DSBR gate, INQUIRE_TASK function
The INQUIRE_TASK function of DSBR gate returns information about a specified task.
Input Parameters
- INPUT_TASK_TOKEN
- Optional Parameter
- is the token for the task to be inquired on.
Output Parameters
- REASON
- The values for the parameter are:
- INVALID_TASK_TOKEN
- NOT_SUPPORTED
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- CANCEL_PENDING
- Optional Parameter
- Not supported by domain gate function.
- Values for the parameter are:
- CLEARED
- FORCE
- KILL
- NONE
- NORMAL
- DEFERRED_ABEND_CODE
- Optional Parameter
- Not supported by domain gate function.
- DOMAIN_INDEX
- Optional Parameter
- is the 2-character index identifying the domain that made the ATTACH call for the task.
- ESSENTIAL_TCB
- Optional Parameter
- indicates whether the TCB is an essential TCB or not.
- Values for the parameter are:
- ESSENTIAL_NO
- ESSENTIAL_YES
- KERNEL_TOKEN
- Optional Parameter
- is the token by which the task is known to the kernel.
- MODE
- Optional Parameter
- is the mode in which the task is to run.
- Values for the parameter are:
- CO
- FO
- QR
- RO
- RP
- SZ
- OPEN_MODES
- Optional Parameter
- is a 32-bit string which indicates which modes of open TCBs were used by this task.
- PRIORITY
- Optional Parameter
- is the task's dispatch priority. It can have a value in the range 0 (low priority) through 255 (high priority).
- RESOURCE_NAME
- Optional Parameter
- is the name of the resource that the task is waiting for, if the task is suspended.
- RESOURCE_TIME
- Optional Parameter
- is the interval of time that has passed since the task last issued a suspend or wait.
- RESOURCE_TYPE
- Optional Parameter
- is the type of resource that the task is waiting for, if the task is suspended.
- STATE
- Optional Parameter
- is the state of the task.
- Values for the parameter are:
- READY
- RUNNING
- SUSPENDED
- SUSPEND_TOKEN
- Optional Parameter
- is the token by which the dispatcher recognizes a task to be suspended or resumed.
- TASK_TOKEN
- Optional Parameter
- is the token by which the attached task is known to the dispatcher.
- TCB_TOKEN
- Optional Parameter
- is the TCB token associated with the task.
- TCB_TYPE
- Optional Parameter
- is the type of TCB that the task is executing on.
- Values for the parameter are:
- CKOPEN_TCB
- INTERNAL_TCB
- QR_TCB
- UKOPEN_TCB
- TYPE
- Optional Parameter
- is the type of task.
- Values for the parameter are:
- NON_SYSTEM
- SYSTEM
- USER_TOKEN
- Optional Parameter
- is the token by which the task is known to the caller that made the ATTACH request for the task.