ENQ - Documentation for BMC AMI Ops SYSPROG Services 6.4
The Enqueue Conflicts (ENQ) sampler monitors enqueue conflicts and produces a warning message when jobs have been waiting for enqueued resources for more than a specified interval.
Important
You can suppress reporting for specific address spaces by including their names in member BBPARM $$INEXCL. For details, see $$INEXCL.
You can suppress reporting for specific major and minor enqueue names by including them in BBPARM member $$XENQ. See $$XENQ.
Syntax
The parameters are defined as follows:
Parameter | Description |
|---|---|
int | is the length of the sample period in intervals; the default sample period is 20 sample intervals (ten minutes when the report interval is 30 seconds, the default) |
waiting | is the number of minutes that an enqueue conflict must exist for a warning message to be issued The default value is 10 minutes. |
Example
Assuming a report interval of 30 seconds, the following control statement displays warning messages at two-minute intervals if any enqueue conflicts have existed for over five minutes:
ENQ 4,5
Warning message
The following warning message is issued by the ENQ sampler:
PWSENQ01 *WARNING* ENQ conflict over n Min (qqqqqqqq) w waiter(s)
Message PWSENQ01 indicates that one or more jobs have been waiting for resources for longer than the specified threshold. To display the enqueue situation, use service ENQUEUES.
Variable | Description |
|---|---|
n | is the number of minutes the ENQ conflict has existed |
qqqqqqqq | is the Qname |
w | is the number of address spaces waiting for the resource |
