Command Reference › CHGVOLNM Command › Description

Description

Note: The CHGVOLNM command requires a CP formatted disk label. Do not use the CHGVOLNM command against CMS‑formatted minidisks.

The CHGVOLNM command allows you to change the volser of any DASD volume controlled by CA VM:Secure, and to have it update all references to the volume by its new volser, including the reference in the physical label of the DASD.

CA VM:Secure changes references to the old volser in the following:

• The VOLUME record in the DASD CONFIG file that identifies the volume to CA VM:Secure
• All MDISK statements in all source directory entries that define minidisks on the target volume, including both minidisks CA VM:Secure controls and minidisks it does not control
• Authorizations in all GRANT and WITHHOLD records to use the COMPRESS volser and MAP volser commands
• CA VM:Secure control blocks, directory source files, and the object directory

Important! CHGVOLNM does not change the volser parameter on the DIRECT record in the PRODUCT CONFIG file. If you change the volser of the object directory volume, you must change that record manually; otherwise CA VM:Secure will not initialize.

At its completion, CHGVOLNM sends a file called CHGVOLNM UPDATE to your A‑disk. This file lists the user ID and virtual address of each MDISK statement that was updated and indicates the original volser and the new volser. If a file with this name already exists, CHGVOLNM appends the new information to the existing information in the file and indicates the date and time the changes occurred.

To prevent the CHGVOLNM command from having to wait for a lock, CA VM:Secure acquires a private lock against the entire DRCT (source) disk during execution of the command. This lock prevents other directory management tasks from starting and may cause currently running tasks to wait until the command completes.

Note: If a system failure occurs while CHGVOLNM is running, the volser change may be only partially complete. You may have to manually change references to the volser that CHGVOLNM did not change before the system failure.

Examples

• To change the physical volser for a DASD volume from XA0001 to ESA001 and to update all appropriate MDISK statements, GRANT and WITHHOLD records, and internal objects to refer to the new volser, enter:

  vmsecure chgvolnm xa0001 esa001 label
  

• To change all references to the volume without changing the physical volser, enter:

  vmsecure chgvolnm xa0001 esa001 nolabel