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.