This is an archive related to a previous version of Esri Maps for IBM Cognos. If you need the current version go to http://doc.arcgis.com/en/maps-for-cognos/.

Change the logging levels

Changing the logging level can help troubleshoot installation and configuration issues. The following log levels are available for EM4C Server and EM4C Dispatcher:

  • DEBUG
  • INFO
  • WARN
  • ERROR
  • FATAL

EM4C Server

The default level of logging is ERROR, which is suitable in most situations.

To change the log settings for EM4C Server, the following must be completed on each EM4C Server computer.

These steps must be performed by an administrator.

  1. Browse to em4c_location\webapps\em4c\WEB-INF\classes.
  2. Open the log4j.properties file in a text editor.
  3. Change the following lines (as appropriate):
    log4j.logger.com.esri.em4c.cognos.custom.customRequestHandler=ERROR, stdout 
    log4j.logger.com.esri.em4c=ERROR, stdout, A1
    
  4. Restart EM4C Server.

EM4C Dispatcher

EM4C Dispatcher logging must be manually configured.

By default, EM4C Dispatcher logs its entries in the IBM Cognos cogserver.log file. You can enable additional logging to help troubleshoot issues with EM4C Dispatcher.

  1. On each EM4C Dispatcher in your environment, make a backup of the log4j.properties file. This file can be found in the following location:

    <ibmcognos_root>\webapps\p2pd\WEB-INF\classes\

  2. Add the following to each log4j.properties file in your environment:
    log4j.logger.com.esri.em4c.cognos.handlers.RSVPHandler=trace,EM4C
    log4j.logger.com.esri.em4c.cognos.handlers.ServiceStatusThread=trace,EM4C
    log4j.appender.EM4C=org.apache.log4j.DailyRollingFileAppender
    log4j.appender.EM4C.file=C:/logs/em4c_handler.log
    log4j.appender.EM4C.layout=org.apache.log4j.PatternLayout
    log4j.appender.EM4C.layout.ConversionPattern=%d  %5p (%M:%F:%L) - %m%n
    
  3. Restart the IBM Cognos Service.

    A log file, em4c_handler.log, is created in the location specified by the log4j.appender.EM4C.file property. You can specify a different location or file name by changing the value of this property.

  4. If you need help reading and understanding the log file, contact Esri Support.