DELETEQ TS

Delete a temporary storage queue.

Read syntax diagramSkip visual syntax diagram
DELETEQ TS

>>-DELETEQ TS--+-QUEUE(name)-+--+-------------------+----------><
               '-QNAME(name)-'  '-SYSID(systemname)-'   

Conditions: INVREQ, ISCINVREQ, LOCKED, NOTAUTH, QIDERR, SYSIDERR

This command is threadsafe.

Note for dynamic transaction routing: Using this command could create inter-transaction affinities that adversely affect the use of dynamic transaction routing. See the CICS® Application Programming Guide for more information about transaction affinities.

Description

DELETEQ TS deletes all the temporary data associated with a temporary storage queue. All storage associated with the queue is freed.

You should delete temporary data as soon as possible to avoid using excessive amounts of storage.

When a recoverable temporary storage queue is deleted, you must issue a syncpoint before issuing a subsequent WRITEQ TS for the same queue.

Options

QUEUE(name)
specifies the symbolic name (1–8 characters) of the queue to be deleted. The name may not consist solely of binary zeros and must be unique within the CICS system. If the name has less than 8 characters, you must still use an 8-character field, padded with blanks if necessary.
QNAME(name)
an alternative to QUEUE, QNAME specifies the symbolic name (1–16 characters) of the queue to be deleted. The name may not consist solely of binary zeros and must be unique within the CICS system. If the name has less than 16 characters, you must still use a 16-character field, padded with blanks if necessary.
SYSID(systemname)
(remote and shared queues only) specifies the system name (1–4 characters) identifying the remote system or shared queue pool to which the request is directed.

Conditions

INVREQ
occurs in either of the following situations:
  • the queue was created by CICS internal code.
  • the queue name specified consists solely of binary zeroes.

Default action: terminate the task abnormally.

ISCINVREQ
occurs when the remote system indicates a failure that does not correspond to a known condition.

Default action: terminate the task abnormally.

LOCKED
occurs when the request cannot be performed because use of the queue has been restricted owing to a unit of work failing in-doubt.

Default action: terminate the task abnormally.

NOTAUTH
occurs when a resource security check has failed on QUEUE(name).

Default action: terminate the task abnormally.

QIDERR
occurs when the specified queue cannot be found in either main or auxiliary storage.

Default action: terminate the task abnormally.

SYSIDERR
occurs in any of the following situations:
  • 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)
  • When the link to the remote system is closed
  • When the CICS region in which the temporary storage command is executed fails to connect to the TS server managing the TS pool that supports the referenced temporary storage queue. (For example, this can happen if the CICS region is not authorized to access the temporary storage server).

    SYSIDERR can also occur if the temporary storage server has not been started, or because the server has failed (or been stopped) while CICS continues executing.

Default action: terminate the task abnormally.