MPE/iX Commands Reference Manual (32650-90877)

Chapter 11 447
Command List IX
Commands RECALL/=RECALL thru RUN
NOTE
This command follows the optional MPE/iX command line syntax. Refer to
"Optional Format for MPE/iX Commands" at the beginning of this chapter.
Parameters
textfile
Actual file designator of the input file from which the source program is
read. This can be any ASCII input file. Formal file designator is RPGTEXT.
Default is $STDIN.
progfile
Actual file designator of the program file to which the linked program is
written. When you omit
progfile
, the MPE/iX Link Editor creates the
program file, which is stored in the temporary file domain as $OLDPASS. If
you do create your own program file, you do so by specifying a nonexistent
file in the
progfile
parameter, in which case a job/session permanent file
of the correct size and type is created.
If you name an existing program file (file code = NMPROG), that file is
purged before the new one of the same name is created.
listfile
Actual file designator of the file to which the program listing is written.
This can be any ASCII output file. Formal file designator is RPGLIST.
Default is $STDLIST.
NOTE
The formal file designators used in this command (RPGTEXT and RPGLIST)
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
The RPGXLLK command compiles and links an RPG/XL program into a disk file. If you do
not specify
textfile
, RPG/XL expects your input from your standard input device. If you
do not specify
listfile
, RPG/XL sends the listing output to your current list device.
The object file created during compilation is a system-defined temporary file, $NEWPASS,
which is passed directly to the Link Editor as $OLDPASS. The Link Editor overwrites
progfile
and writes the linked program to $OLDPASS, if
progfile
is omitted, which can
then be executed.
NOTE
This command is implemented as a command file. If you set the HPPATH
variable to null (SETVAR HPPATH ""), the command file is not executed, and
the command fails.
Use
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 the RESUME
command continues the execution.