Update CRL Descriptions

Record Layouts › How to Create or Update a Custom Record Layout › Update CRL Descriptions

Update CRL Descriptions

After you have chosen the member name, you will want to define the layout description, define the record offset (described later), or create the views for the custom record layout.

To define layout descriptions

Select LAYOUT from the Main Menu.
The Record Layout screen opens.
Type option U to update the custom record layout.
Type the record layout DSN.

Type the custom record layout member name, and press Enter.

The Custom Record Layout Member Update screen displays for a new layout:

----- CA File Master Plus -- Custom Record Layout Member Update ----- COMMAND ===> SCROLL ===> CSR Custom Layout DSN ===> 'CUSTOMER.PROJECT.COPYLIB' Custom Layout Member ===> CUSTOM5 Description ===> ___________________________________________________ Record Offset ===> (Optional) I - Insert Entry D - Delete Entry S - Display / Update Entry A Member Layout DSN Default _ __________ ____________________________________________ _ ____________________________________________ ******************** End of Custom Record Layout Entries **********************

If you are creating a new layout, there are initially no views defined, so the scrollable list at the bottom of this screen should contain only one empty line. When updating an existing layout, all of your existing views should be listed on the bottom portion of this screen.

Complete the following fields, and press Enter:
Custom Layout DSN

Identifies the DSN of the library in which the custom record layout has been created.

Custom Layout Member

Identifies the member name of the CRL. This is retrieved from the Member field.

Description

Defines the custom record layout in a brief free-format description. This can be used for identification. This is a required field.

Record Offset

Defines the offset within the file record data corresponding to the first field in the record layout. The offset value applies to every view defined within the custom record layout.

If the first field in the COBOL or PL/I record layout does not correspond to the start of the record data, type the record offset that corresponds to the start of the first field in the layout.

Values:

Numeric, but may contain a leading + or - sign.

If the record layouts contain a record descriptor word for variable-length records, type -4 in this field to indicate that the layout begins mapping the record data four bytes before the start of the record.

There is only one record offset for each custom record layout, and its value applies to every view defined within the layout.

A

Defines the action for the screen.

Values:

I—Insert—Creates a new view within the custom record layout.

D—Delete—Removes an existing view from the layout. Once deleted, a view cannot be restored.

S—Display—Selects an existing view for update.

Member
Defines the name of a source or copy member containing the ordinary COBOL or PL/I record layout that will be used as the base for the view when inserting a new view into the custom record layout.

Values:
- A single COBOL or PL/I record layout
- Multiple COBOL or PL/I record layouts
- An entire COBOL or PL/I source program with embedded record layouts
If it contains more than one record layout, a list of record layouts is displayed. Select a single record layout to be used for the view.

After you enter a view, this field becomes protected and cannot be changed.

Values:

Blank, or type a wildcard to display a list of members from the library.
Layout DSN

Defines the name of the library containing the ordinary COBOL or PL/I layout member when inserting a new view into the custom record layout.
Values:

A partitioned data set, a CA Librarian or a CA Panvalet library, or a wildcard, which displays a list of data set names, or can be resolved from a DSN list.

After you add a view, this field becomes protected and cannot be changed.

Default

Defines the default view if you type Y in this column. The default view is used for formatting file data when none of the selection conditions established for any of the views is matched.
To create a new view, type I on the action line to insert a new entry in the list.
If there are no views defined to this layout, a blank entry should already be displayed
Select an ordinary COBOL or PL/I record layout to use as the base for this view. This must be a separate member residing in any source or copy library. It can exist by itself as a standalone copy member, or as part of a larger copy member containing multiple record layouts, or even as an embedded layout within an entire COBOL or PL/I program.

Type the library and member names for the record layout you have selected in the layout DSN and member fields, respectively. Press Enter to view the layout.

If the member that you have selected contains more than one record layout, the Layout Selection screen displays.

------------ CA File Master Plus -- Layout Selection Row 1 to 2 of 2 COMMAND ===> SCROLL ===> CSR Custom Layout DSN ===> 'CUSTOMER.PROJECT.COPYLIB' Custom Layout Member ===> CUSTOM5 Description ===> Custom Record Layout #5 Layout File Name ===> TECH2.LAYOUT(CUSTREC) S - Select Layout A 01 Level Field Name _ 01 CUST-RECORD _ 01 CR1-RECORD ******************************* Bottom of data ********************************

Select only one layout to use from the list provided as the base layout for your new view.
In this example, the copy member CUSTREC contains two record layouts named CUST-RECORD and CR1-RECORD.
Type S in the line action column next to the record you would like to select, and press Enter to select that record layout.