Email Connection

The Email connection allows you to send emails when a Notification (CALL) object starts or when you use the SEND_MAIL script function. This functionality is available in the Automation Engine and Windows, UNIX, and Java agents (SAP, Rapid Automation, JMX, and SQL). SMTP is the email interface that is used for this purpose. You only need to configure the Email connection for the Automation Engine as it automatically applies to all agents that support the sending of emails. The Administration perspective displays the value MAIL in the Services column of the Agents pane of all these agents.

Depending on the situation in which you send an email, the system either uses the Automation Engine or an agent. Make sure they can access the relevant directory if you attach files.

You can send emails by

  • Using a Notification object (Email, Alert, Request, or Message type), see Notification (CALL)

    The Automation Engine is used to send the emails.

    Exception: If external job output files of jobs are attached (see Notification Attributes), the email is sent through the agent on which the job has been executed. The notification aborts if the agent is not active, if the files cannot be found, or if the user does not have the required authorizations (the P - Open Report right for the JOBS and EXTREP authorization types).

  • Using the SEND_MAIL script function

    Mails are either sent through the Automation Engine or, if defined, an agent.

Notes:

  • Notification objects abort with a corresponding message when the sending of an email fails.
  • The reports of the Notification objects log when emails are successfully sent.
  • With SEND_MAIL, script processing continues if an error occurs. Despite this, you can use the :ON_ERRORscript function, and define an appropriate reaction.
  • The SEND_MAIL script element does not output any information in the activation report. However, you can check the return code of this function and have a corresponding message printed.

To Configure the AE Email Connection

  1. Log on to system client 0000.
  2. Open the UC_CLIENT_SETTINGS variable and fill in the SMTP parameters. For more information, see SMTP Parametersand UC_CLIENT_SETTINGS - Various Client Settings.
  3. Other settings for individual clients: Assign the above variable to the particular clients and adjust it accordingly. The settings that are made in system client 0000 apply for clients without SMTP settings in their variable UC_CLIENT_SETTINGS.