Troubleshooting

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.

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).

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 page will look like:

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.

Under Error Codes you can find the name of the errors that ICM and Web dispatcher know of.

You can create a default page or a separate page for each error (static or dynamic). For details see Setting Up Error Pages.

An example of a dynamic error page can be found here.

ICM / Web Dispatcher Prioritizing

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

If parameter is set, when 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}(see 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). You can use the Web Administration Interface to restart the web dispatcher, or the ICM monitor to restart the ICM (Transaction SMICM) (see Monitoring the ICM Using the ICM Monitor.)