CICSplex Dispatcher TCB Pools attribute group

The CICSplex Dispatcher TCB Pools attributes report extended CICS dispatcher TCB pool information in an active system managed by CICSPlex SM.

Note:
The attributes within the CICSplex Dispatcher TCB Pools group are stored for historical retrieval within the Tivoli Data Warehouse. Selected attributes within this group are candidates for the TDW's summarization and pruning features.

CICS Region Name Indicates the job name or modify ID of the CICS region being monitored. Each CICS region in a z/OS image has a unique name. This name is an alphanumeric string, with a maximum of 8 characters, and case-sensitive. CICS region names are always in uppercase characters.

Current tasks waiting Is the current number of tasks waiting for this TCB.

Current TCBs Attached Is the current number of TCBs attached in the CICS dispatcher TCB modes that reside in this TCB pool.

Current TCB in Use Is the current number of CICS TCBs attached in this TCB pool and being used.

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

Current TCB Mismatch Wait Time Is the current wait time for current TCB mismatch waits by TCB requests using this pool. The time is measured in milliseconds.

Current Waiting Time Is the current delay time (in seconds accurate to thousandths of a second) for the TCB requests that are currently delayed because the system has reached the limit for the number of TCBs allowed in this pool. The valid format is a floating-point number, accurate to three decimal places.

Maximum TCBs 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) or MAXJVMTCBS (for the JVM TCBs pool). It can be changed by an override, or changed dynamically using CEMT SET SYSTEM MAXxxxxTCBS(value) or EXEC CICS SET SYSTEM MAXxxxxTCBS (fullword binary data-value) commands.

Origin Node Is the combination of z/OS System ID (SMFID) and CICS region name. The value format is an alphanumeric string, maximum 32 bytes, and case-sensitive.

When a situation is true, the system compares the origin node name in the attribute to the names of managed systems assigned to the item. If the origin node name matches the name of a managed system, the status of the item changes accordingly. If the names of the origin node and the managed systems do not match, the status of the item remains unchanged.

Peak Tasks Waiting 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.

Peak TCBs Attached Is the peak number of TCBs attached in the CICS dispatcher TCB mode that reside in this TCB pool.

Peak TCB in Use Is the peak number of CICS TCBs used that were attached in this TCB pool.

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

System ID Indicates the four-character name that uniquely identifies an active z/OS operating system within a given CICSplex. The value format is an alphanumeric string, maximum 4 characters, and case-sensitive. z/OS System IDs are always in uppercase characters.

TCB Mismatch Waits Is 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.

TCB Mismatch Wait Time Is the total time (in seconds accurate to thousandths of a second) spent in TCB mismatch waits by TCB requests using this pool. The valid format is a floating-point number, accurate to three decimal places.

TCB Pool Name Is the name of the TCB pool in which this CICS dispatcher TCB mode is defined, either N/A, OPEN, JVM, or HP.

TCB Requests Delayed for z/OS Storage Is the total number of z/OS storage requests that have waited because no TCB was available, and none might be created because of z/OS storage constraints.

Time waiting for MVS storage Is the total time (in seconds accurate to thousandths of a second) spent in z/OS storage waits by TCB requests using this pool. The valid format is a floating-point number, accurate to three decimal places.

Times at Limit Is the number of times the system reached the limit for the number of TCBs allowed in this pool (MAXOPENTCBS or MAXJVMTCBS).

Total Number of Waits Is the total number of z/OS storage waits by TCB requests using this pool.

Total Wait Times at TCB limit Is the total wait time of TCBs that have reached the pool limit. The time is measured in milliseconds.