Resolvendo Problemas ao Implementar Fluxos de Mensagens ou Conjuntos de Mensagens

  1. Para depurar problemas ao implementar, verifique os registros:

    Esses logs podem estar em computadores separados e devem ser utilizados em conjunto com a saída do workbench para assegurar que a implementação obteve êxito.

    Utilize o comando mqsilist para verificar se a implementação foi bem-sucedida ou consulte o registro de Eventos do Windows ou o registro de Eventos de domínio do intermediário.

  2. Utilize esta lista de verificação quando tiver problemas de implementação:
    • Certifique-se de que o gerenciador de filas remoto esteja em execução.
    • Certifique-se de que os canais estejam em execução.
    • Exiba o status do canal para ver se o número de mensagens do sistema enviadas aumenta.
    • Verifique o canal a partir da extremidade remota.
    • Verifique o nome do gerenciador de filas.
    • Determine se o canal é um canal de cluster.

Este tópico contém avisos para lidar com alguns problemas comuns que podem surgir ao implementar fluxos de mensagens ou conjuntos de mensagens.
Preparando para implementar:
Durante a implementação:
Cancelando a implementação:
Após a implementação:

Fluxos de Mensagens Migrados Não Estão Disponíveis para Inclusão em um Arquivo Archive do Intermediário

Um Erro é Emitido Quando você Inclui um Dicionário em um Arquivo Arquivado do Intermediário

Você Não Pode Arrastar um Arquivo Broker Archive para um Intermediário

Não É Possível Implementar um Fluxo de Mensagens Que Utilize um Fluxo de Mensagens Plug-in

O Arquivo Compilado (.cmf) do Fluxo de Mensagens Não Foi Gerado

O Fluxo de Mensagens Implementa no Sistema de Teste, Mas Não em Outros Locais

A Implementação Indica que o Intermediário Não Existe

O Configuration Manager Está Tentando Implementar em um Intermediário que Não Existe.

O Configuration Manager Relata que Está Sem Memória

Um Erro de Nome de Correlação é Emitido durante a Implementação em um Intermediário do Versão 2.1

Mensagens de Erro Emitidas durante a Implementação no z/OS

A Serialização de Entrada Esperada Não Está Ocorrendo para uma Fila Compartilhada que Atende a Várias Instâncias de um Fluxo de Mensagens no z/OS

Os Nós MQe não Funcionam Conforme o Esperado após a Implementação em um Intermediário da Versão 6.0

Mensagens de Erro Emitidas durante a Implementação

As mensagens de erro que podem ser geradas durante a implementação são listadas a seguir com uma explicação:

Mensagem BIP1106 com WebSphere MQ o código de razão 2030
  • Cenário: A mensagem de erro BIP1106 é emitida com o código de razão 2030, quando você está implementando um conjunto de mensagens grande.
  • Explicação: O tamanho da mensagem excede o comprimento máximo da mensagem da fila de transmissão para o gerenciador de filas do intermediário.
  • Solução: Aumente o comprimento máximo da mensagem para a fila de transmissão, utilizando o comando WebSphere MQ alter qlocal , no qual comprimento máximo da mensagem está em bytes:
    alter ql(transmit_queue_name) maxmsgl(104857600) 
    Consulte o WebSphere MQ System Administration Guide para obter informações adicionais sobre esse comando.
Mensagem BIP1106 com o erro WebSphere MQ AMQ7463
  • Cenário: A mensagem de erro BIP1106 é emitida com o código de razão 2102, quando você está implementando um conjunto de mensagens grande que compartilha o gerenciador de filas com o Configuration Manager. A mensagem de erro AMQ7463 do WebSphere MQ também é emitida com o texto: O registro para o gerenciador de filas <queue manager> está cheio.
  • Solução:
    1. Pare o Configuration Manager utilizando o comando mqsistop.
    2. Pare e intermediário utilizando o comando mqsistop.
    3. Pare o gerenciador de filas utilizando o comando amqmdain do WebSphere MQ:
      amqmdain end <queue manager>
    4. Se você tiver o WebSphere MQ Versão 5 instalado, clique em Iniciar > Programas > IBM WebSphere MQ > WebSphere MQ Services para iniciar o WebSphere MQ Services.
    5. Início da mudançaSe você tiver o WebSphere MQ Versão 6 instalado, clique em Iniciar > Programas > IBM WebSphere MQ > WebSphere MQ Explorer para iniciar o WebSphere MQ Explorer.Fim da mudança
    6. Início da mudançaClique com o botão direito do mouse no gerenciador de filas e clique em Propriedades. No WebSphere MQ Services, clique na guia Registro, no WebSphere MQ Explorer e selecione a entrada de Registro na área de janela esquerda.Fim da mudança
    7. Aumente o número de arquivos primários e secundários de registro para que o tamanho total seja maior que a mensagem de implementação.
    8. Inicie o Configuration Manager novamente, utilizando o comando mqsistart.
    9. Reinicie o intermediário utilizando o comando mqsistart.
    10. Reinicie o gerenciador de filas utilizando o comando amqmdain do WebSphere MQ:
      amqmdain start <queue manager>
      .
Mensagem BIP1538 com código de razão 2218
  • Cenário: A mensagem de erro BIP1538 é emitida como código de razão 2218 quando você está implementando um grande conjunto de mensagens.
  • Explicação: O tamanho da mensagem excede o tamanho máximo da mensagem no canal.
  • Solução: Aumente o parâmetro maxmsgl do canal em ambos pares de canais, nas duas extremidades:
    1. No gerenciador de filas do Configuration Manager, emita o comando WebSphere MQ alter channel :
      alter chl(CM_to_BRK) chltype(sdr) MAXMSGL(104857600)
      alter chl(BRK_to_CM) chltype(rcvr) MAXMSGL(104857600) 
    2. No gerenciador de filas do intermediário, emita o comando WebSphere MQ alter channel:
       alter chl(BRK_to_CM) chltype(sdr) MAXMSGL(104857600)
       alter chl(CM_to_BRK) chltype(rcvr) MAXMSGL(104857600)
    3. Pare e reinicie cada um dos canais.
Mensagem BIP1536
  • Cenário: Você definiu um Configuration Manager para ser executado com um ID do usuário e definiu um intermediário para ser executado em um computador diferente com um ID do usuário diferente. A implementação é bem-sucedida, mas a mensagem de erro BIP1536 é emitida quando você implementa fluxos de mensagens e conjuntos de mensagens para o intermediário.
  • Explicação: É impossível ao Configuration Manager registrar assinaturas internas com o intermediário, pois o intermediário está em execução sob um ID e o Configuration Manager está em execução sob outro ID. O intermediário e o Configuration Manager trocam mensagens internas entre si através do Publicação/Assinatura. Essas mensagens são transportadas pelo WebSphere MQ, que requerem determinadas autorizações.
  • Solução:
    • Certifique-se de que o ID de usuário do intermediário seja um membro dos grupos mqm e mqbrkrs.
    • Defina o ID do usuário do intermediário no computador em que o Configuration Manager está sendo executado.
    • Defina o ID do usuário do Configuration Manager no computador no qual o intermediário está em execução.
    • Certifique-se de que todos os IDs estão em letra minúscula para que sejam compatíveis entre os computadores.
Mensagens BIP1536 e BIP7017
  • Cenário: As mensagens de erro BIP1536 e BIP7017 são exibidas.
  • Explicação: O Configuration Manager teve um problema ao registrar suas assinaturas internas nos tópicos relacionados à alteração do status do intermediário, que tenta fazer toda vez que uma configuração completa é implementada. A causa do problema é fornecida pela mensagem BIP7017, que indica que está executando com um Servidor de Nome de Usuário configurado, mas que o intermediário ao qual você está implementando não possui o ID do usuário de serviço do Configuration Manager no cache do usuário.
  • Solução: Faça as verificações a seguir. Quando você identificar e corrigir o problema, as assinaturas serão registradas corretamente na próxima vez que você implementar:
    • Assegure-se de que o Servidor de Nome de Usuário seja iniciado.
    • Assegure-se de que os canais do WebSphere MQ entre o Servidor de Nome de Usuário e o intermediário sejam iniciados.
    • Assegure-se de que o ID do usuário esteja presente no domínio do Servidor de Nome de Usuário.
Mensagem BIP1835
  • Cenário: A mensagem de erro BIP1835 é exibida.
  • Explicação: O conjunto de mensagens que você está implementando produz um dicionário de conjunto de mensagens maior do que o limite interno de 4 MB. Isso pode ocorrer porque você tem muitas definições de mensagens grandes definidas para o mesmo conjunto de mensagem.

    O tamanho de um conjunto de mensagens exportado não é uma boa indicação do tamanho do dicionário do conjunto de mensagens gerado na hora da implementação, pois o conjunto de mensagens exportado é armazenado como XML. Esse pode ser muito detalhado, mas o dicionário tem um formato interno muito mais compacto.

  • Solução: Divida as definições de mensagens em vários conjuntos de mensagens menores.
Início da mudançaMensagem BIP2045
  • Cenário: A mensagem de erro BIP2045 é exibida no Message Brokers Toolkit após a implementação.
  • Explicação: Cada intermediário é identificado por um UUID (Universally Unique Identifier), que é armazenado no Configuration Manager quando o intermediário é definido. O UUID também é armazenado no intermediário quando recebe sua primeira mensagem de implementação. Se o intermediário receber uma mensagem de implementação que contém um UUID diferente, ele rejeitará essa mensagem e emitirá a mensagem de erro BIP2045. Isso pode acontecer nas seguintes circunstâncias:
    • você tenta implementar a partir de um segundo Configuration Manager; esse cenário não é suportado.
    • você recria o Configuration Manager, mas não o intermediário
    • você enfrenta problemas com o canal do WebSphere MQ enquanto está excluindo e recriando o intermediário
  • Solução: Certifique-se de que não esteja utilizando mais de um Configuration Manager para controlar um único intermediário. Se esse não for o problema, siga as instruções na mensagem de erro BIP2045 para reassumir o controle do intermediário reconstruindo-o e reimplementando seus aplicativos de fluxo de mensagens.
Fim da mudança
Mensagem BIP2066
  • Cenário: A mensagem de erro BIP2066 é exibida.
  • Explicação: O pedido de implementação não foi reconhecido pelo grupo de execução antes do tempo limite do intermediário ConfigurationTimeout mais o ConfigurationDelayTimeout (padrão de 60 segundos) expirar.
  • Solução: Altere esses tempos limites utilizando os parâmetros -g e -k dos comandos mqsicreatebroker e mqsichangebroker.
Mensagem BIP2242
  • Cenário: A mensagem de erro BIP2242 é exibida.
  • Explicação: O pedido de implementação (alteração da configuração) não foi aceito antes do tempo limite do intermediário ConfigurationTimeout (padrão de 300 segundos) expirar. O tempo limite deve ser longo o suficiente para que o fluxo de mensagens conclua o processamento de sua mensagem atual e então aceite o pedido de implementação.
  • Solução: Configure esses tempos limites utilizando os parâmetros -g e -k dos comandos mqsicreatebroker e mqsichangebroker.
  • Cenário: Quando você implementa em um intermediário, a mensagem de erro BIP7053S é exibida.
  • Explicação: Esse erro ocorre em um ambiente de pilha multi TCP/IP e indica que o ambiente TCP/IP do USS (UNIX System Services) não foi configurado corretamente.
    O WebSphere Message Broker utiliza funções do USS para obter o nome do host para um determinado sistema. A mensagem de erro a seguir será exibida se o nome do host padrão não estiver configurado corretamente no ambiente do USS:
    BIP7053S: Broker $SYS_mqsi 0 unexpected Java exception java.lang.Error: -2103399272!java.net.UnknownHostException :
    Hostname: Hostname
    O nome do host que é reportado na mensagem de erro é aquele que foi retornado para o intermediário como um resultado da chamada gethostname.
  • Solução: Certifique-se de que o ambiente TCP/IP esteja configurado corretamente no USS.
Erro do Validador TDS (Tagged/Delimited String)
  • Cenário: Você tenta implementar um conjunto de mensagens com um um formato de linha TDS que possui um erro.
  • Explicação: O trecho a seguir de um registro de erros ilustra o que você pode ver para um erro do Aprovador TDS. Nesse caso, a causa do problema é que o elemento Town não tem uma tag definida.
    Arquivo de Rastreio do Extrator TDS
    ========================
    
    Iniciando a Extração..
    
    Extraindo Info de Identificação
    Extraindo Info do Projeto
    Extraindo Mensagens
    Extraindo Elementos
    Extraindo Tipos Compostos
    Extraindo Membros de Tipo
    Extraindo Membros de Tipo
    Extraindo Membros de Tipo
    Extraindo Membros de Tipo
    Extraindo Membros de Tipo
    Iniciando Indexação..
    
    Criando IDs de Membros para a Tabela de Índice de Marcações.
    
    Iniciando Validação..
    
    Validando Projeto
    Validando Tipos
    ERRO: TDSValidator::ValidateTypeMemberSimpleElement:
        Elementos simples em um tipo com o atributo Data Element Separation = Tagged
        Delimited devem ter o seguinte atributo definido:
        Element Level - Tag
    (ID do Elemento: Town)
    (ID do Tipo: AddressType)
    Código de Retorno: -80
    
    Validando Mensagens
    
    Info de Rastreio
    ===========
    EXCEPTION: TDSValidator::Validate:
        Validação TDS falhou.
            1 erros
            0 avisos
    Código de Retorno: -1
  • Solução: Utilize as informações no registro de erros para corrigir o problema.

A Mensagem de Erro BIP2432 É Emitida quando Você Implementa a partir de um Configuration Manager Versão 6.0 para um Intermediário Versão 2.1

Ao Cancelar uma Implementação, o mqsilist Mostra um Fluxo de Mensagens em um Grupo de Execução mas as Ferramentas não

Você Não É Notificado Sobre o Resultado de uma Implementação

Você Não Recebe Confirmação de que a Implementação Obteve Êxito

Não É Possível Ver Nenhum Fluxo de Mensagens Implementado nem Conjunto de Mensagens

Um Intermediário Excluído Permanece no Navegador de Domínios

O Nó XMLTransformation não Funciona após a Implementação

Existem dois cenários que explicam por que o nó XMLTransformation pode não funcionar após a implementação:

São exibidas mensagens de erro indicando que as folhas de estilo não foram localizadas

Você obtém resultados da transformação inesperados.

  • Cenário: Você obtém resultados da transformação inesperados.
  • Explicação: Para fluxos de mensagens complexos, pode surgir uma incompatibilidade entre folhas de estilo e arquivos XML após uma implementação. Provavelmente, existem duas razões para isso:
    • Apenas parte das folhas de estilo ou arquivos XML de cooperação são implementados e atualizados (isto pode ser causado por uma falha no sistema de arquivos).
    • Vários nós XMLT que estão em execução dentro do mesmo grupo de execução devem utilizar folhas de estilo compatíveis, mas estão utilizando versões diferentes para processar a mesma mensagem que chega.
  • Solução: Se apenas parte das folhas de estilo ou arquivos XML de cooperação forem implementados e atualizados, resolva qualquer incompatibilidade reimplementando as versões compatíveis. Para evitar que vários nós XMLT utilizem versões diferentes da folha de estilo, pause os fluxos de mensagens relevantes no grupo de execução de destino antes de desempenhar a implementação, em seguida, reinicie os fluxos.
Conceitos relacionados
Visão Geral da Implementação
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
au16540_