CEMT SET TDQUEUE
Changes the attributes of transient data queues.
In the CICS Explorer, the TD Queues operations view provides a functional equivalent to this command.
Description
The SET TDQUEUE command changes some of the attributes of a transient data queue. The queue must not be REMOTE or INDIRECT.
- ATIFACILITY
- ATITERMID
- ATITRANID
To disable a transient data destination, the queue must
not currently be in use. If it is in use, the queue enters a disable
pending
state. The last unit of work (UOW) to use the queue fully
disables it. You can alter the TRIGGERLEVEL, OPENSTATUS, and ENABLESTATUS
attributes regardless of whether the queue is enabled or disabled.
You cannot alter the value of the ENABLESTATUS attribute while a queue
is in a disable pending
state.
A transient data queue cannot be disabled while it is in use, or while tasks are waiting to use it.
Indirect and remote queues can be disabled at any time because they have no concept of being in use.
If tasks
are waiting to use an extrapartition queue, a physically recoverable
queue, or a nonrecoverable intrapartition queue and an attempt is
made to disable the queue, the queue enters a disable pending
state.
The last task to use the extrapartition queue fully disables it.
If
an attempt is made to disable a logically recoverable intrapartition
TD queue when there are UOWs enqueued upon it, the queue enters a disable
pending
state. The last UOW to obtain the enqueue fully disables
the queue. If a UOW has updated a logically recoverable queue and
suffers an indoubt failure, the queue cannot be disabled until the
indoubt failure has been resolved.
If a UOW owns an enqueue
on a queue that is in a disable pending
state, it is allowed
to continue making updates.
When a queue is in a disable
pending
state, no new tasks can alter the queue's state or its
contents. A disabled response is returned when a READQ, WRITEQ, or
DELETEQ request is issued against a destination that is in a disable
pending
state.
If a task updates a logically recoverable
transient data queue, and attempts to disable the queue and alter
an attribute of the queue (for example, ATITRANID) in the same UOW,
the call fails. This is because the UOW is a user of the queue, and
the queue enters a disable pending
state. The SET operation
on the queue attribute, in this case ATITRANID, fails. The queue does
not become fully disabled until the UOW commits or backs out at syncpoint.
You are recommended to issue an EXEC CICS SYNCPOINT command
before you use the SET TDQUEUE command to update
the queue attribute (ATITRANID).
Syntax
- Type
CEMT SET TDQUEUE
(or suitable abbreviations for the keywords), followed by (value) orALL
. The resulting display lists the current status, similar to that obtained by using the CEMT INQUIRE TDQUEUE command. You can tab to the highlighted or blank fields and overtype them with the required values. - Type
CEMT SET TDQUEUE
(or suitable abbreviations for the keywords), followed by(value)
orALL
, then followed by one or more attribute settings that you wish to change. For example,cemt s td(value) en op
makes a named extrapartition queue accessible by applications and open.
?
at the beginning of either the first
or second line gives a syntax prompt. Resetting the values takes effect
immediately. Options
- (value)
- The 1- to 4-character identifier of a transient data queue.
- ALL
- Specifies that any changes you request are made to all resources of the specified type that you are authorized to access.
- CLOSED
- The queue is closed.
- DISABLED
- The queue cannot be accessed by applications, although it can still be open. A queue that has had an indoubt failure cannot be disabled.
- ENABLED
- The queue can be accessed by applications.
- OPEN
- The extrapartition queue is open.
- TRIGGERLEVEL (value)
- Specifies the number of requests for output to a queue that must occur before automatic transaction initiation (ATI) occurs. The value can be 0 - 32767. A value of zero disables ATI.