home *** CD-ROM | disk | FTP | other *** search
/ Java 1.2 How-To / JavaHowTo.iso / 3rdParty / jbuilder / TRIAL / DATAGTWY / README.TXT < prev    next >
Encoding:
Text File  |  1997-11-04  |  16.4 KB  |  409 lines
  1. BORLAND DATAGATEWAY FOR JAVA (R) ONLINE RELEASE NOTES
  2. =======================================================
  3. Welcome to Borland DataGateway for Java!
  4.  
  5. Unless otherwise noted, all materials provided in this
  6. software are copyright (C) 1997 by Borland International.
  7.  
  8. TABLE OF CONTENTS
  9. -------------------
  10.  
  11.  1.  Introduction
  12.  2.  System and software requirements for DataGateway
  13.  3.  Installing DataGateway
  14.  4.  Uninstalling DataGateway
  15.  5.  DataGateway Developers Kit information
  16.  6.  DataGateway sample applications and applets 
  17.  7.  Connecting to MS Access data sources using DataGateway
  18.  8.  Using JDBCTest to test DataGateway features
  19.  9.  Known problems and compatibility issues
  20.  10. DataGateway documentation
  21.  11. Purchasing DataGateway
  22.  12. For more information
  23.  
  24. 1. INTRODUCTION
  25. *****************
  26.  
  27. Borland DataGateway provides Java developers a multi-tier, fast, and 
  28. reliable database connectivity solution adhering to industry standard 
  29. JDBC.
  30.  
  31. There are three different versions of DataGateway, each designed to 
  32. meet your specific development needs.
  33.  
  34.  - DataGateway Developers Kit: The Developers Kit allows you to 
  35.    develop and test your Java database applications.  Native desktop 
  36.    database drivers and SQL Links drivers for connecting to SQL 
  37.    databases are included with the Borland Database Engine.  There 
  38.    is a limit of 5 connections to the DataGateway Server with the 
  39.    Developers Kit, and you agree not to deploy any applications 
  40.    that use DataGateway.  Each time you connect to the DataGateway 
  41.    Server, a notification dialog box appears that reminds you of the 
  42.    licensing agreement for the Developer's Kit.
  43.  
  44.  - DataGateway Professional: DataGateway Professional provides the 
  45.    most comprehensive high-performance, high-quality, 100% Java JDBC 
  46.    connectivity to workgroup data. Native drivers for Paradox, dBASE, 
  47.    FoxPro, and ODBC support for MS Access are included with the Borland
  48.    Database Engine to connect your Java applications and applets to desktop data 
  49.    sources. There is no limit on the number of connections the 
  50.    DataGateway Server can have open, and you may deploy applications 
  51.    and applets that use DataGateway classes.
  52.  
  53.  - DataGateway Enterprise: DataGateway Enterprise provides a 100% Java 
  54.    connection to all your business critical data, providing native 
  55.    drivers for Oracle, Sybase, DB2, Microsoft SQL Server, Informix, 
  56.    Borland InterBase, Paradox, dBASE, and FoxPro. MS-Access and other
  57.    databases are supported via ODBC.  There is no limit on the number of 
  58.    connections the DataGateway Server can have open, and you may deploy 
  59.    applications and applets that use DataGateway classes.
  60.  
  61. 2. SYSTEM AND SOFTWARE REQUIREMENTS FOR DATAGATEWAY
  62. *****************************************************
  63.  
  64.  - 486 or better processor
  65.  - Windows 95, Windows NT 3.51 or greater
  66.  - 24 Mb RAM
  67.  - 8 Mb disk space for compact install, 20 Mb disk space for full install
  68.  - CD-ROM Drive
  69.  - VGA monitor
  70.  - Mouse
  71.  - A TCP/IP connection
  72.  - A Java development environment, such as Borland JBuilder or Sun's Java
  73.    Development Kit 1.1
  74.                        
  75. 3. INSTALLING DATAGATEWAY
  76. ***************************
  77.  
  78. Before installing DataGateway
  79. ------------------------------
  80. Important: Before installing DataGateway, uninstall any previous versions of
  81. DataGateway installed on your system otherwise a "mismatch in protocol" or 
  82. "connection refused" message could result. For information on how to uninstall
  83. previous versions of DataGateway, see "Uninstalling DataGateway" below.
  84.  
  85. During the installation do not select the Java Runtime Environment option
  86. in the install program if you already have a Java development environment
  87. (such as Borland JBuilder or Symantec Visual Cafe) installed.  
  88. See "Mismatching of Java files" below if you installed a Java development
  89. environment prior to installing DataGateway and  you selected the 
  90. Java Runtime Environment option in the DataGateway install program.
  91.  
  92. If you are installing DataGateway and SQL Links for use with 
  93. Sybase version 4.2 or earlier, select DB-Lib when prompted by the 
  94. installation utility. CT-Lib is recommended for use with System 10 and 
  95. later. If you have already installed DataGateway and want to change this 
  96. setting see "Changing the Sybase driver" below.
  97.  
  98. For more information on installing DataGateway, see "Installing 
  99. DataGateway" in the DataGateway User's Guide.
  100.  
  101. Installing DataGateway
  102. -----------------------
  103. Follow these steps to install DataGateway:
  104.  
  105.  1. Insert the DataGateway CD into your CD-ROM drive. (The following 
  106.     instructions assume you are using drive D. Substitute your 
  107.     drive letter if necessary.) 
  108.  2. Choose Start|Run.
  109.  3. Enter d:\setup.exe. 
  110.  4. Choose OK.
  111.  5. Follow the instructions on the screen.
  112.  
  113.  
  114. 4. UNINSTALLING DATAGATEWAY
  115. *****************************
  116.  
  117. Follow these steps to uninstall DataGateway:
  118.  
  119.  1.  From the Start menu, go to the DataGateway program group.
  120.  2.  Click Uninstall. 
  121.  3.  Follow the instructions on the screen.
  122.  
  123.  
  124. 5. DATAGATEWAY DEVELOPERS KIT INFORMATION
  125. *******************************************
  126.  
  127. Built-in limitations
  128. ----------------------
  129. The Developers Kit has the following built in limitations:
  130.  
  131.  - A five connection limit for the DataGateway Server.
  132.  - A notification dialog box that appears whenever you connect to a 
  133.    data source.
  134.  - You agree not to deploy any applications or applets that use any 
  135.    of the components in the Developers Kit.
  136.  
  137. Dismissing the notification dialog in console applications
  138. ------------------------------------------------------------
  139. If you are writing a console application, the notification dialog 
  140. box will appear when you connect to the DataGateway Server. To
  141. terminate the dialog box, call the System.exit method.
  142.  
  143. Developers Kit license file
  144. -----------------------------
  145. Do not modify the license file (jdbc_license.dat).  Any modifications
  146. to the license file will disable DataGateway.
  147.  
  148.  
  149. 6. DATAGATEWAY SAMPLE APPLICATIONS AND APPLETS
  150. ************************************************
  151.  
  152. Included with DataGateway are a number of sample applications 
  153. and applets that use DataGateway classes. 
  154.  
  155. For more information about the sample applications and applets, 
  156. see "DataGateway sample applications and applets" in the User's 
  157. Guide.  A short description of the sample applications and applets
  158. is also included in the file Samples.txt located in the 
  159. \DataGateway\samples directory.
  160.  
  161. Using Visual J++ with DataGateway sample applications and applets
  162. -------------------------------------------------------------------
  163. If you are using Visual J++, use the jview program to run the sample 
  164. programs at the command line.  For example, to run the SampleApp sample
  165. application at the command line enter:
  166.  
  167. jview SampleApp Remote localhost 
  168.  
  169.  
  170. 7. CONNECTING TO MS ACCESS DATA SOURCES USING DATAGATEWAY
  171. ***********************************************************
  172.  
  173. To connect to MS Access databases, you must use an Access
  174. ODBC driver.  DataGateway requires an Access ODBC driver. See
  175. http://www.microsoft.com for details of available MS Access drivers.
  176. The Access ODBC driver is required because Access (specifically DAO)
  177. doesn't support multiple threads.  The DataGateway Server uses
  178. multiple threads and will reject connections that specify Access
  179. as the driver. To connect to MS Access databases, specify an
  180. Access ODBC driver as the driver when calling getConnection.
  181. In the DataGateway Professional version, the Access ODBC driver
  182. will only allow connection to Access databases. It will block 
  183. connections to non-Access data sources via ODBC. In both the
  184. DataGateway Developers Kit and Enterprise versions connection
  185. to all ODBC data sources is available.
  186.  
  187. The Bridge, which bypasses the Server, will allow you to connect to 
  188. Access data sources, but the limitations of the Bridge still apply 
  189. (the program can only be run on the same machine as the Access database 
  190. and the BDE).
  191.  
  192.  
  193. 8. USING JDBCTEST TO TEST DATAGATEWAY FEATURES
  194. ************************************************
  195.  
  196. JDBCTest is a free tool provided by Intersolv. It is a graphical, 
  197. menu-driven program that allows developers to test and learn the 
  198. JDBC API. It is written in Java and can be used as a program.
  199. You may download JDBCTest from JavaSoft's ftp site:
  200. ftp://splash.javasoft.com/pub/JDBCTest1_03.zip.
  201.  
  202. For more information on using JDBCTest, see "Testing DataGateway 
  203. features" in the DataGateway User's Guide.
  204.  
  205.  
  206. 9. KNOWN PROBLEMS AND COMPATIBILITY ISSUES
  207. ********************************************
  208.  
  209. Database drivers must support multiple threads
  210. -------------------------------------------------
  211. All remotely accessed databases must be thread-safe in order 
  212. to work with DataGateway.  MS Access and Oracle 7.1 (and previous 
  213. versions) are not thread-safe and will not work with DataGateway.  
  214. To connect to MS Access data sources, use an ODBC Access driver. 
  215. For more information, see "Connecting to MS Access data sources 
  216. using DataGateway" in this file.
  217.  
  218.  
  219. Changing the Sybase driver
  220. ---------------------------
  221. To change the Sybase driver, use the BDE Administrator program 
  222. and follow these steps:
  223.  
  224.  1.  On the Configuration tab, follow the tree to Configuration|Drivers|
  225.      Native|Sybase.
  226.  2.  On the Definition tab in the right pane, select the DLL32 parameter.
  227.  3.  Using the drop down tab, select either SQLSSC32.DLL for CT-Lib or 
  228.      SQLSYB32.DLL for DB-Lib.
  229.  4.  Save your changes and exit the program.
  230.  
  231.  
  232. Visual J++ 1.1 doesn't support using the DataGateway Bridge
  233. ------------------------------------------------------------
  234. Visual J++ 1.1 doesn't support using the DataGateway Bridge to access 
  235. local data sources.  To connect to a local database, run the 
  236. DataGateway Server and use the Client and Server specifying 
  237. localhost as the machine name. 
  238.  
  239. For more information on using Visual J++ with DataGateway, see 
  240. "Using DataGateway with Visual J++" in the User's Guide.
  241.  
  242.  
  243. Path environment variable must include Java VM path
  244. ----------------------------------------------------
  245. If you attempt to run a Java application or applet and get an error
  246. dialog box with the description "A required .DLL file, JAVAI.DLL, 
  247. was not found" your Path environment variable is missing your Java
  248. VM path information.  To resolve the problem, add the path to the 
  249. ..\Java\bin directory (installed with a Java development environment 
  250. such as Borland JBuilder or Sun's Java Development Kit 1.1) in the Path 
  251. environment variable. By default Javai.dll is located in the 
  252. ..\Java\bin directory.
  253.  
  254.  
  255. Classpath environment variable not correctly updated during installation
  256. -------------------------------------------------------------------------
  257. If you've installed DataGateway prior to installing your Java 
  258. development environment, the Classpath environment variable setting
  259. will need to be updated.  For complete instructions on manually 
  260. updating the Classpath, see "Using DataGateway with Java development
  261. tools" in the DataGateway User's Guide.  Specific instructions are provided
  262. for Borland JBuilder, Symantec Visual Cafe Pro 1.1, and Microsoft Visual 
  263. J++ 1.1.
  264.  
  265. An unsupported utility, Dg_int.exe, has been provided to automate the
  266. updating of the Classpath environment variable. It will automatically
  267. update the environment correctly for JBuilder, Visual Cafe Pro 1.1, 
  268. and Visual J++ 1.1.  To run the utility,
  269.  
  270.  1. Locate Dg_int.exe in the \Tools directory on the DataGateway CD
  271.  2. Run Dg_int.exe
  272.  3. Follow the instructions on the screen to update the Classpath 
  273.     setting.
  274.  
  275.  
  276. Mismatching of Java files
  277. --------------------------
  278. If you installed a Java development environment (such as Borland 
  279. JBuilder or Symantec Visual Cafe) prior to installing DataGateway and 
  280. you selected the Java Runtime Environment option in the DataGateway install program
  281. this may result in duplication and mismatching between Java files.  
  282. To correct this, uninstall DataGateway and reinstall without selecting
  283. the Java Runtime Environment option.
  284.  
  285.  
  286. Queries on tables with LONG fields
  287. -----------------------------------
  288. Queries on tables containing type LONG fields will return the LONG 
  289. fields as type DOUBLE.
  290.  
  291.  
  292. CANNOT CREATE dBASE LOCK FIELDS
  293. -------------------------------
  294. Cannot create DBASELOCK fields from jdbc.
  295.  
  296.  
  297. DISCONNECTING FROM INFORMIX
  298. ---------------------------
  299. Informix only: disconnecting may cause application to crash.
  300.  
  301.  
  302. DbiUseIdleTime no longer supported
  303. ----------------------------------
  304. The BDE no longer supports DbiUseIdleTime. Use DbiSaveChanges 
  305. instead.
  306.  
  307.  
  308. Connecting to a database twice with ODBC 3.4
  309. --------------------------------------------
  310. Due to a known bug in Microsoft's ODBC 3.4, connecting to
  311. a database twice with this driver can cause the IDE to shut 
  312. down. This problem is fixed in ODBC 3.5.
  313.  
  314.  
  315. Adding indexes
  316. --------------
  317. Windows NT 3.51 Service Pack 5 fixes a problem where calling 
  318. DbiGetNextRecord will erroneously return DBIERR_EOF after calling 
  319. DbiAddIndex.
  320.  
  321. Local SQL: Querying logical fields  
  322. ----------------------------------
  323. In Local SQL, when querying logical fields do not use single or 
  324. double quotes around the boolean literal in the criteria.  
  325. For example, the following SQL statement is the correct syntax:
  326.  
  327.      SELECT pboolean FROM table WHERE pboolean = True
  328.  
  329.  
  330. Using long field names with the AS clause
  331. -----------------------------------------
  332. When the AS clause is used to rename a field name, it includes the 
  333. table (or alias) name, therefore increasing the length significantly.
  334. If the total length exceeds 31 characters an error message will be 
  335. displayed.
  336.  
  337.  
  338. ORACLE - SQL NET 2.3.3: ACCESS VIOLATION WHILE DEBUGGING 
  339. --------------------------------------------------------
  340. Under NT4 and any debugger (TD or an integrated debugger) 
  341. with SQL Net 2.3.3, an error 'access violation at 0xbe4278d: 
  342. read of address 0xfffd5ae0' occurs. Using BDE version 3.11 
  343. or 3.10 throws the correct exception 'external exception 
  344. C0000008'. Deleting the value in the following registry entry 
  345. causes the AV to go away:
  346.  
  347.   HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE\OTRACE73
  348.  
  349.  
  350. Access Driver
  351. -------------
  352. Some functionality is not yet implemented in this release. BCD
  353. (binary coded decimal) support is not available. Key-violation
  354. tables cannot be created with DbiAddIndex. (All other DbiAddIndex
  355. functionality is supported.) QBE, heterogeneous queries, and
  356. queries using the local SQL engine are not supported. In the
  357. SDK, DbiDoRestructure and DbiRegenIndex are not available.
  358.  
  359. Because DAO 3.0 (Access 95) is not thread-safe, all database
  360. functions must occur in the application's primary thread
  361.  
  362. MS Access does not support opening a table that has
  363. already been opened exclusively. Hence opening a table
  364. when TTable.Exclusive is set to True prevents the user
  365. from opening that table again, even in same session.
  366.  
  367. Use a BLOB as a parameter in a query only if the BLOB data is
  368. less than 256 bytes.
  369.  
  370. 10. DATAGATEWAY DOCUMENTATION
  371. *******************************
  372.  
  373. For more information concerning using DataGateway refer to the 
  374. DataGateway documentation provided in HTML format. The 
  375. DataGateway User's Guide is installed in the \DataGateway\doc
  376. directory. Open UsersGuide.html in any web browser to begin.  
  377.  
  378. Print version of the DataGateway User's Guide available
  379. ---------------------------------------------------------
  380. A print version of the User's Guide is included with purchased
  381. versions of Borland DataGateway.  For more information,
  382. see DataGateway's homepage at http://www.borland.com/datagateway/.
  383.  
  384.  
  385. 11. PURCHASING DATAGATEWAY
  386. ****************************
  387.  
  388. DataGateway can be ordered directly from Borland's DataGateway home page 
  389. at http://www.borland.com/datagateway/.  When you order DataGateway you 
  390. will receive a printed version of the DataGateway User's Guide in addition
  391. to the DataGateway CD.
  392.  
  393.  
  394. 12. FOR MORE INFORMATION
  395. **************************
  396.  
  397. For support information refer to the following resources:
  398.  
  399.  - DataGateway newsgroup: news://forums.borland.com/borland.public.datagateway
  400.  - DataGateway's home page: http://www.borland.com/datagateway/ 
  401.  - General Borland information: http://www.borland.com/
  402.  - Borland's FTP site: ftp.borland.com
  403.  - Electronic newsletters: http://www.borland.com/feedback/listserv.html
  404.  - International listserver: http://www.borland.com/feedback/intlist.html
  405.  - Techfax, technical documents available by fax: 1-800-822-4269 (North 
  406.    America)
  407.  
  408. -------------------------------------end--------------------------------------
  409.