Program Processor › Output › File and Record Layouts Report

File and Record Layouts Report

Describe file and record layouts

The File and Record Layouts Report is a six part report that provides information about the attributes of each file and specific details about the data items within each record:

• The first five parts of the report describe the five sections contained within the DATA DIVISION of a COBOL source program (that is, the FILE, WORKING-STORAGE, LINKAGE, COMMUNICATION, and REPORT sections).
• The sixth section of the report lists source statement references to all ACCEPT, DISPLAY, STOP, and CALL statements used the PROCEDURE DIVISION of the source program. This report allows quick access to information about files and data items without having to refer to the source listing.

Sample report

The following figure shows the first page of a sample File and Record Layouts Report.

      PRANDEM2   FILE AND RECORD LAYOUTS (FILE SECTION)                          DICTIONARY LOADER       dd mmm yy 1425   PAGE   1

             FILE NAME:           CUSTOMER-FILE
             DEVICE NAME:         UT-2400-S-CUSTIN
             LABEL:               OMITTED
             BLOCK SIZE:          UNBLOCKED
             RECORD SIZE:         104 CHARACTERS
             RECORD FORMAT:       FIXED

                                   079000 OPEN INPUT CUSTOMER-FILE
                                   084000 READ CUSTOMER-FILE RECORD
                                   125000 CLOSE CUSTOMER-FILE

         LV-DAT NAME                    SRC LN  POS  SIZE  USAGE   OCC   VALUE

         FD CUSTOMER-FILE               037000

         01 CUSTOMER                    043000  1    (104) GROUP
         03 CUST-NUM                    044000  1    10    DISP
         03 CUST-NAME                   045000  11   20    DISP
         03 CUST-ADDRESS                046000  31   (40)  GROUP
         05 CUST-ADDR1                  047000  31   20    DISP
         05 CUST-ADDR2                  048000  51   (20)  GROUP
         06 CUST-CITY                   049000  51   15    DISP
         06 CUST-ZIP-CODE               050000  66   5     DISP
         03 CUST-CREDIT                 051000  71   3     DISP
         88 CUST-CREDIT-EXEC            052000                           'AAA'
         88 CUST-GOOD                   053000                           '   '
         88 CUST-POOR                   054000                           'XXX'
         03 FILLER                      055000  74   31    DISP

Field descriptions

FILE NAME

The file name.

DEVICE NAME

The device name assigned to the file.

LABEL

Information about LABEL records. The report displays the keywords OMITTED or STANDARD, or the name of a user LABEL record.

BLOCK SIZE

The size of the physical block, if blocked.

RECORD SIZE

The size of the file's data records.

RECORD FORMAT

The RECORDING MODE of the record. The report displays FIXED, VARIABLE, UNDEFINED, or SPANNED.

LV

The level number of the data item. For items for which level number is not applicable, codes provide information about the item:

• FD-File description
• SD-Sort description
• DC-Communication description
• RD-Report description

No level number is provided for definitions of index names used by the INDEXED BY clause.

DATA NAME

Name of the data item. DATA NAME can be a file name, record name, or an element name.

SRC LN

The line number of the source line where the data item is defined.

POS

Starting position associated with the data item.

SIZE

The size of the data item. Parentheses enclose a size reported for a group item.

USAGE

The form in which the data item is to be stored as the result of the source program's specifications:

• GROUP—The data item contains subordinate items.
• DISP—The data item is stored in character form.
• DISP-NM—The data item is stored one digit per character position. The PIC contains only S, 9, and V.
• NM-EDIT—The data item is a numeric item stored in character format. The PIC contains some or all of the editing characters +, -, z, $, comma, B, CR, DB, ., or 0.

The following report writing specifications can also appear in this column:

• RH—Report heading
• RF—Report footing
• PH—Page heading
• PF—Page footing
• CH—Control heading
• CF—Control footing
• DE—Detail

OCC

The number of occurrences of the data item if the definition of the item uses an OCCURS clause.

VALUE

The value assigned to the data item if the definition of the item uses a VALUE clause.