PilotMail MAPI BETA 3 ===================== PilotMail is a MAPI mail client for US Robotics / Palm Computing Pilot handheld computer. PilotMail is _not_ a PalmOS application, but a Windows 95 application that downloads mail to the Pilot memopad database. New mail will be available on the Pilot after the next HotSync. Try it out and send your comments to Fredrik Thunved PilotMail MAPI BETA is free, but the application will be shareware when released, with a $50 registration fee. All PilotMail BETAs will expire 1996-10-01. IMPORTANT: this is BETA software. Make a backup of your Memopad database file before using PilotMail. Use at your own risk!!!!! Revision History: ================= -- Version BETA 3 1996-09-24 -- New features: - Support for messages larger than 4k. Messages larger than 4k are divided into several memos, with the first line duplicated in every message part. The maximum size to download is user-configurable, up to 400kB (100 memos, I number the memos [00] - [99]). Fixed bugs: - A bug in the version of OLE Messaging library (4.0) included in the BETA 1 and 2 installation prevented the text of large messages to be accessed, causing only the headers to be downloaded to the Pilot. The BETA 3 includes a newer version (version 4.00.837.0) of MDISP32.EXE/REG/TLB that doesn't have this bug. -- Version BETA 2 1996-09-22 -- New features: - Added [Command] to install PalmOS applications remotely (InstallApp: ) - Added "Hide HotSync Manager" option Fixed bugs: - Improved error handling - ConversationTopic/Index in selected headers causes error on deliver -- Version BETA 1 1996-09-16 -- New features: - Original release Fixed bugs: - Original release Features: ========= - Windows Messaging (MAPI) send and retrieve to Pilot - Support through MAPI for internal mail systems like FirstClass, MS Mail, Exchange, cc:Mail (with third party software), Internet and CompuServe email, fax (if using Caere OmniPage Pro you can even get the message text downloaded to your Pilot remotely!), and any other mail system with MAPI support. - User-configurable downloading of MAPI messages - Optional "Private" flag on downloaded mail - Command-line options for automated downloading of mail - Commands for controlling PilotMail from your Pilot - Disable/enable HotSync on deliver - Semi-automatic configuration from Registry settings - Message headers with date (MMDD), importance, receipt options, encryption/signature information, and sender. The header is designed to sort well in the Memo List (use SuperPad or MemoSort). The header format is: MMDDIRCFrom MMDD: Month and date sent I: Importance [!] = High [:] = Normal [·] = Low R: Delivery and read receipts [ ] = No receipts requested [.] = Delivery only [·] = Read only [:] = Delivery and read C: Signed and encrypted? [ ] = Not signed or encrypted [.] = Signed only [·] = Encrypted only [:] = Signed and encrypted From: Sender address Requirements: ============= - Windows 95 - Windows Messaging (MAPI) installed (i.e. Exchange Inbox) Known bugs and limitations (several, this is BETA software folks!): =================================================================== - Limited error handling. The memopad transactions are fairly well protected and debugged, but to be on the safe side: PLEASE BACKUP YOUR MEMOPAD DATABASE BEFORE USING THIS APPLICATION!!! Installation: ============= 1: Download PilMailA.ZIP and unzip to a temporary directory 2: run setup.exe 3: run and configure PilotMail. This is very important, as you will not be able to download mail until all settings are correct. Remember to click "Apply" after entering your settings 4: Click "Deliver" to start the mail retrieve/send 5: HotSync when finished or, if using the minimum installation file (please note that you must have the VB 4.0 32-bit runtime files installed to us this): 1: Download PilMailB.ZIP and unzip to a temporary directory 2: run install.bat with the application install directory as the only parameter, i.e. "install.bat C:\PilotMail". Create a Start menu shortcut to PilMail.exe. 3-5: as above Configuration: ============== User tab: --------- - Name: Pilot user name. The registered version will only work with one Pilot user name. This will limit the use to one person, while allowing installation and use on several PCs. - Password: MAPI password - MAPI Profile: this is set to the default MAPI profile on first run, but you can change it later to any profile. At the moment, PilotMail does not support multiple users and/or profiles, - Disable HotSync Manager on Deliver: if set, shuts down and restarts HotSync Manager when delivering mail (please make sure that the HotSync warning message is turned off). - Hide HotSync Manager: if "Disable HotSync Manager on Deliver" is set, this options hides the HotSync Manager after restart. - Include read mail in download: if set, downloads all mail, read and unread, since last download. Memopad Tab: ------------ - Filename: the filename of your memopad database, usually: \\memopad\memopad.dat the [...] button lets you browse and select the file - Inbox: category for new messages - Outbox: category for outgoing messages - Sent mail: category to which Outbox contents is moved after sending Inbox, Outbox, and Sent mail are configured via the "Categories" button, which shows all categories in the current memopad file. Please configure "Filename" before clicking "Categories", the error handling is limited... - Max msg size: Maximum size to download from messages. If you set this option to 4 kB, all messages will be truncated to fit in one memo. If you enter a larger number, messages larger than 4k will be divided into several memos, with the first line duplicated in every message part. The maximum size to download is 400kB (100 memos, I number the memos [00] - [99]). - Download [..] Private: sets Private flag on Inbox and Sent mail memos Message Tab: ----------------- This tab lets you configure which MAPI information that should be downloaded, and in what order. To specify the actual message text, you _must_ have the entry "[Message]" in the list. - Up, Down: moves "Selected" headers up/down - Left, Right: moves headers between "Available" and "Selected" lists Command-line options: ===================== "-d" or "/d": Start mail delivery on start-up "-q" or "/q/: Quit when finished downloading mail Outgoing messages format: ========================= The format is very simple: Begin the memo with all the headers you want to include (i.e. "To", "Subject", etc). The message _must_ include a "To" header, "From" is generated automatically by MAPI. After the headers, leave a blank line, after which you write the actual message text. Example of outgoing email message from Pilot: ==================BEGIN EXAMPLE============================ To: pilot@straylight.connectnet.com Subject: ANN: PilotMail Version 1.0 Cc: pilot@inforamp.net; srandress@telis.org Hello! This is a message sent from the Pilot handheld computer, with the help of PilotMail, a shareware POP3/SMTP email client for Windows 95. Enjoy! ===================END EXAMPLE============================= The message will be placed in the "sent mail" category after sending, complete with time sent and any error messages. The available headers that will be interpreted by PilotMail are: - To, Cc, Bcc: adds the recipient(s) to the corresponding list Addresses are separated by ";". The MAPI address format is very flexible, and the addresses will be automatically resolved at delivery. Some of the most common types are: - Internet addresses: specify as normal (user@domain) or in MAPI syntax "Joe Smith [SMTP: user@domain]" or "[SMTP: user@domain]" - Fax numbers: specify as "Joe Smith [FAX: (123)456-7890]" or "[FAX: (123)456-7890]" - Addresses in MAPI address book: specify name ("Joe Smith") - Subject - DeliveryReceipt, ReadReceipt, Signed, Encrypted: Yes/True, No/False accepted - ConversationTopic - ConversationIndex: PilotMail adds a new timestamp at the end of this string according to Exchange convention. I have not tested this as I don't have access to a Exchange Server system. [Command] format: ================= If you create a message in the Outbox category with [Command] as the first line, the message will be used by PilotMail to set different options in the application. The available options are: - InstallApp: installs a PalmOS application or database on the Pilot Please note that it is not possible to select user at the moment, the file will be installed to the current default user if there are more than one user defined in Pilot Desktop. - Format: sets the download format. Use a string of "0" - "B" to specify the message format. Do not use any other characters in this string, and no embedded spaces. The available headers are: 0 = "[Header]" 1 = "From" 2 = "To" 3 = "Cc" 4 = "Bcc" 5 = "TimeSent" 6 = "TimeReceived" 7 = "Subject" 8 = "[Message]" 9 = "[Attachments]" A = "ConversationTopic" B = "ConversationIndex" - TimeReceived: change the start date for download. PilotMail tracks the date and time of last download. This command lets you download all mail from a given date. - DownloadReadMail: Sets the flag to download read mail or not. Example: to change the download format to Header, TimeSent, Subject, and message text, and to download all mail received after September 1, 1996, and to install Klondike 1.1 (unregistered version, support your local shareware author and REGISTER your software!), create a memo in the Outbox category with the following information: ==================BEGIN EXAMPLE============================ [Command] Format: 0578 TimeReceived: September 1, 1996 DownloadReadMail: Yes InstallApp: C:\Program\Pilot\add-on\Games\Klond11U.prc ===================END EXAMPLE=============================