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↩