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):

• 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.

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

An STP identifying unauthorized SS7 messages should be able, on a per link set 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.

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 java.io.Serializable

serialVersionUID

Method Summary

int	getScreeningType() Returns the screening type option that is in use.
java.lang.Object[]	getValidList(SignallingPointMO 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(SignallingPointMO 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, getName, removePropertyChangeListener, 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 MethodNotSupportedException

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:

MethodNotSupportedException - thrown if this optional functionality is not supported by the underlying system.

getScreeningType

public int getScreeningType()
                     throws MethodNotSupportedException

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.

Throws:

MethodNotSupportedException - thrown if this optional functionality is not supported by the underlying system.

getValidList

public java.lang.Object[] getValidList(SignallingPointMO destSignallingPoint)
                                throws MethodNotSupportedException

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:

• the allowed Link Sets if the screening type is either:
  • SCR_TYPE_INCOMING_LS_TO_DPC
  • SCR_TYPE_OUTGOING_LS_TO_DPC
  or
• the allowed Originating Signalling Points if the screening type is:
  • SCR_TYPE_OPC_TO_DPC

Throws:

MethodNotSupportedException - thrown if this optional functionality is not supported by the underlying system.

setValidList

public void setValidList(SignallingPointMO destSignallingPoint,
                         java.lang.Object[] authorisedList)
                  throws MethodNotSupportedException

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.

Parameters:

uathorisedList - the authorised list for the Destination Point Code, etiher:

• any array of the allowed Link Sets if the screening type is either:
  • SCR_TYPE_INCOMING_LS_TO_DPC
  • SCR_TYPE_OUTGOING_LS_TO_DPC
  or
• an array of the allowed Originating Signalling Points if the screening type is:
  • SCR_TYPE_OPC_TO_DPC

destSignallingPoint - the destination Signalling Point for which the allowed list is to be returned.

Throws:

MethodNotSupportedException - thrown if this optional functionality is not supported by the underlying system.