jain.protocol.ss7.oam.mtp3
Interface LinkMO


public abstract interface LinkMO
extends Mtp3ManagedObject

This inteface defines the methods of a Link Managed Object(MO). A number of links are combined together to form a Linkset. Each link can be added to a previously defined Linkset by invoking the setSignallingLink() method of the Linkset.

The following statistics can be collected for this MO

The following Alarms can be emitted by this MO

The following Errors can be emitted by this MO


Field Summary
static int CONG_CONGESTED_LEVEL1
          A Congestion Level constant: level 1
static int CONG_CONGESTED_LEVEL2
          A Congestion Level constant: level 2
static int CONG_CONGESTED_LEVEL3
          A Congestion Level constant: level 3
static int CONG_UNCONGESTED
          A Congestion Level constant: uncongested
static int DISCARD_LEVEL_1
          A Discard Level constant: level 1
static int DISCARD_LEVEL_2
          A Discard Level constant: level 2
static int DISCARD_LEVEL_3
          A Discard Level constant: level 3
 
Fields inherited from class jain.protocol.ss7.oam.OamManagedObject
OBJECTID_CONCERNED_AREA, OBJECTID_GLOBAL_TITLE_ENTRY, OBJECTID_LINK, OBJECTID_LINKSET, OBJECTID_MTP2_SAP, OBJECTID_MTP2_TIMER_PROFILE, OBJECTID_MTP3_SAP, OBJECTID_MTP3_TIMER_PROFILE, OBJECTID_OWN_SIGNALLING_POINT, OBJECTID_ROUTE, OBJECTID_ROUTESET, OBJECTID_SCCP_ENTITY_SET, OBJECTID_SCCP_ROUTING_CONTROL, OBJECTID_SCCP_SAP, OBJECTID_SCCP_TIMER_PROFILE, OBJECTID_SCREENING_TABLE, OBJECTID_TCAP
 
Fields inherited from class java.io.Serializable
serialVersionUID
 
Method Summary
 int getCongestionAbate(int congestionLevel)
          Returns the value at which a link congestion situation ends for the specified congestion level.
 int getCongestionLevel()
          Gets the Congestion Level of this Link.
 int getCongestionOnset(int congestionLevel)
          Returns the value at which a link congestion situation starts for the specified congestion level.
 int getCurrentCapacity()
          Returns the Current Capacity of this Link.
 int getDiscardAbate(int discardLevel)
          Returns the value at which MSUs are no longer discarded for the specified discard level.
 int getDiscardOnset(int discardLevel)
          Returns the value at which MSUs are discarded for the specified discard level.
 int getMaxCapacity()
          Returns the Maximum Capacity of this Link.
 Mtp2SapMO getMtp2Sap()
          Returns the Mtp2 Service Access Point associated with this Signalling Link.
 int getSignallingLinkCode()
          Gets the Signalling Link Code (SLC) parameter of this Signalling Link.
 boolean isActive()
          Returns whether this Signalling Link is active or innactive.
 boolean isEnabled()
          Returns whether this Link is enabled or disabled (the operational state of this Link).
 boolean isRoutingAllowed()
          Returns whether it is administratively permitted to route SS7 MSUs towards the Destination Signalling Point via this Link (the Adiministrative State).
 boolean isSignallingLinkTestOn()
          Returns the Signalling Link testing.
 boolean isTestPeriodically()
          Returns whether the link is tested periodically
 void setActive(boolean active)
          Activates or deactivates this Signalling Link.
 void setCongestionAbate(int congestionLevel, int congestionAbate)
          Sets the value at which a link congestion situation ends for the specified congestion level.
 void setCongestionOnset(int congestionLevel, int congestionOnset)
          Sets the value at which a link congestion situation starts for the specified congestion level.
 void setDiscardAbate(int discardLevel, int discardAbate)
          Sets the value at which MSUs are no longer discarded for the specified discard level.
 void setDiscardOnset(int discardLevel, int discardOnset)
          Sets the value at which MSUs are discarded for the specified discard level.
 void setEnabled(boolean enabled)
          Sets the operational state of this link.
 void setMtp2Sap(Mtp2SapMO mtp2Sap)
          Sets the Mtp2 Service Access Point associated with this Signalling Link.
 void setRoutingAllowed(boolean allowed)
          Sets whether it is administratively permitted to route SS7 MSUs towards the Destination Signalling Point via this Link (the Adiministrative State).
 void setSignallingLinkCode(int signallingLinkCode)
          Sets the Signalling Link Code (SLC)of this Signalling Link.
 void setSignallingLinkTestOn(boolean signallingLinkTestOn)
          Sets the Signalling Link testing.
 void setStatus(int status)
          Returns the status of this Link (as defined in ITU Rec.
 void setTestPeriodically(boolean testPeriodically)
          Sets the periodic testing of this signalling link
 
Methods inherited from interface jain.protocol.ss7.oam.mtp3.Mtp3ManagedObject
addMtp3AlarmListener, addMtp3ErrorListener, removeMtp3AlarmListener, removeMtp3ErrorListener
 
Methods inherited from interface jain.protocol.ss7.oam.OamManagedObject
addPropertyChangeListener, addVetoableChangeListener, getName, getObjectId, getProprietaryInformation, removePropertyChangeListener, removeVetoableChangeListener, setName
 

Field Detail

DISCARD_LEVEL_1

public static final int DISCARD_LEVEL_1
A Discard Level constant: level 1

DISCARD_LEVEL_2

public static final int DISCARD_LEVEL_2
A Discard Level constant: level 2

DISCARD_LEVEL_3

public static final int DISCARD_LEVEL_3
A Discard Level constant: level 3

CONG_UNCONGESTED

public static final int CONG_UNCONGESTED
A Congestion Level constant: uncongested

CONG_CONGESTED_LEVEL1

public static final int CONG_CONGESTED_LEVEL1
A Congestion Level constant: level 1

CONG_CONGESTED_LEVEL2

public static final int CONG_CONGESTED_LEVEL2
A Congestion Level constant: level 2

CONG_CONGESTED_LEVEL3

public static final int CONG_CONGESTED_LEVEL3
A Congestion Level constant: level 3
Method Detail

setSignallingLinkCode

public void setSignallingLinkCode(int signallingLinkCode)
                           throws java.lang.IllegalArgumentException
Sets the Signalling Link Code (SLC)of this Signalling Link. The SLC is the same value (between 0 and 15) at each end of the link, and is different from that of any other link between the same two adjacent signalling points.
Throws:
java.lang.IllegalArgumentException - - if the supplied signalling link code is not an acceptable value

getSignallingLinkCode

public int getSignallingLinkCode()
Gets the Signalling Link Code (SLC) parameter of this Signalling Link. The SLC is the same value (between 0 and 15) at each end of the link, and is different from that of any other link between the same two adjacent signalling points.

getMaxCapacity

public int getMaxCapacity()
Returns the Maximum Capacity of this Link. The maximum capacity of a signalling link is the maximum load that should be placed on the signalling link. This is a display only attribute.
Returns:
the maximum capacity of this Link

getCurrentCapacity

public int getCurrentCapacity()
Returns the Current Capacity of this Link. The current capacity of a Link (implementation dependent, consequently an optional attribute) is the maximum load that should be placed on the Link given the present configuration of Signalling Data Links (SDLs) to signalling terminals.
Could be used where Signalling Terminal (ST) capacities might be different in an implementation and automatic allocation of SDL to ST can be done, and/or where a signalling terminal could control several Links. This is a display only attribute.
Returns:
the Current Capacity of this Link.

setStatus

public void setStatus(int status)
               throws java.lang.IllegalArgumentException
Returns the status of this Link (as defined in ITU Rec. Q.704).
Returns:
one of the following :
  • STATUS_LOCALLY_BLOCKED
  • STATUS_REMOTELY_BLOCKED
  • STATUS_LOCALLY_INHIBITED
  • STATUS_REMOTELY_INHBITED
  • STATUS_FAILED
  • STATUS_DEACTIVATED
Throws:
java.lang.IllegalArgumentException - - if the supplied status is not an acceptable value

isEnabled

public boolean isEnabled()
Returns whether this Link is enabled or disabled (the operational state of this Link).
Returns:
either:
  • true if this Link is enabled.
  • false if this Link is disabled.

setEnabled

public void setEnabled(boolean enabled)
Sets the operational state of this link.
Parameters:
enabled - the opertaional state (enabled or disabled) either:
  • true enables this Link.
  • false disables this Link.

setRoutingAllowed

public void setRoutingAllowed(boolean allowed)
Sets whether it is administratively permitted to route SS7 MSUs towards the Destination Signalling Point via this Link (the Adiministrative State).
Parameters:
allowed - either:
  • true if routing is permitted (unlocked).
  • false otherwise (locked).

isRoutingAllowed

public boolean isRoutingAllowed()
Returns whether it is administratively permitted to route SS7 MSUs towards the Destination Signalling Point via this Link (the Adiministrative State).
Returns:
either:
  • true if routing is permitted (unlocked).
  • false otherwise (locked).

getCongestionLevel

public int getCongestionLevel()
Gets the Congestion Level of this Link. This reflects Link congestion. Different vaules are valid depending on the protocol variant supported.
Returns:
either :
  • CONG_UNCONGESTED
  • CONG_CONGESTED_LEVEL1
  • CONG_CONGESTED_LEVEL2
  • CONG_CONGESTED_LEVEL3

setActive

public void setActive(boolean active)
Activates or deactivates this Signalling Link. When the link is originally created it will be deactivated by default.
Parameters:
active - either:
  • true This activates the link (puts the link into operation)and allows alignment of the link to take place.
  • false This deactivates the link (causing it to go out of alignment and to stop carrying traffic).

isActive

public boolean isActive()
Returns whether this Signalling Link is active or innactive.
Returns:
either:
  • true The link is active. (the Signalling Link may have been activated for carrying traffic by operator command
  • false The link is inactive (the Link may have been prevented from aligning or carrying traffic autonomously or may have been deactivated by operator command.

setSignallingLinkTestOn

public void setSignallingLinkTestOn(boolean signallingLinkTestOn)
Sets the Signalling Link testing.
Parameters:
signallingLinkTestOn - TRUE if link testing is on, FALSE otherwise.

isSignallingLinkTestOn

public boolean isSignallingLinkTestOn()
Returns the Signalling Link testing. return signallingLinkTestOn TRUE if link testing is on, FALSE otherwise.

setTestPeriodically

public void setTestPeriodically(boolean testPeriodically)
Sets the periodic testing of this signalling link
Parameters:
testPeriodically - TRUE if periodic link testing is enabled.

isTestPeriodically

public boolean isTestPeriodically()
Returns whether the link is tested periodically
Returns:
TRUE if the link is tested periodically.

setCongestionOnset

public void setCongestionOnset(int congestionLevel,
                               int congestionOnset)
                        throws java.lang.IllegalArgumentException
Sets the value at which a link congestion situation starts for the specified congestion level.
Parameters:
congestionLevel - one of the congestion level constants.
congestionOnset - the value at which a link congestion situation starts for the specified congestion level.
Throws:
java.lang.IllegalArgumentException - - if the congestion level is not one of those defined

getCongestionOnset

public int getCongestionOnset(int congestionLevel)
                       throws java.lang.IllegalArgumentException
Returns the value at which a link congestion situation starts for the specified congestion level.
Parameters:
congestionLevel - one of the congestion level constants.
Returns:
the value at which a link congestion situation starts for the specified congestion level.
Throws:
java.lang.IllegalArgumentException - - if the congestion level is not one of those defined

setCongestionAbate

public void setCongestionAbate(int congestionLevel,
                               int congestionAbate)
                        throws java.lang.IllegalArgumentException
Sets the value at which a link congestion situation ends for the specified congestion level.
Parameters:
congestionLevelone - of the congestion level constants.
congestionAbate - the value at which a link congestion situation ends for the specified congestion level.
Throws:
java.lang.IllegalArgumentException - - if the congestion level is not one of those defined

getCongestionAbate

public int getCongestionAbate(int congestionLevel)
                       throws java.lang.IllegalArgumentException
Returns the value at which a link congestion situation ends for the specified congestion level.
Parameters:
congestionLevel - one of the congestion level constants.
Returns:
the value at which a link congestion situation ends for the specified congestion level.
Throws:
java.lang.IllegalArgumentException - - if the congestion level is not one of those defined

setDiscardOnset

public void setDiscardOnset(int discardLevel,
                            int discardOnset)
                     throws java.lang.IllegalArgumentException
Sets the value at which MSUs are discarded for the specified discard level.
Parameters:
discardLevel - one of the discard level constants.
discardOnset - the value MSUs are discarded for the specified discard level.
Throws:
java.lang.IllegalArgumentException - - if the discard level is not one of those defined

getDiscardOnset

public int getDiscardOnset(int discardLevel)
                    throws java.lang.IllegalArgumentException
Returns the value at which MSUs are discarded for the specified discard level.
Parameters:
discardLevel - one of the discard level constants.
Returns:
the value at which MSUs are discarded for the specified discard level.
Throws:
java.lang.IllegalArgumentException - - if the discard level is not one of those defined

setDiscardAbate

public void setDiscardAbate(int discardLevel,
                            int discardAbate)
                     throws java.lang.IllegalArgumentException
Sets the value at which MSUs are no longer discarded for the specified discard level.
Parameters:
discardLevel - one of the discard level constants.
discardAbate - the value MSUs are no longer discarded for the specified discard level.
Throws:
java.lang.IllegalArgumentException - - if the discard level is not one of those defined

getDiscardAbate

public int getDiscardAbate(int discardLevel)
                    throws java.lang.IllegalArgumentException
Returns the value at which MSUs are no longer discarded for the specified discard level.
Parameters:
discardLevel - one of the discard level constants.
Returns:
the value at which MSUs are no longer discarded for the specified discard level.
Throws:
java.lang.IllegalArgumentException - - if the discard level is not one of those defined

getMtp2Sap

public Mtp2SapMO getMtp2Sap()
Returns the Mtp2 Service Access Point associated with this Signalling Link.

setMtp2Sap

public void setMtp2Sap(Mtp2SapMO mtp2Sap)
Sets the Mtp2 Service Access Point associated with this Signalling Link.


06 January 2000
If you have any comments or queries, please mail them to Colm Hayden [JAIN SS7 OAM Edit Lead]

Copyright - 2000 Sun Microsystems