BCPU


The Batch CPU (BCPU) sampler produces a warning message when a batch address space uses 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 the reporting interval.

Note

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

Syntax

GUID-481B6FB8-0478-4F7D-A993-0EAD0D24200F-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 a batch 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 CPU busy percentage that must be reached before exception messages are issued; the default is a system CPU busy percentage greater than zero

Example

Assuming a report interval of 30 seconds, the following control statement displays up to five warning messages at two-minute intervals if the system-CPU busy percentage exceeds 50 percent over the preceding two minutes:

BCPU 4,35,5,5

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

Warning message

The following warning message is issued by the BCPU sampler:

PWSBCPU1 *WARNING* CPU USAGE IS ppp% FOR JOB jjjjjjjj

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

Variable

Description

ppp

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*