HP 3000 Manuals

NRJEConsCheck [ SNA NRJE User/Programmer Reference Manual ] MPE/iX 5.0 Documentation


SNA NRJE User/Programmer Reference Manual

NRJEConsCheck 

Indicates outstanding host remote console messages whether any 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.

                  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. NRJEConsCheck is used with the following intrinsics: * NRJERcvMsg: to read one recent remote host console message. * NRJERelease: to relinquish ownership of the remote host console. Text Reference See the SNA NRJE Node Manager's Guide for the description of "Host Console Commands".


MPE/iX 5.0 Documentation