Interpreting user trace entries

User trace entries have point IDs in the range AP 0000 through AP 00C2, the numeric part of the point ID being specified in the application.

Extended format user trace entries show a user-defined resource field, and a user-supplied data field that can be up to 4000 bytes in length. A typical extended-format entry is shown in Figure 31.

Figure 31. Example of the extended format for a user trace entry
AP 000B USER  EVENT - APPLICATION-PROGRAM-ENTRY - SEND     - CICS USER TRACE ENTRY           HELP INFORMATION
              TASK-00163 KE_NUM-0007 TCB-QR   /009F3338 RET-8003F54C TIME-16:32:01.1295568750 INTERVAL-00.0001965625    =000731=
                1-0000  E4E2C5D9 404040                                                           *USER                            *
                2-0000  C3C9C3E2 40E4E2C5 D940E3D9 C1C3C540  C5D5E3D9 E8404040 40404040 40404040  *CICS USER TRACE ENTRY           *
                  0020  C8C5D3D7 40C9D5C6 D6D9D4C1 E3C9D6D5  40404040 40404040 40404040 40404040  *HELP INFORMATION                *
                  0040  40404040 40404040 40404040 40404040  40404040 40404040 40404040 40404040  *                                *
                  0060  40404040 40404040 40404040 40404040  40404040 40404040 40404040 40404040  *                                *
                3-0000  E2C5D5C4 40404040                                                         *SEND                            *

The interpretation string for the entry contains the string "APPLICATION-PROGRAM-ENTRY", to identify this as a user trace entry, and the resource field.

There are three data fields on an extended-format user trace entry:

  1. The character string "USER".
  2. User data from the area identified in the FROM parameter of the trace command.
  3. The resource field value identified in the RESOURCE parameter of the trace command.

The abbreviated-trace entry corresponding to the extended trace entry of Figure 31 is shown in Figure 32.

Figure 32. Example of the abbreviated format for a user trace entry
00163 QR    AP 000B USER  EVENT APPLICATION-PROGRAMRY SEND CICS USER TRACE ENTRY HELP INFORMATION                       =000731=

Abbreviated-format trace entries show the user resource field in the interpretation string. There is also an optional user data field that contains as much user-specified data as can be fitted into the line. If successive user trace entries have the same resource field value, but different data field values, you might need to see the corresponding extended trace entries to assess their significance. Figure 33 shows an example of the short format for a user trace entry.

Figure 33. Example of the short format for a user trace entry
00031 QR    AP 000B USER  EVENT APPLICATION-PROGRAM-E SEND  - CICS USE RET-800820A2 11:42:27.1176805000 00.0000 247500 =00 0815= 

Related Concepts
CICS tracing

Related Tasks
Interpreting extended-format CICS system trace entries
Interpreting short-format CICS system trace entries
Interpreting abbreviated-format CICS system trace entries
[[ Contents Previous Page | Next Page Index ]]