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.
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.
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.
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.
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
où PropertyName est le nom de la propriété non valide.