SET TSQUEUE / TSQNAME

Delete a TS queue.

This section applies also to the alternative command SET TSQNAME. Use either to delete a queue with a name up to 8 characters long, use SET TSQNAME to delete a queue with a name up to 16 characters long.

Read syntax diagramSkip visual syntax diagramSET TSQUEUE
 
>>-SET --+-TSQUEUE(data-value)-+--+----------------------+------>
         '-TSQNAME(data-value)-'  +-SYSID(data-value)----+
                                  '-POOLNAME(data-value)-'
 
>--+------------------------------------------+----------------><
   +-ACTION(cvda)-+-------------------------+-+
   |              '-LASTUSEDINT(data-value)-' |
   '-DELETE-----------------------------------'
 

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

Description

The SET TSQUEUE command enables you to delete a TS queue. The LASTUSEDINT option may be used to ensure that the queue to be deleted has not been referenced since a previous INQUIRE was issued. It may also be used to delete queues which have not been referenced within a given interval. If a queue is recoverable, a separate task must be attached to perform the deletion.

Options

ACTION(cvda)
specifies the action to be taken on the queue. The CVDA value is:
DELETE
the queue is to be deleted.
LASTUSEDINT
if this option is specified, the queue is only deleted if its last used interval is greater or equal to the value specified.
POOLNAME(data-value)
specifies an 8-character pool name.
SYSID(data-value)
specifies a 4-character shared 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 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
The filetype was not valid for the specified operation.
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.
[[ Contents Previous Page | Next Page Index ]]