Traçage

Le traçage est une fonction de débogage facultative que vous pouvez activer pour suivre de près le comportement d'un connecteur. Par défaut, les messages de trace sont consignés dans STDOUT. Pour plus d'informations sur la configuration des messages de trace, voir les propriétés de configuration du connecteur dans Configuration du connecteur. Pour plus d'informations sur le traçage, en particulier savoir comment l'activer et le paramétrer, voir Connector Development Guide.

Le tableau 10 dresse la liste du contenu recommandé pour les niveaux de message de traçage du connecteur.

Tableau 10. Contenu des messages de trace
Niveau Description
Niveau 0 Utilisez ce niveau pour les messages de trace qui identifient la version du connecteur. Aucun autre traçage n'est réalisé à ce niveau.
Niveau 1 Utilisez ce niveau pour les messages de trace qui :
  • Fournissent des informations sur le statut.
  • Fournissent des informations clés sur chaque objet métier traité.
  • Enregistrent à chaque fois qu'une unité d'exécution d'interrogation détecte un nouveau message dans une file d'attente d'entrée.
Niveau 2 Utilisez ce niveau pour les messages de trace qui :
  • Identifient le gestionnaire de BO utilisé pour chaque objet traité par le connecteur.
  • Signalent chaque fois qu'un objet métier est transmis au courtier d'intégration.
  • Signalent chaque fois qu'un objet métier de requête est reçu.
Niveau 3 Utilisez ce niveau pour les messages de trace qui :
  • Identifient les clés étrangères traitées, le cas échéant. Ces messages s'affichent quand le connecteur a rencontré une clé étrangère dans un objet métier ou quand il en définit une dans un objet métier.
  • Concernent le traitement d'un objet métier. C'est par exemple le cas lors de la détection d'une correspondance entre objets métier, ou d'un objet métier dans un tableau d'objets métier enfants.
Niveau 4 Utilisez ce niveau pour les messages de trace qui :
  • Identifient les informations spécifiques à l'application. C'est le cas lorsque des valeurs sont retournées par les méthodes qui traitent les zones d'information spécifiques à l'application dans les objets métier.
  • Identifient lorsque le connecteur entre ou quitte une fonction. Ces messages aident à procéder au traçage du flot de processus du connecteur.
  • Enregistrent tout traitement spécifique à l'unité d'exécution. Par exemple, si le connecteur engendre plusieurs unités d'exécution, un message signale la création de chacune.
Niveau 5 Utilisez ce niveau pour les messages de trace qui :
  • Indiquent l'initialisation du connecteur. Ce type de message peut inclure par exemple la valeur de chaque propriété de configurateur de connecteur, extraite du courtier.
  • Détaillent l'état de chaque unité d'exécution que le connecteur engendre pendant son exécution.
  • Représentent des instructions exécutées dans l'application. Le fichier de consignation du connecteur contient toutes les instructions exécutées dans l'application cible ainsi que la valeur des variables qui sont remplacées.
  • Enregistrent les suppressions d'objets métier. Le connecteur sort une représentation textuelle d'un objet métier avant le début du traitement (indiquant l'objet que le connecteur reçoit de la collaboration), et après la fin du traitement de l'objet (indiquant l'objet retourné par le connecteur à la collaboration).

Copyright IBM Corp. 2003, 2005