modifySIBJMSConnectionFactory コマンド

modifySIBJMSConnectionFactory コマンドを使用して、特定の有効範囲にあるデフォルト・メッセージング・プロバイダーの JMS 接続ファクトリーのプロパティーを変更します。

コマンドを実行するには、wsadmin スクリプト・クライアントAdminTask オブジェクトを使用します。

[IBM i][IBM i]wsadmin スクリプト・クライアントは Qshell から実行されます。. [IBM i]詳しくは、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 オブジェクト・メッセージから取得したデータ・オブジェクトは変更しません。 このデータ・オブジェクトは読み取り専用として取り扱われます。
ラージ・オブジェクト・メッセージまたはバイト・メッセージを送信する際、メッセージ・ペイロードのシリアライズ、デシリアライズ、およびコピーのためのメモリーのコストおよびプロセッサー使用量はかなりのものになることがあります。 接続ファクトリーまたはアクティベーション・スペックで「pass message payload by reference」プロパティーを使用可能にする場合は、JMS 1.1 の指定をオーバーライドするようにデフォルト・メッセージング・プロバイダーに通知することで、このデータ・コピーの量が減ったり、行われなくなったりすることがあります。
注意:
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)

トピックのタイプを示すアイコン 参照トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjn_jmscf_modify
ファイル名:rjn_jmscf_modify.html