Echelon i.LON SmartServer 2.0 User Manual
Page 111
i.LON SmartServer 2.0 Programmer’s Reference
7-19
created. An Alarm Notifier will not generate a log file until it has generated an alarm notification.
You should not attempt to read more than 100 log entries with a single Read request.
The following code demonstrates how to use a Read request to generate a list of up to the first 100
entries stored in a specific Alarm Log.
Request
<Read xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem>
<xSelect>//Item[@xsi:type="UFPTalarmNotifier_Data"][UCPTalarmLog="HISTORICAL"]
[position()<100]
</xSelect>
<Item>
<UCPTname>Net/LON/iLON App/Alarm Notifier[0]</UCPTname>
</Item>
</iLonItem>
</Read>
Response
<ReadResponse xmlns="http://wsdl.echelon.com/web_services_ns/ilon100/v4.0/message/">
<iLonItem >
<UCPTfaultCount>0</UCPTfaultCount>
<Item xsi:type="UFPTalarmNotifier_Meta_Data" >
<UCPTname>Net/LON/iLON
App/Alarm
Notifier[0]</UCPTname>
<UCPTlastUpdate>2008-02-29T15:01:40.650-08:00</UCPTlastUpdate>
<UCPTalarmLog
LonFormat="UCPTalarmLog">HISTORICAL</UCPTalarmLog>
<UCPTstart>2008-02-29T11:14:41.300-08:00</UCPTstart>
<UCPTstop>2008-02-29T11:14:41.300-08:00</UCPTstop>
<UCPTmodificationNumber>0</UCPTmodificationNumber>
<UCPTlogLevel>0.496</UCPTlogLevel>
<UCPTtotalCount>1</UCPTtotalCount>
</Item>
<Item
xsi:type="UFPTalarmNotifier_Data">
<UCPTname>Net/LON/iLON
App/Data
Logger[0]/nvoDlLevAlarm[0]</UCPTname>
<UCPTaliasName>nvoDlLevAlarm[0]</UCPTaliasName>
<UCPTlastUpdate>2008-02-29T11:14:41.300-08:00</UCPTlastUpdate>
<UCPTdescription>
</UCPTdescription>
<UCPTvalue
LonFormat="#0000000000000000[0].SNVT_alarm#LO">0</UCPTvalue>
<UCPTpointStatus
LonFormat="UCPTpointStatus">AL_NO_CONDITION</UCPTpointStatus>
<UCPTpriority>255</UCPTpriority>
<UCPTmetaDataPath>//*[@xsi:type=“UFPTalarmNotifier_Meta_Data”]
[UCPTname=“Net/LON/iLON
App/Alarm
Notifier[0]”]
</UCPTmetaDataPath>
<UCPTalarmNotifierName>Net/LON/iLON
App/Alarm
Notifier[0]</UCPTalarmNotifierName>
<UCPTalarmTime>2008-02-29T11:13:44.560-08:00</UCPTalarmTime>
<UCPTuserName>iLON</UCPTuserName>
<UCPTstatus
LonFormat="UCPTalarmStatus">AUTO_CLEAR</UCPTstatus>
<ReadData>
<UCPTalarmText>Online</UCPTalarmText>
<UCPTalarmPriority2>0</UCPTalarmPriority2>
<UCPTalarmGroup>0</UCPTalarmGroup>
<UCPTalarmType
LonFormat="UCPTalarmType">PASSIVE</UCPTalarmType>
</ReadData>
</Item>
</iLonItem>
</ReadResponse>
In addition to the requested log entries, the Read function returns a single <Item> of type
“UFPTalarmNotifier_Meta_Data” for each log file from which entries were read. This
“UFPTalarmNotifier_Meta_Data” <Item> has the following properties:
<UCPTname>
The name of the data logger from which entries were read in
the following format: <network/channel/device/functional
block>.
<UCPTlastUpdate>
A timestamp indicating the time that the last log entry was