CPU utilization commands

MCPUnn
Displays CPU utilization greater than nn% by address space and system-wide.
Type:
Immediate
Format:
MCPUnn
The MCPU command displays utilization of standard (CP), Series z Application Assist (IFA), and System z® Integrated Information (zIIP) processors by address space and individual processor. LPAR-wide TCB, SRB, IFA, IFA on CP, zIIP, zIIP on CP, and enclave utilization is also displayed.
Task
Shows CPU utilization by task or address space. Each address space’s CPU usage over the last OMEGAMON interval is calculated in TCB and SRB time. The total of these two times is calculated as a percentage of the total time available (for one CPU). The maximum possible value for CPU utilization is 100% * number of CPUs being monitored. MCPUnn displays and plots any task whose CPU usage exceeds the nn% threshold. (If you only want to see Task plotted across the entire screen, use the SCPUnn command.)
System
Shows the total CPU utilization system-wide. The totals in this zone are calculated over the last OMEGAMON interval, and displayed in terms of TCB, SRB, IFA, IFA on CP (IFC), zIIP, zIIP on CP (IIC), and enclave utilization (NCL) time. The difference between the total software times and the total hardware time is attributed to z/OS® overhead. In other words, these are non-billable hardware cycles because they are not accounted for in terms of SRB, TCB, zAAP, and zIIP times. On a PR/SM system, the PARx line are given to show average utilization logically for the partition.

The address spaces displayed can be filtered by the total processor utilization percentage. For example, the command XMCPU05 displays all address spaces where the CPU percentage across standard, IFA and zIIP utilization is greater than 5%. Note that IFA and zIIP time consumed by enclaves owned by the address space are not included in the IFA% and IIP% column data; the time is accumulated in the total enclave CPU percentage displayed after the NCL: literal. The system-wide IFA and zIIP values displayed after the IFA: and IIP: literals on the right of the output do not include owned enclave consumption. (The Address Space CPU Utilization displays in IBM Z® OMEGAMON® AI for z/OS® workspaces are more comprehensive, showing the owned enclave IFA and zIIP consumption for enclaves and distinguishing dependent and independent enclave consumption.)

MCPU shows CPU usage by task as well as overall CPU utilization. To view CPU resource consumption within an address space, place the cursor under a job name (in the TASK column) and press PF11. If the job name begins with an asterisk, then place the cursor on the character following the asterisk and press PF11. If your system is logically partitioned (for example, z990 with PR/SM support), place the cursor under the partition and press PF11 for more information on the partition.

To view more detailed enclave statistics by owning address space, place the cursor under the NCL: literal and press PF11. If your system supports zAAP processors, place the cursor under the IFA: or IFC: literal and press PF11 for more information on zAAP and zAAP on CP resource consumption. If your system supports zIIP processors, place the cursor under the IIP: or IIC: literal and press PF11 for more information on zIIP and zIIP On CP resource consumption.

The following figure displays output for the MCPU command with APF-authorization.

Figure 1. Typical output display for MCPU with APF-authorization

 MCPU01|__Task__ CPU% 0______ 100|__PG N/A in goal mode__|System % 0______ 100| 
+      |XCFAS     2.1 > . . . . .|                       |TCB:  96 ---====>>>.| 
+      |CTG720A   1.3 > . . . . .|                       |SRB:   3 > . . . . .| 
+      |S3SUBK39  1.0 > . . . . .|                       |NCL:   0 > . . . . .| 
+      |PLGWCP7  79.2 ---====>. .|                       |MVS:  12 ->. . . . .| 
+      |                         |                       |IFA:   0 > . . . . .| 
+      |                         |                       |IFC:   0 > . . . . .| 
+      |                         |                       |IIP:   0 > . . . . .| 
+      |                         |                       |IIC:   0 > . . . . .| 
+      |                         |                       |         0_______100| 
+      |                         |                       |CPU00 41 ---=> . . .| 
+      |                         |                       |CPU01  0 > . . . . .| 
+      |                         |                       |CPU02 70 ---====>. .| 
+      |                         |                       |IIP03  0 > . . . . .| 
+      |                         |                       |PAR17 37 --->. . . .|

OMEGAMON alters the high end of the scale to the first value large enough to depict the address space, or system with the largest CPU utilization percentage.

Prefixed with an X (XMCPUnn), the command displays all tasks that use more than nn% of the CPU. (5% is the default. You can change it by typing over 05.) The center section of the display shows a breakdown of the CPU percentage into TCB, SRB, zAAP (IFA), zAAP on CP (IFC), zIIP (IIP) and zIIP on CP (IIC) consumption. The final section of the display breaks down CPU utilization into seven components:
  • TCB: Task program execution
  • SRB: System services on behalf of tasks
  • NCL: Enclaves (including standard CP, zAAP and zIIP utilization)
  • MVS: MVS overhead
  • IFA: zAAP processor utilization (normalized)
  • IFC: zAAP-eligible work executed on standard CPs (crossover)
  • IIP: zIIP processor utilization (normalized)
  • IIC: zIIP-eligible work executed on standard CPs (crossover)

 ________________ ZMENU    VTM     OM/DEX   V420./C SYS  03/10/09 15:40:15   1  
XMCPU01|__Task__ CPU%  TCB%  SRB%  IFA%  IFC%  IIP%  IIC%|System % 0______ 100| 
+      |XCFAS     2.1   1.6    .5    .0    .0    .0    .0|TCB:  96 ---====>>>.| 
+      |CTG720A   1.3   1.3    .0    .0    .0    .0    .0|SRB:   3 > . . . . .| 
+      |S3SUBK39  1.0    .9    .1    .0    .0    .0    .0|NCL:   0 > . . . . .| 
+      |PLGWCP7  79.2  79.2    .0    .0    .0    .0    .0|MVS:  12 ->. . . . .| 
+      |                                                 |IFA:   0 > . . . . .| 
+      |                                                 |IFC:   0 > . . . . .| 
+      |                                                 |IIP:   0 > . . . . .| 
+      |                                                 |IIC:   0 > . . . . .| 
+      |                                                 |         0_______100| 
+      |                                                 |CPU00 41 ---=> . . .| 
+      |                                                 |CPU01  0 > . . . . .| 
+      |                                                 |CPU02 70 ---====>. .| 
+      |                                                 |IIP03  0 > . . . . .| 
+      |                                                 |PAR17 37 --->. . . .|
Note: OMEGAMON must be APF authorized for the CPU percentage to appear.
NCLV
Collects performance data for all completed and active enclaves on the system.
Type:
Major
Other than displaying the measurement interval that the collected data represents, the NCLV command does not display any data itself. It is used with the following minor commands:
EDPP
Displays CPU percentages for dependent enclaves.
EDPT
Displays CPU times for dependent enclaves.
EIDP
Displays CPU percentages for independent enclaves.
EIDT
Displays CPU times for independent enclaves.
ETTP
Displays CPU percentages for combined independent and dependent enclaves.
ETTT
Displays CPU times for combined independent and dependent enclaves.
INT
Allows a measurement interval, in minutes, to be specified. An interval can be between 1 and 998 minutes, open-ended, or from "Enter" to "Enter".
EDPP
Displays dependent enclave information as percentages by owning address space.
Type:
Minor of NCLV
Format:
[U]EDPP [xxxx]
<blank>
Unmodified, EDPP displays normalized statistical values.
U
Prefixed by a U, EDPP displays unnormalized statistical values.
nnnn
Followed by nnnn, EDPP displays statistical values where address space owned enclave CPU consumption is greater than or equal to nnnn%..
EDPP displays the following information for each enclave-owning address space where its dependent or independent enclaves have consumed CPU resource over the measurement interval:
  • Address space name.
  • Address space ID in hexadecimal format.
  • Standard CP resource percentage consumed by enclaves.
  • zAAP resource percentage consumed by enclaves.
  • zIIP resource percentage consumed by enclaves.
  • Standard CP resource percentage consumed by enclaves performing zAAP-eligible work.
  • Standard CP resource percentage consumed by enclaves performing zIIP-eligible work.
  • Total of combined standard CP, zAAP and zIIP percentage consumed by enclaves.
A totals line displaying the sum of these values by column is displayed after the individual address space statistics.
Statistical values can be thresholded as follows:
  • Address Space Level Warning set by POPT Major Command value SCPUWARN.
  • Address Space Level Critical set by POPT Major Command value SCPUCRIT.
  • LPAR Level Warning set by POPT Major Command value SCPUTWARN.
  • LPAR Level Critical set by POPT Major Command value SCPUTCRIT.

Exceeding Warning thresholds results in a statistical value being highlighted in the color Yellow. Exceeding Critical thresholds results in a statistical value being highlighted in the color Red. Note that statistics where there has been activity over the measurement interval are highlighted in the color green.

EDPT
Displays dependent enclave information as times by owning address space.
Type:
Minor of NCLV
Format:
[U]EDPT [nnnn]
<blank>
Unmodified, EDPT displays normalized statistical values.
U
Prefixed by a U, EDPT displays unnormalized statistical values.
nnnn
Followed by nnnn, EDPT displays statistical values where address space owned enclave CPU consumption is greater than or equal to nnnn%.
EDPT displays the following information for each enclave-owning address space where its dependent or independent enclaves have consumed CPU resource over the measurement interval:
  • Address space name.
  • Address space ID in hexadecimal format.
  • Standard CP resource time consumed by enclaves.
  • zAAP resource time consumed by enclaves.
  • zIIP resource time consumed by enclaves.
  • Standard CP resource time consumed by enclaves performing zAAP-eligible work.
  • Standard CP resource time consumed by enclaves performing zIIP-eligible work.
  • Total of combined standard CP, zAAP and zIIP time consumed by enclaves.
A totals line displaying the sum of these values by column is displayed after the individual address space statistics.
Statistical values can be thresholded as follows:
  • Address Space Level Warning set by POPT Major Command value SCPUWARN.
  • Address Space Level Critical set by POPT Major Command value SCPUCRIT.
  • LPAR Level Warning set by POPT Major Command value SCPUTWARN.
  • LPAR Level Critical set by POPT Major Command value SCPUTCRIT.

Exceeding Warning thresholds results in a statistical value being highlighted in the color Yellow. Exceeding Critical thresholds results in a statistical value being highlighted in the color Red. Note that statistics where there has been activity over the measurement interval are highlighted in the color green.

EIDP
Displays CPU percentages for independent enclaves.
Type:
Minor of NCLV
Format:
[U]EIDP [nnnn]
<blank>
Unmodified, EIDP displays normalized statistical values.
U
Prefixed by a U, EIDP displays unnormalized statistical values.
nnnn
Followed by nnnn, EIDP displays statistical values where address space owned enclave CPU consumption is greater than or equal to nnnn%.
EIDP displays the following information for each enclave-owning address space where its dependent and/or independent enclaves have consumed CPU resource over the measurement interval:
  • Address space name.
  • Address space ID in hexadecimal format.
  • Standard CP resource percentage consumed by enclaves.
  • zAAP resource percentage consumed by enclaves.
  • zIIP resource percentage consumed by enclaves.
  • Standard CP resource percentage consumed by enclaves performing zAAP-eligible work.
  • Standard CP resource percentage consumed by enclaves performing zIIP-eligible work.
  • Total of combined standard CP, zAAP and zIIP percentage consumed by enclaves.
A totals line displaying the sum of these values by column is displayed after the individual address space statistics.
Statistical values can be thresholded as follows:
  • Address Space Level Warning set by POPT Major Command value SCPUWARN.
  • Address Space Level Critical set by POPT Major Command value SCPUCRIT.
  • LPAR Level Warning set by POPT Major Command value SCPUTWARN.
  • LPAR Level Critical set by POPT Major Command value SCPUTCRIT.

Exceeding Warning thresholds results in a statistical value being highlighted in the color Yellow. Exceeding Critical thresholds results in a statistical value being highlighted in the color Red. Note that statistics where there has been activity over the measurement interval are highlighted in the color green.

EIDT
Displays independent enclave information as times by owning address space.
Type:
Minor of NCLV
Format:
[U]EIDT [nnnn]
<blank>
Unmodified, EIDT displays normalized statistical values.
U
Prefixed by a U, EIDT displays unnormalized statistical values.
nnnn
Followed by nnnn, EIDT displays statistical values where address space owned enclave CPU consumption is greater than or equal to nnnn%.
EIDT displays the following information for each enclave-owning address space where its dependent or independent enclaves have consumed CPU resource over the measurement interval:
  • Address space name.
  • Address space ID in hexadecimal format.
  • Standard CP resource time consumed by enclaves.
  • zAAP resource time consumed by enclaves.
  • zIIP resource time consumed by enclaves.
  • Standard CP resource time consumed by enclaves performing zAAP-eligible work.
  • Standard CP resource time consumed by enclaves performing zIIP-eligible work.
  • Total of combined standard CP, zAAP and zIIP time consumed by enclaves.
A totals line displaying the sum of these values by column is displayed after the individual address space statistics.
Statistical values can be thresholded as follows:
  • Address Space Level Warning set by POPT Major Command value SCPUWARN.
  • Address Space Level Critical set by POPT Major Command value SCPUCRIT.
  • LPAR Level Warning set by POPT Major Command value SCPUTWARN.
  • LPAR Level Critical set by POPT Major Command value SCPUTCRIT.

Exceeding Warning thresholds results in a statistical value being highlighted in the color Yellow. Exceeding Critical thresholds results in a statistical value being highlighted in the color Red. Note that statistics where there has been activity over the measurement interval are highlighted in the color green.

ETTP
Displays CPU percentages for combined independent and dependent enclaves by owning address space.
Type:
Minor of NCLV
Format:
[U]ETTP [nnnn]
<blank>
Unmodified, ETTP displays normalized statistical values.
U
Prefixed by a U, ETTP displays unnormalized statistical values.
nnnn
Followed by nnnn, ETTP displays statistical values where address space owned enclave CPU consumption is greater than or equal to nnnn%.
ETTP displays the following information for each enclave-owning address space where its dependent and/or independent enclaves have consumed CPU resource over the measurement interval:
  • Address space name.
  • Address space ID in hexadecimal format.
  • Standard CP resource percentage consumed by enclaves.
  • zAAP resource percentage consumed by enclaves.
  • zIIP resource percentage consumed by enclaves.
  • Standard CP resource percentage consumed by enclaves performing zAAP-eligible work.
  • Standard CP resource percentage consumed by enclaves performing zIIP-eligible work.
  • Total of combined standard CP, zAAP and zIIP percentage consumed by enclaves.
A totals line displaying the sum of these values by column is displayed after the individual address space statistics.
Statistical values can be thresholded as follows:
  • Address Space Level Warning set by POPT Major Command value SCPUWARN.
  • Address Space Level Critical set by POPT Major Command value SCPUCRIT.
  • LPAR Level Warning set by POPT Major Command value SCPUTWARN.
  • LPAR Level Critical set by POPT Major Command value SCPUTCRIT.

Exceeding Warning thresholds results in a statistical value being highlighted in the color Yellow. Exceeding Critical thresholds results in a statistical value being highlighted in the color Red. Note that statistics where there has been activity over the measurement interval are highlighted in the color green.

ETTT
Displays total enclave information as times by owning address space.
Type:
Minor of NCLV
Format:
[U]ETTT [nnnn]
<blank>
Unmodified, ETTT displays normalized statistical values.
U
Prefixed by a U, ETTT displays unnormalized statistical values.
nnnn
Followed by nnnn, ETTT displays statistical values where address space owned enclave CPU consumption is greater than or equal to nnnn%.
ETTT displays the following information for each enclave-owning address space where its dependent and/or independent enclaves have consumed CPU resource over the measurement interval:
  • Address space name.
  • Address space ID in hexadecimal format.
  • Standard CP resource percentage consumed by enclaves.
  • zAAP resource percentage consumed by enclaves.
  • zIIP resource percentage consumed by enclaves.
  • Standard CP resource percentage consumed by enclaves performing zAAP-eligible work.
  • Standard CP resource percentage consumed by enclaves performing zIIP-eligible work.
  • Total of combined standard CP, zAAP and zIIP percentage consumed by enclaves.
A totals line displaying the sum of these values by column is displayed after the individual address space statistics.
Statistical values can be thresholded as follows:
  • Address Space Level Warning set by POPT Major Command value SCPUWARN.
  • Address Space Level Critical set by POPT Major Command value SCPUCRIT.
  • LPAR Level Warning set by POPT Major Command value SCPUTWARN.
  • LPAR Level Critical set by POPT Major Command value SCPUTCRIT.

Exceeding Warning thresholds results in a statistical value being highlighted in the color Yellow. Exceeding Critical thresholds results in a statistical value being highlighted in the color Red. Note that statistics where there has been activity over the measurement interval are highlighted in the color green.

INT
Sets measurement interval for NCLV major command statistical minors.
Type:
Minor of NCLV
Format:
INT [nnn]

Used without operands, this command displays the measurement interval currently in effect. Valid values for nnn are 0-999, inclusive. Values 1 through 998 represent the number of minutes before a new measurement interval will start. A value of 0 sets the interval as "Enter" to "Enter". A value of 999 sets an indefinite interval. Resetting the measurement interval will result in the NCLV command data collection re-initializing.

SCPUnn
Displays address spaces using more than nn% CPU since the last OMEGAMON cycle.
Type:
Immediate
For each address space selected, SCPUnn displays:
  • CPU utilization (including but not limited to TCB, SRB, and other CPU measurements such as enclave, Series z Application Assist Processors, and System z Integrated Information Processors time) over the last cycle.
  • A plot of CPU utilization. OMEGAMON alters the high end of the scale to the first value large enough to depict the address space with the largest CPU utilization.

The last line of the display is total CPU utilization, not including z/OS overhead, calculated from the sum of all address space utilizations over the last OMEGAMON cycle. The selection threshold (nn) does not affect this total.

This total is probably not the same as the value that the RCTA minor command reports, because RCTA calculates CPU utilization from machine wait time, averaged over an SRM-defined interval of up to 20 seconds, depending upon CPU models.

Figure 2. Typical output for SCPU command

 SCPU02 __CPU Utilization__ 0___20___40___60___80__100__120__140__160__180__200
+       *MASTER*      7.1  |->  .    .    .    .    .    .    .    .    .    . 
+       KOBVTAMA      5.6  |->  .    .    .    .    .    .    .    .    .    . 
+       TDOM29        2.7  |>   .    .    .    .    .    .    .    .    .    .
+       TDOC07B       3.5  |>   .    .    .    .    .    .    .    .    .    .
+       CANDLIMS    112.1  |---20---40---60===80==100=>  .    .    .    .    .
+       CICS         56.2  |---20---40--> .    .    .    .    .    .    .    .
+        Total      206.4  |---20---40---60===80==100==120==140++160++180++200>
In this display, nn = 02, therefore all active address spaces using more
than 2% CPU appear.
SIFAnn
Displays IFA and IFA on CP utilization of address spaces using more than nn% IFA and IFA on CP combined.
Type:
Immediate
Format:

SIFAnn

where nn specifies the threshold over which percentages of IFA and IFA on CP are displayed.

The SIFA command displays utilization percentages of Series z Application Assist Processors (zAAPS: for reporting purposes, referred to as an integrated facility for applications, or IFA%) and utilization of standard processors by zAAP-eligible work (IFA% on CP) for each address space and a total value for all enclaves.

For each address space with an IFA and IFA on CP combined percentage over the threshold, SIFA displays the IFA utilizations since the last cycle and a utilization plot. If there is active enclaves IFA work, an enclaves entry provides the total IFA utilization and IFA on CP utilization of all dispatcher enclaves on the z/OS image.

The Total entry at the end of the output is the sum of IFA and IFA on CP percentages for all address spaces and enclaves on the z/OS image. The threshold selected (nn) does not affect this total.

SIIPnn
Displays zIIP and zIIP on CP utilization of address spaces using more than nn% zIIP and zIIP on CP combined.
Type:
Immediate
Format:

SIIPnn

where nn specifies the threshold over which percentages of zIIP and zIIP on CP combined are displayed.

SIIP displays utilization of System z Integrated Information Processors (zIIP%) and utilization of standard processors by zIIP-eligible work (zIIP% on CP) for each address space and a total value for all enclaves. For each address space with a zIIP and zIIP on CP combined percentage over the threshold, SIIP displays the zIIP utilizations since the last cycle and a utilization plot. If there is active enclaves zIIP work, an Enclaves entry provides the total zIIP utilization and zIIP on CP utilization of all dispatcher enclaves on the z/OS image.

The Total entry at the end of the output is the sum of zIIP and zIIP on CP percentages for all address spaces and Enclaves on the z/OS image. The threshold selected (nn) does not affect this total.