Cisco Cisco Computer Telephony Integration Option 9.0 Developer's Guide

To deal with failover in Monitor Mode:

When the application detects a failover, for example, in a CTIOSFailure() event indicating a connection 
failure or an offline component, wait until the CIL has failed over and everything is back online and the 
CIL is connected to CTI OS.

The Monitor Mode application determines when all required servers are online. You can do this by 
monitoring OnCtiosFailure() events and keeping track of system status changes as they occur.

Use the Disconnect() method to disconnect the session from CTI OS.

Follow the steps starting at the beginning of the section 

to: 

Create a session instance.

Set the event listener.

Set connection parameters.

Call the Connect() method.

Set the connection mode in the OnConnection() event handler.

One of the many useful features of CTI OS is the ability to configure Agent Desktop settings once on 
the server and have them available to all agent desktops via the RequestDesktopSettings() 
method. You can make any changes once on the server instead of changing each and every desktop. 
Settings download are considered as part of the process of setting up a connection that the client 
application uses. 

Desktop settings are stored in the registries on the machines running CTI OS Server. Centralizing the 
desktop settings on the server streamlines the process of changing or updating the agent desktop. A 
settings download occurs every time a client application connects and ensures that all the desktops are 
based on the same settings.

You can downloading settings from CTI OS Server after connecting and setting the mode via the 
RequestDesktopSettings()

 method on the Session object. The 

OnGlobalSettingsDownloadConf

 event indicates success and also returns the settings which are 

now available to the client application in the form of properties on the Session object. You can access 
these properties via the GetValue() methods. Refer to Chapter 9 for a list of all the properties of the 
Session object. 

You can make the request for desktop settings either in the OnConnection event or in the 
OnSetAgentModeEvent

 event (if Agent mode has been specified). Sample code:

Private Sub m_Session_OnConnection(ByVal pDispParam As Object)

'Issue a request to the server to send us all the Desktop 'Settings

m_Session.RequestDesktopSettings eAgentDesktop

 

End Sub 

The OnGlobalSettingsDownloadConf event passes back the settings and you can access them 
via the Session object. For example, the following snippet checks for Sound Preferences and specifically 
to see if the Dial Tone is Mute or not:

Private Sub m_session_OnGlobalSettingsDownloadConf(ByVal pDispParam As Object)

Dim SoundArgs As CTIOSARGUMENTSLib.Arguments

' check if "SoundPreferences is a valid property