File-Aid: Viewing Layouts

Chapter 10. Viewing Layouts

File-AID has a helpful function for interpreting COBOL or PL/I record layouts and presenting an information display showing the following information for each field:

• Field name
• Field level as defined in data declaration
• Field length
• Field start and end locations
• Picture of field as defined in data declaration
• System-assigned field number.

10.1 Accessing the View Utility (Option 8)

The View utility is located on File-AID's Primary Option Menu as option 8.

Step:

1. From the File-AID Primary Option Menu (not shown here), select File-AID option 8 to access the View Record Layout - Dataset Specification screen (Figure 10-1).

10.2 Specifying the Record Layout to be Interpreted

The View Record Layout - Dataset Specification screen (see Figure 10-1) is used to specify the dataset name and member name of the record layout to be interpreted.
You can specify a pattern dataset name in the Dataset name field. If you do not specify a member, File-AID displays a member list.
In this example, you examine the interpreted record layout for the member EMPLOYEE.

Steps:

1. Type the dataset name FASAMP.LAYOUTS.
2. Type the member name EMPLOYEE.
3. Press <Enter>.

Figure 10-1. View Record Layout - Dataset Specification Screen

+--------------------------------------------------------------------------------+
| File-AID ------------- View Record Layout - Dataset Specification -------------|
| COMMAND ===>                                                                   |
|                                                                                |
|                                                                                |
|                                                                                |
| Specify Record Layout Dataset to View:                                         |
|                                                                                |
|        Dataset name  ===> FASAMP.LAYOUTS                                       |
|        Member name   ===> EMPLOYEE   (blank or pattern for member list)        |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
|                                                                                |
+--------------------------------------------------------------------------------+

More About the View Record Layout - Dataset Specification Screen

• The dataset name you specify here is displayed on all screens where you can specify a record layout dataset name (for example, Browse and Edit).
• Record layouts to be interpreted may reside in any supported source library including:
  • PDS (80 byte records)
  • CA-PANVALET
  • CA-LIBRARIAN
  • Compuware map library (Release 6 and prior).
• The member specified must contain only data declarations for one or more structures of data beginning at structure level 01. You can specify a data declaration with COBOL or PL/I, but you cannot specify both within a single member.
• When using a multiple structure member in Browse or Edit, issue the formatted mode command, USE, to see a list of all layouts from which you may select an alternate layout.

10.2.1 Viewing the Interpreted Layout

The VIEW LAYOUT display screen (Figure 10-2) accepts the following primary commands:

DOWN	Scrolls down by the scroll amount.
END	Exits from the VIEW LAYOUT screen.
FIND xx	Searches for string xx and scrolls to the field.
REPEAT	Repeats previous find.
UP	Scrolls up by the scroll amount.

You are done with this example so return to the File-AID Primary Option Menu now.

Step:

1. Use the END command (press PF3) TWO TIMES to redisplay the File-AID Primary Option Menu.

Figure 10-2. View Utility - Display of Interpreted Layout

+--------------------------------------------------------------------------------+
| File-AID ---------------------- VIEW LAYOUT ---------------  ROW 1 TO 19 OF 38 |
| COMMAND ===> END                                              SCROLL ===> CSR  |
| Layout: USERID9.FASAMP.LAYOUTS(EMPLOYEE)                                       |
|                                                  FIELD                         |
| --------- FIELD LEVEL/NAME ---------- -PICTURE- -NUMBER START     END  LENGTH  |
| EMPLOYEE-MASTER-FILE                                        1     198     198  |
| 5 EMP-NUMBER                          X(5)           1      1       5       5  |
| 5 EMP-LAST-NAME                       X(15)          2      6      20      15  |
| 5 EMP-FIRST-NAME                      X(10)          3     21      30      10  |
| 5 EMP-MID-INIT                        X              4     31      31       1  |
| 5 FILLER                              XX             5     32      33       2  |
| 5 EMP-TITLE                           X(30)          6     34      63      30  |
| 5 EMP-PERSONAL-INFO                   GROUP          7     64      86      23  |
|   10 EMP-NATL-ID-NUMBER               9(9)           8     64      72       9  |
|   10 FILLER                           X              9     73      73       1  |
|   10 EMP-DATE-OF-BIRTH                X(6)          10     74      79       6  |
|   10 EMP-DOB-REDEF REDEFINES EMP-DATE-OF-BIRTH                                 |
|   10 EMP-DOB-REDEF                    GROUP         11     74      79       6  |
|     15 EMP-DOB-MM                     99            12     74      75       2  |
|     15 EMP-DOB-DD                     99            13     76      77       2  |
|     15 EMP-DOB-YY                     99            14     78      79       2  |
|   10 EMP-HIRE-DATE                    X(6)          15     80      85       6  |
|   10 EMP-MARITAL-STATUS               X             16     86      86       1  |
| 5 EMP-PERSONAL-INFO                   GROUP         17     87     101      15  |
+--------------------------------------------------------------------------------+

More About the View Display

• If the source member contains more than one 01 level structure, you may scroll down to see additional structures. A marker line is inserted in the display to signify the new structure:

   > > >START OF LAYOUT NUMBER 2< < <
  

---