home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 7 / 07.iso / c / c150 / 1.ddi / VISTA.H < prev    next >
Encoding:
C/C++ Source or Header  |  1991-01-04  |  12.3 KB  |  369 lines
  1. /*----------------------------------------------------------------------
  2.   vista.h: db_VISTA standard header file
  3.  
  4.    This file should be included in all programs which use db_VISTA.  It
  5.    contains database status/error code definitions and standard type
  6.    definitions.
  7.  
  8.    This file should only include user-oriented constructs.
  9.  
  10.    Copyright (c) 1984-1990, Raima Corporation, All Rights Reserved
  11. ----------------------------------------------------------------------*/
  12.  
  13. #ifndef VISTA_H
  14. #define VISTA_H
  15.  
  16. /* ********************** EDIT HISTORY *******************************
  17.  
  18.  SCR    DATE    INI                   DESCRIPTION
  19. ----- --------- --- -----------------------------------------------------
  20.       03-AUG-88 RTK Multi-tasking support - see "#ifdef MULTI_TASK"
  21.       08-AUG-88 RTK Declared globals rn_dba, rn_type, and ft_offset to
  22.             support recfrst, recnext, etc in ONE_DB mode.
  23.       16-Sep-88 RSC Fixed DBN_Dx to use variable # of arg macros.
  24.       28-Sep-88 WLW Corrected the db_VERSION to 3.10 from 3.01.
  25.       11-Oct-88 RSC Fixed DBN_Dx to use variable # of arg macros (again)
  26.       11-Oct-88 RSC Fixed ONE_DB to compile correctly
  27.       17-Oct-88 RSC Replaced MSC with ANSI, moved compiler check to dbtype
  28.   439 17-Nov-88 RSC Placed some multi-tasking stuff within MULTI_TASK
  29.   441 06-Dec-88 RSC Modifications to make gen lockmgr work with 3.10
  30.       26-Jan-89 RSC Add defn for DB_UINT (for lockmgr)
  31.       01-Sep-89 RTK Added tag name to LOCK_REQUEST typedef
  32.       05-Jan-90 KGM Uses DB_VOID now
  33.       26-Mar-90 KGM Dbata base number now required
  34.       01-May-90 WLW Added option to NOT call SESSTAT.
  35. */
  36.  
  37. #define db_VERSION "3.20"
  38. #define dbd_VERSION "V3.00\032"
  39.  
  40. /* -------------------status codes-------------------- */
  41. /* user errors */
  42. #define S_DBOPEN    -1    /* database not opened */
  43. #define S_INVSET    -2    /* invalid set */
  44. #define S_INVREC    -3    /* invalid record */
  45. #define S_INVDB     -4    /* invalid database */
  46. #define S_INVFLD    -5    /* invalid field name */
  47. #define S_INVADDR   -6    /* invalid db_address */
  48. #define S_NOCR      -7    /* no current record */
  49. #define S_NOCO      -8    /* set has no current owner */
  50. #define S_NOCM      -9    /* set has no current member */
  51. #define S_KEYREQD   -10   /* key value required */
  52. #define S_BADTYPE   -11   /* invalid lock type */
  53. #define S_HASMEM    -12   /* record is owner of non-empty set(s) */
  54. #define S_ISMEM     -13   /* record is member of set(s) */
  55. #define S_ISOWNED   -14   /* member already owned */
  56. #define S_ISCOMKEY  -15   /* field is a compound key */
  57. #define S_NOTCON    -16   /* record not connected to set */
  58. #define S_NOTKEY    -17   /* field is not a valid key */
  59. #define S_INVOWN    -18   /* record not legal owner of set */
  60. #define S_INVMEM    -19   /* record not legal member of set */
  61. #define S_SETPAGES  -20   /* error in d_setpages (database open or bad param) */
  62. #define S_INCOMPAT  -21   /* incompatible dictionary file */
  63. #define S_DELSYS    -22   /* illegal attempt to delete system record */
  64. #define S_NOTFREE   -23   /* attempt to locked previously locked rec or set */
  65. #define S_NOTLOCKED -24   /* attempt to access unlocked record or set */
  66. #define S_TRANSID   -25   /* transaction id not be supplied */
  67. #define S_TRACTIVE  -26   /* transaction already active */
  68. #define S_TRNOTACT  -27   /* transaction not currently active */
  69. #define S_TRFREE    -29   /* attempt to free a lock inside a transaction */
  70. #define S_NOTRANS   -31   /* attempted update outside of transaction */
  71. #define S_EXCLUSIVE -32   /* functions requires exclusive db access */
  72. #define S_STATIC    -33   /* Attempted to write lock a static file */
  73. #define S_USERID    -34   /* No user id exists */
  74. #define S_NAMELEN   -35   /* database file/path name too long */
  75. #define S_RENAME    -36   /* invalid file number was passed to d_renfile */
  76. #define S_NOTOPTKEY -37   /* field is not an optional key */
  77. #define S_BADFIELD  -38   /* field not defined in current record type */
  78. #define S_COMKEY    -39   /* record/field has/in a compound key */
  79. #define S_INVNUM    -40   /* invalid record or set number */
  80. #define S_TIMESTAMP -41   /* record or set not timestamped */
  81. #define S_BADUSERID -42   /* invalid user id - not alphanumeric */
  82. #define S_NONETBIOS -43   /* NetBIOS is not installed on machine */
  83. #define S_NOTYPE    -46      /* No current record type */
  84. #define S_INVSORT   -47      /* Invalid country table sort string */
  85. #define S_DBCLOSE   -48   /* database not closed */
  86. #define S_INVPTR    -49   /* invalid pointer */
  87. #define S_INVID     -50   /* invalid internal ID */
  88.  
  89. /* system errors */
  90. #define S_NOSPACE   -900  /* no more space on file */
  91. #define S_SYSERR    -901  /* system error */
  92. #define S_FAULT     -902  /* page fault -- changed during usage */
  93. #define S_NOWORK    -903  /* no working file set in dio */
  94. #define S_NOMEMORY  -904  /* unable to allocate sufficient memory */
  95. #define S_NOFILE    -905  /* unable to locate a file */
  96. #define S_DBLACCESS -906  /* unable to access db lock file */
  97. #define S_DBLERR    -907  /* db lock file open/access error */
  98. #define S_BADLOCKS  -908  /* inconsistent database locks */
  99. #define S_RECLIMIT  -909  /* file record limit reached */
  100. #define S_KEYERR    -910  /* key file inconsistency detected */
  101. #define S_FSEEK     -912  /* Bad seek on database file */
  102. #define S_READ      -914  /* Bad read on database/overflow file */
  103. #define S_NETSYNC   -915  /* Network synchronization error */
  104. #define S_DEBUG     -916  /* Debugging check interrupt */
  105. #define S_NETERR    -917  /* Network communications error */
  106. #define S_RECOVERY  -918  /* Auto-recovery is in process */
  107. #define S_WRITE     -919  /* Bad write on database/overflow file */
  108. #define S_NOLOCKMGR -920  /* Unable to open lockmgr session */
  109. #define S_DUPUSERID -921  /* DBUSERID is already used by another user */
  110. #define S_LMBUSY    -922  /* The lock manager is busy */
  111. #define S_DISCARDED -923  /* attempt to lock discarded memory */
  112. #define S_SEM        -924  /* unable to open semaphore */
  113.  
  114.  
  115. /* function statuses */
  116. #define S_OKAY      0     /* normal return, okay */
  117. #define S_EOS       1     /* end of set */
  118. #define S_NOTFOUND  2     /* record not found */
  119. #define S_DUPLICATE 3     /* duplicate key */
  120. #define S_KEYSEQ    4     /* field type used out of sequence in d_keynext */
  121. #define S_UNAVAIL   5     /* database file currently unavailable */
  122. #define S_DELETED   6     /* record/set deleted since last accessed */
  123. #define S_UPDATED   7     /* record/set updated since last accessed */
  124. #define S_LOCKED    8     /* current record's lock bit is set */
  125. #define S_UNLOCKED  9     /* current record's lock bit is clear */
  126.  
  127.  
  128. /* the following two definitions must be changed together */
  129. typedef short DB_SHORT;
  130. #define DB_SHORT_LEN 2
  131.  
  132. typedef unsigned short DB_UINT;    /* Some compilers won't handle unsigned DB_SHORT */
  133. typedef unsigned long DB_ULONG;
  134. typedef int BOOLEAN;
  135.  
  136. #define MAXRECORDS 16777215L
  137. #define NULL_DBA 0L
  138.  
  139. /* db_VISTA database address */
  140. #define DB_ADDR long  
  141.  
  142. /* db_VISTA file number */
  143. #define FILE_NO DB_SHORT   
  144.  
  145. /* file address: page or record number */
  146. #define F_ADDR long   
  147.  
  148. /* record number indicator */
  149. #define RECMARK 10000
  150. /* field number indicator = rec * FLDMARK + fld_in_rec */
  151. #define FLDMARK 1000L
  152. /* set number indicator - must be greater than RECMARK */
  153. #define SETMARK 20000
  154.  
  155. /* runtime option flags */
  156. #define DCHAINUSE    0x001
  157. #define TRLOGGING    0x002
  158. #define ARCLOGGING   0x004
  159. #define IGNORECASE   0x008
  160. #define CLOSEFILES   0x020
  161. #define GLOBALALLOCS 0x040
  162. #define NOSESSTAT    0x080
  163.  
  164. #define LIB_INIT
  165.  
  166. extern int db_status;
  167. extern int rlb_status;
  168.  
  169. #ifdef ZOR
  170. #define ANSI
  171. #define LINT_ARGS
  172. #endif
  173.  
  174. #ifdef TURBO
  175. #define ANSI
  176. #define LINT_ARGS
  177. #endif
  178.  
  179. #ifdef MSC
  180. #define ANSI
  181. #define LINT_ARGS
  182. #endif
  183.  
  184.  
  185.  
  186. /* Use the 'const' keyword unless told otherwise */
  187. #ifndef NO_CONST
  188. #define CONST const
  189. #else
  190. #define CONST /**/
  191. #endif
  192.  
  193. /* Use the 'void' keyword unless told otherwise */
  194. #ifndef NO_VOID
  195. #define DB_VOID void
  196. #else
  197. #define DB_VOID char
  198. #endif
  199.  
  200. /* Use PASCAL calling conventions unless told otherwise */
  201. #ifndef NO_PASCAL
  202. #ifndef PASCAL
  203. #define PASCAL pascal
  204. #endif
  205. #ifndef CDECL
  206. #define CDECL cdecl
  207. #endif
  208. #define DB_FAR_PROC far
  209. #else
  210. #ifndef PASCAL
  211. #define PASCAL /**/
  212. #endif
  213. #ifndef CDECL
  214. #define CDECL /**/
  215. #endif
  216. #define DB_FAR_PROC /**/
  217. #endif
  218.  
  219. /* If defined used  far and near keywords */
  220. #define DB_FAR  /**/
  221. #define DB_NEAR /**/
  222.  
  223. #define EXTERNAL_FIXED  DB_FAR_PROC PASCAL
  224. #define INTERNAL_FIXED  PASCAL
  225. #define EXTERNAL_DBN EXTERNAL_FIXED
  226.  
  227.  
  228.  
  229. #define LOCK_DESC /**/
  230. #define POINTER_INIT()        {  NULL  }
  231. #define POINTER_ASSIGN(a)    {  a  }
  232.  
  233.  
  234. typedef struct {char DB_FAR *ptr; LOCK_DESC} CHAR_P;
  235. typedef struct {DB_ADDR DB_FAR *ptr; LOCK_DESC} DB_ADDR_P;
  236. #ifdef MULTI_TASK
  237. typedef struct {struct TASK_S DB_FAR *ptr; LOCK_DESC} TASK_P;
  238. typedef struct {char DB_FAR *ptr; LOCK_DESC} QFAKE_P;
  239.  
  240. typedef struct DB_TASK_S {
  241.    TASK_P v;
  242.    QFAKE_P q;
  243. } DB_TASK;
  244. #define DB_TASK_INIT() { POINTER_INIT(), POINTER_INIT() }
  245. #endif
  246.  
  247.  
  248. /* Allow for function prototyping */
  249. #ifdef LINT_ARGS    /* LINT_ARGS */
  250. #define P0      void    /* parameterless function */
  251. #define P1(t)    t    /* first (or only) parameter in function */
  252. #define Pi(t)    ,t    /* subsequent (2,3,...) parameter in function */
  253. #else            /* ! LINT_ARGS */
  254. #define P0    /**/
  255. #define P1(t)    /**/
  256. #define Pi(t)    /**/
  257. #endif            /* */
  258.  
  259. #ifdef  ONE_DB
  260. #define NO_DBN
  261. #endif
  262.  
  263. #ifdef NO_DBN          /* ! NO_DBN */
  264. #define DBN_D1     P0
  265. #define DBN_Dn     /**/
  266. #define DBN_FIX_D1 P0
  267. #else            /* NO_DBN */
  268. #define DBN_D1     P1(int)
  269. #define DBN_Dn     Pi(int)
  270. #define DBN_FIX_D1 P1(int)
  271. #endif            /* */
  272.  
  273. #ifdef MULTI_TASK    /* MULTI_TASK */
  274. #define TASK_DBN_D1 P1(DB_TASK DB_FAR *) DBN_Dn
  275. #ifndef NO_DBN        /* MULTI_TASK & ! NO_DBN */
  276. #define DBN_TASK_D1 DBN_D1 Pi(DB_TASK DB_FAR *)
  277. #else            /* MULTI_TASK & NO_DBN */
  278. #define DBN_TASK_D1 P1(DB_TASK DB_FAR *)
  279. #endif            /* MULTI_TASK */
  280. #define TASK_D1 P1(DB_TASK DB_FAR *)
  281. #define TASK_Di Pi(DB_TASK DB_FAR *)
  282. #define TASK_PTR_D1 P1(DB_TASK DB_FAR *)
  283. #define TASK_PTR_Di Pi(DB_TASK DB_FAR *)
  284. #ifdef VMS_SHARE
  285. noshare DB_TASK Orgtask;
  286. noshare DB_TASK Currtask;
  287. #else
  288. extern DB_TASK Orgtask;
  289. extern DB_TASK Currtask;
  290. #endif
  291. #define CURRTASK_ONLY &Currtask
  292. #define ONLY_CURRTASK_DBN &Currtask DBN_PARM
  293. #define CURRTASK_PARM , &Currtask
  294. #else            /* ! MULTI_TASK */
  295. #define TASK_DBN_D1 DBN_D1
  296. #ifndef NO_DBN        /* ! MULTI_TASK & ! NO_DBN */
  297. #define DBN_TASK_D1 DBN_D1
  298. #else            /* ! MULTI_TASK & NO_DBN */
  299. #define DBN_TASK_D1 /**/
  300. #endif            /* ! MULTI_TASK */
  301. #define TASK_D1 P0
  302. #define TASK_Di /**/
  303. #define TASK_PTR_D1 P0
  304. #define TASK_PTR_Di /**/
  305. #define CURRTASK_ONLY /**/
  306. #define ONLY_CURRTASK_DBN DBN_ONLY
  307. #define CURRTASK_PARM /**/
  308. #endif            /* */
  309.  
  310. #define LOCK_D1 /**/
  311. #define LOCK_Di /**/
  312.  
  313.  
  314. typedef struct lock_request {
  315.    int  item;  /* record or set number */
  316.    char type;  /* lock type: 'r', 'w', 'x', 'k' */
  317. } LOCK_REQUEST;
  318.  
  319. typedef void (DB_FAR EXTERNAL_FIXED *ERRORPROC)(P1(int) Pi(char DB_FAR *));
  320.  
  321. #ifndef NO_TRANS
  322. #define TRANS_ID_LEN 21
  323. #endif
  324.  
  325. #ifndef  ONE_DB        /* ! ONE_DB */
  326. #ifndef NO_DBN        /* ! ONE_DB & ! NO_DBN */
  327. #define  CURR_DB                 -1
  328. #define     CURR_DB_PARM               , curr_db
  329. #define     CURR_DB_ONLY               curr_db
  330. #define     DBN_PARM                   , dbn
  331. #ifdef ZOR
  332. #define  ADBN_PARM               , int dbn
  333. #endif            /* ! ONE_DB */
  334. #define  DBN_ONLY         dbn
  335. #define     DBN_DECL                   int dbn;
  336. #else            /* ! ONE_DB & NO_DBN */
  337. #define  CURR_DB                 /**/
  338. #define     CURR_DB_PARM               /**/
  339. #define     CURR_DB_ONLY               /**/
  340. #define     DBN_PARM                   /**/
  341. #ifdef ZOR
  342. #define  ADBN_PARM               /**/
  343. #endif            /* ! ONE_DB */
  344. #define  DBN_ONLY         /**/
  345. #define     DBN_DECL                   /**/
  346. #endif            /* ! ONE_DB */
  347. #else            /* ONE_DB */
  348. #define  CURR_DB                 /**/
  349. #define     CURR_DB_PARM               /**/
  350. #define     CURR_DB_ONLY               /**/
  351. #define  DBN_PARM                /**/
  352. #ifdef ZOR
  353. #define  ADBN_PARM               /**/
  354. #endif
  355. #define  DBN_ONLY         /**/
  356. #define     DBN_DECL                   /**/
  357. #endif                  /* */
  358.  
  359.  
  360. #include "dproto.h"
  361.  
  362. #ifdef MULTI_TASK
  363. #include "task.h"
  364. #endif
  365.  
  366. #endif
  367. /* vpp -F -nUNIX -nWINDOWS -nWIN3 -nVANILLA_BSD -nVMS -nOS2 VISTA.h */
  368. /* vpp -F -nFAR_ALLOC -nARCHIVING -nDB_DLL -nBSD -nMEMLOCK -nIS_UNIX_REALLY -nREOPEN_FILES VISTA.h */
  369.