modifySIBWMQServerBusMember 命令
使用 modifySIBWMQServerBusMember 命令修改 IBM MQ 服务器总线成员的属性。
要运行该命令,请使用 wsadmin 脚本编制客户机的 AdminTask 对象。
wsadmin
脚本编制客户机通过 Qshell 运行.
有关更多信息,请参阅 使用 wsadmin 脚本编制配置 Qshell 以运行 WebSphere 脚本.
已经为服务集成总线命令提供了命令行帮助:
- 要获取 Jython 中可用服务集成总线命令的列表以及每个命令的简要描述,请在
wsadmin 提示符处输入以下命令:
print AdminTask.help('SIBAdminCommands')
- 要获取有关给定命令的总体帮助,请在 wsadmin 提示符处输入以下命令:
print AdminTask.help('command_name')
使用此命令后,请使用以下命令将更改保存到主配置中:
AdminConfig.save()
用途
IBM MQ 服务器总线成员用于为 IBM MQ 队列分配队列点和调解点。此命令修改 IBM MQ 服务器总线成员的属性。
目标对象
所选 IBM MQ 服务器总线成员。
必需参数
- -name
- 此值是创建 IBM MQ 服务器定义时在 -name 参数中指定的名称。
- -bus
- IBM MQ 服务器所属的服务集成总线的名称。
条件参数
无
可选参数
- -virtualQueueManagerName
- 将消息发送至
IBM MQ 时,IBM MQ
网关队列管理器会将总线视为远程队列管理器。虚拟队列管理器名称将作为此远程队列管理器的名称传递至
IBM MQ。缺省值为服务集成总线的名称。如果此总线名称对于 IBM MQ 队列管理器并非有效名称,或者另一 IBM MQ 队列管理器已具有相同名称,那么应将缺省值替换为另一个值,该值对于 IBM MQ 队列管理器是有效的唯一名称。
- 它必须包含 1 到 48 个字符。
- 它必须遵循 IBM MQ 队列命名规则(请参阅 IBM MQ 信息中心中的“IBM MQ 对象的命名规则”主题)。
- -host
- 被覆盖的 host 属性的新值。此值是主机的名称或 IP 地址,将与该主机建立连接以与此
IBM MQ 服务器所表示的队列管理器或队列共享组通信。此值是字符串,它必须是下列其中一项:
- 符号主机名
- IPv4 地址
- IPv6 地址
- -port
- 被覆盖的 port 属性的新值。此值是此 IBM MQ 服务器所代表的队列管理器或队列共享组侦听的 TCP/IP 端口号。缺省值是 1414。
- -channel
- 被覆盖的 channel 属性的新值。此值是连接到此 IBM MQ 服务器所代表的队列管理器或队列共享组时要使用的 IBM MQ 客户机通道名。缺省值为 SYSTEM.DEF.SVRCONN。
- -securityAuthAlias
- 被覆盖的 securityAuthAlias 属性的新值。此值是连接到队列管理器或队列共享组时要使用的认证别名。此参数与发现认证别名不同。
- -transportChain
- 被覆盖的 transportChain 属性的新值。此值是与 IBM MQ 建立连接时要使用的出站传输链。缺省值为 OutboundBasicWMQClient。
- -trustUserIds TRUE | FALSE
- 被覆盖的 trustUserIds 属性的新值。此值确定在来自
IBM MQ
的消息中接收的用户标识是否传播到消息(即,是否在服务集成总线中使用作为消息数据一部分接收的用户标识)。应用程序用户标识始终是通过
jsAppUserId RFH2 值设置的。如果不存在此用户标识(由于
RFH2 头未包含键/值对,或者由于消息未带有 RFH2 头),那么不会设置此字段。如果将此值设置为 FALSE,那么用户标识将被
IBM MQ 服务器名称覆盖。此参数有两个可能的值:
- TRUE
- 用户标识将传播至消息。
- FALSE
- 用户标识将不会传播至消息。
示例
- 使用 Jython:
wsadmin>AdminTask.modifySIBWMQServerBusMember(["-name", "Finance dept QM-Bus1", "-bus", "Bus1", "-trustUserIds", "false"])
- 使用 Jacl:
wsadmin>$AdminTask modifySIBWMQServerBusMember {-name "Finance dept QM-Bus1" -bus Bus1 -trustUserIds false}