Information
Space announcement: BMC provides limited support for this version of the product. As a result, BMC no longer accepts comments in this space. If you encounter problems with the product version or the space, contact BMC Support.

Reformat Execution - Batch


The following figure creates the JCL needed to submit a batch job to execute the record reformat. The batch job consists of one job step that invokes File-AID/Batch. The step includes a DD name of DD01RF. The DD01RF DD statement contains the name of the saved reformat definition. Since File-AID uses the reformat definition data set for the batch process, it cannot execute in batch a reformat definition that was dynamically created.

The only File-AID/Batch control card statement included in the JCL specifies the REFORMAT function. The REFOUT parameter default value is the same as that specified in the Number of Records to Process field on the Reformat Execution - Batch screen.

File-AID --------------------- Reformat Execution - Batch ---------------------
OPTION  ===>

Validate datasets before JCL generation ===> Y     (Y = Yes; N = No)  

Specify Input Dataset:
  Dataset name   ===> 'USERID9.FASAMP.EMPLOYEE'
  Member name    ===>
  Volume serial  ===>                   (If not cataloged)
  Disposition    ===> SHR               (OLD or SHR)  
  I/O exit name  ===>                   (User written I/O program)  

Specify Output Dataset:
  Dataset name   ===> 'USERID9.FASAMP.EMPLOYE2'
  Member name    ===>
  Volume serial  ===>                   (If not cataloged)
  Disposition    ===> OLD               (OLD; SHR; MOD; NEW)  
  I/O exit name  ===>                   (User written I/O program)  

Copy unselected records      ===> N     (Y = Yes; N = No; drop unselected)
Number of records to process ===> 0     (1-9999999; 0 = all)  

 Use END to END or ENTER to continue REFORMAT MODE

Field Descriptions

Validate datasets before JCL generation

Specify whether or not you want File-AID to validate the data sets before it generates the JCL:

Y

Yes. Automatically validate the data sets.

N

No. Do not automatically validate the data sets. If you select NO, you can allocate the files at a later time or another job or job steps can create the files. For tape files, use N (No).

Specify Input Dataset:

Dataset name

Specify the data set name of the input file. 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.

Enter the FILELIST primary command or blank out the Dataset name field to display the Last Referenced File List. Entering the FILELIST primary command will prompt you to select both the Input and Output data set from the Last Referenced File list. For more information, see Last Referenced File List.

Member name

Specify the member name of the input file. If you leave the Member Name 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 Dataset Name field.

Volume serial

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

Disposition

Specify the status of the data set:

SHR

Allocates data set for shared access.

OLD

Allocates data set for exclusive access.

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 input data set. Blank the field when no I/O exit program is to be used with the input data set.

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 Output Dataset:

Dataset name

Specify the data set name of the output file. 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.

Enter the FILELIST primary command or blank out the Dataset name field to display the Last Referenced File List. Entering the FILELIST primary command will prompt you to select both the Input and Output data set from the Last Referenced File list. For more information, see Last Referenced File List.

Member name

Specify the new or existing member name of the output file. If you leave the Member Name 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 Dataset Name field.

Volume serial

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

Disposition

Specify the status of the data set:

SHR

Allocates data set for shared access.

OLD

Allocates data set for exclusive access.

MOD

Allocates data set for exclusive access and extends it.

NEW

When NEW is specified, you are prompted to allocate the file online. Once the file is allocated, File-AID changes the Disposition to OLD.

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 output data set. Blank the field when no I/O exit program is to be used with the output data set.

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.

Copy unselected records

Specify if you want all input records or only those records that meet the reformat selection criteria copied to the output data set:

Y

Yes, copy all records. Records that do not match the reformat selection criteria are copied unchanged (REFOUT=ALL).

N

Copy only those records that meet the reformat selection criteria (REFOUT=SEL).

Number of records to process

Specify the number of records to be written to the output data set:

1-9999999

Write the specified number of records to the output data set.

0

Write all records to the output data set.

This is useful for testing the reformat definition with large files. It is recommended that you process a small number of records to verify the reformat definition before processing the entire file.

After you complete the fields on the Reformat Execution - Batch screen, press Enter to continue. File-AID displays the Reformat JCL Specification screen. Use the END (PF3) command to display the Reformat Definition Editor screen.

 

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

BMC Compuware File-AID/MVS 21.01