ACPU


The Address Space CPU (ACPU) sampler produces a warning message when an address space uses more than a specified percentage of CPU time during the reporting interval and the total CPU utilization has exceeded the specified percentage.

Important

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

Syntax

GUID-8F00BBD2-F1EC-478E-B7AB-79498561611D-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).

name

is the name of the address space to be monitored

If the last character of the name is an asterisk (*), the name is to be treated as a generic address-space name prefix; that is, any address space whose name matches the character string up to but not including the asterisk is monitored.

To monitor all address spaces, except those in the exclusion list, specify an asterisk (*).

percent

is the CPU busy percentage for which an address space must be responsible before an exception message is issued for that address space

type

is the type of address space to be monitored, where

  • B indicates a batch job
  • S indicates a Started Task
  • T indicates a TSO user
  • A indicates any address space matching the specified name; the default

minpct

is the percentage of system CPU busy that must be reached before exception messages are issued

The default is a system CPU busy percent greater than 0.

Example

This example uses a reporting interval of 30 seconds. The example control statement issues the PWSACP94 warning message (at two-minute intervals) for each address space that is not in the exception list that had at least a 10% CPU utilization and if the total CPU utilization during the interval was at least 50%.

ACPU 4,*,10,A,50

Warning message

The following warning message is issued by the ACPU sampler:

PWSACP94 *WARNING* CPU usage is percent % for type name

The variables in the message are:

Variable

Description

percent

is the percentage of cpu time that the address space used

type

is the type of address space (Job, STC, TSU, or All)

name

is the name of the address space exceeding the limit

 

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