FILE Screen Layout for VSAM Files

Accessing Auxiliary Storage: FILE › VSAM Files › FILE Screen Layout for VSAM Files

FILE Screen Layout for VSAM Files

The following screen shows a blank header area on a FILE screen for VSAM files.

Examples

Examples of the complete screen, see Dump Format, Character Format, Vertical Format and Structured Format earlier in this chapter.

DATATYPE= FC FILEID= MODE= LOG= TODEST= PASSWORD= FUNC= SUBFUNC= RETMETH= ARGTYP= SRCHTYP= MESSAGE= RETNRCID= CHGELEN= RCID= DATA= SIZE= FORMAT= D 00112233 44556677 8899AABB CCDDEEFF *0123456789ABCDEF* LOC 0000 ........ ........ ........ ........ ................ 1 Help 2 Format D 3 End 4 BEGB 5 6 DataType DL 7 Page bwd 8 Page fwd 9 Caps Off 10 Top 11 Bottom 12

The fields provide the following information:

Fields	Function
DATATYPE	Identifies the type of data organization. This must be FC.
FILEID	Specifies the name of the VSAM file.
MODE	Identifies the FILE operation such as browse, update, add, add in mass insertion. This field is blank if you are just viewing a record.
LOG	Specifies whether the FILE logging facility is on or off.
TODEST	Identifies a transient data destination (when a work area is copied) or a dump identification (when a work area is dumped).
PASSWORD	Must contain a four‑character password if the file is protected.
FUNC	Specifies the FILE function. When this field contains a function code, it is executed if you press Enter. In addition to common FILE functions, enter the following commands: BEGB, DEL, ENDB, GET, GETU, NEXT, PREV, PUT, REL.
SUBFUNC	Modifies a FUNC specification.
RETMETH	Identifies the RCID field (BDAM files only).
ARGTYP	No longer required.
SRCHTYP	Specifies how RCID information is processed (KSDS files only).
MESSAGE	Contains FILE messages. Also specify messages here when FUNC=COPY or FUNC=DUMP.
RETNRCID	Contains the record key of the retrieved record.
CHGELEN	Specifies the number of bytes changed in the work area when FUNC=CHGE.
RCID	Identifies the record to be processed.
DATA	Contains data needed to perform certain FILE functions.
SIZE	Specifies the record size or the number of records to be searched.
FORMAT	Specifies the format in which the record is displayed.
USE	Specifies the program and structure for structured format.
LOC	Specifies a location within a record.

Some fields are used only for certain tasks. The discussion of each FILE function indicates which fields must be specified.

When a record displays, its FILE information is in the lower‑right portion of the screen. This information includes the following:

DSORG(data organization)
RECFM(record format)
LRECL (record length)
BLKSIZE (blocksize)
KEYPOS (key position)
KEYLEN (key length)
STRNO (string number)

Beneath the FILE information is a list of the functions you can perform, such as READ, ADD, UPDATE, BROWSE, DELETE.