Automationdirect.com DirectLOGIC DL205 Series User Manual page 497

Chapter 5: Intelligent Box (IBox) Instructions
ECOM100 Send E-mail (ECEMAIL) (IB-711)
1
ECOM100 Send EMail, on a leading edge transition, will behave as an EMail client and send
an SMTP request to your SMTP Server to send the EMail message to the EMail addresses in
the To: field and also to those listed in the Cc: list
2
230
hard coded in the ECOM100. It will send the SMTP
240
request based on the specified ECOM100#, which
250-1
3
corresponds to a specific unique ECOM100
260
Configuration (ECOM100) at the top of your
program.
4
DS5 Used
The Body: field supports what the PRINT and
N/A
HPP
VPRINT instructions support for text and embedded
5
variables, allowing you to embed real-time data in
your EMail (e.g. "V2000 = " V2000:B).
6
The Workspace parameter is an internal, private register used by this IBox and MUST BE
UNIQUE in this one instruction and MUST NOT be used anywhere else in your program.
7
Either the Success or Error bit parameter will turn on once the request is complete. If there is
an error, the Error Code parameter will report an ECOM100 error code (less than 100), an
8
SMPT protocol error (between 100 and 999), or a PLC logic error (greater than 1000).
Since the ECOM100 is only an EMail Client and requires access to an SMTP Server, you
MUST have the SMTP parameters configured properly in the ECOM100 via the
9
ECOM100's Home Page and/or the EMail Setup instruction (ECEMSUP). To get to the
ECOM100's Home Page, use your favorite Internet browser and browse to the ECOM100's
10
IP Address, e.g. http://192.168.12.86
You are limited to approximately 100 characters of message data for the entire instruction,
11
including the To: Subject: and Body: fields. To save space, the ECOM100 supports a hard
coded list of EMail addresses for the Carbon Copy field (cc:) so that you can configure those
IN the ECOM100, and keep the To: field small (or even empty), to leave more room for the
12
Subject: and Body: fields.
In order for this ECOM100 IBox to function, you must turn ON dip switch 7 on the
13
ECOM100 circuit board.
ECEMAIL Parameters
14
• ECOM100#: this is a logical number associated with this specific ECOM100 module in the
specified slot. All other ECxxxx IBoxes that need to reference this ECOM100 module must
A
reference this logical number
• Workspace: specifies a V-memory location that will be used by the instruction
B
• Success: specifies a bit that will turn on once the request is completed successfully
• Error: specifies a bit that will turn on if the instruction is not successfully completed
C
• Error Code: specifies the location where the Error Code will be written
• To: specifies an E-mail address that the message will be sent to
D
• Subject: subject of the e-mail message
• Body: supports what the PRINT and VPRINT instructions support for text and embedded
variables, allowing you to embed real-time data in the EMail message
5–280
DL205 User Manual, 4th Edition, Rev. B