Akcia prečíta archívne hodnoty pre archívny objekt
archIdent z časového intervalu od
timeFromIdent_TmA do
timeToIdent_TmA s krokom
stepIdent_Int (v sekundách). Maximálny počet hodnôt je daný hodnotou identifikátora
maxValsIdent_Int. Pozri
čítanie zaarchivovaných hodnôt.
Parameter
stepIdent_Int určuje prevzorkovanie (v sekundách) čítaných hodnôt. Ak je jeho hodnota 0, čítanie sa neprevzorkováva.
Ak parameter
archIdent obsahuje odkaz na objekt typu
Archivovaná hodnota, činnosť akcie je popísaná vyššie. Ak obsahuje odkaz na objekt, ktorý nie je archívny alebo položku štruktúrovanej premennej, ktorá nie je typu
Objekt, systém sa snaží nájsť archívny objekt (objekt typu
Archivovaná hodnota), ktorý danú hodnotu archivuje.
Ak je parameter
archIdent odkaz na položku štruktúrovanej premennej typu
Objekt, táto ukazuje na určitý objekt v systéme. Ak je tento objekt archívny, dáta budú načítané z neho. Ak nie je, systém sa snaží nájsť archívny objekt, ktorý danú hodnotu archivuje.
Návratový kód
statusIdent_Int
môže nadobúdať jednu z nasledujúcich hodnôt:
- _ERR_TRANS_ABORT
- _ERR_TRANS_ERROR
- _ERR_TRANS_IGNORED
- _ERR_NO_ERROR
- _ERR_NO_DATA - v danom intervale nie sú žiadne dáta
- _ERR_MORE_DATA - v danom intervale je viac hodnôt ako maxValsIdent_Int
- _ERR_OBJECT_IS_NOT_IN_ARCHIVE
Chyba
_ERR_MORE_DATA má len informatívny charakter a žiadaný počet dát je prístupných. Ak je hodnota identifikátora
stepIdent_Int=0, hodnoty z daného časového intervalu nebudú prevzorkované.
Parameter
locVarColValueIdent_Rec obsahuje odkaz na políčko v lokálnej premennej typu
RECORD. Akcia po úspešnom načítaní hodnôt zmení veľkosť (interne akcia
REDIM) poľa na potrebný počet riadkov a postupne (od 1...) naplní dané políčko v každom riadku hodnotou z archívu.
Takisto parameter
locVarColFlagsIdent_Rec je odkaz na políčko v lokálnej premennej typu
RECORD. Políčko musí byť typu
Int. Podobne ako pri predchádzajúcom parametri, akcia zmení veľkosť poľa (veľkosti budú zhodné) a naplní dané políčko v každom riadku archívnymi príznakmi (pozri akciu
GETARCHVAL). Parameter nie je povinný a môže sa vynechať. Položka pre dáta z archívu a položka pre archívne príznaky môžu byť z tej istej lokálnej premennej.
Hodnota parametra archivInstance_Int udáva inštanciu archívu, ktorá realizuje požiadavku. Ak nie je uvedený (alebo má hodnotu 0) požiadavku realizuje aktívna inštancia archívu.