9.2.3. H.323 Stack Debugging in a Windows Environment

The rvtele.ini file can be used to customize the logging of H.323 stack information to the rvtsp1.log file. You can use the rvtele.ini file for the following:

• Selecting Modules that Write to the rvtsp1.log
• Selecting the Debug Level
• Selecting the Debug Output Type
• Configuring Cyclic Mode Parameters

Selecting Modules that Write to the rvtsp1.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 rvtele.ini file, you can enable or disable modules from writing information to rvtsp1.log. A module is enabled by including a line with the <module name>=1 under a section labelled [insertIntoFile]. For example:

    [insertIntoFile]
    TPKTCHAN=1
    UDPCHAN=1
    CMPAPICS=0
    CMPAIP=0 

In this example, the TPKTCHAN and UDPCHAN modules will writer to the log file, but the CMAPICS and CMAPI modules will not.

Note: Only one section labelled [insertIntoFile] is allowed in the rvtele.ini file.

Selecting the Debug Level

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

    #set up debug level
    deblevel=2 

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

Table 57. Debug Levels for H.323 Stack Logging to rvtsp1.log

Debug Level	H.323 Stack Output
0	Do not display or print debug information. This is the default level.
1	Display messages from all source modules, except those source modules in the list given with the filtering level instructions.
2	Display messages from all source modules according to the list given with the filtering level instructions.
3	Display messages from all source modules.

Selecting the Debug Output Type

In the rvtele.ini file, the following section must exist to direct the debug output:

    [supserve]
    ...
    msgfile=1
    msgdeb=1
    msgwin=0 

In this example, the debug output is directed to the rvtsp1.log file and writes all debug output to the debugger window, such as the Windows debugger when running the application in a Windows environment. Table 58 shows the valid output options.

Table 58. Debug Output Options for H.323 Stack Logging to rvtsp1.log

Output Option	H.323 Stack Output
msgfile	The stack writes all debug messages to the rvtsp1.log file.
msgdeb	The stack writes all debug messages to a debugger window.
msgwin	The stack writes all debug messages to a special window that it creates.

Configuring Cyclic Mode Parameters

When using a debug output of msgfile=1, it is possible to work in cyclic mode and set a limit to the physical size of the rvtsp1.log file. When the log file expands to this size, information will be logged to the beginning of the file overwriting older logging information. The lines in the rvtele.ini file that control these parameters are as follows:

    [fileParams]
    fileSize=20000000
    fileCyclic=1 

To disable this option, set the parameter values as follows:

    [fileParams]
    fileSize=-1
    fileCyclic=0 

Click here to contact Telecom Support Resources