Guardian Procedure Calls Reference Manual

NODENUMBER_TO_NODENAME_ Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Summary
The NODENUMBER_TO_NODENAME_ procedure converts a node number (system number) to
the corresponding node name (system name). It can also be used to obtain the name of the caller's
node.
Syntax for C Programmers
#include <cextdecs(NODENUMBER_TO_NODENAME_)>
short NODENUMBER_TO_NODENAME_ ( [ __int32_t nodenumber ]
,char *nodename
,short maxlen
,short *length
,[ __int32_t *ldevnum ] );
• CEXTDECS (through the included file TNSINTH) defines 32-bit values as the typedef
__int32_t, which for TNS and TNS/R compiles is defined as long and for TNS/E compiles
is defined as int.
Syntax for TAL Programmers
error := NODENUMBER_TO_NODENAME_ ( [ nodenumber ] ! i
,nodename:maxlen ! o:i
,nodename-length ! o
,[ ldevnum ] ); ! o
Parameters
nodenumber
input
INT(32):value
if present and not -1D, is the number of the node whose name is to be returned. If nodenumber
is omitted or -1D, the name of the caller's node is returned.
nodename:maxlen
output:input
STRING .EXT:ref:*, INT:value
returns the name of the specified node. If nodenumber is omitted, nodename returns the name
of the caller's node. maxlen specifies the length in bytes of the string variable nodename.
nodename-length
output
INT .EXT:ref:1
returns the length in bytes of the value returned in nodename.
872 Guardian Procedure Calls (N)