NetIPC 3000/XL Programmer's Reference Manual (5958-8600)
Table Of Contents
- 1 NetIPC Fundamentals
- 2 Cross-System NetIPC
- 3 NetIPC Intrinsics
- 4 NetIPC Examples
- A IPC Interpreter (IPCINT)
- B Cause and Diagnostic Codes
- C ErrorMessages
- D Migration From PTOP to NetIPC and RPM
- E C Program Language Considerations
116 Chapter3
NetIPC Intrinsics
IPCSEND
• data offset (code=8, length=2; 2-byte integer)
(input). Compatibility mode (CM) only. An offset in
bytes from the data parameter's address indicating
the actual beginning of the data. HP recommends
that you do not use data offset if data descriptors are
used to point to another location from which data
should be obtained.
• protocol flags (code=144, length=4; 4-byte buffer)
(input). This option contains 32 bits of
protocol-specific flags. The following flag is currently
defined:
— end-to-end acknowledgment (bit 18, input).
(X.25 only.) D bit will be set in the last X.25 data
packet corresponding to this message. When this
flag is set, IPCSEND waits to complete until
acknowledgment from the remote that the
complete message has been received. When the
connection is between two HP 3000’s running NS
X.25, the acknowledgment is made when the
remote IPC user has received the data.
— qualifier bit (bit 19, input). (X.25 only.) This flag
indicates to X.25 to set the Q bit in the packets
that contain this message.
— urgent data (bit 27, input). (TCP only). If set,
this bit will cause the data sent to be marked
urgent.
result
(output)
32-bit integer, by reference. The error code
returned; zero if no error.
NOTE
When nowait I/O is used, the
result
parameter is not updated upon
completion of IOWAIT. Therefore, the value of
result
will indicate only
whether the call was successfully initiated. To determine whether the
call completed successfully, you can use the IPCCHECK intrinsic after
IOWAIT completes.
Description
The IPCSEND intrinsic is used to send data on a connection. The only
required parameters are
vcdesc
,
data
, and
dlen
(option variable).
A set of addresses in the
data
parameter allows vectored data to be
gathered from multiple locations.
The value specified for the data offset option (compatibility mode only)
is relative to the data array. If data descriptors are used, specifying this
option will cause a portion of the descriptor to be passed over (the offset