BBXLCOMP

Generated from C.60.01 /SYS/PUB/CICAT last modified on Thu Jan 11 09:18:52 2001

Back to Main Index


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. (NM)

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)

Back to Main Index