modifySIBLink 命令
使用 modifySIBLink 命令修改服务集成总线链路的属性。
要运行该命令,请使用 wsadmin 脚本编制客户机的 AdminTask 对象。
wsadmin
脚本编制客户机通过 Qshell 运行.
有关更多信息,请参阅 使用 wsadmin 脚本编制配置 Qshell 以运行 WebSphere 脚本.
已经为服务集成总线命令提供了命令行帮助:
- 要获取 Jython 中可用服务集成总线命令的列表以及每个命令的简要描述,请在
wsadmin 提示符处输入以下命令:
print AdminTask.help('SIBAdminCommands')
- 要获取有关给定命令的总体帮助,请在 wsadmin 提示符处输入以下命令:
print AdminTask.help('command_name')
使用此命令后,请使用以下命令将更改保存到主配置中:
AdminConfig.save()
用途
modifySIBLink 命令修改服务集成总线链路的属性。
目标对象
无。
必需参数
- -bus
- 要为其修改服务集成总线链路的服务集成总线的名称。可以使用 listSIBuses 命令来列示现有总线的名称。
- -messagingEngine
- 要为其修改服务集成总线链路的消息传递引擎的名称。服务集成总线链路将一个消息传递引擎连接至另一服务集成总线中的另一消息传递引擎,从而提供了两个服务集成总线之间的网桥。
- -name
- 用于标识服务集成总线链路的名称。
- -foreignBusName
- 用于对服务集成总线链路定义远程服务集成总线的外部总线的名称。可以使用 listSIBForeignBuses 命令来列示现有外部总线的名称。
条件参数
无。
可选参数
- -bootstrapEndpoints
- 此属性的设置方式与 JMS 连接工厂设置中的提供程序端点属性相同。 有关更多信息,请参阅配置与非缺省引导服务器的连接中与设置引导程序端点有关的步骤。
引导端点的端口是在 SIB 端点地址上定义的端口,该地址是在外部总线上的目标应用程序服务器上配置的。
- -remoteMessagingEngineName
- -description
- 总线的可选描述,供进行管理时使用。
- -protocolName
传输链名必须是目标消息传递引擎所在服务器上定义的传输链的名称。
- -authAlias
必须预定义 J2C 认证别名。
- -exceptionDestination
- 这是以下情况下入站消息的目标:在服务集成总线链路无法将消息传递至其目标或传递至为该目标配置的异常目标时,或者在该目标不存在时。
- 系统
- 服务集成总线链路使用缺省异常目标。所有无法送达至总线目标的消息都将自动被重新路由至此链路所指定给的消息传递引擎的系统缺省异常目标:_SYSTEM.Exception.Destination.messaging_engine_name。
- 无
- 服务集成总线链路没有异常目标。无法送达的消息不会被重新路由至异常目标,并且可能会阻塞正在等待传递至同一目标的其他消息的处理。此选项可用来保留消息排序。
- 指定
- 服务集成总线链路使用此处指定的异常目标。如果无法使用此异常目标,那么它将使用系统异常目标。
- -initialState Started | Stopped
- 网关链路的状态,显示启动消息传递引擎时该链路是否自动启动。
信息 值 缺省 已启动 范围 - 已停止
- 当相关联的消息传递引擎启动时,网关链路处于已停止状态并且不能处理任何新的连接请求。
- 已启动
- 当相关联的消息传递引擎启动时,网关链路处于已启动状态并且可以处理任何新的连接请求。
- -preferLocal TRUE | FALSE
- 指示该链路是否首选将入局消息发送至与链路位于同一消息传递引擎的期望目标的队列点(如果可用)。该链路必须由正在 WebSphere® Application
Server V7.0 或更高版本服务器上运行的消息传递引擎所有。
仅当由与 WebSphere Application ServerV7.0 或更高版本 服务器或客户机一起运行并且连接至在 WebSphere Application ServerV7.0 或更高版本 服务器上运行的消息传递引擎的 JMS 应用程序使用时,才支持此选项。在 WebSphere Application Server 的先前版本上使用将导致应用程序发生异常。
信息 值 缺省 TRUE 范围 - TRUE
- 将每个入局消息发送至与链路位于同一消息传递引擎的期望目标的队列点(如果可用)。
- FALSE
- 将入局消息发送至期望目标的任何队列点。
示例
wsadmin>AdminTask.showSIBLink('[-bus bus1 -messagingEngine node01.server1-bus1 -sibLink
mySIBLink]')
'{bootstrapEndpoints=host1:1111:chain1, protocolName=null, authAlias=null,
preferLocalQueuePoints=true, name=mySIBLink, uuid=34647E59163B253D,
remoteMessagingEngineName=node02.server2-bus2, description=null,
targetUuid=BAD49BA75CD36D740E366978, initialState=STARTED,
exceptionDestination=$DEFAULT_EXCEPTION_DESTINATION}'
wsadmin>AdminTask.modifySIBLink('[-bus bus1 -messagingEngine node01.server1-bus1
-name MySIBLink -foreignBusName -bus2
-bootstrapEndpoints anotherhost:2222:BootstrapBasicMessaging]')
wsadmin>AdminTask.showSIBLink('[-bus bus1 -messagingEngine node01.server1-bus1 -sibLink
mySIBLink]')
'{bootstrapEndpoints=anotherhost:2222:BootstrapBasicMessaging, protocolName=null,
authAlias=null, preferLocalQueuePoints=true, name=mySIBLink, uuid=34647E59163B253D,
remoteMessagingEngineName=node02.server2-bus2, description=null,
targetUuid=BAD49BA75CD36D740E366978, initialState=STARTED,
exceptionDestination=$DEFAULT_EXCEPTION_DESTINATION}'
修改服务集成总线链路以使要对其使用队列点的首选项不存在。
AdminTask.modifySIBLink('[-bus bus1 -messagingEngine cluster1.000-bus1 -name MyLink
-foreignBusName -FB1 bootstrapEndpoints host1:1111:chain1 -remoteMessagingEngineName
-cluster2.000-FB1 -preferLocal FALSE]')