DFS627W IMS RTM FAILURE (xxx) FOR task id

Explanation

The IMS resource termination manager (RTM) produces two forms of message DFS627; one is a warning and the other is informational.

The warning message, DFS627W, appears every time a recoverable failure occurs during RTM processing, or when a nonzero return code is received from a routine called by RTM. The message provides a failure code, xxx, specifying the function executing at the time the failure is detected. RTM resumes processing with the next function in the termination process.

The informational message, DFS627I, is produced once for the job step TCB at the end of cleanup, and once for each ESTAE failure under a subtask. An ESTAE failure occurs when the SDWA is not present or no retry is possible. If all TCBs complete without errors, the informational message shows a status of COMPLETE with an X'00' return code; otherwise, the status is FAILED with a return code of X'FF'. (See the hexadecimal return codes described later in the message for the meaning of return code X'FF'.)

Remember: When ESTAE is entered and retry is possible, the SDWA is written to SYS1.LOGREC. Included in the entry are the job name, the release and level of the terminating IMS, and the failure code.
The following table shows the message text:
Table 1. DFS627W message text
Keyword Values Meaning
type EOM EOT ESTAE End of Memory End of Task ESTAE failure; no retry possible.
status COMPLETE FAILED IMS finished successfully. IMS encountered at least one failure during cleanup.
task ST JS Subtask Job step task.
id jobname ID=imsid For End of Task failure For End of Memory failure.
The return code, xxx, indicates the results of resource cleanup processing. Return code values X'00' through X'FF' are produced by DFSRTM00. Values X'04' through X'78' represent failures during End of Task termination. Values X'C8' through X'EC' represent failures during End of Memory termination. Other values produced by DFSRTM00 apply to either type of termination. Return code X'100' or greater are produced by DFSMRC20. The return codes have the following values and meanings.
Code (hex)
Meaning
00
Cleanup finished successfully.
01
GETMAIN failed for work area. Minimal cleanup processing is performed.
04
ESTAE could not be established. Minimal cleanup processing is performed.
08
Not used.
0C
A failure occurred while scanning the TCB Table during TCB validation. Processing resumes with the next function.
10
A failure occurred while performing Availability Manager disconnect processing (XRF environments only). Processing resumes with the next function.
14
RTM received a nonzero return code from GETMAIN when storage was requested for save areas while performing Availability Manager disconnect processing (XRF or Fast Database Recovery environments only). Processing resumes with the next function.
18
A failure occurred while performing IMS Intersubsystem Interface termination processing. Processing resumes with the next function.
1C
A failure occurred while disconnecting memory-to-memory window headers. Processing resumes with the next function.
20
A failure occurred while scanning TCB DEB chain. Processing continues with the next DEB on chain.
24
A failure occurred while performing HALT I/O or quiesce function for channel to channel device. Processing continues with the next DEB on chain.
28
A failure occurred while closing an OSAM data set. Processing continues with the next DEB on chain.
2C
A failure occurred while closing an OS data set. Processing continues with the next DEB on chain.
30
A failure occurred during processing, or nonzero return code received from IMS Resource Lock Manager quit function. Processing resumes with the next function.
34
A failure occurred while page freeing OSAM short term I/O pages. Processing resumes with the next function.
38
A failure occurred while disconnecting cross-memory tables. Processing resumes with the next function.
3C
A failure occurred while releasing CSA storage for RGPARMS. Processing resumes with the next function.
40
A failure occurred during processing or nonzero return code received from SVC termination and CSA cleanup routine. Processing resumes with SVC directory cleanup.
44
A failure occurred during processing or nonzero return code received from SVC directory cleanup routine. Processing resumes with the next function.
48
A failure occurred while performing an ENFREQ DELETE call to delete an IMS ENF listen exit. Processing resumes with the next function.
4C
A failure occurred while performing an IXLDISC call to disconnect from a coupling facility structure. Processing resumes with the next function.
50
A failure occurred while performing an ENFREQ DELETE call for the IMS ARM ENF listen exit. Processing resumes with the next function.
54
A failure occurred while performing Media Manager control block clean up for opened Fast Path DEDB areas. Processing resumes with the next function.
58
A failure occurred while performing Fast Path 64-bit buffer cleanup. Processing resumes with the next function.
59-5B
Not used.
5C
A failure occurred while performing logger cleanup. Processing resumes with the next function.
5D-67
Not used.
68
Batch IRLM PC cleanup.
70
A failure occurred attempting to set IMS DUMP SSCT to null. Processing resumes with the next function.
74
A failure occurred during delete subpool all function for IMS subtask. Processing resumes with the next function.
78
A failure occurred while trying to page free fixed storage used by OSAM to support Media Manager. Processing resumes with the next function.
C8
RTM received a nonzero return code from the SVC directory cleanup routine. Processing resumes with the next function.
CC
RTM received a nonzero return code from the IRLM quit function. Processing resumes with the next function.
D0
A failure occurred attempting to route control to DFSRTM00. The ESTAE in DFSMRC20 intercepts the abend and attempts an abbreviated cleanup.
EC
A failure occurred attempting to set IMS DUMP SSCT to null. Processing resumes with the next function.
F0
The DL/I subordinate address space can terminate without successfully performing resource cleanup for the region. If this happens, the DLS SSCTs might be left after the DLS region has terminated, which can produce abends in the Master Scheduler Broadcast function. In attempting to prevent certain abends if running with a DLS region, the control region job step TCB searches for the DLS SSCTs during cleanup processing. If either SSCT is found, SSCT cleanup is attempted. If cleanup of the DLS SSCTs succeeds, message DFS627W IMS RTM FAILURE (F0) FOR DLS is issued. If cleanup fails, the standard form of the warning message is issued. Processing resumes with the next function.
FC
Resource cleanup processing canceled by operator. Abend X'x22' is intercepted by ESTAE, and no retry processing is permitted. An abbreviated form of cleanup processing is performed by the ESTAE routine.
FF
Resource cleanup processing was completed, but one or more failures occurred during cleanup. Message DFS627W explains the reason for the failure.
100
While processing on behalf of an IMS TCB, DFSMRC20 determined that the DUMP SSCT was invalid. No cleanup is attempted for the terminating TCB.
104
ESTAE could not be established. Control is not passed to DFSRTM00. The only processing attempted is setting the DUMP SSCT to null.
108
DFSRTM00 address is zero in the SSCT. Abbreviated cleanup is attempted.
10C
A failure occurred attempting to route control to DFSRTM00. The ESTAE in DFSMRC20 intercepts the abend and attempts an abbreviated cleanup.
110
Previous job step or end-of-memory cleanup was attempted and failed. DFSMRC20 resets the IMS DUMP SSCT to null and returns to z/OS®. Some IMS resources might not have been cleaned up.
114
DFSMRC20 was called for a non-IMS job step TCB in an address space with an active IMS SSCT. This is usually the result of a prior IMS resource cleanup failure, or of DFSMRC20 not receiving control for an IMS job step TCB termination. DFSMRC20 resets the IMS DUMP SSCT to null and returns to z/OS. Some IMS resources might not have been cleaned up.
118
DFSMRC20 was called for task termination after the IMS job step TCB entered final termination in module DFSRTM00. The job step task is still active. This situation is not an error; however, this code is used internally for tracing this event for diagnostics.

System action

If the return code is X'00' for End of Task termination, the resource cleanup processing for the IMS region completed satisfactorily. If the return code is X'00' for End of Memory termination, cleanup completed satisfactorily, but is limited to non-task-related functions only. If the return code is X'FF', one or more failures occurred, and cleanup processing related to those failures might not have been completed.

Problem determination

1, 11, 36

Module

DFSRTM00, DFSMRC20