Sun Java™ System Message Queue Notes de mise � jour

Version 3.5 SP1

Num�ro de document 817-7200-10

Ces notes de mise � jour contiennent des informations importantes disponibles au moment du lancement de la version 3.5 SP1 de Sun Java™ System Message Queue (anciennement Sun™ ONE Message Queue). Ce document contient �galement les notes de mise � jour vers Message Queue 3.5, destin�es aux clients mettant leur version � niveau � partir des versions ant�rieures � la 3.5. Vous y trouverez des renseignements sur les nouvelles fonctions, les am�liorations, les restrictions et probl�mes connus, les notes techniques, etc. concernant les versions Message Queue 3.5.

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

Ces notes de mise � jour contiennent les sections suivantes :

Historique des mises � jour
À propos de Message Queue 3.5 SP1
Bogues r�solus
Informations importantes
Probl�mes et limites connus
Fichiers redistribuables
Communication de probl�mes et formulation de commentaires
Ressources Sun suppl�mentaires

---

Historique des mises � jour

Tableau 1  Historique des mises � jour

Date	Description des modifications
12 mars 2004	Mise � jour des informations concernant les bogues. Mise � jour de la section Probl�mes et limites connus. Ajout de la section Fichiers redistribuables. Mise � jour de la section Mises � jour de la documentation. Mise � jour de la section Probl�mes de compatibilit�. Mise � jour de la section Informations relatives � Sun Java System.
9 janvier 2004	Mise � jour des informations concernant la prise en charge de PointBase version 4.8 ; mise � jour des informations li�es aux fonctions C-API.

---

À propos de Message Queue 3.5 SP1

Message Queue 3.5 SP1 est une mise � jour de Message Queue 3.5 ; elle contient toutes les nouvelles fonctions de Message Queue 3.5. En outre, Message Queue 3.5 SP1 propose des corrections de bogues et porte un nouveau nom commercial. En effet, ce produit appartient d�sormais � la famille de produits Sun Java™ System.

Message Queue 3.5 SP1 a �t� reconnu conforme � la sp�cification Java^™ Message Service (JMS) 1.1, apr�s avoir satisfait aux tests CTS (Compatibility Test Suite) de JMS 1.1.

Cette section pr�sente les modifications pr�sentes dans Message Queue 3.5 SP1 ainsi que dans la version pr�c�dente, Message Queue 3.5.

Message Queue 3.5 SP1

Message Queue  3.5 SP1 propose des corrections pour certains bogues ; le nom commercial du produit et de la documentation a chang�.

Message Queue 3.5

Message Queue 3.5 comprenait de nombreuses nouvelles fonctions :

� Prise en charge de Client C (Enterprise Edition) � � la page 3

� Reprise apr�s incident de la connexion au client Java (Enterprise Edition) � � la page 4

� Meilleur contr�le du flux de messages du courtier � � la page 5

� Meilleur contr�le du flux du client Java � � la page 6

� Nouveaux param�tres de destination � � la page 7

� API de contr�le � distance (Enterprise Edition) � � la page 8

� Message Queue Adaptateur de ressources pour JMS (prise en charge du serveur d’applications J2EE) � � la page 8

� Personnalisation de l’accus� de r�ception d’un message � � la page 8

� Meilleures strat�gies de livraison de file d’attente (Enterprise Edition) � � la page 9

� Am�lioration des performances du cluster (Enterprise Edition) � � la page 10

� Destinations locales (Enterprise Edition) � � la page 11

� S�curisation des clusters de courtiers (Enterprise Edition) � � la page 11

� Meilleures performances du magasin persistant � � la page 11

� Authentification et autorisation sp�cifiques d’une instance � � la page 13

� Installation sous Linux bas�e sur RPM � � la page 13

� Prise en charge du syst�me d’exploitation Solaris, X86 Platform Edition � � la page 13

Ces fonctions sont pr�sent�es dans les sous-sections suivantes.

Prise en charge de Client C (Enterprise Edition)

Message Queue 3.5 propose une prise en charge de l’ex�cution des fonctions C-API et C (ci-apr�s d�sign�e par le terme fonction Client C). La fonction client C permet d’int�grer d’anciens syst�mes au syst�me de messagerie Message Queue. Il s’agit d’une impl�mentation quasi totale de la sp�cification JMS. Elle prend en charge toutes les fonctions JMS, � l’exception de : certains types de corps (carte, flux et objet), de fonctions de navigateur de file d’attente, ainsi que certaines fonctionnalit�s de serveur d’applications J2EE (telles que les transactions distribu�es et les objets ConnectionConsumer).

La prise en charge de la fonction Client C se fait par le biais d’un jeu de biblioth�ques install�es s�par�ment, qui est activ� uniquement gr�ce � une licence Enterprise Edition. Par cons�quent, une mise � niveau de Platform Edition vers Enterprise Edition n�cessite l’installation du fichier de licence d’Enterprise Edition et des biblioth�ques C.

Les clients d�tenant Platform Edition qui activent la version d’essai de 90 jours de la licence Enterprise Edition peuvent utiliser la fonction client C s’ils demandent � Sun le kit du d�veloppeur de l’API C, par le biais de l’alias imq-feedback@sun.com. Le service ing�nierie est charg� de r�pondre � ces demandes et de mettre � disposition le kit du d�veloppeur de l’API C sur le site FTP anonyme. À l’issue des 90 jours de la licence Enterprise Edition, les clients peuvent continuer � cr�er des fonctions clients C, mais ils ne peuvent pas les connecter au courtier de l’Enterprise Edition.

La fonction client C n�cessitant des versions de compilateur sp�cifiques sur les diff�rentes plates-formes de syst�me d’exploitation, Enterprise Edition contient de nouvelles exigences en mati�re de configuration (voir le Guide d'installation de Message Queue pour plus d’informations). La fonction client C est aussi d�pendante des biblioth�ques Netscape Portable Runtime (NSPR) et Network Security Service (NSS). (En ce qui concerne Message Queue 3.5, la fonction client C a �t� test�e avec succ�s sur Linux Red Hat Advanced Server 2.1. Les versions des biblioth�ques NSPR et NSS sur lesquelles elle a �t� test�e ne sont pas certifi�es pour cette �dition de Linux).

À l’heure actuelle, l’API C ne prend pas en charge le type d’authentification basic. Si vous configurez le courtier de sorte qu’il utilise ce type d’authentification, un appel � la fonction MQCreateConnection �choue ; le r�sultat est MQ_UNSUPPORTED_AUTH_TYPE.

La documentation de la fonction client C est compos�e de documentation de r�f�rence, de documentation de programmation et d’exemples de clients API C. Pour plus d’informations, voir le Guide du d�veloppeur Message Queue Client C.

Reprise apr�s incident de la connexion au client Java (Enterprise Edition)

Message Queue 3.5 propose une fonction de reconnexion automatique am�lior�e, par laquelle une connexion qui a �chou� peut �tre r�tablie non seulement dans le courtier d’origine, mais aussi sur un courtier diff�rent (reprise apr�s incident de la connexion au client). La nouvelle connexion se fait au service de messagerie, plut�t qu’� une instance de courtier sp�cifique. Pour mettre en uvre ce comportement, il vous suffit de configurer l’objet administr� de fabrique de connexion (Message Queue 3.5 poss�de un nouveau sch�ma de sp�cification d’adresses de service de messagerie), en pr�cisant un ensemble d’adresses de courtier (imqAddressList). Lorsque l’ex�cution du client doit �tablir (ou r�-�tablir) une connexion � un service de messagerie, elle essaie de se connecter aux courtiers de la liste par ordre de priorit�, jusqu’� ce qu’elle trouve, ou non, un courtier disponible. Vous pouvez pr�ciser le nombre limite de tentatives de connexion (imqAddressListIterations) � chacun de ces courtiers, ainsi que le laps de temps entre ces tentatives (imqAddressListInterval).

Si la reconnexion automatique se fait � une instance de courtier diff�rente du courtier d’origine, les messages permanents et autres informations li�es � l’�tat se trouvant dans le courtier en �chec (ou d�connect�) peuvent �tre perdus. La raison en est que les diverses instances de courtier d’un cluster n’utilisent pas un magasin persistant partag� largement disponible. Cependant, la fonction de reconnexion automatique de l’ex�cution du client � une instance de courtier diff�rente vous permet de cr�er des sc�narios de r�cup�ration dans lesquels un courtier de remplacement ou un cluster de courtiers peut �tre utilis� dans le cadre d’une protection en cas de reprise apr�s incident (incompl�te).

De plus, si la fonction de reconnexion automatique est activ�e, Message Queue 3.5 rend d�sormais persistantes des destinations temporaires en cas d’�chec de la connexion associ�e, car les clients peuvent se reconnecter et y acc�der � nouveau. Les destinations temporaires sont trait�es comme d’autres destinations physiques. Par cons�quent, vous devez purger r�guli�rement un courtier de toutes les destinations temporaires inutilis�es.

Pour plus d’informations, voir le Guide du d�veloppeur Message Queue Client Java.

Message Queue proposait d�j� une fonction de reconnexion automatique qui permettait � l’ex�cution du client de se reconnecter automatiquement � un courtier en cas d’interruption de la connexion. Toutefois, elle ne fonctionnait pas dans les cas o� il �tait impossible de restaurer compl�tement l’�tat c�t� client dans le courtier lors de la reconnexion (par exemple, lors de l’utilisation de sessions �tablies par le biais d’une transaction ou de destinations temporaires, qui existent uniquement pour la dur�e d’une connexion).

Meilleur contr�le du flux de messages du courtier

Des am�liorations ont �t� apport�es au courtier, afin de mieux contr�ler le flux de messages vers les destinations et d’�viter des situations dans lesquelles la production de messages est beaucoup plus rapide que leur consommation. (En outre, d’autres nouvelles fonctions de Message Queue 3.5 peuvent aider � �liminer les goulots d’�tranglement dans le flux des messages sortant des destinations. Voir les sections � Meilleur contr�le du flux du client Java � � la page 6 et � Meilleures strat�gies de livraison de file d’attente (Enterprise Edition) � � la page 9).

Les am�liorations apport�es au flux de messages du courtier sont les suivantes :

Limitation du nombre de producteurs associ�s � une destination. Les destinations poss�dent d�sormais un nouvel attribut maxNumProducers ; lorsque cette limite est atteinte, il devient impossible de cr�er un producteur pour la destination concern�e.
Mise en place de nouvelles limites configurables et de comportements de limites lorsque les destinations atteignent les limites maxTotalMsgBytes et maxNumMsgs. En particulier, les changements suivants ont �t� apport�s :
L’extension des attributs de destination maxTotalMsgBytes et maxNumMsgs aux destinations de rubriques (elles ne s’appliquaient jusqu’ici qu’aux destinations de file d’attente)
La possibilit� de d�finir les attributs maxTotalMsgBytes et maxNumMsgs des destinations cr��es automatiquement
La possibilit� pour un administrateur de choisir un comportement si les limites ci-dessus (Enterprise Edition) sont atteintes. Vous pouvez pr�ciser les comportements suivants : affichage des producteurs (FLOW_CONTROL), mise au rebut des messages les plus anciens (REMOVE_OLDEST), mise au rebut des messages dont la priorit� est la plus basse, en fonction de leur anciennet� (REMOVE_LOW_PRIORITY) et/ou mise au rebut des messages les plus r�cents (REJECT_NEWEST).
La mise en uvre du comportement en cas d’atteinte de la limite de contr�le du flux du producteur (FLOW_CONTROL) par producteur, plut�t que par connexion. (La mise en uvre pr�c�dente fermait tous les producteurs d’une connexion lorsqu’une destination avait re�u un trop grand nombre de messages par le biais de cette connexion). Le contr�le de flux par producteur ferme uniquement les producteurs d’une connexion associ�e � la destination inond�e, ce qui permet � d’autres producteurs de la connexion de continuer � envoyer des messages � d’autres destinations.
La possibilit� pour un administrateur d’interrompre (et de reprendre) une destination sp�cifique. Vous pouvez interrompre la livraison de messages provenant des producteurs vers la destination ou de la destination vers les consommateurs, ou des deux. Pour ce faire, vous pouvez utiliser deux nouvelles sous-commandes imqcmd : pause et resume, illustr�es dans l’exemple suivant :
imqcmd pause dst -n myQueue -t q -pst PRODUCERS
imqcmd resume dst -n myQueue -t q

Pour plus d’informations, voir le Guide d'administration de Message Queue.

Meilleur contr�le du flux du client Java

L’ex�cution du client Message Queue 3.5 g�re le flux de messages par consommateur, ainsi que par connexion. Vous pouvez limiter le nombre de messages plac�s dans la m�moire tampon par consommateur, emp�chant ainsi qu’un consommateur soit submerg� par d’autres consommateurs. Cela signifie �galement que dans le cas d’une livraison de file d’attente � plusieurs consommateurs, vous pouvez mieux �quilibrer la livraison des messages. Vous pourrez aussi g�rer les ressources en mati�re de m�moire dans l’ex�cution du client de Message Queue.

Un nouvel attribut de fabrique de connexion, imqConsumerFlowLimit, limite le nombre de messages mis en m�moire tampon par consommateur pour tous les consommateurs partageant une connexion. Lorsque le nombre de messages se trouvant dans la m�moire tampon d’un consommateur devient inf�rieur � un pourcentage seuil (imqConsumerFlowThreshold) de imqConsumerFlowLimit, le courtier peut livrer un autre lot de messages � l’ex�cution du client pour qu’il soit consomm� par ce consommateur. Si le nombre total de messages mis en m�moire tampon pour tous les consommateurs dans une connexion d�passe la valeur fix�e pour imqConnectionFlowLimit, la livraison des messages par le biais de la connexion cesse jusqu’� ce que le total devienne inf�rieur � la limite de connexion.

(La mise en uvre pr�c�dente du contr�le du flux d’ex�cution vous permettait de limiter le nombre de messages plac�s dans la m�moire tampon de l’ex�cution du client, avant d’�tre consomm�s (imqConnectionFlowLimit). Cette fonction avait pour objectif de limiter la quantit� de m�moire du client utilis�e pour la mise en m�moire tampon de messages, de sorte que les clients lents � consommer ne tombent pas en panne � cause du manque de m�moire. Cette fonction �tait mise en uvre au niveau de la connexion, ce qui signifie que si une connexion prend en charge un grand nombre de clients, une avalanche de messages destin�es � un consommateur peut emp�cher les autres consommateurs de recevoir des messages).

Pour plus d’informations, voir le Guide du d�veloppeur Message Queue Client Java.

Nouveaux param�tres de destination

Message Queue 3.5 propose un suivi am�lior� des messages et des consommateurs par destination, afin de permettre une meilleure surveillance et un meilleur contr�le de la m�moire et de son utilisation.

Les nouveaux param�tres apparaissent dans la sortie de la nouvelle sous-commande imqcmd metrics dst. Cette commande affiche les totaux cumul�s (depuis le d�but de l’�chantillonnage), les valeurs actuelles, les valeurs moyennes (calcul�es par rapport aux �chantillons pr�lev�s) et les valeurs maximales (depuis le d�but de l’�chantillonnage) correspondant aux param�tres de message et de consommateur.

Par exemple, la commande imqcmd metrics dst -m ttl renvoie les informations suivantes :

flux de messages
flux de messages entrants : total cumul�, d�bit ;
flux de messages sortants : total cumul�, d�bit.
Messages stock�s dans le courtier (messages sans accus� de r�ception dans la m�moire ou dans un magasin persistant)
nombre de messages : actuel, maximal, moyen ;
taille des messages : actuelle, maximale, moyenne.
Message le plus volumineux, en octets

La commande imqcmd metrics dst -m con renvoie les informations suivantes :

nombre de consommateurs actifs : actuel, maximal, moyen (voir � Meilleures strat�gies de livraison de file d’attente (Enterprise Edition) � � la page 9) ;
nombre de consommateurs de remplacement : actuel, maximal, moyen (voir � Meilleures strat�gies de livraison de file d’attente (Enterprise Edition) � � la page 9).

Pour plus d’informations, voir le Guide d'administration de Message Queue.

API de contr�le � distance (Enterprise Edition)

Message Queue 3.5 propose une API message par le biais de laquelle les clients JMS distants (ou locaux) peuvent facilement contr�ler et analyser les param�tres du courtier. Cette API repose sur la capacit� qu’a le courtier � produire des messages contenant les param�tres li�s au courtier, � la machine virtuelle Java et aux destinations individuelles (voir � Nouveaux param�tres de destination � � la page 7). Ces messages sont envoy�s � des destinations de rubriques sp�cifiques, selon l’entit� en cours de contr�le, chaque fois qu’un ou que plusieurs consommateurs sont abonn�s � ces destinations. Le client consommateur peut alors extraire les messages, les filtrer gr�ce � une propri�t� d’en-t�te (type), puis extraire les param�tres qu’ils contiennent.

Pour plus d’informations, voir le Guide d'administration de Message Queue et le Guide du d�veloppeur Message Queue Client Java.

(Message Queue prenait en charge uniquement l’enregistrement des donn�es de param�tres de courtier et les requ�tes � distance sur les param�tres � l’aide de ses outils d’administration. Ces fonctions, m�me si elles fournissaient des donn�es de param�tres importantes, n’en facilitaient pas l’analyse).

Message Queue Adaptateur de ressources pour JMS (prise en charge du serveur d’applications J2EE)

Message Queue 3.5 propose un adaptateur de ressources JMS permettant de connecter le service de messagerie JMS de Message Queue � un serveur d’applications J2EE compatible.

Un adaptateur de ressources est un dispositif normalis� permettant d’apporter des fonctionnalit�s compl�mentaires � un serveur d’applications J2EE (en le connectant � un EIS, un syst�me de messagerie ou autre), selon la sp�cification concernant l’architecture des connecteurs J2EE (JCA 1.5). Cette architecture permet � n’importe quel serveur d’applications J2EE, par exemple, de prendre en charge la messagerie JMS en se connectant � un fournisseur JMS impl�mentant la sp�cification JCA 1.5 : les composants J2EE d�ploy�s et ex�cut�s dans l’environnement de serveur d’applications peuvent �changer des messages JMS par le biais du fournisseur JMS connect� (ex�cution du client et serveur).

Pour plus d’informations, voir le Guide d'administration de Message Queue.

Personnalisation de l’accus� de r�ception d’un message

Message Queue prend actuellement en charge le mode d’accus� de r�ception client JMS CLIENT_ACKNOWLEDGE, gr�ce auquel un client JMS reconna�t explicitement la consommation de messages. En mode CLIENT_ACKNOWLEDGE, le client appelle la m�thode acknowledge() d’un objet de message. Cela a pour cons�quence que la session accuse r�ception de tous les messages qu’elle a consomm�s depuis l’invocation pr�c�dente de la m�thode.

Message Queue 3.5 am�liore ce comportement en vous permettant d’accuser r�ception de messages individuels. Cela signifie que vous pouvez accuser r�ception d’un seul message sp�cifique, plut�t que de tous les messages consomm�s jusque-l� en tant que lot. Cela se fait par le biais du code, en d�finissant le type de l’objet de message comme �tant un type de message Message Queue sp�cial, sur lequel vous appelez une nouvelle m�thode acknowledge(). Cela vous permet de vous �carter de la norme JMS pour pouvoir g�rer des besoins applicatifs sp�ciaux.

Pour plus d’informations, voir le Guide du d�veloppeur Message Queue Client Java.

Meilleures strat�gies de livraison de file d’attente (Enterprise Edition)

La mise en uvre de la livraison de file d’attente � plusieurs consommateurs, anciennement mise en place sous la forme de trois strat�gies diff�rentes (simple, bascule et circulaire), a chang�. Message Queue 3.5 fait appel � une m�thode plus g�n�rale, selon laquelle la charge de chaque livraison est �quilibr�e sur un nombre de consommateurs actifs (et de remplacement) que vous pouvez configurer. La mise en uvre de Message Queue 3.5 s’appuie sur les nouveaux attributs de destination suivants :

maxNumActiveConsumers :    pr�cise le nombre de consommateurs (un ou plusieurs) actifs dans une livraison de file d’attente dont la charge est �quilibr�e.
maxNumBackupConsumers :    pr�cise le nombre de consommateurs de remplacement (aucun ou plusieurs) pouvant remplacer les consommateurs actifs si ceux-ci font d�faut.

(Les nouveaux consommateurs seront rejet�s si le nombre de consommateurs d�passe la somme de ces deux attributs.)

L’�dition Platform Edition de Message Queue prend en charge la livraison de file d’attente dont la charge est �quilibr�e � concurrence de deux consommateurs. L’�dition Enterprise Edition, quant � elle, prend en charge un nombre illimit� de consommateurs.

Le nouveau m�canisme d’�quilibrage des charges tient compte du taux de consommation de messages des diff�rents consommateurs. Il fonctionne de la mani�re suivante :

Un nombre initial de messages plac�s en file d’attente dans une destination est achemin� vers des consommateurs actifs disponibles (dans l’ordre dans lequel ils sont inscrits aupr�s de la destination) dans des lots de taille configurable (attribut consumerFlowLimit de la destination). Une fois ces messages livr�s, d’autres messages parvenant � une destination sont achemin�s vers les consommateurs un par un, � mesure que ces derniers deviennent disponibles (c’est-�-dire, lorsque les consommateurs accusent r�ception de tous les messages qui leur ont �t� livr�s). Si un consommateur actif fait d�faut, le premier consommateur de remplacement devient actif, puis reprend le travail du consommateur faisant d�faut.
Dans un environnement de cluster de courtiers, vous pouvez d�finir le m�canisme de livraison de mani�re qu’il attribue des priorit�s aux consommateurs locaux. Un nouvel attribut de destination, localDeliveryPreferred, vous permet de pr�ciser que les messages doivent �tre livr�s aux consommateurs distants uniquement si aucun consommateur n’est pr�sent dans le courtier local (courtier sur lequel la destination a �t� cr��e). Cela vous permet d’augmenter les performances dans les cas o� l’acheminement vers les clients distants (par le biais de leurs courtiers locaux respectifs) pourrait ralentir le rendement. (Cet attribut n�cessite que l’�tendue de la livraison ne soit pas restreinte � la livraison locale. Voir � Am�lioration des performances du cluster (Enterprise Edition) � � la page 10).

Pour plus d’informations, voir le Guide d'administration de Message Queue.

Am�lioration des performances du cluster (Enterprise Edition)

Dans un environnement de clusters de courtiers, les destinations sont r�pliqu�es sur tous les courtiers et tous les messages livr�s � ces destinations sont envoy�s � tous les courtiers contenant des consommateurs inscrits pour ces destinations, m�me si seul un pourcentage infime des messages est livr� � un consommateur donn� (par exemple, dans le cas d’un abonn� durable utilisant des crit�res de s�lection, ou d’un r�cepteur de file d’attente impliqu� dans une livraison de file d’attente dont la charge est �quilibr�e). Ce trafic de courtier � courtier peut engendrer des avalanches de messages, plus particuli�rement lorsqu’un nouveau consommateur devient actif. Message Queue 3.5 apporte les am�liorations suivantes, destin�es � r�duire le surplus de trafic de courtier � courtier dans un cluster :

L’adoption de nouveaux m�canismes de contr�le de flux qui r�gulent la livraison des messages � une connexion de consommateur. En d’autres termes, le consommateur r�gule la livraison des messages (de la destination vers l’ex�cution du client), �vitant ainsi la transmission des messages superflus de courtier � courtier. (Ces m�canismes doivent �galement permettre d’�viter les engorgements du c�t� de l’ex�cution du client ; voir � Meilleur contr�le du flux du client Java � � la page 6).
La modification de la mise en uvre de la livraison de file d’attente � plusieurs consommateurs (voir � Meilleures strat�gies de livraison de file d’attente (Enterprise Edition) � � la page 9), afin de r�duire la transmission superflue de messages de courtier � courtier. Cette mise en uvre propose un nouvel attribut de destination de file d’attente, localDeliveryPreferred, qui vous permet de pr�ciser que les consommateurs locaux sont prioritaires par rapport aux consommateurs distants lors de la livraison de file d’attente � plusieurs consommateurs (voir � Meilleures strat�gies de livraison de file d’attente (Enterprise Edition) � � la page 9).

Pour plus d’informations, voir le Guide d'administration de Message Queue.

Destinations locales (Enterprise Edition)

Un nouvel attribut de destination, isLocalOnly, vous permet de pr�ciser qu’une destination est limit�e � la livraison de messages aux consommateurs locaux (consommateurs connect�s au courtier sur lequel la destination est cr��e), par opposition aux consommateurs connect�s � d’autres courtiers d’un cluster. De la m�me fa�on, cette destination peut recevoir uniquement les messages qui lui sont envoy�s par des producteurs locaux. Cette propri�t� vous permet de cr�er des destinations ind�pendantes, non interactives, portant le m�me nom sur des courtiers diff�rents d’un m�me cluster et d’�tablir des sc�narios de type reprise apr�s incident, dans lesquels un message est envoy� � deux destinations, au cas o� l’une d’entre elles subirait un �chec.

Pour plus d’informations, voir le Guide d'administration de Message Queue.

S�curisation des clusters de courtiers (Enterprise Edition)

Dans les cas o� il est indispensable que la livraison des messages entre client et serveur de messages soit s�curis�e et crypt�e, Message Queue 3.5 prend d�sormais en charge la livraison s�curis�e de messages entre les courtiers d’un cluster. Pour parvenir � une livraison s�curis�e et crypt�e des messages au sein d’un cluster, vous devez configurer le service de connexion au cluster interne pour qu’il utilise un protocole de transport SSL.

Pour plus d’informations, voir le Guide d'administration de Message Queue.

Meilleures performances du magasin persistant

La mise en uvre du magasin de donn�es simple de Message Queue et du magasin de donn�es conforme au JDBC a �t� modifi�e dans Message Queue 3.5, afin d’en am�liorer les performances. Ces am�liorations sont pr�sent�es dans les deux sections suivantes. Pour plus d’informations, voir le Guide d'administration de Message Queue.

Persistance int�gr�e (magasin de donn�es simple)

Les am�liorations apport�es aux performances du magasin de donn�es simple de Message Queue impliquent des changements internes du format de donn�es qui sont visibles seulement lors de la mise � niveau de Message Queue 3.01 (ou une version pr�c�dente) vers Message Queue 3.5.

La migration du magasin de donn�es est g�r�e automatiquement lorsqu’une instance de courtier de Message Queue 3.5 est lanc�e pour la premi�re fois et qu’elle r�f�rence une version pr�c�dente du magasin de fichiers. Une copie du magasin de fichiers pr�c�dent est enregistr�e dans le r�pertoire d’instances. Vous devez la supprimer manuellement une fois la migration termin�e. Pour supprimer automatiquement le magasin de fichiers pr�c�dent (si vous ne disposez pas de suffisamment d’espace disque pour contenir deux copies du magasin), vous pouvez d�marrer le courtier en version 3.5 avec une option ajout�e, comme le montre la commande suivante :

imqbrokerd -upgrade-store-nobackup

(Il n’y a aucun espace dans upgrade-store-nobackup).

La racine du nouveau magasin de donn�es simple a chang� de :

…/instances/instanceName/filestore/

en :

…/instances/instanceName/fs350/.

En outre, l’utilitaire de commande de Message Queue  (imqcmd) a �t� am�lior� de mani�re � fournir les param�tres de magasin de fichiers suivants :

imqcmd metrics dst -n destName -t type -m dsk

Et imqcmd propose une nouvelle commande de compactage :

imqcmd compact dst -n destName -t type

Persistance int�gr�e (Magasin de donn�es conforme au JDBC™)

Le magasin de donn�es conforme au JDBC de Message Queue a �t� modifi� dans Message Queue 3.5 pour prendre en charge les am�liorations apport�es � la gestion de la m�moire du courtier (voir � Meilleur contr�le du flux de messages du courtier � � la page 5 et � Nouveaux param�tres de destination � � la page 7) ainsi qu’une gamme plus �tendue de fournisseurs de bases de donn�es. Les modifications apport�es pour am�liorer la gestion de la m�moire (classement des messages par destination) sont des changements de sch�ma g�r�s de mani�re transparente. Toutefois, la prise en charge d’autres fournisseurs de bases de donn�es implique des changements de configuration de la persistance int�gr�e.

La migration du magasin conforme au JDBC est g�r�e automatiquement lorsqu’une instance de courtier de Message Queue 3.5 est lanc�e pour la premi�re fois avec une version pr�c�dente du magasin persistant. Les anciennes tables sont n�anmoins conserv�es intactes. Elles doivent �tre supprim�es manuellement � l’aide d’une nouvelle commande imqdbmgr delete oldtbl une fois la migration termin�e. Pour supprimer les anciennes tables automatiquement, au cas o� l’espace serait insuffisant pour contenir deux copies du magasin, vous pouvez utiliser une nouvelle option lors du premier lancement du courtier : imqbrokerd -upgrade-store-nobackup.

Pour ce qui est de la prise en charge d’autres bases de donn�es, il �tait auparavant impossible de personnaliser les instructions SQL envoy�es � la base de donn�es conforme au JDBC que vous vouliez int�grer (les instructions SQL �taient g�n�r�es en interne). Message Queue 3.5 propose de nouvelles propri�t�s de configuration d’instances qui vous permettent de personnaliser le code SQL qui cr�e le sch�ma de base de donn�es de Message Queue. Il existe une propri�t� configurable pour chaque table de la base de donn�es : la propri�t� est le code SQL qui cr�e la table. Ces propri�t�s sont n�cessaires pour pr�ciser correctement les types de donn�es utilis�s par la base de donn�es int�gr�e. Les exemples propos�s s’appuient sur une base de donn�es int�gr�e PointBase, plut�t que sur l’ancienne base de donn�es Cloudscape.

Authentification et autorisation sp�cifiques d’une instance

Par d�faut, Message Queue 3.5 pr�voit que chaque instance poss�de son propre r�f�rentiel utilisateur bas� sur les fichiers et son propre fichier de contr�le d’acc�s, tous deux contenus dans un emplacement standard : …/instances/instanceName/etc/. Ces deux fichiers sont cr��s au premier d�marrage d’une instance de courtier. Si le courtier trouve ces fichiers � l’ancien emplacement (ce qui se produit g�n�ralement lors d’une mise � niveau � partir d’une version pr�c�dente), il copie les fichiers vers l’emplacement sp�cifique de l’instance. En revanche, s’il ne les trouve pas � l’ancien emplacement (ce qui se produit g�n�ralement lors d’une nouvelle installation), il place des versions par d�faut de ces fichiers � un emplacement sp�cifique de l’instance.

Afin de prendre en charge les r�f�rentiels utilisateur sp�cifiques des instances, une option -i instanceName a �t� ajout�e au gestionnaire des utilisateurs (imqusermgr) afin de pr�ciser le r�f�rentiel utilisateur sp�cifique de l’instance auquel la commande imqusermgr s’applique.

Pour plus d’informations, voir le Guide d'administration de Message Queue.

Jusqu’ici, toutes les instances d’un courtier sur un ordinateur partageaient par d�faut le m�me r�f�rentiel utilisateur bas� sur les fichiers (et par cons�quent le m�me mot de passe de connexion client), ainsi que le m�me fichier de contr�le d’acc�s. Vous pouviez toutefois configurer toutes les instances de courtier pour qu’elles utilisent un emplacement de r�f�rentiel utilisateur LDAP sp�cifique ou un fichier de contr�le d’acc�s sp�cifique, les deux �tant identifi�s dans le fichier de configuration de l’instance.

Installation sous Linux bas�e sur RPM

L’installation sous Linux de Message Queue 3.5 s’effectue � l’aide de RPM (Red Hat Package Manager), un syst�me de gestion de paquets pilot� par ligne de commande, capable d’installer, de d�sinstaller, de v�rifier, d’interroger et de mettre � jour les logiciels (RPM).

En outre, la structure de r�pertoires install�e pour Message Queue sous Linux a chang�, pour correspondre aux emplacements standard utilis�s pour les produits non fournis en standard avec Linux. (Les plates-formes Solaris^™ et Linux poss�dent des normes qui d�pendent du fait qu’un produit est fourni ou non en standard avec le syst�me d’exploitation.) En particulier, il n’existe plus de r�pertoire d’installation racine de Message Queue sous Linux, tout comme sous Solaris.

Pour plus d’informations, voir le Guide d'installation de Message Queue.

Prise en charge du syst�me d’exploitation Solaris, X86 Platform Edition

Sous Solaris 9, Message Queue 3.5 est pris en charge par les processeurs X86 et SPARC.

Configurations mat�rielle et logicielle requises

Les configurations mat�rielle et logicielle requises pour cette version, ainsi que les produits et plates-formes pris en charge, sont d�crits en d�tail dans le Guide d'installation de Message Queue.

---

Bogues r�solus

Cette section pr�sente rapidement les bogues r�solus :

Le Tableau 2 � la page 15 pr�sente les bogues r�solus dans Message Queue 3.5 SP1.
Le Tableau 3 � la page 16 pr�sente les bogues r�solus dans Message Queue 3.5.

Pour obtenir les listes plus anciennes de bogues r�solus, voir :

Pour Message Queue 3.0.1 Service Pack 2, voir les Notes de mise � jour de Message Queue 3.0.1 Service Pack 2 � l’adresse suivante :

http://docs.sun.com/coll/S1_MessageQueue_301_SP2

Pour Message Queue 3.0.1, voir les Notes de mise � jour de Message Queue 3.0.1 � l’adresse suivante :

http://docs.sun.com/coll/S1_MessageQueue_301

Pour Message Queue 3.0, voir les Notes de mise � jour de Message Queue 3.0 � l’adresse suivante :

http://docs.sun.com/coll/S1_MessageQueue_30

Pour obtenir un rapport complet sur un bogue, consultez le site Java Developer Connection � l’adresse

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

R�solu dans Message Queue 3.5 SP1

Le Tableau 2 � la page 15 pr�sente les bogues r�solus dans Message Queue 3.5 SP1. (Le Tableau 3 � la page 16 pr�sente les bogues r�solus dans Message Queue 3.5).

Tableau 2  Bogues r�solus dans Message Queue 3.5 SP1  

R�f�rence	Description
4942723	Le courtier peut manquer de m�moire lors de l’envoi de messages volumineux � l’aide de l’option de pool de threads partag�s.
4944894	Le courtier peut occasionnellement g�n�rer une erreur CancelledKeyException lors de l’utilisation du pool de threads partag�s.
4947239	La cr�ation et la cl�ture r�p�t�es de producteurs augmentent l�g�rement l’occupation de la m�moire du client.
4947993	Impossible de d�truire la destination ou la ressource durable avec un abonn� durable actif.
4948525	Des nombres n�gatifs peuvent s’afficher dans les param�tres de sorties de taille des messages en entr�e et sortie. Cela se produit lorsque plus de 2 143 510 810 octets ont �t� envoy�s.
4948563	Conversion de paquets : un message INFO s’affiche sur chaque message 2.0 SP1 envoy� � un courtier 3.5. Chaque fois qu’un client 2.0 SP1 envoie un message � un courtier 3.5, le message de niveau INFO suivant s’affiche :     [04/Nov/2003:10:34:16 PST] Internal Error: Unknown ProducerUID 0
4949781	Erreur d’impossibilit� d’utilisation du diffuseur de cluster au d�marrage du courtier.
4952332	Les messages peuvent �tre livr�s de mani�re erron�e si le consommateur principal   subit un �chec et qu’un consommateur de remplacement prend le relais sur la m�me connexion.
4956748	Impossible d’utiliser un courtier principal avec la base de donn�es Oracle.
4964703	API C : L’en-t�te MESSAGE_ID renvoy� par la fonction MQGetMEssageHeaders() n’est pas dot� du pr�fixe “ ID: ”
4964712	API C : L’en-t�te MESSAGE_ID d�fini par la fonction MQSetMEssageHeaders() n’est pas ignor� lors de l’envoi du message.
4969583	API C : Le m�me identificateur de message doit pouvoir appeler MQAcknowledgeMessages() plusieurs fois.
4983150	L’indicateur JMSRedlivered n’est pas d�fini lors du red�marrage du courtier et de la livraison du message.
4983699	Exceptions de pertes de courtier �mises par le magasin lorsqu’il ne parvient pas � stocker un message.

R�solus dans Message Queue 3.5

Le Tableau 3 pr�sente les probl�mes r�solus dans Message Queue 3.5.

Tableau 3  Probl�mes r�solus dans Message Queue  3.5 

R�f�rence	Description
4449354	Exceptionnellement, l’appel simultan� des m�thodes Connection.stop, Connection.start, Connection.close et des m�thodes Session.recover et Session.rollback (dans des threads distincts) peut aboutir � une commande de nouvelle livraison de message inattendue.
4630183	La destruction d’une destination laisse des abonnements durables dans le courtier.
4753010	Croissance illimit�e du segment de tas natif du processus Java avec un serveur VM.
4761626	Une forte demande de cr�ation/suppression avec des files d’attente cr��es automatiquement peut provoquer la perte de messages.
4855307	Le courtier ne peut pas effectuer d’authentification par rapport � un r�f�rentiel LDAP car la configuration par d�faut utilise un ancien nom de propri�t� (bindDN)
4883126	La fonction de reconnexion automatique ne fonctionne pas correctement.
4888270	La retransmission d’un message envoy� � l’origine dans une transaction provoque une erreur du courtier.
4431924	imqadmin: les bo�tes de dialogue modales qui exigent une r�ponse de l’utilisateur peuvent se bloquer. La console d’administration (imqadmin) utilise des bo�tes de dialogue qui ont un comportement applicatif. La majorit� de ces bo�tes de dialogue s’affichent � la suite d’une interaction avec l’interface utilisateur graphique, par exemple en s�lectionnant l’option de menu Ajouter courtier. N�anmoins, l’affichage d’une bo�te de dialogue peut �galement r�sulter de la perte de connexion avec le courtier. Lorsque plusieurs bo�tes de dialogue sont ouvertes, la console d’administration est verrouill�e. Vous ne pouvez pas faire dispara�tre des bo�tes de dialogue modales exigeant une r�ponse de l’utilisateur � l’aide du bouton Fermer.
4703406	QueueBrowser doit fonctionner sans appeler au pr�alable connection.start(). Connection.start() doit �tre appel� au cours d’une connexion avant que QueueBrowser puisse parcourir la file d’attente. En cas d’�chec de l’appel de Connection.start() , l’�num�ration QueueBrowser se bloque sur nextElement() et peut d�clencher une exception java.util.NoSuchElementException.
4866814	Sous Solaris, le courtier ne peut pas enregistrer les messages d’erreur et d’avertissement � l’aide de syslog s’il a �t� d�marr� avec une JVM 64 bits (le courtier est d�marr� � l’aide de `-vmargs -d64`). La raison de cet incident est que la version b�ta de Message Queue ne contient pas de version 64 bits de notre biblioth�que, libimqutil.so.1.
4872121	Le courtier ne d�marre pas sur un syst�me non mis en r�seau ne poss�dant pas d’adresse IP autre que 127.0.0.1.
4879902	Augmentation lente de m�moire dans le courtier.
4881968	Impossible de cr�er des clients de contr�le si la propri�t� imq.autocreate.topic est d�finie comme �tant fausse.
4884827	�chec des tests CTS1.3 MDB/EJB CMT avec Message Queue 3.5 & AppServer 7.0
4885654	Les producteurs peuvent �chouer si un nouveau message est publi� sur une destination cr��e automatiquement en m�me temps que le syst�me r�colte la destination.
4887506	Au cours d’une reprise apr�s incident d’un consommateur principal vers un consommateur de remplacement, les messages peuvent �tre livr�s de mani�re incorrecte.
4888939	Les clients C et Java d’une destination avec un comportement de FLOW_CONTROL peuvent cesser de recevoir des messages si la taille maximale d’une destination (maxNumMsgs) est tr�s petite (< 5 messages).
4889002	La propri�t� imq.transaction.autorollback n’est pas prise en charge par la version b�ta 3.5.
4891874	Le contr�le de flux consommateur peut provoquer l’arr�t de la livraison des messages aux consommateurs. Ce probl�me est plus susceptible de survenir avec le probl�me 4896133 : ConnectionConsumers et les beans pilot�s par les messages du serveur d’applications 7 de Sun Java System.
4895262	Les clients HTTPS ne parviennent pas � se connecter au courtier par le biais de HTTPSTunnelServlet
4897500	Dans un cluster, lorsqu’un client appelle unsubscribe() pour supprimer un abonnement durable, il est seulement supprim� du courtier auquel le client est connect�. Cela signifie que les messages produits � l’attention des autres courtiers continueront d’�tre stock�s pour cet abonn�.
4898020	Impossible d’utiliser les courtiers de Message Queue 3.0.* et Message Queue 3.5 ensemble dans un cluster. Le d�marrage d’un cluster mixte engendre une erreur dans le courtier 3.0.1 : Diff�rence de configuration : Interruption de la connexion avec le courtier […] car les propri�t�s de configuration suivantes ne correspondent pas - null imq.queue.deliverypolicy
4888983	La commande imqcmd list dur n’affiche pas d’abonn�s durables avec le m�me nom durable.

---

Informations importantes

Cette section comprend les toutes derni�res informations qui n’ont pas pu �tre incluses dans la documentation de base des produits. Elle traite les rubriques suivantes :

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

Notes relatives � l’installation

Consultez le Guide d'installation de Message Queue pour obtenir des informations relatives � la configuration requise, aux plates-formes logicielles et aux produits pris en charge, aux instructions pr�alables � l’installation, aux proc�dures de mise � jour, ainsi que d’autres informations pertinentes pour l’installation de Message Queue sur les plates-formes Solaris, Linux et Windows.

Probl�mes de compatibilit�

Cette section pr�sente les probl�mes de compatibilit� entre Message Queue 3.5 SP1 et Message Queue 3.5.

Probl�mes li�s � la version principale � venir de Message Queue

Les changements incompatibles suivants pourraient �tre introduits dans la version principale � venir de Message Queue. Nous vous communiquons ces informations d�s � pr�sent pour que vous puissiez vous pr�parer � ces changements.

La prise en charge du client Message Queue pour toutes les versions de J2SE 1.3 sera abandonn�e. J2SE 1.4 sera toujours pris en charge.
Toutes les interfaces de ligne de commande Message Queue seront modifi�es pour supprimer l’option vous permettant de fournir un mot de passe en tant qu’argument de ligne de commande. Par exemple :

imqbrokerd -ldappassword <passwd> imqcmd -p <passwd>

D’autres options de pr�cision du mot de passe seront propos�es.

Le format du fichier journal du courtier changera. Les applications d�pendant du format actuel ne fonctionneront plus.
L’emplacement des fichiers individuels install�s avec Message Queue peut changer. Cela pourrait avoir une incidence sur les applications existantes qui d�pendent de l’emplacement actuel de certains fichiers Message Queue.
Le programme imqkeytool peut �tre supprim� du produit. L’utilitaire keytool J2SE le remplacera.
Les clients Message Queue utilisant une version de Message Queue plus ancienne que la version principale � venir pourraient ne pas avoir acc�s aux nouvelles fonctions propos�es dans cette version du produit.
Aucune erreur n’est g�n�r�e lorsque la fonction MQAcknowledgeMessages() est appel�e par des clients C (� l’aide de MQ_CLIENT_ACKNOWLEDGE) sur un message dont il a d�j� �t� accus� r�ception. Ce comportement pourrait changer.

Probl�mes dans Message Queue 3.5

Message Queue 3.5 est g�n�ralement compatible avec Message Queue 3.0 (et les versions suivantes 3.0.1, 3.0.1 Service Pack 1, ainsi que 3.0.1 Service Pack 2). Cependant, les changements apport�s aux propri�t�s du courtier, aux objets administr�s, au sch�ma de persistance, aux emplacements de fichiers et aux outils d’administration peuvent avoir un impact sur une mise � niveau � partir des versions deMessage Queue 3.0 vers Message Queue 3.5.

L’op�ration d’installation de Message Queue 3.5 ne supprime pas ni n’�crase le r�pertoire IMQ_VARHOME de Message Queue 3.0. Ce r�pertoire contient des fichiers li�s � la configuration et � la s�curit�. La plupart de ces donn�es sont compatibles avec Message Queue 3.5 et peuvent �tre conserv�es. Pour ce faire, suivez les instructions figurant dans le Guide d'installation de Message Queue.

Les probl�mes auxquels vous pouvez �tre confront� lors de la mise � niveau de Message Queue 3.0 vers Message Queue 3.5 sont les suivants :

Compatibilit� du courtier
Changements apport�s aux propri�t�s et aux attributs
Emplacement des fichiers publics .jar

Pour obtenir des informations concernant la compatibilit� des objets administr�s, des clients et des outils d’administration, consultez le Guide d'installation de Message Queue.

Compatibilit� du courtier

Un courtier Message Queue 3.5 pourra interagir avec un courtier Message Queue 3.0. Cependant, des changements ont �t� apport�s aux propri�t�s du courtier et au sch�ma du magasin persistant. Certaines donn�es de Message Queue 3.0 restent compatibles avec Message Queue 3.5. Pour plus d’informations, voir le Guide d'installation de Message Queue.

Changements apport�s aux propri�t�s et aux attributs

Cette section r�capitule les changements apport�s aux propri�t�s du courtier, aux attributs de destination et aux attributs de fabrique de connexion de Message Queue 3.5.

Propri�t�s du courtier     Les tableaux suivants pr�sentent les nouvelles propri�t�s, les propri�t�s abandonn�es et les changements de nom de propri�t� dans Message Queue 3.5. Pour plus d’informations, voir le chapitre 2 du Guide d'administration de Message Queue.

Tableau 4  Nouvelles propri�t�s du courtier de Message Queue 3.5 

Nom de la propri�t�	R�f�rence � la fonction
imq.persist.file.message.max_record.size	� Meilleures performances du magasin persistant � � la page 11
imq.persist.file.destination.message. filepool.limit	� Meilleures performances du magasin persistant � � la page 11
imq.metrics.topic.enabled	� API de contr�le � distance (Enterprise Edition) � � la page 8
imq.metrics.topic.interval	� API de contr�le � distance (Enterprise Edition) � � la page 8
imq.metrics.topic.persist	� API de contr�le � distance (Enterprise Edition) � � la page 8
imq.metrics.topic.timetolive	� API de contr�le � distance (Enterprise Edition) � � la page 8
imq.autocreate.destination.maxNumMsgs	� Meilleur contr�le du flux de messages du courtier � � la page 5
imq.autocreate.destination.maxTotalMsgBytes	� Meilleur contr�le du flux de messages du courtier � � la page 5
imq.autocreate.destination.maxBytesPerMsg	� Meilleur contr�le du flux de messages du courtier � � la page 5
imq.autocreate.destination.maxNumProducers	� Meilleur contr�le du flux de messages du courtier � � la page 5
imq.autocreate.queue.maxNumActiveConsumers	� Meilleures strat�gies de livraison de file d’attente (Enterprise Edition) � � la page 9
imq.autocreate.queue.maxNumBackupConsumers	� Meilleures strat�gies de livraison de file d’attente (Enterprise Edition) � � la page 9
imq.autocreate.queue.consumerFlowLimit	� Meilleur contr�le du flux du client Java � � la page 6 et � Meilleures strat�gies de livraison de file d’attente (Enterprise Edition) � � la page 9
imq.autocreate.topic.consumerFlowLimit	� Meilleur contr�le du flux du client Java � � la page 6
imq.autocreate.queue.localDeliveryPreferred	� Am�lioration des performances du cluster (Enterprise Edition) � � la page 10
imq.autocreate.destination.isLocalOnly	� Destinations locales (Enterprise Edition) � � la page 11

Tableau 5  Propri�t�s du courtier abandonn�es dans Message Queue 3.5  

Nom de la propri�t�
imq.persist.file.message.fdpool.limit
imq.persist.file.message.filepool.limit
imq.redelivered.optimization
imq.queue.deliverypolicy

Les tableaux suivants pr�sentent les nouveaux attributs de destination de Message Queue  3.5, ainsi que ceux qui ont �t� abandonn�s. Pour plus d’informations, voir le chapitre 6 du Guide d'administration de Message Queue.

Tableau 6  Nouveaux attributs de destination de Message Queue 3.5 

Type de destination	Nom d’attribut	R�f�rence � la fonction
File d’attente et rubrique	maxNumMsgs	� Meilleur contr�le du flux de messages du courtier � � la page 5
File d’attente et rubrique	maxTotalMsgBytes	� Meilleur contr�le du flux de messages du courtier � � la page 5
File d’attente et rubrique	limitBehavior	� Meilleur contr�le du flux de messages du courtier � � la page 5
File d’attente et rubrique	maxBytesPerMsg	� Meilleur contr�le du flux de messages du courtier � � la page 5
File d’attente et rubrique	maxNumProducers	� Meilleur contr�le du flux de messages du courtier � � la page 5
File d’attente uniquement	maxNumActiveConsumers	� Meilleures strat�gies de livraison de file d’attente (Enterprise Edition) � � la page 9
File d’attente uniquement	maxNumBackupConsumers	� Meilleures strat�gies de livraison de file d’attente (Enterprise Edition) � � la page 9
File d’attente et rubrique	consumerFlowLimit	� Meilleur contr�le du flux du client Java � � la page 6 et � Meilleures strat�gies de livraison de file d’attente (Enterprise Edition) � � la page 9
File d’attente uniquement	localDeliveryPreferred	� Am�lioration des performances du cluster (Enterprise Edition) � � la page 10
File d’attente et rubrique	isLocalOnly	� Destinations locales (Enterprise Edition) � � la page 11

Tableau 7  Attributs de destination abandonn�s dans Message Queue 3.5  

Type de destination	Nom d’attribut
File d’attente	QueueDeliveryPolicy

Attributs de fabrique de connexion     Les tableaux suivants pr�sentent les nouveaux attributs de fabrique de connexion de Message Queue 3.5. Pour plus d’informations, voir le chapitre 4 du Guide du d�veloppeur Message Queue Client Java. Notez que les attributs de fabrique de connexion de la version 3.0 de Message Queue sont toujours pris en charge par Message Queue 3.5. Ils continueront de l’�tre jusqu’� la prochaine version principale du produit Message Queue.

Tableau 8  Nouveaux attributs de fabrique de connexion de Message Queue 3.5 

Nom d’attribut	R�f�rence � la fonction
imqAddressList	� Reprise apr�s incident de la connexion au client Java (Enterprise Edition) � � la page 4
imqAddressListBehavior	� Reprise apr�s incident de la connexion au client Java (Enterprise Edition) � � la page 4
imqAddressListIterations	� Reprise apr�s incident de la connexion au client Java (Enterprise Edition) � � la page 4
imqReconnectEnabled	� Reprise apr�s incident de la connexion au client Java (Enterprise Edition) � � la page 4
imqReconnectAttempts	� Reprise apr�s incident de la connexion au client Java (Enterprise Edition) � � la page 4
imqReconnectInterval	� Reprise apr�s incident de la connexion au client Java (Enterprise Edition) � � la page 4
imqConsumerFlowLimit	� Meilleur contr�le du flux du client Java � � la page 6
imqConsumerFlowThreshold	� Meilleur contr�le du flux du client Java � � la page 6

Tableau 9  Attributs de la fabrique de connexion renomm�s 

Nom pr�c�dent	Nom dans Message Queue 3.5
imqFlowControlCount	imqConnectionFlowCount
imqFlowControlIsLimited	imqConnectionFlowLimitEnabled
imqFlowControlLimit	imqConnectionFlowLimit

Emplacement des fichiers publics .jar

Sur la plate-forme Solaris, les fichiers publics .jar ont �t� d�plac�s de l’ancien emplacement dans Message Queue 3.0 (/usr/share/lib/imq/) vers l’emplacement suivant dans Message Queue 3.0.1 : /usr/share/lib/. Les liens symboliques introduits dans Message Queue 3.0.1 � l’emplacement /usr/share/lib/imq/ des fichiers jar d�plac�s ont �t� supprim�s.

Cela concerne les fichiers .jar suivants :

jms.jar
imq.jar
imqxm.jar
activation.jar
saaj-api.jar
saaj-impl.jar
mail.jar
commons-logging.jar
jaxm-api.jar
fscontext.jar

Mises � jour de la documentation

Cette section pr�sente les changements apport�s � la documentation Message Queue des versions 3.5 SP1et 3.5.

Changements apport�s � la version 3.5 SP1

Les documents Message Queue 3.5 SP1 suivants ont �t� mis � jour par rapport � la version 3.5 du produit :

Guide d’installation

Le Guide d'installation de Message Queue a �t� mis � jour afin de refl�ter les changements de noms commerciaux et d’informations de prise en charge de la plate-forme.

Guide d’administration

Le nom du Guide d'administration de Message Queue a chang� (l’ancien nom �tait Guide de l’administrateur de Message Queue) et le document a �t� chang� pour refl�ter les changements de noms commerciaux. Ce document contient �galement un chapitre plus complet et actualis� d�crivant le contr�le des performances.

Guide du d�veloppeur Java Client

Le Guide du d�veloppeur Message Queue Client Java a �t� mis � jour pour refl�ter les changements de noms commerciaux.

Guide du d�veloppeur Client C

Le Guide du d�veloppeur Message Queue Client C a �t� mis � jour pour refl�ter les changements de noms commerciaux.

Changements apport�s � la version 3.5

Les documents Message Queue 3.5 suivants ont �t� mis � jour par rapport � la version 3.0.1 du produit : Ces mises � jour se trouvent sur le site Web de la documentation Message Queue 3.5 : http://docs.sun.com/coll/S1_MessageQueue_35.

Guide d’installation

Le produit Message Queue 3.5 contient un Guide d'installation de Message Queue actualis�. Celui-ci pr�sente les nouvelles exigences en mati�re de logiciel, les changements apport�s aux instructions relatives � l’installation de Solaris, une nouvelle proc�dure d’installation de Linux � l’aide de Red Hat Package Manager (RPM) et de la structure de r�pertoire install�s, ainsi que des changements mineurs dans l’installation de Windows.

Correction: En ce qui concerne la prise en charge de la persistance int�gr�e, le Tableau 1-2 pr�cise que la version 4.5 de PointBase est prise en charge par Message Queue. Il s’agit en fait de PointBase, Version 4.8.

Guide de l’administrateur

Le document Guide d'administration de Message Queue a �t� mis � jour pour refl�ter les changements apport�s � Message Queue 3.5 (consultez la rubrique � Cette section pr�sente les modifications pr�sentes dans Message Queue 3.5 SP1 ainsi que dans la version pr�c�dente, Message Queue 3.5. � � la page 2).

Guide du d�veloppeur Java Client

Le Guide du d�veloppeur Message Queue Client Java int�gre une grande partie des informations contenues dans Message Queue  Guide du d�veloppeur. Il a �t� mis � jour pour refl�ter les changements apport�s � Message Queue 3.5 (consultez la rubrique � Cette section pr�sente les modifications pr�sentes dans Message Queue 3.5 SP1 ainsi que dans la version pr�c�dente, Message Queue 3.5. � � la page 2).

Guide du d�veloppeur Client C

Le Guide du d�veloppeur Message Queue Client C est un nouveau manuel qui a �t� ajout� � la documentation Message Queue, en vue de pr�senter la cr�ation d’applications Client C Message Queue.

---

Probl�mes et limites connus

Cette section pr�sente les probl�mes, limites et bogues connus de Message Queue 3.5 SP1 et Message Queue 3.5. La version 3.5 SP1 �tant simplement une version renomm�e de Message Queue 3.5, les informations pr�sent�es dans cette section concernent les deux versions.

Pour conna�tre la liste des bogues en cours, leur �tat et les solutions possibles, les membres de Java Developer Connection™ peuvent consulter la page Bug Parade du site Web Java Developer Connection. Avant de signaler tout nouveau bogue, merci de consulter cette page. Bien que les bogues de Message Queue n’y soient pas tous 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 en question est la suivante :

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

Remarque	L’adh�sion � Java Developer Connection est gratuite, mais vous devez vous inscrire. Pour savoir comment devenir membre de Java Developer Connection, consultez la page Web "For Developers" de Sun.

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

Probl�mes connus

Cette section pr�sente les probl�mes connus de Message Queue 3.5 SP1. Certains sont apparus avec la version Message Queue 3.5. Cette section regroupe les probl�mes en fonction de leur pertinence pour Enterprise Edition et Platform Edition de Message Queue 3.5 ou Enterprise Edition uniquement.

Enterprise Edition et Platform Edition

À la suite du changement de nom commercial, les API qui auparavant renvoyaient la cha�ne suivante :

"Sun ONE Message Queue, Sun Microsystems, Inc."

renverront d�sormais :

"Sun Java(tm) System Message Queue"

À la suite du changement de nom commercial, les programmes Client C compil�s � l’aide de MQ 3.5 FCS qui font une comparaison exacte de la valeur associ�e � la propri�t� MQ_NAME_PROPERTY � partir de MQGetMetaData() �choueront s’ils utilisent la biblioth�que partag�e mqcrt de la version 3.5 SP1 lors de l’ex�cution.
Les plate-formes Windows limitent le nombre de connexions � un courtier pouvant �tre initi�es simultan�ment par TCP/IP, conform�ment � la taille maximale du backlog. Le backlog correspond au tampon des connexions de la pile TCP : le nombre de connexions TCP simultan�es ne peut pas d�passer la taille du backlog. Par exemple, le backlog est limit� � 5 sous Windows 2000 Professionnel et � 200 sous Windows 2000 Server.
Si vous utilisez Windows XP, le nombre de connexions entrantes est limit�. En ce qui concerne Windows XP Professionnel, lenombre maximal d’autres ordinateurs autoris�s � se connecter simultan�ment sur le r�seau est 10. Cette limite inclut tous les protocoles de transport et de partage de ressources combin�s. En ce qui concerne Windows XP �dition Familiale, le nombre maximal d’autres ordinateurs autoris�s � se connecter simultan�ment sur le r�seau est 5. Cette limite a une incidence sur le nombre de clients pouvant se connecter au courtier fonctionnant sous Windows XP.

Les fichiers, impressions, tubes nomm�s ou session de messagerie sans activit� sont automatiquement d�connect�s apr�s expiration du d�lai AutoDisconnect ; la valeur par d�faut du d�lai de la propri�t� AutoDisconnect est de 15 minutes. À la d�connexion de la session, l’une des dix connexions devient disponible pour qu’un autre utilisateur puisse se connecter au syst�me Windows XP. Par cons�quente, la r�duction du d�lai de la propri�t� AutoDisconnect peut permettre de r�soudre certains des probl�mes li�s � la limite de dix connexions ou de cinq connexions sur un syst�me qui n’est pas utilis� principalement en tant que serveur. Pour plus d’informations, reportez-vous aux pages suivantes :

http://support.microsoft.com/default.aspx?scid=kb;EN-US;314882

Vous ne pouvez pas modifier le fichier de configuration d’une instance de courtier sans avoir d�marr�, au moins une fois, cette instance. La raison en est 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	Emplacement
Solaris	/var/imq/instances/instanceName/props/config.properties
Linux	/var/opt/imq/instances/NomInstance/props/config.properties
Windows	IMQ_VARHOME\instances\NomInstance\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.
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 si elle tente d’utiliser le m�me ID client, 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 v�ritablement d’un 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.

Bogues connus

Le Tableau 10 r�pertorie les bogues subsistant dans Message Queue 3.5 SP1.

Tableau 10  Bogues connus dans Message Queue 3.5 

R�f�rence	D�tails
4683029	L’option -javahome dans tous les scripts Solaris/Windows ne fonctionne pas si la valeur comprend un espace. L’option -javahome est utilis�e par les commandes et les utilitaires de Message Queue pour indiquer un autre ex�cuteur Java 2 compatible que vous pouvez utiliser. 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 ayant des espaces :       Windows :       C:\jdk 1.4 (sous Windows les espaces sont autoris�s dans le chemin si celui-ci est compris entre des guillemets, comme dans l’exemple “C:\jdk 1.4”)       Solaris :       /work/java 1.4 Solution : installez l’ex�cuteur Java � un emplacement ou dans un chemin ne contenant pas d’espace.
4939923	Le courtier peut provoquer des exceptions NullPointerException lors de l’utilisation d’un pool de threads partag�s, si la JVM du courtier dispose de peu de m�moire.   Solution : aucune. Ce bogue est r�solu dans J2SE 1.4.2_03.
4941058	Les destinations dont le contr�le de flux est activ� peuvent ne pas atteindre la limite maximale. Dans certains cas, les producteurs ne peuvent pas envoyer des messages � une destination avant que celle-ci n’atteigne sa limite maximale configur�e.   Solution : aucune.
4941066	Les destinations peuvent d�passer l�g�rement les limites attribu�es.   Solution : aucune.
4941127	Une destination ne se charge pas compl�tement si un message d�passe la limite de taille des messages individuels. Si la limite de la taille des messages autoris�e dans une destination est modifi�e apr�s le stockage d’un message plus volumineux, la destination ne se charge pas correctement.   Solution : augmentez la limite de taille des messages jusqu’� ce que le message volumineux soit consomm�, puis abaissez-la. Il est possible d’interrompre la production vers la destination pendant ce laps de temps, afin d’emp�cher l’acceptation d’autres messages volumineux.
4946531	Des exceptions NullPointerException inoffensives peuvent survenir lors de la production de messages, bien que cela soit rare.   Solution :   aucune ; vous pouvez passer outre cette exception sans crainte.
4949398	Le param�tre imqcmd query dst transmet des valeurs incorrectes pour les propri�t�s Nombre de messages et Taille totale des messages lorsque la destination correspondante est en cours de chargement. Les valeurs transmises sont correctes avant et apr�s le chargement de la destination. Solution : le probl�me survient uniquement lors du chargement de la destination. Apr�s le chargement, les valeurs renvoy�es sont correctes.
4950166	Erreurs al�taoires du courtier lors de son ex�cution sous les syst�mes jdk1.4.2_02 et x86. Pour plus d’informations, reportez-vous au bogue J2SE 4947404.   Solution : d�marrez le courtier � l’aide de -XX:UseSSE=0, par exemple. imqbrokerd -tty -vmargs -XX:UseSSE=0
4950601	Le param�tre imqcmd metrics dst d�clenche une erreur interne du courtier qui s’imprime lors de l’utilisation du magasin JDBC persistant. Les param�tres li�s � l’utilisation du disque concernent uniquement le magasin de fichiers. Cependant, lors de l’extraction de ces param�tres, le courtier tente d’obtenir les informations li�es � l’utilisation du disque quel que soit le type de magasin. Si vous utilisez une base de donn�es au lieu d’un magasin de fichiers, le courtier imprime le message d’erreur suivant :   06/Nov/2003:22:57:36 PST] ERROR [B3100]: Erreur interne du courtier inattendue    Erreur : [unable to disk usage for destinationT:topic1] :   com.sun.messaging.jmq.jmsserver.util.BrokerException:   Cette op�ration ne s’applique pas au magasin persistant int�gr�.   Solution : aucune.
4951010	Dans un cluster de courtiers, un courtier place les messages dans une file d’attente vers une connexion � distance qui n’est peut-�tre pas d�marr�e.   Solution : le consommateur re�oit les messages une fois la connexion d�marr�e. Les messages seront livr�s � un autre consommateur si la connexion du consommateur est d�sactiv�e.
4953348	Le param�tre HTTPS createQueueConnection d�clenche occasionnellement une exception sous Windows 2000.   Solution : relancez la connexion.
4953354	Le courtier devient inaccessible lorsque le magasin persistant ouvre trop de destinations. Solution : ce probl�me vient du fait que le courtier a atteint la limite des descripteurs de fichiers ouverts. Sous Solaris et Linux, faites appel � la commande ulimit pour augmenter le nombre limite de descripteurs de fichiers.
4954974	L’installation par CD ne d�marre pas automatiquement sous Windows XP.   Solution : dans l’Explorateur Windows, double-cliquez sur le dossier Windows du CD, puis double-cliquez sur le fichier imq3_5-ent-win.exe pour lancer l’installation.
4983525	La cr�ation d’un producteur de messages pour une destination cr��e automatiquement peut �chouer   sous Linux Red Hat Advanced Server 3.0.   Solution : tentez de cr�er � nouveau le producteur. Vous devriez y parvenir la seconde fois. Vous pouvez �galement avoir recours � une destination cr��e administrativement.
4986318	Le client peut g�n�rer un message ACKNOWLEDGE_REPLY de mani�re inattendue : ******** Packet: ACKNOWLEDGE_REPLY(25):26-192.18.86.227-42976-1075458056557 Magic/Version: 469754818/301  Size: 97 Type: ACKNOWLEDGE_REPLY(25) Expiration: 0   Timestamp: 1075458056557 Source IP: 192.18.86.227   Source Port: 42976  Sequence: 26 Solution : aucune. Il existe une condition de synchronisation rare dans le courtier qui fait en sorte que le client g�n�re cette erreur. Vous pouvez passer outre cette erreur. Aucun message ne sera perdu.
4991257	L’envoi de messages permanents volumineux � des abonn�s durables dans un cluster de courtiers dans lequel le magasin persistant est JDBC peut entra�ner un blocage du courtier et/ou g�n�rer des erreurs.     Solution : augmentez le d�lai d’expiration du protocole de verrouillage du courtier, � l’aide de la propri�t� suivante du courtier : imq.cluster.timeout=<expiration-en-secondes> La valeur par d�faut est 60. Si le stockage des messages volumineux s’av�re lent, il se peut que vous deviez r�gler la base de donn�es du magasin persistant ou basculer vers un magasin persistant diff�rent.
5006686	L’exemple ARGS contenu dans le param�tre imqbrokerd.conf est incorrect.   Solution : les valeurs ne doivent pas figurer entre guillemets. ARGS="-name newbroker -port 8888  " La valeur doit appara�tre comme suit : ARGS=-name newbroker -port 8888

---

Fichiers redistribuables

Sun Java System Message Queue  3.5 SP1 contient l’ensemble de fichiers suivants, 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

En outre, vous pouvez �galement redistribuer les fichiers LICENSE et COPYRIGHT.

---

Communication de probl�mes et formulation de commentaires

Pour signaler un probl�me, envoyez un courrier �lectronique � l’adresse imq-feedback@sun.com.

Si vous b�n�ficiez d’un contrat d’assistance Message Queue, contactez l’assistance client d’une des mani�res suivantes :

Services d’assistance logicielle Sun en ligne � l’adresse
http://www.sun.com/service/sunone/software

Ce site contient des liens vers la base de connaissances, le centre d’assistance en ligne et ProductTracker, ainsi que vers des programmes de maintenance et les coordonn�es des services d’assistance.

Le num�ro de t�l�phone associ� � votre contrat de maintenance.

Afin de nous aider � r�soudre vos probl�mes, pensez � r�unir les informations suivantes lorsque vous contactez l’assistance technique :

Description du probl�me, y compris l’endroit o� il se produit et son impact sur l’exploitation.
Type de machine, versions du syst�me d’exploitation et du produit, y compris les correctifs et autres logiciels pouvant avoir un lien avec le probl�me.
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.

---

Sun attend vos commentaires

Afin d’am�liorer sa documentation, Sun vous encourage � faire des commentaires et � apporter des suggestions. Pour ce faire, utilisez le formulaire �lectronique disponible � l’adresse suivante :

http://www.sun.com/hwdocs/feedback/

Veuillez indiquer le titre complet du document ainsi que son num�ro dans les champs appropri�s. Le num�ro du document se trouve sur la page de titre du manuel ou en haut du document. Il s’agit g�n�ralement d’un nombre � 7 ou 9 chiffres. Par exemple, le num�ro de r�f�rence des pr�sentes Message Queue 3.5 SP1 Notes de mise � jour est 817-7200-10.

---

Ressources Sun suppl�mentaires

Outre la documentation relative � Message Queue, vous disposez des ressources d’information suivantes :

Forums de discussion

Sun Java System Forum concernant le logiciel

Il existe un forum Sun Java System Message Queue  � l’adresse suivante :

http://softwareforum.sun.com/NASApp/jive/forum.jsp?forum=24

Votre participation y est 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

Base de connaissances SunSolve

Des informations relatives � Sun Java System Message Queue  sont disponibles dans la base de connaissances SunSolve Knowledge, � l’adresse suivante :

http://sunsolve.Sun.COM/pub-cgi/search.pl?mode=advanced

Cochez la case � All Free Collections �, puis effectuez une recherche sur � Message Queue �.

Informations relatives � Sun Java System

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

Page relative aux produits Message Queue 
http://wwws.sun.com/software/products/message_queue/index.html
Documentation relative � Message Queue 
http://docs.sun.com/coll/MessageQueue_35_SP1
Documentation relative � Sun
http://docs.sun.com/
Produits et services Sun Java System Software
http://www.sun.com/software
Services d’assistance logicielle de Sun
http://www.sun.com/service/sunone/software
Base de connaissance et d’assistance Sun
http://sunsolve.sun.com
Services de formation et d’assistance Sun
http://www.sun.com/supportraining
Informations destin�es aux d�veloppeurs Sun
http://developers.sun.com/
Services d’assistance pour d�veloppeurs Sun
http://www.sun.com/developers/support
Fiches techniques sur les logiciels Sun
http://www.sun.com/software

---

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

Droits soumis � la loi am�ricaine - Logiciel de commerce. Les utilisateurs de l’�tat sont soumis au contrat de licence standard de Sun Microsystems, Inc. ainsi qu’aux clauses applicables du FAR et de ses suppl�ments. L’utilisation est soumise aux termes du contrat de licence. La distribution du logiciel peut s’accompagner de celle de composants mis au point par des tiers.

Sun, Sun Microsystems, le logo Sun, Java, Solaris et Sun[tm] ONE sont des marques 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 dans le cadre d’un contrat de licence et sont des marques 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, sous licence exclusive de X/Open Company, Ltd.