mediateSIBDestination 命令
使用 mediateSIBDestination 命令调解服务集成总线的总线目标。
调解目标时,将使一个调解与所选总线目标相关联。在运行时,该调解将对该总线目标处理的消息执行一些消息处理工作。请注意,每次只能使用单个调解来调解目标。可以使用同一个调解来调解多个目标。
要运行该命令,请使用 wsadmin 脚本编制客户机的 AdminTask 对象。
wsadmin
脚本编制客户机通过 Qshell 运行.
有关更多信息,请参阅 使用 wsadmin 脚本编制配置 Qshell 以运行 WebSphere 脚本.
- 要获取 Jython 中可用服务集成总线命令的列表以及每个命令的简要描述,请在
wsadmin 提示符处输入以下命令:
print AdminTask.help('SIBAdminCommands')
- 要获取有关给定命令的总体帮助,请在 wsadmin 提示符处输入以下命令:
print AdminTask.help('command_name')
AdminConfig.save()
用途
此命令调解服务集成总线的总线目标。可使用某些参数在 IBM MQ 服务器上创建调解队列点以及在集群或服务器上创建相应的调解执行点。
目标对象
无。
必需参数
- -bus bus_name -destinationName destination_name
- 要调解的目标。
- -mediationName mediation_name
- 要应用于总线目标的调解的名称。要使用此命令,该调解必须已存在。
条件参数
- -wmqServer mq_server_name -wmqQueueName mq_queue_name
- [队列或 Web Service 目标] 要将调解点分配到 IBM MQ 队列,请同时指定该调解点所要分配到的 IBM MQ 服务器总线成员的名称,以及用来存储可供调解的消息的 IBM MQ 队列的名称。mq_server_name 是创建 IBM MQ 服务器时在 -name 参数中指定的 IBM MQ 服务器的名称。mq_queue_name 是 IBM MQ 管理分配给 IBM MQ 队列的名称。
- -node node_name -server server_name
- [非主题空间] 要对服务器总线成员调解总线目标,请指定运行该服务器的节点的名称以及该服务器的名称。
- -cluster cluster_name
- [非主题空间] 要对集群总线成员调解总线目标,请指定该集群的名称。
可选参数
- -nonPersistentReliability
指定要与服务集成通过 IBM MQ 网络接收的非持久 IBM MQ 消息配合使用的服务集成服务质量。IBM MQ 网络中的消息具有自己的服务质量级别。此级别是持久或非持久。服务集成应用程序接收这些消息时,将对这些消息指定服务集成服务质量级别,该级别依赖于这些消息的 IBM MQ 服务质量级别。
对于接收到的非持久 IBM MQ 消息,缺省服务集成服务质量为 RELIABLE_NONPERSISTENT。如果选择覆盖缺省值,那么您可能要选择一个其他非持久服务集成服务质量(BEST_EFFORT_NONPERSISTENT 或 EXPRESS_NONPERSISTENT)。但是,可选择下列五个可能的服务集成服务质量中的任何一个:- BEST_EFFORT_NONPERSISTENT
- 当消息传递引擎停止或发生故障时,将废弃消息。如果用于发送消息的连接变为不可用或者系统资源不足,也可能会废弃消息。
- EXPRESS_NONPERSISTENT
- 当消息传递引擎停止或发生故障时,将废弃消息。如果用于发送消息的连接变为不可用,也可能会废弃消息。
- RELIABLE_NONPERSISTENT
- 当消息传递引擎停止或发生故障时,将废弃消息。
- RELIABLE_PERSISTENT
- 当消息传递引擎发生故障时,可能会废弃消息。
- ASSURED_PERSISTENT
- 不废弃消息。
注: 较高级别的可靠性对性能有较大影响。有关更多信息,请参阅 在 JMS 传送选项和消息可靠性与 IBM MQ 持久性值之间进行映射。
- -persistentReliability
指定要与服务集成通过 IBM MQ 网络接收的持久 IBM MQ 消息配合使用的服务集成服务质量。IBM MQ 网络中的消息具有自己的服务质量级别。此级别是持久或非持久。服务集成应用程序接收这些消息时,将对这些消息指定服务集成服务质量级别,该级别依赖于这些消息的 IBM MQ 服务质量级别。
对于接收到的持久 IBM MQ 消息,缺省服务集成服务质量为 ASSURED_PERSISTENT。如果选择覆盖缺省值,那么您可能要选择另一持久服务集成服务质量 (RELIABLE_PERSISTENT)。但是,可选择下列五个可能的服务集成服务质量中的任何一个:- BEST_EFFORT_NONPERSISTENT
- EXPRESS_NONPERSISTENT
- RELIABLE_NONPERSISTENT
- RELIABLE_PERSISTENT
- ASSURED_PERSISTENT
有关更多信息,请参阅 在 JMS 传送选项和消息可靠性与 IBM MQ 持久性值之间进行映射。
- -useRFH2
- 确定服务集成技术在它放到调解点上的消息中是否包括 RFH2 头。可能的值是:
- TRUE
- FALSE
- -maintainStrictMessageOrder
- 维护严格消息顺序.
可能的值是:
- 已选中
- 维护生产者向目标发送消息的顺序。
在运行时,此属性优先于其他配置属性值。有关在运行时被覆盖的配置属性的信息,请参阅总线目标的严格消息排序。
- 已清除
- 对此目标不保留消息顺序。
示例
- 使用 Jython:
wsadmin>AdminTask.mediateSIBDestination("-bus abus -destinationName myqueue -mediationName filterMed -cluster cluster1")
- 使用 Jacl:
wsadmin>$AdminTask mediateSIBDestination {-bus abus -destinationName myqueue -mediationName filterMed -cluster cluster1}