Ein JDBC-Provider-Service kann mit dem Befehl
mqsicreateconfigurableservice oder dem Befehl
mqsichangeproperties konfiguriert werden.
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.
- 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.
- 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.
- 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.
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.)
- 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.
- 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.
- 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.