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.
- 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 TCB statistics.
| 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
|
| 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
|