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

Chapter 3 99
NetIPC Intrinsics
IPCRECV
IPCRECV
Receives a response to a connection request, thereby completing a
connection, or receives data on an existing connection.
Syntax
IPCRECV ( vcdesc [, data ][, dlen ][, flags ][, opt ][ result ]
Parameters
vcdesc (input
32-bit integer, by value. The VC socket descriptor, a
number identifying the VC socket belonging to this
process through which the data will be received.
data (output)
Record or byte array, by reference. A buffer to hold
the received data or a list of data descriptors
(maximum of two) indicating where the data are to be
distributed. For programming in “C” language, see
Appendix E , “C Program Language Considerations.”
dlen (input/output)
32-bit integer, by reference. Gives the maximum
number of bytes you are willing to receive. For a
response to a connection request, this value must be 0
(or the parameter may be omitted). For actual data on
an established connection, the value must be between 1
and 30,000. The returned value indicates how many
bytes were actually received.
In one IPCRECV call, you can receive all the
accumulated data from one or more IPCSEND calls, but
you may also receive only part of the data “sent” in an
IPCSEND. In order to obtain the rest of the data, you can
issue another IPCRECV call.
flags (input/output)
32 bits, by reference. A bit representation of various
options. The following options are defined:
• flags [16] — no output (input). If nowait I/O is used
and this bit is set, the
flags parameter will not be
updated upon completion of this IPCRECV. This
allows a calling procedure to have a local
flags
parameter and still complete before the IPCRECV