mediateSIBDestination 命令

使用 mediateSIBDestination 命令调解服务集成总线的总线目标。

调解目标时,将使一个调解与所选总线目标相关联。在运行时,该调解将对该总线目标处理的消息执行一些消息处理工作。请注意,每次只能使用单个调解来调解目标。可以使用同一个调解来调解多个目标。

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

[IBM i][IBM i]wsadmin 脚本编制客户机通过 Qshell 运行. [IBM i]有关更多信息,请参阅 使用 wsadmin 脚本编制配置 Qshell 以运行 WebSphere 脚本.

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

    print AdminTask.help('SIBAdminCommands')

  • 要获取有关给定命令的总体帮助,请在 wsadmin 提示符处输入以下命令:

    print AdminTask.help('command_name')

使用此命令后,请使用以下命令将更改保存到主配置中:

AdminConfig.save()

用途

此命令调解服务集成总线的总线目标。可使用某些参数在 IBM MQ 服务器上创建调解队列点以及在集群或服务器上创建相应的调解执行点。

仅应在支持服务器集群的 WebSphere® Application Server 环境中使用 node、 server 和 cluster 参数。
注: 如果所调解目标的调解点是 IBM MQ 服务器上的队列(使用 wmqServer 参数),那么必须指定调解代码的运行位置。如果调解代码在服务集成总线成员中运行,那么您必须使用 node、server 和 cluster 参数来指定调解执行点。如果调解代码在外部运行,那么必须省略 node、 server 和 cluster 参数。
  • 如果使用的调解点不是 IBM MQ 服务器上的队列,请使用 node、 server 和 cluster 参数来指定调解点的所在位置。这也是调解的运行位置。如果省略这些参数,那么缺省调解点是所调解目标被指定给的总线成员。
  • 如果使用的调解点是 IBM MQ 上的队列,请使用 wqmServer 和 wmqQueueName 参数来指定调解点。
    • 如果省略 node、 server 和 cluster 参数,那么服务集成总线会假定调解进程由外部 IBM MQ 应用程序执行。
    • 如果要将调解点指定给 IBM MQ 服务器总线成员,请使用 wmqServer 和 wmqQueueName 参数指定 IBM MQ 队列。在此情况下,因为省略了 node、server 和 cluster 参数,所以外部 IBM MQ 应用程序可运行调解。node、server 和 cluster 参数用于指定运行调解代码的总线成员。

目标对象

无。

必需参数

-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
[非主题空间] 要对集群总线成员调解总线目标,请指定该集群的名称。

仅应在支持服务器集群的 WebSphere Application Server 环境中使用此选项。

可选参数

-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
缺省值为 TRUE。
-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}

指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-base-dist&topic=rjo_cli_dest_mediate
文件名:rjo_cli_dest_mediate.html