DELETEQ TS


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 -


DELETEQ TS 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 ConditionRESP2, Description & SolutionSystem 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:
  • The specified SYSID name is not the local system or a remote system.
    Solution -The specified SYSID name is not related to any system. Correct it if required.
  • The link to the remote system is closed.
    Solution -This might be due to the remote system is not up and running. Contact remote system support team.
  • The CICS region specified fails to connect to the TS server supports the referenced temporary storage queue.
    Solution -This issue due to the connectivity issue. Restart the CICS region might solve the issue. Otherwise, contact the system administrator to resolve the issue.
Task abnormally terminated