Dispatcher waits

The CICS dispatcher might cause tasks to wait, depending on the availability of TCBs in the CICS region and the maximum number of TCBs that CICS is allowed to create for tasks.

The resource names or resource type associated with these dispatcher waits are as follows:

  • Start of changeDS_ASSOCEnd of change
  • DSTSKDEF
  • OPENPOOL
  • OPEN_DEL
  • SOSMVS
  • SSL_POOL
  • THR_POOL
  • XMCHILD
  • XMPARENT
  • XP_POOL
Start of change

Resource type DS_ASSOC

When a task performs an EXEC CICS LINK to a Liberty program, or a transaction is attached whose initial program is a Liberty program, CICS will dispatch the task onto a T8 TCB in the Liberty JVM server. The task is suspended on the resource type DS_ASSOC and later resumed on the T8 TCB. If the task is not resumed in the period specified by the WLP_LINK_TIMEOUT parameter in the JVM profile, the suspend will timeout. See JVM server options for more information.

End of change

Resource type DSTSKDEF

A task waiting on the resource type DSTSKDEF is not suspended. Task attach has added the new task to the dispatcher chain and it is waiting for first dispatch. The task might be waiting for a dump to complete, for example.

Resource name OPENPOOL

CICS automatically sets the limit for the number of open TCBs in the L8 and L9 mode open TCB pool. The limit is based on the maximum number of tasks (MXT or MAXTASKS) specified for the CICS region, using the following formula:
(2 * MXT Value) + 32
When a task first needs an L8 or L9 mode open TCB, the dispatcher domain tries to find a free TCB of this mode with the correct subspace attributes. If no L8 or L9 mode TCB associated with a matching subspace is free, CICS performs these actions:
  • Attaches a new L8 or L9 mode TCB of the required subspace, if the number of open TCBs in the L8 and L9 mode open TCB pool is less than the limit set by CICS, and allocates the new TCB to the requesting task.
  • Detaches a free open L8 or L9 mode TCB associated with a different subspace, if there is one available and the limit has been reached, attaches a new L8 or L9 mode TCB, and allocates this new TCB to the requesting task. This process is referred to as TCB stealing: deleting a free TCB of one type to attach one of a different type.
However, if neither of these options is available, the dispatcher places the requesting task onto a queue and the task is suspended, using suspend token AWAITING_OPENPOOL_TOKEN in the DS task block. When an open TCB becomes free, or if the limit changes, the task at the front of the queue is resumed, and the open TCB allocation process is retried.

Resource name OPEN_DEL

If your task is waiting on a resource name of OPEN_DEL, the dispatcher is detaching an unsuitable TCB (stealing) so that it can allocate a new one, and your task is waiting for the old TCB to end so that the dispatcher can attach a new one.

If your task requires an open TCB, but no suitable TCB is available, and a new TCB cannot be attached because the limit set for the number of open TCBs has been reached, CICS deletes a currently idle TCB to allow the task to attach a TCB of the required type. However, the attach cannot proceed until the process to delete the TCB is complete, otherwise, the number of open TCBs in the pool would temporarily exceed the limit.

Resource type SOSMVS

CICS has a storage monitor for MVS storage, which notifies it when MVS storage is constrained or severely constrained. The storage monitor checks whether the availability of MVS storage has dropped below a preset threshold of 40 MB, and notifies CICS when this is the case. The storage monitor also notifies CICS if the availability of MVS storage has become so low that MVS storage requests can be satisfied only from a preset MVS storage cushion of 20 MB.

If CICS queues requests to create TCBs because they cannot obtain sufficient MVS storage, the requests are suspended with a resource name of SOSMVS.

Resource name SSL_POOL

When a task first needs a S8 mode open TCB, the dispatcher domain attempts to find a free TCB from the SSL pool. If no S8 mode TCB is free, and the number of open TCBs in the SSL pool is less than the limit specified by the MAXSSLTCBS system initialization parameter, CICS attaches a new TCB and allocates it to the requesting task.

However, if the number of S8 TCBs in the pool is at the limit set by MAXSSLTCBS, dispatcher places the requesting task onto a queue and the task is suspended, using suspend token AWAITING_OPEN_TCB_TOKEN in the DS task block. When an open TCB becomes free, or the MAXSSLTCBS limit is raised, the task at the front of the queue is resumed, and the open TCB allocation process is retried.

Resource name THR_POOL

When a task first needs a T8 mode open TCB, the dispatcher domain attempts to find a free TCB from the THRD pool. If no T8 TCB is free, and the number of open TCBs in the THRD pool is less than the maximum limit, CICS attaches a new TCB and allocates it to the requesting task. The maximum limit for the THRD pool is total number of threads reserved for all the JVM servers in the region, up to a limit of 2000. The number of threads reserved for each JVM server is the THREADLIMIT value on the JVMSERVER resource, plus 1 (the TCB that is reserved for the JVM server).

If the number of T8 TCBs in the pool is at the maximum limit, dispatcher places the requesting task onto a queue and the task is suspended, using suspend token AWAITING_OPEN_TCB_TOKEN in the DS task block. When an open TCB becomes free, the task at the front of the queue is resumed, and the open TCB allocation process is retried.

Resource type XMCHILD

The task is a CICS Business Transaction Services (BTS) child transaction that is suspended waiting for its parent transaction to resume it. The resource name is the task number of the parent transaction.

Resource type XMPARENT

The task is a CICS Business Transaction Services (BTS) parent transaction that is suspended waiting for an associated child transaction to resume it. The resource name is the task number of the child transaction.

Resource name XP_POOL

CICS automatically sets the limit for the number of X8 and X9 TCBs to a value equal to the maximum number of tasks specified for the CICS region (the MXT value).

When a task first needs a X8 or X9 mode open TCB, the dispatcher domain attempts to find a free TCB from the XP pool. If no X8 or X9 mode TCB is free, and the number of open TCBs in the XP pool is less than the limit set by CICS, CICS attaches a new TCB and allocates it to the requesting task.

However, if the number of X8 and X9 TCBs in the pool is at the limit set by CICS, dispatcher places the requesting task onto a queue and the task is suspended, using suspend token AWAITING_OPEN_TCB_TOKEN in the DS task block. When an open TCB becomes free, or if the limit changes, the task at the front of the queue is resumed, and the open TCB allocation process is retried.



dfhs1kn.html | Timestamp icon Last updated: Monday, 5 June 2017