Sun Java System Message Queue Notes de version

Version 3 2005Q4 (3.6 SP3)

R�f�rence 819-3557

Ces notes de version contiennent des informations importantes connues au moment de la commercialisation de Sun Java™ System Message Queue 3 2005Q4 (3.6 SP3). Ce document inclut �galement le contenu des notes de version de Sun Java™ System Message Queue 3 2005Q1 (3.6) pour les clients qui effectuent une mise � niveau depuis des versions pr�c�dentes de Message Queue 3 2005Q1. Vous y trouverez des renseignements sur les nouvelles fonctionnalit�s, les am�liorations, les restrictions et probl�mes connus, etc. Prenez connaissance de ce document avant d’utiliser Message Queue.

Vous trouverez la derni�re version de ces notes de version sur le site Web de la documentation Sun Java System Message Queue � l’adresse : http://docs.sun.com/coll/1307.1. Consultez ce site Web avant d’installer et de configurer votre logiciel, puis r�guli�rement pour vous procurer la documentation concernant le produit et les notes de mise � jour les plus r�centes.

Ces notes de version comprennent les sections suivantes :

Historique de r�vision des notes de version
À propos de Message Queue 3 2005Q4 (3.6 SP3)
Bogues r�solus dans la pr�sente version
Informations importantes
Probl�mes connus et restrictions
Fichiers redistribuables
Fonctions d’accessibilit� destin�es aux personnes handicap�es
Comment signaler des probl�mes et apporter des commentaires
Ressources Sun suppl�mentaires

Des adresses URL de sites tiers, qui renvoient � des informations compl�mentaires connexes, sont r�f�renc�es dans ce document.

Remarque	Sun d�cline toute responsabilit� quant � la disponibilit� des sites tiers mentionn�s. Sun ne garantit pas le contenu, la publicit�, les produits et autres mat�riaux disponibles sur ces sites ou dans ces ressources, ou accessibles par leur interm�diaire, et ne saurait en �tre tenu pour responsable. Par ailleurs, la responsabilit� de Sun ne saurait �tre engag�e en cas de dommages ou de pertes, r�els ou suppos�s, occasionn�s par, ou li�s �, l’utilisation du contenu, des produits ou des services disponibles sur ces sites ou dans ces ressources, ou accessibles par leur biais, ou encore � la confiance qui a pu leur �tre accord�e.

---

Historique de r�vision des notes de version

Tableau 1  Historique de r�vision 

Date	Description des modifications
26 ao�t 2005	Mise � jour du document À propos de Message Queue 3 2005Q4 (3.6 SP3). Mise � jour du document Mises � jour de la documentation de Message Queue 3 2005Q4 (3.6 SP3) Mise � jour du document Configurations mat�rielle et logicielle requises pour Message Queue 2005Q4 (3.6 SP3). Ajout des bogues r�solus pour Message Queue 3 2005Q4 (3.6 SP3) dans le document Bogues r�solus dans la pr�sente version.
28 juin 2005	Ajout des bogues r�solus pour Message Queue 3 2005Q1 (3.6 SP1) et Message Queue 32005Q4 (3.6 SP2) dans le document Bogues r�solus dans la pr�sente version.
1er mai 2005	Mise � jour de la section Probl�mes relatifs � la prochaine version majeure de Message Queue. Ajout d’une instruction Stabilit� de l’interface dans la section Compatibilit�.
24 janvier 2005	Mise � jour avec la version finale de Sun Java System Message Queue 3 2005Q1 et Java Enterprise System 2005Q1.
8 novembre 2004	Premi�re version des Sun Java System Notes de version de Message Queue.

---

À propos de Message Queue 3 2005Q4 (3.6 SP3)

Message Queue 3 2005Q4 (3.6 SP3) est une mise � jour des bogues r�solus de Message Queue 3 2005Q1 (3.6). Il contient toutes les r�solutions des versions 3.6 SP2 et 3.6 SP1, ainsi que des nouvelles mises � jour de la documentation.

Message Queue 3 2005Q1 (3.6)

Sun Java System Message Queue est un service de messagerie complet fournissant des fonctions de messagerie fiables et asynchrones conformes � la sp�cification Java Messaging Specification (JMS) 1.1. En outre, Message Queue propose un ensemble de fonctions d�passant le cadre de la sp�cification JMS afin de prendre en charge les d�ploiements d’entreprise � grande �chelle.

Cette section inclut :

Nouveaut�s de cette version
Configurations mat�rielle et logicielle requises

Nouveaut�s de cette version

Message Queue 3 2005Q1 (3.6) offre notamment les nouvelles fonctionnalit�s suivantes :

Message Queue bloqu�
Mode sans accus� de r�ception
Compression du corps des messages du client
D�tection de l’�chec de connexion (Ping du programme d’ex�cution client)
Gestion des certificats : Outils NSS de C-API
Prise en charge de l’authentification de base pour l’interface C-API
Prise en charge de l’interface C-API 64 bits

Ces fonctionnalit�s sont d�crites dans les sous-sections suivantes :

Message Queue bloqu�

Message Queue cr�e automatiquement une destination sp�ciale au d�marrage du courtier, utilis�e pour stocker les messages bloqu�s � des fins de diagnostic. Un message bloqu� est un message qui est supprim� du syst�me en dehors du traitement normal ou de l’action explicite d’un administrateur. Un message peut �tre consid�r� comme bloqu� parce qu’il a expir�, qu’il a �t� supprim� d’une destination en raison d’une insuffisance de m�moire ou parce qu’il n’a pu �tre livr� apr�s plusieurs tentatives.

Un administrateur peut configurer les destinations de sorte que les messages bloqu�s soient supprim�s ou qu’ils soient plac�s dans une file d’attente. Lorsqu’ils sont plac�s dans la file d’attente, des informations de propri�t� suppl�mentaires sont �crites dans le message, renseignant l’administrateur sur la cause du blocage. Un d�veloppeur client peut �galement d�finir une valeur de propri�t� lors de la cr�ation d’un message, de sorte � placer directement le message dans la file d’attente des messages bloqu�s s’il venait � �tre bloqu�.

Pour plus d’informations, voir Message Queue Administration Guide.

Mode sans accus� de r�ception

Le mode d’accus� de r�ception NO_ACKNOWLEDGE est une extension de l’API JMS. En principe, le courtier attend l’accus� de r�ception d’un client. Cet acquittement doit �tre effectu� par le programme si le client est d�fini sur le mode CLIENT_ACKNOWLEDGE ou automatiquement, par la session, s’il est d�fini sur AUTO_ACKNOWLEDGE ou DUPS_OK. Si un client est d�fini sur le mode NO_ACKNOWLEDGE, le courtier ignore le message d�s que ce dernier a �t� envoy� au client. Cette fonctionnalit� est r�serv�e en premier lieu aux abonn�s non durables consommant des messages non persistants, mais elle peut �galement servir � tout autre consommateur.

Cette fonction permet d’accro�tre les performances en limitant le trafic de gestion de protocole et le travail du courtier impliqu�s dans l’acquittement d’un message. Elle permet �galement d’am�liorer les performances des courtiers traitant avec des clients au fonctionnement anormal qui n’accusent pas r�ception des messages et de ce fait, utilisent inutilement les ressources de m�moire du courtier. L’utilisation de ce mode n’a aucune incidence sur les producteurs.

Les clients C ne prennent pas en charge le mode NO_ACKNOWLEDGE. Pour plus d’informations, voir Message Queue Developer’s Guide for Java Clients.

Compression du corps des messages du client

Le d�veloppeur peut d�finir la compression du corps d’un message. Les op�rations de compression et de d�compression des messages sont enti�rement effectu�es par le programme client et n’affectent pas le courtier. Les applications peuvent donc utiliser cette fonction avec une version ant�rieure du courtier, mais doivent employer la version 3 2005Q1 (3.6) de la biblioth�que d’ex�cution du client Message Queue.

Avantages et limitations de la compression     Bien que la fonction de compression ait �t� ajout�e dans le but d’am�liorer les performances, ses b�n�fices ne sont pas syst�matiques. Ces derniers d�pendent en effet de la taille et du format des messages, du nombre de consommateurs, de la bande passante du r�seau et des performances de l’unit� centrale. Par exemple, le co�t induit par la compression et la d�compression peut se r�v�ler trop �lev� par rapport au temps que vous pouvez gagner dans la r�ception et l’envoi d’un message compress�. Cela se v�rifie tout particuli�rement lorsque vous envoyez des messages peu volumineux sur un r�seau haut d�bit. En revanche, la compression des messages peut constituer un avantage lorsqu’il s’agit d’envoyer des messages volumineux � plusieurs consommateurs ou de les publier dans un environnement r�seau lent.

Les consommateurs de messages d�ploy�s avec les biblioth�ques d’ex�cution clientes ant�rieures � la version 3 2005Q1 (3.6) ne peuvent pas traiter les messages compress�s. Pour les clients configur�s pour l’envoi de messages compress�s, il faut s’assurer de la compatibilit� des consommateurs. Actuellement, les clients C ne peuvent pas consommer de messages compress�s.

Pour plus d’informations, voir Message Queue Developer’s Guide for Java Clients.

D�tection de l’�chec de connexion (Ping du programme d’ex�cution client)

Message Queue 3 2005Q1 introduit un nouvel attribut ConnectionFactory nomm� imqPingInterval. L’attribut imqPingInterval sp�cifie la fr�quence de l’op�ration ping du programme client vers le courtier. En testant r�guli�rement la connexion, le programme client peut d�tecter de mani�re pr�ventive tout �chec de connexion. Si l’op�ration ping �choue, le programme client envoie une exception � l’objet module d’�coute des exceptions de l’application cliente. Si l’application ne comporte pas de module d’�coute des exceptions, sa tentative suivante de connexion �choue.

Pour plus d’informations, voir Message Queue Administration Guide.

Gestion des certificats : Outils NSS de C-API

L’interface C-API utilise les biblioth�ques NSS (Network Security Services) pour prendre en charge le protocole SSL. Ces biblioth�ques fournissent les API et les utilitaires permettant de d�velopper des applications s�curis�es. Les utilitaires incluent les outils de gestion des bases de donn�es des cl�s et des certificats. Dans Message Queue 3.5, les d�veloppeurs devaient utiliser Mozilla pour g�rer les certificats et cl�s NSS. Dans Message Queue 3 2005Q1, les administrateurs peuvent se servir de l’outil certutil NSS pour g�n�rer les certificats et cl�s n�cessaires.

Pour plus d’informations, voir Message Queue Developer’s Guide for C Clients.

Prise en charge de l’authentification de base pour l’interface C-API

L’interface C-API de Message Queue3 2005Q1 prend en charge le type d’authentification basic. Ce n’�tait pas le cas des pr�c�dentes versions de Message Queue.

Prise en charge de l’interface C-API 64 bits

Message Queue prend d�sormais en charge l’interface C-API 64 bits sur la plate-forme Solaris/SPARC. Pour plus d’informations sur l’activation de la prise en charge de l’interface C-API 64 bits, reportez-vous au manuel Message Queue Developer’s Guide for C Clients.

Configurations mat�rielle et logicielle requises

Cette section d�crit le mat�riel et les logiciels recommand�s pour cette version de Message Queue. Le Tableau 2 r�pertorie les configurations mat�rielle et logicielle requises pour les syst�mes d’exploitation Solaris SPARC.

Tableau 2  Configurations mat�rielle et logicielle requises pour Solaris SPARC 

Composant	Configuration requise par la plate-forme
Syst�me d’exploitation	Solaris 8, Update 7 Solaris 9, Update 7 Solaris 10, Update 1 (inclut une prise en charge 32 et 64 bits pour Solaris 8, Solaris 9 et Solaris 10)
CPU	Sun UltraSPARC™ Remarque : pour un fonctionnement correct de Message Queue, vous devez installer tous les patchs Solaris requis pour Java 2 Platform, Standard Edition 5.0. Pour obtenir les derni�res informations sur les patchs requis et recommand�s et pour les t�l�charger, consultez le site : http://java.sun.com/j2se/1.5.0/download.jsp
M�moire vive	256 Mo
Espace disque	Platform Edition : Le fichier d’installation compress� fait environ 33 Mo. Le r�pertoire de travail temporaire utilis� pour l’extraction des fichiers d’installation requiert 33 Mo suppl�mentaires. Le produit install� requiert environ 33 Mo d’espace disque. Il se peut toutefois que Message Queue ait besoin de plus d’espace si le courtier stocke les messages persistants localement. Enterprise Edition : Le fichier d’installation compress� fait environ 152 Mo. Le r�pertoire de travail temporaire utilis� pour l’extraction des fichiers d’installation requiert 152 Mo suppl�mentaires. Le produit install� requiert environ 33 Mo d’espace disque. Il se peut toutefois que Message Queue ait besoin de plus d’espace si le courtier stocke les messages persistants localement.

Le Tableau 3 r�pertorie les configurations mat�rielle et logicielle requises pour les syst�mes d’exploitation Solaris x86.

Tableau 3  Mat�riel et logiciels requis pour Solaris x86 

Composant	Configuration requise par la plate-forme
Syst�me d’exploitation	Solaris 9, Update 7 Solaris 10, Update 1 (inclut une prise en charge 32 et 64 bits pour Solaris 9 et Solaris 10)
CPU	Intel Pentium 2 (ou compatible) Remarque : pour un fonctionnement correct de Message Queue, vous devez installer tous les patchs Solaris requis pour Java 2 Platform, Standard Edition 5.0. Pour obtenir les derni�res informations sur les patchs requis et recommand�s et pour les t�l�charger, consultez le site : http://java.sun.com/j2se/1.5.0/download.jsp
M�moire vive	256 Mo
Espace disque	Platform Edition : Le fichier d’installation compress� fait environ 22 Mo. Le r�pertoire de travail temporaire utilis� pour l’extraction des fichiers d’installation requiert 22 Mo suppl�mentaires. Le produit install� requiert environ 22 Mo d’espace disque. Il se peut toutefois que Message Queue ait besoin de plus d’espace si le courtier stocke les messages persistants localement. Enterprise Edition : Le fichier d’installation compress� fait environ 115 Mo. Le r�pertoire de travail temporaire utilis� pour l’extraction des fichiers d’installation requiert 115 Mo suppl�mentaires. Le produit install� requiert environ 22 Mo d’espace disque. Il se peut toutefois que Message Queue ait besoin de plus d’espace si le courtier stocke les messages persistants localement.

Le Tableau 4 r�pertorie les configurations mat�rielle et logicielle requises pour les syst�mes d’exploitation Linux.

Tableau 4  Mat�riel et logiciels requis pour Linux 

Composant	Configuration requise par la plate-forme
Syst�me d’exploitation	RedHat Advanced Server 2.1, Update 6 RedHat Advanced Server 3.0, Update 4 Remarque : la distribution du logiciel Message Queue inclut la version JRE requise au moment de sa commercialisation.
CPU	Intel Pentium 2 (ou compatible)
M�moire vive	256 Mo
Espace disque	Platform Edition : Le fichier compress� du produit fait environ 17 Mo. Le produit install� requiert environ 17 Mo d’espace disque. Il se peut toutefois que Message Queue ait besoin de plus d’espace si le courtier stocke les messages persistants localement. Enterprise Edition : Le fichier compress� du produit fait environ 104 Mo. Le r�pertoire de travail temporaire utilis� pour l’extraction des fichiers d’installation requiert 104 Mo suppl�mentaires. Le produit install� requiert environ 17 Mo d’espace disque. Il se peut toutefois que Message Queue ait besoin de plus d’espace si le courtier stocke les messages persistants localement.

Message Queue 3 2005Q1 n�cessite �galement d’autres technologies, comme indiqu� dans le Tableau 5. Vous pouvez �galement utiliser d’autres versions ou impl�mentations d’autres fournisseurs mais ces derni�res n’ont pas fait l’objet de tests par Sun Microsystems et ne sont, par cons�quent, pas prises en charge.

Le Tableau 5 r�pertorie et d�crit les composants de base � installer pour pouvoir d�velopper et ex�cuter les clients Message Queue.

Tableau 5  Tableau des produits de base de Message Queue 3 2005Q1  

Plate-forme/Produit	Utilis� pour	Plate-forme/Version de produit prises en charge
Java Runtime Environment (JRE) (versions Sun Microsystems uniquement)	Courtier Message Queue (serveur de messagerie) et outils d’administration de Message Queue	Java Runtime Environment 1.4.2_05 Java 2 Platform, Standard Edition, 5.0 (1.5.0_02) : Solaris 8 (SPARC), Solaris 9 (SPARC et X86) et Solaris 10 (SPARC et X86) Linux Red Hat Advanced Server 2.1, Update 6 et Linux Red Hat Advanced Server 3.0, Update 4 Windows XP Professionnel SP2, 2000 toutes �ditions SP4, Windows Server 2003 Enterprise Edition
Java Software Development Kit (JDK), Standard Edition (versions de production Sun Microsystems uniquement)	D�veloppement et d�ploiement du client Java (les clients Java SOAP/JAXM ne sont pris en charge que sur JDK 1.4.2 et 1.5)	JDK 1.4.2_05 Java 2 Platform, Standard Edition, 5.0 (1.5.0_02) : Solaris (m�mes plates-formes que JRE) Linux (m�mes plates-formes que JRE) Windows (m�mes plates-formes que JRE)

Le Tableau 6 r�pertorie et d�crit les composants que vous pouvez installer pour fournir une prise en charge suppl�mentaire pour un client Message Queue. Tous les composants r�pertori�s ne sont pas forc�ment n�cessaires. Par exemple, si vous ne d�veloppez pas de client C pour Message Queue, vous n’avez pas besoin des composants requis pour la prise en charge du client C.

Tableau 6  Tableau des produits facultatifs de Message Queue 3 2005Q1  

Produit	Utilis� pour	Version de produit prise en charge
Serveur d’annuaire LDAP	Prise en charge des objets administr�s et du r�f�rentiel utilisateur de Message Queue	Sun Java System Directory Server Version 5.2 SP 3
Web Server	Prise en charge HTTP et HTTPS	Sun Java System Web Server, Enterprise Edition Version 6.1 SP 4
Application Server	Prise en charge HTTP et HTTPS	Sun Java System Application Server, Enterprise Edition 8.1
Database	Prise en charge de la persistance enfichable	PointBase, Version 4.8 Oracle 9i, Version 9.2
JNDI (Java Naming and Directory Interface)	Prise en charge des objets administr�s	JNDI Version 1.2.1 LDAP Service Provider Version 1.2.2 File System Service Provider Version 1.2 Beta 3 (pris en charge pour le d�veloppement et le test, mais pas pour un d�ploiement dans un environnement de production)
Compilateur C et biblioth�que d’ex�cution compatible C++	Prise en charge des clients C de Message Queue	Sous Solaris : Compilateur C++ Sun WorkShop 6, Update 2 ou ult�rieur avec -compat=5, Compilateur C Sun WorkShop Linux : gcc/g++ 2.96 Sous Windows : Microsoft Windows Visual C++ 6.0, SP3
NSPR (Netscape Portable Runtime)	Prise en charge des clients C de Message Queue	Version int�gr�e � Java Enterprise System 2005Q1 Pour l’�dition Platform Edition, ce produit est install� en tant que package partag�.
NSS (Network Security Service)	Prise en charge des clients C de Message Queue	Version int�gr�e � Java Enterprise System 2005Q1 Pour l’�dition Platform Edition, ce produit est install� en tant que package partag�.

---

Bogues r�solus dans la pr�sente version

Le Tableau 7 r�pertorie les bogues r�solus dans Message Queue 3 2005Q1 (3.6) :

Tableau 7  Bogues r�solus dans Message Queue 3 2005Q1 (3.6) 

R�f�rence	Description
2091749	Le courtier r�cup�re une exception de pointeur nul sur un pool de threads partag� lors de charges normales.
2092975	Le d�p�t permanent doit continuer le chargement si la d�s�rialisation �choue sur l’une des destinations.
2092976	Un message d’erreur de traitement est p�riodiquement envoy� � une rubrique lors de la fermeture d’un consommateur avec s�lecteur pendant l’acheminement du message dans le syst�me.
4888259	Les arguments vmargs sont ignor�s si plusieurs arguments sont transmis � imqbroker sous Windows.
4934433	Le code du paquet doit emp�cher la cr�ation de paquets volumineux.
4941127	Le chargement des messages dans la destination ne sera pas complet si la taille d’un message d�passe la limite autoris�e pour chaque message
4949398	imqcmd query dst donne des valeurs incorrectes lorsqu’une destination est en cours de chargement
4953659	Le client Message Queue n’appelle jamais ExceptionListener.onException lors de connexions semi-ouvertes.
4962906	Le courtier doit d�tecter une connexion � une base de donn�es p�rim�e et se reconnecter.
4969880	Receive(timeout) retourne null avant expiration du d�lai d’attente avec des fermetures fr�quentes de connexion.
4970719	Des messages avec accus�s de r�ception dans la transaction pr�par�e peuvent �tre renvoy�s aux consommateurs.
4983525	Erreur lors de la cr�ation du producteur dans la destination cr��e automatiquement sous le syst�me Linux 3.0.
4987799	Message Queue Resource Adapter et le courtier doivent prendre en charge les abonnements partag�s pour les clusters Application Server 8.1 Enterprise Edition.
4989708	imqbrokerd se comporte toujours comme si imq.transaction.autorollback avait la valeur true.
4992645	Message Queue Resource Adapter : JMS Resource Adapter doit prendre en charge le groupement de connexions.
4996776	Le courtier renvoie une exception ConcurrentModificationExceptions avec des charges �lev�es sur le serveur lorsque la g�n�ration de mesures est activ�e.
5004868	Les transactions supprim�es ne sont pas retir�es de la base de donn�es JDBC.
5014570	L’exemple QBrowser ne fonctionne pas avec l’�dition Platform Edition.
5024685	Listes de contr�le d’acc�s : l’interaction entre queue.create.deny.user=* et imq.autocreate.queue=true fonctionne mal.
5025241	L’abonn� durable avec noLocal=true re�oit des messages auto-publi�s.
5037962	Une diff�rence entre l’�tat du courtier principal et le journal entra�ne un blocage au d�marrage.
5042763	Le code du magasin de fichiers doit utiliser FileChannel.force(false) pour am�liorer les performances E/S synchrones.
5046995	L’impl�mentation de la n�gociation de protocole du client Java de Message Queue ne fonctionne pas correctement.
5053565	Message Queue 3.5 SP1 : le courtier utilise le processeur inutilement dans un cluster avec ma�tre.
5063625	Le r�cepteur de file d’attente ne re�oit plus les messages comprenant des messages distants qui lui sont destin�s dans un cluster � deux courtiers.
6021000	Le courtier se bloque lorsque des consommateurs sont ajout�s ou supprim�s lors de charges importantes.
6057402	Le courtier principal se bloque au red�marrage si une destination comprenant des abonn�s durables a �t� supprim�e.
6057450	imqcmd : impossible de d�finir maxNumBackupConsumers sur 0 pour les files d’attente.
6155087	Les courtiers avec un nom incorrect et un abonn� durable dans un cluster se bloquent � l’arr�t.
6155091	JDBC : "la commande "-reset store" est lente avec les messages volumineux et Oracle
6157943	Le service imqbrokerd ne s’arr�te pas correctement lors du red�marrage de Windows 2000.
6165743	Message Queue Resource Adapter : une utilisation r�p�t�e de connection.open/close dans des conditions de forte sollicitation peut entra�ner une exception IllegalStateException.
6165984	imqSSLIsHostTrusted n’est pas pris en compte lorsque imqAddressList est utilis� pour sp�cifier le client lors d’une connexion SSL.
6170578	Message Queue Resource Adapter :ManagedConnectionFactory doit h�riter des propri�t�s d�finies dans le bean java de l’adaptateur de ressources.
6170831	Message Queue Resource Adapter : un probl�me de synchronisation dans l’annulation du d�ploiement de MDB peut entra�ner une exception de pointeur nul si les messages sont toujours en cours de r�ception.
6174532	Les courtiers JMS d�livrent une nouvelle fois les messages d�j� consomm�s par les MDB.
6178549	La r�ex�cution de la commande cls fait perdre la liste des courtiers configur�s si -D imq.cluster.url est utilis� sur la ligne de commande
6189214	MQ_MESSAGE_ID_HEADER_PROPERTY (C) du message re�u est diff�rent de JMSMessageID du message envoy� (Java).

Le Tableau 8 r�pertorie les bogues r�solus dans Message Queue 3 2005Q1 (3.6 SP1) :

Tableau 8  Bogues r�solus dans Message Queue 3 2005Q1 (3.6 SP1) 

R�f�rence	Description
6198481	Les tentatives de reconnexion de Message Queue doivent utiliser la configuration d’intervalle/tentatives de reconnexion du serveur d’applications et rendre les reconnexions interruptibles pour les MDB.
6205463	RichAccess, apr�s �chec de formation de messages d’injection sur la destination, erreur de m�moire satur�e affich�e en 3 heures.
6208728	Tentatives de reconnexion de Message Queue : exception UnavailableException du point d’extr�mit� dans le journal du serveur d’applications pour richAccess bigApp apr�s arr�t/red�marrage du courtier MQ.
6221802	Mise � niveau de NSPR/NSS vers SECURITY_3_9_5_RTM.

Le Tableau 9 r�pertorie les bogues r�solus dans Message Queue 3 2005Q4 (3.6 SP2) :

Tableau 9  Bogues r�solus dans Message Queue 3 2005Q4 (3.6 SP2) 

R�f�rence	Description
4737166	Ajout d’une gestion d’exception non intercept�e � TOUS les threads du courtier
4959114	imqBrokerServiceName avec un nom de service incorrect g�n�re une exception inutile
4960331	Exception java.lang.NullPointerException renvoy�e lors du chargement � partir d’une base de donn�es endommag�e
4961780	La commande imqcmd metrics dst peut afficher 0 msgs/sec m�me s’il y a un (l�ger) trafic de messages
5017152	La m�me cl� de ressource est utilis�e pour l’�tiquette d’option de menu et le titre de bo�te de dialogue.
5029191	Les m�mes cl�s de cha�ne sont utilis�es dans le menu et dans le menu contextuel.
5055667	Unknown Destination:temporary_destination s’affiche parfois � l’arr�t du courtier
6172663	Indicateur interne isTopicConnection mal d�fini lors de la cr�ation d’une connexion unifi�e.
6172794	Le nouveau consommateur distant ne re�oit pas les messages sur la destination cr��e automatiquement (cluster/rare)
6173336	Le contr�le de flux des producteurs peut s’interrompre si des producteurs sont sans cesse ajout�s � des destinations satur�es
6175764	Probl�me de cluster : une fermeture rapide suivie d’une r�ouverture durable peut g�n�rer une erreur interne
6176411	Le courtier ne d�tecte pas les exceptions non intercept�es dans les threads d’acceptation des services
6186193	Les messages sont envoy�s � System.out/System.err du courtier dans certains cas
6186329	Confusion des messages au cours de l’initialisation de clusters sans -tty
6186615	Certains champs de l’interface utilisateur de l’outil imqadmin ont une taille nulle, il est donc impossible de voir leur contenu
6189645	La reconnexion d’ex�cution du client s’interbloque si la connexion du courtier �choue au cours de connection.start()
6191835	Le client/adaptateur de ressources de Message Queue doit r�soudre la fa�on dont les threads de d�mon sont sp�cifi�s pour �viter l’exception AccessControlException actuelle
6193884	Message Queue envoie un message garbage au journal syst�me dans un environnement autre que C
6195048	Le courtier 3.6 broker renvoie une exception lors du chargement du magasin 3.5 avec la transaction PREPARED
6196233	La s�lection de messages � l’aide de JMSMessageID ne fonctionne pas
6198465	Modification du comportement du module d’�coute des messages asynchrone dans l’application cliente depuis le serveur d’application 8.0 � 8.1
6205641	Les emplacements du serveur d’applications sont incorrects dans la d�monstration jaxm
6206595	Les versions Sparc de SUNWiqcrt et SUNWiqcdv ne doivent pas d�pendre de SUNWprx, SUNWtlsx 64 bits.
6206611	Il faut ajouter des biblioth�ques 64 bits aux packages x86 de Message Queue pour la prise en charge de amd64
6208740	Le magasin de r�initialisation avec le courtier principal tentent de d�truire la file d’attente des messages bloqu�s
6213561	Le fichier web.xml contenu dans imq/jaxm/README doit �tre mis � jour.
6215079	ActivationSpec de l’adaptateur de ressources de Message Queue ne dispose pas d’un nom d’utilisateur et d’un mot de passe configurables
6216762	Prise en charge de Solaris amd64
6226548	L’intervalle de reconnexion est ignor� lors de l’it�ration via la liste d’adresses au cours du basculement
6226550	Tentatives de basculement de Message Queue continues lorsque tous les h�tes de la liste mq-address sont inaccessibles
6229572	Consommateurs locaux/internes transf�r�s apr�s que restart-local dsts du courtier devient non local sur restarted bkr
6237112	com/sun/messaging/jmq/Version.class manquant dans imq.jar
6240237	WeakValueHashMap ne lib�re pas de m�moire, entra�nant ainsi une fuite de m�moire avec les r�cepteurs de file d’attente � l’aide des s�lecteurs.
6240568	Le courtier perd de la m�moire lorsque de nouveaux messages sont rejet�s sur des destinations satur�es
6250207	Le producteur et le consommateur temporaires g�n�rent des exceptions dans un cluster
6252146	L’invite � la saisie du mot de passe est endommag�e dans imqcmd, imqusermgr.
6252184	Blocage du producteur avec une erreur interne inattendue dans le courtier avec les destinations temporaires et le courtier principal

Le Tableau 10 r�pertorie les bogues r�solus dans Message Queue 3 2005Q4 (3.6 SP3) :

Tableau 10  Bogues r�solus dans Message Queue 3 2005Q4 (3.6 SP3) 

R�f�rence	Description
6256771	Erreur de syntaxe d’impression de scripts imq* lorsqu’ils sont utilis�s dans une installation bas�e sur des fichiers.
6257306	Le serveur d’applications ne d�marre pas apr�s la mise � niveau de Message Queue sous Linux.
6269126	imqadmin ne d�marre pas si JavaHelp n’est pas install�.
6271773	Suppression des composants partag�s de mqinstall/mqupgrade.
6284769	QueueBrowser perd de la m�moire m�me lorsqu’un nouveau navigateur est cr�� et ferm� pour chaque �num�ration.

---

Informations importantes

Cette section comprend les derni�res informations qui n’ont pu �tre incluses dans la documentation de base du produit. Elle aborde les th�mes suivants :

Notes relatives � l’installation
Probl�mes de compatibilit�
Mises � jour de la documentation de Message Queue

Notes relatives � l’installation

Reportez-vous au manuel Message Queue Installation Guide pour obtenir des informations sur les instructions de pr�-installation, les proc�dures de mise � niveau et toutes autres informations relatives � l’installation de Message Queue, Platform Edition sur les plates-formes Solaris, Linux et Windows.

Reportez-vous au Guide d'installation de Sun Java Enterprise System pour obtenir des informations sur les instructions de pr�-installation et toutes autres informations relatives � l’installation de Message Queue, Enterprise Edition sur les plates-formes Solaris et Linux.

Reportez-vous au Guide de migration et de mise � niveau de Sun Java Enterprise System pour obtenir des informations sur les instructions de migration et de mise � niveau vers Message Queue 3 2005Q1 (3.6) sur les plates-formes Solaris et Linux.

Installation des packages Solaris manquants (distribution de Message Queue 3 2005Q1 Enterprise Edition uniquement (distribution des sous-ensembles) avec le programme d'installation de Java Enterprise System)

La distribution de Message Queue 3 2005Q1 Enterprise Edition pour Solaris n’inclut pas les packages SUNWtlsu (Network Security Services Utilities) et SUNWtlsux (Network Security Services Utilities SPARC 64 bits uniquement).

Ces packages ne sont utiles que pour la prise en charge des clients C SSL. Il se peut que vous poss�diez une version pr�c�dente de ces packages, mais il est conseill� de les mettre � jour avec la version incluse dans Java Enterprise System 2005Q1.

Solution
Vous pouvez obtenir la version des packages SUNWtlsu et SUNWtlsux incluse dans Java Enterprise System 2005Q1 � partir des fichiers de l’�dition Message Queue 3 2005Q1 Platform Edition sur le site Web Sun Java System. Apr�s avoir t�l�charg� les fichiers de Message Queue, suivez les instructions de la section � Installing Message Queue � (Installation de Message Queue) du chapitre 2, � Solaris Installation � (Installation Solaris) dans le guide Message Queue Installation Guide. À l’�tape 8, r�pondez n (non) et passez � l’�tape 9 pour installer uniquement les packages SUNWtlsu et SUNWtlsux sur votre syst�me.

Probl�mes de compatibilit�

Cette section d�crit les probl�mes de compatibilit� de Message Queue 3 2005Q1 (3.6).

Probl�mes de Message Queue 3 2005Q1 (3.6)

Les sections suivantes d�crivent les probl�mes affectant : toutes les plates-formes, les plates-formes Solaris et Linux, et uniquement les plates-formes Linux.

Toutes les plates-formes

Stabilit� de l’interface     Sun Java System Message Queue utilise de nombreuses interfaces qui permettent d’automatiser certaines t�ches des administrateurs. L’Annexe B du Message Queue Administration Guide classe ces interfaces en fonction de leur stabilit�. Plus l’interface est stable, moins elle est susceptible d’�tre modifi�e dans les versions ult�rieures du produit.

D�sapprobation des options de mot de passe     Pour des raisons de s�curit�, les options suivantes ont �t� d�sapprouv�es :

-p
-password
-dbpassword
-ldappassword

Si un mot de passe est sp�cifi� dans une commande, comme dans l’exemple suivant :

imqcmd query bkr -u admin -p adminpassword

un utilisateur peut voir le mot de passe de l’administrateur lors de l’inventaire ou de l’interrogation des processus d’une machine (par ex., en utilisant ps sur Solaris).

Pr�f�rez l’option -passfile � la place. L’option passfile est expliqu�e dans le chapitre relatif � la s�curit� dans le guide Message Queue Administration Guide.

Plates-formes Solaris et Linux

Prise en charge du client JDK 1.3     Les packages suivants contiennent les fichiers jar utilis�s pour la prise en charge de JNDI et JSSE pour le d�veloppement et le d�ploiement du client sur JDK 1.3. Ces packages ne sont fournis qu’avec Message Queue, Platform Edition. Ils ne seront pas fournis dans les versions ult�rieures. Ces packages ne sont pas install�s par d�faut :

SUNWiqsup--Plate-forme Solaris
sun-mq-sup--Plate-forme Linux

Pour plus d’informations sur l’installation des packages de mani�re s�par�e, reportez-vous au guide Message Queue Installation Guide.

Plates-formes Linux

Cette section d�crit les modifications qui affectent les packages et les emplacements d’installation sur la plate-forme Linux.

Nouveaux emplacements d’installation Linux     L’emplacement des r�pertoires d’installation de Message Queue a �t� modifi� pour Linux.

Remarque	Aucune modification n’a �t� apport�e � l’emplacement des r�pertoires d’installation entre Message Queue 3 2005Q1 (3.6) et Message Queue 3 2005Q4 (3.6 SP3).

Le Tableau 11 montre les r�pertoires d’installation par d�faut des RPM Message Queue sur Linux.

Tableau 11  Emplacements d’installation par d�faut des RPM Message Queue 3 2005Q1

Nom du package RPM	Emplacement d'installation par d�faut
sun-mq-config	/etc/opt/sun
sun-mq-var	/var/opt/sun
Tous les autres RPM	/opt/sun

Pour plus d’informations, reportez-vous � l’annexe A, � Operating System-Specific Locations of Message Queue Data � (Emplacements des donn�es de Message Queue en fonction des syst�mes d’exploitation) dans le guide Message Queue Administration Guide.

Modification du nom des packages RPM Linux     Le nom des fichiers de package RPM Linux de Message Queue a �t� modifi�.

Remarque	Aucune modification n’a �t� apport�e aux noms des packages RPM Linux Message Queue entre la version Message Queue 3 2005Q1 et la version Message Queue 3 2005Q4.

Le Tableau 12 montre le nouveau nom des packages RPM Linux de Message Queue 3 2005Q1.

Tableau 12  Packages RPM dans les fichiers Linux 

RPM	Description	Notes
sun-mq-config	Fichiers /etc
sun-mq-var	Fichiers /var
sun-mq	Fichiers /opt	D�pend des packages sun-javahelp, sun-mq-jmsclient, sun-mq-config et sun-mq-var
sun-mq-ent	Fichier de licence Enterprise Edition.	Ce RPM est livr� uniquement avec Message Queue, Enterprise Edition, disponible avec Java Enterprise System.
sun-mq-jaxm	Message Queue Java API for XML Messaging (JAXM) : API	D�pend de sun-saaj
sun-mq-jmsclient	JMS : API et programme d’ex�cution	Aucune d�pendance
sun-mq-xmlclient	Client XML	D�pend de sun-jmsclient et de sun-saaj
sun-mq-capi	C-API	D�pend de sun-nspr, sun-nss
sun-mq-compat	Liens symboliques vers les emplacements de Message Queue 3.5.	D�pend de sun-mq Ce RPM n’est pas install� par d�faut. Remarque : ce package est requis uniquement si vos clients existants d�pendent des emplacements de fichiers de Message Queue 3.5.
sun-mq-sup	Requis pour la prise en charge de JDK 1.3	D�pend de sun-mq Ce RPM n’est pas install� par d�faut. Remarque : ce package est uniquement livr� avec Message Queue, Platform Edition.
sun-mq-[locale]	Fichiers L10N
sun-javahelp1	JavaHelp : API et programme d’ex�cution	Prend en charge le visionneur JavaHelp pour l’aide d’Admin Console
sun-nss1	Biblioth�ques NSS (Network Security Services).	Requis pour la prise en charge des clients du langage C
sun-nspr1	Biblioth�ques NSPR (Netscape Portable Runtime)	Requis pour la prise en charge des clients C
sun-saaj1	SOAP with Attachments API for Java : API et programme d’ex�cution	Requis pour la prise en charge des clients Java utilisant l’API SOAP/JAXM
sun-jaxp1	Message Queue Java API for XML Processing (JAXP) : API et programme d’ex�cution	Requis pour la prise en charge des clients Java utilisant l’API SOAP/JAXM
sun-javamail1	JavaMail : API et programme d’ex�cution	Requis pour la prise en charge des clients Java utilisant l’API SOAP/JAXM
sun-jaf1	JavaBeans Activation Framework : API et programme d’ex�cution	Requis pour la prise en charge des clients Java utilisant l’API SOAP/JAXM

1Ce package RPM est partag� par un certain nombre de produits Sun Java System. Il est fourni avec Message Queue, Platform Edition dans la distribution, mais pas avec Message Queue, Enterprise Edition.

Package des liens symboliques pour les clients de Message Queue 3.5     L’emplacement des fichiers individuels install�s avec Message Queue sur Linux a chang�. Cette modification peut interrompre les applications qui d�pendent de l’ancien emplacement de certains fichiers Message Queue. Par exemple, si vos clients utilisent des scripts pour localiser les fichiers jar install�s avec Message Queue 3.5, ils ne pourront plus localiser ces fichiers.

Pour r�soudre ce probl�me, le package Linux sun-mq-compat est inclus dans cette version. Il installe les liens symboliques des emplacements de fichiers de Message Queue 3.5 vers les emplacements de fichiers de Message Queue 3 2005Q1 (3.6). Ce package peut ne pas �tre fourni dans les versions ult�rieures. Vous devez corriger tous les scripts qui pointent vers les anciens emplacements de fichiers Message Queue.

Le package sun-mq-compat se trouve dans les emplacements suivants.

Distribution de Message Queue, Platform Edition :
Lorsque vous d�compressez la distribution, un r�pertoire rpms est cr��.
Message Queue, Enterprise Edition (fourni avec la distribution Java Enterprise System) :
Linux_x86/Product/message_queue/Packages

  Pour installer le package sun-mq-compat

Ouvrez une session superutilisateur.
À partir du r�pertoire du package RPM, utilisez la commande suivante :

rpm -ivh --nodeps sun-mq-compat-3.6-<Num�roVersion>.i386.rpm

Probl�mes relatifs � la prochaine version majeure de Message Queue

La prochaine version principale de Message Queue peut introduire des modifications rendant vos clients incompatibles avec cette version. Cette information vous est fournie d�s � pr�sent afin que vous puissiez vous pr�parer � ces modifications.

Il s’agit de la derni�re version de fonction de Sun Java System Message Queue qui sera compatible avec Sun One Message Queue 3.0.1. Les futures versions de Sun Java System Message Queue ne prendront plus en charge les fonctions suivantes :
connexion des clients 3.0.1 aux courtiers de la derni�re version ;
mise � niveau d’un magasin persistant 3.0.1 au niveau de la derni�re version ;
clustering des courtiers 3.0.1 avec les courtiers de la derni�re version ;
utilisation des fichiers de propri�t�s, des magasins d’utilisateurs, des listes de contr�le d’acc�s, etc. 3.0.1 avec des courtiers de la derni�re version.
Il s’agit de la derni�re version de Sun Java System Message Queue qui sera prise en charge et int�gr�e en tant que fournisseur de messagerie JMS syst�me pour Sun Java System Application Server 7.X. Les versions ult�rieures de Sun Java System Message Queue ne prendront en charge que Sun Java System Application Server 8.0 et versions sup�rieures.
Il s’agit de la derni�re version de Sun Java System Message Queue qui inclura l’ex�cution SOAP et prendra en charge les objets administr�s SOAP Message Queue.
Les versions futures prendront uniquement en charge SOAP conjointement avec une version Java 2 Standard Edition Platform qui prend en charge SOAP.
Sun Java System La prise en charge du client Message Queue pour toutes les versions de Java 2 Standard Edition 1.3 sera abandonn�e. Java 2 Standard Edition 1.4 continuera d’�tre pris en charge.
L’emplacement des fichiers individuels install�s avec Sun Java System Message Queue peut changer. Ceci risque de perturber l’ex�cution des applications existantes d�pendant de l’emplacement actuel des fichiers Message Queue.
Sun Java System Les clients Message Queue utilisant une version de Message Queue plus ancienne que la prochaine version principale risquent de ne pas avoir acc�s aux nouvelles fonctions fournies dans cette version du produit.

Mises � jour de la documentation de Message Queue

Les sections suivantes pr�sentent les mises � jour de la documentation de Message Queue 3 2005Q1 (3.6) et de Message Queue 3 2005Q4 (3.6 SP3).

Mises � jour de la documentation de Message Queue 3 2005Q1 (3.6)
Mises � jour de la documentation de Message Queue 3 2005Q4 (3.6 SP3)

Mises � jour de la documentation de Message Queue 3 2005Q1 (3.6)

Les documents de Message Queue suivants ont fait l’objet d’une mise � jour � partir de la version 3.5 du produit :

Guide d’installation

Le guide Message Queue Installation Guide a �t� mis � jour pour refl�ter les modifications relatives aux marques et les informations sp�cifiques aux plates-formes. Ce document contient d�sormais les informations d’installation concernant Message Queue, Platform Edition.

Les informations d’installation de Message Queue Enterprise Edition figurent maintenant dans le Guide d'installation Sun Java System.

Pour plus d’informations sur la mise � niveau et la migration vers Message Queue 3 2005Q1 (3.6) Enterprise Edition, reportez-vous au Guide de migration et de mise � niveau de Sun Java System.

Pr�sentation technique

Message Queue Technical Overview est un nouveau document introduit avec la version Message Queue 3 2005Q1 (3.6). Il a �t� remani� pour la version Message Queue 3 2005Q4 (3.6 SP3). Il d�crit Message Queue, ses fonctions, son architecture, sa technologie et sa terminologie. Il contient les informations g�n�rales contenues pr�c�demment dans d’autres manuels et est destin� aux utilisateurs de Message Queue, qu’ils soient administrateurs ou d�veloppeurs, ainsi qu’� tout autre utilisateur.

Administration Guide

Le guide Message Queue Administration Guide a �t� mis � jour afin de refl�ter les modifications relatives aux marques ainsi que les nouvelles fonctions. Il a �galement fait l’objet d’une r�organisation afin d’�tre plus facile d’utilisation pour les administrateurs de Message Queue. Les informations g�n�rales qui figuraient auparavant dans ce document ont �t� transf�r�es dans le document Message Queue Technical Overview.

Message Queue Developer’s Guide for Java Clients

Le guide Java Client Developer’s Guide a �t� mis � jour pour refl�ter les modifications relatives aux marques et les nouvelles fonctions. Il a �galement chang� d’intitul� et s’appelle d�sormais Message Queue Developer’s Guide for Java Clients.

Le guide Message Queue Developer’s Guide for Java Clients a fait l’objet d’une r�organisation afin d’�tre plus facile d’utilisation pour les d�veloppeurs du client Java de Message Queue. Les informations g�n�rales qui figuraient auparavant dans ce document ont �t� transf�r�es dans le document Message Queue Technical Overview.

C Client Developer’s Guide

Le guide C Client Developer’s Guide a �t� mis � jour pour refl�ter les modifications relatives aux marques et les nouvelles fonctions. Il a �galement chang� d’intitul� et s’appelle d�sormais Message Queue Developer’s Guide for C Clients.

Le guide Message Queue Developer’s Guide for C Clients a fait l’objet d’une r�organisation afin d’�tre plus facile d’utilisation pour les d�veloppeurs du client C de Message Queue. Les informations g�n�rales qui figuraient auparavant dans ce document ont �t� transf�r�es dans le document Message Queue Technical Overview.

Mises � jour de la documentation de Message Queue 3 2005Q4 (3.6 SP3)

Les documents de Message Queue suivants ont fait l’objet d’une mise � jour � partir de la version 3 2005Q1 (3.6) du produit :

Guide d’installation

Le document Message Queue Installation Guide a �t� mis � jour de sorte � refl�ter les modifications relatives � l’installation du produit introduites depuis la version Message Queue 3 2005Q1 (3.6).

Pr�sentation technique

Message Queue Technical Overview est un nouveau document introduit avec la version Message Queue 3 2005Q1 (3.6). Il a �t� remani� pour la version Message Queue 3 2005Q4 (3.6 SP3). Il d�crit Message Queue, ses fonctions, son architecture, sa technologie et sa terminologie. Il contient les informations g�n�rales contenues pr�c�demment dans d’autres manuels et est destin� aux utilisateurs de Message Queue, qu’ils soient administrateurs ou d�veloppeurs, ainsi qu’� tout autre utilisateur.

Administration Guide

Le document Message Queue Administration Guide a fait l’objet d’une r�organisation afin d’�tre plus facile d’utilisation pour les administrateurs de Message Queue. Les informations g�n�rales qui figuraient auparavant dans ce document ont �t� transf�r�es dans le document Message Queue Technical Overview.

Message Queue Developer’s Guide for Java Clients

Le document Message Queue Developer’s Guide for Java Clients contient un nouveau chapitre, � Using the Java API �.

---

Probl�mes connus et restrictions

Cette section contient la liste des probl�mes connus de Message Queue 3 2005Q1 (3.6). Les domaines suivants du produit sont abord�s :

Probl�mes d’ordre g�n�ral
Probl�mes li�s � l’administration/configuration
Probl�mes relatifs au courtier

Pour conna�tre la liste des probl�mes actuels, leur �tat et les solutions possibles, les membres de Java Developer Connection™ doivent consulter la page � Bug Parade � du site Web Java Developer Connection. Avant de signaler tout nouveau probl�me, merci de consulter cette page. Bien que tous les probl�mes de Message Queue n’y soient pas r�pertori�s, il est bon de s’y r�f�rer pour savoir si un probl�me a d�j� �t� signal�.

La page concern�e est la suivante :

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

Remarque	L’adh�sion � Java Developer Connection est gratuite, mais elle requiert une inscription. Pour savoir comment devenir membre de Java Developer Connection, consultez la page Web de Sun � For Developers �.

Pour signaler un nouveau probl�me ou soumettre une demande d’am�lioration, envoyez un courrier �lectronique � l’adresse imq-feedback@sun.com.

Probl�mes d’ordre g�n�ral

Cette section d�crit les probl�mes d’ordre g�n�ral de Message Queue 3 2005Q1 (3.6). Certains ont d�j� �t� signal�s dans des versions pr�c�dentes de Message Queue. Cette section regroupe les probl�mes en fonction de leur appartenance � Enterprise Edition et Platform Edition de Message Queue ou � Enterprise Edition uniquement.

Enterprise Edition et Platform Edition

Dans Message Queue 3 2005Q1, l’exemple de configuration du courtier pour l’utilisation d’un serveur LDAP comme r�f�rentiel utilisateur se trouve dans la zone de commentaire du fichier config.properties, et l’exemple de r�f�rentiel utilisateur LDAP du fichier default.properties a �t� comment�.

Si vous d�pendiez auparavant des valeurs de propri�t�s de la configuration du r�f�rentiel utilisateur LDAP donn� en exemple dans le fichier default.properties, votre client d’application JMS recevra une exception de s�curit� lorsqu’il tentera de cr�er une connexion JMS. Ce probl�me survient apr�s une mise � niveau vers Message Queue 3 2005Q1.

Lorsque le client JMS tente d’�tablir une connexion avec le courtier de Message Queue 3 2005Q1, une erreur s’affiche dans le journal du courtier et le client JMS re�oit l’exception suivante :

SecurityException.

20/ao�t/2004:11:16:41 PDT] ERREUR [B4064] : Propri�t� .uidattr du r�f�rentiel LDAP ldap non d�finie pour le type d'authentification basic:com.sun.messaging.jmq.auth.LoginException: [B4064] : Propri�t� .uidattr du r�f�rentiel LDAP ldap non d�finie pour le type d'authentification basic

Solution
D�finissez la propri�t� du courtier imq.user_repository.ldap.uidattr selon les instructions du guide Message Queue Administration Guide.

Un bogue dans RedHat Linux 2.1 (bogue NSS n� 5078380) peut bloquer les m�thodes MQCreateConnection (biblioth�que C-API de Message Queue 3 2005Q1) de l’application C-API de Message Queue ou MQInitializeSSL (biblioth�que C-API de Message Queue 3 2005Q1 ou 3.5) si un thread est cr�� dans l’application C-API de Message Queue avant l’appel de ces deux m�thodes.

Solution
Quatre options permettent d’�viter ce probl�me lors de l’utilisation de la biblioth�que C-API de Message Queue 3 2005Q1 :

Mettre � niveau vers RedHat Linux 3.0
D�finir la variable d’environnement MQ_NSS_5078380_WORKAROUND avant d’ex�cuter l’application cliente C de Message Queue et d�finir la propri�t� du courtier Message Queue sur la valeur imq.authentication.type=basic
Appeler la m�thode MQInistializeSSL(<chemin-bd-certificats>) avant de lancer tout thread dans votre application cliente C de Message Queue. Vous pouvez utiliser l’utilitaire certutil pour cr�er les fichiers de base de donn�es de certificats.

Cr�ez une connexion au courtier de Message Queue en appelant MQCreateConnection avant de lancer un thread. Vous ne pouvez pas modifier le fichier de configuration des instances d’un courtier sans avoir d�marr�, au moins une fois, l’instance du courtier, tout simplement parce que le fichier config.properties n’existe pas tant que l’instance du courtier n’a pas �t� d�marr�e une premi�re fois. Pour configurer un courtier afin qu’il utilise la permanence enfichable ou pour d�finir d’autres propri�t�s de configuration, ex�cutez une fois le courtier (avec le nom d’instance qui doit �tre utilis� pour cr�er le courtier) pour cr�er le fichier config.properties :

Plate-forme	Lieu
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

Lorsque le fichier config.properties a �t� cr��, modifiez-le pour ajouter d’autres valeurs de propri�t�s de configuration, puis red�marrez le courtier.

Enterprise Edition uniquement

Seuls les clusters de courtiers enti�rement connect�s sont pris en charge par cette version. Autrement dit, tous les courtiers d’un cluster doivent communiquer directement avec tous les autres. Si vous connectez des courtiers par l’interm�diaire de l’argument de ligne de commande imqbrokerd -cluster, assurez-vous bien que tous les courtiers du cluster sont pris en compte.
Un client connect� � un courtier appartenant � un cluster ne peut actuellement pas utiliser QueueBrowser pour parcourir les files d’attente situ�es sur les courtiers distants de ce cluster. Il ne peut que parcourir le contenu des files d’attente situ�es sur le courtier auquel il est directement connect�. Il peut toutefois continuer d’envoyer des messages vers les files d’attente ou de consommer les messages provenant des files d’attente sur n’importe quel courtier du cluster, la limitation ne s’appliquant en effet qu’� la navigation.
Si aucun courtier ne fait office de courtier principal dans un cluster, les informations permanentes enregistr�es par un courtier ayant �t� ajout� au cluster ne sont pas communiqu�es aux autres courtiers du cluster.
Un service de connexion utilisant SSL ne prend en charge actuellement que les certificats de serveurs auto-sign�s, c’est-�-dire le mode d’approbation par l’h�te.
Lorsqu’un client JMS utilisant le transport HTTP met brutalement fin � la connexion (en utilisant, par exemple, Ctrl-C), le courtier met environ une minute avant de lib�rer la connexion client et toutes les ressources associ�es.

Si une autre instance du client est d�marr�e pendant cet intervalle d’une minute et qu’elle tente d’utiliser le m�me ClientID, le m�me abonnement durable ou la m�me file d’attente, elle peut recevoir une exception � L’ID client est d�j� utilis� �. Il ne s’agit pas d’un vrai probl�me, mais d’un effet secondaire du processus de fin d�crit pr�c�demment. Si un client est d�marr� apr�s un d�lai d’environ une minute, tout doit fonctionner correctement.

Probl�mes li�s � l’administration/configuration

Les utilitaires imqadmin et imqobjmgr renvoient une erreur lorsque la variable CLASSPATH contient des guillemets sur les postes Windows (ID de bogue 5060769)

Solution
Vous pouvez ignorer ce message d’erreur, le courtier traite correctement le probl�me en notifiant toute erreur aux consommateurs. Cette erreur n’affecte pas la fiabilit� du syst�me.

L'option -javahome dans tous les scripts Solaris/Windows ne fonctionne pas si la valeur comprend un espace (bogue n� 4683029)

L’option -javahome est utilis�e par les commandes et les utilitaires de Message Queue pour indiquer un autre ex�cuteur Java 2 compatible. N�anmoins, le chemin d’acc�s de l’autre ex�cuteur Java ne doit pas contenir d’espace.

Vous trouverez ici des exemples de chemin contenant des espaces :

     Windows :
     C:\jdk 1.4

     Solaris :
     /work/java 1.4

Solution
Installez l’ex�cuteur Java � un emplacement ou un chemin ne contenant pas d’espace.

Message Queue envoie un message garbage au journal syst�me dans un environnement autre que C (bogue n� 6193884)

Message Queue envoie une sortie garbage au journal syst�me lorsque le courtier est ex�cut� dans un environnement autre que C.

Solution
Ex�cutez le courtier dans un environnement C.

Probl�mes relatifs au courtier

Dans un cluster de courtiers, un courtier mettra en file d'attente les messages destin�s � une connexion distante qui n'a pas �t� initi�e (bogue n� 4951010)

Solution
Le consommateur recevra les messages d�s que la connexion est initi�e. Les messages seront de nouveau envoy�s � un autre consommateur si la connexion du consommateur est ferm�e.

Il arrive que HTTPS createQueueConnection renvoie une exception sous Windows 2000. (bogue n� 4953348)

Solution
R�essayez de vous connecter.

Lorsque vous utilisez Ctrl-C pour arr�ter le courtier, il se peut que les transactions soient effac�es apr�s la fermeture du magasin (bogue n� 4934446)

Le courtier affiche les erreurs avec le motif � Acc�s � la m�thode Store apr�s la fermeture du magasin � si le courtier est arr�t� alors que des messages ou des transactions sont en cours de traitement.

Solution
Vous pouvez ignorer ce message d’erreur, le courtier traite correctement le probl�me en notifiant toute erreur aux consommateurs. Cette erreur n’affecte pas la fiabilit� du syst�me.

Le courtier devient inaccessible lorsque le d�p�t permanent ouvre trop de destinations. (Bogue n� 4953354)

Solution
Ce probl�me est d� au fait que le courtier atteint la limite du descripteur de fichier ouvert d�finie pour le syst�me. Sur Solaris et Linux, utilisez la commande ulimit pour augmenter cette limite.

Les consommateurs sont orphelins lorsqu'une destination est d�truite (bogue n� 5060787)

Les consommateurs actifs sont orphelins lorsqu’une destination est supprim�e. Une fois orphelins, ils ne peuvent plus recevoir de messages (m�me si la destination est recr��e).

Solution
Il n’existe aucune solution � ce probl�me.

Impossible de s�lectionner des messages avec JMSMessageID (bogue n� 6196233)

La s�lection de messages avec le s�lecteur "JMSMessageID = ’<id_message>’" ne fonctionne pas.

Envoyez un message � une file d’attente.
Lisez l’ID JMSMessageID du message envoy� - <id_message>.
Cr�ez un consommateur dans la file d’attente avec le s�lecteur d�fini sur "JMSMessageID = '<id_message>'"

Le message ne sera pas re�u.

Solution
Remplacez le s�lecteur :

JMSMessageID = "ID:message-id-string"

en :

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

Message Queue QueueBrowser indique �galement des messages non valid�s (bogue n� 6264003)

Lors du parcours du contenu d’une file d’attente, les messages qui ont �t� produits dans une transaction mais n’ont pas encore �t� valid�s peuvent appara�tre dans l’�num�ration de QueueBrowser.

Solution
Il n’existe aucune solution � ce probl�me.

---

Fichiers redistribuables

Sun Java System Message Queue 3 2005Q1 (3.6) contient le jeu de fichiers suivant que vous pouvez utiliser et distribuer librement sous forme binaire :

jms.jar
imq.jar
imqxm.jar
fscontext.jar
providerutil.jar
jndi.jar
ldap.jar
ldapbpjar
jaas.jar
jsse.jar
jnet.jar
jcert.jar
Vous pouvez �galement redistribuer les fichiers LICENSE et COPYRIGHT.

---

Fonctions d’accessibilit� destin�es aux personnes handicap�es

Pour obtenir la liste des fonctions d’accessibilit� mises � disposition depuis la publication de ce m�dia, consultez les �valuations de produit de la Section 508, disponibles sur demande aupr�s de Sun, afin de d�terminer les versions les mieux adapt�es au d�ploiement des solutions accessibles. Vous trouverez des versions mises � jour pour certaines applications � l’emplacement suivant : http://sun.com/software/javaenterprisesystem/get.html.

Pour plus d’informations sur l’engagement de Sun en mati�re d’accessibilit�, consultez le site http://sun.com/access.

---

Comment signaler des probl�mes et apporter des commentaires

Si vous rencontrez des probl�mes avec Sun Java System Message Queue, contactez le service client�le Sun de l’une des mani�res suivantes :

En faisant appel aux services de support logiciel Sun en ligne � l’adresse ci-dessous :
http://www.sun.com/service/sunone/software

Ce site contient des liens vers la base de connaissances, le centre de support en ligne et ProductTracker, ainsi que vers des programmes de maintenance et des coordonn�es pour le support.

En composant le num�ro de t�l�phone indiqu� sur votre contrat de maintenance.

Afin de vous aider � r�soudre votre probl�me, pensez � r�unir les informations suivantes lorsque vous contactez le support technique :

la description du probl�me, en particulier les situations dans lesquelles il se produit et son impact sur vos op�rations ;
le type de machine, les versions du syst�me d’exploitation et du produit, y compris les patchs et autres logiciels pouvant avoir un lien avec le probl�me ;
la proc�dure d�taill�e des m�thodes utilis�es pour reproduire le probl�me ;
tous les journaux d’erreur ou vidages de la m�moire.

Forum des logiciels Sun Java System

Il existe un forum Sun Java System Message Queue � l’emplacement suivant :

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

Votre participation est la bienvenue.

Forum sur la technologie Java

Il existe un forum JMS au sein des forums sur la technologie Java qui peut �tre utile.

http://forum.java.sun.com

---

Sun attend vos commentaires

Afin d’am�liorer sa documentation, Sun vous encourage � faire des commentaires et � apporter des suggestions.

Pour nous faire part de vos commentaires, rendez-vous sur le site http://docs.sun.com, puis cliquez sur Envoyer des commentaires. Dans le formulaire en ligne, indiquez le titre et le num�ro du document. Ce num�ro est constitu� de sept ou neuf chiffres et figure sur la page de titre du manuel ou en haut du document. Par exemple, le titre de ce manuel est Sun Java System Message Queue 3 2005Q4 Notes de version, et sa r�f�rence est 819-3557.

---

Ressources Sun suppl�mentaires

Vous pouvez obtenir des informations utiles concernant Sun Java System sur les sites Internet suivants :

Documentation de Message Queue
http://docs.sun.com/coll/1307.1
Documentation de Sun Java System
http://docs.sun.com/prod/java.sys
Services professionnels de Sun Java System
http://www.sun.com/service/sunps/sunone
Produits et services logiciels de Sun Java System
http://www.sun.com/software
Services de support logiciel Sun Java System
http://www.sun.com/service/sunone/software
Base de connaissances et support Sun Java System
http://www.sun.com/service/support/software
Services de formation et de support Sun
http://training.sun.com
Services professionnels et de conseil Sun Java System
http://www.sun.com/service/sunps/sunone
Informations pour les d�veloppeurs Sun Java System
http://developers.sun.com
Services de support pour d�veloppeurs Sun
http://www.sun.com/developers/support
Formation sur les logiciels Sun Java System
http://www.sun.com/software/training
Fiches de pr�sentation des logiciels Sun
http://wwws.sun.com/software

---

Copyright � 2005 Sun Microsystems, Inc. Tous droits r�serv�s.

Sun Microsystems, Inc. Sun Microsystems, Inc. d�tient les droits de propri�t� intellectuelle relatifs � la technologie qui est d�crite dans ce document. En particulier, et ce sans limitation, ces droits de propri�t� intellectuelle peuvent inclure un ou plusieurs des brevets am�ricains r�pertori�s � l’adresse http://www.sun.com/patents, et un ou plusieurs brevets suppl�mentaires ou des demandes de brevet en instance aux �tats-Unis et dans d’autres pays.

L’utilisation est soumise aux termes du contrat de licence.

Cette distribution peut comprendre des composants d�velopp�s par des tierces parties.

Sun, Sun Microsystems, le logo Sun, Java, Solaris et Sun[tm] ONE sont des marques de fabrique ou des marques d�pos�es de Sun Microsystems, Inc. aux �tats-Unis et dans d’autres pays.

Toutes les marques SPARC sont utilis�es sous licence et sont des marques de fabrique ou des marques d�pos�es de SPARC International, Inc. aux �tats-Unis et dans d’autres pays.

UNIX est une marque d�pos�e aux �tats-Unis et dans d’autres pays et conc�d�e exclusivement sous licence par X/Open Company, Ltd.