| CONTACT | DEVELOPER CENTER | PARTNERS | SITEMAP

GO

Dialogic Support Helpweb

Dialogic® DM3 & JCT Media Boards

How to Enable Logging for Global Call PDK (Protocol Development Kit)

Summary:
To troubleshoot PDK Dialogic® Global Call Software problems, it's necessary to generate a PDK log to help identify the root cause of a problem. This technical note provides instructions on how to enable and view logs for PDK.

Environment:
Enabling and viewing PDK logs only applies if the user's environment is Microsoft® Windows NT or Windows® 2000 operating system. The application must also be using a PDK Global call protocol.

Solution Summary:
In order to enable logging for PDK follow these steps:

For 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

3. Save the file
4. Go to the Control Panel
5. Double click on System
6. 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:20;mindiskfree:20
7. Click on Set and make sure that the Variable and Value you added in step 3 show in the list
8. Click Apply and then Ok

For Windows® 2000:

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
     
3. Go to the Control Panel
4. Double click on System
5. Go to the Advanced tab
6. 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:20;mindiskfree:20
7. Click on Set and make sure that the Variable and Value you added in step 4 show in the list.
8. 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:20 (MB)
3. Check if there is available disk space for the log via mindiskfree:20 (MB)

Technical Discussion:
After logging is enabled and after running an application, use the LogView application attached to this technical note 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

Attachments:
LogView.zip

Feedback

Home | Products | Purchase | Partners | Developers | Services & Support | Downloads | Contact | About Us
Legal | Privacy Policy | Sitemap | | Careers | Newsletter Signup