EXTRATDQ - Extrapartition transient data queues

The EXTRATDQ view shows general information about currently installed extrapartition transient data queues.

Note:
If an extrapartition transient data queue is closed, much of the information about it is not available, so you receive null values.

Availability

The EXTRATDQ view is available for all managed CICS® systems.

Access

Issue command:
EXTRATDQ [tdq [ENABLED|DISABLED]]

tdq
is the specific or generic name of a currently installed extrapartition transient data queue, or * for all extrapartition queues.

ENABLED|DISABLED
Limits the view to extrapartition transient data queues that are either enabled or disabled. If you omit this parameter, extrapartition transient data queues are included in the view regardless of their status.

If you do not specify parameters, the view includes information about all extrapartition transient data queues within the current scope.

Note:
Some transient data queue names might contain lower case characters. You cannot inquire on these in the EUI using a filter because TSO converts lower case characters to upper case. For example ab* will be converted to AB* and as a result no data will be retrieved.
Select:
TDQ from the OPERATE menu, and EXTRATDQ from the TDQ submenu.

Figure 154 is an example of the EXTRATDQ view.

Figure 154. The EXTRATDQ view
 27FEB2005  18:32:13 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =EXTRATDQ==========EYUPLX01=EYUPLX01=27FEB2005==18:32:13=CPSM=========24===
 CMD Queue CICS     Enabled  Open    Empty    I/O      Lrecl RFM CTL Accesses
 --- ID--- System-- Status-- Status- Status-- Type---- ----- --- --- --------
     COLG  EYUMAS1A ENABLED  OPEN    NOTEMPTY OUTPUT     132 VAR NOC        0
     COLG  EYUMAS2A ENABLED  OPEN    NOTEMPTY OUTPUT     132 VAR NOC        0
     COLG  EYUMAS3A ENABLED  OPEN    NOTEMPTY OUTPUT     132 VAR NOC        0
     COLG  EYUMAS4A ENABLED  OPEN    NOTEMPTY OUTPUT     132 VAR NOC        0
     COPR  EYUMAS1A ENABLED  CLOSED  NOTAPPLI INPUT    N/A   NOT NOT        3
     COPR  EYUMAS2A ENABLED  CLOSED  NOTAPPLI INPUT    N/A   NOT NOT        3
     COPR  EYUMAS3A ENABLED  CLOSED  NOTAPPLI INPUT    N/A   NOT NOT        3
     COPR  EYUMAS4A ENABLED  CLOSED  NOTAPPLI INPUT    N/A   NOT NOT        3
     CPLI  EYUMAS1A ENABLED  OPEN    NOTEMPTY OUTPUT     133 VAR NOC        0
     CPLI  EYUMAS2A ENABLED  OPEN    NOTEMPTY OUTPUT     133 VAR NOC        0
     CPLI  EYUMAS3A ENABLED  OPEN    NOTEMPTY OUTPUT     133 VAR NOC        0
     CPLI  EYUMAS4A ENABLED  OPEN    NOTEMPTY OUTPUT     133 VAR NOC        0
     CSMT  EYUMAS1A ENABLED  OPEN    NOTEMPTY OUTPUT     132 VAR NOC       71
     CSMT  EYUMAS2A ENABLED  OPEN    NOTEMPTY OUTPUT     132 VAR NOC       54
     CSMT  EYUMAS3A ENABLED  OPEN    NOTEMPTY OUTPUT     132 VAR NOC       54
     CSMT  EYUMAS4A ENABLED  OPEN    NOTEMPTY OUTPUT     132 VAR NOC       67
     CXRF  EYUMAS1A ENABLED  OPEN    NOTEMPTY OUTPUT     128 VAR NOC        0
     CXRF  EYUMAS2A ENABLED  OPEN    NOTEMPTY OUTPUT     128 VAR NOC        1

Action commands

Table 304 shows the action commands you can issue from the EXTRATDQ view. The overtype fields are shown in Table 305.

The action commands and overtype fields for the EXTRATDQ view are available for all managed CICS systems for which EXTRATDQ is valid. Exceptions are noted in Table 304 and Table 305.

Table 304. EXTRATDQ view action commands
Primary command Line command Description
CLS
tdq sysname
CLS Closes a queue.
DISable
tdq sysname
DIS Disables a queue.
Notes:
  1. Transient data queues that have names beginning with C are supplied by CICS and cannot be disabled.
  2. A disabled queue cannot be accessed by applications, though it can still be open.
DiSCard
tdq sysname
DSC Discards a queue.
Notes:
  1. Transient data queues that have names beginning with C are supplied by CICS and cannot be discarded.
  2. The transient data queue must be disabled and closed before it can be discarded.

Available only for systems running the CICS TS.

ENAble
tdq sysname
ENA Enables a queue.
OPEn
tdq sysname
OPE Opens a queue.
n/a SET Sets a queue attribute according to the new value you specify in an overtype field (see Table 305).
Note:
The value you specified in the Require Set field on the CICSPlex® System Manager entry panel determines whether or not you must use the SET command when you overtype a field.
Where:
tdq
Is the specific or generic name of an extrapartition transient data queue.
sysname
Is the specific or generic name of a CICS system.

Table 305. EXTRATDQ view overtype fields
Field name Values
Enabled Status ENABLED | DISABLED
Open Status OPEN | CLOSED

Hyperlinks

Table 306 shows the hyperlink field on the EXTRATDQ view.

Table 306. EXTRATDQ view hyperlink field
Hyperlink field View displayed Description
Queue ID EXTRATDD Detailed view of the specified extrapartition transient data queue.
Note:
You can also display the EXTRATDS view by issuing the SUM display command.
[[ Contents Previous Page | Next Page Index ]]