Configurando a Amostra JMS Nodes

Nesta amostra, o WebSphere MQ é usado como o provedor JMS; você deve criar os objetos administrados usando a ferramenta JMSAdmin.

Antes de iniciar:

Se você estiver executando a amostra no Linux, deverá concluir as seguintes etapas:

  1. Inclua a classe JMSAdmin no caminho de classe ao incluir o seguinte arquivo no seu caminho de classe:
    >mq_install_directory</java/lib/com.ibm.mqjms.jar
  2. Inclua o local do Java na variável PATH ao incluir o seguinte código no caminho de classe:
    >JAVA_HOME</bin

Criando os Objetos Administrados Usando JMSAdmin

As seguintes instruções são baseadas na suposição de que o WebSphere MQ esteja instalado no diretório mq_install_dir. A ferramenta JMSAdmin e o arquivo de configuração JMSAdmin estão nos seguintes locais:

Para poder usar a ferramenta JMSAdmin, talvez seja necessário modificar o arquivo JMSAdmin.config.

Validando e Modificando o Arquivo JMSAdmin.config

  1. No editor de texto, abra o arquivo JMSAdmin.config.
  2. Para comentar qualquer opção que não seja necessária, inclua um sinal numérico (#). Para remover o comentário de qualquer opção, remova o sinal de número (#).
    # A seguinte linha especifica que o fornecedor de serviços JNDI está em uso.
    #  Ela atualmente indica um Contexto do Sistema de Arquivos. Se um provedor de serviços diferente
    # for usado, esta linha deve ser comentada e o comentário deve ser removido da linha adequada.
    #
    #  com.sun.jndi.fscontext.RefFSContextFactory is the FileSystem JNDI Context
    #
    #INITIAL_CONTEXT_FACTORY=com.sun.jndi.ldap.LdapCtxFactory
    INITIAL_CONTEXT_FACTORY=com.sun.jndi.fscontext.RefFSContextFactory
    #INITIAL_CONTEXT_FACTORY=com.ibm.ejs.ns.jndi.CNInitialContextFactory
    #INITIAL_CONTEXT_FACTORY=com.ibm.websphere.naming.WsnInitialContextFactory
    #
    #  The following line specifies the URL of the service provider's initial
    #  context. It currently refers to an File System Context. Examples of a
    #  LDAP root context URL and WebSphere's JNDI namespace are also shown, commented
    #  out.
    #
    #  PROVIDER_URL needs changing to, e.g. file:///home/user/JNDI-Directory
    #  on Unix platforms. The 'JNDI-Directory' folder needs to be created in the
    #  location specified.
    #
    #PROVIDER_URL=ldap://localhost/o=ibm,c=us
    PROVIDER_URL=file:/C:/JNDI-Directory
    #PROVIDER_URL=iiop://localhost/	
    
  3. Certifique-se de que PROVIDER_URL esteja configurado para /C:/JNDI-Directory, ou um local equivalente no Linux e de que INITIAL_CONTEXT_FACTORY esteja configurado para com.sun.jndi.fscontext.RefFSContextFactory.
  4. Se você tiver feito mudanças, salve o arquivo.
  5. Crie o diretório PROVIDER_URL se ele ainda não existir.

Agora você pode criar os objetos.

Criando os Objetos

Executando a ferramenta WebSphere MQ JMSAdmin, você cria os objetos administrados por JNDI para configurar Connection Factories e Destinos de JMS que são usados na amostra.

Crie os objetos executando a ferramenta JMSAdmin e usando o arquivo JMSSampleObjects.defs como entrada.

Se o broker não estiver usando a porta 2414, edite a configuração da porta em JMSSampleObjects.defs.

Na linha de comandos, digite os seguintes comandos:

Em que o WebSphere MQ está instalado no seguinte local: mq_install_dir, e workspace_path é o caminho completo para o diretório da área de trabalho do WebSphere Message Broker Toolkit.

Os objetos e o arquivo .bindings são criados.

Em seguida, modifique um objeto JNDI e um atributo do nó MQInput:

  1. Para iniciar a ferramenta JMSAdmin, insira o seguinte comando:

    Onde o WebSphere MQ é instalado no seguinte local: mq_install_dir.

  2. Na linha de comandos, insira os seguintes comandos para modificar esse projeto JNDI:
    alter q(publishqueue) queue(PUBLISHQUEUE)
  3. Para terminar a sessão JMSAdmin, insira o seguinte comando:
    end

Configurando o Caminho JNDI no Fluxo de Mensagens

Você deve informar aos nós JMS nos fluxos de mensagens onde localizar o arquivo .bindings que acabou de criar.

Para configurar os nós JMS com o local do arquivo .bindings:

  1. Na visualização Desenvolvimento do Broker, clique duas vezes no arquivo JMSGateway.msgflow no Projeto de Fluxo da Amostra JMS Nodes. Esta ação abre um editor de fluxo de mensagens em que é possível editar o fluxo de mensagens JMSGateway.
  2. Clique com o direito no nó JMSOutput no fluxo de mensagens, clique em Propriedades para mostrar a visualização Propriedades.
  3. Na área de janela Propriedades, selecione a guia Conexão JMS.
  4. Assegure-se de que o valor mostrado no campo Ligações de JNDI do Local corresponda ao caminho especificado na linha PROVIDER_URL no arquivo JMSAdmin.config. Se esses dois valores não forem iguais, o fluxo de mensagens não funcionará.
  5. Salve o fluxo de mensagens.
  6. Abra o fluxo de mensagens JMSInput_Publication no editor de Fluxo de Mensagens e configure o nó JMSInput com o local do arquivo .bindings usando as etapas anteriores.

Os fluxos de mensagens estão agora configurados e prontos para serem implementados no intermediário.

Criando o Arquivo BAR e Implementando os Fluxos de Mensagens

Para implementar os fluxos JMSGateway e JMSInput_Publication, crie um arquivo BAR (Broker Archive) que contenha os dois fluxos de mensagens.

Para criar o arquivo BAR:

  1. Na visualização Desenvolvimento do Broker, clique com o botão direito do mouse em Novo > Arquivo BAR.
  2. Selecione o "Projeto JMSNodesSampleFlow" e insira um nome para o arquivo BAR.
  3. Clique em Concluir. Uma área de janela Preparar é aberta. Essa área de janela exibe as opções para criação de um novo arquivo bar.
  4. Inclua os dois fluxos no arquivo BAR e, em seguida, salve suas opções (Ctrl+S).
  5. Agora construa o arquivo BAR clicando no botão Construir broker archive. O arquivo BAR criado aparece na pasta BAR do JMSNodesSampleFlowProject na visualização Desenvolvimento do Broker.
  6. Clique no arquivo BAR e arraste-o para o grupo de execução padrão na visualização Brokers. Esta ação implementa os fluxos no intermediário.

Agora você está pronto para executar a amostra.

Voltar para Home da Amostra