File Information panel

Panel and field definitions

  Process   Options   Help
________________________________________________________________________________
 FM/CICS                   File Information FMKSDS5


 Changeable:          Open     Enabled    Read Update Add Browse Delete
    Status  . . . . . OPEN     ENABLED    READ UPDATE ADD BROWSE DELETE
    Data Set Name . . FMN.CICS.TEST.KSDS.FIXED.RECOVER'
    Strings . . . . .   5
    Disposition       RLS access                  Read Integrity
    1  1. SHR         2  1. Not applicable        1  1. Not applicable
       2. OLD            2. No RLS                   2. Consistent
                         3. RLS                      3. Repeatable
 General:                                            4. Uncommitted
    Sysid . . . . . .
    Type  . . . . . . KSDS
    Key position  . . 0
    Key length  . . . 11
    LSR Pool value  . 0
    Record size . . . 80
    Journal number  . 0
    Attributes  . . . FWDRECOV RECOV LOCKING

 Command ===>                                                       Scroll CSR 

Changeable

This section of the panel contains file attributes that you can alter. Any change causes a close of the file, followed by an attempted change with attributes you have requested. If the request fails, you are provided with the CICS command (func=) and error codes which can be located in the CICS Application Programming Reference under the command code section. If the request fails, the displayed attributes represent the current status of the file.

Open

You can change the open status by overtyping the first character with "O" to open, or "C" to close. The following status values can be displayed:

OPEN

File is open.

OPENING

File is being opened.

CLOSED

File is closed.

CLOSING

File is being closed.

CLOSEREQ

A close has been requested.

Enabled

You can change the enable status by overtyping the first character with "E" to enable, or "D" to disable. The following status values can be displayed:

DISABLED

File is disabled.

DISABLING

File is being disabled.

ENABLED

File is enabled.

UNENABLED

File is closed unenabled.

UNENABLING

File is being unenabled.

Read

This field has either the value READ or blanks. To change the status, type "R" in the first byte to set the status, or clear the field to disallow READ to the file.

Note: The read status can only be cleared when Browse, Update, and Delete are also cleared.

Update

This field has either the value UPDATE or blanks. To change the status, type "U" in the first byte to set the status, or clear the field to disallow updates to the file.

Add

This field has either the value ADD or blanks. To change the status, type "A" in the first byte to set the status, or clear the field to disallow ADDs to the file.

Browse

This field has either the value BROWSE or blanks. To change the status, type "B" in the first byte to set the status, or clear the field to disallow BROWSE to the file.

Delete

This field has either the value DELETE or blanks. To change the status, type "D" in the first byte to set the status, or clear the field to disallow DELETEs to the file.

Data Set Name

This field contains the associated data set name. You can enter a fully-qualified or generic data set name to change the name. In a generic data set name, use the percent (%) sign to represent a single character, and an asterisk (*) to represent any number of characters within one qualifier. Two asterisks (**) represent any number of qualifiers.

Strings

This field contains the string number value associated with a VSAM file. It is a value within the range 1–255.

Disposition

You can change the disposition by changing the selection number:

1

DISP=SHR

2

DISP=OLD

RLS Access

You can change the RLS access value by changing the selection number:

1

Does not apply to remote or BDAM data set.

2

The data set is not accessed in RLS mode.

3

The data set is accessed in RLS mode.

Note: You may get errors opening a file on CICS systems where RLS is not supported.

Read Integrity

You can change the read integrity by changing the selection number:

1

Does not apply to VSAM accessed in non-RLS mode, remote, BDAM, or CFDT files.

2

Consistent. Read requests for this file are subject to consistent read integrity (unless otherwise specified on the read request).

3

Repeatable. Read requests for this file are subject to repeatable read integrity (unless otherwise specified on the read request).

4

Uncommitted. No read integrity for this file.

General:

The following fields are values that cannot be changed for the associated CICS file:

SYSID

Blank for the local system on which File Manager is running and represents the connection ID for remote resources.

Type

VSAM or BDAM for closed files. If a VSAM file is open, this field contains KSDS, ESDS, AIX, PATH, RRDS, VRRDS values describing the type of VSAM file. For CICS data tables, Type contains TABL.

Key position

Shown for VSAM files with a keylength > 0 and is the starting position of the key.

Key length

Shown for VSAM files with a keylength > 0 and is the key length.

LSR Pool value

Number indicating the VSAM LSR pool associated with this file. In the range 1–8.

Record size

Maximum record size for variable files or record length for fixed files.

Journal number

A number between 1 and 99 corresponding to the number of the journal to which CICS writes information required for auto journaling. A value of 0 indicates JOURNAL(NO) is specified for the file.

Attributes

The following literals are displayed describing various attributes of the file:

Emptyreq

A reusable VSAM file is reset on open.

Load

The coupling facility data table is, or is to be, preloaded from a source data set.

FWDRECOV

The file is forward recoverable.

RECOV

The file is recoverable.

CFTABLE

Coupling facility data table.

CICSTABLE

CICS-maintained data table.

USERTABLE

User-maintained data table.

KEYED

The data is addressed by physical keys

CONTENTION

The coupling facility data table is updated using the contention model.

LOCKING

The coupling facility data table is updated using the locking model.

EXTENDED

This VSAM data set uses extended relative byte addressing.

Table name

Shown for coupling facility data tables and is the coupling facility data table name.

Table pool

Shown for coupling facility data tables and is the name of the coupling facility data table pool in which the coupling facility data table resides.

Max records

Shown for data tables and indicates the maximum number of records that the data table for this file can hold. A value of 0 may indicate the resource was defined with NOLIMIT.