Migrando um Fluxo de Mensagens

Você pode migrar os fluxos de mensagens criados em WebSphere MQ Event Broker Versão 2.1 e utilizá-lo em WebSphere Business Integration Event Broker Versão 5.0.

Talvez você queira alterar os fluxos de mensagens migrados para tirar vantagem dos novos nós e recursos que estão disponíveis. Para obter informações adicionais sobre as alterações deste release, consulte O que Há de Novo?.

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 para mais de um arquivo de exportação, a tarefa de migração sobrescreverá sem aviso qualquer fluxo de mensagens existente pelo próximo fluxo que ela localizar com o mesmo nome. Portanto, você deve ter cuidado para evitar conflitos e para assegurar que a versão mais recente de um fluxo de mensagens múltiplo definido seja o último a ser migrado.

Se você tiver várias versões do mesmo fluxo de mensagens e utilizar esse como um subfluxo em outros fluxos no mesmo diretório de migração, os resultados da importação serão imprevisíveis.

Para migrar um fluxo de mensagens:

  1. Antes de instalar a Versão 2.1, exporte o fluxo ou os fluxos de mensagens do Centro de Controle, utilizando as ferramentas da Versão 2.1 (consulte a biblioteca 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 workbench. 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 você tiver uma sessão ativa do workbench, deverá fechá-la. Não é possível executar o comando migrar se o workbench estiver em execução.
  4. Em um prompt de comandos, chame o comando mqsimigratemsgflows, especificando o nome do novo projeto e o diretório no qual você armazenou os arquivos de exportação (consulte o Comando mqsimigratemsgflows para obter detalhes completos deste comando). Quando o comando estiver concluído:
    • Os fluxos de mensagens contidos nos arquivos de exportação no diretório especificado serão importados para o projeto do fluxo de mensagens especificado. Se o projeto já existir, os fluxos de mensagens adicionais serão incluídos com o conteúdo atual, se houver algum. Se o projeto não existir antes de você chamar o comando, ele será criado. É recomendável permitir que o comando crie o projeto do fluxo de mensagens.
    • Os fluxos de mensagens e subfluxos foram criados e suas definições armazenadas em arquivos denominados <flow_name>.msgflow.

      Se desejar renomear qualquer um desses fluxos de mensagens ou nós após a importação para ficar de acordo com as convenções de nomenclatura locais, será necessário utilizar os recursos fornecidos pelo workbench para preservar a consistência e 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 está gravado no diretório a partir do qual você chamou o comando. O comando fornece as seguintes informações:
    • O nome de cada fluxo de mensagense subfluxo migrado.Se qualquer um destes recursos tiver um nome que seja incompatível com a Versão 5.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 será sempre a mesma).
    • O êxito ou falha de cada 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 isso ocorrer, localize o subfluxo ausente e importe-o para o projeto apropriado para resolver esse erro. 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 todos os processos de exportação e importação.

  6. Inicie o workbench e alterne para a Perspectiva do Desenvolvimento de Aplicativos do Intermediário.
  7. Abra o projeto do fluxo de mensagens criado ou atualizado pelo comando migrar (clique com o botão direito no projeto e selecione Abrir Projeto). Se o projeto já estiver aberto, clique com o botão direito e selecione Atualizar, em seguida, Reconstruir Projeto para assegurar que a visualização Navegador refletirá o novo conteúdo.A reconstrução também executa uma validação do conteúdo do projeto do fluxo de mensagens.

Conceitos relacionados
Fluxos de Mensagem

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
Editor ESQL
Nós Internos
Comando mqsimigratemsgflows