18 The Text 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 18-2 lists the connection string attributes supported by the Text driver.
Table 18-2. Text Attribute Names 
Action for Undefined Tables
Attribute
UndefinedTable (UT)
Description
Determines whether the driver prompts the user when it encounters a table for which it has no structure information.
Valid Values
PROMPT | GUESS
Specify PROMPT to prompt the user.
Specify GUESS for the driver to guess the format of the file.
Default
GUESS
GUI Tab
Advanced tab
Allow Update and Delete
Attribute
AllowUpdateAndDelete (AUD)
Description
Allows Update and Delete statements. Because Update and Delete statements cause immediate changes to a text file, only one connection at a time can operate on a file. Each update and delete on a text file can cause significant changes to the file, and performance may be degraded. Consider a more appropriate database form if performance is a significant factor.
Valid Values
0 | 1
If set to 1 (Enabled), text files are opened exclusively by the current connection.
If set to 0 (Disabled), Update and Delete statements are not allowed.
Default
0 (Disabled)
GUI Tab
Advanced tab
Application Using Threads
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
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
Century Boundary
Attribute
CenturyBoundary (CB)
Description
The cutoff year for century inference when converting two-digit dates to four-digit dates.
Valid Values
xx
where xx is a two-digit number.
Two-digit dates that are less than the specified year number are converted to 20xx. Two-digit dates greater than or equal to the number are converted to 19xx. For example, using the default value of 20, a date of 19 will be interpreted as 2019 and a date of 21 is interpreted as 1921.
Default
20
GUI Tab
Advanced tab
Column Names in First Line
Attribute
FirstLineNames (FLN)
Description
Determines whether the driver looks for column names in the first line of the file.
NOTE: The Column Names in First Line setting applies only to tables not previously defined. It also determines the attributes of new tables created with the Create Table statement.
Valid Values
0 | 1
If set to 1 (Enabled), the driver looks for column names in the first line of the file.
If set to 0 (Disabled), the driver does not look for column names in the first line of the file.
Default
0 (Disabled)
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.
Default
TXT
GUI Tab
Advanced tab
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
Database Directory
Attribute
Database (DB)
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
Decimal Symbol
Attribute
DecimalSymbol (CS)
Description
The decimal separator used when data is stored.
Valid Values
, | .
If set to Comma (,), the driver uses a comma as the decimal separator.
If set to Period (.), the driver uses a period as the decimal separator.
The international decimal symbol (.) must be used in DML statements and parameter buffers.
Default
. (Period)
GUI Tab
Advanced tab
Default Table Type
Attribute
TableType (TT)
Description
The type of text file (table) that is used when creating a new table and opening an undefined table.
NOTE: The Default Table Type setting applies only to tables not previously defined. It also determines the attributes of new tables created with the Create Table statement.
Valid Values
Comma | Tab | Character | Fixed | Stream
The value chosen determines the type of text used for a table: comma-separated, tab-separated, character-separated, fixed length, or stream.
Default
Comma
GUI Tab
General tab
Delimiter Character
Attribute
Delimiter (DC)
Description
The character used as a delimiter for character-separated files.
NOTE: The Delimiter Character setting applies only to tables not previously defined. It also determines the attributes of new tables created with the Create Table statement.
Valid Values
x
where x is any printable character except single quotes, double quotes, or semicolons.
Note that it is possible to specify a semicolon if you configure the data source using the Windows ODBC Administrator.
Default
, (Comma)
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
Extension List
Attribute
ExtraExtensions (EE)
Description
A comma-separated list of file name extensions for the files that you want returned in addition to the extension specified in the Data File Extension field.
NOTE: You must have also enabled the Files with Matching Extensions option.
Valid Values
ext | NONE
where ext is a file name extension.
To have files with no extensions returned, specify NONE. For example, if some of your files have the extensions TXT and CSV and others have no extension, specify TXT,CSV,NONE.
By default, when an application requests a list of tables, only files that have been defined are returned.
Default
None
GUI Tab
Advanced tab
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
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
Include Files with Matching Extensions
Attribute
n/a
Description
Enables the driver to return files with a given file name extension in addition to the extension specified through the Data File Extension option. After enabling this option, specify the file name extensions through the Extension List option.
Valid Values
0 | 1
If set to 1 (Enabled), the driver returns files with the file name extensions specified through the Extension List and Data File Extension options.
If set to 0 (Disabled), the driver returns only files with the file name extension specified through the Data File Extension option.
Default
0 (Disabled)
GUI Tab
Advanced tab
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
Rows to Scan
Attribute
ScanRows (SR)
Description
The number of rows in a text file that the driver scans to determine the data types in the file.
NOTE: The Rows to Scan setting applies only to tables not previously defined. It also determines the attributes of new tables created with the Create Table statement.
Valid Values
0 | x
where x is a positive integer.
If set to 0, all rows in the file are scanned.
If set to x, x rows are scanned to determine the data types in a file.
Default
25
GUI Tab
Advanced tab
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