Syntax for RAS1 traces

Use this syntax to specify RAS1 traces in the KppENV file. An IBM® Software Support representative can tell you the values to set for the parameters.

where:

global_class

Indicates the level of tracing that you want. This is a global setting that applies to all RAS1 filters in the process. If you set this global class by itself, it is global in scope and the trace cannot filter on any of the other keywords. Separate combined classes with a space. The following values are possible. Valid abbreviations are in parentheses.

• ERROR (ER): returns severe error messages only (this is the default for most applications).
• STATE (ST): records the condition or current setting of flags and variables in the process. If state tracing is enabled, you can see the current state of particular variables or flags as the process is running.
• FLOW (FL): causes a message to be generated at an entry or exit point of a function.
• DETAIL (DE): produces a detailed level of tracing.
• INPUT (IN): records data that is created by a particular API, function, or process.
• ALL: causes all available messages to be recorded. This setting combines all the other forms of tracing.

COMP

Indicates that the trace includes a component type. The COMP keyword is used to trace groups of routines that are related by function (or component). Use this keyword only at the explicit request of an IBM Software Support representative.

component_type

Identifies a component type. An IBM Software Support representative can tell you what value to specify.

ENTRY

Narrows a filtering routine to specify a specific ENTRY POINT. Since multiple entry points for a single routine are rare, use this keyword only at the explicit request of an IBM Software Support representative.

entry_point

Represents the name of the entry point. An IBM Software Support representative can tell you what value to specify.

UNIT

Indicates that the trace is to look for a match between the compilation unit dispatched and the fully or partially qualified compilation unit specified on the RAS1 statement. A match results in a trace entry.

unit_name

Represents the name of the compilation unit. In most instances, this name defines the component that is being traced. The value is likely to be the three-character component identifier for the monitoring agent (Kpp).

class

One of the same values that are specified for global_class, but, because of its position inside the parentheses, narrowed in scope to apply only to the unit_name specified.