Working with VM definitions

Each BS2000 VM on a Server Unit of an SE server has a configuration description, the VM definition.

The VM definition is created in the following cases:

• When a VM is initialized, see "Initializing a VM"

• With /CREATE-VM-DEFINITION

• With /RECOVER-VM-DEFINITION (transfer in the SU cluster)

VM definitions are stored on a system disk.

On SU /390, BCAM must be active in the monitor system in order to work with VM definitions.

A VM definition is identified by the VM name. It contains:

• Attributes and resources which are assigned to the VM (initialized VM) or envisaged for the VM.

• Devices which are assigned to the (initialized) VM or envisaged for the VM.

• Status of the VM (for display in the SE Manager).

The following attributes of a VM are not contained in the VM definition:

• Location of the VM in the main memory of VM2000 (SU /390, is defined by VM2000).

• MONJVs (are determined when the VM definition is activated).

A persistent VM definition is created in the following cases:

• When initializing the VM with /CREATE-VM, PERSISTENT=*YES operand.

• When modifying the VM attributes with /MODIFY-VM-ATTRIBUTES, PERSISTENT=*YES operand.

• When creating a VM definition with /CREATE-VM-DEFINITION.

• When creating a VM definition using the SE Manager.

The monitor VM and other VMs have a non-persistent VM definition.

A persistent VM definition is also available to a Server Unit after a reboot. With its help a persistent VM is set up again and restarted immediately when the corresponding specifications are provided in the AUTO-IPL parameter.
A persistent VM definition is not deleted by /DELETE-VM.

 

Requirements (SU /390)

On SU /390, VM2000 requires an active BCAM in the monitor system to work with VM definitions on the system disk.

When BCAM is active again in the monitor system and VM2000 was able to perform a complete data comparison with the system disk, message VMS2330 is issued.
Until this occurs, all VM2000 commands which directly concern the VM definitions (e.g. /ACTIVATE-VM-DEFINITION or /SHOW-VM-DEFINITION), or set the PERSISTENT attribute (PERSISTENT=*YES operand in /CREATE-VM or /MODIFY-VM-ATTRIBUTES) are rejected with message VMS2332.
All other VM2000 commands are executed. The contingent changes in the VM definitions are saved by the VM2000 hypervisor and later (before message VMS2330 is issued) transferred to the system disk.

In the case of planned termination of BCAM (BS2000 command /BCEND) in the monitor system, VM2000 issues message VMS2331. After that VM2000 behaves in the way described above until BCAM is active again (VMS2330).

When BCAM is active in the monitor system but the network connection to the system disk is (temporarily) faulty, VM2000 commands which concern VM definitions may possibly be executed with a warning or rejected with a corresponding message.

After warning VMS2306 or VMS2308, VM2000 attempts periodically to subsequently update the VM definition.