CREATE-VM-GROUP (Create VM group)

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

/CREATE-VM-GROUP is used to create a VM group under VM2000.

When a VM group is created, it is assigned the following attributes:

• Name of the VM group

• CPU quota of the VM group

• Maximum CPU utilization of the VM group

• CPU pool, to which the VM group is assigned

VMs can be assigned to a created VM group.

This command is reserved for the VM2000 administrator.

CREATE-VM-GROUP

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

,CPU-QUOTA = *STD / <fixed 0.01..99.99>

,MAX-CPU-UTILIZATION = 100 / <fixed 0.01..100.00>

,CPU-POOL-NAME = *STDPOOL / <name 1..8>

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

CPU-QUOTA = *STD / <fixed 0.01..99.99>
CPU quota of the VM group. Determines the CPU share of the VM group in comparison to other VM groups and VMs which do not belong to any VM group (see "Operating VM groups (SU /390)"). The default value is 1.

MAX-CPU-UTILIZATION = 100 / <fixed 0.01..100.00>
Maximum CPU utilization of the VM group, see "Operating VM groups (SU /390)". This value also restricts the maximum CPU utilization of each VM which is added to the VM group.

CPU-POOL-NAME = *STDPOOL / <name 1..8>

Name of the CPU pool to which the VM group is assigned. Each VM group is always assigned to precisely one CPU pool.

The CPU-QUOTA operand determines the VM groups’s own CPU share in comparison to the other (individual) VMs and VM groups which are assigned to the CPU pool (see "Scheduling procedure").

Command return codes

(SC2)   SC1	Main code	Meaning
0 2             0 64 64 64	CMD0001 CMD0001 VMS4610 VMS4410 VMS4600	Command successfully executed Decimal specifications rounded to 2 decimal places VM group already created Maximum number of VM groups already reached CPU pool not yet created

Guaranteed messages

VMS4401, VMS4625

Example

/create-vm-group vm-group-name=gcust1,cpu-quota=20,
                 max-cpu-utilization=20,cpu-pool-name=*stdpool ————————  (1)
VMS4401 VM GROUP 'GCUST1' CREATED
VMS4625 VM GROUP 'GCUST1' ASSIGNED TO CPU POOL '*STDPOOL'

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

(1)	The VM2000 administrator creates the VM group GCUST1 and assigns it a CPU quota and a maximum CPU utilization of 20. VM group GCUST1 is assigned to the standard CPU pool.

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

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