Guardian Procedure Calls Reference Manual (G06.25+)

Guardian Procedure Calls (R)
Guardian Procedure Calls Reference Manual—522629-013
13-51
REMOTEPROCESSORSTATUS Procedure
REMOTEPROCESSORSTATUS Procedure
Summary
Syntax for C Programmers
Syntax for TAL Programmers
Parameters
Considerations
Summary
The REMOTEPROCESSORSTATUS procedure supplies the status of processor
modules in a particular system in a network.
Syntax for C Programmers
•
CEXTDECS (via 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
Parameters
status returned value
INT(32)
returns 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.
#include <cextdecs(REMOTEPROCESSORSTATUS)>
__int32_t REMOTEPROCESSORSTATUS ( short sysnum );
status := REMOTEPROCESSORSTATUS ( sysnum ); ! i
Word [0] MSW 0D if the remote system is nonexistent or
unavailable
Word [1] LSW, bit mask:
1 the processor is up
0 the processor is down or nonexistent