![[z/OS]](../images/ngzos.gif)
Erforderliche Mindesteinstellungen für DB2 unter z/OS mit Verbindung zu einem Anwendungsserver unter z/OS
Diese Eigenschaften sind je nach den Anforderungen für JDBC-Treiberimplementierungen, die der Datenbankhersteller festlegt, verschieden. Sie müssen für jede Datenquelle, die Sie konfigurieren, die geeigneten Eigenschaften festlegen. Diese Einstellungen sind für eine DB2-Datenquelle bestimmt, die unter z/OS ausgeführt wird und mit einem ebenfalls unter z/OS ausgeführten Anwendungsserver verbunden werden soll.
- DB2 Using IBM JCC Driver
Dieser Provider ist ein JCC-Provider mit einphasigem Commit für DB2, der IBM Data Server Driver for JDBC and SQLJ verwendet. IBM Data Server Driver for JDBC and SQLJ ist die nächste Generation von DB2 Universal JDBC Driver. Datenquellen, die Sie unter diesem Provider erstellen, unterstützen nur die einphasige Commit-Verarbeitung, sofern Sie nicht den JDBC-Treiber des Typs 2 mit dem Anwendungsserver für z/OS verwenden. Wenn Sie den Anwendungsserver unter z/OS mit dem Treiber des Typs 2 ausführen, verwendet der Treiber RRS und unterstützt die zweiphasige Commit-Verarbeitung.
Für diesen Provider gilt Folgendes:- Kann auf Knoten der Version 7.0 und höher konfiguriert werden.
- Unterstützt die folgende einphasige Datenquelle:
com.ibm.db2.jcc.DB2ConnectionPoolDataSource
- Setzt die folgenden JDBC-Treiberdateien voraus:
- db2jcc4.jar - Dies ist die JAR-Datei für IBM Data Server Driver for JDBC and SQLJ. Legen Sie die Pfadvariable DB2_JCC_DRIVER_PATH so fest, dass sie auf die Datei "db2jcc4.jar" verweist. Nach der Installation von DB2 finden Sie diese JAR-Datei im Verzeichnis DB2 java. Damit der JDBC-Treiber des Typs 4 auf einer Clientmaschine unterstützt wird, auf der DB2 nicht installiert ist, müssen Sie diese Datei auf die lokale Maschine kopieren. Wenn Sie Fixes oder Upgrades in DB2 installieren, müssen Sie diese Datei ebenfalls aktualisieren.
- db2jcc_license_cu.jar - Dies ist die Lizenzdatei von IBM Data Server Driver for JDBC and SQLJ, die den Zugriff auf die DB2-Datenbank ermöglicht. Verwenden Sie diese JAR-Datei oder die nächste Datei, um auf die Datenbank zuzugreifen. Diese JAR-Datei wird mit dem Anwendungsserver in einem Verzeichnis bereitgestellt, das mit der Umgebungsvariablen UNIVERSAL_JDBC_DRIVER_PATH definiert wird.
- db2jcc_license_cisuz.jar - Dies ist die Lizenzdatei von
IBM Data Server for JDBC and SQLJ, die den Zugriff auf die folgenden Datenbanken ermöglicht:
- DB2 Database for Linux, UNIX and Windows
- DB2 for iSeries
- DB2 for z/OS
- DB2 for VM and VSE
Die Datei "db2jcc_license_cisuz.jar" wird nicht mit dem Anwendungsserver bereitgestellt. Stellen Sie diese Datei in dasselbe Verzeichnis wie die Datei "db2jcc4.jar", damit DB2_JCC_DRIVER_PATH auf beide Dateien verweist.
- Die nativen Dateien, die für IBM Data Server Driver for JDBC and SQLJ im Anwendungsserver erforderlich sind. Diese Dateien sind nur dann erforderlich, wenn "driverType" auf 2 gesetzt ist.
- Verwendet die folgenden Klassenpfade:
${DB2_JCC_DRIVER_PATH}/db2jcc4.jar ${UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_license_cu.jar ${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar ${PUREQUERY_PATH}/pdq.jar ${PUREQUERY_PATH}/pdqmgmt.jar
Fehler vermeiden: Wenn Sie den Verzeichnispfad für ${DB2_JCC_DRIVER_PATH}, ${UNIVERSAL_JDBC_DRIVER_PATH} und ${DB2_JCC_DRIVER_PATH} angeben, dürfen Sie keinen Pfad mit Sonderzeichen gemäß Abschnitt 2.4.3 des Dokuments RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax verwenden. gotcha
Achtung: Die Variablen ${PUREQUERY_PATH}/pdq.jar und ${PUREQUERY_PATH}/pdqmgmt.jar werden dem Klassenpfad als optionale Unterstützung hinzugefügt und sind nur dann erforderlich, wenn der JDBC-Provider von "pureQuery"-Anwendungen verwendet wird. Wenn Sie diesen JDBC-Provider mit "pureQuery"-Anwendungen verwenden, geben Sie für die Variable PUREQUERY_PATH das Verzeichnis an, in dem die JAR-Dateien für IBM Optim pureQuery Runtime gespeichert sind. - Verwendet den folgenden Pfad der nativen Bibliothek:
Wenn "driverType" auf 2 gesetzt wird, sollte für die Variable DB2_JCC_DRIVER_NATIVEPATH das Verzeichnis in Ihrer DB2-Clientinstallation angegeben werden, das die Bibliotheken für den nativen Treiber enthält. Wenn "driverType" auf 4 gesetzt wird, wird der native Pfad nicht verwendet.${DB2_JCC_DRIVER_NATIVEPATH}
- setzt die folgende DataStoreHelper-Klasse voraus:
com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper
- Setzt einen gültigen Authentifizierungsalias voraus.
- Setzt die folgenden Eigenschaften voraus:
- databaseName - Der Name einer tatsächlichen Datenbank, wenn für driverType der Wert 4 angegeben wird, oder der Name einer lokal katalogisierten Datenbank, wenn für driverType der Wert 2 angegeben wird.
- driverType - Der JDBC-Konnektivitätstyp einer Datenquelle. Es gibt zwei zulässige Werte: 2 und 4. Wenn Sie den Treiber des Typs 2 verwenden, setzen Sie diesen Wert auf 2. Möchten Sie Typ 4 verwenden, setzen Sie diesen Wert auf 4.
- serverName - Die TCP/IP-Adresse oder der Hostname des DRDA-Servers (Distributed Relational Database Architecture). Geben Sie nur dann einen Wert für diese Eigenschaft an, wenn driverType auf 4 gesetzt ist. Ist driverType auf 2 gesetzt, ist diese Eigenschaft nicht erforderlich.
- portNumber - Die Nummer des TCP/IP-Ports für den DRDA-Server. Geben Sie nur dann einen Wert für diese Eigenschaft an, wenn driverType auf 4 gesetzt ist. Ist driverType auf 2 gesetzt, ist diese Eigenschaft nicht erforderlich.
- useTransactionRedirect - Konfigurieren Sie diese Eigenschaft als
angepasste Eigenschaft der Datenquelle, wenn Ihr Back-End
Database Partitioning
Feature (DPF) verwendet und wenn Ihr Partitionierungsschlüssel während einer Transaktion konstant bleibt.
Durch Aktivieren der Eigenschaft legen Sie fest, wie
IBM Data Server Driver for JDBC and SQLJ jede Verbindungsanforderung, die eine Transaktion mit DB2 einleitet, überträgt.
Der JDBC-Treiber wird aktiviert, um diese Verbindungsanforderungen an den DPF-Knoten zu senden, der die Zieldaten
der ersten weiterleitbaren Anweisung in der Transaktion enthält, sofern eine solche Anweisung vorhanden ist.
Anschließend überträgt
DB2 diese SQL-Anweisungen nach Bedarf
an verschiedene Partitionen. Vom Standpunkt des Anwendungsservers aus wird die Transaktion normal fortgesetzt.
Sie können die Eigenschaft useTransactionRedirect sowohl für Datenquellen mit driverType 2 als auch für Datenquellen mit driverType 4 verwenden. Verwenden Sie zum Konfigurieren der Eigenschaft entweder das Scripting-Tool "wsadmin" oder die entsprechende Seite in der Administrationskonsole mit den angepassten Einstellungen für den Java™-EE-Ressourcenprovider oder die Verbindungsfactory. Ordnen Sie der Eigenschaft den Wert true zu.
- DB2 Using IBM JCC Driver (XA)DB2 Using IBM JCC Driver (XA) ist ein JCC-Provider mit zweiphasigem Commit für DB2, der IBM Data Server Driver for JDBC and SQLJ verwendet. IBM Data Server Driver ist die nächste Generation von DB2 Universal JDBC Driver. Datenquellen, die Sie unter diesem Provider erstellen, unterstützen die Verwendung von XA für die zweiphasige Commit-Verarbeitung.
Fehler vermeiden: Verwenden Sie den JDBC-Treiber des Typs 2 nicht im Anwendungsserver für z/OS.gotcha
Für diesen Provider gilt Folgendes:- Kann auf Knoten der Version 7.0 und höher konfiguriert werden.
- Unterstützt die folgende zweiphasige Datenquelle:
com.ibm.db2.jcc.DB2XADataSource
- setzt die folgenden JDBC-Treiberdateien voraus:
- db2jcc4.jar - Dies ist die JAR-Datei für IBM Data Server Driver for JDBC and SQLJ. Legen Sie die Pfadvariable DB2_JCC_DRIVER_PATH so fest, dass sie auf die Datei "db2jcc4.jar" verweist. Nach der Installation von DB2 finden Sie diese JAR-Datei im Verzeichnis DB2 Java. Damit der JDBC-Treiber des Typs 4 auf einer Clientmaschine unterstützt wird, auf der DB2 nicht installiert ist, installieren Sie diese Datei auf dem lokalen System. Wenn Sie Fixes oder Upgrades in DB2 installieren, müssen Sie diese Datei ebenfalls aktualisieren. Außerdem müssen Sie den vollständig qualifizierten Pfad der Datei "db2jcc4.jar" als Wert für die Umgebungsvariable DB2_JCC_DRIVER_PATH angeben.
- db2jcc_license_cu.jar - Dies ist die Lizenzdatei, die den Zugriff auf die DB2-Datenbank ermöglicht. Verwenden Sie diese JAR-Datei oder die nächste Datei, um auf die Datenbank zuzugreifen. Diese JAR-Datei wird mit dem Anwendungsserver in einem Verzeichnis bereitgestellt, das mit der Umgebungsvariablen UNIVERSAL_JDBC_DRIVER_PATH definiert wird.
- db2jcc_license_cisuz.jar - Dies ist die Lizenzdatei für den Zugriff auf die folgenden Datenbanken:
- DB2 Database for Linux, UNIX and Windows
- DB2 for iSeries
- DB2 for z/OS
- DB2 for VM and VSE
Die Datei "db2jcc_license_cisuz.jar" wird nicht mit dem Anwendungsserver bereitgestellt. Stellen Sie diese Datei in dasselbe Verzeichnis wie die Datei "db2jcc4.jar", damit DB2_JCC_DRIVER_PATH auf beide Dateien verweist.
- Die nativen Dateien, die für IBM Data Server Driver for JDBC and SQLJ im Anwendungsserver erforderlich sind. Diese Dateien sind nur dann erforderlich, wenn "driverType" auf 2 gesetzt ist.
- Verwendet die folgenden Klassenpfade:
${DB2_JCC_DRIVER_PATH}/db2jcc4.jar ${UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_license_cu.jar ${DB2_JCC_DRIVER_PATH}/db2jcc_license_cisuz.jar ${PUREQUERY_PATH}/pdq.jar ${PUREQUERY_PATH}/pdqmgmt.jar
Fehler vermeiden: Wenn Sie den Verzeichnispfad für ${DB2_JCC_DRIVER_PATH}, ${UNIVERSAL_JDBC_DRIVER_PATH} und ${DB2_JCC_DRIVER_PATH} angeben, dürfen Sie keinen Pfad mit Sonderzeichen gemäß Abschnitt 2.4.3 des Dokuments RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax verwenden. gotcha
Achtung: Die Variablen ${PUREQUERY_PATH}/pdq.jar und ${PUREQUERY_PATH}/pdqmgmt.jar werden dem Klassenpfad als optionale Unterstützung hinzugefügt und sind nur dann erforderlich, wenn der JDBC-Provider von "pureQuery"-Anwendungen verwendet wird. Wenn Sie diesen JDBC-Provider mit "pureQuery"-Anwendungen verwenden, geben Sie für die Variable PUREQUERY_PATH das Verzeichnis an, in dem die JAR-Dateien für IBM Optim pureQuery Runtime gespeichert sind. - Verwendet den folgenden Pfad der nativen Bibliothek:
Wenn "driverType" auf 2 gesetzt wird, sollte für die Variable DB2_JCC_DRIVER_NATIVEPATH das Verzeichnis in Ihrer DB2-Clientinstallation angegeben werden, das die Bibliotheken für den nativen Treiber enthält. Wenn "driverType" auf 4 gesetzt wird, wird der native Pfad nicht verwendet.${DB2_JCC_DRIVER_NATIVEPATH}
- setzt die folgende DataStoreHelper-Klasse voraus:
com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper
- Setzt einen gültigen Authentifizierungsalias voraus.
- Setzt die folgenden Eigenschaften voraus:
- databaseName - Der Name einer tatsächlichen Datenbank, wenn für driverType der Wert 4 angegeben wird, oder der Name einer lokal katalogisierten Datenbank, wenn für driverType der Wert 2 angegeben wird.
- driverType - Der JDBC-Konnektivitätstyp einer Datenquelle. Es gibt zwei zulässige Werte: 2 und 4. Wenn Sie den Treiber des Typs 2 verwenden, setzen Sie diesen Wert auf 2. Möchten Sie Typ 4 verwenden, setzen Sie diesen Wert auf 4.
- serverName - Die TCP/IP-Adresse oder der Hostname des DRDA-Servers (Distributed Relational Database Architecture). Geben Sie nur dann einen Wert für diese Eigenschaft an, wenn driverType auf 4 gesetzt ist. Ist driverType auf 2 gesetzt, ist diese Eigenschaft nicht erforderlich.
- portNumber - Die Nummer des TCP/IP-Ports für den DRDA-Server. Geben Sie nur dann einen Wert für diese Eigenschaft an, wenn driverType auf 4 gesetzt ist. Ist driverType auf 2 gesetzt, ist diese Eigenschaft nicht erforderlich.
- useTransactionRedirect - Konfigurieren Sie diese Eigenschaft als
angepasste Eigenschaft der Datenquelle, wenn Ihr Back-End
Database Partitioning
Feature (DPF) verwendet und wenn Ihr Partitionierungsschlüssel während einer Transaktion konstant bleibt.
Durch Aktivieren der Eigenschaft legen Sie fest, wie
IBM Data Server Driver for JDBC and SQLJ jede Verbindungsanforderung, die eine Transaktion mit DB2 einleitet, überträgt.
Der JDBC-Treiber wird aktiviert, um diese Verbindungsanforderungen an den DPF-Knoten zu senden, der die Zieldaten
der ersten weiterleitbaren Anweisung in der Transaktion enthält, sofern eine solche Anweisung vorhanden ist.
Anschließend überträgt
DB2 diese SQL-Anweisungen nach Bedarf
an verschiedene Partitionen. Vom Standpunkt des Anwendungsservers aus wird die Transaktion normal fortgesetzt.
Sie können die Eigenschaft useTransactionRedirect sowohl für Datenquellen mit driverType 2 als auch für Datenquellen mit driverType 4 verwenden. Verwenden Sie zum Konfigurieren der Eigenschaft entweder das Scripting-Tool "wsadmin" oder die entsprechende Seite in der Administrationskonsole mit den angepassten Einstellungen für den Java-EE-Ressourcenprovider oder die Verbindungsfactory. Ordnen Sie der Eigenschaft den Wert true zu.
- DB2 Universal JDBC Driver Provider Der DB2 Universal JDBC Driver ist ein architekturneutraler JDBC-Treiber für verteilten und lokalen DB2-Zugriff. Da die DB2 Universal Driver-Architektur nicht von einer bestimmten JDBC-Treiberkonnektivität oder Zielplattform abhängig ist, lässt sie sowohl Java-Konnektivität (Typ 4) und JNI-basierte Konnektivität (Java Native Interface) (Typ 2) in einer Treiberinstanz für DB2 zu. Der DB2 Universal JDBC Driver Provider unterstützt einerseits den Zugriff auf DB2-Datenbanken über JDBC und Structured Query Language in Java (SQLJ) und andererseits auch die Verwendung von SQLJ mit CMP.
Fehler vermeiden: Zur Verwendung dieses Providers muss der DB2 Universal JDBC Driver for DB2 für den Anwendungsserver für z/OS installiert und konfiguriert sein. Lesen Sie hierzu den Artikel "DB2 Universal JDBC Driver für den Zugriff auf DB2 for z/OS verwenden".gotcha
Für diesen Provider gilt Folgendes:- Unterstützt die folgende Datenquelle:
Diese Datenquelle kann zweiphasige Transaktionen unterstützen (nur für den Anwendungsserver auf der z/OS-Plattform). Falls Sie den DB2 Universal JDBC Driver mit der Konnektivität des Typs 2 definieren, verwendet der Anwendungsserver unter z/OS RRS für die Verarbeitung der Transaktionen, einschließlich der Transaktionen für zweiphasige Festschreibung. Bei Verwendung mit der Treiberkonnektivität des Typs 4 unterstützt diese Datenquellenimplementierung nur einphasige Transaktionen.com.ibm.db2.jcc.DB2ConnectionPoolDataSource
- Setzt die folgenden JDBC-Treiberdateien voraus:
- db2jcc.jar - Die JAR-Datei von DB2 Universal JDBC Driver im DB2-Installationsverzeichnis. Geben Sie den vollständig qualifizierten Pfad dieser JAR-Datei als Wert der Variablen DB2UNIVERSAL_JDBC_DRIVER_PATH an.
- db2jcc_license_cisuz.jar - Die Lizenzdatei von DB2 Universal JDBC Driver, die mit
DB2 geliefert wird.
Das Installationsprogramm von DB2 kopiert die Lizenzdatei in dasselbe DB2-Verzeichnis wie die Datei
"db2jcc.jar". Deshalb verweist Ihre Variable DB2UNIVERSAL_JDBC_DRIVER_PATH letztendlich auf beide Dateien.
Anmerkung: Die Treiberdatei "db2jcc_license_cu.jar" wird mit dem Anwendungsserver im Verzeichnis "Stammverzeichnis_des_Anwendungsservers/universalDriver/lib" bereitgestellt. Sie wird automatisch auf UNIVERSAL_JDBC_DRIVER_PATH gesetzt. Obwohl diese Treiberdatei keinen Zugriff auf DB2 for z/OS ermöglicht, können Sie sie als Teil der Variablendefinition beibehalten.
- Die nativen Dateien des Typs ".so" werden von DB2 Universal JDBC Driver im Anwendungsserver für z/OS benötigt. Geben Sie für die Variable DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH für den Bibliothekspfad das Verzeichnis an, in dem die nativen Dateien enthalten sind. Wenn keine nativen Dateien erforderlich sind, setzen Sie DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH auf null.
- Verwendet den folgenden Klassenpfad:
${DB2UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc.jar ${UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_license_cu.jar ${DB2UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_license_cisuz.jar ${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}
Fehler vermeiden: Wenn Sie den Verzeichnispfad für ${DB2_JCC_DRIVER_PATH}, ${UNIVERSAL_JDBC_DRIVER_PATH} und ${DB2_JCC_DRIVER_PATH} angeben, dürfen Sie keinen Pfad mit Sonderzeichen gemäß Abschnitt 2.4.3 des Dokuments RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax verwenden. gotcha
- setzt die folgende DataStoreHelper-Klasse voraus:
com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper
- Setzt einen gültigen Authentifizierungsalias voraus, wenn die Eigenschaft "driverType" auf 4 gesetzt ist. Wenn die Eigenschaft "driverType" den Wert 2 hat, müssen Sie einen
komponentengesteuerten Authentifizierungsalias angeben, um die Datenquelle
mit "res-auth APPLICATION" zu verwenden.
Wenn die Eigenschaft "driverType=2" definiert ist und die Datenquelle mit "res-auth CONTAINER" verwendet wird, können Sie einen containergesteuerten Authentifizierungsalias verwenden. Dies ist jedoch nicht erforderlich. Sollten Sie keinen containergesteuerten Alias angeben, ist die Benutzer-ID, die einer von der Datenquelle erstellten Verbindung zugeordnet wird, die Benutzer-ID, die dem aktuellen Thread zum Zeitpunkt der Verbindungsanforderung zugeordnet ist.
- Setzt die folgenden Eigenschaften voraus:
- databaseName - Der Name einer tatsächlichen Datenbank, wenn für driverType der Wert 4 angegeben ist, oder der Name einer lokal katalogisierten Datenbank, wenn für driverType der Wert 2 angegeben ist.
- driverType - Der JDBC-Konnektivitätstyp einer Datenquelle. Es gibt zwei zulässige Werte: 2 und 4. Wenn Sie Typ 2 von Universal JDBC Driver verwenden möchten, setzen Sie diesen Wert auf 2. Möchten Sie Typ 4 von Universal JDBC Driver verwenden, setzen Sie diesen Wert auf 4.
- serverName - Die TCP/IP-Adresse oder der Hostname des DRDA-Servers (Distributed Relational Database Architecture). Geben Sie einen Wert für diese Eigenschaft nur an, wenn driverType auf 4 gesetzt ist. Ist driverType auf 2 gesetzt, wird die Eigenschaft nicht verwendet.
- portNumber - Die Nummer des TCP/IP-Ports für den
DRDA-Server.
Geben Sie einen Wert für diese Eigenschaft nur an, wenn driverType auf 4 gesetzt ist.
Ist driverType auf 2 gesetzt, wird die Eigenschaft nicht verwendet. Anmerkung: DB2 unterstützt zusätzliche Verbindungseigenschaften für den DB2 Universal JDBC Driver. Legen Sie diese Eigenschaften als angepasste Eigenschaften für die Datenquelle fest. Informationen zu diesen optionalen Datenquelleneigenschaften finden Sie in der Veröffentlichung Application Programming Guide and Reference for Java für Ihre Version von DB2 for z/OS.
- Unterstützt die folgende Datenquelle:
- DB2 Universal JDBC Provider (XA) XA DB2 Universal JDBC Provider verwendet den DB2 Universal JDBC Driver für den Zugriff auf DB2-Datenbanken. Universal JDBC Driver unterstützt die Konnektivität auf Java-Kommunikationsbasis (Treiber des Typs 4). Für XA-Transaktionen wird die Konnektivität des Treibertyps 2 durch DB2 Universal JDBC Driver im Anwendungsserver für z/OS nicht unterstützt.
Fehler vermeiden: Zur Verwendung dieses Providers muss DB2 Universal JDBC Driver for DB2 für den Application Server for z/OS installiert und konfiguriert sein, oder das Feature z/OS Application Connectivity to DB2 for z/OS muss für den Application Server for z/OS installiert und konfiguriert sein. Lesen Sie hierzu den Artikel "DB2 Universal JDBC Driver für den Zugriff auf DB2 for z/OS verwenden".gotcha
Für diesen Provider gilt Folgendes:- Ermöglicht Anwendungen den Zugriff über JDBC und Structured Query Language in Java (SQLJ) auf DB2-Datenbanken. Die Verwendung von SQLJ für CMP wird auch unterstützt.
- Unterstützt nicht die Erstellung von Datenquellen der Version 4.0.
- Unterstützt die folgende zweiphasige Datenquelle:
com.ibm.db2.jcc.DB2XADataSource
- setzt die folgenden JDBC-Treiberdateien voraus:
- db2jcc.jar - Die JAR-Datei von DB2 Universal JDBC Driver im DB2-Installationsverzeichnis. Geben Sie den vollständig qualifizierten Pfad dieser JAR-Datei als Wert für die WebSphere-Variable DB2UNIVERSAL_JDBC_DRIVER_PATH an. Der Anwendungsserver verwendet diesen Wert zur Definition des JDBC-Providers.
- db2jcc_license_cisuz.jar - Die Lizenzdatei von DB2 Universal JDBC Driver, die mit
DB2 geliefert wird.
Das Installationsprogramm von DB2 kopiert die Lizenzdatei in dasselbe DB2-Verzeichnis wie die Datei
"db2jcc.jar". Deshalb verweist Ihre Variable DB2UNIVERSAL_JDBC_DRIVER_PATH letztendlich auf beide Dateien.
Anmerkung: Die Treiberdatei "db2jcc_license_cu.jar" wird mit dem Anwendungsserver im Verzeichnis "Stammverzeichnis_des_Anwendungsservers/universalDriver/lib" bereitgestellt. Für die Variable UNIVERSAL_JDBC_DRIVER_PATH ist standardmäßig diese Verzeichnisposition angegeben. Obwohl diese Treiberdatei keinen Zugriff auf DB2 for z/OS ermöglicht, können Sie sie als Teil der Variablendefinition beibehalten.
- Die nativen Dateien des Typs ".so" werden von DB2 Universal JDBC Driver im Anwendungsserver
für z/OS nicht benötigt, wenn Ihr Server nur Treiber des Typs 4 verwendet.
In diesem Fall können Sie den Wert für DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH auf null setzen.
Bewährtes Verfahren: Wenn Sie Server haben, die Treiber des Typs 2 und des Typs 4 ausführen oder voraussichtlich ausführen werden, können Sie als Wert einen gültigen Dateipfad für die nativen Dateien angeben. Die Variable wird für die Treiber des Typs 2 verwendet, doch der Wert für DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH sollte in Fällen, in denen die nativen Dateien nicht erforderlich sind, keine negativen Auswirkungen haben. bprac
- Verwendet den folgenden Klassenpfad:
${DB2UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc.jar ${UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_license_cu.jar ${DB2UNIVERSAL_JDBC_DRIVER_PATH}/db2jcc_license_cisuz.jar ${DB2UNIVERSAL_JDBC_DRIVER_NATIVEPATH}
Fehler vermeiden: Wenn Sie den Verzeichnispfad für ${DB2_JCC_DRIVER_PATH}, ${UNIVERSAL_JDBC_DRIVER_PATH} und ${DB2_JCC_DRIVER_PATH} angeben, dürfen Sie keinen Pfad mit Sonderzeichen gemäß Abschnitt 2.4.3 des Dokuments RFC 2396: Uniform Resource Identifiers (URI): Generic Syntax verwenden. gotcha
- setzt die folgende DataStoreHelper-Klasse voraus:
com.ibm.websphere.rsadapter.DB2UniversalDataStoreHelper
- Setzt einen gültigen Authentifizierungsalias voraus.
- Setzt die folgenden Eigenschaften voraus:
- databaseName - Der Name einer lokal katalogisierten Datenbank.
- driverType - Der JDBC-Konnektivitätstyp einer Datenquelle. Wenn Sie mit einer älteren DB2-Version als DB2 Version 8.1 Fixpack 6 arbeiten, können Sie nur den Treibertyp 2 verwenden.
- serverName - Die TCP/IP-Adresse oder der Hostname des DRDA-Servers (Distributed Relational Database Architecture). Geben Sie einen Wert für diese Eigenschaft nur an, wenn driverType auf 4 gesetzt ist. Ist driverType auf 2 gesetzt, wird die Eigenschaft nicht verwendet.
- portNumber - Die Nummer des TCP/IP-Ports für den
DRDA-Server.
Geben Sie einen Wert für diese Eigenschaft nur an, wenn driverType auf 4 gesetzt ist.
Ist driverType auf 2 gesetzt, wird die Eigenschaft nicht verwendet. Anmerkung: DB2 unterstützt zusätzliche Verbindungseigenschaften für den DB2 Universal JDBC Driver. Legen Sie diese Eigenschaften als angepasste Eigenschaften für die Datenquelle fest. Informationen zu diesen optionalen Datenquelleneigenschaften finden Sie in der Veröffentlichung Application Programming Guide and Reference for Java für Ihre Version von DB2 for z/OS.