連接器有兩種配置內容類型:標準配置內容及配接器特有的配置內容。執行配接器之前,您必須先設定這些內容的值。
您可以使用「連接器配置程式」來配置連接器內容:
連接器會在啟動時取得配置值。 於執行時期階段作業期間,您可能會變更一或多個連接器內容的值。 有些連接器配置內容的變更會立即生效,例如 AgentTraceLevel。 有些連接器內容的變更則需要重新啟動元件或系統才會生效。 若要判斷內容為動態 (立即生效) 或靜態 (需要重新啟動連接器元件或系統),請參閱「連接器配置程式」之「連接器內容」視窗中的「更新方法」直欄。
標準配置內容提供所有連接器使用的資訊。 請參閱附錄 A, 連接器的標準配置內容,以取得這些內容的文件。
連接器特有配置內容提供連接器於執行時期所需的資訊。 連接器特有內容也會提供一種方法,以變更連接器內的靜態資訊或邏輯,而不必重新編碼及重新建置代理程式。
下表列出配接器的連接器特有配置內容。請參閱後續幾節的內容說明。
名稱 | 可能值 | 預設值 | 必要的 |
---|---|---|---|
ApplicationPassword | 登入密碼 |
| 否 |
ApplicationUserName | 登入使用者 ID |
| 否 |
ArchiveQueue | 順利處理的訊息複本將傳送至此佇列 | queue://crossworlds. queue.manager/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://crossworlds. queue.manager/MQCONN.ERROR | 否 |
FeedbackCodeMappingMO | 回饋碼 Meta 物件 |
| 否 |
HostName | WebSphere MQ 伺服器 |
| 是 |
InDoubtEvents | FailOnStartup Reprocess IgnoreLogError | Reprocess | 否 |
InputQueue | 輪詢佇列 | queue://crossworlds. queue.manager/MQCONN.IN | 否 |
InProgressQueue | 「進行中」事件佇列 | queue://crossworlds.queue. manager/MQCONN.IN_PROGRESS | 否 |
PollQuantity | 從 InputQueue 內容指定的每一個佇列中擷取的訊息數目 | 1 | 否 |
Port | 為 WebSphere MQ 接聽器所建立的埠 |
| 是 |
ReplyToQueue | 當連接器發出要求時,回應訊息將傳送到的佇列 | queue://crossworlds. queue.manager/MQCONN.REPLY | 否 |
ReplyToQueuePollFrequency | 於同步要求處理期間輪詢接收端的間隔數 (毫秒) |
| 否 |
SessionPoolSizeForRequests | 要求處理期間用來快取階段作業的最大儲存池大小 | 10 | 否 |
UnsubscribedQueue | 未訂閱的訊息將傳送至這個佇列 | queue://crossworlds.queue. manager/MQCONN.UNSUBSCRIBED | 否 |
UseDefaults | true 或 false | false | 否 |
登入 WebSphere MQ 時搭配 UserID 一起使用的密碼。
預設值 = 無
如果 ApplicationPassword 保留空白或遭移除,則連接器將使用 WebSphere MQ 提供的預設密碼。*
登入 WebSphere MQ 時搭配密碼一起使用的使用者 ID。
預設值 = 無
如果 ApplicationUserName 保留空白或遭移除,則連接器將使用 WebSphere MQ 提供的預設使用者 ID。*
順利處理的訊息複本將傳送至這個佇列。
預設值 = queue://crossworlds.queue.manager/MQCONN.ARCHIVE
佇列管理程式連線的字集。此內容的值應該與佇列 URI 中之 CCSID 內容的值相符;請參閱佇列統一資源識別碼 (URI)。
預設值 = 無
MQ 伺服器連接器通道,連接器透過此通道與 WebSphere MQ 通訊。
預設值 = 無
如果將 Channel 保留空白或遭移除,則連接器將使用 WebSphere MQ 提供的預設伺服器通道。*
靜態 Meta 物件的名稱,這個物件包含連接器的配置資訊。
預設值 = 無
於訊息和商業物件之間轉換時所用的資料處理常式類別。
預設值 = com.crossworlds.DataHandlers.text.xml
傳送至資料處理常式以提供配置資訊的 Meta 物件。
預設值 = MO_DataHandler_Default
可讓您依據特定 MIME 類型以要求資料處理常式。
預設值 = text/xml
指定要在送入商業物件中設定的動詞 (如果在輪詢期間資料處理常式未設定該動詞)。
預設值 = 無
用來指定配接器應該啟用訊息產生程式快取以傳送要求訊息的 Boolean 內容。
預設值 = true
無法處理的訊息將傳送至這個佇列。
預設值 = queue://crossworlds.queue.manager/MQCONN.ERROR
可讓您置換和重新指派預設回饋碼,同步向 InterChange Server 確認已收到訊息。 這個內容可讓您指定 Meta 物件,其中每一個屬性名稱皆可代表一個回饋碼。 回饋碼的對應值為傳送至 InterChange Server 的傳回狀態。 關於預設回饋碼的清單,請參閱"同步遞送"。連接器接受代表 MQ 特有回饋碼的下列屬性值:
連接器接受下列 WebSphere 商業整合系統特有的狀態碼作為 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 個訊息,則連接器會依下列方法來擷取訊息:
因為我們的 PollQuantity 等於 2,所以每次呼叫 PollForEvents 時,連接器最多從每一個佇列擷取 2 則訊息。在第一次循環時 (2-1),連接器會從 MyQueueA、MyQueueB 及 MyQueueC 中每一者都擷取第一則訊息。這就完成第一回合的輪詢,如果我們的 PollQuantity 等於 1,則連接器會停止。因為我們的 PollQuantity 等於 2,所以連接器會開始第二回合的輪詢 (2-2),從 MyQueueA 和 MyQueueC 各擷取一則訊息-因為 MqQueueB 現在是空的,所以跳過。 在輪詢所有佇列兩次之後,呼叫 pollForEvents 方法就完成。 以下為訊息擷取的順序:
預設值 = queue://crossworlds.queue.manager/MQCONN.IN
保留處理中訊息的訊息佇列。 您可以使用「系統管理程式」,從連接器特有內容中移除預設 InProgressQueue 名稱, 來配置連接器在不使用此佇列的情況下,進行作業。這樣做會在啟動時顯示警告,指出如果連接器在事件擱置時關閉, 事件遞送可能會受損。
預設值 = queue://crossworlds.queue.manager/MQCONN.IN_PROGRESS
pollForEvents 掃描期間從 InputQueue 內容所指定的每一個佇列中擷取的訊息數目。
預設值 =1
為 WebSphere MQ 接聽器所建立的埠。
預設值 = 無
當連接器發出要求時,回應訊息將遞送到的佇列。 您也可以在子項動態 Meta 物件中使用這些屬性以忽略回應。如需這些屬性的詳細資訊,請參閱JMS 標頭及動態子項 Meta 物件屬性。
預設值 = queue://crossworlds.queue.manager/MQCONN.REPLY
指定同步要求處理期間,接收端的輪詢間隔。值為毫秒數。
預設值 = 無
要求處理期間用來快取階段作業的最大儲存池大小。
預設值 = 10
未訂閱的訊息將傳送至此佇列。
預設值 = queue://crossworlds.queue.manager/MQCONN.UNSUBSCRIBED
在「建立」作業上,如果 UseDefaults 設為 true,連接器會檢查提供給每一個 isRequired 商業物件屬性的是有效值或預設值。 如果已提供值,表示「建立」作業成功。如果參數設為 false,連接器僅檢查有效值,如果未提供, 則會導致「建立」作業失敗。預設值是 false。