gtpo1m9mOperations

ZMPIF DISPLAY-Display Parameters

Use this command to display formatted information about the status and activity of MPIF resources.

Requirements and Restrictions

This command displays information about the MPIF resources that were defined before you performed the last initial program (IPL). If you defined any new resources or changed any existing resources since that time, the new or changed information is not displayed until after you perform another IPL.

Format




Activity
displays information about the activity of the MPIF resources.

Path-path
displays information about the activity on a specific path, where path is a 1- to 8-character alphanumeric path name.

Device-$device
displays information about the path activity through a specific device, where $device is a 1- to 7-character alphanumeric generic device name that begins with the $ character.

Class-code
displays information about the activity of the paths that are assigned to a specific path class, where code is a 1-character alphanumeric path class code.

ALL
displays information about all the path activity in the system.

CLass
displays information about path classes.

Code-code
displays information about a specific path class, where code is a 1-character alphanumeric path class code.

ALL
displays information about all the path classes.

COMplex
displays the following information about the complex:

Connect
displays information about the connections defined for the MPIF resources.

User-user
displays information about the connections defined for a specific MPIF user, where user is a 1- to 8-character alphanumeric user name.

Device-$device
displays information about the connections through a specific device, where $device is a 1- to 7-character alphanumeric generic device name that begins with the $ character.

Class-code
displays information about the connections that are assigned to a specific path class, where code is a 1-character alphanumeric path class code.

ALL
displays information about all the MPIF connections.

Device
displays the information that is defined in the MPIF hardware table (HDW), which is contained in the DCTCWA DSECT.

Path
displays information about the paths that are defined for the MPIF resources.

Name-path
displays information about a specific MPIF path, where path is a 1- to 8-character alphanumeric path name.

Device-$device
displays information about the paths to a specific device, where $device is a 1- to 7-character alphanumeric generic device name that begins with the $ character.

Class-code
displays information about the paths that are assigned to a specific path class, where code is a 1-character alphanumeric path class code.

ALL
displays information about all the MPIF paths.

Status
displays the following status information about the MPIF resources:

SYstem
displays the following information about the MPIF system:

Additional Information

Examples

Information about the activity on the specified path is displayed in the following example, where:

 DEV-NAME 
is the name of the device.

 PATHNAME 
is the name of the path.

 CL 
is the path class.

 M-RATE 
is the message rate per second.

 MSGSIZE 
is the average number of bytes per message.

 READS 
is the number of read operations per second.

 WRITES 
is the number of write operations per second.

 QUEUED 
is the number of messages queued per second.

 OV-RUN 
is the number of queue overruns per second.
+--------------------------------------------------------------------------------+
|User:   ZMPIF DISP A,P-CPUC.A1                                                  |
|                                                                                |
|System: MPIF0017I 06.56.47 ACTIVITY INFORMATION                                 |
|        DEV-NAME PATHNAME CL M-RATE MSGSIZE READS  WRITES QUEUED OV-RUN         |
|        $CTOC03  CPUC.A1  A  0004.5    2099 0000.0 0001.0 004.50 0000.0         |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

Information about the C path class is displayed in the following example, where:

 CL 
is the path class.

 RBUFF 
is the read buffer size.

 WBUFF 
is the write buffer size.

 BLOCK 
specifies whether or not requests that are unrelated to the path class are blocked.

 LOADB 
specifies whether load balancing is performed or not.

 SHARED 
specifies whether the path can be shared or not.

 PROTECT 
specifies whether the last path in the path class is protected from being stopped or not when you enter the ZMPIF STOP command.
+--------------------------------------------------------------------------------+
|User:   ZMPIF DISP CL,CO-C                                                      |
|                                                                                |
|System: MPIF0032I 06.56.47 ACTIVE CLASS PARAMETERS                              |
|        CL RBUFF WBUFF BLOCK LOADB SHARED PROTECT                               |
|        C  30720 30720 YES   YES   YES    NO                                    |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

Information about the complex is displayed in the following example, where:

 NSYS 
is the maximum number of systems allowed in the complex.

 NUSER 
is the maximum number of users allowed in the complex.

 CONTIME 
is the timeout value, in seconds, for establishing connections.

 PATHTIME 
is the maximum time, in seconds, for an I/O event to end.

 SYSTEM 
is the timeout value, in seconds, for stalled paths.
+--------------------------------------------------------------------------------+
|User:   ZMPIF DISP COMP                                                         |
|                                                                                |
|System: MPIF0031I 06.56.47 ACTIVE COMPLEX PARAMETERS                            |
|        NSYS- 8 NUSER-   16 CONTIME-80 PATHTIME-81 SYSTIME-  82                 |
+--------------------------------------------------------------------------------+

Information about all the MPIF connections is displayed in the following example, where:

 MPIFUSER 
is the name of the user in the current system.

 STATUS 
is the user status, which can be:

 ACTIVE 
User is active.

 INACTIVE 
User is not active.

 DISC-REQ 
User is disconnecting.

 CONN-REQ 
User is establishing a connection.

 PATHNAME 
is the name of the path.

 CL 
is the path class.

 DEV-NAME 
is the name of the device.

 SYSTEM 
is the name of the connected system.

 CONUSER 
is the name of the user in the connected system.
+--------------------------------------------------------------------------------+
|User:   ZMPIF DISP C,ALL                                                        |
|                                                                                |
|System: MPIF0014I 06.56.47 ACTIVE CONNECTION PARAMETERS                         |
|        MPIFUSER STATUS   PATHNAME CL DEV-NAME SYSTEM   CONUSER                 |
|        MPIF     ACTIVE   CPUB.A1  A           CPUB     MPIF                    |
|        MPIF     ACTIVE   CPUB.B1  B           CPUB     MPIF                    |
|        MPIF     ACTIVE   CPUC.A1  A  $CTOC03  CPUC     MPIF                    |
|        IPC      ACTIVE   CPUC.A1  A  $CTOC03  CPUC     IPC                     |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

Information about all the MPIF devices is displayed in the following example, where:

 DEV-NAME 
is the name of the device.

 MOD 
is the model number of the device

 NL 
is the number of physical links defined for the device.

 SDA 
is the symbolic device address range for the device.

 STATUS 
is the status of the device, which can be:

 ACTIVE 
Device is started.

 INACTIVE 
Device is not started.

 CLASS 
is the path classes assigned to the device.
+--------------------------------------------------------------------------------+
|User:   ZMPIF DISP DEV                                                          |
|                                                                                |
|System: MPIF0019I 06.56.47 ACTIVE DEVICE PARAMETERS                             |
|        DEV-NAME MOD  NL    SDA    STATUS   CLASS                               |
|        $CTOC01  C    16 0900/090F ACTIVE   ABC                                 |
|        $CTOC02  C    16 0A00/0A0F ACTIVE   ABC                                 |
|        $CTOC03  2     4 0388/038B ACTIVE   ABC                                 |
|        $CTOC04  2     4 03A8/03AB ACTIVE   ABC                                 |
|        $CTOC05  2     8 1388/138F ACTIVE   ABC                                 |
|        $CTOC06  2    20 13A8/13BB ACTIVE   ABC                                 |
|        $CTOC07  2     4 238C/238F ACTIVE   ABC                                 |
|        $CTOC08  2     4 23B8/23BB ACTIVE   ABC                                 |
|        $CTOC09  2    20 33A4/33B7 ACTIVE   ABC                                 |
|        $CTOC10  2    20 43A0/43B3 ACTIVE   ABC                                 |
|        $CTOC11  2    16 53A0/53AF ACTIVE   ABC                                 |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

Information about the paths that are assigned to the A path class is displayed in the following example, where:

 PATHNAME 
is the name of the path.

 SYSTEM 
is the name of the system to which the path is connected.

 DEVICE 
is the device type, which can be:

 CTOC 
Channel-to-channel.

 MTOM 
Memory-to-memory.

 CL 
is the path class.

 CNT 
is the number of connections on the path.

 STATUS 
is the status of the path, which can be:

 ACTIVE 
Path is active.

 INACTIVE 
Path is not active.

 START-UP 
Path is being started.

 STOPPED 
Path is being stopped.

 DEV-NAME 
is the name of the device associated with the path.

 SDA 
is the symbolic device addresses (SDAs) of the read and write devices allocated to the path.
+--------------------------------------------------------------------------------+
|User:   ZMPIF DISP P,CL-A                                                       |
|                                                                                |
|System: MPIF0015I 06.56.47 ACTIVE PATH PARAMETERS                               |
|        PATHNAME SYSTEM  DEVICE CL CNT STATUS   DEV-NAME    SDA                 |
|        CPUB.A1  CPUB     MTOM  A  000 ACTIVE            0000/0000              |
|        CPUC.A1  CPUC     CTOC  A  001 ACTIVE   $CTOC03  0388/0389              |
|        CPUD.A1  CPUD     CTOC  A  000 INACTIVE          0000/0000              |
|        CPUE.A1  CPUE     CTOC  A  000 INACTIVE          0000/0000              |
|        CPUZ.A1  CPUZ     CTOC  A  000 INACTIVE          0000/0000              |
|        CPU0.A1  CPU0     CTOC  A  000 INACTIVE          0000/0000              |
|        CPU1.A1  CPU1     CTOC  A  000 INACTIVE          0000/0000              |
|        CPU2.A1  CPU2     CTOC  A  000 INACTIVE          0000/0000              |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

Status information about MPIF is displayed in the following example, where:

 SYSTEM NAME 
is the name of the system.

 VERSION 
is the version number of the cross-system interface.

 TRACE 
specifies whether the trace facility is on or off.
+--------------------------------------------------------------------------------+
|User:   ZMPIF DISP STAT                                                         |
|                                                                                |
|System: MPIF0016I 06.56.47 STATUS INFORMATION                                   |
|        SYSTEM NAME-CPUB        VERSION-   3                                    |
|        TRACE-OFF                                                               |
+--------------------------------------------------------------------------------+

Information about the MPIF system is displayed in the following example, where:

 NAME 
is the name of the system.

 NPATH 
is the number of active paths.

 NCONN 
is the maximum number of connections allowed in the system.

 NUSER 
is maximum number of users allowed in the system.

 NPAN 
is the number of path notification activation entries.

 NDNT 
is the number of directory notification entries.

 QDEPTH 
is the maximum queue depth.
+--------------------------------------------------------------------------------+
|User:   ZMPIF DISP SYS                                                          |
|                                                                                |
|System: MPIF0030I 06.56.47 ACTIVE SYSTEM PARAMETERS                             |
|        NAME-CPUB     NPATH-  23 NCONN-  11 NUSER-   8                          |
|        NPAN- 90      NDNT- 90   QDEPTH- 10                                     |
+--------------------------------------------------------------------------------+

Related Information

See TPF Multi-Processor Interconnect Facility Reference for more information about MPIF.