Debug and Trace Facilities › Event Trace Facility (ETF) › Entering Arguments on the Command Line

Entering Arguments on the Command Line

ETFTRACE also allows you to enter arguments to the CLIST through TSO. When this format is used, no screen is displayed. You can enter the following arguments:

ON

Specifies to activate the ETF. When you omit the AUX parameter, the trace is activated in primary mode. The default is OFF.

OFF

Specifies to deactivate the ETF, the default.

AUX

Specifies to enable tracing and place it in auxiliary trace mode. This causes the DDNAME ETFAUXF to be allocated to a disk file, named tiupref.IEF.AUXTRACE.tiusufx. All registered events are written to this file for subsequent formatting. This parameter implies the ON parameter. If not specified, the default is to disable auxiliary tracing.

ETFINCL()

Specifies the events to be included in the trace data. The description and syntax of this option are the same as for entering it on screen.

ETFEXCL()

Specifies the events to be excluded in the trace data. The description and syntax of this option are the same as for entering it on screen.

ETFOPTS()

Specifies an option string to control the execution behavior of the trace facility. The description and syntax of this option are the same as for entering it on screen.

ETFTBLSZ()

Specifies the table size, in number of event entries. When omitted, and tracing is active, the default is 1024.

RESET

Resets all parameters to their default (OFF) state.

Example

TSO %ETFTRACE AUX ETFTBLSZ(128) ETFINCL('(1-5,7,9)')