dpSetTimedWait()

Assigns values and a source time to the original attributes that can be changed by the user or to the attribute "_corr.._value".

Synopsis

int dpSetTimedWait ( time t, string dp1, <type1> val1 [, string dp2, <type2> val2, ...] );

int dpSetTimedWait( time t, dyn_string dpnames, dyn_anytype values)

Parameters

Parameter Meaning
t source time
dp1, dp2, ... original attributes
val1, val2, ... values to be assigned

Return Value

The function dpSetTimedWait () usually returns 0, in the event of a failure, however, it returns -1.

Errors

Errors can be retrieved with getLastError(). The return value is then an error class. An alert is issued in the event of non-existent data points, incorrect parameter transfers or spelling errors.

Description

In a similar way to the function dpSetTimed() it assigns the values val1, val2, ... and the source time t to the original attributes dp1, dp2, ... , which can be modified by the user or to the attribute "_corr.._value". Any number of pairs of modifiable original attributes and values can be transferred to the function dpSetTimedWait(). The data point attributes are transferred as a string, the data type of the value depends on the attribute in question. The execution of the script is blocked and the program waits for an answer from the event manager.

In one dpSetTimedWait() function it is not allowed to assign a value to the same data point attribute several times. In this event only the first assignment is accepted and the other ones are discarded.

If a definition for a config or attribute does not exist, the following defaults are used:

Function Default
dpSet*() _original.._value
dpGet() _online.._value
dpGetAsynch() _offline.._value
dpGetPeriod() _offline.._value
dpConnect() _online.._value
dpDisconnect() _online.._value

Example

see dpSetTimed()

Assignment

Data point function, waiting Control functions

Availability

CTRL