BBXLCOMP



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.

SYNTAX

     BBXLCOMP textfile[,[objectfile][,listfile]]

NOTE

This command follows the more flexible MPE/iX command line syntax.

PARAMETERS

textfile            Actual file designator of the BASIC SAVE file (file
code=1247 or BSVXL) containing the 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 will store
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 will overwrite 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 you are trying to
compile to is too small, you will have to 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 MPE/iX FILE command.

OPERATION

     The BBXLCOMP command compiles a source program stored in a BASIC
SAVE file generated by entering the program using the BASIC/XL
interpreter and creating the file by using the >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.

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

EXAMPLE(S)

     To compile the 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 ** Runs BASIC/XL compiler using the **
** contents of MYPROG as the BASIC SAVE **
** formatted source file. $OLDPASS is **
** the default object file, and $STDLIST**
** is the default output listing. **

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

LINK ** Links the NMOBJ file **
RUN $OLDPASS ** Runs the program **

NOTE

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.

ADDITIONAL INFORMATION

Commands:   BBXL, BBXLGO, BBXLLK

Manuals :   HP Business BASIC/XL Migration Guide (32715-60002)
            HP Business Basic/XL Reference Manual (32715-60001)