Contents

VoiceGuide Help
1. Introduction
Welcome To VoiceGuide
Which version to use
2. System Configuration
System Requirements
Installing v7.x - Dialogic
Installing v7.x - VoIP / HMP
Installing v6.x - Dialogic
Installing v5.x - Voice Modems
Installing v5.x - CAPI compatible cards
Installing v5.x - Dialogic
Installing v5.x - Dialogic Wave Drivers
Text To Speech
Call Transfers and Conferencing
ODBC Data Sources
End of Call Detection
Distinctive Ring Detection
T1/E1 ISDN Configuration
T1/E1 RobbedBit/CAS/R2 Configuration
VoIP Line Registration
Command Line Options
Registering VoiceGuide
Unique System Identifier
3. Script Design
Introduction
Graphical Design Environment
Module Types
Paths
Result Variables
Call Start
Call Finish
Multilanguage Systems
Protected Scripts
Sound files
Testing Scripts
4. Modules Reference
Play
Record
Get Numbers
Say Numbers
Transfer Call
Send Phone Message
Send Pager Message
Send Email
Database Query
Run Program
Time Switch
Evaluate Expression
Run VB Script
Send DDE Command
Hangup Call
5. Voicemail
Introduction
Voicemail System Manager
Voicemail Menus
Message Lamps
6. Outbound Dialing
Loading Numbers to Call
Detect Call Answer
Predictive Dialers
External OutDialQue Source (v7)
External OutDialQue Source (v6)
7. Speech Recognition
Introduction
Grammars
Install LumenVox
8. Logs
Script Logs
Call Detail Records (CDRs)
9. ActiveX / COM Interface
Admin_TraceLogAdd
Dialer_MakeCall
Dialer_OutDialQueAdd
Bridge_Connect
Bridge_Disconnect
Line_Hangup
Line_Pickup
Play_Start
Play_Stop
Record_Stop
Record_Start
Record_2Lines_Start
Run_ResultReturn
RvGet
RvGet_All
RvGet_AllXml
RvSet
RvSet_RvList
Script_Gosub
Script_Goto
Script_Return
Serial_Tx
Vm_Event
Vm_VmbConfig_Get
Vm_VmbConfig_Set
10. PBX Integration (CTI)
Inband Signaling
Ericsson MD110 Voicemail Interface
Legal Information
Copyright & Disclaimer

 
Home
VoiceGuide Online Help
Prev Page Next Page
 
 

Selecting ISDN Protocol

All that is required to configure a T1 ISDN or E1 ISDN system to receive calls is to select the appropriate ISDN protocol in the Dialogic Configuration Manager (DCM) system. After selecting the appropriate ISDN protocol, and starting the Dialogic service the system should now be able to receive calls. Screenshot below shows where in the DCM the ISDN protocol is set:

The telephone company which supplies the ISDN line will inform you what ISDN protocol is used on the lines they supply. Local Dialogic distributor will usually also know which protocols are used by the various telephone companies in your local area and would also be usually able to advise if any special options need to be set on the Dialogic configuration level to make the Dialogic cards work with those lines.

 

Setting Config.xml and ConfigLine.xml

The channels which VoiceGuide is to use are specified in Config.xml file. Sample Config.xml files are provided, and cover the most common deployment scenarios. In the Config.xml file the Protocol just needs to be set to ISDN

It is recommended that all channels get opened: 23 on a T1 ISDN line, and 30 on an E1 ISDN line.

Some PBXs and Switches will not properly initialize the T1/E1 link and will not properly handle calls on it unless all channels on the line are opened.

A sample ConfigLine.xml file for use with ISDN systems is also provided. Analog system related settings have been removed from that file, and ISDN related settings have been added in.

 

Testing ISDN Line

When using the "JCT" and "SC" family cards. eg: D/240JCT, D/300JCT, D/480JCT, D/600JCT, D/240SC, D/300SC etc..  the Dialogic ISDIAG application can be used to test the T1/E1 lines and obtain ISDN traces.

When using the "DMV" family cards. eg: DMV480, DMV600, DMV/240JCT, D/300JCT, D/480JCT, D/600JCT, D/240SC, D/300SC etc..  the Dialogic ISDNTRACE application can be used obtain ISDN traces.

 

ISDIAG

Dialogic provides the isdiag.exe command line application which will allow you to test if the ISDN connection is functioning and can capture the ISDN layer trace as well. Isdiag.exe will only work on 'Springware' Dialogic cards, eg: D/240JCT, D/480JCT, D/300JCT. D/600JCT and their predecessors. Isdiag.exe is located in directory C:\Program Files\Dialogic\bin

To test an E1 connection the isdiag tool would usually be started like this at the DOS Command Prompt:

isdiag 1 1 e s v

To test a T1 connection the isdiag tool would usually be started like this at the DOS command prompt:

isdiag 1 1 t s v

The examples above would allow user to receive and make calls on that first channel of first T1/E1 interface only. You will need to confirm with the Telco that they will send a call on that channel after the ISDN D channel is restarted. D channel is restarted when isdiag

VoiceGuide should not be started when using isdiag, as isdiag itself opens the channel on the ISDN line.

If you are unable to receive/make calls and play/record sound files with isdiag then you will need to contact your local Dialogic supplier to establish why the hardware they provided does not work on the T1/E1 lines from your telephone company. It is unlikely that VoiceGuide will work if isdiag cannot receive and make calls. Your local Dialogic supplier should be familiar with all the local telephone companies' ISDN protocols and know what should be done in order for the Dialogic cards to be able to work with the ISDN lines in your local area.

isdiag can be used to capture traces of the ISDN messages as well. The log files produced by isdiag need to be converted into human-readable form by using the isdtrace.exe application. Note that isdtrace.exe application is different to the isdntrace.exe application.

 

ISDNTRACE

Dialogic provides the isdntrace.exe application which can capture a trace of the ISDN messages. Isdntrace.exe will only work on DM3/DMV type Dialogic cards. Isdntrace.exe is located in directory C:\Program Files\Dialogic\bin

The ISDN traces are used to confirm what ISDN parameters are sent by the Telco on that ISDN line, and to confirm what parameters are being sent out by VoiceGuide when an outbound call is made. The outgoing parameters should usually match what is sent by the Telco's switch.

To use isdntrace to obtain the trace of the ISDN layer messages please follow the following steps.


   1. Stop VoiceGuide.

   2. Restart Dialogic Service.

   3. Start
isdntrace using this command (from Command prompt in Dialogic\bin directory).

   isdntrace -b0 -d1 -f c:\myisdnlog

   4. Start VoiceGuide.

   5. Make a call into VoiceGuide. Hangup after VoiceGuide answers.

   6. Make a call out of VoiceGuide, loading the call using the "Outbound Call Loader".

   7. After calls is ended press "q" in the
 isdntrace Command Prompt window to exit isdntrace.

   8. Trace file would be created in C:\, name of file begins with "
myisdnlog".

 

ISDN Outgoing Calls

Setting the ISDN protocol to the correct value is usually sufficient for outgoing calls to function as well. Some telephone companies however have specific non-standard requirements for outgoing calls.

This section outlines the configuration options available within VoiceGuide to allow the user to explicitly specify the individual settings on outgoing calls.

Most of these requirements relate to the structure and the information contained within the "Setup" message sent to the switch when a new call is made. VoiceGuide for Dialogic offers the use extensive control over the information sent within the Setup message, allowing easy configuration of the system to match requirements of the Telco switch or PBX.

The configration of the ISDN's SETUP message can be made by specifying the following in the ConfigLine.xml file, in section <ConfigLine><isdn><msgSetup>.

Below is an example of what this section looks like, with the default values set.
 

<isdn>
<msgSetup>
  <defsrc>NONE</defsrc>
  <defcc>
    <cc_bc_xfer_cap>BEAR_CAP_SPEECH</cc_bc_xfer_cap>
    <cc_bc_xfer_mode>ISDN_ITM_CIRCUIT</cc_bc_xfer_mode>
    <cc_bc_xfer_rate>BEAR_RATE_64KBPS</cc_bc_xfer_rate>
    <cc_usrinfo_layer1_protocol>ISDN_UIL1_G711ULAW</cc_usrinfo_layer1_protocol>
    <cc_usr_rate>ISDN_NOTUSED</cc_usr_rate>
    <cc_destination_number_type>NAT_NUMBER</cc_destination_number_type>
    <cc_destination_number_plan>UNKNOWN_NUMB_PLAN</cc_destination_number_plan>
    <cc_destination_sub_number_type>OSI_SUB_ADDR</cc_destination_sub_number_type>
    <cc_origination_number_type>NAT_NUMBER</cc_origination_number_type>
    <cc_origination_number_plan>UNKNOWN_NUMB_PLAN</cc_origination_number_plan>
    <cc_origination_phone_number></cc_origination_phone_number>
    <cc_origination_sub_number_type>OSI_SUB_ADDR</cc_origination_sub_number_type>
    <cc_origination_sub_phone_number></cc_origination_sub_phone_number>
    <cc_facility_feature_service>ISDN_NOTUSED</cc_facility_feature_service>
    <cc_facility_coding_value>ISDN_NOTUSED</cc_facility_coding_value>
  </defcc>
  <defgc>
    <gc_destination_address></gc_destination_address>
    <gc_destination_address_type>NAT</gc_destination_address_type>
    <gc_destination_address_plan>UNKNOWN</gc_destination_address_plan>
    <gc_destination_sub_address></gc_destination_sub_address>
    <gc_destination_sub_address_type>UNKNOWN</gc_destination_sub_address_type>
    <gc_destination_sub_address_plan>UNKNOWN</gc_destination_sub_address_plan>
    <gc_origination_address></gc_origination_address>
    <gc_origination_address_type></gc_origination_address_type>
    <gc_origination_address_plan></gc_origination_address_plan>
    <gc_origination_sub_address></gc_origination_sub_address>
    <gc_origination_sub_address_type></gc_origination_sub_address_type>
    <gc_origination_sub_address_plan></gc_origination_sub_address_plan>

    <gc_chan_info_medium_id>1</gc_chan_info_medium_id>
    <gc_chan_info_medium_sel>MEDIUM_PREF</gc_chan_info_medium_sel>

    <gc_call_info_category>SUB_NOPRIOR</gc_call_info_category>
    <gc_call_info_address_info>ENBLOC</gc_call_info_address_info>
    <gc_ext_data></gc_ext_data>
  </defgc>
</msgSetup>
</isdn>;


The
<defsrc> setting selects whether the "CC" or "GC" approach (or neither) will be used to configure Setup message. Both approaches set almost the same information, but some Dialogic cards require the use of CC approach and some require the GC approach, which is why the option to use one or the other is offered. Setting the <defsrc> filed to NONE should always be tried first. This will result in the default settings for the selected ISDN protocol being used - the protocol set in Dialogic's Configuration Manager (DCM).

The DM3/DMV series cards can only use the "GC" setting parameters.

If the default settings do not work please post your system's configuration details on the Support Forum and and a member of staff will then be able to assist in setting the correct configuration.

Settings used for individual fields within the <ConfigLine><isdn><msgSetup> section are detailed below:
 

Valid Settings 

Field Values

defsrc CC, GC, NONE

cc_bc_xfer_cap BEAR_CAP_SPEECH, BEAR_CAP_UNREST_DIG, BEAR_REST_DIG

cc_bc_xfer_mode ISDN_ITM_CIRCUIT

cc_bc_xfer_rate BEAR_RATE_64KBPS, BEAR_RATE_128KBPS, BEAR_RATE_384KBPS, BEAR_RATE_1536KBPS, BEAR_RATE_1920KBPS, PACKET_TRANSFER_MODE

cc_usrinfo_layer1_protocol SDN_UIL1_CCITTV.110, ISDN_UIL1_G711ULAW, ISDN_UIL1_G711ALAW, ISDN_UIL1_G711ADPCM, ISDN_UIL1_G722G725, ISDN_UIL1_H261, ISDN_UIL1_NONCCITT, ISDN_UIL1_CCITTV120, ISDN_UIL1_CCITTX31

cc_usr_rate ISDN_UR_EINI460, ISDN_UR_56000, ISDN_UR_64000, ISDN_UR_134, ISDN_UR_12000

cc_destination_number_type EN_BLOC_NUMBER, INTL_NUMBER, NAT_NUMBER, LOC_NUMBER, OVERLAP_NUMBER

cc_destination_number_plan UNKNOWN_NUMB_PLAN, ISDN_NUMB_PLAN, TELEPHONY_NUMB_PLAN, PRIVATE_NUMB_PLAN

cc_destination_sub_number_type OSI_SUB_ADDR, USER_SPECIFIED_SUB_ADDR, IA_5_FORMAT

cc_origination_number_type EN_BLOC_NUMBER, INTL_NUMBER, NAT_NUMBER, LOC_NUMBER, OVERLAP_NUMBER

cc_origination_number_plan UNKNOWN_NUMB_PLAN, ISDN_NUMB_PLAN, TELEPHONY_NUMB_PLAN, PRIVATE_NUMB_PLAN

cc_origination_phone_number Default CallerID phone number for outgoing calls made using this channel can be specified here.

cc_origination_sub_number_type OSI_SUB_ADDR, USER_SPECIFIED_SUB_ADDR, IA_5_FORMAT

cc_origination_sub_phone_number Default CallerID phone sub-number for outgoing calls made using this channel can be specified here

cc_facility_feature_service ISDN_NOTUSED, ISDN_FEATURE, ISDN_SERVICE

cc_facility_coding_value ISDN_CPN_PREF, ISDN_SDN, ISDN_BN_PREF, ISDN_ACCUNET, ISDN_LONG_DIS, ISDN_INT_800, ISDN_CA_TSC, ISDN_ATT_MULTIQ

gc_destination_address_type TRANSPARENT, NAT, INTL, LOC, IP, URL, DOMAIN, EMAIL

gc_destination_address_plan UNKNOWN, ISDN, TELEPHONY, PRIVATE

gc_destination_sub_address_type UNKNOWN, OSI, USER, IA5

gc_destination_sub_address_plan UNKNOWN

gc_origination_address Default CallerID phone number for outgoing calls made using this channel can be specified here.

gc_origination_address_type TRANSPARENT, NAT, INTL, LOC, IP, URL, DOMAIN, EMAIL

gc_origination_address_plan UNKNOWN, ISDN, TELEPHONY, PRIVATE

gc_origination_sub_address Default CallerID phone sub-number for outgoing calls made using this channel can be specified here.

gc_origination_sub_address_type UNKNOWN, OSI, USER, IA5

gc_origination_sub_address_plan UNKNOWN

gc_chan_info_medium_id Specifies the timeslot to be connected.

gc_chan_info_medium_sel MEDIUM_PREF, MEDIUM_EXCL

gc_call_info_category SUB_NOPRIOR, SUB_PRIOR, MAINT_EQUIP, COIN_BOX, OPERATOR, DATA, CPTP, SPECIAL, MOBILE, VPN

gc_call_info_address_info ENBLOC, OVERLAP


 

VoiceGuide ISDN Tracing

VoiceGuide v6 can also trace the ISDN D-channel messages. A file titled ktTelControl_TraceSelect.txt needs to be placed in "C:\" with the contents of the file indicating which Dialogic's board D-channel is to be traced. Example contents should be:

isdn_trace_dtiB1

which indicates which interface board should have it's D-channel traced.

VoiceGuide will create the traces in "C:\", with the traces named something like this: isdn_trace_dtiB1_0325_203334.log

Traces can be converted into readable format using Dialogic's ISDTRACE.EXE utility.

Converted from CHM to HTML with chm2web Pro 2.7 (unicode)