Copy Utility panel

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.

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, see Specifying a zFS Pathname.

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 TO and FROM dataset from the Last Referenced File list. For more information, see Last Referenced File List.

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.

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 TO and FROM dataset from the Last Referenced File list. For more information, see Last Referenced File List.

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. For more information, see Installing or your system programmer. 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

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

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.