Use this command to do the following:
- Define a new MPIF path
- Change an existing MPIF path definition
- Display information about the MPIF paths that are defined for the next
initial program load (IPL).
Requirements and Restrictions
- New and changed path definitions do not take effect until the next
IPL.
- You can define or change path definitions only after MPIF restart is
completed. Before and during MPIF restart, you can use this command
only to display information about the definitions.
- Enter the ZMPIF SET CLASS command before you define any MPIF paths for
that class.
- If your loosely coupled complex includes processors that are using a TPF
image with 32-way loosely coupled processor support and other processors that
are using images that do not include 32-way loosely coupled processor support,
be aware of the following:
- If the command is entered on a processor that does not include 32-way
loosely coupled processor support, any definitions that are entered must be
reentered when 32-way loosely coupled processor support is installed on the
processor.
- If the command is entered on a processor that includes 32-way loosely
coupled processor support, any definitions that are entered will be lost and
must be reentered if you fall back to a previous level of support on that
processor. If you restore 32-way loosely coupled processor support
after falling back to the previous level, the new definitions are also
restored.
Format
- Name-path
- is a 1- to 8-character alphanumeric path name.
- Note:
- You must specify this parameter when you define a new path or change an
existing path definition. The path name that you specify cannot already
be defined as a device name.
- System-sysname
- is the 1- to 8-character name of the system at the other end of the
path.
- Note:
- You must specify this parameter when you define a new path.
- Device
- specifies the path type, where:
- CTOC
- defines a channel-to-channel path.
- MTOM
- defines a memory-to-memory path.
- Class-code
- is a 1-character alphanumeric code that identifies the path class for the
device.
- STatus
- specifies the IPL status of the path, where:
- START
- allows physical links to be assigned immediately when you perform an
IPL.
- STOP
- does not allow physical links to be assigned when you perform an IPL until
you enter the ZMPIF START command for the path.
Additional Information
- Online help information is available for this command. To display
the help information, enter ZMPIF DEFINE HELP.
- You can define more than one path to a system as long as you use unique
path names for each path.
- You can specify the parameters for this command in any order.
- To define a new path, you must specify both the NAME and SYSTEM
parameters.
- To change an existing path definition, you must specify the NAME parameter
and any other parameters that you want to change.
- Enter ZMPIF DEFINE PATH (with no parameters) to display the
paths that are defined for the next IPL.
- To display the path definition for a specific path, specify only the NAME
parameter.
- To change the name of a path, enter the ZMPIF DELETE command to delete the
path and then enter the ZMPIF DEFINE PATH command to redefine the path.
- To display information about the paths that are currently defined, enter
ZMPIF DISPLAY PATH,ALL.
Examples
The following information is displayed in the examples:
- PATHNAME
- is the name of the path.
- DEVICE
- is the device type, which can be:
- CTOC
- Channel-to-channel.
- MTOM
- Memory-to-memory.
- SYSTEM
- is the name of the system to which the path is connected.
- CL
- is the path class.
- STATUS
- is the status of the path, which can be:
- START
- Physical links can be assigned immediately when an IPL is
performed.
- STOP
- Physical links cannot be assigned when an IPL is performed until the ZMPIF
START command is entered for the path.
The following example displays information about the paths that are defined
for the next IPL.
+--------------------------------------------------------------------------------+
|User: ZMPIF DEF PATH |
| |
|System: MPIF0001I 06.56.47 PATH PARAMETERS DEFINED |
| PATHNAME DEVICE SYSTEM CL STATUS |
| CPUB.A1 MTOM CPUB A START |
| CPUB.B1 MTOM CPUB B START |
| CPUC.A1 CTOC CPUC A START |
| CPUC.B1 CTOC CPUC B START |
| CPUC.C1 CTOC CPUC C START |
| END OF DISPLAY |
+--------------------------------------------------------------------------------+
A new path is defined in the following example.
+--------------------------------------------------------------------------------+
|User: ZMPIF DEF PATH,N-CTC001,SYS-TPF01,DEV-CTOC,CL-B,STATUS-START |
| |
|System: MPIF0001I 06.56.47 PATH PARAMETERS DEFINED |
| PATHNAME DEVICE SYSTEM CL STATUS |
| CTC001 CTOC TPF01 B START |
| END OF DISPLAY |
+--------------------------------------------------------------------------------+
The code for the path class of the device that was defined in the previous
example is changed from B to C in the following example.
+--------------------------------------------------------------------------------+
|User: ZMPIF DEF PATH,N-CTC001,CL-C |
| |
|System: MPIF0001I 06.56.47 PATH PARAMETERS DEFINED |
| PATHNAME DEVICE SYSTEM CL STATUS |
| CTC001 CTOC TPF01 C START |
| END OF DISPLAY |
+--------------------------------------------------------------------------------+
Related Information
See TPF Multi-Processor Interconnect Facility
Reference for more information about MPIF.