ADD-VM-TO-VM-GROUP (Add a VM to a VM group)

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

/ADD-VM-TO-VM-GROUP is used to add a VM to a VM group.

The assignment of the VM to a VM group is noted in its VM definition.

A VM cannot be assigned to a VM group while it is being migrated (VM Migration).

The VM may not already have been added to a VM group. The VM must be assigned to the CPU pool of the VM group.

This command is reserved for the VM2000 administrator.

ADD-VM-TO-VM-GROUP

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

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

,MEMBER-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.

MEMBER-CPU-QUOTA = <fixed 0.01..99.99>
Member CPU quota of the VM.
Determines the VM’s own CPU share in comparison to the other VMs in the VM group. The VM’s previous CPU quota is relinquished and replaced by this member CPU quota (see "Operating VM groups (SU /390)").

 

Command return codes

(SC2)   SC1	Main code	Meaning
0 2             0 2             0 64 64 64 64 128	CMD0001 CMD0001 VMS2306 VMS4000 VMS4400 VMS4422 VMS4424 VMS3042	Command successfully executed Decimal specifications rounded to 2 decimal places VM definition could not be updated (SU /390) VM not yet created VM group not yet created VM not assigned to the CPU pool of the VM group VM already belongs to a VM group VM being migrated

Guaranteed messages

VMS4425

Example

/add-vm-to-vm-group vm-id=c1sys1,vm-group-name=gcust1,
                    member-cpu-quota=1—————————————————————————————————  (1)
VMS4425 VIRTUAL MACHINE (2,C1SYS1) ASSIGNED TO VM GROUP 'GCUST1'

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

(1)	The customer VM C1SYS1 is added to the VM group GCUST1. The member CPU quota selected is 1; the CPU quota which the VM was given when it was created is relinquished.

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

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