Specifications

System Software Diagnostics Guide — September 2006 167
RTFManager Reference
The general tab contains the following settings:
Enable Global Tracing?
This check box is used to enable or disable the RTF tracing capabilities. If the box is checked,
RTF tracing is enabled. If the box is not checked, RTF tracing is disabled.
Note: Enable/disable means RTFManager will modify the RTF configuration file to change
certain values to enable/disable a group of modules. RTFManager will reload the RTF
to let the change take effect.
Timestamp
This check box acts as a Boolean flag to determine whether or not time stamps are generated in
the log file. If the box is checked, time stamps will appear in the log files. If the box is not
checked, time stamps will not appear in the log files.
Log Format
This attribute defines the format of the log file. The following three values are supported:
• Text Aligned - Aligns the trace entry fields in the log file into comma separated columns.
The top of each column includes a header that provides a description of the column’s
content. This is the default setting.
• Text Unaligned - Separates the trace entry fields in the log files with commas only.
Column alignment is not done.
• Binary - Not supported by the current release.
Note: Using the Text Aligned setting makes the log file easier to read but it does not make
efficient use of hard drive space. This inefficiency is exacerbated as the log file grows.
The Text Unaligned format is separated by commas so it can be parsed by a
spreadsheet or database program to make the file easier to read.
Logfile Directory
This attribute defines the location of the log file. This attribute is read-only.
Logfile Prefix
This attribute defines the name of the log file. This attribute is read-only.
Logfile Size
Sets the maximum size, in Kilobytes (KB), of the log file. The default setting is 1000. The size
is the maximum size of a single log file. When the file reaches this size, the RTF behavior
depends on the setting of the attribute as follows:
• If Maximum Backups is set to 0, RTF “rolls over” the log file, much like a circular buffer.
RTF aligns the entries so that the oldest entry is always at the top of the log file and the
newest entry is always at the bottom of the log file.
• If Maximum Backups is set to 1 or greater, the log file will be closed and a new log file
will be created. This sequence continues until the Maximum Backups threshold is
reached.
Maximum Backups
This attribute is used to determine whether or not backup log files are created. Valid values are
as follows:
• 0 - Backup log files will not be created. All trace information will be written to one log
file. When the size of this log file reaches the threshold defined in the attribute, RTF “rolls
over” the log file, much like a circular buffer. RTF aligns the entries so that the oldest
entry is always at the top of the log file and the newest entry is always at the bottom of the
log file. This is the default setting.