Use this command to do the following :
- Define a new path class
- Change an existing system, complex, or path class definition
- Display information about the MPIF system, complex, or path classes that
are defined for the next initial program load (IPL).
Requirements and Restrictions
- New and changed path class, complex, and system definitions do not take
effect until the next IPL.
- If you change a path class definition, the existing path definitions that
are assigned to that path class are not updated
automatically. You must do the following to redefine the path
definition:
- Enter the ZMPIF STOP command to stop the path.
- Enter the ZMPIF DELETE command to delete the path definition.
- Enter the ZMPIF DEFINE PATH command to redefine the path.
- You can define or change path class, complex, and system definitions only
after MPIF restart is completed successfully. Before and during MPIF
restart, you can use this command only to display information about the
definitions.
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
- Online help information is available for this command. To display
the help information, enter ZMPIF SET HELP.
- When you specify a value for the RBUFF and WBUFF parameters, consider the
following:
- If the value is not on a 2 KB boundary, MPIF automatically rounds up the
value to the nearest 2 KB boundary.
- The maximum valid value for these parameters are 63 488.
- For IPC, the minimum valid value for these parameters is 4096.
- If MPIF receives only single data records, the value of these parameters
indicates the actual number of data records that are received. In this
case, the maximum data size must fit in one of the standard TPF core block
sizes; for example, the 1055-byte core block.
- If blocking is used, the maximum number of data characters is received in
blocked format. You must account for the multisystem request block
(MSRB) size when determining the value for these parameters because an MSRB is
required for each distinct data message blocked to a MPIF staging
buffer.
- If you use the list format, the value of these parameters must include the
size of a standard TPF core block that is large enough to contain the list
that is provided.
- You can specify the parameters for this command in any order.
- To define a new path class, you must specify the CODE, RBUFF, and WBUFF
parameters.
- To change an existing path class definition, you must specify the CODE
parameter and any other parameters that you want to change.
- Enter ZMPIF SET CLASS (with no parameters) to display the path
classes that are defined for the next IPL.
- Enter ZMPIF SET COMPLEX (with no parameters) to display the
complex that is defined for the next IPL.
- Enter ZMPIF SET SYSTEM (with no parameters) to display the
system that is defined for the next IPL.
- To display the class definition for a specific path definition, specify
only the CODE parameter.
- To display information about the path classes that are currently defined,
enter ZMPIF DISPLAY CLASS,ALL.
- To display information about the complex that is currently defined, enter
ZMPIF DISPLAY COMPLEX.
- To display information about the system that is currently defined, enter
ZMPIF DISPLAY SYSTEM.
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.