Configurando a Amostra Coordinated Request Reply with Global Cache

Antes de executar a amostra Coordinated Request Reply Global Cache, configure o broker para usar o cache global padrão. Configure a seguinte propriedade do broker usando o comando mqsichangebroker.

mqsichangebroker MB8BROKER -b default

Para que a mudança entre em vigor, é preciso reiniciar o broker.

Configurando o Aplicativo Coordinated Request Reply JMS

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

Antes de iniciar:

Se estiver executando a amostra no Linux, conclua as seguintes etapas:

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

Criando os Objetos Administrados Usando JMSAdmin

As instruções a seguir assumem 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:

No aplicativo Coordinated Request Reply JMS, você deve usar o arquivo JMSObjects.defs com a ferramenta JMSAdmin.

Antes que seja possível usar a ferramenta JMSAdmin, você deverá modificar o arquivo JMSAdmin.config.

Modificando o arquivo JMSAdmin.config

Para modificar o arquivo JMSAdmin.config, conclua as seguintes etapas:

  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 uma 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
    #
    #  A linha a seguir especifica a URL do contexto inicial
    #  para o provedor de serviço. Ela atualmente refere-se a um Contexto do Sistema de Arquivos. 
    #  Exemplos de uma URL de contexto raiz LDAP e o espaço de nomes JNDI para o WebSphere
    #  também são mostrados, comentados.
    #
    #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 estiver executando a amostra no Windows, crie o diretório para o PROVIDER_URL, C:/JNDI-Directory

    Se estiver executando a amostra no Linux, crie o diretório para o PROVIDER_URL, /home/<myuser>/JNDI-Directory .

  5. Salve o arquivo.
  6. Opcional: altere a porta usada na amostra. Esta amostra usa a porta padrão 2414. Se o gerenciador de filas padrão (MB8QMGR) estiver atendendo na porta 2414, ignore esta etapa. Se o gerenciador de filas padrão estiver atendendo em uma porta diferente, você deverá alterar a porta usada nesta amostra.

    Use o IBM Websphere MQ Explorer para determinar em qual porta o gerenciador de filas está recebendo.

    Para alterar a porta usada na amostra, conclua as seguintes etapas:
    1. Altere o diretório para "<workspace_path>/Coordinated Request Reply JMS Application" em que workspace_path é o caminho completo para o diretório da área de trabalho do WebSphere Message Broker Toolkit.
    2. Abra o arquivo JMSObjects.def para edição.
    3. Altere o valor do parâmetro PORT para corresponder à porta do gerenciador de filas padrão.
    4. Salve suas mudanças.

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 JMSObjects.defs como entrada.

Na linha de comandos, digite os seguintes comandos:

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

Configurando as Propriedades de Conexão do JMS Usando um Serviço Configurável Único

As propriedades de conexão do JMS para todos os nós JMS usados nessa amostra são configuradas usando o serviço configurável JMSProviders. Para configurar os nós do JMS com o Nome do connection factory e o local do arquivo .bindings recém-criado, conclua a etapa a seguir.

No console de comando do WebSphere Message Broker, insira o seguinte comando:

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 Solicitação, Resposta, BackendReplyApp e RestoreOriginalJMSHeader, crie um arquivo Broker Archive (BAR) que contenha todos os fluxos de mensagens.

Para criar o arquivo BAR, conclua as etapas a seguir.

  1. Clique com o botão direito do mouse na visualização Desenvolvimento do Broker e, em seguida, clique em Novo > Arquivo BAR.
  2. Selecione o Coordinated Request Reply JMS application e insira um nome para o arquivo BAR.
  3. Inclua o Coordinated Request Reply JMS application no arquivo BAR, clique em Construir archive broker e salve o arquivo (Ctrl+S).
  4. Na visualização Desenvolvimento do Broker, arraste o arquivo BAR 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 Executando a Amostra