Conectando-se ao Mecanismo de Fluxo para Depuração

Antes de começar

Para concluir esta tarefa, você deve ter concluído as tarefas a seguir:

Antes de depurar seu fluxo de mensagens, você deve conectar o depurador de fluxo ao mecanismo de fluxo (grupo de execução) no qual o fluxo está implementado e iniciar uma sessão de depuração. Se desejar, você poderá conectar o depurador de fluxos a vários mecanismos de fluxos que estão em execução nas mesmas máquinas host ou em máquinas diferentes e, em seguida, depura seus fluxos simultaneamente.

Início da mudançaNão é possível depurar fluxos implementados para um grupo de execução de 64 bits; somente os grupos de execução de 32 bits são suportados pelo depurador de fluxo.Fim da mudança

Para conectar-se ao mecanismo de fluxos:

  1. Alterne para o Perspectiva de Administração do Intermediário. Observe o nome de seu fluxo de mensagens conforme exibido na área de janela Domínios.
  2. Abra o fluxo de mensagens que deseja depurar no editor do Fluxo de Mensagens dando um clique duplo em seu nome na área de janela Navegador de Administração do Intermediário.
  3. Inclua um ponto de interrupção em uma conexão que inicia o nó input do fluxo de mensagens. A inclusão desse ponto de interrupção garante que o fluxo de mensagens não é executado até a conclusão antes que você possa começar a depurá-lo.

    O ponto de interrupção aparece como Ponto de Interrupção Ativado. (Para obter informações sobre como incluir um ponto de interrupção, consulte Trabalhando com Pontos de Interrupção no Depurador).

  4. Alterne para o Perspectiva de Depuração.
  5. Clique na seta down-arrow no ícone Depurar Ativar Depuração na barra de ferramentas e selecione Depurar para chamar o assistente Depurar (Criar, Gerenciar e Executar Configurações).
    Dica: Você está criando uma configuração de ativação de depuração. Se já criou uma, poderá reativá-la, clicando diretamente no ícone Depurar Ativar Depuração em si. Essa ação gera um erro se qualquer uma das seguintes condições for verdadeira:
    • Você não criou uma configuração de ativação de depuração
    • O intermediário e o grupo de execução ao qual conectou anteriormente não estão mais em execução
    • O intermediário e o grupo de execução foram reiniciados e, portanto, têm um novo ID do Processo (consulte abaixo).
  6. Na lista de configurações, selecione Depuração do Intermediário de Mensagens e clique no botão Novo. Aparece um conjunto de painéis com guia na janela, começando com Conectar.
    Dica: O botão Depurar permanecerá esmaecido até que você preencha os campos no painel Conectar. Depois disso, você poderá optar por preencher os campos nos outros painéis ou clicar diretamente em Depurar.
    Os painéis no assistente são os seguintes:
    1. Conectar: utilize este painel para estabelecer uma conexão com o mecanismo de fluxo por meio do Rational Agent Controller. Você deve preencher todos os campos neste painel antes de clicar no botão Depurar para iniciar uma sessão de depuração.

      Número de porta do Agent Controller
      Digite o número da porta que deseja utilizar.
      Projeto de Fluxo
      Selecione seu projeto de fluxo.
      HostName
      Selecione o computador host no qual o mecanismo de fluxo está em execução. Se o host não estiver listado, digite o nome do host ou endereço IP do computador host no campo HostName (se o campo HostName não estiver disponível, primeiro clique no botão Reconfigurar, em seguida, faça suas alterações).
      Mecanismo de Fluxo
      Selecione o intermediário e mecanismo de fluxo que deseja depurar. Na lista de opções que se abre quando você clica no botão Procurar, cada mecanismo de fluxo é listado como seu número de processo, seguido pelo nome do intermediário e pelo nome do grupo de execução separado por dois pontos, por exemplo:
      ProcessID    Engine name
      ---------    ---------------
      5984         WMBV6BR:default
      Se o mecanismo de fluxos não aparecer no quadro de listagem, clique em Atualizar para atualizar o quadro de listagem com os nomes de todos os mecanismos de fluxos que estão implementados atualmente e disponíveis no computador host. (Se o mecanismo de fluxo ainda não aparecer no quadro de listagem, tente reiniciar o RAC no computador host).

      Você terá a opção de conectar-se a qualquer grupo de execução em execução no host de destino. Isto inclui grupos de execução que não possuem fluxos implementados.

      Dica: O número do processo é o PID do Windows, como listado em Gerenciador de Tarefas na página Processos. O PID foi relatado para você no Registro de Eventos quando você implementou, conforme descrito em Implementando uma Topologia do Publicação/Assinatura.
      Agora clique em Depurar para ir para a próxima etapa ou preencher os outros painéis da seguinte forma:
    2. Configuração de Depuração Java: utilize este painel quando desejar depurar um nó Java definido pelo usuário ou um nó JavaCompute. A porta Java é o número da porta especificado para a JVM do intermediário. Se você não especificar uma porta, a depuração Java será desativada.
      Dica:
      Configurando a Porta de Depuração da JVM do Intermediário
      Para depurar um nó JavaCompute ou um nó definido pelo usuário contendo código Java, a JVM do intermediário deve ser configurada com um número da porta de depuração. Para configurar esse valor, emita o seguinte comando (tudo em uma linha):
      mqsichangeproperties <broker-name> -e <execution-group-name>
       -o ComIbmJVMManager -n jvmDebugPort -v <port-number>
      Você deve reiniciar o intermediário quando esse comando tiver sido concluído.
    3. Origem: utilize este painel para informar o depurador sobre o local de procura de arquivos de origem para fluxo, mapeamento, ESQL, ou Java durante a depuração. O caminho de consulta pode ser um nome de projeto Eclipse, pasta externa ou um arquivo compactado (zipado). Você pode especificar vários locais, mas o depurador sempre procura primeiro no projeto do fluxo de mensagens especificado no painel Conectar.
    4. Comum: este painel não é diretamente utilizado pelo depurador de fluxo, no entanto, se você configurar opções nele, elas terão efeito. Consulte Guia do Usuário do Workbench para obter detalhes.
  7. Clique no botão Depurar. Na visualização Depuração, são exibidos os nomes do computador host selecionado e do mecanismo de fluxo.
  8. Quando a próxima mensagem chegar em seu fluxo e chegar no ponto de interrupção, o fluxo será pausado, o ícone do ponto de interrupção será alterado como Ponto de Interrupção Pausado Ativado  e você poderá iniciar a depuração.
  9. Na visualização Depuração, dê um clique duplo no fluxo de mensagens que deseja depurar. O fluxo de mensagens é aberto no editor do Fluxo de Mensagens e agora você pode incluir mias pontos de interrupção, começar a atravessar o fluxo e assim por diante.
Dica: A partir de um único workbench, o depurador pode conectar-se a um ou mais grupos de execução e depurar vários fluxos em diferentes grupos de execução (e, portanto, várias mensagens) ao mesmo tempo. No entanto, um fluxo implementado em um grupo de execução pode ser depurado apenas por um usuário de cada vez, portanto, se você conectar seu depurador com ele, outro usuário não poderá conectar-se com um depurador ao mesmo tempo.
Início da mudança

O depurador de fluxo fornecido na Versão 6.0 pode depurar intermediários de tempo de execução de versões anteriores. Selecione a versão do intermediário que deseja depurar marcando a opção correspondente no painel Seleção de Mecanismo no assistente de Depuração conforme descrito acima.

Para obter detalhes de qual versão do Rational Agent Controller deve ser instalada em cada uma das plataformas do intermediário, consulte Instalando o Rational Agent Controller.

Agora que você concluiu essa tarefa, é possível continuar com uma das tarefas a seguir:

Fim da mudança
Conceitos relacionados
Visão Geral do Depurador de Fluxo
Tarefas relacionadas
Instalando o Rational Agent Controller
Implementando
Depuração um Fluxo de Mensagens
Depuração: Desconectando-se do Mecanismo de Fluxo
Referências relacionadas
Atalhos do Depurador de Fluxo
Ícones e Símbolos do Depurador de Fluxo
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
ag11186_