Microsoft Windows 98 Second Edition Vfpodbc.txt FileID: Q234903
|
This article contains a copy of the information in the Microsoft Windows 98 Second Edition Vfpodbc.txt file.
-----------------------------------------------------------
Microsoft(r) Visual FoxPro(tm) ODBC Driver Version 6.0a
-----------------------------------------------------------
(c) Copyright Microsoft Corporation, 1998
Release Notes
September 19, 1998
Welcome to this release of the Microsoft(r) Visual FoxPro(tm) ODBC Driver!
Please read this important information.
System Requirements
------------------------
How to Use This Document
------------------------
To view the ReadMe file in Windows Notepad, maximize the Notepad window,
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 menu.
--------
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 3.5 Compliance
2.3 Referential Integrity
2.4 Thread Support
2.5 dBase(r) Support
2.6 International Support
3. UnSupported Areas
4. Known Issues
5. Troubleshooting
6. Books
1.1 System Requirements
========================
To install the Visual FoxPro ODBC Driver, you need:
* Windows NT 4 (or later. Service Pack 5, recommended),
Windows 95, or Windows 98 (or later).
* 2 megabytes disk space.
Important: Visual FoxPro ODBC Driver is a 32-bit driver only. Windows 3.1
and Windows for Workgroups platforms are not supported.
1.2 What's New in this Release
=========================
* The initial setting for SET REPROCESS is changed to 5 so that Visual
FoxPro tries to lock a record for a limited number of times. If the
attempted lock fails, Visual FoxPro generates an error.
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 3.51 compliance if necessary. See the ODREADME.TXT file
in your Windows system directory for additional information on enhancements
or features of the ODBC 3.51 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 directory 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
Panel
* 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, if 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 in 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),
FoxPro 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 (.DBC file).
Note The Visual FoxPro ODBC Driver only allows transactions on tables
within a Visual FoxPro database (.DBC file), not free tables.
2.2 ODBC 3.51 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. Please report any problems you find regarding the APIs. The
Help file, DRVVFP.HLP, documents supported functions and acceptable input
parameters. In addition, Visual FoxPro SQL extends the SQL functionality
available through the driver. See the Visual FoxPro Language Reference for
the extended grammar.
2.3 Referential Integrity Support
==========================
The Visual FoxPro ODBC Driver supports Visual FoxPro rules, triggers, and
default 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. However, you should disable this feature if the
driver is being called by a multi-threaded application. For more
information, see the "ODBC Visual FoxPro Setup Dialog Box" Help topic.
Remote Views and Parameterized Views
Any time SQLTables( ) is called, remote and parameterized views are
excluded from the list. Local views based on parameterized views are not
excluded, but will generate errors if you use them. If you call SQLTables(
) with a unique table name, however, you will find views (if they are
present) so you can check for name conflicts.
2.5 dBase(r) Support
==========================
Supported Versions of dBASE(r) IV Tables
The Visual FoxPro ODBC Driver gives you access to dBASE(r) 4 and earlier
tables.
The dBASE(r) files are supported in the following manner:
* dBASE(r) v2.x and 3.x: The files are read without conversion.
* dBASE(r) v4.x and 5.x: If the files do not have memo fields and the table
has fewer than 255 columns, the files are read.
Caution If a dBASE(r) v4.x or 5.x file has associated index files (.MDX,
.NDX), the Visual FoxPro ODBC Driver will not update the file properly and
the indexes will be corrupted. These files should be accessed read-only.
* dBASE(r) 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 FoxPro 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
supported collating sequences can be found in the description of SET
COLLATE in the Visual FoxPro Language Reference Help topic.
The default collating sequence is "MACHINE". The collating sequence can be
changed by executing either a SET COLLATE TO Language with the ODBC C API
SQLExecDirect( ), by calling SQLPrepare( ) and SQLExec( ) (see the ODBC SDK
Reference manual p. 42-44), or by selecting a different collating sequence
from the driver options in the Data Source Setup dialog.
Note The FOXPRO.INT file is installed in the system directory. If it is
removed, 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 unsupported 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 ODBC Driver, you might get a "Trigger Failed" message. Check for
unsupported commands 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 user with SET EXCLUSIVE OFF, then 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 with a number, but MSQuery does.
==========================
5. Troubleshooting
==========================
If you have trouble installing the driver, try the following and then try
to reinstall 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, or toolbars such as Microsoft Office Manager.
3. If the computer has video or system ROM shadowing, disable these options
before 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 determining the cause of problems.
* Check to see if the latest build of the driver is installed. To view the
version:
1. In the ODBC Data Source Administrator control Panel, double click the
32bit ODBC icon.
2. Click on 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
parameters, 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
Word, Notepad, or WordPad. Occasionally, it might be necessary to include
the trace log in a bug report. Since the ODBC trace log can be lengthy,
copy only the last four or five function calls and paste them into a
separate document before sending the bug report.
==========================
6. Books
==========================
Microsoft ODBC 3.0 Programmer's Reference and SDK Guide (ISBN#: 1-57231-
516-4 from Microsoft Press) provides basic reference information.
Inside ODBC (ISBN#: 1-55615-815-7 from Microsoft Press) provides a good
background on the development of the ODBC specifications and a CD with ODBC
code examples.
Database Developer's Guide with Visual C++ (ISBN#: 0-672-30613-1 from Sams
Publishing) has several good C++ examples that use the ODBC API.
==========================
Additional query words:
Keywords : win98se
Version : WINDOWS:
Platform : WINDOWS
Issue type : kbinfo Last Reviewed: June 15, 1999