Run

Execute a command file.

Format:

SPECTRA> run file_name[.gra] [arg1 [arg2...]]]

Description:

A two pass interpreter of control commands is invoked for file_name (coded by Th. Ohlow). For more explanations about control commands see sections 6. Examples of command files can be found in the section 6.1.

The completion status can be set with the END command. The function gra_status() returns the completion status.

If ctrl-c is pressed during the execution of a command file, SPECTRA returns control to the command line.

The run command can be used recursivly: Files may start other command files.

If an error occurs, it depends on the status of a flag whether the command execution is terminated:set run_error abort/noabort. If the user selected 'abort', control returns to the command line, no matter how deeply run commands are nested. The default is 'noabort'.

If the user detects a fatal condition somewhere during the execution of a command file, he can set set abort on. This has the effect that run terminates the execution and returns control to the command line and clears the abort flag.

If SPECTRA detects an error, it tries to continue the execution of the file, unless the command set run_error abort has been entered before. In this case it returns to the command line.

While executing a command file, SPECTRA does not log commands.

The arguments of the command file call are available through the variables verb and the arg() function. The number of arguments can be determined by n_arg().

/li$*$st[=list_file]

Writes the output of the interpreter to a disk file. The default ist file_name.lis.

/ti$*$me

The time that is used to run a file is measured. SPECTRA created the symbols run_ctime and run_etime which hold the cpu and elapsed time.