標準配置內容

本章節會列出及定義每一個標準連接器的配置內容。

AdminInQueue

整合分配管理系統用以將管理訊息傳送至連接器的佇列。

預設值是 CONNECTORNAME/ADMININQUEUE

AdminOutQueue

連接器用以將管理訊息傳送至整合分配管理系統的佇列。

預設值是 CONNECTORNAME/ADMINOUTQUEUE

AgentConnections

僅當 RepositoryDirectory 為 <REMOTE> 時適用。

AgentConnections 內容會控制由 orb.init[] 所開啟的 ORB 連線數目。

依預設,這個內容的值設定為 1,不需要變更此預設值。

AgentTraceLevel

特定應用程式元件的追蹤訊息層次。 預設值是 0。連接器會遞送已設定之追蹤層次或更低層次上所有可用的追蹤訊息。

ApplicationName

連接器的應用程式的獨特識別名稱。 系統管理者使用此名稱來監督 WebSphere 商業整合系統環境。 這個內容必須有一個值,您才可執行連接器。

BrokerType

識別您目前使用的整合分配管理系統類型。選項為 ICS、WebSphere 訊息分配管理系統 (WMQI、WMQIB 或 WBIMB) 或 WAS。

CharacterEncoding

指定從字元(例如,英文字母、數值表示法或標點符號)對映到數值所用的字碼集。

註:
Java 型連接器不使用這個內容。C++ 連接器目前對此內容使用值 ascii7

依預設,下拉清單中僅顯示一部份受支援的字元編碼。 若要於下拉清單中加入其他支援的值,您必須以手動方式修改產品目錄中的 \Data\Std\stdConnProps.xml 檔案。 如需詳細資訊,請參閱「連接器配置程式」的附錄。

ConcurrentEventTriggeredFlows

僅當 RepositoryDirectory 為 <REMOTE> 時適用。

決定連接器可同時處理多少商業物件,以遞送事件。 請將這個屬性的值設為您要同時對映和遞送的商業物件數目。 例如,將這個內容的值設為 5 可同時處理五個商業物件。 預設值是 1

將這個內容設為大於 1 的值可讓來源應用程式的連接器同時對映多個事件商業物件, 且同時遞送至多個協同作業實例。 尤其當商業物件使用複式對映時,可加速將商業物件遞送至整合分配管理系統。增加商業物件至協同作業實例的到達率可改善系統的整體效能。

實作整個流程(從來源應用程式到目的地應用程式)的並行處理,您必須:

ConcurrentEventTriggeredFlows 內容不影響連接器輪詢(單一執行緒且序列化執行)。

ContainerManagedEvents

這個內容可讓包含 JMS 事件儲存庫且具有 JMS 功能的連接器提供保證事件遞送, 在此情形下,會將事件從來源佇列移除並放置到目的地佇列中成為單一 JMS 交易。

預設值為無值

當 ContainerManagedEvents 設為 JMS 時,您必須配置下列內容來啟用保證事件遞送:

您也必須以 MimeType、DHClass 及 DataHandlerConfigMOName (選用性) 內容來配置資料處理常式。 若要設定這些值,請使用「連接器配置程式」中的資料處理常式標籤。 唯有當您已將 ContainerManagedEvents 設為 JMS 後,「資料處理常式」標籤下的值欄位才會顯示。

註:
當 ContainerManagedEvents 設為 JMS 時, 連接器呼叫其 pollForEvents() 方法, 因此會停用該方法的功能。

只有在 DeliveryTransport 內容設為 JMS 這個值時, 這個內容才會出現。

ControllerStoreAndForwardMode

僅當 RepositoryDirectory 為 <REMOTE> 時適用。

設定連接器控制程式在偵測到目的地特定應用程式元件無法使用之後的行為。

若這個內容設為 true,且當事件到達 ICS 時無可用的目的地特定應用程式元件, 則連接器控制程式會暫停對特定應用程式元件的要求。 當特定應用程式元件恢復運作時,控制程式就會轉遞要求。

但是當連接器控制程式轉遞服務呼叫要求之後,若目的地應用程式的特定應用程式元件無法使用, 則連接器控制程式會讓此要求失敗。

若這個內容設為 false,則當連接器控制程式偵測到目的地特定應用程式元件無法使用時, 就會立即讓所有服務呼叫要求失敗。

預設值是 true

ControllerTraceLevel

僅當 RepositoryDirectory 為 <REMOTE> 時適用。

連接器控制程式的追蹤訊息層次。 預設值是 0

DeliveryQueue

僅當 DeliveryTransport 為 JMS 時適用。

連接器用以將商業物件傳送至整合分配管理系統的佇列。

預設值為 CONNECTORNAME/DELIVERYQUEUE

DeliveryTransport

指定遞送事件的傳輸機制。 可能值為 MQ (若為 WebSphere MQ)、IDL (若為 CORBA IIOP) 或 JMS (若為 Java Messaging Service)。

若對 DeliveryTransport 內容配置的值為 MQIDL,則連接器會透過 CORBA IIOP 來傳送服務呼叫要求和管理訊息。

WebSphere MQ 及 IDL

在事件遞送傳輸機制上使用 WebSphere MQ 來取代 IDL, 除非您只能有一個產品。WebSphere MQ 提供下列優於 IDL 的優點:

JMS

透過「Java 訊息服務 (JMS)」來讓連接器與用戶端連接器組織架構彼此通信。

若您選取 JMS 作為遞送傳輸,則「連接器配置程式」中會顯示額外的 JMS 內容,例如 jms.MessageBrokerName、 jms.FactoryClassNamejms.Password 以及 jms.UserName。此傳輸需要其中的前兩個內容。

重要事項:
若您於下列環境中對連接器使用 JMS 傳輸機制, 可能有記憶體方面的限制:

此環境中,由於 WebSphere MQ 用戶端的記憶體使用情形, 您可能難以啟動連接器控制程式(在伺服器端)和連接器(在用戶端)。 若您的安裝架構使用小於 768M 的程序資料堆大小,則 IBM 建議您設定:

DuplicateEventElimination

將這個內容設為 true,則可讓具有 JMS 功能的連接器確保不會遞送重複事件到遞送佇列中。 若要使用這個功能,連接器必須有一個唯一事件識別碼設為應用程式特定程式碼中商業物件的 ObjectEventId 屬性。 這會在連接器開發期間內完成。

這個內容亦可設為 false

註:
DuplicateEventElimination 設為 true 時,您也必須配置 MonitorQueue 內容,才能啟用保證事件遞送。

FaultQueue

若連接器在處理訊息時發生錯誤, 則連接器會將訊息移至這個內容所指定的佇列,伴隨著狀態指示器和問題說明。

預設值是 CONNECTORNAME/FAULTQUEUE

JvmMaxHeapSize

代理程式資料堆大小的最大值 (以 MB 為單位)。只有當 RepositoryDirectory 值設為 <REMOTE> 時,才能使用這個內容。

預設值是 128m。

JvmMaxNativeStackSize

代理程式原生堆疊大小的最大值 (以 KB 為單位)。 只有當 RepositoryDirectory 值設為 <REMOTE> 時,才能使用這個內容。

預設值是 128k。

JvmMinHeapSize

代理程式資料堆大小的最小值 (以 MB 為單位)。只有當 RepositoryDirectory 值設為 <REMOTE> 時,才能使用這個內容。

預設值是 1m。

jms.FactoryClassName

指定為 JMS 提供者建立實例的類別名稱。當選擇 JMS 作為遞送傳輸機制 (DeliveryTransport) 時,您必須設定這個連接器內容。

預設值是 CxCommon.Messaging.jms.IBMMQSeriesFactory

jms.MessageBrokerName

指定用於 JMS 提供者的分配管理系統名稱。當選擇 JMS 作為遞送傳輸機制 (DeliveryTransport) 時,您必須設定這個連接器內容。

預設值是 crossworlds.queue.manager

jms.NumConcurrentRequests

指定可同時傳送至連接器的並行服務呼叫要求最大數目。 一旦到達這個最大值時,新的服務呼叫會暫停執行, 等到另一個要求完成之後才會繼續進行。

預設值是 10。

jms.Password

指定 JMS 提供者的密碼。 這個內容的值是選用的。

沒有預設值。

jms.UserName

指定 JMS 提供者的使用者名稱。這個內容的值是選用的。

沒有預設值。

ListenerConcurrency

當 ICS 為整合分配管理系統時,這個內容可支援 MQ 接聽器中的多緒作業。 它可以批次方式將多個事件寫入資料庫,藉此提高系統效能。 預設值是 1。

這個內容僅適用於使用 MQ 傳輸的連接器。 DeliveryTransport 內容必須設為 MQ

Locale

指定語言碼、國家或地區,及相關聯的字碼集(選用)。 這個內容的值決定文化慣例,例如資料的分頁和排序、 日期和時間格式,及貨幣規格使用的符號。

語言環境名稱的格式如下:

ll_TT.codeset
 

其中:

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

LogAtInterchangeEnd

僅當 RespositoryDirectory 為 <REMOTE> 時適用。

指定是否要將錯誤記載到整合分配管理系統的日誌目的地。 記載到分配管理系統之日誌目的地亦會開啟電子郵件通知,在發生錯誤或嚴重錯誤時, 將針對 InterchangeSystem.cfg 檔案中指定的 MESSAGE_RECIPIENT 產生電子郵件訊息。

例如,當連接器失去與其應用程式的連線時, 若 LogAtInterChangeEnd 設為 true, 則電子郵件訊息會傳送至指定的訊息接件者。 預設值是 false

MaxEventCapacity

控制程式緩衝區中的最大事件數目。 這個內容是由流程控制所使用,且只有在 RepositoryDirectory 內容值設為 <REMOTE> 時才能使用。

此值可以是介於 1 和 2147483647 之間的正整數。 預設值是 2147483647。

MessageFileName

連接器訊息檔的名稱。此訊息檔的標準位置為 \connectors\messages。 若訊息檔不在標準位置中,請使用絕對路徑來指定訊息檔案名稱。

若連接器訊息檔不存在,連接器會使用 InterchangeSystem.txt 作為訊息檔。這個檔案位於產品目錄中。

註:
若要判斷某個特定連接器是否擁有它自己的訊息檔案, 請參閱個別的配接器使用手冊。

MonitorQueue

連接器用來監視重複事件的邏輯佇列。只有當 DeliveryTransport 內容值為 JMS,且 DuplicateEventElimination 設為 TRUE 時,才會使用它。

預設值是 CONNECTORNAME/MONITORQUEUE

OADAutoRestartAgent

僅當 RepositoryDirectory 為 <REMOTE> 時有效。

指定連接器是否使用自動及遠端重新啟動功能。此功能使用 MQ 觸發的「物件啟動常駐程式 (OAD)」,以在異常關閉後重新啟動連接器,或從「系統監視器」啟動遠端連接器。

必須將這個內容設為 true,才能啟用自動及遠端重新啟動功能。如需如何配置 MQ 觸發之 OAD 功能的資訊,請參閱安裝手冊 Windows 版UNIX 版

預設值是 false

OADMaxNumRetry

僅當 RepositoryDirectory 為 <REMOTE> 時有效。

指定 MQ 觸發的 OAD 在連接器異常關閉之後自動嘗試重新啟動的次數上限。 必須將 OADAutoRestartAgent 內容設為 True,這個內容才會生效。

預設值是 1000

OADRetryTimeInterval

僅當 RepositoryDirectory 為 <REMOTE> 時有效。

指定 MQ 觸發之 OAD 的重試時間間隔的分鐘數。如果連接器代理程式未在此重試時間間隔內重新啟動,則連接器控制程式會要求 OAD 再次重新啟動連接器代理程式。OAD 會重複此重試程序, 直到達到 OADMaxNumRetry 內容所指定的次數為止。必須將 OADAutoRestartAgent 內容設為 True,這個內容才會生效。

預設值是 10

PollEndTime

停止輪詢事件佇列的時間。 格式為 HH:MM,其中 HH 代表 0-23 時,MM 代表 0-59 秒。

您必須為這個內容提供有效的值。預設值是 HH:MM,但必須變更。

PollFrequency

輪詢動作之間的間隔時間。請將 PollFrequency 設為下列其中一個值:

預設值是 10000

重要事項:
有些連接器會限制這個內容的使用。 若要判斷特定的連接器是否會限制,請參閱配接器手冊的安裝和配置章節。

PollQuantity

指定來自連接器應該輪詢的應用程式之項目數。如果配接器具有連接器特有內容以供輪詢數量的設定使用, 則連接器特有內容中所設定的值將會置換標準內容值。

PollStartTime

開始輪詢事件佇列的時間。 格式為 HH:MM,其中 HH 代表 0-23 時,MM 代表 0-59 秒。

您必須為這個內容提供有效的值。預設值是 HH:MM,但必須變更。

RequestQueue

整合分配管理系統用以將商業物件傳送至連接器的佇列。

預設值是 CONNECTOR/REQUESTQUEUE

RepositoryDirectory

儲存庫的位置,連接器會從該處讀取用來儲存商業物件定義的 meta 資料之 XML 綱目文件。

如果整合分配管理系統為 ICS,此值必須設為 <REMOTE>,因為連接器是從 InterChange Server 儲存庫來取得這項資訊。

當整合分配管理系統為 WebSphere 訊息分配管理系統或 WAS 時,此值必須設為 <本端目錄>。

ResponseQueue

僅當 DeliveryTransport 為 JMS 時適用,且僅當 RepositoryDirectory 為 <REMOTE> 時需要。

指定 JMS 回應佇列,它會將回應訊息從連接器組織架構遞送到整合分配管理系統。當整合分配管理系統為 ICS 時,伺服器會傳送要求,並等待 JMS 回應佇列中的回應訊息。

RestartRetryCount

指定連接器嘗試自我重新啟動的次數。 使用於並行連接器時,請指定主要連接器的特定應用程式元件嘗試重新啟動從屬連接器特定應用程式元件的次數。

預設值是 3

RestartRetryInterval

指定連接器嘗試自我重新啟動的間隔時間(分鐘)。 使用於並行連接器時,請指定主要連接器的特定應用程式元件嘗試重新啟動 從屬連接器特定應用程式元件的間隔時間。 可能值的範圍從 1 到 2147483647。

預設值是 1

SourceQueue

僅當 DeliveryTransport 為 JMS 並且指定了 ContainerManagedEvents 時,才適用。

指定連接器組織架構的 JMS 來源佇列,以支援使用 JMS 事件儲存庫並且具有 JMS 功能的連接器的保證事件遞送。如需進一步資訊,請參閱ContainerManagedEvents

預設值為 CONNECTOR/SOURCEQUEUE

SynchronousRequestQueue

僅當 DeliveryTransport 為 JMS 時適用。

將需要同步回應的要求訊息從連接器組織架構傳遞至分配管理系統。 只在連接器採用同步執行時,才需要這個佇列。 透過同步執行,連接器組織架構將訊息傳送至 SynchronousRequestQueue,然後在 SynchronousResponseQueue 等待來自分配管理系統的回應。 傳送至連接器的回應訊息伴隨一個符合原始訊息 ID 的交互關聯 ID。

預設值是 CONNECTORNAME/SYNCHRONOUSREQUESTQUEUE

SynchronousResponseQueue

僅當 DeliveryTransport 為 JMS 時適用。

將回覆同步要求而送回的回應訊息從分配管理系統傳遞至連接器組織架構。 只在連接器採用同步執行時,才需要這個佇列。

預設值是 CONNECTORNAME/SYNCHRONOUSRESPONSEQUEUE

SynchronousRequestTimeout

僅當 DeliveryTransport 為 JMS 時適用。

指定連接器等待同步要求的回應時間(分鐘)。 若在指定的時間內未接收回應,則連接器會將原始同步要求訊息移至錯誤佇列中,隨伴著錯誤訊息。

預設值是 0。

WireFormat

傳輸的訊息格式。

WsifSynchronousRequest 逾時

僅限 WAS 整合分配管理系統。

指定連接器等待同步要求的回應時間(分鐘)。 若在指定的時間內未接收回應,則連接器會將原始同步要求訊息移至錯誤佇列中,隨伴著錯誤訊息。

預設值是 0。

XMLNameSpaceFormat

僅限 WebSphere 訊息分配管理系統及 WAS 整合分配管理系統。

可讓使用者以 XML 格式指定商業物件定義之長短名稱空間的強大內容。

預設值是 short

Copyright IBM Corp. 1997, 2003