Dispatcher domain: TCB Pool statistics

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

Statistics are produced for each TCB pool: the OPENAPI TCB pool, the SSL TCB pool, the JVM server THRD TCB pool, and the XP TCB pool.

The following fields are mapped by the DSGTCBP DSECT in the DFHDSGDS DSECT. The DSGTCBP DSECT is repeated for each TCB pool in CICS® (DSGPSIZE).

Table 1. Dispatcher domain: TCB Pool statistics
DFHSTUP name Field name Description
TCB Pool DSGTCBPN The name of the CICS TCB pool, either OPEN, SSL, THRD, or XP.

Reset characteristic: not reset

 

Current TCBs attached in this TCB Pool DSGCNUAT The current number of TCBs attached in the TCB modes that are in this TCB pool.

Reset characteristic: not reset

 

Peak TCBs attached in this TCB Pool DSGPNUAT The peak number of TCBs attached in the TCB modes that are in this TCB pool.

Reset characteristic: reset to current

 

Current TCBs in use in this TCB Pool DSGCNUUS 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 The peak number of CICS TCBs used that were attached in this TCB pool.

Reset characteristic: reset to current value

 

Max TCB Pool limit DSGMXTCB 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.
  • The MAXSSLTCBS system initialization parameter specifies the value for the SSL TCB pool.
  • The MAXTHRDTCBS system initialization parameter 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, plus 1, 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)

You can change the maximum value by overriding the appropriate system initialization parameter or by using the SET DISPATCHER command. To change the maximum value of the JVM server, use the SET JVMSERVER command.

Reset characteristic: not reset

 

Start of changeTime Max TCB Pool Limit last reachedEnd of change Start of changeDSGLTCBLEnd of change Start of changeThe time at which the pool reached the maximum TCB limit.

If the DFHSTUP report shows the time as --:--:--:---- then that indicates that the pool limit has not been reached since the statistics were last reset.

Reset characteristic: reset to zero

 

End of change
Times at Max TCB Pool Limit DSGNTCBL 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

Reset characteristic: reset to zero

 

Total Requests delayed by Max TCB Pool Limit DSGTOTNW 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 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 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 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 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 no TCB was available that matched the request, but at least one non-matching TCB was free.

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 was 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