Point.OnTimed (method)

Syntax

Point.OnTimed time_period

Description

To poll the points value periodically. A new value will be sent to the application every time_period seconds. The application should call GetNext to retrieve the next value.

Comments

Unlike the OnChange method, you may miss values of the point if it changes in between your polls. Use the OnChange method to receive the point whenever it changes. OnTimed is useful if the point is rapidly changing and you are only interested in its value in a periodic manner.

Only one of the OnChange, OnAlarm, OnTimed or OnAlarmAck requests may be active at a time.

 

Parameter

Description

 

time_period

Integer. Time period in seconds to read the point.

Example

Sub main()

   Dim MyPoint as new Point   ' Declare the point object

   MyPoint.Id ="TANK_LEVEL"  ' Set the point Id

   MyPoint.OnTimed 60         ' Request value every minute

Top :

    MyPoint.GetNext           ' Read the value

    Trace MyPoint.Value       ' Put it out to the trace buffer

    goto top                  ' Repeat forever

end sub

See Also

Point.GetNext (method); Point.OnChange (method); Point.Cancel (method).

More information

CIMPLICITY Extensions to Basic