RUN

Description

The RUN command starts a BASIC script or can be used to configure BASIC auto-run settings. RUN can have zero or one argument. Without an argument, the script is executed immediately.

Parameters

No Argument
Starts the currently loaded script

File Name
Starts the script which is stored in a without loading it into the internal flash memory. Thus, the script is executed temporarily. Remember that file names must be in the 8.3 format. See the particular meaning of the file name "temp_run.bas"  here.

WAIT
The BASIC script is executed immediately and the command interface is locked while the script is running. Commands can not be entered before the the BASIC script has terminated.

AUTO
The BASIC script is not executed immediately. Instead, the internal non-volatile auto-run flag is set. If the module is powered off and on or rebooted, the script is executed and runs in the background.

AUTOWAIT
The BASIC script is not executed immediately. Instead, the internal non-volatile auto-run flag is set. If the module is powered off and on or rebooted, the script is executed in exclusive mode, that is, the command interface is locked while the script is running.

MANUAL
The BASIC script is not executed, but the internal auto-run flag is cleared. This revokes any previous RUN AUTO or RUN AUTOWAIT commands.

Return Values

ERR_OK (0) if the command was accepted.
ERR_ALREADY_RUNNING (36) if the BASIC script is already active.
ERR_ARGUMENT (4) if the argument was none of the above keywords.

Example

RUN MANUAL 

Clears the autostart flag

RUN 

Executes the script immediately

Remarks

With exception of running a skript directly from a file (see above), a valid BASIC script must exist in Flash memory in order to be executed. See also the LOAD ([more) command.