MIGRATE-VM-DEFINITION (Migrate VM definition)

/MIGRATE-VM-DEFINITION migrates the specified VM definition from the local Server Unit (source SU) to the required Server Unit (target SU).

The VM definition may not belong to a VM which has already been initialized.

This command is reserved for the VM2000 administrator.

MIGRATE-VM-DEFINITION

VM-NAME = <name 1..8>

,SERVER-UNIT-NAME = *UNIQUE / <composed-name 1..64>

VM-NAME = <name 1..8>
Identification of the VM definition by the VM name.

SERVER-UNIT-NAME =
Determines the Server Unit to which the VM definition is to be migrated (target SU). The target SU must belong to the same active SU cluster as the local SU (source SU).

SERVER-UNIT-NAME = *UNIQUE
If an SU cluster consists of only two Server Units, the remote SU is unique and chosen automatically as the target SU. Otherwise, the name of the target SU has to be specified.

SERVER-UNIT-NAME = <composed-name 1..64>
Name of the target SU.

   In case of a target SU /390, this is the BS2000 host name of the monitor system.

 

Command return codes

(SC2)       SC1	Main code	Meaning
0 2             0 64 64 64 64 64 64 64 64 64 64 64	CMD0001 VMS2321 VMS2300 VMS2323 VMS2324 VMS2325 VMS2332 VMS2341 VMS2400 VMS2402 VMS2403 VMS2410 VMS4015	Command successfully executed Migration successful. However, the VM definition could not be deleted on the source SU. VM definition does not exist VM definition could not be migrated Migration of the VM definition rejected by the target SU Migration of the VM definition not confirmed in time by the target SU Storage for VM definitions cannot be reached (SU /390) No unique remote SU found Target SU not detected Target SU not available Connection to target SU aborted Target SU is not in the active SU cluster with the source SU VM already initialized

Guaranteed messages

VMS2320

Example

/migrate-vm-definition vm-name=g4ivn,server-unit-name=d020ze01
% VMS2320 DEFINITION OF VM 'G4IVN' MIGRATED TO TARGET SU 'D020ZE01'