TSP Lab	The IMSI-MSISDN collector	Sga-IMSISDN / Collector

The IMSI-MSISDN collector module
`("SgaIMSISDNcollector")`

Features
User interface
The bottom status-line
Logging
Configuration
Version history

Features

Periodically scans the working directory for Sga-8134.xxx files, created by the Monitor Poller
Assembles 'MAP/LocationUpdate' and 'MAP/LocationGPRSUpdate' transactions
Gets IMSI-MSISDN pairs from the assembled transactions and puts them into the IMSI-MSISDN database
Maintains the IMSI-MSISDN database (drops entries exceeding the preset lifetime)

User interface

The main menu

Menu	Menuitem	Shortcut(s)	Meaning
[Log]
	Find line containing...	(Ctrl-F)	Finds text in log window
	Find next matching line	(F3)	Finds next occurrence of text in log window
	Details		Detail level of logging (Off, Normal, Detailed, or Debug)
[Actions]
	Go on / Pause	(Ctrl-P or )	Starts or pauses the processing of the Sga-8134 files.
	Flush CDR and other counters into log		Writes the counters into the logfile.
	Flush & reset CDR and other counters		Writes the counters into the logfile and resets them.
[Options]
	Auto scroll	()	Allow automatic scrolling of the log screen
	Save settings		Save actual settings into the configuration (INI) file

The bottom status-line

Reading Sga-8134.nnn: Name of the input file currently being read
IPs: Number of received IP packets
MSUs: Number of received signalling messages

MAP / UL+ULgprs: Number of received CS + PS UpdateLocation Invoke messages
- wo/IMSI: Number of received UpdateLocation Invoke messages without IMSI
ISD: Number of InsertSubscriberData messages
- wo/MSISDN: Number of received InsertSubscriberData messages without MSISDN
CL: Number of CancelLocation messages
PMS: Number of PurgeMS messages
decodeErr: Number of undecodeable MSUs.
reTX{UxL-or-ISD}: Number of retransmitted UpdateLocation or UpdateGPRSLocation or InsertSubscriberData messages

Transactions:
- active: Active transactions count
- overflown: Number of overflown transactions (Try to increase "INI/[Advanced]/dwTransactionMaxElemCount".)
- reuse: Number of transaction using a TID already used by an active transaction
- complete: Complete transactions count
- incomplete: Incomplete transactions count
  - noUL: Number of timed out transactions without UpdateLocation message
  - noISD: Number of timed out transactions without InsertSubscriber message

Uptime: Time elapsed since module restart

IMSISDN entries in use now: Number of IMSI-MSISDN pairs in the database
- updated: Number of entries where the MSISDN for an IMSI is change to an other one
- overflown: Number of overflown entries ("SgaIMSISDNbdb.ini/[Settings]/dwEntriesMaxCount".)
- deleted: Number of entries deleted due to a CancelLocation or a PurgeMS transaction
- timed-out: Number of entries deleted due to exceeding the lifetime (SgaIMSISDNcollector.ini/[IMSISDN Memory]/dwEntryLifeSec=120)
- hit/missed: Number of successful/unsuccessfule requests for the database

Logging

The module creates daily logfiles about its operation. The name of the logfile is "modulename_YYYYMMDD.log", reflecting the day when it is created.
The module can write information into the logfile and onto the screen at various detail levels, set by the [Log]/Details menu item. The logging level can be:

Off (0) - warnings/errors are only reported (minimal logfile size and CPU usage)
Normal (1) - information about normal operation are also written into the logfile/screen
Detailed (2) - every received and sent signaling messages are logged
Debug (3) - hexadecimal information of messages is recorded (largest logfile and CPU usage)

Status line counters are logged in every fifteen minutes irrespectively of logging level actually set.

The color coding of the log lines have the following meaning:

Code Color Usage
0 Black Compact data record
1 Red Errors
2 Green Open/close output file/stream
3 Blue Open/close input file/stream
4 Yellow Warnings
5 Light Detailed data (debug info)
6 Dark Grey Detailed data (user info)
7 Purple Operator intervention;
Errors with emphasis

Code	Color	Usage
0	Black	Compact data record
1	Red	Errors
2	Green	Open/close output file/stream
3	Blue	Open/close input file/stream
4	Yellow	Warnings
5	Light	Detailed data (debug info)
6	Dark Grey	Detailed data (user info)
7	Purple	Operator intervention; Errors with emphasis

Configuration (SgaIMSISDNcollector.ini) file settings

Section	Entry	Example	Meaning
[Position]
	iLeft	140	Position of the program module on the display screen
	iTop	72	Position of the program module on the display screen
	iWidth	995	Position of the program module on the display screen
	iHeight	694	Position of the program module on the display screen
[Options]
	bAutoScroll	True	(Refer to the corresponding menu item!)
[IMSISDN Memory]
	sLocalGT	36309123456	GT of the local MSS. Used to filter out irrelevant MSUs.
	dwEntryLifeSec	120	Life time for each IMSI-MSISDN pair entry; given in seconds
	sBackupFile	c:\SgaIMSISDNbdb_BackupFile.bin	Path for the saving of the content of the database in case of module exit
	bBackupPeriodic	True	If True then the IMSI-MSISDN memory is periodically saved into the backup file
[Advanced]
	wLogDetailLevel	3	(Equals to the listed order; refer to the corresponding menu item!)
	dwMaxLinesInLogWindow	1000	Number of lines in the log window on screen
	wMaxCPUUsagePercent	90	Maximum CPU usage in percent
	dwTransactionMaxElemCount	3000	Number of maximum active transactions at the same time
	dwTransactionMaxDurationSec	15	Maximum time period for TCAP transactions in seconds. After this time the transaction will force-close with TimedOut reason.
	sLogFilesPath	d:\LogFiles	Path of the LOG files.

Version history

v0.93

(n) GT based filter to screen out irrelevant MSUs.
(n) New INI entry: [IMSISDN Memory]/sLocalGT.
(n) Handles RestoreData+ISD transactions.
(c) Transactions without a BEGIN are logged at normal level, too.

v0.92

The very first release

The IMSI-MSISDN collector module("SgaIMSISDNcollector")

Table of Contents