DISCARD TDQUEUE
Remove a transient data queue definition.
Syntax
Activate security checks on commands by specifying the XCMD system initialization parameter and by ensuring that command security checking is active for the transaction (either by specifying CMDSEC(YES) on the TRANSACTION resource definition or by specifying ALWAYS on the CMDSEC system initialization parameter).
Conditions: INVREQ, NOTAUTH, QIDERR
NOHANDLE, RESP, and
RESP2 are common options that can be added to all EXEC CICS
commands to process error conditions. They are not explicitly included in the command syntax diagram
and option descriptions. For information about these common options and EXEC CICS
command syntax, see EXEC CICS command format and programming considerations.
This command is threadsafe.
Description
The DISCARD TDQUEUE command removes the definition of a transient data queue from the local CICS® system.
A queue must be disabled before it can be discarded, and an extrapartition queue must be closed as well. See Discarding resource definitions for rules governing disabling of queues. Queues required by CICS (those whose names begin with the letter C) cannot be discarded.
When an intrapartition queue is discarded, an implicit DELETEQ command is executed to empty the queue and release space in the data set associated with it. If the queue is defined as logically recoverable, an implicit SYNCPOINT command follows the DELETEQ. The SYNCPOINT commits all changes to recoverable resources made up to that point in the task that issued the DISCARD TDQUEUE command. However, deletion and syncpoint take place only if the command completes successfully, without raising any exception conditions.
See Discarding resource definitions for general information about discards.
Options
- TDQUEUE(data-value)
- specifies the 4-character name of the transient data queue that is to be removed.
Conditions
- INVREQ
- RESP2 values:
- 11
- The queue name begins with the letter C.
- 18
- The queue is not closed.
- 30
- The queue is in
disable pending
status (that is, the disabling process is not completed). - 31
- The queue is not disabled.
- 200
- The command was executed in a program defined with an EXECUTIONSET value of DPLSUBSET or a program invoked from a remote system by a distributed program link without the SYNCONRETURN option.
- NOTAUTH
- RESP2 values:
- 100
- The user associated with the issuing task is not authorized to use this command.
- 101
- The user associated with the issuing task is not authorized to access this particular resource in the way required by this command.
- QIDERR
- RESP2 values:
- 1
- The queue cannot be found.