Calls Affecting the Remote Process [ Net IPC 3000/XL Programmer's Reference Manual ] MPE/iX 5.0 Documentation
Net IPC 3000/XL Programmer's Reference Manual
Calls Affecting the Remote Process
Table 2-2 lists the NetIPC calls affecting communication with the remote
process.
Table 2-2. Net IPC Calls Affecting the Remote Process
-------------------------------------------------------------------------------------------------
| | | | |
| HP 3000 | HP 1000 | HP 9000 | PC |
| | | | |
-------------------------------------------------------------------------------------------------
| | | | |
| IPCCONNECT | IPCConnect | ipcconnect() | IPCConnect |
| IPCDEST | IPCDest | ipcdest() | IPCDest |
| IPCLOOKUP | IPCLookUp | ipclookup() | not implemented |
| IPCRECV | IPCRecv | ipcrecv() | IPCRecv |
| IPCRECVCN | IPCRecvCn | ipcrecvcn() | IPCRecvCn |
| IPCSEND | IPCSend | ipcsend() | IPCSend |
| IPCSHUTDOWN | IPCShutDown | ipcshutdown() | IPCShutDown |
| | | | |
-------------------------------------------------------------------------------------------------
HP 3000 to HP 1000 NetIPC
The NetIPC calls affecting cross-system communication with the remote
process have the following differences: checksumming, send and receive
sizes, range of permitted TCP protocol addresses for users, and socket
sharing. Table 2-3 summarizes the cross-system considerations.
Table 2-3. Cross-System Calls (HP 3000-HP 1000)
--------------------------------------------------------------------------------------------
| | |
| NetIPC Call | Cross-System Considerations |
| | |
--------------------------------------------------------------------------------------------
| | |
| IPCCONNECT | Checksumming - TCP checksumming will be enabled for both sides of the |
| | connection if it is enabled by either side for HP 3000 to HP 1000 |
| | cross-system communication. On both the HP 3000 and HP 1000 |
| | checksumming can be enabled by setting bit 21 in the flags parameter. |
| | |
| | Send and receive sizes - The HP 3000 send and receive size range is 1 |
| | to 30,000 bytes. The HP 1000 send and receive size range is 1 to 8,000 |
| | bytes. For example, if the HP 3000 node sends 16,000 bytes, the HP |
| | 1000 node can call IPCRECV twice, receiving the first 8,000 bytes the |
| | first time and the second 8,000 bytes the second time. |
| | |
| | Note that the default send and receive sizes are different on different |
| | HP systems. On the HP 3000, the default send and receive size is less |
| | than or equal to 1,024 bytes. On the HP 1000 the default send and |
| | receive size is 100 bytes. |
| | |
--------------------------------------------------------------------------------------------
Cross-System Calls (HP 3000-HP 1000)(cont.)
--------------------------------------------------------------------------------------------
| | |
| NetIPC Call | Cross-System Considerations |
| | |
--------------------------------------------------------------------------------------------
| | |
| IPCCREATE | TCP protocol address - The recommended range of TCP addresses for |
| IPCDEST | cross-system user applications is from 30767 to 32767 decimal (%74057 |
| | to %77777). |
| | |
--------------------------------------------------------------------------------------------
| | |
| IPCLOOKUP | No differences that affect-cross-system operations. |
| | |
--------------------------------------------------------------------------------------------
| | |
| IPCRECV | Receive size ( dlen parameter) - Range for the HP 3000 is 1 to 30,000 |
| | bytes. Range for the HP 1000 is 1 to 8,000 bytes. Although the ranges |
| | are different, cross-system communication is not affected. If you |
| | specify a send or receive size, be sure it is within the correct range |
| | for the respective system. |
| | |
| | Data wait flag - The HP 1000 IPCRecv call supports a "DATA_WAIT" flag. |
| | This flag, when set, specifies that the call will not complete until |
| | the amount of data specified by the dlen parameter has been received. |
| | This flag is not available on the HP 3000, meaning that the call may |
| | complete before all the data is received. However, the HP 3000 IPCRECV |
| | supports other flags such as the "more data" and "destroy data" flags. |
| | Refer to the description of IPCRECV in Chapter 3 for more information. |
| | |
--------------------------------------------------------------------------------------------
| | |
| IPCRECVCN | Checksumming - TCP checksumming will be enabled for both sides of the |
| | connection if it is enabled by either side for HP 3000 to HP 1000 |
| | connections. On both the HP 3000 and HP 1000 checksumming can be |
| | enabled by setting bit 21 in the flags parameter. |
| | |
--------------------------------------------------------------------------------------------
| | |
| | Send and receive sizes - The HP 3000 send and receive size range is 1 |
| | to 30,000 bytes. The HP 1000 send and receive size range is 1 to 8,000 |
| | bytes. For example, if the HP 3000 node sends 16,000 bytes, the HP |
| | 1000 node can call IPCRECV twice, receiving 8,000 bytes the first time |
| | and the second 8,000 bytes the second time. |
| | |
| | Note that the default send and receive sizes are different on different |
| | HP systems. On the HP 3000, the default send and receive size is less |
| | than or equal to 1,024 bytes. On the HP 1000 the default send and |
| | receive size is 100 bytes. |
| | |
--------------------------------------------------------------------------------------------
| | |
| IPCSEND | Send size - The HP 3000 send size range is 1 to 30,000 bytes. The HP |
| | 1000 send size is 1 to 8,000 bytes. Although the ranges are different, |
| | cross-system communication is not affected. If you specify a send or |
| | receive size, be sure it is within the correct range for the respective |
| | system. Note that the urgent data bit is not supported on the HP |
| | 1000; however, if this bit is set by the HP 3000 program, it will be |
| | ignored by the receiving process on the HP 1000. |
| | |
--------------------------------------------------------------------------------------------
| | |
| IPCSHUTDOWN | Socket shut down - The HP 3000 provides a graceful release flag (flag |
| | 17)that is not available on the HP 1000. Donot set the graceful |
| | release flag on the HP 3000. Otherwise, the HP 1000 will not perform a |
| | normal shutdown. |
| | |
--------------------------------------------------------------------------------------------
HP 3000 to HP 9000 NetIPC
The NetIPC calls affecting cross-system communication with the remote
process have the following differences. Checksumming, send and receive
sizes, range of permitted TCP protocol addresses for users, and socket
sharing. Table 2-4 lists the NetIPC calls affecting the remote process
and summarizes the cross-system considerations.
Table 2-4. Cross-System Calls (HP 3000-HP 9000)
--------------------------------------------------------------------------------------------
| | |
| NetIPC Call | Cross-System considerations |
| | |
--------------------------------------------------------------------------------------------
| | |
| IPCCONNECT | Checksumming - When the ipcconnect() call is executed on the HP 9000 |
| | node, checksumming is always enabled. Therefore checksumming is always |
| | enabled for the HP 3000-to-HP 9000 connection. |
| | |
| | Send and receive sizes - The HP 3000 send and receive size range is 1 |
| | to 30,000 bytes. The HP 9000 send and receive size range is 1 to |
| | 32,767 bytes. Although the ranges are different, cross-system |
| | communication is not affected. If you specify a send or receive size, |
| | be sure it is within correct range for the respective system. |
| | |
| | Note that the default send and receive sizes are different on different |
| | HP systems. On the HP 3000, the default send and receive size is less |
| | than or equal to 1,024 bytes. On the HP 9000, the default send and |
| | receive size is 100 bytes. |
| | |
--------------------------------------------------------------------------------------------
| | |
| IPCCREATE | TCP protocol address - The recommended range of TCP addresses for |
| IPCDEST | cross-system user applications is from 30767 to 32767 decimal (%74057 |
| | to %77777). Addresses outside of this range require privileged mode |
| | access. |
| | |
--------------------------------------------------------------------------------------------
| | |
| IPCLOOKUP | No differences that affect cross-system operations. |
| | |
--------------------------------------------------------------------------------------------
| | |
| IPCRECV | Receive size ( dlen parameter) - Range for the HP 3000 is 1 to 30,000 |
| | bytes. Range for the HP 9000 is 1 to 32,767 bytes. Although the |
| | ranges are different, cross-system communication is not affected. If |
| | you specify a send or receive size, be sure it is within the correct |
| | range for the respective system. |
| | |
| | Data wait flag - The HP 9000 IPCRECV call supports a "DATA_WAIT" flag. |
| | This flag, when set, specifies that the call will not complete until |
| | the amount of data specified by the dlen parameter has been received. |
| | This flag is not available on the HP 3000, meaning that the call may |
| | complete before all the data is received. However, the HP 3000 IPCRECV |
| | supports other flags such as the "more data" and "destroy data" flags. |
| | Refer to the description of IPCRECV in Chapter 3 for more information. |
| | |
--------------------------------------------------------------------------------------------
Cross-System Calls (HP 3000-HP 9000)(cont.)
--------------------------------------------------------------------------------------------
| | |
| NetIPC Call | Cross-System considerations |
| | |
--------------------------------------------------------------------------------------------
| | |
| IPCRECVCN | Checksumming - When the ipcrecvcn() call is executed on the HP 9000 |
| | node, checksumming is always enabled. |
| | |
--------------------------------------------------------------------------------------------
| | |
| | Send and receive sizes - The HP 3000 send and receive size range is 1 |
| | to 30,000 bytes. The HP 9000 send and receive size range is 1 to |
| | 32,767 bytes. Although the ranges are different, cross-system |
| | communication is not affected. If you specify a send or receive size, |
| | be sure it is within the correct range for the respective system. |
| | |
| | Note that the default send and receive sizes are different on different |
| | HP systems. On the HP 3000, the default send and receive size is less |
| | than or equal to 1,024 bytes. On the HP 9000, the default send and |
| | receive size is 100 bytes. |
| | |
--------------------------------------------------------------------------------------------
| | |
| IPCSEND | Send size - The HP 3000 send size range is 1 to 30,000 bytes. The HP |
| | 9000 send size is 32,767 bytes. although the ranges are different, |
| | cross-system communication is not affected. If you specify a send or |
| | receive size, be sure it is within the correct range for the respective |
| | system. |
| | |
| | Note that the urgent data bit is not supported on the HP 9000; |
| | however, if this bit is set by the HP 3000 program, it will be ignored |
| | by the receiving process on the HP 9000. For differences in send and |
| | receive size see the discussion for IPCRECVCN. |
| | |
--------------------------------------------------------------------------------------------
| | |
| IPCSHUTDOWN | Socket shut down - The HP 3000 provides a graceful release flag that is |
| | not available on the HP 9000. If the graceful release flag ( flag 17) |
| | is set on the HP 3000, the HP 9000 will respond as though it were a |
| | normal shutdown. The HP 3000 does not support shared sockets; the HP |
| | 9000 does. Shared sockets are destroyed only when the descriptor being |
| | released is the sole descriptor for the socket. Therefore, the HP 9000 |
| | process may take longer to close the connection than expected. |
| | |
--------------------------------------------------------------------------------------------
HP 3000 to PC NetIPC
The NetIPC calls affecting cross-system communication with the remote
process have the following differences: checksumming, send and receive
sizes, range of permitted TCP protocol addresses for users, and socket
sharing. Table 2-5 lists the NetIPC calls affecting the remote process
and summarizes the cross-system considerations.
Table 2-5. Cross-System Calls (HP 3000-PC)
--------------------------------------------------------------------------------------------
| | |
| NetIPC Call | Cross-System Considerations |
| | |
--------------------------------------------------------------------------------------------
| | |
| IPCCONNECT | Checksumming - With PC NetIPC, the TCP checksum option cannot be turned |
| | on. But if the HP 3000 requires it, the TCP checksum is in effect on |
| | both sides of the connection. |
| | |
--------------------------------------------------------------------------------------------
| | |
| | Send and receive sizes - The HP 3000 send and receive size range is 1 |
| | to 30,000 bytes. The PC send and receive size range is 1 to 65,535 |
| | bytes. Although the ranges are different, cross-system communication |
| | is not affected. If you specify a send or receive size, be sure it is |
| | within the correct range for the respective system. For example, if |
| | the PC node sends 60,000 bytes, the HP 3000 node can call IPCRECV |
| | twice, receiving the first 30,000 bytes the first time and the second |
| | 30,000 bytes the second time. |
| | |
| | Note that the default send and receive sizes are different on different |
| | HP systems. On the HP 3000, the default send and receive size is less |
| | than or equal to 1,024 bytes. |
| | |
--------------------------------------------------------------------------------------------
| | |
| IPCCREATE | TCP protocol address - The recommended range of TCP addresses for |
| IPCDEST | cross-system user applications is from 30767 to 32767 decimal (%74057 |
| | to %77777). |
| | |
--------------------------------------------------------------------------------------------
| | |
| IPCRECV | Receive size ( dlen parameter) - Range for the HP 3000 is 1 to 30,000 |
| | bytes. The PC send and receive size is 1 to 65,535 bytes. Although |
| | the ranges are different, cross-system communication is not affected. |
| | If you specify a send or receive size, be sure it is within the correct |
| | range for the respective system. |
| | |
| | On the PC, you can specify the maximum receive size of the data buffer |
| | through the got array in the IPCCONNECT call. This determines what |
| | the maximum value for dlen can be for any IPCRECV call. PC NetIPC has |
| | no option array defined in IPCCONNECT. This does not affect |
| | cross-system communication. The maximum receive size of the data in |
| | the buffer on the HP 3000 will determine the receive size buffer on the |
| | PC. |
| | |
--------------------------------------------------------------------------------------------
Cross-System Calls (HP 3000-PC)(cont.)
--------------------------------------------------------------------------------------------
| | |
| NetIPC Call | Cross-System Considerations |
| | |
--------------------------------------------------------------------------------------------
| | |
| IPCRECVCN | Checksumming - With PC NetIPC, the TCP checksum option cannot be turned |
| | on. But if the HP 3000 requires it, the TCP checksum is in effect on |
| | both sides of the connection. |
| | |
| | Send and receive sizes - The HP 3000 send and receive size range is 1 |
| | to 30,000 bytes. The PC send and receive size range is 1 to 65,535 |
| | bytes. Although the ranges are different, cross-system communication |
| | is not affected. If you specify a send or receive size, be sure it is |
| | within the correct range for the respective system. For example, if |
| | the PC node sends 60,000 bytes, the HP 3000 node can call IPCRECV |
| | twice, receiving 30,000 bytes the first time and the second 30,000 |
| | bytes the second time. |
| | |
| | Note that the default send and receive sizes are different on different |
| | HP systems. On the HP 3000, the default send and receive size is less |
| | than or equal to 1,024 bytes. |
| | |
--------------------------------------------------------------------------------------------
| | |
| IPCSEND | Send size - The PC send and receive size range is 1 to 65,635 bytes. |
| | Although the ranges are different, cross-system communication is not |
| | affected. If you specify a send or receive size, be sure it is within |
| | the correct range for the respective system. |
| | |
| | On the PC, you can specify the maximum receive size of the data buffer |
| | through the got array in the IPCCONNECT call. This determines what |
| | the maximum value the dlen parameter can be for any IPCRECV call. PC |
| | NetIPC has no option array defined for IPCCONNECT. This does not affect |
| | cross-system communication. The maximum receive size of the data in |
| | the buffer on the HP 3000 will determine the receive size buffer on the |
| | PC. |
| | |
--------------------------------------------------------------------------------------------
| | |
| IPCSHUTDOWN | Socket shut down - The HP 3000 provides a graceful release flag that is |
| | not available on the PC. If the graceful release flag (flags 17) is set |
| | on the HP 3000, the PC will respond as though it were a normal |
| | shutdown. |
| | |
--------------------------------------------------------------------------------------------
MPE/iX 5.0 Documentation