RPG


RPG


Compiles an RPG/V program in Compatibility Mode. RPG/V is
not part of the 900 Series HP 3000 Computer System
Fundamental Operating Software and must be purchased separately. (CM)

SYNTAX


RPG [textfile][,[uslfile][,[listfile][,[masterfile][,[newfile]]]]


PARAMETERS


textfile The actual file designator of the input file from
which the source program is read. This can be any
ASCII input file. The formal file designator is
RPGTEXT. Default is $STDIN.

uslfile The actual file designator of the User Subprogram
Library (USL) file to which the object program is
written. This can be any binary input file with a
file code of USL or 1024. Its formal file
designator is RPGUSL. If the uslfile parameter is
omitted, the object code is saved to the temporary
file $OLDPASS. If entered, this parameter refers to
a file created in one of four ways

o By saving, with the MPE/iX SAVE command.
Default is the USL file created during a previous
compilation.

o By building the USL with the MPE Segmenter -
BUILDUSL command. (Refer to the MPE Segmenter
Reference Manual (30000-90011).

o By creating a new USL file with the MPE/iX
BUILD command and specifying a file code of USL
or 1024.

o By specifying a nonexistent uslfile parameter,
thereby creating a permanent file of the correct
size and type.

listfile The actual file designator of the file on which the
program listing is written. This can be any ASCII
output file. The formal file designator is RPGLIST.
Default is $STDLIST.

masterfile The actual file designator of the master file to be
merged against textfile to produce a composite
source. This can be any ASCII input file. The
formal file designator is RPGMAST. Default is that
the master file is not read, and input is read from
textfile, or from $STDIN if textfile is not
specified. If two files being merged have identical
line numbers, the lines from textfile or from $STDIN
will overwrite those in masterfile.

newfile The actual file designator of the file produced by
merging textfile and masterfile. This can be any
ASCII output file. The formal file designator is
RPGNEW. Default is that no file is written.

NOTE

The formal file designators used in this command (RPGTEXT, RPGUSL,
RPGLIST, RPGMAST, and RPGNEW) cannot be backreferenced as actual file
designators in the command parameter list. For further information,
refer to "IMPLICIT FILE COMMANDS FOR SUBSYSTEMS" discussion of the MPE
XL FILE command.


OPERATION

     This command compiles an RPG program onto a User Subprogram
Library (USL) file on disk. If you do not specify textfile,
MPE/iX expects input from your standard input device. If
you create the USL file before compiling the source code,
you must assign it a file code of USL or 1024.

This command may be issued from a session, job, or program. It may
not be used in BREAK. Pressing [Break] suspends the execution of
this command. Entering RESUME continues the execution.


EXAMPLE(S)

     The following example compiles an RPG program entered from
your standard input device, storing the object code in the
default USL file $OLDPASS. The listing is sent to the
standard list device.

RPG

The next example compiles an RPG program contained in the
disk file SOURCE. The object code is stored in the USL file
OBJECT, which is a permanent disk file created with the
BUILD command. The program listing is sent to the disk
file LISTFL.

BUILD OBJECT;CODE=USL
RPG SOURCE,OBJECT,LISTFL

To compile an RPG program, storing the object code in the
USL file OBJECT (created during the compilation process) enter

RPG SOURCE,OBJECT,LISTFL

ADDITIONAL INFORMATION

Commands:   RPGGO, RPGPREP

Manuals : MPE Segmenter Reference Manual (32650-60026)
RPG/3000 Compiler Reference Manual (32104-90001)