Alarm queries

An alarm query retrieves either:

• Alarms and events (historical alarms) from the InTouch internal alarm memory or the alarm database.

• Current alarms (summary alarms) from the InTouch internal alarm memory.

When you configure an InTouch alarm ActiveX control, you specify the query source. You can also select query options to filter the query results.

The following figure shows the Query tab for the Alarm Viewer ActiveX control.

In this example, you create an alarm display that shows alarm data selected by the following criteria:

• Alarm priority (1-999)

• Alarm state (All, Acknowledged, or Unacknowledged)

• Query type (Summary or Historical)

• Alarm group (Local or remote data sources)

You can save your queries to an .xml file, called a "query favorites" file. During run time, you can update the alarm display with new alarm data by running another query using selection criteria saved to the file.

Other InTouch alarm ActiveX controls provide more extensive query criteria. The following figure shows the Query Filter tab of the Alarm DB Viewer control.

You build your queries by selecting alarm or event attributes from the list shown in the left pane of the dialog box. Then, you assign a value to the selected attributes. Finally, you can combine attributes using Boolean operators to set your query filter conditions.

You can write QuickScripts that include query functions or dotfields to select alarm and event records from alarm memory. The following Alarm Viewer control statement uses the ApplyQuery() method to query the alarm memory.

#AlarmViewerCtrl1.ApplyQuery ("\InTouch!$System",500,600,"All", "Historical");

This statement retrieves all historical alarms specified by the "\InTouch!$System" query with a priority between 500 and 600. The selected alarm records appear in the Alarm Viewer control display.