連接器有兩種配置內容類型: 標準配置內容和特定連接器配置內容。 在執行配接器之前,您必須先設定這些內容的值。 若要使用 ICS 作為您的整合分配管理系統來配置連接器內容, 請使用「連接器配置程式」。 如需詳細資訊,請參閱附錄 B, "連接器配置程式"。
連接器會在啟動時取得配置值。 於執行時期階段作業期間,您可能會變更一或多個連接器內容的值。 有些連接器配置內容的變更會立即生效,例如 AgentTraceLevel。 有些連接器內容的變更則需要重新啟動元件或系統才會生效。 若要判斷內容為動態(立即生效)或靜態(需要重新啟動連接器元件或系統), 請參閱「連接器配置程式」的「更新方法」直欄。
標準配置內容提供所有連接器使用的資訊。 如需這些內容的文件,請參閱附錄 A, 連接器的標準配置內容。
因為這個配接器僅支援 InterChange Server (ICS) 作為整合分配管理系統, 所以僅有 ICS 的配置內容才是相關的配置內容。
特定連接器配置內容提供連接器於執行時期所需的資訊。 亦提供一種方法以直接變更配接器內的靜態資訊或邏輯, 不必重新編碼和重新建置代理程式。
下列表格列出配接器的特定連接器配置內容。 請參閱後續幾節的內容說明。
名稱 | 可能值 | 預設值 | 必要的 |
---|---|---|---|
登入密碼
|
|
否
| |
登入使用者 ID
|
|
否
| |
順利處理的訊息複本將傳送至此佇列
|
queue://<queue_manager_name>/
|
否
| |
MQ 伺服器連接器通道
|
|
是
| |
配置 meta 物件的名稱
|
|
是
| |
資料處理常式類別名稱
|
com.crossworlds.DataHandlers.
text.xml
|
否
| |
資料處理常式 meta 物件
|
MO_DataHandler_ Default
|
是
| |
檔案的 MIME 類型
|
text/xml
|
否
| |
未處理之訊息的佇列
|
queue://<queue_manager_name>/WC_MQCONN.ERROR
|
否
| |
回饋碼 meta 物件
|
|
否
| |
WebSphere MQ 伺服器
|
|
是
| |
FailOnStartup、 Reproces、 Ignore、 LogError
|
Reprocess
|
否
| |
輪詢佇列
|
queue://<queue_manager_name>/WC_MQCONN.IN
|
否
| |
「進行中」事件佇列
|
queue://<queue_manager_name>/WC_MQCONN.IN_PROGRESS
|
是
| |
從 InputQueue
內容指定的每一個佇列中擷取的訊息數目
|
1
|
否
| |
為 WebSphere MQ 接聽器所建立的埠
|
|
是
| |
當配接器發出要求時,回應訊息將傳送至此佇列
|
queue://<queue_manager_name>/WC_MQCONN.REPLYTO
|
否
| |
未訂閱的訊息將傳送至這個佇列
|
queue://<queue_manager_name>/WC_MQCONN.UNSUBSCRIBE
|
否
| |
UseDefaults | true 或 false | false |
|
登入 WebSphere MQ 時搭配 UserID 一起使用的密碼。
預設值 = 無。
如果 ApplicationPassword 保留空白或移除,則配接器將使用 WebSphere MQ 提供的預設密碼。
登入 WebSphere MQ 時搭配密碼一起使用的使用者 ID。
預設值=無。
如果 ApplicationUserName 保留空白或移除, 則配接器將使用 WebSphere MQ 提供的預設使用者 ID。
順利處理的訊息複本將傳送至這個佇列。
預設值 = queue://<queue_manager_name>/WC_MQCONN.ARCHIVE
MQ 伺服器配接器通道,配接器透過此通道與 WebSphere MQ 通訊。
預設值=無。
如果 Channel 保留空白或移除,則配接器將使用 WebSphere MQ 提供的預設伺服器通道。
靜態 meta 物件的名稱,這個物件包含連接器的配置資訊。
預設值 = 無。
於訊息和商業物件之間轉換時所用的資料處理常式類別。
預設值 = com.crossworlds.DataHandlers.text.xml
傳送至資料處理常式以提供配置資訊的 meta 物件。
預設值 = MO_DataHandler_Default
可讓您依據特定 MIME 類型以要求資料處理常式。 搭配使用 WebSphere Commerce 需要 XML 資料處理常式。
預設值 = text/xml
無法處理的訊息將傳送至這個佇列。
預設值 = queue://<queue_manager_name>/WC_MQCONN.ERROR
可讓您置換和重新指派預設回饋碼,同步向 InterChange Server 確認已收到訊息。 這個內容可讓您指定 meta 物件,其中每一個屬性名稱皆可代表一個回饋碼。 回饋碼的對應值為傳送至 InterChange Server 的傳回狀態。 關於預設回饋碼的清單,請參閱"同步遞送"。 配接器接受下列屬性值來代表特定 MQ 的回饋碼:
配接器接受下列特定 ICS 狀態碼來代表 meta 物件中的屬性值:
下列表格顯示範例 meta 物件。
屬性名稱 | 預設值 |
---|---|
MQFB_APPL_FIRST |
SUCCESS
|
MQFB_APPL_FIRST + 1 |
FAIL
|
MQFB_APPL_FIRST + 2 |
UNABLE_TO_LOGIN
|
預設值 = 無。
掌管 WebSphere MQ 的伺服器名稱。
預設值=無。
指定如何處理由於非預期的配接器關閉而未完全處理的進行中事件。 若於起始設定期間發現進行中佇列有事件,請採取下列四種動作之一:
預設值 = Reprocess。
將為配接器輪詢新訊息的訊息佇列。 配接器接受多個以分號分隔的佇列名稱。 例如,若要輪詢下列三個佇列:MyQueueA、MyQueueB 及 MyQueueC,連接器配置內容 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 方法就完成。 以下為訊息擷取的順序:
預設值 = queue://<queue_manager_name>/WC_MQCONN.IN
保留處理中訊息的訊息佇列。
預設值 = queue://<queue_manager_name>/WC_MQCONN.IN_PROGRESS
pollForEvents 掃描期間從 InputQueue 內容所指定的每一個佇列中擷取的訊息數目。
預設值 =1
為 WebSphere MQ 接聽器所建立的埠。
預設值=無。
當配接器發出要求時,回應訊息將傳送至這個佇列。
預設值 = queue://<queue_manager_name>/WC_MQCONN.REPLY
未訂閱的訊息將傳送至此佇列。
預設值 = queue://<queue_manager_name>/WC_MQCONN.UNSUBSCRIBED
在「建立」作業上,如果 UseDefaults 設為 true,連接器會檢查提供給每一個 isRequired 商業物件屬性的是有效值或預設值。 如果已提供值,表示「建立」作業成功。如果參數設為 false,連接器僅檢查有效值,如果未提供, 則會導致「建立」作業失敗。預設值是 false。