Broker 命令指的是由 WebSphere Message Broker 运行环境提供的各种管理命令，具体见表 B-2 。 由 于 运 行 这 些 命 令 需 要 设 置 一 些 环 境 变 量 ， Message Broker 提 供 了 一 个 脚 本 mqsiprofile.cmd（Windows）或 mqsiprofile（Linux 和 UNIX），在窗口中首先执行脚本设定环 境，然后可以任意执行Broker 命令。
Windows 平台上也可以执行“开始”→“程序”→IBM WebSphere Message Broker 6.0→
“命令控制台”命令，其效果与执行bin 目录下的 mqsiprofile.cmd 相同。
表 B-2 Broker 命令一览表
命令 说明
组件操作 mqsicreatebroker 创建Broker mqsichangebroker 更改Broker 参数 mqsideletebroker 删除Broker
mqsicreateconfigmgr 创建Configuration Manager mqsichangeconfigmgr 更改Configuration Manager 参数 mqsideleteconfigmgr 删除Configuration Manager mqsbackupconfigmgr 备份Configuration Manager mqsrestoreconfigmgr 恢复Configuration Manager mqsicreateusernameserver 创建User Name Server mqsichangeusernameserver 更改User Name Server 参数 mqsideleteusernameserver 删除User Name Server
mqsimigratecomponents 迁移WebSphere Message Broker 组件
续表
命令 说明
对象及属性操作
mqsideploy 部署对象
mqsilist 显示部署的对象
mqsicreateexecutiongroup 创建Execution Group mqsideleteexecutiongroup 删除Execution Group mqsireportproperties 显示对象属性 mqsichangeproperties 更改对象属性
启动和停止
mqsistart 启动WebSphere Message Broker 组件 mqsistop 停止WebSphere Message Broker 组件 mqsireload 重启Broker 或 Execution Group mqsistartmsgflow 启动消息流
mqsistopmsgflow 停止消息流
数据库命令
mqsicreatedb 创建数据库
mqsideletedb 删除数据库
mqsichangedbimgr 更改DatabaseInstanceManager 的用户名和口令 mqsi_setupdatabase 设置数据库类型及安装目录
mqsisetdbparms 设置消息流使用的数据源的用户名和口令
安全控制 mqsicreateaclentry 创建ACL 条目 mqsideleteaclentry 删除ACL 条目 mqsilistaclentry 列出ACL 条目
mqsisetsecurity 设置用户名和用户组
mqsicbrreport 检查基于内容路由（CBR）的主题
Trace 操作 mqsireporttrace 显示Trace 设置 mqsichangetrace 更改Trace 设置
mqsireadlog 将Trace 内容导出到文件
mqsiformatlog 将Trace 内容格式化 统计操作 mqsireportflowstats 显示消息流统计设置 mqsichangeflowstats 更改消息流统计设置
续表
命令 说明
MQ Broker
mqsijoinmqpubsub 将Broker 加入 MQ Broker 网络 mqsiclearmqpubsub 将Broker 移出 MQ Broker 网络 mqsilistmqpubsub 列出Broker 相邻的 MQ Broker
用户出口
mqsichangeflowuserexits 更改消息流的用户出口列表 mqsireportflowuserexits 显示消息流的用户出口列表
其他
mqsiservice 显示产品安装及配置信息
mqsicmrv 显示Configuration Manager 存储内容 mqsicmdt 显示Configuration Manager 配置表中的内容
mqsibrowse 显示Broker 配置表中的内容
下面就每一条语句逐一进行描述。
B.2.1 mqsicreatebroker
语法格式
mqsicreatebroker brokerName
-i serviceUserId 运行Broker 的用户 -a servicePassword 运行Broker 的密码
-q queueManager Broker 将使用的 WebSphere MQ 队列管理器。如果不存在，
则创建它
-n dataSourceName Broker 的数据源名称
[-u dataSourceUserId] Broker 用于访问其数据库的用户标识 [-p dataSourcePassword] Broker 数据库用户标识的密码
[-s unsQMgrName] 用户名称服务器的 WebSphere MQ 队列管理器
[-j] 为Broker 启用发布／预订访问控制，必须与-s 合用
[-g configurationTimeout] 允许Broker 处理已部署的消息的最大时间(单位：秒)，取值 范围是10～3600，缺省为 300
[-k configurationDelayTimeout] 允许Broker 处理已部署的最小消息的最大时间(单位：秒)，
取值范围是10～3600，缺省为 60
[-w workPath] 放置跟踪日志的目录
[-l userLilPath] Broker 搜索用户所提供库的目录，可以有多个，用“;”(Windows) 或“:”(UNIX)分隔
[-t] 以MQ 信任应用(Trusted Application)方式启动 Broker [-m] 表明需要从 WebSphere MQ Publish/Subscribe Broker 迁移到
WebSphere Message Broker
[-v statisticsMajorInterval] 用于收集统计信息归档记录的时间间隔的持续时间（单位：
分钟），取值范围是10～14400，缺省为 60 [-P httpListenerPort] 代理 HTTP 侦听器将使用的端口，缺省为 7080
[-c icuConverterPath] 搜索 ICU 代码页转换器或转换器包的路径的分隔列表，可以 有多个，用“;”(Windows)或“:”(UNIX)分隔
[-y ldapPrincipal] LDAP 主体（用户标识），-y 与-z 必须合用 [-z ldapCredentials] LDAP 凭证（密码），-y 与-z 必须合用
[-x userExitPath] 用户出口目录，可以有多个，用“;”(Windows)或“:”(UNIX)分隔。
该目录会被执行组进程添加到系统库搜索路径中（PATH、
LIBPATH、LD_LIBRARY_PATH、SHLIBPATH）
功能说明
该命令创建代理（Broker），同时会在-n 指定的数据库中创建相应的表并插入数 据记录，在-q 指定的队列管理器中创建相应的队列。-i 和-a 选项指定运行 Broker 的 用户及密码，这里指的是操作系统用户。-u 和-p 选项指定 Broker 访问其数据库的用 户及密码，这里指的是数据库用户。
为了安全起见，密码可以不以明码方式暴露在命令参数中。如果命令中指定了-i 但未指定-a，或者指定了-u 但未指定-p，则命令在执行过程中会以隐密的形式让用户 输入相关密码。
注意：
（1）该命令的执行用户在 Windows 上必须是 Administrators 组用户，在 UNIX 上必须是 mqbrkrs 组用户。
（2）数据库必须先于代理创建，而队列管理器则不一定。如果创建代理的时候队列管理器 尚不存在，会由该命令一并创建，同时指定队列管理器的死信队列为SYSTEM.DEAD.LETTER.Q。
（3）–i 选项指定的用户必须是 mqbrkrs 组用户。如果指定-t 选项，则 Broker 作为 WebSphere MQ 信任应用（Trusted Application）运行，那么对于 Windows，-i 指定的用户也必须是 mqm 组用户，对于HP-UX 和 Solaris，-i 指定的用户必须就是 mqm，对于 AIX，-i 无效。
（4）如果命令中不指定-u 和-p 选项，则缺省会使用-i 和-a 的值。对于 SQL Server，必须 先在数据库中手工创建相应的用户名和口令，对于Windows 平台的 DB2，该命令会自动创建。
（5）–g 指的是执行组接受部署并更新的超时阈值，如果部署时执行组中的消息流尚未结 束，则会等待结束后再更新。-k 指的是代理接受部署的超时阈值，如果网络阻塞或队列管理 器过载，则可能超时。一般来说，-k 的值应该远小于-g 的值，两者之和表示代理接受部署并 更新的超时阈值。
（6）Broker 中的消息流可能会用到 LDAP，比如 JMSInput 节点和 JMSOutput 节点设定 JNDI 绑定时可以指定 LDAP 的位置。这时使用的 LDAP 用户名和口令是由创建 Broker 时的-y 和-z 选项指定的。
使用举例 例：
mqsicreatebroker WBRK -i userid -a passwd -q WBRKQM -n WBRKDB B.2.2 mqsichangebroker
语法格式
mqsichangebroker brokerName
[-i serviceUserId] 运行Broker 的用户
[-a servicePassword] 运行Broker 的密码
[-p dataSourcePassword] Broker 数据库用户标识的密码
[-s unsQMgrName] 用户名称服务器的 WebSphere MQ 队列管理器，如果
[-g configurationTimeout] 允许Broker 处理已部署的消息的最大时间（单位：秒），取值范 围是10～3600，缺省为 300。
[-k configurationDelayTimeout]允许 Broker 处理已部署的最小消息的最大时间（单位：秒），
取值范围是10～3600，缺省为 60
[-l userLilPath] Broker 搜索用户所提供库的目录，可以有多个，用“;”(Windows) 或“:”(UNIX)分隔
[-v statisticsMajorInterval] 用于收集统计信息归档记录的时间间隔的持续时间（单位：分钟），
取值范围是10～14400，缺省为 60
[-P httpListenerPort] 代理 HTTP 侦听器将使用的端口，缺省为 7080
[-c icuConverterPath] 搜索 ICU 代码页转换器或转换器包的路径的分隔列表，可以有 多个，用“;”(Windows)或“:”(UNIX)分隔
[-y ldapPrincipal] LDAP 主体（用户标识），-y 与-z 必须合用 [-z ldapCredentials] LDAP 凭证（密码），-y 与-z 必须合用
[-x userExitPath] 用户出口目录，可以有多个，用“;”(Windows)或“:”(UNIX)分隔。
该目录会被执行组进程添加到系统库搜索路径中（PATH、
LIBPATH、LD_LIBRARY_PATH、SHLIBPATH）
[-e activeUserExits] 活动的用户出口名，可以有多个并用冒号分隔。缺省情况下，用 户出口是非活动的，该选项将指定的用户出口改成缺省活动的
功能说明
该命令用于更改Broker 的参数，创建 Broker 时的参数大部分可以更改，另一小 部分则无法更改，除非重建Broker。在执行该命令之前必须先用 mqsistop 停止 Broker 的运行，命令完成后再用mqsistart 启动 Broker，使更改后的参数生效。
相关参数的注意事项参见mqsicreatebroker 中的说明。
使用举例
例1：指定用户名服务器所在的队列管理器，启用主题安全控制 mqsichangebroker WBRK -s UNS_QM
例2：不使用用户名服务器，禁用主题安全控制 mqsichangebroker WBRK -s ""
B.2.3 mqsideletebroker
语法格式
mqsideletebroker brokerName
[-q] 同时删除Broker 所在的队列管理器
[-w] 同时删除Broker 工作目录中的相关文件
功能说明
该命令用于删除一个Broker。-q 选项可以指定一并删除 Broker 的相关队列管理
器，否则只删除队列管理器上的相关队列。如果队列管理器上还有组件，比如配置 管理器（Configuration Manager）或用户名服务器（User Name Server），则队列管理 器此时不能被一并删除，-q 选项会导致出错。
使用举例
mqsideletebroker WBRK -q B.2.4 mqsicreateconfigmgr
语法格式
mqsicreateconfigmgr configMgrName
-i serviceUserId 运行ConfigMgr 的用户 -a servicePassword 运行ConfigMgr 的密码
-q queueManager ConfigMgr 将使用的 WebSphere MQ 队列管理器。如果不存在，
则创建它
[-n dataSourceName] 迁移ConfigMgr 的数据源名称 [-u dataSourceUserId] 迁移ConfigMgr 的数据库用户名 [-p dataSourcePassword] 迁移ConfigMgr 的数据库密码
[-s unsQMgrName] 用户名称服务器的 WebSphere MQ 队列管理器
[-w workPath] 放置跟踪日志的目录
功能说明
该命令用于创建配置管理器（ConfigMgr），同时会在-n 指定的数据库中创建相 应的表并插入数据记录，在-q 指定的队列管理器中创建相应的队列。在 Windows 中，
可以不指定configMgrName，这时缺省为 ConfigMgr。在其他平台上则必须指定。
注意：
（1）该命令的执行用户在 Windows 上必须是 Administrators 组用户，在 UNIX 上必须是 mqbrkrs 组用户。
（2）数据库必须先于代理创建，而队列管理器则不一定。如果创建代理的时候队列管理器 尚不存在，会由该命令一并创建，同时指定队列管理器的死信队列为SYSTEM.DEAD.LETTER.Q。
（3）–i 选 项 指 定的 用户 必 须是 mqbrkrs 组 用 户 ， 同时 也必 须 是 mqm 组 用 户 或 Administrators 组用户。
（4）在 WebSphere Business Integrator Message Broker v5 中，配置管理器的信息是记录在 DB2 数据库中的，在 WebSphere Message Broker v6 中，它们是记录在内置的 Derby 数据库中，
通常在C:\Documents and Settings\All Users\Application Data\IBM\MQSI\components\ConfigMgr 目录中。如果创建的配置管理器信息需要从v5 迁移到 v6，则可以通过-n、-u、-p 选项来访问 原数据库。
使用举例
mqsicreateconfigmgr CM -i user -a passwd -q WBRK_CM_QM B.2.5 mqsichangeconfigmgr
语法格式
mqsichangeconfigmgr configMgrName
[-i serviceUserId] 运行ConfigMgr 的用户
[-a servicePassword] 运行ConfigMgr 的密码 [-p dataSourcePassword] 迁移ConfigMgr 的数据库密码
[-s unsQMgrName] 用户名称服务器的 WebSphere MQ 队列管理器
[-j maxJVMHeapSize] 最大Java 虚拟机堆大小（单位：MB，缺省值为 256，最小值为 64）
功能说明
该命令用于更改配置管理器的参数，在执行该命令之前必须先停止配置管理器 的运行，命令完成后再启动，使更新生效。在Windows 中，可以不指定 configMgrName，
这时缺省为ConfigMgr。在其他平台上则必须指定。
相关参数的注意事项参见mqsicreateconfigmgr 中的说明。
使用举例
例1：指定用户名服务器所在的队列管理器，启用主题安全控制 mqsichangeconfigmgr CM -s UNS_QM
例2：不使用用户名服务器，禁用主题安全控制 mqsichangeconfigmgr CM -s ""
B.2.6 mqsideleteconfigmgr
语法格式
mqsideleteconfigmgr configMgrName
[-q] 同时删除ConfigMgr 所在的队列管理器
[-w] 同时删除ConfigMgr 工作目录中的相关文件
[-n] 同时删除ConfigMgr 的数据库
功能说明
该命令用于删除一个配置管理器。-q 选项可以指定一并删除配置管理器的相关 队列管理器，否则只删除队列管理器上的相关队列。如果队列管理器上还有其他组 件，比如代理（Broker）或用户名服务器（User Name Server），则队列管理器此时不 能被一并删除，-q 选项会导致出错。-n 选项可以同时删除配置管理器的数据库，但 是使用时要相当谨慎，因为配置记录中含整个代理域的全部内容，如果删除时仍然 存在其他代理，则会造成这些代理不可用。配置记录也可以事后手工删除，在Windows 中配置记录在C:\Documents and Settings\All Users\Application Data\IBM\MQSI 目录 下，在UNIX 平台中配置记录在/var/mqsi 目录中。
在 Windows 中，可以不指定 configMgrName，这时缺省为 ConfigMgr。在其他 平台上则必须指定。
使用举例
mqsideleteconfigmgr CM -q B.2.7 mqsbackupconfigmgr
语法格式
mqsibackupconfigmgr configMgrName
-d archiveDirectory 备份文件所在的目录，必须事先创建 [-a archiveFileName] 备份文件名
[-w workPath] 配置管理器存储库的工作路径