Specifications

System Software Diagnostics Guide — September 2006 153

Runtime Trace Facility (RTF) Reference

• “DEBG”

• “WARN”

Note: A complete list of labels for a given library can be found in the RTF configuration file.

state

Specifies the state of the label. Valid values are as follows:

Label is enabled. Trace messages associated with this label will be sent to the trace output.

This is the default value.

Label is disabled. Trace messages associated with this label will not be sent to the trace output.

28.3.11 Precedence Scheme for Module/Client Labels

This section summarizes the precedence scheme of settings in RTF module/client labels. Basically,

RTF has three types of handles for use in determining if a trace statement will be filtered. They are

modules, clients, and labels. A trace statement can use filtering of either of the following:

module+label

For trace statements that use module+label, the trace will only be stored in a file when both

module and label are enabled.

module+client+label.

For trace statements that use module+client+label, the trace will only be stored in a file when

module, client and label are all enabled.

When it is not provided in the configuration file, default enable/disable settings for the three types

of handles are:

• Module: disabled.

• Client: enabled.

• Label: disabled.

For handles set in the configuration file, the precedence order is:

• Module: No precedence order since it is only available at a module level. No global level.

• Client: Settings in the module section override settings in the global section.

• Label: For trace statements without client handles, settings in the module section override

settings in the global section. For trace statements with client handles, settings in the

module/client section override settings in the client/label section; settings in the client/label

section override settings in the module section; and settings in the module section override

settings in the global section.

Figure 19 shows the hierarchy of the possible handles and how they relate to one another.