HPlogo MPE/iX Commands Reference Manual: HP 3000 MPE/iX Computer Systems > Chapter 2 Command Definitions A-B

BBXLCOMP
» 

Technical documentation

Complete book in PDF
» Feedback

 » Table of Contents

 » Index

spacerspacerspacer
spacer
spacer
  		 
 

Compiles an HP Business BASIC/XL program. HP Business BASIC/XL is not part of the HP 3000 Series 900 Computer System Fundamental Operating Software and must be purchased separately. (Native Mode)

Syntax

BBXLCOMP textfile [ ,[ objectfile] [ ,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 BASIC SAVE file (file code 1247 or BSVXL) containing the HP Business BASIC/XL program to be compiled. Formal file designator is BBCIN.

objectfile

Actual file designator of the object file to which the object code is written. This file is stored in binary form and has a file code of 1461 or NMOBJ. If your program uses GLOBAL COPTION RLFILE then this file is a binary file with a file code of 1033 or NMRL. Its formal file designator is BBCOBJ. If the objectfile parameter is omitted, the object code is saved to the temporary file $OLDPASS.

If you specify objectfile, the compiler stores the object file in a permanent file of the correct size and type, and with the name you specified.

For an NMOBJ file, if a file of the same name already exists, the object code overwrites that file.

For an NMRL file, if GLOBAL COPTION RLINIT is used, then the relocatable library file is overwritten. If GLOBAL COPTION RLINIT is not used, then the new object code is added but previously written information remains.

If the compiler issues an error message telling you that a new or existing object file is too small, build the object file with a larger size and recompile to it.

You may use the MPE/iX SAVE command to store $OLDPASS as a permanent file under another name.

listfile

The name of the file to which the compiler writes the program listing. This can be any ASCII file. The formal file designator is BBCLIST. If you do not specify listfile, the default is $STDLIST. $STDLIST is usually the terminal in a session or the printer in a batch job.

NOTE: The formal file designators used in this command (BBCIN, BBCOBJ, and BBCLIST) 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 BBXLCOMP command compiles a source program stored in a BASIC SAVE file generated by the HP Business BASIC/XL interpreter. The compiled program executes significantly faster than the corresponding interpreted version.

Create a BASIC SAVE program source file from within the HP Business BASIC/XL interpreter by entering the program and using the HP Business BASIC/XL interpreter >SAVE filename command. Compile the source program in filename with the BBXLCOMP command, then link with the MPE/iX LINK command, and execute the program with the MPE/iX RUN command.

NOTE: This command is implemented as a command file. If you set the HPPATH variable to null (SETVAR ""), 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

To compile the HP Business BASIC/XL source program in the file MYPROG into the NMOBJ file named OBJECT, enter:

  BBXLCOMP MYPROG,OBJECT

If you do not specify an NMOBJ file, the BBXLCOMP command compiles your program, storing the object code in the default file $OLDPASS.

  BBXLCOMP MYPROG

The above example runs the HP Business BASIC/XL compiler using the contents of MYPROG as the BASIC SAVE formatted source file. $OLDPASS is the default object file (NMOBJ) and $STDLIST is the default output listing.

If you now want to run your program, enter the LINK and RUN commands:

  LINK
  RUN $OLDPASS

This links the NMOBJ file and runs the program.

Related Information

Commands

BBXL, BBXLGO, BBXLLK

Manuals

HP Business BASIC/XL Migration Guide HP Business BASIC/XL Reference Manual



BBXL
  		 


BBXLGO  
Feedback to webmaster