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