createSIBus 命令

使用 createSIBus 命令创建新服务集成总线。

要运行此命令,请使用 wsadmin 脚本编制客户机的 AdminTask 对象。

[IBM i][IBM i]wsadmin 脚本编制客户机从 Qshell 运行

为服务集成总线的命令提供了命令行帮助:
  • 要获取 Jython 中可用服务集成总线命令的列表以及每个命令的简短描述,请在 wsadmin 提示符处输入以下命令:

    print AdminTask.help('SIBAdminCommands')

  • 有关特定命令的概述帮助,请在 wsadmin 提示符处输入以下命令:

    print AdminTask.help('command_name')

使用该命令后,使用以下命令将更改保存到主配置。

AdminConfig.save()

用途

此命令创建新服务集成总线。

目标对象

必需参数

-bus 总线名称
用于标识服务集成总线的名称。 选择唯一的名称。

条件参数

无。

可选参数

-description 文本
总线的可选描述,供进行管理时使用。
-secure TRUE | FALSE
不推荐对此版本使用此参数。
interEngineAuthAlias 名称
用于授权总线上的消息传递引擎之间的通信的认证别名名称。

如果总线包含 WebSphere® Application Server V 6.x 总线成员,那么必须指定引擎间认证别名。 启用总线安全性后,总线使用引擎间认证别名来认证来自其他消息传递引擎的入局连接。 未经授权的消息传递引擎不能连接至总线。

-mediationsAuthAlias 名称
用于授权调解来访问总线的认证别名的名称。
-securityGroupCacheTimeout 超时值
对安全组进行高速缓存将花费的时间长短(以分钟计)。 timeout_value 可以在 099999范围内。 缺省值为 120

增加超时可降低用户注册中心上的负载并可改进性能,但会导致系统降低对用户组成员资格的更改的响应性。 为了将组高速缓存调整至最优设置,需要在响应性需求与注册表负载之间达到平衡。 例如,如果系统必须快速响应用户组成员资格的更改,请指定 15 分钟的超时。 如果系统需要降低响应频率(例如,响应隔夜更改),请指定 1440 分钟的超时(24 小时)。 如果设置为 0,那么高速缓存中的条目不会超时,所以会保留至服务器下一次重新启动。

对此值的更改将立即生效,并且仅影响对其更改了配置的总线的组高速缓存。

-protocol 协议
用于在此总线的消息传递引擎之间进行通信的传输链。

传输链必须与服务器的消息传递引擎入站传输设置中定义的其中一个传输链相对应。 所有服务器都自动具有为它们定义的特定数目的传输链,并且也可以创建新的传输链。

缺省传输链为 InboundBasicMessaging

-discardOnDelete TRUE | FALSE
如果可废弃已删除消息点上的消息,请将此选项设置为 TRUE。 如果已删除消息点上的消息应保留在系统异常目标上,请将此选项设置为 FALSE
highMessageThreshold number
总线上的任何消息传递引擎在其消息点上可放置的最大总消息数。

此值用于在创建消息传递引擎时为其设置缺省消息阈值上限。

configurationReloadEnabled TRUE | FALSE
将此选项设置为 TRUE 以动态重新装入此总线的配置文件。

此选项为 TRUE 时,系统会应用对总线配置的某些更改而不需要重新启动消息传递引擎。 系统会在对总线添加或移除目标或调解时应用这些更改。 此选项还控制着是否对该总线上的所有消息传递引擎进行自动更新。

-busSecurity TRUE | FALSE
将此选项设置为 TRUE 以对总线实施授权策略,这还要求启用管理安全性。 如果要一直禁用总线安全性,请将此选项设置为 FALSE。 如果禁用管理安全性,那么总线是不安全的。
-bootstrapPolicy SIBSERVICE_ENABLED | MEMBERS_AND_MODIFIED | MEMBERS_ONLY
设置三个选项中的一个以对总线实施总线成员策略。
SIBSERVICE_ENABLED
启用了 SIB 服务的单元中的任一服务器都可以处理引导程序请求。
MEMBERS_AND_MODIFIED
只有总线成员或指定的引导服务器才能处理引导请求。
仅 MEMBERS_ONLY
只有总线成员才能处理引导请求。
-useServerIdForMediations TRUE | FALSE
如果要使用总线的单个服务器标识来运行调解,请将此选项设置为 TRUE。 此选项允许您在多个安全域之间运行调解而不需要对每个域指定调解认证别名。 可使用服务器标识对全局域运行调解。 如果要使用调解认证别名来运行调解,请将此选项设置为 FALSE
-auditAllowed TRUE | FALSE
将此选项设置为 TRUE 以对总线启用安全性审计。 将此选项设置为 FALSE 以对总线禁用安全性审计。 缺省值为 true。 必须具有审计管理员特权才能使用此参数。

示例

AdminTask.createSIBus('[-bus bus1 -description [A new bus] -busSecurity false ]')
'bus1(cells/cell01/buses/bus1|sib-bus.xml#SIBus_1213019988044)'