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-RESOURCES (Output status of VM2000 resources)

&pagelevel(4)&pagelevel

The status of VM2000 resources is output using /SHOW-VM-RESOURCES.

The command provides the following information:

  • The attributes of all VMs

  • The state of all initialized VMs

  • The version of the BS2000 operating system in the guest system

  • Whether a VM administrator is connected to the VM

  • The privileges of the VMs

  • The number of non-initialized VMs and the greatest possible main memory size that can be assigned when a VM is set up

  • The VM group to which the VM belongs (SU /390)

  • The CPU pool to which the VM is assigned

  • The scheduling procedure for the VM

  • The settings of the VM for control via the real CPU (SU /390)

  • The status of the virtual CPUs of all VMs and of the real CPUs

  • The assignment of the devices to the VMs and the free devices (those not assigned to a VM); selection is possible on the basis of device types and properties

  • The main memory distribution over the VMs and the free main memory

  • The monitoring job variables assigned to the VMs

  • The overview of the Server Unit configuration

  • The assignment of the Channel Subsystem Monitoring Facility (SU /390, see "Measurement with the openSM2 measurement monitor")

This command is reserved for the VM2000 administrator and VM administrators with ADMIN-PRIVILEGES=*MAXIMUM.

 

SHOW-VM-RESOURCES

INFORMATION =

*STD / *CPU / *UNITS / *MEMORY / *MONJV / *PRIVILEGES /





*CONFIGURATION / *ALL

,UNITS = *ALL / list-poss(28): *DEVICE-RANGE(...) / <alphanum-name 1..4 with-wild(20)>


*DEVICE-RANGE(...)



|

FROM = <alphanum-name 2..2> / <x-text 4..4>



|

,TO = <alphanum-name 2..2> / <x-text 4..4>

,TYPE = *ANY / *SD / *VC / <family> / <device>

,ATTRIBUTES = *ALL / *ASSIGNED / *FREE

,VM-IDENTIFICATION = *VM2000 / <integer 1..99> / <name 1..8 with-wild(20)> /






*BY-VM-GROUP(...) / *BY-CPU-POOL(...)


*BY-VM-GROUP(...)



|

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


*BY-CPU-POOL(...)



|

CPU-POOL-NAME = *STDPOOL / <name 1..8>


INFORMATION =
Specifies the output information.

INFORMATION = *STD
Only the attributes and state of the VM.

INFORMATION = *CPU
Only information on the CPU state.

INFORMATION = *UNITS
Only the devices are specified.

INFORMATION = *MEMORY
Only the distribution of main memory.

INFORMATION = *MONJV
Only information on the monitor job variables.

INFORMATION = *PRIVILEGES
Only information on the privileges of the VM.

INFORMATION = *CONFIGURATION
Only the overview of the Server Unit configuration.

INFORMATION = *ALL
All the information contained in the outputs *STD, *CPU, *UNITS, *MEMORY, *MONJV and *PRIVILEGES, but not in *CONFIGURATION.


UNITS =
Specifies the devices whose assignment is to be output. This operand is only evaluated when INFORMATION=*UNITS/*ALL is specified at the same time.

UNITS = *ALL
The assignment of all devices is output in list form. The TYPE and ATTRIBUTES operands are taken into account.

UNITS = *DEVICE-RANGE(...)
The assignment of all the devices in this name range is to be output in list form. The TYPE and ATTRIBUTES operands are taken into account.

Device names <x-text 4..4> (in the case of *DEVICE-RANGE) are selected from FROM to TO in hexadecimal order. Otherwise, device names <alphanum-name 2..2> are selected in alphabetical order.

FROM = <alphanum-name 2..2> / <x-text 4..4>
Defines the start of the name range.

TO = <alphanum-name 2..2> / <x-text 4..4>
Defines the end of the name range. The mnemonic device name must be in the same value range (2- or 4-digit mn) as the FROM device name and must be greater than or equal to the FROM device name in ascending order in the value range.

UNITS = <alphanum-name 1..4 with-wild(20)>
Specifies the devices whose assignment is to be output.
If wildcards are used, the output is in list form. Without wildcards, a corresponding message is output for each device specified (the operand ATTRIBUTES is ignored in the case of output to SYSOUT, but has a meaning for output into an S variable, see "Output in S variables").


TYPE =
Selects the devices on the basis of their device properties. This operand is only evaluated when INFORMATION=*UNITS/*ALL.

TYPE = *ANY
The devices are not selected according to device attributes.

TYPE = *SD
Outputs all devices which are declared as shareable.

TYPE = *VC
Outputs all devices which are assigned as virtual console (ATTRIBUTES=*ASSIGNED) or can be assigned as virtual console (ATTRIBUTES=*FREE).

TYPE = <family>
Outputs all the devices of the specified device family.

<family>

<family> device group

*CONSOLE

Console

*PRINTER

Printer

*FAM50

Special devices

*TD

TRANSDATA device

*UR

Unit record device

*DISK

Disk device

*MBK

Magnetic tape cartridge device

*BIMTAPE

Bimodal tape device

*TAPE

Tape device

TYPE = <device>
Outputs all the devices of the specified device type. The possible device types are contained in the device type table (Device type column) in the "System Installation" manual [1]. The possible device and volume types are displayed in the dialog with TYPE=?. The device types on the current system can be displayed by means of /SHOW-DEVICE-CONFIGURATION, for example.


ATTRIBUTES =
Selects devices or main memory according to their assignment to a VM. This operand is evaluated for devices only if UNITS=*ALL/*DEVICE-RANGE/<alphanum-name-with-wildcards> are specified concurrently.

ATTRIBUTES = *ALL
Information for all devices or the entire main memory is output.

Exception: The output in S variables is restricted to the main memory or those devices assigned to a VM (the same output as for ATTRIBUTES=*ASSIGNED)!

ATTRIBUTES = *ASSIGNED
Only the main memory or those devices assigned to a VM are output.

ATTRIBUTES = *FREE
Only the main memory or those devices not assigned to a VM (DISPOSABLE) are output.


VM-IDENTIFICATION =
Identification of the virtual machine.

The operand is not evaluated for INFORMATION=*CONFIGURATION.

VM-IDENTIFICATION = *VM2000
The information is output for all configured VMs.

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 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 VMs which belong to the CPU pool.

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


Command return codes

(SC2)   SC1

Main code

Meaning

0
1             0
1             0

2             0
2             0
2             0
64
64
64
64
64

CMD0001
VMS4035
VMS4180

VMS4001
VMS4403
VMS4613
VMS3002
VMS3003
VMS4000
VMS4400
VMS4600

Command successfully executed
No corresponding device found (ATTRIBUTES or TYPE)
Specified set of devices empty
(INFORMATION=*ALL/*UNITS)
No VM with appropriate name found
No VM belongs to VM group
No VM has been assigned to CPU pool
Invalid operand value (e.g. TYPE or *DEVICE-RANGE)
Invalid combination of operands
VM not yet created
VM group not yet created
CPU pool not yet created


Guaranteed messages

Only if UNITS is specified without *DEVICE-RANGE and without wildcards:  VMS4006

 

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 = *STD
INFORMATION = *CPU
INFORMATION = *MONJV
INFORMATION = *PRIVILEGES
INFORMATION = *CONFIGURATION

INFORMATION = *UNITS, ATTRIBUTE=*ALL/*ASSIGNED
INFORMATION = *MEMORY, ATTRIBUTE=*ALL/*ASSIGNED
INFORMATION = *ALL, ATTRIBUTE=*ALL/*ASSIGNED

INFORMATION = *UNITS, ATTRIBUTE=*FREE
INFORMATION = *MEMORY, ATTRIBUTE=*FREE
INFORMATION = *ALL, ATTRIBUTE=*FREE

1
2
4
5
6

7
8
9

10
11
12


   

Output information          

Name of S variable

T

Contents             

Condition

The VM index

var(*LIST).VM-INDEX

I

<integer 1..99>

1 - 5, 7 - 9

Name of VM

var(*LIST).VM-NAME

S

<name 1..8>

1 - 5, 7 - 9

Multiprocessor level of the VM

var(*LIST).NUM-OF-CPUS

I

<integer 1..32>

1,2,9

Number of virtual
spare CPUs of the VM

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

I

<integer 0..15>

1,2,9

Name of the CPU pool

var(*LIST).CPU-POOL

S

*STDPOOL
<name 1..8>

1,2,9

CPU quota of the VM (integer)

var(*LIST).CPU-QUOTA

I

<integer 1..99>

1,2,9

CPU quota of the VM (exact)

var(*LIST).FINE-CPU-QUOTA

S

<fixed 0.01..99.99>

1,2,9

Effective CPU share of the VM

var(*LIST).EFFECTIVE-CPU-QUOTA

S

<fixed 0.01..100.00>

1,2,9

Maximum CPU utilization of
the VM (integer)

var(*LIST).MAX-CPU-UTILIZATION

I

<integer 1..100>

1,2,9

Maximum CPU utilization of
the VM (exact)

var(*LIST).FINE-MAX-UTIL

S

<fixed 0.01..100.00>

1,2,9

Maximum CPU utilization of
the VM (effective)

var(*LIST).EFFECTIVE-MAX-UTIL

S

<fixed 0.01..100.00>

1,2,9

Name of the VM group

var(*LIST).VM-GROUP

S

*NONE
<name 1..8>

1,2,9

Is the IO-RESET privilege
assigned?

var(*LIST).IO-PRIVIL

B

TRUE / FALSE

1,5,9

Is the IO-PRIORITY
privilege assigned?

var(*LIST).IO-PRIO-PRIVIL

B

TRUE / FALSE

1,5,9

Is the ASSIGN-BY-GUEST
privilege assigned for at
least one assignment set?

var(*LIST).ASS-BY-GUEST-PRIVIL

B

TRUE / FALSE

1,5,9

Is the AUTO-SNAP-
ASSIGNMENT privilege
assigned?

var(*LIST).AUTO-SNAP-PRIVIL

B

TRUE / FALSE

1,5,9

Size of VM main memory
in Mbytes

var(*LIST).MEM-SIZE

I

<integer 1..1048576>

1,8,9

Minimum size of VM main
memory in Mbytes

var(*LIST).MIN-MEM-SIZE

S

<integer 1..1048576>
*UNDEF

1,8,9

Maximum size of VM main
memory in Mbytes

var(*LIST).MAX-MEM-SIZE

S

<integer 1..1048576>
*UNDEF

1,8,9

New main memory size for
VM for main memory reconfiguration in Mbytes

var(*LIST).PLANNED-MEM-SIZE

S

*UNDEF
<integer 1..1048576>

1,8,9

Size of the main memory for
BS2000 in Mbytes

var(*LIST).BS2-MEM-SIZE

I

<integer 1..1048576>

1,8,9

Maximum I/O utilization of
the VM

var(*LIST).MAX-IO-UTILIZATION

I

<integer 1..100>

1,9

Is the I/O utilization
monitored by IOLVM?

var(*LIST).MAX-IO-UTIL-ACTIVE

B

TRUE / FALSE

1,9

Status of VM

var(*LIST).STA

S

*INIT-ONLY /
*RUN / *WAIT /
*DOWN / *SETUP

1,9

Is the VM in the wait state
following a global /HOLD-VM
from the VM2000 administrator?

var(*LIST).WAIT-GLOBAL

B

TRUE / FALSE

1,9

Is the VM in the wait state
following a selective /HOLD-VM
from the VM2000 administrator?

var(*LIST).WAIT-SEL

B

TRUE / FALSE

1,9

Is the VM in the wait state
following a /HOLD-VM
from the VM administrator?

var(*LIST).WAIT-BY-VM-ADM

B

TRUE / FALSE

1,9

Is the VM in the VM2000-
internal wait state?

var(*LIST).WAIT-INTERNAL

B

TRUE / FALSE

1,9

Is a VM administrator
connected?

var(*LIST).VM-ADM

B

TRUE / FALSE

1,9

Guest operating system

var(*LIST).GUEST-TYPE

S

BS2000
*UNKNOWN

1,9

Version of the guest operating
system

var(*LIST).GUEST-VERSION

S

<c-string 1..8>
*UNKNOWN

1,9

Does the VM have the
PERSISTENT attribute?

var(*LIST).PERSISTENT

B

TRUE / FALSE

1,9

Is the VM currently being
migrated?

var(*LIST).MIGRATING

B

TRUE / FALSE

1,9

Does the VM have a different
I/O configuration after the migration

var(*LIST).DIFFERENT-IO-CONF

B

TRUE / FALSE

1,9

Scheduling procedure

var(*LIST).SCHEDULE

S

*NONE
*BY-TIMESLICE
*DEDICATED-CPUS

2,9

CPU quota (exact) of the
VM group if the VM is
assigned to a VM group

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

S

*NONE
<fixed 0.01..99.99>

2,9

Setting for VM-ACTIVE-IDLE

var(*LIST).VM-ACTIVE-IDLE

S

*NO
*AT-DEDICATED-CPUS

2,9

Virtual CPUs of the VM

var(*LIST).VIRT-CPU(*LIST).NUM

S

<x-text 2..2>

2,9

Status of virtual CPUs of VM

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

S

*RUN / *IDLE / *INIT /
*WAIT / *STOP /
*HALT / *BLOCK /
*SLEEP / *OFFLINE

2,9

Monitor job variable for
monitoring the VM

var(*LIST).VM-MONJV

S

<name 1..54> / *NONE

4,9

Monitor job variable for
monitoring a reconfiguration
of the VM main memory

var(*LIST).RECONF-MONJV

S

<name 1..54> / *NONE

4,9

Monitor job variable for
monitoring a VM migration

var(*LIST).MIGR-MONJV

S

<name 1..54> / *NONE

4,9

Command/function scope
for VM2000 administrator 
and VM administrator

var(*LIST).ADM-PRIVIL

S

*VM2000-MIN /
*VM2000-STD /
*VM-STD / *VM-MAX

5,9

Specification of the
assignment sets for the VM

var(*LIST).ASSIGNMENT-SET-SPEC

S

*NONE / *ALL /
*EXCEPT / *LIST

5,9

List of the assignment sets
for the VM
(only *EXCEPT/*LIST)

var(*LIST).ASSIGNMENT-SET(*LIST)

S

*STDSET /
<name 1..8>

5,9

Number of real normal CPUs
of the Server Unit

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

I

<integer 1..64>

6

Number of real extra CPUs
of the Server Unit

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

I

<integer 0..63>

6

Number of real spare CPUs
of the Server Unit

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

I

<integer 0..63>

6

Maximum possible number
of virtual CPUs for a VM

var(*LIST).MAX-NUM-CPUS-PER-VM

I

<integer 1..32>

6

Size of the main memory
available for VM2000
in Mbytes

var(*LIST).REAL-MEM-SIZE

I

<integer 1..1048576>

6

Main memory size of
domain 0 in Mbytes

var(*LIST).FOREIGN-MEM-SIZE

I

<integer 0..1048576>

6

VM2000 hypervisor main
memory size in Mbytes

var(*LIST).HYPERVISOR-SIZE

I

<integer 0..255>

6

Start address of the VM2000
hypervisor main memory
in Mbytes

var(*LIST).HYPERVISOR-LOCATION

S

<x-text 1..8>
*SPREAD

6

Real CPUs of the Server Unit

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

S

<x-text 2..2>

6

CPU pool to which a real CPU
belongs

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

S

<name 1..8> /
*STDPOOL / *NONE /
*POOL0

6

Status of the real CPUs
of the Server Unit

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

S

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

6

Type of real CPUs
of the Server Unit

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

S

*NORMAL / *EXTRA /
*FOREIGN / *SPARE /
*UNUSED

6

Max. number of VMs
for this Server Unit

var(*LIST).MAX-VMS

I

<integer 1..99>

6

Max. number of VM groups
for this Server Unit

var(*LIST).MAX-VM-GROUPS

I

<integer 0..50>

6

Max. number of CPU pools
for this Server Unit

var(*LIST).MAX-CPU-POOLS

I

<integer 1..64>

6

Default value for the
assignment set
(VM2000 parameter
ASSIGN-BY-GUEST)

var(*LIST).ASSIGNMENT-SET-DEF

S

*NONE / *STDSET

6

Assignment set for new
devices

var(*LIST).ASSIGNMENT-SET-NEW

S

*NONE / *STDSET /
<name 1..8>

6

Devices of the VM

var(*LIST).UNIT(*LIST).MN

S

<alphanum-name 2..2>
<x-text 4..4>

7,9

Who assigned the device
to the VM?

var(*LIST).UNIT(*LIST).ASS-BY

S

*VM-ADMIN /
*GUEST / *UNDEF

7,9

Usage mode of the device

var(*LIST).UNIT(*LIST).USAGE

S

*EXCL / *SHARED /
*UNDEF

7,9

Is the device a virtual
console?

var(*LIST).UNIT(*LIST).VC

B

TRUE / FALSE

7,9

Is the device in KEEP mode?

var(*LIST).UNIT(*LIST).KEEP

B

TRUE / FALSE

7,9

Start address of VM main
memory in Mbytes

var(*LIST).LOCATION

S

<x-text 1..8>
*SPREAD

8,9

Devices not assigned to a VM

var(*LIST).UNIT(*LIST).MN

S

<alphanum-name 2..2>
<x-text 4..4>

10,12

Usage mode of the free device

var(*LIST).UNIT(*LIST).USAGE

S

*SHARED / *UNDEF

10,12

Is the free device a virtual
console?

var(*LIST).UNIT(*LIST).VC

B

TRUE / FALSE

10,12

Is the free device in KEEP
mode?

var(*LIST).UNIT(*LIST).KEEP

B

TRUE / FALSE

10,12

Largest possible main memory
size for a new VM in Mbytes

var(*LIST).LARG-FREE-DOM

I

<integer 0..1048576>

11,12

Start address of a free main
memory in Mbytes

var(*LIST).MEM-SLICE(*LIST).BEGIN

S

<x-text 1..8>
*SPREAD

11,12

End address of the free main
memory in Mbytes

var(*LIST).MEM-SLICE(*LIST).END

S

<x-text 1..8>
*SPREAD

11,12

Size of the free main memory
in Mbytes

var(*LIST).MEM-SLICE(*LIST).SIZE

I

<integer 1..1048576>

11,12


Output format for INFORMATION = *STD

Example
             CPU-POOL(P) 
VM-ID        VM-GROUP(G)  CPU-Q   MAX-U  PROC   MEM-SIZE  MAX-IO 
 1 MONITOR   *STDPOOL(P)  30.00  100.00  1(+1)       512  (100) 
 2 SYSTEM2   *STDPOOL(P)  30.00  100.00  1(+1)       512  (100) 
VM-ID        STATE           VERSION PER ADMIN PRIV 
 1 MONITOR   RUNNING         V21.0B  NO  YES   AG,AS 
 2 SYSTEM2   RUNNING         V20.0B  NO  NO    AS 
F R E E      VM: 13          LARGEST-DOMAIN(MB):   14832
Meaning of the output columns

VM-ID

Identifies the VM by means of VM index and VM name.

CPU-POOL(P)
VM-GROUP(G)

Shows whether the VM is assigned to a VM group. If the VM is not assigned to a VM group, the CPU pool to which the VM is assigned is shown. Whether the VM is assigned to a VM group is indicated by a suffix:

<vm-group-name>(G)  The VM is assigned to a VM group; the VM’s member CPU
                    quota is displayed under CPU-Q.

<cpu-pool-name>(P)  The VM is not assigned to a VM group; the CPU quota of the
                    (individual) VM is displayed under CPU-Q.

CPU-Q

CPU quota of the VM as set by means of command. For VMs which belong to a VM group this is the member CPU quota (MEMBER-CPU-QUOTA operand), otherwise the CPU quota of the VM which does not belong to a VM group (CPU-QUOTA operand).

MAX-U

Maximum CPU utilization of the VM as set by means of command (MAX-CPU-UTILIZATION operand).

PROC

Virtual CPUs of the VM in the form m or m(+n).

mNumber of virtual normal CPUs of the VM (multiprocessor level of the VM)
nNumber of virtual spare CPUs of the VM

MEM-SIZE

Current main memory size of the VM in Mbytes.

MAX-IO

Maximum I/O utilization of the VM as set by means of a command (MAX-IO-UTILIZATION operand). If the value is specified in parentheses, this means it is currently not being monitored by the IORM function IOLVM, see "Use of IORM in VM2000 operation".

STATE

State of the VM.
If there are overlapping wait states, only the wait state with the highest priority (in the order SEL, GLB, VMA, see "Suspending a VM/resuming operation") is displayed.

INIT-ONLYThe VM is initialized (after VM initialization, after /RESET-VM or /ACTIVATE-VM-DEFINITION AUTO-IPL=*NO), but no guest system has been started yet
RUNNING  The guest system on the VM has been started and is running
WAIT(...)The VM is in the wait state (cause)
WAIT(GLB)Global HOLD (/HOLD-VM *ALL) of the VM2000 administrator
WAIT(INT)Internal wait state of the VM, e.g. during /MOVE-VM
WAIT(SEL)Selective HOLD (/HOLD-VM VM-ID=2..n) of the VM2000 administrator
WAIT(VMA)/HOLD-VM of the VM administrator for his VM
DOWNThe guest system on the VM is terminated (after shutdown or SETS in the guest system)

For a VM that is currently being migrated, the following states are output:

  • on the source SU:
    the current state of the VM, complemented by (MIGR), e.g. RUNNING(MIGR)

  • on the target SU (SU /390):
    state SETUP(MIGR)

If the I/O configuration on the target SU is different from the I/O configuration on the source SU, the current state of the migrated VM is output on the target SU, complemented by (DIFF), e.g. RUNNING(DIFF).

VERSION

Version of the BS2000 operating system in the guest system in the form Vnn.na. If the version is not (yet) known, blanks are displayed.

PER

Displays whether the VM has the PERSISTENT attribute (YES/NO).

ADMIN

Indicates if a VM administrator is connected to the virtual machine (YES/NO).

PRIV

Privileges of the VM:

AG  ASSIGN-BY-GUEST
ASAUTO-SNAP-ASSIGNMENT
IO-PIO-PRIORITY
IO-RIO-RESET

The number of VMs not yet initialized and the largest free main memory size for a new VM are shown in the last line of the output information, starting with FREE.

If the Channel Subsystem Monitoring Facility is activated in one of the selected VMs, the VM2000 administrator is informed of this in the case of INFORMATION=*STD/*ALL by message VMS2035 (see "Measurement with the openSM2 measurement monitor").
See the information on FREE in section "Output format for INFORMATION = *MEMORY (SU x86)".


Output format for INFORMATION = *CPU

Example
VM-ID        CPU-POOL  GR-CPU-Q  CPU-Q/ EFF-Q  MAX-U/ EFF-U  PROC
 1 MONITOR   *STDPOOL            30.00/ 25.00 100.00/ 25.00  1(+1) 
 2 SYSTEM2   *STDPOOL            30.00/ 25.00 100.00/ 25.00  1(+1) 
VM-ID        SCHED ACT-I  VIRT CPUS 
 1 MONITOR    DC    NO    00(RUN),01(SLEEP) 
 2 SYSTEM2    DC    NO    00(RUN),01(SLEEP)
Meaning of the output columns

VM-ID / PROC

Corresponds to INFORMATION=*STD.

CPU-POOL

Shows the CPU pool to which the VM is assigned.

GR-CPU-Q

Shows whether the VM is assigned to a VM group.

If the VM is assigned to a VM group, the CPU quota of the VM group is displayed in this column, and the member CPU quota of the VM in column CPU-Q.

If the VM is not assigned to a VM group, blanks are displayed in this column, and the CPU quota of the (single) VM in column CPU-Q.

CPU-Q/EFF-Q

CPU quota of the VM in the format <cpu-quota> / <effective-cpu-quota>, where:

<cpu-quota>           CPU quota of the VM as set by means of command. For VMs
                      which belong to a VM group this is the member CPU quota
                      (MEMBER-CPU-QUOTA operand), otherwise the CPU quota of
                      the VM which does not belong to a VM group (CPU-QUOTA
                      operand).

<effective-cpu-quota> Effective CPU share of the VM, calculated by VM2000.
                      Values < 0.01 are rounded up to 0.01.

MAX-U/EFF-U

Maximum CPU utilization of the VM in the format <max-cpu-util> / <effective-max-cpu-util>, where:

<max-cpu-util>           Maximum CPU utilization set by means of command
                         (MAX-CPU-UTILIZATION operand) for the VM.
<effective-max-cpu-util> Effective maximum CPU utilization of the VM, calculated
                         by VM2000.

SCHED

Scheduling procedure:

-No virtual CPU is executable
DCFixed CPU assignment (dedicated CPUs)
TSTime slicing

ACT-I

Setting for controlling the real CPU in the case of fixed CPU assignment:

NO    The VM leaves control over the real CPU if the VM’s virtual CPU which runs on this is inactive (interruptible wait state, "Idle").
AT–DC The VM retains control over the real CPU even if the VM’s virtual CPU which runs on this is inactive (interruptible wait state, "Idle", SU /390).

VIRT CPUS

Virtual normal and spare CPUs of the VM in the format <cpu-id>(<vstate>),....

<cpu-id>CPU identifier.
<vstate>State of the virtual CPU, see "Virtual CPUs"
(RUN / IDLE / INIT / WAIT / STOP / HALT / BLOCK / SLEEP / OFF).

 

When VM-IDENTIFICATION=*VM2000, the output information for the virtual CPUs of the VMs is followed by the output information for all real CPUs of the Server Unit, grouped according to the type of CPU and the CPU pool to which the CPU belongs.

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

CPU-ATTR

Type of CPU (NORMAL / EXTRA / SPARE / FOREIGN / UNUSED), see "Real CPUs".

CPU-POOL

Identifies the CPU pool to which the real CPU belongs by means of its name.

*STDPOOLStandard CPU pool.
*POOL0Pool of domain 0 (SU x86).

REAL CPUS

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

<cpu-id>Identifier of the real CPU.
<rstate>State of the real CPU, see "Real CPUs"
(ATT / DET / WFM / ERR / OFF).

 

Output format for INFORMATION = *UNITS

Example
VM-ID        UNITS
 1 MONITOR   ASSIGNED BY VM-ADMIN 
             EXCL:   C2,C3,C4,C5,9900,9901,9902,CC40,CC41,CC80, 
                     CC81,CD40,CD41,CD80,CD81,FC10,FC11,FC12
             SHARED: 990F 
 2 SYSTEM2   ASSIGNED BY VM-ADMIN 
             EXCL:   CH,CI,CC42,CC43,CD42,CD43,FC1A,FC1B 
DISPOSABLE   UNASS:  CA(VC),CB(VC),CC(VC),CJ,CK,CL,CM,CN,CO,CS,CT,
                     C0,C1,DH,DI,DJ,DK,DL,DM,DN,DO,DS,DT,N3,N4,N8,
                     ... 
                     CD9B,CD9C,CD9D,FC13,FC14,FC15,FC16,FC17,FC18, 
                     FC19,FC1C,FC1D,FC1E,FC1F 
             SHARED: 990F
Meaning of the output columns

VM-ID

Identifies the VM by means of VM index and VM name.
DISPOSABLE    The devices can be assigned to a VM.

UNITS

The output of the devices assigned to a VM takes place VM-specific in blocks: first the explicitly assigned devices (ASSIGNED BY VM-ADMIN), then the implicitly assigned devices (ASSIGNED BY GUEST). The output is grouped in accordance with the usage mode (EXCL/SHARED/KEEP). Empty blocks or groups are omitted.

The output of the devices which can be assigned to a VM (DISPOSABLE) is grouped in accordance with the usage mode (UNASS/SHARED/KEEP), see operand STATE=*DISPOSABLE at /SHOW-VM-DEVICE-STATUS. Empty groups are omitted.

The device list is arranged in ascending order of the value range (two- or four-digit). The two-digit device names are output first, followed by the four-digit device names.

For SU /390, the suffix (VC) identifies a device that is used or can be used as a virtual console (see "Operating the guest systems (VC dialog via $VMCONS)").

If no device corresponding to the command call is assigned to the VM, NO CORRESPONDING DEVICE ASSIGNED is output.

If UNITS=list-poss(28): <...> is specified (without the use of wildcards), an appropriate message is output for each device affected.

 

Output format for INFORMATION = *MEMORY (SU /390)

Example (VM-ID=*VM2000)
VM-ID        LOC-BEGIN  MEM-SIZE  MIN-MEM-S  MAX-MEM-S  DEST-MEM-S 
HYPERVISOR   00000000         16 
 1 MONITOR   00000010        512        512 
 2 SYSTEM2   00000210        512        512 
NONE         00000410      14832 
LARGEST FREE DOMAIN:       14832
Meaning of the output columns

VM-ID

Identifies the VM by means of VM index and VM name

NONEMain memory is not used by a VM (free main memory).
LARGEST FREE DOMAIN

Maximum free main memory for a new VM. Corresponds to the output in the last line in the case of INFORMATION=*STD, see "FREE".

LOC-BEGIN

Start address of the main memory area in Mbytes.

MEM-SIZE

Size of a free memory area in Mbytes or main memory of the VM in Mbytes.

MIN-MEM-S

Minimum size of the VM’s main memory in Mbytes (for main memory reconfiguration).

MAX-MEM-S

Maximum size of the VM’s main memory in Mbytes for main memory reconfiguration (SU x86). No output for SU /390.

DEST-MEM-S

Planned size of the VM’s main memory in Mbytes when main memory reconfiguration is in progress.

When VM-IDENTIFICATION=*VM2000, the free memory areas are also output. In this case the output lines are arranged in ascending order of the start addresses of the memory areas. Otherwise they are arranged according to the VM index.

 

Output format for INFORMATION = *MEMORY (SU x86)

Example (VM-ID=*VM2000)
VM-ID        BS2-MEM-S  MEM-SIZE  MIN-MEM-S  MAX-MEM-S  DEST-MEM-S
 1 MONITOR        8084      8192       2048      10000
 2 SYSTEM2       35420     36000       8192      65000
FOREIGN VMS                16247
FREE                       67788
Meaning of the output columns

VM-ID

Identifies the VM by means of VM index and VM name.

FOREIGN VMSMain memory size of the domain 0.
FREE       Free main memory for the new VMs. Corresponds to the output in the last line in the case of INFORMATION=*STD, see "FREE".
During the configuration of a VM, there is still a main memory area required for management data of the Xen hypervisor. This additional main memory is assigned automatically to a VM (siehe "Managing main memory on SU x86"). Consequently, not all the main memory specified with FREE can be used for the VM.

BS2-MEM-S

Size of the main memory (without the VM’s firmware component) which is available for BS2000 in Mbytes.

MEM-SIZE

Size of VM main memory in Mbytes.

MIN-MEM-S

Minimum size of the VM’s main memory in Mbytes (for main memory reconfiguration).

MAX-MEM-S

Maximum size of the VM’s main memory in Mbytes (for main memory reconfiguration).

DEST-MEM-S

Planned size of the VM’s main memory in Mbytes when main memory reconfiguration is in progress.

When VM-IDENTIFICATION=*VM2000, the output lines are sorted according to the VM index in ascending order. The memory area of domain 0 (FOREIGN VMS) is subsequently output, followed by the free memory for the new VMs (FREE).

 

Output format for INFORMATION = *MONJV

Example
VM-ID        VM-MONJV
 2 SYSTEM2  :4IVK:$TSOS.JV-SYS2
 3 SYSTEM3  :4IVK:$TSOS.JV-SYS3
VM-ID        RECONF-MONJV
 2 SYSTEM2  :4IVK:$TSOS.JV-S2REC
VM-ID        MIGR-MONJV
 3 SYSTEM3  :4IVK:$TSOS.JV-S3MIG
Output lines are shown only for VMs which are monitored using a MONJV or which are explicitly specified in the command.
Meaning of the output columns

VM-ID

Identifies the VM by means of VM index and VM name.

VM-MONJV

File name of the MONJV for the VM.
NO VM-MONJV ASSIGNED     No MONJV is defined for the MONJV.

RECONF-MONJV

File name of the MONJV for the main memory reconfiguration.
If no reconfiguration of the main memory is in progress or no MONJV has been defined for this, this output block is omitted.

MIGR-MONJV

File name of the MONJV for the VM Migration.
If no VM Migration is in progress or no MONJV has been defined for this, this output block is omitted.

 

Output format for INFORMATION = *PRIVILEGES

Example
VM-ID        PRIV    DETAILS 
 1 MONITOR   AG      *STDSET
             AS 
 2 SYSTEM2   AS
Meaning of the output columns

VM-ID

Identifies the VM by means of VM index and VM name.

PRIV

Privileges of the VM.

NO PRIVILEGE

No privileges.
ADM  Command/function scope for VM2000 administrator (monitor VM) or VM administrator, see DETAILS.
AG  The VM has the ASSIGN-BY-GUEST privilege. The list of the assignment sets assigned is output in DETAILS.
AS  AUTO-SNAP-ASSIGNMENT=*YES (default).
IO–PIO-PRIORITY=*YES.
IO–RIO-RESET=*YES.

DETAILS

Supplementary information on the privileges:

For PRIV=ADM:
*VM2000-MINADMIN-PRIVILEGES=*MIN for the monitor VM
*VM-MAXADMIN-PRIVILEGES=*MAX for a VM other than the monitor VM
For PRIV=AG:
*ALL ASSIGN-BY-GUEST=*YES(SET-NAME=*ALL)
*EXCEPT: set1, set2, ...

ASSIGN-BY-GUEST=*YES(SET-NAME=*EXCEPT(...))
set1, set2, ...

ASSIGN-BY-GUEST=*YES(SET-NAME=<list>)

 

Output format for INFORMATION = *CONFIGURATION

Example (SU /390)
MAX NUMBER OF VMS                     15
MAX NUMBER OF VM-GROUPS                8
MAX NUMBER OF CPU-POOLS                4
MAX NUMBER OF CPUS PER VM              4
TOTAL REAL MEMORY SIZE (MB)        15872
ASSIGNMENT SET   DEFAULT VALUE:  *NONE 
                 NEW DEVICES  :  *NONE
CPU-ATTR     CPU-POOL     REAL CPUS
NORMAL       *STDPOOL     00(ATT),01(ATT),02(ATT),03(ATT)
EXTRA                     NONE
SPARE                     04(DET)
Meaning of the output lines

The following configuration data of the Server Unit is displayed:

  • The maximum number of VMs that can be created.
  • The maximum possible number of VM groups that can be created.
  • The maximum possible number of CPU pools for VM2000.
  • The maximum number of virtual CPUs for a VM (multiprocessor level) which may be selected explicitly for a VM.
  • The size of the main memory in Mbytes.
  • Default value for the implicit device assignment (*NONE/*STDSET). The default value corresponds to the VM2000 parameter ASSIGN-BY-GUEST=*NO/*YES (SU /390). On SU x86 the default value is always *NONE.
  • Default value for the implicit device assignment for new devices (dynamic configuration modification) (*NONE / *STDSET / <name 1..8>). The default value corresponds to the VM2000 parameter ASSIGN-BY-GUEST=*NO/*YES (SU /390), provided this has not been modified by means of /MODIFY-VM-DEVICE-ATTRIBUTES UNITS=*NEW-DEVICES.
  • Information on the real CPUs. For a description of this output format see "Output format for INFORMATION = *CPU (real CPUs)".

 

Example (SU /390)

/show-vm-resources information=*all ———————————————————————————————————  (1)
             CPU-POOL(P) 
VM-ID        VM-GROUP(G)  CPU-Q   MAX-U  PROC   MEM-SIZE  MAX-IO ——————  (2)
 1 MONITOR   *STDPOOL(P)  30.00  100.00  1(+1)       512  (100)
 2 SYSTEM2   *STDPOOL(P)  30.00  100.00  1(+1)       512  (100)
VM-ID        STATE           VERSION PER ADMIN PRIV ———————————————————  (3)
 1 MONITOR   RUNNING         V21.0B  NO  YES   AG,AS
 2 SYSTEM2   RUNNING         V20.0B  NO  NO    AS
F R E E      VM: 13          LARGEST-DOMAIN(MB):   14832
VM-ID        CPU-POOL  GR-CPU-Q  CPU-Q/ EFF-Q  MAX-U/ EFF-U  PROC —————  (4)
 1 MONITOR   *STDPOOL            30.00/ 25.00 100.00/ 25.00  1(+1) 
 2 SYSTEM2   *STDPOOL            30.00/ 25.00 100.00/ 25.00  1(+1)
VM-ID        SCHED ACT-I  VIRT CPUS ———————————————————————————————————  (5) 
 1 MONITOR    DC    NO    00(RUN),01(SLEEP)
 2 SYSTEM2    DC    NO    00(RUN),01(SLEEP)
CPU-ATTR     CPU-POOL     REAL CPUS ———————————————————————————————————  (6)
NORMAL       *STDPOOL     00(ATT),01(ATT),02(ATT),03(ATT)
EXTRA                     NONE
SPARE                     04(DET)
VM-ID        VM-MONJV —————————————————————————————————————————————————  (7)
 2 SYSTEM2  :4IVK:$TSOS.MONJV-SYSTEM2
VM-ID        UNITS ————————————————————————————————————————————————————  (8)
 1 MONITOR   ASSIGNED BY VM-ADMIN
             EXCL:   C2,C3,C4,C5,9900,9901,9902,CC40,CC41,CC80,
                     CC81,CD40,CD41,CD80,CD81,FC10,FC11,FC12
             SHARED: 990F 
 2 SYSTEM2   ASSIGNED BY VM-ADMIN
             EXCL:   CH,CI,CC42,CC43,CD42,CD43,FC1A,FC1B
DISPOSABLE   UNASS:  CA(VC),CB(VC),CC(VC),CJ,CK,CL,CM,CN,CO,CS,CT, ————  (9)
                     C0,C1,DH,DI,DJ,DK,DL,DM,DN,DO,DS,DT,N3,N4,N8, ———— (10)
                     ...
                     CD9B,CD9C,CD9D,FC13,FC14,FC15,FC16,FC17,FC18,
                     FC19,FC1C,FC1D,FC1E,FC1F
             SHARED: 990F
VM-ID        LOC-BEGIN  MEM-SIZE  MIN-MEM-S  MAX-MEM-S  DEST-MEM-S ———— (11)
HYPERVISOR   00000000         16
 1 MONITOR   00000010        512        512
 2 SYSTEM2   00000210        512        512
NONE         00000410      14832
LARGEST FREE DOMAIN:       14832
VM-ID        PRIV    DETAILS —————————————————————————————————————————— (12)
 1 MONITOR   AG      *STDSET
             AS
 2 SYSTEM2   AS

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

(1)

The VM2000 administrator queries the state of all VM2000 resources.

(2)

List of attributes of all VMs. Each VM is also assigned a virtual spare CPU.

(3)

List of states of all VMs. Up to 13 further VMs can be set up. The largest free main memory size for a new VM is 14832 Mbytes.

(4)

Overview of the assignment of VMs to CPU pools and VM groups, and of the shares of Server Unit CPU capacity, specified by means of command and calculated by VM2000.

(5)

List of virtual normal and spare CPUs.

(6)

List of real normal, extra and spare CPUs.

(7)

VM2 is monitored with a MONJV.

(8)

List of devices assigned.

(9)

List of free devices, sorted by usage mode. Possible virtual consoles are identified by the suffix (VC).

(10)

In the device lists, the 2-digit mnemonic device names come first, followed by the 4-digit ones.

(11)

Distribution of the VM's main memories in VM2000 main memory.

(12)

Privileges of the VMs.

Powered by Atlassian Confluence and Scroll Viewport.