NIMS-USM-OAM5 0 0 - v3 04 PDF

NIMS-PrOptima
TM
For W-NMS
Release 1.40b
The Next Generation Performance Management Solution for Wireless Operators
User Manager
User Manual
V3.04
Table of Contents
1. INTRODUCTION............................................................................................................................ 3
1.1. INTRODUCTORY INFORMATION .................................................................................................................... 3
1.2. USERS ........................................................................................................................................................... 3
1.3. TERMINOLOGY ............................................................................................................................................. 4
1.4. CONVENTIONS .............................................................................................................................................. 4
1.5. VERSION & SCOPE ....................................................................................................................................... 4
1.6. PUBLICATION DATE ..................................................................................................................................... 4
1.7. OTHER MANUALS ........................................................................................................................................ 4
1.8. COPYRIGHT INFORMATION ........................................................................................................................... 4
1.9. CUSTOMER SUPPORT CONTACT INFORMATION ........................................................................................... 5
2. INITIAL LOGIN & FILE MENU.................................................................................................. 7

2.1. CHAPTER INTRODUCTION ............................................................................................................................. 7
2.2. INITIAL LOGIN .............................................................................................................................................. 7
2.3. MESSAGE LOG MENU ITEM ......................................................................................................................... 7
2.4. QUIT MENU ITEM ......................................................................................................................................... 8
3. FEATURES MENU ......................................................................................................................... 9

3.1. CHAPTER INTRODUCTION ............................................................................................................................. 9
3.2. CHECK DATABASE INTEGRITY MENU ITEM................................................................................................. 9
3.2.1. Correcting a Test Failure ..................................................................................................................... 10
3.3. USERS AND GROUPS MENU ITEM .............................................................................................................. 11
3.3.1. Create a User ....................................................................................................................................... 12
3.3.2. Create a Group..................................................................................................................................... 13
3.3.3. Delete a User ....................................................................................................................................... 14
3.3.4. Delete a Group..................................................................................................................................... 14
3.3.5. Create Like .......................................................................................................................................... 14
3.3.6. Assign Users to Groups ....................................................................................................................... 16
3.3.7. Direct Features Editor.......................................................................................................................... 17
3.4. EDIT FEATURES MENU ITEM...................................................................................................................... 19
3.4.1. Feature Management ........................................................................................................................... 19
3.4.2. Predefined Reports .............................................................................................................................. 21
3.4.3. Value Provider..................................................................................................................................... 25
3.4.4. Cell Item Styles ................................................................................................................................... 30
3.4.5. Conditional Styles................................................................................................................................ 32
3.4.6. User Rights .......................................................................................................................................... 33
3.4.7. Login Action........................................................................................................................................ 40
3.5. MANAGE DIMENSIONS MENU ITEM ........................................................................................................... 41
3.5.1. Cube Dimension Manager ................................................................................................................... 41
3.5.2. Tool Palette Hierarchy......................................................................................................................... 44
3.5.3. Create a Codified Dimension .............................................................................................................. 48
User Manager user manual - Ref: PRO-SUP-USM-NOR-133-3.04-EN
Copyright MYCOM International 2006
Table of Contents
3.6. SCHEDULED REPORTS MENU ITEM ............................................................................................................ 49
3.6.1. Sorting the Scheduled Report List....................................................................................................... 50
3.6.2. Removing an Existing Scheduled Report............................................................................................ 50
3.6.3. Adding and Configuring an Automatic Report ................................................................................... 50
3.6.4. Modifying Automatic Reports ............................................................................................................ 54
4. ANNEXES...................................................................................................................................... 55
4.1. USING ONLINE HELP .................................................................................................................................. 55
4.2. LIST OF ABBREVIATIONS ........................................................................................................................... 56

Chapter 1: Introduction
Chapter 1- Introduction
1.1. Introductory Information
The User Manager is a standalone application providing the NIMS-PrOptima administrator with an easy way to
manage user rights and thus be the user rights administrator. The User Manager administrator can grant and
deny access to different features and provide information to different users in a user-friendly way. In other words,
this application makes it possible for different users of NIMS-PrOptima to access different applications depending on their profile.
In addition, it allows the NIMS-PrOptimafor W-NMS administrator to customize features that are not directly
accessible in the NIMS-PrOptimafor W-NMS main application, such as selecting the ranges and colors of the
color-coding in the GIS or modifying the presentation of the hierarchy of dimensions in the Report Builder GUI.
The User Manager provides the following benefits:
z
Users from different departments/backgrounds can have a personalized application, making it easier for
them to adapt it to their tasks.
The NIMS-PrOptimafor W-NMS administrator can control access rights to information, thus making
sure that only experts are allowed to make sensitive modifications and helping to control the information flow between departments.
It facilitates access right management.
Information is easier for the user to manage, so that only relevant reports corresponding to a given user
profile are available.
The administration management process is sped up and the risk of mistakes decreases thanks to specifically developed Graphical User Interface elements.
NIMS-PrOptimafor W-NMS administrators can quickly and easily implement additional customized
changes.
The User Manager presents convenient features enabling the administrator to:
z
Add, create, or modify a formula
Save a report in the shared repository
Manage (create, modify, remove, or assign) users and groups
Assign features to users and/or groups
Manage the predefined report tree
Manage the Dimension Palette tree
Check and repair problems that occur in the database
Note: This manual presents the main functions of the User Manager interface in order to provide NIMS-PrOptimafor W-NMS administrators and users with the essential information for using the User Manager. The two
first menus of the User Manager menu bar (i.e. File and Features) contain all of the essential features.
Figure 1: User Manager Menu Bar
1.2. Users

The NIMS-PrOptimafor W-NMS User Manager is specifically adapted to the mobile telecommunications
network information domain. This manual is primarily intended for Super Users and System Administrators who
are given the task of user and group rights assignment.
1.3. Terminology
The vocabulary used in this manual includes GSM (for example: BSC, MSC, BTS, etc.), GPRS, and UMTS
terminologies.
1.4. Conventions
The typographical conventions used in this manual are the following:
z
Bold face:
Keywords
Italics:
Button, icon, tab, field, and menu item names in Notes, Results, and Warnings
Italics boldface:
Button, icon, tab, field, and menu item names in an explained procedure
ALLCAPS:
Control key sequences
Underline:
Notes, Warnings, and Results.
The special symbolic conventions used in this manual are the following:
This type of bullet indicates an action to be performed (for example Click on OK)
1.5. Version & Scope

This document is version 3.04 of the User Manager manual and is referenced as PRO-SUP-USM-NOR-133-3.04EN. The information provided in this manual is specific to the User Manager administration tool of NIMSPrOptima for W-NMS Release 1.40b (OAM v5.0.0).
1.6. Publication Date

This document was released on December 13, 2006 and is valid until the publication of the next document version
in the series.
1.7. Other Manuals

For information on using the NIMS-PrOptima for W-NMS software, please refer to the manuals listed below.
Document
Reference code
Importation Control Manager User Manual

NIMS-PrOptima User Manual
PRO-SUP-USM-NOR-123-3.02-EN
PRO-SUP-USM-NOR-124-3.06-EN
1.8. Copyright Information

Copyright MYCOM International 1996-2006.
All rights reserved. The present document cannot be duplicated in any way without prior written consent of
MYCOM International. The information included in this document is for reader personal use only.
Trademarks: NIMS, PrOptima, and NIMS-PrOptima are all trademarks of MYCOM International Inc. All
other products mentioned in this document are the property of their respective owners.
4

1.9. Customer Support Contact Information

Please contact Nortel for technical support. For product and documentation issues a Service Request should be
opened following regular Nortel support channels.
Contact us through the web at: http://www.nortel.com
Select the Service Requests option in the Support menu, then select the region where you are located.


Chapter 2: Initial Login & File Menu
Chapter 2- Initial Login & File Menu

2.1. Chapter Introduction
This chapter describes how to log into the User Manager application and presents the two items of the File menu,
i.e. Message log and Quit.
Figure 2: File Menu List Items
2.2. Initial Login

The initial login process identifies the user. Depending on the identity, some features are available and other features are hidden (refer to subsection 3.3.7.1. Assign Feature Rights to Owners on page 17 and subsection 3.4. Edit
Features Menu Item on page 19).
To log in, you need to obtain a Login and Password from the administrator.
Figure 3: User Manager Login Window
2.3. Message Log Menu Item

In the User Manager, it is possible to open a Message Log that logs all the messages that appeared in the application.
Menu bar sequence: Select File->Message log in the menu bar.
OR Shortcut sequence: Press F5
Result: A Message log window appears.

Chapter 2: Initial Login & File Menu
Figure 4: Message Log
The window is divided into two fields:

z
The Message field lists all the log messages and displays the following for each log message:
A severity icon (i.e. information icon, error icon, emergency icon).
A timestamp for the message.
A brief description of the message.
The Detail field displays a detailed description of the message selected in the Message field.
There are two icons in the top right-hand corner of the window:
The Save As... icon allows you to save a copy of the message log in a selected location.
The Clear icon allows you to clear the message log.
2.4. Quit Menu Item

This menu item allows you to exit the User Manager application.
Menu bar sequence: Select File->Quit in the menu bar.
OR Shortcut sequence: Press ALT-F4
Result: The application will close after presenting a confirmation message.

Chapter 3: Features menu
Chapter 3- Features menu

3.1. Chapter Introduction
The Features menu contains all the important functions of the User Manager. This menu contains the features that
are necessary for the administrator to assign rights and properties to users.
Warning: You must log in as administrator to access the parameters explained in this section.
Please remember throughout this manual that the word administrator refers to the User Manager
administrator and not as the NIMS-PrOptima administrator. This means that when you are logged into the
User Manager as administrator, you have all the rights for user right administration, but it does not mean that you
automatically have all the rights for the NIMS-PrOptima features. If you want to have all the rights for the
NIMS-PrOptima features, you will have to assign yourself all the rights on all the features using the User right
Monitor tool, which is described later in this chapter.
Figure 5: Features menu items
3.2. Check Database Integrity Menu Item

Warning: This feature is only accessible if you have logged in as administrator.
The tests launched through this menu are configuration integrity checkers. In other words, they ensure that the
database is reliable. They check two tables of the database which are important for user management (i.e.
user_feature and value_provider) and check the problems that might occur, e.g. a table entry referencing another
table entry which does not exist.
Menu bar sequence: Select Features->Check database integrity in the menu bar.
OR Shortcut sequence: Press CTRL-C
Result: A Database Integrity Check window appears.
Figure 6: Database Integrity Check

Click on the Test button.
Result: A Test results window opens. It provides the test results of the two database tables:
value_provider and user_failure. Each test result displays as either Passed or Test failed with [number]
error(s).

Figure 7: Test results window reporting Passed tests
Figure 8: Test results window reporting one error
3.2.1. Correcting a Test Failure

If the test fails, you should follow one of the two following procedures:
Click on the List button(s) to identify the problem.
Result: A Missing foreign keys test details window opens.

Note: The screenshot below shows the window for a test that has reported one error in the
"user_feature" table (which is stored in the database).
10

Figure 9: Missing Foreign Keys Test Details
Warning: The Should Delete column provides a checkbox that is checked by default, since the best way to get a
clean database is to delete the wrong entries.
Click on the Fix button to correct the problem automatically. It fixes the problem by deleting the wrong
entry.
OR Click directly on the Fix all button in the Test results window.
Note: The Fix all button repairs all identified problems by deleting all the wrong entries.
3.3. Users and Groups Menu Item

This menu item allows the administrator to manage the various characteristics of users and groups.
Menu bar sequence: Select Features > Users and groups in the menu bar.
OR Shortcut sequence: Press CTRL-U
Result: A window called Users and Groups appears.

11
Figure 10: Users and Groups window
In this window, there are two tabs:

z
The Users tab displays information on all the registered users (i.e. icon, user name, and description).
The Groups tab displays information on all the registered groups (i.e. icon, group name, and description).
Note: All of the buttons in the button panel on the lower right hand side are disabled.
3.3.1. Create a User

Perform the procedure below to create a new user.
In the Users tab, click on the New... button.
Result: A window called User Profile appears. The OK button is disabled and only the Cancel button is
enabled.
Figure 11: User Profile Window

Enter information in the empty fields.
Description: Enter a small description of the user profile (e.g. NIMS-PrOptima tester).
Login: Enter the login assigned to the user.
Password: Enter the password associated to the user login.
Confirmation: Confirm the password by re-entering it.
Note: The Id and Class fields are automatically filled by the User Manager. The Id field contains the
user or group ID number and the Class field contains either User or Group depending on whether
you are creating a new user or group.
12

Figure 12: Category pull-down menu in User Profile window

Note: Once the text has been typed in the Description and Login fields, the OK button is enabled.
Click on OK.
Result: A dialog window opens asking whether you wish to create a calculation home for the user.
Figure 13: User Manager calculation home creation confirmation dialog window
A calculation home, in this context, is the users folder of calculations. It appears in the Calculation
panel of the Palette and is only available to the user it was created for.
Click on Yes or No depending on whether you wish to create a calculation home for the user.
Result: The new user appears in the Users list of the Users and groups window.
3.3.2. Create a Group

Perform the procedure below to create a new group (of users).
In the Groups tab, click on the New button.
Result: A window called Group Profile appears. The OK button is disabled and only the Cancel button
is enabled.
Figure 14: Group Profile window

Enter information in the empty fields.
Description: Enter a small description of the group profile (e.g. All NIMS-PrOptima testers).
Login: Enter the login assigned to the group (e.g. test).

13
Note: The Id and Class fields are automatically filled by the User Manager. The Id field contains the
user or group ID number and the Class field contains either User or Group depending on whether
you are creating a new user or group.
Note: When text has been typed in the Description and the Login fields, the OK button is enabled.
Click on OK.
Result: A dialog window opens asking whether you wish to create a calculation home for the group.
Figure 15: User Manager calculation home creation confirmation dialog window
A calculation home, in this context, is the groups folder of calculations. It appears in the Calculation
panel of the Palette and is only available to the members of the group it was created for.
Click on Yes or No depending on whether you wish to create a calculation home for the group.
Result: The new Group that has been created appears in the Groups list.
3.3.3. Delete a User

Perform the procedure below to delete a user:
In the Users tab, select a User in the list.
Click on the Delete button.
Result: A delete confirmation message appears.

Click on Yes.
Result: The selected user entry is removed from the list.

Warning: Do not delete the user associated with the ReportScheduler.Login property. This would prevent the Alarm module from connecting to the MDDS server thus causing the Alarm module to be unusable.
Refer to the Installation manual subsection concerning the "Synchronisation.properties" to know where this property is located and to edit it if necessary.
3.3.4. Delete a Group

Perform the procedure below to delete a group (of users).
In the Groups tab, select a group in the list.
Click on the Delete button.

Click on Yes.
Result: The selected group entry is removed from the list.
3.3.5. Create Like

This procedure describes how to create a new entry that has the same set of characteristics as an existing entry.
Perform the following procedure to create a new user similar to another user.
In the Users tab, select a user in the list and then click on the Create like... button.
14

Result: A window called Create User Profile appears.

Enter information in the empty fields (Description, Login, Password, etc.).
Note: Once text has been typed in the Description and Login fields, the OK button is enabled.
Click on OK.
Result: The new user appears in the Users list.

Double-click on the newly created user entry.
Result: The User Profile window appears for that entry.

Click on the Groups button.
Result: A window called Group Chooser appears. The groups associated with the newly created user
are the same as those of the original user entry that the new user is based on.
Figure 16: Group Create Like Feature
A similar procedure can be followed to create a new group similar to another group.
In the Groups tab, select a group in the list and then click on the Create like button.
Result: A window called Create Group Profile appears.

Enter information in the empty fields (Description, Login, Password, etc.).
Note: Once text has been typed in the Description and the Login fields, the OK button is enabled.
Click on OK.
Result: The new group appears in the Groups list.

Double-click on the newly created group entry.
Result: The Group Profile window for that entry appears.

Click on the Users button.
Result: A window called User Chooser appears. The users associated with the newly created group are
the same as those of the original group entry that the new group is based on.

15
Figure 17: User Create Like Feature
3.3.6. Assign Users to Groups

It is possible to assign users to groups either from the point of entry of a specific user or from the point of entry of
a group. Both methods produce the same result (i.e. a specific user belonging to a specific group) and the procedure is identical for both users and groups in their respective Chooser windows. Therefore, a single explanation is
provided below for the assignment procedure (i.e. adding and removing) of both Users and Groups.
In the User Chooser (or the Group Chooser) window:
3.3.6.1. Add One User or Group

Select one user (or group) entry in the Unselected elements field (on the left) and click on
Result: The user (or group) has been transferred from the Unselected elements field (on the left) to the
Selected elements field (on the right).
3.3.6.2. Add Several Users or Groups

Select two or more users (or groups) in the Unselected elements field (to select multiple groups, hold
down the SHIFT or CTRL button while clicking on the entries).

Click on
Result: The users (or groups) have been transferred from the Unselected elements field to the Selected
elements field.
3.3.6.3. Remove One User or Group

Select one user (or groupexcept the everybody group) in the Selected elements field.
Note: It is not possible to remove the everybody group. If you try to remove this group, a warning message appears which indicates that you can not remove any user from the group of all users.
Click on
16

Result: The user (or group) has been transferred from the Selected elements field (on the right) to the
Unselected elements field (on the left).
3.3.6.4. Remove Several Users of Groups

Select two or more groups (except the Group of all users group) in the Selected elements field (to select
multiple groups, hold down the SHIFT or CTRL button while clicking on the entries).
Note: It is not possible to remove the Group of all users group. If you try to remove this group, a warning message appears which indicates that you can not remove any user from the group of all users.
Click on
Result: The groups have been transferred from the Selected elements field to the Unselected elements
field.
Click on OK.
Result: The changes are made.
3.3.7. Direct Features Editor

The Direct Feature Editor displays all the features which are associated to a selected user or group. The procedure for adding and removing features is identical for both users and groups. Therefore, a single explanation is
provided below.
Feature:
A feature is any aspect of use of NIMS-PrOptima that can be limited in terms of user and group access.
Select a user or a group in the User and groups window.
Result: A User Profile or Group Profile window appears.

Click on the Direct Features button.
Result: A window called Direct Feature Editor appears.
Figure 18: Direct Feature Editor.
3.3.7.1. Assign Feature Rights to Owners

Click on the Add Button in the Direct Feature Editor window.
Result: A Feature Chooser window appears.

Select a feature type in the Type pull-down menu.

17
Note: For information on the different feature types which appear in this pull-down menu, refer to
subsection 3.4. Edit Features Menu Item on page 19 of this manual. All features are presented separately.
Figure 19: Feature Chooser Type pull-down menu

Select one or more feature(s) in the list at the bottom of the window.
Click on the Add Button.
Result: The Feature Chooser window closes and the selected feature(s) is added to the list in the Direct
Feature Editor window.
Note: It is also possible to perform this action the other way round, that is to say assign owners to features. Refer
to subsection 3.4.1.1. Assign Owners to Features on page 20 of this manual.
3.3.7.2. Remove features

Select one or more features in the list in the Direct Features window.
Click on the Remove button.
Result: A warning message appears which indicates that you are about to remove features.
Figure 20: User Manager delete confirmation dialog window

Click on Yes.
Result: The selected features is removed from the list.
3.3.7.3. All Features

The All Features function displays all the features of a selected user and all the groups to which the user belongs.
This function can only be accessed in the User Profile window.
Click on the All Features button in the User Profile window.
Result: The Feature Editor window appears. A list of all features available for the user (owner) is displayed. These include:
18

All of the features in the Direct Features window applicable for that particular user.
All of the features applicable to all the groups that the user belongs to (i.e. all users).
3.4. Edit Features Menu Item

3.4.1. Feature Management
The Edit Features item allows the administrator to manage the user-dependent features that can be found in
NIMS-PrOptima .
Feature:
A "feature," in this context, is any aspect in the use of NIMS-PrOptima to which user and group access can be
limited through the granting or denying of user rights.
Owner:
An owner, in this context, refers to any user who has user rights to a feature.
Menu bar sequence: Select Features->Edit Features in the menu bar.

OR Shortcut sequence: Press CTRL-E

Note: This is the same window as the one used to assign features to users (refer to
subsection 3.3.7.1. Assign Feature Rights to Owners on page 17 of this manual).
Figure 21: Feature Chooser Window
The Feature type section of the window gives information concerning the feature selected in the Type pull-down
menu. The information given is the following:
19

z
Id: The ID number of the feature type. In the example above, the Value Provider feature types ID number is 4.
Name: The name of the feature type, e.g. Conditional styles, Predefined Report, etc.
Feature table: The name of the feature table for this feature type in the database, e.g. value_provider for
the Value Provider feature type.
The Features part of the window gives a list of the features of this feature type.
Note: The edit functions change according to the type of feature selected in the Type pull-down menu. For example, the Owner... and Edit... buttons are not always both available for all feature types.
z
Owner... button: The Owner... button grants users and/or groups access to specified features. The process of granting or denying access (i.e. adding and removing) to features is identical for all feature
types. Therefore, the process is explained only once for one type of feature.
Edit... button: The modification process of feature types (via the Edit... button) varies according to the
feature type. Feature editing procedures are described per feature type after this explanation on assigning owners rights to a feature.
3.4.1.1. Assign Owners to Features

Select, for example, the Conditional styles option in the Feature Chooser pull-down menu.
Select a feature in the Features field.
Click on the Owner... button.
Result: A Feature Owner window appears. It is divided up into two sections:

z
Features details: This part of the window gives the following information (which is greyed out and thus
cannot be modified in this window).
Type: The type of feature, e.g. Conditional styles, Predefined Report, etc.
Id: The ID number of the feature. In the example below, the Value Provider features ID number is 8.
Name: The name of the feature, e.g. BCCH, Region, etc.
Owners: This part of the window shows which groups and users have user rights for the feature.
Note: This window allows the administrator to determine who has access (individual users or groups) to
a given feature.
Figure 22: Feature Owner window

Click on the Add... button in the Feature Owner window.
20

Result: An Owner Chooser window appears. It displays a list of users and groups and provides information on their Type, Description, and Login.
Figure 23: Owner Chooser Window

Select a user in the list and click on OK.
Result: The Owner Chooser window closes, and the Feature Owner window now displays the selected
feature.
The Owner Chooser window contains the following elements:
The Type column shows whether the owner is a user
or a group
The Description column gives a brief description of the owner.
The Login column gives the user or group login.
3.4.1.2. Remove an Owner from the Features List

Select a feature in the list of the Feature Chooser window.
Click on the Owner... button.
Select an owner (user or group) in the Owner field of the Feature Owner window.

Click on Yes.
Result: The selected user or group has been removed from the list in the Feature Owner window.
3.4.2. Predefined Reports

This item allows the NIMS-PrOptima administrator to manage the structure and contents of the Predefined
Reports palette that appears in NIMS-PrOptima , as well as the permissions associated with this palette.
3.4.2.1. Add or Remove an Owner for Predefined Reports Features

The procedure for adding and removing an owner for a feature is described in subsection 3.4.1. Feature
Management on page 19 of this manual. The same procedure is used for all features.
3.4.2.2. Edit the Predefined Reports

This function allows you to modify the Predefined Report hierarchy tree which appears in the Predefined Reports
palette in NIMS-PrOptima .
21
Select Predefined Reports in the Type pull-down menu at the top of the Feature Chooser window.
Click on the Edit... button.
Result: The Predefined Report Manager window appears.
Figure 24: Predefined Report Manager
The Predefined Report Manager window is divided into two panes:

z
The Published reports pane gives a list of the predefined reports that are already available in the Predefined Reports palette in NIMS-PrOptimaTM for W-NMS. It shows the predefined reports and their
folders exactly as they appear in the Predefined Reports palette.
The Available reports pane gives a list of all the predefined reports that exist that are not available in the
Predefined Reports palette in NIMS-PrOptimaTM for W-NMS. The pull-down menu at the top allows
you to choose the file extension of the predefined reports file types (i.e. .pcd, .pgc, .rgr, .rpt) so that only
the desired type of predefined reports is displayed in the pane.
3.4.2.3. Add a Folder

Adding folders and subfolders can be useful when you want to modify the structure or appearance of the Predefined Reports palette for a better overview or organization of the predefined reports.
Without selecting anything in the left field, click on the Folder... button.
Result: A Name chooser window appears.
Figure 25: Name Chooser Window

Enter the name for the new folder and click on OK. For example, enter Network Administrator.
Result: A subfolder now appears (in the left field) under the root folder of the tree.
22

Note: It is not possible to create a folder at the same level as the root folder.
Figure 26: New Predefined Report Folder
3.4.2.4. Add a Subfolder

To create a subfolder within a folder (in this example, in the Network Administrator folder), follow the procedure
described below.
Click on the Folder... button with the previous folder (Network Administrator) selected in the left field.
Figure 27: Name chooser window

Note: The selected folder (Network Administrator) will be the parent folder for the new folder.
Enter a name in the Name chooser window and click on OK.
Result: A subfolder is added to the Network Administrator folder.

23
Figure 28: New Predefined Report Subfolder
3.4.2.5. Add a Predefined Report

This function allows you to add a specific predefined report to a folder in the Predefined Reports palette.
Open a folder in the right field of the window and select a predefined report.
Drag a report from the right field and drop it into the left field.

Enter the name of the predefined report as you want it to appear in the Predefined Reports palette and
click on OK.
Result: The predefined report appears where you dropped it and with the name you assigned.
Note: You can move this predefined report to any folder or subfolder in the left field. In the screenshot
below, it was dropped in the Predefined Report subfolder.
24

Figure 29: Add Predefined Report
3.4.2.6. Remove Folder or Leaf

Select one or more items in the left field.
Note: It is not be possible to select the root for deletion.

Click on the Delete button or press the Delete key.
Result: A delete confirmation window appears.
Figure 30: Predefined Report deletion confirmation message

Click on Yes.
Result: The selected items have been removed. This type of feature allows you to associate one or more
predefined reports to users.
3.4.3. Value Provider

The Value Provider creates value categories (consisting of a range of values) for configuring the Geographical
Information System (GIS) view of NIMS-PrOptima for W-NMS. It allows the user to customize the representation of Network Elements in the GIS view by associating their counters or their attributes with colors or sizes. For
example, you can choose to highlight a specific Performance Counter by its color so as to make all the cells on
which this counter is applied in the GIS view stand out. Refer to subsection 7.13. Using Color, Size, and Filter
Coding in the NIMS-PrOptima for W-NMS User Manual for further information.
25
3.4.3.1. Add or Remove an Owner for Value Provider Features

3.4.3.2. Add a Value Provider

Select the Value Provider item in the Feature Chooser pull-down menu and click on Edit...
A Value Provider Editor window appears. It is composed of the following columns:
Id: This column contains the ID number of the Value Provider.
Name: This column contains the name of the Value Provider, e.g. Call Drops, Carried Traffic, etc.
Moc Def: This column contains the Managed Object Class Definition, e.g. Cell, FDDCell, etc.
Format Str: This column contains the format of the string where # is a placeholder for any digit and
0 is a placeholder for any digitif the digit is not there, the result is padded with zeros, e.g. a format"#.000" applied to the value 1.2 will display "1.200"
Property Type: This column contains the property type that defines the Value Provider, e.g. counter,
forumula, etc.
Property Name: This column contains the name of the defining property, e.g. call drop, offered traffic, etc.
Vp Type: This column contains information on the type of Value Provider (to be more precise, the
Value Provider bean).
Click on the Add button in the Value Provider Editor.
26

Result: A window called Value Provider Monitor appears. Fields for Id, Name, Moc def, Format string,
Property type, Property name, and Color Coding are either empty, set to -1, or set with a default value in
the pull-down menu. The fields correspond to the columns in the Value Provider Editor.
Figure 31: Value Provider Monitor

Add the desired values in the appropriate fields
Click on OK.
Result: The new Value Provider is added to the list.
3.4.3.3. Edit the Value Provider

Select the Value Provider item in the Feature Chooser pull-down menu.
Result: A window called Value Provider Editor appears. It displays a table containing columns named
Id, Name, Moc Def, Format String, Property type, Property name, and VP Type.
Note: If no entry has been selected in the list, then the Modify, Remove, and Ranges buttons are disabled.
Double-click on an entry in the Value Provider Editor table, or select an entry in the table and click on
the Modify button.

Result: A window called Value Provider Monitor appears.
Change one or more values.
Click on OK.
Result: The selected Value Provider is displayed in the list with the modified values.
3.4.3.4. Delete a Value Provider

Select a feature in the Value Provider Editor list.

Click on Yes.
Result: The selected Value Provider is removed from the list.
3.4.3.5. Codekey Ranges Editor

The Codekey Ranges Editor allows you to set a visual representation of thresholds using color-coding.
In the Value Provider Editor window, select a feature that is either a counter or a formula (look in the
Property Type column). For example, select Traffic in the list.

27
Result: The Ranges button is enabled.

Click on the Ranges button.
Result: A window called Editing <the name of the value provider you selected> Ranges appears.
Figure 32: Range editor
Add a Range
Click on the Add button in the Editing ranges window.
Result: A new row is added to the table with a From/To range that is based on the preceding From/To
range (if none, a default value is set).
Modify a Range
Double-click on a range in the To column.
Enter a new value.
Note: The new value is accepted if it is a value that is after the To value of the previous range and before
the From value of the following range.
Delete a Range
Select a range.
Result: The row is deleted and the next ranges From value is updated.
Spread Ranges
The Spread Ranges function allows you to customize the range of colors that are displayed with respect to the
staggered categories of any value provider.
Click on the Spread... button.
Result: A Spread ranges editor window appears.
Figure 33: Spread ranges editor
28

Insert the appropriate values in the fields. For example, change the threshold values (i.e. the Min range
and Max range fields) or the colors for displaying the ranges (i.e. the Min range color and Max range
color fields).
Result: When you click on the Choose color fields, a Color chooser window opens.
Note: The Spread function creates a gradation scale between the color of the Min range value and the
color of the Max range value.
Figure 34: Color chooser

Click on OK to add the new color for the Min range color in the Spread ranges editor.
Repeat the same action to change the Max range color.
Figure 35: Spread ranges editor after modifying colors

Click on OK in the Spread ranges editor.

29
Result: All of the values and colors are evenly spread between the first (minimum) and last (maximum)
values.
Figure 36: Range editor after spread
To edit colors without using the Spread function:

Select a counter or a formula in the Value Provider Editor and click on Ranges.
Select one row in the Editingranges window and click in its Color column field.
Result: A Color chooser window appears.

Choose a color in the color palette.
Click on OK.
Result: The color is applied to the selected row.
3.4.4. Cell Item Styles

A Cell Item Style is a style (background and foreground colors and font) that applies to a member or a combination of members of a dimension in any position of the dimension in a table (thus serving as a marker for those
members). For example, you can use this feature to highlight a particular site in every table report that you create
or use.
The Cell Item Style feature allows you to manage which users and groups share any given cell item style for table
cells of a report. It is also possible to modify specific style presentation (color, font, etc.) aspects for cell item
styles.
3.4.4.1. Add or Remove an Owner of Cell Item Styles Features

3.4.4.2. Edit a Cell Item Style

Select the Cell Item Styles in the Feature Chooser pull-down menu.
Select an entry in the list.
Result: A window called Cell Item Styles Editor appears. It displays the following columns:
30
Id: This column contains the Cell Item Style ID number.
Name: This column contains the name of the Cell Item Style:
Background: This column contains the color configuration for the background, e.g. 255,206,163
(RGB).
Cell Location: This column contains the coordinates for the location of the cell.
Font: This column contains the chosen font, font style, and size for the cell, e.g. Arial, italic, 12.
Foreground: This column contains the color configuration for the foreground, e.g. 255,206,163.
Note: If you have not selected an entry in the list, then the Modify and Remove buttons are disabled.
Figure 37: Cell Item Styles Editor

Click on the Modify button.
Result: A window called Cell Item Styles Monitor appears.

Note: Only the Name field is enabled. The different fields correspond to the columns in the Cell Item
Styles Editor.
Figure 38: Cell Item Styles Monitor

Change the Name and click on OK.
Result: The selected Cell Item Style displays the modified values.
3.4.4.3. Delete a Cell Item Style

Select a Cell Item Style in the Cell Item Styles Editor table.

Click on Yes.
Result: The selected Cell Item Style has been removed from the list.

31
3.4.5. Conditional Styles

The Conditional Style feature allows you to apply thresholds in order to represent special values with specific colors. A Conditional Style applies to a calculation. It allows you to color the cells of a table according to the contained value (result of the calculation). It can be progressive (regular color gradation between two values) or
threshold-based (color 1 under the threshold, color 2 above the threshold). If two thresholds are defined, then progressive color-coding is applied. If only one threshold is defined, then values above the threshold are in color 1
and values below the threshold are in color 2.
3.4.5.1. Add or Remove an Owner for Conditional Styles Features

3.4.5.2. Edit a Conditional Style

Select Conditional styles in the Feature Chooser pull-down menu.
Select an entry in the Features list.
Click on the Edit button.
Result: A window called Conditional Style Editor appears. It displays a list which contains columns
named Id, Name, Idf Calculation, Background 1, Background 2, Thresh 1, and Thresh 2.
Double-click on an entry in the Conditional Styles Editor list or select an entry in the list and click on
the Modify button.

Result: A window called Conditional Styles Monitor appears. It contains fields (which correspond to the
columns of the Conditional Styles Editor) for:
Id: This field contains the Conditional Style ID number.
Name: This field contains the Conditional Syle name.
Idf Calculations: This field contains the foreign key ID number for the Calculations table.
Background 1: This field contains one of the background colors.
Background 2: This field contains the other background color.
Thresh 1: This contains one of the thresholds.
Thresh 2: This contains the other threshold.
Note: The threshold is expressed in the same units as in the columns or rows of the table. If the threshold is a percentage, it should be expressed in decimals where 0.25 equals 25%, 0.5 equals 50%, 1 equals
100%, etc.
Note: Only the Name and the Threshold fields are enabled.
Figure 39: Conditional Styles Monitor

32

Change the name or the thresholds.

Click on OK.
Result: The selected Conditional Style displays the modifications made.
3.4.5.3. Delete a Conditional Style

Select a Conditional Style in the table.

Click on Yes.
Result: The selected Conditional Style is removed from the list.
3.4.6. User Rights

The User rights feature allows you to assign users rights for the Calculation Palette of the NIMS-PrOptima
front-end application.
With these rights, the administrator can determine whether the user has the right to:
z
Access to the folders in the Calculation Palette.
View, edit, create, or delete formulas.
View, Acknowledge, Clear, delete, or set Alarms on threshold.
Schedule a report.
Note: All these user rights are listed and explained further on in this manual (in the table of subsection 3.4.6.2.
Edit the User rights).
3.4.6.1. Add or Remove an Owner for User Rights Features

3.4.6.2. Edit a User Right

Select User Rights in the Feature Chooser pull-down menu.

33
Result: A window called User Right Editor opens. It displays a list of the user rights applied to the
NIMS-PrOptima Calculation Palette.
Figure 40: User Right Editor window
The columns in the User Right Editor are the following:
Id: This column contains the ID number of the user-assigned User Right.
Node: This column contains the type of node that is the subject of the calculation.
Right: This column contains the precise user right.
Member: This column contains the user or group that owns the user right.
34

Result: A window called User Right Monitor opens.
Figure 41: User Right Monitor

Select a member in the Members pull-down menu.
Select a calculation folder in the view zone which displays a view of the Calculation Palette as it is dis-
played in the NIMS-PrOptima front-end application.

35
Note: The Expand all button allows you to see all the nodes of the Calculations tree.
Figure 42: Selection of calculation folder in User Right Monitor

Select a right in the Rights pull-down menu.
User Rights table

The table below describes all the rights that can be selected in the User Right Monitor.
Right
FolderNotAllowed
FolderAllowed
ViewFormulaInFolder
ModifyCalculationInFolder
CreateOrDeleteFormulaInFolder
CreateOrDeletePreAggregationInFolder
AlarmNoAccess
AlarmReadAccess
AlarmOperatorAccess
AlarmAdministratorAccess
SchedulingNotAllowed
36
Action
The user will not see the calculation folder selected (in the NIMSPrOptima Calculation Palette).
The user will see the content of the calculation folder selected (in the
NIMS-PrOptima Calculation Palette) but will not be able to see the
content of the formulas in this folder (when he performs a right-click
on one of the formulas).
The user will see the content of the calculation folder and will be able
to see the content of the formulas in this folder (when he performs a
right-click on one of the formulas).
The user will be able to see and modify formulas.
The user will have all the administration rights for the formulas. He can
create, modify, and delete them.
The user will be able to create and define pre-aggregated formulas
from the NIMS-PrOptima Calculation Palette
The user will have no access to the Alarm module.
The user will only be able to consult the alarms in the Alarm module.
The user will be able to consult, "acknowledge" (indicate that the
problem has been taken into account and will be repaired), and "clear"
the alarm (indicate that the alarm is repaired to the administrator).
The user will have all the administration rights on the Alarm module.
He will be able to set the alarm threshold (create the alarm evaluation)
and to delete alarms.
The user will have no access to the report scheduling feature.

Right
Action
SchedulingAllowed
The user will have all the administration rights for the report
scheduling feature.
Note: This right can only be assigned to folders, not to calculations
themselves.
Warning: NIMS-PrOptima for W-NMSs super users must be given the CreateOrDeleteFormulaInFolder, the
AlarmAdministratorAccess and the SchedulingAllowed user rights.
Click on OK.
Result: The User Right Monitor closes and the new user right appears in the list of the User Right Editor
window.
3.4.6.3. Example: Granting Access to Metrics/Formulas in NIMS-PrOptima for W-NMS

This example shows the complete procedure that the administrator should follow to grant access to Metrics/Formulas in NIMS-PrOptima for W-NMS.
Note: The procedure is the same for the other user rights.
Log into the User Manager as Administrator
Select Features->Users and groups
Result: The Users and groups window opens.

Create or select a user.
Result: A User profile window appears.

Click on the Direct Features button.
Result: A Direct Feature Editor window appears.

Click on the Add button.

In the Type pull-down menu select User rights
Result: A User Right Editor window appears.
Figure 43: User Right Editor window

Result: A Users Right Monitor window appears.

37
Select the user you have created (or the one you selected) in the Members pull-down menu, e.g. demo in
the example below.
Figure 44: Members pull-down menu in User Right Monitor

Select the CreateOrDeleteFormulaInFolder option in the Rights pull-down menu.
Figure 45: Selection of CreateOrDeleteFormula option in Rights pull-down menu

Click on the folder or subfolder to which the CreateOrDeleteFormulaInFolder user rights should apply.
Click on OK.
38

Result: The new user right appears in the User Right Editor window.
Figure 46: New user right displayed in User Right Editor

Click on the Close button.
Result: The new user right also appears in the Features list of the Feature Chooser window.
Select the new user right in the Feature Chooser window.
Result: The user right appears in the Direct Feature Editor window.
Figure 47: New user right displayed in Direct Feature Editor

Click on the Close button.
Click on OK in the User Profile window.
Click on the Close button in the Users and groups window.
Now start NIMS-PrOptima and log in as the user to whom you assigned the new user right (in this
example, demo).
Press CTRL+F2
Result: The Palette window appears.

39
Click on the Calculation tab of the Palette and then right-click on a metric/formula which belongs to the
folder or subfolder to which the user rights were applied.

Result: A pop-up menu appears displaying Edit and Delete options. The metric/formula can be edited or
deleted by selecting one of these options (refer to the Editing and Creating Calculations subsection in
the NIMS-PrOptima User Manual).
Figure 48: Pop-up menu with access to formula editing and deletion in the Calculation Palette
3.4.7. Login Action

It is possible to configure the User Manager in order to automatically open specific windows, palettes, or files
when you log into NIMS-PrOptima .
3.4.7.1. Add or Remove an Owner for Login Action Features

3.4.7.2. Add a Login Action

Select Login action in the Features Type pull-down menu of the Feature Chooser and click on the Edit
button.
Result: A Login Action Editor window opens. It displays a list which contains the following columns:
Id: This column contains the ID number of the Login Action.
Name: This column contains the name of the Login Action.
Priority: This column contains the priority attributed to the Login Action. It determines the order of
the Login Actions (i.e. the Login Action with priority 1 is carried out first, followed by the Login
Action with priority 2, etc.)
Comment: This column contains a comment regarding the Login Action.
Click on the Add button in the Login Action Editor window.
Figure 49: Login Action Editor
40

Result: A Login Action Monitor window appears.
Figure 50: Login Action Monitor

Click on the Build... button.
Result: A Login Action Name Dialog window appears.

Open the Login action pull-down menu and select a view type.
Note: If you select OpenPredefinedReport or OpenFile, then the Parameter button is enabled so that
you can define further parameters (e.g. which specific predefined report to open).
Figure 51: Login Action Name Window
3.4.7.3. Edit the Login Action

Select Login action in the Features Type pull-down menu of the Feature Chooser and click on the Edit
button.
Result: A Login Action Editor window opens. It displays a list which contains columns called Id, Name,
Priority, and Comment.
Double-click on an entry in the list or select an entry in the table and click on the Modify button.
Result: A Login Action Monitor window appears.

Click on Build... and change the Priority or the Comment.
3.4.7.4. Delete a Login Action

Select a Login Action in the Login Action Editor table.

Click on Yes.
Result: The selected Login Action has been removed from the list.
3.5. Manage Dimensions Menu Item

3.5.1. Cube Dimension Manager
The Cube Dimension Manager allows the NIMS-PrOptima administrator to create a cube dimension for all
users.
Warning: After creating the cube dimensions, the administrator needs to use the Tool Palette hierarchy window
to select the created dimensions and have them displayed in the NIMS-PrOptima Client palette.
41
3.5.1.1. Open the Cube Dimension Editor

Menu bar sequence: Select Features->Manage dimensions->Cube dimension in the menu bar.
OR Shortcut sequence: CTRL-D
Result: The Cube Dimension Editor window appears.
Figure 52: Cube Dimension Editor
The following columns are displayed in the Cube Dimension Editor:

z
Id: This column contains the ID number of the Cube Dimension.
Short name: This column contains the short name of the Cube Dimension.
Attribute: This column contains the attribute of attribute-based Cube Dimensions. The attributes are
divided up into MOC Def categories.
MocDef: This column contains the Managed Object Class Definition of the Cube Dimension.
Axis: This column contains the axis category of the Cube Dimension, e.g. NE, Time, etc.
Dim_id: This column contains the dimension ID number.
Flags: This column contains the flags associated with the Cube Dimension (depending on which option,
if any, is selected in the Flag field of the Cube Dimension Monitor).
Long name: This column contains the long name of the Cube Dimension.
Granularity: This column contains the time granularity (expressed in minutes) of the Cube Dimension.
3.5.1.2. Create a Cube Dimension

42

Result: A Cube Dimension Monitor window appears.
Figure 53: Cube Dimension Monitor

Fill out the fields (which correspond to the columns of the Cube Dimension Editor window).
Warning: Please indicate a Dimension ID that is different to -1.

Note: The OK button will be enabled when you enter a Long Name.
Select an item in the MOC definition pull-down menu.
Click OK.
Result: The new Cube Dimension has been added in the Cube Dimension Editor window.
Use the Tool palette hierarchy window to add the newly created dimension in the NIMS-PrOptima
Client (in the Dimension Palette).
3.5.1.3. Modify a Cube Dimension

Double-click on an entry in the list or select an entry in the table and click on the Modify button.
Result: A Cube Dimension Monitor window appears.

Change one or more values.
Click on OK.
Result: The selected entry displays the modified values.
3.5.1.4. Delete a Cube Dimension

Select an entry in the table.

Click on Yes.
Result: The selected Cube Dimension has been removed.
3.5.1.5. Assign a Name and Member ID to a Cube Dimension

43
Since the NIMS-PrOptima program cannot display non-numeric characters, attribute-based Cube Dimension
names need to be converted into numeric values. These numbers are automatically assigned by the User Manager
program, however if you wish to assign a particular number and name you can do so through the Special Dim
Member Editor... window.
After creating an attribute-based Cube Dimension (by checking the Attribute based dimension radio
button), close the Cube Dimension Monitor window. In the Cube Dimension Editor window, select the
Cube Dimension in question and click on the Modify button.
Result: The Cube Dimension Monitor window opens and the Dim member... button is activated.
Note: If you do not close the Cube Dimension Editor window after creating the Cube Dimension, the
Dim member button remains grey.
Click on the Dim member button.
Result: A Special Dim Member Editor... window opens.

Result: A Special Dim Member Monitor window opens containing three fields: Id, Name, and Mem_ Id.
In the Name field, enter the name of the Cube Dimension as you would like it to appear and then enter
the number you wish to associate to this string in the Mem_Id field. The Id field is greyed out because
the ID number is automatically assigned by the program.
Click on OK in the Special Dim Member Monitor window.
Close the Special Dim Member Editor on cube dimension window.
Click on OK in the Cube Dimension Monitor window.
Reselect the previously chosen Attribute in the Attribute list of the Cube Dimension Editor.
Warning: Every time you open the Cube Dimension Monitor window for modifications the Attribute field resets
itself to the first item in the list.
Result: The Cube Dimension is displayed with the chosen name and member ID in the Codified dimensions list of the NIMS-PrOptima Dimension Palette.
3.5.2. Tool Palette Hierarchy

The Tool Palette Hierarchy Manager allows you to modify the Dimension Palette hierarchy for all users.
3.5.2.1. Open the Tool Palette Hierarchy Manager

Menu bar sequence: Select Features->Manage dimensions->Tool palette hierarchy in the menu bar.
OR Shortcut sequence: Press CTRL-T
44

Result: The Tool Palette Hierarchy Manager window appears.
Figure 54: Tool Palette Hierarchy Manager
3.5.2.2. Add a Folder

Right-click on a folder (root included) in the tree and select Create folder from the pop-up menu.
Note: The pop-up menu is different if you right-click on the tree root or on a folder of the tree.
Figure 55: Tool Palette Hierarchy Pop-up Menu

OR Select a folder in the tree (root included) and click on the Create folder... button of the Tool Palette
Hierarchy Manager window.

45
Result: The Tool Palette Hierarchy Monitor window appears.
Figure 56: Tool Palette Hierarchy Monitor

Enter the name of the folder you wish to create in the Label field (the Id is automatically assigned by the
User Manager) and click on OK.

Result: The folder is created in the selected location.
3.5.2.3. Delete a Folder

Right-click on a folder (not the root) and select Delete folder... in the pop-up menu (or select and drag
the folder outside of the window).

OR Select the folder in the tree (not the root) that you wish to delete and click on the Delete button of
the Tool Palette Hierarchy Manager window.

Click on Yes.
Result: The folder and its contents have been deleted.
3.5.2.4. Edit a Folder

Right-click on a folder (not the root) and select Edit folder... in the pop-up menu.
OR Select the folder in the tree (not the root) that you wish to edit and click on the Edit button of the
Tool Palette Hierarchy Manager window.

Result: The Tool Palette Hierarchy Monitor appears.
Modify the data and click on OK.
Result: The folder has been modified.
3.5.2.5. Add a Node

Right-click on the folder (root included) in the tree and select Create node in the pop-up menu.
Note: The pop-up menu is different if you right-click on the tree root or on another folder of the tree.
OR Select a node in the tree (root included) and click on the Create node... button of the Tool Palette
Hierarchy Manager window.

Fill out the fields.
Select the nodes Cube Dimension from the Cube dimension pull-down menu.
Enter the filename of the icon to be used to represent the node in the Icon filename field.
Click on OK.
46

Result: The node is created in the same folder as the selected node or folder, as displayed in the second
screenshot below.
Figure 57: Selection of a Cube Dimension in the Tool Palette Hierarchy Monitor
Figure 58: Cube Dimension node added to the Codified Dimensions folder
3.5.2.6. Delete a Node

Right-click on a node (except the root) and select the Delete node ... item in the pop-up menu (OR select
and drag the node outside of the window).

OR Select a node in the tree (except the root) and click on the Delete button of the Tool Palette Hierar-
chy Manager window.

Click on Yes.
Result: The node has been removed.
3.5.2.7. Edit a Node

47
Right-click on a node and select the Edit node... item in the pop-up menu.
OR Select a node in the tree and click on the Edit button of the Tool Palette Hierarchy Manager win-
dow.
Figure 59: Tool Palette Hierarchy Monitor window

Modify the data and click on OK.
Result: The node has been modified.
3.5.3. Create a Codified Dimension

Reminder: Codified Dimensions allow the user to group the Network Elements by a common attribute (refer to
the NIMS-PrOptima User Manual for further information).
Perform the following procedure to create a new Codified Dimension in the NIMS-PrOptima client Dimension
Palette:
Select the Features->Manage Dimensions->Cube dimension menu item.
Result: The Cube Dimension Monitor window appears.

Fill out the two Name fields.
Select NE in the Axis category pull-down menu.
Figure 60: Cube Dimension Monitor configured for Codified Dimension

Enter a Dimension ID in the Dim Id field.
48

Warning: Please indicate a Dimension ID that is different to -1.

Check the Attribute based dimension checkbox.
Result: The Attribute pull-down menu below this checkbox becomes enabled.
Select the Configuration Attribute on which the Codified Dimension will be based.
Click on OK.
Result: The new Codified Dimension has been added to the Cube Dimension Editor table.
Figure 61: Codified Dimension added to the Cube Dimension Editor list
Select the Features->Manage Dimensions->Tool Palette Hierarchy menu item.
Right-click on the Codifed dimensions folder and select the Create a node pop-up menu option.

Fill out the required information (refer to sub-section 3.5.2.5. Add a Node on page 46 of this manual for
further information).
Result: When you open a NIMS-PrOptima client, the newly created Codified Dimension is displayed in the
Dimension Palette.
Warning: Codified Dimensions linked to unimported Network Elements will not appear in the Dimension Palette.
3.6. Scheduled Reports Menu Item

The Scheduled Report Editor allows you to manage automatic reports on data imported from a datasource. An
automatic report is based on a NIMS-PrOptima for W-NMS predefined report which has been scheduled to run
at a specified moment on a regular basis (such as once a day). Automatic reports are delivered either in e-mails or
saved to disk. The easy-to-use GUI of this function allows the administrator to choose a predefined report and
schedule its run-time at certain times of importation process.
Note: Automatic reports are always based on predefined reports created in NIMS-PrOptima for W-NMS.
49
Note: It is NOT possible to schedule Composite Docs.

The Scheduled report editor window consists of an information table with eight columns as seen in the screenshot
below.
Figure 62: Scheduled report editor window
The columns of the Scheduled report editor are the following:

z
Id: This column contains the ID number of the scheduled report.
Name: This column contains the name of the scheduled report.
Predefined report: This column contains the name and relative path of the predefined report used.
Delivery report: This column contains information regarding the method of delivery of the scheduled
report, i.e. Detailed HTML Email (1), Detailed HTML Saved on disk (2), ASCII file saved on disk (4),
XML file saved on disk. (5).
Parameter: This column contains the information needed to deliver the report. For example, an e-mail
adress for a Detailed HTML Email.
Schedule: This column contains the schedule string (in Cron syntax) used by the Scheduled Reports
tool. It is defined using the Schedule string builder tool (see the Schedule string builder context help or
the NIMS-PrOptima User Manual for further information).
Comments: This column contains any add additional information regarding the Scheduled Report.
3.6.1. Sorting the Scheduled Report List

Click on the Name column header in the Scheduled Editor list.
Result: The Scheduled Report list should be sorted by name in alphabetical order.
Click again on the Name column header in the Scheduled Editor list.
Result: The Scheduled Report list should be sorted by names in reverse alphabetical order.
3.6.2. Removing an Existing Scheduled Report

Open the Scheduled Editor window
Select a report or report book in the list.
3.6.3. Adding and Configuring an Automatic Report

Click on Add... in the Scheduled report editor window to create a new automatic report.
50

Result: A Scheduled report monitor window opens. It allows you to configure the automatic report that
you want to add or modify in the Scheduled Report Editor.
Figure 63: Scheduled report monitor
The Scheduled report monitor window contains the following elements:

z
Id: The ID number is set automatically.
Name: Enter a name to identify the automatic report.
Predefined report: Click on the Choose... button. This action opens a Predefined report chooser window which allows you to select the predefined report. Then click on OK to add the selected predefined
report to the Scheduled report monitor list.
Figure 64: Predefined report chooser window

z
Delivery report: Select the delivery method for the automatic report, e.g. sending an e-mail, creating an
ASCII file saved on disk, etc.

51

z
Sample: Example of the format used, e.g. dir/filename.ext for an HTML file saved on disk.
Parameter: Enter the information needed to conduct the report delivery, e.g. the e-mail address, the
users sub-directory in which the report will be saved, etc.
Reports saved on disk specifications:
You should only enter the name of the users sub-directory in which the reports should be saved,
NOT the whole path.
Example: /user1/reportXXX
The whole path towards the directory must be indicated in the ReportScheduler.OutputDir
property. This property should thus be configured as follows in the mdds.properties file:
ReportScheduler.OutputDir=/opt/nortel/data/proptima/users/report/
scheduled/<OS_Login>
Warning: If you want to customize this property and keep the customized configuration following the installation
of a drop or patch, you must:
Copy the property from the mdds.properties file.
Paste the property in the proptimaserver.site.properties file stored in the /opt/
nortel/config/proptima/server/res directory as explained in the System Administration

manual.
If the report is saved on disk, typing %day_selection<DateFormat> in the Parameter field will
include the selected day in the page zone of the report (if there is one) in the filename of the saved
report. If there is no day dimension in the page zone, the current day will be used instead. DateFormat defines the format of the date outputm e.g. you can enter a standard date format such as
YYYYMMDDHHmmss.
Example: /Report1001-%day_selection(YYYYMMDDHHmmss) will create a file named
Report1001-20050611000000 in the directory you indicated, if the day selected in the page zone
of the report is June 11th, 2005 at 00:00:00.
Mode: The Fixed Schedule/After importation session switch controls the behavior of the report computation schedule.
In Fixed Schedule mode, the report will be computed at the exact fixed time indicated in the Schedule string, which uses Cron syntax. For example, for a cron string set to 15 * * * * *, reports will be
computed and checked at 00:15, 01:15, 02:15, etc.
In After importation session mode, reports will be computed after the importation session matching
the scheduled time. For example, if the schedule string is scheduled to create a report using the values of 0:15, the scheduler will WAIT FOR THE 0:15 DATA TO BE ACQUIRED (which typically
happens ten minutes later) before computing the report and possibly sending the alarm.
Schedule: This field displays the schedule string that will be used by the Scheduled Report tool.
Click on the Configure button in order to configure the scheduling of the automatic report.
52

Result: A Schedule string builder window appears.
Figure 65: Schedule string builder
Warning: The same Schedule string builder opens no matter which the Schedule Mode was selected, i.e. Fixed
Schedule or After importation session.
The Cron Syntax of the Schedule string builder:
The syntax used in the Schedule string builder is Cron syntax (the one used in mycom.util.schedule.CronSchedule).
All fields must be filled out with a known value (either a number or a symbol).
The allowed values for each time field are listed in the following table.
Field
Allowed Values
Minute
Hour
Day of month
Month
Day of week
0-59
0-23
1-31
1-12
1-7 (1 is Monday and 7 is Sunday)
ASCII Character
Function
* (asterisk)
- (hyphen)
, (comma)
The asterisk is a character which indicates that the field

is not taken into account.
The hyphen is used to create a range of numbers. The
specified range is inclusive.
For example, 8-11 for an hour entry specifies running
the report at hours 8, 9, 10 and 11.
The comma is used to create a list of separate, usually
non-consecutive, items.
Examples: 1,2,5,9, 0-4,8-12.

53
ASCII Character
Function
The forward slash is used for step values which can be
used in conjunction with ranges. Following a range with
/<number> specifies the level of skips of the numbers
value throughout a range.
/ (forward-slash)
For example, 0-12/2 can be used in the hour field to

specify the running of the report every other hour during
the specified range. 0-12/3 runs the report every third
hour during the specified range.
Note: Steps are also permitted after an asterisk. The
example */2 runs , so if you want to say every two
hours for all hours.
Practical use examples of the Cron syntax:
Run once a year (at midnight on the first day of the

month of the first month of the year)
Run once a month (at midnight on the first day of the
month of every month of the year)
Run once a week (at midnight on the first day of every
week)
Run once a day (at midnight every day)
Run once an hour (at the first minute of every hour)
0011*
001**
00**1
00***
0****
50***
15 14 1 * *
0 22 * * 1-5
23 0-23/2 * * *
54**7
5,9 4 * * 7
0 0 1,15 * 7
At 00:05 every day

At 14:15 on the first day of the every month
At 22:00 on days, Monday through Friday
Every two hours starting at 00:23 (i.e. 00:23, 02:23,
04:23 ... 22:23) on a daily basis
At 04:05 on every Sunday
At 04:05 and 04:09 on every Sunday
At midnight on every Sunday, and at midnight on the
first and 15th day of every month
Activated: Choose to activate or deactivate the automatic report by selecting True (for activate) or False
(for deactivate).
Comments: A free-form field for adding comments, if necessary.
3.6.4. Modifying Automatic Reports

Open the Scheduled report editor window then select an existing report from the list.
Click on the Modify button.
Result: The Scheduled report monitor opens.

Modify some of the fields and click on OK.
Result: The Scheduled report monitor closes and modifications are saved in the Scheduled report editor.
54

Chapter 4: Annexes
Chapter 4- Annexes
4.1. Using Online Help
The User Manager application includes complete documentation in Online Help, including all of the feature information in this user manual and color screenshots.
The Online Help window can be started in two different ways:
From the menu bar by selecting Help->Help topics.
Result: The Online Help window opens.

From an active window, e.g. Users and Groups, etc., by pressing F1 to open a context help.
Result: The Online Help window opens and displays the help section corresponding to the active window.
Note: Several windows support context launch.
Figure 66: Context help launched with F1 from a NE Entities window
Use of the buttons:

z
The buttons "Back"

and "Forward"
work the same way as the ones found in an Internet browser.
Their purpose is not to move to the next/previous chapter but to the next/previous VISITED page.
The "Print" button

zone of the window).
The "Layout" button
allows you to print the page that you have selected in the Online Help (the right
allows you to set the layout of the help page you want to print.

55
Chapter 4: Annexes
4.2. List of Abbreviations
56
Abbreviation
Definition
BSC
BTS
GIS
GPRS
GSM
GUI
HOLAP
ICM
Id
Idf
MDDS
MOC
MOC Def
MSC
NE
UMTS
Base Station Controller

Base Transceiver Station
Geographical Information System
General Packet Radio Service
Global System for Mobile communications
Graphical User Interface
Hybrid Online Analytical Processing
Import Control Manager
Identity
Identity foreign
Multi-Dimensional Data Storage
Managed Object Class
Managed Object Class Definition
Mobile Switching Center
Network Element
Universal Mobile Telecommunications System


NIMS-USM-OAM5 0 0 - v3 04 PDF

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

NIMS-USM-OAM5 0 0 - v3 04 PDF

Uploaded by

Copyright:

Available Formats

NIMS-PrOptima

2. INITIAL LOGIN & FILE MENU.................................................................................................. 7

3. FEATURES MENU ......................................................................................................................... 9

User Manager user manual - Ref: PRO-SUP-USM-NOR-133-3.04-EN

It facilitates access right management.

Add, create, or modify a formula

Save a report in the shared repository

Manage (create, modify, remove, or assign) users and groups

Assign features to users and/or groups

Manage the predefined report tree

Manage the Dimension Palette tree

Check and repair problems that occur in the database

Figure 1: User Manager Menu Bar

User Manager user manual - Ref: PRO-SUP-USM-NOR-133-3.04-EN

Control key sequences

Notes, Warnings, and Results.

1.5. Version & Scope

1.6. Publication Date

1.7. Other Manuals

Importation Control Manager User Manual

1.8. Copyright Information

User Manager user manual - Ref: PRO-SUP-USM-NOR-133-3.04-EN

1.9. Customer Support Contact Information

User Manager user manual - Ref: PRO-SUP-USM-NOR-133-3.04-EN

User Manager user manual - Ref: PRO-SUP-USM-NOR-133-3.04-EN

Chapter 2: Initial Login & File Menu

Chapter 2- Initial Login & File Menu

Figure 2: File Menu List Items

2.2. Initial Login

Figure 3: User Manager Login Window

2.3. Message Log Menu Item

Result: A Message log window appears.

User Manager user manual - Ref: PRO-SUP-USM-NOR-133-3.04-EN

Chapter 2: Initial Login & File Menu

Figure 4: Message Log

The window is divided into two fields:

A severity icon (i.e. information icon, error icon, emergency icon).

A timestamp for the message.

A brief description of the message.

The Clear icon allows you to clear the message log.

2.4. Quit Menu Item

Result: The application will close after presenting a confirmation message.

User Manager user manual - Ref: PRO-SUP-USM-NOR-133-3.04-EN

Chapter 3: Features menu

Chapter 3- Features menu

Figure 5: Features menu items

3.2. Check Database Integrity Menu Item

Result: A Database Integrity Check window appears.

Figure 6: Database Integrity Check

User Manager user manual - Ref: PRO-SUP-USM-NOR-133-3.04-EN

Chapter 3: Features menu

Figure 7: Test results window reporting Passed tests

Figure 8: Test results window reporting one error

3.2.1. Correcting a Test Failure

Result: A Missing foreign keys test details window opens.

User Manager user manual - Ref: PRO-SUP-USM-NOR-133-3.04-EN

Chapter 3: Features menu

Figure 9: Missing Foreign Keys Test Details

3.3. Users and Groups Menu Item

Result: A window called Users and Groups appears.

User Manager user manual - Ref: PRO-SUP-USM-NOR-133-3.04-EN

Chapter 3: Features menu