mqsicreateusernameserver 命令

支持的平台

用途

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

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

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

      除非删除了队列管理器,否则 mqsideleteusernameserver 命令不删除此队列)。

    2. 如果使用的 WebSphere MQ 队列管理器不是用 mqsicreateusernameserver 命令创建的,则可以定义群集。这样可以简化配置工作。

  • (非 z/OS)启动未运行的 WebSphere MQ 队列管理器。

    如果队列管理器是用此命令创建的,它将不作为 Windows 服务启动;如果您注销,它就会停止。要避免发生这种情况,必须保持登录状态,或者更改队列管理器服务的启动状态。(如果锁定工作站,WebSphere MQ 队列管理器并不停止。)

  • 创建特定于“用户名称服务器”的 WebSphere MQ 队列(如果它们还不存在)。
  • Windows 上,安装用于运行用户名称服务器的服务。
  • 在代理注册表中为组件创建记录。

语法

Windows 平台、Linux 和 UNIX 系统

z/OS 控制台命令

参数

-i ServiceUserID
(必需 - Windows 平台、LinuxUNIX 系统)用于运行代理的用户标识。
您可以用任何有效的用户名语法指定它。在 Windows 平台上,有效的语法有:
  • domain\username
  • \\server\username
  • .\username
  • username
LinuxUNIX 系统上,仅最后一种格式 username 有效。

如果在 Windows 平台上使用该用户标识的非限定格式(username),操作系统就从本地系统开始,在它的整个域中搜索该用户标识。这种搜索可能要花费一些时间才能完成。

指定的 ServiceUserID 必须是本地组 mqbrkrs 的成员。在 Windows 平台上, 它可以是组的直接或间接成员。ServiceUserID 还必须有权访问主目录(即安装 WebSphere Message Broker 的目录)。

Windows 平台的Windows 平台的安全性需求LinuxUNIX 系统的Linux 和 UNIX 平台的安全要求中详细描述了 ServiceUserID 的安全要求。

-a ServicePassword
(必需 - Windows 平台、LinuxUNIX 系统)ServiceUserID 的密码。

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

-q QueueManagerName
(必需)与用户名称服务器关联的队列管理器名称。

Windows 平台、LinuxUNIX 系统上,如果队列管理器不存在,则使用此命令创建它。它不作为缺省队列管理器创建:如果希望它成为该系统上的缺省队列管理器,必须在发出该命令前创建队列管理器。

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

-d SecurityDomainName
(可选 - Windows 平台)Windows 系统安全性域的名称。如果未指定,缺省值就是系统的本地 Windows 系统安全性域。 有关 WebSphere Message Broker 中如何实现安全性的详细信息,请参阅设置代理域安全性
-r RefreshInterval
(可选)用户名称服务器向安全子系统询问用户或组的属性是否发生更改的时间间隔(以秒为单位)。如果未指定,则使用用户名称服务器的缺省时间间隔,60 秒。
-w Workpath
(可选 - Windows 平台、LinuxUNIX 系统)用于存储用户名称服务器工作文件的目录。如果未指定,则使用安装产品时指定的缺省值。
-g AuthProtocolDataSource
(可选 - Windows 平台、LinuxUNIX 系统)此参数用于指定密码文件的名称和位置,此密码文件可以提供任何与协议相关的信息。缺省情况下,可以在主目录中找到此文件。如果将此文件存储到其他位置,则必须指定带文件名的完整路径位置。

产品主目录下的 examples/auth 目录中提供了两个样本:password.datpwgroup.dat

-j
(可选 - Windows 平台、LinuxUNIX 系统表示组和组成员资格是在认证协议的数据源中定义的,而不是从操作系统中提取的。
1
(可选 - 仅 z/OS)注册表密码,仅用于创建用户名称服务器注册表。
2
(可选 - 仅 z/OSWebSphere MQ 密码,仅用于创建 用户名称服务器 WebSphere MQ 队列。

创建的 WebSphere MQ 队列

  • SYSTEM.BROKER.SECURITY.QUEUE
  • SYSTEM.BROKER.MODEL.QUEUE

授予 WebSphere Message Brokermqbrkrs 对所有这些队列的访问权。

响应

该命令返回下列响应:
  • BIP8011 无法创建配置数据
  • BIP8012 无法连接到系统组件
  • BIP8014 无法创建组件
  • BIP8022 用户标识/密码无效
  • BIP8030 无法修改用户标识特权
  • BIP8048 无法启动队列管理器
  • BIP8050 无法创建队列管理器
  • BIP8051 无法创建队列
  • BIP8053 无法设置队列管理器的安全性
  • BIP8054 无法设置队列的安全性
  • BIP8056 队列管理器未知
  • BIP8068 缺少整数参数
  • BIP8084 无法创建目录
  • BIP8087 组件已存在
  • BIP8093 正在创建队列管理器
  • BIP8094 正在停止队列管理器

示例

mqsicreateusernameserver -i wbrkuid -a wbrkpw
      -q WBRK_QM -r 1000
相关概念
用户名称服务器
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
an07200_