modifySIBEngine 命令
使用 modifySIBEngine 命令修改服务集成总线成员的消息传递引擎的属性。
要运行该命令,请使用 wsadmin 脚本编制客户机的 AdminTask 对象。
wsadmin
脚本编制客户机通过 Qshell 运行.
有关更多信息,请参阅 使用 wsadmin 脚本编制配置 Qshell 以运行 WebSphere 脚本.
已经为服务集成总线命令提供了命令行帮助:
- 要获取 Jython 中可用服务集成总线命令的列表以及每个命令的简要描述,请在
wsadmin 提示符处输入以下命令:
print AdminTask.help('SIBAdminCommands')
- 要获取有关给定命令的总体帮助,请在 wsadmin 提示符处输入以下命令:
print AdminTask.help('command_name')
使用此命令后,请使用以下命令将更改保存到主配置中:
AdminConfig.save()
用途
此命令修改消息传递引擎的属性。
目标对象
消息传递引擎。
必需参数
- -bus busname
- 配置了该总线成员的服务集成总线的名称。可以使用 listSIBuses 命令来列示现有总线的名称。
条件参数
- -node nodename -server servername
- 要更改作为总线成员的应用程序服务器的消息传递引擎属性,请指定运行该服务器的节点的名称以及服务器名。
- -cluster cluster
- 要更改作为总线成员的服务器集群的消息传递引擎属性,请指定该集群的名称。
- -engine enginename
- 如果总线成员只有一个消息传递引擎,那么不需要指定引擎名。如果总线成员有多个消息传递引擎,那么必须指定要更改其属性的引擎的名称。
可选参数
- -description text
- 消息传递引擎的可选描述,供进行管理时使用。
- -initialState STARTED | STOPPED
- 初始状态确定消息传递引擎是否在服务器或服务器集群启动时自动启动。
- 已停止
- 当相关联的应用程序服务器启动时,消息传递引擎将停止并且不可用于处理消息。
- 已启动
- 当相关联的应用程序服务器启动时,消息传递引擎将启动并且可用于处理消息。
- -highMessageThreshold number
- 消息传递引擎在其消息点上可放置的最大总消息数。
在创建消息传递引擎时,将使用总线的消息阈值上限来设置此属性的缺省值。在此消息传递引擎上创建消息点时,将使用此属性的值为该消息点设置缺省消息阈值上限。
- -restrictLongDBLock TRUE | FALSE
- 这是用于指定活动消息传递引擎是否必须长时间锁定数据库中的
SIBOWNER 表的参数。如果选择了此选项,那么消息传递引擎只会短时间锁定数据库。在活动消息传递引擎不响应数据库的情况下,备用消息传递引擎将能够获得数据库的所有权,这是因为活动消息传递引擎只会短时间锁定数据库。此参数有两个可能的值:
- TRUE
- 限制长时间锁定数据库。
- FALSE
- 不限制长时间锁定数据库。
如果指定了 -dataStore 参数,请使用此参数。
要点: 虽然已选择该属性,但是在使用 WebSphere® Application Server V9.0 和更高版本的 sibDBUpgrade 命令升级数据库表之前,该属性将不会生效。
示例
wsadmin>AdminTask.showSIBEngine('[-bus bus1 -node node01 -server server1
-engine node01.server1-bus1 ]')
'{initialState=STARTED, targetGroups=[], name=node01.server1-bus1,
highMessageThreshold=50000, messageStoreType=FILESTORE, uuid=56F8FE11AB84188D,
busName=bus1, busUuid=6DF19B02BC879BD1}'
wsadmin>AdminTask.modifySIBEngine('[-bus bus1 -node node01 -server server1
-engine node01.server1-bus1 -initialState STOPPED ]')
wsadmin>AdminTask.showSIBEngine('[-bus bus1 -node node01 -server server1
-engine node01.server1-bus1 ]')
'{initialState=STOPPED, targetGroups=[], name=node01.server1-bus1,
highMessageThreshold=50000, messageStoreType=FILESTORE, uuid=56F8FE11AB84188D,
busName=bus1, busUuid=6DF19B02BC879BD1}'