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.

RFMT Select Member List screen

image2021-3-19_15-31-8.png

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.

Reformat Record Layouts Screen

image2021-3-19_15-31-51.png

Field Descriptions

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 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 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 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 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 to continue.

  • File-AID displays the Reformat Definition Editor.

    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.

Related topics

Reformat-Definition

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*