Natural under IMS TM - Recovery Handling

This document describes recovery handling in the Natural IMS TM Interface.

The following topics are covered:

System and User Abends

The Natural IMS TM Interface is protected by an ESTAEX environment which takes control in case of an abend.

  • If a user abend is detected, resources are cleaned up and the abend is percolated without giving control to Natural.

  • If a system abend is detected, Natural is informed about the abend and, depending on the setting of the Natural profile parameter DU, Natural continues with an error message or terminates the session.

  • If the support of IBM's Language Environement (LE) is enabled and the abend occurs while an LE program has control, user-written or language-specific condition handlers are honored and Natural is only informed about the abend if the condition is percolated by all LE condition handlers. In this case, the abend is handled by Natural in the following steps before the standard abend handling takes place:

    • the corresponding LE error message is written to SYSOUT,

    • an LE snap dump is written to CEEDUMP according to LE run-time option TERMTHDACT,

    • LE is instructed to resume processing after the Natural CALL statement,

    • a special Natural error message (NAT0950 if DU=OFF or NAT9967 if DU=ON) is issued which indicates the LE error number.

    In all cases, you can produce a dump which represents the situation at the time when the error occurred (register contents, PSW, etc.). The dump is produced if DU=ON or DU=SNAP or if the user abend has requested this.

Non-Recoverable Errors

A non-recoverable error is a logical error detected by the Natural IMS TM Interface which cannot be handled by Natural. These situations typically occur during startup, termination or terminal I/O. In all cases, the Natural runtime is not active and can thus not react to the error.

If a non-recoverable error is detected, the Natural IMS TM Interface issues an NII error and terminates the session. The error message is also written to the IMS TM log and to the system log. Depending on the dump option in the error message table, a snap dump is produced.

If you do not wish a message to be written to the IMS TM log, set the ERRLHDR keyword subparameter of the NTIMSPE macro (Natural parameter module) explicitely to null, that is, you specify ERRLHDR=,.

If it is not possible to send the error message (for example if the GU has failed), the session abends (user abend).

Recoverable Errors

If a logical error is detected by the Natural IMS TM Interface which can be handled by Natural, for example an invalid destination for a report, a Natural error message is issued and Natural proceeds with its standard error handling.