SNA NRJE User/Programmer Reference Manual (30292-90006)

Chapter 6 183
NRJE Manager Intrinsics
NRJEConsCheck
NRJEConsCheck
Indicates whether any outstanding host remote console messages are
waiting to be received.
Syntax
D IA
NRJEConsCheck ( ConsoleId , Result )
Parameters
ConsoleId An input double-word integer variable. The
ConsoleId parameter is the remote host console
identification. Obtain the value for this parameter by
calling NRJEConsole before you call this intrinsic.
Result An eight-element integer output array. The Reply
array contains error codes which occurred during
execution of this intrinsic.
If no error took place, and a message is waiting, the
first element of the
Reply array is set to zero. If the first
element of
Reply= 97, no message was received.
The structure of the
Reply array is the same as the
Result array described in “Parameters Common to
NRJE Intrinsics,” in the introduction to Chapter 5 ,
“User Intrinsics.”
Always test the first word of
Reply to determine
whether any outstanding host remote console messages
are waiting to be received. The first word of
Reply is set
to zero if no error took place.
Description
Call NRJEConsCheck to indicate whether any outstanding host remote
console messages are waiting to be received. Obtain the
ConsoleId
value by calling NRJEConsole first. Test Reply to determine if messages
are waiting to be received.
NOTE The NRJEConsCheck intrinsic uses Reply as a message-waiting
indicator. Other NRJE intrinsics use the last formal parameter for
error indication only.
While you own the host remote console, you receive all recent host remote
console messages directed to your workstation. These messages may be
in response to commands other than those you issued.