RPGXLLK [ MPE/iX Commands Reference Manual Volume I ] MPE/iX 5.0 Documentation
MPE/iX Commands Reference Manual Volume I
RPGXLLK
Compiles and links an RPG/XL program. RPG/XL is not part of the 900
Series HP 3000 Computer System Fundamental Operating Software and must be
purchased separately. This command is recognized only if RPG/XL is
installed on your system. (Native Mode)
Syntax
RPGXLLK [textfile][,[progfile][,[listfile]]]
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.
Examples
The following example compiles and links an RPG/XL program entered
through your standard input device and stores the linked program in the
file $OLDPASS. The listing is printed on your standard list device.
RPGXLLK
To compile and link an RPG/XL source program from the source file RPGSRC,
store it in RPGPROG, and send the listing to your standard list device,
enter:
RPGXLLK RPGSRC,RPGPROG
Related Information
Commands RPGXL, RPGXLGO
Manuals HP RPG/XL Programmer's Guide (30318-60001)
HP RPG/XL Reference Manual (30318-60002)
HP RPG Utilities Reference Manual (30318-60003)
MPE/iX 5.0 Documentation