Alarm and Event System
Alarm and Event System
Description
The event system handles the notification of system and process alarms as well as messages.
To fully understand all of the event system description, you should have a good understanding of the
module and the distributed control system concepts.
An event is a notification to the operator of some condition in the system or the controlled process that
may need attention. Which events are to be notified to the operator, depends on which list is displayed
and which filter is selected.
The Event Server in AIM maintains lists of the newest alarms while the state of all alarms in the system
is kept by the SBC. In the different event views both dynamic and static presentations can be generated.
Furthermore, the user can control the selection of what is displayed in the event views by means of
'filters'. System defined filters are associated with each list, but you can specify filters that suit specific
needs. There is one list for each client connected to the event server.
Alarm line
Event List image
Event popup
Event decoration
Audible alarm - a summary alarm indication
Alarm indication by means of color coding and flashing effect in the graphic presentation of
modules in flow and process images.
Event pages
The dynamic and static pages are view-ports along the imaginary list of alarms in the system.
The historic page is a view-port in the event log.
The dynamic alarm page is a view-port that moves automatically along the list of alarms in step with the
most recent alarm in the system. The dynamic alarm page has a limited length: As the list is filled up,
the oldest alarms are pushed out while the most recent ones are added to the top of the list.
Look up the dynamic alarm page to get a survey of the current alarm situation.
The static alarm page is a view-port that can be moved by the user along the entire list of alarms. The
static alarm page is updated as major changes occur to alarms in the page. However, new alarms are not
added.
Look up the static alarm page when you want a more exhaustive but less flickering picture for the alarms
in question. As the dynamic page is filled up, the time span covered by the static page is older than the
one in the dynamic page.
The dynamic event page is only a display of events and changes of events.
The historic event page is a view-port along the event database. I.e. it is a pure log of all events that
occur. Within the limits of the event database, you can define the time span to be covered by the historic
event page. While an alarm can appear only once in the dynamic and static page, it appears as many
times in the historic event page as there are changes - minor and major - in its state.
Use the Historic event page whenever you need to analyze the evolution of events.
Dynamic and static alarm pages behave in a similar way: both pages are updated upon alarm changes
but static pages are snapshots of the situation at the time the page was opened. That means that the
dynamic alarm page always displays the most recent alarms. The static page, however, will is updated
with new alarms only each time it is opened. I.e. when focus is moved from the Dynamic Alarm Page to
the Static Alarm Page. Alarms that are acknowledged and return to the normal or void state are
removed.
All pages, except the Historical Event page, have a fixed length: I.e. as alarms are added to the top of the
page, older ones are pushed down or out of the page. The length of the Historical Event page depends on
how many events that pass the filter and the time span.
Note that the static and dynamic page normally have the same filters.
Upon creation of an Event List image, popup or decoration, the default filter is applied to all pages.
However, you can change to any other available filters. When the static/dynamic page is selected from
the dynamic/static page, the latest selected page inherits the filter from the latter. However, if the
previous page was the historic page, the latest selected filter for the page in question is used.
Related topics
The dynamic event page is only a display of events and changes of events. The events are displayed as
they occur and according to the selected filter. The dynamic event page can not be operated.
While the dynamic and static alarm pages are fed by the Event Server, the historic event page fetches
information from the event database. The historic event page acts like a log, the dynamic and static
pages act like 'indicators and controls'. That makes it obvious why alarms can not be acknowledged from
the historic event page.
The historic event page lets the user query the event database. The database query is defined by the
applied filter and the user defined time span.
All functions related to historic event page operation are available from the context menu and the event
toolbar.
The universal event filter is the system default for the historic event page. That means that all events are
passed through. Historic event presentation requires that an ODBC data source name is defined and that
appropriate event storage parameters are set.
The vertical scroll bar of the historic event page lets you navigate within
the defined time span: When you operate the scroll bar a message box
displays the time stamp of the event that will appear in the top row of the
event page.
Historic event presentation requires that the data source name 'OSKEventDb', using the Microsoft
Access Driver (*.mdb) is defined on the OS. The User Data Source must point to the database file
defined in the OS specific EventStore parameter 'DBLocation'. The default path for the event database is
C:\lev\db\event.mdb.
Event presentation
There are several presentation alternatives for displaying alarms and messages on the OS.
Last Alarm line: A fixed area in the primary image window that is always visible, displaying the
last unacknowledged alarm. It is only displayed in the primary image window, and is always
visible, independent of the selected image type.
Event List: A listing of alarms within the image pane of any OS image window. The Event List is
selected from the icon in the toolbar. The Event List may include several 'pages': dynamic and
static alarm pages, dynamic event page and historic event page. Each page provides a specific
view of the events.
Event Popup: A free floating and resizable window, similar to the Event List. The popup window
is selected from the icon in the toolbar. The Event List may include several 'pages': dynamic
and static alarm pages, dynamic event page and historic event page. The operation of the event
popup window is identical with the operation of the Event List images.
Event Decoration: Any event view can be displayed in an Event Decoration. An Event
Decoration can be glued into any image that supports decorations. The Event Decoration may
include several 'pages': Dynamic and static alarm pages, dynamic event page and the historic
event page.
The display format is similar to a worksheet and identical for all presentation alternatives. The actual
layout (column order, width, etc.) is a matter of OS configuration.
In addition to the tabular presentations, alarm indication is included in flow and process images.
Related topics
Users with appropriate configuration privileges may define as many named Event List images as
applicable. These images may be configured into the different Image window navigators of the OS.
An Event List image occupies the entire main work area of the AIM OS window.
Tabs at the bottom of the image pane allows you to select among different 'pages': Dynamic alarm
page, Static alarm page, Historic event page and the Dynamic Event Page. Clicking a tab, displays
the corresponding page.
Toolbar
The functions connected to the controls in the Event List image specific toolbar are:
Acknowledge. The button is available when there are unacknowledged alarms from controlled sources
The buttons are not available when the dynamic page is displayed.
In the static page, the buttons let you page up and down through all available alarms. When paging thro
gathered from the relevant stations.
In historic event page, the buttons let you move the time span forwards (up) or backwards (down).
Displays the Select filter dialog box.
Refreshes the current page. In dynamic pages, the function deletes the current records and collects new
In historic pages, a new query is sent to the event database.
The button is available with historic pages only. It displays the Date and Time dialog box.
The button is available with historic pages only. The function is available during database reading only
selection.
Status line
However, if the status is not 'OK', this field displays a data gathering error message to announce that the
contents of the page may be incorrect.
On the historic event page, the status line displays the database status, the number of records and the
time span currently displayed. Upon error, an error message is displayed.
Related topics
Event attributes
Systematic handling and notification and presentation of events requires all events to be specified by
means of a set of attributes. Some of the attributes are represented by descriptive text found in SysConf
section Global.Event.System.EventImage. The text representation is used in the alarm line and in the
different views. Relevant event attributes are:
Time The time (local and UTC time) at which the reported condition occurred.
Originator Identification of the PS/PS group that issued the event.
Priority Each event is associated with a 'priority' level. The four priority levels are
denoted, in increasing order, by the numbers 0 through 3.
Type Description of the event or state that caused the event (reason).
Command Optional attribute, applicable for alarms only. An identification of the command
group group related to the alarm.
Text A description of the issuing module that can be understood by the operator. e.g.
"pump", "generator" etc.
Tag, Terminal Tag and Terminal denote the source of process events. The fields are used in
case of system events too.
Description Optional attribute. The module description associated with the tag.
Alarm state Applicable for alarms only. High, HighHigh, etc. or DigAlActive
Add. value Optional attribute. A value related to the event
Members Process stations in the PS group that initiates the event.
Event types
The exact event type names, used in event and alarm lists, are not necessarily identical to those used in
the table above. The name associated with each event type is set in the Global/Event
System/EventImage configuration parameter group 'Type Names' in the SysConf database.
Alarm limits
Digital alarms are either active or not (VOID and NORMAL). For alarms on analog terminals, however
the active state is further refined by means of alarm limits via the Analog Alarm Limits dialog box as
illustrated below:
An analog alarm is in 'normal' or 'void' state as long as the terminal value remains within the High
and Low alarm limits. In other words, the alarm is not active.
The alarm becomes active when the terminal has reached the High or Low alarm limits but is
within the HighHigh or LowLow alarm limits.
When the terminal value has reached the HighHigh or LowLow alarm limits but is within the
High Scale or Low Scale, a new limit is passed.
The highest alarm limit is reached when the terminal value equals or exceeds the Scale High or
Scale Low limits.
Related topics
Alarm acknowledgement
Whether an alarm needs acknowledgement depends on its priority level. The priority level that marks
the limit is set in the Global/Event System configuration parameter: 'AckLimit'. All events with a priority
level at or above the 'AckLimit' need to be acknowledged. There is one exception: At OS start-up, the
'station availability' alarms caused by missing response from some station do not require
acknowledgement.
Acknowledgment authority
The authority to acknowledge alarms is built on command control and access system configuration:
An OS can only acknowledge those process alarms that are originated by the modules controlled
by that OS. This authority is exclusive: Process alarm can not be acknowledged from an OS that
does not control the source module.
An OS can acknowledge system alarms originated by itself or by controlled Process station. A PS
is controlled by the OS when it contains a module under a command group that is controlled by
the OS in question.
An OS can acknowledge system alarms for not-controlled PS, if the Global/Event
System/Privileges configuration parameter 'Ack Extended' is set to 'TRUE'.
Acknowledging methods
Using the Ack option in the context menu of the dynamic and static alarm list and the last alarm
line.
Using the in the Event List image or event dialog toolbar.
Using the ACK key on dedicated AIM operator panels.
The authority to acknowledge alarms from the OS in question is indicated in the left most column of the
list.
The effect of these actions depends on whether unacknowledged alarms are selected:
When one or several unacknowledged alarms are selected, the acknowledge action applies to
selected alarms only.
When no selection is made, the acknowledge action depends on the settings of the SysConf
Global/Event System/EventView parameter 'AckAllVisibleIfNoneSelected':
If 'AckAllVisibleIfNoneSelected' is true, all unacknowledged alarms in the current alarm
page are acknowledged.
If 'AckAllVisibleIfNoneSelected' is false, none of the unacknowledged alarms are
acknowledged.
Related topics
Indicating that the alarm condition does not exist, only shown in
Void
historical lists
Active Indicating that the alarm condition is present
Normal Indicating that the alarm condition is no longer present
Suppression
Alarm systems sometimes offer a feature called 'alarm suppression'. The intention of this feature is to
reduce operator stress by holding back alarms that in some temporary system state are more or less
unwanted. The alarm property 'suppressed' indicates that the alarm is normally not intended for operator
attention. Some systems allow the operator to explicitly suppress unwanted alarms. Alarms suppressed
by the operator are called 'manually suppressed alarms'. Alarms suppressed by the system are called
'automatically suppressed alarms'.
Shelving
Some times alarms that are not applicable to the situation at hand pass through the suppression system.
The alarm shelving function provides the operator with means to put these alarms a side on a temporary
basis.
The commands for shelving alarms and viewing of shelved alarms are provided on the main menu and
on the context menu of an alarm selected in the Event List image.
When you shelve the selected alarm, a dialog controlling the expiration time for the alarm
shelving is displayed. You can accept the default expiration time, or you can specify it yourself.
When the expiration time is passed, the alarm is automatically transferred back to the normal
alarm view again.
All alarms that are currently shelved may be displayed in an alarm shelving dialog. Displaying
this dialog, you can move the shelved alarm away from the shelf and back to the normal alarm
view again.
Whenever an alarm is shelved, you can select it in the alarm shelving dialog and specify a new
expiration time.
Dependent on the filter setting, shelved alarms may also be active in the images.
Filters
The presentation of events is subjected to filtering: I.e. only those events that match all attributes
specified in the filter, are included in the presentation. AIM includes system-defined filters that can not
be altered by the user. In addition, AIM provides facilities to specify additional user defined filters.
All filters are made up of a various number of configured, standard filter attributes. The system-defined
filters are:
Filter type Filter name Comments
Alarm filters Alarm line The last alarm line filter.
Default The recommended standard filter.
Only alarms, no
messages. Universal All alarms from all stations pass through the filter. This
filter is suited for test purposes. It is also suited to be the
basis for new filters, which initially must be copied from
an existing filter.
Event filters Default The recommended standard filter.
Universal All alarms and messages from all stations pass through
Both alarms and the filter. This filter is suited for test purposes. It is also
messages. suited to be the basis for new filters, which initially must
be copied from an existing filter.
Station filter Station Explorer Selected alarm- and message types from the system units
filter OS, HS and PS pass through this filter.
Attributes
Filter attributes are the building blocks for all configured filters. Each filter attribute has a number of
options (see the Specified as ... column below), which may be selected or not for each of the filters.
See also
Alarm groups
Grouping of alarms is a tool for providing the operator with an essential selection of alarms by
suppressing or adding alarms.
There are four different kinds of alarm groups:
First up
Logical
Aggregated
Collective
The First-Up type of group shows the first alarm in the group that occurs, but suppresses all the
following alarms. This is useful in cases where many alarms may occur for essentially the same reason.
An alarm may not be the member of more than one First-Up group.
The Logical type of group suppresses its members when a specified expression evaluates to True.
The Aggregated type of group gives an additional alarm, the Aggregated alarm, signaling that all alarms
in the group have an active state.
The Collective type of group reduces the number of alarms by providing one specific alarm, the
Collective alarm, when any member of the group is active. All members of the group are automatically
suppressed.
An OS may be equipped with one or several audible alarms (horns). Each audible alarm on the OS has
its own set of OS-specific configuration parameters (Sections/OS<x>/Event
System/Horns/Horn/Horn<y> and ...Horns/Silence<z>) and its own filter.
Audible alarms are used to notify new alarms and major alarm changes. The horn specific filter will
normally further narrow this selection.
The OS offers a function that silences all horns, controlled by that OS. If an alarm causes Horn on more
than one OS, all horns can normally be silenced from any of the OS in question. However, system
alarms causing Horn can only be silenced from the originating OS. E.g. when an OS becomes 'not
communicational' several other OS may detect the situation and notify it by means of 'Horn'. The Horn
must be silenced on every OS that notifies the situation.
For each horn, a delay can be specified in msec (SysConf parameter: 'Sections/OS<n>/Event
System/Horns/Horn/Horn<n>/Delay) in order to suppress the audible alarm until the delay has expired.
Only alarms that remain unacknowledged for the defined delay time are considered for sounding the
horn. However, if the number of unacknowledged alarms exceeds a system defined limit, the delay will
be overridden and the horn will sound.
Related topics
The system alarms and adjacent messages are displayed in Event images. They are composed as
described below:
System alarms System alarms are issued when abnormal events occur in the process control
system. The station field (statid) indicates from which station the alarm is
reported. In some of the alarms, the type of CPU (376/386/960) is included in the
alarm text/identificator.
System messages System messages are issued as additional information for logging of:
Operation The operation messages are issued as consequences of the operator interaction on
messages the OS (by the OS itself). The station field (statid) indicates on which OS the
interaction takes place.
Related topics
As can be seen from the table below, in most cases only the message fields (value type almess) is filled
in. For some messages, however, the available alarm text field (value type altext) contains information.
The station field (statid) indicates from which station (yy in the tables, e. g. PS yy) the message is
reported. When the tag fields indicates cputest, this means either CPU376 SELF TEST, CPU386 SELF
TEST or CPU960 SELF TEST, dependent of the type of PS in which the self-test error occurred.
tttt: Test-type:
CACHE Error from CACHE test
R/W Error from RAM
read/write/modify
ADR Error from RAM address line test.
file server RED ST: NOT COMPLETED Message from redundant active station, with update
information to PS yy not received.
file server CHK SUM ERROR TOTAL = x After .ps file for PS yy is read, a total of x checksum
errors are found.
file server 1. CHK SUM ERR: ttt First checksum error that is found after .ps file for PS yy
is read, is for tag ttt.
See below.
Each RED ST error parameter that represents received and not accepted elements is described here. The
reason why elements are rejected may be:
1. On the master, the configuration has been edited. The new configuration has not been saved to the
server that the slave loads from (or has not been saved at all). Configuration in this context means
new redundant modules, or alarm configured on a terminal that previously didn't have any.
2. On the servers there are inconsistent files, or the files don't match those files the active station
read. This means that adding (but not reducing) of modules/alarms is possible by transferring the
file and load the computers sequentially during off-line configuring.
3. The message contents has become corrupt.
<modno> - the numbers of the modules to which the data shall be sent (the number of the module on the
station that currently is updated).
<size> - size of data area that is to be updated.
<term type> - 1 - input terminal, 2 - output terminal, 4 - process terminal.
<type> - types that are not listed in the table below are regarded as erroneous.
The following types of messages are with regard to historical storage and is reported via indicated (xx)
OCU (station field).
Operation messages are listed in the table at the bottom. The table below defines the message types.
Message types
Message Explanation
type
1 MOP = Change initiated from module operation menu.
2 This type of message may be displayed during operation by using the module operation
menu, provided that operation of the relevant function module by definition shall generate
an operation message.
3 This type of message is displayed during operation by using the module's operation menu,
under the System menu.
4 This type of message is linked to the command system, and regards transfer of the control of
command groups between stations. "x" is the OCU number, while "Group" is the name of
the OCU group. If the tag field displays OCU-group, this indicates that all command groups
currently under command of this OCU-group can be taken by the requesting OCU-groups.
5 This type of message is generated during use of the password system.
6 This type of message is linked to the redundancy functions of the system. "x" and "y"
represent PS numbers in a master slave pair. "zz" is either MASTER or SLAVE.
7 This type of message is displayed during operation by using the module's operation menu for
the menu ALARM GRP, which regards the module's connections with available alarm group
types. "x" is a group number.
Operation messages
operation.
Tag field CHANGE DBASE Change database parameters, time series etc. 5
Tag field COPY FILE Use file-copying function. 5
Tag field DELETE FILE Use file deletion function. 5
Tag field ENTER CONFIG Enter configuration mode. 5
Tag field IO-CONF READ Read IO system and configuration data. 5
Tag field IO-CONF WRITE Change IO system and configuration data. 5
Tag field NET OPERATE Modify net status. 5
Tag field OPERATE Use OPERER[OPERATE] button. 5
Tag field PRINT QUEUE Open/close printer queues. 5
Tag field PS START/STOP Start and stop PSs. 5
Tag field PWD MAINT Maintenance of password system, e. g. change 5
password.
Tag field READ PG2 Read parameter/table images page 2. 5
Tag field READ PG3 Read parameter/table images page 3. 5
Tag field SET TIME Set clock. 5
Tag field SYSTEM OPER Use "SYSTEM" button during module operation. 5
Tag field TAKE COMMAND Use the take-function in the command control 5
system.
Tag field WRITE PG1 Change data parameter/table images page 1. 5
Tag field WRITE PG2 Change data parameter/table images page 2. 5
Tag field WRITE PG3 Change data parameter/table images page 3. 5
tag ACTIVE Sets the module in active mode (out of maintenance 3
mode).
tag ACTIVE INP Sets all input terminals in active mode (out of 3
maintenance mode).
tag ACTIVE OUTP Sets all output terminals in active mode (out of 3
maintenance mode).
tag ALARM OFF Disables the module alarm system. 3
tag ALARM ON Enables the module alarm system. 3
tag ALARM CHANGE x Change in level for digital alarm (MOP) 1
-> x (0-No alarm,
1-Low level,
2-High level)
Command REQUESTED BY OCU in other OCU group requests your OCU group 4
group/OCU <OCUx>(<Group>) to take command of command group(s) currently in
group OK? command of your OS group.
tag BLOCK INP Sets all input terminals in passive mode (in 3
maintenance mode).
tag BLOCK OUTP Sets all output terminals in passive mode (in 3
maintenance mode).
- DB-BACKUP Error during read/write from/to backup for time 1
FAILED series database.
- READ DB_BACKUP Time series database read from backup, OK. 1
READY
tag HHI: xxxx.x -> xxxx.x Changed limit for HIGH HIGH alarm (MOP). 1
tag HIGH: xxxx.x -> Changed limit for HIGH alarm (MOP). 1
xxxx.x
- STORE Time series database written to backup, OK. 1
DB_BACKUP
READY
tag LLO: xxxx.x -> xxxx.x Changed limit for low low alarm (MOP) 1
User name LOGIN FAILURE : User has attempted to log in by using wrong 5
<user name> password
User name LOGIN OK : <user User has logged in with correct password. 5
name>
tag LOW: xxxx.x -> Changed limit for low alarm (MOP). 1
xxxx.x
tag MDL FLGx Module connected to follow-on alarm group x. 7
tag MDL LOGx Module connected to logical suppression group x. 7
tag MDL PANx Module connected to alarm panel group x. 7
Command Command Group not The command group is currently not under TBS
group/OCU under command command of any OS Group.
group
Command None communicating No other OS of this OS Group is currently available. TBS
group/OCU OSes in OS Group
group
Command REQUEST FAILED, A request for taking the command of command 4
group/OCU <OCUx> REFUSED group(s), which currently is under command of
group other OCU group, is refused by a member of the
other OCU group.
Command REQUEST FAILED, A request has failed because no OCU of the 4
group/OCU NO ANSWER requested OCU group has answered within the time-
group out period (approx. 60 seconds).
Command REQUEST FAILED, A request has failed due to concurrent request for 4
group/OCU BUSY the same command group(s) from other OCU group.
group
Command REQUEST Requested OS group accepts a request for transfer of 4
group/OCU SUCCEED,FROM. command of command group(s).
group <OCUx>(<Group>)
Pop-up messages
Message Explanation
An operator (OS Group) has attempted to operate a module
No Command Control on <command
contained in a command group, over which the operator (OS
group>
Group) currently has no command control.
RIO: On-board voltage error. Vital CPU voltage PWR1 (reset required)
RIO: On-board voltage error. Vital CPU voltage PWR1 (restart required)
RIO: Short-circuit
Communication error
Communication timeout
Exception, acknowledge
Error base
Framing error
Framing/overrun error
Illegal protocol
Interrupt disabled
IO error
No ack received
No ascreate done
Overrun error
Parity error
Parity/framing error
Parity/framing/overrun error
Parity/overrun error
Telegram timeout
Error
Line break
Overload
Overtemperature
Overvoltage
Short circuit
Undervoltage
Line break
Overload
Overtemperature
Overvoltage
Short circuit
Undervoltage
Unknown producer PS
COMMUNICATION FAULT
Incompatible software
This section contains procedures for how to use the Event system.
Shelving alarms
Updating filters
Requirements
The Event system indicates the alarm states as shown in the table below:
Acknowledged alarm
Unacknowledged alarm
Suppressed alarm
When the alarm is marked like this it is not permitted to
acknowlede.
There are two reasons for this, either:
Viewing alarms
The last unacknowledged alarm can be viewed on the last alarm line of any image displayed in
the primary image window.
To get a complete overview of all alarms - acknowledged and unacknowledged, display the
appropriate Event View. (The Event View with the appropriate alarm filter settings.) Use the
available pages as applicable.
Note! System alarms on PSs can also be viewed by entering the PSs from the Station Explorer or
System Status images.
Acknowledging alarms
To acknowledge the last alarm on the primary image window, proceed as follows:
1. Select the last alarm line. On the toolbar, click . The alarm is removed from the last alarm line.
On the appropriate Event View, the unacknowledged alarm mark (see above) on this particular
alarm has disappeared.
2. If your application contains more unacknowledged alarms, the next, appropriate unacknowledged
alarm is displayed on the last alarm line.
1. Select the alarm(s) you want to acknowledge. On the toolbar, click . The unacknowledged
alarm mark (see above) disappears.
2. If no alarm is selected prior to clicking , and the 'Ack All Visible If None Selected'-property is
set, all visible unacknowledged alarms are acknowledged.
3. Note! System alarms on PSs can also be acknowledged by entering the PSs from the Station
Explorer or System Status images.
Related topics
Selections made in one alarm page are reflected in all alarm pages. I.e. if your selection includes the
latest alarm, this item will be selected in both the actual page where you make the selection and the last
alarm line. This is a useful feature, especially when applying different filters to a page in the Event List
image and event dialog. Note that this feature does not include the historic event page.
To cancel any selection, click in any field that is not in the left column of the page.
Single row selection: click in the left field in the row. All previous selections are removed.
Continuous multiple row selection: Click in the left field of the first row to be included in the
selection. Keep SHIFT key down while clicking in the left field of the last row to be included in
the selection.
Random multiple row selection: Click in the left field of the first row. Keep CTRL key down
while clicking in the left field of the rows to be included in the selection.
Using CTRL+Click in the left field of a selected row, deselects that row.
Selecting all rows: use the Select all command
Related topics
To define the time span for events displayed on the Historic Event Page, proceed as follows:
Requirements
Procedure
1. Display the Historic Event Page, for which you want to change the time span.
2. On the toolbar, click . The Date and Time dialog box is displayed.
3. To define the most recent end of the time span, use the fields contained in the Most recent time
group box: Either click the Now button, or use the calendar, drop-down list boxes and text boxes.
4. To define the relative backward time span, type in the appropriate values in the text boxes
contained in the And backward time span group box. Close the box.
5. The Historic Event Page is instantly updated with the new time span, which is displayed on the
status line.
Related topics
Shelving alarms
The procedure below describes how to shelve alarms, eventually view and edit them, and how to move
them back to normal alarm view again.
Requirements
Shelving an alarm
1. The command group, containing the applicable alarm, must be under command control of your
OS group.
2. Display the Event List image. Select the alarm(s) you want to shelve. Right-click to display the
context menu for the selected, acknowledged alarm(s). Click Shelve Alarm.... The Set
Expiration Time dialog box is displayed.
3. Select the expiration time and -date for the selected alarms. Check the Show list of shelved
alarms box and click the OK button. The Alarm Shelving dialog box is displayed. All shelved
alarms are displayed in the list view with their expiration times and other information.
No sign of the alarm can be observed in Flow images or Event List images while the alarm
is shelved.
4. To restore a shelved alarm(s): On the Tools menu click Alarm Shelving.... The Alarm Shelving
dialog box is displayed. Select the applicable alarm(s) and click the Remove button. The alarm(s)
is(are) restored and thus removed from the list of shelved alarms.
Note! When using certain filter settings, alarms that are shelved may be listed in Event lists.
1. The command group, containing the applicable alarm, must be under command control of your
OS group.
2. On the Tools menu click Alarm Shelving.... The Alarm Shelving dialog box is displayed. All
shelved alarms are listed.
3. To restore a shelved alarm, see step 3 in the procedure above.
4. To edit the expiration time for the selected shelved alarm(s), click the Edit... button. The Select
Expiration Time dialog is displayed. Select a new expiration time as applicable.
5. To print the list of shelved alarms, click the Print... button.
Related topics
Requirements
Note! When an Event List image is displayed, you can select among other filter types and thus among
other filters. This applies for all event view context (poput, decoration, etc). Your new selections
however apply only as long as the Event List image is displayed, or the historical list is used.
1. On the toolbar, click . Uncheck the Use default filter type box.
2. To view the navigation tree comprising all filter types, filters and attributes, click the Filters...
button. The Filters dialog box is displayed. You can view all filter attributes by double clicking
them. Close the dialog box.
3. Return to the Select Filter dialog box. To select filter type for the current Event View: From the
Filter type drop-down list, select filter type as applicable. From the Filter Name dropdown list,
select filtername. Click the OK button.
4. In the active filter field on the Event toolbar, the lead text to the left of the drop-down list box now
displays the filter type you selected in the previous step and the visible item in the dropdown list
will be the selected filtername. This does not apply for the Last Alarm Line or decoration context.
The filter change applies to the page where the change was made except for Dynamic and Static alarm
pages where the filter change will apply for both pages.
Related topics
Updating filters
Requirements
Updating filter
To update a filter with the attribute values of another, similar filter of the same type, proceed as follows:
1. On the toolbar, click . The Select Filter dialog box is displayed. Uncheck the Use default
filter type box.
2. Click the Filters... button. The Filters dialog box is displayed.
3. Select the filter, which attributes are to be copied across. Click the Source button. The name of
the filter is now printed in bold font.
4. Select the filter, which is to receive the filter attributes. Click the Update button. Red check marks
appear on the appropriate filter folder icons.
5. Click the Apply button. The Confirm apply dialog box is displayed. Confirm the update. Close
the Filters dialog box. Close the Select Filter filter dialog box by clicking the OK button.
Related topics
Requirements
To create a new a filter within the same filter type folder and with the attribute values of another, similar
filter, proceed as follows:
1. On the toolbar, click . The Select Filter dialog box is displayed. Uncheck the Use default
filter type box.
2. Click the Filters... button. The Filters dialog box is displayed.
3. Select the filter, which you want to copy. Right-click and select Copy from the sub-menu. The
filter is copied to a folder with yellow mark. Type in the name of the new filter. Eventually, edit
each attribute applicable.
4. Click the Apply button. The Confirm apply dialog box is displayed. Confirm the creation of the
new filter. Close the Filters dialog box. Close the Select Filter filter dialog box by clicking the
OK button.
Deleting filter
1. On the toolbar, click . The Select Filter dialog box is displayed. Uncheck the Use default
filter type box.
2. Click the Filters... button. The Filters dialog box is displayed.
3. Select the filter, which you want to delete. Right-click and select Delete from the submenu.
4. Click the Apply button. The Confirm apply dialog box is displayed. Confirm the deletion of the
filter. Close the Filters dialog box. Close the Select Filter filter dialog box by clicking the OK
button.
Related topics
Requirements
1. Display an Event List image. On the Event toolbar, click . The Select Filter dialog box is
displayed. Click the Filters... button. The Filters dialog box is displayed.
2. In the tree view, expand the applicable filter type. Select the filter you want to view. All attributes
of this filter is displayed when you expand the filter name.
3. Select an attribute, right-click and select View from the submenu. A dialog box containing all
options of the attribute is displayed. Thus, you can view which alarms that are filtered for this
attribute and filter.
4. If applicable, select other attributes and view them as described in step 3 above.
NOTE: Filters that are locked cannot be re-configured. (Locked filters have a padlock graphic
symbol.) Filters with attributes that may be reconfigured have associated dialogs with boxes, panes
and options that are available.
Requirements
1. On the toolbar, click . The Select Filter dialog box is displayed. Uncheck the Use default
filter type box.
2. Click the Filters... button. The Filters dialog box is displayed.
3. Select the filter, which you want to edit. Right-click and select Add/Remove attributes from the
sub-menu. The Alarm Line filter attributes dialog box is displayed. Add or remove attributes as
required and press OK.
4. Click the Apply button. Close the Filters dialog box. Close the Select Filter filter dialog box by
clicking the OK button.
Related topics
Requirements
An alarm group must contain at least one alarm. Terminal alarms are allowed as members for all four
group types.
Alarm groups are organized in folders. It is advisable to structure the folders in a way which reflects the
structure of the process.
To avoid inconsistency it is important that all involved PSs are running when alarm groups are
configured.
It is vital to save the configuration for all the PSs when configuration is completed.
For information about how to save PS configuration; Save PS configuration (backup).
Definition of which PSs that are involved when creating and editing alarm groups:
A PS with terminal alarm added to or removed from any type of alarm group.
A PS with module terminal or IO-tag used in State Variable definition.
Any change in an Aggregated Group involves all PSs with members in this group.
1. On the Tools menu, select Alarm Groups.... The Alarm Groups dialogue box is displayed.
2. In the Alarm Groups dialogue box select Edit from the Operation mode drop-down list.
3. Right-click within the graphic view pane and select New - Group Folder.
Enter the name of the group folder, which is free text, e.g the name of the process area.
4. Right-click on the folder and select New - Alarm Group - respective type of alarm group.
For description of the different types see Alarm groups dialogue box. Enter the name of the alarm
group.
5. Right-click on the Alarm group folder and select New- Alarm.
Enter the name of the alarm in the following syntax:
Digital terminal alarms: MOD.<tag name>/<terminal name>
1. On the Tools menu, select Alarm Groups.... The Alarm Groups dialog box is displayed.
2. In the Alarm Groups dialog box select Edit from the Operation mode drop-down list.
3. Right-click on a folder or an alarm and select the required edit function - cut, delete, copy, paste
or rename.
4. In the Alarm Groups dialog box select Dynamic from the Operation mode drop-down list.
5. Run a PS back-up to save your configuration.
When the last alarm in a group is deleted, the group itself is deleted. This is because a group
cannot exist without members.
Similarly, a folder cannot exist without containing groups. The most efficient way of deleting a
substructure, is to delete its top level folder or group.
Requirements
Creating
1. On the File menu, select New Image.... The New Image dialog box is displayed. Using the Type
drop-down list, select Event List. In the Name text box, type in the name of the new image and
click the OK button.
2. If the Event List image does not exist the Event List image properties dialog will be displayed.
Make your selections and close the dialog box. The new Event List image with the selected name
and properties is created and displayed.
Deleting
Reference information
The reference information section contains information regarding the commands and dialog boxes
related to the component. Titles are sorted alphabetically.
The dialog boxes may be displayed in different ways depending on the operation you are performing and
the sequence of commands executed. In the description of the dialog boxes only one of the possibilities
is given.
Acknowledge command
The Acknowledge command allows the user to confirm that he has observed the alarm indication
announced through the AIM system.
Method:
The Acknowledge command is available in the context menu of the Last alarm line whenever an alarm
is unacknowledged.
In addition, the icon is available in the event toolbar in the Event List image and the event dialog.
The effect of the Acknowledge command depends on the current image and current selection. Refer to
the Alarm acknowledgement description.
Method:
On the Tools menu select Alarm Groups.... The Alarm Groups dialog box is displayed.
Method:
On the Main menu select System - OS Configuration - Event Printer.... The Event Printer
Configuration dialog box is displayed.
Filter... command
The Filter... command is an option in the context menu of any alarm and event page in Event List image
and event dialog.
Method:
NOTE: This command is only available when the event printer of your configuration is a page
printer, for example a laser printer.
Method:
On the Main menu, select File - Print Events.... The Event Printer dialog box is displayed.
Method:
Select all is available from the context menu of event and alarm pages.
It may be displayed by the command <Event List image> - <Historic Event Page> - (Time span
icon).
The time span is defined relative to a specified date and time. The 'most recent time' is the reference.
This group contains controls for setting the most recent time.
If you want another reference, use the calendar, and the Hour, Min and Sec controls.
As the reference is the most recent time, the time span is defined in days, hours, minutes and seconds
backwards in time. Use the Days, Hours, Min and Sec text boxes.
It may be displayed by the commanding <Event List image> - <Historic Event page> - <context
menu> - Free text search.
Show me an example
The dialog box may be displayed by the command: <Event List image> - <context-menu> - Lines…
Show me an example
Number of lines
The dialog box may be displayed by the command:in Event image File - Image properties.
Show me an example
The box is checked when you want to use a template for defining an alarm or event page.
There is a check box for each page type. When checked, the page is available in the event view,
independent of the context but not in the Last Alarm Line.
When checked the page names and navigation controls are included in the event view.
When unchecked the page names and navigation controls are omitted in the event view.
The check box should be checked, whenever more than one page is made available.
Start Page
The list contains only those page types that are checked in the Alarm Pages and Event Pages groups.
The selected page is displayed as the active page when the framework that contains the event view is
displayed.
Number of lines
This box must be checked in order to make an unacknowledged alarm more distinguished by flushing
the alarm line.
When this box is checked two new columnswill appear on the dynmic and static alarm pages - 'Value'
and 'Unit'.
SysConf section
Since you can configure the columns in the Event List image, you can choose if the changes should be
saved on the OS you are working on or globally for the whole system.
It may be displayed by the command Tools - Station Explorer - select PS - right-click - System Events
for node - Popup tab.
Show me an example
The user must have the OSKEvent_ExportToFile permission before this entry is enabled.
The exported file can only be saved on the users document and settings area on the disc or to a
removable drive.
The available drives are displayed in the drop list at the top of the dialog.
The csv format can be imported into a text editor or spreadsheet for further analysis.
The alarm and events are exported on the same format as they are presented, with column order and -
names.
At the top of the file there will be information about the station from where the alarms and events were
exported, date and time, name of event view, name of event page and name of filter and filter type.
It may be displayed by the command in <Event List image> - <context menu> - Save Grid as
Template.
Show me an example
It may be displayed by the command Add - Hotspot - Configure hotspot - Function: click in the white
field (auto prompt) - double click EventImage from dropdown window - write . (a point) - double click
SetFilter from dropdown menu - write . (a point).
Show me an example
Display it by the command: Toolbar - Filter-icon - Select Filter - Filters… Right click on a filter type
- Add/Remove Attributes.
Not selected
The attributes that are still available, but not added to the filter.
Use the arrows to select the attributes that are to be added to or removed from the filter.
Selected
Show me an example
The filter explorer pane represents the active filter fully expanded while other filters and filter types are
collapsed. You can browse all defined filters and the explorer reflects all actions taken in the dialog.
Double-clicking a filter attribute in the explorer, displays a dialog that contains all possible attribute
values and reflects the current settings.
The icon indicates that the filter is locked. Locked filters are system standard filters that can not be
modified.
When checked, a confirmation dialog box pops up as you initiate an operation that not can be un-done.
Apply and Restore become available when you have made changes that are marked or . Restore
cancels the changes. Apply effectuates them. Both actions display a confirmation dialog.
Close
It is available during normal operation. Filter selection presumes the AlarmChangeFilter permission.
Show me an example
Filters...
Filter name:
As the dialog is displayed, the list box identifies the filter currently applied in the actual page. Any other
filter - system and user-defined - within the same Filter type, can be selected from the list box. As you
enter a selection from the list, the new filter is activated for the actual page.
Filter type:
Initially, the filter type identifies the filter type that is currently applied in the actual page. Un-checking
the Use default filter type, changes it into a list box, containing the filter type alternatives. The system
defined filter types are: alarm filters, Event filters, and Horn filters. Upon selection of another filter type,
the Filter name alternatives are adjusted.
When checked, the default filter type is automatically selected and filters of other types are not available
from the dialog box. The Filter name list box is than identical with the one displayed in the OS toolbar.
When unchecked, you can select any filter type and make the filters they contain available for selection.
Note that this is the only way to activate a filter that is not of the default filter type.
It may be displayed by the command: Select the acknowledged alarm, which you wish to shelve and
right-click to display its context menu. Click Shelve Alarm... - Select Expiration Time - check Show
list of shelved alarms box - OK.
Show me an example
Refresh
Print...
This command allows you to print all the current shelved alarms. The information contents is the same
as the list in the dialog box above.
Remove
This command restores the selected alarm from the alarm shelf to the Event List image.
Edit...
This command allows you to edit he expiration date and -time for the selected shelved alarm.
It may be displayed by the command: Select the acknowledged alarm, which you wish to shelve and
right-click to display its context menu. Click Shelve Alarm....
Show me an example
Expiration time
Two boxes for selection of the expiration time for the selected shelved alarm are supported:
Left box: Select the expiry date from the drop-down list (month, day, year).
When this box is checked, the Alarm Shelving dialog is opened and refreshed with the current shelved
alarms.
Apply button:
Apply changes made in the configuration.
Filter
Type/name:
The text box indicates which filter is applied before printing. I.e. only events that pass the filter are
printed. Click the Edit... button if you want to select or specify another filter.
Edit...
The Edit... button invokes the Select filter dialog.
Printer properties
The Printer properties group contains the controls that define the output device and format:
Name:
The text box indicates the actual printing device, which is either a printer or a file.
To select a printer, select one of the printers listed in the list box.
To select a file, click the ... control and specify the path and filename in the standard file system explorer
dialog. As you specify a file, the Properties button is disabled.
Type:
The Type input box reflects the type of output device and should correspond with the device specified in
the Name box. I.e. If the event printer is a line printer, the Type input box should be set to 'Line Printer'.
Font:
The Font list box let you select among a set of predefined fonts.
Unprinted events
At one side of the event print mechanism, incoming events that pass the filter, are stored in a buffer. At
the other end, the buffer is drained as events are send to the printer. Buffering is required as printer
performance does not match the rate of event occurrences.
Buffer length:
The text box indicates the buffer capacity. You can resize the buffer by entering a new value in the text
box.
refreshed.
Refresh
Clicking the Refresh button updates the number of events in the buffer.
Purge...
You can purge the buffer - that is - cancel the printing of events in the buffer. Clicking the Purge...
button displays the Purge unprinted events dialog.
You can keep the events in the buffer and inhibit new events from being stored.
You can overwrite events that are stored in the buffer, thus skipping the oldest unprinted events
but keeping the most recent ones.
NOTE: This dialog box is only available when the event printer of your configuration is a page
printer, for example a laser printer.
Unprinted events:
This text box shows the number of un-printed events in the event printer buffer.
Refresh
This button is used to update the information shown in the dialog box. Clicking this button causes the
name and type of the dedicated event printer as defined in the Event Printer Configuration dialog box to
be shown in the Printer name and Printer type fields. It also causes the current number of un-printed
events in the event printer buffer to be read and displayed in the Unprinted events text box.
Flush
Clicking this button sends the un-printed events in the event printer buffer out to the event printer.
Purge...
Click this button to open the Purge unprinted events dialog box
This button will only be enabled if the user has the OskEvent_CanPurge permission.
Printer name:
Printer type:
It may be displayed by the command System - OS Configuration - Event Printer... - Event Printer
Configuration - Purge....
Show me an example
The Purge unprinted events dialog box lets you specify which events to purge. The alternatives are:
All
Select this option when you want to purge the entire queue of events in the buffer.
Older than
Select this option and fill in the number of days. Only those events that are older than the specified limit
are purged.
The Alarm Groups gives an overview of all the alarm goups in the system and allows you to define
and/or edit alarm groups.
There are four different types of Alarm groups
It is available during normal operation. PS Configuration Mode together with Operation Mode Edit is
required for editing.
Alarms are always shown with a colour that indicates its priority.
Logical groups and First-Up groups are shown with a colour that indicates whether they are
suppressed or not.
Aggregated groups and Collective groups are shown with a colour indicating the level of the
aggregated or Collective alarm.
Refresh
The Alarm Groups dialog box present static data. Refresh button must be used for updating with new
data from the PSs.
Refresh button can also be used as an "Undo" function for leaving Edit mode without deploying
changes.
State variables
Operation mode
Used for selection between the two modes; Dynamic and Edit.
Dynamic mode is the default operation mode. After editing Alarm Groups the Dynamic mode must be
selected to deploy the changes.
Edit mode is required for making changes in the Alarm Groups.
Related Topics
It is available during normal operation. For editing PS Configuration Mode and Edit operation mode is
required.
Open the dialog box by selecting Properties in the context menu for an alarm group; right-clicking of an
alarm group folder in the Alarm Group dialog box.
Resulting alarm
Logic expression
Show expanded expression; for displaying the expression from which the State Variables are made
from.
Show expanded expression must be deselected to make the Insert Variable... button available.
Insert Variable
The dialog box is opened from: Alarm Groups dialog box - State Variables - Define
Id
Name
Expression
The State Variable can be made from a single variable or from logical expressions of variables.
MOD.<Tag>/<Term> OR (MOD.<Tag>/<Term> AND MOD.<Tag>/<Term>).
It is available during normal operation. PS Configuration Mode and Edit operation mode is required
for editing.
Open the dialog box by selecting Properties in the context menu for a folder; right-click on a folder in
the Alarm Group dialog box.
Define is used for creating new variables, Delete for removing existing variables.
PS configuration mode is required and PS configuration must be stored after changes.
Define
The Define State Variables dialog box enables you to define new variables.
Delete
Deletes variables.
It is not allowed to delete a variable used by Logic Alarm Group; Message Pop-Up will be given.