You are on page 1of 182

Operators Handbook

Alcatel 1350NM
Network Management

Alcatel 1320CT
Craft Terminal

AS Rel.6.5
Alarm Surveillance

3AL 88876 AAAA Ed.01

01

040126

ED

DATE

2 / 182

CHANGE NOTE

E.MIGNON L.FORESTA

M.SHABOU C.FAVERO

APPRAISAL AUTHORITY

ORIGINATOR

3AL 88876 AAAA Ed.01

Contents

Contents

-1

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

11

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

15

-1.1

Alarm Surveillance Principles . . . . . . . . . . . . . . . . . . .


Telecommunication Network Operation .
Alarm Information . . . . . . . . . . . . . . . . . . .
AS Functionalities . . . . . . . . . . . . . . . . . . . .
Current Alarm Management . . . . . . . . . .
Historical Alarm Management . . . . . . . . .
1.1.6
An Iterative Approach for
Alarm Description . . . . . . . . . . . . . . . . . . . .
-1.1.7
How AS Manages the Current Alarms . .
-1.1.8
How AS Manages the Historical Alarms .
-1.1.9
AS Advanced Features . . . . . . . . . . . . . . . .
User Interface Principles . . . . . . . . . . . . . . . . . . . . . . . .
-1.2.1
HMI Overview . . . . . . . . . . . . . . . . . . . . . . .
-1.2.2
Using the Mouse . . . . . . . . . . . . . . . . . . . .
-1.2.3
Menus, Buttons and Boxes . . . . . . . . . . . .
-1.2.4
Windows . . . . . . . . . . . . . . . . . . . . . . . . . . .
-1.2.5
On-line Help . . . . . . . . . . . . . . . . . . . . . . .
Alarm Surveillance USM Navigation Tree . . . . . . . . .

22
24
25
27
29
29
29
30
34
39
40

Getting Started . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

41

-1.2

-1.3
-2

-2.1

-2.2

-2.3

3AL 88876 AAAA Ed. 01

-1.1.1
-1.1.2
-1.1.3
-1.1.4
-1.1.5

Current Alarm Management Procedures . . . . . . . . . .


Opening a Sublist . . . . . . . . . . . . . . . . . . .
2.1.2
Getting Detailed Information about
an Alarm . . . . . . . . . . . . . . . . . . . . . . . . . . .
-2.1.3
Reserving an Alarm . . . . . . . . . . . . . . . . . .
2.1.4
Requesting the Creation of a
Trouble Ticket . . . . . . . . . . . . . . . . . . . . . . .
-2.1.5
Acknowledging an Alarm . . . . . . . . . . . . .
-2.1.6
Clearing an Alarm . . . . . . . . . . . . . . . . . . .
Historical Alarm Management Procedures . . . . . . . .
-2.2.1
Opening a Sublist . . . . . . . . . . . . . . . . . . .
2.2.2
Getting Detailed Information about
an Alarm . . . . . . . . . . . . . . . . . . . . . . . . . . .
-2.2.3
Exporting Archived Alarms . . . . . . . . . . . .
2.2.4
Saving Alarm Information into an
User File . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Advanced Features Procedures . . . . . . . . . . . . . . . . . .
-2.3.1
Changing the CAL Size . . . . . . . . . . . . . . .
-2.1.1

15
15
16
18
20
22

41
41
42
42
43
43
44
45
45
45
46
46
47
47

3 / 182

Contents

-2.3.2
-2.3.3
-3

Archiving Automatically Incoming Alarms


Acknowledging Incoming Alarms . . . . . .

47
48

Counter Summary Window . . . . . . . . . . . . . . . . . . . . . . . . . .

49

-3.1

-3.2

-3.3
-4

Sublist Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
-4.1

57
58
60
61
65
68
78
83
85
91
93
98
99
100
101
102
102
104
105

Alarm Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

107

-4.3
-4.4
-4.5
-4.6

-4.7
-5.1

-5.2

-5.3
-5.4
-5.5
-5.6

4 / 182

50
50
51
53
53
54
55

Creating a Sublist . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Modifying a Sublist . . . . . . . . . . . . . . . . . . . . . . . . . . . .
-4.2.1
Display Panel . . . . . . . . . . . . . . . . . . . . . . .
-4.2.2
Filter Panel . . . . . . . . . . . . . . . . . . . . . . . . . .
-4.2.3
Basic Sub-panel . . . . . . . . . . . . . . . . . . . .
-4.2.4
Source Sub-panel . . . . . . . . . . . . . . . . . . .
-4.2.5
Extended Sub-panel . . . . . . . . . . . . . . . . .
-4.2.6
Advanced Sub-panel . . . . . . . . . . . . . . . .
-4.2.7
Sort Panel . . . . . . . . . . . . . . . . . . . . . . . . . .
-4.2.8
Trigger Panel . . . . . . . . . . . . . . . . . . . . . . . .
Deleting a Sublist . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Activating/Deactivating a Sublist . . . . . . . . . . . . . . . . .
Enabling/Disabling a Counter . . . . . . . . . . . . . . . . . .
Visualizing (Opening) a Sublist . . . . . . . . . . . . . . . . . .
-4.6.1
Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . . .
-4.6.2
Alarm Table . . . . . . . . . . . . . . . . . . . . . . . . .
-4.6.3
Indicator Fields . . . . . . . . . . . . . . . . . . . . . .
Exiting Alarm Surveillance . . . . . . . . . . . . . . . . . . . . . .

-4.2

-5

Current Alarm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . . .
Sublist Table . . . . . . . . . . . . . . . . . . . . . . . .
Historical Alarm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
-3.2.1
Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . . .
-3.2.2
Sublist Table . . . . . . . . . . . . . . . . . . . . . . . .
Setting the Display of the Counter Summary Window
-3.1.1
-3.1.2

Selecting an alarm . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Selecting All the Alarms . . . . . . . . . . . . . .
Selecting a Single or a Group of Alarms
Reserving/Unreserving Alarms . . . . . . . . . . . . . . . . . .
-5.2.1
Reserving Alarms . . . . . . . . . . . . . . . . . . . .
-5.2.2
Unreserving Alarms . . . . . . . . . . . . . . . . . .
Creating a Trouble Ticket . . . . . . . . . . . . . . . . . . . . . . .
Acknowledging Alarms . . . . . . . . . . . . . . . . . . . . . . . .
Manually Purging an Alarm . . . . . . . . . . . . . . . . . . . .
Manually Clearing an Alarm . . . . . . . . . . . . . . . . . . . .
-5.1.1
-5.1.2

108
108
108
109
109
109
110
111
112
113

3AL 88876 AAAA Ed. 01

Contents

-5.7

Exporting and Printing (Output...) an Alarm . . . . . . .


Saving a Historical Alarm in a User File . . . . . . . . . .

115
118

Display Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

121

-5.8
-6

-6.1

Getting More Information about Alarms . . . . . . . . . .


Viewing Full Alarm Information . . . . . . . .
Viewing the Correlated Alarms . . . . . . . . . . . . . . . . . .
Visualizing the Hidden Columns . . . . . . . . . . . . . . . . .
Auto-selecting the Incoming Alarms . . . . . . . . . . . . .
Auto-scrolling the Incoming Alarms . . . . . . . . . . . . .

122
123
124
125
126
127

Alarm Surveillance Administration . . . . . . . . . . . . . . . . . . .

129

-6.2
-6.3
-6.4
-6.5
-7

-7.1

Setting the AS Administration Parameters . . . . . . . . .


CAL Administration Panel . . . . . . . . . . . . .
Archiving Filter Panel . . . . . . . . . . . . . . . . .
Auto-Purge Panel . . . . . . . . . . . . . . . . . . .
Auto-TT Panel . . . . . . . . . . . . . . . . . . . . . .
Auto-Ack Panel . . . . . . . . . . . . . . . . . . . . .
Resynchronizing AS . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Accessing the Alarm Aging . . . . . . . . . . . . . . . . . . . . .
-7.3.1
Creating a New Alarm Aging . . . . . . . . .
-7.3.2
Open the Aging View . . . . . . . . . . . . . . . .
-7.3.3
Definition Panel . . . . . . . . . . . . . . . . . . . . .
-7.3.4
Filter Panel . . . . . . . . . . . . . . . . . . . . . . . . . .
-7.3.5
Activate an Alarm Aging . . . . . . . . . . . . . .
-7.3.6
Deactivate an Alarm Aging . . . . . . . . . . .
-7.3.7
Delete an Alarm Aging . . . . . . . . . . . . . . .
-7.3.8
Alarm Aging List Menu Bar . . . . . . . . . . . .
Accessing the Script Triggering . . . . . . . . . . . . . . . . . .
-7.4.1
Creating a New Trigger . . . . . . . . . . . . . .
-7.4.2
Open the Trigger View . . . . . . . . . . . . . . .
-7.4.3
Definition Panel . . . . . . . . . . . . . . . . . . . . .
-7.4.4
Filter Panel . . . . . . . . . . . . . . . . . . . . . . . . . .
-7.4.5
Activate a Trigger . . . . . . . . . . . . . . . . . . . .
-7.4.6
Deactivate a Trigger . . . . . . . . . . . . . . . . . .
-7.4.7
Delete a Trigger . . . . . . . . . . . . . . . . . . . . .

130
131
137
138
138
139
140
141
143
143
144
145
146
146
147
147
149
151
151
152
154
155
156
156

Archived Alarm Retrieval . . . . . . . . . . . . . . . . . . . . . . . . . . . .

157

-7.2
-7.3

-7.4

-8

-8.1

159
164
165

Navigation Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

167

-8.3
-9.1

3AL 88876 AAAA Ed. 01

-7.1.1
-7.1.2
-7.1.3
-7.1.4
-7.1.5

Retrieving Archived Alarms from Public Archive . . . .


Retrieving Archived Alarms from User Files . . . . . . .
Removing User Files . . . . . . . . . . . . . . . . . . . . . . . . . . .

-8.2
-9

-6.1.1

Navigating to the Counter Summary . . . . . . . . . . . . .

168

5 / 182

Contents

-9.2

Navigating through the Sublists . . . . . . . . . . . . . . . . .


Getting Reports on Performed Actions . . . . . . . . . . . .
-9.3.1
Deleting a Report . . . . . . . . . . . . . . . . . . . .
-9.3.2
Clearing the Report List . . . . . . . . . . . . . . .
-9.3.3
Configuring the Report Display . . . . . . . .
Navigating between the CAL and the HAL . . . . . . . .
Sending Alarm Information towards an External
Application . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

169
170
174
174
174
175

Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

177

-9.3

-9.4
-9.5
-10

-10.1
-10.2

6 / 182

Abbreviations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

176
177
178

3AL 88876 AAAA Ed. 01

Contents

Figures
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

Figure
Figure
Figure
Figure
Figure
Figure

29
30
31
32
33
34

Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure

35
36
37
38
39
40
41
42

3AL 88876 AAAA Ed. 01

Telecommunication Network and Alarm Emission . . . . . . . . . .


Current and Historical Functions of the Alarm Surveillance . .
An Iterative Approach for Alarm Description . . . . . . . . . . . . . .
The Different Alarm Archives . . . . . . . . . . . . . . . . . . . . . . . . . . .
Advanced Features Mechanisms and Alarm Flow . . . . . . . . . .
Different Kinds of Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Different Kinds of Boxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Main Window Organization . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Additional Window Using a Folder . . . . . . . . . . . . . . . . . . . . . .
Additional Window using a Selection Tree . . . . . . . . . . . . . . . .
Dialog Window Organization . . . . . . . . . . . . . . . . . . . . . . . . . . .
Navigation Tree of the Alarm Surveillance USM . . . . . . . . . . .
Current Alarm Counter Summary Window . . . . . . . . . . . . . . . .
Historical Alarm Counter Summary Window . . . . . . . . . . . . . .
Display Pull-down Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Counter Summary Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Sublist Pull-down Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Sublist Name Chooser Dialog Box . . . . . . . . . . . . . . . . . . . . . . .
Just created Sublists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Sublist Properties Window: Display Panel . . . . . . . . . . . . . . . . .
Color Chooser Dialog Box with RGB/Color Names Options .
Color Chooser Dialog Box with HSV/Color Picker Options .
Filter Panel for Current Alarms . . . . . . . . . . . . . . . . . . . . . . . . . .
Filter Panel for Current Alarms: Basic Sub-panel . . . . . . . . . .
Filter Panel for Historical Alarms: Basic Sub-panel . . . . . . . .
Basic Sub-panel: Event Date & Time Ranges Area . . . . . . . .
Date Range Selection Dialog Box . . . . . . . . . . . . . . . . . . . . . . . .
Basic Sub-panel: Archiving Date & Time Ranges Area for
Historical Alarm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Basic Sub-panel: Status Group for Current Alarm . . . . . . . . .
Basic Sub-panel: Severity and Alarm Type Group . . . . . . . . .
Basic Sub-panel: Probable Cause Group . . . . . . . . . . . . . . . .
Probable Cause Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Basic Sub-panel: Correlation Group for Current Alarm . . . .
Basic Sub-panel: Insertion Cause Group for
Historical Alarm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Filter Panel: Source Sub-panel . . . . . . . . . . . . . . . . . . . . . . . . .
Source Sub-panel: Instance Group . . . . . . . . . . . . . . . . . . . . .
Source Sub-panel: MO Class Group . . . . . . . . . . . . . . . . . . . .
Managed Object Class Dialog Box . . . . . . . . . . . . . . . . . . . . . .
Filter Panel: Extended Sub-panel . . . . . . . . . . . . . . . . . . . . . . .
Filter Panel: Advanced Sub-panel . . . . . . . . . . . . . . . . . . . . . . .
Advanced Sub-panel: Alarm Source Name Group . . . . . . . .
Alarm Source Name Dialog Box . . . . . . . . . . . . . . . . . . . . . . . .

16
18
23
26
28
31
32
34
36
36
38
40
50
53
55
56
57
58
59
61
62
63
65
68
69
70
70
72
73
74
75
76
76
77
78
79
81
82
83
85
86
86

7 / 182

Contents

8 / 182

Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure

43
44
45
46
47
48
49
50

Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure

51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87

Advanced Sub-panel: Specific Problems Group . . . . . . . . . . .


Specific Problems Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . .
Advanced Sub-panel: TT and Rep Counter Group . . . . . . . .
Advanced Sub-panel: Exp. Status Group . . . . . . . . . . . . . . . .
Sublist Properties Window: Sort Panel . . . . . . . . . . . . . . . . . . .
Addition of a Dictionary Entry: Error Message . . . . . . . . . . . . .
Sublist Properties Window: Trigger Panel . . . . . . . . . . . . . . . . .
Sublist Properties Window: Trigger Panel with
Navigation Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Confirmation Window for Sublist Deletion . . . . . . . . . . . . . . . .
Current Alarm Sublist Window . . . . . . . . . . . . . . . . . . . . . . . . . .
Alarm Sublist Window Contextual Menu . . . . . . . . . . . . . . . . . .
Save USM Confirmation Dialog Box . . . . . . . . . . . . . . . . . . . . .
Exit USM Confirmation Dialog Box . . . . . . . . . . . . . . . . . . . . . .
Action Pull-down Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Confirmation Dialog Box for Manually Clearing an Alarm . .
Cleared Alarm Report Window . . . . . . . . . . . . . . . . . . . . . . . . .
Output Window: Default Aspect . . . . . . . . . . . . . . . . . . . . . . . . .
File Chooser Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
File Chooser Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Historical User File: Storage Progress Window . . . . . . . . . . . .
Display Pull-down Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
More Alarm Information Window: Identity Panel . . . . . . . . . . .
More Alarm Information Window: Navigation Area . . . . . . . .
Option Pull- down Menu for AS Administration . . . . . . . . . . .
IM Administration Window: CAL Administration Panel . . . . . .
CAL Administration Panel: Overflow Area . . . . . . . . . . . . . . . .
CAL Administration Panel: Purging Sort Criteria Area . . . . . .
CAL Administration Panel: Statistics Area . . . . . . . . . . . . . . . . .
IM Administration Window: Archiving Filter Panel . . . . . . . . . .
Confirmation Dialog Box for Resyndhronizing AS . . . . . . . . . .
Information Dialog Box During the AS Resynchronization . . .
Alarm Aging List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Aging Pull-down Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Alarm Aging Identification Window: Definition Panel . . . . . . .
Alarm Aging Identification Window: Filter Panel . . . . . . . . . . .
Alarm Aging List Window updated . . . . . . . . . . . . . . . . . . . . . .
Display Pull-down Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Inactive Alarm Aging List Window . . . . . . . . . . . . . . . . . . . . . . .
Navigation Pull-down Menu . . . . . . . . . . . . . . . . . . . . . . . . . . .
Trigger List Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Trigger Pull-down Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Trigger Identification Window: Definition Panel . . . . . . . . . . . .
Trigger Identification Window: Filter Panel . . . . . . . . . . . . . . . .
Trigger List Window updated . . . . . . . . . . . . . . . . . . . . . . . . . . .
Trigger List Window updated . . . . . . . . . . . . . . . . . . . . . . . . . . .

87
88
89
90
91
93
94
97
98
101
103
105
105
107
113
114
115
116
118
119
121
122
123
129
131
132
133
135
137
140
140
141
142
144
145
146
147
147
148
150
150
152
154
155
156

3AL 88876 AAAA Ed. 01

Contents

Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure
Figure

3AL 88876 AAAA Ed. 01

88
89
90
91
92
93
94
95
96
97

Archive Pull-down Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .


Main Filter : Public Archive Window . . . . . . . . . . . . . . . . . . . . .
Retrieval Operation: Appending or Overwriting . . . . . . . . . . .
Retrieval Operation: Confirming the Overwriting . . . . . . . . . .
Retrieval Operation: Filling Percentage Window . . . . . . . . . . .
Retrieval Operation: Error Dialog Box . . . . . . . . . . . . . . . . . . . .
User Source File: Retrieve Dialog Box . . . . . . . . . . . . . . . . . . . .
Navigation Pull-down Menu . . . . . . . . . . . . . . . . . . . . . . . . . . .
Report Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Pull-down Menus of the Report Window . . . . . . . . . . . . . . . . .

158
160
161
162
163
163
164
167
170
171

9 / 182

Contents

Tables
Table 1
Table 2

10 / 182

Mouse Action on the Sublist Table of the Counter Summary


Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Mouse Action on the Alarm Table of the Alarm Sublist
Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

3AL 88876 AAAA Ed. 01

Preface

Preface
History as internal document 3BP 21662 0012 TCZZA
Ed 01 on 02-11-18
creation for AS 6.5.0
Ed 02 on 03-09-30
Update for AS 6.5.1 P2

History as handbook part number 3AL 88876 AAAA (this handbook)


Ed 01 on 04-01-26 corresponding to internal document Ed 02

Legal Notice
Document Scope
Edition Scope
Target Audience

Alcatel is committed to the continuous improvement of ALMAP. The


information in this document is therefore subject to change without
prior notice.
This document is the user's guide of the Alarm Surveillance (AS)
application. It describes the different windows of the graphical
user interface and how to use them.
This document applies to the legacy part of AS 6.5.1 P2.
This document is aimed at any user working with AS: network
customer, network supervisor, casual operator...
This document does not deal with the AS administration.

3AL 88876 AAAA Ed. 01

11 / 182

Preface

Document Structure

This document is organized as follows:


"

1. Overview
Presents the Alarm Surveillance application, its functionalities
and the context it takes place into, together with the user
interface principles.

"

2. Getting Started
Describes how to quickly use the main features of AS.

"

3. Counter Summary Window


Describes the start-up window for current and historical
alarms.

"

4. Sublist Management
Explains how to manage the current or historical alarm
sublists and presents the general operations on sublists and
on alarms within their sublist properties.

"

5. Alarm Management
Presents the main actions to manage the alarms in the alarm
sublist window and explains how to save an historical alarm. It
explains also how to manage the Alarm Synthesis Information
symbols.

"

6. Display Management
Explains how to choose the way to display the alarm
information from the alarm sublist.

"

7. Alarm Surveillance Administration


Explains how to administer the current alarms and describes
the options of the Counter Summary window and their filters.

"

8. Archived Alarm Retrieval


Explains how to retrieve the historical alarms from the Counter
Summary window, and apply a main filter.

"

9. Navigation Features
Describes the navigation within the AS application and toward
external applications.

"

10. Terminology
Gives a list of abbreviations and the definitions of terms used
in this document.

12 / 182

3AL 88876 AAAA Ed. 01

Preface

Related Documents

Refer to the following sources for more information.


For factory use only.
Applicable Documents
"

Enabling Software Product Life Cycle,


8AY 02001 0014 ASZZA

"

Product Evolution Quality Assurance Plan,


8AY 02001 0057 QMZZA

Reference Documents
"

ALMAP 6 AS Feature Description,


3BP 21621 0004 DSZZA

"

ALMAP AS 6.5 Technical Requirement Specification,


3BP 21662 0003 DSZZA

"

ALMAP AS 6.5 Administration Guide,


3BP 21662 0025 PCZZA

"

X.733 Alarm Reporting Function,


ITU-T (CCITT) - Feb. 1992

"

Action Request System 5.0 Server Administrator's Guide


Remedy Corporation, AR-500-SVADG-01

"

ALMAP PNM 6.5 User's Guide,


3BP 21664 0012 TCZZA

"

ALMAP SEC 6.5 User's Guide Addendum,


3BP 21635 0006 PCZZA

Typographic The following typographic conventions are used in this document:


Conventions " Italics: names of windows, dialog boxes and areas
"

3AL 88876 AAAA Ed. 01

Bold italics: names of buttons, fields, menus, menu items and


menu paths

13 / 182

Preface

14 / 182

3AL 88876 AAAA Ed. 01

1 Overview

1 Overview
1.1

Alarm Surveillance Principles


The Alarm Surveillance (AS) is a generic component of the ALMAP
product. It provides efficient mechanisms to control, supervise and
manage equipment anomalies that may occur in a
Telecommunication Network.

1.1.1

Telecommunication Network Operation


Telecommunication Networks are usually composed of thousands
of heterogeneous resources (access, transmission, switch...) which
are linked to each other in order to communicate and achieve
high-level services to the network users like dispatching a TV
program or an usual phone call.
Because some elements in the network may happen to break
down, several mechanisms have been provided to the users in
charge of supervising the network, whenever such a failure occurs.
One of these mechanisms allows the resources which are trying to
use another disabled one to send a warning message into the
network. In such a case, the warning message is called an alarm,
and the mechanism is called alarm raising. These alarm messages
are collected and displayed on a supervision console. Therefore,
the network users are able to engage whatever action is necessary
to solve the raised problem. Once the disabled resource is
repaired, other resources may use it again. If the operation is
successfully achieved, all the resources send another message to
warn that the failure has been repaired. The message is still called
an alarm, but the mechanism here is called the alarm clearing.
The alarms that are sent into a Telecommunication Network are
potentially numerous since the number of elements that compose
the network is large. The users supervising the network need
efficient tools to detect, locate and take into account dysfunctions
in the network, and finally resume operation. The Alarm
Surveillance product is dedicated to this purpose.

3AL 88876 AAAA Ed. 01

15 / 182

1 Overview

NETWORK
Network User

Network User

available
resource

faulty
resource
Figure 1

1.1.2

resource
emitting
alarms

Telecommunication Network and Alarm Emission

Alarm Information
Alarms or Alarm notifications consist in messages emitted by
network resources that have detected problems or failures in the
network. Information contained in the alarm belongs to two
classes:
"
"

Resource Identification

16 / 182

Resource identification
Type identification.

Identifies the resource (Object instance) which has raised the


alarm. Basically these pieces of information are:
"

The resource type (Object class)

"

The resource name which has to be unique (Full distinguished


name) in order to avoid identification ambiguities. However,
because the manipulation of such unique ids is often heavy,
the resource usually happens to be also designed by a
user-friendly name which is locally unique (Friendly name).

3AL 88876 AAAA Ed. 01

1 Overview

Type Identification

Identifies the type of the problem the alarm refers to. The kind of
problem regroups three basic elements of information:
"

The problem type (Event type) taken out of the five following
ones:
D
D
D
D
D

Note

Quality of service
Communications
Processing error
Equipment
Environmental.

"

The probable cause of the problem, which is taken out of


either standard probable cause values (cf. ITU-T
Recommendation X.733), or locally defined values.

"

The severity level of the problem (Perceived severity) when the


alarm is raised. Malfunctions are ranked into five severity
levels:
D

Critical when it is no longer possible to provide the


service you have requested

Major

Minor

Warning which means no impact is reported upon the


quality of service offered to you

Indeterminate, if the severity level cannot be defined by


the resource which raises the alarm.

Note that a particular severity level (Cleared) is used when the


alarm is cleared by the resource which has raised it before.
Note that these pieces of information are mandatory in any alarm
notification, as well as the date and time the alarm has been
raised by the resource. Other optional information such as the
specific problems the alarm is linked to, the notification identifier...
may also be present to help you in the alarm management
process.

3AL 88876 AAAA Ed. 01

17 / 182

1 Overview

1.1.3

AS Functionalities
The AS application is dedicated to receive, store, display and
manage in real time alarms raised by different sources, here
called current alarms, facilitating the overall alarm surveillance of
the multi-vendor and multi-technology network, and improving
the reaction time of the network users in case of anomalies in the
network. It also provides the possibility to archive and retrieve the
alarms, then called historical alarms, allowing post-analysis of
anomalies in the network.
Figure 2 illustrates the use of the different branches of the Alarm
Surveillance application.

Real-Time Management

Static Analysis
AS User

AS User

print/export
alarms

print/export
alarms

Printer

Printer

Export Files

Export Files
display
alarms

CURRENT
ALARMS

raise & clear


alarms

display
alarms

manage
alarms

archive
alarms

ARCHIVED
ALARMS

Alarm
Surveillance

NETWORK
RESOURCES
Figure 2

18 / 182

Current and Historical Functions of the Alarm


Surveillance

3AL 88876 AAAA Ed. 01

1 Overview

Note

Historical alarms are not available with 1320 Craft Terminal.


They are only operative with Network Management.
Current and historical alarms are managed through a
user-friendly and powerful query interface. The way alarms are
handled is similar in both current and historical parts of the Alarm
Surveillance, so that you can go through real-time treatment or
long term analysis of the network problems without having to use
a new interface.
These alarms can be displayed in lists while alarm counters keep
track of statistics. By mouse clicking, you can get detailed alarm
information, or perform action on the alarm when the alarm is
raised.
In both cases, there is the possibility to export the displayed
alarms to either a printer or an ASCII file that may be used by
another application for dedicated analysis.

3AL 88876 AAAA Ed. 01

19 / 182

1 Overview

1.1.4

Current Alarm Management


A part of the Alarm Surveillance product is dedicated to the
real-time treatment of current alarms, i.e. the alarms which have
just been raised by a resource. This section will describe how to
supervises the network activity to interfere with the network in
order to take anomalies into account and solve them.

Raised Alarm

Displayed Alarm

When an alarm is raised by a faulty resource (or by a neighboring


one), it is received by the Alarm Surveillance which stores it and
warns you by a tone emission or by the appearance of a specific
icon on the screen. The alarm may be displayed as soon as it is
signalled according to your needs.
The alarm is displayed on the screen by you: basic information
(described in paragraph 1.1.2) is immediately available to the
user who can decide:
"

To get detailed information contained in the alarm

"

To reserve the alarm for further exclusive investigation. This


action of reservation on the alarm prevents other users to
perform any action on the alarm. It is reversible: a user can
unreserve a formerly-reserved alarm without damaging it.

"

To request the creation of a trouble ticket to be handled by the


external product ARS (Action Remedy System)

"

To acknowledge the alarm, indicating that the cause of the


alarm has been taken into account, and that repair actions
have been launched

"

To let other users take it into account.

During the whole period an alarm is considered to be current


(alive), its state is permanently real-time refreshed so that any
user who displays this alarm knows if it has been reserved or not,
if it has been acknowledged or not, if a trouble ticket has been
requested for this alarm or not...
On user's request, other pieces of information are also available,
such as the date and time these actions have been performed, or
the name of the user that performed each of them. Furthermore,
the user can attach a free text note to any of the current alarms.

20 / 182

3AL 88876 AAAA Ed. 01

1 Overview

Cleared Alarm

The alarm is cleared by the emitting resource as soon as the


problem is no longer present at the resource level. As soon as the
alarm is acknowledged by the user, it is no longer considered as a
current alarm. The alarm is removed from the current alarm set
and is archived into the set of historical alarms.
The problem the alarm is linked to may not be solved
immediately. In such a case the alarm is repeated until the
problem is solved. Alarm Surveillance associates a repetition
counter to each received alarm. Furthermore, if the alarm is not
cleared by the resource which raised it, then the Alarm
Surveillance offers the possibility to archive it manually on the
user's request.

Note

3AL 88876 AAAA Ed. 01

Note that a single anomaly in the network may cause the raising
of several alarms; it may also generate other anomalies or
disfunctioning that raise additional alarms. These alarms, called
correlated alarms, may be marked as linked to each other. The
user can be aware if an alarm has correlated alarms or not.

21 / 182

1 Overview

1.1.5

Historical Alarm Management


Note

Historical alarms are not available with 1320 Craft Terminal.


They are only operative with Network Management.
Once alarms are no longer considered as current alarms, they are
archived in the Historical Alarm section of the Alarm Surveillance
application, where they can be consulted.
A consultation of historical alarms is generally performed in four
steps:
Extracting the required alarm list from the repository or from
personal files. Because all alarms present in the repository may
not be relevant for the user analysis, the user is requested to
specify filtering criteria in order to extract only the useful part of
the alarms. These alarms are stored in a main alarm list. The
main alarm list is the base on which the user will work later on.
Creating sublists from the main alarm list. This operation
automatically generates counters based on the severity level, or on
the clearing or acknowledgement statuses of the alarms contained
in the sublist.
Opening the alarm sublists. The user can then get basic
information on the alarms of the sublist, including the date and
time the alarms have been archived and the reason of their
archiving.
Getting detailed information on a particular alarm.
The user can store a collection of selected alarms into a user file.
The user will then be allowed to access later again these alarms
from this file to pursue the analysis.
The historical part of the Alarm Surveillance is particularly useful to
follow the activity of a network, its robustness, the recurrence of
problems, or to help the user to dimension the network, detect its
critical points, etc.

1.1.6

An Iterative Approach for Alarm Description


The Alarm Surveillance offers three main windows for viewing the
alarms:
"
"
"

22 / 182

The Counter Summary window


The Alarm Sublist window
The More Alarm Information window

3AL 88876 AAAA Ed. 01

1 Overview

The Counter Summary


Window

The Alarm Sublist


Window

The More Alarm


Information Window

This is a main window used to display statistics on alarms. It shows


alarm counters, according to severity levels or statuses of the
alarms (critical, major, minor, warning, indeterminate, cleared,
acknowledged, incoming). In the counter summary, alarms may
be grouped according to filtering criteria in several sublists. For
each sublist, each of the counters may be shown or not.
The sublist is a basic working window. It regroups alarms
according to filtering criteria defined by you, and allows to work
on a limited subset of alarms. The sublist can also be sorted
according to criteria defined by you. It makes the management of
current alarms easier, and allows information classification before
a possible export to a file or a printer.
This window gives you the complete information contained in an
alarm (among a selection of alarms), which is particularly helpful
for locating and diagnosing the problem the alarm is linked to.
Figure 3 illustrates the principle of this iterative approach.

Alarm
s

Counter
Summary

Alarm Sublist

More Alarm
Information

sort

filter
increasing precision

actual network

global vision
1 summary,
n sublists
Figure 3

3AL 88876 AAAA Ed. 01

local vision
1 sublist,
n alarms

detailed vision
1 alarm

An Iterative Approach for Alarm Description

23 / 182

1 Overview

1.1.7

How AS Manages the Current Alarms


When working with current alarms the user interface is primarily
organized around:
"

The Counter Summary window which provides the global level


of information (see chapter 3)

"

One or several Alarm Sublist windows, each of them


providing a second level of information on a parametrized
subset of alarms, together with a set of possible commands
on these alarms

The application is installed with a configuration including some


default sublists. The user is expected to create new alarm sublists
according to his/her surveillance or analysis needs (see section
4.1). The creation of a new sublist is characterized by the
definition of its filter and by the setup of its sorting and display
characteristics.
The application allows to receive alarms raising from one or
several alarm agents.
The filter conditions the content of the sublist. For example, a filter
may be used to monitor alarms of a given resource or to restrict
the number of alarms to be looked at when analyzing a problem.
It is a logical expression that describes conditions on the presence
of alarm attributes or on their values. An alarm passes the filter if
all conditions expressed by the filter are fulfilled by the attributes
of the alarm. In that case, the alarm is added to the sublist. Since
an alarm may pass different filters, an alarm may belong to
several sublists.
The display and sort criteria do not involve the content of the
sublist but its visualization. For each sublist, the attributes of the
alarms to be displayed may be configured. In addition, alarms
may be listed according to a user-defined order. A sublist is also
given a name and is assigned an user-defined color.
When working with historical (archived) alarms, the user interface
is organized as with current alarm, except for the submap window
which is not present here.

24 / 182

3AL 88876 AAAA Ed. 01

1 Overview

1.1.8

How AS Manages the Historical Alarms


Note

Historical alarms are not available with 1320 Craft Terminal. They
are only operative with Network Management.
AS historical part allows to display archived alarms and to perform
actions on them. AS internally manages an archiving space called
the Historical Alarm List (HAL) containing former current alarms
that have been archived through one of the following processes
(at the additional condition they were matching the archiving
filter):
"

Auto-purging: such alarms have never been raised up to


the CAL.

"

Manual purging: an AS user has manually removed one or


more selected alarms from the CAL.

"

Overflow: an AS user can set overflow configuration (i.e. a


maximum size of the CAL, an overflow mode, an Overflow
Purge Size and Purging Sort Criteria). Refer to paragraph
7.1.1 for additional detail.

"

Acknowledging cleared alarms or clearing


acknowledged alarms: when normal synchronization
occurs, all alarms which were acknowledged and which are
not confirmed in the synchronization.

"

Synchronization: alarms that are not confirmed on a


synchronization command are automatically cleared by the
application. Among them, those which were previously
acknowledged are forwarded to the HAL.

"

AS IM modification: at start up, when an agent is no longer


in the agents list, all alarms from this agent.

"

Invalidation: alarms matching FDN, scope and class in case


of invalidate Alarm List.

Specifying filters, you can extract alarms from this archiving space
to visualize and process them.
The HAL is stored using a specific ad-hoc format, referenced
below as the Public Archive format. This repository receives all
alarms matching through the Archiving filter.
The content of this repository, as a list of alarms, is usually
identical over a short time period. The repository can be seen as a
redundancy method to improve the availability of the archiving
and retrieval functions of the AS application.
The application allows to retrieve archived alarms from several
public archive (local and external). By using a filter, called the

3AL 88876 AAAA Ed. 01

25 / 182

1 Overview

main (historical) filter, you build a list of alarms corresponding to


the subset of archived alarms you are interested in. This subset
constitutes the main (historical) alarm list.
In addition, you can store a set of alarms (built by selection in the
main list or in any sublist) into a user-defined file. You will then
be able to retrieve alarms from such a file instead of the public
archive, or in conjunction with this source.
As for current alarms, sublists can be created to provide limited
views on this main list by defining secondary filters.
When a retrieval is initiated, a dialog is used to let the user choose
between to append alarms to already retrieved one, or to replace
the content of the Main Alarm List.
Handling of sublists and general management of alarms within
the sublists (or within the main list) are performed according to the
same methods as in the current alarms case. Specific actions on
current alarms such as reservation, clearing... are not available
because they are meaningless in historical case, but obtaining of
detailed information or exportation are operated exactly in the
same way.
Figure 4 presents these different retrieval and storage capabilities.

Figure 4

26 / 182

The Different Alarm Archives

3AL 88876 AAAA Ed. 01

1 Overview

1.1.9

AS Advanced Features
Because the Current Alarm List (CAL) has a limited size, the user is
provided with several advanced features in order to solve capacity
overflow problems:
"

The user can adjust the CAL size, and indicates the filling
percentage starting from which a warning is emitted (see
paragraph 7.1.1). The maximum size value being itself
limited to a maximum value of 10000 current alarms. The
user can also specify the behavior of the CAL when the
overflow occurs (wrap/halt). In wrap mode, a mechanism of
purge will be automatically involved. The user specifies the
size of the purge (number of alarms) and the criteria to select
the alarms to be eliminated (these alarms are archived in the
historical list).

"

An automatic purge mechanism: according to filtering criteria,


some incoming alarms may be immediately archived, without
going through the current state, that is without being
displayed in the current alarms part of the Alarm Surveillance
(see paragraph 7.1.3).

Other features are provided:

3AL 88876 AAAA Ed. 01

"

An automatic acknowledgement mechanism: according to


filtering criteria, the user may decide to automatically
acknowledge some alarms when they enter the CAL (see
paragraph 7.1.5).

"

An automatic trouble ticket creation mechanism: according to


filtering criteria, the user is provided with a way to
automatically request the creation of trouble tickets to an
external ARS application when the alarms appear in the CAL
(see paragraph 7.1.4).

"

A selective archiving mechanism: according to a filtering


criteria, the user can prevent some alarms from being
archived in the historical list. By default, all the alarms are
foreseen to be archived. If this filter is changed, alarms which
are not archived are lost (see paragraph 7.1.2).

"

A synchronization mechanism: because the CAL, for any


reason, may happen to become inconsistent with the alarms
situation of the network, the user can provoke a
synchronization mechanism which performs a global
refreshment of the CAL checking all the resources involved
(see section 7.2).

27 / 182

1 Overview

"

An automatic tone emission mechanism: according to the


severity level of the incoming alarm, a tone may be
automatically emitted. This configuration can be customized
by each user (see paragraph 4.2.8).

"

A navigation mechanism: the user is provided with an


interface to another external application after selecting an
alarm to allow specific treatment on its data (see section 9.5).

Figure 5 illustrates the advanced features mechanisms.


Real-Time Management

Static Analysis

navigation

AS User

AS User

navigation

EXTERNAL
APPLICATION

navigation

sublist
ordering
and filtering
auto-beeping
auto-trouble
ticket creation
ARS

archiving
filter

sublist
ordering and
filtering
alarm retrieving

overflow purge
CURRENT
ALARMS

ARCHIVED
ALARMS

auto-acknowledgement filter
auto-purge filter

Alarm flow
Alarm ordering
Alarm filtering

NETWORK
RESOURCES
Figure 5

28 / 182

Advanced Features Mechanisms and Alarm Flow

3AL 88876 AAAA Ed. 01

1 Overview

1.2

User Interface Principles

1.2.1

HMI Overview
This section gives some general rules concerning the whole AS
user interface. It includes a general description of the different
kinds of windows that can be encountered through the
application.
Current and historical part of the Alarm Surveillance follow the
same design rules. This allows the user to use indifferently both
parts without any additional formation. These design rules aim to
get an interface that is:
"
"
"

Simple Interface

Interactive Interface

Personal Interface

1.2.2

Simple
Interactive
Personal.

All operation may be realized with a mouse click. Some


operations are accelerated by mouse double-click and drag and
drop. Operations may be disabled according to selections... Their
corresponding items then are greyed.
Dialogs are popped up before performing any unreversible
operations. Messages are systematically displayed on the screen to
inform the user of the state of the Alarm Surveillance. A contextual
help offers from any window a support to the user.
The user can easily customize colors, fonts and general layout of
the interface. This customization is saved while exiting the
interface. It is automatically retrieved while starting it again.

Using the Mouse


All actions are performed with the left button, but contextual
menus can be accessed by using the right button.
Quite generally, these actions are limited to simple click. They
sometimes include double-click. Drag and drop operations are
not used, except for moving columns in tables.
Combination of key pressing and mouse action is used in lists with
multiple selection. Shift + click allows to select a range of items,
Ctrl + click allows to add an item to an existing selection (or to
remove it). In this same context, selecting a range of items can
also be obtained by holding down the mouse button after pointing
the first item, moving toward the last one and releasing the button
on this element.

3AL 88876 AAAA Ed. 01

29 / 182

1 Overview

1.2.3

Menus, Buttons and Boxes


Menus

The menu bar, when it exists, is located at the top of the window,
just below the title.
A right arrow, when appearing at the right of a menu item,
indicates the presence of a popup sub-menu.
The ... mention, at the right of a menu item or of a button label
(for example Create...), means that additional information is
needed to perform the operation. This information will be
provided through a dialog box.
When a character appears underlined inside a menu item or a
button label, the combination of the Alt key and of the character
key provides a shortcut for executing the same command.
A grayed item means that the corresponding command is not
available, either because of a restriction of access rights, or
because the operation needs an operand, which has not yet been
selected.

30 / 182

3AL 88876 AAAA Ed. 01

1 Overview

Buttons
push button (or button)
check button (or checkbox)

radio button

option button (or popup list)


Figure 6

3AL 88876 AAAA Ed. 01

Different Kinds of Buttons

"

The push button, or more simply the button, is used to


perform an action.

"

The check button, or checkbox, sometimes used in a group,


enables a boolean state.

"

The radio buttons, always used in a group, figure exclusive


choices.

"

The option button, or popup list, allows the user to choose a


predefined item (see figure 6).

31 / 182

1 Overview

Boxes

list box (or list)

twin boxes

entry box
combo box
spin buttons
Figure 7

32 / 182

Different Kinds of Boxes

3AL 88876 AAAA Ed. 01

1 Overview

"

The list box, or more simply the list, is used to display sets of
generally non-predefined items and to select the item (simple
selection list ) or the items (multiple selection list) on which an
action will be performed.

"

The twin boxes are used to select and move one or several
attributes from a source list to a destination list:
The user can move one or several attributes from a source list
(e.g. Hidden Attributes list) to the destination list (e.g.
Displayed Attributes) by selecting the desired items and then
using the arrow buttons (left and right).
In each list multiple selection is available. To add a new
attribute to the selection, press the Ctrl key simultaneously to
the mouse click. To unselect an already selected attribute, use
again in the same way this Ctrl key. To add a whole block of
attributes, including all items between the end of the current
selection and the designated item, press the Shift key
together with the mouse button, or hold the button across the
desired block.
To control the position of insertion in the destination list, after
the selection of the desired item in the source list, operate as
follows:

"

To add at the end of the list, check there is no current


selection in this destination list (Displayed Attributes). If
there is one, click again on the selected item, while
pressing simultaneously the Ctrl key. Click afterwards on
the right arrow button.

To insert at the beginning or before an existing item of


the destination list (e.g. Displayed Attributes), i.e. to take
the ordinal position of an existing item, select first this
item in the destination list and then click the right arrow.
If, when pressing the arrow, there is a multiple selection
in the destination list, only the first item is used as position
reference.

The entry box is used to enter textual or alphanumeric data.


Also called text box, especially when it can accept multi-line
display or input.
The entry box may be in some cases (when it contains
numeric or date/time values) accompanied on its right by spin
buttons, two small down and up arrows which allow to
decrease or increase the value in the box.

"

3AL 88876 AAAA Ed. 01

The combo box which combines an option button and an


entry box is used here to manage dictionary entries.

33 / 182

1 Overview

1.2.4

Windows
The user interface is built with three kinds of windows:
"
"
"

Main Windows

Main windows
Additional windows
Dialog boxes

Main windows are primary windows. The user does not need to
close them before performing any other action. A possible
presentation of main windows is shown in figure 8.
WINDOW TITLE
MENU BAR

WORKING AREA

INFORMATION BOX

Figure 8

Main Window Organization

The Counter Summary and the Alarm Sublist windows belong to


this window category, and their functionalities are described in
detail later on.
Menus can only be encountered within these workspaces.
Such a window is made of:
"

34 / 182

A menu bar which allows the user to perform commands

3AL 88876 AAAA Ed. 01

1 Overview

"

A working area which contains a table of elements (sublists


or alarms).
The user can select with the mouse or the keyboard arrows
one or several elements in this table.
When needed, because of a limited size or of a large number
of elements, a scroll bar on the right allows to walk through
the complete list. Similarly, a scroll bar may appear at the
bottom of the table to make possible the visualization of the
complete set of columns.
The order of the attributes columns can be modified. To move
such a column, click the corresponding cell on the header line
and hold down. The contents of the column are displayed
with inverse video. Move the cursor toward the desired
position without leaving the header bar. The column follows
the movement and other columns are moved. When on the
right position, release the button.
The width of the columns can also be modified to adapt to
their contents or to allow a better visualization. To do so,
move the mouse cursor to the header line, at the right border
of the column the user want to widen or to narrow. The aspect
of the cursor changes to a horizontal double arrow. Click,
hold down. A thin vertical line appears. Move right or left until
the user reachs the desired width and release. The table
display is then updated.

"

3AL 88876 AAAA Ed. 01

An information box which gives the user general real-time


refreshed information or error messages, and, in the
bottom-right corner, the number of elements of the table.
The user cannot perform any action in the information box.

35 / 182

1 Overview

Additional Windows

These additional windows are also primary windows. The user


does not need to close them before performing any other action.
They are used for displaying general information on alarms and
sublist properties. Their content is refreshed according to user's
selection.
The possible presentations of additional windows are shown in the
following figures 9 and 10:

Window Title

Folder

Working area(s)

Reset

Apply

Figure 9

Close

Help

Button area

Additional Window Using a Folder


Window Title

Selection
Tree area

Apply

Figure 10

36 / 182

Working
area(s)

Reset

Close

Help

Button area

Additional Window using a Selection Tree

"

The Folder includes several panels (or Working areas, figure


9). Each of them allows the user to perform commands.

"

The Selection Tree area (figure 10) regroups the different


panels and allows the user to select one of them.

"

The Working area allows the user to display information on


alarms or sublists refreshed. This area is occupied by the
widgets belonging to the selected panel. These widgets vary
with the panel and some of them may be grayed in specific
contexts.

3AL 88876 AAAA Ed. 01

1 Overview

"

The Button area, at the bottom of the window, is shared


between the different panels and allows the user to take
modifications into account or not. The available buttons are:
D

Apply: the modifications operated in all the panels are


saved. Then the window is closed.

Reset: the window is not closed but the modifications


operated in the current panel are lost. The initial state of
this panel is restored. Other panels are left unchanged.

Close: the window is closed without any storing. Any


modifications operated in any panel and not saved
through the previous use of Apply are lost.

Help: causes the display of the on-line help window.

In some other windows, especially those with only one panel,


Close may be replaced by Cancel, with a similar operation.
However, in these cases, Apply causes the window to close
after saving the user input.
Property, Administration and More Info windows belong to this
category of windows.

3AL 88876 AAAA Ed. 01

37 / 182

1 Overview

Dialog Boxes

To display some messages, especially errors, or to ask for


confirmation before performing some actions such as deletions,
the system uses small modal windows. The user must take the
dialog into account and close the window before any other action
on the application.
A possible presentation of such a window is shown in figure 11.
Window Title
Dialog area
Ok

Figure 11

Cancel

Help

Button area

Dialog Window Organization

The central area is read-only. The user can perform any action
on it.
For a simple information or error message, the button bar will
only include a Ok button to acknowledge the message.
For a confirmation, the button bar will include Ok and Cancel,
and sometimes Help.
Output, Tone Configuration and basic dialog windows belong to
this category of windows. Their functionalities are described in
detail later on.

38 / 182

3AL 88876 AAAA Ed. 01

1 Overview

1.2.5

On-line Help
An on-line help is provided by the application. The user can
access this help:
"

"

3AL 88876 AAAA Ed. 01

by opening the Help popup menu from the menu bar in any
workspace window, and then selecting one of the following
options:
D

On Version: the current AS version and related


information are displayed.

On Help: a window opens, which describes the help


facilities and the methods of navigation within the help
contents.

On Window: a windows opens, providing an


explanation about the current window.

Index: a window opens, which presents an introduction


page, and then proposes links toward the various parts of
the help.

Glossary: a window opens, which presents a list of


important terms together with the related definitions.

By pushing the Help button available in most dialog boxes.


This method gives access to same contents that the On
Window menu option. In that case, the help window opens
on a page which directly relates to the current dialog box
function and way of operation.

39 / 182

1 Overview

1.3

Alarm Surveillance USM Navigation Tree


Figure 12 introduces the navigation facilities within the Alarm
Surveillance USM.
The rectangles represent the windows of the user interface, the
arrows give the links between these windows.
HAL

(Archive / Retrieve from


Public Archive)

HAL

(Archive / Retrieve from


User File)

(Sublist / Modify)

MAIN FILTER
PUBLIC ARCHIVE
USER SOURCE FILE
RETRIEVE

SUBLIST
PROPERTIES

(Display)

COLOR
CHOOSER

(Sublist / Modify)
(Action / Output)
(Sublist / Open)

COUNTER
SUMMARY

(Navigation / Sublist)

OUTPUT

ALARM
SUBLIST

HAL

FILE

(Action / Save As)

CHOOSER

(Display / More Info)

MORE ALARM
INFORMATION

CAL

(Navigation / Report)

REPORT

(Option / Administration)
IM ADMINISTRATION

CAL

CAL

CAL

(Option / Aging List)

ALARM AGING LIST

Alarm Aging
Identification

TRIGGER LIST

Trigger
Identification

(Option / Trigger List)

(Option / Map Property)

Map
Administration

(Navigation / Report)
REPORT

Figure 12

40 / 182

Navigation Tree of the Alarm Surveillance USM

3AL 88876 AAAA Ed. 01

2 Getting Started

2 Getting Started
This chapter allows you to quickly use the main features of AS, by
means of instructions in form of procedures.
To get more information about windows, dialog boxes and menus
as those mentioned in these procedures, refer to chapter 3 to 9.
These procedures are organized into three parts:
"
"
"

2.1

Current alarm management (see section 2.1)


Historical alarm management (see section 2.2)
Advanced feature management (see section 2.3).

Current Alarm Management Procedures


The main procedures allowing you to manage the current alarms
are as follows:
"
"
"
"
"
"

2.1.1

Opening a sublist (see paragraph 2.1.1)


Getting detailed information about an alarm (see paragraph
2.1.2)
Reserving an alarm (see paragraph 2.1.3)
Requesting the creation of a Trouble Ticket (see paragraph
2.1.4)
Acknowledging an alarm (see paragraph 2.1.5)
Clearing an alarm (see paragraph 2.1.6).

Opening a Sublist
Counter Summary only displays global information. To get more
information, it is necessary to open the sublist.
"

In the current alarm Counter Summary window:


D

either double click on the sublist to be open

or click on the sublist to be open, then use the menu


path:
Sublist -> Open

A Current Alarm Sublist window opens.


For more detailed information about:
"
"
"
"

3AL 88876 AAAA Ed. 01

This feature, see section 4.6


The current alarm Counter Summary window, see chapter 3
The Sublist pull-down menu, see chapter 4
The Current Alarm Sublist window, see section 4.6.

41 / 182

2 Getting Started

2.1.2

Getting Detailed Information about an Alarm


Once a sublist is open and its alarms displayed, you can get the
full information about one or several alarms. To do so:
"

In the Alarm Sublist window:


D

either double click on the alarm

or click on the alarm, then use the menu path:


Display -> More Info...

A More Alarm Information window opens.


For more detailed information about:
"
"
"
"

2.1.3

This feature, see section 6.1


The Alarm Sublist window, see section 4.6
The Display pull-down menu, see chapter 6
The More Alarm Information window, see section 6.1.

Reserving an Alarm
To ensure to be the only responsible for an alarm (or a group of
alarms), you can perform the reservation action on alarm(s).
"

In the Alarm Sublist window, select an alarm.

"

Use the menu path:


Action -> Reserve
The status of the selected alarm(s) changes in the Reservation
Status column, passing from NRSV (non-reserved) to RSV
(reserved).

For more detailed information about:


"
"
"
"

42 / 182

This feature, see section 5.2


The Alarm Sublist window, see section 4.6
The Action pull-down menu, see chapter 5
The Reservation Status, see section 4.2.3.

3AL 88876 AAAA Ed. 01

2 Getting Started

2.1.4

Requesting the Creation of a Trouble Ticket


A Trouble Ticket is a collection of all kind of information about a
specific problem.
"

In the Alarm Sublist window, select an alarm.

"

Use the menu path:


Action -> Trouble Ticket...
A confirmation is required before effectively sending the
request.
The flag(s) corresponding to the selected alarm(s) changes in
the Trouble Ticket Creation Flag column, passing from NO to
YES.

For more detailed information about:


"
"
"
"

2.1.5

This feature, see section 5.3


The Alarm Sublist window, see section 4.6
The Action pull-down menu, see chapter 5
The Creation Flag, see section 4.2.6.

Acknowledging an Alarm
To acknowledge a single or a group of selected alarms:
"

In the Alarm Sublist window, select an alarm.

"

Use the menu path:


Action -> Acknowledge
A confirmation is required.
The status of the selected alarm(s) changes in the Ack. Status
column, passing from NACK (non acknowledged) to ACK
(acknowledged).

For more detailed information about:


"
"
"
"

3AL 88876 AAAA Ed. 01

This feature, see section 5.4


The Alarm Sublist window, see section 4.6
The Action pull-down menu, see chapter 5
The Ack. Status, see section 4.2.3.

43 / 182

2 Getting Started

2.1.6

Clearing an Alarm
To manually clear one or several alarm(s):
"

In the Alarm Sublist window, select an alarm.

"

Use the menu path:


Action -> Manual Clear...

"

In the Question dialog box that opens, click on the Yes push
button.
The Report window opens.

For more detailed information about:


"
"
"
"

44 / 182

This feature, see section 5.6


The Alarm Sublist window, see section 4.6
The Action pull-down menu, see chapter 5
The Report window, see section 5.6.

3AL 88876 AAAA Ed. 01

2 Getting Started

2.2

Historical Alarm Management Procedures


Note

Historical alarms are not available with 1320 Craft Terminal. They
are only operative with Network Management.
The main procedures allowing you to manage the historical
alarms are as follows:
"
"
"
"

2.2.1

Opening a sublist (see paragraph 2.2.1)


Getting detailed information about an alarm (see paragraph
2.2.2)
Exporting archived alarms (see paragraph 2.2.3)
Saving alarm information into an user file (see paragraph
2.2.4).

Opening a Sublist
"

In the historical alarm Counter Summary window:


D

either double click on the sublist to be open

or click on the sublist to be open, then use the menu


path:
Sublist -> Open

The historical Alarm Sublist window opens.


For more detailed information about:
"
"
"
"

2.2.2

This feature, see section 4.6


The historical alarm Counter Summary window, see section
3.1
The Sublist pull-down menu, see chapter 4
The historical Alarm Sublist window, see section 4.6.

Getting Detailed Information about an Alarm


"

In the Historical Alarm Sublist window:


D

either double click on the alarm

or click on the alarm, then use the menu path:


Display -> More Info

The More Alarm Information window opens.

3AL 88876 AAAA Ed. 01

45 / 182

2 Getting Started

For more detailed information about:


"
"
"
"

2.2.3

This feature, see section 6.1


The Historical Alarm Sublist window, see section 4.6
The Display pull-down menu, see chapter 6
The More Alarm Information window, see section 6.1.

Exporting Archived Alarms


The content of a sublist can be exported to a file or sent to a
printer as well as the content of a single alarm:
"

In the historical Alarm Sublist window, select an alarm.

"

Use the menu path:


Action -> Output...
Fill the Output dialog box that opens with the desired
parameters.

For more detailed information about:


"
"
"
"

2.2.4

This feature, see section 5.7


The historical Alarm Sublist window, see section 4.6
The Action pull-down menu, see chapter 5
The Output dialog box, see section 5.7.

Saving Alarm Information into an User File


You can store into an user file a set of alarms displayed in any of
the sublists. To do so:
"

In the historical Alarm Sublist window, select an alarm.

"

Use the menu path:


Action -> Save As...
The File Chooser dialog box opens, which allows you to
specify a file name.

For more detailed information about:


"
"
"
"

46 / 182

This feature, see section 5.8


The historical Alarm Sublist window, see section 4.6
The Action pull-down menu, see chapter 5
The File Chooser dialog box, see section 5.8.

3AL 88876 AAAA Ed. 01

2 Getting Started

2.3

Advanced Features Procedures


The main procedures allowing you to perform advanced features
are as follows:
"
"
"

2.3.1

Changing the CAL size (see paragraph 2.3.1)


Archiving automatically incoming alarms (see paragraph
2.3.2)
Acknowledging incoming alarms (see paragraph 2.3.3).

Changing the CAL Size


"

In the Counter Summary window, use the menu path:


Option -> Administration
The CAL Administration window opens.

For more detailed information about:


"
"
"
"

2.3.2

This feature, see section 7.1


The Counter Summary window, see section 3
The Option pull-down menu, see chapter 7
The CAL Administration window, see section 7.1.1.

Archiving Automatically Incoming Alarms


When alarms are removed from the CAL, they are tested against
the Archiving Filter. If matching this filter, alarms are archived.
"

In the Archiving Filter window, set the appropriate archiving


filter.
The default configuration of this filter is Match All. That
causes every alarm removed from the CAL to be effectively
archived.

For more detailed information about this feature or the Archiving


Filter window, see section 7.1.2.

3AL 88876 AAAA Ed. 01

47 / 182

2 Getting Started

2.3.3

Acknowledging Incoming Alarms


Automatic acknowledgment is useful when you want systematic
acknowledgement of some alarms, on their incoming, but prefers
to avoid manual acknowledgement.
"

In the Filter panel, set the appropriate filter.


The default configuration of this filter is Match None, which
means that an incoming alarm is never automatically
acknowledged.

For more detailed information about:


"
"

48 / 182

This feature, see section 7.1.5


The Filter panel, see section 4.2.2.

3AL 88876 AAAA Ed. 01

3 Counter Summary Window

3 Counter Summary Window


The Counter Summary window is a start-up window for:
"
"

Current Alarm management (see section 3.1)


Historical Alarm management (see section 3.2).

The Counter Summary window includes four parts:


"
"
"
"

3AL 88876 AAAA Ed. 01

At the top of the window: a menu bar (see section 3.1.1 or


3.2.1)
In the middle of the window: a sublist table (see section 3.1.2
or 3.2.2)
At the bottom left of the window: an information box in which
every action you choose in the menu bar briefly appears
At the bottom right of the window: an indicator field (used
only in the current alarm Counter Summary window) that
displays the corresponding AS IM name and the color of the
CAL status. This color is real-time updated. Overflow
parameters are configurable (see paragraph 7.1.1).

49 / 182

3 Counter Summary Window

3.1

Current Alarm
On start-up of AS current alarm management, the Counter
Summary window appears like in figure 13.

Figure 13

Current Alarm Counter Summary Window

This window provides the user with all the available sublists
informing the user about the status of the network in term of
alarm.

3.1.1

Menu Bar
The menu bar includes the following pull-down menus:

50 / 182

"

Sublist: to manage the sublists (see chapter 4)

"

Display: to choose the view with or without details of the


Counter Summary window (see section 3.3)

"

Option: to set AS features (see chapter 7)

"

Navigation: to navigate within and out of AS (see chapter 9)

"

Help: to get the on-line help (see paragraph 1.2.5)

3AL 88876 AAAA Ed. 01

3 Counter Summary Window

3.1.2

Sublist Table
The sublists are updated according to the flow of incoming
alarms. When a new alarm arrives, filter matching is done for
each sublist. If the test is successful for a given sublist, the alarm is
added to this sublist, according to its displaying and sort criteria.
The default set of the sublist table is composed of:

Note

"

The Main Alarm List that contains all the available alarms. It
is a special sublist whose filtering properties cannot be
changed (filtering panel is insensitive).

"

The Default Alarm Sublist that plays a specific role for


creating new sublists (see section 4.1)

"

The Critical (resp. major, minor, warning, indeterminate)


sublist that contains the subset of alarms whose severity is
critical (resp. major, minor, warning, indeterminate)

"

The Cleared alarm sublist that contains the subset of alarms


which have been cleared.

On start-up of AS, the active sublists are immediately initialized


according to the network status.
The Counter Summary window displays the following information:
"

The danger flag on the left of the sublist name, informs you
that new incoming alarms have appeared in the sublist (i.e.
no danger flag will appear in sublists which only contain
already present alarms, such as the cleared alarm sublist). If
the user selects (i.e. single click) or opens (i.e. double click)
the sublist, then this flag disappears (until new incoming
alarms are risen).

"

Inactive sublists have all their counters set to X.

"

The "." character in the Total column means there is no alarm


in the corresponding field.

Table 1 synthesizes the actions you can undertake by using the


mouse.

3AL 88876 AAAA Ed. 01

51 / 182

3 Counter Summary Window

Table 1

Mouse Action on the Sublist Table of the Counter Summary Window

Location

Action

Click

Double Click

Drag & Drop

Move column (2)

Unselected

Select sublist

Move sublist line

Single selection

Unselect sublist

Open the
SINGLE pointed
sublist
-

Column Titles
Sublist Line

Multiple selection (1)

(3)

(1) Multiple selection is not allowed in the Counter Summary.


(2) Drag & Drop on the left or right edge of column title resizes the width of the

row.
(3) Drag & Drop on the bottom or high edge of the 1.st column of any rows
resizes the height of all rows.

52 / 182

3AL 88876 AAAA Ed. 01

3 Counter Summary Window

3.2

Historical Alarm
On start-up of AS historical alarm management, the Counter
Summary window appears like in figure 14:

Figure 14

Historical Alarm Counter Summary Window

The Counter Summary window, as in the CAL case, presents global


information made up of severity level counters about the different
existing sublists.

3.2.1

Menu Bar
The menu bar includes the following pull-down menus:

3AL 88876 AAAA Ed. 01

"

Sublist: to manage the sublists (see chapter 4)

"

Display: to choose the view with or without details of the


Counter Summary window (see section 3.3)

"

Archive alarms (see chapter 8)

"

Navigation: to navigate within and out of AS (see chapter 9)

"

Help: to get the on-line help (see section 1.2.5).

53 / 182

3 Counter Summary Window

3.2.2

Sublist Table
Before any action, this window only displays two empty lists in the
sublist table: the Main Alarm List and the Default Alarm
Sublist.
To initiate a work session:

54 / 182

"

Build a Main (historical) Alarm List by specifying one or


several (by successive elementary operations) archive sources
and configuring the filter to be applied for retrieval

"

Create or adapt the Default Alarm Sublist according to your


needs.

3AL 88876 AAAA Ed. 01

3 Counter Summary Window

3.3

Setting the Display of the Counter Summary


Window
To set the display of a Counter Summary, click on the Display
pull-down menu. Depending on the context - current alarms
(see section 3.1) or historical alarm (see section 3.2) - the
Display pull-down menu is different (see figure 15).
Current Alarm
Display
Inactive Sublists
Severity Counters
Auto-Raise

Figure 15

Historical Alarm
Display
Inactive Sublists
Severity Counters

Display Pull-down Menu

The Display pull-down menu includes the following options:


"

Inactive Sublists: if this option is activated, the user can see


the inactive sublists (see figure 16).

"

Severity Counters: if this option is activated, each line


representing a sublist displays in addition:
D
D
D

The number of alarms for each severity level


The number of cleared alarms
The number of non-acknowledged alarms.

These counters may be real-time refreshed (when the sublist


is active) or not (when the sublist is inactive) according to your
needs.
"

3AL 88876 AAAA Ed. 01

Auto-Raise: for current alarms, if this option is activated, the


Counter Summary window will be reactivated by incoming
alarms and the sublist will be automatically updated.

55 / 182

3 Counter Summary Window

Figure 16

56 / 182

Counter Summary Window

3AL 88876 AAAA Ed. 01

4 Sublist Management

4 Sublist Management
To manage the sublists in the Counter Summary window (see
chapter 3), click on the Sublist pull-down menu.
Depending on the context - current alarms (see section 3.1) or
historical alarms (see section 3.2) - the Sublist pull-down menu
is different (see figure 17).
Note

Historical alarms are not available with 1320 Craft Terminal.


They are only operative with Network Management.

Current Alarm

Historical Alarm

Sublist

Sublist

Create
Modify...
Delete...
Activate
Deactivate
Open
Close
Save
Exit

Create
Modify...
Delete...
Enable Counter
Disable Counter
Open
Close
Save
Exit

Figure 17

Sublist Pull-down Menu

By using the Sublist menu, you can:

3AL 88876 AAAA Ed. 01

"

Create a sublist (see section 4.1)

"

Modify a sublist (see section 4.2)

"

Delete a sublist (see section 4.3)

"

Activate or Deactivate a current alarm sublist (see section


4.4)

"

Enable or Disable Counter of an historical alarm sublist (see


section 4.5)

"

Open (Visualize) a sublist (see section 4.6)

"

Close a sublist

"

Save a sublist (see section 4.7)

"

Exit from the current window

57 / 182

4 Sublist Management

4.1

Creating a Sublist
To set up a new sublist, you must define its characteristics, (i.e. its
filter, the list of attributes to display for the matching alarms, the
sort criteria to be applied, the color to be assigned). To ease this
process, you can create a sublist from an already existing sublist
(cloning mechanism) then change the parameters as needed.
To create a sublist:
"

Note

In the sublist table of the Counter Summary window, click on


the sublist from which you want to create a sublist.

Do not select a sublist if you want to use the Default Alarm


Sublist, whose goal is to store a common initial definition.
"

Use the menu path:


Sublist -> Create
The Sublist Name Chooser dialog box opens (see figure18).

Figure 18

Sublist Name Chooser Dialog Box

If a sublist is selected, the entry box contains the


corresponding name (which is selected). Thus you can modify
easily the name. If no sublist or the default one is selected, the
entry box is empty, and you can write the sublist name.
"

Click on the Ok push button to confirm the creation


operation, otherwise click on the Cancel push button.
If the entry box remains empty, an error box is displayed. If
the written name already exists, a warning box appears.

The Counter Summary window is updated and a new sublist is


displayed. In figure 19, the my sublist sublist has been created by
cloning from the Default Alarm Sublist and the ne sublist from
the Main Alarm List.

58 / 182

3AL 88876 AAAA Ed. 01

4 Sublist Management

Figure 19

Just created Sublists

At this moment, the new sublists have exactly the same


characteristics as their source. As a consequence, the new sublists
has exactly the same content as the original ones.
The next operation is generally the modification of a new sublist to
adjust its parameters (see section 4.2).

3AL 88876 AAAA Ed. 01

59 / 182

4 Sublist Management

4.2

Modifying a Sublist
The following characteristics of a sublist can be modified:

Note

"

Name

"

Assigned color

"

Level of information to be displayed for each alarm, through


a list of attributes

"

Filter which specifies the content of the sublist (matching


alarms)

"

Sort criteria used to determine the order in which alarms will


be displayed

"

Tone emission on incoming alarms (only for current alarms)

"

Scripts triggered when the number of alarms becomes greater


or smaller than customized values (only for current alarms).

The modification process is the same for current or historical


alarms, except if notified.
To modify a sublist:
"

In the Counter Summary window, use the menu path:


Sublist -> Modify
The Sublist Properties window opens (see figure 20). It
contains three or four panels:

"

In the Sublist Properties tree area, select one of the following


panels from which you can modify the sublist:
D
D
D
D

Display (see paragraph 4.2.1)


Filter (see paragraph 4.2.2)
Sort (see paragraph 4.2.7)
Trigger (only for current alarm, see paragraph 4.2.8).

"

After modifying the sublist properties, click on the Apply push


button to save the modifications.

"

Click on the Close push button to close the Sublist Properties


window.

Modifying an open sublist (i.e. a sublist whose content is displayed


in an alarm sublist window - see section 4.6) and clicking on the
Apply push button will cause this window to be immediately
actualized, according to the changes performed.

60 / 182

3AL 88876 AAAA Ed. 01

4 Sublist Management

4.2.1

Display Panel

Figure 20

Sublist Properties Window: Display Panel

By using the Display panel (see figure 20), you can change:
"
"
"

The sublist name


The sublist counter color
the attributes displayed in the alarm table.

These parameters do not modify the content of the sublist but


change the display according to your preferences.

Modifying the Sublist To modify the sublist name, click in the Sublist Name field and
Name replace the existing name. The size must be less than or equal to
32 characters.

3AL 88876 AAAA Ed. 01

61 / 182

4 Sublist Management

Modifying the Sublist


Counter Color

The sublist counter color is used to display the sublist line within
the sublist table of the Counter Summary window. For example, by
default, critical alarm sublist appears in red color.
To change this color, click on the large button labeled with the
sublist name.
The Color Chooser dialog box (figure 21 or figure 22) opens:

Figure 21

62 / 182

Color Chooser Dialog Box with RGB/Color Names


Options

3AL 88876 AAAA Ed. 01

4 Sublist Management

Figure 22

Color Chooser Dialog Box with HSV/Color Picker


Options

In the left part, three slider bars with cursors allows the user to
precisely adjust the color.
Above these slider bars, an option button offers two color models:
"

RGB (Red, Green and Blue) which is based on proportions of


primary colors (see figure 21)

"

HSV (Hue-Saturation-Value, see figure 22).

The numeric values corresponding to the position of the cursors


are displayed below each slider bar.

3AL 88876 AAAA Ed. 01

63 / 182

4 Sublist Management

In the right part of the dialog box, according to the status of the
option button, a list of color names (see figure 21) or a palette of
color picture (see figure 22) is displayed:
"

In Color names mode, simply select the desired option in the


list.

"

In Color picker mode, the color is defined by two


complementary data:
D
D

A point on the disk


The cursor position on the horizontal bar.

Move the H, S and V sliding bars to adjust the color.


In every modes, the selected definition is shown in the rectangular
area at the right bottom of the dialog box (see figure 21 or 22).
Click on the Ok push button to validate the modification.

Modifying the Attribute Displayed attributes are the alarm atrributes that appear in the
Display alarm table when the sublist is open (see section 4.6). The Display
panel (see figure 20) includes two lists:

"
"

One for the hidden attributes, not to be displayed in the


alarm table
One for the displayed attributes.

It is possible to move one or several attributes from a list to the


other one by selecting the desired items and then using the arrow
buttons.
In the second list (Displayed Attributes), the order of items also
represents the order of the corresponding columns in the sublist
table.
Note

64 / 182

The set of possible attributes depends on the context. The lists are
different in current alarms and historical alarms cases, but the
user interaction is identical.

3AL 88876 AAAA Ed. 01

4 Sublist Management

4.2.2

Filter Panel
The filter of a sublist is the criterion that determines the content of
the sublist. It is different from the display and sort criteria, that do
not affect this content.
The filter allows to store in a given sublist, alarms with common
properties (values of an attribute), matching some user defined
criteria. Filters can be saved for later use.
The Filter panel of the Sublist Properties window has the following
aspect (figure 23):

Figure 23

Filter Panel for Current Alarms

In addition to its usage for the definition of the filters associated to


sublists, this panel is also used to define the Main Filter applied
during a retrieval operation. In that case, it is loaded after the
selection of the source.

3AL 88876 AAAA Ed. 01

65 / 182

4 Sublist Management

For the historical alarm management, the Filter panel has no


Trigger sub-panel (see figure 25).

Filter Name Group

The Filter Name group is placed at the top of the Filter panel (see
figure 23):
This group provides a list of filters previously prepared. In this
group, filters can be created, modified or removed. Clicking on
the drop down button shows the pull-down list containing the
existing filter names. Clicking on one of them selects it and loads
the various elementary criteria in the different other fields of the
panel.
The Not check button selection allows you to use or not this
attribute in the filter. If it is selected, the filter will consist in an NOT
condition on the global attributes.

Note

A filter is a logical expression defined as following:


"

Filter :: attribute_expr_1 AND ... AND attribute_expr_n

"

Attribute_expr_i :: (attribute_i, operator, value1) OR


(attribute_i, operator, value2) OR ...

Each attribute_expr_i deals with only one specific alarm attribute


(e.g. severity) and allows to define a filter to select alarms having
one or several given values of certain attribute (e.g. severity =
critical or severity = major).
The NOT operator is usable to define filtering criterion. A filter is
now defined as following:
"

Filter :: [NOT] Filter1 ...

"

Filter1 :: [NOT] attribute_expr_1 AND ... AND [NOT]


attribute_expr_n

The NOT operator may be used (or not) for each individual
attribute_expr_i
For example, the following filter may be defined: severity = critical
AND NOT probable cause = fireDetected.

66 / 182

3AL 88876 AAAA Ed. 01

4 Sublist Management

The matching status area is between the Not check button and the
Save push button. It indicates if the alarms could match this filter.
One of the following three statuses may appear:
"

Match None: no alarm could match the filter. In this case,


there may be conflicting options specified in the filter.

"

Match Some: some alarms may match the filter.

"

Match All: all alarms will match the filter. This means in
particular that a sublist characterized by this type of filter will
extract all alarms of the main list (in both current and
historical case).

To create a new filter in the Filter Name group, fill the field with
any authorized name. Authorized names are names containing
letters (case independent), numbers, and the three -, _, and .
characters. Size of a name should not exceed 32 characters.
Clicking on the Save push button will take into account every
element of the Filter Panel. Therefore this must be done after
having performed the modifications on the other elements of the
panel.
Note

Filter Sub-panels

This panel is not accessible (greyed) when modifying the


properties of the Main Alarm Sublist.
As shown in the selection tree area of the Sublist Properties
window (see figure 23), the Filter panel contains also the four
following sub-panels:
"
"
"
"

Basic sub-panel (see paragraph 4.2.3)


Source sub-panel (see paragraph 4.2.4)
Extended sub-panel (see paragraph 4.2.5)
Advanced sub-panel (see paragraph 4.2.6).

Each of them corresponds to a specific attribute or group of


attributes and is enclosed in a specific page. The global condition
defining the filter is built by applying an AND user between the
elementary conditions defined by the groups. When, inside a
group, a list offers multiple selection for an attribute, the condition
on this attribute results from an OR user on the different selected
values.

3AL 88876 AAAA Ed. 01

67 / 182

4 Sublist Management

4.2.3

Basic Sub-panel
To activate or deactivate one of the groups (e.g. Severity or Alarm
Type), click the check button of the area (black color means that
the area has been activated). The following paragraphs detail the
operations for the different groups.

Basic Sub-panel for


Current Alarms

For the current alarm management, the basic sub-panel of the


Sublist Properties window has the following aspect (figure 24):

Figure 24

68 / 182

Filter Panel for Current Alarms: Basic Sub-panel

3AL 88876 AAAA Ed. 01

4 Sublist Management

Basic Sub-panel for


Historical Alarms

For the historical alarm management, the basic sub-panel of the


Sublist Properties window has the following aspect (figure 25):

Figure 25
Note

3AL 88876 AAAA Ed. 01

Filter Panel for Historical Alarms: Basic Sub-panel

Historical alarms are not available with 1320 Craft Terminal. They
are only operative with Network Management.

69 / 182

4 Sublist Management

Event Date & Time


Ranges Group

The AS application gives the possibility to select alarms according


to the date and time of their raising event.
You can specify a list of intervals for date and time. An alarm will
be selected if the raising event took place in one of the intervals.
In the basic sub-panel, the Event Date & Time Ranges area (figure
26) presents in a read-only box the list of the intervals already
defined.

Figure 26

Basic Sub-panel: Event Date & Time Ranges Area

To add some intervals or to adapt this list, click on the Select...


push button. Another dialog box opens, presented in figure 27.

Figure 27

70 / 182

Date Range Selection Dialog Box

3AL 88876 AAAA Ed. 01

4 Sublist Management

As in all other relevant places of the application, times have to be


expressed using local definition, not GMT.
To specify an interval (beginning and end) with the text boxes,
respecting the proposed format, or adapt it with the spin buttons,
after selecting the desired sub-part (month, day, year, hours,
minutes, seconds) by clicking on the right position inside a box
(see paragraph 1.2.3).
Add the hour interval to the list of intervals, displayed on the right
part of the dialog box, by clicking on the right-arrow button.
To delete an existing time interval from the list, select it then click
on the left-arrow button.
Note

The validation of a date depends on the way it is entered:


"

A date that is specified by typing in the entry box is only


validated when you press the right-arrow.

"

A date that is specified by using the spin buttons cannot be


false, so it is automatically validated.

To modify an interval, proceed in two steps (deletion and


addition):
"

Select an interval in the right list and click on the left-arrow


button. It disappears from the list (deletion), but its definition
is moved to the edition area on the left.

"

Adapt this definition according to your needs and press the


right-arrow button. The new interval is inserted in the list.

Click on the Ok push button to close the dialog box and return to
the Basic sub-panel.

3AL 88876 AAAA Ed. 01

71 / 182

4 Sublist Management

Archiving Date & Time


Ranges Group

Only historical alarms can also be filtered according to their


archiving date and time, i.e. the moment they have entered the
archive. This time can be significantly different from the raising
event time and, for this reason, is available as a separate data.

Figure 28

Basic Sub-panel: Archiving Date & Time Ranges


Area for Historical Alarm

The way of operation is exactly the same as for the Event Date &
Time Ranges group.

72 / 182

3AL 88876 AAAA Ed. 01

4 Sublist Management

Status Group

Only the current alarms can be selected according to their status


(figure 29). You can manage separately the statuses
corresponding to:
"
"
"
"

Reservation
Acknowledgement
Clearing
Clearable.

These statuses are described in the Glossary (see section 10.2).


For each of these statuses, you can insert a condition in the filter
and specify the desired state (set or not). To do this, check the
relevant check button and select the wanted option by opening the
option list on the right.
For example, to include in the list the acknowledged alarms,
activate the Acknowledgement check button and select ACK from
the option list.

Figure 29

3AL 88876 AAAA Ed. 01

Basic Sub-panel: Status Group for Current Alarm

73 / 182

4 Sublist Management

Severity or Alarm Type In both contexts (current and historical alarms management),
Group alarms can also be filtered according to their severity level or their
type.

Figure 30

Basic Sub-panel: Severity and Alarm Type Group

For each group, the test can be operated against several values,
offering an OR boolean user through multiple selection in the list.
Click on the Severity or Alarm Type check buttons to activate the
respective areas if they are not activated. Then, select the desired
fields with the left mouse button. Reciprocally, click also on the
check buttons to deactivate the areas if they are already activated
and you want to remove the corresponding condition from the
filter.

74 / 182

3AL 88876 AAAA Ed. 01

4 Sublist Management

Probable Cause Group

Another attribute group that may be used for filtering is the


probable cause of the alarm (figure 31). Exactly as for Severity or
Alarm Type, several values can be selected to define an OR
combination.

Figure 31

Basic Sub-panel: Probable Cause Group

The list presented at this sub-panel level is read-only and


displays the causes already selected (in previous operations). It is
initially empty.
The set of probable cause is defined in a repository file. Probables
causes are predefined when AS application is launched. They are
loaded from a configuration file that gives the translation between
attribute identifier (oid/integer) and displayed associated text.
To select alarms according to their probable cause, click on the
Probable Cause check button to activate the area then on the
Select... push button. A new dialog box opens up (figure 32) in
which the user can adapt the list of selected probable causes.

3AL 88876 AAAA Ed. 01

75 / 182

4 Sublist Management

Figure 32

Probable Cause Dialog Box

This dialog box includes two lists:


"
"

one in alphabetical order (Unselected Probable Causes) for


the probable causes to be no selected
the other one in alphabetical order (Selected Probable
Causes) for the probable causes to be taken into account

It is possible to move one or several elements from a list to the


other one by selecting the desired items and then using the arrow
buttons (left and right, see paragraph 1.2.3).
At the end of the operation, click on the Ok push button. This
dialog box closes and the list at the panel level is updated.

Correlation Group

Only in current alarms case, you can select alarms according to


their correlation status.

Figure 33

Basic Sub-panel: Correlation Group for Current


Alarm

Click on the check button to activate the Correlation area if


necessary. Then click on the option button to drop it down and
select an item.

76 / 182

3AL 88876 AAAA Ed. 01

4 Sublist Management

Selecting Primary Alarms will add in the filter a condition


specifying that the correlation status must be false, excluding all
the correlated alarms. Selecting Correlated alarms will add a
condition specifying that this status must be true.

Insertion Cause Group

Only in the historical alarms case, you can extract alarms from the
Main Alarm List according to their insertion cause, i.e. the way the
alarm has entered the historical list.
This can be done by selecting the desired option in the Insertion
Cause area.

Figure 34

Basic Sub-panel: Insertion Cause Group for


Historical Alarm

Click on the check button to activate the Insertion Cause area if


necessary. Then click on the option button to drop it down and
select an item.

3AL 88876 AAAA Ed. 01

"

Auto-purging: such alarms have never been raised up to


the CAL.

"

Manual purging: an AS user has manually removed one or


more selected alarms from the CAL.

"

Overflow: an AS user can set overflow configuration (i.e. a


maximum size of the CAL, an overflow mode, an Overflow
Purge Size and Purging Sort Criteria). Refer to section 7.1.1.

"

Acknowledging cleared alarms or clearing


acknowledged alarms: when normal synchronization
occurs, all alarms which were acknowledged and which are
not confirmed in the synchronization.

"

Synchronization: alarms that are not confirmed on a


synchronization command are automatically cleared by the
application. Among them, those which were previously
acknowledged are forwarded to the HAL.

"

AS IM modification: at start up, when an agent is no longer


in the agents list, all alarms from this agent.

"

Invalidation: alarms matching FDN, scope and class in case


of invalidate alarm List.

77 / 182

4 Sublist Management

4.2.4

Source Sub-panel
By using the source sub-panel (see figure 35), you can extract
alarms according to their MO class, MO instance or Friendly
Name (NE).

Figure 35

Filter Panel: Source Sub-panel

The Source sub-panel contains two attributes (Object Instance


and Object Class). There is a sub area for each attribute. Each
sub-area have a check button with a name. This name is the
name given in a configuration file. The check button selection
allows you to use (if activated) or not this attribute in the filter. If
the two attributes are used, the filter will consist in an AND
condition on the used attributes.
The two types of attributes which may be used are described
below.

78 / 182

3AL 88876 AAAA Ed. 01

4 Sublist Management

Object Instance Type Radio buttons allow you to choose how the instance is managed
(as a Friendly Name or as a MO Instance).

To select alarms according to their object instance, click on the


Instance check button to activate the area.

Figure 36
"

"

3AL 88876 AAAA Ed. 01

Source Sub-panel: Instance Group

If MO Instance is selected (as in figure 36), you can specify


the kind of test to be performed by using the option button
which presents the following options:
D

Base: to only consider the object specified by the instance

Subtree: to also include in the search all the objects


contained in the specified object.

If Friendly Name is selected, you can also specify the nature


of the test by using the same option button as above, which
now presents another list of options:
D

Equal: only includes objects which match exactly the


specified string

Substring: the actual Friendly Name must contain the


specified string

Begin with: the actual Friendly Name must begin by the


specified string

79 / 182

4 Sublist Management

End with: the actual Friendly Name must end by the


specified string.

Enter the desired value in the lower edit field and then click
on the Add push button. The user's value appears now in the
right read-only area.
If you want to modify an existing value appearing in this
read-only list, select it first by clicking on it with the left
mouse button. This causes the left area to be put in conformity
with the selected element (this means that one of the Friendly
Name or MO Instance check buttons is checked, the option
button points to the option in accordance with the selected
element and the edit field is also updated). Bring any wanted
modifications in this area and valid them by clicking on the
Modify push button (note that this button remains disabled as
long as no element or more than one have been selected in
the right list box).
Multiple selection is available in the right list box to allow
removing action. To do this, select one or more elements in
the right list box and click on the initially disabled Remove
push button.
Moreover, it is also possible to use regular expressions, strings
of characters that define patterns used to search for matching.
It is a way of specifying a string that allows certain
metacharacters (e.g. '.', '*', '[', ']', '-', '+', '?') to stand for
other characters. Metacharacters in a regular expression are
defined as following:

80 / 182

'.' matches any single character except a newline. For


example the regular expression "P." matches any single
character followed by a 'P' in a string.

[...] is called a character set. It matches any one of the


characters that are enclosed in the square of brackets.
For example [ATC] matches any one of the characters 'A',
'T' or 'C' in a string.

[~xyz] is the negation of [xyz]. For example [~abc]


matches any character except a, b or c.

[x-y] is called a range of characters and is indicated by


using an hyphen '-' between the beginning and ending
characters, and enclosing the whole thing in brackets. For
example [0-9] matches any digit.

'|' is the alternation operator and it is used to specify


alternatives. For example "a|b" matches either "a" or "b"
string.

3AL 88876 AAAA Ed. 01

4 Sublist Management

'*' means that the preceding regular expression is to be


repeated as many times (>=0) as possible to find a
match. For example "ph*" matches strings such as "ph",
"phh", "phhh".

'+' is similar to '*', but the preceding expression must be


matched at least once. For examble "ph+" matches
strings such as "ph", "Phh".

'?' is similar to '*', but the preceding expression can be


matched once or not at all least once. For examble
"ph?L" matches the strings "phL" and "phiL".

'\' before a metacharacter means that it must be


understood as a simple character.

Here follows some regular expression examples:


D

"[0-9][a-z]*" will match strings such as "7czw".

"[0-9a-zA-Z]+" will match any alphanumerical


strings with at least one character.

"a.\+b" will match strings such as "ax+b".

Object Class Type You can extract alarms with respect to multiple MO Class attribute
values.

Figure 37

Source Sub-panel: MO Class Group

The list presented at this sub-panel level is read-only and


displays the MO classes already selected (in previous operations).
It is initially empty.
To add some MO classes or to adapt this list, click on the MO
Class check button to activate the area then on the Select... push
button. Another dialog box opens, presented in figure 38.

3AL 88876 AAAA Ed. 01

81 / 182

4 Sublist Management

Figure 38

Managed Object Class Dialog Box

This dialog box includes two lists:


"

one (Unselected MO Class) for the MO classes which will not


be involved in the extraction process

"

the other one (Selected MO Class) for the MO classes


participating to this process.

You can move one or several elements from a list to the other one
by selecting the desired items and then using the arrows buttons.
To retrieve valid values for MO Class, MO Instance and Friendly
Name, you can use the More Alarm Information window (see
section 6.1). This window can be called from any open sublist
window after selection of an alarm in the table. The three
attributes are displayed in the identity panel.

82 / 182

3AL 88876 AAAA Ed. 01

4 Sublist Management

4.2.5

Extended Sub-panel
By using the Extended sub-panel (see figure 39), you can extract
alarms considering their additional info attribute values.

Figure 39
Note

3AL 88876 AAAA Ed. 01

Filter Panel: Extended Sub-panel

The availability of the Extended sub-panel depends on the

83 / 182

4 Sublist Management

Additional Info repository: it may be inaccessible if the Additional


Info repository is empty.
Check the Additional Info check button to activate the group if
necessary. The Extended filter is defined through an area
composed of a set of labeled check buttons indicating the type of
additional info (enumerated list, date and time, integer, real,
string, boolean). Each of them is associated with an option button
(which specifies the nature of the test and depends on the type of
the additional info) and an edit field.
The option buttons and edit fields are activated once the relevant
check button has been checked. A test is defined by an user AND
applied between the conditions specified at the level of each
activated check button.
Fill in the desired fields. Note that for additional info about a date
and time, you have to click on the Select... push button to access
a Date Range Selection dialog box (see figure 27).
Then, to add the test involving additional info attributes to the
existing ones (if any), click on the Add push button located below
this area. As a result of this, the test appears (in an explicit form
showing the elementary expressions and the logical user AND
applied between them) in the read-only area located at the
bottom of the page. The extended filter results in an OR user
applied between the different existing tests.
If the user wants to modify an existing test (i.e. appearing in the
read-only area), select it first in this area by clicking on it. The
upper area of the page is updated according to the content of the
test. Modify the user's test and then click on the Modify push
button. The test is now updated.
In a same way, removing an existing test is done by first selecting
the test and then clicking on the Remove button. The removed test
disappears from the list.
Note that multiple selection is available in the existing tests list. In
this case, the additional info check boxes area relates to the last
selected test, but the Modify push button is not active.
The historical alarms source names are not the same as the
current alarms ones. They depend on the repository in which the
current alarms have been archived (see section 8.1).

84 / 182

3AL 88876 AAAA Ed. 01

4 Sublist Management

4.2.6

Advanced Sub-panel
By using the Advanced sub-panel (see figure 40), you can extract
alarms according to the name of their alarm source, their specific
problem attribute value, their Trouble Ticket and Repetition
Counter value and their expiration status.

Figure 40

3AL 88876 AAAA Ed. 01

Filter Panel: Advanced Sub-panel

85 / 182

4 Sublist Management

Alarm Source Name


Group

The 'Alarm Source Name' is the name of one of the current IM


connected to the USM.

Figure 41

Advanced Sub-panel: Alarm Source Name Group

The list presented at this sub-panel level is read-only and


displays the IM already selected (in previous operations). It is
initially empty.
To add some IMs or to adapt this list, click on the Alarm Source
Name check button to activate the area then on the Select... push
button. Another dialog box opens, presented in figure 42.

Figure 42

86 / 182

Alarm Source Name Dialog Box

3AL 88876 AAAA Ed. 01

4 Sublist Management

This dialog box includes two lists:


"

One (Unselected Sources) for the IMs which will not be


involved in the extraction process

"

The other one (Selected Sources) for the IMs participating to


this process.

The user can move one or several elements from a list to the other
one by selecting the desired items and then using the arrows
buttons.

Specific Problems
Group

This attribute is complementary to the Probable Cause of the Basic


sub-panel.

Figure 43

Advanced Sub-panel: Specific Problems Group

The list presented at this sub-panel level is read-only and


displays the specific problems already selected (in previous
operations). It is initially empty.
To add some specific problems or to adapt this list, click on the
Specific Problems check button to activate the area then on the
Select... push button. Another dialog box opens, presented in
figure 44.

3AL 88876 AAAA Ed. 01

87 / 182

4 Sublist Management

Figure 44

Specific Problems Dialog Box

This dialog box includes two lists:


"

One (Unselected Specific Problems) for the specific


problems which will not be involved in the extraction process

"

One (Selected Specific Problems) for the specific problems


participating to this process.

You can move one or several elements from a list to the other one
by selecting the desired items and then using the arrows buttons.
Before doing this, you have to choose the way the filter will be
applied, by using the option button located on the top middle of
the area. The proposed options allows you to perform all the
possible operations (Equal, Not Equal, SubSetOf, Not SubSetOf,
SuperSetOf, Not SuperSetOf, NullIntersection, Not
NullIntersection) between two data sets.

88 / 182

3AL 88876 AAAA Ed. 01

4 Sublist Management

Trouble Ticket and


Repetition Counter
Group

In AS, it is possible to extract alarms considering an existing


Trouble Ticket (and possibly its identifier) and/or the value of the
Repetition Counter (see figure 45).

Figure 45

3AL 88876 AAAA Ed. 01

Advanced Sub-panel: TT and Rep Counter Group

"

To enable filtering according to the TT flag, check the


corresponding check button then select the TT option by
clicking on the relevant option button.

"

The TT Ident check button becomes active. If you check it, you
can enter a TT identifier value in the corresponding field then
select an operation to apply to this value by clicking on the
relevant option button.

"

To enable filtering according to the repetition counter value,


check the Rep Counter check button, enter a value in the
corresponding field then select an operation to be applied to
this value by clicking on the relevant option button.

89 / 182

4 Sublist Management

Expiration Status Group

The expiration status refers to the alarm aging mechanism (see


section 7.3).
Click on the Exp. Status check button to activate the area if
necessary (see figure 46).

Figure 46

Advanced Sub-panel: Exp. Status Group

Select a condition in the list. The option button allows to select the
way the filter will be applied on this condition. The proposed
options allow you to perform all the possible operations (Equal,
Not Equal, SubSetOf, Not SubSetOf, SuperSetOf, Not SuperSetOf,
NullIntersection, Not NullIntersection) between two data sets.

90 / 182

3AL 88876 AAAA Ed. 01

4 Sublist Management

4.2.7

Sort Panel
The Sort panel of the Sublist Properties window presents the
following aspect (figure 47):

Figure 47

3AL 88876 AAAA Ed. 01

Sublist Properties Window: Sort Panel

91 / 182

4 Sublist Management

This panel includes two lists:


"

An Unselected Sort Criteria list for the attributes which will


not be involved in the sort process

"

A Selected Sort Criteria list for the attributes participating to


this process.

It is possible to move one or several attributes from a list to the


other one by selecting the desired items and then using the arrow
buttons.
Note

The set of possible attributes depends on the context. The lists are
slightly different in current USM and historical USM, but the user
interaction is identical.
In the Selected Sort Criteria list, the order of items also
represents the priority order for the sort process.
For each attribute of the right list, it is also possible to specify the
order the values taken by this attribute are considered (ascending
or descending order). The current direction is indicated by the
option button on the right of the attribute name. To invert this
order, click on this button. Its label then changes (Incr or Decr).

Note

For boolean attributes such as Reservation Status, the set value


(e.g. reserved) is assimilated to 1, the unset value (e.g.
unreserved) to 0, which allows defining an ascending or
descending order.
As in several other contexts, you can benefit of a dictionary of
sorting configurations to ease your work. The corresponding Sort
Name group is located at the top of the panel.
It is possible to choose among available entries, add another one
from selected definition, or remove an existing entry that will not
be useful anymore. Loading a configuration is done by first
clicking on the dropdown button and then selecting the desired
entry through its name.

92 / 182

3AL 88876 AAAA Ed. 01

4 Sublist Management

Note

When creating a new entry, the size of the name should not
exceed 32 characters. Authorized names are names containing
letters (case independent), numbers, and the three -,_,.
characters. Save the new entry by clicking on the Save button. If
the specified name is incorrect, the following error message
appears:

Figure 48

4.2.8

Addition of a Dictionary Entry: Error Message

Trigger Panel
Only for current alarms, it is possible to set Tone emission or
Continuous Beep on incoming alarms in the sublist (whatever the
severity level).
Triggering capability allows ASCUR-USM to raise some external
actions. This mechanism permits to execute an external application
according to filtering conditions.
For incoming alarms, the administrator can define a selection filter
identifying alarms under scope of this automatic action.
It is also possible to trigger scripts execution as the number of
alarms contained in the sublist becomes lower or greater than
customized values.

3AL 88876 AAAA Ed. 01

93 / 182

4 Sublist Management

The Trigger panel of the Sublist Properties window presents the


following aspect (figure 49):

Figure 49

94 / 182

Sublist Properties Window: Trigger Panel

3AL 88876 AAAA Ed. 01

4 Sublist Management

Tone Group

Note

To activate the tone emission on incoming alarms, check the


On/Off or the Continuous Beep check buttons of the Tone area.
In this case, AS will trigger a tone emission or a continuous beep
each time a new alarm is inserted in the concerned sublist, i.e.
matches the filter defined for this sublist (the user may for example
set the tone emission or the continous beep for the predefined
critical sublist and by this way be warned if critical alarms are
received by AS).
when the Tone Emission criteria is selected and In case of
incoming alarms package (one or several alarms) or incoming
alarms in several displayed sublists, the AS application triggers a
single tone emission.
when the continuous beep criteria is selected and In case of
incoming alarms package (one or several alarms) or incoming
alarms in several displayed sublists, the AS application triggers a
continuous beep emission. This continuous beep stops when the
sublist is selected or opened.
To deactivate the Tone emission or the Continuous beep, uncheck
the button.

3AL 88876 AAAA Ed. 01

95 / 182

4 Sublist Management

Trigger Group

To extend the Trigger features, AS allows you to execute any


command line according to the number of alarms contained in the
sublist (this allows you for example to load some particular process
as soon as the number of critical alarms exceeds a certain value).
Arguments may be provided to the script/program.
Two distinct command execution criteria can be defined:
"

When the number of alarms becomes greater than a specified


value

"

When the number of alarms becomes smaller than a specified


value.

To define the first criterion, check the Do check button to activate


the upper part of the Trigger area (see figure 49) and select
Execute by means of the option button. Then fill the Script field
with the command or the executable file.
Use the option button to execute the script either when the number
of alarms is strictly greater than the value you enter in the
alarms field, or on incoming alarm(s).
The second criterion definition follows the same steps except that
the lower part of the Trigger area is involved in this case.
Use the option button to execute the script either when the number
of alarms is strictly smaller than the value you enter in the
alarms field, or on outgoing alarm(s).
Note

The script/program is executed by the script triggering server in


the environment of the machine on which it is located.
In the same way, you can check the Do button and select the
Navigate To option (see figure 50) to send alarm information (No
Attribute, All Alarm Attributes, Displayed Alarm Attribute proposed
by the Sending option button) towards an external application
(see section 9.5).

96 / 182

3AL 88876 AAAA Ed. 01

4 Sublist Management

Figure 50

3AL 88876 AAAA Ed. 01

Sublist Properties Window: Trigger Panel with


Navigation Option

97 / 182

4 Sublist Management

4.3

Deleting a Sublist
Any sublist, except the Main Alarm List and the Default Alarm
Sublist, can be deleted.
In the Counter Summary window, use the menu path:
Sublist -> Delete
The following dialog box opens (figure 51):

Figure 51

Confirmation Window for Sublist Deletion

Before the actual deletion, you are asked for a confirmation.


In case of confirmation, the sublist disappears from the Counter
Summary window.

98 / 182

3AL 88876 AAAA Ed. 01

4 Sublist Management

4.4

Activating/Deactivating a Sublist
Activating a sublist consists in viewing the current alarms that
match the filtering criteria defined by the user. If the sublist is
opened and deactivation is asked, a dialog box opens to ask
confirmation to the user. In case of confirmation the sublist is
closed.
Note

This action is available only for current alarms:


In the Counter Summary window, use the menu path:
Sublist -> Activate (or Deactivate)

3AL 88876 AAAA Ed. 01

99 / 182

4 Sublist Management

4.5

Enabling/Disabling a Counter
Enabling a counter consists in extracting the archived alarms that
match the filtering criteria defined by the user.
Note

This action is available only for historical alarms:


In the Counter Summary window, use the menu path:
Sublist -> Enable (or Disable) a counter

Note

100 / 182

Historical alarms are not available with 1320 Craft Terminal. They
are only operative with Network Management.

3AL 88876 AAAA Ed. 01

4 Sublist Management

4.6

Visualizing (Opening) a Sublist


Once a sublist has been created (see section 4.1) and its
parameters defined (see section 4.2), you may want the sublist
content to be displayed. Counter Summary only displays global
information (the number of alarms of each severity level). To get
more information, i.e. the list of alarms contained in the sublist, it
is necessary to open this sublist.
In the Counter Summary window, use the menu path:
Sublist -> Open
As an alternate method, it is possible to simply double-click on
the line in the sublist table.
A specific window dedicated to the selected sublist appears (see
figure 52):

Figure 52
Note

3AL 88876 AAAA Ed. 01

Current Alarm Sublist Window

The appearance of the Alarm Sublist window is the same for


current or historical alarms, except if notified.

101 / 182

4 Sublist Management

The Alarm Sublist window is composed of four parts:


"
"

"
"

4.6.1

At the top of the window: a menu bar (see section 4.6.1)


In the upper middle part: the COUNTERS area that repeats
the global information already available in the Counter
Summary window
In the lower middle part: an alarm table (see section 4.6.2)
At the bottom right of the window: two Indicator fields (see
section 4.6.3).

Menu Bar
The menu bar includes the following pull-down menus:

4.6.2

"

Sublist: to manage the sublists (see chapter 4)

"

Action: to manage the alarms (see chapter 5)

"

Display: to choose the way to display the alarm information


(see chapter 6)

"

Navigation: to navigate within and out of AS (see chapter 9)

"

Help: to get the on-line help (see paragraph 1.2.5).

Alarm Table
This table presents the alarms matching the sublist filter. The
columns of the table correspond to the displayed subset of alarm
attributes, which has been defined as one of the sublist
parameters.
Table 2 synthesizes the actions you can undertake by using the
mouse.
Note

102 / 182

You can sort these alarms by clicking with the right button of the
mouse on the head of each columns.

3AL 88876 AAAA Ed. 01

4 Sublist Management

Table 2

Mouse Action on the Alarm Table of the Alarm Sublist Window

Location

Action

Click

Double Click

Drag & Drop

Hide column

Move column (2)

Select alarm

Single selection

Show more info


on THE pointed
alarm

Multiple selection -

Column Titles
Alarms

Unselected

(3)

(2) Drag & Drop on the bottom edge of a column title resizes the height of the

row.
(3) Drag & Drop on the bottom or high edge of the 1.st column of any rows
resizes the height of all rows.

In this Sublist window, when the user clicks with the right button of
the mouse, a contextual menu as shown in figure 53 appears.
More Info...
Correlated Alarms...
Trouble Ticket...
Acknowledge...
Reserve...
Unreserve...
Manual Purge...
Manual Clear...
Output...
External Applications

Figure 53

Alarm Sublist Window Contextual Menu

By using this contextual menu, you can:


"
"
"
"
"
"
"
"
"

3AL 88876 AAAA Ed. 01

get More Information about alarms (see section 6.1)


see Correlated Alarms (see section 6.2)
create a Trouble Ticket (see section 5.3)
Acknowledge an alarm (see section 5.4)
Reserve or Unreserve an alarm (see section 5.2)
perform a Manual Purge of an alarm (see section 5.5)
perform a Manual Clear of an alarm (see section 5.6)
Output (export) an alarm (see section 5.7)
sending alarm information towards an External Application
(see section 9.5).

103 / 182

4 Sublist Management

4.6.3

Indicator Fields
The indicators display the corresponding AS IM name and the
color of the CAL Status. This color is real-time updated. Overflow
parameters are configurable (see paragraph 7.1.1).
Note

104 / 182

In current alarms case, the content of the Alarm Sublist window is


permanently refreshed according to the incoming alarms and
sublist characteristics (filter, sort... except for windows issued from
the Correlated Alarms command).

3AL 88876 AAAA Ed. 01

4 Sublist Management

4.7

Exiting Alarm Surveillance


If using the Save option from the Sublist pull-down menu, any
sublist creation or any modification you have performed on
sublists parameters are saved during exit process, and restored at
the beginning of AS next sessions (persistency).
When you select the Save option in the current alarm Counter
Summary window a confirmation dialog box (see figure 54) opens.
If you click on the Yes push button, the association between the
alarm list and the alarm filter is saved. Thus if you close AS USM
and open it again, the alarm list is filtered in the recently saved
way. But if you use another alarm list, you have not the new filter
in its filter list. To make the new filter visible to the other lists, use
the Save button of the Filter panel in the Sublist Properties window
(see paragraph 4.2.2).

Figure 54

Save USM Confirmation Dialog Box

If using directly the Exit option from the Sublist pull-down menu,
a confirmation dialog box (see figure 55) opens and ask your if
you want to save the changes you have performed on sublist
parameters.

Figure 55

3AL 88876 AAAA Ed. 01

Exit USM Confirmation Dialog Box

105 / 182

4 Sublist Management

106 / 182

3AL 88876 AAAA Ed. 01

5 Alarm Management

5 Alarm Management
AS Management

To manage the alarms in the Alarm Sublist window (see section


4.6 - figure 52), click on the Action pull-down menu.
For the current and historical alarms, the actions are the same
plus Save As for the historical one (see figure 56):
However, in the historical pull-down menu some actions are
greyed and cannot be selected.
Current Alarm

Historical Alarm
Action

Action
Select
>
Reserve
Unreserve...
Trouble Ticket...
Acknowledge
Manual Purge...
Manual Clear...
Output...

Figure 56

All
None

Select
> All
None
Reserve
Unreserve...
Trouble Ticket...
Acknowledge
Manual Purge...
Manual Clear...
Output...
Save As...

Action Pull-down Menu

By using the Action menu, the user can:


"
"
"
"
"
"
"
"

Note

3AL 88876 AAAA Ed. 01

Select an alarm (see section 5.1)


Reserve or Unreserve an alarm (see section 5.2)
create a Trouble Ticket (see section 5.3)
Acknowledge an alarm (see section 5.4)
perform a Manual Purge of an alarm (see section 5.5)
perform a Manual Clear of an alarm (see section 5.6)
Output (export) an alarm (see section 5.7)
Save an historical alarm in a user file (see section 5.8)

Historical alarms are not available with 1320 Craft Terminal. They
are only operative with Network Management.

107 / 182

5 Alarm Management

5.1

Selecting an alarm
Once an Alarm Sublist window is open, one or more alarms can
be selected, and the user has several possibilities.

5.1.1

Selecting All the Alarms


In the Alarm Sublist window, use the menu path:
Action -> Select
Two cascading options appear and the user can choose (figure
56):
"
"

5.1.2

All: to select all the alarms of the sublist window


None: to deselect the selected alarms

Selecting a Single or a Group of Alarms


"

To select a single or a list of alarms, the user must click on the


desired alarm or drag the mouse along the alarms he wants
to select. In this case, the selected alarms will be consecutive.

"

It is also possible to use some combinations of mouse +


keystroke:
D

Once an alarm has been selected in the list, the user


must press the <Shift> key while clicking on another
alarm, so that all the alarms appearing between the first
selected alarm and the clicked alarm are selected.

Pressing the <Ctrl> key while clicking on alarms allows


the user to select alarms which are not consecutive in a
list. In this case, the user can select an alarm outside a
given existing selection without removing this selection.

With this same combination it is also possible to deselect a


previously-selected alarm.

108 / 182

3AL 88876 AAAA Ed. 01

5 Alarm Management

5.2

Reserving/Unreserving Alarms
To ensure to be the only responsible for an alarm (or a group of
alarms), the user can perform the reservation action on alarm(s).

5.2.1

Reserving Alarms
To reserve one or several alarms:
"

Select the alarm(s).

"

Use the menu path:


Action -> Reserve

The status of the selected alarm(s) changes in the Reservation


Status column, passing from NRSV (non-reserved) to RSV
(reserved).
Note

5.2.2

An alarm can only be reserved if it has not been reserved before


by another user (i.e. an alarm must have a Reservation Status set
to NRSV).

Unreserving Alarms
To unreserve one or several alarms:
"

Select the alarm(s).

"

Use the menu path:


Action -> Unreserve

The status of the selected alarm(s) changes in the Reservation


Status column, passing from RSV (reserved) to NRSV
(non-reserved).
Note

3AL 88876 AAAA Ed. 01

A reserved alarm can be unreserved by:


The user who has reserve it.
Or
A privileged user that has the "RestrictedUnreserveAlarm" FAD in
its SEC profile.

109 / 182

5 Alarm Management

5.3

Creating a Trouble Ticket


A Trouble Ticket is a collection of all kind of information about a
specific problem. Thus, it contains at least the information related
to an alarm, but can also include information relative to the
actions performed to solve this problem.
AS can be customized to interface with the third-party Trouble
Ticket managing product ARS (edited by Remedy Corporation).
Note

If AS is configured to run without ARS, all menus concerning the


management of trouble tickets are inaccessible (i.e. greyed).
To create Trouble Ticket(s) about a single or a group of alarms in
the Alarm Sublist window:
"

Select the alarm(s).

"

Use the menu path:


Action -> Trouble Ticket...

A confirmation is required before effectively sending the request.


The flag(s) corresponding to the selected alarm(s) changes in the
Trouble Ticket Creation Flag column, passing from NO to YES.

110 / 182

3AL 88876 AAAA Ed. 01

5 Alarm Management

5.4

Acknowledging Alarms
By acknowledging a single or a group of selected alarms in the
Alarm Sublist window, the user notifies he is taking it or them into
account.
To acknowledge one or several alarms:
"

Select the alarm(s).

"

Use the menu path:


Action -> Acknowledge

A confirmation is required.
The status of the selected alarm(s) changes in the Ack. Status
column, passing from NACK (non acknowledged) to ACK
(acknowledged).
Note

3AL 88876 AAAA Ed. 01

Acknowledging a cleared alarm is an implicit archiving action.


Thus, on the example above, the acknowledgement will actually
archive the alarms and cause their disappearance from the list.

111 / 182

5 Alarm Management

5.5

Manually Purging an Alarm


To manually purge one or several alarms of the Alarm Sublist
window:
"

Select the alarm(s).

"

Use the menu path:


Action -> Manual Purge...

The purged alarm(s) disappear from the sublist, or main list, and
are now archived, if matching the archiving filter.

112 / 182

3AL 88876 AAAA Ed. 01

5 Alarm Management

5.6

Manually Clearing an Alarm


When Alarm Clear Event is never received from an alarm agent,
an AS operator is authorized to clear manually this kind of alarm.
AS can be informed about this kind of alarm either by the alarm
agent or by AS off-line configuration
To manually clear one or several alarms of the Alarm Sublist
window:
"

Select the alarm(s) whose alarm status must be Clearable.

"

Use the menu path:


Action -> Manual Clear...

A confirmation dialog box (see figure 57) opens.

Figure 57

Confirmation Dialog Box for Manually Clearing an


Alarm

Click on the Yes push button. The Report window opens (see
figure 58) showing the status of the cleared alarm(s).

3AL 88876 AAAA Ed. 01

113 / 182

5 Alarm Management

Figure 58

114 / 182

Cleared Alarm Report Window

3AL 88876 AAAA Ed. 01

5 Alarm Management

5.7

Exporting and Printing (Output...) an Alarm


The content of a sublist can be exported to a file or sent to a
printer as well as the content of a single alarm (for this last part,
see section 6.1). In both cases, the user will be requested to fill in
the Output dialog box with the desired parameters.
Exporting a whole sublist or part of it (i.e. a selected group of
alarms belonging to this sublist) can be done from both current or
historical Alarm Sublist windows. It means that the user is
requested to first open the sublists he wants to export.
To export a part of or the whole sublist:
"

Select one or several alarm(s).

"

Use the menu path:


Action -> Output...

The Output window has the following aspect (figure 59):

Figure 59
Note

Output Window: Default Aspect

By default, the Print area is greyed and Export area is enabled. A


default print command and a default filename are specified.
The user has the possibility to change the default options,
exporting the alarms to an ASCII file of his choice, or using a
specific print command.
To activate either the Print or the Export field, click on the radio
button in front of the field. Then fill in the field corresponding to
the type of export the user has chosen (printer or ASCII file).

3AL 88876 AAAA Ed. 01

115 / 182

5 Alarm Management

"

"

The user is requested to fill the Print field with a user


command (the default one calls a printing script). Two
possibilities exist:
D

keeping the default command

developing a print command that handles as a


parameter the name of the temporary formatted file
generated by AS. This file is not accessible and it is up to
the AS application to take and execute the user
command.

The Export field is to be filled in with a file name. There are


two possibilities:
D

specifying directly in the field the name of the file

using the Select... push button. The following File


Chooser dialog box opens up (see figure 60), which
allows the user to browse the existing files. He can select
an existing file (in this case, this file will be overwritten), or
specify a new name.

Figure 60

File Chooser Dialog Box

Click on the Ok push button to return to the Output dialog box


(figure 59).

116 / 182

3AL 88876 AAAA Ed. 01

5 Alarm Management

To launch the exportation or printing operation, click on the Ok


push button of the Ouput dialog box (figure 59). During the
operation, a progress dialog box is displayed.
Note

The exported information concerns only the attributes displayed in


the sublist.
On the contrary, information exported from the More Alarm
Information window only concerns a single alarm. Its content
corresponds to this More Alarm Information window (see section
6.1).

Note

3AL 88876 AAAA Ed. 01

The exported format is a generic one with a defined syntax (see


the ALMAP AS 6.5 Integration & Administration Guide). It is up to
the customer applications to write the appropriate printing script
to parse the generic format and print the alarm data according to
their specific needs.

117 / 182

5 Alarm Management

5.8

Saving a Historical Alarm in a User File


Note

Historical alarms are not available with 1320 Craft Terminal. They
are only operative with Network Management.
The user can store into a user file a set of alarms displayed in any
of the sublists (or in the Main List). To do so, from such an Alarm
Sublist window:
"

Select one or several alarms.

"

Use the menu path:


Action -> Save As...

The following dialog box opens (figure 61), which allows the user
to specify a file name.

Figure 61

File Chooser Dialog Box

The directory where the file will be stored has been configured by
the administrator. According to this configuration, it may be
common to the different users, to some of them, or specific to
each of them. As a result, the user cannot control this directory
location.
Simply select from the list one of the existing files to overwrite it, or
type a new name in the entry box at the bottom to create a new
file. Authorized names are names containing letters (case
independent), numbers, and the three -, _, and . characters. Size
of a name should not exceed 32 characters. Click on the Ok push
button.

118 / 182

3AL 88876 AAAA Ed. 01

5 Alarm Management

During the storage process, a progress window (see figure 62) is


displayed.

Figure 62

Historical User File: Storage Progress Window

At any moment, the user can interrupt the process by clicking on


the Stop push button. Already treated alarms are kept in the file,
but remaining ones are ignored.

3AL 88876 AAAA Ed. 01

119 / 182

5 Alarm Management

120 / 182

3AL 88876 AAAA Ed. 01

6 Display Management

6 Display Management
To choose the way to display the alarm information from the
Counter Summary window (see chapter 3) or from the Alarm
Sublist window (see section 4.6), click on the Display pull-down
menu (see figure 63).
Display

More Info...
Correlated Alarms...
Hidden Columns
Auto-Select
Auto-Scroll
Figure 63

Display Pull-down Menu

By using the Display pull-down menu, the user can:


"
"
"
"
"

3AL 88876 AAAA Ed. 01

get More Information about alarms (see section 6.1)


see Correlated Alarms (see section 6.2)
see the Hidden Columns (see section 6.3)
Auto-Select the incoming alarms (see section 6.4)
Auto-Scroll the incoming alarms (see section 6.5)

121 / 182

6 Display Management

6.1

Getting More Information about Alarms


Once a sublist is open and its alarms displayed, the user can get
the full information about one or several alarms. This information
is collected within the More Alarm Information window (see figure
64).
To open the More Alarm Information window:
"

Select the alarm(s) in the alarm table.

"

Use the menu path:


Display -> More Info...

Another method is to double-click on a line in the alarm table.


The More Alarm Information window opens:

Figure 64
Note

122 / 182

More Alarm Information Window: Identity Panel

The appearance of the More Alarm Information window is the


same for historical alarms and for current alarms.

3AL 88876 AAAA Ed. 01

6 Display Management

6.1.1

Viewing Full Alarm Information


The More Alarm Info window presents several panels. Some or
them may be activated and some others deactivated (greyed).
Each of them regroups pieces of information of the same type.
Panels of the More Alarm Information window which do not
concern the considered alarm are greyed. On the previous figure
64, the Additional Info panel was greyed because the considered
alarm has no additional info.

Identity Panel

All the fields, except the User Note field of the Identity panel,
have only display purpose and are therefore read-only.
"

The User Note area is limited to 500 characters. It offers the


possibility to enter textual information, such as comments,
which can be useful to some other users.
Click within this area and enter a text. Click on the Apply
push button to store it.
If the user has selected several alarms before opening the
More Alarm Information window, he can navigate from an
alarm to another one by using the arrow buttons (see figure
65).

Figure 65

More Alarm Information Window: Navigation Area

"

The Dynamic Mode check button (when checked) allows the


automatic update of the More Alarm Information window
when the user selects another alarm or another set of alarms,
or when auto selection occurs (see section 6.4).

"

The New button allows the user to duplicate the current More
Alarm Information window. It may be useful to compare two
windows corresponding to two different alarms.

"

Information contained in the More Alarm Information window


(and relative to a single alarm) can be exported by using the
Output... push button.
To use the Output window, see section 5.7.

Note

3AL 88876 AAAA Ed. 01

The More Alarm Information window is cleared if the target alarm


is purged.

123 / 182

6 Display Management

6.2

Viewing the Correlated Alarms


The Correlated Notification Flag of an alarm indicates whether or
not this alarm is linked to other alarms listed in the Correlated
Notification attributes. When the Correlated Notification Flag of
an alarm is set to YES, the alarm is said to be correlated. When set
to NO, it is said to be a primary alarm (refer to the Correlation
area of the Basic sub-panel described in paragraph 4.2.3).
The user can see if alarms of a sublist are correlated or not,
looking at this Correlated Notification Flag in the corresponding
column.
For a correlated alarm, it is possible to visualize the list of alarms
which this alarm is linked with. To do so:
"

Select an alarm in the alarm table.

"

Use the menu path:


Display -> Correlated Alarms...

An Alarm Sublist window dedicated to the Correlated Alarms


opens.
Unlike other Alarm Sublist windows (corresponding to actual
sublists listed in the Counter Summary window), the content of this
window is not real-time refreshed when new alarms occur but
only if an alarm is purged.
This window may be empty even if the alarm is a Correlated
Alarm, because the alarms which are listed may simply be absent
from the AS Current USM view of alarms.

124 / 182

Note

Only alarms present in the Main Alarm List may appear in the
Correlated Alarms Sublist window.

Note

Note that when a duplicate alarm (see the Glossary for definition)
raising notification is received, alarms attributes that have
changed are updated with their most recent received value and
the repetition counter which is displayed in the Identity panel of
the More Alarm Information window of the alarm is incremented.

3AL 88876 AAAA Ed. 01

6 Display Management

6.3

Visualizing the Hidden Columns


To visualize the columns previously hidden:
"

Use the menu path:


Display -> Hidden Columns

To see all the columns, click on the horizontal scroll bar at the
bottom of the alarm table.

3AL 88876 AAAA Ed. 01

125 / 182

6 Display Management

6.4

Auto-selecting the Incoming Alarms


When this function is activated, the incoming alarms appears
automatically as selected in the alarm table.
To activate/deactivate the auto-select function:
"

Use the menu path:


Display -> Auto-Select

Note

126 / 182

The selected alarms are automatically deselected when they are


clicked to open them.

3AL 88876 AAAA Ed. 01

6 Display Management

6.5

Auto-scrolling the Incoming Alarms


When this function is activated, AS scrolls automatically the alarm
table in oder to always keep the same alarms visible, even if there
are incoming alarms.
When this function is deactivated, AS makes the incoming alarms
visible in the alarm table. In that case, the already displayed
alarms may be shifted up or down.
To activate/deactivate the auto-scroll function:
"

Use the menu path:


Display -> Auto-Select

3AL 88876 AAAA Ed. 01

127 / 182

6 Display Management

128 / 182

3AL 88876 AAAA Ed. 01

7 Alarm Surveillance Administration

7 Alarm Surveillance Administration


To administer the alarm surveillance, the user must be in the
Counter Summary window, and click on the Option pull down
menu (see figure 66).
Note

The Option menu concerns only the current alarms.

Option
Administration
Synchronization
Aging List
Trigger List

Map Property ...

Figure 66

>
>
>
>

Alarm Sources
etamin0

Option Pull- down Menu for AS Administration

By using the Option menu, the user can:


"

set the AS Administration parameters (see section 7.1)

"

perform an AS Resynchronization (see section 7.2)

"

access the Aging List to define automatic actions on alarm


(see section 7.3)

"

access the Trigger List to trigger automatic actions on alarm (see


section 7.4)

The list of Alarm Sources allows the user to choose one AS IM


among those that are connected to the current running USM.

3AL 88876 AAAA Ed. 01

129 / 182

7 Alarm Surveillance Administration

7.1

Setting the AS Administration Parameters


To customize the alarm surveillance performed by the AS
application:
"

in the Counter Summary window, use the menu path:


Option -> Administration

The IM Administration window opens (see figure 67). It contains


five different panels.
"
"
"
"
"

130 / 182

CAL Administration (see paragraph 7.1.1)


Archiving Filter (see paragraph 7.1.2)
Auto-Purge (see paragraph 7.1.3)
Auto-TT (see paragraph 7.1.4)
Auto-Ack (see paragraph 7.1.5)

3AL 88876 AAAA Ed. 01

7 Alarm Surveillance Administration

7.1.1

CAL Administration Panel

Figure 67

IM Administration Window: CAL Administration Panel

By using this panel, it is possible to set the size of the Current


Alarm List (CAL), customize parameters relating to an overflow
case, visualize the current filling status of the CAL.
Note that the maximum CAL size should not exceed 10000
alarms. If the user try to specify a maximum CAL size greater than
this value, a report window opens up pointing out the request
failure and giving some useful indications.
The different parameters of CAL administration are distributed into
three areas.

3AL 88876 AAAA Ed. 01

131 / 182

7 Alarm Surveillance Administration

The Overflow Area

See figure 68.

Figure 68

CAL Administration Panel: Overflow Area

The Overflow area allows the user to set:


"

the CAL Maximum Size parameter:


the current alarm list (and as a consequence, every sublist)
can only contain a limited number of alarm instances.
To define this maximum size, click in the CAL Maximum Size
field then enter the desired value (limited to 10000 current
alarms).

"

The Warning Filling Percentage parameters:


this parameter corresponds to a percentage ratio between the
present size (number of alarms) and the maximum size.
To define this parameter, click in the Warning Filling
Percentage field then enter the desired value.

"

The Overflow Action Mode parameter:


this parameter is activated only once the CAL Maximum Size is
reached.
By clicking on the Overflow Action Mode option button, the
user can choose:
D

132 / 182

Wrap: on an alarm creation request, a certain number of


alarms, defined by the Overflow Purge Size parameter,
are purged (selection is operated according to the
purging sort criteria mentioned below) to allow the
insertion of the new alarm into the list. This is the default
mode.

3AL 88876 AAAA Ed. 01

7 Alarm Surveillance Administration

Note

Halt: the request concerning the creation of a new alarm


is discarded (consequently, the alarm is not created in the
CAL). In this case, no overflow purge occurs.

In the Halt mode, the new incoming alarms are definitively lost
until the CAL status comes back to warning.
"

The Overflow Purge Size parameter:


this parameter defines the number of alarms to be purged to
allow the insertion of new alarms in the CAL.
To define the parameter, click in the Overflow Purge Size
field then enter the desired value.

Purging Sort Criteria


Area

Alarms to be removed from the Current Alarm List when overflow


occurs (in Wrap mode) can be selected according to specified
criteria. For example, the user may want alarms of the less high
severity levels to be removed first. This can be done configuring
the Purging Sort Criteria area (figure 69):

Figure 69

CAL Administration Panel: Purging Sort Criteria Area

This area includes two lists:


"

Unselected Criteria: attributes which do not play a part in


the selection process

"

Selected Criteria: attributes which play such a role.

The user can move one or several attributes from a list to the other
one by selecting the desired items and then using the arrow
buttons.

3AL 88876 AAAA Ed. 01

133 / 182

7 Alarm Surveillance Administration

In the Selected criteria list (), the order of items represents the
order the corresponding attributes are considered in the
determination of the alarms to be kept or removed.
Note that the alarms to be removed are not the first but the last
appearing in the built list. It is possible to check the effects of the
sort by applying exactly the same criteria for displaying the
contents of the Main Alarm List. The candidates to the purge
appear at the bottom of the table.
For each attribute of the right list, the user can also specify the
order the values taken by this attribute are considered (Increasing
or Decreasing order). The current direction is indicated by the
option button on the right of the attribute name. To invert this
order, click on this button. Its label then changes (Incr or Decr).
Note

134 / 182

For boolean attributes such as Reservation Status, the set value


(e.g. reserved) is assimilated to 1, the unset value (e.g.
unreserved) to 0, which allows defining an ascending or
descending order.

3AL 88876 AAAA Ed. 01

7 Alarm Surveillance Administration

Statistics Area

See figure 70.

Figure 70

CAL Administration Panel: Statistics Area

This area is read-only. It informs the user of the current state of


the CAL.
Four pieces of information are given:
"

CAL Size: gives the current number of alarms contained in


the CAL. It corresponds to the displayed total number of
alarms in the Main Alarm List in the Counter Summary
window.

"

CAL Filling Percentage: gives the present filling state of the


CAL with respect to the CAL Maximum Size parameter.

"

CAL Status: computed from those parameters:


D

from empty (0 alarm) to the Warning Filling Percentage,


the status of the list is normal.

From the Warning Filling Percentage to the maximum size,


the status is warning.

When the number of alarms reaches the maximum value,


the status is overflow.

Users are instantaneously informed of changes of the CAL


status, through the real-time update of the information in the
bottom-right corner of the Counter Summary window (see
chapter 3).

3AL 88876 AAAA Ed. 01

135 / 182

7 Alarm Surveillance Administration

"

Note

136 / 182

ARS Connection Status: indicates whether ARS (third party


application for Trouble Ticket Management - see section 5.3)
is interfaced or not with AS, and whether it is correctly
working or not.

The Statistics area is refreshed either manually by the user or in


some cases by the IM. Sometimes misleading data may be
displayed in the CAL Size and CAL Filling Percentage fields (not
automatically refreshed by the IM). The user can retrieve the
correct information by clicking on the Reset push button at the
bottom of the window. WARNING: Using the Reset push button
cancels any modification you have previously done in the IM
Administration window.

3AL 88876 AAAA Ed. 01

7 Alarm Surveillance Administration

7.1.2

Archiving Filter Panel


When alarms are removed from the CAL, they are tested against
the Archiving Filter. If matching this filter, alarms are put in the
HAL. They may then be retrieved from there using the AS historical
part. Alarms leaving the CAL and not matching the archiving are
discarded.
Note

In particular, this means that setting a Match None archiving filter


(i.e. a filter that no alarm could match) would cause purged
alarms to be irremediably lost.

Note

Historical alarms are not available with 1320 Craft Terminal. They
are only operative with Network Management.

Figure 71

3AL 88876 AAAA Ed. 01

IM Administration Window: Archiving Filter Panel

137 / 182

7 Alarm Surveillance Administration

The default configuration of this filter is Match All (see figure 71).
That causes every alarm removed from the CAL to be effectively
archived (i.e. placed in the HAL).
The use of this panel is exactly the same as in the Filter panel for
the definition or modification of an Alarms Sublist (see paragraph
4.2.2).

7.1.3

Auto-Purge Panel
Automatic purging allows to automatically redirect some incoming
alarms to the HAL), avoiding their creation in the CAL.
The default configuration of this filter is Match None. That causes
every incoming alarm to enter the CAL, without any bypassing.
The use of this panel is exactly the same as in the Filter panel for
the definition or modification of an Alarms Sublist (see paragraph
4.2.2.)
Note

7.1.4

However, in the Auto-Purge panel, the Status area is greyed, and


so its elements cannot be accessed. AS does not support automatic
operations on alarms according to these statuses.

Auto-TT Panel
The access to this panel is enabled although the AS application is
not interfaced with the third party product ARS (from Remedy
Corporation). But in such a case its configuration is not
operational.
If the interface is installed, trouble ticket requests can be
automatically generated for some alarms and sent to ARS.
The default configuration of this filter is Match None. That means
that an incoming alarm never triggers the automatic creation of a
trouble ticket.
The use of this panel is exactly the same as in the Filter panel for
the definition or modification of an Alarms Sublist (see paragraph
4.2.2.).
Note

138 / 182

However, in the Auto-TT panel, the Status area is greyed, and so


its elements cannot be accessed. AS does not support automatic
operations on alarms according to these statuses.

3AL 88876 AAAA Ed. 01

7 Alarm Surveillance Administration

7.1.5

Auto-Ack Panel
Automatic acknowledgment is useful when the user wants
systematic acknowledgement of some alarms, on their incoming,
but prefers to avoid manual acknowledgement.
The default configuration of this filter is Match None, which means
that an incoming alarm is never automatically acknowledged.
The use of this panel is exactly the same as in the Filter panel for
the definition or modification of an Alarms Sublist (see paragraph
4.2.2).
Note

3AL 88876 AAAA Ed. 01

However, in the Auto-Ack panel, the Status area is greyed, and


so its elements cannot be accessed. AS does not support automatic
operations on alarms according to these statuses.

139 / 182

7 Alarm Surveillance Administration

7.2

Resynchronizing AS
The Current Alarms Main List displays the alarms emitted within
the system. It is real time refreshed. An alarm received by the AS is
immediately displayed on the screen, except in the case of
automatic purging.
Furthermore, since the CAL may become inconsistent with the
actual situation of the network, the user can explicitly initiate the
resynchronization of information concerning current alarms.
To request a resynchronization with local or external agents,
(depending on the configuration file):
"

in the Counter Summary window, use the menu path:


Option -> Synchronization

The following dialog box appears (figure 72):

Figure 72

Confirmation Dialog Box for Resyndhronizing AS

Click either on the Yes push button to perform the


synchronization, or on the No push button to abort. During the
synchronization phase, the following information box opens
(figure 73):

Figure 73

Information Dialog Box During the AS


Resynchronization

Alarms which were present in the CAL, and which are not
confirmed by the synchronization (i.e. that do not exist anymore
from the AS point of view) are automatically cleared by the AS
application. Thus, alarms that were previously acknowledged are
forwarded to the HAL, if matching the archiving filter.

140 / 182

3AL 88876 AAAA Ed. 01

7 Alarm Surveillance Administration

7.3

Accessing the Alarm Aging


The alarm aging consists of the definition of automatic actions
(acknowledgement, trouble ticket, purge requests, expiration task,
triggering and manual clear) performed periodically on alarms of
the CAL whose status (raised, acknowledged, cleared) is set since
a given time and an alarm filter is performed. All the conditions
are user defined. Several aging conditions may be active at the
same time.
The expiration task consists in setting a given AS alarm attribute
in order to inform the user that an alarm matches some
conditions. The user is then able to create a sublist filter based on
this attribute, so as to determine what kind of alarm is expired due
to an age exceeding on presence, (not) clearing or (not)
acknowledgement.
To access the alarm aging:
"

in the Counter Summary window, use the menu path:


Option -> Aging List -> Alarm Sources

The following window lists all the existing alarms aging (figure
74):

Figure 74

3AL 88876 AAAA Ed. 01

Alarm Aging List Window

141 / 182

7 Alarm Surveillance Administration

To manage the alarm aging from the Alarm Aging List window,
click on the Aging pull-down menu (see figure 75).
Aging

New
Delete
Activate
Deactivate
Open Aging View
Close Aging View
Close
Figure 75

Aging Pull-down Menu

By using the Aging pull-down menu, the user can:


"
"
"
"
"
"
"

142 / 182

create a New alarm aging (see section 7.3.1)


Delete an alarm aging (see section 7.3.7)
Activate an alarm aging (see section 7.3.5)
Deactivate an alarm aging (see section 7.3.6)
Open the alarm Aging View window (see section 7.3.2)
Close the alarm Aging View window
Close the current window

3AL 88876 AAAA Ed. 01

7 Alarm Surveillance Administration

7.3.1

Creating a New Alarm Aging


To add an alarm aging, use the menu path:
Aging -> New
The Alarm Aging Property window opens (see figure 76).

7.3.2

Open the Aging View


The user can also select an alarm aging and use the menu path:
Aging -> Open Aging View
The Alarm Aging Property window opens (see figure 76).
This window contains an Alarm Aging Name area and two panels:
"
"

Definition (see paragraph 7.3.3)


Filter (see paragraph 7.3.4)

After setting all the parameters in both panels, the user can save
them by clicking on the Save push button (on the top of the
window) and/or apply the alarm aging by clicking on the Apply
push button (at the bottom of the window).

Alarm Aging Name


Area

3AL 88876 AAAA Ed. 01

If the user accesses the Alarm Aging Property window by the Open
Aging View menu path, the Alarm Aging Name field is already
filled out. Otherwise the user has first to enter a Name.

143 / 182

7 Alarm Surveillance Administration

7.3.3

Definition Panel
The Definition panel describes the automatic action to be
performed on alarms (see figure 76).

Figure 76

Alarm Aging Identification Window: Definition Panel

The Definition panel includes three areas:

144 / 182

"

the On Alarms area allows the user to choose the alarm, on


which the automatic action will be applied, by specifying its
original state (present or not, acknowledged or not, cleared
or not)

"

the Do area allows the user to set the automatic actions

"

the Every area allows the user to set the frequency of the
automatic actions.

3AL 88876 AAAA Ed. 01

7 Alarm Surveillance Administration

7.3.4

Filter Panel
The Filter panel (see figure 77) allows the user to select (by
applying filtering criteria) the alarms on which these automatic
actions will be applied.
The use of the Filter panel is exactly the same as in the Sublist
Properties window (see paragraph 4.2.2).

Figure 77

3AL 88876 AAAA Ed. 01

Alarm Aging Identification Window: Filter Panel

145 / 182

7 Alarm Surveillance Administration

7.3.5

Activate an Alarm Aging


To activate an alarm aging, first select it in the list, then use the
menu path:
Aging -> Activate
The Alarm Aging List is updated (see figure 78):

Figure 78
Note

7.3.6

Alarm Aging List Window updated

When the user creates a new aging the status is Activated by


default.

Deactivate an Alarm Aging


To inactivate an alarm aging, select it in the list, then use the menu
path:
Aging -> Deactivate
The status of the alarm aging will be Deactivated in the Alarm
Aging List window (see figure 78).

146 / 182

3AL 88876 AAAA Ed. 01

7 Alarm Surveillance Administration

7.3.7

Delete an Alarm Aging


To delete an alarm aging, select it in the list, then use the menu
path:
Aging -> Delete
The deleted aging disappears from the Aging List window.

7.3.8

Alarm Aging List Menu Bar


The Alarm Aging List menu bar contains other pull-down menus.
"

The Display pull-down menu (see figure 79):

Display
Inactive Agings
Hidden columns
Auto-Raise

Figure 79

Display Pull-down Menu

The Display pull-down menu includes the following options:


D

Inactive Agings: if this option is activated, the user can


see the inactive sublists (see figure 16).

Figure 80

3AL 88876 AAAA Ed. 01

Inactive Alarm Aging List Window

147 / 182

7 Alarm Surveillance Administration

"

Hidden columns: this option allows the user to see the


columns which have been hidden.

Auto-Raise: for current alarms, if this option is


activated, the Counter Summary window will be
reactivated by incoming alarms and the sublist will be
automatically updated.

The Navigation menu (see figure 81):

Navigation
Summary
>
Sublists
Report...
Archive...
External Application

Figure 81

OPEN SUBLISTS

Navigation Pull-down Menu

By using the Navigation pull-down menu, the user can:


D
D
D
D
D

navigate to the Counter Summary window (see section


9.1)
navigate through the Sublists (see section 9.2)
get a Report on performed actions (see section 9.3)
navigate to the Archive (see section 9.4)
send alarm information towards an External Application
(see section 9.5)

These menus are the same in the Trigger List window menu bar.

148 / 182

3AL 88876 AAAA Ed. 01

7 Alarm Surveillance Administration

7.4

Accessing the Script Triggering


The script triggering consists in raising some external actions when
an alarm is being inserted in the CAL.
The AS IM sends automatically to the triggering server a command
message (script or navigation order) when the number of alarms
crossing up or down user defined threshold conditions associated
to a given triggering filter. These threshold conditions consist of a
number of alarms present in the CAL which can be defined
separately for the crossing up threshold and for the crossing down
threshold. For each threshold a specific navigation message is
sent.
The triggering server is in charge of executing the script or
navigation order sent by the AS IM.
Note

Be aware the external action is performed from the machine


where the triggering server is running (and not from the machine
where the AS IM is installed).
You can find more information in section 4.2.8.
The IM Triggering mechanism permits to carry out some trigger
mechanisms without the need of some active Current-USM
sessions. Only the AS Current IMs are required here as regards to
the trigger execution. The operator may quit an AS Current-USM,
and then release the AS IM-USM communication connection, but
his configured trigger filters will remain active at the AS
Current-IM level.
This functionality can be used to trigger some operations in
association with the alarm aging, by using some current alarm
filters based upon the expiration status: activation/deactivation of
scripts when crossing up/down threshold conditions as regards to
the number of alarms not acknowledged in an expected time.
To access the script triggering:
"

in the Counter Summary window, use the menu path :


Option -> Trigger List -> Alarm Sources

The following window lists all the existing triggers (figure 82):

3AL 88876 AAAA Ed. 01

149 / 182

7 Alarm Surveillance Administration

Figure 82

Trigger List Window

To manage the triggers from the Trigger List window, click on the
Trigger pull-down menu (see figure 83).
Trigger

New
Delete
Activate
Deactivate
Open Trigger View
Close Trigger View
Close
Figure 83

Trigger Pull-down Menu

By using the Trigger pull-down menu, the user can:


"
"
"
"
"
"
"

150 / 182

create a New trigger (see section 7.4.1)


Delete a trigger (see section 7.3.7)
Activate a trigger (see section 7.4.5)
Deactivate a trigger (see section 7.4.6)
Open the Trigger View window (see section 7.4.2)
Close the Trigger View window
Close the current window

3AL 88876 AAAA Ed. 01

7 Alarm Surveillance Administration

7.4.1

Creating a New Trigger


To add a trigger, use the menu path:
Trigger -> New
The Trigger Property window opens (see figure 84).

7.4.2

Open the Trigger View


The user can also select one in the list and use the menu path:
Trigger -> Open Trigger View
The Trigger Property windows opens (see figure 84). This window
contains a Trigger Name area and two panels.
"
"

Definition (see paragraph 7.4.3)


Filter (see paragraph 7.4.4)

After setting all the parameters in both panels, the user can save
them by clicking on the Save push button (on the top of the
window) and/or apply the trigger by clicking on the Apply push
button (at the bottom of the window).

Trigger Name Area

3AL 88876 AAAA Ed. 01

If the user accessed the Trigger Property window by the Open


Trigger View menu path, the Trigger Name field is already filled
out. Otherwise the user has first to enter a name.

151 / 182

7 Alarm Surveillance Administration

7.4.3

Definition Panel
The Definition panel describes the threshold conditions (figure 84).

Figure 84

Trigger Identification Window: Definition Panel

The Definition panel is composed only of the Trigger area which


allows the user to choose the script to be performed and the
threshold conditions. To set these conditions, see paragraph
4.2.8.

152 / 182

3AL 88876 AAAA Ed. 01

7 Alarm Surveillance Administration

The script command can be used with control characters which


are interpreted by the IM process. The following substitutions are
performed on the script string:
%% -> %
%n -> trigger name
%d -> threshold crossing direction: > for high threshold
crossing, < for low threshold crossing
%l -> trigger threshold level
%v -> trigger crossing value (number of alarms matching the
trigger when it was raised)
%p -> previous trigger value (number of alarms matching the
trigger before it was raised)
%o -> trigger owner name
%t -> GMT time when this trigger threshold was crossed.
Any other control character (following the %) is ignored.
Note

3AL 88876 AAAA Ed. 01

Arguments may be provided to the scrips/programs. The


scripts/programs are executed by the script triggering server in the
environment of the machine on which it is located.

153 / 182

7 Alarm Surveillance Administration

7.4.4

Filter Panel
This panel (see figure 85) allows the user to select (by applying
filtering criteria) the alarms on which this trigger will be applied.
The use of the Filter panel is exactly the same as in the Sublist
Properties window (see paragraph 4.2.2).

Figure 85

154 / 182

Trigger Identification Window: Filter Panel

3AL 88876 AAAA Ed. 01

7 Alarm Surveillance Administration

7.4.5

Activate a Trigger
To activate a trigger, first select it in the list, then use the menu
path:
Trigger -> Activate
The Trigger List is updated (see figure 86):

Figure 86
Note

3AL 88876 AAAA Ed. 01

Trigger List Window updated

When the user creates a new trigger the status is Activated by


default.

155 / 182

7 Alarm Surveillance Administration

7.4.6

Deactivate a Trigger
To inactivate a trigger, select it in the Trigger List window, then use
the menu path:
Trigger -> Deactivate
The status of the trigger will be Deactivated in the Trigger List
window (see figure 87).

Figure 87

7.4.7

Trigger List Window updated

Delete a Trigger
To delete a trigger, select it in the Trigger List window, then use the
menu path:
Trigger -> Delete
The selected trigger will disappear from the Trigger List window.

156 / 182

3AL 88876 AAAA Ed. 01

8 Archived Alarm Retrieval

8 Archived Alarm Retrieval


This chapter concerns only the historical alarms (see section 3.2).
Note

Historical alarms are not available with 1320 Craft Terminal.


They are only operative with Network Management.
The user can retrieve alarms:
"

From one or several public archives (local and externals). A


public archive is a storage database containing a set of alarm
information and managed by the AS Current IM.

"

From a set of user files.

A retrieval operation can be analyzed as the succession of several


phases:
"

Selecting a single source among the three possibilities offered.


In the public archive case, the user may select the local one or
one of the external ones, depending on the configuration file.

"

Defining the filter to be applied to this source.

"

Deciding whether the set of alarms resulting from the retrieval


will overwrite the current content of the Main List or will be
appended to it.

"

Retrieving the alarms from the source, with the possibility to


stop the process at any moment.

By performing several successive retrieval operations and using


the append option, it is possible to build a Main List containing
alarms of various origins.
Duplicated alarms (i.e. alarms retrieved from a source but already
loaded from another) are discarded to keep a single instance.
Note also that it is possible to apply different types of filters or
variants on the different sources.

3AL 88876 AAAa Ed. 01

157 / 182

8 Archived Alarm Retrieval

To retrieve archived alarms, from the Counter Summary window,


click on the Archive pull-down menu (see figure 88):
Archive
Retrieve from Public Archive...>
Retrieve from User Files...
Remove User Files...

Figure 88

Archive Pull-down Menu

By using the Archive pull-down menu, the user can:


"
"
"

158 / 182

Retrieve alarms from Public Archive... (see section 8.1)


Retrieve alarms from User Files... (see section 8.2)
Remove User Files... (see section 8.3)

3AL 88876 AAAA Ed. 01

8 Archived Alarm Retrieval

8.1

Retrieving Archived Alarms from Public Archive

Choose the Archive


Source

To choose the archive source, from the historical Counter Summary


window:
"

use the menu path:


Archive -> Retrieve from Public Archive

Note

When selecting Retrieve from Public Archive, a cascading menu


appears, displaying all the public archives (local and external) the
user may access. Select one public archive.
The following Main Filter window opens (figure 89).

3AL 88876 AAAa Ed. 01

159 / 182

8 Archived Alarm Retrieval

Figure 89

Main Filter : Public Archive Window

A full description of the panel organization of the Main Filter


window and of the operation in the various groups takes place in
paragraph 4.2.2 (Filter sub-panels) to paragraph 4.2.6.

160 / 182

3AL 88876 AAAA Ed. 01

8 Archived Alarm Retrieval

Apply the Main Filter

Clicking on the Apply push button of the Main Filter window


allows the user to enter the next step of the process. He has to
answer the following Question window (see figure 90).

Figure 90

Retrieval Operation: Appending or Overwriting

"

Click on the Cancel push button to abort the retrieval


operation.

"

Click on the No push button to overwrite the current content


of the Main List.

"

Click on the Yes push button to keep the current content or


the Main List and append the alarms to be retrieved.

Whatever the user's choice in this Question window (excepting


Cancel), another confirmation window opens (figure 91, which
corresponds to the 'overwrite' case. The message differs in the
'append' case).

3AL 88876 AAAa Ed. 01

161 / 182

8 Archived Alarm Retrieval

Figure 91

Retrieval Operation: Confirming the Overwriting

Performing the retrieval causes a global change of the contents of


all the sublists, since the sublists correspond to limited views of the
Main List, whose content is to be revised.
"

Click on the Yes push button to go on. The sublists are closed,
if previously open, and made empty, but their characteristics
(especially the related filter) are kept. To regenerate their
content, just open them again.

"

Otherwise, click on the No push button to abort the retrieval


operation and keep the Main List and the sublists unchanged.

Clicking on the Yes push button initiates the retrieval from the
selected source. The user will continuously be informed of the
progress of the retrieval operation by the updated counters of the
Counter Summary window and by the following Filling Percentage
window (see figure 92):

162 / 182

3AL 88876 AAAA Ed. 01

8 Archived Alarm Retrieval

Figure 92

Retrieval Operation: Filling Percentage Window

If desired, the retrieval operation can be stopped at any moment


by clicking on the Stop push button. In this case a confirmation
window pops up.
In case of confirmation, the actual stopping may take some time.
In any case, the alarms already retrieved are displayed in the list.
The retrieval operation may failed (time out exceeded). The
following Error dialog box then pops up:

Figure 93

Retrieval Operation: Error Dialog Box

This message means no response has been reported since a lapse


of time, defined in the configuration file (parameter
GET_TIMEOUT from param.cfg file).

3AL 88876 AAAa Ed. 01

163 / 182

8 Archived Alarm Retrieval

8.2

Retrieving Archived Alarms from User Files


To retrieve archived alarms from user files:
"

in the historical Counter Summary window, use the menu path:


Archive -> Retrieve from User Files

The following dialog box opens (figure 94):

Figure 94

User Source File: Retrieve Dialog Box

This dialog box includes two lists:


"
"

one (Excluded User Files) for the user files not to be used for
retrieval
the other one (Included User Files) for the user files to be
used for the retrieval

The user can move one or several attributes from a list to the other
one, by selecting the desired items then using the arrow buttons.
Click on the Ok push button to enter the retrieval process itself, as
described in section 8.1, with first the definition of the filter to be
used.

164 / 182

3AL 88876 AAAA Ed. 01

8 Archived Alarm Retrieval

8.3

Removing User Files


To remove a set of user files:
"

in the historical Counter Summary window, use the menu path:


Archive -> Remove User Files

The same dialog box as above opens (see figure 94). Operate in
the same way.
Click on Ok to actually delete the chosen files.

3AL 88876 AAAa Ed. 01

165 / 182

8 Archived Alarm Retrieval

166 / 182

3AL 88876 AAAA Ed. 01

9 Navigation Features

9 Navigation Features
AS provides some navigation features in order to improve the
handling of the application.
To choose the destination from the Counter Summary window (see
chapter 3), or from any Alarm Sublist window (see section 4.6),
click on the Navigation pull-down menu (see figure 95):
Navigation
Summary
>
Sublists
Report...
Current...
Archive...
PNM...
External Application

Figure 95

OPEN SUBLISTS
MAIN ALARM LIST
Ne_Nantes

Navigation Pull-down Menu

By using the Navigation pull-down menu, the user can:


"
"
"
"
"
"

3AL 88876 AAAA Ed. 01

navigate to the Counter Summary window (see section 9.1)


navigate through the Sublists (see section 9.2)
get a Report on performed actions (see section 9.3)
navigate between the Current alarms and the Archive (see
section 9.4)
send alarm information towards an External Application
(see section 9.5)
navigation to PNM is not a supported option

167 / 182

9 Navigation Features

9.1

Navigating to the Counter Summary


To navigate from a current or historical Alarm Sublist window to
the relevant Counter Summary window:
"

use the menu path:


Navigation -> Summary

A Counter Summary window for current or historical alarms opens


(see figures 14 and 16).

168 / 182

3AL 88876 AAAA Ed. 01

9 Navigation Features

9.2

Navigating through the Sublists


To navigate through several open Alarm Sublists:
"

use the menu path:


Navigation -> Sublists

It is necessary to select a sublist name among the proposed items:


"
"

the Main Alarm List


a specific sublist (named Ne_Nantes, in the example of figure
95)

Note that only currently open sublists (for the considered subset current or historical alarms - of the application) are presented in
this dynamic menu, and not the whole set of existing sublists.
This menu also does not include (in current alarms management
case) the Alarm Sublist windows obtained through the Correlated
Alarms command (see section 6.2).
To access sublist that are not currently open, first select the Open
option from the Sublist pull-down menu (see section 4.6).

3AL 88876 AAAA Ed. 01

169 / 182

9 Navigation Features

9.3

Getting Reports on Performed Actions


After an action has been launched on the user's request, it may be
useful to visualize a report offering detailed information about the
progress or achievement (successful or not) of this action. For
example, the user may try to manually purge alarms whereas
some of these alarms have been previously reserved by another
user. The operation will succeed for some alarms and fail for
others. This kind of cases is reported by the AS.
To get the report about an action:
"

use the menu path:


Navigation -> Report...

A window opens, displaying the list of successive actions and their


status report (figure 96).

Figure 96

Report Window

This window includes three parts:


"
"
"

170 / 182

a menu bar
a Report List
a Report Detail area

3AL 88876 AAAA Ed. 01

9 Navigation Features

Menu Bar

The menu bar includes the following pull-down menus (see figure
97).
Report
Report
Delete...
Clear
Close

Figure 97

Display
Display
All Attributes
AutoRaise

Pull-down Menus of the Report Window

By using the Report pull-down menu, the user can:


"
"
"

Delete a report (see paragraph 9.3.1)


Clear a report list (see paragraph 9.3.2)
Close a report window

By using the Display pull-down menu, the user can:


"

3AL 88876 AAAA Ed. 01

configure the report display (see paragraph 9.3.3)

171 / 182

9 Navigation Features

Report List Area

This area is a table including four columns:


"
"
"

Date & Time: date and time the action was sent
Source: source the alarm is coming from
Type: type of the performed action. The different types are as
follows:
D
D
D
D
D
D
D
D
D
D
D
D
D
D
D
D
D
D
D

"

172 / 182

Get Alarm List Attributes


Get All Alarms
Get More Alarm Info
Get Correlated Alarms
Set Alarm List Attributes
Set User Note
Reserve Alarms
Unreserve Alarms
Acknowledge Alarms
Create Trouble Ticket
Manually Purge Alarms
Synchronize Application
Create EFD
Set Administrative Parameters
Get Alarm List Aging Attributes
Get Alarm List Trigger Attributes
Update Overflow Status
Connexion broken
Information

Status: status of the performed action. Five different statuses


are managed. They are mapped to the colours of the default
severity levels:
D

Aborted (Minor severity level colour): request has not


been sent.

Failure (Critical severity level colour): request failed.

Success (Cleared severity level colour): request


succeeded.

Half Success (Major severity level colour): request


partially succeeded. In this case, read the report details in
order to find out what failed in the request.

In Progress (Indeterminate severity level colour): request


is ongoing.

3AL 88876 AAAA Ed. 01

9 Navigation Features

Report Detail Area

This area provides the view with additional information on the


action selected in the report list.

Note

The report window is updated each time an action is initiated. The


new action is inserted at the top of the list.

Note

The report window automatically opens up each time an action


request result is Aborted or Failure in order to allow the user to get
details on the failed action.

3AL 88876 AAAA Ed. 01

173 / 182

9 Navigation Features

9.3.1

Deleting a Report
The user can delete reports for some selected actions.
Clearing the whole report window, as presented in the next
paragraph, may be sometimes an inadequate solution, so the user
can also delete a single or some report items after having selected
them. The reports must correspond to terminated actions.
To delete some report items:
"

First select the corresponding lines in the report list.

"

Use the menu path:


Report -> Delete...

9.3.2

Clearing the Report List


The user can clear the whole report list, reinitializing it in the
mean time.
Clearing the report list will cause all terminated actions displayed
in the report list to disappear, keeping the actions in progress.
To clear the report list:
"

use the menu path:


Report -> Clear

9.3.3

Configuring the Report Display


To configure the report display, use the following items of the
Display pull-down menu (see figure 97).

174 / 182

"

All Attributes: to recover the columns the user may have


previously removed by double clicking on their titles.

"

Auto-Raise: when checked, this option allows the report


window to be systematically brought on top when an action is
performed. This allows the user to control the progress and
the result of this action.

3AL 88876 AAAA Ed. 01

9 Navigation Features

9.4

Navigating between the CAL and the HAL


To navigate between the two Counter Summary windows (current
and historical, see chapter 3):
"

use the menu path:


Navigation -> Archive... (or Current...)

Note

3AL 88876 AAAA Ed. 01

If the Alarm List the user wants to navigate to is not running, the
result of the request is the starting up of this part. If it is running, it
is brought on top.

175 / 182

9 Navigation Features

9.5

Sending Alarm Information towards an External


Application
The user can also navigate to an external application. This
navigation feature has to be configured during the installation
phase.
To navigate to a particular external application:
"

Use the menu path:


Navigation -> External Application

"

Select an external application among the proposed items.

This operation allows to export information related to a single


alarm and to treat this information in this external application (this
treatment may be of any kind, but a spreadsheet application can
be a typical example).
Applying to a single selected alarm, this operation is not available
from the Counter Summary window, but from any sublist window.
In such a window, select first the alarm in the table and then select
the option from the menu.
Note

176 / 182

In case of multiple alarms selection, the navigation to the external


application is omitted.

3AL 88876 AAAA Ed. 01

10

Terminology

10 Terminology
10.1

Abbreviations

3AL 88876 AAAA Ed. 01

ALMAP

Alcatel Management Platform

ARS

Action Request System (Trouble Ticket third party


Product of Remedy)

AS

Alarm Surveillance

CAL

Current Alarm List

CNE

Composite NE

ELM

EFD and Log Management

FDN

Full Distinguished Name

GUI

Graphical User Interface

HAL

Historical Alarm List

HMI

Human Machine Interface

MOC

Managed Object Class

MOI

Managed Object Instance

NE

Network Element

OVW

Open View Window

PNM

Physical Network Management

TMN

Telecommunications Management Network

TN

Telecommunications Network

TT

Trouble Ticket

TVA

Topology Viewer Application

177 / 182

10
Terminology

10.2

Glossary
Acknowledgement
When an alarm is taken into account by the application, the user
has to acknowledge it to point out that he has seen it and that he
will react in the right way.
Acknowledgement status
This attribute indicates whether the reported alarm has been
acknowledged or not.
Additional information
Optional attribute of an alarm wich consists in structured
information that is used to define sublists characteristics.
Additional text
This optional information allows a free form text description to be
reported.
Alarm
An alerting indication to a condition that may have an immediate
or potentially negative impact on the state of a communication
resource. An alarm is characterized by an alarm begin and an
alarm end.
Archiving filter
Alarms which are removed from the CAL (whatever the reason)
are tested against this filter. If matching it, they are archived in the
Historical Alarms List (HAL) and they can be retrieved from it using
the AS historical part commands and operations.
Clearable
The alarm status is clearable if it can be cleared by the operator.
Clearing status
This attribute indicates whether the reported alarm has been
cleared or not.
Correlated notification
This optional attribute indicates a link of an alarm to a set of other
alarms identified by a Notification Identifier and their relative
Object instance.
Correlated Notification Flag (in the CAL only)
This attribute is set to YES when a Correlated Notification is sent
together with the reported alarm.
Event date & time
This parameter gives the local date and time when the alarm
notification has been detected.

178 / 182

3AL 88876 AAAA Ed. 01

10

Terminology

Event type
This parameter categories the alarm.
Expiration status
This attribute take the value notExpired when the alarm arises.
After a certain date or conditions defined by the Alarm Aging
machanism (present, (not)cleared or (not)acknowledged since a
given time, it takes a corresponding combination among the
following set of values: present-, acknowledge-,
notAcknowledge-, clear- or notClearExpired.
Filter
They are related to the alarms or events generated on an NE.
They can be configured by a user to reject specified types of
notifications and limit the processing that is applied to them.
Friendly name
Name of a managed entity.
Human Machine Interface
It is the graphical user interface application through which the
users interact with the system.
Insertion Cause (in the HAL only)
This parameter indicates which processing causes the alarm to be
archived. It can be one of the following:
"
"
"
"
"
"
"

Overflow purge
Manual purge
Automatic purge
Acknowledging a cleared alarm (or the inverse)
Synchronization
AS IM Modification
Invalidation

Logging time (in the HAL only)


This parameter gives the local time when the alarm was put in the
HAL.
Managed object class
This attribute specifies the class of the managed object in which
the event emitted by the agent occurred.
Managed object instance
This attribute specifies the instance of the managed object in
which the event emitted by the agent occurred.
Monitored attributes
These attributes are monitored by AS and can contain one or
more attributes belonging to the following set:

3AL 88876 AAAA Ed. 01

179 / 182

10
Terminology
"

alarm status: this attribute can have one of the following


values: Cleared, activeReportable - Indeterminate,
activeReportable - Warning, activeReportable - Minor,
activeReportable - Major, activeReportable - Critical,
activePending.

"

Availability status: this attribute can have zero or more of the


following values: In test, Failed, Power off, Off line, Off duty,
Dependency, Degraded, Not installed, Log full.

"

Administrative state: this attribute can have three different


values: locked, unlocked and shutting down.

"

Location name: this attribute identifies a location.

"

Operational state: this attribute indicates whether or not the


resource associated to the managed object is physically
installed and working.

"

Usage state: this attribute indicates the usage of the resource


associated to the managed object with regards to three
possible values: Idle, Active and Busy.

"

User label: this optional attribute contains the Friendly Name


information. The Friendly Name is used to give meaningful
user friendly information on the alarm origin.

"

Vendor name: this attribute identifies the vendor of the


associated managed object.

"

Version: this attribute identifies the version of the associated


managed object.

"

Access control domain: this optional attribute identifies the


domain to which the alarm belongs.

Network Element (NE)


Either a telecommunication equipment or groups parts of a
Telecommunication Network. Have characteristics compliant with
ITU-T recommendations.
Notification
Spontaneous data received by the system concerning an NE.
Notification identifier
This parameter, when present, provides an identifier for the
notification, which may be carried in the correlated notifications
parameter of future notifications.
Overflow
The CAL can only contain a limited number of alarm instances,
that you can defined. Once this number is reached, overflow
purge occurs that you can customize.

180 / 182

3AL 88876 AAAA Ed. 01

10

Terminology

Perceived severity
This parameter defines six severity levels, which provide an
indication of how it is perceived that the capability of the managed
object has been affected.
Probable cause
This parameter defines further qualification as to the probable
cause of the alarm.
Proposed repair actions
This optional attribute consists of a set of elements, each indicating
a possible solution for solving the present alarm.
Repetition counter
This parameter indicates the number of times an alarm was sent
by an agent.
Reservation status
This attribute indicates whether the alarm has been reserved by a
user or not.
Severity
See Perceived Severity.
Specific problems
This optional attribute consists of a set of possible values
complementary to the probable cause.
State change definition
This optional attribute is used to indicate a state transition
associated with the alarm.
Telecommunication Network
Describes the network to be managed. Provides the transmission,
the transport and the switching supports to the interconnected
Network Elements.
Threshold information
This optional attribute indicates information relative to the crossing
of a threshold that implied the emission of the alarm.
Trend indication
This optional information specifies the current severity trend of the
managed object. The following values can be taken by this
attribute:

3AL 88876 AAAA Ed. 01

"

more severe: with regards to alarms notified previously, this


alarm has a higher perceived severity.

"

No change: with regards to alarms notified previously, the


perceived severity of this alarm is equal to the highest severity
of alarms notified previously.

181 / 182

10
Terminology
"

Less severe: this alarm has not the highest severity of the set
of alarm impacting the same object instance.

Wrapping
Wrapping is the technique that enables the most recent entries in
a file to replace the oldest when a file is full.

END OF DOCUMENT

182 / 182

3AL 88876 AAAA Ed. 01

You might also like