Specifications

System Software Diagnostics Guide — September 2006 145
Runtime Trace Facility (RTF) Reference
– LabelWidth number - Allows you to customize the number of characters that appear in
the Label column. The default setting is 10.There is no maximum setting.
2. Using the ALIGN 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 UNALIGN format is
separated by commas so it can be parsed by a spreadsheet or database program to make the file
easier to read.
28.3.2 Logfile Tag
The Logfile tag is the first child tag of the RTFConfig tag. The Logfile tag provides logistical
information about the log file(s) used to store trace output.
If you would like to customize the appearance and settings of the log file, edit the Logfile tag
within the RTF configuration file. The Logfile tag appears under the RTFConfig tag in the RTF
configuration file.
A sample Logfile tag entry from the RtfConfigLinux.xml file is shown below:
<Logfile path=”$(INTEL_DIALOGIC_DIR)/log” size=”300” maxbackups=”10”
preserve_size=”300” preserve_maxbackups=”10”
duplicate_to_debug_console=”0” log_format=”text”/>
A sample Logfile tag entry for the RtfConfigWin.xml file is shown below:
<Logfile path=”$(INTEL_DIALOGIC_DIR)\log” size=”300” maxbackups=”10”
preserve_size=”300” preserve_maxbackups=”10”
duplicate_to_debug_console=”0” log_format=”text”/>
The Logfile tag includes the following attributes:
path
Indicates a valid directory path for the log file. The default path for Linux is
$(INTEL_DIALOGIC_DIR)/log. The default path for Windows is $(INTEL_DIALOGIC_DIR)\log.
The INTEL_DIALOGIC_DIR environment variable is defined as part of the system release
software installation routine. Refer to the Intel Dialogic System Release Software Installation
Guide for more information about the INTEL_DIALOGIC_DIR environment variable.
size
Sets the maximum size, in Kilobytes (KB), of the log file when RTF is run with preservation mode
turned OFF. The default setting is 300. When the file reaches its maximum size, RTF “rolls over”
the log file, much like a circular buffer. The previous log file is saved as a timestamped text file.
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.