SET TRACEWINDOW

SET TRACEWINDOW

Class

Error Handling and Debugging

Purpose

Enable or disable the use of trace windows

Syntax

SET TRACEWINDOW ON | OFF | (<expL>)

See Also

ACTIVATE WINDOW, DEFINE WINDOW, SET ERRORWINDOW, SET COMMANDWINDOW

Description

The SET TRACEWINDOW command is used to enable or disable the use of trace windows. A trace window is a window that automatically activates itself and displays each executing line of a currently running program. Trace windows are specified by including the TRACE keyword with the DEFINE WINDOW command. A window is an area of the screen designated for output and input. There is no limit to the number of windows you may define. Windows are defined with the DEFINE WINDOW command, and are activated with the ACTIVATE WINDOW command.

To display lines of the executing program, a trace window requires the following command settings: SET COMPILE OFF, SET HISTORY ON, SET DOHISTORY ON. When SET TRACEWINDOW is ON, trace windows are automatically activated when a program is run. When SET TRACEWINDOW is OFF, trace windows do not activate or display when programs are run.

Example

// Entered interactively
set compile off
set history on
set dohistory on

// In program file
define window debug;
from 15,01 to 22,78;
trace
set tracewindow on

do progname

Products

Recital Terminal Developer