ALTER subcommand — change a name in the IPCS inventory

Use the ALTER subcommand to change the name of a dump or trace data set in an IPCS dump directory.

Syntax

ALTER 

{DSNAME(dsname)|DATASET(dsname)|FILE(ddname)|DDNAME(ddname)}
 NEWNAME({ DSNAME(dsname)|DATASET(dsname)|FILE(ddname)|DDNAME(ddname) }

-------- SETDEF-Defined Parameters -------------------------
Note: You must specify one of the following SETDEF parameters:

      { DSNAME(dsname) | DATASET(dsname) }
      { FILE(ddname) | DDNAME(ddname) }
      [ PATH(path-name)     ]

Note: You can override the following SETDEF parameters.
See SETDEF subcommand — set defaults.

      [ TEST | NOTEST ]

Parameters
DSNAME

Designates the current dsname or ddname of the dump or trace.

NEWNAME

Designates the new dsname or ddname of the dump or trace. The ALTER subcommand does not actually change the name of any data sets, only the association between dump directory data and a name.
For consistency with the TSO (and IDCAMS) ALTER command, you can use NEWNM as an abbreviation of the NEWNAME keyword.

The ALTER subcommand requires that the dump whose description is to be affected be explicitly specified.