Enqueue domain statistics

The enqueue domain collects global statistics for enqueue requests.

This section contains the following statistics:

Enqueue domain: Global statistics - enqueue requests

These statistics fields contain the global data collected by the enqueue domain for enqueue requests.

These statistics can be accessed online using the EXEC CICS® COLLECT STATISTICS ENQUEUE command, and are mapped by the DFHNQGDS DSECT. For programming information about the EXEC CICS COLLECT STATISTICS command, see the CICS System Programming Reference manual.

Table 51. Enqueue domain: Global statistics - enqueue requests
DFHSTUP name Field name Description
NOT IN THE DFHSTUP REPORT NQGNPOOL is the number of enqueue pools.

Reset characteristic: not reset

 

ENQ Poolname NQGPOOL is the enqueue pool id.

Reset characteristic: not reset

 

ENQs Issued NQGTNQSI is the total number of enqueue requests issued.

Reset characteristic: reset to zero

 

ENQs Waited NQGTNQSW is the total number of enqueue requests that had waited due to the enqueues being held. This is a subset of NQGTNQSI.

Note that this value does not include the enqueue requests currently waiting (see NQGCNQSW).

Reset characteristic: reset to zero

 

Enqueue Waiting time NQGTNQWT is the total waiting time for the enqueue requests that waited (NQGTNQSW).

Note that this value does not include the time for the enqueue requests currently waiting (see NQGCNQWT).

Reset characteristic: reset to zero

 

NOT IN THE DFHSTUP REPORT NQGCNQSW is the current number of enqueue requests waiting.

Reset characteristic: not reset

 

NOT IN THE DFHSTUP REPORT NQGCNQWT is the total waiting time for the enqueue requests that are currently waiting due to the enqueue being held by another transaction.

Reset characteristic: not reset

 

Sysplex Waited NQGGNQSW is the total number of sysplex enqueue requests that had waited due to the enqueues being held.

Reset characteristic: reset to zero

 

Sysplex Waiting time NQGGNQWT is the total waiting time for the sysplex enqueue requests that waited (NQGGNQSW).

Reset characteristic: reset to zero

 

NOT IN THE DFHSTUP REPORT NQGSNQSW is the current number of sysplex enqueues waiting.

Reset characteristic: not reset

 

NOT IN THE DFHSTUP REPORT NQGSNQWT is the total waiting time for the sysplex enqueues that are currently waiting (NQGSNQSW).

Reset characteristic: not reset

 

Enqueues Retained NQGTNQSR is the total number of enqueues that were retained due to the owning UOW being shunted.

Note that this value does not include the enqueues that are currently retained (see NQGCNQSR).

For more information about shunted UOWs see Recovery manager statistics.

Reset characteristic: reset to zero

 

Enqueue Retention NQGTNQRT is the total retention time for the enqueues that were retained due to the owning UOW being shunted.

Note that this value does not include the enqueue retention time for those currently retained (see NQGCNQRT).

For more information about shunted UOWs see Recovery manager statistics.

Reset characteristic: reset to zero

 

NOT IN THE DFHSTUP REPORT NQGCNQSR is the current number of enqueues retained.

Reset characteristic: not reset

 

NOT IN THE DFHSTUP REPORT NQGCNQRT is the current enqueue retention time.

Reset characteristic: not reset

 

Immediate-rejection
-Enqbusy NQGTIRJB is the total number of enqueue requests that were immediately rejected due to the enqueue being busy (ENQBUSY response). This value is a subset of the total number of enqueue requests (NQGTNQSI).

Reset characteristic: reset to zero

 

-Retained NQGTIRJR is the total number of enqueue requests that were immediately rejected due to the enqueue being in a retained state. This value is a subset of the total number of enqueue requests (NQGTNQSI).

Reset characteristic: reset to zero

 

Waiting rejection
-Retained NQGTWRJR is the total number of waiting enqueue requests that were rejected due to the required enqueue moving into a retained state. This value is a subset of the number of enqueue requests that waited (NQGTNQSW).

Reset characteristic: reset to zero

 

-Operator NQGTWPOP is the total number of waiting enqueue requests that were rejected due to the operator purging the waiting transaction. This value is a subset of the number of enqueue requests that waited (NQGTNQSW).

Reset characteristic: reset to zero

 

-Timeout NQGTWPTO is the total number of waiting enqueue requests that were rejected due to the timeout value (DTIMEOUT) being exceeded. This value is a subset of the number of enqueue requests that waited (NQGTNQSW).

Reset characteristic: reset to zero

 

Enqueue domain: Summary global statistics

Summary statistics are not available online.

These statistics fields contain the enqueue summary global data.

Table 52. Enqueue domain: Summary global statistics
DFHSTUP name Description
ENQ Poolname is the enqueue pool id.
ENQs Issued is the total number of enqueue requests that were issued.
ENQs Waited is the total number of enqueues requests that waited.
Enqueue Waiting time is the waiting time for enqueue requests that waited.
Sysplex Waited is the total number of sysplex enqueue requests that had waited due to the enqueues being held.
Sysplex Waiting time is the total waiting time for the sysplex enqueue requests that waited.
ENQs Retained is the total number of enqueues retained.
Enqueue Retention is the enqueue retention time.
Immediate-rejection
-Enqbusy is the total number of enqueue requests that were immediately rejected ENQBUSY.
-Retained is the total number of enqueue requests immediately rejected due to the enqueue being in a retained state.
Waiting rejection
-Retained is the total number of waiting enqueue requests that were rejected due to the required enqueue moving into a retained state.
-Operator is the total number of waiting enqueue requests that were rejected due to the operator purging the waiting transaction.
-Timeout is the total number of waiting enqueue requests that were rejected due to the timeout value being exceeded.

Related reference
Back to full list of statistics and DFHSTUP reports
Appendix A. CICS statistics tables
Interpreting these statistics
Interpreting enqueue statistics
DFH0STAT reports for these statistics
Enqueue Manager Report
Enqueue Models Report
[[ Contents Previous Page | Next Page Index ]]