DELETEQ TS
Summary
Delete a temporary storage queue. DELETEQ TS deletes all the data associated with a temporary storage queue. All storage associated used by the queue is freed. When a recoverable temporary storage queue is deleted, sync point must be issued before WRITEQ TS command for the same queue.
Syntax -
Parameters -
QNAME (name) -
Specifies an alternative to QUEUE, QNAME. Specifies the symbolic name (1 - 16 characters) of the queue to be deleted. The name should have 16-characters and padded with spaces if the length field has less than 16-characters.
Temporary Storage Queue can be created with dynamic names to avoid duplicate queues creation. Temporary Storage Queue name would be a combination of symbolic name (Program name most of the cases) and the timestamp (current time portion).
Ex - TEMPPROG11060309
If the queue defined as remote in CICS, the request will be transferred to remote system. If no SYSID is present, then based on the TST definition the Queue will be decided whether it is a local or remote. If SYSID presents, then system won’t check for TST entries and directly assumes that the queue is Remote one.
QUEUE (name) -
Specifies the symbolic name (1 - 8 characters) of the queue to be deleted. The name should have 8-characters and padded with spaces if the length field has less than 8-characters. If the queue defined as remote in CICS, the request will be transferred to remote system.
SYSID (system-name) -
Option is for remote and shared queues only. Specifies the system name (1 - 4 characters).
Error Conditions -
Below are the list of error conditions may occur in combination. If more than one occurs, only the first is passed to the application program.
| Error Condition | RESP2, Description & Solution | System Action |
|---|---|---|
| 16 INVREQ | Queue name specifies consisting of binary zeroes or queue locked and waiting for ISC recovery or queue created by CICS internal code. Solution -If queue name consists binary zeroes, modify the queue name and try again.If the queue is recoverable TSQ and waiting for ISC recovery, wait until the TSQ is recovered.If the queue is created by CICS internal code, use some other name for TSQ and try again. | Task abnormally terminated |
| 70 NOTAUTH | A resource security check has failed on QUEUE (name). Solution -Contact system administrator team to check whether the appropriate access added for the user or group. It will resolve the problem. | Task abnormally terminated |
| 44 QIDERR | Occurs when the queue specified cannot be found in Main storage, Auxiliary storage. Solution -This happens due to the Queue already might get deleted or queue name provided might wrong. Debug the application program flow and correct the logic. | Task abnormally terminated |
| 53 SYSIDERR | 4 - Occurs in any of the following situations:
| Task abnormally terminated |