ClearSCADA

Introduction

ClearSCADA can be configured to send alarms to an application. Each time an alarm changes state, an application can be run with command-line parameters. The parameters carry the alarm information, and can be configured as required.

For example, a simple application C:\Program Files\HandleAlarm.exe could be created which takes command line parameters of the alarm object name, condition and date/time.

How to Configure

1. Create a new object from the Alarm Redirection sub-menu 'System Command Action'.

See this page in the help which explains how to configure this object: Link

To pass the alarm details in to this command, the appropriate trip sequence characters need to be inserted into the command text.

This help page describes what sequences can be used: Link

For example, the following text can be used in the Command box of the System Command Action:

"C:\Program Files\HandleAlarm.exe" %ASeverity% "%ASource%" "%AMessage%" "%ACategory%" %ACondName% "%ACondActiveDateTime%"

Note: It may be appropriate to use quotation marks around each parameter which contains spaces.

2. Add an alarm redirection to a group.

To redirect all alarms in all circumstances to this System Command Action, add the following configuration to the Root Group for the database:

Performance

Program Size

For performance reasons, the .exe program which you create should be small so that it is quick to load, start and run to completion. If your external alarm handling system is complex, then it is recommended that the .exe program run from ClearSCADA is an independent small program which passes data or commands to the external system.

Filtering

It is unlikely that your external program needs all alarms and state changes to be sent to it. Doing this may be an unnecessary burden, particularly on a large system.

Therefore you can use ClearSCADA alarm redirection configuration to filter only what is needed.

For example, you can apply the redirection action only to the groups, sub-groups or even the alarm objects you need to be informed for.

Also you can filter by alarm state, alarm severity, geographic region, area of interest (if enabled), direction (away or towards normal) and time of day.