Debugging the Email Engine on Windows

To enable the -Dmail.debug=true debug mode option for Windows, perform the following steps.

To debug the  on Windows

1. In the EmailStart.bat file, add the -Dmail.debug=true option as follows:

   "%JavaPath%\java" -Dmail.debug=true -cp emaildaemon.jar;arapi<releaseNum>.jar;arutil<releaseNum>.jar;activation.jar;mail.jar;imap.jar;smtp.jar;pop3.jar;armapi<releaseNum>.jar com.bmc.arsys.emaildaemon.EmailDaemon

   The default location of the EmailStart.bat file is C:\Program Files\BMC Software\ARSystem\AREmail.

2. Save the batch file as another name, for example, emaildebug.bat.
3. Make sure that the  service is stopped in the Services window.
4. Open a command prompt, change the directory to the location of the  install directory, and run the new batch file. This batch file adds debug information to the screen when the  is started from a command prompt. You can also direct the output to a file by adding > c:\temp\debug.out to the end of the previous Java statement.

To generate debug log using the Windows  service

1. From the Services window, stop the  service.
2. Open the Windows registry, and navigate to HKEY_LOCAL_MACHINE > SYSTEM > CurrentControlSet> Services\BMC Remedy Email Engine – MACHINE_NAME 1\Parameters.
3. Create a new String Value, name it JVM Option Number 4, and set its value to -Dmail.debug=true.
4. Change the value of JVM Option Count to 5.
5. Start the  service.

The debug log is available in the emailEngineInstallDir\AREmail\Logs\email.log file.

When you set the value of the com.bmc.arsys.emaildaemon.ReceiverModule.level parameter to SEVERE, the debug entries are displayed a the top of the email.log file and the module entries are displayed a the bottom of the email.log file.

See the following screenshots.

Debug entries displayed at the top of the email.log file:

Module entries displayed at the bottom of the email.log file: