HP 3000 Manuals HP 3000 Manuals
BBXLCOMP Compiles an HP Business BASIC/XL program. HP Business BASIC/XL is not part of the 900 Series HP 3000 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 (32715-60002) HP Business BASIC/XL Reference Manual (32715-60001)