gtpo1m9qOperations

ZMPIF SET-Set MPIF Parameters

Use this command to do the following :

Requirements and Restrictions

Format




CLass
defines a new path class, changes an existing path class definition, or displays the path class definitions for the next IPL.

Code-code
is a 1-character alphanumeric path class code that identifies the path class.

Rbuff-size
is the maximum size of the read staging buffer, where size is a 1- to 5-digit decimal number. The maximum value is 63 488.

Wbuff-size
is the maximum size of the write staging buffer, where size is a 1- to 5-digit decimal number. The maximum value is 63 488.

Block
specifies whether requests that are unrelated to the path class are processed or not.
Note:
You cannot override this parameter during cross-system startup processing to accommodate connecting to a system that cannot support blocking.

Loadb
specifies whether load balancing is performed for the path class or not.

Shared
specifies whether the path class can be shared by different MPIF users or not. If the path class is dedicated to one user, only one connection on each path in the path class is allowed.

Protect
specifies whether the last path in the path class is protected from being stopped or not when you enter the ZMPIF STOP command.

Complex
changes the existing complex definition or displays the complex definition for the next IPL.

Nsys-sysmax
is the maximum number of systems allowed in the complex, where sysmax is a 1- to 2-digit decimal number.

NUser-usrmax
is the maximum number of users allowed in the complex, where usrmax is a 1- to 5-digit decimal number.

Contime-time
is the timeout value, in seconds, for establishing connections, where time is a 1- to 2-digit decimal number.
Note:
The suggested value for this parameter is 30 seconds.

Pathtime-time
is the maximum time, in seconds, for an I/O event to end, where time is a 1- to 2-digit decimal number. This value is used to detect stalled paths.
Note:
The suggested value for this parameter is 3 seconds.

Systime-time
is the timeout value, in seconds, for stalled paths, where time is a 1- to 4-digit decimal number. This value should accommodate the time required to recover from a low core condition or to perform a recoverable system error dump, whichever is greater.
Note:
The suggested value for this parameter is 15 seconds.

SYstem
changes the existing system definition or displays the system definition for the next IPL.

Name-sysname
is the 1- to 8-character alphanumeric system name; for example, TPF.

NConn-conmax
is the maximum number of connections allowed in the system, where conmax is a 1- to 4-digit decimal number.

NUser-usrmax
is the maximum number of users allowed in the system, where usrmax is a 1- to 4-digit decimal number.

NPan-entries
is the number of path notification activation entries for the system, where entries is a 1- to 3-digit decimal number.

NDnt-entries
is the number of directory notification entries for the system, where entries is a 1- to 3-digit decimal number.

Qdepth-depth
is the send queue depth that determines when MPIF stops sending messages, where depth is a 1- to 3-digit decimal number.
Note:
The suggested value for this parameter is 6 messages.

Additional Information

Examples

The path class definitions for the next IPL are 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 requests that are unrelated to the path class are processed or not.

 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 SET CL                                                            |
|                                                                                |
|System: MPIF0006I 06.56.47 CLASS PARAMETERS SET                                 |
|        CL RBUFF WBUFF BLOCK LOADB SHARED PROTECT                               |
|        A  61440 61440 YES   NO    YES    YES                                   |
|        B   4096  4096 NO    YES   YES    NO                                    |
|        C  30720 30720 YES   YES   YES    NO                                    |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

A new path class is defined in the following example.

+--------------------------------------------------------------------------------+
|User:   ZMPIF SET CL,CO-E,RBUFF-4096,WBUFF-4096                                 |
|                                                                                |
|System: MPIF0006I 06.56.47 CLASS PARAMETERS SET                                 |
|        CL RBUFF WBUFF BLOCK LOADB SHARED PROTECT                               |
|        E   4096  4096 NO    NO    YES    NO                                    |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

The A path class definition is changed in the following example. Blocking is now performed in this path class.

+--------------------------------------------------------------------------------+
|User:   ZMPIF SET CL,CO-A,BLOCK-YES                                             |
|                                                                                |
|System: MPIF0006I 06.56.47 CLASS PARAMETERS SET                                 |
|        CL RBUFF WBUFF BLOCK LOADB SHARED PROTECT                               |
|        A  61440 61440 YES   NO    YES    YES                                   |
|        END OF DISPLAY                                                          |
+--------------------------------------------------------------------------------+

The complex definition for the next IPL is displayed in the following example, where:

 NSYS 
is the maximum number of systems that can be connected to the complex.

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

 CONTIME 
is the timeout value, in seconds, for establishing a connection.

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

 SYSTIME 
is the timeout value, in seconds, for stalled paths.
+--------------------------------------------------------------------------------+
|User:   ZMPIF SET COMP                                                          |
|                                                                                |
|System: MPIF0005I 06.56.47 COMPLEX PARAMETERS SET                               |
|        NSYS-10 NUSER-  100 CONTIME-80 PATHTIME-81 SYSTIME-  82                 |
+--------------------------------------------------------------------------------+

The current complex definition is changed in the following example. The maximum number of users is changed to 500.

+--------------------------------------------------------------------------------+
|User:   ZMPIF SET COMP,NUSER-500                                                |
|                                                                                |
|System: MPIF0005I 06.56.47 COMPLEX PARAMETERS SET                               |
|        NSYS-10 NUSER-  500 CONTIME-80 PATHTIME-81 SYSTIME-  82                 |
+--------------------------------------------------------------------------------+

The system definition for the next IPL is displayed in the following example, where:

 NAME 
is the name of the system.

 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 SET SYS                                                          |
|                                                                                |
|System: MPIF0004I 06.56.47 SYSTEM PARAMETERS SET                                |
|        NAME-CPUB     NCONN-  90 NUSER-  24 NPAN- 90 NDNT- 90 QDEPTH- 10        |
+--------------------------------------------------------------------------------+

The current system definition is changed in the following example. The maximum number of connections is changed to 100.

+--------------------------------------------------------------------------------+
|User:   ZMPIF SET SYS,NCONN-100                                                 |
|                                                                                |
|System: MPIF0004I 06.56.47 SYSTEM PARAMETERS SET                                |
|        NAME-CPUB     NCONN- 100 NUSER-  24 NPAN- 90 NDNT- 90 QDEPTH- 10        |
+--------------------------------------------------------------------------------+

Related Information

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