WebSphere WebSphere Enterprise Service Bus, Version 6.0.1 作業系統: AIX, HP-UX, Linux, Solaris, Windows

「訊息日誌程式」調解基本元素

您可以使用「訊息日誌程式」調解基本元素將訊息儲存在資料庫中。

簡介

「訊息日誌程式」調解基本元素會在調解流程期間, 將訊息儲存在資料庫中。「訊息日誌程式」調解基本元素會使用 IBM 定義的資料庫綱目, 將訊息記載到關聯式資料庫中;它不會寫入純文字檔之類的其他儲存媒體。

「訊息日誌程式」調解基本元素會記載 SMO 的 XML 轉換碼副本。 預設行為是只記載有效負載,但調解基本元素可配置成記載完整的 SMO, 或是由 XPath 表示式所定義的部分 SMO。除了訊息內容,調解基本元素也會記載時間戳記、 訊息 ID、基本元素實例名稱、調解模組實例名稱,以及 SMO 版本號碼。

記載的訊息會儲存在名稱為 Message 的資料庫直欄中。 其他記載的資料則會儲存在適當標題的直欄中,這個主題之後會加以說明。

「訊息日誌程式」調解基本元素有一個輸入端和兩個輸出端。一個輸出端用於成功輸出,另一個用於失敗輸出。連接輸入端可用來接受訊息, 而連接輸出端則可用來傳送訊息。輸入訊息會觸發記載到資料庫,如果記載成功,成功輸出端會傳送原始訊息。如果處理輸入訊息期間發生異常狀況, 則失敗端會傳送原始訊息,以及任何異常狀況資訊。

用法

您可以使用「訊息日誌程式」調解基本元素來儲存之後要處理的訊息。記載的訊息可以用於各種不同的用途。比方說,您可以使用記載的訊息來進行資料採礦或用於審核。

將資料記載成 XML,表示它可以由任何認得 XML 的應用程式來處理。許多資料庫(包括 DB2)都提供內建功能來處理資料庫直欄內含的 XML。

執行時期產品的預設安裝作業會建立獨立式應用程式伺服器,以及 Cloudscape 資料庫和資料來源。依預設,「訊息日誌程式」調解基本元素會配置成使用這個 Cloudscape 資料庫。執行時期產品也會提供名稱為 createMessageLoggerResource.jacl 的 Script 來建立 Cloudscape 資料庫。

內容

資料來源名稱
定義資料記載位置之資料來源的 JNDI 名稱。
這是一個 XPath 1.0 表示式,代表要記載的訊息範圍。 您可以指定://body/headers 或是您自己的 XPath 表示式。/ 表示完整的 SMO,/body 表示 SMO 的主體區段,而 /headers 表示 SMO 的標頭。如果指定您自己的 XPath 表示式, 則會處理您指定的 SMO 部分。要記載的訊息會從「根」(Root) 指定的那一點轉換成 XML。
交易模式
定義是要在流程的交易內確定資料庫的變更,或是在新的交易中確定資料庫的變更。如果您指定 Same,則會在流程的交易內記載訊息。雖然調解元件可配置成在廣域交易下執行,但是依預設,流程會在區域交易下執行。如果已指定廣域交易,且在流程中發生失敗, 則會回復廣域交易(包括日誌作業)。如果您指定 New,則會在它自己的區域交易內記載訊息。在此情況下,如果流程中發生失敗, 則不會回復訊息記載。
表 1. 「訊息日誌程式」調解基本元素內容
內容 有效值 預設值
資料來源名稱 字串 jdbc/mediation/messageLog
字串:代表轉換的根之 XPath 表示式。 /body
交易模式 字串:SameNew Same
表 2. 「訊息日誌程式」資料庫表格綱目
直欄名稱 SQL 類型 索引鍵欄位 說明
時間戳記 TIMESTAMP Y UTC 時間戳記,指出訊息記載到資料庫的時間。
MessageID VARCHAR Y 來自 SMO 的訊息 ID。
MediationName VARCHAR Y 記載訊息之調解基本元素實例的名稱。
ModuleName VARCHAR N 包含「訊息日誌程式」基本元素之調解模組實例的名稱。
Message CLOB N 轉碼成 XML 的 SMO。
Version VARCHAR N 記載之 SMO 的版本。

注意事項

當您使用「訊息日誌程式」調解基本元素時,請考量下列事項:

相關資訊
利用 Java 資料庫連線功能資料調解者服務進行資料存取

Reference topic

使用條款 | 此頁的評等

時間戳記前次更新: 6 Mar 2006
http://publib.boulder.ibm.com/infocenter/dmndhelp/v6rxmx/index.jsp?topic=/com.ibm.wbit.help.medprim.doc.nl1_6.0.1\ref\rwesb_MessageLoggermediationprimitive.html

(C) Copyright IBM Corporation 2005. All Rights Reserved.
本資訊中心採用 Eclipse 技術。(http://www.eclipse.org)