modifySIBJMSConnectionFactory 命令
使用 modifySIBJMSConnectionFactory 命令在特定范围内修改缺省消息传递提供程序的 JMS 连接工厂的属性。
要运行该命令,请使用 wsadmin 脚本编制客户机的 AdminTask 对象。
wsadmin
脚本编制客户机通过 Qshell 运行.
有关更多信息,请参阅 使用 wsadmin 脚本编制配置 Qshell 以运行 WebSphere 脚本.
已经为服务集成总线命令提供了命令行帮助:
- 要获取 Jython 中可用服务集成总线 JMS 命令的列表以及每个命令的简要描述,请在
wsadmin 提示符处输入以下命令:
print AdminTask.help('SIBJMSAdminCommands')
- 要获取有关给定命令的总体帮助,请在 wsadmin 提示符处输入以下命令:
print AdminTask.help('command_name')
使用此命令后,请使用以下命令将更改保存到主配置中:
AdminConfig.save()
用途
该命令更改 JMS 连接工厂的属性。
目标对象
JMS 连接工厂。
必需参数
无。
可选参数
- -name
- factory_name
- -jndiName
- jndi_name
- -category
- category
- -description
- text
- -logMissingTransactionContext
- True | False
- -manageCachedHandles
- True | False
- -busName
- name
- -clientID
- id
- -userName
- name
- -password
- password
- -target
- target_name
- -targetType
- BusMember | Custom | ME
- -targetSignificance
- Preferred | Required
- -targetTransportChain
- transport_chain
- -providerEndPoints
- tuple_list
- -connectionProximity
- Bus | Host | Cluster | Server
- -durableSubscriptionHome
- me_name
- -nonPersistentMapping
- BestEffortNonPersistent | ExpressNonPersistent | ReliableNonPersistent | ReliablePersistent | AssuredPersistent | AsSIBDestination | None
- -persistentMapping
- BestEffortNonPersistent | ExpressNonPersistent | ReliableNonPersistent | ReliablePersistent | AssuredPersistent | AsSIBDestination | None
- -readAhead
- Default | AlwaysOn | AlwaysOff
- -tempQueueNamePrefix
- prefix
- -tempTopicNamePrefix
- prefix
- -shareDurableSubscriptions
- AsCluster | AlwaysShared | NeverShared
“通过引用传递消息有效内容”属性:
- -producerDoesNotModifyPayloadAfterSet
- true | false(缺省值 false)
- 使用此连接工厂发送消息的应用程序必须遵循以下规则:
- 应用程序不会修改 JMS 对象消息中包含的数据对象。
- 应用程序通过使用对 writeBytes(byte[]) 的单次调用来填充 JMS 字节消息,并且在消息中设置字节数组后不会对其进行修改。
- -consumerDoesNotModifyPayloadAfterGet
- true | false(缺省值 false)
- 使用此连接工厂接收消息的应用程序必须遵循以下规则: 该应用程序未修改从 JMS 对象消息获取的数据对象。该数据对象被视为只读对象。
警告:
将定义这些属性所绕过的 JMS 规范的一部分,以确保消息数据完整性。 使用这些属性的所有 JMS 应用程序必须严格遵循“通过引用传递消息有效内容的原因及时间”主题中描述的规则,否则会有丢失数据完整性的风险。
- -authDataAlias
- alias_name
- -shareDataSourceWithCMP
- True | False
- -xaRecoveryAuthAlias
- alias_name
示例
- 使用 Jython:
wsadmin>AdminConfig.getid(“/Node:9994GKCNode01” ) “9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1)” wsadmin>AdminTask.modifySIBJMSConnectionFactory(“jmsqcf2(cells/9994GKCNode01Cell/ nodes/9994GKCNode01|resources.xml#J2CConnectionFactory_1098736176544)”, [“-manageCachedHandles”, “True”]) “jmsqcf2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CConnectionFactory_1098733675578)”
- 使用 Jacl:
wsadmin>$AdminConfig getid /Node:9994GKCNode01 9994GKCNode01(cells/9994GKCNode01Cell/nodes/9994GKCNode01|node.xml#Node_1) wsadmin>$AdminTask modifySIBJMSConnectionFactory jmsqcf2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CConnectionFactory_1098736176544) {-manageCachedHandles True} jmsqcf2(cells/9994GKCNode01Cell/nodes/9994GKCNode01|resources.xml# J2CConnectionFactory_1098733675578)