Debug and Trace Facilities › Event Trace Facility (ETF) › Selecting an Options Screen

Selecting an Options Screen

Execute the ETFTRACE CLIST by typing TSO %ETFTRACE on the command line on CA Gen panels.

Use the following fields on the Set CA Gen Event Trace Facility Environment Variable Screen to specify various options to control the execution of the trace facility:

Activate Trace

Specifies Y to turn on the trace or N (the default) to turn it off.

Size of Trace Table

Specifies the size, in number of events that can be recorded, of the primary trace table, or the buffer size for auxiliary tracing.

The value must be a positive integer, zero, or from 32 through 99,999 inclusive. If the value is zero, the ETF facility is disabled. A non-zero value causes the trace facility to allocate a table large enough to contain the specified number of events.

A non-zero value less than 32 is rounded up to 32. If a non-zero value results in a table that exceeds a segment of memory on the executing platform, the number is adjusted down to the largest number that does not exceed a segment (on Windows or MS/DOS a segment is 64K; on z/OS, 1M).

Auxiliary Trace

Specifies Y to create an auxiliary trace or N (the default) to deactivate this option.

ETFINCL (see note)

Specifies the events to be recorded to the ETF. By default, all events are recorded. The actual operation of this option depends on the value for ETFEXCL.

ETFEXCL (see note)

Specifies the events that are NOT to be written to the trace table, or the auxiliary trace file, depending upon the conditions. By default, no events are excluded. The actual operation of this option depends on the value for the ETFINCL option.

ETFOPTS (see note)

Used to specify keyword runtime options to control execution of the ETF. DO NOT specify options unless directed to do so by a Technical Support technician. The technician indicate which options to set to avoid adverse effects on performance, storage requirements, and costs.

Separate the keywords with commas. You also prefix keywords with NO to negate their effect. The supported keywords are:

• SIGNAL (default) and NOSIGNAL
• EXIT and NOEXIT (default)
• GEN and NOGEN (default)
• SYMBOL and NOSYMBOL (default)
• FLUSH and NOFLUSH (default)

Note: For these options to be activated, the Activate Trace field must be set to Y, and the Size of Trace Table field must contain a value for an auxiliary trace buffer area.

When the ETFINCL, ETFEXCL, or both options are defined, their actual behavior depends on which ones are specified:

• When both are undefined, the default is to include all defined events.
• When only the include variable is defined, only the events that are listed on the include variable are registered. All others are implicitly excluded.
• When only the exclude variable is defined, all events are implicitly registered except those listed on the exclude variable.
• When both are defined, the intersection of the two sets that are defined by these variables is used to determine which events are registered. All others are implicitly excluded.

The syntax of the ETFINCL and ETFEXCL values is the same, and allows for a single event, list of events, a range of events, or a combination of lists and ranges:

• When a single event is specified, only the event ID need be entered (and no parentheses are required). For example, ETFEXCL=3.
• When a list of discrete IDs are being entered, separated them with commas and enclosed in parentheses. For example, ETFEXCL=(1,3,5).
• A range of IDs is specified by using a dash or hyphen, indicating a from-to ordering. For example, ETFEXCL=(1-5) is valid, representing event IDs 1 through 5, inclusive.
• Lists and ranges can be combined, where each range occupies a member of the list. For example, ETFEXCL=(1,3-5,7,9-13,15).

Note: The ID numbers that are provided in the preceding description are merely examples. Event IDs and their description are not documented in this guide. The events, what they represent, and the data in them are considered to be proprietary and confidential. A Technical Support technician inform you of the event IDs that included or excluded, if any.