HP 3000 Manuals

BASICOMP [ MPE/iX Commands Reference Manual Volume I ] MPE/iX 5.0 Documentation


MPE/iX Commands Reference Manual Volume I

BASICOMP 

Compiles a compatibility mode BASIC/V program.  BASIC/V is not part of
the 900 Series HP 3000 Computer System Fundamental Operating Software and
must be purchased separately.

Syntax 

BASICOMP [commandfile][,[uslfile][,listfile]]

Parameters 

commandfile           Actual file designator of the input file from which
                      the BASIC/V compiler commands are read.  This can
                      be any ASCII input file.  Formal file designator is
                      BSCTEXT. Default is $STDINX.

uslfile               Actual file designator of the user subprogram
                      library (USL) file to which the object code is
                      written, which can be any binary output file with a
                      file code of USL or 1024.  Its formal file
                      designator is BSCUSL. If the uslfile parameter is
                      omitted, the object code is saved to the temporary
                      file $OLDPASS. If entered, this parameter specifies
                      that the file was created in one of four ways:

                         *   By using the SAVE command to save the
                             default USL file $OLDPASS, created by a
                             previous compilation.

                         *   By building the USL with the MPE segmenter
                             command BUILDUSL. Refer to the MPE Segmenter 
                             Reference Manual (30000-90011).

                         *   By creating a new USL file with the MPE/iX
                             BUILD command and a file code of USL or
                             1024.

                         *   By specifying a nonexistent uslfile 
                             parameter, thereby creating a permanent file
                             of the correct size and type.

listfile              Actual file designator of the file on which the
                      program listing is written.  This can be any ASCII
                      output file.  Formal designator is BSCLIST. Default
                      is $STDLIST.


NOTE The formal file designators used in this command (BSCTEXT, BSCUSL, and BSCLIST) 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 BASICOMP command compiles a program from a "fastsave" file generated by the BASIC/V interpreter. If a USL file is not specified, the BASIC/V compiler stores the object code in the default systemcdefined temporary file $OLDPASS, as shown in the second example, below. You may, however, build a USL file in the permanent file domain, then direct the BASIC/V compiler to store the object code in this file by naming the USL file in the BASICOMP command line. Refer to "Examples." 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 BASIC/V program MYPROG onto the USL named OBJECT, enter: BUILD OBJECT;CODE=USL BASICOMP, OBJECT $CONTROL USLINIT $COMPILE MYPROG $EXIT The above example builds the USL file, begins execution of the BASIC/V compiler and specifies the USL named OBJECT, initializes the USL, compiles the fastsave program named MYPROG, and then exits from the compiler. If you do not choose to build a USL file, the BASICOMP command compiles your program and stores the object code in the default USL file $OLDPASS. BASICOMP $COMPILE MYRUN $EXIT The above example begins execution of the BASIC/V compiler, accepts commands from $STDINX, and specifies $OLDPASS the USL output and $STDLIST for listing output. It compiles from the fastsave file named MYRUN into a USL named $OLDPASS, and then exits from the BASIC/V compiler. To run your program, enter: PREPRUN $OLDPASS Related Information Commands BASIC, BASICGO, BASICPREP Manuals BASIC/V Compiler Reference Manual (32103-90001) MPE Segmenter Reference Manual (32650-60026)


MPE/iX 5.0 Documentation