When the driver is first installed, the values of its connection options are set by default. 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.

To configure an XML data source:

  1. Start the ODBC Administrator by selecting its icon from the DataDirect Connect program group; then, select a tab:
    • User DSN: If you are configuring an existing user data source, select the data source name on the User DSN tab and click Configure to display the driver Setup dialog box.
    If you are configuring a new user data source, click Add on the User DSN tab to display a list of installed drivers. Select the driver and click Finish to display the driver Setup dialog box.
    • System DSN: To configure a new system data source, click Add on the System DSN tab to display a list of installed drivers. Select the driver and click Finish to display the driver Setup dialog box.
    • File DSN: If you are configuring an existing file data source, select the data source name on the File DSN tab and click Configure to display the driver Setup dialog box.
    If you are configuring a new file data source, click Add on the File DSN tab to display a list of installed drivers. Select the driver and click Next. Specify a name for the data source and click Next. Verify the data source information; then, click Finish to display the driver Setup dialog box.
    The General tab of the Setup dialog box appears by default.
    Figure 1. Driver Setup: General tab

    The General tab of the ODBC XML Driver Setup dialog box

    Note: The General tab displays only fields that are required for creating a data source. The fields on all other tabs are optional, unless noted otherwise.
  2. On the General tab, provide the following information; then, click Apply.
    Connection Options: General Default
    Data Source Name None
    Description None
    Location Names None
  3. If you want to edit or delete a location name, or change its position in the list, select it; then, click Edit, Delete, Up, or Down as appropriate.
  4. If you want to define a location, click Add. The Configure Location dialog box appears.
    Figure 2. Configure Location: General tab

    The General tab of the Configure Location dialog box for XML

  5. On the General tab of the Configure Location dialog box, provide the following required information; then, click Apply.
    Configure Location Options: General Default
    Location Names None
    Location Type None
    Location localhost

    Location: Either type the full path to the location you are defining or click the select button: to select a path.

  6. Optionally, click the Advanced tab of the Configure Location dialog box to specify additional information about the location you are defining.
    Figure 3. Configure Location: Advanced tab

    The Advanced tab of the Configure Location dialog box

    On this tab, provide any of the following optional information; then, click Apply.

    Configure Location Options: Advanced Default
    Table Hint None
    Row Hint None
    Validate Schema Disabled
    Resolve External References Disabled
    Flush Every Change Enabled
    Require User ID/Password Disabled
    User ID None
    Password None
    Table Creation DataDirect Format
    Delete Linked Schema Disabled
    Max Rows to Scan 0
  7. You can click Test Connect to attempt to connect to the location.
    • If the driver can connect, it releases the connection and displays a connection established message. Click OK.
    • If the driver cannot connect because of an incorrect environment or connection value, it displays an appropriate error message. Click OK.
  8. Click OK to return to the ODBC XML driver Setup dialog box or Cancel. If you click OK, the values you have specified become the defaults for this location.
  9. Optionally, click the Advanced tab of the ODBC XML driver Setup dialog box to specify data source settings.
    Figure 4. Driver Setup: Advanced tab

    The Advanced tab of the ODBC XML Driver Setup dialog box

    On this tab, provide any of the following optional information; then, click Apply.

    Connection Options: Advanced Default
    Logging Disabled
    International Sort Order Disabled
    Schema Mode Show Virtual Schemas Only
    Report Codepage Conversion Errors 0 - Ignore Errors
    Read Only Disabled
  10. Optionally, click the Options tab to specify data source connection values.
    Figure 5. Driver Setup: Options tab

    The Options tab of the ODBC XML Driver Setup dialog box

    Driver Options: Type configuration options specific to the XML driver.

    Connection Options: Options Default
    Driver Options Disabled
    Warning: The properties you set in the Options tab override other properties for this session only and can adversely affect the operation of the XML driver. Use only authorized entries. For information about authorized entries for the Options tab, contact Progress DataDirect customer support.
  11. At any point during the configuration process, you can click Test Connect to attempt to connect to the data source using the connection options specified in the driver Setup dialog box. A logon dialog box appears (see Using a Logon Dialog Box (XML) for details). Note that the information you enter in the logon dialog box during a test connect is not saved.
    • If the driver can connect, it releases the connection and displays a connection established message. Click OK.
    • If the driver cannot connect because of an incorrect environment or connection value, it displays an appropriate error message. Click OK.
  12. Click OK or Cancel. If you click OK, 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.