配置配接器

連接器有兩種配置內容類型: 標準配置內容和特定連接器配置內容。 在執行配接器之前,您必須先設定這些內容的值。 若要使用 ICS 作為您的整合分配管理系統來配置連接器內容, 請使用「連接器配置程式」。 如需詳細資訊,請參閱附錄 B, "連接器配置程式"

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

標準連接器內容

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

因為這個配接器僅支援 InterChange Server (ICS) 作為整合分配管理系統, 所以僅有 ICS 的配置內容才是相關的配置內容。

特定連接器內容

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

下列表格列出配接器的特定連接器配置內容。 請參閱後續幾節的內容說明。

註:
這些內容包括預設佇列名稱值。 您需要變更這些值以符合您於設置中實際使用的佇列名稱。


表 7. 特定連接器配置內容
名稱 可能值 預設值 必要的

ApplicationPassword

登入密碼



ApplicationUserName

登入使用者 ID



ArchiveQueue

順利處理的訊息複本將傳送至此佇列

queue://<queue_manager_name>/
WC_MQCONN.ARCHIVE


Channel

MQ 伺服器連接器通道



ConfigurationMetaObject

配置 meta 物件的名稱



DataHandlerClassName

資料處理常式類別名稱

com.crossworlds.DataHandlers. text.xml


DataHandlerConfigMO

資料處理常式 meta 物件

MO_DataHandler_ Default


DataHandlerMimeType

檔案的 MIME 類型

text/xml


ErrorQueue

未處理之訊息的佇列

queue://<queue_manager_name>/WC_MQCONN.ERROR


FeedbackCodeMappingMO

回饋碼 meta 物件



HostName

WebSphere MQ 伺服器



InDoubtEvents

FailOnStartup、 Reproces、 Ignore、 LogError

Reprocess


InputQueue

輪詢佇列

queue://<queue_manager_name>/WC_MQCONN.IN


InProgressQueue

「進行中」事件佇列

queue://<queue_manager_name>/WC_MQCONN.IN_PROGRESS


PollQuantity

InputQueue 內容指定的每一個佇列中擷取的訊息數目

1


Port

為 WebSphere MQ 接聽器所建立的埠



ReplyToQueue

當配接器發出要求時,回應訊息將傳送至此佇列

queue://<queue_manager_name>/WC_MQCONN.REPLYTO


UnsubscribedQueue

未訂閱的訊息將傳送至這個佇列

queue://<queue_manager_name>/WC_MQCONN.UNSUBSCRIBE


UseDefaults true 或 false false

ApplicationPassword

登入 WebSphere MQ 時搭配 UserID 一起使用的密碼。

預設值 = 無。

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

ApplicationUserName

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

預設值=無。

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

ArchiveQueue

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

預設值 = queue://<queue_manager_name>/WC_MQCONN.ARCHIVE

Channel

MQ 伺服器配接器通道,配接器透過此通道與 WebSphere MQ 通訊。

預設值=無。

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

ConfigurationMetaObject

靜態 meta 物件的名稱,這個物件包含連接器的配置資訊。

預設值 = 無。

DataHandlerClassName

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

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

DataHandlerConfigMO

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

預設值 = MO_DataHandler_Default

DataHandlerMimeType

可讓您依據特定 MIME 類型以要求資料處理常式。 搭配使用 WebSphere Commerce 需要 XML 資料處理常式。

預設值 = text/xml

ErrorQueue

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

預設值 = queue://<queue_manager_name>/WC_MQCONN.ERROR

FeedbackCodeMappingMO

可讓您置換和重新指派預設回饋碼,同步向 InterChange Server 確認已收到訊息。 這個內容可讓您指定 meta 物件,其中每一個屬性名稱皆可代表一個回饋碼。 回饋碼的對應值為傳送至 InterChange Server 的傳回狀態。 關於預設回饋碼的清單,請參閱"同步遞送"。 配接器接受下列屬性值來代表特定 MQ 的回饋碼:

配接器接受下列特定 ICS 狀態碼來代表 meta 物件中的屬性值:

下列表格顯示範例 meta 物件。

表 8. 範例回饋碼 meta 物件屬性
屬性名稱 預設值
MQFB_APPL_FIRST

SUCCESS

MQFB_APPL_FIRST + 1

FAIL

MQFB_APPL_FIRST + 2

UNABLE_TO_LOGIN

預設值 = 無。

HostName

掌管 WebSphere MQ 的伺服器名稱。

預設值=無。

InDoubtEvents

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

預設值 = Reprocess

InputQueue

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

若未提供 InputQueue 內容,則連接器會適當地啟動, 但會列出警告訊息,並僅執行要求處理。 不會執行任何事件處理。

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

因為我們的 pollQuanity 等於 2,所以每次呼叫 pollForEvents 時, 配接器最多從每一個佇列擷取兩個訊息。 在第一次循環時 (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://<queue_manager_name>/WC_MQCONN.IN

InProgressQueue

保留處理中訊息的訊息佇列。

預設值 = queue://<queue_manager_name>/WC_MQCONN.IN_PROGRESS

PollQuantity

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

預設值 =1

Port

為 WebSphere MQ 接聽器所建立的埠。

預設值=無。

ReplyToQueue

當配接器發出要求時,回應訊息將傳送至這個佇列。

預設值 = queue://<queue_manager_name>/WC_MQCONN.REPLY

UnsubscribedQueue

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

預設值 = queue://<queue_manager_name>/WC_MQCONN.UNSUBSCRIBED

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

UseDefaults

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

Copyright IBM Corp. 1997, 2003