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

/ASSIGN-VM-TO-CPU-POOL is used to assign a VM which does not belong to a VM group to a (different) CPU pool. The VM is assigned a (new) CPU quota.

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

A VM cannot be assigned to another CPU pool while it is being migrated (VM Migration).

On SU x86, the command is not executed if the CPU pool to which the VM is to be assigned contains no attached CPU.

This command is reserved for the VM2000 administrator.

ASSIGN-VM-TO-CPU-POOL

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

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

CPU-QUOTA = <fixed 0.01..99.99>
CPU quota of the VM. Determines the VM’s own CPU share in comparison to the other VMs or VM groups which are assigned to the CPU pool (TO-CPU-POOL operand).

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

ATTACHED-VM-CPUS = *CHECK-NUMBER
The command is executed if the number of attached virtual CPUs in the VM is less than the number of attached real CPUs in the CPU pool to which the VM is to be assigned, see "Number of attached real and virtual CPUs in the CPU pool". Otherwise the command is rejected.

ATTACHED-VM-CPUS = *ADJUST-NUMBER
The command is executed unless the VM is in state RUNNING or IN HOLD (WAIT) and the CPU pool to which the VM 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 the VM is greater than the number of attached real CPUs in the CPU pool to which the VM 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 the VM is less than the number of attached real CPUs in the CPU pool to which the VM is assigned, and the number of attached virtual CPUs in the VM is 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 2             0 3             0 4             0 64 64 64 64 64 128	CMD0001 CMD0001 VMS2306 CMD0001 CMD0001 VMS4000 VMS4600 VMS4612 VMS4616 VMS4622 VMS3042	Command successfully executed Decimal specifications rounded to 2 decimal places VM definition could not be updated (SU /390) Implicit attach started for virtual CPU(s) Implicit detach started for virtual CPU(s) VM not yet created CPU pool not yet created Too few attached CPUs added to the CPU pool VM already assigned to the CPU pool VM belongs to a VM group VM being migrated

Guaranteed messages

VMS4618, VMS4620, VMS4621

Example

/assign-vm-to-cpu-pool vm-id=c1sys1,to-cpu-pool=pcust1,cpu-quota=80
VMS4618 CPU POOL ASSIGNMENT OF VIRTUAL MACHINE (2,C1SYS1) CHANGED
        FROM CPU POOL '*STDPOOL' TO CPU POOL 'PCUST1'

See also the detailed "Example of managing CPU pools".