DISCARD TDQUEUE

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.