CHECK-VM-MIGRATION (Checking prerequisites for VM Migration)

/CHECK-VM-MIGRATION checks, if the specified VM can be migrated from the local Server Unit (source SU) to the required Server Unit (target SU).

This command is reserved for the VM2000 administrator.

CHECK-VM-MIGRATION

VM-IDENTIFICATION = <integer 1..99> / <name 1..8>

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

VM-IDENTIFICATION =
Identification of the virtual machine.

VM-IDENTIFICATION = <integer 1..99> / <name 1..8>
Identifies the virtual machine by means of a VM index or VM name.

SERVER-UNIT-NAME =
Determines the Server Unit to which the VM 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	CMD0001 VMS2461 VMS2341 VMS2400 VMS4000	Command successfully executed VM Migration not possible No unique remote SU found Target SU not detected VM not yet created

Guaranteed messages

VMS2331, VMS2401 through VMS2406, VMS2409, VMS2410, VMS2460, VMS2470, VMS2471, VMS2472

Examples (SU /390)

/check-vm-migration vm-id=g4ivo,server-unit-name=d021ze01
%  VMS2404 LIVE MIGRATION OF VM (4,G4IVO) REJECTED BY TARGET SU 'D021ZE01'.
REASON: VMS4011 ———————————————————————————————————————————————————————  (1)
%  VMS2404 LIVE MIGRATION OF VM (4,G4IVO) REJECTED BY TARGET SU 'D021ZE01'.
REASON: VMS4034,9920 ——————————————————————————————————————————————————  (2)
%  VMS2404 LIVE MIGRATION OF VM (4,G4IVO) REJECTED BY TARGET SU 'D021ZE01'.
REASON: VMS2437,9921 ——————————————————————————————————————————————————  (3)
%  VMS2461 LIVE MIGRATION OF VM (4,G4IVO) TO TARGET SU 'D021ZE01' NOT
POSSIBLE ——————————————————————————————————————————————————————————————  (4)

-----------------------------------------------------------------------------------------------------------------

The checks on the target SU have delivered the following results:

(1)	Not enough main memory for the VM to be migrated.
(2)	Device 9920 has already been assigned for shared usage.
(3)	Device 9921 has already been assigned exclusively to another VM.
(4)	The VM Migration is not possible.

-----------------------------------------------------------------------------------------------------------------

/check-vm-migration vm-id=g4ivo,server-unit-name=d021ze01
%  VMS2471 DEVICE '9940' WILL BE DETACHED BY LIVE MIGRATION
%  VMS2471 DEVICE '9941' WILL BE DETACHED BY LIVE MIGRATION
%  VMS2471 DEVICE '9942' WILL BE DETACHED BY LIVE MIGRATION ———————————  (1)
%  VMS2460 LIVE MIGRATION OF VM (4,G4IVO) TO TARGET SU 'D021ZE01'
POSSIBLE ——————————————————————————————————————————————————————————————  (2)

-----------------------------------------------------------------------------------------------------------------

The checks on the target SU have delivered the following results (after correcting the problems in the above example):

(1)	Warnings: Alias devices are automatically detached and removed from the VM during VM Migration.
(2)	The VM Migration is possible.

-----------------------------------------------------------------------------------------------------------------