mqsicreateconfigmgr 命令

支持的平台

用途

此命令完成以下操作:
  • 创建不存在的 WebSphere MQ 队列管理器。
    注:
    1. 如果使用 mqsicreateconfigmgr 命令创建了 WebSphere MQ 队列管理器,则自动启用 WebSphere MQ (SYSTEM.DEAD.LETTER.QUEUE) 提供的缺省 DLQ。安全性设置与其他代理特定的 WebSphere MQ 队列的安全性设置相同。

      如果选择单独创建队列管理器,请设置死信队列(DLQ)。处理消息流中的消息时若发生错误,则由 WebSphere Message Broker 引用 DLQ。

      如果无法处理用户定义的消息流或发布/预订模型中的消息,则使用最后一个办法,将消息路由到此 DLQ。 如果更希望将此消息回退到输入队列,并且在问题解决之前有效地阻止消息流,则禁用 DLQ。

      mqsideleteconfigmgr 命令不删除此队列(除非删除了队列管理器)。

    2. 如果您使用与 mqsicreateconfigmgr 无关的已创建的 WebSphere MQ 队列管理器,则可以定义群集(如果您选择的话)。此选项可以简化您的配置。
  • 如果 WebSphere MQ 队列管理器尚未运行,则启动它。
  • 创建 WebSphere MQ 队列和特定于配置管理器的通道(如果它们还不存在)。
  • 配置管理器的内部存储库中创建它的数据库表。如果需要将数据从先前发行版的配置库转换过来,则可以使用 db2DatabaseToMigratemigrationDatabaseUserIdmigrationDatabasePassword 参数。
  • 如果您使用 -n 参数运行此命令,然后使用不指定 -n 参数的 mqsideleteconfigmgr 命令删除 配置管理器,不会删除包含此配置库的新数据库。

    如果在此情况下再次运行此命令并且指定 -n 参数,由于新数据库仍然存在,所以将忽略此参数。

  • (仅 Windows) - 安装运行配置管理器 的 Windows 服务。
  • 在代理注册表中为组件创建记录。

如果您已安装了 VisualAge for Java 并且选择了 WebSphere MQ 连接器作为该安装的一部分,请确保 VisualAge for Java 的 CLASSPATH 条目出现在当前使用的 Windows 平台(服务器或 Java 客户机)的 WebSphere MQ 的 CLASSPATH 条目之后。该要求可以确保当配置管理器mqsistart 命令启动时,它访问的是正确的 WebSphere MQ 类(而不是 VisualAge 类)。 如果配置管理器在该区域中检测到错误,它会将消息 BIP1004 写入 Windows 的系统事件日志。

语法

Windows

LinuxUNIX 系统

z/OS

参数

configmgrName
(可选 - Windows。 必需 - LinuxUNIX 系统z/OS)您要创建的配置管理器名。

LinuxUNIX 系统z/OS 上,必须首先指定此参数。它在 LinuxUNIX 系统z/OS 上区分大小写。

如果未指定此参数,则 Windows 上的缺省名称为“ConfigMgr”。

-i ServiceUserID
(必需)运行服务所需的用户标识。

此参数可以按照平台的任何有效用户名语法指定。

指定的 ServiceUserID 必须是本地组 mqbrkrs 的成员(直接成员或间接成员),并且必须有权访问主目录(即 WebSphere Message Broker 的安装目录)和工作目录(如果用 -w 标志指定了工作目录)。

更新开始ServiceUserID 的安全要求在 Windows 平台的安全性需求(针对 Windows)、Linux 和 UNIX 平台的安全要求(针对 UNIX 平台)和 z/OS 的安全性需求(针对 z/OS)中有详细描述。更新结束

如果您使用服务用户标识(username)的非限定格式,更新开始在 Windows 上更新结束操作系统会在其域范围内搜索用户标识,首先是本地系统。这种搜索可能要花费一些时间才能完成。

-a ServicePassword
(必需)ServiceUserID 的密码。

为与现有系统兼容,可以仍然指定 <password>。但在运行此命令时,如果未使用该参数指定密码,调用此命令时会提示您输入密码,并且还提示您再次输入密码以验证您的输入是否正确。

-q QueueManagerName
(必需)与配置管理器相关联的队列管理器的名称。

对于不存在的队列管理器,可以使用此命令创建。此队列管理器不作为缺省队列管理器创建:如果希望此队列管理器成为该系统的缺省队列管理器,必须在发出该命令前创建队列管理器。

将队列管理器属性 MAXMSGL(可以放入队列中的消息的最大长度)更新为 100 MB。无论队列管理器是否使用该命令创建都需要执行此更新。

-n db2DatabaseToMigrate
(可选)用于访问在先前发行版中创建的配置库数据库的用户标识。

此数据库必须已经存在。您不需要为此数据库创建 ODBC 连接,因为访问权是由 JDBC 提供的。

-u migrationDataBaseUserID
(可选)在先前发行版中创建的用于访问配置库数据库的用户标识。
-p migrationDataBasePassword
(可选)用于访问在先前发行版中创建的配置库数据库的用户标识的密码。如果未指定,则此参数缺省为由 -a 指定的 ServicePassword。

为与现有系统兼容,可以仍然指定 <password>。但在运行此命令时,如果未使用该参数指定密码,调用此命令时会提示您输入密码,并且还提示您再次输入密码以验证您的输入是否正确。

-s UserNameServerQueueManagerName
(可选)与用户名称服务器关联的 WebSphere MQ 队列管理器的名称。 如果未指定该参数,配置管理器会假设没有已定义的用户名称服务器,并且不会尝试与其通信。
-w Workpath
(可选)存储配置管理器工作文件的目录。如果未指定此参数,则使用安装产品时指定的缺省目录。
1
(可选 - 仅 z/OS)仅用来创建配置管理器注册表的注册表密码。
2
(可选 - 仅 z/OS)仅用来创建 配置管理器 WebSphere MQ 队列的 WebSphere MQ 密码。
注: 仅当存在配置管理器注册表时,才能执行此操作。

权限

该命令更改 ServiceUserID 的安全性特权;用于调用该命令的用户标识必须是此本地系统上Windows 管理员组的成员。

更新开始在 UNIX 系统上,用于调用此命令的用户标识必须是 mqbrkrs 组的成员。更新结束

更新开始在 z/OS 系统上,用于调用此命令的用户标识必须属于对组件目录有“读”和“写”访问权的组。更新结束

创建的 Websphere MQ 队列

  • SYSTEM.BROKER.CONFIG.QUEUE
  • SYSTEM.BROKER.CONFIG.REPLY
  • SYSTEM.BROKER.ADMIN.REPLY
  • SYSTEM.BROKER.SECURITY.REPLY
  • SYSTEM.BROKER.MODEL.QUEUE

授予 WebSphere Message Brokermqbrkrs 对所有这些队列的访问权。如果启用了 DLQ,它也有同样的权限。

创建的 Websphere MQ 通道

  • SYSTEM.BKR.CONFIG

创建的数据库表

该命令创建的数据库表由配置管理器管理。

响应

该命令返回下列响应:
  • BIP8011 无法创建配置数据
  • BIP8012 无法连接到系统组件
  • BIP8014 无法创建组件
  • BIP8022 用户标识/密码无效
  • BIP8030 无法修改用户标识特权
  • BIP8048 无法启动队列管理器
  • BIP8050 无法创建队列管理器
  • BIP8051 无法创建队列
  • BIP8053 无法设置队列管理器的安全性
  • BIP8054 无法设置队列的安全性
  • BIP8055 无法装入 Java 类
  • BIP8056 队列管理器未知
  • BIP8074 无法创建 JVM
  • BIP8075 Java 异常
  • BIP8076 无法设置当前目录
  • BIP8077 初始化配置数据时出错
  • BIP8078 初始化配置数据时出错
  • BIP8084 无法创建目录
  • BIP8087 组件已存在
  • BIP8093 正在创建队列管理器
  • BIP8094 正在停止队列管理器
  • BIP8097 无法创建 Java 对象

示例

mqsicreateconfigmgr CMGR01 -i wbrkuid -a wbrkpw -q WBRK_CONFIG_QM   
相关概念
配置管理器
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
an23000_