Previous Topic: COPY CommandNext Topic: VSAM Cluster Considerations


COPY Command Syntax

The COPY command syntax is:

COPY ABSOLUTE,BLKSIZE=,CATALOGALL,CONTIG,CREATE,CYL,MERGE,NEWNAME=,NEWVOLUMES,PDSECONV PREALLOC,REDUCE,TARGETONLY,TOVOL=,TRACK,VATHRESH=,STORCLAS=,MGMTCLAS=,DATACLAS=
ABSOLUTE

This optional parameter is provided to permit the override of the default action of not copying a BDAM data set with absolute addressing. This parameter requires that the data set be preallocated on a like device, and that the PREALLOC parameter also be specified. This parameter is applicable only to non-VSAM data sets.

BLKSIZE=

When reblocking is desired, this optional parameter must be specified in one of the two following ways:

When reblocking keyed data sets, the reblocked size can be less than the limit block size specified. For more information, see Reblocking. This parameter is applicable only to non-VSAM data sets.

CATALOGALL

The presence of this parameter will cause even uncataloged source volume data sets to be cataloged to the target volume. The default catalog action for the COPY command is no action. This parameter is applicable only to non-VSAM data sets.

CONTIG

Specify this parameter if the new data sets are to be copied to the target volume only if they can be allocated in one contiguous extent. (Default allocation uses standard DADSM allocation, which will usually result in one extent, but will allow up to five if the volume is badly fragmented.) This parameter is applicable only to non-VSAM data sets.

CREATE

Specify this parameter if the creation date for the target data set is to be set equal to the current date. Default processing leaves the original creation date unaltered. Specifying this parameter will cause the DASD Billing support to charge for the target data set from its real creation date, not from the source data set's creation date. This parameter is applicable only to non-VSAM data sets.

CYL

Specification of this parameter will force all allocations on the target volume(s) to be rounded to the next highest cylinder and the allocation type to be cylinder rather than track. This parameter is applicable only to non-VSAM data sets.

MERGE

Specifying this parameter and the PREALLOC parameter will cause the pre-allocated target PDS or PDSE to be merged by the source PDS or PDSE. The existing target PDS or PDSE members will be overlaid by the same named source PDS or PDSE members.

NEWNAME=

A different name can be given to the data set on the target volume if security checking permits it. A relative GDG name is permitted. This parameter is required for VSAM data sets.

NEWVOLUMES

This parameter pertains to the migration of multi- volume data sets. When specified, it will indicate that none of the original volumes on which the data set resides be considered as candidate volumes when data sets are selected by volume.

As an example; A data set resides on volumes A, B, and C. It is selected to be copied to volumes D, E, and F, and volume selection criteria is used (that is, SELECT VOL=A). With NEWVOLUMES specified, only volumes D, E, and F will be considered as candidate volumes. Without NEWVOLUMES specified, volumes B, C, D, E, and F will be considered.

PDSECONV

Specify this parameter and set SYSPARM SMSALLOC to N to automatically convert PDSE to PDS if the target data set is not eligible to be SMS-managed.

PREALLOC

This parameter must be entered to permit a copy to preallocated data sets on a target volume. The default action is to bypass data sets having an allocation on a target volume. When this parameter is present, only one target volume can be specified. This parameter is applicable only to non-VSAM data sets.

REDUCE

Specify this parameter when the space allocations on the target volumes should be based on amount of space used rather than amount allocated. This parameter is only applicable to PO and PS data set organizations with a non-zero secondary allocation amount. (See the TRACK parameter also.) This parameter is applicable only to non-VSAM data sets.

TARGETONLY

Specifying this parameter forces the target allocation to the volume specified on the TOVOL= parameter. This is useful when making a copy of a data set with a different name, and you want both source and target data sets to remain on the source volume. This parameter is applicable only to VSAM data sets.

TOVOL=

Specify this parameter to identify a list of 1 to 20 volume names or volume name patterns to which data sets are to be moved. If this parameter is not specified, CA Disk will attempt to copy the data set to its original volume. This can fail if the NEWNAME= parameter is not specified or if space does not exist on the original volume.

TRACK

When the REDUCE parameter is also present, this parameter causes PS and PO data sets allocated by cylinders but using less than one cylinder to have their allocations changed to tracks and the unused space released. This parameter is applicable only to non-VSAM data sets.

VATHRESH=

This parameter indicates the percent of the volume (for VSAM) that is to be filled. Specify a value from 1 to 99 that indicates the maximum threshold of space CA Disk is to use on a volume. For example, a value of 80 indicates that CA Disk can fill a volume until 80% of its space is used and then will attempt to choose other volumes for new allocations.

DATACLAS=

For a VSAM or non-VSAM SMS managed data set, the value supplied for this parameter is the new Data Class name to be assigned to the data set at allocation time. The Data Class name supplied must be previously defined to SMS.

Note: This parameter is only valid when sysparm SMSALLOC is specified with a Y.

MGMTCLAS=

For a VSAM or non-VSAM SMS managed data set, the value supplied for this parameter is the new Management Class name to be assigned to the data set at allocation time. The Management Class name supplied must be previously defined to SMS.

Note: This parameter is only valid when sysparm SMSALLOC is specified with a Y.

STORCLAS=

For a VSAM or non-VSAM SMS managed data set, the value supplied for this parameter is the new Storage Class name to be assigned to the data set at allocation time. For non-SMS-Managed data sets, supplying this parameter will cause the target data set to be SMS-Managed. In either case, the Storage Class name supplied must be previously defined to SMS.

This parameter is only valid when the sysparm SMSALLOC is specified with a Y.