CONTROL BLOCK NAME = DFHNQGDS
NAME OF MATCHING PLS CONTROL BLOCK = DFHNQGPS
DESCRIPTIVE NAME = CICS TS Enqueue Manager Statistics
Licensed Materials - Property of IBM
Restricted Materials of IBM
5655-Y04
(C) Copyright IBM Corp. 1994, 2002
CICS level at which this module was last updated
FUNCTION =
This data area contains global statistics provided by the
Enqueue Manager Domain.
It is provided for use in users monitoring applications
to map the statistics returned via the API, the statistics
exit, or offline formatting products.
There is a single instance of this data block.
LIFETIME =
This data block is created by the Enqueue Manager
Domain to store statistics to be passed to the user in
response to a request for statistics. The storage is
released when the user task is detached.
STORAGE CLASS =
LOCATION =
The user is passed a pointer to the head of the storage
block.
INNER CONTROL BLOCKS = none
NOTES :
DEPENDENCIES = S/370
RESTRICTIONS = none
MODULE TYPE = Domain call buffer
--------------------------------------------------------------------
EXTERNAL REFERENCES = none
DATA AREAS = none
CONTROL BLOCKS = from enqueue manager domain
GLOBAL VARIABLES (Macro pass) = none
--------------------------------------------------------------------
ALTHOUGH PROVIDED IN A GENERAL INTERFACE LIBRARY DFHNQGDS IS
NOT TO BE USED AS A GENERAL PROGRAMMING INTERFACE. REFER TO
PRODUCT DOCUMENTATION TO DETERMINE INTENDED USAGE.
Table 1.
| Offset Hex |
Type |
Len |
Name (Dim) |
Description |
| (0) |
STRUCTURE |
0 |
DFHNQGDS |
Enqueue Manager Global statistics |
| (0) |
FULLWORD |
4 |
(0) |
Fullword alignment |
| (0) |
HALFWORD |
2 |
NQGLEN |
Length of data area |
| (0) |
.11. ...1 |
|
NQGIDE |
"0097" Enqueue Manager statistics id mask |
| (2) |
ADDRESS |
2 |
NQGID |
Enqueue Manager statistics id |
| (2) |
.... ...1 |
|
NQGVERS |
"X'01'" Stats version number id mask |
| (4) |
CHARACTER |
1 |
NQGDVERS |
Stats version number |
| (5) |
CHARACTER |
3 |
|
Filler |
| (5) |
.... 1... |
|
NQGHEND |
"*" End of header |
| (5) |
.... 1... |
|
NQGHLEN |
"*-NQGLEN" Length of header |
| (8) |
FULLWORD |
4 |
NQGNPOOL |
Number of ENQ pools following |
| (8) |
.... 11.. |
|
NQGGEND |
"*" End of global portion |
| (8) |
.... 11.. |
|
NQGGLEN |
"*-DFHNQGDS" Length of header and global part |
The following dsect is repeated for each ENQ pool. The number of
repetitions of the NQGBODY dsect is in NQGNPOOL.
Table 2.
| Offset Hex |
Type |
Len |
Name (Dim) |
Description |
| (0) |
STRUCTURE |
0 |
NQGBODY |
Individual ENQ pool statistics |
| (0) |
CHARACTER |
8 |
NQGPOOL |
ENQ pool id |
| (8) |
FULLWORD |
4 |
NQGTNQSI |
Total enqueues issued |
| (C) |
FULLWORD |
4 |
NQGTNQSW |
Total enqueues waited |
| (10) |
CHARACTER |
8 |
NQGTNQWT |
Time enqueues had waited (STCK) |
| (18) |
FULLWORD |
4 |
NQGCNQSW |
Current enqueues waiting |
| (1C) |
CHARACTER |
8 |
NQGCNQWT |
Current enqueues waiting time (STCK) |
| (24) |
FULLWORD |
4 |
NQGGNQSW |
Total sysplex ENQs waited |
| (28) |
CHARACTER |
8 |
NQGGNQWT |
Time sysplex ENQs had waited (STCK) |
| (30) |
FULLWORD |
4 |
NQGSNQSW |
Current sysplex ENQs waiting |
| (34) |
CHARACTER |
8 |
NQGSNQWT |
Current sysplex ENQs wait time (STCK) |
The following fields show the enqueue retention activity.
|
| (3C) |
FULLWORD |
4 |
NQGTNQSR |
Total enqueues that were retained |
| (40) |
CHARACTER |
8 |
NQGTNQRT |
Time enqueues were retained (STCK) |
| (48) |
FULLWORD |
4 |
NQGCNQSR |
Current enqueues retained |
| (4C) |
CHARACTER |
8 |
NQGCNQRT |
Current enqueues retained time (STCK) |
The following fields show a breakdown of the possible reasons of
why requests for ENQs may not have been successful.
|
| (54) |
FULLWORD |
4 |
NQGTIRJB |
Total immed. rejected ENQBUSY |
| (58) |
FULLWORD |
4 |
NQGTIRJR |
Total immed. rejected ENQ retained |
| (5C) |
FULLWORD |
4 |
NQGTWRJR |
Total waiting ENQs rejected retained |
| (60) |
FULLWORD |
4 |
NQGTWPOP |
Total waiting ENQs purged by operator |
| (64) |
FULLWORD |
4 |
NQGTWPTO |
Total waiting ENQs purged by timeout |
| (64) |
.11. 1... |
|
NQGBEND |
"*" End of individual ENQ pool stats |
| (64) |
.11. 1... |
|
NQGBLEN |
"*-NQGBODY" Length of body |