MIGRATE-VM (Migrate VM)

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

After the synchronous checking of the prerequisites for the VM, control is given back to the caller. The VM Migration itself is executed asynchronously. It can be monitored with a MONJV.

During the VM Migration, the VM is only stopped for a short time. User operation, network transfers and transactions on the guest system continue normally on the target SU.

This command is reserved for the VM2000 administrator.

MIGRATE-VM

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

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

,MONJV= *NONE / <filename 1..54 without-gen-vers>

,JV-PASSWORD = *NONE / <c-string 1..4> / <x-string 1..8> / <integer -2147483647..2147483648>

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.

MONJV =
Defines a MONJV for monitoring the VM Migration (see "Monitoring a VM Migration with job variables (MONJV)").

MONJV = *NONE
No MONJV is defined.

MONJV = <filename 1..54 without-gen-vers>
The specified MONJV is supplied with data by VM2000; therefore, the sender of the command must have write permission for the specified MONJV. If no catalog ID or user ID is specified in the file name, VM2000 completes the file name, in accordance with the runtime environment of the sender of the command.

If the specified file name does not refer to an existing job variable, VM2000 creates the MONJV as shareable and without a password.

JV-PASSWORD = *NONE / <c-string 1..4> / <x-string 1..8> / <integer ...>
Password of the MONJV for checking access authorization. The input field is automatically blanked in the guided dialog. The value input is not logged.

This operand is only evaluated if a previously created job variable was specified with MONJV.

Command return codes

(SC2)   SC1	Main code	Meaning
0 1             0 2             0 64 64 64 64 64 64 64 64 64 64	CMD0001 CMD0001 VMS2480 VMS2101 VMS2332 VMS2341 VMS2400 VMS2407 VMS2408 VMS2462 VMS4000 VMS4084 VMS4340	Command successfully executed No action required (source SU = target SU) VM Migration initiated with warnings VM2000 shutdown in progress Storage for VM definitions cannot be reached (SU /390) No unique remote SU found Target SU not detected VM Migration rejected by guest system VM Migration not confirmed in time by the guest system Prerequisites for the VM Migration not met VM not yet created I/O configuration modification active MONJV could not be accessed

Guaranteed messages (on the source SU)

VMS2401 through VMS2407, VMS2409 through VMS2426, VMS2440 through VMS2444,
VMS2450 through VMS2452, VMS2470 through VMS2472, VMS4024, VMS6021

In case of the messages VMS2404 and VMS2421 (migration rejected/aborted by the target SU), the cause is stated as a message insert in the form of the corresponding VM2000 message code.

Guaranteed messages (on the target SU)

VMS2050, VMS2430 through VMS2434, VMS3050, VMS6020

Example

See the example in the section "Example for a VM Migration (SU /390)".