Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (N)
Guardian Procedure Calls Reference Manual—522629-013
10-43
NODENUMBER_TO_NODENAME_ Procedure
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.
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.
Consideration
If the value specified for nodenumber does not designate a node that is known to the
local system, an
error value of 18 is returned. In this case, the nodename parameter
returns a printable string such as “\255” showing the node number that was supplied as
input (provided that the number fits in seven characters).