Instruction Manual

i.LON 100 Internet Server Programmer’s Reference 6-15

6.2.1.5 DataLoggerClear

You can use the DataLoggerClear function to remove log entries from a Data Logger’s log

file. You can specify which Data Logger is to be affected, and which log entries will be

removed, by configuring the properties described in Table 19 into the <Data> parameter you

supply to the function.

NOTE: This function only deletes the log entries. You can delete the Data Logger itself with

the DataLoggerDelete function.

Table 19 DataLoggerClear Input Properties

Parameter Description

The index number of the Data Logger to be affected.

The name of the data point whose log entries are to be deleted. If you

do not fill in this property, the function will delete log entries for all

data points that the Data Logger is monitoring.

Use this property to specify the maximum number of log entries the

function will delete. If you do not fill in this property, the function will

delete all log entries for the applicable data point, or data points, that

occurred within the interval defined by the <UCPTstart> and

<UCPTstop> properties.

Use these fields to specify a time interval for the log entries to be

deleted. You can specify a start and stop time, or just a stop time.

If you specify a start and stop time and the number of log entries

during this interval exceeds the count entered, the function will delete

the first group of log entries recorded during the interval.

If you only specify a stop time and the number of log entries before this

time exceeds the count entered, the function will delete the first group

of log entries recorded before the stop time.

If you do not enter a start or stop time, the function will delete 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 following call to DataLoggerClear deletes up to 200 log entries for data point

NVL_nviDlCount2. These entries must have occurred between 1/27/2002 and 11/28/2002

(both at one hour ahead of UTC) to be deleted.