WebSphere MQ トピック接続ファクトリー設定このパネルを使用して、WebSphere MQ JMS プロバイダーで使用する選択済みトピック接続ファクトリーの構成プロパティーを表示または変更します。 これらの構成プロパティーは、関連する JMS トピック宛先への接続の作成方法を制御します。
トピック接続ファクトリーを使用して、トピックの宛先への JMS 接続を確立します。 トピック接続ファクトリーは、WebSphere MQ JMS プロバイダーによって作成されます。 WebSphere MQ JMS プロバイダーのトピック接続ファクトリーには、以下のプロパティーがあります。
注:
「カスタム・プロパティー」ページを使用して、WebSphere MQ プロパティーのサブセットを定義することができます。これらプロパティーの設定についての詳細は、『カスタム・プロパティー』を参照してください。この管理コンソール・ページを表示するには、「リソース」->「WebSphere MQ JMS プロバイダー」-> (コンテンツ・ペイン内、「追加プロパティー」の下にある)「WebSphere MQ Topic Connection Factories」->「connection_factory」をクリックします。
| データ型 | ストリング |
規則として、完全修飾の JNDI 名を使用します。 例えば、jms/Name の形式です。 ここで、Name は、リソースの論理名です。
この名前は、プラットフォームのバインディング情報をリンクするために使用します。 バインディングにより、モジュールのデプロイメント記述子で定義されているリソースと、 プラットフォーム別に JNDI にバインドされている実際の (物理的な) リソースとの関連付けが行われます。
| データ型 | ストリング |
| データ型 | ストリング |
| デフォルト | Null |
| データ型 | ストリング |
このプロパティーでは、WebSphere Application Server に定義されている J2C 認証データ・エントリー・エイリアスのリストを提供します。 使用するデータ・エントリー・エイリアスを選択して、 JMS プロバイダーへの新規接続を確立するための認証を受けることができます。
WebSphere Application Server に対するグローバル・セキュリティーを使用可能にしている場合は、 JMS プロバイダーへの新規接続の確立の認証を受けるために使用するユーザー ID とパスワードを指定するエイリアスを選択します。 このエイリアスの使い方は、アプリケーション・コンポーネントのデプロイメント記述子の接続ファクトリー・リソース参照で宣言されているリソース認証 (res-auth) の設定によって異なります。
注: 12 文字より長いユーザー ID は、 組み込み WebSphere JMS プロバイダーによる認証には使用できません。 例えば、デフォルトの Windows NT のユーザー ID Administrator は、 13 文字なので、組み込み WebSphere メッセージングでは使用できません。 したがって、WebSphere JMS プロバイダー接続ファクトリー用の認証エイリアスでは、 12 文字以下のユーザー ID を指定する必要があります。
このプロパティーでは、WebSphere Application Server に定義されている J2C 認証データ・エントリー・エイリアスのリストを提供します。 使用するデータ・エントリー・エイリアスを選択して、 JMS プロバイダーへの新規接続を確立するための認証を受けることができます。
WebSphere Application Server に対するグローバル・セキュリティーを使用可能にしている場合は、 JMS プロバイダーへの新規接続の確立の認証を受けるために使用するユーザー ID とパスワードを指定するエイリアスを選択します。 このエイリアスの使い方は、アプリケーション・コンポーネントのデプロイメント記述子の接続ファクトリー・リソース参照で宣言されているリソース認証 (res-auth) の設定によって異なります。
注: 12 文字より長いユーザー ID は、 組み込み WebSphere JMS プロバイダーによる認証には使用できません。 例えば、デフォルトの Windows NT のユーザー ID Administrator は、 13 文字なので、組み込み WebSphere メッセージングでは使用できません。 したがって、WebSphere JMS プロバイダー接続ファクトリー用の認証エイリアスでは、 12 文字以下のユーザー ID を指定する必要があります。
| データ型 | ストリング |
| デフォルト | Null |
| 範囲 | 1 から 48 文字の ASCII 文字で表される、有効な WebSphere MQ キュー・マネージャー名 |
| データ型 | ストリング |
| デフォルト | Null |
| 範囲 | 有効な TCP/IP ホスト名 |
このポートは、WebSphere MQ キュー・マネージャー上で構成される必要があります。
| データ型 | 整数 |
| デフォルト | Null |
| 範囲 | WebSphere MQ キュー・マネージャー上で構成された有効な TCP/IP ポート番号 |
| データ型 | ストリング |
| デフォルト | Null |
| 範囲 | 1 から 20 文字の ASCII 文字 |
| データ型 | 列挙型 |
| 単位 | 該当なし |
| デフォルト | BINDINGS |
| 範囲 |
|
| 推奨 |
|
ブローカーのコントロール・キューの名前。パブリッシャーとサブスクライバー・アプリケーション、およびその他のブローカーは、 すべてのコマンド・メッセージ (パブリケーションとパブリケーション削除の要求は除く) をこのキューに送信します。
| データ型 | ストリング |
| 単位 | En_US ASCII 文字 |
| デフォルト | Null |
| 範囲 | 1 から 48 文字の ASCII 文字 |
| データ型 | ストリング |
| 単位 | En_US ASCII 文字 |
| デフォルト | Null |
| 範囲 | 1 から 48 文字の ASCII 文字 |
デフォルト・ストリームのすべてのパブリケーション・メッセージを受信するブローカーの入力キュー (ストリーム・キュー) の名前。 アプリケーションは、このキューに対して、 デフォルト・ストリーム上のパブリケーションの削除要求を送信することもできます。
| データ型 | ストリング |
| 単位 | En_US ASCII 文字 |
| デフォルト | Null |
| 範囲 | 1 から 48 文字の ASCII 文字 |
非永続的なサブスクリプション・メッセージの検索元となるブローカーのキューの名前。 サブスクライバーは、サブスクリプションの登録時にキューの名前を指定します。
| データ型 | ストリング |
| 単位 | En_US ASCII 文字 |
| デフォルト | Null |
| 範囲 | 1 から 48 文字の ASCII 文字 |
ConnectionConsumer 用の非永続的サブスクリプション・メッセージの検索元となるブローカー・キューの名前。 このプロパティーは、Web コンテナーを使用する場合にのみ適用されます。
| データ型 | ストリング |
| 単位 | En_US ASCII 文字 |
| デフォルト | Null |
| 範囲 | 1 から 48 文字の ASCII 文字 |
| データ型 | 列挙型 |
| 単位 | 該当なし |
| デフォルト | 拡張 |
| 範囲 |
|
モデル・キュー定義の名前。ブローカーがこの定義を使用すると、 デフォルト・ストリーム以外のストリーム用のパブリケーションを受信する動的キューを作成することができます。 これが使用されるのは、ストリーム・キューがまだ存在していない場合に限られます。 このモデル・キュー定義が存在しない場合は、ストリーム・キューはすべて、 管理者によって定義されなければなりません。
| データ型 | ストリング |
| 単位 | En_US ASCII 文字 |
| デフォルト | Null |
| 範囲 | 1 から 48 文字の ASCII 文字 |
この Coded Character Set Identifier (CCSID) は、WebSphere MQ で サポートされている CCSID である必要があります。
| データ型 | ストリング |
| 単位 | 整数 |
| デフォルト | Null |
| 範囲 | 1 から 65535 |
サポートされている CCSID、およびあるコード化文字セットから別のコ
ード化文字セットへのメッセージ・データの変換について詳しくは、「
MQSeries システム管理の手引き」および「
WebSphere MQ Application Programming Reference」を参照し
てください。
これらの資料は、WebSphere MQ メッセージングのマルチプラットフォームおよびプラットフォーム固有の資料に関する Web ページ
(例えば、
http://www-3.ibm.com/software/ts/mqseries/library/manualsa/manuals/platspecific.html
、
IBM Publications Center
)、または
WebSphere MQ コレクション・キット SK2T-0730 から入手可能です。
| データ型 | 列挙型 |
| 単位 | 該当なし |
| デフォルト | クリア |
| 範囲 |
|
このプロパティーを選択する場合は、「クライアント ID」プロパティーにも値を指定する必要があります。
| データ型 | ストリング |
| 範囲 | ASCII 文字で表された、有効な JMS クライアント ID |
このプロパティーを NON_XA に設定すると、JMS セッションはトランザクションには参加していますが、XA 呼び出しではなく、リソース・マネージャーのローカル・トランザクション呼び出し (session.commit および session.rollback) を使用します。 これによって、パフォーマンスを向上できます。ただし、WebSphere Application Server のトランザクションに参加させることができるリソースは、1 つだけになります。WebSphere Application Server Enterprise では、最終参加者サポートを使用することにより、1 つの非 XA リソースをその他の XA 可能リソースとともに参加させることができます。
「ポート」プロパティーが「DIRECT」に設定されている WebSphere トピック接続ファクトリーの場合、このプロパティーは適用されず、常に値「NON_XA」を採用します。
| データ型 | 列挙型 |
| 単位 | 該当なし |
| デフォルト | XA 使用可能 |
| 範囲 |
|
| 推奨 | メッセージ・キューまたは受信されたトピックがトランザクションの唯一のリソースである場合は、XA を使用可能にしないでください。 他のキューまたは他のトピックなど、他のリソースが関係している場合は、XA を使用可能にしてください。 |
接続プール・プロパティーは、すべての J2C コネクターに共通です。
アプリケーション・サーバーは、JMS プロバイダーとの接続とセッションをプールすることで、 パフォーマンスを向上させます。 これは、WebSphere MQ 接続プールとは無関係です。 アプリケーションの接続とセッションのプール・プロパティーを適切に構成する必要があります。 構成が適切でないと、接続とセッションが正しく動作しない場合があります。
JMS リソースへのサーバー・サイド・アクセスが並行して行われ、それがデフォルト値を超える場合は、接続プールのサイズを変更してください。接続プールのサイズは、キューごと、あるいはトピックごとに設定されます。詳しくは、次の表を参照してください。
このリンクは、すべての J2C コネクターに共通の、オプションの接続プール・ プロパティーのパネルを提供します。
アプリケーション・サーバーは、JMS プロバイダーとの接続とセッションをプールすることで、 パフォーマンスを向上させます。 これは、WebSphere MQ 接続プールとは無関係です。 アプリケーションの接続とセッションのプール・プロパティーを適切に構成する必要があります。 構成が適切でないと、接続とセッションが正しく動作しない場合があります。
「カスタム・プロパティー」ページを使用して、次の WebSphere MQ プロパティーを定義することができます。これらのプロパティーは、Transport type=CLIENT を 設定している場合にしか適用されません。
SSL プロパティーの設定についての詳細は、「WebSphere MQ Java の使用 」の『SSL プロパティー』を参照してください。