QuantiQa Client

U S ER M AN U AL
P a rt 2 : Ap p e nd i c e s

S oft war e Re le ase 2.0

UG2-0502-00EN

Copyright 2009 CommProve Limited. All rights reserved.

While every effort has been made to ensure that the information contained in this document is
true and correct at the time of going to press, the products, specifications and services
described here, together with the document content in general, are subject to continuous
improvement. CommProve reserves the right to make such changes as it sees fit, without
prior notice, and cannot accept liability for any loss or damage, of any nature whatsoever,
arising or resulting from the use of the information or particulars contained here.
CommProve does not warrant that the material contained in this document is free of errors.
Any errors found in this document should be reported to CommProve in writing.
The information in this document is confidential, and is meant for use only by the intended
recipient in connection with, and subject to, the terms of its contractual relationship with
CommProve. This document is the sole property of CommProve, and no part may be
reproduced or transmitted in any form, or by any means, for any purpose, without the express
written permission of CommProve.
All trademarks not owned by CommProve that appear in this document, are the property of
their respective owners.

Contents
Conv entions Used In T his Docu ment ............................................. iii
S PELLING A ND T ERMINOLOGY .......................................................................... III

Appe ndix 1: T he Serv er Configuration Fil e (serv er.cfg) ................. 1

Appe ndix 2: F ormula s Sy ntax ........................................................ 3

F ORMULAS THAT GIVE RESULT AS A SINGLE VALUE ............................................... 3
F ORMULAS THAT GIVE RESULT AS A LIST OF VALUES ............................................. 5

Appe ndix 3: E mbedd ed Fun ctions ................................................. 9

ORAMAX ..................................................................................................... 9
ORAMIN ...................................................................................................... 9
MAX F UNCTION ............................................................................................. 9
MIN F UNCTION .............................................................................................. 9
SUM F UNCTION ............................................................................................ 10
AVG F UNCTION ............................................................................................ 10
MAX/AVG ................................................................................................... 10
MIN/AVG .................................................................................................... 11
ORAMAX(SUM()) ........................................................................................ 11
OPERATOR | ............................................................................................ 11
FREQEV (E VENT F REQUENCY) ....................................................................... 11
OPERATOR ^ ............................................................................................ 12
LB .............................................................................................................. 12
LN .............................................................................................................. 12
EXP............................................................................................................ 12
SQRT ......................................................................................................... 12
DEV (S TANDARD DEVIATION ) .......................................................................... 13
VAR (VARIANCE ) ........................................................................................... 13
MAXT ......................................................................................................... 14
MINT .......................................................................................................... 14

QuantiQa Client User Manual Part 2

AVGT ......................................................................................................... 14
IMAXT ........................................................................................................ 14
IMINT ......................................................................................................... 14
OPERATION BETWEEN TABLES.................................................................. 15
DELTA O PERATOR .......................................................................................... 16

Appe ndix 4: E mbedd ed Counters ................................................. 17

NSEC ......................................................................................................... 17
NSUBELEM ................................................................................................ 17
NROP ......................................................................................................... 17

Appe ndix 5: Tic ket Ty pe Co des ................................................... 19

Appe ndix 6: Glo ssary .................................................................. 21

ii

Conventions Used In This

Document
The following list explains the meaning of graphic symbols and devices, together with the
typographical conventions used in CommProve documentation.
Convention

Description

>

Used to show a step in a path to a window or dialog box.

For example:
File > Save As

Bold

Used for window component names, buttons, menu

options and similar.
For example:
Click Cancel.

Bold Italics

Used to emphasize important words or phrases.

For example:
JavaScript

<CAPITALS>

Used for keyboard key names, or key strokes.

For example:
Press <ENTER>.

Computer

Computer generated text.

For example:
<?xml version="1.0"?>

Marks

Used to highlight references to chapters within other

documents.

Marks

Used to highlight references to other chapters or sections

within the same document.

Information bar, used to highlight important information, such as the outcome of a described
action.
Caution bar, used to highlight for example, actions that could lead to undesirable results.

Warning bar, used to highlight for example, actions that could lead to data
loss, or system instability.

S PELLING A ND T ERMINOLOGY
CommProve English language documentation uses US English spelling conventions and
terminology.

iii

QuantiQa Client User Manual Part 2

iv

Appendix 1:
The Server Configuration File
(server.cfg)

A1

The server configuration file allows the user to define specific parameters for each server
requiring access by the QuantiQa client. Currently, a file named server.cfg that contains this
connection information must be located in the installation directory. The standard installation
path is:
<Local System Volume>:\<Program Files Directory Name>\Commprove\Quantiqa
where:
<Local System Volume> is the letter assigned by the operating system to the disk drive
volume where the operating system is installed (generally this is C)
<Program Files Directory Name> is the name assigned to the Program Files directory by your
operating system language
Each entry in the configuration file, except the first one, designates a server selecti on that is
visible in QuantiQa Client Main Server Selection window. The first entry in the configuration
file is a special meaning row: it contains a list of the configurable parameters, separated by
TABs, which can be easily identified by a @ character at the beginning of each parameter
name.
The following parameters are configurable for each server, and must be specified in the order
shown below. Each parameter MUST be separated by a TAB. To use the default value for the
parameter, the parameter must be empty and tabbed-through without specifying data for that
parameter.

T AB LE A1.1: S E RV ER . C FG F ILE C O NF IG UR ATI O N PAR A MET ER S

Parameter
Name
@srvname

Parameter Full
Name
Server Name

@srvadrs

Server IP Address

@port

Server TCP port

@alias

Database Alias

@geoset

@ttprop

Description

Example

Default Value

Specify the name of the server to be used

in the Server Selection window.

CommProve3G

Default

Specify the IP address of the server

QuantiQa GUI will use for connection.
Specify the TCP port number of the server
QuantiQa will use for connection
Specify the storage database name of the
QuantiQa main server.

10.10.10.123

localhost

3306

80

smop

gsp

Geographic Set

Specify the MapInfo MapX software

applications mapping GeoSet file name.

florence.gst

world.gst

Tool Tip Properties

Specify the attributes associated with the

network element to be displayed as tool tips
when hovering the mouse over a network
element on the map.

Technology;LAC
;CI;BSC;CellTyp
e

No
tooltips
displayed
as
default.

Notes
The name should be representative
of measurements available on the
server. If this field is left blank, the
QuantiQa GUI will show Default as
server name in the Server Selection
window.
If left blank localhost IP address will
be used.
If left blank 80 TCP port will be
used.
This is a QuantiQa database
configuration parameter that has to
be known prior to configure the
server.cfg file.
A GeoSet is a collection of map
layers and their settings as defined
in the official MapInfo MapX
documentation. For further details,
please referrer to the MapInfo
documentation
at
reference.mapinfo.com.
Each Tool Tip must be separated
by semicolons and include no
spaces. Each tooltip name must be
a valid attribute that exists on the
server for the given network
element.

QuantiQa Client User Manual Part 2

Parameter
Name
@timeout

Parameter Full
Name
Server Timeout

@proxy

Description

Example

Default Value

Notes

Specify in seconds how long to wait on a

response from the server.

60

15

If using large aggregation methods

for large quantities of Network
Elements, it may be necessary to
specify a larger timeout value since
the server will require more time to
aggregate the requested query. If
the server takes longer than the
specified amount of seconds, a
message box will be displayed to
the user showing a timeout error.

Proxy IP Address

Specify a proxy server IP if necessary.

192.168.42.100

No IP is used for
proxy if left blank.

This parameter is used only in those

installations where the QuantiQa
main server is reachable through a
proxy server.

@hierarchy

Hierarchy Name

Specify the Hierarchy name used to access

measurement data and managed object
information on the server.

IUBCELL

RADIOQOS

This is a QuantiQa database

configuration parameter that has to
be known prior to configure the
server.cfg file.

@ddserver

Drill Down Server IP

Address

Specify the IP address and TCP port of the

Drill Down server QuantiQa GUI will use to
download PDUs and to query for tickets.

192.168.1.38:800
0

No IP and TCP
port are used for
Drill Down server
if left blank.

This is a QuantiQa System

configuration parameter that has to
be known prior to configure the
server.cfg file.

@updateU
RL

Auto Update URL

Specify an URL where the client will check,

after logging in to the corresponding server
entry, if a new QuantiQa Client software
version is available.

http://10.10.10.1/
QuantiQa/deploy

http://10.2.2.41/d
eploy

At the time of this document this is

an experimental parameter that
must be used only for development
purposes

@grain_sec
onds

ROP
Size
Seconds

Specify a default ROP (grain) size in

seconds that the QuantiQa GUI has to set
as soon as the login to the QuantiQa main
server completes.

300

3600

This parameter is used to define the

standard ROP granularity of a
specific measure.

in

For an example of the content of the server.cfg file, please refer to the one that comes with
your QuantiQa Client installation. To open the file, you can use a text editor, such as Microsoft
Windows Notepad.

Appendix 2:
Formulas Syntax

A2

There are two kinds of formulas defined in the CommProve Netledge and CommProve
QuantiQa Systems:
1.

Formulas that give a single value represent an arithmetical combination of numerical

values and elementary formulas.

2.

Formulas that give results as a list of values separated by ;. Such formulas use the $
operator.

F ORMULAS THAT GIVE RESULT AS A SINGLE VALUE

Table name [][] Sum of all table counters.

Table name[A:A][] - Sum of counters on row A and on all columns.

QuantiQa Client User Manual Part 2

Table name [A:C][] Sum of counters on #n rows located between rows A and C and on all
columns.

Table name [][C:E] Sum of counters on #n columns located between columns C and E and
on all rows.

Table name [A:B][C:E] Sum of counters on #n rows and #n columns located between A&B
rows and between C&E columns.

Appendix 2: Formulas Syntax

F ORMULAS THAT GIVE RESULT AS A LIST OF VALUES

Table name [$][] For each table row, the system sums the counters belonging to the row with
its all columns. The output results are displayed as follows: v1| v2| v3| v4| v5.

Table name [$][D:E] For each table row, the system sums the counters belonging to the row
with its columns between D and E (included).

Table name [A$B][] The system returns the sum of the row counters, for each row between A
and B and all columns.

QuantiQa Client User Manual Part 2

Table name [A$B][C:D] The system sums the row counters between the columns C and D
(included) for each row between A and B.

Table name [][$] For each column of the table, the system sums the counters belonging to
the column with its all rows.

Table name [A:B][$] For each column of the table, the system sums the counters belonging
to the column with its rows between A and B (included).

Appendix 2: Formulas Syntax

Table name [][C$D] The system returns the sum of the column counters, for each column
between C and D and all rows.

Table name [A:B][C$D] The system sums the column counters between the rows A and B
(included) for each column between C and D.

Table name [$][$] The system returns the list of all the counters in the table as follows:

QuantiQa Client User Manual Part 2

Table name [A$B][C$D] The system lists the counters between rows A and B and columns C
and D

Table name [A$B][$] The system shows the list of counters between rows A and B for all the
columns of the table.

Table Name [$][C$D] The system returns the list of counters for each row and columns
between C and D.

Appendix 3:
Embedded Functions

A3

This section reports a description of pre-defined Functions inside the CommProve Netledge
and CommProve QuantiQa Systems. Two types of functions are available in the system
according to the type of results:

Functions giving numerical values: these functions can be combined together inside the
same mathematical expression. Below an example:

A= MAX(CONT_A)*MIN(CONT_B)
B= LB(CONT_A)/CONT_B

Functions giving dates and time: These types of fun ctions cannot be combined together
in a mathematical expression.

ORAMAX
Syntax:

ORAMAX(Formula)

Function:

Gives the date and time in which the formula, specified between the
bracket, reaches the Maximum value in the given time interval.

ORAMIN
Syntax:

ORAMIN(Formula)

Function:

Gives the date and time in which the formula, specified between the
bracket, reaches the Minimum value in the given time interval.

MAX F UNCTION
Syntax:

MAX(Formula)

Function:

Gives the MAXIMUM value of the formula in brackets.

MIN F UNCTION
Syntax:

MIN(Formula)

Function:

Gives the MINIMUM value of the formula in brackets.

QuantiQa Client User Manual Part 2

SUM F UNCTION
Syntax:

SUM(Formula)

Function:

Determines an aggregation method, different from the one usually

applied by the system. For instance, the common aggregation
operation is performed as follows:

A B
is a function defined on the counters A, B, C and it is
C

evaluated on an interval T t 0 , t1 ,......t n and on a network element set

N n0 , n1,......nm . The operations result will be:

When F ( A, B, C )

FN ,T

A B

C
ni ,ti

tiT niN

tiT niN

tiT niN

ni ,ti

ni ,ti

By using the SUM function, the aggregation operation will be structured as follows:

FN ,T

Aniti Bniti

Cn t
ti T ni N
i i

In this case, the formula is evaluated for each hour and for each element, so the results
are added together giving the final value.

AVG F UNCTION
Syntax:

AVG(Formula)

Function:

Calculates the medium value of the formula within the bracket, for the
time and aggregation settings in the global time window and for the
selected Network Elements and their geographical aggregation mode.

MAX/AVG

10

Syntax:

MAX/AVG(Formula)

Function:

Calculates the ratio of Maximum value over the Average value of the
formula.

Appendix 3: Embedded Functions

MIN/AVG
Syntax:

MIN/AVG(Formula)

Function:

Calculates the ratio of the Minimum value over the Average value of
the formula.

ORAMAX(SUM())
Syntax:

ORAMAX(SUM(Formula))

Function:

Combination of SUM and ORAMAX functions. First it applies the SUM

function to the formula and then gives the time of the maximum value.

OPERATOR |
Syntax:

(Counter_A|Counter_B)

Function:

When summing up two operations, the operator | is used instead of

+, this will solve problems arising from the possible lack of data in one
of the two elements included in the sum.

Example:

The result of the formula (A | B) is:

A Value
10
10

B Value
10
Not available

A | B Result
20
10

Not available

Not available

Not available

Not available

FREQEV (E VENT F REQUENCY )

Syntax:

FREQEV(Formula# operator_of_comparison# )

Function:

Gives the number of times that the event, represented by the Formula
positioned inside the brackets and the condition applied to it in relation
to a defined threshold , with the specified operator, occurs.

Note that:

Valid operator_of_comparison
must be a numeric value

Example:

FREQEV((TOTCONGPAG/TOTPAG)*100#>=#0.1)

are:

(<,

>,

>=,

<=,

==,

!=);

11

QuantiQa Client User Manual Part 2

OPERATOR ^
Syntax:

x^y.

Function:

The operator ^ computes the value of x to the power of y. If x is

negative, y must be an integer value. Upon successful completion,
operator ^ gives the value of x to the power of y.

Examples:

CONT^3
CONT_A^CONT_B
CONT_A^(CONT_B*CONT_C).

Syntax:

LB(x)

Function:

Calculates the base 10 logarithm of x. The value of x must be positive;

otherwise the result will be #INF.

Example:

LB(CONT_A)*CONT_B

Syntax:

LN(x)

Functions:

Computes the natural logarithm of x. The value of x must be positive;

otherwise the result will be #INF.

Example:

LN(CONT_A)*CONT_B

Syntax:

EXP(x)

Function:

Computes the exponential of x.

Example:

EXP(CONT_A)*CONT_B

LB

LN

EXP

SQRT

12

Syntax:

SQRT(x)

Function:

Gives the square root of x.

Example:

SQRT(COUNT_A)/COUNT_B

Appendix 3: Embedded Functions

DEV (S TANDARD D EVIATION )

Syntax:

DEV(y)

Function:

Gives the standard deviation of y.

DEV(A/B) corresponds to:

A
DEV
B

Where:

( xt x )
t 1

n 1

n = aggregated ROPs

NE _ aggregati

xt

t ,s
s 1
NE _ aggregati

s 1

Bt ,s

(considering A t and B t the values of A and B counters at t ROP)

1 n
x xt
n t 1
Example:

DEV (COUNT_A+COUNT_B)

VAR (VARIAN CE )
Syntax:

VAR(x)

Function:

Gives the variance of x.

Example:

VAR(COUNT_A)/COUNT_B

13

QuantiQa Client User Manual Part 2

MAXT
Syntax:

MAXT(TablesDistribution).

Function:

Gives the maximum value among the ones in the distribution.

Examples:

MAXT(TALEVUL[$][$])
MAXT(TALEVUL[0$3][2$4])

Syntax:

MINT(TablesDistribution).

Function:

Gives the minimum value among the ones in the distribution.

Examples:

MINT(TALEVUL[$][$])
MINT(TALEVUL[0$3][2$4])

MINT

AVGT
Syntax:

AVGT(TablesDistribution).

Function:

Gives the average value of the distribution.

Examples:

AVGT(TALEVUL[$][$])
AVGT(TALEVUL[0$3][2$4])
AVGT(TALEVUL[1$3][])
AVGT(TALEVUL[1$3][4$8])

IMAXT
Syntax:

IMAXT(TablesDistribution).

Function:

Gives the row and column indexes of the maximum value in a

distribution.

Examples:

IMAXT(TALEVUL[$][$])
IMAXT(TALEVUL[0$3][2$4])

IMINT

14

Syntax:

IMINT(TablesDistribution).

Function:

Gives the row and column indexes of the minimum value in a

distribution.

Examples:

IMINT(TALEVUL[1$3][])
IMINT(TALEVUL[1$3][4$8])

Appendix 3: Embedded Functions

OPERATION BETWEEN TABLES

The operators * , - , +, /, ^, | can be applied, not only to scala rs and counters combinations,
but also to tables of values. The operations are performed element by element and the 2
tables must have the same dimensions (equal number of rows and columns).
The possible cases are reported below (it is obvious when both the variables are scalars):

Case 1:

Operator_A = scalar; Operator_B = table; Operation: <op>

Case 2:

|a11, a12|
<op> |a21, a22|
|a31, a32|

|b<op>a11, b<op>a12|
|b<op>a21, b<op>a22|
|b<op>a31, b<op>a32|

Operator_A = table; Operator_B = table; Operation: <op>

|b11, b12|
|b21, b22|
|b31, b32|

Case 3:

|a11, a12|
<op> |a21, a22|
|a31, a32|

|b11<op>a11, b12<op>a12|
|b21<op>a21, b22<op>a22|
|b31<op>a31, b32<op>a32|

Operator_A = table; Operator_B = scalar; Operation: <op>

|a11, a12|
|a21, a22| <op> c
|a31, a32|

|a11<op>c, a12<op>c|
|a21<op>c, a22<op>c|
|a31<op>c, a32<op>c|

where <op> can be one of the following operators: * , - , +, /, ^, |

Examples:

TALEVUL[][]*NSEC
TALEVUL[0$3][2$4]+DROP_TALQ[1$4][4$6]

15

QuantiQa Client User Manual Part 2

D ELTA O PERATOR
The Delta operator !, initiates time shifting, and is used to evaluate one, or more expressions
included in a formula, at different times.
For example:
The expression: RLINKISSUES[0:0][] returns the total number of radio disconnections, du ring
a defined time interval, starting at a time set by using the Main Selection window.
RLINKISSUES[0:0][]!-48 however, returns the total number of radio disconnections in a time
interval of exactly the same duration, but shifted 48 ROPs before the time s et in the Main
Selection window.
As a result, the Delta operator can be used to evaluate the changes that occurred between
two periods.
For example:
(RLINKISSUES[0:0][] - RLINKISSUES[0:0][]!-48)/ RLINKISSUES[0:0][]!-48 * 100
When a 24 hour time interval, with a ROP of 30 minutes, is evaluated using the above
expression, the result is the disconnection percentage, in a 2 day period.

16

Appendix 4:
Embedded Counters

A4

NSEC
Syntax:

NSEC

Function:

The function gives the number of seconds in the selected time frame.

Note:

When the NSEC function is performed for a given time frame, the
seconds taken into account are only those related to an hour where
there are available measurements; the seconds which make up an
hour without available data doesnt affect the total count.

NSUBELEM
Syntax:

NSUBELEM

Function:

The function gives the number of network elements included in a

specific aggregation.

Note: The function can be used to set media calculations on NE values, able to be adapted to a
variable number of included elements; the expression NSUBELEM can be used as media
denominator.

NROP
Syntax:

NROP

Function:

The function gives the number of hours included in a specific time

selection.

17

QuantiQa Client User Manual Part 2

18

Appendix 5:
Ticket Type Codes

A5

In the lists of ticket types, and the titles of ticket lists in the Drill Down and Drill Up processes,
code numbers are often used to signify the source ticket type. The following codes have been
used to refer to Ticket Types as indicated here:

Measurement Report

10

Radio Link

20

Abis Call Trace

30

Channel Request

40

Abis Assignment

50

Abis Handover

70

RL Failure

440

Paging

2000 Ainterface
2001 HandoverPerformed
2200 BssmapAssignment
2201 BssmapClear
2202 BssmapInHandover
2203 BssmapOutHandover
2300 CcCallEstablishment
2301 CcCallDisconnect

19

QuantiQa Client User Manual Part 2

20

A6

Appendix 6:
Glossary
Abbreviation

Meaning

3G

Third Generation

Abis

Abis interface

BCCH

BroadCast Channel

BLER

BLocking Error Rate

BTS

Base Station

BSIC

Base Station Identity Code

BTSM

Base Transceiver Station Management

CBCH

Cell Broadcast Channel

CC

Call Control

CCCH

Common Control channel

CDR

Call Detail Record

CGI

Cell Global Identification

CM

Compressed Mode

CN

Core Network

CRC

Cyclic Redundancy Check

CS

Circuit Switched

DCCH

Dedicated Control Channel

DTM

Data Transfer Mode

DTMF

Dual Tone Multi-Frequency

Ec/No

Chip Energy over Noise Ratio

GMM

GPRS Mobility Management

GSM

Global System for Mobile Communications

HSDPA

High Speed Downlink Packet Access

HS-DSCH

High Speed-Downlink Shared Channel

21

QuantiQa Client User Manual Part 2

22

Abbreviation

Meaning

IMEI

International Mobile Equipment Identification

IMSI

International Mobile Subscriber Identity

IRAT

Inter-Radio Access Technology

Iub

Iub interface

IuCS

Iu interface Circuit Switch

IuPS

Iu interface

KPI

Key Performance Indicator

KPM

Key Performance Matrix

KQI

Key Quality Indicator

L1

Layer 1

L2

Layer 2

L3

Layer 3

LAC

Location Area Code

MM

Mobility Management

MOU

Minutes Of Use

MR

Measurement Report

NAS

Non Access Stratum

NBAP

Node B Application Part

NCH

Network Controlled Handover or N-Channel

NE

Network Element

PCODE

Pointcode

PDCH

Packet Data Channel

PDU

Packet Data Unit

PS

Packet Switched

p-TMSI

Packet Temporary Mobile Subscriber Identity

QoS

Quality of Service

RAB

Radio Access Bearer

Appendix 6: Glossary

Abbreviation

Meaning

RAC

Routing Area Code

RANAP

Radio Access Network Application Part

RB

Radio Bearer

RF

Radio Frequency

RL

Radio Link

RLC

Radio Link Control

RNC

Radio Network Controller

ROI

Return Of Investment

ROP

Result Output Period

RR

Radio Resources

RRC

Radio Resource Control

SACCH

Slow Associated Control Channel

SCCP

Signalling Connection Control Part

SHO

Soft(er) Handover

SMS

Short Message Service

SS

Supplementary Services

TFO

Tandem Free Operation

TMSI

Temporary Mobile Subscriber Identity

UE

User Equipment

UMTS

Universal Mobile Telecommunications System

UTRAN

Universal Terrestrial Radio Access Network

Uu

Uu interface

VBS

Voice Broadcast Service

VGCS

Voice Group Call Service

23

CommProve Addresses
Ireland
CommProve Limited
Block F2
East Point Business Park
Fairview
Dublin 3
Ireland
Telephone: +353 1 818 8050
Fax: +353 1 875 0127
Italy
Via delle Fonti, 8/e
50010 Scandicci
Florence
Italy
Telephone: +39 055 737 54
Fax: +39 055 737 5666
UK
Annex 1
Worting Business Park
Church Lane, Basingstoke
Hampshire
RG23 8PX
UK
Telephone: +44 1256 817 640
Fax: +44 1256 811 876

USA
Suite 200-300
1022 S Greenville Ave.
Allen
TX 75002
USA
Telephone: +1 469 656 4900
Fax: +1 214 383 5999

Brazil
Av. Das Americas
3434 Bloco 5 Sala 503
22640-102
Rio de Janeiro
Brazil
Telephone: +55 21 3431 3738
Fax: +55 21 3431 3739