Alarm Tag

Not counted towards your tag license limit.

Alarm tags are used to establish rules for when an alarm should be triggered, and what behavior should occur. An Alarm tag monitors the value of another tag and triggers an alarm when that tag’s value reaches or passes a given set point.

The Setpoint property can be a user-defined number or it can be supplied by another tag’s value. The two values are compared using an operation such as greater than, equal to, or less than. If the result of this comparison is determined to be true, then the Alarm tag will be triggered.

The value of the Alarm tag itself becomes 1 while the alarm is on the active list. Otherwise, the value of the Alarm tag is 0. Note that trip alarms and event alarms never appear on the active list and therefore will always have a value of zero.

The urgency of the alarm (from Event to Critical) is defined by the Alarm Priority tag selected in the Alarm tag’s properties.

Alarms can be configured such that, if they are acknowledged by an operator, but remain active for a set length of time (that is, the triggering condition for the alarm remains in effect), the alarm will go back to an unacknowledged condition, thereby re-activating any audible and visible warning indicators that are attached to that alarm.

Note that shelving or unshelving an alarm is an operational action, not a configuration change.

Alarms should be matched to alarm databases when the application is created. If an alarm is switched from one database to another, you will lose access to that portion of the alarm's history that was recorded using the first database.
The selection of which alarm database will be used is done based on each tag's position in the tag hierarchy. An alarm will be matched to the closest AlarmDatabase tag ancestor in the hierarchy, defaulting to the built-in System Alarm DB if no other database ancestor is found.

Trip Alarms Versus Level Alarms

Alarm tags can be configured as either "Trip" or "Level".

A level alarm will show up in the Active List as long as the underlying trigger condition remains true. The underlying condition must be cleared before the alarm is removed from the list of Active alarms.

Trip alarms do not have an Active or Inactive status. After being triggered, the trip alarm is simply in an alarm condition, waiting for operator acknowledgment. There is no need to also clear the alarm state by adjusting the Trigger tag’s value.

A trip alarm will not be displayed in the list of Active alarms. They are primarily used in situations where the momentary existence of an alarm condition should "trip" the alarm, after which the state of the Trigger tag is irrelevant. As an example, consider an intrusion detection system: When an unauthorized person opens a door, the alarm is triggered. What later happens to the door is irrelevant to the alarm.

Both trip and level alarms must be acknowledged by an operator before their audible and visual warnings will stop.

Alarm properties Trigger tab

The Trigger tab for the Alarm tag properties folder consists of the attributes used to identify the conditions that the Alarm tag will evaluate to determine whether an alarm should be triggered.

The Triggered By field is used to select the tag that is being monitored by this Alarm tag. The Setpoint property displays a value (or a tag) that will be compared to the value of the tag being monitored (as identified in the Triggered By tab). The Function property selects the operation that is to be performed to compare the monitored tag's value with the Setpoint value.

Triggered By

Select the tag whose value will be monitored and compared to the value of this Alarm tag's Setpoint value to determine if this alarm should be triggered.

The Triggered By field can be used to associate this Alarm tag with a new or existing numeric tag using the tag browser button to its right. The Triggered By field can be cleared of its current value using the X button to its right.

Right-clicking the name of the I/O tag that has been selected in the Triggered By field opens the tag properties folder for the selected communication driver tag.

While the link can be made using either the Expression or the Tag option, this alarm will not show up in a trend plot of the triggering tag if the link is made using an expression. If you specify the Triggered By tag directly then the alarm line will be shown. (Assumes that the pen in the HDV is configured to show alarms.)


The Function drop-down list enables you to select one of 11 operators to use to compare the value of the Triggered By tag with the Setpoint value configured for the Setpoint field to determine if there is an alarm state.


You must provide a setpoint to configure an alarm. The alarm will trip or activate when the triggering value matches the setpoint, according to the rule set by the selected function.

The valid value for the Setpoint field can be provided via any of a constant, an expression, or a tag. Please see Constant, Expression or Tag for help selecting which to use.


The Deadband field specifies how far the triggering value must return into the safe zone before the alarm is no longer considered active. Deadband values are used in systems where analog values fluctuate often, sometimes providing a false data reading.

On Delay

Use the On Delay field to specify a length of time (in seconds or in fractions of a second) that the system will wait before triggering this alarm. This enables you to disregard transient spikes in value as the tag must remain in an alarm state for the amount of time specified in the Delay field before an alarm will be indicated.

Off Delay

Similar to the On Delay, the Off Delay field can be used to specify a length of time (in seconds or in fractions of a second) that the system will wait before the alarm will return to the normal state. (The triggering condition is no longer true).

This enables you to disregard transient spikes in value that may occur after an alarm has been activated. The Off Delay does not apply to trip alarms, which do not have an active state.

Alarm properties Actions tab

The Actions tab for the Alarm tag properties folder enables you to select an Alarm Priority tag whose of properties will be used to indicate the category of alarm to be triggered by this Alarm tag (see Alarm Priorities). Other properties available on the Actions tab allow you to disable the alarm in the event that alarm conditions could be triggered due to routine equipment maintenance or another interruption in communications of which you are aware. The sound to be used for the alarm siren for this alarm can also be indicated here.

Disable Alarm

The Disable Alarm field enables you to disable or enable this Alarm tag, using a 0 (not disabled) or 1 (disabled), an expression or, the value of a second tag. This feature is typically used in situations such as when routine maintenance is being performed. In such a situation, an alarm can be disabled until the maintenance is complete and communications are reestablished, thus avoiding false alarms.

Alarm Rearm Time

Applies only if Alarm Rearm Enable is selected for this alarm. If the alarm has been acknowledged, but remains active for the time shown in this field, the alarm will return to the unacknowledged state. Audible and visible warnings configured for this alarm’s priority level, will again be displayed. The Alarm Rearm Time is measured in seconds, and defaults to 3600 (1 hour). The value in this field must be greater than 0.

Alarm Rearm Enable

Controls whether this alarm will revert back to an unacknowledged state if it remains active for the length of time set in Alarm Rearm Time, after having been acknowledged by the operator.


Choose whether this alarm is a trip alarm or a level alarm, as described in the introduction to this tag.


Set the priority of this alarm by selecting an Alarm Priority tag. The built-in Alarm Priority tags have numbers from 0 to 4 with the following meanings:

  • None.
  • 0 (event) - the alarm will not occur, but its value may still be used as a set point by other tags.
  • 1 (critical) - the highest priority alarm.
  • 2 (high) - a regular priority alarm.
  • 3 (warning) - warning.
  • 4 (notice) - a notice or informational event. Logged in the event history, but otherwise silent.

You may also create your own Alarm Priority tags.


Identify what audible warning will be played when this alarm is triggered. The Sound field can be set to a 0, a 1, or to the name of a .WAV sound file to be played.

If the Sound field is set to 0, no sound will be played when this alarm is triggered.

If the Sound field is set to 1, the sound configured in the associated Alarm Priority tag will be played.

If the Sound field identifies the name of a .WAV sound file, it will override any alarm sound configured for the associated Alarm Priority tag. When specifying a sound file, you must enter its name and extension (e.g. MySound.wav). The specified sound file must be a .WAV file, and must be stored in the application directory. If the specified sound file is not found, the alarm will revert to using tones as specified in the associated Alarm Priority tag.

Alarm Database

This tag will be linked to the first parent Alarm Database in the tag hierarchy. If none found, it will use the System Alarm Database.

Use this parameter to link the tag to an alternate Alarm Database of your choice.

Pop-up Enable

If the configuration variable AlarmPopupsEnable is set to 1, then selecting this option will result in a pop-up dialog being displayed whenever the alarm is triggered. The variable can be set using a check box within the Application Configuration dialog, Alarms tab.

The pop-up will display the names of all active alarms for which the Pop-up option has been selected. As alarms are acknowledged, they will be removed from the pop-up. Should all the alarms be acknowledged while the pop-up is displayed, it will close. You may close the pop-up at any time by selecting the Close button. The pop-up will not be displayed again until a fresh alarm event occurs.

Alarm properties Display tab

When this tag is represented on screen by widgets that can use a Style Settings tag, you can save development time by choosing the Style Settings tag that holds the correct display configuration for this tag instance.

The default configuration will use System Style, the default style tag that is automatically part of every new VTScada application.