TSP Lab	Sga-MAP_CDR-Assembler - The MAP CDR Assembler	Sga-MAP / CDR Assembler

The MAP CDR Assembler module
`("Sga-MAP_CDR-Assembler")`

Features
User interface
The bottom status-line
Configuration
Version history

Features

Periodically scan its working directory for Sga-8135.xxx files created by the Message Sorter module
Processe MAP signaling traffic carried by SCTP on interface D (MSC ↔ HLR) and Gr (SGSN ↔ HLR)
Handle fragmented SCTP/DATA chunks
Assemble MAP dialogs based on SCCP CadPA/CagPA and TCAP OTID/DTID parametres
Assign a Global Title to records based on the Point Code when the Global Title is not given in the messages
Use SCTP Ports to differentiate SCTP associations
Handle SCTP retransmission
Store transactions in binary CDRs with essential parameters
Create IMSI and MSISDN index files for fast CDR search
Keep {IMSI→MSISDN} pairs in memory and derive an IMSI or an MSISDN if not explicitly present in a transaction (uses SgaIMSISDNbdb.dll for this purpose)
Provide IMSI-MSISDN assignments for the Sga-IC service

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 )	Enables input data processing
	Reload IMSI prefix names		Reload IMSI prefix - IMSI name assignment list for roaming statistics feature
	Backup "(IMSI→MSISDN) Memory" entries		Entries of "(IMSI→MSISDN) Memory" are written into the corresponding binary backup files
	Flush CDR and other counters into log		Writes status counters into the log. These counters are being flushed in every 15 minutes.
	Flush & reset CDR and other counters		Clears status counters after writing them into the log
[Options]
	Auto scroll	()	Allows automatic scrolling of the log screen
	Save settings		Saves actual settings into the configuration file

The bottom status-line

Idle./Loading...: The state of input data processing.
Uptime: time elapsed since module has been started up;
- Hovering over: start date and time
- left-click: kernel and user time
- righ-click: put a line into the log with the used DLL's and their versions
open output DAT files: Currently opened CDR DAT files for writing

Reading Sga-8135.000: Name of input file currently opened for reading
IPs: Number of processed IP packets containing SCTP payload
MSUs: Number of MSUs taken out from SCTP payload

Last MSU: Date and time of the last processed MSU
Latest MSU: Date and time of the latest MSU

IPerror: Number of IP level errors
PCunresolved: Number of cases when it was not possible to assign GT to a point code
TCAPerror: Number of TCAP level errors
MAPerror: Number of MAP level errors
MultiIMSI{diff}: Number of cases when a dialog contains more than one IMSI which are different

SCCP Counters for SCCP messages
- Mgmnt: Number of SCCP management messages
- MAP: Number of MAP messages
- INAP: Number of INAP messages
- other: Number of other SCCP messages
ISUP: Number of ISUP messages
BICC: Number of BICC messages
other: Number of other types of messages

IMSISDN entries in use Counters for IMSI-MSISDN entries
- now: Number of current IMSI-MSISDN pairs
- updated: Number of entries where the MSISDN for an IMSI has been changed to an other one
- overflown: Number of overflown entries
- deleted: Currently not used
- timed-out Number of entries deleted due to exceeding the lifetime (INI/[IMSISDN Memory]/dwEntryLifeSec)
- hit/missed: Number of successful/unsuccessful requests from the database

{IMSI+MSISDN} pairs Number of IMSI+MSISDN pairs forwarded to the central IMSI-MSISDN database (via "Sga-8999.nnn" output files)

CDRs: Number of collected records
- w/o IMSI: Number of records without an IMSI
- w/o MSISDN: Number of records without an MSISDN
Active dialogs: Number of opened MAP dialogs
- with bwTID: Number of MAP dialogs with backward TransactionID
items: Number of messages belonging to the active dialogs

Error countes
- E1: Number of CONTINUE and END messages for which no BEGIN has been seen previously.
- E2: Number of messages being dropped due to too many pending dialogs. No record is being generated; red line in log. (Increase [MAP Dialogs]/dwMaxActiveCount value in the INI!)
- E2i: Number of messages....
- E3: Number of cases when....
- E7: Number of timed out dialogs.
- reTX(BEGIN): Number of retrasmitted BEGIN messages. "Another BEGIN has already been seen for the dialog that the above BEGIN belongs to - probably retransmission.

Configuration (`Sga-MAP_CDR-Assembler.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 `[Options]/Auto scroll` menu item!)
[PC--->GT]
	202	36309489902	Point Code → Global Title assignments
[INAP SSN]
	146	reserved for national networks	List of Subsystem Numbers with free text remarks which should be interpreted as INAP instead of MAP
[IP-SM-GW]
	36309888046	any remark	List of Global Titles of IP-SM-GW nodes
[MAP Dialogs]
	dwMaxActiveCount	100000	Defines maximum count of opened dialogs
	dwTimeoutSeconds	90	Defines max length of pending dialogs
	dwExtraHoldTimeMS	1000	Defines an additional hold time after dialog time out waiting for messages arriving after the dialog closing message
	dwCheckTimeoutsAfterEveryNthRecord	100	Opened dialogs are being checked whether they are timed out after every Nth processed records
	sBackupFile	d:\Backups\Sga-8135.SAV	Opened dialogs are saved into this file on operator requested program exit
[MAP CDR Files]
	wPeriodMinutes	15	Period of creating CDR files (given in minutes)
	dwPreallocationSize	250000000	Preallocation size of CDR files, in bytes
	dwPreallocationSize_IMSIindex	25000000	Preallocation size of IMSI index files, in bytes
	dwPreallocationSize_MSISDNindex	25000000	Preallocation size of MSISDN index files, in bytes
	iCompressionLevel	6	Compression level for CDRs. 0 means compression is switched off
	dwUseCrypto	1	Enables encryption of CDR files; 0 means off
	sPathPrimary	e:\MAP-CDR\	Path for CDRs
	sPathAlternate	f:\MAP-CDR-2	Alternative path for CDRs when `sPathPrimary` is inaccessible
[IMSISDN Memory]
	dwEntryLifeSec	2592000	Life time for each IMSI-MSISDN pair entry; given in seconds
	sBackupFile	c:\SgaIMSISDNbdb_BackupFile.bin	Path and file for saving IMSI-MSISDN pair entries
	bBackupPeriodic	True	If True then the IMSI-MSISDN memory is periodically saved into the backup file
[Sga-8999 files]
	sOutputDataFilesPath	e:\8999Files	Path for output temporary files containing IMSI-MSISDN information for the Sga-IC system
	dwOutputDataFilesCutSizeInBytes	500000	Output Sga-8999.nnn files will be cut after reaching this size (given in bytes)
[Advanced]
	wLogDetailLevel	3	(Equals to the listed order; refer to the `[Log]/Details` menu item!)
	dwMaxLinesInLogWindow	1000	Number of lines in the log window on screen
	wMaxCPUUsagePercent	100	Limit of CPU-usage for this module
	sInput8135FilesPath	e:\InputFiles	Path for input temporary files (Sga-8035.nnn) containing messages to be processed (generated by the Massage Sorter module)
	sLogFilesPath	d:\Logfiles	Path for the LOG files

Version history

v0.91

First official release

The MAP CDR Assembler module("Sga-MAP_CDR-Assembler")

Table of Contents

Features

User interface

The main menu

The bottom status-line

Configuration (Sga-MAP_CDR-Assembler.ini) file settings

Version history

The MAP CDR Assembler module
`("Sga-MAP_CDR-Assembler")`

Configuration (`Sga-MAP_CDR-Assembler.ini`) file settings