Akcia UPDATEARCHVAL

Zmena alebo zápis hodnoty do archívu.

UPDATEARCHVAL valueIdent, archIdent [,[retIdent_Int], bRecalcStat_Bool]

valueIdent	in	Identifikátor hodnoty zapisovanej do archívu.
archIdent	in	Odkaz na jednu (archívnu) hodnotu - (nie je kontrolované, či sa pracuje s archívnym objektom - stačí odkaz na objekt).
retIdent_Int	out	Identifikátor typu Int - návratový kód - úspešnosť zápisu (nepovinný parameter).
bRecalcStat_Bool	in	Identifikátor typu Bool - prepočet súvisiacich štatistických archívnych objektov (nepovinný parameter). Možné hodnoty: @TRUE - povolenie prepočtu @FALSE - zakázanie prepočtu

Akcia zmení (alebo zapíše novú) hodnotu do archívu pre archívny objekt archIdent. Hodnota je daná parametrom valueIdent. Čas, pre ktorý bude hodnota do archívu zapísaná, je daný časom vzniku hodnoty valueIdent. Ak nie je uvedený identifikátor retIdent_Int, akcia nečaká na potvrdenie zápisu. Ak identifikátor je uvedený, nadobúda niektorú z nasledujúcich hodnôt:

• _ERR_TRANS_ABORT
• _ERR_TRANS_ERROR
• _ERR_TRANS_IGNORED
• _ERR_NO_ERROR

Ak identifikátor retIdent_Int nie je uvedený, skript nemá žiadnu spätnú väzbu pre zistenie úspešnosti zápisu. Čas trvania akcie je krátky, lebo ide len o požiadavku, ktorá je odoslaná do systému.
Ak je identifikátor retIdent_Int uvedený, skript čaká na fyzický zápis hodnoty do archívnej databázy.

Dôsledok:
Ak je použitá akciu zápisu do archívu bez čakania a následne sa bude táto hodnota čítať, prečítaná hodnota takmer určite nebude tá, ktorú bola v predchádzajúcej akcii zapisovaná.

Prepočet súvisiacich štatistických objektov je možné zakázať, ak uvedieme nepovinný parameter bRecalcStat_Bool s hodnotou @FALSE.

Zápis hodnoty do archívu:

REAL _archVal TIME _archTime INT _retCode ; čas archivácie _archTime := %StrToTime("12:0:0 1-12-2000") ; príprava hodnoty spolu s časom _archVal := 1 TIME _archTime ; zápis do archívu UPDATEARCHVAL _archVal, H.Int, _retCode ; test úspešnosti akcie IF _retCode # _ERR_NO_ERROR THEN ; chyba pri zápise ENDIF