ZIIP |
|
|
This system command only applies to z/OS batch, batch servers and TSO environments that support the use of the IBM System z Integrated Information Processor (zIIP). If issued from a different environment and/or without zIIP support enabled, appropriate error messages occur.
The ZIIP system command provides status and
processing information on the zIIPs used in your environment and the license
file required for the zIIP Enabler for Natural. In addition, you can obtain
statistics on the Natural components that cause switches to the general central
processor (GCP) and manage the component switch counting.
For details on zIIP support, usage and monitoring, refer to the zIIP Enabler for Natural documentation.
This document covers the following topics:
|
|
PRINT |
|
INFO
|
|
|
||||||||
|
|
|
|
|
|
|
||||||||
STAT |
|
|
|
||||||||||
LIC |
|
|
|
||||||||||
| Subfunction | Option | Explanation |
|---|---|---|
PRINT* |
INFO |
Displays the zIIP Processing Information report. |
STAT |
Displays the zIIP Component Switch
Statistics report if component switch counting has been
activated (see STAT
below).
See also Sort Options for the zIIP Component Switch Statistics to determine the sort sequence. |
|
ALL
(default) |
Displays the
zIIP Processing
Information report first, followed by the
zIIP Component Switch
Statistics (if activated).
See also Sort Options for the zIIP Component Switch Statistics to determine the sort sequence. |
|
STAT* |
ON |
Activates the component switch counting. |
OFF |
Deactivates the component switch counting. | |
CLR |
Clears the component switch table. | |
LIC |
ASIS |
Displays the XML-formatted zIIP license file left-justified. |
XML |
Displays the XML-formatted zIIP license file. | |
FORMATTED
(default) |
Displays the zIIP license file in free format without brackets. |
* Alternatively, you can set the keyword subparameters
STAT and PRINT of the profile parameter
ZIIP and the macro NTZIIP respectively. See
Keyword
Subparameters in the section ZIIP - zIIP
Processing (z/OS only) in the Parameter
Reference documentation.
| Keyword | Sort Order |
|---|---|
SORTDESC |
The report is sorted ascending by the component description. |
SORTNAME |
The report is sorted ascending by the component name. |
SORTSWITCHES
(default) |
The report is sorted descending by the number of TCB switches. |
This section describes the reports and statistical data provided by the
ZIIP system
command.
The zIIP Processing Information report looks similar to the example below:
+------------ zIIP Processing Information ------------+ | | | Advanced zIIP Support Enabled | | | | Number of GCPs 3 | | Number of zIIPs 1 | | zIIP normalization factor 3.48 | | | | Number of switches into TCB mode 105 | | Number of SRB starts 1 | | | | Total enclave CPU time 24 | | Qualified zIIP CPU time 12 | | Eligible zIIP CPU time on GCP 0 | | Total enclave zIIP CPU time 12 | | Total enclave zIIP CPU time (%) 50.00 | | | | (All times in milliseconds; zIIP times normalized) | | | +-----------------------------------------------------+ |
This report provides the following status and processing information:
| Report Item | Explanation |
|---|---|
| Advanced zIIP Support Enabled | Indicates that the current Natural session runs with full zIIP enablement. |
| Number of GCPs | The number of general central processors (GCPs) running under your z/OS system. |
| Number of zIIPs | The number of zIIPs running under your z/OS system. |
| zIIP normalization factor | The zIIP normalization factor indicates the
ratio of zIIP to GCP speed.
This factor tells you how fast your zIIP runs compared to a
throttled GCP with reduced power. In the example above, the value of |
| Number of switches into TCB mode | The number of switches from SRB (service request block) into TCB (task control block) processing mode due to any system service calls that had to be issued. The corresponding switches back into SRB mode are not counted. |
| Number of SRB starts | The number of times an SRB process was started.
The counter is incremented by 1 for the first SRB at each session start and for the SRB restart after an abnormal termination in SRB mode. |
| Total enclave CPU time | The total CPU (GCP plus zIIP) time consumed by the current WLM enclave. |
| Qualified zIIP CPU time | The time qualified for zIIP usage on SRB, which is the sum of the eligible plus the total zIIP CPU time. |
| Eligible zIIP CPU time on GCP | The CPU time on the GCP qualified for a zIIP but
not used by it.
A non-zero value means that zIIP-eligible workload could not be offloaded because no zIIP was available. |
| Total enclave zIIP CPU time | The total zIIP CPU time consumed by the current WLM enclave. |
| Total enclave zIIP CPU time (%) | The percentage of the total zIIP CPU time consumed by the current WLM enclave. In the example above, Natural was able to offload 50 % of the total CPU load to a zIIP. |
For details on the statistics items, refer to Natural zIIP Processing: TCBs, SRBs and Enclaves and Calculating the CPU Time in the zIIP Enabler for Natural documentation.
For hints on improving zIIP exploitation, refer to Tuning zIIP Usage in the zIIP Enabler for Natural documentation.
| ENTER or PF5 | Updates the report data. |
| PF8 | Switches to the zIIP Component Switch Statistics. |
The zIIP Component Switch Statistics report lists all non-zero TCB switches and the components that cause these switches as shown in the following example:
+----------------- zIIP Component Switch Statistics -----------------+ | | | Component Description TCB Switches | | ------------------------------------------------------------------ | | CMDBAS Call Adabas 72 | | CMGETMP Acquire working storage 14 | | CMGTIMER Set CPU time limit 10 | | CMFREMP Release working storage 3 | | CMWTERM Primary I/O 3 | | ZPINIT Initialization of zIIP support 1 | | CMWTL Write message to system log 1 | | CMDLET Release external module 1 | | ------------------------------------------------------------------ | | Total 105 | | | | | | | | | | | | | | | | | | | | | | | | | | | +--------------------------------------------------------------------+ |
Components are service routines of the Natural nucleus, Natural add-on
products or other Software AG products (for example, Adabas) that cause TCB
switches when executing, for example, Adabas calls or external
CALLNAT requests. The report contains the component name, the
component description, the number of switches per component and the total
number of switches.
ENTER or
PF5 |
Updates the statistics data. |
| PF7 | Switches to the zIIP Processing Information report. |
| PF10 | Toggles between the two displays described for
SORTDESC and SORTNAME in
Sort Options for zIIP
Component Switch Statistics.
|
| PF11 | Toggles between the two displays described for
SORTDESC and SORTSWITCHES in
Sort Options for zIIP
Component Switch Statistics.
|
In online mode, you can use a menu to set the
ZIIP report options according to your
requirements.
To display the ZIIP menu
At any command prompt, enter the following:
ZIIP MENU
The of the
ZIIP command is displayed, in which you can select
the required subfunction and option(s) described in
Syntax Element
Description.
You can use the user exit routine ZIIPUX01 to specify the
default settings for the PRINT options of the ZIIP
system command. The source is provided as subprogram ZIIPUS01 in
the Natural system library SYSEXT. Copy the cataloged object of
ZIIPUX01 to the Natural system library SYSLIB,
SYSLIBS or SYSTEM. For details, see the subprogram
ZIIPUS01 in the system library SYSEXT.
You can use the Natural application programming interface
USR8204N to perform all functions of the
ZIIP system command. For details, see the text
object USR8204T and the program USR8204P in the
Natural system library SYSEXT.
