Instruction Manual

ManualsBrandsEchelon ManualsSensorsi.LON 100 e2 Internet Server

121

122

123

124

125

126

127

128

129

130

i.LON 100 Internet Server Programmer’s Reference 8-19

8.2.1.3 AlarmNotifierSet

Use the AlarmNotifierSet function to create new Alarm Notifiers, or to overwrite the

configuration of exisiting Alarm Notifiers. The Alarm Notifiers to be created or written to 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 Notifier or modifying an existing Alarm Notifier. The previous section,

AlarmNotifierGet, describes these properties.

NOTE: When modifying an existing Alarm Notifier, any optional properties 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 Notifier, even if you are not changing all of the values.

You can create up to 40 Alarm Notifiers per i.LON 100. The first invocation of the

AlarmNotifierSet function will generate the AlarmNotifier.XML file in the

/root/config/software/Driver directory of your i.LON 100, if it does not already exist.

When creating or modifying an Alarm Notifier with AlarmNotifierSet, you may want to use

output from AlarmNotifierGet 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, to generate your input.

The example below creates an Alarm Notifier that uses NVL_nviRequest as its input data

point. This Alarm Notifier includes one e-mail profile that it can use each time an alarm

notification occurs. It also has two ouput data points that can be updated when alarm

notifications occur. Several factors determine which of the data points will be updated when

the Alarm Notifier logs an alarm, including the status the input data point is updated to and

the alarm level assigned to the alarm condition set.

<Data>

Parameter

<Data>

<Alarm>

<UCPTdescription>Temperature Sensor Device</UCPTdescription>

<UCPTfbName>Alarm Notifier- 9</UCPTfbName>

<SCPTdelayTime>0.0 /SCPTdelayTime> <

<UCPTlogFormat>LF_BINARY</UCPTlogFormat>

<Point>

<UCPTpointName>NVL_nviRequest</UCPTpointName>

</Point>

<Mail>

<UCPTemailFormat>%al occured at %dy/%dm/%dd %pn </UCPTemailFormat>

<UCPTemailSubject>Alarm Notifier 3: %ad</UCPTemailSubject>

</Mail>