DELETEQ TS
Delete a temporary storage queue.
Conditions: INVREQ, ISCINVREQ, LOCKED, NOTAUTH, QIDERR, SYSIDERR
This command is threadsafe when it is used with a queue in main storage or auxiliary storage, either in a local CICS® region, or function shipped to a remote CICS region over an IPIC connection. It is also threadsafe when it is used with a queue in a shared temporary storage pool in a z/OS® coupling facility that is managed by a temporary storage data sharing server (TS server). The command is non-threadsafe when it is function shipped to a remote CICS region over another type of connection other than IPIC.
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 sync point before issuing a subsequent WRITEQ TS command for the same queue.
Options
- QNAME(name)
- An alternative to QUEUE, QNAME specifies the symbolic name (1 - 16 characters) of the queue to be deleted. The name must not consist solely of binary zeros and must be unique in the CICS system. If the name has less than 16 characters, you must still use a 16-character field, padded with blanks if necessary.
- QUEUE(name)
- Specifies the symbolic name (1 - 8 characters) of the queue to be deleted. The name cannot 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.
- 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. Note that TSMODEL resource definitions do not support specifying a SYSID for a queue that resides in a temporary storage data sharing pool. Use the QUEUE or QNAME option instead. Using an explicit SYSID for a shared queue pool requires the support of a temporary storage table (TST).
Conditions
- 16 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.
- 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.
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
when the specified queue cannot be found in either main or auxiliary
storage.
Default action: terminate the task abnormally.
- 53 SYSIDERR
- Occurs
in any of the following situations:
- The SYSID option specifies a name that is not the local system or a remote system (made known to CICS by defining a CONNECTION or an IPCONN).
- When IPIC connectivity is used, the local system, the remote system, or both, are not CICS TS 4.2 or later regions.
- The link to the remote system is closed.
- 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 situation can occur if the CICS region is not authorized to
access the temporary storage server.
This condition can also occur if the temporary storage server is not started, or because the server has failed (or been stopped) while CICS continues to run.
Default action: terminate the task abnormally.