Filter
Top Products
378 Dialogic
®
Global Call IP Technology Guide — November 2007
Dialogic Corporation
Debugging Dialogic
®
Global Call API IP Applications
client
An entity for identifying a device, component, or function that is to be traced by the RTF. The
RTF modules for the IP Call Control library include a large number of client entities to provide
a high degree of control over what statements are written to the log file; these clients are listed
in the following sections which describe how to configure the logging facility.
label
An attribute associated with a trace statement to categorize the type or level of the information
and to determine whether the statement is written to the log file. Labels are handled as
independent entities and must be enabled or disabled individually; this is in contrast to the
previous IP Call Control library logging implementation, where it was possible to enable log
output for multiple statement levels collectively. Different RTF modules use different subsets
of the overall RTF label set; the labels used for the IP Call Control library include only Error,
Warning, and Debug.
7.2 Configuring the Logging Facility
The following topics provide information about how the user can customize the information
written into the log file by the Global Call IP library:
• Configuration File Overview
• Configuring the gc_h3r Logging Module
• Configuring SIP Stack Logging
• Configuring H.323 Stack Logging
7.2.1 Configuration File Overview
This section describes how the common RTF configuration file is organized and what configuration
is set up in the default configuration file that is supplied with the release software. The default
configuration file may be named RtfConfig.xml or it may have an OS-specific name as appropriate
to the specific release (i.e., RtfConfigWin.xml or RtfConfigLinux.xml); for simplicity, this document
will only refer to the generic name. The entries in this configuration file conform to XML syntax
rules.
Global Section
The global section of the RtfConfig.xml file contains one or more “GLabel” elements, which are
used to globally enable logging of trace statements that are mapped to that RTF label. Globally
enabling or disabling a label affects all RTF modules, but the global setting may be overridden
locally.
The default RtfConfig.xml file globally enables the Error label, so that all error statements from all
RTF modules will be logged unless disabled locally. The statement that globally enables the Error
label is:
<GLabel name="Error" state="1"/>