MonSetFilter

Passes a filter configuration to the monitor task.

Prototype

MON_STATUS MonSetFilter ( U8 board, MonFilterDef *pfilter, S16 linkNo )

Argument

Description

board

TX board number on which the desired monitor task resides.

pfilter

Pointer to a new filter definition:

typedef struct _MonFilterDef
{
    U8 type;
#define MON_FILTER_SIO 1            /* Filter types */
#define MON_FILTER_DPC 2
#define MON_FILTER_OPC 3
    U8 spare;
    U16 spare2;
    U32 value;
} MonFilterDef;

linkNo

Link number from the configuration file. If this parameter is set to MON_ALL_LINKS, all filters are set for all links, not for just one specific link.


Return values

Return value

Description

MON_BOARD

Board number out of range.

MON_DRIVER

CPI driver returned an error.

MON_HANDLE

Board not previously initialized.

MON_LINKTYPE

Invalid link or switch type.

MON_PARAM

Invalid parameter.

MON_RESPONSE

Wrong response from board.

MON_SUCCESS

 

MON_TIMEOUT

No response from board.


Details

This function sets destination point code (DPC), originating point code (OPC), or service information octet (SIO) filters on one or all links.

A filter definition is defined by two values: the type and the value. The type is set to either MON_FILTER_SIO, MON_FILTER_DPC, or MON_FILTER_OPC. When a message comes in, it is compared to the defined filters on the link it came in on. If the message does not match any of the filters, it is dropped. There is a maximum of three filter definitions per link. You cannot have more than one filter of any type active at a time. For example, you cannot have two SIO filters active at a time.

For OPC and DPC filters, the value field is compared to the DPC or OPC in the MTP3 routing label. For the SIO filter, the service indicator octet is retrieved from the received message and compared to the filter value. The service indicator determines for which SS7 upper layer the message is destined (for example, ISUP, SCCP, or TUP).