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

Chapter 3 95
NetIPC Intrinsics
IPCLOOKUP
IPCLOOKUP
Obtains a destination descriptor for a named call socket. Use with TCP
access only.
Syntax
IPCLOOKUP ( socketname , nlen [, location ][, loclen ][, flags ], destdesc
[, protocol ][, socketkind ][, result ])
Parameters
socketname (input)
Character array, by reference. The name of the
socket.
nlen (input)
32-bit integer, by value. The length in bytes of the
specified socket name. Maximum is 16.
location (input)
Character array, by reference. An environment ID
or node name indicating where the socket registry
search is to take place. The domain and organization
names which fully qualify the node/environment
designation are optional. If no location is specified, the
local socket registry is searched. This parameter can be
a maximum of 50 characters long.
loclen (input)
32-bit integer, by value. The length in bytes of the
location parameter. A zero value indicates that the
socket registry search is to take place on the local node.
flags (input)
32 bits, by reference. A bit representation of various
options. The only flag defined is: flags [0]. It causes the
destination descriptor to be “protected.” A protected
destination descriptor is one which only privileged
users may create or use.
destdesc (output)
32-bit integer, by reference. The returned
destination descriptor, which the calling process may
use to access the named socket as a destination. This
descriptor is required by the IPCCONNECT intrinsic.