modifySIBJMSQueue 命令
使用 modifySIBJMSQueue 命令在特定范围内更改缺省消息传递提供程序的 JMS 队列的属性。
要运行该命令,请使用 wsadmin 脚本编制客户机的 AdminTask 对象。
wsadmin
脚本编制客户机通过 Qshell 运行.
有关更多信息,请参阅 使用 wsadmin 脚本编制配置 Qshell 以运行 WebSphere 脚本.
- 要获取 Jython 中可用服务集成总线 JMS 命令的列表以及每个命令的简要描述,请在
wsadmin 提示符处输入以下命令:
print AdminTask.help('SIBJMSAdminCommands')
- 要获取有关给定命令的总体帮助,请在 wsadmin 提示符处输入以下命令:
print AdminTask.help('command_name')
AdminConfig.save()
用途
modifySIBJMSQueue 命令会在特定范围内更改缺省消息传递提供程序的 JMS 队列的属性。
目标对象
JMS 队列。
必需参数
无。
可选参数
- -name
- 用于识别此 JMS 队列以便管理的标识。
- -jndiName
- 用于将队列与应用程序服务器名称空间绑定的 JNDI 名称。
- -queueName
- JMS 队列映射至的服务集成总线目标的名称。
- -description
- 总线的可选描述,供进行管理时使用。
- -deliveryMode Application | NonPersistent | Persistent
- MessageProducers 要用于发送至此队列的消息的传送方式。
- -timeToLive
- 消息发送至此队列的分派时间的缺省时间长度应该由系统保留,其中 0 表明生存时间值不到期。如果未提供此参数,那么使用来自生产者的值。
- -priority
- 发送至此队列的消息的优先级。如果未填写此值,那么使用来自生产者的值。在 0 至 9 的范围中,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 的先前版本上使用将导致应用程序发生异常。
示例
- 使用 Jython:
wsadmin>AdminConfig.getid("/Node:9994GKCNode01" ) '9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)' wsadmin>AdminTask.modifySIBJMSQueue("jmsq2(cells/9994GKCNode01Cell/nodes/ 9994GKCNode01|resources.xml#J2CAdminObject_1098737234986)", ["-queueName", "q2forjms"]) '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 modifySIBJMSQueue jmsq2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CAdminObject_1098737234986) {-queueName q2forjms} jmsq2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CAdminObject_1098737234986)