This documentation supports the 23.3 version of BMC Helix Innovation Suite (AR System and BMC Helix Innovation Studio).

To view an earlier version, select the version from the Product version menu.

Troubleshooting when approving requests through emails does not work

You might notice that approving requests through emails does not work. See the guidelines described here to troubleshoot the issue or create a BMC Support case.


You cannot approve requests through emails.


  • One or more users might experience the symptom.
  • In a Server Group environment, the symptom can affect one or more servers.


Perform the following steps to troubleshoot issues that occur when approving requests through emails:


Review the Email Engine configuration.

  1. On the Email Engine Configuration form, review the configuration for the incoming mailbox and the outgoing mailbox.
  2. Test the configuration setting by using the Test Utility Open link .
    If the Test Utility fails, update the configuration and then retest.
    For more information, see Troubleshooting Email Service.


Validate the Approval Server configuration.

  1. Run the checklist for approval server configuration Open link .
  2. Test that approval sever is working correctly.
    The following video (6:32) explains how to test Approval Server.


Review Email Engine logs.

  1. Review the following Email Engine log files for any severe errors:
      • (Windows): EmailEngineInstallDir\AREmail\Logs\email.log
      • (Linux): EmailEngineInstallDir/logs/emaild.sh_log
  2. Run the following advanced query on the AR System Email Messages form:
    'Message Type*' = "Outgoing" AND 'Send Message' = "Error"


Enable Approval logs.

  1. Enable Approval server logs in the Debug mode Open link .
  2. Perform the following steps to enable AR System server-side API log, Filter log, and SQL log:
    1. Open AR System Administration Console.
    2. Select System > General > Server Information.
      The Server Information page is displayed.

    3. On the Log Files tab, select the API Log, Filter Log, and the SQL Log check boxes.

    4. Click Apply, and then click OK.
    5. TheAR System server
    6.  server-side API log, Filter log, and SQL log are enabled.
5.Analyze logs.

Review the logs to identify any error messages or behaviors.

See the table to troubleshoot issues based on the symptoms and error messages.

6.Collect logs and disable logging.

Perform the following steps:

  1. Run the Support Assistant tool.
    Note: You must click Zip Logs (not Zip All Logs) to collect the log files.
  2. Copy the log files to another location and review them so that they do not get overwritten.
    Note: A few log files might be huge in size.
  3. Disable the logs that you enabled in step 4.
7.Create a BMC support case.

Collect and send logs with detailed information when creating a case with BMC support case:

  1. Provide the following information as part of your case:
    • The name of the user who executed the approval
    • The item used for approval or rejection
    • The time when the approval or rejection was executed
    • Any error messages that you received
  2. Attach a ZIP file to your case.
    You can attach a ZIP file of size up to 2 GB. You can also upload the file on FTP.

After you determine a specific symptom or error message, use the following table to identify the solution:


You get the ARERR 4927 error message.
When you try to configure email-based Change Request approvals, you get this error after Email Engine processes the approval email.

On screen

See Error 4927 on Email Based Approvals Open link .

You get the ARERR 4931 error message.
You cannot decrypt the modify key error while approving changes by using an email.
On screen

See Error: "ARERR 4931 - Unable to decrypt the modify key" while approving changes through email in server group environment Open link .

You get the ARERR 4934 error message.
You notice that the Gmail client does not interpret special characters correctly, which causes the reply in an email message to be in a single line instead of the required separate lines.
On screen

See Email-based approvals are not working when using gmail email client. Encounter ARERR 4934 - The modify key in the incoming modify action email message is invalid Open link .

You get the ARERR 4934 error message.
You notice that the approval email is rejected with the following error message:
The modify key in the incoming modify action email message is invalid. Make sure that the modify key was not modified.
On screen

See Approval e-mail is getting rejected showing "The modify key in the incoming modify action email message is invalid. Make sure that the modify key was not modified" Open link .

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