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 must be met before you can issue the CONSOLE command successfully:

You must have NM capability or, if you do not have NM capability, this command must have been "allowed" by your node manager.
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. Here is an example:

CONS>$DA

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 (NMS) 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.
 
HP30245A.60.00 NRJE (C) HEWLETT-PACKARD CO. 1987
 
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 Chapter 6 “NRJE Manager Intrinsics”

CONSOLE

Technical documentation

» Table of Contents

» Glossary

» Index

Syntax

Description

Example

Text Reference