ATTACH-VM-RESOURCES (Attach real CPUs)

/ATTACH-VM-RESOURCES is used to attach detached real normal CPUs and extra CPUs for VM2000 operation.

This command is reserved for the VM2000 administrator.

ATTACH-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 attached.

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

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 real normal CPU.

UNIT = *EXTRA-CPU(...)
Specifies extra CPUs to be attached, 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
An extra CPU from the only existing 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	CMD0001 CMD0001 VMS4043 VMS4072 VMS4073 VMS4074 VMS4150 VMS4270 VMS4600 VMS4609 VMS4611 VMS9005	Command successfully executed No action required CPU not known in system CPU defective CPU not attached because of CPU attribute No additional (extra) CPU available CPU could not be attached because of 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 Command not or only partially processed

Guaranteed messages

VMS4043, VMS4044, VMS4046, VMS4072, VMS4073, VMS4075, VMS4150

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(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) —————————————————————————————  (2)
SPARE                     04(DET)
/attach-vm-resources unit=*cpu(cpu-id=01) —————————————————————————————  (3)
VMS4044 CPU 01 ATTACHED
/attach-vm-resources unit=*extra-cpu(cpu-id=*all) —————————————————————  (4)
VMS4075 EXTRA-CPU 02 ATTACHED
VMS4075 EXTRA-CPU 03 ATTACHED
/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(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) —————————————————————————————  (6)
SPARE                     04(DET)

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

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

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

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