调试 EmailPlus

关于此任务

请遵循以下步骤以启用 EmailPlus 调试功能:

过程

  1. 定义一个名为 EMP_DEBUGOUT_LEVEL 的系统环境变量。 将 EMP_DEBUGOUT_LEVEL 变量的值设置为以下其中一个值:
    选项 描述
    1 列出所有 EmailPlus 函数调用以及传递给函数的参数
    2 列出所有 EmailPlus 函数调用、传递给函数的参数和返回值
    3 完全调试,可能生成大量输出
  2. 如果您在 Linux 或 UNIX 系统上进行调试,那么必须将 EMP_DEBUGOUT_FILE 变量的值设置为 IBM® Rational® ClearQuest® 可以写入到的文件的名称。请勿在调试文件名的完整路径中包含空格。例如,创建一个与下面一行类似的文件名:EMP_DEBUGOUT_FILE=/tmp/EmailPlusDebug.log

下一步做什么

要在 Microsoft Windows 上查看调试输出,请运行 Windows Debugger (dbwin32.exe)。EmailPlus 生成的调试输出具有以下前缀:

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

例如,如果 EMP_DEBUGOUT_LEVEL 变量值为 2,那么可能生成以下输出:
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>
要在 Linux 或 UNIX 系统上查看调试输出,请查看您在 EMP_DEBUGOUT_FILE 变量中定义的文件的内容。 在您启用 EmailPlus 调试后,ClearQuest 性能将受到影响。仅当需要时才应启用调试,并且在调试完成后将其禁用。在启动 ClearQuest 客户机之前,您必须定义或修改 EMP_DEBUGOUT_FILE 变量。 对于在 ClearQuest 客户机正在运行时您对 EMP_DEBUGOUT_FILE 变量进行的更改,只有在 ClearQuest 客户机重新启动之后才会被识别。

Feedback