9.2.2. H.323 Stack Debugging on Linux Operating Systems

The msg.conf file can be used to customize the logging of H.323 stack information to the logfile.log file. You can use the msg.conf file for the following:

• Selecting Modules that Write to logfile.log
• Selecting the Debug Level
• Selecting the Debug Output Type

Selecting Modules that Write to logfile.log

The H.323 stack comprises a number of modules as follows:

• EMA
• MEMORY
• RA
• CAT
• CM†
• CMAPI†
• CMAPICB†
• CMERR†
• TPKTCHAN†
• CONFIG†
• APPL
• FASTSTART†
• VT
• UNREG
• RAS†
• UDPCHAN
• TCP
• TRANSPORT
• ETIMER
• PER†
• PERERR†
• TUNNCTRL†
• Q931†
• Q931ERR
• L1
• TIMER
• AnnexE
• SSEERR
• SSEAPI
• SSEAPICS
• SSCHAN
• SUPS

Note: † indicates the most commonly used modules.

In the msg.conf file, you can enable or disable the modules that write information to logfile.log. A module is disabled by including a pound symbol (#) in front of the module name. For example, in the following segment of the msg.conf file, the TPKTCHAN and UDPCHAN modules write to the log file, but the CMAPICS and CMAPI modules do not.

    TPKTCHAN
    UDPCHAN
    #CMAPICB
    #CMAPI 

Selecting the Debug Level

In the msg.conf file, you can set the debug level by including lines similar to the following:

    #set up debug level
    %2 

In this example, the debug level is set to 2. Table 55 shows the valid bebug levels and their meaning.

Table 55. Debug Levels for H.323 Stack Logging to logfile.log

Debug Level	H.323 Stack Output
0	Do not display or print debug information. This is the default level.
1	Do not display trees or do not check trees for ASN.1 consistency.
2	Display all information including trees, but do not check trees for ASN.1 consistency.
3	Display all information and check trees for ASN.1 consistency. Display any inconsistencies found.
4	Display all messages.

Selecting the Debug Output Type

In the msg.conf file, you can direct where the debug output will be written by including lines similar to the following:

    #debug output definition
    >file 

In this example, the debug output is directed to a file. Table 56 shows the valid output options.

Table 56. Debug Output Options for H.323 Stack Logging to logfile.log

Output Option	H.323 Stack Output
file	Write the debug output to a file. The name of the file is <current directory>logfile.log.
logger	Write the debug output to a logger, such as the debug logger, or to any other printing tool.
terminal	Display the debug output on a terminal.

Click here to contact Telecom Support Resources