MQ常用命令

QUEUE(QMB)
TYPE(QLOCAL)
ACCTQ(QMGR)
ALTDATE(2009-02-06)
ALTTIME(11.41.44)
BOQNAME( )
BOTHRESH(0) CLUSTER( )
CLUSNL( ) CLWLPRTY(0)
CLWLRANK(0)
CLWLUSEQ(QMGR)
CRDATE(2008-12-05)
1.查看所有队列管理器 dspmq
查看所有的通道
dis chl(name)/dis chl(*)/dis chl(*) all/dis channel(name)
查看通道状态
dis chs(name)/dis chs(*)/dis chs(*) all
查看队列
display queue(name)
查看队列管理器信息（包括 CCSID 等信息） dis qmgr
种方法。 需要注意的时，当 DEPTH 属性值为0的时候，实际上就形成了同步通信。另外，当采用 Depth 触发时，产生触发消息以后，队列将被修改为非触发方式，如果需要再次触发，需要重新设 置成允许触发。
一般而言，在实际应用中，如果通道设置成触发方式，触发类型往往设置成为 FIRST 和
DEPTH。
6.修改 ccsid
alter qmgr ccsid(“XXX”)
一、MQ 的启动与停止
用 root 用户启/停需要 root 用户包含在 mqm 组中。
1、MQ 的启动 strmqm QMgrName 如果启动默认队列管理器，strmqm 后可以忽略队列管理器名称。 在意外情况停止队列管理器后，启动可能会失败，此时可以检查上次停止后是否有 IPC 资 源未释放，若有请予以删除，删除方法参考下面的“C.清理所有残留在系统内部的信号灯和 共享内存”。
CRTIME(10.37.53)
CURDEPTH(0)
DEFBIND(OPEN)
DEFPRTY(0)
DEFPSIST(NO)
DEFSOPT(SHARED)
DEFTYPE(PREDEFINED)
DESCR( )
DISTL(YES)
GET(ENABLED)
HARDENBO
INITQ( )
IPPROCS(1)
5、查看死信队列 dis qlocal(DEADQName)
三、日常维护项目 1、监控文件系统/var/mqm 的使用情况，建议不要超过80%。
2、定期报告 MQ 系统错误，备份清理 MQ 系统错误记录 在遇到问题时，检查/var/mqm/errors 目录下是否有新的 FDC 文件产生，如果有应当检查原 因。另外，要定期检查该目录下 MQ 错误日志。 3、检查日志个数是否增长 使用命令 cd 移动到 MQ 日志所在目录（/var/mqm/log/QMgrName/active/），使用 ls –l|wc 命令统计。
次事情，下次传输队列的消息数由3个增加到4个时候不会产生触发事件YPE(FIRST)。
l 在通道触发中，推荐使用 SYSTEM.CHANNEL.INITQ 队列作为初始队列， 该队列为 MQ 专
用的通道启动队列, 不需要手工启动其触发监视器，设置传输队列
2.2.3 触发器工作流程
1)
本地或远程应用程序 A，往应用队列(Application Queue)中 PUT 了一条消息。
2)
如果队列的触发类型设置为 first，当队列原来深度为0时（队列为空），这时 PUT
一条消息到队列中将形成触发事件，同时产生一条触发消息，触发消息中将包含进程定义中
的信息，因为进程定义中包含启动程序 B 所需的信息，所以触发消息中也包含了启动程序 B
4. 检查 MQ 队列管理器错误日志 当系统运行不正常时首先检查：/var/mqm/qmgrs/QMgrName/errors/AMQERR0n.LOG 错误消息生成后总是放在 AMQERR01中，AMQERR02和 AMQERR03文件用于保存历史错 误消息 2.2.2 触发类型 l EVERY： 应用队列中每接受到一个消息时，都将产生触发消息。如果应用程序仅仅处理一个消息就结 束，可采用这种触发类型。 l FIRST： 应用队列中消息从0变为1时会触发事件。如果当队列中的一个消息到达时启动程序，直到 处理完所有消息才结束，则采用这种触发类型。 l DEPTH： 应用队列中消息数目和 TriggerDepth（引起触发事件发生时，队列中的消息数目）属性值相 同时，才会产生触发事件。当一系列请求的回复都收到时，才启动应用程序，则可以采用这
QDPLOEV(DISABLED)
QDPMAXEV(ENABLED)
QSVCIEV(NONE)
QSVCINT(999999999)
RETINTVL(999999999)
SCOPE(QMGR)
SHARE
STATQ(QMGR)
TRIGDATA( )
TRIGDPTH(1)
TRIGMPRI(0)
TRIGTYPE(FIRST)
所需的信息。
3)
队列管理器创建触发消息，并把它 PUT 入与应用队列相关的启动队列 Initiation
Queue。
4)
触发监控器(Trigger Monitor)从启动队列(Initiation Queue)中 GET 触发消息。
5)
触发监控器处理触发消息，发出启动应用程序 B 的命令。
6)
应用程序 B 打开应用队列(Application Queue)，并处理队列中的消息。
完整 MQSC 命令参考如下：
ALTER QL(QMB) +
TRIGGER +
TRIGTYPE(FIRST) +
INITQ(SYSTEM.CHANNEL.INITQ) +
TRIGDATA(QMA.QMB)
l 通道的触发监控器我们采用系统的自带的 runmqchi 程序，缺省队列管理器启动的时候，
runmqchi 进程会自动启动。
发送通道名 QMA.QMB，通道启动器为 runmqchi，该进程在队列管理器启动的时候自动启
动。下面我们通过举例来演示配置实现消息通道触发启动。
l 首先我们来查看一下传输队列 QMB 都有哪些属性，显示如下清单所示，其中清单中的标 注红色的属性和通道触发配置相关。
dis ql(QMB)
1 : dis ql(QMB) AMQ8409: 显示队列细节。
二、MQ 运行状态查看与常用操作
1、查看队列管理器运行状态 对 MQ 5.2或以上版本，执行如下命令检查队列管理器运行状态：dspmq 显示结果中 QMNAME 表示 MQ 队列管理器的名称，STATUS 表示当前运行状态。 运行状态有如下几种： Starting 正在启动 Running 正在运行 Ending 正在停止 Ended normally 已经正常终止 Ended immediately 已经立即终止 Ended preemtively 已经强制终止 Ended unexpectively 异常终止 注意：停止 MQ 后必须使用 dspmq 命令进行状态检查 dspmq 查询结果示例： QMNAME(QM00) STATUS（Running）
INITQ(SYSTEM.CHANNEL.INITQ )属性。
l 通过 TRIGDATA 属性设置需要触发的通道名，例如 TRIGDATA(QMA.QMB )。
l 对于 TRIGMPRI 属性的含义是基于消息优先级触发，也即某类优先级的消息满足的触发条
件才产生触发事件，我们在消息通道触发中不推荐使用。
7.6.3.1 通道的状态
USAGE(XMITQ)
l 设置传输队列为触发模式 TRIGGER。
l 设置触发类型为 every/first/depth 其中的一种，例如 TRIGTYPE(FIRST)。如果设置为
TRIGTYPE(DEPTH)，则还需要设置触发深度属性，例如 TRIGDPTH(4)，表示当队列中的消
息数由3个增加到4个的时候才能形成触发事件，但需要注意的是深度触发事件只能产生一
2、MQ 的关闭 一般情况下，我们使用“endmqm -i QMgrName”来停止 mq，如果停止失败，可以使用如 下步骤： 步骤1：endmqm -p QMgrName，如果停不掉，继续步骤2； 步骤2：杀死有关进程，清理残留在系统内部的信号灯和共享内存 A.找到队列管理器程序进程 ps -ef|grep QMgrName B.使用 kill 命令终止1>中找到的程序进程，无法停止的进程可以用 kill -9来终止，终止进程 的顺序如下(不存在的进程可以忽略）： kill amqpcsea 命令服务器 kill amqhasmx 记录器 kill amqharmx 日志格式化器（仅 LINEAR 日志） kill amqzllp0 检查点处理器 kill amqzlaa0 队列管理器代理 kill amqzxma0 处理控制器 kill amqrrmfa 库进程（用于群集） C.清理所有残留在系统内部的信号灯和共享内存（其属主和组均为 mqm） ipcs -s| grep mqm | awk '{print $2}'|xargs -i ipcrm -s {} ipcs -m| grep mqm | awk '{print $2}'|xargs -i ipcrm -m {}
2、查看通道运行状态与启停通道 runmqsc dis chl(*); 查看所有通道定义 dis chs(*); 查看所有通道状态，如果没有查询到通道状态，或报错 AMQ8420: Channel Status not found，请启动通道 dis chs(ChannelName)；查看通道 ChannelName 的状态 通道状态有如下几种： STARTING 正在启动 BINDING 正在绑定 INITIALIZING 正在初始化 RUNNING 正常 STOPPING 正在停止 RETRYING 重试 PAUSED 等待 STOPPED 已停止 REQUESTING 请求 start chl(ChannelName); 启动通道 stop chl(ChannelName); 停止通道 reset channel(ChannelName); 重置通道序号。当本地与其他 MQ 队列管理器的通道无法 正常启动的情况，检查日志发现是通道序号不一致，此时就需要先停止发送方通道，并在发 送方和接收方进行通道计数的重置，重置后启动通道即可恢复通讯。