Echelon i.LON 100 e2 Internet Server - Manual (Page 105)

7.2.1.3 AlarmGeneratorSet
You can use the AlarmGeneratorSet function to create a new Alarm Generator, or to
overwrite the configuration of an existing Alarm Generator. You can create up to 40 Alarm
Generators per i. LON 100.
The Alarm Generators to be created or written to by the function are signified by a list of
<Alarm> elements in the <Data> parameter. The properties that you must define within
each <Alarm> element are the same, whether you are creating a new Alarm Generator or
modifying an existing Alarm Generator. The previous section, AlarmGeneratorGet, describes
these properties.
NOTE: When modifying an existing Alarm Generator, any optional properties such as
<AlarmDataPoint> and <Alarm2DataPoint> that are left out of the input string will be
erased. Old values will not be carried over, so you must fill in every property when writing to
an Alarm Generator, even if you are not changing all of the values.
The first invocation of the AlarmGeneratorSet function will generate the
AlarmGenerator.XML file in the /root/Config/software directory of the i. LON 100, if the file
does not already exist.
When creating or modifying an Alarm Generator with AlarmGeneratorSet, you may want to
use output from AlarmGeneratorGet as the basis for your <Data> parameter. You would
then only need to modify the values of each property to match the new configuration you
want, as opposed to re-creating an entire string like the one shown below.
The following example uses the AlarmGeneratorSet function to create a new Alarm
Generator that uses a data point called NVL_DataValueAG1 as its input data point.
<Data>
Parameter
<Data>
<iLONAlarmGenerator>
<Alarm>
<UCPTindex></UCPTindex>
<UCPTdescription>Alarm Generator 1</UCPTdescription>
<UCPTfbName></UCPTfbName>
<SCPTalrmIhbT>0 00:00:00.000 /SCPTalrmIhbT> <
<UCPTalarmPriority>PR_LEVEL_1</UCPTalarmPriority>
<UCPTpollOnResetDelay>0.0</UCPTpollOnResetDelay>
<UCPTpollRate>0.0</UCPTpollRate>
<UCPTalarm2Description>none</UCPTalarm2Description>
<InputDataPoint>
<UCPTpointName>NVL_DataValueAG1</UCPTpointName>
</InputDataPoint>
<CompareDataPoint>
<UCPTpointName>NVL_CompareValueAG1</UCPTpointName>
</CompareDataPoint>
<AlarmDataPoint>
<UCPTpointName>NVL_AlarmGenOut1</UCPTpointName>
</AlarmDataPoint>
<Alarm2DataPoint>
<UCPTpointName></UCPTpointName>
</Alarm2DataPoint>
<UCPTcompFunction>FN_LIMIT</UCPTcompFunction>
<UCPTalarmSetTime>0 00:00:00.000</UCPTalarmSetTime>
<UCPTalarmClrTime>0 00:00:00.000</UCPTalarmClrTime>
<UCPTlowLimit1Offset>5.0</UCPTlowLimit1Offset>
<UCPTlowLimit2Offset>5.0 /UCPTlowLimit2Offset>
<
<UCPThighLimit1Offset>5.0</UCPThighLimit1Offset>
<UCPThighLimit2Offset>5.0</UCPThighLimit2Offset>
i. LON 100 Internet Server Program 7-16 mer’s Reference