gtpo1m9kOperations

ZMPIF DEFINE PATH-Define a MPIF Path

Use this command to do the following:

Requirements and Restrictions

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

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.