User Commands [ SNA NRJE User/Programmer Reference Manual ] MPE/iX 5.0 Documentation
SNA NRJE User/Programmer Reference Manual
Chapter 3 User Commands
Introduction
SNA NRJE is used to transmit and receive batch jobs between a workstation
and an IBM or IBM plug-compatible host system, and to control the
workstation. This chapter describes how to use NRJE to submit jobs and
receive data between a host system and an HP 3000 serving as a
workstation. It also describes how NRJE is used to perform the following
tasks:
* Display information about your jobs.
* Display information about the workstation.
* Alter the status of your jobs.
* Cancel your jobs.
Some user commands have NRJE manager extensions . You must be configured
with NM capability to use them.
Job Output
Output from a job is automatically received from a host whenever
communication is established between a workstation and a host. You do
not need to issue an NRJE subsystem command or related intrinsic to
receive your job output.
Job output can be directed to any output device that is supported by your
HP 3000. These include laser printers , line printers , and disc and
tape files . These devices can be spooled or non-spooled , but the
default output device for your workstation, as configured in the NMMGR
Workstation Data Page 2 screen, must be spooled. Control of the final
destination can be determined either at the time your job is submitted
for transmission to the host, or after the output has been returned from
the host. Chapter 4 describes job output, including the following:
* How to route job output.
* The relationship between SNA control codes and HP 3000 carriage
controls.
* The JCL to use for special forms processing.
* Directing output to an HP 268XX laser printer.
* How to relate host output classes and message classes (msgclass) with
logical writers by using JCL and host job entry subsystem commands.
Workstation Identification
Whenever you enter NRJE, you can identify a workstation to serve as the
default identifier for all subsequent subsystem commands. The following
is an example:
________________________________________________________________________________________
| |
| :NRJE RMT11 |
| |
| |
| This MPE command invokes NRJE for workstation RMT11.|
| |
| product number version number NJRE (C) HEWLETT-PACKARD CO. copyright year |
| |
| NRJE WELCOME MESSAGE |
| |
| The NRJE welcome message is configured by the |
| SNA node manager or provided by an NRJE manager. |
| |
| RMT11>SUBMIT infile |
| |
| The NRJE subsystem SUBMIT command prepares |
| infile for the default workstation, RMT11. |
| |
| JOB SUCCESSFULLY SUBMITTED. THE SPOOL FILE IS: |
| #O... |
| |
| NRJE sends you a message once the SUBMIT |
| command has completed. |
| |
| RMT11>... |
| |
| Other NRJE commands follow. |
| |
| RMT11>SUBMIT infile;WSID=RMT99 |
| |
| This NRJE subsystem SUBMIT command prepares |
| infile for workstation RMT99 even though the |
| default workstation is RMT11. |
| |
| JOB SUCCESSFULLY SUBMITTED. THE SPOOL FILE IS: |
| #O... |
| |
| NRJE sends you a message once the SUBMIT command |
| has completed. |
| RMT11>... |
| |
| Other NRJE commands follow. |
________________________________________________________________________________________
Both "Command Structure" and command descriptions in this chapter
describe how some NRJE subsystem commands can override the default
workstation identifier.
Access Methods
You can access NRJE two ways: interactively and programmatically.
Interactive access is through the NRJE subsystem command interpreter.
Use NRJE this way from your terminal or from a streamed job. Interactive
commands have a simple format and provide the most common parameter
values as defaults. As a convenience, abbreviations and a flexible range
of parameter values are supported.
Programmatic access allows your program to call NRJE intrinsics . Most
NRJE commands have a corresponding intrinsic so that, for example, the
submission of a large number of jobs can be done programmatically. This
access method can also be used to build an alternate subsystem command
interface for a workstation, or a background operator interface to a
workstation.
MPE Commands
When running NRJE interactively you can execute many MPE commands in the
middle of NRJE operations. Enter an MPE command preceded by a colon (:),
and the command will be passed to the MPE command interpreter. Many MPE
commands can be entered without preceding them with a colon, if they are
not members of the NRJE command set. The following is an example of how
to enter an MPE command:
__________________________________________________________________________________
| |
| RMT11>... Some NRJE command. |
| |
| RMT11>:LISTF List the file names in your logon group and account.|
| |
| RMT11>... Another NRJE command. |
__________________________________________________________________________________
You could have entered LISTF without preceding it with a colon, because
it is not an NRJE subsystem command.
Subsystem Command Limits
Each subsystem command is limited to 256 characters. If a command
requires more than one line, the command can be continued by ending the
line with an ampersand (&).
MPE/iX 5.0 Documentation