modifySIBJMSConnectionFactory command

Use the modifySIBJMSConnectionFactory command to modify the properties of a JMS connection factory for the default messaging provider at a specific scope.

如果要執行這個指令,請使用 wsadmin Scripting 用戶端AdminTask 物件

[IBM i][IBM i]wsadmin Scripting 用戶端是從 Qshell 執行. [IBM i]如需相關資訊,請參閱利用 wsadmin Script 配置 Qshell 來執行 WebSphere Script.

服務整合匯流排指令有指令行說明:
  • 如需 Jython 中可用的服務整合匯流排 JMS 指令清單,以及每個指令的簡要說明,請在 wsadmin 提示下,輸入下列指令:

    print AdminTask.help('SIBJMSAdminCommands')

  • 如需給定指令的概觀說明,請在 wsadmin 提示下,輸入下列指令:

    print AdminTask.help('command_name')

使用指令之後,請利用下列指令,儲存對主要配置所做的變更:

AdminConfig.save()

Purpose

This command changes the properties of a JMS connection factory.

Target object

A JMS connection factory.

Required parameters

None.

Optional parameters

-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
The "pass message payload by reference" properties:
-producerDoesNotModifyPayloadAfterSet
true | false (default false)
利用這個 Connection Factory 來傳送訊息的應用程式必須遵循下列規則:
  • 應用程式不會修改 JMS 物件訊息所包含的資料物件。
  • 應用程式利用對於 writeBytes(byte[]) 的單一呼叫來移入 JMS 位元組訊息,位元組陣列在訊息內設定之後,應用程式就不會修改它。
-consumerDoesNotModifyPayloadAfterGet
true | false (default false)
利用這個 Connection Factory 來接收訊息的應用程式必須遵循下列規則: 應用程式不會修改從 JMS 物件訊息取得的資料物件。資料物件是當作唯讀來處理。
當傳送大型物件訊息或位元組訊息時,為了序列化、解除序列化及複製訊息有效負載,可能會耗用大量的記憶體和處理器成本。 如果您在 Connection Factory 或啟動規格上啟用 pass message payload by reference 內容,您會通知預設傳訊提供者置換 JMS 1.1 規格,這項資料的複製有可能會縮減或略過。
CAUTION:
定義這些內容所略過的 JMS 規格部分,以確保訊息資料的完整性。 任何使用這些內容的 JMS 應用程式,都必須嚴格遵循「依參照傳遞 JMS 訊息有效負載的原因和時機」主題中所說明的規則,否則,會有喪失資料完整性的風險。
-authDataAlias
alias_name
-shareDataSourceWithCMP
True | False
-xaRecoveryAuthAlias
alias_name

Example

  • Using 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)"
  • Using 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)

指出主題類型的圖示 參照主題



時間戳記圖示 前次更新: July 9, 2016 11:12
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjn_jmscf_modify
檔名:rjn_jmscf_modify.html