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.

You cannot alter the following attributes unless the queue is fully disabled:

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

Press the Clear key to clear the screen. You can start this transaction in two ways:

Type CEMT SET TDQUEUE (or suitable abbreviations for the keywords), followed by (value) or ALL. 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) or ALL, 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.

Typing ? at the beginning of either the first or second line gives a syntax prompt. Resetting the values takes effect immediately.

CEMT SET TDQUEUE

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.