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

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

Configuring incoming mailboxes

Based on the information that you enter in the AR System Email Mailbox Configuration form, the Email Engine polls incoming mailboxes for new messages, processes the messages, parses the contents if necessary, and performs the actions specified in the messages, such as modifying requests or executing queries.

Incoming mailboxes support the MAPI, POP3, IMAP4, and MBOX mail protocols.

To configure basic incoming mailbox properties

Basic configuration for your incoming mailbox consists of you entering the following information in the Basic Configuration tab on the AR System Email Mailbox Configuration form:

  • Mailbox information, such as the mailbox name
  • Server information, such as the mail protocol associated with the server and the server port number

Perform the following steps:

  1. Open the AR System Email Mailbox Configuration form.
  2. Enter the following information in the fields above the tabs:
    • Mailbox Name — Enter a name that describes the function of the mailbox. For example, enter ARSystemEmail - Incoming.
    • Mailbox Function — Select Incoming.
    • Status — Select Enabled.
  3. In the Basic Configuration tab, select MAPIPOP3IMAP4, or MBOX as the Email Server Type, and set the following values in the remaining fields:
    • MAPI(for 32-bit JVM only):
      • Server Type — Select MAPI.
      • Polling Interval(Minutes/Seconds) — Select a polling interval for the Email Engine to check for new incoming email from the mail server.


        The polling interval is treated as minutes or seconds based on the property com.remedy.arsys.emaildaemon.MailboxPollingUnitIsMinutes in the file. If this property is set to False, the polling interval is treated as seconds. Otherwise, it is treated as minutes.

      • Profile Name — Enter the name of the Microsoft Exchange profile that you created during the product installation.
        This field is required because a profile is used to see the MAPI email account configuration information. For more information about Microsoft Exchange profiles, see your Microsoft Exchange documentation.

        MAPI protocol requires Microsoft Outlook 32-bit client, irrespective of the OS bit size.

    • POP3 or IMAP4 only
      • Server Type — Select either POP3 or IMAP4.
      • Polling Interval(Minutes/Seconds) — Select a polling interval for the Email Engine to check for new incoming email from the mail server.
      • Email Server Requires SSL — Select Yes to enable Secure Sockets Layer (SSL). For more information, see Configuring SSL for the Email Engine.
      • Email Server Name/IP — Enter the name or IP address of your company's mail server.
      • Email Server Port — Enter the mail server port number, or click Set Default Email Server Port to accept the default port.
      • Email Server User — If your mail server requires authentication information before sending email, enter the email account user name.
      • Email Server Password — Enter the password corresponding to the server user.
    • MBOX only:
      • Server Type — Select MBOX.
      • Polling Interval(Minutes/Seconds) — Select a polling interval for the Email Engine to check for new incoming email from the mail server.
      • Inbox Path — Enter the complete path to the MBOX file that corresponds to the user email account. For example, enter /usr/spool/mail/ARSystem, where ARSystem is the file name.
  4. Click Save.

To configure advanced incoming mailbox properties

During advanced configuration, you enter information about associated mailboxes, templates, and forms, and information related to mailbox security. You can do this by using the Advanced Configuration tab of the AR System Email Mailbox Configuration form as shown in the following figure. 

 Advanced configuration for incoming mailboxes

(Click the image to expand it.)


Review the information about advanced configuration settings in Creating and using email templates.

Perform the following steps:

  1. In the Advanced Configuration tab of the AR System Email Mailbox Configuration form, select an outgoing mailbox from the Associated Mailbox Name list to reply to incoming emails that require responses, such as queries.
  2. In the Action Configuration section, specify:
    • Email Action — To enable the Email Engine to detect and process instructions included in an incoming email message, select Parse. If you use templates to perform Submit, Modify, or Query actions, you must select Parse.
      For more information about templates and parsing, see Using label-value pairs in templates and Types of email templates.
    • Use Original Template Format   (enabled for upgrades from BMC Remedy Mail Server) — To enable original parsing system processing, select Yes.
      Original parsing ignores special HTML fields, XML formats, and data entered in an invalid format, such as a character string in a number field. If you use this option, the Email Engine displays an error message when it encounters these types of fields or formats. To use normal parsing, select No.


      If you select No, make sure that multiple lines in emails are encapsulated with the [$$ and $$] multiple-line delimiters.

    • Reply with Result — To enable the Email Engine to return the results of an action in an email, select Yes.
      This option allows the email sender to know if the incoming email succeeded or failed. 
    • Reply with Entry — To return the complete entry of a submit or modify action, select Yes.
    • Enable Modify Actions — To enable the Email Engine to modify existing entries, select Yes.
    • Default Workflow Form — Enter the name of the default form on which the Email Engine executes instructions such as queries, form-entry modifications, and form submittals, from the incoming email message.


      If you define a default workflow form, incoming templates do not require the Form (or Schema) label. For more information, see Form label.

    • Force Default Workflow Form — To confine all instructions from the incoming email message to the form that you specified in the Default Workflow Form field, select Yes.


      If an incoming template specifies a schema, the schema will not be processed and the default workflow form will be used instead.

  3. In the Incoming Security Configuration section, specify the level of security to be applied to email messages to this mailbox. This information is used to determine which AR System user information to apply when executing instructions parsed from an incoming email.
    Depending on the level of security that you want, apply one of the following security options:
    • Use Security Key — Select Yes to enable a security key for incoming email.
      The information is added to the Email Security form, so you do not have to supply the user name and password in the incoming email. If you use this option, you must create and configure the security key. See Configuring incoming mailbox security.
      If you select No, the security key will be disabled for incoming email containing the modify action. In case of multiple recipients, the outgoing email message for this modify action will not be sent.
    • Use Supplied User Information — To use AR System server login information from the incoming email message to execute instructions in the incoming message, such as instructions to modify requests or submit queries, select Yes.
      For more information about login syntax, see Login, Password, and TCP Port labels.
    • Use Email From Address — To use the sender's email address as a form of authentication, select Yes.
      The Email Engine displays an error message if the sender's email address is different from the email address stored in the AR System User form.


      Apply only one of the given security options.

  4. Click Save.

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