Passes a filter configuration to the monitor task.
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 |
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 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. |
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).