連接器特有內容概觀

連接器特有配置內容提供連接器代理程式於執行時期所需的資訊。 連接器特有內容會提供一種方法,以變更連接器代理程式內的靜態資訊或邏輯,而不必重新編碼及重新建置代理程式。

下列內容判斷配接器及 WebSphere Business Integration Message Broker 之間的通訊:

附錄 A, 連接器的標準配置內容中,可以找到判斷 InterChange Server 整合分配管理系統及配接器之間通訊的內容。

連接器特有內容

表 24 列出連接器之連接器特有配置內容。請參閱後續幾節的內容說明。


表 24. 連接器特有配置內容
名稱 可能值 預設值 必要的
ApplicationPassword 登入密碼
ApplicationUserName 登入使用者 ID
ArchiveQueue 順利處理的訊息複本將傳送至此佇列 queue://crossworlds.queue. manager/WBIMBConnector/ARCHIVE
CCSID 佇列管理程式連線的字集 空值
Channel MQ 伺服器連接器通道
ConfigurationMetaObject 配置 Meta 物件的名稱
DataHandlerClassName 資料處理常式類別名稱 com.crossworlds.DataHandlers. text.xml
DataHandlerConfigMO 資料處理常式 Meta 物件 MO_DataHandler_Default
DataHandlerMimeType 檔案的 MIME 類型 text/xml
DefaultVerb 連接器支援的任何動詞

EnableMessageProducerCache true 或 false true
ErrorQueue 未處理之訊息的佇列 queue://crossworlds.queue. manager/WBIMBConnector/ERROR
HostName WebSphere MQ 伺服器 在連結模式中連接本端佇列管理程式。
InDoubtEvents FailOnStartup Reprocess IgnoreLogError Reprocess
InputQueue 輪詢佇列 queue://crossworlds.queue. manager/WBIMBConnector/IN
InProgressQueue 「進行中」事件佇列
PollQuantity InputQueue 內容指定的每一個佇列中擷取的訊息數目 1
Port 為 WebSphere MQ 接聽器所建立的埠 1414
ReplyToQueue 當連接器發出要求時,回應訊息將傳送到的佇列 queue://crossworlds.queue. manager/WBIMBConnector/REPLY
ReplyToQueuePollFrequency 於同步要求處理期間輪詢接收端的間隔數 (毫秒)
SessionPoolSizeForRequests 要求處理期間用來快取階段作業的最大儲存池大小 10
UnsubscribedQueue 未訂閱的訊息將傳送至這個佇列 queue://crossworlds.queue. manager/WBIMBConnector/ UNSUBSCRIBED
UseDefaults true 或 false false

ApplicationPassword

登入 WebSphere Business Integration Message Broker 時,搭配使用者 ID 使用的密碼。

預設值 = 無。

如果 ApplicationPassword 保留空白或移除,則連接器將使用 WebSphere Business Integration Message Broker 提供的預設密碼。

ApplicationUserName

登入 WebSphere Business Integration Message Broker 時,搭配密碼使用的使用者 ID。

預設值 = 無。

如果 ApplicationUserName 保留空白或移除,則連接器將使用 WebSphere Business Integration Message Broker 提供的預設使用者 ID。

ArchiveQueue

順利處理的訊息複本將傳送至這個佇列。

預設值 = queue://crossworlds.queue.manager/WBIMBConnector/ARCHIVE

CCSID

佇列管理程式連線的字集。此內容的值應該與佇列 URI 中的 CCSID 內容值相符。請參閱設定佇列統一資源識別碼 (URI)

預設值 = 空值

Channel

MQ 伺服器連接器通道,連接器透過此通道與 WebSphere Business Integration Message Broker 通訊。

預設值 = 無。

如果 Channel 保留空白或移除,則連接器將使用 WebSphere Business Integration Message Broker 提供的預設伺服器通道。

ConfigurationMetaObject

包含連接器配置資訊的 Meta 物件名稱

預設值 = 無。

DataHandlerClassName

於訊息和商業物件之間轉換時所用的資料處理常式類別。

預設值 = com.crossworlds.DataHandlers.text.xml

DataHandlerConfigMO

傳送至資料處理常式以提供配置資訊的 Meta 物件。

預設值 = MO_DataHandler_Default

DataHandlerMimeType

可讓您依據特定 MIME 類型以要求資料處理常式。

預設值 = text/xml

DefaultVerb

指定要在送入商業物件中設定的動詞 (如果在輪詢期間資料處理常式未設定該動詞)。

預設值 = 無

EnableMessageProducerCache

用來指定配接器應該啟用訊息產生程式快取以傳送要求訊息的 Boolean 內容。

預設值 = true

ErrorQueue

無法處理的訊息將傳送至這個佇列。

預設值 = queue://crossworlds.queue.manager/WBIMBConnector/ERROR

HostName

掌控 WebSphere Business Integration Message Broker 的伺服器名稱。

預設值 = 未提供值時,配接器將在連結模式下連接本端佇列管理程式。

InDoubtEvents

指定如何處理由於非預期的連接器關閉而未完全處理的進行中事件。若於起始設定期間發現進行中佇列有事件,請採取下列四種動作之一:

預設值 = Reprocess

InputQueue

連接器輪詢是否有新訊息的訊息佇列。連接器接受多個以分號定界的佇列名稱。例如,若要輪詢下列三個佇列:MyQueueAMyQueueBMyQueueC,連接器配置內容 InputQueue 的值等於:MyQueueA;MyQueueB;MyQueueC

連接器以循環方式輪詢佇列,從每個佇列中最多擷取 pollQuantity 則訊息。比方說,如果 pollQuantity 等於 2,且 MyQueueA 包含 2 個訊息、MyQueueB 包含 1 個訊息、MyQueueC 包含 5 個訊息,則連接器會依下列方法來擷取訊息:

因為 pollQuanity 的值是 2,每次呼叫 PollForEvents 時,連接器最多從每一個佇列擷取 2 則訊息。在第一次循環時 (2-1),連接器會從 MyQueueA、MyQueueB 及 MyQueueC 中每一者都擷取第一則訊息。這會完成第一回合的輪詢,如果 pollQuantity 的值是 1,則連接器會停止。因為 pollQuanity 的值是 2, 連接器會開始第二回合的輪詢 (2-2),從 MyQueueA 和 MyQueueC 各擷取一則訊息 -- 因為 MqQueueB 現在是空的,所以跳過。 在輪詢所有佇列兩次之後,呼叫 pollForEvents 方法就完成。 以下為訊息擷取的順序:

  1. MyQueueA 擷取一個訊息
  2. MyQueueB 擷取一個訊息
  3. MyQueueC 擷取一個訊息
  4. MyQueueA 擷取一個訊息
  5. 跳過 MyQueueB,因為現在是空的
  6. MyQueueC 擷取一個訊息

預設值 = queue://crossworlds.queue.manager/WBIMBConnector/IN

InProgressQueue

保留處理中訊息的訊息佇列。 您可以使用「系統管理程式」,從連接器特有內容中移除預設 InProgressQueue 名稱, 來配置連接器在不使用此佇列的情況下,進行作業。這樣做會在啟動時顯示警告,指出如果連接器在事件擱置時關閉, 事件遞送可能會受損。

預設值 = 無

PollQuantity

pollForEvents 掃描期間從 InputQueue 內容所指定的每一個佇列中擷取的訊息數目。

預設值 = 1

Port

為 WebSphere Business Integration Message Broker 接聽器所建立的埠。

預設值 = WebSphere MQ 環境的預設埠 1414

ReplyToQueue

當連接器發出要求時,回應訊息將遞送到的佇列。

預設值 = queue://crossworlds.queue.manager/WBIMBConnector/REPLY

ReplyToQueuePollFrequency

指定同步要求處理期間,接收端的輪詢間隔。值為毫秒數。

預設值 = 無。

SessionPoolSizeForRequests

要求處理期間用來快取階段作業的最大儲存池大小。

預設值 = 10

UnsubscribedQueue

未訂閱的訊息將傳送至此佇列。

預設值 = queue://crossworlds.queue.manager/WBIMBConnector/UNSUBSCRIBED

註:
*請務必檢查 WebSphere Business Integration Message Broker 提供的值,這些值可能不正確或不明。 若是如此,請隱含地指定值。

UseDefaults

在「建立」作業上,如果 UseDefaults 設為 true,連接器會檢查提供給每一個 isRequired 商業物件屬性的是有效值或預設值。 如果已提供值,表示「建立」作業成功。如果參數設為 false,連接器僅檢查有效值,如果未提供, 則會導致「建立」作業失敗。預設值是 false

Copyright IBM Corp. 1997, 2004