RESUME-VM (Resume VM operation)

/RESUME-VM is used to cancel a VM wait state explicitly imposed beforehand. After command execution, the VM is in the RUNNING state, provided no further wait state had to be taken into consideration.

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

The change of state is noted in the VM definition.

The following rules apply to canceling the wait state:

• 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

Owing to “pending interrupts”, the VM can continue at another address, in another state than specified in the corresponding /HOLD-VM command.

Canceling overlapping wait states is described on "Suspending a VM / resuming operation".

   

RESUME-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
The global wait state is canceled for all suspended VMs. This operand is reserved 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 2             0 64 64 64 64 64	CMD0001 CMD0001 VMS2020 VMS2306 VMS2001 VMS4000 VMS4612 VMS9004 VMS9005	Command successfully executed No action required VM remains in state IN HOLD(WAIT) VM definition could not be updated (SU /390) VM not in state IN HOLD(WAIT) VM not yet created No attached CPU in the CPU pool Command not supported (SU x86) Command could not be processed or could only be partially processed

Guaranteed messages

VMS2001, VMS2016, VMS2020, VMS4083

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   WAIT(SEL)       V20.0B  NO  NO    AS —————————————————————  (2)
/resume-vm vm-id=system2———————————————————————————————————————————————  (3)
VMS2016 VIRTUAL MACHINE (2,SYSTEM2) RESUMED 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   RUNNING         V20.0B  NO  NO    AS —————————————————————  (4)

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

(1)	The VM2000 administrator requests the state of VM2.
(2)	VM2 is in the wait state WAIT(SEL), triggered by a /HOLD-VM VM-ID=2 from the VM2000 administrator.
(3)	The wait state for VM2 is canceled by the VM2000 administrator.
(4)	VM2 is (again) in the RUNNING state.