ibmmq 命令是管理和操作 IBM MQ 消息队列系统的核心工具，通过命令行接口（CLI）提供了队列管理、通道配置、监听器控制、错误处理等一系列功能，这些命令通常在 MQ 的安装目录下的 bin 目录中，如 runmqsc、dspmq、mqrc 等，适用于系统管理员、开发人员和运维工程师日常维护 MQ 集群，以下是 ibmmq 常用命令的详细分类及使用说明，涵盖队列管理、通道控制、监听器配置、监控诊断等场景。

队列管理命令

队列是 MQ 的核心组件，用于存储和传递消息，队列管理命令主要包括创建、修改、显示和删除队列等操作。

1. 创建队列（DEFINE QLOCAL）
   用于定义本地队列，语法为：DEFINE QLOCAL(QNAME) USAGE(NORMAL) + (MAXDEPTH(1000)) + (MAXMSGL(1048576))。QNAME 为队列名，MAXDEPTH 指队列最大消息数，MAXMSGL 指单条消息最大长度（字节），创建名为 TEST.Q 的队列，限制消息数为 500，可执行：DEFINE QLOCAL(TEST.Q) MAXDEPTH(500)。

2. 修改队列（ALTER QLOCAL）
   动态调整队列属性，如修改最大深度或启用/禁用队列，将 TEST.Q 的最大深度改为 1000：ALTER QLOCAL(TEST.Q) MAXDEPTH(1000)，若需暂停队列（新消息被拒绝），可使用 ALTER QLOCAL(TEST.Q) DISABLED。

3. 显示队列（DISPLAY QLOCAL）
   查看队列状态和属性，语法为：DISPLAY QLOCAL(*) 显示所有本地队列，或 DISPLAY QLOCAL(TEST.Q) 查看特定队列，输出结果包括队列深度（CURDEPTH）、最大深度（MAXDEPTH）、状态（RUNNING/Paused）等关键信息。

   
   （图片来源网络，侵删）

4. 删除队列（DELETE QLOCAL）
   删除不再使用的队列，需确保队列为空且无应用程序连接，命令：DELETE QLOCAL(TEST.Q)，若队列非空，可强制删除（但可能导致消息丢失）：DELETE QLOCAL(TEST.Q) FORCE。

通道管理命令

通道是 MQ 队列管理器（Queue Manager, QM）之间通信的桥梁，分为发送通道（Sender）、接收通道（Receiver）、请求通道（Requester）和服务器通道（Server）等类型。

1. 创建通道（DEFINE CHANNEL）
   以定义发送通道为例：DEFINE CHANNEL(SND.CHANNEL) CHLTYPE(SDR) CONNAME('192.168.1.100(1414)')。CHLTYPE 为通道类型，CONNAME 为目标队列管理器的 IP 和监听端口。

2. 启动通道（START CHANNEL）
   激活通道以传输消息，START CHANNEL(SND.CHANNEL)，若通道启动失败，可通过 DISPLAY CHANNEL(SND.CHANNEL) 查看状态（如 RUNNING 或 STOPPED）。

   
   （图片来源网络，侵删）

3. 停止通道（STOP CHANNEL）
   安全终止通道，语法为：STOP CHANNEL(SND.CHANNEL)，对于正在传输大量消息的通道，可使用 FORCE 选项强制停止，但可能导致消息未确认：STOP CHANNEL(SND.CHANNEL) FORCE。

4. 显示通道状态（DISPLAY CHANNEL）
   监控通道运行情况，如：DISPLAY CHANNEL(*) ALL 显示所有通道的详细属性，包括当前消息数（CURMSGS）、连接状态（STATUS）和错误日志（ERRORLOG）。

队列管理器（QM）控制命令

队列管理器是 MQ 的核心进程，负责管理队列、通道和连接。

1. 启动队列管理器（STRMQM）
   启动指定的队列管理器：STRMQM QM1，启动后可通过 RUNMQLR 启动监听器进程。

2. 停止队列管理器（ENDMQM）
   安全关闭队列管理器，支持两种模式：ENDMQM QM1（等待当前消息处理完成）和 ENDMQM QM1 IMMEDIATE（立即停止，可能导致未提交消息丢失）。

3. 显示队列管理器状态（DSPMQ）
   列出本地所有队列管理器及其状态（Running、Ended、Starting 等）：DSPMQ。

   QMNAME(PQM1)        STATUS(Running)  
   QMNAME(QM2)        STATUS(Ended)  

监听器管理命令

监听器负责监听客户端连接请求,并将请求转发给队列管理器。

1. 创建监听器（DEFINE LISTENER）
   定义 TCP 监听器，DEFINE LISTENER(LISTENER1) TRPTYPE(TCP) PORT(1414)。

2. 启动监听器（START LISTENER）
   激活监听器：START LISTENER(LISTENER1)，可通过 DISPLAY LISTNER(LISTENER1) 查看监听状态（如 LISTENING）。

3. 停止监听器（STOP LISTENER）
   终止监听器：STOP LISTENER(LISTENER1)。

消息管理与错误处理

1. 查看队列消息（DISPLAY QSTATUS）
   检查队列中的消息状态，如：DISPLAY QSTATUS(Q1) TYPE(ALL)，输出包括消息 ID、优先级和过期时间。

2. 处理死信队列（Dead Letter Queue, DLQ）
   当消息无法送达目标队列时，会被发送到 DLQ，可通过 DISPLAY QLOCAL(DLQ.*) 查看死信消息，并使用 RUNMQLNQ 工具重新处理或导出消息。

3. 日志管理
   MQ 错误日志可通过 DISPLAY QMSTATUS ALL 查看队列管理器日志，或使用 runmqtrc 工具跟踪通道和消息流：runmqtrc -m QM1 -s all trace.trc。

常用命令速查表

相关问答FAQs

Q1: 如何解决 MQ 通道启动失败的问题？
A: 通道启动失败通常与网络连接、认证配置或队列管理器状态有关，可通过以下步骤排查：

1. 使用 DISPLAY CHANNEL(CH_NAME) 检查通道状态，若显示 STOPPED，查看 REASON 字段获取错误码（如 MQRC_CHANNEL_NOT_STARTED）。
2. 检查目标队列管理器的监听器是否启动：DISPLAY LISTNER(*)，确认端口和 IP 配置正确。
3. 验证通道两端的队列管理器是否运行：DSPMQ，确保状态为 Running。
4. 检查通道认证机制（如 SSL/TLS 或用户 ID），确保配置一致。

Q2: 如何高效清理队列中的大量消息？
A: 清理大量消息时，需避免直接删除队列导致数据丢失，推荐以下方法：

1. 使用批量删除工具：通过 runmqm 命令结合脚本循环获取消息 ID，并使用 MQGET 命令逐条删除。

   while true; do  
     MQGET -m QM1 -q TEST.Q -i "MSGID('*')" -r;  
     if [ $? -ne 0 ]; then break; fi  
   done  

2. 启用队列预清理：修改队列属性，设置 GET 模式为 NOOP（不处理消息），再通过 ALTER QLOCAL(TEST.Q) MAXDEPTH(0) 限制新消息，最后清空队列。
3. 导出消息到文件：使用 runmqsc 的 SAVE QLOCAL 命令将消息导出为文件，备份后删除队列：

   SAVE QLOCAL(TEST.Q) TO('messages.dat')  
   DELETE QLOCAL(TEST.Q)  

   注意：导出操作需确保队列管理器有足够权限，且目标文件系统空间充足。