Documentation
(C) IBM Corp. 1996, 2000

DB2 Text Extender

TXTRACE

此指令可將處理程序資訊寫入共用記憶體中的追蹤緩衝區。 本資訊可用來追蹤錯誤。 您可使用二進位,從該追蹤緩衝區將此資訊寫入檔案中,以在之後關掉追蹤時, 供格式化使用;或者可以在追蹤開著時,將此資訊格式化,並寫入檔案。

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

請參閱追蹤錯誤


[ 頁面頂端 | 前一頁 | 下一頁 | 目錄 | 索引 ]