- This line was added.
- This line was removed.
- Formatting was changed.
UPDATEARCHVAL valueIdent, archIdent [,[retIdent_Int], bRecalcStat_Bool]
|valueIdent||in||Identifier of a value that is to be written into the archive.|
|archIdent||in||Reference to one of (historical) value - (not controlled whether the archive object is used - adding reference to object is enough).|
|retIdent_Int||out||Identifier of Int type - return code: the action success (optional parameter).|
|bRecalcStat_Bool||in||Identifier of Bool type - enable/disable the calculation of|
|depending statistical historical values (optional parameter).|
archIdent. The value is given by the identifier
valueIdent. Time of its storing into the database is the time when the value
valueIdentoccurred. I the identifier retIdent_Int is not statedspecified, the action doesn't wait for the storing confirmation. If the identifier is stated, gains one of the following values:
If the identifier is statedspecified, the script waits for the physical storing of a value into the archive database.
If I use the action to store a value into the archive without waiting and then I want to read this value, the read value almost certainly is not this the one , I that was stored in the by previous action.
Calculation of related depending statistical historical values can be disabled by setting the parameter bRecalcStat_Bool to the value of @FALSE.
REAL _archVal TIME _archTime INT _retCode
; archiving time _archTime := %StrToTime("12:0:0 1-12-2000")
; prepare a value together with time _archVal := 1 TIME _archTime
; storing into the archive UPDATEARCHVAL _archVal, H.Int, _retCode
; action success test IF _retCode # _ERR_NO_ERROR THEN ; error at storing ENDIF