このセクションでは、標準コネクター構成プロパティーについて説明します。
AdapterHelpName プロパティーは、 コネクター固有の全般ヘルプ・ファイルがあるディレクトリーの名前です。 ディレクトリーは <ProductDir>¥bin¥Data¥App¥Help にある必要があります。また、少なくとも言語ディレクトリー enu_usa を含んでいる必要があります。 ロケールによっては、その他のディレクトリーが含まれることもあります。
有効またはブランクである場合、デフォルト値はテンプレート名です。
AdminInQueue プロパティーは、統合ブローカーからコネクターへ管理メッセージが送信されるときに使用されるキューを指定します。
デフォルト値は <CONNECTORNAME>/ADMININQUEUE です。
AdminOutQueue プロパティーは、コネクターから統合ブローカーへ管理メッセージが送信されるときに使用されるキューを指定します。
デフォルト値は <CONNECTORNAME>/ADMINOUTQUEUE です。
AgentConnections プロパティーは、ORB が初期設定するときにオープンされる ORB (Object Request Broker (オブジェクト・リクエスト・ブローカー)) 接続の数を制御します。
これは、RepositoryDirectory が <REMOTE> に設定され、 DeliveryTransport プロパティーの値が MQ または IDL である場合のみ有効です。
このプロパティーのデフォルト値は 1 です。
AgentTraceLevel プロパティーは、アプリケーション固有のコンポーネントの トレース・メッセージのレベルを設定します。 コネクターは、設定されたトレース・レベル以下の該当するトレース・メッセージを すべてデリバリーします。
デフォルト値は 0 です。
ApplicationName プロパティーは、コネクター・アプリケーションの名前を一意的に識別します。 この名前は、システム管理者が統合環境をモニターするために使用します。 コネクターを実行する前に、このプロパティーに値を指定する必要があります。
デフォルトはコネクターの名前です。
BiDi.Application プロパティーは、このアダプターによってサポートされるビジネス・オブジェクト形式で外部アプリケーションからアダプターに送信されるデータに対して、 双方向フォーマットを指定します。 このプロパティーは、アプリケーション・データの双方向属性を定義します。 属性は次のとおりです。
このプロパティーは、BiDi.Transformation プロパティーが true に設定されている場合のみ有効です。
デフォルト値は ILYNN (暗黙、左から右、オン、オフ、公称) です。
BiDi.Broker プロパティーは、サポートされるビジネス・オブジェクトの形式で アダプターから統合ブローカーへ送信されるデータに対して双方向スクリプト・フォーマットを指定します。 これは、 前述の BiDi.Application にリストされているようなデータの双方向属性を定義します。
このプロパティーは、BiDi.Transformation プロパティーが true に設定されている場合のみ有効です。 BrokerType プロパティーが ICS である場合、 プロパティー値は読み取り専用です。
デフォルト値は ILYNN (暗黙、左から右、オン、オフ、公称) です。
BiDi.Metadata プロパティーは、メタデータの双方向フォーマットまたは属性を定義します。 これは、外部アプリケーションへのリンクを確立または保守するためにコネクターによって使用されます。 属性設定は、双方向機能を使用する各アダプターに固有です。 アダプターが双方向処理をサポートしている場合、 詳細については、アダプター固有のプロパティーに関するセクションを参照してください。
このプロパティーは、BiDi.Transformation プロパティーが true に設定されている場合のみ有効です。
デフォルト値は ILYNN (暗黙、左から右、オン、オフ、公称) です。
BiDi.Transformation プロパティーは、システムが実行時に双方向変換を実行するかどうかを定義します。
プロパティー値が true に設定されている場合は、 BiDi.Application、BiDi.Broker、および BiDi.Metadata プロパティーを使用できます。 プロパティー値が false に設定されている場合、 それらは非表示になります。
デフォルト値は false です。
BOTrace プロパティーは、ビジネス・オブジェクト・トレース・メッセージ を実行時に使用可能にするかどうかを指定します。
トレース・レベルが 5 より小さく設定されている場合は、 次のコマンド行パラメーターを使用して BOTrace の値をリセットできます。
デフォルト値は false です。
BrokerType プロパティーは、使用する統合ブローカー・タイプを指定します。 可能な値は、ICS、WMQI (WMQI、WMQIB または WBIMB の場合)、または WAS です。
CharacterEncoding プロパティーは、文字 (アルファベットの文字、数値表現、句読記号など) から数値へのマッピングに使用する文字コード・セットを指定します。
デフォルトでは、サポートされる文字エンコードのサブセットだけが表示されます。 リストに、サポートされる他の値を追加するには、製品ディレクトリーにある ¥Data¥Std¥stdConnProps.xml ファイルを手動で変更する必要があります (<ProductDir>)。 詳細については、本書の Connector Configurator の付録を参照してください。
Common Event Infrastructure (CEI) は、 生成されたイベントを処理する単純なイベント管理機能です。 CommonEventInfrastructure プロパティーは、 実行時に CEI を起動するかどうかを指定します。
デフォルト値は false です。
CommonEventInfrastructureContextURL は、 Common Event Infrastructure (CEI) サーバー・アプリケーションを 実行する WAS サーバーにアクセスするために使用します。 このプロパティーは、使用する URL を指定します。
このプロパティーは、 CommonEventInfrastructure の値が true に設定されている場合のみ有効です。
デフォルト値はブランク・フィールドです。
ConcurrentEventTriggeredFlows プロパティーは、コネクターがイベントのデリバリー時に並行処理できるビジネス・オブジェクトの数を決定します。この属性の値を、 並行してマップおよびデリバリーされるビジネス・オブジェクトの数に設定します。 例えば、このプロパティーの値を 5 に設定すると、 5 個のビジネス・オブジェクトが並行して処理されます。
このプロパティーを 1 よりも大きい値に設定すると、ソース・アプリケーションのコネクターが、複数のイベント・ビジネス・オブジェクトを同時にマップして、複数のコラボレーション・インスタンスにそれらのビジネス・オブジェクトを同時にデリバリーすることができます。これにより、統合ブローカーへのビジネス・オブジェクトのデリバリーにかかる時間、特にビジネス・オブジェクトが複雑なマップを使用している場合のデリバリー時間が短縮されます。ビジネス・オブジェクトのコラボレーションに到達する速度を増大させると、システム全体のパフォーマンスを向上させることができます。
ソース・アプリケーションから宛先アプリケーションまでのフロー全体に並行処理を実装するには、次のプロパティーを構成する必要があります。
ConcurrentEventTriggeredFlows プロパティーは、単一スレッドで順次実行されるコネクター・ポーリングには影響しません。
このプロパティーは、 RepositoryDirectory プロパティーの値が <REMOTE> に設定されている場合のみ有効です。
デフォルト値は 1 です。
ContainerManagedEvents プロパティーにより、JMS イベント・ストアを使用する JMS 対応コネクターが、保証付きイベント・デリバリーを提供できるようになります。保証付きイベント・デリバリーでは、イベントはソース・キューから除去され、1 つの JMS トランザクションとして宛先キューに配置されます。
このプロパティーが JMS に設定されている場合は、 保証付きイベント・デリバリーを使用できるように次のプロパティーも構成する必要があります。
また、MimeType および DHClass (データ・ハンドラー・クラス) プロパティーを設定したデータ・ハンドラーも構成する必要があります。DataHandlerConfigMOName (オプションのメタオブジェクト名) を追加することもできます。 これらのプロパティーの値を設定するには、Connector Configurator の「データ・ハンドラー」タブを使用します。
これらのプロパティーはアダプター固有ですが、いくつかの値の例を次に示します。
「データ・ハンドラー」タブのこれらの値のフィールドは、 ContainerManagedEvents プロパティーが値 JMS に設定されている場合のみ表示されます。
ContainerManagedEvents プロパティーは、 DeliveryTransport プロパティーの値が JMS に設定されている場合のみ有効です。
デフォルト値はありません。
ControllerEventSequencing プロパティーは、コネクター・コントローラーで イベントの順序付けを使用可能にします。
このプロパティーは、RepositoryDirectory プロパティーの値 が <REMOTE> (BrokerType は ICS) に設定されている場合のみ有効です。
デフォルト値は true です。
ControllerStoreAndForwardMode プロパティーは、宛先側のアプリケーション固有のコンポーネントが使用不可であることをコネクター・コントローラーが検出した場合に、コネクター・コントローラーが実行する動作を設定します。
このプロパティーを true に設定した場合、イベントが ICS に到達したときに宛先側のアプリケーション固有のコンポーネントが使用不可であれば、コネクター・コントローラーはそのアプリケーション固有のコンポーネントへの要求をブロックします。アプリケーション固有のコンポーネントが作動可能になると、コネクター・コントローラーはアプリケーション固有のコンポーネントにその要求を転送します。
ただし、コネクター・コントローラーが宛先側のアプリケーション固有のコンポーネントにサービス呼び出し要求を転送した後でこのコンポーネントが使用不可になった場合、コネクター・コントローラーはその要求を失敗させます。
このプロパティーを false に設定した場合、コネクター・コントローラーは、宛先側のアプリケーション固有のコンポーネントが使用不可であることを検出すると、ただちにすべてのサービス呼び出し要求を失敗させます。
このプロパティーは、RepositoryDirectory プロパティーの値 が <REMOTE> に設定されている場合のみ有効です (BrokerType プロパティーの値は ICS)。
デフォルト値は true です。
ControllerTraceLevel プロパティーは、コネクター・コントローラーのトレース・メッセージのレベルを設定します。
このプロパティーは、 RepositoryDirectory プロパティーの値が <REMOTE> に設定されている場合のみ有効です。
デフォルト値は 0 です。
DeliveryQueue プロパティーは、コネクターから統合ブローカーへビジネス・オブジェクトが送信されるときに使用されるキューを定義します。
このプロパティーは、 DeliveryTransport プロパティーの値が JMS に設定されている場合のみ有効です。
デフォルト値は <CONNECTORNAME>/DELIVERYQUEUE です。
DeliveryTransport プロパティーは、イベントのデリバリーのためのトランスポート機構を指定します。指定可能な 値は、WebSphere MQ の MQ、CORBA IIOP の IDL、Java Messaging Service の JMS です。
RepositoryDirectory プロパティーの値が MQ または IDL である場合、コネクターは、CORBA IIOP を使用してサービス呼び出し要求と管理メッセージを送信します。
DeliveryTransport プロパティーの値が MQ である場合、 アダプター開始スクリプトにコマンド行パラメーター WhenServerAbsent を設定して、InterChange Server のシャットダウン時にアダプターを一時停止するかシャットダウンするかを示すことができます。
イベントのデリバリー・トランスポートには、IDL ではなく WebSphere MQ を使用してください (1 種類の製品だけを使用する必要がある場合を除きます)。WebSphere MQ が IDL よりも優れている点は以下のとおりです。
JMS トランスポート・メカニズムは、Java Messaging Service (JMS) による、コネクターとクライアント・コネクター・フレームワークの間の通信を可能にします。
JMS をデリバリー・トランスポートとして選択した場合は、jms.MessageBrokerName、jms.FactoryClassName、jms.Password、および jms.UserName などの 追加の JMS プロパティーが Connector Configurator 内にリストされます。プロパティー jms.MessageBrokerName および jms.FactoryClassName は、このトランスポートで必須です。
以下の環境では、コネクターに JMS トランスポート機構を使用すると、メモリー制限が発生することもありま す。
この環境では、WebSphere MQ クライアント内でメモリーが使用されるため、(サーバー側の) コネクター・コントローラーと (クライア ント側の) コネクターの両方を始動するのは困難な場合があります。ご使用のシステムのプロセス・ヒープ・サイズが 768MB 未満である場合は、次の変数とプロパティーを設定します。
このスクリプトは、製品ディレクトリー (<ProductDir>) の 下の ¥bin ディレクトリーにあります。 テキスト・エディターを使用して、CWSharedEnv.sh スクリプトの最初の行として次の行を追加します。
export LDR_CNTRL=MAXDATA=0x30000000
この行は、ヒープ・メモリーの使用量を最大 768 MB (3 セグメント * 256 MB) に制限します。プロセス・メモリーがこの制限値を超えると、ページ・スワッピングが発生し、システムのパフォーマンスに悪影響を与える場合があります。
このプロパティーの値が true である場合は、JMS 対応コネクターによって、 重複イベントがデリバリー・キューに配信されないようにすることができます。 コネクターの開発時にこの機能を使用するには、コネクターに対し、アプリケーション固有のコード内でビジネス・オブジェクトの ObjectEventId 属性として固有のイベント ID が設定されている必要があります。
デフォルト値は false です。
このプロパティーの値が true である場合は、 アダプター・ランタイムは、着信 ObjectEventID をフロー・モニター用外部キーとしてマーク付けします。
このプロパティーは、BrokerType プロパティーが ICS に設定されている場合のみ有効です。
デフォルト値は false です。
コネクターでメッセージ処理中にエラーが発生すると、コネクターは、そのメッセージ (および状況標識と問題記述) を FaultQueue プロパティーで指定されているキューに移動させます。
デフォルト値は <CONNECTORNAME>/FAULTQUEUE です。
jms.FactoryClassName プロパティーは、JMS プロバイダーのためにインスタンスを生成するクラス名を指定します。DeliveryTransport プロパティーの値が JMS である場合は、 このプロパティーを設定する必要があります。
デフォルト値は CxCommon.Messaging.jms.IBMMQSeriesFactory です。
jms.ListenerConcurrency プロパティーは、 JMS コントローラーの並行リスナーの数を指定します。 これは、コントローラー内でメッセージを並行して取り出しおよび処理を行う スレッドの数を指定します。
このプロパティーは、 jms.OptimizedTransport プロパティーの値が true である場合のみ有効です。
デフォルト値は 1 です。
jms.MessageBrokerName は、JMS プロバイダーのために使用するブローカー名を指定します。JMS をデリバリー・トランスポート機構として指定する場合 (DeliveryTransport プロパティーで指定) は、このコネクター・プロパティーを設定する必要があります。
リモート・メッセージ・ブローカーに接続する場合、このプロパティーに次の値を
指定する必要があります。
QueueMgrName:Channel:HostName:PortNumber
ここで、以下のように説明されます。
QueueMgrName は、キュー・マネージャー名です。
Channel は、クライアントが使用するチャネルです。
HostName は、キュー・マネージャーの配置先のマシン名です。
PortNumber は、キュー・マネージャーが listen に使用するポートの番号です。
例えば、次のように指定します。
jms.MessageBrokerName = WBIMB.Queue.Manager:CHANNEL1:RemoteMachine:1456
デフォルト値は crossworlds.queue.manager です。ローカル・メッセージ・ブローカーに接続する場合は、デフォルト値を使用します。
jms.NumConcurrentRequests プロパティーは、コネクターに対して同時に送信することができる並行サービス呼び出し要求の数 (最大値) を指定します。この最大値に達した場合、新規のサービス呼び出し要求はブロックされ、既存のいずれかの要求が完了した後で処理されます。
デフォルト値は 10 です。
jms.Password プロパティーは、JMS プロバイダーのためのパスワードを指定します。このプロパティーの値はオプションです。
デフォルト値はありません。
jms.TransportOptimized プロパティーは、 WIP (処理中の作業) を最適化するかどうかを決定します。 WIP を最適化するには WebSphere MQ プロバイダーが必要です。 最適化された WIP が作動するには、メッセージング・プロバイダーが次のことを実行できる必要があります。
JMS API は上記の条件 2 と 4 に合わないので、 最適化された WIP に使用することはできませんが、 MQ Java API は 4 つの条件すべてを満たしているので、 最適化された WIP に必要です。
このプロパティーは、DeliveryTransport の値が JMS で BrokerType の値が ICS である場合のみ有効です。
デフォルト値は false です。
jms.UserName プロパティーは、JMS プロバイダーのためのユーザー名を指定します。このプロパティーの値はオプションです。
デフォルト値はありません。
JvmMaxHeapSize プロパティーは、エージェントの最大ヒープ・サイズ (メガバイト単位) を指定します。
このプロパティーは、 RepositoryDirectory プロパティーの値が <REMOTE> に設定されている場合のみ有効です。
デフォルト値は 128M です。
JvmMaxNativeStackSize プロパティーは、エージェントの最大ネイティブ・スタック・サイズ (キロバイト単位) を指定します。
このプロパティーは、 RepositoryDirectory プロパティーの値が <REMOTE> に設定されている場合のみ有効です。
デフォルト値は 128K です。
JvmMinHeapSize プロパティーは、エージェントの最小ヒープ・サイズ (メガバイト単位) を指定します。
このプロパティーは、 RepositoryDirectory プロパティーの値が <REMOTE> に設定されている場合のみ有効です。
デフォルト値は 1M です。
ListenerConcurrency プロパティーは、統合ブローカーとして ICS を使用する場合の WebSphere MQ Listener でのマルチスレッド化をサポートしています。 このプロパティーにより、データベースへの複数イベントの書き込み操作をバッチ処理できるので、システム・パフォーマンスが向上します。
このプロパティーは、MQ トランスポートを使用するコネクターでのみ有効です。 DeliveryTransport プロパティーの値は、MQ にしてください。
デフォルト値は 1 です。
Locale プロパティーは、言語コード、国または地域、および、希望する場合には、関連した文字コード・セットを指定します。 このプロパティーの値は、データの照合やソート順、日時フォーマット、通貨規格で使用されている記号などの国/地域別情報を決定します。
ロケール名は、次の書式で指定します。
ll_TT.codeset
ここで、以下のように説明されます。
ll は、
2 バイト文字の言語コード (小文字) です。
TT は、2 バイト文字の国または地域コード (大文字) です。
codeset は、関連文字コード・セットの名前です (オプション)。
デフォルトでは、サポートされるロケールのサブセットだけがリストされます。 サポートされるほかの値をリストに追加するには、<ProductDir>¥bin ディレクトリー にある ¥Data¥Std¥stdConnProps.xml ファイルを変更します。 詳細については、本書の Connector Configurator の付録を参照してください。
コネクターが国際化に対応していない 場合、このプロパティーの有効な値は en_US のみです。特定のコネクター がグローバル化に対応しているかどうかを判別するには、そのアダプターのユーザーズ・ガイドを参照してください。
デフォルト値は en_US です。
LogAtInterchangeEnd プロパティーは、 統合ブローカーのログ宛先にエラーを記録するかどうかを指定します。
ログ宛先にログを記録すると、電子メール通知もオンになります。これにより、エラーまたは致命的エラーが発生すると、InterchangeSystem.cfg ファイルの MESSAGE_RECIPIENT の値で指定された宛先に対して電子メール・メッセージが生成されます。 例えば、LogAtInterChangeEnd の値が true である場合に コネクターからアプリケーションへの接続が失われると、 指定されたメッセージ宛先に、電子メール・メッセージが送信されます。
このプロパティーは、RespositoryDirectory プロパティーの値 が <REMOTE> (BrokerType は ICS) に設定されている場合のみ有効です。
デフォルト値は false です。
MaxEventCapacity プロパティーは、コントローラー・バッファー内のイベントの最大数を指定します。このプロパティーは、フロー制御フィーチャーによって使用されます。
このプロパティーは、RespositoryDirectory プロパティーの値 が <REMOTE> (BrokerType は ICS) に設定されている場合のみ有効です。
値は 1 から 2147483647 の間の正整数です。
デフォルト値は 2147483647 です。
MessageFileName プロパティーは、コネクター・メッセージ・ファイルの名前を指定します。メッセージ・ファイルの標準位置は、製品ディレクトリーの ¥connectors¥messages です。メッセージ・ファイルが標準位置に格納されていない場合は、メッセージ・ファイル名を絶対パスで指定します。
コネクター・メッセージ・ファイルが存在しない場合は、コネクターは InterchangeSystem.txt をメッセージ・ファイルとして使用します。このファイルは、製品ディレクトリーに格納されています。
デフォルト値は InterchangeSystem.txt です。
MonitorQueue プロパティーは、コネクターが重複イベントをモニターするために使用する論理キューを指定します。
これは DeliveryTransport プロパティーの値が JMS で DuplicateEventElimination の値が true である場合のみ有効です。
デフォルト値は <CONNECTORNAME>/MONITORQUEUE です。
OADAutoRestartAgent プロパティーは、コネクターが自動再始動機能およびリモート再始動機能を使用するかどうかを指定します。この機能では、WebSphere MQ により起動される Object Activation Daemon (OAD) を使用して、異常シャットダウン後にコネクターを再始動したり、System Monitor からリモート・コネクターを始動したりします。
自動再始動機能およびリモート再始動機能を使用可能にするには、このプロパティーを true に設定する必要があります。WebSphere MQ により起動される OAD 機能の構成方法については、「システム・インストール・ガイド (Windows 版)」または「システム・インストール・ガイド (UNIX 版)」を参照してください。
このプロパティーは、RespositoryDirectory プロパティーの値 が <REMOTE> (BrokerType は ICS) に設定されている場合のみ有効です。
デフォルト値は false です。
OADMaxNumRetry プロパティーは、異常シャットダウンの後で WebSphere MQ により起動される Object Activation Daemon (OAD) がコネクターの再始動を自動的に試行する回数の最大数を指定します。このプロパティーを有効にするには、OADAutoRestartAgent プロパティーを true に設定する必要があります。
このプロパティーは、RespositoryDirectory プロパティーの値 が <REMOTE> (BrokerType は ICS) に設定されている場合のみ有効です。
デフォルト値は 1000 です。
OADRetryTimeInterval プロパティーは、 WebSphere MQ により起動される Object Activation Daemon (OAD) の再試行時間間隔の分数を指定します。 コネクター・エージェントがこの再試行時間間隔内に再始動しない場合は、コネクター・コントローラーはコネクター・エージェントを再び再始動するように OAD に要求します。OAD はこの再試行プロセスを OADMaxNumRetry プロパティーで指定された回数だけ繰り返します。 このプロパティーを有効にするには、OADAutoRestartAgent プロパティーを true に設定する必要があります。
このプロパティーは、RespositoryDirectory プロパティーの値 が <REMOTE> (BrokerType は ICS) に設定されている場合のみ有効です。
デフォルト値は 10 です。
PollEndTime プロパティーは、イベント・キューのポーリングを停止する時刻を指定します。 形式は HH:MM です。ここで、HH は 0 から 23 時を表し、MM は 0 から 59 分を表します。
このプロパティーには必ず有効な値を指定してください。デフォルト値は HH:MM で、 値が指定されていないので、これは変更する必要があります。
アダプター・ランタイムが次のことを検出した場合の処理は以下のとおりです。
PollFrequency プロパティーで構成された値を使用してポーリングが実行されます。
PollFrequency プロパティーは、あるポーリング・アクションの終了から次のポーリング・アクションの開始までの時間をミリ秒単位で指定します。これはポーリング・アクション間の間隔ではありません。この論理を次に説明します。
このプロパティーで有効な値は次のとおりです。
デフォルト値は 10000 です。
PollQuantity プロパティーは、コネクターがアプリケーションからポーリングする項目の数を指定します。アダプターにコネクター固有のポーリング数設定プロパティーがある場合、標準プロパティーの値は、このコネクター固有のプロパティーの設定値によりオーバーライドされます。
このプロパティーは、DeliveryTransport プロパティーの値が JMS で ContainerManagedEvents プロパティーに値がある場合のみ有効です。
電子メール・メッセージもイベントと見なされます。コネクターは、電子メールに関するポーリングを受けたときには次のように動作します。
PollStartTime プロパティーは、イベント・キューのポーリングを開始する時刻を指定します。形式は HH:MM です。ここで、HH は 0 から 23 時を表し、MM は 0 から 59 分を表します。
このプロパティーには必ず有効な値を指定してください。デフォルト値は HH:MM で、 値が指定されていないので、これは変更する必要があります。
アダプター・ランタイムが次のことを検出した場合の処理は以下のとおりです。
PollFrequency プロパティーで構成された値を使用してポーリングが実行されます。
RepositoryDirectory プロパティーは、コネクターが XML スキーマ文書を読み取るリポジトリーの場所です。この XML スキーマ文書には、ビジネス・オブジェクト定義のメタデータが含まれています。
統合ブローカーが ICS の場合はこの値を <REMOTE> に設定する必要があります。これは、コネクターが InterChange Server リポジトリーから この情報を取得するためです。
統合ブローカーが WebSphere Message Broker または WAS である場合、この値は デフォルトで <ProductDir>¥repository に設定されます。 ただし、任意の有効なディレクトリー名に設定することもできます。
RequestQueue プロパティーは、統合ブローカーからコネクターへビジネス・オブジェクトが送信されるときに使用されるキューを指定します。
このプロパティーは、DeliveryTransport プロパティーの値が JMS である場合のみ有効です。
デフォルト値は <CONNECTORNAME>/REQUESTQUEUE です。
ResponseQueue プロパティーは、JMS 応答キューを指定します。JMS 応答キューは、応答メッセージをコネクター・フレームワークから統合ブローカーへデリバリーします。統合ブローカーが ICS の場合、サーバーは 要求を送信し、JMS 応答キューの応答メッセージを待ちます。
このプロパティーは、DeliveryTransport プロパティーの値が JMS である場合のみ有効です。
デフォルト値は <CONNECTORNAME>/RESPONSEQUEUE です。
RestartRetryCount プロパティーは、コネクターによるコネクター自体の再始動の試行回数を指定します。このプロパティーを並列に接続されたコネクターに対して使用すると、 マスター・コネクターのアプリケーション固有コンポーネントがクライアント・コネクターのアプリケーション固有コンポーネントの再始動を試行する回数が指定されます。
デフォルト値は 7 です。
RestartRetryInterval プロパティーは、コネクターによるコネクター自体の再始動の試行間隔を分単位で指定します。このプロパティーを並列にリンクされたコネクターに対して使用すると、 マスター・コネクターのアプリケーション固有コンポーネントがクライアント・コネクターのアプリケーション固有コンポーネントの再始動を試行する間隔が指定されます。
このプロパティーで指定できる値は、1 から 2147483647 です。
デフォルト値は 1 です。
ResultsSetEnabled プロパティーは、Information Integrator がアクティブである場合に、 結果セット・サポートを使用可能または使用不可にします。 このプロパティーを使用できるのは、アダプターが DB2 Information Integrator をサポートしている場合のみです。
このプロパティーは、DeliveryTransport プロパティーの値が JMS で BrokerType の値が WMQI である場合のみ有効です。
デフォルト値は false です。
ResultsSetSize プロパティーは、 Information Integrator へ戻すことができるビジネス・オブジェクトの最大数を定義します。 このプロパティーを使用できるのは、アダプターが DB2 Information Integrator をサポートしている場合のみです。
このプロパティーは、 ResultsSetEnabled プロパティーの値が true である場合のみ有効です。
デフォルト値は 0 です。これは、結果セットのサイズが無限であることを意味します。
RHF2MessageDomain プロパティーにより、JMS ヘッダーのドメイン名フィールドの値を構成できます。JMS トランスポートを介してデータを WebSphere メッセージ・ブローカーに送信するときに、アダプター・フレームワークにより JMS ヘッダー情報、ドメイン名、および固定値 mrm が書き込まれます。構成可能ドメイン名を使用すると、 WebSphere メッセージ・ブローカーがメッセージ・データをどのように処理するかを追跡できます。
次に、ヘッダーの例を示します。
<mcd><Msd>mrm</Msd><Set>3</Set><Type>
Retek_POPhyDesc</Type><Fmt>CwXML</Fmt></mcd>
このプロパティーは、BrokerType の値が WMQI または WAS である場合のみ有効です。 また、これは DeliveryTransport プロパティーの値が JMS で WireFormat プロパティーの値が CwXML である場合のみ有効です。
指定できる値は mrm と xml です。 デフォルト値は mrm です。
SourceQueue プロパティーは、JMS イベント・ストアを使用する JMS 対応コネクターでの 保証付きイベント・デリバリーをサポートするコネクター・フレームワークに、JMS ソース・キューを指定します。詳細については、ContainerManagedEventsを参照してください。
このプロパティーは、DeliveryTransport の値が JMS で ContainerManagedEvents の値が指定されている場合のみ有効です。
デフォルト値は <CONNECTORNAME>/SOURCEQUEUE です。
SynchronousRequestQueue プロパティーは、同期応答を要求する要求メッセージを、コネクター・フレームワークからブローカーに配信します。このキューは、コネクターが同期実行を使用する場合にのみ必要です。同期実行の場合、コネクター・フレームワークは、 同期要求キューにメッセージを送信し、同期要求キュー上のブローカーからの応答を待ちます。 コネクターに送信される応答メッセージには、元のメッセージの ID を指定する相関 ID が含まれています。
このプロパティーは、 DeliveryTransport の値が JMS である場合のみ 有効です。
デフォルト値は <CONNECTORNAME>/SYNCHRONOUSREQUESTQUEUE です。
SynchronousRequestTimeout プロパティーは、コネクターが同期要求への応答を待機する時間をミリ秒単位で指定します。コネクターは、指定された時間内に応答を受信できなかった場合、元の同期要求メッセージ (およびエラー・メッセージ) を障害キューに移動させます。
このプロパティーは、 DeliveryTransport の値が JMS である場合のみ 有効です。
デフォルト値は 0 です。
SynchronousResponseQueue プロパティーは、同期要求に対する応答として送信される応答メッセージを、ブローカーからコネクター・フレームワークに配信します。 このキューは、コネクターが同期実行を使用する場合にのみ必要です。
このプロパティーは、DeliveryTransport の値が JMS である場合のみ有効です。
デフォルトは <CONNECTORNAME>/SYNCHRONOUSRESPONSEQUEUE です。
TivoliMonitorTransactionPerformance プロパティーは、 実行時に IBM Tivoli Monitoring for Transaction Performance (ITMTP) を起動するかどうかを指定します。
デフォルト値は false です。
WireFormat プロパティーは、トランスポートでのメッセージ・フォーマットを指定します。
WsifSynchronousRequestTimeout プロパティーは、コネクターが同期要求への応答を待機する時間をミリ秒単位で指定します。 コネクターは、指定された時間内に応答を受信できなかった場合、元の同期要求メッセージ (およびエラー・メッセージ) を障害キューに移動します。
このプロパティーは、BrokerType の値が WAS である場合のみ有効です。
デフォルト値は 0 です。
XMLNameSpaceFormat プロパティーは、ビジネス・オブジェクト定義の XML フォーマットで 短いネーム・スペースまたは長いネーム・スペースを指定します。
このプロパティーは、BrokerType の値が WMQI または WAS に設定されている場合のみ有効です。
デフォルト値は short です。