NetIPC 3000/XL Programmer's Reference Manual (5958-8600)

64 Chapter3
NetIPC Intrinsics
Common Parameters
• byte length of the vectored data.
Native Mode
In native mode, the data location descriptor is 12-bytes long. It contains
two 2-byte fields and a 64-bit native mode address. The DST field is
unnecessary because DSTs do not exist in native mode. The three fields
in the native mode vectored data descriptor are:
• descriptor type (2-byte integer); in this field, only Type = 4 for NM
addressing is valid;
• byte length of the data;
• native mode address (64-bits long); this is a long pointer (in Pascal
terminology) to the data.
Example:
nm_address:= globalanyptr(addr(data));
DLEN Parameter
In both compatibility and native mode, the
dlen parameter indicates
the full length of the
data parameter. If the data are vectored, dlen
must give the total length of each data location descriptor, not the
length of the actual data buffer. For example, the length of a single or
double vectored descriptor would be 8 or 16 bytes in compatibility mode;
and 12 or 24 bytes for native mode.
Result Parameter
If a NetIPC (or Remote Process Management) intrinsic call is
successful, the
result parameter returns a value of zero. Otherwise the
value returned represents a NetIPC error code (SOCKERR). NetIPC error
messages are listed in Appendix A , “IPC Interpreter (IPCINT),”of this
manual. You can also obtain the corresponding error message by calling
IPCERRMSG.
NOTE When nowait I/O is used, the result parameter is not updated upon
completion of an intrinsic. Therefore, the value of
result only indicates
whether the call was successfully initiated. To determine if the call
completed successfully, you can use the IPCCHECK intrinsic immediately
afterward.
Condition Codes
On an HP 3000, NetIPC intrinsics cause MPE condition codes to be set.
CCE indicates successful completion, CCL indicates failure, and CCG is
either not used or represents a warning.