Propiedades personalizadas de IBM MQ
WebSphere Application Server da soporte al uso de propiedades personalizadas para definir las propiedades de IBM MQ. Esto es útil porque permite a WebSphere Application Server trabajar con versiones posteriores de IBM MQ que podrían tener propiedades que no están disponibles en la consola administrativa de WebSphere Application Server.
Para WebSphere Application Server Versión 7.0 o posterior, las propiedades personalizadas que define las valida el adaptador de recursos de IBM MQ incluido en WebSphere Application Server. En releases anteriores, esto se realizó en el propio WebSphere Application Server y, a continuación, por los archivos jar del cliente de IBM MQ. Si ha definido una propiedad que no es válida para IBM MQ, el adaptador de recursos de IBM MQ crea una excepción, que detecta WebSphere Application Server y se registra en los archivos Systemout.log y SystemErr.log. Se proporcionan mensajes de error al final de este tema.
Cuando está disponible una versión posterior de IBM MQ que está soportada por la instalación de WebSphere Application Server, se pueden crear nuevas propiedades de IBM MQ desconocidas para WebSphere Application Server. Puede configurar estas propiedades como propiedades personalizadas a través de WebSphere Application Server para que sean reconocidas por el adaptador de recursos de IBM MQ. También puede configurar WebSphere Application Server para que apunte al adaptador de recursos de IBM MQ en el proveedor de JMS externo, tal como se describe en Configuración del proveedor de mensajería de IBM MQ con información de bibliotecas nativas.
Para obtener información sobre valores válidos para las propiedades de IBM MQ, consulte las secciones Utilización de Java y Administración del sistema del Information Center de IBM MQ.
Los siguientes casos de ejemplo ilustran cómo distintas configuraciones de célula pueden verse afectadas.
Caso de ejemplo de nodos combinados
En este escenario de nodo mixto, una célula consta de un WebSphere Application Server, un gestor de despliegue de Versión 9.0, dos nodos de WebSphere Application Server, Versión 6 y dos nodos de WebSphere Application Server, Versión 9.0. Si se ha definido una fábrica de conexiones de IBM MQ a nivel de célula y tiene propiedades personalizadas definidas que aprovechan los campos nuevos disponibles en IBM MQ, la fábrica de conexiones sólo se enlaza en las células de WebSphere Application Server que están en el nivel de la Versión 9.0. Los nodos de WebSphere Application Server, Versión 6 no tienen conocimiento de las nuevas propiedades de IBM MQ y no se enlazan en el JNDI (Java™ Naming and Directory Interface). Las mejoras realizadas en WebSphere Application Server, Versión 9.0 permiten que se difiera la validación de las propiedades al adaptador de recursos de IBM MQ.
Escenario de WebSphere MQ versión 7 o posterior
En este caso de ejemplo, una célula consta de un gestor de despliegue de WebSphere Application Server, Versión 9.0 y de nodos. El proveedor de mensajería de IBM MQ se ejecuta en un nivel posterior a Versión 6. WebSphere Application Server utiliza el adaptador de recursos de IBM MQ predeterminado que se proporciona con WebSphere Application Server Versión 9.0. En este escenario el adaptador de recursos de IBM MQ no tiene conocimiento de las nuevas propiedades de IBM MQ de forma que la validación falla y la fábrica de conexiones no se enlaza en el JNDI.
Caso de ejemplo configurado correctamente
En este escenario, que es parecido al anterior, una célula consta de un gestor de despliegue y nodos de WebSphere Application Server, Versión 9.0. El proveedor de mensajería de IBM MQ se ejecuta en un nivel posterior a Versión 6. Para utilizar correctamente las nuevas propiedades de IBM MQ, es necesario configurar el WebSphere Application Server para apuntar al adaptador de recursos de IBM MQ asociado a la versión posterior de IBM MQ.
Ejemplo de mensaje de error
La excepción generada por el adaptador de recursos contiene mensajes de error similares a los del ejemplo siguiente:[09/02/06 15:40:06:377 GMT] 0000000a ContainerImpl E WSVR0501E: Se
ha producido un error al crear el componente nulo [class com.ibm.ws.runtime.component.ApplicationServerImpl]
com.ibm.ws.exception.RuntimeWarning: com.ibm.ws.runtime.component.binder.
ResourceBindingException: se ha pasado un configuración no válida a la lógica de enlace de recursos.
RAZÓN: se ha producido un error al crear una fábrica de conexiones: se ha
producido un error al crear dminObject,
código de error: XAQCF PropertyName : XAQCF PropertyName
donde PropertyName es el nombre de la
propiedad no válida.