DB2 Version 9.7 für Linux, UNIX und Windows

Konfigurationsdatei db2dsdriver

Die Konfigurationsdatei db2dsdriver.cfg ist eine ASCII-Datei, die verschiedene Schlüsselwörter und Werte enthält, die verwendet werden können, um über ODBC-, CLI-, .NET-, OLE DB- oder Open-Source-Software (PHP oder Ruby) und die Anwendungen, die die Schlüsselwörter verwenden, eine Verbindung zu einer unterstützten Datenbank herzustellen. Die Schlüsselwörter sind dem Aliasnamen der Datenbank zugeordnet und haben Einfluss auf alle Anwendungen, die auf die Datenbank zugreifen. Sie können diese Konfigurationsdatei auch verwenden, um für Sysplex relevante Einstellungen anzugeben.

Diese Konfigurationsdatei kann mit den folgenden Datenservertreibern verwendet werden:

• CLI-Treiber:
  • IBM Data Server Driver for ODBC and CLI
• Datenservertreiber:
  • IBM Data Server Driver Package
• IBM Data Server-Clients:
  • IBM Data Server Client
  • IBM Data Server Runtime Client
  Für IBM Data Server-Clients wird die Konfigurationsdatei db2dsdriver.cfg nur verwendet, um für Sysplex relevante Einstellungen, wie z. B. WLB und ACR, abzurufen. Die Datenbankverbindungsinformationen und -merkmale sollten aus einer anderen Quelle stammen, z. B. aus dem Datenbankkatalog, einer Verbindungszeichenfolge, der Initialisierungsdatei db2cli.ini oder den .NET-Objektmerkmalen.

Sie müssen die Konfigurationsdatei db2dsdriver.cfg nicht für diese Treiber erstellen und füllen, da die Treiber ohne diese Konfigurationsdatei ausgeführt werden können. Anstatt in Ihren Anwendungen Informationen zum Datenbanknamen, zum Host, zum Port und zu Konfigurationsparametern anzugeben, können Sie die Konfigurationsdatei verwenden, um Aliasnamen anzugeben.

Wenn Sie über einen vorhandenen IBM Data Server-Client verfügen ( IBM Data Server Runtime Client oder IBM Data Server Client), können Sie die vorhandenen Informationen des Datenbankverzeichnisses unter Verwendung des Befehls db2dsdcfgfill in die Konfigurationsdatei db2dsdriver.cfg kopieren. Mithilfe dieses Befehls wird die Konfigurationsdatei auf der Basis des Inhalts des lokalen Datenbankverzeichnisses, des Knotenverzeichnisses und des DCS-Verzeichnisses (Database Connection Services) einer spezifischen Datenbankmanagerinstanz gefüllt.

Die in der Konfigurationsdatei angegebenen verschiedenen Schlüsselwörter, Werte und spezifischen Datenbankverbindungseinstellungen gelten für alle ODBC-, CLI-, .NET- oder Open-Source-Anwendungsverbindungen, die zu dieser Datenbank oder diesem Aliasnamen hergestellt wurden.

Die Konfigurationsdatei db2dsdriver.cfg kann bearbeitet werden. Die Datei muss jedoch manuell bearbeitet werden. Außerdem müssen Sie die Anwendung nach der Bearbeitung der Datei erneut starten, damit die Änderungen wirksam werden. Die Konfigurationsdatei wird in einem der folgenden Pfade erstellt:

• Bei einem Data Server-Client wird die Konfigurationsdatei im Ordner cfg des Instanzpfads erstellt:
  • Unter AIX-, HP-UX-, Linux- oder Solaris-Betriebssystemen: instanzpfad/cfg
  • Unter Windows-Betriebssystemen: instanzpfad\cfg
• Bei einem Datenservertreiber wird die Konfigurationsdatei im Ordner cfg des Installationspfads erstellt:
  • Unter AIX-, HP-UX-, Linux- oder Solaris-Betriebssystemen: installationspfad/cfg
  • Unter Windows-Betriebssystemen: installationspfad\cfg

Die Konfigurationsdatei darf keine identischen Einträge für eine Datenbank mit den folgenden Merkmalen enthalten: Datenbankname, Servername und Portnummer. Außerdem darf die Konfigurationsdatei keine identischen Einträge für Datenbankaliasnamen enthalten.

Als Hilfestellung wird eine Beispielkonfigurationsdatei mitgeliefert. Sie befindet sich im Verzeichnis sqllib/cfg. Die Konfigurationsdatei enthält die folgenden Anschnitte:

• den Abschnitt mit dem Datenquellennamen innerhalb des Tags DSN_Collection,
• den Abschnitt mit den Datenbankinformationen innerhalb der Datenbanktags,
• den Abschnitt mit den globalen Attributen innerhalb der Parametertags.

<configuration>
	<DSN_Collection>
		<dsn alias="alias1" name="name1" host="server1.net1.com" port="50001"/>
		<!-- Long aliases are supported -->
		<dsn alias="longaliasname2" name="name2" host="server2.net1.com" port="55551">
			<parameter name="Authentication" value="Client"/>
		</dsn>
	</DSN_Collection>
	<databases>
		<database name="name1" host="server1.net1.com" port="50001">
			<parameter name="CurrentSchema" value="OWNER1"/>
			<wlb>
				<parameter name="enableWLB" value="true"/>
				<parameter name="maxTransports" value="50"/>
			</wlb>
			<acr>
				<parameter name="enableACR" value="true"/>
			</acr>
		</database>
		<!-- Local IPC connection -->
		<database name="name3" host="localhost" port="0">
			<parameter name="IPCInstance" value="DB2"/>
			<parameter name="CommProtocol" value="IPC"/>
		</database>
	</databases>
	<parameters>
		<parameter name="GlobalParam" value="Value"/>
	</parameters>
</configuration>