DSAT gate, ATTACH function

The ATTACH function of the DSAT gate is used to attach a new task.

Input Parameters

PRIORITY

affects a task's dispatching precedence. It can have a value in the range 0 (low priority) through 255 (high priority).

TYPE

is the type of task.

Values for the parameter are:

• NON_SYSTEM
• SYSTEM

USER_TOKEN

is the token by which the task to be attached is known to the caller.

MODE

Optional Parameter

specifies the mode in which the task is to run.

Values for the parameter are:

• CO
• FO
• QR
• RO
• RP
• SZ

SPECIAL_TYPE

Optional Parameter

identifies the special task SMSY.

Values for the parameter are:

• SMSY

TASK_REPLY_GATE_INDEX

Optional Parameter

is used when a gate other than the attaching domain's default gate is to receive a resultant TASK_REPLY.

TIMEOUT

Optional Parameter

is the deadlock timeout interval, in milliseconds.

TRANSACTION_TOKEN

Optional Parameter

identifies the transaction associated with the attached task.

TRANSACTION_BUILD

Optional Parameter

Values for the parameter are:

• BUILD
• TERMINATE

Output Parameters

REASON

The following values are returned when RESPONSE is DISASTER:

• ABEND
• LOOP
• TRANSACTION_ABEND
• TRANSACTION_ERROR_MSG
• USER_TASK_SLOT_UNAVAILABLE

The following values are returned when RESPONSE is EXCEPTION:

• INSUFFICIENT_STORAGE

RESPONSE

Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.

TASK_TOKEN

is the token by which the attached task is known to the dispatcher.