Product Site

2.29.1. Trace Alphabetic Character (Word) Options

Although you can enter the word in full, only the first capitalized letter is needed; all following characters are ignored. That is why these are referred to as alphabetic character options.

TRACE actions correspond to the alphabetic character options as follows:
All

Traces (that is, displays) all clauses before execution.
Commands

Traces all commands before execution. If the command results in an error or failure, tracing also displays the return code from the command.
Error

Traces any command resulting in an error or failure after execution, together with the return code from the command.
Failure

Traces any command resulting in a failure after execution, together with the return code from the command. This is the same as the Normal option.
Intermediates

Traces all clauses before execution. Also traces intermediate results during the evaluation of expressions and substituted names.
Labels

Traces method and routine invocations, internal subroutine calls, transfers of control because of the SIGNAL instruction, and labels passed during program execution. This is especially useful with debug mode, when the language processor pauses after each invocation or call.
Normal

Traces any failing command after execution, together with the return code from the command. This is the default setting, if not overridden using the ::OPTIONS directive.

For the default Windows command processor, an attempt to enter an unknown command raises a FAILURE condition. The CMD return code for an unknown command is 1. An attempt to enter a command in an unknown command environment also raises a FAILURE condition; in such a case, the variable RC is set to 30.
Off

Traces nothing and resets the special prefix option (described later) to OFF.
Results

Traces all clauses before execution. Displays the final results (in contrast with Intermediates option) of the expression evaluation. Also displays values assigned during PULL, ARG, PARSE, and USE instructions. This setting is recommended for general debugging.