Porovnávané verzie

Kľúč

  • Tento riadok sa pridal
  • Riadok je odstránený.
  • Formátovanie sa zmenilo.

GETOLDVAL action


Function
Reading of values from the archive of the substation.
Declaration


Blok kódu
languageesl
themeConfluence
GETOLDVAL statIdent, fromTimeIdent_TmA, endTimeIdent_TmA, retIdent_Int, archIdent [MASK mask_txt]
 
or
 


Blok kódu
languageesl
themeConfluence
GETOLDVAL statIdent, fromTimeIdent_TmA, endTimeIdent_TmA, retIdent_Int NOWAIT [MASK mask_txt]
Parameters


statIdentinReference to a Station type
type object
 object.
fromTimeIdent_TmAinIdentifier of the AbsTime type - begin time for reading from the archive.
endTimeIdent_TmAinIdentifier of the AbsTime type - end time for reading from the archive.
retIdent_IntoutReturn code identifier of the Int type.
archIdentinReference to a Process type object (archive).
NOWAITin
Key word
Keyword. If it is not entered, the action waits synchronously for the termination of data reading.
MASKin
Key word
Keyword.
mask_txtinIdentifier of Text type - text string that consists of a mask formed from the names of I/O tags for which the values are to be read.
Description
The action will start the backward reading of values from the archive of a station. Time interval is given by the identifiers fromTimeIdent_TmA and endTimeIdent_TmA. Return code (retIdent_Int) gains one of the following values:
  • _ERR_TRANS_ABORT
  • _ERR_TRANS_ERROR
  • _ERR_TRANS_IGNORED
  • _ERR_NO_ERROR 

In case of the first declaration, the action waits for the termination of the reading and archiving of values, if these are archived. In this case it is necessary to archive all I/O tags in one archive. An archive is represented by the identifier archIdent. The second declaration only starts the backward reading of values and doesn't wait for its termination. Return values is to be always _ERR_NO_ERROR.

If the key word keyword MASK and identifier mask_txt are defined, the action reads values only for those I/O tags that match the definition, which is  entered in the identifier mask_txt. For example mask_txt := "M.RIADENIE*".

Note
If backward reading of communication station values is being performed, the flag A is set for the communication station value.

Info
titleRelated pages:

Script actions