ALTER

The ALTER command changes the attributes of an MVS data set.

Parameters:

MFJAMS supports the following parameters. They are supported as documented in the IBM documentation unless otherwise stated below:

data-set-name
Name of the data set to be renamed. This parameter is required.
{EMPTY|NOEMPTY}
Determines processing when the maximum number of generation data sets (GDSs) has been cataloged.
LIMIT(limit)
Determines the maximum number (between 1 and 255) of active generation data sets (GDSs) that might be associated with a generation data group (GDG) base.
NEWNAME(data-set-name)
The new name for the data set. This parameter is required.
When a data set is renamed, the underlying physical file is also renamed, as long as it is stored within a directory under the one in which the catalog file is stored. To rename a physical file stored outside of sub-directories of the catalog, set the environment variable MF_PCRENAME_LAX=Y. Setting this variable causes the filename to be changed, but the location is not changed. For allocation overrides to take effect, which may include changing the directory the file is stored in, set MF_PCRENAME_LAX=D.
Warning: When used on a Dynamic PDS, the name of the cataloged PO dataset will change, but not the location or names of the PDS members. If a file is moved from a disk-based file system to a Fileshare hosted one, or vice-versa, or between two different Fileshare servers, the file needs to be copied. This can take some time, depending on the number of records in the file.
{SCRATCH|NOSCRATCH}
Determines whether generation data sets, when they are uncataloged, are to be deleted.
SHAREOPTIONS(crossregion[ crosssystem])
Abbreviation: SHR
Used when a cluster, data or index component of a cluster or alternate index can be shared among users. No default value is assumed in this system. To nullify an existing value use SHAREOPTIONS(0,0). See the SHAREOPTIONS help topic for more information.
MANAGEMENTCLASS(class)
Abbreviation: MGMTCLAS
Gives the name, 1 to 8 characters, of the management class for a data set. This parameter is required.
TO(date)|FOR(days)[2]
Specifies the retention period for the entry being altered. The maximum retention period may be limited by the management class.

Comments:

Within NEWNAME, you cannot use * as a qualifier to rename a number of data sets with one command. For example, ABC.*.FILE is not permitted.