modifySIBForeignBus 命令
使用 modifySIBForeignBus 命令修改外部总线的属性。
要运行该命令,请使用 wsadmin 脚本编制客户机的 AdminTask 对象。
wsadmin
脚本编制客户机通过 Qshell 运行.
有关更多信息,请参阅 使用 wsadmin 脚本编制配置 Qshell 以运行 WebSphere 脚本.
已经为服务集成总线命令提供了命令行帮助:
- 要获取 Jython 中可用服务集成总线命令的列表以及每个命令的简要描述,请在
wsadmin 提示符处输入以下命令:
print AdminTask.help('SIBAdminCommands')
- 要获取有关给定命令的总体帮助,请在 wsadmin 提示符处输入以下命令:
print AdminTask.help('command_name')
使用此命令后,请使用以下命令将更改保存到主配置中:
AdminConfig.save()
用途
此命令修改外部总线的属性。外部总线代表另一单元(或同一单元)或者 IBM MQ 网络中可以与服务集成总线交换消息的总线。
目标对象
外部总线。
必需参数
- -bus busname
- 要为其修改外部总线的服务集成总线的名称。可以使用 listSIBuses 命令来列示现有总线的名称。
- -name busname
- 要修改的外部总线的名称。可以使用 listSIBForeignBuses 命令来列示现有总线的名称。
条件参数
无。
可选参数
- -description text
- 总线的可选描述,供进行管理时使用。
- -sendAllowed False | False
- (缺省值:True)生产者是否能够将消息发送至外部总线。
- False
- 生产者无法将消息发送至该外部总线。
- True
- 生产者能够将消息发送至该外部总线。
- -inboundUserid userID
- 入站用户标识用于将服务集成总线中目标的权限授予从外部总线到达的各个消息。如果这不是安全总线,那么此属性不会对消息产生影响。您可能想要指定入站用户标识:
- 如果外部总线与此总线不在同一个安全域中,并且在此总线中无法识别来自该外部总线的用户标识
- 以便以本地方式对此总线进行入站消息访问控制。
- -outboundUserid userID
- 出站用户标识将替换用于在所有发送至外部总线的消息中标识消息源的用户标识。如果两条总线都是安全总线,而且外部总线未使用自己的入站用户标识来覆盖此用户标识,那么外部总线还可使用此用户标识来授予消息对其目标的权限。
- -nextHopBus bus_name
- (如果 -routingType 为 Indirect)所连接的总线的序列中下一个服务集成总线的名称。中间总线可以是除服务集成总线之外的 IBM MQ 系统。
- -topicSpaceMappings local topicSpace_name : remote topicSpace_name
- 主题空间映射使本地主题空间中的订户能够接收外部主题空间中发布的消息。对于从本地主题空间流入外部总线的发布来说,外部总线需要等效的主题空间映射。本地总线的主题空间名将映射至外部总线上定义的主题空间名。这两个名称通常匹配。请注意,如果映射两个主题空间,就意味着它们包含相同的主题。可以指定多个主题空间对。
示例
以下示例指定现有外部总线 foreignbus1 的附加可选属性:- 入站用户标识 iuserid,用于在对 foreignbus1 启用安全性时对从 foreignbus1 发送至本地总线的消息及本地总线授权。
- 出站用户标识 ouserid,用于在对 foreignbus1 启用安全性时对从本地总线发送至 foreignbus1 的消息以及本地总线授权。
- 本地总线上的 Topic.Space1 与 foreignbus1 上的 Topic.Space2 之间的主题空间映射。此映射允许本地总线上的 Topic.Space1 的订户接收在 foreignbus1 上的 Topic.Space2 中发布的消息。
AdminTask.modifySIBForeignBus('[-bus bus1 -name foreignbus1 -inboundUserid iuserid
-outboundUserid ouserid -topicSpaceMappings [[Topic.Space1 Topic.Space2]]]')
'foreignbus1(cells/cell01/buses/bus1|sib-bus.xml#SIBForeignBus_1213023645293)'