Dispatcher domain’s generic formats

Table 48 describes the generic formats owned by the dispatcher domain and shows the functions performed on the calls.

Table 48. Generic formats owned by dispatcher domain
Format Calling modules Functions
DSAT
DFHDSKE
DFHDSDS4
DFHSJIN
DFHSMVN
TASK_REPLY
PURGE_INHIBIT_QUERY
FORCE_PURGE_INHIBIT_QUERY
NOTIFY_DELETE_TCB

In the descriptions of the formats that follow, the "input" parameters are input not to the dispatcher, but to the domain being called by the dispatcher. Similarly, the "output" parameters are output by the domain that was called by the dispatcher, in response to the call.

DSAT format, TASK_REPLY function

The TASK_REPLY function of DSAT format is used to notify the domain that attached a task that the task has had its first dispatch.

Input parameters

USER_TOKEN
is the token by which the task that has been dispatched is known to the called domain.
TASK_TOKEN
is the token by which the task that has been dispatched is known to the dispatcher.
SUSPEND_TOKEN
is the suspend token that the task can be suspended against by default.

Output parameters

RESPONSE
is the called domain’s response to the call. It can have any one of these values:
OK|DISASTER|INVALID|KERNERROR

DSAT format, PURGE_INHIBIT_QUERY function

The PURGE_INHIBIT_QUERY function of DSAT format is used by the dispatcher to see if a task selected for purge can be purged. Its main purpose is to find out from the AP domain whether the task is currently purgeable by the system.

Input parameters

USER_TOKEN
is the token by which the task that has been dispatched is known to the called domain.
TASK_TOKEN
is the token by which the task that has been dispatched is known to the dispatcher.

Output parameters

PURGE_INHIBITED_RESPONSE
states whether the task can be purged. It can have either of these values:
YES|NO
RESPONSE
always has the value OK.

DSAT format, FORCE_PURGE_INHIBIT_QUERY function

The FORCE_PURGE_INHIBIT_QUERY function of DSAT format is used by the dispatcher to see if a task selected for purge can be forcepurged. Its main purpose is to find out from the AP domain whether the task is currently purgeable by the system.

Input parameters

USER_TOKEN
is the token by which the task that has been dispatched is known to the called domain.
TASK_TOKEN
is the token by which the task that has been dispatched is known to the dispatcher.

Output parameters

PURGE_INHIBITED_RESPONSE
states whether the task can be purged. It can have either of these values:
YES|NO
RESPONSE
always has the value OK.

DSAT format, NOTIFY_DELETE_TCB function

The NOTIFY_DELETE function of DSAT format notifies the interested domain (as specified in the NOTIFY_DELETE parameter on the DSIT ACTIVATE_MODE request for the mode) that a DELETE_TCB request is in progress.

Input parameters

TCB_TOKEN
The DS token representing the TCB instance for which notification is required when deleted.

Output parameters

RESPONSE
is the dispatcher’s response to the call. It can have only one value:
OK
[[ Contents Previous Page | Next Page Index ]]