Guardian Procedure Calls Reference Manual

MYSYSTEMNUMBER Procedure (Superseded by
NODENAME_TO_NODENUMBER_ Procedure or
PROCESSHANDLE_GETMINE_ Procedure and
PROCESSHANDLE_DECOMPOSE_ Procedure)
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Returned Value
Considerations
Summary
NOTE: This procedure is supported for compatibility with previous software and should not be
used for new development.
The MYSYSTEMNUMBER procedure provides a process with its own 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
sysnum := MYSYSTEMNUMBER;
Returned Value
INT
Caller's system number.
Considerations
• Part of network or local system
This IF (skeleton) statement determines if you are running on a network system.
IF NOT ( SYS^NUM := MYSYSTEMNUMBER ) THEN
! not on network system
If the caller is running in a local nonnamed system, MYSYSTEMNUMBER returns 0. Since 0
is a valid system number, a process wishing to determine the name of the system on which it
is running can use this call.
CALL GETSYSTEMNAME( MYSYSTEMNUMBER, NAME );
A return of all blanks in a name indicates that the system is not part of a network, or that it is
a local system which is not named.
844 Guardian Procedure Calls (M)