DSAT gate, CHANGE_PRIORITY function
The CHANGE_PRIORITY function of DSAT gate has two effects. It changes the dispatch priority of the issuing task, and it causes control to be given up to another task.
Input Parameters
- PRIORITY
- Optional Parameter
- The dispatching precedence of a task. This parameter can have a value in the range 0 (low priority) through 255 (high priority).
Output Parameters
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- REASON
- Optional Parameter
- The values for the parameter are as follows:
- ABEND
- ACTIVATE_MODE_FAILED
- ADD_TCB_FAILED
- CANCEL_INHIBITED
- INSUFFICIENT_STORAGE
- INVALID_FORMAT
- INVALID_FRESH_TCB_USAGE
- INVALID_FUNCTION
- INVALID_MODENAME
- INVALID_MODENAME_TOKEN
- INVALID_STATE
- INVALID_STATE_PURGE
- INVALID_TASK_TOKEN
- INVALID_TCB_TOKEN
- LOCK_FAILED
- LOOP
- MODE_NOT_ACTIVE
- NO_TCBS_ACTIVE
- NOT_OPEN_MODE_TCB
- NOT_PURGEABLE
- NOT_SUBSPACE_ELIGIBLE
- SUSPEND_FAILED
- TASK_CANCELLED
- TCB_FAILED
- TCB_NOT_OWNED
- TIMED_OUT
- TOO_FEW_TCBS
- USER_TASK_SLOT_UNAVAILABLE
- OLD_PRIORITY
- Optional Parameter
- The former priority of the task. This parameter can have a value in the range 0 (low priority) through 255 (high priority).