Specifying the level of detail displayed in error messages

You can specify the level of details that are displayed in an error message to help you troubleshoot your problem. Change this setting by modifying the properties in the Web.config file.

About this task

Error messages include details that can help IBM Support diagnose the problems and trace the events that led up to the failure. As a system administrator, you might want to restrict the type and quantity of information that is displayed in the error message as a security precaution. Errors can contain sensitive information that you do not want users to see.

You can change the level of details shown in the error messages by setting the ControllerWebServiceException property in the ASP.NET Web.config configuration file. The Web.config file specifies configuration information that is specific to IBM Cognos Controller.

Procedure

  1. In a text editor, open the web.config file.

    The default location of the Web.config file ccr_location/ ControllerProxyServer

  2. Go to the ControllerWebServiceException property and change the detail setting based on the following values: 
     <!--Return error to client, Levels: 0=None, 1=Normal, 2=All-->
<add key="ControllerWebServiceException" value="1"/>

    The property value is set to 1 by default. When the property is set to 0, no details are provided except for the instruction to contact the system administrator. If you set the property to 2, users can send the information in the Details section of the message to IBM Support for further investigation.

  3. Save the changes and close the editor.

Results

You are not required to restart the web server after modifying the Web.config file. For performance reasons, Internet Information Services (IIS) monitors the Web.config file for changes and caches the contents.