アプリケーション・クライアントの IBM MQ プロバイダーのキュー接続ファクトリー設定
このパネルを使用して、IBM MQ Java™ Message Service (JMS) プロバイダーで使用するために、選択されたキュー接続ファクトリーの構成プロパティーを表示または変更します。これらの構成プロパティーは、JMS プロバイダーと IBM MQ との間に接続を作成する方法を制御します。
この「アプリケーション・クライアント・リソース構成ツール (ACRCT)」ページを表示するには、オープン」をクリックします。 選択した JAR ファイルを展開して、 とクリックします。 「Queue Connection Factories」を右マウス・ボタン・クリックして、「新規」をクリックします。 「一般」タブ上に以下のフィールドが表示さ れます。
とクリックします。EAR ファイルのブラウズ後、「- 指定するプロパティー値は、 IBM MQ の JMS リソースを構成する際に指定した値と一致していなければなりません。 JMS リソース用の IBM MQ の構成について詳しくは、IBM MQ インフォメーション・センターの『Java の使用』セクションを参照してください。
- IBM MQ では、名前に最大 48 文字まで使用できますが、チャネルの場合は例外で、最大 20 文字までになります。
JMS プロバイダーのキュー接続ファクトリーには、以下のプロパティーがあります。
名前
WebSphere® Application Server 内で、このキュー接続ファクトリーを管理目的で使用する際の名前。 この名前は、WebSphere 管理ドメイン全体の JMS 接続ファクトリー内で固有でなければなりません。
通知 | 値 |
---|---|
データ型 | ストリング |
説明
WebSphere Application Server 内で管理目的で使用する、この接続ファクトリーの説明。
通知 | 値 |
---|---|
データ型 | ストリング |
デフォルト | Null |
JNDI 名
アプリケーション・クライアント・ランタイムは、 このフィールドを使用して構成情報を検索します。
ユーザー ID
呼び出し側のアプリケーションがユーザー ID とパスワードを明示的に指定しない場合に、認証で「パスワード」プロパティーと一緒に使用するユーザー ID です。
「ユーザー ID」プロパティーに値を指定する場合は、「パスワード」プロパティーにも値を指定する必要があります。
呼び出し側のアプリケーションがユーザー ID とパスワードを明示的に提供しない場合 (例えば、呼び出し側のアプリケーションがメソッド createQueueConnection() を使用する場合) は、接続ファクトリーの「ユーザー ID」プロパティーと「パスワード」プロパティーが使用されます。JMS クライアントは、ユーザー ID とパスワードを JMS サーバーに渡します。
通知 | 値 |
---|---|
データ型 | ストリング |
Password
呼び出し側のアプリケーションがユーザー ID とパスワードを明示的に提供していない場合、認証のために「ユーザー ID」プロパティーとともにこのパスワードを使用します。
「ユーザー ID」プロパティーに値を指定する場合は、「パスワード」プロパティーにも値を指定する必要があります。
通知 | 値 |
---|---|
データ型 | ストリング |
デフォルト | Null |
再入力パスワード
パスワードを確認します。
キュー・マネージャー
この接続ファクトリー用の IBM MQ キュー・マネージャーの名前。
このファクトリーによって作成された接続は、そのキュー・マネージャーに接続します。
通知 | 値 |
---|---|
データ型 | ストリング |
ホスト名およびポート情報の入力
このラジオ・ボタンはデフォルトで選択されます。これが選択されている場合は、ホスト・プロパティーおよびポート・プロパティーが使用可能になり、接続名リスト・プロパティーが使用不可になります。
通知 | 値 |
---|---|
データ型 | ラジオ・ボタン |
デフォルト | 選択 |
ホスト
クライアント接続専用で IBM MQ キュー・マネージャーが実行されているホストの名前。
通知 | 値 |
---|---|
データ型 | ストリング |
デフォルト | Null |
範囲 | 有効な TCP/IP ホスト名 |
Port
IBM MQ キュー・マネージャーへの接続に使用される TCP/IP ポート番号 (クライアント接続の場合のみ)。
このポートは、IBM MQ キュー・マネージャー上で構成する必要があります。
通知 | 値 |
---|---|
データ型 | 整数 |
デフォルト | Null |
範囲 | IBM MQ キュー・マネージャー上で構成された有効な TCP/IP ポート番号。 |
接続名リスト情報の入力
このラジオ・ボタンを選択すると、接続名リスト・プロパティーが使用可能になり、ホスト名プロパティーおよびポート名プロパティーが使用不可になります。このラジオ・ボタンは、マルチインスタンス・キュー・マネージャーに接続する場合に選択します。
通知 | 値 |
---|---|
データ型 | ラジオ・ボタン |
デフォルト | クリア |
接続名リスト
マルチインスタンス・キュー・マネージャーへの接続に使用できるホスト情報とポート情報のコンマ区切りリスト。
host[(port)],[host[(port)]]
ここで、port はオプションで、設定されていない場合はデフォルトで 1414 に設定されます。以下に例を示します。hostname1,hostname2(1415)
マルチインスタンス・キュー・マネージャーについて詳しくは、IBM MQ インフォメーション・センターを参照してください。
このプロパティーは、マルチインスタンス・キュー・マネージャーに接続する場合にのみ使用する必要があります。個別のキュー・マネージャーのリストへの接続には使用しないでください。使用すると、トランザクションの整合性問題が発生する可能性があります。
チャネル
IBM MQ キュー・マネージャーへの接続に使用されるチャネルの名前 (クライアント接続の場合のみ)。
通知 | 値 |
---|---|
データ型 | ストリング |
デフォルト | Null |
範囲 | 1 から 20 文字の ASCII 文字 |
トランスポート・タイプ
IBM MQ キュー・マネージャーとの接続に、IBM MQ クライアント接続を使用するか、JNDI バインディングを使用するかを指定します。外部 JMS プロバイダーが、JMS クライアントと JMS サーバーの間の通信プロトコルを制御します。 非 ASF の非パーシスタント、非永続、非トランザクションのメッセージングを使用している場合、またはセキュリティー問題を解決する必要があり、クライアントがキュー・マネージャー・ノードに対してローカルである場合は、トランスポート・タイプを調整してください。
通知 | 値 |
---|---|
データ型 | 列挙型 |
単位 | 該当なし |
デフォルト | BINDINGS |
範囲 |
|
推奨 |
注: WebSphere Application Server バージョン 6.1 には Java 5 ランタイムがあるため、IBM MQ 5.3 JMS は、WebSphere Application Server バージョン 6.1 内では使用できません。そのため、IBM MQ 5.3 キュー・マネージャーを使用して、仮想記憶間接続を確立できません。
以前、ユーザー接続に IBM MQ 5.3 と BINDINGS を使用しており、WebSphere Application Server バージョン 6.1 への移行で CLIENT ネットワーク接続に移動した場合は、性能が低下する可能性があります。
![]() |
クライアント ID
IBM MQ キュー・マネージャーへの接続に使用される JMS クライアント ID。
通知 | 値 |
---|---|
データ型 | ストリング |
CCSID
IBM MQ キュー・マネージャーで使用されるコード化文字セット ID。
このコード化文字セット ID (CCSID) は、IBM MQ がサポートする CCSID の 1 つでなければなりません。
通知 | 値 |
---|---|
データ型 | ストリング |
サポートされる CCSID、およびコード化文字セット間のメッセージ・データ変換について詳しくは、IBM MQ インフォメーション・センターの『システム管理』および『アプリケーション・プログラミング・リファレンス』の各セクションを参照してださい。
メッセージ保存
このチェック・ボックスを選択すると、不要なメッセージがキューに残るように指定されます。 このチェック・ボックスが選択されないと、不要なメッセージは後処 理オプションに従 って処理されます。
通知 | 値 |
---|---|
データ型 | 列挙型 |
単位 | 該当なし |
デフォルト | クリア |
範囲 |
|
一時モデル
接続ファクトリーがまだ存在していない場合に、一時接続ファクトリーの作成に使用できるモデル定義の名前。
通知 | 値 |
---|---|
データ型 | ストリング |
範囲 | 1 から 48 文字の ASCII 文字 |
一時キュー接頭部
動的キュー・ネーミングに使用される接頭部。
通知 | 値 |
---|---|
データ型 | ストリング |
静止の場合に失敗
キュー・マネージャーが制御された失敗状態になった場合に、アプリケーションがメソッド呼び出しから戻されるかどうかを指定します。
通知 | 値 |
---|---|
データ型 | チェック・ボックス |
デフォルト | 選択 |
ローカル・サーバー・アドレス
ローカル・サーバー・アドレスを指定します。
通知 | 値 |
---|---|
データ型 | ストリング |
ポーリング間隔
非同期メッセージの配信中に、すべての受信側の間でのスキャン間隔をミリ秒で指定します。
通知 | 値 |
---|---|
データ型 | 整数 |
単位 | ミリ秒 |
デフォルト | 5000 |
再スキャン間隔
トピックに順不同で追加されたメッセージを探すために、トピックをスキャンする間隔 (ミリ秒) を指定します。
この間隔は、トピックに順不同で追加されたメッセージの IBM MQ ブラウズ・カーソルを考慮したスキャンを制御します。
通知 | 値 |
---|---|
データ型 | 整数 |
単位 | ミリ秒 |
デフォルト | 5000 |
SSL 暗号スイート
IBM MQ への SSL 接続に使用する暗号スイートを指定します。
このプロパティーは、ご使用の JSSE プロバイダーで提供されている有効な暗号スイートに設定してください。 この値は SVRCONN チャネル (「チャネル」プロパティー) で指定された CipherSpec と一致していなければなりません。
「SSL ピア名」プロパティーを設定する場合は、 このプロパティーを設定する必要があります。
SSL 証明書ストア
SSL 証明書の失効を検査するために使用される、ゼロ個以上の証明書失効リスト (CRL) サーバーのリストを指定します。 このプロパティーに値を指定する場合は、Java 2 バージョン 1.4 の IBM MQ JVM を使用する必要があります。
ldap://hostname:[port]
シングル・スラッシュ (/) がこの値に続きます。port を省略した場合は、デフォルトの LDAP ポートである 389 が想定されます。接続時に、サーバーから提示された SSL 証明書が、指定された CRL サーバーと照合されます。 CRL セキュリティーについて詳しくは、IBM MQ インフォメーション・センターの『セキュリティー』セクションの『証明書失効リストの取り扱い (Working with Certificate Revocation Lists)』を参照してください。
SSL ピア名
SSL の場合は、識別名スケルトンです。これは、IBM MQ キュー・マネージャーによって提供された名前に一致している必要があります。この識別名は、接続時にサーバーによって提示された識別証明書を検査するために使用されます。
このプロパティーが設定されていない場合、このような証明書の検査が行われます。
「SSL 暗号スイート」プロパティーが指定されていない場合は、SSL ピア名プロパティーは無視されます。
CN=QMGR.*, OU=IBM, OU=WEBSPHERE
この例では、接続時にサーバーによって提示される識別証明書が検査されます。正常に接続するためには、証明書は QMGR で始まり、少なくとも 2 つの組織単位名 (最初が IBM®、2 つ目が WEBSPHERE) で構成される共通名を持っている必要があります。検査では、大/小文字が区別されません。
識別名、および IBM MQ での識別名の使用方法について詳しくは、IBM MQ インフォメーション・センターの「識別名」に関する情報を参照してください。
接続プール
接続プールの設定のオプショナル・セットを指定します。
接続プール・プロパティーは、すべての J2C コネクターに共通です。
アプリケーション・サーバーは、JMS プロバイダーとの接続とセッションをプールすることで、 パフォーマンスを向上させます。 この接続プールは、IBM MQ 接続プールとは無関係です。ご使用のアプリケーションに合わせて接続およびセッションのプールのプロパティーを構成する必要があります。 そうしないと、接続およびセッションが期待どおりの動作をしない場合があります。
JMS リソースへのサーバー・サイド・アクセスが並行して行われ、それがデフォルト値を超える場合は、接続プールのサイズを変更してください。接続プールのサイズは、キューごと、あるいはトピックごとに設定されます。
通知 | 値 |
---|---|
データ型 | チェック・ボックス |
デフォルト | 選択 |
クライアント再接続オプション
通信またはキュー・マネージャーの障害が発生した場合に、クライアント・モード接続の再接続を自動的に実行するかどうかを指定します。このプロパティーは、接続ファクトリーがシン・クライアント環境または管理対象クライアント環境で使用されている場合でない限り、無視されます。
通知 | 値 |
---|---|
データ型 | ドロップダウン・リスト |
デフォルト | DISABLED |
範囲 |
|
自動クライアント再接続について詳しくは、IBM MQ インフォメーション・センターを参照してください。
クライアント再接続タイムアウト
通信またはキュー・マネージャーの失敗の後で、クライアント・モード接続がキュー・マネージャーに自動的に再接続しようと費やす最大秒数。シン・クライアント環境または管理対象クライアント環境で接続ファクトリーが使用されていない限り、このパラメーターは無視されます。 このパラメーターが使用されるかどうかは、クライアント再接続オプション・パラメーターの値によって決まります。
通知 | 値 |
---|---|
データ型 | 整数 |
単位 | 秒 |
デフォルト | 1800 |
範囲 | ゼロより大きく 2147483647 以下の値。 |
自動クライアント再接続について詳しくは、IBM MQ インフォメーション・センターを参照してください。