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