First Failure Data Capture (FFDC) 記錄提供的資訊有助於診斷您可能遇到的 XMS 問題。如果需要額外的資訊以協助找出錯誤原因, 您的 IBM 業務代表可能要求您產生一份追蹤。
XMS 會將 FFDC 記錄與追蹤檔建立在現行工作目錄中, 除非您按照下列所述配置 XMS 環境變數以指定不同的位置。FFDC 記錄會以開頭為 xmsffdc 字首的名稱, 儲存在人可辨讀的文字檔中。追蹤檔為二進位, 並可設定格式。追蹤檔名稱的開頭為 xms 字首。
若要配置 XMS C 或 C++ 應用程式的追蹤,請在執行應用程式前先設定如下的 XMS 環境變數:
環境變數 | 預設值 | 設定 | 意義 |
---|---|---|---|
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 會以二進位格式將追蹤輸出至一或多個副檔名為 .trc 的追蹤檔中。您可以按照下列範例所示, 使用執行檔 gxitrcfmt 來設定追蹤檔的格式:
gxitrcfmt xms01234.trc
格式化後的檔案的字尾為 txt,例如:
cat xms01234.trc.txt
追蹤中的每一行都含有:
追蹤記錄為一個函數進入點(以 '{' 表示)、函數跳出點(以 '}' 表示)或函數資料點。