Ug1 0502 00en

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

The following list explains the meaning of graphic symbols and devices, together with the typographical conventions used in CommProve documentation. Convention > Description Used to show a step in a path to a window or dialog box. For example : File > Save As Bold Used for window component names, buttons, menu options and similar. For example : Click Cancel . Bold Italics Used to emphasize For example : JavaScript <CAPITALS> Used for keyboard For example : Press <ENTER>. Computer Computer generated text. For example : <?xml version="1.0"?> Marks Marks Used to highlight references to chapters within other documents. Used to highlight references to other chapters or sections within the same document. key names, or key strokes. important words or phrases.
Information bar, used to highlight important information, such as the outcome of a described action.
Caution bar, used to highlight for example, actions that could lead to undesirable results.
Warning bar, used to highlight for example, actions that could lead to data loss, or system instability.
QuantiQa Client User Manual Part 1
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
QuantiQa Client Main Window................................................3

T HE M AIN W INDOW A FTER Y OU S TART Q UANTI Q A C LIENT F OR T HE F IRST T IME ..............................................................................3 T HE M AIN W INDOW C OMPONENTS .............................................................5
Title Bar................................................................................................5 Main Menu (Menu Bar).......................................................................5 Toolbars................................................................................................5 Windows And Panels..........................................................................5 The Status Bar....................................................................................5
R EARRANGING Q UANTI Q A C LIENT ' S A PPEARANCE.......................................6

Move The Main Menu, A Toolbar, Or A Window..............................6
The Main Menu.............................................................................7

D ISPLAY A M AIN M ENU D ROPDOWN L IST ...................................................7 T HE N EW M ENU .....................................................................................8
New Menu Commands.......................................................................8
New Procedure List.....................................................................................8 New Protocol Analyzer................................................................................9 New Trace Diagram.....................................................................................9 New Map Result Window............................................................................9 New Table Result Window...........................................................................9 New Chart Result Window...........................................................................9 New Chart Builder Window..........................................................................9 New Preset Editor........................................................................................9 Exit...............................................................................................................9
Select A New Menu Command........................................................10
T HE V IEW M ENU ...................................................................................10

The View Menu List..........................................................................11
Toolbars List..............................................................................................12 Windows List.............................................................................................12
Display, Hide, Or Locate A View Menu Item.................................13
iii
T HE TOOLS M ENU .................................................................................13

Tool Menu Commands......................................................................13
Options......................................................................................................14 Import PA Symbols....................................................................................14 User Administration...................................................................................14 Change User..............................................................................................14 Change Password.....................................................................................14 KPM Rules.................................................................................................14 IMSI List Configuration..............................................................................14 Alarm Configuration...................................................................................15
Select A Tools Menu Command......................................................15
T HE H ELP M ENU ..................................................................................15

The Help Menu List..........................................................................16
User Guide................................................................................................16 A Interface Ticket Description....................................................................16 Abis Interface Ticket Description...............................................................16 About QuantiQa.........................................................................................16
Select A Help Menu Item.................................................................16
Toolbars........................................................................................17
T HE N EW TOOLBAR ...............................................................................17
New Toolbar Buttons........................................................................17
T IME G RID TOOLBAR .............................................................................18

The Mode Button...............................................................................18 The ROP Selection Button...............................................................19 The Time Slot Selection Grid..........................................................20 Define A Query Time Interval..........................................................20
Windows and Panels................................................................23

T YPES O F W INDOW ..............................................................................23
Dialog, Or Default Windows............................................................23
Show Or Hide A Default Window...............................................................23 Current Windows List................................................................................23 Panels........................................................................................................24
User Defined Windows.....................................................................24

The User Defined Window Title Bar..........................................................24
Windows With Tables.......................................................................24

Row Alphabetical Order.............................................................................24 Column Order............................................................................................24 Column Width............................................................................................25 Column Grouping......................................................................................25 The Field Chooser.....................................................................................27
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
I MPORT PA S YMBOLS ............................................................................37

Store Name Resolution Definitions On A Server..........................38 Manually Download Definitions From A Server............................38 Automatically Download Definitions From A Server.....................39
C HANGE U SER ......................................................................................39 C HANGE PASSWORD ..............................................................................40 KPM R ULES ........................................................................................41 IMSI L IST C ONFIGURATION ....................................................................41 A LARM C ONFIGURATION..........................................................................42
Default Windows........................................................................43
D ISPLAY A D EFAULT W INDOW :................................................................43
The Main Selection Window..................................................45

T HE M AIN S ELECTION W INDOW C ONTROL PANELS....................................45
Expand Or Collapse A Control Panel.............................................46
T HE S ERVER S ELECTION PANEL ..............................................................46

Access A Server................................................................................47 Unsuccessful Server Access...........................................................47
T HE D ATE S ELECTION PANEL ................................................................48 T HE C ALENDAR S ELECTION PANEL ..........................................................49

Calendar Selection Panel Control Buttons....................................49 The Calendar Selection Panel Calendar Display.........................49 Select A Calendar Date Range.......................................................50
Change The Month....................................................................................50 Select A Date Or Date Range....................................................................50
T HE D AY T IME S LOT PANEL ...................................................................51 T HE A GGREGATION M ODE S ELECTION PANEL ............................................52

Time Based Aggregation..................................................................52
MO Hierarchy, Hierarchy Level And Property Based Aggregation .............................................................................................................52

Hierarchical Levels....................................................................................53 Example Of Hierarchical Levels................................................................54 Re-homing Management...........................................................................54 Naming Hierarchical Levels.......................................................................55
The MO Selection Window.....................................................57

D ISPLAY T HE MO S ELECTION W INDOW ...................................................57 T HE MO S ELECTION W INDOW ................................................................57
The Managed Object List.................................................................58 Viewing Managed Objects...............................................................59 The MO Selection Toolbar...............................................................59
Global MO List ..........................................................................................60 Result Window MO List ............................................................................60 Highlight All................................................................................................60 Remove Highlight From All........................................................................60 Invert Highlighting......................................................................................61 Toggle Visibility..........................................................................................61 Lock Visibility.............................................................................................61 Select All Highlighted MOs........................................................................61 Deselect All Highlighted MOs....................................................................61 Toggle Selection of All Highlighted MOs....................................................62 Find MO.....................................................................................................62 Column or Field Chooser ..........................................................................62 Collapse All Groups ..................................................................................62 Expand all Groups ....................................................................................62 Query Server to Expand All MOs...............................................................62
MO Selection Filter...........................................................................63
S ELECTING M ANAGED O BJECTS ..............................................................63

MO Visibility.......................................................................................66 MO Profile And Group Toolbar........................................................67
The MO Profile Tool...................................................................................68 The MO Group Tool...................................................................................69
Find A Managed Object....................................................................70 The Column Drag & Drop Area.......................................................70
The Preset Selection Window...............................................71

E DIT A P RESET.....................................................................................72 E XECUTE D ELETE
A A
P RESET...............................................................................72
P RESET .................................................................................72
The Counters Selection Window..........................................73
vi
The Ticket Finder Window.....................................................75

T HE T ICKET F INDER TOOL B UTTONS B AR ................................................76 T REE V IEW L IST ...................................................................................79 T ICKET T YPE F IELDS L IST ......................................................................80 A DVANCED T ICKET F ILTERING ..................................................................80 DD S ERVER A DVANCED T ICKET F ILTERING ...............................................81
The Drill Down Filter Window...............................................83

MO F ILTER ..........................................................................................85 P ROTOCOLS AND M ESSAGE T YPES .........................................................85 T HE D RILL D OWN F ILTER TOOL B UTTONS B AR .........................................86
The Preset Editor......................................................................89 The Chart Builder......................................................................95

Pie, Bar and XY Charts..................................................................100
Co-ordinate Values..................................................................................104
Query Results...........................................................................113
M APS .................................................................................................113 TABLES...............................................................................................113 C HARTS .............................................................................................113
The Map Result Window.......................................................115

M AP T ITLE B AR ..................................................................................115 M AP TOP TOOLBAR .............................................................................116
Map Top Toolbar Buttons...............................................................116
Dragger....................................................................................................117 Auto Refresh............................................................................................117 Global Dropdown List..............................................................................118 Lock Drilldown Layer...............................................................................118 Drilldown Drop List...................................................................................118 Autoscale.................................................................................................119 Print.........................................................................................................119 Pixel.........................................................................................................119 Show Only Expanded Rows ...................................................................119 Main Layer Threshold..............................................................................119 Drilldown Layer Threshold.......................................................................119
T HE M AP TOOLS TOOLBAR ...................................................................121

Map Tools Toolbar Buttons............................................................121
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
A CTIVATE A M AP W INDOW ..................................................................129 T HE M AP R ESULTS PANEL ...................................................................129

Cell Location And Cell Sector.......................................................130 Multiple MOs At The Same Cell Sector.......................................132
M AP C OLOR S CALE .............................................................................133 M AP B OTTOM TOOLBAR .......................................................................134

Distance Measurement Label.......................................................135 Blending Tools.................................................................................135
Map (Blending Tool).................................................................................136 Feat (Blending Tool)................................................................................136
Image Sizing Tools.........................................................................137 ROP Tools........................................................................................137

Previous Button (ROP Tools)...................................................................137 Speed/Play Button (ROP Tools)..............................................................138 Next Button (ROP Tools).........................................................................138
M AP W ITH A N OT A N UMBER (N AN ) R ESULT ........................................138 A N E XAMPLE O F U SING D RILLDOWN .....................................................139
The Table Result Window.....................................................141

TABLE G RID .......................................................................................141
Table/Record Title Bar...................................................................142 Table/Record Toolbar.....................................................................142 Dragger............................................................................................143 Auto Refresh...................................................................................143
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
The Chart Result Window....................................................149

C HART L AYOUT A ND R ESULTSET ...........................................................149
Chart Title Bar.................................................................................150 Chart Top Toolbar...........................................................................151 Dragger............................................................................................151 Auto Refresh...................................................................................152 Save Layout.....................................................................................153 Load Layout.....................................................................................153 Edit Layout (Unlock Chart)............................................................153 Zoom In............................................................................................154 Zoom Out.........................................................................................154 Scroll................................................................................................154 Save..................................................................................................155 Print..................................................................................................157 Autoscale With Data Dropdown List............................................158 Disable Items..................................................................................158 Cumulative.......................................................................................159 Normalization Dropdown List........................................................159
A UTOSCALE E XAMPLES ........................................................................160 W IDGETS : S LIDERS A ND D ROPDOWN L ISTS............................................161 P IE C HART.........................................................................................165

Pie Angle..........................................................................................165 Pie Color..........................................................................................166 Pie Height........................................................................................166
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
The Ticket List Window........................................................173

T HE T ITLE B AR ...................................................................................174 TOOLBAR ............................................................................................174
Field Chooser..................................................................................174 Export...............................................................................................174 Show Details...................................................................................174
TABLE FACILITIES................................................................................174
The Protocol Analyzer Window..........................................177

T ITLE B AR ..........................................................................................177 P ROTOCOL A NALYSIS TOOLBAR .............................................................177
Protocol Analyzer View..................................................................178 Trace Diagram View.......................................................................178 Mixed View......................................................................................178 Find Text..........................................................................................178 Column Chooser.............................................................................178 Refresh.............................................................................................178 Export...............................................................................................178
PDU L IST PANEL ...............................................................................180 T RACE T HE PDU P ROCEDURES...........................................................180

Drill Up To Ticket.............................................................................182 PDU Contents Panel......................................................................182 PDU Bytes Panel............................................................................183 Trace Diagram Panel.....................................................................184
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 Main Window. The Main Menu. Toolbars. Windows and Panels. Tools. Default Windows. The Preset Editor. The Chart Builder. Result Windows.
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.
B EFORE Y OU R UN Q UANTI Q A C LIENT

QuantiQa Client accesses servers using the settings defined in the server.cfg file.
If any of these settings are not formatted correctly, missing, or wrong, connections with one, several, or all servers, will fail.
A correctly configured server.cfg file is provided with the QuantiQa Client Software Distribution Package . This is copied to the QuantiQa Client software root directory, during installation. Under normal circumstances, you should not need to change these settings. If however, you are unsure about the server configuration settings, you should check that the server.cfg file entries are correct, before starting a QuantiQa Client session. For further information about the server.cfg file, please refer to the " QuantiQa Client User Manual Part 2 ".
QuantiQa Client Main Window

This chapter introduces the QuantiQa Client Main Window, which displays after you have successfully logged on to the application. The Main Window is the primary user interface, and provides access to all of QuantiQa Client's toolbars, windows, panels, controls and dialog boxes. These enable you to:
Create reports from data stored on the connected server. Manage tickets, and analyze transactions in detail. Access the protocol analyzer, to review protocol messages and Packet Data Units (PDU). Manage, set, upload and run alarms, as well as retrieve data about alarms that have been previously defined.
T HE M AIN W INDOW A FTER Y OU S TART Q UANTI Q A C LIENT F OR T HE F IRST T IME

When you start QuantiQa Client for the first time, the Main Window displays, as shown in Figure 1: The QuantiQa Client Main Window. It includes all of the controls needed to build a query, and manage the application's advanced features. All toolbars, windows, panels and controls display in their default location.
Main Menu Toolbars Time Grid Toolbar Main Selection Window
Title Bar And Standard Windows Controls 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 .
QuantiQa Client Main Window
T HE M AIN W INDOW C OMP ONEN TS

The QuantiQa Client Main Window is made up of the following:
The Title Bar. The Main Menu . Toolbars. Windows and Panels. The Status Bar.
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.
R EARRANGING Q UANTI Q A C LIENT ' S A PPEARANCE

You can customize QuantiQa Client's appearance, and rearrange the Main Menu , toolbars and control windows (which can be docked, floating, or hidden), to a layout that suits your personal needs. This new layout is then stored by QuantiQa Client when you exit, and applied the next time that you log on. The same is true for any layout created by other users.
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 : The Main Menu , toolbar, or window, displays in its new location during the current session, where it remains after restarting QuantiQa Client, until you relocate it again.
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.
The Main Menu

This chapter describes the Main Menu , which by default, displays at the top left of the Main Window, beneath the Title Bar. You can however, reposition the Main Menu anywhere on your screen, as described in Chapter 2 , QuantiQa Client Main Window, Move The Main Menu, A Toolbar, or A Window . The Main Menu provides access to the following selectable dropdown lists:
New. View. Tools . Help .
F I G U R E 3.1: T H E M A I N M E N U .
D ISPLAY A M AIN M ENU D ROPDOWN L IST

To display a Main Menu dropdown list: 1. Click New, View, Tools , or Help . Result : 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. The appropriate dropdown list displays.
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.
NEW MENU COMMANDS

The New menu includes the following:
New Procedure List . New Protocol Analyzer. New Trace Diagram . New Map Result Window. New Table Result Window. New Chart Result Window. New Chart Builder. New Preset Editor. Exit .
NOTE: Please refer to Figure 3.2: The New Menu , for the icon that is associated with each New Menu command.
NEW PROCEDURE LIST

When clicked, a new Ticket List window displays. This is used, for example, with the Ticket Finder tool, or a drill-down from a Table Result window, to display Tickets , which have been generated and stored by Netledge.
The Main Menu
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.
NEW TRACE DIAGRAM

When clicked, a new Trace Diagram window displays. From there, select the Trace Diagram View button , in the window's toolbar. This can then be used, to display procedures, which have been monitored 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.
NEW CHART BUILDER WINDOW

When clicked, a new Chart Builder window, consisting of the Chart Builder Wizard displays, which can be used to define a new chart format. You can do this, for example, by dragging result data from another window, or a Preset from the Preset Selection window. This data is then be used in by the Chart Builder Wizard , as the basis for you to use to construct the new chart layout.
NEW PRESET EDITOR

When clicked, a new Preset Editor window displays, which can be used to define a new Preset . This can be done, for example, by dragging an existing Preset from the Preset Selection window, and editing it accordingly, before saving the new definition under a new name.
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.
SELECT A NEW MENU COMMAND

To select from the New menu: 1. Click New. Result : 2. The New menu displays.
Click the required command. Result : The appropriate tool dialog, or result window, displays, or you exit QuantiQa Client.
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
The Main Menu
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.
THE VIEW MENU LIST

The View menu includes the following:
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:
Menu Bar ( Main Menu ). New. Status Bar. Time Grid .
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
The Main Menu
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. The View menu displays.
Click the required item. If you have clicked either Toolbars , or Windows , click the required item, in the additional dropdown list. Result : The item displays if it is not already visible, or is hidden (except for User Defined windows), or its window Title Bar is highlighted, to make it easier to locate.
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
The Main Menu
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.
SELECT A TOOLS MENU COMMAND

To select from the New menu: 1. Click Tools . Result : 2. The Tools menu displays.
Click the required command. Result : The appropriate tool window or dialog displays.
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
THE HELP MENU LIST

The Help menu list includes the following:
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.
SELECT A HELP MENU ITEM

To select from the Help menu: 1. Click Help . Result : 2. The Help menu displays.
Click the required document, or About QuantiQa. Result : The appropriate document, or the QuantiQa Client Version Information window displays.
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.
NEW TO OL BA R BUT TON S

The New toolbar includes the following buttons:
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 .
T IME G RID T OOLBAR
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:
The Mode button. The ROP Selection button. The Time Slot Selection grid.
THE MODE BUTTON
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. Click the Mode button. Result : The defined time slots are activated, the button icon is highlighted, and the Time Slot Selection grid appears gray, to indicate that it cannot be changed.
2.
Click the Mode button again. Result : The defined time slots are deactivated, the button icon is no longer highlighted, and the Time Slot Selection grid is available to define time slots.
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:

To use: 1.
1 hour ROP. 30 minutes ROP. 15 minutes ROP. 5 minutes ROP.
Click the ROP Selection button. Result : A dropdown list of ROP selection options displays.
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. Select the desired ROP. Result : NOTE: Exactly how data is displayed for the selected ROP, depends on the actual ROP duration that is acquired from the server. The dropdown list closes, and the ROP Selection button changes, to reflect the chosen ROP.
19
THE TIME SLOT SELECTION GRID
The Time Slot Selection grid with a 1 hour ROP selected.
The Time Slot Selection grid with a 30 minute ROP selected.
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.
A 1 hour ROP results in 24 time slots. A 30 minute ROP results in 48 time slots. A 15 minute ROP results in 96 time slots. A 5 minute ROP results in 288 time slots.
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. Do one of the following: I. II. III. or: 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. Release the left mouse button. Click, within the Time Slot Selection grid, on an individual time slot when the query should start. Press <CTRL> and click further time slots as required. Release <CTRL> when finished.
II.
20
Toolbars
3.
Press <CTRL> and repeat step 1, until you have defined all required query time intervals for the selected day. Result : All time slots, which make up each individual query time interval, are highlighted in red, to show that they have been selected.
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
Windows and Panels

This chapter describes the features common to most QuantiQa Client Windows and Panels . For details about individual windows, please refer to the appropriate chapter, or section, in this QuantiQa Client User Manual. By default, windows display within the Main Window, in the area beneath the toolbars. Windows may however, be docked within the Main Window, or floating, allowing you to reposition them anywhere on your screen, as described in Chapter 2 , QuantiQa Client Main Window, Move The Main Menu, A Toolbar, or A Window .
T YPES O F W INDOW
The QuantiQa Client has two main types of window:
Dialog, or Default windows. User Defined windows.
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 : The Default window is hidden.
As an alternative, you can follow the steps given in the next section, Current Windows list.
CURRENT WINDOWS LIST

You can access a selectable list of all current windows from the Title Bar of a Default window. 1. Right click the window's Title Bar. Result : 2. The list of all current windows displays.
Select a window. Result : If the window is hidden, it displays. If it is already visible, it is hidden.
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.
USER DEFINED WINDOWS

These are the windows created by you, the user, during a QuantiQa Client session. They are, for example, tool dialog and result windows, or windows and wizards that are used to define new charts and presets. User Defined windows are only valid for the current session, and may be closed prior to its end, when you have finished using them. User Defined windows are created, for example, by using the New menu. For further details please refer to Chapter 3 , The Main Menu , The New Menu . You can display a hidden User Defined window from the View menu. You cannot however, hide such a window from the View menu. You can also display a hidden window by using the Current Window list, as described in the previous section, Dialog, Or Default Windows .
THE USER DEFINED WINDOW TITLE BAR
Focus State Icon Options Button Close Button
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.
The Close button. This button permanently closes the User Defined window. It you need it again in the future, you must recreate it. The Options button. This button enables you to hide the User Defined window, change its positioning setting, or check its current state. To use, do the following: Click the Options button. Result: The Options dropdown list displays.
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
Windows And Panels
2.
Select one of the following:
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.
You can also display the Options dropdown list as follows: 1. Right click the window's Title Bar. Result: The Options dropdown list displays.
The Focus State icon. The Focus State icon has three states, and changes its appearance accordingly:
The window is not in focus. The window is still being loaded with data. The window is ready and in focus.
25
W I N D O W S W I T H TA B L E S
Column Chooser Button Drag and Drop Area
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:
ROW ALPHABETICAL ORDER

The table can be sorted according to the contents of any column, in ascending, or descending alphabetical order, as follows: 1. Click the heading of the appropriate column. Result : The table is sorted according to the alphabetical order of that column.
COLUMN ORDER
The column order can be rearranged as follows: 1. 2. 3. Click and hold the mouse on a column heading. Drag the heading to the place you want it, in the column order. Release the mouse button. Result : To hide a column: 1. 2. Click and hold the mouse on a column heading. Drag the heading outside the Table window. The column order is rearranged.
24
Windows And Panels
3.
Release the mouse button. Result : The column is hidden.
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 : The column width is changed accordingly.
COLUMN GROUPING
Columns may be ordered in a hierarchical group, to reorganize the table as required, by doing the following: 1. 2. 3. Click and hold the mouse on a column heading. Drag the heading to the window's Drag and Drop Area . Release the mouse button. Result : The column is removed from the current table, and displays as a box, in the hierarchy shown in the Drag and Drop Area . This is the top level of the group, and the table display changes to represent the hierarchy.
4.
Repeat steps 1 to 3 with other headings, positioning them as desired, in the hierarchy. Result : The structure of the hierarchy is reflected in the table display, with each descending level of the group, representing a column, indented beneath its immediate parent.
The information listed within each hierarchical layer, can be displayed in ascending or descending alphabetical order. To change the order: 1. Click the arrowhead, positioned to the right of the box that represents a column, in the Drag and Drop Area . Result : The order of the information changes accordingly.
Each row in the hierarchy can be expanded, to show further information if available, or collapsed, as follows: 1. Click " + ", positioned to the left of the relevant row in the display, to expand it, or " - ", to collapse it. Result: The information displayed, changes accordingly.
Columns can be returned to the original table, from the hierarchical group, as required.
25
1.
Do one of the following: I. Click and hold the box representing the column in the Drag and Drop Area . a. b. or: II. Use the Field Chooser, as described in the following section. The column is returned to the table, and its heading displays in the column heading row. Drag the box back to the table column heading row. Release the mouse button.
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
Windows And Panels
THE FIELD CHOOSER
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. 3. 4. The Field Chooser window displays.
Click and hold the Field Chooser list entry, which you want to restore. Drag the entry to the desired position in column heading row. Release the mouse button. Result : The column is returned to the table, and it's heading displays in the column heading row.
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
The Options window initially displays a selection list, formatted in a tree structure, positioned to the left. The list includes:

1.
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: Click a list item. Result : The Options window refreshes, and in addition to the selection list tree, displays the controls for the list item, which you have selected.
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
The Options Protocol Analyzer, and Options Protocol Analyzer General windows, display controls to the right, which are used to set the PDU Cyclic Buffer and Range Buffer sizes. The windows also include the following check boxes:
Show filter msg in alphabetical order. Use "lamp" style check boxes in msg filters . Resolve NEID names in summary view. Provided that name resolution data is loaded locally, for example, from a *.csv file, or remotely from a GSP server, select this to enable name resolution, if required, in the Protocol Analysis Summary.
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. A dropdown list of buffer sizes displays.
Select an appropriate buffer size from the dropdown list. Result : The dropdown list closes, and the box is updated with the new buffer size.
3.
Click the arrowhead to the right of the box under PDU Range Buffer Size . Result : A dropdown list of buffer sizes displays.
4.
5. 6.
Select the check boxes that you require. Click OK to proceed (or Cancel to abort). Result : The Options Protocol Analyzer, or Options Protocol Analyzer General window closes, and the application settings are updated.
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. Click the arrowhead to the right of the Background box under Downlink Colors . Result : 2. A color selection dialog displays.
Select a color as required, or define a custom color. Result : The dropdown list closes, and the box is updated to display the chosen color.
3.
Repeat steps 1 and 2 as required, for the Downlink Colors , Foreground , and Uplink Colors , Background and Foreground selections. Click OK to proceed (or Cancel to abort). Result : The Options Protocol Analyzer Fonts and Colors window closes, and the application settings are updated.
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 Q uantiQa 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. A dropdown list of buffer sizes displays.
3.
Click the arrowhead to the right of the box under Ticket Range Buffer. Result : A dropdown list of buffer sizes displays.
4.
33
5. 6.
Select Flatten All Fields , if required. Click OK to proceed (or Cancel to abort). Result : The Options Ticket Viewer window closes, and the application settings are updated.
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. Auto Sync Ticket definition at login . Enables auto-synchronization of ticket definitions, when logging on to a GSP server. Users who do not require the ticket analysis functionality, can disable this feature, and so avoid the extra waiting time, during login.
Auto Sync PDU NEID at login. Enables auto-synchronization of PDU NEID, when logging on to a GSP server. Users who do not require the ticket analysis functionality, can disable this feature, and avoid downloading the NEID list for PDU analysis.
34
Tools
Auto Sync PDU NEID Symbols at login . Enables auto-synchronization of name resolution data, for pointcode pairs, to MSC, BSC and LACs to BSCs, when logging on. For further information, please refer to the Import PA Symbols section, later in this chapter.
Use SSL with stats server. Provided to support SSL related developments. Use SSL with ddserver. Provided to support SSL related developments.
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. Select the check boxes that you require. If you want to set a timeout for PDU NEIDs and ticket definition synchronization: I. II. 3. Click the arrowhead, positioned to the right of the drop-down list, in the Ticket Definition And PDU NEID Sync field. Select a timeout setting from the list.
Click OK to proceed (or Cancel to abort). Result : The Options Application window application settings are updated. 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. Suppress NaN painting on maps .
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. To select the 2G timing advance , do one of the following: I. or: I. II. Click Other. Enter the required setting in the text box. Click 550 to accept the default setting.
36
Tools
2.
To select the 3G propagation distance , do one of the following: I. or: I. II. Click Other. Enter the required setting in the text box. Click either 117 or 234 to accept a default setting.
3. 3.
Select the check box to suppress NaN painting on maps, if required. Click OK to proceed (or Cancel to abort). Result : The Options Map Results window closes, and the map results settings are updated, together with any existing maps.
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
To use the Import PA Symbols window: Complete the following steps, to load a *.csv formatted file locally, using the controls within the A Interface Point Codes panel, or the A-bis Interface LAC/CI panel, according to the type of interface in question. 1. Click ... , positioned to the right of the Import File input field. Result : 2. 4. 5. A Windows Explorer window displays.
Navigate to the folder where the *.csv formatted file is stored on your computer. Select the appropriate file. Click Open . Result : The path to the *.csv formatted file displays in the Import File input field.
6.
Click Load . Result : The definitions contained in the *.csv formatted file are loaded, and the list to the right of the window, is updated.
7. 8.
Repeat steps 1 to 5, to add further definitions, and click Add each time, to load them. Click OK to proceed (or Cancel to abort). Result : The Import PA Symbols window application settings are updated. 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. When you have completed steps 1 to 7 above, select the definitions you require, from the list to the right of the window. Click Store . Result : 3. The definitions are uploaded to the server.
Click OK to proceed (or Cancel to abort). Result : The Import PA Symbols window application settings are updated. 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. The definitions are downloaded from the server, and stored locally.
Click OK to proceed (or Cancel to abort). Result : The Import PA Symbols window application settings are updated. closes, and the
38
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. Click Tools , in the Main Menu . Result : 2. The Tools menu displays.
Select Options . Result : The Options window displays.
3.
Select Application from the list in the Options window. Result: The Application check box list displays.
4. 5.
Select Auto Sync PDU NEID Symbols at login . Click OK to proceed (or Cancel to abort). Result : The Options Application window closes, and the application settings are updated to automatically download name resolution definitions from a server.
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. Type your old password in the Old entry field. Type your new password in the New Password entry field. Retype your new password in the Confirm New entry field. Click OK to proceed (or Cancel to abort). Result : NOTE: Passwords must include at least one uppercase character, and a special character or number. The Please Change Password dialog closes, and your password is changed.
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 .
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 IST C ONFIGURATION
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 .
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.
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 .
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.
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 Main Selection window. The MO Selection window. The Preset Selection window. The Counters Selection window. The Ticket Finder window. The Drill-Down Filter window.
The Default windows are presented in the following chapters, in the logical sequence in which they are generally used.
D ISPLAY A D EFAULT W INDOW :

If a default window cannot be found: 1. Do one of the following: I. or: I. II. Right-click the Title Bar of any other default window. Select the Window Name in the drop-down list. The windows displays. Click View > Window Name .
Result :
43
44
The Main Selection Window
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 .
T HE M AIN S ELECTION W INDOW C ONTROL PANELS

The five control panels in the Main Selection window, enable you to access the appropriate server, set the time interval for a query, and define the data aggregation to be applied.
45
The panels are:
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. Day Time Slot . Select the time interval for a query, for the selected day.
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. Click the panel's Title Bar. Result : The panel expands or collapses accordingly.
T HE S ERVER S ELECTION PANEL
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. Double left-click the Server Name in the Server Selection list. Result : If the connection is successful, the Monitor Icon next to the Server Name is highlighted, and QuantiQa Client is ready to access and process the network data.
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.
UNSUCCESSFUL SERVER ACCESS

If the connection is not successful: 1. 2. Check that the server is running, and/or connected to the right network. Check that the workstation is connected to the right network, and/or that its network configuration parameters are correct.
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. 2. Ensure that the server.cfg file contains all the details for the required server(s). 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
T HE D ATE S ELECTION PANEL
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. Do one of the following: I. II. or: I. II. Scroll to the Start date, using the up and/or down arrowheads, positioned to the right of the top date field. Scroll to the End date, using the up and/or down arrowheads, positioned to the right of the lower date field. The Start and End dates are set, and the Calendar Selection panel is automatically updated accordingly. Type the Start date in the top date field, using the format dd/mm/yyyy. Type the End date in the lower date field.
Result : 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
T HE C ALENDAR S ELECTION PANEL
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:
MF button, representing Monday to Friday. SS button, representing Saturday and Sunday. HLD button, representing holidays.
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.
CHANGE THE MONTH

1. Do one of the following: I. Click the left, or right facing arrowhead, positioned on either side of the months name. Result : or: I. Click and hold the left mouse button over the months name. Result : II. III. A selectable list of months displays. The month scrolls accordingly.
Scroll up, or down the list, while still holding the mouse button. Release the mouse button, when it is over the appropriate month. Result : The chosen month displays.
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. Click the date in the Calendar display. Result : The date is selected or deselected accordingly.
To select a range of dates: 1. Do one of the following: I. II. III. Click one date in the Calendar display. Press and hold <SHIFT> while clicking further dates. Release <SHIFT> when finished. Result : or: I. II. III. Click and hold the left mouse button over one date in the Calendar display. Drag the mouse, while still holding the left button, to include further dates. Release the mouse when finished. Result : 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. A continuous range of dates is selected. The range of dates is selected.
Repeat steps I. to III. to select further date ranges.
50
T HE D AY T IME S LOT PANEL
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 Q uantiQa Client Getting Started Guide . 2. Do one of the following: I. II. or: I. II. Result : 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 Q uantiQa Client Getting Started Guide . Scroll to the Start time, using the up and/or down arrowheads, positioned to the right of the left-hand time field. Scroll to the End time, using the up and/or down arrowheads, positioned to the right of the right-hand time field. The Start and End times are set, and t he Time Grid toolbar displays the query time interval selected, as a red band. Type the Start time in the left-hand time field. Type the End time in the right-hand time field.
51
T HE A GGREGATIO N M ODE S ELECTION PANEL
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.
ROP, together with a scrollable numeric field. Accumulate the data based on the value set in the scrollable numeric field, for the time interval. For example, a setting of 1 accumulates data for every ROP, 2 aggregates data for 2 consecutive ROPs, and so on.
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
EXAMPLE OF HIERARCHICAL LEVELS

In the following example, a BSC > Cell > TRX hierarchy is described. The Detail dropdown list displays the following entries:
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
F I G U R E 8.9 : C E L L NOR EHOM L E V E L A G G R E G AT I O N , S H O W I N G T H E C E L L I N D E P E N D E N T O F T H E PA R E N T MO S . If cell measurements for each parent MO overlap, the sum of the measurements is displayed. NOTE: If cell measurements are made, and then Cell NOREHOM is selected, only those measurements made following its selection are displayed.
NAMING HIERARCHICAL LEVELS

When a server connection entry is added to the Server Configuration file, you can specify a name for each of the hierarchical levels supported by the relevant database. These names subsequently display in the Aggregation Mode Selection panel dropdown list, and are included in any report that is generated. The names for the hierarchical levels are added to the @smoplm column of the Server Configuration file (server.cfg). You can use any name in the @smoplm column, as required. As a result, database names that are perhaps less understandable, are translated to an immediately recognized term, of your own choosing, when displayed on-screen, or included in reports. If no name is specified, the default that is applied is PARENT,NAME. This correlates to BSC and Cell, as defined by the default RADIOQOS hierarchy. For further information about the server.cfg file, please refer to the " QuantiQa Client User Manual Part 2 "
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
IMPORTANT: If a query is run using, for example, hierarchical level aggregation, it can be rerun, with a different preset, if required. If however, a query is run using Managed Object property aggregation, it will not possible to repeat it, without updating the MO list from the server, and selecting the required MO s again. This is because after running a query that has been aggregated in this way, the MO Selection window displays a hierarchical list of MO properties, rather than the MO s themselves. As a result, if you attempt to repeat the query, a window, similar to the following displays:
56
The MO Selection Window
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.
D ISPLAY T HE MO S ELECTION W INDOW

If the MO Selection window is not visible: 1. Click the MO Selection tab. Result : The MO Selection window displays.
If the MO Selection tab is not visible: In the Main Menu bar, positioned at the top of the Main Window : 1. Click View > MO Selection . Result : The MO Selection window displays.
T HE MO S ELECTION W INDOW
The MO Selection window consists of:
The Title Bar. The MO Selection toolbar. The MO Profile and Group toolbar. The Column Drag & Drop area. The Managed Object list.
The following sections describe each of these components in further detail, starting with the Managed Object list.
57
THE MANAGED OBJECT LIST

After a server, date range and time interval have been chosen in the Main Selection window, the MO Selection window displays the Managed Objects ( MO ) that are included in the server's database during the period defined by the date and time parameters, together with their relevant properties, in the Managed Object list. The Managed Objects are organized as a selectable, alpha-numerical listing of top-level MO s, linked as appropriate, to further MO s, through drop-down hierarchical lists. By default, the top-level MO s represent the highest level of aggregation available (excluding the ALL option), for the hierarchy chosen in the Aggregation Mode Selection panel. For example, the default RADIOQOS hierarchy has ALL , BSC , Cell and TRX aggregation levels available. As a result, BSC is selected as the initial aggregation level. NOTE: The MO Selection list can be aggregated according to MO properties, hierarchies, or hierarchy levels. For further information, please refer to "The Main Selection Window, The Aggregation Mode Selection Panel" , earlier in this Manual. The MO properties that are displayed, vary according to the selected hierarchy, or hierarchy level. In addition to other details, an MO property list may also include its geographical co-ordinates. While this means, for example, that any hierarchy, hierarchy level, or MO , may potentially be displayed on a map, this functionality is still being developed, and at the present time, it is limited to representing MO s as cell orientation sticks. For further information about cell sticks, please refer to "The Map Result Window" , later in this Manual.
Although under normal circumstances, MO details are very consistent, with little, or no change, the relationship between managed objects and the selected time interval, is key to successfully querying the database, and the available results. As a result, whenever the time interval is changed, for example, if you choose a new date range, QuantiQa Client performs a new database query, and the MO Selection window is updated. It is important to remember that:
When an MO appears in the Managed Object list, this confirms both that it exists, and is included in the database during the selected time interval. However, this does not mean that it is available for the whole period. The contents of the MO Selection list depends upon a suitable and applicable Results Output Period (ROP) being selected, for the network concerned.
58
VIEWING MANAGED OBJECTS

Initially, only the top-level MO s are displayed, as shown in "Figure 9.1" . To view the managed objects that are part of the hierarchical list associated with a top-level MO : 1. Click the ' + ' button, to the left of the relevant top-level MO . Result : A drop-down list of MO s displays.
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 MO s 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 MO s. 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.
Each button does the following:
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 MO s 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 MO s listed before running a preset, may differ to those shown afterward. This may occur when for example, the server sends results for MO s 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 MO s in a Result window is changed, before rerunning the preset.
HIGHLIGHT ALL
This button highlights every MO within the Managed Object list.
REMOVE HIGHLIGHT FROM ALL

This button removes the highlighting from every MO within the Managed Object list.
60
INVERT HIGHLIGHTING
This button highlights those MO s within the Managed Object list, which previously were not highlighted, and removes the highlighting from those that were. NOTE: MO s 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 MO s 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 MO s 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 MO s in a Result window. When this button is clicked (the default state), visibility is locked, and only the MO s 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 MO s 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 MO s display when visibility is unlocked, and later click the Lock Visibility button, all MO s 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 MO s, 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 MO s 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 MO s, 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 MO s are not shown in a Result window, when displayed. If visibility is not locked, you need to remove MO s 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 MO s, 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
This button displays the Field Chooser window, which is made up of a selectable list of all of those columns that are in the Drag and Drop Area , as well as any that are hidden. For further information about the Field Chooser window, please refer to the " Windows And Panels " chapter of this Manual.
COLLAPSE ALL GROUPS

This button collapses any expanded column groupings, within the Managed Object list. A plus sign ( + ) displays next to the name of column groupings that are collapsed.
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 MO s, 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. Enter an appropriate term in the text field. Click Apply Filter. Result: The Managed Object list is filtered according to the term that you entered.
You can filter the Managed Object list further, by selecting Filter Incrementally, and then entering the next term in the text field.
S ELECTING M ANAGED O BJECTS

An MO in the Managed Object list, can have one of four states:
Not selected to be used when processing a preset, and not visible in a Result window, such as a map (the default state). Not selected to be used when processing a preset, but visible in a Result window, such as a map. This state is only possible before a preset is run. Selected to be used when processing a preset, and visible in a Result window, such as a map (the default selected state). Selected to be used when processing a preset, but not be visible in a Result window, such as a map.
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. In the MO Selection list, do one of the following: I. Click the tick-box to the left of one top-level MO to select it, and all the MO s in the associated hierarchy list. NOTE: If you click the tick-box next to a top-level MO , all of the MO s 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. Click any top-level MO to highlight it. Press and hold <SHIFT> and click another top-level MO , n rows above, or below the originally highlighted MO . Result : c. A continuous series of top-level MO s are highlighted. Click the ' + ' button to the left of a top-level MO , to expand its hierarchical list. Click the tick-box to the left of one of the listed MO s.
Repeat any combination of steps I. and II. as required, until all the MO s needed for the query, have been selected.
Click the Select All Highlighted MOs button, on the MO Selection toolbar. Result : The continuous series of highlighted, top-level MO s, together with all of the MO s in the associated hierarchical lists, are selected.
d.
Repeat steps a. to c. to select further continuous series of top-level MO s, and those in the associated hierarchical lists, until all the MO s needed for the query have been selected.
or: V. Do the following: a. b. Click the ' + ' button to the left of a top-level MO , to expand its hierarchical list. Click an MO in the list to highlight it.
64
c.
Press and hold <SHIFT> and click another MO , n rows above, or below the originally highlighted MO . Result : A continuous series of MO s is highlighted.
d.
Click the Select All Highlighted MOs button, on the MO Selection toolbar. Result : The continuous series of highlighted MO s, is selected.
e.
Repeat steps a. to d. to select further continuous series of MO s, until all the MO s needed for the query have been selected.
or: VI. Do the following: a. b. c. Click any top-level MO to highlight it. Press and hold <CTRL> and click as many additional toplevel MO s as you require, in any order. Release <CTRL> when you have finished. Result : d. A non-continuous series of top-level MO s is highlighted.
Click the Select All Highlighted MOs button, on the MO Selection toolbar. Result : The non-continuous series of highlighted, toplevel MO s, together with all of the MO s in the associated hierarchical lists, are selected.
or: VI. Do the following: a. b. c. b. c. Click the ' + ' button to the left of a top-level MO , to expand its hierarchical list. Repeat step a. to expand all top-level MO s that are required. Click any MO needed for a query, to highlight it. Press and hold <CTRL> and click as many additional MO s as you require, in any order. Release <CTRL> when you have finished. Result : d. A non-continuous series of MO s is highlighted.
Click the Select All Highlighted MOs button, on the MO Selection toolbar. Result : The non-continuous series of highlighted MO s is selected.
Result :
Any MO that has been selected is used in a query.
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 MO s. For further information, please refer to the "MO Selection Toolbar" section, earlier in this chapter. To help you select MO s on a geographical basis, open a new map window. MO s 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 MO s 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 MO s 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. Do one of the following: I. Click the Lock Visibility button, on the MO Selection toolbar, to unlock visibility. Result: or: II. Do the following: a. Click the Lightbulb icon, to the left of an appropriate MO . Result: The following window displays: MO visibility is no longer locked to whether an MO is selected.
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. Click Yes to continue (or No to abort).
66
Result:
MO visibility is no longer locked to whether an MO is selected, and the chosen Lightbulb icon changes color accordingly.
2.
Do one, or a combination of the following: I. Click individual MO Lightbulb icons as required. Result: II. Each MO is visible in a Result window, and the Lightbulb icon changes color accordingly.
Do the following: a. b. c. d. Click the ' + ' button, to the left of appropriate top-level MO s, to expand their hierarchical lists. Click any appropriate MO to highlight it. Press and hold <CTRL> and click as many additional MO s as you require, in any order. Release <CTRL> when you have finished. Result : e. A non-continuous series of MO s is highlighted.
Click the Toggle Visibility button, on the MO Selection toolbar. Result : All highlighted MO s are visible in a Result window, and the Lightbulb icons change color accordingly.
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 MO s are displayed. However, if the hierarchical list of a visible top-level MO is expanded and then collapsed before running a query, the MO s 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
The MO Profile tool. The MO Group tool.
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. 3. Use the Drag and Drop Area to define a column grouping. Enter a name for the grouping in the Profile combined text field and dropdown list. Click the Save button. Result : The grouping is saved under the appropriate Profile Name .
To retrieve a grouping: 1. Click the arrowhead, positioned to the right of the Profile combined text field and dropdown list. Result : 2. A dropdown list displays.
Select the appropriate Profile Name . Result : The Profile displays in the Managed Object list.
To delete a grouping: 1. 2. 3. Follow steps 1 and 2 above. Ensure that the correct Profile Name displays in the Profile combined text field and dropdown list. Click the Delete button. Result : The Profile is permanently deleted.
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. 3. Select one or more elements from the Managed Object list. Enter a name for the managed object group in the Group combined text field and dropdown list. Click the Save button. Result : The managed object group is saved under the appropriate Group Name .
To retrieve a managed object group: 1. Click the arrowhead, positioned to the right of the Group combined text field and dropdown list. Result : 2. A dropdown list displays.
Select the appropriate Group Name . Result : The managed object group displays in the Managed Object list.
To delete a managed object group: 1. 2. 3. Follow steps 1 and 2 above. Ensure that the correct Group Name displays in the Group combined text field and drop-down list. Click the Delete button. Result : NOTE: If the Group drop-down list is empty, no managed object groups have been saved. The managed object group is permanently deleted.
69
FIND A MANAGED OBJECT

You can search for a managed object in the MO Selection list as follows: 1. Press <CTRL> and <F> at the same time. Result : 2. 3. The Find MO dialog displays.
Enter a search string. Select from the following, as appropriate: I. II. III. Search Up . Find All . Match Case .
4.
Click Find Next . Result : All fields in the MO Selection list are searched for the defined string, according to the selected criteria. When found, the relevant managed objects are highlighted.
THE COLUMN DRAG & DROP AREA.

For further information about the Column Drag & Drop Area , please refer to the "Windows And Panels" chapter, earlier in this Manual.
70
10
The Preset Selection Window
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. User defined presets. Presets created by the user and these can be located anywhere the user desires, but QuantiQa Client GUI will only access presets from the installation /preset directory structure.
In the Preset Selection window the presets of all directories and subdirectories appear within a tree structure. To expand, or collapse a tree level, click the folder. The illustrated tree structure corresponds exactly to the directory structure under the installation /preset directory. For the above example, the preset directory contains the following visible directories: /preset/2G LB QoS; /preset/2G Radio QoS; /preset/Abis_rev_02; /preset/Abis_rev_02/CHARTS; Within the Preset directories are the preset files, either predefined or userdefined. The files, LinkBalance 1800_chart and RxLev_RxQUAL_UL, are just 2 of the many preset files shown available here within the Abis_rev02/CHARTS library directory.
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. Open the Preset Selection window. Select the preset to be modified and right click. Select Edit , Execute or Delete Preset .
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
Select Execute, followed by Map , Table , or Chart . A map, chart or table window is opened, and a query based on the preset is sent to the database. When processing is finished, the result window is populated with the results. Maps, Tables and Charts are described in more detail, later in this Manual.
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
The Counters Selection Window
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
The Ticket Finder Window

Tool Buttons Bar
Tree View List
Ticket Type Fields List
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:
Tool Buttons Bar. This contains all the tools to access the required set of tickets. This is first used to set the time period of interest. Tree View List. This provides lists of the types of tickets for each server that are available on the operator network for the selected time period. The required ticket type is selected here. Ticket Type Fields List. For the selected ticket type, this shows the list of fields that exist. Filters can be applied to these fields to confine the list of tickets to any specific characteristics that the user is looking for.
To access tickets: 1. 2. First select date and time of the investigated time period using the Tool Buttons Bar. Then through the Tree View List select the site server and the type of tickets.
75
3. 4.
Choose any eventual filter to apply using the Ticket Type Fields list. Click on the Select Interval button to find and list the tickets.
The resulting tickets are listed in the Ticket List window.
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 .
T HE T ICKET F INDER T OO L B UTTONS B AR

Refresh Start/Stop/Pause
Start Time End Time
Play Until End
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
This refreshes the server list in the Tree View list, using the defined time interval. The time interval is set by means of the start and end Date and Time controls. Press <ALT> and click this button to display a dialog with a list of DD servers. This can be used to select which servers are synchronized for PDU NEIDs, and to define a timeout setting. The timeout overrides, for the next synchronization only, any setting made using the Options menu. For further information about the Options menu synchronization settings, please refer to the QuantiQa Client User Manual, Part 1 . If a server exceeds the timeout setting, a warning button ( ) displays. When clicked, a list of non-responsive servers is shown.
Select This
Opens a tickets list window that contains all the filtered tickets belonging to date and time values set in the start date and time controls, (i.e. to the right of this button).
Start and End Date
Sets the start and end date of the interested time interval. By clicking over each of the separated fields of the date, the respective value will be highlighted and can be changed by typing in new values or using the keyboard UP and DOWN arrows. The keyboard LEFT and RIGHT arrows can be used to move the highlight from one field to the other. By Clicking on the down chevron the Calendar control will be opened. Using the Calendar control user can set the desired date simply by acting on the proper controls.
Start and End Time
Sets the start and end time of a time interval. By clicking over each of the separated fields of the time, the respective value will be highlighted and can be changed by typing in new values or using the keyboard UP and DOWN arrows. To change the time user can also use the up and down chevrons buttons on the right of the Time control. The keyboard LEFT and
77
RIGHT arrows can be used to move the highlight from one field to the other.
Select Interval
Opens a tickets list window that contains all the filtered tickets belonging to an entire time interval as set by the start and end Date and Time controls.
Play
Opens a tickets list window that contains all the filtered tickets shown in real time. This process continues until user presses the Stop or Pause button.
Stop
Stops the process of showing tickets started by the Play button. If you press the Play button, after having pressed the Stop button, the process of showing tickets will start again from the beginning.
Pause
Pauses the process of showing tickets started by the Play button. To continue the process of showing tickets from where you left it press the Play button again.
Play To End
Opens a tickets list window that contains all the filtered tickets showed in real time from the start time till the end time. The time interval is set by means of the start and end Date and Time controls. If the start time is of the past, the system shows all produced tickets starting from that time, then it shows all other tickets as produced in real time until the end time is reached. Thus the end time can be of the past or in the future.
Profile
Lists all the user defined profiles and provides the ability to set new profiles. Profiles are specific configurations of the Ticket Finder tool filters, which the user can re-use without having to configure the same settings to the Ticket Finder each time. Profiles are XML files saved locally under the neprofiles subdirectory into the QuantiQa Client installation directory, and with the same name as assigned through the profile control but with the .tfp extension.
78
Save
Saves the profile with the name set through the Profile control.
Delete
Deletes the profile with the name set through the Profile control.
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 .
T REE V IEW L IST
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
T ICKET T YPE F IELDS L IST
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.
A DVANCED T ICKET F ILTERIN G

You can also use C language style relational and logical operators.
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 && || Example a && b a || b Description and or
80
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.
DD S ERVER A DVANCED T ICKET F ILTERING

DD server advanced ticket filtering allows you to filter tickets that have variable length fields. To search, for example, for a field that includes the expression 123: 5. Do one of the following: I. or: II. Type a search string, using wildcards, for example, 1*3. Any tickets with a field that includes the search string are highlighted in the Ticket List window. Type 123, or the ASCII equivalent, as the search string.
Result :
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
The Drill Down Filter Window

Tool Buttons Bar
Available Message Types
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 MO s 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 MO s in terms of LACs and Pointcodes. From this pane the MO s 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.
Message Tree List . This provides lists of all the types of PDUs for the users selection of MO s. Unwanted message types can be excluded by turning off their lightbulbs. In the example below only Connection Failures are required.
83
Tool Buttons Bar. This contains the same control arrangement as for Ticket Finder. From here the overall time period is set and data collection can be started, paused, and if necessary stopped. NOTE: If the window is restricted in width, the toolbar will not display the profile facility. If the profile area is not visible, increase the window width.
To access a set of PDUs: 1. 2. 3. First select the MO s of interest. Then from message types pane, exclude all those not wanted. (leaving only the Connection Failures in the given example. 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.
The collected PDUs appear in a Protocol Analyzer window.
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 MO s is apparent. The user may select all those MO s 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 MO s 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 MO s, 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
T HE D RILL D OW N F ILTER T OOL B UTTONS B AR

Refresh Start/Stop/Pause
Start Time End Time
Play Until End
Profile
F IGURE 13.5: T HE TOOL B UTTONS B AR .

The Drill Down Filter Tool Buttons Bar contains all the tools to select the set of PDUs and these are explained below. NOTE: Make sure that the Profile drop down list is visible. If not, widen the window to expose it.
Refresh
This refreshes the list of server in the MO list using the defined time interval. The time interval is set by mean of the start and end Date and Time controls. Opens a protocol analyzer window that contains all the filtered PDUs belonging to date and time values set in the start date and time controls, (i.e. to the right of this button). Sets the start and end date of the interested time interval. By clicking over each of the separated fields of the date, the respective value will be highlighted and can be changed by typing in new values or using the keyboard UP and DOWN arrows. The keyboard LEFT and RIGHT arrows can be used to move the highlight from one field to the other. By Clicking on the down chevron the Calendar control will be opened. Using the Calendar control user can set the desired date simply by acting on the proper controls.
Select This
Start and End Date
86
Start and End Time
Sets the start and end time of a time interval. By clicking over each of the separated fields of the time, the respective value will be highlighted and can be changed by typing in new values or using the keyboard UP and DOWN arrows. To change the time user can also use the up and down chevrons buttons on the right of the Time control. The keyboard LEFT and RIGHT arrows can be used to move the highlight from one field to the other.
Select Interval
Opens a protocol analyzer window that contains all the filtered PDUs belonging to an entire time interval as set by the start and end Date and Time controls.
Play
Opens a protocol analyzer window that contains all the filtered PDUs shown in real time. This process continues until user presses the Stop or Pause button.
Stop
Stops the process of adding PDUs started by the Play button. If you press the Play button, after having pressed the Stop button, the process of showingPDUs will start again from the beginning.
Pause
Pauses the process of showing PDUs started by the Play button. To continue the process of showing tickets from where you left it press the Play button again.
Play To End
Opens a protocol analyzer window that contains all the filtered PDUs showed in real time from the start time till the end time. The time interval is set by means of the start and end Date and Time controls. If the start time is of the past, the system shows all produced PDUs starting from that time, then it shows all other PDUs as produced in real time until the end time is reached. Thus the end time can be of the past or in the future.
Profile
Lists all the user defined profiles and provides the ability to set new profiles. Profiles are specific configurations of the
87
Ticket Finder tool filters, which the user can re-use without having to configure the same settings to the Ticket Finder each time. Profiles are XML files saved locally under the neprofiles subdirectory into the QuantiQa Client installation directory, and with the same name as assigned through the profile control but with the .tfp extension. Save Saves the profile with the name set through the Profile control.
Delete
Deletes the profile with the name set through the Profile control.
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
The Preset Editor
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 Clears the current preset entries and allows the user to add new formula entries. Opens a file browser to allow the user to select a preset file to edit. Allows the user to save the current preset to a user defined file name and folder. Revert to last saved.
Load Preset
Save Preset
Revert to Saved
Add Formula
Creates an entry in the preset editor with some of the columns or fields with default values. The user can modify each field within the preset entry. Duplicates a line in the preset.
Duplicate Formula
Delete Formula
Deletes a line in the preset.
Move Formula Down Moves a line down.
89
Move Formula Up
Moves a line up.
Synchronize Lists
Refreshes the DD Item and Colormap dropdown lists with newly created information from the preset entries. For example, a user may add a new colormap to the colormap directory; the Sync button would rebuild the dropdown list to include the newly added colormap.
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
The Preset Editor
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:
Console entries within QuantiQa that correspond to the print statements within the JavaScript:
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
The Preset Editor
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
The Chart Builder

The Chart Builder is an editor which allows the user to modify existing chart layouts or to build new charts as they will appear on the Chart Result Window. Chart Builder is accessed from the Main Window either using the New Menu by selecting New Chart Builder or from the New Toolbar at the top of the Main Window. The process of modifying or building a new chart involves the following stages : 1. 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.
A) If A Chart Already Exists then it may be modified or a new alternative chart added. B1`) Copy a Chart from Another Preset ? If there is No Existing Chart, the option is offered to select a chart from another preset. B2) Starting without an existing chart .
4.
Setting Chart Properties. After having established the chart by one of the three alternative paths, the named chart is set or modified exactly as required, and finally saved.
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
The Chart Builder
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.
F I G U R E 15.5: C H A R T B U I L D E R , C O P Y "M A I N _TRAF" C O N TA I N I N G 3 C H A R T S .

In the above figure, Chart Builder is preparing to create a chart file for the preset Main2 and a label string below the Copy radio button indicates the charts defined for Main_TRAF are 1pie chart, 1 bar chart and 1 XY chart. On clicking the OK button with the selection as shown in the figure above, all three charts are copied into a newly created Main2 chart file and made available for future use by the Main2 preset. However the Chart Builder dialog showing chart properties is now open for modification of properties of all the copied charts as is usually necessary and subsequent updating of the new chart 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
The Chart Builder
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
S ETTING T HE C HART P ROPERTIES

PIE, BAR
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:
Title Area controls. This group selects the chart, the chart type and determines its title name. 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).
Axis Labels and Orientation . A text string can optionally be included as a title for each of axis. In addition the orientation of the value labels for the x-axis, can be set anywhere between 0 and 360. 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
The Chart Builder
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
TITLE AREA CONTROLS
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.
CHART BUILDER AXIS CONTROLS
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 Chart Builder
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 . T he 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 .
3-D Bar and Line . There are 2 axes, one for Bars and one for Sets. The coordinate settings for the Bars and Sets should not be the same coordinate.
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
The Chart Builder
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 MO s 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 MO s 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
The Chart Builder
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 .
Enter the label for the X axis. The Tick Label field allows you to adjust the angle of the X axis labels. 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.
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 .
Primary and Secondary Y Axis Labels . Enter the label for the Primary and/or Secondary Y axis. If you click Options , you can define:
The Axis Style: Bars. Lines. Step lines. Splines
The Axis Line style: Solid. Dash.
The Axis Scale: Linear. Logarithmic.
108
The Chart Builder
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 .
WIDGETS: SLIDERS AND DROPLISTS

Click Widgets to display the Chart Builder Widgets dialog.
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 : The Chart Builder Legend Options dialog displays.
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. Select the Legend Position that you require. Do one of the following: I. or: II. Click the up, or down arrowhead, positioned to the right of the Distance from chart field, until you have scrolled to the required distance in pixels. Type in the Distance from chart field, how far, in pixels, the legend should be positioned, away from the chart.
4.
Click Close . Result : The Chart Builder Legend Options dialog closes, and the chart legend is displayed.
110
The Chart Builder
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:
Title Area controls. Widgets .
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.
Show colormap ring box. When selected, this displays the formula's colormap as a progressive ring around the circumference of the gauge.
111
Show value box. When selected, this displays the numeric value of the gauge's current needle position in the chart panel. Decimal control. This allows you to define the number of decimal places to which displayed results are rounded. Major tick step control. This allows you to define how often major division marks appear on the face of the gauge. For example, setting the Major tick step control to 5, means that a major division mark will display at every 5 units.
Minor tick control. This allows you to define how often major divisions are subdivided with minor division marks. For example, setting the Major tick step control to 5, and the Minor tick control to 10, means that 10 minor division marks will display, each representing 0.5 units.
Micro tick control. This allows you to define how often minor divisions are subdivided. with micro division marks. For example, setting the Micro tick control to 10, means that a minor division will be subdivided into 10 micro sections. In the example used above, these would each represent 0.05 units.
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
The Map Result Window
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:
The Map Title Bar. The Map Top toolbar. The Map Tools toolbar. The Map Results panel. The Map Color Scale . The Bottom toolbar.
In addition to displaying query results as a map, a Map Result window can also be opened before running a preset, to display the geographical position of Managed Objects that are selected in the MO Selection window. This enables you, for example, to more readily identify the MO s to use when running a preset, according to their location.
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 map title. The Focus State Icon . Standard window control buttons.
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 .
MAP TO P TO OL BA R BUT TONS

The Map top toolbar includes the following buttons and controls:

116
Dragger. Auto Refresh. Global Dropdown List. Lock Drilldown Layer. Drilldown Dropdown List. Autoscale. Print.

DRAGGER
Pixel. Show Only Expanded Rows. Main Layer. Drilldown Layer Threshold.
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. Click the Auto Refresh button. Result : 2. 3. The Auto Refresh Settings dialog displays.
Select Enable . Do one of the following: I. or: Use the scroll arrows to select the number of minutes it should take, until the first refresh should begin.
117
I.
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.
4.
Do one of the following: I. or: I. Click the scroll box text field, and directly type in a value for how often, in minutes, a refresh should take place. Use the scroll arrows to select how often, in minutes, a refresh should take place.
5.
Click OK to proceed, or Cancel to abort. Result: Auto Refresh is enabled, using the defined settings.
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 .
GLOBAL DROPDOWN LIST

The dropdown list contains the names from the preset file when the type identified in the Presets List column is Global or Both. For example, notice the List column for the row Traf indicates Global. This means Traf will appear in the Global Dropdown list on the maps toolbar as is indicated above. If the List column indicated Both then Traf would be listed in the Global Dropdown list and the Drilldown Dropdown list.
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.
DRILLDOWN DROP LIST

The Drilldown Droplist is enabled when the Lock Button is in an unlocked state. The droplist contains the Names from the Preset file when the type identified in the Presets List column is Drill or Both. For example, the List column for the row TrafTA indicates Drill. This means TrafTA will appear in the Drilldown Droplist. If the List column indicated Both then TrafTA would be listed in the Global Droplist and the Drilldown Droplist. When the Lock button (described above) is unlocked then the data from formula listed in the Drilldown Droplist is used on the map.
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 MO s already shown on the map, all selected MO s 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 MO s 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.
MAIN WINDOW TOP TOOLBAR DRILL BUTTON
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.
MAP TO OL S TO OL B AR BUT TON S

The Map Tools toolbar includes the following buttons:
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. Click an appropriate point on a map. Result : or: 1. 2. 3. Click and hold the left mouse button, over an appropriate point on a map. Drag the mouse, to define a map area to zoom in to. The area is highlighted with a dotted rectangle, as you define it. Release the left mouse button. Result : 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. The dotted rectangular highlighting disappears, and the map view zooms in to the defined area. The map view zooms in to an enlargement of the selected area.
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. Click an appropriate point on a map. Result : or: 1. 2. 3. Click and hold the left mouse button, over an appropriate point on a map. Drag the mouse, to define a map area to zoom out from. The area is highlighted with a dotted rectangle, as you define it. Release the left mouse button. Result : The rectangular highlighting disappears, the view zooms out, and a larger area of the map displays, with the portion you defined, at its center. The map view zooms out, and a larger area of the map displays, with the point you clicked at its center.
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. 2. 3. Click and hold the left mouse button, over an appropriate point on a map. 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. Release the left mouse button. Result : The highlighting disappears, and the map view zooms in to the defined area.
PA N
When clicked, the mouse functionality is set to Pan mode. Its cursor is a hand. To use: 1. 2. 3. Click and hold the left mouse button over an appropriate point on a map. Drag the mouse, to scroll the map view. Release the left mouse button. Result : The map view displays a different portion of the map.
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. Click a point on the map, in which you are interested. If you want to select further points: I. II. III. Press and hold <CTRL>. Click further points on the map, until you have selected all the ones, in which you are interested. Release <CTRL>. Result : 3. Cells associated with the selected point(s) are highlighted in red.
Right click a selected point. Result : A dropdown list displays, which enables you to access statistical values (KPIs) assigned to a preset, and as a result, graphically analyze a network problem .
DISABLE DRILL DOWN

When clicked, all cell sticks associated with a drill-down, are removed from the map view. There is no change to mouse functionality, or its cursor's appearance.
SHOW NEIGHBOR CELLS

When clicked, the mouse functionality is set to Show Neighbor Cells mode. Its cursor is a broad arrow. To use: 1. Click an appropriate cell stick. Result : Lines display in the map view, known as "cobwebs", which connect from the selected cell stick, to its target cells, or neighbors.
or: 1. 2. 3. Click an appropriate cell stick. Press and hold <CTRL>, while selecting other cell sticks. Release <CTRL> when finished. Result : Multiple cobwebs display, connecting the selected cell sticks to their targets, or neighbors.
When the QuantiQa Client Handover and Neighbor Management functionality is activated, the cobwebs display as one of three different types of line, depending upon whether:
The neighboring cell is a target of the selected cell stick. The target cell is measured.
124
Target, but not measured. Measured, but not target.
Target and measured.
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. Do one of the following: I. or: II. Click an area of the map view where there is no cell stick. The cobwebs are removed. Click a different cell stick to the one(s) selected.
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. 2. 3. Click and hold the left mouse button, over an appropriate point on a map. Drag the mouse to another point on the same map. Release the left mouse button. Result : The distance between the two points is measured, and displays towards the bottom left corner of the Map window.
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. 2. 3. Click and hold the left mouse button, over an appropriate point on a map. Drag the mouse, to define the map area to select. The area is highlighted with a dotted rectangle, as you define it. Release the left mouse button. Result : The dotted rectangular highlighting disappears, and is replaced by a dotted, rectangular selection box. All cell locations within the box are selected. The corresponding Managed Objects are highlighted in the MO Selection window.
4. 5.
If you want to make further selections, press <CTRL> while repeating steps 1 to 3. Release <CTRL> when finished.
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. 3. Click the left mouse button, over an appropriate point on a map. Move the mouse to the next point on the same map, and define the first side of the polygon. Click the left mouse button. Result : 4. 5. The side of the polygon is highlighted with a dotted line.
Repeat steps 2 and 3, until you have defined all the sides of the polygon you require. Double-click the left mouse button to close the polygon. Result : The dotted linear highlighting disappears, and is replaced by a dotted, polygon-shaped selection box. All cell locations within the box are selected. The corresponding Managed Objects are highlighted in the MO Selection window.
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. Click the Layer Manager button. Result : A Layer dialog displays. This shows a list of all of the layers, which combine to make up the active map. The dialog provides several control options, for example, Visible , which toggles a layer's display properties between visible and invisible.
2. 3. 4. 5.
Select The layer that you want to manage, in the Layer dialog. Select the control option(s) that you require. Repeat steps 2 and 3, until you have made all necessary changes. Press <ENTER>. Result : The active map refreshes, and displays with the chosen options.
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:
The Projection Category. The Projection Category Member.
The projection displayed, is the result of combining the Projection Category and Projection Category Member settings.
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. Click the File Manager button. Result : 2. Click Add... Result : 3. 4. 5. A Windows Explorer window displays. The Third Party Map File Manager window displays.
Navigate to the folder where the map files, which you want to associate with QuantiQa Client, are stored on your computer. Select the appropriate files. Click Open . Result : The name of the map file(s) display in the Third Party Files list.
128
6.
Select a map file in the Third Party Files list. Result : The file path displays in the File Path panel.
7. 8. 9.
Use the controls in the File Properties panel to adjust the map's visibility and transparency. Repeat steps 6 and 7, as required. Click OK . Result : The Third Party Map File Manager window closes, and the third party map is displayed, according to the settings that you have defined.
To remove a third party map: 1. Click the File Manager button. Result : 2. The Third Party Map File Manager window displays.
Select the map that you want to remove in the Third Party Files list. Result : The file path displays in the File Path panel.
3.
Click Remove . Result : The map file is deleted from the Third Party Files list.
4.
Click OK . Result : The Third Party Map File Manager window closes, and the map display refreshes.
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. Ensure that the required Map window is visible. Click the Map window's Title Bar. Result : The Map window is activated, and the Map Tools toolbar buttons are available.
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:
A long black stick indicates L1 layer (usually assigned to GSM900). A medium length dark blue stick indicates L2 layer (usually assigned to GSM1800). A short dark purple stick represents L3 layer (usually assigned to FDD UMTS).
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 MO s 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 MO s in the MO Selection Window. For multiple MO s 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
Distance Measurement Label. Blending Tools. Map (Blending Tool). Feat (Blending Tool). Image Sizing Tools.
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.
M AP W ITH A N OT A N UMBER (N AN ) R ESULT
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.
A N E XAMPLE O F U SING D RILLDOWN

The following sequence of figures show:
A map of a network area that shows where most Drops occur. The worst performing cell is identified, and its performance examined. Tickets are obtained for the instances of Drops. The list of PDUs is obtained for one of the tickets. See measurements after Handover is complete.
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
The Table Result Window
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
Individual Cell Selection. Table Options. Column/Field Chooser. Collapse All Groups. Expand All Groups. Normalization Dropdown List.
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. Click the Auto Refresh button. Result : The Auto Refresh Settings dialog displays.
143
2. 3.
Select Enable . Do one of the following: I. or: I. 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. Use the scroll arrows to select the number of minutes it should take, until the first refresh should begin.
4.
5.
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.
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 .
COLLAPSE ALL GROUPS

All column groupings in the grid area collapse. A + sign is visible next to the name of those elements that are collapsed.
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. Sum of All Formulas. Normalizes according to the sum of all the values of all the formulas in the preset.
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
The Chart Result Window
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.
C HART L AYOUT A ND R ESULTSET

When a query result is received by the result window, a file containing the layout of the charts will be read. The layout file will indicate :
The chart type for each chart. The initial resultset coordinates for each chart. Whether sliders or dropdown lists are available on the bottom toolbar of the charts dialog window.
149
The number of charts is determined by the number of chart descriptions in the chart layout file. The available chart types in the layout file are :
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.
CHART TITLE BAR
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
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.
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. Click the Auto Refresh button. Result : 2. 3. The Auto Refresh Settings dialog displays.
Select Enable . Do one of the following: I. or: I. 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. Use the scroll arrows to select the number of minutes it should take, until the first refresh should begin.
4.
5.
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.
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. Click the Save button. Result : 2. The Save As dialog displays.
Click the downwards arrow, to the right of the Save as type text field. Result : A dropdown list of possible file types displays.
3.
Select the appropriate file type.
155
4.
In the Chart Selection panel, do one of the following: I. or: I. If you want to save all displayed charts, select All slider positions . If you only want to save the active chart, select Current slider position only.
5.
In the Size panel do one of the following: I. or: I. Select Custom size , then do one of the following: a. or: a. Use the arrows next to the Width and Height fields to scroll to the desired size in pixels. Type the required size in pixels, in the Width and Height text fields. Select Use current size to save the selection at the resolution it/they appear at, on the screen.
6.
In the File name text field, do one of the following: I. II. or: I. II. or: I. Click the downwards arrow to the right of the File name text field. Result : II. A dropdown list of names displays. Position the cursor before, or after the currently displayed name. Type in any addition to the name that you require. Highlight the name that is currently displayed. Type in any name that you require.
Select a name from the list.
7.
Do one of the following: I. Click Save to proceed. Result : or: I. Click Cancel to abort. Result : All actions are canceled, and the Save As dialog closes. The chart/s are saved at the size, and in the format selected. The Save As dialog closes.
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. Click the Print button. Result : 2. 3. 4. The Print dialog displays.
In the Select Printer panel, double click the name of the printer that you want to use. Click Preferences and change the printer parameters, if required. In the Chart Selection panel, do one of the following: I. or: I. If you want to print all displayed charts, select All slider positions . If you only want to print the active chart, select Current slider position only.
5.
In the Size panel do one of the following: I. or: I. Select Fit to page . Select Use current size to print the selection at the resolution it/they appear at, on the screen.
157
6. 7.
Select the number of copies that you want to print. Do one of the following: I. Click Print to proceed. Result : or: I. Click Cancel to abort. Result : All actions are canceled, and the Print dialog closes. The chart/s are printed at the size selected. The Print dialog closes.
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
When an item checkbox is set the item is included in the chart.
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. Sum of All Formulas. Normalizes according to the sum of all the values of all the formulas in the preset.
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.
W IDGETS : S LIDE RS A ND D ROPDOWN L ISTS

The sliders and dropdown lists at the bottom of the Chart Result window are configurable. The definition of the sliders and dropdown lists are made in the chart layout file using the Chart Builder. As mentioned previously the query resultset contains the values or measurements used to plot the points on the charts. To extract values from the resultset structure there are 6 coordinates, MO , ROP, ITEM, X, Y and Z. The sliders and droplists are defined using the 6 coordinate types.
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 MO s 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 MO s 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 MO s 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 MO s 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
In the situation where there are no sliders or dropdown lists, default coordinate values are used to retrieve the measurements from the resultset. The measurements for the map will not change. The values used to plot the chart will change only if Cumulative or Normalization are turned on because these 2 modes use the results of calculations done on the original retrieved measurement. When setting Autoscaling it appears the chart values have changed but this mode affects the minimum and maximum settings on the colormap scale. Autoscaling uses the original measurements to plot the chart.
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 MO s 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 MO s 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 MO s 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
TWO DIMENSIONAL BAR CHART
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
THREE DIMENSIONAL BAR AND LINE CHART
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 MO s 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 ROP:11/12 12:00 11/12 13:00 > red bar or line ROP:11/12 13:00 11/12 14:00 > green bar or line ROP:11/12 14:00 11/12 15:00 > blue bar or line MO-44017699 ROP:11/12 12:00 11/12 13:00 > red bar or line ROP:11/12 13:00 11/12 14:00 > green bar or line ROP:11/12 14:00 11/12 15:00 > blue bar or line and so on for each MO with each ROP. Keep in mind the settings for the 4 other coordinate types of ITEM, X, Y and Z are also in the retrieval. So the true settings used in the retrieval from the resultset would be similar to: MO-44017698, ITEM-Traf, X-0, Y-0, Z-0 ROP:11/12 12:00 11/12 13:00 > red bar or line ROP:11/12 13:00 11/12 14:00 > green bar or line ROP:11/12 14:00 11/12 15:00 > blue bar or line MO-44017699, ITEM-Traf, X-0, Y-0, Z-0 ROP:11/12 12:00 11/12 13:00 red bar or line
ROP:11/12 13:00 11/12 14:00 > green bar or line ROP:11/12 14:00 11/12 15:00 > blue bar or line and so on for each MO with each ROP.
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
The Ticket List Window
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:
A specific search as made by the Ticket Finder dialog. A Drilldown from a KPI/KPM displayed on a map or in table. The use of the Drilldown Filter dialog to select a ticket. A Drill Up, or Trace Up from a PDU under analysis.
The Ticket List is a table presenting one or more tickets/procedures for analysis and the table contains the summary information for each ticket. The Ticket List table includes the standard column sorting and rearrangement facilities to help organise the table and gather details as required from the tickets. If needed the user can double click a ticket row to drill down to protocol analysis for still deeper study of its messages and their contents. NOTE: If a ticket list is already open and in use, it can be overwritten by a subsequent ticket list. To avoid this, use the New Toolbar button to open a new ticket list and leave this selected before creating another ticket list.
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
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
The Ticket List Window
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
The Protocol Analyzer Window

PDU List Pane 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.
P ROTOCOL A NALYSIS T OOLBAR
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
Protocol Analyzer View. Trace Diagram View. Mixed View. Find Text. Column Chooser. Refresh. Export.
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.
TRACE DIAGRAM VIEW

Clicking on the Trace Diagram button selects display of the Trace Diagram only, showing message flow.
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
PDU L IST PANEL
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 :
Trace the PDUs procedure. Drill up to the PDUs ticket. Export the PDU (in Text, Binary of Wireshark formats). Select all PDUs.
T RACE T HE PDU P ROCEDURES

From a selected PDU the user can trace other procedures in which this PDU is included. After a Right mouse click and selecting Trace procedure, 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 corresponding procedure list is displayed.
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
Figure 9.6: The Visibility Is Locked Window........................................................................................66 Figure 9.7: The MO Profile And Group Toolbar...................................................................................67 Figure 9.8: The MO Selection Window, Displaying A NAME And AntType Column Grouping.............69 Figure 10.1: The Preset Selection Window.........................................................................................71 Figure 10.2: Preset Selection With The Context Menu.......................................................................72 Figure 10.3: Preset Editor Disconnections_Analysis...........................................................................72 Figure 11.1: Counters Selection With Counters..................................................................................73 Figure 12.1: The Ticket Finder Window...............................................................................................75 Figure 12.2: The Ticket List Window With Selected Tickets................................................................76 Figure 12.3: The Tool Buttons Bar.......................................................................................................76 Figure 12.4: Calendar Control Example..............................................................................................79 Figure 12.5: The Tree View List..........................................................................................................79 Figure 12.6: Ticket Type Fields List.....................................................................................................80 Figure 12.7: Examples Of Advanced Ticket Filtering Expressions......................................................81 Figure 13.1: The Drill Down Filter Window..........................................................................................83 Figure 13.2: A PDU List Window Generated Using A Drill Down Filter................................................84 Figure 13.3: The MO Filter List...........................................................................................................85 Figure 13.4: Protocol And Message Lists............................................................................................85 Figure 13.5: The Tool Buttons Bar.......................................................................................................86 Figure 13.6: Calendar Control Example..............................................................................................88 Figure 14.1: The Preset Editor With Toolbar And Columns.................................................................89 Figure 14.2: Editing A Preset...............................................................................................................90 Figure 14.3: Preset Editor Map Types.................................................................................................92 Figure 15.1: Empty Chart Builder Window..........................................................................................95 Figure 15.2: Preset Assigned, With and Without Existing Chart..........................................................95 Figure 15.3: Typical Chart Builder Window, Ready For Editing Properties..........................................96 Figure 15.4: Adding A New Chart........................................................................................................97 Figure 15.5: Chart Builder, Copy "Main_TRAF" Containing 3 Charts..................................................97 Figure 15.6: Chart Builder: Edit A Copy Of A Chart Layout With 3 Charts...........................................98 Figure 15.7: The New Chart Dialog.....................................................................................................99 Figure 15.8: Build A New Pie Chart.....................................................................................................99 Figure 15.9: The Three Different Types Of Chart: Pie, Bar and XY...................................................101 Figure 15.10: Edit Properties For A Pie Chart...................................................................................102 Figure 15.11: Chart Builder Title Controls.........................................................................................102 Figure 15.12: Chart Builder Axis Control For Pie And 2-D Bar..........................................................102 Figure 15.13: Chart Builder Axis Control For 3-D Bar And Line........................................................103 Figure 15.14: Pie Chart Coordinates.................................................................................................103 Figure 15.15: 2-Dimensional Bar Chart Coordinates.........................................................................104 Figure 15.16: 3-Dimensional Chart Coordinates...............................................................................104 Figure 15.17: Chart Builder Coordinates...........................................................................................104 Figure 15.18: Chart Builder Show As Area........................................................................................105 Figure 15.19: Chart Builder Custom Area.........................................................................................105 Figure 15.20: Chart Builder Custom Labels......................................................................................106 Figure 15.21: Chart Builder X Axis, Primary Y And Secondary Y Axis Label Panels......................................................................................................................106 Figure 15.22: Example Of A Chart With Two Y Axes.........................................................................107 Figure 15.23: The Custom X Axis Labels Dialog...............................................................................108 Figure 15.24: The Y Axis Options Dialog...........................................................................................109 Figure 15.25: Chart Builder Widgets Dialog......................................................................................109 Figure 15.26: The Chart Legend.......................................................................................................110 Figure 15.27: The Chart Builder Legend Option Dialog.....................................................................110 Figure 15.28: Build A New Gauge Chart............................................................................................111 Figure 17.1: The Map Result Window...............................................................................................115 Figure 17.2: Map Title Bar.................................................................................................................115 Figure 17.3: Map Top Toolbar............................................................................................................116 Figure 17.4: Example Of A Preset File With Column Entries.............................................................116 Figure 17.5: Auto Refresh In Disabled Mode.....................................................................................117 Figure 17.6: Auto Refresh In Enabled Mode.....................................................................................117 Figure 17.7: Notification Of Next Auto Refresh..................................................................................118
186
Table Of Figures
Main Window Top Toolbar Drill Button...............................................................................................119 Figure 17.8: Map Autoscale Is Off.....................................................................................................120 Figure 17.9: Map Autoscale Is On.....................................................................................................120 Figure 17.10: The Map Tools Toolbar................................................................................................121 Figure 17.11: Examples Of Cobwebs When Using The Show Neighbors Mode...............................125 Figure 17.12: The Managed Objects For The Above Example..........................................................125 Figure 17.13: Projection Examples...................................................................................................128 Figure 17.14: Map With 2 Cell Locations..........................................................................................130 Figure 17.15: Cell Location With Traf Data.......................................................................................131 Figure 17.16: Cell Location With Traf TA Data. ................................................................................131 Figure 17.17: Selected Element On Map And MO Selection Window...............................................132 Figure 17.18: Depiction Of 2 Cell Sectors, Left Has Multiple MOs And Right Has One MO..............132 Figure 17.19: Colormap Scale With Slider And Thumbs, High And Low...........................................133 Figure 17.20: Textbox With The Thumb Value..................................................................................134 Figure 17.21: Map Bottom Toolbar....................................................................................................134 Figure 17.22: Distance Between Cell Locations................................................................................135 Figure 17.23: Partial GIS Map With Map Area Faded.......................................................................136 Figure 17.24: Partial GIS Map With Feat Faded...............................................................................136 Figure 17.25: Maximum Possible Size Of TA Image.........................................................................137 Figure 17.26: ROP Speed/Play Button With Speed Options.............................................................138 Figure 17.27: Map Showing The Drilldown TA Vector With Values And Non-Values...........................................................................................................................138 Figure 17.28: A Drill down Example..................................................................................................139 Figure 18.1: Table And Records In A Table Results Window.............................................................141 Figure 18.2: Table Title Bar...............................................................................................................142 Figure 18.3: Table/Record Toolbar....................................................................................................142 Figure 18.4: Auto Refresh In Disabled Mode....................................................................................143 Figure 18.5: Auto Refresh In Enabled Mode.....................................................................................143 Figure 18.6: Notification Of Next Auto Refresh.................................................................................144 Figure 18.7: Table Options Dialog.....................................................................................................145 Figure 18.8: Table Column/Field Chooser Dialog..............................................................................146 Figure 18.9: Table Normalization Options.........................................................................................146 Figure 18.10: Column Drag Area And Column Titles.........................................................................147 Figure 18.11: Table With NAN Values...............................................................................................147 Figure 19.1: Chart Window With 3 Chart Images, 3 Dropdown Lists And 1 Slider..................................................................................................................................149 Figure 19.2: Chart Window Title Bar.................................................................................................150 Figure 19.3: Chart Window Top Toolbar............................................................................................151 Figure 19.4: Auto Refresh In Disabled Mode....................................................................................152 Figure 19.5: Auto Refresh In Enabled Mode.....................................................................................152 Figure 19.6: Notification Of Next Auto Refresh.................................................................................153 Figure 19.7: Three Chart Panels Unlocked And Editable..................................................................153 Figure 19.8: The Panel Title Bar........................................................................................................154 Figure 19.9: The Save As Dialog.......................................................................................................155 Figure 19.10: The Print Dialog..........................................................................................................157 Figure 19.11: Autoscale With Data Choices......................................................................................158 Figure 19.12: Disable Formula Items List..........................................................................................159 Figure 19.13: Table Normalization Options.......................................................................................159 Figure 19.14: Autoscale Is Off And Color Scale Range Is Between 0 5.........................................160 Figure 19.15: Autoscale Is On And Color Scale Range Is Min And Max Of Result Values...................................................................................................................161 Figure 19.16: Example Of MO ROP Item Dropdown Lists And X Slider On The Bottom Toolbar................................................................................................................161 Figure 19.17: MO Slider With Range Of 4.........................................................................................162 Figure 19.18: MO Dropdown List With MO Names...........................................................................162 Figure 19.19: 2D Bar With MO Dropdown List = 44017698..............................................................163 Figure 19.20: 2D Bar With MO Dropdown List = 44017721..............................................................163 Figure 19.21: Pie Chart With Angle, Height, Color And MO Dropdown List......................................164 Figure 19.22: Pie Chart With No Sliders Or Dropdown Lists Defined................................................164
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 Italy Via delle Fonti, 8/e 50010 Scandicci Florence Italy Telephone: +39 055 737 54 Fax: +39 055 737 5666 UK Annex 1 Worting Business Park Church Lane, Basingstoke Hampshire RG23 8PX UK Telephone: +44 1256 817 640 Fax: +44 1256 811 876 USA Suite 200-300 1022 S Greenville Ave. Allen TX 75002 USA Telephone: +1 469 656 4900 Fax: +1 214 383 5999 Brazil Av. Das Americas 3434 Bloco 5 Sala 503 22640-102 Rio de Janeiro Brazil Telephone: +55 21 3431 3738 Fax: +55 21 3431 3739

Ug1 0502 00en

Uploaded by

Document Information

Original Description:

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Ug1 0502 00en

Uploaded by

Copyright:

Available Formats

QuantiQa Client

Software Releas e 2.0

Conventions Used In This Document

QuantiQa Client User Manual Part 1

QuantiQa Client Main Window................................................3

R EARRANGING Q UANTI Q A C LIENT ' S A PPEARANCE.......................................6

The Main Menu.............................................................................7

Select A New Menu Command........................................................10

T HE V IEW M ENU ...................................................................................10

Display, Hide, Or Locate A View Menu Item.................................13

QuantiQa Client User Manual Part 1

T HE TOOLS M ENU .................................................................................13

Select A Tools Menu Command......................................................15

T HE H ELP M ENU ..................................................................................15

Select A Help Menu Item.................................................................16

T IME G RID TOOLBAR .............................................................................18

Windows and Panels................................................................23

User Defined Windows.....................................................................24

Windows With Tables.......................................................................24

I MPORT PA S YMBOLS ............................................................................37

The Main Selection Window..................................................45

T HE S ERVER S ELECTION PANEL ..............................................................46

T HE D ATE S ELECTION PANEL ................................................................48 T HE C ALENDAR S ELECTION PANEL ..........................................................49

T HE D AY T IME S LOT PANEL ...................................................................51 T HE A GGREGATION M ODE S ELECTION PANEL ............................................52

QuantiQa Client User Manual Part 1

MO Hierarchy, Hierarchy Level And Property Based Aggregation .............................................................................................................52

The MO Selection Window.....................................................57

S ELECTING M ANAGED O BJECTS ..............................................................63

Find A Managed Object....................................................................70 The Column Drag & Drop Area.......................................................70

The Preset Selection Window...............................................71

The Counters Selection Window..........................................73

The Ticket Finder Window.....................................................75

The Drill Down Filter Window...............................................83

The Preset Editor......................................................................89 The Chart Builder......................................................................95

The Map Result Window.......................................................115

T HE M AP TOOLS TOOLBAR ...................................................................121

QuantiQa Client User Manual Part 1

A CTIVATE A M AP W INDOW ..................................................................129 T HE M AP R ESULTS PANEL ...................................................................129

M AP C OLOR S CALE .............................................................................133 M AP B OTTOM TOOLBAR .......................................................................134

Image Sizing Tools.........................................................................137 ROP Tools........................................................................................137

M AP W ITH A N OT A N UMBER (N AN ) R ESULT ........................................138 A N E XAMPLE O F U SING D RILLDOWN .....................................................139

The Table Result Window.....................................................141

The Chart Result Window....................................................149

A UTOSCALE E XAMPLES ........................................................................160 W IDGETS : S LIDERS A ND D ROPDOWN L ISTS............................................161 P IE C HART.........................................................................................165

QuantiQa Client User Manual Part 1

The Ticket List Window........................................................173

The Protocol Analyzer Window..........................................177

PDU L IST PANEL ...............................................................................180 T RACE T HE PDU P ROCEDURES...........................................................180

B EFORE Y OU R UN Q UANTI Q A C LIENT

QuantiQa Client User Manual Part 1

QuantiQa Client Main Window

T HE M AIN W INDOW A FTER Y OU S TART Q UANTI Q A C LIENT F OR T HE F IRST T IME

QuantiQa Client User Manual Part 1

Main Menu Toolbars Time Grid Toolbar Main Selection Window

Title Bar And Standard Windows Controls Ticket Finder Window

Panels Docking Area For Other Windows

Tabbed Windows Status Bar

QuantiQa Client Main Window

T HE M AIN W INDOW C OMP ONEN TS

QuantiQa Client User Manual Part 1

R EARRANGING Q UANTI Q A C LIENT ' S A PPEARANCE

The Main Menu