addSIBusMember 命令
借助 wsadmin 工具,使用 addSIBusMember 命令将成员添加至服务集成总线。总线成员可以是应用程序服务器或 WebSphere® MQ 服务器。
要运行该命令,请使用 wsadmin 脚本编制客户机的 AdminTask 对象。
![[IBM i]](../images/iseries.gif)
wsadmin
脚本编制客户机通过 Qshell 运行.
有关更多信息,请参阅 使用 wsadmin 脚本编制配置 Qshell 以运行 WebSphere 脚本.
- 要获取 Jython 中可用服务集成总线命令的列表以及每个命令的简要描述,请在
wsadmin 提示符处输入以下命令:
print AdminTask.help('SIBAdminCommands')
- 要获取有关给定命令的总体帮助,请在 wsadmin 提示符处输入以下命令:
print AdminTask.help('command_name')
AdminConfig.save()
用途
addSIBusMember 命令将新成员添加至服务集成总线。将应用程序服务器添加为总线成员时,将自动创建带有缺省设置的消息传递引擎。
将 WebSphere MQ 服务器添加为总线成员时,系统会创建服务器代理,它可覆盖在 WebSphere MQ 服务器中定义的父代连接属性(主机、端口、通道和 SSL 安全性配置别名)。这意味着可以对每个总线成员资格指定一组不同的连接属性。
目标对象
无。
已创建总线成员对象。如果总线成员是服务器,那么还会创建消息传递引擎。
必需参数
- -bus bus_name
- 用于标识服务集成总线的名称。可以使用 listSIBuses 命令来列示现有总线的名称。
条件参数
- -node node_name
- -server server_name
- 要将应用程序服务器添加为总线成员,请指定运行该服务器的节点的名称和该服务器的名称。
如果指定这些参数,那么不要指定 -wmqServer 参数。
- -wmqServer
- 要将
WebSphere MQ
服务器添加为总线成员,请指定
WebSphere MQ
服务器的名称。这是创建 WebSphere MQ
服务器时在 -name 参数中指定的名称。
如果指定此参数,那么不要指定 -node 或 -server 参数。
可选参数
- -description text
- 总线成员的可选描述,供进行管理时使用。
- -virtualQueueManagerName
- WebSphere MQ
服务器虚拟队列管理器的名称的覆盖值。将消息发送至
IBM MQ 时,IBM MQ
网关队列管理器会将总线视为远程队列管理器。虚拟队列管理器名称将作为此远程队列管理器的名称传递至
IBM MQ。缺省值是总线的名称。如果此值对于
IBM MQ
队列管理器并非有效名称,或者另一现有
IBM MQ
队列管理器具有相同名称,那么应将缺省值替换为另一个值,该值是对 IBM MQ
队列管理器有效的唯一名称。该名称必须符合以下条件才有效:
- 它必须包含 1 到 48 个字符。
- 它必须遵循 IBM MQ 队列命名规则(请参阅 IBM MQ 信息中心中的“IBM MQ 对象的命名规则”主题)。
- -host
- WebSphere MQ 服务器总线成员主机属性的覆盖值。此值是与其建立连接以与队列管理器或队列共享组通信的主机的主机名或 IP 地址。如果指定了 -wmqServer 参数,请使用此参数。
- -port
- WebSphere MQ 服务器总线成员端口属性的覆盖值。端口号受队列管理器或队列共享组侦听器(侦听器将侦听连接)监视。缺省值为 1414。如果指定了 -wmqServer 参数,请使用此参数。
- -channel
- WebSphere MQ 服务器总线成员通道属性的覆盖值。这是用于与 IBM MQ 队列管理器或 IBM MQ for z/OS® 队列共享组建立连接的服务器连接通道的名称。缺省值为 SYSTEM.DEF.SVRCONN。如果指定了 -wmqServer 参数,请使用此参数。
- -securityAuthAlias
- WebSphere MQ 服务器总线成员 securityAuthAlias 属性的覆盖值。这是连接至 WebSphere MQ 服务器时提供的认证别名。此参数没有缺省值。 如果指定了 -wmqServer 参数,请使用此参数。
- -transportChain
- WebSphere MQ 服务器总线成员 transportChain 属性的覆盖值。这是与 IBM MQ 通信时传输链使用的名称。缺省值为 OutboundBasicWMQClient。如果指定了 -wmqServer 参数,请使用此参数。
- -trustUserIds TRUE | FALSE
- WebSphere MQ
服务器总线成员 trustUserIds 属性的覆盖值。它将确定在来自
IBM MQ
的消息中接收到的用户标识是否传播至消息。应用程序用户标识始终是通过
jsAppUserIdRFH2 值设置的。如果此值不存在(因为 RFH2 头的
<sib> 文件夹中不存在该键/值对或该消息没有 RFH2 头),那么表示未设置此字段。此参数有两个可能的值:
- TRUE
- 用户标识将传播至消息。
- FALSE
- 用户标识将不会传播至消息。
缺省值为 TRUE。如果指定了 -wmqServer 参数,请使用此参数。
- -fileStore
- 创建要用作消息传递引擎的消息存储器的文件存储器。文件存储器是一种消息存储器,它通过操作系统直接使用文件系统中的文件。还可使用数据存储器。有关更多信息,请参阅相关链接。
- -logSize logsize
- 日志文件的大小,以 MB 计。如果指定了 -fileStore 参数,请使用此参数。
- -logDirectory logdirectoryname
- 不想使用缺省日志目录时所使用的日志文件目录的名称。如果指定了 -fileStore 参数,请使用此参数。
- -minPermanentStoreSize minpermanentstoresize
- 永久存储器文件的最小大小,以 MB 计。如果指定了 -fileStore 参数,请使用此参数。
- -minTemporaryStoreSize mintemporarystoresize
- 临时存储器文件的最小大小,以 MB 计。如果指定了 -fileStore 参数,请使用此参数。
- -maxPermanentStoreSize maxpermanentstoresize
- 永久存储器文件的最大大小,以 MB 计。如果指定了 -fileStore 参数,请使用此参数。
- -maxTemporaryStoreSize maxtemporarystoresize
- 临时存储器文件的最大大小,以 MB 计。如果指定了 -fileStore 参数,请使用此参数。
- -unlimitedPermanentStoreSize TRUE | FALSE
- 用于指定永久存储器大小是否不受限的参数。此参数有两个可能的值:
- TRUE
- 永久存储器大小不受限。
- FALSE
- 永久存储器大小受限。如果使用此选项,请提供 -maxPermanentStoreSize 参数。
如果指定了 -fileStore 参数,请使用此参数。
- -unlimitedTemporaryStoreSize TRUE | FALSE
- 用于指定临时存储器大小是否不受限的参数。此参数有两个可能的值:
- TRUE
- 临时存储器大小不受限。
- FALSE
- 临时存储器大小受限。如果使用此选项,请提供 -maxTemporaryStoreSize 参数。
如果指定了 -fileStore 参数,请使用此参数。
- -permanentStoreDirectory permanentstoredirectoryname
- 不想使用缺省永久存储器目录时所使用的永久存储器目录的名称。如果指定了 -fileStore 参数,请使用此参数。
- -temporaryStoreDirectory temporarystoredirectoryname
- 不想使用缺省临时存储器目录时所使用的临时存储器目录的名称。如果指定了 -fileStore 参数,请使用此参数。
- -dataStore
- 创建要用作消息传递引擎的消息存储器的数据存储器。
数据存储器由消息传递引擎将持久数据存储在数据库中时使用的一组表构成。请参阅数据存储器表以获取组成数据存储器的表的列表。数据存储器中的所有表都处于同一数据库模式。通过对每个数据存储器使用不同的模式名称,可在同一个数据库中创建多个数据存储器。
还可使用文件存储器(缺省值)。有关更多信息,请参阅相关链接。 - -createDefaultDatasource TRUE | FALSE
- 用于指定创建消息传递引擎时是否创建缺省数据源的参数。此参数有两个可能的值:
- TRUE
- 创建缺省数据源。
- FALSE
- 不创建缺省数据源。
如果指定了 -dataStore 参数,请使用此参数。如果指定了 -cluster 参数,请不要使用此参数。
- -datasourceJndiName jndiname
- 数据源的 JNDI 名称,消息传递引擎使用此数据源来访问数据存储器的关系数据库管理系统 (RDBMS)。如果指定了 -dataStore 参数,请使用此参数。
- -authAlias authalias
- 认证别名的名称,消息传递引擎使用此认证别名连接至其数据存储器中的数据库。如果指定了 -dataStore 参数,请使用此参数。
- -createTables datasource
- 自动为指定的数据源创建数据库表。如果未指定此选项,那么数据库管理员必须创建这些表。如果指定了 -dataStore 参数,请使用此参数。
- -restrictLongDBLock TRUE | FALSE
- 这是用于指定活动消息传递引擎是否必须长时间锁定数据库中的
SIBOWNER 表的参数。如果选择了此选项,那么消息传递引擎只会短时间锁定数据库。在活动消息传递引擎不响应数据库的情况下,备用消息传递引擎将能够获得数据库的所有权,这是因为活动消息传递引擎只会短时间锁定数据库。此参数有两个可能的值:
- TRUE
- 限制长时间锁定数据库。
- FALSE
- 不限制长时间锁定数据库。
如果指定了 -dataStore 参数,请使用此参数。
要点: 虽然已选择该属性,但是在使用 WebSphere Application Server V9.0 和更高版本的 sibDBUpgrade 命令升级数据库表之前,该属性将不会生效。 - -schemaName schemaname
- 不想使用缺省模式名时所使用的数据库模式的名称,该数据库模式包含数据存储器的表。有关缺省模式的详细信息,请参阅在数据库中创建用户和模式。如果指定了 -dataStore 参数,请使用此参数。
- -initialHeapSize size
- 服务器或集群中每个服务器的初始 Java™ 虚拟机 (JVM) 堆大小,以兆字节计。没有缺省值。如果未指定此参数,那么不会做任何更改。如果指定了此参数,那么提供的值必须大于或等于零并且小于或等于 2048。如果提供了参数但未提供值,那么会生成错误消息。
- -maxHeapSize size
- 服务器或集群中每个服务器的最大 JVM 堆大小,以兆字节计。没有缺省值。如果未指定此参数,那么不会做任何更改。如果指定了此参数,那么提供的值必须大于或等于零并且小于或等于 2048。如果提供了参数但未提供值,那么会生成错误消息。
示例
将 node1 上的 server1 添加为带有缺省文件存储器的 bus1 成员。
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 ]')
将 server1 添加为 bus1 成员,并使用文件存储器保存消息。
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 -fileStore ]')
将 server1 添加为 bus1 成员,使用文件存储器保存消息,并设置一些选项。
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 -fileStore
-logSize 100 -logDirectory C:\\filestore1 ]')
将 server1 添加为 bus1 成员,并使用数据存储器保存消息。
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 -dataStore ]')
将 server1 添加为 bus1 成员,使用数据存储器保存消息,并设置一些选项。
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 -dataStore
-createDefaultDatasource true -datasourceJndiName myjndi]')
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
将初始 JVM 堆大小更改为 256,并将最大 JVM 堆大小更改为 512。
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1
-initialHeapSize 256 -maxHeapSize 512]')
参考主题