Displaying system configuration information (M)

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.

Syntax

D M

D M
D M[=CHP[{(xx)\|(xx-xx)\|(list)}[,PATHINFO]] \|=CONFIG[(xx)] \|=CORE[(x)\|(list)] \|={CPUAD\|CPU}[(x)\|(list)] \|=CU(xxxx) \|={DEVICE\|DEV}[([/]devnum)\|([/]lowdevnum-[/]highdevnum)\|(list)] [,{ZHYPERLINK\|ZHL\|READSEC}] \|={DEVICE\|DEV}([/]devnum,(chp))[,ROUTE={TODEV\|FROMDEV\|BOTH}[,HEALTH]] [,LINKINFO={FIRST\|LAST\|REFRESH\|COMPARE}] \|={DEVICE\|DEV}(([/]devnum),chp)[,ROUTE={TODEV\|FROMDEV\|BOTH}[,HEALTH]] [,LINKINFO={FIRST\|LAST\|REFRESH\|COMPARE}] \|=HIGH [,DMEM] \|=HSA \|=SCM(DETAIL) \|=SIDE[(id)] \|={STORAGE\|STOR}[(ddddM-ddddM)\|(list)\|(E[=id])] \|={STORAGE\|STOR}[(ddddM-ddddM)\|(list)],DMEM \|=SWITCH(sssss [,pp[-pp] [,pp[-pp]]...]) \|=(parm[,parm]...) [,L={a\|name\|name-a}]

 
D M[=CHP[{(xx)|(xx-xx)|(list)}[,PATHINFO]]
    |=CONFIG[(xx)]
    |=CORE[(x)|(list)]
    |={CPUAD|CPU}[(x)|(list)]
    |=CU(xxxx) 
    |={DEVICE|DEV}[([/]devnum)|([/]lowdevnum-[/]highdevnum)|(list)]      
                                   [,{ZHYPERLINK|ZHL|READSEC}] 
    |={DEVICE|DEV}([/]devnum,(chp))[,ROUTE={TODEV|FROMDEV|BOTH}[,HEALTH]]
                                   [,LINKINFO={FIRST|LAST|REFRESH|COMPARE}]
    |={DEVICE|DEV}(([/]devnum),chp)[,ROUTE={TODEV|FROMDEV|BOTH}[,HEALTH]]
                                   [,LINKINFO={FIRST|LAST|REFRESH|COMPARE}]
    |=HIGH [,DMEM]
    |=HSA
    |=SCM(DETAIL)
    |=SIDE[(id)]
    |={STORAGE|STOR}[(ddddM-ddddM)|(list)|(E[=id])]
    |={STORAGE|STOR}[(ddddM-ddddM)|(list)],DMEM
    |=SWITCH(sssss [,pp[-pp] [,pp[-pp]]...])
    |=(parm[,parm]...)

   [,L={a|name|name-a}]

Parameters

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 in z/OS MVS System Messages, Vol 7 (IEB-IEE).

(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.

[,PATHINFO]: Display information for the paths sharing the specified channel path identifiers. This information includes, for example, the destination link address, link speed, and Fibre Channel Endpoint Security status.

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 in z/OS MVS System Messages, Vol 7 (IEB-IEE).

You can also start this function from the HCD dialog. For details refer to the "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 as well as the HiperDispatch setting and multithreading (MT) mode. If you do not specify any core identifiers, the system displays the online or offline status of all cores.

For a description of the display format, see message IEE174I in z/OS MVS System Messages, Vol 7 (IEB-IEE).

(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 while a zIIP boost is active, any zIIPs added due to the boost processing are displayed as B instead of I. The key at the end of the IEE174I display contains B BOOST (TRANSIENT) zIIP.

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.

CPUAD or CPU

The system is to display the online or offline status of one or more processors and any ICRFs attached to those processors. See message IEE174I in z/OS MVS System Messages, Vol 7 (IEB-IEE).

If you do not specify any processor identifiers, the system displays the online or offline status of all processors and any ICRFs attached to them. Whether you specify a processor identifier or not, the system displays “N” when a processor is neither online or offline, but is recognized by the machine.

Note: When you issue the DISPLAY M=CPU command while a zIIP boost is active, any zIIPs added due to the boost processing are displayed as B instead of I. The key at the end of the IEE174I display contains B BOOST (TRANSIENT) zIIP.

Note: When you issue the DISPLAY M=CPU command from a PR/SM partition, the system displays the status for the logical processors, and ICRFs defined to the partition.

(x): A single processor identified by processor identifier in hexadecimal format.
(list): One or more processor 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 in z/OS MVS System Messages, Vol 7 (IEB-IEE).

(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 in z/OS MVS System Messages, Vol 7 (IEB-IEE).

([/]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

The ROUTE parameter displays the route through the fabric between the channel and the device.

Specify one of the following keywords on the ROUTE parameter:

TODEV: Displays the route through the fabric, starting with the channel and going to the device.
FROMDEV: Displays 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.

Routing and health information will only be determined and displayed when the channel is connected to a switch and the control unit definition for the channel path is defined in the I/O configuration with a two-byte link address.

For a description of the display format, see message IEE583I in z/OS MVS System Messages, Vol 7 (IEB-IEE).

For more information about how the routing and health information can be used to diagnose a problem in the fabric, see Diagnosing problems in a switched fabric.

HEALTH

Displays the health information, which includes the utilization, average delay, and error counts, for the fabric, switch, and port.

LINKINFO

The LINKINFO parameter displays link diagnostic information for a device and CHPID. Link diagnostic information consists of the optical transceiver values, error counters, and buffer credits for each port from the channel to the control unit, except inter-switch link (ISL) ports.

For switched point-to-point configurations, information for the channel port, entry switch port, exit switch port, and control unit port is displayed.
For point-to-point configurations, information for the channel port and control unit port is displayed.

The LINKINFO parameter may only be specified when a path is specified on the D M=DEV command.

Specify one of the following keywords on the LINKINFO parameter:

FIRST

Displays the link diagnostic information that was obtained during IPL or when the path was varied online for the first time after IPL.

LAST

Displays the link diagnostic information that was last retrieved by the system. The system retrieves new information for a path every 24 hours or when you specify LINKINFO=REFRESH.

REFRESH

Requests that the system obtain new link diagnostic information for the physical path and then displays that information. This replaces the prior information; a subsequent LINKINFO=LAST request will display this new information.

Notes:

A REFRESH request does not cause the entry switch port, exit switch port, and control unit port to retrieve new optical transceiver information; it simply causes the last retrieved values to be returned to the channel subsystem. The frequency at which a port retrieves its own optical transceiver information is manufacturer- and model-specific.
The system rejects a REFRESH request if the channel specified in the command is already processing the maximum number of concurrent requests. These requests could be from this system or from other systems running on the same CPC. The allowed maximum number of concurrent requests for a channel is model-dependent.

The system issues the IEE584I message in response to the FIRST, LAST, and REFRESH keywords.

COMPARE

Displays a comparison of the first and last set of link diagnostic information that was retrieved by the system. The system issues the IEE586I message in response to the COMPARE keyword.

ZHYPERLINK or ZHL

The ZHYPERLINK parameter is used to display the zHyperLink capabilities of the device. If zHyperLink capability or zHyperLink reads or writes are disabled for the device, the list of reasons why the function is disabled is displayed. The ZHYPERLINK keyword is ignored if it is specified for a parallel access volume (PAV) alias device.

READSEC

The READSEC parameter is used to display the consistent read from secondary capability of the device. If consistent read from secondary is disabled for the device, the list of reasons why the function is disabled is displayed. The READSEC keyword is ignored if it is specified for a parallel access volume (PAV) alias device.

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. Each address indicates the amount of storage available at system initialization. For a description of the display format, see message IEE174I in z/OS MVS System Messages, Vol 7 (IEB-IEE). Start of change

DMEM: The system is to display the range of Dedicated Memory.

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 in z/OS MVS System Messages, Vol 7 (IEB-IEE).

SCM[(DETAIL)]

Displays the online or offline status for all installed storage-class memory (SCM) increments, and usage information. Start of change

Information about reconfigurability of online SCM is also displayed. End of change

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 in z/OS MVS System Messages, Vol 7 (IEB-IEE).

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 job name 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 in z/OS MVS System Messages, Vol 7 (IEB-IEE).

(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.

DMEM

The status of Dedicated Memory is displayed. End of change

(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 in z/OS MVS System Messages, Vol 7 (IEB-IEE).

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.

Examples

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 the following command:

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 following example, 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  +-

Example 7:

The following example displays the channel path information for the control units connected to channel path identifier (CHPID) 5A.

D M=CHP(5A),PATHINFO
IEE588I 07.58.47 DISPLAY M 251
CHPID 5A:  TYPE=1B, DESC=FICON SWITCHED, ONLINE
Path Information for Channel Path 5A
Connection Security Capability: Encryption
Dest                                     Link-Speed  Conn
Link Intf Node Descriptor                Curr  Cap   Sec
1211 0131 002107.996.IBM.75.0000000KMP31 32G   32G   Encr
1111 0030 002107.996.IBM.75.0000000KMP31 16G   16G   Auth