IBM MQ メッセージング・プロバイダー・アクティベーション・スペック設定
このパネルを使用して、IBM MQ メッセージング・プロバイダーで使用する選択済みのアクティベーション・スペックの構成プロパティーを表示または変更します。 これらの構成プロパティーは、関連するキューおよびトピックへの接続を作成する方法を制御します。
- ナビゲーション・ペインで、「」をクリックして、既存のアクティベーション・スペックを表示します。
- 適宜、目次ペインで、「有効範囲」設定を、アクティベーション・スペックが定義されているレベルに変更します。 これにより、表示されるアクティベーション・スペックのセットが制限されます。
- 作業の対象となるアクティベーション・スペックの名前を選択します。
- 「拡張プロパティー (Advanced properties)」。これをクリックすると、IBM MQ アクティベーション・スペックの拡張プロパティーを表示または変更できます。
- 「ブローカー・プロパティー (Broker properties)」。これをクリックすると、IBM MQ アクティベーション・スペックのブローカー・プロパティーを表示または変更できます。
- 「カスタム・プロパティー」。これをクリックすると、 IBM MQ アクティベーション・スペックのカスタム・プロパティーを表示または変更できます。 例えば、このオプションを使用してアクティベーション・スペックのためのカスタム・プロパティー WAS_EndpointInitialState を設定します。 WAS_EndpointInitialState によって、アクティベーション・スペックを使用して メッセージ駆動型 Bean が宛先に接続し次第、JMS 宛先からメッセージのコンシュームを 開始するかどうかが決まります。
- 「クライアント・トランスポート・プロパティー」。これは、IBM MQ アクティベーション・スペック のクライアント・トランスポート・プロパティーを表示または変更するときに使用します。 選択したアクティベーション・スペックがクライアント・チャネル定義テーブル (CCDT) を使用して作成されたものでない場合は、このリンクを介して、IBM MQ へ接続するために必要なすべての情報を入力してください。選択したアクティベーション・スペックが CCDT を使用して作成されたものである場合は、クライアント・トランスポート・プロパティーを指定する必要がないので、このリンクは表示されません。
「関連項目」で、「JAAS - J2C 認証データ」をクリックして、当該アクティベーション・スペック用の認証情報を構成することができます。
また、createWMQActivationSpec IBM MQ 管理コマンドを使用して、-localAddress プロパティーを指定することもできます。
- 名前には最大 48 文字を使用できます。ただし、チャネルは例外で、最大 20 文字となります。
- 指定するプロパティー値は、 IBM MQ の JMS リソースを構成する際に指定した値と一致していなければなりません。詳しくは、IBM MQ インフォメーション・センターの『Java の使用』および『システム管理』セクションを参照してください。
IBM MQ 機能が、この IBM MQ メッセージング・プロバイダー・リソースに影響を及ぼす有効範囲で無効になっている場合は、IBM MQ が無効になっていることを示す通知メッセージが表示されます。単一サーバー環境では、この通知メッセージは、IBM MQ 機能が無効になった後でサーバーが再始動されたときにのみ表示されます。 Network Deployment 環境では、即時に通知メッセージが表示されます。
IBM MQ アクティベーション・スペックには、以下のプロパティーがあります。
管理
有効範囲
このリソース定義がアプリケーションに対して可視であるレベル。
メッセージング・プロバイダー、名前空間バインディング、または共有ライブラリーなどのリソースを複数の有効範囲で定義することが可能です。より限定的な有効範囲で定義されたリソースは、それより広い有効範囲で定義された重複するリソースをオーバーライドします。
表示された有効範囲は情報のためだけです。このパネルで変更することはできません。 異なる有効範囲でこのリソース (またはその他のリソース) を参照または変更する場合は、IBM MQ アクティベーション・スペック・コレクション・パネルで有効範囲を変更し、「適用」をクリックしてから、そのリソース・タイプのリンクをクリックします。
通知 | 値 |
---|---|
データ型 | ストリング |
プロバイダー
アクティベーション・スペックの作成時に割り当てられた JMS プロバイダー。
このパネルを使用して作成されたすべてのアクティベーション・スペックの場合、プロバイダーは IBM MQ メッセージング・プロバイダーです。
プロバイダーは情報提供のためだけに表示されます。
通知 | 値 |
---|---|
データ型 | ストリング |
名前
WebSphere Application Server 内で、このアクティベーション・スペックを管理目的で使用する際の名前。
通知 | 値 |
---|---|
データ型 | ストリング |
範囲 | この名前は、セルに対して定義されたアクティベーション・スペックのセット内で固有でなければなりません。 |
JNDI 名
JNDI ネーム・スペースにアクティベーション・スペックをバインドするために使用される JNDI 名。
規則として、完全修飾の JNDI 名を使用します。 例えば、jms/Name の形式です。ここで、Name はリソースの論理名です。
通知 | 値 |
---|---|
データ型 | ストリング |
説明
WebSphere Application Server 内で管理目的で使用する、このアクティベーション・スペックの説明。
通知 | 値 |
---|---|
データ型 | ストリング |
デフォルト | Null |
接続
接続の構成に必要な情報は、選択したアクティベーション・スペックがクライアント・チャネル定義テーブル (CCDT) を使用して作成されたものであるかどうかによって異なります。
- クライアント・チャネル定義テーブル URL
- キュー・マネージャー
- SSL 構成
- キュー・マネージャー
- トランスポート
- 「ホストおよびポート情報を、ホストとポート値が分離された形式で入力する」が選択された場合、接続名リスト・プロパティーは使用できず以下のプロパティーを使用できます。
- ホスト名
- Port
- 「ホストおよびポート情報を、接続名リストの形式で入力 (Enter host and port information in the form of a connection name list)」が選択された場合、接続名リスト・プロパティーは使用できますが、以下のプロパティーは使用できません。
- ホスト名
- Port
- サーバー接続チャネル
- 「IBM MQ との通信をセキュアにするために SSL を使用」プロパティーのチェック・ボックスをクリアした場合は、以下のプロパティーを使用することはできません。
- 中央管理対象
- 固有の構成
- SSL 構成
IBM MQ の SSL プロパティーの設定について詳しくは、IBM MQ インフォメーション・センターの『IBM MQJava の使用』セクションにある『SSL プロパティー』を参照してください。
- maxConnections
- connectionConcurrency(このプロパティーを設定すると、WebSphere Application Server 7 のノードのみに影響します。このプロパティーは、WebSphere Application Server バージョン 8 以降のノードには影響しません。)
- reconnectionRetryCount
- reconnectionRetryInterval
クライアント・チャネル定義テーブル URL
IBM MQ CCDT のロケーションを指定する URL。
通知 | 値 |
---|---|
データ型 | ストリング |
キュー・マネージャー
指定されたアクティベーション・スペックが CCDT に基づいて作成されたものである場合、このプロパティーはその CCDT 内のエントリーを選択するために使用されます。 それ以外の場合、このプロパティーは、接続先のキュー・マネージャーまたはキュー共有グループの名前を指定します。指定された IBM MQ リソースへの接続が確立されて、メッセージの受信が行われます。
通知 | 値 |
---|---|
データ型 | ストリング |
範囲 | このアクティベーション・スペックが CCDT に基づいて作成されたものでない場合、値は有効なキュー・マネージャー名でなければなりません。
このアクティベーション・スペックが CCDT に基づいて作成されたものである場合、値は次のいずれかでなければなりません。
指定された接続ファクトリーが CCDT に基づいて作成されたものであり、その CCDT が複数のキュー・マネージャーから選択可能である場合、グローバル・トランザクションをリカバリーできない場合があります。
そのため、CCDT を指定する接続ファクトリーには、以下の 2 つの代替方法があります。
|
トランスポート
接続用の 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 のアドレス。
通知 | 値 |
---|---|
データ型 | ストリング |
Port
IBM MQ が listen するポート番号。
通知 | 値 |
---|---|
データ型 | 整数 |
デフォルト | 1414 |
範囲 | 値は 1 から 65536 の範囲内の値でなければなりません。 |
接続名リストの形式でホストおよびポート情報を入力 (Enter host and port information in the form of a connection name list)
このラジオ・ボタンを選択すると、IBM MQ キュー・マネージャーへの接続は、接続名リスト・プロパティーによって提供された情報を使用して行われます。
接続名リストは、単一のキュー・マネージャーまたはマルチインスタンスのキュー・マネージャーへの接続に使用できます。 マルチインスタンス・キュー・マネージャーの使用について詳しくは、IBM MQ インフォメーション・センターを参照してください。このオプションを選択すると、接続名リスト・プロパティーが使用可能になり、ホスト名およびポートのプロパティーが使用不可になります。 分離されたホストおよびポート情報を入力するには、「ホストおよびポート情報を、ホストとポート値が分離された形式で入力する」をクリックします。
このラジオ・ボタンは、有効範囲のプロパティーにセルまたはクラスターが指定されている場合、 あるいは有効範囲のプロパティーにノードまたはサーバーが指定されており、そのノードまたは サーバーが WebSphere Application Server バージョン 8.0 以降を実行している場合のみ使用可能です。
通知 | 値 |
---|---|
データ型 | ラジオ・ボタン |
接続名リスト
アクティベーション・スペックをマルチ・インスタンスのキュー・マネージャーに接続する場合に、使用するホスト名とポートの詳細を指定する接続名リスト。
このプロパティーは、マルチインスタンス・キュー・マネージャーへの接続を許可するためにのみ使用する必要があります。マルチ・インスタンスではないキュー・マネージャーに接続できるようにするために使用してはなりません。トランザクション整合性の問題を引き起こす可能性があるからです。
通知 | 値 |
---|---|
データ型 | ストリング |
デフォルト | 設定なし |
範囲 | このフィールドには以下の形式でストリングを設定しなければなりません。 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 フィックスパック 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 を使用
このオプションは、IBM MQ キュー・マネージャーまたはキュー共有グループとのネットワーク通信をセキュアにするために、 SSL (Secure Sockets Layer) プロトコルを使用するかどうかを決定します。
アプリケーション・サーバー環境で IBM MQ メッセージング・プロバイダー・アクティベーション・スペックを使用する場合、アプリケーション・サーバーが SSL 構成を管理します。SSL 構成パラメーターを変更するには、管理コンソールを使用して、 パネルに移動します。
IBM MQ メッセージング・プロバイダー・アクティベーション・スペックの SSL 構成で使用できる暗号スイートは 1 つのみです。暗号スイートを複数指定した場合は、最初の暗号スイートのみが使用されます。
通知 | 値 |
---|---|
データ型 | チェック・ボックス。
このチェック・ボックスがクリアされていると、以下の 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 に基づいていると、このパラメーターは、SSL を使用するようにその CCDT 内の関連エントリーが構成されている場合にのみ使用されます。
また、SSL 構成の none が選択されていると、IBM MQ メッセージング・プロバイダーに対し、中央管理対象 WebSphere Application Server のデフォルトの SSL 構成が使用されます。
通知 | 値 |
---|---|
データ型 | ドロップダウン・リスト |
宛先
宛先 JNDI 名
このアクティベーション・スペックを使用するように構成されるメッセージ駆動型 Bean (MDB) への配信のためのメッセージがコンシュームされる元の JMS 宛先を表す JNDI 名。
通知 | 値 |
---|---|
データ型 | ストリング |
メッセージ・セレクター
送信されるメッセージを指定するメッセージ・セレクター式。
通知 | 値 |
---|---|
データ型 | ストリング |
宛先タイプ
メッセージのコンシューム元の宛先 (キューまたはトピック) のタイプ。
通知 | 値 |
---|---|
データ型 | ドロップダウン・リスト |
範囲 |
|
永続サブスクリプション
このトピックへサブスクライブする MDB へのメッセージ配信に、永続サブスクリプションが使用されるか、非永続サブスクリプションが使用されるかどうかを指定するオプション。
通知 | 値 |
---|---|
データ型 | チェック・ボックス |
デフォルト | クリア (非永続) |
範囲 |
|
サブスクリプション名
永続サブスクリプションの名前。 これは、「永続サブスクリプション (Durable subscription)」チェック・ボックスを選択した場合にのみ使用可能です。
通知 | 値 |
---|---|
データ型 | ストリング |
拡張
クライアント ID
IBM MQ メッセージング・プロバイダーに接続するときに指定するクライアント ID。
通知 | 値 |
---|---|
データ型 | ストリング |
クローン永続サブスクリプションを許可
異なるサーバーが永続サブスクリプションの複数インスタンスに同時にアクセスできるかどうかを決定するオプション。
通知 | 値 |
---|---|
データ型 | チェック・ボックス |
デフォルト | クリア |
範囲 |
|
プロバイダー・バージョン
IBM MQ メッセージング・プロバイダー・バージョン。これは、キュー・マネージャーの特定のバージョンに接続するかどうかを決定するために使用されます。 また、クライアントが必要とする機能のタイプを決定するためにも使用されます。
通知 | 値 |
---|---|
データ型 | ストリング |
範囲 | 入力値は、空ストリングか、または次のいずれかの形式の値でなければなりません。
例えば、6.0.0.0 などです。 |
セキュリティー設定
認証別名
IBM MQ への接続の際に使用するユーザー名とパスワード。
通知 | 値 |
---|---|
データ型 | ドロップダウン・リスト |
デフォルト | (なし) |
範囲 | セルに対して定義されたすべての認証別名と、クレデンシャルを IBM MQ に渡さないことを指定する値「(なし)」。 |