WebSphere MQ 教程

### WebSphere MQ 教程详解 #### 一、将消息发送至本地队列 在这一部分，我们将深入了解如何设置队列管理器、创建队列、将测试消息放入队列，并验证消息是否成功接收。 ##### 1. 创建队列管理器 **开始之前：** 在进行队列管理器的创建之前，确保已经正确安装了 WebSphere MQ 软件。安装过程中可能需要配置一些基础环境变量，如 `MQ_INSTALL_DIR` 和 `PATH` 变量。 **关于此任务：** 此任务的目标是创建一个名为 QM_APPLE 的队列管理器。队列管理器是 WebSphere MQ 的核心组件之一，用于管理队列、通道以及其他相关对象。 **使用 WebSphere MQ 资源管理器创建队列管理器：** 1. **启动 WebSphere MQ 资源管理器：** 通常情况下，可以通过点击开始菜单中的 “WebSphere MQ” 文件夹找到 “WebSphere MQ Explorer” 应用程序。 2. **创建队列管理器：** 在 “导航器” 视图中，右键点击队列管理器文件夹，选择 “新建 > 队列管理器”，然后按照向导提示操作。 3. **命名队列管理器：** 在队列管理器名称字段中输入 QM_APPLE。 **使用 WebSphere MQ 脚本命令 (MQSC) 创建队列管理器：** 除了使用图形界面外，还可以通过命令行方式使用 MQSC 命令来创建队列管理器。这在自动化部署或批量处理时非常有用。示例命令如下： ```mqsc DEFINE QMGR QMgrName(QM_APPLE) ``` **注意事项：** - 创建队列管理器时，需要确保没有同名的队列管理器存在。 - 如果使用的是 Windows 操作系统，确保 WebSphere MQ 服务已经启动。 ##### 2. 创建本地队列 **关于此任务：** 创建本地队列是消息传递的基础步骤之一。在这个例子中，我们将创建一个名为 Q1 的队列。 **使用 WebSphere MQ 资源管理器创建本地队列：** 1. **选择队列管理器：** 在 WebSphere MQ Explorer 中，选择刚刚创建的队列管理器 QM_APPLE。 2. **新建队列：** 右键点击队列文件夹，选择 “新建 > 队列”。根据向导提示输入队列名称 Q1，并选择适当的队列类型。 **使用 WebSphere MQ 脚本命令 (MQSC) 创建本地队列：** ```mqsc DEFINE QLOCAL(Q1) ``` **注意事项：** - 需要确保队列名称的独特性，避免与其他队列重复。 - 队列类型的选择取决于实际应用场景。这里使用的是本地队列 (`QLOCAL`)。 ##### 3. 将测试消息放入本地队列 **关于此任务：** 接下来，我们需要使用提供的工具 `amqsput` 来发送一条测试消息到队列 Q1 中。 **使用 amqsput 工具发送测试消息：** 1. **打开命令行窗口：** 使用 Windows 或 Linux 命令行界面。 2. **发送消息：** 输入以下命令： ```bash amqsput -m "This is a test message." -q Q1 -c QM_APPLE ``` 其中 `-m` 表示消息内容，`-q` 表示目标队列名称，`-c` 表示队列管理器名称。 **注意事项：** - 发送消息前，请确保已安装了相应的客户端工具集。 - 检查命令行参数是否正确无误。 ##### 4. 验证是否已发送测试消息 **关于此任务：** 最后一步是验证消息是否成功发送到了队列中。我们将使用 `amqsget` 工具来检查队列中的消息。 **使用 amqsget 工具读取消息：** 1. **打开命令行窗口：** 2. **读取消息：** 输入以下命令： ```bash amqsget -q Q1 -c QM_APPLE ``` 其中 `-q` 表示源队列名称，`-c` 表示队列管理器名称。 **注意事项：** - 如果消息成功发送，`amqsget` 命令将会显示消息内容。 - 确认队列管理器处于运行状态。 --- #### 二、将消息发送至远程队列 本节将继续基于之前的教程，介绍如何将消息发送至远程队列管理器。这包括了创建远程队列管理器、配置通道、以及发送消息等步骤。 ##### 1. 创建远程队列管理器 **关于此任务：** 创建远程队列管理器的过程与创建本地队列管理器类似，只是它们运行在不同的计算机上。假设我们已经有了一个本地队列管理器 QM_APPLE，现在需要创建一个远程队列管理器 QM_BANANA。 **使用 WebSphere MQ 脚本命令 (MQSC) 创建远程队列管理器：** ```mqsc DEFINE QMGR QMgrName(QM_BANANA) ``` **注意事项：** - 确保远程计算机上也已安装 WebSphere MQ。 - 避免队列管理器名称冲突。 ##### 2. 创建消息通道 **关于此任务：** 为了使两个队列管理器能够互相通信，需要创建一个消息通道。通道是 WebSphere MQ 中用于连接两个队列管理器的重要组件。 **使用 WebSphere MQ 脚本命令 (MQSC) 创建消息通道：** ```mqsc DEFINE CHANNEL(CHANNEL_NAME) CHLTYPE(SDR) MCAUSER(*NOAUTH) CONNAME(QM_BANANA(1414)) ``` **注意事项：** - `CHLTYPE` 参数定义了通道类型，`SDR` 表示单向接收通道。 - `CONNAME` 参数指定了远程队列管理器的名称和监听端口。 ##### 3. 将测试消息放入远程队列 **关于此任务：** 现在可以使用 `amqsput` 工具将测试消息发送到远程队列管理器的队列中。 **使用 amqsput 工具发送测试消息：** ```bash amqsput -m "This is a test message for remote queue." -q Q1 -c QM_BANANA -H CHANNEL_NAME ``` **注意事项：** - `-H` 参数指定了用于发送消息的通道名称。 --- #### 三、在客户机-服务器配置上发送消息 本节将介绍如何在客户机-服务器配置中设置消息传递，以及如何从客户机发送消息到服务器，并验证是否接收到消息。 ##### 1. 设置服务器 **关于此任务：** 在服务器端，首先需要确保已经正确安装了 WebSphere MQ 并且队列管理器正在运行。此外，还需要创建接收队列和发送队列。 **使用 WebSphere MQ 脚本命令 (MQSC) 创建接收队列和发送队列：** ```mqsc DEFINE QLOCAL(RECV_QUEUE) DEFINE QLOCAL(SEND_QUEUE) ``` **注意事项：** - 确保队列管理器运行正常。 ##### 2. 设置客户机 **关于此任务：** 在客户机端，同样需要确保 WebSphere MQ 客户端已正确安装，并且能够连接到服务器端的队列管理器。 **使用 amqsput 工具发送消息到服务器：** ```bash amqsput -m "This is a test message from client to server." -q SEND_QUEUE -c QM_SERVER -H CHANNEL_NAME ``` **注意事项：** - `-c` 参数指定服务器端队列管理器名称。 - `-H` 参数指定连接服务器的通道名称。 ##### 3. 验证是否已发送测试消息 **关于此任务：** 在服务器端，使用 `amqsget` 工具从接收队列中读取消息。 **使用 amqsget 工具读取消息：** ```bash amqsget -q RECV_QUEUE -c QM_SERVER ``` **注意事项：** - 如果消息成功发送，`amqsget` 命令将会显示消息内容。 - 确认服务器端队列管理器处于运行状态。 --- #### 四、使用文件传输应用程序交换文件 在这一部分，我们将学习如何使用文件传输应用程序 (FTA) 来发送和接收文件。这包括在服务器-服务器安装和客户机-服务器安装两种场景下发送和接收文件的方法。 ##### 1. 设置文件传输应用程序 **关于此任务：** 在服务器端和/或客户机端设置 FTA，确保已安装并配置了 FTA 组件。 **使用 WebSphere MQ 脚本命令 (MQSC) 配置 FTA：** ```mqsc DEFINE FTA(Filename("testfile.txt") FTAQueue("FT_QUEUE") FTAFileName("testfile_received.txt")) ``` **注意事项：** - `Filename` 参数指定源文件名。 - `FTAQueue` 参数指定用于文件传输的队列。 - `FTAFileName` 参数指定接收文件名。 ##### 2. 发送文件 **关于此任务：** 使用 FTA 发送文件到目标队列。 **使用 amqsendfta 工具发送文件：** ```bash amqsendfta -f testfile.txt -q FT_QUEUE -c QM_SERVER ``` **注意事项：** - `-f` 参数指定源文件名。 - `-q` 参数指定目标队列。 - `-c` 参数指定队列管理器名称。 ##### 3. 接收文件 **关于此任务：** 使用 FTA 从队列中接收文件。 **使用 amqrecvfta 工具接收文件：** ```bash amqrecvfta -q FT_QUEUE -c QM_SERVER ``` **注意事项：** - 确认队列管理器处于运行状态。 - 文件将保存在当前目录下，或者通过 FTA 配置指定的目录。 ### 总结 以上教程提供了 WebSphere MQ 的基本操作指南，包括队列管理器的创建、队列的创建、消息的发送与接收、远程队列管理器的配置、客户机-服务器配置下的消息传递，以及使用 FTA 进行文件传输等内容。这些基础知识对于初学者来说是非常有用的起点，可以帮助理解 WebSphere MQ 的基本工作原理及其应用场景。