Release-Informationen für Version 2.7.0 von IBM WebSphere Business Integration Adapter für WebSphere MQ

Diese Anmerkungen zum Release betreffen die Release-Informationen für Version 2.7.0 von IBM(R) WebSphere(R) Business Integration Adapter für WebSphere MQ. Diese Release-Informationen bestehen aus folgenden Abschnitten:
Neues in dieser Release WebSphere Business Integration Adapters-API und -Laufzeit
Frühere Produktkorrekturen Bekannte Probleme und Fehlerumgehungen
Hardware- und Softwarevoraussetzungen Aktualisierungen der Dokumentation
Installation, Migration, Upgrade und Konfiguration

Hinweis: Wichtige Informationen zu diesem Produkt können in den Kurzmeldungen der technischen Unterstützung zur Verfügung gestellt werden, nachdem diese Release-Informationen veröffentlicht worden sind. Auf diese können Sie auf der Website der Unterstützung für WebSphere Business Integration unter http://www.ibm.com/websphere/integration/wbiserver/support zugreifen. Klicken Sie auf das gewünschte Produkt; wenn Kurzmeldungen verfügbar sind, befinden sie sich in Self help > Solve a problem > Flashes (Alerts).

Neues in dieser Release

Diese Release umfasst bidirektionale (Bi-di) Unterstützung für unterschiedliche Metadaten.

Detaillierte Informationen zum Adapter und den neuen Funktionen finden Sie im Adapter for WebSphere MQ User Guide.

Frühere Produktkorrekturen

Von Release 2.6.0 bis Release 2.7.0 wurden die folgenden Probleme auf der Grundlage der von den Kunden gemeldeten Fälle behoben.
Protokoll-
nummer
Beschreibung
36128 Der Adapter wird nicht initialisiert, wenn die Connectoreigenschaft 'InputQueue' nicht konfiguriert ist. Dies wurde in Fixpack 2.5.2 korrigiert.
36438 Ab Release 2.5.x des Adapters muss die Groß- und Kleinschreibung in den Namen der Konversionseigenschaften in statischen und dynamischen Metaobjekten beachtet werden.
33728  Wenn im Konfigurationsmetaobjekt nicht eindeutige Konvertierungseigenschaften konfiguriert sind, ordnet der Adapter die Ereignisse den Geschäftsobjekten falsch zu.
37094 Wenn für den Adapter mehrere Eingabewarteschlangen konfiguriert sind, schlägt der Abrufmechanismus der Konvertierungseigenschaft während der Verarbeitung von Statusnachrichten fehl.
34969 Während der synchronen Ereignisverarbeitung sendet der Adapter keine Data Handler-Fehler an die Berichtsnachricht.

Hardware- und Softwarevoraussetzungen

Hardware- und Softwarevoraussetzungen sind in der Produktdokumentation enthalten. Die Links zu diesen Handbüchern finden Sie im Abschnitt Installation, Migration, Upgrade und Konfiguration.

Installation, Migration, Upgrade und Konfiguration

Wenn Sie die Software von der CD installieren oder von Passport Advantage herunterladen und aus einem lokalen Verzeichnis installieren, finden Sie die Informationen hierfür im entsprechenden Handbuch für Ihren Integrationsbroker:

In diesen Handbüchern sind auch allgemeine Informationen zu Migration, Upgrade und Konfiguration enthalten.

Die Informationen zu den Hardware- und Softwarevoraussetzungen und die Konfigurationsdaten für diesen Adapter finden Sie im Adapter for WebSphere MQ User Guide.

Upgrade-Anmerkungen

WebSphere Business Integration Adapters-API und -Laufzeit

Stellen Sie sicher, dass Sie diese Version des Adapters mit der Laufzeitversion 1.8.0 oder einer späteren Laufzeitversion von WebSphere Business Integration Adapters ausführen.

Die .jar-Dateien der WebSphere Business Integration Adapters-API und die zugeordneten Scripts(CWConnEnv.bat und CWODAEnv.bat für Windows(R); CWConnEnv.sh und CWODAEnv.sh für UNIX-Plattformen) werden über die WebSphere Business Integration Adapters-API installiert. Stellen Sie vor der Installation des Adapters sicher, dass die Laufzeitversion von WebSphere Business Integration Adapters installiert ist. Wenn eine ältere Version als 1.8.0 verwendet wird, müssen Sie die neueste API herunterladen. In diesem Abschnitt finden Sie die Anweisungen zur Überprüfung der API-Version, zum Herunterladen der neuesten Version und zum Aktivieren des Adapters zur Ausführung unter verschiedenen Versionen von InterChange Server und Adapter Development Kit (ADK).

Überprüfen der Laufzeitversion

Zur Überprüfung der Laufzeitversion suchen Sie die Manifestdatei (ProductDir\lib\WBIA.jar) und öffnen sie in einem geeigneten Java JAR-Editor. Suchen Sie die folgenden Zeilen:

Implementation-Title: "CWConnectorAPI"
Implementation-Version: 1.8.0

In der Zeile 'Implementation-version' ist die installierte Version der API angegeben. Wenn eine ältere Version als 1.8.0 verwendet wird, müssen Sie die neueste Laufzeitversion herunterladen.

Herunterladen der Laufzeitversion

Gehen Sie wie folgt vor, um die neueste Laufzeitversion herunterzuladen:

  1. Rufen Sie http://www.ibm.com auf.
  2. Klicken Sie auf die Registerkarte Support & download.
  3. Klicken Sie unter der Überschrift Downloads auf Downloads & Treiber.
  4. Geben Sie im Feld für den Suchbegriff "wbia api" ein, und klicken Sie auf Senden.

Wenn Sie die Laufzeitversion heruntergeladen und installiert haben, müssten die folgenden Dateien angezeigt werden:

lib\WBIA.jar
bin\CWConnEnv.bat (Windows)
bin/CWConnEnv.sh (UNIX)
bin\CWODAEnv.bat (Windows)
bin/CWODAEnv.sh (UNIX)
connectors\messages\CwConnectorAgentMessages.txt

Aktivierung von Adaptern für frühere Versionen von Adapter Development Kit und InterChange Server

Dieser Adapter kann nur unter der aktuellen Version 2.6.0 von Adapter Framework ausgeführt werden.

Bekannte Probleme und Fehlerumgehungen

In dieser Release wurden folgende Probleme festgestellt:

Kontroll-
nummer
Beschreibung
58988 Der Adapter ist blockiert, wenn er in ein Linux(TM)-Multiprozessorsystem implementiert wird. Für dieses Problem ist ein bekannter Fehler in Linux JDK 1.4.2 verantwortlich, der eine Blockierung während der Garbage-Collection verursacht. (Die PMR-Nummer für dieses JDK-Problem lautet 27182.001.866.)

Ändern Sie zur Umgehung dieses Fehlers im Startscript des Adapters die Einstellung für die Variable 'JVMArgs' mit der Option "-Xgcthreads1" wie im folgenden Beispiel beschrieben:
JVMArgs="-Xgcthreads1 %JVMArgs%"
34668 WebSphere MQ Version 5.3 mit CSD06 oder früher unterstützt nicht bidirektionale Daten im Feld 'JMSCorrelationID'; wenn Sie die gesamte bidirektionale Funktionalität des Adapters nutzen möchten, benötigen Sie WebSphere MQ Version 5.3 mit CSD07.

Aktualisierungen der Dokumentation

Die Produktdokumentation ist weder als CD noch über den elektronischen Produktvertrieb im Produktpaket enthalten. Die Dokumentation für dieses Produkt finden Sie in den folgenden Information Centern:

Wenn Sie sich die Produktdokumentation beschaffen möchten, besuchen Sie die Website und laden die aktuelle Dokumentation für die Release herunter, die Sie verwenden. Gehen Sie gemäß der Anweisungen auf der Seite des Information Center vor, um die Installation durchzuführen.

Copyright IBM Corp. 1997, 2004