LOCFILED - Local file details

The LOCFILED view shows detailed information about a local CICS file.

Availability

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

Access

Issue command:
LOCFILED file sysname

file
is the name of a currently installed local file.

sysname
is the name of the CICS system where the file is installed. The CICS system must be within the current scope.

Hyperlink from:
the File ID field of a FILE or LOCFILE view.

Figure 68 is an example of the LOCFILED view.

Figure 68. The LOCFILED view
 27FEB2005  18:46:19 ----------- INFORMATION DISPLAY ---------------------------
 COMMAND  ===>                                                 SCROLL ===> PAGE
 CURR WIN ===> 1        ALT WIN ===>
 >W1 =LOCFILE==LOCFILED=EYUPLX01=EYUPLX01=27FEB2005==18:46:10====CPSM==========1
     File ID......     DFHCSD CICS System...  EYUMAS1A Time Opened..  00:00:00
     Access Method       VSAM File Type..... NOTAPPLIC Time Closed..  00:00:00
     Enabled Stat.  UNENABLED Object Type...      BASE GMT Opened...       N/A
     Open Status..     CLOSED Recovery Stat.      BASE GMT Closed...       N/A
     Add Option...        YES Forward Recvr. FWDRECOVA Strings......         3
     Browse Option        YES Journal ID....         1 String Wt Tot         0
     Delete Option        YES Add Requests..         0 String Wt HC.         0
     Read Option..        YES Browse Request         0 Activ String.       N/A
     Update Option        YES Local Deletes.         0 ActString Wt.       N/A
     Exclusive Opt  NOTAPPLIC Get Requests..         0 LSR Pool ID..        00
     Empty Option. NOEMPTYREQ Get Upd Req...         0 EXCP VSAM Dat         0
     Read Integrity       N/A Update Request         0 EXCP VSAM Idx         0
     Disposition..      SHARE Bro Upd Count.       N/A Block Size...       N/A
     Block Format     BLOCKED # Data Buffers         2 Record Size..         0
     Record Format   VARIABLE # IDX Buffers.         1 Key Length...         0
     Rel Type.....        N/A Rls Acess Mode.      N/A Key Position.         0
                              Rls Req Timeout      N/A Block Key Len       N/A
 
Note:
Scroll to the right to see the name of the data sets associated with this file.

Action commands

Table 140 shows the action commands you can issue from the LOCFILED view. The overtype fields are shown in Table 141.

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

Table 140. LOCFILED view action commands
Primary command Line command Description
CLS 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 the file has been enabled by an OPEN action command, CLS disables the file.
DISable 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 DSC Discards the file from the CICS system where it is installed.
ENAble ENA Enables the file.
OPEn OPE Opens the file. When the 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 141).
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.

Table 141. LOCFILED view overtype fields
Field name Values
Enabled Stat ENABLED | DISABLED
Open Status OPEN | CLOSED
Add Option YES | NO
Browse Option YES | NO
Delete Option YES | NO (VSAM only)
Read Option YES | NO
Update Option YES | NO
Exclusive Opt EXCTL | NOEXCTL (BDAM only)
Empty Option EMPTYREQ | NOEMPTYREQ (VSAM only)
Disposition OLD | SHARE
Strings 1-255 (VSAM only)
LSR Pool ID 1-8 (VSAM only)
Dataset Name Any valid data set name

Hyperlinks

Table 142 shows the hyperlink fields on the LOCFILED view.

Table 142. LOCFILED view hyperlink fields
Hyperlink field View displayed Description
Dataset Name
Base Dataset
DSNAMED Detailed view of the data set or base data set associated with this file.
[[ Contents Previous Page | Next Page Index ]]