コネクターの構成

Installer を使用してコネクター・ファイルをシステムにインストールした後で、標準およびアプリケーション固有のコネクター構成プロパティーを設定する必要があります。

構成プロパティーの設定

コネクターには、2 種類の構成プロパティーがあります。標準の構成プロパティーと、コネクター固有の構成プロパティーです。コネクターを稼働させる前に、System Manager (SM) を使用して、これらのプロパティーの値を設定する必要があります。

標準構成プロパティー

標準構成プロパティーは、すべてのコネクターによって使用される情報を提供します。これらのプロパティーの説明については、付録 A, コネクターの標準構成プロパティーを参照してください。下の表には、この付録で説明する構成プロパティーに関する、このコネクターに固有の情報が示されています。
プロパティー 説明
CharacterEncoding

このコネクターはこのプロパティーを使用しません。

Locale

このコネクターは国際化に対応していないため、このプロパティーの値は変更できません。現在サポートされているロケールについては、コネクターのリリース情報を参照してください。

このコネクターが統合ブローカーとしてサポートするのは InterChange Server Express のみであるため、関連する構成プロパティーは InterChange Server Express 用のプロパティーのみです。

少なくとも、以下の標準コネクター構成プロパティーを設定する必要があります。

コネクター固有の構成プロパティー

コネクター固有の構成プロパティーは、実行時にコネクター・エージェントが必要とする情報を提供します。また、コネクター固有のプロパティーを使用することにより、エージェントの再コーディングおよび再ビルドを行わずに、コネクター・エージェント内の静的な情報または論理を変更することができます。

表 38 には、コネクター固有の構成プロパティーがリストされています。プロパティーの説明については、以下の各セクションを参照してください。プロパティーの中には、別のプロパティーを含んでいるものもあります。 + 文字は、プロパティー階層内の項目の位置を示しています。

注:
コネクターと連動させずに、SOAP/JMS プロトコル・リスナーまたは SOAP/JMS プロトコル・ハンドラーをコネクターを使用したい場合は、SOAP/JMS 関連のコネクター固有のプロパティーを必ず削除するか、ブランクのままにしておいてください。


表 38. コネクター固有の構成プロパティー
名前 指定可能な値 デフォルト値 必須
ConnectorType 任意の有効なコネクター・タイプ WebService はい
DataHandlerMetaObjectName データ・ハンドラーのメタオブジェクト名 MO_DataHandler_ Default はい
JavaProtocolHandlerPackages 有効な Java プロトコル・ハンドラー・パッケージ com.ibm.net.ssl. internal.www.protocol いいえ
ProtocolHandlerFramework これは階層プロパティーであり、値はありません。 なし いいえ
+ProtocolHandlers これは階層プロパティーであり、値はありません。
いいえ
++SOAPHTTPHTTPSHandler これは階層プロパティーです。このプロパティーのサブプロパティーについては、SOAPHTTPHTTPSHandlerを参照してください。
はい
++SOAPJMSHandler これは階層プロパティーです。このプロパティーのサブプロパティーについては、SOAPJMSHandlerを参照してください。

ProtocolListenerFramework これは階層プロパティーであり、値はありません。
いいえ
+WorkerThreadCount 使用可能なリスナー・スレッド数を指定する 1 より大きい整数。 10 いいえ
+RequestPoolSize リソース・プール・サイズを指定する WorkerThreadCount より大きい整数 20 いいえ
+ProtocolListeners これは階層プロパティーであり、値はありません。

++Listener1 固有の名前が指定されたプロトコル・リスナー
はい
+++Protocol soap/httpsoap/httpssoap/jms
はい
+++SOAPDHMimeType SOAP データ・ハンドラーの任意の有効な MIME タイプ xml/soap
+++ListenerSpecific リスナーで固有または必要なプロパティーListenerSpecificを参照してください。

ProxyServer これは階層プロパティーであり、値はありません。
いいえ
+HttpProxyHost HTTP プロキシー・サーバーのホスト名
いいえ
+HttpProxyPort HTTP プロキシー・サーバーのポート番号 80 いいえ
+HttpNonProxyHosts 直接接続が必要な HTTP ホスト
いいえ
+HttpsProxyHost HTTPS プロキシー・サーバーのホスト名
いいえ
+HttpsProxyPort HTTPS プロキシー・サーバーのポート番号 443 いいえ
+HttpsNonProxyHosts 直接接続が必要な HTTPS ホスト
いいえ
+SocksProxyHost Socks プロキシー・サーバーの名前
いいえ
+SocksProxyPort Socks プロキシー・サーバーのポート
いいえ
+HttpProxyUsername HTTP プロキシー・サーバー・ユーザー名
いいえ
+HttpProxyPassword HTTP プロキシー・サーバー・パスワード
いいえ
+HttpsProxyUsername HTTPS プロキシー・サーバー・ユーザー名
いいえ
+HttpsProxyPassword HTTPS プロキシー・サーバー・パスワード
いいえ
SSL これは階層プロパティーであり、値はありません。
いいえ
+SSLVersion SSLSSLv2SSLv3TLSTLSv1 SSL いいえ
+SSLDebug truefalse false いいえ
+KeyStoreType 任意の有効な鍵ストア・タイプ JKS いいえ
+KeyStore KeyStore ファイルへのパス
いいえ
+KeyStorePassword KeyStore における秘密鍵のパスワード
いいえ
+KeyStoreAlias KeyStore における鍵ペアの別名
いいえ
+TrustStore TrustStore ファイルへのパス
いいえ
+TrustStorePassword TrustStore のパスワード
いいえ
+UseClientAuth truefalse false いいえ
WSCollaborations これは、WSDL 構成ウィザードで作成する階層プロパティーであり、値はありません。WSCollaborationsを参照してください。

+Collaboration1 これは階層プロパティーであり、値はありません。

++CollaborationPort1 コラボレーション・ポートの名前
はい
+++WebServiceOperation1 これは階層プロパティーであり、値はありません。
はい
++++BodyName Web サービス・メソッドの名前であり、有効な XML エレメント名でなければなりません。
はい
++++BodyNS Web サービス・メソッドのネーム・スペースであり、有効な XML ネーム・スペースでなければなりません。
はい
++++BOName 操作のための要求ビジネス・オブジェクトの名前
はい
++++Mode synchasynch asynch いいえ
JNDI これは、JMS 関連の階層プロパティーであり、値はありません。
いいえ
+LookupQueuesUsingJNDI truefalse false いいえ
+JNDIProviderURL 有効な JNDI URL
いいえ
+InitialContextFactory 初期コンテキストに関するファクトリー・クラスの名前
いいえ
+JNDIConnectionFactoryName JNDI コンテキストを使用して検索する接続ファクトリーの名前
いいえ
+CTX_ObjectFactories


+CTX_プロパティー

JNDI コンテキストにおけるセキュリティーおよびオブジェクト検索に関する追加情報を指定するプロパティー
いいえ

ConnectorType

このプロパティーが WebService に設定されている場合、コラボレーション・ポートをバインドすると、System Manager は、そのコネクターを Web サービス・コネクターとして表示します。それ以外の場合には、そのコネクターは通常のコネクターとして表示されます。

デフォルト値は WebService です。

DataHandlerMetaObjectName

これは、データ・ハンドラーが構成プロパティーを設定するために使用する、メタオブジェクトの名前です。

デフォルト値は MO_DataHandler_Default です。

JavaProtocolHandlerPackages

このプロパティーの値は、Java プロトコル・ハンドラー・パッケージを指定します。コネクターは、このプロパティーの値を使用して、システム・プロパティー java.protocol.handler.pkgs を設定します。

デフォルトは com.ibm.net.ssl.internal.www.protocol です。

ProtocolHandlerFramework

プロトコル・ハンドラー・フレームワークは、そのプロトコル・ハンドラーをロードおよび構成するために、このプロパティーを使用します。これは階層プロパティーであり、値はありません。

デフォルト値はありません。

ProtocolHandlers

この階層プロパティーには、値がありません。この第 1 レベルの子は、別個のプロトコル・ハンドラーを表します。

デフォルト値はありません。

SOAPHTTPHTTPSHandler

SOAP/HTTP-HTTPS プロトコル・ハンドラーの名前。これは階層プロパティーです。リスナーとは異なり、プロトコル・ハンドラーは重複しない場合もあるので、それぞれのプロトコルごとにハンドラーは 1 つだけしかないことがあります。次の、表 39 は SOAP/HTTP-HTTPS プロトコル・ハンドラーのサブプロパティーを表しています。+ 文字は、プロパティー階層内の項目の位置を示しています。


表 39. SOAP/HTTP-HTTPS プロトコル・ハンドラー構成プロパティー
名前 指定可能な値 デフォルト値 必須
++SOAPHTTPHTTPSHandler これは階層プロパティーであり、値はありません。
はい
+++Protocol ハンドラーがインプリメントしようとしているプロトコルの種類。SOAP/HTTP および SOAP/HTTPS の場合の値は soap/http です。
注:
このプロパティーの値を指定しなければ、コネクターはプロトコル・ハンドラーを初期化しません。

はい
+++HTTPReadTimeout リモート・ホスト (Web サービス) から読み取りを行う際のタイムアウト・インターバル (ミリ秒単位) を指定する、SOAP/HTTP 固有のプロパティー。このプロパティーが指定されていない場合、または 0 に設定されている場合、プロトコル・ハンドラーは、リモート・ホストからの読み取りを行っている間、いつまでもブロックします。 0 いいえ

図 32 は、Connector Configurator Express で表示されたプロパティーを表しています。

図 32. SOAP/HTTP-HTTPS プロトコル・ハンドラー・プロパティー


SOAPJMSHandler

SOAP/JMS プロトコル・ハンドラーの名前。これは階層プロパティーです。リスナーとは異なり、プロトコル・ハンドラーは重複しない場合もあるので、それぞれのプロトコルごとにハンドラーは 1 つだけしかないことがあります。次の、表 40 は SOAP/JMS プロトコル・ハンドラーのサブプロパティーを表しています。 + 文字は、プロパティー階層内の項目の位置を示しています。


表 40. SOAP/JMS プロトコル・ハンドラー構成プロパティー
名前 指定可能な値 デフォルト値 必須
++SOAPJMSHandler これは階層プロパティーであり、値はありません。
はい
+++Protocol ハンドラーがインプリメントしようとしているプロトコルの種類。SOAP/JMS の場合の値は soap/jms です。
注:
このプロパティーの値を指定しなければ、コネクターはプロトコル・ハンドラーを初期化しません。

はい
+++ResponseWaitTimeout これは、JMS プロトコル・ハンドラー固有のプロパティーで、プロトコル・ハンドラーが ReplyToQueue で同期要求処理を待つ際のタイムアウト・インターバル (ミリ秒単位) を指定します。このインターバル中に応答が到着しない場合、ハンドラーはコラボレーション要求に失敗します。このプロパティーが指定されていない場合、または 0 に設定されている場合、プロトコル・ハンドラーは ReplyToQueue でいつまでも待機します。 0 いいえ
+++ReplyToQueue これは、ReplyTo キューの名前を指定する JMS プロトコル・ハンドラー固有の必要なプロパティーです。同期要求処理の場合、ハンドラーは JMSReplyTo フィールドの値としてこの JMS 宛先を指定します。
LookupQueuesUsingJNDI が
true であれば、 SOAP/JMS プロトコル・ハンドラーは JNDI を使用してこのキューを検索します。
なし はい

図 33 は、Connector Configurator Express で表示されたプロパティーを表しています。

図 33. SOAP/JMS プロトコル・ハンドラー・プロパティー


ProtocolListenerFramework

プロトコル・リスナー・フレームワークは、このプロパティーを使用してプロトコル・リスナーをロードします。これは階層プロパティーであり、値はありません。

WorkerThreadCount

このプロパティー (これは、1 より大きい整数でなければなりません) は、プロトコル・リスナー・フレームワークで使用できるプロトコル・リスナー・ワーカー・スレッドの数を設定します。詳しくは、プロトコル・リスナーを参照してください。デフォルト値は 10 です。

RequestPoolSize

このプロパティー (これは、WorkerThreadCount より大きい整数でなければなりません) は、プロトコル・リスナー・フレームワークのリソース・プール・サイズを設定します。このフレームワークは、最大で、WorkerThreadCount 要求と RequestPoolSize 要求の合計数を並行して処理することができます。

デフォルト値は 20 です。

ProtocolListeners

これは階層プロパティーであり、値はありません。このプロパティーの第 1 レベルの子は、それぞれ、別のプロトコル・リスナーを表します。

Listener1

プロトコル・リスナーの名前。複数のプロトコル・リスナーが存在する場合があります。これは階層プロパティーです。このプロパティーのインスタンスを複数作成して、固有の名前を持つ、追加のリスナーを作成することができます。このようにする場合、リスナー固有のプロパティーは変更できますが、プロトコル・プロパティーは変更できません。複数のリスナーの名前は固有でなければなりません。指定可能な名前 (値ではありません) は、SOAPHTTPListener1SOAPHTTPSListener1SOAPJMSListener1 のいずれかです。

Protocol

このプロパティーは、このリスナーがインプリメントしようとしているプロトコルを指定します。指定可能な値: soap/httpsoap/httpssoap/jms

注:
このプロパティーの値を指定しなければ、コネクターはプロトコル・リスナーを初期化しません。

SOAPDHMimeType

このリスナーによって受け取られた要求のために使用される、SOAP データ・ハンドラーの MIME タイプ。

デフォルト値は xml/soap です。

ListenerSpecific

リスナー固有のプロパティーは、指定されたプロトコル・リスナーに固有の、あるいは指定されたプロトコル・リスナーにとって必須のプロパティーです。例えば、HTTP リスナーにはリスナー固有のプロパティー Port が設定されますが、これは、リスナーが要求をモニターするポート番号を表します。表 41 は、HTTP/HTTPS リスナーに固有のプロパティーを要約したものです。 + 文字は、プロパティー階層内の項目の位置を示しています。


表 41. SOAP/HTTP および SOAP/HTTPS プロトコル・リスナーに固有の構成プロパティー
名前 指定可能な値 デフォルト値 必須
+++SOAPHTTPListener1 HTTP プロトコル・リスナーの固有の名前。これは、ProtocolListenerFramework -> ProtocolListeners 階層プロパティーの子です。リスナーは複数存在する場合があります。このプロパティーおよびその階層の別のインスタンスを作成することにより、追加の HTTP リスナーを付け加えることができます。
はい
++++Protocol soap/http (SOAP/HTTP プロトコル・リスナーの場合)

soap/https (SOAP/HTTPS プロトコル・リスナーの場合)

注:
このプロパティーの値を指定しなければ、コネクターはプロトコル・リスナーを初期化しません。

はい
++++SOAPDHMimeType xml/soap xml/soap いいえ
++++BOPrefix このプロパティーの値は、データ・ハンドラーに渡されます。
いいえ
++++Host リスナーは、このプロパティーの値によって指定された IP アドレスで要求を listen します。Host が指定されない場合、デフォルト値として localhost が使用されます。リスナーを実行しているマシンのホスト名 (DNS 名) または IP アドレスのどちらを指定しても構いません。 1 台のマシンで複数の IP アドレスまたは複数の名前を持つこともできますlocalhost いいえ
++++Port リスナーが要求を listen するポート。ポートが指定されていない場合、ポートのデフォルトとして、SOAP/HTTP の場合は 80SOAP/HTTPS の場合は 443 が使用されます。コネクター内でリスナーを複製した場合、Host プロパティーと Port プロパティーの組み合わせは固有にします。そうしないと、リスナーは、要求を受け入れるためにポートにバインドすることができなくなる可能性があります。 SOAP/HTTP リスナーの場合は 80
SOAP/HTTPS リスナーの場合は 443
いいえ
++++SocketQueueLength 着信接続要求のためのキュー (ソケット・キュー) の長さ。ホストに接続を拒否されずに、一度に保管できる着信接続の数を指定します。キューの最大長は、オペレーティング・システムに依存します。 5 いいえ
++++RequestWaitTimeout Web サービス要求の到着を待つ際にリスナー・スレッドがホストおよびポートでブロックを行う時間間隔を、ミリ秒単位で指定します。この間隔以内に Web サービス要求を受け取った場合、リスナーはその要求を処理します。それ以外の場合、リスナー・スレッドは、コネクター・シャットダウン・フラグが設定されているかどうかを調べます。このフラグが設定されている場合、コネクターは終了します。このフラグが設定されていない場合、RequestWaitTimeout 間隔の間、ブロックが継続します。このプロパティーを 0 に設定した場合、ブロックはいつまでも継続します。このプロパティーを指定しないと、デフォルトとして 60000 ミリ秒が使用されます。 60000 (ms) いいえ
++++HTTPReadTimeout クライアントからの Web サービス要求を読み取っているときにリスナーがブロックされる時間間隔を、ミリ秒単位で指定します。このパラメーターを 0 に設定すると、リスナーは、要求メッセージ全体を受け取るまで、いつまでもブロックされます。 0 いいえ
++++HttpAsyncResponseCode リスナーへの非同期要求に対する HTTP 応答コード。

200 (OK)

202 (ACCEPTED)

202 (ACCEPTED) いいえ
++++URLsConfiguration これは階層プロパティーであり、値はありません。ここには、このリスナーがサポートする URL の構成が 1 つ以上格納され、さらにオプションで、MIME タイプと charset の値が格納されます。これは、ProtocolListenerFramework->ProtocolListeners-> SOAPHTTPListener1 階層プロパティーの子プロパティーです。このプロパティーが指定されない場合、リスナーはデフォルト値を想定します。 ContextPath: / Enabled: true データ・ハンドラー MimeType: 要求の ContentType と同じ Charset: NONE。詳しくは、SOAP/HTTP および SOAP/HTTPS プロトコル・リスナー処理を参照。 いいえ
+++++URL1 これは階層プロパティーであり、値はありません。この子には、このリスナーがサポートする URL の名前があります。サポートされる URL は、複数存在する場合があります。このプロパティーおよびその階層を複製すれば、追加の URL を付け加えることができます。
いいえ
++++++ContextPath リスナーが受け取る HTTP 要求の URI。この値は、URLsConfiguration プロパティーの下の ContextPath 値の中で固有でなければなりません。そうでないと、コネクターはログにエラーを記録し、始動に失敗します。ContextPath の値については、大文字小文字の区別が行われます。ただし、大文字小文字が区別されないプロトコル、ホスト名およびポートを含めることができます。プロトコルを ContextPath に指定する場合は、http にする必要があります。ホストを指定する場合には、Host リスナー・プロパティーの値と同じにする必要があります。ポートを指定する場合には、Port リスナー・プロパティーの値と同じにする必要があります。
いいえ
++++++Enabled このプロパティーの値によって、親 URL 階層プロパティーがコネクターで使用可能かどうかが決まります。 True いいえ
++++++TransformationRules これは階層プロパティーであり、値はありません。1 つ以上の変換規則が保持されます。

+++++++TransformationRule1 これは階層プロパティーであり、値はありません。ここには変換規則が保持されます。
いいえ
++++++++ContentType このプロパティーの値は、特殊処理 (データ・ハンドラー MIME タイプまたは charset) が適用される着信要求の ContentType を示します。TransformationRuleN 階層プロパティーによって ContentType が指定されていない場合、コネクターは、ログに警告メッセージを記録して、その TransformationRuleN プロパティーを無視します


このプロパティーに特殊値
*/* が指定された場合、プロトコル・リスナーは、この規則を任意の ContentType に適用できます。同じコンテキスト・パスで、同じ ContentType を持つ規則が複数検出された場合、リスナーはログにエラーを記録し、初期化に失敗します。


いいえ
++++++++MimeType 指定された ContentType の要求を処理するためにデータ・ハンドラーを呼び出すときに使用する MIME タイプ。
いいえ
++++++++Charset 指定された ContentType の要求をビジネス・オブジェクトに変換するときに使用する Charset。
いいえ

図 34 は、Connector Configurator Express で表示されたプロパティーを表しています。

図 34. SOAP/HTTP プロトコル・リスナー・プロパティー


表 42 は、SOAP/JMS プロトコル・リスナーに固有のプロパティーを要約したものです。+ 文字は、プロパティー階層内の項目の位置を示しています。

表 42. SOAP/JMS プロトコル・リスナーに固有の構成プロパティー
名前 指定可能な値 デフォルト値 必須
+++SOAPJMSListener1 JMS プロトコル・リスナーの固有の名前。これは、ProtocolListenerFramework -> ProtocolListeners 階層プロパティーの子です。リスナーは複数存在する場合があります。このプロパティーおよびその階層の別のインスタンスを作成することにより、追加の JMS リスナーを付け加えることができます。
はい
++++Protocol soap/jms
はい
++++SOAPDHMimeType xml/soap xml/soap いいえ
++++BOPrefix このプロパティーの値は、SOAPDHMimeType プロパティーによって指定されたデータ・ハンドラーに渡されます。
いいえ
++++RequestWaitTimeout このプロパティーは、Web サービス要求を待つ際に SOAP/JMS リスナー・スレッドが InputQueue をブロックする時間間隔を設定します。この間隔以内に Web サービス要求を受け取った場合、リスナーはその要求を処理します。この間隔以内に要求を受け取らなかった場合、リスナー・スレッドは最初に、コネクター・シャットダウン・フラグが設定されているかどうかを調べます。コネクター・シャットダウン・フラグが設定されている場合、コネクターは終了します。このフラグが設定されていない場合、RequestWaitTimeout 間隔の間、ブロックが継続します。このプロパティーを 0 に設定した場合、ブロックはいつまでも継続します。 60000

ミリ秒

いいえ
++++SessionPoolSize 任意のリスナーとそのワーカー・スレッドに割り振り可能なセッションの最大数。セッションの最小数は 2 です (これがデフォルトです)。セッション・プール・サイズを大きくすると、コネクターが必要とするメモリーも多くなります。 2 いいえ
++++InputQueue このプロパティーでは、リスナーが Web サービスからのインバウンド・メッセージをポーリングする入力キューの名前を指定します。LookupQueuesUsingJNDI が true である場合、リスナーが JNDI を使用してこのキューを検索し、InputQueue プロパティーの値が SOAP/JMS バインディングの jms:address 要素の jndiDestinationName 属性に設定されます。jms:address 要素は、WSDL 文書の wsdl:port セクションで指定されています。WSDL の生成中に SOAP/JMS リスナーを選択した場合、System Manager は、このプロパティーの値を使用して自動的に jndiDestinationName 属性を作成します。LookupQueueUsingJNDI が false である場合、System Manager は jmsProviderDestinationName 属性を作成します
はい
++++InProgressQueue このプロパティーでは、進行中のキューの名前を指定します。リスナーは、InputQueue から InProgressQueue にインバウンド・メッセージのコピーを送信します。LookupQueuesUsingJNDI = true である場合、リスナーは JNDI を使用してこのキューを検索します。
はい
++++ArchiveQueue このプロパティーでは、アーカイブ・キューの名前を指定します。リスナーは、InProgressQueue から ArchiveQueue に、正常に処理されたメッセージのコピーを送信します。LookupQueuesUsingJNDI = true である場合、リスナーは JNDI を使用してこのキューを検索します
いいえ
++++UnsubscribedQueue このプロパティーでは、アンサブスクライブされたキューの名前を指定します。リスナーは、InProgressQueue から UnsubscribedQueue に、アンサブスクライブされたメッセージのコピーを送信します。LookupQueueUsingJNDI = true である場合、リスナーは JNDI を使用してこのキューを検索します
いいえ
++++ErrorQueue このプロパティーでは、エラー・キューの名前を指定します。リスナーは、失敗したメッセージのコピーを ErrorQueue に送信します。LookupQueueUsingJNDI = true である場合、リスナーは JNDI を使用してこのキューを検索します
いいえ
++++InDoubtEvents このプロパティーでは、予期しないコネクター終了のために完全に処理されなかった、InProgressQueue 内のメッセージの取り扱い方法を指定します。このプロパティーには、次のいずれかの値を指定することができます。
  • FailOnStartup: エラーをログに記録し、ただちにシャットダウンします。
  • Reprocess: InProgressQueue 内の残りのメッセージを処理します
  • Ignore: 進行中キュー内のメッセージをすべて無視します
  • LogError: エラーをログに記録しますが、シャットダウンしません
Ignore いいえ
++++ReplyToQueue このプロパティーでは、ReplyTo キューの名前を指定します。WSDL 構成ウィザードはこのプロパティーを読み取り、それを WSDL 文書に書き込みます。このプロパティーが指定されない場合、このユーティリティーは、WSDL 文書内の SOAP/JMS バインディングに ReplyTo JMS ヘッダーを作成しません。(リスナーはこのプロパティーを使用しません。) JNDI プロパティーが指定されていて、LookupQueueUsingJNDI が false である場合にも、WSDL Generation Utility は WSDL 文書内に JNDI 固有の属性を作成します。これらの JNDI 固有属性が必要であるのは、JNDI がなければ SOAP/JMS バインディングが ReplyTo 属性を指定できないためです。JNDI による InputQueue の検索は必要ではありませんが、ReplyTo キューを使用するためには、JNDI 固有のプロパティーが必要です。JNDI 固有のプロパティーが見付からなかった場合、WSDL ユーティリティーは、SOAP/JMS バインディング内で ReplyTo 属性を作成することができません

++++ JMSVendorURI JMS インプリメンテーションを一意的に識別し、SOAP/JMS バインディングの jms:address 要素の jmsVendorURI 属性に対応するストリング。jms:address 要素は、WSDL 文書の wsdl:port セクションで指定されています。このプロパティーは、リスナーでは使用されません。
いいえ

図 35 は、Connector Configurator Express で表示されたプロパティーを表しています。

図 35. SOAP/JMS プロトコル・リスナー・プロパティー


注:
以下のプロパティーに指定されたキュー名が固有であることを確認してください。

ProxyServer

ネットワークがプロキシー・サーバーを使用する場合には、このプロパティー以下の値を構成してください。これは階層プロパティーであり、値はありません。このプロパティー以下で指定された値は、SOAP/HTTP/HTTPS プロトコル・ハンドラーによって使用されます。

図 36 は、Connector Configurator Express で表示されたプロキシー・サーバーのプロパティーを表しており、以下にその説明をしています。

図 36. ProxyServer プロパティー


HttpProxyHost

HTTP プロキシー・サーバーのホスト名。ネットワークが HTTP プロトコルでプロキシー・サーバーを使用する場合には、このプロパティーを指定してください。

デフォルト値はありません。

HttpProxyPort

HTTP プロキシー・サーバーに接続するためにコネクターが使用するポート番号。

デフォルト値は 80 です。

HttpNonProxyHosts

このプロパティーの値は、プロキシー・サーバー経由ではなく直接接続する必要のある、1 つまたは複数のホスト (HTTP の場合) を表します。この値は、各ホストを "|" で区切った、ホストのリストの形で指定することができます。

デフォルト値はありません。

HttpsProxyHost

HTTPS プロキシー・サーバーの場合のホスト名。

デフォルト値はありません。

HttpsProxyPort

HTTPS プロキシー・サーバーに接続するためにコネクターが使用するポート番号。

デフォルト値は 443 です。

HttpsNonProxyHosts

このプロパティーの値は、プロキシー・サーバー経由ではなく直接接続する必要のある、1 つまたは複数のホスト (HTTPS の場合) を表します。この値は、各ホストを "|" で区切った、ホストのリストの形で指定することができます。

デフォルト値はありません。

SocksProxyHost

Socks Proxy サーバーの場合のホスト名。ネットワークが Socks プロキシーを使用する場合には、このプロパティーを指定してください。

注:
基礎となる JDK は Socks をサポートしていなければなりません。

デフォルト値はありません。

SocksProxyPort

Socks Proxy サーバーに接続するためのポート番号。ネットワークが Socks プロキシーを使用する場合には、このプロパティーを指定してください。

デフォルト値はありません。

HttpProxyUsername

HTTP プロキシー・サーバーのユーザー名。Web サービス要求の宛先が HTTP URL であり、ProxyServer ->HttpProxyUsername が指定された場合、SOAP HTTP/HTTPS プロトコル・ハンドラーは、このプロキシーでの認証のときに Proxy-Authorization ヘッダーを作成します。ハンドラーは、認証に CONNECT メソッドを使用します。

このプロキシー認証ヘッダーは Base64 方式でエンコードされており、以下の構造になっています。


Proxy-Authorization: Basic

Base64EncodedString

ハンドラーは、ユーザー名とパスワードのプロパティー値を連結し、その間をコロン (:) で区切って、Base64 エンコードされたストリングを作成します。

デフォルト値はありません。

HttpProxyPassword

HTTP プロキシー・サーバーのパスワード。これらの値の使用に関する詳細については、HttpProxyUsernameを参照してください。

デフォルト値はありません。

HttpsProxyUsername

HTTPS プロキシー・サーバーのユーザー名。Web サービス要求の宛先が HTTPS URL であり、ProxyServer ->HttpsProxyUsername が指定された場合、SOAP HTTP/HTTPS プロトコル・ハンドラーは、このプロキシーでの認証に対して Proxy-Authorization ヘッダーを作成します。ハンドラーは、HttpsProxyUsername と HttpsProxyPassword 構成プロパティー値を連結し、その間をコロン (:) で区切って、Base64 エンコードされたストリングを作成します。

デフォルト値はありません。

HttpsProxyPassword

HTTPS プロキシー・サーバーのパスワード。これらの値の使用に関する詳細については、HttpsProxyUsernameを参照してください。

デフォルト値はありません。

SSL

コネクターのための SSL を構成するためには、このプロパティー以下の値を指定してください。これは階層プロパティーであり、値はありません。

図 37 は、Connector Configurator Express で表示された SSL のプロパティーを表しており、以下にその説明をしています。

図 37. SSL プロパティー


SSLVersion

コネクターによって使用される SSL のバージョン。詳しくは、IBM JSSE 資料に記載された、サポートされる SSL バージョンに関する説明を参照してください。

デフォルト値は SSL です。

SSLDebug

このプロパティーの値が true に設定されている場合、コネクターは javax.net.debug システム・プロパティーの値を true に設定します。IBM JSSE はこのプロパティーを使用して、トレース機能をオンにします。詳しくは IBM JSSE の資料を参照してください。

デフォルト値は false です。

KeyStoreType

このプロパティーの値は、KeyStore および TrustStore のタイプを表します。詳しくは、IBM JSSE 資料に記載された、有効な鍵ストア・タイプに関する説明を参照してください。

デフォルト値は JKS です。

KeyStore

このプロパティーでは、鍵ストア・ファイルへの完全パスを指定します。KeyStore または KeyStoreAlias プロパティー、あるいはその両方が指定されていない場合には、KeyStorePassword、KeyStoreAlias、TrustStore、および TrustStorePassword の各プロパティーは無視されます。コネクターは、このプロパティーで指定されたパスを使用して鍵ストアをロードすることができない場合、始動に失敗します。このパスは、鍵ストア・ファイルの完全パスでなければなりません。

デフォルト値はありません。

KeyStorePassword

このプロパティーでは、Keystore 内の秘密鍵のパスワードを指定します。

デフォルト値はありません。

KeyStoreAlias

このプロパティーでは、KeyStore 内の鍵ペアの別名を指定します。SOAP/HTTPS リスナーは、KeyStore からこの秘密鍵を入手して使用します。また、SOAP/HTTP-HTTPS プロトコル・ハンドラーは、クライアント認証を必要とする Web サービスを呼び出すときに、KeyStore からこの別名を入手して使用します。このプロパティーは、有効な JSSE 別名に設定しなければなりません。

デフォルト値はありません。

TrustStore

このプロパティーでは、TrustStore への完全パスを指定します。TrustStore は、コネクターに信頼される証明書を保管するために使用されます。TrustStore のタイプは KeyStore と同じでなければなりません。TrustStore ファイルの完全パスを指定しなければなりません。

デフォルト値はありません。

TrustStorePassword

このプロパティーは、Truststore のパスワードを指定します。

デフォルト値はありません。

UseClientAuth

このプロパティーでは、SSL クライアント認証を使用するかどうかを指定します。このプロパティーが true に設定されている場合、SOAP/HTTPS リスナーはクライアント認証を使用します。

デフォルト値は false です。

WSCollaborations

このプロパティーは、ユーザーがコラボレーション・オブジェクトを Web サービスとして公開するときに自動的に作成され、非 TLO で使用されます。これは階層プロパティーであり、値はありません。このプロパティーの第 1 レベルのそれぞれの子は、Web サービスとして公開されたコラボレーションを表します。これらのプロパティーを自動的に作成するのに使用するためのツールについては、Web サービスとしてのコラボレーションの公開を参照してください。

注:
System Manager でコラボレーションまたはそのポートを削除しても、コネクターはコラボレーションを表すプロパティーを自動的には削除しません。これらのプロパティーは、Connector Configurator Express. を使用して削除しなければなりません。

図 38 は、Connector Configurator Express で表示された WSCollaborations のプロパティーを表しており、以下にその説明をしています。

図 38. WSCollaborations プロパティー


Collaboration1

このプロパティーでは、このコネクターを介して Web サービスとして公開されるコラボレーション・オブジェクトを指定します。これは階層プロパティーであり、値はありません。Web サービスとして公開されるそれぞれのコラボレーション・オブジェクトごとに 1 つずつ、このようなプロパティーを複数指定することができます。このプロパティーの第 1 レベルのそれぞれの子は、このコラボレーション・オブジェクトのポートを表します。

CollaborationPort1

このプロパティーでは、コラボレーション・ポートを指定します。これは階層プロパティーであり、値はありません。コネクターにバインドされるこのコラボレーションのそれぞれのポートごとに 1 つずつ、このようなプロパティーを複数指定することができます。このプロパティーの第 1 レベルのそれぞれの子は、Web サービスの操作を表します。

WebServiceOperation1

このプロパティーでは、コラボレーション・オブジェクトに関する Web サービス操作を表します。これは階層プロパティーであり、値はありません。 WSDL 文書生成時にユーザーが定義したそれぞれの Web サービス操作ごとに 1 つずつ、このようなプロパティーを複数指定することができます。

BodyName

このプロパティーでは、Web サービス方式の名前を指定します。この名前は有効な XML 要素名でなければなりません。

デフォルト値はありません。

BodyNS

このプロパティーでは、Web サービス方式のネーム・スペースを指定します。この名前は有効な XML 要素ネーム・スペースでなければなりません。

デフォルト値はありません。

BOName

このプロパティーでは、この操作に関する要求ビジネス・オブジェクトの名前を指定します。

デフォルト値はありません。

Mode

このプロパティーでは、操作の処理モードを指定します。このプロパティーを synch に設定すると、コネクターはコラボレーションを同期的に呼び出すようになります。それ以外の値を設定した場合、およびデフォルト値の場合、コネクターは、コラボレーションを要求専用操作として非同期的に呼び出すようになります。

デフォルト値は asynch です。

JNDI

コネクターは、JNDI (Java Naming and Directory Interface) への接続時に SOAP/JMS プロトコル・ハンドラーおよび JMS プロトコル・リスナーによって使用される JNDI プロバイダー・プロパティーの 1 組のセットを維持します。これは階層プロパティーであり、値はありません。コネクターは、JNDI を使用して JMS 接続ファクトリー・オブジェクトを検索します。このプロパティーは、SOAP/JMS バインディングの生成時に WSDL 構成ウィザードによって使用されることに注意してください。

図 39 は、Connector Configurator Express で表示された JNDI のプロパティーを表しており、以下にその説明をしています。

図 39. JNDI プロパティー


LookupQueuesUsingJNDI

このプロパティーの値が true に設定されている場合、コネクターの SOAP/JMS リスナーおよび SOAP/JMS プロトコル・ハンドラーは、JNDI を使用してキューを検索します。

デフォルト値は false です。

JNDIProviderURL

このプロパティーでは、JNDI サービス・プロバイダーの URL を指定します。これは、SOAP/JMS バインディングの jms:address 要素の jndiProviderURL 属性に対応します。jms:address 要素は、wsdl:port セクションで指定されています。これは、デフォルトの JNDI プロバイダーとして使用されるものであり、有効な JNDI URL でなければなりません。詳しくは JNDI 仕様を参照してください。

デフォルト値はありません。

InitialContextFactory

このプロパティーでは、初期コンテキストを作成するファクトリー・クラスの完全修飾クラス名 (例えば、com.ibm.NamingFactory) を指定します。これは、SOAP/JMS バインディングの jms:address 要素の initialContextFactory 属性に対応します。jms:address 要素は、wsdl:port セクションで指定されています。

デフォルト値はありません。

JNDIConnectionFactoryName

このプロパティーでは、JNDI コンテキストを使用して検索を行う接続ファクトリーの名前を指定します。これは、SOAP/JMS バインディングの jms:address 要素の jndiConnectionFactoryName 属性に対応します。jms:address 要素は、wsdl:port セクションで指定されています。

デフォルト値はありません。

CTX_ObjectFactories

JNDI コンテキストにおけるセキュリティーおよびオブジェクト検索に関する追加情報を指定するプロパティー。表 43 は、これらのプロパティーを要約したものです。 + 文字は、プロパティー階層内の項目の位置を示しています。


表 43. Java Naming and Directory Interface (JNDI) プロバイダーのプロパティー
プロパティー名 説明
+CTX_StateFactories

+CTX_URLPackagePrefixes

+CTX_DNS_URL

+CTX_Authoritative

+CTX_Batchsize

+CTX_Referral

+CTX_SecurityProtocol

+CTX_SecutiryAuthentication

+CTX_SecurityPrincipal

+CTX_SecurityCredentials

+CTX_Language

JNDI コンテキストにおけるセキュリティーおよびオブジェクト検索に関する追加情報を指定するプロパティー。詳しくは J2EE 資料を参照してください。これらのプロパティーは、JMS 用アダプターで使用されるものを反映しています。

複数のプロトコル・リスナーの作成

プロトコル・リスナーのインスタンスを複数作成することができます。プロトコル・リスナーは、ProtocolListenerFramework> ProtocolListeners コネクター・プロパティーの子プロパティーとして構成されます。(ProtocolListenerFramework -> ProtocolListeners の) それぞれの子プロパティーは、コネクターのプロトコル・リスナーを明確に識別します。したがって、ProtocolListeners プロパティーの下で、新しい子プロパティーを構成することにより、追加のプロトコル・リスナーを作成することができます。新規に作成したリスナー・プロパティーの子プロパティーをすべて指定していることを、確認してください。各リスナーの名前は固有でなければなりません。ただし、リスナーのプロトコル・プロパティー (soap/httpsoap/httpssoap/jms) は変更しません。これらは、リスナーの複数インスタンス用に同じ名前で残ります。

注:
このプロトコル・プロパティーはスイッチの役目をしているため非常に重要です。リスナーまたはハンドラーを使用したくない場合は、このプロパティーを空のままにします。

SOAP/HTTP リスナーまたは SOAP/HTTPS リスナーの複数インスタンスを作成している場合は、それぞれのインスタンスに別々のポートおよびホスト・プロパティーを必ず指定してください。複数の SOAP/JMS リスナーを指定している場合は、それぞれのインスタンスに対して必ず別々のキューのセットを使用します。

1 つのハンドラーの複数のインスタンスは作成できません。プロトコルごとにハンドラーは 1 つしか存在できません。

Copyright IBM Corp. 2004