CMDT - Data tables

The CMDT view shows general information about files that have CICS- or user-maintained data tables, or coupling facility data tables, associated with them.

Availability

The CMDT view is available for all managed CICS® systems except CICS for Windows.

Access

Issue command:
CMDT [file [CFTABLE|CICSTABLE|USERTABLE]]

file
is the specific or generic name of a currently installed data table file, or * for all data table files.

CFTABLE|CICSTABLE|USERTABLE
Limits the view to either CICS- or user-maintained data table files, or coupling facility data table files. If you omit this parameter, data table files are included in the view regardless of their type.

If you do not specify parameters, the view includes information about all data table files within the current scope.

Select:
FILE from the OPERATE menu, and CMDT from the FILE submenu.

Figure 57 is an example of the CMDT view.

Figure 57. The CMDT view
 27FEB2005  15:54:26 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
  W1 =CMDT==============EYUPLX01=EYUPLX01=27FEB2005==15:54:26====CPSM============
 CMD File     CICS     Enable    Table     Get      Browse   Curr     Highest
 --- ID------ System-- Status--- Type----- Requests Requests Records- Records-
     EYUFIL02 EYUMAS4A ENABLED   CFTABLE          0        0        0        0
     EYUFIL03 EYUMAS4A ENABLED   CICSTABLE        0        0        0        0
     EYUFIL04 EYUMAS4A ENABLED   USERTABLE        0        0        0        0
 

Action commands

Table 113 shows the action commands you can issue from the CMDT view. The overtype fields are shown in Table 114.

The action commands and overtype fields for the CMDT view are available for all managed CICS systems for which CMDT is valid, except as noted in Table 113.

Table 113. CMDT view action commands
Primary command Line command Description
CLS
file sysname
CLS Displays the CLOSE OPTIONS input panel (Figure 58), which lets you specify how to handle a data table file if it is still in use. When a data table file has been enabled by an OPEN action command, CLS disables the file.
DISable
file sysname
DIS Displays the DISABLE OPTIONS input panel (Figure 58), which lets you specify how to handle a data table file if it is still in use.
DiSCard
file sysname
DSC Discards a data table file from the CICS system where it is installed.

DiSCard is available for CICS Transaction Server for OS/390 and later systems.

ENAble
file sysname
ENA Enables a data table file.
OPEn
file sysname
OPE Opens a data table file. When the data table file has been disabled by a CLS action command, OPEN enables the file.
n/a SET Sets a data table file attribute according to the new value you specify in an overtype field (see Table 114).
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:
file
Is the specific or generic name of a data table file.
sysname
Is the specific or generic name of a CICS system.

Table 114. CMDT view overtype fields
Field name Values
Enable Status ENABLED | DISABLED
Table Type CFTABLE|CICSTABLE |USERTABLE|NOTTABLE

In order to change the Table Type, the file should be in a CLOSED state, with an ENABLESTATUS of either DISABLED or UNENABLED. The change does not take effect until the file is next opened.

When you issue the CLS or DISABLE action command, an input panel appears, as shown in Figure 58.

Figure 58. The CLOSE OPTIONS input panel
 --------------------------- CLOSE OPTIONS -------------------------------------
 COMMAND  ===>
 
 CICS System          CICS123
 
 File                 EYUDREP
 
 Option          ===>            Wait, Nowait, or Force
 
 
 
 Press Enter to close the file.
 Type END or CANCEL to terminate without closing.
 

Except for the panel title, the input panels produced by the CLS and DISABLE actions are identical. To close or disable a data table file, verify the CICS system and file names, and specify one of the following options:

WAIT
Waits to perform the close or disable action until the data table file is no longer in use.
NOWAIT
Does not perform the close or disable action if the data table file is in use.
FORCE
Closes or disables the data table file immediately, even if it is in use.

Hyperlinks

Table 115 shows the hyperlink field on the CMDT view.

Table 115. CMDT view hyperlink field
Hyperlink field View displayed Description
File ID CMDTD Detailed view of the specified data table file.
Note:
You can also display the CMDTS view by issuing the SUM display command.
[[ Contents Previous Page | Next Page Index ]]