The recovery termination manager work area (RTM2WA)
The RTM2WA is a z/OS® work area that is requested by Db2 ESTAE routines. z/OS formats and includes this block when a summary dump is printed or when a formatted address space dump is requested.
The RTM2WA block contains the most recent information about the failing task at the time the dump was produced. Use this information to relate the problem in a dump to a specific SYS1.LOGREC entry by comparing the completion code, PSW, and abend reason code (if present) in register 15. This control block is used by the RTM to control processing of abends. It includes registers, the PSW, the abend completion code, and other useful information about the status of the subsystem at the time of the failure. The RTM2WA maps a description of the errors and control flags for the functions of task termination or storage termination within the RTM (recovery termination manager).
Finding the RTM2WA
- Locate the TCB summary.
The Print Dump Index or Table of Contents contains an entry and page number for
Task Control Block Summary
. - Find the TCB involved in the failure, looking for a TCB with a
nonzero completion code.
Scan the second column of the TCB summary, looking for a nonzero CMP value. Notice the address of the TCB (in the first column) and the page number on which the TCB is located (in the last column). This TCB was involved in the failure.
- Locate the RTM2WA
eye-catcher
in this TCB. This is the unformatted RTM2WA control block.From the beginning of the TCB, turn forward a few pages. The eye-catcher is in the left margin.
If you have access to a tool that allows you to examine dumps in machine-readable form, then search for RECORD ID = X'0039' to find the unformatted RTM2WA control block.
In most error situations, a summary of the most important information in the RTM2WA block is formatted and can be found near the unformatted RTM2WA control block in the dump.
The following figures show the formatted and unformatted versions of the RTM2WA.
+1C COMPLETION CODE 0004E000
+8C ABENDING PROGRAM NAME N/A
+94 ABENDING PROGRAM ADDR 00000000
+3C REGS AT TIME OF ERROR 00000000 0004E000 001957A0 005A1DDC 009B5CE0 005A1C2C 009B8C78 005A9BA8 (0-7)
+5C 0099F550 0025B15A 005A1F58 4025AF24 005A1F58 4025B168 00C90001 (8-F)
+7C EC PSW AT TIME OF ERROR 0025B176 0002000D 0024F5A0
+DC SDWACOMP 00000000
+E8 RETURN CODE FROM RECOVERY ROUTINE-00,CONTINUE WITH TERMINATION-IMPLIES PERCOLATION
+E0 RETRY ADDR RETURNED FROM RECOVERY EXIT 009BE2A0
+E4 00000000
+C CVT ADDR 00035768
+38 RTCT ADDR 00FDAE78
+C8 SCB ADDR 005FC7D0
+D4 SDWA ADDR 001477B8
+14 SVRB ADDR 005FD158
+16C PREV RTM2WA FOR THE TASK 00000000
+170 PREV RTM2WA FOR RECURSION 00000000
+B8 ASID OF ERROR IF CROSS MEMORY ABTERM 0000
+36C ERROR ASID 000E
+37C CURRENT TRACE ENTRY FOR SAVED TRACE TABLE 00000000
+380 FIRST TRACE ENTRY FOR SAVED TRACE TABLE 00000000
+384 LAST TRACE ENTRY FOR SAVED TRACE TABLE 00000000
-RTM2WA---------------------------------AT LOCATION 005BF9A0
------
+0 D9E3D4F2 005BF9A0 FF0004D4 00035768 005CAEA8 005FD158 00FC85F0 0004E000
+20 80808001 005FC7E8 80000000 00000000 005CAEA8 005FD158 00FDAE78
-EED TYPE1 REGS AND PSW
+3C 00000000 0004E000 001957A0 005A1DDC 009B5CE0 005A1C2C 009B8C78 005A9BA8
+5C 00000010 0099F550 0025B15A 005A1F58 4025AF24 005A1F58 4025B168 00C90001
+7C 077C2000 0025B176 0002000D 0024F5A0
----
+8C 005FD040 00000000 00000000
-EED TYPE 3 MACHINE CHECK
+98 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000
----
+B4 04041041 00001000 00000000 005CA058 00000000 005FC7D0 005ED820 00000000
+D4 001477B8 FA000418 00000000 009BE2A0 00000000 00000000 FF74000D 6025B176
+F4 FF8500DF A07DF74A 00000000
-SNPPARMS
+100 00000000 00000000 00000000 00000000 005BFD84