Documents/API

This page describes an application programming interface (API) of OpenSCADA.

OpenSCADA is the project of an open SCADA-system based on the modular principle. The document contains an exhaustive description of the internal system architecture of OpenSCADA. In addition to information on the architecture the background information on methods and attributes of the system is provided.
The document is intended for programmers wishing to understand the architecture of OpenSCADA and develop extensions for it. The document is not intended for users and integrators of OpenSCADA!

For understanding of this document it is necessary for you to know the concept of Object Oriented Programming (OOP) and Universal Modeling Language (UML), and for the possibility of studying the source code of the project it is required the knowledge of programming language C++. In addition, the document contains the mentioning of the following technologies: relational databases, XML.

1 The internal structure, OpenSCADA API

For the purpose of visual and affordable perception of OpenSCADA architecture in general the Figure 1 shows the static class diagram of OpenSCADA on the universal modeling language (UML). Based on the chart it is clear that OpenSCADA contains modular subsystems: "Archives", "Databases", "Transports", "Transport protocols", "User interfaces", "Data acquisition" and "Special", as well as subsystems: "Safety" and "Module's management". The chart graphically presents the relationship between modular subsystems and modules.

Fig. 1. Static class diagram.

2 The overall structure of the system. Modularity (TSYS, TSubSYS, TModule)

The root, from which we construct the whole system is the object of TSYS. The root contains a subsystem (TSubSYS). Subsystems can be: the ordinary and modular. The difference between the modular subsystems is clearly shown in Fig. 1. Thus, the modular subsystems necessarily contain a list of modular structures (TModule), such as subsystem TArchiveS contain modular objects TTypeArchivator. At the same time, the normal subsystem does not contain such objects. For example TSecurity subsystem (Figure 2).

Fig. 2. Hierarchical structure of OpenSCADA.

In the process of initializing the root (TSYS) the global variable SYS is defined. The variable SYS can be used for direct access to the root of the system from any of its node. Initialization of the root is performed only one time from the main calling function. After starting the management is captured by the system object till stop. The root object concentrate all system functions of OpenSCADA.

Extension of the root object (TSYS) is the object TMess, which performs the functions of service of the flow of system messages. The object is accessible through the global variable Mess, which is initialized by the root of the system. The object contains the functions of encoding, decoding, and localization of messages.

In the subsystems (TSubSYS) the functions typical for each subsystem individually with the general access for all subsystems are carried out through the object TSubSYS. Modular subsystem is able to extend its functionality by means of modules. For this purpose, modular subsystem provides access to the modules of its type in the form of modular objects.

Module is the component of the modular subsystem. In general, for all modules and subsystems, the module provides information about itself, its origin and export functions. Individual module implements the functionality according to its own needs.

2.1 The root object system (TSYS)

Data:
Information variables of the program:

• PACKAGE_LICENSE — Distribution license of the program
• PACKAGE_DESCR — Brief description of the program
• PACKAGE_AUTHOR — Author of the program
• PACKAGE_SITE — Web site of the program support

Methods for coding of symbol sequences (enum — TSYS::Code):

• PathEl — element of the path (the characters: '/' and '%' to the form '%2f');
• HttpURL — address of the browser (http url);
• Html — special characters for use in html;
• JavaSc — end of line character for JavaScript;
• SQL — SQL-query value;
• Custom — selective coding of the specified characters;
• base64 — Mime encoding in the standard Base64;
• FormatPrint — Coding/masking of the formating elements for functions like "printf";
• oscdID — coding of the nodes' identifiers.
• Bin — Encoding of the binary data in text and vice versa.
• Reverse — Invert the order of characters in the line.
• ShieldSimb — Shielded symbols like "\n" encoding to real code.
• ToLower — Convert to lower case.

Types of representations of the integer in the function TSYS::int2str(), and TSYS::ll2str() (enum — TSYS::IntView):

• Dec — decimal;
• Oct — octal;
• Hex — hexadecimal.

Structure of redundant station (class — TSYS::SStat):

• int8_t lev; — station level;
• bool isLive; — flag "Station Alive";
• float cnt; — counter of requests to the remote station or timer of a re-connection try;
• SStat( int8_t ilev, bool iisLive = false, float icnt = 0 ) — station object constructor with level ilev, initiated as "Alive" iisLive and counter icnt;
• SStat( ) — constructor by default, initiated as as a missed and an inactive station;
• bool isActive( ) — station is active.

Structure of OpenSCADA task (class — TSYS::STask):

• STask( pthread_t ithr, char ipolicy, char iprior ); — constructor of the task's descriptor for thread ithr, it's scheduling policy ipolicy and priority iprior.
• float consumpt( ) const; — the task's last CPU time consumption, in seconds.
• float period( ); — the task's call instant periodicity, in seconds.
• string path; — path.
• pthread_t thr; — thread handler.
• uint8_t policy, phase; — scheduling policy and phase.
• int16_t prior; — scheduling priority.
• pid_t tid; — thread's identifier as a Linux process's ID.
• ResString cpuSet; — used processors/cores list.
• void *(*task) (void *); — pointer to the task.
• void *taskArg; — arguments of the task.
• unsigned flgs; — flags, "enum Flgs { Detached = 0x01, FinishTask = 0x02; }".
• int64_t tm_beg, tm_end, tm_per, tm_pnt, cycleLost, lagMax, consMax; — statistic variables of the task execution.

Templates/definitions:

• NSTR_BUF_LEN — Length of string buffers for numbers (50 symbols).
• BUF_ARCH_NM — The archive buffer name ("<buffer>").
• ALRM_ARCH_NM — The alarms table name ("<alarms>").
• ALRM_ARCH_CH_NM — The alarms table name ("<alarmsChange>") just for changing.
• __func__ — The full name of the calling function.
• vmin (a,b) — Determination of the minimum value.
• vmax (a,b) — Definition of the maximum value.

Public methods:

• TSYS( int argi, char **argb, char **env ); — The initialisation constructor.
• bool isRunning( ); — Sign of the station running state — executing the main threaded module or waiting the stop signal.
• bool isFinalKill( ); — Sign "The final killing of". It is used for forced disconnection of blocked objects on the the final stage of shutdown.
• int stopSignal( ); — The return code in the case of system shutdown. Can be used as a sign of "System shutdown" of the various subsystems.
• void unload( ); — Unload subsystems.
• int start( ); — Start of the system. The function is finished only with the finishing of the system. The return code is returned.
• void stop( int sig = SIGUSR1 ); — Stop program by the signal sig, by default it is SIGUSR1 and SIGUSR2 reserved for projects manager.
• string id( ); — station ID.
• string name( ); — Localized name of the station.
• string user( ); — The system user on behalf of which the system is running .
• string host( ); — Host name for the station run.
• void list( vector<string> &list ) const; — A list of registered subsystems in the system.
• bool present( const string &name ) const; — Check the availability of the subsystem.
• void add( TSubSYS *sub ); — Add/registration of the subsystem.
• void del( const string &name ); — Removing the subsystem.
• AutoHD<TSubSYS> at( const string &name ) const; — Connection to the specified subsystem.
• AutoHD<TUIS> ui( ); — Direct access to the subsystem "User interfaces".
• AutoHD<TArchiveS> archive( ); — Direct access to the subsystem "Archives".
• AutoHD<TBDS> db( ); — Direct access to the subsystem "Databases".
• AutoHD<TControllerS> daq( ); — Direct access to the subsystem "Data acquisition".
• AutoHD<TProtocolS> protocol( ); — Direct access to the subsystem "Protocols".
• AutoHD<TTransportS> transport( ); — Direct access to the subsystem "Transports".
• AutoHD<TSpecialS> special( ); — Direct access to the subsystem "Special".
• AutoHD<TModSchedul> modSchedul( ); — Direct access to the subsystem "Module".
• AutoHD<TSesurity> sesurity( ); — Direct access to the subsystem "Security".
• string workDir( ); — Working directory of the station.
• string modDir( ); — Directories with the modules of OpenSCADA, separated by ';', they can include a files' template into the end (/my/modules/path/lib*.so).
• string icoDir( ); — Directory of the icons of OpenSCADA.
• string docDir( ); — Directory of the documents of OpenSCADA.
• void setWorkDir( const string &wdir, bool init = false ); — Setting the working directory of the station.
• void setModDir( const string &mdir, bool init = false ); — Specifying the directories of the modules of OpenSCADA.
• void setIcoDir( const string &idir, bool init = false ); — Specifying of the directory of icons of OpenSCADA.
• void setDocDir( const string &idir, bool init = false ); — Specifying of the directory of documents of OpenSCADA.
• string cfgFile( ); — Name of configuration file of the system.
• XMLNode &cfgRoot( ); — Parsed structure of the configuration file.
• XMLNode *cfgNode( const string &path, bool create = false ); — Node of configuration getting by it path path. Elements of the path creation by it miss create.
• void modifCfg( bool chkPossibleWR = false ); — Configuration mark to modification or write possibility chkPossibleWR, for next saving to file.
• ResRW &cfgRes( ); — Lock of the access to the config file tree.
• string workDB( ); — The full name of the working database.
• string mainCPUs( ); — Used processors list.
• bool clockRT( ); — The Real-time clock selection for the tasks planning, else used the monotonic one (by defaults).
• int taskInvPhs( ); — Number of the tasks invoking phases.
• bool saveAtExit( ); — Sign - "Save configuration on exit".
• int savePeriod( ); — Frequency of the automatically saving the station in the database (seconds).
• bool modifCalc( ); — Set modification for the calculated objects.
• void setSelDB( const string &vl ); — Installation of the selected database for the specified boot.
• void setMainCPUs( const string &vl ); — Setting of used processors list.
• void setClockRT( bool vl ); — Setting of the Real-time clock selection for the tasks planning.
• void setTaskInvPhs( int vl ); — Setting number of the tasks invoking phases.
• void setSaveAtExit( bool vl ); — Setting of the sign - "Save configuration on exit".
• void setSavePeriod( int vl ); — Set the frequency of the automatically saving of the station to the database (seconds).
• void setModifCalc( bool vl ); — Set of setting the modification for the calculated objects.
• string selDB( ); — Chosen DB. Used for selective loading from the specified database in the subsystem "DB".
• void setWorkDB( const string &wdb ); — Setting of the full name of the working database.
• bool chkSelDB( const string &wDB ); — The function of checking for compliance of the specified database wDB with the selected "selDB()".
• XMLNode *cfgCtx( ); — The global configuration context of the interstation copy, for the access lock use cfgLoadSaveM().
• void setCfgCtx( XMLNode *vl ); — Set the global configuration context of the interstation copy, for the access lock use cfgLoadSaveM().
• ResMtx &cfgLoadSaveM( ); — Lock of the loading and saving configuration.
• static void sighandler( int signal ); — Function of the default handler of the signals of the system as a whole.
• unsigned long long sysClk( ); — The estimated frequency of the processor on which the system works (Hz).
• void clkCalc( ); — Calculation of frequency of the processor on which the system works. It is called periodically for the systems with variable CPU frequency.
• unsigned long long shrtCnt( ); — The function of the measurement of small intervals of time by the counter of the CPU cycles. Returns the value of the counter of CPU cycles.
• static long HZ( ); — Time of the system teak of the CPU.
• void taskCreate( const string &path, int priority, void *(*start_routine)(void *), void *arg, int wtm = 5, pthread_attr_t *pAttr = NULL, bool *startSt = NULL ); — Create task (thread) with id path, priority (-1...99), task's function start_routine and it argument arg, and also wait for user's code start by flag startSt.
• void taskDestroy( const string &path, bool *endrunCntr = NULL, int wtm = 5, bool noSignal = false ); — Destroy task with id path, start control flag startCntr. Use noSignal for exclude signal SIGALRM send to the task.
• void taskSendSIGALRM( const string &path ); — Sending the termination signal "ALARM" to a task with id path.
• double taskUtilizTm( const string &path, bool max = false ); — Utilization of CPU time, in seconds, for task path or it's maximum max.
• static bool taskEndRun( ); — Check for the task endrun by signal SIGUSR1.
• static const STask& taskDescr( ); — Get reference to the task's descriptor.
• static int sysSleep( float tm ); — System sleep in seconds up to nanoseconds (1e-9).
• time_t sysTm( ); — System time fast access, from updated cell
• static int64_t curTime( ); — The actual time in microsecond from the beginning of the era (01.01.1970).
• string prjUserDir( ); — Directory of the user projects.
• bool prjCustMode( ); — Custom mode of projects.
• void setPrjCustMode( bool vl ); — Set for custom mode of projects.
• string prjNm( ); — Project name of the configuration.
• void setPrjNm( const string &vl ); — Set project name of the configuration.
• bool prjSwitch( const string &prj, bool toCreate = false ); — Switch to project prj.
• int prjLockUpdPer( ); — Get project lock updating period, zero for the lock disable.
• bool prjLock( const char *cmd ); — Project lock process for the command cmd ("hold", "free", "update").
• static void taskSleep( int64_t per, const string &cron = "", int64_t *lag = NULL ); — The function of the flow sleep by the grid of absolute time with the period per in the nanosecond or for the scheduled time cron. If set lag then to it will return different value from real and planed wake up time (lost cycles).
• static time_t cron( const string &vl, time_t base=0 ); — Planning the execution time on the format of the standard Cron vl beginning at the basic time base or at the current time if the base is not specified.
• static bool eventWait( bool &m_mess_r_stat, bool exempl, const string &loc, time_t time=0 ); — Function of the event waiting exempl for the variable m_mess_r_stat within a specified time interval time for the source loc.
• bool cntrEmpty( ); — Debug counters checking to empty.
• double cntrGet( const string &id ); — Debug counter id getting.
• void cntrSet( const string &id, double vl ); — Debug counter id setting to value vl.
• void cntrIter( const string &id, double vl ); — Debug counter id iteration to value vl.
• bool rdEnable( ); — Redundancy enabled, at least one redundancy station presented.
• bool rdActive( ); — Redundancy active, at least one active station presented.
• void rdStList( vector<string> &ls ); — List of ls stations into the redundancy.
• SStat rdSt( const string &id ); — Get copy of state structure of the redundancy station id.
• map<string, SStat> rdSts( ); — Get copy of list of state structures of redundancy stations.
• int rdStLevel( ); — Current station level into the redundancy system.
• void setRdStLevel( int vl ); — Set current station level into the redundancy system.
• float rdTaskPer( ); — Period of execution of the redundancy processing task.
• void setRdTaskPer( float vl ); — Set period of execution of the redundancy processing task.
• int rdRestConnTm( ); — Time of the retry attempts to reconnect to the backup station after its loss in seconds.
• void setRdRestConnTm( int vl ); — Set time of the retry attempts to reconnect to the backup station after its loss in seconds.
• string rdStRequest( XMLNode &req, const string &st = "" ); — Common request req to pointed redundancy station st.
• static string int2str( int val, IntView view=Dec ); — Transformation of a signed integer to the string of the type of view view.
• static string uint2str( unsigned val, IntView view=Dec ); — Transformation of unsigned integer to the string type of view view.
• static string ll2str( long long val, IntView view=Dec ); — Transformation of a long integer (64bit) to the string type of view view.
• static string real2str( double val, int prec=15, char tp='g'); — Real transformation with an accuracy prec signs and type tp to the string.
• static double realRound( double val, int dig=0, bool toint=false ); — Rounding the real number to the specified digit dig after the decimal point with the possibility of transformation to integer after rounding toint.
• static string atime2str( time_t tm, const string &format = "", bool gmt = false ); — Astronomic UNIX time tm conversion to a string, in the format of the POSIX-function "strftime()" or "gmtime()", for gmt.
• static string time2str( double tm ); — Convert time interval, in seconds, to string like "1hour 23min 10sec".
• static string cpct2str( double cnt ); — Traffic counter cnt (bytes) convert to string like "12.5KiB".
• static double str2real( const string &val ); — String transformation to the real.
• static time_t str2atime( const string &val, const string &format = "", bool gmt = false ) — String time val conversion to an astronomic UNIX time, in the format of the POSIX-function "strptime()", and by the function "mktime()" or "timegm()", for gmt.
• static string addr2str( void *addr ); — Convert addresses into string.
• static void *str2addr( const string &str ); — Convert string into the address.
• static string strTrim( const string &val, const string &cfg = " \n\t\r" ); — Deletes from the original string val pointed into cfg (mostly empty) characters at the beginning and end of it.
• static string strSepParse( const string &path, int level, char sep, int *off=NULL ); — Parsing of the string path into the components separated by the dividing symbol sep, beginning with the offset off and controlling the offset of the element end in itself.
• static string strParse( const string &str, int level, const string &sep, int *off = NULL, bool mergeSepSymb = false ); — Parse function's "strSepParse()" expanded version which allow using multi-symbols separators and one symbols merging.
• static string strLine( const string &str, int level, int *off = NULL ); — Parsing text lines for different ways to the end of a line (CR, LF and CR/LF).
• static string pathLev( const string &path, int level, bool decode = true, int *off = NULL ); — Obtaining of the elements of the path with the ability of their decode, starting with the offset off and controlling the offset of the element end.
• static string pathLevEnd( const string &path, int level, bool decode = true, int *off = NULL ); — Obtaining of the elements of the path with the ability of their decode, starting with the offset off and controlling the offset of the element begin, in processing from the end.
• static string path2sepstr( const string &path, char sep = '.' ); — Transformation the path into string with the separator sep of the elements.
• static string sepstr2path( const string &str, char sep = '.' ); — Transformation of the string with the separator sep of the elements into the path.
• static string strEncode( const string &in, Code tp, const string &opt1 = "" ); — Encoding of the string by the specified rule tp and option opt1 (symbols by "Custom").
• static string strDecode( const string &in, Code tp = Custom, const string &opt1 = "" ); — Decoding of the string in by the specified rule tp and option opt1 (separator or "<text>" for "Bin").
• static string strMess( const char *fmt, ... ); — Formation of the string by the template fmt and arguments. It is implemented on the basis of "printf".
• static string strLabEnum( const string &base ); — Individual string labels from base forming by increment at end. Supported numbering into decimal, hexadecimal (prefix "0x") or octal (prefix "0") notation.
• string strCompr( const string &in, int lev=-1); — Compression of the string in with the compression level lev.
• string strUncompr( const string &in ); — Decompression of the string in.
• static inline uint16_t getUnalign16( const void *p ); static inline uint32_t getUnalign32( const void *p ); static inline uint64_t getUnalign64( const void *p ); — Unaligned read for unsigned
• static inline int getUnalignInt( const void *p ); — Unaligned read for integer from buffer by offset.
• static inline float getUnalignFloat( const void *p ); — Unaligned read by real "float" from buffer by offset.
• static inline double getUnalignDbl( const void *p ); — Unaligned read by real "double" from buffer by offset.
• static uint16_t i16_LE( uint16_t in ); static uint32_t i32_LE( uint32_t in ); static uint64_t i64_LE( uint64_t in ); — Byte order conversion for integer in from Little-Endian (LE) to internal represent.
• static uint16_t i16_BE( uint16_t in ); static uint32_t i32_BE( uint32_t in ); static uint64_t i64_BE( uint64_t in ); —Byte order conversion for integer in from Big-Endian (BE) to internal represent.
• static float floatLE( float in ); static double doubleLE( double in ); — Real number in conversion from internal to format IEEE754 Little-Endian (LE).
• static float floatLErev( float in ); static double doubleLErev( double in ); — Real number in conversion from format IEEE754 Little-Endian (LE) to internal.
• static float floatBE( float in ); static double doubleBE( double in ); — Real number in conversion from internal to format IEEE754 Big-Endian (BE).
• static float floatBErev( float in ); static double doubleBErev( double in ); — Real number in conversion from format IEEE754 Big-Endian (BE) to internal.
• string optDescr( ); — Full localized help on the options of the command line and parameters of the configuration file.
• string getCmdOpt( int &curPos, string *argVal = NULL ); static string getCmdOpt_( int &curPos, string *argVal, int argc, char **argv ); — Command line parameters parsing by cursor scanning curPos. Return argument name and it's possible value into argVal. Implement formats for short keys: "-v", "-v val", "-abcv", "-abcv val"; and long keys: "--var", "--var=val", "--var val".
• bool cmdOptPresent( const string &opt ); — Check the command-line option opt for presence.
• string cmdOpt( const string &opt, const string &setVl = "" ); — Get command-line option opt. Set it at setVl if pointing.
• int permCrtFiles( bool exec = false ); — get permission for files created OpenSCADA in form 0777 (RWXRWXRWX), where exec is not mask the bit 01.
• ResMtx *commonLock( const string &nm ); — creates and gets a lock for the name nm — for non multithread system functions, typically.
• static void ctrListFS( XMLNode *nd, const string &fsBase, const string &fileExt = "" ); — Browsing list for file system's items from base fsBase, for the files with extensions fileExt in list "png;jpeg;gif;".

Public attributes:

• AutoHD<TModule> mainThr; — Connection to a module executing in the main thread.

Short calls for global functions into "OSCADA" namespace:

• template <class fVal> fVal fmin( fVal a, fVal b ); template <class fVal> fVal fmax( fVal a, fVal b ); — functional templates for obtain of two values minimum and maximum.
• inline string i2s( int val, TSYS::IntView view = TSYS::Dec ) —> TSYS::int2str(val, view);
• inline string u2s( unsigned val, TSYS::IntView view = TSYS::Dec ) —> TSYS::uint2str(val, view);
• inline string ll2s( long long val, TSYS::IntView view = TSYS::Dec ) —> TSYS::ll2str(val, view);
• inline string r2s( double val, int prec = 15, char tp = 'g' ) —> TSYS::real2str(val, prec, tp);
• inline double rRnd( double val, int dig = 0, bool toint = false ) —> TSYS::realRound(val, dig, toint);
• inline string atm2s( time_t tm, const string &format = "", bool gmt = false ) —> TSYS::atime2str(tm, format, gmt);
• inline string tm2s( double tm ) —> TSYS::time2str(tm);
• inline int s2i( const string &val ) —> atoi(val.c_str());
• inline long long s2ll( const string &val ) —> atoll(val.c_str());
• inline double s2r( const string &val ) — TSYS::str2real(val);
• inline string sTrm( const string &val, const string &cfg = " \n\t\r") —> TSYS::strTrim(val, cfg);

2.2 Object of the messages system (TMess)

Data:
Types (levels) of messages (enum — TMess::Type):

• Debug (0) — debug;
• Info (1) — information;
• Notice (2) — the notification;
• Warning (3) — warning;
• Error (4) — error;
• Crit (5) — critical situation;
• Alert (6) — alert;
• Emerg (7) — emergency.

Direction for the messages (enum — TMess::Direct):

• DIR_SYSLOG (0x1) — to SYSLOG;
• DIR_STDOUT (0x2) — to standard output;
• DIR_STDERR (0x4) — to standard errors output;
• DIR_ARCHIVE (0x8) — to messages archive.

The structure of the message (class — TMess:: SRec):

• time_t time; — time of the message;
• int utime; — microsecond of the message time;
• string categ; — category of messages (usually the way inside the system);
• int8_t level; — the level of the message;
• string mess; — message.

Templates:

• _( mess ) — Wrapper over the translation of the messages function for the provision of the accepted by the most of the programs translation of the messages.
• trL(base,lng); trU(base,usr); trLU(base,lng,usr) — Wrappers over the text variables dynamic translation functions by language and user.
• trSetL(base,lng,mess); trSetU(base,usr,mess); trSetLU(base,lng,usr,mess) — Wrapper over the text variables dynamic translation set functions by language and user.
• FTM(rec); FTM2(tm, utm) — Get a full time of the message, in microseconds, using the two fields of time of the message structure.
• mess_lev() — The system's messages level. Often used for debug mode check (=Debug).
• message( cat, lev, fmt, args ... ) — Formation of the the full message.
• mess_debug( cat, fmt, args ... ) — Formation of the debug message.
• mess_info( cat, fmt, args ... ) — Formation of the information message.
• mess_note( cat, fmt, args ... ) — Formations of the message - notification.
• mess_warning( cat, fmt, args ... ) — Formation of the warning message.
• mess_err( cat, fmt, args ... ) — Formation of the error message.
• mess_crit( cat, fmt, args ... ) — Formation of the critical condition message.
• mess_alert( cat, fmt, args ... ) — Formation of the alarm message.
• mess_emerg( cat, fmt, args ... ) — Formation of the emergency message.
• message_( cat, lev, fmt, args ... ) — Formation of the the full message (selected level and debug categories are ignored).
• mess_debug_( cat, fmt, args ... ) — Formation of the debug message (selected level and debug categories are ignored).
• mess_info_( cat, fmt, args ... ) — Formation of the information message (selected level is ignored).
• mess_note_( cat, fmt, args ... ) — Formations of the message - notification (selected level is ignored).
• mess_warning_( cat, fmt, args ... ) — Formation of the warning message (selected level is ignored).
• mess_err_( cat, fmt, args ... ) — Formation of the error message (selected level is ignored).
• mess_crit_( cat, fmt, args ... ) — Formation of the critical condition message (selected level is ignored).
• mess_alert_( cat, fmt, args ... ) — Formation of the alarm message (selected level is ignored).
• mess_emerg_( cat, fmt, args ... ) — Formation of the emergency message (selected level is ignored).

Public methods:

• void load( ); — Download.
• void save( ); — Saving.
• string codeConv( const string &fromCH, const string &toCH, const string &mess); — Conversion of the codepage of the messages.
• string codeConvIn( const string &fromCH, const string &mess); — Conversion the codepage of the messages into the internal system codepage.
• string codeConvOut ( const string &toCH, const string &mess); — Conversion of the message from the internal system codepage.
• const char *I18N( const char *mess, const char *d_name = NULL, const char *mLang = NULL ); — Getting the message mess/ in the language mLang// or system one at its NULL or empty or not dynamic messages translation mode.
• string I18Ns( const string &mess, const char *d_name = NULL, const char *mLang = NULL ); — Getting the message mess/ in the language mLang// or system one at its NULL or empty or not dynamic messages translation mode.
• string lang( ); — Language of the system, as en_US.UTF-8.
• string lang2Code( ); — Language of the system in bi-symbolic codepage (en).
• string &charset( ); — The system codepage.
• int logDirect( ); — Receivers to whom the system messages (stdout, stderr, syslog, archive) are sent;
• int messLevel( ); — The level below which the messages are ignored.
• string selDebCats( ); — Selected debug categories (by separated ';' list).
• bool isUTF8( ); — Internal codepage is UTF-8.
• void setLang( const string &lang, bool init = false ); — Setting of the system language (localization).
• void setLogDirect( int dir ); — Setting receivers to which the system messages are sent. For dir the bit mask is used. Where:

1 — to syslog;

2 — to stdout;

4 — to stderr;

8 — to the archive.

• void setMessLevel( int level ); — Setting a minimum level of processed messages.
• void setSelDebCats( const string &vl ); — Debug categories set (by separated ';' list).
• void put( const char *categ, int8_t level, const char *fmt, ... ); — The message forming for the current time with the category categ, the level, the formatted message fmt and the followed arguments.
• void put_( const char *categ, int8_t level, const char *fmt, ... ); void putArg( const char *categ, int8_t level, const char *fmt, va_list ap ); — The message forming for the current time (selected level and debug categories are ignored) with the category categ, the level, the formatted message fmt and the followed arguments.
• void get( time_t b_tm, time_t e_tm, vector<TMess::SRec> &recs, const string &category = "", int8_t level = Debug ); — Get the message from the archive for the period of time b_tm — e_tm under the category template category and minimum level level.
• string lang2CodeBase( ); — The language of basic variables of the text messages in bi-symbolic codepage(en).
• bool translCfg( ); — The configuration translation sign, combined as "lang2CodeBase().size() && lang2Code() != lang2CodeBase()".
• bool translDyn( bool plan = false ); — Mode "Dynamic translation" or the plan to next start.
• bool translEnMan( ); — The sign "Enabled translations manager", for activation of the built translation messages index and the translation manager.
• string translLangs( ); — List of translation languages, into the manager.
• string translFld( const string &lng, const string &fld, bool isCfg = false ); — Representing the translated field name by the field name fld and language lng for configuration isCfg or DB.
• void setLang2CodeBase( const string &vl ); — Setting the language of the basic message of text variables in the bi-symbolic codepage (en).
• void setTranslDyn( bool val, bool plan = true ); — Setting the mode "Dynamic translation" or the plan to value val for next start.
• void setTranslEnMan( bool vl, bool passive = false ); — Setting "Enabled translation manager" to value vl and passive mode passive.
• void setTranslLangs( const string &vl ); — Setting a list of translation languages.
• string translGet( const string &base, const string &lang, const string &src = "" ); string translGetU( const string &base, const string &user, const string &src = "" ); string translGetLU( const string &base, const string &lang, const string &user, const string &src = "" ); — Getting translation for base text variable for language lang or user and optional source src.
• string translSet( const string &base, const string &lang, const string &mess, bool *needReload = NULL ); string translSetU( const string &base, const string &user, const string &mess, bool *needReload = NULL ); string translSetLU( const string &base, const string &lang, const string &user, const string &mess, bool *needReload = NULL ); — Setting translation for base text variable for language lang or user and optional source src to value mess.
• void translReg( const string &mess, const string &src, const string &prms = "" ); — Registering the translated message mess with source src and appended parameters prms into the translations index.
• static const char *labDB( ); static const char *labSecCRON( ); static const char *labSecCRONsel( ); static const char *labTaskPrior( ); — Common help labels.
• int getUTF8( const string &str, int off = 0, int32_t *symb = NULL ); — Get and parse a UTF-8 symbol.
• static string setUTF8( int32_t symb ); — Set, form and return a UTF-8 symbol from their code symb.

2.3 Object subsystem (TSubSYS)

Public methods:

• TSubSYS( const char *id, const char *name, bool mod = false ); — Initialize the constructor. Sign mod indicates that subsystem is module one.
• string subId( ); — ID of the subsystem.
• string subName( ); — Localized name of the subsystem.
• bool subStartStat( ); — Sign of the subsystem execution.
• bool subModule( ) const; — Sign of the modularity of the subsystem.
• virtual int subVer( ); — Version of the subsystems.
• virtual void subStart( ); — Start of the the subsystem.
• virtual void subStop( ); — Stop of the subsystem.
• void modList( vector <string> &list ); — List list of the modules of the modular subsystem.
• bool modPresent( const string &name ); — Check for the availability of the module name.
• void modAdd( TModule *modul ); — Add/registration of the module modul.
• void modDel( const string &name ); — Deleting of the module name.
• AutoHD <TModule> modAt( const string &name ) const; — Connection to the module name.
• virtual void perSYSCall( unsigned int cnt ); — Periodic call from system thread, with period 10 seconds and seconds counter cnt.
• virtual bool rdProcess( XMLNode *reqSt = NULL ); — Processing of redundancy of the subsystem, calls from the system's task of redundancy. reqSt pass a result of a state request to the redundancy station for this subsystem.
• virtual string optDescr( ); — Localized help on the options of the command line and parameters of the configuration file for the whole subsystem, includes its modules.
• TSYS &owner( ) const; — The system - the owner of the subsystem.

2.4 Object Module (TModule)

Data:
The data structure which identifies the module (class — TModule::SAt):

• SAt( const string &iid, const string &itype = "", int itver = 0 ); — initialize the constructor;
• bool operator ==(const TModule::SAt &amst ) const; — comparison function identifiers modules;
• string id; — the identifier of the module;
• string type; — the type of module (subsystem);
• int tVer; — version of the type of module (subsystem) to which the module is designed.

The structure of exported functions (class — TModule::ExpFunc):

• string prot; — a prototype of the function;
• string dscr; — localized description of the function;
• void (TModule::*ptr) (); — relative address of the function (with respect to the object module).

Public methods:

• TModule( const string &id ); — Initialize the constructor of module id.
• string modId( ); — ID of the module.
• string modName( ); — Localized name of the module.
• virtual void modStart( ); — Start of the module.
• virtual void modStop( ); — Stop of the module.
• virtual void modInfo( vector<string> &list ); — A list of information items list of the module.
• virtual string modInfo (const string &name ); — Getting the contents of the specified information item name. For get the item on different language, at [../ProgrammManual#h932-1 dynamic messages translation], you can set the name in way "{Name}:{lang}".
• virtual void perSYSCall( unsigned int cnt ); — Periodic call from system thread, with period 10 seconds and seconds counter cnt.
• void modFuncList( vector<string> &list ); — The list of exported functions list of the module.
• bool modFuncPresent( const string &prot ); — Check the availability of the specified function by its prototype prot.
• ExpFunc &modFunc (const string & prot); — Get the information about exported function of the module prot.
• bool modFunc( const string &prot, void (TModule::**offptr)(), bool noex = false ); — Getting the relative address offptr of the exported function prot. Returns "true" for successful and the non-exceptional mode noex.
• const char *I18N( const char *mess ); — Localization of modular message mess in accordance with the current locale.
• virtual string optDescr( ); — Localized help on the options of the command line and parameters of the configuration file for the module.
• TSubSYS &owner( ) const; — Subsystem - the owner of the module.

Protected Attributes:

• string mModName; — Name of the module.
• string mModDescr; — Description of the module.
• string mModType; — Type of module.
• string mModVers; — Version of the module.
• string mModAutor; — Author of the module.
• string mModLicense; — License of the module.
• string mModSource; — Source/origin of the module.

Protected methods are:

• void modInfoMainSet( const string &name, const string &type, const string &vers, const string &author, const string &descr, const string &license, const string &source ); — Main module information set.
• void modFuncReg (ExpFunc * func); — Registration of the exported by module functions.

3 Subsystem "Database" (TBDS)

Subsystem "Databases" is represented by the object TBDS, which contains a modular objects of the following types of DB TTypeBD. Each type of database contains objects of individual databases of that type TBD. Each database in its turn, contains the objects of their tables TTable (Fig. 3).

Fig. 3. Hierarchical structure of the subsystem "DB".

The subsystem provides the basic functions to access the type of database, as well as generalized functions for the manipulation of the databases and tables. For example, to hide the source of data, which may be a configuration file, the functions of an abstract access to the data source are provided. For the storage system-wide data the system table and the function of the abstract to access it are provided. Consequently, system-wide data can be stored in the configuration file and in the database table. Priority source, in this case, is the database table.

Being a modular object, the type of database (TTypeBD) provides access to the implementation of the mechanism of one or another database. Access is made through a public databases of the module of a given type of database. Open/registered database is described in the table of databases to be opened or in the configuration file. There is, the so-called, the working database, which is always opens and is shown in the configuration file. DB which support the SQL-queries can grant access based on direct SQL-queries.

While working, the components of OpenSCADA open tables (TTable) available in the database and work with them.

3.1 Object of subsystem "Database" (TBDS)

Data:
Flags of the queries to the system table (enum – TDBS::ReqGen):

• OnlyCfg — request only to the configuration file.
• UseTranslate — use the translation of text variable.

Public methods:

• int subVer( ); — Subsystem version.
• static string realDBName( const string &bdn ); — Conversion of the full template name of the database or table (of view *.*.myTbl) in the real name. Actually the replacement of the special elements '*' by the elements of the working DB.
• void dbList( vector<string> &ls, bool checkSel = false ); — A list of available databases.. checkSel points to the necessity to verify the fact of boot from the selected database and to insert to the db list the only selected one.
• int tblLifeTime( ); — Lifetime of the inactive tables closing, in seconds.
• void setTblLifeTime( int vl ); — Sets lifetime of the inactive tables closing in vl seconds.
• AutoHD<TTable> open( const string &bdn, bool create = false ); — Opening the table bdn of the DB by its full path with the creation create in the case of its absence.
• void close( const string &bdn, bool del = false ); — Closing the table bdn of the DB by its full path with the possibility of deleting of it after closing del.
• bool dataSeek( const string &bdn, const string &path, int lev, TConfig &cfg, bool forceCfg = false, bool useCache = false, XMLNode *localCfgCtx = NULL ); — Total scanning of the records of the data source. The configuration file or the DB is the source of the data. In the case of DB absence the configuration file is used. If the DB name bdn or path path to the configuration file are not indicated, their processing is skipped. useCache defines the seek cache using — preloading the result in whole and significant acceleration, as the unique cacheKey this function uses the cfg address. localCfgCtx uses for loading from the local configuration context, prepared in dataSet(), and it missing causes for checking and using, at presence, the global configuration context SYS->cfgCtx().
• bool dataGet( const string &bdn, const string &path, TConfig &cfg, bool forceCfg = false, bool noEx = false, XMLNode *localCfgCtx = NULL ); — Getting the record from the data source (database or configuration file). If the DB name bdn or path path to the configuration file are not indicated, their processing is skipped. localCfgCtx uses for loading from the local configuration context, prepared in dataSet(), and it missing causes for checking and using, at presence, the global configuration context SYS->cfgCtx().
• void dataSet( const string &bdn, const string &path, TConfig &cfg, bool forceCfg = false, bool noEx = false, XMLNode *localCfgCtx = NULL ); — Set/Save the record in the data source (database or configuration file). If the DB name bdn or path path to the configuration file are not indicated, their processing is skipped. localCfgCtx uses for saving to the local configuration context, prepares for dataSeek() and dataGet(), and it missing causes for checking and using, at presence, the global configuration context SYS->cfgCtx().
• bool dataDel( const string &bdn, const string &path, TConfig &cfg, bool useKeyAll = false, bool forceCfg = false, bool noEx = false ); — Deleting the record in the data source (database or configuration file). If the DB name bdn or path path to the configuration file are not indicated, their processing is skipped. useKeyAll is used to indicate the necessity of the all keys set fro their using while deleting with the restoration of the original state of the keys selection when the function is finished. If this flag is not set, the early selected keys are used to perform the operation.
• static string genDBGet( const string &path, const string &oval = "", const string &user = "root", char rFlg = 0 ); — Get system-wide data from the configuration file or system tables on behalf of user name user. If data are not available the value oval is returned.
• static void genDBSet( const string &path, const string &val, const string &user = "root", char rFlg = 0 ); — Set/Save the system-wide data in the configuration file or system tables on behalf of user name user.
• string fullDBSYS( ); — The full name of the system table.
• string fullDB( ); — The full name of the table with a description of the registered databases.
• TElem &openDB_E( ) — The structure of the table of registered databases.
• AutoHD<TTypeBD> at( const string &iid ) — Referencing to the DB module(DB type).

3.2 Modular object of types of databases (TTypeBD)

Public methods:

• bool fullDeleteDB( ); — Sign of the complete removal of the database.
• void list( vector<string> &list ) const; — The list of registered (opened) databases.
• bool openStat( const string &idb ) const; — Check the availability of the specified opened database.
• string open( const string &id ); — Opening of the database. Returns the end created identifier.
• void close( const string &id, bool erase = false ); — Closing the database. If the sign erase is set, the database will be completely removed.
• AutoHD<TBD> at( const string &id ) const; — Connection to the opened database.
• TBDS &owner( ) const; — Subsystem - the owner of the module.

3.3 The object of the database (TBD)

Public methods:

• TBD( const string &iid, TElem *cf_el ); — Initializing constructor.
• string id( ); — DB identifier.
• string fullDBName( ); — Full name a storage-DB.
• string name( ); — DB name.
• string dscr( ); — DB description.
• string addr( ) const; — Address of the database. The form of recording is different for each type of database.
• string codePage( ); — Codepage in which the data of the database are stored.
• double trTm_ClsOnOpen( ); — Transaction closing: after opening, seconds.
• double trTm_ClsOnReq( ); — Transaction closing: after request, seconds.
• int trPr_ClsTask( ); — Transaction closing: separate task priority.
• bool enableStat( ) const; — The state of the database: "Enabled".
• bool toEnable( ); — Sign of the DB: "To Enable".
• bool disabledByUser( ); — Sign of the node disabling by user, to prevent its enabling restore.
• void setName( const string &inm ); — Setting the DB name.
• void setDscr( const string &idscr ); — Setting the DB description.
• void setAddr( const string &iaddr ); — Setting the DB address.
• void setCodePage( const string &icp ); — Setting of the codepage for the storage of the DB data.
• void setToEnable( bool ivl ); — Setting of the sign: "To Enable".
• virtual void enable( ); — Enabling of the DB.
• virtual void disable( ); — Disabling of the DB.
• virtual void allowList( vector<string> &list ) const; — The list of the tables in this DB.
• void list( vector<string> &list ) const; — The list of opened tables.
• bool openStat( const string &table ) const; — The sign that indicates of the fact that the requested table is opened.
• virtual void open( const string &table, bool create ); — Opening of the table. If the sign create is set, in the case of absence the table will be created.
• virtual void close( const string &table, bool del = false, long tm = -1 ); — Closing of the table. If the sign del is set, the table will be completely removed.
• AutoHD<TTable> at( const string &name ) const; — Connection to the table.
• virtual void sqlReq( const string &req, vector< vector<string> > *tbl = NULL, char intoTrans = EVAL_BOOL ); — Sending the SQL-request req to the DB and receiving the result in tabular form tbl. If set intoTrans to true then will open transaction for the request, else if set to false then transaction will close.
• virtual void transCloseCheck( ) — The function call periodic for opened transaction check to close for old transaction or overloaded.
• TTypeBD &owner( ) const; — DB type – the owner of the DB.

Protected methods:

• virtual TTable *openTable( const string &table, bool create ); — The modular method for opening the table.

3.4 The object of the table (TTable)

Public methods:

• TTable( const string &name ); — Initializing constructor.
• string name( ); — Table name.
• string fullDBName( ); — Full name a storage-table into DB.
• virtual void fieldStruct( TConfig &cfg ); — Getting the structure of the table.
• virtual bool fieldSeek( int row, TConfig &cfg, const string &cacheKey = "" ); — Scanning the records cfg of the table by row, where cacheKey defines the seek cache using — preloading the result in whole and significant acceleration.
• virtual void fieldGet( TConfig &cfg ); — Request the specified record. The requested record is determined by the values of key cells of the original record cfg.
• virtual void fieldSet( TConfig &cfg ); — Setting the values of the specified record. In the case of absence the record will be removed.
• virtual void fieldDel( TConfig &cfg ); — Deleting of the specified record.
• TBD &owner( ) const; — DB – the owner of the table.

4 The subsystem "Data acquisition" (TDAQS)

The subsystem "Data acquisition" is represented by the TDAQS object which contains modular objects of the data sources' types TTypeDAQ and the objects of the libraries of parameters' templates of subsystem "Data acquisition" TPrmTmplLib. Object of the data sources types contains objects of the controllers TController and objects of the parameters' types TTypeParam. Parameters' types objects are provided by the controller module and contain the DB structure of the separate parameters' types (analog, digital ...). Controllers' objects contain parameters' objects TParamContr. Each parameter is associated with only one type of the parameter. For the attribute storage parameter is inherited from the values object TValue, which contains the attributes' values TVal. The library of the parameters' templates of this subsystem contains templates' objects TPrmTmpl. An example of the described hierarchical structure is shown in Fig. 4.

Fig. 4. Hierarchical structure of the subsystem "Data acquisition".

Subsystem contains the types of data sources. The source may be virtually any substance providing any data. Type of source can be divided into individual sources (controllers) within the limits of the particular type. For example, if we take the data from the operating system (OS), then the single source can be the separate operating system of the separate PC.

Data source (controller) is further divided (contains) into the parameters. The parameter is the part of the data source. In the case of the OS it will be, for example,: used RAM, the processor's frequency and many other parts.

Parameter, in its turn, contains the attributes, which provide the data. In addition to the basic data attributes can provide the related or detailing data. In the case of the same operating system and the memory usage, the attributes may not only provide the used memory, and also how much it all, how much in the swap, etc.

Some of the implementation of the data sources may provide the possibility of setting the structure of the parameter based on previously developed parameters' templates. For this purpose subsystem contains templates' libraries, which, in their turn, provide the parameters' templates . The example shows a library of templates "base" with the templates "digAlrm" and "smplBrd".

At the level of the subsystem the redundancy mechanism for data sources is provided. Redundancy means the possibility of coordinated work of several OpenSCADA stations to perform common task of data acquisition from the same data sources.

4.1 Object of subsystem "Data acquisition" (TDAQS)

Public methods:

• int subVer( ); — Version of the subsystem.
• void subStart( ); — Start the subsystem.
• void subStop( ); — Stop the subsystem.
• AutoHD<TTypeDAQ> at( const string &name ) const; — Connection to the type of data source.
• AutoHD<TValue> prmAt( const string &path, char sep = 0, bool noex = false ) const; — Connection to the parameter by path or separated by sep string. Do not throw an exceptions if set noex.
• AutoHD<TVal> attrAt( const string &path, char sep = 0, bool noex = false ) const; — Connection to the parameter's attribute by path or separated by sep string. Do not throw an exceptions if set noex.
• void ctrListPrmAttr( XMLNode *nd, const string &addrBase, bool toPrm = false, char sep = 0, const string &pref = "" ); — Browsing list for items of attributes of parameters or only the parameters DAQ by toPrm with prefix pref from path or separated by sep string from base address addrBase.
• string tmplLibTable( ); — Name of table to store the parameters' templates of the subsystem "Data acquisition".
• void tmplLibList( vector<string> &list ) const; — The list of available parameters' templates.
• bool tmplLibPresent( const string &id ) const; — Check the availability of the parameter's template id.
• void tmplLibReg( TPrmTmplLib *lib ); — Registration of the parameter's template lib.
• void tmplLibUnreg( const string &id, int flg = 0 ); — Deleting/removing of the registration of the parameter's template id.
• AutoHD<TPrmTmplLib> tmplLibAt( const string &id ) const; — Connection to the parameter's template id.
• double rdRestDtTm( ); — Maximum depth of the archive data recovery when starting in hours.
• void setRdRestDtTm( double vl ); — Set of the maximum depth of the archive data recovery when starting in hours.
• void rdActCntrList( vector<string> &ls, bool isRun = false ); — The list of active controllers working in the redundancy scheme. When we indicate isRun there will be in the list only running controllers in this station.
• string rdStRequest( const string &cntr, XMLNode &req, const string &prevSt = "", bool toRun = true ); — Request req to the redundant station on behalf of the controller cntr. The station for the request is selected after specified in prevSt for the running remote controller when indicating toRun.
• TElem &elLib( ); — The structure of the table of the libraries if parameters' templates.
• TElem &elTmpl( ); — The structure of the table of parameters' templates.
• TElem &elTmplIO( ); — The structure of the attributes of parameters' templates.
• TElem &elErr( ); — The structure of the attribute(s) of parameters' errors.

4.2 Modular object of the controller's type (TTypeDAQ)

Public methods:

• string DAQPath( ); — Getting for DAQ-address of the element.
• void modStart( ); — Start of the module.
• void modStop( ); — Stop of the module.
• void list( vector<string> &list ) const; — The list of the controllers.
• bool present( const string &id ) const; — Check for the availability of the specified controller object.
• string add( const string &id, const string &daq_db = "*.*" ); — Add the controller object. Returns the end created identifier.
• void del( const string &id ); — Delete the controller object.
• AutoHD<TController> at( const string &id, const string &who = "" ) const; — Connect to the controller object.
• bool tpPrmPresent( const string &name_t ); — Check for the availability of the specified controller type.
• unsigned tpPrmToId( const string &name_t ); — Getting of the index of the parameters' types by their names.
• int tpParmAdd( const char *id, const char *n_db, const char *name ); — Addition/registration of the parameters' types.
• unsigned tpPrmSize( ); — Quantity of the parameters' types.
• TTypeParam &tpPrmAt( unsigned id ); — Get the object of the parameters' type.
• virtual bool compileFuncLangs( vector<string> *ls = NULL ); — Request of the list of languages for which it is realized the possibility of formation of user procedures in this module, and check for it support fact.
• virtual void compileFuncSynthHighl( const string &lang, XMLNode &shgl ); — The rules of syntax highlight request for specifying language.
• virtual string compileFunc( const string &lang, TFunction &fnc_cfg, const string &prog_text, const string &usings = "", int maxCalcTm = 0 ); — Compiling/setup of the user function on the supported programming language lang and on the source code of procedure prog_text, based on the parameters of procedure fnc_cfg. The result is the address to the prepared function object.
• virtual bool redntAllow( ); — The indication of support of redundancy mechanisms by the module. It must be simply overridden and return true.

Protected methods:

• virtual TController *ContrAttach( const string &name, const string &daq_db ); — Connecting of the controller. It must be obligatory overridden in the descendant of the module.

4.3 Controller's object (TController)

Data:
Redundancy modes (enum TController::Redundant):

• Off (0) — Turned off;
• Asymmetric (1) — asymmetric;
• OnlyAlarms (2) — only alarms, suppressing on the reserve.

Command specific

• Any (0) — any mode.

Public methods:

• TController( const string &name_c, const string &daq_db, TElem *cfgelem ); — Initializing constructor of the controller.
• string DAQPath( ); — Getting for DAQ-address of the element.
• string id( ); — Controller ID.
• string workId( ); — Work ID of the controller, including the ID of the module.
• string name( ); — Controller's name.
• string descr( ); — Controller's description.
• virtual string getStatus( ); — Request function of the controller's status.
• string DB( ); — DB name of the controller's instance.
• string tbl( ); — The name of the table of DB of the controller's instance.
• string fullDB( ); — The full name of the table of DB of the controller's instance.
• void setName( const string &nm ); — Set the controller's name.
• void setDescr( const string &dscr ); — Set the controller's description.
• void setDB( const string &idb ); — Setting of the DB name of the controller's instance.
• bool toEnable( ); — Sign "To enable the controller".
• bool toStart( ); — Sign "To start the controller".
• bool enableStat( ) const; — Status "Enable".
• bool startStat( ); — Status "Run".
• int messLev( ); — Messages level of diagnostic information.
• void start( ); — Controller's start.
• void stop( ); — Controller's stop.
• void enable( ); — Controller's enabling.
• void disable( ); — Controller's stopping.
• void list( vector<string> &list ) const; — Parameter's list in the controller.
• bool present( const string &id ) const; — Check for the availability of the parameter id.
• string add( const string &id, unsigned type ); — Addition of the parameter id of the type type. Returns the end created identifier.
• void del( const string &id, bool full = false ); — Deleting of the parameter id. If the field full is specified the controller will be completely removed.
• AutoHD<TParamContr> at( const string &id, const string &who = "th_contr" ) const; — Connection to the controller's parameter id.
• bool redntUse( Redundant md = Asymmetric ); — Redundancy state for mode md.
• void setRedntUse( bool vl ); — Changing of the getting the data from the backup station mode.
• Redundant redntMode( ); — Redundancy mode ("<high>", "<low>", "<optimal>", {ForceStation}), enabling.
• void setRedntMode( Redundant vl ); — Setting of the redundancy mode, enabling.
• string redntRun( ); — Configuration of the preferred execution.
• void setRedntRun( const string &vl ); — Setting the configuration of the preferred execution.
• virtual void redntDataUpdate( ); — An operation of the data receiving from the backup station execution. It is called automatically by the service procedure of the redundancy scheme of the subsystem.
• virtual string catsPat( ); — regular expression rules separated '|' list for the object's generated messages math by category.
• void alarmSet( const string &mess, int lev = -TMess::Crit, const string &prm = "", bool force = false ); — Formation of an alarms (a violation) for the parameter object prm ({PrmId}\n{PrmNm}), or the controller object in whole if the object is not specified, the message mess and level lev. The negative value of the level lev is used to set and positive for removal of the violation. This function generates the violation and message with a category al{ModId}:{CntrId}[.{prm}] and the text {CntrNm} > {PrmNm}: {MessText}. The alarms clearance, as the setting also, works in the toggling mode, so means of passing the clearance messages to the message buffer, and the same clearance, only at the according violations presence, what may be disabled setting force.
• TTypeDAQ &owner( ) const; — The type of the data source (module) - the owner of the controller.

Protected attributes:

• bool enSt; — The sign "Enable".
• bool runSt; — The sign "Running".

Protected methods:

• virtual void enable_( ); — Enabling of the controller. Intercepted by the child.
• virtual void disable_( ); — Disabling of the controller. Intercepted by the child.
• virtual void start_( ); — Starting of the controller. Intercepted by the child.
• virtual void stop_( ); — Stopping of the controller. Intercepted by the child.
• virtual TParamContr *ParamAttach( const string &name, int type ); — Modular method of the creation/opening of the new parameter.

4.4 Parameters' type object (TTypeParam)

Public methods:

• TTypeParam( const char *iid, const char *iname, const char *idb = "", bool i_isPrmCntr = false ); — Initializing constructor.
• virtual void create( TParamContr *prm ); — Create or set the parameter prm type.
• virtual void destroy( TParamContr *prm ); — Remove or clean the parameter prm type.
• virtual string DB( TController *cntr ); — Get table name of the parameters of the controller cntr.
• void setDB( TController *cntr, const string &vl ); — Set the table name of the parameters of the controller cntr.
• virtual void enable( TParamContr *prm ); — To enable the parameter prm.
• virtual void disable( TParamContr *prm ); — To disable the parameter prm.
• virtual bool cfgChange( TParamContr *prm, TCfg &cfg ); — The configuration filed cfg of the parameter prm change.
• virtual void vlGet( TParamContr *prm, TVal &vo ); — Predicting function of the value getting, through the parameter prm. It is used for direct (synchronous) reading.
• virtual void vlSet( TParamContr *prm, TVal &vo, const TVariant &vl, const TVariant &pvl ); — Predicting function of the value setting, through the parameter prm. It is used for direct (synchronous) writing vl with the previous value into pvl.
• bool vlSetRednt( TVal &vo, const TVariant &vl, const TVariant &pvl ); — Processing of the values setting, mostly in the predicting function, under the redundancy. Returns true at processing the setting in the redundancy.
• virtual void vlArchMake( TParamContr *prm, TVal &val ); — Notifying function of the creation of the archive for the val attribute, through parameter prm. It is used to configure the created archive in accordance with the peculiarities of the data source.
• virtual void getVals( TParamContr *prm ); — Asynchronous mode internal realization, called into the controller object cycle for parameter prm.
• virtual bool cntrCmdProc( TParamContr *prm, XMLNode *opt ); — Function of requests' processing of the control interface, from parameter prm.

Public attributes:

• string name; — Parameter's type name.
• string descr; — Parameter's type description.
• string db; — DB of the parameter's type.

4.5 Object of the physical level parameter (TParamContr)

Public methods:

• TParamContr( const string &name, TTypeParam *tpprm ); — Initializing constructor.
• string DAQPath( ); — Getting for DAQ-address of the element.
• string ownerPath( bool inclSelf = false ); — The parameter-owner path, include inclSelf the parameter.
• bool operator==( TParamContr & PrmCntr ); — Parameter's comparison.
• string id( ); — Parameter's ID (key).
• string name( ); — Parameter's name.
• string descr( ); — Parameter's description.
• bool toEnable( ); — Sign "To enable parameter".
• bool enableStat( ) const; — Status "Enable".
• void setName( const string &inm ); — Setting of the parameter's name.
• void setDescr( const string &idsc ); — Setting of the parameter's description.
• void setToEnable( bool vl ); — Setting of the sign "To enable the parameter".
• void list( vector<string> &list ) const; — Parameter's list in the parameter.
• bool present( const string &id ) const; — Check for the availability of the parameter id.
• string add( const string &id, unsigned type = 0 ); — Addition of the parameter id of the type type. Returns the end created identifier.
• void del( const string &id, bool full = false ); — Deleting of the parameter id. If the field full is specified the controller will be completely removed.
• AutoHD<TParamContr> at( const string &id, const string &who = "th_prm" ) const; — Connection to the controller's parameter id.
• TTypeParam &type( ) const; — Parameter's type.
• virtual TElem *dynElCntr( ); — Container of the dynamic elements of the DAQ attributes.
• virtual void enable( ); — To enable parameter.
• virtual void disable( ); — To disable parameter.
• TController &owner( ) const; — Controller – the parameter's owner.

Protected methods:

• virtual void setType( const string &tpId ); — is called to change the parameter type tpId and can be processed in the object module for self data change.

4.6 Object of the value (TValue)

Public methods:

• bool dataActive( ); — Activity (updatable) flag of data.
• virtual string DAQPath( ); — Getting for DAQ-address of the element.
• void vlList( vector<string> &list ) const; — Getting the attributes' list.
• bool vlPresent( const string &name ) const; — Check for the availability of the specified attribute.
• AutoHD<TVal> vlAt( const string &name ) const; — Connection to the attribute.

Protected methods:

• TConfig *vlCfg( ) — Getting of the associated configuration object. If NULL is returned then there is no associated configuration object.
• void setVlCfg( TConfig *cfg ); — Setting of the associated configuration object cfg.
• bool vlElemPresent( TElem *ValEl ); — Check for the availability if the attributes' elements ValEl.
• void vlElemAtt( TElem *ValEl ); — Attach of the data structure ValEl.
• void vlElemDet( TElem *ValEl ); — Detach of the data structure ValEl.
• TElem &vlElem( const string &name ); — Get the data structure by its name name.
• virtual TVal* vlNew( ); — Creation of the TVal instance. It can be overridden in the module for the creation of derived objects of the parameters' attributes of the subsystem "Data acquisition".
• virtual void vlGet( TVal &vo ); — Predicting function of the value getting. It is used for direct (synchronous) reading.
• virtual void vlSet( TVal &vo, const TVariant &vl, const TVariant &pvl ); — Predicting function of the value setting. It is used for direct (synchronous) writing vl with the previous value into pvl.
• virtual void vlArchMake( TVal &val ); — Notifying function of the creation of the archive for the val attribute. It is used to configure the created archive in accordance with the peculiarities of the data source.

4.7 Attribute's object (TVal)

Data:
Additional flags to the object TFld (enum TVal::AttrFlag):

• TVal::DirRead(0x100) — Flag for the direct reading of the value;
• TVal::DirWrite(0x200) — Flag for the direct writing of the value;
• TVal::Dynamic(0x400) — Flag of the dynamic attribute, creates in typical from user procedures.

Public methods:

• TVal( ); — Default constructor.
• TVal( TFld &fld ); — Initialization as the repository of dynamic data.
• TVal( TCfg &cfg ); — Initialization as the reflection of static data (DB).
• string DAQPath( ); — Getting for DAQ-address of the element.
• void setFld( TFld &fld ); — Initialization as the repository of dynamic data.
• void setCfg( TCfg &cfg ); — Initialization as the reflection of static data (DB).
• string name( ); — Attribute's name.
• int64_t time( ); — Time marker of the the last/current value (10^-6s).
• bool isCfg( ); — Sign of the value object created in base of a configuration element.
• bool dataActive( ); — Activity (updatable) flag of data.
• string getSEL( long long *tm = NULL, bool sys = false ); — Request of the selected type value for the specified time tm. If NULL then it will be returned the last value.
• TVariant get( long long *tm = NULL, bool sys = false ); — Request of the value for the specified time tm. If NULL then it will be returned the last value.
• string getS( long long *tm = NULL, bool sys = false ); — Request of the string type value for the specified time tm. If NULL then it will be returned the last value.
• double getR( long long *tm = NULL, bool sys = false ); — Request of the real type value for the specified time tm. If NULL then it will be returned the last value.
• int64_t getI( long long *tm = NULL, bool sys = false ); — Request of the integer type value for the specified time tm. If NULL then it will be returned the last value.
• char getB( long long *tm = NULL, bool sys = false ); — Request of the boolean type value for the specified time tm. If NULL then it will be returned the last value.
• AutoHD<TVarObj> getO( int64_t *tm = NULL, bool sys = false ); — Request of the object type value.
• void setSEL( const string &value, long long tm = 0, bool sys = false ); — Setting of the selected type value value.
• void set( const TVariant &value, long long tm = 0, bool sys = false ); — Setting of the value value.
• void setS( const string &value, long long tm = 0, bool sys = false ); — Setting of the string type value value.
• void setR( double value, long long tm = 0, bool sys = false ); — Setting of the real type value value.
• void setI( int64_t value, long long tm = 0, bool sys = false ); — Setting of the integer type value value.
• void setB( char value, long long tm = 0, bool sys = false ); — Setting of the boolean type value value.
• void setO( AutoHD<TVarObj> value, int64_t tm = 0, bool sys = false ); — Setting of the object type value value.
• AutoHD<TVArchive> arch( ); — Getting the associated with the value archive.
• void setArch( const AutoHD<TVArchive> &vl ); — Setting the associated with the value archive.
• string setArch( const string &nm = "" ); — Setting/creation new archive with proposed name nm or automatic, if name empty.
• bool reqFlg( ); bool resB1( ); bool resB2( ) — Get some realisation-specific flags.
• void setReqFlg( bool vl ); void setResB1( bool vl ); void setResB2( bool vl ) — Set some realization-specific flags.
• TFld &fld( ); — Descriptor of the attribute's structure.

4.8 Object of the templates library of parameters of the "DAQ" subsystem (TPrmTmplLib)

Public methods:

• TPrmTmplLib( const char *id, const char *name, const string &lib_db ); — Initializing constructor.
• string id( ); — Library ID.
• string name( ); — Library name.
• string descr( ); — Library description.
• string DB( ); — DB of the library instance.
• string tbl( ); — DB table of the library instance.
• string fullDB( ); — Full address of the DB table of the library instance.
• bool startStat( ); — Sign "Library started".
• void start( bool val ); — Satart/stop of the library.
• void setName( const string &vl ); — Setting of the library name.
• void setDescr( const string &vl ); — Setting of the library description.
• void setFullDB( const string &vl ); — Setting of the full address of the DB table of the library instance.
• void list( vector<string> &ls ) const; — Templates list in the library.
• bool present( const string &id ) const; — Check for the presence of the template id in the library.
• AutoHD<TPrmTempl> at( const string &id ) const; — Connection to the template id.
• void add( const char *id, const char *name = "" ); — Addition of the template id.name into the library.
• void del( const char *id, bool full_del = false ); — Deleting of the template id from the library.
• TDAQS &owner( ) const; — Object subsystem "DAQ", owner of the library.

4.9 The object of the parameter's template of the "DAQ" subsystem (TPrmTempl)

Data:
Additional flags to the attribute's object of the function IO (enum TPrmTempl::IOTmplFlgs):

• TPrmTempl::AttrRead(0x10) — Read only attribute;
• TPrmTempl::AttrFull(0x20) — Full access attribute;
• TPrmTempl::CfgPublConst(0x40) — Public constant;
• TPrmTempl::CfgLink(0x80) — External link;
• TPrmTempl::LockAttr(0x100) — Blocked attribute.

Public methods:

• TPrmTempl( const char *id, const char *name = "" ); — Initializing constructor of the template.
• string id( ); — Parameter's template ID.
• string name( ); — Parameter's template name.
• string descr( ); — Parameter's template description.
• int maxCalcTm( ); — The limit on the maximum time calculation of procedure template.
• string progLang( ); — Parameter's template programming language.
• bool progTr( ); — Parameter's template program transaltion.
• string prog( ); — Parameter's template program.
• int64_t timeStamp( ); — Timestamp for the object changes into DB.
• void setName( const string &inm ); — Setting the name of the parameter's template.
• void setDescr( const string &idsc ); — Setting the description of the parameter's template.
• void setMaxCalcTm( int vl ); — Setting the limit on the maximum time calculation of procedure template.
• void setProgLang( const string &ilng ); — Setting the programming language of the parameter's template.
• void setProgTr( bool vl ); — Setting the program of the parameter's template translation.
• void setProg( const string &iprg ); — Setting the program of the parameter's template.
• void setStart( bool val ); — Start/stop of the parameter's template.
• AutoHD<TFunction> func( ); — Connection to the function formed by the template.
• TPrmTmplLib &owner( ) const; — Object of the templates' library - the owner of the template.

4.9.1 The object of the implementation of the template's parameters of the "DAQ" subsystem (TPrmTempl::Impl)

Data:
Structure of template links (class — TPrmTempl::Impl::SLnk):

• int objOff; — offset of an Object part to direct accessing by it;
• string addr, addrSpec; — original and special (like to ModBus final address) link address;
• AutoHD<TVal> con; — connection to the destination, DAQ attribute;
• SLnk( const string &iaddr = "" ) — structure constructor.

Public methods:

• Impl( TCntrNode *iobj, const string &iname = "", bool blked = true ); — constructs for the template implementation with the control node iobj and the name iname.
• int lnkId( const string &nm ); — returns the link nm (function's IO) identifier/number.
• bool lnkPresent( int num ); — checks the link number num to presence, returns "true" for accessibility the link.
• void lnkList( vector<int> &ls ) const — gets for list of the linked attributes ID.
• virtual void lnkAdd( int num, const SLnk &l ); — adds a link with the number num and the "SLnk" structure l.
• string lnkAddr( int num, bool spec = false ) const; — returns the link address for the number num and the special link address for spec.
• void lnkAddrSet( int num, const string &vl, bool spec = false ); — sets the link address to vl for number num and the special link address for spec.
• virtual bool lnkInit( int num, bool toRecnt = false ); — inits/connects the link for the number num, which means reading "addr" and forming "con" or "addrSpec". Set toRecnt to force the re-linking. Returns "true" at the need for the initialization/activation repeating.
• virtual bool lnkActive( int num ); — checks the link number num initialization/activation state.
• virtual TVariant lnkInput( int num ); — returns a value by the link number num.
• virtual bool lnkOutput( int num, const TVariant &vl ); — sets the value vl by the link number num. Returns "true" at correct setting.
• void addLinksAttrs( TElem *attrsCntr = NULL ); — adds links and DAQ parameter's attributes, at attrsCntr presence.
• bool initLnks( bool toRecnt = false ); — inits/connects all the links. Set toRecnt to force the re-linking. Returns "true" at presence at last one not initiated link — needs for the initialization/activation repeating.
• virtual void cleanLnks( bool andFunc = false ); — cleans all the links and the function, for andFunc.
• void inputLinks( ); — gets for values of all the links.
• void outputLinks( ); — sets for values of all the links.
• bool cntrCmdProc( XMLNode *opt, const string &pref = "/cfg" ); — calls for control interface of the links with the prefix "pref".

Protected attributes:

• map<int,SLnk> lnks; — links contatiner;
• TCntrNode *obj; — associated control node;

Protected methods:

• virtual string lnkHelp( ); — returns help for the links address' syntax.

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 TTypeArchivator. 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. Hierarchical structure of the 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 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: 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" (TTypeArchivator) 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)

Modes of forming ID of the automatic created archives:

• BothPrmAttrId — combining the parameter and the attribute ID.
• OnlyPrmId — only the parameter ID.
• OnlyAttrId — only the attribute ID.
• AllCntrPrmAttrId — all controller, parameter and attribute ID.

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.
• bool valForceCurTm( ); — Points to force of current time as the time-stamp of the getting values.
• AutoIdMode autoIdMode( ); — Gets the mode of forming ID of the automatic created archives.
• 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 setValForceCurTm( bool vl ); — Force of current time as the time-stamp of the getting values.
• void setAutoIdMode( AutoIdMode vl ); — Sets the mode vl of forming ID of the automatic created archives.
• void setToUpdate( ); — Planing update flag set.
• void subStart( ); — Start of the subsystem.
• void subStop( ); — Stop of the system.
• void valList( vector<string> &list ) const; — The list of the values'archives in the subsystem.
• bool valPresent( const string &id ) const; — Check for the availability of the values' archive id.
• string valAdd( const string &id, const string &idb = "*.*" ); — Addition of the new values' archive id. Returns the end created identifier.
• void valDel( const string &id, bool db = false ); — Deleting of the values' archive id.
• AutoHD<TVArchive> valAt( const string &id ) const; — Connection/addressing to the values' archive id.
• void setActMess( TMArchivator *a, bool val ); — Setting of the messages archivator a into the active status val. Active archivator will be provided by the subsystem with the flow of messages.
• void setActVal( TVArchive *a, bool val ); — Setting of the value archive a into the active status val. Active archive will be provided by the subsystem with the periodic flow of values (is determined by the periodicity of the archive).
• AutoHD<TTypeArchivator> at( const string &name ); — Connection/addressing to the archiver's type (module) name.
• void messPut( time_t tm, int utm, const string &categ, int8_t level, const string &mess, const string &arch = "" ); — 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 or direct to the pointed archivators arch (separated by symbol ';').
• void messPut( const vector<TMess::SRec> &recs, const string &arch = "" ); — Location of the group of values recs into the buffer, and then into the messages' archive or direct to the pointed archivators arch (separated by symbol ';').
• time_t messGet( time_t bTm, time_t eTm, vector<TMess::SRec> &recs, const string &category = "", int8_t level = TMess::Debug, const string &arch = "", time_t upTo = 0 ); — Values' request reqs for the specified period of time bTm, eTm for the specified category (by the template) category and level level from the archivators arch (separated by symbol ';'). Return time of the request stop, useful for continue from the point.
• 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.
• time_t rdTm( ); — Time of the last redundancy operation, maximum for message archivers in the active redundancy.
• double rdRestDtOverTm( ); — Overtime of the reserve history reload at start in days.
• void setRdRestDtOverTm( double vl ); — Setting of overtime of the reserve history reload at start in days.
• void rdActArchMList( vector<string> &ls, bool isRun = false ); — The list of active message archivators working in the redundancy scheme. When we indicate isRun there will be in the list only running message archvators in this station.
• string rdStRequest( const string &arch, XMLNode &req, const string &prevSt = "", bool toRun = true ); — Request req to the redundant station on behalf of the message archivator arch. The station for the request is selected after specified in prevSt for the running remotely message archivators when indicating toRun.
• 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:

• bool SubStarting; — The subsystem starting flag.

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.
• string id( ); — Archive's ID.
• string name( ); — Archive's name.
• string dscr( ); — Archive's description.
• SrcMode srcMode( ); — Linkage mode with the data source.
• AutoHD<TVal> srcPAttr( bool force = false, const string &ipath = "" ); — Connect to associated attribute of parameter of 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( ) const; — 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.
• int64_t end( const string &arch = BUF_ARCH_NM ); — End of the archive time at whole (arch="") or the specified archiver, buffer (arch="<bufer>").
• int64_t begin( const string &arch = BUF_ARCH_NM ); — Start of the archive time at whole (arch="") or the specified archiver, buffer (arch="<bufer>").
• int64_t period( const string &arch = BUF_ARCH_NM ); — Periodicity of the archive buffer or the specified archiver (microseconds).
• TFld::Type valType( bool full = false ); — Type of the archived value. full — request full type, else only generic.
• bool hardGrid( ); — Using of the hard grid in the archive buffer.
• bool highResTm( ); — Using of the high-resolution time in the archive buffer (microseconds).
• bool fillLast( ); — Fill pass points to a last value. Mostly the pass values fill by EVAL but sometime the source's data periodicity greater to the archive's one and it is normal.
• 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 = SaveCur, const string &isrc = "<*>", bool noex = false ); — 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 setFillLast( bool vl ); — Set to fill pass points to a last value.
• void setSize( int vl ); — Setting of the archive buffer size (units).
• void setPeriod( int64_t 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( int64_t *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, int64_t beg = 0, int64_t end = 0, const string &arch = "", int limit = 100000, bool onlyLocal = false ); — Request of the values' frame buf for the time from beg to end from the specified archiver arch, buffer (arch = "<bufer>") or from the all archivers in the course of falling quality (arch =""), limiting the size of the request limit of the record. To request only the local archives, without compensation gaps in the archives from the backup stations, set onlyLocal.
• void setVals( TValBuf &buf, int64_t beg, int64_t end, const string &arch ); — Set of the values' frame buf for the time from beg to end to the specified archiver arch, buffer (arch = "<bufer">) or to all archivers (arch ="").
• void getActiveData( const int64_t &tm = 0 ); — To interrogate the data source with forcing time-stamp to tm (not zero). Is used for periodic data acquisition by the active archives in the subsystem.
• void archivatorList( vector<string> &ls ); — List of archivers which serves the archive.
• bool archivatorPresent( const string &arch ); — Check the archiver for it's servicing of the given archive.
• void archivatorAttach( const string &arch ); — Connecting the archive to be served by the specified archiver.
• void archivatorDetach( const string &arch, bool full = false ); — Disabling this archive from the servicing of the specified archiver.
• void archivatorSort( ); — Sort of the serving archivers in the order of decreasing quality.
• string makeTrendImg( int64_t beg, int64_t end, const string &arch, int hsz = 650, int vsz = 230 ); — Building of the (pdf) image of the trend for the specified amount of time beg, end and for this archiver arch.
• TArchiveS &owner( ) const; — Subsystem "Archives" - the owner of the archive of values.

5.3 Object of the values' buffer (TValBuf)

Public methods:

• TValBuf( ); — Buffer initializer with default settings.
• TValBuf( TFld::Type vtp, int isz, int64_t ipr, bool ihgrd = false, bool ihres = false ); — Buffer initializer with the specified parameters.
• TValBuf( const TValBuf &src ); — Copying constructor.
• TValBuf &operator=( const TValBuf &src ); — Object copying.
• void clear( ); — Cleaning the buffer.
• TFld::Type valType( bool full = false ); — Type of the value stored in the buffer. full — request full type, else only generic.
• bool hardGrid( ); — Hard grid working mode.
• bool highResTm( ); — High resolution (microseconds) working mode of the buffer.
• bool fillLast( ); — Fill pass points to a last value. Mostly the pass values fill by EVAL but sometime the source's data periodicity greater to the archive's one and it is normal.
• int size( ); — Maximum buffer size (units).
• int realSize( ); — Real buffer size (units).
• int64_t period( ); — Frequency of values in the buffer (microseconds). If the frequency is zero the buffer operates in the mode of free access.
• int64_t begin( ); — Start time of the buffer (microseconds).
• int64_t end( ); — End time of the buffer (microseconds).
• bool vOK( int64_t ibeg, int64_t iend ); — Checking for values in the buffer for the specified period of time from ibeg to iend.
• void setValType( TFld::Type vl ); — Setting of the value type stored by the buffer.
• void setHardGrid( bool vl ); — Setting the hard grid mode.
• void setHighResTm( bool vl ); — High resolution (microseconds) working mode setting.
• void setFillLast( bool vl ); — Set to fill pass points to a last value.
• void setSize( int vl ); — Buffer size (units) setting.
• void setPeriod( int64_t vl ); — Frequency of values in the buffer (microseconds) setting.
• virtual void getVals( TValBuf &buf, int64_t beg = 0, int64_t end = 0 ); — Request of the values' frame buf for the time from beg to end.
• TVariant get( int64_t *tm = NULL, bool up_ord = false ); — Request value for the time tm and with the sign of moving to the top up_ord.
• virtual string getS( int64_t *tm = NULL, bool up_ord = false ); — Request of the string type value for the time tm and with the sign of moving to the top up_ord.
• virtual double getR( int64_t *tm = NULL, bool up_ord = false ); — Request of the real type value for the time tm and with the sign of moving to the top up_ord.
• virtual int64_t getI( int64_t *tm = NULL, bool up_ord = false ); — Request of the integer type value for the time tm and with the sign of moving to the top up_ord.
• virtual char getB( int64_t *tm = NULL, bool up_ord = false ); — Request of the boolean type value for the time tm and with the sign of moving to the top up_ord.
• virtual void setVals( TValBuf &buf, int64_t beg = 0, int64_t end = 0 ); — Setting the values' frame from buf fro the time from beg to end.
• void set( const TVariant &value, int64_t tm = 0 ); — Setting value with the time tm.
• virtual void setS( const string &value, int64_t tm = 0 ); — Setting the string type value with the time tm.
• virtual void setR( double value, int64_t tm = 0 ); — Setting the real type value with the time tm.
• virtual void setI( int64_t value, int64_t tm = 0 ); — Setting the integer type value with the time tm.
• virtual void setB( char value, int64_t tm = 0 ); — Setting the boolean type value with the time tm.

Protected methods:

• void makeBuf( TFld::Type v_tp, int isz, int64_t ipr, bool hd_grd, bool hg_res ); — Rebuilding the buffer for the specified parameters.

5.4 The modular object of the archiver's type (TTypeArchivator)

Public methods:

• void messList( vector<string> &list ) const; — The list of the messages' archivers.
• bool messPresent( const string &id ) const; — Check for the presence of the specified messages' archiver.
• string messAdd( const string &id, const string &idb = "*.*" ); — Adding of the messages' archiver. Returns the end created identifier.
• void messDel( const string &id, bool full = false ); — Deleting of the messages' archiver.
• AutoHD<TMArchivator> messAt( const string &id ) const; — Connection to the messages' archiver.
• void valList( vector<string> &list ) const; — The list of the values' archivers.
• bool valPresent( const string &id ) const; — Check for the presence of the specified values' archiver.
• string valAdd( const string &id, const string &idb = "*.*" ); — Adding of the values' archiver. Returns the end created identifier.
• void valDel( const string &id, bool full = false ); — Deleting of the values' archiver.
• AutoHD<TVArchivator> valAt( const string &id ) const; — Connection to the values' archiver.
• TArchiveS &owner( ) const; — Subsystem "Archives" - the owner of the archiver's type.

Protected methods:

• virtual TMArchivator *AMess( const string &iid, const string &idb ); — The modular method of creating of the messages' archiver.
• virtual TVArchivator *AVal( const string &iid, const string &idb ); — The modular method of creating of the values' archiver.

5.5 The object of the messages' archiver (TMArchivator)

Public methods:

• TMArchivator( const string &id, const string &db, TElem *cf_el ); — Initializing constructor of the messages' archiver with the ID id, for the storage in the database db with the structure <cf_el>.
• string id( ); — Archiver's ID.
• string workId( ); — Working identifier, it includes the name of the module.
• string name( ); — Archiver's name.
• string dscr( ); — Archiver's description.
• bool toStart( ); — The sign "To start the archiver".
• bool startStat( ); — Archivers' status "Run".
• string &addr( ) const; — Address of the archiver's storage.
• int &level( ); — The level of messages, serviced by the archiver.
• void categ( vector<string> &list ); — Categories (templates) of messages, serviced by the archiver.
• string DB( ) const; — DB address of the archiver.
• string tbl( ); — Table address of the archiver's DB.
• string fullDB( ); — The full table address of the archiver's DB.
• void setName( const string &vl ); — Setting the archiver's name.
• void setDscr( const string &vl ); — Setting the archiver's description.
• void setToStart( bool vl ); — Setting the sign "To start the archiver".
• void setAddr( const string &vl ); — Setting the address of the archiver's storage.
• void setLevel( int lev ); — Setting the level of messages, serviced by the archiver.
• void setDB( const string &idb ); — Setting the DB adress of the archiver.
• time_t redntTm( ); — Time of the last redundancy operation.
• bool redntUse( ); — Getting the data from the backup station mode.
• void setRedntUse( bool vl ); — Changing of the getting the data from the backup station mode.
• Redundant redntMode( ); — Redundancy mode ("<high>", "<low>", "<optimal>", {ForceStation}), enabling.
• void setRedntMode( Redundant vl ); — Setting of the redundancy mode, enabling.
• string redntRun( ); — Configuration of the preferred execution.
• void setRedntRun( const string &vl ); — Setting the configuration of the preferred execution.
• virtual void redntDataUpdate( ); — An operation of the data receiving from the backup station execution. It is called automatically by the service procedure of the redundancy scheme of the subsystem.
• virtual void start( ); — Start of the archiver.
• virtual void stop( ); — Stop of the archiver.
• virtual time_t begin( ); — The beginning of the archive of the specified archiver.
• virtual time_t end( ); — The end of the archive of the specified archiver.
• virtual bool put( vector<TMess::SRec> &mess, bool force = false ); — Place the group of messages in the messages' archive of the specified archivator. Return "true" on successful operation. force for direct writing to the archivator omit the redundancy.
• virtual time_t get( time_t bTm, time_t eTm, vector<TMess::SRec> &mess, const string &category = "", char level = 0, time_t upTo = 0 ); — Get the messages from the archive of the specified archiver for the specified filter parameters. Return time of the request stop, useful for continue from the point.
• TTypeArchivator&owner( ) const; — Archiver's type – the owner of the messages' archiver.

Protected attributes:

• bool runSt; — The sign "Running".
• int messHead; — The pointer to last read message of the messages buffer.

Protected methods:

• bool chkMessOK( const string &icateg, int8_t ilvl ); — Check the message to the filter conditions.

5.6 The object of the values' archiver (TVArchivator)

Public methods:

• TVArchivator( const string &id, const string &db, TElem *cf_el ); — Initializing constructor of the values' archiver with the ID id, for the storage in the database db with the structure cf_el.
• string id( ); — Archiver's ID.
• string workId( ); — Working identifier, it includes the name of the module.
• string name( ); — Archiver's name.
• string dscr( ); — Archiver's description.
• string addr( ) const; — Address of the archiver's storage.
• double valPeriod( ); — Frequency of values of the archiver (microseconds).
• int archPeriod( ); — Frequency of the values' archiving by the archiver. Time after which the archiver makes archiving of the frame of values from the archive's buffer.
• int selPrior( ); — Selection priority for mode "All" archivers.
• bool toStart( ); — The sign "To start the archiver".
• bool startStat( ); — Archivers' status "Run".
• string DB( ) const; — DB address of the archiver.
• string tbl( ); — Table address of the archiver's DB.
• string fullDB( ); — The full table address of the archiver's DB.
• void setName( const string &inm ); — Setting the archiver's name.
• void setDscr( const string &idscr ); — Setting the archiver's description.
• void setAddr( const string &vl ); — Setting the address of the archiver's storage.
• void setValPeriod( double iper ); — Setting the frequency of values of the archiver (microseconds).
• void setArchPeriod( int iper ); — Setting the frequency of the values' archiving by the archiver. Time after which the archiver makes archiving of the frame of values from the archive's buffer.
• void setSelPrior( int vl ); — Set selection priority for mode "All" archivers.
• void setToStart( bool vl ); — Setting the sign "To start the archiver".
• void setDB( const string &idb ); — Setting the DB adress of the archiver.
• virtual void start( ); — Start of the archiver.
• virtual void stop( bool full_del = false ); — Stop of the archiver with the possibility of it's full deleting full_del.
• void archiveList( vector<string> &ls ); — The archive's list, serviced by the archiver.
• bool archivePresent( const string &iid ); — Check for the servicing of the specified archive by the specified archiver.
• TTypeArchivator &owner( ) const; — Archiver's type – the owner of the values' archiver.

Protected methods:

• TVArchEl *archivePlace( TVArchive &item ); — Add the archive item to the processing by the archiver.
• void archiveRemove( const string &id, bool full = false ); — Remove the archive id from the processing by the archiver, with the possibility of its full deleting full.
• virtual TVArchEl *getArchEl( TVArchive &arch ); — Getting the object of the archive's element for the specified archive.
• virtual void pushAccumVals( ); — Push the accumulated by the archivation task values, for the accumulated archivators.

Protected attributes:

• ResRW archRes; — Resource locker of the archiving process.
• bool runSt; — The sign "Archiver is run".
• bool endrunReq; — The sign "End run request to the archiver task".
• vector<TVArchEl *> archEl; — Array of elements of archives in the archiver.

5.7 The object of the archive's element in the archiver (TVArchEl)

Public methods:

• TVArchEl( TVArchive &iarchive, TVArchivator &iarchivator ); — Initializing constructor fro the connection the archive iarchive with the archiver iarchivator.
• virtual void fullErase( ); — Full deleting of the element.
• virtual int64_t end( ); — End time of data (microseconds).
• virtual int64_t begin( ); — Start time of data (microseconds).
• int64_t lastGet( ); — Time of last transfer of the data from the buffer to the storage.
• TVariant getVal( int64_t *tm, bool up_ord, bool onlyLocal = false ); — Request of the value for the time tm and with the sign of moving to the top up_ord, with the specifying of the request of only local archive in onlyLocal.
• void getVals( TValBuf &buf, int64_t beg = 0, int64_t end = 0, bool onlyLocal = false ); — Request of the values' frame buf for the time from beg to end, with the specifying of the request of only local archive in onlyLocal.
• void setVals( TValBuf &buf, int64_t beg = 0, int64_t end = 0, bool toAccum = false ); — Setting the values' frame from the buf for the time from beg to end, through the accumulation toAccum.
• TVArchive &archive( ); — Elements' archive.
• TVArchivator &archivator( ); — Elements' archiver.

Public methods:

• int64_t prev_tm; — The previous value time. It is used for averaging.
• string prev_val; — The previous value time. It is used for averaging.

Protected methods:

• virtual TVariant getValProc( int64_t *tm, bool up_ord ); — The processing function of the single value from the archive request.
• virtual void getValsProc( TValBuf &buf, int64_t beg, int64_t end ); — Function of the processing the request of the module to get the data.
• virtual void setValsProc( TValBuf &buf, int64_t beg, int64_t end, bool toAccum ); — Function of the processing the request of the module to set the data, through the accumulation toAccum.

6 Subsystem "Transports" (TTransportS)

"Transports" subsystem is represented by the TTransportS object, which contains modular objects of the transports' types TTypeTransport on the subsystem-level. Each type of transport contains objects TTransportIn of the input and TTransportOut of the output transports. The overall structure of the subsystem is shown in Fig. 6.

Fig. 6. Hierarchical structure of the subsystem "Transports".

The root object of the "Transports" subsystem's module provides information about the specific type of module and about the external OpenSCADA hosts/stations. As part of the single module it can be implemented the own general-module functionality. In general, for all modules, the access methods for both: inbound and outbound transports of the specific module are contained.

The object of the input transport TTransportIn provides an interface to the implementation of the modular method of input transport.

The object of the output transport TTransportOut provides an interface to the implementation of the modular method of output transport.

6.1 The object of the "Transports" subsystem (TTransportS)

Data:
External hosts mode (enum — ExtHost::Mode):

• User (0) — User.
• System (1) — System.
• UserSystem (2) — User and System.

The structure of the external OpenSCADA hosts/stations (class TTransportS::ExtHost):

• ExtHost( const string &iUserOpen, const string &iid, const string &iname = "", const string &itransp = "", const string &iaddr = "", const string &iuser = "", const string &ipass = "", uint8_t iUpRiseLev = 0 ); — Constructor of the structure initialization.
• string userOpen; — User who created the record about the external host/station.
• string id; — Id of the external host/station.
• string name; — Name of an external host/station.
• string transp; — Transport which is used to access an external host/station.
• string addr; — Address for the transport, which is used to access an external host/station.
• string user; — Users of the external host/station.
• string pass; — Password of the external host/station user.
• uint8_t upRiseLev; — External hosts uprising level/depth of this host/station.
• int8_t mode; — Host mode.
• time_t mdf; — Modification time.

Public methods:

• int subVer( ); — Subsystem's version.
• void inTrList( vector<string> &ls ); — Full list of input transports.
• void outTrList( vector<string> &ls ); — Full list of output transports.
• string extHostsDB( ); — Database for the storing the list of external hosts.
• void extHostList( const string &user, vector<ExtHost> &list, bool andSYS = false, int upRiseLev = -1 ); — The list of external hosts for user, include system andSYS and the uprising level upRiseLev (-1 - starting from the host's entry level).
• ExtHost extHostGet( const string &user, const string &id, bool andSYS = false ); — Getting the information object from the external host id on behalf of the user user, include system andSYS ( "*" — for the system hosts).
• AutoHD<TTransportOut> extHost( TTransportS::ExtHost host, const string &pref = "" ); — Creation - request of the output transport to service the external host host with the prefix of the identification of the system node pref.
• void extHostSet( const ExtHost &host, bool andSYS = false ); — Setting of the external host/station host, include system andSYS.
• void extHostDel( const string &user, const string &id, bool andSYS = false ); — Deleting of the external host/station id on behalf of the user user, include system andSYS ( "*" — for the system hosts).
• int cntrIfCmd( XMLNode &node, const string &senderPref, const string &user = "" ); — Transfer of the control area request of the OpenSCADA node to the remote station.
• void subStart( ); — Start of the subsystem.
• void subStop( ); — Stop of the subsystem.
• TElem &inEl( ); — DB structure of the input transports
• TElem &outEl( ); — DB structure of the output transports
• AutoHD<TTypeTransport> at( const string &id ) const; — Addressing/connection to the type of transport id.

6.2 The modular object of the transports' type (TTypeTransport)

Public methods:

• void inList( vector<string> &list ) const; — The list of the input transports.
• bool inPresent( const string &id ) const; — Check for an input transport presence.
• string inAdd( const string &id, const string &db = "*.*" ); — Addition of the input transport. Returns the end created identifier.
• void inDel( const string &id, bool complete = false ); — Deleting of the input transport. It is possible to completely delete with the database included, by setting the complete sign.
• AutoHD<TTransportIn> inAt( const string &id ) const; — Connection to the input transport.
• void outList( vector<string> &list ) const; — The list of the output transports.
• bool outPresent( const string &id ) const; — Check for an output transport presence.
• string outAdd( const string &id, const string &db = "*.*" ); — Addition of the output transport. Returns the end created identifier.
• void outDel( const string &id, bool complete = false ); — Deleting of the output transport. It is possible to completely delete with the database included, by setting the complete sign.
• AutoHD<TTransportOut> outAt( const string &id ) const; — Connection to the output transport.
• virtual string outAddrHelp( ); — Address format help of the output transport.
• int outLifeTime( ); — Output transport lifetime, 0 for disable.
• void setOutKeepAliveTm( int vl ); — Set the output transport lifetime, 0 for disable.
• TTransportS &owner( ) const; — "Transports" subsystem - the owner of the transport's type.

Protected methods:

• virtual TTransportIn *In( const string &name, const string &db ); — The modular method of the creating/opening of the new "input" transport.
• virtual TTransportOut *Out( const string &name, const string &db ); — The modular method of the creating/opening of the new "output" transport.

6.3 The object of the input transports (TTransportIn)

Public methods:

• TTransportIn( const string &id, const string &db, TElem *el ); — Initializing constructor.
• string id( ); — Transport's Id.
• string workId( ); — Full ID including the ID of the module.
• string name( ); — Transport's name.
• string dscr( ); — Transport's description.
• string addr( ) const; — Address.
• string protocols( ); — Linked transport protocols.
• virtual unsigned keepAliveReqs( ); — Maximum Keep Alive requests.
• virtual unsigned keepAliveTm( ); — Keep Alive time.
• virtual string getStatus( ); — Getting the status of the input transport.
• bool toStart( ); — The sign "To start".
• bool startStat( ); — The status "Running".
• string DB( ); — Transport's DB address.
• string tbl( ); — Transport's DB table.
• string fullDB( ); — The full name of the transport's DB table.
• void setName( const string &inm ); — Setting the name of transport in inm.
• void setDscr( const string &idscr ); — Setting the description of transport in idscr.
• void setAddr( const string &addr ); — Setting the address of transport in addr.
• void setProtocols( const string &prt ); — Setting of the linked transport protocols.
• void setToStart( bool val ); — Setting of the sign "To start".
• void setDB( const string &vl ); — Setting of the transport's DB address.
• virtual void start( ); — Start of the transport.
• virtual void stop( ); — Stop of the transport.
• virtual int writeTo( const string &sender, const string &data ); — Sending data backward to the sender.
• vector<AutoHD<TTransportOut> > assTrs( bool checkForCleanDisabled = false ); — The assigned output transports massive, created by the input transport for typical requests to the connection initiator. Set checkForCleanDisabled for prior checking and clean up disabled ones.
• int logLen( ); — length of the IO log.
• void setLogLen( int vl ); — set length of the IO log.
• void pushLogMess( const string &vl ); — push the message vl to the log in format "{Message}\n{BinData}".
• TTypeTransport &owner( ) const; — Transport's type – the owner of the input transport.

Protected methods:

• string assTrO( const string &addr ); — The assigned output transport creation with address addr.

Protected attributes:

• bool runSt; — The sign "Running".

6.4 The object of the output transports (TTransportOut)

Public methods:

• TTransportOut( const string &id, const string &db, TElem *el ); — Initializing constructor.
• virtual bool isNetwork( ); — The sign — "The transport is network one", what is specified by the timeouts in seconds.
• string id( ); — Transport's Id.
• string workId( ); — Full ID including the ID of the module.
• string name( ); — Transport name.
• string dscr( ); — Transport description.
• string addr( ) const; — Transport address.
• virtual string timings( ); — Transport timeouts.
• virtual unsigned short attempts( ); Connection attempts.
• TVariant conPrm( const string &nm ); — Getting the connection parameter nm value.
• bool startStat( ); — Status "Running".
• time_t startTm( ); — Status "Time of starting/connection".
• int64_t lstReqTm( ); — Status "Last request time".
• virtual string getStatus( ); — Getting the status of the transport.
• string DB( ); — Transport's DB address.
• string tbl( ); — Transport's DB table.
• string fullDB( ); — The full name of the transport's DB table.
• void setName( const string &inm ); — Setting the name of transport.
• void setDscr( const string &idscr ); — Setting the description of transport.
• void setAddr( const string &addr ); — Setting the address of transport.
• virtual void setTimings( const string &vl, bool isDef = false ); — Setting the transport timeouts, as default one for isDef.
• virtual void setAttempts( unsigned short vl ); — Setting the connection attempts.
• void setConPrm( const string &nm, const TVariant &vl ); — Setting the connection parameter nm to value vl.
• void clearConPrm( ); — Clearing the connection parameters.
• void setDB( const string &vl ); — Setting of the transport's DB address.
• virtual void start( int time = 0 ); — Start of the transport with connection time time.
• virtual void stop( ); — Stop of the transport.
• virtual int messIO( const char *obuf, int len_ob, char *ibuf = NULL, int len_ib = 0, int time = 0 ); — Sending of the data over the transport. The waiting time time of the connection (in milliseconds). The time in negative disables the transport's request/respond mode and allow independent reading/writing to a buffer IO, with the reading timeout time in absolute.
• void messProtIO( XMLNode &io, const string &prot ); — Sending of the data in the XML tree in over the transport using the transport protocol prot.
• int logLen( ); — length of the IO log.
• void setLogLen( int vl ); — set length of the IO log.
• void pushLogMess( const string &vl ); — push the message vl to the log in format "{Message}\n{BinData}".
• TTypeTransport &owner( ) const; — Type of transport - the owner of output transport.
• ResMtx &reqRes( ); — The requesting resource, needs to global lock into protocols with fragments receiving.

Protected attributes:

• bool runSt; — The sign "Running".
• int64_t mLstReqTm; — The last request time.

7 Subsystem "Communication interfaces' protocols" (TProtocolS)

Subsystem "Communication interfaces' protocols" is presented by the TProtocolS object, which contains modular objects of the separate protocols TProtocol on the a subsystem's level. Each protocol contains objects of the opened sessions of the input protocols TProtocolIn.

TProtocolS object provides an access to the both: the input and the output protocols of the individual types of transport protocols. The inner side of output protocol based on the steaming principle with the individual structure of the stream for each implementation of the protocol.

7.1 The object of the "Communication interfaces' protocols" subsystem (TProtocolS)

Public methods:

• int subVer( ); — Subsystem's version.
• AutoHD<TProtocol> at( const string &id ) const; — Connection to the protocol's id module.

7.2 The modular object of the protocol (TProtocol)

Public methods:

• virtual void itemListIn( vector<string> &ls, const string &curIt = "" ); — Items list of protocol for individual addressing into transport.
• void list( vector<string> &list ) const; — The list of open input sessions.
• bool openStat( const string &name ) const; — Check for the openness of the input session with the specified name.
• void open( const string &name, TTransportIn *tr = NULL, const string &sender = "" ); — Opening of the session on behalf of the input transport tr.
• void close( const string &name ); — Closing of the input session.
• AutoHD<TProtocolIn> at( const string &name ) const; — Connecting to the open input sessions.
• virtual void outMess( XMLNode &io, TTransportOut &tro ); — Sending the data in the XML tree in over the protocol and transport tro.

7.3 The object of the input protocol's session (TProtocolIn)

Public methods:

• TProtocolIn( const string &name ); — Initializing constructor.
• string name( ); — The name of the input session.
• AutoHD<TTransportIn> &srcTr( ) — The transport-source of the opening of the session of the input protocol.
• const string &srcAddr( ) — The sender address; second line contains service part of the address for backward messages.
• virtual unsigned waitReqTm( ); — A request waiting time on input transport (in milliseconds), after what call to the protocol with the empty message — the polling mode. Setting it to zero will disable the polling mode.
• virtual void setSrcTr( TTransportIn *vl ) — Setting of the transport-source of the opening of the session of the input protocol.
• virtual void setSrcAddr( const string &vl ); — Setting of the sender address.
• int writeTo( const string &data ); — Sending the messages data backward to the sender, into srcAddr().
• virtual bool mess( const string &request, string &answer ); — Transfer of unstructured data to their processing by the protocol.
• TProtocol &owner( ) const; — The protocol, the owner of input sessions.

8 Subsystem "User interfaces" (TUIS)

The subsystem "User Interfaces" is presented by the TUIS object, which contains modular objects of the TUI user interfaces' on the subsystem's level.

8.1 The object of the "User interfaces" subsystem (TUIS)

Data:
Requests parameters (enum — GetOpts):

• GetPathURL (1) — Path get.
• GetContent (2) — Open document command get.

Public methods:

• int subVer( ); — Subsystem's version.
• void subStart( ); — Start of the subsystem.
• void subStop( ); — Stop of the subsystem.
• AutoHD<TUI> at( const string &name ) const; — Connects to the user's interface module.
• static string icoGet( const string &inm, string *tp = NULL, bool retPath = false ); — Downloads image of the icon inm from standard directories or return path, on retPath, to allowed icon. Detecting icons for file extensions "png", "gif", "jpg", "jpeg", which return into tp.
• static string docGet( const string &inm, string *tp = NULL, unsigned opt = 0 ); — Downloads document inm from standard directories or return path, on retPath, to allowed document. Detecting documents for file extensions "pdf", "html", "odt", which return into tp.
• static string docKeyGet( const string &itxt ); — Gets the inline documentation key from the text itxt of a configuration field, often it is the node description and the key "DOC" in it.
• static string mimeGet( const string &inm, const string &fDt, const string &orig = "" ); — Gets file's mime type in view {group}/{type} for the file name inm, its content fDt and the original hint orig.

8.2 The modular object of the user interface (TUI)

Protected attributes:

• bool runSt; — The sign "Running".

9 Subsystem "Specials" (TSpecialS)

The subsystem "Specials" is presented by TSpecialS object, which contains modular objects of TSpecial special on the subsystem's level.

9.1 The object of the "Specials" subsystem (TSpecialS)

Public methods:

• int subVer( ); — Subsystem's version.

9.2 The modular object of the specials (TSpecial)

Protected attributes:

• bool runSt; — The sign "Running".

10 Subsystem "Security" (TSeсurity)

Security subsystem is presented by an object TSesurity, which contains group objects of TGroup and users TUser.

User object TUser contains user information and checks the authenticity of the user in accordance with the specified password.

TGroup user object contains information about the group of users and checks the user's belonging to the group.

10.1 The object of the "Security" subsystem (TSeсurity)

Public data:

• static const string pHashMagic; — String-pointer (prefix) of the password into hash.

Public methods:

• bool access( const string &user, char mode, int owner, int groups, int access ); — Check the access of the user in the mode to the resource with the owner, groups (separated ',') and permition access.
• void usrList( vector<string> &list ) const; — The list of the users list.
• void usrGrpList( const string &name, vector<string> &list ); — The list of the users' groups list, in which the user name is included.
• bool usrPresent( const string &name ) const; — Check fro the presence of the specified user name.
• string usrAdd( const string &name, const string &db = "*.*" ); — Addition of the user name with the saving to the DB db. Returns the end created name of the user.
• void usrDel( const string &name, bool complete = false ); — Deleting of the user name with the possibility of the completely deleting complete.
• AutoHD<TUser> usrAt( const string &name ) const; — Attaching of the user name.
• void grpList( vector<string> &list ) const; — The list of the users' groups list.
• bool grpPresent( const string &name ) const; — Check fro the presence of the specified users' group name.
• string grpAdd( const string &name, const string &db = "*.*" ); — Addition of the users' group name with the saving to the DB db. Returns the end created name of the user group.
• void grpDel( const string &name, bool complete = false ); — Deleting of the users' group name with the possibility of the completely deleting complete.
• AutoHD<TGroup> grpAt( const string &name ) const; — Connection to the users' group name.

10.2 The user's object (TUser)

Public methods:

• TUser( const string &name, const string &db, TElem *el ); — Initialising constructor.
• string name( ); — User name.
• string descr( ); — User description.
• string longDescr( ); — User long description.
• string picture( ); — User image.
• string lang( ); — User language, only into the dynamic translation text variables mode.
• bool sysItem( ); — Sign of the system user.
• bool auth( const string &pass, string *hash = NULL ); — Check the authenticity of the user by the password pass. The password hash, if it is supports, placing into the hash.
• int permitCmpr( const string &user ); — Comparing the user permition with the user object. Returns -1 for lesser, 1 for greater and 0 for even permition.
• string DB( ); — User DB address.
• string tbl( ); — Address of the table of user's DB.
• string fullDB( ); — The full name of the table of user's DB.
• void setDescr( const string &vl ); — Setting user's description to vl.
• void setLongDescr( const string &vl ); — Setting user's long description to vl.
• void setPicture( const string &pct ); — Setting user's image to pct.
• void setLang( const string &vl ); — Setting user's language to vl.
• void setPass( const string &pass ); — Setting user's password to pass.
• void setSysItem( bool vl ); — Setting the sign of system user to vl.
• void setDB( const string &vl ); — Setting user's DB address.
• TSeсurity &owner( ) const; — "Security" subsystem - the owner of the user.

10.3 The users' group object (TGroup)

Public methods:

• TGroup( const string &name, const string &db, TElem *el ); — Initializing constructor.
• string name( ); — Users group name.
• string descr( ); — Users group description.
• string longDescr( ); — Users group long description.
• bool sysItem( ); — The sign of the system user.
• string DB( ); — Users' group DB address.
• string tbl( ); — Address of the table of the users' group DB.
• string fullDB( ); — The full name of the table of the users' group DB.
• void setDescr( const string &vl ); — Setting users group description to vl.
• void setLongDescr( const string &vl ); — Setting users group long description to vl.
• void setDB( const string &vl ); — Setting the users' group DB address.
• bool user( const string &name ); — Check for the user's belonging to the group name.
• void userAdd( const string &name ); — Addition of the user name to the group.
• void userDel( const string &name ); — Deleting of the user name from the group.
• TSeсurity &owner( ) const; — "Security" subsystem - the owner of the users' group.

11 Subsystem “Modules' sheduling” (TModSchedul)

Subsystem “Modules' sheduling” is presented by the object TModSchedul.

The subsystem contains the control mechanism for modules contained in shared libraries.

11.1 The object of the subsystem "Modules' sheduling" (TModSchedul)

Data:
The structure of information about the shared library (struct – TModSchedul::SHD):

• void *hd; — the title of the shared library (if NULL, the library is present, but not connected);
• vector<string> use; — list of connected modules;
• time_t tm; — modification time of the library;
• string name; — full name/path of the shared library.

Public methods:

• string allowList( ) const; — The list of permitted shared libraries (modules).
• string denyList( ); — The list of prohibited shared libraries (modules).
• int chkPer( ); — The verification period of the directory with the modules (s).
• void setAllowList( const string &vl ); — Setting of the list of permitted shared libraries (modules).
• void setDenyList( const string &vl ); — Setting of the list of prohibited shared libraries (modules).
• void setChkPer( int per ); — Setting the verification period of the directory with the modules (s). If the frequency is equal to zero, the check will be disabled.
• void subStart( ); — Subsystem's start.
• void subStop( ); — Subsystem's stop.
• int loadLibS( ); — Loading the shared libraries and initialization of the modules. Return numbers loaded modules.
• SHD &lib( const string &name ); — Getting the shared library object name.
• void libList( vector<string> &list ); — The list of shared libraries list.
• int libLoad( const string &path, bool full ); — Loading the shared libraries from the specified path path. Return numbers loaded modules.
• void libAtt( const string &name, bool full = false); — Attaching of the specified shared library name.
• void libDet( const string &name ); — Detaching of the specified shared library name.

12 Components of the object model of OpenSCADA

Object model of OpenSCADA is based on the function object TFunction, on the parameters of the function IO and on the values' frame of the function TValFunc. Later the function's objects are included in the object tree, forming an object model of the system. Using the functions of the object model is made by linking the frame of values TValFunc with function.

The idea in general is shown in Fig. 7.

Fig. 7. Basis of the programming area of OpenSCADA.

Object of the function (TFunction) provides an interface for the formation of function parameters and algorithm of the computing in the object which inherits it.

Object of the function's parameter (IO) contains the configuration of the single parameter.

Object of the values' frame (TValFunc) contains values in accordance with the structure of the linked function. While the execution of the algorithm by the associated function the values of this object are used.

12.1 The function object (TFunction)

Public methods:

• TFunction( const string &id, const char *grp = "root", const string &istor = "" ); — Initializing constructor of the function with the identifier id, users group grp and storage stor.
• TFunction( const TFunction &src ); — Copying constructor.
• TFunction &operator=( const TFunction &func ); — Copying of functions.
• string id( ) const; — Function ID.
• virtual string name( ); — Localized name of the function.
• virtual string descr( ); — Description of the function.
• virtual string prog( ); — Program's text of the function, for no static ones.
• virtual string stor( ); — Storage DB, for table "Trs" mostly.
• bool startStat( ) const; — Status - "Running".
• int use( ); — Counter of the function's using.
• ResRW &fRes( ); — Link to the resource of the function.
• void setId( const string &vl ); — Set the function identifier.
• virtual void setProg( const string &prg ); — Set program's text of the function, for no static ones.
• void setStor( const string &istor ); — Set storage DB to stor.
• virtual void setStart( bool val ); — Start/stop val of the function.
• void ioList( vector<string> &list ); — The list of the function's parameters list.
• int ioId( const string &id ) const; — Getting the index of the function's parameter id.
• int ioSize( ) const; — The quantity of the function's parameters.
• IO *io( int id ) const; — Getting the function's parameter by the index id.
• int ioAdd( IO *io ); — Addition of the function's parameter io. Returns the actual position of the new IO.
• int ioIns( IO *io, int pos ); — Insert of the function's parameter io into the position pos. Returns the actual position of the new IO.
• void ioDel( int pos ); — Deleting the function's parameter in the position pos.
• void ioMove( int pos, int to ); — Moving the function's parameter from the position pos to the position to.
• virtual void calc( TValFunc *val ); — The calculation of the function's algorithm of the specified values val.
• virtual void valAtt( TValFunc *vfnc ); — Is called by the object of the values' frame vfnc in the case of attaching with the function.
• virtual void valDet( TValFunc *vfnc ); — Is called by the object of the values' frame vfnc in the case of detaching from the function.
• virtual void preIOCfgChange( ); — Is called before the changing of the configuration of the function.
• virtual void postIOCfgChange( ); — Is called after the changing of the configuration of the function.

Protected attributes:

• string mId; — Function ID.
• bool runSt; — Sign - "Running".
• bool beStart; — Sign - "Start".
• TValFunc *mTVal; — Reference to the values' object, used for testing the function. May be absent.

12.2 The object of the function's parameter (IO)

Data:
Parameter's type (enum — IO::Type):

• IO::String — string/text;
• IO::Integer — integer;
• IO::Real — real;
• IO::Boolean — boolean;
• IO::Object — object.

Parameter's flags (enum — IO::IOFlgs):

• IO::Default — default mode (input);
• IO::Output — output;
• IO::Return — return.

Public methods:

• IO( const char *id, const char *name, IO::Type type, unsigned flgs, const char *def = "", bool hide = false, const char *rez = "" ); — Initializing constructor.
• IO( const IO &src ); — Copying constructor.
• IO &operator=( const IO &iio ); — Copying of the function parameters.
• const string &id( ) const; — ID of the function's parameter.
• const string &name( ) const; — The localized name of the function's parameter.
• const Type &type( ) const; — The type of the function's parameter.
• unsigned flg( ) const; — The flags of the function's parameter.
• const string &def( ) const; — Default value.
• bool hide( ) const; — Sign - "Hide".
• const string &rez( ) const; — The reserve property of the function's parameter.
• void setId( const string &val ); — Set the identifier to val.
• void setName( const string &val ); — Set the name to val.
• void setType( Type val ); — Set the type to val.
• void setFlg( unsigned val ); — Set the flags to val.
• void setDef( const string &val ); — Set the default value to val.
• void setHide( bool val ); — Set/unset the sign - "Hide".
• void setRez( const string &val ); — Set the reserve property to val.

12.3 The object of the function's value (TValFunc)

Public methods:

• TValFunc( const string &iname = "", TFunction *ifunc = NULL, bool iblk = true ); — Initializing constructor.
• bool blk( ); — The sign — "Blocking of the parameters' changes of the function".
• bool mdfChk( ); — The sign — "To check attributes to modify".
• bool isChangedProg( bool clear = false ); — The sign — "The program changing" with it clearing by clear.
• bool isCalc( ); — The sign — "The function calculation".
• string user( ); — User on whose behalf the function is executed.
• string lang( ); — Language on whose the function is executed.
• const string &vfName( ); — Name of the values' object.
• void setUser( const string &vl ); — Set the user on whose behalf the function will be executed.
• void setLang( const string &vl ); — Set the language on whose the function will be executed.
• void setVfName( const string &nm ); — Set the name of the values' object to nm.
• void setMdfChk( bool set ); — Set/unset set of the sign - "To check attributes to modify".
• void ioList( vector<string> &list ); — The list of the function's parameters list.
• int ioId( const string &id ); — Getting the parameter's index id.
• int ioSize( ) const; — The whole quantity of the parameters.
• IO::Type ioType( unsigned id ); — Parameter's type id.
• unsigned ioFlg( unsigned id ) const; — Parameter's flags id.
• bool ioHide( unsigned id ); — Parameter's sign id - "Hide".
• bool ioMdf( unsigned id ); — Parameter's sign id - "Modified".
• TVariant get( unsigned id ); — Get the value of the parameter id.
• string getS( unsigned id ); — Get the value (string) of the parameter id.
• int64_t getI( unsigned id ); — Get the value (integer) of the parameter id.
• double getR( unsigned id ); — Get the value (real) of the parameter id.
• bool getB( unsigned id ); — Get the value (boolean) of the parameter id.
• AutoHD<TVarObj> getO( unsigned id ); — Get the value of the parameter's object id.
• void set( unsigned id, const TVariant &val ); — Set the value val of the parameter id.
• void setS( unsigned id, const string &val ); — Set the value val (string) of the parameter id.
• void setI( unsigned id, int64_t val ); — Set the value val (integer) of the parameter id.
• void setR( unsigned id, double val ); — Set the value val (real) of the parameter id.
• void setB( unsigned id, bool val ); — Set the value val (boolean) of the parameter id.
• void setO( unsigned id, AutoHD<TVarObj> val ); — Set the value val of the parameter's object id.
• virtual void calc( const string &user = "" ); — To calculate on behalf of the user user or user, specified earlier.
• double calcTm( ); — Computation time.
• void setCalcTm( double vl ); — Initializing of the time of value's calculation vl.
• TFunction *func( ); — Attached function.
• void setFunc( TFunction *func, bool att_det = true ); — To attach with the specified function func.
• virtual void preIOCfgChange( ); — Is called before the configuration changes.
• virtual void postIOCfgChange( ); — Is called after the configuration changes.
• virtual void progChange( ); — Is called at the program changing.
• TValFunc *ctxGet( int key ); — Get context for key key.
• void ctxSet( int key, TValFunc *val ); — Set context for key key.
• void ctxClear( ); — External functions call context clear.

Public attributes:

• void *exCtx; — The function execution context.

13 Data in OpenSCADA and their storage in the DB (TConfig)

Storing data in the system based on the objects TConfig and TElem. These objects store the structure and fields' values of the database, allowing for direct loading and saving the configuration via the "DB" subsystem. For the specialized different types data storage the TVariant object is provided.

TElem object contains the structure of database record. Structure of the record contains extensive information about the elements, their types, sizes and other parameters. Information in this structure is enough to create, control and manage the real structure of the database. Elementary unit of the record is the cell Tfld.

TConfig object is the heir of TElem and contains the actual values of elements. TConfig is used as the parameter in the functions of the manipulating with the table's records in the "DB" subsystem. Elementary unit of the record is the cell TCfg.

To provide an opportunity to inform the data storehouse about the changes in the structure it is provides an object TValElem, from which it is inherited the storehouse TConfig and the list of which is contained in the TElem structure.

13.1 Data object (TConfig)

Public methods:

• TConfig( TElem *Elements = NULL ); — Initializing constructor.
• TConfig( const TConfig &src ); — Copying constructor.
• TConfig &operator=( const TConfig &cfg ); TConfig &exclCopy( const TConfig &cfg, const string &passCpLs = "", bool cpElsToSingle = false ); — Copying from cfg, passing fields into passCpLs and creating same this fields cpElsToSingle for combined configurations.
• void cfgList( vector<string> &list ) const; — Elements' list list.
• bool cfgPresent( const string &n_val ) const; — Check for the element's presence n_val.
• TCfg &cfg( const string &n_val ) const; — Getting of th element n_val.
• TCfg *at( const string &n_val, bool noExpt = false ) const; — Getting of the element's pointer n_val. If the element is absent an exception is generated or the null pointer is returned when setting noExpt.
• void cfgViewAll( bool val = true ); — Set/unset the sign of the visibility for all the elements.
• void cfgKeyUseAll( bool val ); — Set/unset the sign of the using the key for all the elements.
• void cfgToDefault( ); — Setting all not key and view fields to the default value.
• TElem &elem( ); — The using structure.
• void setElem( TElem *Elements, bool first = false ); — Setting the structure in Elements.
• void cntrCmdMake( XMLNode *fld, const string &path, int pos, const string &user = "root", const string &grp = "root", int perm = 0664 ); — Formation of the information description of elements of the configuration for the management interface of OpenSCADA.
• void cntrCmdProc( XMLNode *fld, const string &elem, const string &user = "root", const string &grp = "root", int perm = 0664 ); — Requests' of the OpenSCADA management interface to the elements of the configuration processing.
• bool incomplTblStruct( ); — The DB struct incomplete flag.
• void setIncmplTblStrct( bool vl ); — Setting the DB struct incomplete flag to vl.
• bool reqKeys( ); — The sign "Requests key", mark for using the request keys by the group items.
• TVariant objFunc( const string &id, vector<TVariant> &prms, const string &user, int perm, const string &owner ); — User API object functions of accessing to the configuration with the permition control.

Protected methods:

• virtual bool cfgChange( TCfg &co, const TVariant &pc ); — Is called in the case of changing the contents of the configuration element.

13.2 Data cell (TCfg)

Data:
Additional flags to TFld (enum — TCfg::AttrFlg):

• TCfg::NoVal(0x100) — Do not reflect an element on the value of the TValue object.
• TCfg::Key(0x200) — key field.
• TCfg::Hide(0x400) — attribute is hidden.

Requests flags (enum — ReqFlg):

• TFld::ForceUse(0x01) — Forcing the setting of the flag of the element's using during the setting of its value.
• TFld::ExtValOne (0x02) — One/first (and default) value: set value for key.
• TFld::ExtValTwo (0x04) — Two/second value: base value for the key request or set.
• TFld::ExtValThree (0x08) — Three value: source address for translations.

Public methods:

• TCfg( TFld &fld, TConfig &owner ); — Initializing constructor.
• TCfg( const TCfg &cfg ); — Copy constructor.
• const string &name( ); — Cell name.
• bool operator==( TCfg &cfg ); — Comparison of the cells.
• TCfg &operator=( const TCfg &cfg ); — Copying of the cells.
• bool view( ) const; — The sign - "Cell is visible".
• bool keyUse( ) const; — The sign - "Use the key" for the dataSeek() and dataDel() requests.
• bool noTransl( ) const; — The sign "No translation" is provided to disable the translation of text variables for the record.
• bool reqKey( ) const; — The sign "Requests key", for group operations produce by the field as key.
• bool isKey( ) const; — Common sign of the field as key, depends from mode "Requests key" for the group.
• bool extVal( ) const; — The sign "Extended value", for mark the field to misc role for search and update the key value and translation.
• void setView( bool vw ); — Setting of the sign "The cell is visible" в vw.
• void setKeyUse( bool vl ); — Setting of the sign "Use the key" in vl.
• void setNoTransl( bool vl ); — Setting of the sign "No translation".
• void setReqKey( bool vl, bool treatDep = true ); — Setting of the sign "Requests key", treating the dependencies by treatDep.
• void setExtVal( bool vw ); — Setting of the sign "Extended value".
• void toDefault( bool notSetType = false ); — Setting the field value to the default one, and without setting the field type at notSetType.
• TFld &fld( ) const; — Configuration of the cell.
• string getSEL( ); — Get the value of the selectable type.
• string getS( ) const; string getS( uint8_t RqFlg ); — Get the value of the string type with the request flags RqFlg.
• const char *getSd( ); — Get the direct access to the string type value.
• double &getRd( ); — Get the direct access to the real type value.
• int64_t &getId( ); — Get the direct access to the integer type value.
• char &getBd( ); — Get the direct access to the boolean type value.
• void setSEL( const string &val, uint8_t RqFlg = 0 ); — Set the value of the selectable type to the val with the request flags RqFlg.
• void setS( const string &val ); TCfg &operator=( const string &vl ); TCfg &operator=( const char *vl ); void setS( const string &val, uint8_t RqFlg ); — Set the value of the string type to the val with the request flags RqFlg.
• void setR( double val ); TCfg &operator=( double vl ); void setR( double val, uint8_t RqFlg ); — Set the value of the real type to the val with the request flags RqFlg.
• void setI( int64_t val ); TCfg &operator=( int64_t vl ); void setI( int64_t val, uint8_t RqFlg ); — Set the value of the integer type to the val with the request flags RqFlg.
• void setB( char val ); TCfg &operator=( bool vl ); void setB( char val, uint8_t RqFlg ); — Set the value of the boolean type to the val with the request flags RqFlg.
• TConfig &owner( ) const; — The object of container-owner.

13.3 Data structure object (TElem)

Public methods:

• TElem( const string &name = "" ); — Initialization of the structure with the specified name name.
• TElem( const TElem &src ); — Copying constructor.
• TElem &operator=( const TElem &src ); — Copying from src.
• string &elName( ); — The name if the structure.
• void fldList( vector<string> &list ); — The cell's list in the structure list.
• unsigned fldSize( ) const; — The number of cells in the structure.
• unsigned fldId( const string &name, bool noex = false ); — Getting the index of the cell from its identifier name. Set noex on no the cell present caused return overall cells number, without exception generation.
• bool fldPresent( const string &name ); — Check for the presence of the specified cell name.
• int fldAdd( TFld *fld, int id = -1 ); — Addition/insert of the cell fld to the position id (-1 — insert to the end).
• void fldDel( unsigned int id ); — Deleting of the cell id.
• TFld &fldAt( unsigned int id ) const; — Getting of the cell id.
• void fldClear( ); — Removing all cells.
• void valAtt( TValElem *cnt ); — Is called automatically when the structure is attached to the data storage cnt.
• void valDet( TValElem *cnt ); — Is called automatically when the structure is detached from the data storage cnt.
• ResMtx &resEl( ); — Mutex for access to containers of the fields.

13.4 Data structure cell (TFld)

Data:
Cell's type (enum – TFld::Type):

• TFld::Boolean(0) — boolean type;
• TFld::Integer(1) — integer type;
• TFld::Real(4) — real type;
• TFld::String(5) — string type;
• TFld::Object(6) — object type.
• TFld::GenMask(0x0F) — generic types mask;
• TFld::Int16(0x11) — signed integer 16 bits;
• TFld::Int32(0x01) — signed integer 32 bits;
• TFld::Int64(0x21) — signed integer 64 bits;
• TFld::Float(0x14) — float (4 bytes);
• TFld::Double(0x04) — double (8 bytes).

Cell's flags (enum — TFld::AttrFlg):

• TFld::NoFlag(0x00) — No flags;
• TFld::Selectable(0x01) — selection mode from the available values, the selectable type;
• TFld::SelfFld(0x02) — To create the own copy of this cell;
• TFld::NoWrite(0x04) — unwritable;
• TFld::HexDec(0x08) — integer type: hexadecimal notation;
• TFld::OctDec(0x10) — integer type: octal notation;
• TFld::DateTimeDec(0x20) — integer type: содержит дату в UTC;
• TFld::FullText(0x08) — Full-text, multi-string mode of the text type;
• TFld::TransltText(0x10) — Translate the text variables of the record.

Public methods:

• TFld( ); — Initialization by default.
• TFld( const TFld &ifld, const char *name = NULL ); — Copying constructor, with possibility for individual name set.
• TFld( const char *name, const char *descr, Type type, unsigned char flg, const char *valLen = "", const char *valDef = "", const char *vals = "", const char *nSel = "", const char *res = "" ); — Initialization with the specified configuration.
• TFld &operator=( const TFld &fld ); — Copy of the cell from fld.
• const string &name( ) const; — Cell's name.
• const string &descr( ) const; — Cell's description.
• string lenS( ) const; — Combined string variant of the length field in the form "{len}.{dec}".
• int len( ) const; — Size of the cell's value (symbols in symbolic representation).
• int dec( ) const; — Size of the fractional part of a real (symbols in symbolic representation).
• Type type( ) const; — Cell's type.
• static Type type(IO::Type tp); — Cell's type from IO::Type type.
• IO::Type typeIO( ) const; — Cell's type in IO::Type.
• unsigned flg( ) const; — Cell's flag.
• const string &def( ) const; — Default value.
• string values( ) const; — Working range of the value or a list of possible values for the selectable type (as — "vl1;vl2;vl3").
• string selNames( ) const; — List of names of values for the selectable type (as — "Value 1;Value 2;Value 3").
• const string &reserve( ) const; — Reserve parameter.
• void setDescr( const string &dscr ); — Set the descrition to the dscr.
• void setLen( int vl ); — Set the cell's size to the vl.
• void setDec( int vl ); — Set the fraction part of the real to the vl.
• void setDef( const string &def ); — Set the default value to the def.
• void setFlg( unsigned flg ); — Set the flags to flg.
• void setValues( const string &vls ); — Set the working range of value or the list of possible values for the selectable type (as — "vl1;vl2;vl3") to the vls.
• void setSelNames( const string &slnms ); — Set the list of values' names for the selectable type (as — "Value 1;Value 2;Value 3") to the slnms.
• void setReserve( const string &ires ); — Set of the reserve parameter to res.
• const vector<string> &selValS() const; — List of values' variants for the string type.
• const vector<int> &selValI() const; — List of values' variants for the integer type.
• const vector<double> &selValR() const; — List of values' variants for the real type
• const vector<bool> &selValB() const; — List of values' variants for the boolean type
• const vector<string> &selNm() const; — List of the names of values' variants.
• string selVl2Nm( const string &val ); — Get the selectable name from the value val of the string type.
• string selVl2Nm( int64_t val ); — Get the selectable name from the value val of the integer type.
• string selVl2Nm( double val ); — Get the selectable name from the value val of the real type.
• string selVl2Nm( bool val ); string selVl2Nm( char val ); — Get the selectable name from the value valof the Boolean type.
• string selNm2VlS( const string &name ); — Get the value of string type from the selectable name name.
• int64_t selNm2VlI( const string &name ); — Get the value of integer type from the selectable name name.
• double selNm2VlR( const string &name ); — Get the value of real type from the selectable name name.
• bool selNm2VlB( const string &name ); — Get the value of boolean type from the selectable name name.
• XMLNode *cntrCmdMake( XMLNode *opt, const string &path, int pos, const string &user = "root", const string &grp = "root", int perm = 0664 ); — Create a form element in accordance with the parameters of the cell.

13.5 The object which preacts about changing of the structure (TValElem)

Protected methods:

• virtual void detElem( TElem *el ); — Notification by the element el of the container about it's wish to detach.
• virtual void addFld( TElem *el, unsigned id ) = 0; — Notification about the addition of the cell id of the element el.
• virtual void delFld( TElem *el, unsigned id ) = 0; — Notification about the deleting of the cell id of the element el.

13.6 Data cell (TVariant)

Data:
Error values for the different data types (define):

• EVAL_BOOL — Error value of the boolean type (2);
• EVAL_INT — Error value of the integer type (-2147483647);
• EVAL_REAL — Error value of the real type (-3.3E308);
• EVAL_STR — Error value of the string type ("<EVAL>").
• EVAL_INT16 — Error value of the integer 16 type (-32767);
• EVAL_INT32 — Error value of the integer 32 type (-2147483647);
• EVAL_INT64 — Error value of the integer 64 type (-9223372036854775807ll);
• EVAL_RFlt — Error value of the real type Float (-3.29E38);
• EVAL_RDbl — Error value of the real type Double (-1.79E308).

Типы данных (enum — TVariant::Type):

• TVariant::Null — data type and data is not set.
• TVariant::Boolean — boolean type (boolean, 8бит).
• TVariant::Integer — integer type (integer, 32бит).
• TVariant::Real — real type (double).
• TVariant::String — string.
• TVariant::Object — object.

Public methods:

• TVariant( ); — Default constructor.
• TVariant( char ivl ); TVariant( bool ivl ); — Boolean type constructor.
• TVariant( int64_t ivl ); TVariant( int ivl ); — Integer type constructor.
• TVariant( double ivl ); — Real type constructor.
• TVariant( string ivl ); — String type constructor.
• TVariant( const char *var ); — String type constructor.
• TVariant( AutoHD<TVarObj> ivl ); TVariant( TVarObj *ivl ); — Object constructor.
• TVariant( const TVariant &var ); — Copying constructor.
• bool operator==( const TVariant &vr ) const; — Check the object for equality.
• bool operator!=( const TVariant &vr ) const; — Check the object for not equality.
• TVariant &operator=( const TVariant &vr ); — Copy of the object.
• bool isNull( ) const; — Signs that the object is not initiated.
• bool isEVal( ) const; — Value into the object is error.
• Type type( ) const; — Value's type.
• void setType( Type tp, bool fix = false, bool stdStringOmit = false ); — Set type tp for fixing it fix and use as constant allow stdStringOmit.
• bool isModify( ); — Modification flag. It serves in the object functions to indicate the modification of variables.
• void setModify( bool vl = true ); — Set of the modification flag.
• virtual char getB( ) const; operator char( ); — Getting the value as the boolean one.
• virtual int64_t getI( ) const; operator int64_t( ); operator int( ); — Getting the value as the integer one.
• virtual double getR( ) const; operator double( ); — Getting the value as the real one.
• virtual string getS( ) const; operator string( ); — Getting the value as the string one.
• virtual AutoHD<TVarObj> getO( ) const; operator AutoHD<TVarObj>( ); — Getting the object.
• virtual void setB( char val ); — Set to the value the boolean one.
• virtual void setI( int64_t val ); — Set to the value the integer one.
• virtual void setR( double val ); — Set to the value the real one.
• virtual void setS( const string &val ); — Set to the value the string one.
• virtual void setO( AutoHD<TVarObj> val ); — Set the object.

13.7 User object (TVarObj)

Public methods:

• TVarObj( ); — Constructor.
• int connect( ); — Connection to the object.
• int disconnect( ); — Disconnection from the object.
• virtual void propList( vector<string> &ls ); — Object's properties list ls.
• virtual TVariant propGet( const string &id ); — Request of the object property with an ID id.
• TVariant propGet( const string &ids, char sep ); — Request of the object hierarchical property with a path ids and separator sep.
• virtual void propSet( const string &id, TVariant val ); — Set the object property with an ID id to the value val.
• void propSet( const string &ids, char sep, TVariant val ); — Set the object hierarchical property with a path ids and separator sep to the value val.
• void propClear( const string &ids = "" ); — Property ids clear or all properties clear for empty ids.
• virtual string getStrXML( const string &oid = "" ); — Conversion of the contents of the object in the XML flow.
• static AutoHD<TVarObj> parseStrXML( const string &str, XMLNode *nd = NULL, AutoHD<TVarObj> prev = NULL ); — Backward serialization for XML-stream to object.
• virtual TVariant funcCall( const string &id, vector<TVariant> &prms ); — Call of the object function with the ID id and with the parameters prms.

14 The control interface of OpenSCADA and the dynamic tree of the control nodes (TCntrNode)

For complete coverage of the key components of the system by the network of the same structure objects the object of the dynamic tree node TCntrNode is provided. This objects provides the following functions:

• providing of the uniform access to system components, including the blocks of the dynamic access;
• building the distributed control interface.

Any object that has the need to provide dynamic access to itself or its components must be inherited from the object of the dynamic tree node TCntrNode. This relationship is automatically includes the node into the dynamic tree of objects covered by both: the direct and the reverse links, and also provides an opportunity to create containers for its own child nodes. In addition to this node is able to preact the inclusion and exclusion/remove of the node from the tree with the possibility of reject from the exclusion/removal.

The control interface of the system is included into the TCntrNode object and, accordingly, covers all the nodes of the dynamic tree of the system, allowing you to consistently manage the system regardless of the client tool used. The control interface of the system is based on the markup language XML. You can think of many ways to use control interface of system, as an example, we'll note the following most meaningful solutions:

• Web interface of the configuration ;
• GUI configuration interface (QT, GTK+, ...);
• reflection of the configuration in the network for distributed management of multiple OpenSCADA-stations from the single management area;
• using as the protocol for objects' data access from the network;
• provision of service functions to access of the exterior application and the single OpenSCADA components to the internal data.

The control interface of the system is implemented by the following components:

• information structure of the user configuration page;
• dynamic part in the form of requests for getting, modification of data and service requests;
• container or group of the above elements.

Information hierarchical structure contains information about public control elements and can be used to build custom dialogs for the node's control of the system.

The dynamic part contains the scripts of requests' to the control elements service which are described in the information structure; as well as hidden control elements in the form of service functions used for unified access to the node.

The container can also gather into the single request several information structures and dynamic parts, thereby optimizing the time of the request especially on the high latency network interfaces.

Overall control interface is built from individual components of the dynamic tree. Hierarchical inheritance from the TCntrNode object allows to realize multi-level addition of the configuration of the control interface. General view of the dynamic node tree is shown in Fig. 8.

Fig. 8. Example of a dynamic tree of the nodes in OpenSCADA.

<CntrReqs path="/sub_DAQ/cntr_gate">
  <get path="/%2fprm%2fcfg%2fNAME"/>
  <get path="/%2fprm%2fcfg%2fDESCR"/>
  <list path="/%2fserv%2fattr"/>
</CntrReqs>

<branches id='br'>
  <grp id='/br/in_' descr='Input transport' acs='52'/>
  <grp id='/br/out_' descr='Output transport' acs='52'/>
</branches>

<area id="base" dscr="Base information">
  <fld id="host" dscr="Host name" tp="str"/>
  <fld id="user" dscr="Operated user" tp="str"/>
  <fld id="sys" dscr="Station system" tp="str"/>
  <area id="other" dscr="Other options">
     <fld id="val" dscr="Value" tp="real"/>
  </area>
</area>

<fld id="host" dscr="Host name" tp="str"/>
<fld id="user" dscr="Operated user" tp="str"/>
<fld id="sys" dscr="Station system" tp="str"/>

<rule expr="\b(if|else|for|while|in|using|new|var|break|continue|return|Array|Object)\b" color="darkblue" font_weight="1"/>
<rule expr="(\?|\:)" color="darkblue" font_weight="1"/>
<rule expr="(\b0[xX][0-9a-fA-F]*\b|\b[+-]?[0-9]*\.?[0-9]+[eE]?[-+]?[0-9]*\b|\btrue\b|\bfalse\b)" color="blue"/>
<rule expr=""[^"]*"" color="darkgreen"/>
<rule expr="//[^\n]*" color="gray" font_italic="1"/>
<blk beg="/\\*" end="\\*/" color="gray" font_italic="1"/>

<list id="mod_auto" dscr="List of shared libs(modules)" tp="str" dest="file"/>

<table id="a_mess" key="0" col_lst="0;1;2">
  <list id="0" dscr="Id" acs="36" tp="str"/>
  <list id="1" dscr="Name" acs="52" tp="str"/>
  <list id="2" dscr="Type" acs="52" tp="str"/>
  <list id="3" dscr="Hide" acs="52" tp="bool"/>
</table>

<img id="ico" descr="Page icon"/>

<comm id="add">
  <fld id="tm" tp="time"/>
  <fld id="cat" tp="str"/>
  <fld id="lvl" tp="dec" min="0" max="7"/>
  <fld id="mess" tp="str"/>
</comm>

<set path="/fld_teg" user="user"/>
  <fld id="tm">1023456244</fld>
  <fld id="cat">*</fld>
  <fld id="lvl">2</fld>
  <fld id="mess">Test mess</fld>
</set>

<get path="/fld_teg" user="user" tp="lnk"/>"

<list id="k_br" dscr="Kernel branches" tp="br"/>

<oscada_cntr>
  <area id="a_gen" dscr="Generic control">
    <fld id="config" dscr="Config file" tp="str" dest="file"/>
    <fld id="cr_file_perm" dscr="Files" tp="oct" len="3"/>
    <fld id="cr_dir_perm" dscr="Directories" tp="oct" len="3"/>
    <comm id="upd_opt" dscr="Update options(from config)"/>
    <comm id="quit" dscr="Quit"/>
  </area>
  <area id="a_kern" dscr="Kernels">
    <list id="k_br" dscr="Kernels" tp="br"/>
  </area>
</oscada_cntr>

34.5678
23.6543
65.8754
34.6523

0 34.5678
1 23.6543
4 65.8754
6 34.6523

//================== CUT =========================
extern "C"
{
#ifdef MOD_INCL
    //Need for define only at case builtin to OpenSCADA core support by the module
    TModule::SAt bd_DBF_module( int n_mod )
#else
    TModule::SAt module( int n_mod )
#endif
    {
	//Allowed into the shared object the modules descriptors forming
    }

#ifdef MOD_INCL
    //Need for define only at case builtin to OpenSCADA core support by the module
    TModule *bd_Tmpl_attach( const TModule::SAt &AtMod, const string &source )
#else
    TModule *attach( const TModule::SAt &AtMod, const string &source )
#endif
    {
	//Selected module connect
    }
}
//================== CUT =========================