セクション 5 ―ファイル形式、データ記述方法、MIB、およびシステム・プロセスのリファレンス

Tuxedo

ドキュメントのダウンロード

サイトマップ

検索

e-docs > Tuxedo > Tuxedo のファイル形式とデータ記述方法 > セクション 5 ―ファイル形式、データ記述方法、MIB、およびシステム・プロセスのリファレンス

Tuxedo のファイル形式とデータ記述方法

Previous

Next

Contents

View as PDF

DM_ROUTING セクション

このセクションでは、型付きバッファである FML、FML32、VIEW、VIEW32、X_C_TYPE、X_COMMON、または XML を使用したローカル・サービス要求のデータ依存型ルーティングに関する情報を指定します。

DM_ROUTING セクションのエントリの形式は次のとおりです。

ROUTING_CRITERIA_NAME required_parameters

ROUTING_CRITERIA_NAME は、 DM_IMPORT セクションの特定のサービス・エントリの ROUTING パラメータに割り当てられる identifier の名前です。ROUTING_CRITERIA_NAME は 15 文字以下でなければなりません。

DM_ROUTING セクションの必須パラメータ

FIELD = identifier

ルーティング・フィールドの名前を指定します。名前は 30 文字以内でなければなりません。identifier の値には次のいずれかを指定できます。FML フィールド・テーブル (FML および FML32 バッファの場合) で識別されたフィールド名、XML の要素あるいは要素属性 (XML バッファの場合)、または FML VIEW テーブル (VIEW、X_C_TYPE、または X_COMMON バッファの場合) で識別されたフィールド名です。FML フィールド・テーブルを検索するには、2 つの環境変数、FLDTBLDIR および FIELDTBLS、または FLDTBLDIR32 および FIELDTBLS32 を使用します。同様に、FML VIEW テーブルを検索するには、2 つの環境変数、VIEWDIR および VIEWFILES、または VIEWDIR32 および VIEWFILES32 を使用します。FML または FML32 バッファ内のフィールドがルーティングに使用される場合は、フィールド番号は 8191 以下でなければなりません。

UTF-8 で符号化された XML 要素の内容をルーティングに使用できます。ルーティングに使用する場合、この要素の内容に文字リファレンス、エンティティ・リファレンス、および CDATA セクションを含めることはできません。UTF-8 で符号化された XML 要素の属性は、この属性が属する要素が定義されている場合にルーティングに使用できます。

XML 文書が要素の内容または属性に基づいてルーティングされる場合、FIELD パラメータは次の構文で定義される必要があります。

FIELD = "root_element[/child_element][/child_element][/. . .][/@attribute_name]"

FIELD の値には、ルーティングの要素または要素の属性名を指定します。root_element の値には、XML ドキュメントまたはデータグラムの要素のタイプ (または名前) あるいは要素の属性名を指定できます。この情報は、ドキュメントまたはデータグラム送信時に、データ依存型ルーティングで要素の内容または属性を識別するために使用されます。要素名と属性名を組み合わせて、最大 30 文字まで指定できます。インデックスはサポートされないので、BEA Tuxedo システムは、データ依存型ルーティングで XML バッファを処理する際に、与えられた要素タイプの最初のオカレンスだけを認識します。

XML は、属性名に使用できる文字セットを厳密に定義しています。属性名は、単一の文字、アンダースコア (_)、またはコロン (:) を含む文字列で、その後に 1 つ以上の名前文字が続きます。要素名と属性名はいずれも、大文字小文字が区別されます。

XML の詳細については、World Wide Web Consortium の Web サイト http://www.w3c.org/XML を参照してください。

FIELDTYPE = type

FIELD パラメータに指定されたルーティング・フィールドのタイプを指定します。このパラメータは、XML バッファをルーティングする場合にのみ使用されます。値 type は、CHAR、SHORT、LONG、FLOAT、DOUBLE、STRING のいずれかに設定できます。ルーティング・フィールドのデフォルトのタイプは STRING です。

UTF-8 で符号化された XML 要素の内容と属性を FIELDTYPE パラメータで指定されたデータ型に変換できる場合、それらをルーティングに使用できます。

RANGES = "string[1..4096]"

ルーティング・フィールドの範囲および関連するリモート・ドメイン・アクセス・ポイント名を指定します。string は二重引用符で囲みます。string はカンマで区切ったペアのリストで、各ペアはコロン (:) で区切られた範囲とリモート・ドメイン・アクセス・ポイントで構成されます (
RANGES = "MIN-1000:b01,1001-3000:b02,*:b03" など)。

範囲は、単一の値 (符号付き数値または一重引用符で囲んだ文字列)、または lower - upper の形式で表します。lower と upper は、いずれも符号付き数値または一重引用符で囲んだ文字列です。lower の値は、upper の値より小さくなければなりません。

文字列値に一重引用符を埋め込むには (例: O'Brien)、一重引用符の前にバックスラッシュを 2 つ入れます (例: O¥¥'Brien)。

関連する FIELD のデータ型の最小値を示すには、値 MIN を使用します。文字列と carray の最小値にはヌル文字列を指定します。文字フィールドの最小値には 0 を指定します。数値の場合、これはフィールドに格納できる最小値です。

関連する FIELD のデータ型の最大値を示すには、値 MAX を使用します。文字列と carray の最大値には、8 進数値の 255 文字の無限文字列を指定します。文字フィールドの最大値には、単一の 8 進数値の 255 文字を指定します。数値の場合は、数値としてフィールドに格納できる最大値です。したがって、"MIN - -5" は -5 以下のすべての数値を指し、"6 - MAX" は、6 以上のすべての数値を指すことになります。範囲内のメタキャラクタ * (ワイルドカード) は、既にエントリとして指定した範囲では使用されなかった任意の値を示します。各エントリでは、1 つのワイルドカードによる範囲指定だけが可能です。1 つのエントリで使用できるワイルドカード範囲は 1 つだけで、最後になければなりません (後続の範囲は無視される)。

数値ルーティング・フィールドには数値で範囲を指定し、文字列ルーティング・フィールドには、文字列で範囲を指定する必要があります。文字列で範囲を設定する場合は、文字列、carray、および文字フィールド型の値を一重引用符で囲みます。先頭に符号を付けることはできません。short 型および long 型の整数値は数字の文字列であり、オプションで先頭に正の符号または負の符号を付けることができます。浮動小数点数は、C コンパイラまたは atof(3) で受け入れられる形式で指定します。つまり、符号 (オプション)、数字の文字列 (オプションで小数点を追加)、e または E (オプション)、符号またはスペース (オプション)、整数という形式で指定します。

フィールド値が範囲と一致する場合、関連付けられているリモート・ドメイン・アクセス・ポイントは、要求がルーティングされるリモート・ドメインを示します。リモート・ドメイン・アクセス・ポイントの値に "*" を指定すると、ゲートウェイ・グループが認識する任意のリモート・ドメインに要求が送られます。

BUFTYPE = "type1[:subtype1[, subtype2 . . . ]][;type2[:subtype3[, . . . ]]] . . ."

このルーティング・エントリで有効なデータ・バッファのタイプとサブタイプのリストを指定します。タイプは、FML、FML32、VIEW、VIEW32、X_C_TYPE、X_COMMON、または XML に制限されています。FML、FML32、または XML に対してはサブタイプを指定できず、VIEW、VIEW32、X_C_TYPE、および X_COMMON ではサブタイプを指定する必要があります ("*" は使用できません)。タイプとサブタイプのペアのうち、重複するものは同じルーティング基準名として指定できません。タイプとサブタイプのペアが一意の場合、複数のルーティング・エントリは同じ基準名を持つことができます。このパラメータは必須です。単一のルーティング・エントリに複数のバッファ・タイプが指定される場合、各バッファ・タイプに対するルーティング・フィールドのデータ型は同じでなければなりません。

フィールド値が設定されていないか (FML または FML32 バッファの場合)、または特定の範囲と一致しておらず、ワイルドカードの範囲が指定されていない場合、リモート・サービスの実行を要求したアプリケーション・プロセスに対してエラーが返されます。

Back to Top

Previous

Next