追蹤

檔案中的 TRACING 區段的參數,可讓您開啟和關閉 InterChange Server 元件的追蹤,以及指定追蹤層次。

DB_CONNECTIVITY

指定 InterChange Server 的資料庫連線功能服務與 DBMS 伺服器之間的互動追蹤層次。 InterChange Server 的資料庫連線功能服務,使用「Java 資料庫連線功能 (JDBC)」API 來與資料庫伺服器通訊。

如果您懷疑 InterChange Server 有存取 DBMS 伺服器方面的問題, 請嘗試追蹤資料庫服務。例如,如果「系統管理程式」似乎要花費很長的時間, 才能完成您輸入的配置變更,則您可能想要檢查該連線。

您可以將追蹤設為下列層次:
0 無追蹤。
1 當資料庫連線功能服務連接至資料來源或中斷與資料來源的連線時,將列印訊息, 以顯示真正的 SQL 陳述式。此外,當資料庫連線功能服務建立或刪除 InterChange Server 服務的連線儲存區時, 也會列印訊息。
2 列印層次 1 的訊息。此外,也會列印說明已建立及釋放之連線的訊息。
3 列印層次 1 和 2 的訊息。此外,也會列印指出在尋找可用連線時所採取的每一個內部步驟的訊息。 這些步驟包括搜尋現有的連線儲存區,以取得最近最少使用的連線。
4 列印層次 1 到 3 的訊息。此外,也會提供有關在尋找可用連線時所採取之步驟的詳細資訊。
5 列印層次 1 到 4 的訊息。此外,也會在關閉閒置連線時列印訊息。

範例:DB_CONNECTIVITY = 1

預設值

DB_CONNECTIVITY = 0
 

EVENT_MANAGEMENT

指定事件管理服務的追蹤層次。

您可以將追蹤設為下列層次:
0 無追蹤。
1 將事件管理服務的要求列印至資料庫,以儲存事件或變更有關事件的狀態資訊。 追蹤資訊指出已接收事件的連接器控制程式,以及它已傳送至其中的協同作業。
2 列印層次 1 的訊息。此外,也會列印每一個協同作業的記憶體內工作中佇列的內容。 追蹤訊息包括協同作業的工作中佇列內的事件數目, 以及進行中的事件數目。請查看是否有項目正在移出佇列,或是否僅正在新增它們。

範例:EVENT_MANAGEMENT = 1

預設值

EVENT_MANAGEMENT = 0
 

MESSAGING

指定 InterChange Server 傳訊驅動程式與傳訊服務之間的互動追蹤層次。

這個參數會影響 InterchangeSystem.cfg 檔常駐之機器上的傳訊驅動程式。 傳訊驅動程式會為任何已安裝在該機器上的 InterChange Server 元件服務,如:

您可以將追蹤設為下列層次:
0 無追蹤。
1 追蹤傳訊驅動程式如何從傳訊服務接收訊息,以及如何將訊息傳送至傳訊服務。 追蹤訊息會指定訊息是已設定類型 (商業物件) 訊息,或未設定類型 (管理) 訊息。
2 列印層次 1 的訊息。此外,也會列印已傳送和已接收之商業物件的內容。

範例:MESSAGING = 2

預設值

MESSAGING = 0
 

REPOSITORY

指定儲存庫服務的追蹤層次。 這會顯示要插入、擷取及刪除的儲存庫物件。

如果您遇到與儲存庫物件 (如可透過「系統管理程式」看到的物件) 有關的問題, 請嘗試追蹤儲存庫服務。

您可以將儲存庫追蹤設為下列層次:
0 無追蹤。
1 當儲存庫服務從資料庫擷取一個物件 (及其子物件,若適用的話) 以回應要求時,將列印訊息。
2 列印層次 1 的訊息。此外,當儲存庫服務順利地將新物件新增至儲存庫時,也會列印訊息。
3 列印層次 1 和 2 的訊息。此外,當儲存庫服務順利地變更儲存庫物件時,也會列印訊息。
4 列印層次 1 到 3 的訊息。此外,當儲存庫服務順利地從儲存庫刪除物件時,也會列印訊息。
5 列印層次 1 到 4 的訊息。此外,當儲存庫服務建立 helper 物件時,也會列印訊息。helper 物件就是寫在記憶體內,真正向資料庫伺服器提出要求, 並從其中傳回資訊的程式碼。儲存在儲存庫中之每一類型的物件都有一個 helper 物件。
6 列印層次 1 到 5 的訊息。此外,當 InterChange Server 為儲存庫物件建立資料庫綱目時,也會列印訊息。 啟動時會出現這些訊息。
7 列印層次 1 到 6 的訊息。此外,追蹤所有內部儲存庫方法。

範例:REPOSITORY = 3

預設值

REPOSITORY = 0
 

TRACE_FILE

指定當開啟追蹤時,InterChange Server 要寫入追蹤訊息的位置。 您可以將追蹤訊息傳送到標準輸出 (STDOUT) 或傳送到您指定其完整路徑的檔案。

如果您未指定這個參數值,則 InterChange Server 會將訊息寫至記載的目的地, 亦即 LOG_FILE 參數的值。

例如:

TRACE_FILE = logs/trace.log (在 ProductDir 目錄中)

預設值

TRACE_FILE = STDOUT
 

在 UNIX 中, STDOUT 會將日誌檔重新導向至 ProductDir 目錄中的 logs 子目錄。

MIRROR_TRACE_TO_STDOUT

這個選用參數可讓您將追蹤訊息傳送至標準輸出和追蹤檔。 如果 TRACE_FILE 參數已指定成有效的檔案, 則設定 MIRROR_TRACE_TO_STDOUT =TRUE 也會將追蹤輸出鏡映至標準輸出。如果未設定 TRACE_FILE,將忽略這個參數。

由於追蹤檔鏡映會造成效能的額外負荷,因此僅在開發和除錯期間, 這個參數才應設成 true。我們建議在生產期間指定 false 或完全不指定它 (在這種情況下, 它的預設值是 false)。

預設值

這個參數的預設值是 false (關閉)。

MAX_TRACE_FILE_SIZE

這個選用性參數會將追蹤檔大小限制為指定的大小。 大小單位可以是 KB (千位元組)、MB (百萬位元組) 或 GB (十億位元組)。 如果未指定任何單位,單位的預設值是位元組。

範例如下:

MAX_TRACE_FILE_SIZE = 100 KB
  
 MAX_TRACE_FILE_SIZE = 5 MB
  
 MAX_TRACE_FILE_SIZE = 1 GB
  
 MAX_TRACE_FILE_SIZE = 8192
 

如果指定了 MAX_TRACE_FILE_SIZE 參數,將隱含地啟用追蹤保存。

除非遭到 NUMBER_OF_ARCHIVE_TRACES 參數置換, 否則預設保存數為 5,前提是 MAX_TRACE_FILE_SIZE 設成 UNLIMITED 以外的值。

預設值

這個參數的預設值是 UNLIMITED

NUMBER_OF_ARCHIVE_TRACES

這個選用性參數指定要維護的保存追蹤數目。 保存檔的名稱衍生自 TRACE_FILE 的指定值。 如果未指定 MAX_TRACE_FILE_SIZE 參數, 或如果設定了 TRACE_FILE=STDOUT,將忽略這個參數。

範例,如果:

TRACE_FILE = traces/InterchangeSystem.trc (在 ProductDir 目錄中),且 NUMBER_OF_ARCHIVE_TRACES = 3

保存追蹤命名如下 (位於 ProductDir 目錄):

traces/InterchangeSystem_Arc_01.trc 
 traces/InterchangeSystem_Arc_02.trc
 traces/InterchangeSystem_Arc_03.trc
 

預設值

這個參數的預設值是 5。

RELATIONSHIP.CACHING

這個選用參數告訴 ICS 每次載入或卸載記憶體中之靜態關係的關係表格時, 將訊息寫至追蹤檔。將這個參數設成五 (5),以開啟這個追蹤。 值若少於五 (0-4) 將關閉這個追蹤。 根據預設值,這個參數不存在於 InterchangeSystem.cfg 檔的 TRACING 區段中。因此,將停用已快取關係表格的追蹤。

範例:RELATIONSHIP.CACHING=5

預設值

這個參數的預設值是 0。

TRANSACTIONS

指定交易服務的追蹤層次。

您可以將追蹤設為下列層次:
0

無追蹤。

1

當交易啟動,以及執行交易式佇列的後置確定處理程序時,將列印訊息。

2

列印層次 1 的訊息。此外,當交易服務儲存交易中之商業物件的狀態時,也會列印訊息。

3

列印層次 1 和 2 的訊息。此外,當交易式協同作業確定時,也會列印訊息。

4

列印層次 1 到 3 的訊息。此外,也會列印有關協同作業回復的訊息。 當回復開始時,以及當執行每一個補償步驟時,訊息就會出現。

5

列印層次 1 到 4 的訊息。此外,當暖啟動復原 (當 InterChange Server 在非預期結束之後重新啟動時所發生的復原) 時,也會列印訊息。 伺服器會重新啟動已被非預期結束所中斷的交易式協同作業,並且回復它們。 除非完成了暖啟動復原,否則伺服器不會將新事件傳遞到協同作業, 因此這些事件將留在佇列中,然後在復原期間結束時,就可以處理它們。

範例:TRANSACTIONS = 1

預設值

TRANSACTIONS = 0
 

FLOW_MONITORING

指定流程監視服務的追蹤層次。

您可以將追蹤設為下列層次:
0

無追蹤。

1

在啟動時列印訊息 (無論是否有為協同作業配置追蹤作業),並顯示資料庫的配置。

2

列印層次 1 的訊息。此外,在從內部佇列移除事件時,也會列印訊息。

3

列印層次 1 和 2 的訊息。此外,在透過 API 來移除事件記錄時,也會列印訊息。

4

列印層次 1 到 3 的訊息。此外,當事件被分派到內部佇列時,也會列印訊息。

5

列印層次 1 到 4 的訊息。此外,也會列印資料庫寫入內容。

範例:FLOW_MONITORING = 1

預設值

FLOW_MONITORING = 0 
 

SERVER_MEMORY

這個選用參數可讓伺服器監視事件觸發的串流使用記憶體的情形, 以及藉由暫停連接器來控制記憶體成長。

您可以將追蹤設為下列參數:
MEMORY_UPPER_THRESHOLD_PCT

伺服器暫停連接器的最大記憶體百分比。

MEMORY_LOWER_THRESHOLD_PCT

伺服器開始調整接聽器速度的記憶體百分比。

MEMORY_CHECK_SLEEP

記憶體檢查程式執行緒檢查伺服器記憶體的頻率。

SLEEPTIME_AFTER_MAX_THRESHOLD

記憶體檢查程式執行緒在連接器暫停之後檢查伺服器記憶體的頻率。

例如:

MEMORY_UPPER_THRESHOLD_PCT = 90
 MEMORY_LOWER_THRESHOLD_PCT = 75
 MEMORY_CHECK_SLEEP = 1
 SLEEPTIME_AFTER_MAX_THRESHOLD = 2
 

預設值

MEMORY_UPPER_THRESHOLD_PCT = 90
 MEMORY_LOWER_THRESHOLD_PCT = 80
 MEMORY_CHECK_SLEEP = 0
 SLEEPTIME_AFTER_MAX_THRESHOLD = 5
 

若要查看記憶體檢查程式執行緒的追蹤,請將下列參數新增至 [TRACING] 子區段:

SERVER_MEMORY = 1 to 3
 

DOMAIN_STATE_SERVICE

指定網域狀態服務的追蹤層次。 此服務追蹤 InterChange Server 系統中的所有元件狀態。


0 無追蹤。
1 當元件 (如連接器或協同作業) 新增至登錄或從登錄中刪除時,將列印訊息。 當元件狀態變更 (如執行中的連接器停止或暫停) 時,也會列印訊息。
2 列印層次 1 的訊息。此外,當呼叫任何方法時,也會列印訊息。

範例:DOMAIN_STATE_SERVICE = 1

預設值

DOMAIN_STATE_SERVICE = 0
 

MQSERIES_TRACE_LEVEL

針對與 WebSphere MQ 傳訊系統的連線指定除錯的追蹤層次。 追蹤層次可提供關於 InterChange Server 與 WebSphere MQ 通道的連線資訊。您可以在 WebSphere MQ 說明區搜尋追蹤,以取得詳細資訊。

您可以將追蹤設為下列層次:
0 無追蹤。
1 提供項目、結束和異常狀況追蹤。
2 列印層次 1 的訊息。此外,也提供參數資訊。
3 列印層次 1 和 2 的訊息。此外,也提供已傳輸和已接收的 MQ 標頭和資料區塊。
4 列印層次 1 到 3 的訊息。此外,也提供已傳輸和已接收的使用者訊息資料。
5 列印層次 1 到 4 的訊息。此外, 也針對「Java 虛擬機器」中的方法提供追蹤。

預設值

MQSERIES_TRACE_LEVEL = 0
 

MQSERIES_TRACE_FILE

指定當開啟追蹤時, WebSphere MQ 追蹤訊息要傳送到哪個檔名。 如果您沒有指定此參數的值,就會使用預設檔名 ProductDir/mqseries/CwMQ.trc

例如:

MQSERIES_TRACE_FILE = MQSeries.trace.log (位於 ProductDir 目錄)

預設值

MQSERIES_TRACE_FILE =mqseries/CwMQ.trc(在 ProductDir 目錄中)

Copyright IBM Corp. 1997, 2004