TRANSFERRING PEGASUS EMAIL INTO AGENT

Transferring your Pegasus email into Agent is a 2-step process.  
First, you convert your Pegasus email into a DOS file.  Then, in 
Agent, you import this file.  Here's how to do each step.

1. How to execute the converter:

The converter is a DOS program (sorry ... we have not yet put an 
elegant user interface on it).  The command syntax is:

emailcvt <data directory> <output filename> [<folder prefix>]

where <data directory> is your Pegasus database directory and <output 
filename> is the name of the DOS file that contains the file Agent 
will read.  We recommend that the file extension be .txt, but this is 
not required.  The argument <folder prefix> is optional.  If provided 
it is appended to the beginning of all folder names that Agent 
creates during the import.  For example, if the argument was 
"Pegasus" then email would be imported into folders with names like 
"Pegasus.Main folder", "Pegasus.Copy to Self", etc.

If you're running Pegasus on a network, it may be difficult to 
determine what the <data directory> is.  If you're not sure, run 
Pegasus, select the Help | About menu item, and click on the "Info" 
button at the bottom of the About box.  The "Home mailbox location:" 
line in the resulting window gives the data directory.

The conversion program handles hierarchies of Trays and Folders by 
concatenating the tray and folder names with dots between them.  If 
you had a folder called "Music" in a tray called "Personal", the 
messages would be given an "X-Folder" name of "Personal.Music".

Pegasus doesn't store unread messages or messages that are queued for 
sending in regular folders, so no folder name is associated with 
them.  The conversion program puts unread and queued messages into 
folders named "_Unread" and "_Queued" respectively.

2. How to import the intermediate file into Agent:

In Agent, from the File menu, select, "Import Messages...".  Use the 
dialog box to select the intermediate file you created in step 1.  
The Import Messages dialog lets you select the destination folders 
(i.e the folders Agent will create), with the following options:

- "File according to import message filters" causes Agent to use the 
filing filters defined in the Inbound Email dialog.  This option is 
grayed if you have not yet opened the Inbound Email dialog and 
designated a default inbound folder.

- "Put all messages in folder <x>" causes Agent to put all messages 
in the specified folder.  The very first time you run this dialog, 
the folder defaults to your default inbound folder.

- If "... X-Folder" option is checked, Agent will file the messages 
in the folders specified by the "X-Folder" fields in the file, 
overriding the other preference settings on the dialog.  If 
"Automatically Create Folders" is checked, Agent will create these 
folders as needed.

To best preserve your Pegasus database structure, set the "... 
X-Folder" and "Automatically Create Folders" options.
