Configuração de amostra do link do IBM MQ

Essa configuração de amostra ilustra como é possível usar um link do IBM MQ para conectar um sistema de mensagens de integração de serviço do WebSphere Application Server ao sistema de mensagens do IBM MQ.

Um link do IBM MQ conecta um mecanismo do sistema de mensagens de integração de serviço, chamado de mecanismo do sistema de mensagens de gateway, a um gerenciador de filas ou a um grupo de filas compartilhadas do IBM MQ chamado de gerenciador de filas de gateway. Todos os mecanismos do sistema de mensagens no barramento de integração de serviço usam o mecanismo do sistema de mensagens de gateway para rotear as mensagens para a, e a partir da, rede do IBM MQ e todos os gerenciadores de filas e grupo de filas compartilhadas na rede do IBM MQ usam o gerenciador de filas de gateway para rotear as mensagens para o, e a partir do, barramento de integração de serviços.

Normalmente, um link do IBM MQ consiste de duas conexões TCP/IP:
  • O canal emissor do link do IBM MQ, que transporta as mensagens de uma integração de serviço para o IBM MQ.
  • O canal receptor do link do IBM MQ, que transporta as mensagens do WebSphere MQ para a integração de serviço.
O IBM MQ chama esses canais de mensagens de conexão TCP/IP, um canal receptor que se conecta ao canal emissor do link do IBM MQ e um canal emissor que se conecta ao canal receptor do link do IBM MQ. A seguinte figura mostra uma configuração, como aquela recém-descrita, com um canal emissor do link do WebSphere MQ chamado BUS1.TO.QM01 e um canal receptor do link do IBM MQ chamado QM01.TO.BUS1.
Um barramento de integração de serviços chamado BUS1 contém três mecanismos do sistema de mensagens, em que um deles é o mecanismo do sistema de mensagens de gateway. Uma rede do WebSphere MQ, que é vista em um barramento, contém dois gerenciadores de filas QM01 e QM02. O QM01 é o gerenciador de filas de gateway. O barramento de integração de serviços e o "barramento" do WebSphere MQ são conectados por um canal emissor de link do WebSphere MQ chamado BUS1.TO.QM01 e também por um canal receptor de link do WebSphere MQ chamado QM01.TO.BUS1.

Se você precisar que as mensagens fluam apenas para uma direção, será necessário definir apenas uma conexão TCP/IP. Por exemplo, um canal emissor de link do IBM MQ na integração de serviço que se conecta a um canal receptor no IBM MQ é suficiente para suportar o fluxo de mensagens da integração de serviço para o IBM MQ. No entanto, essa amostra constrói uma configuração que permite que as mensagens fluam para as duas direções.

Contexto de Configuração de Amostra

O propósito desta amostra é conectar uma configuração do WebSphere Application Server a uma configuração do IBM MQ para que as mensagens assíncronas possam fluir nas duas direções entre os dois sistemas de mensagens. A amostra assume que você já definiu uma configuração do WebSphere Application Server como esta:
  • Um servidor de aplicativos chamado server1 está localizado em um nó chamado London. Em um Network Deployment, server1 pode ser um dos vários servidores em uma célula e pode ser um de vários servidores em um cluster, porém esta amostra é igualmente aplicável a uma implementação de base contendo apenas um servidor de aplicativos.
  • O nome do host do IP para o servidor London é LONDON.
  • Um barramento de integração de serviços é chamado BUS1.
  • O server1 é um membro do BUS1; o mecanismo do sistema de mensagens que o contém é chamado de London.server1-BUS1.
  • Um destino do barramento de tipo de fila é chamado ServiceIntegrationQueue1, que é um dos destinos no BUS1.
A amostra também assume que você já possui uma configuração do IBM MQ como esta:
  • Os gerenciadores de fila chamados QM01 e QM02, que fazem parte de uma rede de gerenciadores de filas e de grupos de filas compartilhadas do IBM MQ interconectados. Se você tiver apenas um gerenciador de filas, as referências ao QM02 poderão ser ignoradas nessa amostra.
  • O nome do host do IP para o servidor em que QM01 é executado é PARIS.
  • Uma fila chamada WMQ11, localizada no QM01, e uma fila chamada WMQ21, que está localizada no QM02. Muitas outras filas podem estar definidas na rede do IBM MQ, mas essa amostra se concentra apenas nas duas filas do IBM MQ que serão acessadas a partir do WebSphere Application Server.

Você seleciona London.server1-BUS1 para ser o mecanismo do sistema de mensagens de gateway e QM01 para ser o gerenciador de filas de gateway.

Configuração de Amostra das Conexões

Essa seção descreve as configurações que você ou o administrador do IBM MQ precisa configurar para as conexões:
  • Os comandos que seu administrador do IBM MQ usa para configurar os componentes do IBM MQ que correspondem ao link do IBM MQ:
    • O canal emissor
    • O canal receptor
    • A fila de transmissão
    Para os programas JMS, o administrador do IBM MQ também define um destino do JMS que identifica a fila no barramento de integração de serviços. Consulte a documentação do IBM MQ para obter mais detalhes sobre esses comandos.
  • Os parâmetros necessários quando usar o console administrativo do WebSphere Application Server para configurar:
    • Uma conexão do barramento externo, que inclui o barramento externo representando a rede de gerenciadores de fila e de grupos de filas compartilhadas do IBM MQ e o link do IBM MQ representando a conexão com essa rede
    • Destinos do JMS, que identificam as filas na rede do IBM MQ

Após configurar e ativar esses componentes, seus aplicativos poderão trocar mensagens entre o sistema de mensagens de integração de serviço do WebSphere Application Server e o sistema de mensagens do IBM MQ. Opcionalmente, é possível configurar os artefatos administrativos adicionais que permitem obter um controle mais detalhado sobre as filas e destinos, consulte o Configuração de Amostra dos Destinos.

Comando do IBM MQ para configurar o canal emissor
DEFINE    CHL(QM01.TO.BUS1) +
          CHLTYPE(SDR) +
          TRPTYPE(TCP) +
          CONNAME('LONDON(5558)') +
          XMITQ(BUS1)
Seu administrador do IBM MQ escolhe o nome para o canal emissor, que nesta amostra é QM01.TO.BUS1.

O parâmetro CONNAME especifica o host e porta IP do mecanismo do sistema de mensagens de gateway.

O parâmetro XMITQ especifica o nome da fila de transmissão, que normalmente é o mesmo nome do gerenciador de filas virtual do barramento de integração de serviços, que preferencialmente, é igual ao nome do barramento.

Comando do IBM MQ para configurar o canal receptor
DEFINE    CHL(BUS1.TO.QM01) +
          CHLTYPE(RCVR) +
          TRPTYPE(TCP)
Seu administrador do IBM MQ escolhe o nome para o canal receptor, que nesta amostra é BUS1.TO.QM01.
Comando do IBM MQ para configurar a fila de transmissão
DEFINE   QL(BUS1) +
         CHLTYPE(RCVR)TRPTYPE(TCP)
Seu administrador do IBM MQ escolhe o nome para a fila de transmissão, porém é conveniente usar o nome o barramento de integração de serviços BUS1. Se o nome do barramento de integração de serviços não for um nome do gerenciador de filas válido do IBM MQ, então o administrador do WebSphere Application Server deverá definir um nome do gerenciador de filas virtual diferente para ser usado aqui.
Comando do IBM MQ JMSAdmin para configurar o destino do JMS
DEFINE   Q(ServiceIntegrationQueue1) +
         QMGR(BUS1) +
         QUEUE(ServiceIntegrationQueue1)
Seus aplicativos JMS do IBM MQ podem usar esse destino do JMS para enviar mensagens para o destino do barramento de integração de serviços ServiceIntegrationQueue1 no BUS1.
Parâmetros do WebSphere Application Server para a conexão do barramento externo.
Configure uma conexão do barramento externo como parte da topologia do barramento de integração de serviços. Para esse exemplo, o barramento de integração de serviços é BUS1 e a conexão do barramento externo usa as seguintes configurações:
Definição Valor
Tipo de conexão do barramento Conexão direta
Tipo do barramento externo IBM MQ
Mecanismo do sistema de mensagem para hospedar a conexão London.server1-BUS1
Nome do gerenciador de filas virtual BUS1 (use o nome do barramento local)
Nome do barramento externo QM01 (use o nome do gerenciador de filas de gateway do IBM MQ)
Nome do link do MQ TO.QM01
Ative o barramento de integração de serviços para o fluxo de mensagens do IBM MQ Verificado (padrão)
Nome do canal receptor do IBM MQ BUS1.TO.QM01
Nome do host PARIS
Port 1414
Ative o IBM MQ para o fluxo de mensagens do barramento de integração de serviços Verificado (padrão)
Nome do canal emissor do IBM MQ QM01.TO.BUS01
Há outras opções no assistente relacionadas ao sistema de mensagens de publicação/assinatura e à segurança. Deixe essas configurações como o padrão.
Parâmetros do WebSphere Application Server para os destinos JMS
Configure os destinos do JMS para permitir que os aplicativos JMS de integração de serviço acessem as filas na rede do IBM MQ. Essa amostra precisa dos destinos do JMS para a fila WMQ11 no gerenciador de filas QM01 e para a fila WMQ21 no gerenciador de filas QM02.

Note que esses destinos do JMS são filas do IBM MQ, mas para os propósitos desta amostra, você está acessando essas filas a partir dos programas JMS de integração de serviço, portanto, é necessário definir os destinos do JMS para o provedor de sistemas de mensagens padrão (integração de serviço) e não para o provedor JMS do IBM MQ.

Para o WMQ11, configure os seguintes parâmetros:
Parâmetro Valor
Nome WMQ11
Nome JNDI jms/WMQ11
Nome do Barramento QM01
Nome da fila WMQ11
Deixe todas as outras configurações como o padrão.
Para o WMQ21, configure os seguintes parâmetros:
Parâmetro Valor
Nome WMQ21
Nome JNDI jms/WMQ21
Nome do Barramento QM01
Nome da fila WMQ21@QM02
Deixe todas as outras configurações como o padrão.

Configuração de Amostra dos Destinos

Os destinos JMS de amostra na configuração Sample para as conexões apontam diretamente para os destinos de filas e de integração de serviço do IBM MQ correspondentes. Se preferir, é possível configurar componentes adicionais para que:
  • O destino JMS do IBM MQ aponte para uma fila do IBM MQ (na realidade, uma fila de alias ou remota) que aponta para o destino da integração de serviço.
  • Os destinos JMS da integração de serviço apontem para os destinos de integração de serviço (na realidade, destinos de alias ou estrangeiros) que apontam para as filas do IBM MQ.

Consulte a documentação do IBM MQ para obter informações sobre quando e como definir as filas de alias e remotas.

Parâmetros do WebSphere Application Server para os destinos estrangeiros
Configure os destinos estrangeiros para as filas do IBM MQ para permitir um controle sobre como os aplicativos de integração de serviço acessam cada fila. Por exemplo, é possível configurar os destinos estrangeiros para cada uma das duas filas e especificar que a integração de serviço inclua um cabeçalho MQRFH2 nas mensagens de uma fila, mas não da outra.

Configure os destinos estrangeiros como recursos de destino do barramento de integração de serviços.

Para o WMQ11, configure os seguintes parâmetros:
Parâmetro Valor
Identificador WMQ11
Barramento QM01
Deixe todas as outras configurações como o padrão.
Para o WMQ21, configure os seguintes parâmetros:
Parâmetro Valor
Identificador WMQ21@QM02
Barramento QM01
Se o destino estrangeiro for um destino do IBM MQ, o identificador deverá estar no formato qName@qmName, em que qName é o nome da fila e qmName é o nome do gerenciador de filas. Para esse exemplo, o identificador do WMQ21 no gerenciador de filas QM02 é WMQ21@QM02.

Deixe todas as outras configurações como o padrão.

Após definir esses destinos estrangeiros, será possível, por exemplo, configurar a propriedade customizada _MQRFHAllowed para um dos destinos, ou para ambos, conforme necessário.


Ícone que indica o tipo de tópico Tópico de Referência



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjc0222_
Nome do arquivo: rjc0222_.html