Mediante el proveedor de mensajería de IBM MQ
de 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 de JMS.
Antes de empezar
Debe asegurarse de que se ha creado un servidor de 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 de 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 las aplicaciones JMS para conectarse en la modalidad BINDING.
Para permitir que las aplicaciones JMS se conecten utilizando las memorias compartidas o en modalidad BINDING
a
IBM MQ, debe tener desplegados Liberty y
IBM MQ en el mismo servidor. Para permitir que las aplicaciones JMS
se conecten en modalidad BINDING, 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"/>