JMS の注意・制限事項について説明します。

• 永続ストアを変更（ファイルストア⇔ JDBC ストア）した場合、それまでに永続化された情報（メッセージ、送信先、永続サブスクリプション、トランザクション）は引き継がれないことに注意してください。
  

• WebOTX ドメイン認証では、クライアントからの認証要求で、MD5 ダイジェスト化したパスワードを送信することができません。パスワードの MD5 ダイジェスト化送信を利用する際は、JMS認証を使用してください。
  
  
• ユーザ管理方式を変更する際は、ユーザリポジトリの設定値に誤った値を指定しないでください。運用管理操作でのJMSサーバの停止ができなくなります。ユーザ管理方式の変更についての詳細は、「運用編(コンフィグレーション)」-「JMSに関する設定」-「ユーザ管理方式の設定」をご覧ください。

• Oracle の OCI ドライバを利用する場合の設定については、「注意制限事項」-「JDBCデータソース」-「Oracle利用時」を参照してください。

• J2EE 環境下で動作するアプリケーション (MDB など) では、コネクションファクトリリソースの「コネクションタイプ」は有効になりません。
  
  
• J2EE アプリケーションで SSL 通信を利用する場合は、コネクションファクトリリソースのプロパティとして、「 MessageServiceAddressList=<wojmsBrokerHostName>:<wojmsBrokerHostPort>/ssljms 」を設定してください。
  <wojmsBrokerHostName>は「JMS サーバのホスト名」の値を、<wojmsBrokerHostPort>は「JMS サーバのホストのポート番号」の値を指定します。
  
  

  統合運用管理ツールで設定する場合：

  「WebOTX 管理ドメイン[<ホスト名>]」-「<ドメイン名>」-「リソース」-「JMS リソース」-「コネクションファクトリリソース」-「<JNDI 名>」-【プロパティの設定】操作で設定します。

  運用管理コマンドで設定する場合：

  set コマンドで指定します。
  otxadmin> set server.resources.jms-resource.jms-connection-factory.<JNDI 名>.property.MessageServiceAddressList=<wojmsBrokerHostName>:<wojmsBrokerHostPort>/ssljms
  

  
  設定方法の詳細は、「運用編（コンフィグレーション）」-「JMSに関する設定」-「その他の設定項目・設定方法」-「SSL 通信を利用するための設定」を参照してください。

• DUPS_OK_ACKNOWLEDGE 応答確認モードでは、自動再接続機能は使用できません。

• 同一ホストで JMS サーバクラスタを構成する場合は、JMS サーバインスタンス識別子をホスト内で一意にしておく必要があります。JMS サーバインスタンス識別子の設定方法は以下のとおりです。
  
  

  統合運用管理ツールで設定する場合：

  「WebOTX 管理ドメイン[<ホスト名>]」-「<ドメイン名>」-「アプリケーションサーバ」-「JMS サービス」-【プロパティの設定】操作で設定します。
  instance-name=<JMSサーバインスタンス識別子>

  運用管理コマンドで設定する場合：

  set コマンドで指定します。
  otxadmin> set server.jms-service.property.instance-name=<JMSサーバインスタンス識別子>
  

  
  設定方法の詳細は、「運用編（コンフィグレーション）」-「JMSに関する設定」-「その他の設定項目・設定方法」-「JMSサーバクラスタを利用するための設定」を参照してください。
  
  
• クラスタに属する JMS サーバのアドレスリスト (clusterBrokerList) には、ホスト名として "127.0.0.1" は指定できません。
  
  
• マスターブローカを設定している場合、マスターブローカである JMS サーバが起動するまで、他の JMS サーバは起動しません。他の JMS サーバは、マスターブローカの起動を待ち合わせます。
  
  
• マスターブローカを設定している場合、マスターブローカが停止すると、以下の操作を行うことができなくなります。
  
  
  • 物理的な送信先の生成／削除／プロパティ更新
  • 永続サブスクリプションの削除
  
  
• 統合運用管理ツールでは、接続したドメインのデフォルトの JMS サーバの情報だけが参照できます。また、統計情報は、JMS サーバクラスタ内で統合された情報ではなく、そのドメインの JMS サーバのみの情報となります。
  
  
• JMS サーバクラスタ構成で自動再接続機能は利用できません。
  
  
• JMS サーバクラスタを起動する場合は、各 JMS サーバの設定を一致させて起動する必要があります。設定が一致していない場合、JMS サーバは起動しません。
  
  
• JMS サーバクラスタ構成では、送信先のアクティブコンシューマの最大数 (server.jms-service.jms-physical-destination.<送信先名>.maxNumActiveConsumers) は、無制限 (-1) で利用してください。
  

• JMS サーバ停止中に JMS リソースを生成することはできません。
  
  
• Standard Edition、Enterprise Edition で、コネクションファクトリリソースをルックアップできない場合、JMX エージェント上でリソースをロードする必要があります。ロードするための設定は以下の通りです。
  
  

  統合運用管理ツールで設定する場合：

  「WebOTX 管理ドメイン[<ホスト名>]」-「<ドメイン名>」-「リソース」-「コネクタリソース」-「<JNDI名>」-「JMXエージェント上でロードするかどうかを指定」をチェック
  

  運用管理コマンドで設定する場合：

  set コマンドで指定します。
  otxadmin> set server.resources.connector-resource.<JNDI名>.use-jmx-agent=true
  

• 非 J2EE 環境下では JMS をグローバルトランザクションに参加させることはできません。
  
  
• JMS を分散トランザクションに参加させる場合、同一の JMS サーバへの複数のコネクションファクトリを、トランザクションサービスの JCA リソースに登録することができません。JCA リソースは、接続先が異なる JMS サーバごとに 1 つ登録してください。
  例えば、以下のように、接続先が同一のコネクションファクトリを複数作成した場合、
      jms/QueueConnectionFactory { wojmsBrokerHostName=host1, wojmsBrokerHostPort=9700 }
      jms/QueueConnectionFactory2 { wojmsBrokerHostName=host1, wojmsBrokerHostPort=9700 }
      jms/TopicConnectionFactory { wojmsBrokerHostName=host1, wojmsBrokerHostPort=9700 }
  JCA リソースとして登録 (create-ts-jca-resource) するのは、
      jms/QueueConnectionFactory
      (あるいは、jms/QueueConnectionFactory2 か、jms/TopicConnectionFactory のいずれでも構いません)
  の 1 つだけになります。
  

• WebOTX V5 との相互接続不可

  WebOTX V6 以降では性能向上のため、通信プロトコルを中心に、大幅な実装変更を行いました。
  このため、WebOTX V5 と WebOTX V6 以降では、ライブラリレベルでの 相互接続性はありません。
  
  ただし、アプリケーションレベルでは、次項の WebOTX 拡張機能を使用していなければ、 そのまま利用することができます。

• WebOTX 拡張機能のインタフェース変更

  WebOTX V5 で作成したアプリケーションにおいて、次に示す API を利用している場合には 新しい API への修正が必要となります。
  
  

  1. 確認応答モード定数 ： NO_ACKNOWLEDGE
     パッケージ名の変更
         V5: jp.co.nec.WebOTX.jms.ClientSession.NO_ACKNOWLEDGE
               ↓
         V6以降: com.nec.webotx.messaging.ClientSession.NO_ACKNOWLEDGE
     
     
  2. 配信時刻指定 API
     パッケージ名の変更
         V5: jp.co.nec.WebOTX.jms.MessageImpl.setDeliveryTime()
               ↓
         V6以降: com.nec.webotx.messaging.jmq.jmsclient.MessageImpl.setDeliveryTime()
     
     
  3. 再配信遅延時間指定 API
     パッケージ名の変更
         V5: jp.co.nec.WebOTX.jms.ClientQueueConnection.createQueueSession()
               ↓
         V6以降: com.nec.webotx.messaging.ClientQueueConnection.createQueueSession()
     
         V5: jp.co.nec.WebOTX.jms.ClientQueueConnection.createTopicSession()
               ↓
         V6以降: com.nec.webotx.messaging.ClientQueueConnection.createTopicSession()
     
     

• 運用コマンドの変更

  WebOTX V5 の互換コマンドは提供しておりません。以下のコマンドをご利用ください。
  
  

  1. jmsadm （JMS サーバの起動と停止）
     JMSサーバの起動と停止には、WebOTXの運用管理コマンド(otxadmin)を使用してください。統合運用管理ツールから操作することも可能です。
     
     起動 ： otxadmin> start-jms
     
     停止 ： otxadmin> stop-jms
     
     
  
  
  2. jmsmng （送信先の運用）
     送信先の生成等の運用には、WebOTXの運用管理コマンド(otxadmin)を使用してください。また、統合運用管理ツールでjms-service管理対象に対して操作することも可能です。
     
     生成 ： otxadmin> create-jmsdest
     
     削除 ： otxadmin> delete-jmsdest
     
     一覧 ： otxadmin> list-jmsdest
     
     メッセージ廃棄ポリシーに相当する機能は、送信先の属性 (limitBehavior) として与えることができます。
     ただし、LIFO に相当するものはサポートしておりません。
     
     
  
  
  3. jmslog （ログ採取レベルの変更）
     JMSサーバのログレベルを変更するには、WebOTXの運用管理コマンド(otxadmin)、もしくは統合運用管理ツールを使用してjms-service管理対象の属性値を変更してください。
     
     変更 ： otxadmin> set
     
         例) otxadmin> set server.jms-service.loglevel=DEBUG
     
  
  
  4. jmspasswd （管理者パスワードの変更）
     管理者パスワードの変更については、JMS固有のwojmsusermgr コマンドを使用してください。
         例) wojmsusermgr update -u admin -p adminadmin -otxdomain domain1

• プロパティファイルの変更

  WebOTX V5 のプロパティファイルの変更点について説明します。
  
  

  1. jms_service.properties
     以下の設定ファイルで定義してください。
          <WebOTX dir>\domains\<domain name>\wojms\instances\wojmsbroker\props\config.properties
     
     設定できるプロパティについては、「運用編(コンフィグレーション)」-「JMS に関する設定」をご覧ください。
     なお、WebOTX V5 のプロパティとの互換性はありません。
     
  
  
  2. jms_client.properties
     WebOTX V6 以降では使用しません。
     

• DUPS_OK_ACKNOWLEDGE 確認応答モードの実装変更

  JMS 標準では実装依存となっている DUPS_OK_ACKNOWLEDGE 確認応答モードの実装を WebOTX V5 から変更しています。
  WebOTX V5 では AUTO_ACKNOWLEDGE 確認応答モード相当の実装 (1件単位に確認応答を発行) でしたが、WebOTX V6 以降では 10 件単位に確認応答を発行します。

• 再配信メッセージの順序保証は V7.11.02 からのサポートで、利用できるのは、次の環境に制限されます。
  1. 送信先タイプはキューであること
     JMSサーバクラスタ構成では、送信先の「ローカル配信のみ (isLocalOnly) 」の 設定を有効 (true) にして、ローカルコンシューマ (送信先が作成されたブローカに 接続しているコンシューマ) だけにメッセージを配信するようにおく必要があります。
  2. コンシューマのメッセージ受信がトランザクション内で行われていること
     
  3. 送信先に接続するコンシューマ数は 1 であること
     送信先に接続できるコンシューマ数は、1 に制限されます。また、MDBの場合は、多重度を 1 に制限しておく必要があります。

• 再配信メッセージの順序保証を利用する場合は、次のような動作になります。

  優先度を設定したメッセージ

  1 件目は優先度の最も高いものがコンシューマに配信されます。 コンシューマがそのメッセージをロールバックした場合は、優先度を無視して そのメッセージが再配信されます。 2 件目は、その次に優先度の高いものが配信されます。

  
  
  

  配信時間を設定したメッセージ

  1 件目は、一番最初に指定時刻に達したメッセージがコンシューマに配信されます。 コンシューマがそのメッセージをロールバックすると、配信時間を無視して そのメッセージが再配信されます。 コンシューマがメッセージをロールバックしている間は、他のメッセージが 指定時刻になっても配信されません。 2 件目は、その次に指定時刻に達したものが配信されます。

  
  
  

  有効期限を設定したメッセージ

  メッセージの再配信中に有効期限が切れた場合は、 そのメッセージが破棄(または、転送)され、コンシューマには、その次の メッセージが配信されます。

  
  
  

  再配信回数、再配信遅延時間、破棄メッセージ転送先の設定

  いずれの設定も有効になります。 コンシューマが 1 件目のメッセージを受信後、ロールバックすると、 遅延時間に指定した時間だけ待ってそのメッセージが再配信され、 再配信回数の上限を超えると、そのメッセージは破棄(または、転送)されます。 その後、キュー内の 2 件目のメッセージが配信されます。

  
  
  

• 順序保証の設定を変更する場合は、送信先のコンシューマ数が 1 以下の状態で行ってください。 複数のコンシューマが接続しているときに順序保証の設定を有効にしても、設定は無視されます。

• 送信先の制限到達時の振る舞い (limitBehavior) が REMOVE_OLDEST と REMOVE_LOW_PRIORITY の場合、メッセージが削除されてもプロデューサに通知されません。JMS サーバ内で暗黙的に削除されます。
  
  
• 送信先の制限到達時の振る舞い (limitBehavior) がREMOVE_LOW_PRIORITY の場合、削除対象は既に滞留しているメッセージから選択されます。新しいメッセージが削除されることはありません。