WebSphere Message Service Clients for C/C++ and .NET, Version 1.2 作業系統: Linux, Windows

針對 C/C++ 應用程式使用 FFDC 和追蹤

First Failure Data Capture (FFDC) 記錄提供的資訊有助於診斷您可能遇到的 XMS 問題。如果需要額外的資訊以協助找出錯誤原因, 您的 IBM 業務代表可能要求您產生一份追蹤。

XMS 會將 FFDC 記錄與追蹤檔建立在現行工作目錄中, 除非您按照下列所述配置 XMS 環境變數以指定不同的位置。FFDC 記錄會以開頭為 xmsffdc 字首的名稱, 儲存在人可辨讀的文字檔中。追蹤檔為二進位, 並可設定格式。追蹤檔名稱的開頭為 xms 字首。

執行應用程式前先配置追蹤

若要配置 XMS C 或 C++ 應用程式的追蹤,請在執行應用程式前先設定如下的 XMS 環境變數:

表 1. C/C++ 追蹤的環境變數設定
環境變數 預設值 設定 意義
XMS_TRACE_ON 不適用 normal 追蹤所選的元件。
    full 追蹤所有的元件。
    partial 追蹤以逗點隔開的元件 ID 清單。例如 "partial,osa,cal" 則只會追蹤 XMS 元件 gxiosa 和 gxical。請使用完整追蹤以顯示可追蹤的元件。
XMS_TRACE_FILE_PATH 現行工作目錄 /dirpath/ 要寫入追蹤和 FFDC 記錄的目錄路徑。

XMS 會將 FFDC 與追蹤檔建立在現行工作目錄中, 除非您指定了不同的位置,亦即, 將 XMS_TRACE_FILE_PATH 設為您要讓 XMS 建立 FFDC 和追蹤檔之所在目錄的完整路徑名稱。您必須設定此環境變數, 才能啟動您要追蹤的應用程式,且您必須確定執行應用程式時所用的使用者 ID 有權寫入 XMS 建立 FFDC 和追蹤檔所在的目錄。

XMS_TRACE_FILE_SIZE 200000 整數 XMS 產品追蹤所能成長的大小上限 (KB),亦即,10 代表 10,000 個位元組。
XMS_TRACE_FILE_NUMBER 4 整數 可用來儲存追蹤記錄的檔案數。(200000 / 4 = 每個檔案為 50000 個位元組。)

動態配置追蹤

若要動態配置追蹤,請使用執行檔 gxisc。您可以使用 gxisc 在執行中的 XMS C 或 C++ 應用程式中啟用和停用追蹤, 以及修改追蹤大小。您必須在和 XMS 應用程式相同的機器上執行 gxisc。

若要呼叫 gxisc, 請按照下列範例所示,使用您想改變其追蹤配置之 XMS 應用程式的程序 ID。

gxisc 1234                              <enter>
display all                             <enter>
alter trace(enabled) tracesize(100)     <enter>
help                                    <enter>
alter trace(disabled)                   <enter>
alter                                   <enter>
end

gxisc                                   <enter>
alter pid(1234) trace(enabled)          <enter>
end

cat a.file                              <enter>

        alter pid(1234) trace(enabled)
        end

cat a.file | gxisc                      <enter>


cat b.file                              <enter>

        alter trace(disabled) tracesize(1000)
        end

cat b.file | gxisc 1234                 <enter>

註:XMS C 或 C++ 應用程式終止後,即不再保留追蹤設定。

設定追蹤檔的格式

為了在執行時期將處理程序和磁碟的額外負荷減至最少, XMS 會以二進位格式將追蹤輸出至一或多個副檔名為 .trc 的追蹤檔中。您可以按照下列範例所示, 使用執行檔 gxitrcfmt 來設定追蹤檔的格式:

gxitrcfmt xms01234.trc

格式化後的檔案的字尾為 txt,例如:

cat xms01234.trc.txt

追蹤中的每一行都含有:

追蹤記錄為一個函數進入點(以 '{' 表示)、函數跳出點(以 '}' 表示)或函數資料點。


Concept topic

使用條款 | 評比此網頁

時間戳記前次更新: 25 Apr 2006
(C) Copyright IBM Corporation 2005. All Rights Reserved.
本資訊中心採用 Eclipse 技術。(http://www.eclipse.org)