HPlogo MPE/iX Commands Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 6 Command Definitions P-R

RPGXLLK
» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

spacerspacerspacer
spacer
spacer
  		 
 

Compiles and links an RPG/XL program. RPG/XL is not part of the HP 3000 Series 900 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

HP RPG/XL Reference Manual

HP RPG Utilities Reference Manual



RPGXLGO
  		 


RUN  
Feedback to webmaster