DELETEQ TD

Delete all transient data.

DELETEQ TD

Read syntax diagramSkip visual syntax diagramDELETEQ TDQUEUE( name)SYSID( systemname)

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.