IBM_MQ常用命令(参考)

1.队列管理器1.1.创建队列管理器命令：crtmqmqmgrName示例：crtmqm-ld/var/mqm/log-lc-lf16384-lp25-ls5QMCIS参数说明：-ld日志文件目录-lc使用循环日志-lf日志文件页大小-lp主日志文件个数-ls辅助日志文件个数QMCIS：队列管理器名1.2.启动队列管理器命令：strmqmqmgrName停止队列管理器命令：endmqm-c|-w|-i|-pqmgrName参数说明：-c受控关闭（或停顿关闭）。这是缺省值。队列管理器停止，但仅当所有应用程序已断开连接后才停止。当前正在处理的任何MQI调用已完成。立即将控制权返回给您，并且不通知您队列管理器是何时停止的。对通过服务器连接通道连接的任何客户机应用程序的影响等效于以QUIESCE方式发出的STOPCHANNEL命令。-w等待关闭。此类型的关闭等效于受控关闭（除了仅当队列管理器已停止后才将控制权返回给您之外）。当执行关闭时，您将接收到消息：等待队列管理器qmName结束。对通过服务器连接通道连接的任何客户机应用程序的影响等效于以QUIESCE方式发出的STOPCHANNEL命令。-i立即关闭。队列管理器在完成所有当前正在处理的MQI调用后停止。任何在该命令发出后发出的MQI请求都将失败。当队列管理器再次启动时，任何未完成的工作单元将回滚。队列管理器结束后返回控制权。对通过服务器连接通道连接的任何客户机应用程序的影响等效于以FORCE方式发出的STOPCHANNEL命令。-p抢先关闭。仅在意外情况下使用此类型的关闭。例如，当队列管理器在常规endmqm命令下未停止。队列管理器可以停止而不等待应用程序断开连接或MQI调用完成。这可能会产生WebSphereMQ应用程序的不可预测的结果。关闭方式设置为立即关闭。如果队列管理器稍后未停止，关闭方式将升级，且终止所有剩余的的队列管理器进程。对通过服务器连接通道连接的任何客户机应用程等效于以TERMINATE方式发出的STOPCHANNEL命令。1.3.删除队列管理器命令：dltmqm1.4.显示队列管理器启动状态命令：dspmq命令结果显示示例：QMNAME(Test)STATUS(正在运行)QMNAME(Test2)STATUS(已正常结束)2.管理本地MQ对象使用MQSC命令执行本地管理任务使用MQSC命令执行定义或修改队列、通道等操作。MQSC命令可以有以下两种使用方式：交互地使用MQSC命令：runmqsc[qmgrName]从文本文件运行MQSC命令：runmqsc[qmgrName]myprog.inmyprog.out命名WebSphereMQ对象的规则：WebSphereMQ认证信息、通道、客户机通道、侦听器、名称列表、进程、队列、服务和存储类对象存在于各自独立的对象名称空间中，因此，每个不同类型的对象都可以有相同的名称。但是，同一个名称空间中的对象不能与任何其它的对象同名。（例如，本地队列不能和模型队列有相同的名称。）WebSphereMQ中的名称都区分大小写；但是，您应该记住不包含在引号中的小写字符将转换为大写。显示或修改队列管理器属性displayqmgr(display可简写为dis)示例：alterqmgrCCSID(819)#修改字符集defql(DEADQ)defpsist(yes)maxdepth(20000)replacealterqmgrdeadq(DEADQ)#设置死信队列为DEADQ2.1.队列2.1.1.定义本地队列示例defql(FROMCCPC_1)maxdepth(10000)defpsist(yes)replace参数说明：ql(FROMCCPC_1)：队列本地名称maxdepth：队列上允许的最大消息数；defpsist：队列中消息持久性默认值。NO该队列上的消息在队列管理器重新启动时丢失YES该队列上的消息在队列管理器重新启动时保存了下来。关于消息在队列中的保存时间：消息在队列的保存时间与三个设置有关：队列defpsist属性、消息Persistence持久性属性和消息Expiry消息到期时间属性，其中队列defpsist属性是在创建队列时设置，消息Persistence和Expiry属性是应用程序往队列放入消息时指定。消息本身的Persistence值优先于队列defpsist值。Expiry指消息到期时间，即经过指定的时间后，消息如果还没被取走，此消息将过期（无效）。消息过期后，可能会自动从队列中删除（取决于不同操作系统的MQ实现）。对于非持久性消息，即使Expiry设为永不过期，重启队列管理器时，消息也将丢失。2.1.2.定义远程队列示例defqr(TOCCPC_1)rname(5819_1)rqmname(QMC5819)xmitq(QMGF)defpsist(yes)replace参数说明：qr(TOCCPC_1)：队列本地名称，名字可任意取；rname(5819_1)：远程队列名，必须与远程队列管理器中的本地队列名相同；rqmname(QMC5819)：远程队列管理器名，必须与远程队列管理器名相同；xmitq(QMGF)：本地传输队列名称。2.1.3.定义传输队列示例defql(QMGF)usage(XMITQ)defpsist(YES)maxdepth(50000)triggertrigtype(FIRST)trigdata(999581030604.5819)initq(SYSTEM.CHANNEL.INITQ)replace参数说明：ql(QMGF)：队列本地名称，名字可任意取；usage(XMITQ)：指定此本地队列为传输队列，参数值固定填“XMITQ”；trigger：启动触发（相应的，NOTRIGGER为禁用触发）trigtype(FIRST)：触发方式，建议值为“FIRST”，即第一条消息触发；trigdata(999581030604.5819)：触发数据，值为传输队列将使用的发送通道名；initq(SYSTEM.CHANNEL.INITQ)：触发队列，固定填“SYSTEM.CHANNEL.INITQ”。触发器在此的作用是当传输队列接收到第一条消息时，将触发启动指定的发送通道。2.1.4.查看队列disql(qname)all显示队列所有属性disql(qname)curdepth显示队列当前深度，即当前队列中存放的消息数disqs(qname)type(queue)all显示与队列相关的状态信息disqs(qname)type(handle)all显示与访问队列的句柄相关的状态信息2.1.5.删除队列deleteql(qname)2.1.6.删除队列中的消息clearql(qname)注：删除队列中的消息时出错时处理尝试执行命令RESOLVECHANNEL(channel_name)ACTION(COMMIT)后，再执行clearql命令。2.2.通道2.2.1.定义接收通道defchl(999581000107.5819)chltype(rcvr)trptype(tcp)replace参数描述：chl(999581000107.5819)：接收通道名称，必须与远程队列管理器中的发送对列名称相同。推荐的命名规则为“远程队列管理器名.本地队列管理器名”；chltype(rcvr)：指定通道为类型，值固定为“rcvr”；trptype(tcp)：通讯协议，除非特别指明，一般采用“tcp”协议。2.2.2.定义发送通道defchl(5819.999581000107)chltype(SDR)discint(0)conname('10.2.106.106(1417)')xmitq(QMCIS)trptype(tcp)replace2.2.3.定义服务器连接通道defchl()chltype()replace2.2.4.删除通道Deletechl(channelname)2.2.5.查看通道状态dischs(channelname)通道的当前状态，它可以是正在启动、正在绑定、正在初始化、正在运行、正在停止、正在重试、已暂停、已停止、正在请求和通道状态未找到。正常运行时，通道状态为“正在运行”；关闭通道时，通道状态为“已停止”；如果通道状态长时间处于“正在绑定”（binding）、“正在重试”（retrying），则表明通道不正常，需要人工介入。这时可查看队列管理器日志文件，日志文件中一般会提供异常原因。关于“通道状态未找到”：此状态值仅表示当前没有建立到此通道的连接，并不能表示通道是否正常。2.2.6.启动通道Startchl(channelname)2.2.7.关闭通道Stopchl(channelname)2.2.8.重置通道resetchl(channelname)2.3.监听器定义监听器deflistener(QMC5819)TRPTYPE(TCP)PORT(1417)CONTROL(STARTONLY)BACKLOG(0)replace参数描述：listener(QMC5819)：监听器名，名称可任意取；TRPTYPE(TCP)：通讯协议类型；PORT（1417）：服务监听端口CONTROL(string）指定如何启动和停止侦听器：MANUAL不会自动启动或自动停止侦听器。通过使用STARTLISTENER命令和STOPLISTENER命令来控制它。这是缺省值。QMGR当队列管理器启动和停止时，同时启动和停止被定义的侦听器。STARTONLY当队列管理器启动时，同时启动侦听器，但当队列管理器停止时，不请求停止侦听器。2.3.1.启动监听器startlistener(QMC5819)2.3.2.关闭监听器stoplistener(QMC5819)2.3.3.查看监听器状态dislsstatus(LISTENER.TCP)all(QMC5819)all3.WebSphereMQ配置文件mqs.iniWebSphereMQ配置文件mqs.ini包含和节点上所有队列管理器都相关的信息。它在安装期间自动创建。WebSphereMQforUNIX系统的mqs.ini文件在/var/mqm目录中。它包含：队列管理器的名称缺省队列管理器的名称和每个文件关联的文件位置图9显示WebSphereMQ配置文件的示例：图9.UNIX(R)系统的WebSphereMQ配置文件示例#***********************************************************************##*ModuleName:mqs.ini*##*Type:WebSphereMQMachine-wideConfigurationFile*##*Function:DefineWebSphereMQresourcesforanentiremachine*##***********************************************************************##*Notes:*##*1)Thisistheinstallationtimedefaultconfiguration*##**##***********************************************************************#AllQueueManagers:#***********************************************************************##*Thepathtotheqmgrsdirectory,belowwhichqueuemanagerdata*##*isstored*##***********************************************************************#