このセクション (DM_LOCAL_SERVICES セクションとうもいう) では、BEA Tuxedo サービスおよび /Q キュー・スペースを BEA TOP END システムが使用するために必要なマッピング情報を定義します。このセクションは、TOP END Domain Gateway で必要となります。

TEDG 用に記述された DMCONFIG ファイルの場合、DM_EXPORT セクションでは次のエントリを定義します。

DM_EXPORT セクションのエントリの形式は次のいずれかです。

service [TYPE=SERVICE]required_parameters [optional_parameters]

qspace  TYPE=QSPACE required_parameters [optional_parameters]

qname   TYPE=QNAME required_parameters [optional_parameters]

service はエクスポートされたBEA Tuxedo サービスの名前、qspace はエクスポートされた BEA Tuxedo キュー・スペースの名前、qname は BEA Tuxedo キュー・スペース内で定義されたキューの名前です。それぞれの名前は 15 文字以内で指定します。エントリのタイプは、TYPE パラメータの設定値 (SERVICE、QSPACE、QNAME) によって決まります。

DM_EXPORT セクションの SERVICE エントリでは、TEDG によって BEA TOP END システムに対して宣言される BEA Tuxedo サービスを定義します。BEA TOP END システムに対して宣言される BEA Tuxedo サービスのエントリには、BEA Tuxedo サービス名から BEA TOP END サービス識別子 (製品、関数、ターゲット、修飾子) へのマッピングが指定されます。これらのサービス識別子は、BEA TOP END の tp_client_send(3T) および tp_client_signon(3T) ルーチン呼び出しで使用されます。

DM_EXPORT セクションの QSPACE エントリでは、BEA TOP END が RTQ キューとして使用できる BEA Tuxedo キュー・スペースを定義します (制限あり)。RTQ キューは、RTQ グループ名、RTQ キュー名、およびターゲット名を BEA TOP END サービス名として宣言することにより、BEA TOP END で使用可能になります。BEA TOP END ゲートウェイは、その RTQ キュー名に送信された tp_rtq_put(3T) 要求を、RTQ サーバと同じような方法で処理します。次に、各要求はこの QSPACE エントリで識別される BEA Tuxedo キュー・スペースにマッピングされます。メッセージのキュー処理には QSPACE エントリと QNAME エントリの両方が必要です。

DM_EXPORT セクションの QNAME エントリでは、RTQ を通して要求を BEA Tuxedo システムのキューに入れるための BEA TOP END サービス要求の BEA Tuxedo キュー名へのマッピングを定義します。QNAME エントリは、BEA TOP END システムにサービスとして宣言されません。QSPACE エントリと QNAME エントリは互いに独立しています。QSPACE および QNAME 識別子は、関連する BEA TOP END 識別子を tp_rtq_put(3T) ルーチン呼び出しで指定することにより、アプリケーションで任意に組み合わせて使用できます。組み合わせがローカル BEA Tuxedo ドメインに存在しないと、実行時エラーが発生します。。

QNAME エントリは、その製品、関数、ターゲット、および修飾子の組み合わせに関して、LACCESSPOINT パラメータで指定される特定のローカル・ドメイン・アクセス・ポイントで一意である必要があります。同じ組み合わせのエントリが複数設定された場合、TEDG は最初のエントリしか使用しません。

TE_PRODUCT パラメータを含む任意の SERVICE または QNAME エントリ、または TE_RTQGROUP パラメータを含む任意の QSPACE エントリは、そのエントリが LACCESSPOINT パラメータで特定のローカル・ドメイン・アクセス・ポイントに対して設定されていない場合、すべての TOPEND ローカル・ドメイン・アクセス・ポイントに適用できます。特定のローカル・ドメイン・アクセス・ポイントに対して設定されたエントリは、そのドメイン・ゲートウェイだけに適用されます。

SERVICE エントリと QSPACE エントリでは、BEA TOP END サービスとして宣言される BEA TOP END サービス識別子をコンフィギュレーションするので、特定のローカル・ドメイン・アクセス・ポイントに対するこれらの識別子は重複してはいけません。SERVICE エントリの場合、TE_PRODUCT、TE_FUNCTION、および TE_TARGET が宣言されます。QSPACE エントリの場合、TE_RTQGROUP、TE_RTQNAME、および TE_TARGET が、製品、関数、およびターゲット識別子として宣言されます。このため、SERVICE エントリの製品、関数、およびターゲットが QSPACE エントリの RTQ グループ、RTQ キュー名、およびターゲットと一致する場合、TEDG は要求をルーティングできません。BEA TOP END システムの場合と同様に、ターゲットのデフォルト値は短縮されたノード名です。

DMCONFIG ファイルに複数の BEA TOP END システムのローカル・ドメイン・アクセス・ポイントを含む場合、または複数のタイプのドメイン・ゲートウェイを含む場合は、DM_EXPORT セクションでローカル・リソース・エントリに対する LACCESSPOINT パラメータを指定する必要があります。ローカル・ドメイン・アクセス・ポイントを指定せずに混在型のコンフィギュレーションを作成しないでください。ゲートウェイが正しく初期化しない場合があります。判断に迷う場合は、LACCESSPOINT を明示的に設定します。

次の表に、DM_EXPORT セクションの各 TEDG エントリの必須パラメータとオプション・パラメータを示します。

DM_EXPORT セクションの必須およびオプション TEDG パラメータ