1.7. JMS

JMSに関する設定について説明します。

1.7.1. JMS設定項目・設定方法

JMSサーバは独立したプロセスで実装しており、WebOTXのアプリケーションサーバ本体には、リソースアダプタにより接続連携しています。

JMSサーバや、JMSリソース、および、送信先の基本的な管理は、運用管理コマンド(otxadmin)、あるいは、統合運用管理ツールで行います。さらに詳細な管理を行うためには、JMSサーバが提供している専用の運用管理ツールを利用します。

運用管理コマンド、あるいは、統合運用管理ツールからの各項目の設定方法については、「1.1. 各サービスの属性」を参照してください。また、JMSサーバが提供している専用の各運用管理ツールについては、「4. 運用管理コマンドリファレンス > 4.4. JMS」を参照してください。

1.7.1.1. JMSサーバに対する設定

JMSサーバの運用に関するプロパティは、JMSサービス(jms-service)と、JMSホスト(jms-host)のMOから設定できます。

運用管理コマンドや、統合運用管理ツールでは、それぞれ以下のように指定します。

JMSサーバは、1〜4のプロパティを取り込みます。優先順位は、後ろのものほど高くなっています。

1. default.propertiesファイル

   プロパティのデフォルト値が定義されたファイルで、次の位置にあります。

   ${AS_INSTALL}/wojms/lib/props/broker/default.properties

   注意 :

   利用者は直接編集を行わないで下さい。

   
   

2. install.propertiesファイル

   インストール時に指定されたプロパティが格納されるファイルで、次の位置にあります。

   ${AS_INSTALL}/wojms/lib/props/broker/install.properties

   注意 :

   利用者は直接編集を行わないで下さい。

   
   

3. config.propertiesファイル

   ドメイン固有のJMSサーバに対するプロパティ設定を記述するファイルで、次の位置にあります。ファイルはドメイン生成時に作成されます。

   ${INSTANCE_ROOT}/wojms/instances/<JMSサーバインスタンス識別子>/props/config.properties

   備考 :

   <JMSサーバインスタンス識別子>の既定値は「wojmsbroker」です。

   
   

4. JMSサーバの起動引数(server.jms-service.start-args)

   起動引数で指定したプロパティは、すべてのプロパティ設定ファイルに対して優先されます。

1.7.1.2. コネクションファクトリに対する設定

コネクションファクトリリソース

コネクションファクトリリソースは、Java EEアプリケーションからJNDIを通して利用します。項目の設定や、参照を行う場合、運用管理コマンドや、統合運用管理ツールでは、それぞれ以下のように指定します。
「connection-factory-name」は、コネクションファクトリリソースの定義名で、JNDIの登録名になります。

1.7.1.3. 送信先に対する設定

送信先

物理的な送信先の設定や、項目の参照を行う場合、運用管理コマンドや、統合運用管理ツールでは、それぞれ以下のように指定します。「physical-destination-name」は、送信先の定義名です。

送信先リソース

送信先リソースは、Java EEアプリケーションからJNDIを通して利用します。項目の設定や、参照を行う場合、運用管理コマンドや、統合運用管理ツールでは、それぞれ以下のように指定します。
「logical-destination-name」は、送信先リソースの定義名で、JNDIの登録名になります。

1.7.2. JMS設定項目一覧

運用管理コマンド、統合運用管理ツールで制御できるMOの属性と、そのベースとなるJMSのプロパティ／属性一覧を示します。

1.7.2.1. MOの属性一覧

JMSに関連するMOのうち、属性を設定できるものは、以下の5種類です。以降、各MOについて設定できる属性を説明します。

• JMSサービス（jms-service）
• JMSホスト（jms-host）
• コネクションファクトリリソース（jms-connection-factory）
• 送信先（jms-physical-destination）
• 送信先リソース（jms-logical-destination）

1.7.2.2. JMSサービス

連携するJMSサーバに関する情報を定義します。
この定義は、運用管理コマンドのcreate-domainによるドメイン生成時に自動的に設定されます。
MOのdottednameは「server.jms-service」です。設定可能な属性や、操作については、「2. MO定義リファレンス > jms-service」を参照してください。
なお、jms-serviceの「プロパティ」として設定できるのは、以下の項目です。

1.7.2.3. JMSホスト

JMSサーバの起動、JMSサーバへの接続に必要な情報を定義します。
この定義は、create-domainコマンドによるドメイン生成時に自動的に設定されます。ポート番号については、create-domainコマンドの--fileオプションで指定するプロパティファイル(ドメイン設定ファイル)に、domain.jms.portとして指定することができます。
MOのdottednameは「server.jms-service.jms-host.default_JMS_host」です。設定可能な属性や、操作については、「2. MO定義リファレンス > jms-host」を参照してください。

1.7.2.4. コネクションファクトリリソース

JNDIを通してアクセスするコネクションファクトリリソースを定義します。
この定義は、運用管理コマンドのcreate-jms-resource、統合運用管理ツールでは、「WebOTX管理ドメイン[<ホスト名>].<ドメイン名>.リソース.JMSリソース」の「コネクションファクトリリソースの作成」操作で作成されます。コネクションファクトリリソースの作成方法については、「ドメイン構築・基本設定ガイド > 7. WebOTXの内部サービス > 7.3. JMS > 7.3.3. JMSリソースの操作」を参照してください。
コネクションファクトリリソース(jms-connection-factory)作成時には、コネクタリソース(connector-resource)、コネクタコネクションプール(connector-connection-pool)、および、リソース参照(resource-ref)を自動的に作成し、属性値を設定します。 属性値を変更する場合は、コネクションファクトリリソースのMOを介して行います。 各MOのdottednameは以下のとおりです。

設定可能な属性や、操作については、「2. MO定義リファレンス」を参照してください。

注意 :

コネクションファクトリリソース作成時、「プロパティ」に属性と同じ名前の項目を指定した場合は、「プロパティ」に指定されたものが優先されます。

1.7.2.5. 送信先

物理的な送信先を定義します。
この定義は、運用管理コマンドのcreate-jmsdest、統合運用管理ツールでは、「WebOTX管理ドメイン[<ホスト名>].<ドメイン名>.アプリケーションサーバ.JMSサービス」の「送信先作成」操作で作成されます。送信先の作成方法については、「ドメイン構築・基本設定ガイド > 7. WebOTXの内部サービス > 7.3. JMS > 7.3.2. 送信先の操作」を参照してください。
MOのdottednameは「server.jms-service.jms-physical-destination.destination-name」です。設定可能な属性や、操作については、「2. MO定義リファレンス > jms-physical-destination」を参照してください。

注意 :

送信先作成時、「プロパティ」に属性と同じ名前の項目を指定した場合は、「プロパティ」に指定されたものが優先されます。

1.7.2.6. 送信先リソース

JNDIを通してアクセスする送信先リソースを定義します。
この定義は、運用管理コマンドのcreate-jmsresource、統合運用管理ツールでは、「WebOTX管理ドメイン[<ホスト名>].<ドメイン名>.リソース.JMSリソース」の操作である「送信先リソースの作成」で作成されます。送信先リソースの作成方法については、「ドメイン構築・基本設定ガイド > 7. WebOTXの内部サービス > 7.3. JMS > 7.3.3. JMSリソースの操作」を参照してください。
送信先リソース(jms-logical-destination)作成時には、管理オブジェクトリソース(admin-object-resource)と、リソース参照(resource-ref)を自動的に作成し、属性値を設定します。
属性値を変更する場合は、送信先リソースのMOを介して行います。
各MOのdottednameは以下のとおりです。

設定可能な属性や、操作については、「2. MO定義リファレンス」を参照してください。

注意 :

送信先リソース作成時、「プロパティ」に属性と同じ名前の項目を指定した場合は、「プロパティ」に指定されたものが優先されます。

1.7.2.7. JMSのプロパティ／属性一覧

ここでは、以下のプロパティや属性について説明します。

JMSサーバのプロパティ

「1.7.1. JMS設定項目・設定方法 > 1.7.1.1. JMSサーバに対する設定」で説明した、「config.propertiesファイル」に設定できるプロパティです。以下のカテゴリに分けて説明しています。

• JMSサーバ全体のプロパティ
• コネクションサービスに関するプロパティ
• セキュリティに関するプロパティ
• 永続ストアに関するプロパティ
• ログ出力に関するプロパティ
• メモリ管理に関するプロパティ
• 自動生成送信先に関するプロパティ
• クライアント監視に関するプロパティ
• JMSサーバクラスタに関するプロパティ

JMSクライアントのプロパティ

非Java EE環境下で動作するJavaアプリケーションに有効であり、Javaシステムプロパティとして設定します。

1.7.2.8. JMSサーバのプロパティ

「config.properties」ファイルに設定するプロパティの一覧を示します。このファイルには、JMSサービス(jms-service)や、JMSホスト(jms-host)のMOから設定できない詳細な項目を指定します。「config.properties」ファイルの変更は、JMSサーバを停止した状態で行ってください。
ファイルの格納場所、設定方法については、「1.7.1. JMS設定項目・設定方法」を参照してください。

ただし、以下のプロパティについては、JMSサービス、あるいは、JMSホストのMOの属性値が優先されます。これらの値を設定する場合は各MOの属性値を設定してください。

JMSサーバ全体のプロパティ

コネクションサービスに関するプロパティ

セキュリティに関するプロパティ

永続ストアに関するプロパティ

ログ出力に関するプロパティ

メモリ管理に関するプロパティ

自動生成送信先に関するプロパティ

クライアント監視に関するプロパティ

JMSサーバクラスタに関するプロパティ

1.7.2.9. JMSクライアントのプロパティ

JMSクライアントのプロパティの一覧を示します。これらのプロパティは、非Java EE環境下で動作するJavaアプリケーションに有効であり、Javaシステムプロパティとして設定します。

ログの利用方法については、「1.7.3.13. JMSクライアントのログ出力」を、チューニング情報採取に関しては、「高度な管理と運用サイクルガイド > 2. チューニング > 2.4. JMS > 2.4.4. JMSクライアントのチューニング情報採取」を参照してください。

C言語アプリケーションプログラムのプロパティ

設定は、${AS_INSTALL}/wojms/etc/wojmscrt.conf ファイルで行います。

1.7.3. その他の設定項目・設定方法

JMSサーバのその他の設定項目、および設定方法について説明します。

1.7.3.1. ファイルストアを利用するための設定

ファイルストアを利用するための設定について説明します。

1. JMSサービスのMOに対して、次の属性を設定します。
   
   server.jms-service ：
   

   表1.7.3.1-1

   属性名	説明	既定値
   storeType	永続ストアタイプを指定します。 file：ファイルストア	file

   
   
2. JMSサービスを再起動してください。

インストール直後は、ファイルストアを利用する設定になっています。関連する、JMSサーバの各プロパティにはデフォルト値が設定されていますので、ご利用になるシステムに合わせて設定値を変更してください。ファイルストアをご利用になるためのプロパティの詳細については、「1.7.2.7. JMSのプロパティ／属性一覧 > JMSサーバのプロパティ」-「永続ストアに関するプロパティ」を参照してください。

注意 :

• ストアを変更（ファイルストア⇔JDBCストア）する場合、それまでに永続化された情報（メッセージ、送信先、永続サブスクリプション、トランザクション）は、変更先のストアには引き継がれません。

1.7.3.2. JDBCストアを利用するための設定

JDBCストアを利用するための設定について説明します。

インストール直後は、ファイルストアを利用する設定になっています。JDBCストアを利用する場合は、次の手順で設定を変更してください。

補足：データベーススキーマ作成プロパティの既定値

wojms.persist.jdbc.dbtype に利用するDBMSを指定することで、該当するDBMSのプロパティが自動的に有効になります。 ここでは、各DBMSのJDBCドライバについてのみ記述しています。その他のプロパティの既定値については、default.propertiesファイル (${AS_INSTALL}/wojms/lib/props/broker/default.properties) の「wojms.persist.jdbc.<dbtype>」で始まるプロパティ値を参照してください。

• Oracle の既定値 (wojms.persist.jdbc.dbtype=oracle)

  表1.7.3.2-2

  プロパティ名	既定値
  wojms.persist.jdbc.oracle.driver	oracle.jdbc.driver.OracleDriver

• PostgreSQL の既定値 (wojms.persist.jdbc.dbtype=postgresql)

  表1.7.3.2-3

  プロパティ名	既定値
  wojms.persist.jdbc.postgresql.driver	org.postgresql.Driver

• Microsoft SQL Server の既定値 (wojms.persist.jdbc.dbtype=sqlserver)

  表1.7.3.2-4

  プロパティ名	既定値
  wojms.persist.jdbc.sqlserver.driver	com.microsoft.sqlserver.jdbc.SQLServerDriver

注意 :

• ストアを変更（ファイルストア⇔JDBCストア）する場合、それまでに永続化された情報（メッセージ、送信先、永続サブスクリプション、トランザクション）は、変更先のストアには引き継がれないことにご注意ください。
• OracleのOCIドライバを利用する場合、「注意制限事項 > 6. JDBCデータソース > 6.1. Oracleご利用時の注意・制限事項」を参考にしてください。JMSも /etc/WebOTX**/otx.conf (**にはバージョン番号が入ります。V9.4の場合、/etc/WebOTX94/otx.confです。)の設定が有効になります。

1.7.3.3. ユーザ管理の設定

ここでは、JMS固有のユーザ管理方式(JMS認証)を利用する場合のユーザ管理について説明します。

デフォルトでは、WebOTXドメインのユーザ管理方式を利用するようになっています。JMS固有のユーザ管理方式を利用する場合は、あらかじめ、設定が必要となります。 設定方法については、[ 1.7.3.10. ユーザ管理方式の設定 ] を参照してください。 また、WebOTXドメインのユーザ管理方式を利用する場合のユーザ管理については、 [ ドメイン構築・基本設定ガイド > 4. ユーザ管理 ] を参照してください。

JMS認証に必要なユーザ管理は、wojmsusermgrコマンドで行います。wojmsusermgrコマンドの詳細については、「4. 運用管理コマンドリファレンス > 4.4. JMS > 4.4.5. wojmsusermgr」を参照してください。
ユーザ情報は、次の場所にあるファイルで管理されています。
${INSTANCE_ROOT}/wojms/instances/wojmsbroker/etc/passwd

グループ

状態

管理者は任意ユーザの登録情報の状態（アクティブ／非アクティブ）を変更することができます。

ユーザ名とパスワードの形式

次の文字は、ユーザ名として使用できません。

• 改行やCRを文字として使用できません。
• 空白を含める場合には全体を引用符で囲んでください。
• 1文字以上であることが必要ですが、基本的に長さに制限はありません。

デフォルトの設定

※ JMSサーバの起動時にはadmin権限が必要です。JMSサーバを起動する運用管理エージェント側の定義には、あらかじめこのデフォルト値が設定されています。

1.7.3.4. アクセス制御機能を利用するための設定

JMS クライアントからの操作 (コネクション、送信先、送信先自動作成) に対するアクセス制御は、次の場所にあるアクセス制御プロパティファイルに定義します。
${INSTANCE_ROOT}/wojms/instances/wojmsbroker/etc/accesscontrol.properties

コネクションのアクセス制御

コネクションサービスへの権限を定義します。

形式 :

connection.resourceVariant.access.principalType = principals

デフォルトでは、通常のコネクションは全てのユーザに権限が、管理用のコネクションはadminグループにのみ権限が与えられています。

たとえば、通常のコネクション確立について、ユーザxxxを拒否するには、次の記述を追加します。

1.7.3.5. 送信先のアクセス制御

送信先に対する権限を定義します。

形式 :

resourceType.resourceVariant.operation.access.principalType = principals

デフォルトでは、すべてに権限が与えられています。

たとえば、トピックxxxからのメッセージ受信について、グループyyyを拒否するには、次の記述を追加します。

1.7.3.6. 送信先自動作成のアクセス制御

送信先の自動作成の権限を定義します。

形式 :

resourceType.create.access.principalType = principals

デフォルトでは、すべてに権限が与えられています。

たとえば、topicの自動作成について、ユーザxxxを拒否するには、次の記述を追加します。

1.7.3.7. SSL通信を利用するための設定

JMSサーバとクライアントアプリケーションとの間、JMSサーバと管理ツールとの間で送受信されるメッセージをSSLで暗号化するために必要な設定について説明します。
前者はssljmsコネクションサービス、後者はssladminコネクションサービスが対象です。

1. 自己署名型証明書の生成
   wojmskeytoolコマンドでJMSサーバの自己署名型証明書を生成してください。wojmskeytoolコマンドの詳細は、「4. 運用管理コマンドリファレンス > 4.4. JMS > 4.4.4. wojmskeytool」を参照してください。
   

   # wojmskeytool -broker
   

   証明書が格納されるキーストアの位置は次の場所となります。
   $WOJMS_HOME/etc/keystore
   

2. SSLコネクションサービスの有効化
   wojms.service.activelistプロパティにより、SSLコネクションサービスを有効化します。次のいずれかの方法で指定してください。
   1. 起動引数で指定する方法
      次のオプションをJMSサーバの起動引数に指定してください。ここでは、jms、adminの両方のSSLコネクションサービスを有効化しています。
      
      -Dwojms.service.activelist=jms,admin,ssljms,ssladmin
      
      

      運用管理コマンドで指定する場合は、JMSサービスの「start-args」属性に、統合運用管理ツールで指定する場合は、JMSサービスのMO属性「起動引数」に上記を設定してください。

   2. config.propertiesに設定する方法
   3. 次のプロパティを設定してください。ここでは、jms、adminの両方のSSLコネクションサービスを有効化しています。
      

      wojms.service.activelist=jms,admin,ssljms,ssladmin
      

   実際に有効になったかどうかは、JMSサーバ再起動後に、wojmscmd list svcコマンドで確認することができます。wojmscmd list svcコマンドの詳細は、「4. 運用管理コマンドリファレンス > 4.4. JMS > 4.4.4. wojmskeytool > 4.4.2.9. list svc」を参照してください。
   

3. JMSサーバの再起動
   次のいずれかの方法でキーストアのパスワードを指定してJMSサーバを再起動してください。
   
   1. 起動引数で指定する
   2. パスワードファイルを使用する

   詳細は、「1.7.3.8. パスワードファイルの使用」を参照してください。

4. JMSクライアントの設定
   クライアントの設定は、Javaアプリケーションの場合と、Java EE環境下で動作するJava EEアプリケーションの場合で方法が異なります。
   
   
   1. Javaアプリケーションの場合
      コネクションファクトリに次の属性値を設定してください。
      wojmsConnectionType=TLS
      
      この設定を有効にするには、次の2つの方法があります。
      
      • JNDIに登録するオブジェクトに設定する方法
        コネクションファクトリリソースの場合は、MO属性「コネクションタイプ（wojmsConnectionType）」で指定します。
        
        
      • Javaクライアントアプリケーション起動時にJavaシステムプロパティで指定する方法
        通常はJNDIに登録されたオブジェクトにあらかじめ設定された属性値に従って暗黙的に決まりますが、これをJavaシステムプロパティとして与えることによって、起動時に自由に選択することができます。
        
      
      
   2. Java EEアプリケーションの場合
      コネクションファクトリリソースのプロパティとして、
      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
      
      例）デフォルトの接続先(ホスト名：localhost、ポート番号：9700)にSSLで接続する場合

      otxadmin> set server.resources.jms-resource.jms-connection-factory.jms/MyCF.property.MessageServiceAddressList=localhost:9700/ssljms
      

1.7.3.8. パスワードファイルの使用

ここでは、JMSサーバが使用するSSL、JDBCのパスワードを起動引数ではなく、パスワードファイルを使用して指定する方法について説明します。

1. パスワードファイルの作成
   パスワードファイルの作成は、次の位置にある雛形を利用してください。
   ${AS_INSTALL}/wojms/etc/passfile.sample
   パスワードファイルには次のパスワードを指定することができます。
   

   表1.7.3.8-1

   パスワード	説明
   wojms.keystore.password	SSL運用時に必要なキーストアのパスワードを指定します。
   wojms.persist.jdbc.password	データベースとの接続時に必要なパスワードを指定します。

   
   
2. パスワードファイルの有効化
   作成したパスワードファイルを有効にするためには、次のプロパティを指定する必要があります。
   
   wojms.passfile.enabled=true
   
   
3. パスワードファイルの指定
   JMSサーバの起動時に使用するパスワードファイルを指定します。次のいずれかの方法で指定してください。
   
   
   1. 起動引数で指定する方法
      次のオプションをJMSサーバの起動引数に指定してください。
      
      -passfile <password file>
      
      

      運用管理コマンドで指定する場合は、JMSサービスの「start-args」属性に、統合運用管理ツールで指定する場合は、JMSサービスのMO属性「起動引数」に上記を設定してください。

   2. config.propertiesに設定する方法
   3. 次のプロパティを設定してください。

      wojms.passfile.dirpath=<passfile directory>
      wojms.passfile.name=<passfile name>
      

   注意 :

   起動引数を指定した場合は、config.propertiesに設定した内容は無視されます。

1.7.3.9. Standard/Enterprise で動作させる場合の設定

Standard/Enterprise において、TPモニタ上でMessage-Driven Bean(MDB)やJMSの非同期受信を行うCORBAアプリケーションを起動する場合の設定について説明します。

MDBでTopicのマルチコンシューマ負荷分散を利用する場合

MDBでTopicのマルチコンシューマ負荷分散を利用するには、クライアント識別子とその共有フラグを以下に示すいずれかの方法で設定する必要があります。

1. 配備記述子での設定
   ejb-jar.xml中の<activation-config-property>を利用して、以下のプロパティを設定します。
   
   

   表1.7.3.9-1

   プロパティ	値
   clientId	クライアント識別子
   enableSharedClientID	true

   
   具体例は、以下の通りです。
   
   

   <?xml version="1.0" encoding="UTF-8"?> <ejb-jar> 　<enterprise-beans> 　　<message-driven> 　　　<ejb-name>MyMDB</ejb-name> 　　　・・・・・ 　　　<activation-config> 　　　　<activation-config-property> 　　　　　<activation-config-property-name>clientId</activation-config-property-name> 　　　　　<activation-config-property-value>MyClientID</activation-config-property-value> 　　　　</activation-config-property> 　　　　<activation-config-property> 　　　　　<activation-config-property-name>enableSharedClientID</activation-config-property-name> 　　　　　<activation-config-property-value>true</activation-config-property-value> 　　　　</activation-config-property> 　　　　・・・・・ 　　　</activation-config> 　　</message-driven> 　</enterprise-beans> </ejb-jar>

   
   
2. アノテーションでの設定
   @ActivationConfigPropertyを利用して、以下のプロパティを設定します。
   
   

   表1.7.3.9-2

   プロパティ	値
   clientId	クライアント識別子
   enableSharedClientID	true

   
   具体例は、以下の通りです。
   
   

   @MessageDriven( 　　activationConfig = { 　　　　@ActivationConfigProperty(propertyName="clientId", propertyValue="MyClientID"), 　　　　@ActivationConfigProperty(propertyName="enableSharedClientID", propertyValue="true"), 　　　　・・・・・ 　　} ) public class MyMDB implements MessageListener { 　　public void onMessage(Message msg) {・・・・・} }

   
   
3. プロセスグループでの設定
   プロセスグループのシステムプロパティに以下のプロパティを指定してください。 同じプロセスグループの中で複数のMDBが配備されるような場合、クライアント識別子の共有範囲が複数のMDB間にまたがることに注意してください。

   表1.7.3.9-3

   プロパティ	設定値
   wojmsConfiguredClientID	クライアント識別子
   wojmsEnableSharedClientID	true

CORBAアプリケーションでTopicのマルチコンシューマ負荷分散を利用する場合

CORBAアプリケーションでTopicのマルチコンシューマ負荷分散を利用する場合は、自動的にクライアント識別子とその共有フラグを設定します。この場合のクライアント識別子は、[アプリケーショングループ名]_[プロセスグループ名]です。 以下の方法でクライアント識別子を明示的に指定することも可能です。

1. プログラムでの設定
   javax.jms.TopicConnectionのsetClientIDメソッドで指定してください。
   
   
2. プロセスグループでの設定
   プロセスグループのシステムプロパティに以下のプロパティを指定してください。
   同じプロセスグループの中で複数のコンシューマを生成するような場合、クライアント識別子の共有範囲が複数のコンシューマ間にまたがることに注意してください。

   表1.7.3.9-4

   プロパティ	説明
   wojmsConfiguredClientID	クライアント識別子

   
   
3. コネクションファクトリリソースでの設定
   使用するコネクションファクトリリソースの以下の属性を指定してください。
   同じコネクションファクトリリソースを複数のコンシューマで利用すると、クライアント識別子の共有範囲が複数のコンシューマ間にまたがることに注意してください。
   server.resources.jms-resource.jms-connection-factory.connection-factory-name ：

   表1.7.3.9-5

   プロパティ	説明
   wojmsConfiguredClientID	クライアント識別子

CORBAアプリケーションでWebOTXアプリケーション管理機能を利用する場合

JMSの非同期受信を行うCORBAアプリケーションで次のようなWebOTXのアプリケーション管理機能を利用するための設定について説明します。

1. プロセスの障害監視・閉塞機能
   MessageListenerの呼び出しが指定した時間経過しても応答しない場合や、プロセスが異常終了した場合に、該当するプロセスを閉塞し、指定にしたがってプロセスを再起動します。
   
   
2. 性能情報の採取機能
   MessageListener呼び出しに要した時間や、呼び出し回数といった性能および統計情報を採取します。
   
   アプリケーション管理機能を利用するためには、プロセスグループに次のJavaシステムプロパティを設定してください。
   

   表1.7.3.9-6

   プロパティ名	説明
   wojmsEnableReliableThread	アプリケーション管理機能を利用するかどうかを指定します。 true　アプリケーション管理機能を有効にします。 false　アプリケーション管理機能を無効にします（既定値）。
   wojmsReliableRetryAttempts	アプリケーション管理機能を有効にした場合の、管理機能に対する初期処理が失敗した場合のリトライ回数を指定します。 既定値は、200回です。
   wojmsReliableRetryInterval	アプリケーション管理機能を有効にした場合の、管理機能に対する初期処理が失敗した場合のリトライ間隔を、秒単位で指定します。 既定値は、3（秒）です。

1.7.3.10. ユーザ管理方式の設定

ここでは、JMSサーバに接続するユーザの管理方式を設定する方法について説明します。

1. JMSサーバのプロパティファイルに、認証方式を指定するためのプロパティを設定します。プロパティの詳細については、「1.7.2.7. JMSのプロパティ／属性一覧 > JMSサーバのプロパティ」を参照してください。
   

   ユーザ管理方式を指定するためのプロパティについて説明します。

   表1.7.3.10-1

   プロパティ名	説明	設定値
   		WebOTXドメインの管理方式	JMS認証
   wojms.authentication.provider	JMSサーバに接続するユーザの管理方式を指定します。	APSERVER	WOJMS
   wojms.authentication.type	JMSクライアントからパスワードを送信する際のタイプを指定します。	basic	digest
   wojms.authentication.<type>.user_repository	認証に使用されるユーザリポシトリのタイプを指定します。 <type>には、wojms.authentication.type プロパティの値を指定します。	jaas	file

2. JMSサービスを再起動します。

1.7.3.11. メッセージ再配信に関する設定

ここでは、ロールバックされたメッセージの再配信に関する設定について説明します。

再配信回数

再配信回数の上限は、送信先か、JMSサービスのMOの属性で指定します。送信先で指定した場合は、その送信先に接続したコンシューマに対して有効になり、JMSサービスで指定した場合は、JMSサーバで動作するコンシューマ全体に対して有効になります。既定値以外の値が設定されていた場合の優先順位は、高いものから、送信先、JMSサービスの設定となります。

備考 :

送信先、JMSサービスともに属性名は同じです。

再配信遅延時間

再配信の遅延時間は、コネクションファクトリリソース、送信先、JMSサービスのMOの属性で指定します。また、コンシューマプログラム向けに用意しているAPI（WebOTX V5よりサポート）で、セッション単位に指定することも可能です。既定値以外の値が設定されていた場合の優先順位は、高いものから、セッション単位、コネクションファクトリリソース、送信先、JMSサービスの設定となります。

備考 :

コネクションファクトリリソース、送信先、JMSサービスともに属性名は同じです。

セッション単位で指定する場合については、[リファレンス集 開発編（共通） > 3. リソース > 3.2. JMS > 3.2.2. 拡張インタフェース]を参照してください。

MDBで再配信遅延時間を指定する場合

MDBに対して再配信遅延時間を指定するには、以下に示す方法があります。優先順位は、高いものから順に、1、2、3 となっており、以下のいずれも指定されていない場合は、前述の指定に従って再配信されます。

1. 配備記述子での設定
   ejb-jar.xml中の<activation-config-property>を利用して、以下のプロパティを設定します。
   

   表1.7.3.11-3

   プロパティ	説明
   RedeliveryDelay	再配信遅延時間（秒）

   
   具体例は、以下の通りです。
   
   

   <?xml version="1.0" encoding="UTF-8"?> <ejb-jar> 　<enterprise-beans> 　　<message-driven> 　　　<ejb-name>MyMDB</ejb-name> 　　　・・・・・ 　　　<activation-config> 　　　　<activation-config-property> 　　　　　<activation-config-property-name>RedeliveryDelay</activation-config-property-name> 　　　　　<activation-config-property-value>10</activation-config-property-value> 　　　　</activation-config-property> 　　　　・・・・・ 　　　</activation-config> 　　</message-driven> 　</enterprise-beans> </ejb-jar>

   
   
2. アノテーションでの設定
   @ActivationConfigPropertyを利用して、以下のプロパティを設定します。

   表1.7.3.11-4

   プロパティ	説明
   RedeliveryDelay	再配信遅延時間（秒）

   
   具体例は、以下の通りです。
   
   

   @MessageDriven( 　　activationConfig = { 　　　　@ActivationConfigProperty(propertyName="RedeliveryDelay", propertyValue="10"), 　　　　・・・・・ 　　} ) public class MyMDB implements MessageListener { 　　public void onMessage(Message msg) {・・・・・} }

   
   
3. プロセスグループでの設定
   プロセスグループの Java システムプロパティに以下のプロパティを指定してください。

   表1.7.3.11-5

   プロパティ	説明
   wojmsRedeliveryDelay	再配信遅延時間（秒）

   
   

1.7.3.12. 破棄メッセージの転送に関する設定

ここでは、破棄メッセージの転送に関する設定について説明します。「破棄メッセージ」とは、不達メッセージ(再配信回数を超過したメッセージ)や、有効期限切れのメッセージのことをさします。

不達メッセージ

備考 :

送信先、JMSサービスともに属性名は同じです。

有効期限切れメッセージ

注意 :

• ここで指定する送信先は、あらかじめ作成しておく必要があります。送信先の自動生成許可の設定（wojms.autocreate.topic、wojms.autocreate.queue）にかかわらず、送信先が自動的に作成されることはありません。
• 指定した送信先が存在しない場合、メッセージは破棄されます。
• 「メッセージの最大数」、「メッセージの最大合計サイズ」を設定している場合、基本的には「制限到達時の振る舞い」の設定に準じた動作となりますが、FLOW_CONTROLの指定は無視され、そのままメッセージを移動します。
• 「１メッセージ当たりの最大サイズ」の指定を超過したメッセージであっても移動します。
• 移動先の送信先が停止状態（JMS固有コマンドによる制御）の場合でもメッセージを移動します。
• 移動中にDBへの保存に失敗した場合は、差し戻されて再配信の対象となります。
• 元の送信先と移動先が同じ場合、メッセージを削除します。

JMSのメッセージヘッダ：

JMSのメッセージプロパティ：

1.7.3.13. JMSクライアントのログ出力

非Java EE環境下で動作するJavaアプリケーションでは、実行時にJavaシステムプロパティを設定することにより、ログ出力が可能です。ログは、障害解析などに利用します。
ログを出力するには、以下をJavaシステムプロパティとして指定します。

wojms.client.logger.level
wojms.client.logger.file
wojms.client.logger.size
wojms.client.logger.num

あるいは、

wojms.client.log.level
wojms.client.log.file

wojms.client.logger.〜で始まるプロパティは、出力ファイルのローテートが可能です。wojms.client.log.〜で始まるプロパティは、出力ファイルのローテートはできません。ローテートの要/不要に応じて、どちらかのタイプのプロパティを指定してください。各プロパティの詳細については、「1.7.2.9. JMSクライアントのプロパティ」を参照してください。

1.7.3.14. 分散トランザクションへの参加

Java EE環境で、JMSを分散トランザクションに参加させる場合、トランザクションサービスのJCAリソースを登録する必要があります。
JCAリソースの登録方法については、「ドメイン構築・基本設定ガイド > 7. WebOTXの内部サービス > 7.4. Transactionサービス > 7.4.2. リソースの登録・削除」を参照してください。

注意 :

• 非Java EE環境下ではJMSを分散トランザクションに参加させることはできません。
• 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つだけになります。

1.7.3.15. JMSサーバクラスタを利用するための設定

ここでは、2つのJMSサーバで構成されるJMSサーバクラスタの設定方法について説明します。
設定は、以下のように、host1のdomain1で起動するJMSサーバ(JMS1)と、host2のdomain1で起動するJMSサーバ(JMS2)でJMSサーバクラスタを構成するものとします。また、マスターブローカとして、host1-domain1上のJMSサーバを指定します。

図1.7.3.15-1

1. host1-domain1、host2-domain1のJMSサーバの設定
   
   統合運用管理ツールの場合
   「WebOTX 管理ドメイン[<ホスト名>]」-「<ドメイン名>」-「アプリケーションサーバ」-「JMS サービス」の「クラスタ」タブの各属性に対して、以下を設定します。
   
   

   表1.7.3.15-1

   項目	設定値
   JMSサーバクラスタの使用	true(チェックする)
   クラスタに属するJMSサーバのアドレスリスト	host1:9700,host2:9700
   マスターブローカのアドレス	host1:9700

   
   運用管理コマンドの場合
   set コマンドで以下を設定します。
   

   otxadmin> set server.jms-service.enableCluster=true
   otxadmin> set server.jms-service.clusterBrokerList=host1:9700,host2:9700
   otxadmin> set server.jms-service.clusterMasterBroker=host1:9700
   

   注意 :

   
   同一ホストでJMSサーバクラスタを構成する場合、上記の設定に加えて、次の設定が必要です。
   
   

   • JMSサーバインスタンス識別子をホスト内で一意となるように設定してください。設定方法は次のとおりです。
     
     統合運用管理ツールの場合
     「WebOTX 管理ドメイン[<ホスト名>]」-「<ドメイン名>」-「アプリケーションサーバ」-「JMS サービス」-【プロパティの設定】操作で、以下を設定します。
     　　instance-name=<JMSサーバインスタンス識別子>
     
     運用管理コマンドの場合
     set コマンドで以下を設定します。
     　　otxadmin> set server.jms-service.property.instance-name=<JMSサーバインスタンス識別子>
     
     
   • 2つ目以降のドメインに対して、クラスタコネクションサービスのポート番号(既定値は、9705)を変更してください。
     
     統合運用管理ツールの場合
     「WebOTX 管理ドメイン[<ホスト名>]」-「<ドメイン名>」-「アプリケーションサーバ」-「JMS サービス」-「クラスタコネクションサービスのポート番号」 を変更します。
     
     運用管理コマンドの場合
     set コマンドで以下を設定します。
     　　otxadmin> set server.jms-service.clusterPort=<クラスタコネクションサービスのポート番号>
     
     

2. JMSサーバの再起動
   クラスタの設定は、JMSサーバの再起動後に有効になるため、すべてのJMSサーバを再起動します。
   
   

   注意 :

   • マスターブローカを設定した場合は、マスターブローカが起動するまで、他のJMSサーバは利用できません。
   • 
     
   • マスターブローカを設定した場合は、マスターブローカが停止中、クラスタ内のJMSサーバでは以下の操作ができなくなります。それ以外の操作は正常に行えます。
     　　- 物理的な送信先の生成／削除／プロパティ更新
     　　- 永続サブスクリプションの削除
     

1.7.3.16. 接続先分散のための設定

JMSサーバクラスタなどで、接続先の分散を行うためにアドレスリストを使用することができます。アドレスリストは、コネクションファクトリリソースの属性として設定します。

次に、アドレスリストを設定した場合の動作について説明します。

JMSクライアントランタイムは、wojmsAddresListBehaviorの設定に応じて、wojmsAddressListから接続先を選択し接続を行います。最初に選択したアドレスで接続できなかった場合は、wojmsAddressListから「次の」アドレスを選択して接続を試みます。それでも接続できなければ「次の」アドレス、と進めていき、wojmsAddressListIterations回アドレスリストを繰り返して接続できなければ、例外を発生させるようになっています。

図1.7.3.16-1

1.7.3.17. 再配信メッセージの順序保証のための設定

注意 :

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

再配信メッセージの順序保証の利用条件

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

再配信メッセージの順序保証の利用時の動作

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

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

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

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

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

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

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

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

1.7.3.18. 他社JMSプロバイダ接続の設定

1. JNDIへの登録

1. 他社JMSプロバイダ実装クラスに関する設定
2. リソースアダプタの設定
3. リソースアダプタの配備
4. コネクタコネクションプールの生成
5. コネクタリソースの生成
6. 管理対象オブジェクトの生成
7. 配備記述子の定義

他社JMSプロバイダ側の作業

(1) JNDIへの登録

WebOTX側の作業

(1) 他社JMSプロバイダ実装クラスに関する設定

otxadmin> set server.java-config.server-classpath=/other/jms/lib/a.jar:/other/jms/lib/b.jar:/other/jms/lib/c.jar

クラス群を指定しても参照できない場合、永続化した登録情報の復元時にセキュリティ例外が発生していることが考えられます。 例えば、リフレクション権限が不足する場合には、次の例外が発生します。
java.security.AccessControlException: access denied (java.lang.reflect.ReflectPermission suppressAccessChecks)

この場合、セキュリティログ(${INSTANCE_ROOT}/logs/agent/webotx_security.log)で詳細を確認し、必要な権限を以下のセキュリティポリシファイルに追加してください。
${INSTANCE_ROOT}/config/server.policy

(2) リソースアダプタの設定

otxadmin> create-resource-adapter-config --property ProviderIntegrationMode=jndi:SupportsXA=true:RMPolicy=OnePerPhysicalConnection:UseFirstXAForRedelivery=true:JndiProperties=java.naming.factory.initial\\=jp.co.nec.WebOTX.jndi.SerialInitContextFactory,java.naming.provider.url\\=corbaname\\:\\/\\/host\\:2809 genjmsra

(3) リソースアダプタの配備

otxadmin> deploy ${AS_INSTALL}/wojms/lib/genjmsra.rar

(4) コネクタコネクションプールの生成

otxadmin> create-connector-connection-pool --raname genjmsra --connectiondefinition javax.jms.QueueConnectionFactory --transactionsupport XATransaction --property ConnectionFactoryJndiName=other/ReplyQCF:ConnectionValidationEnabled=true mypool

(5) コネクタリソースの生成

otxadmin> create-connector-resource --poolname mypool jms/ReplyQCF

(6) 管理対象オブジェクトの生成

otxadmin> create-admin-object --raname genjmsra --restype javax.jms.Queue --property DestinationJndiName=other/ReplyQueue jms/ReplyQueue

(7) 配備記述子の定義

1.7.3.19. ActivationSpec に設定可能なプロパティ

JMS リソースアダプタの ActivationSpec に設定可能なプロパティは次のとおりです。