NetIPC Common Parameters

The flags, opt, data, result, socketname, and nodename parameters are common to many NetIPC calls. The flags, opt, and result parameters are also common to the Remote Process Management (RPM) calls. RPM calls are explained in the •Remote Process Management" section in the NSARPA/1000 User/Programmer Reference Manual. These calls can be used to schedule remote NetIPC programs.

The opt parameter provides functionality for NetIPC and RPM calls; opt usually has data associated with it. The flags parameter enables or disables certain functions for NetIPC calls. The result parameter returns error codes for NetIPC calls. The socketname and nodename parameters identify sockets and nodes, respectively.

Refer to the NSARPA/1000 User/Programmer Reference Manual for detailed information on NetIPC calls and their parameters.

Flags Parameter

The flags parameter is a bit map of 32 special request bits. By setting bits in the flags parameter, you can invoke various services in some NetIPC calls.

NetIPC and RPM calls assume that the bits in the flags parameter are numbered from left to right with the most significant bit being one and the least significant bit being bit 32. In the NetIPC and RPM sections, whenever the flags parameter is discussed, bit one is the most significant bit:

MSB

 

 

 

 

1 2

3

4 5 6 ...

32

Pascal, NetIPC, and RPM

MSB

 

 

 

 

31 30

29 28 ...

0

FORTRAN

Opt Parameter

The opt parameter allows you to request optional services when invoking certain NetIPC and RPM calls. It enables calls that include the opt parameter to accept an arbitrary number of arguments that are either protocol or operating system specific. To help you distinguish between the opt parameter and a flag parameter, remember that the opt parameter is an array and usually has data associated with it.

Data Parameter

The data parameters reference data vectors or data buffers.

Result Parameter

Every NetIPC call has a result parameter. If an error occurs when a program uses a NetIPC call, an error code is returned to this parameter. The NSARPA/1000 Error Message and Recovery Manual lists and explains the NetIPC error codes.

Network Interprocess Communication 61