Examples of the extended format for short and long trace entries
The tracing in the AP domain has two different styles of trace entry; the oldest style of trace entry is short and contains minimal information, whereas the later style of trace entry is long, containing much more information to help with problem determination.
Figure 1 shows a trace entry made from a short trace point. Its trace point ID is AP 00E1, corresponding to trace ID X'E1' in old releases of CICS.
AP 00E1 EIP EXIT INQUIRE-PROGRAM OK REQ(00F4) FIELD-A(00000000 ....) FIELD-B(00004E02 ..+.) BOUNDARY(0200)
TASK-00048 KE_NUM-07FC TCB-L8000/009A0E88 RET-B28102A2 TIME-11:19:53.2944533850 INTERVAL-00.0000226252 =000491=
- AP 00E1 shows that this trace entry was made
from trace point X'00E1' in the application domain.
Although all short trace points are in AP domain, not all AP domain trace points are short. Some are long trace points and they have a similar format to that shown in Figure 2. In general, short trace points have values less than or equal to X'00FF' and new AP-domain trace points have values greater than or equal to X'0200'
- EIP EXIT INQUIRE-PROGRAM OK is the
interpretation string, which gives information about what was going
on at the time the trace entry was made.
- EIP identifies the module where the trace point is located, in this case DFHEIP.
- EXIT shows that the trace entry was written on completion of processing a request.
- INQUIRE-PROGRAM shows the type of function requested.
- REQ(00F4) represents the request type of the short trace format. In this example, byte 1 bits 0–3 (X'F') show that the trace entry is made on exit from the request.
- FIELD-A and FIELD-B contain
the same data as FIELD A and FIELD B in the short format.
FIELD-A bytes 0–3 would contain the secondary response, EIBRESP2. FIELD-B bytes 0–1 would contain the condition number, EIBRESP. In this example, both are zero, indicating that no error response has been returned. FIELD-B bytes 2–3 contain the command code, EIBFN. In this example, this is X'4E02', showing that the EXEC CICS command was INQUIRE PROGRAM.
Note: For some trace entries, an 8-character resource field is shown after FIELD B. - BOUNDARY shows the dispatcher state and the EIS boundary flags.
- The standard information string shows:
- TASK-00048 shows that the task number for the currently running task is 00048. Any trace entries having the same task number would have been made while this task was running.
- KE_NUM-07FC shows that the kernel task number for the task is 07FC. If you took a system dump while this task was in the system, you could identify the task in the kernel summary information from this number.
- TCB-L8000/009A0E88 is the address of the MVS TCB.
- RET-B28102A2 is the return address.
- The time when the trace entry was made was 11:19:53.2944533850.
- The interval that elapsed between this and the preceding trace entry was 00.0000226252 seconds.
Figure 2 shows a long trace entry.
SM 0C01 SMMG ENTRY - FUNCTION(GETMAIN) GET_LENGTH(1A4A) SUSPEND(YES) INITIAL_IMAGE(00) STORAGE_CLASS(TASK)
TASK-00163 KE_NUM-0007 TCB-QR /009F3338 RET-800411F2 TIME-16:31:52.5916976250 INTERVAL-00.0000666250 =000112=
1-0000 00480000 00000011 00000000 00000000 B6700000 00000000 02000100 C4C6C8C3 *............................DFHC*
0020 C5E3D9C4 03BD5BB0 00001A4A 03BD5B01 00000001 01000698 04755D70 40400008 *ETRD..$.... ..$........Q..). ..*
0040 00000FE8 C3C5E3D9 *...YCETR *
- SM 0C01 shows that this trace entry was made from trace point X'0C01' in the storage manager domain.
- SMMG ENTRY - FUNCTION(GETMAIN) GET_LENGTH(1A4A) SUSPEND(YES)
INITIAL_IMAGE(00) STORAGE_CLASS(TASK) is the interpretation
string, which provides the following information:
- SMMG tells you that the trace call was made from module DFHSMMG.
- ENTRY FUNCTION(GETMAIN) tells you that the call was made on entry to the GETMAIN function.
- GET_LENGTH(1A4A) SUSPEND(YES) INITIAL_IMAGE(00) STORAGE_CLASS(TASK)
tells you the parameters associated with the GETMAIN call, as follows:
- The request is for X'1A4A' bytes of storage.
- The task is to be suspended if the storage is not immediately available.
- The storage is to be initialized to X'00'
- The storage class is TASK.
- The standard information string provides the following information:
- The task currently running is task number X'00163'.
- The kernel task number for the task is 0007.
- The time when the trace entry was made was 16:31:52.5916976250.
- The time that elapsed between this and the preceding trace entry was 00.0000666250 seconds.
- The data that is displayed following the standard information was taken from only one data area.
Storage manager domain trace points contains details of trace point ID SM 0C01. The data area is the SMMG parameter list.
Relevant information is formatted from the data area and appears in the trace entry interpretation string.
Information about some data areas is intended for use by IBM support personnel, and therefore the details of their format and contents might not be available to you. If you reach a point at which you are certain that you cannot continue the problem determination process because you do not have access to information about a data area, contact your IBM Support Center.