DETACH-VM-RESOURCES (Detach real CPUs)

/DETACH-VM-RESOURCES is used to detach attached real normal and extra CPUs for VM2000 operation.

This command is reserved for the VM2000 administrator.

DETACH-VM-RESOURCES

UNIT = *CPU(...) / *EXTRA-CPU(...)
	*CPU(...)
		|	CPU-IDENTIFICATION = *ANY(...) / list-poss(63): <x-text 1..2>
		|		*ANY(...)
		|			|	CPU-POOL-NAME = *UNIQUE / *STDPOOL / <name 1..8>
	*EXTRA-CPU(...)
		|	CPU-IDENTIFICATION = *ALL(...) / *ANY(...) / list-poss(63): <x-text 1..2>
		|		*ALL(...)
		|			|	CPU-POOL-NAME = *UNIQUE / *STDPOOL / <name 1..8> / *ALL
		|		*ANY(...)
		|			|	CPU-POOL-NAME = *UNIQUE / *STDPOOL / <name 1..8>

UNIT = *CPU(...)
Specifies real normal CPUs to be detached.

Detaching a real CPU has no effect on the reconfiguration state (attached/detached) of the virtual CPUs of a VM. Virtual CPUs may be detached in the BS2000 guest system by means of the BS2000 command /DETACH-DEVICE UNIT=*CPU(CPU-IDENTIFIER=<mn>).

The last available real normal CPU cannot be detached.

The last available real CPU of a CPU pool in which VMs are still active cannot be detached.

VM2000 prevents the last attached real CPU in a CPU pool from being detached in the following cases:

	if a VM in RUNNING, IN HOLD (WAIT) or SETUP(MIGR) state is assigned to the CPU pool (message/return code VMS4617)
	if a VM is still assigned to the CPU pool

CPU-IDENTIFICATION = *ANY(...)
Selects any real normal CPU from a CPU pool.

CPU-POOL-NAME =
Determines the CPU pool.

CPU-POOL-NAME = *UNIQUE
A real normal CPU from the CPU pool (*STDPOOL) is selected (operand provided for reasons of compatibility with earlier VM2000 versions).

CPU-POOL-NAME = *STDPOOL / <name 1..8>
Name of the CPU pool.

CPU-IDENTIFICATION = list-poss(63): <x-text 1..2>
Identifier of the normal CPU.

UNIT = *EXTRA-CPU(...)
Specifies the extra CPUs to be detached, see "Increasing capacity with extra CPUs".

CPU-IDENTIFICATION = *ALL(...)
Selects all extra CPUs from a CPU pool.

CPU-POOL-NAME =
Determines the CPU pool.

CPU-POOL-NAME = *UNIQUE
All extra CPUs from the CPU pool (*STDPOOL) are selected (operand provided for reasons of compatibility with earlier VM2000 versions).

CPU-POOL-NAME = *STDPOOL / <name 1..8>
Name of the CPU pool.

CPU-POOL-NAME = *ALL
All extra CPUs from all CPU pools are selected.

CPU-IDENTIFICATION = *ANY(...)
Selects any extra CPU from a CPU pool.

CPU-POOL-NAME =
Determines the CPU pool.

CPU-POOL-NAME = *UNIQUE
One extra CPU from the CPU pool *STDPOOL is selected (operand provided for reasons of compatibility with earlier VM2000 versions).

CPU-POOL-NAME = *STDPOOL / <name 1..8>
Name of the CPU pool.

CPU-IDENTIFICATION = list-poss(63): <x-text 1..2>
Identifier of the extra CPU.

 

Command return codes

(SC2)   SC1	Main code	Meaning
0 1             0 64 64 64 64 64 64 64 64 64 64 64	CMD0001 CMD0001 VMS4043 VMS4048 VMS4078 VMS4079 VMS4151 VMS4270 VMS4600 VMS4609 VMS4611 VMS4617 VMS9005	Command successfully executed No action required CPU not known in system CPU is last available CPU. Reconfiguration not possible CPU not detached due to CPU attribute No adequate CPU attached CPU could not be detached due to its state No extra CPU in the configuration CPU pool not yet created Several CPU pools created Selected CPUs do not belong to CPU pool Last attached CPU of an active CPU pool Command not or only partially processed

Guaranteed messages

VMS4043, VMS4045, VMS4047, VMS4048, VMS4077, VMS4078, VMS4151

Example

/show-vm-resources information=*cpu ———————————————————————————————————  (1)
VM-ID        CPU-POOL  GR-CPU-Q  CPU-Q/ EFF-Q  MAX-U/ EFF-U  PROC
 1 M4IVR     *STDPOOL    20.00    1.00/ 12.04  80.00/ 80.00  2(+1)
 2 G4IVQ     *STDPOOL            26.00/ 15.66 100.00/100.00  4(+1)
 3 G4IVP     *STDPOOL    50.00    4.00/ 24.09 100.00/ 50.00  2(+1)
 4 G4IVO     *STDPOOL    50.00    1.00/  6.02 100.00/ 50.00  1(+1)
 5 G4IVJ     *STDPOOL            70.00/ 42.16 100.00/100.00  2(+1)
VM-ID        SCHED ACT-I  VIRT CPUS
 1 M4IVR      TS    NO    00(RUN),01(RUN),02(OFF)
 2 G4IVQ      TS    NO    00(RUN),01(RUN),02(STOP),03(STOP),
                          04(OFF)
 3 G4IVP      TS    NO    00(RUN),01(RUN),02(OFF)
 4 G4IVO      TS    NO    00(RUN),01(SLEEP)
 5 G4IVJ      -     NO    00(IDLE),01(IDLE),02(OFF)
CPU-ATTR     CPU-POOL     REAL CPUS
NORMAL       *STDPOOL     00(ATT),01(ATT)
EXTRA        *STDPOOL     02(ATT),03(ATT) —————————————————————————————  (2)
/detach-vm-resources unit=*extra-cpu ——————————————————————————————————  (3)
VMS4077 EXTRA-CPU 02 DETACHED
VMS4077 EXTRA-CPU 03 DETACHED
/detach-vm-resources unit=*cpu(cpu-id=01) —————————————————————————————  (4)
VMS4045 CPU 01 DETACHED
/show-vm-resources information=*cpu ———————————————————————————————————  (5)
VM-ID        CPU-POOL  GR-CPU-Q  CPU-Q/ EFF-Q  MAX-U/ EFF-U  PROC
 1 M4IVR     *STDPOOL    20.00    1.00/ 12.04  80.00/ 80.00  2(+1)
 2 G4IVQ     *STDPOOL            26.00/ 15.66 100.00/100.00  4(+1)
 3 G4IVP     *STDPOOL    50.00    4.00/ 24.09 100.00/ 50.00  2(+1)
 4 G4IVO     *STDPOOL    50.00    1.00/  6.02 100.00/ 50.00  1(+1)
 5 G4IVJ     *STDPOOL            70.00/ 42.16 100.00/100.00  2(+1)
VM-ID        SCHED ACT-I  VIRT CPUS
 1 M4IVR      TS    NO    00(RUN),01(RUN),02(OFF)
 2 G4IVQ      TS    NO    00(RUN),01(RUN),02(BLOCK),03(BLOCK),
                          04(OFF)
 3 G4IVP      TS    NO    00(RUN),01(RUN),02(OFF)
 4 G4IVO      TS    NO    00(RUN),01(SLEEP)
 5 G4IVJ      -     NO    00(IDLE),01(IDLE),02(OFF)
CPU-ATTR     CPU-POOL     REAL CPUS
NORMAL       *STDPOOL     00(ATT),01(DET)
EXTRA        *STDPOOL     02(DET),03(DET) —————————————————————————————  (6)
SPARE                     04(DET)

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

(1)	The VM2000 administrator requests information on the CPU state.
(2)	All real normal CPUs and the extra CPU are attached.
(3)	All extra CPUs are detached.
(4)	Real normal CPU 01 is detached.
(5)	The VM2000 administrator requests information on the CPU state.
(6)	Real normal CPU 01 and the extra CPUs are detached.

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

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