TRACEMODE

Set Tracing Mode

This system variable gets the mode of tracing during a SETTRACE.

Syntax

TRACEMODE

Remarks

TRACEMODE is initially in “FULL” mode, printing each line as it is executed.

Doing a SET TRACEMODE “PARTIAL” prints each directive as it is executed.

This system variable is generally available starting with release level 8.2.

Starting with Thoroughbred Basic 8.3.0, SET TRACEMODE “SKIPCALLS” enables you to skip tracing CALLed routines. Those routines will be executed but you will remain in the main body of the program.

Starting with Thoroughbred Basic 8.3.0, SET TRACEMODE “SKIPGOSUBS” enables you to skip tracing GOSUB routines. Those routines will be executed but you will remain in the main body of the program.

The “DELAY=n” option is only active in “PARTIAL” mode. It will delay displaying trace lines.

Starting with Thoroughbred Basic 8.8.1, SET TRACEMODE “SHOWNAME” enables you to include the current program name in trace output.

Starting with Thoroughbred Basic 8.8.1, SET TRACEMODE “SKIPTRIGGERS” enables you to skip tracing for 3GL Trigger execution.

Starting with Thoroughbred Basic 8.8.1, SET TRACEMODE “NEVEREND” disables the ENDTRACE directive.

Starting with Thoroughbred Basic 8.8.1, SET TRACEMODE “CLEARFILE” enables you to truncate the file currently opened on the channel when using SETTRACE (channel). This allows tracing from a specific point or condition. This option may be used alone or with other options. This option is ignored for channel 0 unless FILE= has been specified.

Starting with Thoroughbred Basic 8.8.1 SET TRACEMODE “FILE=Filename” appends trace output to channel 0 to the specified Filename file. SETTRACE to other channels is not affected. Filename must include a complete path and is not enclosed in quotes. This option is ignored if file name does not exist.

Examples

00100 DIM A[2]; FOR I=0 TO 2; LET A[I]=I; NEXT I

In “FULL” (regular) mode, a SETTRACE just prints this line once for each iteration of the FOR/NEXT loop. However, in “PARTIAL” mode, the output is as follows:

-->00100 DIM A[2]
-->00100 FOR I=0 TO 2
-->00100 LET A[I]=I
-->00100 NEXT I
-->00100 LET A[I]=I
-->00100 NEXT I
-->00100 LET A[I]=I
-->00100 NEXT I

See also

SET TRACEMODE and SETTRACE directives

From the Thoroughbred Basic Language Reference, Volume III: R–Z, version 8.9.1. Open this page in the PDF