w3 JMail v 4.5
Table of Contents :
Preface............................................................................................................ 3
What’s New ? ................................................................................................. 4
Installation..................................................................................................... 5
Uninstall.......................................................................................................... 5
Enqueue and MS Pickup Directory ................................................................ 6
Enabling PGP Encryption with w3 JMail ........................................................ 7
Getting started.............................................................................................. 8
Sending e-mails with w3 JMail ...................................................................... 8
Receiving e-mails with w3 JMail ................................................................... 9
Encrypting e-mails with w3 JMail.................................................................. 11
Massmailing e-mails with w3 JMail .............................................................. 12
Object reference........................................................................................... 13
JMail.POP3 ................................................................................................... 14
JMail.Messages ............................................................................................ 17
JMail.Message ............................................................................................. 18
JMail.Headers .............................................................................................. 29
JMail.Recipients ........................................................................................... 30
JMail.Recipient ............................................................................................. 31
JMail.Attachments ........................................................................................ 32
JMail.Attachment .......................................................................................... 33
JMail.MailMerge ........................................................................................... 35
JMail.PGPKeys ............................................................................................ 37
JMail.PGPKeyInfo ........................................................................................ 38
JMail.SpeedMailer ....................................................................................... 39
JMail.PGPDecodeResults ........................................................................... 40
JMail.PGPDecodeResult ............................................................................ 41
JMail.PGPDecodeResultCollection ............................................................ 42
MailMergeResultCollection ........................................................................ 43
MailMergeResult ........................................................................................ 44
Appendix: w3 JMail Registry Settings ........................................................ 45
Software License Agreement ..................................................................... 47
www.Dimac.net Page: 2
w3 JMail v 4.5
The world’s most popular e-mail component!
Dimac’s w3 JMail is being used by 900.000+ programmers worldwide. w3 JMail is
based on COM technology and can therefore be called from most modern
programming languages, though it has most of its users in the ASP platform.
We are proud to present the latest version of w3 JMail, which now features sending e-
mails, receiving e-mails, encryption and mass mailing with mailmerge. We believe we
have made the best e-mail component even better. We have taken all the input you
have given us (and that’s a lot!) and most of it has been implemented in this new
version, in fact we added some more stuff we thought was really cool.
What can you do with w3 JMail? A lot we say! The first thing you want to do is to add
some outgoing e-mail notifications from your web pages, then move on to creating
your own hotmail version using the brand new POP3 feature in w3 JMail. Securing
your e-mails with PGP is a natural step into a safer communication and with the
mailmerge function of w3 JMail you will be able to send newsletters to your
customers without investing in expensive list servers. All in all, w3 JMail will give
you new possibilities to create web applications which will rock!
Now, run the installation (which you probably already have done) and get acquainted
with the world’s most popular e-mail component!
Dimac Development AB Phone: +46 42 35 94 00
Prästgatan 12 Fax: +46 42 15 80 50
252 24 Helsingborg Homepage:
http://www.Dimac.net
Sweden E-mail: info@dimac.net
Support: support@dimac.net
www.Dimac.net Page: 3
w3 JMail v 4.5
What’s new in v 4.5 ?
- Added better support for unicode charsets.
-
Added a new property CID to the JMail.Attachment object.
-
Added better logging to MailMerge. It now logs mail that caused an error.
- F
ixed parsing of names (sender and recipients) when using POP3.
-
Removed the X-MSMail-Proirity header.
New in v 4.4:
- Some issues regarding incorrect handling of attachments in POP3 were fixed.
- An issue which sometimes generated an error when iterating multiple attachments
were fixed.
- The property "NoAutoContentID" was added to the message object. If set to true, no
Content-ID header will be generated for regular attachments. For inline attachments,
the header is still set. This can be used to solve some attachment problems occuring
with certain email-clients. The default value is false.
New in v 4.3:
Dimac’s w3 JMail 4.3 features a rewritten core and truckload of new features, for
example:
-The inner architecture of w3 JMail has been redesigned. E-mails are now sent using
the Message Object. Instead of just one object (jmail.smtpmail) we now have more
than 10 (!). For most of us jmail.message will do the trick. Note that despite all this,
w3 JMail 4 is 100% backwards compatible.
- Support for receiving e-mails from POP3 mail servers.
-You can make massive bulkmailings to thousands of thousands of recipients using
w3 JMails enque functions. To make it even snazzier, you can personalize each e-
mail with the mailmerge object.
-Encryption of your e-mails using the most popular encryption method, PGP
Encryption.
-Speedmailer, to send e-mails with just one function call.
So read on, get acquainted with the market’s most popular e-mail component;
Dimac’s w3 JMail.
www.Dimac.net Page: 4
w3 JMail v 4.5
Installation
To use Dimac’s w3 JMail you must have the jmail.dll registered at your web server. This is
done by either running the installation program or by copying the jmail.dll file to your web
server and manually registering it with the command regsvr32 jmail.dll. Any previous
installations of w3 JMail must first be removed, as described below. To run the installation you
must have administrator permissions on the web server.
Double click the w3JMail.msi file to run the installation program. The installation will by default
install at C:\Program Files\Dimac\w3JMail\ together with this manual and some example files.
More example files are viewed at our web site at http://www.dimac.net. The installation will
register the jmail.dll file as a COM object.
Uninstall
Uninstall is available in the Add/Remove Programs in your settings folder. You can also do
this manually by unregistering the jmail.dll component (type regsvr32 /U jmail.dll) and deleting
the files.
www.Dimac.net Page: 5