Wenn die Datenbank, auf die Sie über eine JDBC-Verbindung des
Typs 4 zugreifen, an global koordinierten Transaktionen teilnehmen soll, richten Sie die
entsprechende Umgebung ein.
Informationen zu dieser Task
In verteilten Systemen übernimmt ein mit dem Integrationsknoten verbundener Queue-Manager von „ IBM® MQ “ die Rolle des Transaktionsmanagers, was bedeutet, dass „ IBM App Connect Enterprise “ bei der Verarbeitung von Nachrichten Zugriff auf „ IBM MQ “ benötigt. Weitere Informationen zur Verwendung von „ IBM MQ “ mit „ IBM App Connect Enterprise “ finden Sie unter „Installation von IBM MQ “.
Datenbankaktualisierungen über eine JDBC-Verbindung vom Typ 4 können mit anderen Aktionen innerhalb des Nachrichtenflusses koordiniert werden, wenn Sie die Ressourcen entsprechend für eine solche Koordination konfigurieren.
Führen Sie die folgenden Schritte aus:
Vorgehensweise
- Überprüfen Sie, ob die Definition für Ihre JDBC-Provider-Richtlinie für koordinierte
Transaktionen geeignet ist.
Gehen Sie beispielsweise wie folgt vor, um die erforderlichen JDBC-Klassen einzurichten:
- Für Db2® setzen Sie JDBC
type 4 data source class name auf
com.ibm.db2.jcc.DB2XADataSource und JDBC
driver class name auf com.ibm.db2.jcc.DB2Driver.
- Setzen Sie für Oracle JDBC type 4 data source class name auf
oracle.jdbc.xa.client.OracleXADataSource und JDBC
driver class name auf oracle.jdbc.OracleDriver.
Wenden Sie sich an den Datenbankadministrator oder schlagen Sie in der vom Datenbankanbieter
bereitgestellten Dokumentation nach, um sicherzustellen, dass alle Eigenschaften für die
JDBC-Provider-Richtlinie korrekt festgelegt sind. Es kann beispielsweise sein, dass ein
Datenbankanbieter sicheren Zugriff fordert, wenn die Datenbank an koordinierten Transaktionen
teilnimmt.
- Definieren Sie die Switchdatei und die Datenbankeigenschaften:
- Die Switch-Datei „ JDBC “ wird von IBM App Connect Enterprise bereitgestellt und nutzt die statische Registrierung unter XA (siehe „Konfigurieren von Datenbanken für die globale Transaktionskoordination“ ).
Öffnen Sie auf Linux® -und UNIX -Systemen die Datei qm.ini für den Warteschlangenmanager des Integrationsknotens mit einem Texteditor. Fügen Sie für jede Datenbank folgende
Zeilengruppe hinzu:XAResourceManager:
Name=Database_Name
SwitchFile=JDBCSwitch
XAOpenString=JDBC_DataSource
ThreadOfControl=THREAD
Datenbankname steht für den Datenbanknamen der Datenbank, die in der JDBC-Provider-Richtlinie
definiert ist.
JDBCSwitch ist ein fester generischer Name für die Switchdatei zur XA-Koordination. Verwenden Sie diesen bzw. einen anderen einzelnen festen Wert in jeder Zeilengruppe. Die spezielle vom Warteschlangenmanager verwendete Switchdatei wird durch die im nächsten Schritt erstellten symbolischen Verbindungen definiert.
JDBC_Datenquelle steht für die ID der JDBC-Provider-Richtlinie.
Definieren Sie eine Zeilengruppe für jede Datenbank (DSN), zu der Sie von diesem Integrationsservereine Verbindung herstellen. Separate Definitionen sind selbst dann erforderlich, wenn die DSNs in dieselbe physische Datenbank aufgelöst werden. Deshalb muss für jede JDBC-Provider-Richtlinie, die Sie
definiert haben, eine Zeilengruppe vorhanden sein, da jeder Service die Eigenschaften für eine
einzelne Datenbank definieren kann.
Öffnen Sie unter Windows den „ IBM MQ -Explorer“ und wählen Sie den Queue-Manager aus, zum Beispiel BROKERQM.
Öffnen Sie die Seite XA-Ressourcenmanager und ändern Sie die Attribute,
um die Definition der Datenbank zu erstellen. Die Attribute entsprechen denen, die für „ Linux “ und „UNIX“ angegeben sind: „Name“, „SwitchFile“, „XAOpenString “ und „ ThreadofControl “. Lassen Sie das zusätzliche Attribut
XACloseString leer.
Geben Sie JDBCSwitch in SwitchFile ein.
- Richten Sie Warteschlangenmanagerzugriff auf die Switchdatei ein.
Erstellen Sie auf Linux- und UNIX -Systemen einen symbolischen Link zu den Switchdateien, die im Verzeichnis install_dir/server/lib bereitgestellt werden. install_dir ist das Verzeichnis, in dem Sie „ IBM App Connect Enterprise “ installiert haben. Der Standardspeicherort für dieses Verzeichnis ist install_dir/ace-13.0.n.0/server unter Windows „ Linux “ und /opt/IBM/mqsi/13.0.n.0/server unter UNIX -Systemen „/“. Das Standardverzeichnis enthält Version, Release, Modifikationsstufe und Fix-Level des Produkts im Format v.r.m.f (version.release.modifikation.fix).
Definieren Sie Links im Verzeichnis /var/mqm/exits64. Der Dateiname für alle Plattformen ist
libJDBCSwitch.so.
Geben Sie denselben Namen der Switchdatei (
JDBCSwitch ) oder einen eigenen Wert im Verzeichnis
/exits64 an.
Beispiel für AIX®:ln -s install_dir/server/lib/libJDBCSwitch.so /var/mqm/exits64/JDBCSwitch
Kopieren Sie unter Windows die JDBCSwitch32.dll Datei aus dem install_dir\server\bin Verzeichnis in das \exits Unterverzeichnis im Installationsverzeichnis von „ IBM MQ “ und benennen Sie die Datei um in JDBCSwitch.dll. Kopieren Sie anschließend die JDBCSwitch.dll Datei aus dem install_dir\server\bin Verzeichnis in das \exits64 Unterverzeichnis im Installationsverzeichnis von „ IBM MQ “.
- Konfigurieren Sie den Nachrichtenfluss, der einen oder mehrere Knoten enthält, die auf
Datenbanken zugreifen, die an einer global koordinierten Transaktion teilnehmen.
- Öffnen Sie eine Sitzung des „ IBM App Connect Enterprise “-Toolkits.
- Wechseln Sie zur -Perspektive 'Integrationsentwicklung'.
- Fügen Sie den Nachrichtenfluss hinzu, der den oder die Knoten enthält, die eine Verbindung zu der Datenbank herstellen, die an einer global koordinierten Transaktion zu einer neuen oder bestehenden Brokerarchivdatei teilnehmen soll.
- Erstellen Sie die Brokerarchivdatei.
- Klicken Sie auf die Registerkarte Konfigurieren , wählen Sie den hinzugefügten Nachrichtenfluss aus und wählen Sie das Kontrollkästchen Koordinierte Transaktion aus.
Nächste Schritte
Wenn Ihr Integrationsknoten unter Windowsausgeführt wird, berechtigen Sie den Warteschlangenmanager für den Zugriff auf Ressourcen, die der JDBC -Providerrichtlinie zugeordnet sind (siehe Zugriff auf JDBC-Ressourcen des Typs 4 von JDBC unter Windows erteilen).Wenn Sie die Anweisungen unter Mit Datenbanken arbeitenausgeführt haben, ist die nächste Task ODBC -Verbindungen für global koordinierte Transaktionen konfigurieren (optional).