檔案之 TRACING 區段中的參數,可讓您開啟和關閉 InterChange Server 元件的追蹤,以及指定追蹤層次。
InterChange Server 資料庫連線功能服務與 DBMS 伺服器之間的互動追蹤層次。 ICS 資料庫連線功能服務使用「Java 資料庫連線功能 (JDBC)」API 來與資料庫伺服器通訊。
如果您懷疑 ICS 有存取 DBMS 伺服器方面的問題, 請嘗試追蹤資料庫服務。例如,如果「系統管理程式」似乎要花費很長的時間, 才能完成您輸入的配置變更,則您可能想要檢查該連線。
您可以將追蹤設為下列層次:
層次 | 說明 |
0 | 無追蹤。 |
1 | 當資料庫連線功能服務連接至資料來源或中斷與資料來源的連線時,將列印訊息, 以顯示真正的陳述式。此外,當資料庫連線功能服務建立或刪除 InterChange Server 服務的連線儲存區時, 也會列印訊息。 |
2 | 列印層次 1 的訊息。此外,也會列印幾則說明已建立及釋放之連線的訊息。 |
3 | 列印層次 1 和 2 的訊息。此外,也會列印指出在尋找可用連線時所採取的每一個內部步驟的訊息。 這些步驟包括搜尋現有的連線儲存區,以取得最近最少使用的連線。 |
4 | 列印層次 1 到 3 的訊息。此外,也會提供有關在尋找可用連線時所採取之步驟的詳細資訊。 |
5 | 列印層次 1 到 4 的訊息。此外,也會在關閉閒置連線時列印訊息。 |
範例:DB_CONNECTIVITY = 1
DB_CONNECTIVITY = 0
可設定的追蹤層次介於 0 和 5 之間。
您可以將追蹤設為下列層次:
層次 | 說明 |
0 | 無追蹤。 |
1 | 在啟動時列印訊息 (會在這個層次為協同作業配置追蹤作業,並且會顯示資料庫的配置)。 |
2 | 列印層次 1 的訊息。此外,亦包含從內部佇列移除的事件。 |
3 | 列印層次 1 和 2 的訊息。此外,在透過 API 來移除事件記錄時,也會列印訊息。 |
4 | 列印層次 1 到 3 的訊息。此外,當事件被分派到內部佇列時,也會列印訊息。 |
5 | 列印層次 1 到 4 的訊息。此外,也會列印資料庫寫入內容。 |
範例:F LOW_MONITORING = 1
FLOW_MONITORING = 0
您可以將追蹤設為下列層次:
層次 | 說明 |
0 | 無追蹤。 |
1 | 將事件管理服務的要求列印至資料庫,以儲存事件或變更有關事件的狀態資訊。 追蹤資訊指出已接收事件的連接器控制程式,以及它已傳送至其中的協同作業。 |
2 | 列印層次 1 的訊息。此外,也會列印每一個協同作業的記憶體內工作中佇列的內容。 追蹤訊息包括協同作業的工作中佇列內的事件數目, 以及進行中的事件數目。請查看是否有項目正在移出佇列,或是否僅正在新增它們。 |
例如:
EVENT_MANAGEMENT = 1
EVENT_MANAGEMENT = 0
這個參數會影響 InterchangeSystem.cfg 檔常駐之機器上的傳訊驅動程式。 傳訊驅動程式會為已安裝在該機器上的 InterChange Server 元件提供服務,如:
您可以將追蹤設為下列層次:
層次 | 說明 |
0 | 無追蹤。 |
1 |
追蹤傳訊驅動程式如何從傳訊服務接收訊息,以及如何將訊息傳送至傳訊服務。
追蹤訊息會指定訊息是已設定類型 (商業物件) 訊息,或未設定類型 (管理) 訊息。
|
2 | 列印層次 1 的訊息。此外,也會列印已傳送和已接收之商業物件的內容。 |
例如:
MESSAGING = 2
MESSAGING = 0
儲存庫服務的追蹤層次。 這個參數會顯示要插入、擷取及刪除的儲存庫物件。
當遇到與儲存庫物件 (如可透過「系統管理程式」看到的物件) 有關的問題時, 您可以追蹤儲存庫服務。
您可以將儲存庫追蹤設為下列層次:
層次 | 說明 |
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
當開啟追蹤時,InterChange Server 寫入追蹤訊息的位置。 您可以將追蹤訊息傳送到標準輸出 (STDOUT) 或傳送到您指定其完整路徑的檔案。
如果您未指定這個參數值,則 InterChange Server 會將訊息寫至記載的目標, 亦即 LOG_FILE 參數的值。
範例:TRACE_FILE = logs\trace.log (在 ProductDir 目錄中)
TRACE_FILE = STDOUT
可讓您將追蹤訊息傳送至標準輸出和追蹤檔的參數。 如果 TRACE_FILE 參數已指定成有效的檔案, 則設定 MIRROR_TRACE_TO_STDOUT =TRUE 也會將追蹤輸出鏡映至標準輸出。如果未設定 TRACE_FILE,將忽略這個參數。
由於追蹤檔鏡映會造成效能的額外負荷,因此僅在開發和除錯期間, 才將這個參數設成 true。在正式作業期間將它設為 false 或完全不指定它 (在這種情況下, 它的預設值是 false)。
這個參數的預設值是 false (關閉)。
追蹤檔的大小限制。此值可以是以 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
如果指定了這個參數值,將隱含地啟用追蹤保存。
這個參數的預設值是 UNLIMITED。
要維護的保存追蹤數目。 保存檔的名稱衍生自指定的 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
除非這是遭到 NUMBER_OF_ARCHIVE_TRACES 置換的參數, 或除非 MAX_TRACE_FILE_SIZE 設成 UNLIMITED 以外的值, 否則預設保存數為 5。
此為觸發函式,它可讓 ICS 在每次載入或卸載記憶體中之靜態關係的關係表格時, 將訊息寫至追蹤檔。將這個參數設成 5,以開啟這個追蹤。 值若是 0-4,將關閉這個追蹤。根據預設值,這個參數不存在於 InterchangeSystem.cfg 檔的 TRACING 區段中。因此,將停用已快取的關係表格之追蹤。
範例:RELATIONSHIP.CACHING=5
這個參數的預設值是 0。
您可以將追蹤設為下列層次:
層次 | 說明 |
0 | 無追蹤。 |
1 | 當交易啟動,以及執行交易式佇列的後置確定處理程序時,將列印訊息。 |
2 | 列印層次 1 的訊息。此外,當交易服務儲存交易中之商業物件的狀態時,也會列印訊息。 |
3 | 列印層次 1 和 2 的訊息。此外,當交易式協同作業確定時,也會列印訊息。 |
4 | 列印層次 1 到 3 的訊息。此外,也會列印有關協同作業回復的訊息。 當回復開始時,以及當執行每一個補償步驟時,訊息就會出現。 |
5 | 列印層次 1 到 4 的訊息。此外,在進行暖啟動回復時 (當 InterChange Server 在非預期結束之後,重新啟動時,所發生的作業),也會列印訊息。 伺服器會重新啟動因非預期結束而中斷的交易式協同作業,並加以回復。 除非暖啟動復原作業完成,否則伺服器不會將新事件傳遞到協同作業, 因此這些事件將留在佇列中,然後在回復期間結束時,就可以處理它們。 |
範例:TRANSACTIONS = 1
TRANSACTIONS = 0
此為觸發函式,它可讓伺服器監視事件觸發之串流的記憶體使用情形, 以及藉由暫停配接器來控制記憶體成長。
您可以將追蹤設為下列參數:
參數 | 說明 |
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
網域狀態服務的追蹤層次。 這個服務會追蹤系統中所有元件的狀態。
層次 | 說明 |
0 | 無追蹤。 |
1 | 當元件 (如配接器或協同作業) 新增至登錄或從登錄中刪除時,將列印訊息。 當元件狀態變更 (如執行中的配接器停止或暫停) 時,也會列印訊息。 |
2 | 列印層次 1 的訊息。此外,當呼叫任何方法時,也會列印訊息。 |
範例:DOMAIN_STATE_SERVICE = 1
DOMAIN_STATE_SERVICE = 0
針對與 WebSphere MQ 傳訊系統的連線進行除錯時的追蹤層次。 追蹤層次提供關於 InterChange Server 與 WebSphere MQ 通道之連線的資訊。 您可以在 WebSphere MQ 說明區搜尋追蹤以取得詳細資訊。若要啟動搜尋, 請移至「開始」功能表 >「程式集」> WebSphere MQ >「WebSphere MQ 資訊中心」,然後按一下「搜尋」標籤。
您可以將追蹤設為下列層次:
層次 | 說明 |
0 | 無追蹤。 |
1 | 提供項目、結束和異常狀況追蹤。 |
2 | 列印層次 1 的訊息。此外,也提供參數資訊。 |
3 | 列印層次 1 和 2 的訊息。此外,也提供已傳輸和已接收的 MQ 標頭和資料區塊。 |
4 | 列印層次 1 到 3 的訊息。此外,也提供已傳輸和已接收的使用者訊息資料。 |
5 | 列印層次 1 到 4 的訊息。此外,也提供「Java 虛擬機器」中的方法之追蹤。 |
MQSERIES_TRACE_LEVEL = 0
當開啟追蹤時,WebSphere MQ 追蹤訊息要傳送到的檔案。 如果您未指定這個參數值,將使用預設檔名 ProductDir\mqseries\CwMQ.trc。
範例:MQSERIES_TRACE_FILE = MQSeries.trace.log (位於 ProductDir 目錄)