
System Software Diagnostics Guide — September 2006 147
Runtime Trace Facility (RTF) Reference
preserve_maxbackups
Indicates the maximum number of backup log files the RTF creates when the RTF is run with
preservation mode turned ON. If this attribute is set to 0, all trace information is written to one log
file. If this attribute is set to 1 or greater, all trace information is initially written to one log file.
When the size of this initial log file reaches the threshold defined in the Logfile tag’s preserve_size
attribute, the RTF trace data “rolls over” into a second log file. When the size threshold is reached
in the second log file, the RTF trace data “rolls over” into a third log file. This sequence occurs
until the number of backup log files created equals the preserve_maxbackups attribute setting.
When the “roll over” occurs, the previous log file is saved under the following timestamped name:
rtflog-<year><month><day>-<hour>h<minute>m.<second>s_p.txt
Note: The _p suffix appears in the log file name because preservation mode is turned ON.
The default preserve_maxbackups value is 10.
Note: This attribute is only applicable when RTF preservation mode is turned ON. When RTF
preservation mode is OFF, the maxbackups attribute determines the number of backup log files.
Refer to Section 28.5.3, “Running RTF in Preservation Mode”, on page 156 for information about
preservation mode.
duplicate_to_debug_console
This attribute determines whether or not trace information is duplicated in the debug console
(Windows) or the standard error output (Linux). Possible settings are as follows:
1
The trace output information will be duplicated on the debug console for Windows systems or
the standard error output for Linux systems.
0
The trace output information will not be duplicated on the debug console for Windows systems
or the standard error output for Linux systems. This is the default setting.
log_format
This attribute determines the format of the output log file. By default, this is set to “text” (the trace
output log is written in readable, text file format). However, you can change the attribute to
“binary” to get binary output.
28.3.3 Global Tag
The Global tag is the second child tag of the RTFConfig tag. The Global tag is used to specify the
global configuration. Global configuration settings are valid for all modules included in the RTF
configuration file. However, the Global tag has the lowest priority in the RTF configuration file.
Therefore, the global configuration settings can be overridden by individual settings at the Module
tag level (see Section 28.3.7, “Module Tag”, on page 150).The Global tag cannot occur more than
one time in the RTF configuration file. The Global tag can either be empty:
Comentarios a estos manuales