Guardian Procedure Calls Reference Manual

GETSYSTEMNAME Procedure (Superseded by
NODENUMBER_TO_NODENAME_ 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 GETSYSTEMNAME procedure supplies the system name associated with a system number.
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 := GETSYSTEMNAME ( sysnum ! i
,sysname ); ! o
Parameters
sysnum
input
INT:value
is the number of the system {0:254}; the name is returned in sysname.
sysname
output
INT:ref:4
returns the name of the system corresponding to 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:32767
The line handler exists and the specified system is accessible, but the line handler logical device number
exceeds 15 bits of magnitude.
or
The specified system is the local system, so there is no line handler logical device number to return.
672 Guardian Procedure Calls (G)