RSS

Email Facility

A 'command line' emailer is available (free of charge to RTES users). The command line may be executed by RTES as EXT function, thus integrating it with an application. You may download email.exe here.

The email facility references a text line that may be crated dynamically with RTES (DOC / PRINT) just like a report, thus making the content of the email dynamic.

Some applications of this emailing facility are Alarm annunciation, Periodic status report, Archiving of events, Production reports.

To use the emailing facility, you must have make accessible to RTES32 the program (email.exe). The easiest way is to copy it to the RTES32 default directory, where OLEX*.RTES is located. Email.exe use a configuration file named email.ini, that must be also be in that same directory.

Create email.ini.
Using notepad, create a file containing the following - replacing the information within quote marks with your own, without the quote marks:
[SMTP] SERVER="my SMTP server name or ip address" AUTH="0 if authentication is not required (default), 1 if authentication is required" USERID="user id for authentication - not used if AUTH=0" PASSWORD="password for authentication - not used if AUTH=0" PORT="smtp port - the default is 25" [LOGS] FILE="path name of a file that will log the activities of email.exe" ACTIVE="0 if logging is not required (default), 1 if logging is required"

Below is an example of email.ini using a server on port 25 without authentication and with logging enabled:
[SMTP] SERVER=mail.organisation.central.com [LOGS] FILE=emails.log ACTIVE=1

Once email.ini is done, you may use email.exe to send and email that is contained in a file. The file must follow a certain format, that provides to email.exe the recipient and sender. Below is what a typical file looks like:
MAIL FROM: <fai@rt-sys.com> RCPT TO: <frank@rt-sys.com> DATA Message-id: <automated-email-notice> From: "RTES32" (optional) To: "Office" (optional) Subject: This is a sample (optional) Content-Type: text/plain (optional) (note: Some servers require a blank line here) Hourly report : Pressure 2340kPa Temperature 60C

To send this email, save the above text in a file named "hourly.txt" (for instance) and you may open a command prompt window, change the direcory to the one containing the file and enter the command line : email hourly.txt

You may also send this email through a EXT function in RTES32. Here is an example of how you do that:
Create two consecutive variables named EMAIL and HOURLY
Define a function EXT EMAIL=HOURLY (this is like defining a RULE, but with EXT instead of RULE)
Enter in the Message area of HOURLY : email hourly.txt

When you set HOURLY to 1, EMAIL changes to 1 as well and the EXT associated with it execute the text that is 1 line down as an EXTernal command line (just as if you entered it at the command prompt).

See the example here to create hourly.txt dynamically.