Cisco Cisco Computer Telephony Integration Option 8.5 Developer's Guide

The application should contain logic within the OnConnection() event handler to ensure it attempts 
to set the connection mode only during the initial connection, and not in an OnConnection() event 
due to failover.

You use Agent mode for connections when the client application must log in and control a specific agent. 
When in Agent mode, the connection also receives call events for calls on that agent’s instrument, as 
well as system events.

To select Agent mode for the connection, in the OnConnection() event:

Set properties for the agent.

The properties required for the agent depend on the type of ACD you are using. The 
following example demonstrates the required properties for Unified CC users.

Set the agent for the Session object to that Agent object.

In the Java CIL only: If the SetAgent() method is called on a session in which the current 
agent is different than the agent parameter in the SetAgent() method, the Java CIL 
automatically calls the Disconnect() method on the current session instance, generating an 
OnCloseConnection() event, then attempts to reconnect, generating an OnConnection() 
event. Then the new agent is set as the current agent.

The following example, which assumes the Session object has been created and connected to the CTI 
OS Server, demonstrates this task in 

void OnConnection(Arguments rArgs) {

   /* 1. Create and agent and set the required properties. */

   Agent agent = new Agent();

   agent.SetValue(CtiOs_IKeywordIDs.CTIOS_AGENTID, "275");

   agent.SetValue(CtiOs_IKeywordIDs.CTIOS_PERIPHERALID, "5002");

   /* 2. Set the session's agent */

   int returnValue = session.SetAgent(agent);

}

When successful, the SetAgent() method generates the following events:

OnQueryAgentStateConf()

OnSetAgentModeConf()

OnSnapshotDeviceConf(), if the agent is already logged in

OnSnapshotCallConf(), if there is a call and the agent is already logged in

OnCTIOSFailureEvent()