WARNING
The WARNING (WAR) service (alias AEW) provides the ability to start and stop the Exception Monitor and display and alter the parameters for active samplers.
For an explanation of the various samplers and their parameters, see Exception-Monitor-samplers.
Syntax
The parameters are defined as follows:
Parameter | Description |
|---|---|
LIST | lists the Exception Monitor samplers currently active (default) |
START | starts the Exception Monitor system If xx is not specified, BBPARM member PWSCPM00 is used. |
xx | is the suffix used to form the name of the BBPARM member (PWSCPM xx) that contains the sampler control statements to be used to start the Exception Monitor The default member name is PWSCPM00. |
STOP | stops the Exception Monitor |
STATS | displays a status report detailing the CPU time used by the Exception Monitor This report is also displayed when the Exception Manager is stopped. |
samp(n) | WARNING samp causes all parameters and their associated values for sampler samp to be displayed (n) is optional and refers to the nth sampler with the name samp. The default value is 1. See examples 6 and 7. |
parm | WARNING samp, parm causes the value associated with parameter parm for sampler samp to be displayed |
PARM=value | WARNING samp, parm= value causes parameter parm for sampler samp to be set to value value You can specify multiple parameters and values for the sampler on a single WARN command. You can also use scaled numeric values. See example 7. |
Example 1
To display the active Exception Monitor samplers, type
WARN
AMTTH2I The following AEW Samplers are active:
AMTTH3I INT DEV DNR MTP
Example 2
To start the Exception Monitor, type
WARN,START,01
PWSSDV02 AEW Initializing
PWSINI00 AEW parameters obtained from member PWSCPM01
PWSSDV65 AEW Monitor Active, 5:00:24 PM, SJSD, Release: 3.6.00
PWSSDV09 AEW Initialization Complete
AMTAW1I AEW initialization completed
Example 3
To display the status report, type
WARN,STATS
AMTV32I Sampler Calls Microsec Microsec Percent
AMTV33I --------- -------- -------- -------- --------
AMTV34I GBLS 184 5,231 28 0.24
AMTV34I JSU 184 2,039K 11,083 95.06
AMTV34I Admin -N/A- 101K 273 4.68
AMTV33I --------- -------- -------- -------- --------
AMTV34I Total/Avg 368 2,145K 5,829 100.00
AMTV35I Average absorption rate 1.400 seconds per hour
AMTV36I AEW DIE Monitor Statistics
AMTV37I Total Nano Secs
AMTV38I DIE Samples Mic Sec Per sample
AMTV39I ---- -------- -------- ----------
AMTV3AI GBLS 44,650 142K 3,173
AMTV3AI JSU 44,650 399K 8,947
Example 4
To display all of the parameters and their associated values for the DNR sampler, type
WARN,DNR
AMTTL8I DNR parameter value(s):
AMTW51I INT = 1
AMTW51I NOTREADY = 2
Example 5
To display the value associated with PENDING parameter for the MTP sampler, type
WARN,MTP,PENDING
AMTW51I PENDING = 3
Example 6
To change the value of the PENDING parameter for the MTP sampler to 5, type
WARN,MTP,PENDING=5
AMTW51I PENDING = 5
Example 7
This example shows how to use the WARNING service to change the minimum service units rate threshold (minrate) for the third BSRV sampler to 10,000 service units per second.
Because there are multiple BSRV samplers and the parameters for the third BSRV sampler needs updating, you must add the suffix (3) to the sampler name (BSRV(3)). The rate is a numeric value and you can specify a scaled value. In this example, the scaled value 10K represents 10,000 service units per second. This example also shows that the report interval value is 2 (INT=2).
You can specify both the rate and interval parameters at the same time; enter the following command to receive the following results.
WARN,BSRV(3),RATE=10K,INT=2
AMTW51I MINRATE = 10,000
AMTW51I INT = 2
Related topic