Migrando um Nó Definido pelo Usuário

Você deve executar as seguintes etapas para migrar um nó definido pelo usuário para o WebSphere Message Broker Versão 6.0:
  1. Migrando a Representação do Message Brokers Toolkit do Nó Definido pelo Usuário
  2. Migrando o Código do Nó Definido pelo Usuário do Tempo de Execução

Migrando a Representação do Message Brokers Toolkit do Nó Definido pelo Usuário

Você pode implementar um nó definido pelo usuário escrito no Versão 5.0 Message Brokers Toolkit no Versão 6.0 Message Brokers Toolkit. Antes de poder implementar o nó definido pelo usuário, você deve migrar a representação do Message Brokers Toolkit do nó definido pelo usuário para o Message Brokers Toolkit Versão 6.0.

Para migrar da Versão 5.1 ou do Message Brokers Toolkit Versão 5.1 para o Message Brokers Toolkit Versão 6.0, execute as etapas a seguir:

  1. Importe o projeto do nó definido pelo usuário no Versão 6.0 Message Brokers Toolkit.
  2. Selecione o projeto do nó definido pelo usuário no Explorador de Pacotes e clique em Projeto > Limpar Projeto.

Para migrar do Message Brokers Toolkit Versão 5.0 para o Message Brokers Toolkit Versão 6.0, conclua as seguintes etapas:

  1. Importe o projeto do nó definido pelo usuário no Versão 6.0 Message Brokers Toolkit.
  2. Selecione o projeto do nó definido pelo usuário no Explorador de Pacotes e clique em Projeto > Limpar Projeto.
  3. Modifique o elemento <requires> no arquivo plugin.xml na raiz do projeto do nó definido pelo usuário para que corresponda ao seguinte:
    <requires>
            <import match="greaterOrEqual" plugin="com.ibm.etools.mft.api" version="6.0.0"/>
    </requires>
  4. Modifique a extensão "org.eclipse.help.contexts" no mesmo arquivo plugin.xml para que corresponda ao seguinte:
    <extension point="org.eclipse.help.contexts">
    <contexts file="HelpContexts.xml"/>
    </extension>

Quando você tiver migrado os nós definidos pelo usuário, não será necessário migrar nenhum fluxo de mensagens que contenha o nó definido pelo usuário.

Migrando o Código do Nó Definido pelo Usuário do Tempo de Execução

Para migrar o código do nó definido pelo usuário do tempo de execução, execute as seguintes etapas:

  1. Coloque uma cópia do arquivo compilado ou empacotado da extensão definida pelo usuário em todos os sistemas de intermediários a partir dos quais você pretende utilizá-la.
    • Se você estiver migrando um nó Java definido pelo usuário, você poderá construir o arquivo de extensão definido pelo usuário uma vez e distribuí-lo para cada um de seus sistemas .
    • Se você estiver migrando um nó definido pelo usuário C e todos os seus intermediários forem do mesmo tipo, então, você pode construir o arquivo de extensão definido pelo usuário uma vez e distribuí-lo para cada um de seus sistemas.
    • Se você estiver migrando um nó C definido pelo usuário e tiver um cluster que consiste em vários tipos de máquinas - por exemplo, um intermediário AIX, um Solaris e um Windows, então, você deve construir os arquivos separadamente em cada tipo de máquina.
  2. Especifique o diretório no qual colocar o arquivo, utilizando o comando mqsichangebroker ou mqsicreatebroker.

    Em versões anteriores, o arquivo .lil ou .jar era salvo no diretório de instalação. Não salve o arquivo .lil ou .jar no diretório de instalação do WebSphere Message Broker.

    Para extensões C definidas pelo usuário, armazene o arquivo .pdb que corresponde ao arquivo .lil no diretório escolhido. O arquivo .pdb fornece informações simbólicas utilizadas pelo WebSphere Message Broker, ao exibir informações de diagnóstico da pilha em caso de violações de acesso ou outros problemas de software.

  3. Pare e inicie cada intermediário. Isso é para assegurar que seja detectada a existência de um novo arquivo.
    Há duas situações em que não é necessário um reinício do intermediário:
    • Se você tiver criado um grupo de execução no Message Brokers Toolkit e ainda não houver nada implementado nele, é possível incluir os arquivos .lil, .pdb e .jar no diretório escolhido.
    • Se algo já tiver sido implementado no grupo de execução que você deseja utilizar, inclua o arquivo .lil, .pdb ou .jar no diretório escolhido e, em seguida, utilize o comando mqsireload para reiniciar o grupo. Não é possível sobrescrever um arquivo existente no sistema operacional Windows quando o intermediário está em execução, por causa da trava de arquivo utilizada pelo sistema operacional.
    Utilize essas duas abordagens com cautela, pois qualquer grupo de execução conectado ao mesmo intermediário também detectará os novos arquivos .lil, .pdb e .jar quando o grupo de execução for reiniciado ou quando algo for implementado pela primeira vez para o grupo de execução. Utilizando a maneira mais convencional de reiniciar o intermediário, certifique-se de que qualquer pessoa com interesse em um grupo de execução específico reconheça que foram feitas alterações recentes no intermediário.

    Essas duas situações supõem que você já concluiu a etapa anterior e, portanto, utilizou o comando mqsichangebroker ou o comando mqsicreatebroker para notificar o intermediário do diretório, no qual os arquivos de extensão definidos pelo usuário foram colocados.

    Quando você instalou um nó definido pelo usuário, ele é referido pelo seu esquema e nome, exatamente como um fluxo de mensagens.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
as10009_