Propriétés personnalisées de IBM MQ

WebSphere Application Server prend en charge l'utilisation des propriétés personnalisées pour définir les propriétés de IBM MQ. Cette fonction est utile car elle permet à WebSphere Application Server d'utiliser des versions ultérieures de IBM MQ pouvant comporter des propriétés non disponibles dans la console d'administration de WebSphere Application Server.

Dans WebSphere Application Server Version 7.0 ou ultérieures, les propriétés personnalisées que vous définissez sont validées par l'adaptateur de ressources IBM MQ contenu dans WebSphere Application Server. Dans les éditions précédentes, cette étape était exécutée dans WebSphere Application Server, puis par les fichiers jar du client IBM MQ. Si vous avez défini une propriété non valide pour IBM MQ, l'adaptateur de ressources IBM MQ crée une exception interceptée par WebSphere Application Server, puis consignée dans les fichiers Systemout.log et SystemErr.log. Vous trouverez des exemples de messages d'erreurs à la fin de cette rubrique.

Lorsqu'une version ultérieure de IBM MQ prise en charge par l'installation de WebSphere Application Server est disponible, de nouvelles propriétés IBM MQ inconnues de WebSphere Application Server peuvent être créées. Vous pouvez configurer ces dernières comme des propriétés personnalisées via WebSphere Application Server. Elles sont ainsi reconnues par l'adaptateur de ressources IBM MQ. Vous pouvez également configurer WebSphere Application Server de sorte à pointer vers l'adaptateur de ressources IBM MQ du fournisseur JMS externe, comme décrit dans Configuration du fournisseur de messagerie IBM MQ avec des informations de bibliothèques natives.

Pour plus d'informations sur les valeurs valides des propriétés IBM MQ, consultez les sections Using Java et System Administration du centre de documentation de IBM MQ.

Remarque : Cette rubrique fait référence à un ou plusieurs des fichiers journaux de serveur d'applications. Il est recommandé de configurer le serveur de telle sorte qu'il utilise l'infrastructure de journalisation et de trace HPEL (High Performance Extensible Logging) à la place des fichiers SystemOut.log, SystemErr.log, trace.log et activity.log sur les systèmes distribués et IBM® i. Vous pouvez également utiliser HPEL conjointement avec vos fonctions de journalisation z/OS natives. Si vous utilisez l'infrastructure HPEL, vous pouvez accéder à toutes les informations de journalisation et de trace en utilisant l'outil de ligne de commande LogViewer à partir de votre répertoire bin de profil de serveur. Pour plus d'informations sur l'utilisation de HPEL, voir les informations sur l'utilisation de HPEL en vue du traitement des incidents liés aux applications.

Les scénarios suivants illustrent la façon dont différentes configurations de cellules peuvent être affectées.

Scénario avec noeuds mixtes

Dans ce scénario incluant plusieurs types de noeud, une cellule est constituée d'un gestionnaire WebSphere Application Server, Version 9.0, de deux noeuds WebSphere Application Server, Version 6 et de deux noeuds WebSphere Application Server, Version 9.0. Si une fabrique de connexions IBM MQ est définie au niveau de la cellule et possède des propriétés personnalisées qui exploitent les nouvelles zones disponibles IBM MQ, cette fabrique est uniquement liée aux cellules WebSphere Application Server se trouvant au niveau Version 9.0. Les noeuds WebSphere Application Server Version 6 n'ont pas connaissance des nouvelles propriétés IBM MQ et ne sont pas liés à JNDI (Java™ Naming and Directory Interface). Les améliorations apportées à WebSphere Application Server Version 9.0 permettent de valider les propriétés devant être différées dans l'adaptateur de ressources IBM MQ.
Figure 1. Scénario incluant des noeuds mixtes

Scénario WebSphere MQ Version 7 ou version ultérieure

Dans ce scénario, une cellule est constituée d'un gestionnaire de déploiement WebSphere Application Server, Version 9.0 et de noeuds. Le fournisseur de messagerie IBM MQ s'exécute à un niveau postérieur à Version 6. WebSphere Application Server utilise l'adaptateur de ressources IBM MQ par défaut livré avec WebSphere Application Server Version 9.0. Dans ce scénario, l'adaptateur de ressources IBM MQ ne connaît pas les nouvelles propriétés IBM MQ. Il en résulte que la validation échoue et que la fabrique de connexions n'est pas liée à JNDI.
Figure 2. Scénario incluant une version future de IBM MQ

Scénario incluant une configuration correcte

Dans ce scénario similaire au précédent, une cellule est constitué d'un gestionnaire de déploiement WebSphere Application Server Version 9.0 et de noeuds. Le fournisseur de messagerie IBM MQ s'exécute à un niveau postérieur à Version 6. Pour pouvoir utiliser les nouvelles propriétés IBM MQ, vous devez configurer WebSphere Application Server de telle sorte qu'il désigne l'adaptateur de ressources IBM MQ associé à la dernière version de IBM MQ.
Figure 3. Scénario incluant une configuration correcte

Exemple de message d'erreur

L'exception créée par l'adaptateur de ressources contient des messages d'erreur similaires à l'exemple suivant :
[09/02/06 15:40:06:377 GMT] 0000000a ContainerImpl E   WSVR0501E: Error creating
component null [class com.ibm.ws.runtime.component.ApplicationServerImpl]
com.ibm.ws.exception.RuntimeWarning: com.ibm.ws.runtime.component.binder.
ResourceBindingException: invalid configuration passed to resource binding logic.
REASON: Failed to create connection factory: Error raised constructing AdminObject,
error code: XAQCF PropertyName : XAQCF PropertyName
PropertyName est le nom de la propriété non valide.

Icône indiquant le type de rubrique Rubrique de concept



Icône d'horodatage Dernière mise à jour: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cmm_customprops
Nom du fichier : cmm_customprops.html