Syntax:

TRACE <filename>

TRACE ON

TRACE OFF

Description:

Causes a trace listing of every line executed to be written to a specified file for subsequent analysis.

TRACE <filename> must be the first TRACE command to be executed. This specifies the name of the file to contain the trace listing.

TRACE ON turns tracing on.

TRACE OFF turns tracing off.

The output is in the format: line number, value of OK, contents of the line executed. The result of a variable assignment or the result of a conditional command (where this results in a jump in execution) is shown on the next line.

Note: Because the compiled program contains tokens instead of the full names of commands, functions and variables, the trace listing itself is not very readable, and is best read in conjunction with the original source files and the map file created when the program was compiled.

See also: