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

名前

WebSphere Application Server 内で、このキュー接続ファクトリーを管理目的で使用する際の名前。 この名前は、WebSphere 管理ドメイン全体の JMS 接続ファクトリー内で固有でなければなりません。

データ型

ストリング

説明

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

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

JNDI 名

アプリケーション・クライアント・ランタイムは、 このフィールドを使用して構成情報を検索します。

ユーザー ID

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

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

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

データ型

ストリング

パスワード

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

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

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

再入力パスワード

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

キュー・マネージャー

この接続ファクトリー用の WebSphere MQ キュー・マネージャーの名前。

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

データ型

ストリング

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

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

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

ホスト

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

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

ポート

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

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

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

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

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

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

接続名リスト

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

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

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

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

hostname1,hostname2(1415)

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

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

チャネル

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

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

トランスポート・タイプ

WebSphere MQ キュー・マネージャーとの接続に、WebSphere MQ クライアント接続を使用するか、JNDI バインディングを使用するかを指定します。外部の JMS プロバイダーは、JMS クライアントと JMS サーバーとの間の通信プロトコルを制御します。非 ASF の、非永続的で耐久性のない非トランザクション・メッセージングを使用しているか、またはセキュリティー問題に対処したい場合で、クライアントがキュー・マネージャー・ノードに対してローカルのときは、トランスポート・タイプを調整してください。

データ型	列挙型
単位	該当なし
デフォルト	BINDINGS
範囲	BINDINGS JNDI バインディングは、キュー・マネージャーに 接続するために使用されます。BINDINGS は共用メモリー・プロトコルです。 BINDINGS は、キュー・マネージャーが JMS クライアントと同じノードにあり、EJB 役割を使用して処理する必要のあるセキュリティー・リスクを見つけた場合にのみ使用できます。 CLIENT WebSphere MQ クライアント接続を使用してキュー・マネージャーに接続します。CLIENT は典型的な TCP ベースのプロトコルです。 DIRECT DIRECT モードを使用する WebSphere MQ Event Broker 用です。DIRECT は軽量のソケット・プロトコルであり、非トランザクション的で、 耐久性がなく、非永続的なパブリッシュ/サブスクライブ・メッセージングで使用されます。 DIRECT は、非 ASF プロトコルを使用するクライアントおよびメッセージ駆動型 Bean に対してのみ機能します。 QUEUED QUEUED は、標準的な TCP プロトコルです。
推奨	キュー接続ファクトリー・トランスポート・タイプ BINDINGS の方が 30% 以上も高速ですが、セキュリティー面で劣ります。セキュリティーに不安がある場合、BINDINGS は CLIENT よりも望ましいでしょう。 トピック接続ファクトリー・トランスポート・タイプ DIRECT は最も高速なトランスポート・タイプです。可能であれば DIRECT を使用してください。 追加のセキュリティー・タスクを満たしたい場合、およびキュー・マネージャーが JMS クライアントに対してローカルの場合は、BINDINGS を使用してください。 QUEUED は、それ以外のすべての場合を想定したフォールバックです。DIRECT を設定した、CSD2 以前の WebSphere MQ 5.3 は、メッセージ駆動型 Bean と併用され、負荷がかかった場合には、メッセージを失ってしまうことがあるので注意が必要です。このようなロスはブローカーの maxClientQueueSize が 0 に設定されていない場合に、 クライアント・サイドのアプリケーションでも発生します。 次のコマンドを使用すると、この値を 0 に設定できます。 #wempschangeproperties WAS_nodeName_server1 -e default -o DynamicSubscriptionEngine -n maxClientQueueSize -v 0 -x executionGroupUUID ここで、executionGroupUUID は、ブローカーを開始し、 イベント・ログ/アプリケーションのイベント 2201 を調べることにより見つけることができます。 この値は、通常、ffffffff-0000-0000-000000000000 です。 注: WAS 6.1 には Java 5 ランタイムがあるため、WAS 6.1 では WebSphere MQ 5.3 JMS を使用できません。 そのため、WebSphere MQ 5.3 キュー・マネージャーを使用して、仮想記憶間接続を確立できません。 結果として、WebSphere Application Server バージョン 6.1 へのマイグレーションで、接続および CLIENT ネットワーク接続への移動に WebSphere MQ 5.3 および BINDINGS を使用していた場合、性能低下を引き起こす可能性があります。 WebSphere MQ 5.3 for z/OS® を使用している場合、追加のフィーチャー・パックも購入する必要があります。 64 ビット版 z/OS 上で実行している場合、64 ビット版 WebSphere MQ z/OS は今のところ使用できず、また BINDINGS モードを使用して 31 ビット版 WebSphere MQ z/OS へ接続できないため、トランスポート・タイプに CLIENT を設定する必要があります。 このサポートに、追加の WebSphere MQ フィーチャー・パックの購入も必要な場合があります。

クライアント ID

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

データ型

ストリング

CCSID

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

このコード化文字セット ID (CCSID) は、WebSphere MQ でサポートされている CCSID のいずれかである必要があります。

データ型

ストリング

サポートされる CCSID、およびメッセージ・データ間で行われる 1 つのコード化文字セットから別のコード化文字セットへの変換について詳しくは、WebSphere MQ インフォメーション・センターの『システム管理』および『 アプリケーション・プログラミング・リファレンス』セクションを参照してください。

メッセージ保存

このチェック・ボックスを選択すると、不要なメッセージがキューに残されます。 このチェック・ボックスが選択されないと、不要なメッセージは後処 理オプションに従 って処理されます。

データ型	列挙型
単位	該当なし
デフォルト	クリア
範囲	選択 不要なメッセージはキューに残されます。 クリア 不要なメッセージは後処理オプションに従って処理されます。

一時モデル

接続ファクトリーがまだ存在していない場合に、一時接続ファクトリーの作成に使用できるモデル定義の名前。

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

一時キュー接頭部

動的キュー・ネーミングに使用される接頭部。

データ型

ストリング

静止の場合に失敗

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

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

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

ローカル・サーバー・アドレスを指定します。

データ型

ストリング

ポーリング間隔

非同期メッセージの配信中に、すべての受信側の間でのスキャン間隔をミリ秒で指定します。

データ型	整数
単位	ミリ秒
デフォルト	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 インフォメーション・センターを参照してください。