Dispatcher domain: TCB Mode statistics

You can retrieve dispatcher domain TCB mode statistics by using the EXEC CICS EXTRACT STATISTICS DISPATCHER system command. They are mapped by the DFHDSGDS DSECT.

Two passes are made at the data, producing two TCB Mode statistics tables, because the statistics cannot all be fitted into a single table in the format of the report.

The first table contains mainly the TCB event information, such as attaches, detaches, and steals, for each mode.
The second table shows timing information, such as operating system wait time, waits, TCB dispatch, and CPU times. Some fields show accumulated time for all the TCBs in a specific mode. When there can be multiple TCBs, for example L8 open TCBs, be aware that the value of such fields is a total that might exceed the time since the statistics were last reset.

The following fields are mapped by the DSGTCBM DSECT in the DFHDSGDS DSECT. The DSGTCBM DSECT is repeated for each mode of TCB in CICS® (DSGASIZE). For a list of modes of TCB, see Interpreting dispatcher statistics.

Table 1. Dispatcher domain: TCB Mode statistics - Pass 1
DFHSTUP name	Field name	Description
TCB Mode	DSGTCBNM	The name of the CICS dispatcher TCB mode, either QR, RO, CO, SZ, RP, FO, SL, SO, SP, EP, TP, D2, S8, L8, L9, X8, X9, orT8. Reset characteristic: not reset
Open	DSGTCBMD	Indicates whether the CICS dispatcher TCB mode is open, not open, or unknown. A TCB mode of type 'unknown' indicates that this TCB mode has not been activated. Reset characteristic: not reset
TCB Pool	DSGTCBMP	The name of the TCB pool in which this TCB mode is defined, either N/A, OPEN, SSL, THRD, or XP. Reset characteristic: not reset
TCBs Attached – Current	DSGTCBCA	The current number of MVS™ TCBs attached in this TCB mode. Reset characteristic: not reset
TCBs Attached – Peak	DSGTCBPA	The peak number of MVS TCBs attached in this TCB mode. Reset characteristic: reset to current value
TCBs In Use – Current	DSGTCBCU	The current number of MVS TCBs in use in this TCB mode. Reset characteristic: not reset
TCBs In Use – Peak	DSGTCBPU	The peak number of MVS TCBs in use in this TCB mode. Reset characteristic: reset to current value
Dispatchable Queue - Current	DSGTMCDQ	The current number of dispatchable tasks queued for the TCB. Reset characteristic: not reset
Dispatchable Queue - Peak	DSGTMPDQ	The peak number of dispatchable tasks that have been queued for the TCB. Reset characteristic: reset to current
Dispatchable Queue - Average	DSGTMADQ	The average number of dispatchable tasks that have been queued for the TCB. Reset characteristic: reset to current
TCB Attaches	DSGNTCBA	The number of MVS TCBs that have been attached in this TCB mode. Reset characteristic: reset to zero
Detached Unclean	DSGTCBDU	The number of MVS TCBs that have been, or are in the process of being, detached from this TCB mode because the CICS transaction that was associated with the TCB has abended. Reset characteristic: reset to zero
Detached Stolen	DSGTCBDS	The number of MVS TCBs that have been, or are in the process of being, stolen from this TCB mode because they are required by another TCB mode. Reset characteristic: reset to zero
Detached Excess	DSGTCBDX	The number of MVS TCBs that have been, or are in the process of being, detached from this CICS dispatcher TCB mode because of the dispatcher excess TCB management processing. Reset characteristic: reset to zero
Detached Other	DSGTCBDO	The number of MVS TCBs that have been, or are in the process of being, detached from this TCB mode. They are detached because, for example, the limit for the number of TCBs allowed in the TCB pool has been lowered, or too many TCBs are attached in relation to the number of TCBs in use. Reset characteristic: reset to zero
TCB Steals	DSGTCBST	The number of MVS TCBs that have been stolen from other TCB modes. Reset characteristic: reset to zero
TCB Mismatches	DSGTCBMM	The number of MVS TCB mismatches that have occurred for this TCB mode. Reset characteristic: reset to zero

Table 2. Dispatcher domain: TCB Mode statistics - Pass 2
DFHSTUP name	Field name	Description
Mode	DSGTGBM	The name of the CICS dispatcher TCB mode, either QR, RO, CO, SZ, RP, FO, SL, SO, SP, EP, TP, D2, S8, L8, L9, X8, X9, orT8. Reset characteristic: not reset
TCBs Attached – Current	DSGTCBCA	The current number of MVS TCBs attached in this TCB mode. Reset characteristic: not reset
TCBs Attached – Peak	DSGTCBPA	The peak number of MVS TCBs attached in this TCB mode. Reset characteristic: not reset
TCB Attaches	DSGNTCBA	The number of MVS TCBs that have been attached in this TCB mode. Reset characteristic: reset to zero
Attach Failures	DSGTCBAF	The number of MVS TCB attach failures that have occurred in this TCB mode. Reset characteristic: reset to zero
MVS Waits	DSGSYSW	The number of MVS waits that occurred on TCBs in this mode. Reset characteristic: reset to zero
Accum Time in MVS wait	DSGTWT	The accumulated real time that the CICS region was in an MVS wait; that is, the total time used between an MVS wait issued by the dispatcher and the return from the MVS wait. The DFHSTUP report expresses this time as `days-hours:minutes:seconds.decimals`; however, the DSECT field contains the time as a store clock (STCK) value. Reset characteristic: reset to zero
Accum Time Dispatched	DSGTDT	The accumulated real time that TCBs in this mode have been dispatched by MVS; that is, the total time used between the end of an MVS wait issued by the dispatcher and the start of the subsequent wait issued by the dispatcher. The DFHSTUP report expresses this time as `days-hours:minutes:seconds.decimals`; however, the DSECT field contains the time as a store clock (STCK) value. Reset characteristic: reset to zero
NOT IN THE DFHSTUP REPORT	DSGTCT	The accumulated CPU time taken for the DS task, that is, the processor time used by TCBs in this mode while running the default dispatcher task (DSTCB). The DSECT field contains the time as a store clock (STCK) value. Reset characteristic: reset to zero
Accum CPU Time / TCB	DSGACT	The accumulated CPU time taken for all the TCBs that are, or have been, attached in this TCB mode; that is, the total time that TCBs in this mode have been running. The DFHSTUP report expresses this time as `days-hours:minutes:seconds.decimals`; however, the DSECT field contains the time as a store clock (STCK) value. Reset characteristic: reset to zero