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:
- Maximum number of systems allowed in the complex
- Maximum number of users allowed in the complex
- Timeout value for establishing connections
- Maximum time, in seconds, for an I/O event to end
- Timeout value for stalled paths.
- 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 name
- Interface version number
- Trace activity.
- SYstem
- displays the following information about the MPIF system:
- Name of the system
- Number of active paths
- Maximum number of connections allowed in the system
- Maximum number users allowed in the system
- Number of path notification activation entries
- Number of directory notification entries
- Maximum queue depth.
Additional Information
- Online help information is available for this command. To display
the help information, enter ZMPIF DISPLAY HELP.
- Enter the ZMPIF DEFINE or ZMPIF SET command to display information about
the resources that are defined for the next IPL.
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.