Specifications

System Software Diagnostics Guide — September 2006 41
7
7.Debugging Software
This chapter provides several procedures that can be useful for general software debugging:
• Troubleshooting Runtime Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
• Collecting System Data to Diagnose an Application Failure or Crash . . . . . . . . . . . . . 44
• Creating a System Configuration Archive. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
7.1 Troubleshooting Runtime Issues
This section describes how to use the Runtime Trace Facility (RTF) for tracing the execution path
of various runtime libraries. You can use the RTFManager GUI to customize the trace settings or
you can manually edit the RTF configuration file. Procedures for each of these approaches are
provided in the following sections:
• Using RTFManager to Customize Trace Settings
• Manually Editing the RTF Configuration File
Using RTFManager to Customize Trace Settings
You can use the RTFManager GUI to customize and activate the RTF’s tracing capabilities as
follows:
1. Start RTFManager:
• On Windows systems, RTFManager can be started from the Start menu. RTFManager is
in the program group for the Intel telecom software. RTFManager can also be started by
just typing “RTFManager” from the console.
• On Linux systems, RTFManager can be started by typing /usr/dialogic/RTFManager
or
RTFManager if the executable is in the operating system’s executable searching path.
RTFManager’s main window appears.
2. From the Tools menu, select RTF Configuration... This launches the Runtime Trace Facility
Manager Configuration window. The Runtime Trace Facility Manager Configuration window
contains the following two tabs:
• General - The General tab is used to enable/disable RTF tracing and customize the format,
readability and location of the log files. Refer to Section 29.5, “General Tab”, on page 166
for more information.
• Filtering - The Filtering tab allows you to determine which libraries to trace and the trace
level (Debugging, Program Flow, Warnings, Errors) for each library. Refer to
Section 29.6, “Filtering Tab”, on page 168 for information about using the Filtering tab.
Adjust the settings on each of these tabs to suit your needs and click OK when you are
finished.