Displaying system configuration information

Use the DISPLAY M command to display the status of sides, processors, ICRFs, channel paths, devices, Start of change storage-class memory (SCM) End of change 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
`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}]`

 
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, Start of change

storage-class memory (SCM) End of change

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. End of change

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. End of change

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)

Start of change Example 6: End of change

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  +-