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

請參閱追蹤錯誤。