La section suivante contient des informations concernant l'identification et la résolution des incidents rencontrés lors de l'utilisation du service de messagerie Web.
L'environnement d'exécution du service de messagerie Web doit être installé et activé avant qu'une application compatible avec une messagerie Web soit installée. Si vous installez une application compatible avec une messagerie Web sans avoir installé ni activé l'environnement d'exécution, le message d'erreur suivant s'affiche avec une erreur de servlet 503 lorsque vous essayez d'accéder à l'URI d'une messagerie Web :
CWPSB1701E : Le service de messagerie Web n'est pas configuré pour l'URI entrant suivant : /uri
Lorsque vous rencontrez ce message, vous devez d'abord vérifier si le service de messagerie Web est installé et activé. Pour obtenir plus de détails, reportez-vous à la section Activation du service de messagerie Web. Si l'installation et l'activation du service de messagerie Web se sont déroulées normalement, les messages de journal suivants s'affichent au démarrage du serveur :
CWPSB1102I : Le service de messagerie Web est activé.
Si vous rencontrez une erreur de configuration même après avoir installé et activé le service de messagerie Web, vérifiez les points suivants :
Le service de messagerie Web utilise le protocole Bayeux. La plupart des zones de message du protocole Bayeux présentent une zone booléenne correcte et une zone d'erreur correspondante. Si une opération effectuée à l'aide du protocole Bayeux n'a pas abouti, le service de messagerie Web tente d'envoyer des informations sur l'erreur qui s'est produite, afin d'aider les développeurs d'application ainsi que les utilisateurs finaux à déterminer l'origine de l'échec. Le format de la chaîne de l'erreur figurant sur le protocole Bayeux comporte 3 arguments séparés par des deux-points. Le premier argument correspond à un code d'erreur permettant d'effectuer de simples comparaisons. Le deuxième argument correspond à une liste séparée par des virgules, contenant des arguments à l'origine de l'échec. Le dernier argument correspond à une brève description du message d'erreur. Voici des exemples de message d'erreur :
Le tableau suivant répertorie la plupart des messages que le service de messagerie Web envoie aux clients utilisant le protocole Bayeux, lorsqu'une opération échoue.
Référez-vous à ce tableau pour déboguer les échecs rencontrés côté client.
Si vous rencontrez ces types d'erreur côté client, consultez les journaux du serveur pour obtenir des informations supplémentaires.
Code d'erreur | Description simple | Arguments | Description |
---|---|---|---|
300 | Le numéro de la version n'est pas approprié. | Les versions minimale et maximale sont transmises au serveur | Le serveur a été incapable de trouver une version appropriée à la zone correspondant à la version fournie par le client et à celle de la version minimale. Dans la plupart des cas, le serveur invite le client à établir une nouvelle connexion via un numéro de version fourni par le serveur dans les zones : version et minimumVersion. |
301 | Le type de connexion n'est pas approprié. | Les types de connexion fournis par le client | Le client a essayé d'établir une connexion avec un type de connexion qui n'est pas pris en charge par le serveur. La réponse relative à l'établissement de la connexion comprend la liste des types de connexion pris en charge. Si ce message d'erreur s'affiche lors d'une demande d'établissement de connexion, le client doit essayer de se reconnecter à l'aide d'une valeur valide figurant dans la liste des types de connexion pris en charge. Si ce message d'erreur est généré à la suite d'une demande de connexion, le serveur invite le client à établir une nouvelle connexion et à trouver un type de connexion commun. |
302 | L'extension n'est pas appropriée. | L'extension fournie | Le protocole Bayeux fournit un mécanisme d'extension qui permet d'utiliser une fonction au-dessus de ce qu'il peut prendre en charge. Dans certains cas, une extension fournie peut être non valide. Dans cette version, le serveur ignore toute extension inconnue. |
400 | La demande n'est pas reconnue par le serveur | aucun | La demande envoyée par le client n'est pas reconnue par le serveur. Vous recevez ce message d'erreur pour les raisons suivantes :
|
401 | L'ID client fourni est inconnu. | L'ID client fourni | Ce message s'affiche lorsqu'un serveur ne reconnaît pas l'ID client fourni. Dans la plupart des cas, ce message d'erreur s'affiche avec le mécanisme de suggestion Bayeux qui invite le client à établir une nouvelle connexion et à effectuer une inscription dans toute rubrique dans laquelle des inscriptions ont été effectuées auparavant. Cette erreur se produit le plus souvent dans l'un des cas suivants :
|
402 | Un paramètre requis ne figure pas dans la demande | Le paramètre manquant | Le protocole Bayeux exige les zones requises dans plusieurs messages Bayeux. Si une zone requise est manquante, un message d'erreur indiquant la zone manquante est généré. |
403 | Le canal indiqué est non autorisé. | Le canal non autorisé | Si un client a essayé d'effectuer une inscription ou une publication dans un canal sans l'autorisation requise, ce message d'erreur est renvoyé au client. |
404 | Le canal indiqué est inconnu | Le canal inconnu | Le client a essayé d'effectuer une inscription, une désinscription ou une publication dans un canal inconnu. Cette erreur est souvent générée lorsque le format du canal multipleDestination est indiqué et que le premier argument ne correspond pas à l'espace de rubrique du bus d'intégration de service ou à l'alias de l'espace de la rubrique. |
405 | La syntaxe du canal indiqué n'est pas valide | Le format du canal non valide | Ce message est émis lorsqu'un format de canal non valide est indiqué. Reportez-vous à la section relative au protocole Bayeux pour obtenir des informations sur les formats de canal Bayeux valides. |
406 | La zone d'extension indiquée n'est pas valide | La zone d'extension non valide | Ce message est émis lorsqu'une zone d'extension non valide est fournie. L'implémentation du service de messagerie Web ignore les zones d'extension qu'elle ne reconnaît pas ; ce message d'erreur ne doit donc pas être visible côté client. |
407 | La demande de publication n'a pas abouti. | Le canal sur lequel la demande de publication a été créée | Ce message d'erreur indique l'échec de la demande de publication. Dans la plupart des cas, ce message indique que l'option clientCanPublish est définie sur false. |
408 | Le client n'est pas autorisé à établir une connexion pour une réception ou une publication de messages. | aucun | Ce message d'erreur est généré lors de l'établissement d'une connexion ou lors d'une demande de connexion. Dans la plupart des cas, ce message d'erreur indique un problème lié à la configuration de la sécurité du bus d'intégration de services, en particulier en attribuant le rôle du connecteur de bus à cet utilisateur entrant. |
500 | Le serveur a rencontré une erreur interne et a été incapable d'effectuer la demande. | aucun | Une erreur interne s'est produite au sein du serveur. Pour plus d'informations, consultez les journaux du serveur. |
503 | Service indisponible. | aucun | Une erreur de communication avec un bus d'intégration de services a été rencontrée. Cela se produit classiquement en cas de défaillance de la communication avec un moteur de messagerie, par exemple, lorsque ce dernier s'arrête. Pour plus d'informations, consultez les journaux du serveur. |