This documentation supports the 9.0 version of Remedy Action Request System.

To view the latest version, select the version from the Product version menu.

BMC Remedy Email Engine logs

The reason you have issues sending or receiving email can depend on when the error occurs and the frequency at which it occurs. The best way to troubleshoot these issues is by creating log files and examining your console output.

To use the BMC Remedy Email Engine logs and console output

  1. Stop the BMC Remedy Email Engine, and then re-start it from the command line by using debug mode. For more information, see Creating email debug batch files.
  2. Examine the BMC Remedy AR System Email Error Logs form. The email daemon always uses the BMC Remedy AR System Email Error Logs form when logging errors and warnings. This should be the first place you look to identify an issue.
  3. Consult the console output to access more details, such as stack traces and the exact exceptions generated. The location of the console output depends on how the application is executed and on which system.
    • (Recommended) For both Windows and UNIX, when the BMC Remedy Email Engine is started from the command line, all console output is piped to the open console window.  
      This is the quickest and easiest way to identify an issue because you can see where the output actually occurred and you can trace any errors.
    • When the email daemon is executed on Windows as a service, the output is located under the logs subdirectory of the BMC Remedy Email Engine installation (by default, emailEngineInstallDir/AREmail/Logs).  
      For more information, see Log file information.  
      On UNIX, the console output is placed under the emailEngineInstallDir/logs directory, but is stored in only one file called emaild.sh_log.
  4. Make sure that console logging is turned on in the file, located in the AREmail directory.
  5. Enable the console output with the following handler property:

    handlers = java.util.logging.ConsoleHandler
  6. Set the level for console logging. You set this level with the following line:

    java.util.logging.ConsoleHandler.level = INFO
  7. Set the level for the entire application. On the AR System Configuration Generic UI form, ensure that the following settings are set to INFO level. By default, the level is set to OFF. You should set following levels to INFO. For more information on the settings, see Configuration settings C-D.

    com.bmc.arsys.emaildaemon.level = INFO
    com.bmc.arsys.emaildaemon.ARSystemHandler.level = INFO

    The first setting sets the level for the entire application; the second setting sets the level for logging to the BMC Remedy AR System Email Error Logs form. The level for the form logging should never be set lower than this. Otherwise, the table will fill up very quickly and use unnecessary space.

Log file information

The email.log file is located in the <emailEngineInstallDir>/AREmail/Logs directory.

The log file can include the following information:

  • Email transmission or instruction failures
  • BMC Remedy AR System API errors
  • Internal Email Engine errors
  • System status logs, which include information about:
    • All incoming emails (the email is included in the logging message as an attachment)
    • All outgoing emails (the email is included in the logging message as an attachment)
    • Connection status information for email servers
    • Connection status information for the BMC Remedy AR System server containing the configuration, logs, and email form
    • Date and time the Email Engine was started or stopped
    • Changes to the configuration of the Email Engine

Was this page helpful? Yes No Submitting... Thank you


  1. Mark Wychowski

    For steps 4,5, and 6, it would be helpful to show us how to do these things.  It may be 2nd nature for people who do it on a daily basis, but those of us  with other responsibilities struggle to remember the specifics.  I'm sure new admins feel the same way.

    Jun 15, 2017 08:07
  2. Mark Wychowski

    For step 3 how about an example of starting the BMC Remedy Email Engine from the command line

    Jun 15, 2017 08:08
    1. Anagha Deshpande

      Hello Mark,

      Thanks for the inputs. I will confirm with SME and will update the topic.



      Jun 15, 2017 10:23
      1. Anagha Deshpande

        Hello Mark,

        Perform the following steps to start BMC Remedy Email Engine from the command line:

        • Navigate to Install directory > Email. 
        • Run the EmailStart.batfile.
        • (Optional) If you want the debug logging on, set the Dmail.debug = true in the EmailStart.bat file.

        Hope this helps.



        Jul 04, 2017 12:52