|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
This interface defines the methods required for the creation and management of all SCCP Managed Objects. Logically, more than one Signalling Point may exist on the same system. The SCCP routing information for each logical signalling point is contained in the SCCP Routing Control MO, with each SCCP Routing Control MO having only one Own Signalling Point MO associated with it. It follows that there will be one SCCP Routing Control MO instance for each local Signalling Point.
This interface defines the methods to:
It must be noted that under the JAIN Naming Convention the lower-level package structure and classname of a proprietary implementation of the jain.protocol.ss7.oam.sccp.SccpLayerManager interface must be jain.protocol.ss7.oam.sccp.SccpLayerManagerImpl.
Under the JAIN naming convention, the upper-level package structure (pathname) can be used to differentiate between proprietary implementations from different SS7 Vendors. The pathname used by each SS7 Vendor must be the domain name assigned to the Vendor in reverse order, e.g. Sun Microsystem's would be 'com.sun'
It follows that a proprietary implementation of a SccpLayerManager will be located
at:
Where:
pathname = reverse domain name, e.g. com.sun'
The resulting Peer JAIN SS7 Object would be located at: com.sun.jain.protocol.ss7.oam.sccp.SccpLayerManagerImpl
An application may create a JainTcapStackImpl by invoking the JainSs7Factory.createJainSS7Object() method. The PathName of the vendor specific implementation of which you want to instantiate can be set before calling this method or the default or current pathname may be used
Fields inherited from class jain.protocol.ss7.oam.OamLayerManager |
PROTOCOL_VARIANT_ANSI,
PROTOCOL_VARIANT_ITU,
PROTOCOL_VARIANT_OTHER |
Method Summary | |
void |
addSccpStatisticListener(SccpStatisticListener listener)
Adds a SccpStatisticListener to the list of registered statistic listeners of the SCCP layer. |
ConcernedAreaMO |
createConcernedArea(SccpSapMO[] remoteSubsystems)
Creates a new Concerned Area Managed Object containing the specified remote Subsystems (SccpSaps). |
GlobalTitleEntryMO |
createGlobalTitleEntry(SccpEntitySetMO entitySet,
int globalTitleIndicator,
byte[] addressInformation)
Creates a new Global Title Entry Managed Object. |
SccpEntitySetMO |
createSccpEntitySet(SccpSapMO[] destinationSubsystems,
int sharingMode)
Creates a new SCCP Entity Set Managed Object |
SccpRoutingControlMO |
createSccpRoutingControl(OwnSignallingPointMO sp,
SccpSapMO[] subsystems)
Creates a new Routing Control Managed Object for the specified Own Signalling Point and (local) Subsystems |
SccpSapMO |
createSccpSap(int ssn,
Mtp3SapMO signallingPoint)
Creates a new SCCP Sevice Access Point (SAP) Managed Object (a local or remote Subsystem) |
SccpTimerProfileMO |
createSccpTimerProfile()
Creates a new SccpTimerProfileMO that will use the correct Timer values for the the protocol variant of this SccpLayerManager. |
void |
deleteConcernedArea(ConcernedAreaMO concernedArea)
Deletes the specified Concerned Area Managed Object. |
void |
deleteGlobalTitleEntry(GlobalTitleEntryMO globalTitleEntry)
Deletes the specified Global Title Entry Managed Object. |
void |
deleteSccpEntitySet(SccpEntitySetMO entitySet)
Deletes the specified SCCP Entity Set Managed Object. |
void |
deleteSccpRoutingControl(SccpRoutingControlMO routingControl)
Deletes the specified Routing Control Managed Object. |
void |
deleteSccpSap(SccpSapMO subSystem)
Deletes the specified SCCP Sevice Access Point (SAP) Managed Object (a local or remote Subsystem). |
void |
deleteSccpTimerProfile(SccpTimerProfileMO timerProfile)
Deletes the specified SccpTimerProfileMO. |
SccpRoutingControlMO[] |
getActiveSccpRoutingControl()
Returns the Active SCCP Routing controls of this SCCP Layer Manager. |
SccpRoutingControlMO |
getActiveSccpRoutingControl(int index)
Returns the Active SCCP Routing controls of this SCCP Layer Manager. |
ConcernedAreaMO[] |
getAllConcernedAreas()
Returns all of the Concerned Areas created by this layer manager |
ConcernedAreaMO |
getAllConcernedAreas(int index)
Returns one of the Concerned Areas created by this layer manager |
GlobalTitleEntryMO[] |
getAllGlobalTitleEntries()
Returns all of the Global Tiltle Entries created by this layer manager |
GlobalTitleEntryMO |
getAllGlobalTitleEntries(int index)
Returns one of the Global Tiltle Entries created by this layer manager |
SccpEntitySetMO[] |
getAllSccpEntitySets()
Returns all of the SCCP Entity Sets created by this layer manager |
SccpEntitySetMO |
getAllSccpEntitySets(int index)
Returns one of the SCCP Entity Sets created by this layer manager |
SccpRoutingControlMO[] |
getAllSccpRoutingControls()
Returns all of the SCCP Routing Controls created by this layer manager |
SccpRoutingControlMO |
getAllSccpRoutingControls(int index)
Returns one of the SCCP Routing Controls created by this layer manager |
SccpSapMO[] |
getAllSccpSaps()
Returns all of the SCCP SAPs (Local or Remote Subsystems) created by this layer manager |
SccpSapMO |
getAllSccpSaps(int index)
Returns one of the SCCP SAPs (Local or Remote Subsystems) created by this layer manager |
SccpTimerProfileMO[] |
getAllSccpTimerProfiles()
Returns all of the SCCP Timer Profiles created by this layer manager |
SccpTimerProfileMO |
getAllSccpTimerProfiles(int index)
Returns one of the SCCP Timer Profiles) created by this layer manager |
SccpStatisticEvent |
getStatistic(int statisticType,
SccpManagedObject managedObject)
Returns a SccpStatisticEvent of the specified statistic type containing the value of the statistic for the specified managed object. |
void |
removeSccpStatisticListener(SccpStatisticListener listener)
Removes a SCCP Statistic Listener from the list of registered statistic listeners of this SCCP Layer Manager. |
void |
setActiveSccpRoutingControl(int index,
SccpRoutingControlMO routingControl)
Sets one of the Active SCCP Routing controls of this SCCP Layer Manager. |
void |
setActiveSccpRoutingControl(SccpRoutingControlMO[] routingControls)
Sets the Active SCCP Routing controls of this SCCP Layer Manager. |
void |
startPollingStatistic(int statisticType,
SccpManagedObject managedObject,
int interval)
Initiates the polling of statistic of the specified statistic type for the specified managed object. |
void |
stopPollingStatistic(int statisticType,
SccpManagedObject managedObject)
Stops the polling of statistic of the specified statistic type for the specified managed object. |
Methods inherited from interface jain.protocol.ss7.oam.OamLayerManager |
commit,
getProtocolVariant,
getProtocolYear,
getVendorDetails,
readCurrentConfiguration,
setProtocolVariant,
setProtocolYear |
Method Detail |
public void addSccpStatisticListener(SccpStatisticListener listener) throws java.util.TooManyListenersException, SS7ListenerAlreadyRegisteredException
listener
- the SCCP Statistic Listener to be added.public void removeSccpStatisticListener(SccpStatisticListener listener) throws SS7ListenerNotRegisteredException
ie. Removing a SCCP Statistic Listener application implicitly stops the polling of all of the applications statistics.
listener
- the SCCP Statistic Listener to be removed.public SccpStatisticEvent getStatistic(int statisticType, SccpManagedObject managedObject) throws StatisticNotSupportedException
statisticType
- the type of the statistic to be returned
[managedObject
- the SCCP Managed Object (MO) for which the statistic is to be collectedpublic void startPollingStatistic(int statisticType, SccpManagedObject managedObject, int interval) throws StatisticNotSupportedException
statisticType
- the type of the statistic to be polled
[managedObject
- the SCCP Managed Object (MO) for which the statistic is to be polledinterval
- the polling interval in millisecondspublic void stopPollingStatistic(int statisticType, SccpManagedObject managedObject) throws IllegalOperationException
If
the specified statistic is currently being polled by the Listener
that invoked this method
then
this polling will stop and the specified
statistic shall no longer be sent to the registered SCCP Statistic Listener.
If
the specified statistic is not longer being polled by the Listener
that invoked this method
then
invoking this operation will have
no effect.
statisticType
- the type of the statistic for which polling is to stop.managedObject
- the SCCP Managed Object (MO) for which the polling is to stoppublic void setActiveSccpRoutingControl(int index, SccpRoutingControlMO routingControl) throws TooManyInstancesException
index
- the index of the SCCP Routing Control to be set.routingControl
- the routing controlpublic SccpRoutingControlMO getActiveSccpRoutingControl(int index)
There is a subtle difference between this method and the getAllSccpRoutingControls() method in that this method returns one the SCCP Routing Controls that are currently in use, whereas the getAllSccpRoutingControls() method contains all SCCP Routing Controls (both those Routing Controls currently in use and the Routing Controls that have been configured, but not activated for any reason including for backup). Every SCCP Routing Control that was created through the setActiveRoutingControl() method shall be returned by this method.
index
- the index of the SCCP Routing Control to be returned.public void setActiveSccpRoutingControl(SccpRoutingControlMO[] routingControls) throws TooManyInstancesException
routingControls
- all of the routing controlspublic SccpRoutingControlMO[] getActiveSccpRoutingControl()
There is a subtle difference between this method and the getAllSccpRoutingControls() method in that this method returns only the SCCP Routing Controls that are currently in use, whereas the getAllSccpRoutingControls() method contains all SCCP Routing Controls (both those Routing Controls currently in use and the Routing Controls that have been configured, but not activated for any reason including for backup). Every SCCP Routing Control that was created through the setActiveRoutingControl() method shall be returned by this method.
public SccpTimerProfileMO createSccpTimerProfile() throws TooManyInstancesException
public GlobalTitleEntryMO createGlobalTitleEntry(SccpEntitySetMO entitySet, int globalTitleIndicator, byte[] addressInformation) throws java.lang.IllegalArgumentException, TooManyInstancesException
entitySet
- the entity set to which this entry translates toglobalTitleIndicator
- one of the Global Title Indicator constants:
addressInformation
- the address information
composed of digits in the form of Binary Coded Decimal(BCD).public ConcernedAreaMO createConcernedArea(SccpSapMO[] remoteSubsystems) throws TooManyInstancesException
remoteSubsystems
- the remote subsystems to be informed of local
(primary broadcast) or remote (secondary broadcast)
SCCP Subsystem status changes, or to be informed of the SCCP status after
completion of SCCP Restart.public SccpSapMO createSccpSap(int ssn, Mtp3SapMO signallingPoint) throws java.lang.IllegalArgumentException, TooManyInstancesException
ssn
- the subsystem numbersignallingPoint
- the signalling point of this subsystempublic SccpEntitySetMO createSccpEntitySet(SccpSapMO[] destinationSubsystems, int sharingMode) throws TooManyInstancesException
destinationSubsystems
- the destination Subsystems (SCCP SAPs) of the Entity Set.sharingMode
- the sharing mode determining the distribution of SCCP traffic
over the entities in this set. This may be one of:
public SccpRoutingControlMO createSccpRoutingControl(OwnSignallingPointMO sp, SccpSapMO[] subsystems) throws TooManyInstancesException
sp
- the Own signalling point whose routing is to be controlled by
this Routing Control function.subsystems
- the local subsystems controlled by this Routing Control.public void deleteSccpTimerProfile(SccpTimerProfileMO timerProfile)
public void deleteGlobalTitleEntry(GlobalTitleEntryMO globalTitleEntry)
public void deleteConcernedArea(ConcernedAreaMO concernedArea)
public void deleteSccpSap(SccpSapMO subSystem)
public void deleteSccpEntitySet(SccpEntitySetMO entitySet)
public void deleteSccpRoutingControl(SccpRoutingControlMO routingControl)
public SccpSapMO[] getAllSccpSaps()
public SccpSapMO getAllSccpSaps(int index)
index
- the index of the Subsystem in the listpublic SccpTimerProfileMO[] getAllSccpTimerProfiles()
public SccpTimerProfileMO getAllSccpTimerProfiles(int index)
index
- the index of the SCCP Timer Profile in the listpublic SccpRoutingControlMO[] getAllSccpRoutingControls()
public SccpRoutingControlMO getAllSccpRoutingControls(int index)
index
- the index of the SCCP Routing Control in the listpublic GlobalTitleEntryMO[] getAllGlobalTitleEntries()
public GlobalTitleEntryMO getAllGlobalTitleEntries(int index)
index
- the index of the Global Tiltle Entry in the listpublic SccpEntitySetMO[] getAllSccpEntitySets()
public SccpEntitySetMO getAllSccpEntitySets(int index)
index
- the index of the SCCP Entity Set in the listpublic ConcernedAreaMO[] getAllConcernedAreas()
public ConcernedAreaMO getAllConcernedAreas(int index)
index
- the index of the Concerned Area in the list
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |