Willkommen bei IBM WebSphere Message Broker. Dies ist die Readme-Datei für Version 7.0 der Ausrüstungs- und Laufzeitkomponenten.
In dieser Readme-Datei werden bekannte Probleme beschrieben. Außerdem enthält sie Aktualisierungen der verfügbaren Dokumentationsversion des Produkts.
Verwenden Sie stets die neueste Version dieser Readme-Datei. Sie finden diese nur auf Englisch unter:
http://www.ibm.com/support/docview.wss?rs=171&uid=swg27006917
Übersetzte Readme-Dateien sind unter der folgenden Adresse erhältlich:
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/
Informationen zu den vor der Produktinstallation erforderlichen Tasks finden Sie im
WebSphere Message Broker Information Center unter:
http://publib.boulder.ibm.com/infocenter/wmbhelp/v7r0m0/index.jsp
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,))
/*
Rufen Sie bei einer Migration von WebSphere Message Broker Version 6.0 oder Version 6.1 das Online Information Center unter http://publib.boulder.ibm.com/infocenter/wmbhelp/v7r0m0/index.jsp auf. Dort finden Sie ausführliche Informationen zur Vorgehensweise bei der Migration.
Unter http://www.ibm.com/support/docview.wss?rs=849&uid=swg21255570 ist ein Dokument mit einer Beschreibung spezieller Migrationsprobleme verfügbar, die von der IBM Unterstützungsfunktion gemeldet werden.
Das Online Information Center
für WebSphere Message Broker kann unter der folgenden Adresse aufgerufen werden:
http://publib.boulder.ibm.com/infocenter/wmbhelp/v7r0m0/index.jsp
Das Standalone Information Center steht unter der folgenden Adresse zum Download zur Verfügung:
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V7.0/wmb_help_linux.tgz (Linux-Version)
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V7.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: Aktuelle Informationen zu bekannten Problemen und verfügbaren Korrekturen finden Sie auf der Unterstützungswebsite von WebSphere Message
Broker unter:
http://www.ibm.com/software/integration/wbimessagebroker/support/
Klicken Sie für die Suche nach Informationen auf Troubleshoot > View all Troubleshooting documents (Fehlerbehebung > Alle Dokumente zur Fehlerbehebung anzeigen). Alle relevanten technischen Hinweise werden angezeigt; diese können bestellt und durchsucht werden.
Informationen zum Download der Installationsimages von
WebSphere Message Broker Version 7.0 über die Passport Advantage-Website finden Sie im Downloaddokument Download WebSphere Message
Broker V7.0 from the Passport Advantage Web site unter folgender Adresse:
http://www.ibm.com/support/docview.wss?rs=849&uid=swg24023447
Versionen: Aktuelle Informationen darüber, welche Betriebssystem- und Datenbankversionen von WebSphere Message Broker unterstützt werden, finden Sie auf der Seite mit den Systemvoraussetzungen unter folgender Adresse:
http://www.ibm.com/software/integration/wbimessagebroker/requirements/index.html
Überprüfen
Sie in regelmäßigen Abständen, ob Aktualisierungen für das Toolkit, einschließlich Aktualisierungen
der Dokumentation auf Englisch und in anderen unterstützten Sprachen, zur Verfügung
stehen. Empfohlene Programmkorrekturen für WebSphere Message Broker sind unter folgender Adresse zu finden:
http://www.ibm.com/support/docview.wss?rs=849&uid=swg27006041
Einzelheiten zu den Neuerungen in Version 7.0 finden Sie auf folgender Website:
http://publib.boulder.ibm.com/infocenter/wmbhelp/v7r0m0/index.jsp?topic=/com.ibm.etools.mft.doc/bb45000_.htm
In diesem Abschnitt werden die Einschränkungen im Hinblick auf die einzelnen Komponenten von WebSphere Message Broker beschrieben.
Im folgenden Abschnitt finden Sie den korrigierten Text für die Abschnitte von WebSphere Message Broker und WebSphere Message Broker for z/OS zu diesem Thema:
WebSphere Message Broker
Das Paket enthält den Produktcode für alle unterstützten verteilten Betriebssysteme und zusätzlich weitere optionale Software und Dokumentation:
WebSphere Message Broker for z/OS
Das Paket enthält den Produktcode für das z/OS-Betriebssystem auf Band und zusätzlich weitere optionale Software und Dokumentation. Sie erhalten außerdem WebSphere Message Broker for Linux on x86, Linux on x86-64 und Windows, da das WebSphere Message Broker Toolkit nur auf diesen Betriebssystemen verfügbar ist.
Die elektronischen Images, die Sie herunterladen können, verfügen über entsprechende Inhalte.
Weitere Informationen zu den Bändern, die mit WebSphere Message Broker for z/OS geliefert werden, finden Sie unter Program Directory for WebSphere Message Broker for z/OS.
Hinweise 1 und 3 im Information Center-Abschnitt 'bh44965_ Unterstützte Migrationspfade' fehlen in folgendem markierten Text:
1. Sie können WebSphere Message Broker Version 6.1 mit Fixpack 3 (Version 6.1.0.3) oder höher migrieren. Für die Verwendung von WebSphere MQ Version 7.0.1 müssen Sie vor der Migration Ihrer Version 6.1 der Installation ein Upgrade durchführen.
>>Bei der Verwendung von WebSphere Application Server mit WebSphere Message Broker oder bei der Verwendung von Publish/Subscribe-Anwendungen, die die Option 'SubIdentity' verwenden, müssen Sie ein Upgrade von WebSphere Message Broker Version 6.1 auf Fixpack 4 durchführen, damit Sie in WebSphere Message Broker Version 7.0 migrieren können.<<
3. Sie können Produkte der Version 6.0 in Fixpack 9 (Version 6.0.0.9) oder höher >>für Laufzeitkomponenten und Produkte der Version 6.0.2 oder höher für das WebSphere Message Broker Toolkit<< migrieren. Für die Verwendung von WebSphere MQ Version 7.0.1 müssen Sie vor der Migration Ihrer Version 6.0 der Installation ein Upgrade durchführen.
>>Bei der Verwendung von WebSphere Application Server mit WebSphere Message Broker oder bei der Verwendung von Publish/Subscribe-Anwendungen, die die Option 'SubIdentity' verwenden, müssen Sie vor der Migration von WebSphere Message Broker Version 6.0 oder WebSphere Event Broker Version 6.0 auf WebSphere Message Broker Version 7.0 den Analysebericht APAR IZ55985 BROKER REPORTS SUBIDENTITY INCORRECTLY lesen.<<
Für die Migration von Publish/Subscribe-Informationen aus WebSphere Message
Broker auf WebSphere MQ mit dem Befehl migmbbrk
ist APAR IZ63802 erforderlich.
IZ63802 ist in WebSphere MQ Version 7.0.1.1 verfügbar.
Für die Migration von Publish/Subscribe-Informationen aus WebSphere Message
Broker auf WebSphere MQ mit dem Befehl migmbbrk
ist APAR PK97972 erforderlich.
Der Information Center-Abschnitt 'ah61170_ Veraltete Nachrichten aus Anzeigeoptionen entfernen' enthält neben gelöschten Nachrichten auch neue und wiederverwendete Nachrichten. Er wird in Routinen bei der Fehlerverarbeitung aktualisieren umbenannt. Die aktualisierten Inhalte für diesen Abschnitt sind unter der Adresse http://www.ibm.com/support/docview.wss?rs=849&uid=swg21409374 auf der WebSphere Message Broker-Unterstützungssite verfügbar.
In Version 6.0 können Sie bei einem anderen Wert als 'MRM' oder 'IDOC' für die Nachrichtengruppeneigenschaft 'Nachrichtendomäne' über eine Nachrichtengruppe verfügen, die sowohl MRM-fremde als auch MRM-Modelle enthält, und eine Datei des Typs '.dictionary' generieren, wenn die Nachrichtengruppe zu einer Brokerarchivdatei hinzugefügt wird. Dabei spielt die Einstellung der Nachrichtendomäne keine Rolle.
In Version 6.1 und 7.0 wird nur ein Wörterbuch generiert, wenn die Nachrichtendomäne 'MRM' oder 'IDOC' lautet.
Lösung:
Wählen Sie das MRM-Kontrollkästchen unter der Nachrichtengruppeneigenschaft für unterstützte Nachrichtendomänen aus.
Symptome:
Bei der Migration des WebSphere Message Broker Toolkits und der zugehörigen Ressourcen werden möglicherweise Einträge wie beispielsweise die Optionen des vorigen Toolkits in Menüs angezeigt, die seit der letzten Lieferung entfernt wurden.
Lösung:
Klicken Sie beim Öffnen des WebSphere Message Broker Toolkits und der Broker Application Development-Perspektive auf Window > Reset Perspective (Windows > Perspektive zurücksetzen), um sicherzustellen, dass alle Ansichten und Menüs für Version 7.0 aktualisiert werden.
Symptome:
Bei der Koexistenz eines WebSphere Message Broker Toolkits der Version 6.1 mit einem Toolkit der Version 7.0 wird beim Start des Toolkits der Version 6.1 möglicherweise die Begrüßungsanzeige von Version 7.0 angezeigt. Dieser Fehler gilt für Toolkits der Version 6.1 bis einschließlich V6.1.0.3.
Lösung:
Dieses Problem wird in Version 6.1.0.4 (Fixpack 4) behoben. Führen Sie ein Upgrade Ihres Toolkits auf V6.1.0.4 oder durch.
Im folgenden Abschnitt wird der korrigierte Text für diesen Schritt angezeigt:
Unter Linux on x86 ist für die Beendigung der Bestätigung die Rootberechtigung erforderlich. Sie können das WebSphere Message Broker Toolkit nicht aus dem Installationsassistenten starten, da es bei der Erstellung von Ressourcen (z. B. als Broker) zu Problemen bei der Ausführung kommen kann, wenn Sie nicht als Root-Benutzer angemeldet sind. Diese Option ist daher nicht verfügbar.
Melden Sie sich aus der Benutzer-ID ab, unter der Sie das Produkt installiert haben. Melden Sie sich mit der gleichen ID (falls es nicht der Root-Benutzer ist) oder einer anderen ID mit Ausnahme der ID des Root-Benutzers an.
Starten Sie das WebSphere Message Broker Toolkit aus dem Hauptmenü oder führen Sie die bereitgestellte Scriptdatei aus. Navigieren Sie in einer Befehlszeile zum Stammverzeichnis der Paketgruppe und geben Sie folgenden Befehl ein:
>>./launcher
Sie können die Anwendung bei Bedarf auch direkt ausführen:
./eclipse -product
com.ibm.etools.msgbroker.tooling.ide
Vor der Ausführung der Anwendung müssen Sie allerdings den Pfad LD_LIBRARY_PATH festlegen. Informationen zum Festlegen von LD_LIBRARY_PATH finden Sie im Script des Startprogramms.<<
mqsicreatebar
ist möglicherweise die Bereinigung des Projekts erforderlichSymptome:
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 Project > Clean (Projekt > Bereinigen), um die Projekte neu zu erstellen. Nach der Bereinigung der Projekte werden die Fehlernachrichten, die sich auf den Import beziehen, entfernt.
Symptome:
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.
In den folgenden Abschnitten des Information Centers werden die Funktionen zum Ziehen und Ablegen von Elementen im Zuordnungseditor beschrieben:
Unter Linux kann die Funktion zum Ziehen und Ablegen im Zuordnungseditor jedoch nicht korrekt ausgeführt werden. Deshalb können Sie ein Quellenelement im Quellenfenster nicht in ein Zielelement im Zielfenster bzw. ein Quellenelement aus dem Quellenfenster nicht in das Bearbeitungsfenster ziehen. Außerdem können Sie Elemente nicht mit der Funktion zum Ziehen und Ablegen in einem Element im MapScript-Fenster nach oben oder unten verschieben.
Alternativverfahren zur Ausführung dieser Aktionen werden im Information Center dokumentiert. Zum Verschieben von Elementen im MapScript-Fenster können Sie die Elemente kopieren und einfügen oder die Aktionen zum Löschen und erneuten Erstellen bzw. Ausfüllen der Elemente verwenden.
Symptome:
Die TCP/IP-Knoten unter Solaris x86-64 führen keine Datenverarbeitung durch und können Verbindungen verweigern.
Lösung:
Wenn derartige Probleme bei Ihnen auftreten, setzen Sie 'rlim_fd_max' und 'rlim_fd_cur' auf 8193 oder niedriger.
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 nachfolgende iterative EMD-Erkennungen sicherzustellen und die Informationen der Adaptersystemverbindung beizubehalten:
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.
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. An Stelle 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 dienen lediglich als Benutzerinformationen und stellen keinerlei Billigung des Inhalts dieser Website dar. Das über diese Websites verfügbare Material ist nicht Bestandteil des Materials für dieses IBM Produkt.
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 übernimmt im Hinblick auf Produkte anderer Hersteller keine Verantwortung für einwandfreie Funktion, Kompatibilität oder andere Ansprüche. 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.
COPYRIGHT-LIZENZ:
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:
AIX, DB2, developerWorks, IBM,
Passport Advantage, Rational, WebSphere, z/OS.
Java und alle auf Java basierenden Marken und Logos sind in den USA und/oder anderen Ländern Marken von Sun Microsystems, Inc.
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.
DB2-Fixpacks
Falls Sie über einen aktuellen Unterstützungsvertrag verfügen, können Sie telefonisch beim DB2-Support DB2-Fixpacks auf CD bestellen. Sie können die DB2-Fixpacks auch aus dem Web herunterladen. Allerdings sind manche Fixpackdateien sehr groß, durch Verwendung der CD-Versionen lassen sich somit unter Umständen langwierige Downloads vermeiden.
Kontaktinformationen für den DB2-Support sowie Downloads der DB2-Fixpacks sind auf der folgenden Website verfügbar:
http://www.ibm.com/software/data/db2/udb/support.html
WebSphere MQ-Fixpacks
http://www.ibm.com/software/integration/wmq/support/
WebSphere Message Broker-Fixpacks
http://www.ibm.com/support/docview.wss?rs=171&uid=swg27006367
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?rs=171&uid=swg27006917
WebSphere Message Broker Stand-alone Information
Center
Für Linux:
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V7.0/wmb_help_linux.tgz
Für Windows:
ftp://public.dhe.ibm.com/software/integration/wbibrokers/docs/V7.0/wmb_help_win.zip
WebSphere Message Broker V7.0 - Online Information Center
http://publib.boulder.ibm.com/infocenter/wmbhelp/v7r0m0/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