WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Implementando um Arquivo Bar

Depois de ter criado e preenchido um arquivo bar, implemente o arquivo em um grupo de execução em um broker, para que o conteúdo do arquivo possa ser usado no broker.

Antes de iniciar:

Este tópico supõe que você criou um arquivo BAR. Para obter informações adicionais, consulte Criando um Arquivo Broker Archive (BAR).

Se você alterar um arquivo BAR e quiser propagar essas mudanças para um ou mais brokers, poderá reimplementar o arquivo BAR atualizado seguindo as instruções de Reimplementando um Arquivo BAR.

O modo no qual seu broker está trabalhando pode afetar o número de grupos de execução e os fluxos de mensagens que podem ser implementados e os tipos de nós que podem ser usados. Consulte Restrições que se Aplicam em cada modo de operação.

Ao implementar um fluxo de mensagens que contenha um subfluxo que esteja definido no arquivo .subflow, você deverá implementar o subfluxo no mesmo grupo de execução. Não é possível implementar o fluxo de mensagens antes do subfluxo, mas é possível implementar o subfluxo primeiro, ou os dois recursos juntos. Se você reimplementar um subfluxo que esteja definido em um arquivo .subflow para um grupo de execução, os fluxos de mensagens que usam o subfluxo nesse grupo de execução serão interrompidos e reiniciados. Quando os fluxos de mensagens forem reiniciados, eles usarão o subfluxo atualizado.

Utilizando o WebSphere Message Broker Toolkit

Para implementar um arquivo BAR usando o WebSphere Message Broker Toolkit, conclua as etapas a seguir. É possível implementar em apenas um grupo de execução de cada vez.

  1. Opcional: Geralmente, é executada uma implementação incremental do arquivo BAR. Para executar uma implementação completa do arquivo BAR, clique com o botão direito do mouse no grupo de execução de destino na Visualização Brokers e clique em Excluir > Todos os Fluxos e Recursos. Aguarde a conclusão da operação antes de continuar.

    Não clique em Excluir > Todos os Fluxos e Recursos se quiser atualizar um ou mais dos processos-filho com o conteúdo do arquivo BAR. Para obter uma explicação da diferença entre uma implementação de arquivo BAR completa e uma incremental, consulte Implementação do Fluxo de Mensagens.

  2. Implemente um arquivo BAR ou fluxo de mensagens em um grupo de execução usando um dos métodos a seguir. Se desejar implementar arquivos .msgflow e arquivos .subflow contidos em um aplicativo ou uma biblioteca, deverá implementar o aplicativo ou a biblioteca que os contêm.
    • Arraste um aplicativo, uma biblioteca, o arquivo .msgflow, o arquivo .subflow ou o arquivo BAR em seu grupo de execução de destino na Visualização Brokers.
    • Clique com o botão direito do mouse no arquivo .msgflow, no arquivo .subflow ou no arquivo BAR do aplicativo ou da biblioteca e, em seguida, clique em Implementar. A caixa de diálogo Implementar é aberta, listando os grupos de execução aos quais o WebSphere Message Broker Toolkit está conectado.

      Selecione um grupo de execução e, em seguida, clique em OK.

    • Clique com o botão direito do mouse no grupo de execução e clique em Implementar. A caixa de diálogo Recursos é aberta. É possível escolher implementar recursos da área de trabalho, ou arquivos BAR do sistema de arquivos.
      • Especifique o tipo de recurso a ser implementado selecionando o botão de opções apropriado. Os recursos disponíveis para essa categoria são listados.
      • Selecione o recurso que deseja implementar.
      • Clique OK.
  3. Se você não salvou o arquivo BAR desde que a última vez em que o editou, será perguntado se você deseja salvar o arquivo antes da implementação. Se você clicar em Cancelar, o arquivo BAR não será salvo e a implementação não ocorrerá.
O arquivo BAR é transferido para o broker, que implementa o conteúdo do arquivo (por exemplo, fluxos de mensagens e conjuntos de mensagens) no grupo de execução. Na Visualização Brokers, os recursos implementados são incluídos no grupo de execução apropriado.

Utilizando o WebSphere Message Broker Explorer

Antes de começar:

Importe um arquivo BAR para o WebSphere Message Broker Explorer seguindo as instruções de Importando um Arquivo BAR para o WebSphere Message Broker Explorer.

Para implementar um arquivo BAR usando o WebSphere Message Broker Explorer, conclua as etapas a seguir.

  1. Expanda a pasta Recursos do Broker e selecione a pasta que contém os arquivos BAR.
  2. Opcional: Geralmente, é executada uma implementação incremental do arquivo BAR. Para executar uma implementação completa do arquivo BAR, clique com o botão direito do mouse no grupo de execução de destino na Visualização Brokers e clique em Excluir > Todos os Fluxos e Recursos. Aguarde a conclusão da operação antes de continuar.

    Não Exclua > Todos os Fluxos e Recursos se quiser atualizar um ou mais dos processos-filho com o conteúdo do arquivo BAR. Para obter uma explicação da diferença entre uma implementação de arquivo BAR completa e uma incremental, consulte Implementação do Fluxo de Mensagens.

  3. Implemente o arquivo BAR em um grupo de execução usando um dos métodos a seguir:
    • Arraste o arquivo para o grupo de execução de destino, na visualização do Navegador. É possível arrastar um arquivo BAR a partir de sua área de trabalho do WebSphere Message Broker Explorer ou de seu sistema de arquivos.
    • Clique com o botão direito do mouse no arquivo BAR e selecione Implementar Arquivo. Uma caixa de diálogo é aberta, listando os grupos de execução aos quais o WebSphere Message Broker Explorer está conectado.

      Selecione um grupo de execução e, em seguida, clique em OK.

    Se você usar o método Implementar Arquivo, poderá selecionar (e implementar em) vários grupos de execução de uma vez.

  4. Se você não salvou o arquivo BAR desde que a última vez em que o editou, será perguntado se você deseja salvar o arquivo antes da implementação. Se você clicar em Cancelar, o arquivo BAR não será salvo e a implementação não ocorrerá.
O arquivo BAR é transferido para o broker, que implementa o conteúdo do arquivo (por exemplo, fluxos de mensagens e conjuntos de mensagens) no grupo de execução. Expanda o broker na visualização do Navegador para ver os fluxos de mensagens e conjuntos de mensagens designados, incluídos no grupo de execução apropriado.

Utilizando o Comando mqsideploy

Para implementar um arquivo BAR usando o comando mqsideploy, conclua as etapas a seguir.

  1. Abra uma janela de comandos configurada para seu ambiente.
  2. Insira o comando apropriado para o seu sistema operacional e sua configuração, usando os exemplos a seguir como um guia.
    Em sistemas distribuídos:
    mqsideploy -i ipAddress -p port -q qmgr -e egroup -a barfile

    O comando desempenha uma implementação incremental. Inclua o parâmetro –m para desempenhar uma implementação completa do arquivo BAR.

    Os parâmetros -i (endereço IP), -p (porta) e -q (gerenciador de fila) representam os detalhes de conexão do gerenciador de filas associado ao broker. Se você criou o broker no computador no qual está executando este comando, então poderá especificar o nome do broker.

    Também é necessário especificar os parâmetros -e (nome do grupo de execução) e -a (nome do arquivo BAR).

    No z/OS:
    /f MQ01BRK,dp e=egroup a=barfile

    O comando desempenha uma implementação incremental. Inclua o parâmetro m=yes para desempenhar uma implementação completa do arquivo BAR.

    No exemplo, MQ01BRK é o nome do broker. Você também deve especificar os nomes do grupo de execução e do arquivo BAR (os parâmetros e= e a=).

O comando relata quando as respostas são recebidas do broker. Se o comando for concluído com sucesso, ele retornará 0 (zero).

Utilizando o CMP API

Para implementar usando a CMP API, use o método deploy da classe ExecutionGroupProxy.

O código a seguir mostra como um aplicativo pode executar uma implementação incremental:
import com.ibm.broker.config.proxy.*;
public class DeployBAR {

  public static void main(String[] args) {
    BrokerConnectionParameters bcp =
       new MQBrokerConnectionParameters("localhost", 2414, "MB8QMGR");
    try {
      BrokerProxy b = BrokerProxy.getInstance(bcp);
      ExecutionGroupProxy eg = b.getExecutionGroupByName("default");
      DeployResult dr = eg.deploy("MyBAR.bar", true, 30000);
      System.out.println("Result = "+dr.getCompletionCode());
    } catch(Exception e) {
      e.printStackTrace();
    }
  }
}
Por padrão, o método implementação desempenha uma implementação incremental. Para desempenhar uma implementação completa, utilize uma variante do método que inclua um valor falso para o parâmetro Booleano isIncremental. Por exemplo, e.deploy("deploy.bar",false,0). Configure esse parâmetro como true para solicitar uma implementação incremental.

Reimplementando um Arquivo BAR

Você pode alterar um arquivo BAR e propagar essas mudanças para um ou mais brokers. Se fizer isso, poderá reimplementar o arquivo BAR atualizado em um ou mais grupos de execução usando um dos métodos de implementação descritos anteriormente. Não é necessário parar os fluxos de mensagens implementados anteriormente; todos os recursos no grupo ou grupos de execução que estão no arquivo BAR reimplementado são substituídos e os novos recursos são aplicados.

Se as suas atualizações ao arquivo BAR incluírem a exclusão de recursos, uma reimplementação não resultará na exclusão desses recursos do broker. Por exemplo, suponha que seu arquivo BAR contenha os aplicativos A1, A2 e A3. Atualize o arquivo removendo A2 e incluindo o aplicativo A4. Se você reimplementar o arquivo BAR, os quatro aplicativos estarão disponíveis no grupo de execução quando a reimplementação for concluída. A1 e A3 são substituídos pelo conteúdo do arquivo BAR reimplementado.

Para limpar recursos implementados anteriormente do grupo de execução antes da reimplementação (por exemplo, se estiver excluindo recursos), use um dos métodos descritos anteriormente.
  • Para usar o WebSphere Message Broker Toolkit, siga as instruções para uma implementação completa, certificando-se de que você selecionou Excluir > Todos os Fluxos e Recursos antes da implementação.
  • Para usar o WebSphere Message Broker Explorer, siga as instruções para uma implementação completa, certificando-se de que você selecionou Excluir Todos os Fluxos e Recursos antes da implementação.
  • Para usar o comando mqsideploy, siga as instruções, certificando-se de incluir o parâmetro –m para executar uma implementação completa do arquivo BAR.
  • Para usar o CMP API, siga as instruções para uma implementação completa.

Se seus fluxos de mensagens não forem transacionais, pare estes fluxos de mensagens antes de reimplementar, para certificar-se de que todos os aplicativos foram concluídos corretamente e estão em um estado conhecido e consistente. É possível parar fluxos de mensagens individuais, grupos de execução ou brokers.

Se os fluxos de mensagens forem transacionais, a lógica de processamento que manipula a confirmação ou recuperação assegurará que a integridade e a consistência dos recursos seja preservada.

Em seguida:

Verifique os resultados da reimplementação seguindo as instruções de Verificando os Resultados da Implementação.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:29:41


Tópico de TarefaTópico de Tarefa | Versão 8.0.0.5 | af03890_