IBM MQ常用命令Word文档格式.docx
《IBM MQ常用命令Word文档格式.docx》由会员分享,可在线阅读,更多相关《IBM MQ常用命令Word文档格式.docx(16页珍藏版)》请在冰豆网上搜索。
endmqm-c|-w|-i|-p<
-c受控关闭(或停顿关闭)。
这是缺省值。
队列管理器停止,但仅当所有应用程序已断开连接后才停止。
当前正在处理的任何MQI调用已完成。
立即将控制权返回给您,并且不通知您队列管理器是何时停止的。
对通过服务器连接通道连接的任何客户机应用程序的影响等效于以QUIESCE方式发出的STOPCHANNEL命令。
-w等待关闭。
此类型的关闭等效于受控关闭(除了仅当队列管理器已停止后才将控制权返回给您之外)。
当执行关闭时,您将接收到消息:
等待队列管理器qmName结束。
-i立即关闭。
队列管理器在完成所有当前正在处理的MQI调用后停止。
任何在该命令发出后发出的MQI请求都将失败。
当队列管理器再次启动时,任何未完成的工作单元将回滚。
队列管理器结束后返回控制权。
对通过服务器连接通道连接的任何客户机应用程序的影响等效于以FORCE方式发出的STOPCHANNEL命令。
-p抢先关闭。
仅在意外情况下使用此类型的关闭。
例如,当队列管理器在常规endmqm命令下未停止。
队列管理器可以停止而不等待应用程序断开连接或MQI调用完成。
这可能会产生WebSphereMQ应用程序的不可预测的结果。
关闭方式设置为立即关闭。
如果队列管理器稍后未停止,关闭方式将升级,且终止所有剩余的的队列管理器进程。
对通过服务器连接通道连接的任何客户机应用程序的影响等效于以TERMINATE方式发出的STOPCHANNEL命令。
1.3.删除队列管理器
dltmqm
1.4.显示队列管理器启动状态
dspmq
命令结果显示示例:
QMNAME(Test)STATUS(正在运行)
QMNAME(Test2)STATUS(已正常结束)
2.管理本地MQ对象
使用MQSC命令执行本地管理任务
使用MQSC命令执行定义或修改队列、通道等操作。
MQSC命令可以有以下两种使用方式:
●交互地使用MQSC命令:
runmqsc[qmgrName]
●从文本文件运行MQSC命令:
runmqsc[qmgrName]<
myprog.in>
myprog.out
命名WebSphereMQ对象的规则:
WebSphereMQ认证信息、通道、客户机通道、侦听器、名称列表、进程、队列、服务和存储类对象存在于各自独立的对象名称空间中,因此,每个不同类型的对象都可以有相同的名称。
但是,同一个名称空间中的对象不能与任何其它的对象同名。
(例如,本地队列不能和模型队列有相同的名称。
)WebSphereMQ中的名称都区分大小写;
但是,您应该记住不包含在引号中的小写字符将转换为大写。
显示或修改队列管理器属性
displayqmgr(display可简写为dis)
alterqmgrCCSID(819)#修改字符集
defql(DEADQ)defpsist(yes)maxdepth(20000)replace
alterqmgrdeadq(DEADQ)#设置死信队列为DEADQ
2.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)replace
2.2.3.定义服务器连接通道
defchl()chltype()replace
2.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)all
3.WebSphereMQ配置文件mqs.ini
WebSphereMQ配置文件mqs.ini包含和节点上所有队列管理器都相关的信息。
它在安装期间自动创建。
WebSphereMQforUNIX系统的mqs.ini文件在/var/mqm目录中。
它包含:
∙队列管理器的名称
∙缺省队列管理器的名称
∙和每个文件关联的文件位置
图9显示WebSphereMQ配置文件的示例:
图9.UNIX(R)系统的WebSphereMQ配置文件示例
#***********************************************************************#
#*ModuleName:
mqs.ini*#
#*Type:
WebSphereM