IBM MQ メッセージング・プロバイダー・アクティベーション・スペック設定

このパネルを使用して、WebSphere® MQ メッセージング・プロバイダーで使用する選択済みのアクティベーション・スペックの構成プロパティーを表示または変更します。これらの構成プロパティーは、関連するキューおよびトピックへの接続を作成する方法を制御します。

IBM MQ のアクティベーション・スペック設定を表示するには、管理コンソールを使用して以下のステップを実行します。

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

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

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

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

「拡張プロパティー (Advanced properties)」。これをクリックすると、IBM MQ アクティベーション・スペックの拡張プロパティーを表示または変更できます。
「ブローカー・プロパティー (Broker properties)」。これをクリックすると、IBM MQ アクティベーション・スペックのブローカー・プロパティーを表示または変更できます。
「カスタム・プロパティー (Custom properties)」。これをクリックすると、 IBM MQ アクティベーション・スペックのカスタム・プロパティーを表示または変更できます。例えば、このオプションを使用してアクティベーション・スペックのためのカスタム・プロパティー WAS_EndpointInitialState を設定します。 WAS_EndpointInitialState によって、アクティベーション・スペックを使用してメッセージ駆動型 Bean が宛先に接続し次第、JMS 宛先からメッセージのコンシュームを開始するかどうかが決まります。
「クライアント・トランスポート・プロパティー (Client transport properties)」。これをクリックすると、IBM MQ アクティベーション・スペックのクライアント・トランスポート・プロパティーを表示または変更できます。選択したアクティベーション・スペックがクライアント・チャネル定義テーブル (CCDT) を使用して作成されたものでない場合は、このリンクに従って、IBM MQへの接続に必要なすべての情報を入力してください。選択したアクティベーション・スペックが CCDT を使用して作成されたものである場合は、クライアント・トランスポート・プロパティーを指定する必要がないので、このリンクは表示されません。

「関連項目」で、「JAAS - J2C 認証データ」をクリックして、当該アクティベーション・スペック用の認証情報を構成することができます。

createWMQActivationSpec IBM MQ 管理コマンドを使用して、-localAddress プロパティーを指定できます。

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

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

この IBM MQ メッセージング・プロバイダー・リソースに影響を及ぼす有効範囲で IBM MQ 機能が使用不可になった場合には、 IBM MQ が使用不可になったことを示す通知メッセージが表示されます。単一サーバー環境では、この通知メッセージは、IBM MQ 機能が使用不可になった後でサーバーを再始動したときにはじめて表示されます。Network Deployment 環境では、通知メッセージは即時に表示されます。詳しくは、WebSphere Application Server の IBM MQ 機能を使用不可にするを参照してください。

IBM MQ アクティベーション・スペックには、以下のプロパティーがあります。

管理

有効範囲

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

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

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

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

プロバイダー

アクティベーション・スペックの作成時に割り当てられた JMS プロバイダー。

このパネルを使用して作成されたすべてのアクティベーション・スペックの場合、プロバイダーは IBM MQ メッセージング・プロバイダーです。

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

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

名前

WebSphere Application Server 内で、このアクティベーション・スペックを管理目的で使用する際の名前。

通知	値
データ型	ストリング
範囲	この名前は、セルに対して定義されたアクティベーション・スペックのセット内で固有でなければなりません。

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 インフォメーション・センターの「IBM MQ Java の使用」セクションの『SSL プロパティー』を参照してください。

注: IBM MQ メッセージング・プロバイダーによって使用される IBM MQ リソース・アダプターの構成に使用する IBM MQ 接続プロパティーは、4 つあります。これらのプロパティーは、アクティベーション・スペックが使用する次の接続プールに影響を与えます。

maxConnections
connectionConcurrency(このプロパティーの設定は、WebSphere Application Server 7 ノードにのみ影響します。このプロパティーは、WebSphere Application Server バージョン 8 以降のノードには影響しません。)
reconnectionRetryCount
reconnectionRetryInterval

これらの 4 つのプロパティーとその構成方法について詳しくは、リソース・アダプターのプロパティーを参照してください。

クライアント・チャネル定義テーブル 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 キュー・マネージャーと通信します。バインディングの次にクライアントキュー・マネージャーへのバインディング・モード接続を試みます。これが可能でなければ、クライアント・トランスポートに戻ります。バインディング同じノードで実行されているキュー・マネージャーへの仮想記憶間接続を確立します。以下の「クライアント・トランスポート・モード」プロパティーは使用不可です。ホスト名ポート接続名リストサーバー接続チャネルトランスポート・タイプ「`バインディングとクライアント (Bindings, then client)`」または「`バインディング (Bindings)`」の構成について詳しくは、ネイティブ・ライブラリー情報を持つ 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 バージョン 8.0 以降を実行している場合のみ使用可能です。

混合セル環境で使用する場合、クラスターまたはセルの有効範囲のアクティベーション・スペックに対する接続名リスト・プロパティーの情報が WebSphere Application Server バージョン 7.0 ノードに使用可能です。具体的な振る舞いは、ノードのフィックスパックのレベルによります。

WebSphere Application Server バージョン 7.0 フィックスパック 7 以降のフィックスパック・レベルで実行するノードでは、接続名リスト・プロパティーを使用して、マルチインスタンス・キュー・マネージャーに接続できます。
バージョン 7.0 より前のフィックスパック・レベルで実行するノードの場合、接続名リスト・プロパティーは認識されず、次の例のような警告メッセージが出力されます。
```
[29/09/10 12:15:27:468 BST] 00000018 J2CUtilityCla W   J2CA0008W: Class com.ibm.mq.connector.inbound.ActivationSpecImpl used by resource cells/L3A3316Node01Cell/resources.xml#J2CResourceAdapter_1284547647859 did not contain method setConnectionNameList. Processing continued.
```
この場合、ホスト名およびポート・プロパティーの情報を使用して、キュー・マネージャーに接続されます。

サーバー接続チャネル

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

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

IBM MQ とセキュアに通信する SSL の使用 (Use SSL to secure communications with IBM MQ)

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

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

IBM MQ メッセージング・プロバイダー・アクティベーション・スペックの SSL 構成で使用できる暗号スイートは 1 つのみです。暗号スイートを複数指定した場合は、最初の暗号スイートのみが使用されます。

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

中央管理対象

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

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

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

固有の構成

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

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

SSL 構成

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

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

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

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

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

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

宛先

注: プロパティー WAS_EndpointInitialState はカスタム・プロパティーです。このプロパティーは、アクティベーション・スペックを使用してメッセージ駆動型 Bean が宛先に接続し次第、JMS 宛先からメッセージのコンシュームを開始するかどうかを決定します。カスタム・プロパティーを設定するには、この目次ペインで変更を完了し、「適用 (Apply)」をクリックして構成を保存してから、目次ペインの「追加プロパティー (Additional Properties)」の下にある「カスタム・プロパティー (Custom properties)」リンクをクリックします。

宛先 JNDI 名

このアクティベーション・スペックを使用するように構成されるメッセージ駆動型 Bean (MDB) への配信のためのメッセージがコンシュームされる元の JMS 宛先を表す JNDI 名。

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

メッセージ・セレクター

送信されるメッセージを指定するメッセージ・セレクター式。

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

宛先タイプ

メッセージのコンシューム元の宛先 (キューまたはトピック) のタイプ。

通知	値
データ型	ドロップダウン・リスト
範囲	キュー「宛先 JNDI 名 (Destination JNDI name)」は、キューである JMS 宛先を参照します。トピック「宛先 JNDI 名 (Destination JNDI name)」は、トピックである JMS 宛先を参照します。

永続サブスクリプション

このトピックへサブスクライブする MDB へのメッセージ配信に、永続サブスクリプションが使用されるか、非永続サブスクリプションが使用されるかどうかを指定するオプション。

通知	値
データ型	チェック・ボックス
デフォルト	クリア (非永続)
範囲	クリア非永続選択永続

サブスクリプション名

永続サブスクリプションの名前。これは、「永続サブスクリプション (Durable subscription)」チェック・ボックスを選択した場合にのみ使用可能です。

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

拡張

クライアント ID

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

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

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

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

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

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

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

通知

値

データ型

ストリング

範囲

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

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

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

例えば、6.0.0.0 などです。

セキュリティー設定

認証別名

IBM MQ に接続する際に使用するユーザー名とパスワード。

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

ファイル名: umj_pasm.html