modifySIBJMSConnectionFactory コマンド
modifySIBJMSConnectionFactory コマンドを使用して、特定の有効範囲にあるデフォルト・メッセージング・プロバイダーの JMS 接続ファクトリーのプロパティーを変更します。
コマンドを実行するには、wsadmin スクリプト・クライアントの AdminTask オブジェクトを使用します。
wsadmin スクリプト・クライアントは Qshell から実行されます。.
詳しくは、wsadmin スクリプトを使用した WebSphere スクリプトを実行するための Qshell の構成.
サービス統合バスのコマンドには、コマンド行ヘルプが用意されています。
- 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
「参照によるメッセージ・ペイロードの受け渡し (pass message payload by reference)」プロパティー:
- -producerDoesNotModifyPayloadAfterSet
- true | false (デフォルトは false)
- メッセージの送信にこの接続ファクトリーを使用するアプリケーションは、次のルールに従っていなければなりません。
- アプリケーションは、JMS オブジェクト・メッセージに含まれているデータ・オブジェクトは変更しません。
- アプリケーションは、writeBytes(byte[]) の単一呼び出しを使用して JMS バイト・メッセージにデータを追加します。 メッセージにバイト配列を設定した後で、そのバイト配列を変更することはありません。
- -consumerDoesNotModifyPayloadAfterGet
- true | false (デフォルトは false)
- メッセージの受信にこの接続ファクトリーを使用するアプリケーションは、次のルールに従っていなければなりません。 アプリケーションは、JMS オブジェクト・メッセージから取得したデータ・オブジェクトは変更しません。 このデータ・オブジェクトは読み取り専用として取り扱われます。
注意:
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)