Command Reference › CHGVOLNM Command

CHGVOLNM Command

Use the CHGVOLNM command to change the volser (and all references to it) of any DASD volume controlled by CA VM:Secure.

CHGVOLNM   oldvolser newvolser {LABEL | NOLABEL}

When issuing the CHGVOLNM command, CA VM:Secure must have OPTION D84NOPAS in its directory entry if the directory has any user IDs that have the special password of LBYONLY. Failing to have this authorization can result in errors and the command outcome can be unpredictable.

When CHVOLNM detects when more than one volume is online with the same volser, the command will exit with return code 100 and issue message 811E. To avoid this, do the following:

1. Use the CP VARY OFFLINE rdev command to vary any volumes offline, that has the same volser of the volume, you want to change. This also applies to the volumes defined as Parallel Access Volumes (PAV). rdev specifies the real device address of the volume.

   The volume specified by rdev is VARIED OFFLINE.

2. Use the CP VARY OFFLINE rdev for each PAV alias volume to make sure that only one definition of the volume is available online, so that each volser is unique.

   Each PAV alias volume specified by rdev is VARIED OFFLINE.

3. Execute the CHGVOLNM command to change the volser of the volume.

   The volser of the volume changes.