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.
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).
| Field | Related parameter | Function | Input or output | Gate |
|---|---|---|---|---|
| AD | DOMAIN_INDEX | INQUIRE_TASK |
IN |
DSBR |
| DTA | ATTACH_TOKEN | CREATE_TASK | IN | KEDS |
| DS_TOKEN | TASK_TOKEN | ATTACH |
OUT |
DSAT |
| KE_TASK | TASK_TOKEN | CREATE_TASK |
OUT |
KEDS |
| MO | MODE | ATTACH |
IN |
DSAT |
| P | PURGEABLE | SUSPEND |
IN |
DSSR |
| PS | none | |||
| RESOURCE NAME | RESOURCE_NAME | ADD_SUSPEND |
IN |
DSSR |
| RESOURCE TYPE | RESOURCE_TYPE | ADD_SUSPEND |
IN |
DSSR |
| S |
STATE | GET_NEXT |
OUT |
DSBR |
| SUSPAREA |
ECB_ADDRESS or |
WAIT_MVS |
IN |
DSSR |
| TIME OF SUSPEND | none | |||
| TASKNO | none | |||
| TIMEOUT DUE |
none | |||
| TT | INTERVAL and |
SUSPEND |
IN |
DSSR |
| TY | none | |||
| ATTACHER TOKEN | USER_TOKEN | ATTACH |
OUT |
DSAT |
| ST | none |
- 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.
- 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.
- Parameter ECB_LIST_ADDRESS is only valid for functions WAIT_MVS and WAIT_OLDW, and not for function WAIT_OLDC.
- If INTERVAL has been specified, the value of TIMEOUT DUE should be equal to INTERVAL + TIME OF SUSPEND.