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

Incluindo Arquivos em um Broker Archive

Para implementar arquivos em um grupo de execução, inclua-os em um arquivo bar.

Antes de iniciar:

Crie um arquivo BAR para cada configuração que deseja implementar. Para obter mais detalhes, consulte Criando um Arquivo Broker Archive (BAR).

É possível incluir quaisquer recursos implementáveis do seu espaço de trabalho a um arquivo BAR. Se você selecionar Incluir Arquivos de Origem do Projeto de Área de Trabalho, os arquivos de origem e projeto para todos os fluxos de mensagens, arquivos de esquema de modelo de mensagem, conjuntos de mensagens ou outros recursos implementáveis no broker archive serão incluídos. Para obter mais informações sobre os arquivos que você pode incluir um um broker archive, consulte Broker Archive.

Os subfluxosdefinidos nos arquivos .msgflow não são exibidos no arquivo BAR como itens separados e são incluídos automaticamente. Para incluir esses subfluxos, é necessário incluir apenas o fluxo pai. Subfluxos que são definidos em arquivos .subflow são exibidos no arquivo BAR como itens separados e podem ser implementados como recursos individuais. Se for incluído um fluxo pai contendo esses subfluxos, os subfluxos serão incluídos no arquivo BAR automaticamente quando o arquivo BAR for construído.

É possível incluir arquivos Flow, DLL, ESQL, Java™ JAR, PHP, MAP, XML, XSLT e Conjuntos de Mensagens manualmente seguindo estas etapas. No entanto, os arquivos JAR ou conjuntos .NET (arquivos DLL) que são requeridos pelos nós JavaCompute ou nós .NETCompute nos fluxos de mensagens são incluídos automaticamente a partir de seu projeto Java ou Projeto do Message Broker quando você inclui o fluxo de mensagens. Os arquivos XML e XSL também serão incluídos automaticamente, se forem requeridos pelo fluxo.

Ao incluir um fluxo de mensagens (definido em um arquivo .msgflow) em um arquivo BAR, é possível incluir o fluxo como um arquivo .msgflow ou incluí-lo como um fluxo de mensagens compilado (definido em um arquivo .cmf). Selecione Recursos de Compilação e Sequenciais para incluir fluxos como arquivos .cmf. Você não pode incluir o mesmo fluxo de mensagens em um arquivo BAR como um arquivo .cmf e .msgflow. Se o seu fluxo contiver um dos seguintes nós, não será possível incluir o fluxo como um arquivo .msgflow:
  • Um nó definido pelo usuário que é criado a partir de um subfluxo
  • Um nó de subfluxo que representa um subfluxo que é definido em um arquivo .msgflow
  • Um nó WebSphere Message Broker Versão 7.0 Mapeamento
  • Um nó MQOptimizedFlow

Se você selecionar Recursos de Compilação e Sequenciais, o código ESQL será integrado no arquivo .cmf que faz referência a ele. Se você não selecionar Recursos de Compilação e Sequenciais, os arquivos ESQL serão incluídos no arquivo BAR como recursos individuais.

Esteja ciente de que, se seu arquivo BAR contiver uma combinação de recursos que estão compilados e recursos que não estão compilados, você poderá ver resultados inesperados. Por exemplo, se você selecionar a opção Recursos de Compilação e Sequenciais para criar um arquivo BAR que contenha um arquivo ESQL e um fluxo de mensagens, o ESQL será integrado no arquivo do fluxo de mensagens compilado (.cmf). Se você atualizar o ESQL e inclui-lo no arquivo BAR com a opção Recursos de Compilação e Sequenciais desmarcada, o arquivo ESQL será incluído como um recurso individual, mas o arquivo .cmf usará o ESQL original porque ele permanecerá integrado no arquivo .cmf. Para garantir que todos os recursos estejam ou não compilados, ao alterar a opção Recursos de Compilação e Sequenciais, selecione também Remover Conteúdo do Broker Archive Antes da Criação e recrie o arquivo BAR.

Não é necessário reimplementar arquivos JAR, a menos que eles tenham sido atualizados. Se um ou mais arquivos JAR em seu arquivo BAR estiverem presentes no computador no qual o broker está em execução, será possível removê-los com segurança do arquivo BAR antes da nova implementação. Os arquivos JAR disponíveis para o broker incluem arquivos JAR que foram implementados e arquivos JAR existentes nos diretórios de classes compartilhadas ou no subdiretório classes do diretório de instalação. Por exemplo, os arquivos com.ibm.mq.jar, ConfigManagerProxy.jar, jplugin2.jar e javacompute.jar ficam sempre visíveis para o broker e não precisam ser implementados separadamente.

Não é possível ler arquivos implementados retornados dos grupos de execução do broker. Portanto, mantenha uma cópia do arquivo BAR implementado, ou dos arquivos individuais nele contidos.

Para incluir arquivos em um arquivo BAR usando o WebSphere Message Broker Toolkit, conclua as etapas a seguir.

  1. Abra o arquivo BAR dando um clique duplo nele. O conteúdo do arquivo BAR é mostrado no editor de Broker Archive. (Se o arquivo BAR for novo, esta visualização estará vazia.)
  2. Na página Preparar do editor de Broker Archive, selecione recursos implementáveis da área de trabalho para incluir no arquivo BAR.

    Selecione Aplicativos para ver uma lista de aplicativos que podem ser implementados. Se você selecionar um aplicativo, todos os recursos contidos serão implementados com esse aplicativo. Os recursos implementados em um aplicativo são isolados dos recursos de outros aplicativos. Para implementar recursos diretamente para o grupo de execução, clique em Fluxos de Mensagens, Bibliotecas e Outras Dependências do Fluxo de Mensagens. Depois que esses recursos forem implementados, eles ficarão visíveis a todos os outros recursos implementados no mesmo grupo de execução.

    É possível selecionar um recurso individual (aplicativo, biblioteca,domínio de aplicativo .NET ou recurso do projeto) para ser incluído no arquivo BAR ou incluir todos os aplicativos, bibliotecas, domínios de aplicativo .NET ou recursos do projeto na área de trabalho selecionando o elemento-raiz apropriado. Se o aplicativo selecionado fizer referência a uma ou mais bibliotecas, essas bibliotecas serão incluídas no arquivo .appzip do aplicativo como arquivos .libzip aninhados. Essas bibliotecas referenciadas são privadas e não estão acessíveis a recursos fora do aplicativo. Portanto, essas bibliotecas não são selecionadas na página Preparar, por padrão. Se quiser implementar uma biblioteca como uma biblioteca de nível de grupo de execução, que é acessível a outros recursos, selecione-a para implementá-la separadamente. Um arquivo .libzip é criado para essa biblioteca e incluída no arquivo BAR no nível-raiz.

    Se você selecionar uma biblioteca que faça referência a outras bibliotecas, essas bibliotecas referenciadas também serão incluídas no arquivo BAR como arquivos .libzip.

    Se o aplicativo selecionado fizer referência a um ou mais domínios de aplicativo .NET, esses domínios de aplicativo serão incluídos no arquivo BAR no nível raiz como um arquivo .appdomainzip.

  3. Opcional: Para incluir arquivos de origem, selecione Incluir Arquivos de Origem do Projeto de Área de Trabalho.

    Se você selecionar Incluir Arquivos de Origem do Projeto de Área de Trabalho, os projetos de origem de todos os aplicativos, bibliotecas e outros recursos compilados serão incluídos na pasta src do arquivo BAR.

  4. Opcional: Para remover conteúdo existente do arquivo BAR antes de construir o novo arquivo BAR, selecione Remover conteúdo do Broker Archive antes de construir.
  5. Opcional: Se estiver incluindo um fluxo de mensagens em um broker archive pela segunda vez e tiver usado a página Gerenciar para alterar parâmetros de fluxo, selecione Substituir valores de propriedade configuráveis para refazer as definições de configuração. Se o controle estiver livre, as configurações existentes são deixadas como estão quando o fluxo é substituído.
  6. Opcional: Para incluir fluxos de mensagens como arquivos .cmf do fluxo de mensagens compilado e para incluir o código ESQL diretamente no arquivo .cmf de cada fluxo de mensagem que faz referência a um arquivo ESQL, selecione a opçãoRecursos de Compilação e Sequenciais. Por padrão, quando você inclui um fluxo de mensagens em um arquivo BAR, ele é incluído como um arquivo .msgflow. Por padrão, cada arquivo ESQL referido por um ou mais de seus fluxos de mensagens é implementado como um recurso individual e pode ser acessado por diversos arquivos .msgflow. Se algum dos fluxos incluídos no arquivo BAR contiver um subfluxo que está definido em um arquivo .msgflow, você deverá selecionar a opção Recursos de Compilação e Sequenciais.
  7. Clique em Construir e Salvar.

A página Gerenciar lista os arquivos que são novos no arquivo BAR. Expanda os aplicativos e bibliotecas para visualizar seu conteúdo. Os recursos compilados no arquivo BAR são mostrados em ordem alfabética na árvore. É possível editar apenas elementos-raízes, por exemplo, se você tiver incluído um aplicativo no arquivo BAR, poderá renomear o arquivo .appzip ou incluir comentários nele. Não é possível editar recursos no arquivo .appzip, mas as propriedades configuráveis desses recursos podem ser editadas.

Não é possível remover recursos individuais dos arquivos .appzip, .appdomainzip ou .libzip; para remover esses recursos, você deve remover o aplicativo, o domínio de aplicativo .NET ou a biblioteca.

Você pode escolher não exibir os arquivos de origem selecionando Recursos construídos ou Propriedades configuráveis na lista do menu Filtrar por.

Em seguida:

Se utilizar propriedades configuráveis, consulte Editando Propriedades Configuráveis.

Se desejar ter múltiplas instâncias de um fluxo com diferentes valores para propriedades configuráveis, consulte Incluindo Múltiplas Instâncias de um Fluxo de Mensagens em um Archive de Broker.

Para fazer alterações adicionais no seu arquivo BAR, consulte Editando um Arquivo Broker Archive Manualmente.

Quando o arquivo BAR estiver concluído, implemente-o seguindo as instruções de Implementando um Arquivo Bar.

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:40


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