home *** CD-ROM | disk | FTP | other *** search
/ PC World 1999 October / PCWorld_1999-10_cd1.bin / delphi / INSTALL / DATA1.CAB / BDE_Help_Files / bdereadme.txt < prev    next >
Text File  |  1999-08-11  |  13KB  |  325 lines
  1. ***********************************************************
  2.               BDE and SQL Links Release Notes
  3. ***********************************************************
  4.  
  5. This file contains important, late-breaking information
  6. about the Borland Database Engine (BDE) and SQL Links for
  7. Windows, including revisions to the documentation.
  8. Information in this file supersedes information in the BDE
  9. and SQL Links documentation where they differ from this
  10. file.
  11.  
  12.  
  13. TABLE OF CONTENTS
  14. ===========================================================
  15.   1. TIPS FOR USING THE BDE AND SQL LINKS
  16.   2. BEHAVIOR CHANGES
  17.   3. DISTRIBUTING THE BDE AND SQL LINKS
  18.   4. BDE AND SQL LINKS DOCUMENTATION
  19.   5. UPDATES, TECHNICAL INFO, AND LATE-BREAKING NEWS
  20.   6. CONFIGURING THE BDE
  21.   7. DOCUMENTATION UPDATES
  22.   8. KNOWN PROBLEMS
  23.  
  24.  
  25. 1. TIPS FOR USING THE BDE AND SQL LINKS
  26. ===========================================================
  27. 1.1 Where to start: SQL Links
  28. -----------------------------
  29. For information about configuring and connecting to SQL
  30. servers, see the Help file SQLLNK32.HLP. This Help file
  31. also contains a "Hints, Problems, and Notes" topic with
  32. tips and troubleshooting information. This help file is
  33. installed in the main BDE directory.
  34.  
  35. Availability of SQL Links is dependent on the Inprise
  36. product used. Consult the documentation for the specific
  37. Inprise product used to see whether SQL Links is included.
  38.  
  39. 1.2 Where to start: BDE
  40. -----------------------
  41. For information about configuring the BDE, working with
  42. aliases, and making ODBC drivers accessible to the BDE, see
  43. the Help file BDEADMIN.HLP. For information on BDE API
  44. functions, see the Help file BDE32.HLP. For information on
  45. migrating data between databases using the Data Pump
  46. utility, see the Help file DATAPUMP.HLP. For information on
  47. using SQL with local tables (dBASE and Paradox) see the
  48. Help file LOCALSQL.HLP. All of these BDE Help files are
  49. installed in the main BDE directory.
  50.  
  51.  
  52. 2. BEHAVIOR CHANGES
  53. ===========================================================
  54. 2.1 Performance Improvements on DbiModifyRecord
  55. -----------------------------------------------
  56. DbiModifyRecord no longer generates an UPDATE statement on
  57. unchanged record buffers. This improves performance.
  58.  
  59. 2.2 InterBase Changes
  60. ---------------------
  61. 2.2.1 Transaction Isolation Levels & InterBase
  62. ----------------------------------------------
  63. By adding 4096 to the setting of DRIVER FLAGS in the
  64. Borland Database Engine (BDE) configuration, you can
  65. specify that the InterBase SQL Links driver should use soft
  66. commits. Soft commits are a feature of InterBase that let
  67. the driver retain the cursor when committing changes. Soft
  68. commits improve performance on updates to large sets of
  69. data. When not used, the BDE must re-fetch all the records,
  70. even for a single record change. With soft commit the
  71. cursor is retained, and a re-fetch is not needed. Soft
  72. commits are never used in explicit transactions started by
  73. BDE client applications. The soft commit property
  74. corresponds to the COMMIT RETAINING transaction option in
  75. the InterBase documentation.
  76.  
  77.   DRIVER FLAGS  Isolation level  Commit type
  78.   ------------  ---------------  ------------
  79.   0             Read committed   hard commit
  80.   512           Repeatable read  hard commit
  81.   4096          Read committed   soft commit
  82.   4608          Repeatable read  soft commit
  83.  
  84. The 4096 driver flag bit only affects implicit transaction
  85. behavior. Use the COMMIT RETAINING property to control the
  86. default commit behavior of explicit transactions.
  87.  
  88. 2.2.2 Roles
  89. -----------
  90. InterBase allows users to log in by specifying a role.
  91. ROLE NAME is a new BDE configuration parameter that allows
  92. BDE clients to pass a role name. ROLE NAME can also be
  93. passed as an optional parameter when using a TDatabase
  94. component (Delphi and C++Builder). 
  95.  
  96. This information supersedes that in the InterBase 5.5
  97. Operations Guide, which indicates that the BDE has no
  98. property for specifying a role name.
  99.  
  100. 2.2.3 Transaction WAIT
  101. ----------------------
  102. Currently, the InterBase SQL Links driver uses NOWAIT when
  103. resolving lock conflicts and returns an error immediately
  104. if there is a resource conflict. Setting the WAIT ON LOCK
  105. configuration parameter allows SQL Links to use WAIT on
  106. InterBase transactions. This can also be done by setting
  107. the r/w database property dbWAITONLOCK to TRUE.
  108.  
  109. 2.2.4 Explicit transactions
  110. ---------------------------
  111. The new BDE configuration parameter COMMIT RETAIN allows
  112. explicit transactions to use soft commit. The new database
  113. property dbCOMMITRETAIN also does this. Only explicit
  114. transactions are affected. The existing driver flags are
  115. still valid for explicit transactions.
  116.  
  117.   COMMIT RETAINING = TRUE    calls isc_commit_retaining()
  118.   COMMIT RETAINING = FALSE   calls isc_commit_transaction()
  119.  
  120. 2.3 Y2K and the FOURDIGITYEAR and YEARBIASED Parameters
  121. -------------------------------------------------------
  122. The information for the FOURDIGITYEAR and YEARBIASED
  123. parameters has changed. The following supersedes the
  124. descriptions in the BDE Administrator online help.
  125.  
  126. FOURDIGITYEAR
  127.   Determines how the BDE treats the century portion of a
  128.   date when only the last two digits of a year are
  129.   specified. If set to FALSE, the century part of the
  130.   date's year is added automatically based on its relative
  131.   position in a baseline range. If the date falls between
  132.   01/01/00 and 12/31/49, the year is considered to be in
  133.   the 21st century (05/20/22 becomes 05/20/2022). If the
  134.   date falls between 01/01/50 and 12/31/99, the date is
  135.   considered as being in the 20th century (12/08/98 becomes
  136.   12/08/1998). A TRUE setting has no effect on dates
  137.   expressed with a century (the year of a new date of
  138.   12/30/1902 remains 1902).
  139.   
  140.   If set to TRUE, the year for the date is assumed to be
  141.   literal (no century digits automatically prefixed to the
  142.   date). For example, a date expressed as 07/72/96 is
  143.   considered to be the year 96 (0096).
  144.   
  145.   FOURDIGITYEAR has an effect in such places as date
  146.   literals in SQL statements.
  147.  
  148. YEARBIASED
  149.   Tells the BDE application whether or not it should add
  150.   the century to years entered as two digits. For example,
  151.   if TRUE and you enter "7/21/96," the BDE application
  152.   interprets your value as "7/21/1996". If set to FALSE,
  153.   the date is interpreted as entered (in this case,
  154.   "7/21/0096"). YEARBIASED uses the same range
  155.   considerations as FOURDIGITYEAR for determining the
  156.   century used.
  157.  
  158.  
  159. 3. DISTRIBUTING THE BDE AND SQL LINKS
  160. ===========================================================
  161. See the file BDEDEPLOY.TXT for specific information
  162. regarding redistributing the BDE and SQL Links with
  163. applications. This file is found in the main BDE directory.
  164.  
  165.  
  166. 4. BDE AND SQL LINKS DOCUMENTATION
  167. ===========================================================
  168.  
  169. Documentation for the Borland Database Engine (BDE) and SQL
  170. Links is only available in the form of on-line Help files
  171. (see "1. TIPS FOR USING THE BDE AND SQL LINKS" for the
  172. names of these files). When the information in the on-line
  173. Help files and this file conflict, the information in this
  174. file should be considered correct.
  175.  
  176.  
  177. 5. UPDATES, TECHNICAL INFO, AND LATE-BREAKING NEWS
  178. ===========================================================
  179. 5.1 How To Get Updates
  180. ----------------------
  181. Updates to the Borland Database Engine (BDE), SQL Links,
  182. and documentation for the two may be distributed in a
  183. number of ways. Updates are available from the BDE
  184. Developer Support Web page. See the URL:
  185.  
  186.   http://www.inprise.com/devsupport/bde/
  187.  
  188. The BDE Developer Support Web page also contains tips,
  189. links to Technical Information sheets (TIs), examples, and
  190. other useful technical information.
  191.  
  192. 5.2 New MS-SQL Server 7 Driver
  193. ------------------------------
  194. The SQL Links (not available with all editions of Inprise
  195. programming tools) driver for Microsoft SQL Server now
  196. supports version 7, in addition to support in the same
  197. driver for version 6.5.
  198.  
  199. SQL Links uses DBLIB (native API for MS-SQL Server).
  200. DBLIB only implements the MS-SQL Server 6.5 feature set.
  201. This means that new types in MS-SQL Server 7 like GUID,
  202. Unicode, and CHAR columns longer than 255 characters are
  203. not supported. Microsoft will not be adding support for
  204. these new types to DBLIB, so the SQL Links driver does not
  205. support these new MS-SQL Server 7 types.
  206.  
  207. Both Microsoft and Inprise strongly recommend that you use
  208. the client software appropriate for the version of MS-SQL
  209. Server used. That is, use version 6.x client software only
  210. with 6.x server software and version 7 client software only
  211. with version 7 server software.
  212.  
  213.  
  214. 6. CONFIGURING THE BDE
  215. ===========================================================
  216. The Borland Database Engine (BDE) comes with the utility
  217. program BDE Administrator. Installed in the main BDE direc-
  218. tory, this utility is used to: configure the BDE; add,
  219. delete, and modify BDE aliases; configure database drivers;
  220. and connect to installed ODBC drivers (this latter
  221. operation not available with all programming tools with
  222. which the BDE is installed).
  223.  
  224. While the installation programs for some programming tools
  225. that include the BDE allow SQL Links to be installed in a
  226. different directory, we highly recommend that you install
  227. SQL Links in the same directory as the BDE. (SQL Links is
  228. not available with all versions of programming tools.)
  229.  
  230.  
  231. 7. DOCUMENTATION UPDATES
  232. ===========================================================
  233. 7.1 New Oracle 8 REF Field Property: curREFINSERTTABLENAME 
  234. ----------------------------------------------------------
  235. When inserting records with a cursor opened with
  236. DbiOpenRef(), BDE needs to know the name of the stand-alone
  237. table into which you wish to insert the record. If this
  238. property has not been set, an error will occur.
  239.  
  240.   DbiSetProp( hCur, curREFINSERTTABLENAME, (UINT32)
  241.     <pszStandAloneTableName> );
  242.  
  243. 7.2 New Oracle 8 REF Field Property: curGETREF
  244. ----------------------------------------------
  245. After inserting a record, the object ID for the newly
  246. inserted record can be obtained by allocating space (the
  247. iLen of the parent's REF field), and  passing this into
  248. DbiGetProp().
  249.  
  250.   DbiGetProp( hCur, curGETREF, pOBJECTID, refSize,
  251.     &iObjectLen );
  252.  
  253.  
  254. 8. KNOWN PROBLEMS
  255. ===========================================================
  256. 8.1 Oracle 8
  257. ------------
  258. The latest Oracle 8.0.4 client is required to work with the
  259. Oracle 8 driver (SQLORA8.DLL). There are known problems in
  260. the Oracle 8.0.3 client.
  261.  
  262. The BDE does not support reference to object members
  263. within live queries.
  264.  
  265. The BDE does not support indexes with nested tables.
  266.  
  267. COLLECTION (NESTED TABLE/VARRAY) and REFERENCE access:
  268. there is a memory loss when fetching data from and
  269. navigating through NESTED TABLE data. This is an Oracle
  270. issue, Oracle problem #593042. The fix for this will be
  271. available from Oracle in the OCI 8.0.4.2 patch.
  272.  
  273. Memory leakage when executing a query many times.
  274. Workaround : call DbiQFree() and DbiQPrepare() every time
  275. the query is executed.
  276.  
  277. 8.3 Sybase CT-LIB SQL Links Driver
  278. ----------------------------------
  279. The CT-Lib driver works with Sybase version 10.0.4 EBF7264
  280. or higher.
  281.  
  282. 8.4 BDE & CGI Applications [43890][12552]
  283. --------------------------
  284. In CGI applications, if the volume of BDE initializations
  285. is high enough (varies with circumstances), error
  286. "Operation not applicable occurs." Only known workaround is
  287. to use ISAPI instead of CGI.
  288.  
  289. 8.5 DbiBatchMove & dBASE/Paradox to Sybase [13320]
  290. ------------------------------------------
  291. DBiBatchMove with Mode value of batCOPY fails when copying
  292. data from Paradox or Dbase table to Sybase table. Failure
  293. is indicated by error "General SQL error."
  294.  
  295. 8.6 SQL Explorer & Sybase 11.5 and Above [43494]
  296. ----------------------------------------
  297. Applied to Enterprise edition of BDE-using programming
  298. tools only). Edit DBX.DBI with a text editor (such as
  299. NotePad). DBX.DBI is located in the directory in which SQL
  300. Explorer was installed. Change the line:
  301.  
  302.   SYBASE:IdentityRE=SQL Server/([0-9]+)\.
  303.   
  304. The line should be changed to:
  305.  
  306.   SYBASE:IdentityRE=[SQL Server][Adaptive Server Enterprise]/([0-9]+)\.
  307.  
  308. 8.7 DB/2 and Decimal Separators
  309. -------------------------------
  310. Certain versions of the DB/2 client library return decimal
  311. separators specified in the Windows regional settings. If
  312. the decimal separator is set in the Windows regional
  313. settings to other than a period ("."), this can cause
  314. problems when working with NUMERIC and DECIMAL data types
  315. with the BDE configuration setting ENABLE BCD is set to
  316. TRUE. The IBM library should always return a period as the
  317. decimal separator, regardless of the regional settings.
  318.  
  319.  
  320. ===========================================================
  321. Unless otherwise noted, all materials provided in this
  322. release are Copyright 1983 - 1999 by Inprise Corporation.
  323. ========================= END =============================
  324.                                                   
  325.