Skip to main content
Previous section

Settings for the Email Outbound Adapter

Provides reference information for settings of the settings outbound adapter.


The outbound email adapter has the following settings:

Group Settings
Basic Settings SMTP Server, SMTP Port, Credentials
Connection Settings SSL Configuration, SSL Check Server Identity
Additional Settings Recipient, Cc, Bcc, From, ContinueIfInvalidRecipient

The remaining settings are common to all business services. For information, see “Settings for All Business Services” in Configuring Productions.


Specifies a comma-separated list of email addresses to add to the Bcc: list of each mail message sent.


Specifies a comma-separated list of email addresses to add to the Cc: list of each mail message sent.


If selected, the adapter continues to send the message if one or more of the recipients have an invalid address.


The ID of the production credentials that can authorize a connection to the given server. For information on creating production credentials, see Configuring Productions.


The default From: address to put in mail messages. May be overridden by the business operation implementation code.


Specifies a comma-separated list of email addresses to add to the To: list of each mail message sent.


The port on the SMTP server to send mail to. The default value is 25.

SMTP Server

The IP address of the SMTP server to send mail to. (Note: the timeouts for connecting and sending mail can be more than 10 minutes).

SSL Configuration

The name of an existing SSL/TLS configuration to use to authenticate this connection. Choose a client SSL/TLS configuration, because the adapter initiates the communication.

To create and manage SSL/TLS configurations, use the Management Portal. See the chapter “Using SSL/TLS with InterSystems IRIS” in the Security Administration Guide. The first field on the Edit SSL/TLS Configuration form is Configuration Name. Use this string as the value for the SSLConfig setting.

Generally, when you specify a value for this setting, outbound email opens a socket on default port 465 and uses SMTP over SSL/TLS. However, the SSL Config setting also supports the server interaction described in the RFC3207 standard. Specifically, you can enable the system to initiate the connection by opening a standard TCP socket and then switching to an SSL/TLS connection on the same port. The system achieves the switch by issuing the issue the STARTTLS command. To enable this special type of connection, you include an asterisk at the end of the SSL Config value. For example, if your TLS Configuration Name is MySSLItem, you specify MySSLItem* as the SSLConfig value. The default SMTP port in this case is 25.

For further information, see the description of the SSLConfig property in the Class Reference entry for EnsLib.EMail.OutboundAdapter.

SSL Check Server Identity

When connecting to a POP3 or SMTP server via SSL/TLS, the server name in the certificate must match the DNS name used to connect to the server. This match is based on the rules in section 3.1 of RFC 2818.