アプリケーション・クライアントの WebSphere MQ プロバイダーのトピック接続ファクトリー設定

このパネルを使用して、WebSphere^® MQ 製品の Java™ Message Service (JMS) プロバイダーを使用するために選択されたトピック接続ファクトリーの構成プロパティーを表示または変更します。これらの構成プロパティーは、JMS プロバイダーと WebSphere MQ 間に接続を作成する方法を制御します。

この「アプリケーション・クライアント・リソース構成ツール (ACRCT)」ページを表示するには、「ファイル」>「オープン」とクリックします。EAR ファイルのブラウズ後、「オープン」をクリックします。選択した JAR ファイル >「メッセージング・プロバイダー (Messaging Providers)」>「WebSphere MQ プロバイダー (WebSphere MQ Provider)」と展開します。「Topic Connection Factories」を右マウス・ボタン・クリックして、「新規」をクリックします。

注:

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

MA0C ブローカー: WebSphere Application Server v6 トピック接続ファクトリーを作成する際には、次の属性値を考慮する必要があります。

BrokerControlQueue: この値は、MA0C ブローカーの SYSTEM.BROKER.CONTROL.QUEUE に固定されており、ブローカーが読み込むキューを示します。
BrokerVersion: この値を MA0C ブローカーの BASIC に設定します。
ClientID: この値は MA0C ブローカーの任意の値に設定します (値はストリングであり、ご使用のクライアント・アプリケーションの単なる ID です)。
XA 使用可能: この値を MA0C ブローカーの TRUE または FALSE に設定します (使用する設定はパフォーマンス向上フラグです。ほとんどの場合、この値を「true」に設定します)。
BrokerMessage Selection: ブローカーはクライアント側のメッセージ選択に依存するため、この値は、MA0C ブローカーの CLIENT に固定されています。
直接ブローカー許可タイプ: この値は MA0C ブローカーでは必要ありません。

WebSphere MQ 製品 JMS プロバイダーのトピック接続ファクトリーには、以下のプロパティーがあります。

名前

WebSphere Application Server 内での管理目的で使用する、このトピック接続ファクトリーを識別するための名前。この名前は、JMS プロバイダー内で固有でなければなりません。

データ型

ストリング

説明

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

データ型

ストリング

JNDI 名

トピック接続ファクトリーをアプリケーション・サーバーのネーム・スペースにバインドする際に使用される JNDI (Java Naming and Directory Interface) 名。

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

この名前は、プラットフォームのバインディング情報をリンクするために使用します。バインディングにより、モジュールのデプロイメント記述子で定義されているリソースと、プラットフォーム別に JNDI にバインドされている実際の (物理的な) リソースとの関連付けが行われます。

データ型	ストリング
単位	En_US ASCII 文字
範囲	1 から 45 の ASCII 文字

ユーザー ID

呼び出し側アプリケーションがユーザー ID とパスワードを明示的に提供しない場合に、認証用としてパスワード・プロパティーとともに使用されるユーザー ID です。

ユーザー ID プロパティーに値を指定する場合は、パスワード・プロパティーにも値を指定する必要があります。

接続ファクトリーのユーザー ID プロパティーとパスワード・プロパティーは、呼び出し側アプリケーションがユーザー ID とパスワードを明示的に提供しない場合に使用されます。例えば、呼び出し側アプリケーションがメソッド createTopicConnection() を使用する場合などです。 JMS クライアントは、ユーザー ID とパスワードを JMS サーバーに渡します。

データ型

ストリング

パスワード

呼び出し側アプリケーションがユーザー ID とパスワードを明示的に提供しない場合に、認証用としてユーザー ID とともに使用されるパスワード・プロパティーです。

ユーザー ID プロパティーに値を指定する場合は、パスワード・プロパティーにも値を指定する必要があります。

データ型

ストリング

再入力パスワード

パスワードを確認します。

キュー・マネージャー

この接続ファクトリー用の WebSphere MQ キュー・マネージャーの名前。この接続ファクトリーによって作成された接続は、このキュー・マネージャーに接続します。

データ型

ストリング

ホスト名およびポート情報を入力する (Enter Hostname and Port Information)

このラジオ・ボタンはデフォルトで選択されており、選択されている場合には、ホスト・プロパティーおよびポート・プロパティーが有効になり、接続名リスト・プロパティーは無効になります。

データ型	ラジオ・ボタン
デフォルト	選択

ホスト

クライアント接続専用で WebSphere MQ キュー・マネージャーが実行されているホストの名前。

データ型	ストリング
範囲	有効な TCP/IP ホスト名

ポート

WebSphere MQ キュー・マネージャーへの接続に使用される TCP/IP ポート番号 (クライアント接続の場合のみ)。

このポートは、WebSphere MQ キュー・マネージャー上で構成される必要があります。

データ型	整数
範囲	WebSphere MQ キュー・マネージャー上で構成された有効な TCP/IP ポート番号

接続名リスト情報を入力する (Enter Connection Name List Information)

このラジオ・ボタンが選択された場合、接続名リスト・プロパティーが有効になり、ホスト・プロパティーおよびポート名プロパティーが無効になります。複数インスタンス・キュー・マネージャーに接続する場合に、このラジオ・ボタンを選択してください。

データ型	ラジオ・ボタン
デフォルト	クリア

接続名リスト

複数インスタンス・キュー・マネージャーへの接続に使用されるホストおよびポートの情報のコンマ区切りリスト。

リストの形式は次のとおりです。

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

ここで、ポートはオプションで、設定されていない場合、デフォルトで 1414 になります。以下に例を示します。

hostname1,hostname2(1415)

複数インスタンス・キュー・マネージャーについて詳しくは、WebSphere MQ インフォメーション・センターを参照してください。

このプロパティーは、複数インスタンス・キュー・マネージャーに接続する場合にのみ使用してください。トランザクションの整合性に問題を引き起こす恐れがあるため、このプロパティーを個別のキュー・マネージャーのリストへの接続に使用することはできません。

チャネル

クライアント接続専用で WebSphere MQ キュー・マネージャーへの接続に使用されるチャネルの名前。

データ型	ストリング
範囲	1 から 20 文字の ASCII 文字

トランスポート・タイプ

WebSphere MQ クライアント接続または JNDI バインディングが、WebSphere MQ キュー・マネージャーとの接続に使用されるかどうか。

データ型	列挙型
デフォルト	BINDINGS
範囲	CLIENT WebSphere MQ クライアント接続を使用して WebSphere MQ キュー・マネージャーに接続します。 BINDINGS JNDI バインディングは、WebSphere MQ キュー・マネージャーに接続するために使用されます。

クライアント ID

WebSphere MQ キュー・マネージャーへの接続に使用される JMS クライアント ID。

データ型

ストリング

CCSID

WebSphere MQ キュー・マネージャーで使用するコード化文字セット ID。

このコード化文字セット ID (CCSID) は、WebSphere MQ でサポートされている CCSID のいずれかである必要があります。詳しくは、トピック接続ファクトリーのプロパティーを参照してください。

データ型	ストリング
単位	整数
範囲	1 から 65535

ブローカー・コントロール・キュー

すべてのコマンド・メッセージの送信先となる (パブリケーションおよびパブリケーションの削除要求は除く) ブローカー・コントロール・キューの名前。

データ型	ストリング
単位	En_US ASCII 文字
範囲	1 から 48 文字の ASCII 文字

ブローカー・キュー・マネージャー

Publisher および Subscriber メッセージ・ブローカーを提供する WebSphere MQ キュー・マネージャーの名前。

データ型	ストリング
単位	En_US ASCII 文字
範囲	1 から 48 文字の ASCII 文字

ブローカー・パブリッシュ・キュー

デフォルト・ストリームのすべてのパブリケーション・メッセージを受信するブローカーの入力キューの名前。

デフォルト・ストリームのすべてのパブリケーション・メッセージを受信するブローカーの入力キュー (ストリーム・キュー) の名前。アプリケーションは、このキューに対して、デフォルト・ストリーム上のパブリケーションの削除要求を送信することもできます。

データ型	ストリング
単位	En_US ASCII 文字
範囲	1 から 48 文字の ASCII 文字

ブローカー・サブスクリプション・キュー

耐久性のないサブスクリプション・メッセージの検索元となるブローカー・キューの名前。

耐久性のないサブスクリプション・メッセージの検索元となるブローカー・キューの名前。サブスクライバーは、サブスクリプションの登録時にキューの名前を指定します。

データ型	ストリング
単位	En_US ASCII 文字
範囲	1 から 48 文字の ASCII 文字

ブローカー CCSubQ

ConnectionConsumer 要求の耐久性のないサブスクリプション・メッセージの検索元となるブローカー・キューの名前。このプロパティーは、Web コンテナーを使用する場合にのみ適用されます。

データ型	ストリング
単位	En_US ASCII 文字
範囲	1 から 48 文字の ASCII 文字

ブローカー・バージョン

メッセージ・ブローカーを WebSphere MQ MA0C SupportPac™ によって提供するか、またはより新しいバージョンの WebSphere ファミリーのメッセージ・ブローカー製品によって提供するか。

データ型	列挙型
デフォルト	拡張
範囲	拡張メッセージ・ブローカーを、WebSphere ファミリーのメッセージ・ブローカー製品 (MQ Integrator および MQ Publish and Subscribe) のより新しいバージョンから提供します。基本メッセージ・ブローカーを WebSphere MQ MA0C Supportpac (WebSphere MQ - Publish および Subscribe) によって提供します。

クリーンアップ・レベル

パブリッシュまたはサブスクライブのクリーンアップ・ユーティリティーにより提供されるクリーンアップのレベル。

データ型

列挙型

デフォルト

SAFE

範囲

ASPROP
NONE

STRONG

クリーンアップ間隔

パブリッシュ/サブスクライブ・クリーンアップ・ユーティリティーのバックグラウンド実行の間隔 (ミリ秒)。

データ型	整数
単位	ミリ秒
デフォルト	6000

メッセージの選択

ブローカー・メッセージを選択する場所。

データ型

列挙型

デフォルト

BROKER

範囲

BROKER: メッセージ選択はブローカー・ロケーションで行います。

Message CLIENT: メッセージ選択はクライアント・ロケーションで行います。

パブリッシュ肯定応答間隔

ブローカーからの肯定応答が必要なパブリッシュ要求間の間隔 (メッセージ数)。

データ型	整数
デフォルト	25

疎サブスクリプション

疎サブスクリプションを使用可能にします。

データ型	チェック・ボックス
デフォルト	クリア

状況のリフレッシュ間隔

パブリッシュまたはサブスクライブの状況をリフレッシュするトランザクションの間隔 (ミリ秒) です。

データ型	整数
デフォルト	6000

サブスクリプションの保管

WebSphere MQ が、アクティブな JMS サブスクリプションに関するデータを保存する場所。

データ型

列挙型

デフォルト

MIGRATE

範囲

MIGRATE

QUEUE

BROKER

マルチキャスト

この接続ファクトリーがマルチキャスト・トランスポートを使用するかどうか。

データ型

列挙型

デフォルト

NOT USED

範囲

NOT USED: この接続ファクトリーは、マルチキャスト・トランスポートを使用しません。

ENABLED: この接続ファクトリーは常にマルチキャスト・トランスポートを使用します。

ENABLED_IF_AVAILABLE: この接続ファクトリーはマルチキャスト・トランスポートを使用します。

ENABLED_RELIABLE: この接続ファクトリーは、信頼性のあるマルチキャスト・トランスポートを使用します。

ENABLED_RELIABLE_IF_AVAILABLE: この接続ファクトリーは使用可能であれば、信頼性の高いマルチキャスト・トランスポートを使用します。

直接認証

ダイレクト・ブローカー権限を使用するかどうか。

データ型

列挙型

デフォルト

NONE

範囲

NONE: ダイレクト・ブローカー権限は使用しません。

PASSWORD: ダイレクト・ブローカー権限はパスワードで認証されます。

CERTIFICATE: ダイレクト・ブローカー権限は証明書で認証されます。

プロキシー・ホスト名

WebSphere MQ との通信に使用されるプロキシーのホスト名。

データ型

ストリング

プロキシー・ポート

WebSphere MQ との通信に使用されるプロキシーのポート番号。

データ型	整数
デフォルト	0

静止の場合に失敗

キュー・マネージャーが制御された失敗状態になった場合に、アプリケーションがメソッド呼び出しから戻されるかどうか。

データ型	チェック・ボックス
デフォルト	選択

ローカル・サーバー・アドレス

ローカル・サーバー・アドレス。

データ型

ストリング

ポーリング間隔

非同期メッセージの配信中のすべての受信側のスキャンの間隔 (ミリ秒)。

データ型	整数
単位	ミリ秒
デフォルト	5000

再スキャン間隔

トピックに順不同で追加されたメッセージを探すために、トピックをスキャンする間隔 (ミリ秒)。

再スキャン間隔は、トピックに順不同で追加されたメッセージの WebSphere MQ ブラウズ・カーソルを考慮したスキャンを制御します。

データ型	整数
単位	ミリ秒
デフォルト	5000

SSL 暗号スイート

WebSphere MQ への SSL 接続に使用する暗号スイートです。

このプロパティーは、ご使用の JSSE プロバイダーで提供されている有効な暗号スイートに設定してください。この値は SVRCONN チャネル (「チャネル」プロパティー) で指定された CipherSpec と一致していなければなりません。

「SSL ピア名」プロパティーを設定する場合は、このプロパティーを設定する必要があります。

SSL 証明書ストア

SSL 証明書の失効をチェックするために使用される、ゼロ個以上の証明書取り消しリスト (CRL) サーバーのリスト。このプロパティーに値を指定する場合は、Java 2 バージョン 1.4 の WebSphere MQ JVM を使用する必要があります。

この値は、スペースで区切られた項目のリストで、次のような形式になります。

ldap://hostname:[port]

シングル・スラッシュ (/) がこの値に続きます。port を省略した場合は、デフォルトの LDAP ポートである 389 が想定されます。接続時に、サーバーから提示された SSL 証明書が、指定された CRL サーバーと照合されます。 CRL セキュリティーについて詳しくは、WebSphere MQ インフォメーション・センターの『セキュリティー』セクションにある「証明書取り消しリストの使用」を参照してください。

SSL ピア名

SSL の場合は、識別名のスケルトンです。これは、WebSphere MQ キュー・マネージャーによって提供された名前に一致していなければなりません。この識別名は、接続時にサーバーによって提示された識別証明書を検査するために使用されます。

このプロパティーが設定されていない場合、このような証明書の検査が行われます。

「SSL 暗号スイート」プロパティーが指定されていない場合は、SSL ピア名プロパティーは無視されます。

このプロパティーは、コンマまたはセミコロンで区切られた、属性名と値の対のリストです。以下に例を示します。

CN=QMGR.*, OU=IBM, OU=WEBSPHERE

この例の場合、接続時にサーバーによって提示された識別証明書が検査されます。正常に接続するためには、証明書は QMGR で始まり、少なくとも 2 つの組織単位名 (最初が IBM、 2 つ目が WEBSPHERE) で構成される共通名を持っていなければなりません。検査では、大/小文字が区別されません。

識別名および WebSphere MQ での識別名の使用方法について詳しくは、WebSphere MQ インフォメーション・センターの『セキュリティー』セクションにある「識別名」を参照してください。

接続プール

接続プール設定のオプション・セット。

接続プール・プロパティーは、すべての J2C コネクターに共通です。

アプリケーション・サーバーは、JMS プロバイダーとの接続とセッションをプールすることで、パフォーマンスを向上させます。これは、WebSphere MQ 接続プールとは無関係です。アプリケーションの接続とセッションのプール・プロパティーを適切に構成する必要があります。構成が適切でないと、接続とセッションが正しく動作しない場合があります。

JMS リソースへのサーバー・サイド・アクセスが並行して行われ、それがデフォルト値を超える場合は、接続プールのサイズを変更してください。接続プールのサイズは、キューごと、あるいはトピックごとに設定されます。

データ型	チェック・ボックス
デフォルト	選択

クライアント再接続オプション (Client Reconnect Options)

コミュニケーション・マネージャーまたはキュー・マネージャーで障害が発生したときに、クライアント・モード接続を自動で再接続するかどうかを指定します。シン・クライアント環境または管理対象クライアント環境で接続ファクトリーが使用されていない限り、このプロパティーは無視されます。

データ型	ドロップダウン・リスト
デフォルト	DISABLED
範囲	DISABLED クライアントは自動で再接続しません。 ASDEF クライアント構成ファイルのチャネル・スタンザで設定する DefRecon 属性からの値を使用します。 DefRecon 値が指定されていない場合、この設定は DISABLED の値と同じ効果があります。 RECONNECT キュー・マネージャー属性の値と一致する任意のキュー・マネージャーに再接続します。最初に接続が確立されていたキュー・マネージャーと異なるキュー・マネージャーに再接続される可能性もあります。 QMGR 最初に接続が確立されていたキュー・マネージャーにのみ再接続されます。

自動クライアント再接続について詳しくは、WebSphere MQ インフォメーション・センターを参照してください。

クライアント再接続タイムアウト

通信障害またはキュー・マネージャーの障害発生後、クライアント・モード接続がキュー・マネージャーへの自動再接続の試行に費やす最大時間 (秒単位)。シン・クライアント環境または管理対象クライアント環境で接続ファクトリーが使用されていない限り、このパラメーターは無視されます。このパラメーターが使用されるかどうかは、クライアント再接続オプションのパラメーターの値によって異なります。

データ型	整数
単位	秒
デフォルト	1800
範囲	ゼロより大きく 2147483647 以下の値。

自動クライアント再接続について詳しくは、WebSphere MQ インフォメーション・センターを参照してください。

マーク付きのリンク (オンライン) では、インターネットにアクセスする必要があります。

ファイル名: ucli_ptcfm.html