TDTM gate, INQUIRE_TDQDEF function
The INQUIRE_TDQUEUE function of the TDTM gate is used to inquire on a specified queue.
Input Parameters
- QUEUE_NAME
- The name of the queue.
Output Parameters
- REASON
- The values for the parameter are:
- DIRECTORY_MGR_ERROR
- LOGIC_ERROR
- QUEUE_NOT_FOUND
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- ATI_FACILITY
- Optional Parameter
- The facility associated with this intrapartition queue when a trigger transaction is attached.
- Values for the parameter are:
- NOTERM
- TERM
- ATI_TERMID
- Optional Parameter
- Specified together with the FACILITY option, FACILITY_ID identifies the facility that the trigger transaction should be associated with.
- ATI_TRANID
- Optional Parameter
- The ATI transaction to be invoked when the trigger level is reached.
- BLOCK_LENGTH
- Optional Parameter
- The block length of an extrapartition queue.
- BUFFER_NUMBER
- Optional Parameter
- The number of buffers to be associated with an extrapartition queue.
- DDNAME
- Optional Parameter
- The DDNAME associated with an extrapartition queue.
- DISPOSITION
- Optional Parameter
- The disposition of the data set associated with an extrapartition queue.
- Values for the parameter are:
- MOD
- OLD
- SHR
- DSNAME
- Optional Parameter
- The DSNAME of the data set associated with the extrapartition queue.
- EMPTY_STATUS
- Optional Parameter
- Indicates whether the queue contains any records, and whether the queue is full. This option applies to extrapartition queues only.
- Values for the parameter are:
- EMPTY
- FULL
- NOTEMPTY
- ENABLE_STATUS
- Optional Parameter
- The status of the queue.
- Values for the parameter are:
- DISABLED
- DISABLING
- ENABLED
- ERROR_OPTION
- Optional Parameter
- The action is to be taken in the event of an I/O error. This option applies to extrapartition queues only.
- Values for the parameter are:
- IGNORE
- SKIP
- INDIRECT_DEST
- Optional Parameter
- The destination queue if this queue is an indirect queue.
- MEMBER
- Optional Parameter
- The member name when a PDS member is used for an extrapartition queue.
- NUM_ITEMS
- Optional Parameter
- The number of committed items in the queue.
- OPEN_STATUS
- Optional Parameter
- Indicates whether the queue is open.
- Values for the parameter are:
- CLOSED
- OPEN
- RECORD_FORMAT
- Optional Parameter
- The format of the records held on the extrapartition queue.
- Values for the parameter are:
- FIXBLK
- FIXBLKA
- FIXBLKM
- FIXUNB
- FIXUNBA
- FIXUNBM
- UNDEFINED
- VARBLK
- VARBLKA
- VARBLKM
- VARUNB
- VARUNBA
- VARUNBM
- RECORD_LENGTH
- Optional Parameter
- The record length of the extrapartition queue.
- RECOVERY
- Optional Parameter
- The recovery type of an intrapartition queue.
- Values for the parameter are:
- LG
- NO
- PH
- REMOTE_NAME
- Optional Parameter
- The remote name of the queue if this is a remote queue definition.
- REMOTE_SYSTEM
- Optional Parameter
- The remote system identifier (SYSID) for a remote queue definition.
- REWIND
- Optional Parameter
- Where the tape is positioned in relation to the end of the data set. This parameter applies to extrapartition queues only.
- Values for the parameter are:
- LEAVE
- REREAD
- SYSOUTCLASS
- Optional Parameter
- The SYSOUT class to be used for the associated output extrapartition queue.
- TD_QUEUE_TOKEN
- Optional Parameter
- The token associated with the queue.
- TD_TYPE
- Optional Parameter
- The queue type.
- Values for the parameter are:
- EXTRA
- INDIRECT
- INTRA
- REMOTE
- TERMINAL_ID
- Optional Parameter
- The terminal associated with a transaction that is invoked when the trigger level is reached.
- TRANSACTION_ID
- Optional Parameter
- The ATI transaction to be invoked when the trigger level is reached.
- TRIGGER_LEVEL
- Optional Parameter
- The trigger level of the intrapartition queue.
- TYPE_FILE
- Optional Parameter
- specifies whether this queue is:
- an input queue
- an output queue
- a queue that is to be read backwards.
- Values for the parameter are:
- INPUT
- OUTPUT
- RDBACK
- USERID_TOKEN
- Optional Parameter
- A token for the USERID that was specified for this intrapartition queue.
- WAIT
- Optional Parameter
- Specifies whether this logically recoverable intrapartition queue can wait for the resolution of an indoubt failure.
- Values for the parameter are:
- NO
- YES
- WAIT_ACTION
- Optional Parameter
- The action to be taken if this logically recoverable intrapartition queue suffers an indoubt failure.
- Values for the parameter are:
- QUEUE
- REJECT