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.
- 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.

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
- 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.
- 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
- 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
- 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
Seu administrador do IBM MQ escolhe o nome para o canal emissor, que nesta amostra é QM01.TO.BUS1.DEFINE CHL(QM01.TO.BUS1) + CHLTYPE(SDR) + TRPTYPE(TCP) + CONNAME('LONDON(5558)') + XMITQ(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
Seu administrador do IBM MQ escolhe o nome para o canal receptor, que nesta amostra é BUS1.TO.QM01.DEFINE CHL(BUS1.TO.QM01) + CHLTYPE(RCVR) + TRPTYPE(TCP)
- Comando do IBM MQ para configurar a fila de transmissão
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.DEFINE QL(BUS1) + CHLTYPE(RCVR)TRPTYPE(TCP)
- Comando do IBM MQ JMSAdmin para configurar o destino do JMS
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.DEFINE Q(ServiceIntegrationQueue1) + QMGR(BUS1) + QUEUE(ServiceIntegrationQueue1)
- 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:
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.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
- 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:
Deixe todas as outras configurações como o padrão.Parâmetro Valor Nome WMQ11 Nome JNDI jms/WMQ11 Nome do Barramento QM01 Nome da fila WMQ11 Para o WMQ21, configure os seguintes parâmetros:
Deixe todas as outras configurações como o padrão.Parâmetro Valor Nome WMQ21 Nome JNDI jms/WMQ21 Nome do Barramento QM01 Nome da fila WMQ21@QM02
Configuração de Amostra dos Destinos
- 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:
Deixe todas as outras configurações como o padrão.Parâmetro Valor Identificador WMQ11 Barramento QM01 Para o WMQ21, configure os seguintes parâmetros:
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.Parâmetro Valor Identificador WMQ21@QM02 Barramento QM01 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.