Guardian Procedure Calls Reference Manual

REMOTEPROCESSORSTATUS Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameter
Returned Value
Considerations
Summary
The REMOTEPROCESSORSTATUS procedure supplies the status of processor modules in a particular
system in a network.
Syntax for C Programmers
#include <cextdecs(REMOTEPROCESSORSTATUS)>
__int32_t REMOTEPROCESSORSTATUS ( short sysnum );
• CEXTDECS (through the included file TNSINTH) defines 32-bit values as the typedef
__int32_t, which for TNS and TNS/R compiles is defined as long and for TNS/E compiles
is defined as int.
Syntax for TAL Programmers
status := REMOTEPROCESSORSTATUS ( sysnum ); ! i
Parameter
sysnum
input
INT:value
is the number of a particular system in a network whose processor modules' status is returned.
Returned Value
INT(32)
Two words indicating the processor status.
The most significant word (MSW) is the highest processor number in the remote system plus one.
The least significant word (LSW) is a bit mask for processor availability. If LSW is all zeros, the
number of processors is not available and you should ignore any value in MSW.
MSW: highest processor number in the remote system + 1, or 0D if the remote system is nonexistent or
unavailable.
Word [0]
LSW, bit mask for processor availability: 1 if the processor is up; 0 if the processor is down or nonexistent.Word [1]
1236 Guardian Procedure Calls (R)