modifySIBWMQServer 命令

使用 modifySIBWMQServer 命令可修改 WebSphere® MQ 服务器。

您可以使用 wsadmin 工具 (如本主题中所述) 或使用管理控制台 (如 修改 WebSphere MQ 服务器定义中所述) 来修改 WebSphere MQ 服务器。

要运行该命令，请使用 wsadmin 脚本编制客户机的 AdminTask 对象 。

[IBM i][IBM i]wsadmin 脚本编制客户机从 Qshell 运行。

为服务集成总线的命令提供了命令行帮助：
  • 要获取 Jython 中可用服务集成总线命令的列表以及每个命令的简短描述，请在 wsadmin 提示符处输入以下命令：

    print AdminTask.help('SIBAdminCommands')

  • 要获取特定命令的概述帮助，请在 wsadmin 提示符下输入以下命令：

    print AdminTask.help('command_name')

使用该命令后，使用以下命令将更改保存到主配置。

AdminConfig.save()

用途

WebSphere MQ 服务器表示 WebSphere MQ 队列管理器或 (对于 WebSphere MQ for z/OS) 队列共享组。 此命令用于修改 WebSphere MQ 服务器。 不可能使用此命令来修改名称或类型属性。

注: 修改 WebSphere MQ 服务器时，了解 name 和 serverName 属性的重要性非常重要。 例如，如果 WebSphere Application Server 管理员创建名为 My European Area Server 的 WebSphere MQ 服务器，该服务器表示具有 serverName QM1的 WebSphere MQ 队列管理器， 然后，管理员可以创建名为 My UK Country Server的第二个 WebSphere MQ 服务器，该服务器也表示同一个队列管理器。

目标对象

所选 WebSphere MQ 服务器。

必需参数

-name
WebSphere MQ 服务器的名称。 此名称是在创建 WebSphere MQ 服务器定义时指定的。

条件参数

无

可选参数

-serverName
队列管理器或队列共享组的名称。 这是用于标识队列管理器或队列共享组的名称。 该值由 WebSphere MQ 管理分配给该 WebSphere MQ 资源。 管理员始终使用由 WebSphere MQ 管理分配的名称。
-host
host 属性的新值。 此值是与此 WebSphere MQ 服务器所代表的队列管理器或队列共享组进行通信时建立连接的主机的名称或 IP 地址。 此值是字符串，它必须是下列其中一项：
  • 符号主机名
  • IPv4 地址
  • IPv6 地址
-bindingsMode
bindingsMode 属性的新值。 此值确定连接到队列管理器或队列共享组时是否使用绑定传输方式连接。 仅当应用程序服务器与队列管理器在同一节点上，但即使同一节点上有多个队列管理器也只允许连接到单个队列管理器时，才有可能进行绑定方式连接。 此参数有两个可能的值：
TRUE
在绑定方式可用时使用此方式。 如果选择此选项，但绑定方式不可用，那么连接机制将缺省为客户机传输方式。
FALSE
始终使用客户机方式。
缺省值为 True。
-port
WebSphere MQ port 属性的新值。 此值是此 WebSphere MQ 服务器表示侦听的队列管理器或队列共享组的 TCP/IP 端口号。 缺省值为 1414。
-channel
WebSphere MQ channel 属性的新值。 此值是连接到此 WebSphere MQ 服务器所代表的队列管理器或队列共享组时要使用的 WebSphere MQ 客户机通道名称。 此名称由 WebSphere MQ 管理分配给 WebSphere MQ 对象，并且必须始终由 WebSphere Application Server 管理员使用。 缺省值为 SYSTEM.DEF.SVRCONN。
-description
description 属性的新值。 此值是 WebSphere MQ 服务器的简短描述，仅用于管理目的。
-securityAuthAlias
securityAuthorizationAlias 属性的新值。 此值是连接到队列管理器或队列共享组时要使用的认证别名。 此参数与发现认证别名不同。
-transportChain
transportChain 属性的新值。 此值是与 WebSphere MQ建立连接时要使用的出站传输链。 缺省值为 OutboundBasicWMQClient。
-trustUserIds
trustUserIds 属性的新值。 确定是否将从 WebSphere MQ 消息中接收的用户标识传播到消息中 (即，是否在服务集成总线中使用作为消息数据的一部分接收的用户标识)。 应用程序用户标识始终是通过 jsAppUserId RFH2 值设置的。 如果不存在此用户标识（由于 RFH2 头未包含键/值对，或者由于消息未带有 RFH2 头），那么不会设置此字段。 如果将此值设置为 FALSE，那么将使用 WebSphere MQ 服务器名称覆盖用户标识。 此参数有两个可能的值：
TRUE
用户标识将传播至消息。
FALSE
用户标识将不会传播至消息。
缺省值为 True。
-allowDiscovery
allowDiscovery 属性的新值。 此值确定是否执行 WebSphere MQ 资源的自动发现。 此参数有两个可能的值：
TRUE
启用自动资源发现功能。
FALSE
禁用自动资源发现功能。
缺省值为 True。
-discoveryAuthAlias
discoveryAuthAlias 属性的新值。 此值是与队列管理器或队列共享组建立资源发现连接时使用的认证别名，它与安全性认证别名参数不同。
-replyToQueue
replyToQueue 属性的新值。 此值是要用于资源发现的应答队列，是 WebSphere MQ 管理分配给 WebSphere MQ 对象的名称，并且必须是临时动态队列的模型队列的名称。 WebSphere Application Server 管理必须始终使用与 WebSphere MQ 管理一致的名称。 缺省值为 SYSTEM.DEFAULT.MODEL.QUEUE。

示例

  • 使用 Jython：
    wsadmin>AdminTask.modifySIBWMQServer(["-name", "Finance dept QM",
 "-allowDiscovery", "false"] )
  • 使用 Jacl：
    wsadmin>$AdminTask modifySIBWMQServer {-name "Finance dept QM"
 -allowDiscovery false}