Delete a temporary storage queue (TS queue).
This topic applies also to the alternative command, CEMT
SET TSQNAME. In CEMT you can use either command to operate
on temporary storage queues (TS queues) with names up to 16 characters
long.
In the CICS Explorer, the TS queues operations view provides
a functional equivalent to this command.
Description
You can use the SET TSQUEUE
command to delete a temporary storage queue (TS queue).
You
can use the LASTUSEDINT option to ensure that the queue to be deleted
has not been referenced since a previous INQUIRE was issued. You can
also use this option to delete queues that have not been referenced
in a given interval.
Syntax
CEMT SET TSQUEUE
.-ALL-----.
>>-CEMT SET TSQUEUE--+---------+--+-----------------+----------->
'-(value)-' +-SYSID(value)----+
'-POOLNAME(value)-'
>--+--------------------+--+-ACTION(value)-+-------------------><
'-LASTUSEDINT(value)-' '-DELETE--------'
Options
- (value)
- Specifies
the identifier of the TS queue.
- ALL
- Specifies
that any changes you request are made to all resources of the specified
type that you are authorized to access, up to a maximum of 32766.
If this limit is exceeded, the request fails and no resources are
updated.
- ACTION(value)
- Specifies
the action to be taken on the queue. The values are:
- 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.
- TSQUEUE(data-value)
- Specifies
the 16-character identifier of the TS queue.