Exception Conditions
INVREQ
occurs if: v
PURGETYPE has an incorrect CVDA value (RESP2=3) v
The named task is not in a valid state for purging (RESP2=5)
Default action: Terminate the task abnormally.
TASKIDERR
occurs if: v
The named task cannot be found (RESP2=1) v
The named task is protected by CICS; that is, it is a CICS-supplied transaction that is normally invoked from within CICS and not by an operator
Default action: Terminate the task abnormally.
SET TDQUEUE
(
name
)
ATIFACILITY
TERMINAL
NOTERMINAL
(
cvda
) ATITERMID (
data-value
)
ATITRANID (
data-value
) ENABLESTATUS
ENABLED
DISABLED
(
cvda
) OPENSTATUS
OPEN
CLOSED
(
cvda
)
TRIGGERLEVEL (
data-value
)
Conditions:
INVREQ, IOERR, QIDERR
The EXEC CICS SET TDQUEUE command changes some of the information of a named transient data queue definition in the control region. The queue definition must not be remote or indirect.
Options
ATIFACILITY(cvda) (intrapartition queues only)
causes the specified queue to associate, or not, a terminal (or session) with the task to be started when the TRIGGERLEVEL value is reached. The input
CVDA values are:
TERMINAL
A terminal (or session) is associated with the task.
NOTERMINAL
A terminal (or session) is not associated with the task.
ATITERMID(data-value) (intrapartition queues only)
causes the specified queue to use the value as the terminal (or session) that is associated with the task to be started when the TRIGGERLEVEL value is reached.
518
CICS for iSeries Application Programming Guide V5
ATITRANID(data-value) (intrapartition queues only)
causes the specified queue to use the value as the transaction that is associated with the task to be started when the TRIGGERLEVEL value is reached.
ENABLESTATUS(cvda)
causes the specified queue to allow or not allow use by application programs.
The input CVDA values are:
ENABLED
The queue is available for use by application programs.
DISABLED
The queue is unavailable for use by application programs, though it may still be OPEN. Any queue whose name begins with the letter “C” cannot be disabled, because this identifies
CICS’s own queues.
OPENSTATUS(cvda) (extrapartition queues only)
causes the specified queue to be opened or closed. The input CVDA values are:
OPEN
CLOSED
The queue is to be opened.
The queue is to be closed.
Note:
A queue that is disabled cannot be opened or closed.
TDQUEUE(name)
is the name of the queue as specified in the DEST parameter within the
OS/400 ADDCICSDCT CL command. The name may be up to 4 characters long.
TRIGGERLEVEL(data-value) (intrapartition queues only)
specifies as a fullword binary value the number of records that can be written to the queue before automatic transaction initiation (ATI) occurs. The number must be in the range 0 through 32 767.
Exception Conditions
INVREQ
occurs if: v
TRIGGERLEVEL was specified for an extrapartition queue (RESP2=2) v TRIGGERLEVEL value is not in the range 0–32767 (RESP2=3) v
ATITERMID was specified for an extrapartition queue (RESP2=4) v
ATITRANID was specified for an extrapartition queue (RESP2=5) v
ATIFACILITY was specified for an extrapartition queue (RESP2=6) v
ATIFACILITY was specified with an invalid CVDA value (RESP2=7) v
OPENSTATUS was specified with an invalid CVDA value (RESP2=8) v
OPENSTATUS was specified for an intrapartition queue (RESP2=9) v
ENABLESTATUS was specified with an invalid CVDA value (RESP2=10) v
DISABLED was specified for a queue whose name begins with “C”
(RESP2=11) v The named queue is remote (RESP2=12) v
The named queue is indirect (RESP2=13) v
OPEN or CLOSED was specified for a DISABLED queue (RESP2=15) v
TRIGGERLEVEL is specified but the ATI transaction does not exist
(RESP2=17)
Default action: Terminate the task abnormally.
Chapter 33. System programming reference
519
