GTF 書き込み機能ヘッダー・セクション

書き込み機能ヘッダー・セクションの長さおよび内容は、SMF と GTF では 異なっていますが、レコードのその他のセクションについては、SMF と GTF で同じです。

プログラム固有のプログラミング・インターフェース情報の開始
GTF 書き込み機能ヘッダー・セクションは、レコードの最初のバイトから始まります。 アドレスが分かれば、ヘッダーのフィールドを調べることができます。 GTF に送信されるトレース・レコードの書き込み機能のヘッダーは、常に、 マクロ DSNDQWGT によりマップされます。 これらのフィールドは、表 1 で説明されています。

表 1. GTF 書き込み機能ヘッダー・セクションの内容
オフセット マクロ DSNDQWGT のフィールド 説明
0 QWGTLEN レコードの長さ
2   予約済み
4 QWGTAID アプリケーション ID
5 QWGTFID フォーマット ID
6 QWGTTIME タイム・スタンプ。GTF 始動時に TIME=YES を指定してください。
14 QWGTEID イベント ID: X'EFB9'
16 QWGTASCB ASCB アドレス
20 QWGTJOBN ジョブ名
28 QWGTHDRE ヘッダーの拡張部分
28 QWGTDLEN データ・セクションの長さ
30 QWGTDSCC セグメント制御コード

0=完了 2=最後 1=最初 3=中間

31 QWGTDZZ2 予約済み
32 QWGTSSID サブシステム ID
36 QWGTWSEQ シーケンス番号
40 QWGTEND GTF ヘッダーの終わり
図 1 は、GTF に送られたトレース出力の内容を示しています。
図 1. GTF に送られた Db2 トレース出力 (IMS™ の DFSERA10 出力プログラム により出力されたスパン・レコード)
DFSERA10 - PRINT PROGRAM
 
 000000   001A0000 0001FFFF  94B6A6E9 BD6636FA   5C021000 00010000  0000
          A            B                  C               D                  E   F 
 000000   011C0000 FF00A6E9  C33E28F7 DD03EFB9   00F91400 E2E2D6D7  D4E2E3D9 01000100
          G               H   I        J    K      L         M    N      O 
 000020   E2E2D6D7 00000001  000000A0 00980001   00000038 00680001  0060005E 4DE2E3C1
 000040   D9E340E3 D9C1C3C5  404DE2E3 C1E3405D   C3D3C1E2 E2404D5C  405DD9D4 C9C4404D
 000060   5C405DC4 C5E2E340  4DC7E3C6 405DD7D3   C1D5404D 5C405DC1  E4E3C8C9 C4404D5C
 000080   405DC9C6 C3C9C440  4D5C405D C2E4C6E2   C9E9C540 4D5C405D  FFFFFFFF 00040101
          P         Q   R  S 
 0000A0   004C0110 000402xx  00B3ADB8 E2E2D6D7   A6E9C33E 28EF4403  00000006 00000001
                   T 
 0000C0   00000001 E2C1D5E3  C16DE3C5 D9C5E2C1   6DD3C1C2 C4C2F2D5  C5E34040 D3E4D5C4
 0000E0   F0404040 A6E9C33E  271F0001 004C0200   E2E8E2D6 D7D94040  F0F2F34B C7C3E2C3
 000100   D5F6F0F2 E2E2D6D7  40404040 40404040   40404040 E2E8E2D6  D7D94040
                                                                                 U 
 000000   00440000 FF00A6E9  C33E2901 1303EFB9   00F91400 E2E2D6D7  D4E2E3D9 00280200
 000020   E2E2D6D7 00000001  00000000 00000000   00000000 00000000  00000000 00000000
 000040   00000000 V 
          W                                                                       X 
 000000   011C0000 FF00A6E9  C33E2948 E203EFB9   00F91400 E2E2D6D7  D4E2E3D9 01000100
 000020   E2E2D6D7 00000002  000006D8 004C0001   00000090 001C0004  00000100 001C000E
 000040   00000288 0018000E  00000590 00400001   000005D0 00740001  00000480 00440001
 000060   000003D8 00800001  00000458 00280001   00000644 00480001  000004E4 00AC0001
 000080   0000068C 004C0001  000004C4 00200001   D4E2E3D9 00000001  762236F2 00000000
 0000A0   59F48900 001E001E  00F91400 C4C2D4F1   00000001 1A789573  00000000 95826100
 0000C0   001F001F 00F90E00  C4C9E2E3 00000000   3413C60E 00000000  1C4D0A00 00220022
 0000E0   00F90480 C9D9D3D4  00000000 0629E2BC   00000000 145CE000  001D001D 00F91600
 000100   E2D4C640 00000046  00000046 00000000   00000000 00000000  00000000
                                                                                 Y 
 000000   011C0000 FF00A6E9  C33E294B 1603EFB9   00F91400 E2E2D6D7  D4E2E3D9 01000300
 000020   E2E2D6D7 00000002  D9C5E240 00000000   00000000 00000000  00000000 00000000
 000040   00000000 C7E3C640  00000001 00000001   00000000 00000000  00000000 00000000
 000060   E2D9E540 00000000  00000000 00000000   00000000 00000000  00000000 E2D9F140
 000080   00000156 000000D2  00000036 00000036   00000000 00000004  E2D9F240 00000000
 0000A0   00000000 00000000  00000000 00000000   00000000 D6D7F140  00000000 00000000
 0000C0   00000000 00000000  00000000 00000000   D6D7F240 00000000  00000000 00000000
 0000E0   00000000 00000000  00000000 D6D7F340   00000000 00000000  00000000 00000000
 000100   00000000 00000000  D6D7F440 00000000   00000000 00000000  00000000
                                                                                 Y 
 000000   011C0000 FF00A6E9  C33E294D 3C03EFB9   00F91400 E2E2D6D7  D4E2E3D9 01000300
 000020   E2E2D6D7 00000002  00000000 00000000   D6D7F540 00000000  00000000 00000000
 000040   00000000 00000000  00000000 D6D7F640   00000000 00000000  00000000 00000000
 000060   00000000 00000000  D6D7F740 00000000   00000000 00000000  00000000 00000000
 000080   00000000 D6D7F840  00000000 00000000   00000000 00000000  00000000 00000000
 0000A0   00010000 0000000E  0000000D 00000000   00000000 00000000  00020000 0000000D
 0000C0   0000000D 00000000  00000000 00000000   00030000 00000003  00000003 00000000
 0000E0   00000000 00000000  00040000 00000006   00000006 00000000  00000000 00000000
 000100   00050000 00000005  00000005 00000000   00000000 00000000  006A0000
                                                                                 Y 
 000000   011C0000 FF00A6E9  C33E294F 6103EFB9   00F91400 E2E2D6D7  D4E2E3D9 01000300
 000020   E2E2D6D7 00000002  00000005 00000005   00000000 00000000  00000000 008C0000
 000040   00000000 00000000  00000000 00000000   00000000 008D0000  00000000 00000000
 ⋮
                                                                                 Z 
 000000   00780000 FF00A6E9  C33E2957 D103EFB9   00F91400 E2E2D6D7  D4E2E3D9 005C0200
                                      AA 
 000020   E2E2D6D7 00000002  00000000 004C011A   00010D31 02523038  E2E2D6D7 A6E9C33E
 000040   29469A03 0000000E  00000002 00000001   E2C1D5E3 C16DE3C5  D9C5E2C1 6DD3C1C2
 000060   40404040 40404040  40404040 40404040   A6E9B6B4 9A2B0001
図 1 のキー 説明
 A 011C レコード長 (フィールド QWGTLEN)。GTF 書き込み機能ヘッダー・セクションの開始
 B A6E9 C33E28F7 DD03 タイム・スタンプ (フィールド QWGTTIME)
 C EFB9 イベント ID (フィールド QWGTEID)
 D E2E2D6D7 D4E2E3D9 ジョブ名 (フィールド QWGTJOBN)
 E 0100 データ・セクションの長さ
 F 01 セグメント制御コード (01 = 最初のレコードの最初のセグメント)
 G E2E2D6D7 サブシステム ID (フィールド QWGTSSID)
 H  GTF 書き込み機能ヘッダー・セクションの 終わり
 I 000000A0 プロダクト・セクションへのオフセット。 自己定義セクションの開始
 J 0098 プロダクト・セクションの長さ
 K 0001 プロダクト・セクションの反復回数
 L 00000038 最初の (この場合はただ 1 つの) データ・セクション へのオフセット
 M 0068 データ・セクションの長さ
 N 0001 データ・セクションの反復回数
 O 0060005E データ・セクションの開始
 P 004C0110... プロダクト・セクションの開始
 Q 0004 IFCID (フィールド QWHSIID)
 R 02 このレコードの自己定義セクションの数 (フィールド QWHSNSDA)
 S xx リリース標識番号 (フィールド QWHSRN)。これは、使用する Db2® の実際のリリース・レベルによって異なります。
 T E2C1D5E3... ローカル・ロケーション名 (16 バイト)
 U 02 最初のレコードの最後のセグメント
 V  最初のレコードの終わり
 W  新しいレコードの GTF ヘッダーの開始
 X 01 スパン・レコードの最初の セグメント (QWGTDSCC = QWGTDS01)
 Y 03 スパン・レコードの中間セグメント (QWGTDSCC = QWGTDS03)
 Z 02 スパン・レコードの最後のセグメント (QWGTDSCC = QWGTDS02)
 AA 004C プロダクト・セクションの開始
GTF レコードは、256 バイトにブロック化されます。 トレース・レコードの中にはこの 256 バイトの GTF 限界値を超えるものもあるため、 トレース・レコードは Db2 によりブロック化されています。GTF レコードを処理するためには、次の論理を使用してください。
  1. レコードの GTF イベント ID が Db2 ID に等しいか (すなわち、QWGTEID = X'xFB9' か)

    等しくない 場合、次のレコードを読み取る。

    等しい場合は、処理を継続。

  2. レコードはスパンされているか
    レコードがスパンされている場合 (つまり、QWGTDSCC ¬ = QWGTDS00)、スパン・レコードが最初、中間、あるいは最後のセグメントかを判別するためにテストする。
    1. 最初の セグメントの場合 (つまり、QWGTDSCC = QWGTDS01)、 シーケンス番号 (QWGTWSEQ) およびサブシステム ID (QWGTSSID) を含めて レコード全体を保管する。
    2. 中間 セグメントの場合 (つまり、QWGTDSCC = QWGTDS03)、 シーケンス番号 (QWGTSEQ) およびサブシステム ID (QWTGSSID) と一致する最初の セグメントを見つける。次に、GTF ヘッダー直後のデータ部分を、前のセグメントの最後に移動する。
    3. 最後の セグメントの場合 (すなわち、QWGTDSCC = QWGTDS02)、 シーケンス番号 (QWGTSEQ) およびサブシステム ID (QWTGSSID) と一致する最初の セグメントを見つける。次に、GTF ヘッダー直後のデータ部分を、前のレコードの最後に移動する。

      ここで、完全なレコードを処理する。

    スパンされていない 場合は、レコードを処理する。

次の図は、上記で述べた論理に従って、ユーザー作成出口ルーチンにより処理された同じ出力を示しています。

図 2. GTF に送られた Db2 トレース出力 (ユーザー作成ルーチンでアセンブルされ、IMS の DFSERA10 出力プログラムで出力)
 000000   01380000 FF00A6E9  DCA7E275 1204EFB9   00F91400 E2E2D6D7  D4E2E3D9 011C0000
 000020   E2E2D6D7 00000019  000000A0 00980001   00000038 00680001  0060005E 4DE2E3C1
 000040   D9E340E3 D9C1C3C5  404DE2E3 C1E3405D   C3D3C1E2 E2404D5C  405DD9D4 C9C4404D
 000060   5C405DC4 C5E2E340  4DC7E3C6 405DD7D3   C1D5404D 5C405DC1  E4E3C8C9 C4404D5C
 000080   405DC9C6 C3C9C440  4D5C405D C2E4C6E2   C9E9C540 4D5C405D  00000001 00040101
 0000A0   004C0110 000402xx  00B3ADB8 E2E2D6D7   0093018F 11223310  0000000C 00000019
 0000C0   00000001 E2C1D5E3  C16DE3C5 D9C5E2C1   6DD3C1C2 C4C2F2D5  C5E34040 D3E4D5C4
 0000E0   F0404040 A6E9DCA7  DF960001 004C0200   E2E8E2D6 D7D94040  F0F2F34B C7C3E2C3
 000100   D5F6F0F2 E2E2D6D7  40404040 40404040   40404040 E2E8E2D6  D7D94040 00000000
 000120   00000000 00000000  00000000 00000000   00000000 00000000
          A                               B 
 000000   07240000 FF00A6E9  DCA8060C 2803EFB9   00F91400 E2E2D6D7  D4E2E3D9 07080000
                          C  D                   E 
 000020   E2E2D6D7 0000001A  000006D8 004C0001   00000090 001C0004  00000100 001C000E
 000040   00000288 0018000E  00000590 00400001   000005D0 00740001  00000480 00440001
 000060   000003D8 00800001  00000458 00280001   00000644 00480001  000004E4 00AC0001
                             F 
 000080   0000068C 004C0001  000004C4 00200001   D4E2E3D9 00000003  27BCFDBC 00000000
 0000A0   AB000300 001E001E  00F91400 C4C2D4F1   00000001 1DE8AEE2  00000000 DB0CB200
 0000C0   001F001F 00F90E00  C4C9E2E3 00000000   4928674B 00000000  217F6000 00220022
 0000E0   00F90480 C9D9D3D4  00000000 07165F79   00000000 3C2EF500  001D001D 00F91600
 000100   E2D4C640 0000004D  0000004D 00000000   00000000 00000000  00000000 D9C5E240
 000120   00000000 00000000  00000000 00000000   00000000 00000000  C7E3C640 00000019
 000140   00000019 00000000  00000000 00000000   00000000 E2D9E540  00000000 00000000
 000160   00000000 00000000  00000000 00000000   E2D9F140 00000156  000000D2 00000036
 000180   00000036 00000000  00000004 E2D9F240   00000092 00000001  00000091 00000091
 0001A0   00000000 0000000C  D6D7F140 00000002   00000001 00000001  00000000 00010000
 0001C0   20000004 D6D7F240  00000000 00000000   00000000 00000000  00000000 00000000
 0001E0   D6D7F340 00000000  00000000 00000000   00000000 00000000  00000000 D6D7F440
 000200   00000000 00000000  00000000 00000000   00000000 00000000  D6D7F540 00000000
 000220   00000000 00000000  00000000 00000000   00000000 D6D7F640  00000000 00000000
 000240   00000000 00000000  00000000 00000000   D6D7F740 00000000  00000000 00000000
 000260   00000000 00000000  00000000 D6D7F840   00000000 00000000  00000000 00000000
 000280   00000000 00000000  00010000 00000042   00000011 00000030  00000000 00000000
 0002A0   00020000 00000041  00000011 00000030   00000000 00000000  00030000 00000003
 0002C0   00000003 00000000  00000000 00000000   00040000 0000000C  0000000C 00000000
 0002E0   00000000 00000000  00050000 0000000B   0000000A 00000001  00000000 00000000
 000300   006A0000 0000000C  0000000B 00000001   00000000 00000000  008C0000 00000000
 000320   00000000 00000000  00000000 00000000   008D0000 00000000  00000000 00000000
 000340   00000000 00000000  008E0000 00000000   00000000 00000000  00000000 00000000
 000360   008F0000 00000000  00000000 00000000   00000000 00000000  00900000 00000000
図 3. GTF に送られた Db2 トレース出力 (ユーザー作成ルーチンでアセンブルされ、IMS の DFSERA10 出力プログラムで出力) (続き)
 000380   00000000 00000000  00000000 00000000   00910000 00000000  00000000 00000000
 0003A0   00000000 00000000  00920000 00000000   00000000 00000000  00000000 00000000
 0003C0   00CA0000 00000041  00000011 00000030   00000000 00000000  00000000 00000000
 0003E0   00000000 00000000  00000000 00000000   00000000 00000000  00000000 00000000
 000400   00000000 00000000  00000000 00000000   00000000 00000000  00000000 00000000
 000420   00000000 00000000  00000000 00000000   00000000 00000000  00000000 00000000
 000440   00000000 00000000  00000000 00000004   00000000 00000000  000005D4 00000130
 000460   0000000D 0000000A  00000029 00000009   000000C3 00000000  00000000 00000000
 000480   00000001 0000000C  00000000 04A29740   00000000 00000000  00000001 00000000
 0004A0   00000001 00000000  00000000 00000000   00000000 00000000  00000000 00000000
 0004C0   00000000 00000000  00000000 00000000   00000000 00000000  00000000 00000000
 0004E0   00000000 E2C1D56D  D1D6E2C5 40404040   40404040 00000000  00000002 00000003
 000500   00000000 000004A8  000005C7 00000000   00000001 00000003  00000003 00000000
 000520   00000001 00000000  00000001 00000000   00000000 00000000  00000000 00000000
 000540   00000002 00000001  00000000 00000000   00000000 00000000  00000000 00000000
 000560   00000000 00000000  00000000 00000000   00000000 00000000  00000000 00000000
 000580   00000000 00000000  00000002 00000000   00000003 00000000  00000003 00000006
 0005A0   00000000 00000000  00000000 00000000   00000005 00000003  00000000 00000000
 0005C0   00000000 00000003  00000000 00000000   00000000 00000000  00000000 00000000
 0005E0   00000000 00000000  0000000C 00000001   00000000 00000007  00000000 00000000
 000600   00000000 00000000  00000000 00000001   00000000 00000000  00000000 00000000 
 000620   00000000 00000000  00000000 00000000   00000000 00000000  00000000 00000000
 000640   00000000 003C0048  D8E2E2E3 00000035   00000006 00000002  0000009E 0000002B
 000660   00000078 00000042  00000048 000000EE   0000001B 0000007B  0000004B 00000000
 000680   00000000 00000000  00000000 0093004C   D8D1E2E3 00000000  000000FC 0000000E
 0006A0   00000000 00000000  0000009D 00000000   00000000 00000016  0000000F 00000018
                                                                    G 
 0006C0   00000000 00000000  00000000 00000000   00000000 00000000  004C011A 00010Dxx
 0006E0   02523038 E2E2D6D7  0093018F 11223324   00000042 0000001A  00000001 E2C1D5E3
 000700   C16DE3C5 D9C5E2C1  6DD3C1C2 40404040   40404040 40404040  40404040 A6E9B6B4
 000720   9A2B0001 H 
図 2 のキー 説明
 A 0724 アセンブルされたレコードの長さ。2 番目のレコードの GTF 書き込み機能ヘッダー・セクションの始まり (フィールド QWGTLEN)
 B EFB9 GTF イベント ID (フィールド QWGTEID)
 C  2 番目のレコードの GTF 書き込み機能 ヘッダー・セクションの終わり
 D 000006D8 プロダクト・セクションへのオフセット
 E 00000090 最初のデータ・セクションへのオフセット
 F 000004C4 最後のデータ・セクションへのオフセット
 G 004C011A プロダクト・セクションの開始
 H  2 番目のレコードの終わり
プログラム固有のプログラミング・インターフェース情報の終了