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

Chapter 3 93
NetIPC Intrinsics
IPCGIVE
IPCGIVE
Gives away a VC socket or call socket descriptor, making it available for
use by other processes.
Syntax
IPCGIVE ( descriptor , givename , nlen , flags , result )
Parameters
descriptor (input)
32-bit integer, by value. The VC socket or call socket
descriptor to be given away.
givename (input/output)
Character array, by reference. A name which will
be temporarily assigned to the specified socket. The
process which obtains the socket must request it by this
name. If the
nlen (name length) parameter is zero, an
8-character name is randomly assigned and returned in
the
givename parameter. If the name is supplied by
the user, it must be no longer than 16 characters.
nlen (input)
32-bit integer, by value. Length in bytes of the
specified name. If the value is zero, the NetIPC facility
will assign the name.
flags
32 bits, by reference. A bit representation of various
options. No flags are currently defined for this intrinsic.
result (output)
32-bit integer, by reference. The error code
returned; zero if no error.
Description
A process can invoke IPCGIVE to give away a VC socket or call socket
descriptor that it owns. Another process at the same node must then
“get” the descriptor in order to use it. For example, Process A at node X
can give away a VC socket descriptor. Process B, also at node X, may get
the descriptor and send data over the connection that Process A has
previously established with process C at node Z. Because Process B
“got” the endpoint of a previously established connection, it does not