HOLD-VM (Suspend VM)

/HOLD-VM is used to suspend one or more VMs. The monitor VM cannot be suspended. After execution of the command, the VM is in the IN HOLD(WAIT) state.

On SU x86, a VM cannot be suspended. The command is rejected with the message VMS3011 and the general return code VMS9004.

The change of state is also noted in the VM definition.

A VM cannot be suspended while it is being migrated (VM Migration).

This command can be canceled by entering /RESUME-VM. The following rules apply:

• The wait state of a VM suspended by the VM administrator can be canceled by the VM2000 administrator

• The wait state of a VM suspended by the VM2000 administrator cannot be canceled by the VM administrator

Precautions must be taken for guest systems in the MSCF network to ensure that the guest system is not regarded as failed while it is suspended.

Current I/O operations are still executed. However, termination interrupts for these I/O operations are not accepted by the guest system until after the end of the wait state.

Overlapping wait states are described on "Suspending a VM / resuming operation".

   

HOLD-VM

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

VM-IDENTIFICATION =
Identification of the virtual machine.

VM-IDENTIFICATION = *CURRENT
The VM identification assigned previously by means of /BEGIN-VM-DIALOG is used.

VM-IDENTIFICATION = *ALL
All currently running VMs except the monitor VM and the VM for which a VM Migration is running, are suspended. This operand is only permitted for the VM2000 administrator.

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

 

Command return codes

(SC2)   SC1	Main code	Meaning
0 1             0 2             0 64 64 64 64 64 128	CMD0001 CMD0001 VMS2306 VMS1002 VMS2101 VMS4000 VMS9004 VMS9005 VMS3042	Command successfully executed No action required VM definition could not be updated (SU /390) Command not permitted for the monitor VM VM2000 shutdown in progress VM not yet created Command not supported (SU x86) Command not or only partially processed VM being migrated

Guaranteed messages

VMS2000, VMS2012, VMS3041

Example

/show-vm-attributes vm-id=system2 —————————————————————————————————————  (1)
             CPU-POOL(P)
VM-ID        VM-GROUP(G)  CPU-Q   MAX-U  PROC   MEM-SIZE  MAX-IO
 2 SYSTEM2   *STDPOOL(P)  30.00  100.00  1(+1)       512  (100)
VM-ID        STATE           VERSION PER ADMIN PRIV
 2 SYSTEM2   RUNNING         V20.0B  NO  NO    AS —————————————————————  (2)
/hold-vm vm-id=system2 ————————————————————————————————————————————————  (3)
VMS2012 VIRTUAL MACHINE (2,SYSTEM2) PLACED IN WAIT STATE BY THE
        VM2000 ADMINISTRATOR
/show-vm-attributes vm-id=system2
             CPU-POOL(P)
VM-ID        VM-GROUP(G)  CPU-Q   MAX-U  PROC   MEM-SIZE  MAX-IO
 2 SYSTEM2   *STDPOOL(P)  30.00  100.00  1(+1)       512  (100)
VM-ID        STATE           VERSION PER ADMIN PRIV
 2 SYSTEM2   WAIT(SEL)       V20.0B  NO  NO    AS —————————————————————  (4)

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

(1)	The VM2000 administrator requests the status of VM2.
(2)	VM2 is in the RUNNING state.
(3)	The VM2000 administrator suspends VM2 by means of /HOLD-VM.
(4)	VM2 is in the state WAIT(SEL).