Translations:Documents/User API/27/en

Subsystem "Archives-History" (SYS.Archive)

Functions of the subsystem object:

• Array messGet( int btm, int etm, string cat = "", int lev = 0, string arch = "", int upTm = 0 ); — requests of the program messages or alarms for the time from btm to etm for the category cat, level lev (-7...7) and archivers arch (separated by the symbol ';'; "" — buffer and archivers; "<buffer>" — buffer; "{ArhMod}.{Arh}" — concrete archiver of the module). upTm sets the operation continuance limit to time; a negative value used as relative time; less to STD_INTERF_TM (5). Returns time of stopping of the reading (attribute "tm" of the array) and an array of the message objects with the preset attributes:
  • tm — time of the message, seconds;
  • utm — time of the message, microseconds;
  • categ — category of the message;
  • level — level of the message;
  • mess — text of the message.
• bool messPut( int tm, int utm, string cat, int lev, string mess, string arch = "" ); — writes the message mess with the category cat, level lev (-7...7) and time tm.utm to the archivers arch (separated by the symbol ';') or/and the alarms list.