The Email connection facilitates the sending of emails either when a Notification 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, RA, 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.
General Information
Only configure the Email connection for the Automation Engine, it applies automatically for all agents that support the sending of emails (Windows, UNIX, SAP, RA, JMX, SQL). The Administration perspective includes the value "MAIL" in the "Service" column of all these agents.
Depending on the situation in which you send an email, either the Automation Engine or an agent is used. Ensure that they can access the relevant directory if you attach files.
| Send by using | Email connection |
|---|---|
| Notification object
(type "Email" or "Alarm", "Request", "Message" with the option "Send Email") |
The Automation Engine is used to send the emails. Exception: If external job output files of jobs are attached (Notification tab - Attach reports from), 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"). |
| Script function SEND_MAIL | Mails are either sent via the Automation Engine or, if defined, an agent. |
Notification objects abort with a corresponding message when the sending of an email fails.
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 successful sending of emails is logged in the reports of the Notification objects. The script element SEND_MAIL does not output any information in the activation protocol. However, you can check the return code of this function and output a corresponding message.
To Configure the AE Email Connection
- Log on to system client 0000.
- Open the variable UC_CLIENT_SETTINGS and fill in the keys that have names that start with "SMTP."
- 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.