Delete all transient data.
Conditions: DISABLED, INVREQ, ISCINVREQ, LOCKED, NOTAUTH, QIDERR, SYSIDERR
This command is threadsafe when it is used with
a queue in a local CICS region, or function shipped to a remote CICS
region over an IPIC connection. It is non-threadsafe when it is function
shipped to a remote CICS region over another type of connection.
Description
DELETEQ TD deletes all the transient data associated with a particular intrapartition destination (queue). All storage associated with the destination is released (deallocated). Note that you cannot use this command to delete an extrapartition transient data queue. An attempt to do so results in an INVREQ condition.
Options
- QUEUE(name)
- Specifies
the symbolic name (1 - 4 alphanumeric characters) of the queue to
be deleted. The named queue must be defined to CICS®.
If SYSID is specified, the queue is assumed to be on a remote system, irrespective of how it is defined. Otherwise the resource definition is used to find out whether the queue is on a local or a remote system.
- SYSID(systemname)
- (remote systems only) Specifies the name (1 - 4 characters) of the system the request is directed.
Conditions
- 84 DISABLED
- Occurs
when the queue has been disabled.
Default action: terminate the task abnormally.
- 16 INVREQ
- Occurs
if DELETEQ names an extrapartition queue.
Default action: terminate the task abnormally.
- 54 ISCINVREQ
- Occurs
when the remote system indicates a failure that does not correspond
to a known condition.
Default action: terminate the task abnormally.
- 100 LOCKED
- Occurs
when the request cannot be performed because use of the queue has
been restricted owing to a unit of work failing indoubt. This can
happen on any request for a logically-recoverable queue defined with
WAIT(YES) and WAITACTION(REJECT) in the TDQUEUE resource definition.
Specify WAIT(YES) and WAITACTION(QUEUE) in the TDQUEUE resource definition if you want the transaction to wait.
Default action: terminate the task abnormally.
- 70 NOTAUTH
- Occurs
when a resource security check has failed on QUEUE(name).
Default action: terminate the task abnormally.
- 44 QIDERR
- Occurs
if the symbolic destination to be used with DELETEQ TD cannot be found.
Default action: terminate the task abnormally.
- 53 SYSIDERR
- Occurs
when the SYSID option specifies a name that is neither the local system
nor a remote system (made known to CICS by defining a CONNECTION or an IPCONN). SYSIDERR also occurs when the link to
the remote system is closed.
Default action: terminate the task abnormally.
