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

Parameter Description
<UCPTstart> Use these fields to specify a range for the log time of the entries that will
be returned by the function. You can specify a start and stop time, or
just a stop time. When reading the Alarm History Log, these fields
indicate a range for the log time of the entries in the log, which is stored
for each entry in the <UCPTlogTime> property. When reading the
Alarm Summary Log, these fields indicate a range for the alarm time of
the entries in the log, which is stored for each entry in the
<UCPTalarmTime> property.
<UCPTstop>
If you specify a start and stop time and the number of log entries during
this interval exceeds the maximum defined by the <UCPTcount>
property, the function will return the first group of log entries recorded
during the interval.
If you only specify a start time, the function will return entries from the
log starting at the start time until it reaches the end of the log file, or
until it has returned the maximum number of entries (as defined by the
<Count> property).
If you only specify a stop time and the number of log entries during this
interval exceeds the maximum defined by the <UCPTcount> property,
the function will return the group of entries from the stop time going
backwards in the log until the maximum number of log entries have
been returned. If the <UCPTcount> property was not defined, the
function will return all log entries in the log, going backward from the
stop time. This may be useful for applications that need to read the
newest information logged.
If you do not enter a start or stop time, the function will return all log
entries for the applicable data points, up to the maximum.
You must enter the <UCPTstart> and <UCPTstop> properties as
timestamps in local time, with appended time zone indicators to denote
the difference between local time and UTC. For more information on
this format, see Local Times and Coordinated Universal Time on page 6-
12.The <UCPTstart> and <UCPTstop> properties must be entered as
timestamps in local time, with an appended time zone indicator that
denotes the difference between local time and UTC. For more
information on this format, see Local Times and Coordinated Universal
Time on page 6-12.
The following call to the AlarmNotifierRead function returns all log entries for data point
NVL_AlarmGenIn1 the Alarm Notifier using index number 0 for alarms that were logged
between 1-1-02 and 7-4-03. This call will return up to 200 log entries.
i. LON 100 Internet Server Program 8-22 mer’s Reference