Skip to main content
InSource Solutions

TN Appsvr136 Alarm Shelving

insource logo large.jpg



About alarm shelving in Wonderware System Platform version 2014 R2


  • Author: Peter Farrell
  • Published: 6/25/2015
  • Applies to: System Platform 2014 R2




You can shelve alarms to temporarily hide them from displays for a fixed period. Alarms continue to be historized, even when they are shelved.


Shelving typically is used to reduce alarm “noise”, or to temporarily suppress alarms that might be triggered during system modifications or repairs, allowing you to focus on correcting other more urgent alarms.


Shelving is similar to silencing an alarm, but shelved alarms differ from silenced alarms in the following ways:


Shelved alarms have a built-in associated timeout. Shelved alarms are automatically unshelved when the configured shelving period expires. You can also manually unshelve alarms and return them
to an active, displayed state.


Alarm shelving must be enabled at an area level, but shelving applies only to individual alarms. You cannot shelve a hierarchy of alarms for for an entire area or for an entire object. You cannot propagate alarm shelving through the Model View hierarchy.


The system enforces role-based limitations on permission to shelve alarms, alarm severity levels that can be shelved, and the total number of alarms a user can shelve.


The system tracks who shelved the alarm, from what workstation, the reason for shelving the alarm, when shelving began, and when shelving will expire. Shelved alarms aggregate in similar fashion to silenced alarms.


A set of seven attributes provide run-time alarm shelving information and control:



User writeable. Use this attribute to shelve or unshelve an alarm.

Default values: Duration = 0,

Reason = “”



Read-only, Boolean value. Shows True if alarm is shelved, False if alarm is unshelved.

Default value: False



A read-only date/time stamp indicating when alarm shelving began, based on the engine time when the shelving request was received,

Default value: Blank



A read-only date/time stamp equal to the AlarmShelveStartTime plus the duration for which the alarm is
to be shelved.

Default value: Blank



A read-only string value providing the reason for which the alarm was shelved or unshelved by the Alarm Shelve command.

Default value: Blank



Read-only, the name of the user who most recently shelved or unshelved the alarm with the Alarm Shelve command.

Default value: Blank



Read-only, the name of the computer node from which the user most recently shelved or un-shelved the alarm with the Alarm Shelve command. If the node is hosted in a Terminal Server client session,
the node and the TSE ID are both identified.

Default value: Blank