public interface CiscoRestrictedEv extends CiscoProvEv {
public static final int ID
com.cisco.jtapi.CiscoEventID.CiscoRestrictedEv;
/**
- The following define the cause codes for restricted events
*/
public final static int CAUSE_USER_RESTRICTED
=
1;
public final static int CAUSE_UNSUPPORTED_PROTOCOL
=
2;
}
This represents the base class for restricted events and defines the cause codes for all restricted events.
CAUSE_USER_RESTRICTED indicates the terminal or address is marked as restricted.
CAUSE_UNSUPPORTED_PROTOCOL indicates that the device in the control list is using a protocol that
Cisco Unified JTAPI does not support. Existing Cisco Unified IP 7960 and 7940 phones that are running SIP
fall in this category.
CiscoAddrRestrictedEv
Public interface CiscoAddrRestrictedEv extends CiscoRestrictedEv. Applications will recognize this event
when a line or an associated device is designated as restricted from Cisco Unified Communications Manager
Administration. For restricted lines, the address will go out of service and will not come back in service until
it is activated again. If an address is restricted, addCallObserver and addObserver will throw an exception.
For shared lines, if a few shared lines are restricted, and others are not, no exception gets thrown, but restricted
shared lines will not receive any events. If all shared lines are restricted, an exception gets thrown when
observers are added. If an address is restricted after observers are added, applications will perceive
CiscoAddrOutOfServiceEv, and when the address is activated, the address will go in service.
CiscoAddrActivatedEv
Public interface CiscoAddrActivatedEv extends CiscoProvEv. Applications will perceive this event whenever
a line or an associated device is in the control list and is removed from the restricted list in the Cisco Unified
Communications Manager Administration. If any observers exist on the address, applications will perceive
CiscoAddrInServiceEv. If no observers exist, applications can try to add observers, and the address will go
in service.
CiscoAddrRestrictedOnTerminalEv
Public interface CiscoAddrRestrictedOnTerminalEv extends CiscoRestrictedEv. If a user has a shared
address in the control list, and if one of the lines is added into the restricted list, this event will get sent.
Interface getTerminal() returns the terminal on which the address is restricted. Interface getAddress() returns
the address that is restricted.
getAddress()
javax.telephony.Address
getTerminal()
javax.telephony.Terminal
CiscoAddrActivatedOnTerminal
Public interface CiscoAddrActivatedOnTerminalEv extends CiscoProvEv. When a shared line or a device
that has a shared line is removed from the restricted list, this event will get sent. The interface getTerminal()
returns the terminal that is being added to the address. The interface getAddress() returns the address on which
the new terminal is added.
Cisco Unified JTAPI Developers Guide for Cisco Unified Communications Manager, Release 15 and SUs
23
Overview
Terminal and Address Restrictions