JDBC-Provider für Verbindungen des Typs 4 einrichten

Ein JDBC-Provider-Service kann mit dem Befehl mqsicreateconfigurableservice oder dem Befehl mqsichangeproperties konfiguriert werden.

Vorbereitungen:
Wenn Sie einen DatabaseRetrieve-, DatabaseRoute-, JavaCompute- oder benutzerdefinierten Java-Knoten in einen Nachrichtenfluss einschließen und in diesem Knoten eine Interaktion mit einer Datenbank stattfindet, muss der Broker Verbindungen zu der Datenbank herstellen, damit der Knoten seine Operationen durchführen kann. Sie müssen einen konfigurierbaren JDBCProvider-Service definieren, um den Broker mit den Informationen zu versorgen, die er zum Herstellen der Verbindung benötigt.

Ein konfigurierbarer JDBCProvider-Service unterstützt nur Verbindungen zu einer einzigen Datenbank, d. h., Sie müssen einen Service für jede Datenbank erstellen, zu der Ihre Java-Anwendungen Verbindungen herstellen.

  1. Identifizieren Sie den Typ der Datenbank, für die ein JDBC-Provider benötigt wird. Folgende Datenbanken werden für JDBC-Verbindungen unterstützt:
    • DB2
    • Informix
    • Oracle
    • SQL Server
    • Sybase

    Eine Liste der unterstützten JDBC-Treiber finden Sie im Abschnitt Unterstützte Datenbanken. JDBC-Verbindungen des Typs 4 zu einer SQL Server-Datenbank können nicht an global koordinierten Transaktionen (XA-Transaktionen) teilnehmen.

  2. Führen Sie den Befehl mqsireportproperties aus, um die Liste der verfügbaren JDBC-Provider anzuzeigen. Ersetzen Sie Brokername durch den Namen Ihres Brokers.
    mqsireportproperties Brokername -c JDBCProviders -a -o AllReportableEntityNames

    Dieser Befehl zeigt eine Liste aller konfigurierbaren JDBC-Provider-Services an, die definiert sind. Falls Sie noch keine neuen Definitionen erstellt haben, enthält die Liste die folgenden standardmäßig bereitgestellten Provider:

    • DB2
    • Informix
    • Informix_With_Date_Format
    • Microsoft_SQL_Server
    • Oracle
    • Sybase_JConnect6_05

    Hinweise für Verbindungen zu einer Informix-Datenbank:

    • Verwenden Sie Informix_With_Date_Format, um Kompatibilität mit Clientanwendungen zu gewährleisten, die von dem Datumsformatverbindungsattribut abhängig sind, das von früheren Versionen von Informix-Servern verwendet wurde.
    • Verwenden Sie Informix für Clientanwendungen, die nicht vom Datumsformatattribut abhängig sind.
  3. Zeigen Sie den Inhalt der relevanten Definition an. Führen Sie beispielsweise folgenden Befehl aus, um die mitgelieferte Oracle-Definition anzuzeigen:
    mqsireportproperties Brokername -c JDBCProviders -o Oracle -a

    Der Befehl gibt eine Liste aller Eigenschaften für die Oracle-Definition zurück. Sofern Sie diese Definition nicht geändert haben, sind die Eigenschaften auf ihre Anfangswerte gesetzt. Einige davon müssen Sie ändern, um eine funktionsfähige Definition zu erstellen. Beispielsweise ist die Eigenschaft databaseName auf Standarddatenbankname gesetzt. Sie müssen diesen Namen durch den Namen der spezifischen Datenbank ersetzen, zu der eine Verbindung hergestellt werden soll.

    Ein JDBCProvider hat folgende Eigenschaften:

    • databaseType. Der Datenbanktyp, z. B. DB2.
    • databaseVersion. Die Datenbankversion; z. B. 8.1.
    • type4DriverClassName; Der Name der JDBC-Treiberklasse, die zur Erstellung einer Verbindung verwendet wird; z. B. 'com.ibm.db2.jcc.DB2Driver'.
    • connectionUrlFormat. Ein Muster, das die URL-Definition einer Verbindung darstellt, z. B. jdbc:db2://[Servername]:[Portnummer]/[Datenbankname]:user=[Benutzer];password=[Kennwort];
    • connectionUrlFormat Attr1-5. Wenn das angegebene URL-Format vom Standard abweichende Eigenschaften für die JDBC-Datenquelle wie z. B. eine Serverkennung enthält, geben Sie diese Eigenschaften zusätzlich zu den Standardattributen an, indem Sie eines der fünf allgemeinen Attribute für Verbindungs-URLs verwenden.

      Beispiel: Bei connectionURLFormat = jdbc:oracle:thin:[Benutzer]/[Kennwort]@[Servername]:[Portnummer]:[connectionUrlFormatAttr1], und connectionUrlFormatAttr1 = Oracle-SID ist die Server-ID nicht Bestandteil der Standardgruppe der Eigenschaften für die JDBC-Datenquelle in der Registry. Deshalb wird für das Oracle-spezifische URL-Verbindungsmuster das allgemeine URL-Verbindungsattribut 'connectionUrlFormatAttr1' zur Darstellung dieser vom Standard abweichenden Eigenschaft in der URL-Definition verwendet. Dieses Attribut wird durch den ihm zugeordneten Wert, Oracle-SID, ersetzt. Hierbei handelt es sich um eine benutzerdefinierte SID.

    • databaseName. Der Name der Datenbank, zu der der Datenquelleneintrag Verbindungen ermöglicht; z. B. 'employees'.
    • description. Eine optionale Eigenschaft zur Beschreibung der Datenquellendefinition.
    • jarsURL. Der lokale Verzeichnispfad auf dem System, auf dem der Broker aktiv ist, mit der JAR-Datei, in der die Treiberklasse des Typs 4 enthalten ist.
    • portNumber. Die Portnummer, an der der Datenbankserver empfangsbereit ist; z. B. 50000.
    • serverName. Der Name des Servers; z. B. 'host1'.
    • securityIdentity. Ein eindeutiger Sicherheitsschlüssel zur Durchführung einer zweiten Suche im Brokerregister, um einen Eintrag unter den DSN-Einträgen des Brokers zu finden, die das verschlüsselte Kennwort für den Benutzer auf dem zugehörigen Hostsystem speichern; z. B. jdbc::mysecurityIdentity. Erstellen Sie einen neuen DSN-Eintrag mit dem Befehl mqsisetdbparms (siehe Beschreibung unter JDBC-Verbindung des Typs 4 sichern).

      Der DSN-Eintrag stellt ein ID/Kennwort-Wert-Paar für einen bestimmten JDBC-Providereintrag für den Zugriff auf die angegebene Datenquelle bereit. Diese Eigenschaft wird ignoriert, wenn die Verbindungs-URL nicht ein Benutzer-ID/Kennwort-Paar enthält, das die Ersetzung der Eigenschaftswerte verlangt. Wenn für 'securityIdentify' keine Angabe gemacht oder der Standardwert verwendet wird (default_User@default_Server), diese Eigenschaft jedoch für das Muster der Verbindungs-URL erforderlich ist, oder wenn ein gültiger eindeutiger Sicherheitsidentitätsschlüssel eingegeben wird, der nicht unter dem DSN-Schlüssel zu finden ist, werden die Eigenschaften 'DataSourceUserId' (Datenquellenbenutzer-ID) und 'DataSourcePassword' (Datenquellenkennwort) verwendet, mit denen der Broker erstellt wurde.

      z/OS platform Unter z/OS müssen Sie eine Benutzer-ID und ein Kennwort mit geeigneter Zugriffsberechtigung für die Datenbank angeben. Verwenden Sie dafür nicht die Benutzer-ID für die gestartete Task des Brokers. (Einer Benutzer-ID für die gestartete Task sollte nur nach Berücksichtigung aller möglichen Sicherheitsverzweigungen ein Kennwort zugewiesen werden.)

  4. Wenn die bereitgestellte Definition verwendet werden soll, führen Sie den Befehl mqsichangeproperties aus, um die Standardwerte durch die spezifischen Werte für Ihre Datenbank und Umgebung zu ersetzen. Falls Sie die benötigten Werte nicht kennen, wenden Sie sich an den Datenbankadministrator, oder schauen Sie in der Dokumentation nach, die mit der ausgewählten Datenbank bereitgestellt wird. Einige Werte sind davon abhängig, wie und wo Sie das Datenbankprodukt installiert haben. Beispielsweise gibt die Eigenschaft jarsURL die Position der JAR-Dateien an, die vom Datenbankanbieter geliefert und installiert werden.
  5. Wenn Sie einen neuen konfigurierbaren Service erstellen möchten, weil Sie den gelieferten Service als Schablone für künftige Definitionen aufbewahren wollen, führen Sie den Befehl mqsicreateconfigurableservice aus, um die neue Definition zu erstellen.
    mqsicreateconfigurableservice Brokername -c JDBCProviders -o Providername
    -n Eigenschaftenliste -v Werteliste

    Geben Sie den Befehl in einer einzigen Zeile ein. Das Beispiel wurde lediglich zur besseren Lesbarkeit aufgeteilt.

    Geben Sie alle Eigenschaften an, die vom ausgewählten Datenbankanbieter angefordert werden. Wenn Sie eine Liste aus Eigenschaften und Werten angeben, trennen Sie die Elemente nach jedem Attribut durch ein Komma. Beispiel: -n databaseName,databaseType -v MitarbeiterDB,DB2. Falls Sie in dem Befehl mqsicreateconfigurableservice nicht alle Eigenschaften angeben, können Sie diese später mit dem Befehl mqsichangeproperties aktualisieren.

  6. Nachdem Sie den JDBCProvider-Service eingerichtet haben, müssen Sie den Broker stoppen und erneut starten.
Nächster Schritt: Falls erforderlich, konfigurieren Sie Sicherheit für die JDBC-Verbindung und/oder die Umgebung, um den JDBCProvider-Service in global koordinierte Transaktionen einzuschließen.
Zugehörige Konzepte
Datenbankübersicht
Zugehörige Tasks
JDBC-Verbindung des Typs 4 sichern
JDBC-Verbindung des Typs 4 für global koordinierte Transaktionen konfigurieren
Zugriff auf JDBC Typ 4 JDBCProvider-Ressourcen erteilen
Interaktion mit Datenbanken mit Hilfe des JavaCompute-Knotens
Funktionalität eines Java-Nachrichtenverarbeitungsknotens oder Java-Output-Knotens erweitern
Zugehörige Verweise
Unterstützte Datenbanken
mqsichangeproperties-Befehl
mqsicreateconfigurableservice-Befehl
mqsireportproperties-Befehl
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ah61310_