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.

Normalmente, un enlace IBM MQ consta de dos conexiones TCP/IP:
  • 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.
IBM MQ llama a estos canales de mensajes de conexiones TCP/IP, un canal receptor que se conecta al canal emisor del enlace IBM MQ y un canal emisor que conecta al canal receptor del enlace IBM MQ. En la figura siguiente se muestra una configuración como la que acaba de describir, con un canal emisor del enlace WebSphere MQ denominado BUS1.TO.QM01 y un canal receptor del enlace IBM MQ denominado QM01.TO.BUS1.
Un bus de integración de servicios denominado BUS1 contiene tres motores de mensajería, uno de los cuales es un motor de mensajería de pasarela. Una red de WebSphere MQ, que se considera un bus, contiene dos gestores de colas QM01 y QM02. QM01 es el gestor de colas de pasarela. El bus de integración de servicios y el "bus" WebSphere MQ están conectados mediante un canal emisor de enlace WebSphere MQ denominada BUS1.TO.QM01 y también mediante un canal receptor de enlace WebSphere MQ denominado QM01.TO.BUS1.

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

La finalidad de este ejemplo es conectar una configuración de WebSphere Application Server a una configuración de IBM MQ de modo que los mensajes asíncronos puedan fluir en ambas direcciones entre los dos sistemas de mensajería. En el ejemplo se supone que ya ha configurado una configuración de WebSphere Application Server como la siguiente:
  • 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.
En el ejemplo también se supone que ya tiene una configuración de IBM MQ como la siguiente:
  • 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

En esta sección se describen los valores que usted o el administrador de IBM MQ deben configurar 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
    Para los programas JMS, el administrador de IBM MQ también define un destino JMS que identifica la cola en el bus de integración de servicios. Consulte la documentación de IBM MQ para obtener más detalles sobre estos mandatos.
  • 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
DEFINE    CHL(QM01.TO.BUS1) +
          CHLTYPE(SDR) +
          TRPTYPE(TCP) +
          CONNAME('LONDON(5558)') +
          XMITQ(BUS1)
El administrador de IBM MQ elige el nombre del canal emisor, que en este ejemplo es QM01.TO.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
DEFINE    CHL(BUS1.TO.QM01) +
          CHLTYPE(RCVR) +
          TRPTYPE(TCP)
El administrador de IBM MQ elige el nombre del canal receptor, que en este ejemplo es BUS1.TO.QM01.
Mandato de IBM MQ para configurar la cola de transmisión
DEFINE   QL(BUS1) +
         USAGE(XMITQ)
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í.
Mandato JMSAdmin de IBM MQ para configurar el destino de JMS
DEFINE   Q(ServiceIntegrationQueue1) +
         QMGR(BUS1) +
         QUEUE(ServiceIntegrationQueue1)
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.
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:
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
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.
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:
Parámetro Valor
Name WMQ11
Nombre JNDI jms/WMQ11
Nombre de bus QM01
Nombre de cola WMQ11
Deje todos los demás parámetros con los valores predeterminados.
Para WMQ21, configure los parámetros siguientes:
Parámetro Valor
Name WMQ21
Nombre JNDI jms/WMQ21
Nombre de bus QM01
Nombre de cola WMQ21@QM02
Deje todos los demás parámetros con los valores predeterminados.

Configuración de ejemplo para los destinos

Los destinos de JMS de ejemplo del ejemplo de configuración para las conexiones apuntan directamente a las colas IBM MQ correspondientes y a los destinos de integración de servicios. Si lo prefiere, puede configurar componentes adicionales de forma que:
  • 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:
Parámetro Valor
Identificador WMQ11
Bus QM01
Deje todos los demás parámetros con los valores predeterminados.
Para WMQ21, configure los parámetros siguientes:
Parámetro Valor
Identificador WMQ21@QM02
Bus QM01
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.

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.


Icon that indicates the type of topic Reference topic



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