dbdefs.h

Go to the documentation of this file.

/* dbdefs.h */
/* $Id: dbdefs.h,v 1.18 2009/03/27 09:39:08 vlad Exp $ */

/*********************************************************************
 *
 * UNIVERS
 * (C) ¾¾¾ "³µ¾²µÀÁ", 2001
 *
 * ²áÕ ßàÐÒÐ ×ÐéØéÕÝë *
 * ¸áßÞÛì×ÞÒÐÝØÕ, ÚÞßØàÞÒÐÝØÕ ØÛØ ßÕàÕÔÐçÐ àÕÓãÛØàãîâáï ×ÐÚÞÝÐÜØ
 * ÀÞááØÙáÚÞÙ ÄÕÔÕàÐæØØ "¾Ñ ÐÒâÞàáÚÞÜ ßàÐÒÕ Ø áÜÕÖÝëå ßàÐÒÐå", "¾
 * ßàÐÒÞÒÞÙ ÞåàÐÝÕ ßàÞÓàÐÜÜ ÔÛï íÛÕÚâàÞÝÝëå ÒëçØáÛØâÕÛìÝëå ÜÐèØÝ Ø ÑÐ×
 * ÔÐÝÝëå"
 *
 * Encoding: ISO-8859-5 (GOST)
 *
 *********************************************************************/

#ifndef __dbdefs_h
#define __dbdefs_h

/** \file
 ***********************************************************************
 *
 * »ÞÚÐÛìÝÐï ±Ð×Ð ´ÐÝÝëå (ÒÕàáØï 4)
 * ¾ßàÕÔÕÛÕÝØï, ÞßØáÐÝØï Ø äÞàÜÐâë ÔÐÝÝëå.
 *
 ***********************************************************************/

#include <mix/Types.h>
#include <mix/units.h>
#include <mix/wenv.h>


/** ´ÛØÝÐ ØÔÕÝâØäØÚÐâÞàÐ Ò »±´ ÑÕ× ßàØ×ÝÐÚÐ ÚÞÝæÐ áâàÞÚØ. */
#define DB_IDENT_LEN        15

/** ¸Üï äÐÙÛÐ ÔÕáÚàØßâÞàÞÒ ßÞ ãÜÞÛçÐÝØî. */
#define DB_DESC_FILE        "ttdesc.4db"

/** ¸Üï ßÕàÕÜÕÝÝÞÙ ÞÚàãÖÕÝØï, Ò ÚÞâÞàÞÙ ×ÐÔÐÕâáï ßãâì Ú äÐÙÛã ÔÕáÚàØßâÞàÞÒ. */
#define DBDFILE_ENV     "DBDFILE"


/** @name dbdebug
 * \brief 
 ***********************************************************************
 * ¾âÛÐÔÞçÝëÕ ßÕàÕÜÕÝÝëÕ ÞÚàãÖÕÝØï
 ***********************************************************************/

/**
 ***********************************************************************
 * ´Ûï æÕÛÕÙ ÞâÛÐÔÚØ ßàÞÓàÐÜÜ, ØáßÞÛì×ãîéØå »±´4 ÜÞÖÝÞ ßàØáÒÞØâì
 * ßÕàÕÜÕÝÝÞÙ ÞÚàãÖÕÝØï DBDEBUG çØáÛÞÒÞÕ ×ÝÐçÕÝØÕ, ßÞÚÐ×ëÒÐîéÕÕ,
 * ÚÐÚÞÙ áÕàìÕ×ÝÞáâØ áÞÞÑéÕÝØï Þ ÒÝãâàÕÝÝÕÙ àÐÑÞâÕ ßàÞæÕÔãà »±´ áÛÕÔãÕâ
 * áÞÞÑéÐâì.  ÁÞÞâÒÕâáâÒØÕ çØáÛÞÒëå ÚÞÔÞÒ Ø áÕÜÐÝâØÚØ ßàØÒÞÔØâáï ÝØÖÕ:
 * EL_FATAL 0 - äÐâÐÛìÝëÕ ÞèØÑÚØ, ÒÛØïîéØÕ ÝÐ àÐÑÞâÞáßÞáÞÑÝÞáâì »±´;
 * EL_ERROR 1 - áÕàìÕ×ÝëÕ ÞèØÑÚØ ßàØ àÐÑÞâÕ á »±´ Ø× ßàØÚÛ.ßàÞÓàÐÜÜ;
 * EL_WARNING   2 - ßàÕÔãßàÕÖÔÕÝØï Þ "ßÞáâãßÚÐå" ßàÞæÕÔãà »±´;
 * EL_INFO  3 - ÝÕÙâàÐÛìÝÐï ØÝäÞàÜÐæØï ßàØ àÐÑÞâÕ á »±´;
 * EL_HINT  4 - áÞÞÑéÕÝØï Þ ÒëßÞÛÝïÕÜëå ÞßÕàÐæØïå;
 * EL_DEBUG 5 - ÞâÛÐÔÞçÝëÕ áÞÞÑéÕÝØï Ø× ÒÝãâàÕÝÝÕÙ ÚãåÝØ »±´.
 ***********************************************************************/

/* @{ */

/** ¸Üï ßÕàÕÜÕÝÝÞÙ ÞÚàãÖÕÝØï, ØáßÞÛì×ãÕÜÞÙ ÔÛï ×ÐÔÐÝØï
   çØáÛÞÒÞÓÞ ãàÞÒÝï ÞèØÑÚØ: áÜ. EL_internal_*. */
#define DBDEBUG     "DBDEBUG"

/* ÁßÕæØÐÛìÝëÕ ãàÞÒÝØ áÕàìÕ×ÝÞáâØ ÒÝãâàÕÝÝØå áÞÞÑéÕÝØÙ »±´. */
#define EL_internal_FATAL   10/*!< äÐâÐÛìÝëÕ ÞèØÑÚØ, ÒÛØïîéØÕ ÝÐ
                                    àÐÑÞâÞáßÞáÞÑÝÞáâì »±´ */
#define EL_internal_ERROR   11/*!< áÕàìÕ×ÝëÕ ÞèØÑÚØ ßàØ àÐÑÞâÕ á
                                    »±´ Ø× ßàØÚÛ.ßàÞÓàÐÜÜ */
#define EL_internal_WARNING 12/*!< ÔãßàÕÖÔÕÝØï Þ "ßÞáâãßÚÐå"
                                    ßàÞæÕÔãà »±´ */
#define EL_internal_INFO    13/*!< ÝÕÙâàÐÛìÝÐï ØÝäÞàÜÐæØï ßàØ
                                    àÐÑÞâÕ á »±´ */
#define EL_internal_HINT    14/*!< áÞÞÑéÕÝØï Þ ÒëßÞÛÝïÕÜëå ÞßÕàÐæØïå */
#define EL_internal_DEBUG   15/*!< ÞâÛÐÔÞçÝëÕ áÞÞÑéÕÝØï Ø×
                                    ÒÝãâàÕÝÝÕÙ ÚãåÝØ »±´ */


/** ÃàÞÒÕÝì áÕàìÕ×ÝÞáâØ ÒëÔÐÒÐÕÜëå áÞÞÑéÕÝØÙ ßÞ ãÜÞÛçÐÝØî */
#define DBDLDEFAULT EL_ERROR

/** ¸Üï ßÕàÕÜÕÝÝÞÙ ÞÚàãÖÕÝØï, ØáßÞÛì×ãÕÜÞÙ ÔÛï ×ÐÔÐÝØï
   ØÜÕÝØ äÐÙÛÐ ßàÞâÞÚÞÛÐ. */
#define DBLOGFILE   "DBLOGFILE"

/** ¸Üï ßÕàÕÜÕÝÝÞÙ ÞÚàãÖÕÝØï, ØáßÞÛì×ãÕÜÞÙ ÔÛï ×ÐÔÐÝØï
   ØÜÕÝØ ßàÞâÞÚÞÛÐ ÞßÕàÐæØÙ. */
#define DBOPERLOGFILE   "DBOPERLOGFILE"

/* @} */

/**
 ***********************************************************************
 * ÁâàãÚâãàÐ ×ÐÓÞÛÞÒÚÐ äÐÙÛÐ ÔÐÝÝëå »±´ (ÒÕàáØï 4).
 * ² ×ÐÓÞÛÞÒÚÕ äÐÙÛÐ ÝÕ ãßÞÜØÝÐÕâáï ØÜï âØßÐ âÐÑÛØæë Ø ØÜÕÝÐ Ø âØßë
 * ÔÞÜÕÝÞÒ.  ¸×ÒÕáâÝÞ âÞÛìÚÞ ÚÞÛØçÕáâÒÞ áâÞÛÑæÞÒ Ø áâàÞÚ, Ð âÐÚÖÕ
 * àÐ×ÜÕà, ×ÐÝØÜÐÕÜëÙ áâàÞÚÞÙ Ø ÐâàØÑãâë ÚÐÖÔÞÓÞ áâÞÛÑæÐ (ÔÞÜÕÝÐ).

 <pre>
 DbFileHeader:
 +0 [Char] (4)      ÁØÓÝÐâãàÐ "@D4"
 +4 [Int4]      ¼ÐÓØçÕáÚÞÕ çØáÛÞ ÔÛï ÞßàÕÔ. Big/Little Endian
 +8 [Char] (16)     ¸Üï âØßÐ âÐÑÛØæë
 +24 [Int4]      ÀÐ×ÜÕà ×ÐßØáØ (áâàÞÚØ âÐÑÛØæë) Ò ÑÐÙâÐå
 +28 [Int4]     ºÞÛØçÕáâÒÞ áâàÞÚ Ò âÐÑÛØæÕ
 +32 [Int4]     ºÞÛØçÕáâÒÞ ÔÞÜÕÝÞÒ

 DbFileDomainAttr:  ßÞÒâÞàïÕâáï ßÞ ÚÞÛØçÕáâÒã ÔÞÜÕÝÞÒ:
 +36 [Int4]     °âàØÑãâë ÔÞÜÕÝÞÒ

 +??            ßÞÒâÞàïÕâáï ßÞ ÚÞÛØçÕáâÒã áâàÞÚ:

 +??+0          1-ëÙ ßÞ áçÕâã ÔÞÜÕÝ áâàÞÚØ #0
 +??+?          2-ëÙ ßÞ áçÕâã ÔÞÜÕÝ áâàÞÚØ #0
 ...

 +??+0          1-ëÙ ßÞ áçÕâã ÔÞÜÕÝ áâàÞÚØ #1
 +??+?          2-ëÙ ßÞ áçÕâã ÔÞÜÕÝ áâàÞÚØ #1
 ...
 </pre>
 ***********************************************************************/
typedef struct
{
#define DBD_SIGNATURE_VER4  "@D4"
  Char  signature[4];   /*!< ÁØÓÝÐâãàÐ "@D4", ÓÔÕ 4 - ÝÞÜÕà ÒÕàáØØ */

#define DBD_MAGIC_BYTES "\x87\x65\x43\x21"
#define DBD_MAGIC_HEX   (0x87654321UL)
#define DBD_MAGIC_DEC   (-2023406815L)
  Int4  magic;      /*!< ¿àÞÒÕàÚÐ ßÞàïÔÚÐ ÑØâÞÒ Ø ÑÐÙâÞÒ Ò áÛÞÒÕ;
               Ò èÕáâÝÐÔæÐâÕàØçÝÞÜ ÒØÔÕ 0x87654321,
               Ò ÔÕáïâØçÝÞÜ ÒØÔÕ -2023406815 */

  Char  ttname[DB_IDENT_LEN+1]; /* ¸Üï âØßÐ âÐÑÛØæë */
  Int4  recsize;    /*!< ÀÐ×ÜÕà ×ÐßØáØ (áâàÞÚØ âÐÑÛØæë) Ò ÑÐÙâÐå */
  Int4  line_cnt;   /*!< ºÞÛØçÕáâÒÞ áâàÞÚ Ò âÐÑÛØæÕ (0..) */
  Int4  dmn_cnt;    /*!< ºÞÛØçÕáâÒÞ ÔÞÜÕÝÞÒ */

}   DbFileHeader;


/**
 ***********************************************************************
 * °âàØÑãâë ÔÞÜÕÝÐ Ò äÐÙÛÕ ÔÐÝÝëå »±´.
 ***********************************************************************/
typedef struct
{
  Int4  unit;       /*!< ÄØ×ØçÕáÚÐï ÒÕÛØçØÝÐ ×ÝÐçÕÝØÙ ÔÞÜÕÝÐ */

}   DbFileDomainAttr;


/**
 ***********************************************************************
 * ¾ßØáÐÝØÕ ÔÞÜÕÝÐ Ò ßÐÜïâØ.
 ***********************************************************************/
typedef struct
{
  Char  dname[DB_IDENT_LEN+1];  /*!< ¸Üï ÔÞÜÕÝÐ (áâÞÛÑæÐ âÐÑÛØæë) */
  AtomType  atype;      /*!< ÂØß ×ÝÐçÕÝØï ÔÞÜÕÝÐ */
  Int4      dim;        /*!< ÀÐ×ÜÕàÝÞáâì ÔÞÜÕÝÐ Ò ×ÝÐçÕÝØïå */
  CategoryId    categ;      /*!< ºÐâÕÓÞàØï äØ×.ÒÕÛØçØÝë */
  Int4      offset;     /*!< ÁÜÕéÕÝØÕ ßÞÛï Ò ×ÐßØáØ äÐÙÛÐ Ò ÑÐÙâÐå
                   (ÒëçØáÛïÕâáï ßÞ àÐ×ÜÕàã ßàÕÔëÔãéØå
                   ÔÞÜÕÝÞÒ ÐÒâÞÜÐâØçÕáÚØ) */
}   DbDomainDesc;


/** @name 4DMNDESC
 ***********************************************************************
 * ¾ßØáÐÝØÕ áâàãÚâãàë ×ÐßØáØ Ò äÐÙÛÕ ÞßØáÐâÕÛÕÙ.
 * TT_4* Ø DT_4* ÒÒÞÔïâáï ÔÛï âÞÓÞ, çâÞÑë Ø×ÑÕÖÐâì ÚÞÝäÛØÚâÐ á ÔàãÓØÜØ
 * ØÜÕÝÐÜØ ÔÞÜÕÝÞÒ Ø âÐÑÛØæ, ÚÞâÞàëÕ ÜÞÖÕâ ÞÑêïÒØâì ßÞÛì×ÞÒÐâÕÛì.
 ***********************************************************************/
/* @{ */
#define TT_4DMNDESC "4DMNDESC"
#define DT_4TTNAME  "4TTNAME"
#define DT_4DNAME   "4DNAME"
#define DT_4ATYPE   "4ATYPE"
#define DT_4DIM     "4DIM"
#define DT_4CATEG   "4CATEG"

/*                      dname       atype  dim             categ    offset */
#define DMNDESC_4TTNAME DT_4TTNAME, CHAR_1,  DB_IDENT_LEN+1, UC_NONE, 0
#define DMNDESC_4DNAME  DT_4DNAME,  CHAR_1,  DB_IDENT_LEN+1, UC_NONE, 0
#define DMNDESC_4ATYPE  DT_4ATYPE,  INT_4, 1,              UC_NONE, 0
#define DMNDESC_4DIM    DT_4DIM,    INT_4, 1,              UC_NONE, 0
#define DMNDESC_4CATEG  DT_4CATEG,  INT_4, 1,              UC_NONE, 0
/* @} */


/***********************************************************************
 *
 * ¾ßØáÐÝØÕ ßàÞçØå áÛãÖÕÑÝëå âØßÞÒ âÐÑÛØæ
 *
 ***********************************************************************/

/** @name 4LOCK
 * ÂÐÑÛØæÐ ÑÛÞÚØàÞÒÞÚ ÔÞáâãßÐ Ú ÞÑêÕÚâÐÜ ÔÐÝÝëå
 */
/* @{ */
#define TT_4LOCK    "4LOCK"
#define DT_4ID      "4ID"
#define DT_4TYPE    "4TYPE"
#define DT_4MOMENT  "4MOMENT"
#define DT_4APPNAME "4APPNAME"
#define DT_4OWNER   "4OWNER"
#define DT_4WORKPLACE   "4WORKPLACE"
#define DT_4HOST    "4HOST"
#define DT_4PID     "4PID"

/*                      dname          atype  dim            categ    offset */
#define DD_4ID      DT_4ID,        INT_4, 1,             UC_NONE, 0
#define DD_4MOMENT  DT_4MOMENT,    CHAR_1,  MOMENT_LEN+1,  UC_NONE, 0
#define DD_4TYPE    DT_4TYPE,      CHAR_1,  3,             UC_NONE, 0
#define DD_4APPNAME DT_4APPNAME,   CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4OWNER   DT_4OWNER,     CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4WORKPLACE   DT_4WORKPLACE, CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4HOST    DT_4HOST,      CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4PID     DT_4PID,       INT_4, 1,             UC_NONE, 0
/* @} */


/** @name 4HISTORY
 * ÂÐÑÛØæÐ ØáâÞàØØ ÞÑàÐÑÞâÚØ ßàÞÕÚâÐ
 */
/* @{ */
#define TT_4HISTORY "4HISTORY"
#define DT_4TIMESTAMP   "4TIMESTAMP"
/* already defined
#define DT_4APPNAME "4APPNAME"*/
#define DT_4JOBNUM  "4JOBNUM"
#define DT_4USER    "4USER"
#define DT_4DATAREF "4DATAREF"
#define DT_4EVENT   "4EVENT"
/* already defined
#define DT_4MOMENT  "4MOMENT"
#define DT_4WORKPLACE   "4WORKPLACE"
#define DT_4HOST    "4HOST"*/

/*                      dname          atype  dim            categ    offset */
#define DD_4TIMESTAMP   DT_4TIMESTAMP, INT_4, 1,             UC_NONE, 0
#define DD_4EVENT   DT_4EVENT,     CHAR_1,  256,           UC_NONE, 0
/* already defined
#define DD_4APPNAME DT_4APPNAME,   CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0*/
#define DD_4JOBNUM  DT_4JOBNUM,    INT_4, 1,             UC_NONE, 0
#define DD_4USER    DT_4USER,      CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4DATAREF DT_4DATAREF,   DBTPTR,1,             UC_NONE, 0
/* already defined
#define DD_4MOMENT  DT_4MOMENT,    CHAR_1,  MOMENT_LEN+1,  UC_NONE, 0
#define DD_4WORKPLACE   DT_4WORKPLACE, CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4HOST    DT_4HOST,      CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0*/
/* @} */


#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */


/** ¸ÝØæØÐÛØ×ÐæØï àÕÓØáâàÐ ßàØÚÛÐÔÝëå âØßÞÒ âÐÑÛØæ.  ¼ÞÖÕâ Òë×ëÒÐâìáï
   ÜÝÞÓÞÚàÐâÝÞ ÑÕ× ãéÕàÑÐ ÔÛï ÑëáâàÞÔÕÙáâÒØï Ø ÛÞÓØÚØ àÐÑÞâë »±´. */
void    dbAppInitialize ();

/** ¸ÝØæØÐÛØ×ØàãÕâ ãÚÐ×ÐÝÝãî ÞÑÛÐáâì ßÐÜïâØ ãÜÞÛçÐâÕÛìÝëÜ ×ÝÐçÕÝØÕÜ
   ÔÐÝÝÞÓÞ âØßÐ. */
void    dbFillEmpty (void* ptr, DbDomainDesc* dd);

/** ¿àÞÒÕàïÕâ ãÚÐ×ÐÝÝãî ÞÑÛÐáâì ßÐÜïâØ ÝÐ ãÜÞÛçÐâÕÛìÝëÕ ×ÝÐçÕÝØï
   ÔÐÝÝÞÓÞ âØßÐ. */
Logic   dbCheckEmpty (void* ptr, DbDomainDesc* dd);


/**
 ***********************************************************************
 * ´Ûï æÕÛÕÙ ÞâÛÐÔÚØ ßàÞÓàÐÜÜ, ØáßÞÛì×ãîéØå »±´4 ÜÞÖÝÞ ßàØáÒÞØâì
 * ßÕàÕÜÕÝÝÞÙ ÞÚàãÖÕÝØï DBDEBUG çØáÛÞÒÞÕ ×ÝÐçÕÝØÕ, ßÞÚÐ×ëÒÐîéÕÕ,
 * ÚÐÚÞÙ áÕàìÕ×ÝÞáâØ áÞÞÑéÕÝØï Þ ÒÝãâàÕÝÝÕÙ àÐÑÞâÕ ßàÞæÕÔãà »±´ áÛÕÔãÕâ
 * áÞÞÑéÐâì.  ÁÞÞâÒÕâáâÒØÕ çØáÛÞÒëå ÚÞÔÞÒ Ø áÕÜÐÝâØÚØ ßàØÒÞÔØâáï ÝØÖÕ:
 * EL_FATAL 0 - äÐâÐÛìÝëÕ ÞèØÑÚØ, ÒÛØïîéØÕ ÝÐ àÐÑÞâÞáßÞáÞÑÝÞáâì »±´;
 * EL_ERROR 1 - áÕàìÕ×ÝëÕ ÞèØÑÚØ ßàØ àÐÑÞâÕ á »±´ Ø× ßàØÚÛ.ßàÞÓàÐÜÜ;
 * EL_WARNING   2 - ßàÕÔãßàÕÖÔÕÝØï Þ "ßÞáâãßÚÐå" ßàÞæÕÔãà »±´;
 * EL_INFO  3 - ÝÕÙâàÐÛìÝÐï ØÝäÞàÜÐæØï ßàØ àÐÑÞâÕ á »±´;
 * EL_HINT  4 - áÞÞÑéÕÝØï Þ ÒëßÞÛÝïÕÜëå ÞßÕàÐæØïå;
 * EL_DEBUG 5 - ÞâÛÐÔÞçÝëÕ áÞÞÑéÕÝØï Ø× ÒÝãâàÕÝÝÕÙ ÚãåÝØ »±´.
 ***********************************************************************/

/** ÄãÝÚæØï ×ÐÜÕÝïÕâ wePutMsg() á æÕÛìî ÝÕ ÒëÒÞÔØâì ÝÐ ßÕçÐâì áÞÞÑéÕÝØï á
   ãàÞÒÝÕÜ áÕàìÕ×ÝÞáâØ ÑÞÛìèÕ dbDebugLevel.  ÂÐÚØÜ ÞÑàÐ×ÞÜ, ÕáÛØ 
   dbDebugLevel == 0, âÞ ÑãÔãâ ßÕçÐâÐâìáï âÞÛìÚÞ áÞÞÑéÕÝØï áÕàìÕ×ÝÞáâØ
   EL_FATAL.  µáÛØ == 1, âÞ EL_FATAL Ø EL_ERROR Ø â.Ô. */
void    dbPutMsg (int elevel, const char* msg);

/** ÄãÝÚæØï ×ÐÜÕÝïÕâ weFormatMsg() á æÕÛìî ÝÕ ÒëÒÞÔØâì ÝÐ ßÕçÐâì
   áÞÞÑéÕÝØï á ãàÞÒÝÕÜ áÕàìÕ×ÝÞáâØ ÑÞÛìèÕ dbDebugLevel. */
void    dbFormatMsg (int elevel, const char* format, ...);


/** ÄãÝÚæØï ÒëÒÞÔØâ ãÚÐ×ÐÝÝãî áâàÞÚã Ò äÐÙÛ ßàÞâÞÚÞÛÐ ÞßÕàÐæØÙ. */
void    dbOperLog (const char* format, ...);


/** Return name of directory for temporal data base objects. */
const char* dbTempDir ();


#ifdef __cplusplus
};
#endif /* __cplusplus */


#endif /* dbdefs.h */

 *
 * ¸áßÞÛì×ÞÒÐÝØÕ, ÚÞßØàÞÒÐÝØÕ ØÛØ ßÕàÕÔÐçÐ àÕÓãÛØàãîâáï ×ÐÚÞÝÐÜØ
 * ÀÞááØÙáÚÞÙ ÄÕÔÕàÐæØØ "¾Ñ ÐÒâÞàáÚÞÜ ßàÐÒÕ Ø áÜÕÖÝëå ßàÐÒÐå", "¾ * ßàÐÒÞÒÞÙ ÞåàÐÝÕ ßàÞÓàÐÜÜ ÔÛï íÛÕÚâàÞÝÝëå ÒëçØáÛØâÕÛìÝëå ÜÐèØÝ Ø ÑÐ×
 * ÔÐÝÝëå"
 *
 * Encoding: ISO-8859-5 (GOST)
 *
 *********************************************************************/

#ifndef __dbdefs_h
#define __dbdefs_h

/** \file
 ***********************************************************************
 *
 * »ÞÚÐÛìÝÐï ±Ð×Ð ´ÐÝÝëå (ÒÕàáØï 4)
 * ¾ßàÕÔÕÛÕÝØï, ÞßØáÐÝØï Ø äÞàÜÐâë ÔÐÝÝëå.
 *
 ***********************************************************************/

#include <mix/Types.h>
#include <mix/units.h>
#include <mix/wenv.h>


/** ´ÛØÝÐ ØÔÕÝâØäØÚÐâÞàÐ Ò »±´ ÑÕ× ßàØ×ÝÐÚÐ ÚÞÝæÐ áâàÞÚØ. */
#define DB_IDENT_LEN        15

/** ¸Üï äÐÙÛÐ ÔÕáÚàØßâÞàÞÒ ßÞ ãÜÞÛçÐÝØî. */
#define DB_DESC_FILE        "ttdesc.4db"

/** ¸Üï ßÕàÕÜÕÝÝÞÙ ÞÚàãÖÕÝØï, Ò ÚÞâÞàÞÙ ×ÐÔÐÕâáï ßãâì Ú äÐÙÛã ÔÕáÚàØßâÞàÞÒ. */
#define DBDFILE_ENV     "DBDFILE"


/** @name dbdebug
 * \brief 
 ***********************************************************************
 * ¾âÛÐÔÞçÝëÕ ßÕàÕÜÕÝÝëÕ ÞÚàãÖÕÝØï
 ***********************************************************************/

/**
 ***********************************************************************
 * ´Ûï æÕÛÕÙ ÞâÛÐÔÚØ ßàÞÓàÐÜÜ, ØáßÞÛì×ãîéØå »±´4 ÜÞÖÝÞ ßàØáÒÞØâì
 * ßÕàÕÜÕÝÝÞÙ ÞÚàãÖÕÝØï DBDEBUG çØáÛÞÒÞÕ ×ÝÐçÕÝØÕ, ßÞÚÐ×ëÒÐîéÕÕ,
 * ÚÐÚÞÙ áÕàìÕ×ÝÞáâØ áÞÞÑéÕÝØï Þ ÒÝãâàÕÝÝÕÙ àÐÑÞâÕ ßàÞæÕÔãà »±´ áÛÕÔãÕâ
 * áÞÞÑéÐâì.  ÁÞÞâÒÕâáâÒØÕ çØáÛÞÒëå ÚÞÔÞÒ Ø áÕÜÐÝâØÚØ ßàØÒÞÔØâáï ÝØÖÕ:
 * EL_FATAL 0 - äÐâÐÛìÝëÕ ÞèØÑÚØ, ÒÛØïîéØÕ ÝÐ àÐÑÞâÞáßÞáÞÑÝÞáâì »±´;
 * EL_ERROR 1 - áÕàìÕ×ÝëÕ ÞèØÑÚØ ßàØ àÐÑÞâÕ á »±´ Ø× ßàØÚÛ.ßàÞÓàÐÜÜ;
 * EL_WARNING   2 - ßàÕÔãßàÕÖÔÕÝØï Þ "ßÞáâãßÚÐå" ßàÞæÕÔãà »±´;
 * EL_INFO  3 - ÝÕÙâàÐÛìÝÐï ØÝäÞàÜÐæØï ßàØ àÐÑÞâÕ á »±´;
 * EL_HINT  4 - áÞÞÑéÕÝØï Þ ÒëßÞÛÝïÕÜëå ÞßÕàÐæØïå;
 * EL_DEBUG 5 - ÞâÛÐÔÞçÝëÕ áÞÞÑéÕÝØï Ø× ÒÝãâàÕÝÝÕÙ ÚãåÝØ »±´.
 ***********************************************************************/

/* @{ */

/** ¸Üï ßÕàÕÜÕÝÝÞÙ ÞÚàãÖÕÝØï, ØáßÞÛì×ãÕÜÞÙ ÔÛï ×ÐÔÐÝØï
   çØáÛÞÒÞÓÞ ãàÞÒÝï ÞèØÑÚØ: áÜ. EL_internal_*. */
#define DBDEBUG     "DBDEBUG"

/* ÁßÕæØÐÛìÝëÕ ãàÞÒÝØ áÕàìÕ×ÝÞáâØ ÒÝãâàÕÝÝØå áÞÞÑéÕÝØÙ »±´. */
#define EL_internal_FATAL   10/*!< äÐâÐÛìÝëÕ ÞèØÑÚØ, ÒÛØïîéØÕ ÝÐ
                                    àÐÑÞâÞáßÞáÞÑÝÞáâì »±´ */
#define EL_internal_ERROR   11/*!< áÕàìÕ×ÝëÕ ÞèØÑÚØ ßàØ àÐÑÞâÕ á
                                    »±´ Ø× ßàØÚÛ.ßàÞÓàÐÜÜ */
#define EL_internal_WARNING 12/*!< ÔãßàÕÖÔÕÝØï Þ "ßÞáâãßÚÐå"
                                    ßàÞæÕÔãà »±´ */
#define EL_internal_INFO    13/*!< ÝÕÙâàÐÛìÝÐï ØÝäÞàÜÐæØï ßàØ
                                    àÐÑÞâÕ á »±´ */
#define EL_internal_HINT    14/*!< áÞÞÑéÕÝØï Þ ÒëßÞÛÝïÕÜëå ÞßÕàÐæØïå */
#define EL_internal_DEBUG   15/*!< ÞâÛÐÔÞçÝëÕ áÞÞÑéÕÝØï Ø×
                                    ÒÝãâàÕÝÝÕÙ ÚãåÝØ »±´ */


/** ÃàÞÒÕÝì áÕàìÕ×ÝÞáâØ ÒëÔÐÒÐÕÜëå áÞÞÑéÕÝØÙ ßÞ ãÜÞÛçÐÝØî */
#define DBDLDEFAULT EL_ERROR

/** ¸Üï ßÕàÕÜÕÝÝÞÙ ÞÚàãÖÕÝØï, ØáßÞÛì×ãÕÜÞÙ ÔÛï ×ÐÔÐÝØï
   ØÜÕÝØ äÐÙÛÐ ßàÞâÞÚÞÛÐ. */
#define DBLOGFILE   "DBLOGFILE"

/** ¸Üï ßÕàÕÜÕÝÝÞÙ ÞÚàãÖÕÝØï, ØáßÞÛì×ãÕÜÞÙ ÔÛï ×ÐÔÐÝØï
   ØÜÕÝØ ßàÞâÞÚÞÛÐ ÞßÕàÐæØÙ. */
#define DBOPERLOGFILE   "DBOPERLOGFILE"

/* @} */

/**
 ***********************************************************************
 * ÁâàãÚâãàÐ ×ÐÓÞÛÞÒÚÐ äÐÙÛÐ ÔÐÝÝëå »±´ (ÒÕàáØï 4).
 * ² ×ÐÓÞÛÞÒÚÕ äÐÙÛÐ ÝÕ ãßÞÜØÝÐÕâáï ØÜï âØßÐ âÐÑÛØæë Ø ØÜÕÝÐ Ø âØßë
 * ÔÞÜÕÝÞÒ.  ¸×ÒÕáâÝÞ âÞÛìÚÞ ÚÞÛØçÕáâÒÞ áâÞÛÑæÞÒ Ø áâàÞÚ, Ð âÐÚÖÕ
 * àÐ×ÜÕà, ×ÐÝØÜÐÕÜëÙ áâàÞÚÞÙ Ø ÐâàØÑãâë ÚÐÖÔÞÓÞ áâÞÛÑæÐ (ÔÞÜÕÝÐ).

 <pre>
 DbFileHeader:
 +0 [Char] (4)      ÁØÓÝÐâãàÐ "@D4"
 +4 [Int4]      ¼ÐÓØçÕáÚÞÕ çØáÛÞ ÔÛï ÞßàÕÔ. Big/Little Endian
 +8 [Char] (16)     ¸Üï âØßÐ âÐÑÛØæë
 +24 [Int4]      ÀÐ×ÜÕà ×ÐßØáØ (áâàÞÚØ âÐÑÛØæë) Ò ÑÐÙâÐå
 +28 [Int4]     ºÞÛØçÕáâÒÞ áâàÞÚ Ò âÐÑÛØæÕ
 +32 [Int4]     ºÞÛØçÕáâÒÞ ÔÞÜÕÝÞÒ

 DbFileDomainAttr:  ßÞÒâÞàïÕâáï ßÞ ÚÞÛØçÕáâÒã ÔÞÜÕÝÞÒ:
 +36 [Int4]     °âàØÑãâë ÔÞÜÕÝÞÒ

 +??            ßÞÒâÞàïÕâáï ßÞ ÚÞÛØçÕáâÒã áâàÞÚ:

 +??+0          1-ëÙ ßÞ áçÕâã ÔÞÜÕÝ áâàÞÚØ #0
 +??+?          2-ëÙ ßÞ áçÕâã ÔÞÜÕÝ áâàÞÚØ #0
 ...

 +??+0          1-ëÙ ßÞ áçÕâã ÔÞÜÕÝ áâàÞÚØ #1
 +??+?          2-ëÙ ßÞ áçÕâã ÔÞÜÕÝ áâàÞÚØ #1
 ...
 </pre>
 ***********************************************************************/
typedef struct
{
#define DBD_SIGNATURE_VER4  "@D4"
  Char  signature[4];   /*!< ÁØÓÝÐâãàÐ "@D4", ÓÔÕ 4 - ÝÞÜÕà ÒÕàáØØ */

#define DBD_MAGIC_BYTES "\x87\x65\x43\x21"
#define DBD_MAGIC_HEX   (0x87654321UL)
#define DBD_MAGIC_DEC   (-2023406815L)
  Int4  magic;      /*!< ¿àÞÒÕàÚÐ ßÞàïÔÚÐ ÑØâÞÒ Ø ÑÐÙâÞÒ Ò áÛÞÒÕ;
               Ò èÕáâÝÐÔæÐâÕàØçÝÞÜ ÒØÔÕ 0x87654321,
               Ò ÔÕáïâØçÝÞÜ ÒØÔÕ -2023406815 */

  Char  ttname[DB_IDENT_LEN+1]; /* ¸Üï âØßÐ âÐÑÛØæë */
  Int4  recsize;    /*!< ÀÐ×ÜÕà ×ÐßØáØ (áâàÞÚØ âÐÑÛØæë) Ò ÑÐÙâÐå */
  Int4  line_cnt;   /*!< ºÞÛØçÕáâÒÞ áâàÞÚ Ò âÐÑÛØæÕ (0..) */
  Int4  dmn_cnt;    /*!< ºÞÛØçÕáâÒÞ ÔÞÜÕÝÞÒ */

}   DbFileHeader;


/**
 ***********************************************************************
 * °âàØÑãâë ÔÞÜÕÝÐ Ò äÐÙÛÕ ÔÐÝÝëå »±´.
 ***********************************************************************/
typedef struct
{
  Int4  unit;       /*!< ÄØ×ØçÕáÚÐï ÒÕÛØçØÝÐ ×ÝÐçÕÝØÙ ÔÞÜÕÝÐ */

}   DbFileDomainAttr;


/**
 ***********************************************************************
 * ¾ßØáÐÝØÕ ÔÞÜÕÝÐ Ò ßÐÜïâØ.
 ***********************************************************************/
typedef struct
{
  Char  dname[DB_IDENT_LEN+1];  /*!< ¸Üï ÔÞÜÕÝÐ (áâÞÛÑæÐ âÐÑÛØæë) */
  AtomType  atype;      /*!< ÂØß ×ÝÐçÕÝØï ÔÞÜÕÝÐ */
  Int4      dim;        /*!< ÀÐ×ÜÕàÝÞáâì ÔÞÜÕÝÐ Ò ×ÝÐçÕÝØïå */
  CategoryId    categ;      /*!< ºÐâÕÓÞàØï äØ×.ÒÕÛØçØÝë */
  Int4      offset;     /*!< ÁÜÕéÕÝØÕ ßÞÛï Ò ×ÐßØáØ äÐÙÛÐ Ò ÑÐÙâÐå
                   (ÒëçØáÛïÕâáï ßÞ àÐ×ÜÕàã ßàÕÔëÔãéØå
                   ÔÞÜÕÝÞÒ ÐÒâÞÜÐâØçÕáÚØ) */
}   DbDomainDesc;


/** @name 4DMNDESC
 ***********************************************************************
 * ¾ßØáÐÝØÕ áâàãÚâãàë ×ÐßØáØ Ò äÐÙÛÕ ÞßØáÐâÕÛÕÙ.
 * TT_4* Ø DT_4* ÒÒÞÔïâáï ÔÛï âÞÓÞ, çâÞÑë Ø×ÑÕÖÐâì ÚÞÝäÛØÚâÐ á ÔàãÓØÜØ
 * ØÜÕÝÐÜØ ÔÞÜÕÝÞÒ Ø âÐÑÛØæ, ÚÞâÞàëÕ ÜÞÖÕâ ÞÑêïÒØâì ßÞÛì×ÞÒÐâÕÛì.
 ***********************************************************************/
/* @{ */
#define TT_4DMNDESC "4DMNDESC"
#define DT_4TTNAME  "4TTNAME"
#define DT_4DNAME   "4DNAME"
#define DT_4ATYPE   "4ATYPE"
#define DT_4DIM     "4DIM"
#define DT_4CATEG   "4CATEG"

/*                      dname       atype  dim             categ    offset */
#define DMNDESC_4TTNAME DT_4TTNAME, CHAR_1,  DB_IDENT_LEN+1, UC_NONE, 0
#define DMNDESC_4DNAME  DT_4DNAME,  CHAR_1,  DB_IDENT_LEN+1, UC_NONE, 0
#define DMNDESC_4ATYPE  DT_4ATYPE,  INT_4, 1,              UC_NONE, 0
#define DMNDESC_4DIM    DT_4DIM,    INT_4, 1,              UC_NONE, 0
#define DMNDESC_4CATEG  DT_4CATEG,  INT_4, 1,              UC_NONE, 0
/* @} */


/***********************************************************************
 *
 * ¾ßØáÐÝØÕ ßàÞçØå áÛãÖÕÑÝëå âØßÞÒ âÐÑÛØæ
 *
 ***********************************************************************/

/** @name 4LOCK
 * ÂÐÑÛØæÐ ÑÛÞÚØàÞÒÞÚ ÔÞáâãßÐ Ú ÞÑêÕÚâÐÜ ÔÐÝÝëå
 */
/* @{ */
#define TT_4LOCK    "4LOCK"
#define DT_4ID      "4ID"
#define DT_4TYPE    "4TYPE"
#define DT_4MOMENT  "4MOMENT"
#define DT_4APPNAME "4APPNAME"
#define DT_4OWNER   "4OWNER"
#define DT_4WORKPLACE   "4WORKPLACE"
#define DT_4HOST    "4HOST"
#define DT_4PID     "4PID"

/*                      dname          atype  dim            categ    offset */
#define DD_4ID      DT_4ID,        INT_4, 1,             UC_NONE, 0
#define DD_4MOMENT  DT_4MOMENT,    CHAR_1,  MOMENT_LEN+1,  UC_NONE, 0
#define DD_4TYPE    DT_4TYPE,      CHAR_1,  3,             UC_NONE, 0
#define DD_4APPNAME DT_4APPNAME,   CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4OWNER   DT_4OWNER,     CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4WORKPLACE   DT_4WORKPLACE, CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4HOST    DT_4HOST,      CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4PID     DT_4PID,       INT_4, 1,             UC_NONE, 0
/* @} */


/** @name 4HISTORY
 * ÂÐÑÛØæÐ ØáâÞàØØ ÞÑàÐÑÞâÚØ ßàÞÕÚâÐ
 */
/* @{ */
#define TT_4HISTORY "4HISTORY"
#define DT_4TIMESTAMP   "4TIMESTAMP"
/* already defined
#define DT_4APPNAME "4APPNAME"*/
#define DT_4JOBNUM  "4JOBNUM"
#define DT_4USER    "4USER"
#define DT_4DATAREF "4DATAREF"
#define DT_4EVENT   "4EVENT"
/* already defined
#define DT_4MOMENT  "4MOMENT"
#define DT_4WORKPLACE   "4WORKPLACE"
#define DT_4HOST    "4HOST"*/

/*                      dname          atype  dim            categ    offset */
#define DD_4TIMESTAMP   DT_4TIMESTAMP, INT_4, 1,             UC_NONE, 0
#define DD_4EVENT   DT_4EVENT,     CHAR_1,  256,           UC_NONE, 0
/* already defined
#define DD_4APPNAME DT_4APPNAME,   CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0*/
#define DD_4JOBNUM  DT_4JOBNUM,    INT_4, 1,             UC_NONE, 0
#define DD_4USER    DT_4USER,      CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4DATAREF DT_4DATAREF,   DBTPTR,1,             UC_NONE, 0
/* already defined
#define DD_4MOMENT  DT_4MOMENT,    CHAR_1,  MOMENT_LEN+1,  UC_NONE, 0
#define DD_4WORKPLACE   DT_4WORKPLACE, CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4HOST    DT_4HOST,      CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0*/
/* @} */


#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */


/** ¸ÝØæØÐÛØ×ÐæØï àÕÓØáâàÐ ßàØÚÛÐÔÝëå âØßÞÒ âÐÑÛØæ.  ¼ÞÖÕâ Òë×ëÒÐâìáï
   ÜÝÞÓÞÚàÐâÝÞ ÑÕ× ãéÕàÑÐ ÔÛï ÑëáâàÞÔÕÙáâÒØï Ø ÛÞÓØÚØ àÐÑÞâë »±´. */
void    dbAppInitialize ();

/** ¸ÝØæØÐÛØ×ØàãÕâ ãÚÐ×ÐÝÝãî ÞÑÛÐáâì ßÐÜïâØ ãÜÞÛçÐâÕÛìÝëÜ ×ÝÐçÕÝØÕÜ
   ÔÐÝÝÞÓÞ âØßÐ. */
void    dbFillEmpty (void* ptr, DbDomainDesc* dd);

/** ¿àÞÒÕàïÕâ ãÚÐ×ÐÝÝãî ÞÑÛÐáâì ßÐÜïâØ ÝÐ ãÜÞÛçÐâÕÛìÝëÕ ×ÝÐçÕÝØï
   ÔÐÝÝÞÓÞ âØßÐ. */
Logic   dbCheckEmpty (void* ptr, DbDomainDesc* dd);


/**
 ***********************************************************************
 * ´Ûï æÕÛÕÙ ÞâÛÐÔÚØ ßàÞÓàÐÜÜ, ØáßÞÛì×ãîéØå »±´4 ÜÞÖÝÞ ßàØáÒÞØâì
 * ßÕàÕÜÕÝÝÞÙ ÞÚàãÖÕÝØï DBDEBUG çØáÛÞÒÞÕ ×ÝÐçÕÝØÕ, ßÞÚÐ×ëÒÐîéÕÕ,
 * ÚÐÚÞÙ áÕàìÕ×ÝÞáâØ áÞÞÑéÕÝØï Þ ÒÝãâàÕÝÝÕÙ àÐÑÞâÕ ßàÞæÕÔãà »±´ áÛÕÔãÕâ
 * áÞÞÑéÐâì.  ÁÞÞâÒÕâáâÒØÕ çØáÛÞÒëå ÚÞÔÞÒ Ø áÕÜÐÝâØÚØ ßàØÒÞÔØâáï ÝØÖÕ:
 * EL_FATAL 0 - äÐâÐÛìÝëÕ ÞèØÑÚØ, ÒÛØïîéØÕ ÝÐ àÐÑÞâÞáßÞáÞÑÝÞáâì »±´;
 * EL_ERROR 1 - áÕàìÕ×ÝëÕ ÞèØÑÚØ ßàØ àÐÑÞâÕ á »±´ Ø× ßàØÚÛ.ßàÞÓàÐÜÜ;
 * EL_WARNING   2 - ßàÕÔãßàÕÖÔÕÝØï Þ "ßÞáâãßÚÐå" ßàÞæÕÔãà »±´;
 * EL_INFO  3 - ÝÕÙâàÐÛìÝÐï ØÝäÞàÜÐæØï ßàØ àÐÑÞâÕ á »±´;
 * EL_HINT  4 - áÞÞÑéÕÝØï Þ ÒëßÞÛÝïÕÜëå ÞßÕàÐæØïå;
 * EL_DEBUG 5 - ÞâÛÐÔÞçÝëÕ áÞÞÑéÕÝØï Ø× ÒÝãâàÕÝÝÕÙ ÚãåÝØ »±´.
 ***********************************************************************/

/** ÄãÝÚæØï ×ÐÜÕÝïÕâ wePutMsg() á æÕÛìî ÝÕ ÒëÒÞÔØâì ÝÐ ßÕçÐâì áÞÞÑéÕÝØï á
   ãàÞÒÝÕÜ áÕàìÕ×ÝÞáâØ ÑÞÛìèÕ dbDebugLevel.  ÂÐÚØÜ ÞÑàÐ×ÞÜ, ÕáÛØ 
   dbDebugLevel == 0, âÞ ÑãÔãâ ßÕçÐâÐâìáï âÞÛìÚÞ áÞÞÑéÕÝØï áÕàìÕ×ÝÞáâØ
   EL_FATAL.  µáÛØ == 1, âÞ EL_FATAL Ø EL_ERROR Ø â.Ô. */
void    dbPutMsg (int elevel, const char* msg);

/** ÄãÝÚæØï ×ÐÜÕÝïÕâ weFormatMsg() á æÕÛìî ÝÕ ÒëÒÞÔØâì ÝÐ ßÕçÐâì
   áÞÞÑéÕÝØï á ãàÞÒÝÕÜ áÕàìÕ×ÝÞáâØ ÑÞÛìèÕ dbDebugLevel. */
void    dbFormatMsg (int elevel, const char* format, ...);


/** ÄãÝÚæØï ÒëÒÞÔØâ ãÚÐ×ÐÝÝãî áâàÞÚã Ò äÐÙÛ ßàÞâÞÚÞÛÐ ÞßÕàÐæØÙ. */
void    dbOperLog (const char* format, ...);


/** Return name of directory for temporal data base objects. */
const char* dbTempDir ();


#ifdef __cplusplus
};
#endif /* __cplusplus */


#endif /* dbdefs.h */

 * ßàÐÒÞÒÞÙ ÞåàÐÝÕ ßàÞÓàÐÜÜ ÔÛï íÛÕÚâàÞÝÝëå ÒëçØáÛØâÕÛìÝëå ÜÐèØÝ Ø ÑÐ× * ÔÐÝÝëå"
 *
 * Encoding: ISO-8859-5 (GOST)
 *
 *********************************************************************/

#ifndef __dbdefs_h
#define __dbdefs_h

/** \file
 ***********************************************************************
 *
 * »ÞÚÐÛìÝÐï ±Ð×Ð ´ÐÝÝëå (ÒÕàáØï 4)
 * ¾ßàÕÔÕÛÕÝØï, ÞßØáÐÝØï Ø äÞàÜÐâë ÔÐÝÝëå.
 *
 ***********************************************************************/

#include <mix/Types.h>
#include <mix/units.h>
#include <mix/wenv.h>


/** ´ÛØÝÐ ØÔÕÝâØäØÚÐâÞàÐ Ò »±´ ÑÕ× ßàØ×ÝÐÚÐ ÚÞÝæÐ áâàÞÚØ. */
#define DB_IDENT_LEN        15

/** ¸Üï äÐÙÛÐ ÔÕáÚàØßâÞàÞÒ ßÞ ãÜÞÛçÐÝØî. */
#define DB_DESC_FILE        "ttdesc.4db"

/** ¸Üï ßÕàÕÜÕÝÝÞÙ ÞÚàãÖÕÝØï, Ò ÚÞâÞàÞÙ ×ÐÔÐÕâáï ßãâì Ú äÐÙÛã ÔÕáÚàØßâÞàÞÒ. */
#define DBDFILE_ENV     "DBDFILE"


/** @name dbdebug
 * \brief 
 ***********************************************************************
 * ¾âÛÐÔÞçÝëÕ ßÕàÕÜÕÝÝëÕ ÞÚàãÖÕÝØï
 ***********************************************************************/

/**
 ***********************************************************************
 * ´Ûï æÕÛÕÙ ÞâÛÐÔÚØ ßàÞÓàÐÜÜ, ØáßÞÛì×ãîéØå »±´4 ÜÞÖÝÞ ßàØáÒÞØâì
 * ßÕàÕÜÕÝÝÞÙ ÞÚàãÖÕÝØï DBDEBUG çØáÛÞÒÞÕ ×ÝÐçÕÝØÕ, ßÞÚÐ×ëÒÐîéÕÕ,
 * ÚÐÚÞÙ áÕàìÕ×ÝÞáâØ áÞÞÑéÕÝØï Þ ÒÝãâàÕÝÝÕÙ àÐÑÞâÕ ßàÞæÕÔãà »±´ áÛÕÔãÕâ
 * áÞÞÑéÐâì.  ÁÞÞâÒÕâáâÒØÕ çØáÛÞÒëå ÚÞÔÞÒ Ø áÕÜÐÝâØÚØ ßàØÒÞÔØâáï ÝØÖÕ:
 * EL_FATAL 0 - äÐâÐÛìÝëÕ ÞèØÑÚØ, ÒÛØïîéØÕ ÝÐ àÐÑÞâÞáßÞáÞÑÝÞáâì »±´;
 * EL_ERROR 1 - áÕàìÕ×ÝëÕ ÞèØÑÚØ ßàØ àÐÑÞâÕ á »±´ Ø× ßàØÚÛ.ßàÞÓàÐÜÜ;
 * EL_WARNING   2 - ßàÕÔãßàÕÖÔÕÝØï Þ "ßÞáâãßÚÐå" ßàÞæÕÔãà »±´;
 * EL_INFO  3 - ÝÕÙâàÐÛìÝÐï ØÝäÞàÜÐæØï ßàØ àÐÑÞâÕ á »±´;
 * EL_HINT  4 - áÞÞÑéÕÝØï Þ ÒëßÞÛÝïÕÜëå ÞßÕàÐæØïå;
 * EL_DEBUG 5 - ÞâÛÐÔÞçÝëÕ áÞÞÑéÕÝØï Ø× ÒÝãâàÕÝÝÕÙ ÚãåÝØ »±´.
 ***********************************************************************/

/* @{ */

/** ¸Üï ßÕàÕÜÕÝÝÞÙ ÞÚàãÖÕÝØï, ØáßÞÛì×ãÕÜÞÙ ÔÛï ×ÐÔÐÝØï
   çØáÛÞÒÞÓÞ ãàÞÒÝï ÞèØÑÚØ: áÜ. EL_internal_*. */
#define DBDEBUG     "DBDEBUG"

/* ÁßÕæØÐÛìÝëÕ ãàÞÒÝØ áÕàìÕ×ÝÞáâØ ÒÝãâàÕÝÝØå áÞÞÑéÕÝØÙ »±´. */
#define EL_internal_FATAL   10/*!< äÐâÐÛìÝëÕ ÞèØÑÚØ, ÒÛØïîéØÕ ÝÐ
                                    àÐÑÞâÞáßÞáÞÑÝÞáâì »±´ */
#define EL_internal_ERROR   11/*!< áÕàìÕ×ÝëÕ ÞèØÑÚØ ßàØ àÐÑÞâÕ á
                                    »±´ Ø× ßàØÚÛ.ßàÞÓàÐÜÜ */
#define EL_internal_WARNING 12/*!< ÔãßàÕÖÔÕÝØï Þ "ßÞáâãßÚÐå"
                                    ßàÞæÕÔãà »±´ */
#define EL_internal_INFO    13/*!< ÝÕÙâàÐÛìÝÐï ØÝäÞàÜÐæØï ßàØ
                                    àÐÑÞâÕ á »±´ */
#define EL_internal_HINT    14/*!< áÞÞÑéÕÝØï Þ ÒëßÞÛÝïÕÜëå ÞßÕàÐæØïå */
#define EL_internal_DEBUG   15/*!< ÞâÛÐÔÞçÝëÕ áÞÞÑéÕÝØï Ø×
                                    ÒÝãâàÕÝÝÕÙ ÚãåÝØ »±´ */


/** ÃàÞÒÕÝì áÕàìÕ×ÝÞáâØ ÒëÔÐÒÐÕÜëå áÞÞÑéÕÝØÙ ßÞ ãÜÞÛçÐÝØî */
#define DBDLDEFAULT EL_ERROR

/** ¸Üï ßÕàÕÜÕÝÝÞÙ ÞÚàãÖÕÝØï, ØáßÞÛì×ãÕÜÞÙ ÔÛï ×ÐÔÐÝØï
   ØÜÕÝØ äÐÙÛÐ ßàÞâÞÚÞÛÐ. */
#define DBLOGFILE   "DBLOGFILE"

/** ¸Üï ßÕàÕÜÕÝÝÞÙ ÞÚàãÖÕÝØï, ØáßÞÛì×ãÕÜÞÙ ÔÛï ×ÐÔÐÝØï
   ØÜÕÝØ ßàÞâÞÚÞÛÐ ÞßÕàÐæØÙ. */
#define DBOPERLOGFILE   "DBOPERLOGFILE"

/* @} */

/**
 ***********************************************************************
 * ÁâàãÚâãàÐ ×ÐÓÞÛÞÒÚÐ äÐÙÛÐ ÔÐÝÝëå »±´ (ÒÕàáØï 4).
 * ² ×ÐÓÞÛÞÒÚÕ äÐÙÛÐ ÝÕ ãßÞÜØÝÐÕâáï ØÜï âØßÐ âÐÑÛØæë Ø ØÜÕÝÐ Ø âØßë
 * ÔÞÜÕÝÞÒ.  ¸×ÒÕáâÝÞ âÞÛìÚÞ ÚÞÛØçÕáâÒÞ áâÞÛÑæÞÒ Ø áâàÞÚ, Ð âÐÚÖÕ
 * àÐ×ÜÕà, ×ÐÝØÜÐÕÜëÙ áâàÞÚÞÙ Ø ÐâàØÑãâë ÚÐÖÔÞÓÞ áâÞÛÑæÐ (ÔÞÜÕÝÐ).

 <pre>
 DbFileHeader:
 +0 [Char] (4)      ÁØÓÝÐâãàÐ "@D4"
 +4 [Int4]      ¼ÐÓØçÕáÚÞÕ çØáÛÞ ÔÛï ÞßàÕÔ. Big/Little Endian
 +8 [Char] (16)     ¸Üï âØßÐ âÐÑÛØæë
 +24 [Int4]      ÀÐ×ÜÕà ×ÐßØáØ (áâàÞÚØ âÐÑÛØæë) Ò ÑÐÙâÐå
 +28 [Int4]     ºÞÛØçÕáâÒÞ áâàÞÚ Ò âÐÑÛØæÕ
 +32 [Int4]     ºÞÛØçÕáâÒÞ ÔÞÜÕÝÞÒ

 DbFileDomainAttr:  ßÞÒâÞàïÕâáï ßÞ ÚÞÛØçÕáâÒã ÔÞÜÕÝÞÒ:
 +36 [Int4]     °âàØÑãâë ÔÞÜÕÝÞÒ

 +??            ßÞÒâÞàïÕâáï ßÞ ÚÞÛØçÕáâÒã áâàÞÚ:

 +??+0          1-ëÙ ßÞ áçÕâã ÔÞÜÕÝ áâàÞÚØ #0
 +??+?          2-ëÙ ßÞ áçÕâã ÔÞÜÕÝ áâàÞÚØ #0
 ...

 +??+0          1-ëÙ ßÞ áçÕâã ÔÞÜÕÝ áâàÞÚØ #1
 +??+?          2-ëÙ ßÞ áçÕâã ÔÞÜÕÝ áâàÞÚØ #1
 ...
 </pre>
 ***********************************************************************/
typedef struct
{
#define DBD_SIGNATURE_VER4  "@D4"
  Char  signature[4];   /*!< ÁØÓÝÐâãàÐ "@D4", ÓÔÕ 4 - ÝÞÜÕà ÒÕàáØØ */

#define DBD_MAGIC_BYTES "\x87\x65\x43\x21"
#define DBD_MAGIC_HEX   (0x87654321UL)
#define DBD_MAGIC_DEC   (-2023406815L)
  Int4  magic;      /*!< ¿àÞÒÕàÚÐ ßÞàïÔÚÐ ÑØâÞÒ Ø ÑÐÙâÞÒ Ò áÛÞÒÕ;
               Ò èÕáâÝÐÔæÐâÕàØçÝÞÜ ÒØÔÕ 0x87654321,
               Ò ÔÕáïâØçÝÞÜ ÒØÔÕ -2023406815 */

  Char  ttname[DB_IDENT_LEN+1]; /* ¸Üï âØßÐ âÐÑÛØæë */
  Int4  recsize;    /*!< ÀÐ×ÜÕà ×ÐßØáØ (áâàÞÚØ âÐÑÛØæë) Ò ÑÐÙâÐå */
  Int4  line_cnt;   /*!< ºÞÛØçÕáâÒÞ áâàÞÚ Ò âÐÑÛØæÕ (0..) */
  Int4  dmn_cnt;    /*!< ºÞÛØçÕáâÒÞ ÔÞÜÕÝÞÒ */

}   DbFileHeader;


/**
 ***********************************************************************
 * °âàØÑãâë ÔÞÜÕÝÐ Ò äÐÙÛÕ ÔÐÝÝëå »±´.
 ***********************************************************************/
typedef struct
{
  Int4  unit;       /*!< ÄØ×ØçÕáÚÐï ÒÕÛØçØÝÐ ×ÝÐçÕÝØÙ ÔÞÜÕÝÐ */

}   DbFileDomainAttr;


/**
 ***********************************************************************
 * ¾ßØáÐÝØÕ ÔÞÜÕÝÐ Ò ßÐÜïâØ.
 ***********************************************************************/
typedef struct
{
  Char  dname[DB_IDENT_LEN+1];  /*!< ¸Üï ÔÞÜÕÝÐ (áâÞÛÑæÐ âÐÑÛØæë) */
  AtomType  atype;      /*!< ÂØß ×ÝÐçÕÝØï ÔÞÜÕÝÐ */
  Int4      dim;        /*!< ÀÐ×ÜÕàÝÞáâì ÔÞÜÕÝÐ Ò ×ÝÐçÕÝØïå */
  CategoryId    categ;      /*!< ºÐâÕÓÞàØï äØ×.ÒÕÛØçØÝë */
  Int4      offset;     /*!< ÁÜÕéÕÝØÕ ßÞÛï Ò ×ÐßØáØ äÐÙÛÐ Ò ÑÐÙâÐå
                   (ÒëçØáÛïÕâáï ßÞ àÐ×ÜÕàã ßàÕÔëÔãéØå
                   ÔÞÜÕÝÞÒ ÐÒâÞÜÐâØçÕáÚØ) */
}   DbDomainDesc;


/** @name 4DMNDESC
 ***********************************************************************
 * ¾ßØáÐÝØÕ áâàãÚâãàë ×ÐßØáØ Ò äÐÙÛÕ ÞßØáÐâÕÛÕÙ.
 * TT_4* Ø DT_4* ÒÒÞÔïâáï ÔÛï âÞÓÞ, çâÞÑë Ø×ÑÕÖÐâì ÚÞÝäÛØÚâÐ á ÔàãÓØÜØ
 * ØÜÕÝÐÜØ ÔÞÜÕÝÞÒ Ø âÐÑÛØæ, ÚÞâÞàëÕ ÜÞÖÕâ ÞÑêïÒØâì ßÞÛì×ÞÒÐâÕÛì.
 ***********************************************************************/
/* @{ */
#define TT_4DMNDESC "4DMNDESC"
#define DT_4TTNAME  "4TTNAME"
#define DT_4DNAME   "4DNAME"
#define DT_4ATYPE   "4ATYPE"
#define DT_4DIM     "4DIM"
#define DT_4CATEG   "4CATEG"

/*                      dname       atype  dim             categ    offset */
#define DMNDESC_4TTNAME DT_4TTNAME, CHAR_1,  DB_IDENT_LEN+1, UC_NONE, 0
#define DMNDESC_4DNAME  DT_4DNAME,  CHAR_1,  DB_IDENT_LEN+1, UC_NONE, 0
#define DMNDESC_4ATYPE  DT_4ATYPE,  INT_4, 1,              UC_NONE, 0
#define DMNDESC_4DIM    DT_4DIM,    INT_4, 1,              UC_NONE, 0
#define DMNDESC_4CATEG  DT_4CATEG,  INT_4, 1,              UC_NONE, 0
/* @} */


/***********************************************************************
 *
 * ¾ßØáÐÝØÕ ßàÞçØå áÛãÖÕÑÝëå âØßÞÒ âÐÑÛØæ
 *
 ***********************************************************************/

/** @name 4LOCK
 * ÂÐÑÛØæÐ ÑÛÞÚØàÞÒÞÚ ÔÞáâãßÐ Ú ÞÑêÕÚâÐÜ ÔÐÝÝëå
 */
/* @{ */
#define TT_4LOCK    "4LOCK"
#define DT_4ID      "4ID"
#define DT_4TYPE    "4TYPE"
#define DT_4MOMENT  "4MOMENT"
#define DT_4APPNAME "4APPNAME"
#define DT_4OWNER   "4OWNER"
#define DT_4WORKPLACE   "4WORKPLACE"
#define DT_4HOST    "4HOST"
#define DT_4PID     "4PID"

/*                      dname          atype  dim            categ    offset */
#define DD_4ID      DT_4ID,        INT_4, 1,             UC_NONE, 0
#define DD_4MOMENT  DT_4MOMENT,    CHAR_1,  MOMENT_LEN+1,  UC_NONE, 0
#define DD_4TYPE    DT_4TYPE,      CHAR_1,  3,             UC_NONE, 0
#define DD_4APPNAME DT_4APPNAME,   CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4OWNER   DT_4OWNER,     CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4WORKPLACE   DT_4WORKPLACE, CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4HOST    DT_4HOST,      CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4PID     DT_4PID,       INT_4, 1,             UC_NONE, 0
/* @} */


/** @name 4HISTORY
 * ÂÐÑÛØæÐ ØáâÞàØØ ÞÑàÐÑÞâÚØ ßàÞÕÚâÐ
 */
/* @{ */
#define TT_4HISTORY "4HISTORY"
#define DT_4TIMESTAMP   "4TIMESTAMP"
/* already defined
#define DT_4APPNAME "4APPNAME"*/
#define DT_4JOBNUM  "4JOBNUM"
#define DT_4USER    "4USER"
#define DT_4DATAREF "4DATAREF"
#define DT_4EVENT   "4EVENT"
/* already defined
#define DT_4MOMENT  "4MOMENT"
#define DT_4WORKPLACE   "4WORKPLACE"
#define DT_4HOST    "4HOST"*/

/*                      dname          atype  dim            categ    offset */
#define DD_4TIMESTAMP   DT_4TIMESTAMP, INT_4, 1,             UC_NONE, 0
#define DD_4EVENT   DT_4EVENT,     CHAR_1,  256,           UC_NONE, 0
/* already defined
#define DD_4APPNAME DT_4APPNAME,   CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0*/
#define DD_4JOBNUM  DT_4JOBNUM,    INT_4, 1,             UC_NONE, 0
#define DD_4USER    DT_4USER,      CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4DATAREF DT_4DATAREF,   DBTPTR,1,             UC_NONE, 0
/* already defined
#define DD_4MOMENT  DT_4MOMENT,    CHAR_1,  MOMENT_LEN+1,  UC_NONE, 0
#define DD_4WORKPLACE   DT_4WORKPLACE, CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4HOST    DT_4HOST,      CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0*/
/* @} */


#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */


/** ¸ÝØæØÐÛØ×ÐæØï àÕÓØáâàÐ ßàØÚÛÐÔÝëå âØßÞÒ âÐÑÛØæ.  ¼ÞÖÕâ Òë×ëÒÐâìáï
   ÜÝÞÓÞÚàÐâÝÞ ÑÕ× ãéÕàÑÐ ÔÛï ÑëáâàÞÔÕÙáâÒØï Ø ÛÞÓØÚØ àÐÑÞâë »±´. */
void    dbAppInitialize ();

/** ¸ÝØæØÐÛØ×ØàãÕâ ãÚÐ×ÐÝÝãî ÞÑÛÐáâì ßÐÜïâØ ãÜÞÛçÐâÕÛìÝëÜ ×ÝÐçÕÝØÕÜ
   ÔÐÝÝÞÓÞ âØßÐ. */
void    dbFillEmpty (void* ptr, DbDomainDesc* dd);

/** ¿àÞÒÕàïÕâ ãÚÐ×ÐÝÝãî ÞÑÛÐáâì ßÐÜïâØ ÝÐ ãÜÞÛçÐâÕÛìÝëÕ ×ÝÐçÕÝØï
   ÔÐÝÝÞÓÞ âØßÐ. */
Logic   dbCheckEmpty (void* ptr, DbDomainDesc* dd);


/**
 ***********************************************************************
 * ´Ûï æÕÛÕÙ ÞâÛÐÔÚØ ßàÞÓàÐÜÜ, ØáßÞÛì×ãîéØå »±´4 ÜÞÖÝÞ ßàØáÒÞØâì
 * ßÕàÕÜÕÝÝÞÙ ÞÚàãÖÕÝØï DBDEBUG çØáÛÞÒÞÕ ×ÝÐçÕÝØÕ, ßÞÚÐ×ëÒÐîéÕÕ,
 * ÚÐÚÞÙ áÕàìÕ×ÝÞáâØ áÞÞÑéÕÝØï Þ ÒÝãâàÕÝÝÕÙ àÐÑÞâÕ ßàÞæÕÔãà »±´ áÛÕÔãÕâ
 * áÞÞÑéÐâì.  ÁÞÞâÒÕâáâÒØÕ çØáÛÞÒëå ÚÞÔÞÒ Ø áÕÜÐÝâØÚØ ßàØÒÞÔØâáï ÝØÖÕ:
 * EL_FATAL 0 - äÐâÐÛìÝëÕ ÞèØÑÚØ, ÒÛØïîéØÕ ÝÐ àÐÑÞâÞáßÞáÞÑÝÞáâì »±´;
 * EL_ERROR 1 - áÕàìÕ×ÝëÕ ÞèØÑÚØ ßàØ àÐÑÞâÕ á »±´ Ø× ßàØÚÛ.ßàÞÓàÐÜÜ;
 * EL_WARNING   2 - ßàÕÔãßàÕÖÔÕÝØï Þ "ßÞáâãßÚÐå" ßàÞæÕÔãà »±´;
 * EL_INFO  3 - ÝÕÙâàÐÛìÝÐï ØÝäÞàÜÐæØï ßàØ àÐÑÞâÕ á »±´;
 * EL_HINT  4 - áÞÞÑéÕÝØï Þ ÒëßÞÛÝïÕÜëå ÞßÕàÐæØïå;
 * EL_DEBUG 5 - ÞâÛÐÔÞçÝëÕ áÞÞÑéÕÝØï Ø× ÒÝãâàÕÝÝÕÙ ÚãåÝØ »±´.
 ***********************************************************************/

/** ÄãÝÚæØï ×ÐÜÕÝïÕâ wePutMsg() á æÕÛìî ÝÕ ÒëÒÞÔØâì ÝÐ ßÕçÐâì áÞÞÑéÕÝØï á
   ãàÞÒÝÕÜ áÕàìÕ×ÝÞáâØ ÑÞÛìèÕ dbDebugLevel.  ÂÐÚØÜ ÞÑàÐ×ÞÜ, ÕáÛØ 
   dbDebugLevel == 0, âÞ ÑãÔãâ ßÕçÐâÐâìáï âÞÛìÚÞ áÞÞÑéÕÝØï áÕàìÕ×ÝÞáâØ
   EL_FATAL.  µáÛØ == 1, âÞ EL_FATAL Ø EL_ERROR Ø â.Ô. */
void    dbPutMsg (int elevel, const char* msg);

/** ÄãÝÚæØï ×ÐÜÕÝïÕâ weFormatMsg() á æÕÛìî ÝÕ ÒëÒÞÔØâì ÝÐ ßÕçÐâì
   áÞÞÑéÕÝØï á ãàÞÒÝÕÜ áÕàìÕ×ÝÞáâØ ÑÞÛìèÕ dbDebugLevel. */
void    dbFormatMsg (int elevel, const char* format, ...);


/** ÄãÝÚæØï ÒëÒÞÔØâ ãÚÐ×ÐÝÝãî áâàÞÚã Ò äÐÙÛ ßàÞâÞÚÞÛÐ ÞßÕàÐæØÙ. */
void    dbOperLog (const char* format, ...);


/** Return name of directory for temporal data base objects. */
const char* dbTempDir ();


#ifdef __cplusplus
};
#endif /* __cplusplus */


#endif /* dbdefs.h */

 * ÔÐÝÝëå"
 *
 * Encoding: ISO-8859-5 (GOST)
 *
 *********************************************************************/

#ifndef __dbdefs_h
#define __dbdefs_h

#include <mix/Types.h>
#include <mix/units.h>
#include <mix/wenv.h>


#define DB_IDENT_LEN        15

#define DB_DESC_FILE        "ttdesc.4db"

#define DBDFILE_ENV     "DBDFILE"


/* @{ */

#define DBDEBUG     "DBDEBUG"

/* ÁßÕæØÐÛìÝëÕ ãàÞÒÝØ áÕàìÕ×ÝÞáâØ ÒÝãâàÕÝÝØå áÞÞÑéÕÝØÙ »±´. */
#define EL_internal_FATAL   10
#define EL_internal_ERROR   11
#define EL_internal_WARNING 12
#define EL_internal_INFO    13
#define EL_internal_HINT    14
#define EL_internal_DEBUG   15
#define DBDLDEFAULT EL_ERROR

#define DBLOGFILE   "DBLOGFILE"

#define DBOPERLOGFILE   "DBOPERLOGFILE"

/* @} */

typedef struct
{
#define DBD_SIGNATURE_VER4  "@D4"
  Char  signature[4];   
#define DBD_MAGIC_BYTES "\x87\x65\x43\x21"
#define DBD_MAGIC_HEX   (0x87654321UL)
#define DBD_MAGIC_DEC   (-2023406815L)
  Int4  magic;      
  Char  ttname[DB_IDENT_LEN+1]; /* ¸Üï âØßÐ âÐÑÛØæë */
  Int4  recsize;    
  Int4  line_cnt;   
  Int4  dmn_cnt;    
}   DbFileHeader;


typedef struct
{
  Int4  unit;       
}   DbFileDomainAttr;


typedef struct
{
  Char  dname[DB_IDENT_LEN+1];  
  AtomType  atype;      
  Int4      dim;        
  CategoryId    categ;      
  Int4      offset;     
}   DbDomainDesc;


/* @{ */
#define TT_4DMNDESC "4DMNDESC"
#define DT_4TTNAME  "4TTNAME"
#define DT_4DNAME   "4DNAME"
#define DT_4ATYPE   "4ATYPE"
#define DT_4DIM     "4DIM"
#define DT_4CATEG   "4CATEG"

/*                      dname       atype  dim             categ    offset */
#define DMNDESC_4TTNAME DT_4TTNAME, CHAR_1,  DB_IDENT_LEN+1, UC_NONE, 0
#define DMNDESC_4DNAME  DT_4DNAME,  CHAR_1,  DB_IDENT_LEN+1, UC_NONE, 0
#define DMNDESC_4ATYPE  DT_4ATYPE,  INT_4, 1,              UC_NONE, 0
#define DMNDESC_4DIM    DT_4DIM,    INT_4, 1,              UC_NONE, 0
#define DMNDESC_4CATEG  DT_4CATEG,  INT_4, 1,              UC_NONE, 0
/* @} */


/***********************************************************************
 *
 * ¾ßØáÐÝØÕ ßàÞçØå áÛãÖÕÑÝëå âØßÞÒ âÐÑÛØæ *
 ***********************************************************************/

/** @name 4LOCK
 * ÂÐÑÛØæÐ ÑÛÞÚØàÞÒÞÚ ÔÞáâãßÐ Ú ÞÑêÕÚâÐÜ ÔÐÝÝëå
 */
/* @{ */
#define TT_4LOCK    "4LOCK"
#define DT_4ID      "4ID"
#define DT_4TYPE    "4TYPE"
#define DT_4MOMENT  "4MOMENT"
#define DT_4APPNAME "4APPNAME"
#define DT_4OWNER   "4OWNER"
#define DT_4WORKPLACE   "4WORKPLACE"
#define DT_4HOST    "4HOST"
#define DT_4PID     "4PID"

/*                      dname          atype  dim            categ    offset */
#define DD_4ID      DT_4ID,        INT_4, 1,             UC_NONE, 0
#define DD_4MOMENT  DT_4MOMENT,    CHAR_1,  MOMENT_LEN+1,  UC_NONE, 0
#define DD_4TYPE    DT_4TYPE,      CHAR_1,  3,             UC_NONE, 0
#define DD_4APPNAME DT_4APPNAME,   CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4OWNER   DT_4OWNER,     CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4WORKPLACE   DT_4WORKPLACE, CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4HOST    DT_4HOST,      CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4PID     DT_4PID,       INT_4, 1,             UC_NONE, 0
/* @} */


/** @name 4HISTORY
 * ÂÐÑÛØæÐ ØáâÞàØØ ÞÑàÐÑÞâÚØ ßàÞÕÚâÐ
 */
/* @{ */
#define TT_4HISTORY "4HISTORY"
#define DT_4TIMESTAMP   "4TIMESTAMP"
/* already defined
#define DT_4APPNAME "4APPNAME"*/
#define DT_4JOBNUM  "4JOBNUM"
#define DT_4USER    "4USER"
#define DT_4DATAREF "4DATAREF"
#define DT_4EVENT   "4EVENT"
/* already defined
#define DT_4MOMENT  "4MOMENT"
#define DT_4WORKPLACE   "4WORKPLACE"
#define DT_4HOST    "4HOST"*/

/*                      dname          atype  dim            categ    offset */
#define DD_4TIMESTAMP   DT_4TIMESTAMP, INT_4, 1,             UC_NONE, 0
#define DD_4EVENT   DT_4EVENT,     CHAR_1,  256,           UC_NONE, 0
/* already defined
#define DD_4APPNAME DT_4APPNAME,   CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0*/
#define DD_4JOBNUM  DT_4JOBNUM,    INT_4, 1,             UC_NONE, 0
#define DD_4USER    DT_4USER,      CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4DATAREF DT_4DATAREF,   DBTPTR,1,             UC_NONE, 0
/* already defined
#define DD_4MOMENT  DT_4MOMENT,    CHAR_1,  MOMENT_LEN+1,  UC_NONE, 0
#define DD_4WORKPLACE   DT_4WORKPLACE, CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4HOST    DT_4HOST,      CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0*/
/* @} */


#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */


/** ¸ÝØæØÐÛØ×ÐæØï àÕÓØáâàÐ ßàØÚÛÐÔÝëå âØßÞÒ âÐÑÛØæ.  ¼ÞÖÕâ Òë×ëÒÐâìáï
   ÜÝÞÓÞÚàÐâÝÞ ÑÕ× ãéÕàÑÐ ÔÛï ÑëáâàÞÔÕÙáâÒØï Ø ÛÞÓØÚØ àÐÑÞâë »±´. */
void    dbAppInitialize ();

/** ¸ÝØæØÐÛØ×ØàãÕâ ãÚÐ×ÐÝÝãî ÞÑÛÐáâì ßÐÜïâØ ãÜÞÛçÐâÕÛìÝëÜ ×ÝÐçÕÝØÕÜ
   ÔÐÝÝÞÓÞ âØßÐ. */
void    dbFillEmpty (void* ptr, DbDomainDesc* dd);

/** ¿àÞÒÕàïÕâ ãÚÐ×ÐÝÝãî ÞÑÛÐáâì ßÐÜïâØ ÝÐ ãÜÞÛçÐâÕÛìÝëÕ ×ÝÐçÕÝØï
   ÔÐÝÝÞÓÞ âØßÐ. */
Logic   dbCheckEmpty (void* ptr, DbDomainDesc* dd);


/**
 ***********************************************************************
 * ´Ûï æÕÛÕÙ ÞâÛÐÔÚØ ßàÞÓàÐÜÜ, ØáßÞÛì×ãîéØå »±´4 ÜÞÖÝÞ ßàØáÒÞØâì
 * ßÕàÕÜÕÝÝÞÙ ÞÚàãÖÕÝØï DBDEBUG çØáÛÞÒÞÕ ×ÝÐçÕÝØÕ, ßÞÚÐ×ëÒÐîéÕÕ,
 * ÚÐÚÞÙ áÕàìÕ×ÝÞáâØ áÞÞÑéÕÝØï Þ ÒÝãâàÕÝÝÕÙ àÐÑÞâÕ ßàÞæÕÔãà »±´ áÛÕÔãÕâ
 * áÞÞÑéÐâì.  ÁÞÞâÒÕâáâÒØÕ çØáÛÞÒëå ÚÞÔÞÒ Ø áÕÜÐÝâØÚØ ßàØÒÞÔØâáï ÝØÖÕ:
 * EL_FATAL 0 - äÐâÐÛìÝëÕ ÞèØÑÚØ, ÒÛØïîéØÕ ÝÐ àÐÑÞâÞáßÞáÞÑÝÞáâì »±´;
 * EL_ERROR 1 - áÕàìÕ×ÝëÕ ÞèØÑÚØ ßàØ àÐÑÞâÕ á »±´ Ø× ßàØÚÛ.ßàÞÓàÐÜÜ;
 * EL_WARNING   2 - ßàÕÔãßàÕÖÔÕÝØï Þ "ßÞáâãßÚÐå" ßàÞæÕÔãà »±´;
 * EL_INFO  3 - ÝÕÙâàÐÛìÝÐï ØÝäÞàÜÐæØï ßàØ àÐÑÞâÕ á »±´;
 * EL_HINT  4 - áÞÞÑéÕÝØï Þ ÒëßÞÛÝïÕÜëå ÞßÕàÐæØïå;
 * EL_DEBUG 5 - ÞâÛÐÔÞçÝëÕ áÞÞÑéÕÝØï Ø× ÒÝãâàÕÝÝÕÙ ÚãåÝØ »±´.
 ***********************************************************************/

/** ÄãÝÚæØï ×ÐÜÕÝïÕâ wePutMsg() á æÕÛìî ÝÕ ÒëÒÞÔØâì ÝÐ ßÕçÐâì áÞÞÑéÕÝØï á
   ãàÞÒÝÕÜ áÕàìÕ×ÝÞáâØ ÑÞÛìèÕ dbDebugLevel.  ÂÐÚØÜ ÞÑàÐ×ÞÜ, ÕáÛØ 
   dbDebugLevel == 0, âÞ ÑãÔãâ ßÕçÐâÐâìáï âÞÛìÚÞ áÞÞÑéÕÝØï áÕàìÕ×ÝÞáâØ
   EL_FATAL.  µáÛØ == 1, âÞ EL_FATAL Ø EL_ERROR Ø â.Ô. */
void    dbPutMsg (int elevel, const char* msg);

/** ÄãÝÚæØï ×ÐÜÕÝïÕâ weFormatMsg() á æÕÛìî ÝÕ ÒëÒÞÔØâì ÝÐ ßÕçÐâì
   áÞÞÑéÕÝØï á ãàÞÒÝÕÜ áÕàìÕ×ÝÞáâØ ÑÞÛìèÕ dbDebugLevel. */
void    dbFormatMsg (int elevel, const char* format, ...);


/** ÄãÝÚæØï ÒëÒÞÔØâ ãÚÐ×ÐÝÝãî áâàÞÚã Ò äÐÙÛ ßàÞâÞÚÞÛÐ ÞßÕàÐæØÙ. */
void    dbOperLog (const char* format, ...);


/** Return name of directory for temporal data base objects. */
const char* dbTempDir ();


#ifdef __cplusplus
};
#endif /* __cplusplus */


#endif /* dbdefs.h */

 *
 ***********************************************************************/

/* @{ */
#define TT_4LOCK    "4LOCK"
#define DT_4ID      "4ID"
#define DT_4TYPE    "4TYPE"
#define DT_4MOMENT  "4MOMENT"
#define DT_4APPNAME "4APPNAME"
#define DT_4OWNER   "4OWNER"
#define DT_4WORKPLACE   "4WORKPLACE"
#define DT_4HOST    "4HOST"
#define DT_4PID     "4PID"

/*                      dname          atype  dim            categ    offset */
#define DD_4ID      DT_4ID,        INT_4, 1,             UC_NONE, 0
#define DD_4MOMENT  DT_4MOMENT,    CHAR_1,  MOMENT_LEN+1,  UC_NONE, 0
#define DD_4TYPE    DT_4TYPE,      CHAR_1,  3,             UC_NONE, 0
#define DD_4APPNAME DT_4APPNAME,   CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4OWNER   DT_4OWNER,     CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4WORKPLACE   DT_4WORKPLACE, CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4HOST    DT_4HOST,      CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4PID     DT_4PID,       INT_4, 1,             UC_NONE, 0
/* @} */


/* @{ */
#define TT_4HISTORY "4HISTORY"
#define DT_4TIMESTAMP   "4TIMESTAMP"
/* already defined
#define DT_4APPNAME "4APPNAME"*/
#define DT_4JOBNUM  "4JOBNUM"
#define DT_4USER    "4USER"
#define DT_4DATAREF "4DATAREF"
#define DT_4EVENT   "4EVENT"
/* already defined
#define DT_4MOMENT  "4MOMENT"
#define DT_4WORKPLACE   "4WORKPLACE"
#define DT_4HOST    "4HOST"*/

/*                      dname          atype  dim            categ    offset */
#define DD_4TIMESTAMP   DT_4TIMESTAMP, INT_4, 1,             UC_NONE, 0
#define DD_4EVENT   DT_4EVENT,     CHAR_1,  256,           UC_NONE, 0
/* already defined
#define DD_4APPNAME DT_4APPNAME,   CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0*/
#define DD_4JOBNUM  DT_4JOBNUM,    INT_4, 1,             UC_NONE, 0
#define DD_4USER    DT_4USER,      CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4DATAREF DT_4DATAREF,   DBTPTR,1,             UC_NONE, 0
/* already defined
#define DD_4MOMENT  DT_4MOMENT,    CHAR_1,  MOMENT_LEN+1,  UC_NONE, 0
#define DD_4WORKPLACE   DT_4WORKPLACE, CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0
#define DD_4HOST    DT_4HOST,      CHAR_1,  WE_NAME_LEN+1, UC_NONE, 0*/
/* @} */


#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */


void    dbAppInitialize ();

void    dbFillEmpty (void* ptr, DbDomainDesc* dd);

Logic   dbCheckEmpty (void* ptr, DbDomainDesc* dd);


void    dbPutMsg (int elevel, const char* msg);

void    dbFormatMsg (int elevel, const char* format, ...);


void    dbOperLog (const char* format, ...);


const char* dbTempDir ();


#ifdef __cplusplus
};
#endif /* __cplusplus */


#endif /* dbdefs.h */