Criando um Canal de Mensagens

Antes de Iniciar

Antes de criar um canal de mensagens, você deve já ter concluído as seguintes tarefas neste tutorial:

Sobre Esta Tarefa

Nesta parte do tutorial, você criará um canal de mensagens entre os gerenciadores de filas de envio e de recebimento.
Você pode executar cada tarefa utilizando uma das seguintes interfaces:

Criando o canal de mensagens usando o IBM MQ Explorer

Procedimento

  1. No gerenciador de filas de recebimento QM_APPLE, crie a extremidade do receptor do canal:
    1. Na visualização do Navegador, expanda o gerenciador de filas QM_APPLE criado anteriormente..
    2. Clique com o botão direito do mouse em Canais e, em seguida, clique em Novo > Canal Receptor.
      O assistente Novo Canal Receptor é exibido.
    3. No campo Nome, digite QM_ORANGE.QM_APPLE.
    4. Clique em Concluir.
      Agora você criou o canal de receptor na máquina de destino.
  2. No gerenciador de filas de envio QM_ORANGE, crie a extremidade do emissor do canal:
    1. Expanda o gerenciador de filas QM_ORANGE criando anteriormente..
    2. Clique com o botão direito do mouse em Canais e, em seguida, clique em Novo > Canal Emissor.
      O assistente Novo Canal Emissor é exibido.
    3. No campo Nome, digite QM_ORANGE.QM_APPLE e clique em Avançar.
    4. No campo Nome da Conexão, digite o nome do computador ou o endereço IP da máquina de destino (você já deve ter obtido essa informação do administrador do sistema).
      Se o número da porta padrão 1414 não foi usado quando criou QM_APPLE, a entrada do campo do nome de Conexão deverá estar no formato:
      
      con-name(port)
      Em que con-name é o nome do computador ou o endereço IP da máquina de recebimento e port é o número da porta usado quando o gerenciador de filas de recebimento foi configurado.
    5. No campo Fila de Transmissão, digite QM_APPLE.
      O nome da fila de transmissão a ser inserido aqui deve corresponder ao nome inserido para a fila de transmissão em Criando as filas no gerenciador de filas de envio.
    6. Clique em Concluir.
    7. Clique na pasta Canais.
    8. Clique com o botão direito do mouse em QM_ORANGE.QM_APPLE.
    9. No menu pop-up, clique em Iniciar.
    10. Clique em OK.
      Agora você criou o canal de emissor na máquina de origem.
      Nota: Não é necessário iniciar o canal de receptor porque ele é iniciado automaticamente quando o canal emissor é configurado (ao configurar o canal emissor, o endereço IP do canal receptor é especificado).

Resultados

Agora você criou um canal receptor QM_ORANGE.QM_APPLE no gerenciador de filas de recebimento QM_APPLE e um canal emissor QM_ORANGE.QM_APPLE no gerenciador de filas de envio QM_ORANGE. Você também iniciou o canal emissor, que inicia automaticamente o canal receptor.

Criando o Canal de Mensagens com o MQSC

Procedimento

  1. Abra um prompt de comandos na máquina de destino e siga estas etapas:
    1. Inicie o MQSC digitando o comando:
      
      runmqsc
      Uma mensagem informa que o gerenciador de filas foi iniciado.
    2. Defina um canal de receptor digitando o seguinte comando:
      
      define channel (QM_ORANGE.QM_APPLE) chltype (RCVR) trptype (TCP)
      Uma mensagem informa você de que o canal foi criado.
    3. Abra uma nova janela de comandos e verifique quais portas estão livres. Insira o seguinte comando:
      
      netstat -an

      Isso mostra uma lista de processos em execução. Verifique o número de porta de cada um dos processos para confirmar se a porta 1414 está sendo utilizada. Isso pode ser feito ao consultar a coluna Endereço Local. As informações são fornecidas no formulário ip_address:port_being _used.

      Se a porta 1414 não estiver em uso, use 1414 como o número da porta para o canal listener e emissor, posteriormente na verificação. Se ela estiver em uso, selecione uma porta alternativa que não esteja sendo utilizada, por exemplo, 1415, se ela não estiver sendo utilizada por outro processo.

    4. A verificação requer que o listener padrão do IBM MQ seja iniciado. Por padrão, o listener atenderá na porta 1414. Se você localizou a porta 1414 que estava livre durante a etapa c, nenhuma ação será necessária e será possível continuar na etapa e. Se precisar usar uma porta diferente da 1414, altere a definição do SYSTEM.DEFAULT.LISTENER.TCP. Por exemplo, para utilizar a porta 1415, digite o seguinte comando na janela do MQSC:
      
      alter listener(system.default.listener.tcp) trptype(tcp) port(port_number)
      em que port_number é o número da porta onde o listener deve ser executado. Este deve ser o mesmo número usado ao definir o canal emissor na etapa 2b deste procedimento.
    5. Na janela do MQSC, inicie o listener padrão do IBM MQ inserindo o seguinte comando:
      
      start listener (system.default.listener.tcp)
    6. Pare o MQSC digitando:
      
      end
      Algumas mensagens exibidas são seguidas pelo prompt de comandos.
  2. Abra um prompt de comandos na máquina de origem e siga estas etapas:
    1. Inicie o MQSC digitando o comando:
      runmqsc
      Uma mensagem informa que o gerenciador de filas foi iniciado.
    2. Defina um canal de emissor digitando o seguinte comando:
      
      define channel(QM_ORANGE.QM_APPLE) chltype(sdr) conname('con-name(port)') xmitq(QM_APPLE) trptype(tcp)
      O valor con-name é o endereço TCP/IP da estação de trabalho do receptor. O valor port é a porta na qual o listener está em execução na máquina receptora, o valor padrão é 1414.
    3. Inicie o canal digitando o seguinte comando:
      
      start channel (QM_ORANGE.QM_APPLE)
    4. Pare o MQSC digitando:
      
      end
      Algumas mensagens exibidas são seguidas pelo prompt de comandos.

Resultados

Agora você criou todos os objetos do IBM MQ necessários para que as mensagens sejam enviadas do gerenciador de filas de envio QM_ORANGE para a fila Q1 no gerenciador de filas de recebimento QM_APPLE. A próxima tarefa será enviar uma mensagem de teste.