DEBUG directive

Puts an implicit BREAK statement after the current statement and after every NSTATEMENTS subsequent statements, until an ENDDEBUG is reached.

Options

CHANNEL = scalar

Channel number; default 1

NSTATEMENTS = scalar

Number of statements between breaks; default 1

FAULT = string

Whether to invoke DEBUG only at the next fault (yes, no); default no

No parameters

Description

The straightforward use of DEBUG causes an immediate break, and then further breaks at regular intervals until you issue an ENDDEBUG statement. Alternatively, by setting option FAULT=yes, you can arrange for GenStat to continue until the next fault diagnostic, and then break. The interval before each further break is specified by the NSTATEMENTS option; by default, breaks take place after every statement.

During the breaks, GenStat takes statements from the channel specified by the CHANNEL option; by default they are taken from channel 1. Each individual break is terminated by an ENDBREAK, exactly like a break invoked explicitly by the BREAK directive.

Options: CHANNEL, NSTATEMENTS, FAULT.

Parameters: none.