home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 5 / 05.iso / a / a084 / 2.ddi / CKREADME.TXT next >
Encoding:
Text File  |  1993-05-25  |  10.2 KB  |  274 lines
  1.                      CKREADME.TXT
  2. **********************************************************
  3.                    Release Notes for
  4.         Microsoft(R) FoxPro(R) Connectivity Kit
  5.  
  6.    Microsoft(R) FoxPro(R) for MS-DOS(R) Version 2.5
  7.    Microsoft(R) FoxPro(R) for Windows(TM) Version 2.5
  8.  
  9.  
  10.    (C)1993 Microsoft Corporation. All Rights Reserved.
  11.  
  12. **********************************************************
  13. ========
  14. CONTENTS
  15. ========
  16.  
  17. Part   Description
  18. ----   -----------
  19.  
  20. 1      Tips and Tricks
  21. 2      Changes to Documentation Since Printing
  22. 3      Answers to Commonly Asked Questions
  23.  
  24. ----------------------------------------------------------
  25.  
  26. ================================
  27. Part 1:  Tips and Tricks
  28. ================================
  29.  
  30. *FoxPro for Windows to ORACLE(R) Connectivity*
  31.  
  32. While the Connectivity Kit includes the ORACLE ODBC driver, 
  33. FoxPro for Windows to ORACLE Connectivity requires the file
  34. SQL*NET.DLL, which is available from ORACLE only.  
  35. Contact your ORACLE representative.
  36.  
  37. If you're using ORACLE, make sure you read the ORACLE.TXT 
  38. file on the ODBC disk.  This file contains information you
  39. need to make a connection to ORACLE.
  40. ----------------------------------------------------------
  41.  
  42. *SQL Server to FoxPro for MS-DOS Field Size Limit*
  43.  
  44. The maximum length of each data field imported from SQL 
  45. Server to a FoxPro for MS-DOS cursor or table is 65530 
  46. bytes.  If your available memory is less than this value, 
  47. or if you are importing data that is longer than 65530 
  48. bytes, you must limit the size of the data exported by 
  49. SQL Server to fit into your available memory. 
  50.  
  51. You can reduce the length of the data exported from SQL 
  52. Server by using the Transact-SQL command "SET TEXTSIZE n", 
  53. where n is equal to the desired textsize in bytes.  For
  54. example, to limit the length of data to 20K, you would
  55. use the command "SET TEXTSIZE 20480".  For an explanation
  56. of the SET TEXTSIZE command, refer to your SQL Server 
  57. documentation.
  58.  
  59. If the data in an exported field exceeds the available
  60. memory, DB-Library will terminate the connection.
  61.  
  62. This limit does not apply to FoxPro for Windows.  If you 
  63. want to import a text or binary field that exceeds 65530
  64. bytes, you can import the data into FoxPro for Windows and
  65. then use the data in FoxPro for MS-DOS.
  66. ----------------------------------------------------------
  67.  
  68. *Temporary File Space Requirements*
  69.  
  70. Keep in mind that when you import data into a FoxPro 
  71. cursor or table, your system must have enough temporary 
  72. file space to allow FoxPro to build the cursor or table.  
  73. ----------------------------------------------------------
  74.  
  75. *Viewing System Warning Messages*
  76.  
  77. Set the DBSetOpt( ) DispError option to "ON" if you want 
  78. to be able to view system warning messages.  System 
  79. warning messages are displayed by FPSQL to notify you of 
  80. conditions or problems encountered in processing a request.
  81.  
  82. For more information about specific messages, refer to 
  83. "*Addition to the Appendix: System Warning Messages*" in
  84. Part 2, "Changes to Documentation Since Printing."
  85. ----------------------------------------------------------
  86.  
  87. *Other Error Messages*
  88.  
  89. In addition to Connectivity Kit errors, FPSQL also displays
  90. error messages sent by ODBC, DB-Library and SQL Server.  
  91. For information about ODBC error messages, refer to the 
  92. ODBC Software Developer's Kit documentation and to the 
  93. driver and data source documentation for the data 
  94. source currently in use.  For a list of DB-Library error 
  95. messages, refer to the Microsoft SQL Server Programmer's 
  96. Reference for C in the Microsoft SQL Server Programmer's 
  97. Toolkit.  
  98.  
  99. You'll find an explanation of the more common SQL Server
  100. errors in the Microsoft SQL Server Troubleshooting Guide.
  101. If you don't find information about a specific SQL Server
  102. error message in the Troubleshooting Guide, please contact
  103. your SQL Server system administrator or your SQL Server 
  104. primary support provider.
  105. ----------------------------------------------------------
  106.  
  107. *Using SQL Server Triggers to Return Error Messages*
  108.  
  109. If you're relying on SQL Server triggers to return error
  110. messages, be sure you include the Transact-SQL "RAISERROR"
  111. command in your trigger.  FPSQL then recognizes the error
  112. and returns the information.  For more  information about 
  113. the "RAISERROR" command, refer to the Microsoft SQL Server
  114. Language Reference.
  115. ----------------------------------------------------------
  116.  
  117. ================================================
  118. Part 2:  Changes to Documentation Since Printing
  119. ================================================
  120.  
  121. *Appendix, page 68, Connectivity Kit Errors by Number*
  122.  
  123. Delete error numbers 17 "Failed to set connection timeout"
  124. and 18 "Failed to set general timeout".  These situations 
  125. now produce system warning messages.  
  126.  
  127. Add error number 36 "Cannot set transaction option while in
  128. a transaction" (MS-DOS only).
  129.  
  130. *Appendix, page 69, Connectivity Kit Errors Alphabetically*
  131.  
  132. Add:  Cannot set transaction option while in a transaction" 
  133. (36) (MS-DOS only).
  134.   If you are in manual transaction mode and have made the
  135.   first call to DBExec( ), you are in an active 
  136.   transaction.  In this case, you must explicity end the
  137.   transaction by calling DBTransact( ) with a Commit or 
  138.   Rollback statement before you can either call 
  139.   DBSetOpt( ) to change the transaction mode or call 
  140.   DBDisconnect( ).
  141.  
  142.  
  143. Change to error number 33 "Cannot disconnect while in a
  144. transaction" (MS-DOS only).
  145.   
  146. In manual mode, you can end a current transaction only by
  147. calling DBTransact( ), not by changing the transaction mode
  148. with DBSetOpt( ).  The new description for FPSQL error 33
  149. should read:
  150.  
  151.   Before you can call DBDisconnect( ), you need to end the
  152.   current transaction by calling DBTransact( ).
  153.  
  154.  
  155. *Addition to the Appendix: System Warning Messages*
  156.     
  157. FPSQL provides system warning messages which notify you of
  158. conditions or problems encountered during processing.  In 
  159. contrast to error messages, which indicate fatal problems 
  160. that interrupt processing, system warning messages indicate
  161. conditions or problems that are not serious enough to 
  162. interrupt processing.  The following system warning 
  163. messages have been added to the Connectivity Kit:
  164.  
  165. Msg   System Warning Message              Platform
  166. No.
  167. ----  ----------------------------------  ----------------
  168. 1     Failed to set connection timeout    (MS-DOS/Windows)
  169. 2     Failed to set general timeout       (MS-DOS/Windows)
  170. 3     Data precision lost in conversion   (MS-DOS/Windows)
  171. 4     Failed to convert memo field        (MS-DOS/Windows)
  172. 5     Failed to clear connection          (MS-DOS/Windows)  
  173.  
  174. 6     Failed to set transaction mode      (Windows only)
  175. 7     Failed to set connection in
  176.       asynchronous mode                   (Windows only)
  177.  
  178. 10    Failed to set DB-LIB text limit     (MS-DOS only)
  179. 11    Failed to set in use the specified
  180.       database                            (MS-DOS only)
  181.  
  182. *Connectivity Kit System Warning Messages Alphabetically*
  183.  
  184. Data precision lost in conversion (3)    
  185.   Shows any data conversion error from whatever datasource
  186.   type to FoxPro.  This message is displayed once at the 
  187.   end of the result set conversion for one or multiple 
  188.   problems encountered during the conversion process.
  189.  
  190. Failed to clear connection (5)
  191.   FPSQL was unable to clear the connection.  The error 
  192.   could indicate corruption of FPSQL memory space or a 
  193.   problem either in the connection channel or on the 
  194.   data source. 
  195.   
  196. Failed to convert memo field (4)             
  197.   Indicates any error while converting data to FoxPro
  198.   memo fields (not enough memory, temporary file error, 
  199.   etc.)  This message is displayed once at the end of the
  200.   result set conversion for one or multiple problems 
  201.   encountered during the conversion process.
  202.  
  203. Failed to set connection in asynchronous mode (7)
  204.   Windows only.  Indicates an error in the ODBC call for
  205.   the current data source.
  206.  
  207. Failed to set connection timeout (1)
  208.   FPSQL was unable to set the specified connection timeout 
  209.   for an attempted connection to a data source.  The 
  210.   connection attempt will timeout according to the data
  211.   source default connection timeout.        
  212.  
  213. Failed to set DB-LIB text limit (10)
  214.   MS-DOS only.  Shows an error in setting the maximum 
  215.   DB-Library text size to 65530 bytes. 
  216.  
  217. Failed to set general timeout (2)             
  218.   FPSQL was unable to set the specified general timeout 
  219.   for a connection to a data source.  The connection
  220.   will use the data source default general timeout. 
  221.  
  222. Failed to set in use the specified database (11)
  223.   MS-DOS only.  Indicates an error when trying to set in
  224.   use the database specified as the fourth parameter in
  225.   DBConnect().
  226.  
  227. Failed to set transaction mode (6)
  228.   Windows only.  Indicates an error in the ODBC call for
  229.   the current data source.
  230. ----------------------------------------------------------
  231.  
  232. ============================================
  233. Part 3:  Answers to Commonly Asked Questions
  234. ============================================
  235.  
  236. *License Agreement*
  237.  
  238. Question 1
  239.  
  240. Our organization includes several FoxPro developers.
  241. Does each developer need an individual copy of the
  242. Connectivity Kit?
  243.  
  244. Answer 1
  245.  
  246. Your organization must own one licensed copy of the
  247. Connectivity Kit per developer, for each developer
  248. creating applications that use the Connectivity Kit. If 
  249. five developers in your organization create applications
  250. using one or both of the Connectivity Kit libraries 
  251. (FPSQL.PLB and/or FPSQL.FLL), you must own five licensed 
  252. copies of the Connectivity Kit.
  253. ----------------------------------------------------------
  254.  
  255. Question 2
  256.  
  257. I own licensed copies of both the FoxPro Distribution Kit
  258. and the FoxPro Connectivity Kit. May I distribute the 
  259. FPSQL libraries with applications I develop using the 
  260. Distribution Kit?
  261.  
  262. Answer 2
  263.  
  264. Yes. As a licensed user of both the FoxPro Distribution 
  265. Kit and the Connectivity Kit, you are free to distribute 
  266. the FPSQL.PLB and/or FPSQL.FLL library file(s) with your
  267. distributed application(s).
  268. ----------------------------------------------------------
  269.  
  270.                     *******************
  271.                     END OF CKREADME.TXT
  272.                     *******************
  273.  
  274.