home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 6 / 06.iso / a / a563 / 5.ddi / BTRIEVE.TX$ / BTRIEVE.bin
Encoding:
Text File  |  1993-05-26  |  6.5 KB  |  177 lines
  1.        ------------------------------------------------
  2.        Microsoft Access Version 1.1 Btrieve Information
  3.                        May 1993
  4.        ------------------------------------------------
  5.  
  6.        (C) Copyright Microsoft Corporation, 1993
  7.  
  8. This document provides supplementary information on configuring
  9. Btrieve for use with Microsoft Access.  Before you import, 
  10. export, or attach Btrieve tables with Microsoft Access, please 
  11. read this file.
  12.  
  13.  
  14. --------
  15. Contents
  16. --------
  17.  
  18. General Considerations
  19. Using Compressed Data Files
  20. Using Btrieve in a Multiuser Environment
  21. Using Btrieve Indexes
  22. Setting Btrieve Options in WIN.INI
  23. Configuring the Server-Based Version (BTRIEVE.NLM)
  24.  
  25.  
  26.  
  27. ----------------------
  28. General Considerations
  29. ----------------------
  30.  
  31. When using Btrieve data with Microsoft Access, keep the following
  32. considerations in mind:
  33.  
  34. - Btrieve data files must be in version 5.1x format.
  35.  
  36. - You must have the data definition files FILE.DDF and FIELD.DDF,
  37.   which tell Microsoft Access the structure of your tables.  These
  38.   files are created by Xtrieve or another .DDF file-building 
  39.   program.
  40.  
  41. - You must have the Btrieve for Windows dynamic-link library
  42.   WBTRCALL.DLL, which isn't provided with Microsoft Access.
  43.   This file is available with Novell Btrieve for Windows, Novell
  44.   NetWare SQL, and some other products for Windows that use Btrieve.
  45.  
  46. - You can't use Btrieve files that have Xtrieve security.  To use
  47.   data files with Microsoft Access, disable Xtrieve security.
  48.  
  49.  
  50. ---------------------------
  51. Using Compressed Data Files
  52. ---------------------------
  53.  
  54. If you're using compressed Btrieve files, you must be sure that
  55. the compression buffer Btrieve is using is adequate for your data.
  56. The buffer size must be at least as large as the largest record
  57. in your data files.
  58.  
  59. To ensure proper operation, set the compression buffer size 
  60. option (/u) in the [btrieve] section of your WIN.INI file.  The
  61. units for this setting are kilobytes, so if your largest record 
  62. is 2K, you would add /u:2 to the Btrieve options line in WIN.INI.
  63.  
  64. For more information on setting options, see "Setting Btrieve
  65. Options in WIN.INI" later in this file.
  66.  
  67.  
  68. ----------------------------------------
  69. Using Btrieve in a Multiuser Environment
  70. ----------------------------------------
  71.  
  72. If you're using Btrieve in a multiuser environment, you must
  73. use the same transaction file (BTRIEVE.TRN) as other users on 
  74. the network.  To do this, set the transaction file name option 
  75. (/t) in the Btrieve section of your WIN.INI to point to the 
  76. network location of BTRIEVE.TRN.
  77.  
  78. For more information on setting options, see the next section
  79. of this file.
  80.  
  81.  
  82. ---------------------
  83. Using Btrieve Indexes
  84. ---------------------
  85.  
  86. Microsoft Access automatically uses indexes in attached Btrieve
  87. tables when searching or sorting.  However, some types of indexes
  88. aren't supported.  If an index was defined with the Btrieve index
  89. attributes Manual or Null, Microsoft Access won't use the index.
  90. In addition, Microsoft Access won't use an index that has an 
  91. alternate collating sequence specified.
  92.  
  93. To get the best performance when you use attached Btrieve tables,
  94. make sure your indexes aren't one of these types.
  95.  
  96. For information about Btrieve indexes, please refer to the Btrieve
  97. Programmer's Manual.
  98.  
  99. ----------------------------------
  100. Setting Btrieve Options in WIN.INI
  101. ----------------------------------
  102.  
  103. When you install Microsoft Access, Setup adds the following
  104. section to the WIN.INI file in your Windows directory:
  105.  
  106. [btrieve]
  107. options=/m:64 /p:4096 /b:16 /f:20 /l:40 /n:12 /t:C:\ACCESS\BTRIEVE.TRN
  108.  
  109. Although these are the recommended option settings, you can
  110. change these options in your WIN.INI file using the following
  111. table as a guide.  If the option you want to set is not on
  112. the line, add the option and desired setting at the end.
  113.  
  114. Option Description                Required value
  115. ------ -----------                --------------
  116. /m     Memory size                At least 38
  117. /p     Page size                  4096
  118. /b     Pre-image buffer size      16
  119. /f     Open files                 At least 4
  120. /l     Multiple locks             At least double the setting for
  121.                                     the Open Files option (/f)
  122. /n     Files in a transaction     At least 4
  123. /t     Transaction file name      Valid path to a .TRN file;
  124.                                     in a multiuser environment,
  125.                                     network path to the .TRN
  126.                                     file shared by all users
  127. /u     Compression buffer size    If your Btrieve data files are
  128.                                     compressed, at least the length
  129.                                     (in kilobytes) of the longest
  130.                                     record in your data files
  131. /i     Pre-image file drive
  132. /c     Index compaction
  133. /a     Activate logging
  134. /s     Discard unneeded segments
  135.  
  136.  
  137. --------------------------------------------------
  138. Configuring the Server-Based Version (BTRIEVE.NLM)
  139. --------------------------------------------------
  140.  
  141. If you're using the server-based version of Btrieve (BTRIEVE.NLM), 
  142. there are several considerations you must keep in mind about your 
  143. configuration.  Before you use Btrieve data with Microsoft Access, 
  144. you should check for the following:
  145.  
  146. - You must have the following section in your WIN.INI file:
  147.  
  148.   [BREQUESTDPMI]
  149.   datalength=4096
  150.   tasks=10
  151.   local=no
  152.   chkparms=no
  153.  
  154. - You must have transactions enabled on your NLM server.
  155.  
  156. - You must be using version 6.0 of the NLM requestor files-- 
  157.   BREQUEST.EXE, WBTRCALL.DLL, and WBTRVRES.DLL.  (However, note
  158.   that you must still be using version 5.1x data file format.)
  159.  
  160. If you don't have the correct versions of these files, you won't
  161. be able to use Btrieve with Microsoft Access.  If you have access
  162. to Compuserve, you can download the necessary files for this 
  163. configuration using the instructions below.  If you don't have a
  164. Compuserve account, contact your Novell representative and ask
  165. for the 6.0 versions of the requestor files.
  166.  
  167.  
  168. To update your Btrieve NLM files from Compuserve:
  169.  
  170. 1. Connect to Compuserve and GO NOVLIB.
  171. 2. Go into the Btrieve/XQL library section.
  172. 3. Download the file BT515.ZIP, and then unpack the file using PKUNZIP.EXE.
  173. 4. Unpack the file BTRREQ.ZIP (one of the files from BT515.ZIP).  
  174. 5. Follow the instructions in the README file for installing the
  175.    resulting files and applying necessary patches to the 
  176.    BTRIEVE.NLM file on your server.
  177.