User`s guide

Dialogic
®
System Release 6.0 PCI for Windows
®
Release Update, Rev 62 — January 30, 2008 114
Dialogic Corporation
1.42.1 Feature Description
This feature allows a user to dynamically (at runtime) retrieve and/or modify the following
parameter values:
• Protocol ID
• CAS signal definitions
• CDP variable values
• Line type (E1_CRC, D4, ESF) and coding (B8ZS, HDB3, AMI) for a trunk
• Protocol for a trunk
Some typical use cases for this feature are as follows:
• When a new system is configured and then provisioned by a new carrier, protocol
parameters, such as wink settings, need to be tweaked before a call can be placed
using the new switch. Currently, the configuration file has to be manually edited for
every change and the firmware re-downloaded for the changes to take effect. The
provision of this API to perform these changes at runtime alleviates the need to
manually edit configuration files and subsequently re-download the firmware.
• When using ISDN protocols, the ability to dynamically determine the protocol running
on a particular span is important in determining whether features such as Two-B Call
Transfer (TBCT) or Overlapped Sending can be supported.
This feature is implemented using the Dialogic
®
Global Call Run Time Configuration
Management (RTCM) facility, which uses the Global Call gc_GetConfigData( ),
gc_SetConfigData( ), and gc_QueryConfigData( ) functions. For general information on
the operation of the Global Call RTCM facility, see the Dialogic
®
Global Call API
Programming Guide. Details on how to dynamically configure the parameter types
mentioned above are provided in the following sections.
1.42.1.1 Prerequisites for Feature Use
Creating a dm3enum.cfg File
Before this feature can be used, it must be enabled. To enable the feature, a new
configuration file must be created. The name of the configuration file is dm3enum.cfg and
it must be stored in the Dialogic\cfg directory. The dm3enum.cfg file determines the
boards on which this dynamic protocol configuration feature is to be enabled.
The syntax of the commands that can be included in a dm3enum.cfg file are:
board <n>
Specifies a logical board (<n>) on which this feature is to be enabled.
board (startBd endBd)
Specifies a range of boards on which this feature is to be enabled.
Notes:1. The “board” command word can be abbreviated to “b”.
2. The startBd value must be less than the endBd value.