Field Descriptions

Utility Functions › Copy Utility › Field Descriptions

Field Descriptions

Copy "FROM" Data Set

Data set name

Type the DSN of the input file for the copy function. This file can be a sequential file, PDS, or VSAM file.

Member name

If the data set being copied is a PDS, specify the Member name of the member to be copied.

You can leave this field blank to receive a directory of the members in the data set or type a wildcarded member name to receive a directory of members that match that wildcard. From a member directory, select the members to be copied.

Volume serial

If input data set to the copy function is uncataloged, type the volume serial of the volume on which the data set resides.

Copy "TO" Data Set

Data set name

Type the DSN of the output file for the copy function. This file can be a sequential file, PDS, PDS member, or VSAM file.

Volume serial

If output data set to the copy function is uncataloged, type the volume serial of the volume where the data set resides.

Disposition

Specify the disposition of the output of the copy function as SHR, OLD, NEW, or MOD. Only the first position of the disposition field is required.

SHR – Output data set already exists, can be shared while copying into it
OLD – Output data set already exists, cannot be shared while copying into it
NEW – Output data set does not currently exist and will be allocated
MOD – Output data set already exists and records will be copied and appended to the existing data set or library members

Replace Mems

When copying PDS members, use this field to chose whether to replace members that already exist on the 'TO' PDS with the member from the 'FROM' PDS.

Replace Keys

When copying records to a VSAM KSDS, use this field to chose whether to replace duplicate keys in the TO data set. When this option is set to N and the TO VSAM KSDS data set was defined with the REUSE option, the 'TO' data set is opened in load mode. When this option is set to Y and the 'TO' VSAM KSDS was defined with the REUSE option, the 'TO' data set is opened in update/extend mode.

Execution Mode

The choices for execution mode are:

O – Perform the function online.
S – Generate and submit JCL to perform the function.
E – Generate JCL to perform the function and initiate an edit session on the JCL. Alter the JCL as needed and submit the JCL or save it to another location.

Record Layout

Layout dataset

Type the DSN of the Record Description Copy Library member that describes the input file. You can also type a wildcarded DSN to request a list of data sets from which you can select the desired data set. This field is required when using the LAYOUT primary command.

Layout member

Type the Member Name of the Record Description Copy Member that describes the input file.

Leave this field blank to receive a directory of the members in the Layout data set. You can also type a wildcarded member name to receive a directory of members that match that wildcard.

Specify the LAYOUT command on this panel when you specify a Layout data set and member and you also want to dynamically build the dynamic selection by field names defined in the record layout.

Selection criteria below or Selection criteria member

Specifies selection criteria if the records or members of the input file will be filtered according to selection criteria. Use selection criteria to specify a filter based on the following types of parameters:

Condition that evaluates data values in each record
Presence of a character string within a record or specified columns or field name from a record layout
Specification of the first record to be selected based on relative record number, VSAM key, or VSAM RBA
Limit to the number of records to be selected

Use a cataloged selection criteria parameter member that has been defined using CA File Master Plus Option 0.3.

Use the primary command LAYOUT.

For sample Selection Criteria specifications, see the following table. For a complete explanation of the syntaxes, request field-level help.

Selection Criteria	Description
101 = C'NY'	Position 101 for a length of 2 equals 'NY'
1(3) = C'001 & 101 = C'NY'	Compound condition
C'TEXAS'	Character string 'TEXAS' anywhere in the record
'TEXAS'	Text 'TEXAS' (any case) anywhere in the record. If the character string contains imbedded blanks or an imbedded operand, the character string must be within quotes.
10(4) EQP	Position 10 for a length of 4 is any valid packed value
80 = C'NY'C'NJ'C'MA'	Position 80 for a length of 2 equals 'NY' or 'NY' or 'MA' (case sensitive)
80 = C'NY,NJ,MA'	Position 80 for a length of 2 equals 'NY' or 'NY' or 'MA' (case sensitive)
100(2) = P'0,1,999'	Position 100 contains a two-byte packed value of 0 or 1 or 999
82(2) > 84	Position 82-83 is greater than positions 84-85
101(20) CO C'NEW YORK'	Positions 101-120 contain 'NEW YORK'. (case sensitive and can appear anywhere within positions 101-120)
STARTREC=1001	Select records beginning with record number 1001
STARTKEY='56789'	Select keyed VSAM records beginning with key 56789
STARTRBA=X'1FD8'	Select records starting with the record with RBA x'1FD8'
INLIM=5000	Stop reading/selecting after reading 5000 records.
SELLIM=1000	Only select 1000 records based on selection criteria
STATE-CODE NE 'NY'	Field STATE-CODE not equal 'NY' (requires LAYOUT information)
80 = C'NY' C'TX' AND 100 = C'000'	Position 80 for a length of 2 equals 'NY' or 'TX', AND position 100 for a length of 3 equals '000'
TRAN-DD GT '01' AND TRAN-DD LT '06'	Field TRAN-DD is '02' '03' '04', or '05'
MEMBER criteria	Specifies that 'criteria' (specified after the MEMBER command) applies to PDS member selection only. This parameter and subsequent selection criteria is ignored if specified for non-PDS data sets. Examples: MEMBER 'texas' MEMBER 101 EQ 'NY' MEMBER is the default for selection criteria specified for PDS or PDSE data sets when no member or a generic member name is specified.
RECORD criteria	Specifies that 'criteria' (specified after the RECORD command) applies to record selection only. When a data set or member(s) are selected for browse or edit, only selected records will be displayed. Examples: MEMBER 'texas' MEMBER 101 EQ 'NY' RECORD is the default for VSAM and sequential files or for fully qualified PDS-member names.