|
||||||||||
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 MTP Level 2 Managed Objects. It 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.mtp2.Mtp2LayerManager interface must be jain.protocol.ss7.oam.mtp2.Mtp2LayerManagerImpl.
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 Mtp2LayerManager 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.mtp2.Mtp2LayerManagerImpl
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 |
addMtp2StatisticListener(Mtp2StatisticListener listener)
Adds a Mtp2StatisticListener to the list of registered statistic listeners of the MTP2 layer. |
Mtp2SapMO |
createMtp2Sap(int portType)
Creates a new Mtp2SapMO. |
Mtp2TimerProfileMO |
createMtp2TimerProfile()
Creates a new Mtp2TimerProfileMO that will use the correct Timer values for the the protocol variant of this Mtp2LayerManager. |
void |
deleteMtp2Sap(Mtp2SapMO sap)
Deletes the specified Mtp2SapMO. |
void |
deleteMtp2TimerProfile(Mtp2TimerProfileMO timerProfile)
Deletes the specified Mtp2TimerProfileMO. |
Mtp2SapMO[] |
getActiveMtp2Sap()
Returns all of the the Mtp2 Service Access Points. |
Mtp2SapMO |
getActiveMtp2Sap(int index)
Returns one of the the Mtp2 Service Access Points. |
Mtp2SapMO[] |
getAllMtp2Saps()
Returns all of the Mtp2 SAPS created by this layer manager |
Mtp2SapMO |
getAllMtp2Saps(int index)
Returns one of the MTP2 SAPs created by this layer manager |
Mtp2TimerProfileMO[] |
getAllMtp2TimerProfiles()
Returns all of the Mtp2 Timer Profiles created by this layer manager |
Mtp2TimerProfileMO |
getAllMtp2TimerProfiles(int index)
Returns one of the MTP2 Timer Profiles created by this layer manager |
Mtp2StatisticEvent |
getStatistic(int statisticType,
Mtp2ManagedObject managedObject)
Returns a Mtp2StatisticEvent of the specified statistic type containing the value of the statistic for the specified managed object. |
void |
removeMtp2StatisticListener(Mtp2StatisticListener listener)
Removes a MTP2 Statistic Listener from the list of registered statistic listeners of this MTP2 Layer Manager. |
void |
setActiveMtp2Sap(int index,
Mtp2SapMO mtp2Sap)
Sets one of the Mtp2 Service Access Points. |
void |
setActiveMtp2Sap(Mtp2SapMO[] mtp2Saps)
Sets all of the Mtp2 Service Access Points. |
void |
startPollingStatistic(int statisticType,
Mtp2ManagedObject managedObject,
int interval)
Initiates the polling of statistic of the specified statistic type for the specified managed object. |
void |
stopPollingStatistic(int statisticType,
Mtp2ManagedObject 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 addMtp2StatisticListener(Mtp2StatisticListener listener) throws java.util.TooManyListenersException, SS7ListenerAlreadyRegisteredException
listener
- the MTP2 Statistic Listener to be added.public void removeMtp2StatisticListener(Mtp2StatisticListener listener) throws SS7ListenerNotRegisteredException
ie. Removing a MTP2 Statistic Listener application implicitly stops the polling of all of the applications statistics.
listener
- the MTP2 Statistic Listener to be removed.public Mtp2StatisticEvent getStatistic(int statisticType, Mtp2ManagedObject managedObject) throws StatisticNotSupportedException
statisticType
- the type of the statistic to be returned
[managedObject
- the Managed Object (MO) for which the statistic is to be collected.public void startPollingStatistic(int statisticType, Mtp2ManagedObject managedObject, int interval) throws StatisticNotSupportedException
statisticType
- the type of the statistic to be polled
[managedObject
- the Managed Object (MO) for which the statistic is to be collected.interval
- the polling interval in millisecondspublic void stopPollingStatistic(int statisticType, Mtp2ManagedObject 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 MTP2 Statistic Listener.
If
the specified statistic is not longer being polled by the Listener
that invoked this method
then
then invoking this operation will have
no effect.
statisticType
- the type of the statistic for which polling is to stop.managedObject
- the Managed Object (MO) for which the polling is to stoppublic Mtp2TimerProfileMO createMtp2TimerProfile() throws TooManyInstancesException
public Mtp2SapMO createMtp2Sap(int portType) throws TooManyInstancesException, java.lang.IllegalArgumentException
portType
- either: public void deleteMtp2TimerProfile(Mtp2TimerProfileMO timerProfile)
public void deleteMtp2Sap(Mtp2SapMO sap)
public Mtp2SapMO getActiveMtp2Sap(int index)
There is a subtle difference between this method and the getAllMtp2Saps() method in that this method returns one of the MTP2 SAPs that are currently in use, whereas the getAllMtp2Saps() method returns one of all the MTP2 SAPs (both those Mtp2SapMOs currently in use and the Mtp2SapMOs that have been configured are not available for use for any reason including for backup). Every Mtp2SapMOs that was created through the setActiveMtp2Sap() method shall be returned by this method.
index
- the index position of the SAPpublic void setActiveMtp2Sap(int index, Mtp2SapMO mtp2Sap) throws TooManyInstancesException
index
- the index position of the SAPmtp2Sap
- the MTP2 SAP to be set at the specified positionpublic Mtp2SapMO[] getActiveMtp2Sap()
There is a subtle difference between this method and the getAllMtp2Saps() method in that this method returns only the MTP2 SAPs that are currently in use, whereas the getAllMtp2Saps() method contains all MTP2 SAPs (both those Mtp2SapMOs currently in use and the Mtp2SapMOs that have been configured are not available for use for any reason including for backup). Every Mtp2SapMOs that was created through the setActiveMtp2Sap() method shall be returned by this method.
public void setActiveMtp2Sap(Mtp2SapMO[] mtp2Saps) throws TooManyInstancesException
mtp2Saps
- all of the the Mtp2 Service Access Points.public Mtp2SapMO[] getAllMtp2Saps()
public Mtp2SapMO getAllMtp2Saps(int index)
index
- the index of the MTP2 SAP in the listpublic Mtp2TimerProfileMO[] getAllMtp2TimerProfiles()
public Mtp2TimerProfileMO getAllMtp2TimerProfiles(int index)
index
- the index of the MTP2 Timer Profiles in the list
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |