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.
Nã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.
Para conectar-se ao mecanismo de fluxos:
- 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.
- 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.
- 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
. (Para obter informações sobre como incluir
um ponto de interrupção, consulte Trabalhando com Pontos de Interrupção no Depurador).
- Alterne para o Perspectiva de Depuração.
- Clique na seta down-arrow no ícone Depurar
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 
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).
- 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:- 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.
Agora clique em Depurar para ir para a
próxima etapa ou preencher os outros painéis da seguinte forma:
- 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.
- 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.
- 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.
- Clique no botão Depurar. Na visualização Depuração, são exibidos os nomes do computador host selecionado e do mecanismo de fluxo.
- 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
e você poderá iniciar a depuração.
- 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.

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:
