Previous Topic: BDAM FilesNext Topic: FILE Functions for BDAM Records

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

FILE Screen Layout for BDAM Files

The following screen shows a blank header area on a FILE screen for BDAM files. For examples of the complete screen, see the Dump Format, Character Format, Vertical Format, Structured Format sections 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  ........ ........ ........ ........  ................

Field

Function

DATATYPE

Identifies the type of data organization. This must be FC.

FILEID

Specifies the name of the BDAM file.

MODE

Identifies the FILE operation, such as browse, update, add, add in mass insertion. This field is blank if you are viewing a record.

LOG

Specifies whether FILE's 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 password 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

Must contain RBA or XRBA when working with ESDS files.

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 on the lower‑right portion of the screen. This information includes the following:

Beneath this information is a list of the functions you can perform, including READ, ADD, UPDATE, BROWSE, DELETE.