TSP Lab	SgaRomSt - Roaming statistics	SgaRomSt

The roaming statistics creator module
`("SgaRomSt")`

Basic Operation

Periodically scans the working directory for Sga-7009.xxx files
Loads IMSI and operator prefix lists
Assembles the messages in connection with the a Provide Roaming Number transaction and the corresponding call establishing
(ProvideRoamingNumber_Invocation (PRN_I) - ProvideRoamingNumber_ReturResult/Abort (PRN_R) - Initial Address Message (IAM))
Logs into file and onto screen (selectable detail level)
Creates statistics about roaming call success per operator and per IMSI prefix basis for adjustable periods (*.SzA statistics files)
Dumps short statistics from bottom status-line at every quater hours
Collects and updates roaming number ranges for further usage
Saves roaming number ranges into a binary file
Creates daily alarm files (SgaRomSt_Alarms_YYYYMMDD.txt) to list unrecognized IMSI and Operator prefixes. (Prefix lists can be revised based on these alarm files.)

IAM filtering

Only those incoming IAMs are processed where the B number falls in one of the incoming ranges defined in 7NMonitor.ini/[Task9]/IncomingRangeX
Outgoing IAM's are only processed if they have international addressing
To determine which direction of a signaling link is the incoming one set the link parameters properly (for further information check the explanation of 7NMonitor.ini/[SS7Links]/Link) entries

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)
	Ommit yellow (warning) lines from log file		Warning messages are only written onto screen and not into logfile. This can help preserving file space when there is a temporary problem generating warnings.
[Prefix]
	Reload operator prefix codes		A new or modified operator prefix list can be reloaded
	Reload IMSI prefix codes		A new or modified IMSI prefix list can be reloaded
	Reload both operator and IMSI prefix codes		Reloads both lists
[Options]
	Go on / Pause	(Ctrl-P, or )	Allow periodic scanning of the working directory for `Sga-7009.xxx` files
	Auto scroll	(ScrollLock, or )	Allow automatic scrolling of the log screen
	Flush & reset statistics counters		Collected statistics will be written into a `*.SzA` file and counters will be zeroed
	Flush & reset status-line counters		Counter in the status-line will be written into the log (screen and file) and zeroed
	Save settings		Save actual settings into the configuration (`SgaRomSt.INI`) file

The bottom status-line

Uptime: time elapsed since module has been started up.
... is being loaded.: name of input file under processing. (Reading)
PRNI/PRNR/IAM/EorA/other MSU's: number of
- ProvideRoamingNumber_Invocation
- ProvideRoamingNumber_Return-result
- Initial Address Messages
- End or Abort
- other type than previous MSU's
Complete: number of collected PRN_Inv/PRN_Res/IAM processes
Umatched (TID/RoamNum): Number of messages with TID (PRN_I, PRN_R) or RoamNum (PRN_R, IAM) that have not yet closed
Overflow: it is increased when more statistical records are being generated for TIDs and RoamNumbers than INI/[Advanced]/dwMaxStatKeyCount
Reuse: number of reused TID or roaming number
Missing (prnI,prnR,PRN,IAM): missing messages from a process
- Missing_prnI: there was no PRN_Invoke (but there was Result!)
- Missing_prnR: there was no PRN_Result (but Invoke was)
- Missing_PRN: an IAM arrived but the previous PRN_Result is missing
- Missing_IAM: there was a PRN_Result but correspondig IAM did not arrived

Roaming statistics file (`*.SzA`)

The PRN statistics files contain the following data:

Date/Time: End timestamp of the period
IMSIPrefix_value: value of the IMSI prefix from the IMSI prefix list
IMSIPrefix_name: name of the IMSI prefix from the IMSI prefix list
NI: Network Indication
OPC: Originating PC of the PRN_I
PRN: Number of PRN messages for this IMSI prefix and OPC
noPRNI: Missing PRN_I
noPRNR: Missing PRN_R or Abort
noIAM: Missing IAM
NumA: Number of A numbers
NumA_pc: percent of A numbers (-1, if IAM is missing)
ISDN: if A number is ISDN number
ISDN_pc: percent of ISDN numbers (-1, if IAM is missing)
PRN_IAM_ms: duration between PRN_I and IAM (-1, if IAM is missing)

Format of IMSI and operator prefix files (`IMSIPref.cfg`, `OpPref.cfg`)

Some sample IMSI prefix entries:

216301 HUNGARY_WESTEL
216302 HUNGARY_WESTEL
216303 HUNGARY_WESTEL

Some sample operator prefix entries:

36 HUNGARY
3630 HUNGARY_WESTEL

Value: prefix value (at most 20 digit long)
Prefix name: name for the prefix value (at most 20 character long)
the value and name must be separated by a space

Configuration (SgaRomSt.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` menuitem!)
[Advanced]
	wLogDetailLevel	3	(Equals to the listed order; refer to the `[LOG]/Details menuitem!)`
	wMaxCPUUsagePercent	25	Limit of CPU-usage for this module
	dwMaxLinesInLogWindow	1000	Number of lines in the log window on screen
	dwMaxCDRElemCount	1000	Maximum number of concurrent roaming calls. Further calls will be dropped but counted.
	dwActiveCallDurationTimeOutSec	60	Time limit for long calls in seconds. If a call reaches this limit it will be closed and counted.
	dwFlushStatPeriod	300	Period of roaming statistics file creation (in seconds)
	dwFlushStatDelay	10	Written out of statistics file can be delayed by this value
	dwMaxStatKeyCount	25000	A statistics file can contain at most a limited number of rows. Further records will be dropped and counted
	sOpPrefFile	c:\Sga-7N Server\OpPref.cfg	Name and path of the operator prefix file
	sIMSIPrefFile	c:\Sga-7N Server\IMSIPref.cfg	Name and path of the IMSI prefix file
	sAlarmFilesPath	d:\AlarmFiles	Daily alarm files will be created into this directory
	sStatPath	d:\StatFiles	Folder for files containing roaming call statistics
	sLogFilesPath	d:\LogFiles	Path for the LOG files
[RoamRangeList]
	sRoamRangeListFile	c:\Sga-RoamRangeList.bin	Binary file to store roaming ranges when the module has been shut down
	dwRoamEntryLifeSec	86400	Life time parameter for roaming ranges. If no new call occures in a range in this duration the range will be dropped from the list (in seconds)

Version history

v1.12

(c) Limit for count of nodes within the prefixes increased from 16384 to 32768.

v1.11

(c) Limit for count of nodes within the prefixes increased from 8192 to 16384.
(c) Log on start-up includes the section name for the particular INI settings.
(n) Shift-ESC combination minimizes application window.
(c) Opening and closing (and deleting) of input and output files are logged only in case of LogDetailLevel=Debug.
(c) Refresh interval can no longer be set; the default '1000 ms' setting will always be applied.
(c) INI/[Advanced]/wRefreshInterval is obsolete.

v1.10

(n) Daily alarm files (SgaRomSt_Alarms_YYYYMMDD.txt) to list unrecognized IMSI and Operator prefixes.
(n) INI/[Advanced]/sAlarmFilesPath (defaults to "c:\AlarmFiles").
(c) The unused INI/[RoamRangeList]/dwRoamRangeMaxCount and byDigitsToBeTrimmed are no longer saved into and loaded from the INI.

The roaming statistics creator module("SgaRomSt")

Basic Operation

IAM filtering

User Interface

The main menu

The bottom status-line

Roaming statistics file (*.SzA)

Format of IMSI and operator prefix files (IMSIPref.cfg, OpPref.cfg)

Configuration (SgaRomSt.INI) file settings

Version history

The roaming statistics creator module
`("SgaRomSt")`

Roaming statistics file (`*.SzA`)

Format of IMSI and operator prefix files (`IMSIPref.cfg`, `OpPref.cfg`)