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

Chapter 6 185
NRJE Manager Intrinsics
NRJEConsole
NRJEConsole
Obtains the host remote console of a workstation.
Syntax
BA D IA
NRJEConsole ( Wsid , ConsoleId , Result )
Parameters
Wsid An eight-character input byte array. The Wsid
parameter identifies your workstation. It must contain
a left-justified alphanumeric name beginning with a
letter. If the workstation identifier is less than eight
characters long, it must be followed by blanks.
ConsoleId An output double-word integer variable. The
ConsoleId parameter contains the console
identification used with the NRJEConsCheck,
NRJERcvMsg, NRJERelease, and NRJESendCmd
intrinsics.
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.
Description
Call NRJEConsole before NRJESendCmd, NRJERcvMsg, and NRJERelease.
NRJEConsole obtains access to the host remote console for a
workstation and returns
ConsoleId .
ConsoleId is used to identify the host remote console in these
intrinsics:
• NRJEConsCheck: to determine if any host remote console messages
are waiting to be received.
• NRJESendCmd: to transmit a host remote console command.