HP 3000 Manuals HP 3000 Manuals
CONSOLE
Obtains access to the host remote console of a workstation.
Syntax
_____________________________________________________________________________
| |
| CONSOLE |
_____________________________________________________________________________
Description
This command obtains access to the host console of a workstation. While
you have access to the console, the console mode prompt that you have
configured for the workstation is displayed on the screen in place of the
usual NRJE prompt. (The console mode prompt is configured in the NRJE
Configuration: Workstation Data screen.)
The following conditions are necessary for this command to be issued
successfully:
* You must have NM capability, or if you do not have NM capability,
this command must have been "allowed" on the NRJE Configuration:
Workstation Data screen.
* The communications line for your workstation must be open; the
workstation must be connected to the host job entry subsystem.
* The console facility must be free or available. Up to 28 users can
access the console simultaneously.
Note that since you cannot specify a Wsid in this command, you can obtain
access to the console of the default workstation only.
Once you can access the console, you can enter host console commands.
Each of these commands must begin with the configured host command prefix
character configured on the NRJE Configuration: Workstation Data screen.
For example,
CONS>$DA
where CONS> is the console mode prompt configured for the workstation,
and $DA is a JES2 host command. (The $ is the host command prefix
character.)
NOTE NRJE does not check the host console command syntax. NRJE simply
sends all the text you entered, including the host console command
prefix, to your host as a console command.
If you are connected to a VSE/POWER host, the host console command
prefix is required before each command, but by host system
requirement, it is stripped off before transmission.
While you have access to the console, you receive all console messages
issued by the host. So, you can receive console messages in response to
your own commands, as well as messages in response to commands by other
users. You also receive all other output sent by the host to the remote
console. This includes host "Job Received" messages sent by some host
systems when a job is received from a remote workstation. NRJE writes
this output to your job or session output device, $STDLIST.
Node Management Services can also log messages (CLAS0013 in SUB0002) sent
to the host remote console of your workstation. If no user has access to
the console, you can retrieve a lost message by using the Node Management
Services utility program NMDUMP. See the SNA Link Services Reference
Manual (for MPE V) or Using the Node Management Services Utilities (for
MPE XL) for more information about this utility.
If you currently have access to the console and no longer need it, issue
a RELEASE command. That command terminates your access to the console
and frees that facility for use by other users.
Example
________________________________________________________________________________
| |
| :NRJE RMT11 Enter the NRJE subsystem with RMT11 as the |
| default workstation. |
| |
| ProductNum VersionNum NRJE (C) HEWLETT-PACKARD CO. CopyrightYear |
| |
| WELCOME TO NRJE |
| |
| RMT11> ... Execute subsystem commands. |
| |
| RMT11>CONSOLE Acquire the console. |
| |
| CON11> ... Execute other subsystem commands from the |
| configured console mode prompt. |
| |
| CON11>$DA Issue a host remote console command, with the|
| configured host command prefix character. |
| Output messages related to this command might|
| not return immediately. |
| |
| CON11> ... Execute subsystem commands. |
| |
| CON11>RELEASE Relinquish ownership of the console. |
| |
| RMT11> ... Remote workstation prompt is returned. |
________________________________________________________________________________
Text Reference
Programmatic access to the host remote console is provided by these
manager intrinsics:
* NRJEConsole: obtains access to the console.
* NRJESendCmd: transmits a console command.
* NRJEConsCheck: determines whether any outstanding host remote
console messages are waiting to be received.
* NRJERcvMsg: receives a console message.
* NRJERelease: relinquishes access to the console.
These intrinsics are described in the SNA NRJE User/Programmer Reference
Manual.