TDTM gate, ADD_REPLACE_TDQDEF function

Install a transient data queue definition.

Input Parameters

CATALOG_TDQ
Indicates whether to catalog the queue when it is installed.
Values for the parameter are:
  • NO
  • YES
QUEUE_NAME
The name of the queue to be installed.
TD_QUEUE_TOKEN
Can be specified instead of QUEUE. The token uniquely identifies a transient data queue definition that has already been created, but needs to be installed.
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 to be associated with an extrapartition queue.
DISPOSITION
Optional Parameter
The disposition of the data set to be associated with an extrapartition queue.
Values for the parameter are:
  • MOD
  • OLD
  • SHR
DSNAME
Optional Parameter
The DSNAME of the data set to be associated with an extrapartition queue.
ERROR_OPTION
Optional Parameter
The action to be taken in the event of an I/O error. This input parameter applies to extrapartition queues only.
Values for the parameter are:
  • IGNORE
  • SKIP
FACILITY
Optional Parameter
The facility associated with this intrapartition queue when a trigger transaction is attached.
Values for the parameter are:
  • FILE
  • SYSTEM
  • TERMINAL
FACILITY_ID
Optional Parameter
Specified together with the FACILITY option, FACILITY_ID identifies the facility that the trigger transaction should be associated with.
INDIRECT_DEST
Optional Parameter
The destination queue if this queue is an indirect queue.
OPEN_TIME
Optional Parameter
Specifies whether this extrapartition queue should be opened as part of installation processing.
Values for the parameter are:
  • DEFERRED
  • INITIAL
RECORD_FORMAT
Optional Parameter
The format of records held in an extrapartition queue.
Values for the parameter are:
  • FIXBLK
  • FIXBLKA
  • FIXBLKM
  • FIXUNB
  • FIXUNBA
  • FIXUNBM
  • UNSPECIFIED
  • VARBLK
  • VARBLKA
  • VARBLKM
  • VARUNB
  • VARUNBA
  • VARUNBM
RECORD_LENGTH
Optional Parameter
The record length of an extrapartition queue in bytes.
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) if this is a remote queue definition.
REWIND
Optional Parameter
For extrapartition queues only, where the tape is positioned in relation to the end of the data set.
Values for the parameter are:
  • LEAVE
  • REREAD
SYSOUTCLASS
Optional Parameter
The SYSOUT class to be used for the associated output extrapartition 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
indicates whether this queue is:
  • an input queue
  • an output queue
  • to be read backwards.
Values for the parameter are:
  • INPUT
  • OUTPUT
  • RDBACK
USERID
Optional Parameter
The userid to be associated with a trigger-level attached transaction.
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

Output Parameters

REASON
The values for the parameter are:
  • CATALOG_WRITE_FAILED
  • COLD_START_IN_PROGRESS
  • DDNAME_NOT_FOUND
  • DFHINTRA_NOT_OPENED
  • DIRECTORY_MGR_ERROR
  • DISABLE_PENDING
  • DUPLICATE
  • INSUFFICIENT_STORAGE
  • INVALID_FUNCTION
  • LOGIC_ERROR
  • NOT_CLOSED
  • NOT_DISABLED
  • NOT_SAME_TYPE
  • QUEUE_NOT_OPENED
  • SECURITY_FAILURE
  • USERID_NOTAUTHED
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.


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