 | A VM need not be moved on SU x86. The command is rejected with message VMS3011 and with general return code VMS9004. |
/MOVE-VM serves to move a VM in VM2000 main memory. Overlapping with the old VM main memory is possible. The monitor VM cannot be moved. A VM cannot be moved while it is being migrated (VM Migration).
This command is reserved for the VM2000 administrator.
MOVE-VM | ||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||
LOCATION =
Specifies the new location of the VM in VM2000 main memory.
LOCATION = *BEFORE-VM(VM-IDENTIFICATION = *NEXT / <integer 2..99> / <name 1..8>)
Specifies the VM before which the new VM is to be located. If *NEXT is specified, the VM is located before the next VM.
LOCATION = *AFTER-VM(VM-IDENTIFICATION = *PREVIOUS / <integer 1..99> / <name 1..8>)
Specifies the VM after which the new VM is to be located. If *PREVIOUS is specified, the VM is located after the previous VM.
LOCATION = *MEMORY-END
The VM is to be located at the end of the available main memory.
LOCATION = <x-text 1..8>(DIMENSION = *BYTE / *MEGABYTE)
Specifies the address with the dimension. The address must be a multiple of 1 Mbyte. Permissible range of values: 00000000..7FF00000 (hexadecimal digits). If necessary, the address is padded with leading zeros.
VM-IDENTIFICATION = <integer 2..99> / <name 1..8>
Identifies the virtual machine by means of a VM index or VM name.
MSCF-COORDINATED =
The VM (in the RUNNING state) is stopped by VM2000 (WAIT(INT) state, see "SHOW-VM-ATTRIBUTES (Output attributes of a VM)"), while it is moved in main memory. The duration of this process is not negligible for a large main memory of the VM (greater than 2 Gbyte; more than 10 seconds). For a guest system, this operand enables lock mechanisms to be used in the MSCF network to protect the guest system from being regarded as failed by MSCF partners while it is being moved.
Detailed information on MSCF is provided in the “HIPLEX MSCF” manual [10].
This operand is ignored for a VM in the INIT-ONLY or DOWN status.
MSCF-COORDINATED = *IF-POSSIBLE
Protection is not requested in the guest system. However, the command is executed even if configuration of this protection has not been confirmed after a specified time or has even been rejected.
A VM in the HOLD state cannot request the protection. The command is executed immediately.
MSCF-COORDINATED = *YES
Protection is not requested in the guest system. The command is rejected if configuration of this protection has not been confirmed after a specified time or has even been rejected.
The command is not executed for a virtual machine in the hold state.
MSCF-COORDINATED = *NO
Protection is not requested.
Command return codes
(SC2) | Main code | Meaning |
0 2 0 64 64 64 64 64 64 128 128 | CMD0001 VMS4103 VMS4000 VMS4011 VMS4071 VMS4100 VMS4101 VMS4102 VMS3042 VMS4049 | Command successfully executed MSCF protection not (yet) canceled again VM not yet created Requested memory size or location not available Invalid memory size or location MSCF protectionnot supported by the guest system (MSCF-COORDINATED=*YES) MSCF protection rejected by the guest system (MSCF-COORDINATED=*YES) MSCF protection not confirmed in time by the guest system (MSCF-COORDINATED=*YES) VM being migrated Memory location of the virtual machine could not be changed as a device is still busy |
Example
/show-vm-resources information=*memory ————————————————————————————————— (1)VM-ID LOC-BEGIN MEM-SIZE MIN-MEM-S MAX-MEM-S DEST-MEM-S
HYPERVISOR 00000000 16 1 MONITOR 00000010 512 512 2 SYSTEM2 00000210 512 512NONE 00000410 14832LARGEST FREE DOMAIN: 14832/move-vm location=*memory-end,vm-id=system2,mscf-coordinated=*if-poss — (2)/show-vm-resources information=*memory
VM-ID LOC-BEGIN MEM-SIZE MIN-MEM-S MAX-MEM-S DEST-MEM-SHYPERVISOR 00000000 16 1 MONITOR 00000010 512 512NONE 00000210 14832 2 SYSTEM2 00003C00 512 512LARGEST FREE DOMAIN: 14832/move-vm location=*after-vm(vm-id=monitor),vm-id=system2 —————————————— (3)/show-vm-resources information=*memory
VM-ID LOC-BEGIN MEM-SIZE MIN-MEM-S MAX-MEM-S DEST-MEM-SHYPERVISOR 00000000 16 1 MONITOR 00000010 512 512 2 SYSTEM2 00000210 512 512NONE 00000410 14832LARGEST FREE DOMAIN: 14832
---------------------------------------------------------------------------------------------------------------------
(1) | The VM2000 administrator queries the distribution of main memory for the VMs. |
(2) | The VM2000 administrator moves VM2 to the end of main memory. A free memory area is created between the monitor VM and VM2. MSCF protection is requested, but the command is executed anyway (default). |
(3) | The VM2000 administrator places VM2 behind the monitor VM again. |