gtpo1mesOperations

ZSIPC ALTER-Alter System Interprocessor Information for MPIF/IPC

Use this command to change the interprocessor communications (IPC) control information, which includes counters, paths, the path class, and intervals.

Requirements and Restrictions

This command is valid only for Multi-Processor Interconnect Facility (MPIF) IPC users.

Format




COunts
resets all IPC counters to 0.

Paths maximum
sets the maximum number of paths between processors, where maximum is a 1- to 2-digit decimal value.
Note:
The maximum number of paths takes effect when the next initial program load (IPL) is performed.

CLass code
sets the path class that will be used by IPC, where code is the 1-character alphanumeric path class code that identifies the path class.
Note:
The new class designation takes effect when the next IPL is performed.

Intervals
modifies the current interval parameters or specifies new interval parameters.

TIme-seconds
is the 1- to 2-digit number of seconds for the IPC interval.
Note:
This value takes effect when the next IPL is performed.

TOut-intervals
is the 1- to 2-digit number of intervals that IPC waits for connections to be established to a destination processor before declaring a transmission failure. IPC returns the request to the sender.
Note:
This value takes effect when the next IPL is performed.

Restart seconds
is the number of seconds from 0-65 535, that IPC waits for connections to be established to all loosely coupled processors during restart. A 0 value indicates an infinite wait.
Note:
This value takes effect when the next IPL is performed.

Attention: Using this parameter could compromise the integrity of the loosely coupled complex.

Additional Information

Enter the ZSIPC DISPLAY command to display information about MPIF IPC.

Examples

All the IPC counters are set to 0 in the following example.

+--------------------------------------------------------------------------------+
|User:   ZSIPC ALTER COUNTS                                                      |
|                                                                                |
|System: SIPC0002I 13:22:21 COUNTS ZEROED                                        |
+--------------------------------------------------------------------------------+

The maximum number of paths between processors is set to 10 in the following example.

+---------------------------------------------------------------------------------------------+
|User:   ZSIPC ALTER PATHS 10                                                                 |
|                                                                                             |
|System: SIPC0006I 12:23:44 MAXIMUM NUMBER OF PATHS BETWEEN PROCESSORS ALTERED TO 10          |
+---------------------------------------------------------------------------------------------+

The path class used by IPC is set to C in the following example.

+--------------------------------------------------------------------------------+
|User:   ZSIPC ALTER CLASS C                                                     |
|                                                                                |
|System: SIPC0007I 14:21:33 IPC CLASS ALTERED TO C                               |
+--------------------------------------------------------------------------------+

The IPC interval is set to 10 and the number of intervals that IPC waits for connections to be established is set to 40 in the following example.

+--------------------------------------------------------------------------------+
|User:   ZSIPC ALTER INTERVALS TIME-10,TOUT-40                                   |
|                                                                                |
|System: SIPC0005I 11:42:57 INTERVALS SET                                        |
+--------------------------------------------------------------------------------+

The number of IPC intervals that IPC waits for connections to be established is set to 30 in the following example.

+--------------------------------------------------------------------------------+
|User:   ZSIPC ALTER INTERVALS TOUT-30                                           |
|                                                                                |
|System: SIPC0005I 11:42:57 INTERVALS SET                                        |
+--------------------------------------------------------------------------------+

The number of seconds that IPC waits for connections to be established to all loosely coupled processors during restart is set to 240 in the following example.

+--------------------------------------------------------------------------------+
|User:   ZSIPC ALTER RESTART 240                                                 |
|                                                                                |
|System: SIPC0008I 16:32:46 IPC RESTART TIMEOUT VALUE ALTERED TO 240             |
+--------------------------------------------------------------------------------+

Related Information

See TPF Main Supervisor Reference for more information about interprocessor communications.