Teleservice communication (SMTP email)
13.1 TM_Mail (Send email) instruction
Parameter and type
FROM
SFC_STATUS
The values of these parameters are not modified at every call of TM_MAIL. The values are assigned in the TM_MAIL
1
instance data block and are only referenced once, on the first call of TM_MAIL.
SMTP authentication
TM_MAIL supports the SMTP AUTH LOGIN authentication method. For information on this
authentication method, please refer to the manual of the mail server or the website of your
internet service provider.
The AUTH LOGIN authentication method uses the TM_MAIL USERNAME and PASSWORD
parameters to connect with the mail server. The user name and password must be
previously set up on an email account at an email server.
If no value is assigned for the USERNAME parameter, then the AUTH LOGIN authentication
method is not used and the email is sent without authentication.
TO_S:, CC:, and FROM: parameters
The parameters TO_S:, CC: and FROM: are strings, as shown in the following examples:
TO: <wenna@mydomain.com>, <ruby@mydomain.com>,
CC: <admin@mydomain.com>, <judy@mydomain.com>,
FROM: <admin@mydomain.com>
The following rules must be used when entering these character strings:
● The characters "TO:", "CC:" and "FROM:" must be entered, including the colon character.
● A space character and an opening angle bracket "<" must precede each address. For
example, there must be a space character between "TO:" and <email address>.
● A closing angle bracket ">" must be entered after each address.
● A comma character "," must be entered after each email address for the TO_S: and CC:
addresses. For example, the comma after the single email address is required in "TO:
<email address>,".
● Only one email address may be used for the FROM: entry, with no comma at the end.
Because of run-time mode and memory usage, a syntax check is not performed on the
TM_MAIL TO_S:, CC: and FROM: data. If the format rules above are not followed exactly.
The SMTP email server transaction will fail.
778
Data types
Static
String
1
Static
Word
1
Description
Sender address: STRING with a maximum length of 240
characters
Execution condition code of the called communication
blocks
System Manual, 03/2014, A5E02486680-AG
S7-1200 Programmable controller