コネクターの構成

Adapter for iSeries の構成には、次のセクションで説明する標準コネクター・プロパティーを使用します。また、その次のセクションで説明するコネクター固有のプロパティーも使用します。

このセクションには、以下のトピックがあります。

Connector Configurator の概要

Connector Configurator では、次の統合ブローカーで使用するアダプターの コネクター・コンポーネントを構成できます。

Connector Configurator を使用して次の作業を行います。

Connector Configurator の実行モードと使用する構成ファイルのタイプは、実行する 統合ブローカーによって異なります。例えば、使用している統合ブローカーが WMQI の場合、Connector Configurator を System Manager から実行するのではなく、直接実行します (スタンドアロン・モードでのコンフィギュレーターの実行を参照)。

コネクター構成プロパティーには、標準の構成プロパティー (すべてのコネクターがもつプロパティー) と、コネクター固有のプロパティー (特定のアプリケーションまたはテクノロジーのためにコネクターで必要なプロパティー) とが含まれます。

標準プロパティーはすべてのコネクターにより使用されるので、標準プロパティーを新規に定義する必要はありません。ファイルを作成すると、Connector Configurator により標準プロパティーがこの構成ファイルに挿入されます。ただし、Connector Configurator で各標準プロパティーの値を設定する必要があります。

標準プロパティーの範囲は、ブローカーと構成によって異なる可能性があります。特定のプロパティーに特定の値が設定されている場合にのみ使用できるプロパティーがあります。Connector Configurator の「標準のプロパティー」ウィンドウには、特定の構成で設定可能なプロパティーが表示されます。

ただしコネクター固有プロパティーの場合は、最初にプロパティーを定義し、その値を設定する必要があります。このため、特定のアダプターのコネクター固有プロパティーのテンプレートを作成します。システム内で既にテンプレートが作成されている場合には、作成されているテンプレートを使用します。システム内でまだテンプレートが作成されていない場合には、新規テンプレートの作成のステップに従い、テンプレートを新規に作成します。

注:
Connector Configurator は、Windows 環境内でのみ実行されます。UNIX 環境でコネクターを実行する場合には、Windows で Connector Configurator を使用して構成ファイルを変更し、このファイルを UNIX 環境へコピーします。

Connector Configurator の始動

以下の 2 種類のモードで Connector Configurator を開始および実行できます。

スタンドアロン・モードでのコンフィギュレーターの実行

どのブローカーを実行している場合にも、Connector Configurator を個別に実行し、コネクター構成ファイルを編集できます。

これを行うには、以下のステップを実行します。

Connector Configurator を個別に実行して構成ファイルを生成してから、System Manager に接続してこの構成ファイルを System Manager プロジェクトに保存することもできます (構成ファイルの完成を参照)。

System Manager からのコンフィギュレーターの実行

System Manager から Connector Configurator を実行できます。

Connector Configurator を実行するには、以下のステップを実行します。

  1. System Manager を開きます。
  2. 「System Manager」ウィンドウで、「統合コンポーネント・ライブラリー 」アイコンを展開し、「コネクター」を強調表示します。
  3. System Manager メニュー・バーから、「ツール」>「Connector Configurator」をクリックします。「Connector Configurator」ウィンドウが開き、「新規コネクター」ダイアログ・ボックスが表示されます。
  4. 「システム接続統合ブローカー (System Connectivity Integration Broker)」の隣のプルダウン・メニューをクリックします。使用しているブローカーに応じて、ICS、WebSphere Message Brokers、WAS のいずれかを選択します。

既存の構成ファイルを編集するには、以下のステップを実行します。

コネクター固有のプロパティー・テンプレートの作成

コネクターの構成ファイルを作成するには、コネクター固有プロパティーのテンプレートとシステム提供の標準プロパティーが必要です。

コネクター固有プロパティーのテンプレートを新規に作成するか、または既存のコネクター定義をテンプレートとして使用します。

新規テンプレートの作成

このセクションでは、テンプレートでプロパティーを作成し、プロパティーの一般特性および値を定義し、プロパティー間の依存関係を指定する方法について説明します。次にそのテンプレートを保管し、新規コネクター構成ファイルを作成するためのベースとして使用します。

Connector Configurator でテンプレートを作成するには、以下のステップを実行します。

  1. 「ファイル」>「新規」>「コネクター固有プロパティー・テンプレート」をクリックします。
  2. 「コネクター固有プロパティー・テンプレート」ダイアログ・ボックスが表示されます。
  3. テンプレートを 作成するときには、ご使用のコネクターに必要なプロパティー定義に類似したプロパティー定義 が含まれている既存のテンプレートを使用できます。ご使用のコネクターで使用するコネクター固有のプロパティーが表示されるテンプレートが見つからない場合は、自分で作成する必要があります。
一般特性の指定

「次へ」をクリックしてテンプレートを選択すると、「プロパティー: コネクター固有プロパティー・テンプレート」ダイアログ・ボックスが表示されます。このダイアログ・ボックスには、定義済みプロパティーの「一般」特性のタブと「値」の制限のタブがあります。「一般」表示には以下のフィールドがあります。

プロパティーの一般特性の選択を終えたら、「値」タブをクリックします。

値の指定

「値」タブを使用すると、プロパティーの最大長、最大複数値、デフォルト値、または値の範囲を設定できます。編集可能な値も許可されます。これを行うには、以下のステップを実行します。

  1. 「値」タブをクリックします。「一般」のパネルに代わって「値」の表示パネルが表示されます。
  2. 「プロパティーを編集」表示でプロパティーの名前を選択します。
  3. 「最大長」および「最大複数値」のフィールドに値を入力します。

新規プロパティー値を作成するには、以下のステップを実行します。

  1. 「プロパティーを編集」リストでプロパティーを選択し、右マウス・ボタンでクリックします。
  2. ダイアログ・ボックスから「追加」を選択します。
  3. 新規プロパティー値の名前を入力し、「OK」をクリックします。右側の「値」パネルに値が表示されます。

「値」パネルには、3 つの列からなるテーブルが表示されます。

「値」の列には、「プロパティー値」ダイアログ・ボックスで入力した値と、以前に作成した値が表示されます。

「デフォルト値」の列では、値のいずれかをデフォルトとして指定することができます。

「値の範囲」の列には、「プロパティー値」ダイアログ・ボックスで入力した範囲が表示されます。

値が作成されて、グリッドに表示されると、そのテーブルの表示内から編集できるようになります。

テーブルにある既存の値の変更を行うには、その行の行番号をクリックして行全体を選択します。次に「値」フィールドを右マウス・ボタンでクリックし、「値の編集 (Edit Value)」をクリックします。

依存関係の設定

「一般」タブと「値」タブで変更を行ったら、「次へ」をクリックします。「依存関係: コネクター固有プロパティー・テンプレート」ダイアログ・ボックスが表示されます。

依存プロパティーは、別のプロパティーの値が特定の条件に合致する場合にのみ、テンプレートに組み込まれて、構成ファイルで使用されるプロパティーです。例えば、テンプレートに PollQuantity が表示されるのは、トランスポート機構 が JMS であり、DuplicateEventEliminationTrue に設定 されている場合のみです。
プロパティーを依存プロパティーとして指定し、依存する条件を設定するには、以下のステップを実行します。

  1. 「使用可能なプロパティー」表示で、依存プロパティーとして指定するプロパティーを選択します。
  2. 「プロパティーを選択」フィールドで、ドロップダウン・メニューを使用して、条件値を持たせるプロパティーを選択します。
  3. 「条件演算子」フィールドで以下のいずれかを選択します。

    == (等しい)

    != (等しくない)

    > (より大)

    < (より小)

    >= (より大か等しい)

    <= (より小か等しい)

  4. 「条件値」フィールドで、依存プロパティーをテンプレートに組み込むために必要な値を入力します。
  5. 「使用可能なプロパティー」表示で依存プロパティーを強調表示させて矢印をクリックし、「依存プロパティー」表示に移動させます。
  6. 「完了」をクリックします。Connector Configurator により、XML 文書として入力した情報が、Connector Configurator がインストールされている ¥bin ディレクトリーの ¥data¥app の下に保管されます。

新規構成ファイルの作成

構成ファイルを新規に作成するには、構成ファイルの名前を指定し、統合ブローカーを選択する必要があります。

また、統合ブローカーも選択する必要があります。選択したブローカーによって、構成ファイルに記述されるプロパティーが決まります。ブローカーを選択するには、以下のステップを実行します。

コネクター固有のテンプレートからの構成ファイルの作成

コネクター固有のテンプレートを作成すると、テンプレートを使用して構成ファイルを作成できます。

  1. 「ファイル」>「新規」>「コネクター構成」をクリックします。
  2. 以下のフィールドを含む「新規コネクター」ダイアログ・ボックス表示されます。
  3. 構成しているコネクターの構成画面が表示されます。タイトル・バーに統合ブローカーとコネクターの名前が表示されます。ここですべてのフィールドに値を入力して定義を完了するか、ファイルを保管して後でフィールドに値を入力するかを選択できます。
  4. ファイルを保管するには、「ファイル」>「保管」>「ファイルに」をクリックするか、「ファイル」>「保管」>「プロジェクトに」をクリックします。プロジェクトに保管するには、System Manager が実行中でなければなりません。

    ファイルとして保管する場合は、「ファイル・コネクターを保管」ダイアログ・ボックスが表示されます。*.cfg をファイル・タイプとして選択し、「ファイル名」フィールド内に名前が正しいスペル (大文字と小文字の区別を含む) で表示されていることを確認してから、ファイルを保管するディレクトリーにナビゲートし、「保管」をクリックします。Connector Configurator のメッセージ・パネルの状況表示に、構成ファイルが正常に作成されたことが示されます。
    重要:
    ここで設定するディレクトリー・パスおよび名前は、コネクターの始動ファイルで指定するコネクター構成ファイルのパスおよび名前に一致している必要があります。
  5. この章で後述する手順に従って、「Connector Configurator」ウィンドウの各タブにあるフィールドに値を入力し、コネクター定義を完了します。

既存ファイルの使用

使用可能な既存ファイルは、以下の 1 つまたは複数の形式になります。

これらのいずれのファイル・ソースにも、コネクターのコネクター固有プロパティーのほとんど、あるいはすべてが含まれますが、この章内の後で説明するように、コネクター構成ファイルは、ファイルを開いて、プロパティーを設定しない限り完成しません。

既存ファイルを使用してコネクターを構成するには、Connector Configurator でそのファイルを開き、構成を修正し、そのファイルを再度保管する必要があります。

以下のステップを実行して、ディレクトリーから *.txt、*.cfg、または *.in ファイルを開きます。

  1. Connector Configurator 内で、「ファイル」>「開く」>「ファイルから」をクリックします。
  2. 「ファイル・コネクターを開く」ダイアログ・ボックス内で、以下のいずれかのファイル・タイプを選択して、使用可能なファイルを調べます。
  3. ディレクトリー表示内で、適切なコネクター定義ファイルへ移動し、ファイルを選択し、「開く」をクリックします。

System Manager プロジェクトからコネクター構成を開くには、以下のステップを実行します。

  1. System Manager を始動します。System Manager が開始されている場合にのみ、構成を System Manager から開いたり、System Manager に保管したりできます。
  2. Connector Configurator を始動します。
  3. 「ファイル」>「開く」>「プロジェクトから」をクリックします。

構成ファイルの完成

構成ファイルを開くか、プロジェクトからコネクターを開くと、「Connector Configurator」ウィンドウに構成画面が表示されます。この画面には、現在の属性と値が表示されます。

構成画面のタイトルには、ファイル内で指定された統合ブローカーとコネクターの名前が表示されます。正しいブローカーが設定されていることを確認してください。正しいブローカーが設定されていない場合、コネクターを構成する前にブローカー値を変更してください。これを行うには、以下のステップを実行します。

  1. 「標準のプロパティー」タブで、BrokerType プロパティーの値フィールドを選択します。ドロップダウン・メニューで、値 ICSWMQI、または WAS を選択します。
  2. 選択したブローカーに関連付けられているプロパティーが「標準のプロパティー」タブに表示されます。ここでファイルを保管するか、または サポートされるビジネス・オブジェクト定義の指定の説明に従い、残りの構成フィールドに値を入力することができます。
  3. 構成が完了したら、「ファイル」>「保管」>「プロジェクトに」を選択するか、または「ファイル」>「保管」>「ファイルに」を選択します。

    ファイルに保管する場合は、*.cfg を拡張子として選択し、ファイルの正しい格納場所を選択して、「保管」をクリックします。

    複数のコネクター構成を開いている場合、構成をすべてファイルに保管するには「すべてファイルに保管」を選択し、コネクター構成をすべて System Manager プロジェクトに保管するには「すべてプロジェクトに保管」をクリックします。

    Connector Configurator では、ファイルを保管する前に、必須の標準プロパティーすべてに値が設定されているかどうかが確認されます。必須の標準プロパティーに値が設定されていない場合、Connector Configurator は、検証が失敗したというメッセージを表示します。構成ファイルを保管するには、そのプロパティーの値を指定する必要があります。

構成ファイル・プロパティーの設定

新規のコネクター構成ファイルを作成して名前を付けるとき、または既存のコネクター構成ファイルを開くときには、Connector Configurator によって構成画面が表示されます。構成画面には、必要な構成値のカテゴリーに対応する複数のタブがあります。

Connector Configurator では、すべてのブローカーで実行されているコネクターで、以下のカテゴリーのプロパティーに値が設定されている必要があります。

注:
JMS メッセージングを使用するコネクターの場合は、データをビジネス・オブジェクトに変換するデータ・ハンドラーの構成に関して追加のカテゴリーが表示される場合があります。

ICS で実行されているコネクターの場合、以下のプロパティーの値も設定されている必要があります。

重要:
Connector Configurator では、英語文字セットまたは英語以外の文字セットのいずれのプロパティー値も設定可能です。ただし、標準のプロパティーおよびコネクター固有プロパティー、およびサポートされるビジネス・オブジェクトの名前では、英語文字セットのみを使用する必要があります。

標準プロパティーとコネクター固有プロパティーの違いは、以下のとおりです。

「標準プロパティー」「コネクター固有プロパティー」のフィールドは、どのフィールドが構成可能であるかを示すために色分けされています。

標準コネクター・プロパティーの設定

標準構成プロパティーにより、すべてのコネクターによって使用される情報が提供されます。標準構成プロパティーの資料については、付録. コネクターの標準構成プロパティーを参照してください。

重要:
本書で解説するコネクターはすべての統合ブローカーをサポートしているため、関係する構成プロパティーは、すべてのブローカーに適合する構成プロパティーのみになります。

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

標準のプロパティーの値を変更するには、以下のステップを実行します。

  1. 値を設定するフィールド内でクリックします。
  2. 値を入力するか、ドロップダウン・メニューが表示された場合にはメニューから値を選択します。
  3. 標準のプロパティーの値をすべて入力後、以下のいずれかを実行することができます。
コネクター固有のプロパティー

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

表 2 に、コネクターのコネクター固有の構成プロパティーをリストします。各プロパティーの説明については、以降のセクションを参照してください。

表 2. コネクター固有の構成プロパティー
名前 指定可能な値 デフォルト値 必須
ApplicationName iSeriesAdapter なし はい
UseDefaults デフォルト値 なし はい
MessageFileName BIA_iSeriesAdapter.txt BIA_iSeriesAdapter.txt いいえ
PollQuantity 1 より大きな整数 1 いいえ
ApplicationName

各コネクターに指定する必要がある、固有の名前です。

UseDefaults

例えば、プログラムの入力パラメーターの一部は、値が一定です。これらを表す属性は、デフォルト値を持つように設計することができます。UseDefaults プロパティーが trueに設定されている場合、デフォルト値が指定されていなければ、アダプターはエラーにより停止し、エラー・メッセージ VerbProcessingFailedException をスローします。UseDefaults が設定されていない場合や false, に設定されている場合は、デフォルト値が指定されていなければ、MaxLength に指定されている長さになるようにスペースを埋め込んだストリングが属性の値としてアダプターで作成されます。

MessageFileName

エラー・メッセージ・ファイルの名前とパスです。エラー・メッセージ・ファイルがメッセージの標準位置である %CROSSWORLDS%¥connectors¥messages にない場合に指定します。メッセージ・ファイル名が完全修飾パスでない場合、メッセージ・ファイルは、HOME 環境変数、または起動パラメーター user.home で指定されたディレクトリー内にあるとみなされます。コネクター・メッセージ・ファイルが存在しない場合は、ファイル BIA_iSeriesAdapter.txt がメッセージ・ファイルとして使用されます。

PollQuantity

PollQuantity は 1 より大きな整数値で、データ・キューからポーリングする項目の数を指定します。PollQuantity の値として n を指定すると、メタオブジェクトを使用して構成された各キューは n 回ポーリングされることに注意してください。デフォルト値は 1 になります。

アプリケーション固有の構成プロパティーの設定

アプリケーション固有の構成プロパティーの場合、プロパティー名の追加または変更、値の構成、プロパティーの削除、およびプロパティーの暗号化が可能です。プロパティーのデフォルトの長さは 255 文字です。

  1. グリッドの左上端の部分で右マウス・ボタンをクリックします。ポップアップ・メニュー・バーが表示されます。プロパティーを追加するときは「追加」をクリックします。子プロパティーを追加するには、親の行番号を右マウス・ボタンでクリックし、「子を追加」をクリックします。
  2. プロパティーまたは子プロパティーの値を入力します。
  3. プロパティーを暗号化するには、「暗号化」ボックスを選択します。
  4. 標準コネクター・プロパティーの設定で説明したように、変更内容を保管するかまたは破棄するかを選択します。

各プロパティーごとに表示される「更新メソッド」は、変更された値をアクティブにするためにコンポーネント またはエージェントの再始動が必要かどうかを示します。

重要:
事前設定のアプリケーション固有のコネクター・プロパティー名を変更すると、コネクターに障害が発生する可能性があります。コネクターをアプリケーションに接続したり正常に実行したりするために、特定のプロパティー名が必要である場合があります。
コネクター・プロパティーの暗号化

「コネクター固有プロパティー」ウィンドウの「暗号化」チェック・ボックスにチェックマークを付けると、アプリケーション固有のプロパティーを暗号化することができます。値の暗号化を解除するには、「暗号化」チェック・ボックスをクリックしてチェックマークを外し、「検証」ダイアログ・ボックスに正しい値を入力し、「OK」をクリックします。入力された値が正しい場合は、暗号化解除された値が表示されます。

各プロパティーとそのデフォルト値のリストおよび説明は、各コネクターのアダプター・ユーザーズ・ガイドにあります。

プロパティーに複数の値がある場合には、プロパティーの最初の値に「暗号化」チェック・ボックスが表示されます。「暗号化」を選択すると、そのプロパティーのすべての値が暗号化されます。プロパティーの複数の値を 暗号化解除するには、そのプロパティーの最初の値の「暗号化」チェック・ボックスを クリックしてチェックマークを外してから、「検証」ダイアログ・ボックス で新規の値を入力します。 入力値が一致すれば、すべての複数値が暗号化解除されます。

更新メソッド

付録 A『コネクターの標準構成プロパティー』の 構成プロパティー値の概要にある更新メソッドの説明を参照してください。

サポートされるビジネス・オブジェクト定義の指定

コネクターで使用するビジネス・オブジェクトを指定するには、Connector Configurator の「サポートされているビジネス・オブジェクト」タブを使用します。汎用ビジネス・オブジェクトと、アプリケーション固有のビジネス・オブジェクトの両方を指定する必要があり、またそれらのビジネス・オブジェクト間のマップの関連を指定することが必要です。

注:
コネクターによっては、アプリケーションでイベント通知や (メタオブジェクトを使用した) 追加の構成を実行するために、特定のビジネス・オブジェクトをサポートされているものとして指定することが必要な場合もあります。詳細は、「コネクター開発ガイド (C++ 用)」または 「コネクター開発ガイド (Java 用)」を参照してください。
ご使用のブローカーが ICS の場合

ビジネス・オブジェクト定義がコネクターでサポートされることを指定する場合や、既存のビジネス・オブジェクト定義のサポート設定を変更する場合は、「サポートされているビジネス・オブジェクト」タブをクリックし、以下のフィールドを使用してください。

ビジネス・オブジェクト名

ビジネス・オブジェクト定義がコネクターによってサポートされる ことを指定するには、System Manager を実行し、以下のステップを実行します。

  1. 「ビジネス・オブジェクト名」リストで空のフィールドをクリックします。System Manager プロジェクトに存在するすべてのビジネス・オブジェクト定義を示すドロップダウン・リストが表示されます。
  2. 追加するビジネス・オブジェクトをクリックします。
  3. ビジネス・オブジェクトの「エージェント・サポート」(以下で説明) を設定します。
  4. 「Connector Configurator」ウィンドウの「ファイル」メニューで、「プロジェクトに保管」をクリックします。追加したビジネス・オブジェクト定義に指定されたサポートを含む、変更されたコネクター定義が、System Manager の ICL (Integration Component Library) プロジェクトに保管されます。

サポートされるリストからビジネス・オブジェクトを削除する場合は、以下のステップを実行します。

  1. ビジネス・オブジェクト・フィールドを選択するため、そのビジネス・オブジェクトの左側の番号をクリックします。
  2. 「Connector Configurator」ウィンドウの「編集」メニューから、「行を削除」をクリックします。リスト表示からビジネス・オブジェクトが除去されます。
  3. 「ファイル」メニューから、「プロジェクトの保管」をクリックします。

サポートされるリストからビジネス・オブジェクトを削除すると、コネクター定義が 変更され、削除されたビジネス・オブジェクトはコネクターのこのインプリメンテーションで 使用不可になります。コネクターのコードに影響したり、そのビジネス・オブジェクト定義 そのものが System Manager から削除されることはありません。

エージェント・サポート

ビジネス・オブジェクトがエージェント・サポートを備えている場合、システムは、コネクター・エージェントを介してアプリケーションにデータを配布する際に そのビジネス・オブジェクトの使用を試みます。

一般に、コネクターのアプリケーション固有ビジネス・オブジェクトは、そのコネクターのエージェントによってサポートされますが、汎用ビジネス・オブジェクトはサポートされません。

ビジネス・オブジェクトがコネクター・エージェントによってサポートされるよう 指定するには、「エージェント・サポート」ボックスに チェックマークを付けます。「Connector Configurator」ウィンドウでは「エージェント・サポート」の選択の妥当性は検査されません。

最大トランザクション・レベル

コネクターの最大トランザクション・レベルは、そのコネクターがサポートする 最大のトランザクション・レベルです。

ほとんどのコネクターの場合、選択可能な項目は「最大限の努力」のみです。

トランザクション・レベルの変更を有効にするには、サーバーを再始動する必要があります。

ご使用のブローカーが WebSphere Message Broker の場合

スタンドアロン・モードで作業している (System Manager に接続していない) 場合、手動で ビジネス・オブジェクト名を入力する必要があります。

System Manager を実行している場合、「サポートされているビジネス・オブジェクト」タブの「ビジネス・オブジェクト名」列の下にある空のボックスを選択できます。コンボ・ボックスが表示され、コネクターが属する統合コンポーネント・ライブラリー・プロジェクトから選択可能なビジネス・オブジェクト のリストが示されます。リストから必要なビジネス・オブジェクトを選択します。

WebSphere Business Integration Message Broker 5.0 を使用している場合、「メッセージ・セット ID」はオプションのフィールドです。値を指定するときは、固有の値を指定しなくてもかまいません。ただし、WebSphere MQ Integrator 2.1 または WebSphere MQ Integrator Broker 2.1 を使用している場合は、固有の ID を指定する必要があります。

ご使用のブローカーが WAS の場合

使用するブローカー・タイプとして WebSphere Application Server を 選択した場合、Connector Configurator にメッセージ・セット ID は必要ありません。「サポートされているビジネス・オブジェクト」タブ には、サポートされるビジネス・オブジェクトの「ビジネス・オブジェクト名」列のみ が表示されます。

スタンドアロン・モードで作業している (System Manager に接続していない) 場合、手動で ビジネス・オブジェクト名を入力する必要があります。

System Manager を実行している場合、「サポートされているビジネス・オブジェクト」タブ の「ビジネス・オブジェクト名」列の下にある空のボックスを選択できます。コンボ・ボックスが表示され、コネクターが属する統合コンポーネント・ライブラリー・プロジェクトから選択可能なビジネス・オブジェクト のリストが示されます。このリストから必要なビジネス・オブジェクトを選択します。

関連付けられたマップ (ICS のみ)

各コネクターは、現在 WebSphere InterChange Server でアクティブなビジネス・オブジェクト定義、およびそれらの関連付けられたマップのリストをサポートします。このリストは、「関連付けられたマップ」タブを選択すると表示されます。

ビジネス・オブジェクトのリストには、エージェントでサポートされるアプリケーション固有のビジネス・オブジェクトと、コントローラーがサブスクライブ・コラボレーションに送信する、対応する汎用オブジェクトが含まれます。マップの関連によって、アプリケーション固有のビジネス・オブジェクトを汎用ビジネス・オブジェクトに変換したり、汎用ビジネス・オブジェクトをアプリケーション固有のビジネス・オブジェクトに変換したりするときに、どのマップを使用するかが決定されます。

特定のソースおよび宛先ビジネス・オブジェクトについて一意的に定義されたマップを使用する場合、表示を開くと、マップは常にそれらの該当するビジネス・オブジェクトに関連付けられます。ユーザーがそれらを変更する必要はありません (変更できません)。

サポートされるビジネス・オブジェクトで使用可能なマップが複数ある場合は、そのビジネス・オブジェクトを、使用する必要のあるマップに明示的にバインドすることが必要になります。

「関連付けられたマップ」タブには以下のフィールドが表示されます。

リソース (ICS)

「リソース」タブでは、コネクター・エージェントが、コネクター・エージェント並列処理を使用して 同時に複数のプロセスを処理するかどうか、またどの程度処理するかを決定する値を設定できます。

すべてのコネクターがこの機能をサポートしているわけではありません。複数のプロセスを使用するよりも複数の スレッドを使用する方が通常は効率的であるため、Java でマルチスレッドとして 設計されたコネクター・エージェントを実行している場合、この機能を使用することは お勧めできません。

メッセージング (ICS)

メッセージング・プロパティーは、DeliveryTransport 標準プロパティーの値として MQ を設定し、ブローカー・タイプとして ICS を設定した場合にのみ、使用可能です。これらのプロパティーは、コネクターによるキューの使用方法に影響します。

トレース/ログ・ファイル値の設定

コネクター構成ファイルまたはコネクター定義ファイルを開くと、Connector Configurator は、そのファイルのログおよびトレースの値をデフォルト値として使用します。Connector Configurator 内でこれらの値を変更できます。

ログとトレースの値を変更するには、以下のステップを実行します。

  1. 「トレース/ログ・ファイル」タブをクリックします。
  2. ログとトレースのどちらでも、以下のいずれかまたは両方へのメッセージの書き込みを選択できます。

データ・ハンドラー

データ・ハンドラー・セクションの構成が使用可能となるのは、DeliveryTransport の値に JMS を、また ContainerManagedEvents の値に JMS を指定した場合のみです。すべてのアダプターでデータ・ハンドラーを使用できるわけではありません。

これらのプロパティーに使用する値については、付録 A『コネクターの標準構成プロパティー』にある ContainerManagedEvents の下の説明を参照してください。その他の詳細は、「コネクター開発ガイド (C++ 用)」または 「コネクター開発ガイド (Java 用)」を参照してください。

構成ファイルの保管

コネクターの構成が完了したら、コネクター構成ファイルを保管します。Connector Configurator では、構成中に選択したブローカー・モードで構成ファイルを保管します。Connector Configurator のタイトル・バーには現在のブローカー・モード (ICS、WMQI、または WAS) が常に表示されます。

ファイルは XML 文書として保管されます。XML 文書は次の 3 通りの方法で保管できます。

System Manager でのプロジェクトの使用法、および配置の詳細については、以下のインプリメンテーション・ガイドを参照してください。

構成ファイルの変更

既存の構成ファイルの統合ブローカー設定を変更できます。これにより、他のブローカーで使用する構成ファイルを新規に作成するときに、このファイルをテンプレートとして使用できます。

注:
統合ブローカーを切り替える場合には、ブローカー・モード・プロパティーと同様に他の構成プロパティーも変更する必要があります。

既存の構成ファイルでのブローカーの選択を変更するには、以下のステップを実行します (オプション)。

構成の完了

コネクターの構成ファイルを作成し、そのファイルを変更した後で、コネクターの始動時にコネクターが構成ファイルの位置を特定できるかどうかを確認してください。

これを行うには、コネクターが使用する始動ファイルを開き、コネクター構成ファイルに 使用されている格納場所とファイル名が、ファイルに対して指定した名前およびファイルを格納したディレクトリーまたはパスと正確に一致しているかどうかを検証します。

グローバル化環境における Connector Configurator の使用

Connector Configurator はグローバル化され、構成ファイルと統合ブローカー 間の文字変換を処理できます。 Connector Configurator では、ネイティブなエンコード方式を使用しています。構成ファイルに書き込む場合は UTF-8 エンコード方式を使用します。

Connector Configurator は、以下の場所で英語以外の文字をサポートします。

CharacterEncoding および Locale 標準構成プロパティーのドロップ・リストに表示されるのは、サポートされる値の一部のみです。ドロップ・リストに、サポートされる他の値を追加するには、製品ディレクトリーの ¥Data¥Std¥stdConnProps.xml ファイルを手動で変更する必要があります。

例えば、Locale プロパティーの値のリストにロケール en_GB を追加するには、stdConnProps.xml ファイルを開き、以下に太字で示した行を追加してください。

<Property name="Locale"
 isRequired="true"
 updateMethod="component restart">
                 <ValidType>String</ValidType>
             <ValidValues>
                                 <Value>ja_JP</Value>
                                 <Value>ko_KR</Value>
                                 <Value>zh_CN</Value>
                                 <Value>zh_TW</Value>
                                 <Value>fr_FR</Value>
                                 <Value>de_DE</Value>
                                 <Value>it_IT</Value>
                                 <Value>es_ES</Value>
                                 <Value>pt_BR</Value>
                                 <Value>en_US</Value>
                                 <Value>en_GB</Value>
                    <DefaultValue>en_US</DefaultValue>
             </ValidValues>
     </Property>

コネクターの始動

コネクターは、コネクター始動スクリプトを使用して明示的に始動する必要があります。Windows システムでは、始動スクリプトは、次に示すようなコネクターのランタイム・ディレクトリーに存在していなければなりません。

ProductDir¥connectors¥connName

ここで、connName はコネクターを示します。

UNIX システムでは、始動スクリプトは、UNIX ProductDir/bin ディレクトリーに存在していなければなりません。

始動スクリプトの名前は、表 3 に示すように、オペレーティング・システム・プラットフォームによって異なります。

表 3. コネクターの始動スクリプト
オペレーティング・システム 始動スクリプト
UNIX ベースのシステム connector_manager
Windows start_connName.bat

始動スクリプトは、実行時に、 デフォルトで Productdir (以下のコマンドを参照) に構成ファイル があることを予期します。 これは、構成ファイルを置く場所です。

注:
アダプターが JMS トランスポートを使用している場合は、 ローカル構成ファイルが必要です。

コネクター始動スクリプトは、以下に示すいずれかの方法で起動することができます。

コマンド行の始動オプションなどのコネクターの始動方法の詳細については、以下の資料のいずれかを参照してください。

コネクターの停止

コネクターを停止する方法は、以下に示すように、コネクターが始動された方法によって異なります。

複数のコネクター・インスタンスの作成

コネクターの複数のインスタンスを作成する作業は、いろいろな意味で、カスタム・コネクターの作成と同じです。以下に示すステップを実行することによって、コネクターの複数のインスタンスを作成して実行するように、ご使用のシステムを設定することができます。次のようにする必要があります。

新規ディレクトリーの作成

それぞれのコネクター・インスタンスごとにコネクター・ディレクトリーを作成する必要があります。このコネクター・ディレクトリーには、次の名前を付けなければなりません。

ProductDir¥connectors¥connectorInstance

ここで connectorInstance は、コネクター・インスタンスを一意的に示します。

コネクターに、コネクター固有のメタオブジェクトがある場合、コネクター・インスタンス用のメタオブジェクトを作成する必要があります。メタオブジェクトをファイルとして保管する場合は、次のディレクトリーを作成して、ファイルをそこに格納します。

ProductDir¥repository¥connectorInstance
ビジネス・オブジェクト定義の作成

各コネクター・インスタンスのビジネス・オブジェクト定義がプロジェクト内にまだ存在しない場合は、それらを作成する必要があります。

  1. 初期コネクターに関連付けられているビジネス・オブジェクト定義を変更する必要がある場合は、適切なファイルをコピーし、Business Object Designer を使用してそれらのファイルをインポートします。初期コネクターの任意のファイルをコピーできます。変更を加えた場合は、名前を変更してください。
  2. 初期コネクターのファイルは、次のディレクトリーに入っていなければなりません。
    ProductDir¥repository¥initialConnectorInstance
    作成した追加ファイルは、ProductDir¥repository の適切な connectorInstance サブディレクトリー内に存在している必要があります。
コネクター定義の作成

Connector Configurator 内で、コネクター・インスタンスの構成ファイル (コネクター定義) を作成します。これを行うには、以下のステップを実行します。

  1. 初期コネクターの構成ファイル (コネクター定義) をコピーし、名前変更します。
  2. 各コネクター・インスタンスが、サポートされるビジネス・オブジェクト (および関連メタオブジェクト) を正しくリストしていることを確認します。
  3. 必要に応じて、コネクター・プロパティーをカスタマイズします。
始動スクリプトの作成

始動スクリプトは以下のように作成します。

  1. 初期コネクターの始動スクリプトをコピーし、コネクター・ディレクトリーの名前を含む名前を付けます。

    dirname

  2. この始動スクリプトを、新規ディレクトリーの作成で作成したコネクター・ディレクトリーに格納します。
  3. 始動スクリプトのショートカットを作成します (Windows のみ)。
  4. 初期コネクターのショートカット・テキストをコピーし、新規コネクター・インスタンスの名前に一致するように (コマンド行で) 初期コネクターの名前を変更します。

これで、ご使用の統合サーバー上でコネクターの両方のインスタンスを同時に実行することができます。

カスタム・コネクター作成の詳細については、「コネクター開発ガイド (C++ 用)」または「コネクター開発ガイド (Java 用)」を参照してください。

Copyright IBM Corp. 2003, 2005