WebSphere MQ7.5教程——教程 1：將消息發送至本地隊列

本教程介紹瞭如何在與任何其他 WebSphere® MQ 安裝沒有任何通信鏈路的本地獨立安裝上設置隊列管理器QM_APPLE 和隊列Q1。定義對象後，可使用多種工具來測試該設置。第一個任務是放置測試消息。可通過使用 MQ 資源管理器或分佈式平臺amqsput 程序完成該任務。第二個任務是驗證該消息是否已添加到隊列。可通過使用 MQ 資源管理器或分佈式平臺amqsget 程序完成該任務，

完成教程 1 後，您應該會基本瞭解 WebSphere MQ 消息傳遞在具有一個隊列管理器和若干本地隊列的簡單消息傳遞拓撲中的工作原理。

一：創建隊列管理器：

過程

1. 啓動 WebSphere MQ 資源管理器。
2. 在“導航器”視圖中，右鍵單擊隊列管理器文件夾，然後單擊新建 >隊列管理器。 將打開“創建隊列管理器”嚮導。
3. 在隊列管理器名稱字段中，輸入 QM_APPLE。
4. 單擊兩次下一步。
5. 確保從選擇隊列管理器啓動類型選項中選擇自動。
6. 單擊下一步。
7. 確保選中創建配置用於 TCP/IP 的偵聽器複選框。
8. 如果完成按鈕不可用，那麼在偵聽端口號字段中輸入另一個端口號。 如果當前值爲 1414，那麼嘗試使用另一個端口號，例如：1415 或1416。如果此階段未使用缺省端口號 1414，請記錄所使用的端口號，因爲在本教程的後面階段中QM_APPLE 充當接收隊列管理器時將需要此端口號。
9. 單擊完成。

結果：WebSphere MQ 資源管理器的“導航器”視圖中的隊列管理器文件夾中會顯示錶示此隊列管理器的圖標，並且在您創建隊列管理器後，該隊列管理器會自動開始運行

使用 MQSC 創建隊列管理器

打開命令提示符，然後按照以下步驟操作：

過程

1. 通過輸入以下命令，創建名爲 QM_APPLE 的隊列管理器：

   crtmqm QM_APPLE

   此時會顯示消息，告訴您已經創建了隊列和缺省 WebSphere MQ 對象。
2. 通過輸入以下命令來啓動此隊列管理器：

   strmqm

   此時會顯示一條消息，告訴您何時啓動了該隊列管理器。

結果：您現在已經創建了名爲 QM_APPLE 的隊列管理器。

二：創建本地隊列

過程

1. 在“導航器”視圖中，展開隊列管理器文件夾。
2. 展開隊列管理器 QM_APPLE。
3. 右鍵單擊隊列文件夾，然後單擊新建 >本地隊列。 將打開“新建本地隊列”嚮導。
4. 在名稱字段中，輸入Q1。
5. 單擊完成。

使用 MQSC 創建本地隊列

關於此任務

打開命令提示符，然後按照以下步驟操作：

過程

1. 通過輸入以下命令來啓用 MQSC 命令：

   runmqsc

2. 輸入以下命令：

   define qlocal (Q1)

   此時會顯示消息，告訴您已經創建了隊列和缺省 WebSphere MQ 對象。

3. 通過輸入以下命令來停止 MQSC：

   end

結果：您現在已經創建了名爲 Q1 的本地隊列。

三：將測試消息放入本地隊列

過程

1. 在“導航器”視圖中，展開隊列管理器文件夾。
2. 展開所創建的隊列管理器 QM_APPLE。
3. 單擊隊列文件夾。 這樣會在“內容”視圖中列出隊列管理器的隊列。
4. 在“內容”視圖中，右鍵單擊本地隊列Q1，然後單擊放入測試消息。 將打開“放入測試消息”對話框。
5. 在消息數據字段中，輸入一些文本，例如：這是測試消息，然後單擊放入消息。 系統會清空消息數據字段，並將消息放入隊列。
6. 單擊關閉。

結果

在“內容”視圖中，您會注意到 Q1 的當前隊列深度值現在爲 1

使用 MQSC 來將測試消息放入隊列

關於此任務

使用 amqsput 樣本程序來將消息放入您創建的隊列。

在 Windows 上，缺省情況下樣本程序隨 WebSphere MQ 服務器或客戶機一起安裝。在 Linux 上，需要安裝樣本程序 RPM。

打開命令提示符，然後按照以下步驟操作：

過程

1. 啓動 amqsput 樣本程序，如下所示：
   • 在 Linux 上，更改爲 MQ_INSTALLATION_PATH/samp/bin 目錄，其中MQ_INSTALLATION_PATH 表示安裝了 WebSphere MQ 的高級別目錄。輸入以下命令：

     ./amqsput Q1 QM_APPLE

   • 在 Windows 上，輸入命令：

     amqsput Q1 QM_APPLE

   此時會顯示以下消息：

   Sample AMQSPUT0 start

   target queue is Q1

2. 在一行或多行上輸入某些消息文本，然後按 Enter 鍵兩次。 此時會顯示以下消息：

   Sample AMQSPUT0 end

結果

您現在已經創建了測試消息並將其放入本地隊列。

在 MQ 資源管理器“內容”視圖中，您會注意到 Q1 的當前隊列深度值現在爲 1。

四：驗證是否已發送測試消息

過程

1. 在“導航器”視圖中，展開隊列管理器文件夾，然後再展開QM_APPLE。
2. 單擊隊列文件夾。
3. 在“內容”視圖中，右鍵單擊Q1，然後單擊瀏覽消息。 將打開“消息”瀏覽器，顯示當前Q1 上的消息列表。
4. 雙擊最後一條消息以打開其屬性對話框。

結果

在屬性對話框的數據頁上，消息數據字段以人類可讀的格式顯示了消息的內容。

使用 amqsget 樣本程序來從隊列中取回消息。

打開命令提示符，然後按照以下步驟操作：

過程

啓動 amqsget 樣本程序：

• 在 Windows 上，輸入以下命令：

  amqsget Q1 QM_APPLE

• 在 Linux 上，更改爲 MQ_INSTALLATION_PATH/samp/bin 目錄，其中MQ_INSTALLATION_PATH 表示 WebSphere MQ 所安裝在的高級目錄。輸入以下命令：

  ./amqsget Q1 QM_APPLE

結果

此時會啓動該樣本程序，並顯示您的消息以及此隊列上的任何其他消息。在暫停 15 秒鐘後，樣本程序結束，並再次顯示命令提示符。

您現在已經完成了本教程。