Use the DISPLAY M command to display the status of sides, processors,
ICRFs, channel paths, devices, storage-class memory (SCM) and
central storage, or to compare the current hardware configuration
to the configuration in a CONFIGxx parmlib member.
The DISPLAY M command can accept the subchannel set
number to qualify the input device number. The output of message IEE097I
includes the applicable subchannel set number.
When you specify a device number that might be mistaken for the
device name, precede the device number with a slash. The slash is
optional with a 3-digit device number.
D M |
D M[=CHP[(xx)|(xx-xx)|(list)]
|=CONFIG[(xx)]
|=CORE[(x)|(list)]
|={CPUAD|CPU}[(x)|(list)]
|=CU(xxxx)
|={DEVICE|DEV}[([/]devnum)|([/]lowdevnum-[/]highdevnum)|(list)]
|={DEVICE|DEV}([/]devnum,(chp))[,ROUTE={TODEV|FROMDEV|BOTH}
[,HEALTH]]
|={DEVICE|DEV}(([/]devnum),chp)[,ROUTE={TODEV|FROMDEV|BOTH}
[,HEALTH]]
|=HIGH
|=HSA
|=SCM(DETAIL)
|=SIDE[(id)]
|={STORAGE|STOR}[(ddddM-ddddM)|(list)|(E[=id])]
|=SWITCH(sssss [,pp[-pp] [,pp[-pp]]...])
|=(parm[,parm]...)
[,L={a|name|name-a}]
|
- M
- The system is to display information about system configuration.
When you enter DISPLAY M with no operands, the system displays the
starting address and length of each portion of the hardware system
area (HSA). The system also displays the status of all processors,
ICRFs, central storage, channel paths, storage-class memory (SCM) and
devices, depending on the type of processor or processor complex.
If
the processor complex is partitioned, the system does not provide
information about resources that are not part of the configuration
on which you issue the command. Message IEE174I gives you the status
of resources on the side from which you issue the command and tells
you that information about the other side is unavailable. If you
are running your processor complex in single-image mode with all resources
in one side offline, message IEE174I identifies the other side as
being offline but gives you the information about those resources.
For example, to partition a processor complex, you configure offline
the resources on one side. To verify that those resources are offline,
issue the DISPLAY M=SIDE command. The display lists the side as offline
and gives the status of the resources.
- CHP
- The system is to display the online and offline status of channel
paths. If you do not specify any channel path, the system displays
the status of all channel paths, as well as a status of either “managed
and online” or “managed and offline” as part of
the support of dynamic channel path management. For a description
of the display format, see message IEE174I.
- (xx)
- A single channel path identified by xx. The
channel path identifier can have a value from 0 to FF.
- (xx-xx)
- A range of channel path identifiers. The starting and ending
channel path identifiers can have a value from 0 to FF.
- (list)
- One or more single channel path identifiers, or a combination
of single channel path identifiers and ranges of channel path identifiers,
each separated by a comma.
- CONFIG[(xx)]
- The system is to display the differences between the current configuration
and the configuration described in the CONFIGxx parmlib member. If
you omit xx, the system assumes that you mean CONFIG00.
For
a description of the display format, see message IEE097I.
You
can also start this function from the HCD dialog. For details refer
to the topic "Process
Display M=CONFIG(xx) Command" in z/OS HCD User's Guide.
- CORE
- The system is to display the online or offline status of one or
more cores. If you do not specify any core identifiers, the system
displays the online or offline status of all cores.
- (x)
- A single core identified by a core identifier in hexadecimal format.
- (list)
- One or more core identifiers, each separated by a comma.
Note: When you issue the DISPLAY M=CORE command
from a PR/SM™ partition, the system displays the status
for the logical cores and ICRFs defined to the partition.
Note: When
you issue the DISPLAY M=CORE command from a system where PROCVIEW
CPU is in effect, the command is rejected.
- CPUAD or CPU
- The system is to display the online or offline status of one or
more CPUs and any ICRFs attached to those CPUs. See message IEE174I.
If
you do not specify any CPU identifiers, the system displays the online
or offline status of all CPUs and any ICRFs attached to them. Whether you specify a CPU identifier or not, the system
displays “N” when a CPU is neither online or offline,
but is recognized by the machine.
- (x)
- A single CPU identified by CPU identifier in
hexadecimal format.
- (list)
- One or more CPU identifiers, each separated by a comma.
Note: When you issue the DISPLAY M=CPU command from
a PR/SM partition, the system displays the status
for the logical CPUs, and ICRFs defined to the partition.
Note: When you issue the DISPLAY M=CPU
command from a system where PROCVIEW CORE is in effect, the command
is rejected. With LOADxx PROCVIEW CORE,CPU_OK, CPU is accepted and
treated as an alias for CORE.
- CU
- The system is to display the information for a specific control
unit. For a description of the display format, see message IEE174I.
- (xxxx)
- The control unit number.
Note: The D M=CU command does not support displaying
information for CTC control units.
- DEVICE or DEV
- The system is to display the number of online channel
paths to devices (including special devices) or a single channel path
to a single device.
For a description of the display format, see
message IEE583I.
- ([/]devnum)
- A single device number.
- ([/]lowdevnum-[/]highdevnum)
- The lower device number lowdevnum and the upper
device number highdevnum of a range of devices.
- ([/]devnum,(chp))
- A single device number and single channel path identifier.
- (([/]devnum),chp)
- A single device number and single channel path identifier.
- ROUTE
- ROUTE=
- TODEV – displays the route through the fabric, starting
with the channel and going to the device.
- FROMDEV – displays the route through the fabric, starting
with the device and going to the channel.
- BOTH – displays the route through the fabric in both directions.
For a description of the display format, see message IEE583I
in z/OS MVS System Messages, Vol 7 (IEB-IEE).
- HEALTH
- Displays the health information, which includes the utilization,
average delay, and error counts, for the fabric, switch, and port.
Device numbers and ranges can be specified in
any combination.
A device number consists of 3, 4, or 5 hexadecimal
digits, optionally preceded by a slash (/). A channel
path identifier can have a value from 0 to FF. In the 5 digit format, sdddd, s is
the subchannel set identifier and dddd is the device
number.
If a range of device numbers is found
and one of the two numbers is a 5-digit number, the other number in
the range must also be a 5-digit number.
- HIGH
- The system is to display the highest possible central
storage addresses in decimal M bytes (megabytes) or when the value
is greater than 16383 decimal, in hexadecimal M bytes. Each address
indicates the amount of storage available at system initialization.
For a description of the display format, see message IEE174I.
- HSA
- The system is to display the starting address and length of each
portion of the hardware system area (HSA). For a description of the
display format, see message IEE174I.
- SCM [(DETAIL)]
- Displays the online or offline status for all installed SCM increments,
and usage information. If DETAIL is
specified, details for each online increment are displayed; otherwise,
summary information is displayed for ranges of SCM.
For
a complete description of the display format of DISPLAY M=SCM, refer
to message IEE174I.
- SIDE[(id)]
- The system is to display the resources installed in side (physical
partition) id, whether the resources are online
or offline, and whether the side is online, offline, or unavailable.
If the processor complex is partitioned and the specified side is
part of another configuration, no information is provided. If the
processor complex is running in single-image mode and you do not specify
an id, the system displays both sides. If the command
is issued from MVS™ running in a partition, no information is
provided.
For a complete description of the display format of DISPLAY
M=SIDE, see message IEE174I.
- STORAGE or STOR
- The system is to display the status of central storage. The display
includes storage offline, storage waiting to go offline, and reconfigurable
storage sections. For storage waiting to go offline, the system displays:
- The address space identifier (ASID)
- The jobname of the current user of the storage
- The amount of unassigned storage in offline storage elements
- The amount of storage that belongs to another configuration
STORAGE also indicates if a given range of central storage
contains data that is shared through the use of the IARVSERV macro.
In
this display, storage offline does not include the hardware save area
(HSA). To find the location and length of the HSA, enter DISPLAY
M=HSA.
If you do not specify (dddddX-dddddX),
(list), or (E[=id]), the system
displays the status of all central storage. For a description of
the display format, see message IEE174I.
- (dddddX-dddddX)
- The starting and ending addresses of a range in central storage
for which you want the status display. Specify up to five decimal
digits followed by a multiplier (M-megabytes, G-gigabytes, T-terabytes,
P-petabytes) for each address. The starting and
ending addresses (dddddX) must each be on a valid
storage boundary and cannot exceed 16383P. The starting and ending
addresses must not be the same.
Instead of specifying the range
using decimal numbers, you can specify it in hexadecimal, with or
without a multiplier, in the format
X'xxxxxx'-
X'xxxxxx'.
For example:
- X'123456789A00000'-X'123456789B00000'
- X'123'M-X'124'M
You can use underscores in any hexadecimal specification for
better clarity. Underscores in the specification are ignored during
processing.
- (list)
- One or more address ranges (in decimal), each separated by a comma.
- (E[=id])
- The system is to display the status of the requested storage element.
The display includes the amount of storage (in megabytes) the system
owns in each online storage element, the amount of storage available
to be configured online, whether the storage element is online or
offline. If you omit the id, the system displays
this information for all installed storage elements.
Note: If the
processor complex is partitioned and the specified storage element
is part of another configuration, no information is provided.
- SWITCH(ssss [,pp[-pp]
[,pp[-pp]]…])
- The system is to display the status of a specific switch, switch
port, or list of switch ports.
For a description of the display
format, see message IEE174I.
- ssss
- The device number of the switch device.
- [,pp[-pp] [,pp[-pp]]…]
- The port address or port address list.
- (parm[,parm]…)
- The system is to display the status of each resource you specify
as parm. The list of parms
you specify within the parentheses may contain any combination of
CHP, CPU, DEV, HIGH, HSA, STOR(E[=id]), and STOR. You must separate
the resources in the list with commas and you must enclose the list
in parentheses. Do not use blanks within the parentheses and do not
specify CONFIG in the list.
- L=a, name, or name-a
- Specifies the display area (a), console name
(name), or both (name-a) where
the display is to appear.
If you omit this
operand, the display is presented in the first available display area
or the message area of the console through which you enter the command.
Example 1:
To display the online or offline status of all devices on channel
path 01, enter:
D M=CHP(01)
Example 2:
To display the following information:
- The online or offline status of all processors
- The number of online channel paths to each device
- The highest central storage address available
- The status of central storage
enter:
D M=(CPU,DEV,HIGH,STOR)
Example 3:
To display the number of megabytes of storage the system owns in
storage element 0 and the status of the storage element, enter:
D M=STOR(E=0)
Example 4:
To display the number of megabytes of storage the system owns in
each storage element and the status of each element, enter:
D M=STOR(E)
Example 5:
To display the status of all processors, the status for channel
paths 1, 3, 4, 5, and the high storage addresses for central storage,
enter:
D M=CPU
D M=CHP(01,03-05)
D M=HIGH
or
D M=(CPU,CHP(01,03-05),HIGH)
Example 6:
The following example displays
the status of cores. In this example, the configuration supports
MT Mode=2 (MT=2) where standard CP cores 0 and 1 are exploiting MT
Mode=1 (CP=1) and zIIP cores 2 and 3 are exploiting MT Mode=2 (zIIP=2).
D M=CORE
CORE STATUS: HD=Y MT=2 MODE: CP=1 zIIP=2
ID ST ID RANGE VP ISCM CPU THREAD STATUS
0000 + 0000-0001 H FC00 +N
0001 + 0002-0003 H FC00 +N
0002 +I 0004-0005 H 0200 ++
0003 +I 0006-0007 H 0200 ++
It is possible
for a core status to be mixed (/). A core status of mixed means that
a core's CPU thread status is unexpected given the MT Mode for cores
of that type. In the example below, the status of core 3 is mixed,
because CPU 6 is online, CPU 7 is offline, and zIIPs are exploiting
MT Mode=2. With zIIPs exploiting MT Mode=2, the system expects core
3 to have both threads (CPUs 6 and 7) online. If a core appears with
a mixed mode, it is generally due to an internal system error and
should be configured to the desired online or offline state.
D M=CORE
CORE STATUS: HD=Y MT=2 MODE: CP=1 zIIP=2
ID ST ID RANGE VP ISCM CPU THREAD STATUS
0000 + 0000-0001 H FC00 +N
0001 + 0002-0003 H FC00 +N
0002 +I 0004-0005 H 0200 ++
0003 /I 0006-0007 H 0200 +-