連接器配置

連接器有兩種配置內容類型:標準配置內容及配接器特有的配置內容。執行配接器之前,您必須先設定這些內容的值。

您可以使用「連接器配置程式」來配置連接器內容:

連接器會在啟動時取得配置值。 於執行時期階段作業期間,您可能會變更一或多個連接器內容的值。 有些連接器配置內容的變更會立即生效,例如 AgentTraceLevel。 有些連接器內容的變更則需要重新啟動元件或系統才會生效。 若要判斷內容為動態 (立即生效) 或靜態 (需要重新啟動連接器元件或系統),請參閱「連接器配置程式」之「連接器內容」視窗中的「更新方法」直欄。

標準連接器內容

標準配置內容提供所有連接器使用的資訊。 請參閱附錄 A, 連接器的標準配置內容,以取得這些內容的文件。

註:
當您設定「連接器配置程式」中的配置內容時,要使用 BrokerType 內容指定分配管理系統。設定它之後,分配管理系統相關的內容會出現在「連接器配置程式」視窗中。

連接器特有內容

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

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


表 8. 連接器特有配置內容
名稱 可能值 預設值 必要的
ApplicationPassword 登入密碼
ApplicationUserName 登入使用者 ID
ArchiveQueue 順利處理的訊息複本將傳送至此佇列 MQWFCONN.ARCHIVE
CCSID 佇列管理程式連線的字集 null
Channel MQ 伺服器連接器通道
ConfigurationMetaObject 配置 meta 物件的名稱
DataHandlerClassName 資料處理常式類別名稱 com.crossworlds.DataHandlers. text.xml
DataHandlerConfigMO 資料處理常式 meta 物件 MO_DataHandler_Default
DataHandlerMimeType 檔案的 MIME 類型 text/xml
DefaultVerb 連接器支援的任何動詞。 Create
ErrorQueue 未處理之訊息的佇列 MQWFCONN.ERROR
HostName WebSphere MQ 伺服器
InDoubtEvents FailOnStartup Reprocess IgnoreLogError Reprocess
InputQueue 輪詢佇列 MQWFCONN.IN
InProgressQueue 「進行中」事件佇列 MQWFCONN.IN_PROGRESS
PollQuantity InputQueue 內容指定的每一個佇列中擷取的訊息數目 1
Port 為 WebSphere MQ 接聽器所建立的埠
ReplyToQueue 當連接器發出要求時,回應訊息將傳送到的佇列 MQWFCONN.REPLYTO
UnsubscribedQueue 未訂閱的訊息將傳送至這個佇列 MQWFCONN.UNSUBSCRIBE
UseDefaults true 或 false false

ApplicationPassword

登入 MQ Integrator Broker 時搭配使用者 ID 一起使用的密碼。

預設值 = 無。

如果 ApplicationPassword 保留空白或移除,則連接器將使用 MQ Integrator Broker 提供的預設密碼。*

ApplicationUserName

登入 MQ Integrator Broker 時搭配密碼一起使用的使用者 ID。

預設值 = 無。

如果 ApplicationUserName 保留空白或移除,則連接器將使用 MQ Integrator Broker 提供的預設使用者 ID。*

ArchiveQueue

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

預設值 = MQWFCONN.ARCHIVE

CCSID

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

預設值 = null

Channel

MQ 伺服器連接器通道,連接器透過此通道與 MQ Integrator Broker 通訊。

預設值 = 無。

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

ConfigurationMetaObject

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

預設值 = 無。

DataHandlerClassName

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

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

DataHandlerConfigMO

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

預設值 = MO_DataHandler_Default

DataHandlerMimeType

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

預設值 = text/xml

DefaultVerb

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

預設值 = Create

ErrorQueue

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

預設值 = queue://CrossWorlds.QueueManager/ERROR

HostName

掌管 MQ Integrator 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.QueueManager/IN

InProgressQueue

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

預設值 = queue://CrossWorlds.QueueManaer/IN_PROGRESS

PollQuantity

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

預設值 =1

Port

為 MQ Integrator Broker 接聽器所建立的埠。

預設值 = 無。

ReplyToQueue

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

預設值 = queue://CrossWorlds.QueueManager/REPLYTO

UnsubscribedQueue

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

預設值 = queue://CrossWorlds.QueueManager/UNSUBSCRIBED

註:
*請務必檢查 MQ Integrator Broker 所提供的值,因為可能不正確或不明。 若是如此,請隱含地指定值。

UseDefaults

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

Copyright IBM Corp. 1997, 2003