TCPU


The TSO CPU (TCPU) sampler produces a warning whenever a TSO address space is detected that is using more than a specified percentage of the total CPU time during a reporting interval.

The message can be suppressed if a given threshold for total CPU usage is not reached during a reporting interval. This sampler also notifies the operator when TSO address spaces are using an excessive percentage of CPU time.

Note

You can suppress reporting for specific address spaces by including their names in member BBPARM $$INEXCL. For details, see INEXCL.

Syntax

GUID-9CF5257A-2108-4516-9BC8-3DD802894528-low.pngThe parameters are defined as follows:

Parameter

Description

int

is the length of the sample period in intervals; the default sample period is 30 seconds (one interval)

percent

is the percentage of total system CPU time that an address space must be responsible for before an exception message is issued for that address space

rptno

is the maximum number of address spaces to be listed whenever a CPU overload condition is detected; the default is 5

minpct

is the system CPU-busy percentage that must be reached before exception messages are issued; the default is zero

Example

Assuming a report interval of 30 seconds, the following control statement displays up to five warning messages at two-minute intervals for each interval in which the total time the CPU is busy increases 50 percent over the preceding interval:

TCPU 4,35,5,50

A warning is issued for any TSO address space that has been active 35 percent of the total CPU busy time.

Warning message

The following warning message is issued by the TCPU sampler:

PWSTCPU1 *WARNING* CPU USAGE IS ppp.p% FOR TSU jjjjjjjj

Message PWSTCPU1 indicates that the specified address space has exceeded the warning threshold for percentage of system CPU busy time, where

Variable

Description

ppp.p

is the address space busy percentage

jjjjjjjj

is the address space name

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*