Email Connection

The Email connection facilitates the sending of emails either when a Notification (CALL) object starts or when the script function SEND_MAIL is used. This function has been implemented in the Automation Engine and in Windows, UNIX and Java agents (SAP, Rapid Automation, JMX and SQL).

The MAPI2 interface of Windows agents is no longer available as of version 9.00A. The only supported email interface now is SMTP.

Note: Only configure the Email connection for the Automation Engine since it applies automatically for all agents that support the sending of emails (Windows, UNIX, SAP, Rapid Automation, JMX, SQL). The Administration perspective displays the value MAIL in the column Service of all these agents.

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

• Send by using a Notification object (type Email, Alarm, Request, Message with the option Send Email), 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 via 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 right P for the authorization types JOBS and EXTREP).

• Send by using script function SEND_MAIL

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

Notes:

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

To Configure the AE Email Connection

1. Log on to system client 0000.
2. Open the variable UC_CLIENT_SETTINGS and fill in the SMTP parameters. For more information, see SMTP Parameters and 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.