CLEMAIL by Sureshot – FAQ

CLEMAIL by Sureshot – FAQ

If you can’t find the requested information, please consult the manual. It may have the required information.

Frequently Asked Questions

1. What is the difference between the registered and the demo version?
2. I’m using Windows 95 and get the error message “Could not find the DLL WS2_32.dll”. What should I do?
3. Can CLEMAIL integrate more closely with email systems installed i.e. add sent e-mails into the sent folder?
4. Can CLEMAIL read emails from a POP server?
5. Can CLEMAIL send mails to multiple recipients?
6. How can I send a body in HTML?
7. How can I set up a Yahoo mail account for CLEMAIL?
8. I would like to integrate CLEMAIL with my web page. Is that possible?
9. I would like to integrate CLEMAIL with an application. How can I know if the mail is successfully sent?
10. Why does my IP number show up in the end of the email?
11. I would like to integrate CLEMAIL in our application. What is the policy?
12. Is there a way to change the message that CLEMAIL sends?
13. How can I send a carriage return or a line feed in the email body?
14. When entering the command line, the DOS prompt does not allow more than X characters.
15. I’m calling CLEMAIL from a .bat file. How can I make the .bat file return 0 if the mail is sent and 1 if not?
16. I think I’ve found a bug, what should I do?

1. What is the difference between the registered and the demo version?

The difference between the registered and the demo version is that the latter has a evaluation period of 30 days.

2. I’m using Windows 95 and get the error message “Could not find the DLL WS2_32.dll”. What should I do?

If you get the error message “Could not find the DLL WS2_32.dll”, please download and install Microsoft’s Winsock 2 update for Windows 95

3. Can CLEMAIL integrate more closely with email systems installed i.e. add sent e-mails into the sent folder?

No, CLEMAIL operates directly on the SMTP server. It does not know anything about email clients like Outlook, Eudora, etc.

4. Can CLEMAIL read emails from a POP server?

CLEMAIL can only send emails, it cannot read messages from a POP server.

5. Can CLEMAIL send mails to multiple recipients?

This version of CLEMAIL does not support multiple recipients. The work around is to run CLEMAIL multiple times, one for each recipient. You could for example write a small script that loops over the number of recipients. Another work-around is to use the -hook flag to intercept and change the MIME message that CLEMAIL generates.

6. How can I send a body in HTML?

In order to send a body written in HTML you have to specify the text/html content type. Do that with “-contenttype text/html”

7. How can I set up a Yahoo mail account for CLEMAIL?
—————————————————–
Please go to http://mail.yahoo.com. If you don’t have an account already, please sign up. Do this by pressing the “sign up” link. Choose a username and fill in the required information. After filling in the information, please go to the login page again, http://mail.yahoo.com. If you are prompted for a username and password, please fill in these and log in. Now you should see your inbox.
You have to set up your account for POP access. Yahoo allow you to access the POP server only if they can send you a few advertisement emails. To set up your yahoo account for “Yahoo Delivers” and getting POP access. Click Options->Yahoo! Delivers. Check the Yes checkbox. Click Finished->Sign out.
Now your account is ready to use.

8. I would like to integrate CLEMAIL with my web page. Is that possible?

You can integrate CLEMAIL with your web page, but you need to know a little bit of CGI programming. The CGI program can read and parse the input from a HTML

. Within the CGI program you can call CLEMAIL with the required arguments, for example, the recipient’s address. CGI programs can be written in many languages. For example, C, C++, Java (servlets), ASP, Perl, etc.

9. I would like to integrate CLEMAIL with an application. How can I know if the mail is successfully sent?

When CLEMAIL completes successfully it will return 0. If it fails to send the mail for some reason it will return 1.
You could for example use the WIN32 API function CreateProcess to start CLEMAIL from another application. CLEMAIL will respond “The mail was successfully sent!” if the mail was sent successfully. Otherwise an error message is printed.

10. Why does my IP number show up in the end of the email?

When you send mails from one of the preconfigured accounts, CLEMAIL will append the IP of the sending host. This will protect the preconfigured accounts from spammers.

11. I would like to integrate CLEMAIL in our application. What is the policy?

You can register multiple licenses. Please see our site for the pricing structure.

12. Is there a way to change the message that CLEMAIL send?

You can intercept and change the message that CLEMAIL generates with an executable that you implement. This executable can read the MIME message that CLEMAIL generated from stdin. The executable can now change the message and write the output back to stdout. Clemail will read the output of the executable and use that as the MIME message.

C++ example that replace the word “lower_case” with “UPPER_CASE”:

#include
#include

// Read the MIME message from stdin. Replace the word “lower_case”
// word with the word “UPPER_CASE”. The modified MIME message is
// written on stdout.
int main(unsigned int argc, const char** argv)
{
using namespace std;

const string lower_case(“lower_case”);
const string upper_case(“UPPER_CASE”);

while (true)
{
string s;

//Read a line from the MIME message.
getline(cin, s, ‘\n’);

if (cin.eof())
{
break;
}

string::size_type pos;
if ((pos = s.find(lower_case)) != string::npos)
{
s.replace(pos, lower_case.size(), upper_case);
}

//Output the modified message. CLEMAIL will read
//the output.
cout << s << "\n"; if (cout.fail()) { //Writing failed. Do not send the email. return EXIT_FAILURE; } } //Signal CLEMAIL that the program terminated successfully. return EXIT_SUCCESS; } 13. How can I send a carriage return or a line feed in the email body?

1. Read the body from file, using the -bodyfile flag, or
2. Send the email as a html email, and use
as the linebreak, or
3. Use the -hook flag to change the MIME message before it is sent to the SMTP server, or
4. If you are using PERL or C++ for example. Call the CreateProcess in the WIN32 API to start CLEMAIL.

The following C++ program sends a mail with newline in the body.

#include
#include
#include

int main()
{
using namespace std;

const string commandLine =
“C:\\Program Files\\clemail\\clemail.exe -to [email protected]
“-subject \”The subject\” -body \”The body:\nwith\nnew\nline\n\””;
char commandLineChars[1024];
strcpy(commandLineChars, commandLine.c_str());

STARTUPINFO si;
PROCESS_INFORMATION pi;
memset(&si, 0, sizeof(STARTUPINFO));
memset(&pi, 0, sizeof(PROCESS_INFORMATION));
BOOL ret =
CreateProcess(NULL, commandLineChars, NULL, NULL, FALSE, DETACHED_PROCESS, 0, NULL, &si, &pi);
assert(ret);
return 1;
}

The send email looks like this:

The body:
with
new
line

14. When entering the command line, the DOS prompt does not allow more than X characters, what should I do?

The global command-line character limitation on Windows 95 can be increased to its maximum by placing the following line in the CONFIG.SYS file:
shell=c:\windows\command.com /u:250 /p
This command affects all MS-DOS virtual machines (VMs) as well as the Windows 95 command line.
NOTE: If the SHELL command is already present with the /u switch, increase the value to 250.
For more info, please visit Microsoft Product support.

15. I’m calling CLEMAIL from a .bat file. How can I make the .bat file return 0 if the mail is sent and 1 if not?

In the .bat file you can check the return value of CLEMAIL by using the error level. The .bat file below returns 0 if the mail is sent successfully and 1 if not. The address of the recipient is given as the first argument to the script.

@echo off

“c:\program files\clemail\clemail.exe” -to %1 -subject “test” -body “test”

if errorlevel 1 goto error

echo OK
exit 0

:error
echo ERROR
exit 1

16. I think I’ve found a bug, what should I do?

If you’ve found a bug, please get in touch with us. Please include this in your bug report:
1. The version of the software. Use clemail -help.
2. Information about your platform, that is, the Windows version.
3. The command line you are using.
4. And most important, detailed description of what goes wrong.

Follow Us:

Surf Spy

Surf Spy is an invisible tool that monitors the Internet activity on your computer. It captures the link of every visited web site. Read more >>

Bluescreen Screensaver

Bluescreen Screensaver will simulate the Windows Blue Screen of Death for your operating system. Read more >>

Farsighter

Farsighter monitors a remote computer invisibly by streaming real-time video to a viewer on your computer. Read more >>