ASSIGN-VM-GROUP-TO-CPU-POOL (Assign a VM group to a CPU pool)

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

/ASSIGN-VM-GROUP-TO-CPU-POOL is used to assign a VM group to a (different) CPU pool. The VM group is assigned a (new) CPU quota. Together with the VM group, the VMs which are assigned to the VM group are also assigned to the (different) CPU pool.

A VM group cannot be assigned to another CPU pool while a VM in the group is being migrated (VM Migration).

This command is reserved for the VM2000 administrator.

ASSIGN-VM-GROUP-TO-CPU-POOL

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

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

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

,ATTACHED-VM-CPUS = *CHECK-NUMBER / *ADJUST-NUMBER

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

TO-CPU-POOL = *STDPOOL / <name 1..8>
Name of the CPU pool to which the VM group is to be assigned.

CPU-QUOTA = <fixed 0.01..99.99>
CPU quota of the VM group. Determines the VM group’s own CPU share in comparison to the other (individual) VMs and VM groups which are assigned to the CPU pool (TO-CPU-POOL operand) (see "Planning distribution of the CPU capacity to the VMs").

ATTACHED-VM-CPUS =
Determines command execution and the implicit actions of VM2000 for the virtual CPUs of all VMs of the VM group.

ATTACHED-VM-CPUS = *CHECK-NUMBER
The command is executed when the number of attached virtual CPUs of every VM in the VM group is less than or equal to the number of attached real CPUs in the CPU pool to which the VM group is to be assigned, see "Number of attached real and virtual CPUs in the CPU pool". If a VM in the VM group does not fulfill this condition, the command is rejected.

ATTACHED-VM-CPUS = *ADJUST-NUMBER
The command is executed unless a VM in the VM group is in state RUNNING or IN HOLD (WAIT) and the CPU pool to which the VM group is to be assigned contains no attached real CPU.

With this operand value, VM2000 initiates asynchronous actions in the following cases:

• The number of attached virtual CPUs in a VM in the VM group is greater than the number of attached real CPUs in the CPU pool to which the VM group is assigned:

  VM2000 detaches the excess virtual CPUs (implicit /DETACH-DEVICE in the BS2000 guest system for a corresponding number of virtual CPUs). These detached CPUs cannot initially be attached again by the guest system; they are marked accordingly by VM2000 (state of the virtual CPU in the VM2000 information commands: BLOCK).

• The number of attached virtual CPUs in a VM in the VM group is less than the number of attached real CPUs in the CPU pool to which the VM group is assigned and the number of attached virtual CPUs in this VM in the VM group is less than its multiprocessor level:

  VM2000 cancels state BLOCK for the required number of virtual CPUs of the VM and attaches them (implicit /ATTACH-DEVICE in the BS2000 guest system for the virtual CPU).

Command return codes

(SC2)   SC1	Main code	Meaning
0 2             0 5             0 64 64 64 64 128	CMD0001 CMD0001 CMD0001 VMS4400 VMS4600 VMS4612 VMS4626 VMS3042	Command successfully executed Decimal specifications rounded to 2 decimal places Implicit reconfiguration started for virtual CPU(s) VM group not yet created CPU pool not yet created Too few attached CPUs added to the CPU pool VM group is already assigned to the CPU pool VM of the VM group is being migrated

Guaranteed messages

VMS4620, VMS4621, VMS4627

Example

/assign-vm-group-to-cpu-pool vm-group-name=extgroup,to-cpu-pool=exclpool,
                 cpu-quota=1,attached-vm-cpus=*check-number
VMS4627 CPU POOL ASSIGNMENT OF VM GROUP 'EXTGROUP' CHANGED FROM
        CPU POOL '*STDPOOL' TO CPU POOL 'EXCLPOOL'