Exporting and Importing Configuration Files

Use the following procedures to convert binary configuration files to an editable format. After you make your changes, convert the text file back to a binary file to use with the Client. Conversion is done using the export and import commands, which can be executed from a command line or by selecting menu commands in the Client Console. (For instructions on using the Export Client Configuration option, see the DATABridge Client Console Help.)

To export the client configuration file (for the data source)

  • Open a command session and run the following command:

    dbutility options export filename

where filename (optional) is used to specify a name for the exported file, other than the default (dbridge.ini).

Option

Description

-E

Toggles the setting of the configuration parameter encode passwords.

-u

Use this option if the exported or imported filename is the same as the existing filename to prevent from overwriting the existing file. For example:

dbutility -u export dbridge.cfg

exports a text file called "dbridge.cfg" while preserving the existing binary configuration file "dbridge.cfg".

The export command creates a text file (regardless of the file extension) in the config subdirectory of the data source's working directory.

To import the client configuration file

Use this procedure to import a text-based client configuration file as a new binary configuration file. Binary configuration files can be used with both command-line and service-based client operations.

  • Open a command session and run the following command:

    dbutility options import

    This command processes the text file (dbridge.ini) and creates an equivalent binary configuration file (dbridge.cfg) in the same directory (config). If the text file contains errors, no binary file is created. Instead, you'll receive an error message to help you identify the error.

    Option

    Description

    -f filename

    Use this option to specify the file you want to import (that is, the input file). This file is assumed to be in the config subdirectory of the working directory, unless the full path is specified, starting with a backslash (Windows) or forward slash (UNIX).

    -u

    Use this option if the exported and imported filenames are the same to allow the existing file to be overwritten. For example:

    dbutility -u export dbridge.cfg

    This command exports a text file called "dbridge.cfg" and creates the binary configuration file "dbridge.cfg" which replaces the text file of the same name.

To export the service configuration file

  • Open a command session and from the client working directory, run the following command:

    dbctrlconfigure export dbcontrol.cfg

    This command creates an editable text configuration file (dbcontrol.ini) from the binary file.

To import the service configuration file

  1. Open a command session and run the following command:

    dbctrlconfigure import dbcontrol.cfg

    This command creates a binary configuration file from the imported text configuration file.