IPCLOOKUP

Obtains a path report descriptor.

IPCLOOKUP(socketname,nlen,nodename,nodelen,flags,pathdesc, protocol,socketkind,result)

socketname

Packed array of characters (Pascal); Integer

 

array (FORTRAN), by reference. An array containing

 

the ASCIIcoded name of the call socket to be •looked up."

 

Upper and lower case characters are not considered distinct.

nlen

32-bit integer, by value in Pascal, by

 

reference in FORTRAN. The length of the socket name in

 

characters. Maximum length is 16 characters.

nodename

Packed array of characters (Pascal); Integer

 

array (FORTRAN), by reference. A variable length

 

array of ASCII characters identifying the node where the socket

 

specified in the socketname parameter resides. The syntax of

 

the node name is node[.domain[.organization]],

 

which is further described in the NSARPA/1000

 

User/Programmer Reference Manual.

 

Default: You may omit the organization, organization and

 

domain, or all parts of the node name. When organization or

 

organization and domain are omitted, they will default to the

 

local organization and/or domain. If the nodelen parameter is

 

set to zero, nodename is ignored and the node name defaults

 

to the local node.

nodelen

32-bit integer, by value in Pascal, by

 

reference in FORTRAN. The length in bytes of the

 

nodename parameter. If this parameter is zero (0), the

 

nodename parameter is ignored and the node name defaults to

 

the local node. A fullyqualified node name length may be 50

 

bytes long.

flags

32-bit integer, by reference. A 32bit map of

 

special request bits. This parameter is reserved for future use.

 

All bits must be clear (set to zero).

pathdesc

32-bit integer, by reference. Path report

 

descriptor. Refers to the path report descriptor which indicates

 

the location of the named call socket. May be used in

 

subsequent NetIPC calls (IPCConnect, IPCName, IPCGive,

 

etc.).

protocol

32-bit integer, by reference. Identifies the

 

protocol module with which the •looked up" socket is

 

associated. May be used in an IPCCreate call to create a call

 

socket with the appropriate protocol binding.

socketkind

32-bit integer, by reference. Identifies the socket's

 

type.

result

32-bit integer, by reference. The error code

 

returned; zero if no error.

Network Interprocess Communication 611