Automationdirect.com DL05 User Manual page 314

Chapter 5: Standard RLL Instructions
ECOM100 Send E-mail (ECEMAIL) (IB-711)
1 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
DS5 Used
the To: field and also to those listed in the Cc: list hard coded in the ECOM100. It will send
N/A
HPP
2 2
the SMTP request based on the specified ECOM100#, which corresponds to a specific unique
ECOM100 Configuration (ECOM100) at the top of
3 3
your program.
The Body: field supports what the PRINT and VPRINT
4 4
instructions support for text and embedded variables,
allowing you to embed real-time data in your EMail (e.g.
"V2000 = " V2000:B).
5 5
The Workspace parameter is an internal, private register
used by this IBox and MUST BE UNIQUE in this one
6 6
instruction and MUST NOT be used anywhere else in
your program.
7 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 SMPT
protocol error (between 100 and 999), or a PLC logic error (greater than 1000).
8 8
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 ECOM100's
9 9
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 IP Address, e.g.
10 10
http://192.168.12.86
You are limited to approximately 100 characters of message data for the entire instruction,
11 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 12
Subject: and Body: fields.
In order for this ECOM100 IBox to function, you must turn ON dip switch 7 on the
13 13
ECOM100 circuit board.
ECEMAIL Parameters
14 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 reference this
a A
logical number
• Workspace: specifies a V-memory location that will be used by the instruction
b 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 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 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-168 DL05 Micro PLC User Manual, 6th Edition, Rev. D