Echelon i.LON SmartServer 2.0 User Manual
Page 164
i.LON SmartServer 2.0 Programmer’s Reference
10-14
position()
Position of the events in previously selected list. You can use this
filter to limit the number of events in a result. You can compare the
number of events to be returned using equal, less (or equal), or great
(or equal). You can request a maximum of 500 events, however,
more than 500 events may be returned.
Note: The last instance of an exception before the specified start date
is always returned (if it exists), and it is not counted by the position()
constraint.
The following code demonstrates how to use the Read function to return a list of up to the first 100
events on a Calendar on the SmartServer:
Request
[UCPTlastUpdate>="2008-03-07T00:00:00.000"
and
UCPTlastUpdate<="2037-12-31T00:00:00.000"]
[position()<100]
App/Calendar
Response
App/Calendar
App/Calendar
The Read function returns the following properties for each event from the specified Calendar:
The name of the calendar from which events were read in
the following format: <network/channel/device/functional
block>.
Timestamps indicating the times of the first and last dates of
the events returned by the Read function.
The name of the exception from which events were read.
A set of structures containing signed longs indicating the
number of days from