除錯 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 偵錯工具」(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 用戶端後才可辨識那些變更。

意見