Administration Guide > Installation > New Installation > E-mail Connection

E-mail Connection

The Email connection facilitates the sending of emails either when a Notification objectstarts 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 AutomationEngine, it applies automatically for all agents that support the sending of emails (Windows, UNIX, SAP, RA, JMX, SQL). The System Overview 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 E-mail")	The AutomationEngine 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 autorization types "JOBS" and "EXTREP").
Script function SEND_MAIL	Mails are exclusively sent via the AutomationEngine.

Send by using

Email connection

Notification object
(type "Email" or "Alarm", "Request", "Message" with the option "Send E-mail")

The AutomationEngine 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 autorization types "JOBS" and "EXTREP").

Script function SEND_MAIL

Mails are exclusively sent via the AutomationEngine.

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.

Configuration

	Configuring the AE E-mail 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.