RUN Command

The RUN command runs an mvBASIC program that has already been compiled with the COMPILE (or the BASIC) command.

Format

RUN filename progname [(options)]

Parameter(s)

filename

Name of the mvBASIC program file. This file often contains many mvBASIC programs, one program per file item.

progname

Item-ID of the program that you want to run.

options

Modifies the execution of the program. Enclose the options you select in a set of parentheses.

A

Aborts the program if an error occurs by inhibiting entry to the Debugger.

D

Enters the mvBASIC Debugger before program execution.

E

Forces the mvBASIC run-time package to enter the Debugger whenever an error occurs. The user must either accept the error by using the Debugger, or exit to TCL.

I

Inhibits initialization of the data area. This option should only be used with the CHAIN statement.

N

Suppresses automatic paging.

P

Sends program output to the printer.

S

Suppresses run-time warning messages.

 

NOTE

Rocket does not recommend using the I option. The I option is available to support old code (pre-EXECUTE statement). Any corruption of the workspace area causes problems if you try to use the I option. If using the I option causes problems, you should change the structure of your program (that is, use the EXECUTE statement).

Running an mvBASIC Program

The following example runs an mvBASIC program called COUNTER that resides in the BP program file, and sends program output to the printer:

> RUN BP COUNTER (P)

.

.

.