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