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 parameter 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. If maximum number of tasks is dynamically adjusted, then CICS recalculates the MAXOPENTCBS based on the adjusted MXT value. Be aware that, to revert to allowing CICS to set MAXOPENTCBS automatically after you have specified it explicitly, you must reinitialize both the local and global catalogs.

    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 server is the THREADLIMIT 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 system initialization parameter .

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