System Model > Alarms > Customize Alarm Pages > Alarm Display Fields

Alarm Display Fields

You can use any of the fields listed below, or the Alarm Summary Fields, to format an alarm display and an alarm log device (see Format an Alarm Display).

Field Name

Description

{AcqDesc,n}

Textual representation of Alarm Acquisition Error.

{AcqError, n}

Numeric representation of Alarm Acquisition Error.

{AlarmType,n}

Alarm type (string), not localized. Values are: Digital, Analog, Advanced, Multi-Digital, Time Stamped, Time Stamped Digital, Time Stamped Analog.

{AlmComment,n}

The text entered into the Comment field of the alarm properties dialog.

{Area,n}

Area

Note:Set the value of this field between 0 and 255

{Category,n}

Alarm Category

{Cluster,n}

Cluster Name

{CUSTOM1,n}
{CUSTOM2,n}
{CUSTOM3,n}
{CUSTOM4,n}
{CUSTOM5,n}
{CUSTOM6,n}
{CUSTOM7,n}
{CUSTOM8,n}

Alarm custom fields as configured.

{Date,n}

The date on which the alarm changed state (dd:mm:yyyy). Be aware that you can change the format used via the parameter [ALARM]ExtendedDate.

{DateExt,n}

The date on which the alarm changed state in extended format.

{Deadband,n}

Deadband

{Desc,n}

Alarm Description

{Deviation,n}

Deviation Alarm trigger value

{ErrDesc,n}

Text string associated with a protocol (communication) error. This field is only associated with hardware errors and contains extra information associated with whatever error is detected (for example if the error is associated with a device, the device name is returned; if the error is associated with a Cicode function, the function name is returned; if the error is associated with an I/O Device, the I/O Device's alert message is returned).

{ErrPage,n}

The page, device, etc. associated with the alarm.

{Format,n}

Display format of the Variable Tag

{Help,n}

Help Page

{High,n}

High Alarm trigger value

{HighHigh,n}

High High Alarm trigger value

{LocalTimeDate,n}

Alarm date and time in the form: "yyyy-mm-dd hh:mm:ss[.ttt]"

{LogState,n}

The last state that the alarm passed through. (This is useful when logging alarms to a device.)

{Low,n}

Low Alarm trigger value

{LowLow,n}

Low Low Alarm trigger value

{Name,n}

Alarm Name

Note: If the Name field is configured to support long names (up to 79 characters), it might cause overlap in an alarm display. Use a smaller display font if long names are expected.

{Native_Desc,n}

Alarm Description in the native languageGenerally the language of the project developer. Display items such as alarm descriptions, button text, keyboard/alarm logs, graphic text, Cicode strings and so on can be configured in the native language, and displayed at runtime, in the language of the end-user (local language).

{Native_Name,n}

Alarm Name in the expression

Note: If the Native_Name field is configured to support long names (up to 79 characters), it might cause overlap in an alarm display. Use a smaller display font if long names are expected.

{Paging,n}

Indicates whether the alarm has to be paged. When the value is TRUE the alarm will be paged. The default value is FALSE.

{PagingGroup, n}

Indicates the paging group to which the alarm belongs. Maximum length is 80 characters.

{Priority,n}

Alarm category's priority

{Priv,n}

Privilege

{Rate,n}

Rate of change trigger value

{State,n}

The current state of the alarm. This field may be used for

Alarm Display Only. It is not applicable to Alarm Summary.

ON
OFF
DEVIATION
RATE
LOW
LOWLOW
HIGH
HIGHHIGH
ON State 2
ON State 3
ON State 4
ON State 5
ON State 6
ON State 7
CLEARED

{State_desc, n}

The configured description (for example healthy or stopped) of a particular state. This description is entered when configuring the Multi-Digital Alarm Properties

{Tag,n}

Alarm Tag

Note: If the Tag field is configured to support long names (up to 79 characters), it might cause overlap in an alarm display. Use a smaller display font if long names are expected.

{TagEx,n}

Alarm Tag with Cluster Name prefix

Note: If the TagEx field is configured to support long names (up to 79 characters), it might cause overlap in an alarm display. Use a smaller display font if long names are expected.

{Time,n}

The time at which the alarm changed state (hh:mm:ss). (Set the [Alarm]SetTimeOnAck parameter to use this field for the time the alarm is acknowledged.)

{Type,n}

The type of alarm or condition:
ACKNOWLEDGED
CLEARED
DISABLED
UNACKNOWLEDGED

{TypeNum,n}

Alarm type number (use AlarmType to get string value instead). Values are:

-1 Invalid
0 Digital
1 Analog
2 Advanced
3 Multi-Digital
4 ArgAna
5 User Event
6 timestamped
7 hardware
8 timestamped digital
9 timestamped analog

{Value,n}

The current value of the analog variable

{Classification,n}

The class of the event. E.g:
-“Action”
- “Comment”
- “Configuration”
- “System”
- “<alarm type>”

{Equipment,n}

The name of the equipment the alarm is associated with.

{Message,n}

The event message.

{Millisec,n}

Adds milliseconds to the {Time,n} field

{RecordId,n}

String that uniquely identifies SOE records within the cluster. On the Alarm Summary table, this field references the associated SOE record.

{State,n}

State of the event. The value of this field indicates the action that triggers the event, similar to the value returned by the existing LogState field.

{UserLocation,n}

The IP of the machine which last raised, or performed an action on alarm.

Where n specifies the display field size.

Notes:
• Any of the above fields can be displayed for any type of alarm. Where not applicable for a particular alarm type, zero or an empty string will be displayed.
• If an alarm value is longer than the field it is to be displayed in (n ), it will be truncated or replaced with the #OVR ("overflow of format width") alert message.
• For summary pages use {SumState}. To log the state to a device, use {LogState}. State is the current state of the alarm, SumState is the state of the alarm when it occurred, and Log State is the state of the alarm at the transition.

See Also

Published June 2018