Reformat Execution - Online
Field Descriptions
Display file after reformat
Specify whether or not you want the file displayed when Reformat is complete:
N
Do not display the data file
B
Data file is redisplayed under the Browse function
E
Data file is redisplayed under the Edit function.
Specify Input Dataset:
Dataset Name
Specify the dataset 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 dataset 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 dataset 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 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 dataset 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 dataset 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 dataset 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 containing the output 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.
N
Copy only those records that meet the reformat selection criteria.
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 - Online screen, press Enter and File-AID executes the reformat definition under your TSO address space. If online processing is delayed, File-AID displays an informational screen that indicates foreground processing is in progress.
When executing an existing reformat definition (saved) and you specified a B or an E in the Display file after reformat field, File-AID displays the Record Layout Specification screen when the processing is complete.
To stop the reformat definition processing, press the ATTN key. If you terminate the processing, the data set is only partially processed and the results are unpredictable. Use the END command (PF3) to return to the Reformat Definition Editor screen.