Professional Documents
Culture Documents
Ug1 0502 00en
Ug1 0502 00en
Ug1 0502 00en
USER MANUAL
P a r t 1 : T h e M a i n Wi n d o w, M e n u s ,
To o l b a r s , To o l s , D e f a u l t A n d
R e s u l t Wi n d o w s
UG1-0502-00EN
Description
>
Bold
Bold Italics
Used to emphasize
For example:
important
words
or
phrases.
key
strokes.
JavaScript
<CAPITALS>
key
names,
or
Press <ENTER>.
Computer
Marks
Marks
Caution bar, used to highlight for example, actions that could lead to
undesirable results.
S PELLING A ND T ERMINOLOGY
CommProve English language documentation uses US English spelling
conventions and terminology.
ii
Contents
Conventions Used In This Document....................................i
S PELLING A ND T ERMINOLOGY....................................................................II
Overview.........................................................................................1
B EFORE Y OU R UN Q UANTI Q A C LIENT.......................................................1
iii
Toolbars........................................................................................17
T HE N EW TOOLBAR ...............................................................................17
New Toolbar Buttons........................................................................17
Other Windows..................................................................................27
Information Windows.................................................................................27
Dialogs.......................................................................................................27
iv
Tools..............................................................................................29
O PTIONS..............................................................................................29
Protocol Analyzer..............................................................................30
Protocol Analyzer Fonts And Colors..............................................32
Ticket Viewer.....................................................................................33
Application.........................................................................................34
Map Results.......................................................................................36
Default Windows........................................................................43
D ISPLAY A D EFAULT W INDOW :................................................................43
MO Selection Filter...........................................................................63
D ELETE
P RESET .................................................................................72
P RESET...............................................................................72
vi
Query Results...........................................................................113
M APS .................................................................................................113
TABLES...............................................................................................113
C HARTS .............................................................................................113
vii
Selection Pointer............................................................................122
Zoom In ...........................................................................................122
Zoom Out.........................................................................................123
Zoom Extent....................................................................................123
Pan...................................................................................................123
Drill Down........................................................................................124
Disable Drill Down..........................................................................124
Show Neighbor Cells......................................................................124
Distance Measurement..................................................................126
Rectangle Selection.......................................................................126
Polygon Selection...........................................................................127
Layer Manager................................................................................127
Projection.........................................................................................127
File Manager...................................................................................128
viii
Export to Clipboard.........................................................................144
Export to Disk..................................................................................144
Export to Excel................................................................................145
Individual Cell Selection................................................................145
Table Options..................................................................................145
Column/Field Chooser...................................................................145
Collapse All Groups........................................................................146
Expand All Groups..........................................................................146
Normalization Dropdown List........................................................146
Table/Record Drag Area And Columns........................................147
Table/Record With NAN.................................................................147
ix
Pie Displacement............................................................................167
Pie With A NAN...............................................................................167
Two Dimensional Bar Chart...........................................................168
Three Dimensional Bar And Line Chart.......................................169
Three Dimensional Bar And Line Chart With NAN.....................170
Gauge Chart....................................................................................172
TABLE FACILITIES................................................................................174
Table Of Figures......................................................................185
Overview
To get the most out of this manual, and before reading further, please
ensure that you have installed QuantiQa Client, as described in the
QuantiQa Client Software Installation Guide.
The following pages provide detailed information about:
The "QuantiQa Client User Manual Part 2" contains the appendices to this
manual, and includes information about the Server Configuration File,
formulas and syntax. For information about getting started with QuantiQa
Client, please refer to the "QuantiQa Client Getting Started Guide".
The availability of certain QuantiQa Client functions to individual users,
depends upon their particular User Rights. For further information about the
rights available to you, please contact your system administrator. This
QuantiQa Client User Manual does not include, in detail, how to define User
Rights.
NOTE:
The examples of screens, menus and dialog boxes shown in this
manual, may differ slightly from those displayed by your system,
depending upon which Microsoft Windows version you are using, and
your local settings.
Title Bar
And Standard
Windows Controls
Main Menu
Toolbars
Time Grid Toolbar
Main Selection
Window
Ticket Finder
Window
Panels
Docking Area
For Other
Windows
Tabbed Windows
Status Bar
F I G U R E 2.1: Q U A N T I Q A C L I E N T M A I N W I N D O W .
TITLE BAR
The Title Bar displays the name of the application, and includes standard
Windows control buttons, to minimize, restore and close the Main Window.
M A I N M E N U (M E N U B A R )
The Main Menu , also referred to as the Menu Bar, provides access to a
range of dropdown lists, in a similar way to the main menus of other
Microsoft Windows based applications. These lists enable you to, for
example, open windows, change passwords, or display documentation. The
Main Menu is treated in many ways like a Toolbar in QuantiQa Client, and
can be relocated, or hidden, as required.
TO OL B ARS
All QuantiQa Client toolbars, apart from the Map Tools toolbar, display by
default, at the top of the Main Window, and provide access to several of the
applications tools and advanced functions. Toolbars can be hidden, or
relocated as required, with the exception of the Map Tools toolbar, which is
permanently docked within the Map Results window.
W I N D O W S A N D PA N E L S
The QuantiQa Client windows act, together with the toolbars, as the main
user interface. Certain windows also include collapsible panels. Windows,
together with any panels that they might include, can be hidden, or relocated
as required. Panels can only be collapsed or expanded, within the parent
window, and cannot be individually repositioned.
T H E S TAT U S B A R
The Status Bar displays information about any current application activity,
and for example, whether the keyboard Number Lock is on, and so on. In
general, it functions in a similar way to the status bars of many other
Microsoft Windows based applications. The position of the Status Bar is
fixed, and it cannot be relocated elsewhere, although it may be hidden.
MO VE T H E MA IN ME NU , A TO OL B AR , OR A WIN DO W
To move the Main Menu, a toolbar, or a window:
1.
Click and hold the Toolbar Control Handle, or the Window Title bar.
Toolbar
Control
Handles
F I G U R E 2.2: T O O L B A R C O N T R O L H A N D L E S .
2.
Drag to the required location on your screen, and release the mouse
button.
Result:
NOTE:
When you drag a Default window (please refer to Chapter 5,
Windows And Panels, Dialog, Or Default Windows for further
details about Default windows), docking areas display, on either side,
at the top, or at the bottom of the Main Window.
If you drag a toolbar, or Default window, outside the boundaries of the
Main Window, it becomes a floating toolbar, or window.
The following chapters describe in detail, the features and functions of each
of the QuantiQa Client Main Window components, with the exception of
the Title Bar and Status Bar. Please refer to Microsoft Windows
documentation for information about these two bars.
New.
View.
Tools.
Help.
F I G U R E 3.1: T H E M A I N M E N U .
NOTE:
The User Group that you belong to, and your assigned User Rights,
determine whether or not you can access individual windows, dialogs
and so on, through menu lists. For further information, please contact
your system administrator.
T HE N EW M ENU
F I G U R E 3.2: T H E N E W M E N U .
The New menu is a selectable list of commands, which enable you to open
new tool dialogs and result windows or, for example, create charts and
presets. The resultant windows are referred to here, as User Defined
windows. In addition, the New Menu also includes the QuantiQa Client Exit
command.
NOTE:
Please refer to Figure 3.2: The New Menu, for the icon that is
associated with each New Menu command.
N E W P R O T O C O L A N A LY Z E R
When clicked, a new Protocol Analyzer window displays. This may only be
used however, in conjunction with a Ticket List window, to display
messages/Packet Data Units (PDU), which have been generated and
stored by Netledge.
N E W M A P R E S U LT W I N D O W
When clicked, a new Map Result window displays. This can be used to
display a map showing, for example, cell locations and their associated
data. A Map Result window can be populated automatically, prior to running
a query, by selecting Managed Objects (MO) in the MO Selection window.
In addition, the Map Result window can also be populated, by dragging
result data from another window, or a Preset from the Preset Selection
window.
N E W TA B L E R E S U LT W I N D O W
When clicked, a new Table Result window displays. This can be used to
display a table showing, for example, results of a query. You can populate
the Table Result window, once Managed Objects have been selected, by
dragging a Preset from the Preset Selection window.
N E W C H A R T R E S U LT W I N D O W
When clicked, a new Chart Result window displays. This can be used to
display a chart showing, for example, results of a query. You can populate
the Chart Result window, once Managed Objects have been selected, by
dragging result data from another window.
EXIT
When clicked, the QuantiQa Client application closes.
NOTE:
For further details about each of the dialogs and windows listed in the
New menu, please refer to the appropriate chapter, or section, in this
Manual.
Click New.
Result:
2.
T HE V IEW M ENU
F I G U R E 3.3: T H E V I E W M E N U .
The View menu is a selectable list of all the toolbars and windows that are
available within the Main Window. This list enables you to display, or hide,
any QuantiQa Client window or toolbar, or to locate one, for example, if it
cannot immediately be seen on your screen.
10
User Defined windows, created using the New menu commands, are also
included in a separate dropdown list, accessible through the Windows list
item. You cannot however, use the View menu to hide User Defined
windows.
View menu list items, which are already displayed on your screen, have
their icon highlighted with, for example, a blue background.
Toolbars.
Console.
(Drill Down Config.).
Drill Down Filter.
Drill Down Ticket Finder.
Alarm List.
Alarm Log.
(Table Tester).
Main Selection.
MO Selection.
Counters Selection.
Preset Selection.
Dashboard.
Windows.
NOTE:
For further details about each of the windows and dialogs listed in the
View menu, please refer to the appropriate chapter, or section, in this
Manual.
IMPORTANT:
Although they display in the View menu, the Drill Down Config. and
Table Tester items are currently for development purposes only, and
are not available for use by QuantiQa Client users, at the present
time. No further information about these items is provided here.
Details of the Alarm List and Alarm Log windows, as well as the
Dashboard, are given in separate documentation to this QuantiQa
Client User Manual, and are not described further here. For more
information, please contact your CommProve representative.
11
NOTE:
Please refer to Figure 3.3: The View Menu, for the icon that is
associated with each View menu item.
TOOLBARS LIST
F I G U R E 3.4: T H E T O O L B A R S L I S T.
The Toolbars list includes all QuantiQa Client toolbars:
NOTE:
For further details about each of the toolbars listed under Toolbars,
please refer to the appropriate chapter, or section, in this Manual.
If a toolbar is visible, a highlighted check mark (9) displays, next its name in
the Toolbars list, with the exception of the Time Grid (which has its own
icon). If a toolbar is active, but hidden, it will reappear in its stored location,
when QuantiQa Client is restarted.
WINDOWS LIST
F I G U R E 3.5 : A N E X A M P L E O F A W I N D O W S S E L E C TA B L E L I S T.
The Windows list includes any User Defined windows that you have
created in the current session. Windows are added automatically to the list,
as they are generated. Figure 3.5 is an example of how the Windows list
appears.
12
D I S P L AY, H I D E , O R L O C AT E A V I E W M E N U I T E M
To toggle the display of, or locate, a View menu item:
1.
Click View.
Result:
2.
3.
T HE T OO LS M ENU
F I G U R E 3.6: T H E T O O L S M E N U .
The Tools menu is a selectable list of commands that enable you to open a
range of windows and dialogs, which are used to manage the administrative
settings of QuantiQa Client.
TO OL ME NU COM M ANDS
The Tool menu includes the following:
Options...
Import PA Symbols...
User Administration...
Change User...
Change Password...
KPM Rules...
IMSI List Configuration...
Alarm Configuration.
13
O P T I O N S ...
When clicked, the Options window displays. This enables you to manage,
for example, different Protocol Analyzer and Application settings.
I M P O R T PA S Y M B O L S ...
When clicked, the Import PA Symbols window displays. This enables you,
for example, to load a file containing name definitions for point code pairs.
U S E R A D M I N I S T R AT I O N ...
When clicked, the User Administration window displays. This enables you,
for example, to create User Groups, and define User Rights. In Figure 7,
User Administration... appears gray, which indicates that the current user
does not have the User Rights to access the User Administration window.
This QuantiQa Client User Guide does not include, in detail,
information about how to define User Rights. For further information,
please contact your system administrator, or your CommProve
representative.
C H A N G E U S E R ...
When clicked, the QuantiQa Client System Login dialog displays. This
enables a different user to log on and use the QuantiQa Client application.
C H A N G E PA S S W O R D ...
When clicked, the Please Change Password dialog displays. This enables
you to change your Password.
KPM R U L E S ...
Details of the KPM Rules functionality are provided in separate
documentation to this QuantiQa Client User Manual, and are not
described further here. For more information, please contact your
CommProve representative.
IMSI L I S T C O N F I G U R AT I O N ...
Details of the IMSI List Configuration functionality are provided in
separate documentation to this QuantiQa Client User Manual, and
are not described further here. For more information, please contact
your CommProve representative.
14
A L A R M C O N F I G U R AT I O N .
Details of the Alarm Configuration functionality are provided in
separate documentation to this QuantiQa Client User Manual, and
are not described further here. For more information, please contact
your CommProve representative.
NOTE:
For further details about each of the windows and dialogs listed in the
Tools menu, except for those described in other documentation, as
explained previously, please refer to the Tools chapter, in this Manual.
Click Tools.
Result:
2.
T HE H ELP M ENU
F I G U R E 3.7: T H E H E L P M E N U .
The Help menu is a selectable list, which enables you to access a range of
QuantiQa Client documentation.
NOTE:
Some documentation may be client specific, and only available to
them.
You can also display information about the version of QuantiQa Client that
you are using.
15
User Guide.
A Interface Ticket Description.
Abis Interface Ticket Description.
About QuantiQa.
USER GUIDE
When clicked, the QuantiQa Client User Manual displays, in *.pdf format.
A I N T E R FA C E T I C K E T D E S C R I P T I O N
When clicked, A Interface Ticket Description documentation displays, in *.pdf
format.
A B I S I N T E R FA C E T I C K E T D E S C R I P T I O N
When clicked, Abis Interface Ticket Description documentation displays, in
*.pdf format.
ABOUT QUANTIQA
When clicked, details about the version of QuantiQa Client that you are
using, display.
NOTE:
For further details about the contents of each document in the Help
menu list, please refer to the document itself.
Click Help.
Result:
2.
16
Toolbars
This chapter describes the QuantiQa Client Toolbars. By default, these
display beneath the Main Menu. You can however, reposition the toolbars
anywhere on your screen, as described in Chapter 2, QuantiQa Client
Main Window, Move The Main Menu, A Toolbar, or A Window.
QuantiQa Client includes the following toolbars:
New.
Time Grid.
T HE N EW T OOLBAR
F I G U R E 4.1: T H E N E W T O O L B A R .
The New toolbar functions in a similar way to the New menu, in the Main
Menu, and enables you to open new tool dialogs and result windows or, for
example, create charts and presets. The resultant windows are referred to
here, as User Defined windows.
The New toolbar consists of a series of buttons, together with a downwards
facing arrow, which provides access to a list of current User Defined
windows.
Procedure List.
Protocol Analyzer.
Trace Diagram.
Map Result Window.
Table Result Window.
Chart Result Window.
Chart Builder.
Preset Editor.
17
NOTE:
For a description of the results of clicking individual toolbar buttons,
please refer to, for example, New Procedure List, or New Map
Result Window and so on, under The New Menu, New Menu
Commands, in Chapter 3, The Main Menu.
F I G U R E 4.2: T H E T I M E G R I D T O O L B A R .
The Time Grid toolbar enables you to configure the Result Output Period
(ROP), and the query time interval(s) on a daily basis, for example, from
3pm to 6pm and 8pm to 10pm. It consists of:
F I G U R E 4.3: T H E M O D E B U T T O N .
The Mode button turns the defined time slots on, or off. To use:
1.
2.
18
Toolbars
T H E ROP S E L E C T I O N B U T T O N
F I G U R E 4.4: A N E X A M P L E O F T H E ROP S E L E C T I O N B U T T O N .
The ROP Selection button allows you to select the ROP that is suitable for
your network configuration. Its appearance changes, according to the ROP
currently selected. Possible ROP options are:
1 hour ROP.
30 minutes ROP.
15 minutes ROP.
5 minutes ROP.
To use:
1.
F I G U R E 4.5: T H E ROP S E L E C T I O N D R O P D O W N L I S T.
2.
NOTE:
Exactly how data is displayed for the selected ROP, depends on the
actual ROP duration that is acquired from the server.
19
F I G U R E 4.6: E X A M P L E S O F T I M E S L O T S E L E C T I O N G R I D .
NOTE:
The Time Slot Selection grid displays a scroll bar, as required, to
allow you to see the full 24 hour period.
The Time Slot Selection grid enables you to define the query time
interval(s) for the selected day. A 24 hour period is subdivided into different
numbers of selectable time slots, according to the ROP that has been
chosen.
D E F I N E A Q U E RY T I M E I N T E R VA L
To define a query time interval:
1.
II.
III.
I.
Click and hold the left mouse button, over the first time slot in a
time interval, then drag your mouse, until you come to the last
time slot of the required period.
II.
or:
20
Toolbars
3.
Press <CTRL> and repeat step 1, until you have defined all required
query time intervals for the selected day.
Result:
NOTE:
When you use the Time Slot Selection grid to define query selection
intervals for a particular day, they do not have to be consecutive, and
can take place any time during the 24 hour period.
21
22
T YPES O F W INDOW
The QuantiQa Client has two main types of window:
D I A L O G , O R D E FA U LT W I N D O W S
Dialog, or Default windows are where you make selections, or enter
commands, which allow you, for example, to access a server, or configure a
query. They are available as soon as you have logged on, and cannot be
closed, although they may be hidden.
S H O W O R H I D E A D E FA U LT W I N D O W
The visibility of Default windows is controlled by using the View menu. For
further details please refer to Chapter 3, The Main Menu, The View
Menu. You may also do the following:
1.
Click the X button, positioned to the left of the window's Title Bar.
Result:
As an alternative, you can follow the steps given in the next section,
Current Windows list.
2.
Select a window.
Result:
23
PA N E L S
Certain windows, especially the Main Selection window, include collapsible
Panels. These allow you to configure, for example, individual elements of a
query, such as the date, or time slot. Panels are docked within their parent
window, and move, or are hidden, with them.
F I G U R E 5.1: T H E U S E R D E F I N E D W I N D O W T I T L E B A R .
Besides the window's name, the User Defined window Title Bar includes:
1.
F I G U R E 5.2: T H E O P T I O N S D R O P D O W N L I S T.
24
2.
Floating.
Changes the window to a floating window, which can be
positioned as required.
Dockable.
Displays the Main Window docking areas when the window is
dragged.
Tabbed.
Positions the window in a fixed location, within the Main Window,
and displays it as a tabbed window. To see the positioning of
tabbed windows, please refer to Chapter 1, QuantiQa Client
Main Window, Figure 1: QuantiQa Client Main Window.
Autohide.
Appears gray, to indicate that this feature is not currently
available.
Hide.
Hides the window.
25
W I N D O W S W I T H TA B L E S
Column Chooser Button
F I G U R E 5.3: E X A M P L E O F A TA B L E W I N D O W .
Table windows are laid out in a grid, with the top row displaying the heading
for each column. When a table is initially generated, the order of the rows is
determined by the alphabetical order of the contents of the first column. You
may however, rearrange the table contents in the following ways:
COLUMN ORDER
The column order can be rearranged as follows:
1.
2.
Drag the heading to the place you want it, in the column order.
3.
To hide a column:
24
1.
2.
3.
NOTE:
The column can be restored, by using the Field Chooser, as
described later in this chapter.
COLUMN WIDTH
To adjust the column width:
1.
In the heading row, click and drag the column boundary line.
Result:
COLUMN GROUPING
Columns may be ordered in a hierarchical group, to reorganize the table as
required, by doing the following:
1.
2.
3.
4.
Click the arrowhead, positioned to the right of the box that represents
a column, in the Drag and Drop Area.
Result:
Click "+", positioned to the left of the relevant row in the display, to
expand it, or "-", to collapse it.
Result:
Columns can be returned to the original table, from the hierarchical group,
as required.
25
1.
Click and hold the box representing the column in the Drag and
Drop Area.
a.
b.
or:
II.
Result:
F I G U R E 5.4: E X A M P L E S O F C O L U M N G R O U P I N G .
26
F I G U R E 5.5: T H E F I E L D C H O O S E R W I N D O W .
The Field Chooser displays a selectable list of all of those columns that are
in the Drag and Drop Area, as well as any that are hidden. It can be used,
for example, to restore columns to the table.
To restore a column:
1.
Click the Column Chooser button, located in the toolbar at the top of
the table window.
Result:
2.
Click and hold the Field Chooser list entry, which you want to restore.
3.
4.
OTHER WINDOWS
In addition to the main types of window, QuantiQa Client displays, as
required:
I N F O R M AT I O N W I N D O W S
These provide information only. They require no user interaction, apart from,
perhaps, the need to click an OK, or Close button to continue.
DIALOGS
These allow you to make selections, or enter commands, while you are
using the toolbars and the main types of window.
27
28
Tools
This chapter describes the windows and dialogs that belong to the tools
listed in the Tools menu. For further information about the Tools menu and
how to use it, please refer to "Chapter 3, The Main Menu, The Tools
Menu".
The Tools menu provides access to the following windows and dialogs:
Options...
Import PA Symbols...
User Administration...
Change User...
Change Password...
KPM Rules...
IMSI List Configuration...
Alarm Configuration.
O PTIONS
F I G U R E 6.1: T H E O P T I O N S W I N D O W .
29
Protocol Analyzer.
General.
Fonts and Colors.
Ticket Viewer.
NOTE:
The Ticket Viewer also includes a sub-category called General.
However, this opens the same window as its parent list entry.
Application.
To use:
1.
P R O T O C O L A N A LY Z E R
F I G U R E 6.2: T H E O P T I O N S W I N D O W , W I T H T H E P R O T O C O L A N A LY Z E R
LIST ITEM SELECTED.
NOTE:
If you select the Protocol Analyzer sub-category General, the same
window as the one opened for its parent list entry displays.
30
Tools
NOTE:
For real-time protocol analysis, name resolution on an individual PDU
basis, may increase the time required to process data.
To use the Options Protocol Analyzer, and Options Protocol Analyzer
General windows:
1.
Click the arrowhead to the right of the box under PDU Cyclic Buffer
Size.
Result:
2.
3.
The dropdown list closes, and the box is updated with the
new buffer size.
Click the arrowhead to the right of the box under PDU Range Buffer
Size.
Result:
4.
The dropdown list closes, and the box is updated with the
new buffer size.
5.
6.
31
P R O T O C O L A N A LY Z E R F O N T S A N D C O L O R S
F I G U R E 6.3: T H E O P T I O N S W I N D O W , W I T H T H E P R O T O C O L A N A LY Z E R
FONTS AND COLORS LIST ITEM SELECTED.
The Options Protocol Analyzer Fonts and Colors window displays
controls to the right, which are used to set the downlink and uplink
background, and foreground colors. To use:
1.
2.
3.
4.
32
Tools
TICKET VIEWER
F I G U R E 6.4: T H E O P T I O N S W I N D O W , W I T H T H E T I C K E T V I E W E R
LIST ITEM SELECTED.
The Options Ticket Viewer window displays controls to the right, which are
used to set the Ticket Cyclic Buffer and Ticket Range Buffer sizes.
If the Flatten All Fields check-box is selected, tickets display in a format
similar to that of earlier versions of QuantiQa Client. The hierarchical ticket
view, which is available when using the advanced ticket filtering
functionality, is disabled.
NOTE:
For further details about advanced ticket filtering, please refer to
the QuantiQa Client User Manual, Part 2.
To use the Options Ticket Viewer window:
1.
Click the arrowhead to the right of the box under Ticket Cyclic Buffer.
Result:
2.
3.
The dropdown list closes, and the box is updated with the
new buffer size.
Click the arrowhead to the right of the box under Ticket Range Buffer.
Result:
4.
The dropdown list closes, and the box is updated with the
new buffer size.
33
5.
6.
A P P L I C AT I O N
F I G U R E 6.5: T H E O P T I O N S W I N D O W , W I T H T H E A P P L I C AT I O N
LIST ITEM SELECTED.
The Options Application window displays, with the following check boxes
to the right:
Use cache.
This check box is redundant, and no longer functions.
34
Tools
Ticket Definition And PDU NEID Sync enables you to set a timeout, in
seconds, which is applied when the system synchronizes PDU NEIDs and
ticket definitions. In this way, potentially long waits can be avoided.
To use the Options Application window:
1.
2.
If you want to set a timeout for PDU NEIDs and ticket definition
synchronization:
3.
I.
II.
closes,
and
the
35
M A P R E S U LT S
F I G U R E 6.6: T H E O P T I O N S W I N D O W , W I T H T H E M A P R E S U LT S
LIST ITEM SELECTED.
The Options Map Results window displays, with the following Timing
Advance Radius and NaN painting selection choices to the right:
2G timing advance.
Allows you to choose either the default timing advance radius setting
of 550 meters, or define a custom setting.
3G propagation distance.
Allows you to choose the preset propagation distances, of 117 meters,
or 234 meters, or define a custom setting.
The settings are saved and applied to existing and future maps, including
those generated in new sessions, until the settings are changed.
To use the Options Map Results window:
1.
or:
36
I.
Click Other.
II.
Tools
2.
or:
I.
Click Other.
II.
3.
3.
I MPORT PA S YMBOLS
F I G U R E 6.7: T H E I M P O R T PA S Y M B O L S W I N D O W .
The Import PA Symbols window displays controls that are used load a
locally stored *.csv formatted file, which contains the name resolution
definitions for pointcode pairs, to MSC, BSC and LACs to BSCs. As a result,
names display instead of numbers, when the the NEID list is
resynchronized.
Once a file has been loaded locally, an administrator with the appropriate
User Rights, can store the name resolution definitions on a GSP server.
Other users may then receive them automatically, when they log on to that
server.
37
Click ..., positioned to the right of the Import File input field.
Result:
2.
Navigate to the folder where the *.csv formatted file is stored on your
computer.
4.
5.
Click Open.
Result:
6.
Click Load.
Result:
7.
8.
closes,
and
the
S TO R E N A M E R E S O L U T I O N D E F I N I T I O N S O N A S E R V E R
To store the name resolution definitions on a server:
1.
2.
Click Store.
Result:
3.
closes,
and
the
M A N U A L LY D O W N L O A D D E F I N IT I O N S F R O M A S E R V E R
To manually download definitions from the server:
1.
Click Retrieve.
Result:
2.
38
closes,
and
the
Tools
A U T O M AT I C A L LY D O W N L O A D D E F I N IT I O N S F R O M A S E R V E R
To automatically download name resolution definitions from a server:
1.
2.
Select Options.
Result:
3.
4.
5.
C HANG E U SER
F I G U R E 6.8: T H E S Y S T E M L O G I N D I A L O G .
The Change User tool opens the System Login dialog, and allows a
different user to enter their user name, and password, to log on to QuantiQa
Client.
39
C HANGE PASSWORD
F I G U R E 6.9: T H E P L E A S E C H A N G E P A S S W O R D D I A L O G .
The Please Change Password dialog and allows you to define a new
password. To use:
1.
2.
3.
4.
NOTE:
Passwords must include at least one uppercase character, and a
special character or number.
40
Tools
KPM R ULES
F I G U R E 6.10: T H E KPM R U L E A D M I N I S T R AT I O N W I N D O W .
F I G U R E 6.11: T H E IMSI L I S T C O N F I G U R AT I O N W I N D O W .
41
A LARM C ONFIGURATION
F I G U R E 6.12: T H E A L A R M A N D R E P O R T C O N F I G U R AT I O N W I N D O W .
42
Default Windows
Default windows are the main user input interface with the QuantiQa Client
application. They are accessible as soon as you log on, and are always
available while QuantiQa Client is running. The Default windows include:
The Default windows are presented in the following chapters, in the logical
sequence in which they are generally used.
or:
I.
II.
Result:
43
44
F I G U R E 8.1: T H E M A I N S E L E C T I O N W I N D O W ,
W I T H C O L L A P S E D A N D E X PA N D E D P A N E L S .
This chapter describes the Main Selection window, and the control panels
that it includes. For an overview of how to use the Main Selection window,
please refer to the QuantiQa Client Getting Started Guide.
45
Server Selection.
Access the appropriate server and database.
Date Selection.
Select the query start and end dates, using input fields.
Calendar Selection.
Select the query start and end dates, using a calendar display.
NOTE:
The Day Time Slot panel can only be used to select a continuous time
interval. To define multiple time intervals for the same day, the Time
Grid Toolbar should be used. For further information about the Time
Grid Toolbar, please refer to the Toolbars chapter of this Manual.
Aggregation Mode.
Define the required level of Result Output Period (ROP) aggregation.
E X PA N D O R C O L L A P S E A C O N T R O L PA N E L
To toggle the visibility of a control panel:
1.
F I G U R E 8.2: T H E S E R V E R S E L E C T I O N PA N E L .
The Server Selection panel displays at the top of the Main Selection
window, and consists of the Server Selection list. This is populated when
you start QuantiQa Client, and contains information extracted from the
server.cfg file, related to available servers.
NOTE:
Even if a server is listed as being available, this does not mean that it
is currently accessible.
46
ACCESS A SERVER
To access a server:
1.
Set a valid query date, using either the Date Selection panel, or the
Calendar Selection panel.
NOTE:
By setting a valid query date before selecting a server, and provided
that the server connection is successful, you ensure that the MO
Selection window is populated with a list of all relevant managed
objects.
For further information about the Date Selection panel, or the Calendar
Selection panel, please refer to the relevant sections, later in this chapter.
For further information about the MO Selection window, please refer to the
"MO Selection Window" chapter, later in this Manual.
2.
NOTE:
There may be a slight delay between clicking the Server Name, and
the Monitor Icon being highlighted. This is due to several factors,
including the network configuration, available bandwidth, and so on.
2.
If the server that you wish to access is not displayed in the Server List, or
the list is empty, as a first step:
1.
Ensure that the server.cfg file contains all the details for the required
server(s).
2.
Ensure that the server.cfg file table is correctly aligned and tabbed.
You must restart QuantiQa Client, after making any changes to the
server.cfg file.
For further information about the server.cfg file, please refer to Appendix
1: The Server Configuration File.
47
F I G U R E 8.3: T H E D AT E S E L E C T I O N P A N E L .
The Date Selection panel displays beneath the Server Selection panel,
within the Main Selection window. It consists of two directly editable, or
alternatively, scrollable date fields, which enable you to define the query
Start and End dates. The query End date can be the same as the Start
date, or later. To use:
1.
Type the Start date in the top date field, using the format
dd/mm/yyyy.
II.
or:
I.
II.
Result:
The Start and End dates are set, and the Calendar
Selection panel is automatically updated accordingly.
NOTE:
The Date Selection panel is used to define a single, continuous range
of dates only. If you want to select multiple date ranges, or a group of
non-continuous dates, you must use the Calendar Selection panel.
The Date Selection panel includes 2 additional scrollable fields,
positioned to the right of each date field. These are currently inactive.
48
F I G U R E 8.4: T H E C A L E N D A R S E L E C T I O N PA N E L .
NOTE:
Not all of the Calendar Selection panel controls are described in
detail here. Their use is generally very intuitive however, and require
little, if any explanation.
C A L E N D A R S E L E C T I O N PA N E L C O N T R O L B U T TO N S
The Calendar Selection panel includes the following buttons, positioned at
the top of the panel:
If the selected calendar range covers a long period, these buttons may be
used to exclude their relevant days from the query. The buttons are
highlighted, when active.
In addition, the Calendar Selection panel includes the Today button,
positioned at the bottom of the panel. This is used to select today's date.
T H E C A L E N D A R S E L E C T I O N PA N E L C A L E N D A R D I S P L AY
The Calendar display is the main query date selection interface. When a
calendar date range is selected, it is highlighted on the Calendar display in
orange. If the current month is displayed, today's date is highlighted by a
square, with no fill color, unless today's date is part of a selection, in which
case, the fill color will also be orange.
49
S E L E C T A C A L E N D A R D AT E R A N G E
The following are examples of how you can select a calendar date range.
or:
I.
Click and hold the left mouse button over the months name.
Result:
II.
Scroll up, or down the list, while still holding the mouse button.
III.
S E L E C T A D AT E O R D AT E R A N G E
To select, or deselect a date:
1.
II.
III.
or:
I.
Click and hold the left mouse button over one date in the
Calendar display.
II.
Drag the mouse, while still holding the left button, to include
further dates.
III.
IV.
NOTE:
When a calendar date range is selected, the Date Selection panel is
automatically updated. However, if the calendar date range is not
continuous, the Date Selection panel is disabled, as it cannot be used
to define non-continuous ranges of dates.
50
F I G U R E 8.5: T H E D AY T I M E S L O T S E L E C T I O N P A N E L .
The Day Time Slot Selection panel is used to define a single, continuous
query time interval, for each date selected. It consists of two directly
editable, or alternatively, scrollable time selection fields, which enable you
to define the query Start and End times. The start and end times are
displayed in hours and minutes. To use:
1.
Select the Result Output Period (ROP) that is suitable for your
network configuration, using the ROP Selection button on the Time
Grid toolbar.
NOTE:
The ROP determines the data retrieval frequency. For example, if the
ROP is 1 hour, the data retrieval interval can only be set in multiples of
one hour. But if the ROP is 30, 15, or 5 minutes, the data retrieval
interval can be set to multiples of the respective, and as a result,
shorter time unit.
If the Result Output Period (ROP) is set to 1 hour, the minute selection
display appears gray.
For further information about selecting the ROP, please refer to the
Toolbars chapter of this Manual, or the QuantiQa Client Getting Started
Guide.
2.
II.
or:
I.
II.
Result:
The Start and End times are set, and t he Time Grid toolbar
displays the query time interval selected, as a red band.
NOTE:
The Day Time Slot panel can only be used to configure a single,
continuous interval. If you require multiple time intervals for the same
day, you must use the Time Slot Selection grid to define them.
For further information about the Time Slot Selection grid, please refer to
the Toolbars chapter of this Manual, or the QuantiQa Client Getting
Started Guide.
51
F I G U R E 8.6: T H E A G G R E G AT I O N M O D E S E L E C T I O N PA N E L .
The Aggregation Mode Selection panel is used to define the required
amount of ROP aggregation. The statistical data, which is retrieved from the
server during each time interval, is accumulated according to the settings
made in this panel.
T I M E B A S E D A G G R E G AT I O N
The Aggregation Mode Selection panel has the following buttons, to define
time based aggregation:
All.
Accumulate the data as one value for the whole time interval.
Day.
Accumulate the data as one value for each day of the time interval.
Hour.
Accumulate the data for each ROP, throughout the whole time interval.
NOTE:
This results in no more than 24 values, when the ROP is set to
1 hour.
MO H I E R A R C H Y, H I E R A R C H Y L E V E L A N D P R O P E R T Y B A S E D
A G G R E G AT I O N
The Aggregation Mode Selection panel includes a selectable dropdown
list, positioned to the right of the Detail field. This enables you to define
aggregation according to the hierarchical structure of the database, the level
within the hierarchy. or Managed Object properties. The contents of the
dropdown list vary, according to the individual network configuration.
52
F I G U R E 8.7 : A G G R E G AT I O N M O D E S E L E C T I O N PA N E L D R O P D O W N L I S T.
Many networks are subdivided into hierarchical groups. These may include,
for example, networks, clusters, and members, or be far more complex,
according to each individual operator's specific environment. QuantiQa
Client allows data to be collected from each level of the hierarchy, and
enables you to aggregate the results as required.
For example, you may want a report that summarizes the results of a query
at the cluster hierarchical level. QuantiQa Client adds all cluster member
data together, and presents the cluster totals in the report. Aggregation at
the network level is carried out in the same way, while individual member
information remains available from the database, if required.
HIERARCHICAL LEVELS
The hierarchical levels that are supported vary according to each cellular
network, combined with the type of data being monitored, and the collection
methods being deployed. However, one common hierarchy that is supported
for most networks is:
Controller > Cell Sector > TRX.
These hierarchy levels in particular, provide essential quality and location
information, within the radio network. Other hierarchies may include, for
example, cell neighbor relationships, or other interactions with network
equipment, such as Mobile Switching Centers (MSC) and Home Location
Registers (HLR).
53
BSC.
Query results are reported at BSC level (one result for each unique
BSC selected).
Cell.
Query results are reported at Cell level (one result for each unique
Cell selected).
TRX.
Query results are reported at TRX level (one result for each unique
TRX selected).
All.
Query results are reported as one single value, which includes the
results for all the Managed Objects selected.
RE-HOMING MANAGEMENT
An additional hierarchical level, Cell NOREHOM, may also be displayed in
the Aggregation Mode Selection dropdown list. This level enables you to
manage the re-parenting or re-homing of a cell, and allows measurements to
be displayed independent of the current parent MO.
F I G U R E 8.8 : C E L L L E V E L A G G R E G AT I O N ,
D I S P L AY I N G T H E C E L L W I T H T W O PA R E N T MO S .
54
PROPERTIES
Property based aggregation allows you to query the database, and view the
results for a hierarchy, or hierarchical level, organized according to defined
MO properties, such as the technology used, or geographical location.
Property-based aggregation entries in the Aggregation Mode Selection
panel dropdown list, can be readily identified, through the '@' character at
the beginning of the name, for example, @Cell.Technology. In this instance,
the hierarchical level is 'Cell', and 'Technology' is the property.
55
56
F I G U R E 9.1: T H E MO S E L E C T I O N W I N D O W .
This chapter describes the MO Selection window, the controls that it
includes, and the Managed Object list. For an brief introductory overview of
how to use the MO Selection window, please refer to the QuantiQa Client
Getting Started Guide.
T HE MO S ELECTION W INDOW
The MO Selection window consists of:
57
58
Click the '+' button, to the left of the relevant top-level MO.
Result:
F I G U R E 9.2: T O P - L E V E L MO W I T H D R O P - D O W N H I E R A R C H I C A L L I S T D I S P L AY E D .
NOTE:
When a drop-down list is displayed, this can influence whether MOs in
a hierarchy are shown in a Result window. For further information,
please refer to the "MO Visibility" section, later in this chapter, and
the "Map Result Window" chapter, later in this Manual.
T H E MO S E L E C T I O N T O O L B A R
F I G U R E 9.3: T H E MO S E L E C T I O N T O O L B A R .
The MO Selection toolbar includes controls that enable you to display
managed object lists, select the objects to be queried, and toggle the
visibility of selected MOs. It has the following buttons:
Global MO List.
Result Window MO List.
Highlight All.
Remove Highlight From All.
Invert Highlighting.
Toggle Visibility.
59
Lock Visibility.
Select All Highlighted MOs.
Deselect All Highlighted MOs.
Toggle Selection of All Highlighted MOs.
Find MO.
Column or Field Chooser.
Collapse All Groups.
Expand All Groups.
Query Server to Expand All MOs.
G L O B A L MO L I S T
This button displays all available objects, within the Managed Object list.
Initially only the top-level MOs are visible.
R E S U LT W I N D O W MO L I S T
This button displays, within the Managed Object list, only the objects that
are present in a Result window, such as a map, chart, or table.
Because queries are processed from the latest data on the server,
without direct reference to the MO Selection window, the MOs listed
before running a preset, may differ to those shown afterward. This
may occur when for example, the server sends results for MOs that
have been expanded, or aggregated, differently to those in the original
Managed Object list. In most cases, the lists before and after a query
will be the same, however this is not always so.
This also means that if a preset is run multiple times, the results may
differ for each run. This is especially true if, for example, the visibility
of MOs in a Result window is changed, before rerunning the preset.
HIGHLIGHT ALL
This button highlights every MO within the Managed Object list.
60
INVERT HIGHLIGHTING
This button highlights those MOs within the Managed Object list, which
previously were not highlighted, and removes the highlighting from those
that were.
NOTE:
MOs are highlighted in order to either bulk select them for inclusion in
a query, or to toggle their visibility in a Result window.
TOGGLE VISIBILITY
This button toggles the visibility of the highlighted MOs in a Result window,
between on and off. The Lightbulb icon, positioned to the left of a managed
object, changes between yellow for on, and blue for off, and the MOs
visibility in a query Result window, is updated accordingly.
The Toggle Visibility button is only available when the Lock Visibility
button is set to unlock. For further information, please refer to the Lock
Visibility button, below.
LOCK VISIBILITY
This button locks and unlocks the visibility of MOs in a Result window.
When this button is clicked (the default state), visibility is locked, and only
the MOs that are selected to be used when running a query, are displayed in
a Result window. In addition, the Show Only Expanded Rows button, on
the Map Top toolbar, in a Map Result window, is deactivated. For further
information about the Show Only Expanded Rows button, please refer to
the "Map Result Window" chapter, later in this Manual.
When visibility is unlocked, you can independently determine which MOs
display in a Result window, regardless of whether they are to be used when
running a query. For further information about the visibility of an MO in a
Result window, please refer to the "MO Visibility" section, later in this
chapter.
NOTE:
If you manually select which MOs display when visibility is unlocked,
and later click the Lock Visibility button, all MOs that are not selected
to be used when running a query, will no longer show in the Result
window.
S E L E C T A L L H I G H L I G H T E D MO S
This button selects all highlighted MOs, ensuring that they are used when
running a query. The tick-box to the left of each MO is checked accordingly.
If the Lock Visibility button is clicked, the relevant MOs are shown in a
Result window, when displayed. If visibility is not locked, you need to set it
manually.
D E S E L E C T A L L H I G H L I G H T E D MO S
This button deselects all highlighted MOs, to remove them from a query. The
tick-box to the left of each MO is unchecked accordingly.
61
If the Lock Visibility button is clicked, the relevant MOs are not shown in a
Result window, when displayed. If visibility is not locked, you need to
remove MOs from the Result window display manually.
TOGGLE SELECTION
OF
A L L H I G H L I G H T E D MO S
This button toggles the selection of all highlighted MOs, so that those
previously selected are deselected, and those not selected are now marked
for use in a query. The state of the tick-box to the left of each MO is
changed accordingly.
If the Lock Visibility button is clicked, the MO visibility in a Result window
is changed accordingly. If visibility is not locked, you need to change it
manually.
F I N D MO
This button locates the chosen MO within a Map Result window, and
highlights it. The cell within the map turns red, and blinks briefly.
COLUMN
OR
FIELD CHOOSER
E X PA N D
ALL
GROUPS
This button expands all column groupings , within the Managed Object list.
A minus sign (-) displays next to the name of column groupings that are
expanded.
For further information about the column groupings, please refer to the
"Windows And Panels" chapter of this Manual.
Q U E RY S E R V E R
TO
E X PA N D A L L MO S
This button initiates a server query, and results in the drop-down lists, for all
top-level MOs, being expanded to display the most up-to-date data
regarding the associated MO hierarchy. When clicked, the following window
displays:
62
F I G U R E 9.4: T H E E X PA N D A L L MO S W I N D O W .
Click Yes to proceed (or NO to abort).
MO S E L E C T I O N F I LT E R
The MO Selection toolbar also includes a filter that allows you to further
refine the contents of the Managed Object list.
F I G U R E 9.5: T H E MO S E L E C T I O N F I LT E R .
To use:
1.
2.
You can filter the Managed Object list further, by selecting Filter
Incrementally, and then entering the next term in the text field.
A managed object must have one of the last two states, if it is to be included
in a query.
63
NOTE:
When an MO is selected using one of the following methods, it is
normally visible in a Result window. It is possible however, to control
the visibility of an MO, regardless of whether it is selected or not. For
further information, please refer to the "MO Visibility" and "MO
Selection Toolbar" sections.
To select Managed Objects:
1.
Click the tick-box to the left of one top-level MO to select it, and
all the MOs in the associated hierarchy list.
NOTE:
If you click the tick-box next to a top-level MO, all of the
MOs in the associated hierarchical list will automatically
selected, whether the list is expanded, or not.
or:
II.
Do the following:
a.
b.
III.
or:
IV.
Do the following:
a.
b.
c.
d.
or:
V.
64
Do the following:
a.
b.
c.
d.
e.
or:
VI.
Do the following:
a.
b.
Press and hold <CTRL> and click as many additional toplevel MOs as you require, in any order.
c.
d.
The non-continuous series of highlighted, toplevel MOs, together with all of the MOs in the
associated hierarchical lists, are selected.
or:
VI.
Do the following:
a.
b.
c.
b.
c.
d.
Result:
65
NOTE:
Only a limited number of common selection methods are described
above. The MO Selection toolbar includes additional controls that
simplify the selection of complex groups of multiple MOs. For further
information, please refer to the "MO Selection Toolbar" section,
earlier in this chapter.
To help you select MOs on a geographical basis, open a new map window.
MOs are automatically displayed on the map, as you select them.
NOTE:
Provided that the Lock Visibility button, on the MO Selection toolbar,
is active, the selected MOs display on maps without having to run a
query first.
If a Result Table window, or a Result Map window, is open when you
highlight objects in the Managed Object list, the appropriate MO is
automatically highlighted there. Once a query has been run, if you deselect
MOs in the Result Window MO list, for example, to further refine the query,
the corresponding MO in the Managed Object list is also deselected.
MO V I S I B I L IT Y
By default, an MO is only visible in a Result window, if it is selected by
means of its tick-box. It is however, possible to control visibility
independently of whether an MO is selected, or not, as follows:
1.
or:
II.
Do the following:
a.
F I G U R E 9.6: T H E V I S I B I L I T Y I S L O C K E D W I N D O W .
b.
66
Result:
2.
II.
Do the following:
a.
b.
c.
d.
e.
NOTE:
When a top-level MO is made visible, but its hierarchical list is not
expanded before running a query, then only the top-level MO is
displayed in a Map Result window. If the hierarchical list is expanded
at the time of running a query, then all of the relevant MOs are
displayed.
However, if the hierarchical list of a visible top-level MO is expanded
and then collapsed before running a query, the MOs in the list may still
be visible in the Map Result window. The visibility of collapsed
hierarchical lists is controlled by the Show Only Expanded Rows
button, on the Map Top toolbar, in a Map Result window. For further
information about the Show Only Expanded Rows button, please
refer to the "Map Result Window" chapter, later in this Manual.
If an MO in a hierarchical list is made visible, but its respective toplevel MO is not, then only the visible MO displays in a Result window.
MO P R O F I L E A N D G R O U P T O O L B A R
Save Button
Delete Button
F I G U R E 9.7: T H E MO P R O F I L E A N D G R O U P T O O L B A R .
The MO Profile and Group toolbar enables you to define, save, recall and
delete libraries of column groupings and managed objects, as required. It
consists of:
67
Each tool is made up of a directly editable drop-down list, together with save
and delete buttons.
T H E MO P R O F I L E T O O L
This tool is used to save and retrieve, for example, a hierarchical column
grouping, known as a Profile, which has previously been defined in the
Drag and Drop Area of the MO Selection window. For further information
about the Drag And Drop Area, please refer to the "Windows And Panels"
chapter of this Manual.
To save a column grouping:
1.
2.
Enter a name for the grouping in the Profile combined text field and
dropdown list.
3.
To retrieve a grouping:
1.
2.
To delete a grouping:
1.
2.
Ensure that the correct Profile Name displays in the Profile combined
text field and dropdown list.
3.
68
NOTE:
If the Profile dropdown list is empty, no profiles have been saved.
F I G U R E 9.8: T H E MO S E L E C T I O N W I N D O W , D I S P L AY I N G A NAME A N D A N T T Y P E
COLUMN GROUPING.
T H E MO G R O U P T O O L
The MO Group tool is used to save and retrieve a group of selected
managed objects. To save an managed object group:
1
2.
Enter a name for the managed object group in the Group combined
text field and dropdown list.
3.
2.
2.
Ensure that the correct Group Name displays in the Group combined
text field and drop-down list.
3.
NOTE:
If the Group drop-down list is empty, no managed object groups have
been saved.
69
2.
3.
4.
I.
Search Up.
II.
Find All.
III.
Match Case.
70
10
F I G U R E 10.1: T H E P R E S E T S E L E C T I O N W I N D O W .
The Preset Selection window contains two types of Presets:
Predefined presets.
Presets which are included in the installation package. These are
located in the directory under the /preset directory and organized in
directories below /preset.
71
NOTE:
Both presets and directories can be moved by dragging them to
another folder.
F I G U R E 10.2: P R E S E T S E L E C T I O N W I T H T H E C O N T E X T M E N U .
From the Preset Selection window you can edit, execute or delete a preset.
To use:
1.
2.
3.
E DIT A P RESET
Select Edit to modify or edit an existing preset. This will display the Preset
Editor, as in the case of the Disconnection_Analysis preset example below.
F I G U R E 10.3: P R E S E T E D I T O R D I S C O N N E C T I O N S _A N A LY S I S .
Most of the fields can be modified then the file must be saved. You can save
with any file name at any directory location. The Preset Editor is described
in more detail later in this manual.
E XECUTE
P RESET
D ELETE
P RESET
Select Delete to permanently delete a preset from the file system and the
Preset selection list. It is best to backup your file(s) before deleting.
72
11
F I G U R E 11.1: C O U N T E R S S E L E C T I O N W I T H C O U N T E R S .
The Counters Selection window lists the counters that are available from the
active KPM servers. The counters in the list are retrieved from the database
after logging on to the server. The counters are used in the Preset Editor
when building formulas. When adding a counter to a preset, drag and drop it
in the Formula field of a Preset Editor.
As the cursor is moved over each counter in the list, tool tips display a brief
description.
A detailed explanation of the formulas can be found in "QuantiQa Client
User Manual, Part 2: Appendices".
73
74
12
F I G U R E 12.1: T H E T I C K E T F I N D E R W I N D O W .
The Ticket Finder window is the main tool that is used to manage tickets. It
retrieves tickets to user defined filtering rules. To show the Ticket Finder
window click on the Ticket Finder tab under the bottom right corner area of
the Main Window. If the Ticket Finder tab is not visible, go to the View top
menu and click Drill Down Ticket Finder to reveal the Ticket Finder window.
There are three different areas in the Ticket Finder window:
To access tickets:
1.
First select date and time of the investigated time period using the
Tool Buttons Bar.
2.
Then through the Tree View List select the site server and the type of
tickets.
75
3.
Choose any eventual filter to apply using the Ticket Type Fields list.
4.
Click on the Select Interval button to find and list the tickets.
F I G U R E 12.2: T H E T I C K E T L I S T W I N D O W W I T H S E L E C T E D T I C K E T S .
Start/Stop/Pause
Start Time
End Time
Profile
F I G U R E 12.3: T H E T O O L B U T T O N S B A R .
The Ticket Finder Tool Buttons Bar contains all the tools to select the set of
tickets and these are explained in the following section.
76
Refresh
Select This
77
78
Select Interval
Play
Stop
Pause
Play To End
Profile
Save
Delete
F I G U R E 12.4: C A L E N D A R C O N T R O L E X A M P L E .
F I G U R E 12.5: T H E T R E E V I E W L I S T.
The Tree View list is used to identify all the available ticket types produced
within the time interval set by the Tool Buttons Bar. Ticket types are shown
in the Tree View List window, and are grouped under their originating site
server.
Site servers and ticket types are represented by a tree view list. Each site
server is a node of the tree view. Clicking on the
symbol on the left of
each site server name, users can expand the list of ticket types available
from that server. Clicking on the
will collapse the site servers list of ticket
types. By double clicking on a site server name will expand or collapse the
pertaining list of ticket types. Each item of the Tree View list can be
highlighted simply by clicking on it. Highlighting a ticket type will show the
list of its fields in the Ticket Type Fields list window.
79
F I G U R E 12.6: T I C K E T T Y P E F I E L D S L I S T.
The Ticket Type Fields list is used to show all the available fields of a
chosen ticket type. The Ticket Type Fields are shown in a two column list,
and against any field in the left column, the user can set a value (or a
formula) against it in the right column as a prerequisite requirement to filter
out the required tickets. I.E, only those tickets that satisfy the imposed
condition(s) will be collected and displayed in the resulting Tickets List
window.
When users type in a value, or select a required property from a predefined
list, they must complete the entry either by pressing the Enter key or by a
click outside the field with the new value, before running the filter. Also this
value will only be applied as a filter if the check box against this field has
been set. Several fields may be used to apply filters.
T A B L E 12.1: A D VA N C E D T I C K E T F I LT E R I N G : R E L AT I O N A L O P E R AT O R S
Operator
<
<=
>
>=
!=
==
Example
x<a
x <= a
x>a
x >= a
x != a
x == a
Description
less than
less than or equal to
greater than
greater than or equal to
not equal to
equal to
T A B L E 12.2: A D VA N C E D T I C K E T F I LT E R I N G : L O G I C A L O P E R AT O R S
Operator
&&
||
80
Example
a && b
a || b
Description
and
or
F I G U R E 12.7: E X A M P L E S O F A D VA N C E D T I C K E T F I LT E R I N G E X P R E S S I O N S .
Relational operators use a fix left value which is represented by the x
lowercase letter. The x letter refers to the value of the adjacent field. Logical
Operators can be combined together with relational operators to build
complex expressions.
When building complex expressions, relational operators are evaluated
before logical operators. For clarity when building expressions, users can
use spaces to separate each variable, operator and value, but this is not
essential. Equally users can use round parenthesis to group subexpressions to ensure intended order of evaluation, or to just make complex
expressions more readable.
or:
II.
Result:
Any tickets with a field that includes the search string are
highlighted in the Ticket List window.
Because of DD server advanced ticket filtering, you can also display tickets
with hierarchical fields. For further information, please refer to the The
Ticket List Window chapter of this manual.
81
82
13
MO filter
MO Filter list of
LACs and Pointcodes
F I G U R E 13.1: T H E D R I L L D O W N F I LT E R W I N D O W .
The Drill Down Filter window is the PDU equivalent of the Ticket Finder for
tickets. It retrieves PDUs for MOs specified by LAC code or Pointcode, and
against the users defined message filters. To show the Drill Down filter
window click on the DrillDown Filter tab under the bottom right corner area
of the Main Window. If the Drill Down Filter tab is not visible, go to the
View top menu and click Drill Down Filter to reveal the Drill Down Filter
window.
Starting from the bottom and working upwards, we can identify three
different areas in the DrillDown Filter window. This is also the sequence of
user input.
LACs or Pointcodes.
This displays the server and a tree of its MOs in terms of LACs and
Pointcodes. From this pane the MOs must be selected first as the
display in the next pane depends on this selection. If required, more
than one LAC or Pointcode can be selected by holding down the shift
key or control key.
83
2.
Then from message types pane, exclude all those not wanted. (leaving
only the Connection Failures in the given example.
3.
Select date and time for the investigation time period using the Tool
Buttons Bar and initiate collection with the Interval button. Use the
Stop button to end the collection if the PDUs are not required for the
whole period.
F I G U R E 13.2: A PDU L I S T W I N D O W G E N E R AT E D U S I N G A D R I L L D O W N F I LT E R .
In the above example, the opportunity has been taken to drill up from one of
the listed PDUs to determine the Ticket and learn details of the call affected.
84
MO F ILTER
F I G U R E 13.3: T H E MO F I LT E R L I S T.
If the MO Filter list is in its collapsed state, click on all the + signs, and
any + signs that are subsequently displayed, until the full scope of the
MOs is apparent. The user may select all those MOs to be included. Hold
down either the shift key or control key as the mouse is clicked when more
than one item is to be selected.
Only after a selection has been made for the MOs can the Protocols and the
different message types be listed.
P ROTOCOLS
AND
M ESSAGE T YPES
F I G U R E 13.4: P R O T O C O L A N D M E S S A G E L I S T S .
Having selected the MOs, the server is able to provide a complete list of all
the possible message types and the user is able to select which types are of
interest and those that are not wanted. All the light bulbs need to be set to in
accordance with these user requirements.
It is easiest to turn the complete contents of a folder on or off just by
collectively setting them with one or two clicks on the folder. With all set to
the majority condition, the exceptions can now be set individually within the
folder.
85
Start/Stop/Pause
Start Time
End Time
Profile
86
Refresh
Select This
Select Interval
Play
Stop
Pause
Play To End
Profile
87
Delete
F I G U R E 13.6: C A L E N D A R C O N T R O L E X A M P L E .
88
14
F I G U R E 14.1: T H E P R E S E T E D I T O R W I T H T O O L B A R A N D C O L U M N S .
The Preset Editor enables the user to create result definitions that can be
used to query the server database for measurement information and provide
results that can be visually be represented on maps, in tables or in charts.
Each entry in the preset definition represents a query and returns results
that could be in scalar, vector or table form. Depending on the results, the
measurements from the server can be visualized in QuantiQa Client in many
different ways.
The Toolbar buttons are:
New Preset
Load Preset
Save Preset
Revert to Saved
Add Formula
Duplicate Formula
Delete Formula
89
Move Formula Up
Synchronize Lists
F I G U R E 14.2: E D I T I N G A P R E S E T.
For every entry or row in the preset editor, each column in the row is
editable. Some fields indicate droplists with selections, checkboxes, editable
textfields for characters or numeric values. The modifications for the fields
affect the results for QuantiQa. When a Preset is selected for a query the
entries for the preset are used in the query. When the preset editor window
is closed, if a change has been made the user is invited to save the file.
Each of the preset editors fields is identified and described below:
Name.
Specify the name of the results from the Formula field. This name
will be used in dropdown lists and sliders for selection of the
corresponding measurement results as specified in the Formula field.
Formula.
Specify the table, counter, formula or JavaScript function required to
return the desired results. The results will be associated with the name
entered in the Name field.
Table and counter selection follow the same parsing rules and
selection methods as designed in both CommProve Netledge and
CommProve Quantiqa. Detailed explanations for the formulas are
given in the appendices.
To determine the difference between a server Table or Counter name
and Javascript function calls, the user must delineate all server table
names, counters, and server formulas with quotes. For example, the
following formula is surrounded in quotes and specifies to QuantiQa
the RLINKISSUES and associated formulas can be found and
calculated on the server:
"RLINKISSUES[0:0][$]/RLINKISSUES[0:0][]*100"
However, the following example without quotes indicates to QuantiQa
to call the given JavaScript:
90
Traffico()
The formulas can mix Tables, Counters and/or JavaScript in the same
preset. The following JavaScript would be executed in order and all
entries would return the same results:
Traffico()
TrafficFunction("RXQUL[][]")
RXQUL[][]
Where the JavaScript for the two functions are:
formula Traffico (result, "RXQUL[][]" as traf)
{
print (ne.NAME+" Traff_formula = "+traf.Get()+"\n");
result.Set(traf.Get());
}
and
function TrafficFunction (result, traf)
{
print (ne.NAME+" Traff_function= "+traf.Get()+"\n");
result.Set(999); Notice user defined return result in table.
}
RXQUL[][] is a simple data query to the server that returns the same
scalar value.
This would produce the following results in table form:
91
Notice that within JavaScript functions you can use the ne variable to print
different attributes of the MO that are designated as display names in the
server configuration file ( ne.NAME or ne.PARENT ).
Show R Click.
Specify whether the right mouse click will display scalar and vector
tables for the results directly on the map.
Map Type.
Specify the visualization mechanism used by the map to display the
results. The options available are:
Split Drop.
Creates a colored teardrop image to represent scalar and
vector data points at the MO point on the map. The color of the
drop will be shaded based on the colormap value.
Split Ball.
Creates a single circle at the tip of the MO stick to represent the
value for scalars only. The color of the ball will be shaded based
on the colormap value.
TA Vector.
Creates an arc a valid distance from the Managed Object on the
map representing a location at which the measurement
occurred. The color of the arc will be shaded based on the
colormap value.
F I G U R E 14.3: P R E S E T E D I T O R M A P T Y P E S .
92
Threshold.
Specifies the value to set for the low thumb on the maps colorscale
when the Main Layer Threshold is on.
Min.
Specify the minimum value to display on Maps and Charts. This value
also affects the color threshold bar.
Max.
Specify the maximum value to display on the Maps and Charts. This
value also affects the color threshold bar.
Dbl Click.
Not available in this release.
Chart.
Not available in this release.
List.
Specify whether the preset formula is available for view as a global or
drilldown item on the map.
DD Item.
Specify the name of the formula that will be used in drilldown mode on
the Map. This formula item must exist as one of the entries in the
same preset definition.
Colormap.
Specify the colormap to use in Maps and Charts when viewing the
measurement results. The colormap will specify the color of the drop,
ball, TA vector arc, pie, and/or bar chart. Color maps can be user
defined to generate the necessary colors for each value as required by
the user.
Formula2.
Specify the formula (same rules and syntax as shown above in the
formula description) that will be used in a twin configuration. This
formula2 and the query/results are associated and processed by the
second server in the list of a twin configuration.
93
94
15
Open a Chart Builder window from the Main Window or New menu.
F I G U R E 15.1: E M P T Y C H A R T B U I L D E R W I N D O W .
2.
Assign the Preset. The preset is dragged from the Preset Selection
window to the new window, or alternatively a resultset data of that
preset can be dragged from the dragger icon of an existing Chart
Result window. Either will give one of two possibilities according to
whether the preset already has, or does not have a chart.
F I G U R E 15.2: P R E S E T A S S I G N E D , W I T H
AND
W I T H O U T E X I S T I N G C H A R T.
95
3.
4.
E STABLISHING
THE
C HART
After dragging the preset or the presets result set to the empty chart builder
window, this section describes how to obtain and make a chart ready for the
setting of its properties.
PRESET
HAS AN
EXISTING CHART
After dragging the preset or the presets result set to the empty chart builder
window, if the preset already has a chart the dialog the dialog should be
similar to that shown below.
F I G U R E 15.3: T Y P I C A L C H A R T B U I L D E R W I N D O W , R E A D Y F O R E D I T I N G P R O P E R T I E S .
The preset may have one or more existing charts, and by clicking on the top
left drop down list, the user can select any of the existing charts ready for
modification.
Alternatively the user may click on the Add button to create a new chart as
shown adjacent. This now provides for creation of a new chart definition.
96
F I G U R E 15.4: A D D I N G A N E W C H A R T .
COPY CHARTS
FROM
ANOTHER PRESET
If the user makes the choice to Copy charts from another preset, the scroll
list gives a full listing of the currently available chart layout files. When the
user selects one of the listed names (a preset name) the Chart Builder
dialog presents a description of the types of charts defined in this file.
97
MO
F I G U R E 15.6: C H A R T B U I L D E R : E D I T A C O P Y O F A C H A R T L AY O U T W I T H 3 C H A R T S .
Notice the dropdown list contains 3 titles of the charts from a copy of a chart
layout file, Main_TRAF. By selecting a title from the dropdown list, the
properties for that chart will be displayed in the Chart Builder window for
editing. The user can make modifications but these are only saved to the file
if and when the Apply or OK buttons are used.
C R E AT E A N E W C H A R T D E F I N I T I O N
A new chart definition can created from either the Option dialog to copy
charts from another preset, or from use of the top left Add button of the
Chart Editor dialog.
The New Chart dialog, offers the user a choice of chart type to create. The
available types are Pie, Bar, XY or Gauge charts.
98
F I G U R E 15.7: T H E N E W C H A R T D I A L O G .
After selecting the chart type, a text field must also be completed for the
chart title. This title will appear at the top of the chart image. After making a
selection and entering a title, click the OK button. The chart editor window
will then appear and the chart is ready for the setting of its properties.
MO
F I G U R E 15.8: B U I L D A N E W P I E C H A R T .
99
AND
XY C H A R T S
The controls for Pie, Bar and XY charts are different, but are the same in
terms of their grouping for setting their respective chart properties. These
groupings are as follows:
Axis controls.
For pie charts and 2-D bar charts, there is one axis only (for pie: angle
of slice, for 2-D bar: the x-axis). For 3-D Bar and Line charts, 2 axes
are available (bars and sets). Drop-down boxes allow assignment of
one of the 6 resultset coordinates to each available axis.
Coordinate controls.
Coordinates not used for the axis, can still be displayed by other
means dependant on the type of chart (height, colormap, sector size
and displacement). Up to 4 dimensional settings are possible for pie
charts, up to 2 for 2-D charts (height and colormap), and 1 for 3-D
charts (height).
Show As controls.
For 3-D charts only, either Lines or Bars can be selected.
Custom Area.
Facilities exist for some chart forms, for the use of custom colors (i.e.
user selected) or custom labels.
Widgets.
Sliders and droplists are available for allocation to coordinates to
enable the user to determine values for any MO, ROP, Item, X, Y, Z
value.
100
Title Area
MO
Coordinate
Controls
Custom
Controls
MO
Widget
Control
MO
Axis Controls
Axis Labels
Legend Control
F I G U R E 15.9: T H E T H R E E D I F F E R E N T T Y P E S O F C H A R T: P I E , B A R
AND
XY.
101
F I G U R E 15.10: E D I T P R O P E R T I E S F O R A P I E C H A R T.
F I G U R E 15.11: C H A R T B U I L D E R T I T L E C O N T R O L S .
The first control is a dropdown list of currently defined chart titles with the
name of the selected chart displayed. Underneath the dropdown list there
are 3 buttons :
Add.
Click and a New Chart window will appear to create another chart.
Remove.
Click and the currently selected chart is permanently removed from
the dropdown list.
Rename.
Click and a Chart Builder Rename window will appear with a textbox
for entering a new title for the chart currently selected.
F I G U R E 15.12: C H A R T B U I L D E R A X I S C O N T R O L F O R P I E A N D 2-D B A R .
102
The Axis control is different for some of the charts as described below. The
dropdown lists allows the selection of one of the 6 coordinates which are
part of the resultset.
Pie Chart.
The axis is depicted as the angle of a pie slice for more than 1
coordinate value in the result. The axis is the entire pie if there is only
1 coordinate value.
2-D Bar.
The axis is the x-axis of the chart.
F I G U R E 15.13: C H A R T B U I L D E R A X I S C O N T R O L F O R 3-D B A R A N D L I N E .
C O O R D I N AT E S A R E A
F I G U R E 15.14: P I E C H A R T C O O R D I N AT E S .
The Coordinates area is different for each of the types of charts as
described below. A dimension setting can be turned on or off by clicking
the checkbox. To change a setting click the Set button. The Set window is
described at the end of this section.
On the Chart Builder window there are 4 dimension settings available on the
pie chart as shown above. Each pie chart has a Sector Size or angle. The
Colormap, Height and Displacement are described in detail later in this
Manual.
103
F I G U R E 15.15: 2-D I M E N S I O N A L B A R C H A R T C O O R D I N AT E S .
Each 2-D chart has a Height. The Colormap dimension is optional.
F I G U R E 15.16: 3-D I M E N S I O N A L C H A R T C O O R D I N AT E S .
Each 3-D chart has a Height. The Colormap is not an option.
C O - O R D I N AT E VA L U E S
To set the coordinate values, click on the Set button and the Chart Builder
Coordinates window will appear. All 6 coordinates with their values will
appear on the Coordinates window. A coordinate is greyed out if it was
selected as the Axis, Bars or Sets on the main Chart Builder window.
F I G U R E 15.17: C H A R T B U I L D E R C O O R D I N AT E S
Formula.
The dropdown list will contain the formulas defined for the Preset. The
Preset name is on title bar of the main Chart Builder window.
104
MO.
This is grayed out in this view because it is selected as the axis. The
axis will differ for each chart. All of the MOs in the query will be
represented on the pie chart as pie slices so you dont need to select
a specific MO. On the pie chart example, if the MOs for the query have
not yet been selected then the MO for the axis will default to 10 MO
objects.
ROP.
The dropdown list will contain all the time periods defined on the Main
Window.
X, Y and Z.
Each of these coordinates is set using numeric scrolling. The minimum
is 0 and maximum is 256. From the resultset the X, Y and Z will have
different maximum values but the numeric scroll control is defaulting
with the maximum of 256.
SHOW AS
AREA
F I G U R E 15.18: C H A R T B U I L D E R S H O W A S A R E A .
The Show As area with the Lines and Bars radio buttons is available only
on the Builder Window for the 3-D charts. The 3-D Chart type will change
according to the selection.
CUSTOM AREA
F I G U R E 15.19: C H A R T B U I L D E R C U S T O M A R E A .
The custom area allows the user to checkmark then create custom colors
and custom labels for each axis object. For example on the pie chart, each
pie slice is an axis object.
Custom Colors.
When turned on, go to the chart image and click on the top of a pie
slice. A color wheel will appear to select a color.
Custom Labels.
When turned on, click the Set button and a Custom Labels dialog
displays.
105
F I G U R E 15.20: C H A R T B U I L D E R C U S T O M L A B E L S .
The choices on the Custom Labels window are to display the label either in
a numeric format or as a name string.
Range of Numbers.
A user can set the first number in a range with a step amount to the
next number and the number can have decimal point precision.
Names.
Click Insert to add a label name, Remove to remove a label name,
Move Up and Move Down to set the positioning of the label name.
If more names are listed then there are axis objects the default is
show another object without a value plotted.
A X I S L A B E L S A N D L A B E L O R I E N TAT I O N
F I G U R E 15.21: C H A R T B U I L D E R X A X I S , P R I M A R Y Y A N D S E C O N D A R Y
Y A X I S L A B E L PA N E L S .
106
You can label the X and Y axes of Bar charts and XY charts as required.
QuantiQa Client also provides the option of adding a second Y axis and
label, to XY charts only. This can, for example, be set to a different scale
than that of the first Y axis, or relate to different data results in the same
chart.
F I G U R E 15.22: E X A M P L E O F A C H A R T W I T H T W O Y A X E S .
You can define the data results to which the secondary Y axis refers, by
clicking the plot that represents the data in the chart, or by clicking the
appropriate entry in the chart legend, if displayed.
X Axis Label.
If you select Custom Tick Labels, and click Set, the Custom X
Axis Labels dialog displays. For further details about this
dialog, please refer to Custom Labels, earlier in this chapter.
The Tick Label field allows you to adjust the angle of the X axis
labels.
107
F I G U R E 15.23: T H E C U S T O M X A X I S L A B E L S D I A L O G .
108
Bars.
Lines.
Step lines.
Splines
Solid.
Dash.
Linear.
Logarithmic.
F I G U R E 15.24: T H E Y A X I S O P T I O N S D I A L O G .
F I G U R E 15.25: C H A R T B U I L D E R W I D G E T S D I A L O G .
The Widgets are the Slider and Droplist controls which are visible at the
bottom of the main Chart Window. Each slider and droplist is defined as one
of the 6 coordinates types. The maximum number of widgets is 6, while the
minimum is 0.
109
LEGEND
F I G U R E 15.26: T H E C H A R T L E G E N D .
The chart Legend is an option that can be displayed as part of XY charts. To
use:
1.
Click Legend.
Result:
F I G U R E 15.27: T H E C H A R T B U I L D E R L E G E N D O P T I O N D I A L O G .
2.
3.
Type in the Distance from chart field, how far, in pixels, the
legend should be positioned, away from the chart.
or:
II.
4.
Click Close.
Result:
110
GAUGE CHART
F I G U R E 15.28: B U I L D A N E W G A U G E C H A R T.
The following controls are common to Gauge charts, as well as the other
chart types:
NOTE:
The Gauge type chart is affected by all sliders.
For further information about these controls, please refer to the previous
section of this Guide.
The remaining controls used to create a Gauge chart, differ from those used
to define the other types of chart. These controls are:
Position control.
This allows you to define the co-ordinates that the gauge uses. All six
co-ordinates, formula, MO, ROP, X, Y and Z are used to determine the
gauge needle position.
When the Set button is clicked, the Chart Builder Coordinates
window displays. For further details about using the Chart Builder
Coordinates window, please refer to "Co-ordinate Values" and
"Figure 15.17: Chart Builder Coordinates", earlier in this chapter.
111
Decimal control.
This allows you to define the number of decimal places to which
displayed results are rounded.
112
16
Query Results
After a successful query to the server database, measurement data follows
in the form of a resultset. It will be recalled that the query contains MO, ROP
and preset information. The ResultSet is a structure containing MO, ROP,
ITEM (preset formula), X, Y and Z information. Each value of the ResultSet
can be addressed by using these 6 coordinates.
MAPS
For the map, the user only needs to select a cell element. The measurement
is retrieved from the ResultSet based on the selected cell element. To view
the data for a cell element, select the line or wand protruding from the cell
center (depicted as a small circle). After selection, right-click to bring up a
pop-up containing a scalar value, a scroll list containing all the timing
advance values or a pop-up table containing values.
TABLES
For the table all the data measurements available in the ResultSet will be
viewed which means all the sets of values for the 6 coordinates are used.
The measurements are displayed in a grid format on the Table/Record
window.
CHARTS
When plotting a chart, settings for the 6 coordinates are defined in a chart
layout file. The chart layout files are built using the Chart Builder. From the
chart layout configuration, defined sliders and/or dropdown lists contain the
possible selections for the 6 coordinates. The sliders and droplists will be
visible at the bottom of the main Chart window. The user can set the sliders
and droplists to alter the charting of the data from the ResultSet..
The concept of the ResultSet with the coordinate information for the MO,
ROP, ITEM, X, Y and Z is complex to describe. It was mentioned here purely
to give an overview of the ResultSet. The user does not require detailed
knowledge of the ResultSet to view the data but an awareness may help in
describing some of the GUI controls used to manipulate the retrieval of data.
The following sections describe the map, table and chart views of the data
retrieved from the ResultSet.
The following chapters describe the results windows in more detail.
113
114
17
F I G U R E 17.1: T H E M A P R E S U LT W I N D O W .
The Map Result window provides a geographical view of cell locations and
cell data. It consists of:
M AP T ITLE B AR
F I G U R E 17.2: M A P T I T L E B A R .
115
The Map Title Bar is a standard QuantiQa Client User Defined window
Title Bar, and includes:
The title is formatted as Server name - Preset name - ROP time period.
For example, in the figure above, the server name is Allen, the preset is
Main_TRAF and the time period displayed on the map is 11/12 12:00
11/12 13:00.
M AP T OP T OOLBAR
F I G U R E 17.3: M A P T O P T O O L B A R .
Some of the controls on the top toolbar are created by using file entries from
the querys preset. The description of these toolbar controls, reference both
the toolbar and the Preset Editor that contains the preset file for the query,
as shown in the following illustration.
F I G U R E 17.4: E X A M P L E O F A P R E S E T F I L E W I T H C O L U M N E N T R I E S .
116
Dragger.
Auto Refresh.
Global Dropdown List.
Lock Drilldown Layer.
Drilldown Dropdown List.
Autoscale.
Print.
Pixel.
Show Only Expanded Rows.
Main Layer.
Drilldown Layer Threshold.
DRAGGER
The Dragger icon allows the user to select and drag from this icon the
results from the query to another map, table or chart window. After dragging,
a copy of the map results, a corresponding set of results will be displayed
on the destination map, chart or table window. If a window already contains
results, they will be replaced by the new results and displayed.
AUTO REFRESH
This button displays the Auto Refresh Settings dialog. This, when enabled,
allows the Map Result window to be refreshed periodically.
F I G U R E 17.5 : A U T O R E F R E S H I N D I S A B L E D M O D E .
F I G U R E 17.6 : A U T O R E F R E S H I N E N A B L E D M O D E .
The dialog tells you the ROP granularity (period), and can be enabled as
follows:
1.
2.
Select Enable.
3.
or:
117
I.
4.
Click the scroll box text field, and directly type in a value for the
number of minutes it should take, until the first refresh should
begin.
or:
I.
5.
Click the scroll box text field, and directly type in a value for how
often, in minutes, a refresh should take place.
When Auto Refresh is enabled, the Auto Refresh button is highlighted with a
blue box, and the remaining time until the next refresh takes place, is
displayed in the title bar of the Map Result window.
F I G U R E 17.7: N O T I F I C AT I O N O F N E X T A U T O R E F R E S H .
L O C K D R I L L D O W N L AY E R
Lock button locks or unlocks the Drilldown droplist. When locked the
Drilldown droplist is grayed out. When unlocked the background of the Lock
button icon is highlighted and the Drilldown droplist enabled. The locked
mode sets the DrillDown mouse mode to use the formula indicated in the
Presets DD Item column for the Drilldown data. For example, the DD Item
for the row Traf indicates formula TrafTA so this formulas data will be
used on the map when the DrillDown mouse mode is invoked.
118
AUTOSCALE
This turns the Autoscaling on and off and the button is highlighted when
on (default condition). Autoscaling uses the selected formula in the Global
Droplist to determine the colormap scaling. When colormap scaling changes
it will change the background color of the colormap labels which affects the
data colors on the map such as the teardrop color and TA sector color.
PRINT
The Print button enables you to print a copy of the map area currently
displayed in the Map Result window. Maps can be printed in landscape or
portrait format and, if the area displayed is to large for the selected paper
size, it is scaled down to fit the page.
PIXEL
Pixelization of a map is currently under development.
S H O W O N LY E X PA N D E D R O W S
When visibility is locked in the MO Selection window, the Show Only
Expanded Rows button displays, in addition to the MOs already shown on the
map, all selected MOs within MO Selection window hierarchical lists that
were previously expanded, but are now collapsed.
When visibility is unlocked, the Show Only Expanded Rows button displays, in
addition to all the selected MOs as described above, all visible MOs within MO
Selection window hierarchical lists that were previously expanded, but are
now collapsed.
If the Show Only Expanded Rows button is deactivated, the map display returns to
its original state.
M A I N L AY E R T H R E S H O L D
Main Layer Threshold sets the color map slider to use the values from the
Global Droplist formula when in Drilldown mode. Drilldown mode is set
when the Drill button in the Main Window Top Toolbar is turned on.
D R I L L D O W N L AY E R T H R E S H O L D
Drill-down Layer Threshold sets the color map slider to use the values from
the Drilldown Droplist formula when in Drill-down mode. Drill-down mode is
set when the Drill button in the Main Windows Top Toolbar is turned on.
119
F I G U R E 17.8: M A P A U T O S C A L E I S O F F .
When Autoscale is off it uses the minimum and maximum values indicated
in the Min and Max columns in the Preset for the selected formula. For the
Preset example above, on the Traf row the Min column equals 0 and
the Max column equals 5. For the map this sets the colormap scaling
between 0 5. We are using Traf because it is the selected formula in the
Global Droplist.
F I G U R E 17.9: M A P A U T O S C A L E I S O N .
When Autoscale is on the data retrieved for the selected formula
determines the minimum and maximum value used for the colormap scaling.
In the above figure, the minimum value appears to be 0.179 and the
maximum value to be 2.878. Note: When on the minimum and maximum
values are determined by comparing all the values in the query including all
ROP time periods.
120
T HE M AP T OOLS T OOLBAR
F I G U R E 17.10: T H E M A P T O O L S T O O L B A R .
The Map Tools toolbar, positioned to the left of the window, includes a
range of controls, which are intended to help you customize the way that
data is presented visually.
The Map Tools toolbar includes a selection of buttons, which define:
How your mouse functions when it is used, within a visible and active
Map window.
The information detail displayed.
The map projection applied to a Map window.
Selection Pointer.
Zoom In.
Zoom Out.
Zoom Extent.
121
Pan.
Drill Down.
Disable Drill Down.
Show Neighbor Cells.
Distance Measurement.
Rectangle Selection.
Polygon Selection.
Layer Manager.
Projection.
File Manager.
S E L E C T I O N P O IN T E R
When clicked, the mouse functionality is set to the default mouse mode. Its
cursor is an arrow.
ZOOM IN
When clicked, the mouse functionality is set to Zoom In mode. Its cursor is
a magnifying glass, with a plus (+) sign. To use:
1.
or:
1.
Click and hold the left mouse button, over an appropriate point on a
map.
2.
Drag the mouse, to define a map area to zoom in to. The area is
highlighted with a dotted rectangle, as you define it.
3.
NOTE:
If you press and hold <CTRL> while clicking on a map, the mouse
functionality toggles to Zoom Out mode. The magnifying glass cursor
displays a minus (-) sign.
122
ZOOM OUT
When clicked, the mouse functionality is set to Zoom Out mode. Its cursor
is a magnifying glass, with a minus (-) sign. To use:
1.
The map view zooms out, and a larger area of the map
displays, with the point you clicked at its center.
or:
1.
Click and hold the left mouse button, over an appropriate point on a
map.
2.
Drag the mouse, to define a map area to zoom out from. The area is
highlighted with a dotted rectangle, as you define it.
3.
NOTE:
If you press and hold <CTRL> while clicking on a map, the mouse
functionality toggles to Zoom In mode. The magnifying glass cursor
displays a minus (+) sign.
ZOOM EXTENT
When clicked, the mouse functionality is set to Zoom Extent mode. Its
cursor is a magnifying glass, with a two chevron (< >) signs. To use:
1.
Click and hold the left mouse button, over an appropriate point on a
map.
2.
Drag the mouse, to define a linear selection of the map area to zoom
in to. The area is highlighted with a dotted line, as you define it.
3.
PA N
When clicked, the mouse functionality is set to Pan mode. Its cursor is a
hand. To use:
1.
Click and hold the left mouse button over an appropriate point on a
map.
2.
3.
123
D R IL L D O W N
When clicked, the mouse functionality is set to Drill Down mode. Its cursor
is a hand drill, with a plus (+) sign. To use:
1.
2.
II.
Click further points on the map, until you have selected all the
ones, in which you are interested.
III.
Release <CTRL>.
Result:
3.
or:
1.
2.
3.
124
F I G U R E 17.11: E X A M P L E S O F C O B W E B S W H E N U S I N G T H E S H O W N E I G H B O R S M O D E .
F I G U R E 17.12: T H E M A N A G E D O B J E C T S F O R T H E A B O V E E X A M P L E .
To remove cobwebs from the map view:
1.
or:
II.
Result:
125
NOTE:
If the mouse cursor is placed over a cell stick, a Tool Tips list
displays, which shows the details of its neighboring cell sticks. If the
Disable Drill Down functionality is enabled, all cell sticks associated
with a drill-down, are removed from the map view. There is no change
to mouse cursor's appearance.
D I S TA N C E M E A S U R E M E N T
When clicked, the mouse functionality is set to Distance Measurement
mode. Its cursor is a cross hair. To use:
1.
Click and hold the left mouse button, over an appropriate point on a
map.
2.
3.
R E C TA N G L E S E L E C T I O N
When clicked, the mouse functionality is set to Rectangular Selection
mode. Its cursor is a left pointing arrow, with a rectangle. To use:
1.
Click and hold the left mouse button, over an appropriate point on a
map.
2.
Drag the mouse, to define the map area to select. The area is
highlighted with a dotted rectangle, as you define it.
3.
4.
5.
NOTE:
When you have made a selection with the Rectangle Selection tool,
and right click over the appropriate area, the number of selected pixels
is displayed.
If you have made multiple selections that overlap, any tickets included
in more than one selection, are counted once only.
126
P O LY G O N S E L E C T I O N
When clicked, the mouse functionality is set to Polygon Selection mode. Its
cursor is a left pointing arrow, with a polygon. To use:
1.
2.
Move the mouse to the next point on the same map, and define the
first side of the polygon.
3.
4.
Repeat steps 2 and 3, until you have defined all the sides of the
polygon you require.
5.
L AY E R M A N A G E R
When clicked, the mouse functionality is set to Layer Control mode.
NOTE:
When a map is created, different layers of information are generated.
Each layer of information represents a set of geographical data, stored
in one database table. A graphical representation of this data displays
on the map, and could be, for example, roads, or lakes.
To use:
1.
2.
Select The layer that you want to manage, in the Layer dialog.
3.
4.
Repeat steps 2 and 3, until you have made all necessary changes.
5.
Press <ENTER>.
Result:
PROJECTION
When clicked, the map is set to Projection mode, and the Projection dialog
displays.
127
NOTE:
The Projection mode enables you to select the type of conversion
that is applied to a map, when the true positions of objects on the
Earth's three dimensional surface, are plotted to representations on a
two dimensional area, such as your computer screen.
This conversion process always results in a degree of distortion, for
several reasons. The intention behind changing the type of
conversion, is to reduce this distortion, and/or generate a map layout
with the projection settings, which you require.
Use the Projection dialog to define:
Latitude/Longitude
Robinson
Sinusoidal
Polar Stereographic
F I G U R E 17.13: P R O J E C T I O N E X A M P L E S .
FILE MANAGER
When clicked, the Third Party Map File Manager window displays. This is
used to associate third party map files with QuantiQa Client.
To use:
1.
2.
Click Add...
Result:
3.
Navigate to the folder where the map files, which you want to
associate with QuantiQa Client, are stored on your computer.
4.
5.
Click Open.
Result:
128
6.
7.
Use the controls in the File Properties panel to adjust the map's
visibility and transparency.
8.
9.
Click OK.
Result:
2.
Select the map that you want to remove in the Third Party Files list.
Result:
3.
Click Remove.
Result:
4.
The map file is deleted from the Third Party Files list.
Click OK.
Result:
NOTE:
The appropriate Map window must be active, before you can use the
Map Tools. If a Map window is not active, the Map Tools toolbar
buttons appear gray, and are unavailable.
A CTIVATE A M AP W INDOW
To activate a Map window:
1.
2.
T HE M AP R ESULTS PANEL
The Map Results panel includes a Geographical Information System (GIS)
with an overlay of the retrieved data from a query. The GIS map will vary
depending upon the customer locations for QOS assessment. The map can
indicate the cell locations based on longitude and latitude, and the
technology of each antenna. It can indicate the distance between cell
locations. The user can view the managed object measurements for each
cell. This section will describe the use of the map controls found on the Map
Window and the map tools located on the Main Window.
129
The map creation uses the query information containing the managed
objects, the preset formulas, the time periods and the element data. Each
managed object has geographic properties such as the longitude, latitude
and direction to determine the cell locations. See the MO Selection window
for the geographical properties in a tabular format.
C E L L L O C AT I O N A N D C E L L S E C T O R
F I G U R E 17.14: M A P W I T H 2 C E L L L O C AT I O N S .
The map shown above is of a geographic area with 2 cell locations on the
map. A cell location is based on the longitude and latitude. The cell location
is indicated as a circle. A cell location can have cell sectors. A cell sector is
indicated as a black, blue, purple or red protruding line from the cell circle. If
the line is red then the cell sector is selected. The sector line is drawn
based on the direction of the MO(s) associated with this line.
When a cell sector is not selected, its length and color indicates its
technology layer:
The 2 cell locations each have 2 cell sectors. Each cell sector has a colored
teardrop shape surrounding it. The teardrop or drop color corresponds to the
colormap legend on the right side of the map frame. The colormap legend
indicates values with a different colored label for each value. So a drop color
is an indicator of the value retrieved from the query.
130
F I G U R E 17.15: C E L L L O C AT I O N W I T H T R A F D ATA .
On the map above is a cell sector with a label 4017699. The drop color is
white and matches the colormap indicator with an approximate value of
2.878. The above figure indicates a popup with the label, Traf 2.847600.
This popup label corresponds to cell sector 4017699. To see the values for
the cell sectors, select a cell sector at the line protruding from the cell
location then right-click, a popup appears indicating the values for each
preset formula. In this example there are 2 formulas, Traf and TrafTA.
The value which is visible is for Traf. As mentioned previously the data
values and preset formula information are available in the ResultSet.
F I G U R E 17.16: C E L L L O C AT I O N W I T H T R A F TA D ATA .
The above figure shows a partial map with a cell sector selected and a popup with data visible. The second formula, TrafTA, is a 2G vector. The
vector is depicted as a one row scroll list. This vector is a timing advance
(TA) which can have up to 64 values and is the reason for the addition of the
scroll bar. Scrolling to the left or right allows you to view all 64 values.
The cell sector labeled 4017699 displays a red line protruding from the
cell location. This indicates the cell sector is selected. In addition, when a
cell sector is selected on the map the selection is also highlighted on the
MO Selection window.
131
F I G U R E 17.17: S E L E C T E D E L E M E N T O N M A P A N D MO S E L E C T I O N W I N D O W .
M U LT I P L E MO S AT T H E S A M E C E L L S E C T O R
F I G U R E 17.18: D E P I C T I O N O F 2 C E L L S E C T O R S , L E F T H A S M U LT I P L E MO S A N D
R I G H T H A S O N E MO.
In the case where there are multiple MOs with the same longitude, latitude
and direction, the cell sector line will be thicker. In the above figure, the first
image contains 2 cell sectors. The image on the left has more than one MO
as indicated with a thicker sector line. When the thicker sector line is
selected a pop-up containing a labeled check box for each MO is visible as
indicated in the second image. The user can click on a check box and the
associated MO will be selected on the map as the third image indicates with
the multiple MO sector line being red.
Although the pop-up is centered over the cell sector on the right, the check
box selections affect the cell sector on the left. As mentioned previously
when a cell sector is selected on the map the MO is also selected in the list
of MOs in the MO Selection Window. For multiple MOs on the same cell
sector, when a check box is selected that MO is selected in the MO
Selection Window.
132
M AP C OLOR S CALE
F I G U R E 17.19: C O L O R M A P S C A L E W I T H S L I D E R A N D T H U M B S , H I G H A N D L O W .
On the QuantiQa Client GUI the color map scale is a gui control which is
used for the map and the charts. This example of a colormap scale also
includes a slider with 2 thumbs on the right side of the scale. Only the map
will have a colormap scale with a slider.
A colormap file determines the colors used on the scale. The specific
colormap file is set in the Preset file for the Query.
The colormap scale allows a graphic indication of a value. The data values
have a direct correlation to a color. On the map the data can be presented
as colored tear drops around cell sectors or as TA sectors resembling
colored arcs echoing out from a cell. On a chart data points are plotted and
the result will be various colored lines, bars or pie slices.
A colormap scale is visible with a slider to the right of the scale. The slider is
used to set a range of values visible on the map. On the slider are 2 thumbs;
one is positioned high at > 2.878 and the other positioned low at < 0.169.
The scale between the thumbs is the range of values which can be viewed
on the map. By sliding either the high thumb or low thumb, the effect on the
map is that the color disappears for those teardrops or TA sectors where the
color value is no longer in the range.
133
F I G U R E 17.20: T E X T B O X W I T H T H E T H U M B V A L U E .
There are two methods to modify the slider range using the thumbs. One is
to drag either thumb to the desired value. The second method is to select a
thumb with the mouse and right-click. A pop-up with an editable text field is
displayed for a value to be entered. When the pop-up text field appears the
current value is set to the current position of the thumb on the numeric
scale. The result of editing a thumb value is the thumb will slide to the new
value which will increase or decrease the range of the color values which
are viewable on the map.
M AP B OTTOM T OOLBAR
F I G U R E 17.21: M A P B O T T O M T O O L B A R .
The bottom toolbar contains the following buttons and controls:
134
ROP Tools.
Previous Button (ROP Tools).
Speed/Play Button (ROP Tools).
Next Button (ROP Tools).
D I S TA N C E M E A S U R E M E N T L A B E L
The Distance Measurement Label indicates the distance from a selected
point to the drop point on the map. Distance Measurement mode is set
when the Measurement button in the Main Windows Top Toolbar is turned
on.
F I G U R E 17.22: D I S TA N C E B E T W E E N C E L L L O C AT I O N S .
The distance between 2 cell locations is indicated as a dash line. The
distance label is indicated as D: 8.481 KM on the bottom toolbar.
BLE ND ING TO OL S
The maps Blending Tools consist of a dropdown list and slider. The tools
set the transparency of 2 areas on the map work area. A dropdown list
contains the icon options for Map and Feat. The Map option affects the GIS
Map and the Feat affects the map features. The maps features consist of
the colored images for the teardrop or TA displayed on the cell sectors. The
second tool is the Blending Slider. As the user moves the slider either the
GIS Map or Maps features will increase or decrease their transparency.
135
F I G U R E 17.23: P A R T I A L GIS M A P W I T H M A P A R E A F A D E D .
M A P (B L E N D I N G T O O L )
In the figure above the dropdown displays the the Map icon. As the slider
moves to the left the transparency will increase, until the map area is
invisible. As the slider moves to the right, the map transparency decreases.
F E AT (B L E N D I N G T O O L )
As the slider moves to the left the transparency will increase until the
images for the teardrop or TA are invisible. As the slider moves to the right
the images transparency decreases.
F I G U R E 17.24: PA R T I A L GIS M A P W I T H F E AT F A D E D .
136
IMAG E S IZIN G TO OL S
The Image Sizing Tools consist of a dropdown list and slider. The sizing
tools set the size of the cell sectors image features. A dropdown list
contains the options for either a:
Teardrop Image.
TA Image.
To be displayed on the map. The second tool is the Sizing slider. As the user
moves the slider either the teardrop increases or decreases in size and the
TA image will increase or decrease in angle.
F I G U R E 17.25: M A X I M U M P O S S I B L E S I Z E O F TA I M A G E .
ROP T O O L S
The ROP Tools include a Previous button, a Speed/Play button, a Slider
and a Next button. The ROP Tools are available if a query contains more
than 1 ROP. The tools enable the user to set the ROP period to be displayed
on the map work area. When a ROP changes the data for the ROP period
will be displayed on the map and the ROP time on the Title Bar will be
updated.
P R E V I O U S B U T T O N (ROP T O O L S )
The Previous button will set the ROP to the previous ROP period. The
slider moves to the left, and the map updates accordingly.
137
S P E E D /P L AY B U T T O N (ROP T O O L S )
The Speed/Play button is a combined button and dropdown list. By clicking
the play button the ROPs are updated automatically, on a time basis. The
Speed dropdown enables the user to select the speed at which the ROP
data is automatically updated on the map.
F I G U R E 17.26: ROP S P E E D /P L AY B U T T O N W I T H S P E E D O P T I O N S .
N E X T B U T T O N (ROP T O O L S )
The Next button sets the ROP to the next ROP period. The slider moves one
position to the right, and the map updates accordingly.
F I G U R E 17.27: M A P S H O W I N G T H E D R I L L D O W N TA V E C T O R W I T H V A L U E S
A N D N O N -V A L U E S .
138
A map which has a measurement retrieved from the query which is a NAN,
or Not A Number, cannot be plotted in the same way as one with a
measurement that is. To make it clear that the vector contains a NAN, the
vector displays with a white background and red crosshatch lines. This is
similar to the appearance of a NAN on a pie chart.
Click measure
for tickets
Double Click ticket
See measure
F I G U R E 17.28: A D R I L L
DOWN
EXAMPLE.
139
140
18
F I G U R E 18.1: TA B L E A N D R E C O R D S I N A TA B L E R E S U LT S W I N D O W .
The Table Result window contains the managed object data in a tabular
format. Along with the data, the table can also display the information for the
managed objects. The query result information contains the selected
managed objects, the ROP time settings, the formulas in the Preset and the
measurements retrieved from the server database. The Table/Record is
filled using some of the query result information. To display query
information in a table/record window the user can drag and drop a new
resultset from another result window or select a preset then execute a table.
TABLE G RID
The structure of the table is a grid which allows sorting of the table by
column . The first row of the grid is the header row containing the Title and
type of the column. The titles depicted in the header row shown are ROP,
Parent, Name, Traf, TrafTA, Read Tables(%) and % Data. The
subsequent rows contain ResultSet information retrieved from the query and
organized in the grid according to the column header type. The header row
titles will differ for at least 2 of the columns. In this example the Parent
column references the querys aggregation type which can vary depending
on the Preset, and the Traf and TrafTA columns which are the Preset
formulas. The number of columns in the header row will vary based on the
number of formulas in the Querys Preset and the number of columns which
are not hidden.
141
In the Table/Record example there are 3 ROP times ( 11/12 12:00 11/12
13:00, 11/12 13:00 11/12 14:00, 11/12 14:00 11/12 15:00 ), 4
managed objects ( 44017698, 44017699, 44017721, 44017722 ), and
2 Preset formulas ( Traf and TrafTA ). The twelve rows of data
information are for the 4 managed objects multiplied by the 3 time periods
(ROP).
The data or measurements retrieved from the query are different for each
Preset formula, for each managed object at each ROP.
The Read Tables(%)column indicates the percentage of the database
tables which responded from the initial query. The % Data column
indicates the percentage of possible counters returned from the query.
TA B L E /R E C O R D T I T L E B A R
F I G U R E 18.2: TA B L E T I T L E B A R .
At the top of each Table Window the title bar contains a title on the left and
window controls on the right. The title is formatted as Server name - Preset
name - ROP time period. For example in the aboved figure, the server
name is Allen, the preset is Main_TRAF and the first ROP is 11/12 12:00
11/12 13:00.
The controls on the top right are the focus, window options, and the close
button as standard for all user windows.
TA B L E /R E C O R D T O O L B A R
F I G U R E 18.3: TA B L E /R E C O R D T O O L B A R .
The toolbar at the top of the table window has icon buttons and a dropdown
list.
The toolbar controls are as follows:
142
Dragger.
Auto Refresh.
Export to Clipboard.
Export to Disk.
Export to Excel.
DRAGGER
The Dragger icon allows the user to select and drag from this icon the
results from the query to another map, table or chart window. After dragging
and processing, a copy of the table results, a corresponding set of results
will be displayed on the destination map, chart or table window. If a window
already contains results, the old results will be cleared and the new results
displayed.
AUTO REFRESH
This button displays the Auto Refresh Settings dialog. This, when enabled,
allows the Table Results window to be refreshed periodically.
F I G U R E 18.4 : A U T O R E F R E S H I N D I S A B L E D M O D E .
F I G U R E 18.5 : A U T O R E F R E S H I N E N A B L E D M O D E .
The dialog tells you the ROP granularity (period), and can be enabled as
follows:
1.
143
2.
Select Enable.
3.
or:
I.
4.
Click the scroll box text field, and directly type in a value for the
number of minutes it should take, until the first refresh should
begin.
or:
I.
5.
Click the scroll box text field, and directly type in a value for how
often, in minutes, a refresh should take place.
When Auto Refresh is enabled, the Auto Refresh button is highlighted with a
blue box, and the remaining time until the next refresh takes place, is
displayed in the title bar of the Table Result window.
F I G U R E 18.6: N O T I F I C AT I O N O F N E X T A U T O R E F R E S H .
EXPORT
TO
CLIPBOARD
When the export table selection button is clicked, the selected rows or
selected cells in the table will be copied to the desktop clipboard. The
contents on the clipboard can then be pasted.
NOTE:
By holding the Ctrl key multiple rows/cells can be selected. If nothing
has been selected when this button is pressed, a warning is given and
no copy action is taken.
EXPORT
TO
DISK
When the Export and Save button is clicked, the selected rows, or selected
cells in the table, are copied and a SaveAs dialog will appear. This allows
you to save the contents as a csv or tsv file, with a user-defined name and
location. If nothing has been selected when this button is clicked, a warning
is given and no copy action is taken.
144
EXPORT
TO
EXCEL
When the Export to Excel button is clicked, the selected rows or selected
cells in the table are copied into an Excel spreadsheet ,which can then be
saved as a workbook with a user-defined name and location. If nothing has
been selected when this button is clicked, a warning is given and no copy
action is taken.
I N D IV I D U A L C E L L S E L E C T I O N
When this button is clicked, it changes the selection mode within the table
from row, to individual cell. When the button is in cell selection mode, it is
surrounded by a blue highlight.
TA B L E O P T I O N S
This button opens a dialog for setting the decimal precision, and thousands
separator options, for numerical results in the table. It also provides the
option of displaying row numbers.
F I G U R E 1 8. 7 : TA B L E O P T I O N S D I A L O G .
C O L U M N /F I E L D C H O O S E R
The Column chooser or Field chooser is a dialog containing a drag and
drop list area. When you drag and drop a column header to the dialog, it
displays the column name. After dragging a column header to the Chooser
dialog, the column information will no longer be visible in the table.
NOTE:
The Formula columns, such as Traf and TrafTA, and the Read
Tables (%) and % Data columns cannot be dragged.
To retrieve a column from the chooser list you can select a column name
and drag it to the column header row or the column drag area above the
table. If a column name is dragged to the Header row, the column header
and column information will refresh.
145
If a column name is dragged and dropped in the column drag area then the
table will refresh with a hierarchial grouping.
F I G U R E 18.8: TA B L E C O L U M N /F I E L D C H O O S E R D I A L O G .
E X PA N D A L L G R O U P S
All column groupings in the grid area expand. A - sign is visible next to the
name of those elements that are expanded.
N O R M A L I Z AT I O N D R O P D O W N L I S T
The Normalization dropdown list allows you to select a Normalization mode
for the displayed counter data in the table. Normalization is calculated using
the preset formulas in the query. There are 4 normalization modes as
depicted in the following figure.
F I G U R E 18.9: TA B L E N O R M A L I Z AT I O N O P T I O N S .
Normalization off.
Provides the raw data and is the default setting shown in the above
droplist.
Maximum Value.
Normalizes the values according to the maximum value in each
formula.
146
Formula Sum.
Normalizes according to the sum of all the values in each formula.
TA B L E /R E C O R D D R A G A R E A A N D C O L U M N S
F I G U R E 18.10: C O L U M N D R A G A R E A A N D C O L U M N T I T L E S .
The Table Result window includes a drag area is located above the table as
seen in the above figure. By dragging a column from the header row and
dropping it in the column drag area, the table will appear grouped based on
the column type. Note: The Formula columns, such as Traf and TrafTA,
and the Read Tables (%) and % Data columns cannot be dragged.
TA B L E /R E C O R D W I T H NAN
F I G U R E 18.11: TA B L E W I T H NAN V A L U E S .
147
When the value in the table grid indicates NAN this is an abbreviation for
Not A Number. This is a measurement without value. Normalization cannot
be calculated when one of the measurements in the column has a NAN so
the rest of the values will default to a zero value.
148
19
F I G U R E 19.1: C H A R T W I N D O W W I T H 3 C H A R T I M A G E S , 3 D R O P D O W N L I S T S
AND 1 SLIDER.
The Chart Result window consists of a title bar, toolbar, panels with chart
images and a bottom toolbar. A chart can be created and viewed after a
query is successfully completed.
An empty chart window can be created by going to the Main Window New
Menu and selecting New Chart. A result can be dragged and dropped into
the chart window to start the processing of creating and displaying the
charts.
There are 5 chart types Pie, 2D Bar, 3D Bar, 3D Line and Gauge, which can
be created. Each chart will have at least one axis and one dimension. The
chart result windows tools and chart layout area are explained in later
sections.
149
Pie.
2-Dimensional Bar.
3-Dimensional Bar.
3-Dimensional Line.
Gauge.
The values plotted on the charts are retrieved from the ResultSet. When a
query is sent to the server, a successful response will return a ResultSet.
The ResultSet is a structure containing MO, ROP, Preset ITEM (formula), X,
Y and Z information. Each value of the ResultSet can be addressed by using
these 6 coordinates. Each pie, bar and line chart is able to have one of the 6
coordinates as a chart axis and the axis is set in the layout file. The other 5
coordinates can also be set in the layout file or a default setting is used. All
6 co-ordinates are used to define the position of the needle in a gauge
chart.
The example in the figure above, has 3 chart images, a 3D Bar chart, a 3D
Line chart and a Pie chart. The layout file would contain at least 3 chart
descriptions for the example. The file also defines a droplist for ROP, a
droplist for MO, a droplist for ITEM and a slider for X.
Some of the chart types can have 1 or more dimensions. In the figure
above, the Pie Chart has multiple dimensions. The width of the pie slices is
one dimension. The height of the pie slice can be a dimension. The color of
the pie slice can be a dimension. The dimensions for each chart type are
described in the chart type section for the Pie, 2D Line, 3D Line and 3D Bar.
The user will be able to configure the number of dimensions by making the
proper settings for the particular chart type using the Chart Builder.
F I G U R E 19.2: C H A R T W I N D O W T I T L E B A R .
At the top of each Chart window the title bar contains a title on the left and
window controls on the right. The title is formatted as Server name - Preset
name - ROP. In the example above, the server name is Allen and the
preset is Main_TRAF.
The controls on the top right are the focus, window options, and the close
button as standard for all user windows.
150
CHAR T TO P TO OL B AR
F I G U R E 19.3: C H A R T W I N D O W T O P T O O L B A R .
The toolbar buttons and controls are as follows:
Dragger.
Auto Refresh.
Save Layout.
Load Layout.
Edit Layout (Unlock Chart).
Zoom In.
Zoom Out.
Scroll.
Save.
Print.
Autoscale With Data Dropdown List.
Disable Items.
Cumulative.
Normalization Dropdown List.
DRAGGER
The Dragger icon allows the user to select and drag from this icon the
results from the query to another map, table or chart window. After dragging
and processing, a copy of the chart results, a corresponding set of results
will be displayed on the destination map, chart or table window. If a window
already contains results, the old results will be cleared and the new results
displayed.
151
A U TO R E F R E S H
This button displays the Auto Refresh Settings dialog. This, when enabled,
allows the Chart Result window to be refreshed periodically.
F I G U R E 19.4: A U T O R E F R E S H I N D I S A B L E D M O D E .
F I G U R E 19.5: A U T O R E F R E S H I N E N A B L E D M O D E .
The dialog tells you the ROP granularity (period), and can be enabled as
follows:
1.
2.
Select Enable.
3.
or:
I.
4.
Click the scroll box text field, and directly type in a value for the
number of minutes it should take, until the first refresh should
begin.
or:
I.
5.
Click the scroll box text field, and directly type in a value for how
often, in minutes, a refresh should take place.
152
When Auto Refresh is enabled, the Auto Refresh button is highlighted with a
blue box, and the remaining time until the next refresh takes place, is
displayed in the title bar of the Chart Result window.
F I G U R E 19.6: N O T I F I C AT I O N O F N E X T A U T O R E F R E S H .
S AV E L AY O U T
The Save Chart Layout archives the current chart layout in the installation
directory with the filename similar to <presetname>.layout. Whenever the
same query preset spawns a chart, the <presetname>.layout checks as to
whether it exists. If it does, then this archived version of the layout for the
charts is used.
L O A D L AY O U T
Load Chart Layout checks whether the <presetname>.layout file exists in
the installation directory. If it does exist, the file is used to set or re-set the
layout of the charts.
E D I T L AY O U T (U N L O C K C H A R T )
The Edit Layout button can be turned on or off. When on the button is
highlighted and the panes containing the chart images are changed to the
unlocked and editable mode.
F I G U R E 19.7: T H R E E C H A R T PA N E L S U N L O C K E D A N D E D I TA B L E .
153
Each charts panel will appear attached as shown above but each pane is
separate with a title bar at the top. The title bar may not contain a title string
but will have a pushpin button and X button.
F I G U R E 19.8: T H E P A N E L T I T L E B A R .
Title bar.
Select bar and drag the pane for re-docking within the chart layout
area.
Title.
May or may not be visible, if visible the title was defined in the chart
layout file.
Pushpin button.
When clicked the pane will Autohide.
X button.
When clicked the pane is deleted.
ZOOM IN
Zoom In mode displays less data for each mouse click on the chart. Zoom
In mode can be turned on and off by clicking the button. When turned on
the mouse is shaped as a spyglass with a + sign when it is in the viewport
area of a chart.
ZOOM OUT
Zoom Out mode displays more data for each mouse click on the chart. Zoom
Out mode can be turned on and off by clicking the button. When turned
on the mouse is shaped as a spyglass with a - sign when it is in the
viewport area of a chart.
SCROLL
Scroll Chart View mode allows scrolling through data in the chart view. For
large amounts of data when the data is first displayed on a Bar or Line chart
the chart software will display all the data. With this much data the lines and
bars are so close together they become unreadable. The Zoom In mode and
scrolling mechanism allow the user to adjust the amount of data to be
viewed. The Zoom In will set less data in the viewport and the Scrolling
allows the user to scroll forwards or backwards through the data.
By clicking on the Scroll Chart View button the scrolling mechanism is
turned on or off. To turn on scrolling, the mouse must be clicked and held
down over a chart viewport then moved to the left or right. The appearance
of the mouse will change to left and right arrows. This indicates the user can
move the mouse forward or backward through data.
154
S AV E
When the Save button is clicked, a Save As dialog displays, which provides
options to save the current chart in PNG, BMP, WBMP, JPEG, or GIF format.
You can also save a chart at the currently displayed size, or at a custom
resolution, defined in pixels.
F I G U R E 19.9: T H E S AV E A S D I A L O G .
When multiple chart panels are displayed for different slider positions, for
example, for a range of Managed Objects and ROPs, you can batch save
all charts as separate files. The file names are automatically generated,
which by default, include the preset, chart and managed object names,
together with the ROP and date. This is done to ensure that each saved
chart has a name that is both unique and identifiable.
The preset name displays in the File name text field however, and can be
changed as required. The other naming elements are not visible, and cannot
be changed from the Save As dialog.
To save a chart or group of charts:
1.
2.
Click the downwards arrow, to the right of the Save as type text field.
Result:
3.
155
4.
If you only want to save the active chart, select Current slider
position only.
or:
I.
5.
or:
I.
or:
a.
6.
II.
or:
I.
II.
or:
I.
Click the downwards arrow to the right of the File name text
field.
Result:
II.
7.
or:
I.
156
PRINT
When the Print button is clicked, a Print dialog displays, which provides
options to print the current chart, or batch print all visible ones. You can
print charts at the currently displayed size, or rescale it/them so that each
fills the selected paper size.
F I G U R E 19.10: T H E P R I N T D I A L O G .
To print a chart or group of charts:
1.
2.
In the Select Printer panel, double click the name of the printer that
you want to use.
3.
4.
If you only want to print the active chart, select Current slider
position only.
or:
I.
5.
or:
I.
157
6.
7.
or:
I.
A U TO S C A L E W I T H D ATA D R O P D O W N L I S T
There are 2 controls to set autoscaling. There is the Autoscale button and
the Data dropdown list. The button allows autoscaling to be turned on and
off with the button highlighted when on. Turning on autoscaling affects
the colormap scaling according to the range of the minimum and maximum
values. Changing the colormap scale will affect the chart image colors
based on the range.
The Data dropdown list determines the amount data used to set the
minimum and maximum values. The data is either Autoscale to all data or
Autoscale to visible data. For all data the minimum and maximum values
are based on all the resultset data. For visible data the minimum and
maximum values are based on the data retrieved from the settings of the
sliders and droplists on the bottom of the Chart Window.
F I G U R E 19.11: A U T O S C A L E W I T H D ATA C H O I C E S .
Autoscaling is on when the button background is highlighted. To determine
the data state click on the dropdown list. A checkmark is visible in front of
either Autoscale to all data or Autoscale to visible data.
NOTE:
Autoscaling has no impact on gauge charts, as only one data value
displayed.
DISABLE ITEMS
This button opens a list of all the Formula items included in the resultset and
for multi-item resultsets, enables the used to deselect items not wanted for
display. In this way the user may simplify presentation for clarity and viewing
of currently relevent items.
158
F I G U R E 19.12: D I S A B L E F O R M U L A I T E M S L I S T .
C U M U L AT I V E
The Cumulative Mode calculates each retrieved value and sums it to the
previous values sum, such that
1st = 1st,
2nd = 1st + 2nd,
3rd = 1st + 2nd + 3rd
...
The cumulative values are used to plot points for the charts. The initial data
values are retrieved from the Preset Item formula selected in the ITEM
droplist. The Cumulative mode is valid on the Line and Bar charts only. The
Cumulative Mode button is highlighted when on.
N O R M A L I Z AT I O N D R O P D O W N L I S T
The Normalization dropdown list allows the user to select a mode to
normalize the data used to plot a chart. Normalization is calculated using
the data from the Preset formula selected in the ITEM dropdown list or
slider. The ITEM dropdown list at the bottom of the window is an example.
F I G U R E 19.13: TA B L E N O R M A L I Z AT I O N O P T I O N S .
159
Normalization off.
Provides the raw data and is the default setting shown in the above
dropdown list.
Maximum Value.
Normalizes the values according to the maximum value in each
formula.
Formula Sum.
Normalizes according to the sum of all the values in each formula.
A UTOSCALE E XAMPLES
For the charts a colormap scale is visible for the Pie Charts so for our
example we use the Pie chart.
F I G U R E 19.14: A U T O S C A L E I S O F F A N D C O L O R S C A L E R A N G E I S B E T W E E N 0 5.
When Autoscale is off it uses the minimum and maximum values indicated
in the Min and Max columns in the Preset for the selected formula in the
ITEM droplist. For the Preset, Main_Traf, on the Traf row the Min
column equals 0 and the Max column equals 5. The range for the
colormap scale is between 0 5. We are using Traf because it is the
selected formula in the ITEM droplist.
160
If there is not a slider or droplist defining the ITEM, then a default ITEM
formula will be used.
F I G U R E 19.15: A U T O S C A L E I S O N A N D C O L O R S C A L E R A N G E I S M I N A N D
M A X O F R E S U LT V A L U E S .
When Autoscale is on the data retrieved for Traf in the ITEM droplist is
used. The minimum value appears to be 0.159 and the maximum value to be
2.878 for all Traf data. The Traf data includes data from all ROP time
periods. To determine whether the range of data to get the minimum and
maximum is for all the data or the visible data, click on the AutoScales Data
droplist.
F I G U R E 19.16: E X A M P L E O F MO ROP I T E M D R O P D O W N L I S T S A N D X S L I D E R
ON THE BOTTOM TOOLBAR
161
Before a slider or dropdown list is created the chart layout file is read to
determine how many sliders or dropdown lists to create. The maximum
number of sliders and dropdown lists is 6, one for each coordinate type. The
minimum number of sliders or dropdown lists can be 0 because it is not a
requirement to define a slider or dropdown list. The size of the coordinate in
the resultset determines the slider range. The coordinates names in the
resultset defines the item strings in the dropdown list.
For a simple example, consider a query with 4 MOs with the names
44017698, 44017699, 44017721 and 44017722. (This information is
available in the query result.)
The slider type is MO so the slider range would be 1 4 because there are
4 MOs in the query. By clicking the right arrow the slider can slide to the
right 3 times. Changing the slider value changes the MO whose
measurements are retrieved from the query resultset. As the MO
measurements change, the points plotted on the chart change.
F I G U R E 19.17: MO S L I D E R W I T H R A N G E O F 4.
If the dropdown list type is MO, the list of items would be 44017698,
44017699, 44017721 and 44017722. Because the dropdown list
displays the item strings and there are 4 MOs in this query. By selecting a
different MO, the measurements retrieved from the resultset will differ
affecting the points plotted on the chart.
F I G U R E 19.18: MO D R O P D O W N L I S T W I T H MO N A M E S .
162
The sliders and dropdown lists allow the user to change the selection of a
coordinate value. By changing the selection the measurement data changes.
F I G U R E 19.19: 2D B A R W I T H MO D R O P D O W N L I S T = 44017698.
F I G U R E 19.20: 2D B A R W I T H MO D R O P D O W N L I S T = 44017721.
The two charts above, show the results of changing the MO Dropdown list
from 44017698 to 44017721. The values plotted on both charts are
visually different. The remaining 5 coordinates for ROP, ITEM, X, Y and Z
did not change in either chart.
The case where a selection is changed for a coordinate and the chart does
not change is when the slider or dropdown list coordinate type is the same
as the chart axis. An example is described for the pie.
163
F I G U R E 19.21: P I E C H A R T W I T H A N G L E , H E I G H T , C O L O R A N D MO D R O P D O W N L I S T.
On the pie chart the axis is the angle of the slice. If a slider is set to the
same coordinate as the angle then changing this slider will not have an
affect on the angle of the pie slices because all the values are already
visible. In the above figure, the axis is set to MO, there are 4 MO pie slices
shown and the MO dropdown list is set to 44017698.
If the dropdown list changes to a different MO the chart will not change
since the measurements for all the MOs are already visible for this ROP,
ITEM, X, Y and Z. If the ROP dropdown list time period changes though the
measurements for this time period will change the plot points on the chart.
F I G U R E 19.22: P I E C H A R T W I T H N O S L I D E R S O R D R O P D O W N L I S T S D E F I N E D .
164
P IE C HART
Each chart type will have at least one axis defined in the chart layout file.
The Pies axis is the angle. The angle is depicted as a pie slice. The Pie is a
chart type which can be configured to have multiple dimensions. The height,
color and displacement of the slice can be separate visible dimensions but
are optional. For a dimension to be turned on or visible it must be defined in
the chart layout file by using the Chart Builder. When a dimension is
defined each of the 6 coordinates, MO, ROP, ITEM, X, Y and Z, can be set.
The setting of all of the coordinates determines the value or non-value read
from the resultset.
The following section describes the 4 possible dimensions of the pie:
Angle.
Color.
Height or Depth.
Displacement.
PIE ANGLE
F I G U R E 19.23: P I E C H A R T : 4 MO S W I T H D ATA D E P I C T E D A S S L I C E S O R A N G L E S .
The Pie Chart has the axis set to MO because the labels are MO names.
There are 4 MOs in this query since there are 4 slices in the pie. Although
this example has color, the colors are using the default colormap since a
colormap scale is not visible. From the example the MO 44017699 has the
largest data value compared with the widths of all 4 slices. This depiction
gives you one dimension of the data measurements retrieved for this query.
165
PIE COLOR
F I G U R E 19.24: 4 MO S W I T H D ATA D E P I C T E D A S 4 A N G L E S A N D 4 C O L O R S .
The Pie Chart has the axis set to MO but the color has been turned on
because the colormap scale is visible on the right side. In the scenario
where there are multiple Preset Formulas in a query, the pie can be
configured to use one Preset formula for the angle width and a different
Preset formula to depict the color. This would allow one dimension for the
angle width and a different dimension for the color.
The color gives a visual view of a value. The colormap scale contains value
labels with different background colors. The pie slice color should
correspond with the value on the colormap scale. In the example the MO
44017699 has an approximate value of 2.878 since the color of the slice is
white and corresponds to the white label of 2.878.
The colormap scale depiction is similar to the colormap scale used on the
Map window.
PIE HEIGHT
F I G U R E 19.25: MO S W I T H D ATA D E P I C T E D A S 4 A N G L E S A N D 4 H E I G H T S .
The Pie chart has pie slices with varying heights or depths. The pie slices
also have varying widths. Again the axis is set to MO since the labels are
MO names and there are 4 MOs in the query since there are 4 pie slices.
The color associated with the slices has no meaning since there is not a
visible colormap scale. In the example, slice 44017699 has the greatest
value since the slice height is the tallest. The height of the slices will go
from the tallest at the top to the smallest going clockwise.
166
PIE DISPLACEMENT
F I G U R E 19.26: MO S W I T H D ATA D E P I C T E D A S 4 A N G L E S A N D 4 D I S P L A C E M E N T S .
The Pie chart is depicted with pie slices displaced from the center. The pie
slices also have varying widths. Again the axis is set to MO since the labels
are MO names. There are 4 MOs in the query since there are 4 pie slices.
The color associated with the slices are default colors and have no meaning
since there is not a visible colormap scale. The displacement of a pie slice
from the center should correspond to a value. The greater the value the
greater the displacement of the slice from the center.
P I E W I T H A NAN
F I G U R E 19.27: P I E C H A R T W I T H 2 VA L U E S A N D 2 N O N - VA L U E S .
A Pie chart which has a measurement retrieved from the query which is
NAN or Not A Number can not be plotted the same as a measurement
which is a number. To make it obvious one of the pie sectors is a NAN, the
pie sector will appear with a white background and red crossed lines. This is
similar to the appearance for a NAN on the map.
167
F I G U R E 19.28: 2D B A R C H A R T W I T H C O L O R .
Each chart type will have at least one axis defined in the chart layout file.
The 2D Bar charts axis is the height. The height is the point plotted on the
chart. The bar chart has one other dimension which is the color. For a
dimension to be turned on or visible it must be defined in the chart layout file
by using the Chart Builder. When a dimension is defined each of the 6
coordinates, MO, ROP, ITEM, X, Y and Z, can be set in the chart builder.
The settings of all the coordinates determines the measurements read from
the resultset.
The 2D Bar chart in the figure above, indicates the color dimension is turned
on because the colormap scale is visible. The x-axis is set to the ROP
coordinate since ROP labels are visible on the horizontal axis.
If the result of a measurement is NAN or Not A Number, this non-value
cannot be plotted so a bar will not be visible for that point. Normalization
and Cumulative mode do not apply on the 2D chart.
168
F I G U R E 19.29: 3D L I N E C H A R T .
Each chart type will have at least one axis defined in the chart layout file.
The 3D Bar and 3D Line Chart have 2 axes defined as bars and sets. The
bars and sets can be set to any of the 6 coordinates, MO, ROP, ITEM
(formula), X, Y and Z but cannot be set to the same coordinate type. Each
axis is defined in the the chart layout file by using the Chart Builder. The
Chart Builder defines the 3D Bar and 3D Line Charts as XY charts. Custom
colors of the lines or bars are defined in the chart layout file otherwise they
are the default colors of the charting software.
For the XY chart (3D Bar or 3D Line), each coordinate value defined as the
axis for sets is displayed as a position on the horizontal axis (x-axis). Each
coordinate value defined as the axis for bars is displayed as a separate
line or bar.
F I G U R E 19.30: 3D B A R C H A R T .
169
In the two figures above, the top title indicates the axis settings as
Sets:MO and Bars:ROP. The query, Main_TRAF, contains 4 MOs and 3
ROPs. The horizontal axis displays the 4 MO strings, 44017698,
44017699, 44017721 and 44017722. The chart legend is reflective of
the bars and the coordinate value of each ROP, 11/12 12:00 11/12
13:00, 11/12 13:00 11/12 14:00 and 11/12 14:00 11/12 15:00. Each
ROP bar is denoted with a different color.
The different coordinate values for the sets and bars will retrieve the
measurements to be plotted for the height. The height for each combination
of MO with each ROP is shown in the 2 charts as:
MO-44017698
MO-44017699
T H R E E D I M E N S I O N A L B A R A N D L I N E C H A R T W I T H NAN
F I G U R E 19.31: 3D L I N E A N D 3D B A R W I T H NAN.
170
For NAN results on the 3D Line Chart the point is not plotted but will
appear to be 0. From this NAN point (at 0) the line segment will indicate a
different color from the rest of the line. The NAN result on a 3D Bar chart is
not plotted so a bar will not be visible for a NAN point.
Based on the query results for DropTA with X = 1, the appearance of the 2
charts for 3D Line and 3D Bar are shown in the figure above. For the line
chart on the left, notice the gray line. This gray line is indicating the first
point at 44017698 plotted is a NAN. The second point at 44017699 is a
NAN. The third point at 44017721 is 100.
On the line chart the third point at 44017721 should indicate a red and
green dot but the pixel points are too small to be visible. For Line charts
when the plotted points are not contiguous the line will not be visible and the
resolution for the plotted points may not be visible either. For noncontiguous plotted points the bar chart is better to display these
measurements.
In the figure above, the Bar chart on the right shows 4401698 at point 0
has a green bar barely visible and 44017721 at point 100 has a red and
green bar. The NAN values are not plotted.
F I G U R E 19.32: E X A M P L E O F R E S U LT TA B L E W I T H NAN R E S U LT S .
171
GAUGE CHART
F I G U R E 19.33: G A U G E C H A R T .
Each chart is defined in the chart layout file, using the Chart Builder. The
gauge needle can be set to any of the 6 coordinates, MO, ROP, formula, X,
Y and Z.
The formula's colormap can be displayed as a progressive ring around the
circumference of the gauge, and the numeric value of the current needle
position may also be shown, with the appropriate decimal rounding as
defined using the Chart Builder. The gauge is affected by all sliders.
The face of the gauge may be divided using major division marks. These
can in turn, be subdivided with minor and micro division marks.
172
20
F I G U R E 20.1: A T Y P I C A L T I C K E T L I S T W I N D O W .
The Ticket List window lists all those tickets associated with any one of the
following:
173
T HE T ITLE B AR
F I G U R E 20.2: T H E T I C K E T L I S T T I T L E B A R .
Within the title bar there is the data title that refers on the origin of the data
and at the right hand side are the standard icons for data available, the
window options and to close the window.
Usually the data presented is the result of a ticket drilldown and the title
includes a drilldown code indicating the type of ticket.
T OOLBAR
The toolbar buttons and controls are as follows:
Field Chooser.
Export.
Show Details.
FIELD CHOOSER
This button opens the Field Chooser window in which any columns that
have been dragged into the drag and drop area are listed and can be
dragged back to a column position as determined by the user.
EXPORT
The selected data can be saved to a user defined filename in either csv or
tsv format. This icon is greyed out whilst there is no selected data.
S H O W D E TA I L S
This button displays the Details panel at the bottom of the Ticket List
window, allowing you to view tickets with hierarchical fields.
TABLE FACILITIES
As for most QuantiQa tables, immediately above the table headings there is
an area to which column headings can be dragged to create a tree structure
and categorize by column values. See below for a demonstration example.
174
F I G U R E 20.3: TA B L E D R A G A N D D R O P A R E A , A N D F I E L D C H O O S E R L I S T.
The Field Chooser button can be used to display the Field Chooser
window as means to restore columns as with other tables.
A left mouse click on any ticket will select it. A group of tickets can be
selected by using the control or shift keys with a further click.
A right mouse click on any ticket or over an existing selection offers the
opportunity to export the selected data by saving it in csv or tsb format.
F I G U R E 20.4: E X P O R T I N G T I C K E T I N F O R M AT I O N .
A double click on any ticket row will select the row and open the Protocol
Analyzer for analysis of all its procedures and PDUs. To ensure a new
Protocol Analysis window is opened, hold <CONTROL> and double click.
175
176
21
Trace
Diagram
PDU Content
Pane
PDU Bytes
Pane
F I G U R E 20.1: T Y P I C A L P R O C E D U R E L I S T S H O W I N G A T I C K E T L I S T W I N D O W
WITHOUT TRACED TICKETS.
This window lists all those messages (PDUs) associated with a specific
Ticket and has extensive facilities for analysis of the sequence of messages,
for analysis of the contents of any message, and its structure right down to
bit level.
This window is a single window that can include several panes for which a
typical arrangement is shown below.
NOTE:
When the Protocol Analysis first opens, nothing is selected and so the
Details and Bytes panes will contain no data.
T ITLE B AR
F I G U R E 21.2: T H E P R O T O C O L A N A LY Z E R T I T L E B A R .
Within the title bar there is the data title that refers on the origin of the data
and at the right hand side are the standard icons for data available, the
window options and to close the window. The data presented is usually the
result of a ticket drilldown. The title includes a code for the type of ticket.
F I G U R E 21.3: P R O T O C O L A N A LY Z E R T O O L B A R .
177
P R O T O C O L A N A LY Z E R V I E W
Clicking on this button selects the normal tabular presentation of procedure
messages (PDUs) in the message table pane. This selection also includes
the PDU Contents and PDU Bytes panes.
MIXED VIEW
Clicking on the Mixed View button provides the message analyzer and flow
sequence message views, side by side. I.E. this displays all panes together.
FIND TEXT
This button helps you locate specific text.
COLUMN CHOOSER
This button opens the Column Chooser window in which any columns that
have been dragged into the drag and drop area are listed and can be
dragged back to a column position as determined by the user.
REFRESH
This refreshes the contents of the protocol analyzer window as determined
from the selected ticket.
EXPORT
The selected data can be exported to a user defined file in either text, binary
or Wireshark format. This icon is grayed out when there is no selected data.
178
F I G U R E 21.4: T H E E X P O R T M E N U .
The following shows the different display options available, by using the first
three buttons of the Protocol Analyzer toolbar.
F I G U R E 21.5: T H E P R O T O C O L A N A LY Z E R D I S P L AY O P T I O N S .
179
F I G U R E 21.6: P R O T O C O L A N A LY Z E R PDU L I S T PA N E L .
This is the master panel for the Protocol Analyzer and from which one PDU
message at a time can be selected for thorough analysis. In this pane the
PDUs are tabulated in a similar manner to other QuantiQa tables and
columns can be dragged into the drag and drop area at the top of the pane,
for hierarchal regrouping of messages according to the values of the
deposited column(s).
When data is available this pane should contain one or more PDUs, and the
scroll bars may need to be used to view all the data. PDU rows have either a
green or blue background. Green signifies an uplink message, and blue
indicates a downlink message.
By default, the PDU rows are presented in chronological order but the user
can reorganize the table sequence to follow the ascending or descending
values of any column by clicking the column heading, and of course
rearrange size and sequence of columns.
A left mouse click on any PDU message in the PDU List will select the PDU
for more detailed display of its contents in the PDU Contents and PDU Bytes
pane.
A right mouse click on any PDU in the PDU List will open a menu to :
180
F I G U R E 21.7: T H E D R O P D O W N L I S T O F T I C K E T T Y P E S .
The PDU selected above, is included in three procedure lists, - RadioLink,
AbisCallTrace, and Channel Request. The procedures found, are shown
here.
F I G U R E 21.8: E X A M P L E S O F P R O C E D U R E S F O U N D .
181
D R IL L U P T O T I C K E T
From a selected PDU the user can drill up to tickets in which this PDU is
included. After a Right mouse click and selecting Drill up to ticket, the drop
down list of ticket types appears. A click on an item here determines whether
the selected PDU is included. If it is, the ticket is displayed.
F I G U R E 21.9: T H E D R O P D O W N L I S T O F T I C K E T T Y P E S .
The PDU selected above, was included in three tickets, RadioLink,
AbisCallTrace, and Channel Request. The tickets found are shown below.
F I G U R E 21.10: E X A M P L E S O F T I C K E T S F O U N D .
PDU C O N T E N T S PA N E L
This panel displays the descriptive contents of the PDU selected in the PDU
List pane, and when a PDU is first selected it is displayed here in closed
hierarchal form.
182
F I G U R E 21.11: P R O T O C O L A N A LY Z E R PDU C O N T E N T S P A N E L
W I T H C L O S E D H I E R A R C H Y.
NOTE:
When the Protocol Analyzer first opens, no message is selected and
this pane can be blank.
The panel can be sized or scrolled to display as much information as
required. Full descriptive information is available for every field of the
message and each field is in tree form which can be expanded as required,
all the way down to bit level.
The higher levels of the fields in this pane are in black text, but at the lowest
level some details are in blue. This signifies that a context menu exists,
accessed by a right mouse click, by which the user can arrange for a
summary display of the contents of this field in each message in the Trace
Diagram pane to assist in the analysis process.
F I G U R E 21.12: T H E P R O T O C O L A N A LY Z E R D E TA I L S PA N E L , W I T H E X PA N D E D F I E L D .
For whatever line is currently selected, the corresponding bytes are
highlighted in the Bytes panel.
PDU B Y T E S PA N E L
In this panel, each byte of the selected message is displayed in hex dump
format.
The address offest is on the left side, the middle area shows the data in
hexadecimal, and the corresponding ASCII characters are displayed to the
right where possible.
F I G U R E 21.13: T H E P R O T O C O L A N A LY Z E R PDU B Y T E S PA N E L (N O S E L E C T I O N ).
When fields are selected in the Details panel, the corresponding bytes are
highlighted in the Bytes panel. Equally, bytes can be selected in the PDU
183
Bytes panel and to reveal the corresponding fields in the Details panel. See
below for examples.
F I G U R E 21.14: P R O T O C O L A N A LY Z E R PDU B Y T E S P A N E L
(A D D R E S S F I E L D S E L E C T E D ).
T R A C E D I A G R A M PA N E L
This displays a labeled arrow to represent each PDU, in downward
chronological order and showing the direction of flow.
F I G U R E 21.15: P R O T O C O L A N A LY Z E R T R A C E D I A G R A M PA N E L (W I T H O U T D ATA ).
This panel is read only. The scroll bars can be used to display the
appropriate part of the trace diagram but it is not possible to select and/or
operate on a message from here.
The PDU Contents and PDU Bytes panels are not displayed alongside the
Trace Diagram panel unless the Mixed view has been selected. When the
Mixed view is used, the PDU selected in the Message List panel is
highlighted in the Trace Diagram.
184
Table Of Figures
Figure 2.1: QuantiQa Client Main Window............................................................................................4
Figure 2.2: Toolbar Control Handles......................................................................................................6
Figure 3.1: The Main Menu...................................................................................................................7
Figure 3.2: The New Menu....................................................................................................................8
Figure 3.3: The View Menu.................................................................................................................10
Figure 3.4: The Toolbars List...............................................................................................................12
Figure 3.5: An Example Of A Windows Selectable List.......................................................................12
Figure 3.6: The Tools Menu.................................................................................................................13
Figure 3.7: The Help Menu.................................................................................................................15
Figure 4.1: The New Toolbar...............................................................................................................17
Figure 4.2: The Time Grid Toolbar.......................................................................................................18
Figure 4.3: The Mode Button..............................................................................................................18
Figure 4.4: An Example Of The ROP Selection Button.......................................................................19
Figure 4.5: The ROP Selection Dropdown List....................................................................................19
Figure 4.6: Examples Of Time Slot Selection Grid..............................................................................20
Figure 5.1: The User Defined Window Title Bar..................................................................................24
Figure 5.2: The Options Dropdown List...............................................................................................24
Figure 5.3: Example Of A Table Window.............................................................................................24
Figure 5.4: Examples Of Column Grouping........................................................................................26
Figure 5.5: The Field Chooser Window...............................................................................................27
Figure 6.1: The Options Window.........................................................................................................29
Figure 6.2: The Options Window, With The Protocol Analyzer
List Item Selected...........................................................................................................................30
Figure 6.3: The Options Window, With The Protocol Analyzer
Fonts And Colors List Item Selected..............................................................................................32
Figure 6.4: The Options Window, With The Ticket Viewer
List Item Selected...........................................................................................................................33
Figure 6.5: The Options Window, With The Application
List Item Selected...........................................................................................................................34
Figure 6.6: The Options Window, With The Map Results
List Item Selected...........................................................................................................................36
Figure 6.7: The Import PA Symbols Window.......................................................................................37
Figure 6.8: The System Login Dialog..................................................................................................39
Figure 6.9: The Please Change Password Dialog...............................................................................40
Figure 6.10: The KPM Rule Administration Window............................................................................41
Figure 6.11: The IMSI List Configuration Window...............................................................................41
Figure 6.12: The Alarm And Report Configuration Window.................................................................42
Figure 8.1: The Main Selection Window,
With Collapsed And Expanded Panels...........................................................................................45
Figure 8.2: The Server Selection Panel..............................................................................................46
Figure 8.3: The Date Selection Panel.................................................................................................48
Figure 8.4: The Calendar Selection Panel..........................................................................................49
Figure 8.5: The Day Time Slot Selection Panel...................................................................................51
Figure 8.6: The Aggregation Mode Selection Panel............................................................................52
Figure 8.7: Aggregation Mode Selection Panel Dropdown List...........................................................53
Figure 8.8: Cell Level Aggregation,
Displaying The Cell With Two Parent MOs.....................................................................................54
Figure 8.9: Cell NOREHOM Level Aggregation, Showing The Cell Independent Of The Parent MOs.
.......................................................................................................................................................55
Figure 9.1: The MO Selection Window................................................................................................57
Figure 9.2: Top-level MO With Drop-down Hierarchical List Displayed...............................................59
Figure 9.3: The MO Selection Toolbar.................................................................................................59
Figure 9.4: The Expand All MOs Window............................................................................................63
Figure 9.5: The MO Selection Filter.....................................................................................................63
185
186
Table Of Figures
187
Figure 19.23: Pie Chart: 4 MOs With Data Depicted As Slices Or Angles.........................................165
Figure 19.24: 4 MOs With Data Depicted As 4 Angles And 4 Colors.................................................166
Figure 19.25: MOs With Data Depicted As 4 Angles And 4 Heights..................................................166
Figure 19.26: MOs With Data Depicted As 4 Angles And 4 Displacements......................................167
Figure 19.27: Pie Chart With 2 Values And 2 Non-values.................................................................167
Figure 19.28: 2D Bar Chart With Color..............................................................................................168
Figure 19.29: 3D Line Chart..............................................................................................................169
Figure 19.30: 3D Bar Chart...............................................................................................................169
Figure 19.31: 3D Line And 3D Bar With NAN....................................................................................170
Figure 19.32: Example Of Result Table With NAN Results...............................................................171
Figure 19.33: Gauge Chart...............................................................................................................172
Figure 20.1: A Typical Ticket List Window.........................................................................................173
Figure 20.2: The Ticket List Title Bar.................................................................................................174
Figure 20.3: Table Drag And Drop Area, And Field Chooser List.......................................................175
Figure 20.4: Exporting Ticket Information..........................................................................................175
Figure 20.1: Typical Procedure List Showing A Ticket List Window
Without Traced Tickets.................................................................................................................177
Figure 21.2: The Protocol Analyzer Title Bar.....................................................................................177
Figure 21.3: Protocol Analyzer Toolbar..............................................................................................177
Figure 21.4: The Export Menu..........................................................................................................179
Figure 21.5: The Protocol Analyzer Display Options.........................................................................179
Figure 21.6: Protocol Analyzer PDU List Panel.................................................................................180
Figure 21.7: The Dropdown List Of Ticket Types..............................................................................181
Figure 21.8: Examples Of Procedures Found...................................................................................181
Figure 21.9: The Dropdown List Of Ticket Types..............................................................................182
Figure 21.10: Examples Of Tickets Found........................................................................................182
Figure 21.11: Protocol Analyzer PDU Contents Panel
With Closed Hierarchy..................................................................................................................183
Figure 21.12: The Protocol Analyzer Details Panel, With Expanded Field........................................183
Figure 21.13: The Protocol Analyzer PDU Bytes Panel (No Selection).............................................183
Figure 21.14: Protocol Analyzer PDU Bytes Panel
(Address Field Selected)..............................................................................................................184
Figure 21.15: Protocol Analyzer Trace Diagram Panel (Without Data)..............................................184
188
189
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
USA
Suite 200-300
1022 S Greenville Ave.
Allen
TX 75002
USA
Telephone: +1 469 656 4900
Fax: +1 214 383 5999
Italy
Via delle Fonti, 8/e
50010 Scandicci
Florence
Italy
Brazil
Av. Das Americas
3434 Bloco 5 Sala 503
22640-102
Rio de Janeiro
Brazil
UK
Annex 1
Worting Business Park
Church Lane, Basingstoke
Hampshire
RG23 8PX
UK
Telephone: +44 1256 817 640
Fax: +44 1256 811 876