When attempting to login an agent with invalid agentid or password, a custom CTIOS Application may see either:

1. eCTIOSFailureEvent event and eButtonEnablementMaskChange events are fired when eControlFailureConf received by the CIL.

or

2. Only eControlFailureConf event is fired when eControlFailureConf is received by the CIL.



We found that the behavior is controlled by the registry entry ¿AuthenticationEnabled¿ which is present at the following location.

HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Systems, Inc.\Ctios\<Instance Name>\CTIOS1\Server\Security.



When AuthenticationEnabled is set to ¿1¿, we saw that eCTIOSFailureEvent event and eButtonEnablementMaskChange events are fired by the CIL

on recieving eControlFailureConf.

When AuthenticationEnabled is set to ¿0¿ we see that only eControlFailureConf is being fired by the CIL.



When AuthenticationEnabled is set to ¿1¿ and if there is a login failure, BlockAllEvents is set to true so that CIL starts blocking all events coming from the server.

This results in eCTIOSFailureEvent event and eButtonEnablementMaskChange events being fired when eControlFailureConf received by the CIL.



In the case where AuthenticationEnabled is set to ¿0¿, BlockAllEvents is set to false and this results in eControlFailureConf being fired by the CIL..



Please refer to the log snippets for both the cases given below.



AuthenticationEnabled : 1

HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Systems, Inc.\Ctios\CTIOS_sree\CTIOS1\Server\Security



12/04/09 12:46:40.227 3276 CTIOSSoftphone Thd(4388) Event Arguments: (PeripheralID:5000 FailureCode:256

PeripheralErrorCode:0 AgentID:456 UniqueObjectID:agent.5000.456 MessageID:eControlFailureConf

MessageType:eSetAgentStateRequest ErrorMessage:The request specified an invalid AgentID. FilterTarget:agent.5000.456

TargetCILClientID:skottada-wxp-3276-4388)

12/04/09 12:46:40.227 3276 CTIOSSoftphone Thd(4388) CCtiOsSession:nEvent( eControlFailureConf ), EnablementMask = ffffffff



12/04/09 12:46:40.237 3276 CTIOSSoftphone Thd(4388) CCtiOsSession:nEvent, (PeripheralID:5000 FailureCode:256

PeripheralErrorCode:0 AgentID:456 UniqueObjectID:agent.5000.456 MessageID:eControlFailureConf MessageType:eSetAgentStateRequest

ErrorMessage:The request specified an invalid AgentID. FilterTarget:agent.5000.456 TargetCILClientID:skottada-wxp-3276-4388)

12/04/09 12:46:40.237 3276 CTIOSSoftphone Thd(4388) CObjectManager::GetTarget( eControlFailureConf )



12/04/09 12:46:40.247 3276 CTIOSSoftphone Thd(4388) [agent.5000.456] eSetAgentStateRequest : (PeripheralID:5000 FailureCode:256

PeripheralErrorCode:0 AgentID:456 UniqueObjectID:agent.5000.456 MessageID:eControlFailureConf MessageType:eSetAgentStateRequest

ErrorMessage:The request specified an invalid AgentID. FilterTarget:agent.5000.456 TargetCILClientID:skottada-wxp-3276-4388)



12/04/09 12:46:40.247 3276 CTIOSSoftphone Thd(4388) [agent.5000.456]::SetAgentProperties: (PeripheralID:5000 FailureCode:256

PeripheralErrorCode:0 AgentID:456 UniqueObjectID:agent.5000.456 MessageID:eControlFailureConf MessageType:eSetAgentStateRequest

ErrorMessage:The request specified an invalid AgentID. FilterTarget:agent.5000.456 TargetCILClientID:skottada-wxp-3276-4388)



12/04/09 12:46:40.307 3276 CTIOSSoftphone Thd(4388) [agent.5000.456] eControlFailureConf : (PeripheralID:5000 FailureCode:256

PeripheralErrorCode:0 AgentID:456 UniqueObjectID:agent.5000.456 MessageID:eControlFailureConf MessageType:eSetAgentStateRequest

ErrorMessage:The request specified an invalid AgentID. FilterTarget:agent.5000.456 TargetCILClientID:skottada-wxp-3276-4388)



12/04/09 12:46:40.307 3276 CTIOSSoftphone Thd(4388) [agent.5000.456] FireEvent( eButtonEnablementMaskChange) :

(PeripheralID:5000 FailureCode:256 PeripheralErrorCode:0 AgentID:456 EnablementMask:0x1400000

UniqueObjectID:agent.5000.456 MessageID:eControlFailureConf MessageType:eSetAgentStateRequest ErrorMessage:The request specified an

invalid AgentID. EventType:2 FilterTarget:agent.5000.456 TargetCILClientID:skottada-wxp-3276-4388)



12/04/09 12:46:40.307 3276 CTIOSSoftphone Thd(4388) CCtiOsSession::FireEvent( Type(4), Evt(eButtonEnablementMaskChange),EnablementMask = 20971520



12/04/09 12:46:40.317 3276 CTIOSSoftphone Thd(4388) CCtiOsSession::FireEvent, (PeripheralID:5000 FailureCode:256

PeripheralErrorCode:0 AgentID:456 EnablementMask:0x1400000 UniqueObjectID:agent.5000.456 MessageID:eControlFailureConf

MessageType:eSetAgentStateRequest ErrorMessage:The request specified an invalid AgentID. EventType:2 FilterTarget:agent.5000.456

TargetCILClientID:skottada-wxp-3276-4388)



12/04/09 12:46:40.317 3276 CTIOSSoftphone Thd(1788) CComSession::FireEvent, (PeripheralID:5000 FailureCode:256

PeripheralErrorCode:0 AgentID:456 EnablementMask:0x1400000 UniqueObjectID:agent.5000.456 MessageID:eControlFailureConf

MessageType:eSetAgentStateRequest ErrorMessage:The request specified an invalid AgentID. EventType:2 FilterTarget:agent.5000.456

TargetCILClientID:skottada-wxp-3276-4388)



12/04/09 12:46:40.377 3276 CTIOSSoftphone Thd(4388) [agent.5000.456] FireEvent( eCTIOSFailureEvent) :

(PeripheralID:5000 FailureCode:11 PeripheralErrorCode:0 AgentID:456 EnablementMask:0x1400000 UniqueObjectID:agent.5000.456 MessageID:eControlFailureConf MessageType:eSetAgentStateRequest ErrorMessage:The request specified an invalid AgentID. EventType:2 FilterTarget:agent.5000.456 TargetCILClientID:skottada-wxp-3276-4388 BlockAllEvents:1)



********************************************************************



AuthenticationEnabled : 0

HKEY_LOCAL_MACHINE\SOFTWARE\Cisco Systems, Inc.\Ctios\CTIOS_sree\CTIOS1\Server\Security



12/04/09 13:44:16.917 5132 CTIOSSoftphone Thd(2100) Event Arguments: (PeripheralID:5000 FailureCode:256 PeripheralErrorCode:0 AgentID:456 UniqueObjectID:agent.5000.456 MessageID:eControlFailureConf MessageType:eSetAgentStateRequest ErrorMessage:The request specified an

invalid AgentID. FilterTarget:agent.5000.456 TargetCILClientID:skottada-wxp-5132-2100)



12/04/09 13:44:16.917 5132 CTIOSSoftphone Thd(2100) CCtiOsSession:nEvent, (PeripheralID:5000 FailureCode:256

PeripheralErrorCode:0 AgentID:456 UniqueObjectID:agent.5000.456 MessageID:eControlFailureConf MessageType:eSetAgentStateRequest

ErrorMessage:The request specified an invalid AgentID. FilterTarget:agent.5000.456 TargetCILClientID:skottada-wxp-5132-2100)



12/04/09 13:44:16.917 5132 CTIOSSoftphone Thd(2100) [agent.5000.456] eSetAgentStateRequest : (PeripheralID:5000 FailureCode:256

PeripheralErrorCode:0 AgentID:456 UniqueObjectID:agent.5000.456 MessageID:eControlFailureConf MessageType:eSetAgentStateRequest

ErrorMessage:The request specified an invalid AgentID. FilterTarget:agent.5000.456 TargetCILClientID:skottada-wxp-5132-2100)



12/04/09 13:44:16.927 5132 CTIOSSoftphone Thd(2100) [agent.5000.456]::SetAgentProperties: (PeripheralID:5000 FailureCode:256

PeripheralErrorCode:0 AgentID:456 UniqueObjectID:agent.5000.456 MessageID:eControlFailureConf MessageType:eSetAgentStateRequest

ErrorMessage:The request specified an invalid AgentID. FilterTarget:agent.5000.456 TargetCILClientID:skottada-wxp-5132-2100)



12/04/09 13:44:16.957 5132 CTIOSSoftphone Thd(2100) [agent.5000.456] eControlFailureConf : (PeripheralID:5000 FailureCode:256

PeripheralErrorCode:0 AgentID:456 UniqueObjectID:agent.5000.456 MessageID:eControlFailureConf MessageType:eSetAgentStateRequest

ErrorMessage:The request specified an invalid AgentID. FilterTarget:agent.5000.456 TargetCILClientID:skottada-wxp-5132-2100)



12/04/09 13:44:16.957 5132 CTIOSSoftphone Thd(2100) [agent.5000.456]::SetAgentProperties( (PeripheralID:5000 PeripheralType:17

AgentState:eUnknown FailureCode:256 NumSkillGroups:0 PeripheralErrorCode:0

AgentWorkMode:0 AvailTimeToday:0 LoggedOnTimeToday:0 NotReadyTimeToday:0

.

.

TargetCILClientID:skottada-wxp-5132-2100 LoginNamenull) BlockAllEvents:0

SilentMonitorTargetAgentUIDnull) SilentMonitorCallUIDnull)) )



12/04/09 13:44:16.957 5132 CTIOSSoftphone Thd(2100) [agent.5000.456] FireEvent( eControlFailureConf) : (PeripheralID:5000

FailureCode:256 PeripheralErrorCode:0 AgentID:456 UniqueObjectID:agent.5000.456 MessageID:eControlFailureConf

MessageType:eSetAgentStateRequest ErrorMessage:The request specified an invalid AgentID. EventType:2 FilterTarget:agent.5000.456

TargetCILClientID:skottada-wxp-5132-2100)



12/04/09 13:44:16.967 5132 CTIOSSoftphone Thd(2100) CCtiOsSession::FireEvent, (PeripheralID:5000 FailureCode:256

PeripheralErrorCode:0 AgentID:456 UniqueObjectID:agent.5000.456 MessageID:eControlFailureConf MessageType:eSetAgentStateRequest

ErrorMessage:The request specified an invalid AgentID. EventType:2 FilterTarget:agent.5000.456 TargetCILClientID:skottada-wxp-5132-2100)



12/04/09 13:44:16.967 5132 CTIOSSoftphone Thd(5868) CComSession::FireEvent, (PeripheralID:5000 FailureCode:256

PeripheralErrorCode:0 AgentID:456 UniqueObjectID:agent.5000.456 MessageID:eControlFailureConf MessageType:eSetAgentStateRequest

ErrorMessage:The request specified an invalid AgentID. EventType:2 FilterTarget:agent.5000.456 TargetCILClientID:skottada-wxp-5132-2100)