REMOVE-VM-FROM-VM-GROUP (Remove VM from VM group)

No VM groups are available on SU x86. The command is rejected with message VMS3011 and with general return code VMS9004.

/REMOVE-VM-FROM-VM-GROUP is used to remove a VM from a VM group.

The change of assignment is noted in the VM definition.

A VM cannot be removed from a VM group while it is being migrated (VM Migration).

This command is reserved for the VM2000 administrator.

REMOVE-VM-FROM-VM-GROUP

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

,VM-GROUP-NAME = <name 1..8>

,CPU-QUOTA = <fixed 0.01..99.99>

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

VM-GROUP-NAME = <name 1..8>
Name of the VM group.

CPU-QUOTA = <fixed 0.01..99.99>
New CPU quota of the VM.
Determines the VM’s own CPU share in comparison to the VM groups and the other VMs which do not belong to a VM group (see "Planning distribution of the CPU capacity to the VMs"). The VM’s previous member CPU quota of the VM is relinquished.

Command return codes

(SC2)   SC1	Main code	Meaning
0 2             0 2             0 64 64 128	CMD0001 CMD0001 VMS2306 VMS4000 VMS4427 VMS3042	Command successfully executed Decimal specifications rounded to 2 decimal places VM definition could not be updated (SU /390) VM not yet created VM does not belong to VM group VM being migrated

Guaranteed messages

VMS4429

Example

/remove-vm-from-vm-group vm-id=c1sys1,vm-group-name=gcust1,
                         cpu-quota=30 —————————————————————————————————  (1)
VMS4429 VIRTUAL MACHINE (2,C1SYS1) REMOVED FROM VM GROUP 'GCUST1'

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

(1)	The VM C1SYS1 is removed from the VM group. It (again) becomes an autonomous VM with a CPU quota of 30. The member CPU quota is relinquished.

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

See also the detailed "Example of operating VM groups".