TRCREX (Trace REXX)
Purpose
The Trace REXX (TRCREX) command allows the user to turn the REXX interpreter tracing feature on or off from the command entry level or from the CL programming level.
Optional Parameters
- SET
- Specifies the initial trace setting for the next REXX procedure that is run. This setting remains in effect unless changed through the REXX Trace instruction.
*RESULTS: All clauses are traced before processing. The final results of an expression evaluation are traced. The values that were assigned during the PULL, ARG, and PARSE instructions are also shown. Tracing operates as if the Trace instruction is issued from within the REXX procedure.
*ALL: All clauses are traced before processing. Tracing operates as if the Trace instruction is issued from within the REXX procedure.
*COMMANDS: All host commands are traced before processing and any error return code is shown. Tracing operates as if the Trace instruction is sent from within the REXX procedure.
*ERROR: Host commands resulting in an error return code are traced after processing. Tracing operates as if the Trace instruction is sent from within the REXX procedure.
*FAILURE: Host commands resulting in a failure are traced after processing with the return code from the command. Tracing operates as if the Trace instruction is sent from within the REXX procedure.
*INTERMEDIATES: All clauses are traced before processing. Intermediate results during evaluation of expressions and substituted names are also traced. Tracing operates as if the Trace instruction is sent from within the REXX procedure.
*LABELS: Labels passed during processing are traced. Tracing operates as if the Trace instruction is sent from within the REXX procedure.
*NORMAL: Failing host commands are traced after processing. Tracing operates as if the Trace instruction is sent from within the REXX procedure.
*OFF: Nothing is traced. Tracing operates as if the Trace instruction is sent from within the REXX procedure.
Examples for TRCREX
Example 1: Tracing Host Commands
TRCREX SET(*COMMANDS)This command causes all commands in by the REXX procedure to be shown before they are to be run.
Example 2: Tracing Failing Host Commands
TRCREX SET(*NORMAL)This command causes all commands that result in a FAILURE condition to be shown. This command shows the normal setting for the REXX tracing operation.
Error messages for TRCREX