Revise possíveis problemas com nós usando o transporte JMS.
Use o log de atividades como a primeira etapa no diagnóstico de um problema quando algo inesperado acontecer em um fluxo de mensagens. O log de atividades mostra as atividades recentes em seus fluxos de mensagens e nos recursos externos associados, e pode mostrar a você, em um alto nível, quaisquer problemas que ocorram com os seus recursos JMS. Você também pode visualizar o log de eventos para obter informações sobre os erros que ocorrem.
Em todos os casos de erro, se a causa subjacente for uma exceção JMS que foi lançada pelo provedor JMS, a mensagem de evento BIP do broker incluirá a mensagem de texto da exceção JMS para ajudar a diagnosticar.
Se uma mensagem não puder ser processada pelo nó de entrada JMS, ou tiver sido retrocedida como parte de uma transação coordenada por XA, a mensagem será retrocedida para o destino de origem. A mensagem então é entregue novamente para o nó de entrada.
Propriedade | Descrição |
---|---|
Destino de restauração | Essa propriedade especifica um destino JMS para o qual as mensagens
restauradas serão roteadas se a propriedade de mensagem JMS
JMSX_DeliveryCount, configurada pelo provedor JMS, exceder o limite de
restauração. O destino JMS deve ser aplicável ao modelo de mensagem que está sendo utilizado pelo nó; por exemplo, se um tópico de assinatura tiver sido configurado no nó, o destino JMS também deverá ser um tópico. |
Limite de Backout | Essa propriedade especifica o valor de número inteiro que controla uma mensagem enviada ao destino de restauração. Um valor de limite igual a 3 indica que, se o nó de entrada receber uma mensagem em que o valor da propriedade JMSX_DeliveryCount excede 3, a mensagem será enviada para o destino de restauração e removida do destino de origem. Consulte o Configurando a Propriedade de Limite de Restauração. |
Esse problema não é aplicável ao z/OS.
Além do rastreio de serviço do broker, é fornecido outro log de rastreio para diagnosticar problemas que podem ocorrer quando um nó que usa o transporte JMS participa de uma transação de fluxo de mensagem coordenado por XA. Ou seja, pelo menos um nó JMS no fluxo de mensagens possui a propriedade Modo de Transação configurada como Sim e a propriedade do fluxo de mensagens Transação Coordenada configurada como sim.
XAJMS_TRACEFILE = c:\JMSSwitchLog
O exemplo anterior produz um arquivo chamado JMSSwitchLog2596.txt, no qual o ID do processo de inicialização do gerenciador de filas é 2596.
Nenhum desses arquivos de rastreio requer formatação extra.
Descrição do problema: O nó JMS não pode obter o Factory de Contexto Inicial ou um objeto administrado pela JNDI, como o Connection Factory ou destino JMS, e a mensagem BIP4640 é emitida.
mqsireportproperties MB8BROKER -c JMSProviders -o JMSProvider –r
Descrição do problema: Um nó JMS não consegue conectar-se a um provedor JMS e emite a mensagem BIP4648.
Descrição do problema: Um nó JMS não consegue obter um destino JMS e emite a mensagem BIP4642.
Descrição do problema: Um nó de entrada JMS não tenta reconectar-se a um provedor JMS após uma falha de conexão ou um reinício do provedor JMS.
Ação corretiva: Se o provedor JMS for implementado usando um modelo que seleciona o cliente JMS, em vez de um modelo de pesquisa tradicional, o provedor JMS poderá não lançar uma exceção ao chamar receive() em uma conexão do broker. Para resolver esse problema, configure a propriedade jmsAsyncExceptionHandling do serviço configurável JMSProviders como true para esse provedor JMS.