Real Time Status Information
Command-Line Interface (Console)
The command-line interface is the main interface to the b+s Connects for Siebel processes. You can use the command-line interface to get information directly from these processes or set specific configurations. Several monitors can be run at the same time. The impact on the system’s performance is minimal, and the monitor’s features are kept for each session.
Please note that only one access is supported (by default localhost).**
The monitor telnet process supports local commands, which are defined within the monitor. This section provides a list of basic monitor commands for use with processes such as <list_ > or <dump_ >.
A telnet session can be started by entering the following command at a DOS command prompt:
C:\>telnet localhost <RemoteConsolePort>
<RemoteConsolePort> is the address of the gateway port, which is stored in the initialization file under the [Config] or [MAIN] sections or in the [Driver Parameters] depending on the components.
A welcome screen appears after a successful connection has been established. Following an example from the b+s ConnectMCAL:
Welcome to b+s MCAL (ConnectMCAL)
remote>
The parameter for the telnet port differs by the components.
Default Telnet Ports
| Component | Key Name | Default Value |
|---|---|---|
| Communication Toolbar Adapter | RemoteConsoleBasePort | 8040 |
| ConnectMCAL | RemoteConsolePort | 8030 |
| Media Manager | REMOTE_PORT | 7010 |
| DataStore | RemoteConsolePort | 9010 |
| Routing Adapter | TelnetServerPort | 9095 |
| Chat Connector | TelnetServerPort | 9015 |
Communication Toolbar Adapter
After the monitor is started, the following prompt will be visible:
b+s MCA for Siebel
Communication Toolbar Adapter Bucher + Suter AG, 2023
--------------------------------------------------------------------------------
Welcome to MCA for Siebel Communication Toolbar Adapter remote console.
--------------------------------------------------------------------------------
Type 'help' to show a list of the commands available. Type 'quit' to exit.
List of Commands
To display a basic list of commands, type help. The following list is displayed:
> help
Available commands are:
Command Aliases Parameters Description
-----------------------------------------------------------------------------
quit exit Quit the console.
help Display this help text.
LogBookmark lb [optional text] Writes a bookmark into the
log file
ls [!|serviceSessionId] List registered sessions
la [!|agentId] List logged in agents
lc [!|callId| List ongoing calls
[serviceSessionId
agentSessionId]]
lt [!|taskId| List ongoing tasks
[serviceSessionId
agentSessionId]]
log [mask Show or change log masks
[newTraceMask]|
collected_mask
[newTraceMask]|
collected
[enable|disable]|
test]
status s Show driver information
config c Show agent configuration
system_usage_info sui [!|memory|thread[wor Shows the system resource
ker|io]|cpu] usage
>
The most important commands to check the current status are the following:
s(show driver information)la(list logged in agents)ls(list registered sessions)
Status Information
In order to display status information, type status. The following list is displayed:
> status
---Driver Information---
File: C:\Program Files (x86)\BucherSuter\...\CommunicationToolbarAdapter.dll
Version: 2.4.7643.16776
---Logger Status---
Log File: C:\ProgramData\BucherSuter\logfiles\MCAforSiebel\Driver\MCA_For_Siebel_0.log
Log Level: Debug
Log TraceMask: 0x8FFFFFFF
CollectedLog Status: enabled
CollectedLog Level: Info
CollectedLog TraceMask: 0x00000004
Error Count: 0
Warn Count: 0
>
Remote access from ConnectMCAL
The Communication Toolbar Adapter command-line interface commands are also accessible from the ConnectMCAL command-line interface.
If you don’t have direct access to the server where the Communication Toolbar Adapter is running, you can invoke these commands remotely from the ConnectMCAL command-line interface.
ConnectMCAL can forward a request to one or multiple connected Communication Toolbar Adapter instances and display the response. For more information, please see command trc in the description of the ConnectMCAL command-line interface.
ConnectMCAL
List of Commands
Entering "help" shows the available commands:
remote> help
Available help:
---------------
Categories:
Default: Contains standard commands like help.
list: list commands
admin: admin commands
Name Aliases Parameters Description
--------------------------------------------------------------------------------------------
echo Switch echo on and off.
exit quit Terminates this session.
help ? [Category] Generated help for commands.
help flags list all flag commands
Status s displays an applicaion health page
SStatus ss displays an applicaion health page
ConfigStatus cs Display config status and all failures
PrintEnv pe Print environment
Trace t [mask] Set trace: with param, set mask and
level; w/o param, toggle trace on/off
CollectedTrace ct [mask] Set collected msg: with param, set mask
and level; w/o param, toggle trace
on/off
SpecialFailure sf [key] count of special failure
LogBookmark lb [bookmark text] write a bookmark stamp as info line to
logfile with bookmark text
TpiRemCmd trc sesId remote command to tpi
* cmd [param]
GetConfigAgent gca key [mask] list all cti config agent data by
search key and optional search criteria
mask 0x0 .. 0x3f.
GetConfigAgent gca key [mask] list all cti config agent data by
search key and optional search criteria
mask 0x0 .. 0x3f.
ResetAgentMonitor [agentid] reset an agent monitor by agent id
ResetTransactionMonitor ID [Key] reset a transaction monitor by agent
id
KillAgent ka [agentid] triggers an AgentEndMonitor Request
(forced)
FlashLogBuffer flb flush the buffer from log
ForcedOpenNewLog fol open a new logfile
CrashTheApp crash the app to test minidump
ListAgents la [agentid] List all logged in agents with the
current states
DumpAgents da [agentid] Dump all agent monitor entries by all
agents
ListTransaction lt List all transactions states
DumpTransaction dt Dump all transaction monitor entries by
all transactions
ListTpiDllInfo ltdi List tpi dll info
DumpTpiDllInfo dtdi Dump tpi dll info
ListCtiConnect lcc List cti connect info
DumpCtiConnect dcc dump cti connect info
ListFailure lf List Failure
remote>
The most important commands to check the current status are the following:
s(displays an application health page)la(list all logged in agents with the current status)trc(remote command to tpi - invoke CTA console commands remotely from ConnectMCAL, either by specifying an explicit session id[sesId]or an asterisk[\*]to broadcast the command to all active CTA sessions.)
Example trc command
| Command | Description |
|---|---|
trc * lb Investigation started | Writes a bookmark containing "Investigation started" to every active CTA log file |
trc * log trace enable | Enable trace log level for all active CTA sessions |
tpi_dll_info(ltdi) lists information about third party interface (TPI) to Siebel respectively information about the TPI sessions from the Communication Toolbar Adapter to ConnectMCAL
remote>ltdi
ListTpiDllInfo (2023.09.19 10:18:23)
-------------------------------------------------------------------------------------------
List of active TPI Sessions
----------------------------------------
Session 0 (V5):
State: SESSION_ACTIVE
ClientIdentifier: Instance 0, ConsolePort 8040 (siebelserver.domain)
ClientTypeId: SIEBEL (V2)
ConfigPool:
Status Information
In order to display status information, type status. The following list is
displayed:
remote>s
Status (2023.06.26 15:16:32)
-------------------------------------------------------------------------------------------
Start Time: 2023.06.26 - 15:16:01 (UTC: 13:16:01)
Up Time: 12 Days 4 Hours
File Name: ConnectMcal.exe
Version: 3.x.x (...)
DLL Version: TPI: 3.x.x (...)
Application Status: ACTIVE
Work Path: 'C:\Program Files (x86)\BucherSuter\MCAforSiebelCC\mcal'
Data Path: 'C:\ProgramData\BucherSuter\MCAforSiebelCC\mcal'
Proc Name: ConnectMcal
Config URL: 'C:\ProgramData\BucherSuter\MCAforSiebelCC\mcal\ConnectMCAL_Siebel.ini'
Config Status: warning detected
Connect Info Cti: SideA[pgserver.domain:42027] - connected (cti prot: 20)
Connect Info Media: MSrvA[wait to connect] - connecting
ARM: offline, MRI: offline
Alloc Msg Obj Count: 0
Access Obj Count: 0
Search Param Obj Count: 0
Media Obj Count Total: 0
Call Obj Count: 0
Media Obj Count: 0
Media Domain Obj Count: 0
Timer Schedule Count: 4
Agents Transactions
Monitor Act Obj: 0 0
Idle Obj: 0 0
Queued Messages: 0 0
Waiting Messages: 0 0
Activate Count: 0 0
MGR Queue: 0
TPI Queue: 0
ICM Cti Queue: 0
MM Queue: 0
Web Service: online
Web Address V5: net.tcp://1.2.3.5:8014/V5/mcal (plain)
Trace / Collected: 0x03702808 (Trace) / 0x00000004 (Info)
Failure: 0 Errors / 2 Warnings
remote>
Determine Siebel server and driver instance where agent is logged in
To find the Communication Toolbar Adapter logfile or Communication Toolbar Adapter console for a currently logged in agent, you may need to know on which Siebel server and which Communication Toolbar Adapter instance number the agent is logged in on and what the console port of this instance is.
Use list_agents agentid /TSI to find that information:
remote> list_agents 12345 /TSI
ListAgents (2023.06.26 15:41:08)
-------------------------------------------------------------------------------------------
00006 12345 556677 VoiceActive-MediaActive
TPI Ses Info: 30 /Instance 1, ConsolePort 8040 (siebelsvr02.domain.lan)
remote>
Media Manager
List of Commands
Entering help shows the available commands:
remote> help
Available help:
---------------
Categories:
Default: Contains standard commands like help.
admin: admin commands
list: list commands
Name Aliases Parameters Description
--------------------------------------------------------------------------------------------
echo Switch echo on and off.
exit quit Terminates this session.
help ? [Category] Generated help for commands.
help flags list all flag commands
status s Display gateway status
sstatus ss Display gateway status short
RoutingStatus rs Display routing status
RMStatus rms Display redundance manager status
LogBookmark lb [bookmark text] write a bookmark stamp as info line to
logfile with bookmark text
Trace [mask] Set trace: with param, set mask and
level; w/o param, toggle trace on/off
CollectedTrace [mask] Set collected msg: with param, set mask
and level; w/o param, toggle trace
on/off
WinEventLogLevel well level Set Win Event Log Level: 0=off,
2=statistic, 3=info
ArchiveLogLevel all level Set Archive Log Level: 0=off, 1=error,
2=statistic, 3=info
SpecialFailure sf [comment] count of special failure
ConfigStatus cs Display config status and all failures
CrashTheApp crash the app to test minidump
PrintEnv pe Print environment
ForcedOpenNewLog fol open a new logfile
ListAgents la [id Shows a list of all agents, or filtered
name] by agentid or loginname
ListResources lr Shows a list of all resources
PjArm a Shows list of pennding jobs in arm
handler
PjReq r Shows list of pennding jobs in request
handler
PjReqEx rex key Shows list of parameter of pennding
jobs in request handler
remote>
The most important commands to check the current status are the following:
s(display gateway status)la(shows a list of all agents, or filtered by agentid or loginname)
The remote console command "trace" without [mask] argument can be used to toggle trace on/off.
Status Information
In order to display status information type status. The following list is displayed:
remote>status
Status (2023.06.26 15:16:32)
-------------------------------------------------------------------------------------------
Start Time: 2023.06.26 - 15:16:01 (UTC: 13:16:01)
Up Time: 12 Days 4 Hours
Config Status: ok
Trace Level
----------------------------------------------------------------------------------
Trace Mask: (Trace) 0x00044018
Trace Collected Mask: (Trace) 0x00000000
Connections
----------------------------------------------------------------------------------
MRI connected from mediapgserver.domain (x.x.x.x) (con. count: 1)
Routing is enabled.
ARM[0] SideA(ctiservera:42027) (con. count: 1)
Redundancy state is Active.
MCIL clients: 1
- 7050 <- x.x.x.x/port, RefId:1, Client:'ConMCal', CTime:2023.09.19-12:16:32
MCIL routing sessions: 0
ResourceControl Counters
----------------------------------------------------------------------------------
Agents : 0
Pending jobs : 0
- Request jobs : 0
- ARM[0] jobs : 0
ReqMsg : 0
ArmMsg : 0
MriMsg : 0
AgtMsg : 0
CcMaps : 0
TableMaps : 0
Queue Sizes
----------------------------------------------------------------------------------
Agt-Queue : 0
Req-Queue : 0
MRI-Queue : 0
ARM-Queue[0] : 0
Task counters
----------------------------------------------------------------------------------
RouteRequests : 0
RouteFailures : 0
Rejected overflow : 0
Routed to agent : 0
Routed to label : 0
Canceled requests : 0
Queued tasks : 0 (max=5000, reserved prio=0)
Failure Counters
----------------------------------------------------------------------------------
Errors Count: 0
Warnings Count: 0
Short Status Information
In order to display short status information type sstatus. The following list is displayed:
remote>sstatus
Short State (2023.06.26 15:16:32)
-------------------------------------------------------------------------------------------
Start Time: 2023.06.26 - 15:16:01 (UTC: 13:16:01)
Up Time: 12 Days 4 Hours
Config Status: ok
Trace Mask: (Trace) 0x00044018
Trace Collected Mask: (Trace) 0x00000000
MRI connected from mediapgserver.domain (x.x.x.x) (con. count: 1)
Routing is enabled.
ARM[0] SideA(ctiservera:42027) (con. count: 1)
Redundancy state is Active.
MCIL clients: 1
- 7050 <- x.x.x.x/port, RefId:1, Client:'ConMCal', CTime:2023.09.19-12:16:32
MCIL routing sessions: 0
Agents : 42
Errors Count: 0
Warnings Count: 0
Config Status Information
In order to display config status information type configstatus. The following list is displayed:
remote>configstatus
Config Status (2023.06.26 15:16:32)
-------------------------------------------------------------------------------------------
Config Status: warning detected
W => incorrect path ending. please terminate path with '\'
W => PORT is used in section [ICM0], please use section [MRI]
W => LOCAL_MM_INSTANCE_UDP_PORT is used in section [REDUNDANCY], please use UDP_PORT
W => SECOND_MM_INSTANCE is used in section [REDUNDANCY], please use REMOTE_HOST
Redundancy Management Information
In order to display redundancy management information type rmstatus. The following list is displayed:
remote>rmstatus
Redundancy Manager State (2023.06.26 15:16:32)
-------------------------------------------------------------------------------------------
State: Active
Remote State: not connected
Special Failure Information
In order to display special failure information type specialfailure. The following list is displayed:
remote>specialfailure
SpecialFailure (2023.06.26 15:16:32)
-------------------------------------------------------------------------------------------
ao : arm offline
DayCount = 0, TotalCount = 0
mo : mri offline
DayCount = 0, TotalCount = 0
aml : arm message length to long
DayCount = 0, TotalCount = 0
alf : agent login failure
DayCount = 0, TotalCount = 0
rm : redundancy manager
DayCount = 2, TotalCount = 2
mf : main failure
DayCount = 2, TotalCount = 2
List Agent
In order to display agent information type listagents. The following list is displayed:
remote>listagents
ListAgents (2023.06.26 15:16:32)
-------------------------------------------------------------------------------------------
AgentID Loginname InternalID AgentSktID MRDs
- 1234567 0000000001 0000010191 5000, Tasks:00(01), state=MM_AGENT_STATE_READY(0)
Log Bookmark
This command is useful to mark a certain event in the log with a label. To set a label use the command logbookmark test this command.
remote>logbookmark test this command
LogBookmark (2023.06.26 15:16:32)
-------------------------------------------------------------------------------------------
Bookmark-001 is written to log
Print Environment
This command shows the loaded configuration parameters from the ini-file. Only those parameters which deviate from the default value are displayed. To print environment, type printenv.
remote>printenv
PrintEnv (2023.06.26 15:16:32)
-------------------------------------------------------------------------------------------
[LOGGER]
PATH 'C:\ProgramData\BucherSuter\logfiles\...'
WIN_EVENT_LOG_SOURCE 'MediaManager'
TRACE_MASK 0x00044018 [Default: 0x0]
[MAIN]
REMOTE_PORT 7019 [Default: 0]
[MCIL]
PORT 7055 [Default: 7050]
[MR_DOMAINS]
MAIL 5000 [Default: 0]
CHAT 5001 [Default: 0]
[CTISERVER_1]
HOST_A 'ctiservera'
HOST_B 'ctiserverb'
PERIPHERALID 5002 [Default: 0]
APPLICATIONPATHID 5005 [Default: 5000]
[MRI]
MAX_PROTOCOL_VERSION 1 [Default: 4]
ECC01 'user.BS_inout'
[REDUNDANCY]
internal enabled 1 [Default: 0]
REMOTE_HOST 'mediamanagerservera'
UDP_PORT 1818 [Default: 0]
THIS_IS_SIDE 'B' [Default: 'A']
Data Store
List of Commands
In order to display a basic list of commands, type help. The following list will be displayed:
remote>help
Available help:
---------------
Categories:
Default: Contains standard commands like help.
admin: admin commands
list: list commands
Name Aliases Parameters Description
--------------------------------------------------------------------------------------------
echo Switch echo on and off.
exit quit Terminates this session.
help ? [Category] Generated help for commands.
Status s displays an applicaion health page
SStatus ss displays an applicaion health page
ConfigStatus cs Display config status and all failures
PrintEnv pe Print environment
Trace t [mask] Set trace: with param, set mask and
level; w/o param, toggle trace on/off
CollectedTrace ct [mask] Set collected msg: with param, set mask
and level; w/o param, toggle trace
on/off
SpecialFailure sf [key] count of special failure
LogBookmark lb [bookmark text] write a bookmark stamp as info line to
logfile with bookmark text
ViewEsFlags vef view the es flag mask
SetEsFlags sef <full mask> set a new es flag mask
add <mask>
sub <mask>
ViewFixFlags vff view the fix flag mask
SetFixFlags sff <mask> set a new fix flag mask
add <mask>
sub <mask>
ViewFixIgnoreFlags vfif view the fix ignore flag mask
SetFixIgnoreFlags sfif <mask> set a new fix ignore flag mask
add <mask>
sub <mask>
FlashLogBuffer flb flush the buffer from log
CrashTheApp crash the app to test minidump
ListTransaction lt List all transaction states
DumpTransaction dt Dump all transaction monitor entries by
all transactions
ListDsDllInfo lddi List ds dll info
DumpDsDllInfo dddi dump ds dll info
remote>
Status Information
In order to display status information, type status. The following list will be displayed:
remote>status
Status (2023.09.20 12:57:58)
-------------------------------------------------------------------------------------------
Start Time: 2023.09.20 - 12:12:43 (UTC: 10:12:43)
Up Time: 0 Days 0 Hours
File Name: DataStore.exe
Version: 2.3.2 (3c1ceb3fd64-20230919)
DLL Version: DS: 2.3.2 (b7f25212d13-20230630)
Application Status: ACTIVE
Work Path: 'C:\Program Files (x86)\BucherSuter\bsCommonComponents\DataStore\stable\'
Proc Name: QA-Common-B-stab
Config URL: 'C:\ProgramData\BucherSuter\bsCommonComponents\DataStore\stable\DataStore_QA-Common-B-stab.ini'
Config Status: ok
Alloc Msg Obj Count: 0
Access Obj Count: 0
Search Param Obj Count: 0
Timer Schedule Count: 3
Transactions
Monitor Act Obj: 0
Idle Obj: 0
Queued Messages: 0
Waiting Messages: 0
Activate Count: 0
Trace / Collected: 0x00000004 (Info) / 0x00000000 (Off)
Failure: 0 Errors / 0 Warnings
remote>
Routing Adapter
List of Commands
Entering help shows the available commands:
> help
Available commands are:
Command Aliases Parameters Description
-----------------------------------------------------------------------------
consolelog cl status/on/off [log Displays log messages in the
level] console.
list_tasks lt,list_t [ no parameters | Lists all active tasks
SI | ID taskid |
URL mediaurl | FROM
sender | TO
recipient | STATUS
status | RJSTATUS
routingJob-Status|
SUBJECT
beginOfSubject]
log l Shows the current logger
configuration
configuration c,conf o|d Information about the current
configuration file
help Display this help text.
httpsrv start|stop|status Control the HTTP server.
list_gates lg List gates.
quit exit Quit the program.
status s [mask] Get status of the connector.
telnetsrv telnet start|stop|status Control the telnet server.
version v all (optional) Display version information.
GC.Collect() gc Calls GC.Collect().
Minidump dmp <file path> Generates a minidump file.
Example: dmp
C:\Minidumps\Minidump1.dmp.
LogBookmark lb [optional text] Writes a bookmark into the log
file
cfg Configure RoutingAdapter.
Commands for $mcal
-----------------------------------------------------------------------------
cfg Configure the gate.
help Display this help text.
To get help on a specific command, use:
help <command>
To get help for a specific gate, type
$<gate id> help
Status Information
In order to display status information, type status. The following list will be displayed:
> status
--- Logger ---
Tracemask: 0x8FFFFFF5
Collected: 0x00000003
Errors: 0
Warnings: 0
--- Core ---
Status: Started
Started at: 12/10/2019 16:58:03 (UTC: 15:58:03)
Server time: 12/10/2019 17:04:28 (UTC: 16:04:28)
File Name: RoutingAdapter.exe (default)
Version: 2.x.x (...)
Configuration: C:\ProgramData\BucherSuter\...SiebelRoutingAdapter_Siebel.ini
--- Gate:siebel ---
Status: Started
Class: SiebelRoutingGate.SiebelRoutingGate
Receive Queue: 0 items
Send Queue: 0 items
Direct Message Dispatcher contains 0 entries
SiebelRoutingGate MCO
Current State: Online
Idle Time: 382s
--- Gate:mcal ---
Status: Started
Class: MCALGate.MCALGate
Receive Queue: 0 items
Send Queue: 0 items
Direct Message Dispatcher contains 0 entries
MR_MainCO
Current State: Started
Idle Time: 384s
MCAL status: Online (net.tcp://...:8014/V5/mcal)
ARM status: Online
MRI status: Online
MRI queue: 0
MRI prio: 0
MR_RoutingControlClient
Current State: Ready
Idle Time: 384s
>remote
Chat Connector
List of Commands
Entering help shows the available commands:
> help
Available commands are:
Command Aliases Parameters Description
-----------------------------------------------------------------------------
cfg Configure the
connector's core.
help Display this help text.
httpsrv start|stop|status Control the HTTP server.
list_gates lg List gates.
quit exit Quit the program.
start Start the connector.
stop Stops the connector
status s [mask] Get status of the
connector.
telnetsrv telnet start|stop|status Control the telnet
server.
version v Display version
information.
GC.Collect() gc Calls GC.Collect().
Minidump dmp <file path> Generates a minidump
file. Example: dmp
C:\Minidumps\Minidump1
.dmp.
LogBookmark lb [optional text] Writes a bookmark into
the log file
ListAllConnectorUser lacu list all connector users
ListAllConnectorSession lacs list all chat sessions
ReloadChatUser rcu reload chat user
Commands for $mcil
-----------------------------------------------------------------------------
cfg Configure the gate.
help Display this help text.
lat List agent task.
dat Dump agent task.
vp Dump agent task VarPool.
Commands for $jabber
-----------------------------------------------------------------------------
cfg Configure the gate.
help Display this help text.
lju List jabber users.
radc Reconnect All Disabled
Clients.
To get help on a specific command, use:
help <command>
To get help for a specific gate, type
$<gate id> help
Status Information
In order to display status information, type status. The following list will be displayed:
> status
--- Logger ---
Tracemask: 0xFFFFFFFF
Collected: 0x00000004
Errors: 0
Warnings: 0
--- Core ---
Status: Started
Started at: 12/10/2019 17:27:06 (UTC: 16:27:06)
Server time: 12/10/2019 17:27:19 (UTC: 16:27:19)
--- Gate:mcil ---
Status: Started
Class: McilGate.McilGate
Receive Queue: 0 items
Send Queue: 0 items
Direct Message Dispatcher contains 0 entries
CO-00000000 MmGate.MainConnectorObject
Current State: Ready
Idle Time: 4s
MM status: Connected (MRI:Online ARM:Online)
--- Gate:jabber ---
Status: Started
Class: MatrixGate.MatrixGate
Receive Queue: 0 items
Send Queue: 0 items
Direct Message Dispatcher contains 0 entries
CO-00000001 ChatGate.MainConnectorObject
Current State: Ready
Configuration commands
Use the cfg command to access the configuration values.
[@<portid>] cfg [{<key> [<value>]|!save}]
<gateid> is the port identifier to access the configuration. If this part is omitted, the core configuration is accessed. This parameter determines which of the top-level sections should be accessed.
<key> is the key to access. If the key-value pair is not in a top-level section, the path is determined automatically. If this parameter is omitted, the remote console displays all possible keys.
<value> is the value to set for a given key. If the value contains whitespaces, it must be surrounded with quotes. If the value contains quotes or
backslashes, they must be preceded with a backslash (escape-character). If this parameter is omitted, the current value is displayed.
After modifying the settings, save the configuration by using the !save command.
Note that this must be done separately for each part – core and gates.
Example of changing a setting via the remote console
The following example sets the key MmPort in port mm to 7051 and AutoStartHttpServer to false in the core and saves the changes.
>@mm cfg MmPort
7050
>@mm cfg MmPort 7071
Value changed.
>cfg AutoStartHttpServer false
Value changes.
>@mm cfg !save
Configuration saved
>cfg !save
Configuration saved.
Complex and Multivalued Values
There is a special syntax to set the value of complex types or multivalued types, or a mixture of both. With this syntax, strings must be surrounded with quotes, even if they do not contain whitespaces. The configuration of complex and multivalued types will be padded with explicit examples.
Create a list of values by separating them with commas and surround the list with braces.
{value0,value1,value2,…}
Define a structure by setting the fields using an equal sign and putting the field name on the left-hand side and the field value on the right-hand side. Separate the field assignments with commas and surround the whole structure with parentheses.
(key1=value1, key2=value2,…)
Example of adding users via the remote console
The following example would create a list of two users: Support with password SupportPassword and Sales with password SalesPassword.
>@jabber cfg ChatUsers {(username=\"Support \",password=\"SupportPassword \"),
(username=\"Sales \",password=\"SalesPassword \")}
Notice the use of a leading backslash (escape-character) before every quote.
Web Status Page
ConnectMCAL
The web interface is the additional interface to the ConnectMCAL process. You can use the web interface to get status information directly from the ConnectMCAL process. Several monitors can run at the same time. The impact on the system’s performance is minimal.
The used TCP/IP port must be manually enabled.
RemoteWebServerPort=8031 (Default: 0)
AppIdentifier=MCAforSiebel (Siebel) SideA
URL: http://localhost:8031/MCAforSiebel/Mcal/Status/
Routing Adapter
In order to verify that the Routing Adapter service is ready and running, open a browser and point it to:
http://hostname:port
For "hostname", use the name of the server where the Routing Adapter service is running, and for "port", use the port number given during the installation procedure. This port number can be found in the HttpServerPort setting in the [core] section of the Routing Adapter initialization file, or by typing httpsrv status on the command-line interface.
HttpServerPort=9085 (Default: 9085)
Please note that this service is only available if the AutoStartHttpServer is set to active (1) in the [core] section of the configuration file or if the server has been manually started by typing "httpsrv start" on the command-line interface.
Chat Connector
In order to verify that the ChatConnector service is ready and running, open a browser and point it to:
http://hostname:port
For "hostname", use the name of the server where the ChatConnector service is running, and for "port", use the port number given during the installation procedure. This port number can be found in the HttpServerPort setting in the [core] section of the ChatConnector initialization file, or by typing "httpsrv status" on the command-line interface.
HttpServerPort=9085 (Default: 9085)
This service is only available if the AutoStartHttpServer is set to active (1) in the [core] section of the configuration file or if the server has been manually started by typing "httpsrv start" on the command-line interface.
