Guardian Procedure Calls Reference Manual

NODENAME_TO_NODENUMBER_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Summary
The NODENAME_TO_NODENUMBER_ procedure converts a node name (system name) to the
corresponding node number (system number). It can also be used to obtain the number of the
caller's node.
Syntax for C Programmers
#include <cextdecs(NODENAME_TO_NODENUMBER_)>
short NODENAME_TO_NODENUMBER_ ( [ const char *nodename ]
,[ short length ]
,__int32_t *nodenumber
,[ __int32_t *ldevnum ] );
The parameter length specifies the length in bytes of the character string pointed to by nodename.
The parameters nodename and length must either both be supplied or both be absent.
Syntax for TAL Programmers
error := NODENAME_TO_NODENUMBER_ ( [ nodename:length ] ! i:i
,nodenumber ! o
,[ ldevnum ] ); ! o
Parameters
nodename:length
input:input
STRING .EXT:ref:*, INT:value
specifies the name of the node whose number is to be returned. nodename must be exactly
length bytes long. If nodename is omitted or if length is 0, the number of the local node
is returned.
nodenumber
output
INT(32) .EXT:ref:1
returns the number of the specified node. If nodename is omitted or if length is 0,
nodenumber returns the number of the caller's node.
ldevnum
output
INT(32) .EXT:ref:1
returns the logical device number of the line handler to the specified node. If the specified node
is the local node, ldevnum returns 32767. If error is nonzero, ldevnum is undefined.
870 Guardian Procedure Calls (N)