Débogage d'EmailPlus

Pourquoi et quand exécuter cette tâche

Procédez comme suit pour activer les fonctions de débogage d'EmailPlus :

Procédure

  1. Définissez une variable d'environnement système nommée EMP_DEBUGOUT_LEVEL. Définissez la valeur de la variable EMP_DEBUGOUT_LEVEL sur l'une des valeurs suivantes :
    Option Description
    1 Répertorier tous les appels de fonction EmailPlus et les paramètres transférés aux fonctions
    2 Répertorie tous les appels de fonction, les paramètres transférés aux fonctions et les valeurs de retour
    3 Débogage complet, qui peut générer de nombreuses sorties
  2. Si vous déboguez sur les systèmes Linux ou UNIX, définissez la valeur de la variable EMP_DEBUGOUT_FILE sur le nom d'un fichier dans lequel IBM® Rational ClearQuest peut écrire. N'insérez pas d'espace dans le chemin d'accès complet du nom du fichier de débogage. Par exemple, créez un nom de fichier semblable à cette ligne :EMP_DEBUGOUT_FILE=/tmp/EmailPlusDebug.log.

Que faire ensuite

Pour afficher la sortie de débogage sur Microsoft Windows, exécutez le débogueur Windows (dbwin32.exe). La sortie de débogage générée par EmailPlus a le préfixe suivant :

#EMP_DEBUGOUT# <DATE> : <FUNCTION NAME> : <DEBUG MESSAGE>

Par exemple, lorsque la valeur de la variable EMP_DEBUGOUT_LEVEL est 2, la sortie suivante peut être générée :
3712: #EMP_DEBUGOUT# 2009-10-23 11:45:21 :EMP_isEmailPlusActive: START
3712: #EMP_DEBUGOUT# 2009-10-23 11:45:21 :EMP_CacheConfig: START - Cache EmailPlusConfig
3712: #EMP_DEBUGOUT# 2009-10-23 11:45:21 :EMP_CacheConfig: END
3712: #EMP_DEBUGOUT# 2009-10-23 11:45:21 :EMP_isEmailPlusActive: EMP::ConfigCache::isEmailPlusActive = <YES>
3712: #EMP_DEBUGOUT# 2009-10-23 11:45:21 :EMP_isEmailPlusActive: END  - isEmailPlusActive=<1>
Pour afficher la sortie de débogage sous les systèmes Linux ou UNIX, affichez le contenu du fichier que vous avez défini dans la variable EMP_DEBUGOUT_FILE. Lorsque vous activez le débogage d'EmailPlus, les performances de ClearQuest sont affectées. Activez uniquement le débogage lorsque vous en avez besoin, puis désactivez-le lorsque le débogage est terminé. Vous devez définir ou modifier la variable EMP_DEBUGOUT_FILE avant de démarrer le client ClearQuest. Les changements que vous apportez à la variable EMP_DEBUGOUT_FILE pendant l'exécution du client ClearQuest ne sont pas reconnu jusqu'au redémarrage du client ClearQuest.

Commentaires