Technical Helpweb

- more articles

How to set the Dial Timeout Value on Gammalink T1

Problem Description:
When using the T1 CAS protocol on a GDK application, it may become necessary to increase or decrease the dial timeout value from the default value. The procedure for making such a change is not clearly documented in the GDK configuration and programming manuals. This technical note describes how to change the value to a predictable result.

Solution Summary:
Set the registry’s HKEY_LOCAL_MACHINE\SOFTWARE\Dialogic\Gammalink\DM3Fax -> UseQrecCdTimeout value to ‘No’. Then set the desired dial timeout value in both the registry’s HKEY_LOCAL_MACHINE\SOFTWARE\Dialogic\Gammalink\DM3Fax\WatchDogMakeCall and fcd file’s AnswerTimeout value.

Technical Discussion:
The dial-out timeout value in the Gammalink GDK API is commonly referred to as the CD Timeout. There are two parameters that determine the CD Timeout value - one is located in the registry and the other in the fcd file. Firstly, the UseQrecCdTimeout value in the registry’s HKEY_LOCAL_MACHINE\SOFTWARE\Dialogic\Gammalink\DM3Fax key must be set to 'No'. Then the following parameters must also be set:
(1) In the Registry: HKEY_LOCAL_MACHINE\SOFTWARE\Dialogic\Gammalink\DM3Fax\WatchDogMakeCall. Set the desired value in milliseconds.
(2) In the config file: Variant AnswerTimeout. Set the desired value in milliseconds.
The way the dial timeout value is derived is that the protocol compares the values of both parameters and uses whichever is lower. For example, if WatchDogMakeCall is set to 120000 and AnswerTimeout to 30000, the dialing will time out in 30 seconds. And if AnswerTimeout is set to 240000 and WatchDogMakeCall to 120000, the time out will occur in 120 seconds or two minutes. However, if you set both parameters to equal values, the protocol will use that same value, for example, if both parameters are set to 60000 the timeout will occur in 60 seconds or one minute. Remember that when changes are made in the config file the fcdgen utility will need to be run on the config file in order to generate a new fcd file, and then the Dialogic System Service as well as the Gammalink service will need to be restarted.

Product Listing:
CPi/2400-1T1-PCIU
CPi/2400-1T1-PCI
System Release 5.1.1 FP1 SU
System Release 6.0 SU

Related Documents:
GDK Installation and Configuration Guide: http://www.dialogic.com/~/media/manuals/docs/gdk_install_and_config_win_v1.pdf
GDK Programming Reference: http://www.dialogic.com/~/media/manuals/docs/gdk_api_win_v2.pdf

Attachments: None