IBMMQ常用命令.docx

IBMMQ常用命令.docx

《IBMMQ常用命令.docx》由会员分享，可在线阅读，更多相关《IBMMQ常用命令.docx（25页珍藏版）》请在冰豆网上搜索。

IBMMQ常用命令

1.队列管理器

1.1.创建队列管理器

命令：

crtmqm

示例：

crtmqm-ld/var/mqm/log-lc-lf16384-lp25-ls5QMCIS

参数说明：

-ld日志文件目录

-lc使用循环日志

-lf日志文件页大小

-lp主日志文件个数

-ls辅助日志文件个数

QMCIS：

队列管理器名

1.2.启动队列管理器

命令：

strmqm

停止队列管理器

命令：

endmqm-c|-w|-i|-p

参数说明：

-c受控关闭（或停顿关闭）。

这是缺省值。

队列管理器停止，但仅当所有应用程序已断开连接后才停止。

当前正在处理的任何MQI调用已完成。

立即将控制权返回给您，并且不通知您队列管理器是何时停止的。

对通过服务器连接通道连接的任何客户机应用程序的影响等效于以QUIESCE方式发出的STOPCHANNEL命令。

-w等待关闭。

此类型的关闭等效于受控关闭（除了仅当队列管理器已停止后才将控制权返回给您之外）。

当执行关闭时，您将接收到消息：

等待队列管理器qmName结束。

对通过服务器连接通道连接的任何客户机应用程序的影响等效于以QUIESCE方式发出的STOPCHANNEL命令。

-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.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:

WebSphereMQMachine-wideConfigurationFile*#

#*Function:

DefineWebSphereMQresourcesforanentiremachine*#

#***********************************************************************#

#*Notes:

*#

#*1）Thisistheinstallationtimedefaultconfiguration*#

#**#

#***********************************************************************#

AllQueueManagers:

#***********************************************************************#

#*Thepathtotheqmgrsdirectory,belowwhichqueuemanagerdata*#

#*isstored*#

#***********************************************************************#

DefaultPrefix=/var/mqm

LogDefaults:

LogPrimaryFiles=3

LogSecondaryFiles=2

LogFilePages=1024

LogType=CIRCULAR

LogBufferPages=0

LogDefaultPath=/var/mqm/log

QueueManager:

Name=saturn.queue.manager

Prefix=/var/mqm

Directory=saturn!

queue!

manager

QueueManager:

Name=pluto.queue.manager

Prefix=/var/mqm

Directory=pluto!

queue!

manager

DefaultQueueManager:

Name=saturn.queue.manager

ApiExitTemplate:

Name=OurPayrollQueueAuditor

Sequence=2

Function=EntryPoint

Module=/usr/ABC/auditor

Data=123

ApiExitCommon:

Name=MQPoliceman

Sequence=1

Function=EntryPoint

Module=/usr/MQPolice/tmqp

Data=CheckEverything

4.队列管理器配置文件qm.ini

队列管理器配置文件（qm.ini）包含特定队列管理器的相关信息。

每个队列管理器都有一个队列管理器配置文件。

创建和qm.ini文件关联的队列管理器时，将自动创建此文件。

qm.ini文件保存在队列管理器占用的目录树的根中。

例如，队列管理器QMNAME的配置文件的路径和名称是：

/var/mqm/qmgrs/QMNAME/qm.ini

队列管理器名称可长达48个字符的长度。

但是，这并不保证此名称是有效的或唯一的。

因此，目录名称是基于队列管理器名称生成的。

这个过程也称为名称变换。

有关描述，请参阅理解WebSphereMQ文件名。

图10显示在WebSphereMQforUNIX系统中如何在队列管理器配置文件中排列属性的组。

图10.WebSphereMQforUNIX系统的队列管理器配置文件示例

#*ModuleName:

qm.ini*#

#*Type:

WebSphereMQqueuemanagerconfigurationfile*#

#Function:

Definetheconfigurationofasinglequeuemanager*#

#**#

#*******************************************************************#

#*Notes:

*#

#*1）Thisfiledefinestheconfigurationofthequeuemanager*#

#**#

#*******************************************************************#

ExitPath:

ExitsDefaultPath=/var/mqm/exits

ExitsDefaultPath64=/var/mqm/exits64

Service:

Name=AuthorizationService

EntryPoints=13

ServiceComponent:

Service=AuthorizationService

Name=MQSeries.UNIX.auth.service

Module=/opt/mqm/bin/amqzfu1

ComponentDataSize=0

Log:

LogPrimaryFiles=3

LogSecondaryFiles=2

LogFilePages=1024

LogType=CIRCULAR

LogBufferPages=0

LogPath=/var/mqm/log/saturn!

queue!

manager/

XAResourceManager:

Name=DB2ResourceManagerBank

SwitchFile=/usr/bin/db2swit

XAOpenString=MQBankDB

XACloseString=

ThreadOfControl=THREAD

Channels:

2

MaxChannels=20

MaxActiveChannels=100

MQIBindType=STANDARD

TCP:

KeepAlive=Yes

QMErrorLog:

ErrorLogSize=262144

ExcludeMessage=7234

SuppressMessage=9001,9002,9202

SuppressInterval=30

ApiExitLocal:

Name=ClientApplicationAPIchecker

Sequence=3

Function=EntryPoint

Module=/usr/Dev/ClientAppChecker

Data=9.20.176.20

5.

5.MQ日志

5.1.1.队列管理器日志

从WebSphereMQ资源管理器使用日志队列管理器属性页，或qm.ini文件中的Log节来指定与此队列管理器上的日志记录相关的信息。

缺省情况下，这些设置从为队列管理器的缺省日志设置指定的设置继承（在WebSphereMQ的日志缺省中描述）。

如果您要以不同的方法配置此队列管理器，则仅更改这些设置。

有关计算日志大小的信息，请参阅计算日志的大小。

注：

以下参数列表中给出的限制由WebSphereMQ设置。

操作系统限制可能减少最大可能的日志大小。

LogPrimaryFiles=3|2-254（Windows）|2-510（UNIX系统）

创建队列管理器时分配的日志文件。

主日志文件的最小数目是2，最大数目在Windows上是254，在UNIX系统上是510。

缺省值是3。

主日志文件和辅助日志文件的总数在Windows不能超过255，在UNIX系统上不能超过511，并且不能小于3。

创建或启动队列管理器时检查此值。

创建队列管理器后，您可更改它。

但是，在重新启动队列管理器前值的更改不是有效的，不会立即产生作用。

LogSecondaryFiles=2|1-253（Windows）|1-509（UNIX系统）

耗尽主文件时分配的日志文件。

辅助日志文件的最小数目是1，在Windows上最大数目是253，在UNIX系统上最大数目是509。

缺省数目是2。

主日志文件和辅助日志文件的总数在Windows不能超过255，在UNIX系统上不能超过511，并且不能小于3。

启动队列管理器时检查此值。

您可更改此值，但是在重新启动队列管理器前更改不会有效，而且然后也不会立即发生作用。

LogFilePages=number

日志数据保存在称为日志文件的一系列文件中。

日志文件大小以4 KB页为单位指定。

在WebSphereMQforUNIX系统中，日志文件页数的缺省数是1024，日志文件大小是4 MB。

日志文件的最小页数是64，最大页数是65 535。

在WebSphereMQforWindows中，日志文件页数的缺省值是256，日志文件大小是1 MB。

日志文件的最小页数是32，最大页数是65 535。

注：

创建队列管理器期间指定的日志文件大小不能因为队列管理器而更改。

LogType=CIRCULAR|LINEAR

队列管理器使用的日志记录类型。

一旦创建了队列管理器，您就无法更改将使用的日志记录的类型。

请参阅WebSphereMQ的日志缺省中的LogType属性的描述，以获取关于创建具有您需要的日志记录类型的队列管理器的信息。

CIRCULAR

使用日志回滚系统停止时在处理中的事务来启动重新启动恢复。

请参阅循环日志记录以获取更全面的循环日志记录的说明。

LINEAR

对于重新启动恢复和介质或正向恢复（通过重放日志内容来创建丢失或损坏的数据）。

请参阅线性日志记录以获取更全面的线性日志记录的说明。

LogBufferPages=0|0-4096

分配给缓冲区记录进行写操作的内存数量，以4KB页为单位指定缓冲区大小。

缓冲区页的最小数量是18，最大数量是4096。

缓冲区越大，其吞吐量越高，尤其是那些较大的消息。

如果您指定0（缺省值），则队列管理器选择此大小。

在WebSphereMQV6.0中，这是128（512KB）。

如果您指定一个1到17之间的数，则队列管理器缺省是18（72KB）。

如果您指定一个18和4096之间的数，则队列管理器使用指定的用于设置内存分配的数。

创建或启动队列管理器时检查此值，在这两个时候值可能会增加或减少。

但是，对此值的更改在重新启动队列管理器之后才会有效。

LogPath=directory_name

队列管理器的日志文件所在的目录。

该目录必须存在于队列管理器能写的本地设备上，更好的情况是该目录与消息队列在不同的驱动器上。

指定不同的驱动器能在系统发生故障的情况下提供更好的保护。

缺省值是：

∙在WebSphereMQforWindows中是C:

\ProgramFiles\IBM\WebSphereMQ\log。

∙在WebSphereMQforUNIX系统中是/var/mqm/log。

您可以使用-ld标志在crtmqm命令中指定目录的名称。

创建队列管理器时，在队列管理器目录下还会创建一个目录，此目录用于保存日志文件。

这个目录的名称基于队列管理器名称。

这确保日志文件路径是唯一的，并确保它符合目录