VMSAVE Save VM System Configuration Parameters to File

VMSAVE [FILE=sample] [, ID=n] [, HOST=host] [, VSN=N|Y] [, LOC=Y|N]

The VMSAVE command saves the configuration parameters and the device assignments of each VM system to a separate file. These files can be used to initialise the VM system by means of a /CALL-VM-PROC file command.

Any existing password for the /BEGIN-VM-DIA command will be read from the VMCONFIG file, and so will be stored in this file being saved.

FILE=sample

Template file name. In addition to a file name string, at least one of the substitute variables !ID, !NAME or !HOST must be contained in this template so that the file name can be associated with one of these attributes, i.e. the VM Index, VM name or BCAM host name. Default: FILE=CFS.VM-PROC.CREATE.!ID

Note:

If the VMCONFIG file contains a record type SAVE:, then the name specified in the record will be used as the configuration file name in the VMSAVE command.

Examples:

VMSAVE FILE=CFS.VM-SAVE.!NAME.!ID

The configuration files created for the VM systems will be named as follows:

CFS.VM-SAVE.MONITOR.1, CFS.VM-SAVE.GUEST1.2, etc.

VMSAVE FILE=CFS.VM-SAVE.!NAME

The configuration files created for the VM systems will be named as follows:

CFS.VM-SAVE.MONITOR, CFS.VM-SAVE.GUEST1, CFS.VM-SAVE.GUEST2

ID=n Only the configuration parameters relating to the guest system with the specified VM-INDEX n will be saved.

By default, the configuration parameters for all initialised VM systems will be saved.

HOST=host

Only the configuration parameters relating to the system with the specified BCAM host name will be saved.

VSN=Y The device type (and additionally for tape and disc devices, the VSN) will be saved in the VM configuration files as a descriptive comment. The current VSN of the device can only be ascertained if the device has been assigned to a guest system and made available there by means of an ATTACH command.

LOC=N The LOCATION=addr operand of the CREATE-VM commands written to the file will be suppressed.