|
||||||||||
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 3 Managed MBeans.
The Mtp3LayerManagerMBean acts as a factory for the creation of Mtp3ManagedObjectMBeans and allows a NotificationListener to register as a listener of all Mtp3ManagedObjectMBeans.
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 Mtp3LayerManagerMBean 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 Mtp3LayerManager.
It follows that a proprietary implementation of a Mtp3LayerManagerMBean will be located at:
Where:
pathname = reverse domain name, e.g. 'com.aepona'
The resulting Mtp3LayerManager from AePONA would be located at:
com.aepona.jain.protocol.ss7.oam.mtp3.Mtp3LayerManager
Consequently, an application may create a Mtp3LayerManagerMBean by invoking: JainSS7Factory.createSS7Object(jain.protocol.ss7.oam.mtp3.Mtp3LayerManager). 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.
Illustrates how JAIN OAM MBeans are instantiated
Relationship between the MTP3 JAIN OAM MBeans
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 |
createLink(ObjectName mtp2Sap)
Creates a new Link Managed Bean (LinkMBean). |
ObjectName |
createLinkSet(ObjectName adjacentSignallingPoint,
ObjectName[] links)
Creates a new Linkset Managed Bean (LinkSetMBean). |
ObjectName |
createMtp3Sap(ObjectName signallingPoint,
java.lang.Integer serviceIndicator)
Creates a new Mtp3 Service Access Point MBean (representing a Remote Signalling Point) |
ObjectName |
createMtp3TimerProfile()
Creates a new Mtp3TimerProfileMBean that will use the correct Timer values for the the protocol variant of this Mtp3LayerManager. |
ObjectName |
createOwnSignallingPoint(java.lang.Long pointCode,
java.lang.Integer type,
java.lang.Integer networkInd)
Creates a new Own Signalling Point Managed Bean (OwnSignallingPointMBean). |
ObjectName |
createRoute(ObjectName destinationSignallingPoint,
ObjectName[] linkSets)
Creates a new Route Managed Bean (RouteMBean). |
ObjectName |
createRouteSet(ObjectName[] routes)
Creates a new Routeset Managed Bean (RouteSetMBean). |
ObjectName |
createScreeningTable()
Creates a new Screening Table Managed Bean (ScreeningTableMBean). |
ObjectName |
createSignallingPoint(java.lang.Long pointCode,
java.lang.Integer type,
java.lang.Integer networkInd)
Creates a new Own Signalling Point Managed Bean (OwnSignallingPointMBean). |
void |
deleteLink(ObjectName link)
Deletes the LinkMBean identified by the specified ObjectName. |
void |
deleteLinkSet(ObjectName linkSet)
Deletes the LinkSetMBean identified by the specified ObjectName. |
void |
deleteMtp3Sap(ObjectName sap)
Deletes the Mtp3SapMBean identified by the specified ObjectName. |
void |
deleteMtp3TimerProfile(ObjectName mtp3TimerProfile)
Deletes the Mtp3TimerProfileMBean identified by the specified ObjectName. |
void |
deleteOwnSignallingPoint(ObjectName ownSignallingPoint)
Deletes the OwnSignallingPointMBean identified by the specified ObjectName. |
void |
deleteRoute(ObjectName route)
Deletes the RouteMBean identified by the specified ObjectName. |
void |
deleteRouteSet(ObjectName routeSet)
Deletes the RouteSetMBean identified by the specified ObjectName. |
void |
deleteScreeningTable(ObjectName screeningTable)
Deletes the ScreeningTableMBean identified by the specified ObjectName. |
void |
deleteSignallingPoint(ObjectName signallingPoint)
Deletes the SignallingPointMBean identified by the specified ObjectName. |
ObjectName |
getActiveOwnSignallingPoint(java.lang.Integer index)
Returns the ObjectName of one of the active (local) OwnSignallingPointMBeans of this stack. The underlying stack management system may support multiple signalling points on the the same system. |
ObjectName[] |
getActiveOwnSignallingPoints()
Returns the ObjectNames of all of the active (local) OwnSignallingPointMBeans of this stack. The underlying stack management system may support multiple signalling points on the the same system. |
ObjectName |
getLink(java.lang.Integer index)
Returns the ObjectName of one of the LinkMBeans created by this layer manager |
ObjectName[] |
getLinks()
Returns the ObjectNames of all the LinkMBeans created by this layer manager |
ObjectName |
getLinkSet(java.lang.Integer index)
Returns the ObjectName of one of the LinkSetMBeans created by this layer manager |
ObjectName[] |
getLinkSets()
Returns the ObjectNames of all the LinkSetMBeans created by this layer manager |
ObjectName |
getMtp3Sap(java.lang.Integer index)
Returns the ObjectName of one of the Mtp3SapMBeans (Remote Signalling Points) created by this layer manager |
ObjectName[] |
getMtp3Saps()
Returns the ObjectNames of all the Mtp3SapMBeans (Remote Signalling Points) created by this layer manager |
ObjectName |
getMtp3TimerProfile(java.lang.Integer index)
Returns the ObjectName of one of the Mtp3TimerProfileMBeans created by this layer manager |
ObjectName[] |
getMtp3TimerProfiles()
Returns the ObjectNames of all the Mtp3TimerProfilesMBeans created by this layer manager |
ObjectName |
getOwnSignallingPoint(java.lang.Integer index)
Returns the ObjectNames of one of the OwnSignallingPointMBeans created by this layer manager |
ObjectName[] |
getOwnSignallingPoints()
Returns the ObjectNames of all the OwnSignallingPointMBeans created by this layer manager |
ObjectName |
getRoute(java.lang.Integer index)
Returns the ObjectName of one of the RouteMBeans created by this layer manager |
ObjectName[] |
getRoutes()
Returns the ObjectNames of all of the RouteMBeans created by this layer manager |
ObjectName |
getRouteSet(java.lang.Integer index)
Returns the ObjectName of one of the RouteSetMBeans created by this layer manager |
ObjectName[] |
getRouteSets()
Returns the ObjectNames of all the RouteSetMBeans created by this layer manager |
ObjectName |
getScreeningTable(java.lang.Integer index)
Returns the ObjectName of one of the ScreeningTableMBeans created by this layer manager |
ObjectName[] |
getScreeningTables()
Returns the ObjectNames of all of the ScreeningTableMBeans created by this layer manager. |
ObjectName |
getSignallingPoint(java.lang.Integer index)
Returns the ObjectNames of one of the SignallingPointMBeans created by this layer manager |
ObjectName[] |
getSignallingPoints()
Returns the ObjectNames of all the SignallingPointMBeans created by this layer manager |
void |
setActiveOwnSignallingPoint(java.lang.Integer index,
ObjectName OwnSignallingPoint)
Sets one of the active (local) OwnSignallingPointMBeans of this stack. The underlying stack management system may support multiple signalling points on the the same system. |
void |
setActiveOwnSignallingPoints(ObjectName[] OwnSignallingPoints)
Sets all of the active (local) OwnSignallingPointMBeans of this stack. The underlying stack management system may support multiple Signalling points on the the same system. |
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 createMtp3TimerProfile() throws TooManyInstancesException
public ObjectName createLink(ObjectName mtp2Sap) throws TooManyInstancesException
mtp2Sap
- the ObjectName of the Mtp2SapMBean defining the
hardware characteristics of this LinkMBean.public ObjectName createLinkSet(ObjectName adjacentSignallingPoint, ObjectName[] links) throws TooManyInstancesException
adjacentSignallingPoint
- the ObjectName of the Adjacent
SignallingPointMBean of this LinkSetMBeanlinks
- an array of ObjectNames of the LinkMBeans of this LinkSetMBean.public ObjectName createRoute(ObjectName destinationSignallingPoint, ObjectName[] linkSets) throws TooManyInstancesException
destinationSignallingPoint
- the destination OwnSignallingPointMBean
of this RouteMBeanlinksetsan
- array of ObjectNames of the LinksetMBeans that
make up this RouteMBeanpublic ObjectName createRouteSet(ObjectName[] routes) throws TooManyInstancesException
routes
- The array of ObjectNames of the RouteMBeans that
make up this RouteSetMBeanpublic ObjectName createOwnSignallingPoint(java.lang.Long pointCode, java.lang.Integer type, java.lang.Integer networkInd) throws TooManyInstancesException, java.lang.IllegalArgumentException
pointCode
- the signalling point codetype
- one of the following:
networkInd
- one of the following Network Indicator constants:
public ObjectName createSignallingPoint(java.lang.Long pointCode, java.lang.Integer type, java.lang.Integer networkInd) throws TooManyInstancesException, java.lang.IllegalArgumentException
pointCode
- the signalling point codetype
- one of the following:
networkInd
- one of the following Network Indicator constants:
public ObjectName createMtp3Sap(ObjectName signallingPoint, java.lang.Integer serviceIndicator) throws TooManyInstancesException, java.lang.IllegalArgumentException
pointCode
- the signalling point codetype
- one of the following:
networkInd
- one of the following Network Indicator constants:
serviceIndicator
- one of the following Service Indicator constants:
public ObjectName createScreeningTable() throws java.lang.UnsupportedOperationException, TooManyInstancesException
screeningType
- either:
public void deleteMtp3TimerProfile(ObjectName mtp3TimerProfile)
public void deleteLink(ObjectName link)
public void deleteLinkSet(ObjectName linkSet)
public void deleteRoute(ObjectName route)
public void deleteRouteSet(ObjectName routeSet)
public void deleteOwnSignallingPoint(ObjectName ownSignallingPoint)
public void deleteSignallingPoint(ObjectName signallingPoint)
public void deleteMtp3Sap(ObjectName sap)
public void deleteScreeningTable(ObjectName screeningTable) throws java.lang.UnsupportedOperationException
public void setActiveOwnSignallingPoint(java.lang.Integer index, ObjectName OwnSignallingPoint) throws TooManyInstancesException
index
- the index position of the element in the array.OwnSignallingPoint
- the ObjectName of the local OwnSignallingPointMBeanpublic ObjectName getActiveOwnSignallingPoint(java.lang.Integer index)
There is a subtle difference between this method and the getOwnSignallingPoints() method in that this method returns the ObjectName of one of the OwnSignallingPointMBeans that are currently in use, whereas the getOwnSignallingPoints() method returns the ObjectName of one of the OwnSignallingPointMBeans (both those OwnSignallingPointMBeans currently in use and the OwnSignallingPointMBeans that have been configured are not available for use for any reason including for backup). The ObjectName of every OwnSignallingPointMBean that was created through the createOwnSignallingPoint() method shall be returned by the getOwnSignallingPoints() method, but only the ObjectName of those OwnSignallingPointMBeans that have been activated using the setActiveOwnSignallingPoint() method shall be returned by this method.
index
- the index position of the element in the array.public void setActiveOwnSignallingPoints(ObjectName[] OwnSignallingPoints) throws TooManyInstancesException
OwnSignallingPoints
- all of the (local) Signalling Points of this stack.public ObjectName[] getActiveOwnSignallingPoints()
There is a subtle difference between this method and the getOwnSignallingPoints() method in that this method returns the ObjectNames of only the OwnSignallingPointMBeans that are currently in use, whereas the getOwnSignallingPoints() method returns the ObjectNames of all OwnSignallingPointMBeans (both those OwnSignallingPointMBeans currently in use and the OwnSignallingPointMBeans that have been configured are not available for use for any reason including for backup). The ObjectNames of every OwnSignallingPointMBean that was created through the createOwnSignallingPoint() method shall be returned by the getOwnSignallingPoints() method, but only the ObjectNames of those OwnSignallingPointMBeans that have been activated using the setActiveOwnSignallingPoint() method shall be returned by this method.
public ObjectName[] getMtp3Saps()
public ObjectName getMtp3Sap(java.lang.Integer index)
index
- the index of the Remote OwnSignallingPointMBean in the listpublic ObjectName[] getMtp3TimerProfiles()
public ObjectName getMtp3TimerProfile(java.lang.Integer index)
index
- the index of the Mtp3TimerProfileMBean in the listpublic ObjectName[] getLinks()
public ObjectName getLink(java.lang.Integer index)
index
- the index of the LinkMBean in the listpublic ObjectName[] getLinkSets()
public ObjectName getLinkSet(java.lang.Integer index)
index
- the index of the LinkSetMBean in the listpublic ObjectName[] getRoutes()
public ObjectName getRoute(java.lang.Integer index)
index
- the index of the RouteMBean in the listpublic ObjectName[] getRouteSets()
public ObjectName getRouteSet(java.lang.Integer index)
index
- the index of the RouteSetMBean in the listpublic ObjectName[] getScreeningTables() throws java.lang.UnsupportedOperationException
public ObjectName getScreeningTable(java.lang.Integer index) throws java.lang.UnsupportedOperationException
index
- the index of the ScreeningTableMBean in the listpublic ObjectName[] getOwnSignallingPoints()
public ObjectName getOwnSignallingPoint(java.lang.Integer index)
index
- the index of the OwnSignallingPointMBean in the listpublic ObjectName[] getSignallingPoints()
public ObjectName getSignallingPoint(java.lang.Integer index)
index
- the index of the SignallingPointMBean in the list
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |