|
||||||||||
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 MBeans.
The Mtp2LayerManagerMBean acts as a factory for the creation of Mtp2ManagedObjectMBeans and allows a NotificationListener to register as a listener of all Mtp2ManagedObjectMBeans.
When creating a MBean an entry must be added to the LookupTable of that MBean's ObjectName and reference, and when a MBean is being deleted the corresponding entry in the LookupTable must be removed. This is to enable the application to operate successfully without a JMX agent.
An instance of this Mtp2LayerManagerMBean should be created through the JainSS7Factory. The JainSS7Factory defines a naming convention to locate a proprietary implementation of this interface.
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'
In order to be recognised as a JMX MBean a class implementing this interface must be called Mtp2LayerManager.
It follows that a proprietary implementation of a Mtp2LayerManagerMBean will be located at:
Where:
pathname = reverse domain name, e.g. 'com.aepona'
The resulting Mtp2LayerManager from AePONA would be located at:
com.aepona.jain.protocol.ss7.oam.mtp2.Mtp2LayerManager
Consequently, an application may create a Mtp2LayerManagerMBean by invoking: JainSS7Factory.createSS7Object(jain.protocol.ss7.oam.mtp2.Mtp2LayerManager). The PathName of the vendor specific implementation of which you want to instantiate can be set before calling JainSS7Factory.setPathName("vendorPathname"); or the default or current pathname may be used.
This illustrates how JAIN OAM MBeans are instantiated
Relationship between the MTP2 JAIN OAM MBean
Fields inherited from class jain.protocol.ss7.oam.OamLayerManagerMBean |
PROTOCOL_VARIANT_ANSI_1992,
PROTOCOL_VARIANT_ANSI_1996,
PROTOCOL_VARIANT_ITU_1993,
PROTOCOL_VARIANT_ITU_1996,
PROTOCOL_VARIANT_ITU_1997,
PROTOCOL_VARIANT_OTHER |
Fields inherited from class java.io.Serializable |
serialVersionUID |
Method Summary | |
ObjectName |
createMtp2Sap(java.lang.Integer portType)
Creates a new Mtp2SapMBean. |
ObjectName |
createMtp2TimerProfile()
Creates a new Mtp2 Timer Profile MBean that will use the correct Timer values for the the protocol variant of this Mtp2LayerManager. |
void |
deleteMtp2Sap(ObjectName sap)
Deletes the Mtp2SapMBean identified by the specified ObjectName. |
void |
deleteMtp2TimerProfile(ObjectName timerProfile)
Deletes the Mtp2TimerProfileMBean identified by the specified ObjectName. |
ObjectName |
getActiveMtp2Sap(java.lang.Integer index)
Returns the ObjectName of one of the the Mtp2 Service Access Points (Mtp2SapMBeans) There is a subtle difference between this method and the getMtp2Saps() method in that this method returns the ObjectName of one of the Mtp2SapMBeans that are currently in use, whereas the getMtp2Saps() method returns the ObjectName of one of all the Mtp2SapMBeans (both those Mtp2SapMBeans currently in use and the Mtp2SapMBeans that have been configured are not available for use for any reason including for backup). |
ObjectName[] |
getActiveMtp2Saps()
Returns the ObjectNames of all of the the Mtp2 Service Access Point MBeans (Mtp2SapMBeans). |
ObjectName |
getMtp2Sap(java.lang.Integer index)
Returns the ObjectName of one of the Mtp2SapMBeans created by this layer manager |
ObjectName[] |
getMtp2Saps()
Returns the ObjectNames of all of the Mtp2SapMBeans created by this layer manager |
ObjectName |
getMtp2TimerProfile(java.lang.Integer index)
Returns the ObjectName of one of the Mtp2TimerProfileMBeans created by this layer manager |
ObjectName[] |
getMtp2TimerProfiles()
Returns the ObjectNames of all of the Mtp2TimerProfileMBeans created by this layer manager |
void |
setActiveMtp2Sap(java.lang.Integer index,
ObjectName mtp2Sap)
Sets one of the Mtp2 Service Access Points (Mtp2SapMBeans) identified by the specified ObjectName |
void |
setActiveMtp2Saps(ObjectName[] mtp2Saps)
Sets all of the Mtp2 Service Access Points (Mtp2SapMBeans) identified by the specified array of ObjectNames |
Methods inherited from interface jain.protocol.ss7.oam.OamLayerManagerMBean |
addNotificationListenerToAllMBeans,
commit,
getAllOamManagedObjects,
getLookupTable,
getProtocolVariantAndYear,
getStackName,
getVendorDetails,
readCurrentConfiguration,
removeNotificationListenerFromAllMBeans,
rollBack,
setProtocolVariantAndYear,
setStackName |
Methods inherited from interface jain.protocol.ss7.oam.OamManagedObjectMBean |
getName,
getObjectId,
getObjectName,
getObjectType,
getProprietaryInformation,
getStatistic,
setName,
startPollingStatistic,
stopPollingStatistic |
Methods inherited from interface javax.management.NotificationBroadcaster |
addNotificationListener,
getNotificationInfo,
removeNotificationListener |
Methods inherited from interface javax.management.MBeanRegistration |
postDeregister,
postRegister,
preDeregister,
preRegister |
Method Detail |
public ObjectName createMtp2TimerProfile() throws TooManyInstancesException
public ObjectName createMtp2Sap(java.lang.Integer portType) throws TooManyInstancesException, java.lang.IllegalArgumentException
portType
- either: public void deleteMtp2TimerProfile(ObjectName timerProfile)
public void deleteMtp2Sap(ObjectName sap)
public ObjectName getActiveMtp2Sap(java.lang.Integer index)
There is a subtle difference between this method and the getMtp2Saps() method in that this method returns the ObjectName of one of the Mtp2SapMBeans that are currently in use, whereas the getMtp2Saps() method returns the ObjectName of one of all the Mtp2SapMBeans (both those Mtp2SapMBeans currently in use and the Mtp2SapMBeans that have been configured are not available for use for any reason including for backup). Every Mtp2SapMBeans that was created through the createMtp2Sap() method shall be returned by the getMtp2Saps() method, but only those MTP2 SAPs that have been activated using the setActiveMtp2Sap() method shall be returned by this method.
index
- the index position of the SAPpublic void setActiveMtp2Sap(java.lang.Integer index, ObjectName mtp2Sap) throws TooManyInstancesException
index
- the index position of the SAPmtp2Sap
- the Mtp2SapMBean to be set at the specified positionpublic ObjectName[] getActiveMtp2Saps()
There is a subtle difference between this method and the getMtp2Saps() method in that this method returns only the ObjectNames of the Mtp2SapMBeans that are currently in use, whereas the getMtp2Saps() method returns the ObjectNames of all Mtp2SapMBeans (both those Mtp2SapMBeans currently in use and the Mtp2SapMBeans that have been configured are not available for use for any reason including for backup). The ObjectNames of every Mtp2SapMBeans that was created through the createMtp2Sap() method shall be returned by the getMtp2Saps() method, but only those Mtp2SapMBeans that have been activated using the setActiveMtp2Sap() method shall be returned by this method.
public void setActiveMtp2Saps(ObjectName[] mtp2Saps) throws TooManyInstancesException
mtp2Saps
- all of the the Mtp2 Service Access Point MBeans.public ObjectName[] getMtp2Saps()
public ObjectName getMtp2Sap(java.lang.Integer index)
index
- the index of the MTP2 SAP in the listpublic ObjectName[] getMtp2TimerProfiles()
public ObjectName getMtp2TimerProfile(java.lang.Integer 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 |