配置配接器

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

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

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

標準連接器內容

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

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

連接器特有配置內容

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

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

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


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

ApplicationPassword

登入密碼



ApplicationUserName

登入使用者 ID



ArchiveQueue

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

queue://<queue_manager_name>/
WC_MQCONN.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://<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


SessionPoolSizeForRequests

要求處理期間使用的快取階段作業儲存區大小上限

10


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

CCSID

佇列管理程式連線的字集。這個內容的值應該符合 URI 佇列中的 CCSID 內容值。 如需詳細資訊,請參閱佇列統一資源識別碼 (URI)

預設值 = 無。

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

DefaultVerb

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

預設值 = 無。

EnableMessageProducerCache

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

預設值 = true。

EnableMessageProducerCache

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

預設值 = true

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

SessionPoolSizeForRequests

要求處理期間使用的快取階段作業儲存區大小上限。

預設值 = 10

UnsubscribedQueue

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

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

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

UseDefaults

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

Copyright IBM Corp. 1997, 2004