AITIA	Welcome Message Sending System	Sga-WM

The SS7 monitor program
`("WMMonitor")`

Features
Built in limitations
User interface
Configuration
Version history

Features

The Monitor collect Location Update related SS7 messages from the monitored network
Sends UpdateLocation, InsertSubscriberData, End/Abort, CancelLocation messages to the Server
Sends the received UDTS messages as Abort (with identifiers are extracted from UDTS)
The Monitor connects automatically to the server on an adjustable port. If the server is not available, it tries to connect to it periodically every 2 seconds.
The SNTP client running on the monitor machine provides the exact timing for creating timestamps
The monitor sends statistics about SS7 links and SCCP usage on a per-link/direction basis every 15 minutes. This sending is delayed a few minutes (based on the IP-address) to avoid conflicts with other Monitors.
Every link events are sent for Server side
For the convenient maintenance the Monitor provides the log and status information as Web content (http://IP_address/ for log and http://IP_address/?status for status).

Built-in limitations

No more than 8 physical cards in a monitor unit.
No more than 8 timeslots per channel for Sga47 cards.
No more than 31 timeslots per channel for Sga47P16 cards.
No more than 256 links per monitor unit.

User interface

The main menu

Button	Meaning
	Shows the status of the cards working in the monitor
	This function is unavailable in this version
	This window provides information about the network connections
	Provides miscellanenous information about the message processing
	Summarized view about traffic handling
Record (Checkbox)	If checked the program saves SS7 messages and card events in PKT files (for debug purposes)

Configuration (`WMMonitor.ini`) file settings

Section	Entry	Example	Meaning
[General]
	RecordDir	c:\WM-Monitor\Recordings	Path for recording SS7 network data (if Record checkbox is checked)
	LogDir	c:\WM-Monitor\Logs	Path for log files
	Sga47PSysPath	c:\WM-Monitor\Sga47PDriver.sys	Name and path of the Windows driver
	StatIntervalSecs	900	Statistics sending interval in seconds
	NTPServerAddress	10.117.144.200	Server IP address providing NTP snychronization
	NTPSynchronIntervalSecs	900	Time synchronization interval in seconds
	NTPMinAdjustmentMSecs	3	If the different between the local and the NTP times is smaller then this value time adjusting will be skipped.
	NTPNotifyAdjustmentMSecs	5	When the needed adjustment is greater then this value an event will be sent to the server.
	NTPMaxAdjustmentMSecs	7200000	If the different between the local and the NTP times is greater then this value time adjusting will be skipped.
	NTPRoundtripTimeoutMSecs	10	Maximum roundtrip time for NTP answers. Answers received later then this roundtrip time will be skipped.
	PollerAddress	111.222.33.44	IP-address of the server running the Poller module.
	PollerPort	8000	Port where Poller module accepts the connection from Monitor
	KeepAlive	1	Defines that the monitor uses KeepAlive feature for network connections
	OpPrefPath	c:\WM-Monitor\OpPref.cfg	Name of the file containing the operator-prefixes.
	IMSIPrefPath	c:\WM-Monitor\IMSIPref.cfg	Name of the file containing the IMSI-prefixes.
	ProcessSCCPStats	1	Enables (1) or disables (0) creating SCCP statistics about the traffic on the SS7 link
	ProcessLUEvents	1	Enables (1) or disables (0) sending LU events to the server
	ProcessSMSEvents	0	Enables (1) or disables (0) sending SMS events to the server (It needs the proper processing modules on the server side.)
	LogCardEvents	1	Enable or disable logging events about cards and links. If it is disabled events can be followed on the Card screen.
	SortingPoolSize	20480	Size of the messages sorting buffer
	SortingPoolTimeoutMSecs	1000	The maximum time that a message can spend in the sorting pool
	LogTimeOnScreen	1	Enable or disable logging timestamp of log entries.
	EnableWatchdog	0	0: disable watchdog, other: enable, default: 0
	WatchdogIntervalSecs	5	Time period for sending reset messages to the watchdog utility
	WatchdogPort	7474	Port of WatchDog utility (default: 7474)
[Card0]			Each card in the Monitor unit has a [CardN] section containing setting for that card. (N must be replaced with the sequential number of the card, e.g. [Card0] for the 0th, [Card1] for the 1st card, etc.)
	ID	0	The ID of the 0th card. This can be adjusted with switches on the Sga47 cards. In the case of Sga47P16 cards IDs are set automatically by the host PC. All IDs must be unique within a Monitor unit.
	Type	Sga47SS7	This defines that the Sga47 card monitors SS7 links
	TMSObjectPath	Sga7N135.obj	DSP code filename (and its path if needed).
	AM186CodePath	AM186.bin	This value can be needed for card type Sga47SS7 and Sga47DSS1. This defines the path and file name of the AM186 processor code. If it is not set card does not use AM186 processor (this provides a "messages buffer" between DSP processors and host PC).
	AmplifyX	1	Sga47 cards can amplify connected PCM trunks if its voltage level is too low to work correct. (X must be 0 or 3.) If it is 1, it turns on the amplification feature for the Xth processor of Sga47SS7 cards. If it is 0, it turns the amplification off.
[Card1]
	ID	1	The ID of Card1. In the case of Sga47P16 cards IDs are set automatically by the host PC. All IDs must be unique within a Monitor unit.
	Type	Sga47P16SS7	This value defines that the given Sga47P16 card monitors SS7 links
	TMSObjectPath	SGA-S_M-09.bin	This object code is loaded onto Sga47P16 card and operates that as SS7 monitor card
	TerminationInN	300	For Sga47P16 cards the line termination can be set by the monitor software. The given value sets the termination (in Ohm) for processor N (N can be 0, 1, 2 and 3). Value can be 75 or 120 or 300. Optional parameter. The default is 300 Ohm.
	TerminatinOutN	120	The transmission termination can be set with this parameter. (On Sga47 cards this setting can be set physically by jumpers.) It sets termination of the Nth processor. The two possible values are 75 and 120 Ohm. Optional parameter. The default is 120 Ohm.
	GainN	0	Amplification for Nth processor can be adjusted by this value. Possible values are 0 and 12 and 30 dB. They are in dB. Optional parameter. Default value is 0 dB.
[Card2]
	ID	2	The ID of Card2. This can be adjusted with switches on the Sga47 cards. In the case of Sga47P16 cards IDs are set automatically by the host PC. All IDs must be unique within a Monitor unit.
	Type	Sga47P16HSL	This value defines that the given Sga47P16 card monitors HSL links
	TMSObjectPath	SGA-H_M-09.bin	This object code is loaded onto Sga47P16 card and operates that as HSL monitor card
	TerminationInN	300	For Sga47P16 cards the line termination can be set by the monitor software. (On Sga47 cards this setting can be set physically by jumpers.) The given value sets the termination (in Ohm) for processor N (N can be 0, 1, 2 and 3). Value can be 75 or 120 or 300. Optional parameter. The default is 300 Ohm.
	TerminatinOutN	120	The transmission termination can be set with this parameter. It sets termination of the Nth processor. The two possible values are 75 and 120 Ohm. Optional parameter. The default is 120 Ohm.
	GainN	0	Amplification for Nth processor can be adjusted by this value. Possible values are 0 and 12 and 30 dB. They are in dB. Optional parameter. Default value is 0 dB.
[Card3]
	ID	3	The ID of Card3.
	Type	PacketStream	This card type is for receiving messages from the PacketDistributor monitoring module.
	Port	17000	Local port where the PacketDistributor connects to.
[Card4]
	ID	4	The ID of Card4.
	Type	Tapper	Card type is for `Tapper` monitoring module.
	Port	17001	Local port where the `GyTapper` module connects to.
[Links]
	L00/0 C=0 TS=1 P=MTP2 L01/1 C=0 TS=1 P=MTP2		This format can be used for Sga47SS7 and Sga47P16SS7 card types that monitor SS7 signaling links. L00/0: The symbolic name of the link and the ID of the card to which the link belongs. The link ID has to consist of three alphanumeric characters and be unique in the whole monitoring system. C=0: Channel (interface) id of the given card where the PCM cable containing this link is connected to. TS=1: timeslot of this link P=MTP2: Defines the carried protocol of signaling link.
	H00/2 C=0 TS=1 P=MTP2H		This format can be used for Sga47P16HSL card type that monitor HSL signaling links. H00/0: The symbolic name of the link and the ID of the card to which the link belongs. The link ID has to consist of three alphanumeric characters and be unique in the whole monitoring system. C=0: Channel (interface) id of the given card where the PCM cable containing this link is connected to. TS=1/31: start timeslot and the number of joined timeslots (more groups of timeslots can be defined as an HSL signaling link: "1/15,17/15" = the signaling link contains two 15-timeslot groups from 1 to 15 and from 17 to 31.) P=MTP2H: used protocol (HSL).
	P00/3 P=ETHERNET		This format can be used for PacketStream card type. P00/0: The symbolic name of the link and the ID of the card to which the link belongs. The link ID has to consist of three alphanumeric characters and be unique in the whole monitoring system. P=ETHERNET: used protocol (Ethernet based traffic).
	T00/4 P=IP		This format can be used for Tapper card type. T00/0: The symbolic name of the link and the ID of the card to which the link belongs. The link ID has to consist of three alphanumeric characters and be unique in the whole monitoring system. P=IP: used protocol (IP based traffic).
Following sections are not used for WMMonitor v2.00 or newer.
[SS7Links]			In this section the monitored SS7 links can be defined
	Link	SS0 0/0 1	SS0: The symbolic name of the link what has to consist of three alphanumeric characters. It must be unique in the whole monitoring system 0/0: Card and Channel id where the PCM cable contains this link is connected (0th connector of the 0th card - the lower one at the card's backplane) 1: timeslot of this link
	Link	SS1 2/1 1	SS1: The symbolic name of the link what has to consist of three alphanumeric characters. It must be unique in the whole monitoring system 2/1: Card and Channel id where the PCM cable contains this link is connected (1st connector of the 2nd card - the upper one at the card's backplane 1: timeslot of this link
[HSLLinks]			In this section the monitored HSL links can be defined
	Link	HS0 1/0 1/31 Native	HS0: The symbolic name of the link what has to consist of three alphanumeric characters. It must be unique in the whole monitoring system 1/0: Card and Channel id where the PCM cable contains this link is connected (0th connector of the 1st card - the lower one at the card's backplane) 1/31: Start timeslot and the number of timeslots of this link Native: This value defines how the HSL messages are handled. Previously it had more possible values but now only the 'Native' is enabled and used.

Version history

WM-Monitor v2.22

(c) Maximum count of descriptors increased from 4096 to 16384.

WM-Monitor v2.21

(f) Non-first XUDT segments were also decoded which could cause the program to crash.
(c) Summary status window: 'Last NTP Synchron' text changed to 'Last NTP synchron (GMT)'.
(c) Message recording is not logged.

WM-Monitor v2.18

(f) Executable used SSE2 instruction set which was not available on older processors.
(f) Program crashed when an Sga47Card was configured but was not present physically.

WM-Monitor v2.16

(f) Prefix lists were not handled correctly. (Numbers ending with a non-decimal BCD digit were not translated.)

WM-Monitor v2.15

(n) New icon for the main window.
(f) Overloaded Tapper and PacketStream cards could block the watchdog packets.
(f) Tapper and PacketStream cards could lose packets at small incoming traffic rates as well.
(c) Tapper and PacketStream cards are replaced by the new TcpStream card.
(c) Poller connection: "Write buffer is full" log warning message is not displayed any more.
(c) INI/[General]/SortingPoolLengthLimit entry renamed as SortingPoolMaxSize, default value raised to 514244.
(c) Maximum data packet size is now 2008 bytes (old maximum: 4056).

WM-Monitor v2.14

(f) Prefix lists were not handled correctly.

WM-Monitor v2.13

(n) Main window position is saved to INI.
(n) Local IP address can be set for the Poller connection.
(n) PacketStream card: both the old and the new C-Board headers are accepted.

WM-Monitor v2.12

(f) Sporadic error of time bias calculation fixed.
(f) Program crashed after an SGA card error had been detected.

WM-Monitor v2.11

(c) M3UA decoder could not decode protocol data when it was not the first parameter.

WM-Monitor v2.10

(f) Fixed traffic and packet counters overflow in summary window
(f) SCTP multiple data stream handling is fixed
(n) New card types: PacketStream and Tapper cards are now supported

WM-Monitor v2.04

(c) Decoder: Irregular XUDT messages are processed as well.
(c) Decoder: Uses SgaDecoder v1.19
(c) General: Compiled with VS2010.

WM-Monitor v2.03

(n) General: Number of timestamp disorders in the message sorter are shown in the status.
(n) General: More detailed logging of socket errors during sending or receiving.
(c) General: Slight changes in socket error handling and data sending.
(c) Decoder: Uses SgaDecoder v1.08.
(f) Card: Link-count checking works properly. (Allowed max+1 links earlier.)
(n) Task1: new 5-minute counters:
- 1504: Number of IUA Messages
- 1601: Number of LAPD Messages
- 1602: Number of DSS1 Messages
(n) Task4: updateGPRSLocation messages are sent to the server.

WM-Monitor v2.02

(c) Card: Sga155eO and Sga155eM cards use e1550687.sys satellite driver and e1550687.bin FPGA code.
(f) Card: Processor statistics from Sga155eO and Sga155eM cards acquired correctly with reset option.
(f) Card: No more fake NTP alerts and notifications.
(f) General: Sockets are closed after unsuccesful connection attempts (could cause memory leaks).

WM-Monitor v2.01

(n) General: PCM-Id for STM1 links in status.
(n) General: Link counfiguration logged at startup.
(f) General: A possible failure point at program shutdown is eliminated.
(f) General: Messages with CRC errors are not processed.
(c) Card: Card traffic on summary screen is counted in B/s.
(f) Card: Traffic counting for Sga47SS7 processors and cards.
(f) NTP: .ini/[General]/NTPSynchronIntervalSecs works correcly.
(f) Card: Multi-digit [CardN] sections are parsed correctly.

WM-Monitor v2.00

(n) General: New format to store messages. (This involves massive changes to almost all part of the program.)
(n) General: Stored timestamps are now in GMT (+local time difference), and have a 100ns resolution.
(n) General: Handling and configuration of links is overhauled. (This involves massive changes in almost all parts of the program)
(c) General: INI/[SS7Links] section is obsoleted.
(n) General: INI/[Links] section for configuration of all links in format:
<link-name>[direction]/<card-id> <option0>=<value0> ... <optionN>=<valueN>
where the available options are:
- P protocol on the link (optional) (MTP2, HTP2H, LAPD, IP, AAL5)
- C card channel
- TS timeslot(s)
- PCM STM1 PCM identifer (0..62)
- VCI, VPI ATM cell identifiers
(c) General: Scheduling is moved to message handling. (thus schedule thread is eliminated)
(c) General: Overhauled network connections that speeds up sending and receiving data through the network.
(n) Decoder: Using SgaDecoder v1.04 for decoding protocols up to SCCP level.
(n) Card: Number of of allowed card is increased from 8 to 16.
(n) Card: Supporting Sga155dO, Sga155eO, Sga155eM, and Tapper cards.
(n) Card: DiskReader card converts messages to new format before submitting.
(c) Card: Uniform event handling.
(c) Card: Enhanced resolution of timestamps for Sga47 and Sga47P16 based cards (from 1ms to 125us).
(n) Card: Colorful status window.
(c) Task1, 4, 10: Code refactored to reflect changes in the internal structure.
(c) NTP: Less CPU-intensive and faster NTP query.
(c) NTP: More accurate measurement of NTP roundtrip times.
(c) HTTP: HTTP status is the exact same as the on-screen status.
(c) HTTP: Return buffer increased to 256kB from 64kB.

WM-Monitor v1.13

(n) Card: Sga46P16HSL card type.

WM-Monitor v1.12

(f) Decoder: Alphanumeric originating address fields are decoded correctly.

WM-Monitor v1.11

(n) Task10: Messages identifiable as reject but enclosed in TCAP/END are sent are sent as generic MAP/Reject.
(f) General: No more garbage sending on startup to poller. (could only happen in some rare, special cases)
(f) General: More error-proof prefix file loading.

WM-Monitor v1.10

(f) NTP: Daylight-saving period is calculated correctly when the last sunday of the month is on the 25th.

WM-Monitor v1.09

(f) Task4: More strict checking of IMSI numbers.
(f) Watchdog: Poller connection is watched by the dog.

WM-Monitor v1.08

(n) General: INI/[General]/LogTimeOnScreen. (0: don't show time, other: show time, default: 1)
(n) General: INI/[General]/SendQueueSize (default: 16MB, minimum value: 64KB)
(c) General: Message queue is replaced by Send queue.
(c) General: Mutexes are changed to critical sections.
(n) NTP: Event is sent on NTP errors. (code 19)
(n) NTP: Time settings are logged for all processors on Sga47SS7 and Sga47P16SS7 cards.
(n) NTP: Only time adjustments above threshold are applied on Sga47SS7 and Sga47P16SS7 cards.
(n) NTP: Event is sent when a processor's clock had to be adjusted on Sga47SS7, Sga47P16SS7 cards. (code 21)
(n) NTP: INI/[General]/NTPMinAdjustmentMSecs. (default: 3)
(n) NTP: INI/[General]/NTPNotifyAdjustmentMSecs. (default: 5)
(n) NTP: INI/[General]/NTPMaxAdjustmentMSecs. (default: 7200000)
(n) NTP: INI/[General]/NTPRoundtripTimeoutMSecs. (default: 10)
(c) NTP: NTP cycle delay is reduced to 5 seconds. (it was 10)
(n) Card: INI/[General]/EnableFISUs (o: disable, other: enable, default: 0)
(n) Card: INI/[General]/EnableLSSUs (o: disable, other: enable, default: 0)
(n) Card: FISU/LSSU processing can be enabled or disabled on Sga47P16SS7 cards.
(n) Card: Time settings are logged for all processors on Sga47SS7, Sga47P16SS7 cards.
(n) Card: Event is sent on lost messages for Sga47P16 cards. (code 11)
(n) Card: Event is sent on processor/card errors for Sga47P16 cards. (code 10)
(c) Card: Sga47P16 cards work with Sga47PDriver v1.03
(c) Card: Sga47P16SS7 cards work with DSP code SGA_S_M-08.
(c) Card: Message puffers on Sga47P16SS7 processors are increased to 64Kword.
(n) Card: new setting MaxPacketCount for DiskReaderCard. (default: 1000)
(n) Card: Packets are sorted by filename on DiskReaderCard.
(c) Card: DiskReaderCard starts work only after successful time synchronization.
(c) Card: Inter-packet delays of DiskReaderCard are more accurate.
(f) Card: Optional parameters of SS7 links on DiskReaderCard's are always empty.
(f) Card: HTTP status requests don't cause card errors.
(f) Card: Sga47P16SS7 card initialisation errors doesn't cause stat sending problems.
(f) Card: AM186 counters are not checked if the AM186 is not used.
(n) Decoder: BSN and FSN are decoded from MSU's.
(f) Decoder: Fixed decoding of SCCP optional parameters.
(f) Decoder: Point codes are filled with 0xffff if there is no correspondong global title.
(f) Decoder: Length of SCCP/CR/DAT parameters are decoded correctly.
(n) HTTP: Version number is displayed in header of status page.
(n) HTTP: Requests for monitor.cfg are translated to the approriate .ini.
(c) HTTP: All non-log files are treated as plain text files.
(f) Task10: sm-RP-OA/DA tags are decoded correctly
(n) Watchdog: The monitor can connect to external watchdog application. (Typically Sga-Dog.)
(n) Watchdog: INI/[General]/EnableWatchdog (0: disable, other: enable, default: 0)
(n) Watchdog: INI/[General]/WatchdogIntervalSecs (default: 5, minimum value: 1)
(n) Watchdog: INI/[General]/WatchdogPort (default: 7474)

WM-Monitor v1.07

(n) forwardSM/LMSI
(n) SM-RP-UI/Submit/[ Message reference, Destination address ]
(n) SM-RP-UI/Deliver/Originating address
(n) SM-RP-UI/StatusReport/[ Message reference, Recipient address, Status ]

WM-Monitor v1.06

(n) Messages from cards are sorted before processing.
(n) INI/[General]/SortingPoolSize (default: 10240).
(n) INI/[General]/SortingPoolTimeoutMSecs (default: 1000).
(n) MessageSortingPool status in Misc window and HTML status.
(f) Link direction signs ("<" and ">") are replaced with HTML entities in log files.
(f) Prefix names are truncated at 20 characters instead of 19.

WM-Monitor v1.05

(f) Point codes in SCCP Gt's are decoded corrrectly.
(f) Parameters of Status Report messages are filled correctly.
(f) Submit/UDH is filled correctly.

WM-Monitor v1.04

(f) SM-RP-UI message type is filled even more correctly for ForwardSM-Inv messages.
(f) DataPacketConnectSockets work like listen sockets.
(c) Total number of bytes at link information is displayed in kilobytes. (it was in bytes before)

WM-Monitor v1.03

(n) Traffic of SS7 links is displayed in Cards window and HTML status.
(n) Per-processor traffic of Sga47SS7Cards, Sga47P16SS7Cards and NISS7Cards is displayed in Cards window and HTML status.
(c) Result parameter of SMSEvents is overriden by ReturnCause for UDTS messages.
(f) MAP versions are sent correctly.
(f) Link statistics with high values are counted correctly on Sga47P16SS7 cards.
(f) networkNode-Number is filled for SRI4SM-Res messages.
(f) SM-RP-UI message type is filled correctly for ForwardSM-Inv messages.
(n) LMSI for SRI4SM-Res messages is included into SMS-events.

WM-Monitor v1.02

(n) INI/[General]/LogCardEvents (0: logging disabled, all other values: enabled, default: 0)
(n) New key DelayMSecs in ini for disk-reader cards (default: 100).
(n) New key Multiplier in ini for disk-reader cards (default: 1).
(n) SS7 links can be definied for disk-reader cards.
(f) SCCP messages with no address parameter are decoded correctly.
(c) digits of ISDN numbers are coded as 0123456789*#abcF (it was 0123456789ABCDEF)
(c) Slight code improvements in SCCP decoder.
(c) Statistic counters with zero value are not sent to server.
(n) INI/[General]/ProcessLUEvents (0: sending LU-events to the server is disabled, all other values: enabled, default: 1)
(n) INI/[General]/ProcessSMSEvents (0: sending SMS-events to the server is disabled, all other values: enabled, default: 0)
(c) INI/[General]/ProcessSCCPStats become optional and has a default value of 0. (it was mandatory)
(n) Sends SMS-related messages to server. (Task10)

WM-Monitor v1.01

(n) DiskReaderCard: CycleCount
(f) Decoder handles messages with indefinite length tags correctly
(n) Delay after unsuccessful network connection attempts. (e.g. Poller connection)
(n) Direct time synchronization via NTP.
(n) new INI/[General]/NTPServerAddress key (mandatory).
(n) new INI/[General]/Sga47PSysPath key. (default: Sga47PDriver.sys)
(n) new card types: NISS7, Sga47P16SS7.
(c) INI/[General]/TMSObjectPath is obsolete.
(n) INI/[CardN]/TMSObjectPath key. (mandatory).
(c) Unified status reporting for SS7 links.
(n) NFRA,MTP,CRC event counters for SS7 links.
(f) Fixed CRC event reporting for Sga47SS7 cards.
(n) MTP status events on Sga47SS7 cards.
(n) FISU and LSSU messages on Sga47SS7 cards.
(n) INI/[CardN]/AmplifyM for Sga47SS7 cards. (0 <= M <=3, possible values: 0, 1, default: 0)
(n) INI/[CardN]/GainM for Sga47P16SS7 cards (0 <= M <= 3, possible values: 0, 12, 30, default: 0)
(n) INI/[CardN]/TerminationInM for Sga47P16SS7 cards (0 <= M <= 3, possible values: 75, 120, 300, default: 300)
(n) INI/[CardN]/TerminationOutM for Sga47P16SS7 cards (0 <= M <= 3, possible values: 75, 120, default: 120)
(n) INI/[General]/KeepAlive (0: disable, other: enable, default: 0)
(c) INI/[SS7Linkxxx] is obsolete.
(n) INI/[SS7Links]/Link keys for SS7 link configuration. (format: Link=LinkId Card/Channel Timeslot)
(n) HTTP: Any file can be retrieved. (only current log was possible before)
(n) General: Previous/Next links at the beginning of logfiles.
(f) Card: Eliminated minor bug at card configuration.

WM-Monitor v1.00

(n) "Misc" window
(n) Sends UDTS messages as abort
(n) Sends cancelLocation messages

WM-Monitor 0.99

(n) initial release for testing

The SS7 monitor program("WMMonitor")

Table of Contents