IBM MQ メッセージング・プロバイダー・トピック接続ファクトリー設定

WebSphere® MQ メッセージング・プロバイダーで使用する選択済みトピック接続ファクトリーの構成プロパティーを表示または変更します。これらの構成プロパティーは、関連する JMS トピック宛先への接続の作成方法を制御します。

IBM MQ トピック接続ファクトリーを使用して、Publish/Subscribe メッセージングのために IBM MQ が提供するトピック宛先への JMS 接続を確立します。

IBM MQ トピック接続ファクトリー設定を表示するには、管理コンソールを使用して以下のステップを実行します。

ナビゲーション・ペインで、「リソース」 > 「JMS」->「トピック接続ファクトリー」をクリックして、既存のトピック接続ファクトリーを表示します。
適宜、目次ペインで、「有効範囲」の設定を、トピック接続ファクトリーが定義されているレベルに変更します。これにより、表示されるトピック接続ファクトリーのセットが制限されます。
作業の対象となるトピック接続ファクトリーの名前を選択します。

「一般プロパティー」の下に以下の 4 つのプロパティー・グループがあります。

管理
接続
拡張
セキュリティー設定

「管理」、「接続」、「拡張」、および「セキュリティー」設定のプロパティー・グループに対して必要な変更を行い、次に「適用」をクリックして構成を保存してから、目次ペインの「追加プロパティー」で次のいずれかのリンクをクリックします。

「拡張プロパティー」。これは、IBM MQ トピック接続ファクトリーの拡張プロパティーを表示するときに使用します。
「ブローカー・プロパティー」。これは、IBM MQ トピック接続ファクトリーのブローカー・プロパティーを表示するときに使用します。
「カスタム・プロパティー」。これは、IBM MQ トピック接続ファクトリーのカスタム・プロパティーを表示するときに使用します。
「クライアント・トランスポート・プロパティー」。これは、IBM MQ トピック接続ファクトリーのクライアント・トランスポート・プロパティーを表示または変更するときに使用します。選択したトピック接続ファクトリーが、クライアント・チャネル定義テーブル (CCDT) を使用して作成されたものでない場合、このリンクに IBM MQ へ接続するために必要な情報をユーザーがすべて入力します。選択したトピック接続ファクトリーが CCDT を使用して作成されたものである場合は、クライアント・トランスポート・プロパティーを指定する必要がないため、このリンクはありません。
「接続プール」。これは、IBM MQ トピック接続ファクトリーの接続プール詳細を表示するときに使用します。
「セッション・プール」。これは、IBM MQ トピック接続ファクトリーのセッション・プール詳細を表示するときに使用します。

「関連項目」の下で、「JAAS - J2C 認証データ」をクリックして、トピック接続ファクトリーで使用する認証情報を構成することができます。

IBM MQ 管理コマンドを使用して、以下の追加プロパティーを指定できます。

-localAddress
-clonedSubs
-componentAuthAlias

これらのプロパティーについて詳しくは、createWMQConnectionFactory コマンドを参照してください。

注: IBM MQ プロパティーを指定する際には、次の制限が適用されます。

名前には最大 48 文字を使用できます。ただし、チャネルは例外で、最大 20 文字となります。
指定するプロパティー値は、IBM MQ での JMS リソース構成時に指定した値と一致している必要があります。 IBM MQ での JMS リソースの構成について詳しくは、IBM MQ インフォメーション・センターの「Java の使用」のセクションを参照してください。

IBM MQ トピック接続ファクトリーには以下のようなプロパティーがあります。

管理

有効範囲

このリソース定義がアプリケーションに対して可視であるレベル。

メッセージング・プロバイダー、ネーム・スペース・バインディング、または共有ライブラリーなどのリソースを複数の有効範囲で定義することが可能です。より限定的な有効範囲で定義されたリソースは、それより広い有効範囲で定義された重複するリソースをオーバーライドします。

表示された有効範囲は情報のためだけです。このパネルで変更することはできません。異なる有効範囲でこのリソースを参照する、または変更する場合は、IBM MQ トピック接続ファクトリー・コレクション・パネルで有効範囲を変更し、「適用」をクリックしてから、そのリソース・タイプのリンクをクリックします。

通知	値
データ型	ストリング

プロバイダー

トピック接続ファクトリーの作成時に割り当てられた JMS プロバイダー。

このパネルを使用して作成されるすべてのトピック接続ファクトリーの場合、プロバイダーは IBM MQ メッセージング・プロバイダーです。

プロバイダーは情報提供のためだけに表示されます。

通知	値
データ型	ストリング

名前

WebSphere Application Server 内で、このトピック接続ファクトリーを管理目的で使用する際の名前。

通知	値
データ型	ストリング
範囲	この名前は、セルに定義されている JMS トピック接続ファクトリーのセット内で固有である必要があります。

JNDI 名

JNDI 名前空間にトピック接続ファクトリーをバインドするために使用される JNDI 名。

規則として、完全修飾の JNDI 名を使用します。例えば、jms/Name の形式です。ここで、Name はリソースの論理名です。

通知	値
データ型	ストリング

説明

WebSphere Application Server 内で管理目的で使用する、このトピック接続ファクトリーの説明。

通知	値
データ型	ストリング
デフォルト	Null

接続

接続を構成するために必要な情報は、選択したトピック接続ファクトリーがクライアント・チャネル定義テーブル (CCDT) を使用して作成されたものであるかどうかによって異なります。

選択したトピック接続ファクトリーが、CCDT を使用して作成されたものであれば、次のプロパティーのみが表示されます。

クライアント・チャネル定義テーブル URL
キュー・マネージャー
SSL 構成

選択したトピック接続ファクトリーが、CCDT を使用して作成されたものでない場合、次のプロパティーが表示されます。

キュー・マネージャー
トランスポート
「ホストおよびポート情報を、ホストとポート値が分離された形式で入力する」が選択された場合、接続名リスト・プロパティーは使用できず以下のプロパティーを使用できます。
- ホスト名
- ポート
「ホストおよびポート情報を接続名リストとして入力する (Enter host and port information in the form of a connection name list)」が選択されている場合は、接続名リスト・プロパティーを使用することができ、以下のプロパティーは使用できません。
- ホスト名
- ポート
サーバー接続チャネル
「IBM MQ との通信を保護するために SSL を使用」プロパティーのチェック・ボックスをクリアした場合は、以下のプロパティーを使用することはできません。
- 中央管理対象
- 固有の構成
- SSL 構成

IBM MQ の SSL プロパティーの設定について詳しくは、IBM MQ インフォメーション・センターの「Javaの使用」セクション内の『SSL プロパティー』を参照してください。

クライアント・チャネル定義テーブル URL

IBM MQ CCDT のロケーションを指定する URL。

通知	値
データ型	ストリング

キュー・マネージャー

指定されたトピック接続ファクトリーが CCDT に基づいている場合、このプロパティーは CCDT でエントリーを選択するために使用されます。そうでない場合、これは接続先のキュー・マネージャーまたはキュー共有グループの名前です。この IBM MQ リソースに対して、メッセージを送受信するために接続が確立されます。

通知

値

データ型

ストリング

範囲

このトピック接続ファクトリーが CCDT に基づいていない場合、値は有効なキュー・マネージャー名でなければなりません。

このトピック接続ファクトリーが CCDT に基づいている場合、値は次のいずれかでなければなりません。

有効なキュー・マネージャー名
先頭にアスタリスク (*) の付いたキュー・マネージャー・グループの名前¹
アスタリスク (*)
ブランク¹

¹CCDT と組み合わせてこのフォームでキュー・マネージャー・プロパティーの値を指定すると、トピック接続ファクトリーを使用して確立された個別の接続が、異なるキュー・マネージャーに接続することがあります。CCDT が対応するキュー・マネージャー名 (QMNAME) パラメーターで複数のクライアント接続チャネル定義を含んでいるときは複数のキュー・マネージャーからの選択が行われ、これらの接続チャネル定義は異なるキュー・マネージャーのネットワーク接続の詳細を定義します。

指定された接続ファクトリーが CCDT に基づいて作成されたものであり、その CCDT が複数のキュー・マネージャーから選択可能である場合、グローバル・トランザクションをリカバリーできない場合があります。そのため、CCDT を指定する接続ファクトリーには、以下の 2 つの代替方法があります。

キュー・マネージャー・プロパティーを指定する際には、ターゲットのキュー・マネージャーについてあいまいさが残らないようにします。つまり、このプロパティーに指定する値には、アスタリスク (*) を含めてはなりません。
グローバル・トランザクションに属するアプリケーションでリソースを使用しないようにします。

トランスポート

接続用の IBM MQ トランスポート・タイプ。トランスポート・タイプは、IBM MQ への接続で使用する的確なメカニズムを決定するために使用されます。

通知	値
データ型	ドロップダウン・リスト
デフォルト	バインディングの次にクライアント
範囲	クライアント TCP/IP ベースのネットワーク接続を使用して、IBM MQ キュー・マネージャーと通信します。バインディングの次にクライアントキュー・マネージャーへのバインディング・モード接続を試みます。これが可能でなければ、クライアント・トランスポートに戻ります。バインディング同じノードで実行されているキュー・マネージャーへの仮想記憶間接続を確立します。以下の「クライアント・トランスポート・モード」プロパティーは使用不可です。ホスト名ポート接続名リストサーバー接続チャネルトランスポート・タイプ `バインディングとクライアント` または `バインディング`の構成について詳しくは、ネイティブ・ライブラリー情報を持つ IBM MQ メッセージング・プロバイダーの構成を参照してください。

ホストおよびポート情報を、ホストとポート値が分離された形式で入力する

このラジオ・ボタンを選択する場合、IBM MQ キュー・マネージャーへの接続は、ホスト名とポートのプロパティーによって指定される情報を使用して行われることを意味します。

このオプションを選択すると、ホスト名およびポートのプロパティーが使用可能になり、接続名リストのプロパティーが使用不可になります。接続名リスト情報を入力するには、「ホストおよびポート情報を接続名リストとして入力する (Enter host and port information in the form of a connection name list)」をクリックします。

このラジオ・ボタンは、有効範囲のプロパティーにセルまたはクラスターが指定されている場合、あるいは有効範囲のプロパティーにノードまたはサーバーが指定されており、そのノードまたはサーバーが WebSphere Application Server バージョン 8.0 以降を実行している場合のみ使用可能です。

通知	値
データ型	ラジオ・ボタン

ホスト名

接続先となる IBM MQ キュー・マネージャーの、ホスト名、IPv4 アドレス、または IPv6 アドレス。

通知	値
データ型	ストリング

ポート

IBM MQ が listen するポート番号。

通知	値
データ型	整数
デフォルト	1414
範囲	値は 1 から 65536 の範囲内の値でなければなりません。

接続名リストの形式でホストおよびポート情報を入力 (Enter host and port information in the form of a connection name list)

このラジオ・ボタンを選択する場合、IBM MQ キュー・マネージャーへの接続は、接続名リスト・プロパティーによって指定される情報を使用して行われることを意味します。

接続名リストは、単一のキュー・マネージャーまたはマルチ・インスタンスのキュー・マネージャーへの接続に使用できます。マルチインスタンス・キュー・マネージャーの使用に関して詳しくは、 IBM MQ インフォメーション・センターを参照してください。このオプションを選択すると、接続名リスト・プロパティーが使用可能になり、ホスト名およびポートのプロパティーが使用不可になります。分離されたホストおよびポート情報を入力するには、「ホストおよびポート情報を、ホストとポート値が分離された形式で入力する」をクリックします。

通知	値
データ型	ラジオ・ボタン

接続名リスト

接続ファクトリーをマルチインスタンス・キュー・マネージャーに接続する場合に使用するホスト名およびポートの詳細を指定する接続名リスト。

このプロパティーは、マルチ・インスタンスのキュー・マネージャーに接続できるようにするためだけに使用しなければなりません。マルチ・インスタンスではないキュー・マネージャーに接続できるようにするために使用してはなりません。トランザクション整合性の問題を引き起こす可能性があるからです。

通知

値

データ型

ストリング

デフォルト

設定なし

範囲

このフィールドには以下の形式でストリングを設定しなければなりません。

host[(port)][,host(port)]

ポート情報はオプションで、指定されない場合のデフォルトは 1414 です。

host は、有効な TCP/IP ホスト名、または IPv4 アドレスか IPv6 アドレスである必要があります。

<ポート> は、1 から 65536 までの範囲の整数値でなければなりません。

例えば、localhost(1234),remotehost1(1234),remotehost2 と指定します。

接続名リスト・プロパティーが指定された場合、ホスト名およびポートのプロパティーには自動的に接続名リストの最初のエントリーのホスト名とポート番号が設定されます。そのため、localhost(1234),remotehost1(1234),remotehost2 と指定した場合、ホスト名は localhost に設定され、ポートは 1234 に設定されます。

このプロパティーは、有効範囲のプロパティーにセルまたはクラスターが指定されている場合、あるいは有効範囲のプロパティーにノードまたはサーバーが指定されており、そのノードまたはサーバーが WebSphere Application Server 以降を実行している場合のみ使用可能です。

混合セル環境で使用する場合、接続名リスト・プロパティーの情報は、WebSphere Application Server のバージョン 8.0 より前のバージョンには使用できません。この場合、接続名リスト内の最初のエレメントに基づくホスト名フィールドとポート名フィールド内の情報が代わりに使用されます。

サーバー接続チャネル

WebSphere MQ に接続する際に使用される IBM MQ サーバー接続チャネル名。

通知	値
データ型	ストリング
デフォルト	SYSTEM.DEF.SVRCONN
範囲	この値は、接続しようとしている IBM MQ キュー・マネージャーに対して定義されているサーバー接続チャネルである必要があります。

IBM MQ との通信をセキュアにするために SSL を使用

このオプションは、IBM MQ キュー・マネージャーまたはキュー共用グループとのネットワーク通信をセキュアにするために、 SSL (Secure Sockets Layer) プロトコルを使用するかどうかを決定します。

アプリケーション・サーバー環境で IBM MQ メッセージング・プロバイダー・トピック接続ファクトリーを使用する場合、アプリケーション・サーバーは SSL 構成を管理します。SSL 構成パラメーターを変更するには、管理コンソールを使用して、「セキュリティー」 > 「SSL 証明書および鍵管理」パネルにナビゲートします。

クライアント環境で IBM MQ メッセージング・プロバイダー・トピック接続ファクトリーを使用する場合、クライアントは ssl.client.props ファイルから SSL 構成情報を取得します。このファイルの使用に関しては、このトピックの関連参照情報に詳細が記述されています。

IBM MQ メッセージング・プロバイダー・トピック接続ファクトリーには、SSL 構成内の 1 つの暗号スイートしか使用できません。複数の暗号スイートを指定しても、最初の暗号スイートしか使用されません。

通知	値
データ型	チェック・ボックス。このチェック・ボックスがクリアされていると、以下の SSL プロパティーは使用不可です。中央管理対象固有の構成 SSL 構成

中央管理対象

SSL プロトコルを IBM MQ との通信に使用する場合、このラジオ・ボタンを選択して、中央管理対象の WebSphere Application Server SSL 構成から SSL 構成を取得することを指定します。

このラジオ・ボタンを選択した場合、適切な SSL 構成を選択するために、IBM MQ メッセージング・プロバイダー接続ファクトリーのホスト名属性とポート属性が使用されます。接続名リストによってホストおよびポート情報が提供された場合、これは、適切な SSL 構成を選択するためにリスト内の最初のエレメントのホスト名およびポート情報が使用されることを意味します。接続ファクトリーに一致する SSL 構成を提供するには、『関連参照』の下にリストされている『動的アウトバウンド・エンドポイント SSL 構成設定』のトピックを参照してください。

通知	値
データ型	ラジオ・ボタン

固有の構成

IBM MQ キュー・マネージャーまたはキュー共用グループとのネットワーク通信をセキュアにするために SSL を使用していて、使用する特定の SSL 構成を指定する場合、このラジオ・ボタンを選択します。

通知	値
データ型	ラジオ・ボタン

SSL 構成

SSL を使用して IBM MQ キュー・マネージャーまたはキュー共有グループとのネットワーク通信をセキュアにする場合に使用する SSL 構成。

「中央管理対象」ラジオ・ボタンが選択されており、IBM MQ メッセージング・プロバイダー・リソースが明示的に定義されている場合、このプロパティーは使用不可になります。

IBM MQ メッセージング・プロバイダー・リソースが CCDT に基づいている場合、このプロパティーは常に使用可能です。

この IBM MQ メッセージング・プロバイダー・リソースが CCDT に基づいており、また、CCDT の関連エントリーが SSL を使用するように構成されている場合に限り、このパラメーターは使用されます。

また、SSL 構成が none に選択されていると、IBM MQ メッセージング・プロバイダーに対し、中央管理対象 WebSphere Application Server のデフォルトの SSL 構成が使用されます。

通知	値
データ型	ドロップダウン・リスト

拡張

クライアント ID

IBM MQ メッセージング・プロバイダーに接続するときに指定するクライアント ID。

通知	値
データ型	ストリング

クローン永続サブスクリプションを許可

異なるサーバーが永続サブスクリプションの複数インスタンスに同時にアクセスできるかどうかを決定するオプション。

通知	値
データ型	チェック・ボックス
デフォルト	クリア
範囲	選択異なるサーバーが永続サブスクリプションの複数インスタンスに同時にアクセスできます。クリア異なるサーバーが永続サブスクリプションの複数インスタンスに同時にアクセスすることはできません。

プロバイダー・バージョン

IBM MQ メッセージング・プロバイダーのバージョン。特定バージョンのキュー・マネージャーに接続するかどうかを判別するために、この情報を使用します。また、クライアントが必要とする機能のタイプを決定するためにも使用されます。

通知

値

データ型

ストリング

範囲

入力値は、空ストリングか、または次のいずれかの形式の値でなければなりません。

n.n.n.n
n.n.n
n.n
n

ここで、n はゼロ以上の数値です。

例えば、6.0.0.0 などです。

分散 2 フェーズ・コミット・プロトコルをサポート

トピック接続ファクトリーがメッセージング・トランザクションの XA 調整をサポートするかどうかを指定するオプション。複数のリソース (このトピック接続ファクトリーを含む) が同じトランザクションで使用される場合は、このオプションを使用可能に設定します。

このプロパティーをクリアすると、分散 2 フェーズ・コミット・プロトコルのサポートを使用不可にします。この場合、JMS セッションは引き続き、トランザクションに参加できますが、XA 呼び出しではなく、リソース・マネージャー・ローカル・トランザクション呼び出し session.commit および session.rollback を使用します。これによって、パフォーマンスが向上することがあります。ただし、WebSphere Application Server のトランザクションに参加させることができるリソースは、1 つのみになります。

最終参加者サポートを使用することにより、 1 つの非 XA リソースをその他の XA 可能リソースとともに参加させることができます。

通知	値
データ型	チェック・ボックス
デフォルト	選択
範囲	選択接続ファクトリーは、トランザクション処理の調整のために分散 2 フェーズ・コミット・プロトコルの使用をサポートします。クリア接続ファクトリーは、トランザクション処理の調整のために分散 2 フェーズ・コミット・プロトコルの使用をサポートしません。

トピック接続ファクトリーによって指定されたキュー・マネージャーがトランザクション内の唯一のリソースである場合は、XA を使用可能にしないでください。トランザクションが他のキューまたはトピックなど、他のリソースと関係している場合は、XA を使用可能に設定してください。

セキュリティー設定

XA リカバリーの認証別名

XA リカバリー時の IBM MQ への接続の際に使用するユーザー名とパスワード。

通知	値
データ型	ドロップダウン・リスト
デフォルト	(なし)
範囲	セルに定義されているすべての認証別名、および値「(なし)」 (この値は、XA リカバリー時にクレデンシャルが IBM MQ に渡されないことを指定します)。

マッピング構成別名

このフィールドは、コンポーネント・リソース参照のログイン構成が存在しない場合にのみ使用されます。

リソース権限の値が「container」である場合は、認証ストラテジーを定義する際に、ログイン構成とその関連プロパティーをコンポーネント・リソース参照に指定する方法が推奨されます。

DefaultPrincipalMapping ログイン構成を指定すると、関連のプロパティーは JAAS - J2C 認証データ入力別名になります。トピック接続ファクトリーと共に使用する認証情報を構成するには、「関連項目」で「JAAS - J2C 認証データ」をクリックします。

通知	値
データ型	ドロップダウン・リスト
デフォルト	(なし)
範囲	使用可能なオプションは次のとおりです。 ClientContainer WSLogin WSKRB5Login DefaultPrincipalMapping TrustedConnectionMapping KerberosMapping

コンテナー管理認証別名

IBM MQ メッセージング・プロバイダーへの接続の際に使用するユーザー名とパスワードを指定する、認証別名。

通知	値
データ型	ドロップダウン・リスト
デフォルト	(なし)
範囲	セルに定義されているすべての認証別名、および値「(なし)」 (この値は、クレデンシャルが IBM MQ に渡されないことを指定します)。

ファイル名: umj_ptcfm.html