Shared TS queue server: coupling facility statistics
For queues that do not exceed 32K bytes, the data is included in the queue index; otherwise, it is stored as a separate list.
Reset characteristics: these statistics are produced by a separate server address space, not by CICS®. Following a reset, these fields are reset by the server, not CICS. As a general rule, high and low watermarks (max, min and highest, lowest) are reset to current, counts are reset to zero.
The statistics are described in detail in the DFHXQS1D data area. The individual fields have the following meanings.
| Statistic name | Field | Description |
|---|---|---|
| Structure | S1PREF | First part of structure name |
| Structure | S1POOL | Poolname part of structure name |
| Structure | S1CNPREF | Prefix for connection name |
| Structure | S1CNSYSN | Own MVS system name from CVTSNAME |
| Structure: Size | S1SIZE | Current allocated size of the list structure. |
| Structure: Elem size | S1ELEMLN | Data element size, fullword, used for the structure. |
| Structure: Max size | S1SIZEMX | Maximum size to which this structure could be altered. |
| Lists: Total | S1HDRS | Maximum number of list headers |
| Lists: Control | S1HDRSCT | Headers used for control lists |
| Lists: Data | S1HDRSQD | Headers available for queue data |
| Lists: In use | S1USEDCT | Number of entries on used list |
| Lists: Max used | S1USEDHI | Highest number of entries on used list |
| Entries: In Use | S1ENTRCT | Number of entries currently in use. |
| Entries: Max Used | S1ENTRHI | Maximum number in use (since last reset). |
| Entries: Min Free | S1ENTRLO | Minimum number of free entries (since last reset). |
| Entries: Total | S1ENTRMX | Total data entries in the currently allocated structure. (Obtained at connection time, may be updated by ALTER). |
| Entries | S1FREECT | Number of entries on free list |
| Entries | S1ENTRRT | Entry size of entry to element ratio |
| Entries | S1FREEHI | Highest number of entries on free list |
| Elements: In use | S1ELEMCT | Number of elements currently in use. |
| Elements: Max used | S1ELEMHI | Maximum number in use (since last reset). |
| Elements: Min free | S1ELEMLO | Number of elements currently free (total minus used). |
| Elements: Total | S1ELEMMX | Total data elements in the currently allocated structure. (Obtained at connection time, may be updated by ALTER). |
| Elements | S1ELEMPW | Data element size, power of 2, used for the structure. |
| Elements | S1ELEMPE | Maximum number of elements per entry (for 32K) |
| Elements | S1ELEMRT | Element size of entry to element ratio. |
| Queues: Current | S1INDXCT | Number of queues currently in existence. |
| Queues: Highest | S1INDXHI | Highest number of queues at any time (since last reset). |
| Index access counts: Wrt adjs | S1WRACT | Number of index writes to update adjunct area only. (This area contains the read cursor for small queues and the queue status including last used data). |
| Index access counts: Inquires | S1INQCT | Inquire on queue index entry |
| Index access counts: Reads | S1RDQCT | Read queue index entry |
| Index access counts: Writes | S1WRQCT | Write queue index entry. |
| Index access counts: Deletes | S1DLQCT | Delete queue index entry. |
| index access counts: Rereads | S1RRQCT | Number of index data reads which had to be repeated because the data was larger than the default data transfer size. |
| Data access counts: Creates | S1CRLCT | Number of times a separate data list was created. |
| Data access counts: Writes | S1WRLCT | Number of queue writes (new or update) for list data. |
| Data access counts: Reads | S1RDLCT | Number of list data reads. |
| Data access counts: Deletes | S1DLLCT | Delete list (1 per overall delete). |
| Data access counts: Rereads | S1RRLCT | Number of list data reads which had to be repeated because the data was larger than the default data transfer size. |
| Data access counts: Rewrites | S1RWLCT | Rewrite list entry. |
| Data access counts: | S1INLCT | Inquire on list entry |
| Response counts: Asynch | S1ASYCT | Number of asynchronous requests. |
| Response counts: Unavail | S1RSP9CT | Structure temporarily unavailable, for example during rebuild. |
| Response counts: Normal | S1RSP1CT | Number of normal responses. |
| Response counts: Timeout | S1RSP2CT | Request timed out by the CF and should be restarted. |
| Response counts: Not fnd | S1RSP3CT | Specified entry (queue or item) was not found. |
| Response counts: Vers chk | S1RSP4CT | A version check failed for an entry being updated, indicating another task had updated it first. |
| Response counts: List chk | S1RSP5CT | A list authority comparison failed, usually indicating big queue was deleted. |
| Response counts: List full | S1RSP6CT | Maximum list key reached, indicating max queue size or max queues reached depending on list. |
| Response counts: Str full | S1RSP7CT | The list structure is out of space. |
| Response counts: I/O err | S1RSP8CT | An IXLLIST return code occurred other than those already referenced. |