跳轉到主要內容
IBM MQ 端口透過 REST API 提供對 IBM MQ 佇列的存取。

核心功能

  • 透過 IBM MQ REST API 整合實現企業級訊息佇列功能
  • 支援具有 TLS 加密功能的佇列管理器(Queue Manager)連線
  • 支援雙向訊息處理,並具備可配置的身分驗證功能
  • 自動重試邏輯,可配置重試間隔及最大嘗試次數

概觀

IBM MQ 端口配置有特定的佇列,訊息可以推送到該佇列或從中檢索訊息。到達端口 交易 索引標籤的檔案作為訊息推送到佇列,而從佇列中提取的訊息作為檔案寫入 交易 索引標籤。每個端口例項只能配置一個佇列。

必要條件

要與 IBM MQ 建立連線,使用者至少必須具備:
  • 一臺 IBM MQ 伺服器,以及從 知行之橋 到該伺服器的清晰網路路徑
  • 至少有一個活動佇列的佇列管理器
知行軟件 不提供建立或配置 IBM MQ 伺服器的設定幫助或支援。有關 IBM MQ 伺服器設定的疑問,請參閱 IBM MQ 簡介 文件。

端口配置

本節包含所有可配置的端口屬性。

設定索引標籤

設定

與端口核心配置相關的設定。

TLS 設定

與傳輸安全相關的設定。

用戶端身分驗證

與針對遠端服務進行身分驗證相關的設定。

其他設定

未包含在先前類別中的設定。

進階頁面

訊息

訊息設定確定端口如何搜尋訊息並在處理後管理它們。

注意:以下設定已棄用,預設處於隱藏狀態。只有先前已啟用這些設定或將其配置為非預設值的端口才會顯示它們。若要保留成功處理的檔案副本,請在工作流程中右鍵單擊該端口,選擇顯示成功路徑,然後將成功路徑連線到 File 端口。

設定描述
儲存到已傳送資料夾(已棄用)將端口處理的檔案複製到 Sent 資料夾。預設停用。儲存到 Sent 資料夾中的檔案不受靜態加密保護。
已傳送資料夾方案(已棄用)按所選時間間隔對 Sent 資料夾中的檔案進行分組。僅在啟用儲存到已傳送資料夾時適用。

日誌

用於管理日誌建立和儲存的設定。

設定描述
日誌級別指定要記錄在端口日誌目錄中的資訊型別:
  • None - 不建立任何日誌。
  • Error - 僅當端口遇到錯誤時才建立日誌。
  • Warning - 僅當端口發出警告時才建立日誌。
  • Info - 記錄工作流程的一般資訊,包括任何錯誤和警告(如果適用)。
  • Debug - 記錄成功和失敗工作流程的詳細偵錯資訊。
  • Trace - 記錄成功和失敗工作流程的詳細跟蹤資訊。
請注意:Debug 和 Trace 級別的日誌可能會記錄敏感資訊,包括訊息內容和 SSL 憑證。儘管連線屬性(例如密碼)被遮蔽了,但在與您的組織外部共享它們之前,請檢視此級別的日誌以避免洩漏敏感資訊。
日誌資料夾結構指示端口根據選定的時間間隔將日誌資料夾中的檔案分組。例如,Weekly 選項指示端口每週建立一個新的子資料夾,並將該周的所有日誌儲存在該資料夾中。空白設定告訴端口將所有日誌直接儲存在日誌資料夾中。對於處理許多交易的端口,使用子資料夾有助於保持日誌的有序性並提高效能。
保留訊息副本指示端口在日誌目錄中儲存最新訊息副本的切換。請注意,端口每個子資料夾只保留一個訊息,並且端口在再次執行時會覆蓋以前儲存的訊息。

其他設定

雜項

特殊設定適用於特定用例。

設定描述
其他設定允許在以分號分隔的清單中配置隱藏的端口設定,例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用這些設定。

自動化索引標籤

自動化設定

與端口自動處理檔案相關的設定。

自動化狀態

效能

與端口資源分配相關的設定。

設定描述
最大工作執行緒數此端口上處理檔案時從執行緒池中消耗的最大工作執行緒數。如果設定,則會覆蓋 進階設定 頁面的 效能設定 部分的預設設定。
最大檔案數分配給端口的每個執行緒傳送的最大檔案數。如果設定,則會覆蓋 進階設定 頁面的 效能設定 部分的預設設定。

告警索引標籤

SLA 索引標籤

建立連線

建立連線需要以下設定:
  • 遠端主機
  • 遠端端口
  • 佇列管理器
  • 佇列
如果需要用戶端身分驗證,還必須設定以下設定:
  • 使用者名稱
  • 密碼
使用 測試連線 按鈕可以驗證與伺服器的成功連線。

傳送訊息

到達端口 交易 索引標籤的檔案將作為訊息推送到配置的佇列。檔案可以透過直接放置到此資料夾中,也可以從工作流程中較早的另一個端口到達此資料夾。 如需將訊息推送到多個佇列,需要設定多個 IBM MQ 端口。可以使用 Branch 端口 等端口將檔案路由到適當的 IBM MQ 端口。

接收訊息

可以將 IBM MQ 端口配置為自動輪詢遠端佇列以取得要下載的訊息。使用自動化索引標籤上的 接收自動化 和 接收 設定。啟用後,端口會等待指定的時間間隔,然後嘗試從佇列中檢索訊息並將其推送到輸出資料夾。 如果 IBM MQ 端口連線到流中的其他端口,下載的訊息將自動傳遞到下一個端口。否則,訊息將保留在輸出資料夾中。

宏

範例