home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / odbc_hlp.zip / odbc_doc.zip / iv_read.me next >
Text File  |  1996-11-22  |  12KB  |  371 lines
  1.     READ.ME
  2.     INTERSOLV DataDirect ODBC Pack for OS/2
  3.     Version 2.11
  4.     September 30, 1995
  5.  
  6. This README file contains information not included in the INTERSOLV 
  7. DataDirect ODBC Drivers Reference.  This file contains information 
  8. about the following topics:
  9.  
  10. What's New since Version 2.0
  11. Available DataDirect ODBC Drivers
  12. Installing the DataDirect ODBC Pack
  13. Files Installed
  14. For MicroDecisionware Driver Users
  15. For SQL Server Driver Users
  16. Setting the Driver Manager Trace
  17. Using the ODBC Demonstration Application
  18. OS/2 Multithread Applications
  19. OS/2 Warp Considerations
  20. Notes and Known Problems
  21. Compiler Issues
  22. ODBC Demo 
  23. Contacting INTERSOLV Answerline for Technical Support
  24.  
  25.  
  26.     What's New since Version 2.0
  27.  
  28. The following list summarizes the new features since version 2.0.
  29.  
  30. New Drivers
  31. - DB2/2 driver (IVDB208.DLL)
  32. - MicroDecisionware driver (IVMDI08.DLL)
  33.  
  34. All Drivers
  35. - Now fully compliant with version 2.10 of the ODBC specification
  36. - Now support translation DLLs
  37. - Have new filenames, with "QE" replaced by "IV," for example, 
  38. "IVDB08.DLL."
  39.  
  40. Many Drivers
  41. - Now support ODBC right outer join syntax
  42.  
  43. dBASE Driver
  44. - Now supports long filenames as table names and
  45.   long pathnames as table qualifiers
  46. - Now supports FOR expressions that contain the clauses AND,
  47.   NOT, OR, and NOT DELETED
  48. - Now opens tables in a read-only mode when an index is opened
  49.   that contains a FOR expression or an index expression that
  50.   is not recognized by the driver
  51.  
  52. Flat-File Drivers (dBASE and Text)
  53. - Now support the SQLSetPos function
  54. - Now support subqueries in INSERT statements
  55. - Many queries are optimized so that they execute faster. 
  56.   For example, OR predicates or IN predicates may now use indexes.
  57.  
  58. INFORMIX 5 Driver
  59. - Now supports databases that do not have transaction logging enabled
  60. - Offers an option to support scrollable cursors
  61. - Uses tables from different databases via database qualifiers
  62.  
  63. INGRES 6.4/04 Driver
  64. - Includes many performance tuning options
  65. - No longer requires that you set the II_DATE_FORMAT environment 
  66.   variable to US
  67. - Now supports the SQLPrimaryKeys ODBC level 2 function
  68.  
  69. SQL Server Driver
  70. - Now supports Microsoft SQL Server version 6.0
  71.  
  72. SQLBase Driver
  73. - Now supports SQLBase 6.x and includes support for SQLBase stored 
  74.   procedures
  75.  
  76. System 10 DRIVER
  77. - Offers many new performance tuning options 
  78.  
  79. Text Driver
  80. - Now supports long pathnames as table qualifiers
  81.  
  82.  
  83.     Available DataDirect ODBC Drivers
  84.  
  85. The following drivers are available:
  86.  
  87. DRIVER                          SUPPORTS
  88. ------                          --------
  89. DB2/2 (IVDB208.DLL)        DB2 (DDCS/2 or DDCS/6000), DB2/2, 
  90.                 DB2/6000, SQL/DS (DDCS/2 or DDCS/6000)
  91.  
  92. dBASE (IVDBF08.DLL)        dBASE III, IV, and V files, Clipper 
  93.                 files, FoxBASE files, FoxPro files 
  94.                 versions 1, 2.5
  95.  
  96. INFORMIX (IVINF508.DLL)        INFORMIX 5
  97.  
  98. INGRES 6.4/04 (IVING408.DLL)    INGRES Release 6.4/04
  99.  
  100. MicroDecisionware (IVMDI08.DLL)    IBM Database 2 (DB2) and InfoHub
  101.  
  102. Oracle 7 (IVOR708.DLL)        Oracle 7
  103.  
  104. Oracle (IVORA08.DLL)        Oracle 6
  105.  
  106. SQLBase (IVGUP08.DLL)        Gupta SQLBase
  107.  
  108. SQL Server (IVSS08.DLL)        SQL Server from Microsoft and Sybase
  109.  
  110. System 10 (IVSYB08.DLL)        System 10 from Sybase
  111.  
  112. Text (IVTXT08.DLL)        ASCII text files
  113.  
  114. The ODBC Drivers are compliant with OS/2 2.x and 3.x and are all 32-bit 
  115. drivers. The relational database network support drivers should all be 
  116. 32-bit compliant. For more information, refer to "ODBC Drivers 
  117. Reference," specifically, the "System Requirements" section in each 
  118. chapter.
  119.  
  120.  
  121.     Installing the DataDirect ODBC Pack
  122.  
  123. For information about installing the DataDirect ODBC Pack, refer to the 
  124. Installation Guide for OS/2. 
  125.  
  126.  
  127.  
  128.     Installed Files
  129.  
  130. If you install all drivers, Setup copies the following files to the 
  131. product installation directory, by default, \IVODBC:
  132. IVDRV08.HLP
  133. READ.ME        This READ.ME file
  134.  
  135. Setup copies the following files to the \IVODBC\DEMO directory:
  136. DEMOODBC.COD    ODBC Demonstration resource file
  137. DEMOODBC.CPP    ODBC Demonstration source file
  138. DEMOODBC.DEF    ODBC Demonstration definitions file
  139. DEMOODBC.EXE    ODBC Demonstration executable file
  140. DEMOODBC.H    ODBC Demonstration header file
  141. DEMOODBC.ICO    ODBC Demonstration icon file
  142. DEMOODBC.RC    ODBC Demonstration resource file
  143. EMP.DBF        EMP table; sample dBASE file
  144. INFORMIX.SQL    script to create/populate EMP table for INFORMIX
  145. INGRES.SQL    script to create/populate EMP table for INGRES
  146. MAKEFILE    MAKE file to be used with CSET++
  147. ORACLE.SQL    script to create/populate EMP table for Oracle
  148. SYBASE.SQL    script to create/populate EMP table for Sybase
  149.  
  150. Setup copies the following files to the \IVODBC\TRANSLAT directory:
  151. MAKEFILE
  152. LIBMAIN.C
  153. QEODBC.H
  154. QETRN.DEF
  155. README.TRN
  156. TRANSLAT.C
  157.  
  158. Setup copies the following files to your installation directory 
  159. (by default, the OS2\DLL directory):
  160. COREO32.DLL    Oracle 7 client file
  161. LITB32.DLL    Oracle 6 client file
  162. ODBC.DLL    Driver Manager
  163. ODBCADM.EXE    ODBC Administrator
  164. ODBCINST.DLL    ODBC Installer
  165. ODBCINST.HLP
  166. ORA6O32.DLL    Oracle 6 client file
  167. ORA7O32.DLL    Oracle 7 client file
  168. OSNT32.DLL    Oracle 6 client file
  169. IOM.DLL        "C" runtime DLL
  170. IPPOM30.DLL    "C" runtime DLL
  171. IVBAS08.DLL
  172. IVDBF08.DLL    dBASE driver
  173. IVDBF08.HLP
  174. IVDB208.DLL    DB2/2 driver
  175. IVDB208.HLP
  176. IVDRV08.INF    Drivers Reference online Help
  177. IVGUP08.DLL    Gupta SQLBase driver
  178. IVGUP08.HLP
  179. IVINF508.DLL    INFORMIX 5 driver
  180. IVINF508.HLP
  181. IVINFO.EXE
  182. IVING408.DLL    INGRES 6.4/04 driver
  183. IVING408.HLP
  184. IVODBC.LIC    License file
  185. IVMDI08.DLL    MicroDecisionware driver
  186. IVMDI08.HLP
  187. IVOR708.DLL    Oracle 7 driver
  188. IVOR708.HLP
  189. IVORA08.DLL    Oracle 6 driver
  190. IVORA08.HLP
  191. IVSS08.DLL    SQL Server driver
  192. IVSS08.HLP
  193. IVSYB08.DLL    Sybase System 10 driver
  194. IVSYB08.HLP
  195. IVTRN08.DLL    INTERSOLV translation DLL
  196. IVTXT08.DLL    Text driver
  197. IVTXT08.HLP
  198. IVUTL08.DLL
  199. QECSV1.BND    Bind files for DB2/2 databases
  200. QERRV1.BND
  201. QEURV1.BND
  202. QECSWHV1.BND
  203. QERRWHV1.BND
  204. QEURWHV1.BND
  205.  
  206.  
  207.     For MicroDecisionware Driver Users
  208.  
  209. The DataDirect ODBC Drivers Reference omits the MDI Driver system
  210. requirements. To use the MDI driver, you must have the appropriate Sybase 
  211. SQL Server DB-Library and Net-Library installed to gain access to MDI DB2 
  212. databases. Your database must support catalog stored procedures. 
  213. For OS/2, you must have Net-Library version 2.0 (32-bit) or higher, 
  214. which is required to set up your network environment. Contact a 
  215. Sybase SQL Server vendor for more information on Net-Library. 
  216.  
  217. Also, you must have DB-Library version 4.6 (32-bit) or higher, 
  218. available from Sybase. All DLLs from Net-Library and DB-Library 
  219. must be in directories listed in the LIBPATH environment variable 
  220. in your CONFIG.SYS file. 
  221.  
  222.  
  223.     For SQL Server Driver Users
  224.  
  225. The SQL Server driver no longer uses the Sybase SQL Server 4.6x client 
  226. pieces. You'll need the Sybase System 10.2 (or higher) client pieces. Contact 
  227. Sybase to obtain them.
  228.  
  229. The DataDirect ODBC Drivers Reference gives incorrect system requirements. 
  230. The current system requirements are as follows:
  231. To gain access to Microsoft SQL Server or Sybase SQL Server databases, 
  232. you must install the Sybase Open Client-Library and the appropriate Sybase
  233. Net-Library.
  234.  
  235. SYBPING is a tool that is provided to test connectivity from your client
  236. workstation to the database server (servers that are added through SQLEdit). 
  237. Use this tool to test your connection. 
  238.  
  239. SQLEdit is a tool that allows you to define servers and adds them to 
  240. SQL.INI.
  241.  
  242. Set the environment variable SYBASE to the directory where you installed 
  243. the System 10 client. For example, SET SYBASE=C:\SQL10. You set this 
  244. environment variable in the config.sys file. 
  245.  
  246. The DataDirect ODBC Drivers Reference incorrectly states that the 
  247. SQL Server driver supports only isolation level 1. The SQL Server driver
  248. actually supports isolation levels 1 (read committed) and 3 (serializable).
  249.  
  250.  
  251.     Setting the Driver Manager Trace
  252.  
  253. You can set the Driver Manager trace on or off by clicking the 
  254. "Options" button in the Data Sources dialog box of the ODBC 
  255. Administrator.  For more information, please check your ODBC 2.0 
  256. Programmer's Reference and SDK Guide.
  257.  
  258.  
  259.     Using the ODBC Demonstration Application
  260.  
  261. To run the demo after installing the drivers, click the ODBC Demo icon 
  262. in the INTERSOLV DataDirect folder. In the menu bar of the ODBC Demo 
  263. window, click Select. From this window, you can either display the ODBC 
  264. demo code, or execute the demo code. 
  265.  
  266. When you click Execute Demo, a dialog box displays the data sources 
  267. defined in ODBC.INI. If dBaseFile is available, select it and click OK. 
  268. You'll see data from EMP.DBF. 
  269.  
  270. To execute the ODBC Demo using aother driver, first make sure you have 
  271. an EMP table in the database you want to access. To create an EMP table,
  272. use one of the .SQL files in the demo directory. These .SQL scripts 
  273. files let you create and populate an EMP table.  To run the demo 
  274. program, the table must be called EMP and be structured as shown in the 
  275. .SQL files.  
  276.  
  277.  
  278.     OS/2 Multithread Applications
  279.  
  280. Some database drivers do not allow multiple threads in an OS/2 
  281. application to access the database concurrently, others have 
  282. restrictions on how it must be handled.  The table below lists
  283. the drivers and their multithread application considerations.
  284.  
  285. IVDBF08.DLL  (dBASE driver)
  286. IVTXT08.DLL  (Text driver)
  287. These drivers fully support multithreaded access.
  288.  
  289. IVDB208.DLL  (DB2/2 driver)
  290. This driver allows multithreaded access if used with a version of 
  291. DB2/2 that allows such access.
  292.  
  293. IVMDI08.DLL (MicroDecisionware driver)
  294. IVORA08.DLL (Oracle 6 driver)
  295. IVOR708.DLL (Oracle 7 driver)
  296. IVSS08.DLL (SQL Server driver)
  297. IVSYB08.DLL  (Sybase System 10 driver) 
  298. These drivers allow multithread access provided each thread calls 
  299. SQLConnect to obtain its own handle to the database.
  300.  
  301. IVINF508.DLL (INFORMIX 5 driver)       
  302. IVING408.DLL (INGRES 6.4/04 driver)    
  303. IVGUP08.DLL  (Gupta SQLBase driver)   
  304. These drivers do not allow concurrent access by multiple threads. 
  305. Applications must guarantee that only one thread access the database 
  306. at all times.
  307.  
  308.  
  309.     OS/2 Warp Considerations
  310.  
  311. OS/2 Warp users need a patch from IBM to fix a problem that may 
  312. occur when using any database driver (DataDirect ODBC drivers or 
  313. others). To get the patch, call IBM OS/2 Technical Support at 
  314. (800) 992-4777 and ask for the fix for APAR #PJ18056. 
  315. Without this fix, you may see the error message "Not able to load the 
  316. specified driver." You must exit your application and restart it 
  317. immediately. Failure to restart your application may result in a Trap E 
  318. error, during which the operating system halts with a possible loss of 
  319. data.    
  320.  
  321.  
  322.        Notes and Known Problems
  323.  
  324. The following are known problems with all of the drivers in this 
  325. release of the DataDirect ODBC Pack for OS/2.  
  326.  
  327. Note:  Some error messages returned by SQLError may be different than the 
  328. error messages you get from other driver managers.  For example, you may 
  329. get a function sequence error when an invalid cursor state error occurs.
  330.  
  331. Restriction:  IBM has fixed the following restriction. Contact OS/2
  332. Technical Support at (800) 992-4777 and ask for the fix for APAR# PJ18060.
  333.  
  334. If an INI file is opened and closed on Warp (OS/2 3.X) using 
  335. the PrfOpenProfile and PrfCloseProfile functions, the PrfOpenProfile call 
  336. fails after approximatley 12972 times. This problem affects the Text and 
  337. dBASE drivers and could possibly impact other drivers. 
  338. For example, if the following calls are made in a loop on the Text driver, 
  339. the driver is found to fail after 4320 loops. 
  340.  
  341.      SQLAllocEnv
  342.      SQLAllocConnect
  343.      SQLConnect
  344.      SQLAllocStmt
  345.      SQLExecDirect
  346.      SQLFreeStmt
  347.      SQLDisconnect
  348.      SQLFreeConnect
  349.      SQLFreeEnv
  350.  
  351.  
  352.  
  353.     Compiler Issues
  354.  
  355. The IBM VISUALAGE compiler, version 2.0 for OS2, was used to 
  356. generate this release of ODBC.
  357.  
  358. The _System calling convention is used for the API. 
  359.  
  360.  
  361.     Contacting INTERSOLV Answerline for Technical Support
  362.  
  363. Before calling INTERSOLV Answerline, please collect basic information
  364. about your system to help us understand the environment in which you
  365. are working and the exact steps to reproduce the problem.
  366.  
  367. The Answerline number to call is 800-443-1601. Or, you can FAX the 
  368. information you have collected about your problem to 919-461-4527.
  369.  
  370.  
  371. End of READ.ME