View Record Layout (8)
The View Record Layout function enables you to view COBOL or PL/I record layouts as File-AID has interpreted them. The function consists of specifying the data set and member name of the record layout to view.
This section describes the two screens presented in the View function.
View record layout — dataset specification
The following figure allows you to view record layouts as File-AID has interpreted them. To access the View function, select option 8 from the File-AID Primary Option Menu or enter the appropriate jump command (for example, =8) from any File-AID screen. See Selecting-screens. The View function can also be accessed with the F8 recursive command. See Recursive Commands.
View Record Layout — Dataset Specification screen
Field Descriptions
Dataset name and Member name
Specify the dataset name and member of the record layout you want to view. You can use a pattern character when specifying a dataset name. You can also specify a member name, in parentheses, along with the dataset name in the Dataset name field. For more information on specifying data set and member names, see Pattern dataset names.
Specifying a Concatenation List
To specify a concatenation list to be used in place of the Record Layout dataset, enter a plus sign followed by the member name (+membername) of the member containing the list. Enter this in the Record layout dataset field instead of the Record Layout dataset name. For example, if the member RLPROD contains the list to be used, enter +RLPROD instead of a Record Layout Dataset name. You specified the name of the concatenation list data set in Option 0.1, File-AID system parameters (see Concatenation List DSN). The concatenation list data set contains members known as concatenation lists. Each such list contains names of record layout datasets, each of which in turn contains record layout members.
The concatenation list is used in place of the single Record Layout dataset name. If the concatenated libraries contain duplicate member names, File-AID will always select the first occurrence of the member name.
Expand occurrences
When a record layout which contains an OCCURS or ODO you can specify to view all occurrences (YES) or only the first occurrence of each field.
Y
(Default) View all occurrences.
N
View only the first occurrence.
- Only the first occurrence of an OCCURS/ODO is displayed
- Each field number is displayed once
- Displayed FLD START position is for the first occurrence
After entering the record layout dataset information, press Enter to display the next screen. If you did not specify a member name or you entered a pattern character in the Member name field, a Member List is displayed before the next screen. Use the END (PF3), RETURN (PF4), or a jump command to exit the View Record Layout function.
View Layout
After you press Enter from the View Record Layout - Dataset Specification screen, the View Layout screen is displayed. This screen displays the field level and name, picture, starting and ending positions, and length for each item in the record layout. The field level and name are presented in a format similar to Edit Formatted mode.
The following figure shows the View Layout screen for a COBOL layout. COBOL Record Layout — FASAMP.LAYOUTS(EMPLOYEE) shows the same portion of the corresponding record layout.
View Layout — COBOL
COBOL Record Layout — FASAMP.LAYOUTS(EMPLOYEE)
The following figure shows the View Layout screen for a PL/I layout. PL/I Record Layout — FASAMP.LAYOUTS(PLIEMP) shows the same portion of the corresponding record layout.
View Layout — PL/I
PL/I Record Layout — FASAMP.LAYOUTS(PLIEMP)
The following figure shows the View Layout screen for a COBOL layout with Expand Occurrences NO.
View Layout — COBOL with Expand Occurrences NO
The starting and ending position, and length are shown for both elementary and group items.
From the record layout screen, you can do the following:
- Use the UP, DOWN, and LOCATE commands to scroll through the record layout. The scroll amount field is on line two of the screen.
- Use the END (PF3), RETURN, or a jump command to exit the View Record Layout screen.
If the member contains multiple 01-level structures, File-AID identifies how many layouts there are and displays a message line to identify the first and next layout(s). For example:
MEMBER CONTAINS 6 LAYOUTS
-------- FIELD LEVEL/NAME --------- --PICTURE-- FLD START END LENGTH
> > > > > START OF LAYOUT NUMBER 1 < < < < <
.
.
.
> > > > > START OF LAYOUT NUMBER 2< < < < <