HPlogo SNA NRJE Node Manager's Guide: HP 3000 MPE/iX Computer Systems > Chapter 6 Commands

CONSOLE

» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Glossary

 » Index

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.

Feedback to webmaster