Default language.

AR System Email Error Messages form

In this topic:

The AR System Email Error Messages form stores any incoming email message that has not been processed correctly due to any runtime error, along with the error details.


Note

This form stores information only for incoming email messages.


Warning

(For incoming mails that have not been processed correctly due to any runtime error) The Email Engine considers the HTML format, by default. If the incoming message is in a plain text format, Email Engine first checks for the HTML format and when not found, considers the plain text format. But, if the incoming mail is in a plain text as well as HTML format, the Email Engine only considers the HTML format. For the Email Engine to consider the plain text format, change the HTML format to a plain text format (without any spaces) or clear the HTML format.


Copying incoming messages to the AR System Email Messages form


After manually rectifying the errors, you can copy these incoming messages to the AR System Email Messages form.

Best practice
We recommend that you perform the rectification process individually on every error out email message. Do not perform the rectification process on more than one email message at the same time using the Modify All option.



To copy the rectified incoming messages to the AR System Email Messages form


  1. From the Message Information tab, change the status of the message to Yes.

  2. Click on the Copy to AR System Email Messages Form button. After the rectified messages are copied to the AR System Email Messages form, the Email Engine processes the incoming actions at the next polling interval. However, if there are messages in the incoming queue, the rectified messages are parsed at the next polling interval. Increase the time of the polling interval, if you want to parse the rectified messages in spite of the messages in the incoming queue.

    The messages stored on the AR System Email Error Messages form, are not deleted even after they are moved to the AR System Email Messages form. The administrator can configure the period and the conditions for deleting these mails using the "Clean AR System Email Error Messages" escalation.

    Note

    This escalation is disabled by default.


Enabling the Clean AR System Email Error Messages escalation


Follow the steps given below to enable the Clean AR System Email Error Messages escalation.


  1. Go to Escalation > Execution Options.
  2. Change the value of the State field to Enabled.

  3. (Optional) Change the Escalation period in accordance with your requirements from the default value of 15 days.

    Note

    Additional conditions can be set using the Run Process field.

  4. To clean up the system logs, restart the BMC Remedy Email Engine.

    All the messages in the AR System Email Error Messages form will be deleted depending upon the conditions set in the escalation. For each message, this form provides the name of the mailbox from which the message was generated, the message type, name and organization of the mailbox owner; names of recipients sent to and copied; the text of the message (in HTML, plain text format, or a combination of both); and (under a separate tab) a list of any attachments included with the message.


    Fields on the AR System Email Error Messages form


Message tab




Fields on the AR System Email Error Messages form--Messages tab



Attachments tab




Fields on the AR System Error Messages form--Attachments tab



Advanced Options tab


Fields on the AR System Email Error Messages form--Advanced Options tab

Field name

Description

Templates tab

Header Template

Template to be used as the header template.

Content Template

Template to be used as the content template.

Footer Template

Template to be used as the footer template.

Variable Replacement tab

Field Values

Value for a variable in the template.

AR System Server

With qualification variables, name of the server on which the form resides.

AR System Server TCP Port

With qualification variables, any access information necessary.

AR System Server RPC Number

With qualification variables, any access information necessary.

AR System Form

With qualification variables, name of the AR System form to which these values apply.

Qualification

Query used to retrieve data and substitute it in the email.

Attachment Alternatives tab

Attachment Alternatives (attachment pool)

Attachment pool enables you to add the content of your email as a plain text, HTML, or RTF attachment, instead of typing it into the Body field in the Message tab.

Plain Text Content Attachment Encoding

Language encoding used.

HTML Content Attachment Encoding

Language encoding used.

RTF Content Attachment Encoding

Language encoding used.

Values Attachment Encoding

Language encoding used.



Message Information tab




Fields on the AR System Email Error Messages form--Message Information tab



Errors tab


Enables users to view error messages if their email is not sent correctly.


Fields on the AR System Email Error Messages form--Errors tab


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*