CiscoAddress
getRestrictedAddrTerminals()
Returns an array of terminals on which this address is restricted. If none are restricted,
this method returns null.
In shared lines, a few lines on terminals may be restricted. This method returns all the
terminals on which this particular address is restricted. Applications cannot see any call
events for restricted lines. If a restricted line is involved in a call with any other control
device, an external connection gets created for the restricted line.
javax.telephony.Terminal[]
isRestricted(javax.telephony.Terminal terminal)
Returns true if any address on this terminal is restricted.
Returns false if no addresses on this terminal are restricted.
boolean
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 is 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
is not supported by Cisco Unified JTAPI. Existing Cisco Unified IP 7960 and 7940 phones that are running
SIP fall in this category.
CiscoAddrRestrictedEv
Public interface CiscoAddrRestrictedEv extends CiscoRestrictedEv. Applications will see this event when
a line or an associated device is designated as restricted from Cisco Unified Communications Manager
Administration. For restricted lines, the address goes out of service and does not come back in service until
it is activated again. If an address is restricted, addCallObserver and addObserver throws an exception. For
shared lines, if a few shared lines are restricted, and others are not, no exception is thrown, but restricted
shared lines do not receive any events. If all shared lines are restricted, an exception is thrown when adding
observers. If an address is restricted after adding observers, applications see CiscoAddrOutOfServiceEv, and
when the address is activated, the address goes in service.
CiscoAddrActivatedEv
Public interface CiscoAddrActivatedEv extends CiscoProvEv. Applications see 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 see
CiscoAddrInServiceEv. If no observers exist, applications can try to add observers, and the address goes in
service.
Cisco Unified JTAPI Developers Guide for Cisco Unified Communications Manager, Release 15 and SUs
191
Features Supported by Cisco Unified JTAPI
Terminal and Address Restrictions