This document provides information on how to view and control data on zIIP processing.
See also Monitoring the Cache Usage in the section Print and Work File Caching.
You can use the Natural system command
ZIIP to determine whether the current Natural
session is running on a zIIP and analyze your CPU time savings by zIIP
enablement.
The ZIIP command displays the number of
GCPs and zIIPs available in your z/OS environment, the CPU time consumed and,
optionally, a list of components that caused SRB/TCB switches: see the example
reports and explanations in zIIP Processing
Information and
zIIP Component
Switch Statistics in the System
Commands documentation.
For batch processing, you can also set the keyword subparameter
PRINT of
the profile parameter ZIIP to print zIIP processing
information automatically at the end of the session.
A report with general zIIP information and component switch
statistics is also printed when your CICS or Com-plete environment is shut
down, depending on the version of the Natural CICS Interface or Natural
Com-plete/SMARTS Interface, respectively, installed at your site. This report
is similar to the report produced by the PRINT option of the
ZIIP
system command. For a CICS environment, the required program definitions are
described in the section
Natural
zIIP Shutdown Statistics in Installing Natural
CICS Interface in the Installation for z/OS
documentation.
For a Com-plete environment, the required definitions are described in the section Natural zIIP Shutdown Statistics in Installing Natural Com-plete/SMARTS Interface on z/OS in the Installation for z/OS documentation
If you do not know how many zIIPs are available in your z/OS LPARs (logical partitions), you can check this with the following operator command:
D M=CPU
The following example result of this command shows that four GCPs
(00 to 03) and one zIIP (+I) is running
in the current LPAR, and that one additional GCP (05) and one
additional zIIP (-I) are defined as spare processors.
D M=CPU IEE174I 12.39.09 DISPLAY M 781 PROCESSOR STATUS ID CPU SERIAL 00 + 0FA10E2098 01 + 0FA10E2098 02 + 0FA10E2098 03 + 0FA10E2098 04 +I 0FA10E2098 05 - 06 -I
If you have the z/OS SDSF (System Display and Search Facility) installed under TSO, you can use the command ENC to obtain information about all WLM enclaves currently active in your z/OS environment and their zIIP usage.
For detailed information, see the IBM literature SDSF Operation and Customization.
Be aware that in the SDSF "D A" display the CPU time does not show the real values if running in a WLM enclave. You need to use the value of "ECPU Time" to evaluate the right CPU usage of your zIIP-enabled Natural session. The following definitions are quoted from the IBM z/OS SDSF documentation:
"CPU Time" is the CPU time (TCB + SRB) for the address space, excluding any NP-SRB/enclave time.
"ECPU Time" is the CPU time (TCB + SRB) for the address space, plus any NP-SRB/enclave time; that is, CPU used on behalf of this address space - the SDSF definition of "CPU Time".
Note:
Com-plete UQ A and Natural ISPF only document the
"CPU Time", there is no "ECPU Time" value
available.
You can evaluate the SMF type 30 records to obtain statistics about zIIP processing per address space. These records contain several fields with various job step CPU time values such as TCB, SRB, WLM enclave and zIIP times.
For detailed information, see the IBM literature z/OS MVS System Management Facilities (SMF).