連接器有兩種配置內容類型:標準配置內容及配接器特有的配置內容。執行配接器之前,您必須先設定這些內容的值。
您可以使用「連接器配置程式」來配置連接器內容:
標準配置內容提供所有連接器使用的資訊。 請參閱附錄 A, 連接器的標準配置內容,以取得這些內容的文件。當您設定「連接器配置程式」中的配置內容時,要使用 BrokerType 內容指定分配管理系統。設定它之後,分配管理系統相關的內容會出現在「連接器配置程式」視窗中。如需詳細資訊,請參閱附錄 B, 連接器配置程式。
連接器特有的配置內容提供 WebSphere MQ Workflow 連接器所需的資訊。亦提供一種方法,以變更連接器代理程式內的靜態資訊或邏輯,而不必重新編碼及重新建置代理程式。
表 4 列出了連接器的特有配置內容。請參閱後續幾節的內容說明。
名稱 | 可能值 | 預設值 | 必要的 |
---|---|---|---|
ApplicationPassword | 登入密碼 | password | 否 |
ApplicationUserID | 登入使用者 ID | ADMIN | 否 |
ArchiveQueue | 順利處理的訊息複本將傳送至此佇列 | MQWFCONN.ARCHIVE | 否 |
MQSeriesCCSID | 佇列管理程式連線的字集 | null | 否 |
MQSeriesChannel | MQ 伺服器連接器通道 | FMCQM.CL.TCP | 是 |
DataHandlerClassName | 資料處理常式類別名稱 | com.crossworlds .DataHandlers. text.xml | 否 |
DataHandlerConfigMO | 資料處理常式 meta 物件 | MO_DataHandler _Default | 是 |
DataHandlerMimeType | 檔案的 MIME 類型 | text/xml | 否 |
ErrorQueue | 含有錯誤訊息的佇列 | MQWFCONN.ERROR | 否 |
MQSeriesHostName | WebSphere MQ Workflow 佇列管理程式的機器的名稱 | 空白 | 是 |
InDoubtEvents | FailOnStartup Reprocess IgnoreLogError | Reprocess | 否 |
InputQueue | 輪詢是否有 WebSphere MQ Workflow 要求的佇列 | CWLDINPUTQ | 是 |
InProgressQueue | 「進行中」事件佇列 | MQWFCONN.IN_ PROGRESS | 是 |
JavaCorbaApi | 當其值設為 true 時啟用 Java CORBA API | false | 否 |
OutputQueue | 向 WebSphere MQ Workflow 發出要求的佇列 | FMC.FMCGRP.EXE.
XML | 是 |
PollQuantity | 從輸入佇列擷取的訊息數目 | 1 | 否 |
MQSeriesPort | 為 WebSphere MQ (MQSeries) 接聽器所建立的埠 | 14000 | 是 |
ReplyToQueue | 當連接器發出要求時,回應訊息將傳送到的佇列 | MQWFCONN.REPLYTO | 否 |
UnsubscribedQueue | 未訂閱的訊息將傳送至這個佇列 | MQWFCONN. UNSUBSCRIBE | 否 |
MQSeriesQueueManager | Workflow 的佇列管理程式 | FMC (如果留為空白,
則會使用預設佇列管理程式) | 否 |
|
|
|
|
BOPrefix | 若為訂閱遞送,資料結構的名稱會附加到此字首,以判斷最上層商業物件的名稱。 | MQWF_ | 否 |
WorkflowSystemName | WebSphere MQ Workflow 系統的名稱,連接器會與其連結,以取得工作流程程序的直接控制。 | FMCSYS | 否 |
WorkflowSystemGroup | WebSphere MQ Workflow 系統群組的名稱,連接器會建立於此,以取得工作流程程序的直接控制。 | FMCGRP | 否 |
WorkflowAgentLocatorPolicy | 指定 WebSphere MQ Workflow 伺服器的本端或遠端連線。LOC 連接器會連接到在本端機器上執行的伺服器。OSA 連接器會連接到遠端的 WebSphere MQ Workflow 伺服器 | LOC | 否 |
WorkflowAgentName | WebSphere MQ Workflow CORBA 代理程式的名稱。 |
| 否 |
登入 WebSphere MQ 時搭配 UserID 一起使用的密碼。
預設值 = password。
如果將 ApplicationPassword 留為空白或移除,則連接器會使用 WebSphere MQ Workflow 提供的預設密碼。
由連接器傳遞給 WebSphere MQ Workflow 伺服器,以授權連線 (針對 Java 直接連結的 API)。這個內容還用於:
如果將 ApplicationUserID 留為空白或移除,則連接器將使用 WebSphere MQ Workflow 提供的預設使用者 ID。
您可以在這個內容或 Meta 物件屬性 UserID 中指定使用者 ID。在任一情況中,ApplicationUserID 都必須:
預設值 =ADMIN。
順利處理的訊息複本將傳送至這個佇列。
預設值 = MQWFCONN.ARCHIVE
WebSphere MQ Workflow 伺服器連接器通道,連接器透過此通道與 WebSphere MQ 通訊。
預設值 =FMCQM.CL.TCP
如果將 Channel 留為空白或移除,則連接器將使用 WebSphere MQ Workflow 提供的預設伺服器通道。
於訊息和商業物件之間轉換時所用的資料處理常式類別。
預設值 = com.crossworlds.DataHandlers.text.xml
傳送至資料處理常式以提供配置資訊的 meta 物件。
預設值 = MO_DataHandler_Default
可讓您依據特定 MIME 類型以要求資料處理常式。
預設值 = text/xml
無法處理的訊息將傳送至這個佇列。
預設值 = MQWFCONN.ERROR
掌管 WebSphere MQ Workflow 的伺服器名稱。
預設值 = 空白
指定如何處理由於非預期的連接器關閉而未處理完成的進行中事件。若於起始設定期間發現進行中佇列有事件,請採取下列四種動作之一:
預設值 = Reprocess
連接器輪詢是否有新訊息的訊息佇列。
預設值 = CWLDINPUTQ
進行中事件佇列。
預設值 = MQWFCONN.IN_PROGRESS
需要啟用 Java CORBA API,以與 WebSphere MQ Workflow 3.2.2 搭配使用。如果為 false,則連接器會支援 XML API,以與 WebSphere MQ Workflow 3.3.2 及較高版本搭配使用。如果您正使用 WebSphere MQ Workflow 3.4 或更新版本,則這個內容必須為 false。
預設值 = false
用於連接到 WebSphere MQ Workflow 之佇列管理程式的 CCSID。此值應與 WebSphere MQ Workflow 佇列管理程式的 CCSID 內容相符。
預設值 = 空白 (如果留為空白,則會將其視為 819)
您可能需要變更 CCSID,以支援選取的字元。當您進行變更時,您必須變更 CCSID 連接器特有的內容,以及 WebSphere MQ Workflow 佇列的 CCSID。
向 MQSeries Workflow 發出要求的佇列。
預設值 = FMC.FMCGRP.EXE.XML
從輸入佇列擷取的訊息數目。
預設值 =1
為 MQSeries (WebSphere MQ) 接聽器所建立的埠。
預設值 = 14000
當連接器發出要求時,回應訊息將傳送到的佇列。
預設值 = MQWFCONN.REPLYTO
未訂閱的訊息將傳送至此佇列。 連接器將訊息傳送到此佇列內容的條件是:
預設值 = MQWFCONN.UNSUBSCRIBE
WebSphere MQ Workflow 的佇列管理程式。
預設值 = FMC (如果留為空白,則會使用預設佇列管理程式)
若為訂閱遞送,資料結構的名稱會附加到此字首。資料結構會判斷交易之最上層商業物件的名稱。
預設值 = MQWF_
WebSphere MQ Workflow 系統的名稱,當連接器需要直接控制工作流程程序時,會建立與此系統的連線。
預設值 = FMCSYS
WebSphere MQ Workflow 系統群組的名稱,當連接器需要直接控制工作流程程序時,會建立與此系統群組的連線。
預設值 = FMCGRP
指定連接器如何建立與內容 WorkflowSystemName 及 WorkflowSystemGroup 識別之 WebSphere MQ Workflow 伺服器的連線。可能的值為:
預設值 = LOC
WebSphere MQ Workflow CORBA 代理程式的名稱。