Depuración de EmailPlus

Acerca de esta tarea

Siga estos pasos para habilitar la función de depuración de EmailPlus:

Procedimiento

  1. Defina una variable de entorno del sistema denominada EMP_DEBUGOUT_LEVEL. Establezca el valor de la variable EMP_DEBUGOUT_LEVEL en uno de estos valores:
    Opción Descripción
    1 Lista todas las llamadas a funciones de EmailPlus y los parámetros pasados a las funciones
    2 Lista todas las llamadas a funciones de EmailPlus, los parámetros pasados a las funciones y los valores de retorno
    3 Depuración completa, que puede generar un gran volumen de salida
  2. Si está realizando la depuración en sistemas Linux o UNIX, debe establecer el valor de la variable EMP_DEBUGOUT_FILE en el nombre de un archivo en el que IBM® Rational ClearQuest pueda grabar. No incluya espacios en la vía de acceso completa del nombre del archivo de depuración. Por ejemplo, cree un nombre de archivo similar a esta línea: EMP_DEBUGOUT_FILE=/tmp/EmailPlusDebug.log.

Qué hacer a continuación

Para ver la salida de depuración en Microsoft Windows, ejecute el depurador de Windows (dbwin32.exe). Los datos de salida de depuración generados por EmailPlus tienen este prefijo:

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

Por ejemplo, cuando el valor de la variable EMP_DEBUGOUT_LEVEL es 2, podría generarse la salida siguiente:
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>
Para ver la salida de depuración en sistemas Linux o UNIX, vea el contenido del archivo que ha definido en la variable EMP_DEBUGOUT_FILE. Cuando habilita la depuración de EmailPlus, el rendimiento de ClearQuest se ve afectado. Habilite la depuración sólo cuando sea necesario, y, a continuación, inhabilítela cuando la depuración haya finalizado. Debe definir o modificar la variable EMP_DEBUGOUT_FILE antes de iniciar el cliente ClearQuest. Los cambios que realice en la variable EMP_DEBUGOUT_FILE mientras el cliente ClearQuest se esté ejecutando no se reconocen hasta que se reinicia el cliente ClearQuest.

Comentarios