MOVE DSNAME and COPY DSNAME Statements

The MOVE DSNAME statement is used to move a data set. The source data set is scratched. If the data set is cataloged, the catalog is automatically updated unless UNCATLG and FROM are specified.

The COPY DSNAME statement is used to copy a data set. The source data set, if cataloged, remains cataloged unless UNCATLG or CATLG is specified without the RENAME and FROM parameters. The source data set is not scratched in a copy.

The syntax of the MOVE DSNAME and COPY DSNAME statements is:

Label	Statement	Parameters
[label]	{MOVE\|	DSNAME=name
	COPY}	,TO=device={serial\|(list)}
		[,{FROM=device={serial\| (list)}\|
		[,UNCATLG]
		[,CATLG]
		[,RENAME=name]
		[,FROMDD=ddname]
		[,TODD=ddname]
		[,UNLOAD]
		[,COPYAUTH]
Note: CATLG may only be coded with COPY DSNAME

where:

DSNAME=name

specifies the fully qualified name of the data set to be moved or copied.

TO=device={serial| (list)}

specifies the device type and volume serial number of the volume or volumes to which the specified data set is to be moved or copied. If the data set resides on more than one volume, code the list of volume serial numbers in parentheses, separating the numbers with commas.

FROM=device={serial| (list)}

specifies the device number or device type and serial number of the volume on which the data set resides. If the data set resides on more than one volume, enclose the list of serial numbers within parentheses, separating the numbers with commas.

If the data set is cataloged, do not code "FROM".

If you want to specify a specific device rather than device type, code the device number in the device subparameter.

When FROM is used with MOVE DSNAME, the catalog will not be updated.

If the data set resides on a tape device, the serial number must be enclosed in parentheses, and the data set sequence number must be included as follows: "(serial,sequence number)".

If FROM is omitted, the data set is assumed to be cataloged in the integrated catalog facility catalog.

UNCATLG

specifies that the catalog entry pertaining to the source data set is to be removed. This parameter should be used only if the source data set is cataloged. If the volume is identified by FROM, UNCATLG is ignored. Alias entries in catalogs for the source data set is lost and can be replaced with access method services if the data set is later cataloged. For more information, see the DELETE command in z/OS DFSMS Access Method Services Commands. For a MOVE operation, UNCATLG inhibits cataloging of the output data set.

CATLG

specifies that the copied data sets are to be cataloged as described below:

The cataloging is done in the integrated catalog facility catalog.
If the RENAME and FROM parameters are omitted, the entries for the source data sets are deleted from the appropriate catalog to permit the copied data sets to be recataloged.

For proper results, this control statement option must be used instead of specifying the "CATLG" option in the "DISP" parameter in the DD statements.

CATLG may only be coded with COPY DSNAME.

RENAME=name

specifies that the data set is to be renamed, and indicates the new name.

FROMDD=ddname

specifies the name of the DD statement from which DCB and LABEL information, except data set sequence number, can be obtained for input data sets on tape volumes. The FROMDD operand can be omitted, if the data set has standard labels and resides on a 9-track tape volume.

TODD=ddname

specifies the name of a DD statement from which DCB (except RECFM, BLKSIZE and LRECL) and LABEL (except data set sequence number) information for an output data set on a tape volume can be obtained.

The DD statement describes the mode and label information to be used when creating the output data set on tape volumes. Record format, blocksize and logical record length information, if coded, is ignored.

When UNLOAD is specified, it describes the mode and label information to be used when unloading the data set. Record format, blocksize and logical record length information, if coded, must specify (RECFM=FB, BLKSIZE=800, LRECL=80).

TODD must be specified in the control statement when an expiration data (EXPDT) or retention period (RETPD) is to be created or changed.

The TODD parameter can be omitted for 9-track tapes with standard labels and default density for the unit type specified.

UNLOAD

specifies that the data set is to be unloaded to the receiving volumes.

COPYAUTH

specifies that the receiving data set is to be given the same access list as the input data set, if the input data set is RACF protected and the output data set is not preallocated.