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

190 Chapter6
NRJE Manager Intrinsics
NRJERcvMsg
NRJERcvMsg
Reads one recent host remote console message.
Syntax
D LA I I IA
NRJERcvMsg ( ConsoleId , OutBuffer , MaxOutBuf , OutputLength , 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.
OutBuffer An output logical array. The OutBuffer array
contains the text of a host remote console message.
OutBuffer is a byte array, and the MaxOutBuf and
OutputLength parameters are byte counts.
NOTE The size of OutBuffer must be large enough to contain a host remote
console message. If
OutBuffer is not large enough, the message will be
truncated.
MaxOutBuf An input integer variable. The MaxOutBuf
parameter contains the maximum number of bytes that
can be put into
OutBuffer . 132 bytes is recommended.
OutputLength An output integer variable. The OutputLength
parameter contains the actual number of bytes of the
host remote console message contained in
OutBuffer .
Result An eight-element integer output array (required).
The
Result array contains error codes that occurred
during execution of this intrinsic.
The first element of the Result array is set to zero if no
errors took place. The structure of the
Result array is
described in “Parameters Common to NRJE Intrinsics”
in the introduction to Chapter 5 , “User Intrinsics.”
Always test the first element of
Result immediately
after you call this intrinsic. If the first element of
Result is not zero, test the other elements of Result to
determine the nature of the problem that has occurred.