HP 3000 Manuals

The Interpreter [ HP Business BASIC/XL Reference Manual ] MPE/iX 5.0 Documentation


HP Business BASIC/XL Reference Manual

The Interpreter 

Typing the command BBXL in response to the operating system prompt will
run the interpreter.  You can use options to specify a file from which
input will be read or a file to which output will be written or both.
You can also use a file which contains commands to be executed by the
interpreter, called a command file.

Syntax 

     BBXL [cfile[,ifile[,ofile[,xlfile]]]]

Parameters 

cfile            Command file which can contain both commands and program
                 lines.  The command file cfile must be an ASCII file.
                 Its formal file name is BASCOM and its default
                 assignment is $STDINX.

ifile            HP Business BASIC/XL program input file which contains
                 data for INPUT statements.  The input file ifile must be
                 an ASCII file.  Its formal file name is BASIN and its
                 default assignment is $STDINX.

ofile            HP Business BASIC/XL program output file, that the PRINT
                 statement sends output to.  The output file ofile must
                 be an ASCII file.  Its formal file name is BASOUT and
                 its default assignment is $STDLIST.

xlfile           The xlfile parameter specifies one or more executable
                 libraries to the interpreter.  A single library may be
                 referenced by entering the fully qualified library file
                 name.  Two or more libraries may be referenced by
                 enclosing the list of libraries in quotes, separating
                 each name with commas, semicolons, or spaces.

Examples 

The first example below uses a command file called Command, and uses the
executable libraries Lib.Pub.Sys and Mylib in the log on group and
account.  The second example specifies an input file (Infil) and an
output file (Outfil).

     BBXL Command,,,"Lib.Pub.Sys,Mylib.!hpgroup.!hpacct"
     BBXL ,Infil,Outfil

HP Business BASIC/XL can also be run as a program using the following
syntax:

     RUN HPBBXL.PUB.SYS [;PARM=n]

The PARM option is used to specify two things to the interpreter:

   1.  How much space the interpreter should reserve for representing the
       currently-executing subunit.

   2.  Which of the BASCOM, BASIN, or BASOUT files has been respecified
       using a file equate.  n specifies which of the parameters have
       been redefined.  The following are the values of n:

       0       No redefinition of the files.

       1       BASCOM has been redefined.

       2       BASIN has been redefined.

       3       BASCOM and BASIN have been redefined.

       4       BASOUT has been redefined.

       5       BASCOM and BASOUT have been redefined.

       6       BASIN and BASOUT have been redefined.

       7       BASCOM, BASIN, and BASOUT have been redefined.

To set both of these parameters on the same run of the interpreter, add
the two values together and use their sum as the PARM value.

Consider the following two files (HELLO and RUNHELLO) in the following
example:

The HELLO file contains the HP Business BASIC/XL program:

     10 PRINT "HELLO"

The RUNHELLO file contains the commands:

     GET HELLO
     RUN
     EXIT

You can run the HELLO program by typing in the following command in
response to the operating system prompt:

     BBXL RUNHELLO

The commands in the RUNHELLO file are executed by HP Business BASIC/XL's
interpreter.  In response to the RUN command, "HELLO" is printed on the
terminal's screen.  Incorporating the command into a stream job has the
same effect.

Redirecting BASCOM, BASIN, and BASOUT is useful when running stream jobs.

Any of the file parameters can be specified by a local file equate
statement.

The HELLO program can be run by typing the following commands in response
to the operating system prompt or by including the commands in a stream
file, as illustrated below:

     FILE BASCOM = RUNHELLO
     RUN HPBBXL.PUB.SYS;PARM=1



MPE/iX 5.0 Documentation