SET TSQUEUE / TSQNAME

Delete a temporary storage (TS) queue. You can also use the alternative command SET TSQNAME. Use either command to delete a queue with a name up to 8 characters long and use SET TSQNAME to delete a queue with a name up to 16 characters long.

SET TSQUEUE

Conditions: INVREQ, NOTAUTH, NOTFND, POOLERR, QIDERR, SYSIDERR

This command is threadsafe.

Description

The SET TSQUEUE command deletes a TS queue. You can use the LASTUSEDINT option to ensure that the queue to delete has not been referenced since a previous INQUIRE was issued. You can also use the LASTUSEDINT option to delete queues that have not been referenced in a given interval. If a queue is recoverable, a separate task must be attached to perform the deletion.

The maximum number of TS queues that you can delete by using a single command is 32766. If this limit is exceeded, the request fails and no queues are deleted.

Options

ACTION(cvda)

Specifies the action to take on the queue. The CVDA value is as follows:

DELETE: Delete the queue.

LASTUSEDINT(data-value)

If this option is specified, the queue is deleted only if its last used interval is greater or equal to the value specified. Specify the value in seconds.

POOLNAME(data-value)

Specifies an 8-character pool name.

SYSID(data-value)

Specifies a 4-character shared system identifier (sysid).

TSQNAME(data-value)

Specifies the 1 to 16-character identifier of the TS queue.

TSQUEUE(data-value)

Specifies the 1 to 8-character identifier of the TS queue.

Conditions

INVREQ

RESP2 values:

1: The TSQUEUE was not deleted because LASTUSEDINT was greater than the interval, or because the TSQUEUE is in use.
2: The action specified was not DELETE
3: LASTUSEDINT was specified but had an invalid value; that is, a negative value.
4: Invalid queue type.

NOTAUTH

RESP2 values:

100: The user associated with the issuing task is not authorized to use this command.
101: The user associated with the issuing task is not authorized to access this particular resource in the way required by this command.

NOTFND

RESP2 values:

1: The TSQUEUE cannot be found.

POOLERR

RESP2 values:

0: POOLNAME was specified but the pool could not be accessed.

QIDERR

RESP2 values:

1: The QUEUE name was invalid; (it was binary zeros).

SYSIDERR

RESP2 values:

0: SYSID was specified but there is no corresponding pool, or the pool is unavailable.
3: The SYSID does not map to a shared pool.
4: Server error.
5: I/O error on coupling facility.