Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

SHOW-VM-CPU-POOL (Output attributes of a CPU pool)

&pagelevel(4)&pagelevel

/SHOW-VM-CPU-POOL is used to output the attributes of CPU pools.

The command provides the following information:

  • Name of the CPU pool as defined with /CREATE-VM-CPU-POOL

  • The scheduling procedure

  • The CPUs in the CPU pool and their state

  • The VMs assigned to the CPU pool and their multiprocessor level

  • On SU x86: the static CPU pool *POOL0, see "Implementation on SU x86"

This command is reserved for the VM2000 administrator.


SHOW-VM-CPU-POOL

CPU-POOL-NAME = *ALL / *STDPOOL / <name 1..8> / *BY-CPU-IDENTIFICATION(...) /





*BY-VM-IDENTIFICATION(...) / *BY-VM-GROUP(...)


*BY-CPU-IDENTIFICATION(...)



|

CPU-IDENTIFICATION = <x-text 1..2>


*BY-VM-IDENTIFICATION(...)



|

VM-IDENTIFICATION = <integer 1..99> / <name 1..8>


*BY-VM-GROUP(...)



|

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

,INFORMATION = *CPU / *VM / *SUMMARY / *ALL


CPU-POOL-NAME =
Determines the CPU pool about which information is to be output.

CPU-POOL-NAME = *ALL
Information about all CPU pools is to be output.

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

CPU-POOL-NAME = *BY-CPU-IDENTIFICATION(...)
Determines the CPU pool by specifying a CPU contained in the CPU pool.

CPU-IDENTIFICATION = <x-text 1..2>
CPU identifier.

CPU-POOL-NAME = *BY-VM-IDENTIFICATION(...)
Determines the CPU pool by specifying a VM which is assigned to the CPU pool.

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

CPU-POOL-NAME = *BY-VM-GROUP(...)
Determines the CPU pool by specifying a VM group which is assigned to the CPU pool (SU /390).

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


INFORMATION =
Specifies the output information.

INFORMATION = *CPU
Only information about CPUs contained in the CPU pool.

INFORMATION = *VM
Only information about the virtual machines assigned to the CPU pool.

INFORMATION = *SUMMARY
Summary of the information for *CPU and *VM.

INFORMATION = *ALL
All the information contained in the outputs *CPU and *VM.


Command return codes

(SC2)   SC1

Main code

Meaning

0
64
64
64
64
64

CMD0001
VMS4000
VMS4043
VMS4400
VMS4600
VMS4628

Command successfully executed
VM not yet created
CPU not known in system
VM group not yet created
CPU pool not yet created
Spare CPU belongs to no CPU pool


Output in S variables (in user task)

The INFORMATION operand of the command is used to specify which S variables are to be supplied with values. The following can be specified for INFORMATION:

Notation of command

Abbreviated form used in table

INFORMATION = *CPU
INFORMATION = *VM
INFORMATION = *SUMMARY
INFORMATION = *ALL

1
2
3
4

   

Output information        

Name of S variable

T

Contents

Cond.

Name of the CPU pool

var(*LIST).CPU-POOL

S

*STDPOOL
*POOL0
<name 1..8>

1,2,3,4

Scheduling procedure

var(*LIST).SCHEDULE

S

*NONE
*BY-TIMESLICE
*DEDICATED-CPUS

1,2,3,4

Number of assigned
real normal CPUs

var(*LIST).NUM-OF-NORMAL-CPUS.ALL

I

<integer 0..64>

1,3,4

Number of assigned
real extra CPUs

var(*LIST).NUM-OF-EXTRA-CPUS.ALL

I

<integer 0..63>

1,3,4

Real CPUs in the CPU pool

var(*LIST).REAL-CPU(*LIST).ID

S

<x-text 2..2>

1,4

State of real CPUs
in the CPU pool

var(*LIST).REAL-CPU(*LIST).STA

S

*ATT / *DET /
*ERR / *OFFLINE /
*WAIT-FOR-MAINT

1,4

Type of real CPUs
in the CPU pool

var(*LIST).REAL-CPU(*LIST).ATTR

S

*NORMAL
*EXTRA
*FOREIGN

1,4

Number of assigned
real foreign CPUs

var(*LIST).NUM-OF-FOREIGN-CPUS.ALL

I

<integer 0..63>

1,4

Number of VMs assigned
to the CPU pool

var(*LIST).NUM-OF-VMS

I

<integer 0..99>

2,3,4

Index of the VM which is
assigned to the CPU pool

var(*LIST).VM(*LIST).VM-INDEX

I

<integer 1..99>

2,4

Name of the VM which is
assigned to the CPU pool

var(*LIST).VM(*LIST).VM-NAME

S

<name 1..8>

2,4

Name of the VM group which
is assigned to the CPU pool

var(*LIST).VM(*LIST).VM-GROUP

S

*NONE
<name 1..8>

2,4

Number of attached virtual
CPUs of the VM which is
assigned to the CPU pool

var(*LIST).VM(*LIST).NUM-OF-ATT-CPUS

I

<integer 0..32>

2,4

Multiprocessor level of
the VM which is assigned
to the CPU pool

var(*LIST).VM(*LIST).NUM-OF-CPUS

I

<integer 1..32>

2,4

Number of spare CPUs of
the VM which is assigned
to the CPU pool

var(*LIST).VM(*LIST).
NUM-OF-SPARE-CPUS

I

<integer 0..15>

2,4

Number of assigned real
normal CPUs (attached)

var(*LIST).NUM-OF-NORMAL-CPUS.ATT

I

<integer 0..64>

3

Number of assigned real
normal CPUs (detached)

var(*LIST).NUM-OF-NORMAL-CPUS.DET

I

<integer 0..63>

3

Number of assigned real
normal CPUs (offline)

var(*LIST).
NUM-OF-NORMAL-CPUS.OFFLINE

I

<integer 0..63>

3

Number of assigned real
extra CPUs (attached)

var(*LIST).NUM-OF-EXTRA-CPUS.ATT

I

<integer 0..63>

3

Number of assigned real
extra CPUs (detached)

var(*LIST).NUM-OF-EXTRA-CPUS.DET

I

<integer 0..63>

3

Number of assigned real
extra CPUs (offline)

var(*LIST).
NUM-OF-EXTRA-CPUS.OFFLINE

I

<integer 0..63>

3

Total number of active
virtual CPUs of the VMs
assigned to the CPU pool

var(*LIST).NUM-OF-RUN-VIRT-CPUS

I

<integer 0..3168>

3

 

Output format for INFORMATION = *CPU

Example
CPU-POOL SCHED CPU-ATTR REAL CPUS 
*STDPOOL   DC  NORMAL   00(ATT),01(ATT)
               EXTRA    04(DET)
PCUST1     TS  NORMAL   02(ATT),03(ATT)
               EXTRA    NONE
Meaning of the output columns

CPU-POOL

Identifies the CPU pool by means of its name.

*STDPOOLStandard CPU pool
*POOL0CPU pool of domain 0 (SU x86)

SCHED

Scheduling procedure

-There are no virtual CPUs in the scheduling procedure
DCFixed CPU assignment (dedicated CPUs)
TSTime slicing

CPU-ATTR

Type of CPU  (NORMAL / EXTRA / FOREIGN).

REAL CPUS

CPU identification and state in the format <cpu-id>(<rstate>),....

<cpu-id>CPU identifier.
<rstate>State of the real CPU, see "Real CPUs"
(ATT / DET / WFM / ERR / OFF).
NONENo CPU of this type belongs to the CPU pool.

 


Output format for INFORMATION = *VM

Example
CPU-POOL SCHED VM-ID       VM-GROUP ATT PROC
PCUST1     TS   2 C1SYS1              2  4(+1)
                3 C1SYS2              2  2(+1)
Meaning of the output columns

CPU-POOL
SCHED

Corresponds to INFORMATION=*CPU.

VM-ID

Identifies a VM which is assigned to the CPU pool by means of VM index and VM name.
NONE   No VM has been assigned to the CPU pool.

VM-GROUP

Name of the VM group if the VM is assigned to a VM group.

ATT

Number of attached virtual CPUs of the VM which is assigned to the CPU pool.

PROC

Virtual CPUs of the VM which is assigned to the CPU pool in the form m or m(+n).

mNumber of virtual normal CPUs of the VM (multiprocessor level of the VM).

n

Number of virtual spare CPUs of the VM.

 

Output format for INFORMATION = *SUMMARY

Example
CPU-POOL SCHED REAL-NORMAL-CPUS REAL-EXTRA-CPUS VIRT-CPUS
               ALL ATT DET OFF  ALL ATT DET OFF    RUN
PCUST1     TS    2   2   0   0    0   0   0   0      4
Meaning of the output columns

CPU-POOL
SCHED

Corresponds to INFORMATION=*CPU.

REAL-NORMAL-CPUS
ALL ATT DET OFF

Number of all / attached / detached / offline real normal CPUs of the CPU pool.

REAL-EXTRA-CPUS
ALL ATT DET OFF

Number of all / attached / detached / offline real extra CPUs of the CPU pool.

VIRT-CPUS
RUN

Total number of active virtual CPUs in the CPU pool.


Example

/show-vm-cpu-pool cpu-pool-name=pcust1,information=*all
CPU-POOL SCHED CPU-ATTR REAL CPUS
PCUST1     TS  NORMAL   02(ATT),03(ATT)
               EXTRA    NONE
CPU-POOL SCHED VM-ID       VM-GROUP ATT PROC
PCUST1     TS   2 C1SYS1              2  4(+1)
                3 C1SYS2              2  2(+1)

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

Powered by Atlassian Confluence and Scroll Viewport.