Messages de 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. Les messages de traçage sont configurables et peuvent être modifiés de manière dynamique. Vous pouvez définir divers niveaux en fonction du niveau de détail souhaité. Par défaut, les messages de trace sont consignés dans STDOUT.

Vous pouvez également configurer le traçage de sorte qu'il soit consigné dans un fichier. Le tableau suivant décrit les types de messages de trace émis par le connecteur iSeries pour chaque niveau de trace. Tous les messages de trace apparaissent dans le fichier spécifié par la propriété TraceFileName du connecteur. Ces messages viennent compléter les messages de traçage générés par l'architecture IBM WebSphere Business Integration Adapter. 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 pour savoir comment l'activer et le paramétrer, voir Connector Development Guide.

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

Tableau 8. Description du niveau de contenu des messages de trace
Niveau de trace Messages de traçage
Niveau 0 Utilisez ce niveau de trace pour les messages de trace qui identifient la version du connecteur. Aucun autre traçage n'est réalisé à ce niveau.
Niveau 1 Non applicable
Niveau 2 Utilisez ce niveau de trace 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 Non applicable
Niveau 4 Utilisez ce niveau de trace 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 de trace 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