Edit C:\Program Files (x86)\SAP BusinessObjects\SAP BusinessObjects Enterprise XI 4.0\win32_x86\odbc\7.0.1\help\userguide\btrieve.20.05.html
<?xml version="1.0" encoding="utf-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xml:lang="en" lang="en" xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/html;charset=utf-8" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <!-- MOTW-DISABLED saved from url=(0014)about:internet --> <title>Configuring and Connecting to Data Sources</title> <link rel="StyleSheet" href="css/btrieve.css" type="text/css" media="all" /> <link rel="StyleSheet" href="css/webworks.css" type="text/css" media="all" /> <script type="text/javascript" language="JavaScript1.2" src="wwhdata/common/context.js"></script> <script type="text/javascript" language="JavaScript1.2" src="wwhdata/common/towwhdir.js"></script> <script type="text/javascript" language="JavaScript1.2" src="wwhdata/common/wwhpagef.js"></script> <script type="text/javascript" language="JavaScript1.2"> <!-- var WebWorksRootPath = ""; // --> </script> <script type="text/javascript" language="JavaScript1.2"> <!-- // Set reference to top level help frame // var WWHFrame = WWHGetWWHFrame("", true); // --> </script> <script type="text/javascript" language="JavaScript1.2" src="scripts/expand.js"></script> </head> <body class="" style="background-color: #FFFFEE;" onload="WWHUpdate();" onunload="WWHUnload();" onkeydown="WWHHandleKeyDown((document.all||document.getElementById||document.layers)?event:null);" onkeypress="WWHHandleKeyPress((document.all||document.getElementById||document.layers)?event:null);" onkeyup="WWHHandleKeyUp((document.all||document.getElementById||document.layers)?event:null);"> <br /> <div class="WebWorks_Breadcrumbs" style="text-align: left;"> <a class="WebWorks_Breadcrumb_Link" href="btrieve.20.01.html#106262">15 The Btrieve (Pervasive.SQL) Driver</a> : Configuring and Connecting to Data Sources</div> <hr align="left" /> <blockquote> <div class="head_1"><a name="106262">Configuring and Connecting to Data Sources</a></div> <div class="Body"><a name="132808">After you install the driver, you configure data sources to connect to the database. See </a><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'quikstart.04.1.html#106107', '');">Chapter 1 â??Quick Start Connectâ??</a></span><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'quikstart.04.1.html#106107', '');"> </a></span>for an explanation of different types of data sources. The data source contains connection options that allow you to tune the driver for specific performance. If you want to use a data source but need to change some of its values, you can either modify the data source or override its values at connection time through a connection string.</div> <div class="Body"><a name="107036">If you choose to use a connection string, you must use specific connection string attributes. </a>See <span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'btrieve.20.05.html#106405', '');">â??Using a Connection Stringâ??</a></span> and <span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'btrieve.20.06.html#111018', '');">Table 15-1</a></span> for an alphabetical list of driver connection string attributes and their initial default values.</div> <div class="Body"><a name="132816">On Windows, data sources are stored in the Windows Registry. You can configure and </a>modify data sources through the ODBC Administrator using a driver Setup dialog box.</div> <div class="Body"><a name="132817">When the driver is first installed, the values of its connection options are set by default. </a>These values appear on the driver Setup dialog box tabs when you create a new data source. You can change these default values by modifying the data source. In the following procedure, the description of each tab is followed by a table that lists the connection options for that tab and their initial default values. This table links you to a complete description of the options and their connection string attribute equivalents. The connection string attributes are used to override the default values of the data source if you want to change these values at connection time.</div> <div class="Body"><span class="Action_bold"><a name="106293">To configure a Btrieve data source:</a></span></div> <div class="list_procedure_first_outer" style="margin-left: 0pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_procedure_first_inner" style="width: 18pt; white-space: nowrap;"> <span class="Numbers">1 </span> </div> </td> <td width="100%"> <div class="list_procedure_first_inner"><a name="132821">Start the ODBC Administrator by selecting its icon from the DataDirect Connect </a>program group; then, select a tab:</div> </td> </tr> </table> </div> <div class="list_bulleted_proc_outer" style="margin-left: 18pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_bulleted_proc_inner" style="width: 18pt; white-space: nowrap;">â? </div> </td> <td width="100%"> <div class="list_bulleted_proc_inner"><span class="Action_bold"><a name="132822">User DSN</a></span>: If you are configuring an existing user data source, select the data source name on the User DSN tab and click <span class="Action_bold">Configure</span> to display the driver Setup dialog box.</div> </td> </tr> </table> </div> <div class="Body_Indent_Sub"><a name="132823">If you are configuring a new user data source, click </a><span class="Action_bold">Add</span> on the User DSN tab to display a list of installed drivers. Select the driver and click <span class="Action_bold">Finish</span> to display the driver Setup dialog box.</div> <div class="list_bulleted_proc_outer" style="margin-left: 18pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_bulleted_proc_inner" style="width: 18pt; white-space: nowrap;">â? </div> </td> <td width="100%"> <div class="list_bulleted_proc_inner"><span class="Action_bold"><a name="132824">System DSN</a></span>: To configure a new system data source, click <span class="Action_bold">Add</span> on the System DSN tab to display a list of installed drivers. Select the driver and click <span class="Action_bold">Finish</span> to display the driver Setup dialog box.</div> </td> </tr> </table> </div> <div class="list_bulleted_proc_outer" style="margin-left: 18pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_bulleted_proc_inner" style="width: 18pt; white-space: nowrap;">â? </div> </td> <td width="100%"> <div class="list_bulleted_proc_inner"><span class="Action_bold"><a name="132825">File DSN</a></span>: If you are configuring an existing file data source, select the data source name on the File DSN tab and click <span class="Action_bold">Configure</span> to display the driver Setup dialog box.</div> </td> </tr> </table> </div> <div class="Body_Indent_Sub"><a name="132826">If you are configuring a new file data source, click </a><span class="Action_bold">Add</span> on the File DSN tab to display a list of installed drivers. Select the driver and click <span class="Action_bold">Next</span>. Specify a name for the data source and click <span class="Action_bold">Next</span>. Verify the data source information; then, click <span class="Action_bold">Finish</span> to display the driver Setup dialog box.</div> <div class="Body_Indent"><a name="106304">The General tab of the Setup dialog box appears by default.</a></div> <div class="picture"><a name="130918"><img class="procedure" src="images/btrgen.gif" width="447" height="482" style="display: block; float: none; left: 0.0; top: 0.0;" alt="The General tab of the ODBC Btrieve Driver Setup dialog box" /></a></div> <div class="Body_Indent"><a name="106313">NOTE: The General tab displays only fields that are required for creating a data source. </a>The fields on all other tabs are optional, unless noted otherwise.</div> <div class="list_procedure_outer" style="margin-left: 0pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_procedure_inner" style="width: 18pt; white-space: nowrap;"> <span class="Numbers">2 </span> </div> </td> <td width="100%"> <div class="list_procedure_inner"><a name="107396">On this tab, provide values for the options in the following table; then, click </a><span class="Action_bold">Apply. </span>The table provides links to descriptions of the connection options.</div> </td> </tr> </table> </div> <table class="Format_D" cellspacing="0" summary=""> <caption></caption> <tr style="vertical-align: top;"> <td style="padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_column_heads"><a name="107399">Connection Options: General</a></div> </td> <td style="padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_column_heads"><a name="107401">Default</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a href="javascript:WWHClickedPopup('ODBC', 'btrieve.20.06.html#112911', '');" name="107406">Data Source Name</a></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="107408"> None</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a href="javascript:WWHClickedPopup('ODBC', 'btrieve.20.06.html#108604', '');" name="107413">Description</a></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="107415"> None </a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a href="javascript:WWHClickedPopup('ODBC', 'btrieve.20.06.html#108574', '');" name="107420">Database Directory</a></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="107425"> None</a></div> </td> </tr> </table> <div class="list_procedure_outer" style="margin-left: 0pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_procedure_inner" style="width: 18pt; white-space: nowrap;"> <span class="Numbers">3 </span> </div> </td> <td width="100%"> <div class="list_procedure_inner"><a name="106320">Optionally, click the </a><span class="Action_bold">Advanced</span> tab to specify data source settings. </div> </td> </tr> </table> </div> <div class="picture"><a name="130931"><img class="procedure" src="images/btradv.gif" width="447" height="485" style="display: block; float: none; left: 0.0; top: 0.0;" alt="The Advanced tab of the ODBC Btrieve Driver Setup dialog box" /></a></div> <div class="Body_Indent"><a name="107579">On this tab, provide values for any of the options in the following table; then, click </a><span class="Action_bold">Apply. </span>The table provides links to descriptions of the connection options.</div> <table class="Format_D" cellspacing="0" summary=""> <caption></caption> <tr style="vertical-align: top;"> <td style="padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_column_heads"><a name="107582">Connection Options: Advanced</a></div> </td> <td style="padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_column_heads"><a name="107584">Default</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a href="javascript:WWHClickedPopup('ODBC', 'btrieve.20.06.html#108589', '');" name="107610">Default Logon ID</a></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="107612">None</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a href="javascript:WWHClickedPopup('ODBC', 'btrieve.20.06.html#110091', '');" name="107617">File Open Cache</a></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="107619">0</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a href="javascript:WWHClickedPopup('ODBC', 'btrieve.20.06.html#108521', '');" name="107624">Array Size</a></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="107626">4096</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a href="javascript:WWHClickedPopup('ODBC', 'btrieve.20.06.html#108536', '');" name="107631">Data File Extension</a></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="107633">DTA</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a href="javascript:WWHClickedPopup('ODBC', 'btrieve.20.06.html#108488', '');" name="107638">Action for Undefined Tables</a></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="107640">Return Error Condition</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a href="javascript:WWHClickedPopup('ODBC', 'btrieve.20.06.html#108634', '');" name="107645">International Sort</a></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="107647">Disabled</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a href="javascript:WWHClickedPopup('ODBC', 'btrieve.20.06.html#108666', '');" name="107652">Use Long Qualifiers</a></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="107657">Disabled</a></div> </td> </tr> <tr style="vertical-align: top;"> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a href="javascript:WWHClickedPopup('ODBC', 'btrieve.20.06.html#112676', '');" name="107696">Application Using Threads</a></div> </td> <td style="border-bottom-color: Black; border-right-color: Black; border-top-color: Black; padding-bottom: auto; padding-left: auto; padding-right: auto; padding-top: auto; vertical-align: top;"> <div class="table_text"><a name="107698">Enabled</a></div> </td> </tr> </table> <div class="Body_Indent"><span class="Action_bold"><a name="116697">Define:</a></span> Click <span class="Action_bold">Define</span> to define table structure as described in <span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'btrieve.20.07.html#116630', '');">â??Defining Table Structureâ??</a></span>.</div> <div class="Body_Indent"><span class="Action_bold"><a name="132834">Translate: </a></span>Click <span class="Action_bold">Translate</span> to display the Select Translator dialog box, which lists the translators specified in the ODBC Translators section of the Registry. DataDirect provides a translator named OEM to ANSI that translates your data from the IBM PC character set to the ANSI character set.</div> <div class="Body_Indent"><a name="132835">Select a translator; then, click </a><span class="Action_bold">OK</span> to close this dialog box.</div> <div class="list_procedure_outer" style="margin-left: 0pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_procedure_inner" style="width: 18pt; white-space: nowrap;"> <span class="Numbers">4 </span> </div> </td> <td width="100%"> <div class="list_procedure_inner"><a name="106361">At any point during the configuration process, you can click </a><span class="Action_bold">Test Connect</span> to attempt to connect to the data source using the connection properties specified in the driver Setup dialog box.</div> </td> </tr> </table> </div> <div class="list_bulleted_proc_outer" style="margin-left: 18pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_bulleted_proc_inner" style="width: 18pt; white-space: nowrap;">â? </div> </td> <td width="100%"> <div class="list_bulleted_proc_inner"><a name="106362">If the driver can connect, it releases the connection and displays a </a><span class="Syntax">Connection </span><span class="Syntax">established!</span> message. Click <span class="Action_bold">OK</span>.</div> </td> </tr> </table> </div> <div class="list_bulleted_proc_outer" style="margin-left: 18pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_bulleted_proc_inner" style="width: 18pt; white-space: nowrap;">â? </div> </td> <td width="100%"> <div class="list_bulleted_proc_inner"><a name="106363">If the driver cannot connect because of an incorrect environment or connection </a>value, it displays an appropriate error message.</div> </td> </tr> </table> </div> <div class="Body_Indent_Sub"><a name="106364">Verify that all required client software is properly installed. If it is not, you will see the </a>message:</div> <div class="syntax_embed_sub_first"><a name="106365">Specified driver could not be loaded due to system error [xxx].</a></div> <div class="Body_Indent_Sub"><a name="106366">Click </a><span class="Action_bold">OK</span>.</div> <div class="list_procedure_outer" style="margin-left: 0pt;"> <table border="0" cellspacing="0" cellpadding="0" summary=""> <tr style="vertical-align: baseline;"> <td> <div class="list_procedure_inner" style="width: 18pt; white-space: nowrap;"> <span class="Numbers">5 </span> </div> </td> <td width="100%"> <div class="list_procedure_inner"><a name="106367">Click </a><span class="Action_bold">OK</span> or <span class="Action_bold">Cancel</span>. If you click <span class="Action_bold">OK</span>, the values you have specified become the defaults when you connect to the data source. You can change these defaults by using this procedure to reconfigure your data source. You can override these defaults by connecting to the data source using a connection string with alternate values.</div> </td> </tr> </table> </div> <div class="head_2"><a name="106405">Using a Connection String</a></div> <div class="Body"><a name="132839">If you want to use a connection string for connecting to a database, or if your application </a>requires it, you must specify either a DSN (data source name), a File DSN, or a DSN-less connection in the string. The difference is whether you use the DSN=, FILEDSN=, or the DRIVER= keyword in the connection string, as described in the ODBC specification. A DSN or FILEDSN connection string tells the driver where to find the default connection information. Optionally, you may specify <span class="Emphasis">attribute=value</span> pairs in the connection string to override the default values stored in the data source.</div> <div class="Body"><a name="132840">The DSN connection string has the form:</a></div> <div class="syntax_first"><a name="132841">DSN=</a><span class="EquationVariables">data_source_name</span>[;<span class="EquationVariables">attribute=value</span>[;<span class="EquationVariables">attribute=value</span>]...]</div> <div class="Body"><a name="132842">The FILEDSN connection string has the form:</a></div> <div class="syntax_first"><a name="132843">FILEDSN=</a><span class="EquationVariables">filename.</span><span class="Syntax">dsn</span>[;<span class="EquationVariables">attribute=value</span>[;<span class="EquationVariables">attribute=value</span>]...]</div> <div class="Body"><a name="132844">The DSN-less connection string specifies a driver instead of a data source. All connection </a>information must be entered in the connection string because the information is not stored in a data source.</div> <div class="Body"><a name="132845">The DSN-less connection string has the form:</a></div> <div class="syntax_first"><a name="132846">DRIVER=[{]</a><span class="EquationVariables">driver_name</span>[}][;<span class="EquationVariables">attribute=value</span>[;<span class="EquationVariables">attribute=value</span>]...]</div> <div class="Body"><span class="Cross_ref_"><a href="javascript:WWHClickedPopup('ODBC', 'btrieve.20.06.html#111018', '');" name="132850">Table 15-1</a></span><span class="Cross_ref_"> </span>lists the long and short names for each attribute, as well as the initial default value when the driver is first installed. You can specify either long or short names in the connection string.</div> <div class="Body"><a name="127206">An example of a DSN connection string with overriding attribute values for Btrieve is:</a></div> <div class="syntax_first"><a name="106425">DSN=BTRIEVE FILES;DB=J:\Btrvdata</a></div> <div class="Body"><a name="106426">A FILEDSN connection string is similar except for the initial keyword:</a></div> <div class="syntax_first"><a name="106427">FILEDSN=Btrieve.dsn;DB=J:\Btrvdata</a></div> <div class="Body"><a name="106428">A DSN-less connection string must provide all necessary connection information:</a></div> <div class="syntax_first"><a name="106429">DRIVER=DataDirect 7.0 Btrieve;DB=J:\Btrvdata;UID=JOHN;PWD=XYZZY</a></div> <script type="text/javascript" language="JavaScript1.2"> <!-- // Clear related topics // WWHClearRelatedTopics(); document.writeln(WWHRelatedTopicsInlineHTML()); // --> </script> </blockquote> <script type="text/javascript" language="JavaScript1.2"> <!-- document.write(WWHRelatedTopicsDivTag() + WWHPopupDivTag() + WWHALinksDivTag()); // --> </script> </body> </html>
Ms-Dos/Windows
Unix
Write backup
jsp File Browser version 1.2 by
www.vonloesch.de