15th October, 1998

Clarion 4 E-Mail Example for Catalyst Socket Tools (Library Edition)
--------------------------------------------------------------------

Developed using Clarion 4 (legacy Templates) and Catalyst SocketTools 
version 2.2 - if you are using 2.15 then switch the MIME library 
prototypes in "Inside the Global Map". 
 
32 bit Libs are supplied for the SocketTools POP3, SMTP, UUCode and 
MIME DLL's. If you are using 2.15 you'll also need to create a 
new lib file from the 2.15 CSMSGL32.DLL file to replace the existing 
CSMSG32.LIB. 
         
The project settings are for 32-bit standalone. If you want to compile
in 16-bit you must create the required LIB files from the 16-bit 
SocketTools DLL's.

The program has an Inbox and Outbox sharing a common
Mailbox.TPS file. With the Outbox open you can compose and send 
new mail. With the Inbox open you can receive and reply to new mail.

The program POP3/SMTP setup values are stored in the .ini file.

Limitations to outgoing messages are 1 recipient, multiple cc:'s 
(not tested extensively) and 1 attachment in MIME or UUEncoded format. 
Messages (the text component) are limited to 32k - you can, of 
course, increase the size of the text field. This does not affect 
outgoing attachments but, as it stands, the 32k "body" must accommodate 
the incoming message and leave enough over to start receiving an 
attachment.

Attachments can be received in MIME or UUEncoded format. But only 
ONE incoming attachment per message.

The Stop button only serves to stop between messages. Error checking 
exists, but is not extensive.

I've started testing the MIME library in a separate modules - most of 
the functions required to manipulate incoming and outgoing messages are 
included. The "In" module requires messages to be saved to disk - toggle 
the "File|Incoming Mail to File" switch ON to save incoming messages to 
the current directory in a Msgnnnnn.txt format.

The app is an update of the earlier OCX example (cwstmail) which was, in
turn, based VB examples included with the SocketTools Visual Edition.

E&OE

--
Marshall Reeve
Johannesburg, South Africa
mreeve@iafrica.com
