Workstationst Alarm Viewer: Instruction Guide
Workstationst Alarm Viewer: Instruction Guide
Workstationst Alarm Viewer: Instruction Guide
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Document Updates
Location Description
The section, OPC UA Alarms Clarified the descriptions of the Comments, Comments With Acknowledge,
and Comments With Reset features.
The section, Historical Settings Added new section with new settings for Historical Alarms.
Related Documents
Doc # Title
GEI-100626 WorkstationST* Alarm Server
ControlST* Software Suite How-to Guides, the following sections:
How to Analyze Historical Alarm Data Using the WorkstationST Alarm Viewer - Online Mode
GEH-6808
How to Analyze Historical Alarm Data Using the WorkstationST Alarm Viewer - Offline Mode
How to Filter Live and Historical Alarms Using the WorkstationST Alarm Viewer
How to Set Up Alarm Help and Diagnostic Help for use in the WorkstationST Alarm Viewer
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Acronyms and Abbreviations
CMP Command Message Protocol
OOS Out-of-service
OPC A standard for data exchange in the industrial environment.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Contents
1 Introduction.................................................................................................................................................6
1.1 System Requirements ..............................................................................................................................7
1.2 Installation ............................................................................................................................................7
2 Multi-language Support .................................................................................................................................8
2.1 Language Usage Rules.............................................................................................................................9
3 Application Help ..........................................................................................................................................9
4 Security .................................................................................................................................................... 10
5 Command Line Arguments ........................................................................................................................... 12
6 Operation .................................................................................................................................................. 13
6.1 Screen Overview .................................................................................................................................. 13
7 Advanced Features...................................................................................................................................... 17
8 Live Alarms............................................................................................................................................... 18
8.1 Organize and Display Columns................................................................................................................ 18
8.2 Sort Alarm Data ................................................................................................................................... 20
8.3 Filter Live Alarms................................................................................................................................. 21
8.4 Active Alarm Background Notification ..................................................................................................... 23
8.5 Manage Alarms and Events..................................................................................................................... 24
8.6 Alarm Shelving and Out-of-service .......................................................................................................... 27
8.7 Alarm Parent Child ............................................................................................................................... 32
8.8 OPC UA Alarms................................................................................................................................... 37
8.9 Live Alarm Status History ...................................................................................................................... 39
8.10 Alarm Symbols................................................................................................................................... 40
8.11 Sound Options .................................................................................................................................... 42
8.12 Alarm Attributes ................................................................................................................................. 43
8.13 Redundant Alarm Server Support ........................................................................................................... 46
9 Live Alarm Messages .................................................................................................................................. 47
10 Live Alarm Summary ................................................................................................................................ 49
11 Connect................................................................................................................................................... 53
12 Historical Alarms ...................................................................................................................................... 55
12.1 Display Columns................................................................................................................................. 57
12.2 View a Single File ............................................................................................................................... 58
12.3 View All Files .................................................................................................................................... 59
20019983-94.03.18.100-010-01-06-2017-INF
13 Filters ..................................................................................................................................................... 65
13.1 Filter Collections................................................................................................................................. 65
13.2 Alarm Filter Timeouts .......................................................................................................................... 67
13.3 Edit a Filter ........................................................................................................................................ 69
14 Alarm Viewer Settings ............................................................................................................................... 71
14.1 Live Settings ...................................................................................................................................... 74
14.2 Historical Settings ............................................................................................................................... 77
14.3 Historical Chart Settings ....................................................................................................................... 77
15 Views ..................................................................................................................................................... 80
15.1 Create a View ..................................................................................................................................... 80
15.2 Open a Saved View ............................................................................................................................. 82
15.3 Open a Recently Used View .................................................................................................................. 82
15.4 Default View ...................................................................................................................................... 82
15.5 CIMPLICITY* Alarm Status History View .............................................................................................. 82
16 Alarm Reports ......................................................................................................................................... 84
16.1 Report Options ................................................................................................................................... 86
16.2 Create Alarm Report ........................................................................................................................... 90
16.3 Report Results ................................................................................................................................... 96
17 Alarm Help.............................................................................................................................................106
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
17.1 Directory Structure .............................................................................................................................106
17.2 Process Alarms ..................................................................................................................................107
17.3 Diagnostic Alarms..............................................................................................................................108
17.4 Alarm Help Comments........................................................................................................................109
17.5 Alarm Viewer....................................................................................................................................110
18 Terms ....................................................................................................................................................117
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
1 Introduction
The WorkstationST Alarm Viewer displays and manages live and historical alarm and
event information from a computer configured with the WorkstationST application, and
running the Alarm Server Feature. Alarm and event information displays by using
advanced filtering and sorting capabilities, as well as functions such as acknowledging,
locking, and silencing alarms and events.
The following alarm and event information can be generated:
• Alarms
• Events
• Holds
• Sequence of Events (SOE)
• Diagnostics
The Alarm Server connects to and receives alarm and event data from one or more
controllers listed as consumed devices in a WorkstationST component configured in the
ToolboxST application. An Alarm Server configuration connected to four controllers is
displayed in the following figure. The Alarm Viewer then connects to the Alarm Server to
display and manage the alarm and event data from the configured controllers and the
Alarm Server.
Note The Alarm Viewer can connect to any single Alarm Server in the system.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
For further information refer The terms in the following table are defined in ISA 18.2 and are also used in the alarm
to ISA 18.2, Management of system by GE. The definition describes their use as implemented in the GE alarm system.
Alarm Systems for the Process
Industries Term Definition
Represents a group of alarm configuration parameters used in
configuring an alarm. These parameters include:
The operator action that clears an alarm from the alarm display
Reset when the alarm has been Acknowledged and is in the Normal
condition.
1.2 Installation
Refer to the ToolboxST User The Alarm Viewer is installed from the ControlST DVD by selecting the WorkstationST
Guide for Mark Controls application installation option. The Alarm Viewer can be installed with the
Platform (GEH-6700), the WorkstationST application or by itself for use on a remote computer. If a new version is
section Installation. installed, the desktop and Start menu update to reflect the most recently installed version.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
2 Multi-language Support
Refer to the section Alarm Starting with the ControlST V04.03, the Alarm Viewer can be displayed in the local
Viewer Settings, the option Windows language as selected in the Control Panel - Region and Language - Keyboards
Enable Non-translated and Languages, on the tab Display Language.
Content.
To enable the Alarm Viewer to display in the selected language the following is required:
• The Windows Language Pack is installed on the computer for the desired language.
Or
• The Alarm Viewer resource DLLs are installed that match the selected Windows
display language.
Refer to the Resource The resource DLLs can be created or modified by using the Resource Translation
Translation Manager Manager utility application and exporting the strings to a dictionary text file for
(GEI-100793). (The document translation. This application is installed automatically when the ControlST software suite,
can be found at \GE Energy\ Configuration Tools Package or the WorkstationST application is installed. This utility
Documentation\GEI-100793. can be found in the following directory:
pdf)
For Windows XP: \Program Files\GE Energy\Resource Translation
Manager
For Windows 7: \Program Files (x86)\GE Energy\Resource Translation
Manager
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
2.1 Language Usage Rules
Starting with ControlST V04.03, the WorkstationST Alarm Viewer supports displaying
text in the native language as selected from the Control Panel - Regional Settings -
Keyboards and Languages - Display Text. With this new capability, support for
subcultures in the language component of the help files names is available.
Refer to the Resource The language component used in the file name can now contain the subculture for that
Translation Manager country. The language component of the file can be defined as:
(GEI-100793).
<culture>-<subculture>
or
<culture>
Example:
A file name can be defined using the culture and subculture for Spanish - Spain (Spanish
for Spain) as
L63QTX.es-SP.txt
or it can be defined using just the culture for Spanish as
L63QTX.es.txt
If the alarm help subsystem detects the use of the subculture in the language component
of the file name, it displays. Otherwise, the culture form displays.
3 Application Help
The Alarm Viewer includes a help file to aid in the understanding of the configuration and
operation of the application. The help file is located in the installation directory and is
named WorkstationSTAlarmViewer.chm.
Starting with ControlST V04.03, the Alarm Viewer supports displaying text in the native
language of the operating system. When enabled, the Alarm Viewer displays the
application help in the native display language of the operating system. The help file must
reside in the language subdirectory under the installation directory for the Alarm Viewer.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
4 Security
Logon security qualifies the capabilities of the Alarm Viewer user. A logon prompt
displays if the user logon account names and user roles are defined in the ToolboxST
application. The logon validates the user against the Windows account credentials on the
current computer, and against the user logon name entered in the Users and Roles section
in the ToolboxST System Editor. If the logon is successful, the user’s role, as defined in
the ToolboxST application (displayed in the following figure), establishes the capabilities
in the Alarm Viewer.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
If the User Logon dialog box The Alarm Viewer user capabilities are determined by the Alarm Privilege assigned to the
displays when the Alarm user role. The Alarm Privilege is defined as True or False for each role.
Viewer is started, select the Alarm Privilege, when set to True, allows the user to interact completely with the alarm
User from the drop down list
system. This includes performing tasks such as acknowledging, locking, silencing, and
(as defined in the ToolboxST reset of alarms, defining or saving views, and defining or saving filters.
system component User Names
and Roles feature), and enter Alarm Shelving Privilege allows the user to shelve or unshelve alarms.
the Windows account Download Privilege allows the user to download to a controller.
Password.
Alarm Service Privilege allows the user to place alarms as out-of-service from the
Alarm Viewer.
Go To Definition From HMI Graphics Privilege, when set to True, allows the user
to open the ToolboxST application to display the logic writing the current alarm. When
set to False, this feature is disabled.
Live Data Force Privilege allows the user to force live values.
Live Data Modify Privilege allows the user to modify live values.
Tag Out Privilege allows the user to perform tag outs in the system.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
5 Command Line Arguments
The Alarm Viewer supports a number of command line options for starting up the Alarm
Viewer. The leading “/” and trailing “:” characters around the option keywords are
required, and only one option is supported at a time.
Note The < > brackets are displayed to demonstrate usage, not to be included with the
value.
Note If there is an AlarmViewerDefault.AvView defined, the Alarm Viewer uses that file
instead of the HostName specified to control the display behavior.
/IPAddress:<QuadIPAddress>
Where:
/IPAddress: is the option to be used
QuadIPAddress is a valid IP address on the network.
Usage: /IPAddress:127.0.0.1
Note If there is an AlarmViewerDefault.AvView defined, the Alarm Viewer uses that file
instead of the IPAddress specified to control the display behavior.
Where:
/View: is the option to be used.
View file name is the name of the AvView file to be used. The file can be fully qualified
or be the name of the file without the path.
Note If just the file name is specified, the Alarm Viewer uses the Alarm Configuration
Root Path option, and then checks in the Views subdirectory.
Note The View file name must be enclosed in double quotes if there are spaces in the
path or file name.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
The Alarm Configuration Root Path is assigned to be C:\WorkstationST
\AlarmViewerConfiguration and Views is the required subdirectory.
Note For the view file name, the file extension AvView is registered for use by the
Alarm Viewer during installation. When you double-click on a file with that extension,
the Alarm Viewer opens and uses that file to define the display.
/NoSplashScreen indicates to suppress the startup splash screen when the Alarm
Viewer is started.
6 Operation
➢ To start the Alarm Viewer: from the Start menu, select All Programs, GE
ControlST, and WorkstationST Alarm Viewer.
or
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
6.1.1 Menus
Menu Command Use to
New Filter Collection Define a new collection of alarm filters.
Open Filter Collection Open a previously saved set of alarm filters.
Save Filter Collection Save the current set of alarm filters to a different file.
Save Filter Collection As Save the current set of alarm filters to a different file.
Close Filter Collection Close the current filter set.
Recent Filter Collections Display a list of recently used filter collections.
Open Alarm Data File Browse for an alarm data file to display.
Close Alarm Data File Close the currently open data file.
File Print Alarm Data Print the currently displayed alarm/event data.
Export Alarm Data Export the displayed alarm/event data to a .csv file.
Export Alarm Summary Data Export the historical alarm data to a .csv file.
Show Live Alarms Summary Display the Live Alarm Summary Data tab.
Show Live Alarm Messages Display the Live Alarm Messages tab.
Show Historical Alarms Select the mode of operation to display historical alarm data.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Menu Command Use to
Contents Display the Help application.
Live Alarm Data tab – Short Term Historical Alarms Alarm Reports tab – displays
displays all live alarms tab – displays historical data. report options and reports.
Live Alarm Summary Data Filter Definitions tab –
tab – displays a summary of edits the filter collection.
the alarm data.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
6.1.3 Status Bar
The following is an example of an Alarm Viewer status bar.
Alarm Source indicates whether the data displayed is from a live connection or is
historical, and if the data is filtered.
Filter Applied indicates the name of the filter applied or <Unfiltered> or No Filter. If a
single alarm file displays, File Contents also displays.
Alarm Data indicates the number of rows used for live or historical alarm data. If live
20019983-94.03.18.100-010-01-06-2017-INF
data is displayed, an icon indicates the update status of the screen. If the update is
interrupted, the icon displays in red. The icon turns green when the connection is
reestablished.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
7 Advanced Features
Refer to the sections Alarm The WorkstationST Alarm Viewer supports a number of advanced features that must be
Shelving and Out-of-service enabled in the ToolboxST application before they can be used. These features are Out of
and Alarm Parent Child. Service, Shelving, and Parent/Child.
These features are enabled in the ToolboxST System Editor, System propeerties. When
enabled, they are available plant wide.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
8 Live Alarms
Live alarms can be displayed from either a local or a remote Alarm Server.
Option Description
Default Column Organization Resets the column order from left to right to the default order
Auto Size Columns Click on this option to automatically adjust the width of all columns to display the data in
those columns.
Edit Column Filter Equation When filtering is applied, the element of the filter that applies to the column can be
edited. Changes made are automatically applied to the live alarms being displayed.
Multicolumn Sort Order Allows you to sort up to three columns of displayed data
Print Alarms Prints all alarms that display or could display if scrolled into view. Selection state and
alarm color is included. Only columns visible are printed
The Alarm Viewer can display the following items for each alarm.
Columns
Column Name Description
Acknowledged The acknowledged state of the alarm. (Yes = Acknowledged, No = Unacknowledged)
Actor ID The user ID of the operator that performed the last action.
Alarm Server The IP address of the Alarm Server being used as the source of the alarm.
Alarm State The current state of the displayed alarm or event. If the alarm state is Undefined, the OPC AE
alarm configuration must be added to the external OPC Servers in ToolboxST.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Columns (continued)
Last State The previous state of the alarm. If the previous state is unknown the displayed value will be blank.
Locked State The current state of the locked attribute. Used by the operator to control the alarm from being
updated. (L = Locked, U = Unlocked) Locked freezes the alarm. Unlocked allows the alarm to
update.
OPC Severity The severity of the alarm or event. (1 is a message, 1000 is critical)
Plant Area The logical plant area assigned to the alarm or event.
Primary Language The alarm description in the primary language. This is entered in the Description column for all
Description variables in the ToolboxST application.
Quality The quality of the alarm or event. When the quality is poor, the color changes to light gray on
white to indicate that the alarm is stale and its state may not be correct.
Rate The number of notifications received between updates of the display for a given alarm. Used as
an indicator to detect high rate of notifications per alarm. The threshold value default is 10 and
can be changed in Settings.
Recorded Time The time when the alarm was recorded by the alarm system (time received by the alarm server).
This allows you to find time-sync problems when the device time has not yet been set and alarms
are being generated. The units and precision are the same for Device Time.
Second Language The alarm alternate language description in the second language defined in the ToolboxST
Description application.
Service State The In Service or Out of Service state of the process alarm.
Service Time The time when the alarm was placed either In Service or Out of Service based on the Service
State value.
Shelved State The Shelved state of the process alarm.
20019983-94.03.18.100-010-01-06-2017-INF
Shelved Time The time when the alarm was placed either in the Shelved or Unshelved state.
Shelved Time The remaining time the alarm will be in the Shelved state, Time displays in the form, Days Hours:
Remaining Minutes:Seconds.
Sound The name of the source of the sound in the systems component in the ToolboxST application.
Symbol The symbol representing the priority, alarm state, and acknowledgement state of the alarm.
Type The type (alarms, events, holds, SOEs, or diagnostics) of the alarm being displayed.
Value The value of the alarm, either True or False, for Boolean alarms, or the current value of an analog
alarm.
Variable Alias The customer assigned variable alias name associated with this alarm or event.
Variable Name The fully qualified name of the variable associated with this alarm or event. Device names have a
unique prefix.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
8.2 Sort Alarm Data
Rest the cursor on the sort ➢ To sort by information in a single column: click the column header of the
arrow to display a ToolTip column to be sorted to display a sort arrow that indicates the direction of the sort.
describing the sort direction. Any column can be used to sort data. Re-selecting the same column toggles the sort
direction. Single-column sorting is the default.
Use the right / left icons to move the selected Use the up / down arrows to
column to the Columns Sorted text box . define major to minor sorting .
2. Click OK.
20019983-94.03.18.100-010-01-06-2017-INF
An arrow now displays on each column that was selected and the same
ToolTip displays when the cursor rests on either column header.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
8.3 Filter Live Alarms
Refer to the section Filters. The Alarm Viewer allows you to edit and apply filters that control the displayed alarms.
The filter toolbar is displayed in the following figure.
Note The special filter <Unfiltered> is available even if no filter collection is loaded.
selected, the drop-down list of filters is unavailable. Clicking the icon toggles the
priority filter on or off.
Selecting a filter automatically updates the live alarm display using the selected filter. The
column headers also update if the alarm data in a particular column is used in the filter.
Note The filter equation applied displays when the cursor is positioned over the
drop-down arrow of the filter list.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
All columns that have the ➢ To edit the applied filter: from the column header, click any of the red filter icons.
Filter icon displayed can be
Clicking the Filter icon for the Type column allows you to edit the filter term for that
edited. column. Changing the selection changes the display based on the new evaluation.
Changes made are reflected back into the current filter.
If no Filter icon is displayed in the column header, you can add the filter term for the
column. Right-click over the column header and select Edit Column Filter Equation from
the shortcut menu.
Note If the Edit Column Filter Equation item is unavailable, there is no filter allowed for
that column.
Note If no selection is made in a filter element, it is considered unused when the filter is
evaluated.
The Column Filter dialog box (obtained by clicking the Filter icon in the Type column)
allows you to change the alarm event types being filtered. Selecting the Events check box
displays both alarms and events.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
The Filter1 filter has been modified to display The new filter definition
both Diagnostic Alarms and Events . displays in the ToolTip.
Note The notification does NOT display if the Dynamic Priority filter is applied.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
8.5 Manage Alarms and Events
The Live Alarm Toolbar buttons are used to manage alarms and events. Additionally,
when you right-click in the live display area, a shortcut menu displays with additional
options.
Note Items that are unavailable are due to the current alarm conditions at the instant that
this menu displays (for example, if a selected alarm has already been acknowledged).
Note For computers running the WorkstationST Alarm Viewer V04.04 or later, an alarm
placed in the Out of Service state is displayed at all times (unless filtering is hiding the
alarm) until the alarm is placed in the In Service state. Acknowledging and resetting the
20019983-94.03.18.100-010-01-06-2017-INF
alarm while in the Out of Service state does not clear the alarm from the screen. If an
Alarm Viewer running an earlier version is also displaying the same alarm, the operator
cannot reset the alarm to clear it from the screen. There is no indication as to why the
alarm cannot be cleared. It is recommended that all computers using the WorkstationST
Alarm Viewer be upgraded to use V04.04 or later.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
The following tables display alarm and event management options:
Reset All On Screen Resets all alarms visible on screen. Does not include alarms that must be scrolled into view. All
connected clients see this action. Alarm selections are not required.
Silence All On Screen Suppresses the sound being annunciated for all alarms visible on screen. All connected clients
respond to this action. Only visible columns are printed. Alarm selections are not required.
When an alarm set is selected, the row(s) display(s) in blue. The selected alarm set may
be larger than can be displayed at one time. These actions are system-wide.
Alarm Selection
Action Result
Ctrl-A Selects all alarms visible on screen. Does not include alarms that must be scrolled into view. All
connected clients see this action. Alarm selections are not required.
Left Mouse Selects the alarm under the cursor and deselects all other selected alarms
Ctrl-Left Mouse Toggles the selected alarm under the cursor
Respond Dialog specific alarm response option. The display will be updated based on what the server
includes in the response.
User Comment Displays the Comments Included in the Historical Alarm Data dialog box. Allows the addition of
user comments in the selected language (Primary or Second).
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
The following menu items affect the selected alarm set. They have no impact on the alarm
state in the system.
Go To Display Screen Causes the HMI screen that contains the selected alarm to display. Selection is not
available if the HMI software is not installed.
Alarm Status History Selects a time frame of Ten Minutes, One Hour, One Day, or a User Defined Filter that
is used to retrieve the set of historical alarms that match the filter criteria. This historical
alarm data then displays in the Short Term Alarms tab.
The user-defined filter item is unavailable until the user defined filter is added to the
Options/Settings/User Defined Alarm Status History Filter Name option, and also is
defined in the current filter collection.
Display Variable Attributes Displays a data grid with the selected alarm variable attributes for the operator to
review.
Alarm Attributes Displays alarm attributes for the selected process alarm.
Alarm Help Displays help for the selected process alarm or diagnostic alarm if installed and
configured.
Print Alarms Prints all alarms that are displayed or could be displayed if scrolled into view. Selection
state and alarm color is included.
Copy Selection Copies the currently selected alarms into the clipboard. The copied alarms can be
pasted into Word® or Excel®.
Create Filter from Selection Creates a filter from the currently selected alarms and events.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
8.6 Alarm Shelving and Out-of-service
With ControlST V04.06, alarm shelving and an enhanced out-of-service feature are
provided. These features apply only to process alarms. Alarm shelving allows an operator
to temporarily suppress alarms from the WorkstationST Alarm Viewer filtered alarm
display, and from HMI screens that display alarms. The shelving command can be issued
from either the Alarm Viewer or selected screens on the HMI. Shelving capability is
supported in all Mark VIe controllers, the WorkstationST Alarm Scanner, and the
embedded OPC AE clients in the Alarm Server. The out-of-service feature allows an
operator to place an alarm into the out-of-service state or to return the alarm back to the in
service state.
To enable these features, refer The alarm shelving and out-of service features are similar. Dedicated out-of-service and
to the section Advanced shelved alarm displays are provided in the Alarm Viewer to reduce alarm information on
Features. the filtered alarm display. Both features are enabled through properties in the ToolboxST
System Editor. Refer to the ControlST Software Suite How-to Guides (GEH-6808), the
When enabled, these features section, How to Shelve and Place Alarms Out-of-Service for additional information.
impact alarm displays
throughout the system.
Refer to the ControlST The correct privileges must also be enabled for each operator in the system. This is done
Software Suite How-to Guides, using the Users and Roles feature in the System Information Editor. For alarm shelving,
the section, How to Define each user must have the Alarm Privilege and the Alarm Shelving Privilege enabled. For
Roles and Users in the alarm out-of-service, each operator must have the Alarm Privilege and the Alarm Service
ToolboxST Application. Privilege enabled.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Changes to these properties For alarm shelving, there are two properties in each Component Editor that must also be
require that the component be configured. These properties display in the Property Editor when a variable is selected in
built and downloaded. the Data Grid:
Alarm Shelving must be set to Enabled before shelving will be allowed on that variable.
Alarm Shelving Max Duration is the maximum time in minutes that the alarm can be
shelved.
20019983-94.03.18.100-010-01-06-2017-INF
When a set of process alarms is being shelved, the operator is prompted to enter an
expiration time for the shelving and a comment as to why the alarms are being shelved.
Once the alarms are shelved, the expiration time and the shelved time are used to
determine when the shelved alarm is un-shelved. When the shelve command is issued, all
alarm displays with alarm shelving enabled no longer display the shelved alarms. When
the expiration time expires, the alarms again display.
When a set of process alarms is being placed out-of service, the operator is prompted to
enter a comment as to why the alarms are being placed out-of-service. Once the alarms
are placed out-of-service, they must be manually placed in service to return them to their
normal function.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
When the Alarm Viewer is running and the Live Alarm Data tab is selected, the toolbar
displays icons that indicate enabled features:
Filters Available and Feed Alarms indicate the filters collection available for use.
When an icon is clicked, it becomes highlighted to indicate that the selected display
is active. Clicking it again toggles it back , activating the filtered alarm display.
Note If no icons are selected, the filtered alarm display is active. If the shelving or the
The status bar displays the total number of shelved and out-of-service alarms in the
control system. When either number is zero, that area of the status bar does not display.
Note In the Alarm Viewer, shelving and out-of-service commands can be issued from the
filtered alarm display. Shelving commands can also be issued from the shelved alarm
display to re-shelve the alarm with a new duration.
If an alarm that does not have When a set of alarms is selected, both the Shelve and Out-of-service icons are enabled on
the Alarm Shelving property the toolbar.
enabled is selected as part of a
set, it is not shelved.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Each Shelve Type is The Maximum Shelve Time
enabled if the device or The units can be changed displayed is the minimum of the
server supports the as necessary. set of selected alarms
shelving type and the
alarm selected is enabled
for shelving.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
8.6.1 Shelved Alarm Display
Alarms that have been shelved are removed from the filtered alarm display. Click the
Alarms displayed on the Alarms can be un-shelved or re-shelved by selecting the alarms and clicking the Shelve or
shelved alarm display screen
can be managed as in the Un-shelve icon . The following columns contain additional information:
filtered alarm display.
Shelved Time is the time the alarm was shelved.
Shelved Time Remaining is the amount of time the alarm will remain shelved. The
value is updated automatically.
Shelved State indicates that the alarm is in the shelved state.
Shelved alarms that also have Alarms can be removed from this display by un-shelving manually or when the Shelve
Auto Reset enabled are Time Remaining goes to zero. When either condition occurs, the alarms are removed
automatically un-shelved when from this display and return to the filtered alarm display.
not in the alarmed condition.
20019983-94.03.18.100-010-01-06-2017-INF
Note Shelved alarms do not play any configured sound or display blinking behaviors.
These behaviors are available in the filtered alarm display only.
The filtered alarm display automatically removes the shelved alarms from the display
when the feature is enabled, regardless of filters defined or selected. Filtering can be
applied to further reduce the alarms displayed.
The Shelved State is available as a filter definition. This is used when generating
historical alarm reports or performing alarm analysis. Setting the Shelved State while the
filtered alarm display is active has no effect.
When Alarm Printing is enabled in the WorkstationST Component Editor Alarm tab, the
shelve and un-shelve commands for each alarm are printed. However, any changes to
these alarms while shelved are not printed. Printing alarm changes for the alarms resumes
once the alarm is un-shelved.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
8.6.2 Out-of-service Alarm Display
Alarms that have been place out-of-service are removed from the filtered alarm display.
Alarms displayed on the Alarms can be placed out-of-service from the filtered alarm display by selecting the
out-of-service alarm display
screen can be managed as in alarms and clicking the Out-of-service icon . These alarms are only visible in the
the filtered alarm display. out-of-service alarm display, regardless of filters defined or selected. Place the
out-of-service alarms back into service by selecting the out-of-service alarm display,
select the alarms and click the Service icon . The alarms will be put back into service
and displayed on the filtered alarm display.
Note Out-of-service alarms do not play any configured sound or display blinking
behaviors. These behaviors are available in the filtered alarm display only.
The Service State is available as a filter definition. This filter can be set for In Service,
Out-of-service, or Unused and is used when generating historical alarm reports or
performing alarm analysis. Setting the Service State while the filtered alarm display is
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Note When selecting colors, unnamed colors display the RGB code in place of the name
in the data grid.
The symbol and color selected will display for parents and for children.
After enabling the Alarm Parent Child feature and configuring the symbol for the parent
and child icons, the variables must be configured in the controller to establish the parent
child associations. The following procedure shows the ToolboxST application
configuration to define four Boolean variables that are enabled as process alarms with one
parent and three interconnected child alarms.
This configuration can be visualized using the following diagram. In the application code
defined in the ToolboxST application, any combination of alarms available for display
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
8.7.1 Live Alarm Display
The Live Alarm display will show alarms based on the filter selected and the display
mode selected. The parent and child symbols will be shown for all alarms displayed on
the filtered Live Alarm Data display. The Dynamic Priority display, the Shelved Alarm
display, and the Out of Service Alarm display will not show the parent child associations.
this point but the alarms position in the hierarchy is denoted by the or symbol.
The user can select the or symbol to see the alarms that are available in the
specific alarms hierarchy for that alarm. When the symbol is selected, the list of all
available child alarms in the defined hierarchy is displayed in a dialog box.
Note This list excludes any alarms that have been shelved or placed out of service.
The following figure shows the parent alarm selected, along with all child alarms that are
available. Both displays can be used to interact with the alarms.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
When a child alarm is selected, the child name displays in the dialog box header, and all
alarms up to the parent display in the grid. In the following figure, the alarm A3 is
selected. The dialog box displays all alarms available up the hierarchy (in this example
A2 and A1).
8.7.2 Filtering
The Parent Child filter option has been added to the filter definition. This option can be
used to manage the alarms that are displayed using the parent or child configuration
information. The filtering selections are Parents Only, Children Only, and Unused.
Additionally, there is a check box selection Include Non-Parented Alarms. This allows
alarms that are not parented to also be displayed.
20019983-94.03.18.100-010-01-06-2017-INF
Note The Parent Child filter option is only used when displaying alarms on the Live
Alarm Data tab. The filter has no effect on any of the other alarm displays. This option is
hidden if the Alarm Parent Child feature is not enabled.
When Parents Only is selected on the existing applied filter, the display will be as
follows:
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Changing to Children Only displays the following:
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
8.8 OPC UA Alarms
Starting with ControlST V05.03, the alarm system supports an embedded OPC UA Alarm
client. This allows for connecting to an external OPC UA Alarm Condition Server.
8.8.1 Features
Live Alarms – Alarms from an external OPC UA Server are displayed and updated like
any other alarm in the control system. However, the following differences apply:
Comments – Comments can now be entered for any process alarm displayed (Context
Menu Only) from an OPC UA Alarm Conditions Server, an OPC AE Server, or from the
alarm scanner. Comments are not supported in Mark* controls products.
Comments With Acknowledge – Comments when acknowledging process alarms
can now be entered for any process alarm displayed from an OPC UA Alarm Conditions
Server, an OPC AE Server or from the alarm scanner. Comments are not supported in
Mark* controls products.
Note Acknowledge Comments must be enabled in the system overview property grid in
the ToolboxST System Editor.
Comments With Reset – Comments when resetting process alarms can now be
entered for any process alarm displayed from an OPC UA Alarm Conditions Server, an
OPC AE Server, or from the alarm scanner. Comments are not supported in Mark*
controls products.
Note Reset Comments must be enabled in the system overview property grid in the
ToolboxST System Editor.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Select the language
(Primary or Second)
to use.
Click OK .
One-shot Shelving – This optional feature shelves an alarm until one of two conditions
are met:
Dialog Conditions – This optional feature provides a request for action to the operator.
When the alarm is selected, a dialog box is displayed that presents the choices to the
operator. Once a selection has been made it is sent to the UA Server, which then sends a
response. The display is updated based on what the server includes in the response.
The following is an example from the AlarmConditionServer:
The Dialog Condition is displayed expecting a response from the operator.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
The icon is selected with the mouse, or Respond is selected from the context
menu.
A dialog box displays with the choices listed.
After a selection is made the dialog box closes and the selection is sent to the server.
In this example the Dialog Condition is removed from the screen indicating no further
action is required.
Branch Alarms – These are alarms that have not been acknowledged or reset by the
operator. Usually there is a current alarm that these are related to. In the following
example, AlarmConditionServer.NorthMotor.Green is the current active alarm. The
other two alarms are the alarms that were active but have not been acknowledged and
reset by the user. This is an optional feature and the extension added to the name of the
alarm is server specific. Alarm help is not supported for branched alarms.
Note The selection made on the screen overwrites the variable(s) defined in the filter.
Refer to the section Filters.
To display and manage this The results of the filter are displayed in the Short Term Historical Alarms display tab.
information, refer to the
section Historical Alarms.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
8.10 Alarm Symbols
To configure Alarm Symbols Starting with ControlST V04.06, Alarm symbols can be displayed in the Alarm Viewer in
refer to the ToolboxST User both the Live Alarm Data display and the Live Alarm Summary Data display. The
Guide for Mark Controls symbols must be defined and configured in the ToolboxST application before they are
Platform (GEH-6700), the available for display in the alarm viewer.
section, System Information
Alarm symbols represent alarm conditions being displayed. The symbol is a combination
Editor.
of the selected shape, the shape color, the alarm state, acknowledged state, and priority.
The color used comes from the alarm class associated with the variable. The Symbols
column must be made visible in the Live Alarm Data display for symbols to display. The
Live Alarm Summary Data display automatically displays the symbol that corresponds to
the alarm data in the respective column.
Example:
In the System Information Editor, under the Alarm System, Classes item, the following
are defined:
The alarm class LVL_1 is associated with a variable in the controller and is declared to be
an alarm. The symbol displayed indicates the priority (number inside the symbol), the
alarm and acknowledged state (represented by the text and background color). A typical
Alarm Viewer Live Alarm Data display using symbols is shown in the following figure:
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
The Rate symbol displays in With the exception of the Rate symbol, the same symbols display on the Live Alarm
the Rate column as shown in Summary Data display as shown in the following figure:
the second figure.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
8.11 Sound Options
The Alarm Viewer can play sounds defined as part of the Alarm Class definition in the
ToolboxST configuration. Sound options include Tone, Wave-File, and Voice. Once
defined, they are assigned to an alarm class for variables. The Alarm Viewer updates the
displayed alarm data approximately once a second. During the update, the Alarm Viewer
detects the highest-priority alarm that is active, unacknowledged and not silenced, and
plays the sound for that alarm. If the sound is defined as Voice, the Alarm Viewer states
the phrase Priority <Value><AlarmType><Description>, where Value is the priority value
of the alarm or event.
Note Sound will only be played by the Alarm Viewer for process alarm type alarms
(Type = Alarm).
Alarm Type is the type of alarm/event and is a separate column in the alarm viewer. These
types are distinctly different in there uses. The types are:
• Alarm – Generated from the controller block-ware or the Workstation and are
considered process alarms. The alarm class Alarm will be used if an alarm class is not
assigned to the variable during configuration. These alarms are actionable by the
operator.
• Event – Generated from the controller block-ware or the Workstation and is used to
provide non actionable information to the operator. The alarm class Event will be
used if an alarm class is not assigned to the variable during configuration.
• Hold - Generated from the controller block-ware and is used holds for steam turbine
applications. The alarm class Hold will be used if an alarm class is not assigned to
the variable during configuration. The hold is considered actionable by the operator
when used in a steam turbine application.
• SOE – Generated by controller I/O subsystem and uses the alarm class SOE and
cannot be overridden.
• Diagnostic - Generated by the controller and by the I/O subsystem and uses the
alarm class Diag and cannot be overridden.
Description is the description assigned to the variable in the ToolboxST configuration. An
example of a phrase would be: Priority 1 Process Alarm,
GasAuxiliaryStopPositionFilterPre-IgnitionTrip
20019983-94.03.18.100-010-01-06-2017-INF
Note Using abbreviations in the variable description results in a garbled voice message.
➢ To set the sound options: From the Alarm Viewer toolbar, click Options and
Settings. The Settings dialog box displays and allows you to configure the sound
options.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
8.12 Alarm Attributes
Alarm attributes can be displayed for process alarms in the Alarm Viewer. Alarm
attributes cannot be displayed for non-process alarms such as holds, SOE, and such.
➢ To display alarm attributes: from the Alarm Viewer, in the Live Alarm Data
display, right-click on a process alarm and select Alarm Attributes from the
drop-down menu.
Refer to the table Alarm The Alarm Attributes Display window displays for the selected process alarm.
Attributes for a complete list
and description.
The left-hand side of the window displays the alarm attributes in a grid. Sort the attributes
by clicking the Organize Attributes button, or right-click the header of the data grid
and select Organize Attributes.
Refer to the section Alarm The right-hand side of the window displays the alarm help and comments for the selected
Help. alarm in the language selected in the combo box.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Alarm Attributes
Attribute Name Description
Acknowledged Indicates if the alarm is currently acknowledged
The value assigned when the alarm is in the active state. Used for filtering and display
Active Severity in the Alarm Viewer. Valid range is from 1 – 1000, where 1 is the least severe. Range
and usage defined by OPC for use in OPCAE servers and clients.
Alarm On Zero When True, causes the alarm on a 1 to 0 transition. Requires alarm = True
Alarm Server The IP address of the Alarm Server that is being used as the source of the alarm.
Alarm Shelving Max Duration The max duration the alarm can be shelved as configured in the Component Editor.
Enable or disable the Return to Normal (RTN) Unacknowledged alarm state. RTN is
Auto Reset reached when the process returns to within normal limits and the alarm clears
automatically prior to the operator acknowledging the alarm.
For Deviation alarms only, the threshold value that is compared to the current value.
Compare Value† This difference is checked to see if it exceeds the set point to determine if an action is
to be performed.
The time (in milliseconds) to wait after the set point has been exceeded before an
Delay Time†
action is performed.
The description text displayed follows the Option menu Display Language setting, or
Description
the WorkstationST Status Monitor tray icon Regional Settings selection.
The timestamp when the alarm transitioned to its current state. (The time units change
Device Time (UTC)
based upon the Alarm Viewer settings.)
The default upper limit for displays on the HMI (such as bar-graph or trending
displays). If a format spec has been specified, and this display high attribute is not
specified, the format spec engineering max is used.
Display High Limit†
When a measurement system is selected, HMI applications scale the display limits
accordingly.
The default lower limit for displays on the HMI (such as bar-graph or trending displays).
If a format spec has been specified, and this display low attribute is not specified, the
format spec engineering min is used.
Display Low Limit†
When a measurement system is selected, HMI applications scale the display limits
accordingly.
EGD Page The Ethernet Global Data page for this variable.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Alarm Attributes (continued)
Enable Rate Failure† When True, the Rate Failure alarm is configured.
This value represents the amount that the data value must change before it is sent to
Historian Deadband
the Historian.
The definition of the Historian Deadband value (engineering units, percentage of
Historian Deadband Definition
range).
The current state of the locked attribute. Used to freeze the update of an alarm on
Locked State
screen.
Measurement System The measurement system currently selected.
The value assigned when the alarm is in the normal state. Used for filtering and display
Normal Severity in the Alarm Viewer. Valid range is from 1 – 1000, where 1 is the least severe. Range
and usage defined by OPC for use in OPCAE servers and clients.
20019983-94.03.18.100-010-01-06-2017-INF
Precision† The number of digits to display to the right of the decimal point.
Priority The priority of the alarm as defined in the alarm class assigned to this variable.
The timestamp for when the Alarm Server received the alarm. (The time units change
Recorded Time (UTC)
based upon the Alarm Viewer settings.)
This value represents the amount that the data value must change before it is stored by
Recorder Deadband
the Recorder.
The definition of the Recorder Deadband value (engineering units, percentage of
Recorder Deadband Definition
range).
Second Language Description The second language description for this alarm.
Service State The current service state (applies to process alarms only).
The time that the Service State occurred for the process alarm (N/A for all other alarm
Service Time (UTC)
types). (The time units change based upon the Alarm Viewer settings.)
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Alarm Attributes (continued)
Severity The assigned OPC AE severity value for the given state.
The time the alarm was shelved (N/A if not enabled). (The time units change based
Shelved Time (Local Time)
upon the Alarm Viewer settings.)
Shelved Time Remaining The amount of time remaining before the alarm is unshelved (N/A if not enabled).
Normal Connection
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
9 Live Alarm Messages
This display in the WorkstationST Alarm Viewer provides the ability to view incoming
alarm notifications as they are generated within the control system.
Note The WorkstationST Alarm Viewer must be connected to a live alarm source for this
feature to work correctly.
➢ To enable the Live Alarm messages display: From the View menu, select
Show Live Alarm Message and the Live Alarm Messages tab.
The display is used to aid in troubleshooting fleeting, chattering, and dithering live alarms
in the system. The newest alarm received is always displayed at the top of the screen.
Sorting by columns is not supported.
The features available in the display are:
• Filtering – Used to display only the alarms that are being investigated.
• Max Rows – Used to limit the number of alarms displayed on screen.
• Clear Screen – Clears the screen of all alarms.
• Freeze Screen – Prevents the updating of alarms on screen. The screen can be
scrolled and the alarm data that has been captured can be viewed. All new incoming
alarms received are discarded while the screen is frozen.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
The columns available for display when Organize Columns is selected are described in
the section, Managing Columns. In addition, the following columns are available:
Composite State – Displays the alarm symbol if defined, followed by the alarm state.
The additional alarm state information is also displayed from left to right using the
following format:
L for Locked, K for Acknowledged, S for Silenced, H for Shelved, O for Out of Service.
If the alarm is not in the above states a “-“ is displayed.
Example: Hi alarm that has been acknowledged and shelved would be Hi [-K-H-]
Reason – The cause for the notification being sent.
20019983-94.03.18.100-010-01-06-2017-INF
The following figure shows the Live Alarm Messages tab with Max Rows set at 1000 and
Freeze Screen selected.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
10 Live Alarm Summary
With ControlST V04.06 a new capability has been added that provides an alarm summary
based on a number of criteria selected by the user.
The Live Alarm Summary Data screen is divided into three sections; summary display
(upper left), summary filtering (lower left), and summary detail display (right panel). The
summary totals display in a data grid in the summary detail. If symbols are defined, they
display in the same column as the totals. A gray scale option changes how the summary
display uses color. The following figures were taken with gray scale set to true. With gray
scale set to false, the color defined in the alarm class is used as the background color for
the cell. Live Alarm Summary Data display options include:
Summary By Device displays totals by device. The columns represent the Device
Name, total Active Unacknowledged, Active Acknowledged, Normal Unacknowledged,
Normal Acknowledged, Shelved, Out-of-service, Locked, Parent, and Child alarms.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Summary By Device and Priority includes the priority column. This displays the
alarm summary by priority by device.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
The Summary By Device and Summary By Device and Priority displays can be filtered by
using the device filter in the summary filtering section of the screen. No selections in the
summary filtering section indicate that the screen data is unfiltered.
Note Since Plant Area is optional, any alarm without a Plant Area defined will be
included on the row in the data grid with the Plant Area blank.
Summary By Plant Area and Priority produces totals by priority and plant areas in
the system.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
The Summary By Plant Area and Summary By Plant Area and Priority displays
can be filtered by using the Plant Area filter in the summary filtering section of the
screen. No selections in the summary filtering section indicate that the screen data is
unfiltered.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
11 Connect
The Alarm Viewer allows you to display alarm and event data from all alarm servers
accessible in the system.
3. If the appropriate Alarm Server is not on the list, click Add a Connection.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
4. Enter the Host (either the name or IP Address) and click OK.
5. The Alarm Server displays in the list. Select the Connection and click OK.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
12 Historical Alarms
The Alarm Viewer allows you to display alarm and event data from the short-term
historical alarm data file collection on the connected Alarm Server. When no alarm data
displays, the filters toolbar displays as follows:
Clicking the Find button displays the Find dialog box, used to find specific information in
the alarm data displayed.
Alarm data from one or more alarm data files displays in table form based on the filter
selected from the drop-down list. Summary information in table or plotted form can also
be displayed.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
➢ To display the historical alarms screen
1. From the View menu, select Connect
2. From the Remote Connection To WorkstationST Alarm Server dialog box,
select the Alarm Server to use. (or Click Add a Connection, enter the Host (name
or IP Address) and click OK to add the correct Alarm Server to the list.)
Note The checked item indicates the connection that is to be used. The selected row is
used when the Resolve button is pressed
3. Click OK.
4. From the View menu, select Show Historical Alarms. The Short Term Alarms
tab is enabled, but no alarm data displays.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Note If Local Mode is selected, the data is retrieved from the Historical Alarm Files on
the local computer. If Remote Mode is selected, the data is retrieved from the Historical
Alarm Files on the remote computer.
• The number of rows returned is clamped at 50,000 unless a filter is defined and the
Maximum Alarm Rows To Return option in the filter definition is non-zero.
• The text in the selected tab is Short Term Historical Alarms – Unfiltered.
• Historical displays as the Alarm Source in the status bar.
Comments The user comments displayed following the WorkstationST Use Second Language selection.
Composite State A string that represents the alarm state and all additional command states of the alarm. (L for
Locked, A for Acknowledged, Sl for Silenced, Sh for Shelved, O for Out of Service)
Override State The Hold Override state of the alarm. (Yes = Overridden, No = Override Removed)
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
12.2 View a Single File
The Historical information in a single alarm data file from a collection can also be
displayed.
Note To restore viewing of all Alarm Data, the Alarm Data Display must be closed by
selecting Close Alarm Data File from the File menu.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
12.3 View All Files
Once the historical alarm file source has been selected, the information in the files can be
displayed in various ways.
Note To update the initial historical data display, select a filter from the drop-down list.
Selecting a different filter always applies the new filter to the current alarm data file
selected.
When the Charts button is clicked, the alarm data displays in table form (the default).
When the Summary button is clicked, summary information displays.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
From the Tree View , select Device Summary to
display summary information for all devices and all
alarm/event types.
Note When the selection is changed to an item in the Device Summary, the
corresponding alarm summary displays and a new chart button is added to the toolbar. No
alarm summary information is displayed, and the chart button is removed from the toolbar
if the Time Range Summary item is selected.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
The following are examples of the four different chart types that are available:
• Transitions Frequency – A Pareto chart that is scaled to the largest frequency value
found.
• Transitions Pareto – A Pareto chart that is scaled to display the data scaled as
percent of the total frequency found. A cumulative percent line from highest to
lowest frequency displays.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
• Priority – A Pareto chart of the highest frequency by priority. The chart starts with
the alarms grouped from highest priority to the lowest priority.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Refer to the section Historical By selecting the alarm types for a single device in the tree, a Pareto chart of the alarms
Chart Settings for Alarms per and events that occurred within the hour displays.
hour options.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Right-click anywhere in the chart area to display the Settings dialog box and select
Historical Chart Settings to display options for the chart.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
13 Filters
A filter contains one or more terms that can be configured. These terms, which
correspond to the column names of the live or historical alarm data display, can be edited
to provide filtering capability. Filters used in this application are pass-through filters. The
alarm/event data displays if the evaluation of the filter is True for the alarm/event.
Created filters are immediately available for use in both the live and historical displays.
➢ To create a new filter collection: from the File menu, select New Filter
Collection. A new filter collection is created with a default filter named Filter1.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
The Tree View displays The File Name used to The filter Name and
all filters in the collection . store the filter collection. Description .
Enter a number from 0 to 60 to specify the time Enter a value that limits the number
in minutes the filter is allowed to be applied . of historical alarms that display.
The default configuration for a new filter added is Display All Alarms.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
13.2 Alarm Filter Timeouts
With the release of ControlST V04.07, a Filter Timeout field has been added to the alarm
filter definition. This allows a timeout value to be entered that specifies the time in
minutes the filter is allowed to be applied when used on the live alarm display. The
behavior is as follows:
When the filtered live alarm data screen is displayed, alarm filters can be selected as
before. If a filter has a timeout defined, the alarm filter in the available filters drop-down
list displays in a distinct color, with a clock icon to indicate that the time is limited to the
time defined in each filter.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
After selection, the filter name displays with the clock icon and in the timed color.
Upon expiration of the time specified, the filter selection reverts to Unfiltered as shown in
the following figure.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
13.3 Edit a Filter
➢ To edit a filter: from the Tree View, select the filter element name. A dialog box
displays to allow you to edit the filter element.
Note Alarm Class displays all alarm classes defined in the ToolboxST configuration for
the current system.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Device Time specifies a number of time-filtering options for filtering on the time of the
alarm or event. The options are:
Note It is recommended that the option Time Type for Display be set to the same units as
the units defined here.
Severity filters on the OPC AE Severity value of the alarm/event. The operators defined
are <=, =, or >=.
Silence filters on Silenced, Normal or both of the alarm or event.
Shelved State filters on Shelve, Unshelve, or Unused. A Not Selected option is also
available.
Variable Alias filters on the alias name of the alarm or event. The definition can be a
single variable or a list of variables. Wildcard characters ? and * are supported.
Variable Name filters on the alarm or event name. The definition can be a single
variable or a list of variables. Wildcard characters ? and * are supported.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
14 Alarm Viewer Settings
➢ To access Alarm Viewer Settings: from the Alarm Viewer Options menu,
select Settings.
or
➢ Right-click any tab and select Settings from the shortcut menu.
Alarm Help
20019983-94.03.18.100-010-01-06-2017-INF
Master Workstation Host Name is the host name that is the source of the
Process Alarm/Diagnostics Help.
Communications
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Filter Options
Add Default Filters, if True, opens the file DefaultFilters.xml (if found) and
adds all contents to the new filter collection being created. The DefaultFilters.xml
file is generated by creating and editing a set of filters and then saving them to
the file named DefaultFilters.xml. This file must be located in the Filters folder of
the Alarm Configuration Root Path.
Load Last Used Filter, if True, loads the last filter file. The filters can then be
selected and applied.
User Defined Alarm Status History Filter Name is the name of the filter
to locate and apply when selecting the Historical Status.
Local Settings
Alarm Configuration Root Path sets the path to the Alarm Viewer root
configuration directory. All views, filters, and sound filters are located under this
directory.
Alarm Export Path is the path used when the current alarm display is
exported to a .csv file.
Alarm Files Path is the path used when Use Local Workstation Alarm
Configuration is set to False.
Export CSV data with headers, if set to True, writes the headers when the
alarm data is exported to a .csv file. If set to False, no headers are written. Only
the visible columns are written.
Use Local Workstation Alarm Configuration, if set to True, uses the
workstation configuration on this computer. If set to False, uses the local Alarm
Files Path to point to the alarm data to process.
Startup Settings
Display Style selects either a resizable, movable form or a fixed size and
fixed position form.
20019983-94.03.18.100-010-01-06-2017-INF
Show Main Menu, when True, displays the main menu. When False, the
main menu is hidden.
Show Startup Splash Screen, when True, displays the startup splash
screen. When False, the startup splash screen is suppressed when the Alarm
Viewer is started.
Show Status Bar, when True, displays the status bar at the bottom of the
screen. When False, the status bar is hidden.
Show Toolbar, when True, displays the toolbar. When False, the toolbar is
hidden.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Viewer Display Options
Alarm ID in Hex, when True, displays the alarm ID in hex. When False, the
value is displayed as a decimal.
Always On Top, when True, keeps the Alarm Viewer on top of all other
windows.
Enable Non-Translated Content displays only when the Alarm Viewer is
configured to display in a language other than English. When True, it enables
access to non-translated documentation and advanced features of the
WorkstationST Alarm Viewer that are not translated into the selected display
language.
Image Size, sets the size of the images displayed on the Live and Historical
toolbars.
Main Font changes the font used for all items displayed.
Show Text With Toolbar Buttons, when True, displays the text for each
toolbar button displayed.
Time Type for Display defines the time type that displays. The selections are
UTC Time, Site Time, or Local Time. Local and site settings use the local time
zone to calculate the time for display.
Setting this option to 'True' will enable access to features and documentation
that may not be translated into the current Windows display language.
When displaying English, this option is hidden and set to True, allowing access to
all features and documentation.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
14.1 Live Settings
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Alarm Management Group Toolbar
Show Filter Collection Name hides or displays the filter collection name.
Show Filters Available Label hides or displays the Filters Available label.
Show Page Down Button hides or displays the Page Down button. Used to
control scrolling when using a touch screen.
Show Page Up Button hides or displays the Page Up button. Used to control
scrolling when using a touch screen.
Show Reset All Command Button hides or displays the Reset All
Command button.
Show Toolbar hides or displays this toolbar.
Show Zoom In Button hides or displays the Zoom In Button. Used to
increase the font size used for display.
Show Zoom Out Button hides or displays the Zoom Out Button. Used to
decrease the font size used for display.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Display
Disable Blinking overrides the configured blink value in the Alarm Class
definition for the system. Alarm Class configuration is defined in the ToolboxST
System Editor.
Enable Gray Scale when True, enables gray scale rendering and allows the
Enable Vertical Colored Bar option to display. The Symbols column must be
used to provide plant alarm conditions feedback.
Enable Vertical Colored Bar provides alarm state feedback using a vertical
colored bar displayed in the 2nd and last column on screen. These are always
displayed regardless of the alarm viewer windows size or scrolling position. If the
Enable Gray Scale option is false, the Enable Vertical Colored Bar option is
forced to false and is hidden in the options dialog.
Notification Rate Threshold the threshold value for the maximum number
of notifications allowed before an icon indicator is displayed. A value of 0
disables the icon. The update rate is set by the Rate Units selection.
Rate Units the unit of time that notifications are accumulated before being
reset back to 1.
Row Height Percentage is the height of the row calculated as a percentage
of the text height displayed. The value must be between 0 and 100. A value of 0
displays the most rows on screen. A value of 100 displays the fewest number of
rows. Increase the number to improve readability.
Show Column Headers, when True, displays the column headers. Hiding the
headers prevents the reorganization of columns and prevents changing the
selected sort direction.
Show Dynamic Priority Display Button hides or displays the Dynamic
Priority Display button. Used to display alarms based on cascading priorities.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Sound Configuration
Play Sound Continuously, when True, causes the sound configured for the
highest-priority alarm to play repeatedly until the operator takes action to silence
the alarm.
Play Sound Continuously Repeat Delay is the time delay, in seconds,
before repeating the sound for the highest-priority alarm. Play Sound
Continuously must also be set to True.
Time To Disable Mute Sound Button is the time delay, in minutes, before
resetting the button when the Mute Sound Button is clicked. While the mute
button is active, all sound is suspended. When this time expires, sound is played
again. A value of 0 mutes the sound indefinitely.
Sound Toolbar
Show Alarm Horn Command Button displays or hides the Alarm Horn
Silence Command button.
Show Mute Sound Button displays or hides the Mute Sound button.
Show Silence All Command Button displays or hides the Silence All
Command button.
Show Silence/Unsilence Command Button Set displays or hides the
Silence/Unsilence Command button.
Show Toolbar displays or hides this toolbar. If the toolbar is not displayed, the
functionality provided by this toolbar is disabled. Sound will still be played if
configured in the system.
Voice Options
Use Second Language Description Text, when False, uses the text
description. When True, uses the second language description text as the
phrase spoken when Voice is the sound type configured.
20019983-94.03.18.100-010-01-06-2017-INF
Enable Alarm Symbols when True displays alarm symbols in the Composite
State column if alarm symbols have been configured for use in the control
system.
Enable Vertical Color Bar when True enables display of a vertical colored
bar that tracks the alarm background color.
Center Color for Active Transitions Bar Color is the color for the center
of the Active Transition state bar when a chart is displayed.
Edge Color for Active Transitions Bar Color is the color for the edge of
the Active Transition state bar when a chart is displayed.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Alarms Per Hour
Alarm Type Center Color is the color for the center of the Alarm Type
displayed.
Alarm Type Edge Color is the color for the edge of the Alarm Type
displayed.
Diagnostic Type Center Color is the color for the center of the Diagnostic
Type displayed.
Diagnostic Type Edge Color is the color for the edge of the Diagnostic Type
displayed.
Event Type Center Color is the color for the center of the Event Type
displayed.
Event Type Edge Color is the color for the edge of the Event Type displayed.
Hold Type Center Color is the color for the center of the Hold Type
displayed.
Hold Type Edge Color is the color for the edge of the Hold Type displayed.
Increasing Time Table Sort Direction Set to True to sort the time labels
in increasing order (from oldest time to newest time). Set to False to sort in
decreasing order (from newest time to oldest time). The time display format is
Month-Day Hour:Minute:Second.
Show Time Label Sort Direction Set to True to display the hour time label
on the x axis for data that is not defined for that hour. Set to False to skip
displaying time for no data.
SOE Type Center Color is the color for the center of the SOE Type
displayed.
SOE Type Edge Color is the color for the edge of the SOE Type displayed.
Background Color
Bottom Gradient Color is the gradient color at the bottom of the chart
20019983-94.03.18.100-010-01-06-2017-INF
displayed.
Top Gradient Background Color is the gradient color at the top of the chart
displayed.
Chart Options
Show Alarm/Event types for each variable, when True, draws bars for
each alarm/event type for all variables.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Show Alias Names, when True, the Alias name displays in the chart. When
False, the standard variable name display behavior is provided. The variable
names are displayed on the bars and also displayed in the ToolTip.
If the alias name to be displayed is blank, the variable name displays instead.
Depending on the configuration, there can be a mixed display of alias and variable
names on the same chart.
Show Bar Text, when True, displays the text inside or above the bar as
necessary. When False, no bar text is displayed.
Show cumulative percent line plot, when True, draws the line connecting
the first series of bars representing total percent of the data displayed. This
option only works if the Chart Type selected is Pareto.
Text Angle is the alarm/event display angle on the screen, and has a range of
0 - 90 degrees.
Starting with the Deviations Transitions Bar Color, the remaining Transitions Bar
Color options use the same definitions as explained previously in the Active
Transactions Bar Code section of this list
The three alarm states (Hi, HiHi, and HiHiHi) designate increasing levels of severity,
or concern, for an alarm in this category. (The higher it gets, the more critical it is.)
Hi Transitions Bar Color
HiHi Transitions Bar Color
HiHiHi Transitions Bar Color
Inhibited Transitions Bar Color
The three alarm states (Lo, LoLo, and LoLoLo) designate increasing levels of severity,
or concern, for an alarm in this category. (The lower it gets, the more critical it is.)
Lo Transitions Bar Color
LoLo Transitions Bar Color
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
15 Views
With the View menu, a set of parameters can be configured to view in a given situation.
When saved, the view will return to the same set of parameters at any time.
➢ To create a view
1. From the View menu, select Local Mode or Remote Mode, Show Live Alarms,
and Show Historical Alarms as appropriate. Refer to the section Live Alarms.
2. Select the Live Alarm Data tab and organize the columns as they need to be
displayed. Refer to the section Live Alarms, Organizing and Displaying Columns.
3. Sort the alarm data as required. Refer to the section Live Alarms, Sorting Alarm
Data.
4. Create and name the necessary Filter Collection. Refer to the section Filters, Filter
Collections.
Note If you have filters defined from previous versions of Alarm Viewer, you can
manually copy them to the Filters subdirectory.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
6. Set the Alarm Configuration Root Path to a directory that contains all Filters,
Views, and Sound Files in one location. It is recommended that the root directory
be named AlarmViewerConfiguration. The Filters, Views, and Sound Files
subdirectories are created automatically under the root directory.
Note At this point, the Alarm Viewer should be configured to display all the necessary
parameters. Once you ensure this, proceed with the final step.
7. From the File menu, select Save View As. The file browser defaults to the View
subdirectory. Save the view using a name that describes the view state.
Or
8. Right-click any tab and select Save View As from the shortcut menu.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
15.2 Open a Saved View
➢ To open a saved view: From the File menu, select Open View.
Or
1. Right-click any tab and select Open View from the shortcut menu.
2. Select the desired view, then click Open. The selected view displays.
Note The Short Term Historical Alarms tab does not automatically apply and display the
filter selected. You must apply the filter to update the Short Term Historical Alarms
display.
➢ To apply a filter to the Short Term Historical Alarms display: with the
Alarm Viewer, open to the correct view, select the Short Term Historical
Alarms tab and from the drop-down list, select the required filter.
➢ Right-click any tab and select Recent Views from the shortcut menu.
and saved. This view generates a historical alarm report on the variables passed into the
WorkstationST Alarm Viewer when started from CimView.
Refer to the WorkstationST This view file is also used to animate the alarm button on the navigation bar in CimView.
CIMPLICITY Advanced Viewer The animation is controlled by an alarm status client running in the background when
Integration Instruction Guide CimView is running. This client reads the CimplicityAlarmStatusHistory.AvView file to
(GEI-100697). perform the connection to the designated alarm servers. A filter named AlarmStatusFilter
is created to allow only process alarms to be received by the alarm status client.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
15.5.1 Create a CimplicityAlarmStatusHistory View File
➢ To create the CimplicityAlarmStatusHistory View file
1. From the Start menu, select All Programs, GE ControlST, and WorkstationST
Alarm Viewer. The WorkstationST Alarm Viewer screen displays.
2. From the View menu, select Local Mode or Remote Mode to select the Alarm
Server to use.
3. From the Options menu, select Settings to display the Settings dialog box.
4. Select Alarm Viewer Settings, expand Local Settings, and note the Alarm
Configuration Root Path.
The Short Term Historical 5. From the File menu, select Save View As.
Alarms tab display (such as
6. Verify the file path matches the Alarm Configuration Root Path noted earlier.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
16 Alarm Reports
Starting with ControlST The Alarm Reports feature analyzes alarm data to compute and display the performance
V04.04, the WorkstationST metrics of the alarm system based on ISA 18.2 recommendations. All the metrics are
Alarm Viewer includes an computed based on the alarm data available for the reporting period as defined by the
Alarm Reports feature. selected alarm filter. The reporting period is selected by the user and is sorted on a range
of dates, hours, and minutes.
In addition to frequency-based reports the Alarm Reports feature provides for the creation
of alarm metrics, including the most frequent alarms, alarm flood, stale alarms, and
chattering alarm reports. These reports would be used as part of the continuous
improvement of the control system.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
The Alarm Reports tab displays
with the Alarm Reports options,
including Filter Criteria .
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
16.1 Report Options
The following figure displays the report sorting options; Alarm Reports, Report
Configuration, and Filter Criteria including Time Range, Alarm Types, Devices, Priority,
and Plant Area.
Note When creating reports that are targeting ISA 18.2 metrics, expand the Alarm Types
section and select Alarm only. This ensures that all reports generated are for process
alarms only.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
20019983-94.03.18.100-010-01-06-2017-INF
Refer to the following sections for additional information on the reports available.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
16.1.1 Alarm Reports
Alarm Performance Metric Report – Select to display the Alarm Metrics Report.
Alarms Per Day – Select to display the number of alarms created per day during the
selected time range.
Alarms Per Hour – Select to display the number of alarms created per hour during the
selected time range.
Alarms Per Ten Minutes – Select to display the number of alarms created per ten
minute period during the selected time range.
Refer to the section, Terms for Alarm Flood Report – Select to display the number of alarm floods, as defined in the
a definition of alarm flood and section Percent Display Options, during the selected time range.
alarm chattering.
Chattering Alarms – Select to display chattering alarms. Use the Chattering Alarm
Definition options to define the chattering parameter (such as an alarm transitioning three
times in a one minute period).
Stale Alarms – Select to display alarms that remain in effect continuously for more than
24 hours.
Top Most Frequent Alarms – Select to display the most frequently occurring alarms.
Use the Maximum Alarm Quantity to determine the setpoint (such as top 10, top 15, top
20 and so forth).
Start Flood Alarm Quantity – Defines the quantity of alarms that must be exceeded
within the defined Flood Time Interval for the alarm flood to be detected.
Show Threshold Quantity on Bar Chart – Used to determine the number of time
slices that exceed the Threshold Quantity. When selected, displays a horizontal line at the
designated Threshold Quantity level on the bar chart.
Show Percent Pie Chart – Select to display the Alarm Quantity Percentage Pie Chart
tab and chart that displays the percentage of alarms above and below the designated
Threshold Quantity.
Threshold Quantity – This is the transitions value used as a threshold to calculate the
percentage of time that exceeds this value. It is the actual number of transitions displayed
on the bar chart.
Transition Quantity – Displays when creating a Chattering Alarms report. This defines
the number of transitions that must be exceeded within the defined Time Interval for the
chattering alarm to be detected.
Time Interval – Displays when creating a Chattering Alarms report. This is the time
period in minutes over which the chattering alarms option is defined (such as an alarm
transitioning three times in a one minute period).
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Note When creating an Alarm Performance Metric Report or a Stale Alarms report the
Report Configuration section does not display.
Note The format of the Start Time and Stop Time criteria is based upon the Alarm
Reports option selected (Day, Hour, or Ten Minutes).
16.1.6 Devices
This filters on the devices that are the source of the alarms.
16.1.7 Priority
Filters on the priority value associated with the alarm or event. The operators defined are
<=, =, or >=. The range is from 1 to 99 with 1 being the highest priority.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
16.2 Create Alarm Report
➢ To create an alarm report
20019983-94.03.18.100-010-01-06-2017-INF
Note When Alarms Per Day, Alarms Per Hour, or Alarms per Ten Minutes is selected,
the appropriate Threshold Quantity is enabled in the Report Configuration section.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Note When Unfiltered is selected, the Filter Criteria cannot be saved for future use. To
save a filter selection, an existing filter must be selected from the drop-down menu.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
When creating an Alarm Flood Report, the Alarm System Flood Definition criteria
display. A bar chart is not created.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
When creating a Top Most Frequent Alarms report, the Frequent Alarm Maximum
Quantity option displays.
When creating a Chattering Alarms report, the Chattering Alarm Definition criteria
display. A pie chart is not created.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
When creating a Stale Alarms report, there are no display options available and a pie
chart is not created.
When creating an Alarm Performance Metric Report, the Report Configuration section
changes to allow entry of criteria for all other reports. A Restore Defaults option is
included to set the criteria to ISA standards. Data displays in tabular form only.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
20019983-94.03.18.100-010-01-06-2017-INF
Note After selecting Create Report a progress dialog box displays. The amount of time it
takes to create the report varies based upon the size of the database.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
16.3 Report Results
The following are representative samples of the reports created:
Note When Alarms Per Day, Alarms Per Hour, or Alarms per Ten Minutes is selected,
the tabs and reports display in the corresponding time segments.
Note For all tabular data reports (first tab in each report), right-click the header row and
select Organize Columns to configure which columns display.
Report Configuration – Displays the report configuration options and their selected
values. This tab displays for each type of report created.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Alarm Performance Metric Report – Displays the Alarm Metrics Report in tabular
form.
Alarm Quantity Per Hour Data – Displays the report data in one hour segments in
tabular form.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Alarm Quantity Per Hour Bar Chart – Displays the data in one hour segments in bar
chart form.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Alarm Quantity Percentage Pie Chart – Displays in blue the percentage of hours
that exceeds the Threshold Quantity entered in the Display Options section.
Alarm Flood Summary – Displays the time periods when an alarm flood has occurred
in tabular form.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Alarm Flood Load Percentage – Displays the number of time periods during which a
defined alarm flood occurs as a percentage of the selected time range. (For example, 10
alarms in a 10-minute period over the selected 5-day time range.)
A breakdown of
the selected alarm
types, how many
floods they
contributed, and
their percentage
of overall time
displays.
Top Occurring Alarm Data – Displays the Top Most Frequent Alarms in tabular form.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Top Occurring Alarm Data Bar Chart – Displays the Top Most Frequent Alarm data
in bar chart form.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Top Occurring Alarm Percentage – Displays in orange the Top Most Frequent
Alarms as a percentage of the total alarm load.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Chattering Alarm Data – Displays the Chattering Alarms report data in tabular form.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Chattering Alarm Data Bar Chart – Displays the Chattering Alarm report data in bar
chart form.
Stale Alarm Data – Displays the Stale Alarm report data in tabular form.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Stale Alarm Data Bar Chart – Displays the number of stale alarms by duration in bar
chart form.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
17 Alarm Help
The process and diagnostics Alarm Help display and their associated alarm commenting
capabilities are integrated into the Alarm Viewer. Alarm Help is displayed by one of the
following methods:
• Select a single process alarm or diagnostic alarm and click the Alarm Help icon.
• Right-click a single process or diagnostic alarm and select Alarm Help from the
context menu.
• Right-click a single process or diagnostic alarm and select Alarm Attributes from the
context menu.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
MasterDirectory is the root directory on the Master Workstation as defined in the
ToolboxST application.
Help is the subdirectory that defines the start of the help file collection. This subdirectory
is required, and must be named as displayed.
Diagnostics is the subdirectory that defines the start of the diagnostics section. This
subdirectory is required, and must be named as displays. Subdirectories such as AEPA are
specific Distributed I/O packs used in the system.
ProcessAlarms is the subdirectory that defines the start of the process alarms section.
This subdirectory is required, and must be named as displayed.
Ews1 is a name of a WorkstationST component.
G1 and G2 are component names.
TMRM6E is a Mark VIe component.
Note Process alarm help files can have the extension.txt, rtf, htm, or chm. If a set of files
is located in this directory, the order txt, htm, rtf, chm is used to display the file. The first
one found is displayed. The name of the file is not case-sensitive.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
17.3 Diagnostic Alarms
Diagnostic alarm Help is managed on a per type basis. An example of the directory used
for Diagnostics is as follows:
A properly named file is PAICDiags.en.chm, which indicates the file is for a PAIC pack,
is authored in English, and is a standard chm file.
Note For information on how MarkV Diagnostic alarms are defined, refer to
GHT-200040, How to Convert a Mark V Component for Use in ControlST Applications.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
17.4 Alarm Help Comments
Refer to the section Comments There are two types of comment files; user comment and comment lock files. These files
Tab. are created by the Alarm Viewer when the customer adds or modifies comments, so the
user does not need to create the file separately.
file for a PAIC pack type, is authored in English, and is an xml file.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
17.5 Alarm Viewer
The Alarm Viewer allows you to browse available help files, view live and historical
alarm help in either the primary or second language, and view and enter comments
through the Alarm Help Viewer.
You must enter the Master Workstation Host in the Settings dialog box.
➢ To set the Master Workstation Host Name: from the Alarm Viewer Options
menu, select Settings.
After it is entered, the host name is resolved and the Master Workstation Path is retrieved.
If an error is detected, the host name is not set. The Master Host and Path in the
ToolboxST application must be fixed.
20019983-94.03.18.100-010-01-06-2017-INF
After the Master Host and Path are validated, the Alarm Help Browser button is enabled.
Click the browser button to display a dialog box that allows you to navigate all defined
alarm and diagnostic help files.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Navigate to the appropriate item to display the help file.
20019983-94.03.18.100-010-01-06-2017-INF
The Tree View displays the existing master directory and all its subdirectories. A
document that can be displayed is represented by the Document icon. When the icon is
selected, the file is read on demand from the Master Workstation and written locally to a
temporary (temp) directory. ProcessAlarms help displays on the Help tab in the Summary
View of the Alarm Help Viewer dialog box. Diagnostics help only displays when the
CHM viewer is used. It does not display in the Summary View.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Note If the Master Workstation host name is not set, an error displays in the status bar,
and only the root names display in the Tree View.
If a document is not defined in Spanish (the signal name language), the document icon is
missing and the Help tab is blank. The following screen displays:
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
17.5.3 Live Alarm Display Help
In a live alarm display, you can select a single process alarm or diagnostic by selecting the
row. Alarm Help is enabled only if a single item is selected and the variable type is a
Process Alarm or a Diagnostic type. Alarm Help is available from the live alarm toolbar
and the alarm shortcut menu.
Examples:
Live alarms actively update without selecting rows.
20019983-94.03.18.100-010-01-06-2017-INF
The selection of a single Process Alarm or Diagnostic (row is highlighted in blue) enables
the Alarm Help icon and the Alarm Help shortcut menu item. The Alarm Help icon
displays on the toolbar and when the mouse pointer is held over it, a ToolTip displays.
You can also right-click an alarm and select Alarm Help from the drop-down menu.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
When Alarm Help is selected, the Alarm Viewer Help dialog box displays, the Tree View
expands, the correct item is selected, and the corresponding Help content displays. All file
types, except chm files, display in the Summary View.
➢ To enter comments: from the Alarm Help Viewer, select the Comments tab.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
The icon changes to L to indicate it is locked for
commenting by the displayed user.
The red page indicates the Comment has Click the L icon to return the file
been edited but has not yet been saved. to the read-only mode .
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
The toolbar on the Comments tab is used to control editing, and manage the display.
Controls available on this toolbar are as follows:
changes the sort direction of the date/time items in the Tree View (Oldest to Newest
or Newest to Oldest)
The Lock/Unlock button controls access to the file for editing. The button states are:
to indicate the comment file is locked by the current user for editing.
when one or more comment sections have been edited and not yet saved.
On the comments tab, when the Alarm Help item is selected, all comments display.
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
18 Terms
Alarm Flood - A condition during which the alarm rate is greater than the operator can
effectively manage (such as more than 10 alarms per 10 minutes).
Bind - To establish the correspondence between the data in an exchange and variables in
a device.
Bind/Build - To bind the configuration for each consumed exchange and create/update
the configuration for any produced exchange.
Chattering Alarm - An alarm that repeatedly transitions between the alarm state and the
normal state in a short period of time. An alarm that repeats three or more times in one
minute.
Collection - More formally, an EGD Collection. A group of devices that constitutes a
formal subset of the devices participating in a particular EGD installation. This arbitrary
grouping allows users to subdivide the system to make some tasks easier.
Consume - To receive an EGD data message (exchange).
Consumer - An EGD node configured to receive an EGD data message.
EGD - A mechanism that provides access to global data between nodes supporting the
EGD protocol.
Exchange - An EGD data message consisting of a header and a body of data. The
header contains the producer ID and the exchange ID that uniquely identifies the
message. The body of data is a block of bytes in a format agreed upon by the producer
and all consumers.
Feature - An element of the WorkstationST runtime system, which can be optionally
enabled through the ToolboxST application. Examples include OPC Server, Recorder, and
Alarm Viewer.
In Service - The state of an alarm indicating the alarm is displaying and updating
correctly and is actionable by the operator.
Latching Alarm - An alarm that remains in alarm state after the process has returned to
normal and requires an operator reset before it will clear.
Global Data - A concept in which multiple controllers on a network can share
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001
Out-of-service (OOS) - The state of an alarm during which the alarm indication is
suppressed (not actionable by the operator), typically manually, for reasons such as
maintenance.
Produce - To send an EGD data message (exchange).
Producer - The EGD node configured to send data messages. The source of the data
samples for an exchange.
Refresh - To bind the configuration for each consumed exchange for a particular
consumed device.
Return to Normal (RTN) - An unacknowledged alarm state reached when the process
returns within normal limits and the alarm clears automatically (sometimes called
auto-reset) before an operator has acknowledged the alarm condition.
Runtime - Software stored in the controller’s Flash memory that converts application
code (pcode) to executable code.
Service State - The in service or out of service state of the process alarm. (Refer to In
Service and Out-of-service.)
Stale alarm - Alarms that remain in effect continuously for more than 24 hours may be
considered as stale.
Suppress - Any mechanism to prevent the indication of the alarm to the operator when
the base alarm condition is present (such as shelving, suppressed by design, or
out-of-service).
Unbound Variables - Variables required by a consumer that were not found in the
producer configuration during the bind.
20019983-94.03.18.100-010-01-06-2017-INF
20019983-94.03.18.100-010-12-13-2016-R-0001466-20019983-94.03.18.100-001