Gestion et consignation des erreurs

Le connecteur enregistre un message d'erreur chaque fois qu'il rencontre une condition qui entraîne l'échec du traitement d'un objet métier et d'une instruction. Lorsqu'une erreur survient, le connecteur imprime également une représentation textuelle de l'objet métier qui a échoué tel qu'il a été reçu. Il enregistre le texte dans le fichier journal du connecteur ou le flot de sortie standard, selon sa configuration. Vous pouvez utiliser le texte pour vous aider à identifier la source de l'erreur.

Types d'erreur

Le Tableau 16 présente les types de message de suivi que le connecteur produit à chaque niveau de trace. Ces messages viennent compléter les messages de suivi générés par l'architecture d'IBM WebSphere Business Integration Adapter, comme l'encapsuleur d'exécution de connecteur Java et l'interface de messages de WebSphere MQ.

Tableau 16. Messages de suivi de Connector
Niveau de trace Messages de suivi
Niveau 0 Message qui identifie la version du connecteur. Aucun autre suivi n'est réalisé à ce niveau. Il s'agit de la valeur par défaut.
Niveau 1
  • Messages d'état
  • Messages qui contiennent des informations d'identification (clé) pour chaque objet métier traité
  • Messages transmis chaque fois que la méthode pollForEvents est exécutée

Niveau 2
  • Messages du gestionnaire d'objets métier qui contiennent des informations comme les tableaux et les objets métier enfant que le connecteur rencontre ou extrait pendant le traitement d'un objet métier
  • Messages journalisés chaque fois qu'un objet métier est transmis au courtier d'intégration, depuis la méthode gotApplEvent() ou executeCollaboration()
  • Messages qui indiquent qu'un objet métier a été reçu en tant que requête du courtier d'intégration

Niveau 3
  • Messages de traitement d'une clé étrangère qui contiennent des informations telles que l'heure à laquelle le connecteur a détecté ou défini une clé étrangère dans un objet métier
  • Messages qui contiennent des informations sur le traitement de l'objet métier. Par exemple, ces messages sont transmis lorsque le connecteur détecte une correspondance entre des objets métier, ou qu'il identifie un objet métier dans un tableau d'objets métier enfant

Niveau 4
  • Messages d'informations spécifiques à l'application, par exemple, des messages indiquant les valeurs renvoyées par les fonctions qui analysent les zones d'informations spécifiques à l'application de l'objet métier
  • Messages qui identifient lorsque le connecteur accède ou quitte une fonction, ce qui permet de suivre le flot de traitement du connecteur
  • Tous les messages spécifiques aux unités d'exécution. Si le connecteur engendre plusieurs unités d'exécution, un message signale la création de chaque nouvelle unité d'exécution

Niveau 5
  • Messages qui indiquent l'initialisation du connecteur, par exemple, des messages indiquant la valeur de chaque propriété de configuration extraite du courtier d'intégration
  • Messages qui contiennent des instructions exécutées dans l'application. A ce niveau de trace, le fichier journal du connecteur contient toutes les instructions exécutées dans l'application cible ainsi que la valeur des variables qui sont remplacées.
  • Messages qui comprennent la représentation d'un objet métier avant son traitement (en affichant son état tel que le connecteur le reçoit) et après son traitement (en affichant son état tel que le connecteur le renvoie)
  • Messages qui contiennent un cliché de l'objet métier
  • Messages qui indiquent l'état de chaque unité d'exécution que le connecteur engendre pendant son exécution

Messages d'erreur

Fichier de messages du connecteur

Tous les messages d'erreur générés par le connecteur sont stockés dans un fichier de messages nommé JDBCConnector.txt ou JDBCConnector_II_TT.txt (où ll correspond à une langue et TT à un pays ou territoire). Chaque erreur est associée à un numéro d'erreur suivi du message d'erreur. Par exemple :

20017
 Connector Infrastructure version does not match.
 

20018
 Connection from {1} to the Application is lost! Please enter 'q' 
 to stop the connector, then restart it after the problem is fixed.
 

20019
 Error: ev_id is NULL in pollForEvent().
 

Copyright IBM Corp. 1997, 2004