RPGXLLK



RPGXLLK

     Compiles and links an HP RPG/XL program.  HP RPG/XL is not part
of the 900 Series HP 3000 Computer system Fundamental Operating
Software and must be purchased separately.

SYNTAX

     RPGXLLK [textfile][,[progfile][,[listfile]]]

NOTE:

This command follows the optional MPE/iX command line syntax.

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 LinkEditor creates the program
file, which will be 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, RPGLIST)
cannot be backreferenced as actual file designators in the
command parameter list.

OPERATION

     The RPGXLLK command compiles and links an HP RPG/XL
program into a disk file. If you do not specify textfile,
HP RPG/XL expects your input from your standard input
device. If you do not specify listfile, HP 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 LinkEditor as $OLDPASS. The LinkEditor overwrites
progfile and writes the linked program to $OLDPASS, if
progfile is omitted, which can then be executed.

This command is implemented as a command file. If you set
the HPPATH variable to null (SETVAR HPPATH ""), the Command
File will not be executed, and the command will fail.

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 execution.

EXAMPLE(S)

     The following example compiles and links an HP RPG/XL
program entered through your standard input device and
stores the linked program in the file $OLDPASS. The listing
will be printed on your standard list device.

RPGXLLK

To compile and link an HP RPG/XL source program from
the source file RPGSRC, storing it in RPGPROG, and sending
the listing to your standard list device, enter

RPGXLLK RPGSRC,RPGPROG

ADDITIONAL INFORMATION

Commands:   RPGXL, RPGXLGO

Manuals :   HP RPG/XL Reference Manual (30318-60002)
            HP RPG/XL Utilities Reference Manual (30318-60003)
            HP RPG/XL Programmer's Guide (30318-60001)