A seguinte seção contém informações de resolução de problemas ao utilizar o serviço de sistema de mensagens da Web.
O serviço de sistema de mensagens da Web deve ser instalado e ativado antes de um aplicativo ativado pelo sistema de mensagens da Web ser instalado. Se você instalar um aplicativo ativado pelo sistema de mensagens da Web sem o tempo de execução instalado e ativado, a seguinte mensagem de erro será exibida, junto com um erro 503 de servlet, ao tentar acessar uma URI de sistema de mensagens da Web:
CWPSB1701E: O serviço do sistema de mensagens da Web não está configurado para o seguinte URI de entrada: /uri
Quando você encontrar essa mensagem, deverá primeiro verificar se o serviço de sistema de mensagens da Web está instalado e ativado. Consulte Ativar o Serviço de Sistema de Mensagens da Web para obter detalhes adicionais. A instalação bem-sucedida e a ativação do serviço de sistema de mensagens da Web exibem as seguintes mensagens de log no início do servidor:
CWPSB1102I: O serviço do sistema de mensagens da Web foi iniciado.
Se você ainda encontrar um erro de configuração após o serviço de sistema de mensagens da Web ser instalado e ativado, verifique o seguinte:
O serviço de sistema de mensagens da Web utiliza o protocolo Bayeux. Para a maioria dos campos de mensagens de protocolo Bayeux, há um campo booleano com êxito em um campo de erro associado. Se uma operação do Bayeux for malsucedida, o serviço de sistema de mensagens da Web tentará enviar informações de erro para ajudar desenvolvedores de aplicativos e usuários finais na determinação da causa da falha da operação. O formato de cadeia de erro do Bayeux contém 3 argumentos separados por dois pontos. O primeiro argumento é um código de erro para fins de facilitar a comparação. O segundo argumento é uma lista separada por vírgula de argumentos envolvidos na falha. O último argumento é uma descrição resumida da mensagem de erro. As mensagens de erro de exemplo são da seguinte maneira:
A tabela a seguir lista a maioria das mensagens de erro que o serviço do sistema de mensagens da Web envia aos clientes Bayeux quando uma operação falha.
Consulte essa tabela ao depurar falhas do cliente.
Em muitos casos, verifique os logs do servidor para obter informações adicionais ao encontrar esses erros dos clientes.
Código de Erro | Descrição Resumida | Argumentos | Descrição |
---|---|---|---|
300 | Incompatibilidade de Número de Versão | Versões mínima e máxima transmitidas ao servidor. | Não foi possível ao servidor localizar uma correspondência de versão para os campos de versão fornecida do cliente e versão mínima. Na maioria dos casos, o servidor solicitará que o cliente tente novamente estabelecer a comunicação com um número de versão conforme fornecido pelo servidor nos campos de versão e versão mínima. |
301 | Incompatibilidade do Tipo de Conexão | Os tipos de conexão fornecidos pelo cliente. | O cliente tentou fazer o protocolo de reconhecimento ou conectar-se com um tipo de conexão não suportado pelo servidor. A resposta do protocolo de reconhecimento conterá uma lista de tipos de conexão suportados. Se essa mensagem de erro for recebida durante um pedido de protocolo de reconhecimento, o cliente deverá tentar reconectar-se com um valor válido a partir da lista de tipos de conexão suportados. Se esse erro for fornecido em resposta a um pedido de conexão, o servidor direcionará o cliente para um novo protocolo de reconhecimento e concordância com um tipo de conexão comum. |
302 | Incompatibilidade da Extensão | A extensão fornecida. | O protocolo Bayeux fornece um mecanismo de extensão para ativar a função acima do que o protocolo Bayeux suporta. Em alguns casos, pode ser fornecida uma extensão inválida. Nesse release, o servidor irá ignorar qualquer extensão desconhecida. |
400 | O pedido não pôde ser reconhecido pelo servidor. | nenhum | O cliente enviou um pedido que não foi reconhecido pelo servidor. Essa mensagem de erro pode ser recebida pelos seguintes motivos:
|
401 | O ID do cliente especificado é desconhecido. | O ID do cliente que é especificado. | Essa mensagem é fornecida quando um servidor não reconhece o ID do cliente. Na maioria dos casos, essa mensagem de erro será fornecida com o mecanismo de aviso do Bayeux instruindo o cliente para fazer novamente o protocolo de reconhecimento e a assinatura para qualquer tópico anterior assinado. Esse erro ocorre com mais frequência quando:
|
402 | Está faltando um parâmetro necessário no pedido. | O parâmetro ausente. | O protocolo Bayeux solicita campos necessários para várias mensagens de Bayeux. Se um campo necessário estiver ausente, uma mensagem de erro será emitida, indicando que o campo está ausente. |
403 | O canal especificado é proibido. | O canal que é proibido. | Se o cliente tentou assinar ou publicar um canal sem as permissões de autorização apropriadas, esse erro será enviado de volta ao cliente. |
404 | O canal especificado é desconhecido. | O canal desconhecido. | O cliente tentou assinar, cancelar a assinatura ou publicar um canal que é desconhecido. Esse erro é emitido muitas vezes quando o formato de canal multipleDestination especificado e o primeiro argumento não correspondem com um espaço de tópico ou alias de espaço de tópico de barramento de integração de serviços existente. |
405 | A sintaxe do canal especificada é inválida. | Formato de canal inválido. | Essa mensagem é fornecida quando um formato de canal inválido é especificado. Consulte o protocolo Bayeux para obter informações sobre formatos de canal do Bayeux válidos. |
406 | O campo de extensão especificado é inválido. | O campo de extensão inválido. | Essa mensagem é fornecida quando um campo de extensão inválido é especificado. A implementação do serviço de sistema de mensagens da Web ignora os campos de extensão fornecidos que não reconheceu, de modo que essa mensagem de erro não deve ser vista pelos clientes. |
407 | O pedido de publicação falhou. | O canal em que o pedido de publicação foi emitido. | Essas mensagens de erro indicam que o pedido de publicação falhou. Na maioria dos casos, isso indica que a opção clientCanPublish foi configurada como falsa. |
408 | O cliente não tem autorização para se conectar para receber ou publicar mensagens. | nenhum | Essa mensagem de erro é fornecida durante um protocolo de reconhecimento ou pedido de conexão. Na maioria dos casos, essa mensagem de erro indica um problema ao configurar a segurança do barramento de integração de serviços, em particular na concessão da função do conector de barramento para esse usuário de entrada. |
500 | O servidor encontrou um erro interno e não pôde concluir o pedido. | nenhum | Foi encontrado um erro interno do servidor. Verifique os logs do servidor para obter informações adicionais. |
503 | Serviço indisponível. | nenhum | Um erro de comunicação com um barramento de integração de serviços foi encontrado. Isto geralmente ocorre quando existe uma falha de comunicação com um mecanismo do sistema de mensagens, como, por exemplo, o mecanismo do sistema de mensagens em processo de parada. Verifique os logs do servidor para obter informações adicionais. |