Contents | Index | < Browse | Browse >

---

TRACING OPTIONS:
---------------
Note: the keywords that select options can be shortened to one letter
for convenience:

ALL -all clauses traced
BACKGROUND -no tracing performed and program can't be forced into
interactive tracing
COMMANDS -command traced before being sent to external host.
Non-zero codes are displayed on the console.
ERRORS -command generating a non-zero return code are traced
after the clause is executed.
INTERMEDIATES -all clauses traced and intermediate results displayed
during expression evaluation.
LABELS -label clauses traced as executed. Label displayed each
time a transfer of control takes place.
NORMAL -the default. Command clauses with return codes higher than
current error failure level are traced after execution
and an error message is displayed.
OFF -off
RESULTS -all clauses traced before execution and the final result
of each expression is displayed.
SCAN -special option that traces all clauses and checks for
errors, but suppresses actual execution of statements.

TRACING PREFIX CODES:
--------------------
+++ Command or syntax error
>C> Expanded compound name
>F> Result of a function call
>L> Label clause
>O> Result of a dyadic operation
>P> Result of a prefix operation
>U> Uninitialized variable
>V> Value of a variable
>>> Expression or template result
>.> "Placeholder" token value

COMMAND INHIBITION
-special ARexx tracing mode that suppresses host commands; the clauses are
evaluated but not actually sent to the external host.
-may be used with any trace option. It is controlled by the "!" character,
which may appear by itself or may precede any of the alphabetic options
in a TRACE instruction. Each occurrence toggles the inhibition mode
currently in effect. Command inhibition is cleared when tracing is set
to OFF.

INTERACTIVE TRACING
-controlled by the "?" character, either by itself or in combination
with an alphabetic trace option. Each occurrence toggles the mode
currently in effect.
-eg. TRACE ?R