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]-Section
| Name | Description |
|---|---|
| TraceMask1 | Renamed from [LOGGER] TraceMask Specifies the trace mask of the logger system. The most significant byte specifies whether collected messages are written: < 8 = Off >= 8 = On 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) Default: 0x0000401f |
| TraceMaskCollectMsg1 | Renamed from [LOGGER] TraceMaskCollectMsg Specifies the trace mask of the logger system for collected messages. The least significant byte defines the log level: 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) Default: 0x0 |
| WinEventLogLevel | Renamed from [LOGGER] NTEventLogLevel Specifies the Windows Event Log level: 0 = None 2 = Error 3 = Warning 4 = Info Default: 2 |
| LogArchiveLevel | Specifies the Archive Log level: 0 = None 1 = Failure 2 = Statistic 3 = Info Default: 0 |
[Logger]-Section
| Name | Description |
|---|---|
| Path | Renamed from BsLoggerFilePath Defines the path where log files are stored (absolute or relative to the installation directory) Default: C:\ProgramData\BucherSuter\logfiles\MCAforSiebelCC\ConnectMCAL_Siebel |
| FileSize | Renamed from BsLoggerFileSize Specifies the maximum size of a log file. Default: 100MB |
| MaxBackupIndex | Renamed from BsLoggerMaxBackupIndex Specifies the number of roll files that are used by the file logger. Allowed range: 1-50 Default: 10 |
| WinEventLogSource | Specifies the Windows Event Log identifier Default: ConnectMCAL (Siebel) |
| HandlerStayOpen | Keeps the file handler open until the beginning of a new day. This reduces the writing time on vm's. Default: 0 |
| PerformanceTest | 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 Default: 1 |
| ArchiveFilePath | Defines the path where archive log files are stored (absolute or relative to the installation directory) Default: archive |
| ArchiveFileSize | Specifies the maximum size of a archive log file. Default: 100MB |
[Config]-Section
| Name | Description |
|---|---|
| AgentBestEffortLogin | Tries to log an agent in, even if not all systems are available. 0=off, 1=on Default: 1 |
| AgentRetryRecoveryTimeout | This timeout defines how long ConnectMCAL waits before a previously failed recovery action (either voice and/or media domain) is restarted. The value is specified in milliseconds. Default: 5000 |
| McalMulitInstanceSetup | In a multi-instance setup the agent is probably already logged in on the other instance when a session times out, so the agent should not be logged out on session timeout in a multi instance setup. [0=off, 1=on] Default: 1 |
| RemoteConsoleAddress | 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 Default: 0x7F000001 |
| RemoteConsoleEchoOn | Specifies whether the command-line interface (aka remote console) echoes each character typed by the user. Valid values are either 1 (on) or 0 (off). This parameter comes in handy when the console does not automatically echo each character. [0=off, 1=on] Default: 0 |
| RemoteConsolePort | Specifies the port of the command-line interface (aka remote console). Default: 8030 |
| RemoteWebServerAddress | 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 Default: 0x7F000001 |
| RemoteWebServerPort | Specifies the port of the web service interface. Reserved port 8031. 0 = off. Default: 0 |
| CtiHostA | IP address (or hostname) of CTI server side A Default: <empty> |
| CtiHostB | IP address (or hostname) of CTI server side B Default: <empty> |
| CtiPortA | Port of CTI server side A. Default: 42027 |
| CtiPortB | Port of CTI server side B. Default: 43027 |
| CtiPeripheralID | Defines the Peripheral ID of the corresponding CCE/CCH peripheral gateway Default: 5000 |
| CtiAttachedDataECCVariableName | 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] Default: BAAccountNumber,BABuddyName,BACampaign, BADialedListID,BAResponse,BAStatus,BATimeZone |
| CtiDefaultNotReadyReasonCode | This key is used if not ready reasons are set to required on CCE. |
| CtiDefaultLogoutReasonCode | This key is used if logout reasons are set to required on CCE. |
| CtiProtocolVersion | Specifies the CTI Protocol Version which is used by ConnectMCAL to connect to the CTI Server. There are two valid values for this particular setting, 14 and 20. Default: 20 |
| CtiTimeInQueueVariableName | The parameter in which the timestamp can be found is defined here. A value of NONE or empty switches off the function. |
| CtiTimeInQueueOffsetValue | This value is added to the difference. This can be used to correct a time zone difference. The value can be + and -. |
| MediaChatLocalDomainName | Domain name to generate a valid chat address (i.e. username\@\<MediaChatLocalDomainName>) Default: <empty> |
| McilConnectionDisable | If set, ConnectMCAL does not connect to the MediaManager. Thus, media routing domains and media routing interface are not started. [0=off, 1=on] Default: 0 |
| McilHostA | IP address or hostname of the server hosting MediaManager side A. Default: <empty> |
| McilHostB | IP address or hostname of the server hosting MediaManager side B. Default: <empty> |
| McilPortA | Listening port of MediaManager side A Default: 7050 |
| McilPortB | Listening port of MediaManager side B Default: 7050 |
| TpiWebserviceHost | The IP address (or hostname) that is used for exposing the web service. Default: 127.0.0.1 |
| TpiWebservicePort | The port which is used for the web service. Default: 8015 |
| TpiWebserviceName | The name of the web service. Default: mcal |
| TpiAppUsername | Username that is used by the Communications Toolbar Adapter (and Siebel RoutingAdapter, if installed) to connect to ConnectMCAL Default: mcal |
| TpiAppPassword | Username that is used by the Communications Toolbar Adapter (and Siebel RoutingAdapter, if installed) to connect to ConnectMCAL Default: mcal |
| TpiMaxSession | Maximum third-party-sessions supported by ConnectMCAL. Default: 32 |
| TpiMaxThreadPoolSize | Specifies the maximum number of concurrent threads sending responses and events to the Communication Toolbar Adapter. Default: 32 |
| TpiMsgQueueSizeThreshold | This value defines the upper limit of messages in the service queue. If this limit is reached, a new thread is created. Default: 2 |
| TpiSetDataResponseDelayTimeout | 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. Default: 0 |
| TpiDisableWebserviceSecurity | Specifies, whether ConnectMCAL accepts only unsecured connections (1) or both, unsecured and secured connections (0). Default: 1 |
| TpiUsingNetTcpBinding | 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. Default: 1 |
| TpiAddPerCallKeyInDeliveredEv | 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 Default: 0 |
- The bitwise coded trace mask enables granular logging if needed↩