IBMMQ常用命令.docx
1.队列管理器1.1.创建队列管理器命令:crtmqm<qmgrName>示例:crtmqm-Idvarmqm1og-Ic-If16384-Ip25-Is5QMCIS参数说明:-Id日志文件目录-Ic使用循环日志-If日志文件页大小-Ip主日志文件个数-Is辅助日志文件个数QMCIS:队列管理器名1.2. 启动队列管理器命令:strmqm<qmgrName>停止队列管理器命令:endmqm-c-w-i-p<qmgrName>参数说明:- C受控关闭(或停顿关闭)。这是缺省值。队列管理器停止,但仅当所有应用程序已断开连接后才停止。当前正在处理的任何MQI调用已完成。立即将控制权返回给您,并且不通知您队列管理器是何时停止的。对通过服务器连接通道连接的任何客户机应用程序的影响等效于以QUIESCE方式发出的STOPCHANNE1命令。- w等待关闭。此类型的关闭等效于受控关闭(除了仅当队列管理器已停止后才将控制权返回给您之外)。当执行关闭时,您将接收到消息:等待队列管理器qmName结束。对通过服务器连接通道连接的任何客户机应用程序的影响等效于以QUIESCE方式发出的STOPCHANNE1命令。- i立即关闭。队列管理器在完成所有当前正在处理的MQI调用后停止。任何在该命令发出后发出的MQI请求都将失败。当队列管理器再次启动时,任何未完成的工作单元将回滚。队列管理器结束后返回控制权。对通过服务器连接通道连接的任何客户机应用程序的影响等效于以FORCE方式发出的STOPCHANNE1命令。- P抢先关闭。仅在意外情况下使用此类型的关闭例曲当队列管理器在常规endmqm命令下未停止。队列管理器可以停止而不等待应用程序断开连接或MQI调用完成。这可能会产生WebSphereMQ应用程序的不可预测的结果。关闭方式设置为立即关闭。如果队列管理器稍后未停止,关闭方式将升级,且终止所有剩余的的队列管理器进程。对通过服务器连接通道连接的任何客户机应用程等效于以TERMINATE方式发出的STOPCHANNE1命令。1.3. 删除队列管理器命令:d1tmqm1.4. 显示队列管理器启动状态命令:dspmq命令结果显示示例:QMNAME(Test)STATUS(正在运行)QMNAME(Test2)STATUS(已正常结束)2.管理本地MQ对象使用MQSC命令执行本地管理任务使用MQSC命令执行定义或修改队列、通道等操作。MQSC命令可以有以下两种使用方式:交互地使用MQSC命令:runmqscqmgrName从文本文件运行MQSC命令:runmqscqmgrName<myprog.in>myprog.out命名VebSphereMQ对象的规则:WebSphereMQ认证信息、通道、客户机通道、侦听器、名称列表、进程、队列、服务和存储类对象存在于各自独立的对象名称空间中,因此,每个不同类型的对象都可以有相同的名称。但是,同一个名称空间中的对象不能与任何其它的对象同名。(例如,本地队列不能和模型队列有相同的名称。)WebSphereNQ中的名称都区分大小写;但是,您应该记住不包含在引号中的小写字符将转换为大写。显示或修改队列管理器属性disp1ayqmgr(disp1ay可简写为dis)示例:a1terqmgrCCSID(819)#修改字符集defq1(DEADQ)defpsist(yes)maxdepth(20000)rep1acea1terqmgrdeadq(DEADQ)#设置死信队列为DEADQ2.1. 队列2.1.1. 定义本地队列示例defq1(FROMCCPC_1)maxdepth(10000)defpsist(yes)rep1ace参数说明: q1(FROMCCPC_1):队列本地名称 maxdepth:队列上允许的最大消息数; defpsist:队列中消息持久性默认值。NO该队列上的消息在队列管理器重新后动时丢失YES该队列上的消息在队列管理器重新启动时保存了下来。关于消息在队列中的保存时间:消息在队列的保存时间与三个设置有关:队列的属性、消息PerSiStenCe持久性属性和消息Expiry消息到期时间属性,其中队列附加出属性是在创建队列时设置,消息PerSiStenCe和EXPiry属性是应用程序往队列放入消息时指定。消息本身的PerSiStenCe值优先于队列内加亚值。EXPiry指消息到期时间,即经过指定的时间后,消息如果还没被取走,此消息将过期(无效)。消息过期后,可能会自动从队列中删除(取决于不同操作系统的MQ实现)。对于非持久性消息,即使EXPiry设为永不过期,重启队列管理器时,消息也将丢失。2.1.2. 定义远程队列示例defqr(TOCCPC_1)rname(58/9_/)rqmname(QMC589)xmitq(QMGF)defpsist(yes)rep1ace参数说明: qr(TOCCPCJ):队列本地名称,名字可任意取; mame(5819_1):远程队列名,必须与远程队列管理器中的本地队列名相同; rqmname(QMC5819):远程队列管理器名,必须与远程队列管理器名相同; Xmitq(QMGF):本地传输队列名称。2.1.3. 定义传输队列示例defq1(QMG)Usage(XMITQ)defpsist(YES)maxdepth(500M)triggerIrigtype(FIRST)trigdata(999581030604.5819)initq()rep1ace参数说明: q1(QMGF):队列本地名称,名字可任意取; Usage(XMITQ):指定此本地队列为传输队列,参数值固定填rtXMITQw; trigger:启动触发(相应的,NOTRIGGER为禁用触发) Irigtype(FIRST):触发方式,建议值为"FIRST",即第一条消息触发; trigdata(999581030604.5819):触发数据,值为传输队列将使用的发送通道名; initq():触发队列,固定填触发器在此的作用是当传输队列接收到第一条消息时,将触发启动指定的发送通道。2.1.4. 查看队列disq1(qname)a11显示队列所有属性disq1(qname)Curdepth显示队列当前深度,即当前队列中存放的消息数disqs(qname)type(queue)a11显示与队列相关的状态信息disqs(qname)1ype(hand1e)a11显示与访问队列的句柄相关的状态信息2.1.5. 删除队列de1eteq1(qname)2.1.6. 删除队列中的消息c1earq1(qname)注:删除队列中的消息时出错时处理尝试执行命令RESo1VECHANNE1(ChanneUiame)ACTION(COMMIT)后,再执行Ckarq1命令。2.2. 通道2.2.1. 定义接收通道defch1(999581OOO107.5819)ch1type(rcvr)trptype(tcp)rep1ace参数描述: ch1(999581000107.5819):接收通道名称,必须与远程队列管理器中的发送对列名称相同。推荐的命名规则为“远程队列管理器名.本地队列管理器名”; ch1type(rcvr):指定通道为类型,值固定为“rcvr”; trptype(tcp):通讯协议,除非特别指明,一般采用“1ep”协议。2.2.2. 定义发送通道defch1(5819.999581OOO107)ChItype(SDR)discint(0)conname('10.2.106.106(1417),)Xmitq(QMCIS)trptype(tcp)rep1ace2.2.3. 定义服务器连接通道defch1()ch1type()rep1ace2.2.4. 删除通道De1etech1(channe1name)2.2.5. 查看通道状态dischs(channe1name)通道的当前状态,它可以是正在启动、正在绑定、正在初始化、正在运行、正在停止、正在重试、已暂停、已停止、正在请求和通道状态未找到。正常运行时,通道状态为“正在运行”;关闭通道时,通道状态为“已停止”;如果通道状态长时间处于“正在绑定"(binding)、“正在重试”(retrying),则表明通道不正常,需要人工介入。这时可查看队列管理器日志文件,日志文件中一般会提供异常原因。关于“通道状态未找到“:此状态值仅表示当前没有建立到此通道的连接,并不能表示通道是否正常。2.2.6. 启动通道Startch1(channe1name)2.2.7. 关闭通道Stopch1(channe1name)2.2.8. 重置通道resetch1(channe1name)2.3. 监听器定义监听器def1istener(QMC5819)TRPTYPE(TCP)PORT(I417)CONTRO1(STARTON1Y)BACK1OG(0)rep1ace参数描述: 1istener(QMC5819):监听器名,名称可任意取; TRPTYPE(TCP):通讯协议类型; PORT(1417):服务监听端口 CONTRO1(String)指定如何启动和停止侦听器:MANUA1不会自动启动或自动停止侦听器。通过使用START1ISTENER命令和STOP1ISTENER命令来控制它。这是缺省值。QMGR当队列管理器启动和停止时,同时启动和停止被定义的侦听器。Starton1y当队列管理器启动时,同时启动侦听器,但当队列管理器停止时,不请求停止侦听器。2.3.1. 启动监听器start1istener(QMC5819)2.3.2. 关闭监听器stop1istener(QMC5819)2.3.3. 查看监听器状态disIsstatus(1ISTENER.TCP)a11(QMC5819)a113. WebSphereMQ配置文件mqs.iniWebSphereMQ配置文件mqs.ini包含和节点上所有队列管理器都相关的信息。它在安装期间自动创建。WebSphereMQforUNIX系统的mqs.ini文件在varmqm目录中。它包含:# 队列管理器的名称# 缺省队列管理器的名称和每个文件关联的文件位置图9显示WebSphereMQ配置文件的示例:图9UNIX系统的WebSDhereMQ配置文件示例*# *Modu1eName:mqs.ini# # *Type:WebSphereMQMachine-wideConfigurationFi1e# # *Function:DefineWebSphereMQresourcesforanentiremachine*#*# *Notes:# #*1)Thisistheinsta11ationtimedefau1tconfiguration*#*#*#A1IQueueManagers:*# *Thepathtotheqmgrsdirectory,be1owwhichqueuemanagerdata*# *isstored# #*#Defau1tPrefix=varmqm1ogDefau1ts:1ogPrimaryFi1