ページの先頭行へ戻る
Interstage Application Server/Interstage Web Server Java EE運用ガイド

9.6.3 JMS接続ファクトリの定義項目

定義項目

項目名

省略値

範囲

説明

再起動要否

(※)

JNDI名

  • 半角英数字、または特殊文字('-'、'_'、'.'、'/'、';')。

  • 先頭には、半角英数字または‘_’のみ指定可。

  • 1~255文字の文字列

JMS接続ファクトリをlookupするためのJNDI名です。

リソースタイプ

  • javax.jms.TopicConnectionFactory

  • javax.jms.QueueConnectionFactory

  • javax.jms.ConnectionFactory

JMS接続ファクトリのタイプです。

説明

文字列

JMS接続ファクトリの説明文です。

状態

true

  • true

  • false

JMS接続ファクトリを有効または無効にします。

×

追加プロパティ

UserName

guest

■プロパティ値:
文字列

メッセージブローカとの接続に使用するユーザ名です。

Password

guest

■プロパティ値:
文字列

メッセージブローカとの接続に使用するパスワードです。

ClientId

■プロパティ値:
文字列

永続的なサブスクライバ(durable subscriber)が使用するJMS接続ファクトリのクライアントIDです。

任意のプロパティ名

■プロパティ名:
半角英数字、マルチバイト文字、または特殊文字(‘-’、‘_’、‘.’、‘/’、‘;’、‘#’)。
先頭には、半角英数字もしくはマルチバイト文字を指定可。
■プロパティ値:
文字列

プール設定

初期および最小プールサイズ

8

0~2147483647
(最大プールサイズ以下)

プール内の接続の最小数を指定します。この値は、プールを最初に作成する時のプールに含まれる接続数としても使用されます。

×

最大プールサイズ

32

1~2147483647
(初期および最小プールサイズ以上、かつプールサイズ変更量以上)

プールに含まれる接続の最大数を指定します。プール数が最大プールサイズに達し、すべての接続が使用中の場合、接続要求はキューに格納されます。使用中の接続が解放されると、キューにたまった要求が取り出されて処理が実行されます。

×

プールサイズ変更量

2

1~2147483647
(最大プールサイズ以下)

プールのサイズを最大プールサイズおよび最小プールサイズに対して拡大および縮小すると、一括処理でプールサイズが変更されます。ただし、プールサイズ変更時には最大プールサイズまで拡大し、最小プールサイズまで縮小するように変更します。
この値は一括処理での接続の数を指定します。この値を過大に設定すると接続の作成と再利用が遅れ、過小に設定すると効率が落ちます。

×

アイドルタイムアウト

300

1~2147483647

プールで接続がアイドル状態のままでいられる最長時間(秒)を指定します。この時間を過ぎると、接続はプールから削除されます。

×

最大待ち時間

60000

0~2147483647

接続を要求するアプリケーションが接続タイムアウトになるまでに待つ時間(ミリ秒)を指定します。0が指定された場合、接続タイムアウトは発生しません。

×

すべての障害で

false

  • true

  • false

この設定を有効にした場合、1つの接続障害を検出すると、アプリケーションサーバはプールに含まれるすべての接続を閉じ、初期および最小プールサイズで指定した数だけ接続を再確立します。この際、クローズされた接続は接続検証に失敗した接続としてみなされます。
無効の場合は、クライアントからの接続要求の契機でプールから取り出した接続に対して接続検証を行い、検証に失敗した接続のみを破棄します。

×

トランザクションサポート

  • XATransaction

  • LocalTransaction

  • NoTransaction

接続ファクトリがサポートするトランザクションのレベルです。

×

接続検証

false

  • true

  • false

接続検証を有効にします。

×

※:IJServerクラスタの再起動が必要かどうかを示しています。
    ○:再起動必要、×:再起動不要

関連情報

詳細な説明や関連記事については、以下を参照してください。

内容

参照先

機能説明

JMSの提供機能

チューニング方法

コマンド

asadminコマンドの以下のサブコマンド
  11.1.4.1 getサブコマンド
  11.1.4.2 setサブコマンド
  11.1.4.3 listサブコマンド
  11.1.14.8 create-jms-resourceサブコマンド
  11.1.14.9 delete-jms-resourceサブコマンド
  11.1.14.10 list-jms-resourcesサブコマンド

asadminコマンドでの定義項目名

11.18.2.6 resources.connector-resourceの定義項目
11.18.2.9 resources.connector-connection-poolの定義項目