IBM Cloud Docs
使用「 MQ 探險家」及 runmqsc 指令行來管理佇列管理程式

使用「 MQ 探險家」及 runmqsc 指令行來管理佇列管理程式

本手冊說明如何使用「 MQ 探險家」應用程式及 runmqsc 指令行介面來管理 IBM MQ on Cloud 佇列管理程式。

MQ 探險家:

MQ Explorer 是一個以 Eclipse 為基礎的工具，用於管理在所選機器上安裝的 IBM MQ，並且使用用戶端連線以遠端方式連線至一個以上的佇列管理程式。 Windows 及 Linux 64 位元環境具有原生安裝程式，可以透過 Docker 容器在 Mac OS 上執行，如下面的必要條件所述。

在撰寫時， Mac OS 上 MQ 瀏覽器的 Eclipse 外掛程式不支援 TLS 連線。 比 9.2.1 版修訂 1 更新的 MQ on Cloud 佇列管理程式的管理通道將會啟用 TLS。 這些應該從 Linux 或 Windows 管理。

runmqsc

runqmsc 是 MQ Client 軟體組的一部分，這是一個指令行介面 (CLI) 工具，容許您透過指令行或在 Script 檔中執行一系列預先定義的步驟來自動配置 MQ 佇列管理程式。 許多作業系統（包括 Windows 和 Linux）上都支援此工具（但目前在 Mac OS 上不支援）。

您可以從 MQ 用戶端使用「 MQ 探險家」或 runmqsc 來執行許多動作。 您可以

  • 連接至佇列管理程式
  • 建立新的佇列
  • 將訊息放置到佇列上
  • 刪除佇列

此外，在「 MQ 探險家」上，您可以 browse a queue to view messages 在 runmqsc 指令行中，您也可以 get messages from a queue

開始之前

  • 現有的 IBM MQ Explorer 安裝。 您可以從這裡取得 Windows 與 Linux 的下載和安裝指示，以及從這裡取得 Mac OS 的下載和安裝指示。 或
  • 在您自己的機器上已有現有的 IBM MQ Client 安裝。
  • 從這裡下載用戶端。
    • 按一下最新可用版本 CD 用戶端旁的 HTTP 鏈結，會讓您前往修正程式中心。 從那裡，您可以搜尋及選取適用於您作業系統平台的適當 Redist（可重新配送）用戶端組合。 這將包括範例應用程式和 runmqsc。
    • 下載之後，將組合解壓縮到您選擇的位置。
    • 記下 bin 目錄的完整路徑，該目錄的位置將根據您選擇用於解壓縮組合軟體的位置而定。 此路徑將在此作業的其餘部分中參照為 <PATH_TO_BIN_DIR> 。
    • 記下包含範例應用程式之目錄的完整路徑。 此路徑將在此作業的其餘部分中參照為 <PATH_TO_SAMPLE_BIN_DIR> 。
      • 若為 Windows，這將是前一個步驟中解壓縮的 bin 目錄，其位置將視您選擇解壓縮組合的位置而定。
      • 若為 Linux，這將是前一個步驟中解壓縮的 samp/bin 目錄，其位置將視您選擇解壓縮組合的位置而定。

收集必要的連線詳細資料

  1. 登入 IBM Cloud 主控台。

  2. 按一下漢堡功能表。

  3. 按一下儀表板。

    • 確定資源群組設為所有資源。

  4. 找到並按一下您的 IBM MQ 服務實例，這可在「服務」標題下找到。

  5. 從您的佇列管理程式清單，按一下您要管理的項目。

  6. 記下佇列管理程式名稱、主機名稱及埠值，以便用於後續步驟。

  7. 如果已經知道 MQ 使用者名稱和 IBM Cloud API 金鑰，則可以跳至此作業的下一節。 否則，請按一下管理標籤。

    顯示「管理」標籤的影像

  8. 記下您的 MQ 使用者名稱以便未來使用。

    • 請注意，您可以隨時遵循編輯或移除現有使用者或應用程式的 MQ 使用者名稱手冊，編輯您的 MQ 使用者名稱。

  9. 如果您尚沒有現有的 IBM Cloud API 金鑰，請執行下列動作：

    • 按一下建立 IBM Cloud API 金鑰。
    • 按一下顯示以顯示 API 金鑰，複製並儲存供之後使用，或是按一下下載將 API 金鑰儲存在檔案中。
      • 請注意，在這些步驟中產生的 API 金鑰，會用來向 IBM Cloud 以建立它之使用者的身分進行鑑別。 因此，它不應該與任何其他人共用，且應該安全地儲存。
      • 透過 IBM MQ 服務建立的 API 金鑰可以從佇列管理程式管理標籤重設。
    • 按一下關閉。

連接至佇列管理程式

使用「 MQ 探險家」:

  1. 啟動 IBM MQ Explorer。

  2. 在「MQ Explorer - 導覽器」畫面中，展開 IBM MQ。

  3. 按一下滑鼠右鍵佇列管理程式。

  4. 按一下新增遠端佇列管理程式...。

    影像顯示「新增遠端佇列管理程式」按鈕的位置

  5. 輸入要管理的佇列管理程式的名稱。

  6. 按下一步。

  7. 輸入在步驟 2 中記下的主機名稱。

  8. 使用步驟 2 中記下的相應值改寫埠號。

  9. 使用 CLOUD.ADMIN.SVRCONN 改寫伺服器連線通道名稱。

    影像顯示完整連線欄位

  10. 按下一步。

  11. 按下一步。

  12. 勾選「啟用使用者識別」的勾選框。

  13. 取消勾選「使用者識別相容模式」的勾選框。

  14. 鍵入您的 MQ 使用者名稱作為使用者 ID。

顯示完整使用者名稱欄位的影像

  1. 按一下完成。
  2. 將平台 API 金鑰貼至「密碼」文字框中。
  3. 按一下確定。

現在，佇列管理程式連線會顯示在「MQ Explorer - 導覽器」畫面的佇列管理程式資料夾下。

使用 runmqsc

  1. 開啟要在後續步驟中使用的指令 Shell。
  2. 匯出 'MQSERVER' 變數：
    • Linux: export MQSERVER="CLOUD.ADMIN.SVRCONN/TCP/<Hostname>(<Port>)"
    • Windows (命令提示字元): set MQSERVER=CLOUD.ADMIN.SVRCONN/TCP/<Hostname>(<Port>)
    • Windows (PowerShell): $env:MQSERVER="CLOUD.ADMIN.SVRCONN/TCP/<Hostname>(<Port>)"
  3. 執行 <PATH_TO_BIN_DIR>/runmqsc -c -u <your MQ username> -w60 <QUEUE_MANAGER_NAME>
  4. 提示輸入密碼時，輸入您的平台 API 金鑰。

建立新的測試佇列，稱為 'DEV.TEST.1'

使用「 MQ 探險家」:

在「MQ Explorer - 導覽器 > IBM MQ > 佇列管理程式」視圖中：

  1. 展開佇列管理程式的項目。
  2. 按一下滑鼠右鍵佇列。
  3. 選取「新建」>「本端佇列 ...」。
  4. 在「名稱」文字框中，鍵入「DEV.TEST.1」。
  5. 按一下完成。
  6. 按一下確定。

新的佇列會顯示在佇列清單中。

使用 runmqsc

佇列名稱應該以 DEV.* (範例 :DEV.myQueue) 開頭，因為應用程式使用者已配置對此字首的存取權。

在先前步驟所用的相同 Shell 中：

  1. 執行 DEFINE QLOCAL(DEV.TEST.1)
  2. 執行 DISPLAY QLOCAL(DEV.TEST.1)
    • 會顯示佇列 'DEV.TEST.1' 的詳細資料。
  3. 執行 end
    • runmqsc 階段作業已結束。
    • 保留提示以便用於後續步驟。

將訊息放置到測試佇列上

使用「 MQ 探險家」:

  1. 在佇列 'DEV.TEST.1' 按一下滑鼠右鍵。
  2. 按一下「放置測試訊息 ...」。
  3. 在「訊息資料」文字框鍵入測試訊息。
  4. 按一下放置訊息。
  5. 按一下關閉。
  6. 按一下「佇列」畫面中的重新整理。

您可以看到 "DEV.TEST.1" 的「現行佇列深度」現在為 1。

使用 runmqsc:

我們將使用範例程式 amqsputc 來協助將訊息放置在測試佇列上。 在先前步驟所用的相同 Shell 中：

  1. 匯出 'MQSAMP_USER_ID' 變數：
    • Linux: export MQSAMP_USER_ID="<your MQ username>"
    • Windows (命令提示字元): set MQSAMP_USER_ID=<your MQ username>
    • Windows (PowerShell): $env:MQSAMP_USER_ID="<your MQ username>"
  2. 執行 <PATH_TO_SAMPLE_BIN_DIR>/amqsputc DEV.TEST.1 <your QMGR name>
  3. 提示輸入密碼時，輸入您的平台 API 金鑰。
  4. 鍵入測試訊息。
  5. 按 Enter 鍵兩次以結束 amqsputc 範例。

在測試佇列上瀏覽訊息

此步驟對「 MQ 探險家」而言是唯一的步驟，無法使用指令行達成。

  1. 在佇列 'DEV.TEST.1' 按一下滑鼠右鍵。
  2. 按一下「瀏覽訊息 ...」。
  3. 確認您可以看到測試訊息，然後按一下關閉。

使用 amqsgetc 範例程式取出訊息

此步驟對於 runmqsc 而言是唯一的，無法在「 MQ 探險家」上達成。

在先前步驟所用的相同 Shell 中：

  1. 執行 <PATH_TO_SAMPLE_BIN_DIR>/amqsgetc DEV.TEST.1 <your QMGR name>
  2. 提示輸入密碼時，輸入您的平台 API 金鑰。

您的測試訊息已顯示。

不久之後，amqsputc 範例程式應該會在找不到其他訊息之後結束。

刪除測試佇列

使用 MQ Explorer

  1. 在佇列 'DEV.TEST.1' 按一下滑鼠右鍵。
  2. 按一下「刪除」。
  3. 按一下「刪除」。
  4. 勾選「從佇列清除所有訊息」方框。
  5. 按一下刪除。
  6. 按一下確定。

您可以看到 "DEV.TEST.1" 佇列已從佇列清單移除。

使用 runmqsc

在先前步驟所用的相同 Shell 中：

  1. 執行 <PATH_TO_BIN_DIR>/runmqsc -c -u <your MQ username> -w60 <QUEUE_MANAGER_NAME>
  2. 提示輸入密碼時，輸入您的平台 API 金鑰。
  3. 執行 DELETE QLOCAL(DEV.TEST.1)
    • 您會收到一則訊息，指出該佇列已刪除。
  4. 執行 DISPLAY QLOCAL(DEV.TEST.1) 以證明該佇列確實已刪除。
    • 您會收到一則訊息，指出找不到該佇列。
  5. 執行 end
    • runmqsc 階段作業已結束。

總結

您已順利：

  • 使用「 MQ 探險家」或 runmqsc 連接至佇列管理程式，並已建立新的測試佇列
  • 將測試訊息放入測試佇列
  • 瀏覽測試佇列以檢視測試訊息，或使用 amqsgetc 來檢視測試訊息
  • 清除及刪除測試佇列以便進行清除

後續步驟

既然您已順利瞭解如何使用 MQ 探險家及 runmqsc 來管理佇列管理程式，請嘗試下列步驟: