Dialogic Global Call IP Benutzerhandbuch

377

Dialogic Corporation

This chapter provides information about debugging Dialogic

®

 Global Call API IP applications: 

The Dialogic

®

 Global Call API IP Call Control Library uses the RTF (Runtime Tracing Facility) 

system that is used by other Dialogic

®

 Software libraries to write underlying call control library 

and stack information to a consolidated log file while an application is running. This information 
can help trace the sequence of events and identify the source of a problem. This information is also 
useful when reporting problems to technical support personnel. 

All libraries and software modules that use RTF write their messages to a single, consolidated log 
file, with the default name rftlog.txt. The log file may optionally have a date and time stamp 
appended to the filename; for example, rtflog01052005-13h24m19.923s. When compared to the 
multiple independent log files used in previous implementations of the IP Call Control library, the 
consolidated log file has the advantage of clearly showing the time relationship of events associated 
with different software modules without requiring developers to correlate event time stamps.

The SIP stack may also generate its own log file named sdplog.txt to capture any parsing errors that 
may occur. 

The RTF facility allows developers to configure which events are written to the log file based on 
the importance of the event and the specific software module generating the event. All logging 
configuration for all libraries and modules that use RTF (not just the IP Call Control Library) is 
contained in a single, consolidated configuration file. This is in contrast to previous Global Call IP 
library implementations which used multiple configuration files for the library and the two IP 
protocol stacks. 

The RTF facility uses the following entities to control which debug print statements are written to 
the log file:

module

An RTF module corresponds to a library or software module that has internal RTF APIs 
incorporated into its source code. Three separate RTF modules are used by the IP Call Control 
library: 

gc_h3r – call control, signal handler, and signal adaptation layer software modules

sip_stack – SIP protocol stack 

h323_stack – H.323 protocol stack