Porovnávané verzie
porovnané s
Kľúč
- Tento riadok sa pridal
- Riadok je odstránený.
- Formátovanie sa zmenilo.
Akcia UPDATEARCHVAL
Funkcia
Zmena alebo zápis hodnoty do archívu.
Deklarácia
| Blok kódu | ||||
|---|---|---|---|---|
| ||||
UPDATEARCHVAL valueIdent, archIdent [,[retIdent_Int], bRecalcStat_Bool] |
Parametre
| 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:
|
Popis
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
Poznámka
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.
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.
Príklad
Zápis hodnoty do archívu:
| Blok kódu | ||||
|---|---|---|---|---|
| ||||
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 |