createSIBJMSQueue 命令

使用 createSIBJMSQueue 命令在特定范围为缺省消息传递提供程序创建新 JMS 队列。

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

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

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

    print AdminTask.help('SIBJMSAdminCommands')

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

    print AdminTask.help('command_name')

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

AdminConfig.save()

用途

createSIBJMSQueue 命令在特定范围为缺省消息传递提供程序创建 JMS 队列。

目标对象

在其中创建 JMS 队列的缺省消息传递提供程序的范围。

必需参数

-name
用于识别此 JMS 队列以便管理的标识。
-jndiName
用于将队列与应用程序服务器名称空间绑定的 JNDI 名称。
-queueName
JMS 队列映射至的服务集成总线目标的名称。

可选参数

-description
总线的可选描述,供管理使用。
-deliveryMode Application | NonPersistent | Persistent
MessageProducers 要用于发送至此队列的消息的传送方式。
-timeToLive
消息发送至此队列的分派时间的缺省时间长度应该由系统保留,其中 0 表明生存时间值不到期。如果未提供生存时间参数,那么会使用来自生产者的值。
-priority
发送至此队列的消息的优先级。如果未填写此值,那么使用来自生产者的值。在 09 的范围中,0 表示最低优先级,9 表示最高优先级。
-readAhead AsConnection | AlwaysOn | AlwaysOff
用于控制消息交付期间的预读优化。缺省值为 AsConnection
-busName
要对其配置服务集成总线目标(由 queueName 标识)的服务集成总线的名称。如果未设置,那么使用应用程序连接至的总线。
-scopeToLocalQP TRUE | FALSE
指示使用此 JMS 队列寻址时,底层服务集成总线队列目标的范围是否限定为本地队列点。 本地队列点是在 JMS 应用程序连接至的消息传递引擎上配置的队列点。使用此 JMS 队列发送和接收消息时以及在请求消息中设置应答队列时,此选项适用。如果在请求消息中设置了应答队列,那么本地队列点在设置应答队列的应用程序连接至的消息传递引擎上,而不在使用应答队列的应用程序将应答消息发送至的消息传递引擎上。如果连接的消息传递引擎没有对应该目标的队列点,那么会忽略此选项。缺省值为 FALSE

仅当由与 WebSphere® Application Server V7.0 或更高版本 服务器或客户机一起运行并且连接至在 WebSphere Application Server V7.0 或更高版本 服务器上运行的消息传递引擎的 JMS 应用程序使用时,才支持更改此选项的缺省设置。在 WebSphere Application Server 的先前版本上使用将导致应用程序发生异常。

-producerBind TRUE | FALSE
指示 JMS 生产者如何绑定至集群队列的队列点。缺省值为 FALSE

仅当由与 WebSphere Application Server V7.0 或更高版本 服务器或客户机一起运行并且连接至在 WebSphere Application Server V7.0 或更高版本 服务器上运行的消息传递引擎的 JMS 应用程序使用时,才支持更改此选项的缺省设置。在 WebSphere Application Server 的先前版本上使用将导致应用程序发生异常。

TRUE
会话打开时,消息传递系统会选择队列点。该会话产生的所有消息将发送至所选队列点。选择队列点时,消息传递系统会使用 producerPreferLocal 设置。
FALSE
每次发送消息时消息传递系统会选择队列点,并且可能会在所有可用队列点间分摊消息的工作负载。选择队列点时,消息传递系统会使用 producerPreferLocal 设置。
-producerPreferLocal TRUE | FALSE
指示消息传递系统选择要将消息产生至的队列点时,生产者本地的队列点的首选优先级是否高于其他可用队列点。本地队列点是在 JMS 应用程序连接至的消息传递引擎上配置的队列点。缺省值为 TRUE

仅当由与 WebSphere Application Server V7.0 或更高版本 服务器或客户机一起运行并且连接至在 WebSphere Application Server V7.0 或更高版本 服务器上运行的消息传递引擎的 JMS 应用程序使用时,才支持更改此选项的缺省设置。在 WebSphere Application Server 的先前版本上使用将导致应用程序发生异常。

-consumerGatherMessages TRUE | FALSE
JMS 使用者或浏览者被消息传递系统连接至服务集成总线目标的单个队列点。此参数指示 JMS 使用者或浏览者是从服务集成总线目标的任何可用队列点获取消息 (TRUE) 还是从它连接至的单个队列点获取消息 (FALSE)。缺省值为 FALSE。从多个队列点收集消息会导致性能成本上升并且不能保留消息顺序。

仅当由与 WebSphere Application Server V7.0 或更高版本 服务器或客户机一起运行并且连接至在 WebSphere Application Server V7.0 或更高版本 服务器上运行的消息传递引擎的 JMS 应用程序使用时,才支持更改此选项的缺省设置。在 WebSphere Application Server 的先前版本上使用将导致应用程序发生异常。

示例

注: 在以下示例中,以 wsadmin> 开始的代码块显示了由用户输入的代码。不是以 wsadmin> 开始的行显示控制台所返回的代码。
  • 使用 Jython:
    wsadmin>AdminConfig.getid("/Node:9994GKCNode01" )
    '9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)'
    wsadmin>AdminTask.createSIBJMSQueue("WASINSTALL2Node01(cells/WASINSTALL2Cell01/
    nodes/WASINSTALL2Node01|node.xml#Node_1)", ["-name", "jmsq2", "-jndiName",
     "jms/jnmsq2", "-queueName", "busq4jmsq2"])
    'jmsq2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml
    #J2CAdminObject_1098737234986)'
    wsadmin>AdminTask.listSIBJMSQueues("WASINSTALL2Node01(cells/WASINSTALL2Cell01
    /nodes/WASINSTALL2Node01|node.xml#Node_1)")
    'queue1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CAdminObject_1098711838691)
    jmsq2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CAdminObject_1098737234986)'
  • 使用 Jacl:
    wsadmin>$AdminConfig getid /Node:9994GKCNode01
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
    wsadmin>$AdminTask createSIBJMSQueue 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
     {-name jmsq2 -jndiName jms/jnmsq2 -queueName busq4jmsq2}
    jmsq2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CAdminObject_1098737234986)
    wsadmin>$AdminTask listSIBJMSQueues 
    9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)
    queue1(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CAdminObject_1098711838691)
    jmsq2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml#
    J2CAdminObject_1098737234986)
以下示例显示如何创建缺省消息传递提供程序 JMS 队列,该队列在会话打开时选择队列点并且永不更改:
  • 使用 Jython:
    wsadmin>AdminTask.createSIBJMSQueue("9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1)", ["-name", "MyJMSQueue", "-jndiName",
     "MyJMSQueue", "-busName bus1", "-queueName", "MyExistingQueue", "-deliveryMode",
     "Application", "-readAhead", "AsConnection", "-producerBind", "TRUE"])
  • 使用 Jacl:
    wsadmin>$AdminTask createSIBJMSQueue 9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1 {-name MyJMSQueue -jndiName MyJMSQueue 
    -busName bus1 -queueName MyExistingQueue -deliveryMode Application 
    -readAhead AsConnection -producerBind TRUE }
以下示例显示如何创建缺省消息传递提供程序 JMS 队列,该队列在每次发送消息时选择队列点。选择队列点时没有首选项,并且使用者从任意队列点获取消息:
  • 使用 Jython:
    wsadmin>AdminTask.createSIBJMSQueue("9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1)", ["-name", "MyJMSQueue", "-jndiName",
     "MyJMSQueue", "-busName bus1", "-queueName", "MyExistingQueue", "-deliveryMode",
     "Application", "-readAhead", "AsConnection", "-producerBind", "FALSE",
     "-producerPreferLocal", "FALSE", "-gatherMessages", "TRUE"])
  • 使用 Jacl:
    wsadmin>$AdminTask createSIBJMSQueue 9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1 {-name MyJMSQueue -jndiName MyJMSQueue 
    -busName bus1 -queueName MyExistingQueue -deliveryMode Application 
    -readAhead AsConnection -producerBind FALSE -producerPreferLocal FALSE 
    -gatherMessages TRUE}
以下示例显示如何创建缺省消息传递提供程序 JMS 队列,该队列将对其执行的所有操作的范围向下限定为 JMS 队列用户本地的队列点:
  • 使用 Jython:
    wsadmin>AdminTask.createSIBJMSQueue("9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1)", ["-name", "MyJMSQueue", "-jndiName",
     "MyJMSQueue", "-busName bus1", "-queueName", "MyExistingQueue", "-deliveryMode",
     "Application", "-readAhead", "AsConnection", "-scopeToLocalQP", "TRUE"])
  • 使用 Jacl:
    wsadmin>$AdminTask createSIBJMSQueue 9994GKCNode01(cells/9994GKCNode01Cell/
    nodes/9994GKCNode01|node.xml#Node_1 {-name MyJMSQueue -jndiName MyJMSQueue 
    -busName bus1 -queueName MyExistingQueue -deliveryMode Application 
    -readAhead AsConnection -scopeToLocalQP TRUE}

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



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