Dialogic Voice Cards - How To Enable PDK Logging on a JCT series board

Summary

To troubleshoot  Dialogic Global Call Software Protocol Development Kit (PDK) issues on Dialogic JCT series Media Boards, it is sometimes desirable to generate a PDK log to help identify the root cause of an issue. This article provides instructions on how to enable and view logs for PDK.

Environment

This article applies only to the Windows environment. The application must also be using a PDK Global Call protocol with a JCT series Media Board.

Enable PDK logging in Windows NT

1. Save a copy of your existing pdk*.cdp file

2. Add the following line to your pdk*.cdp file (for example, at the end of pdk_us_mf_io.cdp):

ALL INTEGER_t PSL_TXRX_LOG_ENABLE=1

1. Save the file

2. Go to the Control Panel

3. Double click on System

4. Go to the Environment tab and add the following variable and value:

    Variable: GC_PDK_START_LOG
    Value: filename:pdk.log;loglevel:ENABLE_DEBUG;services:ALL_SERVICES;
    cachedump:WHEN_FULL|THREAD_OFF;cachesize:1;maxfilesize:200;mindiskfree:200

1. Click on Set and make sure that the Variable and Value you added in step 3 show in the list

2. Click Apply and then Ok

Enable PDK logging in Windows® 2000/XP/2003

1. Save a copy of your existing pdk*.cdp file

2. Add the following line to your pdk*.cdp file (for example, at the end of pdk_us_mf_io.cdp):

ALL INTEGER_t PSL_TXRX_LOG_ENABLE=1

1. Go to the Control Panel

2. Double click on System

3. Go to the Advanced tab

4. Click on the Environment Variables option and add the following variable and value under the Systems Variables section:

    Variable: GC_PDK_START_LOG Value: filename:pdk.log;loglevel:ENABLE_DEBUG;services:ALL_SERVICES;
    cachedump:WHEN_FULL|THREAD_OFF;cachesize:1;maxfilesize:200;mindiskfree:200

1. Click on Set and make sure that the Variable and Value you added in step 4 show in the list.

2. Click Apply and then OK

Enable PDK logging in Windows® 7/2008

1. Save a copy of your existing pdk*.cdp file

2. Add the following line to your pdk*.cdp file (for example, at the end of pdk_us_mf_io.cdp):

ALL INTEGER_t PSL_TXRX_LOG_ENABLE=1

1. Go to the Control Panel

2. Double click on System

3. Click on the Advanced System Settings Option

4. Click on the Environment Variables option and add the following variable and value under the Systems Variables section:

    Variable: GC_PDK_START_LOG Value: filename:pdk.log;loglevel:ENABLE_DEBUG;services:ALL_SERVICES;
    cachedump:WHEN_FULL|THREAD_OFF;cachesize:1;maxfilesize:200;mindiskfree:200

1. Click on Set and make sure that the Variable and Value you added in step 4 show in the list.

2. Click Apply and then Ok

In the Value of the argument added above, notice that the user has the option to do the following:

1. Specify the name of the log file via filename:pdk.log

2. Specify the maximum size of a log file via maxfilesize:200 (MB)

3. Check if there is available disk space for the log via mindiskfree:200 (MB)

Viewing the PDK log

After logging is enabled and after running an application, use the LogView application( )  to view the generated PDK log. The log file will generally be found in the folder where the application was run from. However, if the application is running as a service, the log will be generated in ..\WinNT\System32\ directory. Also note that the log file name is specified in the key you add to the environment . In the example above, it's called pdk.log.

Note: Remember to disable logging if not needed afterwards. To disable logging, do the following:

1. Go to the control panel and delete the key you added

2. Replace your cdp file with the original one or just delete the line that you added