TPAG


The TSO Paging (TPAG) sampler produces a warning when a specified TSO address space is detected that is using more than a specified percentage of the total system paging activity during a reporting interval.

The warning can be suppressed if a given threshold for the total system paging rate is not reached during a reporting interval. This sampler also produces a warning when the paging for a particular TSO address space exceeds the threshold.

Note

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

Syntax

GUID-AD34E1FC-0C5B-4F3B-A6C6-F188B6C5A76F-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 paging for which a TSO address space must be responsible before an exception message is issued for that address space

rptno

is the maximum number of TSO address spaces to be listed whenever a TSO-paging overload condition is detected

The default is 5.

rate

is the paging rate per second that must be reached before exception messages are issued; the default is a system paging rate greater than 25 EXCPs-per-second

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-paging rate exceeds 50 pages-per-second over the preceding two minutes:

TPAG 4,25,5,50

A warning is issued for any TSO address space that is doing more than 25 percent of the paging.

Warning messages

The following warning messages are issued by the TPAG sampler:

PWSTPAG0 *WARNING* TOTAL SYSTEM PAGING RATE IS NOW ppp PAGES/SEC

Message PWSTPAG0 indicates that the system-paging rate has exceeded the warning threshold.

PWSTPAG1 *WARNING* PAGING RATE FOR TSU nnnnnnnn IS xxx% OF TOTAL

Message PWSTPAG1 indicates that the specified address space has exceeded the warning threshold for percentage of system paging, where

Variable

Description

nnnnnnnn

is the TSO user ID

xxx

is the percentage of the system total

 

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