HP 3000 Manuals HP 3000 Manuals
NRJESendCmd
Sends a remote host console command.
Syntax
______________________________________________________________
| |
| D LA I IA |
| NRJESendCmd ( ConsoleId, CmdBuffer, CmdLength, 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.
CmdBuffer An input logical array. The CmdBuffer array contains the remote host
console command text to be transmitted. The syntax of the command is
not checked by NRJE. The text of the command must meet the standards
of the host.
A remote host console command can be sent successfully but be in
error.
CmdLength An input integer variable. The CmdLength parameter contains the
number of characters in CmdBuffer. The maximum host console command
length is 80 characters for all supported host job entry subsystems.
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
Obtain the ConsoleId value by calling NRJEConsole first. The CmdBuffer
parameter must contain a valid remote host console command for your
workstation. The CmdLength parameter must contain the command length in
bytes. Use NRJESendCmd with the following intrinsics:
* NRJERcvMsg: to read one recent remote host console message.
* NRJEConsCheck: to determine whether any outstanding console messages
are waiting to be received.
* NRJERelease: to relinquish access to the remote host console.
After NRJESendCmd returns control to your program, test the first element
of Result.
Text Reference
See the SNA NRJE Node Manager's Guide for a description of "Host Console
Commands."