MOVE DSGROUP and COPY DSGROUP Statements

The MOVE DSGROUP statement is used to move groups of data sets whose names are partially qualified by one or more identical names. The data sets may be cataloged on several catalogs. Source data sets are scratched. Data set groups to be moved must reside on DASD volumes. Only data sets that could be moved by MOVE DSNAME or MOVE PDS can be moved by MOVE DSGROUP. Alias entries in catalogs for the data sets are lost and can be replaced with access method services.

The COPY DSGROUP statement is used to copy groups of data sets whose names are partially qualified by one or more identical names. The data sets may be cataloged on several catalogs. Only data sets that can be copied with COPY DSNAME or COPY PDS can be copied with COPY DSGROUP. Data set groups to be copied must reside on DASD volumes.

Related reading: For more information, see z/OS DFSMS Access Method Services Commands.

MOVE DSGROUP operations cause the catalog to be updated automatically unless UNCATLG is specified. COPY DSGROUP operations leave the source data sets cataloged unless UNCATLG or CATLG is specified without the RENAME and FROM parameters.

The syntax of the MOVE and COPY DSGROUP statements is:

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

where:

DSGROUP=[name]

specifies the cataloged data sets to be moved or copied. If name is a fully qualified data set name, only that data set is not moved or copied. If name is one or more qualifiers, but not fully qualified, all data sets whose names are qualified by name are moved or copied. If name is omitted, all data sets whose names are found in the searched catalog are moved or copied.

TO=device={serial|(list)}

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

PASSWORD

specifies that password protected data sets are included in the operation. This is not VSAM password protection, but the data set password scheme. This is described in the z/OS DFSMSdfp Advanced Services. If PASSWORD is omitted, only data sets that are not protected are copied or moved.

UNCATLG

specifies that the catalog entries pertaining to the source data sets are 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 integrated catalog facility for the source data sets are lost and can be replaced with access method services if the data sets are later cataloged. For more information, see z/OS DFSMS Access Method Services Commands. For a MOVE operation, UNCATLG inhibits cataloging of the output data sets.

CATLG

specifies that the cataloging is done in the integrated catalog facility catalog.

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

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 output data sets on tape volumes can be obtained.

The DD statement describes the mode and label information to be used when creating output data sets 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 creating unloaded versions of data sets on tape volumes. 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 sets are 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.