Sun Identity Manager 8.1 System Administrator's Guide

About Identity Manager Errors and Exceptions

This section describes the Identity Manager error and exception message system and the components that can generate errors and exceptions.

The information is organized into the following sections:

Where Messages Are Stored

Error messages are stored as follows:

Identity Manager messages are stored in a WPMessages.properties file in the idmcommon.jar and in the RAMessages.properties file in the idmadapter.jar.
The WPMessages.properties file is located in project_directory/waveset/idm/common/src/com/waveset/msgcat.
The RAMessages.properties file is located in project_directory/waveset/idm/adapter/src/com/waveset/adapter.

Sun Identity Manager Service Provider uses a standard Java message resource bundle for displaying strings in the user interface. This resource bundle is normally included in the idmspe.jar file and must be extracted if you plan to customize message strings.
```
$ cd $WSHOME/WEB-INF/classes
$ jar xvf ../lib/idmspe.jar com/sun/idm/idmx/msgcat/I
DMXMessages.properties
```

Identity Auditor messages are stored in the AUMessages.properties file, which is located in

project_directory/waveset/idm/auditor/src/com/sun/idm/auditor/msgcat/
AUMessages.properties

The Data Exporter’s default implementation includes its own message bundle, called WICMessages.properties. The WICMessages.properties file is located in the exporter.jar file in

com/sun/idm/warehouse/msgcat/WICMessages.properties

Note –

You can create a customized message catalog to add messages or to modify messages provided with the system.

See Chapter 9, Customizing Message Catalogs, in Sun Identity Manager Deployment Guide for instructions.

How Messages Are Displayed

For easy identification, Identity Manager displays page-level error and exception messages along the top of the page as boxed text with a unique error icon.

Figure 6–1 Example Login Authentication Error

Note –

In the Identity Manager messaging system, items displayed as {0} or {1} represent parameters that are supplied by code. For example:

The file is larger than the maximum supported length of
 {0} bytes.

In this exception, the code replaces the {0} with the parameter value representing the maximum number of bytes.

Error Severity Levels

Within Identity Manager, error severities are defined as follows:

Fatal. A severe error that causes your system to crash, resulting in the loss or corruption of unsaved data.
Error. A severe error that might cause the loss or corruption of unsaved data. Immediate action must be taken to prevent losing data.
Warning. Action must be taken at some stage to prevent a severe error from occurring in the future.
Info. An informative message, usually describing server activity. No action is necessary.

Note –

You can check the Identity Manager System Log for more information about an error or exception message. (See Viewing Errors in the System Log Report.)