16 The dBASE Driver : Connection Option Descriptions

Connection Option Descriptions
The following connection option descriptions are listed alphabetically by the GUI name that appears on the driver Setup dialog box. The connection string attribute name, along with its short name, is listed immediately underneath the GUI name.
In most cases, the GUI name and the attribute name are the same; however, some exceptions exist. If you need to look up an option by its connection string attribute name, please refer to the alphabetical table of connection string attribute names.
Also, a few connection string attributes, for example, Password, do not have equivalent options that appear on the GUI. They are in the list of descriptions alphabetically by their attribute names.
Table 16-1 lists the connection string attributes supported by the dBASE driver.
Table 16-1. dBASE Attribute Names 
ApplicationUsingThreads
Attribute
ApplicationUsingThreads (AUT)
Description
Determines whether the driver works with applications using multiple ODBC threads.
Valid Values
0 | 1
If set to 1 (Enabled), the driver works with single-threaded and multi-threaded applications.
If set to 0 (Disabled), the driver does not work with multi-threaded applications. If using the driver with single-threaded applications, this value avoids additional processing required for ODBC thread-safety standards.
Default
1 (Enabled)
GUI tab
Advanced tab [dBASE]
Advanced tab [FoxPro]
Cache Size
Attribute
CacheSize (CSZ)
Description
The number of 64 KB blocks the driver uses to cache database records. The larger the number of blocks, the better the performance.
Valid Values
0 | x
where x is a positive integer that specifies the number of 64 KB blocks for caching.
If set to 0, no records are cached.
If set to x, the specified number of 64 KB blocks are set aside for caching. The maximum number of blocks you can set depends on the system memory available. If the cache size is greater than 0, when browsing backwards, you are not able to see updates made by other users until you run the Select statement again.
Default
4
GUI tab
Advanced tab [dBASE]
Advanced tab [FoxPro]
Create Type [dBASE]
Attribute
CreateType (CT) [dBASE]
Description
The type of table or index to be created on a Create Table or Create Index statement.
Valid Values
dBASE4 | dBASE5 | Clipper | FoxPro25 | FoxPro30
Default
dBASE5
GUI tab
General tab
Create Type [FoxPro]
Attribute
CreateType (CT)) [FoxPro]
Description
The type of table or index to be created on a Create Table or Create Index statement.
Valid Value
FoxPro30 Database
Default
FoxPro30 Database
GUI tab
General tab
Data File Extension
Attribute
DataFileExtension (DFE)
Description
A one- to three-character file name extension to use for data files.
Valid Values
ext
where ext is the name of the one- to three-character file name extension.
This value is used for all Create Table statements. Sending a Create Table using an extension other than the value specified for this option causes an error.
In other SQL statements, such as Select or Insert, users can specify an extension other than the one specified for this connection option. The Data File Extension value is used when no extension is specified.
The file extension cannot be one the driver already uses, such as MDX or CDX.
Default
DBF
GUI tab
Advanced tab [dBASE]
Advanced tab [FoxPro]
Data Source Name
Attribute
DataSourceName (DSN)
Description
The name of a data source in your Windows Registry or odbc.ini file.
Valid Values
string
where string is the name of a data source.
Default
None
GUI Tab
General tab [dBASE]
General tab [FoxPro]
Database Directory
Attribute
Database (DB) [dBASE]
Description
The directory that contains the data files.
Valid Values
database_directory
where database_directory is the full path name of the directory in which the data files are stored. If no directory is specified, the current working directory is used.
Default
None
GUI Tab
General tab
Database Name
Attribute
Database (DB) [FoxPro]
Description
The directory that contains the database container (.DBC) files.
Valid Values
database_directory
where database_directory is the full path name of the directory and .DBC file that you want to use.
Default
None
GUI Tab
General tab
Description
Attribute
Description (n/a)
Description
An optional long description of a data source. This description is not used as a runtime connection attribute, but does appear in the ODBC.INI section of the Registry and in the odbc.ini file.
Valid Values
string
where string is a description of a data source.
Default
None
GUI Tab
General tab [dBASE]
General tab [FoxPro]
Extension Case
Attribute
ExtensionCase (EC)
Description
This option determines whether uppercase or lowercase file extensions are accepted.
Valid Values
LOWER | UPPER
When set to UPPER, uppercase extensions are accepted.
When set to LOWER, lowercase extensions are accepted.
Default
UPPER
GUI tab
Advanced tab [dBASE]
Advanced tab [FoxPro]
File Open Cache
Attribute
FileOpenCache (FOC)
Description
The maximum number of used file handles to cache.
Valid Values
0 | x
where x is a positive integer.
If set to 0, no file open caching is performed.
If set to x, when a user opens and closes x tables, the tables are not actually closed. The driver keeps them open so that if another query uses one of these tables, the driver does not have to perform another open, which is expensive. The advantage of file open caching is improved performance. The disadvantage is that a user who tries to open the file exclusively may get a file locking conflict even though no one appears to have the file open.
Default
0 (No File Open Caching)
GUI tab
Advanced tab [dBASE]
Advanced tab [FoxPro]
IANAAppCodePage
Attribute
IANAAppCodePage (IACP)
Description
An Internet Assigned Numbers Authority (IANA) value. You must specify a value for this option if your application is not Unicode‑enabled and/or if your database character set is not Unicode (refer to Chapter 4 “Internationalization, Localization, and Unicode” in the DataDirect Connect Series for ODBC Reference for details). The value you specify must match the database character encoding and the system locale.
The Driver Manager checks for the value of IANAAppCodePage in the following order:
Valid Values
IANA_code_page
where IANA_code_page is one of the valid values listed in Chapter 1 “Values for the Attribute IANAAppCodePage” in the DataDirect Connect Series for ODBC Reference. The value must match the database character encoding and the system locale.
Default
4 (ISO 8559-1 Latin-1)
GUI tab
Advanced tab [dBASE]
Advanced tab [FoxPro]
International Sort
Attribute
IntlSort (IS)
Description
Uses international sort order as defined by your operating system when you issue a Select statement with an Order By clause.
Valid Values
0 | 1
If set to 1 (Enabled), this order is always alphabetic, regardless of case; the letters are sorted as "A, b, C." Refer to your operating system documentation concerning the sorting of accented characters.
If set to 0 (Disabled), ASCII sort order is used. This order sorts items alphabetically with uppercase letters preceding lowercase letters. For example, "A, b, C" is sorted as "A, C, b."
Default
0 (Disabled)
GUI tab
Advanced tab [dBASE]
Advanced tab [FoxPro]
Lock Compatibility
Attribute
LockCompatibility (LCOMP)
Description
The locking scheme the driver uses when locking records.
Valid Values
Clipper | dBASE | Fox | Q+E | Q+EVirtual
Q+E specifies that locks be placed on the actual bytes occupied by the record. Only applications that use the dBASE driver can read and write to the database. Other applications are locked out of the table completely (they cannot even read other records). This locking is compatible with earlier versions of Q+E products.
Q+EVirtual specifies that locks be placed on bytes beyond the physical end-of-file. Q+EVirtual is the same as Q+E except that other applications can open the table and read the data.
The advantage of using a Q+E locking scheme over dBASE locking is that, on Inserts and Updates, Q+E locks only individual index tags, while dBASE locks the entire index. The following values determine locking support as described:
If you are accessing a table with an application that uses the dBASE driver, your locking scheme does not have to match the Create Type. If you access a table with two applications, however, and only one uses the dBASE driver, set your locking scheme to match the other application. For example, you do not have to set this value to Fox to work with a FoxPro table. But if you are using a FoxPro application simultaneously with an application using the dBASE driver on the same set of tables, set this value to Fox to ensure that your data does not become corrupted.
Default
dBASE
GUI tab
Advanced tab [dBASE]
Advanced tab [FoxPro]
Locking
Attribute
Locking (LCK)
Description
The level of locking for the database file.
Valid Values
NONE | RECORD | FILE
Default
RECORD
GUI tab
Advanced tab [dBASE]
Advanced tab [FoxPro]
Use Long Names
Attribute
UseLongNames (ULN)
Description
Specifies whether to use long file names as table names.
Valid Values
0 | 1
If set to 1 (Enabled), the driver uses long file names as table names. The maximum table name length is specific to the environment in which you are running.
If set to 0 (Disabled), the driver does not long file names as table names.
Default
0 (Disabled)
GUI tab
Advanced tab [dBASE]
Advanced tab [FoxPro]
Use Long Qualifiers
Attribute
UseLongQualifiers (ULQ)
Description
Determines whether the driver uses long path names.
Valid Values
0 | 1
If set to 1 (Enabled), path names can be a maximum of 255 characters.
If set to 0 (Disabled), path names can be a maximum of 128 characters.
Default
0 (Disabled)
GUI tab
Advanced tab [dBASE]
Advanced tab [FoxPro]