Professional Documents
Culture Documents
USER MANUAL
April 2013
Any full or partial representation or reproduction of this document, without the prior consent of Astellia is unauthorised.
WARNING
The information contained in this manual is subject to change without prior notice and in no case
constitutes a contractual undertaking on the part of ASTELLIA.
ASTELLIA cannot be held responsible for slight variations between the manual and the product described
therein, nor for any accidental damages following use of said manual and product.
Every possible effort has been made to guarantee that this manual and the information contained therein
are as accurate as possible. However, in the case of the subsistence of any error(s), please do not hesitate
to contact us. We also invite you to get in touch with us to make any comments you may have as to
possible improvements.
For any maintenance operation, please contact:
ASTELLIA
: +33 (0)2 99 04 80 66
Fax: +33 (0)2 99 04 80 61
E-mail: support@astellia.com
Registered trademarks: The products and marks mentioned have been registered by their
respective owners.
Astellia Confidential
2 / 87
CONTENT
1.
2.
3.
4.
5.
6.
Astellia Confidential
3 / 87
7.
8.
Revision
A
Date
12/03/13
Writer
MCE
Revisions
Object
Creation
Reference documents
- Installation manual
Astellia Confidential
4 / 87
1.
GENERAL INTRODUCTION
Network
Elements
Troubleshoot AA
Business
Customers
SLM
Roamers
VIP
All Mobiles
Services
Radio
Capture on A
interface
Astellia Confidential
5 / 87
6 / 87
Astellia Confidential
7 / 87
2.
PRODUCT COMPONENTS
Cigale GSM decodes record files in order to extract the various messages and associated data (called
elements). These messages are decoded per protocol layer (MTP 2 and 3 levels, SCCP, BSSAP, Layer3, RP,
TP, SMS, and SS levels).
The various messages and associated elements make it possible to extract information such as:
- the SCCP connections ;
- the cells, the location areas detected ;
- the types of the current connections (terminating calls, originating calls, handovers,
location updates, short messages, etc.).
View
KPI
AA
Browsing
Troubleshooting
Viewers
CDR
KPI
Call Trace
Cigale Engine
Capture File
Ocean Probe
Network Interfaces
Cigale Layer Model (Figure 2)
Astellia Confidential
8 / 87
3.
3.1.
- Troubleshooting Database
- KPI results
- Cigale Engine
- EDX Storage
Processing
(Optional)
Ocean
- Capture
probe(s)
Unit(s)
Added Value:
o Isolate functions: Capture, Processing, Database Server
o Improve performances, allow capturing and processing in parallel
o Service is not interrupted during maintenance
Typical Server/Processing Unit: Xeon bi-pro 3GHz
Server and processing can be split in 2 different Units (server and Process) for up to
20GB/day
Astellia Confidential
9 / 87
4.
4.1.
QUICK START
STARTUP
You can run Cigale GSM by clicking on the associated icon in the program group created at installation or
indeed through the link created on your desktop:
Cigale GSM
The Cigale GSM application can be started by clicking on the START/PROGRAMS/Astellia/Cigale GSM menu
or by using ASM.
4.2.
SOFTWARE PROTECTION
4.2.1. PRESENTATION
When you have installed Cigale GSM with the help of the CD ROM, you will have to fill in an execution
authorization code specific to the destination computer.
This means that it will not be possible to install the application on different workstations without the
associated codes. However, the same installation CD ROM may be used on different workstations. You will
then simply have to ask for the codes relative to each workstation.
This window displays a Site Code which is specific to the computer used. You will have to contact your
administrator and give him this Site Code so that he can give you a key authorizing execution and
instructions on how to install it.
Astellia Confidential
10 / 87
Astellia Confidential
11 / 87
5.
5.1.
INTERFACE
Process Unit
OCEAN
Server Unit
DB View
EDX (temp)
SDR DB
VIP Care DB
ASM
ASM
System
Controller
+
System
Process Flow
System
Controller
+
System
Process Flow
EDX
DB Activity Analysis
Trace Files
Roaming Files
SLM Files
EDX (backup)
EDX Server
Astellia Confidential
12 / 87
OCEAN: Probe dedicated for capture and EDX file storage. The high captured data rate needs an exclusive
use of the CPU. On-disk data storage constraints need also that no other process disturbs disk access.
Process Unit (PU): Dedicated machine for Cigales processing. Processing time is more and more critical and
need the whole CPU resource.
Server Unit (SU): Dedicated machine for results storage. A MySQL server is running. Many other results
(such as reassembly EDX, stats view ) are also stored.
For some light configurations, PU and SU can be a single machine.
5.2.
CIGALE.CONF
Output_xl3.ini
Record files :
REC (K1103), RF5 (K1205),
EDX (OCEAN),PCAP,
Cells description
Topology.txt
CIGALE
Engine
Cigale GSM Configuration File (Figure 4)
Astellia Confidential
13 / 87
ToolBar :
Open / Save / Close
Parameters of the
selected section are
displayed here
Astellia Confidential
14 / 87
5.2.3.1.
Group
Component/
Component/
Component parameters
Name
Component name
Component version
5.2.3.2.
Network parameters
Group
Network/
Network/ Topology/
Name
Topology
Topology directory
Network/ Topology/
Network/ Topology/
Network/ Topology/
Network/
Description
Description
Topology settings
This field indicates the location of the file containing
topology informations
This field indicates the location of the file containing
networks informations (networks.txt)
Enable or disable the use of MSS Pools.
List of processing nodes (defined by Point Code)
Operator
Astellia Confidential
15 / 87
Network/ Operator/
Country code
(MCC)
Network/
Network/ Paging/
Paging
Paging Nb Repeat
CS
Paging Repeat
Time CS
Hand-Over
Limited duration for
ping pong handover
(s)
Network/ Paging/
Network/
Network/ Hand-Over/
Network/
Network/ TAC-IMEI/
TAC-IMEI
TAC-IMEI file
5.2.3.3.
Group
Processing/
Processing/
Decoding/
Processing/
Decoding/
Processing/
Decoding/
Processing/
Processing/
Megaco/
Processing/
Megaco/
Processing/
Megaco/
Processing/
Megaco/
Processing/
Megaco/
Processing/
Megaco/
Processing/
Megaco/
Purge MEGACO/
Processing settings
Name
Decoding
Standard
Description
Decoding
ETSI , ANSI are availables. Default value is ETSI.
MTP2 extended
Full IP BSC
Megaco
Megaco CDR
generation
Megaco CDR
Integration
Megaco Statistics
MGW mapping file
Megaco threshold
statistics time
Purge MEGACO
Purge time out
MEGACO
(Seconds)
Astellia Confidential
16 / 87
Processing/
Megaco/
Purge MEGACO/
Processing/
Processing/
Iden Decoding/
Processing/
Processing/
GS Decoding/
Processing/
GS Decoding/
Purge number of
set MEGACO
Iden Decoding
FAC-EC-IMEI file
GS Decoding
Paging Nb
Repeat GS
Paging Repeat
Time GS
5.2.3.4.
Advanced settings
Group
Advanced settings/
Name
Treshold trace multi
capture
Advanced settings/
Detailled display of
handovers
Advanced settings/
Advanced settings/
Advanced
settings/Purge
Advanced
settings/Purge
Advanced
settings/Purge
Advanced
settings/Purge
Group
Inputs/
Inputs/
Settings/
Inputs/Settings/
Inputs/Settings/
Inputs/Settings/
Process max
memory threshold
(MB)
Process Minimum
Free memory after
purge (MB)
Description
Detection of capture redundancy by A interface based on the
openening of connexions by probe analyzer ports. Default
value is 80. Value in [0; 100] to enable the process.
Redondancy is traced if the threshold of failed connections is
higher or equal to defined value. Value -1 to disable the
process
If this field equals true, the statistics relative to the handovers
(XLH and XLF) are generated in detail (including, in
particular, the breakdown of intra-cell handovers according to
the causes, and the taking into account of the Directed Retry
cause for all types of handover). By default this field equals
false
detail or not User Data filed in sms output file and database
Purge settings
[Timer value for SCCP connection purge] : By default this
field equals 2500 ms
Limit duration of a connection if a purge is started. All
connections which are opened since more than this timer are
purged. By default this field equals 7200 s.
If this memory treshold is reached, purge is started. By
default this field equals 1500 MB.
Minimun free memory to get during purge. If this value is not
reached, engine is stopped. By default this field equals 100
MB.
5.2.3.5.
Inputs settings
Name
Settings
Input
Description
Input setting
Capture
Comment
Analyzer
Start time
Comment
Analyzer to use for treat
Start of the time range
Astellia Confidential
17 / 87
Inputs/Settings/
Inputs/Settings/
Inputs/
Inputs/
Process Mode/
Inputs/
Process Mode/
Online mode/
Inputs/
Process Mode/
Online mode/
Inputs/
Process Mode/
Online mode/
Inputs/
Process Mode/
Online mode/
Inputs/
Process Mode/
Online mode/
Inputs/
Process Mode/
Online mode/
End time
Real time
streaming
Process Mode
Online mode
Minimum remaining
time polling
(seconds)
Online flag
5.2.3.6.
Group
Outputs/
Outputs/ Settings/
Outputs/ Settings/
Name
Settings
Output radical
Output mode
Outputs/
Outputs/
Activity Analysis/
Outputs/ Activity
Analysis/
Activity Analysis
MySQL
parameters
MySQL
parameters/
Hostname
MySQL
parameters/
Outputs/
Activity Analysis/
Outputs settings
Description
Output
Used name for the output (databases and statistics files)
Used mode for the output (databases and statistics files) 'Input
file': outputs will be named with the (first) source name (EDX
file) 'OutputRadical': outputs will be named with the output
radical defined above 'date_OutputRadical': outputs will be
named with the current date and the output radical defined
above, format is 'YYYY_MM_DD_{radical}'
'date_hour_OutputRadical': outputs will be named with the
current date, the current time and the output radical defined
above, format is 'YYYY_MM_DD_HH_MM_{radical}' 'T&A
naming': outputs will be named with the current date and time
(small length) and the output radical defined above, format is
'YYMMDD_HHMM_{radical}'
Activity Analysis Settings
MySQL server name, port, login and password. You can test the
connection with the test button.
Define hostname
Define port
Astellia Confidential
18 / 87
Outputs/
Activity Analysis/
Outputs/
Activity Analysis/
Outputs/
Activity Analysis/
Outputs/
Activity Analysis/
Outputs/
Activity Analysis/
Outputs/
Activity Analysis/
Outputs/ Activity
Analysis/
Outputs/ Activity
Analysis/
Outputs/
Activity Analysis/
Outputs/
Activity Analysis/
Outputs/
Activity Analysis/
Outputs/
Activity Analysis/
Outputs/
Activity Analysis/
Outputs/
Activity Analysis/
Outputs/
Activity Analysis/
Outputs/
Activity Analysis/
Outputs/
Activity Analysis/
Outputs/
Activity Analysis/
Outputs/
Activity Analysis/
Outputs/
Activity Analysis/
Outputs/
Port
MySQL
parameters/
Login
MySQL
parameters/
Password
Central database
parameters
Central database
parameters/
Hostname
Central database
parameters/
Port
Central database
parameters/
Login
Central database
parameters/
Password
Server name
used by viewers
Define login
Define password
Define port
Define login
Define password
Trace detailed
activity
All paging
procedures
MAP Cancel
Location (LOR)
SMS
SQL post
processing?
Timers
Location Update
on success
Real time
database access
Imsi index
Imei index
19 / 87
Activity Analysis/
Outputs/
Activity Analysis/
Outputs/
Activity Analysis/
Outputs/
Activity Analysis/
Outputs/
Outputs/
Detailed decoding/
Outputs/
Detailed decoding/
Outputs/
Detailed decoding/
Outputs/
Outputs/
Frames Archiving /
Outputs/
Outputs/
Statistics files/
Detailed decoding
Hostname
Databases.
Used to accelerate times of requests in Activity Analysis
Databases.
Used to accelerate times of requests in Activity Analysis
Databases.
Used to accelerate times of requests in Activity Analysis
Databases.
Detailed decoding
Define hostname
Port
Define port
Frame server
alias
Frames Archiving
Archive Path
Statistics files
CDR (XL3)?
Statistics files
If checked, the XL3 statistics file will be generated when a record
file is processed. It should be noted that generating an XL3 file is
quite time consuming.
This field indicates the directory in which the CDR statistics files
must be generated.
If this field equals true, the mAP messages Cancel Location is
decoded and displayed in the XL3 file. This option is software
proteceted. Notice that you may tick XL3 option to use Loss of
roamer option
Value in minutes of generation of the periodical XL3 files
Cell index
LAC index
Start Event index
Outputs/
Statistics files/
Outputs/
Statistics files/
CDR Statistics
Output directory
MAP Connections
(Cancel Location)
Outputs/
Statistics files/
Outputs/
Statistics files/
Outputs/
Statistics files/
Outputs/
Statistics files/
Outputs/
Statistics files/
Outputs/
Statistics files/
Outputs/
Statistics files/
Outputs/
Statistics files/
Outputs/
Statistics files/
Outputs/
Statistics files/
Outputs/
Statistics files/
Outputs/
Periodical CDR
Periodical CDR
Output directory
Flag Extension
List
Output directory
Frames Archiving
The directory where the archive files will be created
This field indicates the directory in which the CDR statistics files
must be generated.
Flag files to create
Resources (XLT)
This field indicates the directory in which the statistics files must
be generated.
If checked, the XL2 statistics file will be generated at the end of
processing of a record file.
If checked, the different procedure timers defined will be
generated during process.
If checked, the traffic statistics will be generated.
Efficace (EFF)
Handovers (XLH,
XLF)
Handovers links
(LHO)
Inter System
Statistics (XLE)
Location updates
State-machine
transitions (XL2)
Timers (TIM)
Astellia Confidential
20 / 87
Statistics files/
Outputs/
Statistics files/
Outputs/
Statistics files/
Outputs/
Statistics files/
Outputs/
Statistics files/
Outputs/
Statistics files/
Outputs/
Outputs/ View/
Outputs/ View/
Outputs/
Outputs/ TA/
Outputs/ TA/
Outputs/ TA/
Outputs/ TA/
Outputs/
Outputs/ TT/
Outputs/ TT/
Outputs/ TT/
Outputs/ TT/
Outputs/ TT/
Outputs/ TT/
Outputs/ TT/
Outputs/ TT/
Outputs/ TT/
Outputs/ TT/ Type
Filter/
(XLU)
Short messages
(SMS)
SMS Center
efficiency (XSC)
Supplementary
services (SS)
Miscellaneous
statistics (XLV)
SDRs
View and
Statistics in AA
Output directory
Automatic daily
subdirectory
TA
TA Periodicity
Output directory
Automatic daily
subdirectory
TA periodical zip
files destination
path
TT
TT server
Protocol
Hostname
Port
Login
Password
TT V3
TT SDRs record
path
Type Filter
TT SDR Type
filter file
Outputs/ TT/
TT Disallow
Duplicates
Outputs/ TT/
TT Message Time
Out
TT Message
Retry
TT Session Test
Time Out
Outputs/ TT/
Outputs/ TT/
generated.
If checked, the Short messages will be generated.
If checked, the SMS Center efficiency will be generated.
If checked, the Supplementary services will be generated.
If checked, some ATM statistics are produced in a XLV file.
If checked, some SDRs are produced in a txt file. SDR Sender
output will be desactivated.
View and Statistics in AA
This field indicates the directory in which the Cigale View files
must be generated.
Use daily statistics subdirectory.
Trending And Aggregation
Value in minutes of generation of the TA files.
This field indicates the directory in which the TA files must be
generated.
Use daily statistics subdirectory.
If checked, 'Output directory' is used to generate temporary files.
Only for files with View format (.txt).
Trouble Ticketing SDRs
Trouble Ticketing SDRs
Define protocol
Define hostname
Define port
Define login
Define password
Defined if the type of server TT to communicate with is a TT v3
server.
This field indicates the location of the path containing the SDRs
which couldn't have been send to TT server
If check, TT SDRs are filtered
This field indicates the name of the file containing the type of
SDR which are filtered by Trouble Ticketing. This file is located in
Cigale directory.
A SDR is a time-based duplicate if the xEndDate field of SDR is
lower than the xEndDate field of any SDR that was already
sent.0, if time-based duplicates are allowed; 1, otherwise.
Life time, in milliseconds, of a message that is sent to the TT
server. This number must be lower or equal to 4 294 967 295.
Number of retry after what the sent is considered as failed.
Life time, in milliseconds, of a session test message that is sent
to the TT server. This number must lower or equal to 4 294 967
Astellia Confidential
21 / 87
Outputs/ TT/
TT Session Start
Time Out
Outputs/ TT/
TT SDR Send
Time Out
Outputs/ TT/
TT Session Stop
Time Out
Outputs/ TT/
TT SDR Send
Packet Count
TT SDR Send
Packet Time Out
Period of sdr file
creation
Number of
attempts to
connect
Delay between
two connection
attempts
TT SDR Max
buffer size
VIP Care
VIP Care server
Protocol
Hostname
Port
Login
Password
VIP Care Off Line
VIP Care SDRs
record path
Outputs/ TT/
Outputs/ TT/
Outputs/ TT/
Outputs/ TT/
Outputs/ TT/
Outputs/
Outputs/ VIP Care/
Outputs/ VIP Care/
Outputs/ VIP Care/
Outputs/ VIP Care/
Outputs/ VIP Care/
Outputs/ VIP Care/
Outputs/ VIP Care/
Outputs/ VIP Care/
VIP Care
Message Time
Out
VIP Care
Message Retry
VIP Care Session
Test Time Out
295.
Time, in milliseconds, between the first session open request
message and the moment when the request is considered to be
failed. This number must be lower or equal to 4 294 967 295.
Time, in milliseconds, between the first send of a SDR and the
moment when the send of the SDR is considered to be failed.
This number must be lower or equal to 4 294 967 295.
Time, in milliseconds, between the first session close request
message and the moment when the request is considered to be
failed. This number must be lower or equal to 4 294 967 295.
Maximum number of SDR per packet. When reached, packet is
sent.
When this timeout (in ms) elapsed, packet is sent (whatever the
number of SDR)
Periodicity of SDR file generation when connection white TT
Server is lost.
Number of attempts to connect to TT server
Astellia Confidential
22 / 87
Number of
attempts to
connect
Delay between
two connections
attempts
SLM SDR Max
buffer size
VIP Care options
IMSI Filtering
Activation
VIP Care Upload
Path
967 295.
Time, in milliseconds, between the first session open request
message and the moment when the request is considered to be
failed. This number must be lower or equal to 4 294 967 295.
Time, in milliseconds, between the first send of a SDR and the
moment when the send of the SDR is considered to be failed.
This number must be lower or equal to 4 294 967 295.
Time, in milliseconds, between the first session close request
message and the moment when the request is considered to be
failed. This number must be lower or equal to 4 294 967 295.
Maximum number of SDR per packet. When reached, packet is
sent.
When this timeout (in ms) elapsed, packet is sent (whatever the
number of SDR)
Period covered by each SDR file in minutes. SDR files are
generated in offline mode or when the connection to VIP Care
Server is bad or lost.
Number of attempts to connect to VIP Care server
This field indicates the name of the file containing the IMSI
followed by VIP Care
ByPass
If check, SDR of types defined in the ByPass file are send even if
their IMSI are not followed by VIP Care
This field indicates the name of the file containing the type of
SDR which are ByPass by VIP Care. This file is located in Cigale
directory.
The Reprocessing mode is used to reprocess specified data that
should have been processed from another engine (called here
original engine). This mode can be used with an online or an
offline connexion
Must indicate the installation path of the original engine of
reprocessed data. For example, C:\ASTELLIA\Cigale UMTS
Iu_1\
Advanced settings
Reprocessing
Original engine
path
Outputs/
Advanced
settings
Astellia Confidential
23 / 87
Outputs/ Advanced
settings/
Performance
indicators
periodicity (min)
5.2.3.7.
Debug options
Options under this node are used for debugging purpose only and should be left untouched.
5.2.4. OUTPUT_XL3.INI FILE
This file configures the CDRs output file. Its composed by two sections:
- [General]
Prefix output filename: defines a prefix for the output file name;
FILEHEADER:
LINEHEADER:
SEPARATOR: specifies the separator between the columns, the possibilities are ; or TAB
- [KPIs]
KEY = value: defines the columns, KEY must be unchanged; value is the column name and if value is null
the column is not generated in the file
5.2.5. TOPOLOGY
This file is used when processing record files to name the detected 2G cells (GSM), designate their BSC and
MSC Number and LAC and fill in their BSIC and BCCH. These files contain also names of the detected 3G
cells (UMTS) and UMA cells.
Astellia Confidential
24 / 87
5.2.5.1.
To select a cell Topology file (also known as cell data base), use the Options: Cell data base menu or the
button. A selection box allows you to choose the file:
Type
Mandatory
Mandatory
Mandatory
Mandatory
Mandatory 2G/UMA
Mandatory 2G/UMA
Optional 2G
Mandatory 3G/UMA
Mandatory 2G/UMA
Description
name of the BSC that the 2G cell is attached to
2G cell's name (limited to 255 caracters)
identification number (CI ; 0 - 65535)
location area code (0 65535)
cell's BSIC (0 63) ; 0 means unknown
cell's BCCH (0 1023) ; 0 means unknown
type of cell (empty (2G) / UMA / 3G)
Example
MyBSC
MyCell
28461
12654
15
36
UMA
3957
Astellia Confidential
25 / 87
rnc_id
Mandatory 3G
code of the RNC that the 3G cell is attached to
The CI,, LAC, BSIC, BCCH and RNC Id values are indicated as decimals.
Example of cell data base file (contains 2G and 3G cell description):
bsc_rnc_name bsc_pc rnc_id cell_name
cell_id
BSC 1
125
MyCell1
3512
BSC 2
126
MyCell2
45818
BSC 2
126
MyCell3
45818
BSC_UMA 2
165
MyCellUMA1
7580
BSC_UMA 2
165
MyCellUMA2
7580
BSC_UMA 2
165
MyCellUMA3
7580
BSC 2
126
MyCell4
40336
BSC 2
126
MyCell5
40336
BSC 1
125
MyCell6
3512
BSC_UMA 1
164
MyCellUMA4
3577
BSC_UMA 1
164
MyCellUMA5
3577
BSC 1
125
MyCell7
23577
BSC 1
125
MyCell8
23577
BSC_UMA 1
164
MyCellUMA6
5658
RNC_TEST1
568
SAI_TEST1
15652
RNC_TEST1
568
SAI_ TEST2
15652
5.2.5.2.
lac
3967
3958
3958
3958
3958
3958
3958
3958
3967
3967
3967
3967
3967
3971
4545
4545
bsic
0
0
0
0
0
0
0
0
0
0
0
0
0
0
bcch
0
0
0
0
0
0
0
0
0
0
0
0
0
0
568
cell_type
UMA
UMA
UMA
UMA
UMA
UMA
3G
3G
Additional parameters
CigaleGSM can also group cells into clusters via the annexe labels. Up to 3 different groups can be
configured, and these groups will appear in CigaleView and Statistics in AA.
Example of cell data base file:
bsc_rnc_na
me
bsc_pc
BSC 1
BSC 2
rnc_id
cell_name cell_id
lac
bsic
bcch
cell_type
125
MyCell1
3512
3967
urban
900
126
MyCell2
45818
3958
rural
900
BSC 2
126
MyCell3
45818
3958
urban
900
BSC 2
126
MyCell4
40336
3958
Airport
urban
1800
BSC 2
126
MyCell5
40336
3958
Airport
rural
1800
BSC 1
125
MyCell6
3512
3967
rural
1800
BSC 1
125
MyCell7
23577
3967
rural
1800
BSC 1
125
MyCell8
23577
3967
urban
1800
Airport
RNC_TEST1
568
SAI_TEST1 15652
4545
3G
RNC_TEST1
568
SAI_
TEST2
4545
3G
15652
Astellia Confidential
26 / 87
Note that Annexe_1 and Annexe_2 contain a string of characters whereas Annexe_3 can only contain a
numeric value.
5.2.5.3.
During processing, the cell data base may be completed or modified. You will then be informed by
messages in the technical log.
It should be noted that these updates will only be effective for the current processing operation.
When a cell is detected that has not been filled in (identified by its Cell Identity code), this cell will be added
to the data base and named by concatenating the character string "Cell_" with the corresponding CI
number :
Message informing you that there is a new cell
If this cell is assigned to a connection, the BSC with which the connection is associated is assigned to the
cell :
Message informing you that a BSC has been assigned to a cell
Likewise, if this cell was already linked to a BSC, it is transferred to the new BSC.
Cell transfer
When a handover link is established, if the cell concerned was the only candidate cell, it is validated (cell
certification). Furthermore, its BSIC-BCCH pair is checked against the pair resulting from the Layer 3
protocol Handover Command message. If these pairs are different, the new BSIC-BCCH pair is assigned to
the cell :
Message informing that the BSIC-BCCH pair has been modified
Likewise, when several cells were candidates, but only the cell concerned by the handover is not certified, it
is certified and, if necessary, its BSIC-BCCH pair is modified.
The names of the cells that have been certified are then preceded by the "*" character in the statistics files.
Cell certifications and BSIC-BCCH pair modifications may optionally be reported in the LHO file.
5.2.6. STATE-MACHINE CONFIGURATION FILE
5.2.6.1.
Presentation
The statistics obtained from processing a record file serve two main purposes:
to count the various data items or situations detected during that processing ;
to trace the changes in the various connection contexts.
Besides the SCCP level messages relative to connections, the changes to the connection contexts concern
the higher level messages such as BSSAP, Layer 3, RP or TP.
Astellia Confidential
27 / 87
(1)
(2)
(3)
(7)
(4)
(5)
(6)
(7)
BEGIN
BEGIN
BEGIN
CMSRQ _NC
CMSRQ _EC
PAGRP
OC_CMS_REQ AUTRQ
OC_CMS_REQ CMCMD
OC_CMS_REQ CMSA
OC_CMS_REQ
*
(1), (2)
BEGIN
OC_CMS_REQ
(4)
OC_AUT_REQ1
(3)
TC_PAGRP
(6)
(5)
OC_CIM_CMP
OC_CIM_CMD
The state-machine is designed to trace these changes by distinguishing between the different types of
connections (originating calls, terminating calls, location updates, handovers, etc.).
To achieve this, the notions of states and of transitions between states have been defined. A transition is
characterized by two states (origin and destination), a message (also called event) and a cause.
5.2.6.2.
Automat files
The state machine is configured by three external binary files (AUTOMAT.BDT, CAUSES.BDT, EVENTS.BDT).
They must be contained in the CIGALE execution directory when you start up the application.
The states and transitions are contained in the AUTOMAT.BDT external file. The events and causes are
identified by names in the AUTOMAT.BDT file. The EVENTS.BDT and CAUSES.BDT files are then used to
establish the correspondence between those names and the coded events and causes. In fact, an event is
characterized by a membership protocol and a code, and a cause is identified by its code.
The AUTOMAT.BDT file also contains the declaration of the timers intended for the EFFICACE file. When it
has read the state-machine, CIGALE reads the TIMES.ADT file. This file is used to delimit state-machine
transitions in order to generate statistics on the durations between the marked transitions.
Remark: These files must not, in any event, be modified. They are supplied with the CIGALE application and
your administrator is responsible for their maintenance.
5.2.6.3.
In CIGALE, an external file called TIMES.ADT allows you to declare timers between state-machine states for
which you want to generate specific statistics in the XLV file and in the TIM file and in AA database and in
Cigale View and T&A Files.
A timer is defined by a start state and an end state. Each time CigaleGSM goes through the pre-defined
start-state for a given connection, the start timestamp for the relevant timer is stored. When CigaleGSM
Astellia Confidential
28 / 87
goes through the pre-defined end-state for that same connection, the stored timestamp is deducted from
the current timestamp, and the connection is then associated with the timer value.
At the end of the processing campaign, CigaleGSM generates 4 statistics for all timers
- Number of associated connections
- Average duration
- Maximum duration
- Minimum duration
Furthermore, a distinction is made between timers relative to the BSCs and to the cells. The timers will then
be aggregated per BSC or per cell.
Below you will find a list of timers declared in the TIMES.ADT file.
The first columns in the file identify the transitions:
- initial state ;
- the message ;
- the message extension, if applicable ;
- the cause associated with the message, if applicable.
You will then find:
- the timers network aggregation : BSC or Cell ;
its identification :
for start timers, a start identifier must be specified ;
for end timers, you must declare the timer's name (to be displayed in the statistics) and
the associated start identifier. The types of the start and end timers must of course be
the same.
CAUTION :
This list is not exhaustive and cannot serve as absolute reference due to the parameterable
nature of timers.
Example:
STATE
MESSAGE
EXTENSION
CAUSE
TYPE
TIMER
ASCMP_1
ASCMP
Cell
ASCMP
Cell
ASCMP_2
ASCMP
Cell
ASCMP_3
HOCMP
Cell
HOCMP
HOPER
Cell
HOPER_IN
CLCMD
HoS
Cell
Oc_InterCel(ASCMP_1)
CLCMD
HoS
Cell
HoInterCel_InterCel(HOCMP)
CLCMD
HoS
Cell
HoIntraCel_InterCel(HOPER_IN)
CLCMD
Cell
Oc_Clr(ASCMP_2)
CLCMD
Cell
HoInterCel_Clr(HOCMP)
CLCMD
Cell
HoIntraCel_Clr(HOPER_IN)
HOPER
_OUT
Cell
Oc_IntraCel(ASCMP_3)
HOPER
_OUT
Cell
HoInterCel_IntraCel(HOCMP)
HOPER
_OUT
Cell
HoIntraCel_IntraCel(HOPER_IN)
_IN
Astellia Confidential
29 / 87
In the above example the timer called Oc_InterCel starts upon reception of an ASCMP (Assignment
Complete) message in any state, and stops when a CLCMD (Clear Command) with cause HoS (handover
successful) is seen in the same connection. This timer is calculated at the Cell level.
Note that several timers start upon reception of an Assignment Complete message, it is better in this case
to duplicate the ASCMP lines to start several timers (in the above example: ASCMP_2, ASCMP_3).
The generic character * allows you to declare any initial state. It can also (but not simultaneously) be used
to declare the messages. Note that the wildcard * cannot be used in the Extension or in the Cause column.
5.2.7. NETWORK FILE
In CIGALE, an external file called NETWORKS.TXT allows you to define the GSM networks using their MNC
code (Mobile Network Code) and MCC code (Mobile Country Code).
Now, the MNC and MCC codes are also extracted during decoding, and they are associated with the value
of the LAC. The XLU statistics are then broken down according to the MNC and MCC pairs in addition to the
value of the LAC.
The definition of the GSM networks (and therefore of the corresponding MNC and MCC pair) makes it
possible to display in plain language the names of the networks to which the LACs are attached in the XLU
file.
Furthermore, this information is also used to display in plain language the subscribers' origin network.
The NETWORKS.TXT file must be contained in the CIGALE config directory so that it can be loaded when you
start up CIGALE.
Below you will find a list of the GSM networks declared in the NETWORKS.TXT file along with the following
for each one:
- its name which will be used in AA, T&A and Cigale View ;
- its MCC (Mobile Country Code) ;
- its MNC (Mobile Network Code).
GSM network
MCC
MNC
A, max.mobil.
232
03
A, A1 (PTV)
232
01
276
01
AND, Mobiland
213
03
Astellia Confidential
30 / 87
$ : to replace a group of characters at the end of the number. For example, the number
012345 will be equated to the number 012$ declared in the PHONES.ADT file for the
statistics.
? : to replace a character. For example, if the number 1?3 is declared in the PHONES.ADT
and if numbers 123, 143 and 163 are dialled, these numbers will all appear in the XLV result
file.
@ : same thing as for ? but replaces several characters. Declaration of 012@ will cause to
list every number beginning by 012.
Numbers including the generic characters ! or $ will be displayed in the statistics by accumulating the
occurrences of the numbers that have been equated to them whereas every number corresponding to a
number including the generic characters ? or @ will be displayed in the statistics.
These generic characters can be used simultaneously for the same number.
However, the fact of using generic characters means that there are no priority rules in the event that a
number detected during processing can be equated to several numbers declared in the PHONES.ADT file
(e.g. the number 012345 is detected, and at least two of the numbers 01$, 012!45 and 012345 have
been declared in PHONES.ADT).
Furthermore, the international numbers (TONE = international) are preceded by the "+" character.
It should be noted that in the statistics files the called numbers are preceded by the "" character.
Below you will find an example of a list of called numbers:
NUMBER
COMMENT
NAME
777
voicemail
Voicemail
0492$
Test_team
Test_team
014!25$
Range_014
Range_014
0836680724
John_Smith
John_Smith
04!1583030
Just_a_test
Just_a_test
Here are a few examples of what numbers match the configured ranges above:
Destination
number
Match?
explanation
777
Matches voicemail
778
Doesnt
anything
0492123
Matches test_team
0492123456789
Matches test_team
01482545678
Matche Range_014
Starts with 014, followed by exactly one digit and then 25 and then any number
match
of digits
014002545678
Doesnt
match
anything
Astellia Confidential
31 / 87
The
TAC
mapping
file
is
a
text
file
"TAC\tManufacturer\tType\tTechno\tUA\tComments" :
TAC
00103400
00256841
00350016
00350019
00350029
Manufacturer
Palm
Sony Ericsson
Siemens
Siemens
Motorola
Type
Treo 600
K608
SL42_45
A36
T260
identified
Techno
UA
by
this
header
line:
Comments
--------------------------
When configured for iDEN networks, CigaleGSM can point to 2 mapping files : the regular TAC.txt file and
the FAC_EC.txt file. In case no match is found in the TAC file, the FAC_EC file is used to find the handset
manufacturer and type.
The content of this file is the following :
Astellia Confidential
32 / 87
The
FAC_EC
mapping
file
is
a
text
file
"FAC_EC\tManufacturer\tType\tTechno\tUA\tComments" :
TAC
Manufacturer
000117
Motorola
000118
Motorola
000119
Motorola
000112
Motorola
000122
Motorola
Type
i85s
i80s
i50sx
i55sr
i50sx
Techno
iDEN
iDEN
iDEN
iDEN
iDEN
UA
identified
by
this
header
line:
Comments
5.2.12. SDR_CLIENT
The parameters allow to configure both servers are described in Cigale.conf file.
Please refer to section 5.2.3 Cigale GSM Configuration file for more information.
5.2.13. MEGACO : MGW MAPPING FILE
There is an optional configuration file for Megaco Decoding specified in the configuration Processing /
Megaco / MGW mapping file. This file contains the mapping of the MGW IP address, RNC id and PCM.
Without this mapping file, it is impossible to associate a PCM number on the MGW with a PCM number on
the AN/CN termination side. This mapping file also contains information for IuCS terminations.
The file is a text file, tab-separated and contains several sections:
- A media gateway section identifying the MGW with its IP addresses or Point Codes
- A RNC part that is listing the RNCs linked to this MGW with their RNC id
- The BSC mapping section giving a complete PCM mapping
Heres an illustration of what this mapping file does:
Astellia Confidential
33 / 87
4419606
4419607
4419608
4419609
4419610
4419611
2192
2192
2195
2195
2191
2191
22
23
26
27
27
24
[MGW_6012]
PointCode=6012
Mapping=BSSAP
Mapping=BSSAP
Mapping=BSSAP
Mapping=BSSAP
4419608
4419609
4419610
4419611
4146
4146
4146
4140
15
7
11
5
5.3.
Cigale GSM allows launching a script in post queries. This script is present in Cigale GSM installation
directory PostQueries.bat.
This batch is launched by CigaleGSM at the end of the processing with one argument: the name of the AA
database.
The script could start for instance automatic SQL queries launched at the end of post-process in order to
provide additional information retrieved from Activity Report database (CDRs).
Heres an example of a PostQueries.bat file that queries the AA database in order to dump all distinct IMSIs
found in the CDRs into a text file:
Astellia Confidential
34 / 87
5.4.
There is an action QuerySQL in ASM witch can create custom indexes in MySQL database. The launch of
this task is independent of the engine processing and can operate in parallel of processing or at the end.
Astellia Confidential
35 / 87
6.
6.1.
DATA DESCRIPTION
PRESENTATION
Various files are generated during and at the end of processing so that the content of the record file can be
examined. These files may be log files (LOG, LHO) or statistics files. They are edited in a dedicated directory.
This directory corresponds by default to the directory containing the record file.
CIGALE
Engine
LOG, ERR
.txt data
Cigale
View
Activity
Analysis
qvm
base
File name
Astellia Confidential
36 / 87
6.2.
RESULTS OVERVIEW
Cigale GSM uses the decoded information to recreate the various connection contexts and updates the
internal counters used for the statistics :
XL3
SS
SMS
TIM
LHO
XL2
XLH and
XLF
XLU
XLT
XLV
miscellaneous statistics
EFF
EFFICACE counters
XLE
Call Trace
CDRs
KPIs
Lastly, the various error or warning messages generated during processing can be transferred to a log
file (LOG).
Capture file
Source of Cigale GSM
Generated
during
process
Log file
Used by Ast Admin
Result file
Generated
after
process
Source of Roaming,
Trace,
SLM
Text files
Source of Cigale
View
Generated
after
process
Astellia Confidential
37 / 87
It contains the information associated with the handover links between the connections managed in the
Handover Command message of the Layer 3 protocol. Do not forget that the links between the connections
are based, in particular, on the cells' BSIC-BCCH pairs.
When it has not been possible to establish the handover link, because there is no correspondence between
the cell concerned (identified by its BSIC-BCCH pair) and the list of cells proposed when the handover
request was made (Handover Required message in the BSSMAP protocol), the BSIC-BCCH pair concerned
and the list of candidate cells are written in the LHO file. For example, there will be :
14460 HOCMD_RR : No cell corresponds to bsic 18 and bcch 7.
Cell
CI
BSIC
BCCH
MALESHERBE
43936
MALESHERBEBIENFAISA
37280
26
On the contrary, if there was only one candidate cell, the handover link is established despite the fact there
is no correspondence between the BSIC-BCCH pairs. In this case, this is notified to the user and in the LHO
and then the cell's BSIC-BCCH pair is updated for the rest of processing. For example :
77836 HOCMD_RR : Unique cell 42652 assigned although not identified by the proposed bsic 13 and
bcch 56.
In this case, the cell is said to be certified. The certified cells will be identified in the statistics files by the
" * " character before their name :
135204 HOCMD_RR : No cell corresponds to bsic 0 and bcch 14.
Cell
CI
BSIC
BCCH
AvenueRapp1
7581
38
TREMOILLEBOCCADOR
42908
Astellia Confidential
38 / 87
*MAROTMARBOEUF
42652
13
56
It will then be possible to establish the handover links when there is no candidate cell corresponding to the
desired BSIC-BCCH pair, but only one candidate cell is not certified. In which case that cell will be managed
in the same way as for the case of a unique candidate cell.
6.2.3. XL3 : COMPLETE INFORMATION OF EACH CONNECTION
6.2.3.1.
Presentation
XL3 statistics are used to trace the complete sequence for a given connection by analyzing, either manually
or by post-processing, the various parts (on different cells) that that connection is made up of. It also
indicates the duration of each connection and the ringing duration if ringing took place.
The XL3 statistics are edited at closure of each connection or part of connection.
As a general rule, for regular observations or for statistical processing operations that do not concern a
problem on a precise type of connection, there is not much point in generating this file, which is very
cumbersome to exploit.
However, CIGALE allows you to mark state-machine transitions in the AUTOMAT.BDT file so that only
certain connections will be included in the XL3 file. So, a connection will only be written in this file if it has
caused a marked transition. In which case, provided the transition is not an initial transition (starting in the
BEGIN state), the transition concerned is indicated.
XL3 statistics have two special features:
- they are edited during processing (generally at closure of each connection) ;
- they can be generated in text format
- In order to generate XL3 statistics, you will have to insert the line EDIT_XL3=1 in the
CIGALE.INI file before you start up CIGALE or turn on the Connections (XL3) check box in
the window associated with the statistics files
Special case of intra-BSC handovers
In the case of intra-BSC handovers, lines are added to the XL3 file that trace the transfers between parts of
a connection when a HOPER message is detected.
The origin connection then ends in the XL3 file with an event called HOPER_OUT at the end instant t1.
The destination connection starts with a HOPER_IN event at instant t1.
It is therefore possible to find the link between several parts of connections.
In the case of an intra-cell handover, two lines appear in the XL3 file: one ending with a HOPER_IN_CEL
event, and the other starting with the same event.
When there is a change of cell during the channel assignment phase (BSC internal Directed Retry function),
two lines appear in the XL3: one ending with an ASCMP_xx_OUT event (for the cell being exited), and the
other starting with an ASCMP_xx_IN event (for the new cell).
6.2.3.2.
The XL3 file includes by default (configurable via the output_xl3.ini file) the following fields presented in
columns for each connection :
the date of the last update (end date and time of the connection or of the part of the connection) ;
the opening date (start date and time of the connection or of the part of the connection) ;
Astellia Confidential
39 / 87
the time elapsed (connection duration) between the opening date and the last update ; the duration of
time between the opening date and the most recent update: this duration is directly expressed in
milliseconds, and no longer in the format HH:MM:SS:mmm
the duration of the ringing phase (ringing duration) if there was one (between the ALERTING and
CONNECT messages or cut-off) ; this duration is directly expressed in milliseconds, and no longer in the
format HH:MM:SS:mmm
the LAC (Location Area Code) ; of the serving cell on the opening
the name of the serving cell at opening and its CI (Cell Identity) ;
the opening event (start event);
the last message (end event) received : either for a handover (with a cell change for the connection), or
for the termination of the connection ;
the state (previous state) preceding reception of the last message (the one indicated in the previous
column);
the cause (cause/rejcause) or reject cause associated with the last message received if it exists ;
the CIC that may have been used by the connection ;
the first TMSI (initial TMSI) and the new reallocated one if any (TMSI);
the current IMSI and IMEI ;
called or calling number (Number) associated with the connection, supplementary service operations
and strings, Destination or Originating addresses of RP and TP protocols .
Examples of supplementary service operations are : NotifySS, ActivateSS, EraseSS,
InterrogateSS, pud (process unstructured data), pur (process unstructured request),
Examples of supplementary services are : cfu (call forwardinfg unconditional), cfb (call
forwarding on busy), cfnrc (call forwarding on not reachable), allCondForwardingSS,
For Destination or Originating addresses of RP and TP protocols, numbers are prefixed xith
rpoa_ or rpda_ or tpoa_ or tpda.
The called or calling number (number)
A connection number (Ncnx), defined internally by CIGALE, which allows to easily find all the transfers
between parts of connection (intra-BSC or inter-BSC handovers if the 2 BSC concerned belong to the
same file processed by CIGALE)
The code of the old LAC with the corresponding (MCC-MNC) network for location updates;
the CI of the previous cell (PrevCI), in the case of a part of a connection by incoming handovers ;
the CI of the following cell (NextCI), in the case of a successful outgoing handover ;
the cause of an incoming handover (CauseHoIn), in the case of part of a connection arriving by
handover ;
the cause of an outgoing handover (CauseHoOut), in the case of a successful outgoing handover ;
information on the mobile equipment used for the connection (InfoMS): revision level (Ph1: phase 1,
Ph2 : phase 2, Phx : other phases), multiband capability (Bi), EFR support (EFR), Dual rate Full and Halfsupported (DRa), CLIR Calling Line Identification Restriction - service (CLIRi : invocation, CLIRs :
suppression) when requested in the setup message;
Astellia Confidential
40 / 87
the number of the first frame (Nframe) in the saved file of the connection on every A interface. This
number corresponds to the frame containing the CR message (Connection Request) of the opening of a
SCCP connection on every A interface ; this CR message includes either a CL3I message (Complete Layer
3 Info) or a HOREQ (HandOver REQuest) ;
indication of data resource allocation for a given call (D);
the numbering of the serving BSC (NBSC) for the connection part ;
the total number of handovers (HoNb) at the end of the connection. This number is provided within the
last part of the connection (the one of the termination); otherwise, this column includes a > symbol for
the first handover, and . symbols for the other handovers.
Some elements taken out of the Bearer Capability Information Element (BearerCap) in the CALL
CONFIRMED, CALL PROCEDING or SETUP message. The aim is to provide details about data connections
in the following order : information transfert element (s : speech, UDI : unrestricted digital information,
31A : 3.1 Khz audio ex PLMN, FG3 : facsimile group 3, othITC : other ITC), User Rate (ur0.3 : 0.3 kbit/s
Rec X.1 and V.110, ur1.2 : 1.2kbit/s Rec X.1 and V.110, ur2.4 : 2.4 kbit/s Rec X.1 and V.110, ur4.8 :
4.8kbit/s Rec X.1 and V.110, ur9.6 : 9.6 kbits/s Rec X.1 and V.110, ur12trans : 12.0 kbit/s transparent (no
compliance with X.1 and V.110)), modem type (NoMod : no modem, V21, V.22, V22b : V22 bis, V26 ter,
V32, ModUnInt : modem for undefined interface, autobaudT1 : autobauding type 1) and Fixed Network
User Rate (FNur9.6 : 9.6 kbit/s Rec X.1 and V.110, FNur14.4 : 14.4 kbit/s Rec X.1 and V.110, FNur19.2 :
19.2 kbit/s Rec X.1 and V.110, FNur28.8 : 28.8 kbit/s Rec X.1 and V.110, FNur38.4 : 38.4 kbit/s Rec X.1
and V.110, FNur48 : 48 kbit/s Rec X.1 and V.110 (synch), FNur56tr : 56 kbit/s Rec X.1 and V.110 (synch)
/bit transparent, FNur64tr : 64 kbit/s bit transparent, FNur33.6tr : 33.6 kbit/s bit transparent,
FNur32I460 : 32.0 kbit/s Rec I.460)
The duration of the call (Call duration), from the CONNECT message to the last message of the
connection, in milliseconds
the paging response time (PAGRP time) in milliseconds; it is measured between the first A interface
PAGING message and the corresponding Paging Response message. If there is no answer to the paging,
this time corresponds to the time between the 2 A interface paging messages.
the number of A interface Paging messages (PAG Nb) for the paging procedure.
Bsic
BCCH
ChaT-TN
Astellia Confidential
41 / 87
Bsic
BCCH
ChaT-TN
Transition tag (TypeTrans) : indicates the CDR type based on the following table:
Byte 2
4
3
Not used
PROCEDURE_TYPE
Byte 1
4
3
CONNEXION_PHASE
SYSTEM
where:
Procedure Type:
Hexadecimal value
Name
explanation
0x00
OC
Outgoing Call
0x01
TC
Incoming Call
0x02
SMS_MO
Outgoing SMS
0x03
SMS_MT
Incoming SMS
0x04
SS_MO
0x05
SS_MT
0x06
LU_NU
0x07
LU_PU
0x08
LU_IA
0x09
HO_IN
0x0A
IMSID
IMSI Detach
Connexion Phase
Hexadecimal value
Name
explanation
0x00
Setup
0x01
Alerting
0x02
Communication
System
Hexadecimal value
Name
0x00
User
0x01
BSS
0x02
NSS
Astellia Confidential
42 / 87
0x03
Normal
The type of the serving cell (Current type cell): can be 2G, UMA or 3G
The type of the previous serving cell (Previous type cell): can be 2G, UMA or 3G
The type of the next serving cell (Next type cell) : can be 2G, UMA or 3G
TAC: first 6 or 8 digits of the IMEI, between square brackets, for example [35905102]
The type of old LAC (Type Old LAC) : can be 2G, 3G or Invalid
HPG type: based on Classmark Type 2 and Classmark Type 3, uses the following bit mask:
UMTS
GPS
13107
2
6553
6
HFR
AMR
WB
32768
OFR AMR
WB
HR AMR
WB
FR AMR
WB
HRAM
R
16384
8192
4096
2048
FR
AMR
1024
EFR FR
512
25
6
85
0
190
0
180
0
90
0
12
8
64
32
16
If the connection has detected a non-initial transition that is marked in the state-machine's description file,
the following three columns will be included :
Astellia Confidential
43 / 87
The TMSI, IMSI, IMEI and called numbers are systematically preceded by the " " character
(obtained via ALT+0183)
Do not forget that international called or calling numbers are also preceded by the " + "
character.
6.2.4. PERIODIC XL3 : COMPLETE INFORMATION OF EACH CONNECTION FOR A PERIOD
The Periodic XL3 files are generated periodically every 1,2,5,10,15,20,60 mn (configurable in Cigale GSM
configuration). They are used by ROAMING RAN and contains exactly the same information of the XL3 file.
6.2.5. XL2 : STATISTICS ON THE NUMBER OF A INTERFACE MESSAGES
The XL2 statistics file will only be generated if you choose the option for generating statistics on the statemachine transitions. This option can be chosen or in the window associated with the statistics files.
This file gives detailed statistics on the number of messages observed on each A interface according to the
connection step and the cell on which the transition is made.
Each connection evolves according to a state-machine's states. Each connection begins in the
BEGIN state and follows a specific transition depending on the service requested (e.g. originating
call, terminating call, location update, handover managed by the MSC, supplementary service,
outgoing short message, etc.).
Connection evolution is therefore followed by means of the states of the state-machine. It is also followed
from cell to cell and the messages received are counted according to their arrival in such and such a cell.
This results in the message occurrence statistics being presented by states and by cells.
In-depth knowledge of the protocols used on the A interface is required to analyze this file.
The XL2 file is classified by BSC. For each BSC, the lists of cells without any observed traffic and of those
with observed traffic are given.
The content, column by column, of the XL2 files is described below:
- the state of the connection at the moment the event was received ;
- the event (including the extension if applicable) ;
- the cause, if applicable, associated with the event ;
- the state of the connection after reception of the event ;
- the total number of occurrences of that event in the current state (all cells considered) ;
- the following columns give the breakdown of those event occurrences per cell for the BSC
being monitored.
This file therefore traces the evolution of the connections in great detail for each cell in statistical form.
6.2.6. XLH : FLOW OF OUTGOING HANDOVERS TYPES FOR EACH CELL
The XLH statistics file will only be generated if you have chosen the option for generating statistics on
handovers. You can choose this option in the window associated with the statistics files.
Astellia Confidential
44 / 87
This file gives a table of flows of handover types. It takes the form of a series of tables separated by two
blank lines.
This file contains all the intra-cell, intra-BSC and inter-BSC handovers
causes for all origin cells.
BSC
Studied cell
(Source cell)
Ho information
The first part concerns the first three columns: it includes the implemented cells with, in order: the name of
the attachment BSC, the cell's name and its CI.
6.2.6.2.
This part is filled in when the source cell belongs to a BSC whose A interface has been observed.
This part consists of the following columns:
intra-BSC, intra-cell handovers :
the CEL column : characterizes the changes of channel within a given cell (all causes considered).
This column will only be displayed if the Detailed display of handovers option is not selected ;
the CEL_ULQ column (cause : Uplink Quality) : channel changes inside a given cell due to poor
quality in the uplink direction. This column will only be displayed if the Detailed display of
handovers option is selected ;
the CEL_ULS column (cause : Uplink Strength) : channel changes within a given cell due to field
weakness in the uplink direction. This column will only be displayed if the Detailed display of
handovers option is selected ;
Astellia Confidential
45 / 87
the CEL_DLQ column (cause : Downlink Quality) : channel changes inside a given cell due to poor
quality in the downlink direction. This column will only be displayed if the Detailed display of
handovers option is selected ;
the CEL_DLS column (cause : Downlink Strength) : channel changes within a given cell due to field
weakness in the downlink direction. This column will only be displayed if the Detailed display of
handovers option is selected ;
the CEL_D column (cause : Distance) : channel changes within a given cell due to distance. This
column will only be displayed if the Detailed display of handovers option is selected ;
the CEL_BC column (cause : Better Cell) : channel changes within a given cell due to the existence
of a better field. This column will only be displayed if the Detailed display of handovers option is
selected ;
the CEL_DR column (cause : Directed Retry) : channel changes within a given cell due to Directed
Retry. This column will only be displayed if the Detailed display of handovers option is selected ;
the CEL_XX column (other causes) : characterizes the channel changes within a given cell for a
cause other than those listed above. This column will only be displayed if the Detailed display of
handovers option is selected ;
the OUT_ULQ column (cause : Uplink Quality) : handovers triggered due to poor quality in the
uplink direction ;
the OUT_ULS column (cause : Uplink Strength) : handovers triggered due to field weakness in the
uplink direction ;
the OUT_DLQ column (cause : Downlink Quality) : handovers triggered due to poor quality in the
downlink direction ;
the OUT_DLS column (cause : Downlink Strength) : handovers triggered due to field weakness in
the downlink direction ;
the OUT_BC column (cause : Better Cell) : handovers triggered due to the existence of a better
field ;
the OUT_DR column (cause : Directed Retry) : handovers triggered due to Directed Retry. This
column will only be displayed if the Detailed display of handovers option is selected ;
the OUT_XX column (other causes) : handovers triggered for a cause other than those listed
above. This column will only be displayed if the Detailed display of handovers option is selected ;
the ASS column (ASSIGNMENT COMPLETE message : change of cell during channel assignment
(BSS internal Directed Retry function) ;
Astellia Confidential
46 / 87
Outgoing handovers
% Response = Nb HO Command/Nb Ho Required
% Failure = Nb HO Clear Command/Nb HO Command
Incoming handovers
% Response = Nb HO Request Ack/Nb Ho Request
% Failure = Nb HO Complete/Nb HO Request Ack
the RQD1_ULQ column (cause : Uplink Quality) : handovers due to degraded quality in the uplink
direction for which the target cell (indicated at the beginning of the corresponding line) is
classified in the first position (hence the 1) in the list of eligible cells transmitted in the Handover
Required message ;
the RQD1_ULS column (cause : Uplink Strength) : handovers due to a field that is too weak in the
uplink direction for which the target cell (indicated at the beginning of the corresponding line) is
classified in the first position (hence the 1) in the list of eligible cells transmitted in the Handover
Required message ;
the RQD1_DLQ column (cause : Downlink Quality) : handovers due to degraded quality in the
downlink direction for which the target cell (indicated at the beginning of the corresponding line)
is classified in the first position (hence the 1) in the list of eligible cells transmitted in the
Handover Required message ;
the RQD1_DLS column (cause : Downlink Strength) : handovers due to a field that is too weak in
the downlink direction for which the target cell (indicated at the beginning of the corresponding
line) is classified in the first position (hence the 1) in the list of eligible cells transmitted in the
Handover Required message ;
the RQD1_D column (cause : Distance) : handovers due to an excessive distance with respect to
the source cell whose target cell (indicated at the beginning of the corresponding line) is classified
in the first position (hence the 1) in the list of eligible cells transmitted in the Handover
Required message ;
the RQD1_BC column (cause : Better Cell) : handovers due to a better cell with respect to the
source cell whose target cell (indicated at the beginning of the corresponding line) is classified in
the first position (hence the 1) in the list of eligible cells transmitted in the Handover
Required message ;
the RQD1_DR column (cause : Directed Retry) : handovers due to lack of TCH resources on the
originating cell whose target cell (indicated at the beginning of the corresponding line) is classified
in the first position (hence the 1) in the list of eligible cells transmitted in the Handover
Required message. This column will only be displayed if the Detailed display of handovers option
is selected ;
the RQD1_XX column (other causes) : handovers for a cause other than those described above for
which the target cell (indicated at the beginning of the corresponding line) is classified in the first
position (hence the 1) in the list of eligible cells transmitted in the Handover Required message.
This column will only be displayed if the Detailed display of handovers option is selected ;
Astellia Confidential
47 / 87
Required message. The RQD2_DR and RQD2_XX columns will only be displayed if the Detailed
display of handovers option is selected ;
the CMDx column : execution of handovers (Handover Command message) to a cell which it has
not been possible to connect with the cells contained in the previous Handover
Required message's list (hence the designation "cell x") ;
the CMD1 column : execution of handovers (Handover Command message) to the first cell in the
list of eligible cells called up earlier by the Handover Required message (hence the 1) ;
the meaning of the CMD2 and CMD3 columns is similar to that of the CMD1 column for the cell
placed in the second and third positions respectively of the list called up by the Handover
Required message ;
Remark :
When the list of eligible cells called up by the Handover Required message contains more than
three cells, the information concerning the cells after the fourth position does not appear in
the table.
the HOsu column (Clear Command message, cause : Handover successful) : indicates the number of
successful inter-BSC handovers ;
the RRJ column (Handover Required Reject message) : indicates the number of inter-BSC handovers that
have failed due to the absence of cells able to support the mobile ;
The FAIr column (Handover Failure message, cause : Reversion to old channel) : indicates the number of
handovers that have failed due to reversion to the old channel (failed connection to the target cell).
6.2.6.3.
This part is filled in when the target cell belongs to a BSC whose A interface has been observed.
This part consists of the following columns :
the REQ column (Handover request message) : indicates the number of inter-BSC handover requests.
This column will only be displayed if the Detailed display of handovers option is not selected ;
the REQ_None column (no cause) : indicates the number of requested inter-BSC handovers for which no
cause is specified. This column will only be displayed if the Detailed display of handovers option is
selected ;
the REQ_ULQ column (cause Uplink Quality) : indicates the number of inter-BSC handover requests due
to poor quality in the uplink direction. This column will only be displayed if the Detailed display of
handovers option is selected ;
the REQ_ULS column (cause Uplink Strength) : indicates the number of inter-BSC handover requests due
to field weakness in the uplink direction. This column will only be displayed if the Detailed display of
handovers option is selected ;
the REQ_DLQ column (cause Downlink Quality) : indicates the number of inter-BSC handover requests
due to poor quality in the downlink direction. This column will only be displayed if the Detailed display
of handovers option is selected ;
Astellia Confidential
48 / 87
the REQ_DLS column (cause Downlink Strength) : indicates the number of inter-BSC handover requests
due to field weakness in the downlink direction. This column will only be displayed if the Detailed
display of handovers option is selected ;
the REQ_D column (cause Distance) : indicates the number of inter-BSC handover requests due to
distance. This column will only be displayed if the Detailed display of handovers option is selected ;
the REQ_BC column (cause Better Cell) : indicates the number of inter-BSC handover requests due to
the existence of a better field. This column will only be displayed if the Detailed display of handovers
option is selected ;
the REQ_DR column (cause Directed Retry) : indicates the number of inter-BSC handover requests due
to Directed Retry. This column will only be displayed if the Detailed display of handovers option is
selected ;
the REQ_XX column (autres causes) : indicates the number of inter-BSC handover requests for a cause
other than those listed above. This column will only be displayed if the Detailed display of handovers
option is selected ;
the RAC column (Handover Request Acknowledge message) : indicates the number of inter-BSC
handover request acknowledgments ;
the FAI column (Handover Failure) : indicates the number of handovers that have failed after attempted
connection to the target cell ;
the DET column (Handover Detect message) : indicates the number of attempted accesses by handover.
Certain manufacturers have not introduced this message, it is therefore possible that this column will
not be filled in (see the restrictions made by the manufacturers) ;
the CMP column (Handover Complete message) : indicates the number of successful inter-BSC
handovers ;
the CLR column (Clear Command message) : indicates the number of failed handovers after successful
access to the target cell (for example failure at level 2).
6.2.6.4.
This part is given when a source cell belongs to a BSC for which its A interface was observed. It is only
displayed if the option Detailled handover display is selected. The delay for a handover to be considered a
ping pong handover is configurable.
Astellia Confidential
49 / 87
CELL B
CELL C
CELL B
CELL C
the HoPPG_DLQ column (cause Downlink Quality) : indicates the number of successful outgoing pingpong handovers with bad quality causes in the downlink direction, for calls that arrived by handover
(from the cell to which they return) and which remained on the source cell less than NN seconds [value
defined by the Limited duration for ping pong handover execution parameter];
the HoPPG_DLS column (cause Downlink Strength) : indicates the number of successful outgoing
handovers due to field weakness causes in the downlink direction, for calls that arrived by handover
(from the cell to which they return) and which remained on the source cell less than NN seconds [value
defined by the Limited duration for ping pong handover execution parameter];
Astellia Confidential
50 / 87
the HoPPG_D column (cause Distance) ; indicates the number of successful outgoing handovers with
distance causes, for calls that arrived by handover (from the cell to which they return) and which
remained on the source cell less than NN seconds [value defined by the Limited duration for ping pong
handover execution parameter];
the HoPPG_BC column (cause Better Cell); indicates the number of successful outgoing handovers with
better cell causes, for calls that arrived by handover (from the cell to which they return) and which
remained on the source cell less than NN seconds [value defined by the Limited duration for ping pong
handover execution parameter];
the HoPPG_DR column (cause Directed Retry) : indicates the number of successful outgoing handovers
with directed retry causes, for calls that arrived by handover (from the cell to which they return) and
which remained on the source cell less than NN seconds [value defined by the Limited duration for ping
pong handover execution parameter];
the HoPPG_XX column (other causes) : indicates the number of successful outgoing handovers with
causes other than the previous ones, for calls that arrived by handover (from the cell to which they
return) and which remained on the source cell less than NN seconds [value defined by the Limited
duration for ping pong handover execution parameter];
the HOPPG column: indicates the number of ping-pong handovers, those successful outgoing handovers
for calls that return to their previous cell after they arrived by handover from that cell and remained on
the source cell less than NN seconds [value defined by the Limited duration for ping pong handover in
seconds execution parameter];
These columns will only be displayed if the Detailed display of handovers option is selected.
intra-BSC, intra-cell handovers :
CEL_TRA column (cause : Traffic) : channel changes within a given cell due to Traffic.
CEL_OM column (cause Operation & Maintenance) : channel changes within a given cell due
to Operation & Maintenance.
OUT_OM column (cause Operation & Maintenance) : handovers triggered due to Operation
& Maintenance.
RQD2_OM column (cause Operation & Maintenance) : handovers triggered due to Operation
& Maintenance.
RQD3_OM column (cause Operation & Maintenance) : handovers triggered due to Operation
& Maintenance.
Astellia Confidential
51 / 87
REQ_TRA column (cause : Traffic) : indicates the number of inter-BSC handover requests due
to Traffic.
REQ_OM column (cause Operation & Maintenance) : indicates the number of inter-BSC
handover requests due to Operation & Maintenance.
HoPPG_TRA column (cause : Traffic) : indicates the number of successful outgoing handovers
with directed Traffic causes, for calls that arrived by handover (from the cell to which they
return) and which remained on the source cell less than NN seconds [value defined by the
Limited duration for ping pong handover execution parameter];
HoPPG_OM column (cause Operation & Maintenance) : indicates the number of successful
outgoing handovers with directed Operation & Maintenance causes, for calls that arrived by
handover (from the cell to which they return) and which remained on the source cell less
than NN seconds [value defined by the Limited duration for ping pong handover execution
parameter];
It should be noted that it is assumed here that all the handovers checked by the MSC are inter-BSC
handovers. It is possible, however, in certain special cases that the check of the intra-BSC handovers may
be returned to the MSC. The first columns of the table (CEL and OUT_xx) will then not be meaningful and
the other columns will give overall statistics on the successes and failures of all the handovers (intra and
inter-BSC).
The tables, each of which is relative to a source cell, are classified in increasing order of source cell CIs. The
target cells (lines) in each table are also classified in increasing order of their CI (all BSCs considered).
6.2.7. XLF : FLOW OF INCOMING AND OUTGOING HANDOVERS FOR EACH CELL
The XLF statistics file will only be generated if you have chosen the option for generating handover
statistics. You can choose this option in the window associated with the statistics files.
This file also concerns the handover flows, but gives a different view to that obtained in the XLH file. It also
consists of a series of tables relative to each cell. The purpose of each table is to indicate the handover
incoming and outgoing flows for the cell designated on the first line.
The tables are delimited by the terms START_XLF and END_XLF.
The first line of a table indicates the cell relative to the table. This first column identifies this line
(START_XLF term). The next three columns give the name of the cell's attachment BSC, the cell's name and
its CI. The rest of the line delimits the columns of the table associated with the incoming and outgoing
flows.
The second line contains the titles of the table's columns.
The next lines give the list of cells neighboring the cell being examined and on which at least one handover
has been observed. Each cell is filled in on three columns respectively indicating the name of its attachment
BSC, the cell's name and its CI. They are classified in increasing CI order.
Each table then has three parts, one concerning the handover flow leaving the cell concerned (whose name
is given on the first line), the second one the handover flow entering into that cell, and the last concerns
the flow of ping pong handovers.
Astellia Confidential
52 / 87
This file's content depends on whether you have chosen the Detailed display of handovers and written XLF
results reduction option or not.
6.2.7.1.
Outgoing flows
the ULQ column (Handover Performed and Handover Request messages, cause : Uplink
Quality) : handovers triggered due to poor quality in the uplink direction (intra-BSC handovers that have
succeeded and inter-BSC handovers). The number indicates the percentage of handovers generated by
this cause with respect to the total number of handovers observed from the source cell (indicated on
the first line of the table) to the target cell (indicated at the beginning of the line) ;
the ULS column (Handover Performed and Handover Request messages, cause : Uplink
Strength) : handovers triggered due to a field that is too weak in the uplink direction (intra-BSC
handovers that have succeeded and inter-BSC handovers). The number indicates the percentage of
handovers generated by this cause with respect to the total number of handovers observed from the
source cell (indicated on the first line of the table) to the target cell (indicated at the beginning of the
line) ;
the DLQ column (Handover Performed and Handover Request messages, cause : Downlink
Quality) : handovers triggered due to poor quality in the downlink direction (intra-BSC handovers that
have succeeded and inter-BSC handovers). The number indicates the percentage of handovers
generated by this cause with respect to the total number of handovers observed from the source cell
(indicated on the first line of the table) to the target cell (indicated at the beginning of the line) ;
the DLS column (Handover Performed and Handover Request messages, cause : Downlink
Strength) : handovers triggered due to a field that is too weak in the uplink direction (intra-BSC
handovers that have succeeded and inter-BSC handovers). The number indicates the percentage of
handovers generated by this cause with respect to the total number of handovers observed from the
source cell (indicated on the first line of the table) to the target cell (indicated at the beginning of the
line) ;
the D column (Handover Performed and Handover Request messages, cause : Distance) : handovers
triggered because the distance between the mobile and the source cell is too great (intra-BSC handovers
that have succeeded and inter-BSC handovers). The number indicates the percentage of handovers
generated by this cause with respect to the total number of handovers observed from the source cell
(indicated on the first line of the table) to the target cell (indicated at the beginning of the line) ;
the BC column (Handover Performed and Handover Request messages, cause : Better Cell) : handovers
(intra-BSC handovers that have succeeded and inter-BSC handovers) triggered because there is a better
cell (from the radio viewpoint). The number indicates the percentage of handovers generated by this
cause with respect to the total number of handovers observed from the source cell (indicated on the
first line of the table) to the target cell (indicated at the beginning of the line) ;
the DR column (Handover Performed and Handover Request messages, cause : Directed
retry) : handovers (intra-BSC handovers that have succeeded and inter-BSC handovers) triggered due to
a lack of TCH resources on the origin cell. The number indicates the percentage of handovers generated
by this cause with respect to the total number of handovers observed from the source cell (indicated on
the first line of the table) to the target cell (indicated at the beginning of the line). This column will only
be displayed if the Detailed display of handovers option is selected ;
Astellia Confidential
53 / 87
the XX column (Handover Performed and Handover Request messages, other causes) : handovers (intraBSC handovers that have succeeded, channel assignment handovers and inter-BSC handovers) triggered
for reasons other than those listed above. The number indicates the percentage of handovers generated
by this cause with respect to the total number of handovers observed from the source cell (indicated on
the first line of the table) to the target cell (indicated at the beginning of the line). This column will only
be displayed if the Detailed display of handovers option is selected ;
the Total column : this column indicates the total number of handovers leaving the cell indicated on the
first line of the table and going to the cell indicated at the beginning of the corresponding line (the
handover's destination cell). These are absolute values and not percentages ;
the %total column : this column indicates the proportion of each cell pair (source cell on the first line of
the table, and the target cell at the beginning of the line) with respect to the total number of handovers
leaving the cell indicated on the first line ;
the Tx rep column : this column indicates the percentage of the number of handovers performed
(Handover Command message relative to the first cell in the list called up by the previous Handover
Required message, CMD1 column in XLH) with respect to the number of handover requests (Handover
Required message with the cell indicated at the beginning of the line classified in the first position of the
list of eligible cells that has been called up, RQD1 column of XLH) ;
the Tx failed column : this column indicates the complement to 100% of the percentage of successful
handovers (Clear Command message with the cause Handover successful) with respect to the number of
handovers performed (Handover Command message).
The following columns deal with inter-BSC handovers times. The measured times are between the MSC
BSC Handover command and the MSC BSC Clear Command cause Handover successful. It corresponds to
the time the mobile station needs to access its newly allocated traffic channel.
the Avg duration column : average duration of the handovers from the cell indicated on the first line of
the table to the cell indicated at the beginning of the corresponding line ;
the Max duration column : maximum duration of the handovers from the cell indicated on the first line
of the table to the cell indicated at the beginning of the corresponding line ;
the Min duration column : minimum duration of the handovers from the cell indicated on the first line
of the table to the cell indicated at the beginning of the corresponding line ;
The Num HO column : represents the absolute number of handovers for which it was possible to
measure the execution time.
6.2.7.2.
Incoming flows
The second part, relative to the handover incoming flows to the cell being examined, consists of columns
similar to those in the first part. The only difference being that the handover direction is reversed. The
source cell is the one indicated at the beginning of the line and the target cell is the one indicated on the
first line of the table (incoming handovers to the cell being examined, that is to say the one indicated on
the first line of the table).
The only difference lies in the measured inter-BSC handover times. For the incoming handovers, the time is
measured between the BSC MSC Handover request acknoledge and BSC MSC the Handover
complete. It corresponds to the time the mobile station needs to access its newly allocated traffic channel.
Astellia Confidential
54 / 87
Astellia Confidential
55 / 87
Outgoing flows
the HoOut_TRA column: (Handover Performed and Handover Request messages, cause :
Traffic) : handovers (intra-BSC handovers that have succeeded and inter-BSC handovers)
triggered due to
. The number indicates the percentage of
handovers generated by this cause with respect to the total number of handovers
observed from the source cell (indicated on the first line of the table) to the target
cell (indicated at the beginning of the line). This column will only be displayed if the
Detailed display of handovers option is selected ;
the HoOut_OM column: (Handover Performed and Handover Request messages, cause :
Operation&Maintenance) : handovers (intra-BSC handovers that have succeeded and
inter-BSC handovers) triggered due to
. The number indicates the
percentage of handovers generated by this cause with respect to the total number of
handovers observed from the source cell (indicated on the first line of the table) to the
target cell (indicated at the beginning of the line). This column will only be displayed if the
Detailed display of handovers option is selected ;
Incoming flows
the HoIn_TRA column: indicates the pourcentage of incoming handover with cause Traffic.
This column will only be displayed if the Detailed display of handovers option is selected ;
the HoIn_OM column: indicates the pourcentage of incoming handover with cause
Operation&Maintenance. This column will only be displayed if the Detailed display of
handovers option is selected ;
ping pong handover flows
the HoPPG_TRA column: indicates the pourcentage of ping pong handover with cause
Traffic, in relation to the total number of ping pong handovers for the cell couple
concerned ; This column will only be displayed if the Detailed display of handovers option
is selected ;
the HoPPG_OM column: indicates the pourcentage of ping pong handover with cause
Operation & Maintenance, in relation to the total number of ping pong handovers for the
cell couple concerned ; This column will only be displayed if the Detailed display of
handovers option is selected ;
6.2.8. XLU : LOCATION UPDATE FLOWS
The location update procedure allows a mobile device to inform the cellular network, whenever it moves
from one location area to the next. Mobiles are responsible for detecting location area codes. When a
mobile finds that the location area code is different from its last update, it performs another update by
sending to the network, a location update request, together with its previous location, and its Temporary
Mobile Subscriber Identity (TMSI).
The XLU statistics file will only be generated if you have chosen the option for generating the statistics on
the location updates. You can choose this option in the window associated with the statistics files.
This file contains a series of tables indicating the location update flows. Each table is separated by two
blank lines from the next table.
Astellia Confidential
56 / 87
CIGALE creates LAC flow tables per destination Furthermore, the XLU statistics are broken down per MNC
and associated MCC pairs and per the subscribers' origin GSM networks.
The first line of a table indicates the LAC (Location Area Code) of the destination location area followed by
the titles relative to each column
The XLU statistics are ventilated in relation to the MCC and MNC couples associated with the LAC and in
relation to the Home GSM network of the subscribers. They also contain the details of particular reject
causes of location updates.
The XLU statistics contain two types of tables :
a local table for subscribers networks :here the statistics are grouped by subscribers network,
independent of the original LAC and destination
The first line of the table indicates the titles for each column
The following lines are relative to the network subscribers.
Tables per destination LAC : the statistics here are detailled by LAC of origin and by mobile network.
The first line of a table indicates the LAC of the destination location zone followed by the title relative to
every column. The following lines are relative to original location zones.
The following lines concern the origin location areas. For each line, you will see the following columns :
the LAC of the former location area (only for the type of table indicating per destination LAC);
the subscribers' origin GSM network (when the IMSI has been requested during the location update). If
not you will find a ? symbol ;
the number of normal location update requests ;
the number of successful normal location update requests ;
the number of rejected normal location update requests ;
the number of normal location updates interrupted by radio cuts ;
the number of rejected normal location updates with a PLMN Not Allowed cause ;
the number of rejected normal location updates with an IMSI Unknown in HLR cause ;
the number of rejected normal location updates with a Location Area Not Allowed cause ;
the number of rejected normal location updates with a Network Failure cause ;
the number of normal location updates rejected with a Invalid Mandatory Information cause ;
the number of normal location updates rejected with a cause other than the previous ones ;
the number of periodic location update requests ;
the number of successful periodic location update requests ;
the number of rejected periodic location update requests.
6.2.9. XLV : SCCP, TRAFFIC AND CIC STATISTICS
The XLV statistics file will only be generated if you have chosen the option for generating the miscellaneous
statistics. You can choose this option in the window associated with the statistics files
Astellia Confidential
57 / 87
This file contains miscellaneous items of information that do not necessarily have any link with each other.
The first series of information items concerns the processing time and the initial (at the beginning of
processing) and minimum remaining memories.
Processing time
Frames
The second series of information items concerns the processed file : count of records read, origins of the
captured frames broken down according to the analyzer's logic ports and the file's exploitation ratios
according to the protocols (processed frames rate, error frames rate).
Connections purged (still open at the end of the capture) for each interface
Astellia Confidential
58 / 87
Remark :
If the analyzer manages several ports, the informations on the logic ports indicate the
direction (RX or TX) followed by the board's number in parentheses and then the IT number.
For example, you will have RX(1)14 for the 14th port in reception mode on the 1st board.
The third series of information items concerns the list of connections that are open at the end of processing
of the record file. These connections are broken down per observed A interface.
Initial
Setup
Establishing
message
Setup
Alerting,
Progress Ringing
Connect
Communication
1st release
message
Establishing durations (broken down per originating and terminating calls with the distinction
being made between successful and failed calls and an indication of the handover rate)
Astellia Confidential
59 / 87
percentage of attempted connections broken down per cell and per class and mobile revision
levels.
The next part gives an overall accumulation of the called numbers broken down per type of called number.
These counts are also performed for the numbers declared in the PHONES.ADT file
These counts are detailed by two other statistics:
- column Setup/Alerting : setup durations
- column Alerting/Connect:ringing duration
Phones information
Astellia Confidential
60 / 87
The following statistics concern the number of SCCP messages seen when processing the record file.
The overall count of messages (SCCP, BSSAP, Layer3, RP, TP, SS and SMS) is then given with a breakdown
per observed A interface.
Lastly, the number of eligible cells contained in the lists called up in the HORQD messages, all A interfaces
considered.
6.2.9.1.
Timer table
Astellia Confidential
61 / 87
6.2.9.2.
USSD statistics
Astellia Confidential
62 / 87
MS
BSS
MM AUTHENTICATION REQUEST
MSC
/VLR
SCCP_RELEASE COMPLETE
MS
MSC
/VLR
BSS
congestion
BSSMAP ASSIGNMENT FAILURE
(NRRA)
CC DISC
SCCP_RELEASED
SCCP_RELEASE COMPLETE
Astellia Confidential
63 / 87
The next table is global to all the CICs used by the current BSC. It lists the accumulated durations per
number of simultaneous allocations, and the durations during which there were that number of
simultaneous allocations at the most (this corresponds to the duration sum of the numbers of allocations
lower than or equal to the current number of allocations). The table ends with the resource's average
number of allocations. The resource's number of allocations is also indicated at the beginning and end of
the file.
Then there is a table similar to the previous one relative to the SCCP resources of the current BSC.
Resource Nb
3
0 resource : D1 + D3
1 resource : D2 + D4 + D6
2 resources : D5 + D7 + D9
2
1
0
Time
D1
D2
D3
D4
D5
D6
D7
D8
D9
Allocations
Releases
SCCP
CIC
TCH
Handover request acknowledge (BSSMAP) (if the CIC Handover performed (BSSMAP) (release of the
is already assigned)
resource on the origin cell)
Clear command (BSSMAP)
Assignment complete (BSSMAP) (if the CIC is already Connection refused (SCCP)
assigned)
Released (SCCP)
Astellia Confidential
64 / 87
This file groups together all the information on each message relative to the supplementary services
detected during processing of a record file.
It is comprised of the following columns :
- Date : message reception date ;
- Time : reception time ;
- Message : message from the Layer 3 protocol concerned (with its extension if applicable) ;
- State : state of the state-machine at the time of the message reception transaction ;
- Cell : cell concerned ;
- Operation : name of the supplementary services' operation concerned ;
- Service : name of the supplementary service.
6.2.12. SMS : SHORT MESSAGES
The SMS statistics file will only be generated if you have chosen the option for generating the statistics on
the short messages. You can choose this option in the window associated with the statistics files.
MS
BSS
MSC
/VLR
HLR
SMS-IWMSC
SC
Nb SMS MO
Zone SMS OC failures
MAP_FORWARD_SHORT_MESSAGE
Message
Message and
transfer
adress
acknowledgment storage
MAP_FORWARD_SHORT_MESSAGE
ack
Nb SMS MO success
release
65 / 87
State : state of the state-machine at the time of the message reception transaction ;
Cell : cell concerned ;
RP MR : value of the Message Reference field delivered by the RP protocol ;
RP OA : value of the Originating Address field delivered by the RP protocol ;
RP DA : value of the Destination Address field delivered by the RP protocol ;
TP MR : value of the Message Reference field delivered by the TP protocol ;
TP OA : value of the Originating Address field delivered by the TP protocol ;
TP DA : value of the Destination Address field delivered by the TP protocol ;
PID : value of the Protocol IDentifier field delivered by the TP protocol ;
DCS : value of the Data Coding Scheme field delivered by the TP protocol ;
SCTS : value of the Service Centre Time Stamp field delivered by the TP protocol ;
CT : value of the Command Type field delivered by the TP protocol ;
MN : value of the Message number field delivered by the TP protocol ;
VP : value of the Validity Period field delivered by the TP protocol ;
Num char. : number of characters contained in the short message ;
UD : short message displayed depending to the character set ;
For 7 bit character set, short message is displayed in plain language
For 8 bit and UCS2 messages, shoert message is displayed in hexadecimal format
CD : command displayed in hexadecimal.
HLR
MS
MSC
/VLR
BSS
SMSIWMSC
SC
Message
transfer
MAP_SEND_ROUTING_INFO_FOR_SM
MAP_SEND_ROUTING_INFO_FOR_SM ack
MAP_FORWARD_SHORT_MESSAGE
Nb SMS MT
SMS CP-DATA [RP-DATA]
SMS CP-ACK
Nb SMS MT success
MAP_FORWARD_SHORT_MESSAGE
ack
release
Astellia Confidential
66 / 87
You can choose this option in the window associated with the statistics.
This file groups together the successive unit values of the timers. It is comprised of the following columns :
- Type : timer associated with the cells or with the BSCs ;
- Name : number between parentheses and name of the cell or of the BSC ;
- Timer : timer name ;
- Start event : message at the beginning of the connection ;
- Duration (ms) : corresponding duration in milliseconds.
- Connection number : this number corresponds to the internal connection numbering of
CIGALE ; it is the same numbering than the one used for XL3 statistics.
6.2.14. EFF : EFFICACE COUNTERS STATISTICS
This file groups together a set of counters. The Efficace counters are defined in the successive columns of
each associated transition in the state-machine description file (AUTOMAT.BDT).
Each counter can be associated with one or several transitions.
The AUTOMAT.BDT file also declares the version of EFFICACE that is compatible with those counters. This
version number will be written in the EFF file when the statistics are generated.
The table below presents examples of counters associated with the state-machine transitions.
Present
Cause
Next state
in
XL3
(by default = 0)
OC_CMS_REQ
NbOC
OC_CMS_REQ
NbOC
SSUP
NbOCss
SMS
NbOCsms
REEST
TC_PAG_RP
NbTC
HO_TCH_REQ
NbHORQ_HO
PrcHOREQ_INOUT
PqsHOREQ
HO_TCH_REQ
NbHORQ_HO
PrcHOREQ_INOUT
PqsHOREQ
HO_TCH_REQ
NbHORQ_HO
PrcHOREQ_INOUT
PqsHOREQ
HO_SD_REQ
HO_SD_REQ
HO_SD_REQ
LU_N
NbLUREQ_NU
LU_P
NbLUREQ_PU
Astellia Confidential
67 / 87
LU_IA
NbLUREQ_IA
END
NbIMSID
BEGIN
BEGIN
BEGIN
BEGIN
END
OC_AUT_REQ_1
OC_CIM_CMD
3G handovers
Two sorts of Handover are considerered: the outgoing Ho to 3G and the Incoming Ho from 3G.
The Incoming Ho from 3G per cell KPI are listed by (RNC, Cell) or (SAI, Cell):
RNC
LAC from 3G
SAC
LAC
CELL
Incoming Ho from 3G Req
Incoming Ho from 3G Cmd
Incoming Ho from 3G Succ
Incoming Ho from 3G Rate
Resp
Incoming Ho from 3G Rate Det
Incoming Ho from 3G Rate
Number of Handover Request (HOREQ) messages received by the target BSS for handovers
from 3G.
Number of Handover Request Acknowledge (HORAC) messages sent by the target BSS for
handovers from 3G.
Number of Handover Complete (HOCMP) messages sent by the target BSS for handovers
from 3G.
Incoming Inter-Ho Cmd / Incoming Inter-Ho Req.
number of Handover Detect (HODET) messages divided by Incoming Ho from 3G Cmd.
Incoming Ho from 3G Succ / Incoming Ho from 3G Cmd.
Astellia Confidential
68 / 87
Succ
Incoming Ho from 3G Average
duration (ms)
Incoming Ho from 3G Min
duration (ms)
Incoming Ho from 3G Max
duration (ms)
Nb of HO 2G->2G
Nb of drop in 2G cell
Nb of Call Release
6.2.16.2.
UMA handovers
Two sorts of Handover are considerered: the outgoing Ho to UMA and the Incoming Ho from UMA.
The Incoming Ho from UMA per cell KPI are listed by (UMA cell, Cell).
The Outgoing Ho to UMA per cell KPI are listed by (Cell, UMA Cell).
Incoming Ho from UMA
Req
Number of Handover Request (HOREQ) messages received by the target BSS for handovers from UMA.
Number of Handover Request Acknowledge (HORAC) messages sent by the target BSS for handovers from UMA.
Number of Handover Complete (HOCMP) messages sent by the target BSS for handovers from UMA.
Astellia Confidential
69 / 87
Succ
Incoming Ho from UMA
Rate Resp
number of Handover Detect (HODET) messages divided by Incoming Ho from UMA Cmd.
Nb of Call Release
Nb of HO 2G->2G
Nb of drop in 2G cell
Incoming Ho from 2G
Req
Number of Handover Request (HOREQ) messages received by the target BSS for handovers from 2G.
Incoming Ho from 2G
Cmd
Number of Handover Request Acknowledge (HORAC) messages sent by the target BSS for handovers from 2G.
Incoming Ho from 2G
Succ
Number of Handover Complete (HOCMP) messages sent by the target BSS for handovers from 2G.
Incoming Ho from 2G
Rate Resp
Incoming Ho from 2G
Rate Det
Incoming Ho from 2G
Rate Succ
Incoming Ho from 2G
Average duration (ms)
Incoming Ho from 2G
Min duration (ms)
Incoming Ho from 2G
Max duration (ms)
Nb of Call Release
Nb of HO UMA->UMA
Astellia Confidential
70 / 87
7.
APPENDIX A: GLOSSARY
2G
3G
3GPP
2nd Generation
3rd Generation
Third Generation Partnership Project
A
AAL
AAL2
AAL5
APN
ASN.1
ATM
AuC
B
BER
BSS
BTS
C
CAMEL Customised Application for Mobile network Enhanced Logic
CAP
CAMEL Application Part
CCI
Capability / Configuration Identifier
CCITT Comit Consultatif International Tlgraphique et Tlphonique (The International Telegraph and
Telephone Consultative Committee)
CEIR Central Equipment Identity Register
CN
Core Network
CRC
Cyclic Redundancy Check
CRNC Controlling Radio Network Controller
CS-GW Circuit Switched Gateway
CS
Circuit Switched
D
DCS
E
E-GGSN Enhanced GGSN
E-HLR Enhanced HLR
EGPRS Enhanced GPRS
EHPLMN
Equivalent Home PLMN
EIR
Equipment Identity Centre
Equipment Identity Register
ETSI
European Telecommunications Standards Institute
Astellia Confidential
71 / 87
F
FTN
forwarded-to number
G
GERAN
GGSN
GMSC
GPRS
GSM
GTP
GTP-U
H
H-CSCF Home CSCF
HLR
Home Location Register
HPLMN Home Public Land Mobile Network
I
IETF
IMEI
IMSI
IN
INAP
IP
IPv4
IPv6
ISDN
ISUP
ITU
K
Kc
Ki
Ciphering key
Individual subscriber authentication key
L
L1
Layer 1 (physical layer)
L2
Layer 2 (data link layer)
L2ML Layer 2 Management Link
L2R
Layer 2 Relay
L2R BOP
L2R Bit Orientated Protocol
L2R COP
L2R Character Orientated Protocol
L3
Layer 3 (network layer)
LAC
Location Area Code
Astellia Confidential
72 / 87
LAI
LMSI
LPLMN
LU
M
M
Mandatory
MAP Mobile Application Part
MCC Mobile Country Code
MO-SMS
Mobile Originated Short Message Service
MSC Mobile Switching Centre
MSID Mobile Station Identifier
MSIN Mobile Station Identification Number
MSISDN
Mobile Subscriber ISDN Number
MSRN Mobile Station Roaming Number
MT-SMS
Mobile Terminated Short Message Service
MTP Message Transfer Part
MTP3-BMessage Transfer Part level 3
N
NMSI
NNI
NO
NPA
NPI
NSS
O
O
Optional
O&M Operations & Maintenance
OID
Object Identifier
OPLMN Operator Controlled PLMN (Selector List)
P
P-TMSI
PCU
PDP
PDU
PID
PIN
PKCS
PLMN
PS
PSTN
Packet TMSI
Packet Control Unit
Packet Data Protocol
Protocol Data Unit
Packet Identification
Personal Identification Number
Public-Key Cryptography Standards
Public Land Mobile Network
Packet Switched
Location Probability
Public Switched Telephone Network
Astellia Confidential
73 / 87
Q
QoS
Quality of Service
R
Rel-4 Release 4
Rel-5 Release 5
RPLMN Registered Public Land Mobile Network
RT
Real Time
S
S-CSCF Serving CSCF
SAPI Service Access Point Identifier
SCCP Signalling Connection Control Part
SCP
Service Control Point
SGSN Serving GPRS Support Node
SIM
GSM Subscriber Identity Module
SIP
Session Initiated Protocol
SM
Short Message
SMS Short Message Service
SMS-SC Short Message Service - Service Centre
SS
Supplementary Service
SS7
Signalling System No. 7
SSF
Service Switching Function
SSN
Sub-System Number
STP
Signalling Transfer Point
T
TAC
TC
TLV
TMSI
TPDU
TS
U
UE
UI
UL
UMTS
UP
URAN
USIM
USSD
UTRAN
User Equipment
User Interface
Uplink (Reverse Link)
Universal Mobile Telecommunications System
User Plane
UMTS Radio Access Network
Universal Subscriber Identity Module
Unstructured Supplementary Service Data
Universal Terrestrial Radio Access Network
Astellia Confidential
74 / 87
V
VLR
Visitor Location Register
VMSC Visited MSC
VPLMN Visited Public Land Mobile Network
W
WAP
WIN
Astellia Confidential
75 / 87
8.
Severity
Critical
Critical
Critical
Critical
Critical
Critical
Critical
Critical
Critical
Critical
Critical
Critical
Critical
Critical
Critical
Critical
Critical
Critical
Critical
Critical
Critical
Critical
Critical
Label
Missing or bad parameter for Polling
You have not declared an analyzer DLL
in the INI file.\nThe application operation
is therefore interrupted.
Error(s) found : %s
Nb failed (HORAC-HOCMP) (%lu) >
Nb REQ (%lu) => Nb failed=Nb REQ
Error in a database insert operation : %s
Error in %s
file list mode / On-line processing mode:
invalid command line (missing -f option)
Error in index addition into XL3 : %s
Error in update of source table : %s
Error while initializing extract server:
%s:%s
Description
Missing parameter for Polling
You must declare at least one analyzer DLL to run
CIGALE (otherwise it will not be possible to perform
any record file processing).
Error found in command line.
Number of failed HO.
Error while inserting in database.
An error as occured.
Missing parameter in command line. No ouptut
name define.
Error while indexing database.
The source database update has failed.
Error while initializing extract server. See Frame
Extractor configuration.
In the case of a BTS migration, the data process
detects an incorrect BSC name in the cell
description file: the process can not any more affect
the BSC name from description file. The BSC is also
considered as Unknown.
Error while writing in MySQL Database
Error while indexing database.
Astellia Confidential
76 / 87
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Astellia Confidential
77 / 87
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
System properties
System properties
Error while initializing EVE.
Error occured while terminating EVE.
An error occured on MEGACO frame.
Indicated the data and statistics process are over
The file is loaded by the engine.
A frame in the capture file is not correct. This frame
will be ignored.
The frame has already been seen. It will be ignored.
Error while inserting SMS in the database.
The configuration file hasn't been load properly.
Compare cell Info between cellcig.dat and capture
process
The BSC declared for the cell in cell description file
is incorrect.
Error creating Database.
Astellia Confidential
78 / 87
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Info
Astellia Confidential
79 / 87
Info
Info
Info
Info
Major
Major
Major
Major
Delete file %s
Probe number : %d detected on : %s
=> Loading the event declaration file
%s.
Event n %d : %s" was called %d times"
[Internal] GetProcAddress failed
[Internal] LoadLibrary failed
State-machine description file missing.
%s file missing
Major
Major
Major
Major
File %s incorrect
File %s incorrect: %s
Line %s in file %s is incorrect.It will
therefore be ignored.
Incorrect %s description file version
number.
The version number of DLL %s\n
declared in the CIGALE.Conf file is
incorrect.
DLL %s declared in the configuration file
does not exist.
DLL %s declared in the configuration file
is not an analyzer DLL.
DLL % declared in the CIGALE.CONF file
is incorrect\n(it does not enable an
analyzer to be created).
DLL %s declared in the CIGALE.CONF
file is an incorrect file.
Analyzer %s\nis declared several times in
the CIGALE.CONF file
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Astellia Confidential
80 / 87
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Astellia Confidential
81 / 87
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Astellia Confidential
82 / 87
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Major
Periodic XL3 Path is not filled. Periodic XL3 output will be desactivated.
End of threshold memory purge (Number
of purge Part!: %d, Number of purge
Timeout!: %d, Free memory: %s).
End of threshold Purge.
Process memory is too high (%s Mo),
Process memory is too high, threshold purge
threshold purge starting.
starting.
Undefined GlobalTitle [%I64x]: PointCode Undefined GlobalTitle : a PointCode will be affected
[%d] will be affected to this GlobalTitle
to this GlobalTitle
Immediate Stop asked by ASM, data
Immediate Stop asked by ASM, data might have
might have been lost while stopping.
been lost while stopping.
Analyser : %s
Analyzer Info
Unknow Exception
Unknow Exception
CAUTION: Processing interruption because there is less than %s Kb memory left.
Processing has been interrupted because Processing of a record file has been interrupted
an error has been detected.
because an error has been detected.
Processing has been interrupted: Time
out
Problem with ocean 2G analyzer.
Processing has been interrupted: Bad
Problem with Ocean 2G analyzer. The flag is
flag
created but EDX file does not existed.
Processing has been interrupted:
Problem with ocean 2G analyzer. Capture files are
desynchronized files
in the disorder
On demand process error: no connection
found.
On demand process error: no connection found.
Exception while trying to connect to
database
Exception while trying to connect to database
PSM Error: %s
SDR Sender Client Error: %s
A problem occured in SDR client (TT or SLM)
UPCS Error: %s
File %s skipped --> File time earlier than current time
Unable to open %s
Probe : %d is timed out
Maximum probe number reached : %d
[Probe : %d] Unknown Exception while %s
[Probe : %d] Exception while %s : %s
File %s is invalid.
File %s incorrect. Its identification line
The file does not correspond to the type of file
'%s' is missing.
expected because line ... is missing.
Unknown cause (line : %s).
An unknown Cause value has been detected.
The event description file is not present in the
Event description file missing.
CIGALE conf directory.
Incorrect event description file version
number.
Invalid version of the EVENTS.BDT file.
Line incorrect (Extension, cause and
destination state missing) : %s.
The line is incomplete.
Cause description file missing.
The cause declaration file is missing.
Invalid cause type (line %s).
The cause is incorrectly defined.
Two occurrences of the same cause have been
Cause duplicated (line %s).
detected.
Incorrect cause description file version
number.
Invalid version of the CAUSES.BDT file.
Line ignored (unknown Cause) : %s.
The cause is incorrect.
Line ignored (unknown extension) : %s.
Astellia Confidential
83 / 87
Major
Major
Major
Major
Major
Major
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Astellia Confidential
84 / 87
(CMSRQ).
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Astellia Confidential
85 / 87
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
(RNC_%s).
Duplicate BSC groups have been
detected : %s.
HOREQ message without a %s.
description file.
Astellia Confidential
86 / 87
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Warning
Error in Analyzer
Stop of the process (the end time band defined by
Time out reached in polling mode
the user is reached)
View - correction on HO In statistics : origin %s destination %s
A location update acceptance has been detected
LUACC : Allocation of different LACs :
with a GSM network value different to that in the
%s - %s.
location update request.
Analyser : %s
Analyzer Info
The current connection is closed and then opened
Connection closure on double
again subsequent to a new opening request for the
connection.
same connection.
=> Conversion of .ADT files
interrupted.
ADT File conversion is interrupted.
Action: %s is reported 24h later
Scheduled operation change asked at %s is out of file start time %s
Debug Message : %s
Mode Debug : %s
Astellia Confidential
87 / 87