連接器配置

連接器有兩種配置內容類型:標準配置內容及配接器特有的配置內容。執行配接器之前,您必須先設定這些內容的值。

您可以使用「連接器配置程式」來配置連接器內容:

標準連接器內容

標準配置內容提供所有連接器使用的資訊。 請參閱附錄 A, 連接器的標準配置內容,以取得這些內容的文件。當您設定「連接器配置程式」中的配置內容時,要使用 BrokerType 內容指定分配管理系統。設定它之後,分配管理系統相關的內容會出現在「連接器配置程式」視窗中。如需詳細資訊,請參閱附錄 B, 連接器配置程式

連接器特有內容

連接器特有的配置內容提供 WebSphere MQ Workflow 連接器所需的資訊。亦提供一種方法,以變更連接器代理程式內的靜態資訊或邏輯,而不必重新編碼及重新建置代理程式。

表 4 列出了連接器的特有配置內容。請參閱後續幾節的內容說明。

表 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 代理程式的名稱。

ApplicationPassword

登入 WebSphere MQ 時搭配 UserID 一起使用的密碼。

預設值 = password。

如果將 ApplicationPassword 留為空白或移除,則連接器會使用 WebSphere MQ Workflow 提供的預設密碼。

ApplicationUserID

由連接器傳遞給 WebSphere MQ Workflow 伺服器,以授權連線 (針對 Java 直接連結的 API)。這個內容還用於:

如果將 ApplicationUserID 留為空白或移除,則連接器將使用 WebSphere MQ Workflow 提供的預設使用者 ID。

您可以在這個內容或 Meta 物件屬性 UserID 中指定使用者 ID。在任一情況中,ApplicationUserID 都必須:

註:
ApplicationUserID 未指定於 WebSphere MQ Workflow 使用之 WebSphere MQ 伺服器連線通道的 MCA 內容中。依預設,WebSphere MQ Workflow 會為這個內容指定使用者 fmc,這會導致配接器與 WebSphere MQ Workflow 應用程式之間交換的所有訊息都使用 fmc 使用者的權限來傳送。在您的 WebSphere MQ 伺服器連線通道內容中清除此值, 以便可使用您在此連接器特有內容中指定的 ApplicationUserID 傳送訊息。

預設值 =ADMIN。

ArchiveQueue

順利處理的訊息複本將傳送至這個佇列。

預設值 = MQWFCONN.ARCHIVE

MQSeriesChannel

WebSphere MQ Workflow 伺服器連接器通道,連接器透過此通道與 WebSphere MQ 通訊。

預設值 =FMCQM.CL.TCP

如果將 Channel 留為空白或移除,則連接器將使用 WebSphere MQ Workflow 提供的預設伺服器通道。

DataHandlerClassName

於訊息和商業物件之間轉換時所用的資料處理常式類別。

預設值 = com.crossworlds.DataHandlers.text.xml

DataHandlerConfigMO

傳送至資料處理常式以提供配置資訊的 meta 物件。

預設值 = MO_DataHandler_Default

DataHandlerMimeType

可讓您依據特定 MIME 類型以要求資料處理常式。

預設值 = text/xml

ErrorQueue

無法處理的訊息將傳送至這個佇列。

預設值 = MQWFCONN.ERROR

MQSeriesHostName

掌管 WebSphere MQ Workflow 的伺服器名稱。

預設值 = 空白

InDoubtEvents

指定如何處理由於非預期的連接器關閉而未處理完成的進行中事件。若於起始設定期間發現進行中佇列有事件,請採取下列四種動作之一:

預設值 = Reprocess

InputQueue

連接器輪詢是否有新訊息的訊息佇列。

預設值 = CWLDINPUTQ

InProgressQueue

進行中事件佇列。

預設值 = MQWFCONN.IN_PROGRESS

JavaCorbaApi

需要啟用 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

MQSeriesCCSID

用於連接到 WebSphere MQ Workflow 之佇列管理程式的 CCSID。此值應與 WebSphere MQ Workflow 佇列管理程式的 CCSID 內容相符。

預設值 = 空白 (如果留為空白,則會將其視為 819)

您可能需要變更 CCSID,以支援選取的字元。當您進行變更時,您必須變更 CCSID 連接器特有的內容,以及 WebSphere MQ Workflow 佇列的 CCSID。

變更 MQSeries CCSID 連接器內容
  1. 在「系統管理程式」中,按兩下 MQWF 連接器。「連接器設計程式 -- MQWorkflowConnector」會開啟。
  2. 按一下「應用程式配置內容」標籤。
  3. 在 MQSeriesCCSID 內容中輸入新值 (如 『943』)。
  4. 重新啟動連接器。
  5. 重新啟動 ICS (建議)。

變更 MQSeries CCSID 佇列內容
  1. 在命令提示模式中執行 RUMMQSC FMCQM。
  2. 輸入 ALTER QMGR CCSID (new_value) 並按 Enter 鍵。
  3. 輸入 END 並按 Enter 鍵。

OutputQueue

向 MQSeries Workflow 發出要求的佇列。

預設值 = FMC.FMCGRP.EXE.XML

PollQuantity

從輸入佇列擷取的訊息數目。

預設值 =1

MQSeriesPort

為 MQSeries (WebSphere MQ) 接聽器所建立的埠。

預設值 = 14000

ReplyToQueue

當連接器發出要求時,回應訊息將傳送到的佇列。

註:
當傳送訊息至 WebSphere MQ Workflow 應用程式時,連接器會將資料移入離埠訊息標頭中的 ReplyToQueue 欄位,而不論連接器是否預期回應。當無效的商業資料傳送到 MQ Workflow 應用程式時,這可以協助識別問題。

預設值 = MQWFCONN.REPLYTO

UnsubscribedQueue

未訂閱的訊息將傳送至此佇列。 連接器將訊息傳送到此佇列內容的條件是:

預設值 = MQWFCONN.UNSUBSCRIBE

MQSeriesQueueManager

WebSphere MQ Workflow 的佇列管理程式。

預設值 = FMC (如果留為空白,則會使用預設佇列管理程式)

BOPrefix

若為訂閱遞送,資料結構的名稱會附加到此字首。資料結構會判斷交易之最上層商業物件的名稱。

預設值 = MQWF_

WorkflowSystemName

WebSphere MQ Workflow 系統的名稱,當連接器需要直接控制工作流程程序時,會建立與此系統的連線。

預設值 = FMCSYS

WorkflowSystemGroup

WebSphere MQ Workflow 系統群組的名稱,當連接器需要直接控制工作流程程序時,會建立與此系統群組的連線。

預設值 = FMCGRP

WorkflowAgentLocatorPolicy

指定連接器如何建立與內容 WorkflowSystemNameWorkflowSystemGroup 識別之 WebSphere MQ Workflow 伺服器的連線。可能的值為:

預設值 = LOC

註:
若要支援 IBM Java ORB 的用戶端連線,需要修改 start_MQWorkflow.bat (Windows) 或 start_MQWorkflow.sh (UNIX) 檔案。開啟適當的 start_MQWorkflow 檔案並向下捲動直到您看到以「Step 3...」開頭的註解及其後跟隨的所有字行, 並按所提供指示來調整路徑。這可確保載入正確的 IBM Java ORB 程式庫,還可確保在起始設定期間 WebSphere MQ Workflow 用戶端程式庫使用正確的 IBM Java ORB 程式庫。此修改不會影響您與 InterChange Server 的通訊。

WorkflowAgentName

WebSphere MQ Workflow CORBA 代理程式的名稱。

預設值 = 無

Copyright IBM Corp. 1997, 2003