Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (G)
Guardian Procedure Calls Reference Manual—522629-013
6-29
GETSYSTEMNAME Procedure (Superseded by
NODENUMBER_TO_NODENAME_ Procedure )
The specified system is the local system, so there is no line handler
logical device number to return.
In either case, the system name is returned in
sysname.
0 The specified
system does not exist.
-1 All paths to the specified system are down.
-3 Bounds error occurred on
sysname.
sysnum input
INT:value
{0:254} is the number of the system; the name is returned in
sysname.
sysname output
INT:ref:4
returns the name of the system corresponding to
sysnum.
Considerations
When retrieving a line handler logical device number that exceeds 15 bits of
magnitude:
GETSYSTEMNAME uses the number 32767 to represent any logical device number
whose value exceeds 15 bits of magnitude. (The value 32767 is reserved and is never
used as an actual logical device number.) To retrieve logical device numbers having
more than 15 bits of magnitude, replace calls to GETSYSTEMNAME with calls to
NODENUMBER_TO_NODENAME_.
Example
LDEV := GETSYSTEMNAME( SYS^NUM ,SYS^NAME );