Mediante el proveedor de mensajería de IBM MQ en Liberty, las aplicaciones de mensajería Java™ Message Service (JMS) utilizan
el sistema IBM MQ como un proveedor
externo de los recursos de mensajería JMS.
Antes de empezar
Debe asegurarse de que se ha creado un servidor Liberty en el que desea desplegar la aplicación de mensajería que utiliza JMS. Para obtener más
información, consulte Creación manual de un servidor de Liberty.
Acerca de esta tarea
La característica wmqJmsClient-2.0 proporciona soporte para aplicaciones que utilizan las especificaciones JMS 2.0.
Nota: La característica wmqJmsClient-2.0 admite las características de las especificaciones JMS 1.1 y JMS 2.0. Sin embargo, puede decidir utilizar la característica wmqJmsClient-1.1 si desea utilizar solamente las características que son compatibles con la especificación JMS 1.1.
Procedimiento
- Añada la característica wmqJmsClient-2.0 al archivo
server.xml. Si desea realizar
una búsqueda JNDI, debe añadir también la característica jndi-1.0.
<featureManager>
<feature>wmqJmsClient-2.0</feature>
<feature>jndi-1.0</feature>
</featureManager>
La adición de la característica wmqJmsClient-2.0 permite que
el servidor Liberty cargue los paquetes de IBM MQ necesarios
que permiten definir los recursos JMS de IBM MQ. Por ejemplo,
la fábrica de conexiones y las propiedades de especificación de activación proporcionan bibliotecas de clientes
para conectarse a la red de IBM MQ.
- Especifique la ubicación de IBM MQ Resource Adapter añadiendo la entrada siguiente al archivo server.xml:
<variable name="wmqJmsClient.rar.location" value="/path/to/wmq/rar/wmq.jmsra.rar"/>
donde
el atributo
value especifica la vía de acceso absoluta del archivo
de
IBM MQ Resource
Adapter,
wmq.jmsra.rar.
Para obtener detalles de las versiones admitidas y cómo obtener el archivo
wmq.jmsra.rar, consulte la nota técnica 1633761 de IBM MQ. Consiga el archivo wmq.jmsra.rar e instálelo desde Fix Central.
- Añada las definiciones de fábrica de conexiones al archivo server.xml.
<jmsConnectionFactory jndiName="jms/wmqCF" connectionManagerRef="ConMgr6">
<properties.wmqJms
transportType="CLIENT"
hostName="localhost"
port="1414"
channel="SYSTEM.DEF.SVRCONN"
queueManager="QM1"/>
</jmsConnectionFactory>
<connectionManager id="ConMgr6" maxPoolSize="2"/>
<jmsQueue id="jms/queue1" jndiName="jms/wmqQ1">
<properties.wmqJms
baseQueueName="MDBQ"
baseQueueManagerName="QM1"/>
</jmsQueue>
- Configure aplicaciones JMS para conectarse en la modalidad BINDINGS.
Para permitir que las aplicaciones JMS se conecten utilizando las memorias compartidas o en la modalidad BINDINGS a
IBM MQ, debe tener tanto
Liberty como
IBM MQ desplegados en el mismo servidor. Para permitir que las aplicaciones JMS se conecten en la modalidad BINDINGS, utilice el elemento
nativeLibraryPath en el archivo
server.xml para especificar la ubicación de las bibliotecas nativas de
IBM MQ.
<wmqJmsClient nativeLibraryPath="/opt/mqm/java/lib64"/>
Nota: Para utilizar la modalidad BINDINGS, el servidor se debe configurar con la característica zosTransaction-1.0.