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

Chapter 6 195
NRJE Manager Intrinsics
NRJERelease
NRJERelease
Relinquishes access to the host remote console of a workstation.
Syntax
D IA
NRJERelease ( 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 (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 NRJERelease to relinquish access to the host remote console a
workstation. Obtain the
ConsoleId value by calling NRJEConsole first.
Use NRJERelease with the following intrinsics:
• NRJEConsole: to obtain access to the host remote console.
• NRJESendCmd: to send host remote console commands.
• NRJEConsCheck: to determine whether any outstanding host
remote console messages are waiting to be received.
• NRJERcvMsg: to read one recent host console message.
These intrinsics are described in this chapter. After NRJERelease
returns control to your program, test the first element of
Result .