Resolvendo Problemas que Ocorrem Durante a Implementação de Fluxos de Mensagens

Use o conselho fornecido aqui para ajudá-lo a resolver problemas que podem surgir durante a implementação dos fluxos de mensagens ou conjuntos de mensagens.

Procedimento

Você recebe uma mensagem de aviso sobre o modo de seu nó de integração
O fluxo de mensagens implementa no sistema de teste, mas não em outro lugar
Mensagens de erro sobre o seu modo de nó de integração são emitidas quando você cria um servidor de integração
Mensagens de erro sobre o seu modo de nó de integração são emitidas quando você implementa
Você cria uma política, em seguida, implanta um fluxo de mensagens e adaptador de entrada, mas a implementação falha
Você criou um fluxo de mensagens do WebSphere Adapters que usa adaptadores secundários, e um clash de nomenclatura ocorreu nos adaptadores secundários ou conjuntos de mensagens
Implementação falha quando você tem dependências de projeto circulares
As mensagens de erro são emitidas quando você implementa

Você recebe uma mensagem de aviso sobre o modo do seu nó de integração

Sobre esta tarefa

Mensagem BIP1806

Cenário: A mensagem de aviso BIP1806 foi exibida.
Explicação: seu nó de integração não foi iniciado.
Solução: Verifique se o nó de integração é iniciado: se ele não for iniciado, inicie-o usando o comando mqsistart .

Mensagem BIP1821

Cenário: A mensagem de aviso BIP1821 foi exibida.
Explicação: Seu nó de integração está sendo executado em um modo que restringe o número de servidores de integração que você pode usar; consulte Modos de operação.
Solução: entre em contato com o representante IBM para fazer upgrade da licença ou remover o número necessário de servidores de integração; consulte Excluindo um servidor de integração.

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

Procedimento

Cenário: O fluxo de mensagens que você desenvolveu implementa no sistema de teste, mas não em outro lugar.
Solução: Carry out as verificações a seguir:
- Assegure que você tenha verificado a instalação no sistema de destino criando e iniciando um nó de integração, e implementando um único servidor de integração. Essas ações confirmam que o nó de integração está definido corretamente.
- Certifica-se de que o arquivo broker.xml do arquivo do BAR contém referências aos recursos corretos para o novo sistema.
- Certifique-se de que quaisquer conjuntos de mensagens referenciados estejam implementados.
- Se os recursos de banco de dados ou os nós definidos pelo usuário não estiverem acessíveis ou autorizados a partir do sistema de destino, a implementação falhará. Nos sistemas distribuídos, assegure que você tenha definido as conexões ODBC ou JDBC para seus bancos de dados para que eles possam ser acessados a partir do nó de integração. Além disso, configure o ambiente do nó de integração para permitir acesso aos bancos de dados. Nos sistemas Linux® ou Unix , pode ser necessário executar um perfil de banco de dados
- Quaisquer extensões definidas pelo usuário que você esteja utilizando em seu fluxo de mensagens podem não carregar se elas não puderem ser localizadas ou não estiverem vinculadas corretamente. Consulte a documentação para seu sistema operacional para obter detalhes das ferramentas que podem ajudá-lo a verificar os arquivos binários de sua extensão definida pelo usuário.

Mensagens de erro sobre o seu nó de integração modo são emitidas quando você cria um servidor de integração

Sobre esta tarefa

Mensagem BIP1825

Cenário: A mensagem de erro BIP1825 foi exibida.
Explicação: O servidor de integração não pode ser criado porque o número máximo de servidores de integração para o modo do nó de integração de destino foi atingido, e a criação do servidor de integração faz com que esse limite seja excedido; consulte Modos de operação. O servidor de integração não foi criado.
Solução: Reutilizar um servidor de integração existente ou excluir um servidor de integração existente e tentar o comando novamente; consulte Excluindo um servidor de integração. Alternativamente, entre em contato com seu representante IBM para atualizar sua licença.

Mensagens de erro sobre o seu nó de integração modo são emitidas quando você implementa

Sobre esta tarefa

Mensagem BIP1829

Cenário: A mensagem de erro BIP1829 foi exibida.
Explicação: O arquivo BAR não pode ser implantado porque o número máximo de servidores de integração para o modo do nó de integração de destino foi atingido; consulte Modos de operação. O arquivo BAR não pode ser implementado.
Solução: Exclua um servidor de integração existente e tente o comando novamente; consulte Excluindo um servidor de integração Alternativamente, entre em contato com seu representante IBM para atualizar sua licença.

Você cria uma política e, em seguida, implementa um fluxo de mensagens e um adaptador de entrada, mas a implementação falha

Procedimento

Cenário: Você cria uma política, em seguida, implanta um fluxo de mensagens e adaptador de entrada, mas a implementação falha.
Explicação: Quando você cria uma política para um adaptador que ainda não foi implementado, as propriedades de conexão não são totalmente validadas até que você implemente o adaptador e o fluxo de mensagens que usa esse adaptador. Portanto, as propriedades configuradas na política podem ser inválidas.
Solução: Inspecionar a mensagem de erro que é retornada da implementação e determinar se a implementação falhou por causa de propriedades de conexão inválidas na política. Nesse caso, atualize os valores na política e, em seguida, reimplemente o projeto de política.

Você criou um fluxo de mensagens do WebSphere Adapters que usa adaptadores secundários, e um clash de nomenclatura ocorreu nos adaptadores secundários ou conjuntos de mensagens

Procedimento

Cenário: Você criou um fluxo de mensagens do WebSphere® Adapters que usa adaptadores secundários, e ocorreu um clash de nomenclatura. Você precisa saber quais adaptadores e conjuntos de mensagens o nó WebSphere Adapters está usando, e se os nomes do método nos adaptadores ou os nomes do tipo de mensagem nos conjuntos de mensagens estão se chocando.
Explicação: Os nomes de métodos devem ser exclusivos em todos os adaptadores primários e secundários, e o conjunto de mensagens que é criado não deve conter nenhum tipo que compartilha o mesmo nome e o namespace dos conjuntos de mensagens existentes. As informações sobre os adaptadores secundários e os conjuntos de mensagens são gravadas para rastreio do usuário nos seguintes estágios.
- Quando o nó é implementado primeiro, as informações sobre o conjunto atual de adaptadores secundários e os conjuntos de mensagens são relatados.
- Quando os adaptadores e conjuntos de mensagens são implementados de forma subsequente, as informações sobre eles são relatadas no momento da implementação.
- Quando o fluxo de mensagens, o nó de integração ou o servidor de integração for interrompido e, em seguida, reiniciado, as informações sobre o conjunto inteiro de adaptadores secundários e os conjuntos de mensagens são gravados para rastreio do usuário, incluindo esses adaptadores secundários e conjuntos de mensagens que são implementados após o fluxo de mensagens ter sido implementado pela primeira vez.
Essas informações são relatadas pelas seguintes mensagens.
- BIP3432 e BIP3434 listam os adaptadores e conjuntos de mensagens que estão disponíveis quando o nó é implementado ou quando o nó de integração, o servidor de integração ou o fluxo de mensagens são reiniciados.
- BIP3433 relata que um adaptador secundário está sendo implementado e incluído no conjunto.
- BIP3435 relata que um conjunto de mensagens secundárias está sendo implementado.
- BIP3436 identifica o conjunto de mensagens no qual cada tipo está sendo definido.
- BIP3437 identifica os conjuntos de mensagens que tentam redefinir um tipo que já está definido.
- BIP3438 identifica o adaptador no qual cada método está sendo definido.
- BIP3439 identifica os adaptadores que tentam redefinir um método que já está definido.
As mensagens BIP3436, BIP3437, BIP3438 e BIP3439 são emitidas quando uma mensagem é processada para relatar se as definições são usadas para essa mensagem.
Solução: As etapas a seguir descrevem como usar o rastreio do usuário ao trabalhar com adaptadores secundários.
- Quando você implementa o fluxo pela primeira vez
  1. Inicie o rastreio do usuário.
  2. Implemente seu fluxo de mensagens, o adaptador primário, o conjunto de mensagens primário e quaisquer adaptadores secundários ou conjuntos de mensagens que estejam prontos.
  3. Leia o rastreio do usuário, observando as mensagens descritas.
  4. Opcional: Reinicie o rastreio do usuário, pare e reinicie o fluxo de mensagens e, em seguida, leia o rastreio do usuário novamente, observando as mensagens descritas.
- Quando você inclui novos adaptadores e conjuntos de mensagens
  1. Inicie o rastreio do usuário.
  2. Implemente os adaptadores secundários e os conjuntos de mensagens.
  3. Leia o rastreio do usuário, observando as mensagens descritas.
  4. Opcional: Reinicie o rastreio do usuário, pare e reinicie o fluxo de mensagens e, em seguida, leia o rastreio do usuário novamente, observando as mensagens descritas.
Quando tiver identificado onde ocorreu o conflito de nomenclatura, você pode assegurar que os nomes sejam exclusivos editando-os das seguintes maneiras:
- Edite os nomes dos métodos clicando em Editar Operações no painel Geração de Serviço e Configuração de Implementação do assistente Conexão do adaptador.
- Edite os espaços de nomes dos tipos no conjunto de mensagens usando o controle de Espaço de Nomes do Objeto de Negócios no assistente Conexão do adaptador.

Falha na Implementação Quando Há Dependências de Projeto Circulares

Procedimento

Cenário: Dependências de projeto circulares existem nos projetos que você está implementando e a implementação falha.
Explicação: Uma dependência de projeto circular ocorre quando dois ou mais projetos dependem um do outro.
Por exemplo, o Arquivo A no Projeto X depende do Arquivo B no Projeto Y, e o Arquivo C no Projeto Y depende do Arquivo D no Projeto X. Para que o Projeto X seja compilado com sucesso, o Projeto Y deve ser compilado primeiro, para que o Projeto X possa resolver a dependência do Arquivo B. No entanto, para que o Projeto Y seja compilado com sucesso, o Projeto X deve ser compilado primeiro, para que o Projeto Y possa resolver a dependência do Arquivo D. O IBM App Connect Enterprise Toolkit é baseado na plataforma Eclipse, que não suporta dependências circulares entre projetos.
Solução: Para implementar com sucesso, evite dependências de projeto circulares.
Por exemplo, se o Projeto X depender do Arquivo B do Projeto Y e o Projeto Y depender do Arquivo D do Projeto X, mova o Arquivo B para o Projeto Z. Os projetos devem ser construídos na ordem, Projeto Z, Projeto X e então Projeto Y para que as dependências possam ser resolvidas.

Mensagens de Erro Emitidas durante a Implementação

Sobre esta tarefa

As mensagens de erro adicionais que podem ser geradas durante uma implementação são explicadas nesta seção.

Envie uma mensagem para BIP1106 com o código de motivo 2030 do serviço " IBM MQ "

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 nó de integração.
Solução: Aumente o comprimento máximo das mensagens na fila de transmissão usando o comando ` IBM MQalter qlocal `, em que o comprimento máximo das mensagens (maxmsgl) é expresso em bytes:
```
alter ql(transmit_queue_name) maxmsgl(104857600) 
```
Para obter mais informações sobre este comando, consulte a seção “Guia de Administração do Sistema” da documentação online do produto “ IBM MQ ”.

Mensagem BIP2066

Cenário: você iniciou uma solicitação de implementação; por exemplo, implementou um arquivo BAR em um servidor de integração. A mensagem de erro BIP2066 foi retornada uma ou mais vezes.
Explicação: O servidor de integração não respondeu dentro do período de tempo que é configurado pelo parâmetro node ConfigurationChangeTimeout de integração. Este parâmetro define o comprimento máximo de tempo em que um servidor de integração pode aplicar uma mudança de configuração. O valor padrão é 300 segundos.
Solução: Aumente os valores de tempo limite de configuração usando o comando mqsichangeproperties com o parâmetro -n defaultConfigurationTimeout (comando mqsichangeproperties.

Mensagem BIP2080

Cenário: O nó de integração iniciou um servidor de integração; por exemplo, se você emitiu mqsistart para o nó de integração, ou ocorreu um erro e o servidor de integração está sendo recuperado. a mensagem de erro BIP2080 foi exibida uma ou mais vezes.
Explicação: a solicitação de configuração interno não foi reconhecido pelo servidor de integração antes do valor do InternalConfigurationTimeout (padrão de 60 seconds segundos).
Solução: mude o valor de tempo limite de configuração usando o comando mqsichangeproperties com o parâmetro -n defaultConfigurationTimeout (comando mqsichangeproperties).

Mensagem BIP2241

Cenário: Mensagem de erro BIP2241 é exibida.
Explicação: Você está tentando implementar um fluxo de mensagens que contém um nó que não está disponível no nó de integração de destino.
Solução: Certifique-se de que a versão do Kit de Ferramentas do IBM App Connect Enterprise, na qual o fluxo de mensagens foi desenvolvido, corresponda à versão do nó de integração no qual o fluxo de mensagens está sendo implantado. Se o fluxo de mensagens estiver utilizando um nó definido pelo usuário ou um nó fornecido em um pacote de integração ( SupportPac, ), certifique-se de que a implementação do nó em tempo de execução tenha sido instalada corretamente no computador em que o nó de integração está sendo executado. Se o seu fluxo de mensagens incluir um nó definido pelo usuário, consulte Instalando arquivos de tempo de execução da extensão definida pelo usuário em um nó de integração Se o seu fluxo de mensagens incluir um nó fornecido em um pacote de software ( SupportPac, ), consulte as informações de instalação, se disponíveis, para o pacote de software ( SupportPac ).

Mensagem BIP2242

Cenário: A mensagem de erro BIP2242 é exibida.
Explicação: A solicitação de implementação (mudança de configuração) não foi aceita antes que o valor de tempo limite que foi configurado pelo parâmetro do nó de integração defaultConfigurationTimeout expirou. Esse valor de tempo limite de configuração deve ser longo o suficiente para que o fluxo de mensagens conclua o processamento de sua mensagem atual então aceite a solicitação de deploy. O valor padrão é 300 segundos.
Solução: Configure os valores de limite de configuração usando o comando mqsichangeproperties com o parâmetro -n defaultConfigurationTimeout (comando mqsichangeproperties).

Mensagem BIP3226

Cenário: A mensagem de erro BIP3226 é exibida; por exemplo:
```
(Semipersistent_Compute1.Main, 27.89) : Array index evaluated to '0' but must 
evaluate to a positive, nonzero integer value.
```
A primeira inserção em BIP3226 (neste exemplo, Semipersistent_Compute1.Main) identifica o nó e rotina nos quais a instrução ocorre. A segunda inserção (neste exemplo, 27.89) identifica a linha e coluna aproximadas do valor de índice mostrado na terceira inserção (neste exemplo, '0').
Explicação: A validade do uso de um índice de referência de campo de zero foi corrigida em WebSphere Message Broker Versão 7.0. Se você tiver instruções em seus módulos ESQL que incluam um índice de zero, será gerado o erro BIP3226E.
Por exemplo, seu módulo ESQL pode conter a seguinte instrução:
```
SET OutputRoot.XMLNSC.Top.A[0].B = 42;
```
Solução:
Você deve corrigir todas as instruções ESQL que usam um índice de zero para usar um índice de 1. As instruções podem usar uma variável assim como um valor literal para o índice; verificar para ambas as situações possíveis. Por exemplo, seu código alterado pode ler:
```
SET OutputRoot.XMLNSC.Top.A[1].B = 42;
```

Erro do Validador TDS (Tagged/Delimited String)

Cenário: Você tenta implementar um conjunto de mensagens com 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.

TDS Extractor Trace File
========================

Beginning Extract..

Extracting Identification Info
Extracting Project Info
Extracting Messages
Extracting Elements
Extracting Compound Types
Extracting Type Members
Extracting Type Members
Extracting Type Members
Extracting Type Members
Extracting Type Members
Beginning Indexing..

Creating Member IDs to Tags Index Table.

Beginning Validation..

Validating Project
Validating Types
ERROR: TDSValidator::ValidateTypeMemberSimpleElement:
  Simple elements in a type with Data Element Separation attribute = Tagged 
  Delimited must have the following attribute set:
  Element Level - Tag
(Element ID: Town)
(Type ID: AddressType)
Return Code: -80

Validating Messages

Trace Info
===========
EXCEPTION: TDSValidator::Validate:
  TDS Validation failed.
    1 errors
    0 warnings
Return Code: -1

Solução:Use as informações no log de erros para corrigir o problema.