The new parameters that have been added are grouped into four categories:
Each parameter category has a specific registry key path.
HKEY_LOCAL_MACHINE\SOFTWARE\Dialogic\Gammalink\ISDN
HKEY_LOCAL_MACHINE\SOFTWARE\Dialogic\Gammalink\ErrorMapping
HKEY_LOCAL_MACHINE\SOFTWARE\Dialogic\Gammalink\Debug
To modify the default settings of the any of the parameters, use a registry editing tool.
CAUTION
Using a registry editor application incorrectly can cause serious, system-wide problems that may require you to reinstall Windows to correct them. Dialogic cannot guarantee that any problems resulting from the use of a registry editor can be solved. Use these tools at your own risk.
The following section contains summary tables and parameter definitions for each category of the new parameters.
Management ParametersThese parameters control the management of the fax and ISDN features.
Table 9. Management Parameters
Management Parameter DefinitionsBrief descriptions of the new Management parameters are listed alphabetically on the following pages.
AutoReceive
DESCRIPTION |
Specifies whether inbound fax call should be automatically received if the GFXSHUTDOWN state values are set to 0 or 2. If the AutoReceive parameter is set to "yes", inbound faxes are automatically received even when there is no application running of the channel to receive the fax. Inbound faxes received in this mode are stored as a queue record in the queue file. If the AutoReceive parameter is set to "no", inbound faxes received when there are no applications running on the channel to receive them fail. The sender receives an error message indicating that the fax was not received. |
SYNTAX |
"yes" or "no" |
DEFAULT |
"no" |
DATA TYPE |
REG_SZ |
REFERENCE |
None |
PriLayerEnable
NumberOfTrunks
DESCRIPTION |
Indicates the number of PRI trunks in the chassis. This parameter setting is ignored if the PriLayerEnable parameter is set to "no". |
SYNTAX |
Numeric |
DEFAULT |
1 |
DATA TYPE |
REG_DWORD |
REFERENCE |
None |
ChannelsPerTrunk
FaxDistribution
ISDNDistribution
DESCRIPTION |
Determines the selection of which ISDN channel will be used on a specific outgoing call. The setting values include: 0 First free ISDN channel counting from 0 1 Circular ISDN channel assignment 2 First free ISDN channel starting with the last channel 3 Same ISDN channel than Fax channel 4 TBD This parameter setting is ignored if the PriLayerEnable parameter is set to "no". |
SYNTAX |
Numeric |
DEFAULT |
1 |
DATA TYPE |
REG_DWORD |
REFERENCE |
None |
ISDN ParameterThese parameters control the ISDN features. These parameter features are ignored if the PriLayerEnable parameter is set to "no".
Table 10. ISDN Parameters
Parameter |
Description |
BC_xfer_cap |
|
Layer1_protocol |
ISDN Make Call Block parameter. |
BC_xfer_rate |
ISDN Make Call Block parameter. |
BC_xfer_mode |
ISDN Make Call Block parameter. |
origination_number_type |
ISDN Make Call Block parameter. |
origination_number_plan |
ISDN Make Call Block parameter. |
destination_number_type |
ISDN Make Call Block parameter. |
destination_number_plan |
ISDN Make Call Block parameter. |
origination_subnumber_type |
ISDN Make Call Block parameter. |
origination_subnumber_plan |
ISDN Make Call Block parameter. |
origination_phone_number |
ISDN Make Call Block parameter. |
destination_phone_number |
ISDN Make Call Block parameter. |
destination_subphone_number |
ISDN Make Call Block parameter. |
origination_subphone_number |
ISDN Make Call Block parameter. |
AcceptCallState |
Determines whether to use ISDN Accept Call State or not. |
PRI_Overlap_P1 |
Defines minimum number of digits needed before the board accepts incoming call in Overlap Receive mode. |
PRI_Overlap_P2 |
Defines maximum wait time between ISDN SETUP pack and the first ISDN INFO packet. |
CheckInBearer |
Specifies whether to check the Bearer Compatibility during inbound SETUP. |
CheckInSetupFrame |
Specifies whether to check the incoming SETUP packet. |
ISDN Parameter DefinitionsBrief descriptions of the new ISDN parameters are listed alphabetically on the following pages.
BC_xfer_cap
DESCRIPTION |
ISDN Make Call Block parameter. |
SYNTAX |
Mnemonic value defined in the Dialogic DNA 3 online help. |
DEFAULT |
BEAR_CAP_SPEECH |
DATA TYPE |
REG_DWORD |
Layer1_protocol
DESCRIPTION |
ISDN Make Call Block parameter. |
SYNTAX |
Mnemonic value defined in the Dialogic DNA 3 online help. |
DEFAULT |
ISDN_UILI_G711ALAW |
DATA TYPE |
REG_DWORD |
REFERENCE |
Refer to the Dialogic DNA3 Online Help for more information about the parameter settings. |
BC_xfer_rate
DESCRIPTION |
ISDN Make Call Block parameter. |
SYNTAX |
Mnemonic value defined in the Dialogic DNA 3 online help. |
DEFAULT |
BEAR_RATE_64KBPS |
DATA TYPE |
REG_DWORD |
REFERENCE |
Refer to the Dialogic DNA3 Online Help for more information about the parameter settings. |
BC_xfer_mode
DESCRIPTION |
ISDN Make Call Block parameter. |
SYNTAX |
Mnemonic value defined in the Dialogic DNA 3 online help. |
DEFAULT |
ISDN_ITM_CIRCUIT |
DATA TYPE |
REG_DWORD |
REFERENCE |
Refer to the Dialogic DNA3 Online Help for more information about the parameter settings. |
originate_number_type
DESCRIPTION |
ISDN Make Call Block parameter. |
SYNTAX |
Mnemonic value defined in the Dialogic DNA 3 online help. |
DEFAULT |
ISDN_NOTUSED |
DATA TYPE |
REG_DWORD |
REFERENCE |
Refer to the Dialogic DNA3 Online Help for more information about the parameter settings. |
originate_number_plan
DESCRIPTION |
ISDN Make Call Block parameter. |
SYNTAX |
Mnemonic value defined in the Dialogic DNA 3 online help. |
DEFAULT |
ISDN_NOTUSED |
DATA TYPE |
REG_DWORD |
REFERENCE |
Refer to the Dialogic DNA3 Online Help for more information about the parameter settings. |
destination_number_type
DESCRIPTION |
ISDN Make Call Block parameter. |
SYNTAX |
Mnemonic value defined in the Dialogic DNA 3 online help. |
DEFAULT |
EN_BLOCK_NUMBER |
DATA TYPE |
REG_DWORD |
REFERENCE |
Refer to the Dialogic DNA3 Online Help for more information about the parameter settings. |
destination_number_plan
DESCRIPTION |
ISDN Make Call Block parameter. |
SYNTAX |
Mnemonic value defined in the Dialogic DNA 3 online help. |
DEFAULT |
UNKNOWN_NUMBER_PLAN |
DATA TYPE |
REG_DWORD |
REFERENCE |
Refer to the Dialogic DNA3 Online Help for more information about the parameter settings. |
destination_subnumber_type
DESCRIPTION |
ISDN Make Call Block parameter. |
SYNTAX |
Mnemonic value defined in the Dialogic DNA 3 online help. |
DEFAULT |
ISDN_NOTUSED |
DATA TYPE |
REG_DWORD |
REFERENCE |
Refer to the Dialogic DNA3 Online Help for more information about the parameter settings. |
origination_subnumber_type
DESCRIPTION |
ISDN Make Call Block parameter. |
SYNTAX |
Mnemonic value defined in the Dialogic DNA 3 online help. |
DEFAULT |
ISDN_NOTUSED |
DATA TYPE |
REG_DWORD |
REFERENCE |
Refer to the Dialogic DNA3 Online Help for more information about the parameter settings. |
origination_phone_number
DESCRIPTION |
ISDN Make Call Block parameter. |
SYNTAX |
Mnemonic value defined in the Dialogic DNA 3 online help. |
DEFAULT |
ISDN_NOTUSED |
DATA TYPE |
REG_DWORD |
REFERENCE |
Refer to the Dialogic DNA3 Online Help for more information about the parameter settings. |
destination_sub_phone_number
DESCRIPTION |
ISDN Make Call Block parameter. |
SYNTAX |
Mnemonic value defined in the Dialogic DNA 3 online help. |
DEFAULT |
ISDN_NOTUSED |
DATA TYPE |
REG_SZ |
REFERENCE |
Refer to the Dialogic DNA3 Online Help for more information about the parameter settings. |
origination_subphone_number
DESCRIPTION |
ISDN Make Call Block parameter. |
SYNTAX |
Mnemonic value defined in the Dialogic DNA 3 online help. |
DEFAULT |
ISDN_NOTUSED |
DATA TYPE |
REG_SZ |
REFERENCE |
Refer to the Dialogic DNA3 Online Help for more information about the parameter settings. |
AcceptCallState
DESCRIPTION |
Specifies whether or not to use the ISDN Accept Call State. |
SYNTAX |
"yes" or "no" |
DEFAULT |
"yes" |
DATA TYPE |
REG_SZ |
REFERENCE |
None |
PRI_Overlap_Digits
DESCRIPTION |
Defines the minimum number of digits needed before the board will accept the incoming call in Overlap Receiving mode. |
SYNTAX |
|
DEFAULT |
0 |
DATA TYPE |
REG_DWORD |
REFERENCE |
None |
PRI_Overlap_T1
DESCRIPTION |
Defines the maximum time period to pause (in milliseconds) between sending the ISDN SETUP packet and the first ISDN INFO packet. Setting this parameter disables the Overlap Receiving parameter setting. |
SYNTAX |
|
DEFAULT |
2000 |
DATA TYPE |
REG_DWORD |
REFERENCE |
None |
PRI_Overlap_T2
DESCRIPTION |
Defines the maximum time period to pause (in milliseconds) between sending a second ISDN INFO packet which contains additional routing digits in Overlap Receiving. |
SYNTAX |
|
DEFAULT |
2000 |
DATA TYPE |
REG_DWORD |
REFERENCE |
None |
CheckInBearer
DESCRIPTION |
Indicates whether to check for compatible bearer capabilities in the incoming setup. If "yes", checks for compatible bearer capabilities. If "no", does not check bearer capability during inbound SETUP. Any bearer capability is accepted. |
SYNTAX |
|
DEFAULT |
"yes" |
DATA TYPE |
REG_SZ |
REFERENCE |
None |
CheckInSetupFrame
DESCRIPTION |
Indicates whether to check the incoming setup packet. If "yes", checks the incoming setup packet. If "no", does not check the incoming setup packet. Any setup packet is accepted. |
SYNTAX |
|
DEFAULT |
"yes" |
DATA TYPE |
REG_SZ |
REFERENCE |
None |
ErrorMapping ParameterThese parameters control the ErrorMapping features. These parameter features are ignored if the PriLayerEnable parameter is set to "no".
Table 11. ErrorMapping Parameters
Parameter |
Description |
ReservedByDialogic |
Fax channel incoming/outgoing collision error. |
OfferedOnMakeCall |
ISDN channel incoming/outgoing collision error. |
MakeCallFail |
PRI is not able to complete the outgoing call operation error. |
NoPhoneInQrec |
Phone number field not correctly entered by application error, or is missing. |
NoDialogicFree |
Can not find PRI channel error. |
CallDisconnected |
Undefined ISDN connection error. |
ConnectAttemptFail |
Call released before connect state is reached error. |
WrongCRNAllocated |
Serious ISDN error. |
NoFaxResource |
Rejected call due to lack of an available Fax resource ISDN error. |
FaxNotReady |
Rejected call due to system not being initialized or in shutdown mode ISDN error. |
NormalCause |
Default ISDN error sent when releasing a call. |
WrongBearer |
Rejected call due to incompatibility in Bearer Compatibility ISDN error. |
ErrorMapping Parameter DefinitionsBrief descriptions of the new ErrorMapping parameters are listed alphabetically on the following pages.
ReservedByDialogic
DESCRIPTION |
Error code that is returned if the application tries to place an outgoing call on a Fax channel that is reserved by the Dispatcher to accept an incoming fax. |
SYNTAX |
Any numeric value. |
DEFAULT |
3072 |
DATA TYPE |
REG_DWORD |
REFERENCE |
None |
OfferedOnMakeCall
DESCRIPTION |
Error code that is returned if the application tries to place an outgoing call on a ISDN channel that is reserved to accept an incoming call. |
SYNTAX |
Any numeric value. |
DEFAULT |
3072 |
DATA TYPE |
REG_DWORD |
REFERENCE |
None |
MakeCallFail
DESCRIPTION |
Error code that is returned if the PRI is not able to complete the outgoing call. |
SYNTAX |
Any numeric value. |
DEFAULT |
3932 |
DATA TYPE |
REG_DWORD |
REFERENCE |
None |
NoPhoneInQrec
DESCRIPTION |
Error code that is returned if the phone number field is not entered correctly by the application, or is missing. |
SYNTAX |
Any numeric value. |
DEFAULT |
3933 |
DATA TYPE |
REG_DWORD |
REFERENCE |
None |
NoDialogicFree
DESCRIPTION |
Error code that is returned if a PRI channel can not be found. |
SYNTAX |
Any numeric value. |
DEFAULT |
3932 |
DATA TYPE |
REG_DWORD |
REFERENCE |
None |
CallDisconnected
DESCRIPTION |
Error code that is returned when an undefined ISDN disconnection is encountered. |
SYNTAX |
Any numeric value. |
DEFAULT |
3936 |
DATA TYPE |
REG_DWORD |
REFERENCE |
None |
ConnectAttemptFail
DESCRIPTION |
Error code that is returned when a call is released before reaching the connect state. |
SYNTAX |
Any numeric value. |
DEFAULT |
3935 |
DATA TYPE |
REG_DWORD |
REFERENCE |
None |
WrongCRNAllocated
DESCRIPTION |
Error code that is returned when there is a serious ISDN issue. Causes the Dialogic channel to be restarted. |
SYNTAX |
Any numeric value. |
DEFAULT |
3933 |
DATA TYPE |
REG_DWORD |
REFERENCE |
None |
NoFaxResource
DESCRIPTION |
ISDN error returned when a call is rejected because there was no available Fax resource to receive it. |
SYNTAX |
Any numeric value. |
DEFAULT |
USER_BUSY |
DATA TYPE |
REG_DWORD |
REFERENCE |
None |
FaxNotReady
DESCRIPTION |
ISDN error returned when a call is rejected because the system is not initialized, or is in shutdown mode. |
SYNTAX |
Any numeric value. |
DEFAULT |
NORMAL_CLEARING |
DATA TYPE |
REG_DWORD |
REFERENCE |
None |
NormalCause
DESCRIPTION |
The default ISDN error returned when releasing the call. |
SYNTAX |
Any numeric value. |
DEFAULT |
NORMAL_CLEARING |
DATA TYPE |
REG_DWORD |
REFERENCE |
None |
WrongBearer
DESCRIPTION |
ISDN error returned when rejecting the incoming call because of an incompatibility in Bearer Capabilities. |
SYNTAX |
Any numeric value. |
DEFAULT |
CAP_NOT_IMPLEMENTED |
DATA TYPE |
REG_DWORD |
REFERENCE |
None |
Debug ParametersThese parameters control the Debug features.
Table 12. Debug Parameters
Debug Parameter DefinitionsBrief descriptions of the new Debug parameters are listed alphabetically on the following pages.
UseSRAM
DESCRIPTION |
Specifies whether or not to enable Debug logging to Shared Memory in the GDK System Service. If "yes" Shared RAM is used. If "no" Shared RAM is not used. This parameter setting is ignored if the PRILayerEnable parameter is set to "no". This parameter is global across the CP Fax product line. |
SYNTAX |
"yes" or "no" |
DEFAULT |
"yes" if PRILayerEnable parameter is set to "yes", "no" if the PRILayerEnable parameter is set to "no" |
DATA TYPE |
REG_SZ |
REFERENCE |
None |
SRAMMask
DESCRIPTION |
Mask value that specifies type of information logged to Shared Memory. This parameter setting is ignored if the UseSRAM parameter is set to "no". This parameter is global across the CP Fax product line. |
SYNTAX |
bit mask value |
DEFAULT |
0xFFFFFFFF |
DATA TYPE |
REG_DWORD |
REFERENCE |
None |
LogFile
DESCRIPTION |
Specifies file name to store Shared Memory Debug log information. This parameter setting is ignored if the UseSRAM parameter is set to "no". This parameter is global across the CP Fax product line. |
SYNTAX |
full path and filename. |
DEFAULT |
"" |
DATA TYPE |
REG_SZ |
REFERENCE |
None |
LogFileMask
DESCRIPTION |
Mask value that specifies type of information to file named by the Log File parameter. This mask does not affect the other information logged in Shared Memory. This parameter setting is ignored if the UseSRAM parameter is set to "no". This parameter is global across the CP Fax product line. |
SYNTAX |
bit mask value |
DEFAULT |
0xFFFFFFFF |
DATA TYPE |
REG_DWORD |
REFERENCE |
None |
DebugToSRAM
DESCRIPTION |
Specifies whether DEBUG command information is logged to Shared Memory. The functionality of this parameter depends on the DEBUG command being set. If "yes" allows Debug information to be logged into Shared RAM (dependent on the GDK DEBUG Mask.) If "no" firmware information is not logged into the Shared RAM. When the set to "no", the UseSRAM parameter settings are ignored. This parameter setting is ignored if the UseSRAM parameter is set to "no". This parameter is global across the CP Fax product line. |
SYNTAX |
"yes" or "no" |
DEFAULT |
"no" |
DATA TYPE |
REG_SZ |
REFERENCE |
Refer to the Enabling Debug section in Chapter 2 of this guide |
UseGFAX$DL
DESCRIPTION |
Specifies whether or not to log Debug information to a text file called %GFAX%\GFAX.$DL. The functionality of this parameter depends on the DEBUG command being set. If "yes" Debug information is logged in GFAX.$DL (dependent of the GDK Debug mask.) If "no" debug information is not logged in the GFAX.$DL. This parameter setting is ignored if the UseSRAM parameter is set to "no". This parameter is global across the CP Fax product line. |
SYNTAX |
"yes" or "no" |
DEFAULT |
"no" |
DATA TYPE |
REG_SZ |
REFERENCE |
Refer to the Enabling Debug section in Chapter 2 of this guide |
TraceTrunkNumber
TraceFileName
Click here to contact Dialogic Customer Engineering
Copyright 2000, Dialogic Corporation