You are on page 1of 57

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

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


Copyright MYCOM International 2006

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

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


Copyright MYCOM International 2006

Chapter 1: Introduction

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

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


Copyright MYCOM International 2006

Chapter 1: Introduction

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.

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


Copyright MYCOM International 2006

Chapter 1: Introduction

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


Copyright MYCOM International 2006

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.

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


Copyright MYCOM International 2006

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.

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


Copyright MYCOM International 2006

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).

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


Copyright MYCOM International 2006

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


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

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


Copyright MYCOM International 2006

Chapter 3: Features menu

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.

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


Copyright MYCOM International 2006

11

Chapter 3: Features menu

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

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


Copyright MYCOM International 2006

Chapter 3: Features menu

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).

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


Copyright MYCOM International 2006

13

Chapter 3: Features menu

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.

Result: A delete confirmation message appears.


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

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


Copyright MYCOM International 2006

Chapter 3: Features menu

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.

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


Copyright MYCOM International 2006

15

Chapter 3: Features menu

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

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


Copyright MYCOM International 2006

Chapter 3: Features menu

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.

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


Copyright MYCOM International 2006

17

Chapter 3: Features menu

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

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


Copyright MYCOM International 2006

Chapter 3: Features menu

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

Result: A Feature Chooser window appears.


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:
User Manager user manual - Ref: PRO-SUP-USM-NOR-133-3.04-EN
Copyright MYCOM International 2006

19

Chapter 3: Features menu


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

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


Copyright MYCOM International 2006

Chapter 3: Features menu

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 the Remove button.

Result: A delete confirmation message appears.


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 .
User Manager user manual - Ref: PRO-SUP-USM-NOR-133-3.04-EN
Copyright MYCOM International 2006

21

Chapter 3: Features menu

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

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


Copyright MYCOM International 2006

Chapter 3: Features menu

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.

Result: A Name chooser window appears.

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.

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


Copyright MYCOM International 2006

23

Chapter 3: Features menu

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.

Result: A Name chooser window appears.


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

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


Copyright MYCOM International 2006

Chapter 3: Features menu

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.
User Manager user manual - Ref: PRO-SUP-USM-NOR-133-3.04-EN
Copyright MYCOM International 2006

25

Chapter 3: Features menu

3.4.3.1. Add or Remove an Owner for Value Provider 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.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

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


Copyright MYCOM International 2006

Chapter 3: Features menu

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.
Click on the Edit... button.

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 the Remove button.

Result: A delete confirmation message appears.


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.


User Manager user manual - Ref: PRO-SUP-USM-NOR-133-3.04-EN
Copyright MYCOM International 2006

27

Chapter 3: Features menu

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.
Click on the Remove button.

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

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


Copyright MYCOM International 2006

Chapter 3: Features menu

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.

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


Copyright MYCOM International 2006

29

Chapter 3: Features menu

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


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.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.
Click on the Edit... button.

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.
User Manager user manual - Ref: PRO-SUP-USM-NOR-133-3.04-EN
Copyright MYCOM International 2006

Chapter 3: Features menu

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 the Remove button.

Result: A delete confirmation message appears.


Click on Yes.

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

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


Copyright MYCOM International 2006

31

Chapter 3: Features menu

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


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.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

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


Copyright MYCOM International 2006

Chapter 3: Features menu

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 the Remove button.

Result: A delete confirmation message appears.


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


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.6.2. Edit a User Right


Select User Rights in the Feature Chooser pull-down menu.
Click on the Edit button.

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


Copyright MYCOM International 2006

33

Chapter 3: Features menu

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.

Click on the Edit button.

34

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


Copyright MYCOM International 2006

Chapter 3: Features menu

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.

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


Copyright MYCOM International 2006

35

Chapter 3: Features menu

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.

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


Copyright MYCOM International 2006

Chapter 3: Features menu

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.
Click on the Edit button.

Result: A User profile window appears.


Click on the Direct Features button.

Result: A Direct Feature Editor window appears.


Click on the Add button.

Result: A Feature Chooser window appears.


In the Type pull-down menu select User rights
Click on the Edit button.

Result: A User Right Editor window appears.

Figure 43: User Right Editor window


Click on the Add button.

Result: A Users Right Monitor window appears.

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


Copyright MYCOM International 2006

37

Chapter 3: Features menu

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

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


Copyright MYCOM International 2006

Chapter 3: Features menu

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.
Click on the Add button.

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.

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


Copyright MYCOM International 2006

39

Chapter 3: Features menu

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


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.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

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


Copyright MYCOM International 2006

Chapter 3: Features menu

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 the Remove button.

Result: A delete confirmation message appears.


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.
User Manager user manual - Ref: PRO-SUP-USM-NOR-133-3.04-EN
Copyright MYCOM International 2006

41

Chapter 3: Features menu

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


Click on the Add button.

42

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


Copyright MYCOM International 2006

Chapter 3: Features menu

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 the Remove button.

Result: A delete confirmation message appears.


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


User Manager user manual - Ref: PRO-SUP-USM-NOR-133-3.04-EN
Copyright MYCOM International 2006

43

Chapter 3: Features menu

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.


Click on the Add button.

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

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


Copyright MYCOM International 2006

Chapter 3: Features menu

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.

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


Copyright MYCOM International 2006

45

Chapter 3: Features menu

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.


Result: A delete confirmation message appears.
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.


Result: The Tool Palette Hierarchy Monitor appears.
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

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


Copyright MYCOM International 2006

Chapter 3: Features menu

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.


Result: A delete confirmation message appears.
Click on Yes.

Result: The node has been removed.

3.5.2.7. Edit a Node


User Manager user manual - Ref: PRO-SUP-USM-NOR-133-3.04-EN
Copyright MYCOM International 2006

47

Chapter 3: Features menu

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.
Result: The Tool Palette Hierarchy Monitor appears.

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.
Click on the Add button.

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

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


Copyright MYCOM International 2006

Chapter 3: Features menu

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.

Result: The Tool Palette Hierarchy Monitor appears.


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.
User Manager user manual - Ref: PRO-SUP-USM-NOR-133-3.04-EN
Copyright MYCOM International 2006

49

Chapter 3: Features menu

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.
Click on the Remove button.

Result: A delete confirmation message appears.

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

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


Copyright MYCOM International 2006

Chapter 3: Features menu

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.

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


Copyright MYCOM International 2006

51

Chapter 3: Features menu


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

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


Copyright MYCOM International 2006

Chapter 3: Features menu

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.

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


Copyright MYCOM International 2006

53

Chapter 3: Features menu

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

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


Copyright MYCOM International 2006

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.

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


Copyright MYCOM International 2006

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

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


Copyright MYCOM International 2006