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.

Nota: En este tema se hace referencia a uno o más de los archivos de registro del servidor de aplicaciones. Como alternativa recomendada, puede configurar el servidor para utilizar la infraestructura de registro y rastreo HPEL en lugar de utilizar los archivos SystemOut.log , SystemErr.log, trace.log y activity.log en sistemas distribuidos y de IBM® i. Puede también utilizar HPEL junto con sus recursos de registro nativos de z/OS. Si utiliza HPEL, puede acceder a toda la información de registro y rastreo utilizando la herramienta de línea de mandatos LogViewer desde el directorio bin de perfil de servidor. Consulte la información sobre la utilización de HPEL para resolver problemas de aplicaciones para obtener más información sobre la utilización de HPEL.

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.
Figura 1. Caso de ejemplo de nodos combinados

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.
Figura 2. Escenario de versión futura de IBM MQ

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.
Figura 3. Caso de ejemplo configurado correctamente

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.

Icon that indicates the type of topic Concept topic



Timestamp icon Last updated: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=cmm_customprops
File name: cmm_customprops.html