>>-TS----------------------------------------------------------><

TS (Trace Start) is an immediate command you can use to start tracing REXX execs. Tracing lets you control the execution of an exec and debug problems. The TS immediate command is available if an exec is running in TSO/E and you press the attention interrupt key to enter attention mode. You can enter TS in response to the REXX attention prompting message, IRX0920I. The exec continues processing and tracing is started.

TS is also a TSO/E REXX command you can use in a REXX exec that runs in any address space. That is, TS is available from the TSO and MVS™ host command environments.

In TSO/E foreground, trace output is written to the terminal. In TSO/E background, trace output is written to the output stream, SYSTSPRT. In non-TSO/E address spaces, trace output is written to the output stream as defined by the OUTDD field in the module name table (see page Module name table). The system default is SYSTSPRT.

To end tracing, you can use the TRACE OFF instruction or the TE immediate command. You can also use TE in the exec to stop tracing at a specific point. If you are running in interactive debug, you can use TE without entering attention mode to end tracing.

For more information about tracing, see the TRACE instruction on page TRACE and Debug aids.

Example

You are running an exec in TSO/E and the exec is not processing correctly. To start tracing the exec, press the attention interrupt key. The system issues the REXX attention prompting message that asks you to enter either a null line to continue or an immediate command. Enter TS to start tracing.