Guardian Procedure Calls Reference Manual

LOCATESYSTEM Procedure (Superseded by
NODENAME_TO_NODENUMBER_ Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Returned Value
Considerations
Example
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development.
The LOCATESYSTEM procedure provides the system number corresponding to a system name and
returns the logical device number of the line handler controlling the path to a given system.
Syntax for C Programmers
This procedure does not have a C syntax, because it is superseded and should not be used for
new development. This procedure is supported only for compatibility with previous software.
Syntax for TAL Programmers
ldev := LOCATESYSTEM ( sysnum ! i,o
,[ sysname ] ); ! i
Parameters
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.
Returned Value
INT
Logical device number or related error value:
The logical device number of the network line handler that controls the current path to the system
designated by sysnum. The logical device number has at most 15 bits of magnitude and the specified
system is accessible.
1 : 32766
Indicates one of these error:32767
766 Guardian Procedure Calls (L)