如何設定 MQSC 配接器的接收埠和接收位置
您可以使用 BizTalk Server 管理主控台,設定 BizTalk Adapter for WebSphere MQ 的接收埠和接收位置。 您必須以 BizTalk Server Administrators 群組成員的帳戶登入。 此外,您必須在單一 Sign-On (SSO) 資料庫中擁有適當的許可權。
設定接收埠和接收位置
在[程式] 中,選取[Microsoft BizTalk Server],然後選取[BizTalk Server管理]。
在主控台樹中,依序展開 [BizTalk 群組]、[ 應用程式],然後選取您要建立接收埠的應用程式。
以滑鼠右鍵按一下 [接收埠],指向 [ 新增],然後按一下 [單向接收埠]。
在 [ 接收埠屬性] 視窗中,設定埠的屬性,然後按一下 [ 確定]。
在主控台樹中,以滑鼠右鍵按一下 [接收位置],指向 [ 新增],然後按一下 [單向接收位置]。
在 [ 選取接收埠 ] 視窗中,按一下您在上一個步驟中建立的接收埠,然後按一下 [ 確定]。
在 [ 接收位置屬性] 視窗中,選取 MQSC 配接器作為傳輸類型,然後按一下 [ 設定]。
在配接器的 [傳輸屬性 ] 視窗中,設定接收位置的屬性 (參考此程式結尾的資料表) 。
注意
設定接收位置需要下列屬性:
通道名稱 (這是區分大小寫的屬性。)
連接名稱
傳輸類型
佇列 (這是區分大小寫的屬性。)
佇列管理員 (這是區分大小寫的屬性。)
如果您未指定通道名稱屬性,您必須提供用戶端通道定義檔,以啟用安裝在BizTalk Server電腦上的 WebSphere MQ 用戶端,才能與遠端佇列管理員通訊。 如果您將安全通訊端層 (SSL) 設定為使用交易式傳訊,您也必須提供用戶端通道定義檔。 如需詳細資訊,請參閱 如何設定用戶端通道定義檔案。
當您完成設定屬性之後,請按一下 [確定]。
在 [接收位置屬性] 視窗的 [接收處理常式] 清單中,選取接收位置執行所在BizTalk Server主機的實例。
接收處理常式必須在此主控件上執行。
在 [ 接收管線 ] 清單中,選取接收管線,以用於接收此接收位置的訊息。
按一下 [確定]。
在 [ 接收位置 ] 視窗中,以滑鼠右鍵按一下 [ 名稱 ] 資料行中的 [接收位置],然後選取 [ 啟用]。
接收位置屬性
在 [傳輸屬性] 視窗的 [進階]區段中,您可以設定下列屬性。
使用 作法 標頭的資料位移 配接器會使用 MQSeries 標頭中的值, (MQMD、MQXQH、MQIIH 和 MQCIH 結構) 並填入BizTalk Server內容屬性中的對應值。 依照預設,配接器會從訊息內文移除這些 MQSeries 屬性。 設定為 [否 ] 以保留訊息本文中的屬性。
預設值: 是事件日誌錯誤閾值 針對特定錯誤狀況記錄的相同錯誤數目上限。 配接器會繼續運作,如果配接器復原,它會在應用程式記錄檔中記錄事件。
預設值:10已訂購 設定為[是] 以維護從 MQSeries 佇列接收訊息的順序,並提交至 BizTalk Server MessageBox。
針對傳送端,配接器會依照從訊息方塊接收訊息的順序,將訊息傳送至佇列。
設定為 [否 ] 以維護訊息順序。
對於傳送端排序,如果您未使用協調流程,您必須在傳送埠組態的 [傳輸進階選項] 中啟用 [已排序傳遞]。
對於接收端排序,如果您使用 Orchestration,您也必須在接收位置的協調流程中將 [已排序的傳遞 ] 屬性設定為 True 。
已排序的傳遞可能會降低效能;除非您需要已排序的傳遞,否則不建議這麼做。
預設值: 否發生錯誤時停止 設定為 [是 ] 以在發生錯誤時停止處理。 此選項會結束交易並在發生錯誤時停用接收位置。
預設值: 否以不可繼續擱置 設定為 [是 ] 以在發生錯誤時將訊息移至暫停的佇列,並指出是否可繼續。
啟用此值不會在發生錯誤時保留已排序的傳遞,但允許接收位置繼續接收訊息。
預設值: 否支援的交易 當設定為[是] 時,MQSC 配接器可與 WebSphere MQ Extended Transaction Client (Extended-Client) BizTalk Server 一起運作,以防止訊息遺失,以及保證訊息一次和一次傳遞。
當設定為 [否] 時,可能會重複訊息。 在此情況下,配接器會使用非交易式 WebSphere MQ Client (Base-Client) 與 MQSeries 整合。
預設值: 否等待間隔 當執行 MQGet 以從 MQSeries 佇列擷取訊息時,可以設定 [等候間隔] 的 MQGMO 選項。 如果佇列中沒有訊息,配接器會在關閉用戶端要求之前,等候指定的時間 (秒) 。 一旦訊息抵達佇列,配接器就會開始擷取訊息。
預設:3在傳輸屬性視窗的 [通道定義] 區段中,您可以設定下列屬性。
使用 作法 通道名稱 用戶端與 MQSeries 伺服器電腦上定義的通道名稱。 這必須是「伺服器連線」通道類型。
請注意,這是區分大小寫的屬性。連接名稱 MQSeries 伺服器的名稱,其中包含 MQSC 配接器接收訊息的佇列管理員和佇列。
針對 TCP 傳輸類型,指定的格式為 SERVERNAME (PORT) 。 埠號碼相當於與佇列管理員相關聯的接聽程式中所定義的埠號碼。
伺服器名稱也可以指定為 IP 位址。
針對 LU6.2,指定在主機整合伺服器中設定的 LU 名稱或 LU 集區名稱。心跳 檢查之間的秒數,以確認用戶端/伺服器連線是否正常運作。
預設值︰300密碼 嘗試使用遠端 MCA 起始安全 LU 6.2 會話時,MCA 可以使用的密碼。
這個選擇性屬性的初始值為 null。SSL 加密規格 定義 SSL 連線的單一 CipherSpec,該連線將由配接器中設定的端點使用。 WebSphere MQ SSL 通道定義的兩端都必須包含 屬性,此處指定的值應該符合通道伺服器端上指定的名稱。 此值是長度上限為 32 個字元的字串。
只有在針對 MQSeries 用戶端與遠端佇列管理員之間的通訊設定 SSL 時才需要。SSL 對等名稱 用來檢查憑證的辨別名稱 (也稱為 DN) ,以及 WebSphere MQ 通道另一端的對等佇列管理員或用戶端。 如果從對等接收的辨別名稱不符合此值,通道就不會啟動。
只有在針對 MQSeries 用戶端與佇列管理員之間的通訊設定 SSL 時才需要。傳輸類型 支援 TCP 和 LU6.2。
預設值:TCP使用者識別碼 MQSeries MCA 用來存取 MQSeries 資源的 MCA 使用者識別碼。
初始值為 null。 這是選擇性屬性。 當此屬性為空白時,MCA 會使用其預設使用者識別碼。在傳輸屬性視窗的MQSeries 區段中,您可以設定下列屬性。
使用 作法 字元集 從 MQSeries 佇列接收訊息時,訊息應該轉換成的字元集。 如果此屬性設定為 None 以外的值,配接器會在執行 MQGet 時設定 MQGMO CONVERT 選項。
無:不轉換。
UCS-2 和 UTF-16:轉換為這些字元集。 MQSeries 不會區分這些字元集。
UTF-8:轉換為 UTF-8 字元集。
預設值:None允許的分割 設定 MQSeries 以組合分割的訊息或就訊息原貌取得訊息。 使用 [沒有動作] 以不啟用分割的方式讀取 MQSeries 佇列的訊息。 使用 [完整訊息] 在傳送訊息到配接器之前,讓 MQSeries 組合分割的訊息。
預設值: 沒有動作在傳輸屬性視窗的[效能] 區段中,您可以設定下列屬性。
使用 作法 批次大小上限 以 KB 為單位的訊息批次大小上限。
這個屬性和 Batch 中的訊息上限 會一起運作,讓限制是介面卡最先到達的值。
預設值:100批次中的訊息上限 批次中的訊息數目上限,從 1 到 10,000。
此屬性和 批次大小上限 會一起運作,讓限制是介面卡第一個達到的值。
預設值:10執行緒 每個接收位置使用的執行緒數目。
預設值:2在傳輸屬性視窗的[佇列定義] 區段中,您可以設定下表所列的屬性。
使用 作法 佇列 配接器將接收 (MQGet) 訊息的 MQSeries 佇列。
支援傳輸佇列、本機佇列、別名佇列。
請注意,這是區分大小寫的屬性。佇列管理員 MQSeries 佇列管理員的名稱,其中包含配接器將從中擷取訊息的佇列。
支援叢集佇列管理員。
請注意,這是區分大小寫的屬性。按一下 [確定] 。
另請參閱
適用於 WebSphere MQ 的 BizTalk 配接器
如何設定用戶端通道定義檔
如何設定 MQSC 配接器的傳送埠