Sun Java System Message Queue Versionshinweise

Version 3 2005Q4 (3.6 SP3)

Teilenummer 819-3558

Diese Versionshinweise enthalten wichtige Informationen, die zum Zeitpunkt der Herausgabe von Sun Java™ System Message Queue 3 2005Q4 (3.6 SP3) verf�gbar waren. Dieses Dokument umfasst zudem den Inhalt der Versionshinweise zu Sun Java™ System Message Queue 3 2005Q1 (3.6) f�r Kunden, die ein Upgrade von Versionen vor Message Queue 3 2005Q1 durchf�hren. In diesem Dokument werden neue Funktionen und Verbesserungen, bekannte Probleme und Einschr�nkungen und andere Informationen angesprochen, die Sie vor der Verwendung von Message Queue lesen sollten.

Die neueste Ausgabe dieser Versionshinweise finden Sie auf der Sun Java System Message Queue-Website f�r Dokumentationen unter http://docs.sun.com/coll/1307.1. Besuchen Sie diese Website vor der Installation und Konfiguration Ihrer Software und sp�ter regelm��ig, um stets die neuesten Versionshinweise und Produktdokumentationen verf�gbar zu haben.

In diesen Versionshinweisen werden die folgenden Themen behandelt:

�nderungsprotokoll der Versionshinweise
Informationen zu Message Queue 3 2005Q4 (3.6 SP3)
In dieser Version behobene Fehler
Wichtige Informationen
Bekannte Probleme und Einschr�nkungen
Dateien f�r Neuverteilung
Eingabehilfen f�r Benutzer mit Behinderungen
Problemmeldungen und Feedback
Weitere Informationen �ber Sun

In der vorliegenden Dokumentation wird auf URLs von Drittanbietern verwiesen, �ber die zus�tzliche relevante Informationen zur Verf�gung gestellt werden.

Hinweis	Sun ist nicht haftbar f�r die Verf�gbarkeit der Websites Dritter, die in diesem Dokument erw�hnt werden. Sun unterst�tzt keine Inhalte, Werbung, Produkte oder sonstige Materialien, die auf oder �ber solche Websites oder Ressourcen verf�gbar sind, und �bernimmt keine Verantwortung oder Haftung daf�r. Sun ist nicht verantwortlich oder haftbar f�r tats�chliche oder vermeintliche Sch�den oder Verluste, die durch oder in Verbindung mit der Verwendung von �ber solche Websites oder Ressourcen verf�gbaren Inhalten, Waren oder Dienstleistungen bzw. dem Vertrauen darauf entstanden sind.

---

�nderungsprotokoll der Versionshinweise

Tabelle 1  �nderungsprotokoll 

Datum	Beschreibung der �nderungen
26. August 2005	Aktualisierung von Informationen zu Message Queue 3 2005Q4 (3.6 SP3). Aktualisierung von Aktualisierung der Dokumentation f�r Message Queue 3 2005Q4 (3.6 SP3). Aktualisierung von Hardware- und Softwareanforderungen f�r Message Queue 2005Q4 (3.6 SP3). Hinzuf�gen behobener Fehler f�r Message Queue 3 2005Q4 (3.6 SP3) zu In dieser Version behobene Fehler.
28. Juni 2005	Hinzuf�gen behobener Fehler f�r Message Queue 3 2005Q1 (3.6 SP1) und Message Queue 32005Q4 (3.6 SP2) zu In dieser Version behobene Fehler.
1. Mai 2005	Aktualisierung des Abschnitts Probleme mit der n�chsten gr��eren Version von Message Queue mit neuen Informationen. Hinzugef�gte Anmerkung zur Oberfl�chenstabilit�t im Abschnitt „Kompatibilit�t“.
24. Januar 2005	Auf die Verkaufsversion von Sun Java System Message Queue 3 2005Q1 und Java Enterprise System 2005Q1 abgestimmtes Update.
8. November 2004	Urspr�ngliche Ver�ffentlichung von Sun Java System Message Queue Versionshinweise.

---

Informationen zu Message Queue 3 2005Q4 (3.6 SP3)

Message Queue 3 2005Q4 (3.6 SP3) ist ein Fehlerbehebungs-Update von Message Queue 3 2005Q1 (3.6). Es enth�lt s�mtliche Fehlerbehebungen aus 3.6 SP2 und 3.6 SP1 sowie neue Updates der Dokumentation.

Message Queue 3 2005Q1 (3.6)

Sun Java System Message Queue ist ein umfassender Meldungsdienst, der eine zuverl�ssige, asynchrone �bermittlung von Meldungen garantiert, die der Java Messaging Specification (JMS) 1.1 entsprechen. Au�erdem bietet Message Queue eine Vielzahl von Funktionen, die die JMS Specification sogar noch �bertreffen und so die Anforderungen bei einem Einsatz in Gro�unternehmen erf�llen.

Dieser Abschnitt enth�lt Informationen zu folgenden Themen:

Neuheiten in dieser Version
Hardware- und Softwareanforderungen

Neuheiten in dieser Version

Message Queue 3 2005Q1 (3.6) enth�lt folgende neue Funktionen:

Dead Message Queue
Kein Best�tigungsmodus
Komprimierung des Client-Meldungstextes
Erkennen eines Verbindungsfehlers (Client-Runtime-Ping)
Zertifikatsverwaltung C-API NSS-Tools
Unterst�tzung f�r C-API Basic-Authentifizierung
64-Bit C-API-Unterst�tzung

Diese werden in den folgenden Abschnitten genauer erl�utert.

Dead Message Queue

Message Queue erstellt automatisch einen speziellen Zielstandort beim Broker-Start, der zum Speichern verstorbener Meldungen f�r Diagnosezwecke dient. Eine verstorbene Meldung wird aus anderen Gr�nden vom System entfernt als durch die normale Verarbeitung oder das absichtliche Handeln eines Administrators. Eine Meldung wird eventuell als "verstorben" betrachtet, weil sie abgelaufen ist, weil sie aus einem Zielstandort wegen eines �berschreitens des Speicherlimits entfernt wurde oder weil die Zustellung wiederholt fehlgeschlagen ist.

Ein Administrator kann die Zielstandorte so konfigurieren, dass verstorbene Meldungen gel�scht werden oder in die Warteschlange f�r verstorbene Meldungen aufgenommen werden. Wenn sie sich in der Warteschlange f�r verstorbene Meldungen befinden, werden in die Meldung zus�tzliche Eigenschaftsdaten geschrieben, durch die ein Administrator �ber die Todesursache informiert wird. Ein Client-Entwickler kann weiterhin beim Erstellen einer Meldung einen Eigenschaftswert festlegen, der bestimmt, ob die Meldung nach dem Tod in die Warteschlange der verstorbenen Meldungen aufgenommen wird.

Weitere Informationen finden Sie im Handbuch Message Queue Administration Guide.

Kein Best�tigungsmodus

Der Best�tigungsmodus NO_ACKNOWLEDGE ist eine Erweiterung des JMS API. Gew�hnlich wartet der Broker auf die Best�tigung eines Clients. Diese Best�tigung muss programmatisch durchgef�hrt werden, wenn der Client CLIENT_ACKNOWLEDGE angegeben hat oder kann automatisch von der Sitzung durchgef�hrt werden, wenn der Client AUTO_ACKNOWLEDGE oder DUPS_OK angegeben hat. Wenn ein konsumierender Client den Modus NO_ACKNOWLEDGE angibt, verwirft der Broker die Meldung gleich nach dem Senden an den konsumierenden Client. Diese Funktion ist f�r nichtdauerhafte Abonnenten, die nichtpersistente Meldungen konsumieren, gedacht, aber sie kann von jedem Konsumenten verwendet werden.

Wenn Sie diese Funktion verwenden, wird die Leistung verbessert, da der Protokollverkehr und die Broker-Verarbeitung beim Best�tigen einer Meldung verringert werden. Diese Funktion kann die Leistung auch bei Brokern verbessern, die mit fehlerhaft arbeitenden Clients zusammenarbeiten. Solche Clients best�tigen keine Meldungen und belegen so unn�tigerweise Speicherressourcen des Brokers. Der Einsatz dieses Modus hat auf die Produzenten keine Auswirkungen.

In C-Clients wird der Modus NO_ACKNOWLEDGE nicht unterst�tzt. Weitere Informationen finden Sie im Handbuch Message Queue Developer’s Guide for Java Clients.

Komprimierung des Client-Meldungstextes

Der Entwickler kann festlegen, dass der Meldungstext komprimiert wird. Die Komprimierung und Dekomprimierung von Meldungen wird ausschlie�lich von der Client-Runtime durchgef�hrt und hat keine Auswirkungen auf den Broker. Daher k�nnen auch Anwendungen mit einer fr�heren Broker-Version diese Funktion verwenden. Es muss jedoch die Version 3 2005Q1 (3.6) der Message Queue Client-Runtime-Bibliothek verwendet werden.

Vorteile und Nachteile der Komprimierung     Die Meldungskomprimierung dient zwar der Leistungsverbesserung, aber es gibt daf�r keine Garantie. Je nach Gr��e und Format der Meldungen, der Anzahl der Konsumenten, der Netzwerk-Bandbreite und der CPU-Leistung fallen die Vorteile unterschiedlich aus. Die Kosten f�r Komprimierung und Dekomprimierung sind eventuell h�her als die Zeitersparnis beim Senden und Empfangen einer komprimierten Meldung. Das ist vor allem der Fall, wenn Sie kleine Meldungen in einem Hochgeschwindigkeitsnetzwerk senden. Andererseits k�nnen Anwendungen, die an viele Konsumenten gro�e Meldungen senden oder die in einer langsamen Netzwerkumgebung arbeiten, die Systemleistung durch das Komprimieren der Meldungen verbessern.

Meldungskonsumenten, die mit Client-Runtime-Bibliotheken aus fr�heren Versionen als 3 2005Q1 (3.6) eingesetzt werden, k�nnen keine komprimierten Meldungen verarbeiten. Clients, die zum Senden komprimierter Meldungen konfiguriert wurden, m�ssen sicherstellen, dass die Konsumenten kompatibel sind. C-Clients k�nnen derzeit keine komprimierten Meldungen empfangen.

Weitere Informationen finden Sie im Handbuch Message Queue Developer’s Guide for Java Clients.

Erkennen eines Verbindungsfehlers (Client-Runtime-Ping)

Message Queue 3 2005Q1 bietet ein neues ConnectionFactory-Attribut mit dem Namen imqPingInterval. Das imqPingInterval-Attribut gibt die H�ufigkeit einer Ping-Operation vom Client-Runtime zum Broker an. Indem die Verbindung regelm��ig getestet wird, kann die Client-Runtime eine fehlerhafte Verbindung bereits im Voraus entdecken. Falls die Ping-Operation fehlschl�gt, gibt die Client-Runtime einen Ausnahmefehler an das Ausnahmefehler-Listener-Objekt der Client-Anwendung aus. Falls die Anwendung �ber keinen Ausnahmefehler-Listener verf�gt, schl�gt der n�chste Versuch der Anwendung fehl, die Verbindung zu nutzen.

Weitere Informationen finden Sie im Handbuch Message Queue Administration Guide.

Zertifikatsverwaltung C-API NSS-Tools

Der C-API verwendet NSS (Network Security Services)-Bibliotheken zur Unterst�tzung von SSL. Diese Bibliotheken bieten APIs und Dienstprogramme zur Entwicklung sicherer Anwendungen. Diese Dienstprogramme enthalten Tools zur Verwaltung von Schl�sseln und Zertifikatsdatenbanken. In Message Queue 3.5 wurden Entwickler gebeten, bei der Verwaltung von NSS-Schl�sseln und -Zertifikaten Mozilla einzusetzen. Bei Message Queue 3 2005Q1 k�nnen die Administratoren das NSS-Tool certutil verwenden, um die erforderlichen Schl�ssel und Zertifikate zu erstellen.

Weitere Informationen finden Sie im Handbuch Message Queue Developer’s Guide for C Clients.

Unterst�tzung f�r C-API Basic-Authentifizierung

Message Queue 3 2005Q1 C-API unterst�tzt die Authentifizierung basic. Bei vorherigen Versionen von Message Queue wurde der Authentifizierungstyp basic nicht unterst�tzt.

64-Bit C-API-Unterst�tzung

Message Queue bietet jetzt die 64-Bit C-API-Unterst�tzung auf der Solaris/SPARC-Plattform. Weitere Informationen zur Aktivierung der 64-Bit C-API-Unterst�tzung finden Sie im Handbuch Message Queue Developer’s Guide for C Clients.

Hardware- und Softwareanforderungen

In diesem Abschnitt wird die f�r diese Version von Message Queue erforderliche Hard- und Software angegeben bzw. beschrieben. In der Tabelle 2 sehen Sie die Hardware- und Softwareanforderungen f�r Solaris SPARC-Betriebssyteme.

Tabelle 2  Solaris SPARC Hardware- und Softwareanforderungen 

Komponente	Plattformanforderungen
Betriebssystem	Solaris 8, Update 7 Solaris 9, Update 7 Solaris 10, Update 1 (Enth�lt 32- und 64-Bit-Unterst�tzung f�r Solaris 8, Solaris 9 und Solaris 10)
CPU	Sun UltraSPARC™ Hinweis: Sie k�nnen einen korrekten Betrieb von Message Queue sicherstellen, indem Sie alle erforderlichen Solaris-Patches f�r die Java 2 Platform, Standard Edition 5.0 installieren. Die neuesten Informationen zu den Patches und zum Download der empfohlenen und erforderlichen Patches finden Sie unter http://java.sun.com/j2se/1.5.0/download.jsp
RAM	256 MB
Festplattenspeicher	Platform Edition: Die komprimierte Installationsdatei hat eine Gr��e von ca. 33 MB. Im tempor�ren Arbeitsverzeichnis sind zur Extraktion der Installationsdateien zus�tzliche 33 MB erforderlich. Das installierte Produkt ben�tigt ca. 33 MB Festplattenspeicher. Message Queue ben�tigt jedoch eventuell mehr Speicherplatz, wenn der Broker persistente Meldungen lokal speichert. Enterprise Edition: Die komprimierte Installationsdatei hat eine Gr��e von ca. 152 MB. Im tempor�ren Arbeitsverzeichnis sind zur Extraktion der Installationsdateien zus�tzliche 152 MB erforderlich. Das installierte Produkt ben�tigt ca. 33 MB Festplattenspeicher. Message Queue ben�tigt jedoch eventuell mehr Speicherplatz, wenn der Broker persistente Meldungen lokal speichert.

In der Tabelle 3 sehen Sie die Hardware- und Softwareanforderungen f�r Solaris x86-Betriebssysteme.

Tabelle 3  Solaris x86 – Hardware- und Softwareanforderungen 

Komponente	Plattformanforderungen
Betriebssystem	Solaris 9, Update 7 Solaris 10, Update 1 (Enth�lt 32- und 64-Bit-Unterst�tzung f�r Solaris 9 und Solaris 10)
CPU	Intel Pentium 2 (oder kompatibel) Hinweis: Sie k�nnen einen korrekten Betrieb von Message Queue sicherstellen, indem Sie alle erforderlichen Solaris-Patches f�r die Java 2 Platform, Standard Edition 5.0 installieren. Die neuesten Informationen zu den Patches und zum Download der empfohlenen und erforderlichen Patches finden Sie unter http://java.sun.com/j2se/1.5.0/download.jsp
RAM	256 MB
Festplattenspeicher	Platform Edition: Die komprimierte Installationsdatei hat eine Gr��e von ca. 22 MB. Im tempor�ren Arbeitsverzeichnis sind zur Extraktion der Installationsdateien zus�tzliche 22 MB erforderlich. Das installierte Produkt ben�tigt ca. 33 MB Festplattenspeicher. Message Queue ben�tigt jedoch eventuell mehr Speicherplatz, wenn der Broker persistente Meldungen lokal speichert. Enterprise Edition: Die komprimierte Installationsdatei hat eine Gr��e von ca. 115 MB. Im tempor�ren Arbeitsverzeichnis sind zur Extraktion der Installationsdateien zus�tzliche 115 MB erforderlich. Das installierte Produkt ben�tigt ca. 33 MB Festplattenspeicher. Message Queue ben�tigt jedoch eventuell mehr Speicherplatz, wenn der Broker persistente Meldungen lokal speichert.

In der Tabelle 4 sehen Sie die Hardware- und Softwareanforderungen f�r Linux-Betriebssysteme.

Tabelle 4  Hardware- und Softwareanforderungen f�r Linux 

Komponente	Plattformanforderungen
Betriebssystem	Red Hat Advanced Server 2.1, Update 6 RedHat Advanced Server 3.0, Update 4 Hinweis: Die Message Queue-Softwareverteilung enth�lt zum Zeitpunkt der Ver�ffentlichung die erforderliche JRE-Version.
CPU	Intel Pentium 2 (oder kompatibel)
RAM	256 MB
Festplattenspeicher	Platform Edition: Die Zip-Datei mit dem Produkt hat eine Gr��e von ca. 17 MB. Das installierte Produkt ben�tigt ca. 17 MB Festplattenspeicher. Message Queue ben�tigt jedoch eventuell mehr Speicherplatz, wenn der Broker persistente Meldungen lokal speichert. Enterprise Edition: Die Zip-Datei mit dem Produkt hat eine Gr��e von ca. 104 MB. Im tempor�ren Arbeitsverzeichnis sind zur Extraktion der Installationsdateien zus�tzliche 104 MB erforderlich. Das installierte Produkt ben�tigt ca. 17 MB Festplattenspeicher. Message Queue ben�tigt jedoch eventuell mehr Speicherplatz, wenn der Broker persistente Meldungen lokal speichert.

Message Queue 3 2005Q1 h�ngt auch von anderen Technologien ab. Genauere Hinweise finden Sie in Tabelle 5. Andere Versionen oder Herstellerimplementierungen k�nnen auch verwendet werden. Diese sind jedoch von Sun Microsystems nicht getestet und werden daher nicht unterst�tzt.

In der Tabelle 5 sehen Sie die zu installierenden Grundkomponenten, die f�r die Entwicklung und Ausf�hrung von Message Queue-Clients erforderlich sind, und erhalten eine Beschreibung derselben.

Tabelle 5  Message Queue 3 2005Q1 Grundlegende Produktunterst�tzung 

Plattform/Produkt	Verwendungszweck	Unterst�tzte Plattform/Produktversion
Java Runtime Environment (JRE) (nur Versionen von Sun Microsystems)	Message Queue-Broker (Meldungsserver) und Message Queue-Verwaltungs-Tools	Java Runtime Environment 1.4.2_05 Java 2 Platform, Standard Edition, 5.0 (1.5.0_02): Solaris 8 (SPARC), Solaris 9 (SPARC und X86) und Solaris 10 (SPARC und X86). Linux Red Hat Advanced Server 2.1, Update 6 und Linux Red Hat Advanced Server 3.0, Update 4. Windows XP Professional SP2, 2000 alle Editions SP4, Windows Server 2003 Enterprise Edition.
Java Software Development Kit (JDK), Standard Edition (nur Produktversionen von Sun Microsystems)	Java-Client-Entwicklung und -Einsatz (Java SOAP/JAXM-Clients werden nur unterst�tzt von JDK 1.4.2 und 1.5)	JDK 1.4.2_05 Java 2 Platform, Standard Edition, 5.0 (1.5.0_02): Solaris (gleiche Plattformen wie JRE) Linux (gleiche Plattformen wie JRE) Windows (gleiche Plattformen wie JRE)

In der Tabelle 6 sehen Sie die Komponenten, die Sie installieren k�nnen, um zus�tzliche Unterst�tzung f�r einen Message Queue-Client bereitzustellen, und finden eine Beschreibung derselben. Wahrscheinlich ben�tigen Sie nur einige der aufgef�hrten Komponenten. Wenn Sie beispielsweise keinen C-Client in Message Queue schreiben, ben�tigen Sie keine der erforderlichen Komponenten f�r die C-Client-Unterst�tzung.

Tabelle 6  Message Queue 3 2005Q1 Optionale Produktunterst�tzung 

Produkt	Verwendungszweck	Unterst�tzte Produktversion
LDAP-Directory-Server	Message Queue-Benutzer-Repository und verwaltete Objektunterst�tzung	Sun Java System-Directory Server-Version 5.2 SP 3
Webserver	HTTP- und HTTPS-Unterst�tzung	Sun Java System Web Server, Enterprise Edition Version 6.1 SP 4
Anwendungsserver	HTTP- und HTTPS-Unterst�tzung	Sun Java System Application Server, Enterprise Edition 8.1
Datenbank	Plugin-Persistenzunterst�tzung	PointBase, Version 4.8 Oracle 9i, Version 9.2
JNDI (Java Naming and Directory Interface)	verwaltete Objektunterst�tzung	JNDI Version 1.2.1 LDAP Service Provider Version 1.2.2 File System Service Provider Version 1.2 Beta 3 (unterst�tzt f�r Entwicklung und zum Testen, aber nicht f�r den Einsatz in einer Produktionsumgebung)
C-Compiler und kompatible C++-Runtime-Bibliothek	Message Queue C-Client-Unterst�tzung	Solaris: Sun WorkShop 6, Update 2 oder h�herer C++-Compiler mit -compat=5, Sun WorkShop C-Compiler Linux: gcc/g++ 2.96 Windows: Microsoft Windows Visual C++ 6.0, SP3
NSPR (Netscape Portable Runtime)	Message Queue C-Client-Unterst�tzung	Version im Lieferumfang von Java Enterprise System 2005Q1 enthalten. In der Platform Edition ist diese Version als Paket f�r den gemeinsamen Zugriff installiert.
NSS (Network Security Service)	Message Queue C-Client-Unterst�tzung	Version im Lieferumfang von Java Enterprise System 2005Q1 enthalten. In der Platform Edition ist diese Version als Paket f�r den gemeinsamen Zugriff installiert.

---

In dieser Version behobene Fehler

In Tabelle 7 sehen Sie die in Message Queue 3 2005Q1 (3.6) behobenen Fehler:

Tabelle 7  Behobene Fehler in Message Queue 3 2005Q1 (3.6) 

Bugnummer	Beschreibung
2091749	Broker erh�lt Null-Pointer-Ausnahmefehler auf gemeinsamem Thread-Pool bei Belastung.
2092975	Persistenzspeicher sollte weiter geladen werden, wenn die Entserialisierung in einem Zielstandort fehlschl�gt.
2092976	Periodischer Fehler beim Verarbeiten der Meldung zum Themenziel, als ein Konsument mit Selektor beim Routing der Meldung durch das System geschlossen wurde.
4888259	vmargs werden �bergangen, wenn mehr als einer an imqbroker unter Windows geleitet wird.
4934433	Paketcode sollte gegen gro�e Pakete sch�tzen.
4941127	Zielstandort wird nicht komplett geladen, wenn eine Meldung das Einzelmeldungslimit �berschreitet.
4949398	imqcmd query dst meldet falsche Zahlen, w�hrend ein Zielstandort geladen wird.
4953659	Message Queue-Client ruft ExceptionListener.onException bei halb offener Verbindung nicht ab.
4962906	Broker sollte alte Datenbankverbindung entdecken und eine neue Verbindung herstellen.
4969880	Receive(timeout) gibt null zur�ck, bevor die Zeit�berschreitung abl�uft, und beendet h�ufig Verbindungen.
4970719	Meldungen mit Best�tigungen in vorbereiteter Transaktion k�nnen erneut an Konsumenten gesendet werden.
4983525	Fehler beim Erstellen von Produzent in selbst erstelltem Zielstandort in Linux 3.0-System.
4987799	Message Queue-Ressourcenadapter und Broker m�ssen gemeinsame Abonnements von Application Server 8.1 Enterprise Edition-Clustern unterst�tzen.
4989708	imqbrokerd verh�lt sich immer so, als w�re imq.transaction.autorollback = true.
4992645	Message Queue-Ressourcenadapter: JMS-Ressourcenadapter muss Verbindungs-Pooling unterst�tzen.
4996776	Broker gibt bei hoher Client-Belastung einschlie�lich Metriken Fehler ConcurrentModificationExceptions aus.
5004868	Gel�schte Transaktionen werden aus der JDBC-Datenbank nicht entfernt.
5014570	QBrowser-Beispiel funktioniert nicht mit der Platform Edition.
5024685	Zugriffssteuerungslisten: queue.create.deny.user=* und imq.autocreate.queue=true arbeiten fehlerhaft zusammen.
5025241	Dauerhafter Abonnent mit noLocal=true empf�ngt selbstpublizierte Meldungen.
5037962	Unstimmigkeit zwischen Master-Broker-Status und Protokoll verursacht Probleme beim Systemstart.
5042763	Dateispeichercode sollte FileChannel.force(false) verwenden, um synchrone E/A-Leistung zu verbessern.
5046995	Message Queue-Java-Client-Protokoll-Verhandlungsimplementierung funktioniert nicht zuverl�ssig.
5053565	Message Queue 3.5 SP1: Broker startet und brennt CPU in einen Cluster mit einem Master.
5063625	Warteschlangenempf�nger stoppt eingehende Meldungen mit daf�r vorgesehenen Remote-Meldungen in zwei Broker-Clustern.
6021000	Deadlock in Broker beim Hinzuf�gen und Entfernen von Konsumenten bei hoher Belastung.
6057402	Master-Broker-Problem beim Neustart, wenn Zielstandorte mit dauerhaften Abonnenten entfernt wurden.
6057450	imqcmd: Setzen von maxNumBackupConsumers auf 0 f�r Warteschlangen nicht m�glich.
6155087	Broker mit unzul�ssigem Broker-Namen und dauerhaftem Abonnenten in Cluster h�ngt beim Herunterfahren.
6155091	JDBC: "-reset store" ben�tigt bei gro�en Meldungen und Oracle viel Zeit.
6157943	imqbrokerd-Dienst f�hrt beim Neustart unter Windows 2000 nicht sauber herunter.
6165743	Message Queue-Ressourcenadapter: Wiederholte Verwendung von connection.open/close bei hoher Belastung kann IllegalStateException verursachen.
6165984	imqSSLIsHostTrusted wird ignoriert, wenn imqAddressList verwendet wird, um den Client f�r die SSL-Verbindung anzugeben.
6170578	Message Queue-Ressourcenadapter:ManagedConnectionFactory sollte Eigenschaften erben, die in Ressourcenadapter-Java-Bean festgelegt werden.
6170831	Message Queue-Ressourcenadapter: MDB-Zeitproblem beim Aufheben der Bereitstellung kann Null-Pointer-Ausnahmefehler verursachen, wenn weiterhin Meldungen empfangen werden.
6174532	JMS-Broker stellen Meldungen erneut zu, die bereits von MDB verarbeitet wurden.
6178549	Neu laden von cls verursacht einen Verlust der Liste mit den konfigurierten Brokern, falls -D imq.cluster.url bei der Eingabeaufforderung verwendet wird.
6189214	MQ_MESSAGE_ID_HEADER_PROPERTY (C) in erhaltener Meldung unterscheidet sich von JMSMessageID in gesendeter Meldung (Java).

In Tabelle 8 sehen Sie die in Message Queue 3 2005Q1 (3.6 SP1) behobenen Fehler:

Tabelle 8  Behobene Fehler in Message Queue 3 2005Q1 (3.6 SP1) 

Bugnummer	Beschreibung
6198481	Message Queue sollte bei den Versuchen zur erneuten Verbindungsherstellung die Application Server-reconnect-attempts/interval-Konfiguration verwenden und erneute Verbindungen f�r MDB unterbrechbar machen.
6205463	RichAccess: Nach Fehlerausl�sung Meldungsanh�ufung am Ziel, in 3 Stunden Fehler wegen unzureichendem Arbeitsspeicher.
6208728	Message Queue-Verbindungswiederherstellungs-Versuche:Endpoint UnavailableException in Application Server-Protokoll f�r richAccess bigApp nachdem MQ-Broker heruntergefahren/neu gestartet wurde.
6221802	Upgrade von NSPR/NSS auf SECURITY_3_9_5_RTM.

In Tabelle 9 sehen Sie die in Message Queue 3 2005Q4 (3.6 SP2) behobenen Fehler:

Tabelle 9  Behobene Fehler in Message Queue 3 2005Q4 (3.6 SP2) 

Bugnummer	Beschreibung
4737166	F�gt nicht erfasste Ausnahmebehandlung f�r ALLE Broker-Threads hinzu.
4959114	imqBrokerServiceName mit ung�ltigem Servicenamen f�hrt zu nutzloser Ausnahme
4960331	Ausnahme java.lang.NullPointerException beim Laden aus besch�digter DB verursacht
4961780	Der Befehl imqcmd metrics dst kann 0 msgs/sec anzeigen, auch wenn der (wenig) Meldungsverkehr vorhanden ist.
5017152	Es wurde derselbe Ressourcenschl�ssel f�r die Men�elementbezeichnung und den Dialogfeldtitel verwendet.
5029191	Es werden dieselben Zeichenfolgenschl�ssel in Men�s und Popup-Men�s verwendet.
5055667	Unknown Destination:temporary_destination wird manchmal beim Herunterfahren angezeigt.
6172663	Internes Flag isTopicConnection bei Erstellung einer vereinheitlichten Verbindung falsch gesetzt.
6172794	Neuer Remote-Konsument empf�ngt keine Meldungen an selbst erstelltem Ziel (cluster/rare).
6173336	Produzenten-Flusskontrolle h�ngt eventuell, wenn einem vollen Zielstandort st�ndig Produzenten hinzugef�gt werden.
6175764	Clusterproblem: Schnelles Schlie�en und erneutes �ffnen von dauerhaftem Element kann internen Fehler verursachen.
6176411	Broker f�ngt keine nicht erfassten Ausnahmen in Annahmethreads f�r Dienste ab.
6186193	Meldungen werden in manchen F�llen an System.out/System.err im Broker gesendet.
6186329	Meldungen w�hrend der Clusterinitialisierung ohne -tty verwirrend
6186615	Einige Felder der Benutzeroberfl�che im imqadmin-Tool haben scheinbar die Gr��e 0 und Sie k�nnen ihre Inhalte nicht anzeigen.
6189645	Deadlock bei erneuter Verbindung durch Client-Runtime, wenn Broker-Verbindung w�hrend connection.start() fehlschl�gt.
6191835	Message Queue-Ressourcenadapter/-Client zur Behebung von Daemon-Threads-Angaben zur Vermeidung von aktueller AccessControlException.
6193884	Message Queue gibt �berfl�ssige Meldung an Systemprotokoll in Nicht-C-Umgebung aus.
6195048	3.6-Broker verursacht Ausnahme beim Laden von 3.5-Speicher mit PREPARED-Transaktion.
6196233	Meldungsauswahl mithilfe von JMSMessageID funktioniert nicht.
6198465	Asynchrone �nderung im Meldungs-Listener-Verhalten in app-client von Application Server 8.0 in 8.1
6205641	jaxm-Demo verf�gt �ber falsche Application Server-Standorte.
6206595	Sparc-Versionen von SUNWiqcrt und SUNWiqcdv sollten nicht von SUNWprx, SUNWtlsx mit 64 bit abh�ngen.
6206611	64-bit-Bibliotheken m�ssen zu Message Queue x86-Paketen hinzugef�gt werden, damit amd64 unterst�tzt wird.
6208740	Speicherzur�cksetzung mit Master-Broker versucht Dead Message Queue (DMQ) zu zerst�ren.
6213561	web.xml in imq/jaxm/README sollte auf aktuellste Version aktualisiert werden.
6215079	Message Queue-Ressourcenadapter ActivationSpec verf�gt nicht �ber einen konfigurierbaren Benutzernamen und Passwort.
6216762	Unterst�tzung Solaris amd64
6226548	Verbindungswiederherstellungs-Intervall wird bei Adresslistenwiederholgung w�hrend des Failovers ignoriert.
6226550	Unaufh�rliche Wiederholgungsversuche bei Message Queue-Failover, wenn alle Hosts in mq-Adressliste nicht verf�gbar sind
6229572	Lokale/interne Konsumenten weitergeleitet, nachdem Broker-restart-local dsts auf neu gestartetem Broker nonlocal werden
6237112	imq.jar enth�lt kein com/sun/messaging/jmq/Version.class.
6240237	Durch WeakValueHashMap wird Speicher f�lschlicherweise nicht wieder freigegeben (Memory Leak), wobei Warteschlangenempf�nger Selektoren verwenden.
6240568	Broker verf�gt nicht �ber gen�gend Arbeitsspeicher, wenn neue Meldungen auf vollem Ziel zur�ckgewiesen werden.
6250207	tempor�rer Produzent und Konsument generieren Ausnahmen in einem Cluster.
6252146	Passwortabfrage in imqcmd, imqusermgr besch�digt.
6252184	Produzent h�ngt bei unerwartetem internem Fehler in Broker in Cluster mit tempor�ren Zielen & Master-Broker.

In Tabelle 10 sehen Sie die in Message Queue 3 2005Q4 (3.6 SP3) behobenen Fehler:

Tabelle 10  Behobene Fehler in Message Queue 3 2005Q4 (3.6 SP3) 

Bugnummer	Beschreibung
6256771	imq*-Skripten drucken Syntaxfehler, wenn sie in dateibasierter Installation verwendet werden.
6257306	Application Server startet nicht nach Message Queue-Upgrade unter Linux.
6269126	imqadmin kann nicht gestartet werden, wenn JavaHelp nicht installiert ist.
6271773	Entfernen von Installation freigegebener Komponenten aus mqinstall/mqupgrade.
6284769	QueueBrowser verf�gt nicht �ber gen�gend Speicher, auch wenn ein neuer Browser f�r jede Aufz�hlung erstellt und geschlossen wird.

---

Wichtige Informationen

In diesem Abschnitt finden Sie die aktuellsten Informationen, die nicht in der eigentlichen Produktdokumentation enthalten sind: In diesem Abschnitt werden die folgenden Themen behandelt:

Installationshinweise
Kompatibilit�t
Aktualisierungen der Dokumentation f�r Message Queue

Installationshinweise

Im Handbuch Message Queue Installation Guide finden Sie Anweisungen zur Installationsvorbereitung, Upgrade-Anleitungen und alle anderen Informationen zur Installation von Message Queue Platform Edition auf den Plattformen Solaris, Linux und Windows.

Im Handbuch Sun Java Enterprise System Installation Guide finden Sie Informationen zur Installationsvorbereitung und alle weiteren Informationen zur Installation von Message Queue Enterprise Edition auf den Plattformen Solaris und Linux.

Im Handbuch Sun Java Enterprise System Upgrade and Migration Guide finden Sie Informationen zum Upgrade und der Migration f�r die Aktualisierung auf Message Queue 3 2005Q1 (3.6) auf den Plattformen Solaris und Linux.

Installation fehlender Solaris-Pakete (nur in Message Queue 3 2005Q1 Enterprise Edition (Verteilung) mit Java Enterprise System Installer)

Die Message Queue 3 2005Q1 Enterprise Edition-Distribution f�r Solaris enth�lt nicht die folgenden Pakete: SUNWtlsu (Network Security Services Utilities) und SUNWtlsux (nur Network Security Services Utilities 64-Bit SPARC).

Diese Pakete sind nur f�r die Unterst�tzung von SSL C-Clients erforderlich. Eine vorherige Version dieser Pakete ist eventuell bereits auf Ihrem System installiert. Sie sollten diese Pakete jedoch auf die in Java Enterprise System 2005Q1 enthaltene Version aktualisieren.

Umgehung
Die Versionen SUNWtlsu und SUNWtlsux im Lieferumfang von Java Enterprise System Sun Java System k�nnen Sie aus den Message Queue 3 2005Q1 Platform Edition-Bundles auf der Sun Java System-Website erhalten. Nach dem Download der Message Queue-Dateien, befolgen Sie die Anweisungen im Abschnitt „Installing Message Queue“ in Kapitel 2 „Solaris Installation“ des Handbuchs Message Queue Installation Guide. In Schritt 8 antworten Sie n (Nein) und fahren mit Schritt 9 fort. So installieren Sie nur die Pakete SUNWtlsu und SUNWtlsux auf Ihrem System.

Kompatibilit�t

In diesem Abschnitt werden Kompatibilit�tsprobleme von Message Queue 3 2005Q1 (3.6) behandelt.

Probleme in Message Queue 3 2005Q1 (3.6)

In den folgenden Abschnitten werden Probleme behandelt, die folgende Plattformen betreffen: alle Plattformen, Solaris- und Linux-Plattformen und nur Linux-Plattformen.

Alle Plattformen

Oberfl�chenstabilit�t     Sun Java System Message Queue verwendet viele Oberfl�chen, mit deren Hilfe ein Administrator Aufgaben automatisieren kann. In Anhang B des Handbuchs Message Queue Administration Guide werden diese Oberfl�chen nach ihrer Stabilit�t eingeordnet. Je stabiler eine Oberfl�che ist, umso geringer ist die Wahrscheinlichkeit, dass sie sich in folgenden Produktversionen ver�ndert.

Verwerfen von Passwortoptionen     Folgende Optionen wurden aus Sicherheitsgr�nden verworfen:

-p
-password
-dbpassword
-ldappassword

Wenn ein Passwort als Teil eines Befehls, wie dem folgenden, angegeben wird:

imqcmd query bkr -u admin -p adminpassword

k�nnte ein Benutzer das Administratorpasswort sehen, w�hrend Computerprozesse belauscht oder abgefragt werden (z. B. mit ps auf Solaris).

Verwenden Sie stattdessen die Option -passfile. Die Option „passfile“ wird im Kapitel zur Sicherheit im Handbuch Message Queue Administration Guide genauer erl�utert.

Solaris- und Linux-Plattformen

JDK 1.3 Client-Unterst�tzung     Folgende Pakete enthalten jar-Dateien zur Unterst�tzung von JNDI und JSSE zur Client-Entwicklung und zum Client-Einsatz auf JDK 1.3. Diese Pakete sind nur im Lieferumfang von Message Queue Platform Edition enthalten. In zuk�nftigen Versionen sind diese Pakete nicht mehr enthalten. Diese Pakete werden nicht standardm��ig installiert:

SUNWiqsup – Solaris-Plattform
sun-mq-sup – Linux-Plattform

Weitere Informationen zur Installation und Konfiguration finden Sie im Handbuch Message Queue Installation Guide.

Linux-Plattformen

In diesem Abschnitt werden die �nderungen behandelt, die die Pakete und installierten Standorte auf der Linux-Plattform betreffen.

Neue Linux-Installationsstandorte     Der Standort der Message Queue-Installationsverzeichnisse wurde unter Linux ge�ndert.

Hinweis	Es gab keine �nderungen in Bezug auf die Installationsverzeichnisse zwischen Message Queue 3 2005Q1 (3.6) und Message Queue 3 2005Q4 (3.6 SP3).

In der Tabelle 11 sehen Sie die Standardinstallationsverzeichnisse f�r Message Queue-RPMs unter Linux.

Tabelle 11  Standardinstallationsverzeichnis f�r Message Queue 3 2005Q1-RPMs

RPM-Paktetname	Standardinstallationsverzeichnis
sun-mq-config	/etc/opt/sun
sun-mq-var	/var/opt/sun
alle anderen RPMs	/opt/sun

Genauere Informationen finden Sie unter „Operating System-Specific Locations of Message Queue Data“ im Handbuch Message Queue Administration Guide.

Ge�nderte Linux RPM-Paketnamen     Die Namen der Message Queue Linux RPM-Paketdateien wurden ge�ndert.

Hinweis	Es gab keine �nderungen in Bezug auf die Namen der Message Queue Linux RPM-Paketnamen zwischen der Version Message Queue 3 2005Q1und Message Queue 3 2005Q4.

Tabelle 12 zeigt die neuen Namen der Message Queue 3 2005Q1-Linux RPM-Pakete.

Tabelle 12  RPM-Pakete im Linux-Bundle 

RPM	Beschreibung	Hinweise
sun-mq-config	/etc-Dateien
sun-mq-var	/var-Dateien
sun-mq	/opt-Dateien	H�ngt von sun-javahelp, sun-mq-jmsclient, sun-mq-config und sun-mq-var ab.
sun-mq-ent	Enterprise Edition-Lizenzdatei.	Dieses RPM ist nur im Lieferumfang der Message Queue Enterprise Edition als Teil des Java Enterprise System enthalten.
sun-mq-jaxm	Message Queue Java API f�r XML-Messaging (JAXM): API	H�ngt von sun-saaj ab.
sun-mq-jmsclient	JMS: API und Runtime	Keine Abh�ngigkeiten
sun-mq-xmlclient	XML-Client	H�ngt von sun-jmsclient und sun-saaj ab.
sun-mq-capi	C-API	H�ngt von sun-nspr, sun-nss ab.
sun-mq-compat	Symlinks auf 3.5-Standorte.	H�ngt von sun-mq ab. Dieses RPM wird nicht standardm��ig installiert. Hinweis: Dieses Paket ist nur erforderlich, wenn Ihre vorhandenen Clients abh�ngig sind von Message Queue 3.5-Dateistandorten.
sun-mq-sup	Erforderlich zur Unterst�tzung von JDK 1.3.	H�ngt von sun-mq ab. Dieses RPM wird nicht standardm��ig installiert. Hinweis: Dieses Paket ist nur im Lieferumfang von Message Queue Platform Edition enthalten.
sun-mq-[locale]	L10N-Dateien
sun-javahelp1	JavaHelp: API und Runtime	Unterst�tzt den JavaHelp-Betrachter f�r die Hilfe der Administration Console.
sun-nss1	Network Security Services (NSS)-Bibliotheken.	Erforderlich zur Unterst�tzung der C-Language-Clients.
sun-nspr1	Netscape Portable Runtime (NSPR)-Bibliotheken	Erforderlich zur Unterst�tzung der C-Clients.
sun-saaj1	SOAP mit Anhangs-API f�r Java: API und Runtime	Erforderlich zur Unterst�tzung von Java-Clients mit SOAP/JAXM API
sun-jaxp1	Message Queue Java API f�r XML-Verarbeitung (JAXP): API und Runtime	Erforderlich zur Unterst�tzung von Java-Clients mit SOAP/JAXM API
sun-javamail1	JavaMail: API und Runtime	Erforderlich zur Unterst�tzung von Java-Clients mit SOAP/JAXM API
sun-jaf1	JavaBeans Activation Framework: API und Runtime	Erforderlich zur Unterst�tzung von Java-Clients mit SOAP/JAXM API

1Auf dieses RPM-Paket wird von einer Reihe von Sun Java System-Produkten aus zugegriffen. Es ist im Lieferumfang von Message Queue Platform Edition in der Verteilung aber nicht im Lieferumfang von Message Queue Enterprise Edition enthalten.

Symlinks-Paket f�r 3.5-Clients     Die Standorte einzeln als Teil von Message Queue installierter Dateien wurden unter Linux ge�ndert. Dadurch kann es zu Problemen mit Anwendungen kommen, die sich auf den urspr�nglichen Standort einiger Message Queue-Dateien beziehen. Wenn Ihre Clients beispielsweise Skripten verwenden, um nach jar-Dateien zu suchen, die mit Message Queue 3.5 installiert wurden, k�nnen diese Clients die Dateien nicht mehr finden.

Dieses Problem beheben Sie mit dem in dieser Version enthaltenen Linux-Paket sun-mq-compat. Dieses Paket installiert Symlinks von Message Queue 3.5-Dateistandorten auf die installierten Message Queue 3 2005Q1 (3.6) -Dateistandorte. Dieses Paket ist in k�nftigen Versionen m�glicherweise nicht mehr enthalten. Alle Skripten, die sich auf fr�here Standorte von Message Queue-Dateien beziehen, sollten bearbeitet werden.

Das Paket sun-mq-compat befindet sich in den folgenden Verzeichnissen.

Message Queue Platform Edition-Verteilung:
Wenn Sie die Verteilung dekomprimieren, wird das Verzeichnis rpms erstellt.
Message Queue Enterprise Edition (im Lieferumfang der Java Enterprise System-Verteilung enthalten):
Linux_x86/Product/message_queue/Packages

  So installieren Sie das sun-mq-compat-Paket

Melden Sie sich als Root-Benutzer an.
Rufen Sie vom rpm-Paketverzeichnis aus folgenden Befehl auf:

rpm -ivh --nodeps sun-mq-compat-3.6-<Versionsnr.>.i386.rpm

Probleme mit der n�chsten gr��eren Version von Message Queue

Die n�chste gr��ere Version von Message Queue beinhaltet eventuell �nderungen, die eine Inkompatibilit�t mit Ihren Clients verursachen k�nnen. Wir teilen Ihnen diese Informationen jetzt mit, um Sie auf diese �nderungen vorzubereiten.

Dies ist die letzte Funktionsversion von Sun Java System Message Queue, die mit Sun One Message Queue 3.0.1 abw�rtskompatibel ist. Insbesondere zuk�nftige Versionen von Sun Java System Message Queue unterst�tzen Folgendes nicht:
Verbindung von 3.0.1-Clients mit Brokern der neuesten Version
Aktualisierung eines 3.0.1-Speichers auf die neueste Version
Clustering von 3.0.1-Brokern mit Brokern der neuesten Version
Verwendung von 3.0.1-Eigenschaftsdateien, Benutzerspeichern und Zugriffssteuerungslisten usw. mit Brokern der neuesten Version
Dies ist die letzte Version von Sun Java System Message Queue, die als „System JMS Messaging Provider“ f�r Sun Java System Application Server 7.X integriert werden kann. Zuk�nftige Versionen von Sun Java System Message Queue unterst�tzen nur Sun Java System Application Server 8.0 und h�her.
Dies ist die letzte Version von Sun Java System Message Queue, die die SOAP-Runtime einschlie�t und verwaltete Message Queue SOAP-Objekte unterst�tzt.
Zuk�nftige Versionen unterst�tzen SOAP nur gemeinsam mit einer Java 2 Standard Edition Platform-Version, die SOAP unterst�tzt.
Sun Java System Message Queue-Client-Unterst�tzung f�r alle Versionen von Java 2 Standard Edition 1.3 besteht nicht mehr. Java 2 Standard Edition 1.4 wird weiterhin unterst�tzt.
Die Standorte einzelner Dateien, die als Teil von Sun Java System Message Queue installiert wurden, �ndern sich m�glicherweise. Dadurch k�nnen in vorhandenen Anwendungen Fehler auftreten, die vom aktuellen Standort bestimmter Message Queue-Dateien abh�ngen.
Sun Java System Message Queue -Clients, die eine �ltere Message Queue-Version als die n�chste Vollversion verwenden, k�nnen daher eventuell nicht auf die neuen Funktionen dieser Produktversion zugreifen.

Aktualisierungen der Dokumentation f�r Message Queue

In den folgenden Abschnitten werden die Aktualisierungen f�r die Dokumentation f�r Message Queue 3 2005Q1 (3.6) und Message Queue 3 2005Q4 (3.6 SP3) beschrieben.

Aktualisierung der Dokumentation f�r Message Queue 3 2005Q1 (3.6)
Aktualisierung der Dokumentation f�r Message Queue 3 2005Q4 (3.6 SP3)

Aktualisierung der Dokumentation f�r Message Queue 3 2005Q1 (3.6)

Die folgenden Message Queue-Dokumente wurden von der Produktversion 3.5 aktualisiert:

Installation Guide

Das Handbuch Message Queue Installation Guide wurde aktualisiert und enth�lt jetzt �nderungen bei Marken und plattformspezifische Informationen. Dieses Dokument enth�lt jetzt alle Installationsinformationen f�r Message Queue Platform Edition.

Die Installationsinformationen f�r Message Queue, Enterprise Edition wurden in das Handbuch Sun Java SystemInstallation Guide aufgenommen.

Genauere Informationen zum Upgrade und der Migration auf Message Queue 3 2005Q1 (3.6) Enterprise Edition finden Sie im Handbuch Sun Java SystemUpgrade and Migration Guide.

Technische �bersicht

Message Queue Technical Overview ist ein neues Dokument, das mit der Version Message Queue 3 2005Q1 (3.6) eingef�hrt wurde. Es wurde f�r die Version Message Queue 3 2005Q4 (3.6 SP3) neu verfasst. In ihm werden das Message Queue-Produkt, seine Funktionen, die Architektur, Technologie und Terminologie beschrieben. Dieses neue Handbuch enth�lt Informationen, die vorher in anderen Handb�chern enthalten waren, und ist f�r Benutzer von Message Queue gedacht – f�r Administratoren und Entwickler – sowie f�r Benutzer ohne Vorkenntnisse.

Administration Guide

Das Handbuch Message Queue Administration Guide wurde aktualisiert. Es enth�lt jetzt �nderungen bei Marken und neue Funktionen. Dieses Dokument wurde auch neu gegliedert, damit es von Message Queue-Administratoren besser genutzt werden kann. Die bisher in diesem Dokument enthaltenen �bersichtsinformationen wurden in das Dokument Message Queue Technical Overview �bernommen.

Message Queue Developer’s Guide for Java Clients

Das Handbuch Java Client Developer’s Guide wurde aktualisiert. Es enth�lt jetzt �nderungen bei Marken und neue Funktionen. Das Dokument wurde au�erdem umbenannt in Message Queue Developer’s Guide for Java Clients.

Das Handbuch Message Queue Developer’s Guide for Java Clients wurde neu gegliedert, damit es von Message Queue Java Client-Entwicklern besser genutzt werden kann. Die bisher in diesem Dokument enthaltenen �bersichtsinformationen wurden in das Dokument Message Queue Technical Overview �bernommen.

C Client Developer’s Guide

Das Handbuch C Client Developer’s Guide wurde aktualisiert. Es enth�lt jetzt �nderungen bei Marken und neue Funktionen. Das Dokument wurde au�erdem umbenannt in Message Queue Developer’s Guide for C Clients.

Das Handbuch Message Queue Developer’s Guide for C Clients wurde neu gegliedert, damit es von Message Queue C-Client-Entwicklern besser genutzt werden kann. Die bisher in diesem Dokument enthaltenen �bersichtsinformationen wurden in das Dokument Message Queue Technical Overview �bernommen.

Aktualisierung der Dokumentation f�r Message Queue 3 2005Q4 (3.6 SP3)

Die folgenden Message Queue-Dokumente wurden von der Produktversion 3 2005Q1 (3.6) aktualisiert:

Installation Guide

Das Handbuch Message Queue Installation Guide wurde aktualisiert und spiegelt jetzt die �nderungen im Bezug auf die Installation des Produkts wider, die seit der Version Message Queue 3 2005Q1 (3.6) eingef�hrt wurden.

Technische �bersicht

Message Queue Technical Overview ist ein neues Dokument, das mit der Version Message Queue 3 2005Q1 (3.6) eingef�hrt wurde. Es wurde f�r die Version Message Queue 3 2005Q4 (3.6 SP3) neu verfasst. In ihm werden das Message Queue-Produkt, seine Funktionen, die Architektur, Technologie und Terminologie beschrieben. Dieses neue Handbuch enth�lt Informationen, die vorher in anderen Handb�chern enthalten waren, und ist f�r Benutzer von Message Queue gedacht – f�r Administratoren und Entwickler – sowie f�r Benutzer ohne Vorkenntnisse.

Administration Guide

Das Handbuch Message Queue Administration Guide wurde neu gegliedert, damit es von Message Queue-Administratoren besser genutzt werden kann. Die bisher in diesem Dokument enthaltenen �bersichtsinformationen wurden in das Dokument Message Queue Technical Overview �bernommen.

Message Queue Developer’s Guide for Java Clients

Das Handbuch Message Queue Developer’s Guide for Java Clients enht�lt ein neues Kapitel: “Using the Java API”.

---

Bekannte Probleme und Einschr�nkungen

Dieser Abschnitt enth�lt eine Liste der bekannten Probleme in Message Queue 3 2005Q1 (3.6). Die folgenden Produktbereiche werden besprochen:

Allgemeine Probleme
Probleme bei der Verwaltung/Konfiguration
Broker-Probleme

F�r eine Liste der aktuellen Fehler, deren Status und Umgehungsm�glichkeiten sollten Mitglieder der Java Developer Connection™ die Bug Parade der Java Developer Connection-Website besuchen. Besuchen Sie diese Seite, bevor Sie einen neuen Fehler melden. Auch wenn nicht alle Message Queue-Fehler aufgelistet sind, ist diese Seite ein guter Ausgangspunkt, wenn Sie feststellen m�chten, ob ein Problem bekannt gegeben wurde.

Die Adresse der Seite lautet wie folgt:

http://developer.java.sun.com/developer/bugParade

Hinweis	Die Mitgliedschaft bei der Java Developer Connection ist kostenlos, aber es ist eine Registrierung erforderlich. Auf der Sun Java System-Webseite „For Developers“ wird beschrieben, wie Sie Mitglied bei der Java Developer Connection werden.

Wenn Sie einen neuen Fehler melden oder eine Funktionsanfrage einreichen m�chten, senden Sie eine E-Mail an imq-feedback@sun.com.

Allgemeine Probleme

In diesem Abschnitt werden allgemeine Probleme von Message Queue 3 2005Q1 (3.6) behandelt. Einige wurden durch vorherige Versionen von Message Queue eingef�hrt. Die in diesem Abschnitt erl�uterten Probleme sind in Gruppen zusammengefasst, je nachdem, ob sie auf beide oder nur auf die Enterprise Edition von Message Queue zutreffen.

Enterprise und Platform Edition

In Message Queue 3 2005Q1 wird die Beispielkonfiguration f�r einen Broker unter Verwendung eines LDAP-Servers als Benutzer-Repository im Kommentarbereich der Datei config.properties angezeigt. Das Beispiel f�r das LDAP-Benutzer-Repository in der Datei default.properties ist auskommentiert.

Wenn Sie sich bisher auf einen Eigenschaftswert der Beispiel-LDAP-Benutzer-Repository-Eigenschaften in der Datei default.properties verlassen haben, erh�lt Ihr JMS-Anwendungs-Client einen Sicherheitsausnahmefehler beim Versuch eine JMS-Verbindung herzustellen. Das passiert nach dem Upgrade auf Message Queue 3 2005Q1.

Wenn Ihr JMS-Client versucht, eine Verbindung mit dem Message Queue 3 2005Q1-Broker herzustellen, erhalten Sie einen Fehler im Broker-Protokoll und Ihr JMS-Client erh�lt folgenden Ausnahmefehler:

SecurityException.

20/Aug/2004:11:16:41 PDT] ERROR [B4064]: Ldap repository ldap property .uidattr not defined for authentication type basic:com.sun.messaging.jmq.auth.LoginException: [B4064]: Ldap repository ldap property .uidattr not defined for authentication type basic

Umgehung
Legen Sie die Broker-Eigenschaft imq.user_repository.ldap.uidattr nach den Anweisungen im Handbuch Message Queue Administration Guide fest.

Ein Fehler in RedHat Linux 2.1 (NSS-Fehlernr. 5078380) kann verursachen, dass die Methoden Message Queue C-API MQCreateConnection (Message Queue 3 2005Q1-C-API-Bibliothek) oder MQInitializeSSL Message Queue 3 2005Q1- oder 3.5 C-API-Bibliothek) h�ngen, falls ein Thread in der Message Queue C-API-Anwendung erstellt wurde, bevor diese beiden Methoden abgerufen werden.

Umgehung
Beim Verwenden der Message Queue 3 2005Q1-C-API-Bibliothek gibt es vier Optionen, um dieses Problem zu vermeiden:

Aktualisieren Sie auf RedHat Linux 3.0.
Setzen Sie die MQ_NSS_5078380_WORKAROUND-Umgebungsvariable vor dem Ausf�hren Ihrer Message Queue C-Client-Anwendung und setzen Sie die Message Queue Broker-Eigenschaft auf imq.authentication.type=basic.
Rufen Sie MQInistializeSSL(<cert-db-path>) ab, bevor Sie einen Thread in Ihrer Message Queue C-Client-Anwendung starten. Mit dem Dienstprogramm certutil erstellen Sie die Zertifikat-DB-Dateien.

Erstellen Sie eine Verbindung mit dem Message Queue-Broker, indem Sie MQCreateConnection abrufen, bevor Sie Threads starten. Die Konfigurationsdatei f�r eine Broker-Instanz kann nicht bearbeitet werden, ohne dass die Broker-Instanz mindestens ein Mal gestartet wurde. Der Grund hierf�r besteht darin, dass die Datei config.properties erst erstellt wird, wenn die Broker-Instanz das erste Mal gestartet wird. Wenn Sie einen Broker f�r die Verwendung austauschbarer Persistenz konfigurieren oder andere Konfigurationseigenschaften festlegen m�chten, f�hren Sie den Broker ein Mal aus (mit dem Namen der Instanz, der zum Erstellen des Brokers verwendet werden soll), um die Datei config.properties zu erstellen:

Plattform	Standort
Solaris	/var/imq/instances/instanceName/props/config.properties
Linux	/var/opt/sun/mq/instances/instanceName/props/config.properties
Windows	IMQ_VARHOME\instances\instanceName\props\config.properties

Nachdem die Datei config.properties erstellt wurde, bearbeiten Sie sie, um beliebige Werte f�r Konfigurationseigenschaften hinzuzuf�gen, und starten Sie anschlie�end den Broker neu.

Nur Enterprise Edition

In dieser Version werden lediglich vollst�ndig verbundene Broker-Cluster unterst�tzt. Dies bedeutet, dass jeder Broker in einem Cluster direkt mit allen anderen Brokern im Cluster kommunizieren muss. Wenn Sie Broker mithilfe des Befehlszeilenarguments imqbrokerd -cluster verbinden, stellen Sie sicher, dass alle Broker im Cluster enthalten sind.
Ein Client, der mit einem Broker verbunden ist, der Teil eines Clusters ist, kann QueueBrowser nicht zum Durchsuchen von Warteschlangen nutzen, die sich auf Remote-Brokern in diesem Cluster befinden. Der Client kann nur die Warteschlangeninhalte durchsuchen, die sich auf dem Broker befinden, mit dem er direkt verbunden ist. Der Client sendet eventuell noch Meldungen an eine beliebige Warteschlange oder erh�lt Meldungen von einer Warteschlange oder einem Broker im Cluster. Die Einschr�nkung betrifft nur das Durchsuchen.
Wird im Broker-Cluster kein Master-Broker verwendet, werden persistente Informationen, die in einem Broker gespeichert sind, der dem Cluster neu hinzugef�gt wird, nicht an die anderen Broker im Cluster weitergegeben.
Ein Verbindungsdienst, der SSL verwendet, ist derzeit auf die Unterst�tzung von selbstsignierten Serverzertifikaten eingeschr�nkt, d. h. auf den beglaubigten Hostmodus.
Wird ein JMS-Client bei Verwendung des http-Transports pl�tzlich beendet (z. B. durch den Befehl Strg-C), ben�tigt der Broker etwa eine Minute, bevor die Clientverbindung und alle damit zusammenh�ngenden Ressourcen freigegeben werden.

Wird innerhalb dieses Zeitraums eine andere Instanz des Clients gestartet, die versucht, dieselbe ClientID, Warteschlange oder dasselbe dauerhafte Abonnement zu verwenden, wird m�glicherweise der Ausnahmefehler „Client-ID ist bereits in Verwendung“ gemeldet. Dies stellt jedoch kein Problem dar, es handelt sich lediglich um eine Nebenwirkung des vorangehend beschriebenen Beendigungsvorgangs. Wenn der Client nach etwa einer Minute gestartet wird, sollte kein Fehler gemeldet werden.

Probleme bei der Verwaltung/Konfiguration

Die Dienstprogramme imqadmin und imqobjmgr geben einen Fehler aus, wenn CLASSPATH doppelte Anf�hrungszeichen auf Windows-Computern enth�lt (Fehler-ID 5060769).

Umgehung
Sie k�nnen diese Fehlermeldung ignorieren. Der Broker informiert die Konsumenten korrekt �ber m�gliche Fehler. Dieser Fehler hat keine Auswirkungen auf die Zuverl�ssigkeit des Systems.

Die Option -javahome in allen solaris/win-Skripten funktioniert nicht, wenn der Wert ein Leerzeichen enth�lt (Fehler-ID 4683029).

Die Option -javahome wird von den Message Queue-Befehlen und -Programmen verwendet, um eine alternative Java 2-kompatible Runtime anzugeben. Der Pfad zur alternativen Java-Runtime darf jedoch keine Leerzeichen enthalten.

Beispiele f�r Pfade, die Leerzeichen enthalten:

     Windows:
     C:\jdk 1.4

     Solaris:
     /work/java 1.4

Umgehung
Installieren Sie die Java Runtime an einem Speicherort oder unter einem Pfad, der keine Leerzeichen enth�lt.

Message Queue Ausgabe �berfl�ssiger Meldung an Systemprotokoll in Nicht-C-Umgebung (Fehler-ID 6193884)

Message Queue sendet �berfl�ssige Ausgabe an das Systemprotokoll, wenn der Broker in einer Nicht-C-Umgebung ausgef�hrt wird.

Umgehung
F�hren Sie den Broker in einer C-Umgebung aus.

Broker-Probleme

In einem Broker-Cluster werden die Meldungen an eine entfernte Verbindung, die eventuell noch nicht gestartet wurde, in die Warteschlange gestellt (Fehler-ID 4951010).

Umgehung
Der Konsument erh�lt die Meldungen, sobald die Verbindung gestartet wurde. Die Meldungen werden an einen anderen Konsumenten gesendet, wenn die Verbindung beendet wird.

HTTPS createQueueConnection verursacht zuweilen einen Ausnahmefehler unter Windows 2000 (Fehler-ID 4953348).

Umgehung
Versuchen Sie eine erneute Verbindung.

Wenn Sie den Broker mit der Tastenkombination STRG+C beenden, werden die Transaktionen nach dem Schlie�en des Speichers eventuell bereinigt (Fehler-ID 4934446).

Der Broker meldet eventuell Fehler mit folgender Begr�ndung „Zugriff auf Speichermethode nach dem Schlie�en des Speichers.“, wenn der Broker heruntergefahren wird, w�hrend Meldungen oder Transaktionen verarbeitet wurden.

Umgehung
Sie k�nnen diese Fehlermeldung ignorieren. Der Broker informiert die Konsumenten korrekt �ber m�gliche Fehler. Dieser Fehler hat keine Auswirkungen auf die Zuverl�ssigkeit des Systems.

Wenn der Persistenzspeicher zu viele Zielstandorte �ffnet, kann auf den Broker nicht mehr zugegriffen werden (Fehler-ID 4953354)

Umgehung
Diese Bedingung wird vom Broker verursacht, der das Deskriptor-Limit f�r die offenen Dateien im System erreicht. Unter Solaris und Linux erh�hen Sie das Dateideskriptor-Limit mit dem Befehl ulimit.

Konsumenten verwaisen, wenn ein Zielstandort vernichtet wird (Fehler-ID 5060787).

Aktive Konsumenten verwaisen, wenn ein Zielstandort vernichtet wird. Sobald die Konsumenten verwaist sind, erhalten sie keine Meldungen mehr (auch wenn der Zielstandort erneut erstellt wird).

Umgehung
F�r dieses Problem gibt es keine Umgehung.

Die Meldungsauswahl mit JMSMessageID funktioniert nicht (Fehler-ID 6196233).

Die Meldungsauswahl mit dem Selektor „JMSMessageID = '<message_id>'“ funktioniert nicht.

Senden Sie eine Meldung in eine Warteschlange.
Lesen Sie die JMSMessageID der gesendeten Meldung – <message_id>
Erstellen Sie einen Konsumenten f�r die Warteschlange, indem Sie den Selektor auf „JMSMessageID = '<message_id>'“ setzen.

Die Meldung wird nicht empfangen.

Umgehung
�ndern Sie den Selektor von:

JMSMessageID = "ID:message-id-string"

in:

JMSMessageID IN ('ID:message-id-string', 'message-id-string')

Message Queue QueueBrowser zeigt ebenfalls nicht �bernommene Meldungen (Fehler-ID 6264003)

Beim Durchsuchen des Inhalts einer Warteschlange werden Meldungen, die in einer Transaktion erstellt, jedoch noch nicht �bernommen wurden, m�glicherweise in der QueueBrowser-Aufz�hlung angezeigt.

Umgehung
F�r dieses Problem gibt es keine Umgehung.

---

Dateien f�r Neuverteilung

Sun Java System Message Queue 3 2005Q1 (3.6) enth�lt folgende Dateien, die in bin�rer Form verwendet und frei verteilt werden d�rfen:

jms.jar
imq.jar
imqxm.jar
fscontext.jar
providerutil.jar
jndi.jar
ldap.jar
ldapbp.jar
jaas.jar
jsse.jar
jnet.jar
jcert.jar
Au�erdem k�nnen Sie die Dateien LICENSE und COPYRIGHT ebenfalls neu verteilen.

---

Eingabehilfen f�r Benutzer mit Behinderungen

Informationen zu Eingabehilfen, die seit der Ver�ffentlichung dieses Mediums herausgegeben wurden, finden Sie in Abschnitt 508 der Produktbeurteilungen, die Sie bei Sun auf Anfrage erhalten. Sie k�nnen hiermit ermitteln, welche Versionen sich am besten f�r die Bereitstellung zug�nglicher L�sungen eignen. Aktualisierte Versionen der Anwendungen erhalten Sie unter: http://sun.com/software/javaenterprisesystem/get.html.

Informationen zum Einsatz von Sun im Bereich Eingabehilfen erhalten Sie unter http://sun.com/access.

---

Problemmeldungen und Feedback

Wenn Sie mit Sun Java System Message Queue Probleme haben, wenden Sie sich an die Kundenunterst�tzung von Sun. Dazu stehen Ihnen folgende M�glichkeiten zur Verf�gung:

Sun-Softwaresupport unter:
http://www.sun.com/service/sunone/software

Auf dieser Website finden Sie Links zur Knowledge Base, zum Online Support Center, zum ProductTracker wie auch zu Wartungsprogrammen und Kontaktinformationen f�r die Kundenunterst�tzung.

Die auf Ihrem Wartungsvertrag angegebene Telefonnummer.

Wenn Sie sich an die Kundenunterst�tzung wenden, halten Sie bitte die folgenden Informationen bereit, damit wir Sie optimal beraten k�nnen:

Beschreibung des Problems, einschlie�lich der Situation, in der das Problem auftrat, sowie seine Auswirkungen auf Ihre Arbeit.
Rechnertyp, Betriebssystem- und Produktversion, einschlie�lich s�mtlicher Patches und anderer Software, die mit dem Problem in Zusammenhang stehen k�nnten.
Detaillierte Schritte zu den von Ihnen f�r die Reproduktion des Problems verwendeten Methoden.
S�mtliche Fehlerprotokolle oder Kernspeicherausz�ge.

Sun Java System Softwareforum

Unter der nachfolgenden Adresse finden Sie ein Sun Java System Message Queue-Forum:

http://swforum.sun.com/jive/forum.jspa?forumID=24

Wir freuen uns �ber Ihre Teilnahme.

Java Technology Forum

Unter dem Java Technology Forum finden Sie m�glicherweise ein f�r Sie interessantes JMS-Forum.

http://forum.java.sun.com

---

Kommentare sind willkommen

Sun m�chte seine Dokumentation laufend verbessern. Ihre Kommentare und Vorschl�ge sind daher immer willkommen.

Zum Mitteilen Ihrer Kommentare rufen Sie http://docs.sun.com auf und klicken Sie auf „Send Comments“. Geben Sie im Online-Formular den Dokumenttitel und die Teilenummer an. Die Teilenummer ist eine 7-stellige oder 9-stellige Zahl, die Sie auf der Titelseite des Handbuchs oder am Anfang des Dokuments finden. Der Buchtitel dieses Handbuchs lautet beispielsweise Sun Java System Message Queue 3 2005Q4 Versionshinweise und hat die Teilenummer 819-3558.

---

Weitere Informationen �ber Sun

N�tzliche Informationen �ber Sun Java System finden Sie unter den folgenden Internet-Adressen:

Dokumentation zu Message Queue
http://docs.sun.com/coll/1307.1
Sun Java System-Dokumentation
http://docs.sun.com/prod/java.sys
Professionelle Dienste von Sun Java System
http://www.sun.com/service/sunps/sunone
Sun Java System-Softwareprodukte und -Dienste
http://www.sun.com/software
Sun Java System-Softwaresupport
http://www.sun.com/service/sunone/software
Sun Java System-Support und Knowledge Base
http://www.sun.com/service/support/software
Sun-Support und -Schulungen
http://training.sun.com
Sun Java System-Beratung und professionelle Dienste
http://www.sun.com/service/sunps/sunone
Sun Java System-Informationen f�r Entwickler
http://developers.sun.com
Sun-Supportdienste f�r Entwickler
http://www.sun.com/developers/support
Sun Java System-Softwareschulungen
http://www.sun.com/software/training
Sun-Softwaredatenbl�tter
http://wwws.sun.com/software

---

Copyright � 2005 Sun Microsystems, Inc. Alle Rechte vorbehalten.

Sun Microsystems, Inc. hat Rechte in Bezug auf geistiges Eigentum an der Technologie, die in dem in diesem Dokument beschriebenen Produkt enthalten ist. Diese Urherberrechte k�nnen insbesondere und ohne Einschr�nkungen eines oder mehrere der unter http://www.sun.com/patents aufgelisteten US-Patente und weitere Patente oder angemeldete Patente in den USA und anderen L�ndern einschlie�en.

SUN URHEBERRECHTLICH/VERTRAULICH.

Rechte der US-Regierung – Kommerzielle Software. Regierungsbenutzer unterliegen der standardm��igen Lizenzvereinbarung von Sun Microsystems, Inc. sowie den anwendbaren Bestimmungen der FAR und ihrer Zus�tze.

Die Verwendung unterliegt Lizenzbestimmungen.

Diese Ausgabe kann von Drittanbietern entwickelte Bestandteile enthalten.

Sun, Sun Microsystems, das Sun-Logo, Java, Solaris und Sun[tm] ONE sind Marken oder eingetragene Marken von Sun Microsystems, Inc. in den USA und anderen L�ndern.

Alle SPARC-Warenzeichen werden unter Lizenz verwendet und sind Warenzeichen oder eingetragene Warenzeichen von SPARC International, Inc. in den USA und anderen L�ndern.

UNIX ist ein eingetragenes Warenzeichen in den USA und in anderen L�ndern und exklusiv durch X/Open Company, Ltd. lizenziert.