SMTP policy

Attach an SMTP policy to one or more EmailOutput nodes in a message flow to control connection details to an SMTP server at run time.

You can configure the EmailOutput node to send an email to a list of recipients. You can also construct a message flow that produces an email where the SMTP server, list of recipients, subject, text, and multiple attachments are all determined at run time. You can use the SMTP server and port property of the EmailOutput node to specify the host name of the SMTP server that the integration server uses to send emails, or to specify an alias that refers to an SMTP policy (see Sending emails).

If you redeploy an SMTP policy, all message flows that are using the policy will be stopped and restarted.

The properties of this policy are described in the following table.
Table 1. Properties of the SMTP policy
Property Property name in .policyxml file Value
SMTP server name smtpServer This mandatory property specifies the name of the SMTP server; for example, host1.

Value type: String

Security identity (DSN) securityIdentity This property specifies the name of the security identity object that is created by the mqsisetdbparms command, which contains the user ID and password to be used by the integration server to authenticate the connection to the SMTP policy. See Security identities for the integration server connecting to external systems.

Value type: String

Enable the use of the STARTTLS command starttlsEnable This property enables the use of the STARTTLS command (if supported by the server) to switch the connection to a TLS-protected connection before issuing any login commands. If the server does not support STARTTLS, the connection continues without the use of TLS. The default value is false.

Value type: Boolean

Requires the use of the STARTTLS command starttlsRequired This property specifies that use of the STARTTLS command is required. If the server does not support the STARTTLS command, or if the command fails, the connect method fails. The default value is false.

Value type: Boolean