home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 7 / 07.iso / c / c150 / 1.ddi / TRLOG.C < prev    next >
Encoding:
C/C++ Source or Header  |  1990-12-11  |  3.8 KB  |  135 lines
  1. /*-----------------------------------------------------------------------
  2.    trlog.c -- Transaction logging function stubs
  3.  
  4.    Copyright (c) 1984-1990, Raima Corporation, All Rights Reserved
  5. -----------------------------------------------------------------------*/
  6.  
  7. /* ********************** EDIT HISTORY *******************************
  8.  
  9.  SCR    DATE    INI                   DESCRIPTION
  10. ----- --------- --- -----------------------------------------------------
  11.   310 10-Aug-88 RSC Cleanup function prototype.
  12.       16-Aug-88 RTK Added function prototype.
  13.   532 06-Jan-89 RSC Fixed to compile correctly for NO_TRANS
  14.   571 27-Jan-89 RSC Removed include dbtype, added defn of trlog_flag
  15. */
  16.  
  17. #include <stdio.h>
  18. #include "vista.h"
  19.  
  20. #ifndef NO_TRANS
  21.  
  22.  
  23. /* Transaction logging functions:
  24.  
  25.    This module is intended to provide the hooks for implementing 
  26.    "after image" transaction logging which allows the re-creation 
  27.    of a (damaged) database from the last backup up to the time the 
  28.    database problem occurred.
  29.  
  30.    Transaction logging is initiated by setting the external variable
  31.    "trlog_flag" to 1 (through the call to d_tron).  Once initiated,
  32.    function d_trmark is called by d_trend in order to mark the
  33.    beginning of a transaction update which will follow as a sequence
  34.    of calls to d_trlog, one for each page being written to the database.  
  35.    Function d_trbound (called after all database pages have been 
  36.    successfully written to the database) is intended to delimit the 
  37.    end of a transaction on the logging device.
  38.    
  39.    The transaction logging device is normally a cartridge or nine
  40.    track tape unit.  These functions must ensure that shared 
  41.    access to the logging device be protected against simultaneous use.
  42.  
  43.    The information which must minimally be stored is as follows:
  44.       
  45.       Transaction mark:
  46.  
  47.      - an arbitrary mark code 
  48.      - transaction id
  49.      - time/date stamp
  50.  
  51.       Transaction information (one for each changed page):
  52.  
  53.      - transaction id
  54.      - time/date stamp
  55.      - file number
  56.      - page number
  57.      - page contents
  58.      - page size
  59.  
  60.       Transaction boundary:
  61.  
  62.      - an arbitrary bound code
  63.      - transaction id
  64.      - time stamp
  65. */
  66.  
  67. extern int trlog_flag;
  68.  
  69. /* ======================================================================
  70.    Mark the start of transaction
  71. */
  72. int EXTERNAL_FIXED d_trmark()
  73. {
  74.    /* 
  75.       this should first secure exclusive access to
  76.       the logging device and then mark the start of the
  77.       transaction.
  78.    */
  79.    return(0);
  80. }
  81.  
  82. /* ======================================================================
  83.    Bound the end of a transaction
  84. */
  85. int EXTERNAL_FIXED d_trbound()
  86. {
  87.    /*
  88.       This should first bound the end of the transaction
  89.       and then release the logging device from exclusive access.
  90.    */
  91.    return(0);
  92. }
  93.  
  94. /* ======================================================================
  95.    Log a changed db page
  96. */
  97. /*ARGSUSED*/
  98. int EXTERNAL_FIXED d_trlog(fno, pno, page, psz)
  99. int fno;     /* file number */
  100. int pno;     /* page number */
  101. CONST char DB_FAR *page;  /* page contents */
  102. int psz;     /* page size   */
  103. {
  104. #ifdef MSC
  105.     /* These references eliminate compile-time warnings */
  106.     fno;
  107.     pno;
  108.     page;
  109.     psz;
  110. #endif
  111.     return(0);
  112. }
  113.  
  114. /* ======================================================================
  115.    Turn on tr logging
  116. */
  117. int EXTERNAL_FIXED d_tron()
  118. {
  119.    trlog_flag = 1;
  120.    return(0);
  121. }
  122.  
  123. /* ======================================================================
  124.    Turn off tr logging
  125. */
  126. int EXTERNAL_FIXED d_troff()
  127. {
  128.    trlog_flag = 0;
  129.    return(0);
  130. }
  131.  
  132. #endif /* NO_TRANS */
  133. /* vpp -F -nUNIX -nWIN3 -nVANILLA_BSD -nWINDOWS -nVMS -nOS2 TRLOG.c */
  134. /* vpp -F -nFAR_ALLOC -nARCHIVING -nDB_DLL -nBSD -nMEMLOCK -nIS_UNIX_REALLY -nREOPEN_FILES TRLOG.c */
  135.