Show TOC

Background documentationError Handling Locate this document in the navigation structure


A standard error handling mechanism is implemented in the ICM and Web dispatcher. You can however configure both components so that a different error handling mechanism suitable for your application area is used.

Caution Caution

Error situations that occur in the back end are not handled by the ICM/Web Dispatcher. If, for instance, an HTTP error 404 (file not found) occurs in the file access handler of the ICM/Web Dispatcher, an error page is returned if one is configured. But if the request goes to the Application Server ABAP (because of the URL) and the requested file is not found in the Internet Communication Framework (ICF), the ICM forwards the error page generated by the ICF to the browser.

End of the caution.
Standard Error Handling

If the ICM or Web dispatcher finds an error, in most cases it returns a static text to the browser:

The ICM/Web dispatcher also behaves like this when it is in Maintenance Mode).

Note Note

If this error page is too detailed for you due to security reasons, you can set profile parameter is/HTTP/show_detailed_errors to FALSE. The details will then be suppressed and the message will look like:

End of the note.
Controlling Error Handling

You can also configure the ICM and the SAP Web dispatcher so that they returns dynamic error pages.

The following section describes how you do this.

ICM / Web Dispatcher Prioritizing

If parameter icm/HTTP/error_templ_path is not set, the ICM static error page is always returned.

If the parameter is set, and if error <ERRNAME> occurs, the ICM or Web Dispatcher first checks whether file ICMERR<ERRNAME>.html is located in the directory specified by icm/HTTP/error_templ_path, and sends it to the client. If it cannot find this file, it searches for ICMERR<ERRNAME>.shtml and returns it.

In no specific error page can be found, the ICM returns the default error page ICMERR-EDEFAULT.{html,shtml} (as above). If this file also does not exist, the static page is returned.

Updating Error Pages

For reasons of performance, the ICM or Web dispatcher checks once the error templates that are available. This is why you must restart the ICM if you add new templates (changes to the templates are recognized). To restart the ICM, you can use the Web administration interface.