Osp 24 Basic Operations Guide Ed 06

Alcatel - Lucent 8690

OSP 2.4Basic Operations Guide

OSP 2.4.03

3CL 02350 BCXX BAZZA

December 7, 2006

Table of Contents

Table of Contents. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

1. Scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62. Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63. References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64. Book conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75. Abbreviations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Part I. Managing the OSP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

1. Managing the Alarm service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101. Alarm service objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102. Configuration object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

2.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112.2. Object GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112.3. How to configure the Alarm service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

2.3.1. Principle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122.3.2. Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

3. Displaying and monitoring alarm information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163.1. Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163.2. Alarm object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

3.2.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173.2.2. Object GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

3.3. Event object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173.3.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173.3.2. Object GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

3.4. Lost event object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183.4.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183.4.2. Object GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

3.5. How to subscribe to events, lost events and alarms . . . . . . . . . . . . . . . . . . . . . . . . . 193.5.1. Principle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193.5.2. Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

3.5.2.1. Destinations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223.5.2.2. Criteria tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

3.6. How to display events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 263.7. How to monitor events. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323.8. How to list events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353.9. How to display alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Basic Operation’s Guide 3CL 02350 BBXX BAZZA 1/216

December 7, 2006

3.10. How to monitor alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473.11. How to list alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473.12. How to display a lost event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 473.13. How to list lost events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

4. Event severity level object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .474.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 474.2. Default level meaning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484.3. Modifying the severity level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494.4. Creating new event severity objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53

5. Alarm Box object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .545.1. Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545.2. Displaying the Alarm box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555.3. How to use the Alarm Box settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58

5.3.1. Refresh rates. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585.4. How to manage the monitoring window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60

2. Managing the Statistics service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .612. Statistics available within the OSP 2.4 platform. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61

2.1. Available reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612.2. Events description per report. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 632.3. Available subscriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 662.4. Relevant subscriptions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68

3. Subscriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .683.1. Statistical subscription interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69

3.1.1. General Information frame. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 703.1.2. Dimension tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 703.1.3. Selection tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 723.1.4. Other tabs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 723.1.5. Subscription menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73

3.1.5.1. Refresh command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 733.2. How to create a subscription to statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74

3.2.1. Principle . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 743.2.2. Subscription types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 743.2.3. Normal subscription . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 753.2.4. Threshold subscription . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81

3.3. Monitoring subscription . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 903.3.1. Creation of a monitoring subscription . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 903.3.2. Monitoring of existing subscription . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96

3.4. Televoting subscription . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 973.5. Parameters that can be modified in a subscription . . . . . . . . . . . . . . . . . . . . . . . . . 1033.6. Adding dimensions to a subscription . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

3.6.1. Object as dimension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1053.6.1.1. Selection of list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106

3.6.2. Report as dimension. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1083.6.2.1. Report dimension property . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

2/216 3CL 02350 BBXX BAZZA Basic Operation’s Guide

December 7, 2006

4. How to display statistical reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1105. DisplayReport Subscription with Dimension . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1146. Operations on statistical report data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114

6.1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1146.2. Total of statistical data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1156.3. Mean of statistical report data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118

7. How to export statistical data to an external application . . . . . . . . . . . . . . . . . . . . . . . 1217.1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1217.2. Prerequisite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121

8. How to save a statistical report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1238.1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1238.2. How to save statistical report data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1248.3. How to save a statistical report graph . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125

9. How to print a statistical report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1289.1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1289.2. How to print statistical report data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1299.3. How to print a statistical report graph . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132

10.Subscription Wizard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13410.1. Presentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13410.2. Description of the tree interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135

10.2.1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13510.2.2. Wizard menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13610.2.3. Stat Tree frame legend . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13710.2.4. Time Selection frame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13810.2.5. Preferences frame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13910.2.6. Subscription not found . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142

10.3. Description of the Statistical Results window . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14210.3.1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14210.3.2. Single graph . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14410.3.3. Statistical results menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14410.3.4. Legend . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14510.3.5. Multi-graph window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146

10.4. How to view mnemonics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14710.4.1. Warnings and conditions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14710.4.2. Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147

10.5. How to set an X-axis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14910.5.1. Conditions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14910.5.2. Procedure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

10.6. How to display a report, send it by mail or save it as a preference . . . . . . . . . . . . 15110.6.1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15110.6.2. Easy data selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15110.6.3. Advanced data selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153

10.7. Possible selections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15610.7.1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15610.7.2. Only the report is selected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15610.7.3. A dimension becomes X-scale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157


December 7, 2006

10.7.4. No X-scale defined, mnemonics selected . . . . . . . . . . . . . . . . . . . . . . . . . . . 15710.7.5. A dimension as X-scale plus mnemonics selected . . . . . . . . . . . . . . . . . . . . 158

10.8. Examples of report outputs in e-mail messages . . . . . . . . . . . . . . . . . . . . . . . . . . . 15810.8.1 .Example 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15810.8.2. Example 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16010.8.3. Example 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16310.8.4. Example 4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164

3. How to sort information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1661. Sorting data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1662. Tips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .167

4. Managing the Accounting service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1681. How to decode stored tickets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .168

1.1. Customised decoding libraries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1701.2. Decode in one file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

2. Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1712.1. How to create a new report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171

2.1.1. Object-based Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1772.1.2. Tags-based Filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1782.1.3. Selection of elements in the Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180

2.2. How to display a report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1802.3. How to save a report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1822.4. How to export a report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1832.5. How to print a report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1832.6. How to delete a report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1832.7. How to cancel the 'Create' process . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 184

Part II. Scheduled Jobs and Command Log . . . . . . . . . . . . . . . . . . 186

5. How to schedule a job. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 187

6. How to display a scheduled job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192

7. How to modify the execution time. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194

8. How to modify the content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196

9. How to remove a scheduled job. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200

10. How to analyse command & session log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203

List of Figures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207


December 7, 2006

Index of Topics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212

Document References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 214


December 7, 2006

Preface

1. Scope

This document collects procedures needed for basic operations on Alcatel-Lucent OSP PlatformRelease 2.4.It also explains the procedures related to the scheduling of commands and commands logging.

For convenient use, we decided to merge the Diagnosis Tools User’s Guide and the BasicOperations Guide in one single document. For historical reasons, the procedures present inthese two documents were put in two separate documents. As these reasons don’t exist anymore,we thought it more appropriate to group linked procedures together in a same document.

2. Audience

This document is intended for people who want to know the basic operations possible on the OSP2.4.

3. References

While you read this document, you might need to refer to other ones. What follows lists some ofthem.

• OSP 2.4 Management System User’s Guide

• OSP 2.4 Alarm Service Description

• OSP 2.4 Statistics Service Description

• OSP 2.4 Accounting Service Description

• OSP 2.4 Scheduler Service Description

• OSP 2.4 Command Log Service Description

• OSP 2.4 Objects Reference Guide


December 7, 2006

4. Book conventions

5. Abbreviations

Table 1: Conventions .

Convention Description

Bold • To strongly emphasise a word.

• For field names, commands names

Courier new To write code.

Italics To emphasise a word.

+ italics To insert a note.

To insert a reference

• to another point in the present document

• or to another document

for further reading.

To indicate a tip.

To indicate a warning.

Table 2: Abbreviation

Abbreviation Meaning

C

CPU Central Processing Unit


December 7, 2006

.csv file Comma Separated Value file

H

HTML HyperText Markup Language

I

IN Intelligent Network

O

OSP Open Services Platform

S

SCP Service Control Point

SEP Service Execution Process

SIB Service Independent Building Block

SMP Service Management Point

SNMP Simple Network Management Protocol

SQL Structured Query Language

SSP Service Switching Point

Table 2: Abbreviation

Abbreviation Meaning


December 7, 2006


Part I. Managing the OSP

This part describes the basic operations allowing:

• monitoring the behaviour of the platform and services,

• creating and viewing reports.

December 7, 2006 Managing the Alarm service

1. Managing the Alarm service

A detailed description of the Alarm Service can be found in OSP 2.4 Alarm ServiceDescription.

1. Alarm service objects

Clicking on pfmalarm displays the list of the GUI’s of pfmalarm.

Figure 1.1 - Alarm service GUI’s


Managing the Alarm service December 7, 2006

2. Configuration object

2.1. Description

This object allows configuring the Alarm service.

2.2. Object GUI

The figure below shows the Configuration GUI with the General tab open.

Figure 1.2 - Alarm service - Configuration GUI - General tab



The figure below shows the Configuration GUI with the SNMP trap content tab open.

Figure 1.3 - Alarm service - Configuration GUI - SNMP trap content tab

2.3. How to configure the Alarm service

2.3.1. Principle

The behaviour of the Alarm service can be configured according to several requirements. Thisdocument explains which settings are available and how to configure them to achieve the desiredbehaviour.



2.3.2. Procedure

Execute the procedure below to configure the Alarm service.

Table 1: Procedure for configuring the Alarm service .

Step Action

1 Double-click the Configuration GUI in the pfmalarm menu.The Configuration interface is displayed.

Figure 1.4 - Alarm service - Configuration GUI



2 In the Name field, fill in or select pfmalarm, then select Display in the Configuration menu.

Figure 1.5 - Configuration menu - Display

This is a unique object: it cannot be created, and no other object can beadded to the service.

3 In the Filtering: minimum level frame, select a severity level. All events and alarms below this level will be ignored by the service. The list ranges from Warning (1) to Benign (3) and from Minor (4) to Major (6). By default, 'Warning' is selected: as it is the lowest possible level, all events and alarms are kept in the service database.

Figure 1.6 - Filtering: minimum level frame

4 The Live Time… field defines how long a closed alarm is kept in the database before being cleaned up. The default duration is 600 sec's (10 minutes). Every 10 seconds, the Alarm service looks up the database for alarms that have been closed for more than 10 minutes and removes them. You are allowed to modify these settings.

5 Events and alarms are saved to the database ('commit') every 10 seconds or whenever 100 events and/or alarms have occurred. You are allowed to modify these settings.

Table 1: Procedure for configuring the Alarm service (Continued).

Step Action

selected by default



6 The operator can be alerted via e-mail when a given event or alarm occurs. This field shows the path to the default Unix mailer daemon. Other daemons can be used. Set the path to the mailer daemon to be used for sending e-mails.

Figure 1.7 - Mailer field

7 Select the SNMP trap content tab.

Figure 1.8 - Configuration GUI - SNMP trap content tab

8 Select the Event fields that must be part of the content of the SNMP traps describing and reporting events.

9 In addition to the ones specified in step 8, select the Alarm fields that must be part of the content of the SNMP traps describing and reporting alarms.


Step Action



3. Displaying and monitoring alarm information

The pfmalarm service offers several ways for accessing information. This section presents theprocedures used to:

• subscribe to events, lost events and alarms,

• monitor, list and display events, lost events and alarms,

• modify and close alarms.

3.1. Summary

10 In the Configuration menu, select Modify to save your changes.

Figure 1.9 - Configuration menu - Modify

Table 2: Possible operations for each type of information .

Operation Event Lost event Alarm

Subscription Yes Yes Yes

Monitoring window Yes No Yes

List Yes Yes Yes

Display Yes Yes Yes

Modify N/A N/A Yes

Close N/A N/A Yes


Step Action



3.2. Alarm object

3.2.1. Description

'Alarms' reflect abnormal situations and have a lifetime.

3.2.2. Object GUI

The figure below shows the Alarm GUI with the Attributes tab open.

Figure 1.10 - Alarm service - Alarm GUI - Attributes tab open

3.3. Event object

3.3.1. Description

'Events' are one-off pieces of information about the OSP system.An event contains the following information:

• the event identifiers: event catalogue and event code;



• the submitter: SLEE name, SEP name, module name, service Id, etc;

• the object to which the event is related: object type, object Id;

• an optional provider name used for the access control;

• some additional data: date & time, on/off/single event flag, event level.

3.3.2. Object GUI

The figure below shows the GUI of the Event object with the Attributes tab open.

Figure 1.11 - Alarm service - Event GUI - Attributes tab

3.4. Lost event object

3.4.1. Description

When the received event has been recovered by the Dpe Recovery due to unavailability of thealarm service (overload, connection down,...), the event is stored into the Lost Event objectreflecting obsolete information.The Lost Event consists of one circular sequence.



3.4.2. Object GUI

The figure below shows the GUI of the Lost event object.

Figure 1.12 - Alarm service - Lost event GUI - Attributes tab

3.5. How to subscribe to events, lost events and alarms

3.5.1. Principle

The events and alarms sent by the various services and collected by the Alarm service are notautomatically shown to the operator. To receive this information, the operator must either:

• access the event, lost event or alarm through normal SMP management (please see below How to monitor... How to list... How to display...).

• subscribe to specific events, lost events and alarms he wants to be alerted about.



3.5.2. Procedure

Execute the procedure below to create a subscription.

Table 3: Procedure for creating a subscription .

Step Action

1 Double-click the Subscription GUI in the pfmalarm menu.The Subscription interface is displayed.

Figure 1.13 - Alarm service - Subscription GUI - Attributes tab open



2 Fill in a new name for the subscription in the Name field. The Operator name field can be left empty.

‘Subscriber name’ refers here to the name of the operator that creates thesubscription and does NOT refer to operator types (subscriber/ provider/installer).

Figure 1.14 - Alarm service - Subscription GUI - General frame

3 In the Type options block, select the type of subscription wanted: on events, on lost events or on alarms.

Figure 1.15 - Alarm service - Subscription GUI - Type frame

4 In the Start date/time fields, set appropriate values.

You can drag and drop the current Date and Time from the status bar.

Figure 1.16 - Alarm service - Subscription GUI - Start date/time frame

Table 3: Procedure for creating a subscription (Continued).

Step Action



3.5.2.1. Destinations

5 Select one or more of the following destinations.See Section 3.5.2.1. "Destinations" on page 22.

Figure 1.17 - Alarm service - Subscription GUI - Destinations frame

6 In the Subscription menu, select Create to record the subscription.

Figure 1.18 - Subscription menu - Create

Table 4: Destinations descriptions .

If you select.... the events/alarms will be sent to…

E-Mail the e-mail address to be filled in the field on the right.

IN SEP Group a group of SEPs (not to an individual SEP). This provides for load-sharing between SEPs. Note that a SEP group can be a one-SEP group. A typical example for this destination would be a group of SEPs which wait for an event to activate a process.

Table 3: Procedure for creating a subscription (Continued).

Step Action



3.5.2.2. Criteria tab

You can limit the scope of a subscription by setting limits in the Criteria tab.

[Monitoring] An exception exists for 'monitoring' subscriptions: they are automatically created by selecting the 'Start Monitoring' action in the menu of the Event or Alarm objects. The events/alarms are displayed as long as the monitoring window remains open.

Please refer to OSP 2.4 Alarm Service Description -Operator's Workflow.

SNMP trap an SNMP daemon running on the same SMF as the Alarm service.

A detailed description is given in OSP 2.4 Alarm ServiceDescription - External Interfaces.

Default Event Management

the default subscription.

IMPORTANT: This destination cannot be selected for subscribing to alarms, only to events. The default subscription creates an alarm whenever an event occurs that matches the default criteria and is a begin event. To receive these alarms, a specific subscription has to be created.

Please refer to OSP 2.4 Alarm service Description - Featuresfor a complete description of the Default Event Management.

Table 4: Destinations descriptions (Continued).

If you select.... the events/alarms will be sent to…



Figure 1.19 - Alarm service - Subscription GUI - Criteria tab open

Table 5: Setting the scope .

The section … allows selecting:

Event an event catalogue or a single event to limit the monitoring to:

• the events belonging to this particular catalogue or

• this event itself.

Services service(s) to limit the monitoring to the events belonging to the service(s).

Min / max level • the level starting from which events are reported (no events of inferior level are reported).

• the level up to which events are reported (no events of superior level are reported).



At least one of the above sections has to be completed; but it is legal that at least one remainsempty.

Selection the parameters of an SQL request.

Table 5: Setting the scope (Continued).

The section … allows selecting:



3.6. How to display events

Execute the procedure below to display events.

Table 6: Procedure for displaying events .

Step Action

1 Double-click the Event GUI of the pfmalarm service.The Event interface is displayed.

Figure 1.20 - Pfmalarm - Event GUI - Attributes tab open



2

• Click the button next to Event Catalog to list the installed catalog of events, or

• Click the button next to Event Name to list the installed events.

Figure 1.21 - List of installed events that appears after clicking on the magnifying glass next to the Event Name field

Table 6: Procedure for displaying events (Continued).

Step Action



3 • To select an event in the above window:

select it and then click on the OK buttonor double-click it.

The selected event appears in the Event Name field.

• Then click on List in the Event menu.

Figure 1.22 - Event menu - List

The following window appears.

Figure 1.23 - Choose parameters to list window


Step Action



4 Choose the parameters to be listed with the events.The Event ID is mandatory to display events.Click the View button.The following window appears.


Step Action

This button appears when the list is finished. During the invocation of the list, the button is a stop button.



5 In the returned list, double-click the singular event you want to display.

Figure 1.24 - Double-clicking an event in Event: List window displays it in the object interface

You can also fill in the Event ID field with an ID read from the list, then selectDisplay in the Event menu or press Alt+D.


Step Action



6 The data of the selected event are displayed in the Event interface.

Figure 1.25 - Data of the selected event are displayed in the Event interface window (here Attributes tab)

Figure 1.26 - Data of the selected event are displayed in the Guidance tab


Step Action

Event selected in the previous figure.



3.7. How to monitor events

Execute the procedure below to monitor events.

Table 7: Procedure for monitoring events .

Step Action

1 Double-click the Event GUI of the pfmalarm service.The Event interface is displayed.

Figure 1.27 - Pfmalarm - Event GUI - Attributes tab open



2 • Fill in the appropriate parameters (Event Catalog and/or Event Name and/

or Event ID…) or select them using the button.

• In the Event menu, select Start monitoring or use Alt+S.

Figure 1.28 - Event menu - Start monitoring

An automatic subscription is created and the monitoring screen appears (usuallyempty at start!)

Figure 1.29 - Confirmation of the subscription creation in the Message area

Table 7: Procedure for monitoring events (Continued).

Step Action



2 (end)

The figure below shows the monitoring screen.

Figure 1.30 - Monitoring window for events.

A Monitoring menu replaces the Event menu in the Menu bar.

Figure 1.31 - Apparition of a Monitoring menu in the Menu bar


Step Action



3.8. How to list events

The List command allows:

• applying criteria to restrict the list

3 You can close the monitoring either by:

• selecting Stop in the Monitoring menu (or press Alt+T)

Figure 1.32 - Monitoring menu - Stop

• or using the X button in the window title bar.

The monitoring window closes and a confirmation message pops up and is dis-played in the message area.

Figure 1.33 - Pop-up telling you the subscription has been removed

Figure 1.34 - Confirmation of the subscription removal in the Message area


Step Action



• accessing detailed information on a specific item in the list

• saving the returned list for further management with external applications.



Execute the procedure below to list events.

Table 8: Procedure for listing events .

Step Action

1 Double-click the Event GUI in the pfmalarm menu.

Figure 1.35 - Profile view - Pfmalarm GUI’s

The Event interface is displayed.



2Using the button, select any value for the criteria 'Event Catalog', 'Event Name' or event 'ID' in the corresponding lists.

The field(s) may be left empty.

You can also select criteria in the 'Level' and 'Event type' options groups.

3 When done, select the List command in the Event menu.

Figure 1.36 - Event menu - List

The Choose parameters to list window appears.


Table 8: Procedure for listing events (Continued).

Step Action



4 Optionally, select appropriate parameters to restrict the list and get faster results. When done, click the View button.The List window appears and starts listing the events matching the criteria defined in step 2 (if any). The listing operation can be stopped by clicking the Stop button. When the List operation is over, the Stop button turns into Refresh.

Figure 1.38 - Event: List


Step Action



5 Double-click any line to display the detailed information for that event in the Event window. View the Guidance tab for Event - Cause - Effect - Action information.Right-clicking on a column header displays the context menu allowing to sort data and hide columns.

Figure 1.39 - Context menu to sort data and hide columns

6 • To view the details of another event, double-click its line in the List window.

• To close the list, close the window.

• To save the list to a text file, select Save in the Choose parameters to list window, then provide a location and a name for the file.

• To export the data to a spreadsheet, select Export in the Choose parameters to list window (the application must have been set in Edit\Preferences).

• To start another list, click Clear in the toolbar, then start over.


Step Action



3.9. How to display alarms

Execute the procedure below to display alarms.

Table 9: Procedure for displaying alarms .

Step Action

1 Double-click the Alarm GUI of the pfmalarm service.


The Alarm interface is displayed.

Figure 1.41 - Pfmalarm - Alarm GUI with the Attributes tab open



2

• Click the button next to Event Catalog to list the installed catalog of events, or

• Click the button next to Event Name to list the installed events.

Figure 1.42 - List of events installed.

Table 9: Procedure for displaying alarms (Continued).

Step Action



3 • Select the event name you want and click OK, or

• double-click the event name in the list

• then in the Alarm menu, select List or use Alt+L.

Figure 1.43 - Alarm menu - List

The following window appears.

Figure 1.44 - Choose parameters to list window.


Step Action



4 • Choose the parameters to be listed with the alarms.

The Alarm ID parameter is mandatory to display events.

• Click the View button.

Figure 1.45 - List of all the occurrences of the selected alarm(s).


Step Action



5 In the returned list, double-click the singular alarm you want to display.

Figure 1.46 - Double-clicking an alarm in Alarm: List window displays it in the Alarm interface

You can also fill in the Event ID field with an ID read from the list, then selectDisplay in the Alarm menu or press Alt+D.


Step Action



5 (end)

The data of the selected alarm are displayed in the Alarm interface window.

Figure 1.47 - Attributes tab with the data of the selected alarm displayed.

Figure 1.48 - Event Fields with the data of the selected alarm displayed.


Step Action



3.10. How to monitor alarms

The procedure is the same for monitoring alarms and events. You just have to use the Alarm objectinstead of the Event object.

See Section 3.7. "How to monitor events" on page 32.

3.11. How to list alarms

The procedure is the same for listing alarms as for listing events. Use the alarm object instead.

See Section 3.8. "How to list events" on page 35.

3.12. How to display a lost event

The procedure is the same for displaying a lost event as for displaying an event. Use the Lost eventobject instead.

See Section 3.6. "How to display events" on page 26.

3.13. How to list lost events

The procedure is the same for listing lost events as for listing events. Use the lost event objectinstead.

See Section 3.8. "How to list events" on page 35.

4. Event severity level object

4.1. Description

When a service is created, a catalogue of all events that could be sent by this service is created atthe same time. Events are defined by the name, the code and the severity level. This level can bemodified to match specific requirements. The event severity levels can be customised via the eventseverity object, and are created at the installation of a service. Upon reception of an event, thealarm service overwrites the event severity level, set by prOSPer, with the value customised via thisobject.



4.2. Default level meaning

Table 10: Event security levels .

Default levels Meaning

Warning Simple indication, can be considered as normal behaviour of the system.

Threshold System behaviour can be considered as normal, but a system limit has been reached.

Benign An abnormal event has happened; no specific action to take; the system can continue processing.

Minor An abnormal event has happened; a specific action has to be taken locally in the process where the alarm was detected; otherwise the system cannot continue processing.

Blocking An abnormal event has happened; an operator has to take a specific action, otherwise the system cannot continue processing.

Major Abnormal system behaviour; there is no possible action to take; the system is not reliable any more.



4.3. Modifying the severity level

Execute the procedure below to modify the severity level and the information ofthe event.



Table 11: Procedure for modifying the severity level

Step Action

1 Double-click the Event Severity GUI in the pfmalarm menu.


The Event Severity interface is displayed.

Figure 1.50 - Event Severity GUI



2

Using the button, select the Event Catalog name and Event Name.

3 In the Event severity menu, select Display.

Figure 1.51 - Event severity menu - Display

The event level and information are displayed.

Table 11: Procedure for modifying the severity level (Continued)

Step Action



4 In the Level option block, select the appropriate level for Normal.

IMPORTANT: Keep in mind the 'Filtering: minimum level' you have defined in the Configuration. If you selected 'Minor' as the default filtering level and now set the severity for this event to a lower level, every occurrence of the event will be ignored.

Figure 1.52 - Event severity GUI - Level frame

The reference level cannot be modified. It is shown here for information.

5 You may want to set the Critical level. This level allows defining a special behaviour: the pfmalarm service will collect such an event only when the occurrences number threshold and the duration threshold are reached.

6 In the Event Severity menu, select Modify to save your changes.

Figure 1.53 - Event severity menu - Modify

Table 11: Procedure for modifying the severity level (Continued)

Step Action



4.4. Creating new event severity objects

Execute the procedure below to create new event severity objects.

Table 12: Procedure for creating new event severity objects .

Step Action

1 Set the event catalogue the event belongs to.

2 Set the event name and the event code. The event code is a positive value. A generic value, equal to 0, can be set. It will be used by the alarm service to get the event severity level of events for which a specific event code (strictly positive) has not been populated in the corresponding event catalogue.

3 The description, cause, action and effects must not be populated here but via the message object of pfmconfig service.

This object is fully described in the OSP 2.4 Configuration Service Descriptionand enables language-dependent messages to be defined.

This message object requires a specific number to identify a language-dependent message. The following numbers must be used for the event messages:Event code * 4 to refer the event description message;(Event code * 4) + 1 to refer the event cause message;(Event code * 4) + 2 to refer the event action message;(Event code * 4) + 3 to refer the event effect message.

4 Click Create in the Event severity menu.

Figure 1.54 - Event severity menu - Create

Changes to text information will be ignored (to do that, use theMessage object of the pfmconfig service instead).



5. Alarm Box object

5.1. Description

The Alarm Box is a convenient control panel that groups information from any host about:

• memory and swap usage

• defence

• CPU usage

• disk mirroring status

• file system usage information.

It also monitors alarms related with the connected host through a "dummy" subscription.

The Alarm Box displays the information collected by thepfmhwagent service from the object. The operator profile musttherefore have provider rights to use the methods on the HostSupervision object for the Alarm Box to display.



5.2. Displaying the Alarm box

Execute the procedure below to display the Alarm box object.

Table 13: Procedure for displaying the Alarm box object

Step Action

1 Double-click the Alarm Box GUI in pfmalarm menu.


The Alarm Box interface is displayed.

Figure 1.56 - Alarm box GUI



2 Type the name of the host you want to monitor in the Host field or select it in the list

using the button and click Connect.

EXAMPLE:

Figure 1.57 - Alarm service - Alarm box - Host Connection tab

Table 13: Procedure for displaying the Alarm box object (Continued)

Step Action



3 After connection, the control panel displays the available information.

Figure 1.58 - Alarm Box window after connection


Step Action



As soon as the subscription collects an alarm, a signal is sent to the Alarm Box hardwarecorresponding with the settings of the LightBox menu (lights, buzzers…).

5.3. How to use the Alarm Box settings

5.3.1. Refresh rates

The Settings menu of the Alarm Box allows defining the refresh rates used by the Alarm Boxdisplay.

4 A "dummy" subscription is created and an alarm monitoring window is opened.

Figure 1.59 - Alarm Box: Monitoring window


Step Action



Figure 1.60 - Alarm Box - Settings menu

To force a display refresh without changing settings, you can select Force Refresh EventDisplay in the Event Monitoring menu.

Table 14: Alarm Box - Settings menu .

Command Description

Host Info TimingDefault: 10 secs

Figure 1.61 - Timing for host info window

Event Refresh Timing0 (zero) forces immediate, permanent refresh of the subscription.

Figure 1.62 - Timing to refresh the Event table window



Figure 1.63 - Event Monitoring menu

5.4. How to manage the monitoring window

The figure below shows the Event Monitoring menu of the Alarm Box object.

Figure 1.64 - Event Monitoring menu

The Event Monitoring menu of the Alarm Box allows selecting the fields that will display in themonitoring window. It provides easier reading and quicker transfer.It is recommended to select/deselect fields before you click on Connect.To stop the monitoring (and remove the subscription), select Stop in the Monitoring menu of thesubscription.The subscription is also removed when the monitoring window is closed.After a subscription has been removed, you can create a new subscription and open a newmonitoring window by disconnecting, then connecting again to the host.


Managing the Statistics service December 7, 2006

2. Managing the Statistics service

1. Introduction

The management of statistical data by operators is based on a subscription mechanism. Asubscription to specific events of a specific service must be created first. An operator with providerrights usually creates the subscriptions. Then operators, usually with subscriber rights, can use thesubscription to display reports and perform various operations on the statistical data.However, the Subscription Wizard is now part of the pfmstat service. This very convenient toolimpacts many aspects of the procedures related with the management of statistical data. It isdescribed in “Subscription Wizard” on page 134 below.

2. Statistics available within the OSP 2.4 platform.

Reports are defined for the service during service development using statistical events in SIBs.There is no way for an operator to create or modify reports: they are part of the servicespecifications.

2.1. Available reports

Table 1: For platform services, list of objects and reports (each line represents the objects of a service and the interesting reports associated)

Service Object Reports

pfmaccess SERVICE • Command Result

pfmaccess OPERATOR • Logon Result

• Logoff Type

• Modify Password

• Session holding time

• Command Result

pfmaccess OBJECT • Command Result

pfmalarm / • Severity Distribution


December 7, 2006 Managing the Statistics service

pfmconfig SERVICE • Successful / Unsuccessful Calls Distribution

• Main Call Events Occurrence Distribution

• Mean Call Duration Distribution

• Number of rejected calls due to overload

• Number of call attempts

pfmhwagent HOST SUPERVISION

• CPU load

• Physical Memory Usage

• Disk Usage

• Swap Usage

• Host temperature

pfmhwagent FILE SYSTEM LIST

• Disk usage

pfmddup / • Data update result

• Bulk data update results

• Data log result

• Commit result

Table 1: For platform services, list of objects and reports (each line represents the objects of a service and the interesting reports associated) (Continued)

Service Object Reports



2.2. Events description per report

Table 2: Events description per report

Service Report Event Description

pfmaccess Command Result operator_interrupted The SMP command has been interrupted by the operator

other_problem The SMP command has not been executed due to another problem

semantic_error A semantic error has been detected in the SMP command

successful The issued SMP command has been successfully executed

syntax_error A syntax error has been detected in the SMP command

pfmaccess Logon Result wrong_password The user entered a wrong password

successful Successful logon

timeband_not_allowed The user logon is not allowed due to calendar and timeband restrictions

user_revoked The user was revoked

password_expired The user password has expired

technical_problem Technical problem during logon

revoked_too_many_pwd The user entered too many wrong passwords

too_many_sessions Too many active sessions for this operator



pfmaccess Logoff Type too_long_inactivity Too long user inactivity

normal_user_logoff The user has logged out normally

pfmaccess Modify Password modify_pwd_nok Modify password not successful

modify_pwd_ok Modify password successful

technical_problem Technical problem during modify password

pfmaccess Session holding time

Duration Operator session duration

pfmalarm Severity Distribution

Warning - Threshold - Benign - Minor - Blocking - MajorAvailable subscriptions

Severity level (configurable)

pfmconfig Successful / Unsuccessful Calls Distribution

Ok The call has been completely successful

Nok_user The call has been released due to a user error

Nok_data The call has failed due to a database inconsistency

Nok_service The call has failed due to a network event (user release, busy, .. ) or due to an SSP or SCP execution failure

Table 2: Events description per report (Continued)




pfmconfig Main Call Events Occurrence Distribution

Answered The call has been answered

Busy The called number has been found busy

Congestion The call has encountered congestion

No_reply The no reply timeout has been reached

other_failure Another problem occurred during the call

premature_release Calling or called party has released the call before it becomes stable

acm_received Signal end of selection has been received

route_select_failure route_select_failure in connect operation

pfmconfig Mean Call Duration Distribution

Time Duration of the call expressed in seconds

pfmconfig Number of rejected calls due to overload

Rejected Call rejected due to overload

pfmconfig Number of call attempts

Number Number of call attempts

pfmhwagent CPU load Load cpu load (system+user+nice) (%)

Peak maximum cpu load in the quarter

pfmhwagent Physical Memory Usage

Usage Physical memory usage (%)

pfmhwagent Disk Usage Usage Filesystem usage (%)





2.3. Available subscriptions

These are the subscriptions available by default with the OSP 2.4 platform.

pfmhwagent Swap Usage Usage Physical memory usage (%)

pfmhwagent Host temperature Status Temperature value (degree)

pfmddup Data update result

Ok Data update successful

Nok Data update unsuccessful

Archived Data update archived

pfmddup Data log result Ok Successful log

Nok Unsuccessful log

pfmddup Commit result Ok Successful commit

Nok Unsuccessful commit

pfmddup Bulk data update results

Update Total number of bulk data updates

Update-nok Unsuccessful bulk data updates

Commit Number of commits

Archive Bulk data update archived

Archive-nok Bulk data upate unsuccessfully archived





Table 3: Available subscriptions

Service Object Report Subscription Name

pfmaccess OPERATOR • Logon Result

• Logoff Type

• Modify Password

• Cmd result

• Session holding time

OSP_operator

pfmalarm / Severity Distribution OSP_alarm

pfmconfig SERVICE • Successful / Unsuccessful Calls Distribution

• Main Call Events Occurrence Distribution

• Mean Call Duration Distribution

• Number of rejected calls due to overload

• Number of call attempts

OSP_call

pfmhwagent HOST SUPERVISION

• Physical Memory Usage

• Disk Usage

• Swap Usage

• Host temperature

OSP_hardware

pfmhwagent • HOST SUPERVISION

• CPU # (tag)

•CPU load OSP_hardware-CPU



2.4. Relevant subscriptions

The table below lists relevant subscriptions that you can create using platform services' reports.As all reports are available for all objects, you could for example create a subscription topfmaccess - SERVICE - Modify Password. But this subscription would be meaningless, as thestatistics on password changes are relevant on OPERATOR only.

3. Subscriptions

Before viewing the procedure for creating a subscription, let’s first describe the Subscriptioninterface which is needed to create a subscription.

pfmddup / •Data log result

•Data update result

•Commit result

•Bulk data update results

OSP_dataupdate

Table 4: Relevant subscriptions

Service Object Report

pfmaccess SERVICE Command Result

pfmhwagent FILE SYSTEM LIST

Disk usage

Table 3: Available subscriptions (Continued)

Service Object Report Subscription Name



is

3.1. Statistical subscription interface

The figure below shows the Subscription GUI with the General tab open.

Figure 2.1 - Subscription object - General tab

Table 5: Statistical subscription interface

Item Description

1 A two-level tree allows selecting existing subscriptions and automatically displaying their data. Clicking on a subscription displays the corresponding data in the tabbed panels.

2 The interface reacts according to the type of subscription selected. Information irrelevant for a given type is not displayed anymore (Example: Monitoring subscription). Main information is grouped in the General information top frame (2 bis).

3 Access control selection lists: only available to stat providers.

See OSP 2.4 Statistics Service Description.

1

2

3

2 b



3.1.1. General Information frame

The figure below shows the General Information frame.

3.1.2. Dimension tab

When a subscription is displayed, the lists in the Dimension tab are displayed automatically. The

same behaviour happens when a service name is selected using the button - but not when theservice name is entered manually.

Table 6: General information frame description

Field Description

Service Allows selecting an existing service.

IMPORTANT: Statistics must have been defined for this ser-vice and you must have the appropriate rights for this service.

Name Name of the subscription. You can either select an existing subscription or enter a new name for a new subscription.

Type Allows selecting the type of the subscription:- normal- monitoring- threshold- televoting

Granularity Not available with subscriptions of monitoring typeSubscription granularity that can be fixed to 5, 10, 15, 20, 30 or 60 minutes.Used to fix the granularity at which counters have to be saved on disk.

Oracle counters storage Flag to define if subscription counters are stored in oracle or on files.



Figure 2.2 - OSP_call subscription displayed => lists in the Dimension tab automatically displayed



3.1.3. Selection tab

Figure 2.3 - Subscription with the Selection tab open

After creation, only the left part (1) displays, as Display Report information (2) is useless at thismoment.For each dimension (tabs marked Dim), the operator must define which tuples (List - All - SQL) willbe used for the subscription.

3.1.4. Other tabs

The other tabs as well as the two mentioned above are described in the procedures below.

21



3.1.5. Subscription menu

The figure below shows the Subscription menu.

3.1.5.1. Refresh command

When a subscription is created or removed, the node in the Stat Tree is created or removedvisually, but no global refresh is performed.The Refresh Tree item in the Subscription menu, when selected, refreshes the tree and displaysthe subscriptions created (or cleans up the ones removed) since the object interface has beenopened.

Figure 2.4 - Subscription menu - Refresh Tree



3.2. How to create a subscription to statistics

3.2.1. Principle

The statistical data are not automatically sent to the operator. To receive these data, the operatormust subscribe to the statistics of the service(s). This document explains how to create such asubscription.

3.2.2. Subscription types

Table 7: Subscription types

If the type is… Then data are sent to...

Normal a predefined report that can be displayed later.

Monitoring a direct window. Data are refreshed based on a timer value.

Threshold an alarm or e-mail, based on value thresholds reached for events selected.

Televoting a predefined report that can be displayed later.

Recovery (reserved for Alcatel-Lucent internal use).

To create, remove or modify a statistical subscription, the operator must beprovider for pfmstat service.



3.2.3. Normal subscription

Execute the procedure below to create a normal subscription.

Table 8: Procedure for creating a normal subscription .

Step Action

1 Double-click Subscription in the pfmstat menu.

The Subscription interface is displayed:

Figure 2.5 - Subscription GUI with the General tab open

2In the General information frame, select a service using the button.

IMPORTANT:

• The service must exist,

• statistics must have been defined for this service,

• you must have the appropriate rights for this service.



3 Fill in a new name (max. 20 characters) for the subscription.DEFINITION: ‘new’ means 'not yet used'.

4 Select normal for the type of the subscription.

5 Select the appropriate granularity (= frequency).

6 To set Begin Date and Begin Time, simply click in the fields: valid default date and time appear. Change the values if needed. You can even select a Begin period in the past. If you don’t specify a date, the creation date is used.

Table 8: Procedure for creating a normal subscription (Continued).

Step Action



7 Set the Storage values according to your needs.

EXAMPLE: set every field to '1'.

Please refer to Statistics Service Description for more about data storage.

If you try to create the subscription right away, you will get this message.

Figure 2.6 - Missing mandatory parameter window - Report number

It indicates that you have to dimension the data before you can create thesubscription.


Step Action



8 Click on the Dimension tab.In the frame Available reports in the Service, right-click to display the context menu, then select Refresh.

Figure 2.7 - Dimension tab - Available Reports in the Service frame - context menu - Refresh

The available reports are displayed.


Step Action



9 If the service name in step 2 has been selected, the frame 'Available reports in theservice' automatically displays the reports.

• Click to select one or several reports.

• Right-click to display the context menu.

• Click 'Select'.

Figure 2.8 - Dimension tab - context menu - Select

The report is shown as selected.

EXAMPLE:

The Clear selection button cancels all selected reports.


Step Action



10 Repeat step 9 to select more reports if needed.

Reports are defined for the service during service development usingstatistical events in SIBs. There is no way for an operator to create or modifyreports: they are part of the service specifications.

You may now proceed with the subscription creation.

11 Select Create in the Subscription menu.

A message telling you the subscription is created appears in the Message area.

Figure 2.9 - Message: Subscription created


Step Action



To view the results of the subscription you have just created, use the Subscription Wizardobject. See Section 10. "Subscription Wizard" on page 134.

3.2.4. Threshold subscription

A Threshold subscription is similar to a Normal one, except that the operator has to specify thethreshold for one or several events in one or several reports.

12 The new name also appears in the list of available subscriptions for the service:

Figure 2.10 - New subscription (“sevr_normalsub”) appears in the list of the available subscriptions of the concerned service (here: pfmconfig)


Step Action



Table 9: Procedure for creating a threshold subscription.

Step Action


The Suscription GUI is displayed:

Figure 2.11 - Subscription object with the General tab open


IMPORTANT:

• The service must exist

• Statistics must have been defined for this service

• You must have the appropriate rights for this service.




4 Select Threshold as subscription type.The Threshold tab becomes active (no longer grey).


6 To set Begin Date and Begin Time, simply click in the fields: valid default date and time appear. Change the values if needed. You can even select a Begin period in the past. If you don’t specify a date, the creation date is used.


EXAMPLE: set every field to '1'.

Please refer to Statistics Service Description for more about data storage.



It indicates that you have to dimension the data before you can create thesubscription.


Step Action



8 Click on the Dimension tab.In the frame Available reports in the Service, right-click to display the context menu, then select Refresh.

Figure 2.13 - Dimension tab - Available Reports in the Service frame - context menu



Step Action



9 Specify one or several reports.If the service name in step 2 has been selected, the frame 'Available reports in theservice' automatically displays the reports.



• Click 'Select'.



EXAMPLE:

The Clear selection button cancels all selected reports.


Step Action






11 In the Threshold tab, fill in the threshold reporting.

Figure 2.15 - Selection of Threshold reporting in the Threshold tab

If you select Mail when Threshold reached, you have to fill in an e-mail addressas in the figure above.


Step Action



12 Specify one threshold.Select one report in the frame 'Selected Reports in the Subscription'.In the frame 'Available events in the selected report':

• Right-click, then click 'Refresh' in the menu or double-click on the selected report,

EXAMPLE: In the figure below, “Successful / Unsuccessful Calls Distribution” is selected as report. After a Refresh in the “Available Events in the selected report” frame, the events present in the selected report are displayed.

• Select one or several events with the mouse,

• Right-click, then click 'Select' in the menu.

EXAMPLE: In the example below the first two events are selected. After right-clicking on them, the context menu appears allowing selecting them.


Step Action



12 (end)

Figure 2.16 - Example: Selection of events in the “Available Events in the selected report frame”

Modify the Threshold value for each of the selected events.


A message telling you the subscription is creaed appears in the Message area.



Step Action

Events selected Report of the selected events

Value you can change




Figure 2.18 - New subscription (“sevr_thresholdsub”) appears in the list of the available subscriptions of the concerned service (here: pfmconfig)


Step Action



3.3. Monitoring subscription

3.3.1. Creation of a monitoring subscription

Execute the procedure below to create a monitoring subscription.

Table 10: Procedure for creating a monitoring subscription .

Step Action


The Suscription interface is displayed:





IMPORTANT:

• The service must exist,

• Statistics must have been defined for this service,



4 Select Monitoring as subscription type.The interface of the subscription changes.

Figure 2.20 - Subscription GUI - Monitoring selected as type

Table 10: Procedure for creating a monitoring subscription (Continued).

Step Action

As “Monitoring” is selected as subscription type, some frames are removed: - no Restrictions frame- no Storage frame-no Access control framein this General tab.

As “Monitoring” is selected as subscription type, this new field appears and no longer Granularity



5 Specify a Monitoring timer.The smaller the granularity, the more the results are influenced by the time needed for the command to interrogate the SMF.

EXAMPLE: The first monitor command is sent at 10:00:00 with a 10 seconds timer. Say 2 seconds are needed for the answer to come back: the second monitor command will be sent at 10:00:12 and not 10:00:10.


Step Action



6 Specify one report.If the service name in step 2 has been selected, the frame 'Available reports in theservice' automatically displays the reports.



• Click 'Select'.



The Clear selection button at the bottom of the tab cancels all selected reports.


Step Action



7 Add one or several dimensions to the subscription.

See Section 3.6. "Adding dimensions to a subscription" on page 105.

EXAMPLE: Selection of Host object.

Result:

8 If you specified dimensions to the subscription, select the scale you want to use for the display of data in the combobox that appears in the Selection tab.

Figure 2.22 - Specification of the scale in the Selection tab



Step Action




Result: The Statistical results window appears.




Step Action



3.3.2. Monitoring of existing subscription

With Release 2.4, a new command “Monitor” allows the operator to open a monitoring windowbased on the specifications of any subscription.The procedure to follow is the same as the one for displaying a Normal subscription with orwithout dimensions. At the end of the procedure, just click on Monitor in the Subscriptionmenu.

It can appear that sometimes in the monitoring data shown, you get full "-1" counters data.This is normal, this only happens for normal subscriptions you monitor (not for monitoringsubscription you create). In that context, if the period (according to the granularity of thesubscription) has changed between two monitor requests, counters have been written todisk (counter files) and have been reset in memory segment of current period to zero, sowe loose some data if we give information at the first monitor request after the change ofperiod (as the monitoring is directly reading in that memory segment). In that case,instead of giving non complete information, we return all -1.

To illustrate, let's take the example of a monitoring every 10 seconds on a normal subscription witha 5 minutes granularity. Suppose the real counters value in memory segment of the current periodare:

At 10:29:35: 4, 2, 5At 10:29:45: 6, 3, 5At 10:29:55: 7, 3, 8==> Write of counters on disk + reset of memory segment to 0 at 10:30:00At 10:30:05: 0, 1, 0

The counters shown by the monitoring window will be:

At 10:29:35: 4-(value of first cnt 10s before), 2-(value of second cnt 10s before), 5-(value of thirdcnt 10s before)At 10:29:45: 2, 1, 0At 10:29:55: 1, 0, 3At 10:30:05: -1, -1, -1

10 If you minimise the Statistical Results window, you can see the new subscription in the list of available subscriptions for the service:


Step Action



We can not show 0, 1, 0 because at 10:29:58, maybe some counters have still been updated inmemory but erased at the end of the period by the write operation.So, at the change of period, we took the decision to show "crazy" data to avoid showing inconsitantdata. We could, to avoid the surprise effect of the negative values, show all zeroes, but all zeroescan be a consistant data in some cases, while here we are in the case it can not be.

3.4. Televoting subscription

A Televoting subscription is similar to a Normal one except that :

• at least two dimensions are mandatory (with a maximum of three dimensions). The first one is the televoting session. The second / third ones are other dimensions (e.g.: service access number, the origin of the call, …).

• a specific report is dedicated to televoting, which is the only one to be selected for the subscription.



Execute the procedure below to create a televoting subscription.

Table 11: Procedure for creating a televoting subscription .

Step Action


The Suscription interface is displayed:



IMPORTANT:

• The service must exist

• Statistics must have been defined for this service


3 Fill in a new name (max. 20 characters) for the subscription.DEFINITION: ‘new' means 'not yet used'.



4 Select the Televoting as subscription type.


6 To set Begin Date and Begin Time, simply click in the fields: valid default date and time appear. Change the values if needed. You can even select a Begin period in the past. If you don’t specify a date, the creationdate is used.


EXAMPLE: Set every field to '1'.

Please refer to OSP 2.4 Statistics Service Description for more informationabout data storage.



It indicates that you have to dimension the data before you can create the subscription.

Table 11: Procedure for creating a televoting subscription (Continued).

Step Action



8 Click on the Dimension data tab.In the frame Available reports in the Service, right-click to display the context menu, then select Refresh.

Figure 2.26 - Dimension tab - Available Reports in the Service frame - context menu



Step Action



9 If the service name in step 2 has been selected, the frame 'Available reports in theservice' automatically displays the reports.



• Click 'Select'.



The Clear selection button at the bottom of the tab cancels all selected reports.





Step Action



11 Select one or more objects as dimension.


Step Action



3.5. Parameters that can be modified in a subscription





Figure 2.29 - List of available subscriptions for a service

Table 12: Parameters that can be modified in a subscription .

Window Parameter

General End period

General Subscription Reporting

General Provider/Subscriber Restriction


Step Action



General Reporting Language

General Access Control - Provider Group / Subscriber Group

Threshold Threshold Reporting and value of threshold (from 2.4.03)

Watcher All parameters

Table 12: Parameters that can be modified in a subscription (Continued).

Window Parameter



3.6. Adding dimensions to a subscription

3.6.1. Object as dimension

Execute the procedure below to add dimensions to a subscription.

At this point, the operator has to specify, for each object, which type of selection is needed. In theSelection window, there is a frame for each object. The operator has three possibilities:

• select all instances of the object,

• specify a SQL used to find the instances,

• specify a list of instances (limited to 20).

Figure 2.30 - Display selection frame in Selection tab

Selection of ALLThe operator has to select as Selection type ‘All’ option.

Selection of SQLThe operator has to select as Selection type ‘SQL’ option and to enter a SQL condition.

Table 13: Procedure for adding dimensions to a subscription .

Step Action

1 If the service name has been selected, the frame 'Available Objects' automatically displays the objects.

• Select one or several objects

• Right-click and 'Select' in the context menu.

• If the service name has been typed, first right-click and 'Refresh' in the context menu, then select objects as above.



Figure 2.31 - Selection of SQL as display selection => field appears allowing entering a SQL condition

MN is the only attribute usable in the SQL condition. MN transparently maps to the right attribute(e.g. MN10, NAME) for that object.

EXAMPLES:

IMPORTANT: The space reserved for the counters is the space allocated for the existing instances when the subscription is created. Future instances created will never be considered by the subscription, unless the selection ALL is used. In this case, the subscription is dimensioned using all the tuples in the table, empty or not.

3.6.1.1. Selection of list

Execute the procedure below to select a list of instances.

Table 14: Selection of SQL - examples

SQL Description

MN='Alcatel' Selects one instance, e.g. the customer Alcatel

MN like '6050%' Selects several instances, e.g. all cards # beginning with 6050

Table 15: Procedure for selecting a list of instances .

Step Action

1 In the Selection tab, select List in the Display selection frame.



If the object contains a large number of instances, the operator can specify an SQL condition tolimit the list returned.

IMPORTANT: The space reserved for the counters is the space allocated for the existing instances when the subscription is created. Future instances created will never be considered by the subscription, unless the selection ALL is used. In this case, the subscription is dimensioned using all the tuples in the table, empty or not.

2 In the Help list frame:

• Right-click and select “Refresh

”

• Select one or several instances with the mouse

• Right-click and select 'Select' in the menu.

Table 15: Procedure for selecting a list of instances (Continued).

Step Action



3.6.2. Report as dimension

Execute the procedure below to add a report as dimension.

There is no need to specify a type of selection (like for object as dimension), as all events of thereports are considered.

3.6.2.1. Report dimension property

The example of a free phone service is taken as an illustration of the Report Dimension Property:

The statistics ticket looks like:

Table 16: Procedure for adding a report as dimension .

Step Action

1 In the Dimension tab, if the service name has been selected, the frame 'Available Reports' automatically displays the reports.

• Select one or several instances

• Right-click, then click Select in the context menu.

• If the service name has been typed, first right-click, then select Refresh in the context menu, then select reports as above.

Table 17: Example of a freephone service.

Stage Description In the Statistics Ticket

1 A user dials a free phone number and the service identifies it.

The service adds the free phone object.

2 The service translates the free phone number to a destination.

The destination object is added.

3 The service 'connects' the service user to the destination - but this is not available.

Event NOK is added.

4 The service determines an alternative destination.

The destination object is added.

5 The service 'connects' the service user to the second destination and is answered.

The event OK is added.



As we can see now, the event NOK and/or the event OK could be used for the free phone object.The operator can specify which rules apply:

Figure 2.32 - Example of a free phone service taken as an illustration of the Report Dimension Property

Table 18: Statistics ticket .

Free Phone Destination Event Destination Event

Number object Object 1 NOK Object 2 OK



4. How to display statistical reports

Once a subscription has been created, operators can use it to display statistical reports.

Execute the procedure below to display statistical reports.

Table 19: Procedure for displaying statistical reports .

Step Action

1 Double-click the Subscription GUI of pfmstat service.

Figure 2.33 - Pfmstat - Subscription GUI.



2 From the 'Available services' tree list in the Subscription window, open a service for

which subscriptions have been defined (marked by when closed). The subscriptions available for the service are shown below the service branch.

Figure 2.34 - Available services tree list

Table 19: Procedure for displaying statistical reports (Continued).

Step Action



3 • Select a subscription in the tree.

The Subscription form displays the subscription's parameters.

• Select Display Report in the Subscription menu.

Figure 2.35 - Subscription menu - Display Report

Depending on the subscription selected, the result window opens or you get amessage windows requiring additional information.

Figure 2.36 - Missing mandatory parameter window


Step Action



4 After opening tabs and selecting parameters, provide the information missing and select Display Report again in the Subscription menu.

Figure 2.37 - Graph of a statistical report

5 Click on the Data tab to display the data sheet of the statistical report.

Figure 2.38 - Data sheet of a statistical report


Step Action



5. DisplayReport Subscription with Dimension

The procedure to follow is the same as the one for displaying a Normal subscription. The operatorhas two additional possibilities:

• to specify a X-scale, either using time or one of the selected dimensions,

• to specify a sub-selection (All, SQL or List) for each object dimension, based on the selection made when the subscription was created.

This sub-selection is not available for report dimension, as all the events of the report are alwaysselected.There is a maximum of 500 instances if a dimension is used on the X-scale.

For a televoting subscription, it is possible to select a dimension as Y-scale. For example,the results of the televoting could be viewed by 'service access number' as X-scale and'origin of the calls' as Y-scale.

It is also possible to use the new command Monitor on any subscription with dimensions.

6. Operations on statistical report data

6.1. Introduction

The report window of a subscription allows calculating the total and the mean of the data bycolumn (V-Total, V-Mean) and by line (H-Total, H-Mean).When a total or mean are selected, additional series appear in the Graph display; in the Datadisplay, columns are added at the right or the bottom of the data sheet.



6.2. Total of statistical data

Execute the procedure below to display the sum of the data in a statistical report.

Table 20: Procedure for displaying the sum of statistical report data .

Step Action

1 Click Display Report in the Subscription menu.




2 In the Subscription menu, select View / H-Total.

Figure 2.40 - Subscription menu - View command.

An additional series (Sum) appears in yellow.

Figure 2.41 - Total of statistical data added in yellow.

Table 20: Procedure for displaying the sum of statistical report data

Step Action

Sum of statistical data (yellow)



To apply or suppress the four possible calculations in one go, use Select All / Select none inthe View sub-menu.

3 Select the Data tab.An additional column (Sum) has appeared in yellow at the right of the data sheet.

Figure 2.42 - Data tab - Sum column added

Table 20: Procedure for displaying the sum of statistical report data

Step Action

Sum of statistical data

Table 21: Total of statistical report data.

To total the data per... Click....

line (horizontally) H-total in the View menu. The column appears at the right.

column (vertically) V-total in the View menu. The column appears at the bottom.



6.3. Mean of statistical report data

Execute the procedure below to find the mean of the data in a statistical report.

Table 22: Procedure for displaying the mean of the data of a statistical report .

Step Action


Figure 2.43 - Graph of a statistical report.



2 In the Subscription menu, select View / H-Mean.An additional series (Mean) appears in yellow.

Figure 2.44 - Mean of statistical data added in yellow.

Table 22: Procedure for displaying the mean of the data of a statistical report (Continued).

Step Action

Mean of statistical data



3 Select the Data tab.An additional column (Mean) has appeared in yellow at the right of the data sheet.

Figure 2.45 - Data tab - Mean column added

To apply or suppress the four possible calculations in one go, use Select All /Select none in the View sub-menu.

Table 22: Procedure for displaying the mean of the data of a statistical report (Continued).

Step Action

Mean of statistical data

Table 23: Mean of statistical report data.

To mean the data per ... Click...

line (horizontally) H-mean in the View menu. The column appears at the right.

column (vertically) V-mean in the View menu. The column appears at the bottom.



7. How to export statistical data to an external application

7.1. Introduction

The statistical reports provide, in a quick, easy and readable way, useful information about theOSP platform behaviour.But one might want even more elaborate reports or charts. The Statistics service provides easyexport of statistical data to an external application (spreadsheet applications or others)

7.2. Prerequisite

Before exporting data to an external application, you have to have first selected the externalapplication you want to use as default.

See How to select an external application in OSP 2.4 Management System User’s Guide.

Execute the procedure below to export statistical data to an external application.

Table 24: Procedure for exporting statistical data to a spreadsheet .

Step Action

1 Select Display Report in the Subscription menu.The Statistical results window appears.




Sum and Mean are exported if they have been set in the Graph or Data display.

The file exported to the external application must be closed before you can make a newexport from the same report in the same session.

2 Click Export in the File menu.

Figure 2.47 - File menu - Export

The data are exported to the external application you selected in Edit\ Preferences.In the example below, the data are exported to Excel.

Figure 2.48 - The selected spreadsheet application is launched and the data of the above chart are exported to Excel (external application selected).

Table 24: Procedure for exporting statistical data to a spreadsheet

Step Action



8. How to save a statistical report

8.1. Introduction

Statistical reports can be saved for further reference and future use.



8.2. How to save statistical report data

Execute the procedure below to save statistical report data.

Table 25: Procedure for saving statitical report data .

Step Action





The data are separated by tabs or commas, depending on your settings. When you openthe .txt file using Excel, the tab characters or commas are used to automatically parse thedata into columns.

To save the data and the graph in one go, select Graph and Data in the Save window,then give a file name. The same name will be used for the data and the graph. Data filesget the .txt extension; graphs get the .jpg extension.

8.3. How to save a statistical report graph

Execute the procedure below to save the graph of a statistical report.

2 Click Save in the File menu.

The Save window appears:

Figure 2.50 - Save window.

3 As you are saving the data, click on OK.

4 Select the folder to which you want to save the data.

5 Fill in a file name.

6 Press Save.

Table 25: Procedure for saving statitical report data (Continued).

Step Action

You can choose to save:- data- graph- data and graph



Table 26: Procedure for saving a statistical report graph .

Step Action

1 Click Display Report in the Subscription menu.The Statistical results window appears.




To save the data and the graph in one go, select Graph and Data in the Save window,then give a file name. The same name will be used for the data and the graph. Data filesget the .txt extension; graphs get the .jpg extension.

2 Select Save in the File menu.

The Save window appears:

Figure 2.52 - Save window.

3 Select Graph.

4 Select the folder to which you want to save the graph.

5 Fill in a file name.

6 Press Save.The graph of the statistical report is saved in jpeg format.

Table 26: Procedure for saving a statistical report graph (Continued).

Step Action



9. How to print a statistical report

9.1. Introduction

Statistical reports - data as well as graphs - can be printed directly from the Subscriptionwindow.



9.2. How to print statistical report data

Execute the procedure below to print the data of a statistical report.

Table 27: Procedure for printing the data of a statistical report .

Step Action


Figure 2.53 - Graph of a statitstical report



2 Select Print in the File menu.

The Print window is displayed:

Figure 2.54 - Print window

3 Select Table of data as data to print.

Table 27: Procedure for printing the data of a statistical report (Continued).

Step Action



To print the data and the graph together, select them both in the Print window at step 2.This option is not available with printing to file.

4 Click OK.The Printing utilities window appears.

Figure 2.55 - Printing utilities window

5 Adjust the settings if need be and press OK.The data of the statistical report are printed.

Table 27: Procedure for printing the data of a statistical report (Continued).

Step Action



9.3. How to print a statistical report graph

Execute the procedure below to print the graph of a statistical report.

Table 28: Procedure for printing a statistical report graph .

Step Action





2 Select Print in the File menu.

The Print window appears.

Figure 2.57 - Print window

3 Select Graph.

The Fit to page flag allows printing the graph on one page whereas the Zoom factor allows adjusting the graph to a given dimension.

Table 28: Procedure for printing a statistical report graph (Continued).

Step Action

No longer grey

Nolongergrey butselected



To print the data and the graph together, select them both in the Print window at step 2.This option is not available with printing to file.

10. Subscription Wizard

10.1. Presentation

From OSP Rel 2.3.08 onwards, a new interface has been introduced to manage the statisticalreports.This interface is accessed via the Wizard object of pfmstat service. Instead of immediatelylaunching the Wizard available with previous releases, it opens a tree-based interface allowing:

• listing existing subscriptions with their reports and dimensions

• displaying reports and sending them via e-mail

• scheduling differed sending of reports.

4 Press OK.The Printing utilities window appears.

Figure 2.58 - Printing utilities window

5 Adjust the settings if need be and press OK.The graph of the statistical report is printed.

Table 28: Procedure for printing a statistical report graph (Continued).

Step Action



These operations are available with a few simple mouse clicks, which can be a comfortablealternative to field navigation in the Subscription window.

10.2. Description of the tree interface

10.2.1. Introduction

The Wizard window presents three parts:

• the Stat Tree frame (Available services) (1)

• the Time selection frame (2)

• the Preferences frame (3)

Figure 2.59 - Subscription Wizard window.

1

2

3



10.2.2. Wizard menu

The Wizard menu provides the commands needed to navigate in the tree.

Figure 2.60 - Wizard menu.

Table 29: Wizard menu commands .

Command Description

Expand all Expands the tree branches down to the dimensions.

Collapse Collapses all branches, and returns the following (may vary depending on the operator logged):

Refresh Tree Refreshes the display of the tree. This command is needed because several operators can be using pfmstat at the same time, creating or removing subscriptions (which become then unavailable).

When the dimension is an object, itsmnemonics can be accessed, but they arenot displayed through this command. Thisis because too many mnemonics in someobjects would make the display last toolong.



10.2.3. Stat Tree frame legend

The figure below shows the Stat Tree frame.

Figure 2.61 - Stat Tree

Table 30: Description of the Stat Tree

Item Description

1 Identifies a service installed on the platform and accessible for the operator logged.

2: Identifies a service with at least one existing subscription.

3 Identifies a subscription.

4 Identifies the folder containing the report(s) within a subscription.

5 Identifies a report (per subscription, minimum: 1 report - maximum: 10 reports).

6 Identifies the folder containing the dimension(s) within a subscription.

7 Identifies a dimension: (per subscription: minimum: 0, maximum: 8). If objects are used for dimensions, then the mnemonics of the object can be accessed.



10.2.4. Time Selection frame

The figure below shows the Time selection frame.

This frame allows selecting the time scope to be used for the reported data.

Table 31: Exact scope of each item of the Time Selection frame.

Item Description

Yesterday The day before today from 0 a.m. to 12 p.m.

Today From today 0 a.m. to the current hour.

Last month From first to last day of the month before the current one.

This month From first day of this month to 12 p.m. yesterday.

Last year From Jan 1st 0 a.m. to Dec 31st 12 p.m. last year.

This year From Jan 1st 0 a.m. this year to 12 p.m. yesterday.



10.2.5. Preferences frame

This frame lists tree selections that the operator has saved for later use and quicker access.

Selecting a report in the Stat Tree frame and right-clicking on it displays a context menu that allowssaving a display report as preference.

Other Makes the window below appear and allows entering any lower / upper bound not defined above.

Table 31: Exact scope of each item of the Time Selection frame.

Item Description



EXAMPLE: The figure below shows a report selected and its context menu. Clicking “Save display report as preference” in the context menu will save the report as preference. This report will be listed in the Preferences frame.

After clicking on Save display report as preference in the context menu, the following windowappears:

Figure 2.62 - Input window allowing you to insert a preference description

Entering a preference description and clicking on OK display the selected report in the Preferenceswindow and save it as preference.



The preferences cannot be edited or modified. To use preferences, select a preference in the list,then right-click for context menu and select an action.

Figure 2.63 - Preferences frame.

If you double-click a preference instead of opening the context menu, the first command (Loadpreference) is executed immediately.

Table 32: Preference frame - Context menu description.

Item Description

Load preference Displays the report corresponding to the saved preference (same as Display Report).

Load preference and send mail Displays the report corresponding to the saved preference (same as Display Report), then sends it immediately by mail. This allows sending pre-defined reports immediately, without having to go through the selection process.

Remove preference Removes the selected preference from the list and from the <user>.properties file.

The maximum number of recorded preferences is 20.



10.2.6. Subscription not found

The Subscription Wizard allows accessing and managing subscriptions; it does NOT allow creatingthem.If a subscription was available when the preference was created, and has been deleted afterwards,loading a preference which still refers to this removed subscription will result in the message belowbeing displayed in the message area:

Figure 2.64 - Error message - Subscription not found.

The subscription that the preference was based on has been deleted and is not available anymore.The best solution is to remove the preference and to create a new one.

10.3. Description of the Statistical Results window


When you select:

• Display report in the Stat Tree context menu,

The Refresh Tree command in the Wizard menu can be used to viewthe subscriptions currently available to create preferences.However, the preferences list is not cleaned up after a subscriptionhas been removed.



• Load preference in the Preferences context menu,

• or Load preference and send mail in the Preferences context menu,

a window is generated where the results of the subscription are displayed as a graph.



As mentioned before, several subscriptions can be grouped together. In this case, the window willcontain as many graphs as there are reports in the subscriptions.This document describes the single graph and multi-graph interfaces.

10.3.2. Single graph

Figure 2.65 - Single graph Display Report.

10.3.3. Statistical results menu

The procedures in relation with the commands of the Subscription menu can be found above.

Table 33: Subscription menu commands

Commands Description

Clone Creates duplicate window(s), allowing comparing various chart types, zooms, etc.



10.3.4. Legend

View Adds a sum or a mean to the graph as per the table below:

Table 35: Single graph Display Report - Description

Item Description

Switches between the graph, the data table and the dimension.

Selects the chart type.

Selects the chart type from a drop-down list.

Toggles between 3D and 2D charts.

Colour legend of the data.

Zero values are not displayed in Areacharts.

Table 33: Subscription menu commands

Commands Description

Table 34: Subscription menu - View command.

Item Description

H- and V-total When selected, adds a series in the graph, summing up the values along the X-axis (H-total) or the Y-axis (V-total)

H- and V-mean Same effect with mean instead of sum.

Select all / none Selects or deselects all items above in a single operation.



10.3.5. Multi-graph window

When several reports are selected together, the Display Report command displays a multi-graphwindow.The left part of this window allows selecting the graph to display in the right frame.

Figure 2.66 - Statistical results window

Cursors allowing horizontal and vertical zoom.

Table 35: Single graph Display Report - Description (Continued)

Item Description

Once a Subscription Wizard window is opened, any further Displayreport (or Load preference) command will direct the output to thiswindow. To have your subscription report displayed in a singlegraph window, be sure to close any opened Subscription Wizardwindow before selecting Display report.



10.4. How to view mnemonics

10.4.1. Warnings and conditions

The mnemonics are usually not displayed to avoid time loss and prevent heavy CPU consumption.

EXAMPLE: In a Prepaid service, one of the mnemonics is the subscribers' card number. This counts in millions: displaying such a mnemonic should therefore be avoided.

Moreover, mnemonics can only be displayed when they exist: for mnemonics to be available, thedimension must be based on an object.

10.4.2. Procedure

Execute the procedure below to view the mnemonics available with the selecteddimension.

Table 36: Procedure for viewing mnemonics.

Step Action

1 Make sure the dimension is based on an object.

2 Make sure the number of tuples will not exceed available time. Common sense should help you to avoid selecting dimensions with huge number of mnemonics. There is no limitation - but displaying millions of values would take inappropriate time.

3 Select the dimension.



4 Right-click to display the context menu and select View Mnemonics.

EXAMPLE:

Figure 2.67 - Right-clicking a dimension based on an object allows viewing the Mnemonics

Table 36: Procedure for viewing mnemonics. (Continued)

Step Action



10.5. How to set an X-axis

10.5.1. Conditions

This operation can be compared with X-scale in the Selection data tab of the Subscriptionobject. By default, the X-axis of reports is expressed in TimeUnits, but other X's are possible.Only one dimension can be affected to X-axis. If you repeat the operation with a seconddimension, this last one will be the X-axis.If no dimension is selected as X-scale, the default scale is Time Units.

5 Wait until the mnemonics are displayed.

Table 36: Procedure for viewing mnemonics. (Continued)

Step Action



10.5.2. Procedure

Execute the procedure below to affect a dimension to X-axis.

Table 37: Procedure for affecting a dimension to X-axis .

Step Action

1 Select one dimension.

2 Right-click to display the context menu and select Set as X-scale.

Figure 2.68 - Dimension - Set as X-scale

3 A green X appears next to the dimension.

Figure 2.69 - Green X next to a dimension to specify it is set as X-scale

4 To deselect this dimension, select again Set as X-scale in the context menu. The green X disappears and Time Units is again the default scale for X-axis.



10.6. How to display a report, send it by mail or save it as a preference


When you use the DisplayReport method on the Subscription object, you must:

• give the time scope considered,

• select one report.

This is the Easy data selection.

You may, optionally:

• select a dimension as X (or Y if televoting is involved),

• select some mnemonics.

This is the Advanced data selection.

The Stat Tree works rather the same way.

• With easy data selection, you can select one report and have it displayed or sent by mail, and you can save it as a preference.

• With advanced data selection, you can group several subscriptions belonging to different services, or several reports, using dimensions and mnemonics, into one display (the reports, graphs and tables will not be mixed together!).

You can then have the report displayed or sent by mail or saved as a preference.

10.6.2. Easy data selection

Execute the procedure below to make an easy data selection, display a report,send it by mail or save it as preference.

Table 38: Procedure for making an easy data selection .

Step Action

1 Having the Stat Tree opened, select the appropriate time scope in the Time selection frame.

See note below.

2 Select the report you want to display.



3 Double-click the report to display it immediately (steps 6-7 below are overlooked), or right-click to display the context menu.

4 Select one of the items as per steps 5-6-7 below.

5 Select Display Report to open the immediate window displaying the results of the report.

6 Select Display Report and send mail.

Figure 2.70 - Mail input window

Fill in the appropriate mail address and click OK.

An immediate window is launched displaying the results of the selectedreports. An e-mail message is sent to the address filled in above, with thesame information (graph, data in HTML table and CSV file).

Table 38: Procedure for making an easy data selection (Continued).

Step Action

The only check made on the addressverifies if it contains an @.



Preferences are time-related: all items in Time selection are relative, except Other, which isabsolute (you give it absolute start and end). It is therefore not allowed to use Other as atime selection if you want to save the report selections as a preference. Most certainlyindeed, the data stored for the days you would select in Other will be cleaned up the nexttime the preference is loaded.

See storage duration of statistical data in OSP 2.4 Statistics Service Description.

10.6.3. Advanced data selection

Execute the procedure below to make an advanced data selection, then display areport, send it by mail or save it as preference.

7 Select Save as preference to save the current selection as a preferred tree in the Preferences list.

Figure 2.71 - Input window

Fill in a description that will appear as your preference title in the Preferenceslist, then click OK.The window closes and the entry you have just made appears in the list.

Table 39: Procedure for making an advanced data selection .

Step Action

1 Having the Stat Tree opened, select the appropriate time scope in the Time selection frame.

See the note below.

Table 38: Procedure for making an easy data selection (Continued).

Step Action



2 Using Ctrl-click or Shift-click, select the reports and specific mnemonics you want to display.

Figure 2.72 - Selection of reports and mnemonics to display

Shift-click allows easy selections; irrelevant selections are ignored.The dimensions, when existing, are part of the subscription: they areautomatically selected. It is useless to select all mnemonics: theselection is made possible only to select specific mnemonics.

See Section 10.7. "Possible selections" on page 156.

3 Right-click to display the context menu.

4 Select one of the items as per steps 5-6-7 below.

5 Select Display Report to open the immediate window displaying the results of the reports.

Table 39: Procedure for making an advanced data selection (Continued).

Step Action

You can definitely select more than one report or mnemonic.

The sequence order of the selections is irrelevant.



Preferences are time-related: all items in Time selection are relative, except Other, which isabsolute (you give it absolute start and end). It is therefore not allowed to use Other as a

6 Select Display Report and send mail.

Figure 2.73 - Mail input window

Fill in the appropriate mail address and click OK.

An immediate window is launched displaying the results of the selectedreports. An e-mail is sent to the address filled in above, with the sameinformation (graph, data HTML table and CSV file, and HTML table ofselection if dimensions were used).

7 Select Save as preference to save the current selection as a preferred tree in the Preferences list.

Figure 2.74 - Input window

Fill in a description that will appear as your preference title in the Preferenceslist and click OK.The window closes and the entry you have just made appears in the list.

Table 39: Procedure for making an advanced data selection (Continued).

Step Action

The only check made on the address verifies if itcontains an @.



time selection if you want to save the selection as a preference. Most certainly indeed, thedata stored for the days you would select in Other will be cleaned up the next time thepreference is loaded.

See storage duration of statistical data in OSP 2.4 Statistics Service Description.

10.7. Possible selections


The information presented here explains the effect of selections made by the operator in the StatTree.

10.7.2. Only the report is selected

Figure 2.75 - Only the report is selected

The report 'LOGON RESULT' is selected. All the dimensions of the subscription 'OSP_operator' areimplicitly selected. Time Units is the X-scale for the report, as no dimension has been selected as X-scale. The mnemonics of domainid dimension are displayed. The labels of the X-axis are TimeUnits (or days, months depending on the Time selection).



10.7.3. A dimension becomes X-scale

Figure 2.76 - A dimension becomes X-scale

If no mnemonic is selected, all mnemonics of all dimensions are selected implicitly. As the svcdimension has been selected as X-scale, its mnemonics will be the labels of the X-axis.

10.7.4. No X-scale defined, mnemonics selected

Figure 2.77 - No X-scale defined, mnemonics selected.

The labels of the X-axis will be Time Units (or days, months…) as in case 1: no dimension has beenselected as X-scale. But the displayed values from the stat counters will be the sum of themnemonic selected in the first dimension and of the two mnemonics selected in the seconddimension.



10.7.5. A dimension as X-scale plus mnemonics selected

Figure 2.78 - A dimension as X-scale plus mnemonics selected.

The labels of the X-axis will be the two mnemonics selected in the dimension affected as X-scale.

10.8. Examples of report outputs in e-mail messages

The information in this document uses 2.3 graphical elements. The content and behaviourof 2.4 elements are absolutely identical.

10.8.1. Example 1

In this example, the report 'Successful / …' is selected; the subscription 'Example1' contains nodimensions.

Figure 2.79 - Example 1.



The output to an e-mail message will contain:

• the graph:

Figure 2.80 - Ouptut to an e-mail message - Example 1 - graph.



• the data table:

Figure 2.81 - Output to an e-mail message - Example 1 - data table.

• as an attachment to the message, the datas.csv file for import into a spreadsheet:

Figure 2.82 - Output to an e-mail message - Example 1 - attachment to the message.

10.8.2. Example 2

In this more complex example, the selected items are the report AND five mnemonics of the'service' dimension; this dimension has been affected to X-scale, as shown by the green X.




The output to an e-mail message will contain:

• the graph (X-axis = selected mnemonics from 'service' dimension) :

Figure 2.84 - Ouptut to an e-mail message - Example 2 - graph.



• the data table:

Figure 2.85 - Output to an e-mail message - Example 2 - data table.

• as attachment, the datas.csv file.

• and another HTML attachment called selection.htm, which gives the selection made on dimensions:

Figure 2.86 - Output to an e-mail message - Example 2 - html attachment.

Figure 2.87 - Output to an e-mail message - Example 2 - html attachment opened.

This file MUST be opened in a NEW window if the only browserwindow opened is the one with the active SMP session.



10.8.3. Example 3

In this example, the three reports of the subscription 'Example3' are selected; no dimension hasbeen defined.


The output will go in three e-mail messages (one per report), each with:

• the graph

• the data table

• the datas.csv file.

Figure 2.89 - Output to an e-mail message - Three e-mail messages.



10.8.4. Example 4

In this example, the three subscriptions used above have been selected together.


The output will go to five e-mail messages (one per report), each with:

• a graph

• the data table

• the datas.csv file

• and, for the 'Example2' subscription, which uses dimensions, a selection.htm file.



Grouping together, for a direct Display Report or in a Preference, subscriptions thatbelong to different services is a perfectly valid operation.


December 7, 2006 How to sort information

3. How to sort information

1. Sorting data

In the stat or event monitoring windows, you can click on the column name:

• Alphabetical sorting is used on text columns.

• Chronological sorting is used on date/time columns.

Table 1: Mouse actions .

Mouse action Result

Left click The column data are sorted in ascending (upward) order.

Shift + Left click The column data are sorted in the order opposite to current.

Right click You can select the action from the context menu.


How to sort information December 7, 2006

2. Tips

If you leave the mouse pointer on the column name long enough, a hint appears as shown in the picture below:

Figure 3.1 - Monitoring window - hint

If you use the right click, a context menu appears as shown in the picture below.

Figure 3.2 - Monitoring window - context menu


December 7, 2006 Managing the Accounting service

4. Managing the Accounting service

1. How to decode stored tickets

Only the statmngr operator has the rights to decode the stored tickets using the DECODE object.The accounting tickets are stored on disk in a binary format. The 'decode' process converts them inbulk to a readable format.


Managing the Accounting service December 7, 2006

Execute the procedure below to decode stored tickets.

Table 1: Procedure for decoding stored tickets.

Step Action

1 Double-click the Decoding GUI in the pfmstatacc menu.

Figure 4.1 - Profile view - pfmstatacc GUI’s

The Decoding interface is displayed.

Figure 4.2 - Decoding GUI

2 In the Service Name field of the Decoding interface, select a service.



1.1. Customised decoding libraries

When the output of the generic decoding library needs to be customised, it is allowed to select acustom library that will be used instead of the generic one.This library inherits the generic one; all the methods can be overwritten and adapted as needed.Only one decoding library can be used at a time; several customised libraries can be used atdifferent times or for different purposes. The library to be used must be selected according to theprocedure in OSP 2.4 Accounting Service Description - Operator’s Workflow.

3 • Provide a unique name for the decoded file.

• If left empty, a sequence number will be used as name.

In both cases, the name will be automatically prefixed with 'hd_' to give the file name.

4 Set the internet mail address to which the message will be sent at the end of the decoding.

5 Select Generic or Custom as decoding library.

See Section 1.1. "Customised decoding libraries" on page 170.

6 Select Over a period or Specific file.

See Section 1.2. "Decode in one file" on page 171.

7 Depending on choice in step 6,

• specify a period (date and time). The previous day will be used as default value.

• specify a filename.

8 In the Decoding menu, select Decode.

Figure 4.3 - Decoding GUI - Decoding menu

Table 1: Procedure for decoding stored tickets.

Step Action



1.2. Decode in one file

This flag allows selecting one particular file for decoding, instead of managing all files matching agiven period.

2. Reports

2.1. How to create a new report

Providers may create reports using the HISTORICAL DATA object.The accounting tickets are stored on disk in a binary format. The 'create' process converts them toa readable format and is driven by filters and selector elements. It provides a more flexibledecoding than the standard 'decode' process.The table below describes the procedure for creating reports. Once the decoding process isfinished, a mail is sent to the operator.



Execute the procedure below to create a new report.

Table 2: Procedure for creating a new report .

Step Action

1 Double-click Historical data GUI in the pfmstatacc menu.

The Historical data GUI appears.

Figure 4.4 - pfmstatacc - Historical data GUI

2 Select a service.

3 • Provide a unique report name for the decoded file.

• If left empty, a sequence number will be used as report name.

4 Set the internet mail address to which the message will be sent at the end of thereport creation.



5 Specify if all accounting files must be searched to find tickets sent during the definedperiod.

6 Specify the kind of report to create: full, reduced or both.

• Full report: lists all the tickets matching the selection criteria.

• Reduced report: records the sum or mean of the selected events - NOT applicable for tags and objects.

7 Specify a period (date and time). The previous day will be used as the default value.

EXAMPLE:

Figure 4.5 - Example of a new report being created

Table 2: Procedure for creating a new report (Continued).

Step Action



8 Define an optional filter based on objects for selecting the tickets in the Objectcriteria tab.

This procedure is fully explained in Section 2.1.1. "Object-based Filter" onpage 177.

9 Define an optional filter based on tags for selecting the tickets in the Tag criteriatab.

This procedure is fully explained in Section 2.1.2. "Tags-based Filter" onpage 178.

10 Select the events, tags and objects to be displayed in the report in the Displayselection tab.

This procedure is fully explained in Section 2.1.3. "Selection of elements inthe Report" on page 180.

11 Select in the event list an event to compute means (optional):

• Click on Refresh in the context menu of the 'Event list' panel,

• Select one event,

• Right-click, then click Select as mean in the menu.


Step Action



12 In Historical data menu, select Create.

Figure 4.6 - Historical data menu - Create

A message telling you the historical data has been created is displayed in theMessage area.

Figure 4.7 - Message are - Historical data created


Step Action



12 (end)

The new report appears in the tree of available services, under the concerned service(in the example below under pfmtstplat).

A mail is sent to the specified address informing you that you can consult the report.

EXAMPLE:

Figure 4.8 - Example of a mail sent after the creation of a historical data report


Step Action

Output file

New report



2.1.1. Object-based Filter

Execute the procedure below to define the objects to be used as a filter forselecting the tickets.

Table 3: Procedure for defining the objects to be used as a filter for selecting the tickets .

Step Action

1 If needed, click on Refresh in the context menu of the 'Object list' panel.

2 Enter an optional SQL statement to restrict the number of object mnemonics to be displayed.

EXAMPLE:

• MN='Alcatel' will select one instance, e.g. the customer Alcatel.

• MN like '6050%' will select several instances e.g. all cards beginning with 6050.

3 Click Refresh in the context menu of the 'Mnemonic list' panel or double-click one ofthe objects in the 'Object list'.

4 Select the mnemonics to be used as selection criteria.



If more than one criterion are defined, the logical operator AND is applied between the criteria.For instance, if object1/mnemonic1 and object2/mnemonic2 are selected in the 'Object selectioncriteria' window, the ticket will be selected only if information for both object1/mnemonic1 ANDobject2/mnemonic2 is present together.However, if the same object is selected more than once, with different mnemonics, the logicaloperator OR will be used between the criteria instead of AND. For instance, if object1/mnemonic1and object1/mnemonic2 are selected in the Object selection criteria window, the ticket will beselected only if information for object1/mnemonic1 OR object1/mnemonic2 is present.

2.1.2. Tags-based Filter

Execute the procedure below to define the tags to be used as a filter for selectingthe tickets.

5 Click Select in the context menu of the 'Mnemonic list' panel.

EXAMPLE:

Table 3: Procedure for defining the objects to be used as a filter for selecting the tickets (Continued).

Step Action



If more than one criterion are defined, the logical operator AND is applied between the criteria.For instance, if tag1/value1 and tag2/value2 are selected in the Tag selection criteria window,the ticket will be selected only if the information for both tag1/value1 AND tag2/value2 is presenttogether.However, if the same tag is selected more than once with different values, the logical operator ORwill be used between the criteria instead of AND. For instance, if tag1/value1 and tag1/value2 are

Table 4: Procedure for defining the tags to be used as a filter for selecting the tickets .

Step Action

1 If needed, click on 'Refresh' in the context menu of the 'Tag list' panel.

2 Select the tags to be used as selection criteria.

3 Click on 'Select' in the context menu of the 'Tag list' panel.

4 In the table, define the value of the tag and validate with the 'Enter' key.

EXAMPLE:



selected in the 'Tag selection criteria' window, the ticket will be selected only if the information fortag1/value1 OR tag1/value2 is present.

2.1.3. Selection of elements in the Report

Execute the procedure below to select the events, the tags and the objects todisplay in the report.

2.2. How to display a report

Once the decoding process has finished, an e-mail is sent. The operator will now be able todisplay the report using the HISTORICAL DATA object.

Table 5: Procedure for selecting the events, the tags and the objects to display in the report .

Step Action

1 If needed, click 'Refresh' in the context menu of the corresponding list.

2 Select one or several events, tags or objects.

3 Right-click, then click Select in the menu.

EXAMPLE:



Execute the procedure below to display a report.

Table 6: Procedure for displaying a report .

Step Action

1 Select a service.

2 Provide the report name of the decoded file.

3 Select the type of historical report to display.If 'both' has been selected, by default, only the full report will be displayed.

• Full report: displays the selected elements of the selected tickets in a table.

• Reduced report: displays a graph and a table of the sums and mean of the selected events.



2.3. How to save a report

From the Display Report window, you can save a report to disk.

4 In the Historical data menu, select 'DisplayReport'.

Figure 4.9 - Historical data menu - Display report

Result:

Figure 4.10 - Historical data display report

Table 6: Procedure for displaying a report (Continued).

Step Action



Execute the procedure below to save a report.

2.4. How to export a report

From the Display Report window, you can export a report to a spreadsheet applicationpreviously configured in the preferences (Edit / Preferences in the Management System mainwindow). To do this, click Export in the File menu.

2.5. How to print a report

When a report has been displayed, it is also possible to print it using the 'Print Setup' and 'Print'commands in the menu.

2.6. How to delete a report

A report no longer required can be deleted using the HISTORICAL DATA object.

Execute the procedure below to delete a report.

Table 7: Procedure for displaying a report .

Step Action

1 Click Save in the File menu.

2 Select the folder to which you want to save the report.

3 Fill in a name.

4 Click 'Save'.The report is saved in a .txt file.



2.7. How to cancel the 'Create' process

As the creation of a report can consume a lot of time and CPU, the process can be halted by theoperator using the HISTORICAL DATA object.

Execute the procedure below to cancel the ‘Create’ process.

Table 8: Procedure for deleting a report.

Step Action

1 In the Historical data interface, select a service.

2 Provide the report name.

3 In the Historical data menu, select 'Remove'.

A message confirming the report removal is displayed in the Message area.

Table 9: Procedure for cancelling the ‘Create’ process .

Step Action

1 In the Historical data interface, select a service.

2 Provide the report name.



3 In the Historical data menu, select 'Stop'.

Figure 4.11 - Historical data menu - Stop

A message confirming the cancel of the create process is displayed in theMessage area.

Figure 4.12 - Message area: Historical data stopped

Table 9: Procedure for cancelling the ‘Create’ process (Continued).

Step Action


December 7, 2006


Part II. Scheduled Jobs and Command Log

This part explains how to manage scheduled jobs and how to interrogate the command log.

How to schedule a job December 7, 2006

5. How to schedule a job

By default, the commands that can be scheduled for recording are Create, Modify andRemove, because they change the state of the database. It is thus meaningful to be able to recordsuch commands.On the contrary, the commands Count, Display, Help and List cannot be scheduled, becausetheir purpose is to give information at runtime: they do not impact the information itself.There are some exceptions to this default behaviour.A designer can alter the default behaviour of a method for some specific reasons. For example,one cannot record the creation of an operator because the password would then be visible in anunencrypted format.

See BARin14428


December 7, 2006 How to schedule a job

Execute the procedure below to schedule a job.

Table 1: Procedure for scheduling a job .

Step Action

1 Open the Scheduled Job GUI of the pfmscheduler service.

Figure 5.1 - Schedule Job GUI



2 • Fill in the different mandatory parameters:

the job name, the operator login (implicit for a subscriber),

the date and the time for the (first) execution,

the periodicity (one time, every hour, every day, every week, or every month),

the optional flag (continue / stop at the first command not ok).

• Select Start in the Scheduled Job menu.

Figure 5.2 - Scheduled Job menu - Start

A message telling you the schedule job recording has started appears in theMessage area.

Figure 5.3 - Message: Scheduled job recording started

Table 1: Procedure for scheduling a job (Continued).

Step Action


December 7, 2006 How to schedule a job

3 • The job is created and its mode is Recording.

In this mode, the commands launched by the operator are not executed but are registered instead in the scheduler database, with reference to the job.

• Perform now the job to be scheduled, then select Stop in the Scheduled Job menu.

Figure 5.4 - Scheduled Job menu - Stop

A message telling you the recording has been stopped appears in the Messagearea.

Figure 5.5 - Message: Scheduled job recording stopped


Step Action



3 (end)

IMPORTANT: The service can only execute the job after the operator has stopped the Recording mode and the job is set to mode To be done.


Step Action


December 7, 2006 How to display a scheduled job

6. How to display a scheduled job

Execute the procedure below to display a scheduled job.

Table 1: Procedure for displaying a scheduled job .

Step Action


Figure 6.1 - Pfmscheduler - Scheduled Job GUI

2 Fill in the Name and Operator in the General frame or select them

using .


How to display a scheduled job December 7, 2006

3 Select Display in the Scheduled Job menu.

Figure 6.2 - Scheduled Job - Display

Table 1: Procedure for displaying a scheduled job (Continued).

Step Action


December 7, 2006 How to modify the execution time

7. How to modify the execution time

Execute the procedure below to modify the execution time of a scheduled job.

Table 1: Procedure for modifying the execution time .

Step Action


2Fill in the Name and Operator in the General frame or select them using .


Figure 7.1 - Scheduled Job GUI


How to modify the execution time December 7, 2006

4 You can now modify:

• the date and the time for the (first) execution,

• the periodicity (one time, every hour, day, week or month).

Select Modify in the Scheduled Job menu.

Figure 7.2 - Scheduled Job menu - Modify

A message telling you the scheduled job has been updated appears in the Messagearea.

Figure 7.3 - Message: Scheduled job updated

Table 1: Procedure for modifying the execution time (Continued).

Step Action


December 7, 2006 How to modify the content

8. How to modify the content

Execute the procedure below to modify the content of a scheduled job.

Table 1: Procedure for modifying the content of a scheduled job .

Step Action

1 Open the Scheduled Command GUI of the pfmscheduler service.

Figure 8.1 - Pfmscheduler - Scheduled command GUI

2 Fill in the Job name and Operator fields in the General information frame or

select them using .


How to modify the content December 7, 2006

3 Select List in the Scheduled Command menu or use Ctrl+L.The Choose p arameters to list window appears.If you know the order number of the line to be modified, go to step 5.


4 Click Select All, then View.

Figure 8.3 - Scheduled Command: List

5 Identify the order number of the command to be modified, then click Close.

Table 1: Procedure for modifying the content of a scheduled job (Continued).

Step Action


December 7, 2006 How to modify the content

6 • In the Scheduled Command interface, fill in the Order number field.

• Select Display in the Scheduled Command menu.

Figure 8.4 - Scheduled Command menu - Display

EXAMPLE: In the figure below, the selected scheduled command is displayed.

Figure 8.5 - Scheduled command displayed


Step Action


How to modify the content December 7, 2006

You can insert new commands manually: fill in a new Order number, the new commandand then select Create in the Scheduled Command menu.

7 • Modify the command.

• Select Modify in the Scheduled Command menu.

Figure 8.6 - Scheduled Command menu - Modify

A message telling you that the scheduled command has been updated appears inthe Message area.

Figure 8.7 - Message: Scheduled command updated


Step Action

This operation is reserved to advanced operators and should bedone preferably by pasting a pre-recorded command to avoid anysyntax mistake.


December 7, 2006 How to remove a scheduled job

9. How to remove a scheduled job

Execute the procedure below to remove a scheduled job.

Table 1: Procedure for removing a scheduled job .

Step Action

1 Open the Scheduled Job GUI in the pfmscheduler service.

2Fill in the Name and Operator in the General frame or select them using .


How to remove a scheduled job December 7, 2006


Figure 9.1 - Scheduled Job menu - Display

The selected scheduled job is displayed.

Table 1: Procedure for removing a scheduled job (Continued).

Step Action


December 7, 2006 How to remove a scheduled job

4 Select Remove in the Scheduled Job menu.A message telling you that the scheduled job has been removed appears in the Message area.

Figure 9.2 - Message: Scheduled job removed

Table 1: Procedure for removing a scheduled job (Continued).

Step Action

It can be effective to cancel a scheduled job instead of removing it.When the job is removed, all the scheduled commands associated with it are deleted from the service database.When the job is cancelled, it remains as a valid entry in the service database, and all the commands stored at creation are kept: simply, the job will not be executed.To cancel the job, simply set its status to 'Cancelled', then select Modify in the Scheduled Job menu.Should the job be needed again, it can be re-activated simply by setting its status back to 'To be done'.


How to analyse command & session log December 7, 2006

10. How to analyse command & session log

Seven data are recorded in the Command Log when a command is launched:

• the command itself,

• its parameters,

• the operator who launched it,

• the date and

• the time of its execution,

• the CPU time consumed by its execution, and

• its result (ok / not ok).

If the result of the command is OK, there should be no possible misinterpretation, as thecommand and its parameters are available.If the result is NOK, verify in the table below which category of error the NOK result belongs to,and take appropriate action. (BARin14279).

Table 1: Error categories .

Error category means that... Example

Environment error The cause is external to the platform software.

The Oracle database is not running.

Syntax error The command launched by the user is not correct.

A mandatory parameter is missing.

Semantic error The syntax of the command is correct but the command cannot be played successfully.

The values chosen for the mandatory parameters identify more than one object in the database.


December 7, 2006 How to analyse command & session log

Execute the procedure below to analyse command and session log.

Table 2: Procedure for analysing command and session log .

Step Action

1 Open the Log GUI of pfmcmdlog service.

Figure 10.1 - Pfmcmdlog - Log GUI

2 Fill in the parameters (conditions) to select the type of command (not mandatory):

• Command details (Service name, Object name…)

• Log information (Operator name, Date of execution…).

If you don't specify the parameters, it will list all the commands (can be timeconsuming).


How to analyse command & session log December 7, 2006

3 Select List in the Log menu.The following window appears.


Table 2: Procedure for analysing command and session log (Continued).

Step Action


December 7, 2006 How to analyse command & session log

4 Click on the View button.

Figure 10.3 - Log: List

You can now analyse the commands, or export the list to an external file for furtheranalysis.

Table 2: Procedure for analysing command and session log (Continued).

Step Action


December 7, 2006

List of Figures

Figure 1.1 -Alarm service GUI’s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Figure 1.2 -Alarm service - Configuration GUI - General tab . . . . . . . . . . . . . . . . . . . . . . . . . 11Figure 1.3 -Alarm service - Configuration GUI - SNMP trap content tab . . . . . . . . . . . . . . . . . 12Figure 1.4 -Alarm service - Configuration GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13Figure 1.5 -Configuration menu - Display. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Figure 1.6 -Filtering: minimum level frame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14Figure 1.7 -Mailer field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Figure 1.8 -Configuration GUI - SNMP trap content tab. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15Figure 1.9 -Configuration menu - Modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16Figure 1.10 -Alarm service - Alarm GUI - Attributes tab open. . . . . . . . . . . . . . . . . . . . . . . . . 17Figure 1.11 -Alarm service - Event GUI - Attributes tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18Figure 1.12 -Alarm service - Lost event GUI - Attributes tab . . . . . . . . . . . . . . . . . . . . . . . . . . 19Figure 1.13 -Alarm service - Subscription GUI - Attributes tab open . . . . . . . . . . . . . . . . . . . . 20Figure 1.14 -Alarm service - Subscription GUI - General frame . . . . . . . . . . . . . . . . . . . . . . . 21Figure 1.15 -Alarm service - Subscription GUI - Type frame. . . . . . . . . . . . . . . . . . . . . . . . . . 21Figure 1.16 -Alarm service - Subscription GUI - Start date/time frame . . . . . . . . . . . . . . . . . . 21Figure 1.17 -Alarm service - Subscription GUI - Destinations frame . . . . . . . . . . . . . . . . . . . . 22Figure 1.18 -Subscription menu - Create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22Figure 1.19 -Alarm service - Subscription GUI - Criteria tab open . . . . . . . . . . . . . . . . . . . . . 24Figure 1.20 -Pfmalarm - Event GUI - Attributes tab open . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26Figure 1.21 -List of installed events that appears after clicking on the magnifying glass next to the Event Name field . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27Figure 1.22 -Event menu - List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Figure 1.23 -Choose parameters to list window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Figure 1.24 -Double-clicking an event in Event: List window displays it in the object interface. . 30Figure 1.25 -Data of the selected event are displayed in the Event interface window (here Attributes tab). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31Figure 1.26 -Data of the selected event are displayed in the Guidance tab . . . . . . . . . . . . . . . 31Figure 1.27 -Pfmalarm - Event GUI - Attributes tab open . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32Figure 1.28 -Event menu - Start monitoring. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33Figure 1.29 -Confirmation of the subscription creation in the Message area . . . . . . . . . . . . . . 33Figure 1.30 -Monitoring window for events. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34Figure 1.31 -Apparition of a Monitoring menu in the Menu bar . . . . . . . . . . . . . . . . . . . . . . . 34Figure 1.32 -Monitoring menu - Stop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35Figure 1.33 -Pop-up telling you the subscription has been removed . . . . . . . . . . . . . . . . . . . . 35Figure 1.34 -Confirmation of the subscription removal in the Message area . . . . . . . . . . . . . . 35Figure 1.35 -Profile view - Pfmalarm GUI’s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37Figure 1.36 -Event menu - List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38Figure 1.37 -Choose parameters to list window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38Figure 1.38 -Event: List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39Figure 1.39 -Context menu to sort data and hide columns . . . . . . . . . . . . . . . . . . . . . . . . . . . 40Figure 1.40 -Profile view - Pfmalarm GUI’s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41Figure 1.41 -Pfmalarm - Alarm GUI with the Attributes tab open . . . . . . . . . . . . . . . . . . . . . . 41Figure 1.42 -List of events installed. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42Figure 1.43 -Alarm menu - List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43Figure 1.44 -Choose parameters to list window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43


December 7, 2006

Figure 1.45 -List of all the occurrences of the selected alarm(s).. . . . . . . . . . . . . . . . . . . . . . . 44Figure 1.46 -Double-clicking an alarm in Alarm: List window displays it in the Alarm interface 45Figure 1.47 -Attributes tab with the data of the selected alarm displayed. . . . . . . . . . . . . . . . 46Figure 1.48 -Event Fields with the data of the selected alarm displayed.. . . . . . . . . . . . . . . . . 46Figure 1.49 -Profile view - Pfmalarm GUI’s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50Figure 1.50 -Event Severity GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50Figure 1.51 -Event severity menu - Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51Figure 1.52 -Event severity GUI - Level frame . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52Figure 1.53 -Event severity menu - Modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52Figure 1.54 -Event severity menu - Create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53Figure 1.55 -Profile view - Pfmalarm GUI’s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Figure 1.56 -Alarm box GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55Figure 1.57 -Alarm service - Alarm box - Host Connection tab . . . . . . . . . . . . . . . . . . . . . . . 56Figure 1.58 -Alarm Box window after connection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57Figure 1.59 -Alarm Box: Monitoring window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58Figure 1.60 -Alarm Box - Settings menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59Figure 1.61 -Timing for host info window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59Figure 1.62 -Timing to refresh the Event table window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59Figure 1.63 -Event Monitoring menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60Figure 1.64 -Event Monitoring menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60Figure 2.1 -Subscription object - General tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69Figure 2.2 -OSP_call subscription displayed => lists in the Dimension tab automatically displayed 71Figure 2.3 -Subscription with the Selection tab open . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72Figure 2.4 -Subscription menu - Refresh Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73Figure 2.5 -Subscription GUI with the General tab open . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75Figure 2.6 -Missing mandatory parameter window - Report number . . . . . . . . . . . . . . . . . . . 77Figure 2.7 -Dimension tab - Available Reports in the Service frame - context menu - Refresh. . 78Figure 2.8 -Dimension tab - context menu - Select . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79Figure 2.9 -Message: Subscription created . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80Figure 2.10 -New subscription (“sevr_normalsub”) appears in the list of the available subscriptions of the concerned service (here: pfmconfig) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81Figure 2.11 -Subscription object with the General tab open . . . . . . . . . . . . . . . . . . . . . . . . . 82Figure 2.12 -Missing mandatory parameter window - Report number . . . . . . . . . . . . . . . . . . 83Figure 2.13 -Dimension tab - Available Reports in the Service frame - context menu. . . . . . . . 84Figure 2.14 -Dimension tab - context menu - Select . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85Figure 2.15 -Selection of Threshold reporting in the Threshold tab . . . . . . . . . . . . . . . . . . . . 86Figure 2.16 -Example: Selection of events in the “Available Events in the selected report frame” . . 88Figure 2.17 -Message: Subscription created . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88Figure 2.18 -New subscription (“sevr_thresholdsub”) appears in the list of the available subscrip-tions of the concerned service (here: pfmconfig) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89Figure 2.19 -Subscription GUI with the General tab open . . . . . . . . . . . . . . . . . . . . . . . . . . . 90Figure 2.20 -Subscription GUI - Monitoring selected as type . . . . . . . . . . . . . . . . . . . . . . . . . 91Figure 2.21 -Dimension tab - context menu - Select . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93Figure 2.22 -Specification of the scale in the Selection tab. . . . . . . . . . . . . . . . . . . . . . . . . . . 94Figure 2.23 -Message: Subscription created . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95Figure 2.24 -Subscription GUI with the General tab open . . . . . . . . . . . . . . . . . . . . . . . . . . . 98Figure 2.25 -Missing mandatory parameter window - Report number . . . . . . . . . . . . . . . . . . 99Figure 2.26 -Dimension tab - Available Reports in the Service frame - context menu. . . . . . . 100


December 7, 2006

Figure 2.27 -Dimension tab - context menu - Select. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101Figure 2.28 -Message: Subscription created . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103Figure 2.29 -List of available subscriptions for a service . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103Figure 2.30 -Display selection frame in Selection tab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105Figure 2.31 -Selection of SQL as display selection => field appears allowing entering a SQL con-dition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106Figure 2.32 -Example of a free phone service taken as an illustration of the Report Dimension Prop-erty . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109Figure 2.33 -Pfmstat - Subscription GUI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110Figure 2.34 -Available services tree list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111Figure 2.35 -Subscription menu - Display Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112Figure 2.36 -Missing mandatory parameter window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112Figure 2.37 -Graph of a statistical report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113Figure 2.38 -Data sheet of a statistical report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113Figure 2.39 -Graph of a statistical report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115Figure 2.40 -Subscription menu - View command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116Figure 2.41 -Total of statistical data added in yellow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116Figure 2.42 -Data tab - Sum column added . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117Figure 2.43 -Graph of a statistical report. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118Figure 2.44 -Mean of statistical data added in yellow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119Figure 2.45 -Data tab - Mean column added . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120Figure 2.46 -Graph of a statistical report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121Figure 2.47 -File menu - Export . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122Figure 2.48 -The selected spreadsheet application is launched and the data of the above chart are exported to Excel (external application selected). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122Figure 2.49 -Graph of a statistical report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124Figure 2.50 -Save window.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125Figure 2.51 -Graph of a statistical report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126Figure 2.52 -Save window.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127Figure 2.53 -Graph of a statitstical report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129Figure 2.54 -Print window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130Figure 2.55 -Printing utilities window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131Figure 2.56 -Graph of a statistical report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132Figure 2.57 -Print window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133Figure 2.58 -Printing utilities window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134Figure 2.59 -Subscription Wizard window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135Figure 2.60 -Wizard menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136Figure 2.61 -Stat Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137Figure 2.62 -Input window allowing you to insert a preference description . . . . . . . . . . . . . . 140Figure 2.63 -Preferences frame. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141Figure 2.64 -Error message - Subscription not found. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142Figure 2.65 -Single graph Display Report.. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144Figure 2.66 -Statistical results window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 146Figure 2.67 -Right-clicking a dimension based on an object allows viewing the Mnemonics . . 148Figure 2.68 -Dimension - Set as X-scale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150Figure 2.69 -Green X next to a dimension to specify it is set as X-scale . . . . . . . . . . . . . . . . . 150Figure 2.70 -Mail input window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152Figure 2.71 -Input window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153Figure 2.72 -Selection of reports and mnemonics to display. . . . . . . . . . . . . . . . . . . . . . . . . 154Figure 2.73 -Mail input window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155


December 7, 2006

Figure 2.74 -Input window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155Figure 2.75 -Only the report is selected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 156Figure 2.76 -A dimension becomes X-scale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157Figure 2.77 -No X-scale defined, mnemonics selected. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157Figure 2.78 - A dimension as X-scale plus mnemonics selected. . . . . . . . . . . . . . . . . . . . . . 158Figure 2.79 -Example 1. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158Figure 2.80 -Ouptut to an e-mail message - Example 1 - graph.. . . . . . . . . . . . . . . . . . . . . 159Figure 2.81 -Output to an e-mail message - Example 1 - data table.. . . . . . . . . . . . . . . . . . 160Figure 2.82 -Output to an e-mail message - Example 1 - attachment to the message. . . . . . 160Figure 2.83 -Example 2. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161Figure 2.84 -Ouptut to an e-mail message - Example 2 - graph.. . . . . . . . . . . . . . . . . . . . . 161Figure 2.85 -Output to an e-mail message - Example 2 - data table.. . . . . . . . . . . . . . . . . . 162Figure 2.86 -Output to an e-mail message - Example 2 - html attachment. . . . . . . . . . . . . . 162Figure 2.87 -Output to an e-mail message - Example 2 - html attachment opened. . . . . . . . 162Figure 2.88 -Example 3. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163Figure 2.89 -Output to an e-mail message - Three e-mail messages. . . . . . . . . . . . . . . . . . 163Figure 2.90 -Example 4. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 164Figure 3.1 -Monitoring window - hint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167Figure 3.2 -Monitoring window - context menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167Figure 4.1 -Profile view - pfmstatacc GUI’s. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169Figure 4.2 -Decoding GUI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169Figure 4.3 -Decoding GUI - Decoding menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170Figure 4.4 -pfmstatacc - Historical data GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 172Figure 4.5 -Example of a new report being created . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 173Figure 4.6 -Historical data menu - Create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175Figure 4.7 -Message are - Historical data created. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 175Figure 4.8 -Example of a mail sent after the creation of a historical data report . . . . . . . . . . 176Figure 4.9 -Historical data menu - Display report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182Figure 4.10 -Historical data display report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182Figure 4.11 -Historical data menu - Stop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185Figure 4.12 -Message area: Historical data stopped . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185Figure 5.1 -Schedule Job object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188Figure 5.2 -Scheduled Job menu - Start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189Figure 5.3 -Message: Scheduled job recording started . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189Figure 5.4 -Scheduled Job menu - Stop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 190Figure 5.5 -Message: Scheduled job recording stopped . . . . . . . . . . . . . . . . . . . . . . . . . . . 190Figure 6.1 -Pfmscheduler - Scheduled Job GUI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 192Figure 6.2 -Scheduled Job - Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 193Figure 7.1 -Scheduled Job object. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 194Figure 7.2 -Scheduled Job menu - Modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195Figure 7.3 -Message: Scheduled job updated. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 195Figure 8.1 -Pfmscheduler - Scheduled command GUI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196Figure 8.2 -Choose parameters to list window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197Figure 8.3 -Scheduled Command: List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197Figure 8.4 -Scheduled Command menu - Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198Figure 8.5 -Scheduled command displayed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198Figure 8.6 -Scheduled Command menu - Modify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199Figure 8.7 -Message: Scheduled command updated. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199Figure 9.1 -Scheduled Job menu - Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201Figure 9.2 -Message: Scheduled job removed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202


December 7, 2006

Figure 10.1 -Pfmcmdlog - Log GUI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204Figure 10.2 -Choose parameters to list window. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205Figure 10.3 -Log: List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 206


December 7, 2006

Index of Topics

AAccounting service

Cancelling the Create process 184Creating a new report 171Decoding stored tickets 168Deleting a report 183, 184Displaying a report 180Exporting a report 183Printing a report 183Saving a report 182

Alarm boxDisplaying 55Managing the monitoring window 60Using the Alarm box settings 58

Alarm serviceConfiguration 12

Alarm service objects 10Alarms

Displaying 41Lisiting 47

DDisplaying and monitoring alarm information 16DisplayReport Subscription with Dimension 114EEvent seveirty level

Modifying 47Events

Creating a subscription 19Displaying 26Listing 35Monitoring 32

LLost event

Displaying 47Lost events

Listing 47SScheduled job

Displaying 192Modifying its execution time 194Modifying the content 196Removing 200

Scheduling a job 187Sorting information in monitoring window 166


December 7, 2006

Statistical dataExporting to an external application 121

Statistical reportPrinting 128Printing a statistical report graph 132

Statistical reportsDisplaying 110Saving the graph 125Those available 61Total 115

Statisticial reportsSaving 123

StatisticsThose available within the OSP 2.4 61

Statitical reportsMean 118

SubscriptionAdding dimensions 105Creating 74Parameters that can be modified 103Types 74

Subscription WizardAdvanced data selection 153Description of the tree interface 135Easy data selection 151Preferences frame 139Presentation 134Stat Tree frame legend 137Statitstical Results window description 142Time Selection frame 138Wizard menu 136

VViewing mnemonics 147XX-axis

Setting 149


December 7, 2006

Document References

Document title

OSP 2.4. Basic Operations Guide

Reference number

3CL 02350 BCXX BAZZA

Status

Released

Current edition

Ed06

Date of current edition

06/12/06

History

Edition Date Authors Editor Appraisor

Ed06 06/12/06 Sophie EvrardAlcatel-Lucent

Lisiane GoffauxAlcatel-Lucent

Ed05It01 20/10/06 Julien MartensAlcatel

Sophie EvrardAlcatel

Lisiane GoffauxAlcatel

Ed05 12/10/06 Julien MartensAlcatel



Ed04 08/02/06 Julien MartensAlcatel



Ed03 07/11/05Alcatel



Ed02 10/04/05 Sophie EvrardAlcatel



Ed01 31/05/04 Franz CarlierAlcatel

Franz CarlierAlcatel



December 7, 2006

History of changes

Edition Changes note DDTS ID

Ed06 • Modified:

“Managing the Alarm service” on page 10

“Managing the Statistics service” on page 61

“Managing the Accounting service” on page 168

“How to schedule a job” on page 187

“How to display a scheduled job” on page 192

“How to modify the execution time” on page 194

“How to modify the content” on page 196

“How to remove a scheduled job” on page 200

“How to analyse command & session log” on page 203

Ed05It01 • Modified:

“Parameters that can be modified in a sub-scription” on page 103

Ed05 • Modified:

“Statistics available within the OSP 2.4 platform.” on page 61

Ed04 • Modified:

Managing the Statistics service: Change of the structure:

3.3.1 Creation of monitoring subscription3.3.2 Monitoring of existing subscription (oldpoint 6)

VELin40192

Ed03 Improvements NA

Ed02 Update of the whole document. NA

Ed01 First edition. NA


December 7, 2006

Disclaimer

All rights reserved. Passing on and copying of this document, use and communicationof its contents not permitted without written authorisation from Alcatel-Lucent.A8690 OSP is a registered trademark of Alcatel-Lucent.The other marks and product names cited are the service marks or registeredtrademarks of their respective owners.The information in this documentation is subject to change without notice. If you findany problems in the documentation, please report them to us in writing. Alcatel-Lucent does not warrant that this documentation is error free.

Address

Alcatel - LucentAvenue Comte de Smet de Nayer, 145000 Namur, Belgium

216


Osp 24 Basic Operations Guide Ed 06

Documents

Transcript of Osp 24 Basic Operations Guide Ed 06