Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (L)
Guardian Procedure Calls Reference Manual—522629-013
8-10
LOCATESYSTEM Procedure (Superseded by
NODENAME_TO_NODENUMBER_ Procedure )
or
The specified system is the local system, so there is no line handler
logical device number to return.
In either case, the system number is returned in
sysnum.
0 The specified
system does not exist.
-1 All paths to the specified system are down.
-3 Bounds error occurred on
sysname or sysnum.
sysnum input, output
INT:ref:1
is the number of the system to be located unless you specify
sysname. If you
specify
sysname, then the system number that corresponds to sysname returns
into
sysnum.
sysname input
INT:ref:4
if present, specifies the name of the system to be located and causes the
corresponding system number to be returned in
sysnum.
Considerations
•
If the caller provides sysname, sysnum is returned the corresponding number, but
if the caller omits
sysname, the caller must supply sysnum.
•
If the sysname specified does not exist, sysnum is set to 255.
•
When retrieving a line handler logical device number that exceeds 15 bits of
magnitude:
LOCATESYSTEM 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 LOCATESYSTEM
with calls to NODENAME_TO_NODENUMBER_.
Example
LDEV := LOCATESYSTEM ( SYS^NUM , SYS^NAME );