Dispatcher task summary fields

Detailed descriptions of the fields in the dispatcher task summary are given in the following table.

Some of the fields relate to all tasks known to the dispatcher, and some (identified in the table) relate only to suspended tasks. Values are not provided in fields of the latter type for tasks that are not suspended.
Table 1. Descriptions of fields shown in the dispatcher task summary
Field Description
AD The 2-character domain index identifying the domain that attached the task to the dispatcher.
ATTACHER TOKEN A token provided by the domain that attached the task. This token uniquely identifies the task to the attaching domain.
DS_TOKEN A token given by the dispatcher to a domain that attaches a task. It identifies the attached task uniquely to the dispatcher.
DTA An address used internally by the dispatcher.
KE_TASK A value that uniquely identifies to the kernel a task that has been created.
MO The dispatching mode for the task. There is an MVS™ TCB for each mode. All tasks in a given mode are running, or will run next, under the TCB corresponding to the mode. The possible values are:
  • CO—concurrent.
  • FO—file owning.
  • QR—quasi-reentrant.
  • RO—resource owning.
  • RP—ONC RPC
  • SZ—FEPI owning.
P Whether at the time of the suspend call the control block containing the definition of the transaction specified SPURGE(YES) or SPURGE(NO). SPURGE(NO) inhibits deadlock timeout, CEMT SET TASK PURGE, and EXEC CICS SET TASK PURGE.
The possible values are:
  • Y (=YES)—the task is purgeable.
  • N (=NO)—the task is not purgeable.
PS The purge status of the task. The possible values are:
  • OK—the task has not been purged, and there is no purge pending.
  • PU—the task has been purged, either by the dispatcher or by the operator.
  • PP—there is a purge pending on the task.
RESOURCE NAME (suspended tasks only) The name of the resource that a suspended task is waiting for. A value is given only if RESOURCE_NAME has been included as an input parameter on the suspend call.
RESOURCE TYPE (suspended tasks only) The type of the resource that the task is waiting for. A value is given only if RESOURCE_TYPE has been included as an input parameter on the suspend call.
S The state of the task within the dispatcher. Possible values are:
  • DIS—the task is dispatchable. It is ready to run, and it will be dispatched when a TCB becomes available.
  • RUN—the task is running.
  • SUS—the task has been suspended by any of the functions SUSPEND, WAIT_MVS, WAIT_OLDC, or WAIT_OLDW of gate DSSR. For an explanation of these functions, see How tasks are made to wait.
  • REE—the task has been resumed early, possibly because a RESUME request has arrived before the corresponding SUSPEND request. (The SUSPEND/RESUME interface is asynchronous.)
ST (suspended tasks only) The type of function that was invoked to suspend a currently suspended task. Possible values include:
  • MVS—function WAIT_MVS
  • OLDC—function WAIT_OLDC
  • OLDW—function WAIT_OLDW
  • SUSP—function SUSPEND
For a description of the functions, see How tasks are made to wait.
SUSPAREA (suspended tasks only) Either an address used internally by the dispatcher, or an ECB address, or an ECB list address. These are the cases:
  • Address used internally, if the task was suspended by a SUSPEND call.
  • ECB address or ECB list address, if the task was suspended by a WAIT_MVS or WAIT_OLDW call.
  • ECB address, if the task was suspended by a WAIT_OLDC call.
Look at the value given in the ST column to see which one of these descriptions applies.
TIME OF SUSPEND (suspended tasks only) The time when a currently suspended task was suspended.

The format is hh:mm:ss.mmm (hours, minutes, seconds, milliseconds), GMT.

TIMEOUT DUE    (suspended tasks only) The time that a suspended task is due to timeout, if a timeout interval has been specified. A suspended task only times out if it is not resumed before this time arrives.

The format is hh:mm:ss.mmm (hours, minutes, seconds, milliseconds).

TT (suspended tasks only) The timeout type for the task. The possible values, where one is given, are:
  • IN—a timeout interval has been specified for the task.
  • DD—deadlock action is to be delayed when the timeout interval expires.
  • DI—deadlock action is immediate when the timeout interval expires.
TY Whether this is a system task or a non-system task. Possible values are:
  • SY—this is a system task.
  • NS—this is a non-system task.
A non-system task can be either a user written transaction, or a CICS-supplied transaction.


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