home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 5 / 05.iso / a / a083 / 4.img / CKREADME.TXT next >
Encoding:
Text File  |  1994-03-10  |  13.8 KB  |  379 lines
  1.                      CKREADME.TXT
  2. **********************************************************
  3.  Microsoft(R) FoxPro(R) Version 2.6 Professional Edition
  4.  
  5.      Connectivity Kit for Windows(TM) and MS-DOS(R)
  6.  
  7.    (C)1994 Microsoft Corporation. All Rights Reserved.
  8. **********************************************************
  9.  
  10. =========
  11. CONTENTS
  12. =========
  13.  
  14. Part   Description
  15. ----   -----------
  16.  1     Installation
  17.  2     Tips and Tricks
  18.  3     Changes to Connectivity Kit User's Guide Since Printing
  19.  4     Answers to Commonly Asked Questions
  20. ----------------------------------------------------------
  21.  
  22. =====================
  23. Part 1: Installation
  24. =====================
  25.  
  26. Installing the Professional Edition of FoxPro 2.6
  27. -------------------------------------------------
  28. The Professional Edition of FoxPro 2.6 includes the
  29. following kits:
  30.  
  31. Distribution Kit
  32. Connectivity Kit
  33. Library Construction Kit
  34. WorkGroup Extensions (FoxPro for Windows only) 
  35.  
  36. To install the Professional Edition of FoxPro, first install
  37. the main FoxPro product, then follow the installation 
  38. instructions included with each individual kit.  The order 
  39. in which the kits are installed does not matter.
  40. ----------------------------------------------------------
  41.  
  42. Installing the Client-Server Wizard
  43. -----------------------------------
  44. To install the Client-Server Wizard, follow these steps:
  45.  
  46. 1. Replace the following files, located in the subdirectory 
  47.    WIZARDS, with the versions shipped with the Professional
  48.    Edition.  
  49.  
  50.    WIZARD.APP
  51.    WZ_BQUER.APP
  52.  
  53. 2. Delete the following files, located in the subdirectory 
  54.    WIZARDS.
  55.  
  56.    WIZARD.DBF
  57.    WIZARD.FPT
  58.  
  59.    The first time you run the Client-Server Wizard these
  60.    files are re-created with new default values.
  61.  
  62. To run the Client-Server Wizard you must have ODBC already 
  63. installed. For information on installing ODBC, see the 
  64. Connectivity Kit User's Guide.
  65. ----------------------------------------------------------
  66.  
  67. Installing ODBC from 720KB disks
  68. --------------------------------
  69. If you are installing the Connectivity Kit from 720KB 
  70. floppy disks, the ODBC files are contained on two floppy
  71. disks, and cannot be installed from the disks. To install 
  72. the ODBC files follow these steps:
  73.  
  74. 1. Create a new directory called ODBC on your hard drive.
  75.  
  76. 2. Copy the contents of the two ODBC disks into this 
  77.    directory.
  78.  
  79. 3. Run the install program.
  80. ----------------------------------------------------------
  81.  
  82.  
  83. ========================
  84. Part 2: Tips and Tricks
  85. ========================
  86.  
  87. FoxPro for Windows to ORACLE(R) Connectivity
  88. --------------------------------------------
  89. While the Connectivity Kit includes the ORACLE ODBC driver, 
  90. FoxPro for Windows to ORACLE Connectivity requires some
  91. SQL*NET drivers for Windows, which is available from ORACLE 
  92. only. Contact your ORACLE representative.
  93.  
  94. If you're using ORACLE, make sure you read the ORACLE.TXT 
  95. file on the ODBC disk.  This file contains information you
  96. need to make a connection to ORACLE.
  97. ----------------------------------------------------------
  98.  
  99. SQL Server to FoxPro for MS-DOS Field Size Limit
  100. ------------------------------------------------
  101. The maximum length of each data field imported from SQL 
  102. Server to a FoxPro for MS-DOS cursor or table is 65530 
  103. bytes.  If your available memory is less than this value, 
  104. or if you are importing data that is longer than 65530 
  105. bytes, you must limit the size of the data exported by 
  106. SQL Server to fit into your available memory. 
  107.  
  108. You can reduce the length of the data exported from SQL 
  109. Server by using the Transact-SQL command "SET TEXTSIZE n", 
  110. where n is equal to the desired text size in bytes.  For
  111. example, to limit the length of data to 20K, you would
  112. use the command "SET TEXTSIZE 20480".  For an explanation
  113. of the SET TEXTSIZE command, refer to your SQL Server 
  114. documentation.
  115.  
  116. If the data in an exported field exceeds the available
  117. memory, DB-Library will terminate the connection.
  118.  
  119. This limit does not apply to FoxPro for Windows.  If you 
  120. want to import a text or binary field that exceeds 65530
  121. bytes, you can import the data into FoxPro for Windows and
  122. then use the data in FoxPro for MS-DOS.
  123. ----------------------------------------------------------
  124.  
  125. Temporary File Space Requirements
  126. ---------------------------------
  127. Keep in mind that when you import data into a FoxPro 
  128. cursor or table, your system must have enough temporary 
  129. file space to allow FoxPro to build the cursor or table.  
  130. ----------------------------------------------------------
  131.  
  132. Viewing System Warning Messages
  133. -------------------------------
  134. Set the DBSetOpt( ) DispError option to "ON" if you want 
  135. to be able to view system warning messages.  System 
  136. warning messages are displayed by FPSQL to notify you of 
  137. conditions or problems encountered in processing a request.
  138.  
  139. For more information about specific messages, refer to 
  140. "*Addition to the Appendix: System Warning Messages*" in
  141. Part 2, "Changes to Connectivity Kit User's Guide Since 
  142. Printing."
  143. ----------------------------------------------------------
  144.  
  145. Other Error Messages
  146. --------------------
  147. In addition to Connectivity Kit errors, FPSQL also displays
  148. error messages sent by ODBC, DB-Library and SQL Server.  
  149. For information about ODBC error messages, refer to the 
  150. ODBC Software Developer's Kit documentation and to the 
  151. driver and data source documentation for the data 
  152. source currently in use.  For a list of DB-Library error 
  153. messages, refer to the Microsoft SQL Server Programmer's 
  154. Reference for C in the Microsoft SQL Server Programmer's 
  155. Toolkit.  
  156.  
  157. You'll find an explanation of the more common SQL Server
  158. errors in the Microsoft SQL Server Troubleshooting Guide.
  159. If you don't find information about a specific SQL Server
  160. error message in the Troubleshooting Guide, please contact
  161. your SQL Server system administrator or your SQL Server 
  162. primary support provider.
  163. ----------------------------------------------------------
  164.  
  165. Using SQL Server Triggers to Return Error Messages
  166. --------------------------------------------------
  167. If you're relying on SQL Server triggers to return error
  168. messages, be sure you include the Transact-SQL "RAISERROR"
  169. command in your trigger.  FPSQL then recognizes the error
  170. and returns the information.  For more  information about 
  171. the "RAISERROR" command, refer to the Microsoft SQL Server
  172. Language Reference.
  173. ----------------------------------------------------------
  174.  
  175.  
  176. =================================================
  177. Part 3: Changes to Connectivity Kit User's Guide 
  178.         Since Printing
  179. =================================================
  180. The Connectivity Kit now includes support for the following
  181. features.
  182.  
  183. NULL Support
  184. ------------
  185. You can now define NULL constants for four types of  FoxPro
  186. null values. The default for all cases is a string of empty 
  187. spaces.
  188.  
  189. Name           Size
  190. ----           ----
  191. CharNull        30
  192. IntNull         20
  193. FloatNull       20
  194. DateNull        23
  195.  
  196. The values can be set and returned using the following option 
  197. functions, where <expC> is the name of the Null option.
  198.  
  199. DBSetOpt(<expN>, <expC>[, <exp>])
  200. DBGetOpt(<expN>, <expC>)
  201.  
  202. For more information of these functions see the Connectivity
  203. Kit User's Guide.
  204.  
  205.  
  206. Mulitiple Error Messages
  207. ------------------------
  208. The Connectivity Kit now returns a list of up to five error 
  209. messages per connection. DBError includes a fourth parameter 
  210. that indicates which error message is requested from the 
  211. list of error messages.
  212.  
  213. Syntax: DBError (<expN1> [, @<memvar1> [, @<memvar2>] [,<expN2>]])
  214.  
  215. <expN2> returns a value between 1 and 5 corresponding to the
  216. error message in the error message list.  Invalid values for
  217. <expN2> are defaulted to the nearest valid value. If the
  218. parameter is not specified, the latest error message is
  219. returned.
  220.  
  221. Date Strings
  222. ------------
  223. Date type values imported from a data source are now converted
  224. to character strings in FoxPro.
  225. ----------------------------------------------------------
  226.  
  227.  
  228. The following are corrections to the documentation since printing.
  229.  
  230. Appendix, page 68, Connectivity Kit Errors by Number
  231. ----------------------------------------------------
  232. Delete error numbers 17 "Failed to set connection time-out"
  233. and 18 "Failed to set general time-out".  These situations 
  234. now produce system warning messages.  
  235.  
  236. Add error number 36 "Cannot set transaction option while in
  237. a transaction" (MS-DOS only).
  238.  
  239. Appendix, page 69, Connectivity Kit Errors Alphabetically
  240. ---------------------------------------------------------
  241. Add:  Cannot set transaction option while in a transaction" 
  242. (36) (MS-DOS only).
  243.   If you are in manual transaction mode and have made the
  244.   first call to DBExec( ), you are in an active 
  245.   transaction.  In this case, you must explicitly end the
  246.   transaction by calling DBTransact( ) with a Commit or 
  247.   Rollback statement before you can either call 
  248.   DBSetOpt( ) to change the transaction mode or call 
  249.   DBDisconnect( ).
  250.  
  251. Change to error number 33 "Cannot disconnect while in a
  252. transaction" (MS-DOS only).
  253.   
  254. In manual mode, you can end a current transaction only by
  255. calling DBTransact( ), not by changing the transaction mode
  256. with DBSetOpt( ).  The new description for FPSQL error 33
  257. should read:
  258.  
  259.   Before you can call DBDisconnect( ), you need to end the
  260.   current transaction by calling DBTransact( ).
  261.  
  262. Addition to the Appendix: System Warning Messages
  263. -------------------------------------------------
  264. FPSQL provides system warning messages which notify you of
  265. conditions or problems encountered during processing.  In 
  266. contrast to error messages, which indicate fatal problems 
  267. that interrupt processing, system warning messages indicate
  268. conditions or problems that are not serious enough to 
  269. interrupt processing.  The following system warning 
  270. messages have been added to the Connectivity Kit:
  271.  
  272. Msg   System Warning Message              Platform
  273. No.
  274. ----  ----------------------------------  ----------------
  275. 1     Failed to set connection time-out    (MS-DOS/Windows)
  276. 2     Failed to set general time-out       (MS-DOS/Windows)
  277. 3     Data precision lost in conversion   (MS-DOS/Windows)
  278. 4     Failed to convert memo field        (MS-DOS/Windows)
  279. 5     Failed to clear connection          (MS-DOS/Windows)  
  280.  
  281. 6     Failed to set transaction mode      (Windows only)
  282. 7     Failed to set connection in
  283.       asynchronous mode                   (Windows only)
  284.  
  285. 10    Failed to set DB-LIB text limit     (MS-DOS only)
  286. 11    Failed to set in use the specified
  287.       database                            (MS-DOS only)
  288.  
  289. Connectivity Kit System Warning Messages Alphabetically
  290. -------------------------------------------------------
  291. Data precision lost in conversion (3)    
  292.   Shows any data conversion error from whatever data source
  293.   type to FoxPro.  This message is displayed once at the 
  294.   end of the result set conversion for one or multiple 
  295.   problems encountered during the conversion process.
  296.  
  297. Failed to clear connection (5)
  298.   FPSQL was unable to clear the connection.  The error 
  299.   could indicate corruption of FPSQL memory space or a 
  300.   problem either in the connection channel or on the 
  301.   data source. 
  302.   
  303. Failed to convert memo field (4)             
  304.   Indicates any error while converting data to FoxPro
  305.   memo fields (not enough memory, temporary file error, 
  306.   etc.)  This message is displayed once at the end of the
  307.   result set conversion for one or multiple problems 
  308.   encountered during the conversion process.
  309.  
  310. Failed to set connection in asynchronous mode (7)
  311.   Windows only.  Indicates an error in the ODBC call for
  312.   the current data source.
  313.  
  314. Failed to set connection timeout (1)
  315.   FPSQL was unable to set the specified connection timeout 
  316.   for an attempted connection to a data source.  The 
  317.   connection attempt will timeout according to the data
  318.   source default connection timeout.        
  319.  
  320. Failed to set DB-LIB text limit (10)
  321.   MS-DOS only.  Shows an error in setting the maximum 
  322.   DB-Library text size to 65530 bytes. 
  323.  
  324. Failed to set general timeout (2)             
  325.   FPSQL was unable to set the specified general timeout 
  326.   for a connection to a data source.  The connection
  327.   will use the data source default general timeout. 
  328.  
  329. Failed to set in use the specified database (11)
  330.   MS-DOS only.  Indicates an error when trying to set in
  331.   use the database specified as the fourth parameter in
  332.   DBConnect().
  333.  
  334. Failed to set transaction mode (6)
  335.   Windows only.  Indicates an error in the ODBC call for
  336.   the current data source.
  337. ----------------------------------------------------------
  338.  
  339.  
  340. ============================================
  341. Part 4: Answers to Commonly Asked Questions
  342. ============================================
  343.  
  344. Question 1
  345.  
  346. Our organization includes several FoxPro developers.
  347. Does each developer need an individual copy of the
  348. Connectivity Kit?
  349.  
  350. Answer 1
  351.  
  352. Your organization must own one licensed copy of the
  353. Connectivity Kit per developer, for each developer
  354. creating applications that use the Connectivity Kit. If 
  355. five developers in your organization create applications
  356. using one or both of the Connectivity Kit libraries 
  357. (FPSQL.PLB and/or FPSQL.FLL), you must own five licensed 
  358. copies of the Connectivity Kit.
  359. ----------------------------------------------------------
  360.  
  361. Question 2
  362.  
  363. I own licensed copies of both the FoxPro Distribution Kit
  364. and the FoxPro Connectivity Kit. May I distribute the 
  365. FPSQL libraries with applications I develop using the 
  366. Distribution Kit?
  367.  
  368. Answer 2
  369.  
  370. Yes. As a licensed user of both the FoxPro Distribution 
  371. Kit and the Connectivity Kit, you are free to distribute 
  372. the FPSQL.PLB and/or FPSQL.FLL library file(s) with your
  373. distributed application(s).
  374. ----------------------------------------------------------
  375.  
  376.                     ===================
  377.                     END OF CKREADME.TXT
  378.                     ===================
  379.