Resolvendo Problemas ao Depurar Fluxos de Mensagens
Este tópico contém avisos para lidar com alguns problemas comuns que podem
surgir ao depurar os fluxos de mensagens.
Ocorre um Tempo Limite durante a Espera de Conexão do Serviço Rational Agent Controller
Cenário: Você vê mensagens de erro indicando que o serviço Rational Agent
Controller falhou ao iniciar e que ocorreu um tempo limite antes da conexão do Rational Agent
Controller.
Explicação: O Rational Agent Controller pode
estar utilizando a versão incorreta da JVM.
Solução: Assegure-se de que um JVM suportado esteja sendo utilizado. Para
determinar qual JVM está sendo utilizado, emita o comando java -version
na linha de comandos. Para obter o resultado correto, o comando java -version
deve chamar o arquivo executável Java que foi especificado para utilização quando o Rational Agent
Controller foi instalado.
O Depurador Não Pausa no Próximo Ponto de Interrupção
Cenário: O depurador de fluxo de mensagens não
pausa no próximo ponto de interrupção no fluxo de mensagens.
Solução: Execute as seguintes verificações:
Verifique se o DataFlowEngine está em execução; se não estiver, reinicie-o.
Verifique a fila de entrada. Se sua fila de entrada tiver as mensagens deixadas da vez anterior que o depurador foi utilizado, limpe-as antes de enviar uma nova mensagem.
A Mensagem Não Pára de Ser Executada em Nenhum Ponto de
Interrupção
Cenário: A mensagem não pára de ser executada em
nenhum ponto de interrupção após a conexão ao depurador.
Explicação: Este erro pode ser causado por um problema de cronometragem,
ou se você tiver configurado os parâmetros incorretos para a sessão de depuração.
Solução: Execute as seguintes etapas.
Verifique as definições de configuração de ativação, assegurando que você especificou o Projeto de Fluxo, o Nome do Host e o Mecanismo de Fluxo corretos para a sessão de depuração.
Reinicie a sessão de depuração.
Ocorrem Problemas de Edição no Editor de Fluxo de Mensagens
Cenário: Durante a depuração de um fluxo de mensagens, ocorrem problemas de edição quando você está utilizando o
editor de Fluxo de Mensagens.
Solução: Não tente editar a mensagem enquanto o
depurador de fluxo está conectado.
Para editar um fluxo de mensagens, desconecte o depurador, edite o fluxo de mensagens e, em seguida, implemente novamente o fluxo de mensagens.
A Edição do MQMD (MQ Message Descriptor) Provoca Comportamento Inesperado
no Depurador
Cenário: Você edita propriedades do descritor MQMD da mensagem
no editor de Conjunto de Mensagens, mas isso causa comportamento inesperado no depurador.
Explicação: Se você editar o conteúdo do descritor MQMD,
esses campos aceitam um certo intervalo de valores. É preciso conhecer esses valores
antes de editar as propriedades. A menos que você defina
explicitamente o valor desses campos, eles assumem valores padrões e
certos campos podem não ter sido especificados na mensagem. Os valores dos campos que não estão configurados explicitamente na mensagem são valores padrão; não altere os mesmos, a menos que você esteja ciente de sua importância ou do possível intervalo de valores.
Não é Possível Ver o Conteúdo da Mensagem ao Depurar o Fluxo
de Mensagens
Cenário: Você está utilizando o depurador de fluxo
de mensagens e pode ver a mensagem passando através do fluxo de
mensagens, mas não consegue ver o conteúdo da mensagem.
Solução: Abra a visualização Mensagem de Depuração do Fluxo, clicando em Janela > Mostrar Visualização > Outro > Fluxo de Mensagens > Mensagem de Depuração do Fluxo e, em seguida, OK.
Não É Possível Ver os Nomes dos Fluxos de Mensagens na Visualização Depuração (Debug)
Cenário: Você não consegue ver os nomes dos fluxos de mensagens implementados
na visualização Depuração (Debug) após a conexão do depurador com o grupo de execução.
Solução:
Pare o intermediário no qual o grupo de execução está executando.
Reinicie o Rational Agent Controller que está em execução
no mesmo computador que o intermediário.
Iniciar novamente o intermediário.
Não É Possível Ver os Nomes dos Fluxos Implementados na Visualização Depuração (Debug)
Cenário: Não é possível ver os nomes dos fluxos implementados na
visualização Depuração (Debug) após a conexão com o grupo de execução.
Explicação: Pode ser um problema de sincronização.
Solução: Aguarde até que o intermediário tenha sido totalmente iniciado e tente
conectar o depurador novamente, ou reinicie o Rational Agent Controller que está em execução no mesmo computador que o intermediário e, em seguida, reinicie o intermediário.
Aparece um Ponto de Exclamação Acima de um Nó Durante a Depuração
Cenário: No Editor de Fluxo de Mensagens, é exibido um ponto de exclamação
(!) acima de um nó durante a depuração.
Explicação: Ocorreu uma exceção no nó durante a
depuração.
Solução: Examine a ExceptionList na visualização Variáveis
de Perspectiva de Depuração para saber o tipo de
erro ocorrido.
O PutTime Relatado pelo WebSphere MQ no z/OS e Outros Horários ou Time Stamps Estão Inconsistentes
Cenário: O PutTime relatado pelo WebSphere MQ no z/OS e outros horários ou time stamps estão inconsistentes.
Uma diferença de aproximadamente 20 segundos é detectada em:
Rastreios (incluindo os obtidos a partir do nó Trace)
O registro de data e hora do comando MQPUTTIME no cabeçalho MQMD
da mensagem
Registros de data e hora obtidos da ESQL (por exemplo, em um nó Compute)
Explicação: WebSphere Message Broker relata o horário utilizando UTC (Universal Time Coordinated), que não considera os segundos saltados. No entanto, no z/OS, o
putTime da mensagem que é relatado pelo WebSphere MQ no cabeçalho MQMD de uma mensagem considera os segundos saltados, utilizando o valor especificado para o número de segundos saltados no campo CVT.
Essa inconsistência pode causar:
Problema ao depurar
Problemas com fluxos de mensagens se você utilizar registros de data e hora para controlar o fluxo de mensagens
Informações incorretas
Solução: Configure o campo CVT de forma que fique consistente com os segundos saltados de UTC. Como alternativa, inclua um deslocamento para ajustar a leitura de time stamp do z/OS. Por exemplo, inclua 20 segundos ao tentar obter o CURRENT_TIME em
ESQL.
O Processamento da Mensagem Não Pára em Nenhum Ponto de
Interrupção
Cenário: O processamento de mensagens continua quando um ponto de interrupção é localizado.
Explicação: Este erro pode ser causado por um problema de cronometragem,
ou se você tiver configurado os parâmetros incorretos para a sessão de depuração.
Solução: Verifique sua definição de configuração de ativação. Assegure que você tenha especificado o Projeto de Fluxo, o Nome do Host e o Mecanismo de Fluxo corretos para a sessão de depuração.
Reinicie a sessão de depuração.
Você não pode ver onde o depurador está no editor de mapeamento de mensagens
Cenário: O editor de mapeamento de mensagens foi aberto no toolkit,
mas não está claro onde o depurador está no mapa.
Explicação: O caminho de consulta de origem para o arquivo de mapeamento
da mensagem não está configurado corretamente.
Solução: Verifique suas definições de configuração de ativação da depuração
e assegure que você configurou o caminho de consulta de origem para o arquivo de mapeamento
da mensagem corretamente.
Ao Depurar um Mapa de Mensagem, o Depurador Não Move para o Próximo
Campo
Cenário: Você está depurando um mapa de mensagem e o depurador
não move para o próximo campo. Você precisa clicar no botão Avançar
várias vezes.
Explicação: O caminho de consulta de origem para o arquivo de mapeamento
da mensagem não está configurado corretamente.
Solução: Verifique suas definições de configuração de ativação da depuração
e assegure que você configurou o caminho de consulta de origem para o arquivo de mapeamento
da mensagem corretamente.
Ao Depurar um Mapa de Mensagem, o Depurador Não Move para Fora do
Nó de Mapeamento
Cenário: Você está depurando um Mapa de Mensagem e o Depurador
Não Move para Fora do Mapa de Mensagem.
Explicação: O caminho de consulta de origem para o arquivo de mapeamento
da mensagem não está configurado corretamente.
Solução: Verifique suas definições de configuração de ativação da depuração
e assegure que você configurou o caminho de consulta de origem para o arquivo de mapeamento
da mensagem corretamente.
O Fluxo de Mensagens Pára em um Nó do Coletor
Cenário: O processamento de mensagens pára após a seleção
do ícone Entrar no Código-fonte em um nó do Coletor.
Explicação: O nó do coletor é um nó multiencadeado
e o encadeamento é finalizado selecionando Entrar no Código-fonte.
Solução: Configure um ponto de interrupção manualmente após o nó
do coletor.