CONTROL BLOCK NAME = DFHXQS2D
NAME OF MATCHING PLS CONTROL BLOCK = None
DESCRIPTIVE NAME = CICS TS (XQ) Statistics for queue buffer pool.
Licensed Materials - Property of IBM
Restricted Materials of IBM
5655-Y04
(C) Copyright IBM Corp. 1995
FUNCTION = XQ Statistics for queue index buffer pool usage.
LIFETIME = N/A
STORAGE CLASS = N/A
LOCATION = N/A
N/A
NOTES :
DEPENDENCIES = S/370
MODULE TYPE = Control block definition
---------------------------------------------------------------------
Table 1.
| Offset Hex |
Type |
Len |
Name (Dim) |
Description |
| (0) |
STRUCTURE |
0 |
DFHXQS2D |
, XQ buffer pool statistics record |
| (0) |
FULLWORD |
4 |
S2 (0) |
Start of record |
| (0) |
ADDRESS |
2 |
S2LEN |
Length of data area |
| (0) |
.111 1.1. |
|
S2IDE |
"0122" XQ buffer pool stats mask |
| (2) |
ADDRESS |
2 |
S2ID |
XQ buffer pool stats id |
| (2) |
.... ...1 |
|
S2VERS |
"X'01'" DSECT version number mask |
| (4) |
ADDRESS |
1 |
S2DVERS |
XQ buffer pool version number |
| (5) |
BITSTRING |
3 |
|
Reserved |
These statistics are for the queue index buffer pool, which is used
to read and write queue index entries plus the associated data if
the total queue size does not exceed 32K bytes. Buffers containing
recently accessed queue index entries are added to a least recently
used chain, which means that if another request for the same queue
arrives shortly afterwards, it may be possible to optimize the
processing based on the assumption that the copy in the buffer is
probably already correct. If all other buffers are in used, a
request for a new buffer will discard the contents of the least
recently used buffer and reuse the storage as a free buffer.
These statistics are returned by AXM buffer management interface.
The queue server does not use some of the AXM buffer management
functions (such as KEEP or PURGE) so those counters will be zero.
These fields describe the current state of the buffer pool.
|
| (8) |
FULLWORD |
4 |
S2BFQTY |
Total buffers defined |
| (C) |
FULLWORD |
4 |
S2BFENTH |
Number of buffers used so far |
| (10) |
FULLWORD |
4 |
S2BFACTS |
Active buffers owned by tasks |
| (14) |
FULLWORD |
4 |
S2BFLRUS |
Valid buffers on LRU chain |
| (18) |
FULLWORD |
4 |
S2BFEMPS |
Empty buffers on free chain |
The following counters start again from zero after a reset.
|
| (1C) |
FULLWORD |
4 |
S2BFPWTS |
Waits on buffer pool lock |
| (20) |
FULLWORD |
4 |
S2BFGETS |
GET requests |
| (24) |
FULLWORD |
4 |
S2BFHITS |
GET which found a valid buffer |
| (28) |
FULLWORD |
4 |
S2BFGFRS |
GETs which used a free buffer |
| (2C) |
FULLWORD |
4 |
S2BFGNWS |
GETs which used a new buffer |
| (30) |
FULLWORD |
4 |
S2BFGLRS |
GETs which used the LRU buffer |
| (34) |
FULLWORD |
4 |
S2BFLWTS |
GET waits on buffer lock |
| (38) |
FULLWORD |
4 |
S2BFGNBS |
GETs which returned no buffer |
| (3C) |
FULLWORD |
4 |
S2BFPUTS |
PUTs (put back buffer as valid) |
| (40) |
FULLWORD |
4 |
S2BFKEPS |
KEEPs (put back buffer as modified) |
| (44) |
FULLWORD |
4 |
S2BFFRES |
FREEs (put back buffer as empty) |
| (48) |
FULLWORD |
4 |
S2BFFNOS |
FREE errors, buffer not owned |
| (4C) |
FULLWORD |
4 |
S2BFPURS |
PURGEs (mark buffer invalid) |
| (50) |
FULLWORD |
4 |
S2BFPNFS |
PURGE with no matching buffer found |
| (54) |
FULLWORD |
4 |
S2BFPNOS |
PURGE errors, buffer not owned |
| (54) |
.1.1 1... |
|
S2END |
"*" |
| (54) |
.1.1 1... |
|
S2CLEN |
"*-S2LEN" Length of this DSECT |