自己定義セクション

書き込み機能ヘッダーの後ろの自己定義セクションには、プロダクト・セクション およびデータ・セクションをユーザーが見つけることができるように、 ポインターが入っています。 これらのセクションには、実際のトレース・データが入ります。

プログラム固有のプログラミング・インターフェース情報の開始

「ポインター」は、それぞれ以下のフィールドから成る記述子です。

  • レコードの先頭からデータ・セクションまでのオフセットが入っている フルワード。
  • データ・セクションの各項目の長さが入っているハーフワード。 この値がゼロの場合は、項目の長さは可変です。
  • データ・セクションの反復回数が入っているハーフワード。 このフィールドの値が「0」の場合は、そのレコードにはデータ・セクションは存在しません。 このフィールドに 1 より大きい数字が入っている場合は、 複数のデータ項目がそのデータ・セクション内に連続して保管されています。2 番目のデータ項目を見つけるためには、最初のデータ項目のアドレスに 最初のデータ項目の長さを加算してください (3 番目以降も同様です)。
ポインターの順序は固定で、その意味はレコードの IFCID により決定されます。 さまざまなポインター・セットがあり、各セットは独自の DSECT により記述されて います。 したがって、ポインターを調べるには、まず、自己定義セクションの適切な記述を 提供する DSECT を使用して、アドレス可能度を確立する必要があります。 そのためには以下のステップを実行します。
  1. 自己定義セクションのアドレスを計算します。

    自己定義セクションは、統計レコードの場合はラベル「SM100END」から、 アカウンティング・レコードの場合は「SM101END」から、 またパフォーマンスおよび監査レコードの場合は「SM102END」から始まります。 どのマッピング DSECT を使用するかは問題ではありません。SMF 書き込み機能ヘッダーの長さが常に同じであるからです。

    GTF の場合、QWGTEND を使用します。

  2. レコードの IFCID を判別します。

    自己定義セクションの最初のフィールドを使用してください。 このフィールドには、レコードの先頭からプロダクト・セクションまでの オフセットが入っています。 プロダクト・セクションには、IFCID が入っています。

    プロダクト・セクションは、DSNDQWHS によりマップされます。IFCID は、QWHSIID によりマップされます。

    IFCID 0001 の統計レコードの場合は、ラベル「QWS0」を使用してアドレス可能度を設定してください。IFCID 0002 の統計レコードの場合は、ラベル「QWS1」を使用してアドレス可能度を設定してください。アカウンティング・レコードの場合は、ラベル「QWA0」を使用してアドレス可能度を 設定してください。 パフォーマンスおよび監査レコードの場合は、ラベル「QWT0」を 使用してアドレス可能度を設定してください。

該当する DSECT を使用してアドレス可能度を確立した後、 自己定義セクションのポインターを使用して、レコードのデータ・セクションを突き止めてください。

プログラム固有のプログラミング・インターフェース情報の終了