The LOCFILE view shows general information about local CICS files. Examples of how to use this view can be found in:
The LOCFILE view is available for all managed CICS® systems.
file
is the specific or generic
name of a currently installed local file, or * for all local files.
enablestat
Limits the view
to local files that have the specified enable status. Specify an enable status
or * to include all local files regardless of their enable status.
The enable status values are:
OPEN|CLOSED
Limits the view
to local files that are either open or closed. If you omit this parameter,
local files are included in the view regardless of their open status.
If you do not specify parameters, the view includes information about all local files within the current scope.
Figure 67 is an example of the LOCFILE view.
27FEB2005 18:46:10 ----------- INFORMATION DISPLAY --------------------------- COMMAND ===> SCROLL ===> PAGE CURR WIN ===> 1 ALT WIN ===> >W1 =LOCFILE===========EYUPLX01=EYUPLX01=27FEB2005==18:46:10====CPSM==========8 CMD File CICS Enabled Open Add Bro Del Rea Upd LSR Dataset --- ID------ System-- Status--- Status Opt Opt Opt Opt Opt --- Name------------ DFHCSD EYUMAS1A UNENABLED CLOSED YES YES YES YES YES 00 PAYROLL.SALARY.A DFHCSD EYUMAS2A UNENABLED CLOSED YES YES YES YES YES 00 PAYROLL.SALARY.A DFHCSD EYUMAS3A UNENABLED CLOSED YES YES YES YES YES 00 PAYROLL.SALARY.A DFHCSD EYUMAS4A UNENABLED CLOSED YES YES YES YES YES 00 PAYROLL.SALARY.A EYUFIL01 EYUMAS4A ENABLED CLOSED NO NO NO YES NO 01 EYUFIL02 EYUMAS4A ENABLED CLOSED NO NO NO YES NO 01 EYUFIL03 EYUMAS4A ENABLED CLOSED NO NO NO YES NO 01 EYUFIL04 EYUMAS4A ENABLED CLOSED NO NO NO YES NO 01
Table 137 shows the action commands you can issue from the LOCFILE view. The overtype fields are shown in Table 138.
The action commands and overtype fields for the LOCFILE view are available for all managed CICS systems for which LOCFILE is valid, except as noted in Table 137 and Table 138.
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 file if it is still in use. When a 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 file if it is still in use. |
DiSCard
file sysname |
DSC | Discards a file from the CICS system where it is installed. |
ENAble
file sysname |
ENA | Enables a file. |
OPEn
file sysname |
OPE | Opens a file. When a file has been disabled by a CLS action command, OPEN enables the file. |
n/a | SET | Sets a file attribute according to the new
value you specify in an overtype field (see Table 138).
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:
|
Field name | Values |
---|---|
Enabled Status | ENABLED | DISABLED |
Open Status | OPEN | CLOSED |
Add Opt | YES | NO |
Bro Opt | YES | NO |
Del Opt | YES | NO (VSAM only) |
Rea Opt | YES | NO |
Upd Opt | YES | NO |
LSR | 1-8 (VSAM Only) |
Dataset Name | Any valid data set name |
Table 139 shows the hyperlink fields on the LOCFILE view.
Hyperlink field | View displayed | Description |
---|---|---|
File ID | LOCFILED | Detailed view of the specified local file. |
Dataset Name | DSNAMED | Detailed view of the data set associated with the specified file. |