Generate overrides

The Generate File Overrides screen is displayed when you select option U.3 from the Primary Option Menu, or option 3 from the Utilities Selection Menu. The Generate File Overrides screen, shown in the following figure, allows you to specify the criteria to process when generating an entry for a file override.

Generating overrides is executed as a batch job. All selected criteria is processed, and one entry is written for each data set or file name specified within any of the criteria sets within the selected criteria.

Generate File Overrides

Field Descriptions

Specify Change Criteria Information:

Dataset name

Enter the change criteria data set name to populate the File Override data set.

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 in section Specifying-a-dataset-name 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 one or more selections. A pattern member name or mask consists of explicit characters or a combination of explicit and pattern characters. See Pattern Member Names in section Specifying-a-dataset-name for a complete description. Pattern names cannot be entered in both the Dataset name and Member name fields at the same time.

Specify File Override Information:

Override dataset name

Enter the name of the File Override data set. The data set can be a sequential file, PDS, or PDS/E. The data set record format can be fixed or variable. The logical record length (LRECL) for fixed is 156 or greater. LRECL for variable is 160 or greater. If the data set does not exist, an allocation screen is displayed so a data set can be created. For more information, see Override Data set Allocation.

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 in section Specifying a data set name 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 in section Specifying-a-dataset-name for a complete description. Pattern names cannot be entered in both the Dataset name and Member name fields at the same time.

OVERRIDE Select Member List

The OVERRIDE Select Member List screen, shown in the following figure, is displayed when a blank or a pattern is specified in the Member name field for the File Override data set on the Generate File Overrides - Dataset Specification 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.

Override Select Member List Screen

Override data set allocation

The Allocate Dataset New screen is displayed when the override data set does not exist. This allocate screen is based on whether or not a member name for a File Override data set is entered at the Generate Overrides screen.

The below figure shows the allocation screen for a sequential dataset. Specify the allocation parameters for the new output data set.

Override dataset allocation

Field Descriptions

The displayed values can be accepted or changed by overtyping them.

Dataset name

Name of new data set specified in the Output Dataset name field on the Output Specification screen.

Management Class

Specify the management class to use for the allocation of the data set. The management class describes the migration, backup, and retention for the data set.

Storage Class

Specify the storage class to use for the allocation of the data set. The storage class describes the hardware requirements of the data set.

Data Class

Specify the data class to use for the allocation of the data set. The data class describes the attributes of the data set such as RECFM, DSORG, LRECL, BLKSIZE, etc.

Specify Allocation Parameters:

Volume serial

Specify the volume serial of the direct access device that you want to contain the data set. Specify the location in either the Volume serial or Generic unit field.

Generic unit

Generic unit address for the direct access volume to contain the data set. Specify the location in either the Volume serial or Generic unit field.

Space units

Specify one of the following storage unit types depending on how the data set size is expressed:

Primary quantity

Specify the primary allocation quantity as specified in the space units field.

Secondary quantity

Specify the secondary allocation quantity as specified in the space units field.

Directory quantity

For a PDS, specify the number of directory blocks.

Record format

Specify a value with a combination of the following codes (F or V is required):

Record length

Specify a logical record length, in bytes, of the records to be stored in the data set. File-AID/Data Solutions validates this value with the record format and block size. The following record lengths are valid:

Block size

Specify the physical record length, in bytes, of the blocks to be stored in the data set. File-AID/Data Solutions validates this value with the record format and record length.

Expiration date

(Optional) Specify a date value in the format: YYYY/MM/DD. This value specifies the date when the data set may be deleted. If this field is left blank, the data set can be deleted immediately.

Dataset Name Type

Specify the type of new data set name. Valid entries are: Library, PDS, or blank (default).

Number of Volumes

Specify whether you want to allocate the data set on multiple volumes. Valid entries are Y (Yes), N (No), or a number from 2 to 255 for the number of generic volumes to allocate. When you specify Y, File-AID/Data Solutions displays the Specify Volume Serial Numbers pop-up window. You may enter up to 40 specific volume serial numbers.

Press <Enter> to allocate the data set, or use the END command (PF3) to cancel the allocation.

Generating override JCL

When you have completed all appropriate field entries for generating a File Override data set, press <Enter> and the Override - JCL Specification screen, shown in the below figure, is displayed.

Override JCL Specification Screen

On the Override - JCL Specification screen you can enter the following commands:

Override JCL Edit Screen

The generated JCL can be edited, submitted with the SUBMIT primary command, and saved by using the CREATE or REPLACE primary commands. Saving your generated Override function JCL allows you to postpone execution or rerun the same job at another time.

Editing the file override data set

Each entry written to the File Override data set includes the old file name and the new file name. The old and the new file name are initially the same, until you edit the new file name. To edit the new file name, you can use ISPF EDIT or File-AID/MVS. the below figure is an example of a File Override data set before being edited.

File Override Data set Before Editing

The columns in the data set are described below:

An asterisk in column 1 is treated as a comment record and is ignored.