MPE/iX Commands Reference Manual (32650-90877)

Chapter 11 441
Command List IX
Commands RECALL/=RECALL thru RUN
purchased separately.
Syntax
RPGPREP[ textfile ] [,[ progfile ][,[ 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.
progfile The actual file designator of the program to which the prepared program
segments are written. When you omit progfile, the MPE segmenter creates
the program file, which resides in the temporary file domain as $OLDPASS.
If you do create your own program file, however, you must do so in one of
two ways:
• By using the MPE/iX BUILD command, and specifying a file code of 1029
or PROG, and a numextents value of 1. This file is then used by the PREP
command.
• By specifying a nonexistent file in the progfile parameter, in which case
a job or session file of the correct size and type is created. Default is
that $NEWPASS is assigned.
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 that is merged against textfile
to produce a composite sourcefile. This can be any ASCII input file. The
formal file designator is RPGMAST. Default is that master file is not read;
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 overwrite those in masterfile.
newfile The actual file designator of the file produced by merging the textfile and
the 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 the command (RPGTEXT, RPGLIST,
RPGMAST, and RPGNEW) cannot be backreferenced as actual file designators in
the command parameter list. For further information, refer to the "Implicit
FILE Commands for Subsystems" discussion of the FILE command.
Operation Notes
This command compiles and prepares an RPG program to a program file on disk. If you do
not specify textfile, MPE/iX expects the source program to be entered from your standard
input device. The USL file $OLDPASS, created during compilation, is a system-defined
temporary file passed directly to the MPE segmenter. You can access it only if you do not
use the $NEWPASS default for progfile. This is because the segmenter also uses $OLDPASS to