Previous Topic: Work with DL/I DatabasesNext Topic: Specifying the SIZE Field

Accessing Auxiliary Storage: FILE › Work with DL/I Databases › FILE Screen Layout for DL/I Databases

FILE Screen Layout for DL/I Databases

The following screen shows the FILE screen layout for DL/I databases.

DATATYPE= DL FUNC=      PSB=          DBD=          NO 01 SUBFUNC=      PS=     
 SSA=                                                                           
                                                                                
                                                                   TODEST=      
MESSAGE=                                                           CHGLEN=      
    DATA=                                                          SIZE= 0000   
FORMAT= D 00112233 44556677 8899AABB CCDDEEFF  *0123456789ABCDEF*  LOG=ON       
LOC 0000  ........ ........ ........ ........   ................                
                                                                  STAT=         
                                                                  NAME=         
                                                                  LEVL=         
                                                                  POPT=         
                                                                  KFBL=        
                                                                  KEY FEEDBACK  
                                                                  *          *  
                                                                  *          *  
                                                                  *          *  
                                                                  *          *  
                                                                  *          *  
                                                                  *          *  
------------------------------------------------------------------------------- 
1 Help       2 Format C   3 End        4 BEGB       5            6 DataType FC  
7 Page bwd   8 Page fwd   9 Caps Off  10 Top       11 Bottom    12

The following table describes each field's function.

Field

Function

DATATYPE

Specifies the type of data organization. For DL/I databases, it is DL.

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: DLET, GHN, GHU, GN, GNHP, GNP, GU, ISRT, REPL.

PSB

Specifies the PSB name, which you can change any time using FILE.

DBD

Specifies the DBD name, which you can change any time using FILE.

NO

Specifies which DBD entry to use when there is more than one DBD with the same name in the PSB. The default is 01.

SUBFUNC

Modifies a FUNC specification.

PS

If the DBD is password protected, enter a four‑character password.

SSA

Specifies required segment search arguments. See the section SSA Formats.

TODEST

Identifies a transient data destination (when a work area is copied) or a dump identification (when a work area is dumped).

MESSAGE

Contains FILE messages. Also specify messages here when FUNC=COPY or FUNC=DUMP.

CHGELEN

Specifies the number of bytes changed in the work area when FUNC=CHGE.

DATA

Contains data needed to perform certain FILE functions.

SIZE

Specifies the size of the segment.

FORMAT

Specifies the format in which the segment is displayed.

USE

Specifies the program and structure for structured format.

LOG

Specifies whether FILE's logging facility is on or off.

LOC

Specifies a location within a segment.

Returned PCB information appears in the lower‑right screen area:

STAT—DL/I status code returned by PSB

NAME—Name of retrieved segment

LEVL— Level number of segment

POPT—DL/I processing options

KFBL—Length of key feedback area

KEY FEEDBACK—Displays key feedback area

Some fields are applicable only to certain functions. The discussion of each FILE function indicates which fields must be specified.