Configuración de ejemplo de enlace IBM MQ
Esta configuración de ejemplo ilustra cómo se puede utilizar un enlace IBM MQ para conectar la mensajería de integración de servicios de WebSphere Application Server a la mensajería de IBM MQ.
Un enlace IBM MQ conecta un motor de mensajería de integración de servicios, que se conoce como el motor de mensajería de pasarela, a un gestor de colas o un grupo de compartimiento de colas IBM MQ, que se conoce como el gestor de colas de pasarela. Todos los motores de mensajería del bus de integración de servicios utilizan el motor de mensajería de pasarela para dirigir mensajes a y desde la red IBM MQ; todos los gestores de colas y grupos de compartimiento de colas de la red IBM MQ utilizan el gestor de colas de pasarela para dirigir mensajes a y desde el bus de integración de servicios.
- El canal emisor del enlace IBM MQ, que transmite mensajes de la integración de servicios a IBM MQ.
- El canal receptor del enlace IBM MQ, que transmite los mensajes de WebSphere MQ a la integración de servicios.

Si sólo requiere que los mensajes fluyan en una dirección, solo necesita definir una conexión TCP/IP. Por ejemplo, un canal emisor del enlace IBM MQ en la integración de servicios que se conecta a un canal receptor en IBM MQ es suficiente para dar soporte a flujo de mensajes desde la integración de servicios a IBM MQ. No obstante, este ejemplo crea una configuración que permite que los mensajes fluyan en ambas direcciones.
Contexto de configuración de ejemplo
- Un servidor de aplicaciones denominado server1 ubicado en un nodo denominado London. En un entorno de despliegue de red, server1 puede ser uno de varios servidores de una célula y puede ser uno de varios servidores de un clúster, pero en este ejemplo es igualmente aplicable a un despliegue base que contiene un solo servidor de aplicaciones.
- El nombre de host IP del servidor London es LONDON.
- Un bus de integración de servicios denominado BUS1.
- server1 es miembro de BUS1; el motor de mensajería que contiene se denomina London.server1-BUS1.
- Un destino de bus de tipo de cola denominado ServiceIntegrationQueue1, que es uno de los destinos en BUS1.
- Los gestores de colas denominados QM01 y QM02 que forman parte de una red de gestores de colas y grupos de compartimiento de colas IBM MQ interconectados. Si sólo tiene un gestor de colas, puede ignorar las referencias a QM02 en este ejemplo.
- El nombre de host IP del servidor donde se ejecuta QM01 es PARIS.
- Una cola denominada WMQ11 que se encuentra en QM01 y una cola denominada WMQ21 que se encuentra en QM02. Puede haber muchas otras colas definidas en la red IBM MQ, pero en este ejemplo sólo importan las dos colas IBM MQ a las que va a acceder desde WebSphere Application Server.
Va a seleccionar London.server1-BUS1 para que sea el motor de mensajería de pasarela y QM01 para que sea el gestor de colas de pasarela.
Ejemplo de configuración para las conexiones
- Los mandatos que el administrador de IBM MQ utiliza para configurar los componentes de IBM MQ que se corresponden con el enlace IBM MQ:
- El canal emisor
- El canal receptor
- La cola de transmisión
- Los parámetros que necesita cuando utiliza la consola administrativa de WebSphere Application Server para la configuración:
- Una conexión de bus foráneo, que incluye el bus foráneo que representa la red de gestores de colas y grupos de compartimiento de colas IBM MQ, y el enlace IBM MQ que representa la conexión a dicha red
- Destinos de JMS que identifican las colas de la red IBM MQ
Después de que se hayan configurado y activado estos componentes, las aplicaciones pueden intercambiar mensajes entre la mensajería de integración de servicios de WebSphere Application Server y la mensajería de IBM MQ. Opcionalmente, puede configurar artefactos administrativos adicionales que permiten controlar de forma más detallada las colas y los destinos; consulte Configuración de ejemplo para los destinos.
- Mandato de IBM MQ para configurar el canal emisor
El administrador de IBM MQ elige el nombre del canal emisor, que en este ejemplo es QM01.TO.BUS1.DEFINE CHL(QM01.TO.BUS1) + CHLTYPE(SDR) + TRPTYPE(TCP) + CONNAME('LONDON(5558)') + XMITQ(BUS1)
El parámetro CONNAME especifica el host IP y el puerto del motor de mensajería de pasarela.
El parámetro XMITQ especifica el nombre de la cola de transmisión, que suele ser el mismo que el nombre del gestor de colas virtual del bus de integración de servicios, que es preferiblemente el mismo que el nombre del bus.
- Mandato de IBM MQ para configurar el canal receptor
El administrador de IBM MQ elige el nombre del canal receptor, que en este ejemplo es BUS1.TO.QM01.DEFINE CHL(BUS1.TO.QM01) + CHLTYPE(RCVR) + TRPTYPE(TCP)
- Mandato de IBM MQ para configurar la cola de transmisión
El administrador de IBM MQ elige el nombre de la cola de transmisión, pero es conveniente utilizar el nombre del bus de integración de servicios BUS1. Si el nombre de bus de integración de servicios no es un nombre de gestor de colas IBM MQ válido, el administrador de WebSphere Application Server debe definir un nombre de gestor de colas virtual diferente para su uso aquí.DEFINE QL(BUS1) + USAGE(XMITQ)
- Mandato JMSAdmin de IBM MQ para configurar el destino de JMS
Las aplicaciones JMS de IBM MQ pueden utilizar este destino de JMS para enviar mensajes al destino de bus de integración de servicios ServiceIntegrationQueue1 en BUS1.DEFINE Q(ServiceIntegrationQueue1) + QMGR(BUS1) + QUEUE(ServiceIntegrationQueue1)
- Parámetros de WebSphere Application Server para la conexión de bus foráneo
- Debe configurar una conexión de bus foráneo como parte de la topología del bus de integración de servicios. En este ejemplo, el bus de integración de servicios es BUS1 y la conexión de bus foráneo utiliza los valores siguientes:
Hay otras opciones en el asistente relacionadas con la mensajería de publicación/suscripción y la seguridad. Deje estas opciones con los valores predeterminados.Valor Valor Tipo de conexión de Bus Conexión directa Tipo de bus foráneo IBM MQ Motor de mensajería para albergar la conexión London.server1-BUS1 Nombre de gestor de colas virtual BUS1 (utilice el nombre del bus local) Nombre de bus foráneo QM01 (utilice el nombre del gestor de colas de pasarela IBM MQ) Nombre del enlace MQ TO.QM01 Habilitar el bus de integración de servicios en el flujo de mensajes de IBM MQ Seleccionado (valor predeterminado) Nombre del canal receptor de IBM MQ BUS1.TO.QM01 Nombre de host PARIS Puerto 1414 Habilitar IBM MQ en el flujo de mensajes del bus de integración de servicios Seleccionado (valor predeterminado) Nombre del canal emisor de IBM MQ QM01.TO.BUS01
- Parámetros de WebSphere Application Server para los destinos de JMS
- Debe configurar los destinos de JMS para permitir a las aplicaciones JMS de integración de servicios acceder a las colas en la red IBM MQ. Este ejemplo necesita destinos de JMS para la cola WMQ11 del gestor de colas QM01 y para la cola WMQ21 del gestor de colas QM02.
Tenga en cuenta que estos destinos de JMS son las colas IBM MQ pero para los fines de este ejemplo accederá a estas colas desde programas JMS de integración de servicios, de modo que debe definir destinos de JMS para el proveedor de mensajería predeterminado (integración de servicios) y no para el proveedor de JMS de IBM MQ.
Para WMQ11, configure los parámetros siguientes:
Deje todos los demás parámetros con los valores predeterminados.Parámetro Valor Name WMQ11 Nombre JNDI jms/WMQ11 Nombre de bus QM01 Nombre de cola WMQ11 Para WMQ21, configure los parámetros siguientes:
Deje todos los demás parámetros con los valores predeterminados.Parámetro Valor Name WMQ21 Nombre JNDI jms/WMQ21 Nombre de bus QM01 Nombre de cola WMQ21@QM02
Configuración de ejemplo para los destinos
- El destino de JMS de IBM MQ apunte a una cola IBM MQ (de hecho se trata de una cola remota o de alias) que apunta al destino de integración de servicios.
- Los destinos de JMS de integración de servicios apunten a los destinos de integración de servicios (de hecho se trata de destinos foráneos o de alias) que apuntan a las colas IBM MQ.
Consulte la documentación de IBM MQ para obtener información sobre cuándo y cómo definir colas remotas y de alias.
- Parámetros de WebSphere Application Server para los destinos foráneos
- Debe configurar destinos foráneos para las colas IBM MQ para permitir el control sobre cómo acceden las aplicaciones de integración de servicios a cada cola. Por ejemplo, puede configurar destinos foráneos para cada una de las dos colas y especificar que la integración de servicios incluye una cabecera MQRFH2 en los mensajes a una cola pero no a la otra.
Debe configurar los destinos foráneos como recursos de destino del bus de integración de servicios.
Para WMQ11, configure los parámetros siguientes:
Deje todos los demás parámetros con los valores predeterminados.Parámetro Valor Identificador WMQ11 Bus QM01 Para WMQ21, configure los parámetros siguientes:
Si el destino externo es un destino de IBM MQ, el identificador debe tener el formato qName@qmName, donde qName es el nombre de la cola y qName es el nombre del gestor de colas. En este ejemplo, el identificador de WMQ21 en el gestor de colas QM02 es WMQ21@QM02.Parámetro Valor Identificador WMQ21@QM02 Bus QM01 Deje todos los demás parámetros con los valores predeterminados.
Después de definir estos destinos foráneos puede, por ejemplo, establecer la propiedad personalizada _MQRFHAllowed para cualquiera de los dos destinos o para ambos, según sea necesario.