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).


dfhs3_DSATchange_priority.html | Timestamp icon Last updated: Monday, 5 June 2017