jain.protocol.ss7.oam.mtp3
Interface ScreeningTableMO


public abstract interface ScreeningTableMO
extends Mtp3ManagedObject

This inteface defines the methods of an STP Screening Table Managed Object(MO). This MO allows the optional SS7 functionality for an STP to identify and to handle unauthorized SS7 messages. Since the prevention of unauthorized use of an STP is an optional function this MO may be optionally implemented also.

It is possible to inhibit/allow messages destined for another signalling point (SP) based on any one or combination of the following options (ITU Q.705, Section 8.2):

The option to be used is configurable using the setScreeningType() method.

An STP identifying unauthorized SS7 messages should be able, on a per linkset or per signalling point code basis, to

  1. provide all unauthorized SS7 messages with the same handling as authorized traffic; or
  2. discard all unauthorized SS7 messages.

There are no statistics that can be collected for this MO

The following Alarms can be emitted by this MO

The following Errors can be emitted by this MO

The following Errors can be emitted by this MO


Field Summary
static int SCR_TYPE_INCOMING_LS_TO_DPC
          To inhibit/allow STP access by a combination of designated incoming link sets to designated DPCs.
static int SCR_TYPE_OPC_TO_DPC
          To inhibit/allow STP access by examination of OPC and DPC combination in the incoming STP message.
static int SCR_TYPE_OUTGOING_LS_TO_DPC
          To inhibit/allow STP access by a combination of designated outgoing link sets to designated DPCs.
 
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 getScreeningType()
          Returns the screening type option that is in use.
 java.lang.Object[] getValidList(Mtp3SapMO destSignallingPoint)
          Returns an array of Objects representing either all of the allowed Linksets or all of the allowed Originating Point Codes for the specified destination point code.
The type of Objects that is returned in the array is dependent on the screening type option.
 void setScreeningType(int screeningType)
          Sets the screening Type option to be used.
 void setValidList(Mtp3SapMO destSignallingPoint, java.lang.Object[] authorisedList)
          Sets an array of Objects representing either: all of the allowed Linksets, or all of the allowed Originating Point Codes for the specified destination point code.
The type of Object that is supplied in the Object array is dependent on the screening type option.
 
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

SCR_TYPE_INCOMING_LS_TO_DPC

public static final int SCR_TYPE_INCOMING_LS_TO_DPC
To inhibit/allow STP access by a combination of designated incoming link sets to designated DPCs.

SCR_TYPE_OUTGOING_LS_TO_DPC

public static final int SCR_TYPE_OUTGOING_LS_TO_DPC
To inhibit/allow STP access by a combination of designated outgoing link sets to designated DPCs.

SCR_TYPE_OPC_TO_DPC

public static final int SCR_TYPE_OPC_TO_DPC
To inhibit/allow STP access by examination of OPC and DPC combination in the incoming STP message.
Method Detail

setScreeningType

public void setScreeningType(int screeningType)
                      throws java.lang.IllegalArgumentException
Sets the screening Type option to be used.
Parameters:
screeningType - either:
  • SCR_TYPE_INCOMING_LS_TO_DPC
    To inhibit/allow STP access by a combination of designated incoming link sets to designated DPCs.
  • SCR_TYPE_OUTGOING_LS_TO_DPC
    To inhibit/allow STP access by a combination of designated outgoing link sets to designated DPCs.
  • SCR_TYPE_OPC_TO_DPC
    To inhibit/allow STP access by examination of OPC and DPC combination in the incoming STP message.
Throws:
java.lang.IllegalArgumentException - - if the supplied screening type is not one of the defined screening types

getScreeningType

public int getScreeningType()
Returns the screening type option that is in use.
Returns:
either:
  • SCR_TYPE_INCOMING_LS_TO_DPC
    To inhibit/allow STP access by a combination of designated incoming link sets to designated DPCs.
  • SCR_TYPE_OUTGOING_LS_TO_DPC
    To inhibit/allow STP access by a combination of designated outgoing link sets to designated DPCs.
  • SCR_TYPE_OPC_TO_DPC
    To inhibit/allow STP access by examination of OPC and DPC combination in the incoming STP message.

getValidList

public java.lang.Object[] getValidList(Mtp3SapMO destSignallingPoint)
Returns an array of Objects representing either all of the allowed Linksets or all of the allowed Originating Point Codes for the specified destination point code.
The type of Objects that is returned in the array is dependent on the screening type option.
Parameters:
destSignallingPoint - the destination Signalling Point for which the allowed list is to be returned.
Returns:
either:

setValidList

public void setValidList(Mtp3SapMO destSignallingPoint,
                         java.lang.Object[] authorisedList)
                  throws TooManyInstancesException
Sets an array of Objects representing either: for the specified destination point code.
The type of Object that is supplied in the Object array is dependent on the screening type option.
Parameters:
authorisedList - the authorised list for the Destination Point Code, either:
destSignallingPoint - the destination Signalling Point for which the allowed list is to be returned.
Throws:
TooManyInstancesException - - if the authorised list is too large for this implementation


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