TSP Lab	SgaBSSAPCDR - BSSAP CDR Assembler module	SgaBSSAPCDR

The BSSAP CDR generator module
`("SgaBSSAPCDR")`

Basic Operation
User interface
The bottom status-line
SgaCallDispersion functions
TAC-FAC based records
Cell related records (LAC-CI records)
SNMP alarms
Configuration
Version history
- SgaBSSAPCDR.exe
- SgaCallDispersion.dll

Basic Operation

Periodically scans the working directory for Sga-8135.xxx files, created by the SgaBSSAPCDSorter module
Assembles the messages in connection with the same transaction based on their SLR/DLR and OPC/DPC
CDRs created from the complete transactions are being saved in binary format
Creates Bearer Capability statistics based on TAC/FAC and LAC/CI
Creates Classmark Information statistics based on TAC/FAC and LAC/CI
Collects transactions with pre-defined Bearer Capability combinations (Bearer Capability Matching)
Optionally forwards information for Location Update statistics in Sga-7008.xxx files into the given directory
Uses SgaBSSAPDecoder.dll to decode BSSAP messages to extract CDR related parameters
Uses SgaCallDispresion.dll for BC matching feature and to create Bearer Capability related tables, as well
Optionally provide location information for the Sga-UTI system
Maintains a TMSI--->IMSI assocication memory
Optionally creates backup file of TMSI--->IMSI associations
Can creates TMSI--->IMSI association files for SgaBSSAPOraLoaderTMSI_Lister
Derives MSISDN for records based on the IMSI from the IMSI-MSISDN database DLL (uses SgaIMSISDNbdb.dll)
Collects and assembles Paging related messages
Optional compression of CDR files to save place
Optional encryption of CDR files to avoid unauthorized access

User Interface

The main menu

Menu	Menuitem	Shortcut(s)	Meaning
[Log]
	Find line containing...	(Ctrl-F)	Find text in log window
	Find next matching line	(F3)	Find next occurrence of text in log window
	Details		Detail level of logging (Off, Normal, Detailed or Debug)
[Actions]
	Go on / Pause	(Ctrl-P, or )	Allow periodic scanning of the working directory for `Sga-8135.xxx` files
	Reload INI/[RNC Point Codes]		Section INI/[RNC Point Codes] can be reloaded on subsequent operator requests
	Reload INI/[BearerCapabilityMasks]	(Ctrl-M)	Section INI/[BearerCapabilityMasks] can be reloaded on subsequent operator requests
	Reload INI/[Bearer Capabilities]/sTACFACSelection		Section INI/[Bearer Capabilities]/sTACFACSelection can be reloaded on subsequent operator requests
	Reload INI/[Bearer Capabilities]/sLACCISelection		Section INI/[Bearer Capabilities]/sLACCISelection can be reloaded on subsequent operator requests
	Reload INI/[Classmark Information]/sTACFACSelection		Section INI/[Classmark Information]/sTACFACSelection can be reloaded on subsequent operator requests
	Reload INI/[Classmark Information]/sLACCISelection		Section INI/[Classmark Information]/sLACCISelection can be reloaded on subsequent operator requests
	Flush CDR and error counters into log		Actual values of the CDR and error counters are written into the log
	Flush & reset CDR and error counters		Actual values of the CDR and error counters cleared after written into the log
	Write all "(TMSI--->IMSI) Memory" entries into "700T.nnn" file		Entries of "(TMSI--->IMSI) Memory" are written into 700T.nnn file.
	Dump "(TMSI--->IMSI) Memory" entries [debug]		Entries of "(TMSI--->IMSI) Memory are written into the log.
	Dump "Paging Memory" entries [debug]		Entries of "Paging Memory" are written into the log.
	Backup "(TMSI--->IMSI) & Paging Memory" entries		Entries of "(TMSI--->IMSI) & Paging Memory" are written into the corresponding binary backup files.
[Options]
	Auto scroll	()	Allow automatic scrolling of the log screen
	Suspend traps for 1 hour		Trap generation is suspended for 1 hour.
	Save settings		Save actual settings into the configuration (`SgaBSSAPCDR.INI`) file

The bottom status-line

Uptime: time elapsed since module has been started up.
Reading: name of the current input Sga-8135.xxx file.
IPs: number of incoming IP packets
MSUs: number of processed MSUs
CDRs: number of complete CDRs
- w/o IMSI: number of CDRs without IMSI
- w/o MSISDN: number of complete CDRs without MSISDN
Active transactions: number of transactions that have CR and are not complete yet
with DLR: number of transactions that already have DLR
items: number of items in active transactions
SGsAP: number of SGsAP records
open DATs: CDR files that are currently opened
Error counters
- E1: number of messages without a CR (yellow line in the log: "No CR has been seen for the above DT1.")
- E1/CC number of CC messages without preceding CR
- E2: increased when a new CR arrives when the number of the active transactions is reached the SgaBSSAPCDR.ini/[Advanced]/dwMaxActiveTransactionCount (Red colored "Too many active transactions!" in the log.)
- E2i number of items what are dropped due to the case message memory is full (and transaction memory is not yet full)
- E3: TID (more exactly SLR) re-use counter (yellow line in the log)
- E7: number of timed-out transactions (yellow line in the log)
- reTX(CRorCC): number of SCTP retransmissions
BearerCap/TAC-FAC
- encountered: number of Bearer Capability TAC-FAC records
- overflown: if the number of Bearer Capability TAC-FAC records in the actual file reached the SgaBSSAPCDR.ini/[Bearer Capabilities]/dwMaxTACFACStatRecords the new Bearer Capability TAC-FAC's will be dropped and counted here
- keys: current number of stat records in the actual statistics file
BearerCap/LAC-CI
- encountered: number of Bearer Capability LAC-CI records
- overflown: if the number of Bearer Capability LAC-CI records in the actual file reached the SgaBSSAPCDR.ini/[Bearer Capabilities]/dwMaxLACCIStatRecords the new Bearer Capability LAC-CI's will be dropped and counted here
- keys: current number of stat records in the actual statistics file
ClassMark/TAC-FAC
- encountered: number of Classmark Information TAC-FAC records
- overflown: if the number of Classmark Information TAC-FAC records in the actual file reached the SgaBSSAPCDR.ini/[Classmark Information]/dwMaxTACFACStatRecords the new Classmark Information TAC-FAC's will be dropped and counted here
- keys: current number of stat records in the actual statistics file
ClassMark/LAC-CI
- encountered: number of Classmark Information LAC-CI records
- overflown: if the number of Classmark Information LAC-CI records in the actual file reached the SgaBSSAPCDR.ini/[Classmark Information]/dwMaxLACCIStatRecords the new Classmark Information LAC-CI's will be dropped and counted here
- keys: current number of stat records in the actual statistics file
Matching
- compared: number of BC combinations compared with the masks (SgaBSSAPCDR.ini/[Bearer Capabilities]/sMaskX) /
- matched: BC combinations matching criteria
UTI records: number of UTI records written into temporary data files (Sga-9001.***)
- failed-to-write: number of records failed to write into files
TMSI entries in use
- now: number of current IMSI-TMSI pairs
- overflown: if the size of the table reaches the SgaBSSAPCDR.ini/[Advanced]/dwIMSIMemoryMaxEntryCount value the new IMSI-TMSI values will be dropped and this counter will be increased
- hit/missed: when a new messages arrives with a TMSI an IMSI will be looked for this TMSI , number of queries and hits are counted here
<>IMSIs
- bothsure:
- old?:
- new!:
Paging entries in use
- now: number of current Paging process
- overflown: if the size of the Paging memory reaches the SgaBSSAPCDR.ini/[Advanced]/dwPagingMemoryMaxEntryCount value the new Paging will be dropped and this counter will be increased
- hit/missed: when a new Paging messages arrives with a TMSI an IMSI will be looked for this TMSI, number of queries and hits are counted here
SMSDV connected: state of the connection from SMSDV application.
SMSDV
- MOCall: number of Mobile Originated calls.
- 7: number of MO calls with 7 digit called number
- -IMSI: number of missing IMSI
- -IMEI: number of missing IMEI
- +IMEI: number of calls with related IMEI
- ?IMSI: number of calls with uncertain IMSI (derived from IMSI-IMEI database instead from related message sequence)
- missed: number of IMSI-IMEI database requests without any hit
- failed: number of failed IMSI-IMEI database requests
- Submit: number of submitted SMSs
- toW: number of submitted SMSs towards T-Mobile's network
- 7toW: number of SMSs towards T-Mobile's network with 7 digit destination user address
- -IMSI: number of missing IMSI
- -IMEI: number of missing IMEI
- ?IMSI: number of call with uncertain IMSI (derived from IMSI-IMEI database instead from related message sequence)
- missed: number of IMSI-IMEI database requests without any hit
- failed: number of failed IMSI-IMEI database requests
HandOver server connected: state of the connection to Handover server.
- ReqAck: number of requests sent to Handover server
- Cmd(match)
  - 2G: number of 2G handover commands sent to Handover server (indicates successful IMSI insertions/updates on Handover server)
  - 3G: number of 3G handover commands sent to Handover server (indicates successful IMSI insertions/updates on Handover server)
- IMSIfound
  - brandnew: number of new IMSIs.
  - ==: number of IMSIs with correct timestamp.
- <>IMSIs
  - bothsure: number of cases where old and new IMSIs are both sure.
  - old?new?: number of cases where old and new IMSIs are both sure.
  - old?new!(==/<>): number of cases where the new IMSI is sure.
  - old!new?(==/<>): number of cases where the old IMSI is sure.
KeyServer1/23G connected / not connected: state of the connection to the first KeyServer/23G server for S1AP deciphering
- TMSI-IMSI pairs:
  - sent: number of TMSI-IMSI pairs sent to the KeySever/23G
  - not sent: number of TMSI-IMSI pairs not sent to the KeySever/23G
  - failed to send: number of TMSI-IMSI pairs failed sent to the KeySever/23G

The Bearer Capability parameter is collected from 'SETUP', 'EMERGENCY SETUP' and 'CALL CONFIRM' messages. Only that BC parameter is decoded which was sent by the MS. Because the SETUP message can be sent in both direction and CALL CONFIRM can be missing in some cases the PAGING RESPONSE and CM SERVICE REQUEST messages are watched also to detect BC direction every time.

Classmark Information decoding

The Classmark Information parameter is decoded only in that case if the connection has an 'ASSIGNMENT COMPLETE' or 'HANDOVER REQUEST ACK' message. Only the last seen parameters are decoded from all the three types of CI.

Collecting cells and time measuring for LAC-CI tables

The cell information is collected from all the BSSAP messages. If an 'ASSIGNMENT COMPLETE', 'HANDOVER REQUEST ACKNOWLEDGE' or 'HANDOVER PERFORMED' message appears, the current (seen) cell is recorded, and time measuring starts. It lasts until 'CLEAR COMPLETE' or 'HANDOVER PERFORMED' messages. (As it can see 'HANDOVER PERFORMED' has both functions.) The connection time results are in milliseconds. If among the recorded cells two consecutive cells have the same identifier, they are joined together.

TAC-FAC based records

The table contains one row for each TAC-FAC combination
The DateTime column shows the timestamp when the last connection for the actual record has been closed within the ini file's SgaBSSAPCDR.ini/[Bearer Capabilities]/dwFlushTACFACStatPeriod or SgaBSSAPCDR.ini/[Classmark Information]/dwFlushTACFACStatPeriod value interval given in seconds
At CapVal #n (n=1 to 67 for Bearer Capability and 1 to 82 for Classmark Information) columns there are the values of capability parameters (Explanation of BC tables' headers; Explanation of Classmark tables' headers)
The "v" column indicates the version information of a combination for a given TAC-FAC. If a TAC/FAC occurs with capability combination that not exists in the table there will be a new record with this TAC/FAC and capability parameter values. When an existed TAC/FAC-capability combination appears again, the Count column of this will be incremented.
The "Count" column shows count of a given occurrence of a capability combination for the given TAC-FAC

Bearer Capability TAC/FAC table output format

DateTime

TACFAC

Count

CapVal #1

...

CapVal #67

Only the selected parameters based on ini file's [Bearer Capabilities]/sTACFACSelection key will be shown in the table.

Classmark Information TAC/FAC table output format

DateTime

TACFAC

Count

CapVal #1

...

CapVal #82

Only the selected parameters based on ini file's [Classmark Information]/sTACFACSelection key will be shown in the table.

Cell related records (LAC-CI records)

In this table there are the cell identifiers and occurrence of parameter values
The DateTime column shows the timestamp when an MS appeared first time in a cell that has the actual record's LAC/CI values and the connection for this MS has been closed within the ini file's [Bearer Capabilities]/dwFlushLACCIStatPeriod or [Classmark Information]/dwFlushLACCIStatPeriod value interval given in seconds
The cntr #n (n=1 to 398 for Bearer Capability and 1 to 542 for Classmark Information) columns indicate the count of a parameter value occurrence of the actual record's LAC/CI (Explanation of BC tables' headers; Explanation of Classmark tables' headers)
The time #n (n=1 to 398 for Bearer Capability and 1 to 542 for Classmark Information) columns indicate the connection time in seconds of a parameter value occurrence while it is at the actual record's LAC/CI (Explanation of BC tables' headers; Explanation of Classmark tables' headers)
The "v" column indicates the version information of a combination for a given TAC-FAC
The "Count" column shows count of a given occurrence of a capability combination for the given TAC-FAC
LAC: Location Area Code
CI: Cell Identifier

Bearer Capability LAC/CI table output format

DateTime

LAC

cntr #1

time #1

...

cntr #398

time #398

Only the selected parameter occurrences based on ini file's SgaBSSAPCDR.ini/[Bearer Capabilities]/sLACCISelection key will be shown in the table.

Classmark Information LAC/CI table output format

DateTime

LAC

cntr #1

time #1

...

cntr #542

time #542

Only the selected parameter occurrences based on ini file's SgaBSSAPCDR.ini/[Classmark Information]/sLACCISelection key will be shown in the table.

Parameter filtering

In the ini file there are sTACFACSelection and sLACCISelection keys. At sTACFACSelection the user can give the list of sequence numbers of the parameters for which the TAC/FAC table shall contain the parameter values. At sLACCISelection the user can give the list of sequence numbers of parameter value occurrences for which the LAC/CI table shall contain the count of the parameter value occurrences with their connection time together.

Examples:

sTACFACSelection=1,2,7,67 : CapVal #1, CapVal #2, CapVal #7, CapVal #67 will be shown at TAC/FAC table
sLACCISelection=3,7,107 : cntr #3, time#3, cntr #7, time#7, cntr #107, time#107 will be shown at LAC/CI table

For column explanation see Explanation of BC tables' headers or see Explanation of Classmark tables' headers.

Alarm generation

The BSSAPCDR Generator module raises SNMP alarms when:

The difference between the timestamp of processed messages and the current time is higher than 10 minutes. ("Processing has a huge delay." - ERROR)
The NoCRforCC error counter increased in the previous 15 minute period. ("NoCRforCC error counter exceeded threshold." - CRITICAL)
- threshold: INI/[Trap Thresholds]/dw15minNoCRcount, default is 50.
The TMSI/IMSI error counter increased in the previous 15 minute period. ("TMSI-IMSI error counter exceeded threshold." - ERROR)
- threshold: INI/[Trap Thresholds]/dw15minTMSIIMSIerrorCount, default is 50.
The size of TMSI memory reached a threshold. ("Allocated TMSI count exceeded threshold." - CRITICAL)
- threshold: INI/[Trap Thresholds]/byMaxTMSIAllocatedPercent, default is 15 [%].
The number of CDRs decreased in the previous 15 minute period. Threshold is given in percent. ("CDR count decreased too much." - CRITICAL)
- threshold: INI/[Trap Thresholds]/by15minCDRdecreasePercent, default is 15 [%].
The number of MSU decreased in the previous 15 minute period. Threshold is given in percent. ("MSU count decreased too much." - CRITICAL)
- threshold: INI/[Trap Thresholds]/by15minMSUdecreasePercent, default is 15 [%].
The number of SCTP retransmissions reached the given threshold in the previous 60 minute period. ("Retransmission count exceeded threshold." - ERROR)
- threshold: INI/[Trap Thresholds]/dw60minReTXcount, default is 50.
The number of open transaction reached the given threshold. ("Allocated transaction count exceeded threshold." - ERROR)
- threshold: INI/[Trap Thresholds]/byMaxCDRElemCountPercent, default is 15 [%].

Threshold settings are loaded at module start up.

Traps are being generated in every (even successive) period when the cause of an alarm exists. This means a new alarm will be raised in each quater of hour for a longer period.
Ceasing trap is generated at the end of that 15 minute period in which the counter does not reach the threshold.

Trap generation can be suspended for 1 hour manually on the GUI executing [Options]/Suspend traps for 1 hour menu item.

Configuration (`SgaBSSAPCDR.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!)
[RNC point codes]	Defines the RNCs by their point codes. It is used to identify RANAP protocol instead BSSAP in case of RNCs.
	102	RNC1	PC = any remark
[Bearer Capabilities]
	dwMaxTACFACStatRecords	1000	Maximum number of records written into Bearer Capability TAC-FAC stat files. The further records will be lost but counted on the status bar (TAC-FAC overflown)
	dwMaxLACCIStatRecords	1000	Maximum number of records written into Bearer Capability LAC-CI stat files. The further ones will be lost but counted on the status bar (LAC-CI overflown)
	dwFlushTACFACStatPeriod	900	Flush period of Bearer Capability TAC-FAC records
	dwFlushLACCIStatPeriod	900	Flush period of Bearer Capability LAC-CI records
	dwFlushTACFACStatDelay	120	Written out of Bearer Capability TAC-FAC statistics can be delayed by this value
	dwFlushLACCIStatDelay	120	Written out of Bearer Capability LAC-CI statistics can be delayed by this value
	sTACFACSelection	1,2,7,67	Only these adjusted CapVal columns will be shown at Bearer Capability TAC/FAC table
	sLACCISelection	3,7,107	Only these adjusted counters and their connection time columns will be shown at Bearer Capability LAC/CI table
	sBCMatchFilesPath	d:\StatFiles	Bearer Capability matching list is written into this folder
	sStatPathTACFAC	d:\StatFiles	Path for Bearer Capability TAC-FAC statistics files
	sStatPathLACCI	d:\StatFiles	Path for Bearer Capability LAC-CI statistics files
[Classmark Information]
	dwMaxTACFACStatRecords	1000	Maximum number of records written into Classmark Information TAC-FAC stat files. The further records will be lost but counted on the status bar (TAC-FAC overflown)
	dwMaxLACCIStatRecords	1000	Maximum number of records written into Classmark Information LAC-CI stat files. The further ones will be lost but counted on the status bar (LAC-CI overflown)
	dwFlushTACFACStatPeriod	900	Flush period of Classmark Information TAC-FAC records
	dwFlushLACCIStatPeriod	900	Flush period of Classmark Information LAC-CI records
	dwFlushTACFACStatDelay	120	Written out of Classmark Information TAC-FAC statistics can be delayed by this value
	dwFlushLACCIStatDelay	120	Written out of Classmark Information LAC-CI statistics can be delayed by this value
	sTACFACSelection	1,2,7,67	Only these adjusted CapVal columns will be shown at Classmark Information TAC/FAC table
	sLACCISelection	3,7,107	Only these adjusted counters and their connection time columns will be shown at Classmark Information LAC/CI table
	sStatPathTACFAC	d:\StatFiles	Path for Classmark Information TAC-FAC statistics files
	sStatPathLACCI	d:\StatFiles	Path for Classmark Information LAC-CI statistics files
[BearerCapabilityMasks]
	sMaskX	,?,5,,?	Ten Bearer Capability masks can be defined to filter for calls with special Bearer Capability combination. X is from 0 to 9.
[UTI Server]
	s9001FilesPath	c:\DataFiles	Path for circular "Sga-9001.nnn" files containing cell related data
	dw9001FileCutSize	1000000	Temporary files will be cut after reaching this size
	bSendCEAinfoToo	True	If 'True' then sends CEA (A5/1,2,...) info along with the CellDBinfo
[HandOver Server]
	sRemoteIPAddress	192.168.11.23	Defines IP address of the Handover Server
	wRemoteTCPPort	9068	TCP port of the `Handover Server`
	wSecondsToWaitBetweenConnectionTrials	2	Seconds between connection trials.
	wSecondsToWaitBeforeReconnecting	30	Seconds before reconnection after a disconnection.
[SMS DeliVery]
	sRemoteIPAddressAllowed	127.0.0.2	If this entry is given the SMS_DeliVery module only from the defined host can connect.
	wLocalTCPPort	9001	If this value is 0 then the SMS_DeliVery feature is disabled.
[TMSI--->IMSI]
	by700TFilesActualPart	9	This entry always stores the actual value of partition field of TMSI-IMSI records.
	s700TFilesPath	d:\IMSIMemoryFiles	Path of TMSI-IMSI association files for SgaBSSAPOraLoaderTMSI_Lister
	sNRIsInUse	1,2,3,4	TMSI-IMSI pairs are only stored in memory when NRI derived from TMSI is in sNRIsInUse list. sNRIsInUse=*** means all TMSI are stored
[Trap Thresholds]
	byMaxCDRElemCountPercent	15	Threshold for CDR memory
	byMaxTMSIAllocatedPercent	15	Threshold for TMSI memory
	dw15minNoCRcount	50	Threshold for "No CR" counter increase in the previous 15 minutes
	dw15minTMSIIMSIerrorCount	50	Threshold for "TMSI/IMSI error" counter increase in the previous 15 minutes
	dw60minReTXcount	50	Threshold for SCTP retransmissions in the previous 60 minutes
	by15minMSUdecreasePercent	15	Threshold for MSU counter decrease in the previous 15 minutes
	by15minCDRdecreasePercent	15	Threshold for CDR counter decrease in the previous 15 minutes
[BigData Stuff]
	s9099FilesPath	d:\BigDataFiles	Path for circular "Sga-9099.nnn" files containing SCCP data
	dw9099FileCutSize	1000000	Temporary files are cut when reach this size
[KeyServer/23G]
	sRemoteIPaddress	10.111.222.118	Defines IP address of the 2G/3G Key Server module of the S1AP CDR subsystem
	wRemoteTCPport	7111	TCP port of the 2G/3G Key Server module
	sRemoteIPaddress2	10.111.223.118	IP address of the secondary 2G/3G Key Server module
	wRemoteTCPport2	7111	TCP port of the secondary 2G/3G Key Server module
	wSecondsToWaitBetweenConnectionTrials	10	Defines the waiting interval between connection attempts
	wSecondsToWaitBeforeReconnecting	5	Defines the delay before reconnecting after a disconnection
[CR-CC Statistics]
	sPath	d:\StatFiles	Path for CR-CC statistics files
	dwMaxKeyCount	100000	Each statistics file can contain at most a limited number of rows
	dwFlushPeriodSec	900	Period for statistics file writing
	dwFlushDelaySec	15	Written out of statistics file can be delayed by this value
[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
	dwTransactionTimeOutSec	90	Time out for answer of CDR's
	dwTransactionConnectTimeOutSec	20	Defines time out value for transaction continuation after a CR message
	wOutFilePeriod	10	Period of creating BC matching list file (given in minutes)
	dwOutFilePreallocationSize	120000000	Preallocated size of CDR files, in bytes.
	dwOutFilePreallocationSize_IMSIindex	9200000	Preallocated size of IMSI index files, in bytes.
	dwOutFilePreallocationSize_MSISDNindex	9200000	Preallocated size of MSISDN index files, in bytes.
	iOutFileCompressionLevel	6	Compression level for CDRs. 0 means compression is switched off.
	dwOutFileUseCrypto	0	Enables encryption of CDR files; 0 means off.
	dwMaxActiveTransactionCount	1000	Number of active transactions at the same time.
	dwIMSIMemoryMaxEntryCount	10000	At most this amount of IMSI's are stored in two tables (TMSI->IMSI and EncryptionInfo->IMSI)
	dwIMSIMemoryEntryLifeSec	120	When an IMSI's lifetime reaches this value it will be dropped from the tables
	dwPagingMemoryMaxEntryCount	1000	Number of simultaneous Paging procedures that can be stored.
	dwPagingMemoryEntryLifeSec	60	Maximum waiting interval after a Paging process; given is sec.
	dwPagingMemoryEntryT0MSec	2000	Value of the T0 timer; give in msec. Paging messages during this time are calculated together.
	sPagingBackupFile	c:\SgaBSSAPCDR_PagingBackupFile.bin	Path for Paging backup in case of program shuts down.
	bPagingBackupPeriodic	True	Enables to back up paging memory periodically.
	dwLUStat7008FileCutSize	100000	Cutting size (in byte) of LUStat7008 files, defaults to 1000000
	sLUStat7008FilesPath	d:\LUStat	Path for Location Update statistics (defaults to empty string: no collection of records)
	sDataPath	d:\BSSAPCDRFiles	Path for BSSAP CDRs
	sDataPathAlternate	x:\BSSAPCDRFiles	Alternative path for BSSAP CDRs when `sDataPath` is inaccessible.
	sTMSIBackupFile	d:\TMSIBackup.bin	Backup filename of TMSI-IMSI association entries (defaults to "c:\SgaBSSAPCDR_TMSIBackupFile.bin")
	bTMSIBackupPeriodic	True	If True, preparing TMSI-IMSI backup file is allowed (defaults to True)
	sLogFilesPath	d:\LogFiles	Path for the LOG files
	sTrapFilesPath	d:\TrapFiles	Path for the trap files
	byDebugLevel	1	When it is not 0 the Bearer Capability matching result contains the Bearer Capability parameters, as well
	sActiveTransactionsFile	e:\BSSAPCDR\DataFiles\	Plase of active transaction file created at exit.

Version history

SgaBSSAPCDR.exe

v1.67

(n) Can handle a secondary KS23G
(n) INI / [KeyServer/23G] / sRemoteIPaddress2, wRemoteTCPport2
(n) Brand-new CR-CC statistics
(n) INI / [CR-CC Statistics] / sPath
(n) INI / [CR-CC Statistics] / dwMaxKeyCount, dwFlushPeriodSec, dwFlushDelaySec
(n) Additional time-out, based on CR-CC duration
(n) INI / [Advanced] / dwTransactionConnectTimeOutSec

v1.66

(n) CEA (A5/1,2,...) information is extended with CellInfo data
(n) Assembles segmented DT1 messages

v1.65 (+ SgaBSSAPDecoder.dll v1.18)

(n) Optionally sends CEA (A5/1,2,...) info along with the CellDBinfo
(n) INI / [UTI Server] / bSendCEAinfoToo

v1.64 (+ SgaBSSAPDecoder.dll v1.16)

(c) More detailed UTI (CellDBInfo) types for PS-records as well

v1.63

(n) New UTI (CellDBInfo) types: "Attach" (6) and "Detach" (7), used to be indicated as "Other" (255)
(n) Right mouse-click displays current DLL version numbers in log
(c) "[KeyServer/4G]" ---> "[KeyServer/23G]"
(n) Hotkey: F12 (LogLevel=Off)
(c) More efficient scrolling of the log window

v1.62T5

(n) Sends IMSI-TMSI pairs to KS4G
(n) [KeyServer/4G] / sRemoteIPaddress, wRemoteTCPport, wSecondsToWaitBetweenConnectionTrials, wSecondsToWaitBeforeReconnecting

v1.61

(c) CDR assembly is based on {OPC|DPC|SLR} (used to rely on {OPC|SLR}, but new MME assigns same local reference value for different destinations)

v1.60

(c) Ignores 16-digit (or even longer) IMSI; logs it as an error. (Note: v1.59 truncated them to 15 digits.)

v1.59

(n) Binary output files are optionally generated for BigData loading
(n) New INI section: [BigData Stuff]. New entries:
- s9099FilesPath=d:\BigData
- dw9099FileCutSize=1000000
(n) Output folders are checked at module start
(n) Truncates 16-digit (or even longer) IMSI; logs it as a error.

v1.58

(c) Timestamp of IMSI-MSISDN pairs is updated by SGsAP events, as well.

v1.57

(f) SCCP/CadPA is now correctly decoded.

v1.56

(n) MSISDN index is introduced.
(n) New INI entry: dwOutFilePreallocationSize_MSISDNindex
(c) CDR contains derived MSISDN, as well.

v1.55

(n) Place of file containing active transactions at exit can be defined.
(n) New INI entry: [Advanced]/sActiveTransactionsFile.

v1.54

(n) ISUP messages are dropped based on SIO field.
(n) Non BSSAP and RANAP are dropped based on SSN:

v1.53

(c) Paging carried by XUDT messages are also handled.

v1.52

(n) IMSI index is introduced.
(n) New INI entry: dwOutFilePreallocationSize_IMSIindex

v1.51

(n) MSISDN-IMSI pair collection is introduced.

v1.50

(c) New input format for processing data from GyTapper directly.
(n) New INI section: [RNC point codes].
(n) New menu item: [Actions]/Reload INI/[RNC Point Codes].
(c) Input file is Sga-8135.xxx.

v1.41

(f) UID for CEA traps were not always set correctly.

v1.40

(f) UID for CEA traps were not always set correctly.

v1.39

(c) Cell related info is written into circular "Sga-9001.nnn" files instead of sending them in UDP datagrams.
(c) [ITIS Server] section and sIPAddress=127.0.0.6, wUDPPort=9000 entries are obsolete.
(n) New INI section: [UTI Server]. New entries:
- s9001FilesPath=c:\DataFiles
- dw9001FileCutSize=1000000
(n) Now cell info are generated from 3G not only 2G.

v1.38

(n) Notification is sent also at closing of those BSSAP or RANAP transactions from which cell info is generated.
(n) MO-USSD event is now individually indicated.

v1.37

(c) In "Utinform" projects now the IMSI is used to follow subscribers instead of former EncryptionInfo.
(c) Message timestamps now are in millisecond instead of second.

v1.36

(f) Previous versions did not handle TMSI-IMSI changes within the very same (i.e., one) second.

v1.35

(n) Accepting and handling input from SGsAP (fake) monitors.

v1.34

(n) New counter for SCTP retransmissions: reTX(CRorCC).
(n) Traps for "strange" behaviors.
(n) Menu / "Suspend traps for 1 hour"
(n) INI / [Trap Thresholds] section with various parameters
- byMaxCDRElemCountPercent, default is 15 [%].
- byMaxTMSIAllocatedPercent, default is 15 [%].
- dw15minNoCRcount, default is 50.
- dw15minTMSIIMSIerrorCount, default is 50.
- dw60minReTXcount, default is 50.
- by15minMSUdecreasePercent, default is 15 [%].
- by15minCDRdecreasePercent, default is 15 [%].

v1.33

(f) Fixing cases including multiple TMSI-changes with uncertain IMSI.

v1.32

(n) New status counter for IMSI-less records.
(n) New INI entry: [TMSI--->IMSI]/sNRIsInUse.
(n) TMSI-IMSI pairs are only stored in memory when NRI derived from TMSI is in sNRIsInUse list.
sNRIsInUse=*** means all TMSI are stored.

v1.31

(c) Changes in TMSI-IMSI conjugation.
(n) New line in status bar with counters:
- there already is a trustworthy IMSI within the dialog and a new trustworthy but different one occurs.
- there is a supposed IMSI (with "?") and a new trustworthy one occurs, which is the same as the supposed one.
- there is a supposed IMSI (with "?") and a new trustworthy one occurs, which is different than the supposed one.

v1.30

(f) In some rare situations unexpected errors might happened.

v1.29

(c) More robust handling of message retransmission.

v1.28

(c) Maximum number of active transactions is increased up to 100,000.
(n) New error counter (E2i) for items what are dropped due to the case message memory is full (and transaction memory is not yet full)
(n) New error counter (E1/CC) for the case when a CC arrives without preceding CR.

v1.27

(c) TMSI-IMSI handling is changed.

v1.26

(c) Interface towards "SgaCallDispersion.dll" is changed due to new capability statistics counters.

v1.25

(c) If output file can not be written then records are written into an alternative path.
(n) INI/[Advanced]/sDataPathAlternate

v1.24

(c) Structure of Sga-700T.xxx files extended with partition field.
(n) TMSI-IMSI memory is dumped into Sga-700T.xxx file at the beginning of every month.
(n) New TMSI-IMSI data related to an already written out entry is dumped for the previous and the actual month, as well.
(c) INI/[Advanced]/s700TFilesPath is moved to [TMSI--->IMSI].
(n) [TMSI--->IMSI]/by700TFilesActualPart entry.

v1.23

(n) Handover handling for 2G and 3G, as well.
(n) Connects to HandoverServer to share and query Handover information.
(n) INI entries:

v1.22

(n) Optional CDR file zipping.
(n) Optional CDR file encryption.
(n) INI entries:

v1.21

(n) Complete handling of 2G and 3G Paging messages.
(n) Paging memory, with optional periodic back-up, save+reload, status-line, debug dump etc.
(n) INI entries:
(c) Keeps 9 files open simultaneously (used to keep 4 only).
(n) Optional DAT file preallocation in order to reduce file fragmentation.
(n) INI/[Advanced]/dwOutFilePreallocationSize (loaded on-the-fly; defaults to 0, which means 'Off')
(c) Algorithm for closing simultaneously written output files is changed to last-recently-written (used to be last-recently-opened).
(c) Slight speed-up by code review.

v1.20

(n) CDRs are extended with:
- up to 4 (different) SigLinkIDs
- original count of messages (but not including IT's dropped) if CDR consisted of more than 100 messages
- SCCP MessageType for each message
- various release causes for each message:
  - BSSMAP_Cause
  - BSSMAP_RR_Cause
  - BSSLAP_Cause
  - RANAP_Cause
  - DTAP_Cause1
  - DTAP_Cause2
  - SMS_RP_Cause
  - SMS_TP_Cause
- some more fields:
  - NegotiatedQoS
  - CNDomainIndicator
  - BSSMAP_CIC
(c) Stores only the first and last IT messages from IT message sequences.
(c) Stores first and last 50 messages if CDR consisted of more than 100 messages.
(c) CellIDs now also include 3G-specific identifiers (UCI, SAC, RAC, CNID and RNCID).
(f) SgaBSSAPDecoder: DTAP-GMM and DTAP-SM mobile identities (IMSI,IMEI,TMSI) were not retrieved.

v1.14

(c) A new condition is added for writing out TMSI-IMSI pairs: the IMSI is not trailed with "?".

v1.13

(c) Only changes of TMSI-IMSI pairs are written into Sga-700T.xxx files.

v1.12

(n) Can prepare Sga-700T.xxx files for SgaBSSAPOraLoaderTMSI_Lister module.
(n) New INI entry: [Advanced]/sIMSIMemory700TFilesPath.

v1.11

(c) SMS-Delivery events is not triggered by CalledNumbers beginning with '#' or '0'.

v1.10

(c) Deletion time of the content of "TMSI-memory" is calculated from the element's last touch time instead of last refresh time.

v1.09

(n) Automatic saving of "(TMSI--->IMSI) Memory" entries (optionally daily, at exit, and on request).
(n) Menu item: ActionBackup "(TMSI--->IMSI) Memory" entries.
(n) Automatic reloading of "(TMSI--->IMSI) Memory" entries (at start-up).
(c) Dialogs with definite IMSI entries (seen mostly on RANAP) are flagged accordingly in SMS-DV records.
(n) "?IMSI" count values indicating "uncertain" IMSI's both for HomeCall and HomeSMS cases, both in status line and log.
(n) Contents of "(EnIn--->IMSI) Memory" status line are also logged periodically.
(n) Contents of "(TMSI--->IMSI) Memory" status line are also logged periodically.
(n) INI/[Advanced]/sTMSIBackupFile (defaults to "c:\SgaBSSAPCDR_TMSIBackupFile.bin")
(n) INI/[Advanced]/bTMSIBackupPeriodic (defaults to "True"; checked at 2:00AM GMT, daily)
(c) ITIS and SMS-DV related counts are all set to 0 when requesting "Flush & reset CDR and error counters" from the menu.
(f) INI/[SMS DeliVery]/wRemoteIPAddressAllowed renamed as sRemoteIPAddressAllowed.

v1.07

(n) "7/11" event handling.
(n) New INI entries:

v1.06

(n) CDR generation from RANAP messageses, as well.

v1.05c

(f) Fixes BearerCapability and ClassmarkInfo statistics issues on LACCI and TACFAC bases.

v1.05b

(f) Fixes BearerCapability and ClassmarkInfo statistics issues on LACCI bases.

v1.04

(c) Voice call and SMS are distinguished.

v1.00

(c) Transaction time-out is based on the timestamp of the last (instead of the first) MSU.
(n) Cache for ITIS data: latest seen CellID is retrieved (if any, along with its timestamp) when encryption info is seen first.
(c) Transaction backup file renamed from "Sga-8035.SAF" to "Sga-8035.SAK".

v0.99

(n) Implements ITIS record collection and distribution.
(n) INI/[ITIS Server]/sIPAddress (loaded and logged at start-up; defaults to empty string, which disables ITIS feature).
(n) INI/[ITIS Server]/wUDPPort (loaded and logged at start-up).
(n) Status line for ITIS records sent; also logged quarterly.
(n) Status line for "TMSI memory" was missing (similar to "EnIn memory").

v0.98

(n) Optional TACFAC and LACCI statistics for Classmark Information (Class.Inf.) as well as for the already existing Bearer Capabilities (Bear.Cap.).
(n) One more status line for Class.Inf.-related counters.
(c) Bear.Cap. TACFAC statistics output CSV file name "SgaBSSAPCDR-TACFAC-YYYYMMDDhhmm_N.PMS.csv" becomes "SgaBSSAPCDR_BC-TACFAC-YYYYMMDDhhmm_N.PMS.csv".
(c) Bear.Cap. LACCI statistics output CSV file name "SgaBSSAPCDR-LACCI-YYYYMMDDhhmm_N.PMS.csv" becomes "SgaBSSAPCDR_BC-LACCI-YYYYMMDDhhmm_N.PMS.csv".
(n) Class.Inf. TACFAC and LACCI statistics output files are "SgaBSSAPCDR_CM-TACFAC-YYYYMMDDhhmm_N.PMS.csv" and "SgaBSSAPCDR_CM-LACCI-YYYYMMDDhhmm_N.PMS.csv", respectively.
(c) Former INI/[Advanced] entries related to Bear.Cap. TACFAC and LACCI statistics and Bear.Cap. matching moved into INI/[Bearer Capabilities].
(n) New INI/[Classmark Information] section entries related to Class.Inf. TACFAC and LACCI statistics.
(c) Menu items "Reload INI/[Advanced]/sTACFACSelection" and "Reload INI/[Advanced]/sLACCISelection" are renamed as "Reload INI/[Bearer Capabilities]/sTACFACSelection" and "Reload INI/[Bearer Capabilities]/sLACCISelection", respectively.
(n) New menu items "Reload INI/[Classmark Information]/sTACFACSelection" and "Reload INI/[Classmark Information]/sLACCISelection".
(c) INI/[Advanced]/dwMaxTACFACStatRecords ---> INI/[Bearer Capabilities]/dwMaxTACFACStatRecords
(c) INI/[Advanced]/dwMaxLACCIStatRecords ---> INI/[Bearer Capabilities]/dwMaxLACCIStatRecords
(c) INI/[Advanced]/dwFlushTACFACStatPeriod---> INI/[Bearer Capabilities]/dwFlushTACFACStatPeriod
(c) INI/[Advanced]/dwFlushLACCIStatPeriod ---> INI/[Bearer Capabilities]/dwFlushLACCIStatPeriod
(c) INI/[Advanced]/dwFlushTACFACStatDelay ---> INI/[Bearer Capabilities]/dwFlushTACFACStatDelay
(c) INI/[Advanced]/dwFlushLACCIStatDelay ---> INI/[Bearer Capabilities]/dwFlushLACCIStatDelay
(c) INI/[Advanced]/sTACFACSelection ---> INI/[Bearer Capabilities]/sTACFACSelection
(c) INI/[Advanced]/sLACCISelection ---> INI/[Bearer Capabilities]/sLACCISelection
(c) INI/[Advanced]/sStatPathTACFAC ---> INI/[Bearer Capabilities]/sStatPathTACFAC
(c) INI/[Advanced]/sStatPathLACCI ---> INI/[Bearer Capabilities]/sStatPathLACCI
(c) INI/[Advanced]/sBCMatchFilesPath ---> INI/[Bearer Capabilities]/sBCMatchFilesPath
(n) INI/[Classmark Information]/dwMaxTACFACStatRecords
(n) INI/[Classmark Information]/dwMaxLACCIStatRecords
(n) INI/[Classmark Information]/dwFlushTACFACStatPeriod
(n) INI/[Classmark Information]/dwFlushLACCIStatPeriod
(n) INI/[Classmark Information]/dwFlushTACFACStatDelay
(n) INI/[Classmark Information]/dwFlushLACCIStatDelay
(n) INI/[Classmark Information]/sTACFACSelection
(n) INI/[Classmark Information]/sLACCISelection
(n) INI/[Classmark Information]/sStatPathTACFAC
(n) INI/[Classmark Information]/sStatPathLACCI

v0.97

(n) Can optionally generate compatible BSSAP/LocationUpdate records ("Sga-7008.NNN") as input for further LocUpd statistics.
(n) INI/[Advanced]/sLUStat7008FilesPath (defaults to "" (empty string), which results in no collection of records).
(n) INI/[Advanced]/dwLUStat7008FileCutSize (given in bytes, defaults to 1000000, logged at start-up).

v0.96

(f) LAC-CI statistics output might have contained incorrect counts.

v0.95

(f) Presumed IMSI's (those marked with '?') no longer result in "Another IMSI has already been seen in this connection." if assumption was correct.
(c) Transaction backup file renamed from "Sga-8035.SAV" to "Sga-8035.SAF".
(c) SigLink and Monitor ID's are replaced with spaces when set to NULL in input file (e.g., as is in the output of the Sgc project).

v0.94

(n) Dynamic selection of TACFAC and LACCI result columns.
(n) INI/[Advanced]/sTACFACSelection and sLACCISelection
(n) Menu items "Actions" / "Reload INI/[Advanced]/sTACFACSelection" and "Reload INI/[Advanced]/sLACCISelection".
(f) Memory corruption might occur after reloading saved transactions' data.

v0.93

(n) BSSAP-CDR records are run-length encoded on-the-fly, resulting in a compression factor of 10 on average.
(n) Code optimization, resulting in a speed-up factor of 5 when Bear.Cap. filtering is active.
(c) Section INI/[BearerCapabilityMasks] is reloaded on start-up and on subsequent operator requests.
(n) Menu "Actions"/"Reload INI/[BearerCapabilityMasks]"; Ctrl-M can also be used.
(c) Normal log level no longer logs the individual transactions.
(n) Bear.Cap. filtering result count is shown in status bar (and logged periodically as well).

SgaCallDispersion.dll

v0.95

(c) Interworking with BSSAP Assembler v1.28.

v0.94

(n) Release 8 and 9 fields added. (E-UTRA FDD support, E-UTRA TDD support, E-UTRA Measurement and Reporting support, Priority-based reselection support, UTRA CSG Cells Reporting, VAMOS Level).
(n) FLO Iu Capability field added.
(f) Incorrect decoding occured if Classmark 3 parameter contained the 'FLO Iu Capability' field.

v0.93

(f) Classmark Type3 (DTM EGPRS High Multi Slot parameter) decoding error.

v0.92 --- not official release

(c) Better Cellid verification.
(f) Skipping empty SCCP messages during CallDispersion algorithm (instead of message error).

v0.91

(c) Some minor changes which are invisible for users. Interworking with BSSAPDecoder.dll v1.09.

v0.90

(c) Time measuring starts from ASSIGNMENT COMPLETE (instead of CONNECT) message.
(c) Time measuring ends with CLEAR COMPLETE (instead of DISCONNECT, HANDOVER COMMAND) message.
(c) The result cellarray does not contain cells with 0 millisecond connaction time.
(c) In result cellarray two consecutive cells with the same cell identifier are joined together.

v0.89

(n) Decoding Classmark Information (type 1-3) parameters

v0.88

(c) Using SgaBSSAPDecoder.dll v1.00

v0.87

--- Not official release

v0.86

(f) The LACCI header was incomplete.

v0.85

(c) modified Bearer Capability decoding: columns count and the name of columns changed in the outputs
(c) the important output columns can be chosen by the user for the TACFAC and LACCI result files

v0.84

(f) In some cases not the neccessary Bearer Capability parameter was decoded, if the connection consists more SETUP message.

v0.83

First official release

The BSSAP CDR generator module
`("SgaBSSAPCDR")`

Table of Contents

Basic Operation

User Interface

The main menu

The bottom status-line

SgaCallDispersion functions

Decoding and selecting the proper Bearer Capability

Classmark Information decoding

Collecting cells and time measuring for LAC-CI tables

TAC-FAC based records

Bearer Capability TAC/FAC table output format

Classmark Information TAC/FAC table output format

Cell related records (LAC-CI records)

Bearer Capability LAC/CI table output format

Classmark Information LAC/CI table output format

Parameter filtering

Alarm generation

Configuration (`SgaBSSAPCDR.ini`) file settings

Version history

SgaBSSAPCDR.exe

SgaCallDispersion.dll

The BSSAP CDR generator module("SgaBSSAPCDR")

Table of Contents

Basic Operation

User Interface

The main menu

The BSSAP CDR generator module
`("SgaBSSAPCDR")`