Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide

The Client Interface Library’s Session object is used to establish a connection to 
an active CTI OS server. The main functions of the Session object are:

Managing the connection to the CTI OS Server

Distributing events to the appropriate objects and event subscribers

Creating and managing the collections of Agent, Call, and SkillGroup objects 

Automatically recovering from failures 

Typically, an application will have a single instance of the Session object, which 
is used by all other CIL objects to send and receive events. However, there are no 
restrictions on the number or types of Session objects one application can employ. 
It is possible, and sometimes desirable, to establish and manage multiple 
independent Sessions, for example to use multiple current event streams. If there 
is more than one Session object monitoring the same Agent or Call, each Session 
object will receive its own events. The order in which events are received is not 
guaranteed when there are multiple Session objects.

For a step-by-step explanation of using the Session object to connect with CTI OS 
Server, see the section “Disconnecting from CTI OS Server” in 

The Session object creates new Call, Agent, and SkillGroup objects upon receipt 
of an event for that object if the targeted object does not already exist. The Session 
object maintains collections of all Agents, Calls, SkillGroups, and WaitObjects. 
Object lifetime is managed by the Session object, and thus it is important that the 
client application not delete the objects, which would render the object reference