Appendix 1: Ini File Settings

Port

The TCP/IP port used by AgentX server on this machine (Default port 700).

700

AllocEnginePerCall

Allocate recognition engine per call. When set to 0 (No), the engine is allocated to the call when the first recognition is required. When set to 1 the engine is allocated at the beginning of the call.

0/1

1

EngineType

Select Speech Recognition Engine.

Nuance

SpeechWorks

MRCP

Nuance

NumberOfEngines

Total number of recognition engines required by the application. NOTE: the actual number may be limited by RTM and (for Nuance only) vendor's licensing.

96

NumberOfVerifyEngines

Nuance only. Number of speaker verification capable engines required by the application. NOTE: the actual number may be limited by Nuance licensing.

0

XferBufSize

Internal transfer buffer size (in Kbs) for Diaglogic card (SR5.1.1 default is 32K). It's only used for CSP recognition. The lower the value is, the faster the recognition will start.

2-32

32

Auto_Init_Flag

Defines whether or not the terminal is an auto initializing terminal.

0/1

0

Fixed_TEI_Value

Defines the TEI to be used for a fixed TEI assigning terminal (0-63).

0

OverlapSend

Sets application to Send overlapped digits.

0/1

0

SPID

Defines the assigned Service Provider Identifier (SPID) value for terminal initialization. It is only applicable to User side US switches. ASCII digit string limited to the digits 0-9 and limited in length to 21.

SwitchSide

Sets the switch side.

0 = USER_SIDE

USER_SIDE

SwitchType

Switch type.

0=ISDN_BRI_5ESS

ISDN_BRI_NET3

TEI_Assignment

TEI setting applies to USER_SIDE only.

0=AUTO_TEI_TERMINAL

AUTO_TEI_TERMINAL

RemoveCallFromQueueOnDTMF

When set to True (1) the call will be removed from the queue on term DTMF.

0/1

0

MVIPBridging

See Conference control.

0/1

1

RestartForSecondMember

0/1

1

Timer

5

AcceptOfferedCalls

Accept calls right away when they are offered. Applicable to GlobalCall, non-ISDN protocol only. When not set, the Ring event of LineGroup control should have logic to decide whether the offered call should be accepted.

0=Do not accept right away
1=Accept right away

1

asr_bufsize

ASR buffer size in bytes.
NOTE: Do not change it unless you are advised to do so by Pronexus.

65536

Autostart

Start the Dialogic drivers automatically when starting the system.

0/1

1

Board1-4

Set board wide protocol. Please consult Dialogic's Global Call Country Dependent Parameters (CDP) Reference for a complete list of protocols.

ConfEntrytone

For conferencing only, it enables a notification tone to all conferees upon entry of a new conferee.

0/1

1

ConfTarifftone

For conferencing only, it enables a tone every 5 minutes to all conferees.

0/1

0

D41

Indicates that D41 cards are in use.

0/1

0

delay_afterblind_ms

Milliseconds to wait after a blind transfer before moving to the next control.

0

delay_beforeblind_ms

Milliseconds to wait before issuing a blind transfer.

0

Disconnect_Cadence

Allows user to change the default tone values for disconnect; the values are similar to the other tone settings (Busy1_Fequency, Busy1_Cadence, etc).

Dialogic defined

Disconnect_Frequency

Disconnect_Repeat

Fastbusy

The toneID of the defined global tone which will be used as fastbusy tone.

1-100

-1

FaxEncoding

Select fax encoding scheme.

MMR

MH

FaxHeader

Whether fax header is to be included on the image page.

0/1

1

InboundProtocol

Defines the inbound protocol.

T1Compatible

ListenMonitor

Listeners in a DCB.

0

NoAnswer

Number of seconds of ringback before "No Answer" is returned.

30

OutboundProtocol

Defines the outbound protocol.

T1Compatible

PCM

Defines voice recognition PCM codec

μLaw
8-bit,8K
16-bit,8K

μLaw

PreFetchBufferSize

Number of bytes to pre-fetch before the sample is first played. Useful only when using a RealSpeak or Speechify TTS engine.

0-65536

24576

RcvFlags

Receive flags.
NOTE: Do not change it unless advised by Pronexus.

0/1

0

SetChannelsInService

If set, VBVoice sets the channels to in-service after the lines are open, otherwise has no effect. Applicable to lines using GlobalCall protocols.

0/1

0

SetChannelsOutOfService

If set, VBVoice sets the channels to out-of-service before the lines are closed, otherwise has no effect. Applicable to lines using GlobalCall protocols.

0/1

0

Tone_1
Tone_2

User customized Global Tone to be used in addition to the default by Dialogic. The values are based on tone, cadence and silence.

TTSFreq

Sampling rate for TTS.

8000

UseDCBCard

Set when using a DCB card for conferencing otherwise disable.

0/1

0

UserIO

Use user defined IO for TTS.

0/1

0

UseStdBeep

Use standard built-in beep.

0/1

0

WaitForTTSData

Number of milliseconds to wait for TTS data to arrive.

0

DiscardTermDigit

Keep termination digit (discarded by default).

0/1

1

AcceptOfferedCalls

This setting will accept calls right away when they are offered, (applicable to GlobalCall, non-ISDN protocols only). When set to 0, the Ring event of LineGroup control should have logic to decide whether the offered call should be accepted.

0/1

1

Autostart

Start the Voice card drivers automatically when the system is started.

0/1

1

ConfEntrytone

Enables a notification tone to all conferees upon entry of a new conferee.

0/1

1

ConfNeedAnnouncer

Allow a conference to reserve one voice resource to be used for both announcer (to play greetings to the conference) and monitor (to TapRecord the conference); TapRecord won't work if disabled.

0/1

0

Conftarifftone

Enables a tone every 5 minutes to all conferees.

0/1

0

Fastbusy

The toneID of the defined global tone which will be used as fastbusy tone.

0-100

-1

H323SignalingPort

Port used for H.323 signalling.

1720

LogLevel

Customize logger level.

1-5

1

SetChannelsInService

If set, VBVoice sets the channels to in-service after the lines are open, otherwise has no effect. Applicable to lines using GlobalCall protocols.

0/1

0

SIPDTMFMode

Defines the DTMF mode for SIP on HMP.

Both

Both

SIPSignalingPort

Port used for SIP signalling.

5060

Tone_1
Tone_2

User customized Global Tone to be used in addition to the default by Dialogic. The values are based on tone, cadence and silence.

TTSFreq

Sampling rate for TTS.

8000

TTSStreamBufferSize

Internal transfer buffer size (in bytes) for Dialogic card.

32768-65536

65536

UseDriversDefaults

Use default settings of the drivers.

0/1

0

IPConnectionMethod
(deprecated)

Defines the connection method.

faststart, slowstart

faststart

EnglishFormat

See description and tables below

FrenchFormat

GermanFormat

ItalianFormat

SpanishCFormat

SpanishSAFormat

JapaneseFormat

PolishFormat

englishformat

English + sayzeroinminslessthan10

italianformat

Usegender + singularpluralhundred + useitaliangender + usethouforyear + useordinalforfirstofmonthonly + sayzeroinminslessthan10

frenchformat

Singularpluralhundred + usethouforyear + useordinalforfirstofmonthonly + sayzeroinminslessthan10

spanishCformat

Usegender + usehundredgender + usethouforyear + useordinalforfirstofmonthonly + useofyear + singularpluralhundred +usegenderhundreds + usegender_twentyonethirtyone + femalemoney + dontuseordinalsfordays

spanishSAformat

Usegender + usehundredgender + usethouforyear + useordinalforfirstofmonthonly + useofyear + singularpluralhundred +usegenderhundreds + usegender_twentyonethirtyone + dontuseordinalsfordays

germanformat

Singularpluralhundred

japaneseformat

Japaneseflag

polishformat

Polishflag

LocalSlot

Controls which machine receives logging information.

\\\\.\\mailslot\\vbvlog

RemoteSlot

Not used.

CallDetailsMaxSize

For VBVStatistics. Max number of characters allowed to show call details.

char

64

MaxCallGroups

For VBVStatistics. Max number of call groups.

64

ChannelAverageCount

For VBVStatistics. Max number of most recent calls under Channel Averaging.

Number of calls

50

TypeAverageCount

For VBVStatistics. Max number of most recent calls used for Type Averaging.

Number of char

ChannelAverageCount

ASRClientPort

Local Ports used to communicate between the MRCP Client and the VBVoice application. Unless there is a port conflict, these should be left empty.

12500

ASRVBVPort

12510

TTSClientPort

12520

TTSVBVPort

12530

ASRDialogicXferBufSize

Sets Dialogic's buffer size for ASR. Should be a multiple of 160.

160-480

320

AsrNrOfAudioBuffers

Number of MRCP Buffers pre-allocated for ASR.

400-10240

400

TtsNrOfAudioBuffers

Number of MRCP Buffers pre-allocated for TTS.

400-10240

400

VBVClientAddress

MRCP Client IP in IPv4 dot notation. If unset (Default), the local IP address will be used.

ClientContactPort

MRCP Client port to be used in INVITE's contact header field. Used for MRCP servers (like Aumtech) that try to reconnect to the client after closing SIP connection with the contacts provided in the INVITE's contact field. This is important to be set to an unused TCP port when using HMP and such MRCP servers.

5060

TtsServerAddress

MRCP TTS Server IP in IPv4 dot notation. If unset (Default), MRCP TTS will not be available.

TtsServerPort

MRCP TTS Server port.

5060

TTSServerPortIsTCP

The TTS Server Port is using TCP.

0/1

1

TtsServersAddresses

A comma separated list of MRCP TTS Servers (in IPv4 dot notation colon port).

TtsServerAddress

TtsRtpAudioPortsRanges

A comma separated list of ports ranges to be used for TTS RTP Audio.

41000-48999

AsrServerAddress

MRCP ASR Server IP in IPv4 dot notation. If unset (default), MRCP ASR will not be available.

AsrServerPort

MRCP ASR Server port.

5060

ASRServerPortIsTCP

The ASR Server Port is using TCP.

0/1

1

AsrServersAddresses

A comma separated list of MRCP ASR Servers (in IPv4 dot notation colon port).

AsrServerAddress

NrOfTTSSpeakers

Number of speakers the MRCP TTS engine can provide. Set the value of this key to the number of speakers you want your application to be able to use from the MRCP server it is connected to. The keys TTSSpeaker_xx in this section should provide the speaker names.

TTSSpeaker_00
TTSSpeaker_01
TTSSpeaker_02
TTSSpeaker_03
TTSSpeaker_04

The name of the TTS speakers supported my the MRCP TTS engine.

MinTimeBetweenInvites

The Default time between INVITE requests sent to the same MRCP server. A none zero value here introduce a delay between INVITE requests to give the MRCP server a chance to be ready to create a new session after another. This is important for some servers like Aumtech which allows up to 3.6 requests per second, for that example a good value would be 300.

milli seconds

0

AllocEnginePerCall

If set to 1, VBVoice will grab an engine when the call starts. If set to 0, the engine is grabbed only when entering the first control which needs Nuance processing.

0/1

1

AllowBargeIn

Indicates whether barge-in is needed.

0/1

1

ConfidenceRejectionThreshold

Sets the recognition confidence threshold. The server rejects any utterance whose confidence score is smaller than the threshold.

%

5

DynamicAlloc

Used to determine whether VBVoice should dynamically allocate CSP resources to the recognition engine according to the channel. When turned off, the number of recognition engines must equal the number of channels in use.

Applicable only to CardType=Dialogic

0/1

1

InitializeTimeout

Timeout to wait for an engine to be created.

s

20

NuanceCSP

Use native CSP support offered by Nuance Dialogic Audio Provider (must be Nuance 8 or later).

0/1

1

RecClientDebugLevel

Sets the level of Nuance debug (0 to 6) for the recclient process.

2

RecClientPort

The port used by the recClient process.

9200

VoiceResources

Used for Antares-less configuration. It is a range of voice channels using Dialogic naming of voice resources, for instance: dxxxB2C2-dxxxB4C3

XferBufferSize

Internal transfer buffer size (Ks) for Diaglogic card (default is 32K). It's only used for CSP recognition. The lower the value is, the faster the recognition will start.

2-32

32

NLogServer

Diagnostic log level for NLogServer.exe (c:\nlogsvr.log)

-1 = Use PfxLogLevel in [System]
0 = Off
1 = Errors
2 = Trace
3 = Debug
4 = DebugHi

-1/0/1/2/3/4

-1

NLogX

Diagnostic log level for NLogX.DLL (c:\nlogx.log)

-1 = Use PfxLogLevel in [System]
0 = Off
1 = Errors
2 = Trace
3 = Debug
4 = DebugHi

-1/0/1/2/3/4

-1

PortageDLL

Diagnostic log level for Portage2.DLL (c:\portagedll.log)

-1 = Use PfxLogLevel in [System]
0 = Off
1 = Errors
2 = Trace
3 = Debug
4 = DebugHi

-1/0/1/2/3/4

-1

TapiDLL

Diagnostic log level for TapiDLL.DLL (c:\tapidll.log)

-1 = Use PfxLogLevel in [System]
0 = Off
1 = Errors
2 = Trace
3 = Debug
4 = DebugHi

-1/0/1/2/3/4

-1

VBVArbiter

Diagnostic log level for VBVArbiter.EXE (c:\vbvarbiter.log

-1 = Use PfxLogLevel in [System]
0 = Off
1 = Errors
2 = Trace
3 = Debug
4 = DebugHi

-1/0/1/2/3/4

-1

VBV32OCX

Diagnostic log level for VBV32OCX.OCX (c:\vbv32ocx.log)

-1 = Use PfxLogLevel in [System]
0 = Off
1 = Errors
2 = Trace
3 = Debug
4 = DebugHi

-1/0/1/2/3/4

-1

VBV32SS

Diagnostic log level for VBV32SS.DLL (c:\vbv32ss.log)

-1 = Use PfxLogLevel in [System]
0 = Off
1 = Errors
2 = Trace
3 = Debug
4 = DebugHi

-1/0/1/2/3/4

-1

NLogServer

Diagnostic log level for NLogServer.exe (c:\nlogsvr.log)

-1 = Use PfxLogLevel in [System]
0 = Off
1 = Errors
2 = Trace
3 = Debug
4 = DebugHi

-1/0/1/2/3/4

-1

NLogX

Diagnostic log level for NLogX.DLL (c:\nlogx.log)

-1 = Use PfxLogLevel in [System]
0 = Off
1 = Errors
2 = Trace
3 = Debug
4 = DebugHi

-1/0/1/2/3/4

-1

PortageDLL

Diagnostic log level for Portage2.DLL (c:\portagedll.log)

-1 = Use PfxLogLevel in [System]
0 = Off
1 = Errors
2 = Trace
3 = Debug
4 = DebugHi

-1/0/1/2/3/4

-1

VBV32OCX

Diagnostic log level for VBV32OCX.OCX (c:\vbv32ocx.log)

-1 = Use PfxLogLevel in [System]
0 = Off
1 = Errors
2 = Trace
3 = Debug
4 = DebugHi

-1/0/1/2/3/4

-1

VBV32SS

Diagnostic log level for VBV32SS.DLL (c:\vbv32ss.log)

-1 = Use PfxLogLevel in [System]
0 = Off
1 = Errors
2 = Trace
3 = Debug
4 = DebugHi

-1/0/1/2/3/4

-1

FwdDigitsVariable

Set to 1 to allow variable number of mailbox digits (digit collection terminates on # or timeout).

0

FwdDigitsLen

Number of digits when requesting mailbox number to forward to.

3

RecChopSecs

Deletes data from the end of recorded messages to delete tones.

ms

0 (Dialogic)

100 (Tapi)

RecChopSil

Deletes silence from end of recorded messages when ending in silence.

0 / 1

0

RecChopDialTone

Deletes dialtone from end of recorded messages when ending in dialtone.

0/1

0

IgnoreTermDigit

If 1, will discard digit that terminates a recording, if 0, will leave digit in buffer for option digit processing.

0/1

0

BringLogWindowToFront

Disables the startup feature that sets the log window (NLog or VBVLog) as the frontmost window.

0/1

1

DeleteOldLogs

Files older than a specified number of days are deleted at midnight.

days

0

Digit1, Digit2, Digit3, Digit4, Digit5

Custom system phrases. Digit1 to 5 refer to vbvoice30.vap index and should be recorded by the user.

IniRedirect

Causes VBVoice to look for settings first in the local VBVoice.INI, and then in the "redirect" path (usually the master machine).

LineStat

For VBVLog only: sets the path to the VBVLog.

C:\Program Files\Pronexus\

Logs

Enables or disables writing and creation of the log.

Set to 1 logging enables; set to 0 logging disabled.

0/1

1

IgnorePhraseErrors

Prevents call drop on phrase error.

0/1

0

OffHookIdle

Busy out lines on shutdown.

0/1

0

PfxLogLevel

Disables or enables a diagnostic log of VBVoice components. A value of 0 disables the logs. Values 1 through 4 enable increasing amounts of detail in the logs. See [PfxLog] for more information.

0-4

0

PlayEntryAfterError

Changes error handling to stop play of Entry Greeting after Invalid or Silence greetings.

0/1

1

SecureLog

Set to 1 to flush event logs after each write.

0

UseVBVLog

Set to 0 to enable nLog or 1 to enable VBVLog.
Note: VBVLog also requires a valid setting for linestat.

0/1

1

DelayMode

Wait during audio playing for Wave buffers to fully clear.

0/1

1

PlayDelay

Delay (in msecs) before begin playing.

msecs

100

EngineType

Sets the TTS engine to be used by VBVoice.

MRCP TTS Server

Speechfiy

RSTelecom (Scansoft RealSpeak Telecom)

Manufacturer

TTS engine manufacturer author.
Replaces TTS|MfgName.

Nuance

Aumtech

NumberOfEngines

Maximum number of lines to open for TTS - overrides licensed number.

StreamPlay

Activate Streaming mode.

0/1

1 for MRCP, 0 otherwise

Codec1

For Dialogic CallControl this is the preferred codec for HMP calls, choose among g711, g723 and g729. For Pronexus CallControl use one of g711, g723 or g729 to indicate the preferred codec. To disallow g711 you have to set this value to one of the other 2 options.

G711

Codec2

For Dialogic CallControl this is the secondary codec for HMP calls, choose among g711, g723 and g729. For Pronexus CallControl use one of g711, g723 or g729 to indicate the secondary codec.

none

Codec3

For Dialogic CallControl this is the third codec for HMP calls, choose among g711, g723 and g729. For Pronexus CallControl use one of g711, g723 or g729 to indicate the third codec.

none

Codec1FramesPerPacket

For Dialogic CallControl these are the frames per packet for selected codec (frame size for G711), set to 0 for default values.
Default values are 20 for G711, 2 for G723 and 3 for G729.

0

Codec2FramesPerPacket

0

Codec3FramesPerPacket

0

DigitalVoiceOffset

Offset for digital voice resources.  Used to change allocation of voice resources on IPLink cards.

0

IPConnectionMethod

Connection method for SIP/H323.

faststart

faststart

RegAddressPhone

For H323 only, to register end-pointer with a PSTN phone number in E164 format.

RegEndPointIP

Client address, eg: user@192.168.0.5 for SIP; or 192.168.0.5 for H323.

RegMaxHops

For H323 only, to specify the maximum number of hops that a packet can take before being discarded or returned when using multicasting.

RegProtocol

Perform registration with the selected protocol. Specify None to disable registration.

none

RegServerIP

Registration Server IP in IPv4 dot notation. 0.0.0.0 (default) means automatic registration server discovery. A port number can be specified as in 192.168.0.1:1718.

0.0.0.0

RegTerminalAlias

For SIP, this is the alias of the user agent. For H323, this is the email address of the end-pointer.

RegTimeToLive

When using SIP, auto-refresh is used. If the application does not explicitly set the RegTimeToLive value, the VBVoice automatically sets the Expires header field in the REGISTER request to a value of 7200 seconds. If the application wishes to request a longer or shorter auto-refresh interval, it simply sets the RegTimeToLive field to the appropriate value.

AcceptReinvite

When set, VBVoice will accept re-invite requests.
NOTE: Do not set both AcceptReinvite and RejectReinvite.

0

RejectReinvite

When set, VBVoice will reject re-invite requests.
NOTE: Do not set both AcceptReinvite and RejectReinvite.

0

RetrieveSipHeader

(SIP Only) When enabled, VBVoice will offer the specified header value (if available on the SIP message) on the Raw Call Info property.
Note: GetRawCallInfo needs to be enabled.

SipAuthenticationPassword

SIP authentication username and password identify the user.

SipAuthenticationRealm

SIP authentication realm where identifies the protected domain.

SipAuthenticationUsername

SIP authentication username and password identify the user.

SipDefaultTransportProtocol

Set the default transport protocol for SIP messages.
Note: SipTCPEnabled must be set, otherwise this setting is ignored.

TCP

UDP

SipTCPEnabled

Enable TCP transport for SIP messages.

0/1

0

UseDynamicResource

Force use of dynamic resources allocation on IPLink board. VBVoice does not automatically assign or grab voice resource for the digital channel.

0/1

1

ConfVolDownDigit

Sets a digit to decrease listener volume.

0-9,#,*

-

ConfVolResetDigit

Sets a digit to reset listener volume.

0-9,#,*

-

ConfVolUpDigit

Sets a digit to increase listener volume.

0-9,#,*

-

DIDDigitDelay

Max silence while waiting for DID digits.

seconds

2

DisableLCDetect

Disables detection of loop current drop.

0/1

0

Flash_character

The character to be used in dial strings for a hook flash.

!

Flashtime

Duration of a hook flash.

ms

500

Ground_character

Character used to signal an earth recall.

G

LoadDriver

Loads the appropriate voice interface DLL into memory. For Dialogic voicecards, attempts to load the driver when opening in design mode or on Start System, if the driver is not already started.

0/1

0

LoopCurrentDropTime

Duration of loop current drop.

ms

Voice card dependent

MaxDialToneWait

Maximum time to wait for dialtone.

seconds

6

MinDialTone

Minimum duration of dialtone.

seconds

2

PauseTime

Duration for a pause character (comma) during dialling.

ms

Voice card dependent:

0 for Dialogic

Ring_cnt_reset

Minimum time between calls.

seconds

10000

Type

Selects the voicecard type in use.

Dialogic
Tapi
OldTapi
Simulator
IntelHMP
Intel
None

None

UseAlaw

Use A-law compression instead of μ-law for sound card and Tapi cards.

0/1

0

Voxconvert

If set to 1, uses format conversion by VBVoice instead of Windows ACM when playing to sound card or TAPI.

0/1

0

PacketSize

Sets the size of the data packets used to communicate with the Speechify Server. It will take longer to start receiving large data packets, but the overall communication overhead will be cheaper.

1 = 1K
2 = 2K
3 = 4K
4 = 8K

3

Speaker_AddrX

Sets the address of the speaker on the network, in the format:
hostName:portNumber.

X is a running number range from 1 to 10. For example:
Speaker_Addr1=jupiter:5555

No default value

Speaker_AddrX

Sets the address of the speaker on the network, in the format:
hostName:portNumberer
\Lang=allowable_language
\Gender=allowable_gender.

 
X is a running number range from 1 to 10. For example:
Speaker_Addr1=jupiter:5555
\Lang=US_ENGLISH
\Gender=Male

Lang=
US_ENGLISH
MEXICAN_SPANISH

Gender=
Male
Female

No default value

HTMLTemplate

The name of the file containing the HTML template used to generate the web pages for the data sessions. This file must exist in VBVoice program files directory.

halcyon.html,
allotrope.html,
chromatic.html,
luminous.html,
or
html_template.html

html_template.html

NumOfDATASessions

Number of DATA sessions.

0