OPC Toolbox™

start - Start a logging task

Syntax

start(GObj)

Description

start(GObj) starts a data logging task for GObj. GObj can be a scalar dagroup object, or a vector of dagroup objects. A dagroup object must be active and contain at least one item for start to succeed.

When logging is started, GObj performs the following operations:

1. Generates a Start event, and executes the StartFcn callback.

2. If Subscription is 'off', sets Subscription to 'on' and issues a warning.

3. Removes all records associated with the object from the OPC Toolbox™ software engine.

4. Sets RecordsAcquired and RecordsAvailable to 0.

5. Sets the Logging property to 'on'.

The Start event is logged to the EventLog.

GObj will stop logging when a stop command is issued, or when RecordsAcquired reaches RecordsToAcquire.

See Also

flushdata, getdata, peekdata, stop, wait

showopcevents

stop