Skip to main content
Version: 2.7.0

ConnectMCAL

The configuration of ConnectMCAL is stored in a configuration file. The installation program creates this file with the settings entered during setup. The configuration of this component can be adjusted by editing this configuration file. If a configuration setting is not found in the configuration file, the program's default value is used.

Restart service

The service must be restarted for the changes to take effect.

Unless explicitly specified by a command line argument, the path to the configuration file is the name of the executable file with the '.exe' replaced by '.ini' and the instance name used as suffix.

[Dynamic]

TraceMask 1

Default : 0x0000401f

Range : 0 = None, 1 = Fatal Error, 2 = Error, 3 = Warning, 4 = Info, > 4 = Trace

Renamed : Renamed from [LOGGER] TraceMask

Description : Specifies the trace mask of the logger system. The most significant byte specifies whether collected messages are written:
< 8 = Off
>= 8 = On
The most significant byte specifies whether collected messages are written:
0 = None
1 = Fatal Error (least verbose)
2 = Error
3 = Warning
4 = Info
> 4 = Trace (most verbose).

TraceMaskCollectMsg1

Default : 0x0

Range : 0 = None, 1 = Fatal Error, 2 = Error, 3 = Warning, 4 = Info, > 4 = Trace

Renamed : Renamed from [LOGGER] TraceMaskCollectMsg

Description : Specifies the trace mask of the logger system for collected messages. The least significant byte defines the log level:
0 = None
1 = Fatal Error (least verbose)
2 = Error
3 = Warning
4 = Info
> 4 = Trace (most verbose).

WinEventLogLevel

Default : 2

Range : 0 = None, 2 = Error, 3 = Warning, 4 = Info

Renamed : Renamed from [LOGGER] NTEventLogLevel

Description : Specifies the Windows Event Log level:
0 = None
2 = Error
3 = Warning
4 = Info

LogArchiveLevel

Default : 0

Range : 0 = None, 1 = Failure, 2 = Statistic, 3 = Info

Description : Specifies the Archive Log level:
0 = None
1 = Failure
2 = Statistic
3 = Info

[Logger]

FileSize

Default : C:\ProgramData\BucherSuter\logfiles\MCAforSiebelCC\ConnectMCAL_Siebel\

Range : not available

Renamed : Renamed from BsLoggerFilePath

Description : Defines the path where log files are stored (absolute or relative to the installation directory).

FileSize

Default : 100MB

Range : not available

Renamed : Renamed from BsLoggerFileSize

Description : Specifies the maximum size of a log file.

MaxBackupIndex

Default : 10

Range : 1 - 50

Renamed : Renamed from BsLoggerMaxBackupIndex

Description : Specifies the number of roll files that are used by the file logger.

WinEventLogSource

Default : ConnectMCAL (Siebel)

Range : not available

Description : Specifies the Windows Event Log identifier.

HandlerStayOpen

Default : 0

Range : 0=off, 1=on

Description : Keeps the file handler open until the beginning of a new day. This reduces the writing time on vm's.

PerformanceTest

Default : 1

Range : 0 = none, 1 = check, 2 = controlled

Description : Measures the required time to write messages to the logfile :
0 = None
1 = Checks and write time into log file.
2 = Minimizes the log level if the threshold of 2000 milliseconds (2 seconds) is exceeded.

ArchiveFilePath

Default : archive

Range : not available

Description : Defines the path where archive log files are stored (absolute or relative to the installation directory).

ArchiveFileSize

Default : 100MB

Range : not available

Description : Specifies the maximum size of a archive log file.

[Config]

AgentBestEffortLogin

Default : 1

Range : 0=off, 1=on

Description : Tries to log an agent in, even if not all systems are available.

AgentRetryRecoveryTimeout

Default : 5000

Range : not available mSec

Description : This timeout defines how long ConnectMCAL waits before a previously failed recovery action (either voice and/or media domain) is restarted .

RemoteConsoleAddress

Default : 0x7F000001

Range : not available

Description : Specifies the listening IP address (default value sets the address to localhost and should not be changed). This value is hexadecimal encoded. 0x7F000001 = 127.0.0.1 = localhost .

RemoteConsoleEchoOn

Default : 0

Range : 0=off, 1=on

Description : Specifies whether the command-line interface (aka remote console) echoes each character typed by the user. This parameter comes in handy when the console does not automatically echo each character .

RemoteConsolePort

Default : 8030

Range : not available

Description : Specifies the port of the command-line interface (aka remote console) .

RemoteWebServerAddress

Default : 0x7F000001

Range : not available

Description : Specifies the listening IP address (default value sets the address to localhost and should not be changed). This value is hexadecimal encoded. 0x7F000001 = 127.0.0.1 = localhost .

RemoteWebServerPort

Default : 0

Range : 0 = off

Description : Specifies the port of the web service interface. Reserved port 8031 .

CtiHostA

Default : empty

Range : not available

Description : IP address (or hostname) of CTI server side A .

CtiHostB

Default : empty

Range : not available

Description : IP address (or hostname) of CTI server side B .

CtiPortA

Default : 42027

Range : not available

Description : Port of CTI server side A.

CtiPortB

Default : 43027

Range : not available

Description : Port of CTI server side B.

CtiPortSecureA

Default : 42030

Range : not available

Description : Secure port of CTI server side A.

CtiPortSecureB

Default : 43030

Range : not available

Description : Secure port of CTI server side B.

CtiLibOptionalParam

Default : ``

Range : not available

Description : Config key/value pairs.

CtiPeripheralID

Default : 5000

Range : not available

Description : Defines the Peripheral ID of the corresponding CCE/CCH peripheral gateway.

CtiAttachedDataECCVariableName

Default : BAAccountNumber,BABuddyName,BACampaign, BADialedListID,BAResponse,BAStatus,BATimeZone

Range : not available

Description : Specifies which ECC variables are used with ConnectMCAL. The names of the ECC variables must be listed comma separated. Example: user.mcal.01,user.mcal.02 If an ECC variable of type array should be used, the suffix [0/n] must be added to the name of the ECC variable where n is the number of elements in the array. A maximum of 20 ECC variables can be configured (as of b+s Connects for Siebel 2.0.0.2). Example: user.array3x16[0/3].

CtiDefaultNotReadyReasonCode

Default : 0

Range : not available

Description : This key is used if not ready reasons are set to required on CCE.

CtiDefaultLogoutReasonCode

Default : 0

Range : not available

Description : This key is used if logout reasons are set to required on CCE.

CtiProtocolVersion

Default : 20

Range : 14,20,22

Description : Specifies the CTI Protocol Version which is used by ConnectMCAL to connect to the CTI Server.

CtiTimeInQueueVariableName

Default : 0

Range : not available

Description : The parameter in which the timestamp can be found is defined here. A value of NONE or empty switches off the function.

CtiTimeInQueueOffsetValue

Default : 0

Range : not available

Description : This value is added to the difference. This can be used to correct a time zone difference. The value can be + and -.

CtiWaitTimeToSendAutoAnswer

Default : -1

Range : -1=off, 0-10000 mSec

Description : Wait time to execute answer if auto answer is defined.

MediaChatLocalDomainName

Default : empty

Range : not available

Description : Domain name to generate a valid chat address (i.e. username\@\<MediaChatLocalDomainName>).

McilConnectionDisable

Default : 0

Range : 0=off, 1=on

Description : If set, ConnectMCAL does not connect to the MediaManager. Thus, media routing domains and media routing interface are not started.

McilHostA

Default : empty

Range : not available

Description : IP address or hostname of the server hosting MediaManager side A.

McilHostB

Default : empty

Range : not available

Description : IP address or hostname of the server hosting MediaManager side B.

McilPortA

Default : 7050

Range : not available

Description : Listening port of MediaManager side A.

McilPortB

Default : 7050

Range : not available

Description : Listening port of MediaManager side B.

TpiWebserviceHost

Default : 127.0.0.1

Range : not available

Description : The IP address (or hostname) that is used for exposing the web service.

TpiWebservicePort

Default : 8015

Range : not available

Description : The port which is used for the web service.

TpiWebserviceName

Default : mcal

Range : not available

Description : The name of the web service.

TpiAppUsername

Default : mcal

Range : not available

Description : Username that is used by the Communications Toolbar Adapter (and Siebel RoutingAdapter, if installed) to connect to ConnectMCAL.

TpiAppPassword

Default : mcal

Range : not available

Description : Username that is used by the Communications Toolbar Adapter (and Siebel RoutingAdapter, if installed) to connect to ConnectMCAL.

TpiMaxSession

Default : 32

Range : not available

Description : Maximum third-party-sessions supported by ConnectMCAL.

TpiMaxThreadPoolSize

Default : 32

Range : not available

Description : Specifies the maximum number of concurrent threads sending responses and events to the Communication Toolbar Adapter.

TpiMsgQueueSizeThreshold

Default : 2

Range : not available

Description : This value defines the upper limit of messages in the service queue. If this limit is reached, a new thread is created.

TpiSetDataResponseDelayTimeout

Default : 0

Range : not available mSec

Description : This value defines a waiting time in msec between set call data and start consultation call. This ensures that newly set data is available on the GUI side before a subsequent consultation call. Otherwise these can be overwritten by the consultation call.

TpiDisableWebserviceSecurity

Default : 1

Range : 0=off, 1=on

Description : Specifies, whether ConnectMCAL accepts only unsecured connections (1) or both, unsecured and secured connections (0).

TpiUsingNetTcpBinding

Default : 0

Range : 0=off, 1=on

Description : If set to 1 the ConnectMCAL web service is exposed over net.tcp. The connection can be secured with the config key TpiDisableWebserviceSecurity=0. Note: b+s Connects for Siebel supports only net.tcp connections.

TpiAddPerCallKeyInDeliveredEv

Default : 0

Range : 0=off, 1=on

Description : Add the SYS.PeripheralCallKey to the ECC Variable if a Delivered Event is received. To use old EsFlags (ADD_PERIPHERAL_CALL_KEY_AS_FAKED_ECC_VAR and ADD_PERIPHERAL_CALL_KEY_AS_FAKED_ECC_VAR2) set FixIgnoreFlags to 0x80.


  1. The bitwise coded trace mask enables granular logging if needed