RENAME Statement

The RENAME statement is used to change the true name or alias of a data set or member residing on a DASD volume. The name is changed only on the designated volumes. The rename operation does not update the catalog.

A RENAME operation will not be processed if the data set or volume is being used by a program executing concurrently. When renaming a member of a partitioned data set, it is your responsibility to ensure that the data set is not currently in use.

For multivolume data sets, all volumes specified must be online.

If you do not code the MEMBER parameter, the entire data set is renamed.

When renaming a data set managed by the Storage Management Subsystem (SMS), care must be taken to ensure that the device type and volumes list on the VOL parameter reflects the volume actually allocated to the data set. When you specify a volume when allocating an SMS-managed data set, SMS will not automatically allocate the data set on that volume.

When renaming SMS-managed data sets, IEHPROGM will uncatalog the data set and recatalog the data set under the new name. If recataloging is necessary, but cannot be done (because of an alias), IEHPROGM will not rename the data set.

The syntax of the RENAME statement is:

Label	Statement	Parameters
[label]	RENAME	DSNAME=name ,VOL=device=(list) ,NEWNAME=name [,MEMBER=name]

where:

DSNAME=name: specifies the fully qualified name of the data set to be renamed or the partitioned data set that contains the member to be renamed. The name must not exceed 44 characters, including delimiters.
VOL=device=(list): specifies the device type and serial numbers of the volumes, limited to 50, that contain the data sets. If only one serial number is listed, it need not be enclosed in parentheses. Multiple serial numbers should be separated with commas.
If MEMBER is specified, VOL cannot specify more than one volume.
NEWNAME=name: specifies the new fully qualified name or alias name for the data set or the new member.
MEMBER=name: specifies a member name or alias of a member (in the named data set) to be renamed. This name is not validity-checked because all members must be accessible, whether the name is valid or not.
Default: The entire data set or volume of data sets specified by name is changed.