-----------------------------------------------------------

Release Notes
Microsoft® Visual FoxPro(R) ODBC Driver Version 6.0
-----------------------------------------------------------
(c) 1998 Microsoft Corporation

Welcome to the release of the Visual FoxPro ODBC Driver!

Please read this important information.
------------------------
How to Use This Document
------------------------
To view the ReadMe file in Microsoft Windows(R) Notepad, maximize the Notepad wi
ndow and click Word Wrap on the Edit menu. To print the ReadMe file, open it in
Notepad or another word processor and then use the Print command on the File men
u.
--------
CONTENTS
--------
1. Installation Notes
1.1 System Requirements
1.2 What's New in This Release
1.3 Installing the Driver
1.4 Adding a Data Source
1.5 Help Files
1.6 Naming Conventions
2. Supported Areas
2.1 Language Support
2.2 ODBC 2.5 Compliance
2.3 Referential Integrity
2.4 Thread Support
2.5 dBase® Support
2.6 International Support
3. Unsupported Areas
4. Known Issues
5. Troubleshooting
6. Books

======================
1. Installation Notes
======================
1.1 System Requirements
========================
To install the Microsoft Visual FoxPro ODBC driver, you need:
* Microsoft Windows NT(R) 3.51 (or later; Service Pack 5, recommended)
or Microsoft Windows 95 (or later).
* 2 MB disk space.
Important: Visual FoxPro ODBC Driver 1.0 is a 32-bit driver only. Microsoft Win
dows 3.1 and Microsoft Windows for Workgroups platforms are not supported.

1.2 What's New in This Release

===============================
* Query performance is 20% faster.
* VFPODBC.DLL is smaller (from 1.20 MB to ~835 KB).
* The SET commands (see Help file for a list of supported SET commands) are now
supported.
* VERSION( ) is supported through stored procedures.
* Local views are read-only.
* If you insert or update a table with a logical field (a column with a SQL_BIT
data type), you can now use 1 (true) and 0 (false) to store a value in a field.
When comparing values or in an expression, you must use .T. (true) and .F. (fals
e).
* The 16-bit version of Microsoft Query (version 1.0) now works with the Visual
FoxPro ODBC Driver.
* SQLGetInfo and SQL_FILE_USAGE now return SQL_FILE_QUALIFIER both for database
and free table data sources.

1.3 Installing the Driver

==========================
To install the Visual FoxPro ODBC Driver, run SETUP.EXE.
Note: The Visual FoxPro ODBC Driver installation updates the ODBC components to
ODBC 2.5 compliance if necessary. See the README25.TXT file in your Windows sys
tem directory for additional information on enhancements or features of the ODBC
2.5 components.

1.4 Adding a Data Source

=========================
After installing, define a data source:
1. In Control Panel, double-click the 32-bit ODBC icon.
2. Click Add.
3. Select Microsoft Visual FoxPro Driver.
4. In the ODBC Visual FoxPro Setup dialog box, enter a data source name.
5. Select either Visual FoxPro database (.DBC) or Free Table directory.
6. Enter the name of the database or the path to the free table, or click Browse
.
7. Click OK and then click Close.

1.5 Help Files

===============
The Visual FoxPro ODBC driver comes with two help files, located in the SYSTEM d
irectory on Windows 95 or the SYSTEM32 directory on Windows NT:
* ODBCINST.HLP -- General ODBC information, which contains information on:
* The ODBC driver dialog box
* The options that can be set in the drivers dialog box in the Control Pane
l
* DRVVFP.HLP Visual FoxPro ODBC Driver Help file, which provides information on:
* Installing and Configuring
* Using the Visual FoxPro Driver
* Technical Reference
 * ODBC API
* Visual FoxPro Language Reference
* Error Messages

1.6 Naming Conventions

=======================
The Visual FoxPro ODBC Driver names columns based on expressions. For example, i
f you execute the following statement:
SELECT MIN (customer_id) FROM customers
the Visual FoxPro ODBC Driver returns min_customerid as the name of the column i
n the result set.
If you would like to control the resulting field name, use the AS clause, as in
this example:
SELECT MIN(customer_id) AS minimum_custid FROM customers

===================
2. Supported Areas
===================
The following section describes areas of particular support by the Visual FoxPro
ODBC driver.

2.1 Language Support

=====================
Supported versions of FoxBase+ and FoxPro Tables
The Visual FoxPro ODBC Driver gives you access to Microsoft(r) FoxBase+(r), FoxP
ro 1.x, FoxPro 2.x and Visual FoxPro tables. Also, the Visual FoxPro ODBC Driver
allows you to access tables that are in a Visual FoxPro database container (.DB
C file).
Note: The Visual FoxPro ODBC Driver allows transactions only on tables within a
Visual FoxPro database (.DBC file), not free tables.

2.2 ODBC 2.5 Compliance

========================
The Visual FoxPro ODBC driver is ODBC Level 1 API compliant and also implements
several Level 2 APIs. All supported APIs have been implemented at this time. Ple
ase report any problems you find regarding the APIs. The Help file, DRVVFP.HLP,
documents supported functions and acceptable input parameters. In addition, Visu
al FoxPro SQL extends the SQL functionality available through the driver. See th
e Visual FoxPro Language Reference for the extended grammar.

2.3 Referential Integrity Support

==================================
The Visual FoxPro ODBC driver supports Visual FoxPro rules, triggers, and defaul
t values, provided they contain functions that are supported by the driver. See
the Help file, DRVVFP.HLP, for details on which Visual FoxPro language elements
are supported.

2.4 Thread Support

===================
The driver is thread-safe. The Visual FoxPro ODBC driver can process queries in
the background. For more information, see the "ODBC Visual FoxPro Setup Dialog B
ox" Help topic.
Remote Views and Parameterized Views
Anytime SQLTables is called, remote and parameterized views are excluded from th
e list. Local views based on parameterized views are not excluded but will gener
ate errors if you use them. If you call SQLTables with a unique table name, howe
ver, you will find views (if they are present) so that you can check for name co
nflicts.

2.5 dBase® Support

===================
Supported Versions of dBASE IV Tables
The Visual FoxPro ODBC Driver gives you access to dBASE 4 and earlier tables.
The dBASE files are supported in the following manner:
* dBASE v2.x and 3.x: The files are read without conversion.
* dBASE v4.x and 5.x: If the files do not have memo fields and the table has few
er than 255 columns, the files are read.
Caution: If a dBASE v4.x or 5.x file has associated index files (.MDX, .NDX), t
he Visual FoxPro ODBC Driver will not update the file properly and the indexes w
ill be corrupted. These files should be accessed read-only.
* dBASE v4.x and 5.x tables with memo fields: These files require conversion in
the full Visual FoxPro for Windows product before using them with the Visual Fox
Pro ODBC Driver. The driver will not read or convert files.

2.6 International Support

==========================
* The driver is DBCS-enabled.
* You can now set the collating sequence for index ordering. The list of support
ed collating sequences can be found in the description of SET COLLATE in the Vis
ual FoxPro Language Reference Help topic.
The default collating sequence is "MACHINE". The collating sequence can be chang
ed by executing either a SET COLLATE TO Language with the ODBC C API SQLExecDire
ct, by calling SQLPrepare and SQLExec (see the Microsoft ODBC 2.0 Programmer's R
eference and SDK Guide, pp. 42-44), or by selecting a different collating sequen
ce from the driver options in the Data Source Setup dialog.
Note: The FOXPRO.INT file is installed in the system directory. If it is remove
d, the collating sequences on Eastern European code page machines will not work.

====================
3. Unsupported Areas
====================
* Refresh is not supported in rules and triggers.
* The Help file describes the supported commands and functions and lists the uns
upported commands and functions. Any command or function not listed in the Help
file is not supported.
* Parameterized views work in a trigger only if the parameter has been assigned
a value before the view is opened. Interactive input of a parameter value is not
allowed in ODBC.
* Remote views to other ODBC data sources are not supported by the Visual FoxPro
ODBC driver; however, local views (non-parameterized) are fully supported.
================
4. Known Issues
================
* If you insert, delete, or update a Visual FoxPro table via the Visual FoxPro O
DBC Driver, you might get a "Trigger Failed" message. Check for unsupported comm
ands in the trigger.
* INDEX ON is not supported in this release.
* If a table is opened exclusively and the same table is accessed by another use
r with SET EXCLUSIVE OFF, the error "Option Value Changed" is returned by Visual
FoxPro ODBC Driver instead of "File is in use by another."
* MSQuery returns a "Cannot Open File" error when creating a table with a field
name that starts with a number. For example, the field name "1995 Sales" is not
allowed. Visual FoxPro does not allow the creation of field names that begin wit
h a number, but MSQuery does.

===================
5. Troubleshooting
===================
If you have trouble installing the driver, try the following and then try to rei
nstall again:
1. Clean-boot the machine. For example, under Windows 95, start in Safe Mode.
2. Close all other applications, including virus software, third-party shells, o
r toolbars such as Microsoft Office Manager.
3. If the computer has video or system ROM shadowing, disable these options befo
re reinstalling.
4. Check that the .EXE file is not corrupted.
If you are still having problems:
* Make sure that you are running on a clean configuration when testing issues.
* Use the Microsoft ODBC Data Source Administrator control panel Tracing tab to
help determine the cause of problems.
* Check to see if the latest build of the driver is installed. To view the versi
on:
1. In the ODBC Data Source Administrator Control Panel, double-click the 32bit O
DBC icon.
2. Click the ODBC Drivers tab.
* You can generate an ODBC Trace Log by using the ODBC Data Source Administrator
Control Panel:
1. In the Control Panel, double-click the 32bit ODBC icon.
2. Select the Tracing tab.
3. Specify a When to trace option.
4. Specify a log file name.
5. Click Start Tracing Now.
Now, when you execute your code, all the C ODBC API calls, their input parameter
s, and their output are written to the log file. The ODBC log file is ASCII text
that you can view in any standard ASCII text editor such as Microsoft Word, Not
epad, or WordPad. Occasionally, it might be necessary to include the trace log i
n a bug report. Since the ODBC trace log can be lengthy, copy only the last 4 or
5 function calls and paste them into a separate document before sending the bug
report.
==========
6. Books
==========
Microsoft ODBC 2.0 Programmer's Reference and SDK Guide (ISBN#: 1-55615-658-8 fr
om Microsoft Press(R)) provides basic reference information.
Inside ODBC (ISBN#: 1-55615-815-7 from Microsoft Press) provides a good backgrou
nd on the development of the ODBC specifications and a CD with ODBC code example
s.
Database Developer's Guide with Visual C++ (ISBN#: 0-672-30613-1 from Sams Publi
shing) has several good C++ examples that use the ODBC API.
==========================