SAVE-VM-CONFIGURATION (Save the VM2000 configuration)

/SAVE-VM-CONFIGURATION is used to save the current VM2000 configuration to a file. See section "Backing up and restoring the VM2000 configuration".

Persistent VMs are not saved. For each persistent VM a warning (VMS4817) is issued. They can also be restored with /ACTIVATE-VM-DEFINITION after the VM2000 configuration has been restored with /RESTORE-VM-CONFIGURATION.

The VM2000 configuration cannot be saved while a VM is being migrated (VM Migration).

This command is reserved for the VM2000 administrator.

SAVE-VM-CONFIGURATION

TO-FILE = *STD / <filename 1..54 without-cat-gen-ver>

TO-FILE =
Name of the backup file for the current VM2000 configuration.

TO-FILE = *STD
The file is assigned the name SYS.VM2.CFG.<system_name><timestamp>.

TO-FILE = <filename 1..54 without-cat-gen-ver>
Explicitly defines the name of the backup file.

Command return codes

(SC2)   SC1	Main code	Meaning
0 2             0 2             0 64 64 64 128 128 128 128	CMD0001 VMS4814 VMS4818 VMS2070 VMS4840 VMS4841 VMS3042 VMS4830 VMS4831 VMS4832	Command successfully executed An extra CPU is attached when the VM2000 configuration is restored from the backup file Warnings occur when saving the VM2000 configuration VM in the IN HOLD (WAIT) state Creation of the backup file rejected by DMS Error writing to the backup file VM being migrated VM has not yet reached SYSTEM READY Memory reconfiguration being processed Device configuration during processing

Guaranteed messages

VMS4800, VMS4817

Example

/save-vm-configuration to-file=vm2000-conf
VMS4800 CURRENT VM2000 CONFIGURATION SAVED IN FILE ':4IVZ:$TSOS.VM2000-CONF'