Connecting to a Repository Database

Microsoft® Repository can access Repository databases that are managed by either Microsoft Jet or Microsoft SQL Server™. The ODBC connection string that is used to specify the location of the Repository database varies, depending upon which database server is managing the Repository database.

The ODBC connection string contains keyword=keyValue pairs, separated by semicolons.

Connecting to a Jet Repository Database

To connect to a Jet Repository database, use the DBQ keyword to specify the path to the database file. The DBQ keyword must be the first keyword in the connection string, if it is present. If the DBQ keyword is not present, the connection string is assumed to contain only a database path specification. In this case, the Repository will add the DBQ keyword to the front of the ODBC connection string before passing it on to the database server. If the Jet database file specified by the DBQ keyword does not exist, Microsoft Repository will create it.

Connecting to a SQL Server Repository Database

To connect to a SQL Server Repository database, use the SERVER keyword to specify the SQL Server name and (optionally) the database name. To specify the database name, use this syntax:

   SERVER=serverName;DATABASE=databaseName

If the database name is not specified, the default database for the user performing the open is used.

Note   If you choose to use a SQL Server Repository database, you must either use an existing database, or create an empty database and specify which users can access the database. The Repository engine will not automatically create this database for you. If you create a new SQL Server database, be sure to create the necessary "Login" and "User" accounts for people who will be accessing the database, and assign the appropriate permissions to these accounts. If everyone will be granted full permissions, then you can use this SQL command to set database access permissions: "Grant all to public".

Connecting via a Data Source Name

You can use the DSN keyword to specify a Data Source Name (DSN) to connect to an existing Jet or SQL Server Repository database. The DSN keyword specifies a Data Source Name that has been configured via the ODBC Data Source Administrator.

The Default Repository Database

If you do not specify the Repository database via any of the mechanisms described above, a connection will be established to the default Repository database. The location of the default Repository database is stored in the system registry in this registry key:

   HKEY_LOCAL_MACHINE\
      Software\
         Microsoft\
            Repository\
               Current Location

This registry key must contain either a DBQ keyword-value pair, SERVER keyword-value pair, DSN keyword-value pair, or just the path to a Jet Repository database. The default value for this registry key is:

   windowsDirectory\MsApps\Repostry\Repostry.mdb

where windowsDirectory is the path specification for the directory that contains either the Windows NT or Windows 95 installation. Unless you change this registry key value after installing Microsoft Repository, your default database server will be Microsoft Jet.

Note   Microsoft Repository will create a default Repository database for you when it is installed. This database is managed by Microsoft Jet. Its location is determined by the default value of the Current Location registry key.

(c) 1988-1998 Microsoft Corporation. All Rights Reserved.