Creating and modifying the alarmnotifier.xml file, Alarm notifier soap interface, Alarm notifier soap interface -4 – Echelon i.LON 100 e2 Internet Server User Manual
Page 110: 1 alarm notifier soap interface

8.2 Creating and Modifying the AlarmNotifier.XML File
You can create and manage the AlarmNotifier.XML file with the AlarmNotifierSet SOAP
function. The following section, Alarm Notifier SOAP Interface, describes how to use
AlarmNotifierSet and the other SOAP functions provided for the Alarm Notifier application.
Alternatively, you can create and manage the AlarmNotifier.XML file manually with an
XML editor and download it to the
i.
LON 100 via FTP. Echelon does not recommend this, as
the
i.
LON 100 will require a reboot to read the configuration of the downloaded file.
Additionally, the
i.
LON 100 performs error checking on all SOAP messages it receives before
writing to the XML file. It will not perform error checking on any XML files you download via
FTP, and thus the application may not boot properly.
If you plan to create the XML file manually, you should review the rest of this chapter first,
as it describes the elements and properties in the XML file that define each Alarm Notifier’s
configuration. For instructions on creating or modifying an XML file manually, see Manually
Modifying an XML Configuration File on page 15-1.
8.2.1 Alarm Notifier SOAP Interface
The SOAP interface for the Alarm Notifier application includes seven functions. Table 30
lists and describes these functions. For more information on each function, see the sections
following Table 30.
Table 30 Alarm Notifier SOAP Functions
Function Description
AlarmNotifierList
Use this function to generate a list of the Alarm Notifiers that you
have added to the
i.
LON 100. For more information, see
AlarmNotifierList on page 8-5.
AlarmNotifierGet
Use this function to return the configuration of an Alarm Notifier. For
more information, see AlarmNotifierGet on page 8-6.
AlarmNotifierSet
Use this function to create an Alarm Notifier, or to overwrite the
configuration of an exisiting Alarm Notifier. For more information, see
AlarmNotifierSet on page 8-19.
AlarmNotifierRead
Each time an Alarm Notifier causes an alarm notification, it will
record a log entry for that notification. Use this function to retrieve
some or all of the log entries that an Alarm Notifier has recorded. For
more information, see AlarmNotifierRead on page 8-20.
AlarmNotifierWrite
Use this function to acknowledge an alarm notification, or group of
alarm log notifications, made by the Alarm Notifier. You optionally
insert comments into the log entry for each alarm notification with
this function. For more information, see AlarmNotifierWrite on page
8-26.
AlarmNotifierClear
Use this function to clear log entries from an Alarm Notifier’s log file.
For more information, see AlarmNotifierClear on page 8-29.
AlarmNotifierDelete Use this function to delete an Alarm Notifier. For more information,
see AlarmNotifierDelete on page 8-31.
i.
LON 100 Internet Server Program
8-4
mer’s Reference