LOCFILE - Local files

The LOCFILE view shows general information about local CICS files. Examples of how to use this view can be found in:

Availability

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

Access

Issue command:
LOCFILE [file [enablestat [OPEN|CLOSED]]]

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:

ENABLED
Available for access.
DISABLED
Unavailable as a result of a SET DISABLED command.
DISABLING
Still being accessed after a SET DISABLED or SET CLOSED command.
UNENABLED
Unavailable as a result of a SET CLOSED command.

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.

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

Figure 67 is an example of the LOCFILE view.

Figure 67. 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
 
 

Action commands

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.

Table 137. LOCFILE 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 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:
file
Is the specific or generic name of a local file.
sysname
Is the specific or generic name of a CICS system.

Table 138. LOCFILE view overtype fields
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

Hyperlinks

Table 139 shows the hyperlink fields on the LOCFILE view.

Table 139. LOCFILE view hyperlink fields
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.
Note:
You can also display the LOCFILES view by issuing the SUM display command.
[[ Contents Previous Page | Next Page Index ]]