OpenSCADAWiki: Home Page En/Doc/API/part5 ...

5. Subsystem “Archives” (TArchiveS)

Subsystem 'Archives' is represented by an object TArchiveS, which contains at the subsystem level the modular objects of the archivers types TTipArchivator. Each object of the archiver type contains objects of the messages' archivers TMArchivator and values' archivers TVArchivator. In addition, the subsystem object contains the methods of the messages archive and objects of the values' archives TVArchive. The object of the values' archive TVArchive contains the buffer of values through the inheritance of the buffer object TValBuf. To connect the archive of values with the archivers the object of the value element TVArchEl is provided. This object is contained in the archiver and it is referenced by the archive. Structure of the subsystem 'Archives' is presented in Fig. 5.

Fig. 5. The hierarchical structure of subsystem 'Archives'.

Subsystem 'Archives' contains the mechanisms for archiving of messages and values. It directly contains the messages' archive together with its buffer. Contains methods for accessing the archives of the values and for the archivers of values and messages. Besides it performs the actively data acquisition from sources of values for the archives of values, as well as archiving the archive of messages by the archivers.

Archive of values (TVArchive) contains the buffer (TValBuf) for intermediate values' accumulation before archiving.It is connected with the source of values in the person of OpenSCADA system parameters in active or passive mode, as well as with other sources in the passive mode. To archive to the physical storage it is connected with the values' archivers of various types.

Object of the buffer TValBuf contains an array of values of the main types of OpenSCADA system: string, integer, real and boolean. It is supported the storage of values in the modes of hard, soft grid and in the free access mode. It is also provided the mode of high-resolution time (microseconds). It is used for direct storage of large arrays of values, and for the exchange of large arrays by the frame-accurate method of access.

Root object of the module of subsystem 'Archives' (TTipArchivator) contains information about the specific type of module. Within the individual modules it can implement their own module-wide functions. In general, for modules of this type it contains methods to access the repositories of values and messages.

Object of the messages' archiver (TMArchivator) contains the specific implementation of the message storage. In general, for messages' archivers the interface of access to the implementation of an archiving mechanism in modules is provided.

Object of the values' archiver (TVArchivator) contains the specific implementation of the repository of values. In general, for the values' archivers the access interface to implementation of the archiving mechanism and the appointment of archives of values for service by archiver are provided.

Object of the archive element TVArchEl links the archive objects with the archivers. It is used to access the archiver from the archive, as well as to archives from the archiver, ie for cross-calls.

5.1. The object of the subsystem «Archives» (TArchiveS)

Public methods:

• int subVer( ); -- Subsystem's version.
• int messPeriod( ); -- Period of archiving of messages from the buffer (seconds).
• int valPeriod( ); -- Acquisition of values period for the active archivers (milliseconds).
• int valPrior( ); -- Priority of the tasks of the values acquisition for the active archivers.
• void setMessPeriod( int ivl ); -- Setting the period of the archiving of messages from the buffer (seconds).
• void setValPeriod( int ivl ); -- Setting the values' acquisition period for active archivers (milliseconds).
• void setValPrior( int ivl ); -- Setting the priority of the values' acquisition task for the active archivers.
• void subStart( ); -- Start of the subsystem.
• void subStop( ); -- Stop of the system.
• void valList( vector<string> &list ); -- The list of the values'archives in the subsystem.
• bool valPresent( const string &iid ); -- Check for the availability of the values' archive <iid>.
• void valAdd( const string &iid, const string &idb = "*.*" ); -- Addition of the new values' archive <iid>.
• void valDel( const string &iid, bool db = false ); -- Deleting of the values' archive <iid>.
• AutoHD<TVArchive> valAt( const string &iid ); -- Connection/addressing to the values' archive <iid>.
• void setActValArch( const string &id, bool val ); -- Setting of the archive <id> into the active status <val>. Active archive will be provided with the periodic flow of values ( is determined by the periodicity of the archive) of the subsystem.
• AutoHD<TTipArchivator> at( const string &name ); -- Connection/addressing to the archiver's type (module) <name>.
• void messPut( time_t tm, int utm, const string &categ, TMess::Type level, const string &mess ); -- Location of the value <mess> with the level <level> of the category <categ> and time <tm>+<utm> into the buffer, and then into the messages' archive.
• void messPut( const vector<TMess::SRec> &recs ); -- Location of the group of values <recs> into the buffer, and then into the messages' archive.
• void messGet( time_t b_tm, time_t e_tm, vector<TMess::SRec> & recs, const string &category = "", TMess::Type level = TMess::Debug, const string &arch = "" ); -- Values' request <reqs> for the specified period of time <b_tm>, <e_tm> for the specified category (by the template) <category> and level <level> from the archivator <arch>.
• time_t messBeg( const string &arch = "" ); -- Beginning of the messages' archive as a whole or for the specified archiver <arch>.
• time_t messEnd( const string &arch = "" ); -- End of the messages' archive as a whole or for the specified archiver <arch>.
• TElem &messE( ); -- DB structure of the messages' archivers.
• TElem &valE( ); -- DB structure of the values' archivers.
• TElem &aValE( ); -- DB structure of the values' archives.

Public methods:

• static int max_req_mess; -- Maximum size of the messages request (by defaults 3000).

5.2. The object of the values' archive (TVArchive)

Data:
The data acquisition mode/source (struct - TVArchive::SrcMode):

• Passive -- passive mode of the data acquisition, the source puts the data into the archive itself;
• PassiveAttr -- passive mode of the data acquisition from the parameter's attribute, the parameter's attribute puts the data into the archive itself;
• ActiveAttr -- active mode of the data acquisition from the parameter's attribute, the parameter's attribute is periodically polled by the subsystem "Archives";

Public methods:

• TVArchive( const string &id, const string &db, TElem *cf_el ); -- Initializing constructor of the archive, where <id> -- archive ID, <db> -- DB for storage and <cf_el> -- DB structure of the values' archives.
• const string &id( ); -- Archive's ID.
• string name( ); -- Archive's name.
• string dscr( ); -- Archive's description.
• SrcMode srcMode( ); -- Linkage mode with the data source.
• string srcData( ); -- Parameters of the data source, in the case of access mode to the parameter this is the address of the parameter.
• bool toStart( ); -- Sign: "Start the archive when starting the system".
• bool startStat( ); -- Status: "Archive started".
• string DB( ); -- DB address of the values' archive.
• string tbl( ); -- DB table of the values' archive.
• string fullDB( ); -- Full name of the DB table of the values' archive.
• long long end( const string &arch = BUF_ARCH_NM ); -- End of the archive time at whole (arch="") or the specified archiver, buffer (arch="<bufer>").
• long long begin( const string &arch = BUF_ARCH_NM ); -- Start of the archive time at whole (arch="") or the specified archiver, buffer (arch="<bufer>").
• long long period( const string &arch = BUF_ARCH_NM ); -- Periodicity of the archive buffer or the specified archiver (microseconds).
• TFld::Type valType( ); -- Type of the archived value.
• bool hardGrid( ); -- Using of the hard grid in the archive buffer.
• bool highResTm( ); -- Using of the high-resolution time in the archive buffer (microseconds).
• int size( ); -- Archive buffer size (units).
• void setName( const string &inm ); -- Setting the name of the archive.
• void setDscr( const string &idscr ); -- Setting the description of the archive.
• void setSrcMode( SrcMode vl, const string &isrc = "" ); -- Setting the linkage mode with the data source.
• void setToStart( bool vl ); -- Setting the sign: "Start the archive when starting the system".
• void setDB( const string &idb ); -- Setting the DB address of the values' archive.
• void setValType( TFld::Type vl ); -- Setting the type of the archived value.
• void setHardGrid( bool vl ); -- Setting the using of the hard grid in the archive buffer.
• void setHighResTm( bool vl ); -- Setting of using of the high-resolution time in the archive buffer (microseconds).
• void setSize( int vl ); -- Setting of the archive buffer size (units).
• void setPeriod( long long vl ); -- Setting the periodicity of the archive buffer.
• void start( ); -- Start of the archive.
• void stop( bool full_del = false ); -- Stop of the archive with it's completely deleting <full_del>.
• TVariant getVal( long long *tm = NULL, bool up_ord = false, const string &arch = "", bool onlyLocal = false ); -- Request of the single value for the time <tm> and with the sign of the moving to the top <up_ord> from the specified archiver <arch>, buffer (arch = "<bufer">) or from all archivers in the course of falling quality (arch =""). To process the request only by the local station <onlyLocal> is set.
• void getVals( TValBuf &buf, long long beg = 0, long long end = 0, const string &arch = "", int limit = 100000, bool onlyLocal = false ); -- Çàïðîñ êàäðà çíà÷åíèé <buf> çà âðåìÿ îò <beg> äî <end> èç óêàçàííîãî àðõèâàòîðà <arch>, áóôåðà (arch="<bufer>") èëè âñåõ àðõèâàòîðîâ ïî ìåðå ïàäåíèÿ êà÷åñòâà (arch=""), ñ îãðàíè÷åíèåì ðàçìåðà çàïðîñà â <limit> çàïèñåé. Äëÿ çàïðîñà òîëüêî ëîêàëüíûõ àðõèâîâ, áåç êîìïåíñàöèè ïðîáåëîâ àðõèâîâ èç ðåçåðâíûõ ñòàíöèé, óñòàíàâëèâàåòñÿ <onlyLocal>.
• void setVals( TValBuf &buf, long long beg, long long end, const string &arch ); -- Çàãðóçêà êàäðà çíà÷åíèé <buf> çà âðåìÿ îò <beg> äî <end> â óêàçàííûé àðõèâàòîð <arch>, áóôåð (arch="<bufer>") èëè âñå àðõèâàòîðû (arch="").
• void getActiveData( ); -- Îïðîñèòü èñòî÷íèê äàííûõ. Èñïîëüçóåòñÿ ïîäñèñòåìîé äëÿ ïåðèîäè÷åñêîãî ñáîðå äàííûõ àêòèâíûìè àðõèâàìè.
• void archivatorList( vector<string> &ls ); -- Ñïèñîê àðõèâàòîðîâ êîòîðûìè îáñëóæèâàåòñÿ àðõèâ.
• bool archivatorPresent( const string &arch ); -- Ïðîâåðêà àðõèâàòîðà íà îáñëóæèâàíèå äàííîãî àðõèâà.
• void archivatorAttach( const string &arch ); -- Ïîäêëþ÷åíèå äàííîãî àðõèâà íà îáñëóæèâàíèå óêàçàííûì àðõèâàòîðîì.
• void archivatorDetach( const string &arch, bool full = false ); -- Îòêëþ÷åíèå äàííîãî àðõèâà îò îáñëóæèâàíèå óêàçàííûì àðõèâàòîðîì.
• void archivatorSort( ); -- Ñîðòèðîâêà îáñëóæèâàþùèõ àðõèâàòîðîâ â ïîðÿäêå óõóäøåíèÿ êà÷åñòâà.
• string makeTrendImg( long long beg, long long end, const string &arch, int hsz = 650, int vsz = 230 ); -- Ôîðìèðîâàíèå èçîáðàæåíèÿ (pdf) òðåíäà çà óêàçàííûé ïðîìåæóòîê âðåìåíè <beg>, <end> è óêàçàííîãî àðõèâàòîðà <arch>.
• TArchiveS &owner( ); -- Ïîäñèñòåìà "Àðõèâû" - âëàäåëåö àðõèâà çíà÷åíèé.

5.3. Îáúåêò áóôåðà çíà÷åíèé (TValBuf)

Ïóáëè÷íûå ìåòîäû:

• TValBuf( ); -- Èíèöèàëèçàòîð áóôåðà ñ óñòàíîâêàìè ïî óìîë÷àíèþ.
• TValBuf( TFld::Type vtp, int isz, long long ipr, bool ihgrd = false, bool ihres = false ); -- Èíèöèàëèçàòîð áóôåðà ñ óêàçàííûìè ïàðàìåòðàìè.
• void clear( ); -- Î÷èñòêà áóôåðà.
• TFld::Type valType( ); -- Òèï çíà÷åíèÿ õðàíèìîãî áóôåðîì.
• bool hardGrid( ); -- Ðàáîòà áóôåðà â ðåæèìå æåñòêîé ñåòêè.
• bool highResTm( ); -- Ðàáîòà áóôåðà â ðåæèìå âðåìåíè âûñîêîãî ðàçðåøåíèÿ (ìèêðîñåêóíäû).
• int size( ); -- Ìàêñèìàëüíûé ðàçìåð áóôåðà (åäåíèö).
• int realSize( ); -- Ðåàëüíûé ðàçìåð áóôåðà (åäåíèö).
• long long period( ); -- Ïåðèîäè÷íîñòü çíà÷åíèé â áóôåðå (ìèêðîñåêóíä). Åñëè ïåðèîäè÷íîñòü íóëåâàÿ òî áóôåð ôóíêöèîíèðóåò â ðåæèìå ñâîáîäíîãî äîñòóïà.
• long long begin( ); -- Âðåìÿ íà÷àëà áóôåðà (ìèêðîñåêóíä).
• long long end( ); -- Âðåìÿ îêîí÷àíèÿ áóôåðà (ìèêðîñåêóíä).
• bool vOK( long long ibeg, long long iend ); -- Ïðîâåðêà íàëè÷èÿ çíà÷åíèé â áóôåðå çà óêàçàííûé ïðîìåæóòîê âðåìåíè îò <ibeg> äî <iend>.
• void setValType( TFld::Type vl ); -- Óñòàíîâêà òèïà çíà÷åíèÿ õðàíèìîãî áóôåðîì.
• void setHardGrid( bool vl ); -- Óñòàíîâêà ðåæèìà æåñòêîé ñåòêè.
• void setHighResTm( bool vl ); -- Óñòàíîâêà ðåæèìà âðåìåíè âûñîêîãî ðàçðåøåíèÿ (ìèêðîñåêóíäû).
• void setSize( int vl ); -- Óñòàíîâêà ðàçìåðà áóôåðà (åäåíèö).
• void setPeriod( long long vl ); -- Óñòàíîâêà ïåðèîäè÷íîñòè çíà÷åíèé â áóôåðå (ìèêðîñåêóíä).
• virtual void getVals( TValBuf &buf, long long beg = 0, long long end = 0 ); -- Çàïðîñ êàäðà çíà÷åíèé <buf> çà âðåìÿ îò <beg> äî <end>.
• virtual string getS( long long *tm = NULL, bool up_ord = false ); -- Çàïðîñ çíà÷åíèÿ ñòðîêîâîãî òèïà çà âðåìÿ <tm> è ïðèçíàêîì ïðèòÿãèâàíèÿ ê âåðõó <up_ord>.
• virtual double getR( long long *tm = NULL, bool up_ord = false ); -- Çàïðîñ çíà÷åíèÿ âåùåñòâåííîãî òèïà çà âðåìÿ <tm> è ïðèçíàêîì ïðèòÿãèâàíèÿ ê âåðõó <up_ord>.
• virtual int getI( long long *tm = NULL, bool up_ord = false ); -- Çàïðîñ çíà÷åíèÿ öåëîãî òèïà çà âðåìÿ <tm> è ïðèçíàêîì ïðèòÿãèâàíèÿ ê âåðõó <up_ord>.
• virtual char getB( long long *tm = NULL, bool up_ord = false ); -- Çàïðîñ çíà÷åíèÿ ëîãè÷åñêîãî òèïà çà âðåìÿ <tm> è ïðèçíàêîì ïðèòÿãèâàíèÿ ê âåðõó <up_ord>.
• virtual void setVals( TValBuf &buf, long long beg = 0, long long end = 0 ); -- Óñòàíîâêà êàäðà çíà÷åíèé èç <buf> çà âðåìÿ îò <beg> äî <end>.
• virtual void setS( const string &value, long long tm = 0 ); -- Óñòàíîâêà çíà÷åíèÿ ñòðîêîâîãî òèïà ñ âðåìåíåì <tm>.
• virtual void setR( double value, long long tm = 0 ); -- Óñòàíîâêà çíà÷åíèÿ âåùåñòâåííîãî òèïà ñ âðåìåíåì <tm>.
• virtual void setI( int value, long long tm = 0 ); -- Óñòàíîâêà çíà÷åíèÿ öåëîãî òèïà ñ âðåìåíåì <tm>.
• virtual void setB( char value, long long tm = 0 ); -- Óñòàíîâêà çíà÷åíèÿ ëîãè÷åñêîãî òèïà ñ âðåìåíåì <tm>.

Çàùèù¸ííûå ìåòîäû:

• void makeBuf( TFld::Type v_tp, int isz, long long ipr, bool hd_grd, bool hg_res ); -- Ïåðåñîçäàíèå áóôåðà äëÿ óêàçàííûõ ïàðàìåòðîâ.

5.4. Ìîäóëüíûé îáúåêò òèïà àðõèâàòîðà (TTipArchivator)

Ïóáëè÷íûå ìåòîäû:

• void messList( vector<string> &list ); -- Ñïèñîê àðõèâàòîðîâ ñîîáùåíèé.
• bool messPresent( const string &iid ); -- Ïðîâåðêà íà íàëè÷èå óêàçàííîãî àðõèâàòîðà ñîîáùåíèé.
• void messAdd( const string &iid, const string &idb = "*.*" ); -- Äîáàâëåíèå àðõèâàòîðà ñîîáùåíèé.
• void messDel( const string &iid, bool full = false ); -- Óäàëåíèå àðõèâàòîðà ñîîáùåíèé.
• AutoHD<TMArchivator> messAt( const string &iid ); -- Ïîäêëþ÷åíèå ê àðõèâàòîðó ñîîáùåíèé.
• void valList( vector<string> &list ); -- Ñïèñîê àðõèâàòîðîâ çíà÷åíèé.
• bool valPresent( const string &iid ); -- Ïðîâåðêà íà íàëè÷èå óêàçàííîãî àðõèâàòîðà çíà÷åíèé.
• void valAdd( const string &iid, const string &idb = "*.*" ); -- Äîáàâëåíèå àðõèâàòîðà çíà÷åíèé.
• void valDel( const string &iid, bool full = false ); -- Óäàëåíèå àðõèâàòîðà çíà÷åíèé.
• AutoHD<TVArchivator> valAt( const string &iid ); -- Ïîäêëþ÷åíèå ê àðõèâàòîðó çíà÷åíèé.
• TArchiveS &owner( ); -- Ïîäñèñòåìà "Àðõèâû" - âëàäåëåö òèïà àðõèâàòîðà.

Çàùèù¸ííûå ìåòîäû:

• virtual TMArchivator *AMess( const string &iid, const string &idb ); -- Ìîäóëüíûé ìåòîä ñîçäàíèå àðõèâàòîðà ñîîáùåíèé.
• virtual TVArchivator *AVal( const string &iid, const string &idb ); -- Ìîäóëüíûé ìåòîä ñîçäàíèå àðõèâàòîðà çíà÷åíèé.

5.5. Îáúåêò àðõèâàòîðà ñîîáùåíèé (TMArchivator)

Ïóáëè÷íûå ìåòîäû:

• TMArchivator( const string &id, const string &db, TElem *cf_el ); -- Èíèöèàëèçèðóþùèé êîíñòðóêòîð àðõèâàòîðà ñîîáùåíèé ñ èäåíòèôèêàòîðîì <id>, äëÿ õðàíåíèÿ íà ÁÄ <db> ñî ñòðóêòóðîé <cf_el>.
• const string &id( ); -- Èäåíòèôèêàòîð àðõèâàòîðà.
• string workId( ); -- Ðàáî÷èé èäåíòèôèêàòîð, âêëþ÷àåò èìÿ ìîäóëÿ.
• string name( ); -- Èìÿ àðõèâàòîðà.
• string dscr( ); -- Îïèñàíèå àðõèâàòîðà.
• bool toStart( ); -- Ïðèçíàê «Çàïóñêàòü àðõèâàòîð».
• bool startStat( ); -- Ñîñòîÿíèå àðõèâàòîðà «Çàïóùåí».
• string &addr( ); -- Àäðåñ õðàíèëèùà àðõèâàòîðà.
• int &level( ); -- Óðîâåíü ñîîáùåíèé îáñëóæèâàåìûõ àðõèâàòîðîì.
• void categ( vector<string> &list ); -- Êàòåãîðèè (øàáëîíû) ñîîáùåíèé îáñëóæèâàåìûõ àðõèâàòîðîì.
• string DB( ); -- Àäðåñ ÁÄ àðõèâàòîðà.
• string tbl( ); -- Àäðåñ òàáëèöû ÁÄ àðõèâàòîðà.
• string fullDB( ); -- Ïîëíûé àäðåñ òàáëèöû ÁÄ àðõèâàòîðà.
• void setName( const string &vl ); -- Óñòàíîâêà èìåíè àðõèâàòîðà.
• void setDscr( const string &vl ); -- Óñòàíîâêà îïèñàíèå àðõèâàòîðà.
• void setToStart( bool vl ); -- Óñòàíîâêà ïðèçíàêà «Çàïóñêàòü àðõèâàòîð».
• void setAddr( const string &vl ); -- Óñòàíîâêà àäðåñà õðàíèëèùà àðõèâàòîðà.
• void setLevel( int lev ); -- Óñòàíîâêà óðîâíÿ ñîîáùåíèé îáñëóæèâàåìûõ àðõèâàòîðîì.
• void setDB( const string &idb ); -- Óñòàíîâêà àäðåñà ÁÄ àðõèâàòîðà.
• virtual void start( ); -- Çàïóñê àðõèâàòîðà.
• virtual void stop( ); -- Îñòàíîâ àðõèâàòîðà.
• virtual time_t begin( ); -- Íà÷àëî àðõèâà äàííîãî àðõèâàòîðà.
• virtual time_t end( ); -- Êîíåö àðõèâà äàííîãî àðõèâàòîðà.
• virtual void put( vector<TMess::SRec> &mess ); -- Ïîìåñòèòü ãðóïïó ñîîáùåíèé â àðõèâ ñîîáùåíèé äàííîãî àðõèâàòîðà.
• virtual void get( time_t b_tm, time_t e_tm, vector<TMess::SRec> &mess, const string &category = "", char level = 0 ); -- Ïîëó÷èòü ñîîáùåíèÿ èç àðõèâà äàííîãî àðõèâàòîðà äëÿ óêàçàííûõ ïàðàìåòðîâ ôèëüòðà.
• TTipArchivator &owner( ); -- Òèï àðõèâàòîðà – âëàäåëåö àðõèâàòîðîì ñîîáùåíèé.

Çàùèù¸ííûå àòðèáóòû:

• bool run_st; -- Ïðèçíàê «Çàïóùåí».

Çàùèù¸ííûå ìåòîäû:

• bool chkMessOK( const string &icateg, TMess::Type ilvl ); -- Ïðîâåðêà ñîîáùåíèÿ íà ñîîòâåòñòâèå óñëîâèÿì ôèëüòðà.

5.6. Îáúåêò àðõèâàòîðà çíà÷åíèé (TVArchivator)

Ïóáëè÷íûå ìåòîäû:

• TVArchivator( const string &id, const string &db, TElem *cf_el ); -- Èíèöèàëèçèðóþùèé êîíñòðóêòîð àðõèâàòîðà çíà÷åíèé ñ èäåíòèôèêàòîðîì <id>, äëÿ õðàíåíèÿ íà ÁÄ <db> ñî ñòðóêòóðîé <cf_el>.
• const string &id( ); -- Èäåíòèôèêàòîð àðõèâàòîðà.
• string workId( ); -- Ðàáî÷èé èäåíòèôèêàòîð, âêëþ÷àåò èìÿ ìîäóëÿ.
• string name( ); -- Èìÿ àðõèâàòîðà.
• string dscr( ); -- Îïèñàíèå àðõèâàòîðà.
• string addr( ); -- Àäðåñ õðàíèëèùà àðõèâàòîðà.
• double valPeriod( ); -- Ïåðèîäè÷íîñòü çíà÷åíèé àðõèâàòîðà (ìèêðîñåêóíä).
• int archPeriod( ); -- Ïåðèîäè÷íîñòü àðõèâèðîâàíèÿ çíà÷åíèé àðõèâàòîðîì. Âðåìÿ ÷åðåç êîòîðîå àðõèâàòîð ïðîèçâîäèò àðõèâèðîâàíèå êàäðà çíà÷åíèé èç áóôåðà àðõèâà.
• bool toStart( ); -- Ïðèçíàê «Çàïóñêàòü àðõèâàòîð».
• bool startStat( ); -- Ñîñòîÿíèå àðõèâàòîðà «Çàïóùåí».
• string DB( ); -- Àäðåñ ÁÄ àðõèâàòîðà.
• string tbl( ); -- Àäðåñ òàáëèöû ÁÄ àðõèâàòîðà.
• string fullDB( ); -- Ïîëíûé àäðåñ òàáëèöû ÁÄ àðõèâàòîðà.
• void setName( const string &inm ); -- Óñòàíîâêà èìåíè àðõèâàòîðà.
• void setDscr( const string &idscr ); -- Óñòàíîâêà îïèñàíèÿ àðõèâàòîðà.
• void setAddr( const string &vl ); -- Óñòàíîâêà àäðåñà õðàíèëèùà àðõèâàòîðà.
• virtual void setValPeriod( double iper ); -- Óñòàíîâêà ïåðèîäè÷íîñòè çíà÷åíèé àðõèâàòîðà (ìèêðîñåêóíä).
• virtual void setArchPeriod( int iper ); -- Óñòàíîâêà ïåðèîäè÷íîñòè àðõèâèðîâàíèÿ çíà÷åíèé àðõèâàòîðîì. Âðåìÿ ÷åðåç êîòîðîå àðõèâàòîð ïðîèçâîäèò àðõèâèðîâàíèå êàäðà çíà÷åíèé èç áóôåðà àðõèâà.
• void setToStart( bool vl ); -- Óñòàíîâêà ïðèçíàêà "Çàïóñêàòü àðçèâàòîð".
• void setDB( const string &idb ); -- Óñòàíîâêà àäðåñà ÁÄ àðõèâàòîðà.
• virtual void start( ); -- Çàïóñê àðõèâàòîðà.
• virtual void stop( bool full_del = false ); -- Îñòàíîâ àðõèâàòîðà ñ âîçìîæíîñòüþ ïîëíîãî óäàëåíèÿ <full_del>.
• void archiveList( vector<string> &ls ); -- Ñïèñîê àðõèâîâ îáñëóæèâàåìûõ àðõèâàòîðîì.
• bool archivePresent( const string &iid ); -- Ïðîâåðêà íà îáñëóæèâàåìîñòü óêàçàííîãî àðõèâà àðõèâàòîðîì.
• TTipArchivator &owner( ); -- Òèï àðõèâàòîðà – âëàäåëåö àðõèâàòîðîì çíà÷åíèé.

Çàùèù¸ííûå ìåòîäû:

• TVArchEl *archivePlace( TVArchive &item ); -- Âêëþ÷èòü àðõèâ <item> â îáðàáîòêó àðõèâàòîðîì.
• void archiveRemove( const string &id, bool full = false ); -- Óäàëèòü àðõèâ <id> èç îáðàáîòêè àðõèâàòîðîì, ñ âîçìîæíîñòüþ ïîëíîãî óäàëåíèÿ <full>.
• virtual TVArchEl *getArchEl( TVArchive &arch ); -- Ïîëó÷åíèå îáúåêòà ýëåìåíòà àðõèâà äëÿ óêàçàííîãî àðõèâà.

Çàùèù¸ííûå àòðèáóòû:

• Res a_res -- Ðåñóðñ ïðîöåññà àðõèâèðîâàíèÿ.
• bool run_st -- Ïðèçíàê "Àðõèâ çàïóùåí".
• vector<TVArchEl *> arch_el; -- Ìàññèâ ýëåìåíòîâ àðõèâîâ.

5.7. Îáúåêò ýëåìåíòà àðõèâà â àðõèâàòîðå (TVArchEl)

Ïóáëè÷íûå ìåòîäû:

• TVArchEl( TVArchive &iachive, TVArchivator &iarchivator ); -- Èíèöèàëèçèðóþùèé êîíñòðóêòîð äëÿ ñâÿçè àðõèâà <iachive> ñ àðõèâàòîðîì <iarchivator>.
• virtual void fullErase( ); -- Ïîëíîå óäàëåíèå ýëåìåíòà.
• virtual long long end( ); -- Âðåìÿ êîíöà äàííûõ (ìèêðîñåêóíäû).
• virtual long long begin( ); -- Âðåìÿ íà÷àëà äàííûõ (ìèêðîñåêóíäû).
• long long lastGet( ); -- Âðåìÿ ïîñëåäíåãî ñáðîñà äàííûõ èç áóôåðà â õðàíèëèùå.
• TVariant getVal( long long *tm, bool up_ord, bool onlyLocal = false ); -- Çàïðîñ çíà÷åíèÿ çà âðåìÿ <tm> è ïðèçíàêîì ïðèòÿãèâàíèÿ ê âåðõó <up_ord>, ñ óêàçàíèåì çàïðîñà òîëüêî ëîêàëüíîãî àðõèâà â <onlyLocal>.
• void getVals( TValBuf &buf, long long beg = 0, long long end = 0, bool onlyLocal = false ); -- Çàïðîñ êàäðà çíà÷åíèé <buf> çà âðåìÿ îò <beg> äî <end>, ñ óêàçàíèåì çàïðîñà òîëüêî ëîêàëüíîãî àðõèâà â <onlyLocal>.
• void setVals( TValBuf &buf, long long beg = 0, long long end = 0 ); -- Óñòàíîâêà êàäðà çíà÷åíèé èç <buf> çà âðåìÿ îò <beg> äî <end>.
• TVArchive &archive( ); -- Àðõèâ ýëåìåíòà.
• TVArchivator &archivator( ); -- Àðõèâàòîð ýëåìåíòà.

Ïóáëè÷íûå àòðèáóòû:

• long long prev_tm; -- Âðåìÿ ïðåäûäóùåãî çíà÷åíèÿ. Èñïîëüçóåòñÿ äëÿ óñðåäíåíèÿ.
• string prev_val; -- Ïðåäûäóùåå çíà÷åíèå. Èñïîëüçóåòñÿ äëÿ óñðåäíåíèÿ.

Çàùèù¸ííûå ìåòîäû:

• virtual TVariant getValProc( long long *tm, bool up_ord ); -- Ôóíêöèÿ îáðàáîòêè çàïðîñà îäíîãî çíà÷åíèÿ èç àðõèâà.
• virtual void getValsProc( TValBuf &buf, long long beg, long long end ); -- Ôóíêöèÿ îáðàáîòêè çàïðîñà ìîäóëåì íà ïîëó÷åíèå äàííûõ.
• virtual void setValsProc( TValBuf &buf, long long beg, long long end ); -- Ôóíêöèÿ îáðàáîòêè çàïðîñà ìîäóëåì íà óñòàíîâêó äàííûõ.