CEMT INQUIRE TDQUEUE

Retrieve information about transient data queues.

In the CICS Explorer, the TD Queues operations view provides a functional equivalent to this command.

Description

The INQUIRE TDQUEUE command returns information about a named transient data (TD) queue that is defined in a TDQUEUE resource definition.

The resource signature

You can use this command to display the resource signature fields. You can use these fields to manage resources by capturing details of when the resource was defined, installed, and last changed. For more information, see Auditing resources. The resource signature fields are CHANGEAGENT, CHANGEAGREL, CHANGETIME, CHANGEUSRID, DEFINESOURCE, DEFINETIME, INSTALLAGENT, INSTALLTIME, and INSTALLUSRID. See Summary of the resource signature field values for detailed information about the content of the resource signature fields.

Input

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

Type CEMT INQUIRE TDQUEUE (or suitable abbreviations for the keywords). The resulting display lists the current status.
Type CEMT INQUIRE TDQUEUE (or suitable abbreviations for the keywords) followed by the attributes that are necessary to limit the range of information that you require. For example, if you enter cemt i td ind en, the resulting display shows the details of only those transient data queues that are indirect and enabled.

You can change various attributes in the following ways:

Overtype your changes on the INQUIRE screen after tabbing to the appropriate field. See Overtyping a display.
Use the CEMT SET TDQUEUE command.

(value): The 1 - 4 character identifier of a transient data queue.
ALL: The default.

Sample screen

Figure 1. Example CEMT INQUIRE TDQUEUE screen

 IN TDQ
 STATUS:  RESULTS - OVERTYPE TO MODIFY
  Tdq(CADL)              Ind Nam(CSSL)
  Tdq(CAIL)              Ind Nam(CSSL)
  Tdq(CCPI)              Ind Nam(CSSL)
  Tdq(CCSE)              Ind Nam(CCSO)
  Tdq(CCSO)              Ext           Ena Ope
                             Mod Out Dat(001) Ddn(COUT    )
  Tdq(CDBC)              Ind Nam(CSSL)
  Tdq(CDUL)              Ind Nam(CSSL)
  Tdq(CESE)              Ext           Ena Ope
                             Shr Out Dat(001) Ddn(CEEMSG  )
  Tdq(CESO)              Ext           Ena Ope
                             Shr Out Dat(001) Ddn(CEEOUT  )
  Tdq(CMIG)              Ind Nam(CSSL)
  Tdq(CRDI)              Ind Nam(CSSL)
+ Tdq(CSCS)              Ind Nam(CSSL)

Note: When a value does not apply, or is negative (the value begins with No), the fields on the screen are blank. To modify these fields, locate them by tabbing (they appear in the same sequence as in the expanded format), and overtype with input valid for that field. You might find it more convenient to use the expanded format when setting one of these values.

If you place the cursor against a specific entry in the list and press Enter, CICS® displays an expanded format, as shown in Figure 2.

Figure 2. The expanded display of an individual entry

IN TDQ
RESULT - OVERTYPE TO MODIFY
  Tdqueue(CCSO)
  Type(Extra)
  Nameind()
  Triggerlevel(       )
  Enablestatus( Enabled )
  Openstatus( Open )
  Termid()
  Tranid()
  Userid()
  Disposition(Mod)
  Iotype(Output)
  Indoubt()
  Indoubtwait()
  Databuffers(001)
  Ddname(COUT)
  Dsname(BELL.CICSHT61.JOB04382.D0000105.?)

CEMT INQUIRE TDQUEUE

Displayed fields

CHANGEAGENT(value)

Displays a value that identifies the agent that made the last change to the resource definition. You cannot use CEMT to filter on some of these values because they are duplicated. The possible values are as follows:

CREATESPI: The resource definition was last changed by an EXEC CICS CREATE command.
CSDAPI: The resource definition was last changed by a CEDA transaction or the programmable interface to DFHEDAP.
CSDBATCH: The resource definition was last changed by a DFHCSDUP job.
DREPAPI: The resource definition was last changed by a CICSPlex SM BAS API command.
SYSTEM: The resource definition was last changed by the CICS or CICSPlex system.

CHANGEAGREL(value)

Displays the 4-digit number of the CICS release that was running when the resource definition was last changed.

CHANGETIME(date time)

Displays the date and time when the resource definition was last changed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.

CHANGEUSRID(value)

Displays the 8-character user ID that ran the change agent.

DATABUFFERS (value) (extrapartition queues only)

Displays the number of buffers that can be used by the associated QSAM data set, in the range 1 - 255.

An extrapartition queue can be input or output, but not both.

DDNAME (value) (extrapartition queues only)

Displays a 1- to 8-character value that might refer to a data set defined in the startup JCL.

DEFINESOURCE(value)

Displays the source of the resource definition. The DEFINESOURCE value depends on the CHANGEAGENT option. For details, see Summary of the resource signature field values.

DEFINETIME(date time)

Displays the date and time when the resource was created. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.

DISPOSITION (extrapartition queues only)

Displays the status of the associated data set.

SHR: The data set existed before this job step and can be read by other concurrent jobs.
OLD: The data set existed before this job step.
MOD: The system first assumes that the data set exists. For an existing sequential data set, MOD causes the read/write mechanism to be positioned after the last record in the data set. The read/write mechanism is positioned after the last record each time the data set is opened for output.
If the system cannot find volume information for the data set on the DD statement, in the catalog, or passed with the data set from a previous step, the system assumes that the data set is being created in this job step. For a new data set, MOD causes the read/write mechanism to be positioned at the beginning of the data set.

DSNAME (value) (extrapartition queues only)

Displays the name of the associated QSAM data set (1 - 44 characters in length), or a dummy data set (or dummy data set name) that indicates whether the data set will be used by this transient data queue. This option is applicable for output resources only.

ENABLESTATUS (all except indirect and remote queues)

Displays a value indicating whether the queue can be accessed by applications.

ENABLED: The queue can be accessed by applications.
DISABLED: The queue cannot be accessed by applications, although it can still be open. Queues with names that begin with C cannot be disabled because they are usually reserved for use by CICS.

Note:

You can reset this value by overtyping it with a different value.
A queue can be disabled only if there are no current users. If units of work (UOWs) are currently using the queue, the queue enters a disable pending state. The last UOW to complete its operation on the queue fully disables the queue.
When a queue is in a disable pending state, the value of the ENABLESTATUS option cannot be altered.

INDOUBT (value) (intrapartition queues only)

Indicates the action CICS is to take for an indoubt unit of work (UOW) if the definition for this queue specifies WAIT(YES).

INDOUBTWAIT (intrapartition queues only)

Specifies whether an indoubt unit of work (UOW) (which has modified a logically recoverable queue) should wait for resynchronization with its coordinator to determine whether to commit or back out the changes.

NOWAIT: The UOW is not to wait. Any changes made to recoverable resources are to be backed out or committed, as specified by the ACTION attribute on the transaction resource definition.
WAIT: The UOW is to wait, and any action required while waiting is determined by the WAITACTION attribute.
This attribute overrides the WAIT parameter defined on the UOW transaction definition.

INSTALLAGENT(value)

Displays a value that identifies the agent that installed the resource. You cannot use CEMT to filter on some of these values because they are duplicated. The possible values are as follows:

CREATESPI: The resource was installed by an EXEC CICS CREATE command.
CSDAPI: The resource was installed by a CEDA transaction or the programmable interface to DFHEDAP.
GRPLIST: The resource was installed by GRPLIST INSTALL.
SYSTEM: The resource was installed by the CICS or CICSPlex SM system.

INSTALLTIME(date time)

Displays the date and time when the resource was installed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.

INSTALLUSRID(value)

Displays the 8-character user ID that installed the resource.

IOTYPE (extrapartition queues only)

Displays the type of data set to be used:

INPUT: An input data set.
OUTPUT: An output data set.
RDBACK: An input data set that is to be read backward.

MEMBER (extrapartition queues only)

Returns a 1- to 8-character name that indicates the member name of a partitioned data set. This name is blank if the QSAM data set is not a partitioned data set.

OPENSTATUS (EXTRAPARTITION QUEUES ONLY)

Displays whether the extrapartition queue is open or closed.

OPEN: The queue is open.
CLOSED: The queue is closed.

Note:

You can reset this value by overtyping it with a different value.
Queues no longer have to be enabled before they can be opened or closed. It is advisable for a queue to be disabled before it is opened or closed.

NAMEIND (value) (INDIRECT QUEUES ONLY)

Displays a 4-character string that identifies the name of the queue pointed to by the indirect queue.

QUEUE

The UOW is indoubt and waiting; any locks held by the UOW for this queue remain active until the final state of the UOW is known. Therefore, tasks are suspended rather than receiving the LOCKED response. When the final state of the UOW is known, any changes that it made are committed or backed out. Until then, any further requests of the following types that need one of the active locks must wait:

READQ, if the indoubt UOW has issued READQ or DELETEQ requests
WRITEQ, if the indoubt UOW has issued WRITEQ or DELETEQ requests
DELETEQ, if the indoubt UOW has issued READQ, WRITEQ or DELETEQ requests

REJECT

The UOW is indoubt and is waiting. Any locks held by the UOW for this queue are retained until the final state of the UOW is known. When the final state is known, any changes that the UOW made are committed or backed out. Until then, any further requests that need one of the retained locks are rejected, and a LOCKED response is returned. INDOUBT=REJECT causes a LOCKED response to be raised in exactly the same circumstances as those in which INDOUBT=QUEUE causes a transaction to wait.

TDQUEUE (value)

Indicates that this panel relates to a TDQUEUE inquiry and displays the 4-character identifier of a transient data queue. Queue names that begin with C are normally reserved for use by CICS.

TERMID (value)

Displays the 4-character name of the terminal or session to be associated with this queue when automatic transaction initiation (ATI) occurs. See also TRANID and TRIGGERLEVEL.

TRANID (value)

Displays the 4-character identifier of the transaction that is to be initiated automatically when the queue trigger level is reached.

TRIGGERLEVEL (value) (INTRAPARTITION QUEUES ONLY)

Displays the number of requests for output to a queue that must accrue before automatic transaction initiation (ATI) occurs. The number can be between 0 and 32767.

You can reset this value by overtyping it with a different value.

TYPE

Displays the type of this transient data queue.

INDIRECT: The queue type is indirect. The name of the final target queue is shown in the next field.
EXTRA: The queue type is extrapartition.
INTRA: The queue type is intrapartition.
REMOTE: The queue type is remote.

USERID

Displays the 8-byte identifier associated with the intrapartition queue intended for ATI.