タグ論理エレメント (TLE) の構造化フィールド

TLE 構造化フィールドは、AFP データ・ストリーム (MO:DCA-P) 文書でのみ使用できます。

IBM® アプリケーション・プログラミング・インターフェース (AFP API) は、TLE 構造化フィールドをサポートしています。これは、索引付き AFP データ・ストリーム (MO:DCA-P) 文書を作成するためにホストの COBOL および PL/I のアプリケーションから使用できます。また、APAR PN36437 付きの文書構成プログラム (DCF) を使って、出力文書に TLE 構造化フィールドを挿入することもできます。

ACIF がサポートし生成する TLE 構造化フィールドの形式は次のとおりです。

紙送り制御文字 (X'5A'): 紙送り制御文字を指定します。この文字は、構造化フィールドを指示するために入力レコードの最初の位置に必要です。
構造化フィールド接頭部 (8 バイト): これは、構造化フィールド ID、および構造化フィールド全体 (すべてのデータを含む) の長さが含まれる標準構造化フィールド・ヘッダーを指定します。
タグ ID トリプレット (4 バイトから 254 バイト): アプリケーションで定義済みの ID、またはタグ値に関連した属性名を指定します。例として、「Customer Name」があります。これは、タイプ値 X'0B' (属性名) を持つ完全修飾名トリプレット (X'02') です。詳細については、「Mixed Object Content Architecture Reference」を参照してください。
タグ値トリプレット (4 バイトから 254 バイト): 索引属性の実際の値を指定します。属性が「Customer Name」である場合、実際のタグ値は「Bob Smith」のようになります。このトリプレットには、バイト 1 に長さ、バイト 2 にタイプ値 X'36' (属性値)、予約済みの 2 バイト (X'0000')、およびタグ値が含まれます。

以下の例は、索引名と索引値を含む 39 バイト TLE 構造化フィールドを示したものです。分かりやすく図示するため、構造化フィールドにある各フィールドを別々の行にリストしています。X' ' は 16 進データを示しています。 " " は EBCDIC データまたは文字データを示しています。

X'5A0026D3A090000000'
X'11020B00'
"Customer Name"
X'0D360000'
"Bob Smith"

TLE 構造化フィールドは、ページ・グループや個々のページと関連付けることができます。銀行の明細書アプリケーションを考えてみます。各銀行の明細書はページ・グループであり、明細書レベル (例えば、口座番号、日付、顧客名など) で特定の索引付け情報を関連付けることができます。さらに、要約ページなどの明細書にある特定のページに索引 (タグ) を付けることができます。以下に、グループ・レベルおよびページ・レベルの TLE を含む印刷ファイルの例を示します。

BDT
  BNG
    TLE Account #, 101030
    TLE Customer Name, Mike Smith
      BPG
        Page 1 data
      EPG
      BPG
        Page 2 data
      EPG
      ...
      ...
      BPG
        TLE Summary Page, n
        Page n data
      EPG
  ENG
  ...
EDT

ACIF は、グループ・レベルとページ・レベルの索引付けタグが両方含まれている入力ファイルを受け入れることができます。また、ACIF の入力レコード出口を使用して、TLE 構造化フィールドを AFP データ・ストリーム (MO:DCA-P) ファイルに挿入することもできます (ただし適用可能な場合に限ります)。 TLE 構造化フィールドにある索引付け情報は、それらが入っているページまたはグループに適用されます。グループの場合、TLE 構造化フィールドは、グループ内における名前付きグループの開始 (BNG) 構造化フィールドと最初のページ (BPG 構造化フィールド) との間であれば任意の場所に指定できます。合成テキスト・ページの場合、TLE 構造化フィールドは、活動環境終了 (EAG) 構造化フィールドとページ終了 (EPG) 構造化フィールドとの間で、活動環境グループの後であれば任意の場所に指定できます。 ACIF は、グループまたはページに含めることができる TLE 構造化フィールドの数を制限していませんが、それを含めた結果のパフォーマンスやストレージの細分化について考慮する必要があります。

ACIF では、印刷ファイルに一様に索引付けする必要はありません。つまり、TLE 構造化フィールドが含まれているすべてのページに、ほかのページと同じ数だけのタグや、同じタイプの索引属性またはタグ値が含まれている必要はありません。このことによって、アプリケーションは非常に柔軟なものとなります。ACIF が、TLE 構造化フィールドが含まれている印刷ファイルの処理を完了すると、結果として作成される索引付け情報ファイルに可変長のレコードが含まれることがあります。