(C) IBM Corp. 1996, 2000
DB2 Text Extender
此指令可將處理程序資訊寫入共用記憶體中的追蹤緩衝區。 本資訊可用來追蹤錯誤。 您可使用二進位,從該追蹤緩衝區將此資訊寫入檔案中,以在之後關掉追蹤時,
供格式化使用;或者可以在追蹤開著時,將此資訊格式化,並寫入檔案。
Authorization
(僅限 UNIX) SYSADM、DBADM
Command syntax
>>-txtrace--| 參數 |-------------------------------------------><
參數
|---+-on--+--------------+--------------------------------------------+->
| '-| options |--' |
+-dump--| dump-file |---------------------------------------------+
+-off-------------------------------------------------------------+
+-format--+--------------+---+->-------------+---| format-file |--+
| '-| options |--' '-| dump-file |-' |
+-change----------------------------------------------------------+
+-clear-----------------------------------------------------------+
+-flow------------------------------------------------------------+
'-information-----------------------------------------------------'
>---------------------------------------------------------------|
選項
.-------------------------------------------------------------.
V |
|-----+- -m--products--.--events--.--components--.--functions--+--+->
+- -rc--return-code--------------------------------------+
+- -e--max-system-errors---------------------------------+
+- -r--max-record-size-----------------------------------+
'- -i--initial-buffer-size--|-- -l--last-buffer-size-----'
>---------------------------------------------------------------|
dump-file
|---+-------+---dump-filename-----------------------------------|
'-path--'
format-file
|---+-------+---format-filename---------------------------------|
'-path--'
Command parameters
註: |
所有的 TXTRACE 參數都具有一個 -u 選項,
可用來顯示參數的相關資訊。
|
- on
- 可啟動追蹤機能。
- dump | dmp
- 可將追蹤資訊以二進位寫入檔案。
- off
- 可停止追蹤機能。
- format | fmt
- 可將二進位追蹤資訊格式化。在追蹤作業關閉時,
指定傾出檔案的名稱及要用來保留已格式化之追蹤資訊的檔案名稱,
以將傾出檔案格式化。若要在追蹤作業仍作用時,直接從追蹤緩衝區將追蹤資訊格式化,
請輸入:destrc format > filename.tmp。
- change | chg
- 可變更追蹤遮罩、maxSysErrors 或 maxRecordSize。
- clear | clr
- 可清除追蹤。
- flow | flw
- 可顯示追蹤的控制流。
- information | info | inf
- 可取得追蹤的資訊。
- options
- 在追蹤作用時,或是在格式化追蹤資訊時,可過濾追蹤資訊。
在追蹤作用時使用,可減少共用記憶體的用量。
除非追蹤非常大,否則通常在格式化期間,寫入完整的追蹤資訊並過濾會較容易。
- -m
- 可新增 "mask",以指定要將哪些事件、元件及函數併入追蹤。
預設值為追蹤所有項目。 該遮罩分為四部份,以英文句點隔開;
例如:2.2-6.1,3.*
您可指定一個範圍,用 "-" 作為分隔字元;或是指定一個列示,
用 "," 作為分隔字元。 例如:2-6 只包括 ID 在 2 至 6 範圍內的事件。 如果只要包括元件 2 及 6,則指定 2,6
- products
- 產品 ID。 DB2 Text Extender 的產品 ID 為 "2"。 TextMiner 的產品 ID 為 "3"。
- events
- 您想要併入追蹤的事件類型組:
- 0
- system_error
- 1
- system_error
- 2
- system_error
- 3
- non-fatal_error
- 4
- non-fatal_error
- 5
- api_errcode
- 7
- fnc_errcode
- 8
- trap error
- 10
- api_entry
- 11
- api_exit
- 13
- api_retcode
- 15
- api_data
- 30
- fnc_entry
- 31
- fnc_exit
- 33
- fnc_retcode
- 35
- fnc_data
- components
- 要追蹤的元件。
DB2 Text Extender 的元件 ID 有:
- 1
- COMMAND_LINE_INTERFACE
- 2
- UDF
- 3
- STORED_PROCEDURES
- 4
- ADMINISTRATION
- 5
- INDEX_CONTROL
- 6
- LIBRARY_SERVICES
- 7
- DES_PARSER
- 8
- DES_DEMON
- 9
- DES_API
- 10
- SERVICES
TextMiner 的元件 ID 有:
- 1
- automachine
- 2
- bgproc (背景處理程序)
- 3
- cluster
- 4
- common
- 5
- commsrvc (共用服務程式)
- 6
- communic (通信)
- 7
- daemon
- 8
- dsclient
- 9
- environ (環境)
- 10
- glue
- 11
- idxcomm (索引建置,共用部份)
- 12
- libsrv (檔案庫服務程式)
- 13
- search
- 14
- trace
- 15
- guru
- 16
- indexbld (索引建置,僅限 tm)
- 17
- indexeng (索引引擎,僅限 tm)
- 18
- smsearch
- 19
- 搜尋引擎,僅限 tm)
- 20
- tmsearch
- 21
- gtrcm (gtr,共用部份)
- 22
- gtrsrch (搜尋,僅限 gtr)
- 23
- gtridx (索引建置,僅限 gtr)
- functions
- 星號 (*)。要追蹤的函數集。 使用星號 (*) 來追蹤所有的函數,除非「IBM 支援中心」另有指示。
- -rc return-code
- 將 return-code 視為系統錯誤。
- -e max-system-errors
- 整數。在達到此錯誤數後,會停止追蹤。預設值為 1,
指定當第一次發生系統錯誤時,嚴重性較低之事件的所有後續追蹤都會停止。 如果您只對第一個主要錯誤有興趣的話,這個設定是可接受的,
但是如果您想要看到第一個系統錯誤發生後的完整追蹤,
則應指定較高的數字 (例如 -e 50)。 追蹤目的地為共用記憶體。
- -r max-record-size
- 整數。在將此數目的記錄寫入追蹤檔後,會停止追蹤。 預設值為 16 KB。
- -i initial-buffer-size
- 整數。自追蹤開始,保留此數目的記錄。 如果指定 -i,則預設值為 16 KB。 在 UNIX 系統上,建議的緩衝區大小為 2 MB。
如果沒有指定 -i,也沒有指定 -l,則 -l 為預設值。
如果您指定 -i,則不會折返;如果記錄的容體超出 max-record-size,
即使您清除了所有追蹤登錄,也不會再寫入進一步的追蹤登錄。 若要寫入新的追蹤登錄,請增加緩衝區大小,關掉追蹤,然後再打開。
- -l last-buffer-size
- 整數。自追蹤結束,保留此數目的記錄。預設值為 16 KB。
在 UNIX 系統上,建議的緩衝區大小為 2 MB。
- path
- 儲存相符檔案的目錄。
- dump-filename
- 包含二進位追蹤資訊之檔案的名稱。
- formatted-filename
- 包含已格式化之追蹤資訊的檔案的名稱。
Examples
請參閱追蹤錯誤。
[ 頁面頂端 | 前一頁 | 下一頁 | 目錄 | 索引 ]