©1996 Vincent Debierre
7 april 1997

http://members.aol.com/VinceDeb
Email : VinceDeb@aol.com

TransAOL is a PC based application to be used with the Pilot from US Robotics and America Online.

It allows you to send the Email written on the Pilot, and to download any messages you received through AOL. In fact, you can download any of the messages stored in your Personnal Filing Cabinet ; Email as well as Newsgroups messages.
It has been tested with America Online V3.0 and V2.5, US and international version.

TransAOL is compatible with the Pilot based application "Email" from StingerSoft (http://198.70.114.128/stinger/stingersoft.cfm)
I suggest you backup your "organize" directory, before using this program.

The unregistred version of this program will ramdomly put "TransAOL --unregistred--" instead of the body of the message.

System requirements:

• Visual Basic 3.0 Runtime Library : vbrun300.dll
• Cmdialog.vbx ; Commdlg.dll ; Threed.vbx ; Msoutlin.vbx (available on my site)
• Microsoft Windows 3.1 or NT or 95
• An America Online account
• A Pilot from US Robotics

Included files :

• TransAOL.exe : Windows executable file
• TransAOL.htm : This html file

Setup :

On the first start, the program will launch the Setup window. Set the correct AOL and Pilot directories. Then choose the AOL user name you want to use. Click on Save. You will then have to choose in the combo boxes a Pilot User Name and the categories you want TransAOL to operate in.

Instructions :

You can use TransAOL in automatic or manual mode.

• In manual, select the user name and categories you want to use for this session, select the messages you want to transfer in the Pilot Memopad and press the "Mail" button/icon.
• In automatic, set the "Automatic Transfer" in the setup window and let the program do the rest. At the selected time, TransAOL will update the selected PFC folder (you will need to set the "Load unread messages on start-up" option) and will start a transfer.

A - Main interface

This interface has 3 main parts :

1. Your PFC (Personnal Filing Cabinet),
2. The messages selection side (right side),
3. The Main controls - Pilot settings

1- Your PFC :

Main PFC list : this list shows all the folders of your AOL Personnal Filing Cabinet. Click on a plus sign to open a branch, click on a folder name to select a folder.

"Show subfolders messages" button : when you click it, the program will list all the messages included in the selected folder and in all its subfolders. The button will be rename as "Hide subfolders messages", to go back to the previous state.

"v" button : use this button to enlarge the PFC window. Click on the same button (changed to "^") to reduce it.

When the program exits, the opened folder is saved and will be reopen at the next start-up.

2- The messages selection side (right side)

2 lists : one containing the opened folder messages and the other one containing all the messages to be imported to the Pilot ("Pilot Inbox"),
Double click on a message to view it. Use the button below the list to select the messages.

Use the Arrow icons to include or remove messages to or from the "Pilot Inbox" (messages to be sent to the pilot memopad)

Press the "Speedy Enveloppe" button to start the transfer.

Press the "Update" button to update your PFC file (in case you made some change in AOL while this program was running)

Press the "Setup" button to configure TransAOL.

HotSync button :You have probably noticed that after a HotSync the memos are not in the order they have been entered. To avoid this, the Hotsync should be set to "Desktop overwrites Pilot". This is the purpose of this button. But the program can't handle it if you have never customized the HotSync in the "Pilot Desktop" by yourself (one time is enough). The program will prompt you to if you try to use this option without having done the above procedure.
BE AWARE : when HotSync is set as "PC overwrites Pilot", all changes made on the Pilot (memopad) since the last HotSync will be lost ;so synchronize your Pilot if necessary.
If you click the button another time, the HotSync will be set back to "Synchronization". TransAOL will automaticaly set it back to "Synchronization" before leaving the program.

3 - Main controls - Pilot settings

Main controls : Select the categories you want the Pilot to interact with. The "Sent Mail" category is disabled as long as the "Move sent mail" option is unchecked.

Pilot setting : you will find here some of the options described in the "options" section of this file.


B - Format of an outgoing message written on the Pilot :

Begin a memo with the headers which are "To:", "Cc:" and "Sub:" or "Subject:" (case doesn't matter). Then leave a empty line, and write the text of your message.

The header "To:" is the only one mandatory. Insert 2 carriage return before begining the body of the message.

The headers "A:", "Sujet:", "An:", "Kopie:" and "Thema:" also work (for international users).

Examples :

=========================================
To: VinceDeb@aol.com
cc: Someone@somewhere.com,support@usr.com
Sub: TransAOL released

TransAOL is a PC based application
to be used with the Pilot from US
Robotics and America Online...

OR=======================================
To: Nobody@aol.com

Who the hell are you?
=========================================

Options :

Main options:

• "Send only" : By default, the program downloads and sends the Email during a session. If you just want to send and not to receive any incoming email, check this option.
• "Receive only" : Check this option, if you want to receive the incoming email and not to send any email.

Before Transfer:

• "Purge InBox category" : Checking this option will allow TransAOL to delete all the memos in the selected "InBox" category before the transfer.

After Transfer :

• "Mark AOL messages" : By default, TransAOL doesn't mark the incoming email in the AOL incoming flashmail folder after the transfer. By checking this option, TransAOL will mark all the downloaded Email. Check this option to avoid duplicate entry.
• "Delete sent mail" : When this option is checked the messages on the Pilot are deleted after being sent.
• "Move sent mail" : When this option is checked the messages on the Pilot are moved to the selected "Sent Mail" category after being sent.

Setup window additional options :

• "Automatic Transfer" : Check this option to enable automatic transfer. It is build to be used with the AOL FlashSession.
  Then select between the 3 automatic transfer options :
  
  First option- Enter the time you want the program to start an automatic transfer. Use 24 hours format.(e.g. 13:00 )
  Second option- The program will start an automatic transfer every half hour (at 15 and 45 minutes of every hour)
  Third option- The program will start an automatic transfer every hour (at 15 minutes)
• "Load unread messages on start-up" : When TransAOL is started up, it automaticaly add to the "Pilot Inbox" list all the unread messages of the folder opened when you last quit the program.
• "Signature" : Insert here the signature to be inserted at the end of each outgoing PilotEmail. (1000 characters)

Notes :

• To back-up your aol files, copy the aol "organize" directory. To backup your Pilot files, copy the "memopad.dat" file
  
• The incoming messages may optionaly be marked in the incoming FlashMail folder, but TransAOL can't delete them.
  
• To send your email through AOL, you must start the America Online program after the Email has been transfered using TransAOL OR if the America Online program is running, after the transfer, select the "guest" screen name (or any other but yours) and go back to your screen name. This is a way to force America Online to refresh its file.
  
• To receive your Email correctly, the PilotDesktop program must not be running (or it must be set to another user name).

Disclaimer :

You are granted the right to use and to make an unlimited number of copies of the SHAREWARE version of this software. You may not disassemble, decompose, reverse engineer, or alter any of the files in the package.

This software is provided as SHAREWARE and cannot be sold. This restriction does not apply to connect time charges, or flat rate connection/download fees for electronic bulletin board services. This software can not be bundled with any commercial package or distributed by itself or accompanying books or magazines without express written permission from the author.

The author of this program accepts no responsibility for damages resulting from the use of this product and makes no warranty or representation, either express or implied, including but not limited to, any implied warranty of merchantability or fitness for a particular purpose. This software is provided "AS IS", and you, its user, assume all risks when using it.

America Online and US Robotics didn't take part in the developpement of this software.
America Online and US Robotics do NOT support this software.

Registration :

To register this software and to be able to use all its features, send by mail your name, your Email address, the name and version of this program, the Pilot User Name you are using and US $10 cash or 50 french francs to :

Vincent Debierre
12 chemin de la saussaie
77123 Noisy sur Ecole
France

You will receive the registered code of this software via your Email address.
You'll also get all the upgrade for a year at no charge.

Revision information:

V2.1   : Automatic transfer options added

V2.0f  : Graphical and "automatic transfer" problems solved

V2.0a  : Windows position saved on exit
         AOL user bug in the setup window corrected

V2.0   : Features added : - New window design
                          - Download any messages from AOL
                          - Multiple selection options
                          - Signature on outgoing Emails
                          - And a lot more...

V1.01  : Minor bugs corrected. Compatible with Email from StingerSoft.
         The "To:" field needs not to be in the first line anymore.

V1.0   : "Move sent email" and "Purge inbox category" options added.
         Bug when destination address less than 10 characters corrected.
         Minor bugs corrected.

Beta 3 : Messages with file attached are handled correctly.
         No more "ghost" marked messages.

Beta 2 : Bug in the OutBox list when selecting another user name corrected.
         Addition of a message box when the aol file isn't valid.

Beta 1 : Original release