Dispatcher TCB Pools report

The Dispatcher TCB Pools report is produced for each TCB pool. The example shows the OPEN TCB pool. This report is produced using the EXEC CICS EXTRACT STATISTICS DISPATCHER command. The statistics data is mapped by the DFHDSGDS DSECT.

Table 1. Fields in the Dispatcher TCB Pools report
Field Heading Description
TCB Pool The name of the CICS® TCB pool, either OPEN, SSL, THRD, or XP.

Source field: DSGTCBPN

Current TCBs attached in this TCB Pool The current number of TCBs attached in this TCB pool.

Source field: DSGCNUAT

Peak TCBs attached in this TCB Pool The peak number of TCBs attached in this TCB pool.

Source field: DSGPNUAT

Current TCBs in use in this TCB Pool The current number of TCBs in use in this TCB pool.

Source field: DSGCNUUS

Peak TCBs in use in this TCB Pool The peak number of TCBs in use in this TCB pool.

Source field: DSGPNUUS

Max TCB Pool Limit The value for the maximum number of TCBs allowed in this pool:
  • The MAXOPENTCBS system initialization parameter, if specified, sets the value for the open TCB pool. If the MAXOPENTCBS system initialization is not specified, CICS sets the limit for the L8 and L9 mode open TCB pool automatically based on the maximum number of tasks specified for the CICS region (the MXT value), using the following formula: (2 * MXT Value) + 32. For information about explicitly setting the MAXOPENTCBS parameter yourself, see MAXOPENTCBS.
  • The MAXSSLTCBS system initialization parameter specifies the value for the SSL TCB pool.
  • MAXTHRDTCBS specifies the value for the JVM server THRD TCB pool. The number of threads reserved for each JVM serverTHREADLIMIT value on the JVMSERVER resource is automatically calculated by adding 1 to the number of threads, up to a limit of 2000.
  • The MAXXPTCBS system initialization parameter, if specified, sets the value for the XP TCB pool. If the MAXXPTCBS system initialization is not specified, CICS sets the limit for the X8 and X9 mode XP TCB pool automatically to a value equal to the maximum number of tasks specified for the CICS region (the MXT value). For information about explicitly setting the MAXXPTCBS parameter yourself, see MAXXPTCBS .

Source field: DSGMXTCB

Times at Max TCB Pool Limit The number of times the system reached the limit for the number of TCBs allowed in this pool:
  • OPEN TCB pool
  • SSL TCB pool
  • THRD TCB pool
  • XP TCB pool

Source field: DSGNTCBL

Time Pool Limit last reached The time at which the pool reached the maximum TCB limit.

Source field: DSGLTCBL

Reset characteristic: reset to zero

Requests Delayed by Max TCB Pool Limit The total number of TCB attaches delayed because the system reached the limit for the number of TCBs allowed in this pool.

Source field: DSGTOTNW

Total Max TCB Pool Limit delay time The total time that TCB requests were delayed because the system had reached the limit for the number of TCBs allowed in this pool.

Source field: DSGTOTWL

Average Max TCB Pool Limit delay time The average time that a TCB request was delayed because the system had reached the limit for the number of TCBs allowed in this pool.

Source field: (DSGTOTWL and DSGTOTNW)

Current Requests Delayed by Max TCB Pool Limit 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.

Source field: DSGCURNW

Peak Requests Delayed by Max TCB Pool Limit 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.

Source field: DSGPEANW

Total Delay Time for current delayed The total 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.

Source field: DSGCURWT

Average Delay time for current delayed The average 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.

Source field: (DSGCURWT and DSGCURNW)

Total number of TCB Mismatch Waits The total number of TCB mismatch waits; that is, TCB requests that waited because no available TCB matched the request, but at least one non-matching TCB was free.

Source field: DSGMMWTS

Total TCB Mismatch wait time The total time spent in TCB mismatch waits by TCB requests using this pool.

Source field: DSGMMWTM

Average TCB Mismatch wait time The average time spent in a TCB mismatch wait by TCB requests using this pool.

Source field: (DSGMMWTM and DSGMMWTS)

Current TCB Mismatch Waits The current number of TCB mismatch waits by TCB requests using this pool.

Source field: DSGCMMWS

Peak TCB Mismatch Waits The peak number of TCB mismatch waits by TCB requests using this pool.

Source field: DSGPMMWS

Total Wait time for current Mismatch Waits The total wait time for current TCB mismatch waits by TCB requests using this pool.

Source field: DSGCMMWT

Average Wait time for current Mismatch Waits The average wait time for current TCB mismatch waits by TCB requests using this pool.

Source field: (DSGCMMWT and DSGCMMWS)

Requests Delayed by MVS storage constraint The total number of TCB requests that waited because no TCB was available, and none was created because of MVS storage constraints.

Source field: DSGTOTMW

Total MVS storage constraint delay time The total time spent in waits caused by MVS storage constraints for TCB requests using this pool.

Source field: DSGTOTMT

Average MVS storage constraint delay time The average time spent in waits caused by MVS storage constraints for TCB requests using this pool.

Source field: (DSGTOTMT and DSGTOTMW)

TCB Mode The TCB modes currently active in this TCB Pool. The report states if no TCB modes are active.

Source field: DSGTCBNM

TCBs Attached - Current The current number of TCBs attached in this mode.

Source field: DSGTCBCA

TCBs Attached - Peak The peak number of TCBs attached in this mode.

Source field: DSGTCBPA

TCBs In Use - Current The current number of TCBs in use in this mode.

Source field: DSGTCBCU
TCBs In Use - Peak The peak number of TCBs in use in this mode.

Source field: DSGTCBPU

TCB Attaches The total number of MVS TCB attaches for this mode.

Source field: DSGNTCBA

TCBs Detached - Unclean The number of MVS TCBs that have been, or are in the process of being, detached for this CICS dispatcher mode because the CICS transaction associated with the TCB has abended.

Source field: DSGTCBDU

TCBs Detached - Stolen The number of MVS TCBs that have been, or are in the process of being, stolen from this CICS dispatcher mode because it is required by another TCB mode.

Source field: DSGTCBDS

TCBs Detached - Excess The number of MVS TCBs that have been, or are in the process of being, detached from this CICS dispatcher mode because of the CICS dispatcher excess TCB scans.

Source field: DSGTCBDX

TCBs Detached - Other The number of MVS TCBs that have been, or are in the process of being, detached from this CICS dispatcher TCB mode for other reasons; for example, because the TCB pool limit has been lowered, or because there are too many TCBs attached in relation to the number of TCBs in use.

Source field: DSGTCBDO

TCB Steals The number of MVS TCBs that have been stolen from other TCB modes.

Source field: DSGTCBST

TCB Mismatches The number of MVS TCB mismatches that have occurred for this TCB mode.

Source field: DSGTCBMM

TCBs Attached - Current The total number of TCBs currently attached in this TCB pool for all modes.

Source field: DSGTCBCA for each TCB mode

TCBs In Use - Current The total number of TCBs currently in use in this TCB pool for all modes.

Source field: DSGTCBCU for each TCB mode

TCB Attaches The total number of MVS TCB attaches in this TCB pool for all modes.

Source field: DSGNTCBA for each TCB mode

TCBs Detached - Unclean The total number of MVS TCBs in this TCB pool that have been, or are in the process of being, detached because the CICS transaction associated with the TCB has abended.

Source field: DSGTCBDU for each TCB mode

TCBs Detached - Stolen The total number of MVS TCBs in this TCB pool that have been, or are in the process of being, stolen from a CICS dispatcher mode because they are required by another TCB mode.

Source field: DSGTCBDS for each TCB mode

TCBS Detached - Excess The total number of MVS TCBs in this TCB pool that have been or are in the process of being, detached because of the CICS dispatcher excess TCB scans.

Source field: DSGTCBDX for each TCB mode

TCBs Detached - Other The total number of MVS TCBs in this TCB pool that have been, or are in the process of being, detached for other reasons.

Source field: DSGTCBDO for each TCB mode

TCB Steals The total number of MVS TCBs in this TCB pool that have been stolen from other TCB modes.

Source field: DSGTCBST for each TCB mode

TCB Mismatches The number of MVS TCB mismatches that have occurred for this TCB mode.

Source field: DSGTCBMM for each TCB mode