This section contains the following statistics:
These statistics can be accessed online using the EXEC CICS® COLLECT STATISTICS DISPATCHER command, and are mapped by the DFHDSGDS DSECT. For programming information about the EXEC CICS COLLECT STATISTICS command, see the CICS System Programming Reference manual.
DFHSTUP name | Field name | Description |
---|---|---|
Dispatcher Start Date and Time | DSGLSTRT | is the date and time at which the CICS dispatcher
started. This value can be used as an approximate time at which CICS started. The
DFHSTUP report expresses this time as hours:minutes:seconds.decimals; however, the DSECT field contains the time as a store clock (STCK)
value in local time.
Reset characteristic: not reset
|
NOT IN DFHSTUP REPORT | DSGSTART | is the time at which the dispatcher started. This value
can be used as an approximate time at which CICS started. The DFHSTUP report expresses
this time as hours:minutes:seconds.decimals; however,
the DSECT field contains the time as a store clock (STCK) value in GMT.
Reset characteristic: not reset
|
Address Space CPU Time | DSGEJST | is the total CPU time for all TCBs in this address space,
accumulated during the interval.
Reset characteristic: reset to zero
|
Address Space SRB Time | DSGSRBT | is the total CPU time for all service request blocks (SRB)
executed in this address space, accumulated during the interval.
Reset characteristic: reset to zero
|
Current number of dispatcher tasks | DSGCNT | is the current number of dispatcher tasks in the system.
This figure includes all system tasks and all user tasks.
Reset characteristic: not reset
|
Peak number of dispatcher tasks | DSGPNT | is the peak value of the number of dispatcher tasks concurrently
in the system.
Reset characteristic: reset to current value
|
Current ICV time (msec) | DSGICVT | is the ICV time value (expressed in milliseconds)
specified in the SIT, or as an override, or changed dynamically using CEMT
SET SYSTEM TIME(value) or EXEC CICS SET SYSTEM TIME(fullword binary data-value)
commands.
Reset characteristic: not reset
|
Current ICVR time (msec) | DSGICVRT | is the ICVR time value (expressed im milliseconds) specified
in the SIT, or as an override, or changed dynamically using CEMT SET SYSTEM
TIME(value) or EXEC CICS SET SYSTEM TIME(fullword binary data-value) commands.
Reset characteristic: not reset
|
Current ICVTSD time (msec) | DSGICVSD | is the ICVTSD time value (expressed in milliseconds) specified in the SIT, or as an override, or changed dynamically using
CEMT SET SYSTEM SCANDELAY(value) or EXEC CICS SET SYSTEM SCANDELAY(fullword binary
data-value) commands.
Reset characteristic: not reset
|
Current PRTYAGE time (msec) | DSGPRIAG | is the PRTYAGE time value (expressed in milliseconds)
specified in the SIT, or as an override, or changed dynamically using CEMT
SET SYSTEM AGING(value) or EXEC CICS SET SYSTEM AGING(fullword binary data-value)
commands.
Reset characteristic: not reset
|
Current MRO (QR) Batching (MROBTCH) value | DSGMBTCH | is the MROBTCH value specified in the SIT, or as an override,
or changed dynamically using CEMT SET SYSTEM MROBATCH(value) or EXEC CICS SET SYSTEM
MROBATCH(fullword binary data-value) commands.
Reset characteristic: not reset
|
Number of Excess TCB Scans | DSGXSCNS | is the number of CICS dispatcher excess MVS™ TCB scans.
Reset characteristic: reset to zero
|
Number of Excess TCB Scans-No TCB Detached | DSGXSCNN | is the number of excess MVS TCB scans that resulted in no MVS TCBs being detached
by the CICS dispatcher.
Reset characteristic: reset to zero
|
Number of Excess TCBs Detached | DSGXTCBD | is the total number of MVS TCBs that have been detached by the CICS dispatcher's excess MVS TCB management processing.
Reset characteristic: reset to zero
|
Average Excess TCBs Detached per Scan | Not Applicable | is the average number of MVS TCBs that have been detached by each scan
of the CICS dispatcher's excess MVS TCB management processing.
Reset characteristic: reset to zero
|
Number of CICS TCB MODEs | DSGASIZE | is the current number of CICS TCB modes in which the CICS dispatcher
is managing MVS task control blocks (TCBs) in the system.
Reset characteristic: not reset
|
Number of CICS TCB POOLs | DSGPSIZE | is the number of TCB pools in which the CICS dispatcher
is managing MVS task control blocks (TCBs) in the system under which the CICS dispatcher
runs.
Reset characteristic: not reset
|
These statistics can be accessed online using the EXEC CICS COLLECT STATISTICS DISPATCHER command, and are mapped by the DFHDSGDS DSECT. For programming information about the EXEC CICS COLLECT STATISTICS command, see the CICS System Programming Reference manual.
Two passes are made at the data, producing two TCB Mode statistics tables, as the statistics cannot all be fitted into a single table within the format of the report. The first table mainly contains the TCB event information, such as attaches, detaches and steals, for each mode. The second table has timing information, such as operating system wait time, waits, TCB dispatch and CPU times.
The following fields are mapped by the DSGTCBM DSECT within 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.
DFHSTUP name | Field name | Description |
---|---|---|
TCB Mode | DSGTCBNM | is the name of the CICS dispatcher TCB mode, either QR, RO, CO,
SZ, RP, FO, SL, SO, ![]() ![]() ![]() ![]() ![]() ![]() 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 | is the name of the TCB pool in which this TCB mode is
defined, either N/A, OPEN, JVM, ![]() ![]() ![]() ![]() Reset characteristic: not reset
|
TCBs Attached - Current | DSGTCBCA | is the current number of MVS TCBs attached in this TCB mode.
Reset characteristic: not reset
|
TCBs Attached - Peak | DSGTCBPA | is the peak number of MVS TCBs attached in this TCB mode.
Reset characteristic: reset to current value
|
TCBs In Use - Current | DSGCMUSD | is the current number of MVS TCBs in use in this TCB mode.
Reset characteristic: not reset
|
TCBs In Use - Peak | DSGPMUSD | is the peak number of MVS TCBs in use in this TCB mode.
Reset characteristic: reset to current value
|
TCB Attaches | DSGNTCBA | is the number of MVS TCBs that have been attached in this TCB
mode.
Reset characteristic: reset to zero
|
Detached Unclean | DSGTCBDU | is 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 | is 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 | is 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 | is the number of MVS TCBs that have been, or are in the process
of being, detached from this TCB mode. This could be because, for example,
the limit for the number of TCBs allowed in the TCB pool has been lowered,
or there are too many TCBs attached in relation to the number of TCBs in use.
Reset characteristic: reset to zero
|
TCB Steals | DSGTCBST | is the number of MVS TCBs that have been stolen from other TCB
modes.
Reset characteristic: reset to zero
|
TCB Mismatches | DSGTCBMM | is 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 | is the name of the CICS dispatcher TCB mode, either QR, RO, CO,
SZ, RP, FO, SL, SO, ![]() ![]() ![]() ![]() ![]() ![]() Reset characteristic: not reset
|
TCBs Attached - Current | DSGTCBCA | is the current number of MVS TCBs attached in this TCB mode.
Reset characteristic: not reset
|
TCBs Attached - Peak | DSGTCBPA | is the peak number of MVS TCBs attached in this TCB mode.
Reset characteristic: not reset
|
TCB Attaches | DSGNTCBA | is the number of MVS TCBs that have been attached in this TCB
mode.
Reset characteristic: reset to zero
|
Attach Failures | DSGTCBAF | is the number of MVS TCB attach failures that have occurred
in this TCB mode.
Reset characteristic: reset to zero
|
MVS Waits | DSGSYSW | is the number of MVS waits which occurred on TCBs in this mode.
Reset characteristic: reset to zero
|
Accum Time in MVS wait | DSGTWT | is 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 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 | is the accumulated real time that TCBs in this mode have
been dispatched by MVS; that is, the total time used between an MVS wait issued by
the dispatcher and the subsequent wait issued by the dispatcher. The DFHSTUP
report expresses this time as 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 | is the accumulated CPU time taken for the DS task, that
is, the processor time used by TCBs in this mode while executing 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 | is 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 in execution. The DFHSTUP report expresses
this time as hours:minutes:seconds.decimals; however,
the DSECT field contains the time as a store clock (STCK) value.
Reset characteristic: reset to zero
|
Statistics are produced for each TCB pool: the JVM TCBs pool, the OPENAPI TCBs pool,
the SSL TCBs pool,
and
the
XP
TCBs pool.
These statistics can be accessed online using the EXEC CICS COLLECT STATISTICS DISPATCHER command, and are mapped by the DFHDSGDS DSECT. For programming information about the EXEC CICS COLLECT STATISTICS command, see the CICS System Programming Reference manual.
The following fields are mapped by the DSGTCBP DSECT within the DFHDSGDS DSECT. The DSGTCBP DSECT is repeated for each TCB pool in CICS (DSGPSIZE).
DFHSTUP name | Field name | Description |
---|---|---|
TCB Pool | DSGTCBPN | is the name of the CICS TCB pool, either OPEN, JVM, ![]() ![]() ![]() ![]() Reset characteristic: not reset
|
Current TCBs attached in this TCB Pool | DSGCNUAT | is the current number of TCBs attached in the TCB modes
that reside in this TCB pool.
Reset characteristic: not reset
|
Peak TCBs attached in this TCB Pool | DSGPNUAT | is the peak number of TCBs attached in the TCB modes that
reside in this TCB pool.
Reset characteristic: reset to current
|
Current TCBs in use in this TCB Pool | DSGCNUUS | is the current number of CICS TCBs attached in this TCB pool and being
used.
Reset characteristic: not reset
|
Peak TCBs in use in this TCB Pool | DSGPNUUS | is the peak number of CICS TCBs used that were attached in this
TCB pool.
Reset characteristic: reset to current value
|
Max TCB Pool limit (MAXOPENTCBS, MAXJVMTCBS, ![]() ![]() ![]() ![]() |
DSGMXTCB | is the value for the maximum number of TCBs allowed in
this pool. The value is specified in the system initialization parameter MAXOPENTCBS
(for the open TCBs pool), MAXJVMTCBS (for the JVM TCBs pool), ![]() ![]() ![]() ![]() Reset characteristic: not reset
|
Times at Max TCB Pool Limit (MAXOPENTCBS, MAXJVMTCBS, ![]() ![]() ![]() ![]() |
DSGNTCBL | is the number of times the system reached the limit for
the number of TCBs allowed in this pool (MAXOPENTCBS, MAXJVMTCBS,![]() ![]() ![]() ![]() Reset characteristic: reset to zero
|
Total Requests delayed by Max TCB Pool Limit | DSGTOTNW | is the total number of TCB requests delayed because the
system reached the limit for the number of TCBs allowed in this pool.
Reset characteristic: reset to zero
|
Total Max TCB Pool Limit delay time | DSGTOTWL | is the total time that TCB requests were delayed because
the system had reached the limit for the number of TCBs allowed in this pool.
Reset characteristic: reset to zero
|
Current Requests delayed by Max TCB Pool Limit | DSGCURNW | is the number of TCB requests that are currently delayed
because the system has reached the limit for the number of TCBs allowed in
this pool.
Reset characteristic: not reset
|
Current Max TCB Pool Limit delay time | DSGCURWT | is the current delay time for the TCB requests that are
currently delayed because the system has reached the limit for the number
of TCBs allowed in this pool.
Reset characteristic: not reset
|
Peak Requests delayed by Max TCB Pool Limit | DSGPEANW | is the peak number of TCB requests that were delayed
because the system had reached the limit for the number of TCBs allowed in
this pool.
Reset characteristic: not reset
|
Total Number of TCB Mismatch waits | DSGMMWTS | The total number of TCB mismatch waits, that is, TCB
requests that waited because there was no TCB available matching the request,
but there was at least one non-matching free TCB. For J8 and J9 mode TCBs
in the JVM pool, this shows the requests that waited for a TCB of the correct
mode (J8 or J9) and JVM profile.
Reset characteristic: Reset to zero
|
Total TCB Mismatch wait time | DSGMMWTM | The total time spent in TCB mismatch waits by TCB requests
using this pool.
Reset characteristic: Reset to zero
|
Current TCB Mismatch waits | DSGCMMWS | The current number of TCB mismatch waits by TCB requests
using this pool.
Reset characteristic: not reset
|
Current TCB Mismatch wait time | DSGCMMWT | The current wait time for current TCB mismatch waits
by TCB requests using this pool.
Reset characteristic: not reset
|
Peak TCB mismatch waits | DSGPMMWS | The peak number of TCB mismatch waits by TCB requests
using this pool.
Reset characteristic: Reset to current value
|
Requests delayed by MVS storage constraint | DSGTOTMW | The total number of MVS storage requests that have waited because
no TCB was available, and none could be created because of MVS storage constraints.
Reset characteristic: Reset to zero
|
Total MVS storage constraint delay time | DSGTOTMT | The total time spent in MVS storage waits by TCB requests using this
pool.
Reset characteristic: Reset to zero
|
Summary statistics are not available online.
DFHSTUP name | Description |
---|---|
Dispatcher Start Date and Time | is the date and time at which the CICS dispatcher
started. This value can be used as an approximate date and time at which CICS started. The DFHSTUP report expresses this time as hours:minutes:seconds.decimals at the local time; however, the DSECT field contains the time as a local
store clock (STCK) value.
|
Address Space CPU Time | is the total CPU time taken by the CICS address space.
The DFHSTUP report expresses this as hours:minutes:seconds.decimals
|
Address Space SRB Time | is the total SRB time taken by the CICS address space.
The DFHSTUP report expresses this as hours:minutes:seconds.decimals
|
Peak number of dispatcher tasks | is the peak number of dispatcher tasks concurrently in the system. |
Peak ICV time (msec) | is the peak ICV time value (expressed in milliseconds) specified in the SIT, or as an override, or changed dynamically using
CEMT SET SYSTEM TIME(value) or EXEC CICS SET SYSTEM TIME(fullword binary data-value)
commands.
|
Peak ICVR time (msec) | is the peak ICVR time value (expressed in milliseconds) specified in the SIT, or as an override, or changed dynamically using
CEMT SET SYSTEM RUNWAY(value) or EXEC CICS SET SYSTEM RUNWAY (fullword binary data-value)
commands.
|
Peak ICVTSD time (msec) | is the peak ICVTSD time value (expressed in milliseconds) specified in the SIT, or as an override, or changed dynamically using
CEMT SET SYSTEM SCANDELAY(value) or EXEC CICS SET SYSTEM SCANDELAY(fullword binary
data-value) commands.
|
Peak PRTYAGE time (msec) | is the peak PRTYAGE time value (expressed in milliseconds) specified in the SIT, or as an override, or changed dynamically using
CEMT SET SYSTEM AGING(value) or EXEC CICS SET SYSTEM AGING(fullword binary data-value)
commands.
|
Peak MRO (QR) Batching (MROBTCH) value | is the peak MROBTCH value specified in the SIT, or as
an override, or changed dynamically using CEMT SET SYSTEM MROBATCH(value)
or EXEC CICS SET SYSTEM MROBATCH(fullword binary data-value) commands.
|
Number of Excess TCB scans | is the total number of CICS dispatcher excess MVS TCB scans.
|
Excess TCB scans - No TCB detached | is the total number of CICS dispatcher excess MVS TCB scans which
resulted in no MVS TCB being detached.
|
Number of Excess TCBs detached | is the total number of MVS TCBs that have been detached by the CICS dispatcher's excess MVS TCB management processing.
|
Average Excess TCBs Detached per Scan | is the average number of MVS TCBs that have been detached by each scan
of the CICS dispatcher's excess MVS TCB management processing.
|
Number of CICS TCB MODEs | is the number of CICS dispatcher TCB modes.
|
Number of CICS TCB POOLs | is the number of CICS dispatcher TCB pools.
|
Dispatcher domain Summary TCB Mode statistics are not available online.
Two passes are made at the data, producing two summary TCB Mode statistics tables, as the statistics cannot all be fitted into a single table within the format of the report. The first table mainly contains the TCB event information, such as attaches, detaches and steals, for each mode. The second table has timing information, such as operating system wait time, waits, TCB dispatch and CPU times.
For a list of modes of TCB, see Interpreting dispatcher statistics.
DFHSTUP name | Description |
---|---|
Mode | is the name of the CICS dispatcher TCB mode, either QR, RO, CO,
SZ, RP, FO, SL, SO, ![]() ![]() ![]() ![]() ![]() ![]()
|
Open | indicates whether the CICS dispatcher TCB mode is open, not open,
or unknown. A TCB mode of type Unk indicates that this TCB mode
has not been activated.
|
TCB Pool | is the name of the CICS TCB pool, either N/A, OPEN, JVM, ![]() ![]() ![]() ![]()
|
Peak TCBs Attached | is the peak number of MVS TCBs attached in this TCB mode.
|
Peak TCBs In Use | is the peak number of MVS TCBs attached and in use in this TCB mode.
|
TCB Attaches | is the number of MVS TCBs that have been attached in this TCB
mode.
|
Detached Unclean | is the total 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.
|
Detached Stolen | is the total number of MVS TCBs that have been stolen, or are in the
process of being stolen, from this TCB mode because they are required by another
TCB mode.
|
Detached Excess | is the total number of MVS TCBs that have been, or are in the process
of being, detached from this TCB mode because of the dispatcher excess TCB
management processing.
|
Detached Other | is the total number of MVS TCBs that have been detached, or are in
the process of being detached, from this TCB mode. This could be because,
for example, the limit for the number of TCBs allowed in the TCB pool has
been lowered, or there are too many TCBs attached in relation to the number
of TCBs in use.
|
TCB Steals | is the total number of MVS TCBs that have been stolen from other TCB
modes.
|
TCB Mismatches | is the total number of MVS TCB mismatches that have occurred for this
TCB mode.
|
DFHSTUP name | Description |
---|---|
Mode | is the name of the CICS dispatcher TCB mode, either QR, RO, CO,
SZ, RP, FO, SL, SO, ![]() ![]() ![]() ![]() ![]() ![]()
|
Peak TCBs Attached | is the peak number of MVS TCBs attached in this TCB mode.
|
Peak TCBs In Use | is the peak number of MVS TCBs attached and in use in this TCB mode.
|
TCB Attaches | is the number of MVS TCBs that have been attached in this TCB
mode.
|
Attach Failures | is the total number of MVS TCB attach failures that have occurred
in this TCB mode.
|
MVS Waits | is the total number of MVS waits which occurred on this TCB mode.
|
Total Time in MVS wait | is the total real time that the TCBs in this mode were
in an MVS wait. The DFHSTUP report expresses this time as days-hours:minutes:seconds.decimals.
|
Total Time Dispatched | is the total real time that the TCBs in this mode were
dispatched by MVS. The DFHSTUP report expresses this time as days-hours:minutes:seconds.decimals.
|
Total CPU Time / TCB | is the total CPU time taken for all the TCBs in this mode.
The DFHSTUP report expresses this time as days-hours:minutes:seconds.decimals.
|
Statistics are produced for each TCB pool: the JVM TCBs pool, the OPENAPI TCBs pool,
the SSL TCBs pool,
and
the
XP
TCBs pool.
DFHSTUP name | Description |
---|---|
TCB Pool | is the name of the CICS TCB pool, either OPEN, JVM, ![]() ![]() ![]() ![]()
|
Peak TCBs attached in this TCB Pool | is the peak number of TCBs attached in the TCB modes that
reside in this TCB pool.
|
Peak TCBs in use in this TCB Pool | is the peak number of CICS TCBs used that were attached in this
TCB pool.
|
Max TCB Pool limit (MAXOPENTCBS, MAXJVMTCBS, ![]() ![]() ![]() ![]() |
is the value for the maximum number of TCBs allowed in
this pool. The value is specified in the system initialization parameter MAXOPENTCBS
(for the open TCBs pool), MAXJVMTCBS (for the JVM TCBs pool), ![]() ![]() ![]() ![]() |
Times at Max TCB Pool Limit (MAXOPENTCBS, MAXJVMTCBS, ![]() ![]() ![]() ![]() |
is the total number of times the limit for the number
of TCBs allowed in this pool has been reached.
|
Total Requests delayed by Max TCB Pool Limit | is the total number of TCB requests that have been delayed
because the system had reached the limit for the number of TCBs allowed in
this pool.
|
Total Max TCB Pool Limit delay time | is the total time spent waiting by those tasks that were
delayed because the system had reached the limit for the number of TCBs allowed
in this pool.
|
Average Max TCB Pool Limit delay time | is the average time spent waiting by those tasks that
were delayed because the system had reached the limit for the number of TCBs
allowed in this pool.
|
Peak Requests delayed by Max TCB Pool Limit | is the peak number of TCB requests that were delayed because
the system had reached the limit for the number of TCBs allowed in this pool.
|
Total number of TCB Mismatch waits | The total number of TCB mismatch waits, that is, TCB requests
that waited because there was no TCB available matching the request, but there
was at least one non-matching free TCB. For J8 and J9 mode TCBs in the JVM
pool, this shows the requests that waited for a TCB of the correct mode (J8
or J9) and JVM profile.
|
Total TCB Mismatch wait time | The total time spent in TCB mismatch waits by TCB requests
using this pool.
|
Average TCB Mismatch wait time | The average time spent in TCB mismatch waits by TCB requests
using this pool.
|
Peak TCB Mismatch waits | The peak number of TCB mismatch waits by TCB requests
using this pool.
|
Requests delayed by MVS storage constraint | is the total number of MVS storage requests that have waited because
no TCB was available, and none could be created because of MVS storage constraints.
|
Total MVS storage constraint delay time | is the total time spent in MVS storage waits by TCB requests using this
pool.
|