WebSphere MQ 命令

附录 WebSphere MQ 命令一览表

队列管理器 (Queue Manager)

crtmqm 创建队列管理器 (Create Queue Manager)

[-c Text] 描述，最多 64 个字符

[-d DefaultTransmissionQueue] 缺省传输队列

[-h MaximumHandleLimit] 一个应用程序可以 MQOPEN 的最大句柄数

min=1，max=999,999,999，default=256 [-lc | -ll] Log 类型

-lc Circular Logging，环型日志 -ll Linear Logging，线型日志

[-ld LogPath] Log 文件的目录，mqm 用户必须有访问权限，缺省为：

Windows X:\\Program Files\\IBM\\WebSphere MQ\\log\\qmgr UNIX /var/mqm/log

[-lf LogFileSize] Log 文件大小，4KB 的倍数.

Windows min=32，max=16,384，default=256 (1 MB) UNIX min=64，max=16,384，default=1024 (4 MB)

[-lp LogPrimaryFiles] 主 Log 文件数量，min=2，max=62，default=3 [-ls LogSecondaryFiles] 备用 Log 文件数量，min=1，max=61，default=2

注意：LogPrimaryFiles + LogSecondaryFiles <= 63 [-q] 缺省队列管理器

[-g ApplicationGroup] 应用组。Application Group 中的用户可以运行 MQI 应

用，更新 IPCC 资源，改变 Queue Manager 目录中的内容。 仅对 WMQ for AIX，Solaris，HPUX，Linux 有效。会反 映到 qm.ini 中。 mqm 必须是 Application Group 中的 用户。缺省 -g all

[-t IntervalValue] min=0，max=999,999,999，default=999,999,999，单

位: 毫秒。触发间隔 (Trigger Time Interval) [-u DeadLetterQueue] 死信队列 (Dead Letter Queue))

[-x MaximumUncommittedMessages] 最大的未提交的消息数量

min=1，max=999,999,999，default=10,000

在一个交易中的消息最大数量，为 MQPUT + MQGET + LUW 中 产生的 Trigger Message 数量之和 [-z] 抑止出错信息

QMgrName 队列管理器名 例:

crtmqm -t 5000 -u SYSTEM.DEAD.LETTER.QUEUE -ll QM dltmqm 删除队列管理器 (Delete Queue Manager)

[-z] 抑止出错信息

QMgrName 队列管理器名 例:

dltmqm -z QM

strmqm 启动队列管理器 (Start Queue Manager)

[-c] 启动队列管理器，覆盖重建所有的系统对象，再停止该队列管理器

[-z] 抑止出错信息

[QMgrName] 缺省为系统的缺省队列管理器 例:

strmqm -c QM

endmqm 停止队列管理器 (End Queue Manager)

[-c | -w | -i | -p]

-c Controlled (or quiesced) shutdown。缺省值。

等到所有的应用 MQDISC，Queue Manager 停止，当即显示命令提 交的提示。 -w Wait shutdown

与 -c 效果相同，只是命令提示一直等到 Queue Manager 停止后 才出来。

-i Immediate shutdown

等到当前的所有 MQ API 都执行完毕，Queue Manager 停止。以

后的 MQ API 全都失败，当前的交易在下次重启后自动回滚。提示等 到 Queue Manager 停止后出现. -p Preemptive shutdown。

强制停止。不会等待 MQDISC 或 MQ API 执行完毕，所以队列可能 会出现异常。提示等到 Queue Manager 停止后出现。

[-z] 抑止出错信息

QMgrName 队列管理器名 例:

endmqm -c QM endmqm -i QM

dspmq 显示队列管理器 (Display Queue Manager)

[-m QMgrName] 缺省为系统的缺省队列管理器 [-s] 显示运行状态 例: dspmq

QMNAME(QM) STATUS（正在运行） QMNAME(QM1) STATUS（正常结束） QMNAME(QM2) STATUS（正常结束） dspmq -s -m QM

QMNAME(QM) STATUS（正在运行） 命令服务器 (Command Server)

strmqcsv 启动命令服务器 (Start Command Server)

[QMgrName] 缺省为系统的缺省队列管理器 例:

strmqcsv QM

endmqcsv 停止命令服务器 (End Command Server)

[-c | -i]

-c Controlled，允许已经开始处理的 Command 消息完成。缺省值 -i Immediately，中止正在处理的 Command 任务 QMgrName 队列管理器

例:

endmqcsv QM endmqcsv -i QM

dspmqcsv 显示命令服务器 (Display Command Server)

[QMgrName] 缺省为系统的缺省队列管理器 返回的 Command Server 状态可能是: l Starting l Running

l Running with SYSTEM.ADMIN.COMMAND.QUEUE not enabled for gets l Ending l Stopped 例:

dspmqcsv QM Listener (监听器)

runmqlsr 运行监听器 (Run Listener)

-t tcp

[-p Port] Port 口，缺省为 1414

[-i IPAddr] IP 地址，如果不指定，Listener 会监听所有的 IP 地址 [-b Backlog] 允许的并发连接请求数 -t lu62

-n TpName 交易名，如果不指定，从 Queue Manager 的配置中取 -t netbios

-a Adapter NetBIOS Adapter Number。缺省为 0

-l LocalName NetBIOS Local Name。缺省从队列管理器的配置中取 -e Names Listener 可用的 Name 数量。缺省从队列管理器的配置中取 -s Sessions Listener 可用的 Session 数量。缺省从队列管理器的配置中取

-o Commands Listener 可用的 Command 数量。缺省从队列管理器的配置中取 -t spx

-x Socket 缺省为 0x5E86

-b Backlog 允许的并发连接请求数 -t udp

[-p Port] Port 口，缺省为 1414 [-m QMgrName]

缺省为系统的缺省队列管理器 备注:

-t 为必选项，其它为可选项 例:

runmqlsr -t tcp -p 1414 -m QM endmqlsr 停止监听器 (End Listener)

[-w] 等到命令完成后才返回控制

[-m QMgrName] 缺省为系统的缺省队列管理器 触发监控器 (Trigger Monitor)

runmqtmc 启动 Client 端触发监控器 (Run Trigger Monitor for Client)

[-m QMgrName] 缺省为系统的缺省队列管理器

[-q InitiationQName] 初始化队列名字，缺省为

SYSTEM.DEFAULT.INITIATION.QUEUE

runmqtrm 启动 Server 端触发监控器 (Run Trigger Monitor for Server)

[-m QMgrName] 缺省为系统的缺省队列管理器 [-q InitiationQName] 初始化队列名字，缺省为

SYSTEM.DEFAULT.INITIATION.QUEUE Trace

strmqtrc 启动 Trace (Start Trace，Windows 平台)

[-t TraceType] [-x TraceType] [-l MaxSize] 解释同后

strmqtrc 启动 Trace (Start Trace，HP-UX，Solaris，Linux 平台)

[-m QMgrName] 缺省为系统的缺省队列管理器

[-e] Early Tracing。可以 Trace 队列管理器的创建与启动. [-t TraceType] Trace 的部分，可以有多个-t 选项

[-x TraceType] 不要 Trace 的部分，可以有多个-x 选项 TraceType 可以是以下的组合： all 全部，是以下全部选项的叠加

api MQI 调用和主要队列管理器部件相关信息 commentary 部件中的评注信息 comms 网络通信上的数据流 csdata 通用服务的内部数据 csflows 通用服务的控制过程 detail 控制过程的细节数据

lqmdata 本地队列管理器的内部数据 lqmflows 本地队列管理器的控制过程 otherdata 其它部件的内容数据 otherflows 其它部件的控制过程 parms 激活 trace 控制过程

remotedata 通信部件的内部数据 remoteflows 通信部件的控制过程 servicedata 服务部件的内部数据 serviceflows 服务部件的控制过程

ssl 用 GSKit 与SSL Channel 安全数据，不支持 WebSphere MQ for Windows

versiondata WebSphere MQ 版本信息

[-l MaxSize] Trace 文件 (AMQnnnn.TRC) 的上限。以 MB 为单位。如果达到上 限，Trace 文件会更名为 AMQnnnn.TRS，且创建出新的 Trace 文 件 AMQnnnn.TRC。如果原来存在 AMQnnnn.TRS，则原来的文件被 删除。 例:

strmqtrc -m QM strmqtrc -m QM -e

strmqtrc -m QM -t all -x ssl

endmqtrc 停止 Trace (End Trace，Windows 平台) 解释同后

endmqtrc 停止 Trace (End Trace，HP-UX，Solaris，Linux 平台) [-m QMgrName] 缺省为系统的缺省队列管理器 [-e] Early Tracing.

[-a] All Tracing。必须单独设置 例:

endmqtrc -m QM endmqtrc -m QM -e

dspmqtrc 显示 Trace (Display Trace，HP-UX，Solaris，Linux 平台) [-t FormatTemplate] 格式文件，缺省为 /opt/mqm/lib/amqtrc.fmt [-h] 从 Report 中删去 Header Information [-s] 抽取出 Trace Hander 输出到 stdout [-o OutputFilename] 输出文件

InputFileName Trace 文件。如果只有一个文件，输出可以是 stdout 或是-o 指 定的文件。如果不止一个文件，输出为 AMQXXXXX.FMT (PID) 介质恢复 (Media Recover)

rcdmqimg 记录对象映像 (Record Object Image) [-m QMgrName] 缺省为系统的缺省队列管理器 [-z] 抑止出错信息

[-l] 输出重启 Queue Manager 和介质恢复所需的最早的日志文件名。 例:

AMQ7467: 启动队列管理器 QM 所需的最早的日志文件是 S0000000.LOG。

AMQ7468: 执行队列管理器 QM 的介质恢复所需的最早的日志文件 是 S0000001.LOG。

输出到出错日志 ../QM/errors/AMQERR01.LOG 上，同时输出到 stderr 上。如果-l -z 同时使用，则只输出到出错日志上。 -t ObjectType

nl 或namelist 名字列表 prcs 或process 进程 q 或queue 队列

ql 或qlocal 本地队列 qa 或qalias 别名队列 qr 或qremote 远程队列 qm 或qmodel 模型队列 qmgr 队列管理器

syncfile 通道同步文件 ctlg 或catalog 对象目录

authinfo 授权信息，SSL 通道 *或all 全部

GenericObjName 对象名字 备注

此命令仅对 Linear Logging 的 Queue Manager 有效 例:

rcdmqimg -l -m QM -t queue Q

记录了对象 Q 类型 queue 的媒体映像.

AMQ7467: 启动队列管理器 QM 所需的最早的日志文件是 S0000000.LOG .

AMQ7468: 执行队列管理器 QM 的介质恢复所需的最早的日志文件是 S0000000.LOG . rcrmqobj 重建对象 (Recreate Object)

[-m QMgrName] 缺省为系统的缺省队列管理器 [-z] 抑止出错信息 -t ObjectType

nl 或namelist 名字列表 prcs 或process 进程 q 或queue 队列

ql 或qlocal 本地队列 qa 或qalias 别名队列 qr 或qremote 远程队列 qm 或qmodel 模型队列 qmgr 队列管理器

syncfile 通道同步文件 ctlg 或catalog 对象目录

authinfo 授权信息，SSL 通道 *或all 全部

GenericObjName 对象名字 备注

此命令仅对 Linear Logging 的 Queue Manager 有效 例:

rcrmqobj -m QM -t queue Q

重新建立类型 queue 的对象 Q . 日志 (Log)

dmpmqlog 输出格式化日志

[-b | -s StartLSN | -n ExtentNumber]

指定 Dump 开始的 Log Sequence Number (LSN)

-b 从 Base LSN 开始，Base LSN active log 中的第一个

-s StartLSN 从 指 定 的 某 个 LSN 开 始 。StartLSN 格式为 nnnn:nnnn:nnnn:nnnn。

如果是 Circular Logging，StartLSN 必须大于等于 Base LSN

-n ExtentNumber 从指定的某 ExtentNumber 开始。取值为 0 - 9,999,999。仅对 Linear Logging 有效

[-e EndLSN] 指定 Dump 结束的 LSN。EndLSN 格式为 nnnn:nnnn:nnnn:nnnn. [-f LogFilePath] 指 定 Log 目录， 缺省为 C:\\Program Files\\IBM\\WebSphere MQ\\log\\QMgr

[-m QMgrName] 缺省为系统的缺省队列管理器 例:

dmpmqlog -m QM > QMLog.dmp

容量单元 (Capacity)

dspmqcap 显示容量单元 (Display Capacity) 例:

dspmqcap

购买的处理器定量为 1 此机器中的处理器数为 1

setmqcap 设置容量单元 (Set Capacity) 例:

setmqcap 2

权限信息 (Authority)

dmpmqaut 输出权限信息 (Dump Authority) [-m QMgrName] 缺省为系统的缺省队列管理器 [-n Profile | -l]

-n Profile 输出 Profile 文件名 -l 仅输出 Profile 名字和类型 [-t ObjectType] 对象类型 nl 或namelist 名字列表 prcs 或process 进程 q 或queue 队列 qmgr 队列管理器

authinfo 授权信息，SSL 通道

[-s ServiceComponent] 如果有 Installable Authorization Services，通过这个选 项可以提供Authorization Service 的名字。如果不用这个选 项，Authorization Inquiry 使用 Service 中的第一个安装部 件.

[-p PrincipalName | -g GroupName] -g GroupName 组名

-p PrincipalName 用户名.如果是Windows 系统，可以用 userid@domain 例:

dmpmqaut -m QM -l -t queue dmpmqaut -m QM -n Q -t queue

dspmqaut 显示权限信息 (Display Authority) [-m QMgrName] 缺省为系统的缺省队列管理器

-n ObjectName 对象名。如果是队列管理器，则可以不选此项 -t ObjectType 对象类型 nl 或namelist 名字列表 prcs 或process 进程 q 或queue 队列 qmgr 队列管理器

authinfo 授权信息，SSL 通道

[-s ServiceComponent] 如果有 Installable Authorization Services，通过这个选 项可以提供Authorization Service 的名字。如果不用这个选 项，Authorization Inquiry 使用 Service 中的第一个安装部 件.

[-p PrincipalName | -g GroupName] -g GroupName 组名

-p PrincipalName 用户名.如果是Windows 系统，可以用 userid@domain 例:

dspmqaut -m QM -n Q -t queue -p chenyux 实体 chenyux 对于对象 Q 具有下列权限: get browse put inq set crt dlt chg dsp passid passall setid setall clr

dspmqaut -m QM -t qmgr -g mqm

实体 mqm 对于对象 QM 具有下列权限: inq set connect altusr crt dlt chg dsp setid setall

setmqaut设置权限信息 (Set Authority)

[-m QMgrName] 缺省为系统的缺省队列管理器 -n Profile Profile 文件名 -t ObjectType 对象类型 nl 或namelist 名字列表 prcs 或process 进程 q 或queue 队列 qmgr 队列管理器

authinfo 授权信息，SSL 通道 [-p PrincipalName | -g GroupName] -g GroupName 组名

-p PrincipalName 用户名。如果是Windows 系统，可以用 userid@domain

[-s ServiceComponent] 如果有 Installable Authorization Services，通过这个选 项可以提供Authorization Service 的名字。如果不用这个选 项，Authorization Inquiry 使用 Service 中的第一个安装部 件.

[-remove] 删除 Profile 文件 %MQI authorizations%

+altusr 添加更换用户身份权限 -altusr 删除更换用户身份权限

+browse 添加浏览队列MQGET(BROWSE)权限 -browse 删除浏览队列MQGET(BROWSE)权限 +connect 添加连接队列管理器 MQCONN 权限 -connect 删除连接队列管理器 MQCONN 权限 +get 添加读消息MQGET 权限 -get 删除读消息MQGET 权限

+inq 添加查询对象参数MQINQ 权限 -inq 删除查询对象参数MQINQ 权限 +put 添加写消息MQPUT 权限 -put 删除写消息MQPUT 权限

+set 添加设置对象参数MQSET 权限 -set 删除设置对象参数MQSET 权限 %Context authorizations%

+passall 添加传递所有上下文权限 -passall 删除传递所有上下文权限 +passid 添加传递身份上下文权限 -passid 删除传递身份上下文权限 +setall 添加设置所有上下文权限 -setall 删除设置所有上下文权限 +setid 添加设置身份上下文权限 -setid 删除设置身份上下文权限 -ministration authorizations% +chg 添加更改对象权限 -chg 删除更改对象权限 +clr 添加清除对象权限 -clr 删除清除对象权限 +crt 添加创建对象权限 -crt 删除创建对象权限 +dlt 添加删除对象权限 -dlt 删除删除对象权限 +dsp 添加显示对象权限 -dsp 删除显示对象权限 %Generic authorizations% +all 添加所有权限 -all 删除所有权限

+alladm 添加所有管理操作可达到的权限

-alladm 删除所有管理操作可达到的权限 +allmqi 添加所有MQI 可达到的权限 -allmqi 删除所有MQI 可达到的权限

+none 无权限，用来创建不含权限的 Profile 例:

setmqaut -m QM -n Q -t queue -g group +inq +alladm setmqaut -m QM -n Q -t queue -g group -allmqi +alladm setmqaut -m QM -n a.b.* -t q -p mqm +all setmqaut -m QM -n a.b.* -t q -p mqm -remove setmqaut -m QM -n a.b.* -t q -p mqm +none amqoamd 输出授权信息 (OAM Dump)

[-m QMgrName] 缺省为系统的缺省队列管理器 [-t ObjectType] 对象类型 [-n ObjName] 对象名 [-f | -s]

-f 旧的授权文件格式 -s 输出 setmqaut 命令 例； amqoamd

运行环境 (Environment)

mqver 显示版本 (WebSphere MQ Version) 例: mqver

Name: WebSphere MQ Version: 530.4 CSD04

CMVC level: p530-04-030617 BuildType: IKAP - (Production)

这里很清楚地表明 WebSphere MQ 的版本为 5.3，目前的补丁是 CSD04。

具体的 PTF 说明可参考: C:\\Program Files\\IBM\\WebSphere MQ\\PTF\\zh_cn\\memo.ptf setmqprd 设置生产环境 (Set Production) [LicenseFile] 例:

setmqprd \此 WebSphere MQ 副本正在以\生产\方式运行. 备注：

WebSphere MQ 有三种不同的安装介质，试用版 (Trial)、测试版 (Beta) 和产生版 (Production)，分别

对应三个不同的许可文件 amqtcert.lic，amqbcert.lic 和 amqpcert.lic。如果系统用生产版介质安装覆盖了原

来的试用版或测试版，则用此命令可以加载生产许可证文件，切换到生产方式运行。 amqicsdn 安装补丁 (Install CSD) 例:

amqicsdn 备注：

通常这条命令在展开的补丁包中。

高可用性 (High-Avalability，Windows 平台)

hadltmqm 删除队列管理器 (HA Delete Queue Manager) /m QMgrName 队列管理器 备注：

从一个结点上删除 HA 环境下的队列管理器

hamvmqm 移动队列管理器 (HA Move Queue Manager) /m QMgrName 队列管理器

/dd AbsoluteDataDirectory 数据目录的绝对路径 /ld AbsoluteLogDirectory 日志目录的绝对路径 备注：

将队列管理器移至 MSCS 存储空间

haregtyp 注册队列管理器 (HA Register Type) /r 注册 /u 注销 备注：

在 MSCS (Microsoft Cluster Server) 中注册或注销队列管理器 amqmsysn 检查模块版本信息 (System Check) 例:

amqmsysn

输出对话框，显示所有模块的版本信息和 MSCS Cluster 的信息. 高可用性 (High-Avalability，其它平台)

其它平台的 HA 方案由 MQ SupportPac 提供。 l MC63 AIX HACMP l MC66 HP ServiceGuard l MC68 Compaq TruCluster

疑问交易 (In-Doubt Transaction) dspmqtrn 显示疑问交易

[-e] Externally Coordinated，WMQ 作为资源管理器已经应答了交易 管理器2PC 中的 Phase 1 (Prepare to commit) 请求，但是 还没有收到 Phase 2 (Commit or Rollback) 请求.

[-i] Internally Coordinated，WMQ 作为交易管理器已经向资源管理 器发出了2PC 中的 Phase 1 (Prepare to commit) 请求，但 是还没有回答.

[-m QMgrName] 缺省为系统的缺省队列管理器 备注:

如果既不指定 -e 也不指定-i，则 Externally 和 Internally 都输出。由于在测试环境中无 法在 Phase 1 和 Phase 2 之间插入代码，很难模拟出 2PC 中断的情况。 rsvmqtrn 解决疑问交易

{-a | {-b | -c | -r RMID} Transaction}

-a All 。Commit 所有的 Internally Coordinated In-Doubt Transaction。向所有的资源管理器发 Phase 2 Commit 请求 -b Backout 指定的 Externally Coordinated In-Doubt Transaction。不接受资源管理器的 Phase 2 请求

-c Commit 指定的 Externally Coordinated In-Doubt Transaction。不接受资源管理器的 Phase 2 请求

-r RMID Commit Internally Coordinated In-Doubt Transaction。

忽略某一路的资源管理器，对其它的资源管理器发 Phase 2 Commit 请求。只有先在 Queue Manager 配置中删去此资源管理器项，才 可以用这个方法 Transaction 交易号

-m QMgrName 队列管理器 备注:

由于在测试环境中无法在 Phase 1 和 Phase 2 之间插入代码，很难模拟出 2PC 中断的情况.

消息 (Message)

amqsput 往队列中放消息 (Server 程序) QName 队列名

[QMgrName] 缺省为系统的缺省队列管理器 例:

amqsput Q QM

amqsputc 往队列中放消息 (Client 程序) QName 队列名

[QMgrName] 缺省为系统的缺省队列管理器 例:

amqsputc Q QM

amqsget 从队列中取消息 (Server 程序) QName 队列名

[QMgrName] 缺省为系统的缺省队列管理器 例:

amqsget Q QM

amqsgetc 从队列中取消息 (Client 程序) QName 队列名

[QMgrName] 缺省为系统的缺省队列管理器 例:

amqsgetc Q QM 工具 (Utility)

runmqsc 脚本命令服务器 (Run MQSC) [-e | -v | -w WaitTime [-x]]

-e export。MQSC 命令不再拷贝到输出 report 中

-v verify。检查命令的合法性，不执行。只有本地有效，不可与-w 或 -x 共用.

-w 命令在另一个队列管理器上执行，需要定义有相应的通道和传输队列 WaitTime 单位: 秒。min=1，max=999,999。

在指定的时间内等待命令的执行结果，每一条命令都会通过缺省队列 管理器， 以 PCF 的形式通过缺省队列管理器送达对方的 SYSTEM.ADMIN.COMMAND.QUEUE 中， 执行结果放入

SYSTEM.MQSC.REPLY.QUEUE 中。如果未指定缺省队列管理器，

runmqsc -w 会失败.

-x 目标队列管理器是 MQ for z/OS，和-w 共用。MQSC 命令要符 合 z/OS 的命令格式。

[QMgrName] 目标队列管理器 (不一定是直连的缺省队列管理器) 例:

runmqsc -v QM < QM.tst

runmqsc -v QM < QM.in > QM.out mqrc 原因码查询 (MQ Reason Code) l 通过一个或一段原因码查询 mqrc [-a] mqrc -r [-a]

mqrc -R [-f -l ] [-a] l 通过一个或一段消息代号查询 mqrc [-a] AMQ

mqrc -m [AMQ] [-a] mqrc -M -f -l [-a] l 通过原因码符号查询 mqrc mqrc -s l 显示帮助界面

mqrc –h 显示帮助界面 mqrc –v 显示版本信息 l 通用选项

-a 在所有的级别中寻找 -f 起始数 -l 终止数 备注：

n 原因码如果是从 1 到9 打头，则认为是十进制数，如果是0x 打头，则认为是十六进制数。

n 如果一段原因码或消息代号未指明始末，则按最大范围查询。

n 如果一段原因码或消息代号查询中有错误，则在查询结果前会有以下标识。 ? 原因码不存在

! 原因码与消息的查询级别不一不致 例:

mqrc 2058

2058 0x0000080a MQRC_Q_MGR_NAME_ERROR mqrc 0x0000080a

2058 0x0000080a MQRC_Q_MGR_NAME_ERROR mqrc MQRC_Q_MGR_NAME_ERROR 2058 0x0000080a mqrc AMQ9001

36865 0x00009001 rrcI_NORMAL_CHANNEL_END MESSAGE:

通道程序正常结束.

EXPLANATION:

通道程序 '' 正常结束. ACTION: 不必响应.

amqfirst MQ 第一步，仅Window 平台 例:

amqfirst

amqapi API 试验程序，仅Windows 平台 例: amqapi

amqpcard MQI 明信片程序，仅Windows 平台 例:

amqpcard

amqmtbrn MQ Task Bar，仅Windows 平台 例:

amqmtbrn

amqmjpse 准备 MQ 向导，仅Windows 平台

-l 创建 Log 记录文件，系统会把“Prepare WebSphere MQ Wizard” 的执行过程追加到指定的文件中。如果未指明路径， 则使用 WebSphere MQ Data 路径， 如果未指明文件名， 则使用 AMQMJPSE.LOG

-r 重 置 (Reset) MQSeriesService 用户帐号。“ Prepare

WebSphere MQ Wizard”在第一次被执行的时候会自动创建出一个 帐户MUSR_MQADMIN，具有一定的设置与权限，MQSeriesService 部件都用这个帐户运行。在网络发生变化后，也许“准备WebSphere MQ 向导”会要求重新运行，以domain 用户替代，所以需要重置用 户帐号。

-s 安静 (silent) 安装模式，无输入输出。

-p 从指定文件中读取参数。如果未指明路径，则使用WebSphere MQ Data 路径，如果未指明文件名，则使用AMQMJPSE.INI。文件中应 该有以下配置段落： [Services]

[DefaultConfiguration] [RemoteAdministration]

事实上，安静安装模式中使用的就是AMQJPSE.INI

-m 产生安装报告文件。产生Microsoft System Management Server (SMS) 的文件 .MIF，如果没有指明路径，则使用WebSphere MQ Data 路径，如果没有指明文件名，则使用AMQMJPSE.MIF。 amqmgse MQ 缺省配置 例:

amqmgse

amqinfon MQ 信息中心文档 (MQ Info Center) 例:

amqinfon

crtmqcvx 创建数据转换程序框架 (Create Conversion) SourceFile TargetFile 例:

crtmqcvx MyFormat.h MyFormat.c MyFormat.h ----------

typedef struct MyFormat {

MQLONG l; MQCHAR c; MQBYTE b;

MQLONG la [3]; // MQLONG Array MQCHAR ca [5]; // MQCHAR Array MQBYTE ba [6]; // MQBYTE Array } MYFORMAT; MyFormat.c ----------

MQLONG ConvertMyFormat ( PMQBYTE *in_cursor, PMQBYTE *out_cursor, PMQBYTE in_lastbyte, PMQBYTE out_lastbyte, MQHCONN hConn, MQLONG opts,

MQLONG MsgEncoding, MQLONG ReqEncoding, MQLONG MsgCCSID, MQLONG ReqCCSID, MQLONG CompCode, MQLONG Reason) {

MQLONG ReturnCode=MQRC_NONE; ConvertLong(1); /* l */ ConvertChar(1); /* c */ ConvertByte(1); /* b */ AlignLong();

ConvertLong(3); /* la */ ConvertChar(5); /* ca */ ConvertByte(6); /* ba */ Fail:

return(ReturnCode); }

runmqdlq 运行死信队列处理器 (Run Dead-Letter Queue Handler) [QName [QMgrName]]

QName 死信队列，缺省为队列管理器的缺省死信队列 QMgrName 队列管理器，缺省为系统缺省队列管理器 例:

runmqdlq SYSTEM.DEAD.LETTER.QUEUE QM

runmqchi 运行通道初始化程序 (Run Channel Initiator) [-q InitiationQName] 缺省为 SYSTEM.CHANNEL.INITQ [-m QMgrName] 缺省为系统的缺省队列管理器 例:

runmqchi -q SYSTEM.CHANNEL.INITQ QM runmqchl 运行通道 (Run Channel) -c ChannelName 通道名

[-m QMgrName] 缺省为系统的缺省队列管理器 例:

runmqchl -c C_C.S -m QM

dspmqfls 显示对象对应的文件名 (Display Files) [-m QMgrName] 缺省为系统的缺省队列管理器 [-t ObjectType]

nl 或namelist 名字列表 prcs 或process 进程 q 或queue 队列

ql 或qlocal 本地队列 qa 或qalias 别名队列 qr 或qremote 远程队列 qm 或qmodel 模型队列 qmgr 队列管理器

syncfile 通道同步文件 ctlg 或catalog 对象目录

authinfo 授权信息，SSL 通道 *或all 全部

GenericObjName 对象名字，可以用通配符 例:

dspmqfls -m QM -t queue Q

WebSphere MQ 显示 MQ 文件 QLOCAL Q

C:\\Program Files\\IBM\\WebSphere MQ\\qmgrs\\QM\\QUEUES\\Q dspmqfls -m QM Q

WebSphere MQ 显示 MQ 文件 CATALOGUE 对象编目

C:\\Program Files\\IBM\\WebSphere MQ\\qmgrs\\QM\\QMANAGER\\QMQMOBJCAT QMGR 队列管理器对象

C:\\Program Files\\IBM\\WebSphere MQ\\qmgrs\\QM\\QMANAGER\\QMANAGER QLOCAL Q

C:\\Program Files\\IBM\\WebSphere MQ\\qmgrs\\QM\\QUEUES\\Q

setmqscp设置服务连接点 (Set Service Connection Point, 仅Windows 平台)

[-a [-m QMgrName]] Add 。在Active Directory 中增加WebSphere MQ Client Connections 。WebSphere MQ folder 名 为

CN=IBM-MQClientConnections，QMgrName 可以是通配符 *

[-r [-m QMgrName]] Remove 。在 Active Directory 中删除 Service Connection Point。如果未指明-m QMgrName，且不存在 Client Connection 定 义，则删除 IBM-MQClientConnections folder。QMgrName 可以是 通配符 *

[-d] Display。显示 Active Directory 中的 Service Connection Point 例:

setmqscp -d

setmqcrl 设置无效论证列表 (Set Certificate Revocation List (CRL) LDAP Server Definitions, 仅Windows 平台)

[-a [-m QMgrName]] Add。在 Active Directory 中增加 CRL，QMgrName 可以是通 配符 *

[-r [-m QMgrName]] Remove。在 Active Directory 中删除 CRL [-d] Display。显示 Active Directory 中的 CRL 例:

setmqcrl -d

amqmcert Client 证书配置工具 (Utility for Certification) [server] 机器名，缺省为本机 [-k {sslkeyr | CA | ROOT | MY}] sslkeyr 替代 MQSSLKEYR 值

CA 用 IE 中的 Certificate Store CA

ROOT 用 IE 中的 Certificate Store ROOT MY 用 IE 中的 Certificate Store MY

[-m qmgr] 队 列 管 理 器 ， 此选项会根据队列管理器的 SSLKEYR 定位 Certificate Store

[-h] Host ， 引用本机的 Certificate Store 。

Windows 系统允许两套 Certificate Store 。分别在

HKEY_CURRENT_USER 和 HKEY_LOCAL_MACHINE. [-a [handle] [-p filename -z password]] Add，增加证书.p12，.pfx

[-s filename] CA certificate 文件.der，.pb7，.cer [-x handle] Export，导出证书

[-d handle] Assign，指定工作证书 [-r handle] Remove，删除证书 [-u] Unassign，取消工作证书 [-l] List，列出所有证书 例:

amqmcert -l // 用 MQSSLKEYR amqmcert -l -k C:\\mqm\\key amqmcert -l -m QM amqmcert -l -k ROOT -h

amqmcert -l -k CA -h amqmcert -l -k MY

amqmcert -m QM -a 102 amqmcert -a 102

amqmcert -a 4 -k MY -m QM amqmcert -m QM -d 122 amqmcert -d 123

amqmcert -a -p mqper.pfx -z password amqmcert -a -s mqcacert.cer

ffstsummary FFST文件摘要 (FFST Summary) FFST 文件名格式为AMQpid.seq.FDC

ffstsummary 会对当前目录下的所有 FFST 文件进行分析，输出摘要 例:

ffstsummary

AMQ03624.0.FDC 2002/11/30 23:00:00 amqzxma0 3624 1 AD004001 adhOpen arcE_OBJECT_MISSING OK

AMQ03624.0.FDC 2002/11/30 23:00:00 amqzxma0 3624 1 AQ168001 aqpReadData arcE_OBJECT_MISSING OK

AMQ03624.0.FDC 2002/11/30 23:00:00 amqzxma0 3624 1 AQ143008 aqqAccessQHeader arcE_OBJECT_DAMAGED OK mqaxlev 显示 Code Level

有时候在碰上疑难杂症时，IBM Service Team 会要求调查所安装 WebSphere MQ 的 Code Level。找到运行的 mqax200.dll，用 mqaxlev 命令即可查看. 例:

cd C:\\Program Files\\IBM\\WebSphere MQ\\bin mqaxlev mqax200.dll > CodeLevel.txt amqrfdm 查询 MQ Cluster Repository

[-m QMgrName] 缺省为系统的缺省队列管理器 例:

amqrfdm -m QM #) Summary

q) Print Cluster Queues s) Print Subscriptions

m) Print Cluster Queue Managers o) Output entire cache a) Print Free Areas r) Print Registrations

d) Dump Area of repository t) Browse Transmission Queue D) Disconnect f) Set Filters (Off) +) Set Details level

Enter option character Q - Quit amquregn Registry 值列表工具

fname 文件名，内含需要列出的键值 例:

amquregn -?

ERROR: unable to open file -?，fopen return code was 123 --------------------------------------------------------- --------------------------------------------------------- Environment follows.... =::=::\\ =C:=C:\\

=D:=C:\\Program Files\\IBM\\WebSphere MQ\\bin =E:=E:\\WMQ\\MQ_Samples\\UserExit =ExitCode=00000001

ALLUSERSPROFILE=C:\\Documents and Settings\\All Users ANT_HOME=C:\\jakarta-ant-1.5.1

MQ_JAVA_DATA_PATH=C:\\Program Files\\IBM\\WebSphere MQ

MQ_JAVA_INSTALL_PATH=C:\\Program Files\\IBM\\WebSphere MQ\\Java amqmdain MQ 服务控制命令，仅Windows 平台

用于配置和管理 WebSphere MQ Service。相当于Windows MQ Services snap-in start QMgrName 启动队列管理器服务 end QMgrName 停止队列管理器服务

auto QMgrName 将队列管理器服务设置为自动启动 manual QMgrName 将队列管理器服务设置为手工启动 crtlsr QMgrName LsrParams 创建队列管理器中的监听器

LsrParams 监听器参数，与 runmqlsr 命令的参数相同。比如-t trptype -p port

crttrm QMgrName QueueName 创建触发监控器 crtchi QMgrName InitQName 创建通道初始器

status 如果没有指定参数，则输出 WMQ Service 的状态 QMgrName 输出指定队列管理器 Service 的状态 all 输出所有队列管理器

cstmig filename 导入 Custom Service 定义文件。

文件格式为 Command Name，Start Command，End Command， Flags，Reserved。

例: PubSub Broker，strmqbrk -p blue.queue.manager， endmqbrk -i -m blue.queue.manager，SUFFIX | ROOT | STARTUP | SHUTDOWN | COMMAND，1

regsec 确保 Registry 中的 security permissions 正确

spn qmgrname Set 或 Unset 队列管理器的 Serivce Principal set unset

reg [QMgrName | *] RegParams

修 改 Windows Registry 中 RegParams 指定的配置段落 (stanza) 及 WebSphere MQ 属性参数。 -c add -s stanza -v attribute=value

-c remove -s stanza -v [attribute|*] -c display -s stanza -v [attribute|*] * 配置段落 (stanza) 可以是 ApiExitCommon\\name ApiExitTemplate\\name ACPI

AllQueueManagers Channels

DefaultQueueManager LogDefaults

QMgrName 配置段落 (stanza) 可以是 XAResourceManager\\name ApiExitLocal\\name Channels ExitPath Log

QueueManagerStartup TCP LU62 SPX NetBios 例:

amqmdain status

5724-B41 (C) Copyright IBM Corp。1994，2002。ALL RIGHTS RESERVED. MQSeries 服务状态是: 就绪 amqmdain status QM

5724-B41 (C) Copyright IBM Corp。1994，2002。ALL RIGHTS RESERVED. MQSeries 服务状态是: 就绪

队列管理器?QM?状态为: 正在运行 0 队列管理器 (正在运行) 1 命令服务器 (已停止)

amqmsrvn COM 服务器，仅Windows 平台

amqmsrvn 由所有使用这个 COM 组件的 client 程序共享。比如: WebSphere MQ Services snap-in，Alert Monitor Task Bar，WebSphere MQ Service。amqmsrvn 供所有的交互的和 非交互的应用使用，它必须被一个特殊的用户 (MUSR_MQADMIN) 启动，这个用户的口令是随机产生的.

如果要改变用户名，可以先自己创建一个用户 NEW_NAME，然后用 amqmsrvn 设置，例: amqmsrvn -user NEW_NAME -password 如果要恢复到 MUSR_MQADMIN，则: amqmjpse -r

附录 MQSC 命令一览表 RUNMQSC

WebSphere MQ 为所有的开放平台 (Windows 和UNIX) 提供了相同的管理界面。通过 交互命令行的方式执行WebSphere MQ Script Commands (MQSC)。这个通用的管理工具称为

ACTION( COMMIT | BACKOUT ) 手工将通道中处于不确定 (In doubt) 状态的消息提交或回

滚。用于SDR、SVR、CLUSSDR 通道。 解决通道中处于不确定状态的消息。 PING

PING QMGR PING QMGR

检查队列管理器的对 SYSTEM.ADMIN.COMMAND.QUEUE 是否有反映，检查命令服务器是否工作正 常。

PING CHANNEL

PING CHANNEL(channel_name )

[ DATALEN( 16 | integer) ] PING 数据包的大小，16-32,768 字节。 检查对方的队列管理器或端口监听器是否启动，也可以检查对方的通道定义是否正确。但不检查通道 的通性状态。换句话说，PING CHANNEL 只检查通道能否连连通，而不检查目前是否连通。 RESET

RESET CHANNEL

RESET CHANNEL(channel_name )

[ SEQNUM( 1 | integer) ] 消息序号，两端的值应该相同 重设通道的消息序号 RESET CLUSTER

RESET CLUSTER(cluster_name) ]

ACTION( FORCEREMOVE ) 强行将队列管理器从群集中删除 QMNAME(string ) | QMID(string ) 指定队列管理器。QMNAME 为队列管理器名，QMID 为 队列管理器ID

[ QUEUES( NO | YES ) ] 是否被删除的队列管理器中的群集队列也被一并删除 REFRESH

REFRESH CLUSTER

REFRESH CLUSTER(cluster_name) ]

[ REPOS( NO | YES ) ] 是否连同配置库信息一并删除重建 NO 保留本地群集信息中的配置库队列管理器名，

如果该结点自身就是配置库队列管理器，则会记住群集中 的其它配置库队列管理器，其余的信息都被删除重建。通 常用于队列管理器上的群集信息发生混乱时手工更新。 YES 在本地群集信息中连群集中配置库队列管理器

名也被删除重建。用于非配置库队列管理器。如果该结点 自身就是配置库队列管理器，则不能用 REPOS (YES)，应 该先将结点改成非配置库，刷新后，再改回来。通常用于 群集中有配置库队列管理器的地位发生变化，需要手工更 新。

该命令首先删除所有本地已有的群集信息，然后通过与附近的配置库队列管理器交换信息来重建本地

的群集信息。通常用于非配置库队列管理器。

REFRESH SECURITY REFRESH SECURITY

刷新队列管理器中所有的权限配置信息 SUSPEND

SUSPEND QMGR CLUSTER

SUSPEND QMGR CLUSTER (cluster_name)

[ MODE( QUIESCE | FORCE ) ] QUIESCE 通知群集中的其它队列管理器不要再向该 队列管理器发送消息

FORCE 除此之外，断开该队列管理器的所有接收 端通道

暂时将队列管理器从群集中挂起。 SUSPEND QMGR CLUSNL

SUSPEND QMGR CLUSNL (namelist_name)

[ MODE( QUIESCE | FORCE ) ] QUIESCE 通知群集中的其它队列管理器不要再向该 队列管理器发送消息

FORCE 除此之外，断开该队列管理器的所有接收 端通道

暂时将队列管理器从群集列表中挂起。 RESUME

RESUME QMGR CLUSTER

RESUME QMGR CLUSTER (cluster_name) 将队列管理器恢复回到群集中。 RESUME QMGR CLUSNL

RESUME QMGR CLUSNL (namelist_name) 将队列管理器恢复回到群集列表中。

RUNMQSC。 执行脚本

可以把要执行的命令先放入脚本文件中，用重定向的方法将其输入，输出也可以定向到 另一个结果文件中。脚本文件通常用tst 文件后缀。执行的时候，RUNMQSC 会首先回显命

令，然后显示执行结果。所以，结果文件中既有命令的执行结果，也有命令本身。 runmqsc QM < test.tst > test.out 抑制回显

可以用-e 选项抑制回显命令，这样命令输出中就只有执行结果了。 runmqsc -e QM < mqscfile.in > myscfile.out 检验脚本

可以用 –v 选项对脚本文件中的命令进行语法检查而不执行。在真正执行命令脚本之前 用-v 选项检查一遍是一个好习惯。 runmqsc -v QM < myprog.in > myprog.out 远程管理

RUNMQSC 可以进行管理，这时RUNMQSC 工具首先连接本地缺省队列管理器，再通 过事先配置并连接好的通道，把命令发往指定的队列管理器，命令执行结果原路返回。由于 涉及队列管理器之间的通信，可以用-w 选项设定超时时间 (秒)，如果在规定的时间内命令 结果没有返回，则执行失败。

runmqsc -w 100 QM < mqscfile.in > myscfile.out 批处理

开放平台都提供操作系统的批处理方式，如UNIX 中的SHELL 脚本，Windows 中的 BAT 文件。它与RUNMQSC 脚本文件结合就可以灵活自如地进行一些自动配置。例：创建

并启动队列管理器，添加一个本地队列，放入三条消息。 // batch.sh 或 batch.bat crtmqm QM strmqm QM

runmqsc QM < config.tst amqsput Q QM < data.txt // config.tst

DEFINE QLOCAL (Q) // data.txt string 1 string 2 string 3

如果在批处理中需要有变量代入，在UNIX 中可以利用 EOF 将批处理命令和MQSC 配置命令写在一起。例： export QMgrName=QM export QName=Q export Data=string // batch.sh

crtmqm $QMgrName strmqm $QMgrName

runmqsc $QMgrName << EOF DEFINE QLOCAL ($QName) EOF

amqsput $QName $QMgrName << EOF $Data 1 $Data 2 $Data 3 EOF

对于 RUNMQSC 本身的语法，请参见相关附录 (WebSphere MQ 命令一览表)。 MQSC 命令 结构图

所有的 MQSC 命令开始的语法格式都是动作 (Action) + 对象 (Object) + 参数 (Parameter)。开放平台的MQSC 命令结构如下： ALTER CLEAR

DEFINE DELETE DISPLAY PING

RESET REFRESH RESOLVE RESUME START STOP SUSPEND AUTHINFO CHANNEL PROCESS NAMELIST QALIAS QLOCAL QMGR QMODEL QREMOTE AUTHINFO CHANNEL PROCESS NAMELIST QALIAS QLOCAL QMODEL QREMOTE QLOCAL AUTHINFO CHANNEL CHSTATUS CLUSQMGR

PROCESS NAMELIST QALIAS QCLUSTER QLOCAL QMGR QMODEL QREMOTE QUEUE QSTATUS CHANNEL QMGR CLUSTER SECURITY CHANNEL CLUSTER CHANNEL

QMGR CLUSTER QMGR CLUSNL CHANNEL CHINIT LISTENER

DEFINE 命令用来定义创建各种WebSphere MQ 对象，在创建的时候可以指定对象的各 种属性，DELETE 用来删除它们。ALTER 可以修改这些对象的属性，此外，ALTER 可以修

改队列管理器的属性。DISPLAY 用来显示各对象的属性、队列和通道的工作状态、群集中 的队列和队列管理器。

START 用来启动通道及通道相关的对象，比如通道初始化程序、端口监听器。STOP 正 相反，用来停止通道。有时通道会处于不确定 (In-doubt) 状态，表示不知道对方是否收到 该消息，两边对消息是否到达的判断可能不一致。RESOLVE 命令可以在两侧手工地将状态 调整到一致。PING 命令经常用来检查已方的命令服务器是否启动，也可以检查对方的队列 管理器或端口监听器是否启动，还可以检查对方的通道定义是否正确。

RESET 可以重置通道计数，也可以将队列管理器从群集中删除。REFRESH 可以刷新

WebSphere MQ 安全性高速缓存，也可以刷新群集中队列管理器的群集信息。SUSPEND 和 RESUME 都是针对群集的操作，前者将队列管理器隔离出去，后者将其恢复回来。 MQSC 的动作可以有简写方式，如下表： 全称 简称 说明

DEFINE DEF 创建定义对象 DELETE DELETE 删除对象 ALTER ALT 修改对象属性 DISPLAY DIS 显示对象属性

CLEAR CLEAR 清除本地队列内容

START STA 启动通道、通道启动程序、监听器 STOP STOP 停止通道

RESOLVE RESOLVE 手工提交或回滚通道传送事务 PING PING 测试队列管理器或通道是否工作 RESET RESET 重置通道或群集

REFRESH REF 刷新群集或安全信息

SUSPEND SUSPEND 暂挂队列管理器，从群集中隔离出去 RESUME RESUME 恢复队列管理器，回到群集中去 对象也可以有简写方式，如下表： 全称 简称 说明

QMGR QMGR 队列管理器 QUEUE Q 队列

QLOCAL QL 本地队列 QREMOTE QR 远程队列 QALIAS QA 别名队列 QMODEL QM 模型队列 QSTATUS QS 队列状态 CHANNEL CHL 通道

CHSTATUS CHS 通道状态 CHINIT CHI 通道初始程序 LISTENER LSTR 监听器 NAMELIST NL 名称列表 PROCESS PRO 进程定义

AUTHINFO AUTHINFO 认证信息 QCLUSTER QC 群集队列

CLUSQMGR CLUSQMGR 群集队列管理器 CLUSTER CLUSTER 群集

CLUSNL CLUSNL 群集名称列表 SECURITY SECURITY 安全信息 DEFINE

DEFINE 命令用来定义创建WebSphere MQ 对象，这些对象可以是队列 (QLOCAL、

QREMOTE、QALIAS、QMODEL)，通道 (SDR、SVR、RCVR、RQSTR、CLNTCONN、 SVRCONN、CLUSSDR、CLUSRCVR)，进程定义，名称列表，认证信息。 DEFINE QLOCAL

DEFINE QLOCAL(q_name)

[ CLUSTER(cluster_name) ] 队列所属的群集名

[ CLUSNL(namelist_name) ] 队列所属的群集列表名

[ SCOPE( QMGR | CELL ) ] 队列属于队列管理器，还是属于DCE Cell 工作单元 [ DESCR(string) ] 描述字串

[ LIKE(qlocal_name) ] 未指定的属性缺省值从指定队列拷贝。如果不设定LIKE， 系统从SYSTEM.DEFAULT.LOCAL.QUEUE 中拷贝

[ NOREPLACE | REPLACE ] 未指定的属性是否用缺省值替换 [ USAGE( NORMAL | XMITQ ) ] 正常的本地队列，还是传输队列

[ DISTL( NO | YES ) ] Distribution List。对方的队列管理器是否支持分发列表，这 个属性由MCA 设定，在传输队列 (USAGE= XMITQ) 中 有效

[ DEFPRTY(integer) ] Default Priority。消息的缺省优先级

[ DEFPSIST( NO | YES ) ] Default Persistence。消息的缺省持久性

[ DEFBIND( NOTFIXED | OPEN ) ] Default Binding 。缺省绑定方式， 对MQOPEN (MQOO_BIND_AS_Q_DEF)有效

[ DEFSOPT( EXCL | SHARED ) ] Default Share Option。缺省MQPUT 共享方式，对MQOPEN (MQOO_INPUT_AS_Q_DEF) 有效

[ NOSHARE | SHARE ] MQGET 共享方式

[ GET( ENABLED | DISABLED ) ] 允许或禁止 MQGET [ PUT( ENABLED | DISABLED ) ] 允许或禁止 MQPUT [ MAXDEPTH(integer) ] Max Depth。队列的最大深度

[ MAXMSGL(integer) ] Max Message Length。队列中消息的最大长度

[ MSGDLVSQ( PRIORITY | FIFO ) ] Message Delivery Sequence。消息排序方式 [ RETINTVL(integer) ] Retrieval Interval。队列的生命周期，单位：小时。 [ BOQNAME(string) ] Backout Queue Name。回滚超量后的目标队列 [ BOTHRESH(integer) ] Backout Thresh。回滚计数阀值

[ NOHARDENBO | HARDENBO ] Harden Backout。是否固化回滚计数

[ QDPHIEV( ENABLED | DISABLED ) ] Queue Depth High Event。设置队列深度高性能事件开关

[ QDEPTHHI(integer) ] Queue Depth High。队列高位阀值百分比，在QDPHIEV= ENABLED 时生效，当队列深度上升至大于等于该值时， 出现性能事件

[ QDPLOEV( ENABLED | DISABLED ) ] Queue Depth Low Event。设置队列深度低性能事件开关

[ QDEPTHLO(integer) ] Queue Depth Low。队列低位阀值百分比，在QDPLOEV = ENABLED 时生效，当队列深度下降至小于该值时，出现 性能事件

[ QDPMAXEV( ENABLED | DISABLED ) ] Queue Depth Max Event。设置队列满性能事件开关

[ QSVCIEV( NONE | HIGH | OK ) ] Queue Service Event。设置队列服务间隔开关 [ QSVCINT(integer) ] Queue Service Interval。队列服务间隔定时，单位：毫秒。 在QSVCIEV= HIGH 或 OK 时生效 [ NOTRIGGER | TRIGGER ] 触发器开关

[ TRIGTYPE( FIRST | EVERY | DEPTH | NONE ) ] 触发类型 (Trigger Type) [ INITQ(string) ] 触发初始化队列名 [ PROCESS(string) ] 触发进程定义名

[ TRIGDPTH(integer) ] 触发深度，当TRIGTYPE = DEPTH 时生效

[ TRIGMPRI(integer) ] Trigger Message Priority。触发消息优先级，只有大于等于 该优先级的消息才会引起触发

[ TRIGDATA(string) ] 触发数据字串，会映射到MQTM 或MQTMC2 数据结构的 TriggerData 域 创建本地队列。 DEFINE QREMOTE

DEFINE QREMOTE(q_name)

[ CLUSTER(cluster_name) ] 队列所属的群集名

[ CLUSNL(namelist_name) ] 队列所属的群集列表名

[ SCOPE( QMGR | CELL ) ] 队列属于队列管理器，还是属于DCE Cell 工作单元 [ DESCR(string) ] 描述字串

[ LIKE(qlocal_name) ] 未指定的属性缺省值从指定队列拷贝。如果不设定LIKE， 系统从SYSTEM.DEFAULT.REMOTE.QUEUE 中拷贝

[ NOREPLACE | REPLACE ] 未指定的属性是否用缺省值替换 [ DEFPRTY(integer) ] 消息的缺省优先级 [ DEFPSIST( NO | YES ) ] 消息的缺省持久性

[ DEFBIND( NOTFIXED | OPEN ) ] 缺省绑定方式，对MQOPEN (MQOO_BIND_AS_Q_DEF) 有效

[ PUT( ENABLED | DISABLED ) ] 允许或禁止 MQPUT [ RQMNAME(string) ] 目标队列管理器名 [ RNAME(string) ] 目标队列名

[ XMITQ(string) ] 传输队列名，如同不指定，则先找RQMNAME 同名的传 输队列，再找队列管理器的缺省传输队列，如果都找不到， 去死信队列 创建远程队列。 DEFINE QALIAS

DEFINE QALIAS(q_name)

[ CLUSTER(cluster_name) ] 队列所属的群集名

[ CLUSNL(namelist_name) ] 队列所属的群集列表名

[ SCOPE( QMGR | CELL ) ] 队列属于队列管理器，还是属于DCE Cell 工作单元 [ DESCR(string) ] 描述字串

[ LIKE(qlocal_name) ] 未指定的属性缺省值从指定队列拷贝。如果不设定LIKE， 系统从SYSTEM.DEFAULT.ALIAS.QUEUE 中拷贝

[ NOREPLACE | REPLACE ] 未指定的属性是否用缺省值替换 [ DEFPRTY(integer) ] 消息的缺省优先级 [ DEFPSIST( NO | YES ) ] 消息的缺省持久性

[ DEFBIND( NOTFIXED | OPEN ) ] 缺省绑定方式，对MQOPEN (MQOO_BIND_AS_Q_DEF) 有效

[ GET( ENABLED | DISABLED ) ] 允许或禁止 MQGET [ PUT( ENABLED | DISABLED ) ] 允许或禁止 MQPUT [ TARGQ(string) ] 目标队列名 创建别名队列。 DEFINE QMODEL

DEFINE QMODEL(q_name) [ DESCR(string) ] 描述字串

[ LIKE(qlocal_name) ] 未指定的属性缺省值从指定队列拷贝。如果不设定LIKE， 系统从SYSTEM.DEFAULT.MODEL.QUEUE 中拷贝

[ NOREPLACE | REPLACE ] 未指定的属性是否用缺省值替换 [ USAGE( NORMAL | XMITQ ) ] 正常的本地队列，还是传输队列

[ DISTL( NO | YES ) ] 对方的队列管理器是否支持分发列表，这个属性由MCA

设定，在传输队列 (USAGE= XMITQ) 中有效 [ DEFPRTY(integer) ] 消息的缺省优先级 [ DEFPSIST( NO | YES ) ] 消息的缺省持久性

[ DEFTYPE( TEMPDYN | PERMDYN ) ] 缺省动态生成方式，是生成临时动态队列还是永久动态队 列

[ DEFSOPT( EXCL | SHARED ) ] 缺 省 MQPUT 共享方式， 对MQOPEN (MQOO_INPUT_AS_Q_DEF) 有效

[ NOSHARE | SHARE ] MQGET 共享方式

[ GET( ENABLED | DISABLED ) ] 允许或禁止 MQGET [ PUT( ENABLED | DISABLED ) ] 允许或禁止 MQPUT [ MAXDEPTH(integer) ] 队列的最大深度

[ MAXMSGL(integer) ] 队列中消息的最大长度

[ MSGDLVSQ( PRIORITY | FIFO ) ] 消息排序方式 (Message Delivery Sequence) [ RETINTVL(integer) ] 队列的生命周期，单位：小时 [ BOQNAME(string) ] 回滚超量后的目标队列 [ BOTHRESH(integer) ] 回滚计数阀值

[ NOHARDENBO | HARDENBO ] 是否固化回滚计数

[ QDPHIEV( ENABLED | DISABLED ) ] 设置队列深度高性能事件开关

[ QDEPTHHI(integer) ] 队列高位阀值百分比，在QDPHIEV= ENABLED 时生效， 当队列深度上升至大于等于该值时，出现性能事件

[ QDPLOEV( ENABLED | DISABLED ) ] 设置队列深度低性能事件开关

[ QDEPTHLO(integer) ] 队列低位阀值百分比，在QDPLOEV = ENABLED 时生效， 当队列深度下降至小于该值时，出现性能事件

[ QDPMAXEV( ENABLED | DISABLED ) ] 设置队列满性能事件开关 [ QSVCIEV( NONE | HIGH | OK ) ] 设置队列服务间隔开关

[ QSVCINT(integer) ] 队列服务间隔定时，单位：毫秒。在QSVCIEV= HIGH 或 OK 时生效

[ NOTRIGGER | TRIGGER ] 触发器开关

[ TRIGTYPE( FIRST | EVERY | DEPTH | NONE ) ] 触发类型 (Trigger Type) [ INITQ(string) ] 触发初始化队列名 [ PROCESS(string) ] 触发进程定义名

[ TRIGDPTH(integer) ] 触发深度，当TRIGTYPE = DEPTH 时生效

[ TRIGMPRI(integer) ] 触发消息优先级，只有大于等于该优先级的消息才会引起 触发

[ TRIGDATA(string) ] 触发数据字串，会映射到MQTM 或MQTMC2 数据结构的 TriggerData 域 创建模型队列。 DEFINE CHANNEL

DEFINE CHANNEL(channel_name )

CHLTYPE( SDR | SVR | RCVR | RQSTR | CLNTCONN | SVRCONN | CLUSSDR | CLUSRCVR )

通道类型，会使后面的参数选项有所不同

CONNAME(string) 连接参数。对于SDR、RQSTR、CLNTCONN、CLUSSDR、

CLUSRCVR，此参数选项是必需的

XMITQ(string) 传输对于名。对于SDR、SVR，此参数选项是必需的 [ CLUSTER(cluster_name) ] 队列所属的群集名

[ CLUSNL(namelist_name) ] 队列所属的群集列表名 [ DESCR(string) ] 描述字串

[ LIKE(channel_name) ] 未指定的属性缺省值从指定通道拷贝。如果不设定LIKE， 系统从SYSTEM.DEF.*中拷贝

[ NOREPLACE | REPLACE ] 未指定的属性是否用缺省值替换

[ TRPTYPE( LU62 | TCP | NETBIOS | SPX ) ]通信协议，通道双方设置应该相同 [ CONNAME(string) ] 对方连接参数，与TRPTYPE 指定的通信协议有关 [ LOCLADDR(string) ] 本地连接参数，格式与CONNAME类似 [ TPNAME(string) ] 当 TRPTYPE=LU62 时，指定TP 名

[ USERID(string) ] 当 TRPTYPE=LU62 时，指定SNA Session 用户名

[ PASSWORD(string) ] 当 TRPTYPE=LU62 时，指定SNA Session 用户口令 [ MODENAME(string) ] 当 TRPTYPE=LU62 时，指定通信模式名

[ NETPRTY(integer) ] 通道优先级，当到达目标队列的路由有多种选择的时候， 系统会选取优先级最高的通道。取值0-9，只对CLUSRCVR 有效

[ NPMSPEED( NORMAL | FAST ) ] 非持久消息的速度，如果设置成FAST，则该通道称为快速

通道 (FastPath)，非持久消息可以不参与等待批量消息而直 接发送

[ PUTAUT( DEF | CTX ) ] 对于消息通道，表示消息放入目标队列时权限检查所针对 的用户名。对于MQI 通道，表示MQ API 操作时权限检查 所针对的用户名。DEF (Default) 表示用缺省用户。CTX (Context) 表示用消息上下文中的UserIdentifier 域中的用 户名

[ QMNAME(string) ] 只对 CLNTCONN 有效，表示所在的队列管理器名

[ SEQWRAP(integer) ] 最大序列号，取值100-999,999,999。通道在传递消息时序 列号会不断增加，如果达到这个数字，则重新从1 开始

[ BATCHINT(integer) ] 批量间隔，单位毫秒。取值0-999,999,999 [ BATCHSZ(integer) ] 批量大小，取值0-9,999

[ BATCHHB(integer) ] 批量心跳间隔，单位毫秒。取值0-999,999。0 表示不发生 指不发生指心跳

[ HBINT(integer) ] 心跳间隔，单位秒。取值0-999,999。0 表示不发生心跳 [ DISCINT(integer) ] 自动断连间隔，单位秒。取值0-999,999。缺省为6000 秒 [ KAINT(integer) ] 保持连接间隔，单位秒。取值0-99,999。0 表示不使用 [ CONVERT( NO | YES ) ] 发送时是否对消息进行格式转换

[ MAXMSGL(integer) ] 通道能接受的最大消息长度，指的是物理消息长度。0 表 示使用队列管理器的最大消息长度设置 [ MCANAME(string) ] MCA 名字

[ MCATYPE( PROCESS | THREAD ) ] MCA 类型，可以选进程或线程 [ MCAUSER(string) ] MCA 用户名

[ RCVDATA(string) ] Receive Exit 用户数据

[ RCVEXIT(string) ] Receive Exit 名，由程序名和入口函数名组成，可以有多个， 用逗号隔开。例：?C:\\Exit1.dll (Func1), C:\\Exit2.dll (Func2)? [ SENDDATA(string) ] Send Exit 用户数据 [ SENDEXIT(string) ] Send Exit 名

[ MSGDATA(string) ] Message Exit 用户数据 [ MSGEXIT(string) ] Message Exit 名

[ SCYDATA(string) ] Security Exit 用户数据 [ SCYEXIT(string) ] Security Exit 名

[ MRDATA(string) ] Message Retry Exit 用户数据 [ MREXIT(string) ] Message Retry Exit 名

[ MRRTY(integer) ] Message Retry 重试次数，取值0-999,999,999

[ MRTMR(integer) ] Message Retry 重试间隔，单位毫秒，取值0-999,999,999 [ SHORTRTY(integer) ] 短重试次数，取值0-999,999,999

[ SHORTTMR(integer) ] 短重试间隔，单位秒，取值0-999,999 [ LONGRTY(integer) ] 长重试次数，取值0-999,999,999

[ LONGTMR(integer) ] 长重试间隔，单位秒，取值0-999,999

[ SSLCAUTH( REQUIRED | OPTIONAL ) ] 是否需要从 SSL Client 取证书 [ SSLCIPH(string) ] SSL 加密算法，如果为空，表示不用SSL 协议。通道双方 必须指定相同的加密算法

[ SSLPEER(string) ] 数字认证时用的 DN，如：?CN=QM1, OU=SWG, O=IBM, L=Shanghai, S=Shanghai, C=CN?。如果设置了该值，则在 SSL 握手时会检查对方证书的DN 是否与该值相同

1. Cluster (CLUSTER, CLUSNL) 只对CLUSSDR、CLUSRCVR 有效 2. Message Retry (MREXIT, MRDATA, MRRTY, MRTMR) 只对RCVR、RQSTR、CLUSRCVR 有效

3. Channel Retry (SHORTRTY, SHORTTMR, LONGRTY, LONGTMR) 只对SDR、SVR、CLUSSDR、

CLUSRCVR 有效

4. Batch (BATCHINT, BATCHSZ) 表示消息的批量发送，BATCHINT 只对SDR、SVR、CLUSSDR、

CLUSRCVR 有效，BATCHSZ 除此之外还可以对RCVR、RQSTR 有效。

5. HeartBeat (BATCHHB, HBINT) 表示通道心跳，BATCHHB 及与此相关的DISCINT 只对SDR、SVR、

CLUSSDR、CLUSRCVR 有效，HBINT 除此之外还可以对RCVR、RQSTR 有效。 6. SSLCAUTH 只对 RCVR、SVRCONN、CLUSRCVR、SVR、RQSTR 有效

7. MCA (MCATYPE, MCAUSER, MCANAME) 表示在通道上设定Message Channel Agent 的缺省参数，可

以对MCA 的工作方式和安全认证产生影响。MCANAME 只对SDR、SVR、RQSTR、CLUSSDR 有

效，MCATYPE 除此之外还可以对CLUSRCVR 有效，MCAUSER 的有效范围更大，还包括RCVR 和 SVRCONN 创建通道。

DEFINE PROCESS

DEFINE PROCESS(process_name)

[ APPLICID(string) ] 要触发的进程名字，最长256 字节。如果APPLTYPE=CICS， 则APPLICID 指的是CICS 交易名。会映射到MQTM 或 MQTMC2 数据结构的ApplId 域

[ APPLTYPE( CICS | DEF | DOS | OS2 | UNIX | WINDOWS | WINDOWSNT | NOTESAGENT | OS400 | integer) ]

要触发的进程类型

[ DESCR(string) ] 描述字串

[ LIKE(process_name) ] 未指定的属性缺省值从指定进程定义拷贝。如果不设定 LIKE，系统从SYSTEM.DEFAULT. PROCESS 中拷贝

[ NOREPLACE | REPLACE ] 未指定的属性是否用缺省值替换

[ ENVRDATA(string) ] 环境数据，会映射到MQTM 或MQTMC2 数据结构的 EnvData 域

[ USERDATA(string) ] 用户数据，会映射到MQTM 或MQTMC2 数据结构的 UserData 域 创建进程定义。 DEFINE NAMELIST

DEFINE NAMELIST(namelist_name) [ DESCR(string) ] 描述字串

[ LIKE(namelist_name) ] 未指定的属性缺省值从指定名字列表拷贝。如果不设定 LIKE，系统从SYSTEM.DEFAULT. NAMELIST 中拷贝

[ NOREPLACE | REPLACE ] 未指定的属性是否用缺省值替换

[ NAMES(string) ] 用逗号隔开的名字串，比如：Name1, Name2, Name3。最 长48 字节

创建名称列表。 DEFINE AUTHINFO

DEFINE AUTHINFO(authinfo_name)

AUTHTYPE( CRLLDAP ) 认证方式，这里只能是CRLLDAP

CONNAME (string) LDAP Server 的工作机器名或IP 地址及端口号，例： CONNAME('hostname(nnn)')，nnn 缺省为389 [ DESCR(string) ] 描述字串

[ LIKE(authinfo_name) ] 未指定的属性缺省值从指定认证信息拷贝。如果不设定 LIKE，系统从SYSTEM.DEFAULT.AUTHINFO.CRLLDAP 中拷贝

[ NOREPLACE | REPLACE ] 未指定的属性是否用缺省值替换 [ LDAPPWD (string) ] LDAP 用户名 [ LDAPUSER (string) ] LDAP 用户口令 创建认证信息。 DELETE

DELETE QLOCAL

DELETE QLOCAL(q_name) [ NOPURGE | PURGE ] 删除本地队列。

l NOPURGE 如果队列中有已提交的消息，停止删除。

l PURGE 不管队列中是否有已提交的消息，删除队列。消息也被删除。 DELETE QREMOTE

DELETE QREMOTE(q_name) 删除远程队列。 DELETE QALIAS

DELETE QALIAS(q_name) 删除别名队列。 DELETE QMODEL

DELETE QMODEL(q_name) 删除模型队列。 DELETE CHANNEL

DELETE CHANNEL(channel_name ) [ CHLTABLE( QMGRTBL | CLNTTBL ) ] 删除通道。

l CHLTABLE (QMGRTBL) 从队列管理器的通道定义表中删除，表中不含CLNTCONN 通道。缺省值

l CHLTABLE (CLNTTBL) 从 CLNTCONN 的通道定义表中删除 DELETE PROCESS

DELETE PROCESS(process_name ) 删除进程定义。

DELETE NAMELIST

DELETE NAMELIST(namelist_name ) 删除名称列表。

DELETE AUTHINFO

DELETE AUTHINFO(authinfo_name ) 删除认证信息。 ALTER

ALTER QMGR ALTER QMGR

[ FORCE ] 如果指定了缺省传输队列 DEFXMITQ，且有应用打开远程 队列并使用到DEFXMITQ。该次修改对此应用立即生效， 则需要FORCE 选项，否则出错

[ DESCR (string) ] 描述字串。也可以在crtmqm -c 时指定 [ CCSID(integer) ] Character Code Set Id。字符集

[ CHAD( DISABLED | ENABLED ) ] 设置通道自动定义开关

[ CHADEXIT(string) ] 通道自动定义出口程序 (Channel Auto Definition User Exit) [ CLWLEXIT(string) ] 群集负载用户出口程序 (Cluster Workload User Exit) [ CLWLDATA(string) ] 群集负载用户出口用户数据

[ CLWLLEN(integer) ] 能通过群集负载用户出程序路由的最长消息字节数 [ DEADQ(string) ] 死信队列名。也可以在crtmqm -u 时指定

[ DEFXMITQ(string) ] 缺省传输队列名。也可以在crtmqm -d 时指定

[ MAXHANDS(integer) ] 一个任务 (通常指一个队列管理器连接线程) 中最多同时 执有的打开对象的句柄数量。也可以在crtmqm -h 时指定 [ MAXMSGL(integer) ] 消息的最大长度

[ MAXUMSGS(integer) ] 最 多 的 非 提 交 (Uncommited) 的消息数量 。也可以在

crtmqm -x 时指定

[ LOCALEV( ENABLED | DISABLED ) ] Local Event。设置本地事件开关 [ REMOTEEV( ENABLED | DISABLED ) ] Remote Event。设置远程事件开关 [ INHIBTEV( ENABLED | DISABLED ) ] Inhibit Event。设置违禁事件开关

[ AUTHOREV( ENABLED | DISABLED ) ] Authorization Event。设置权限事件开关 [ STRSTPEV( ENABLED | DISABLED ) ] Start/Stop Event。设置启停事件开关

[ CHADEV( DISABLED | ENABLED ) ] Channel Auto Definition Event。设置通道自动定义事件开关

[ PERFMEV( ENABLED | DISABLED ) ] Performance Event。设置性能事件开关 [ REPOS(string) ] 群集名，队列管理器在该群集中担任配置库

[ REPOSNL(string) ] 群集列表名，队列管理器该列表的所有群集中担任配置库 [ SSLCRLNL(string) ] SSL 认证吊销列表名 [ SSLKEYR(string) ] SSL 认证库

[ TRIGINT(integer) ] Trigger Interval。当队列的触发类型TRIGTYPE=FIRST 时， TRIGINT 指定时效间隔。也可以在crtmqm -t 时指定 修改队列管理器属性。 ALTER QLOCAL

ALTER QLOCAL(q_name)

[ FORCE ] 如果有应用程序打开队列进行操作，该次修改对此应用立 即生效，则需要FORCE 选项 其它选项同 DEFINE QLOCAL 修改本地队列属性。 ALTER QREMOTE

ALTER QREMOTE(q_name)

[ FORCE ] 如果有应用程序打开队列进行操作，该次修改对此应用立 即生效，则需要FORCE 选项 其它选项同 DEFINE QREMOTE 修改远程队列属性。 ALTER QALIAS

ALTER QALIAS(q_name)

[ FORCE ] 如果有应用程序打开队列进行操作，该次修改对此应用立 即生效，则需要FORCE 选项 其它选项同 DEFINE QREMOTE 修改别名队列属性。 ALTER QMODEL

ALTER QMODEL(q_name) 选项同 DEFINE QMODEL 修改模型队列属性。 ALTER CHANNEL

ALTER CHANNEL(channel_name ) 选项同 DEFINE CHANNEL 修改通道属性。 ALTER PROCESS

ALTER PROCESS(process_name)

选项同 DEFINE PROCESS 修改进程定义属性。 ALTER NAMELIST

ALTER NAMELIST(namelist_name) 选项同 DEFINE NAMELIST 修改名称列表属性。 ALTER AUTHINFO

ALTER AUTHINFO(authinfo_name) 选项同 DEFINE AUTHINFO 修改认证信息属性。 DISPLAY

DISPLAY QMGR DISPLAY QMGR

[ ALL ] 显示所有属性，缺省值

[ CRDATE ] 创建日期，DEFINE QMGR 时自动设置 [ CRTIME ] 创建时间，DEFINE QMGR 时自动设置 [ ALTDATE ] 上一次修改日期，修改对象时自动更新 [ ALTTIME ] 上一次修改时间，修改对象时自动更新

[ CMDLEVEL ] 版本号，WebSphere MQ 5.3 的CMDLEVEL=530

[ COMMANDQ ] 命令队列，缺省为SYSTEM.ADMIN.COMMAND.QUEUE [ MAXPRTY ] 消息的最大优先级，缺省为9 [ PLATFORM ] 操作系统

[ QMID ] 队列管理器 ID，由系统内部产生，唯一标识该队列管理器 [ QMNAME ] 队列管理器名

[ SYNCPT ] 队列管理器是否支持同步 (SyncPoint) 其它选项同 ALTER QMGR 显示队列管理器属性。 DISPLAY QUEUE

DISPLAY QUEUE(generic_q_name)

[ TYPE( QALIAS | QCLUSTER | QLOCAL | QMODEL | QREMOTE ) ] 输入参数，队列类型

[ QTYPE ] 输出参数，队列类型 [ ALL ] 显示所有属性，缺省值

[ CRDATE ] 创建日期，DEFINE QMGR 时自动设置 [ CRTIME ] 创建时间，DEFINE QMGR 时自动设置 [ ALTDATE ] 上一次修改日期，修改对象时自动更新 [ ALTTIME ] 上一次修改时间，修改对象时自动更新 [ CLUSDATE ] 群集队列对于本地队列管理器生效的日期 [ CLUSTIME ] 群集队列对于本地队列管理器生效的时间 [ CLUSQMGR ] 群集队列的宿主队列管理器名 [ CLUSQT ] 群集队列类型

[ CLUSINFO ] 除了从本地队列管理器中查找队列外，也从该队列管理器 的群集信息 (Repository) 中查找。通常欲显示群集队列信 息需要加上CLUSINFO 选项

[ CURDEPTH ] 队列当前深度

[ IPPROCS ] 以读方式打开的句柄数 [ OPPROCS ] 以写方式打开的句柄数

[ QMID ] 队列管理器 ID，由系统内部产生，唯一标识该队列管理器 其它选项参见 DEFINE QLOCAL、QREMOTE、ALIAS、MODEL 显示队列属性。 DISPLAY QLOCAL

DISPLAY QLOCAL(generic_q_name) [ ALL ] 显示所有属性，缺省值

[ CRDATE ] 创建日期，DEFINE QMGR 时自动设置 [ CRTIME ] 创建时间，DEFINE QMGR 时自动设置 [ ALTDATE ] 上一次修改日期，修改对象时自动更新 [ ALTTIME ] 上一次修改时间，修改对象时自动更新 [ CLUSDATE ] 群集队列对于本地队列管理器生效的日期 [ CLUSTIME ] 群集队列对于本地队列管理器生效的时间 [ CLUSQMGR ] 群集队列的宿主队列管理器名 [ CLUSQT ] 群集队列类型

[ CLUSINFO ] 除了从本地队列管理器中查找队列外，也从该队列管理器 的群集信息 (Repository) 中查找。通常欲显示群集队列信 息需要加上CLUSINFO 选项 [ CURDEPTH ] 队列当前深度

[ IPPROCS ] 以读方式打开的句柄数 [ OPPROCS ] 以写方式打开的句柄数

[ QMID ] 队列管理器 ID，由系统内部产生，唯一标识该队列管理器 [ QTYPE ] 输出参数，队列类型 [TYPE] 与 QTYPE 相同

其它选项同 DEFINE QLOCAL 显示本地队列属性。 DISPLAY QREMOTE

DISPLAY QREMOTE(generic_q_name) [ ALL ] 显示所有属性，缺省值

[ CRDATE ] 创建日期，DEFINE QMGR 时自动设置 [ CRTIME ] 创建时间，DEFINE QMGR 时自动设置 [ ALTDATE ] 上一次修改日期，修改对象时自动更新 [ ALTTIME ] 上一次修改时间，修改对象时自动更新 [ CLUSDATE ] 群集队列对于本地队列管理器生效的日期 [ CLUSTIME ] 群集队列对于本地队列管理器生效的时间 [ CLUSQMGR ] 群集队列的宿主队列管理器名 [ CLUSQT ] 群集队列类型

[ CLUSINFO ] 除了从本地队列管理器中查找队列外，也从该队列管理器 的群集信息 (Repository) 中查找。通常欲显示群集队列信 息需要加上CLUSINFO 选项

[ QMID ] 队列管理器 ID，由系统内部产生，唯一标识该队列管理器 [ QTYPE ] 输出参数，队列类型

[TYPE] 与 QTYPE 相同

其它选项同 DEFINE QREMOTE 显示远程队列属性。 DISPLAY QALIAS

DISPLAY QALIAS(generic_q_name) [ ALL ] 显示所有属性，缺省值

[ CRDATE ] 创建日期，DEFINE QMGR 时自动设置 [ CRTIME ] 创建时间，DEFINE QMGR 时自动设置 [ ALTDATE ] 上一次修改日期，修改对象时自动更新 [ ALTTIME ] 上一次修改时间，修改对象时自动更新 [ CLUSDATE ] 群集队列对于本地队列管理器生效的日期 [ CLUSTIME ] 群集队列对于本地队列管理器生效的时间 [ CLUSQMGR ] 群集队列的宿主队列管理器名 [ CLUSQT ] 群集队列类型

[ CLUSINFO ] 除了从本地队列管理器中查找队列外，也从该队列管理器 的群集信息 (Repository) 中查找。通常欲显示群集队列信 息需要加上CLUSINFO 选项

[ QMID ] 队列管理器 ID，由系统内部产生，唯一标识该队列管理器 [ QTYPE ] 输出参数，队列类型 [TYPE] 与 QTYPE 相同

其它选项同 DEFINE QALIAS 显示别名队列属性。 DISPLAY QMODEL

DISPLAY QMODEL(generic_q_name) [ ALL ] 显示所有属性，缺省值

[ CRDATE ] 创建日期，DEFINE QMGR 时自动设置 [ CRTIME ] 创建时间，DEFINE QMGR 时自动设置 [ ALTDATE ] 上一次修改日期，修改对象时自动更新 [ ALTTIME ] 上一次修改时间，修改对象时自动更新 [ QTYPE ] 输出参数，队列类型 [TYPE] 与 QTYPE 相同

其它选项同 DEFINE QMODEL 显示模型队列属性。 DISPLAY QSTATUS

DISPLAY QSTATUS(q_name) TYPE( QUEUE ) [ ALL ] 显示所有状态，缺省值 [ CURDEPTH ] 队列的当前深度 [ IPPROCS ] 以读方式打开的句柄数 [ OPPROCS ] 以写方式打开的句柄数

[ UNCOM ] 是否有未提交的消息。取值YES 或NO DISPLAY QSTATUS(q_name) TYPE ( HANDLE ) [ ALL ] 显示所有状态

[ OPENTYPE ( ALL | INPUT | OUTPUT ) ] ALL 显示所有打开的句柄信息 INPUT 只显示读方式打开的句柄信息

OUTPUT 只显示写方式打开的句柄信息 [ PID ] 进程号，Process ID [ TID ] 线程号，Thread ID

[ APPLTAG ] 应用程序标签。取值z/OS 批处理作业名，TSO 用户名， CICS 应用名，IMS Region 名，通道初始化作业名，OS/400 作业名，UNIX 或Windows 进程名

[ APPLTYPE ] 应用程序类型。取值BATCH，RRSBATCH，CICS，IMS， CHINIT，SYSTEM，USER。其中CHINIT 表示通道初始 化程序，SYSTEM 表示MQ 系统程序，USER 表示用户程 序

[ CHANNEL ] 与句柄相关的通道名 [ CONNAME ] 与句柄相关的连接参数 [ USERID ] 句柄执有者的用户名

[ BROWSE ] 句柄是否以浏览方式打开 [ INPUT ] 句柄是否以读方式打开 [ OUTPUT ] 句柄是否以写方式打开 [ INQUIRE ] 句柄是否以查询方式打开 [ SET ] 句柄是否以设置方式打开 显示队列状态。 例： dis qs (Q)

AMQ8450: 显示队列状态详细信息。 QUEUE(Q) IPPROCS(1)

OPPROCS(2) CURDEPTH(5) UNCOM(NO)

dis qs (Q) type (handle) opentype (output) all AMQ8450: 显示队列状态详细信息。 QUEUE(Q) PID(3940)

APPLTAG(D:\\WMQ\\bin\\amqsput.exe) TID(1) APPLTYPE(USER) CHANNEL() CONNAME() BROWSE(NO) INPUT(NO) INQUIRE(NO) OUTPUT(YES) SET(NO) USERID(chenyux@T40XP) DISPLAY CHANNEL

DISPLAY CHANNEL(generic_channel_name) [ ALL ] 显示所有属性，缺省值

[ TYPE(ALL | SDR | SVR | RCVR | RQSTR | CLNTCONN | SVRCONN) ] 输入参数，通道类型

[ CHLTYPE ] 输出参数，通道类型 其它选项同 DEFINE CHANNEL 显示通道属性。

DISPLAY CHSTATUS

DISPLAY CHSTATUS(generic_channel_name)

[ CURRENT | SAVED ] CURRENT 只显示当前通道初始化程序执有的通道状 态，通常指连通或准备连通的通道状态，缺省值 SAVED 显示所有定义的通道状态

[ ALL ] 显示以下所有的状态选项，缺省值 [ CONNAME(connection_name) ] 连接参数 [ XMITQ(q_name) ] 传输队列

[ CURMSGS ] 当前传送批次中的消息序号，对发送端而言是发送的消息 序号，对接收端而言是接收的消息序号。一旦整批消息提 交或回滚，该值自动归零。通道两端的值应该相同

[ CURLUWID ] 当前 LUW 号，当前传送批次的交易号。最终会对整批消 息一起提交或回滚

[ CURSEQNO ] 当前消息序号，随着消息的传送该值会不断增加，直到超 过通道定义的最大序列号SEQWRAP 后自动重新从1 开 始，或者手工 RESET CHANNEL SEQNUM 。通道两端的 值应该相同

[ LSTLUWID ] 上一个 LUW 号，通道启动时置为全零。如果有错，则为 出错点的LUW号

[ LSTSEQNO ] 上一个序号。如果有错，则为出错点的序号 [ INDOUBT ] 通道是否处于不确定状态

[ STATUS ] 状态。取值STARTING，BINDING，INITIALIZING， RUNNING，STOPPING，RETRYING，PAUSED，STOPPED， REQUESTING。

STARTING 有启动请求，但尚未开始启动过程 BINDING 开始启动过程，处于握手协议中

INITIALIZING 通道初始化程序正在试图启动通道 RUNNING 运行状态，连接成功

STOPPING 有停止请求，但尚未开始停止过程

RETRYING 上一次连接失败，MCA 间隔一断时间后会 重试连接

PAUSED 等待消息重试间隔

STOPPED 已停止，用户停止了通道或重试次数达到 限制

REQUESTING 本地的 RQSTR通道与远程MCA 之间通信 [ BATCHES ] 自通道启动以来传送的批次数量 [ BATCHSZ ] 自通道启动时约定的批次大小

[ BUFSRCVD ] 自通道启动以来收到的传输缓冲区数量，只含控制消息包 [ BUFSSENT ] 自通道启动以来发送的传输缓冲区数量，只含控制消息包 [ BYTSRCVD ] 自通道启动以来收到的字节数，含应用和控制消息包 [ BYTSSENT ] 自通道启动以来发送的字节数，含应用和控制消息包 [ CHSTADA ] 通道启动日期 [ CHSTATI ] 通道启动时间

[ HBINT ] 自通道启动时约定的心跳间隔

[ JOBNAME ] 作业名。在UNIX 和Windows 中由PID 和TID 组成，比如 00000D1400000FC0 表示PID=3348 (D14) ， TID=4032

(FC0)。在发送端对应的进程为runmqchl，接收端对应的进 程为amqrmppa。

[ LOCLADDR ] 本地连接参数

[ LONGRTS ] 还剩下的长重试次数 [ SHORTRTS ] 还剩下的短重试次数 [ LSTMSGDA ] 上一个消息日期 [ LSTMSGTI ] 上一个消息时间

[ MCASTAT ] MCA 的运行状态。取值RUNNING 或NOT RUNNING [ MSGS ] 自通道启动以来传送的消息数量 [ NPMSPEED ] 是普通通道或是高速通道 [ RQMNAME ] 远程队列管理器名 [ SSLPEER ] SSL 协议用的DN 名

[ STOPREQ ] 用户是否有停止通道请求，取值YES 或NO 显示通道状态。 例：

dis chstatus (C) all

AMQ8417: 显示通道状态细节。 CHANNEL(C) XMITQ(QX)

CONNAME(127.0.0.1 (1415)) CURRENT CHLTYPE(SDR) INDOUBT(NO)

LSTSEQNO(0) LSTLUWID(0000000000000000) CURMSGS(0) CURSEQNO(0)

CURLUWID(F29BEB3F10000401) STATUS(RUNNING) LSTMSGTI( ) LSTMSGDA( ) MSGS(0) BYTSSENT(244)

BYTSRCVD(244) BATCHES(4) BATCHSZ(50) HBINT(300)

NPMSPEED(FAST) CHSTATI(10.58.33) CHSTADA(2003-12-27) BUFSSENT(5) BUFSRCVD(5) LONGRTS(999999999)

SHORTRTS(10) JOBNAME(00000D1400000FC0) MCASTAT(RUNNING) STOPREQ(NO) LOCLADDR(127.0.0.1(3707)) SSLPEER() RQMNAME(QM2) DISPLAY PROCESS

DISPLAY PROCESS(generic_process_name) [ ALL ] 显示所有属性，缺省值

[ ALTDATE ] 上一次修改日期，修改对象时自动更新 [ ALTTIME ] 上一次修改时间，修改对象时自动更新 其它选项同 DEFINE PROCESS 显示进程定义属性。 DISPLAY NAMELIST

DISPLAY NAMELIST(generic_namelist_name) [ ALL ] 显示所有属性，缺省值

[ ALTDATE ] 上一次修改日期，修改对象时自动更新 [ ALTTIME ] 上一次修改时间，修改对象时自动更新

[NAMCOUNT] 名称列表属性 NAMES 串中的名称数量，名称用逗号隔开 其它选项同 DEFINE NAMELIST 显示名称列表属性。 DISPLAY AUTHINFO

DISPLAY AUTHINFO(generic_authinfo_name) [ ALL ] 显示所有属性，缺省值

[ ALTDATE ] 上一次修改日期，修改对象时自动更新 [ ALTTIME ] 上一次修改时间，修改对象时自动更新 其它选项同 DEFINE AUTHINFO 显示认证信息属性。 DISPLAY CLUSQMGR

DISPLAY CLUSQMGR(generic_Q_Mgr_name) [ ALL ] 显示所有属性，缺省值

[ ALTDATE ] 上一次修改日期，修改对象时自动更新 [ ALTTIME ] 上一次修改时间，修改对象时自动更新 [ CLUSDATE ] 群集队列对于本地队列管理器生效的日期 [ CLUSTIME ] 群集队列对于本地队列管理器生效的时间 [ CLUSTER ] 该队列管理器所属的群集名

[ QMID ] 队列管理器 ID，由系统内部产生，唯一标识该队列管理器 [ QMTYPE ] 群集队列管理器的类型，取值REPOS 或NORMAL，表示 配置库队列管理器或普通队列管理器

[ CHANNEL ] 该队列管理器与配置库之间的通道名 [ STATUS ] 通道状态

[ SUSPEND ] 是否被暂挂起，取值YES 或NO 其它选项同 DEFINE CHANNEL 显示群集队列管理器属性。 DISPLAY QCLUSTER

DISPLAY QCLUSTER(generic_q_name) [ ALL ] 显示所有属性，缺省值

[ ALTDATE ] 上一次修改日期，修改对象时自动更新 [ ALTTIME ] 上一次修改时间，修改对象时自动更新 [ CLUSDATE ] 群集队列对于本地队列管理器生效的日期 [ CLUSTIME ] 群集队列对于本地队列管理器生效的时间 [ CLUSTER ] 群集队列所属的群集名

[ CLUSQMGR ] 群集队列的宿主队列管理器名 [ CLUSQT ] 群集队列类型 [ DESCR(string) ] 描述字串 [ QTYPE ] 队列类型

[ TYPE ] 与 QTYPE 相同

[ PUT( ENABLED | DISABLED ) ] 允许或禁止 MQPUT [ DEFPRTY(integer) ] Default Priority。消息的缺省优先级

[ DEFPSIST( NO | YES ) ] Default Persistence。消息的缺省持久性

[ DEFBIND( NOTFIXED | OPEN ) ] Default Binding 。缺省绑定方式， 对MQOPEN (MQOO_BIND_AS_Q_DEF)有效 CLEAR

CLEAR QLOCAL

CLEAR QLOCAL(q_name) 清除本地队列中的所有消息。 START

START CHANNEL

START CHANNEL(channel_name )

该命令适用于除 CLNTCONN 之外的所有通道。对握手协议中的主动方，比如SDR、CLUSSDR，使用

该命令可以启动通道并进行连接。对握手协议中的被动方，比如RCVR、SVRCONN、CLUSRCVR，使用

该命令只能使通道准备好连接，而不能启动通道连接。 START CHINIT START CHINIT

[ INITQ(string) ] 初始化队列名 启动通道初始化进程 START LISTENER START LISTENER

[ TRPTYPE( NETBIOS | LU62 | SPX | TCP ) ]通信协议 启动监听器 STOP

STOP CHANNEL

STOP CHANNEL(channel_name )

[ MODE( QUIESCE | FORCE | TERMINATE ) ] 停止模式 QUIESCE 允许本批次传输完毕后，关闭通道 FORCE 立即结束传输，关闭通道，有可能使正在 传输的消息出现不确定 (In doubt) 状态

TERMINATE 功能上等同于 FORCE，同时可以终止通道 的工作进程或线程

[ STATUS( STOPPED | INACTIVE) ] 设定 SDR 或SVR 通道停止后的状态 STOPPED 将传输队列属性设为 GET (DISABLED) 及NOTRIGGER 。如果命令中不指定QMNAME 和 CONNAME，则STOPPED 为缺省值

INACTIVE 不改变传输队列属性。如果命令中指定了 QMNAME和CONNAME，则INACTIVE 为缺省值

[ QMNAME(qmname) ] 通道所属的队列管理器，该选项可以作为选择通道的匹配 条件

[ CONNAME(connection_name) ] 连接参数，该选项可以作为选择通道的匹配条件 停止通道。 RESOLVE

RESOLVE CHANNEL

RESOLVE CHANNEL(channel_name )

本文来源：https://www.bwwdw.com/article/shhv.html