Migrando um Fluxo de Mensagens

Você pode migrar os fluxos de mensagens criados no WebSphere MQ Event Broker Versão 2.1 e utilizá-los no WebSphere Event Broker Versão 6.0.

Você pode querer alterar os fluxos de mensagens migrados para tirar proveito dos novos nós e recursos disponíveis no Versão 6.0.

Você pode migrar mais de um fluxo de mensagens de uma vez, se desejar que eles sejam definidos no mesmo projeto do fluxo de mensagens. Você deve migrar os subfluxos com os fluxos de mensagens nos quais eles foram incluídos para assegurar referências consistentes.

Se você tiver definido mais de um fluxo de mensagens com o mesmo nome, ou o fluxo de mensagens tiver sido exportado em mais de um arquivo de exportação, a tarefa de migração substituirá, sem avisar, todo fluxo de mensagens existente pelo próximo fluxo que encontrar com o mesmo nome. Portanto, tome cuidado para evitar conflitos, e assegure-se de que a versão mais recente de um fluxo de mensagens que tenha sido definida mais de uma vez seja a última a ser migrada.

Se você tiver diversas versões do mesmo fluxo de mensagens, que é utilizado como subfluxo em outros fluxos no mesmo diretório de migração, os resultados do processo de importação serão imprevisíveis.

Para migrar um fluxo de mensagens:

  1. Antes de desinstalar a Versão 2.1, exporte o(s) fluxo(s) de mensagens do Centro de Controle utilizando as ferramentas da Versão 2.1 (consulte a documentação da Versão 2.1 para obter informações detalhadas).

    O processo de migração é mais eficiente quando todos os subfluxos referenciados estiverem incluídos no mesmo arquivo de exportação; portanto, exporte todos os fluxos de mensagens que você deseja migrar para um único projeto do fluxo de mensagens em um único arquivo de exportação.

  2. Transfira o arquivo ou arquivos de exportação para o novo sistema no qual você está executando o ambiente de trabalho.
    • Verifique se o diretório no qual você armazena estes arquivos não contém outros arquivos.
    • Armazene os arquivos que deseja importar para um único projeto do fluxo de mensagens em um diretório separado e migre cada diretório separadamente.
    • Certifique-se de não armazenar arquivos em subdiretórios do diretório do projeto, porque esses arquivos são ignorados pelo comando migrar.
  3. Se uma sessão do ambiente de trabalho estiver ativa, feche-a. Não é possível executar o comando migrar se o ambiente de trabalho estiver em execução.
  4. Em um prompt de comandos, chame o comando mqsimigratemsgflows, especificando o novo nome de projeto e o diretório no qual você armazenou os arquivos de exportação. Quando o comando estiver concluído:
    • Os fluxos de mensagens contidos nos arquivos de exportação no diretório especificado são importados para o projeto do fluxo de mensagens especificado. Se o projeto já existir, os fluxos de mensagens adicionais são incluídos com conteúdo atual, se houver algum. Se o projeto não existir antes de você chamar o comando, ele será criado. O comando será mais eficaz se criar o projeto de fluxo de mensagens para você.
    • Os fluxos e subfluxos de mensagens são criados e suas definições são armazenadas em arquivos denominados flow_name.msgflow.

      Depois de tê-los importado, se você quiser renomear algum desses fluxos de mensagens ou nós de acordo com as convenções locais de nomenclatura, utilize apenas os recursos fornecidos pelo ambiente de trabalho, a fim de preservar a consistência e a integridade de todas as referências. Não renomeie nenhum dos arquivos no sistema de arquivos.

  5. Verifique o arquivo de relatório mqsimigratemsgflows.report.txt, que é gravado no diretório do qual você chamou o comando. O comando fornece as seguintes informações:
    • O nome de cada fluxo de mensagense subfluxo migrado. Se algum desses recursos tiver um nome incompatível com a Versão 6.0, o comando atualizará o nome e todas as referências a esse nome para assegurar consistência. Se você migrar um recurso com um nome inválido mais de uma vez, a correção feita no nome sempre será a mesma.
    • O sucesso ou a falha de cara recurso migrado.
    • Uma indicação de um subfluxo que não pode ser localizado (sua definição não está contida em nenhum dos arquivos de exportação, mas está incluída em um ou mais dos fluxos de mensagens migrados). Se o problema ocorrer, localize o subfluxo ausente e importe-o para o projeto apropriado. Se, por qualquer motivo, você não puder recuperar o subfluxo ausente, recrie-o com o nome original. Todos os fluxos afetados podem então ser vinculados corretamente ao novo subfluxo.

      Não é necessário repetir todo o processo de exportação e importação.

  6. Inicie o ambiente de trabalho e alterne para a Perspectiva do Desenvolvimento de Aplicativos do Intermediário.
  7. Abra o projeto de fluxo de mensagens criado ou atualizado pelo comando de migração.

    Se o projeto já estiver aberto, clique com o botão direito do mouse nele e clique em Atualizar; em seguida, Reconstruir Projeto para assegurar-se de que a visualização Desenvolvimento do Intermediário reflita o novo conteúdo. A reconstrução também executa uma validação do conteúdo do projeto do fluxo de mensagens.

Quando tiver migrado seus recursos, consulte Tarefas de Pós-migração da Versão 2.1 para obter informações sobre tarefas que você possa querer executar após a migração.
Conceitos relacionados
Visão Geral de Fluxos de Mensagens
Tarefas relacionadas
Abrindo um Fluxo de Mensagens Existente
Definindo o Conteúdo do Fluxo de Mensagens
Referências relacionadas
Perspectiva do Desenvolvimento de Aplicativos do Intermediário
Nós Internos
Comando mqsimigratemsgflows
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009. Todos os Direitos Reservados.
Última atualização : 2009-02-13 15:33:03

ac02355_