本章節會列出及定義每一個標準連接器的配置內容。
整合分配管理系統用以將管理訊息傳送至連接器的佇列。
預設值是 CONNECTORNAME/ADMININQUEUE。
連接器用以將管理訊息傳送至整合分配管理系統的佇列。
預設值是 CONNECTORNAME/ADMINOUTQUEUE。
只有在 RepositoryDirectory 為 <REMOTE> 時才適用。
AgentConnections 內容會控制由 orb.init[] 所開啟的 ORB (Object Request Broker) 連線數目。
這個內容的預設值設定為 1。您可以視需要變更它。
特定應用程式元件的追蹤訊息層次。 預設值是 0。連接器會遞送已設定之追蹤層次或更低層次上所有可用的追蹤訊息。
連接器的應用程式的獨特識別名稱。 系統管理者使用此名稱來監督 WebSphere 商業整合系統環境。 這個內容必須有一個值,您才可執行連接器。
識別您目前使用的整合分配管理系統類型。 選項有:ICS、WebSphere 訊息分配管理系統 (WMQI、WMQIB 或 WBIMB) 或 WAS。
指定從字元(例如,英文字母、數值表示法或標點符號)對映到數值所用的字碼集。
依預設,下拉清單中僅顯示一部份受支援的字元編碼。 若要於下拉清單中加入其他支援的值,您必須以手動方式修改產品目錄中的 \Data\Std\stdConnProps.xml 檔案。 如需詳細資訊,請參閱本手冊中有關「連接器配置程式」的小節。
只有在 RepositoryDirectory 為 <REMOTE> 時才適用。
決定連接器可同時處理多少商業物件,以遞送事件。 請將這個屬性的值設為您要同時對映和遞送的商業物件數目。 例如,將這個內容的值設為 5 可同時處理五個商業物件。 預設值是 1。
將這個內容設為大於 1 的值可讓來源應用程式的連接器同時對映多個事件商業物件, 且同時遞送至多個協同作業實例。 尤其當商業物件使用複式對映時,可加速將商業物件遞送至整合分配管理系統。增加商業物件至協同作業實例的到達率可改善系統的整體效能。
實作整個流程(從來源應用程式到目的地應用程式)的並行處理,您必須:
ConcurrentEventTriggeredFlows 內容不影響連接器輪詢(單一執行緒且序列化執行)。
這個內容可讓包含 JMS 事件儲存庫且具有 JMS 功能的連接器提供保證事件遞送, 在此情形下,會將事件從來源佇列移除並放置到目的地佇列中成為單一 JMS 交易。
沒有預設值。
當 ContainerManagedEvents 設為 JMS 時,您必須配置下列內容來啟用保證事件遞送:
您也必須以 MimeType、DHClass (資料處理常式類別) 及 DataHandlerConfigMOName (選用的 Meta 物件) 內容來配置資料處理常式。 若要設定這些值,請使用「連接器配置程式」中的資料處理常式標籤。
這些內容是配接器特有的,但是範例值為:
唯有當您已將 ContainerManagedEvents 設為 JMS 後,「資料處理常式」標籤中的這些值欄位才會顯示。
只有在 DeliveryTransport 內容設為 JMS 這個值時, 這個內容才會出現。
只有在 RepositoryDirectory 為 <REMOTE> 時才適用。
設定連接器控制程式在偵測到目的地特定應用程式元件無法使用之後的行為。
若這個內容設為 true,且當事件到達 ICS 時無可用的目的地特定應用程式元件, 則連接器控制程式會暫停對特定應用程式元件的要求。 當特定應用程式元件恢復運作時,控制程式就會轉遞要求。
但是當連接器控制程式轉遞服務呼叫要求之後,若目的地應用程式的特定應用程式元件無法使用, 則連接器控制程式會讓此要求失敗。
若這個內容設為 false,則當連接器控制程式偵測到目的地特定應用程式元件無法使用時, 就會立即讓所有服務呼叫要求失敗。
預設值是 true。
只有在 RepositoryDirectory 為 <REMOTE> 時才適用。
連接器控制程式的追蹤訊息層次。 預設值是 0。
只有在 DeliveryTransport 為 JMS 時才適用。
連接器用以將商業物件傳送至整合分配管理系統的佇列。
預設值為 CONNECTORNAME/DELIVERYQUEUE。
指定遞送事件的傳輸機制。 可能值為 MQ (若為 WebSphere MQ)、IDL (若為 CORBA IIOP) 或 JMS (若為 Java Messaging Service)。
若對 DeliveryTransport 內容配置的值為 MQ 或 IDL,則連接器會透過 CORBA IIOP 來傳送服務呼叫要求和管理訊息。
在事件遞送傳輸機制上使用 WebSphere MQ 來取代 IDL, 除非您只能有一個產品。WebSphere MQ 提供下列優於 IDL 的優點:
透過「Java 訊息服務 (JMS)」來讓連接器與用戶端連接器組織架構彼此通信。
若您選取 JMS 作為遞送傳輸,則「連接器配置程式」中會顯示額外的 JMS 內容,例如 jms.MessageBrokerName、 jms.FactoryClassName、jms.Password 以及 jms.UserName。此傳輸需要其中的前兩個內容。
此環境中,由於 WebSphere MQ 用戶端的記憶體使用情形, 您可能難以啟動連接器控制程式(在伺服器端)和連接器(在用戶端)。 若您的安裝架構使用小於 768M 的程序資料堆大小,則 IBM 建議您設定:
這個 Script 位於產品目錄的 \bin 目錄中。利用文字編輯器,在 CWSharedEnv.sh Script 中新增下一行作為第一行:
export LDR_CNTRL=MAXDATA=0x30000000
此行可限制資料堆記憶體用量最大為 768 MB (3 區段 * 256 MB)。若程序記憶體超過此限制, 則對您的系統效能會造成負面影響。
將這個內容設為 true,則可讓具有 JMS 功能的連接器確保不會遞送重複事件到遞送佇列中。 若要使用這個功能,連接器必須有一個唯一事件識別碼設為應用程式特定程式碼中商業物件的 ObjectEventId 屬性。 這會在連接器開發期間內完成。
這個內容亦可設為 false。
若連接器在處理訊息時發生錯誤, 則連接器會將訊息移至這個內容所指定的佇列,伴隨著狀態指示器和問題說明。
預設值是 CONNECTORNAME/FAULTQUEUE。
代理程式資料堆大小的最大值 (以 MB 為單位)。只有當 RepositoryDirectory 值設為 <REMOTE> 時,才能使用這個內容。
預設值是 128m。
代理程式原生堆疊大小的最大值 (以 KB 為單位)。 只有當 RepositoryDirectory 值設為 <REMOTE> 時,才能使用這個內容。
預設值是 128k。
代理程式資料堆大小的最小值 (以 MB 為單位)。只有當 RepositoryDirectory 值設為 <REMOTE> 時,才能使用這個內容。
預設值是 1m。
指定為 JMS 提供者建立實例的類別名稱。當選擇 JMS 作為遞送傳輸機制 (DeliveryTransport) 時,您必須設定這個連接器內容。
預設值是 CxCommon.Messaging.jms.IBMMQSeriesFactory。
指定用於 JMS 提供者的分配管理系統名稱。當選擇 JMS 作為遞送傳輸機制 (DeliveryTransport) 時,您必須設定這個連接器內容。
預設值是 crossworlds.queue.manager。連接到本端訊息分配管理系統時,請使用預設值。
當您連接到遠端訊息分配管理系統時,這個內容會採用下列 (強制) 值:
QueueMgrName:<Channel>:<HostName>:<PortNumber>,
其中的變數為:
QueueMgrName:佇列管理程式名稱。
Channel:用戶端使用的通道。
HostName:佇列管理程式將常駐的機器名稱。
PortNumber:佇列管理程式將用來接聽的埠號。
例如:
jms.MessageBrokerName =
WBIMB.Queue.Manager:CHANNEL1:RemoteMachine:1456
指定可同時傳送至連接器的並行服務呼叫要求最大數目。 一旦到達這個最大值時,新的服務呼叫會暫停執行, 等到另一個要求完成之後才會繼續進行。
預設值是 10。
指定 JMS 提供者的密碼。 這個內容的值是選用的。
沒有預設值。
指定 JMS 提供者的使用者名稱。這個內容的值是選用的。
沒有預設值。
當 ICS 為整合分配管理系統時,這個內容可支援 MQ 接聽器中的多緒作業。 它可以批次方式將多個事件寫入資料庫,藉此提高系統效能。 預設值是 1。
這個內容僅適用於使用 MQ 傳輸的連接器。 DeliveryTransport 內容必須設為 MQ。
指定語言碼、國家或地區,及相關聯的字碼集(選用)。 這個內容的值決定文化慣例,例如資料的分頁和排序、 日期和時間格式,及貨幣規格使用的符號。
語言環境名稱的格式如下:
ll_TT.codeset
其中:
依預設,下拉清單中僅顯示一部份受支援的語言環境。 若要於下拉清單中加入其他支援的值,您必須以手動方式修改產品目錄中的 \Data\Std\stdConnProps.xml 檔案。 如需詳細資訊,請參閱本手冊中有關「連接器配置程式」的小節。
預設值是 en_US。若連接器尚未全球化,則這個內容唯一有效的值是 en_US。 若要判斷特定連接器是否已全球化,請參閱下列網站中的連接器版本清單:
http://www.ibm.com/software/websphere/wbiadapters/infocenter, 或 http://www.ibm.com/websphere/integration/wicserver/infocenter
只有在 RespositoryDirectory 為 <REMOTE> 時才適用。
指定是否要將錯誤記載到整合分配管理系統的日誌目的地。 記載到分配管理系統之日誌目的地亦會開啟電子郵件通知,在發生錯誤或嚴重錯誤時, 將針對 InterchangeSystem.cfg 檔案中指定的 MESSAGE_RECIPIENT 產生電子郵件訊息。
例如,當連接器失去與其應用程式的連線時, 若 LogAtInterChangeEnd 設為 true, 則電子郵件訊息會傳送至指定的訊息接件者。 預設值是 false。
控制程式緩衝區中的最大事件數目。 這個內容是由流程控制所使用,且只有在 RepositoryDirectory 內容值設為 <REMOTE> 時才能使用。
此值可以是介於 1 和 2147483647 之間的正整數。 預設值是 2147483647。
連接器訊息檔的名稱。此訊息檔的標準位置為產品目錄中的 \connectors\messages。 若訊息檔不在標準位置中,請使用絕對路徑來指定訊息檔案名稱。
若連接器訊息檔不存在,連接器會使用 InterchangeSystem.txt 作為訊息檔。這個檔案位於產品目錄中。
連接器用來監視重複事件的邏輯佇列。只有當 DeliveryTransport 內容值為 JMS,且 DuplicateEventElimination 設為 TRUE 時,才會使用它。
預設值是 CONNECTORNAME/MONITORQUEUE
只有在 RepositoryDirectory 為 <REMOTE> 時才有效。
指定連接器是否會使用自動及遠端重新啟動功能。這個功能會使用 MQ 觸發的「物件啟動常駐程式 (OAD)」, 在異常關機之後重新啟動連接器,或是從「系統監視器」啟動遠端連接器。
這個內容必須設為 true,才能啟用自動及遠端重新啟動功能。如需如何配置 MQ 觸發的 OAD 功能的相關資訊,請參閱安裝手冊 Windows 版 或 UNIX 版。
預設值是 false。
只有在 RepositoryDirectory 為 <REMOTE> 時才有效。
指定 MQ 觸發的 OAD 在連接器異常關閉之後自動嘗試重新啟動的最大次數。OADAutoRestartAgent 內容必須設為 true,這個內容才會生效。
預設值是 1000。
只有在 RepositoryDirectory 為 <REMOTE> 時才有效。
指定 MQ 觸發的 OAD 重試時間間隔的分鐘數。如果連接器代理程式沒有在這個重試時間間隔內重新啟動, 連接器控制程式就會要求 OAD 再次重新啟動連接器。OAD 重複這個重試程序的次數就是 OADMaxNumRetry 內容所指定的次數。OADAutoRestartAgent 內容必須設為 true,這個內容才會生效。
預設值是 10。
停止輪詢事件佇列的時間。 格式為 HH:MM,其中 HH 代表 0-23 時,MM 代表 0-59 秒。
您必須為這個內容提供有效的值。預設值是 HH:MM,但必須變更。
上次輪詢的結束和下次輪詢的開始之間會有間隔。 PollFrequency 可指定結束某個輪詢動作和開始下個輪詢動作之間的時間量 (毫秒)。 這不是輪詢動作之間的間隔。邏輯如下:
請將 PollFrequency 設為下列其中一個值:
預設值是 10000。
指定來自連接器應該輪詢的應用程式之項目數。如果配接器具有連接器特有內容以供輪詢 數量的設定使用,則連接器特有內容中所設定的值將會置換標準內容值。
FIX
電子郵件訊息也會被視為事件。當連接器針對電子郵件進行輪詢時,其行為如下。
輪詢一次 - 連接器會挑選 1. 訊息本文 (因為它也會被視為附件)。因為這個 MIME 類型沒有指定 DH, 所以它會忽略本文。 2. 連接器會處理第一個 PO 附件。這個 MIME 類型可以使用 DH, 所以它會將商業物件傳送到「視覺化測試連接器」。如果 3. 在 VTC 中再次接受,則 BO 應該無法通過 第二次輪詢 1. 連接器會處理第二個 PO 附件。這個 MIME 類型可以使用 DH, 所以它會將 BO 傳送到 VTC。 2. 在 VTC 中再次接受,現在第三個 PO 附件應該可以通過。 這是正確的行為。
開始輪詢事件佇列的時間。 格式為 HH:MM,其中 HH 代表 0-23 時,MM 代表 0-59 秒。
您必須為這個內容提供有效的值。預設值是 HH:MM,但必須變更。
整合分配管理系統用以將商業物件傳送至連接器的佇列。
預設值為 CONNECTOR/REQUESTQUEUE。
儲存庫的位置,連接器會從該處讀取用來儲存商業物件定義的 meta 資料之 XML 綱目文件。
如果整合分配管理系統為 ICS,此值必須設為 <REMOTE>,因為連接器是從 InterChange Server 儲存庫來取得這項資訊。
當整合分配管理系統為 WebSphere 訊息分配管理系統或 WAS 時, 此值必須設為<本端目錄>。
只有在 DeliveryTransport 為 JMS 時才適用,且只有在 RepositoryDirectory 為 <REMOTE> 時才需要。
指定 JMS 回應佇列,它會將回應訊息從連接器組織架構遞送到整合分配管理系統。如果整合分配管理系統為 ICS, 伺服器會傳送要求,並等待 JMS 回應佇列中的回應訊息。
指定連接器嘗試自我重新啟動的次數。 使用於並行連接器時,請指定主要連接器的特定應用程式元件嘗試重新啟動從屬連接器特定應用程式元件的次數。
預設值是 3。
指定連接器嘗試自我重新啟動的間隔時間(分鐘)。 使用於並行連接器時,請指定主要連接器的特定應用程式元件嘗試重新啟動 從屬連接器特定應用程式元件的間隔時間。 可能的值範圍從 1 到 2147483647。
預設值是 1。
僅限 WebSphere Message Brokers 及 WAS。
這個內容可讓您配置 JMS 標頭中領域名稱欄位的值。透過 JMS 傳輸將資料傳送到 WMQI 時,連接器組織架構會寫入 JMS 標頭資訊, 其中包含領域名稱及 mrm 的固定值。可配置的領域名稱可讓使用者追蹤 WMQI 分配管理系統處理訊息資料的方式。
標頭的範例如下:
<mcd><Msd>mrm</Msd><Set>3</Set><Type>Retek_POPhyDesc</Type><Fmt>CwXML</Fmt></mcd>
預設值為 mrm,但也可設為 xml。當 DeliveryTransport 設為 JMS 且 WireFormat 設為 CwXML 時,才會出現這個內容。
只有在 DeliveryTransport 為 JMS 且指定 ContainerManagedEvents 時才適用。
指定連接器組織架構的 JMS 來源佇列,以支援使用 JMS 事件儲存庫並且具有 JMS 功能的連接器的保證事件遞送。如需進一步資訊,請參閱ContainerManagedEvents。
預設值為 CONNECTOR/SOURCEQUEUE。
只有在 DeliveryTransport 為 JMS 時才適用。
將需要同步回應的要求訊息從連接器組織架構傳遞至分配管理系統。 只在連接器採用同步執行時,才需要這個佇列。 透過同步執行,連接器組織架構將訊息傳送至 SynchronousRequestQueue,然後在 SynchronousResponseQueue 等待來自分配管理系統的回應。 傳送至連接器的回應訊息伴隨一個符合原始訊息 ID 的交互關聯 ID。
預設值為 CONNECTORNAME/SYNCHRONOUSREQUESTQUEUE
只有在 DeliveryTransport 為 JMS 時才適用。
將回覆同步要求而送回的回應訊息從分配管理系統傳遞至連接器組織架構。 只在連接器採用同步執行時,才需要這個佇列。
預設值為 CONNECTORNAME/SYNCHRONOUSRESPONSEQUEUE
只有在 DeliveryTransport 為 JMS 時才適用。
指定連接器等待同步要求的回應時間(分鐘)。 若在指定的時間內未接收回應,則連接器會將原始同步要求訊息移至錯誤佇列中,隨伴著錯誤訊息。
預設值是 0。
傳輸的訊息格式。
僅限 WAS 整合分配管理系統。
指定連接器等待同步要求的回應時間(分鐘)。 若在指定的時間內未接收回應,則連接器會將原始同步要求訊息移至錯誤佇列中,隨伴著錯誤訊息。
預設值是 0。
僅限 WebSphere 訊息分配管理系統及 WAS 整合分配管理系統。
健全的內容可讓使用者以 XML 格式的商業物件定義來指定短的或長的名稱空間。