Parameters and functions setting fields in the dispatcher task summary

Many of the values shown in the dispatcher task summary are provided directly by parameters included on calls to and from the dispatcher. If you are using trace, you can see the values of the parameters in the trace entries, and this can be useful for debugging.

For details of how you can use trace to investigate waits, see Investigating waits using trace .

Table 1 shows the parameters that set task summary fields, the functions that use those parameters, and the domain gates that provide the functions. Task summary fields that are not set by parameters are also identified (by none in “Related parameter” column).

Table 1. Parameters and functions that set fields shown in the dispatcher task summary
Field Related parameter Function Input or output Gate
AD DOMAIN_INDEX

INQUIRE_TASK
GET_NEXT

IN
OUT

DSBR

DTA ATTACH_TOKEN CREATE_TASK IN KEDS
DS_TOKEN TASK_TOKEN

ATTACH
CANCEL_TASK
PURGE_INHIBIT_QUERY
SET_PRIORITY
TASK_REPLY
 
GET_NEXT
INQUIRE_TASK

OUT
IN
IN
IN
IN
 
OUT
OUT

DSAT
 
 
 
 
 
DSBR

KE_TASK TASK_TOKEN

CREATE_TASK
CREATE_TCB
PUSH_TASK
TASK_REPLY
TCB_REPLY

OUT
OUT
IN
IN
IN

KEDS
MO MODE

ATTACH
CHANGE_MODE
 
GET_NEXT
INQUIRE_TASK

IN
IN
 
OUT
OUT

DSAT
 
 
DSBR

P PURGEABLE

SUSPEND
WAIT_MVS
WAIT_OLDC
WAIT_OLDW

IN
IN
IN
IN

DSSR
PS none      
RESOURCE NAME RESOURCE_NAME

ADD_SUSPEND
SUSPEND
WAIT_MVS
WAIT_OLDC
WAIT_OLDW
 
GET_NEXT
INQUIRE_TASK

IN
IN
IN
IN
IN
 
OUT
OUT

DSSR
 
 
 
 
 
DSBR

RESOURCE TYPE RESOURCE_TYPE

ADD_SUSPEND
SUSPEND
WAIT_MVS
WAIT_OLDC
WAIT_OLDW
 
GET_NEXT
INQUIRE_TASK

IN
IN
IN
IN
IN
 
OUT
OUT

DSSR
 
 
 
 
 
DSBR

S
(see note 1)

STATE

GET_NEXT
INQUIRE_TASK

OUT
OUT

DSBR

SUSPAREA
(see note 2)

ECB_ADDRESS or
ECB_LIST_ADDRESS
(see note 3)

WAIT_MVS
WAIT_OLDC
WAIT_OLDW

IN
IN
IN

DSSR
TIME OF SUSPEND none      
TASKNO none      

TIMEOUT DUE
(see note 4)

none      
TT

INTERVAL and
DEADLOCK_ACTION

SUSPEND
WAIT_MVS
WAIT_OLDW
WAIT_OLDC

IN
IN
IN
IN

DSSR
TY none      
ATTACHER TOKEN USER_TOKEN

ATTACH
PURGE_INHIBIT_QUERY
TASK_REPLY
 
GET_NEXT
INQUIRE_TASK

OUT
OUT

DSAT
 
 
 
DSBR

ST none      
Note:
  1. Field S (for STATE) of the dispatcher task summary has a wider range of values than parameter STATE of DSBR functions GET_NEXT and INQUIRE_TASK. Parameter STATE can only have the values READY, RUNNING, or SUSPENDED. For the possible values of field S, see Dispatcher task summary fields.
  2. Parameters ECB_ADDRESS and ECB_LIST_ADDRESS only relate to SUSPAREA when the task has been suspended by the WAIT_MVS, WAIT_OLDW, or WAIT_OLDC functions of gate DSSR.
  3. Parameter ECB_LIST_ADDRESS is only valid for functions WAIT_MVS and WAIT_OLDW, and not for function WAIT_OLDC.
  4. If INTERVAL has been specified, the value of TIMEOUT DUE should be equal to INTERVAL + TIME OF SUSPEND.


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