HP 3000 Manuals

Defining Formal File Designators [ RJE User/Programmer Reference Manual ] MPE/iX 5.0 Documentation


RJE User/Programmer Reference Manual

Defining Formal File Designators 

The RJE subsystem uses four formal file designators to reference the
default values for the command file, input file, list file, and punch
file.  They are assigned values when RJE is invoked.  (Also refer to the
section on invoking RJE in Chapter 2, "Getting Started with RJE").  The
user can assign values to RJE's formal file designators when invoking RJE
with the MPE command:

     :RJE [command file,input file,list file,punch file]

The parameters in the :RJE command are positional parameters.  You must
supply them in the order shown above.  Use a comma in place of omitted
parameters if any parameters follow.

When a parameter is not specified with the :RJE command, the formal file
designators assume default values as follows:

* Command file:     $STDINX

* Input file:       $STDINX

* List file:        $STDLIST

* Punch file:       $OLDPASS (if it exists) or $NEWPASS (if $OLDPASS does
                    not exist).

You can also specify the input, list, and punch files in some RJE
commands (see Chapter 3, "RJE User Commands").  The input, list, and
punch file specifications in the :RJE command apply only when the
corresponding specification is omitted from an RJE command.  For example,
if you omit the output file reference from an #RJOUT command, the list
and punch files which you specified in the :RJE command will be used.

The examples below show you how to invoke RJE using default and
user-defined values for the :RJE command.  See the next section ("RJE
Process Parm Values") for invoking RJE with:  run RJE.PUB.SYS.

Using Actual File Designators in the :RJE Command 

Assume that ABC is the actual file designator for an existing disk file.
To define the command and input files as a single disk file (the file
ABC) and to use the default list and punch files issue the following :RJE
command:

     :RJE ABC,ABC

The files will then be defined as follows:

* Command file:     ABC

* Input file:       ABC

* List file:        $STDLIST

* Punch file:       $OLDPASS (if existing) or $NEWPASS (if no $OLDPASS)

The file ABC contains RJE commands and the input data sets.  Each #RJIN
command in file ABC must be immediately followed by the associated input
data set.

Using Logical Device Numbers and Device Classes in the :RJE Command 

You may invoke RJE so that the subsystem will use one or more logical
device numbers as default files.  To do this, equate the logical device
number to formal file designators, using the MPE :FILE command before you
issue the :RJE command.  For example, assume that at system generation
time 21 was defined as the logical device number of an interactive
terminal, 5 was defined as the logical device number of a card reader.
Also assume that LP and CP were defined as the device class names for all
system printers and card punches, respectively.  The necessary file
equations are as follows:

     :FILE CMND;DEV=21

     :FILE INPT;DEV=5

     :FILE LIST;DEV=LP

     :FILE PNCH;DEV=CP


NOTE You can use any formal file designators. CMND, INPT, LIST, and PNCH are used only for the purposes of this example.
Then, using asterisks and the formal file designators to refer to the previously stated file equations, issue the :RJE command: :RJE *CMND,*INPT,*LIST,*PNCH The files will then be defined as follows: * Command file: Logical device 21 * Input file: Logical device 5 * List file: The first available printer on the system * Punch file: The first available card punch on the system


MPE/iX 5.0 Documentation