Siemens SIMATIC NET CP 243-1, Operating Instructions Manual

Page: 99 / 142

Programming
4.4 ETHx_EMAIL
CP 243-1
Operating Instructions, 03/2012, C79000-G8976-C244-02
99
Return parameters
Name Type Meaning
Done BOOL Status of the subroutine call
0: Subroutine not executed yet
1: Subroutine executed, read/write
request completed, subroutine ready
for next execution
Error BYTE Error code
16#00: No error occurred
Otherwise: Error (description: refer to
Error messages of the CP 243-1
(Page 108))
Return parameters (ETHx_XFR)
NOTICE
The execution time of an S7-200 user program has a direct effect on the duration of the
read/write requests used in it.
If you want to minimize the execution time of your read/write requests, try to keep the cycle
time of your user program as short as possible.
4.4 ETHx_EMAIL
Calling the subroutine ETHx_EMAIL causes the CP 243-1 to transfer a predefined e-mail to
an e-mail server. Both the e-mail to be transmitted and the e-mail server to be used are
specified in the configuration of the CP 243-1.
A total of up to 32 different e-mails can be configured.
The following is therefore already specified during configuration:
●
Which e-mail server will be used
● Which data from the S7-200 system, in addition to the actual e-mail text, will be
embedded in the e-mail.
● Who will receive the e-mail.
When you call the subroutine ETHx_EMAIL, you specify which of the configured e-mails will
be sent by the subroutine.
The ETHx_EMAIL subroutine is created by the Internet wizard in STEP 7 Micro/WIN 32 if
you activated the e-mail service while configuring the CP 243-1. Only then can you send e-
mails via the CP 243-1 from an S7-200 user program.