/SHOW-VM-STATUS is used to output the current planned values and the current monitored data for active objects once only or periodically in ongoing VM2000 operation.
Active objects comprise attached normal and extra CPUs, active VMs, CPU pools with attached real CPUs, and VM groups with active VMs (see "Planning distribution of the CPU capacity to the VMs").
The monitored data is output once only or periodically:
The one-off output of monitored data (
PERIOD=*RECENT(...)) takes place synchronously to command execution and shows the monitored data from the immediate past. For this purpose the VM2000 monitor collects the current monitored data periodically (every 20 seconds). This data is kept for up to one hour. The one-off output can be called by multiple VM2000 administrators simultaneously, also in parallel to the periodic output of monitored data. Monitored data is output only for VMs, VM groups and CPU pools which existed at the time the command was entered.The periodic output of monitored data (
PERIOD=<integer>) takes place asynchronously wherever the corresponding/SHOW-VM-STATUScommand was entered. The periodic output cannot be used by more than one VM2000 administrator simultaneously.The periodic output is terminated by entering a new
/SHOW-VM-STATUS PERIOD=*NOcommand from the same input medium (ADMIN dialog of the monitor VM or BS2000 console) or by terminating the associated ADMIN dialog or BS2000 console.The periodic output is also aborted by deleting a CPU pool or a VM group or by terminating a VM if the command was entered explicitly for this CPU pool (by means of
VM-IDorCPU-ID), this VM group or this VM.When one VM or multiple VMs are selected (by specifying wildcards), the periodic output is terminated if the specified VM is terminated or if no VM from the selected set exists.
The command outputs information in relation to the attached real CPUs and the active VMs and the created VM groups and CPU pools:
Current planned values for distributing the CPU capacity of and the CPU time used by the virtual machines. Effective planned values under ideal conditions for active and inactive objects are displayed using
/SHOW-VM-ATTRIBUTES/-RESOURCES(see "Planning distribution of the CPU capacity to the VMs").
On SU /390, the following information is also supplied:
CPU time used and the IDLE time of the VM2000 hypervisor
Number of events handled via the VM2000 hypervisor
Values for scheduling by VM2000
This command is reserved for the VM2000 administrator.
SHOW-VM-STATUS | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
INFORMATION =
Specifies the output information.
INFORMATION = *STD
The default value is used (*TIMER).
INFORMATION = *TIMER
The CPU time utilized or the IDLE time and the current planned values are output.
INFORMATION = *COUNTER
The number of events is output (SU /390).
INFORMATION = *SCHEDULE
The values for scheduling are output (SU /390).
INFORMATION = *ALL
All information for the outputs *TIMER, *COUNTER and *SCHEDULE.
PERIOD =
Defines the intervals at which output is to occur.
PERIOD = *NO
Terminates periodical collection of monitored data and the current output of /SHOW-VM-STATUS PERIOD=<seconds>. Other operands are not relevant in this case.
PERIOD = *RECENT(...)
Triggers one-off output of the monitored data from the immediate past.
SECONDS = <integer 1..3600> seconds
Period (in seconds) for which the monitored data is output.
PERIOD = <integer 5..3600> seconds
Starts periodic collection of monitored data and defines the period (in seconds) during which the monitored data is gathered and then output.
VM-IDENTIFICATION =
Identification of the virtual machine.
VM-IDENTIFICATION = *ALL
Information on all active virtual machines is output.
VM-IDENTIFICATION = *NONE
No information on the active virtual machines is output (SU /390).
VM-IDENTIFICATION = <integer 1..99> / <name 1..8 with-wild(20)>
Identifies the virtual machine by means of a VM index or VM name.
VM-IDENTIFICATION = *BY-VM-GROUP(...)
Information is output for all active VMs which belong to the VM group (SU /390).
VM-GROUP-NAME = <name 1..8>
Name of the VM group.
VM-IDENTIFICATION = *BY-CPU-POOL(...)
Information is output for all active VMs which belong to the CPU pool.
CPU-POOL-NAME = *STDPOOL / <name 1..8>
Name of the CPU pool.
CPU-IDENTIFICATION =
Selects the real CPUs.
CPU-IDENTIFICATION = *STD
 | When VM-IDENTIFICATION=*ALL/*NONE, information is output on all attached real CPUs. Otherwise no information on real CPUs is output (operand value provided for reasons of compatibility with earlier VM2000 versions). |
 | No information on real CPUs is output. |
CPU-IDENTIFICATION = *ALL
Information on all attached real CPUs is output (SU /390).
CPU-IDENTIFICATION = *NONE
No information on real CPUs is output.
CPU-IDENTIFICATION = list-poss(64):<x-text 1..2>
Information on the specified real CPUs is output (SU /390).
CPU-IDENTIFICATION = *BY-CPU-POOL(...)
Information on the attached real CPUs in a CPU pool is output (SU /390).
CPU-POOL-NAME =
Selects the CPU pool.
CPU-POOL-NAME = *BY-VM-IDENTIFICATION
The CPU pools to which the VMs are assigned (VM-IDENTIFICATION operand) are selected.
CPU-POOL-NAME = *STDPOOL / <name 1..8>
Name of the CPU pool.
Command return codes
(SC2) | Main code | Meaning |
0 | CMD0001 | Command successfully executed |
Output format for INFORMATION = *STD / *TIMER
The output consists of two information blocks:
CPU TIMER INFORMATION FOR REAL CPU(S)(SU /390)
The CPU-specific information block provides information on time values (actual values for CPU time utilization) of the CPU pools and their attached real CPUs.
The information lines are grouped according to CPU pools, and in these according to the CPU-IDs.CPU TIMER INFORMATION FOR VM(S)
The VM-specific information block provides information on current planned values and time values (actual values for CPU time utilization) of the CPU pools, the VM groups (SU /390), the running VMs and their active virtual CPUs (SU /390).
The information lines are grouped according to CPU pools, and in these according to (single) VMs and VM groups. The virtual CPUs of a VM are sorted according to the CPU-IDs.
Any changes during the monitoring period are marked on the left of the corresponding value lines with '*' or '#' to indicate monitored data that has possibly been corrupted.
'
*' indicates changes which can result in falsified monitored data forACTIVEorIDLEtimes. These were triggered by:attaching or detaching a real CPU in a CPU pool
assigning or removing a real CPU to or from a CPU pool
- assigning or removing a (single) VM or a VM group to or from a CPU pool
and on SU /390 by:
change of state of a virtual CPU from or to
RUNNINGstateassigning or removing a VM to or from a VM group
assigning or removing a VM group to or from a CPU pool
'
#' indicates explicit or implicit changes of the current CPU share (CUR-Q) or of the maximum CPU utilization (CUR-U).ACTIVEtimes then no longer need match the planned values.
When '*' and '#' apply for a line, '*' is output.
If the command was specified explicitly for a CPU pool, a VM group, a VM or a real CPU but no real or virtual CPUs are active or assigned, a corresponding message (NO CPU ACTIVE) is output in the information line.
CPU TIMER INFORMATION FOR REAL CPU(S)
CPU-POOL REAL HPV-ACTIVE HPV-IDLE ALL-VMS-ACTIVE
CPU TIME/ % TIME/ % TIME/ %
*STDPOOL 0.091/ 0.07 124.929/99.66 0.338/ 0.27
00 0.087/ 0.14 62.266/99.34 0.326/ 0.52
01 0.004/ 0.01 62.663/99.97 0.012/ 0.02
EXCLPOOL 0.066/ 0.05 0.000/ 0.00 125.292/99.95
02 0.033/ 0.05 0.000/ 0.00 62.646/99.95
03 0.033/ 0.05 0.000/ 0.00 62.646/99.95
Meaning of the output columns
CPU-POOL
Name of the CPU pool.*STDPOOL Outputs for the standard CPU pool.
REAL CPU
Real CPU identifier (CPU-ID).
HPV-ACTIVE TIME / %
CPU time utilized by the VM2000 hypervisor for the CPU pool or for the real CPU in the form of an absolute value (in seconds) and a percentage value of the CPU capacity of the CPU pool or of the real CPU.
HPV-IDLE TIME / %
IDLE time of the VM2000 hypervisor for the CPU pool or for the real CPU in the form of an absolute value (in seconds) and a percentage value of the CPU capacity of the CPU pool or of the real CPU.
ALL-VMS-ACTIVE TIME / %
CPU time utilized by all VMs for the CPU pool or for the real CPU in the form of an absolute value (in seconds) and a percentage value of the CPU capacity of the CPU pool or of the real CPU.
CPU TIMER INFORMATION FOR VM(S)
CPU-POOL
VM-GROUP VIRT CPU-Q CUR-Q CUR-U VM - ACTIVE
VM-ID CPU TIME/ %
*STDPOOL(P) 50.00 50.00 0.331/ 0.13
1 MONITOR 20.00 25.00 25.00 0.319/ 0.13
00 0.319/ 0.12
EXTGROUP(G) 80.00 25.00 25.00 0.012/ 0.00
2 SYSTEM2 70.00 25.00 25.00 0.012/ 0.00
00 0.012/ 0.00
EXCLPOOL(P) 50.00 50.00 125.351/ 49.99
4 SYSTEM4 1.00 50.00 50.00 125.351/ 50.00
00 62.676/ 24.99
01 62.675/ 24.99
Meaning of the output columns
CPU-POOL
Identifies a CPU pool by its name (suffix: (P)).
VM-GROUP
VM-ID
Identifies a VM group (suffix: (G)) by its name or a VM by the VM index and VM name.
VIRT CPU
Identifier of the VM’s virtual CPU (CPU-ID).
CPU-Q
CPU quota of the VM or VM group or member CPU quota of the VM in the VM group, set by means of command.
CUR-Q
Calculated current CPU share of the VM, VM group or CPU pool (current anticipated CPU utilization if all VMs were CPU-intensive).
For a CPU pool: Identical to CUR-U.
For a VM group: Relative to the Server Unit’s current CPU capacity.
For a VM: Relative to the Server Unit’s current CPU capacity. Identical to the planned value in the VM2000 report of openSM2.
CUR-U
Calculated current maximum CPU utilization of the VM, VM group or CPU pool.
For a CPU pool according to the formula: Number of attached CPUs in the CPU pool / number of attached Server Unit CPUs (in percent).
For a VM group: Current maximum CPU utilization of the VM group.
For a VM:Current maximum CPU utilization of the VM. Identical to the UTIL value in the VM2000 report of openSM2.
VM-ACTIVE TIME / %
CPU time utilized as an absolute value (in seconds) and as a percentage value (actual values).
For a CPU pool: Total CPU times of all VMs in the CPU pool. Percentage value relative to the current Server Unit CPU capacity.
For a VM group: Total CPU times of all VMs in the VM group. Percentage value relative to the current Server Unit CPU capacity.
For a VM: Total CPU times of all the VM’s active virtual CPUs. Percentage value relative to the current Server Unit CPU capacity.
For a virtual CPU: CPU time of the virtual CPU. Percentage value relative to the current Server Unit CPU capacity.
CPU TIMER INFORMATION FOR VM(S) CPU-POOL NUM OF CPU-Q CUR-Q CUR-U VM - ACTIVE VM-ID CPUS TIME/ % *POOL0 6 47.245/ 12.12 *STDPOOL 8 100.00 100.00 7.900/ 1.52 1 MONITOR 2 25.00 25.00 25.00 1.487/ 0.28 2 ABGAFR02 8 5.00 6.81 100.00 2.182/ 0.41 3 ABGAFR03 4 10.00 13.63 50.00 1.732/ 0.33 5 ABGAFR05 8 40.00 54.54 100.00 2.455/ 0.47
Meaning of the output columns
CPU-POOL
Identifies a CPU pool by means of its name.
The pool of domain 0 is named*POOL0.
VM-ID
Identifies a VM by means of VM index and VM name.
NUM OF CPUS
Number of real CPUs currently available in this CPU pool or number of active virtual CPUs of the VM.
CPU-Q
CPU quota of the VM, set by means of a command.
CUR-Q
Calculated current CPU share of the VM or of the CPU pool (current expected CPU utilization if all VMs were CPU-intensive ).
For a CPU pool (with the exception of *POOL0): identical to CUR-U.
For a VM: Relative to the Server Unit’s current CPU capacity Identical to the PLAN value of the VM2000 report of openSM2.
CUR-U
Calculated current maximum CPU utilization of the VM or of the CPU pool.
For a CPU pool (with the exception of *POOL0) according to the formula: Number of attached CPUs in the CPU pool / Number of attached CPUs of the Server Unit (in percent).
For a VM: Current maximum CPU utilization of the VM. Identical to the UTIL value in the VM2000 report of openSM2.
VM-ACTIVE TIME / %
CPU time utilized as an absolute value (in seconds) and as a percentage value (actual values).
For a CPU pool: Total CPU times of all VMs in the CPU pool. Percentage value relative to the current Server Unit CPU capacity.
For a VM: CPU time of the VM (measured by Xen). Percentage value relative to the current Server Unit CPU capacity.
Output format for INFORMATION = *COUNTER (SU /390)
The output consists of two information blocks:
CPU COUNTER INFORMATION FOR REAL CPU(S)
The CPU-specific information block provides information on counter values of the attached real CPUs.
The information lines are grouped according to CPU pools, and in these according to the CPU-IDs.CPU COUNTER INFORMATION FOR VM(S)
The VM-specific information block provides information on counter values of the active virtual CPUs of the running VMs.
The information lines are grouped according to CPU pools, and in these according to VMs. The virtual CPUs of a VM are arranged according to the CPU-IDs.
Any changes during the monitoring period are marked in the appropriate place with '*' to indicate monitored data that has possibly been corrupted, see the corresponding paragraph in "Output format for INFORMATION = *STD".
CPU COUNTER INFORMATION FOR REAL CPU(S)
CPU-POOL REAL I-O INT. INTERCEPT. EMULATION SCHEDULE
CPU COUNT/ % COUNT/ % COUNT/ % COUNT/ %
*STDPOOL 00 429/100 1325/ 50 4/100 1325/ 50
01 0/ 0 63/ 2 0/ 0 63/ 2
EXCLPOOL 02 0/ 0 633/ 24 0/ 0 633/ 24
03 0/ 0 633/ 24 0/ 0 633/ 24
Meaning of the output columns
Percentage values in the CPU-specific information block relate to the total of the values for all attached real CPUs of the Server Unit.
CPU-POOL
Name of the CPU pool to which the real CPU belongs.*STDPOOL The CPU belongs to the standard CPU pool.
REAL CPU
Real CPU identifier (CPU-ID).
I-O INT. COUNT / %
Number/percentage of I/O interrupts handled for a VM via the VM2000 hypervisor.
INTERCEPT. COUNT / %
Number/percentage of interrupt events which were not caused by a command emulation and which lead to a switch from VM mode to VM2000 hypervisor mode.
EMULATION COUNT / %
Number/percentage of command emulations handled for a VM via the VM2000 hypervisor.
SCHEDULE COUNT / %
Number/percentage of time slice allocations to a VM.
CPU COUNTER INFORMATION FOR VM(S)
CPU-POOL VIRT I-O INT. INTERCEPT. EMULATION SCHEDULE
VM-ID CPU COUNT/ % COUNT/ % COUNT/ % COUNT/ %
*STDPOOL
1 MONITOR 00 429/100 1325/ 50 4/100 1325/ 50
2 SYSTEM2 00 0/ 0 63/ 2 0/ 0 63/ 2
EXCLPOOL
4 SYSTEM4 00 0/ 0 633/ 24 0/ 0 633/ 24
01 0/ 0 633/ 24 0/ 0 633/ 24
Meaning of the output columns
Percentage values in the VM-specific information block relate to the total of the values for all active virtual CPUs of all VMs.
CPU-POOLVM-ID
Identifies a CPU pool by means of its name or a VM by means of the VM index and VM name.
VIRT CPU
Virtual CPU identifier (CPU-ID).NO CPU ACTIVE No virtual CPU of the VM has run in this time period.
I-O INT. COUNT / %
Number/percentage of I/O operations handled for the virtual CPU via the VM2000 hypervisor.
INTERCEPT. COUNT / %
Number/percentage of interrupt events which were not caused by a command emulation and which lead to a switch from VM mode to VM2000 hypervisor mode for the virtual CPU.
EMULATION COUNT / %
Number/percentage of command emulations handled for the virtual CPU via the VM2000 hypervisor.
SCHEDULE COUNT / %
Number/percentage of time slice allocations to the virtual CPU.
Output format for INFORMATION = *SCHEDULE (SU /390)
The output consists of two information blocks:
CPU SCHEDULE INFORMATION FOR REAL CPU(S)
The CPU-specific information block provides information on scheduling values of the attached real CPUs.
The information lines are grouped according to CPU pools, and in these according to the CPU-IDs.CPU SCHEDULE INFORMATION FOR VM(S)
The VM-specific information block provides information on scheduling values of the active virtual CPUs of the running VMs.
The information lines are grouped according to CPU pools, and in these according to VMs. The virtual CPUs of a VM are arranged according to the CPU-IDs.
Any changes during the monitoring period are marked in the appropriate place with '*' to indicate monitored data that has possibly been corrupted, see the corresponding paragraph in "Output format for INFORMATION = *STD".
SCHEDULE INFORMATION FOR REAL CPU(S)
CPU-POOL REAL <-- TIME SLICE --> NON-AFFIN SCHED
CPU AVG %RUNOUT %SHORT %IDLE %LOAD
*STDPOOL 00 0.24 1 62 DEDICATED SCHED
01 0.19 0 0 DEDICATED SCHED
EXCLPOOL 02 VM-ACTIVE-IDLE DEDICATED SCHED
03 VM-ACTIVE-IDLE DEDICATED SCHED
Meaning of the output columns
Percentage values in the CPU-specific information block relate to the total of the values for all scheduling procedures of the real CPUs.
CPU-POOL
Name of the CPU pool to which the real CPU belongs.*STDPOOL The CPU belongs to the standard CPU pool.
REAL CPU
Real CPU identifier (CPU-ID).
TIME SLICE AVG
Average value of the time slices (in milliseconds) of the virtual CPUs on the real CPU.
TIME SLICE %RUNOUT
Percentage value of the completely used time slices of the virtual CPUs.
TIME SLICE %SHORT
Percentage value of the little-used time slices of the virtual CPUs (value less than 0.1 milliseconds or less than a tenth of the time slice).
VM-ACTIVE-IDLE is output in the <-- TIME SLICE --> column if this parameter is effective for the VM.NON-AFFIN SCHED %IDLE
Percentage value of the non-CPU-affined scheduling operations on the real CPU for avoiding an IDLE state of the real CPU despite executable (non-affined) virtual CPUs.
NON-AFFIN SCHED %LOAD
Percentage value of the non-CPU-affined scheduling operations on the real CPU for an orderly distribution of the CPU capacity.
DEDICATED SCHED is output in the NON-AFFIN SCHED column.
SCHEDULE INFORMATION FOR VM(S)
CPU-POOL VIRT <-- TIME SLICE --> NON-AFFIN SCHED %WAIT
VM-ID CPU DEF AVG %RUNOUT %SHORT %IDLE %LOAD TIME
*STDPOOL
1 MONITOR 00 8.00 0.24 1 62 DEDICATED SCHED --
2 SYSTEM2 00 8.00 0.19 0 0 DEDICATED SCHED --
EXCLPOOL
4 SYSTEM4 00 99.00 VM-ACTIVE-IDLE DEDICATED SCHED --
01 VM-ACTIVE-IDLE DEDICATED SCHED --
Meaning of the output columns
Percentage values in the VM-specific information block relate to the total of the values for all scheduling operations for a virtual CPU.
CPU-POOLVM-ID
Identifies a CPU pool by means of its name or a VM by means of the VM index and VM name.
VIRT CPU
Virtual CPU identifier (CPU-ID).
TIME SLICE DEF
Current length of the time slice provided (see "CPU assignment in time slicing (SU /390)").
TIME SLICE AVG
Average value of the time slices (in milliseconds) of the virtual CPU on a real CPU.
TIME SLICE %RUNOUT
Percentage value of the completely used time slices on the virtual CPU.
TIME SLICE %SHORT
Percentage value of the little-used time slices of the virtual CPU (value less than 0.1 milliseconds or less than a tenth of the time slice).
VM-ACTIVE-IDLE is output in the <-- TIME SLICE --> column if this parameter is effective for the VM.NON-AFFIN SCHED %IDLE
Percentage value of the non-CPU-affined scheduling operations for the virtual CPU for avoiding unnecessary IDLE states of real CPUs.
NON-AFFIN SCHED %LOAD
Percentage value of the non-CPU-affined scheduling operations for the virtual CPU for an orderly distribution of the CPU capacity.
DEDICATED SCHED is output in the NON-AFFIN SCHED column.%WAIT TIME
Wait time of the operable virtual CPU because no real CPU could be assigned (as a percentage of the length of the monitoring interval). Measurement for “delaying the VM”.
Example
One-off information output
See the detailed "Example of CPU management".
Periodic information output on a BS2000 console
/show-vm-status information=*all,period=60 ———————————————————————————— (1)VMS3016 PERIODIC OUTPUT OF MONITORING DATA STARTED
VMS3000 VM2000 COMMAND /SHOW-VM-STATUS FOR VIRTUAL MACHINE ( ,*ALL) PROCESSED SUCCESSFULLY
NBR0740 COMMAND COMPLETED 'SHOW-VM-STATUS'; (RESULT: SC2=000, SC1=000, MC=CMD0001); DATE: <date>
.../SHOW-VM-STATUS DATA OUTPUT: (PERIOD= 60.003 SEC) —————————————————— (2)CPU TIMER INFORMATION FOR REAL CPU(S)
CPU-POOL REAL HPV-ACTIVE HPV-IDLE ALL-VMS-ACTIVE CPU TIME/ % TIME/ % TIME/ % *STDPOOL 3.401/ 2.83 107.121/89.26 9.484/ 7.90... (output abbreviated)... ——————————————————————————————————————————————————————————————————— (3)/show-vm-status period=*no ———————————————————————————————————————————— (4)
/SHOW-VM-STATUS DATA OUTPUT: (PERIOD= 48.944 SEC)CPU TIMER INFORMATION FOR REAL CPU(S) CPU-POOL REAL HPV-ACTIVE HPV-IDLE ALL-VMS-ACTIVE CPU TIME/ % TIME/ % TIME/ % *STDPOOL 3.748/ 3.83 76.524/78.18 17.616/18.00... (output abbreviated)VMS3029 PERIODIC OUTPUT OF MONITORING DATA TERMINATEDVMS3000 VM2000 COMMAND /SHOW-VM-STATUS FOR VIRTUAL MACHINE ( ,*ALL) PROCESSED SUCCESSFULLY
NBR0740 COMMAND COMPLETED 'SHOW-VM-STATUS'; (RESULT: SC2=000, SC1=000, MC=CMD0001); DATE: <date>
-----------------------------------------------------------------------------------------------------------------
(1) | The VM2000 administrator starts data collection for all VMs with a time period of 60 seconds. |
(2) | The first measured values are output after approx. 60 seconds. |
(3) | Further periodic outputs of monitored data follow. |
(4) | Data collection is terminated. The remaining measured values are output. |
-----------------------------------------------------------------------------------------------------------------
/REMARK command) is made.