Trace data record format

Trace records that are returned from READA and READS requests contain the following sections:

Begin program-specific programming interface information.

  • A writer header that reports the length of the entire record, whether the record was in the first, middle, or last section of data, and other specific information for the writer.
    • The writer header for IFI is mapped by DSNDQWIW or the header QW0306OF for IFCID 306 requests. See the mapping macros in prefix.SDSNMACS for the formats.
    • In SMF, writer headers for statistics records are mapped by macro DSNDQWST, for accounting records by DSNDQWAS, and for performance, audit, and monitor records by DSNDQWSP. When these macros are assembled, they include the other macros necessary to map the remainder of the trace records sent to SMF. The length and content of the writer header section differs between SMF and GTF records, but the other sections of the records are the same for SMF and GTF.
    • The GTF writer header section begins at the first byte of the record. After establishing addressability, you can examine the fields of the header. The writer headers for trace records sent to GTF are always mapped by macro DSNDQWGT. The fields are described in Table 1.
  • A self-defining section
  • A product section containing specific DB2® information based on the active trace. The product section for all record types contains the standard header, DSNDQWHS. The other headers (correlation, CPU, distributed, and data sharing data) might also be present.
    DSNDQWHC
    Product section correlation header
    DSNDQWHD
    Distributed data header
    DSNDQWHT
    Trace header
    DSNDQWHA
    Data sharing header
    Start of changeDSNDQWHUEnd of change
    Start of changeCPU headerEnd of change
    DSNWMSGS.
    Descriptive text for all IFCID records
  • Data areas containing the actual recorded data are mapped by multiple mapping macros described in prefix.SDSNMACS.

The following figure shows the return area after a READS request successfully executed.

Figure 1. Example of IFI return area after READS request (IFCID 106)
. This output was assembled by a user-written routine and printed with the DFSERA10 print program of IMS™.
DFSERA10 - PRINT PROGRAM
⋮
          A        B                  C 
 000000   05A80000 00000510  00980001 00000054   00B80001 0000010C  01000001 0000020C
 000020   01160001 00000324  01B00001 000004D4   00000000 000004D4  00080001 000004DC
                                                          D 
 000040   00010001 000004E0  00000000 000004E0   00300001 80000018  00000010 000003E8
 000060   00640064 000A0028  003D0000 0000A000   00033000 00033000  00010000 E0000000
 000080   00000000 00000000  00000000 C1C4D4C6   F0F0F140 F0F20080  00003084 00000000
 0000A0   00002000 0005003C  0028F040 40404040   40404040 40404040  40404040 40404040
 ⋮
 000320   B0000000 202701D0  E2D7D9D4 D2C4C4F0   F0F1F940 01980064  00000000 E7C14000
 000340   00400280 C5E2E8E2  C1C4D440 40000000   000E1000 000001BC  000001B0 C9C2D4E4
 000360   E2C5D940 C9D9D3D4  D7D9D6C3 C9D9D3D4   0000003C 0000012C  0000000A 8080008C
 000380   00FA0000 00007D00  000A0014 00050028   000E0002 00080008  00400077 00000514
 0003A0   000003E8 012C0000  0000000E 000A01F4   00FA0000 00000032  000003E8 00002710
 0003C0   E2E8E2C1 C4D44040  E2E8E2D6 D7D94040   E2E8E2D6 D7D94040  000A0080 00140000
 0003E0   00000080 0005000A  13880078 0008000A   00040004 00040005  0001000A 00020005
 000400   00003000 00007800  00000001 000007D0   00040400 00780078  00010003 00019000
 000420   0000000A 00000020  00000019 00000000   0005000A 0006000A  00640064 00040063
 000440   00000000 00000000  00000000 00000000   00000000 00000000  00000000 00000000
 000460   30C4E2D5 D9C7C3D6  D3C4E2D5 6DD9C5C7   C9E2E3C5 D96DC1D7  D7D3C4E2 D56DD9C5
 000480   C7C9E2E3 C5D96DD6  C2D1E380 C4E2D5D9   C7C6C4C2 000009FD  C5000000 00001060
 0004A0   00020000 00001000  40000000 00000000   00000000 00000000  00000000 00000000
 0004C0   00000000 00000000  00000000 F1F161F1   F361F9F2 C4E2D5C3  F3F1F040 80000000
 0004E0   00160030 C6C1C340  00010000 C4C4C640   40404040 C1800002  00000000 C1C3E3C9
                                                 E        F 
 000500   E5C54040 00000000  00000000 00000000   004C011A 006A0A31  00B45B78 E2E2D6D7
 000520   A6E9C7D5 EBDB1104  00000008 00000002   00000001 E2C1D5E3  C16DE3C5 D9C5E2C1
 000540   6DD3C1C2 C4C2F2D5  C5E34040 D3E4D5C4   F0404040 A6E9C7D2  E73C0001 004C0200
 000560   E2E8E2C1 C4D44040  D4D7C9E3 E2F14040   40404040 C2C1E3C3  C8404040 C4E2D5C5
 000580   C4C3D340 E2E8E2C1  C4D44040 00000001   00000000 00000000  00000000 00000000
 0005A0   00000000 00000000
Figure label Description
 A 05A8 Length of record. The next two bytes are reserved.
 B 00000510 Offset to product section standard header.
 C 00000054 Offset to first data section.
 D 80000018 Beginning of first data section.
 E 004C011A Beginning of product section standard header.
 F 006A IFCID (decimal 106).

End program-specific programming interface information.