Readme-Dokumentation für IBM WebSphere Message Broker for Version 8.0.0.1 der Tools und Laufzeitkomponenten.
Readme-Datei für: IBM WebSphere Message Broker
Produkt-/Komponentenversion: 8.0
Name des Updates: 8.0.0.1
ID der Korrektur:
8.0.0-WS-MB-AIXPPC64-FP0001 - AIX on 64-bit Power PC-Architektur
8.0.0-WS-MB-HPUXIA64-FP0001 - HP-UX on Itanium
8.0.0-WS-MB-SOLARISSPARC64-FP0001 - Solaris on Sun SPARC-Architektur
8.0.0-WS-MB-SOLARISX64-FP0001 - Solaris on Sun x86-64-Architektur
8.0.0-WS-MB-LINUXIA32-FP0001 - Linux on 32-bit Intel-Architektur
8.0.0-WS-MB-LINUXX64-FP0001 - Linux on Intel x86-Architektur
8.0.0-WS-MB-LINUXPPC64-FP0001 - Linux on i/p series-Architektur
8.0.0-WS-MB-LINUXZ64-FP0001 - Linux on z/series-Architektur
8.0.0-WS-MB-WINIA32-FP0001 - Windows on 32-bit Intel-Architektur
8.0.0-WS-MB-WINX64-FP0001 - Windows on 64-bit-Architektur
8.0.0-WS-MB-ZOS-FP0001 - z/OS
Verwenden Sie stets die neueste Version dieser Readme-Datei. Sie finden diese nur auf Englisch unter:
http://www.ibm.com/support/docview.wss?uid=swg27006917
Übersetzte Readme-Dateien sind unter der folgenden Adresse erhältlich:
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/
Informationen zu den erforderlichen Schritten vor der Produktinstallation finden Sie im WebSphere Message Broker V8.0 Information Center unter:
http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp
Überprüfen Sie die WebSphere Message Broker-Systemanforderungen, um sicherzustellen, dass Ihre Installationsplattform für die Produktedition unterstützt wird, die Sie installieren möchten. Die Webseite mit den Systemanforderungen von WebSphere Message Broker ist unter folgender Adresse verfügbar:
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
Für Windows-Systeme sind zwei Versionen von WebSphere Message Broker V8.0 verfügbar:
Die 64-Bit-Variante von WebSphere Message Broker wird nicht auf allen 64-Bit-Versionen des Windows-Betriebssystems unterstützt. Weitere Informationen finden Sie auf der Webseite mit den Systemvoraussetzungen für WebSphere Message Broker.
Service für z/OS anwenden
Wenn Sie einen Service für z/OS anwenden, müssen die Pakete mit den vorläufigen Programmkorrekturen (Program Temporary Fix, PTF) als Binärdateien heruntergeladen und an z/OS übertragen werden:
Unternehmen . . . . . . . . . : PS
Satzformat . . . . . . . . . . : FB
Satzlänge . . . . . . . . . . : 1024
Blockgröße . . . . . . . . . . : 6144
Tracks der ersten Erweiterung . : 500
Sekundäre Tracks . . . . . . . : 50
Mit dem folgenden Beispiel einer Jobsteuersprache (Job Control Language, JCL) können Sie diese Datensätze zuordnen:
/* INSERT A VALID JOBCARD HERE
//*
//ALLOCATE EXEC PGM=IEFBR14
//SYSMOD1 DD DSN=YOUR HIGH LEVEL QUALIFIER (HLQ).PTF
NUMBER.TRS,
// DISP=(NEW,CATLG,DELETE),
// UNIT=SYSDA,
// SPACE=(TRK,(500,50),RLSE),
// DSORG=PS,
// DCB=(RECFM=FB,LRECL=1024,BLKSIZE=6144)
//*
put PTF-NUMMER.TRS 'YOUR HLQ.PTF-
NUMMER.TRS' (replace
Mit der folgenden Beispiel-JCL können Sie die Datensätze entpacken, nachdem die Änderungen durchgeführt wurden, und es kann eine geeignete Jobkarte hinzugefügt werden:
//*****************************************************
//* UNTERSE APAR
//*****************************************************
/UNPACK EXEC PGM=TRSMAIN,PARM='UNPACK'
//STEPLIB DD DISP=SHR,DSN=TERSE.LOADLIB
//SYSPRINT DD SYSOUT=*
//INFILE DD DSN=YOUR HLQ.PTF NUMBER.TRS,
// DISP=SHR
//OUTFILE DD DSN=YOUR HLQ.PTF NUMBER,
// DISP=(NEW,CATLG),
// SPACE=(TRK,(1000,100,))
/*
Bei einer Migration von WebSphere Message Broker Version 6.1 oder Version 7.0 finden Sie entsprechende Informationen in der Onlineversion des Information Center unter http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp.
Das Online-Information Center für WebSphere Message Broker V8.0 finden Sie unter:
http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp
Wenn Sie aktuellste Informationen suchen, sollten Sie im Online-Information Center nachsehen. Die Informationen des Online-Information Center sind aktueller als die Informationen des mit Message Broker Toolkit ausgelieferten Information Center.
Das WebSphere Message Broker Information Center für V8.0.0.0 enthält Informationen zum Aufzeichnen und Anzeigen von Daten, allerdings keine Informationen zur Wiedergabe von Daten.
Die aktuellsten und umfassendsten Informationen zum Aufzeichnen, Anzeigen und Wiedergeben von Daten in V8.0.0.0 werden in einer PDF-Datei bereitgestellt. Diese Datei kann von der Seite mit den folgenden technischen Hinweisen heruntergeladen werden:
www.ibm.com/support/docview.wss?uid=swg21573603
Das WebSphere Message Broker Information Center für V8.0.0.1 enthält aktuelle Informationen zur Webbenutzerschnittstelle. Die folgenden technischen Hinweise enthalten jedoch zusätzliche Informationen, die die Themen im Information Center ergänzen:
Das Standalone Information Center steht unter der folgenden Adresse zum Download zur Verfügung:
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V8.0/wmb_help_linux.tgz (Linux-Version)
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V8.0/wmb_help_win.zip (Windows-Version)
Lesen Sie die Datei using_the_infocenter.html. Sie befindet sich im Ordner 'ibm_help' in den Dateien 'wmb_help_linux.tgz' und 'wmb_help_win.zip'.
Mängel: Diese Readme-Datei kann Verweise auf Fehlernummern enthalten. Diese Nummern beziehen sich auf interne IBM Problemnummern; unter Umständen ist es hilfreich, wenn Sie Ihrem zuständigen IBM Ansprechpartner bei der Erläuterung von Problemen diese Nummern nennen können.
Technische Hinweise (Technotes): Aktuelle Informationen zu bekannten Problemen und verfügbaren Korrekturen finden Sie auf der Support-Website für WebSphere Message Broker unter:
http://www.ibm.com/support/entry/portal/Software/WebSphere/WebSphere_Message_Broker
Klicken Sie dort auf Troubleshoot. Die Seite mit technischen Hinweisen zu WebSphere Message Broker wird geöffnet, die durchsucht und bestellt werden können.
Informationen zum Download der Installationsimages für WebSphere Message Broker Version V8.0 von der Passport Advantage-Website finden Sie im Downloaddokument Download WebSphere Message Broker V8.0 from the Passport Advantage website unter:
http://www.ibm.com/support/docview.wss?uid=swg24030968
Versionen: Die aktuellsten Informationen zu den von WebSphere Message Broker unterstützten Betriebssystemversionen und Datenbankversionen finden Sie auf der Seite mit den Systemvoraussetzungen unter:
http://www.ibm.com/software/integration/wbimessagebroker/requirements/index.html
Sie sollten in regelmäßigen Abständen prüfen, ob Updates für das WebSphere Message Broker Toolkit sowie für die Dokumentation in englisch und in anderen Sprachen vorhanden sind. Empfohlene Programmkorrekturen für WebSphere Message Broker sind unter folgender Adresse zu finden:
http://www.ibm.com/support/docview.wss?uid=swg27006041
Informationen zu den Neuerungen in Version 8.0 finden Sie unter:
http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp?topic=/com.ibm.etools.mft.doc/bb23110_.htm
In diesem Abschnitt werden die bekannten Probleme von WebSphere Message Broker und, sofern möglich, deren Umgehungen, aufgeführt nach den einzelnen Komponenten, beschrieben.
Symptome:
Bei Ausführung des Deinstallationsprogramms uninstaller.exe für WebSphere Message Broker auf einem System mit Windows 7 oder Windows Server 2008 R2 wird unter Umständen ein Dialogfenster angezeigt, in dem Sie darauf hingewiesen werden, dass die Deinstallationsdatei nicht signiert ist.
Lösung:
Diese Warnung kann ignoriert und die Deinstallation fortgesetzt werden.
Symptome:
Wenn Sie ein IBM Produkt mithilfe eines elektronischen Images von IBM Passport Advantage installieren und Windows XP Service Pack 2 oder höher benutzen, können Ihre Windows-Sicherheitseinstellungen möglicherweise dazu führen, dass der Attachment Manager den Inhalt der ZIP-Datei des Installationsprogramms blockiert und Ihre Installation deshalb fehlschlägt.
Lösung:
Dieses Problem können Sie wie folgt umgehen:
Weitere Informationen über den Windows Attachment Manager finden Sie auf der Support-Seite von Microsoft an der Adresse: http://support.microsoft.com/kb/883260
Das Installationsimage für die Laufzeitkomponente von WebSphere Message Broker V8.0 GA hat die für eine CD empfohlene Größe überschritten. Daher wird das Installationsimage für die HP-UX-Plattform auf einer DVD bereitgestellt. Darüber hinaus kann das Installationsimage für die Laufzeitkomponente von WebSphere Message Broker V8.0 GA auch von der Passport Advantage-Website heruntergeladen werden.
Informationen zum Download der Installationsimages für WebSphere Message Broker Version V8.0 von der Passport Advantage-Website finden Sie im Downloaddokument Download WebSphere Message Broker V8.0 from the Passport Advantage website unter:
http://www.ibm.com/support/docview.wss?uid=swg24030968
Symptome:
Für die Ausführung des Laufzeitinstallationsprogramms von WebSphere Message Broker V8.0.0.0 GA muss die Lizenzvereinbarung akzeptiert werden.
Das Fixpackinstallationsprogramm erfordert, dass Sie die Installation entweder auf einem System durchführen, auf dem WebSphere Message Broker V8.0 GA bereits installiert ist, oder dass Sie die ursprünglichen Lizenzdateien von WebSphere Message Broker V8.0 GA bereitstellen. Die Lizenzdateien von WebSphere Message Broker V8.0 GA können entweder aus einer bereits vorhandenen Laufzeitinstallation von V8.0 oder aus den Originalinstallationsmedien von V8.0 stammen. Die Positionsangabe der Lizenzdateien ist nur erforderlich, wenn Sie ein Fixpack von WebSphere Message Broker V8.0 auf einem System installieren, auf dem keine Installation von WebSphere Message Broker V8.0 GA erkannt wurde.
Lösung:
Installationen über die grafische Benutzerschnittstelle oder die Konsole
Im Fall einer Fixpackinstallation über die grafische Benutzerschnittstelle oder die Konsole, bei der V8.0 auf dem System noch nicht installiert ist, werden Sie vom Installationsprogramm zur Angabe des Pfads von vorhandenen Medienlizenzen oder einer bereits vorhandenen Installation von V8.0 aufgefordert.
Wenn V8.0 bereits auf dem System installiert ist, werden Sie normalerweise nicht nach bereits vorhandenen Lizenzen gefragt, und die Installation wird wie üblich fortgesetzt.
Unbeaufsichtigte Installationen
Bei unbeaufsichtigten Installationen (Vollversion der Medien oder Fixpack) müssen Sie die Lizenz immer akzeptieren. Gehen Sie also beispielsweise folgendermaßen vor:
WebSphere Message Broker wird unter Ubuntu unterstützt, allerdings nur für Entwicklungssysteme. Das Produkt sollte nicht auf Produktsystemen unter Ubuntu eingesetzt werden.
Weitere Informationen finden Sie auf der Seite mit den Systemvoraussetzungen für WebSphere Message Broker. Die Webseite mit den Systemanforderungen von WebSphere Message Broker ist unter folgender Adresse verfügbar:
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
Symptome
Der Versuch, für einen Knoten mit mehreren Ausgabeterminals eine Verbindung zu anderen Knoten herzustellen, schlägt fehl.
Lösung
So können Sie dieses Problem umgehen:
Damit WebSphere Message Broker Explorer eine Verbindung zu einem Warteschlangenmanager herstellen kann, um Veröffentlichungen zu empfangen, muss die Eigenschaft SHARECNV für den SVRCONN-Kanal dieses Warteschlangenmanagers auf einen Wert gesetzt werden, der größer als null ist. Dieser Wert ist erforderlich, wenn die Anzeigen 'Brokerstatistikdaten' und 'Brokerstatistikdaten - Diagramm' in WebSphere Message Broker Explorer verwendet werden sollen.
Symptom:
Nach der Migration von WebSphere Message Broker Toolkit und den zugehörigen Ressourcen auf V8.0 werden in WebSphere Message Broker Toolkit möglicherweise Elemente wie beispielsweise Menüoptionen der vorherigen Toolkit-Version angezeigt, die in V8.0 eigentlich nicht mehr enthalten sind.
Lösung:
Dieses Problem können Sie wie folgt beheben:
Symptom:
Nach der Migration von WebSphere Message Broker Toolkit und der zugehörigen Ressourcen auf V8.0.0.0 oder V8.0.0.1 bzw. nach dem Import von WebSphere Message Broker Toolkit und seiner Ressourcen in die Version 8.0.0.0 oder Version 8.0.0.1 werden im Toolkit unter Umständen fälschlicherweise Fehler angezeigt.
Lösung:
Öffnen Sie Ihren Arbeitsbereich aus V8.0.0.0 oder V8.0.0.1 in WebSphere Message Broker Toolkit und wählen Sie Projekt > Bereinigen... > Alle Projekte bereinigen aus. Die fälschlicherweise ausgegebenen Fehlernachrichten werden entfernt.
Symptom:
Beim Import von Ressourcen in einen neuen Arbeitsbereich werden nach der Beendigung der automatischen Erstellung möglicherweise Fehlernachrichten angezeigt.
Lösung:
Wählen Sie in der Ansicht 'Brokerentwicklung' Ihre Projekte aus und klicken Sie mit der rechten Maustaste auf Projekt > Bereinigen, um die Projekte neu zu erstellen. Nach der Bereinigung der Projekte werden die Fehlernachrichten, die sich auf den Import beziehen, entfernt.
mqsicreatebar
ist unter Umständen eine Projektbereinigung erforderlichSymptom:
Bei der Ausführung des Befehls mqsicreatebar
und der Angabe eines neuen Arbeitsbereichs werden möglicherweise Fehlernachrichten angezeigt.
Lösung:
Verwenden Sie die Option -cleanBuild
, wenn Sie den Befehl mqsicreatebar
zur Bereinigung der Projekte verwenden.
Symptom:
Bei Verwendung des in WebSphere Message Broker Toolkit V8.0.0.0 GA enthaltenen Information Center werden DFDL-Themen (Data Format Description Language) nur in amerikanischem Englisch angezeigt.
Diese Themen haben die ID 'dfxxxxx_'; dabei ist 'xxxxx' eine fünfstellige Nummer.
Lösung:
Dieses Problem wurde in WebSphere Message Broker Version 8.0.0.1 behoben.
Im Online-Information Center können die Benutzer von WebSphere Message Broker Version 8.0.0.0 GA diese Themen in anderen Sprachen als in amerikanischem Englisch anzeigen. Das Online-Information Center für WebSphere Message Broker V8.0 enthält die neueste übersetzte Dokumentation und ist verfügbar unter:
http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp
Symptom:
Wenn ein Kunde in seinem Arbeitsbereich über mehrere Anwendungen oder Bibliotheken verfügt, die gleichnamige Java-, PHP- oder Nachrichtengruppenprojekte erfordern, wird eine Fehlernachricht mit ungefähr folgendem Wortlaut angezeigt:
Das Projekt <Projektname> kann nicht mehreren Anwendungen oder Bibliotheken angehören....
Lösung:
Wenn das gleiche Projekt in mehreren Anwendungen oder Bibliotheken benötigt wird, sollte unter einem anderen Namen eine Kopie des Projekts erstellt werden.
Symptom:
Ein Benutzer ohne Administratorberechtigungen kann das Toolkit nicht mithilfe der aktuellen Installationsdokumentation installieren.
Lösung:
Dieses Problem wurde in WebSphere Message Broker Version 8.0.0.1 behoben.
Benutzer von WebSphere Message Broker 8.0.0.0, die das Toolkit als Benutzer ohne Administratorberechtigungen installieren, finden die benötigten Informationen im Online-Information Center unter http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp oder an dieser Stelle:
Die Informationen unter Schritt 5 der Installationsdokumentation von WebSphere Message Broker Toolkit V8.0.0.0 müssen wie folgt aktualisiert werden:
Wenn Ihre Benutzer-ID nicht über die Root- oder Administratorberechtigung verfügt:
Die Installationsdokumentation von WebSphere Message Broker Toolkit V8.0.0.0 muss mit dem Schritt 14 ergänzt werden und enthält nun folgende Informationen:
Wenn Sie WebSphere Message Broker Toolkit ohne Root- oder Administratorberechtigung installiert haben, wechseln Sie zu einem Benutzer mit Root- oder Administratorberechtigung und führen Sie die folgende Scriptdatei im Ausgangsverzeichnis von WebSphere Message Broker Toolkit aus, um die Installation abzuschließen:
Symptom:
Dies ist der Fall, wenn dem untergeordneten Fluss ein externer Empfangsknoten hinzugefügt wird; die resultierende BAR-Datei enthält in diesem Fall zwei kompilierte Nachrichtenflüsse. Einer der Nachrichtenflüsse ist der beabsichtigte Fluss mit dem eingebetteten untergeordneten Fluss, während es sich bei dem anderen Nachrichtenfluss um einen irrelevanten untergeordneten Fluss handelt, der den externen Empfangsknoten ohne entsprechenden externen Sendeknoten enthält.
Bei der Implementierung der BAR-Datei werden beide Nachrichtenflüsse ausgeführt. Der untergeordnete Fluss startet fälschlicherweise einen neuen Thread und versucht, Daten aus dem Empfangsknoten (InputNode) zu lesen.
Lösung:
Führen Sie eine der folgenden Aktionen aus:
Symptom:
Nach Abschluss einer Installation wird dem Benutzer die Option für den Start von WebSphere Message Broker V8.0 Toolkit angezeigt. Wenn das Toolkit geöffnet wird, wird jeder Broker, der mit einem Warteschlangenmanager in WebSphere MQ Version 7.1 oder 7.5 ausgeführt wird, als 'gestoppt' gemeldet, und zwar unabhängig davon, ob der Broker ausgeführt wird oder nicht. Möglicherweise wird ein Dialog mit der Warnung angezeigt, dass keine Verbindung zu den Brokern hergestellt werden kann.
Wenn ein Benutzer versucht, einen der gestoppten Broker zu starten, wird eine Fehlernachricht mit folgendem Text angezeigt:
Der Warteschlangenmanager '<WS-Manager>' ist nicht aktiv (MQ-Ursachencode 2059 beim Versuch, eine Verbindung herzustellen)
Überprüfen Sie, ob folgende Voraussetzungen erfüllt sind:
Lösung:
Beenden Sie das Toolkit und öffnen Sie es erneut unter Verwendung der Toolkit-Installation anstelle von Installation Manager.
Symptom:
Das Linux-Toolkit stürzt nach seinem Start innerhalb ungefähr einer Minute mit folgendem Fehler ab:
JVM beendet - Exit-Code=160
Lösung:
Installieren Sie eine Version von XULRunner, die mit Eclipse 3.6 kompatibel ist.
Die XULRunner-Versionen 1.8 bis 3.6 mit den zugehörigen Fixpacks sind kompatibel.
Bei IBM wurde ein Test mit der folgenden Version durchgeführt, durch die das Problem nachgewiesenermaßen gelöst werden kann:
http://ftp.mozilla.org/pub/mozilla.org/xulrunner/releases/1.9.2.19/runtimes/xulrunner-1.9.2.19.en-US.linux-i686.tar.bz2
Erweitern Sie die heruntergeladene komprimierte Datei in einem geeigneten Verzeichnis (zum Beispiel /usr/lib/xulrunner_new)
Fügen Sie der Datei 'eclipse.ini' unter dem Installationsverzeichnis 'mb' die folgende Zeile hinzu:
-Dorg.eclipse.swt.browser.XULRunnerPath=<Position des dekomprimierten Downloads> (zum Beispiel -Dorg.eclipse.swt.browser.XULRunnerPath=/usr/lib/xulrunner_new)
In WebSphere Message Broker Version 8.0.0.1 unter zOS können WSDL-Dateien derzeit nicht mit der Webbenutzerschnittstelle hochgeladen werden, um in der Struktur eines webbasierten statischen Endpunkts verwendet werden zu können.
Symptome:
Während der iterativen Erkennung des WebSphere Adapters zur Unternehmensmetadatenerkennung (Enterprise Metadata Discovery, EMD) von SAP-Software wird die Ansicht des Adapterverbindungsassistenten Service Generation and Deployment Configuration (Servicegenerierung und Implementierungskonfiguration) angezeigt und kann bearbeitet werden; die von Ihnen eingegebenen Informationen zur Adaptersystemverbindung werden jedoch nicht in der Adapterkomponente gespeichert.
Lösung:
Ändern Sie die Informationen zur Adaptersystemverbindung mit dem Editor des WebSphere Adapters, um sicherzustellen, dass darauffolgende iterative EMD-Erkennungen die Informationen der Adaptersystemverbindung beibehalten:
Symptome:
Der eingehende JDE-Adapter schlägt bei der Implementierung fehl, wenn das Kontrollkästchen assured delivery (Zuverlässige Nachrichtenübermittlung) im Adapterassistenten aktiviert ist. Der folgende Fehler wird ausgegeben:
Der Versuch, die Eigenschaft 'AssuredOnceDelivery' in der Adapterkomponente 'AssuredDeliveryMSApp.IBM WebSphere Adapter for JD Edwards EnterpriseOne' festzulegen, ist gescheitert, da die Eigenschaft nicht unterstützt wird.
Lösung:
Diese Funktion wird momentan nicht unterstützt und sollte in der Nachrichtenflussentwicklung nicht verwendet werden.
Symptome:
Die Verwendung einer grafischen Datenzuordnung zum Zuordnen von Eingabedaten, die aus einer Datenbank abgerufen wurden, hängt von dem konfigurierten Standardschemanamen Ihres Datenbankservers ab. Der Broker bietet derzeit keine Möglichkeit, den Datenbankschemanamen, der in SQL-Anweisungen für die Datenbank verwendet wird, zu überschreiben. Die von der Zuordnung ausgegebene SQL-Anweisung enthält momentan nur den Namen der Datenbank und der Tabellen, aber keinen Schemanamen. Als ID, unter der der Broker bei Ausführung der Zuordnung eine Verbindung herstellt, verwendet der Datenbankserver daher den standardmäßigen Datenbankschemanamen. Die vom Broker verwendete Verbindungs-ID wird in einem konfigurierbaren JDBCProvider-Service konfiguriert. Der konfigurierbare JDBCProvider-Service, der verwendet wird, wird anhand des Datenquellennamens in der Zuordnung ausgewählt.
Ist die erforderliche Datenbanktabelle in diesem Schema nicht verfügbar, fällt die Ausführung der Zuordnung mit einem Brokerfehler fehl, der die Fehlercodes für Ihren Datenbankserver enthält. Beispiel:
BIP3947E: Die Zuordnung für Warteschlangenname '{maps}:RDB_Mapping' konnte nicht verarbeitet werden. Die Einzelangaben lauten wie folgt:
'{Fehlernachricht und Fehlercodes beim Zugriff auf Tabellen in Ihrem Datenbankschema}'
Lösung:
Diese Einschränkung wurde in WebSphere Message Broker Version 8.0.0.1 und höher durch die Bereitstellung einer Funktion behoben, mit der der Name des Datenbankschemas optional überschrieben werden kann. Sie finden weitere Informationen unter Eigenschaft "databaseSchemaNames" des konfigurierbaren JDBCProviders-Service.
Benutzer von WebSphere Message Broker Version 8.0 GA müssen sicherstellen, dass die in der grafischen Datenzuordnung ausgewählte Tabelle im Schema vorhanden ist, das vom Datenbankserver für die im konfigurierbaren JDBCProvider-Service konfigurierte Datenbankverbindungs-ID gesetzt ist. Dies muss vor allem unter z/OS beachtet werden.
Symptome:
Auf UNIX-Systemen, auf denen als Shellumgebung die Z-Shell (zsh) verwendet wird, führt der Aufruf von 'source {install path}/mqsiprofile' zu einer Beendigung der Shell. Aufgrund des Standardverhaltens der Z-Shell wird vom Befehl 'mqsiprofile' eine falsche Argumentnummer überprüft, um festzustellen, ob er extern aufgerufen oder direkt aufgeführt wird. Das Script 'mqsiprofile' gibt daraufhin eine Warnung aus und ruft 'exit' auf, was von der Z-Shell allerdings als Anweisung interpretiert wird, die aktuelle Shell zu beenden.
Lösung:
So können Sie dieses Problem umgehen:
Symptom:
Im Abschnitt an19545_ mqsiapplybaroverride des Information Center heißt es, dass die Parameter '-k' und '-y' für Anwendungen und Bibliotheken verwendet werden können. Die Angabe dieser Parameter im Befehl führt allerdings zu dem folgenden Fehler:
BIP1033E Invalid parameters (Ungültige Parameter)
Lösung:
Diese Parameter werden in diesem Befehl nicht unterstützt und sollten daher nicht angegeben werden.
Für Kunden, die Benutzerdatenbanken unter z/OS, verwenden, ist DB2 APAR PK99362 erforderlich.
Global koordinierte Transaktionen ('XA-Transaktionen') werden nicht unterstützt.
Global koordinierte JDBC/XA-Transaktionen ('XA-Transaktionen') werden auf DB2 und Oracle (mit Ausnahme von Oracle RAC) auf allen Brokerplattformen außer HP-UX auf Itanium und z/OS unterstützt.
ODBC XA und JDBC/XA können nicht gemeinsam auf dem gleichen Broker verwendet werden.
Global koordinierte Informix-Transaktionen ('XA-Transaktionen') werden nicht unterstützt.
Nur DB2 und Microsoft SQL Server werden auf Windows Server 2008 R2 und Windows 7 64-Bit unterstützt. Stellen Sie anhand der Informationen auf den Seiten mit den Systemvoraussetzungen für DB2 und Microsoft SQL Server fest, welche Produktversionen auf Ihrem System unterstützt werden.
Die Webseite mit den Systemvoraussetzungen für DB2 finden Sie unter:
http://www.ibm.com/software/data/db2/linux-unix-windows/sysreqs.html
Wenn ein Broker für die Verwendung von XA mit einem Warteschlangenmanager von WebSphere MQ 7.1 oder WebSphere MQ 7.5 als Transaktionsmanager konfiguriert wird, müssen Benutzer die entsprechende Switchdatei in den Verzeichnissen
<MQ_DATA_PATH>/exits und/oder <MQ_DATA_PATH>/exits64 einfügen. Die Benutzer dürfen für die Switchdateien nicht das installationsspezifische Unterverzeichnis von 'exits' und 'exits64' verwenden.
Symptome:
Der Message Broker kann nicht ordnungsgemäß mit einer Datenbank verbunden werden, wenn versucht wird, eine ODBC-Datenquelle auf Linux- und UNIX-Systemen zu verwenden.
Beispiel für eine Fehlernachricht
BIP2393E: Datenbankfehler: ODBC-Rückkehrcode '-1' aus Datenquelle ''ROUTING'' unter Verwendung des ODBC-Treibermanagers ''/opt/ibm/IE02/2.0.0/lib/libodbcinterface.so''.
BIP2322E: Datenbankfehler: SQL-Status ''IM002''; Nativer Fehlercode '0'; Fehlertext ''[unixODBC][Treibermanager]Datenquellenname nicht gefunden und kein Standardtreiber angegeben''.
BIP8040E: Es kann keine Verbindung zur Datenbank hergestellt werden.
Lösung:
An den angegebenen Hilfetextseiten für die Beispiele müssen folgende Korrekturen vorgenommen werden, damit die ODBC-Verbindung erfolgreich eingerichtet und ausgeführt werden kann.
Folgende Seite:
Die Informationen unter "Von Linux- und UNIX-Systemen mithilfe von WebSphere Message Broker ODBC Database Extender eine Verbindung zu einer Datenbank herstellen" sind nicht korrekt.
Schritt 8 beginnt mit "Wenn Sie eine DB2 ...verwenden, die unter AIX installiert ist" und erweckt den Eindruck, dass dieser Schritt übersprungen werden kann, wenn Sie nicht AIX verwenden. Sie müssen Schritt 8 jedoch bei allen Linux- und UNIX-Plattformen ausführen.
Symptome:
Beim Versuch, das WebSphere Message Broker-Anwendungsbeispiel einzurichten und auszuführen, wird der DatabaseInput-Knoten nicht erfolgreich ausgeführt. Entweder wird beim Laden oder Aktualisieren der Datenbank ein Fehler angezeigt, oder es wird keine Nachricht aus dem Brokerfluss abgerufen, wenn die Datenbank aktualisiert wurde.
Lösung:
An den Hilfetextseiten zu den Beispielen müssen die folgenden Korrekturen vorgenommen werden.
Abschnitt: DB2 einrichten
Schritt 3 muss wie folgt aktualisiert werden:
3. Navigieren Sie zu dem Projekt "DatabaseInput Data Design", das die Datei dbinput_create_tables_db2.sql enthält.
Öffnen Sie diese in einem Texteditor und fügen Sie am Anfang folgende Zeile hinzu
CONNECT TO DBINPUT@
Navigieren Sie in einem DB2-Befehlsfenster zu dem Ordner des Projekts "DatabaseInput Data Design"
db2 -td@ -vf dbinput_create_tables_db2.sql
Abschnitt: So führen Sie den Nachrichtenfluss 'DatabaseInput' aus:
Die Schritte 3, 4 und 7 müssen wie folgt aktualisiert werden:
3. Wählen Sie eine bestehende JDBC-Verbindung für die Datenbank "DBINPUT" aus oder erstellen Sie mithilfe der Anweisungen auf dem Bildschirm eine neue Verbindung. Wenn Sie eine bestehende Verbindung verwenden, müssen Sie auf der Registerkarte "Treibereigenschaften" unbedingt mit der Funktion "Bearbeiten" einen gültigen Benutzernamen und ein gültiges Kennwort für die Verbindung festlegen.
4. Klicken Sie auf Fertigstellen, um der Tabelle eine Zeile hinzuzufügen. Das Ergebnis wird in der Ansicht "SQL-Ergebnis" angezeigt. Diese kann im Eclipse-Menü "Ansicht anzeigen" geöffnet werden.
...
7. Überprüfen Sie, ob die abgerufene Nachricht eine Kundenstruktur enthält. Wenn Sie keine Nachricht erhalten, öffnen Sie den Flusstest "DatabaseInput Retrieve Failure.mbtest", um eine mögliche Nachricht mit einer Fehlererläuterung aus der Warteschlange zu entfernen.
http://www.ibm.com/legal/copytrade.shtml
Die vorliegenden Informationen wurden für Produkte und Services entwickelt, die auf dem deutschen Markt angeboten werden.
Möglicherweise bietet IBM die in dieser Dokumentation beschriebenen Produkte, Services oder Funktionen in anderen Ländern nicht an. Informationen über die gegenwärtig im jeweiligen Land verfügbaren Produkte und Services sind beim IBM Ansprechpartner erhältlich. Hinweise auf IBM Lizenzprogramme oder andere IBM Produkte bedeuten nicht, dass nur Programme, Produkte oder Dienstleistungen von IBM verwendet werden können. Anstelle der IBM Produkte, Programme oder Dienstleistungen können auch andere ihnen äquivalente Produkte, Programme oder Dienstleistungen verwendet werden, solange diese keine gewerblichen oder anderen Schutzrechte der IBM verletzen. Die Verantwortung für den Betrieb von Fremdprodukten, Fremdprogrammen und Fremdservices liegt beim Kunden.
Für in diesem Handbuch beschriebene Erzeugnisse und Verfahren kann es IBM Patente oder Patentanmeldungen geben. Mit der Auslieferung dieser Veröffentlichung ist keine Lizenzierung dieser Patente verbunden. Lizenzanforderungen sind schriftlich an folgende Adresse zu richten (Anfragen an diese Adresse müssen auf Englisch formuliert werden):
Trotz sorgfältiger Bearbeitung können technische Ungenauigkeiten oder Druckfehler in dieser Veröffentlichung nicht ausgeschlossen werden. Die Angaben in diesem Handbuch werden in regelmäßigen Zeitabständen aktualisiert. Die Änderungen werden in Überarbeitungen oder in Technical News Letters (TNLs) bekannt gegeben. IBM kann jederzeit Verbesserungen und/oder Änderungen an den in dieser Veröffentlichung beschriebenen Produkten und/oder Programmen vornehmen.
Verweise in diesen Informationen auf Websites anderer Anbieter werden lediglich als Service für den Kunden bereitgestellt und stellen keinerlei Billigung des Inhalts dieser Websites dar. Das über diese Websites verfügbare Material ist nicht Bestandteil des Materials für dieses IBM Produkt. Die Verwendung dieser Websites geschieht auf eigene Verantwortung.
Werden an IBM Informationen eingesandt, können diese beliebig verwendet werden, ohne dass eine Verpflichtung gegenüber dem Einsender entsteht.
Lizenznehmer des Programms, die Informationen zu diesem Produkt wünschen, mit der Zielsetzung: (i) den Austausch von Informationen zwischen unabhängig erstellten Programmen und anderen Programmen (einschließlich des vorliegenden Programms) sowie (ii) die gemeinsame Nutzung der ausgetauschten Informationen zu ermöglichen, wenden sich an folgende Adresse:
Die Bereitstellung dieser Informationen kann unter Umständen von bestimmten Bedingungen - in einigen Fällen auch von der Zahlung einer Gebühr - abhängig sein.
Die Lieferung des im Dokument aufgeführten Lizenzprogramms sowie des zugehörigen Lizenzmaterials erfolgt auf der Basis der IBM Rahmenvereinbarung bzw. der Allgemeinen Geschäftsbedingungen von IBM, der IBM Internationalen Nutzungsbedingungen für Programmpakete oder einer äquivalenten Vereinbarung.
Alle Informationen zu Produkten anderer Anbieter stammen von den Anbietern der aufgeführten Produkte, deren veröffentlichten Ankündigungen oder anderen allgemein verfügbaren Quellen. IBM hat diese Produkte nicht getestet und kann daher keine Aussagen zu Leistung, Kompatibilität oder anderen Merkmalen machen. Fragen zu Leistungsmerkmalen von Produkten anderer Anbieter sind an den jeweiligen Anbieter zu richten.
Diese Veröffentlichung enthält Beispiele für Daten und Berichte des alltäglichen Geschäftsablaufes. Sie sollen nur die Funktionen des Lizenzprogramms illustrieren; sie können Namen von Personen, Firmen, Marken oder Produkten enthalten. Alle diese Namen sind frei erfunden; Ähnlichkeiten mit tatsächlichen Namen und Adressen sind rein zufällig.
COPYRIGHTLIZENZ:
Diese Veröffentlichung enthält Beispielanwendungsprogramme, die in Quellensprache geschrieben sind. Sie dürfen diese Beispielprogramme kostenlos kopieren, ändern und verteilen, wenn dies zu dem Zweck geschieht, Anwendungsprogramme zu entwickeln, verwenden, vermarkten oder zu verteilen, die mit der Anwendungsprogrammierschnittstelle konform sind, für die diese Beispielprogramme geschrieben werden. Diese Beispiele wurden nicht unter allen denkbaren Bedingungen getestet. Die in diesem Handbuch aufgeführten Beispiele sollen lediglich der Veranschaulichung und zu keinem anderen Zweck dienen. Sie dürfen diese Musterprogramme kostenlos kopieren, ändern und verteilen, wenn dies zu dem Zweck geschieht, Anwendungsprogramme zu entwickeln, verwenden, vermarkten oder zu verteilen, die mit den Anwendungsprogrammierschnittstellen von IBM konform sind.
Folgende Namen sind in den USA und/oder anderen Ländern Marken der International Business
Machines Corporation:
DB2, developerWorks, IBM, Informix, Passport Advantage, WebSphere, z/OS.
Java und alle auf Java basierenden Marken und Logos sind in den USA und/oder anderen Ländern Marken oder eingetragene Marken von Oracle und/oder verbundenen Unternehmen.
Microsoft und Windows sind in den USA und/oder anderen Ländern
Marken der Microsoft Corporation.
UNIX ist in den USA und/oder anderen Ländern eine eingetragene Marke von The Open Group.
Linux ist in den USA und/oder anderen Ländern eine Marke von Linus Torvalds.
Weitere Unternehmens-, Produkt- oder Servicenamen können Marken anderer Hersteller sein.
WebSphere Message Broker - Produktseite
http://www.ibm.com/software/integration/wbimessagebroker/
DB2-Fixpacks
Falls Sie über einen aktuellen Unterstützungsvertrag verfügen, können Sie DB2-Fixpacks auf CD beim DB2-Support bestellen. Ebenso können Sie DB2-Fixpacks aus dem Internet herunterladen; allerdings sind einige der Fixpackdateien sehr groß; durch Bestellung der CD-Versionen können Sie langwierige Downloads vermeiden.
Hinweise zu DB2-Unterstützungsverträgen sowie zum Download von DB2-Fixpacks finden Sie unter:
http://www.ibm.com/software/data/db2/udb/support.html
WebSphere MQ-Fixpacks
http://www.ibm.com/support/entry/portal/Software/WebSphere/WebSphere_MQ
WebSphere Message Broker-Fixpacks
http://www.ibm.com/support/docview.wss?uid=swg27006041
WebSphere Message Broker - Anforderungen
http://www.ibm.com/software/integration/wbimessagebroker/requirements/
Readme-Datei für WebSphere Message Broker
http://www.ibm.com/support/docview.wss?uid=swg27006917
WebSphere Message Broker V8.0 Stand-alone-Information Center
Für Linux:
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V8.0/wmb_help_linux.tgz
Für Windows:
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V8.0/wmb_help_win.zip
WebSphere Message Broker V8.0 Online-Information Center
http://publib.boulder.ibm.com/infocenter/wmbhelp/v8r0m0/index.jsp
IBM Zentrum für Downloads zu Java™ Technology Development
http://www.ibm.com/developerworks/java/jdk/
Spezifikation 'Web Services Description Language' (WSDL)
http://www.w3.org/TR/wsdl
WebSphere Message Broker developerWorks-Zone
http://www.ibm.com/developerworks/websphere/zones/businessintegration/wmb.html