modifySIBJMSConnectionFactory 命令

使用 modifySIBJMSConnectionFactory 命令在特定范围内修改缺省消息传递提供程序的 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()

用途

该命令更改 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 1.1 规范并可能要减少或绕过此数据复制。
警告:
将定义这些属性所绕过的 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)

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



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