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

Chapter 3 97
NetIPC Intrinsics
IPCNAME
IPCNAME
Associates a name with a call socket descriptor.
Syntax
IPCNAME ( calldesc , socketname , nlen , result )
Parameters
calldesc (input)
32-bit integer, by value. The call socket descriptor to
be named.
socketname (input/output)
Character array, by reference. The name
(maximum of 16 characters) to be assigned to the
socket. 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. The length in bytes of the
specified socket name. Maximum is 16.
result (output)
32-bit integer, by reference. The error code
returned; zero if no error.
Description
The IPCNAME intrinsic allows a user to bind a name to a call socket.
Using the IPCLOOKUP intrinsic, another process can obtain access to the
socket by means of its name. A single call socket on an HP 3000 can
have a maximum of 4 names. VC sockets cannot be named. If the
specified name length is zero, an 8-character name will be randomly
generated and returned in the socketname parameter. When the socket
is destroyed, the name will be removed from the socket registry.
All parameters are required. Condition codes returned by this intrinsic
are:
• CCE — Succeeded.
• CCL — Failed.
• CCG — Not returned by this intrinsic.
This intrinsic cannot be called in split stack mode.