HP 3000 Manuals HP 3000 Manuals
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.
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.
* NRJERcvMsg: to receive a host remote console message.
* NRJERelease: to relinquish control of the host remote console.
After NRJEConsole has returned control to your program, test the first
element of Result.
Text Reference
CONSOLE also obtains access to the host remote console. See the SNA NRJE
Node Manager's Guide for more information.