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.


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