RFMT select member list

The following figure is displayed when the Member name field for the Reformat Definition Dataset is left blank or an * (asterisk) or pattern is specified for it on the Reformat Definition screen. The list may be scrolled using LOCATE commands (LOC mem) or scrolling commands (such as UP and DOWN).

See Member List Field Descriptions for a description of each field on this screen. See Member List Primary Commands for a list of valid primary commands.

Reformat Record Layouts

If you entered a D in the OPTION field, or left the OPTION field blank and specified the name of a new member on the Reformat Definition screen, File-AID displays the Reformat Record Layouts screen as shown in the following figure. Use this screen to define the record layouts for a new reformat definition. This screen supports both COBOL and PL/I record layout information.

If you specified new data set and member names on the Reformat Definition screen, the top line of the screen indicates that you are in create mode. File-AID does not display an informational mode flag when you dynamically create (option D) a reformat definition.

File-AID ---------------- Reformat Record Layouts ---------------------------
COMMAND ===>

Specify Source Record Layout and XREF Information:
  Record layout usage   ===> S          (S = Single; X = XREF)
  Record layout dataset ===> 'USERID9.FASAMP.LAYOUTS'
  Member name           ===> ORDERPO    (Blank or pattern for member list)
  XREF dataset name     ===>
  Member name           ===>            (Blank or pattern for member list)

Specify Target Record Layout and XREF Information:
  Record layout usage   ===> S          (S = Single; X = XREF)
  Record layout dataset ===> 'USERID9.FASAMP.LAYOUTS'
  Member name           ===> EMPLOYEE   (Blank or pattern for member list)
  XREF dataset name     ===>
  Member name           ===>            (Blank or pattern for member list)

Move corresponding?     ===> YES        (YES or NO)

Ignore prefix           ===>
Ignore suffix           ===>

The following table describes the fields on the Reformat Record Layouts panel:

Field	Description
Specify Source Record Layout and XREF Information
Record layout usage	Specify one of the following usage values to define the reformat source record layout files: S—Single record layout X—XREF (record layout cross reference).
Record layout dataset	Specify the name of a data set that contains the COBOL or PL/I source record layout. The data set can be a sequential file, source PDS, or a CA Panvalet or CA Librarian source library. You can use a pattern character in this field. You can also specify a member name, in parentheses, with the data set name. For more information, see Specifying a dataset name. Specifying a Concatenation List To specify a concatenation list, enter a plus sign ( + ) followed by the name of the member (+membername) containing the list in the Record layout dataset field instead of the Record layout data set name. For example, if the member RLPROD contains the list to be used, enter +RLPROD. 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 data sets, 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 always selects the first occurrence of the member name.
Member name	Specify the member name of the source record layout. If you leave the Member field blank or enter a pattern, a member list is displayed. You can use an asterisk (*) as the last character to identify a pattern. You can also specify a member name, in parentheses, along with the data set name in the Record layout dataset field. If the member you specify contains multiple 01-level structures, File-AID displays the Reformat Multiple Layout Selection screen. Specify the 01-level structure to use for the source layout.
XREF dataset name	Specify the name of the XREF dataset. You can use a pattern character in this field. You also can specify a member name, in parentheses, along with the data set name in this field. See Specifying a dataset name.
Member name	Specify the XREF member name. If you leave the Member field blank or enter a pattern, a member list is displayed. You can use an asterisk (*) as the last character to identify a pattern. You can also specify a member name, in parentheses, along with the data set name in the XREF dataset field. When you use an XREF member, File-AID displays the Display XREF screen for you to select a layout from the list. See Display XREF Screen as shown in Reformatting-data-sets-with-multiple-record-types.
Specify Target Record Layout and XREF Information
Record layout usage	Specify one of the following usage values to define the reformat target record layout files: S—Single layout (default). X—XREF.
Record layout dataset	Specify the name of a data set that contains the target record layout. The data set can be a sequential file, source PDS, CA Panvalet or CA Librarian source library, or a File-AID map data set. You can use a pattern character in this field. You can also specify a member name, in parentheses, with the data set name. For more information, see Specifying a dataset name. Specifying a Concatenation List To specify a concatenation list, enter a plus sign ( + ) followed by the name of the member (+membername) containing the list in the Record layout dataset field instead of the Record layout data set name. For example, if the member RLPROD contains the list to be used, enter +RLPROD. 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 data sets, 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 always selects the first occurrence of the member name.
Member name	Specify the member name of the target record layout. If you leave the Member field blank or enter a pattern, a member list is displayed. You can use an asterisk (*) as the last character to identify a pattern. You can also specify a member name, in parentheses, along with the data set name in the Record layout dataset field.
XREF dataset name	Specify the XREF dataset name. Use this field to specify the XREF dataset with a member containing a layout from a program or multiple 01-level layout. Otherwise, specify S for Record layout usage and select the target layout directly from the layout data set. You can use a pattern character in this field. You also can specify a member name, in parentheses, along with the data set name in this field. See Specifying a dataset name.
Member name	Specify the member name for the XREF layout. If you leave the Member field blank or enter a pattern, a member list is displayed. You can use an asterisk (*) as the last character to identify a pattern. You can also specify a member name, in parentheses, along with the data set name in the XREF dataset field.
Move corresponding?	When File-AID processes the Move corresponding value, File-AID compares the source record layout fields with the target record layout fields. If they match, File-AID places field references in the Target fields of the Reformat Definition Editor screen (Reformat Definition Editor Screen). Specify whether you want File-AID to complete the target record layout fields if they match the source record layout fields: YES—Yes (default), complete the target record layout fields. File-AID does not automatically match COBOL FILLER fields. NO—No, do not complete the target record layout fields. Important For more information about using field references for the reformat definition, see Using Field References and Literals.
Ignore prefix	If you specify a prefix, File-AID ignores it in the target field name. During the matching process, File-AID checks each target entry for the prefix. If the target entry has the prefix, File-AID ignores the length of the prefix in the source field name. If File-AID does not match the prefix, it checks the field for an exact field name match. You can use an asterisk () or string of asterisks as a wild card in the prefix. If you specify asterisks, File-AID does not compare the prefix in the target entry and ignores the length of the prefix in the source field name. Example 1 Ignore Prefix ===> BF Target Field Name Source Field Name Action BF-FIRST-NAME AB-FIRST-NAME Selected, prefix matched AA-FIRST-NAME AB-FIRST-NAME Not Selected, prefix not matched BB-FIRST-NAME BB-FIRST-NAME Selected, prefix not matched, field name exact match Example 2 Ignore Prefix ===> * Target Field Name Source Field Name Action BF-FIRST-NAME AB-FIRST-NAME Selected, prefix ignored
Ignore suffix	If you specify a suffix, File-AID ignores it in the target field name. During the matching process, File-AID checks each target entry for the suffix. If the target entry has the suffix, File-AID ignores the length of the suffix in the source field name. If File-AID does not match the suffix, it checks the field for an exact field name match. You can use an asterisk () or string of asterisks as a wild card in the suffix. If you specify asterisks, File-AID does not compare the suffix in the target entry and ignores the length of the suffix in the source field name. Example 1 Ignore Suffix ===> BF Target Field Name Source Field Name Action FIRST-NAME-BF FIRST-NAME-AB Selected, suffix matched FIRST-NAME-AA FIRST-NAME-AB Not selected, suffix not matched FIRST-NAME-BB FIRST-NAME-BB Selected, suffix not matched, field name exact match Example 2 Ignore Suffix ===> * Target Field Name Source Field Name Action FIRST-NAME-BF FIRST-NAME-AB Selected, suffix ignored Example 3 Ignore Prefix ===> ** Ignore Suffix ===> BF Target Field Name Source Field Name Action BF-FIRST-NAME-BF AB-FIRST-NAME-AB Selected, both matched BF-FIRST-NAME-AA AB-FIRST-NAME-AA Selected, suffix not matched; prefix matched, rest name match BB-FIRST-NAME-BF BB-FIRST-NAME-AA Selected, prefix not matched, suffix matched, rest name match

After you complete the fields on the Reformat Record Layouts screen, press Enter and the Reformat Definition Editor panel is displayed.

If you specified YES in the Move corresponding field, File-AID creates field references for the Target fields on the Reformat Definition Editor screen. When the Reformat Definition Editor screen is displayed, the field references are in the Target fields. No data is moved in this process; only field references are created. These field references take effect only when the reformat definition is executed. You can change a field reference any time using the reformat editor. See Reformat-Definition-Editor.

Important

When using the same layout for Source Layout and Target Layout, specify NO to Move corresponding. Then, use a field reference of /0 in target field 0 (zero). This greatly speeds processing when executing your reformat definition to perform a selective copy.

Use the END command (PF3) to return to the Reformat Definition screen.

RFMT select member list

Reformat Record Layouts

On this page