test

Sun Java System Message Queue 3.7 UR1 管理ガイド

接続の処理

表 16–1 に、接続処理に関する接続ファクトリ属性を示します。

表 16–1 接続の処理に関する接続ファクトリ属性

属性 

データ型 

デフォルト値 

説明 

imqAddressList

文字列 

既存の Message QueueTM 3.0 アドレス、またはそれがない場合は表 16–2 の最初のエントリ

ブローカのアドレスのリスト 

リストは、コンマ区切りの 1 つ以上のブローカアドレスから構成されます。各アドレスでは、クライアントが接続できるブローカインスタンスのホスト名、ポート番号、および接続サービスを明示的または暗黙的に指定します。アドレスの構文は、接続サービスとポートの割り当て方法によって異なります。詳細については、後述の説明を参照してください。 

imqAddressListBehavior

文字列 

PRIORITY

ブローカアドレスに接続を試行する順序 

    PRIORITY: アドレスリストに指定されている順序


    RANDOM: ランダムな順序


注 –

多数のクライアントが同じ接続ファクトリを共有する場合は、すべてのクライアントが同じアドレスに接続を試行するのを避けるために、ランダムな接続順序を指定してください。

imqAddressListIterations

整数 

5

接続の確立または再確立を試行する際にアドレスリストを繰り返す回数 

値 -1 は、繰り返し回数が無制限であることを示します。

imqPingInterval

整数 

30

クライアントとブローカ間のテスト接続の間隔 (秒単位) 

値 0 または -1 を指定すると、接続の定期的なテストが無効になります。

imqReconnectEnabled

ブール 

false

失われた接続の再確立を試行するかどうか 

imqReconnectAttempts

整数 

0

アドレスリスト内の次のアドレスに移る前に、各アドレスに接続または再接続を試行する回数 

値 -1 は、接続の試行回数が無制限であることを示します。この場合、成功するまで、最初のアドレスに繰り返し接続が試行されます。

imqReconnectInterval

倍長整数 

3000

再接続を試行する間隔 (ミリ秒単位) 

この値は、特定のアドレスに対する連続する試行と、リスト内の連続するアドレスに対する試行の両方に適用されます。 

注 –

値が小さすぎると、ブローカが回復するのに十分な時間が与えられない可能性があります。値が大きすぎると、許容できない接続遅延が発生する可能性があります。

imqSSLIsHostTrusted

ブール 

true

ブローカが提示する証明書を信頼するかどうか 

false の場合、Message Queue クライアントランタイムは提示された証明書をすべて検証します。証明書の署名者がクライアントのトラストストアに存在しない場合、検証は失敗します。

true の場合、証明書の検証はスキップされます。これは、自己署名付きの証明書を使用するソフトウェアテストなどに便利です。

注:認証局からの署名付き証明書を使用するには、この属性を false に設定します。

imqAddressList 属性の値は、接続先のブローカのアドレスを 1 つ以上指定するコンマ区切りの文字列です。各アドレスの一般的な構文は、次のようになります。

   
scheme://address

scheme には、表 16–2 に示すアドレススキーマのいずれかを指定し、address には、ブローカのアドレス自体を指定します。アドレスを指定するための正確な構文は、表の最後の列に示すように、アドレススキーマによって異なります。

表 16–2 メッセージブローカのアドレススキーマ

スキーマ 

サービス 

構文 

説明 

mq

jms または ssljms

[hostName][:portNumber ][/serviceName]

jms または ssljms 接続サービスで、ポートを動的に割り当てます。

アドレスリストのエントリには、Message Queue ポートマッパーのホスト名とポート番号を指定します。ポートマッパー自体が、接続に使用するポートを動的に割り当てます。 

デフォルト値:

    hostName = localhost


    portNumber = 7676


    serviceName = jms


ssljms 接続サービスでは、すべての変数を明示的に指定する必要があります。

mqtcp

jms

hostName:portNumber /jms

jms 接続サービスを使用して、指定されたポートに接続します。

ポートマッパーをバイパスし、指定されたホスト名とポート番号に対して直接、TCP 接続を作成します。

mqssl

ssljms

hostName:portNumber /ssljms

ssljms 接続サービスを使用して、指定されたポートに接続します。

ポートマッパーをバイパスし、指定されたホスト名とポート番号に対して直接、安全な SSL 接続を作成します。

http

httpjms

http://hostName: portNumber/contextRoot /tunnel

複数のブローカインスタンスが同じトンネルサーブレットを使用する場合、次の構文では、ランダムに選択されたブローカインスタンスではなく、特定のブローカインスタンスに接続します。 

http://hostName: portNumber/contextRoot /tunnel?

    ServerName=hostName :instanceName


httpjms 接続サービスを使用して、指定されたポートに接続します。

指定された URL の Message Queue トンネルサーブレットに対して、HTTP 接続を作成します。HTTP トンネルサーブレットにアクセスするように、ブローカを設定する必要があります。

https

httpsjms

https://hostName: portNumber/contextRoot /tunnel

複数のブローカインスタンスが同じトンネルサーブレットを使用する場合、次の構文では、ランダムに選択されたブローカインスタンスではなく、特定のブローカインスタンスに接続します。 

https://hostName: portNumber/contextRoot /tunnel?

    ServerName=hostName :instanceName


httpsjms 接続サービスを使用して、指定されたポートに接続します。

指定された URL の Message Queue トンネルサーブレットに対して、安全な HTTPS 接続を作成します。HTTPS トンネルサーブレットにアクセスするように、ブローカを設定する必要があります。

表 16–3 メッセージブローカアドレスの例

サービス 

ブローカホスト 

ポート 

アドレス例 

未指定 

未指定 

未指定 

アドレスなし (mq://localHost:7676/jms)

未指定 

指定したホスト 

未指定 

myBkrHost (mq://myBkrHost:7676/jms)

未指定 

未指定 

指定したポートマッパーポート 

1012 (mq://localHost:1012/jms)

ssljms

ローカルホスト 

標準のポートマッパーポート 

mq://localHost:7676/ssljms

ssljms

指定したホスト 

標準のポートマッパーポート 

mq://myBkrHost:7676/ssljms

ssljms

指定したホスト 

指定したポートマッパーポート 

mq://myBkrHost:1012/ssljms

jms

ローカルホスト 

指定したサービスポート 

mqtcp://localhost:1032/jms

ssljms

指定したホスト 

指定したサービスポート 

mqssl://myBkrHost:1034/ssljms

httpjms

該当なし 

該当なし 

http://websrvr1:8085/imq/tunnel

httpsjms

該当なし 

該当なし 

https://websrvr2:8090/imq/tunnel