TSP Lab	Sga7N_ISUP_CDRGen - CDR generator	Sga7N_ISUP_CDRGen

ISUP Call Data Record generator module
`("Sga7N_ISUP_CDRGen")`

Basic Operation

Creates CDRs from the sorted call data and stores them in binary format
Closes binary CDR files periodically
Closes calls missing Release message (REL) after a time-out
Lists DPC-OPC pairs from a required set that had no CDR recently at every midnight and at module shut-down
Collects ASR and NER KPI's on an Operator Prefix basis
Provides statistics about accessibility of own and foreign subscribers (outbound and inbound roamers), as well

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)
[Prefix]
	Reload operator prefix codes		`Sga7N_ISUP_CDRGen.ini/[RoamStat]/sOpPrefFile` can be reloaded if it is changed
[KPI's]
	Reload INI/[KPI XXX] lists		Reload KPI lists from `Sga7N_ISUP_CDRGen.ini/[KPI ASR]` and `Sga7N_ISUP_CDRGen.ini/[KPI NER]` sections
	Zero KPI statistics		KPI statistics are cleared
	Flush KPI statistics		Writes KPI statistics into `Sga7N_ISUP_CDRGen.ini/[Advanced]/sKPIStatFilesPath` folder
	Flush and zero KPI statistics		Writes out KPI statistics and zeroes the counters
[Required PC's]/B>
	Reload INI/[Required DPC=OPC pairs] list		Reloads DPC=OPC pair list form `Sga7N_ISUP_CDRGen.ini//[Required DPC=OPC pairs]` section
	Flush and reset list		Writes the list of DPC-OPC pairs from where there is no CDR recently
[Options]
	Go on / Pause	(Ctrl-P, or )	Allow periodic scanning of the working directory for `Sga-7014.xxx` files
	Auto scroll	(ScrollLock, or )	Allow automatic scrolling of the log screen
	Suspend traps for 1 hour.		Suspend alarm generating for 60 minutes.
	Flush and reset counter		The status-line counters can be flushed and cleared
	Save settings		Save actual settings into the configuration (`Sga7N_ISUP_CDRGen.INI`) file

The bottom status-line

Uptime: time elapsed since module has been started up.
Name of input file under processing. (Reading)
Number of call related messages processed (MSUs), assembled call data records (CDRs), active calls (Active calls).
Opened DAT files, they are open till INI/[Advanced]/wOutFilePeriod is expired.
Error counters:
- NoIAM (used to be E1): call related messages (SAM, ACM, ANM/CON, REL) arrived without initial message (IAM). Fake IAMs will be created for these calls CDRs will be created and a red line will appear in the log, as well
- OverFlow (used to be E2): Too many active connections exist. CDR will not be generated and a red line will be written into the log. (INI/[Advanced]/dwMaxCDRElemCount)
- Reuse (used to be E3): A new IAM arrives with a CIC for such a speech channel where the previous call has not been closed, yet
- NoACM (used to be E4): Incremented when closing a call record with an ANM/CON but without an ACM MSU.
- TimeOut (used to be E7): There is no release complete (RLC) but the call is timed-out. (INI/[Advanced]/dwActiveCallDurationTimeOutSec)

Description of the CDR

The CDR contains the following data

Date & time: timestamp of the call initial message (IAM)
NI/DPC/OPC/CIC: parameters from IAM
IAM-ANM: duration between IAM and ANM messages [ms]
IAM-REL: duration between IAM and REL messages [ms]
TraMR: Transmission medium requirement parameter from the IAM
UseSI: "User service information" from the IAM (The lower 7 bits of the first octet representing "Information transfer capability" and "Coding standard" values)
NoA/CagPN(A): CallingPartyNumber and its NatureofAddressIndicator from the IAM message
NoA/CadPN(B): CalledPartyNumber and its NatureofAddressIndicator from the IAM message
NoA/OriCN(C): OriginalCalledNumber and its NatureofAddressIndicator from the IAM message
NoA/RedGN(D): RedirectingNumber and its NatureofAddressIndicator from the IAM message
TraNS: Transit network selection parameter from the IAM
RelCause: Takes out release cause values from the REL/CauI/CauseValue field but also puts other values into CDRs when the following cases occur:
- Reuse: there was a missing REL for a call on a circuit and a new call has been established on the same circuit (E3 counter will be increased)
- TimeOut: there was a missing REL for a call (or the call is too long) and connection time is more than Sga7N_ISUP_CDRGen.ini/[Advanced]/dwActiveCallDurationTimeOutSec (E6 counter will be increased)
- FakeIAM: if an IAM is missing a FakeIAM will be created
- Shut Down: the CDR generator has closed the CDR because it was shut down
IAM SigLink/dir: SigLinkID where the IAM was seen
ACM SigLink/dir: SigLinkID where the ACM was seen
ANM SigLink/dir: SigLinkID where the ANM was seen
REL SigLink/dir: SigLinkID where the REL was seen
RLC SigLink/dir: SigLinkID where the RLC was seen

Roaming Statistics

Accessibility of own subscribers abroad (`200712201421_0.SzB`)

Date/Time: end time of statistics period
VLRPrefix_name: prefix of the VLR where own subscribers actually are in (derived from Sga7N_ISUP_CDRGen.ini/[RoamStat]/sOpPrefFile)
NI/DPC: Network Indicator and Destination Point Code from the IAM
RelCau[0..9]: Counts of calls with predefined Release Cause codes (Sga7N_ISUP_CDRGen.ini/[RoamStat]/sRelCause0..9)
Other: number of calls that do not belong to any RelCause group
ASR (Answer Seizure Ratio): number of CDR's having ANM or CON independently from ReleaseCause (based on ITU-T E.425)
ASR_pc: ASR percentage of the All call
NER (Network Effectiveness Ratio): number of CDR's having an ANM or CON or a RelCause from the predefined set. (ITU-T E.425 alapján)
NER_pc: NER percentage of the All call
All: total number of calls in the actual row

Accessibility of foreign subscribers (`200712201421_0.SzC`)

Date/Time: end time of statistics period
OpPrefix_name: prefix of the operator where foreign subscribers are from (derived from Sga7N_ISUP_CDRGen.ini/[RoamStat]/sOpPrefFile)
NI/DPC: Network Indicator and Destionation Point code parameters from IAM messages
RelCau[0..9]: Counts of calls with predefined Release Cause codes (Sga7N_ISUP_CDRGen.ini/[RoamStat]/sRelCause0..9)
Other: number of calls that do not belong to any RelCause group
ASR (Answer Seizure Ratio): number of CDR's having ANM or CON independently from ReleaseCause (based on ITU-T E.425)
ASR_pc: ASR percentage of the All call
NER (Network Effectiveness Ratio): number of CDR's having an ANM or CON or a RelCause from the predefined set. (ITU-T E.425 alapján)
NER_pc: NER percentage of the All call
All: total number of calls with the given NI/DPC belonging to the given operator

OpPref File Record Format

Nature of Address (NoA)
Minus sign ("-") separator
Prefix code
Blank or TAB separator
Name of the operator related to the prefix

Remarks:

Nature of Address is optional with its separator. Default value is NoA=4

Name of the operator that can be at most 20 character long

Samples:

49163 GERMANY_E-PLUS
8-1900 PGSM_ported

49163 and 4-49163 are the same
8-1900 means operator with prefix 1900 and Nature of Address 8

Configuration (`Sga7N_ISUP_CDRGen.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 calls
	dwActiveCallDurationTimeOutSec	3600	Time limit for long calls in seconds. If a call reaches this limit its CDR will be closed.
	sDataPath	d:\CDR	Path for CDRs
	dwDataFileCutSize	1000000	size of output files can be limited (given in bytes)
	sLogFilesPath	d:\LogFiles	Path for the LOG files
	sKPIStatFilesPath	c:\StatFilesKPI	Path for KPI statistics files. (Writing ASR and NER KPI's at every midnight.)
	sKPIASRBackupFile	c:\Sga7NCDR_KPIASR.dat	Filename for backup of KPI ASR data which is saved and reloaded at shut-down and start-up.
	sKPINERBackupFile	c:\Sga7NCDR_KPINER.dat	Filename for backup of KPI NER data which is saved and reloaded at shut-down and start-up.
	sMCC	36	Mobile Country Code for Number_B expansion for ASR/NER calculation, based on NoA (default to "36")
	sMNC	30	Mobile Network Code for Number_B expansion for ASR/NER calculation, based on NoA (default to "30")
	dwDuplicatedRxTimeDiffMaxMS	250	Duplicated MSUs arriving within this time are dropped.
[RoamStat]
	sOpPrefFile	c:\Sga-7N\OpPref2.cfg	name of the operator prefix file
	dwFlushStatPeriod	900	Period of roaming statistics file creation
	dwFlushStatDelay	400	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
	sStatPath	c:\StatFiles	Folder for roaming statistics files
	sRelCause0	ACM CON 16 31	Ten ReleaseCause groups can be defined (sRelCause0..9). Particular RelCause values can be parts of more than one group. Maximum count of total RelCause values is 500.
	sRelCause1	ACM CON 0 1 2 3 4 5 6 7 8 9 17 18 19 20 21 22 26 27 28 29 30 34 38 39 40 41 42 43 44 46 47 49 50 53 55 57 58 62 63 65 66 69 70 79 81 82 83 84 85 86 87 88 90 91 95 96 97 98 99 100 101 102 103 110 111 127	Another example for a RelCause group
[Required DPC=OPC pairs]			The module lists DPC-OPC pairs from this section that had no CDR recently at every midnight and at module shut-down
	32	160
	160	32
[KPI ASR]
	3630	7.5.1.2.003630	Calls with operator prefix "3630" will be shown by "7.5.1.2.003630" KPI indicator
	49170	7.5.1.4.0049170	Calls with operator prefix "49170" will be shown by "7.5.1.2.0049170" KPI indicator
[KPI NER]
	3630	7.5.1.4.003630	Calls with operator prefix "3630" will be shown by "7.5.1.2.003630" KPI indicator
	49170	7.5.1.4.0049170	Calls with operator prefix "49170" will be shown by "7.5.1.2.0049170" KPI indicator
[Trap Thresholds]
	dw15minNoACMcount	50	Alarm threshold for NoACM counter increasing.
	dw15minNoIAMcount	50	Alarm threshold for NoIAM counter increasing.
	dw15minTimeOutCount	50	Alarm threshold for TimeOut counter increasing.
	byMaxCDRElemCountPercent	50	Alarm threshold for fulness of active call memory. Given in percent.
	by15minMSUdecreasePercent	10	Alarm threshold for MSU decreasing. Given in percent.
	by15minCDRdecreasePercent	20	Alarm threshold for CDR decreasing. Given in percent.

Version history

v1.36

(n) Duplicated ISUP messages within a given time interval are dropped.
(n) New INI entry [Advanced]/dwDuplicatedRxTimeDiffMaxMS. Default value is 250[ms].

v1.35

(n) General and counter based alarm generating is implemented.
(n) ERROR alarm is generated when the gap between the processed timestamp from the local time is more than 10 minutes.
(n) CRITICAL alarm is generated when the incrementation of NoIAM or NoACM or TimeOut error counters in a 15-minute period is bigger than the value given in the corresponding INI entries.
(n) New INI entries:
- dw15minNoACMcount
- dw15minNoIAMcount
- dw15minTimeOutCount
(n) ERROR alarm is generated when the number of active calls is bigger then the given percent of the maximum value.
(n) New INI entry [Trap Thresholds]/byMaxCDRElemCountPercent
(n) CRITICAL alarm is generated when output CDR files could not be written.
(n) CRITICAL alarm is generated when number of MSUs or CDRs decreased in the previuos period.
(n) New INI entries:
- by15minMSUdecreasePercent
- by15minCDRdecreasePercent
(n) Alarm generation can be suspended for 1 hour.
(n) New menu item: [Options]/Suspend traps for 1 hour.

v1.34

(n) Incorporates information into the CDRs about the (PC-based) direction of the ACM, ANM, REL, and RLC MSU's, compared to that of the IAM MSU.
(n) Clear key (NumPad-5) clears highlight (selection) in log window.

v1.33

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

v1.32

(n) Lists DPC-OPC pairs from the required set that had no CDR recently at every midnight and at module shut-down.
(n) Required DPC-OPC pairs' list is loaded on module start-up; can be reloaded any time.
(n) Menu "Required PC's" with its new menu items "Reload INI/[Required DPC=OPC pairs] list" and "Flush and reset list".
(n) INI/[Required DPC=OPC pairs] section with the required DPC=OPC pairs.

v1.31

(f) REL CauseValue was not filled if REL had not been seen before the RLC.
(c) SLID_REL and REL CauseValue are kept in case of CDRGen TimeOut, CIC-Reuse, and Shutdown.
(c) SLID_RLC is filled in case of CIC-Reuse.

v1.30

(c) Module is renamed from "Sga7NCDR" to "Sga7N_ISUP_CDRGen".
(c) Log file's name is also changed from "Sga7NCDR_YYYYMMDD.log" to "Sga7N_ISUP_CDRGen_YYYYMMDD.log".
(n) Handles new IAM messages as well as new parameters like RedGN, TraNS, NoA's, TraMR, UseSI, and TraNSToNI.
(c) Active records' (that are not not-yet-flushed) file name is changed from "Sga-7004.SAV" to "Sga-7014.SAW"; note that the last actual cannot be used when upgrading.
(c) Expected input files are "Sga-7014.nnn" instead of former "Sga-7004.nnn".
(c) Output files' name is changed from "Sga-7006.nnn" to "Sga-7016.nnn" (because of incompatible contents).
(c) NoA_B is taken into account in the evaluation of SzB and SzC (ASR/NER) statistics; Number_B with NoA_B=1, 3 or 4 can only be a roaming number (for SzB); NoA_B is also checked against operator prefix definitions (for SzC).
(n) OpPref file may contain NoA definition, e.g., "8-1900 PGSM_ported"; default remains NoA=4.
(c) "Omit yellow (warning) lines from log file" menu item is removed.
(c) Log on start-up includes the section name for the particular INI settings.
(c) Detailed and debug log lines look nicer (due to tabbing).
(n) Options / "Flush & reset counters" menu item for the status-line counters.
(n) INI/[Advanced]/sMCC and /sMNC for Number_B expansion for ASR/NER calculation, based on NoA (default to "36" and "30", respectively).
(c) Status-line error counters are named.
(c) Input file open/close actions are logged only in Debug log level.

v1.24b

(c) CDR's with "fake IAM" have their RelCause OR'ed with 0x00800000 instead of 0x20000000.

v1.24

(c) CDR's with "fake IAM" have their RelCause OR'ed with 0x20000000 instead of 0x80000000.

v1.23

(c) KPI ASR and NER statistics are extended from "top10" operators (which actually used to mean "top100") upto "top300".

v1.22

(n) Size of output data files can globally be limited.
(n) INI/[Advanced]/dwDataFileCutSize (given in bytes, defaults to 1000000, logged at start-up).
(c) Refresh interval can no longer be set; the default '1000 ms' setting will always be applied.
(c) INI/[Advanced]/wRefreshInterval is obsolete.

v1.21

(c) ASR and NER KPI's are collected on an Operator Prefix basis (used to be summed for all ranges of the given operator).
(c) Entries in INI/[KPI ASR] and [KPI NER] sections require Operator Prefix on the left side (and not Operator Name as it used to be).

v1.20

(n) Writing ASR and NER KPI's at every midnight.
(n) Menu / KPI's /
- "Reload INI/[KPI xxx] lists"
- "Zero KPI statistics"
- "Flush KPI statistics"
- "Flush and zero KPI statistics"
(n) INI/[KPI ASR] and [KPI NER] sections for "top10" operators.
(n) INI/[Advanced]/sKPIASRBackupFile, defaults to "c:\Sga7NCDR_KPIASR.dat".
(n) INI/[Advanced]/sKPINERBackupFile, defaults to "c:\Sga7NCDR_KPINER.dat".
(n) INI/[Advanced]/sKPIStatFilesPath, defaults to "c:\KPIStatFiles".
(n) KPI data is saved and reloaded at shut-down and start-up.

v1.19

(c) Handles double the amount of operator prefixes.

v1.16

(c) Percent signs got removed from PMS output files (both from headers and from results).

v1.15

(n) Handles ACM MSU's.
(n) Handles RLC MSU's (again).
(n) Handles difference between CON and ANM MSU's.
(c) Unknown MSU's are simply skipped (used to advance to next input file in previous versions); warning is issued.
(c) CDR's are terminated for the first RLC (used to do so for the first REL) MSU.
(c) "Missing IAM for this XXX" reports are assembled into a single CDR (referred to as "one with fake IAM"), having their RelCause OR'ed with 0x80000000.
(c) "Missing IAM for this XXX" reports advanced from Warning (yellow) to Error (red) log level.
(c) "Missing IAM for this RLC!" warning is logged in case of Debug log level only (assuming that an RLC in the reverse direction has already terminated the call).
(n) SL_ID[3] field contains link name of ACM (logged in Debug log level).
(n) SL_ID[4] field contains link name of RLC (logged in Debug log level).
(c) Number of release cause groups is increased from 4+1 to 10+4 (where these latter are 'Other', 'ASR', 'NER', and 'All', respectively).
(n) ASR measurement is implemented: number of CDR's having an ANM or CON (independently from RelCause).
(n) NER measurement is implemented: number of CDR's having an ANM or CON or a RelCause from the (max. 100) predefined set.
(n) ASR and NER results are dumped both into SzB and SzC statistics; numerical results are given as an absolute count and as the percent of the total as well; result file captions are changed accordingly.
(c) Particular RelCause values can be parts of more than one group.
(c) Maximum count of total RelCause values is increased from 100 to 500.
(n) "ACM", "noACM", "CON", "noCON" directives can be declared for any of the RelCause groups.
(n) INI/[RoamStat]/sRelCause4, sRelCause5, ... sRelCause9
(n) INI/[RoamStat]/sRelCauseNER
(c) Upper bits (including the CON bit!) of the RelCause values are masked when comparing with entries in the INI/[RoamStat]/sRelCause* fields.
(n) Shift-ESC combination minimizes application window.

v1.13

(f) Eliminates a rare but erroneous situation that might have resulted in "Serious error: File space for polling data is full!" error message.

ISUP Call Data Record generator module("Sga7N_ISUP_CDRGen")