Copy Utility screen

The following figure is used to specify the input and output dataset names, whether to process the copy online or in batch, and selection criteria usage information.

Copy Utility screen

image2021-3-18_18-12-35.png

Field Descriptions

Specify "FROM" Dataset or zFS Path Information:

Dataset or path

Specify the name of the source dataset or source zFS path.

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

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 on specifying an zFS path, see Specifying a zFS Pathname.

Volume serial

Specify the volume serial of the direct access device that contains the data set.

This field is required only when the dataset name is not cataloged.

Specify "TO" Dataset or zFS Path Information:

Dataset or path

Specify the name of the destination dataset or zFS path.

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

For information on specifying an zFS path, see Specifying a zFS Pathname.

Volume serial

Specify the volume serial of the direct access device that contains the data set.

This field is required only when the dataset name is not cataloged.

Disposition

Specify OLD, MOD or NEW.

The File-AID Copy utility lets you choose whether to overwrite the TO file (DISP=OLD), to append data to the end of an existing file (DISP=MOD), or to allocate online a new file modeled after the FROM dataset (DISP=NEW). When copying a Version 2 PDSE with member generations, specify NEW, otherwise only the current member (0 generation) will be copied.

The following rules apply to DISP=MOD:


    • MOD is ignored for Partitioned data sets and BDAM.
    • If appending to a keyed file (KSDS, IAM), the first record copied must have a key higher than the last record currently on file.
    • If copying one or more members of a PDS to a sequential file all members are copied one after another to the output file. The disposition only determines where to start writing the output (beginning (OLD) or end (MOD) of data set).

The following rules apply to DISP=NEW:

    • NEW is allowed for Sequential, Partitioned, BDAM, and VSAM (KSDS, ESDS, RRDS) data sets.

    • The NEW dataset will be allocated online using the FROM dataset as a model. This is true even if the batch job option is chosen.

      Important

      Panvalet and Librarian files are supported as FROM datasets only. They may not be specified as TO datasets.

    A Disposition of SHR is not allowed because of potentially disastrous results to data integrity.

Specify Execution Information:

Process online or batch

Specify a processing value: O (Online) or B (Batch). See Online Processing and Batch Processing.

Specify Selection Criteria Information:

See 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 dataset 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 dataset 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. Quick selection criteria is not automatically saved. Use the SAVE primary command to retain quick 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 dataset name in this field to display a list of data sets from which you can make a selection. A pattern dataset 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.

I/O Exit Name (Optional)

If the I/O exit install option is set to YES or exitname, you may specify I/O handling for both input (FROM) and output (TO) data sets. See the File-AID Installation and Configuration Guide or your system programmer for more information. I/O exit install options are:

NO

I/O Exit Name field does not appear.

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 name.

Output data set I/O options let you specify: NONE to bypass the I/O exit, blank to use the input I/O exit, or an exitname to use a specific I/O exit for output processing.

Online Processing

When processing the Copy utility online and the appropriate field values are entered, File-AID redisplays the Copy utility screen with the message: xxxx RECORDS COPIED or xxxx MEMBERS COPIED in the upper-right corner of the screen, where xxxx indicates the number of records copied. If no records are found that meet the selection criteria, File-AID displays the message: 0 RECORDS COPIED or 0 MEMBERS COPIED.

Batch Processing

When batch processing is specified and you have completed all appropriate field entries, press Enter and File-AID displays the JCL Specification Screen, as shown in the following figure.

JCL Specification Screen

image2021-3-18_18-13-12.png

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

JCL

File-AID generates the JCL to process the job and displays it on an edit screen, as shown in Generated JCL Edit Screen.

SUBMIT

Submits the batch job.

CANCEL

Terminates the function.

Generated JCL Edit Screen

image2021-3-18_18-13-35.png

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 Copy function JCL gives you the ability to postpone execution or rerun the same job at another time.

Important

When F.3.3 online creates batch JCL (Process online or batch = B) and your userid has 8 characters File-AID uses the 1st 7 characters of the Jobname for the HLQ for the Audit dataset. This can cause issues with RACF so the PREFIX() parameter should be coded, for example if your userid is PFH8LJW0:

The jobname in the created JCL is PFH8LJW0. When that job is submitted, File-AID uses the first 7 characters of the jobname for HLQ = PFH8LJW.
PFH8LJW may or may not have RACF rules. If it doesn't then the allocation will fail.
To avoid the RACF failure then code PREFIX(PFH8LJW0).

Or use the tso-prefix for the audit trail dataset as described under Audit trail dataset to avoid this issue.

Related topics

Copy-Utility-3-3

File-AID installation and configuration guide

 

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