JMS プロバイダの一般プロパティの設定

「JMS サービス」ページを使用して、すべての JMS 接続で使用するプロパティを設定するには、次の手順に従います。

  1. ツリーコンポーネントで、「設定」ノードを選択します。
  2. 「Java メッセージサービス」ノードを選択して、「JMS サービス」ページを開きます。
  3. 起動が中止されないように JMS サービスが開始するのを Application Server が待機する時間を変更するには、「起動時のタイムアウト」フィールドの値を編集します。処理速度の遅いシステムやオーバーロードしたシステムでは、デフォルト値 (60) を大きくします。
  4. 「タイプ」ドロップダウンリストから、次のとおり選択します。
  5. 「起動引数」フィールドに、JMS サービスの起動をカスタマイズする引数を入力します。install_dir/imq/bin/imqbrokerd コマンドで使用できる任意の引数を使用します。
  6. 「再接続」チェックボックスを使用して、接続が失われたときに JMS サービスがメッセージサーバーまたは AddressList で指定したアドレスのリストに再接続を試みるように指定します。
  7. デフォルトで、再接続は有効です。

  8. 「再接続の間隔」フィールドに、再接続を試行する間隔を秒数で入力します。これは、AddressList で指定した各アドレスおよびリストの、次のアドレスへの試行に適用されます。間隔が短すぎると、ブローカにリカバリする時間が与えられません。間隔が長すぎると、再接続が許容できない遅延を示す場合があります。
  9. デフォルト値は 60 秒です。

  10. 「再接続の試行」フィールドで、クライアントランタイムがリストの次のアドレスを試行する前に、AddressList に指定した各アドレスへの接続 (または再接続) を試行する回数を入力します。値 -1 は、再試行回数が無制限であることを示します。クライアントランタイムは、接続が成功するまで最初のアドレスへの接続を試みます。
  11. デフォルト値は 3 です。

  12. 「デフォルト JMS ホスト」ドロップダウンリストからホストを選択します。デフォルトは default_JMS_host です。
  13. 「アドレスリストの動作」ドロップダウンリストで、接続の試行を AddressList で指定したアドレスの順序 (priority) で行うか、またはランダムな順序 (random) で行うかを選択します。
  14. priority は、再接続が常に AddressList に指定した最初のサーバーのアドレスへの接続を試行し、最初のブローカが利用できない場合だけにほかのアドレスを使用することを意味します。

    多数のクライアントが同じ接続ファクトリを使用して接続を試行する場合は、すべてのクライアントが同じアドレスに接続しないように random を指定します。

    デフォルトは random です。

  15. 「アドレスリストの反復」フィールドで、接続の確立または再確立のために、AddressList を介して JMS サービスが反復する回数を入力します。値 -1 は試行回数が無制限であることを示します。
  16. デフォルト値は 3 です。

  17. 非デフォルトスキームまたはサービスを使用する場合は、「MQ スキーム」および「MQ サービス」フィールドに、Message Queue アドレススキーム名と MQ 接続サービス名を入力します。メッセージサービスのアドレスのフル構文は次のとおりです。
  18. scheme://address_syntax

    ここで、schemeaddress_syntax は次の表に示します。

    「MQ スキーム」と「MQ サービス」については、次の表の最初の 2 列に値が表示されています。

    表 32 メッセージサーバーのアドレススキームと構文 

    スキーム名

    接続サービス

    説明

    アドレス構文

    mq

    jmsssljms

    MQ クライアントランタイムは、指定したホストとポートで MQ ポートマッパーへの接続を確立します。ポートマッパーは動的に確立された接続サービスポートのリストを返し、次に MQ クライアントランタイムが指定された接続サービスをホストするポートへの接続を確立します。

    [hostName][:port][/serviceName]

    デフォルトは次のとおり
      hostName = localhost
      port = 7676
      serviceName = jms

    デフォルトは jms 接続サービスだけに適用されます。ssljms 接続サービスの場合、すべての変数を指定する必要があります。

    例:
    mq:MyHost:7677/ssljms

    mqtcp

    jms

    MQ クライアントランタイムは、MQ ポートマッパーをバイパスして、指定したホストとポートにTCP 接続を確立します。

    hostName:port/jms

    例:
    mqtcp:localhost:7676/jms

    mqssl

    ssljms

    MQ クライアントランタイムは、MQ ポートマッパーをバイパスして、指定したホストとポートにセキュリティー保護された SSL を確立します。

    hostName:port/ssljms

    例:
    mqssl:localhost:7676/ssljms

    http

    httpjms

    MQ クライアントランタイムは、指定された URL の MQ トンネルサーブレットに HTTP 接続を確立します。ブローカは、MQ の『管理ガイド』で説明されているとおり、HTTP トンネルサーブレットにアクセスするように設定する必要があります。

    hostName:port/
    contextRoot/tunnel

    複数のブローカインスタンスが同じトンネルサーブレットを使用している場合、無作為に選択されたブローカインスタンスではなく、特定のブローカインスタンスに接続する構文は次のとおりです。
    http://hostName:port/
    contextRoot/tunnel?serverName=hostName:instanceName

    https

    httpsjms

    MQ クライアントランタイムは、指定された MQ トンネルサーブレット URL にセキュリティー保護された HTTP 接続を確立します。ブローカは、MQ の『管理ガイド』で説明されているとおり、HTTP トンネルサーブレットにアクセスするように設定する必要があります。

    hostName:port/
    contextRoot/tunnel

    複数のブローカインスタンスが同じトンネルサーブレットを使用している場合、無作為に選択されたブローカインスタンスではなく、特定のブローカインスタンスに接続する構文は次のとおりです。
    http://hostName:port/
    contextRoot/tunnel?serverName=hostName:instanceName

  19. 「追加プロパティ」領域で、「プロパティを追加」をクリックしてプロパティを追加します。次の表に、利用可能な Message Queue ブローカの設定プロパティのリストを示します。

    表 33 JMS プロバイダの追加プロパティ 

    プロパティ名

    説明

    instance-name

    完全な Sun Java System Message Queue ブローカインスタンス名を指定します。デフォルトは imqbroker

    instance-name-suffix

    完全な Sun Java System Message Queue ブローカインスタンス名に追加するサフィックスを指定します。サフィックスは、下線文字 (_) によってインスタンス名と区切られます。たとえば、インスタンス名が imqbroker の場合、サフィックス xyz を追加して、インスタンス名を imqbroker_xyz に変更します。

    append-version

    true の場合、下線文字 (_) が先行するメジャーバージョンおよびマイナーバージョン番号を完全な Sun Java System Message Queue ブローカインスタンス名に追加します。たとえば、インスタンス名が imqbroker の場合、バージョン番号を追加して、インスタンス名を imqbroker_8_0 に変更します。デフォルトは false

  20. 「保存」をクリックして変更を保存するか、または「デフォルトを読み込み」をクリックしてサービスのデフォルト値を復元します。
  21. 「Ping」をクリックして、JMS サービスが起動し、実行されているかどうかを確認します。JMS サービスが起動し、実行されている場合、「Ping が成功しました: JMS サービスは稼働中です」というメッセージが表示されます。

プロバイダとホストをリモートシステムに変更すると、すべての JMS アプリケーションがリモートサーバーで実行するようになります。ローカルサーバーと 1 つまたは複数のリモートサーバーを使用するには、リモートサーバーにアクセスする AddressList 接続を作成するプロパティを使用して、接続ファクトリリソースを作成します。

同機能を持つ asadmin コマンド: jms-ping

関連項目


著作権表示