MVS driving object

The MVS Driving Object screen shown in the following figure is displayed when you enter the NEW command in the Extract Reference List or the Request File Member List Screen and your profile specifies that the driving object is an MVS file, or you enter the MVS command in the Db2 Driving Object screen.

Use this screen to specify the name of the MVS file for which you want to extract related data. All fields are prefilled with information from your current profile.

MVS Driving Object

After entering or viewing the driving object information, press ENTER to proceed to the Extract Menu.

File To Drive Extract Process From Area

Use the File Name field in this area to specify the MVS file for which you want to retrieve relationship information from the relationship file so you can extract related data. When specifying patterns in the fields, File-AID/RDX presents selection lists and then searches the relationship file.

File name

Specify the MVS file name of the object from which you want to extract related data. To view a list of files, specify a pattern. Valid pattern character is * (see Pattern Characters). If you specify a pattern, select a file from the “Catalog Utility File List” as shown in MVS Catalog Utility File List (for Pattern FR*.ORDERTAB.

If the file name is found in the relationship file, File-AID/RDX uses the layout information as stored in the relationship file, not as entered in the Optional File Information fields.

If the MVS file is not in the relationship file, File-AID/RDX will ask you whether to continue with a single object extract or restart your extract request (see Relationship Listing Window - No Relationships).

Optional File Information Area

The following fields are not needed when the selected MVS file is found in the relationship file. However, if the driving object file name is not in the relationship file, you must specify the layout information when continuing with a single object extract.

Record layout usage

Indicate whether a single record layout (usage "S"), or an XREF (usage "X") had been used to define the selection criteria. Only needed when no relationships have been defined for the MVS file.

Record layout file

Specify the record layout file for the MVS object from which you want to extract related data. To view a list of layout files, specify a pattern. Valid pattern character is * (see Pattern Characters). If you specify a pattern, select a file from the “Catalog Utility File List” as shown in MVS Catalog Utility File List (for Pattern FR*.ORDERTAB.

Member name

Specify the member of the record layout file that contains the layout information for the MVS object. Leave blank or use a pattern to narrow the search.

XREF file

Only needed if layout usage is X. Specify the XREF file name for the MVS object from which you want to extract related data. Valid pattern character is * (see Pattern Characters). If you specify a pattern, select a file from the “Catalog Utility File List” as shown in MVS Catalog Utility File List (for Pattern FR*.ORDERTAB.

Member name

Specify the member of the XREF file that contains the layout information for the MVS object. Leave blank or use a pattern to narrow the search (see also XREF Select Member List Screen).

Relationship Information:

File name or pattern

Specify the name of the file that contains the application relationship information you want to use for the extract process. To view a list of files, specify a pattern. Valid pattern character is * (see Pattern Characters). If you specify a pattern, select a file from the “Catalog Utility File List” as shown in MVS Catalog Utility File List (for Pattern FR*.ORDERTAB.

When you leave this relationship file field blank, File-AID/RDX will create a single object extract.

Primary Command

The following File-AID/RDX-specific primary command is valid on this screen:

Db2 (D)

Switches to the Db2 Driving Object panel prefilled with the applicable information from your profile. See Db2 Driving Object.

Relationship Listing Window—No Relationships

If the file name you specified as the driving object is not found in the relationship file, File-AID/RDX will ask you whether to continue with a single object extract or restart your extract request.

Relationship Listing Window - No Relationships

If you press ENTER for a single object extract, File-AID/RDX will use the optional file information you specified on the MVS Driving Object panel.

MVS Catalog Utility File List

When specifying a pattern in any of the file name fields in the MVS Driving Object panel, File-AID/RDX searches the MVS catalog and displays any matches. Select the file name you want to place in the applicable field with the S line command. The message in the top line indicates for which field the list is displayed:

• Select File (driving object or relationship file)
• Select Record Layout
• Select XREF file

MVS Catalog Utility File List (for Pattern FR*.ORDERTAB)

Field Descriptions

Dataset name

File names that match the entered file name pattern.

Type

Catalog entry type. Types that may be displayed include: CLUSTER, DATA, INDEX, ALT INDEX, PATH, NON-VSAM, GDG BASE, USER CTLG, ALIAS, and PAGESPACE.

Volume

Volume on which the file is stored. Multi-volume files are identified by the + (plus sign) following the Volume field.

PDS Processing Options

A PDS Processing Options screen is displayed when the file name on the MVS Driving Object screen refers to a partitioned dataset (PDS). It is used to specify member selection values to choose members based on a name mask, name range, the userid for last modification, and creation and modification date ranges.

To display a nonselective member list, leave all member selection options blank on the PDS Processing Options screen and press Enter.

PDS Processing Options Screen

Field Descriptions

The following list describes all PDS processing options that File-AID/RDX can present.

Member name mask

Specify a member name mask to select a subset of members based on the mask criteria. A pattern member name or mask consists of explicit characters or a combination of explicit and pattern characters.

Member name range

Specify a member name range to select a subset of members based on the characters in the member name. The endpoint member names (FROM and TO) can be complete or partial and are included in the member list when found. Pattern characters are not allowed.

If the FROM member field is blank and a TO member is specified, File-AID/RDX selects the members less than or equal to the TO member padded with high values.

If a FROM member field is specified and the TO member is blank, File-AID/RDX selects members greater than or equal to the FROM member padded with low values.

Entering the same characters in the FROM and TO fields selects all members beginning with those characters.

Last modified userid

Specify a user identification range to select a subset of members based on the user ID that last updated and saved a member. This information is a PDS statistic that is stored in the directory.

The endpoint userids (FROM and TO) can be complete or partial and are included in the member list when found. Pattern characters are not allowed. As with member name range, the FROM field is padded with low values and the TO field is padded with high values.

Members without PDS statistics, because they were not created (STATS OFF) or the statistics were deleted, are not selected.

Creation date

Specify a creation date range to select a subset of members based on their creation date(s). This is a PDS statistic that is stored in its directory.

The endpoint (FROM and TO) dates can be complete or partial and are included in the member list when found. Leading zeros are required when specifying the year, month, and day.

If the FROM date field is blank and a TO date is specified, File-AID selects all members created on or before the specified TO date.

If a FROM member date is specified and the TO date is blank, File-AID selects all members created on or after the specified FROM date.

Entering the same dates in the FROM and TO fields selects members created only on that date. The two-character year is assumed between 1960 and 2059. Partial creation dates are treated positionally (YY/MM/DD) and are padded with default values.

For example, if you enter blanks the default FROM value becomes 60/01/01 and the TO value becomes 59/12/31. If you enter 85, the defaults are 85/01/01 and 85/12/31. If you enter 85/09, the defaults are 85/09/01 and 85/09/30.

Members without PDS statistics, because they were not created (STATS OFF) or the statistics were deleted, are not selected.

Modification date

Specify a modification date range to select a subset of members based on the last modified date(s). This is a PDS statistic that is stored in its directory. The last modified date is updated with the current date each time a member is updated and saved.

See the description of the Creation date field for more information on specifying a modification range. The specifications are identical.

Members without PDS statistics, because they were not created (STATS OFF) or the statistics were deleted, are not selected.

XREF Select Member List

The following figure is displayed when a blank or a pattern is specified in the Member field for the XREF file name. The list may be scrolled using LOCATE commands (LOC mem) or scrolling commands (such as UP and DOWN).

Select the desired XREF member with the S line command.

XREF Select Member List Screen