EDIT XREF segment list

When you press ENTER on the Segment/Layout XREF Dataset Specification screen, the EDIT XREF Segment List screen is displayed. This screen is used to associate segment layouts with the various segment types in a DBD.

EDIT XREF Segment List Screen

Description

Enter up to a 30-character description of the XREF. The description is displayed whenever an XREF member list is used.

Line Cmd

Enter a line command. Line commands are used to insert and delete segment entries from a DBD in the XREF. The S line command is used to select logical child and concatenated segments and segments with multiple formats so that segment layout information can be specified for these types of segments.

I (Insert) Line Command

Adds a segment entry immediately following the entry where the command is entered. Once the entry is inserted, you must specify a segment name and corresponding segment layout member. Only one insert line command can be entered per interaction. The insert line command cannot be entered with a select line command.

D (Delete) Line Command

Deletes a segment entry from a DBD in the XREF. Any number of delete line commands can be entered simultaneously with or without an occurrence of one of the other line commands.

S (Select) Line Command

Select logical child and concatenated segments and segments with multiple formats for editing. The select line command is valid only for these types of segments. Logical child and concatenated segments are automatically identified by displaying *LCHILD* and *CONCAT* in the Member field. Segments with multiple formats are identified by entering an * or *MULT-RTV* in the Member field. When you select one of these types of segments, the appropriate screen is displayed to enable you to enter the segment layout information.

The S line command cannot be entered with the insert command, and only one S line command can be entered per interaction.

Data Base

Displays the DBD member name and is protected and not modifiable. The DBD member name is displayed next to the first segment name within each DBD and, if you scroll the Segment List screen, next to the segment name displayed on the first screen body line.

Segment

Displays the segment name of each segment defined in a DBD. The segment names can be typed over.

Member

Enter either a member name or an asterisk. The most common entry is the member name within your segment layout library that contains the segment layout defining the segment data. If a segment type has multiple formats that require more than one segment layout to define them, enter an asterisk or *MULT-RTV* in this field. You can then select that entry and proceed to EDIT Record Type 1 screen where you can enter the multiple segment layout member names.

Logical child and concatenated segments defined in a DBD are automatically identified when the DBD is added to the XREF. File-AID for IMS displays *LCHILD* or *CONCAT* in the Member field. For these types of segments, the Member field is protected and not modifiable. How to specify segment layout information for logical child and concatenated segments is described in Logical-child-segment.

If the layout which defines a segment is hard-coded in a COBOL or PL/I program, enter the program name in the Member field and specify a starting data-name.

This field’s heading is displayed with either COBOL or PL/I preceding the word MEMBER depending on your current language mode.

Segment Description

Enter a 15-character description for each segment type. If entered, the description is displayed in the heading lines on the Formatted and Unformatted Browse/Edit screens.

Starting Data-Name

Enter a starting data-name within the COBOL or PL/I member to isolate the appropriate segment layout. This action is required only if multiple segment layouts are contained within a single segment layout library member or if a segment layout is hard-coded in a COBOL or PL/I program. The starting data-name must not contain embedded blanks, but it is not otherwise validated against the segment layout until you use the segment/layout XREF in another File-AID for IMS function. File-AID for IMS reads the layout (or program) beginning with the starting data-name and stops reading when a data-name item with a numerically equal or lower level number is encountered or when the end of the layout is reached.