Compare OLD Dataset Specification

The following figure allows you specify Compare mode, the data set, record layout and XREF, and selection criteria information for the OLD dataset you want to compare.

To access the Compare function, select option 10 from the File-AID Primary Option Menu or enter the appropriate jump command (for example, =10) from any File-AID screen. See Selecting-screens. The Compare function can also be accessed with the F10 recursive command. See Recursive Commands.

Compare OLD Dataset Specification

Field Descriptions

Compare Mode

Specify one of the following valid compare modes:

F (Formatted)

Formatted criteria uses record formats

L (Load Library)

Compare load libraries

U (Unformatted)

Unformatted criteria uses record position

S (Source Code)

Compare source code libraries

J (JCL)

Compare JCL

Source and JCL require Panvalet/Librarian data sets or PDS/PDSE/sequential (RECFM=FB / LRECL=80) data sets.

Specify OLD Dataset Information:

Dataset name or zFS path

Enter the name of the OLD dataset that you want to compare. The data set must be in a valid format for the chosen compare mode, for example, you must specify a load library when you specified a load library compare.

You can enter a pattern data set name in this field to display a list of data sets from which you can make a selection. A pattern data set name or mask consists of explicit characters or a combination of explicit and pattern characters. You can also specify a member name, in parentheses, along with the data set name in this field. For more information on specifying a data set name, see Specifying a dataset name.

Specify the zFS path. If the entered path is a complete path, then the file is processed directly for the Edit, Browse, Compare or Copy function. When a partial path is entered, File-AID displays the zFS Directory List enabling you to continue the drill down process at the last directory level entered. For more information see Specifying a zFS Pathname.

Enter the FILELIST primary command or blank out the Dataset name field to display the Last Referenced File List. For more information, see Last Referenced File List.

Member name

If the file is a partitioned dataset, enter the member name of the OLD dataset you want to compare.
You can leave this field blank or enter a pattern member name in this field to display a list of members from which you can select one or more members. A pattern member name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern Member Names for a complete description. You cannot enter a pattern name in both the Dataset name and Member fields at the same time.
If you enter a pattern member name or mask and do not display a list of members (selection list=no), all qualifying members are compared. A mask of "*" compares all members.

Volume serial

If the data set is not cataloged, enter the volume serial number of the disk or tape containing the data set.

I/O exit name (Optional)

If the I/O exit option has been installed, this input area is provided. For more information, see Installing or your system programmer.

Enter the name of a site-written I/O exit program to be used only with the OLD dataset. Blank the field when no I/O exit program is to be used with the OLD dataset.

I/O exit installation options are:

NO

I/O exit name field is not presented.

YES

I/O exit name field is presented blank for entry of a site-written I/O exit program name.

exitname

I/O exit name field is presented prefilled with the name of a site-written I/O exit program.

Specify Record Layout and XREF Information:

The record layout and XREF information is only required for formatted compare mode.

Record layout usage

Specify one of the following usage values to define the compare files for formatted compare:

S

Single layout member

X

XREF (multiple layouts)

N

None (required for an unformatted, load library, source or JCL compare).

Record layout dataset

Specify the dataset name for the record layout.
You can enter a pattern data set name in this field to display a list of data sets from which you can make a selection. A pattern data set name or mask consists of explicit characters or a combination of explicit and pattern characters. You can also specify a member name, in parentheses, along with the dataset name in this field. For more information on specifying a dataset name, see Specifying a dataset name.

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.

Member name

Specify the member name for the record layout.
You can leave this field blank or enter a pattern member name in this field to display a list of members from which you can make a selection. A pattern member name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern Member Names for a complete description. You cannot enter a pattern name in both the Dataset name and Member fields at the same time.

If the specified layout member contains multiple record layouts, enter the USE primary command on this screen without parameters to display a list of available record layouts. From that list you will be able to select the desired layout. If you don’t enter the USE command ,3 Compare will default to the first layout in the specified member (see also USE ).
When using an XREF, this field is ignored.

XREF dataset name

Specify the data set name for the layout XREF.
You can enter a pattern data set name in this field to display a list of data sets from which you can make a selection. A pattern data set name or mask consists of explicit characters or a combination of explicit and pattern characters. You can also specify a member name, in parentheses, along with the data set name in this field. For more information on specifying a data set name, see Specifying a data set name.

Member name

Specify the member name for the XREF.
You can leave this field blank or enter a pattern member name in this field to display a list of members from which you can make a selection. A pattern member name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern Member Names for a complete description. You cannot enter a pattern name in both the Dataset name and Member fields at the same time.

Specify Selection Criteria Information:

Refer to Selection Criteria (6) for a complete description of selection criteria.

Selection criteria usage

Specify one of the following valid entries:

E

Use existing selection criteria. Enter a data set name in the Selection criteria dataset field.

T

Create temporary selection criteria. File-AID displays the Temporary Selection Criteria Menu. Temporary selection criteria is not automatically saved. Use the SAVE primary command to retain temporary selection criteria.

M

Modify existing selection criteria. Enter a data set name in the Selection criteria dataset field.

Q

Quick selection criteria. File-AID displays the Unformatted Selection Criteria screen for you to enter temporary selection criteria.

N

(Default) None -- Do not use selection criteria.

Selection dataset name

Specify the name of the data set containing existing selection criteria for options E and M.
You can enter a pattern data set name in this field to display a list of data sets from which you can make a selection. A pattern data set name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern data set names for a complete description.

Member name

Specify the member name. You can leave this field blank or enter a pattern member name to display a list of members from which you can make a selection. A pattern member name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern Member Names for a complete description. Pattern names cannot be entered in both the Dataset name and Member name fields at the same time.

After you have completed the fields on the Compare OLD Dataset Specification screen, press Enter to continue. Use the END (PF3) or RETURN (PF4) command to return to the File-AID Primary Option Menu.