Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
User Manual
Copyright 2005-2016, FOOKES Holding Ltd
Aid4Mail version 4
The Swiss Army knife of email conversion tools
by FOOKES Holding Ltd
Aid4Mail is a leading email conversion tool used for email migration, email
discovery (searching and data extraction), and email archiving. It supports
over 40 mail client programs and mailbox formats, and all webmail accounts
offering IMAP access. Mail folders and files can be processed even when
disconnected (unmounted) from their email client including those stored on
CD, DVD, and USB drives.
Aid4Mail retains more information during conversion than any of its
competitors, including the native import and export features of most email
applications. Formatting, sender/recipient and other header details,
attachments, embedded contents, and message status are converted with
unmatched fidelity. This capability is crucial to large-scale migrations and for
those involved in e-discovery and email archiving.
Aid4Mail is a trademark licensed to Fookes Softw are Ltd. Fookes is a registered trademark of Fookes Holding Ltd. All other trademarks
and service marks, both marked and not marked, are the property of their respective ow ners.
Aid4Mail
Copyright 2005-2016, FOOKES Holding Ltd, Switzerland
All rights reserved. No parts of this work may be reproduced in any form or by any means - graphic, electronic, or
mechanical, including photocopying, recording, taping, or information storage and retrieval systems - without the
written permission of the publisher.
Aid4Mail is a trademark licensed to Fookes Software Ltd. Fookes is a registered trademark of Fookes Holding
Ltd. All other trademarks and service marks, both marked and not marked, are the property of their respective
owners.
While every precaution has been taken in the preparation of this document, the publisher and the author assume no
responsibility for errors or omissions, or for damages resulting from the use of information contained in this
document or from the use of programs and source code that may accompany it. In no event shall the publisher and
the author be liable for any loss of profit or any other commercial damage caused or alleged to have been caused
directly or indirectly by this document.
Printed: September 2016 in Charmey, Switzerland
Publisher
FOOKES Holding Ltd
Aid4Mail 4 Help
Table of Contents
Foreword
1 Introduction
................................................................................................................................... 1
2 Key Features
................................................................................................................................... 4
3 System...................................................................................................................................
Requirements
5
4 Installation
................................................................................................................................... 6
Setup Com m and-Line
..........................................................................................................................................................
Param eters
7
Setup Exit Codes
.......................................................................................................................................................... 9
Uninstall
.......................................................................................................................................................... 10
5 Aid4Mail
...................................................................................................................................
Editions
11
6 Which...................................................................................................................................
version do I need?
11
Hom e user m..........................................................................................................................................................
igrating non-professional m ail
11
Individual or organization
..........................................................................................................................................................
m igrating professional m ail
12
Service provider
..........................................................................................................................................................
(including e-discovery, forensic-exam ination, and archiving services)
14
E-discovery or..........................................................................................................................................................
forensic-exam ination professional (but not a service provider)
14
Em ail archivist..........................................................................................................................................................
(but not a service provider)
15
7 Comparison
...................................................................................................................................
Chart
16
8 Trial Mode
................................................................................................................................... 17
9 Product
...................................................................................................................................
Activation
18
10 How to...................................................................................................................................
Get Program Updates
20
11 Supported
...................................................................................................................................
Mail Formats
21
12 Information
...................................................................................................................................
About Mail Formats
23
13 Archiving
...................................................................................................................................
Email
31
14 Finding
...................................................................................................................................
Mail Folders
32
15 Frequently
...................................................................................................................................
Asked Questions (FAQ)
37
Ordering Aid4Mail
..........................................................................................................................................................
FAQ
37
Product Activation
..........................................................................................................................................................
FAQ
39
General Aid4Mail
..........................................................................................................................................................
FAQ
41
Office Outlook..........................................................................................................................................................
FAQ
47
Aid4Mail ZIP Archives
..........................................................................................................................................................
FAQ
52
Using Aid4Mail
..........................................................................................................................................................
w ith Macs FAQ
52
54
1 Program
...................................................................................................................................
Interface
54
2 Accessibility
...................................................................................................................................
Mode
55
3 Wizard
...................................................................................................................................
Screens
56
1. Mail Source.......................................................................................................................................................... 56
2. Source Location
.......................................................................................................................................................... 57
3. MAPI Store .......................................................................................................................................................... 58
4. Source MAPI
..........................................................................................................................................................
Folders
58
5. Source IMAP
..........................................................................................................................................................
Folders
58
Contents
II
6. Filter Options
.......................................................................................................................................................... 59
7. Target Form..........................................................................................................................................................
at
63
Office Outlook
.........................................................................................................................................................
& Microsoft Exchange
63
Other mail clients
......................................................................................................................................................... 64
Export email
.........................................................................................................................................................
to remote server
65
Generic mail
.........................................................................................................................................................
formats
65
Outlook Express ......................................................................................................................................... 65
Extract message
.........................................................................................................................................................
contents only
66
MHT Web Archive
.........................................................................................................................................................
files
66
Mail archives
......................................................................................................................................................... 67
Custom formats
.........................................................................................................................................................
using scripts
68
8. Target Settings
.......................................................................................................................................................... 68
9. Target MAPI..........................................................................................................................................................
Folder
71
10. Target IMAP
..........................................................................................................................................................
Folder
72
11. Export Options
.......................................................................................................................................................... 72
12. Start Processing
..........................................................................................................................................................
Mail
74
Skipped Messages
......................................................................................................................................................... 75
Other Screens.......................................................................................................................................................... 75
Trial Mode ......................................................................................................................................................... 75
New s and .........................................................................................................................................................
Updates
76
4 Software
...................................................................................................................................
Button Menu
76
Notification Options
.......................................................................................................................................................... 76
IMAP Options .......................................................................................................................................................... 77
Advanced Options
.......................................................................................................................................................... 78
5 GUI Command-Line
...................................................................................................................................
Switches
80
6 Writing
...................................................................................................................................
Aid4Mail Scripts
82
Aid4Mail Script
..........................................................................................................................................................
Syntax
86
Calculate com..........................................................................................................................................................
m and
93
7 Aid4Mail
...................................................................................................................................
Console
96
Com m and-Line
..........................................................................................................................................................
Param eters
96
Source Sw.........................................................................................................................................................
itches
98
Target Sw.........................................................................................................................................................
itches
102
Target Format Sw
.........................................................................................................................................
itches
104
Email Contents Sw
.........................................................................................................................................
itches
106
Special IMAP Sw.........................................................................................................................................
itches
107
Filter Sw itches
......................................................................................................................................................... 107
Other Sw .........................................................................................................................................................
itches
110
INI File Settings
.......................................................................................................................................................... 111
Source Settings
......................................................................................................................................................... 112
Target Settings
......................................................................................................................................................... 115
Filter Settings
......................................................................................................................................................... 122
Other Settings
......................................................................................................................................................... 123
Converting Multiple
..........................................................................................................................................................
Accounts w ith a CSV File
125
Receive Em ail
..........................................................................................................................................................
Notifications
128
Words List File
.......................................................................................................................................................... 129
Processing a..........................................................................................................................................................
List of Files
131
Exit Codes .......................................................................................................................................................... 131
Com m and-Line
..........................................................................................................................................................
Exam ples
132
8 Aid4Mail
...................................................................................................................................
Console Launcher
138
9 IMAP...................................................................................................................................
Settings
139
10 Fixing
...................................................................................................................................
Attachment Folder References
143
II
III
Aid4Mail 4 Help
11 Useful
...................................................................................................................................
Tokens and System Variables
145
12 MIME...................................................................................................................................
Types and File Extensions
147
13 Time...................................................................................................................................
Zones
147
14 Templates
...................................................................................................................................
and Fields
149
15 Error...................................................................................................................................
Log File
150
16 Glossary
................................................................................................................................... 150
ANSI PST
.......................................................................................................................................................... 150
Attachm ent .......................................................................................................................................................... 151
CLI
.......................................................................................................................................................... 151
Delim iter
.......................................................................................................................................................... 151
Em bedded contents
.......................................................................................................................................................... 151
EML files
.......................................................................................................................................................... 151
Exchange m ailbox
.......................................................................................................................................................... 151
Folder
.......................................................................................................................................................... 151
Generic m ailbox
.......................................................................................................................................................... 151
GUI
.......................................................................................................................................................... 151
IMAP
.......................................................................................................................................................... 152
Inform ation store
.......................................................................................................................................................... 152
Mailbox
.......................................................................................................................................................... 152
MAPI
.......................................................................................................................................................... 152
MAPI folder .......................................................................................................................................................... 152
m box
.......................................................................................................................................................... 152
MAPI store .......................................................................................................................................................... 153
MD5
.......................................................................................................................................................... 153
Message folder
.......................................................................................................................................................... 153
Message-ID .......................................................................................................................................................... 153
MHT files
.......................................................................................................................................................... 153
MHTML
.......................................................................................................................................................... 153
MIME
.......................................................................................................................................................... 153
PDF/A
.......................................................................................................................................................... 153
Personal folder
..........................................................................................................................................................
store (PST)
154
Plain text
.......................................................................................................................................................... 154
Private inform
..........................................................................................................................................................
ation store
154
Profile
.......................................................................................................................................................... 154
Public inform..........................................................................................................................................................
ation store
154
Recipient
.......................................................................................................................................................... 154
Rich content .......................................................................................................................................................... 154
Rich text
.......................................................................................................................................................... 155
SSL
.......................................................................................................................................................... 155
Status Flags/Indicators
.......................................................................................................................................................... 155
Styled Text .......................................................................................................................................................... 155
Thum b drive.......................................................................................................................................................... 155
TLS
.......................................................................................................................................................... 155
TNEF
.......................................................................................................................................................... 155
Unicode PST.......................................................................................................................................................... 155
Unpurged m ail
.......................................................................................................................................................... 156
UTC
.......................................................................................................................................................... 156
156
1 Ordering
...................................................................................................................................
Information
156
2 Subscription
...................................................................................................................................
Renewals
156
Copyright 2005-2016 Fookes Holding Ltd
Contents
IV
3 Upgrade
...................................................................................................................................
Policy
157
4 Refund
...................................................................................................................................
Policy
157
5 Software
...................................................................................................................................
Piracy
157
6 End User
...................................................................................................................................
License Agreement
158
7 Third...................................................................................................................................
Party Software Notices and/or Additional Terms and Conditions
170
177
1 About...................................................................................................................................
Fookes Software
177
2 Contacting
...................................................................................................................................
Fookes Software
177
3 Other...................................................................................................................................
Fookes Software Titles
178
4 Popular
...................................................................................................................................
Mail Clients
178
5 Trademarks
................................................................................................................................... 179
6 Acknowledgements
................................................................................................................................... 180
180
181
IV
Aid4Mail 4 Help
General Information
1.1
Introduction
Aid4Mail is a fast and highly accurate mail conversion program covering three main areas of expertise:
email migration, email e-discovery (searching and data extraction), and email archiving. It is suitable
for both small and large scale projects, from home use to large corporate migrations, and mission-critical
forensic work.
Aid4Mail supports over 40 email client programs and mail formats, as well as most popular webmail
services and remote accounts through IMAP. Local mail folders and files can be processed even when
disconnected (unmounted) from their email client, including those stored on CD, DVD, and USB drives.
The powerful search and data extraction features provided in the professional editions of Aid4Mail are
used by e-discovery experts worldwide. The filter tool enables refined searches on emails using
wildcards and even complex regular expressions if necessary. The integrated scripting language makes
it possible to extract just about any imaginable information from emails, including header metadata.
Email archiving for long term data retention and legal compliance is another area in which Aid4Mail
excels. All editions can export mail to a non-proprietary highly compressed ZIP file format or indexable
EML files. Aid4Mail eDiscovery also offers the option to convert messages to PDF/A, an important
electronic filing format used for long-term preservation of case-related documents.
Aid4Mail is a Windows program, but can run under Unix/Linux and Mac under certain conditions. See
the System Requirements for details.
If you need an easy and reliable way to:
export mail from Thunderbird to Outlook,
import Outlook into Windows Live Mail,
migrate MS Exchange to Google Apps or Office 365,
convert mbox, EML, or DBX files to PST,
convert from PST to mbox, CSV, MSG, or plain text,
archive email to PST, MSG, EML, XML, or ZIP files,
convert email to PDF,
perform e-discovery or email forensics,
or do just about any other email conversion task,
then you can trust Aid4Mail to do the job for you.
See the Key Features topic for a summary of Aid4Mail's main features.
Unmatched Fidelity
Aid4Mail retains more information during conversion than any of its competitors, including the native
import and export features of most email applications. Formatting, sender/recipient and other header
General Information
details, attachments, embedded contents, and message status are converted with unmatched fidelity.
This capability is crucial to large-scale migrations and for those involved in forensic and other e-discovery
investigations.
Migration
If you are planning large-scale mail migrations, Aid4Mail Console is the ideal solution to save time and
cut costs. There is no need to install Aid4Mail Console on an end-user's computer; simply place it on a
USB flash drive (memory stick) or on your network server. You can then automate the migration process
through a batch file or other script.
Aid4Mail 4 Help
Email Archiving
Aid4Mail is one of the few products on the market that can export to industry standard PDF/A files
(archival format). It also offers powerful archiving features which store your email in non-proprietary
formats. This means that you'll always be able to get it back again.
Badly managed email archives present a tempting target for litigators and regulators, and can cause loss
of valuable business information. Proprietary email archives risk becoming obsolete long before the
retention period is up. See our Archiving Email page for more information.
Aid4Mail Versions
Aid4Mail is available in several editions: Home, Professional, eDiscovery, and Console. Each edition is
distinguished by a specific set of features. The main feature differences are listed in the comparison
chart. An edition is further subdivided into one or more license types. Each license type corresponds to
a specific set of usage terms, which are defined in the End User License Agreement. For help in
choosing the appropriate license, see the Which version do I need? topic.
Testimonial
We work with over 1TB [one terabyte] of email per month and your Aid4Mail product has shown to be an
integral part of our toolset for dealing with these volumes of email. We are very impressed with your
commitment to your products and appreciate the strong customer support.
-- Jason Rappoport, Capsicum Group, LLC.
Note
In this documentation the names Office Outlook , Microsoft Outlook , MS Outlook , and Outlook all refer
to the same mail client software. However, Outlook Express is a completely different mail program and
should not be confused with Outlook.
General Information
1.2
Key Features
Aid4Mail contains the following key features, listed by edition. For help in choosing the appropriate
license, see the Which version do I need? topic.
Aid4Mail 4 Help
1.3
System Requirements
Aid4Mail has the following minimum requirements:
Windows 10 / 8.1 / 8 / 7 / Vista / XP / 2000, Server 2016 / 2012 / 2008 / 2003
Both 32-bit and 64-bit versions of Windows are supported.
The following operating systems should also work but are not officially supported:
+ Windows NT4 / ME / 98 / 95
+ Windows on a Mac with BootCamp or Parallels
+ Mac OS X (requires Wine, or Parallels with Windows)
+ Linux (requires Wine)
General Information
After you purchase an Aid4Mail license, you will need to activate your copy of the software. This simple
procedure requires an internet connection and usually takes just a few seconds. Aid4Mail eDiscovery
editions offer an option for offline activation.
1.4
Installation
Please read the System Requirements before installing Aid4Mail.
To install Aid4Mail, just execute the Setup program (Setup.exe or a similar name) and follow the
instructions. If you have purchased a license and received an activation code, start the Aid4Mail
program, click on the Software button, select Activate Product from the drop-down menu, and then enter
your code in the dialog box. Note that product activation requires an internet connection. Please read
the Trial Mode topic to see what limitations you will encounter during the evaluation period.
If you have a licensed copy of Aid4Mail version 1 installed on your computer, there is no need to
uninstall it. By default, Aid4Mail version 4 installs in a different program folder and can be used without
interfering with version 1. Note that if you have received an upgrade discount on purchasing version 4, the
Setup program does not require the presence of version 1 to install successfully.
If you are a system administrator, see the topic Setup Command-Line Parameters for details on
controlling the Aid4Mail Setup process. See also the Setup Exit Codes topic.
If Aid4Mail fails to run when you launch it, please scan your computer for viruses. Aid4Mail will not run if
it becomes infected by a virus or if it detects attempts to infect it. If you are sure that your computer has
no viruses and Aid4Mail still doesn't run, please contact us so that we can help you resolve the issue.
Anti-Virus Warnings
Copyright 2005-2016 Fookes Holding Ltd
Aid4Mail 4 Help
Unfortunately, certain anti-virus products especially those using proactive protection frequently
generate false positives when scanning programs. In other words, they think a file contains a virus or
other malware when there is none. You may experience this issue with our products too.
All our products are uploaded to the internet virus-free. Aid4Mail was scanned by over 50 different antivirus products and all showed it to be clean. If you have downloaded the software from our website, our
online store, or a reputable software repository, then you can be confident it did not come with a virus.
However, a virus on your computer may have infected our software after installation. If you are sure your
computer has no virus, then any warning you are getting on our software is probably a false positive.
If you encounter a false positive, make sure you inform the company of your anti-virus product so they
can fix the issue in their next maintenance release. Until the issue is fixed, you may be able to white-list
the software that is affected by the false positive, or turn off proactive protection in your anti-virus
product.
You can read more about false positives here:
http://www.viruslist.com/en/glossary?glossid=153654932
And here is an article about a well-known false positive that caused a lot of trouble for many users:
http://support.microsoft.com/kb/2025695
1.4.1
General Information
Aid4Mail 4 Help
Overrides the default folder name displayed on the Select Start Menu Folder wizard page.
/NOICONS
Instructs Setup to initially check the Don't create any icons check box on the Select Start Menu Folder
wizard page.
/COMPONENTS="comma separated list of component names"
Overrides the default components settings. Using this command line parameter causes Setup to
automatically select a custom type.
/TASKS="comma separated list of task names"
Specifies a list of tasks that should be initially selected or deselected. To deselect a task, prefix its
name with a "!" character.
Only the specified tasks (and their children) will be selected; the rest will be deselected. Use the /
MERGETASKS parameter instead if you want to keep the default set of tasks and only select/deselect
some of them.
Examples:
Deselect all tasks, then select the "desktopicon" and "fileassoc" tasks:
/TASKS="desktopicon,fileassoc"
Deselect all tasks, then select a parent task item, but exclude one of its children:
/TASKS="parent,!parent\child"
/MERGETASKS="comma separated list of task names"
Like the /TASKS parameter, except the specified tasks will be merged with the set of tasks that would
have otherwise been selected by default.
If UsePreviousTasks is set to yes, the specified tasks will be selected/deselected after any previous
tasks are restored.
Examples:
Keep the default set of selected tasks, but additionally select the "desktopicon" and "fileassoc" tasks:
/MERGETASKS="desktopicon,fileassoc"
Keep the default set of selected tasks, but deselect the "desktopicon" task:
/MERGETASKS="!desktopicon"
1.4.2
General Information
10
1.4.3
Uninstall
You can uninstall Aid4Mail by using the Control Panel's Add/Remove Programs dialog box or the
Uninstall Aid4Mail shortcut in the Start menu. Unless mentioned otherwise, there is no need to uninstall
your Aid4Mail copy when you upgrade to a newer version.
11
1.5
Aid4Mail 4 Help
Aid4Mail Editions
Aid4Mail 4 is available in several editions, which are listed below:
Aid4Mail Home
Aid4Mail Home is competitively priced, but lacks support for Microsoft Exchange, PDF export, email
filtering, and scripts. It may only be used to process private mail.
Aid4Mail Professional
Aid4Mail Professional includes all the main features but lacks forensic-specific capabilities. It may not
be used to process other people's accounts in a forensic or e-discovery context.
Aid4Mail eDiscovery, Forensic, and Service
Aid4Mail eDiscovery offers the full set of features and can be activated offline. It is designed for email
forensics and e-discovery. It offers access to the Email Notifications feature.
Aid4Mail Migrator
Aid4Mail Migrator includes a console, which is a powerful command-line interface (CLI) that you can use
to automate the migration process through a batch file or other script. Automation can significantly save
time and ultimately cut costs. And version 4 adds a console launcher that makes it really easy to
migrate multiple accounts concurrently. The Aid4Mail Migrator license, which can either be run from a
server or thumb drives, is ideally suited for large-scale email migrations. It offers access to the Email
Notifications feature.
Due to third-party licensing terms, Aid4Mail Console currently does not include the PDF export option.
For help in choosing the appropriate license, see the Which version do I need? topic.
1.6
1.6.1
General Information
12
Important:
This license can only be used in a non-professional context and is not transferable. It can only be used
to process one end-user mail account. A single mail account can consist of several email addresses
belonging to the same person (see definition in EULA). Note that Aid4Mail Home does not support
Microsoft Exchange. For this you would need Aid4Mail Professional Personal.
The following licenses can also be used if you require extra features:
1.6.2
13
Aid4Mail 4 Help
3. Aid4Mail Migrator
Features:
Process over 40 mail formats
Support for Microsoft Outlook and Exchange
Command-line interface for faster migration
Supports CSV files with settings for multiple migrations
Can be run from other applications and batch files
Copy to, and run from, a thumb drive or a server
The server version can be run through a Windows Service
Option to run unattended (with no user-interaction)
Use Email Notifications for lengthy unmonitored migrations
Choose any number of seats between 50 and 500,000
Does not use online activation
Bundled with Aid4Mail Console and Aid4Mail Console Launcher (included in price)
Customer support included in subscription
Speed up migrations with Aid4Mail Console Launcher
Important:
This license can only be used for mail migration. It can only be used to process one end-user mail
account per seat. A single mail account can consist of several email addresses belonging to the same
person (see definition in EULA).
The following license can also be used instead of Aid4Mail Professional Personal if you require extra
features:
General Information
14
1.6.3
Aid4Mail Service
Features:
Process unlimited mail accounts from a single seat
Process over 40 mail formats
Support for Microsoft Outlook and Exchange
Export to generic mail formats (mbox and EML)
Create non-proprietary ZIP archives
Export to searchable PDF, PDF/A, Excel, and HTML
Save to CSV and database formats
Extract email addresses and attachments
Rebuild proprietary formats to internet standards
Filter emails by date, keywords, and text
Scriptable (custom filters and output formats)
Process unpurged mail
Scripting supports various hash functions
Exchange email data with external console programs
Use Email Notifications for lengthy unmonitored tasks
Offline activation
Bundled with Aid4Mail Console and Aid4Mail Console Launcher (included in price)
Transferable (see EULA terms)
Customer support included in subscription
Speed up file processing with Aid4Mail Console Launcher
Important:
This license is for service providers processing email on behalf of their clients (including e-discovery,
forensic-examination, and archiving services). It does not permit mail migration. If you need to migrate
mail, one of the Aid4Mail Professional licenses or Aid4Mail Migrator would be necessary.
1.6.4
Aid4Mail Forensic
Features:
Process unlimited mail accounts from a single seat
15
Aid4Mail 4 Help
1.6.5
Aid4Mail Archivist
Features:
Process unlimited mail accounts from a single seat
Process over 40 mail formats
Support for Microsoft Outlook and Exchange
Export to generic mail formats (mbox and EML)
Create non-proprietary ZIP archives
Export to searchable PDF, PDF/A, Excel, and HTML
Save to CSV and database formats
Extract email addresses and attachments
Rebuild proprietary formats to internet standards
Filter emails by date, keywords, and text
Scriptable (custom filters and output formats)
Process unpurged mail
Scripting supports various hash functions
Exchange email data with external console programs
Use Email Notifications for lengthy unmonitored tasks
Offline activation
Optional Aid4Mail Console bundle
Transferable (see EULA terms)
General Information
16
1.7
Comparison Chart
Aid4Mail is available in several different editions. The main differences are shown in the following chart:
Aid4Mail edition
Home
Professional eDiscovery
Console
No
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
Yes
No
Yes
Yes
Yes
No
Yes
Yes
Yes
Yes
Yes
Yes
No
Yes
Yes
Yes
No
Yes
Yes
Yes
No
No
Yes
Yes
No
No
Yes
Yes
No
No
Yes
Yes
No
No
Yes
Yes
No
Yes
Yes
(Forensic)
N/A
No
No
No
Yes
17
Aid4Mail 4 Help
For help in choosing the appropriate license, see the Which version do I need? topic.
1.8
Trial Mode
Trial mode lets you evaluate Aid4Mail for as long as you like without any payment. Of course, in order to
protect our business, some features work slightly differently during the free trial mode. When you
purchase and activate your license, those trial limitations are removed.
Aid4Mail lets you choose between two main trial limitations. You can either 1) process an unlimited
number of emails but lose the original subject line in exported emails, or 2) preserve the original subject
line (with some inserted text) but process only a limited number of emails in each folder. These two
options are explained in more detail below...
Otherwise, the only other limitation you will experience is the trial-mode information screen. It is
displayed for about 8 seconds each time you start the Aid4Mail wizard.
IMPORTANT
When using Aid4Mail in trial mode, only convert email to target test folders and mailbox files. Since by
default Aid4Mail does not modify or delete your source email, you can safely select existing mail folders
and stores during your tests.
Files created by Aid4Mail during trial mode are for evaluation purposes only and must be destroyed
when you've finished testing our software.
To enable this trial option, click on the "Software" button in the Aid4Mail wizard screen and uncheck the
"Test Unlimited Emails per Folder" option. When using Aid4Mail Console, add the /NoLimit=False
switch to your command line.
General Information
1.9
18
Product Activation
Aid4Mail uses a license activation system to help prevent piracy and protect your investment in our
software. This enables us to continue its development at a competitive price.
The license activation system is managed by software_DNA from softWORKZ Innovation Inc. It does not
collect any details about you or your computer although you may optionally enter your email address for
easy password retrieval if required.
What it does
Unlike other activation systems, software_DNA does not tie your license to your hardware when using
online activation. Essentially, your license is tied to your activation code and the password that you
define. This facilitates re-activating Aid4Mail after reformatting your hard drive, upgrading hardware
components in your computer, logging in under a different user profile, or moving your software to a new
computer.
Note that the Aid4Mail License Agreement allows the software to be moved from an old computer to a
new one that replaces it. However it does not allow a license to be re-activated on a different computer
or user account (e.g. Windows logon) in order to access another person's mail.
How it works
Once Aid4Mail is installed it will run in Trial Mode until activated. Usually activation is carried out online.
It is a quick and simple process that requires an internet connection, and is described below. For
Aid4Mail eDiscovery licenses, and some Aid4Mail Console licenses, an offline activation option is
available.
Once Aid4Mail has been activated, the Trial Mode limitations are removed. If Aid4Mail was activated
online, then it will also require an internet connection at least once a month to verify the license status
(this does not apply to licenses activated offline). Aid4Mail will remain in an activated state unless any of
the following situations are encountered, in which case it will revert to Trial Mode:
it is accessed from a different Windows user login,
installed and run on another computer,
re-installed on the same computer after a disk reformat,
has not connected to the license server for at least four weeks (licenses activated online only),
your license subscription period has expired.
If your license subscription is still valid you can simply re-activate your license and continue using
Aid4Mail. Re-activation is a quick and simple process and free of charge. Again it is usually done online,
requiring an internet connection. For Aid4Mail eDiscovery licenses, and some Aid4Mail Console
licenses, it can also be done offline.
If your license subscription period has expired, then Aid4Mail can only be re-activated if the subscription
is renewed, or if a new subscription is purchased. (License renewal is significantly cheaper than a
corresponding new subscription.)
19
Aid4Mail 4 Help
To ensure compliance with the License Agreement, the number of re-activations allowed in a given time
period is limited. If this limit is exceeded, the activation server will perform a lockout and you must wait
before being allowed to reactivate. Too many failed password attempts can also result in a lockout to
protect your code from theft. Note that software_DNA also includes an anti-fraud system that disables
activation codes in cases of credit-card chargeback or refunds.
Online activation
Activating Aid4Mail online is quick and simple and requires an internet connection.
To activate Aid4Mail:
1. Click on the "Software" button and select "Activate License" (if you have just started Aid4Mail, you
can click directly on the "Activate" button). This will open the "Product Activation" dialog.
2. Enter your activation code and click on the "Next" button.
3. On the next screen, enter a password of your choice, and confirm it. Optionally, enter an email
address that can be used to send your password to you if you forget it. Confirm the email address
too.
4. Click on the "Activate" button.
Online re-activation
Once Aid4Mail has been successfully activated online, it will need to be re-activated in any of the
situations listed above. Re-activation is quick and simple and requires an internet connection.
To re-activate Aid4Mail:
1. Click on the "Software" button and select "Activate License" (if you have just started Aid4Mail, you
can click directly on the "Activate" button). This will open the "Product Activation" dialog.
2. Enter your activation code and click on the "Next" button.
3. On the next screen, enter your current password. Note that it is CASE SENSITIVE.
Single-user activation codes: If you cannot remember your current password, click on the "Forgot
Password?" button and your password will be sent to you (as long as you have previously specified an
email address). If it does not arrive within minutes, check your junk mail folder in case it was
misidentified as spam. You should ensure that your spam filter allows emails from softworkz.com.
Multi-user activation codes (Aid4Mail Professional Site): The activation code password is accessible
to the license administrator through the Softworkz License Control Panel (LCP). The LCP can be used
to manage seats linked to the activation code and change its password. Details on accessing the
LCP are sent by email to the address entered on activating the first seat of the site license.
4. On the same screen, enter a new password that you have never used before in Aid4Mail. Confirm
the new password.
5. Click on the "Re-Activate" button.
software_DNA then checks online that the activation code and your password match the information on
the server. If the match is successful, Aid4Mail is re-activated and the new password is stored on the
license server, replacing the current one. If the match is unsuccessful, re-activation fails and you must
retry. The number of failed password attempts allowed is limited, as is the number of re-activations in a
given time period. Exceeding these limits can result in a lockout.
Note that to ensure the re-activation procedure is as quick and simple as possible, we strongly suggest
Copyright 2005-2016 Fookes Holding Ltd
General Information
20
you keep a record of your current password and any previous passwords you have used in Aid4Mail
(because new passwords must not have been used before). It is preferable to keep this list off your
computer so that you do not lose it if your hard disk fails.
Proxy settings
A "proxy Server" is typically used to block access to the internet by Local Area Network users unless
they are authenticated with a user name and password. If Aid4Mail resides behind a proxy server then
internet access will also be blocked for the software_DNA license activation system. In this case,
software_DNA must know the proxy server settings in order to work. The required information includes
the server name or address, the server port number, user name, and password.
You can access Aid4Mail's "Proxy Settings" as follows:
1. Click on the "Software" button and select "Activate License" (if you have just started Aid4Mail, you
can click directly on the "Activate" button). This will open the "Product Activation" dialog.
2. Click on the "Proxy Settings" button to open the "Proxy Settings" dialog.
On the "Proxy Settings" dialog, if "Use IE proxy configuration" is checked and "Use custom proxy
settings" is not checked, then software_DNA will automatically use the proxy settings of Internet
Explorer including any automatic configuration scripts. As long as Internet Explorer has connectivity to
the internet (i.e. any required proxy settings are correct) then software_DNA will function properly.
You should only set the "Use custom proxy settings" option, and fill in the proxy fields, if "Use IE proxy
configuration" doesn't work on your system.
1.10
21
Aid4Mail 4 Help
you or your computer will be revealed during this operation. If it detects that the news file has been
updated, Aid4Mail will automatically display its contents on startup. Just click on the link to view a news
item or download a program update. Note that Aid4Mail needs access to the internet for this feature. If
you use a firewall product like ZoneAlarm or Norton Personal Firewall, make sure you let the Aid4Mail.
exe program file make the connection.
Usually, program updates are downloaded and installed directly from within Aid4Mail. However, be aware
that some download managers may take over this download process and interfere with normal
operations. When this happens, you may see a prompt from Aid4Mail asking you to click a button once
the download has been completed. With other download managers, the download may fail altogether. In
this case, turn off your download manager and try again.
We recommend that you enable the Check for news updates option to keep your Aid4Mail program
up-to-date. However, if you prefer to check for updates manually, then use the Update Now button on
the News and Updates screen instead. Updates during the subscription period are available at no
charge. See the Upgrade Policy topic for further details.
1.11
General Information
22
23
1.12
Aid4Mail 4 Help
General Information
24
correctly, but a large part of the original email header fails to convert.
The MAPI subsystem installed in the Internet Mail Only mode (IMO; Outlook 98/2000) is a stub that
provides minimal MAPI support for the basic functionality of Office Outlook, and might not work properly
with Aid4Mail. How to tell which setup option you have: in Outlook 98/2000 on the Help menu, click
About Microsoft Outlook. Next, look at the second line of text in the About Microsoft Outlook dialog box.
If it shows "Corporate or Workgroup", then you have a fully working version of Outlook with Extended
MAPI installed.
The current version of Aid4Mail does not support folder and file names with Unicode characters. Any
such character that doesn't translate to the ANSI character set will be replaced with a substitution
character.
Aid4Mail may not be able to process your PST file if it is damaged or oversized. If you experience
issues, you could try one of the following Microsoft tools to repair your PST file:
How to use the Inbox Repair Tools to recover email messages in Outlook 2002, 2003, 2007, and 2010
(scanpst.exe):
http://support.microsoft.com/kb/287497/
Oversized PST and OST crop tool (Pst2gb.exe):
http://support.microsoft.com/kb/q296088
2. Windows Live Mail
Windows Live Mail (WLM) is the email client from Microsoft's Windows Live set of products. It is
intended to be a replacement for Outlook Express on Windows XP and Windows Mail on Windows
Vista. Unlike Outlook Express, it saves messages as individual EML files. Aid4Mail can read WLM disk
folders and convert locally stored messages to any of the supported output formats. However, the current
version is not capable of retrieving or setting email status information (unread, read, replied, etc.) Please
note that the folder names on disk may not reflect the names you see in WLM.
During conversion, Aid4Mail won't access IMAP accounts configured in WLM. Only local mailbox files
are processed. If you need to convert mail from IMAP accounts, choose the IMAP Mail option as your
Mail Source.
Before exporting messages to WLM with Aid4Mail, make sure you have configured it with at least one
mail account so that the appropriate target folder is created. You must export your source mail under the
"Storage Folders" location. Open WLM once Aid4Mail has completed the transfer. WLM will start
indexing your new folders and messages; during this time the "Unread email" count increases
progressively. Make sure you give it enough time to complete the task. Sometimes new folders do not
appear immediately under "Storage Folders"; this display issue is usually fixed by restarting WLM.
3. Windows Mail
Windows Mail replaces Outlook Express under Windows Vista. Unlike Outlook Express, it saves
messages as individual EML files. Aid4Mail can read Windows Mail disk folders and convert the
messages to any of the supported output formats. However, the current version is not capable of
retrieving or setting email status information (unread, read, replied, etc.) Please note that the folder
names on disk may not reflect the names you see in Windows Mail.
During conversion, Aid4Mail won't access IMAP accounts configured in Windows Mail. Only local
mailbox files are processed. If you need to convert mail from IMAP accounts, choose the IMAP Mail
Copyright 2005-2016 Fookes Holding Ltd
25
Aid4Mail 4 Help
General Information
26
During conversion, Aid4Mail won't access IMAP accounts configured in your mail client program. Only
local mailbox files are processed. If you need to convert mail from IMAP accounts, choose the IMAP
Mail option as your Mail Source.
Before exporting messages to any of these mail clients with Aid4Mail, make sure you have configured
them with at least one mail account so that the appropriate target folder is created.
Prior to version 3, Thunderbird has a bug that makes it fail to display mail folders that have a storage
path length that exceeds 128 characters. If you run into this limit, you can display more folders by
moving the profile or the accounts directory closer to the root of the drive, so that less of the total path
length is wasted. Another solution is to rename your source mail folders to shorter names before
converting them with Aid4Mail.
Unless you enabled message synchronization, local mailboxes for IMAP accounts are empty and only
index files for managing the remote messages are created.
6. Qualcomm Eudora
This section concerns the Qualcomm version of Eudora. More recent versions are developed by the
Mozilla Foundation and use a different mailbox format, which is identical to Mozilla Thunderbird (see
section #5 above).
Aid4Mail can read both the Eudora index files (*.toc) and its mailbox files (*.mbx). Mail status
information (unread, read, replied, etc.) is stored in the index files, not in the mailbox files. So unless
they are corrupted or missing, you should always select the *.toc files instead of the *.mbx files to
process in Aid4Mail.
During conversion, Aid4Mail won't access IMAP accounts configured in Eudora. Only local mailbox files
are processed. If you need to convert mail from IMAP accounts, choose the IMAP Mail option as your
Mail Source.
Eudora creates very compact mailbox files. It does so by extracting attachments and embedded
contents from messages, and saves these in separate folders. The advantage of this approach is that
mailbox files grow less quickly when you receive mail and attachments are easily accessible through
Windows Explorer or another file manager. The disadvantage of Eudora's approach is that the original
message MIME format is lost and the message header information no longer reflects the format of the
message body. Eudora also has a tendency to corrupt its own mailbox files by adding binary characters
that do not belong there and messing up the message delimiters. Most of the time, the mailbox files that
Eudora produces no longer conform to RFC 822 rules. As a result, most mail clients are incapable of
importing Eudora mail reliably.
Aid4Mail is one of the few programs that is capable of rebuilding email in Eudora mailboxes back to their
original MIME format. It can also fix most corrupted messages. As a result, you can reliably migrate
your Eudora mail without losing file attachments, embedded contents, rich text, and status information.
Note that old versions of Eudora produced rich text based on the Enriched Text Format (emails start with
<x-rich>), which may not supported by all modern mail clients.
If you have deleted or moved Eudora attachments, Aid4Mail won't be able to re-insert them into the
corresponding email messages. In such cases, the attachments will show up with no contents. There is,
however, a way to instruct Aid4Mail where to look for attachment folders that have changed location
through a file called Tokens.ini. See instructions under the Fixing Attachment Folder References topic.
If you are converting Macintosh Eudora mailbox files, Aid4Mail expects to find the mailbox files under the
Copyright 2005-2016 Fookes Holding Ltd
27
Aid4Mail 4 Help
"Mail Folder" folder, attachments in the "Attachments Folder" folder, and embedded contents in the
"Parts Folder" folder. All three folders share the same parent folder. If your attachment and embedded
contents files are in a different location, see the instructions under the Fixing Attachment Folder
References topic.
Aid4Mail currently cannot retrieve mail status information (unread, read, replied, etc.) from Mac Eudora.
Sent dates stored in the Out mailbox rarely convert well when exported to formats that require a
standards-compliant date format. That is because Eudora stores the sent date in the Out.toc file using a
text format based on the Windows or Mac short date setting. And over time, with each OS upgrade and
mail migration, the date format can change. As a result, it cannot be reliably converted through software
methods to a standard format. To work around this issue, Aid4Mail uses the From-delimiter date from
Out.mbx, which uses a standards-compliant date format. Note, however, that this date corresponds to
the time when the email was added to the mailbox. If the email is moved to a different folder, then the
date no longer corresponds to the sent date.
7. Apple Mail (Mac OS X)
Aid4Mail is capable of processing email files stored by all versions of Apple Mail. Since Aid4Mail is a
Windows application, it will only run on Intel-based Macs that are running Windows or Wine, and on
PowerPC Macs using Virtual PC. We recommend that you run Aid4Mail on a Windows system as it will
process mail much faster that way.
If you want to migrate your Apple Mail to a Windows email program, first transfer your files from Mac to
Windows. You can also copy your Apple Mail folders and files to a CD, DVD, or USB drive, which
Aid4Mail can then access from your Windows computer. Aid4Mail can read the MBOX files created by
Apple Mail 1 (that comes with Mac OS X 10.0 to 10.3) if that is the format you have, use the "mbox
files" Mail Source option under the "Generic mail formats" section in Aid4Mail. Later versions of Apple
Mail (starting with version 2) store their messages in EMLX format. To migrate those messages, use the
"Apple Mail (Mail.app) message files" Mail Source option under the "Popular mail clients" section in
Aid4Mail.
To migrate your Windows email messages to Apple Mail, run Aid4Mail on your Windows computer and
convert your mail to the "mbox files" format, which is listed under the "Generic mail formats" section on
the Target Format screen in Aid4Mail. We recommend that you set the "File name" field on the Target
Settings screen to "*.MBOX" (without the quotes), and set the "Target Line Format" option to "Macintosh
(CR)". You will then have to transfer the mbox files created by Aid4Mail to your Mac system, and use
the Apple Mail import command to copy your emails into it.
During conversion, Aid4Mail won't access IMAP accounts configured in Apple Mail. Only local mailbox
files are processed. If you need to convert mail from IMAP accounts, choose the IMAP Mail option as
your Mail Source.
8. IMAP Mail
Aid4Mail can download and upload email from and to a remote mail server using the IMAP protocol.
IMAP is available with popular services like Yahoo! Mail, Gmail, AOL Mail, Outlook.com, and Outlook
365. Please note that, at this time of writing, IMAP access to a Yahoo! Mail account is not officially
supported by Yahoo. As a result, there is no guarantee that this option will be available in the future.
Beware! Gmail enforces daily bandwidth limits. As of this writing, you can upload up to 500 MB and
download up to 2,500 MB of email per day.
General Information
28
9. Google Takeout
Google Takeout saves emails in mbox files. These files are based on the generic mailbox format but use
a proprietary format for message status information (unread, deleted, etc.). Aid4Mail will recover emails
and their status information. You'll have to extract the files from the ZIP archives before you can process
them.
10. Google Apps Vault
Google Apps Vault saves emails in mbox files. Unlike Google Takeout, message status information
(unread, deleted, etc.) is not stored in the mbox file. Instead, they are stored in a separate XML file that
has a name ending with -metadata.xml. You'll have to extract the files from the ZIP archives before you
can process them.
Before processing mbox files from Google Apps Vault, make sure you place the corresponding metadata.xml file in the same folder. If the corresponding XML file is missing, Aid4Mail won't recover
message status information.
Aid4Mail can also determine the source folder names (or Gmail labels) based on the information in the
XML file. In some cases, an email message may belong under more than one folder. Unfortunately,
Aid4Mail is currently designed to export an email to a single folder. As a result, if a Gmail message has
more than one target location assigned to it, Aid4Mail will choose the target folder in the following order:
1.
2.
3.
4.
5.
6.
7.
Inbox
Sent Mail
Drafts
Spam
Trash
[ User Defined Label (first one listed if there are several) ]
All Mail
Note that the Google Apps Vault option is not available in Aid4Mail Home.
11. mbox files (Generic Mailbox)
A generic mailbox is a file that contains email messages that are stored in a non-proprietary format,
which conforms to RFC 822 rules. Messages in generic mailbox files usually store status information
(unread, read, replied, etc.) in their header, which Aid4Mail can read and export. Most mail clients are
capable of reading or importing messages from generic mailbox files.
Note that Aid4Mail cannot read the *.box mailbox files from Calypso and Courier. Messages in BOX files
are stored in encrypted format so that other programs cannot access them. Before you can process
these messages in Aid4Mail, you must first save your *.box files to Calypso or Courier archives (these
are equivalent the generic mailbox files). To do this, use the Mailbox/Save to Archive menu command in
Calypso or Courier and choose the option to save with attachments. Message status information is
limited to Read and Unread in Calypso and Courier.
Aid4Mail also cannot process Pine MBX files, which use a proprietary format that is in no way related to
the mbox format.
12. Pegasus Mail
Aid4Mail can read both the Pegasus index files (*.pmi) and its mailbox files (*.pmm). Mail status
Copyright 2005-2016 Fookes Holding Ltd
29
Aid4Mail 4 Help
information (unread, read, replied, etc.) is stored in the index files, not in the mailbox files. So unless
they are corrupted or missing, you should always select the *.pmi files instead of the *.pmm files.
Pegasus stores new mail in separate *.cnm files. If you want Aid4Mail to convert those along with the
other mail folders, choose "Pegasus Mail (index)" as the source format and select the folder that
contains all the Pegasus mailbox files (do not highlight any of the PMI files otherwise Aid4Mail will
ignore all CNM file). With Aid4Mail Console, simply specify "*.pmi" as your source mail in order to
include all CNM files during processing.
During conversion, Aid4Mail won't access IMAP accounts configured in Pegasus Mail. Only local
mailbox files are processed. If you need to convert mail from IMAP accounts, choose the IMAP Mail
option as your Mail Source.
13. PocoMail and Barca
Aid4Mail can read both the PocoMail/Barca index files (*.idx) and its mailbox files (*.mbx). Aid4Mail only
reads mail status information (unread, read, replied, etc.) from the index files, not in the mailbox files. So
unless they are corrupted or missing, you should always select the *.idx files instead of the *.mbx files.
During conversion, Aid4Mail won't access IMAP accounts configured in PocoMail and Barca. Only local
mailbox files are processed. If you need to convert mail from IMAP accounts, choose the IMAP Mail
option as your Mail Source.
PocoMail and Barca offer options to create compact mailbox files. The mail client does so by extracting
file attachments from messages, and saves these in a separate folder. The advantage of this approach is
that mailbox files grow less quickly when you receive mail and attachments are easily accessible
through Windows Explorer or another file manager. The disadvantage of this approach is that the original
email MIME format is lost and most mail clients fail to import such messages reliably.
Aid4Mail is the only program that is capable of rebuilding messages in PocoMail and Barca mailboxes
back to their original MIME format. As a result, you can reliably migrate your PocoMail/Barca mail
without losing file attachments, embedded contents, rich text, and status information.
If you have deleted or moved extracted PocoMail/Barca attachments, Aid4Mail won't be able to re-insert
them into the corresponding email messages. In such cases, the attachments will show up with no
contents. There is, however, a way to instruct Aid4Mail where to look for attachment folders that have
changed location through a file called Tokens.ini. See instructions under the Fixing Attachment Folder
References topic.
Before exporting messages to PocoMail or Barca with Aid4Mail, make sure you have configured them
with at least one mail account so that the appropriate target folder is created.
14. The Bat!
Recent versions of The Bat! offer an option to create very compact mailbox files. It does so by extracting
file attachments and embedded contents from messages, and saves these in a separate folder. The
advantage of this approach is that mailbox files grow less quickly when you receive mail and
attachments are easily accessible through Windows Explorer or another file manager. The disadvantage
of this approach is that few programs are capable of migrating such messages reliably.
Aid4Mail can rebuild messages in The Bat! mailboxes back to their original MIME format. As a result,
you can reliably migrate your The Bat! mail without losing file attachments, embedded contents, rich text
, and status information.
Copyright 2005-2016 Fookes Holding Ltd
General Information
30
If you have deleted or moved extracted The Bat! attachments, Aid4Mail won't be able to re-insert them
into the corresponding email messages. In such cases, the attachments will show up with no contents.
There is, however, a way to instruct Aid4Mail where to look for attachment folders that have changed
location through a file called Tokens.ini. See instructions under the Fixing Attachment Folder References
topic.
During conversion, Aid4Mail won't access IMAP accounts configured in The Bat!. Only local mailbox files
are processed. If you need to convert mail from IMAP accounts, choose the IMAP Mail option as your
Mail Source.
Please note that Aid4Mail cannot process encrypted The Bat! mail files. In this case, you will first have
to export your messages with The Bat! to a Generic mailbox format, which Aid4Mail can then process to
any of the supported formats.
15. Opera Mail
Over the years, Opera's mail client has changed storage format several times. The more recent versions
do not organize messages in mailboxes with corresponding names. Instead, Opera uses virtual
mailboxes that classify messages according to use-defined filters. Aid4Mail does not have the capability
to interpret Opera filters. As a result, messages are classified according to their nature. Incoming mail is
stored in the "Received" mailbox, outgoing mail is exported to the "Sent" mailbox, and Usenet
messages are placed in the "News" mailbox.
Opera only supports the email status Read and Unread. Unfortunately, the current version of Aid4Mail
cannot extract this information from the Opera data files.
During conversion, Aid4Mail won't access IMAP accounts configured in Opera Mail. Only local mailbox
files are processed. If you need to convert mail from IMAP accounts, choose the IMAP Mail option as
your Mail Source.
16. Microsoft Entourage
Aid4Mail does not process Microsoft Entourage's native mail database stores, but it does handle the
MBOX file format that Entourage supports.
If you want to migrate your Entourage mail to a Windows email program, first convert your Entourage
mail folders to MBOX files. The simplest way to do this is to drag each folder of messages to the Mac
desktop. Entourage will automatically create an MBOX file for each folder you drag-and drop to the
desktop. Next, you will have to transfer your MBOX files from Mac to Windows. You can also copy your
MBOX files to a CD, DVD, or USB drive, which Aid4Mail can then access from your Windows computer.
Use the "Generic mailboxes" mail source option under the "Generic Mailbox Format" section in Aid4Mail
to select your MBOX files and then choose the appropriate target email format when you reach the
Target Format screen.
To migrate your Windows email messages to Microsoft Entourage, run Aid4Mail on your Windows
computer and convert your mail to the "Generic mailboxes" format, which is listed under the "Generic
formats" section on the Target Format screen in Aid4Mail. We recommend that you set the "File name"
field on the Target Settings screen to "*.MBOX" (without the quotes), and set the "Target Line Format"
option to "Macintosh (CR)". You will then have to transfer the mbox files created by Aid4Mail to your
Mac system. Then either use the Entourage import command to copy your emails into it (File / Import /
Contacts or Messages from a text file / Import messages from an MBOX-format text file), or drag-anddrop the MBOX files to the Entourage folder window.
Copyright 2005-2016 Fookes Holding Ltd
31
Aid4Mail 4 Help
1.13
Archiving Email
Protect Your Business with Your Email Archives
Badly managed email archives present a tempting target for litigators and regulators, and can cause loss
of valuable business information. Download the free report, "Manage Your Email So It Doesn't Manage
You", and learn how to:
Significantly reduce email storage space. Email archives are growing and there is no end in sight.
Learn how to shrink your email storage without compromising your archives.
Easily access archived email content. In a regulatory investigation or legal discovery, you don't have
the luxury of telling investigators and litigators to wait until you find what you need. You need to
produce it now.
Time-proof your email archives. Long retention periods are becoming the norm, but proprietary archives
may not be available long-term. Learn how to easily set and observe retention periods, and how to
protect yourself from obsolete archives.
What Aid4Mail will do for you
1. Aid4Mail stores your email archives as non-proprietary, generic mailbox files. This means that you'll
always be able to get them back again. Proprietary email archives risk becoming obsolete long before
the retention period is up.
General Information
32
2. Your email files are highly compressed in standard ZIP files. This saves you a huge amount of room
on your archive tapes and drives and makes it extremely simple to open them again.
3. Aid4Mail extracts attachments and embedded contents like images and sound files and stores them
in separate folders inside the archived ZIP file. This way you can easily access attachments and
embedded contents without using special utilities.
4. Aid4Mail automatically removes duplicates of attachments and embedded contents. When you have
broadcast the same email with attachments to multiple users, only the original email is archived. This
significantly reduces the size of ZIP archives and doesn't return 20 copies of the very same email in
searches.
5. Use any storage media you like for your archived email. Aid4Mail can easily read your archive files
from any drive that Windows Explorer can access, including CD-ROMs and DVDs, local or network
drives, hard drives or tape.
6. Supports most of the popular email formats, including Outlook, Mozilla Thunderbird, Eudora, Pegasus
and a host of others.
7. Search and filter by folder, date range and/or by matching text.
8. You can also extract names and email addresses of people that have been corresponding with you
an ideal feature if you need to rebuild an address book or create a mailing list.
How to read archived mail
There are several ways you can access and read mail stored in Aid4Mail ZIP archives. The best way is
to use Aid4Mail filters to extract just the messages you're looking for. Simply select your ZIP archive as
the source mail, set the filter options so that they find the specific messages you want to view, and
choose an appropriate target format. Select a temporary target folder if you plan to remove the exported
messages after viewing. An ideal target format is "MHT message files for viewing from Web browser" if
you haven't got too many messages in your selection and you don't mind using Internet Explorer.
Alternatively, you can export messages to the EML format; double-clicking on such a file in your file
manager (e.g. Windows Explorer) will normally display the message in a new window created by a
compatible email program (Outlook Express, Windows Mail, Thunderbird). Of course, you can also
export all your archived mail to any of the supported mail programs.
If you are looking for an archived attachment, simply open your ZIP archive in Windows Explorer
(requires Windows XP or more recent) or a ZIP utility (e.g. 7-Zip, WinZip). You will find attachments
stored as regular files under the Attach folder. If you are looking for pictures or other documents that
were inserted in the email message, search the Embedded folder instead.
1.14
33
Aid4Mail 4 Help
1. Microsoft Outlook
Typical default location:
<Documents>\Outlook Files\
<Application Data>\Microsoft\Outlook\
File to search for:
Outlook.pst
or any file with the .pst extension
2. Outlook Express
Possible default locations:
<Application Data>\Identities\<GUID>\Microsoft\Outlook Express\
<Application Data>\Microsoft\Outlook Express\
<GUID> represents a Global Unique Identifier and looks similar to the following: {EC5E07AF-FD0F-4032AB71-B48918A73052}. The specific numbers and letters is different on every system.
Files to search for with Outlook Express 5.x and 6.x:
Inbox.dbx
Sent Items.dbx
Copyright 2005-2016 Fookes Holding Ltd
General Information
Deleted Items.dbx
Files to search for with Outlook Express 4.x:
Inbox.idx
Sent Items.idx
Deleted Items.idx
3. Windows Live Mail
Typical default location:
<Application Data>\Microsoft\Windows Live Mail\
Local mailbox files are stored under the "Storage Folders" subfolder.
File to search for:
Mail.MSMessageStore
4. Windows Mail
Typical default location:
<Application Data>\Microsoft\Windows Mail\
Local mailbox files are stored under the "Local Folders" subfolder.
File to search for:
winmail.fol
5. Qualcomm Eudora
Typical default location, Windows 10/8/7/Vista/XP/2000:
<Application Data>\Qualcomm\Eudora\
Typical default location, Windows 95/98/ME/NT:
<SYSTEMDRIVE>\Program Files\Qualcomm\Eudora\
Files to search for:
in.toc
Out.toc
Trash.toc
6. Thunderbird and Eudora OSE
Typical default location:
<Application Data>\Thunderbird\Profiles\default\<code>.slt\Mail\
Often the main account is stored under Mail\Local Folders\
Files to search for:
Inbox.msf
Sent.msf
Trash.msf
TIP: Here's a simple trick to find where any Thunderbird mail folder is stored...
Copyright 2005-2016 Fookes Holding Ltd
34
35
Aid4Mail 4 Help
Right click with your mouse on a folder name in Thunderbird to open the shortcut menu. In Thunderbird
version 3, choose Properties from the menu and then select and copy all the text in the Location field of
the Folder Properties dialog box. In Thunderbird version 2, choose the "Copy Folder Location" command
from the shortcut menu.
If you want to set Thunderbird as your source mail client, stop when you reach the Source Location
screen in Aid4Mail. Then right click in the folder field and choose the "Go to Folder" command from the
shortcut menu. Aid4Mail will automatically show the correct folder path in the dialog box.
If you want to set Thunderbird as your target mail client, stop when you reach the Target Settings screen
in Aid4Mail. Paste the Clipboard contents in the field labeled Folder. The resulting path will look
somewhat like this: "mailbox:///C:/Users/.../Mail/Local Folders/Inbox" or "mailbox:/C|/Documents and
Settings/.../Mail/Local Folders/Inbox". Once you click on the Next button, Aid4Mail will automatically
convert the path to the correct Windows format.
7. Mozilla Mail & Netscape 6.x, 7.x
Possible default location:
<Application Data>\Mozilla\Profiles\default\<code>.slt\Mail\
Files to search for:
Inbox.msf
Sent.msf
Trash.msf
8. Netscape Messenger
Possible default location:
<SYSTEMDRIVE>\Program Files\Netscape\Users\
Files to search for:
Inbox.snm
Sent.snm
Trash.snm
9. Pegasus Mail
Typical default locations:
<SYSTEMDRIVE>\PMAIL\MAIL
<SYSTEMDRIVE>\Program Files\PMAIL\MAIL
Files to search for:
*.pmi
*.pmm
10. PocoMail and Barca
Typical default location, Windows 10/8/7/Vista/XP/2000:
<Application Data>\PocoMail\Mail\
<Application Data>\Barca\Mail\
Typical default locations, Windows 95/98/ME/NT:
Copyright 2005-2016 Fookes Holding Ltd
General Information
<SYSTEMDRIVE>\Program Files\PocoMail\Mail\
<SYSTEMDRIVE>\Program Files\Barca\Mail\
Files to search for:
in.idx or in.idb
Out.idx or Out.idb
Trash.idx or Trash.idb
11. The Bat!
Typical default locations:
<Application Data>\The Bat!\
Typical default location:
<SYSTEMDRIVE>\Program Files\The Bat!\MAIL\
Files to search for:
MESSAGES.TBB
MESSAGES.TBX
12. Calypso Email
Typical default location:
<SYSTEMDRIVE>\Program Files\Calypso3\Mailbox\
Files to search for:
*.box
13. Courier Email
Typical default location:
<SYSTEMDRIVE>\Program Files\Courier\Mailbox\
Files to search for:
*.box
14. Opera Mail
Typical default locations:
<Application Data>\Opera\Opera\mail\store\
<SYSTEMDRIVE>\Program Files\Opera\Mail\storage\
Files to search for:
*.mbs
15. Forte Agent
Typical default location:
<SYSTEMDRIVE>\Program Files\Agent\Data\
Files to search for:
00000001.IDX
GROUPS.DAT
Copyright 2005-2016 Fookes Holding Ltd
36
37
Aid4Mail 4 Help
folders.dat
16. Foxmail
Typical default location:
<SYSTEMDRIVE>\Program Files\FoxMail\mail\
<SYSTEMDRIVE>\Users\<USER>\AppData\Local\Foxmail\Data\Boxes\
Files to search for:
in.BOX
sent.BOX
trash.BOX
17. PMMail
Typical default location:
<SYSTEMDRIVE>\Program Files\PMMail 2000\
Files to search for:
*.MSG
18. Evolution (under Ubuntu)
Typical default locations:
<SYSTEMDRIVE>\home\ubuntu\.local\share\evolution\mail\local\
<SYSTEMDRIVE>\home\<user>\.local\share\evolution\mail\local\
File to search for:
Inbox.
1.15
General Information
38
If you have a valid license for Aid4Mail version 1, you can benefit from a significant upgrade discount
when purchasing a corresponding license of version 3. Simply visit our upgrade page and enter either
one of your activation codes or your Plimus order number. Please note that you can only use this
upgrade discount once; it is not available for subsequent orders.
Q. Can I use a Purchase Order?
Purchase orders are only available to corporate customers and must use your official company
letterhead. You will receive the cleverbridge fax number in a later step. If you require immediate product
delivery, please use the credit card or PayPal payment option instead.
Q. I want to pay by wire transfer and need your bank details.
A. Select "Wire transfer" as payment option in the order form. After clicking the "Next" button, you will
be taken to a page with detailed instructions, including your order reference number and the bank details
for your payment.
Q. I have purchased an Aid4Mail license but still haven't received my activation code. When
will I get it?
A. All information regarding your order, including activation code(s), are sent to you via email usually
within minutes of your payment being accepted. However, sometimes these emails may be caught by
your "Spam Protection" tool, or may be automatically sent to your "Junk" folder. Please be sure to
check those locations if you do not receive the emails shortly.
In some cases, your email service may be experiencing a slowdown in email delivery delays of several
hours are possible in these situations. In other cases, your ISP may be blocking the emails before they
even reach your account. When this happens, the only solution is for you to provide an alternative
address to which we can send the registration emails.
Please contact us if the email with your activation code(s) hasn't reached you within minutes of your
completed order.
Q. How can I download Aid4Mail again?
A. Simply visit the Aid4Mail website to download the latest update.
Q. Why was my order was declined?
A. When the message "Credit card was declined" appears while processing an order it means that your
credit card bank has declined the transaction, usually a quick call to your credit card bank's customer
service will clarify most of the issues. If problems persist, please use a different payment option.
Q. What is your Refund Policy?
A. Please go to the Refund Policy topic in this document to find the answer to this question.
Q. What is your Upgrade Policy?
A. Maintenance releases, updates, and upgrades are free during the validity of your subscription period.
Renew before your annual subscription period runs out and benefit from a significant discount over the
regular price. You can also renew after your subscription expires, but the discount is smaller.
39
Aid4Mail 4 Help
General Information
40
When this happens, Aid4Mail may display the Activation screen instead of the Re-activation screen. If
this happens, wait 15 minutes or more and then repeat the activation procedure.
Q. I have forgotten my activation password. How do I retrieve it?
Single-user activation codes
A. If you can't remember your password, click on the "Forgot Password?" button in the Activation dialog
box, which appears on the screen after you enter your activation code. Your password will then be sent
to the email address you entered when you first activated your license. If the email doesn't reach you
within minutes, check your junk mailbox in case it was misidentified as spam.
Note that this feature will only work if you supplied your email address when you first activated your
license. If you chose not to provide an email address during activation, then it is your responsibility to
keep track of your current password.
Multi-user activation codes (Aid4Mail Professional Site)
A. The activation code password is accessible to the license administrator through the Softworkz
License Control Panel (LCP). Details on accessing the LCP are sent by email to the address entered on
activating the first seat of the site license.
Q. Why am I in "Lockout mode"?
A. Lockout mode usually occurs because you have attempted too many re-activations or too many
unsuccessful communications with the license server (e.g., because of failed password attempts) in the
allowed time period. Note that the Aid4Mail License Agreement allows the software to be moved from
an old computer to a new one that replaces it. However it does not allow a license to be re-activated on
a different computer or user account (e.g. Windows logon) in order to access another person's mail.
If you are in lockout mode because of too many re-activations, please read the Aid4Mail License
Agreement to ensure that you are complying to its terms.
Q. Will Aid4Mail activations still be possible if softWORKZ or Fookes Software suspends
service?
A. If softWORKZ or Fookes Software suspends service, customers will be able to download a patch that
bypasses the activation system or a special version of Aid4Mail that does not use any activation
system.
Q. Will you stop offering activations on products that are x years old?
A. No. Activations and re-activations will be available to all versions of our products during the validity of
your subscription period.
Q. Do hardware upgrades/new computers cause the previously activated software to stop
working?
A. No. License activation is not tied to your hardware. If you need to reinstall your software after
reformatting your hard drive or moving to a new computer, you just need to re-activate your software. Reactivation is a quick and simple method to get your software fully operational again. Note, however, that
the copy on your previous computer will revert to trial mode if you re-activate your code on another
computer.
Q. Aid4Mail will reside on computers that are not permitted access to the internet via our
Copyright 2005-2016 Fookes Holding Ltd
41
Aid4Mail 4 Help
firewall. Can you provide the port, IP-address of the verification server, and the domain in
which that server resides. This way we may permit outbound access to just the activation site
and port.
A. The following is the information that you need to setup your firewall:
Main server IP address: reg1.softworkz.com
Backup server IP: reg2.softworkz.com
Port: 80 (Standard HTTP)
Domain: softworkz.com
User agent: Aid4Mail (case sensitive)
or
C:\Documents and Settings\<user>\Application Data\Microsoft\Outlook Express\
<user> represents the name you use to log on to Windows. <GUID> represents a Global Unique
Identifier and looks similar to the following: {EC5E07AF-FD0F-4032-AB71-B48918A73052}. The specific
numbers and letters is different on every system.
You'll recognize the appropriate folder if you see the following files in it:
Inbox.dbx
Sent Items.dbx
Deleted Items.dbx
Once you've found the Outlook Express folder, copy all its contents to a USB flash drive. When that's
done, plug it in your new computer and select that folder in Aid4Mail for your source mail.
Finally, if you have Aid4Mail Professional, choose the "Email Profile" option under Office Outlook as your
target format. If you have the Aid4Mail Home license, you'll have to convert to a PST file instead (choose
your default profile PST file if you can, then you won't need to upload it into Outlook).
Q. Aid4Mail fails to convert some or all of my mailbox files. Why?
General Information
42
A. The most typical reason for such an issue is that your file is locked by another program. To avoid
this, and unless you are using Office Outlook, make sure you close your mail client before clicking on
the Start button in Aid4Mail. Check also that you haven't got an anti-virus or anti-spam program
monitoring the mail that Aid4Mail is processing. Other possible reasons include a source file that is
corrupted or does not correspond to the selected mail type, or the target location has insufficient free
space or is write protected. Sometimes it may help to compact your mail folders before processing them
with Aid4Mail.
Aid4Mail checks both the file extension and contents to see if they conform with the selected source
format. You can instruct Aid4Mail to be more "tolerant" with certain file types by turning off the Strict File
Format Check option or using the /m command-line switch. This can be useful with files that start with a
non-conforming format.
Q. Aid4Mail freezes during processing and the title bar shows (Not Responding). Is this a bug?
A. Probably not. Aid4Mail may appear to hang when it is trying to connect to a remote server (IMAP
account) or processing a very big email (typically a message with one or more huge attachments).
Depending on your processor speed, amount of available RAM, and source or target format (for example
Outlook), such a message may take as long as several hours to process.
If you encounter this situation, don't assume Aid4Mail has stopped working. Instead of terminating the
process, simply give it enough time to finish its job.
Q. Are there file size limits that need to be taken into account when exporting mail?
A. Yes. If you have a large amount of mail or many big attachments, the target file receiving your
messages can grow very big. Outlook 2003 and 2007 can store up to 20 GB of data in a single file using
the Unicode PST format, and Outlook 2010, 2013 and 2016 up to 50 GB. Older versions of Microsoft
Outlook create ANSI PST files that are limited to 2 GB in size (note that Aid4Mail cannot detect when
this size limit is reached). Note that the PST size limit may be set smaller through registry settings (see
this Microsoft Knowledge Base). Some email clients cannot read generic mailbox files that are bigger
than 4 GB. An Aid4Mail ZIP archive can easily exceed a size of 20 GB; in fact the maximum file size is
limited only by your system's resources.
Q. Why do I see my own email address instead of the recipient details after exporting my Sent
folder?
A. Most mail programs and webmail interfaces check the folder location of a message to determine
which field to use for the contact details. For mail stored in the default Sent folder, the recipient details
are taken from the email To, Cc, and Bcc fields. And for mail stored in any other folder, the sender
details are taken from the email From field. To correct this display issue, simply move your outgoing
emails to the default Sent folder.
Q. Can I run multiple instances of Aid4Mail?
A. Yes you can, as long as you don't attempt to convert mail to the same target file in different
instances.
Q. Are there ways to make Aid4Mail process emails faster?
A. Yes. If you are using anti-virus, anti-spam, Windows file indexing, archiving products, or any other
software/plugin that monitor email messages, turn them off temporarily when using Aid4Mail. Doing so
can significantly improve processing speed. You can also speed up processing by unchecking the "Do
Copyright 2005-2016 Fookes Holding Ltd
43
Aid4Mail 4 Help
not add duplicate messages" setting on the Export Options screen or, if you are running Aid4Mail
Console, avoid using the /SkipDups and /SkipAllDups command-line switches.
Aid4Mail does extensive text parsing and format analysis when reading generic mailbox files, including
those created by Mozilla Thunderbird and Eudora. It does so to ensure it doesn't miss any emails when
processing mailbox files that contain a mix of storage formats (e.g. a Mac or Unix mbox file imported in
Windows Thunderbird with new messages added to it). If you are processing mailbox files that are
entirely created by a single mail client, then you can increase performance without sacrificing reliability
by turning on the Fast Mail Processing option or using the /fast command-line switch.
With Outlook 2003 and more recent, Aid4Mail uses the internal MAPI converter to import/export mail
from Outlook PST and MSG files, and Exchange server stores. The advantage of this method is that it
converts messages with non-Latin characters and certain special email types more reliably than the
Aid4Mail method. The disadvantage of the internal MAPI converter is that it is usually slower than
Aid4Mail's conversion method. Uncheck the Use MAPI RFC 1521 Converter option or use the /
MapiConvOff command-line switch to turn off the internal MAPI converter and use Aid4Mail's faster
method instead. Example: Aid4Mail.exe /MapiConvOff
The two command-line switches mentioned above can be used together if necessary. Example:
Aid4Mail.exe /fast /MapiConvOff
Note that working on compacted or expunged mailbox files (i.e. those in which unpurged mail has been
removed) can also improve conversion speed significantly. If you are responsible for migrating mail
accounts in your company, you should encourage staff members to compact their mail folders before
you start processing their data with Aid4Mail.
Q. I have a huge mailbox file and Aid4Mail says it has no messages. Why?
A. Usually this happens when a mailbox file only contains deleted or moved messages (unpurged mail)
and has never (or not recently) been compacted or expunged. The file may also be corrupted or contain
data that does not match the selected source file type.
Also, certain proprietary file formats, like DBX files from Outlook Express and PST files from Office
Outlook, never have a size of zero bytes when empty and compacted.
Q. Is there an easy way to find where a Thunderbird mail folder is stored?
A. Yes there is. See the following instructions.
1) To find Local Folders:
Right click with your mouse on a local folder name in Thunderbird to open the shortcut menu. In recent
versions of Thunderbird, choose Properties from the menu and then select and copy all the text in the
Location field of the Folder Properties dialog box. In Thunderbird version 2, choose the "Copy Folder
Location" command from the shortcut menu.
If you want to set Thunderbird as your source mail client, stop when you reach the Source Location
screen in Aid4Mail. Then right click in the folder field and choose the "Go to Folder" command from the
shortcut menu. Aid4Mail will automatically show the correct folder path in the dialog box.
If you want to set Thunderbird as your target mail client, stop when you reach the Target Settings screen
in Aid4Mail. Paste the Clipboard contents in the field labeled Folder. The resulting path will look
somewhat like this: "mailbox:///C:/Users/.../Mail/Local Folders/Inbox" or "mailbox:/C|/Documents and
General Information
44
Settings/.../Mail/Local Folders/Inbox". Once you click on the Next button, Aid4Mail will automatically
convert the path to the correct Windows format.
45
Aid4Mail 4 Help
A. This issue is due to a bug in Internet Explorer. When you click on an attachment link in an MHT file
to save the document to disk, Internet Explorer displays an incorrect file name in the Save As dialog
box. You should replace it with a more meaningful name and especially add the appropriate file
extension. (Use the same extension as displayed in the attachment link.)
Q. After exporting my messages to a new mail client, I find that some of my attachments are
missing or failed to convert as expected. Why?
A. Some mail clients extract attachments and store them in a separate location from messages. This is
the case with Eudora and Calypso/Courier, as well as with The Bat!, PocoMail, and Barca, depending on
the settings you've chosen. These mail clients usually store the path and file name of extracted
attachments to maintain a link between the message and its files. Unfortunately, if you move the
attachments to another location, or the original drive is assigned another letter, then the link is lost.
Aid4Mail uses this link to find the attachments of the messages it processes. If it cannot find the
attachment, Aid4Mail still adds the file placeholder; instead of the file data Aid4Mail inserts the full name
of the file that was not found. Note that some programs may show an incorrect attachment size for
empty attachments, and even produce a "garbage" file on extraction.
Attachments that Aid4Mail doesn't find are listed in the error log file; see the Error Log File topic for
details.
There is, however, a way to instruct Aid4Mail where to look for attachment folders that have changed
location through a file called Tokens.ini. See instructions under the Fixing Attachment Folder References
topic.
Q. How does Aid4Mail detect duplicates?
A. Aid4Mail checks for email duplicates by comparing the value of the Message-ID field in each
processed email header. If this field is empty or missing (usually in outbound messages), Aid4Mail uses
other header data for the comparison. In MAPI messages (from Office Outlook and Microsoft Exchange),
Aid4Mail uses the email creation and submit dates, subject line, and stored message size. In other
types of messages, Aid4Mail uses the email date and subject line for the comparison, or other header
fields (To, Cc, Bcc, From delimiter) if either of those values are missing, or the whole header if none of
those fields contain any data.
When extracting attachments and other embedded contents, Aid4Mail first checks if a file with the same
name exists in the target folder. If there is, it checks whether the contents are identical. If they are, the
duplicate is not saved. If the files are different, then Aid4Mail saves the file with a new name the
original file name followed by an index number in square brackets. Example:
Untitled.doc
Untitled[1].doc
Untitled[2].doc
Q. Sometimes my source email client reports more and sometimes less messages than the
target email client. How am I gaining messages or loosing mail during the conversion? Why
doesn't the message count of the email clients always equal each other?
A. There are a few reasons that this can happen. First, you may have the options to remove duplicates
and/or ignore deleted mail checked which would result in fewer message in the target mailbox. Your
source email client may have duplicated messages in its mailboxes causing the mismatch of the email
message count. Secondly, some mailboxes get corrupted at the place which marks the start of the next
message (the email delimiter) in the mailbox. If that line is corrupt, the next message in the mailbox
Copyright 2005-2016 Fookes Holding Ltd
General Information
46
may be considered part of the previous message causing less total messages. Thirdly, the index file
(such as *.idx, *.toc) may be corrupt causing the mismatch of email messages. Lastly, Aid4Mail
attempts to correct some corrupted mailboxes which often also causes an email message count
difference.
Q. Some of my message status flags, the icons in the index message grid, that are in the
source email client do not show up in the target email client and some are different. Are these
bugs?
A. There are at least two reasons for status indicators (such as: read, unread, replied, forwarded,
redirected, and priorities) not to get converted or what appears to be the wrong icons displaying in the
target email client. All status flags are not all supported in all email programs, therefore, some may not
show up in the target email client. We also found that some email clients have glitches in them that
cause incorrect status icons to be displayed in their own program. Aid4Mail converts the correct data
found in the email client's index file (or mailbox) where the status information is stored to the target email
client that displays them correctly which causes the discrepancy in the two. Aid4Mail does not convert
email messages based on the status icon displayed, nor does it make the target email client display the
same wrong status icon/indicator.
If you feel that the problem you see is within Aid4Mail, and not the email client, please contact us and
explain to us the problem you are experiencing. We may then ask you to send us a sample mailbox file
or messages if the need arises.
Q. When exporting messages to put on a CD-ROM you recommend using the MD5 file naming
option to limit the length of file names and avoid name conflicts. However, sometimes I like to
open specific MHT email files or EML email messages. It's difficult to do so with the
meaningless MD5 names (mixed letters and numbers). How can I locate the messages I want to
open in a text editor?
A. This is not as hard to do as you might think. Your text editor might have a feature to search for words/
phrases in disk files without the need to open the files into a text editor first. Our award winning NoteTab
text and HTML editor has such a feature called Search Disk that will find the search criteria in the
messages that contain it and open each message(s) (of choice) in its own tab. You can then simply use
the Find dialog (Ctrl+F) and quickly bring the tab in focus at the word(s) searched for. NoteTab is
available in free and commercial versions.
Q. When making EML, MHT, and MSG message files and the "Subject:" of the message is used
as the file name. Some of the characters are changed? Why is this?
A. Windows does not allow certain characters in file names such as: / ? | * : < >. Aid4Mail converts the
"Subject:" lines that have those characters in them to legal file name characters before processing the
mailbox(es) into EML, MHT, and MSG files. Character conversion can be customized through a
specialized template file called NameFilter.dat. Open the file NameFilter.txt for instructions and a
working example.
Q. My PocoMail "Special mailboxes" contain messages, but Aid4Mail does not process them.
Why is this?
A. Your PocoMail email client's "Special mailboxes" are a type of virtual mailboxes. The messages are
not in that folder. It just has an appearance of the messages. The "messages" act sort of like a
shortcuts so that when you see the messages in the index grid and click on one, it is actually opening
the message from another PocoMail mailbox. If you convert all your mailboxes, the messages will
indeed be processed! If you know which mailbox(es) they are actually stored in, you can process it and
Copyright 2005-2016 Fookes Holding Ltd
47
Aid4Mail 4 Help
Outlook for Windows is not installed on your system. See the System Requirements topic for free
solutions.
2. You are using the 64-bit version of Outlook 2010, 2013 or 2016: Download and install the separate
edition of Aid4Mail for Outlook 64-bit to fix this issue (Please contact us if you need help).
3. You have an Outlook 2010 Click-to-Run installation. Re-install without the Click-to-Run method if
available.
4. You are trying to access a Unicode PST file with a MAPI system that does not support the new
format.
5. You are trying to access a mail store that is write protected or has limited access rights.
6. You have Outlook 98/2000 installed in Internet Mail Only Mode (IMO). Re-install in Corporate/
WorkGroup mode.
7. The MAPI profile details you provided were incorrect.
8. You have installed Outlook but have not yet configured a default mail account.
9. Your mail is on a remote computer that is not accessible.
10. The mail file is empty.
11. A third-party utility is interfering with Aid4Mail (synchronization software, backup, anti-virus, etc.).
If your version of Microsoft Outlook is older than Outlook 2003, this issue may occur because your copy
of Outlook is not the default email client. In that case, see if temporarily setting it as the default client
fixes the issue and restart Aid4Mail. To change the default email client, open the Internet Properties
General Information
48
dialog box. (This can be done either by right-clicking on the Internet Explorer program shortcut and
selecting "Properties", or by opening Internet Explorer and selecting "Internet Options" from the "Tools"
menu.) Then select the Programs tab, and select the "Microsoft Office Outlook" value in the field
labeled E-mail.
If none of the above applies, see if rebooting your computer fixes the issue.
Q. When I select a source MAPI profile or PST file, those options are not available on the
Target Format screen. Why?
A. Unlike Aid4Mail Console, the current GUI version of Aid4Mail cannot export a source MAPI profile or
PST file to a target MAPI profile or PST file the workaround is to first export your emails to the Outlook
MSG format, and then re-export those files to your target format.
Q. Why do some messages exported from Outlook have email addresses in the X.400 format
instead of SMTP?
A. If your Outlook source mail has addresses in the X.400 addressing format (e.g. /o=Fookes software/
ou=fs/cn=recipients/cn=customer support), Aid4Mail will try to convert them to the regular SMTP format
(e.g. support@fookes.com). To do so, Aid4Mail searches through all your address books (as listed in
the Addressing configuration of your Outlook profile) for a case-insensitive exact match of the X.400
address. The X.400 to SMTP conversion fails if there is no match or if the matching contact item does
not have a corresponding email address in SMTP format.
If your mail source is a PST file, Aid4Mail can only search contact items in the local address book. If the
information necessary for the X.400 to SMTP conversion is stored in an external list (GAL or other
directory service), then first create an Outlook profile that is connected to your directory service (use
LDAP to connect your GAL). Next, add your PST file to the profile and set it as the default store. Finally,
in Aid4Mail choose the Email Profile option instead of the PST file as your Mail Source.
Note that X.400 to SMTP conversion is limited to outgoing source messages (usually stored in the Sent
Items folder). With incoming messages, Aid4Mail restores the original SMTP email header which
normally never has email addresses in the X.400 format.
Q. I have a damaged/corrupted PST file. Can Aid4Mail process it?
A. The only way to find out is to try. If it doesn't work, you could try one of the following Microsoft tools
to repair your PST file:
How to use the Inbox Repair Tools to recover e-mail messages in Outlook 2010, 2007, 2003 and 2002
(scanpst.exe):
http://support.microsoft.com/kb/287497/
Oversized PST and OST crop tool (Pst2gb.exe):
http://support.microsoft.com/kb/q296088
Q. Why do I get an "Error creating PST file" message?
A. If you are using Outlook 2010, 2013 or 2016, check whether you have the 32 or 64-bit version
installed. The regular version of Aid4Mail only supports the 32-bit version, but we have a separate edition
that you can download and install for Outlook 64-bit support. Note also that Click-to-Run installations of
Outlook 2010 are not supported. If your version of Microsoft Outlook is older than Outlook 2003, this
issue may occur because your copy of Outlook is not the default email client. In that case, see if
Copyright 2005-2016 Fookes Holding Ltd
49
Aid4Mail 4 Help
temporarily setting it as the default client fixes the issue and restart Aid4Mail. To change the default
email client, open the Internet Properties dialog box. (This can be done either by right-clicking on the
Internet Explorer program shortcut and selecting "Properties", or by opening Internet Explorer and
selecting "Internet Options" from the "Tools" menu.) Then select the Programs tab, and select the
"Microsoft Office Outlook" value in the field labeled E-mail.
If the above doesn't apply, see if rebooting your computer fixes the issue.
Q. With Outlook 2007 SP2, why do I get an error in "Module mspst32.dll"?
A. The error occurs when you use Aid4Mail to convert mail to a new PST file. This issue only occurs
with Microsoft Office 2007 Service Pack 2. It appears modifications made in Office 2007 SP2 affect
features that worked unchanged since Outlook 97. Microsoft have now fixed the problem so the solution
is to update to the latest maintenance release of Office 2007 SP2. If for any reason this is not possible,
a workaround in Aid4Mail is to convert mail to an existing MAPI profile instead of a new PST file.
Q. What could cause an "Error adding new message to store" message?
A. The error may be triggered by a break in your network connection. For example when converting mail
to a mapped drive using a wireless connection that times out.
Q. Why do I get an "Error creating MAPI subfolder" message?
A. Your source mail folders may contain characters or a format that MAPI cannot use when creating
target folder names. However, we have found that with some versions of Outlook the problem disappears
after rebooting the computer. If this does not help, try renaming the source mail folder that is causing the
problem.
Q. Why do I get an "Error processing email" message?
A. This error may be triggered by different types of problems. It can occur when your default email client
is set to a program that does not support Extended MAPI. If that is the case, go to the Internet Explorer
Properties and select the Programs tab; then select "Microsoft Office Outlook" or ExchangeMAPI in the
E-mail field.
Q. How do I display my Aid4Mail created PST files in Microsoft Outlook?
A. You can open PST files through the File/Open/Outlook Data File menu command in Microsoft
Outlook. Older versions of Outlook may use slightly different names for the menu command. Note that
Unicode PST files created with Outlook 2003, 2007, 2010, 2013 and 2016 cannot be opened with an
older version of Outlook.
Q. Why is Microsoft Outlook showing wrong dates/contact names in the Folder Pane?
A. By default, Microsoft Outlook displays the Sent date and the contact name from the To field for
messages in the Sent Items folder, and the server Received date and the contact name from the From
field for messages in other folders. As a result, you may see unexpected dates and names in the Folder
Pane for imported "outgoing emails" that are not saved in the Sent Items folder.
To correct this display issue, simply move those outgoing emails to the Sent Items folder. The quickest
way to do this is press the Ctrl+A keyboard shortcut to select all the messages in a folder, then use the
Ctrl+Shift+V keyboard shortcut to open the Move to Folder dialog box, and then select the Sent Items
folder in the list.
Copyright 2005-2016 Fookes Holding Ltd
General Information
50
Q. I have Office Outlook installed in Internet Mail Only mode (IMO). Is it supported by Aid4Mail?
A. The MAPI subsystem installed in the Internet Mail Only mode (only exists in Outlook 98/2000) is a
stub that provides minimal MAPI support for the basic functionality of Office Outlook, and may not work
properly with Aid4Mail. When using Office Outlook 98 and 2000, it must be installed in Corporate/
WorkGroup mode to ensure full compatibility with Aid4Mail. Instructions for changing Outlook 2000
mode are available on Microsoft's website.
How to tell which setup option you have: In Outlook on the Help menu, click About Microsoft Outlook.
Next, look at the second line of text in the About Microsoft Outlook dialog box. If it shows "Corporate or
Workgroup", then you have a fully working version of Outlook with Extended MAPI installed.
Q. Are there ways to make Aid4Mail process emails faster?
A. Yes. If you are using anti-virus, anti-spam, Windows file indexing, archiving products, or any other
software/plugin that monitor email messages, turn them off temporarily when using Aid4Mail. Doing so
can significantly improve processing speed. You can also speed up processing by unchecking the "Do
not add duplicate messages" setting on the Export Options screen or, if you are running Aid4Mail
Console, avoid using the /SkipDups and /SkipAllDups command-line switches.
Aid4Mail does extensive text parsing and format analysis when reading generic mailbox files, including
those created by Mozilla Thunderbird and Eudora. It does so to ensure it doesn't miss any emails when
processing mailbox files that contain a mix of storage formats (e.g. a Mac or Unix mbox file imported in
Windows Thunderbird with new messages added to it). If you are processing mailbox files that are
entirely created by a single mail client, then you can increase performance without sacrificing reliability
by turning on the Fast Mail Processing option or using the /fast command-line switch.
With Outlook 2003 and more recent, Aid4Mail uses the internal MAPI converter to import/export mail
from Outlook PST and MSG files, and Exchange server stores. The advantage of this method is that it
converts messages with non-Latin characters and certain special email types more reliably than the
Aid4Mail method. The disadvantage of the internal MAPI converter is that it is usually slower than
Aid4Mail's conversion method. Uncheck the Use MAPI RFC 1521 Converter option or use the /
MapiConvOff command-line switch to turn off the internal MAPI converter and use Aid4Mail's faster
method instead. Example: Aid4Mail.exe /MapiConvOff
The two command-line switches mentioned above can be used together if necessary. Example:
Aid4Mail.exe /fast /MapiConvOff
Note that working on compacted or expunged mailbox files (i.e. those in which unpurged mail has been
removed) can also improve conversion speed significantly. If you are responsible for migrating mail
accounts in your company, you should encourage staff members to compact their mail folders before
you start processing their data with Aid4Mail.
Q. How do I check what type (ANSI or Unicode) of PST I have?
A. Open the PST file in Outlook. If your version of Outlook is older than Outlook 2003, then it will not be
able to open a Unicode PST. If you are using Outlook 2003 or a later version then select the root folder of
the PST file, in the Outlook Mail list column. Right-click on the folder, and choose Properties from the
menu. From the Properties dialog box, click on the Advanced button to open the Personal Folders dialog
box. This contains a field called Format. If it shows "Personal Folders File (97-2002)", then the file is an
ANSI PST, otherwise it is a Unicode PST.
51
Aid4Mail 4 Help
Q. My mail is stored on an IMAP server, which Office Outlook connects to. Why is Aid4Mail only
exporting message headers?
A. You need to configure Outlook to download the complete email, not just the header. To make the
change, you must open the Send/Receive Settings dialog box in Outlook, select your IMAP account,
and then select "Download complete item including attachments" in the Folder Options section. Once
you've done that, Aid4Mail should be fetching the whole email.
To reach the Send/Receive Settings dialog box, you must first open the Send/Receive Groups dialog box
using the Ctrl+Alt+S keyboard shortcut, or the following menu command: Tools -> Send/Receive ->
Send/Receive Settings -> Define Send/Receive Groups..., then click on the Edit button.
Q. Are there known issues when processing Microsoft Outlook PST files or MAPI profiles?
A. Outlook 2010 had a serious bug that caused data loss in source messages processed with the MAPI
RFC 1521 Converter. Original SMTP headers were replaced with a simplified version. For most users the
effects of this bug are not noticeable, or at most a minor inconvenience. However, for those working in
the field of e-discovery and forensic examination such loss of data is unacceptable. We recommend that
you download and install the latest maintenance release for Outlook 2010.
Aid4Mail does not work with Click-to-Run installations of the Outlook 2010.
Outlook does not support email messages with invalid information (for example with a malformed email
address). Unfortunately, Aid4Mail does not receive an error message from Outlook when it fails to import
such emails. The only way to find out whether an email is not supported by Outlook is by displaying it.
You will see a text like the following in the message body: "This message was not processed because it
contains an invalid recipient."
Outlook versions prior to Outlook 2003 cannot process Unicode PST and MSG files. Aid4Mail will give
an error message when you try to open a Unicode PST file with a MAPI version that does not support it.
Unfortunately, there is no such warning with Unicode MSG files. Aid4Mail will appear to process them
correctly, but a large part of the original email header fails to convert.
To reliably export mail into a PST file or MAPI profile, we recommend that you turn on the MAPI RFC
1521 Converter option (default setting) and avoid using a version of Outlook older than 2003. Outlook
calendar and contact items are only fully preserved when converting them between Outlook formats
(PST, MSG, and MAPI profiles). Exporting such items to EML or mbox formats will produce incomplete
data that is of little use.
TNEF emails are a proprietary format used by Microsoft Outlook and Exchange. They are created when
Outlook is configured to compose messages in Rich Text (RTF) instead of HTML or Plain Text.
Unfortunately this proprietary format rarely converts well to a standards-compliant email format that all
modern mail clients can display correctly. Aid4Mail offers several advanced options to control how TNEF
emails are converted. Under default settings, Aid4Mail saves RTF text as a file attachment which can be
viewed in Windows Wordpad or Microsoft Word.
The current version of Aid4Mail does not support folder and file names with Unicode characters. Any
such character that doesn't translate to the ANSI character set will be replaced with a substitution
character.
The MAPI subsystem installed in the Internet Mail Only mode (IMO; Outlook 98/2000) is a stub that
provides minimal MAPI support for the basic functionality of Office Outlook, and might not work properly
with Aid4Mail. How to tell which setup option you have: in Outlook 98/2000 on the Help menu, click
Copyright 2005-2016 Fookes Holding Ltd
General Information
52
About Microsoft Outlook. Next, look at the second line of text in the About Microsoft Outlook dialog box.
If it shows "Corporate or Workgroup", then you have a fully working version of Outlook with Extended
MAPI installed.
The following applies only if you are using a version of Outlook that is older than Outlook 2003, or when
unchecking the Use MAPI RFC 1521 Converter option or using the /MapiConvOff command-line switch:
Importing a PST file created with this method into Outlook may result in loss of data or formatting. We
recommend that you open the PST file in Outlook instead of using the import command.
Another issue may occur when you attempt to process messages with text that is written in a non-Latin
character set (like Cyrillic and Chinese). Converting such messages to or from Microsoft Outlook may
produce unexpected results. Furthermore, MAPI does not support Unicode attachment file names so
Aid4Mail cannot restore the correct name for such files.
53
Aid4Mail 4 Help
Windows. You can also copy your Apple Mail folders and files to a CD, DVD, or USB flash drive, which
Aid4Mail can then access from your Windows computer. Aid4Mail can read the MBOX files created by
Apple Mail 1 (that comes with Mac OS X 10.0 to 10.3) if that is the format you have, use the "Generic
mailboxes" mail source option under the "Generic Mailbox Format" section in Aid4Mail. Later versions of
Apple Mail (starting with version 2) store their messages in EMLX format. To migrate those messages,
use the "Apple Mail message files" Mail Source option under the "Popular mail clients" section in
Aid4Mail.
To migrate your Windows email messages to Apple Mail, run Aid4Mail on your Windows computer and
convert your mail to the "Generic mailboxes" format, which is listed under the "Generic formats" section
on the Target Format screen in Aid4Mail. We recommend that you set the "File name" field on the
Target Settings screen to "*.MBOX" (without the quotes), and set the "Target Line Format" option to
"Macintosh (CR)". You will then have to transfer the mbox files created by Aid4Mail to your Mac system,
and use the Apple Mail import command to copy your emails into it.
Q. Does Aid4Mail support Microsoft Outlook for Mac?
A. Aid4Mail can only process Outlook PST and MSG files on a system running Outlook for Windows.
PST files from Outlook 8.x for Mac are not supported as they use a format that is incompatible with
Outlook for Windows. Outlook 2001 and 2011 for Mac can read PST files created by Outlook for
Windows. So if you have access to a Windows system, you can use Aid4Mail to export your mail to a
PST file, and then import the PST file into your Outlook for Mac mail store.
Q. Does Aid4Mail support Microsoft Entourage?
A. Aid4Mail does not process Microsoft Entourage's native mail database stores, but it does handle the
MBOX file format that Entourage supports.
If you want to migrate your Entourage mail to a Windows email program, first convert your Entourage
mail folders to MBOX files. The simplest way to do this is to drag each folder of messages to the Mac
desktop. Entourage will automatically create an MBOX file for each folder you drag-and drop to the
desktop. Next, you will have to transfer your MBOX files from Mac to Windows. You can also copy your
MBOX files to a CD, DVD, or thumb drive, which Aid4Mail can then access from your Windows
computer. Use the "Generic mailboxes" mail source option under the "Generic Mailbox Format" section
in Aid4Mail to select your MBOX files and then choose the appropriate target email format when you
reach the Target Format screen.
To migrate your Windows email messages to Microsoft Entourage, run Aid4Mail on your Windows
computer and convert your mail to the "Generic mailboxes" format, which is listed under the "Generic
formats" section on the Target Format screen in Aid4Mail. We recommend that you set the "File name"
field on the Target Settings screen to "*.MBOX" (without the quotes), and set the "Target Line Format"
option to "Macintosh (CR)". You will then have to transfer the mbox files created by Aid4Mail to your
Mac system. Then either use the Entourage import command to copy your emails into it (File / Import /
Contacts or Messages from a text file / Import messages from an MBOX-format text file), or drag-anddrop the MBOX files to the Entourage folder window.
Q. Does Aid4Mail support Eudora for Macintosh (Mac Eudora)?
A. Aid4Mail can process and export mail from Mac Eudora mailbox files, but it cannot create Eudora
mailbox files. Since Aid4Mail is a Windows application, it will only run on Intel-based Macs that are
running Windows or Wine, and on PowerPC Macs using Virtual PC. We recommend that you run
Aid4Mail on a Windows system as it will process mail much faster that way.
General Information
54
To migrate your Mac Eudora messages to a Windows email program, first transfer your files from Mac to
Windows. You can also copy your Mac Eudora mailbox files to a CD, DVD, or thumb drive, which
Aid4Mail can then access from your Windows computer. Use the "Mac Eudora" mail source option
under the "Eudora" section in Aid4Mail to select your mailbox files and then choose the appropriate
target email format when you reach the Target Format screen.
Aid4Mail expects to find the mailbox files under the "Mail Folder" folder, attachments in the
"Attachments Folder" folder, and embedded contents in the "Parts Folder" folder. All three folders share
the same parent folder. If your attachment and embedded contents files are in a different location, see
the instructions under the Fixing Attachment Folder References topic.
Reference Information
2.1
Program Interface
Aid4Mail is based on a user-friendly wizard interface, which is also designed with accessibility in mind.
The wizard helps you adjust program settings step-by-step so that you can process your mail to the
desired format and location. The wizard screens are divided into three parts. The top of the program
window displays an information area that provides a short explanation about the current screen. The
bottom part of the screen includes the navigation buttons (Back, Next) and the status bar. The middle
part of the screen contains all the settings instructing Aid4Mail how to handle your mail.
Note that grayed controls, menu items, fields, and buttons indicate they are not available for use in the
current context.
Aid4Mail Buttons
Software
Click on the button to open a drop-down menu with commands to check for software updates, visit the
Aid4Mail website, and a variety of useful options to control the behavior of Aid4Mail and email
conversions. See the Software Button Menu topic for more details.
Back
Use this button to move to the previous screen.
Next
Use this button to move to the next screen. This button may be disabled if your settings are incomplete.
Start
Click on the Start button to begin processing your mail.
Cancel
Use this button to quit the Aid4Mail program, or cancel the current operation like mail processing or a
file download in the "News and Updates" screen.
Help
Click to open the Help window.
Wizard Screens
1. Mail Source
Copyright 2005-2016 Fookes Holding Ltd
55
Aid4Mail 4 Help
2. Source Location
3. MAPI Store
4. Source MAPI Folders
5. Source IMAP Folders
6. Filter Options
7. Target Format
8. Target Settings
9. Target MAPI Folder
10. Target IMAP Folder
11. Export Options
12. Start Processing Mail
2.2
Accessibility Mode
Aid4Mail has been developed with accessibility in mind. All program features are accessible through the
keyboard. Furthermore, Aid4Mail detects whether Windows is set to High Contrast mode and whether a
screen reader is running. In these situations, Aid4Mail starts up in a special Accessibility Mode that
affects the display of menus as well as the selection of the first control receiving input focus when the
wizard screen changes or a dialog is opened. The text "Accessibility Mode" appears in the program title
bar when it is turned on.
Aid4Mail includes configuration files for the three most popular screen readers: Dolphin Hal, JAWS for
Windows, and Window-Eyes. These files improve recognition of Aid4Mail user-interface elements and
can be installed to the appropriate location by running Aid4Mail with the following command-line
parameter:
Aid4Mail.exe /acc=install
Note that you may have to restart your screen reader to have it pick up the installed configuration file.
If for some reason, Aid4Mail does not set itself in Accessibility Mode, or if you wish to turn it off, use
the /acc command-line switch to turn it on or off. Example:
Aid4Mail.exe /acc=on
Aid4Mail.exe /acc=off
Reference Information
2.3
Wizard Screens
2.3.1
1. Mail Source
56
The Mail Source screen lets you choose the type of mail you want to process. The list is subdivided into
categories of related formats. You must choose an item from one of the highlighted categories before
you can proceed to the next screen. Unless you are using Office Outlook, you should close your mail
client if it is connected to the source emails you plan to process.
With some mail clients, you have a choice between accessing index files or mailbox files. Whenever
possible, always choose the index files. Processing these is usually faster and more information can be
extracted from emails, like status details (unread, read, replied, etc.) Furthermore, deleted mail that is
no longer listed in the index files is skipped during processing. Use mailbox files if the corresponding
index files are corrupted, missing, or if you want to retrieve all mail including deleted messages. See the
topic Information About Mail Formats for details about the different formats that Aid4Mail can process.
Are you using Outlook as your mail source? If so, you'll need a compatible version of Outlook installed
on your system. Furthermore, note that the regular version of Aid4Mail does not support the 64-bit
versions of Office Outlook 2010, 2013 or 2016; we have a separate edition of Aid4Mail for Outlook 64-bit.
Note that Aid4Mail is not be compatible with Click-to-Run installations of Outlook 2010; you will need to
re-install Outlook 2010 using another method following Microsofts instructions.
Are you using Eudora OSE? If so, select Mozilla Thunderbird as your source mail. Eudora OSE is
basically a skin operating on top of Thunderbird.
Set the option "Include mail in trash" if you also want to process mail in the Trash, Junk, and Deleted
Items folders. The names of such folders are stored in the files TrashFiles.dat and TrashFolders.dat that
you will find in the Aid4Mail program folder. You can add more folder names to these two files if
necessary (one name per line). The TrashFolders.dat file is for message folder names created by MAPI
clients like Office Outlook. Aid4Mail uses the names stored in TrashFiles.dat to determine which
mailbox files from other mail clients contain deleted or unwanted messages.
An option labeled "Include unpurged mail" is displayed if you are running Aid4Mail eDiscovery. When
available and checked, Aid4Mail will process moved and deleted items found in mailbox files and folders
that haven't been compacted or expunged. These email items are not usually visible in your mail client.
Note that if you use this option with Outlook Express .dbx files, processed messages all have a certain
degree of corruption as the deletion process partially damages the remaining email. By default, Aid4Mail
skips messages that have been marked as removed from a mailbox. Currently, Aid4Mail cannot extract
these type of messages from Microsoft Outlook.
Another option that is only available in the eDiscovery edition is "Restore unpurged mail". It is available
when the "Include unpurged mail" option is checked. When this feature is used, Aid4Mail removes the
Deleted status flag during export from messages that have been marked as deleted (and hidden by the
mail client) but not yet removed from the mailbox file. Once a mailbox file has been compacted by the
mail client, all hidden deleted messages are definitely lost unless a copy remains in the trash folder.
Set the "Search for mail location" option to let Aid4Mail search for the default folder containing your mail.
This option is only available for some mail formats. Some mail clients make it very difficult to correctly
identify the location of their default mail files, so this feature might not always work properly. When the
search fails, you will have to browse through your drives to find the correct location. You can contact us
if you need help to find where your mail is stored.
57
Aid4Mail 4 Help
If available, use the "Profile name" field to help refine the search for the location of your mail. With
Outlook Express, the profile name is equivalent to your identity name. With Mozilla Mail and
Thunderbird, storage of profile details is different in older versions and its retrieval may be less reliable.
With Foxmail and PMMail, the profile name is treated by Aid4Mail as corresponding to the subfolder
name containing your mail.
The current version of Aid4Mail cannot extract email status information (unread, read, replied, etc.) from
messages stored in Windows Mail, Windows Live Mail, Mac Eudora, Entourage, Opera Mail, Forte
Agent, PMMail, FoxMail, Calypso and Courier.
Note that working on compacted or expunged mailbox files (unpurged mail has been removed) can
improve conversion speed significantly. If you are responsible for migrating mail accounts in your
company, you could encourage staff members to compact their mail folders before you start processing
their data with Aid4Mail. Please see the General Aid4Mail FAQ topic for more tips on speeding up
Aid4Mail.
2.3.2
2. Source Location
This screen is displayed for all mail source types except IMAP and MAPI profiles. Use it to select the
mail folders and/or files your want to process. See the topic Finding Mail Folders if you need help to find
the location of your mail. For most file types, Aid4Mail only lists files that contain email messages;
empty files or files that do not correspond to the selected mail source are not displayed in this screen.
For most mail source types you can select one or more folders and files. Hold down the Ctrl key and
click on names to select multiple files/folders. Hold down the Shift key to select a range of names, and
press Ctrl+A to select all listed names. Aid4Mail can only process one PST (Office Outlook) or ZIP
(Aid4Mail archives) file at a time, so if this is your mail source type you can only select one file name
before continuing to the next screen.
Set the option "Include subfolders" if you want to process all the mail files in and under the current
folder. If this setting is unchecked, only the mail files directly under the selected folders will be
processed; their subfolders and contents will be ignored.
If you select a password-protected PST file, make sure you enter the password in the corresponding
field. Otherwise Outlook will prompt you for the password whenever Aid4Mail needs to access its
contents (usually once when it displays the folder hierarchy and once just before starting email
processing).
Navigating folders with the mouse can be quite laborious depending on where your source files are. If you
know where to find your files, right click with your mouse in the folder/file list window to open a context
menu that gives you access to a folder or file name input dialog box. You can then paste or type a folder
or file name. If you do not specify a fully qualified name, Aid4Mail searches the location relative to the
current folder. Aid4Mail recognizes "shorthand" tokens used in the path name; see the Useful Tokens
and System Variables topic for more details. The following example will select the file Test.pst in the
Office Outlook data folder: %Outlook%\Test.pst
TIP: Here's a simple trick to find where any Thunderbird mail folder is stored...
Right click with your mouse on a folder name in Thunderbird to open the shortcut menu. In Thunderbird
version 3, choose Properties from the menu and then select and copy all the text in the Location field of
Reference Information
58
the Folder Properties dialog box. In Thunderbird version 2, choose the "Copy Folder Location" command
from the shortcut menu. When you reach the Source Location screen in Aid4Mail, right click in the folder
field and choose the "Go to specific folder" command from the shortcut menu. Aid4Mail will then
automatically show the real folder path in the dialog box.
2.3.3
3. MAPI Store
This screen is only displayed if you have chosen the Email Profile (Office Outlook & Microsoft
Exchange) Mail Source option. Choose from the drop-down list the mail profile to process. Aid4Mail will
display the folders of default store connected to the chosen profile.
Office Outlook will prompt you for a profile password if required to access the mail account.
2.3.4
You are using the 64-bit version of Outlook 2010, 2013 or 2016. Download and install the separate
edition of Aid4Mail for Outlook 64-bit support.
2. You have an Outlook 2010 Click-to-Run installation. Re-install without the Click-to-Run method if
available.
3. You are trying to access a Unicode PST file with a MAPI system that does not support the new
format.
4. You are trying to access a mail store that is write protected or has limited access rights.
5. You have Outlook 98/2000 installed in Internet Mail Only Mode (IMO). Re-install in Corporate/
WorkGroup mode.
6. The MAPI profile details you provided were incorrect.
7. You have installed Outlook but have not yet configured a default mail account.
8. Your mail is on a remote computer that is not accessible.
9. The mail file is empty.
10. A third-party utility is interfering with Aid4Mail (synchronization software, backup, anti-virus, etc.).
Note that Aid4Mail requires a fully functioning Extended MAPI system in order to access MAPI folders.
Extended MAPI is not available if you have Microsoft Outlook 2010 installed through the Click-to-Run
method or Outlook 98/2000 installed in the Internet Only Mode (IMO).
Outlook mail stores may also contain items that are not email messages, like appointments, contacts,
and tasks. You can instruct Aid4Mail to skip those items by setting the "Process only email messages"
option.
2.3.5
59
Aid4Mail 4 Help
deleted mail). Uncheck the mail folders you do not want to process. You can check/uncheck a whole
tree branch by holding down the Ctrl key while you click in a checkbox.
Processing mail from an IMAP server is considerably slower that processing mail on a local disk drive. If
you have a large volume of mail to download, make sure your connection to the internet is as good as
can be (avoid Wi-Fi unless you have a constant strong signal) and choose a time of the day when there
is less internet traffic.
Note that Aid4Mail uses the backslash character (\) as a folder name delimiter. As a result, it cannot
handle an IMAP folder name that contains a backslash character. In most cases, IMAP servers don't
allow the creation of such folder names so this issue is very rarely encountered. If you do have a folder
name with a backslash character, please rename it temporarily prior to exporting it with Aid4Mail.
Beware! Gmail enforces daily bandwidth limits. As of this writing, you can download up to 2,500 MB of
email per day.
See the IMAP Settings topic for more details.
2.3.6
6. Filter Options
Note that this screen is not available in the Aid4Mail Home edition.
2004/01/01
2004/12/31
Mail Received
In the following example, Aid4Mail will only process emails that were received after year 2004:
Ignore if older than:
Ignore if newer than:
2005/01/01
<blank>
Reference Information
Date to check:
60
Mail Received
In the following example, Aid4Mail will only process emails that were sent before year 2004:
Ignore if older than:
Ignore if newer than:
Date to check:
<blank>
2003/12/31
Mail Sent
61
Aid4Mail 4 Help
You can combine a Mail by Content filter with a Mail by Date filter to refine your selection of messages.
Matching Words with Wildcards
Aid4Mail also supports wildcards and regular expressions in the word list feature. The regular expression
engine is based on PCRE 8.38 (www.pcre.org). Its syntax is documented in the Regex.chm Help file.
A line with *, #, ?, &, ~ wildcard characters will be treated as a wildcard search unless the line starts
with "N=" or "R=" (without the quotes). The following wildcards are supported:
*
matches 0 or more word characters. Example: "jo*" matches "Jo", "John", "Jody", "joint", "join_leave".
#
matches 0 or more word characters, including HTML entity characters. Example: "na#" matches "nave",
"naïve", and "naïve".
**
matches 0 or more characters and can span across words within a line. Example: "click**link" matches
"click link", "click on link", "clicking on link", "Click on this link", but not "click on links".
?
matches exactly one word character. Example: "jo?" matches "Job" and "jot", but not "Jo", "John",
"Jody", and "joint".
~
matches 0 or one word characters. Example: "jo~" matches "Jo", "Job", and "jot", but not "John",
"Jody", and "joint".
&
matches exactly one word character or one HTML entity. Example: "caf&" matches "caf",
"café", and "café".
Note that word characters include alphanumeric characters, all extended ANSI characters, as well as
"_".
You can set or override the type of search performed by starting a line with a token character followed by
an equal sign. The following are recognized:
N=
W=
R=
Reference Information
62
Filter Scripts
For the ultimate control over email filtering, you can create Filter Scripts that can access any part of the
email message being processed. For example, you could create a script to identify duplicates using a
different method from Aid4Mail's deduplicating feature. Or filter messages based on the presence of
specific header field values for example all incoming messages marked as urgent and that contain
inserted images.
Filter scripts are files with the .s4f extension. Any such file placed in the Scripts subfolder of the
Aid4Mail program or AppData folder will be listed in the Filter Scripts window. If the "Filter source
messages" option is unchecked or if you haven't selected a filter, no filter script will be used when
processing your source emails. To use a script for email filtering, simply click on its name to select it.
You can unselect a script by holding down the Ctrl key and clicking on its name. A right-click on a script
name opens a shortcut menu with commands to unselect, create, edit, delete, and display information
about the script (if such data is available in the file). Another way to delete a script is to first select it and
then hit the Delete key.
Aid4Mail includes several sample Filter scripts that you can experiment with and use as the basis for a
new script.
63
2.3.7
Aid4Mail 4 Help
7. Target Format
This screen lets you choose what to do with your selected mail source. The following options are
available...
1.
2.
3.
4.
5.
6.
7.
8.
2.3.7.1
Reference Information
64
Microsoft Outlook window when you double-click on the file name in Windows Explorer or another file
manager. Note that MSG files use a proprietary format and can only be opened in Microsoft Outlook.
65
Aid4Mail 4 Help
4. Windows Mail
Before exporting messages to Windows Mail (WM) with Aid4Mail, make sure you have configured it with
at least one mail account so that the appropriate target folder is created. You must export your source
mail under the "Local Folders" location. Aid4Mail automatically suggests the appropriate default mail
folder, if it exists. If you type a new subfolder, Aid4Mail will automatically create it before exporting your
messages.
Open WM once Aid4Mail has completed the transfer. WM will start indexing your new folders and
messages. Make sure you give it enough time to complete the task. Sometimes new folders do not
appear immediately under "Local Folders"; this display issue is usually fixed by restarting WM.
Note that the current version of Aid4Mail cannot change email status information (unread, read, replied,
etc.) on messages exported to WM. As a result, all these messages are listed as unread.
2.3.7.3
2.3.7.4
Use the EML format to save your messages in individual files. Depending on your system setup, EML
files can be displayed in an Outlook Express window when you double-click on the file name in Windows
Explorer or another file manager. Aid4Mail sets the file date stamp according to the message date
based on your local time (unless you use the /TimeZone command-line switch). This way you can easily
sort your messages by date in your file manager. Note that the Windows File Indexing feature may
cause the date stamp of your target EML and MSG files to be changed to the current date. To avoid this
issue, go to Control Panel -> Indexing Options -> Advanced -> File Types, and uncheck the extensions
"eml" and "msg" from the list.
Copyright 2005-2016 Fookes Holding Ltd
Reference Information
66
EML files can easily be imported into Outlook Express with Windows Explorer. Simply select the EML
files in Windows Explorer (the Ctrl+A shortcut selects all the files in your current folder) and then drag
them into the Outlook Express application window and drop them into the mail folder of your choice.
2.3.7.5
2.3.7.6
67
Aid4Mail 4 Help
web browser. In most cases, messages are rendered the same way as in a mail client. However certain
special types of emails, like digests and partial messages, may not display any contents at all in
Internet Explorer. Embedded contents like pictures and sounds are displayed too and you can click on
attachment names to extract them from the message and save them to disk. Aid4Mail sets the file date
stamp of MHT files according to the email date based on your local time (unless you use the /TimeZone
command-line switch). This way you can easily sort your messages by date in your file manager.
Note that there is an issue that affects message attachments, which is due to a bug in Internet Explorer.
When you click on an attachment link to save the file to disk, Internet Explorer displays an incorrect file
name in the Save As dialog box. It's best to replace it with a meaningful name and especially to add the
appropriate file extension for it. (Use the same extension displayed in the real attachment name.)
You may get a security warning that tells you Internet Explorer has restricted the MHT file from showing
active content. If you know your mail is safe, right click on the warning bar and select "Allow Blocked
Content" from the popup menu.
Mail archives
Aid4Mail can save your mail in highly compressed ZIP archives that you can open with Windows
Explorer under Windows XP or more recent, or with any of the popular ZIP utilities like WinZip and
PkZip. See the topic Advantages of Aid4Mail Archives for more details about this unique feature.
The Aid4Mail Professional and eDiscovery editions offer the option to export your email in PDF format,
which makes it easy to view and share your important messages without a mail client. Mail text stored
Copyright 2005-2016 Fookes Holding Ltd
Reference Information
68
in these PDF files is searchable in Adobe Reader. Email attachments are embedded in the resulting
PDF file and can be opened or saved to disk by right-clicking on the icon next to the file name.
Furthermore, the Aid4Mail eDiscovery edition gives you the choice to create PDF/A-1a (Level A
Conformance) files for long-term archiving or to encrypt and password-protect your PDF files. Another
useful option only available in the eDiscovery edition lets you choose whether to embed the original
email header or full email in RFC format with each message in the PDF file.
PDF files are not designed to store huge amounts of data. You should avoid exporting too many
messages into a single PDF file. In our tests, we managed to create PDF files with just under 10,000
emails (the limit may vary depending on the type of emails converted). Use the Aid4Mail filtering features
to export just the subset of emails you need.
Note that in some cases, complex HTML mail (typically advertisements and some newsletters) exported
to PDF are not rendered correctly. If graphic elements are stored on the web, Aid4Mail will try to
download them and integrate them into the converted email unless you set the "External links" option to
"No downloading". Of course, this kind of processing will fail if Aid4Mail cannot connect to the internet
and corresponding messages will be rendered in the PDF file without the graphics.
2.3.7.8
2.3.8
8. Target Settings
Target Location
Choose the disk folder that is to receive the exported mail and/or message contents. Click on the button
with the three dots [], or hit the F4 keyboard shortcut while in the field, to browse through your drives
for the folder name. On some Windows systems, you may need to use "Tools | Folder Options | View" in
Windows Explorer and select "Show hidden files and folders". See the topic Finding Mail Folders if you
need help to find the location of your target mail (usually the appropriate target folder is only available if
you have already set up a mail account in your target mail client). Note that if you add new folder names
in this field, Aid4Mail will automatically create them before saving the target file(s) into them. The Folder
field supports "shorthand" tokens; see the Useful Tokens and System Variables topic for more details.
Example:
%MyDocs%\email\
Note for keyboard users: in the Target Folder dialog box, you can use the Ctrl+Ins keyboard shortcut to
create a new subfolder and Ctrl+Del to delete the selected folder.
If you are exporting messages using the EML target format, you can choose to leave the "File name"
field blank or specify a file extension. If the field is left blank, the .eml extension is added by default. If
69
Aid4Mail 4 Help
you want to use a different extension, use an asterisk wildcard followed by the extension you wish to
have (e.g. "*.txt"). In both cases, the file name is determined by the message subject line.
If the source messages are stored in EML, MSG, and MHT files, then you can use the {filename}
token to create EML target file names that are based on the source file names instead of the subject
line. If you also want to control the target extension of exported EML files, just add it after the token (e.g.
"{filename}.txt").
Unless you use the {filename} token or choose the MD5 File names option, exported EML, MSG,
MHT, and PDF files will be saved with a file name taken from the message subject line. Note that
Ai4Mail currently cannot create Unicode file names. If a subject line or source file name used for creating
the target file name has Unicode characters, Aid4Mail will try to convert them to their equivalent ANSI
character, if available, or substitute them with compatible characters before saving the email file to disk.
You cannot specify a file name if you have chosen MHT files or message contents as your target format.
With PST and ZIP as your output formats, you are required to enter a file name before you can proceed
to the next screen.
With other target formats, you can choose to either leave this field blank or specify a file name. If you
leave this field blank, the target file name will be based on the source file name, or folder name if
messages are stored in individual files. If you specify a file name and the export option "Restore source
folder structure" is unchecked, then all source files are exported into the single target file. We
recommend you leave the file name field blank when processing multiple mail folders, unless you want to
merge them all into a single file.
If you have the Aid4Mail Home edition and want to export mail to your default Outlook profile, select the
Outlook.pst file name if it exists under the "<Documents>\Outlook Files\" folder or the "<Application
Data>\Microsoft\Outlook\" folder. Otherwise choose the .pst file with a name that corresponds to your
email account. Make sure you tick the "Append messages to target mailbox file" box on the Export
Options screen.
Exporting to Thunderbird, SeaMonkey, Mozilla, PocoMail, Barca: If you want exported mail to appear in
your mail client, it is important that you have an existing mail profile and that you select the appropriate
folder for the Target Location. Normally, Aid4Mail will suggest the appropriate location if it finds your
default profile. If it doesn't, read through the Finding Mail Folders topic to determine the correct location.
With Thunderbird, the folder usually looks something like this:
<Application Data>\Thunderbird\Profiles\default\<code>.slt\Mail\Local Folders
In most cases, you'll want to leave the "File name" field blank. This is especially important if you want
the exported mail folder names to be the same as those in your source mail. Finally, before exporting
your messages, make sure your mail client is closed. Once the operation is finished and you reopen
your mail client, you should see your newly exported messages.
To reset the value of this field to the default folder location for the current target format, simply clear the
field and double click in it with your mouse. Aid4Mail will then try to determine the appropriate target
folder for you and enter the value.
Target Line Format
This option is available when you export your email to EML or generic mailbox formats. Only use it if you
plan to transfer your converted files to a non-Windows operating system. Aid4Mail will adjust the format
of line endings of exported emails to suit the selected operating system.
Outlook Personal Storage
This section is only displayed if you have chosen the PST output format. You can specify a Display
Copyright 2005-2016 Fookes Holding Ltd
Reference Information
70
Name used when creating a new PST file and the name of the base folder that will be receiving the
exported mail. The Display Name must contain a value; it is shown in the Outlook Folder List when you
open the new PST file. The Base Folder value can either be a default Outlook folder name like Inbox or
Sent Items, or any other name you choose. You can also specify a sequence of subfolder names by
separating each name with a backslash. Example:
Inbox\Imported Mail\August 2012
Use the password field to create a new encrypted PST file or to add mail to an existing passwordprotected PST file. When you create a password-protected ANSI PST file with Aid4Mail, the high
encryption format is used if the password exceeds 8 characters and the weaker compressible-encryption
format is used with shorter passwords. With Unicode PST files, the default compressible-encryption
format is used (high encryption is not supported.)
If you think your export will exceed the capacity of a single PST file, you can set a threshold value in the
"Limit file size" field. Setting the value to zero or leaving the field blank instructs Aid4Mail to not monitor
the PST file size. Otherwise, Aid4Mail treats values equal to or below 500 as representing gigabytes
(GB) and values above as megabytes (MB). When the size limit is reached, Aid4Mail stops exporting
mail to the current PST file, creates a new PST file based on the name of the first one but with an index
number, and then continues the mail export to the new PST file. For example, if you set the size limit to
2 GB for a file called Outlook.pst and have 5 GB of mail to export, Aid4Mail will create the following files
on completion:
Outlook.pst
Outlook[001].pst
Outlook[002].pst
Note that Aid4Mail cannot determine exactly when the limit is reached because Outlook uses a data
cache. In other words, Outlook will still send data to the PST file after Aid4Mail has measured the file
size and stopped exporting mail to it. As a result, a PST file may slightly exceed the size limit you set.
To avoid problems, choose a smaller size that ensures your PST file will never get too big.
The "Create Unicode PST" setting is only used if you have Outlook 2003 or newer. When you check this
setting, Aid4Mail will create a PST file that has a storage capacity of up to 20 GB in Outlook 2003 and
2007, and 50 GB in Outlook 2010, 2013 and 2016. The main drawback with Unicode PST files is that
they are not compatible with Microsoft Outlook 97, 98, 2000, and 2002. If you uncheck this option,
Aid4Mail will create an ANSI PST file that is compatible with all versions of Microsoft Outlook but has a
storage capacity limited to 2 GB. Note that the PST size limit may be set smaller through registry
settings (see this Microsoft Knowledge Base).
PDF Settings
These options are displayed if you select Adobe PDF file as your target format. Several categories of
settings are available through the tabs below the option fields (two in Aid4Mail Professional and three in
eDiscovery). You must define a target file name if you choose to export all your emails into one PDF
document; you can leave the "File name" field blank for the other options.
You can choose whether all messages are saved into a single PDF file, or one PDF per folder, or one
PDF per email. Other options let you set the page size and orientation, the default display mode when
the PDF file is opened, the level of compression (fastest means lowest compression but fastest PDF
creation and opening), and whether to embed fonts in the file or not. For the smallest PDF files, set
compression to "maximum" and Fonts to "No font embedding".
Some email messages rely on external images for their presentation. Aid4Mail can download such
contents and include them in the target PDF file. This feature, however, only works if Aid4Mail has
access to the internet. If you are working in a restricted environment or if processing speed is more
important to you than including external images, simply set the "External links" field to "No
Copyright 2005-2016 Fookes Holding Ltd
71
Aid4Mail 4 Help
downloading".
The "Document Information" tab gives you access to fields where you can enter the author name,
document title and subject, and keywords.
Note that in some cases, complex HTML mail (typically advertisements and some newsletters) exported
to PDF are not rendered correctly. If graphic elements are stored on the web, Aid4Mail will try to
download them and integrate them into the converted email unless you set the "External links" option to
"No downloading". Of course, this kind of processing will fail if Aid4Mail cannot connect to the internet
and corresponding messages will be rendered in the PDF file without the graphics.
If you have the eDiscovery edition, use the Advanced tab to access options for creating PDF files that
are encrypted and password protected or PDF/A archival files. Note that you cannot create encrypted
PDF/A files. To preserve your original source data within the target PDF file, Aid4Mail gives you the
option to store either the original message header or the whole email as embedded data in regular PDF
files (not PDF/A). A right-click on the corresponding icon in the PDF file gives you access to the save to
disk command. You also have the option to print in the PDF file the hash signature (MD5 or SHA1) of
each processed email.
Unfortunately the PDF/A format does not allow embedding files in it in such a way that they can be
saved to disk by end users afterwards. As a result, email attachments and source mail files (headers or
whole emails) are exported in corresponding subfolders of the target PDF folder instead of being
embedded in the PDF/A file.
2.3.9
You are using the 64-bit version of Outlook 2010, 2013 or 2016. Download and install the separate
Aid4Mail edition with Outlook 64-bit support.
2. You have an Outlook 2010 Click-to-Run installation. Re-install without the Click-to-Run method if
available.
3. You are trying to access a Unicode PST file with a MAPI system that does not support the new
format.
4. You are trying to access a mail store that is write protected or has limited access rights.
5. You have Outlook 98/2000 installed in Internet Mail Only Mode (IMO). Re-install in Corporate/
WorkGroup mode.
6. The MAPI profile details you provided were incorrect.
7. You have installed Outlook but have not yet configured a default mail account.
8. Your mail is on a remote computer that is not accessible.
9. The mail file is empty.
10. A third-party utility is interfering with Aid4Mail (synchronization software, backup, anti-virus, etc.).
Note that Aid4Mail requires a fully functioning Extended MAPI system in order to access MAPI folders.
Extended MAPI is usually not available if you have Microsoft Outlook 98/2000 installed in the Internet
Only Mode (IMO).
Create and save under following subfolder
Enter a name in this field if you want the imported mail stored in a new folder under the selected target
MAPI folder. You can also specify a sequence of subfolder names by separating each name with a
backslash. Example:
Imported Mail\August 2015
Copyright 2005-2016 Fookes Holding Ltd
Reference Information
72
73
Aid4Mail 4 Help
a single folder.
2.2 Detach attachments and inserted files from email messages
If your selected target corresponds to a generic mailbox format or EML files, you can save the
messages with all contents (file attachments, embedded pictures, etc.) extracted and saved in a
separate folder. Aid4Mail saves the modified messages using the MIME External-Body Access-Type
format defined in RFC 1521. Using this setting has several advantages: a) attachments and embedded
contents are easy to find and open with Windows Explorer or any other file manager; b) duplicate files
are automatically removed; c) the total size of exported files can be significantly smaller than the source
file(s). The main disadvantage with this format is that most mail clients do not handle it correctly and
may not be able to render the extracted files. However, you can always use Aid4Mail to pull detached
file contents back into the messages if necessary.
2.3 Append messages to target mailbox file
If your selected target corresponds to a PST file or a generic mailbox format, you can add messages to
an existing file if this option is set. If the "Do not add duplicate messages" option is set, only new
messages are appended to the target file. If this option is unchecked, Aid4Mail will first make a backup
copy of the target file if it already exists and then replace the contents with messages from the mail
source.
2.4 Do not add duplicate messages
When available, set this option to block adding duplicate messages. By default, Aid4Mail skips
duplicates based on the target mail folder. But you can increase the scope to all folders by setting the
"Check for Duplicates Across Folders" option under Advanced Options. Checking for duplicates with this
option usually decreases processing speed and uses more system memory, though the impact is
usually minimal.
You can also use this option to process mail incrementally. See the "Log for Incremental Processing"
option under Advanced Options for more details.
Aid4Mail checks for duplicates by comparing the value of the Message-ID field in each processed email
header. If this field is empty or missing (usually in outbound messages), Aid4Mail uses other header
data for the comparison. In MAPI messages (from Office Outlook and Microsoft Exchange), Aid4Mail
uses the email creation and submit dates, subject line, and stored message size. In other types of
messages, Aid4Mail uses the email date and subject line for the comparison, or other header fields (To,
Cc, Bcc, From delimiter) if either of those values are missing, or the whole header if none of those fields
contain any data.
2.5 Use unique MD5 file names
When you save messages to individual MSG, EML, MHT, or PDF files, you can choose to have their file
name based on the message subject line or based on a unique (and usually shorter) MD5 signature. If
you plan to save your message files to a CD-ROM, it is recommended that you set this option. This
ensures you won't encounter problems with file names that are too long. The following example is an
MD5 file name: 6a4b080de66b2dafb4f6bceb4916aaf4.eml
With Outlook MSG files, the MD5 signature is based on the unique Message-ID field, which is normally
present in the header of all received email messages. If this field is empty or missing (usually in
outbound messages), Aid4Mail uses the email creation and submit dates, subject line, and stored
message size. With EML and MHT files the method used for creating the MD5 signature depends on the
"Header-based MD5 File Names" option under Advanced Options.
Note that when the the "Header-based MD5 File Names" option is turned off, a single different character
in an EML or MHT message file will result in a completely different MD5 file name. Only two messages
Copyright 2005-2016 Fookes Holding Ltd
Reference Information
74
that are 100% identical will produce an identical MD5 file name. Unfortunately, when exporting
messages from Outlook 2003 and more recent, most messages (those with a MIME format) will not
produce the same MD5 file name each time you rerun the conversion with Aid4Mail. The reason is that
Outlook uses a random element to create boundary markers between message parts. You can work
around this problem by unchecking the Use MAPI RFC 1521 Converter option or using the /
MapiConvOff command-line switch.
Make sure you close Aid4Mail before you edit its INI file. You can specify the alternative programs under
the [LaunchApp] section in the INI file. Use the WebBrowser key to launch a different browser from
Internet Explorer. Use the FileManager key to launch a different file manager from Windows Explorer.
Use the XlsViewer key to launch a different spreadsheet application from MS Excel. The application
name can be followed by command-line switches. Use the "%s" token to tell Aid4Mail where it must
insert the name of the target folder or file. Example:
[LaunchApp]
WebBrowser=NetCaptor.exe -nohome %s
FileManager=Explorer.exe /e,%s
XlsViewer=Excel.exe %s
75
Aid4Mail 4 Help
If you are going to process large amounts of emails, you can improve speed and reduce memory usage
by setting the "Skip filter details in log" checkbox. When set, this option tells the log screen to not show
information about which messages are skipped as a result of the Aid4Mail filter settings.
Go to the Skipped Messages topic for a detailed explanation on the type of emails that Aid4Mail may
have skipped during processing.
Once processing has finished, a copy of the progress screen is automatically saved in your Windows
Temp folder to a text file called Aid4Mail-Progress.txt:
c:\Users\<User>\AppData\Local\Temp\Aid4Mail-Progress.txt
2.3.12.1 Skipped Messages
Once your messages have been processed, Aid4Mail displays information about the number of emails it
has analyzed and processed. Depending on your settings, Aid4Mail may skip certain kinds of emails.
Skipped messages are either duplicates, unpurged or invisible emails, messages not matching your filter
settings, non-email items, empty emails (no header and body), or emails that were not processed or
saved due to errors.
Duplicates are skipped if you set the "Do not add duplicate messages" checkbox on the Export
Options screen or when Aid4Mail encounters empty emails (no header and body).
Blank messages are emails that have no data (no header and body). These rarely occur but may exist
on IMAP servers with index errors. Outlook Express files may also include links to remote emails that
have not been downloaded and therefore have no local contents to show.
Unpurged messages are emails you cannot see in your mail client but that are stored in your mailbox
files. They are the original copies of emails that have been deleted or moved from the mail folder. These
type of messages disappear when you compact or expunge your mail folders. Note that Aid4Mail cannot
see unpurged messages in Microsoft Outlook because Extended MAPI doesn't provide methods to find
them. Unpurged emails can be extracted with the eDiscovery edition of Aid4Mail by setting the "Include
unpurged mail" checkbox on the Mail Source screen.
Filtered messages are typically emails that did not match your filter settings on the Filter Options
screen. If your source mail is from a MAPI store (Office Outlook, PST) and the "Process only email
messages" option is checked, non-email items such as Calendar, Contacts, and Tasks, are skipped
and added to the Filtered count.
Errors that cause a failure to process or save a message are counted under this item. Such errors
typically occur when you process a corrupted file, or malformed messages, or the file is locked by
another process, or the target location is write protected, or the target lacks the necessary space for the
new data.
Reference Information
76
item
item
item
item
item
has either been added today or after you last displayed news.
has already been displayed before.
link points to an .exe Setup file.
link points to a .zip file.
is an email address link.
The News and Updates screen is useful to find out if a new Aid4Mail update is available. It also displays
news about our other major releases and occasionally special offers that we make available to our users.
Information is transmitted one way only, from our server to your computer. No information about you or
your computer will be revealed during this operation. Aid4Mail determines locally what relevant news to
display to you.
Usually, program updates are downloaded and installed directly from within Aid4Mail updating your
software this way couldn't be easier. However, be aware that some download managers may take over
this download process and interfere with normal operations. When this happens, you may see a prompt
from Aid4Mail asking you to click a button once the download has been completed. With other download
managers, the download may fail altogether. In this case, turn off your download manager and try again.
You can configure Aid4Mail to automatically check for news at regular intervals by checking the Check
for news updates setting. The News and Updates screen will automatically pop up if news items have
been added or modified since the last viewing.
2.4
2.4.1
Notification Options
Email notifications are used to alert you when a migration/conversion session ends as well as when an
account fails to process. This feature frees you up from having to regularly monitor Aid4Mail's progress.
You will find this option in the drop-down menu of the Software button. Please note that the Notification
Option menu is only available in Aid4Mail Migrator, Forensic, eDiscovery, Service, and Console.
In order to work, Aid4Mail needs access to our server on the web (www.fookes.com) and you will have to
double opt-in your email address. Note that this notification feature never stores your actual email
address on our server (only an MD5 hash value), nor do we pass it on to anyone. With this feature you
will only receive notifications concerning your current Aid4Mail migration/conversion session.
To receive email notifications, open the Notification Options menu and choose the Opt-In command.
You will then be prompted to enter your email address after which your opt-in request is sent to our
server. On receiving your opt-in request, our server will send you a confirmation email within a couple of
77
Aid4Mail 4 Help
minutes. When it reaches you, please click on the confirmation link to finalize the opt-in procedure.
Although email notifications work well most of the time, we cannot guarantee that the feature will be
100% reliable. Email messaging is not a fault free system, and so there is no guarantee that a
notification sent from our server will always reach your Inbox.
Before relying on the email notification feature, we recommend that you run a test after you've opted-in
(use the Notification Options > Test Notification Email menu command). There's always the risk that
your email service or your client program will block, delete, or send the notification message to your
Junk folder. Notifications are automatically sent to you from our noreply@fookes.com email address. If
possible, please add that email address to your white list.
You can opt-out from these notifications at any time by choosing the Notification Options > Opt-Out
menu command.
2.4.2
IMAP Options
The IMAP options listed below are available either through command-line switches or the IMAP Options
submenu of the Software button menu.
Some IMAP servers can be quite fussy when it comes to email structure formatting, contents, and size.
During the upload procedure, emails that don't conform to the server's requirements are simply rejected.
Microsoft Exchange servers are particularly strict in this respect.
To avoid email loss, Aid4Mail offers several options to control how rejected emails are handled:
Retry Download On Error
Use this option to force a new download attempt if the previous attempt failed due to an error.
Save Failed Uploads Locally
Tells Aid4Mail to save a copy of rejected emails in EML format. The files are saved under the Mail
subfolder in the folder specified by the "Local Folder For Failed Uploads" option. If no folder is defined,
Aid4Mail then chooses the location of the target IMAP log file if set, or the "My Documents" folder.
Local Folder For Failed Uploads
Tells Aid4Mail where to locally save rejected emails. Use double quotes if the folder name contains
spaces. The folder name can include tokens and system variables. This option is only valid when used
together with the "Save Failed Uploads Locally" option.
Remove Oversized Attachments
Many IMAP servers reject emails that are too big. You can use this option to tell Aid4Mail to try again
after extracting attachment from the rejected email. Extracted attachments are stored under the
Contents subfolder in the parent folder of the EML files. This option is only valid when used together with
the "Save Failed Uploads Locally" option.
Log IMAP Communications
Turn this option on to create a log file storing all communications between Aid4Mail and an IMAP server.
This feature is useful to identify issues encountered when connecting to an IMAP account or when
uploading/downloading messages to it. These log files are saved in the "My Documents" folder and use
the .log file extension. This option is turned off by default when you start Aid4Mail. You can also set this
option through the command line with the /ImapLog switch.
Note that your IMAP logon credentials are stored as plain text in these log files so make sure you keep
Reference Information
78
2.4.3
Advanced Options
The special options listed below are available either through command-line switches or the Advanced
Options submenu of the Software button menu.
Strict File Format Check
When this option is set, Aid4Mail checks both the file extension and contents to see if they conform
with the selected source format. You can instruct Aid4Mail to be more "tolerant" with certain file types
by turning off this option. This option is turned on by default when you start Aid4Mail. You can also
control this option through the command line with the /m switch.
Complete mbox Mail Separator Test
This feature controls how carefully email separators (From line message boundaries) in mbox-type files
are checked. When set, Aid4Mail expects a format similar to the one described in the qmail manual,
which is a standard followed by most mail clients (though Aid4Mail does accept a hyphen or ???@???
for the email address part). When turned off, Aid4Mail will accept any line starting with "From " as an
email separator as long as the next line starts with a valid header field. This means that many nonstandard From line delimiters often appearing in mbox files will be correctly identified. This option is
checked by default, which is the recommended setting.
When this option is set, processing is slightly slower and may increase the risk that some corrupted or
invalid message delimiters are missed. As a result, multiple emails may be processed as if they are a
single email message.
When this option is unchecked, it increases the risk of incorrectly treating a line within an email
beginning with "From " as a message delimiter. If this happens, a single message may get treated as
multiple emails. Another potential issue is that it may miss a valid message delimiter that is followed by
an invalid header line. As a result, multiple emails may be processed as if they are a single email
message.
Use Received Date Field
By default, incoming message dates used for creating file date stamps (eml, mht, msg, extracted
attachments) and Microsoft Exchange delivery time are based on the server Received date instead of the
header Date field. Turn off this option to instruct Aid4Mail to extract the date from the message Date field
instead of the server Received date. You can also control this option through the command line with the /
UseDateField switch.
Header-based MD5 File Names
Prior to Aid4Mail version 2.11, the MD5 signature for EML and MHT file names was computed from the
full email (message header + body). This behavior is preserved when this option is unchecked.
When checked, the MD5 signature is based on the Message-ID field value. If this field is empty or
missing (usually in outbound messages), Aid4Mail uses the email date and subject line for the
comparison, or other fields (To, Cc, Bcc, From delimiter) from the message header if either of those
values are blank, or the whole header.
Add Metadata to Headers
This option is available in Aid4Mail eDiscovery, Forensic and Service. When set, it adds or modifies
header fields (like folder names and status flags) to preserve metadata and conform to the target format.
Uncheck this option to create an unmodified copy of the source SMTP header in the target MIME format.
79
Aid4Mail 4 Help
This option also affects the creation of PDF files; when unchecked it leaves out the source folder name
from the page header section.
Reference Information
80
by turning this option on.This option is turned off by default when you start Aid4Mail. You can also
control this option through the command line with the /fast switch.
Log for Incremental Processing...
This option affects the behavior of the "Do not add duplicate messages" setting on the Export Options
screen and is ignored if the setting is unchecked. Use it to create or open a log file that keeps track of
which emails have been processed. If you open an existing log file, Aid4Mail will skip any email that is
referenced in it. This feature is useful if you want to avoid exporting the same email more than once even
after you restart Aid4Mail.
Note that the references stored in the log file are sensitive to the state of the "Check for Duplicates
Across Folders" option. In other words, if the log file was created when the option was unchecked, then
running Aid4Mail again with the option checked will result in failure to match any of the references. As a
result all emails will be processed again.
In Aid4Mail Console you can set the log file through the /SkipDups and /SkipAllDups command-line
switches.
Check for Duplicates Across Folders
This option affects the behavior of the "Do not add duplicate messages" setting on the Export Options
screen and is ignored if the setting is unchecked. When this option is unchecked, filtering for duplicates
is limited to the contents of the target folder. When the option is set, Aid4Mail filters out all message
duplicates, including those of emails exported to previous target folders. You can also control this option
through the command line with the /SkipAllDups switch.
2.5
Or add the switch to the Windows desktop shortcut for Aid4Mail. You can do this by opening Aid4Mail's
shortcut Properties dialog box and adding one or more switches at the end of the Target field on the
Shortcut tab. Example:
"C:\Program Files\Aid4Mail2\Aid4Mail.exe" /Switch1 /Switch2
/acc
/acc=on
/acc=off
81
Aid4Mail 4 Help
/acc=install
Use this switch to copy screen reader configuration files for Window-Eyes,
JAWS, and/or Dolphin Hal to the appropriate folder locations. These files inform
screen readers how to deal with non-standard controls used in Aid4Mail.
/emlExt=ext
Use this switch if you need to process EML files that do not have the standard .
eml file extension. Set the "ext" value either to the corresponding file extension
or use "*" to accept any file extension. Example: Aid4Mail.exe /emlExt=txt
/ErrorLog
/fast
Aid4Mail does extensive text parsing and format analysis when reading generic
mailbox files, including those created by Mozilla Thunderbird and Eudora. It does
so to ensure it doesn't miss any emails when processing mailbox files that
contain a mix of storage formats (e.g. a Mac or Unix mbox file imported in
Windows Thunderbird with new messages added to it). If you are processing
mailbox files that are entirely created by a single mail client, then you can
increase performance without sacrificing reliability by using the /fast switch. This
setting is also available through the "Software/Advanced Options/Fast Mail
Processing" menu command. Example: Aid4Mail.exe /fast
/ImapLog
Use this switch to create a log file storing all communications between Aid4Mail
and an IMAP server. This feature is useful to identify issues encountered when
connecting to an IMAP account or when uploading/downloading messages to it.
These log files are saved in the "My Documents" folder and use the .log file
extension. This setting is also available through the "Software/IMAP Options/Log
IMAP Communications" menu command. Example: Aid4Mail.exe /ImapLog
/m
Aid4Mail checks both the file extension and contents to see if they conform with
the selected source format. You can instruct Aid4Mail to be more "tolerant" with
certain file types by running it with the /m command-line switch. This can be
useful with files that start with a non-conforming format. This setting is also
available through the "Software/Advanced Options/Strict File Format Check"
menu command. Example: Aid4Mail.exe /m
/MapiConvOff
With Outlook 2003 and more recent, Aid4Mail uses the internal MAPI converter
to import/export mail from Outlook PST and MSG files, and Exchange server
stores. The advantage of this method is that it converts messages with non-Latin
characters and certain special email types more reliably than the Aid4Mail
method. The disadvantage of the internal MAPI converter is that it is usually
slower than Aid4Mail's conversion method. Only use the /MapiConvOff switch if
you are encountering conversion issues with it or if processing speed is critical.
This setting is also available through the "Software/Advanced Options/Use MAPI
RFC 1521 Converter" menu command. Example: Aid4Mail.exe /MapiConvOff
/MapiFixOff
When using the MAPI RFC 1521 converter to process mail from Outlook PST
and MSG files, and Exchange server store formats to RFC text-based formats (
MIME), results may differ significantly from the original format. When this option
is set, Aid4Mail fixes all format inconsistencies it detects based on the original
header data. These fixes ensure that the converted email is as faithful as
possible to the original message and reduces the risk of data loss. The
disadvantage of this option is that it slows down conversion and in some very
rare cases may cause incorrect conversions. Use the /MapiFixOff switch to
Copyright 2005-2016 Fookes Holding Ltd
Reference Information
82
turn off the default email fixing feature. This setting is also available through the
"Software/Advanced Options/Fix MAPI Header Errors" menu command.
Example: Aid4Mail.exe /MapiFixOff
/RESET
/RESETWND
/SkipAllDups
This switch has the same effect as setting the "Check for Duplicates Across
Folders" option under the Advanced Options menu.
/TimeZone
Use this switch to change the default time zone Aid4Mail uses when setting the
date stamp of exported message files and date values in the corresponding
column of MHT target formats. The switch accepts a time zone value in one of
several formats: numerical, time zone abbreviation, time zone in short form, or
Windows registry time-zone name. See the Time Zones topic for more
information.
/TocDate
This feature is only used when processing Qualcomm's Out mailboxes. When
this setting is missing, Aid4Mail determines the date of sent messages by
reading the Out.mbx mailbox email delimiter line. In most cases this provides
fairly accurate dates. However, this does not necessarily match the dates you
see in Eudora, which are taken from the Out.toc file. Unfortunately, Aid4Mail
cannot reliably determine the date format used in Qualcomm Eudora Out.toc
files. However, you can use this setting to provide the appropriate format to
enable successful date conversion for use in other programs. Use the following
letters to indicate the position of the different date elements: h=hour, n=minutes,
m=month, yy=2-digit year, yyyy=4-digit year, ampm=AM or PM. Examples: To
convert a date like 01:51 PM 3/19/2014, use: aid4mail.exe /TocDate="h:n
ampm m/d/yyyy" . To convert a date like 13:51 19/03/14, use: aid4mail.exe /
TocDate="h:n d/m/yy"
2.6
/trial
Removes the local activation data files and starts Aid4Mail in trial mode. This
option is also available through the "Software/Clear Activation Code" menu
command.
/UseDateField
By default, incoming message dates used for creating file date stamps (eml,
mht, msg, extracted attachments) and Microsoft Exchange delivery time are
based on the server Received date instead of the header Date field. Use the /
UseDateField to instruct Aid4Mail to extract the date from the message Date
field instead of the server Received date. This setting is also available through
the "Software/Advanced Options/Use Received Date Field" menu command.
Type of Scripts
83
Aid4Mail 4 Help
Aid4Mail currently supports three types of scripts. They are 1) Filter Scripts which can be selected from
the Filter Options screen; 2) Output Scripts which can be selected from the Target Format screen; and
3) Plain Scripts which can be executed from the "Run Plain Script" menu command opened by clicking
on the Software button.
The main purpose of Filter Scripts is to control which emails are skipped or passed on to the next
processing stage. But a Filter Script can also be used to save a detailed log of each email it analyses,
or influence how emails are saved in the target format. Filter Scripts use the .s4f extension and are
stored in the Scripts subfolder under the Aid4Mail program folder or under the Application Data folder.
Use Output Scripts when you want complete control over the target format. You can create Output
Scripts to create custom formats not available by default in Aid4Mail or to extract data from email
messages. Output Scripts use the .s4o extension and are stored in the Scripts subfolder under the
Aid4Mail program folder or under the Application Data folder.
Plain Scripts do not process email data. So features related to email filtering and access to email data
are not available in these type of scripts. You can use Plain Scripts for setup purposes, to test new
code, or to help you learn the scripting syntax. Plain Scripts can be executed without prior installation or
the need to run an email conversion, so they make a quick job of testing multiple versions of your code.
Plain Scripts use the .s4p extension and do not need to be stored in a particular folder.
Script Structure
An Aid4Mail script is divided into several parts. The first part has several sections that provide
information to Aid4Mail. For example, the [Script.Info] section has a Title field that Aid4Mail uses to list
the script in the relevant part of its interface. The Requirements field tells Aid4Mail if the script can run
under the activated version of the license (Aid4Mail Professional or Aid4Mail eDiscovery).
The [Script.GUI.Enable] section tells Aid4Mail which interface features the script needs to use and
which ones need to be disabled.
The actual script code comes under the [Script.Code] section, and finally there is a [Template=]
section where you can define one or more templates that are to be used by the script.
The script code is divided into several sections that are executed at specific moments (or events) of
email processing. Each section starts with a double colon (::) followed by an identifier. The following
events are available:
::OnStart
Code under this section executes before the first email is processed.
::OnNewFolder
This event occurs each time a new folder is starting to process. It occurs before the first email in the
folder is processed.
::OnNewMessage
This event occurs each time a message is loaded for processing. The script code has access to all the
email-related commands.
::OnFinish
Code under this section executes after the last email has been processed.
Copyright 2005-2016 Fookes Holding Ltd
Reference Information
84
Aid4Mail scripts recognize several different kinds of data types. These are character strings (blocks of
text), which have to be placed between double quotes. Example: "blocks of text"
Boolean values: True or False
Integers: 123
Decimal numbers: 123.456
and Hexadecimal characters: $41 (= letter A).
Variables are named memory blocks that can store any of the above data types. Variable names always
start with the % character followed by a series of alphanumerical characters - spaces, control
characters, diacritics, and special symbols are not allowed in a variable name.
Aid4Mail supports four kinds of variables: plain single value variables (%plain), array variables (%Array.
variable or %%variable) that can store multiple values, template variables (%Template.variable or
#variable) that refer to a pre-defined template, and XML variables (%XML.variable) that provide a
convenient way to construct XML data structures.
Array variables can be subdivided into four types: plain arrays (%Array.variable) with just one column of
data, statistics arrays (%Stats.variable) that increment a counter each time a duplicate value is added
(no duplicates stored) - the value is in the first column and the counter in the second, Real arrays (%
Real.variable) that can store decimal values (real numbers) in the second column, and signature arrays
(%Sigs.variable) that store hash values of any data entered - useful for quickly determining if duplicate
data is being processed.
Aid4Mail provides several pre-defined variables. these are as follows:
%CR = carriage-return character ($0D in hexadecimal)
%LF = line-feed character ($0A in hexadecimal)
%LB = line break (combines %CR+%LF)
%CRLF = same as %LB
%Tab = tab character ($09 in hexadecimal)
%DQ = double-quote character (")
Template variables represent a pre-defined layout for text and/or other variables. The template variable
name must correspond to the name of a template stored in the templates section at the end of the script
file. For example, #Log.Header (or %Template.Log.Header) refers to the template stored under the
[Template=Log.Header] section.
Templates that contain references to script variables must be identified by the "Variables" keyword
which follows the template name and a semi-colon. Example:
[Template=Log.Data; Variables]
Variable place-markers in such templates are identified by the variable name placed between curly
brackets. Here's an example with a place-marker for the %Address variable:
Email address: {Address}
When a template variable is processed, variable place-markers are substituted by the value contained in
the corresponding script variable. Using the above example, with %Address = "me@gmail.com",
produces the following result:
Email address: me@gmail.com
Aid4Mail variables exist within a scope that is defined by where they are first used. Data in variables that
are defined in the OnStart section are accessible in all parts of the script. Variables defined in the
OnNewFolder section can also be accessed in the OnNewMessage section, but not in the OnFinish
section. Variables defined in OnNewMessage can only be accessed in that section.
85
Aid4Mail 4 Help
You use an = sign to assign a value on the right side to a variable on the left side. Example:
%Variable = "Value"
Each script statement should occupy a single line. You cannot include multiple statements on one line.
Blank lines are ignored and comments can be included by preceding them with a double forward slash.
Example:
//This is a comment
Comments can occupy a whole line or be placed at the end of a statement. Example:
%Variable = "Value" //This is a comment
You can insert labels in a script to define separate blocks of code. A label starts with a colon character
(:) followed by an identifier. Aid4Mail offers several "GoTo" commands that can alter the execution flow
based on conditions defined by the script. Use the "Return" command in a label section to return to the
script line following the "GoTo" command that brought you to it.
Script execution starts at the beginning of an event section, and processed statements in sequential
order until a "GoTo" instruction is encountered, or a label, or the next event section, or the start of the
templates section.
Aid4Mail supports over 180 functions. On execution, they all return a value that can be one of the data
types mentioned higher up. Most of these function take on or more parameters, which must be
separated with a semi-colon character (;). Parameters can consist of any of the supported data types.
They can be literal values, variables, other functions, as well as concatenations of any of those. Use
the + symbol to concatenate data. Example:
RunShell("Notepad.exe "+FileName.GetShortName(%TargetFile))
The script parser supports several operators that you can use for simple arithmetics. These are +
(addition), - (subtraction), * (multiplication), and / (division). Unlike the Calculate function, you cannot use
parentheses and there is no operator precedence; operations are evaluated from left to right. Examples:
%Val1 = 3 + 5 + " " + "apples"
%Val2 = 3 - 1 * 5 - 2 + " " + "oranges"
%Val3 = Calculate("3 - 1 * 5 - 2") + " " + "oranges"
%Val1 is assigned "8 apples"; %Val2 is assigned "8 oranges"; %Val3 is assigned "-4 oranges". The
different results between %Val2 and %Val3 are due to differences in operator precedence between the
two methods. Operators and functions supported by the Calculate script function are listed in the
Calculate command topic.
In some cases, one or more parameters are optional and a pre-defined default value is used when they
are left out. Optional parameters are identified in the functions list by enclosing them between square
brackets. Example:
String.Extract(Pattern; String[; SearchOptions; RegExFormat])
Some functions and special features are only available to specific licenses. For example, the %Sigs.
Variable, File.GetHash, String.GetHash, and RunConsole are only available when running Aid4Mail
activated for eDiscovery. Aid4Mail Home can only use scripts in trial mode.
Reference Information
86
You'll find usage examples in the sample scripts stored under the Scripts subfolder in the Aid4Mail
program folder. To execute the "Hello World.s4p" or "Calculate.s4p" script, click on the Software button
in Aid4Mail, select "Run Plain Script", and then open the file. We encourage you to open the sample
scripts in a text editor and then run them to compare results with the syntax.
See the Aid4Mail Script Syntax topic for a list of syntax elements.
Note that the regular expression engine used in some of the Aid4Mail script functions is based on PCRE
8.38. The regular expression syntax is documented in the Regex.chm Help file.
2.6.1
87
Aid4Mail 4 Help
:Label
Predefined Labels:
NEXT_LINE, SKIP_LINE, SKIP_MESSAGE, SKIP_FOLDER, FINISH, HALT
RUNTIME_ERROR
Types:
"String"
True/False
123
123.456
$0A
Assignment:
%Variable = Value
Mathematical operators:
+ - * /
Copyright 2005-2016 Fookes Holding Ltd
Reference Information
88
Comparison operators:
=, <> or !=, <, >, <=, >=
Comments in Script code section:
// ...
Object:
Mime.Attr[(Name)] // Returns current field attribute, or attribute value if a name is
specified
Mime.Attr.Count
Mime.Attr.Find(AttrName)
Mime.Attr.GoFirst
Mime.Attr.GoLast
Mime.Attr.GoNext
Mime.Attr.Name
Mime.Attr.Set(Name; Value) // Added if Name doesn't exist; deleted if Value is empty
Mime.Attr.Value
Mime.Body[(Format)] // Format = Decoded, Raw
Mime.Body.Set(Value)
Mime.Boundary
Mime.Charset
Mime.ContentType
Mime.Count
Mime.Email
Mime.Field[(Name)] // Returns current field, or field value if a name is specified
Mime.Field.Count
Mime.Field.Find(FieldName)
Mime.Field.GoFirst
Mime.Field.GoLast
Mime.Field.GoNext
Mime.Field.Name
Mime.Field.Set(Name; Value) // Added if Name doesn't exist; deleted if Value is empty
Mime.Field.Value
Mime.FileName
Mime.Find(Section) // Section = Display, Text, Html, XML, Rich, TNef, Attachments
Mime.FromDelimiter
Mime.GoChildren
Mime.GoFirst
Mime.GoLast
Mime.GoNext
Mime.GoParent
Mime.HasChildren
Mime.HasParent
Mime.Header[(Format)] // Format = Decoded, Raw
Mime.Header.Set(Value)
Mime.IsAttachment
Mime.IsEmbedded
Mime.IsMessage
Mime.IsMultipart
Mime.Preamble // This is a multi-part message in MIME format.
Mime.Size
Commands:
89
Aid4Mail 4 Help
// All Array data is stored in same Charset, which is determined by data added (ASCII7 -> System -> UTF-8)
Array.Add(Array; Value[; Delimiter])
Array.Add(Array; Value[; Number])
Array.Exists(Array; Value)
Array.Format(Array[; Delimiter; Options]) // Options = Sort
Array.Format(StatsArray[; Format]) // Format = "^1"+%Tab+"^2"+%Tab+"^3"+%LB // ^1 =
Name; ^2 = Count; ^3 = Percentage
Array.Format(StatsArray[; Format]) // Format = CSV
Array.GetNumber(Array[; Index])
Array.GetNumber(Array; Value)
Array.GetIndex(Array[; Value])
Array.GetSize(Array)
Array.GetValue(Array[; Index])
Array.Load(Array; FileName)
Array.Remove(Array[; Index])
Array.Remove(Array; Value)
Array.Replace(Array; Index; NewValue)
Array.Replace(Array; NewValue)
Array.Replace(Array; OldValue; NewValue)
Array.Save(Array; FileName[; Options]) // Options = Overwrite, Backup, Increment,
Skip, Error
Array.SetIndex(Array; Index)
Calculate(Expression)
Clear(Variable[; Type]) // Type = Plain, Array
Decrement(Number[; Count])
Decrement(Array; Item)
Define(Variable[; Type]) // Type = String, Boolean, Number, Array, StatsArray,
RealArray, XML
Define(Variable; SigsArray[; HashMethod]) // HashMethod = CRC32, MD5, SHA1, SHA256,
SHA384, SHA512 [ <-- only in Aid4Mail eDiscovery]
ErrorCode
ErrorLine
ErrorMessage
File.Append(FileName; Data[; CharSet]) // Creates BOM on new file if CharSet = UTF-16
or UTF-8b; CharSet can be numerical value or Charset name like UTF-8
File.Copy(Source; Target[; Options]) // Options = Overwrite, Append, Backup,
Increment, Skip, Error
File.Delete(FileName) // Does not delete files in system folders
File.Exists(FileName)
File.Exists(ZipFile; Specs)
File.GetDate(FileName[; DateField]) // DateField=create, modified, accessed
File.GetHash(FileName[; Options]) // Options = CRC32, MD5, SHA1, SHA256, SHA384,
SHA512 [ <-- only in Aid4Mail eDiscovery]
File.GetIni(FileName; ValueName)
File.GetIni(FileName; SectionName; ValueName)
File.GetSize(FileName)
File.Load(FileName[; Options]) // Options = Parse
File.Rename(FileName; NewName[; Options]) // Options = Overwrite, Backup, Skip, Error
File.Save(FileName; Data[; Options; CharSet]) // Options = Overwrite, Append, Backup,
Increment, Skip, Error; Creates BOM on new file if CharSet = UTF-16 or UTF-8b; CharSet
can be numerical value or Charset name like UTF-8
File.SetIni(FileName; ValueName; Value)
File.SetIni(FileName; SectionName; ValueName; Value)
Reference Information
90
91
Aid4Mail 4 Help
Reference Information
92
Settings.RestoreFolders
Settings.SkipDuplicates
Settings.SourceFolder
Settings.SourceMail
Settings.TargetFileName
Settings.TargetFolder
Settings.TargetFormat
Settings.TargetLineFormat
ShowInfo(Message[; Options]) // Options = ProgressLog, DialogBox
Sound(SoundName)
String.ChangeCase(String; Options) // Options = Lower, Upper, Capitalize, Invert
String.ChangeCharSet(String; NewCharSet) // NewCharSet can be numerical value or
Charset name like UTF-8
String.Contains(Chars; Set) // Contains("AZ"; "ABCDZEF") -> True
String.Copy(String; Offset[; Amount]) // if Offset is negative, position is calculated
from string end
String.Decode(String[; Options]) // Options = quoted-printable quoted base64 CSV HTML
RTF URL UUE ROT13
String.Delete(String; Offset[; Amount]) // if Offset is negative, position is
calculated from string end
String.Encode(String; Options) // Options = quoted-printable quoted base64 CSV URL UUE
ROT13
String.Escape(String; Chars; EscChar)
String.Exists(Pattern; String[; SearchOptions]) // SearchOptions = C,W,?,R (C = Case
Sensitive, W = Whole Words, ? = Wildcards, R = Regular Expression)
String.Extract(Pattern; String[; SearchOptions; Format]) // SearchOptions = C,W,?,R
String.ExtractAll(Pattern; String[; SearchOptions; Format]) // SearchOptions = C,W,?,R
String.Filter(String; OldChars[; NewChars]) // deletes found OldChars if no
corresponding NewChars
String.Format(String; Format[; Charset]) // Format = Windows, Mac, UNIX; CharSet can
be numerical value or Charset name like UTF-8
String.GetCharCount(String)
String.GetCharSet(String) // 0 = System; 20127 = ASCII; 65001 = UTF-8
String.GetCount(Substring; String[; SearchOptions; Offset]) // SearchOptions = C,W,?,R
String.GetHash(String[; Options]) // Options = CRC32, MD5, SHA1, SHA256, SHA384,
SHA512 [ <-- only in Aid4Mail eDiscovery]
String.GetPosition(Substring; String[; SearchOptions; Offset]) // SearchOptions = C,
W,?,R
String.GetPositionRight(Substring; String[; SearchOptions; Offset]) // SearchOptions =
C,W
String.Insert(Substring; String; Offset) // if Offset is negative position is
calculated from string end
String.IsSameAs(Pattern; String2[; MatchOptions]) // MatchOptions = ?,R
String.IsSameAs(String1; String2[; MatchOptions]) // MatchOptions = C
String.Pad(String; Width[; Char]) // Negative width pads left side
String.Replace(String; Pattern; NewText[; SearchOptions; Offset]) // SearchOptions =
C,W,?,R,S (S = SmartReplace)
String.Shorten(String; Width[; EndMarker])
String.ToBoolean(String)
String.ToCSV(String)
String.ToDateTime(String; Format)
String.ToNumber(String)
String.ToString(Variable)
String.ToTSV(String[; SubstTab; SubstLB]) //SubstLB="unwrap" or any other substitution
93
Aid4Mail 4 Help
string
String.Trim(String[; Chars; Options]) // Options = Left, Right, LeftRight
String.Unwrap(String)
String.UrlDecode(String)
String.UrlEncode(String)
String.Wrap(String; Width[; Indent])
System.ComputerName
System.DateTime[(Format; "UTC")]
System.LogonName
System.TimeZone
ValueIf(Condition; ValueIfTrue[; ValueIfFalse]) // Condition Operators: =, <> or !=,
<, >, <=, >=
Wait(Time) // Causes script to pause for specified amount of time. Time value is in
milliseconds
// All XML data is stored in UTF-8 format
XML.AddAttribute(XML.Variable; Name; Value)
XML.AddData(XML.Variable; Data)
XML.TagAdd(XML.Variable; TagName; Data) // Opens tag, adds data, then closes it
XML.TagClose(XML.Variable)
XML.TagName(XML.Variable)
XML.TagOpen(XML.Variable; TagName[; Data; CloseIt]) // CloseIt = True/False
2.6.2
Calculate command
This topic documents the mathematics operators and functions supported by the Calculate command
available in the Aid4Mail Script Syntax.
+: operand, executes adding operation
-: operand, executes subtraction operation
*: function, executes multiplying operation
/: function, executes division operation
Sqrt: functions, root of a number. Root can have any degree
Div: functions, executes integer division operation
Mod: functions, executes remainder operation
Int: function, returns the integer part of a number
Frac: function, returns the fractional part of a number
Random: function, returns random number within the range 0 <= value < 1
Trunc: function, truncates a number to an integer
Round: function, returns the value rounded to the nearest whole number
Sin: function, returns the sine of the angle in radians
ArcSin: function, returns the inverse sine of a number
Sinh: function, returns the hyperbolic sine of an angle
Reference Information
94
95
Aid4Mail 4 Help
Reference Information
96
Variance [Data(1)..Data(N): Double] function, calculates statistical sample variance from an array of data
PopnVariance [Data(1)..Data(N): Double] function, calculates the population variance
TotalVariance [Data(1)..Data(N): Double] function, returns the statistical variance from an array of values
Norm [Data(1)..Data(N): Double] function, returns the Euclidean 'L-2' norm
RandG [Mean, StdDev: Double] function, generates random numbers with Gaussian distribution
RandomRange [AFrom, ATo: Integer] function, returns a random integer from a specified range
RandomFrom [Value(1)..Value(N): Double] function, returns a randomly selected element from an array
EnsureRange [AValue, AMin, AMax: Double] function, returns the closest value to a specified value
within a specified range
Example:
Calculate(((1 + 2) * (3 + 4)) / (5 + 6))
2.7
Aid4Mail Console
Aid4Mail Console is the Win32 CLI version of Aid4Mail and its file name is a4m.exe. It is a different
program from the regular GUI version of Aid4Mail (file name Aid4Mail.exe). It is included with the
Aid4Mail Migrator and Aid4Mail Service licenses. And it is available as a bundle option with Aid4Mail
Forensic, Aid4Mail Archivist and Aid4Mail eDiscovery Personal.
Aid4Mail Console can be run from batch files, the Windows Start/Run dialog, and any application that
can execute other programs; conversion options can either be set through command-line switches, an
INI file, or both. Unlike the other versions of Aid4Mail, the Console can process more than one PST file
unattended. This capability is particularly useful if you need to process dozens or hundreds of PST files
in a batch.
The server edition of Aid4Mail Console can be launched as a Windows Service through the Easy
Service Launcher (ESLaunch.exe) utility included in the distribution package. You will find usage
instructions in the ESLaunch.txt file. You can download the server edition from the following link:
http://www.aid4mail.com/get.php?a4m-srv
Aid4Mail Console uses Exit Codes to inform the calling process if a conversion was successful or if
errors occurred.
2.7.1
Command-Line Parameters
Aid4Mail Console supports an array of command-line switches that you can use to configure mail
processing tasks. The command line length should not exceed 2000 characters under Windows 7,
Vista, XP and NT. You can define settings through an INI file to simplify and reduce the length of your
command line (see the INI File Settings topic for details).
Command-line syntax:
a4m.exe Source [Target] [/optional switches] [>filename]
a4m.exe /INI=FileName [/optional switches] [>filename]
a4m.exe [/optional switches] [>filename]
97
Aid4Mail 4 Help
Required parameter for finding the mail to convert unless this information is provided through an INI file.
The value can represent a token (mapi or imap), or a PST, MSG, EML, Mozilla or other generic mailbox
file name or search criteria (allows the wildcards "*" and "?"). Use double quotes if the Source name
contains spaces. Tokens and system variables are supported in the path name.
Use the "mapi" token to access a MAPI profile; the default profile is used if no profile name is specified
through the /S_Profile switch.
Use the "imap" token to retrieve email from an IMAP account. The account logon settings are taken from
the source.imap.ini file (located in the program folder), which you must modify beforehand. Example:
a4m.exe imap %Outlook%\Test.pst
The above example converts mail from your IMAP account to a new PST file called Test.pst, which is
saved in the default file storage location for Office Outlook. You can open the newly created file through
the File/Open/Outlook Data File menu command in Office Outlook (older versions of Outlook may use
slightly different names for the menu command.)
When using the "mapi" and "imap" tokens, you can specify the name of the folder you want to export
from or to. Simply use a colon (:) after the token name followed by the folder path using a backslash to
separate folder names. Use double quotes if it contains spaces. Wildcards are supported. Example.
a4m.exe imap:INBOX\Archives\* %Outlook%\Test.pst
If you are exporting EML, MHT, or MSG files to the EML, MHT, or MSG format, you can use the
{filename} token to instruct Aid4Mail to create target message files that have the same name as the
source mail files.
Options switches
See the following topics for a list of available optional command-line switches:
Source Switches
Target Switches
Reference Information
98
Filter Switches
Other Switches
/INI
/INI=FileName
Use this switch to specify an INI file with settings for Aid4Mail Console. Use double quotes if the file
name contains spaces. Tokens and system variables are supported. Example:
a4m.exe /ini="%MyData%\Aid4Mail Settings.ini"
You do not need to specify a filename when you use this switch if your INI file is named a4m.ini and is
stored in the same folder as a4m.exe (in fact, you can even omit this switch as long as you specify at
least one other switch). See the INI File Settings topic for more information on this feature.
Redirecting output:
You can redirect the output from the console window to a file by ending the command line with a ">"
character followed by a file name. This feature is particularly useful if you plan to run a4m as an
uninterrupted batch process. Progress information and error messages are stored in the specified file. If
an error occurs, no user input is required (like press Enter key to continue) so batch operations can
continue unattended. Alternatively, you can also use the /unattended switch if you do not want to
redirect output.
Note that you cannot use this redirect method from the Windows Run feature. You need to launch
Aid4Mail from the command prompt of the Windows CMD console or a Windows batch file to redirect
output with the ">" symbol.
2.7.1.1
Source Switches
This topic covers Aid4Mail Console optional command-line parameters that control how source mail is
accessed and processed.
/AddWinmailDat
Converts TNEF messages to the RFC 1521 format using the MAPI internal converter and saves the
original TNEF data in a winmail.dat email attachment.
/DelSource=Fast OR Expunge
Permanently deletes source messages that have been successfully processed. The delete feature works
on the following source formats: IMAP accounts, MAPI profiles ("Default message store" only), PST,
MSG, and EML files, and Mozilla mailboxes (including Thunderbird, SeaMonkey, Eudora OSE, and
Netscape). The "Expunge" option is similar to "Fast", but will send an expunge command when
processing an IMAP account; this will permanently remove deleted messages. Only use this feature with
the greatest care as in most cases you will not be able to undelete the source messages. We strongly
recommend that you first test this feature on data that you can fully restore from backups if necessary.
When using this switch, YOU AGREE TO RELEASE FOOKES SOFTWARE AND ITS SUPPLIERS
FROM ANY LIABILITY OR DAMAGES DUE TO THE LOSS OF ANY SUCH DATA OR FILES. Example:
a4m.exe %Outlook%\Outlook.pst D:\Mail\Generic\*.mbox /DelSource=Fast
/emlExt=ext
Enables processing EML files with an extension that is different from the standard ".eml" one. Set the
"ext" value either to the corresponding file extension or use "*" to accept any file extension. Example:
a4m.exe D:\Messages\ D:\Archives\Mail_2011.zip /emlExt=txt
Note that you can also use the /m=eml switch instead of /emlExt. Example:
a4m.exe D:\Messages\*.txt D:\Archives\Mail_2011.zip /m=eml
99
Aid4Mail 4 Help
/f="folder name"
Exports mail from from the specified source folder in a PST file or an Outlook/Exchange store. Use
double quotes if the folder name contains spaces. You can use the wildcards "*" and "?" to broaden the
scope of folder that should match the criteria. Use a backslash "\" character as a separator in a folder
path. Example: Inbox\Urgent ("Urgent" is a subfolder of the "Inbox" folder). Example: if you use /
f="*Urgent", Aid4Mail will export mail from folders called "Urgent", "Inbox\urgent", "Sent Items\No
Reply\URGENT".
If the search subfolders option is set, then the two following examples are equivalent:
a4m.exe %Outlook%\Outlook.pst D:\Mail\Generic\*.mbox /f=Inbox
a4m.exe %Outlook%\Outlook.pst D:\Mail\Generic\*.mbox /f=Inbox\*
If you only want to process the Inbox (without subfolders if any), then add the /s=False switch:
a4m.exe %Outlook%\Outlook.pst D:\Mail\Generic\*.mbox /f=Inbox /s=False
/fast
Aid4Mail does extensive data analysis when reading generic mailbox files, including those created by
Mozilla Thunderbird and Eudora. It does this to avoid missing messages when dealing with mailbox files
that contain a mix of storage formats (e.g. a Mac or UNIX mbox file imported in Windows Thunderbird
with new messages added to it). If you are processing mailbox files that are entirely created by a single
mail program, then you can increase performance without sacrificing reliability by using the /fast switch.
/IgnoreInvalidFormats
Use this switch to ignore invalid file formats that Aid4Mail encounters when processing folders. Invalid
files will be skipped without generating an error Exit Code.
/IncludeAllItems
Includes Calendar, Contacts, Tasks, and other non-email items in an Outlook/Exchange mail store
during processing. By default, Aid4Mail only processes email items. Note that the current version of
Aid4Mail only exports email-related fields, so special data fields used in Calendar, Contacts, Tasks
items are not transferred.
/IncludeTrash
Includes mail stored in the Trash, Junk, and Deleted Items folders during processing. The names of such
folders are stored in the files TrashFiles.dat and TrashFolders.dat that you will find in the Aid4Mail
program folder. You can add more folder names to these two files if necessary (one name per line). The
TrashFolders.dat file is for message folder names created by Outlook and Exchange. Aid4Mail uses the
names stored in TrashFiles.dat to determine which mailbox files from other mail clients contain deleted
or unwanted messages. By default, mail in these folders is ignored.
/IncludeUnpurged
Includes moved and deleted items still present in mailbox files and folders that haven't been compacted
or expunged prior to processing. These type of emails are usually not displayed in your mail program.
Note that if you use this option with Outlook Express .dbx files, processed messages all have a certain
degree of corruption as the deletion process partially damages the stored email. By default, Aid4Mail
skips messages that have been flagged as removed from a mailbox.
/m
/m=calypso OR eml OR eudora OR mc_eudora OR maildir OR mbox OR moz OR msg OR pine
OR pmmail_msg OR takeout OR vault
Tells Aid4Mail what the source mail format is. This switch is useful if Aid4Mail's automatic format
detection fails due to insufficient information. This switch can also be used without specifying a value (/
Reference Information
100
m); in this case Aid4Mail performs less strict format checking on certain mailbox types. The following
switch values are available:
calypso use if source is Calypso Mail or Courier
eml use if source represents eml mail files
eudora use if source is a Qualcomm Eudora MBX file
mc_eudora use if source is a Macintosh Eudora mailbox file
maildir use if source represents Maildir folders
mbox use if source is a generic mailbox file (mbox, Berkeley mail format, BSD mail format, Unix mail
format)
moz use if source is Mozilla Mail, Thunderbird, Eudora OSE, or Netscape
msg use if source represents Outlook MSG mail files
pine use if source is a Pine mbox file with limited "From " escaping
pmmail_msg use if source represents PMMail MSG mail files
takeout use if source represents Google Takeout mbox files
vault use if source represents Google Apps Vault mbox files
Example:
a4m.exe D:\Mail\*. D:\Archives\Backup2012.zip /m=mbox
/MailDelimTest=Strong OR Weak
This feature controls how carefully email separators (From line message boundaries) in mbox-type files
are checked. When using "Strong", Aid4Mail expects a format similar to the one described in the qmail
manual, which is a standard followed by most mail clients (though Aid4Mail does accept a hyphen
or ???@??? for the email address part). When turned off, Aid4Mail will accept any line starting with
"From " as an email separator as long as the next line starts with a valid header field. This means that
many non-standard From line delimiters often appearing in mbox files will be correctly identified. This
option is set to "Strong" by default, which is the recommended value.
With "Strong", processing is slightly slower and may increase the risk that some corrupted or invalid
message delimiters are missed. As a result, multiple emails may be processed as if they are a single
email message.
With "Weak", the setting increases the risk of incorrectly treating a line within an email beginning with
"From " as a message delimiter. If this happens, a single message may get treated as multiple emails.
Another potential issue is that it may miss a valid message delimiter that is followed by an invalid header
line. As a result, multiple emails may be processed as if they are a single email message.
/MapiConvOff
With Outlook 2003 and more recent versions, Aid4Mail uses a special MAPI feature to import/export
mail from Outlook PST and MSG files, and Exchange server stores. The advantage of this method is that
it converts messages with non-Latin characters and certain special email formats more reliably than
other methods. The disadvantage is that it is usually slower than Aid4Mail's alternative method. Add
the /MapiConvOff switch to turn off the special MAPI conversion feature if you are encountering issues
when using it or if conversion speed is critical.
/MapiFixOff
When converting mail from Outlook PST and MSG files, and Exchange server store formats to RFC textbased formats (MIME), Aid4Mail automatically restores original data that is lost by the MAPI converter.
These fixes are necessary to ensure that the converted email is as faithful as possible to the original
email. The disadvantage of this procedure is that it slows down conversion and in some very rare cases
fails to correctly render emails based on unusual formats. Use the /MapiFixOff switch to turn off the
default email fixing feature.
Copyright 2005-2016 Fookes Holding Ltd
101
Aid4Mail 4 Help
/s=True OR False
Includes mail stored in source subfolders when set. This option is on by default so you only need to use
this switch to ignore subfolders during processing. Example: /S=False
/S_Log="file name"
Enables logging of communications between Aid4Mail and the source IMAP account; data is stored in
the specified log file. Use double quotes if the file name contains spaces. The folder name can include
tokens and system variables.
/S_Namespace="IMAP Namespace"
Defines the Namespace for the source IMAP account. Use double quotes if the user name contains
spaces.
/S_Profile="name of MAPI profile"
/S_Profile="IMAP INI file"
If your source mail is defined by the "mapi" token, use this switch to specify a profile name for your
source MAPI account if it is different from your default profile name. Use double quotes if the profile
name contains spaces.
If your source mail is defined by the "imap" token, this switch tells Aid4Mail where to find the logon
settings file for your source IMAP account. If no file path is specified, Aid4Mail looks for it in its program
folder or under the IMAP subfolder. Tokens and system variables are supported. If this setting is not
used, Aid4Mail will look for the source.imap.ini file in the same folder as the a4m.exe program file.
Example: /S_Profile="%MyData%\IMAP Settings.ini"
/S_PW=password
Defines a password for the source PST file or IMAP account. Use double quotes if the password
contains spaces. Note that this password has nothing to do with the profile password, which MAPI
automatically prompts you to enter in a separate dialog box.
/S_UserId="User name"
Defines the logon user name for the source IMAP account. Use double quotes if the user name contains
spaces.
/TocDate="Date format"
This feature is only used when processing Qualcomm's Out mailboxes. When this setting is missing,
Aid4Mail determines the date of sent messages by reading the Out.mbx mailbox email delimiter line. In
most cases this provides fairly accurate dates. However, this does not necessarily match the dates you
see in Eudora, which are taken from the Out.toc file.
Unfortunately, Aid4Mail cannot reliably determine the date format used in Qualcomm Eudora Out.toc
files. However, you can use this switch to provide the appropriate format to enable successful date
conversion for use in other programs.
Use the following letters to indicate the position of the different date elements: h=hour, n=minutes,
m=month, yy=2-digit year, yyyy=4-digit year, ampm=AM or PM.
Examples:
To convert a date like 01:51 PM 3/19/2014, use:
a4m.exe /TocDate="h:n ampm m/d/yyyy"
Reference Information
102
/UseMapiTnefConverter
Converts TNEF messages to the RFC 1521 format with the MAPI internal converter. This switch should
only be used if you are encountering conversion issues with those type of emails.
2.7.1.2
Target Switches
This topic covers Aid4Mail Console optional command-line parameters that control how target mail is
accessed and processed. You will find additional switches listed under the topics Target Format
Switches and Email Contents Switches.
/a
Appends message to target store or mailbox file if it already exists. If this switch is not used, a backup
copy of the mailbox file is created before the export procedure starts. This option is ignored if you are
exporting to an Outlook email profile, or EML, MHT, XLS, DBS, and MSG files.
/b="folder name"
Defines the base folder (or parent folder) in a PST file or Outlook email profile that will receive exported
mail. This option is ignored if you are exporting to other mail formats. Use double quotes if the folder
name contains spaces. Use a backslash "\" character to separate folder names in a path. Example: /
b="Inbox\Imported Mail"
/DisplayName="PST display name"
Defines a display name for a new target PST file. By default, Aid4Mail creates a name like "Imported
Folders (April 14, 2011)" when this switch is not used. This switch is ignored if the target is not a PST
file.
/md5Name
/md5Name=MessageId
Creates MSG, EML, and MHT files with a name based on their MD5 signature. This switch is ignored
with other types of target mail.
By default, the MD5 signature for EML and MHT file names is computed from the full email (message
header + body). When the switch has the "MessageId" value, the MD5 signature for EML and MHT file
names is based on the Message-ID field value. If this field is empty or missing (usually in outbound
messages), Aid4Mail generates the signature from the email date and subject line, or other fields (To,
Cc, Bcc, From delimiter) from the message header if either of those values are blank, or the whole
header.
/t
By default, Aid4Mail normally restores the source folder structure at the target end. Use the /t switch to
save all processed mail into a single target folder. When used with the /xls export option, all email items
are grouped into a single worksheet page. This switch is ignored if you are exporting mail to the /mht
and /dbs formats.
/T_Log="file name"
Enables logging of communications between Aid4Mail and the target IMAP account; data is stored in
the specified log file. Use double quotes if the file name contains spaces. The folder name can include
tokens and system variables.
/T_Namespace="IMAP Namespace"
Defines the Namespace for the target IMAP account. Use double quotes if the user name contains
103
Aid4Mail 4 Help
spaces.
/T_Profile="name of MAPI profile"
/T_Profile="IMAP INI file"
/T_Profile="PDF INI file"
When using the "mapi" token, this switch defines a profile name for your target MAPI account. Use
double quotes if the profile name contains spaces. Aid4Mail will access your default Outlook profile
when this switch is not used.
When using the "imap" token, this switch tells Aid4Mail where to find the logon settings file for your
target IMAP account. If no file path is specified, Aid4Mail looks for it in its program folder or in the IMAP
subfolder. Tokens and system variables are supported. Use double quotes if the profile name contains
spaces. Aid4Mail will look for the target.imap.ini file when this switch is not used. Example: /
T_Profile="%MyData%\IMAP Settings.ini"
If your target is a PDF file, this switch tells Aid4Mail where to find the PDF settings file. If no file path is
specified, Aid4Mail looks for it in its program folder. Tokens and system variables are supported. If this
switch is missing, Aid4Mail will look for the pdf.ini file in the same folder as the a4m.exe program file.
Example: /T_Profile="%MyData%\PDF Settings.ini"
/T_PstSize=Value in GB or MB
If you think your export will exceed the capacity of a single PST file, you can use /T_PstSize switch to
set a threshold value. Setting the value to zero or leaving it blank instructs Aid4Mail to not monitor the
PST file size. Otherwise, Aid4Mail treats values equal to or below 500 as representing gigabytes (GB)
and values above as megabytes (MB). When the size limit is reached, Aid4Mail stops exporting mail to
the current PST file, creates a new PST file based on the name of the first one but with an index number,
and then continues the mail export to the new PST file.
For example, if you set the size limit to 2 GB for a file called Outlook.pst and have 5 GB of mail to
export, Aid4Mail will create the following files on completion:
Outlook.pst
Outlook[001].pst
Outlook[002].pst
Note that Aid4Mail cannot determine exactly when the limit is reached because Outlook uses a data
cache. In other words, Outlook will still send data to the PST file after Aid4Mail has measured the file
size and stopped exporting mail to it. As a result, a PST file may slightly exceed the size limit you set.
To avoid problems, choose a smaller size that ensures your PST file will never get too big.
/T_PW=password
Defines a password for the target PST file or IMAP account. Use double quotes if the password contains
spaces.
PST files: the password enables creating a new password-protected PST file or adding mail to an
existing password-protected PST file. When you create a password-protected ANSI PST file with
Aid4Mail, the high encryption format is used if the password exceeds 8 characters and the weaker
compressible-encryption format is used with shorter passwords. With Unicode PST files, the default
compressible-encryption format is used (high encryption is not supported.) Note that this password has
nothing to do with the profile password, which MAPI automatically prompts you to enter in a separate
dialog box.
/T_UserId="User name"
Defines the logon user name for the target IMAP account. Use double quotes if the user name contains
spaces.
Copyright 2005-2016 Fookes Holding Ltd
Reference Information
104
/TimeZone
Changes the default time zone Aid4Mail uses when setting the date stamp of exported message files
and date values in the corresponding column of MHT target formats. The switch accepts a time zone
value in one of several formats: numerical, time zone abbreviation, time zone in short form, or Windows
registry time-zone name. See the Time Zones topic for more information. If this switch is missing,
Aid4Mail uses UTC time.
/UseDateField
When exporting mail to eml, mht, and msg files, as well as when extracting files (attachments and
embedded contents), Aid4Mail sets the file stamp to match the email date. By default, Aid4Mail uses
the server Received date taken from the header of incoming messages (Aid4Mail always uses the Date
field for outgoing mail). You can use the /UseDateField to tell Aid4Mail to always get the date from the
message header Date field instead of the server Received date.
2.7.1.2.1 Target Format Sw itches
This topic covers Aid4Mail Console optional command-line parameters that determine the target mail
format.
/addresses=csv OR tab OR txt
This feature is ideal if you need to rebuild an address book or to create a mailing list with addresses of
people that have been corresponding with you. Aid4Mail automatically removes duplicates and sorts
addresses in alphabetical order. You can specify the most appropriate output format after the equal sign:
comma separated values (*.csv), tab separated values (*.tab), and plain-text values (*.txt).
/attachments
Exports only the file attachments contained in the processed source mail. Aid4Mail also saves an
Attach.tab file in the target folder, which contains a tab-delimited list of all the extracted attachment files.
/contents
Exports only the file attachments and embedded contents contained in the processed source mail.
Embedded contents (inline attachments) are saved under the "Embedded" folder and file attachments
under the "Attach" folder. Aid4Mail also saves an Attach.tab file in the target folder, which contains a
tab-delimited list of all the extracted files.
/dbs
Similar to the /mht switch, but produces an index file for importing mail data into a database.
/eml
Exports each source mail into a corresponding EML file. The resulting file name is built from the
message's subject line, unless it is specified in the target parameter, or if you use the /md5Name
switch. Aid4Mail also saves a Mail.tab file in the target folder, which contains a tab-delimited list of all
the exported EML files (useful if you want to import mail in a database.) This switch is not required if
your target name includes the .eml file extension.
/mapi
Exports the source mail to a MAPI profile. The profile name is specified through the Target name.
Example:
a4m.exe %Thunderbird%\*.msf "John Doe" /mapi
Note that Aid4Mail now provides an alternative format using the mapi token. Example:
a4m.exe %Thunderbird%\*.msf mapi /T_Profile="John Doe"
105
Aid4Mail 4 Help
/mbox
Exports the mail into an mbox-compatible (generic) mailbox file. This export option is used by default if
none of the export format switches are specified and the target name has a different extension from .eml,
.mht, .msg, .pst, .zip. This switch is not required if your target name includes the .mbox file extension.
/mht
Exports each source mail into a corresponding MHT file (HTML Web Archive). The resulting file name is
built from the message's subject line, unless it is specified in the target parameter. The format is similar
to EML files. MHT files can be viewed in Internet Explorer like a regular HTML file; embedded pictures
are displayed in the browser window and attachments can be extracted by clicking on their link.
Aid4Mail automatically creates web pages that enable you to easily view your converted mail in Internet
Explorer; just open the file index.html in your browser. This switch is not required if your target name
includes the .mht file extension.
/moz
Exports the source mail into a Mozilla-compatible mailbox file (Netscape, Mozilla, Thunderbird, Eudora
OSE).
/msg
Exports each MAPI source mail into a corresponding MSG file. The resulting file name is built from the
message's subject line. The source must be a PST file or a MAPI mail profile. This switch cannot be
used if the source is also MSG files. This switch is not required if your target name includes the .msg
file extension.
/OutputScript="Script Name"
Use the OutputScript switch to load the specified script name. The script name can either be a fully
qualified file name or just a file name without path and extension. See the Writing Aid4Mail Scripts topic
for more information about Output Scripts.
/pdf
Exports mail to Adobe PDF file(s). By default, the PDF format options are taken from the pdf.ini file in
the program folder. You can specify a different configuration file through the /T_Profile command-line
switch. Note that due to third-party licensing terms, the server edition of Aid4Mail Console currently does
not include the PDF export option. This switch is not required if your target name includes the .pdf file
extension.
/pst
Exports the source mail into a standard Outlook PST file (ANSI format). You can use the /b switch
described under Optional Switches to specify which mail folder should be receiving the messages. This
type of PST file has a maximum storage capacity of 2 GB and is compatible with all versions of Office
Outlook. This switch is ignored if you use the "mapi" token (to access a MAPI profile) as the Target
value.
/UnicodePst
Exports the source mail into a Unicode PST file (Outlook 2003 or newer). You can use the /b switch
described above to specify which mail folder should be receiving the messages. This type of PST file has
a maximum storage capacity of 20 GB in Outlook 2003 and 2007, 50 GB in Outlook 2010, 2013 and
2016, and is not compatible with Outlook 97, 98, 2000, and 2002. Note that this switch will create a
regular ANSI PST file if your version of Microsoft Outlook is older than Outlook 2003. This switch is
ignored if you use the "mapi" token (to access a MAPI profile) as the Target value. This switch is not
required if your target name includes the .pst file extension.
/xls
Copyright 2005-2016 Fookes Holding Ltd
Reference Information
106
Similar to the /mht switch, but produces an index file for viewing in Office Excel instead of Internet
Explorer.
/zip
Exports mail into generic mailbox files (mbox) and stores them in a standard ZIP file. Attachments and
embedded contents are stored under subfolders in the ZIP file. The resulting ZIP file is compatible with
all popular ZIP utilities, like WinZip, and with Windows Explorer under Windows XP or more recent. You
must specify a target ZIP file name without wildcards (*, ?). If the target name already exists, Aid4Mail
creates a backup of it and builds a new ZIP file. This switch is not required if your target name includes
the .zip file extension.
2.7.1.2.2 Email Contents Sw itches
This topic covers Aid4Mail Console optional command-line parameters that determine the target mail
format.
/extract
Attachments contained in exported mail are extracted and saved under the "Attach" folder. The
advantage of this method (RFC 1521) is that attachments are easily accessible and the resulting mail
files are often much smaller. The disadvantage with this method is that many mail clients cannot access
the extracted attachments. This switch is ignored if you're exporting mail to an IMAP account or the
MSG format.
/ExtractAll
Attachments and embedded contents contained in exported mail are extracted and saved under two
subfolders. Embedded contents (inline attachments) are saved under the "Embedded" folder and file
attachments under the "Attach" folder. The advantage of this method (RFC 1521) is that attachments are
easily accessible and the resulting mail files are often much smaller. The disadvantage with this method
is that many mail clients cannot access these extracted attachments. This switch is ignored if you're
exporting mail to an IMAP account or the MSG format.
/lf=Mac OR UNIX OR Linux
The line-format switch can have one of three values: "Mac", "UNIX", or "Linux". It is used when you
export your email to EML or generic mailbox formats. Only use it if you plan to transfer your converted
files to a non-Windows operating system. Aid4Mail will adjust the format of line endings of exported
emails to suit the chosen operating system. Choose "UNIX" for Mac OS X and "Mac" for Mac OS 9.
/rich
Attachments in exported mail are discarded. Only the message text, formatting, and embedded
contents are preserved. This switch can significantly reduce the size of the exported mail.
/plain
Attachments and embedded contents (e.g. pictures, sounds) in exported mail are discarded. Only the
plain message text with no formatting is preserved. Email headers are also simplified to preserve only
the most important fields (like subject, date, sender, and recipients). Messages based on the UTF-8
character set are converted to plain ANSI characters based on the default Windows character set. In
most cases, messages will be easier to read when UTF-8 is converted to ANSI. However, characters
that do not exist in the default character set are converted to a question mark (?). If messages become
unreadable because of this, then you should use the /utf8 switch described below instead of /plain. The /
plain switch can significantly reduce the size of the exported mail.
/PreserveSMTP
By default, Aid4Mail adds or modifies header fields (like folder names and status flags) to preserve
Copyright 2005-2016 Fookes Holding Ltd
107
Aid4Mail 4 Help
source metadata and conform to the target format. Use this switch when you need to have an unmodified
copy of the source SMTP header in the target MIME format.
/utf8
This switch is similar to the /plain switch described above. The only difference is that UTF-8 characters
are not converted to ANSI, they are preserved as-is. In most cases, messages will be easier to read
when UTF-8 is converted to ANSI. However, characters that do not exist in the default character set are
converted to a question mark (?). If messages become unreadable because of this, then you should use
the /utf8 switch instead of /plain. The /utf8 switch can significantly reduce the size of the exported mail.
2.7.1.2.3 Special IMAP Sw itches
This topic covers optional command-line parameters that control how Aid4Mail Console operates.
Some IMAP servers can be quite fussy when it comes to email structure formatting, contents, and size.
During the upload procedure, emails that don't conform to the server's requirements are simply rejected.
Microsoft Exchange servers are particularly strict in this respect.
To avoid email loss, Aid4Mail offers several options to control what happens to rejected emails:
/BadImapMailFolder="folder name"
Tells Aid4Mail where to locally save rejected emails. Use double quotes if the folder name contains
spaces. The folder name can include tokens and system variables. This switch is only valid when used
together with /SaveBadImapMail.
/SaveBadImapMail
Tells Aid4Mail to save a copy of rejected emails in EML format. The files are saved under the Mail
subfolder in the folder specified by the /BadImapMailFolder switch. If no folder is defined, Aid4Mail then
chooses the location of the target IMAP log file if set, or the Aid4Mail program folder.
/ShrinkBadImapMail
Many IMAP servers reject emails that are too big. You can use this switch to tell Aid4Mail to try again
after extracting attachment from the rejected email. Extracted attachments are stored under the
Contents subfolder in the parent folder of the EML files. This switch is only valid when used together with
/SaveBadImapMail.
2.7.1.3
Filter Switches
This topic covers Aid4Mail Console optional command-line parameters that control how source mail is
filtered.
Reference Information
108
/dr=2009/01/01-2009/12/31
In the following example, Aid4Mail will only process emails that were received after year 2009:
/dr=2010/01/01In the following example, Aid4Mail will only process emails that were received before year 2009:
/dr=-2008/12/31
/ds=yyyy/mm/dd-yyyy/mm/dd
This switch is nearly identical to the /dr switch described above except that it is based on the email sent
date. This usually corresponds to the date stored in the message header Date field. You cannot use
the /ds switch at the same time as the other date switches.
/dc=yyyy/mm/dd-yyyy/mm/dd
This switch is nearly identical to the /dr switch described above except that it is based on the mail client
program's download date. You cannot use the /dc switch at the same time as the other date switches.
Not all email client programs record the download date. When it is missing, Aid4Mail uses the email
received or sent date instead. For emails that are stored as EML, MHT, or CNM files, Aid4Mail takes the
download date from the file date stamp. However, this may not correspond to the actual download date.
109
Aid4Mail 4 Help
just a file name without path and extension. If you leave out the file path, Aid4Mail will first look for the
script in the "Scripts" subfolder and then the program folder. See the Writing Aid4Mail Scripts topic for
more information about Filter Scripts.
Reference Information
110
Other Switches
This topic covers optional command-line parameters that control how Aid4Mail Console operates.
/DataFolder
Defines the default folder for source and target files (including log files) when file names are specified
without a folder location. The folder name can include tokens and system variables. Example:
/DataFolder="%Documents%\Migrations\"
/ErrorLog
/ErrorLog="file name"
See the topic Error Log File for details about this switch. The folder name can include tokens and
system variables.
/ImapLog
Creates a log file storing all communications between Aid4Mail and an IMAP server. This feature is
useful to identify issues encountered when connecting to an IMAP account or when uploading/
downloading messages to it. These log files are saved in the "My Documents" folder and use the .log file
extension (unless you specified a fully qualified file name through the /S_Log and /T_Log switches). This
switch is ignored when using /S_Log or /T_Log.
Note that your IMAP logon credentials are stored as plain text in these log files so make sure you keep
them in a secure location.
/Log
/Log="file name"
Use this switch to save the progress information to a text file. It is faster than redirecting output to a text
file. The folder name can include tokens and system variables. If you omit the file name, Aid4Mail will
create a log file stored in its program folder called ProcessLog.txt.
/NoFilterLog
If you are going to process large amounts of emails, you can slightly improve speed by using the /
NoFilterLog switch. When added, this switch tells Aid4Mail to hide progress information related to
skipped messages as a result of Aid4Mail's filter settings.
/NoLimit=True
/NoLimit=False
Add the /NoLimit=True switch to your Aid4Mail command line if you need to run performance tests on an
unlimited number of emails during trial mode. Use /NoLimit=False to preserve the subject line in
exported emails. Only use this switch during trial mode or else you will get a command-line error
message. See the Trial Mode topic for details.
/QuitIfTrial
Terminates program execution if Aid4Mail starts in trial mode. When this happens, Aid4Mail returns an
EXIT code with a value of 6.
/SessionName="session name"
Use this switch to display a session name in the console window or the output file (if redirected). This
feature helps you identify multiple simultaneous instances of the console. When used, Aid4Mail saves a
text file with conversion statistics; the file name is based on the session name. The text file is saved in
the program folder unless the session name includes a folder name to another location. The folder name
111
Aid4Mail 4 Help
2.7.2
See the following topics for a list of available INI file settings used to control the mail conversion process:
Source Settings
Target Settings
Filter Settings
Other Settings
Reference Information
2.7.2.1
112
Source Settings
This page lists settings you can use in the Aid4Mail Console INI file to control the handling of source
mail.
DelSource=Fast or Expunge or False
Use this setting to permanently delete source messages that have been successfully processed. The
delete feature works on the following source formats: IMAP accounts, MAPI profiles ("Default message
store" only), PST, MSG, and EML files, and Mozilla mailboxes (including Thunderbird, SeaMonkey,
Eudora OSE, and Netscape). This feature is turned off by default. The "Expunge" option is similar to
"Fast", but will send an expunge command when processing an IMAP account; this will permanently
remove deleted messages. Only use it with the greatest care as in most cases you will not be able to
undelete your processed source messages. We strongly recommend that you first only test this feature
on data that you can fully restore from backups to ensure no valuable mail is lost. The /DelSource
command-line switch overrides this setting.
When using the DelSource setting, YOU AGREE TO RELEASE FOOKES SOFTWARE AND ITS
SUPPLIERS FROM ANY LIABILITY OR DAMAGES DUE TO THE LOSS OF ANY SUCH DATA OR
FILES.
emlExt=ext
Use this setting if you need to process EML files that do not have the standard .eml file extension. Set
the "ext" value either to the corresponding file extension or use "*" to accept any file extension. The /
emlExt command-line switch overrides this setting. Example: emlExt=txt
IgnoreInvalidFormats=True or False
Use this setting to report or ignore invalid file formats that Aid4Mail encounters when processing folders.
When set to True, invalid files are skipped without generating an error Exit Code. This setting is set to
False by default. The /IgnoreInvalidFormats command-line switch overrides this setting.
ImapSource=FileName.ini
Tells Aid4Mail where to find the logon settings file for your source IMAP account. If no file path is
specified, Aid4Mail looks for it in its program folder. Tokens and system variables are supported. If this
setting is not used, Aid4Mail will look for the source.imap.ini file in the same folder as the a4m.exe
program file. Example: ImapSource=%MyData%\IMAP Settings.ini
IncludeAllItems=True or False
Use this setting when processing Office Outlook mail to include Calendar, Contacts, Tasks, and other
non-email items during the export. By default, Aid4Mail will only process email items. The /
IncludeAllItems command-line switch overrides this setting.
IncludeTrash=True or False
Use this setting to process mail stored in the Trash, Junk, and Deleted Items folders. The names of
such folders are stored in the files TrashFiles.dat and TrashFolders.dat that you will find in the Aid4Mail
program folder. You can add more folder names to these two files if necessary (one name per line). The
TrashFolders.dat file is for message folder names created by MAPI clients like Office Outlook. Aid4Mail
uses the names stored in TrashFiles.dat to determine which mailbox files from other mail clients contain
deleted or unwanted messages. By default, mail in these folders is ignored. The /IncludeTrash
command-line switch overrides this setting.
IncludeUnpurged=True or False
Use this setting to process moved and deleted items found in mailbox files and folders that haven't been
compacted or expunged. These email items are not usually visible in your mail client. Note that if you
113
Aid4Mail 4 Help
use this option with Outlook Express .dbx files, processed messages all have a certain degree of
corruption as the deletion process partially damages the remaining email. By default, Aid4Mail skips
messages that have been marked as deleted from a mailbox. The /IncludeUnpurged command-line
switch overrides this setting.
MailDelimTest=Strong or Weak
This feature controls how carefully email separators (From line message boundaries) in mbox-type files
are checked. When using "Strong", Aid4Mail expects a format similar to the one described in the qmail
manual, which is a standard followed by most mail clients (though Aid4Mail does accept a hyphen
or ???@??? for the email address part). When turned off, Aid4Mail will accept any line starting with
"From " as an email separator as long as the next line starts with a valid header field. This means that
many non-standard From line delimiters often appearing in mbox files will be correctly identified. This
option is set to "Strong" by default, which is the recommended value. The /MailDelimTest command-line
switch overrides this setting.
With "Strong", processing is slightly slower and may increase the risk that some corrupted or invalid
message delimiters are missed. As a result, multiple emails may be processed as if they are a single
email message.
With "Weak", the setting increases the risk of incorrectly treating a line within an email beginning with
"From " as a message delimiter. If this happens, a single message may get treated as multiple emails.
Another potential issue is that it may miss a valid message delimiter that is followed by an invalid header
line. As a result, multiple emails may be processed as if they are a single email message.
SearchSubFolders=True or False
Tells Aid4Mail whether to search subfolders at the location pointed by the Source criteria. This option is
on by default so you only need to include this setting if you want to ignore subfolders. The /s commandline switch overrides this setting.
SkipDuplicates=none or folder or all
Use this setting to discard duplicates of emails that have already been saved in the target mail folder.
Use the "folder" value to check for duplicates at the folder level only and the "all" value to check for
duplicates irrespective of the target folder. By default, Aid4Mail does not skip duplicates. Note that
checking for duplicates with this option may decrease processing speed and require more system
resources. The /SkipDups and /SkipAllDups command-line switches override this setting.
Aid4Mail checks for duplicates by comparing the value of the Message-ID field in each processed email
header. If this field is empty or missing (usually in outbound messages), Aid4Mail uses other header
data for the comparison. In MAPI messages (from Office Outlook and Microsoft Exchange), Aid4Mail
uses the email creation and submit dates, subject line, and stored message size. In other types of
messages, Aid4Mail uses the email date and subject line for the comparison, or other header fields (To,
Cc, Bcc, From delimiter) if either of those values are missing, or the whole header if none of those fields
contain any data.
SkipDuplicatesFile=Incremental Log File
You can specify a log file to keep track of which emails have been processed. A new log file is created if
it doesn't exist. Before Aid4Mail processes a source email, it checks if a matching reference exists in
the log file. The email is skipped if its reference is found. Otherwise, if it isn't blocked by other filter
settings, the email is processed and its reference is stored in the log file. This feature is useful when you
need to perform incremental email exports. You must set the SkipDuplicates option to "folder" or "all"
otherwise this setting will be ignored.
Note that a log file created with the SkipDuplicates FOLDER option should not be used with the
Copyright 2005-2016 Fookes Holding Ltd
Reference Information
114
SkipDuplicates ALL option, and vice versa. Email references are not generated the same way under
each option so matches would not be recognized.
SourceFormat=format
Use this setting if Aid4Mail fails to correctly identify your source mail format. The /m command-line
switch overrides this setting. The following values are available:
QuickCheck - use for less in-depth automatic format checking. Useful if source files have an unusual
format
calypso use if source is Calypso Mail or Courier
eml use if source represents eml mail files
eudora use if source is a Qualcomm Eudora MBX file
mc_eudora use if source is a Macintosh Eudora mailbox file
maildir use if source represents Maildir folders
mbox use if source is a generic mailbox file (mbox, Berkeley mail format, BSD mail format, Unix mail
format)
moz use if source is Mozilla Mail, Thunderbird, Eudora OSE, or Netscape
msg use if source represents Outlook MSG mail files
pine use if source is a Pine mbox file with limited "From " escaping
pmmail_msg use if source represents PMMail MSG mail files
takeout use if source represents Google Takeout mbox files
vault use if source represents Google Apps Vault mbox files
SourceLog="file name"
Enables logging of communications between Aid4Mail and the source IMAP account; data is stored in
the specified log file. Use double quotes if the file name contains spaces. The folder name can include
tokens and system variables. The /S_Log command-line switch overrides this setting.
SourceMail=file name or specs, or "mapi" or "imap" tokens
The value can represent a token (mapi or imap), or a PST, MSG, EML, Mozilla or other generic mailbox
file name or search criteria (allows the wildcards "*" and "?"). Tokens and system variables are
supported in the path name.
Use the "mapi" token to access a MAPI profile; the default profile is used if no profile name is specified
with the MapiProfile setting or the /n switch.
Use the "imap" token to retrieve email from an IMAP account. The account logon settings are taken from
the source.imap.ini file (located in the program folder), which you must modify beforehand.
When using the "mapi" and "imap" tokens, you can specify the name of the folder you want to export
from. Simply use a colon (:) after the token name followed by the folder path using a backslash to
separate folder names. Wildcards are supported. Example.
SourceMail=imap:INBOX\Archives\*
SourceNamespace=IMAP Namespace
Defines the Namespace for the source IMAP account. The /S_Namespace command-line switch
overrides this setting.
SourcePassword=password
Use this setting to specify a password for the source PST file or IMAP account. The /S_PW commandline switch overrides this setting.
PST files: Note that this password has nothing to do with the profile password, which MAPI will prompt
Copyright 2005-2016 Fookes Holding Ltd
115
Aid4Mail 4 Help
UnzipSource=True or False
Tells Aid4Mail whether source mail is contained in a ZIP file that needs to be unzipped prior to
processing. Do not use this setting with Aid4Mail ZIP Archives.
2.7.2.2
Target Settings
This page lists settings you can use in the Aid4Mail Console INI file to control the creation of target mail.
Addresses=txt or csv or tab
Exports extracted email addresses to the specified file format. Aid4Mail automatically removes
duplicates and sorts addresses in alphabetical order. You can specify the most appropriate output
Copyright 2005-2016 Fookes Holding Ltd
Reference Information
116
format after the equal sign: comma separated values (*.csv), tab separated values (*.tab), and plain-text
values (*.txt). By default, Aid4Mail uses the plain-text format. The /Addresses command-line switch
overrides this setting.
AddWinmailDat=True or False
When UseMapiTnefConverter and AddWinmailDat are set to True, TNEF data is saved in a winmail.dat
attachment when converting mail to the RFC 1521 format. Set to False if you do not wish to create
winmail.dat attachments. The /AddWinmailDat command-line switch overrides this setting.
AppendMail=True or False
Appends message to target mailbox file if it already exists. If this switch is not used, a backup copy of
the mailbox file is made before the export procedure starts. This option is ignored if you are exporting to
Outlook or Exchange profile, EML, MHT, XLS, DBS, and MSG files. By default, Aid4Mail does not
append messages to an existing mailbox. The /a command-line switch overrides this setting.
BadImapMailFolder=folder name
Tells Aid4Mail where to locally save emails rejected by the target IMAP server. The folder name can
include tokens and system variables. This option is only valid when used together with the
SaveBadImapMail option.
ExportFormat=format
Defines the target format of exported messages. By default, Aid4Mail restores the full email contents on
export. The /extract, /ExtractAll, /rich, /plain, and /utf8 command-line switches override this setting.
Available format values and their purpose are listed below:
full
The full email contents are restored on export.
extract
Attachments contained in exported mail are extracted and saved under the "Attach" folder. The
advantage of this method (RFC 1521) is that attachments are easily accessible and the resulting mail
files are often much smaller. The disadvantage with this method is that many mail clients cannot access
the extracted attachments. This value is ignored if you are exporting mail to an IMAP account or the
MSG format.
ExtractAll
Attachments and embedded contents contained in exported mail are extracted and saved under two
subfolders. Embedded contents (inline attachments) are saved under the "Embedded" folder and file
attachments under the "Attach" folder. The advantage of this method (RFC 1521) is that attachments are
easily accessible and the resulting mail files are often much smaller. The disadvantage with this method
is that many mail clients cannot access these extracted attachments. This value is ignored if you are
exporting mail to an IMAP account or the MSG format.
rich
Attachments in exported mail are discarded. Only the message text, formatting, and embedded
contents are preserved. This value can significantly reduce the size of the exported mail.
plain
Attachments and embedded contents (e.g. pictures, sounds) in exported mail are discarded. Only the
plain message text with no formatting is preserved. Email headers are also simplified to preserve only
the most important fields (like subject, date, sender, and recipients). Messages based on the UTF-8
character set are converted to plain ANSI characters based on the default Windows character set. In
most cases, messages will be easier to read when UTF-8 is converted to ANSI. However, characters
Copyright 2005-2016 Fookes Holding Ltd
117
Aid4Mail 4 Help
that do not exist in the default character set are converted to a question mark (?). If messages become
unreadable because of this, then you should use the utf8 value described below instead of plain. The
plain value can significantly reduce the size of the exported mail.
utf8
This value is similar to the plain value described above. The only difference is that UTF-8 characters are
not converted to ANSI, they are preserved as-is. In most cases, messages will be easier to read when
UTF-8 is converted to ANSI. However, characters that do not exist in the default character set are
converted to a question mark (?). If messages become unreadable because of this, then you should use
the utf8 value instead of plain. The utf8 value can significantly reduce the size of the exported mail.
ExportSingleFolder=True or False
Depending on the criteria that you use, Aid4Mail creates subfolders in the target folder to match the
source folder structure. If you do not want exported mail files split up into several subfolders, set the
ExportSingleFolder value to True to force Aid4Mail to store all files in a single disk folder. Note that when
TargetFormat is set to xls, all email items are grouped into a single worksheet page. This setting is
ignored if TargetFormat is set to mht or dbs. The /t command-line switch overrides this setting.
HeaderBasedMd5Names=True or False
When False, the MD5 signature for EML and MHT file names is computed from the full email (message
header + body). When True, the MD5 signature is based on the Message-ID field value. If this field is
empty or missing (usually in outbound messages), Aid4Mail generates the signature from the email date
and subject line, or other fields (To, Cc, Bcc, From delimiter) from the message header if either of those
values are blank, or the whole header. This setting was introduced in Aid4Mail 2.11 and is True by
default.
LineFormat=windows or mac or unix
The LineFormat setting controls the type of line break characters Aid4Mail uses to create EML or
generic mailbox formats. It can have one of three values: "Mac", "UNIX", or "Windows". By default
Aid4Mail uses the Windows line format. Only use other values if you plan to transfer your converted files
to a non-Windows operating system. Aid4Mail will adjust the format of line endings of exported emails to
suit the chosen operating system. The /Lf command-line switch overrides this setting.
MapiConvOff=True or False
Under Outlook 2003 and more recent, Aid4Mail uses a MAPI function to convert mail between RFC textbased formats (MIME) and proprietary Outlook PST and MSG files, and Exchange server store formats.
The advantage of this method is that it converts messages with non-Latin characters and certain special
email types more reliably than the alternative method. The disadvantage of this MAPI function is that it is
usually slower than the other Aid4Mail method. Set MapiConvOff to True to turn off the special MAPI
conversion feature. The /MapiConvOff command-line switch overrides this setting.
MapiFixOff=True or False
When converting mail from Outlook PST and MSG files, and Exchange server store formats to RFC textbased formats (MIME), Aid4Mail performs a series of fixes on the messages converted by MAPI. These
fixes are necessary to make the converted email as faithful as possible to the original email and avoid
loss of data. The disadvantage of this procedure is that it slows down conversion and in some very rare
cases some emails don't convert correctly. Set MapiFixOff to True to turn off the email fixing feature. The
/MapiFixOff command-line switch overrides this setting.
MapiTarget=profile name
Use this switch to specify a profile name for your target MAPI account if it is different from your default
profile name. This switch is only valid if the "mapi" token is used for the target mail. The /MapiTarget
command-line switch overrides this setting.
Copyright 2005-2016 Fookes Holding Ltd
Reference Information
118
MD5name=True or False
Use this setting to produce MSG, EML, and MHT files with an MD5 signature as file name. This switch
only works with the msg, eml, and mht TargetFormat values. By default Aid4Mail creates file names
based on the message subject line. Set MD5name to True to use MD5 names. The method used to
calculate MD5 values depends on the HeaderBasedMd5Names setting.
With Outlook MSG files, the MD5 signature is based on the unique Message-ID field, which is normally
present in the header of all received email messages. If this field is empty or missing (usually in
outbound messages), Aid4Mail uses the email creation and submit dates, subject line, and stored
message size.
The /MD5name command-line switch overrides this setting.
OutputScript=Script Name
Use this setting to load the specified script name. The script name can either be a fully qualified file
name or just a file name without path and extension. See the Writing Aid4Mail Scripts topic for more
information on Output Scripts. The /OutputScript command-line switch overrides this setting.
PreserveSMTP=True or False
By default, Aid4Mail adds or modifies header fields (like folder names and status flags) to preserve
source metadata and conform to the target format. Set this option to True when you need to have an
unmodified copy of the source SMTP header in the target MIME format. The /PreserveSMTP commandline switch overrides this setting.
PstDisplayName=PST display name
Use this setting to define a display name when exporting to a new PST file. By default, Aid4Mail creates
a name like "Imported Folders (July 01, 2012)" when this setting is not used. The /PstDisplayName
command-line switch overrides this setting.
SaveBadImapMail=True or False
Tells Aid4Mail to save a copy of emails rejected by the target IMAP server in EML format. The files are
saved under the Mail subfolder in the folder specified by the BadImapMailFolder option. If no folder is
defined, Aid4Mail then chooses the location of the target IMAP log file if set, or the Aid4Mail program
folder.
ShrinkBadImapMail=True or False
Many IMAP servers reject emails that are too big. You can use this switch to tell Aid4Mail to try again
after extracting attachment from the rejected email. Extracted attachments are stored under the
Contents subfolder in the parent folder of the EML files. This option is only valid when used together with
the SaveBadImapMail option.
TargetFormat=format
Use this setting to define the target mail format if this information cannot be determined from your target
name. The /pst, /unicodepst, /msg, /eml, /mbox, /moz, /dbs, /mht, /xls, /zip, /imap, /attachments, /
contents, /addresses command-line switches override this setting. The following format values are
available:
mbox
exports the mail into an mbox-compatible (generic) mailbox file. This export option is used by default if
none of the export format switches are specified and the target name has a different extension from .eml,
.mht, .msg, .pst, .zip.
119
Aid4Mail 4 Help
moz
exports the source mail into a Mozilla-compatible mailbox file (Netscape, Mozilla, Thunderbird).
pst
exports the source mail into a standard Outlook PST file (ANSI format). This type of PST file has a
maximum storage capacity of 2 GB and is compatible with all versions of Office Outlook. This switch is
ignored if you use the "mapi" token (to access a MAPI profile) as the Target value.
unicodepst
exports the source mail into a Unicode PST file (Outlook 2003 or newer). This type of PST file has a
maximum storage capacity of 20 GB in Outlook 2003 and 2007, 50 GB in Outlook 2010, 2013 and 2016,
and is not compatible with Outlook 97, 98, 2000, and 2002. Note that this switch will create a regular
ANSI PST file if your version of Microsoft Outlook is older than Outlook 2003. This switch is ignored if
you use the "mapi" token (to access a MAPI profile) as the Target value.
msg
exports each MAPI source mail into a corresponding MSG file. The source must be a PST file or a MAPI
mail profile. This switch cannot be used if the source is also MSG files.
eml
exports each source message into a corresponding EML file. Aid4Mail also saves a Mail.tab file in the
target folder, which contains a tab-delimited list of all the exported EML files (useful if you want to import
mail in a database.) This setting is not required if you specify a target name with the .eml extension.
mht
exports each source mail into a corresponding MHT file (HTML Web Archive). The format is similar to
EML files. MHT files can be viewed in Internet Explorer like a regular HTML file; embedded pictures are
displayed in the browser window and attachments can be extracted by clicking on their link. Aid4Mail
automatically creates web pages that enable you to easily view your converted mail in Internet Explorer;
just open the file index.html in your browser. This setting is not required if you specify a target name with
the .mht extension.
xls
similar to the mht value, but produces an index file for viewing in Office Excel instead of Internet
Explorer.
dbs
similar to the mht value, but produces an index file for importing mail data into a database.
attachments
exports only the file attachments contained in the processed source mail. Aid4Mail also saves an
Attach.tab file in the target folder, which contains a tab-delimited list of all the extracted attachment files.
contents
exports only the file attachments and embedded contents contained in the processed source mail.
Embedded contents (inline attachments) are saved under the "Embedded" folder and file attachments
under the "Attach" folder. Aid4Mail also saves an Attach.tab file in the target folder, which contains a
tab-delimited list of all the extracted files.
addresses
exports extracted email addresses extracted from source messages. Aid4Mail automatically removes
duplicates and sorts addresses in alphabetical order.
Reference Information
120
pdf
exports mail to Adobe PDF file(s). By default, the PDF format options are taken from the pdf.ini file in the
program folder. You can specify a different configuration file through the TargetProfile setting or the /
T_Profile command-line switch. Note that due to third-party licensing terms, the server edition of
Aid4Mail Console currently does not include the PDF export option.
zip
exports mail into generic mailbox files (mbox) and stores them in a standard ZIP file. Attachments and
embedded contents are stored under subfolders in the ZIP file. The resulting ZIP file is compatible with
all popular ZIP utilities, like WinZip, and with Windows Explorer under Windows XP or more recent. You
must specify a target ZIP file name without wildcards (*, ?). If the target name already exists, Aid4Mail
creates a backup of it and builds a new ZIP file. This setting is not required if you specify a target name
with the .zip extension.
TargetLog="file name"
Enables logging of communications between Aid4Mail and the target IMAP account; data is stored in
the specified log file. Use double quotes if the file name contains spaces. The folder name can include
tokens and system variables. The /T_Log command-line switch overrides this setting.
TargetMail=file or folder name, "mapi", or "imap" token
Use this setting to define a target file or folder name receiving exported mail. Tokens and system
variables are supported. If you choose to export mail to the EML or MSG format, TargetMail should
represent a folder. If you export to an mbox format, TargetMail can either represent a folder or file name.
If the target name ends with a backslash (\), the contents of each mail folder is stored into its own mbox
file with a name matching that of the mail folder. If you want the exported files to use the same name as
the source files, but with a different extension, use the asterisk wildcard followed by the extension.
Example: *.txt -> files are created with the name of the source file and the TXT extension.
Use the "mapi" token to access a MAPI profile; the default profile is used if no profile name is specified
with the MapiProfile setting or the /n switch.
Use the "imap" token to export email to an IMAP account. The account logon settings are taken from
the target.imap.ini file (located in the program folder), which you must modify beforehand. When using
the "imap" token, you can specify the name of the folder you want to export to. Simply use a colon (:)
after the token name followed by the folder path using a backslash to separate folder names. Example.
TargetMail=imap:INBOX\Imports 2012\
If you are exporting EML, MHT, or MSG files to the EML format, you can use the {filename} token to
instruct Aid4Mail to create target message files that have the same name as the source mail files.
TargetNamespace=IMAP Namespace
Defines the Namespace for the target IMAP account. The /T_Namespace command-line switch overrides
this setting.
TargetPassword=password
Use this setting to specify a password for the target PST file or IMAP account. The /T_PW commandline switch overrides this setting.
PST files: the password will create a new password-protected PST file or allow adding mail to an existing
password-protected PST file. When you create a password-protected ANSI PST file with Aid4Mail, the
high encryption format is used if the password exceeds 8 characters and the weaker compressibleencryption format is used with shorter passwords. With Unicode PST files, the default compressibleencryption format is used (high encryption is not supported.) Note that this password has nothing to do
Copyright 2005-2016 Fookes Holding Ltd
121
Aid4Mail 4 Help
with the profile password, which MAPI will prompt you to enter in a separate dialog box.
IMAP accounts: if the TargetPassword setting and /T_PW switch are not used, Aid4Mail takes the
password from the target imap.ini file.
TargetPstFolder=folder name
Defines the base folder (or parent folder) in a PST file or Outlook email profile that will receive exported
mail. This setting is ignored if you are exporting to other mail formats. Use a backslash "\" character to
separate folder names in a path. The /b command-line switch overrides this setting.
TargetPstMaxSize=size in GB or MB
If you think your export will exceed the capacity of a single PST file, you can use TargetPstMaxSize to
set a threshold value. Setting the value to zero or leaving it blank instructs Aid4Mail to not monitor the
PST file size. Otherwise, Aid4Mail treats values equal to or below 500 as representing gigabytes (GB)
and values above as megabytes (MB). When the size limit is reached, Aid4Mail stops exporting mail to
the current PST file, creates a new PST file based on the name of the first one but with an index number,
and then continues the mail export to the new PST file. The /T_PstSize command-line switch overrides
this setting.
For example, if you set the size limit to 2 GB for a file called Outlook.pst and have 5 GB of mail to
export, Aid4Mail will create the following files on completion:
Outlook.pst
Outlook[001].pst
Outlook[002].pst
Note that Aid4Mail cannot determine exactly when the limit is reached because Outlook uses a data
cache. In other words, Outlook will still send data to the PST file after Aid4Mail has measured the file
size and stopped exporting mail to it. As a result, a PST file may slightly exceed the size limit you set.
To avoid problems, choose a smaller size that ensures your PST file will never get too big.
TargetUserName=Logon User name
Use this setting to specify the logon user name for the target IMAP account. The /T_UserId commandline switch overrides this setting. If the TargetUserName setting and /T_UserId switch are not used,
Aid4Mail takes the user name from the target imap.ini file.
TargetProfile=MAPI profile name
TargetProfile=IMAP INI file
TargetProfile=PDF INI file
If your target mail is defined by the "mapi" token, use this setting to specify a profile name for your target
MAPI account if it is different from your default profile name. The /T_Profile command-line switch
overrides this setting.
If your target mail is defined by the "imap" token, this setting tells Aid4Mail where to find the logon
settings file for your target IMAP account. If no file path is specified, Aid4Mail looks for it in its program
folder. Tokens and system variables are supported. If this setting is not used, Aid4Mail will look for the
target.imap.ini file in the same folder as the a4m.exe program file. The /T_Profile command-line switch
overrides this setting.
If your target is a PDF file, this setting tells Aid4Mail where to find the PDF settings file. If no file path is
specified, Aid4Mail looks for it in its program folder. Tokens and system variables are supported. If this
setting is not used, Aid4Mail will look for the pdf.ini file in the same folder as the a4m.exe program file.
The /T_Profile command-line switch overrides this setting.
TimeZone=value
Copyright 2005-2016 Fookes Holding Ltd
Reference Information
122
Use this setting to change the default time zone Aid4Mail uses when setting the date stamp of exported
message files and date values in the corresponding column of MHT target formats. The switch accepts a
time zone value in one of several formats: numerical, time zone abbreviation, time zone in short form, or
Windows registry time-zone name. See the Time Zones topic for more information. The /TimeZone
command-line switch overrides this setting. Example: TimeZone=PST
UseDateField=True or False
By default, incoming message dates used for creating file date stamps (eml, mht, msg, extracted
attachments) and Microsoft Exchange delivery time are based on the server Received date instead of the
header Date field. Set UseDateField to True to instruct Aid4Mail to extract the date from the message
Date field instead of the server Received date. The /UseDateField command-line switch overrides this
setting.
UseMapiTnefConverter=True or False
Prior to Aid4Mail v2.1, both TNEF and regular emails were processed by the MAPI RFC 1521 Converter
when the MapiConvOff setting was False. The MAPI RFC 1521 Converter does a good job converting
regular emails to the standards-compliant RFC 1521 format, but it produces poor results with TNEF
messages (to avoid data loss Aid4Mail always saved the TNEF information in a winmail.dat attachment).
For better results, set this option to False to use Aid4Mail's own converter whenever a TNEF email is
encountered. The /UseMapiTnefConverter command-line switch overrides this setting.
XMailer=value
When converting outgoing mail from Outlook or Exchange, Aid4Mail has to reconstruct the email header
during the conversion procedure. To easily identify such headers, Aid4Mail inserts a standard X-Mailer
field with the value "FOOKES SOFTWARE Aid4Mail (MAPI source mail)". You can define an alternative
value through the XMailer setting. If the value is left blank then Aid4Mail will not insert the X-Mailer field in
reconstructed email headers.
2.7.2.3
Filter Settings
This page lists settings you can use in the Aid4Mail Console INI file to control the filtering of source mail.
FilterDateField=Sent or Received or Stored
This setting is used in conjunction with the FilterDateRange setting. It tells Aid4Mail which date field to
use when filtering emails by date. By default, Aid4Mail uses the Sent date. The /ds, /dr, /dc commandline switches override this setting.
FilterDateRange=yyyy/mm/dd-yyyy/mm/dd
Defines a date range filter. Dates use the international yyyy/mm/dd format (4-digit year/2-digit month/2digit day). A hyphen is used to separate the two values that define the date range. The date on the left
defines the start of the date range and the date on the right defines the end of the date range. You can
leave out one of the date fields to include all messages at either end of the date-range spectrum. The /
ds, /dr, /dc command-line switches override this setting.
In the following example, Aid4Mail will only process emails that were received during year 2009:
FilterDateRange=2009/01/01-2009/12/31
In the following example, Aid4Mail will only process emails that were received after year 2009:
FilterDateRange=2010/01/01In the following example, Aid4Mail will only process emails that were received before year 2009:
FilterDateRange=-2008/12/31
123
Aid4Mail 4 Help
Other Settings
This page lists miscellaneous settings you can use in the Aid4Mail Console INI file to control mail
conversion.
DataFolder=folder name
Defines the default folder for source and target files (including log files) when file names are specified
without a folder location. The folder name can include tokens and system variables. The /DataFolder
command-line switch overrides this setting. Example:
DataFolder="%Documents%\Migrations\"
ErrorLog=FileName
See the Error Log File topic for details about this switch. The /ErrorLog command-line switch overrides
this setting.
Fast=True or False
Copyright 2005-2016 Fookes Holding Ltd
Reference Information
124
Aid4Mail does extensive text parsing and format analysis when reading generic mailbox files, including
those created by Mozilla Thunderbird and Eudora. It does so to ensure it doesn't miss any emails when
processing mailbox files that contain a mix of storage formats (e.g. a Mac or Unix mbox file imported in
Windows Thunderbird with new messages added to it). If you are processing mailbox files that are
entirely created by a single mail client, then you can increase performance without sacrificing reliability
by setting Fast to True. The /Fast command-line switch overrides this setting.
ImapLog=True or False
Set this option to True to create a log file storing all communications between Aid4Mail and an IMAP
server. This feature is useful to identify issues encountered when connecting to an IMAP account or
when uploading/downloading messages to it. These log files are saved in the "My Documents" folder and
use the .log file extension.
Note that your IMAP logon credentials are stored as plain text in these log files so make sure you keep
them in a secure location.
NoLimit=True or False
Set this option to True if you need to run performance tests on an unlimited number of emails during trial
mode. Use NoLimit=False to preserve the subject line in exported emails. Only use this switch during
trial mode or else you will get a command-line error message. The /NoLimit command-line switch
overrides this setting. See the Trial Mode topic for details.
QuitIfTrial=True or False
Set this option to True to terminate program execution if Aid4Mail starts in trial mode. If such a
termination occurs, Aid4Mail returns an EXIT code with a value of 6. The /QuitIfTrial command-line switch
overrides this setting.
SessionName=session name
Use this option to display a session name in the console window or the output file (if redirected). This
feature helps you identify multiple simultaneous instances of the console. The /SessionName commandline switch overrides this setting. When used, Aid4Mail saves a text file with conversion statistics; the
file name is based on the session name. The text file is saved in the program folder unless the session
name includes a folder name to another location. The folder name can include tokens and system
variables. Examples:
SessionName=Account072
SessionName=%AllUsersProfile%\Aid4Mail Migration\Account 072
When associated with a CSV file, you can use an asterisk as a placeholder for the row number.
Example:
SessionName=Account-*
As a result, when row #3 out of 100 rows is processed, your session name becomes Account-003.
TempFolder=folder name
By default, Aid4Mail stores temporary files in the Windows Temp folder under the logon user folder. Use
this setting to specify an alternative location for storing temporary files. The folder name can include
Tokens and system variables. The /Temp command-line switch overrides this setting. Example:
TempFolder=%AllUsersProfile%\Aid4Mail\Temp
Unattended=True or False
Set this option to True to run Aid4Mail without user intervention. This feature is particularly useful if you
plan to run Aid4Mail Console in an uninterrupted batch process. If an error occurs, no user input is
required (like press Enter key to continue) so batch operations can continue unattended. The /
Unattended command-line switch overrides this setting.
Copyright 2005-2016 Fookes Holding Ltd
125
2.7.3
Aid4Mail 4 Help
With the two command-line switches in the above example, Aid4Mail will encrypt all the password
columns in My CSV File.csv based on your provided password (/pw). The new CSV file with the
encrypted password columns will then be saved to My CSV File.safe.csv. If you do not specify a file
path, Aid4Mail will look for your CSV file in its program folder. Alternatively, you can use tokens and
system variables to specify a standard folder location. Here's an example with a CSV file stored in your
Windows My Documents folder:
a4m.exe /EncryptCsv="%Documents%\Accounts.csv" /pw="123456"
If you like, Aid4Mail also lets you specify which columns to encrypt and the target CSV file name. You
just need to add the /CsvColumns and /TargetCsv switches. The /CsvColumns switch requires a commadelimited list of column names. Example:
Reference Information
126
In the above example, Aid4Mail will encrypt the four columns in Accounts.csv that match the names
listed by /CsvColumns. The encrypted CSV file version will then be saved as Accounts-Team01.safe.
csv.
As a convenience, you can also instruct Aid4Mail to encrypt all logon credentials (user logon names and
passwords), by using the asterisk character as a value for the CsvColumns switch (/CsvColumns=*).
Example:
a4m.exe /EncryptCsv=Accounts.csv /pw="123456" /CsvColumns=*
You should avoid encrypting data in a CSV file that already contains encrypted data. But if you choose
to do so, make sure you use the same password and select data columns that are not yet encrypted.
Aid4Mail will not encrypt the data if your password is not valid.
Important: If you plan to use your encrypted CSV file with Aid4Mail Console Launcher, make sure its file
name has the .safe.csv extension. Otherwise Aid4Mail Console Launcher won't know it's encrypted
and therefore won't prompt you for the password.
127
Aid4Mail 4 Help
file, you can resume processing by adding the /Resume switch. Example:
a4m.exe /csv="%Documents%\Migrations\Students.csv" /Resume
The above command line will process the remaining accounts listed in the Students.csv file located
under the C:\\Documents\Migrations folder. This feature will only work in the presence of a file called
Students.csv.results and stored in the same folder as the Students.csv file. Note that the resume
feature requires the order of the accounts listed in Students.csv to be the same as during the previous
migration.
d) Complete command-line:
Additional command-line switches are available to further refine the handling of CSV-based migrations.
You can tell Aid4Mail to process specific data rows in the CSV file by using the /csv-index switch. The /
resume switch adds options to define which accounts should be processed; either only those that failed
to migrate any mail in the previous migration (/Resume=Failed), just those that hadn't been processed
yet (/Resume=NotDone), or both types (/Resume=All). Finally you can use the /DataFolder switch to
specify a default folder for source and target files (like CSVs, log files, etc.) Note that the resume switch
is ignored if your command-line includes the /csv-index switch. Examples:
a4m.exe /csv="My CSV File.csv" /csv-index="1,7,21-25" /pw="My Password" /DataFolder="%
Documents%\Migrations\"
a4m.exe /csv="My CSV File.csv" /pw="My Password" /Resume=Failed /DataFolder="%
Documents%\Migrations\"
Uses the Accounts.csv file placed either in the Aid4Mail Console folder or the Aid4Mail AppData folder.
Processes the first account only.
a4m.exe /csv /csv-index=1
Migrates the first 20 accounts listed in the Teachers.safe.csv CSV file under the C:\
\Documents\Migrations folder. Uses 123456 to decrypt protected data.
a4m.exe /csv="%Documents%\Migrations\Teachers.safe.csv" /csv-index=1-20 /pw="123456"
Migrates accounts number 1, 7, and 21 to 25 listed in the Teachers.csv CSV file located under the C:\
\Documents\Migrations folder.
a4m.exe /csv="%Documents%\Migrations\Teachers.csv" /csv-index=1,7,21-25
Reference Information
2.7.4
128
1. How to Opt-In
To opt-in to receiving email notifications, simply run Aid4Mail Console with the following two commandline switches (replacing "user@aid4mail.com" with your own address):
a4m.exe /Notify=user@aid4mail.com /NotifyCommand=opt-in
After doing so, you will receive a message sent from our server to your email address. It will ask you to
confirm your opt-in request by clicking on the provided link. You will only start receiving notifications after
you have completed the double opt-in procedure.
2. How to Opt-Out
After opting-in with an email address, you can opt-out at any time by running Aid4Mail Console with the
following two command-line switches (replacing "user@aid4mail.com" with your own address):
a4m.exe /Notify=user@aid4mail.com /NotifyCommand=opt-out
This command will be ignored if your email is not opted-in or has already been opted-out.
129
Aid4Mail 4 Help
You can verify the status of your email address (whether it is opted-in, opted-out, or not recognized) at
any time. Use the following two command-line switches to display the status in the Aid4Mail Console
output (replacing "user@aid4mail.com" with your own address):
a4m.exe /Notify=user@aid4mail.com /NotifyCommand=status
2.7.5
Reference Information
130
131
Aid4Mail 4 Help
important@fookes.com
+mailbag assistant
Aid4Mail will only accept messages that were sent to the <important@fookes.com> address and
mention either the aid4mail or mailbag assistant products in the email.
2.7.6
2.7.7
Exit Codes
Aid4Mail Console produces one of the following Exit Codes when it terminates processing:
0 = no error detected
1 = command-line error
2 = source file not found or format not recognized
3 = one or more errors occurred during mail processing (see error log for details)
4 = could not run console or unexpected fatal error
5 = no messages found in source location
6 = program terminated in response to the QuitIfTrial setting
7 = no messages due to error accessing source account or mailbox
8 = no messages due to error accessing target account or mailbox
9 = processing was aborted by user
10 = incorrect password for encrypted CSV file
101 to 111 = a license validation error was detected (only occurs with a key file)
Reference Information
2.7.8
132
Command-Line Examples
This page covers some common email conversion examples using Aid4Mail Console.
1. Outlook Express to Outlook or Exchange
a4m.exe %OE%\*.dbx mapi
Imports mail from Outlook Express and appends it to the default Outlook email profile. The %OE% token
tells Aid4Mail to look for the Outlook Express DBX files in the default storage location.
a4m.exe %OE%\*.dbx mapi /b="Imported Mail"
Similar to the previous example except that the source folder hierarchy is created under the Outlook or
Exchange "Imported Mail" folder (which is created if it doesn't exist) instead of the root folder. This
approach ensures imported mail is not mixed with current mail.
a4m.exe %OE%\*.dbx mapi /T_Profile="John Doe" /b="Imported Mail"
Similar to the previous example except that mail is exported to the "John Doe" email profile instead of
the default profile.
a4m.exe %OE%\*.dbx %Outlook%\Outlook.pst /a /T_PstSize=20
Imports mail from Outlook Express and appends it to the default Outlook.pst file. The %OE% token tells
Aid4Mail to look for the Outlook Express DBX files in the default storage location. When the target PST
file reaches a size of 20 GB, Aid4Mail stops transferring mail to it, creates a new Outlook[001].pst file
and resumes mail export to the new PST until the size limit is reached, and so on.
a4m.exe "T:\Thumbdrive Data\*.dbx" %Outlook%\OE.pst /IncludeTrash /IncludeUnpurged
Exports all Outlook Express messages, including unpurged and deleted mail, from the "T:\Thumbdrive
Data\" folder and stores them in the OE.pst file under the default Outlook files folder. Once completed,
you can open the OE.pst file through the File/Open/Outlook Data File menu command in Microsoft
Outlook (older versions of Outlook may use slightly different names for the menu command.)
a4m.exe "\\PC1\Outlook Express\*.dbx" "\\PC2\Outlook Files\OE Mail.pst"
Exports messages contained in the DBX mailbox files under the "Outlook Express" folder on PC1 to
Imports locally stored mail (not IMAP folders) from Thunderbird and appends it to the default Outlook
email profile. The %Thunderbird% token tells Aid4Mail to look for the Thunderbird mailbox files in the
default storage location.
a4m.exe %Thunderbird%\*.* mapi /m=moz /b="Imported Mail"
Similar to the previous example except that the source folder hierarchy is created under the Outlook or
Exchange "Imported Mail" folder (which is created if it doesn't exist) instead of the root folder. This
approach ensures imported mail is not mixed with current mail.
a4m.exe "%Thunderbird%\Local Folders\*.*" mapi /m=moz /T_Profile="John Doe" /
b="Imported Mail"
Similar to the previous example except that mail is taken from Thunderbird's Local Folders store and is
exported to the "John Doe" email profile instead of the default profile.
a4m.exe %Thunderbird%\*.* %Outlook%\Outlook.pst /m=moz /a /T_PstSize=20
Copyright 2005-2016 Fookes Holding Ltd
133
Aid4Mail 4 Help
Imports locally stored mail (not IMAP folders) from Thunderbird and appends it to the default Outlook.pst
file. The %Thunderbird% token tells Aid4Mail to look for the Thunderbird mailbox files in the default
storage location. When the target PST file reaches a size of 20 GB, Aid4Mail stops transferring mail to
it, creates a new Outlook[001].pst file and resumes mail export to the new PST until the size limit is
reached, and so on.
a4m.exe "T:\Thumbdrive Data\*.*" %Outlook%\TBird.pst /m=moz /IncludeTrash /
IncludeUnpurged
Exports all Thunderbird messages, including unpurged and deleted mail, from the "T:\Thumbdrive Data\"
folder and stores them in the TBird.pst file under the default Outlook files folder. Once completed, you
can open the TBird.pst file through the File/Open/Outlook Data File menu command in Microsoft Outlook
(older versions of Outlook may use slightly different names for the menu command.)
a4m.exe "\\PC1\Thunderbird\*.*" "\\PC2\Outlook Files\TBird Mail.pst" /m=moz
Exports messages contained in the Thunderbird mailbox files under the Thunderbird folder on PC1 to the
"TBird Mail.pst" file on PC2.
Imports mail from the default Outlook email profile and appends it to the Thunderbird local mail store.
The %Thunderbird% token tells Aid4Mail to look for Thunderbird's default storage location (under "Local
Folders").
a4m.exe mapi "%Thunderbird%\Imported Mail\" /moz
Similar to the previous example except that the source folder hierarchy is created under the Thunderbird
"Imported Mail" folder (which is created if it doesn't exist) instead of the root folder of "Local Folders".
This approach ensures imported mail is not mixed with current mail.
a4m.exe mapi "%Thunderbird%\Imported Mail\" /S_Profile="John Doe" /
f="Inbox\Archives" /moz
Similar to the previous example except that mail is taken from the "John Doe" email profile instead of the
Outlook's default profile. Only mail under the "Inbox\Archives" folder is exported to Thunderbird.
a4m.exe "T:\Thumbdrive Data\Outlook.pst" "%Thunderbird%\Imported Mail\" /
IncludeAllItems /IncludeTrash /moz
Exports all Outlook items (mail, notes, contacts, calendar, etc.), including deleted and Junk mail, from
the "T:\Thumbdrive Data\" folder and stores them under the "Imported Mail" folder in Thunderbird. If the
Outlook.pst includes related split files (Outlook[001].pst, Outlook[002].pst, etc.), Aid4Mail will process
them all sequentially.
a4m.exe "\\PC1\Thunderbird\*.*" "\\PC2\Outlook Files\TBird Mail.pst" /m=moz
Exports messages contained in the Thunderbird mailbox files under the Thunderbird folder on PC1 to the
"TBird Mail.pst" file on PC2.
Exports messages from the default Outlook email profile and stores them under the the current folder or
the "My Documents" folder instead if it is write protected. The resulting mailbox files are named
according to the source mail folder names are are stored in the mbox format. Emails are appended to
existing mbox files.
Copyright 2005-2016 Fookes Holding Ltd
Reference Information
134
Exports mail from the Outlook.pst store in the "T:\Thumbdrive Data\" folder and saves them in mbox
format with the .mbx extension under the "Imported Mail" subfolder in the Windows "My Documents"
folder. If the Outlook.pst includes related split files (Outlook[001].pst, Outlook[002].pst, etc.), Aid4Mail
will process them all sequentially.
a4m.exe "T:\Thumbdrive Data\*.*" mapi /m=mbox
Imports mail from mbox files under the "T:\Thumbdrive Data\" folder and appends them to the default
Outlook email profile.
a4m.exe "%Documents%\Imported Mail\*.mbx" %Outlook%\Mbox_Archives_2011.pst /
T_PstSize=20 /m=mbox
Imports mail stored in mbox files with the .mbx extension and saves them to the Mbox_Archives_2011.
pst store. The %Documents% token tells Aid4Mail to look for the mbox files under the Windows "My
Documents" folder. Because the "/a" append switch is not used here, Aid4Mail always creates a new
PST file. If the Mbox_Archives_2011.pst file already exists, Aid4Mail renames it to preserve a backup
copy. When the target PST file reaches a size of 20 GB, Aid4Mail stops transferring mail to it, creates a
new Mbox_Archives_2011[001].pst file and resumes mail export to the new PST until the size limit is
reached, and so on.
a4m.exe %Netscape%\Inbox.snm %Outlook%\Outlook.pst /t /a /b="Inbox\Netscape"
Exports messages from Netscape's Inbox mailbox to the "Inbox/Netscape" folder in Outlook.pst.
Aid4Mail automatically creates the target folder and PST file if they do not exist.
a4m.exe "D:\My Mail\*.msg" "%Documents%\MSG mail." /t /mbox
Converts all MSG files under the "D:\My Mail" folder and stores them in the "MSG mail" mbox file under
the Windows "My Documents" folder.
a4m.exe "T:\Thumbdrive Data\Archives.pst" %Documents%\Mail.txt /t /plain
Saves mail from Archives.pst to the single mbox file Mail.txt in the Windows "My Documents" folder.
Messages are saved as plain text (attachments and embedded contents are discarded).
Exports all EML message files under the "Thumbdrive Data" folder into the "Imported Mail" folder of the
default Outlook email profile.
a4m.exe "%Documents%\Mail Archives\*.eml" %Outlook%\Archives.pst /a
Appends all EML message files under the "Mail Archives" folder to the Archives.pst file (Aid4Mail
creates if it it doesn't already exist). Once completed, you can open the Archives.pst file through the
File/Open/Outlook Data File menu command in Microsoft Outlook (older versions of Outlook may use
slightly different names for the menu command.)
a4m.exe mapi "%Documents%\Imported Mail\*.eml"
Exports messages from the default Outlook email profile and saves them under the "Imported Mail"
folder as individual EML message files. The source folder hierarchy is reproduced under the target folder.
a4m.exe "T:\Thumbdrive Data\*.pst" "%Documents%\Imported Mail\" /eml /ExtractAll
Processes all PST files under the "Thumbdrive Data" folder. Each message is saved as an individual
EML file under the "Imported Mail" folder. The source folder hierarchy is reproduced under the target
folder. All attachments and embedded contents are extracted from the messages and stored under the
Copyright 2005-2016 Fookes Holding Ltd
135
Aid4Mail 4 Help
Exports email messages from the Backup_2012.pst file to the "Backups\2012" folder in the "John Doe"
email profile.
a4m.exe "mapi:Backups\2012" %Outlook%\Backup_2012.pst /S_Profile="John Doe"
Exports email messages from the "Backups\2012" folder in the "John Doe" email profile to the
Backup_2012.pst file (based on the Unicode format if you have Outlook 2003 or newer).
a4m.exe mapi mapi /S_Profile="John Doe" /T_Profile=Backups /IncludeAllItems
Exports all items (emails, appointments, contacts, tasks, etc.) contained in the "John Doe" email profile
to the "Backups" email profile.
a4m.exe mapi:Inbox\* "mapi:Inbox\Imported Mail" /S_Profile="John Doe" /
T_Profile=Backups
Exports email messages from the Inbox folder and its subfolders in the "John Doe" email profile to the
"Inbox\Imported Mail" subfolder in "Backups" email profile.
a4m.exe mapi "T:\Thumbdrive Data\MSG Files\" /S_Profile="John Doe" /IncludeAllItems /
msg
a4m.exe mapi "T:\Thumbdrive Data\MSG Files\*.msg" /S_Profile="John Doe" /
IncludeAllItems
Exports all items (emails, appointments, contacts, tasks, etc.) contained in the "John Doe" email profile
to the "MSG Files" folder as Outlook MSG files.
a4m.exe "mapi:Inbox\" "%Documents%\MSG Files\*.msg" /S_Profile="John Doe"
Exports mail from the Inbox folder in the "John Doe" email profile to the "MSG Files" subfolder under the
Windows "My Documents" folder.
a4m.exe "T:\Thumbdrive Data\MSG Files\*.msg" mapi:Imports /IncludeAllItems /
T_Profile="John Doe"
Exports all items (emails, appointments, contacts, tasks, etc.) stored in Outlook MSG files under the
"MSG Files" folder to the "Imports" folder in the "John Doe" email profile.
Exports all messages from an IMAP account to the "Imported Mail" folder in the default Outlook email
profile. The IMAP logon settings are taken from the source.imap.ini file (placed in the program folder),
which you must modify beforehand.
a4m.exe imap mapi /S_Profile="Gmail.imap.ini"
Exports all messages from a Gmail account to the default Outlook email profile. The IMAP logon
settings are taken from the Gmail.imap.ini file (placed in the program folder), which you must modify
beforehand.
a4m.exe imap mapi /S_UserId=JDoe /S_PW="secret password" /T_Profile="John Doe"
Exports all messages from an IMAP account to the "John Doe" email profile. Aid4Mail uses the "JDoe"
user ID and password to connect to the IMAP account; other IMAP settings are taken from the source.
Copyright 2005-2016 Fookes Holding Ltd
Reference Information
136
imap.ini file (placed in the program folder), which you must modify beforehand.
a4m.exe imap %Outlook%\Backup.pst
Exports all messages from an IMAP account to the Backup.pst file in the Outlook data folder. The IMAP
logon settings are taken from the source.imap.ini file (placed in the program folder), which you must
modify beforehand.
a4m.exe mapi imap /T_UserId="John Doe" /T_PW="secret password"
Exports mail from the default Outlook email profile to an IMAP account. Aid4Mail uses the "John Doe"
user ID and password to connect to the IMAP account; other IMAP settings are taken from the target.
imap.ini file (placed in the program folder), which you must modify beforehand.
a4m.exe %Outlook%\Backup.pst imap
Exports mail from the Backup.pst file in the Outlook data folder to an IMAP account. The IMAP logon
settings are taken from the target.imap.ini file (placed in the program folder), which you must modify
beforehand.
Exports all messages under the Inbox folder of the source IMAP account to the "Inbox/Exports" folder of
the target IMAP account. The source IMAP logon settings are taken from the source.imap.ini file and
the target settings from the target.imap.ini file (placed in the program folder), which you must modify
beforehand.
a4m.exe imap imap /S_Profile="Yahoo.imap.ini" /T_Profile="Gmail.imap.ini"
Exports all messages from a Yahoo! Mail to a Gmail account. The source IMAP logon settings are taken
from the Yahoo.imap.ini file and the target settings from the Gmail.imap.ini file (placed in the program
folder), which you must modify beforehand.
9. Archiving email
a4m.exe "%Thunderbird%\*.*" "T:\Thumbdrive Data\Backup.zip" /m=moz
Archives Thunderbird's locally stored mail in the Backup.zip archive file. File attachments and embedded
contents are detached from the messages and stored under the Attach and Embedded subfolders
respectively; these contents are easy accessible by opening Backup.zip in Windows Explorer or a ZIP
utility.
a4m.exe "T:\Thumbdrive Data\Backup.zip" "mapi:Restored Mail"
Copies all mail from the Backup.zip archive file to the default Outlook email profile under the "Restored
Mail" folder. Detached attachments and embedded contents are re-inserted into their corresponding
messages during the export.
a4m.exe "%Documents%\MSG Files\*.msg" "%Documents%\Archives\Mail_2012.pdf"
Copies the contents of MSG files under the "MSG Files" folder to the "Mail_2012.pdf" Adobe file.
Settings that control the PDF format and how emails are saved into the PDF file are defined through the
pdf.ini file (placed in the program folder).
a4m.exe %Outlook%\Outlook.pst "%Documents%\Mail\db.csv" /OutputScript="Export-csv"
Uses the "Export-csv" script to export mail from Outlook.pst to the db.csv file. The data in CSV format
can then easily be imported into a database.
137
Aid4Mail 4 Help
Exports mail from the default Outlook email profile to the Mail.txt file. File attachments and embedded
contents are detached from the messages and stored under the Attach and Embedded subfolders
respectively.
a4m.exe mapi:Important %Documents%\Web /mht >log.txt
Converts mail in the "Important" folder in default Outlook email profile to MHT files with an index.html file
for viewing in Internet Explorer. Progress information and error messages are redirected from the console
window to the log.txt file.
Merges all the mbox files under the "Mail Archives" folder into one file called "All Mail.mbox".
a4m.exe "%Documents%\Mail Files\*.eml" "T:\Thumbdrive Data\Mail.mbox" /s=False
Exports EML mail from the "Mail Files" folder (but not subfolders) to the "Mail.mbox" file.
a4m.exe %Outlook%\*.pst mapi /T_Profile=Archive
Merges mail from all the source PST files into the target mail store attached to the Archive profile.
a4m.exe %Outlook%\*.pst d:\Mail\Archives\Merged.pst /a
Merges mail from all the source PST files into the target Merged.pst file.
Extracts mail from the default Outlook email profile received during April 2012 and matching one of the
email addresses listed in the "VIP Email Addresses.lst" file (placed in the program folder). Matching
messages are saved as MSG files under the "April 2012" folder and then deleted from the default
Outlook email profile.
Exports Thunderbird messages that contain JPG images, or .mov and .avi movie files (using the Has jpg
mov avi.s4f script) to EML files. File attachments and embedded contents are detached from the
messages and stored under the Attach and Embedded subfolders respectively.
Converts Thunderbird's locally stored mail to EML files under the "Mail Archives" folder. EML file names
are based on their message's subject line.
a4m.exe "\\PC1\Mail Files\*.eml" \\PC2\Outlook\Imports.pst
Exports EML messages from the "Mail Files" folder on PC1 to the "Imports.pst" file on PC2.
a4m.exe "%Documents%\MSG Files\*.msg" "%Documents%\EML Files\{filename}.eml"
Converts MSG mail files under the "MSG Files" folder to EML files under the "EML Files" folder. The
{filename} token tells Aid4Mail to base the EML file names on those of source files.
Reference Information
2.8
138
Email Notifications
Email notifications are used to alert you when a migration/conversion session starts and ends as well as
when an account fails to process. This feature frees you up from having to regularly monitor Aid4Mail
Console Launcher's progress on premise.
In order to work, Aid4Mail Console Launcher needs access to our server on the web (www.fookes.com)
and you will have to double opt-in your email address. Note that this notification feature never stores your
actual email address on our server (only an MD5 hash value), nor do we pass it on to anyone. With this
feature you will only receive notifications concerning your current Aid4Mail migration/conversion session.
To receive email notifications, open the Notifications menu and choose the Opt-In command. If you
haven't provided an email address in the Settings dialog box, you will be prompted to enter it at this
stage. On receiving your opt-in request, our server will send you a confirmation email within a couple of
minutes. When it reaches you, please click on the confirmation link to finalize the opt-in procedure.
Although email notifications work well most of the time, we cannot guarantee that the feature will be
100% reliable. Email messaging is not a fault free system, and so there is no guarantee that a
notification sent from our server will always reach your Inbox.
Copyright 2005-2016 Fookes Holding Ltd
139
Aid4Mail 4 Help
Before relying on the email notification feature, we recommend that you run a test after you've opted-in
(use the Notifications > Test Email Address menu command). There's always the risk that your email
service or your client program will block, delete, or send the notification message to your Junk folder.
Notifications are automatically sent to you from our noreply@fookes.com email address. If possible,
please add that email address to your white list.
You can opt-out from these notifications at any time by choosing the Notifications > Opt-Out menu
command.
2.9
IMAP Settings
Aid4Mail needs IMAP setting details to connect to a remote mail account using the IMAP protocol.
These settings can either be edited through the IMAP Settings screen in the Aid4Mail GUI program or by
editing an INI file in a text editor. The settings INI files are stored either in the Aid4Mail program folder or
under the Aid4Mail AppData (or Application Data) folder. The file name starts with the settings name
followed by the extension ".imap.ini". For example, the settings called "source" are stored in a file called
"source.imap.ini"
Aid4Mail uses the TCP component from the Synapse library to access an IMAP account. Features
supported by Synapse TCP include IPv4, IPv6, SSL/TLS, SOCKS4/4a/SOCKS5 proxy servers (outgoing
connections and limited incoming), and TCP through an HTTP proxy tunnel.
Reference Information
140
You should only set the "Max. folder depth" field if the target IMAP account only supports a limited
depth of folders. For example, GMX Mail only supports 3. With some accounts running under a Dovecot
IMAP server, the maximum folder depth may be set by the administrator.
Use the "Max. folder length" field if your target IMAP account imposes a limit on the length of folder
names (number of characters). Most IMAP servers allow folder names with more than 100 characters so
this field can be left blank. Some popular mail services like Outlook.com, GMX Mail and Zoho Mail only
allow folder names with less than 100 characters (30 for Outlook.com and GMX, 50 for Zoho), so to
ensure successful exports you need to set this field to the appropriate maximum value.
Proxy Settings
All settings on this Proxy screen are ignored if the Server Name field is left blank or if the Type field is
set to None. Aid4Mail supports SOCKS4 and SOCKS5 proxy servers, and tunneling through an HTTP
proxy server. Select the appropriate proxy protocol from the drop-down list in the Type field.
141
Aid4Mail 4 Help
Port: 993
Connection Security: SSL/TLS
Max. folder length: 100
FastMail
The folder hierarchy displayed through the FastMail web interface is consistent with the folder hierarchy
available through the IMAP protocol.
Server Name: imap.messagingengine.com
Port: 993
Connection Security: SSL/TLS
Gmail
If you haven't already done so, please make sure to Enable IMAP in Gmail before connecting to your
account with Aid4Mail. And if you're using a standard Gmail account, you'll also have to temporarily
allow less secure apps access. Furthermore, you'll have to set up an application-specific password for
Aid4Mail if you have protected your account with Google's 2-Step authentication.
Although Gmail supports a multi-level folder structure through IMAP, this is not the case with the web
interface which only displays one level of folders called "labels" and limits their length to 40 characters.
Subfolder names are part of the label name and separated with a forward slash character. Example:
Folder1/Folder2/Folder3. Depending on how you manage you mail on Gmail, you may have many
folders/labels with duplicate mail. If you are exporting mail from a Gmail account, you can filter out
duplicates by setting the "Check for Duplicates Across Folders" option under the Advanced Options
menu and the "Do not add duplicate messages" setting on the Export Options screen. To optimize this
duplicates filtering feature, Aid4Mail processes the "[Gmail]/All Mail" folder last.
Beware! Gmail enforces daily bandwidth limits. As of this writing, you can upload up to 500 MB and
download up to 2,500 MB of email per day. Furthermore, the maximum email size you can upload is 35
MB (including all attachments).
Server Name: imap.gmail.com
Port: 993
Connection Security: SSL/TLS
GMX Mail
Note that GMX Mail only allows folder structures no more than three levels deep (Folder1\Folder2
\Folder3) and does not permit the use of certain characters in the folder name that most IMAP servers
accept (like +, #, [, ], !, "). Aid4Mail automatically corrects invalid folder names on export to GMX, but
you must set the "Max. folder depth" field to 3 and the "Max. folder length" field to 30 in the configuration
settings.
Server Name: imap.gmx.com
Port: 993
Connection Security: SSL/TLS
Max. folder depth: 3
Reference Information
142
Lotus Domino
The folder hierarchy displayed through the Lotus Domino interface should in most cases be consistent
with the folder hierarchy available through the IMAP protocol. However, the IMAP protocol does not have
access to views that are part of the Notes mail file template, such as the Draft and Sent view. Here's
what the IBM Knowledge Center says on the subject:
"Some aspects of a mail file are structured in template items that are visible only to a IBM Lotus Notes
client, and as such are not available to IMAP clients. As a result, IMAP clients display certain folders
and views in a mail file differently from Notes clients. For instance, from an IMAP client, the Inbox and
Trash folders, and any public folders, appear as IMAP mailboxes. Also, hidden and private folders are
not visible to IMAP clients. And finally, IMAP clients do not display views that are part of the Notes mail
file template, such as the Draft and Sent view."
Please contact your mail account administrator to find the appropriate Server Name for your account.
Server Name: imap.host.name
Port: 993
Connection Security: SSL/TLS
Outlook.com
The folder hierarchy displayed through the Outlook.com interface is consistent with the folder hierarchy
available through the IMAP protocol. Some common characters are not accepted in the folder name.
These include &, <, >, :, ", ', (, ), +, ;, /, \. Aid4Mail automatically corrects invalid folder names on export
to Outlook.com.
Server Name: imap-mail.outlook.com
Port: 993
Connection Security: SSL/TLS
Max. folder length: 30
Yahoo! Mail
Please note that, at this time of writing, IMAP access to a Yahoo! Mail account is not officially
supported by Yahoo. As a result, there is no guarantee that this option will be available in the future or
that it will work the same way.
143
Aid4Mail 4 Help
Although Yahoo! Mail supports a multi-level folder structure through IMAP, this is not the case with the
web interface which only displays one level of folders and limits their length to 30 characters. Subfolder
names are part of the top level name and separated with a forward slash character. Example: Folder1/
Folder2/Folder3.
Server Name: imap.mail.yahoo.com
Port: 993
Connection Security: SSL/TLS
Zoho Mail
If you haven't already done so, please make sure to enable IMAP access before connecting to your
account with Aid4Mail. You will find the option in the Zoho Mail web app under Settings > Mail > POP/
IMAP > IMAP Access > Status.
The folder hierarchy displayed through the Zoho Mail web interface is consistent with the folder hierarchy
available through the IMAP protocol. In both access methods, folder names allow up to 50 characters.
Server Name: imap.zoho.com
Port: 993
Connection Security: SSL/TLS
Max. folder length: 50
2.10
Reference Information
144
stored under the Windows Temp folder. Typically something like this:
C:\Users\{User}\AppData\Local\Temp\AttachmentsNotFound.log
Add the section [SubstPaths] to the Tokens.ini file followed by the old drive/path names and their
corresponding new values. Example:
[SubstPaths]
D:\=C:\
C:\=\\server\c$\
C:\Documents and Settings\William\=C:\Documents and Settings\Bill\
Typically, you will only enter one item under the [SubstPaths] section. But if your mail files have been
moved around several times, you may have several different path references that need correcting. In this
case, Aid4Mail will test each item sequentially until it finds the file or reaches the end of the list. You do
not need to enter the full path to the attachments folder, but only the start until the changed part.
Example:
[SubstPaths]
C:\Program Files\Eudora
C:\Program Files\Eudora
C:\Program Files\Eudora
C:\Program Files\Eudora
Pro\=C:\Program Files\Eudora 7\
4\=C:\Program Files\Eudora 7\
5\=C:\Program Files\Eudora 7\
6\=C:\Program Files\Eudora 7\
Supposing your Eudora attachments are now stored under the following folder:
C:\Program Files\Eudora 7\Attach\
but were previously stored under:
C:\Program Files\Eudora Pro\Attach\
then the first item in the above example under the [SubstPaths] section will instruct Aid4Mail to modify
the following attachment link:
C:\Program Files\Eudora Pro\Attach\Contract.doc
to this:
C:\Program Files\Eudora 7\Attach\Contract.doc
Alternatively, if you have attachment references pointing to many different places but have copied or
moved all the files to one location, then you can use the special Attachments and Embedded values to
identify the folder. Note that the Embedded value normally only applies to Eudora's embedded files.
This feature makes it possible to simplify the example above:
[SubstPaths]
Attachments=C:\Program Files\Eudora 7\attach\
Embedded=C:\Program Files\Eudora 7\Embedded\
Supposing your Eudora sent attachments originally had the following names:
D:\My Documents\Word\Contract.doc
D:\My Documents\My Pictures\Drafts\Logo-1.jpg
D:\My Documents\My Pictures\Final\Logo.tif
but are now all stored in this folder:
F:\My Documents\Eudora\Attachments\
Create the following entry in your Tokens.ini file:
145
Aid4Mail 4 Help
[SubstPaths]
Attachments=F:\My Documents\Eudora\Attachments\
that will
F:\My
F:\My
F:\My
2.11
then instruct Aid4Mail to look for the three attachment files in the following place:
Documents\Eudora\Attachments\Contract.doc
Documents\Eudora\Attachments\Logo-1.jpg
Documents\Eudora\Attachments\Logo.tif
Reference Information
146
The following tokens are usually recognized if you have the corresponding mail client installed. These
tokens return the folder that contains the mail files if it exists:
%Agent%
%Barca%
%Eudora%
%Mozilla%
%Netscape%
%OE%
%Outlook%
%Pegasus%
%PocoMail%
%TheBat%
%Thunderbird%
%WindowsMail%
Depending on your mail client's setup, Aid4Mail may not find the correct folder containing your mail. If
that happens the token returns an empty string. If you know the full path to your mail folder, you can
redefine the token to the value of your choice (or create new tokens). To do so, create an INI file called
Tokens.ini and save it in the same folder as the Aid4Mail program file (Aid4Mail.exe or a4m.exe) or
place it in the Aid4Mail folder under Application Data. Add the section [Tokens] followed by the token
names and their values. Note that any changes you make to the file must be saved before you launch
Aid4Mail, or else they might not be picked up by the software.
Token values can contain Windows predefined variables (see below). Example:
[Tokens]
Eudora=C:\Archives\2007
Thunderbird=%AppData%\Backups\Mail
Backups=D:\Backups\Netscape
The following lists a small selection of predefined system variables typically available under Windows
XP, Vista, 7, 8, and 10 with examples of possible default values assuming "Administrator" is the name of
the logged on user:
%AllUsersProfile%
C:\Documents and Settings\All Users
%AppData%
C:\Documents and Settings\Administrator\Application Data
%CommonProgramFiles%
C:\Program Files\Common Files
%CommonProgramFiles(x86)%
C:\Program Files (x86)\Common Files
%ProgramFiles%
C:\Program Files
Copyright 2005-2016 Fookes Holding Ltd
147
Aid4Mail 4 Help
%ProgramFiles(x86)%
C:\Program Files (x86)
%SystemDrive%
C:
%SystemRoot%
C:\WINDOWS
%Temp%
C:\DOCUME~1\ADMINI~1\LOCALS~1\Temp
%UserName%
Administrator
%UserProfile%
C:\Documents and Settings\Administrator
%WinDir%
C:\WINDOWS
2.12
2.13
Time Zones
A time zone is a region of the World where a common standard time is used, usually referred to as the
local time. Email messages usually include this information in the header date field. Most email
programs convert such dates to your local time for display purposes. Doing so ensures that you can
reliably sort messages from around the World by date no matter what time zone you are in.
Reference Information
148
Unlike an email client program, Aid4Mail usually does not have to adjust dates to a local time zone
when converting mail to an IMAP server or another mail client the target mail program takes care of
that when it displays email information. However, there are certain Aid4Mail tasks which require
adjusting the date time zone. These include setting the file date stamp when Aid4Mail exports
messages into individual files (EML, MHT, MSG) and also when it extracts attachments. Time zone
adjustments to dates are also calculated when you export to PDF and one of the MHT target formats
(Excel worksheets, web pages, or database files), when you search for emails within a date range, and
when using Aid4Mail scripts.
When needed, dates are adjusted to your local time zone by default just like your mail client program.
Prior to version 2, dates were adjusted to UTC time. If necessary, you can use the /TimeZone commandline switch to change the default time zone used by Aid4Mail. The switch is supported by both the
Aid4Mail GUI and the console version. The switch accepts a time zone value in one of several formats:
numerical, time zone abbreviation, time zone in short form, or Windows registry time-zone name (starts
with a $ sign). Examples:
/TimeZone=+0100
/TimeZone=CET
/TimeZone=UTC-8
/TimeZone=UTC+5:30
/TimeZone="$Eastern Standard Time"
When you specify a time-zone name or abbreviation, or when you use the default local time (when this
switch is not specified), Aid4Mail will try to calculate the local date based on standard or daylight time.
Aid4Mail determines the daylight time period based on settings in the DST.dat file or the Windows
registry.
Time zone abbreviations and their corresponding offset values are stored in the TimeZones.dat file,
under the Aid4Mail program folder. If necessary, these lists can be edited by experienced users as long
as the simple data format is preserved (one item per line and a tab character separates the two
columns). In order to avoid losing edits when updating the Aid4Mail software, you should store modified
versions of the file in the Aid4Mail user folder under Application Data; example:
On a Windows 2000/XP system, look for
C:\Documents and Settings\<user>\Application Data\Aid4Mail
On a Windows 10, 8, 7 and Vista systems, look for
C:\Users\<user>\AppData\Roaming\Aid4Mail
The list below shows the main time-zone abbreviations with daylight settings that Aid4Mail recognizes
through the /TimeZone switch (settings stored in the DST.dat file):
ACST
ACWST
AEST
AET
AKST
AST
AWST
CET
CST
EET
149
Aid4Mail 4 Help
EST
GMT
MCK
MET
MSK
MST
NZST
PST
WET
Eastern Time
Western European Time
Moscow Time
Central European Time
Moscow Time
Mountain Time
New Zealand Time
Pacific Time
Western European Time
Any changes you make to these files must be saved before you launch Aid4Mail, or else they might not
be picked up by the software.
2.14
Reference Information
150
{target_folder}
{time_zone}
Aid4Mail Console and Aid4Mail eDiscovery also support the following field, which inserts the MD5 value
of the email message:
{message_md5}
2.15
If you do not want any log file created, simply use the /ErrorLog command-line switch without a file
name. Example:
Aid4Mail.exe /ErrorLog
If you do want a log file, but do not want it opened when email processing is finished, simply define a log
file name without a file extension. Example:
Aid4Mail.exe /ErrorLog="%MyDocs%\Aid4MailErrors"
2.16
Glossary
151
Aid4Mail 4 Help
2.16.2 Attachment
An attachment is a file such as a word processing document, spreadsheet, graphics or sound that has
been sent along with an email message. The contents of the attachment usually do not appear in the
message itself, but instead must be opened separately.
2.16.3 CLI
CLI stands for command-line interface. It is a text-only interface that receives instructions through a
keyboard or is executed from other programs. Unlike a graphical user interface (GUI), it does not
respond to mouse clicks and does not display buttons, menus, and graphics. Aid4Mail Console uses a
command-line interface; all the other Aid4Mail editions use a graphical user interface.
2.16.4 Delimiter
Commas, quotes, spaces, tabs, semi-colons, words, phrases, line breaks, and mixtures of thereof (but
not limited to), that are used to separate data. For example, an address book could have: Name,
Address,City,State,Zip,Phone,Email; one line for each entry. The different items are separated by
commas. The comma is the delimiter, because it separates the items from each other. Email clients
use delimiters to separate each message in the mailboxes. It tells the program where one message
ends and the next one starts. For example, Eudora uses "From ???@???" (without the quotes) at the
beginning of a line to separate, or delimit the email messages from one another. Aid4Mail can make
address books from email using commas or tabs as delimiters (or separators).
2.16.8 Folder
See Message Folder and Mailbox.
2.16.10 GUI
GUI stands for graphical user interface. It is a type of user interface that allows interaction between a
mouse, keyboard, and/or touch-screen and graphical elements like buttons, menus, and other visual
Reference Information
152
objects. Most Windows programs offer a graphical user interface, including Windows Explorer, Notepad,
and Microsoft Outlook. A graphical user interface is usually easier to understand and use than a
command-line interface (CLI) which only offers a text-based interface.
2.16.11 IMAP
IMAP is an acronym for Internet Message Access Protocol. It is an internet standard protocol used to
access and organize messages on a remote mail server. Popular services like Gmail offer IMAP access
to their mail accounts.
2.16.13 Mailbox
The term "mailbox" refers to the files in which your mail program stores your emails. It includes the "
message folders" of Microsoft Outlook, Outlook Express, Pegasus, and other email clients. Mailboxes
and folders generally mean the same thing, but if you tell somebody that is using Outlook to look in their
Sent mailbox they might not understand you since Outlook uses the term folders all the time for their
mailboxes.
2.16.14 MAPI
The Messaging Application Program Interface (MAPI) is an extensive set of functions that developers
can use to create mail-enabled applications. The full function library is known as MAPI 1.0 or Extended
MAPI. Extended MAPI allows complete control over the messaging system on the client computer,
creation and management of messages, management of the client mailbox, service providers, and so
forth.
Simple MAPI is a subset of Extended MAPI, which supports only basic messaging functionality. It
includes functions to send and receive messages, and read mail stored in the Inbox.
2.16.16 mbox
The mbox format is a common storage structure for email messages. An mbox is a single file containing
zero or more email messages. A message stored in mbox format begins with a From_ line, continues
with a series of non-From_ lines, and ends with a blank line. A From_ line means any line that begins
with the characters F, r, o, m, space.
This format should not be confused with the Pine MBX format. Although there's only one character
distinguishing the two format names, they are completely different and incompatible from each other.
Aid4Mail does not read the MBX format.
You will find a more detailed definition on the Wikipedia website.
153
Aid4Mail 4 Help
2.16.18 MD5
MD5 is a message-digest algorithm. The algorithm takes as input a message of arbitrary length and
produces as output a 128-bit "fingerprint" or "message digest" of the input. It is conjectured that it is
computationally infeasible to produce two messages having the same message digest, or to produce
any message having a given pre-specified target message digest.
2.16.20 Message-ID
Message-ID is the name of a field usually present in the header of all email messages that have
transited through a mail server. Its value, which is enclosed in angle brackets (<>), is required to be
globally unique. That is, no two different messages should ever have the same Message-ID value. The
uniqueness of the message identifier is normally guaranteed by the host which generates it. A common
technique used by many message systems is to create a value with a time and date stamp along with
the local host's domain name. Example: <972381.2319756@domain.com>.
2.16.22 MHTML
MHTML stands for "MIME Encapsulation of Aggregate HTML Documents." It is an internet standard that
defines the MIME (Multipurpose Internet Mail Extensions) structure used to send HTML content in email
message bodies. MHTML enables you to send and receive webpages and other HTML documents using
email programs such as Microsoft Exchange, Microsoft Outlook, and Microsoft Outlook Express.
MHTML enables you to embed images directly into the body of your email messages rather than
attaching them to the message.
2.16.23 MIME
Multipurpose Internet Mail Extensions (MIME) defines a format and general framework for the
representation of a wide variety of data types in internet mail.
2.16.24 PDF/A
PDF/A is a file format (ISO standard) for the long-term preservation of self-contained electronic
documents. It is a subset of PDF, obtained by leaving out PDF features not suited to long-term archiving.
Copyright 2005-2016 Fookes Holding Ltd
Reference Information
154
All of the information necessary for reliably displaying the document is embedded in the file. However, a
PDF/A document may not be reliant on external information, for example links to external image files or
fonts that are not embedded.
Note that federal courts in the U.S. are moving towards adopting PDF/A as the standard format for
electronic filing to ensure the long-term preservation of case-related documents. All courts currently
accept PDF/A files if they are uploaded to the CM/ECF system.
Aid4Mail produces files based on the PDF/A-1a (Level A Conformance) format.
2.16.28 Profile
A file containing essential information used by mail clients, which may include the location of a
recipient's Inbox, Outbox, address lists, information stores, and other information services.
2.16.30 Recipient
The person to whom an email message is sent is the recipient.
In the Aid4Mail End User License Agreement (EULA), the term "recipient" means the natural person (not
an entity such as a company, institution, school, or any other organization) to whom an email message
is sent. If an email account is not assigned to a natural person, then the entity's corresponding service
or department constitutes the "recipient"; for example, the Sales Department of an organization would be
the recipient of the address <sales@domain.com> if more than one staff member is responsible for
replying to messages sent to the email account.
155
Aid4Mail 4 Help
2.16.33 SSL
SSL stands for Secure Socket Layer and is a cryptographic protocol that provides security for
communications over networks such as the internet. It is the predecessor of the Transport Layer
Security (TLS). OpenSSL is a widely used open source implementation of the SSL and TLS protocols.
2.16.37 TLS
TLS stands for Transport Layer Security and is a cryptographic protocol that provides security for
communications over networks such as the internet. It is the successor, Secure Socket Layer (SSL).
OpenSSL is a widely used open source implementation of the SSL and TLS protocols.
2.16.38 TNEF
TNEF (Transport Neutral Encapsulation Format) is a proprietary format of email attachment used by
Microsoft Outlook and Microsoft Exchange Server when sending messages formatted as Rich Text
Format (RTF). Most non-Microsoft mail clients cannot decipher TNEF data. Consequently, when you
receive a TNEF-encoded message with a non-Microsoft mail client, the TNEF part usually appears as an
attached file (usually named WINMAIL.DAT).
Reference Information
156
2.16.41 UTC
UTC is a time system called Coordinated Universal Time. Time zones around the World are expressed
as positive or negative offsets from UTC.
3.1
Ordering Information
You can buy Aid4Mail through our website. We have no local dealers. Our software is sold world-wide
by cleverbridge, a leading e-commerce company. Cleverbridge is under contract with Fookes Software to
process orders and collect payments. They accept orders online using a credit card (Visa, MasterCard,
American Express, JCB), PayPal, wire transfer and, under certain conditions, purchase order.
Purchase orders are only available to corporate customers and must use your official company
letterhead. You will receive the cleverbridge fax number in a later step. If you require immediate product
delivery, please use the credit card or PayPal payment option instead.
3.2
Subscription Renewals
When you purchase an activation code for a one-year license, your subscription period starts when you
successfully activate your code for the first time. Maintenance releases and major updates are available
at no extra charge during the validity period of your subscription.
Renew your license before the annual subscription period runs out and benefit from a significant discount
over the regular price. You can also renew after your subscription expires, but the discount will be
smaller. The renewed subscription period will only start once you activate your new code.
Starting with Aid4Mail 4, you can opt-in to receive a renewal reminder by email. The first reminder will be
emailed to you one month before your subscription ends. It will be followed by no more than 3 reminders
(or less if you renew your license in the mean time). Your email address will automatically be opted-out
after you renew your license or after the 4 reminders have been sent.
The email reminder will help you renew your license on time so you can:
157
Aid4Mail 4 Help
3.3
Upgrade Policy
Maintenance releases, updates, and upgrades are free during the validity of your subscription period.
3.4
Refund Policy
All of Fookes Software's products can be evaluated, free of charge, through a trial mode or separate trial
version that can be downloaded directly from our website. Use the trial before you purchase to ensure
that the full product will be compatible with your computer systems and satisfy your requirements. If you
do not, you accept that the product may not meet your needs and that this will not justify a refund or
chargeback. If you experience an issue with our software, then please contact our customer support
service for help in solving the problem.
All sales are final and refunds are provided only for accidental duplicate orders. Refunds will only be
made to the credit card or PayPal account through which the original purchase was made. An
administration fee may apply in such cases to cover processing costs and third-party commissions.
Ordering a software license signifies your acceptance of this Refund Policy.
3.5
Software Piracy
Software piracy may be tempting to those who are not familiar with the risks. But far from being an
innocent, victimless crime, software piracy exposes users to many cyber-security hazards like identity
theft and malware such as viruses, worms, and trojans. It also weakens the value of intellectual property,
which is one of the key drivers of innovation and the way millions of people earn a living.
When you buy authentic software, the benefits of ownership far exceed the software itself. Fookes
Software stands behind its products, and as a partner you can depend on us for customer support,
important updates, and future upgrades. By purchasing our products legally, you gain peace of mind
knowing that your programs are safe, stable, and absolutely free of viruses and other malware. You
cannot put a price on that kind of confidence.
Report Piracy Confidentially
Software piracy, or unlicensed software is the unauthorized copying or distribution of copyrighted
software. This can be done by copying, downloading, sharing, selling, or installing multiple copies onto
personal or work computers. It is illegal, increases security risks and results in economic harm such as
loss of jobs and tax revenue.
Visit the nopiracy.com site to report piracy confidentially. You could be eligible for a $1 million reward.
3.6
158
159
Aid4Mail 4 Help
venture, partnership, trust, limited liability company, corporation, or other legal entity, or government
(including but not limited to any agency, bureau, department division or instrumentality).
Professional means in connection with activities of your Organization (if any), or for any other
commercial or professional purposes, whether for-profit, non-profit or governmental.
Regular Mode means Software operating with a purchased Activation Code or Key File that deactivates
Trial Mode.
Seat means one operating system user logon account (for example a Windows user logon account) on
one computer (not a server) with the ability to run the Software in Regular Mode.
Site means an Organization's work location. This includes Staff Members at the Site who Use the
Software on a laptop for their work at home or while traveling.
Software means the relevant version of Aid4Mail in executable form (GUI and/or CLI format) and
documentation, and including operation in Trial Mode or Regular Mode.
Staff Member means an employee and/or individual contractor working for an Organization.
Subscription Period means a period of time specified on the receipt for the Software during which you
are licensed to run the Software in Regular Mode and, for Software licenses purchased from Fookes
Software or its resellers, to receive free Software updates and customer support as described herein.
Trial Mode means Software operating without a purchased Activation Code or Key File, and for which
you are obtaining a no-charge evaluation license.
Trial Pack age means the edition of Aid4Mail available in the public area of the Fookes Software
website without any Activation Code or Key File.
Use means loading, installing, executing, displaying, performing and/or transmitting the Software for
your internal business purposes, and not for distribution or resale.
2. Software License Grants.
2.1. Trial Mode License.
Subject to the terms and conditions of this Agreement, Fookes Software hereby grants you a nonsublicensable, nonexclusive, nontransferable license to Use the Software in Trial Mode without charge
and for evaluation purposes only in a non-production test environment. You may make as many copies
of the Software as is reasonably necessary for evaluating the Software. All copies must reproduce
copyright notices of the Software. Files created by the Software in Trial Mode are for evaluation purposes
only and must be destroyed once evaluation is complete.
Software in Trial Mode operates with limitations as described on the Aid4Mail website (www.aid4mail.
com). By accepting this Agreement you also accept the limitations described on the Aid4Mail website.
2.2. Regular Mode License.
A Regular Mode license becomes effective when Trial Mode is deactivated through the purchase and/or
use of either a valid Activation Code or Key File. Regular Mode licenses are available for purchase for
Personal Use and/or Professional Use.
160
161
Aid4Mail 4 Help
An Activation Code may be transferred only if the license Subscription Period is a minimum of one year.
An Activation Code may be re-activated on a different computer or under a different operating system
user logon account as long as the Mail Account processed in the new location is the same as in the
original location. Once an Activation Code has been used to process one Mail Account, it may not be
used to process another Mail Account except as stated in the next paragraph.
An Activation Code may be transferred only within your Organization from one Staff Member to another if
the initial Staff Member is no longer employed by your Organization or is permanently reassigned to
another post. Such a transfer may occur no sooner than one month after the start of a Subscription
Period and no more than four times within a yearly Subscription Period.
2.4.3. Aid4Mail Professional Site.
Fookes Software hereby grants you the right and license, during the applicable Subscription Period, to
Use one multi-user Activation Code for as many Seats as specified on the receipt for the Software
license. All Seats linked to the Activation Code must be located at a single Site. You may process as
many Mail Accounts as you have Seats. Such license is for Professional Use to perform tasks that
include Mail Migration and archiving, but not e-discovery or forensic examination.
The user who activates the first Seat will receive an email with all the instructions required to open a
license control panel (LCP) account. The LCP is provided for managing the Activation Code and
associated Seats.
The Activation Code cannot be transferred to another Site. A Seat may be transferred from one Staff
Member to another at the same Site if the initial Staff Member is no longer employed at the Site or is
permanently reassigned to another post. The transfer process requires that the old Seat be de-activated
prior to transfer. A delay of between 24 and 72 hours is imposed before activation of another Seat is
possible.
2.4.4. Aid4Mail eDiscovery Forensic.
Fookes Software hereby grants you the right and license, during the applicable Subscription Period, to
Use the Software with one Activation Code or Key File. Such license is for Professional Use to perform
tasks that include e-discovery, forensic examination, and archiving, but not Mail Migration.
Such license held by a government Organization may be exercised to process any number of Mail
Accounts belonging to your Organization or to third parties, as long as the Software can be operated
from one Seat. However, you may not process Mail as part of a for-profit service to clients or other third
parties unless you have a separate valid license for each of their Mail Accounts. (Aid4Mail eDiscovery
Service may be more appropriate in this case.)
Such license held by an Organization (other than a government Organization) may be exercised for
internal purposes only to process any number of Mail Accounts belonging to the Organization as long as
the Software can be operated from one Seat.
You may not make the Software available to other users in your Organization or third parties, whether
directly by offering access to the operating system user logon account from which it can be executed, or
indirectly through a network system.
An Activation Code may be transferred within your Organization from one Staff Member to another if the
initial Staff Member is no longer employed by your Organization or is permanently reassigned to another
Copyright 2005-2016 Fookes Holding Ltd
162
post. Such a transfer may occur no sooner than one month after the start of a Subscription Period and
no more than four times within a yearly Subscription Period.
2.4.5. Aid4Mail eDiscovery Archivist.
Fookes Software hereby grants you the right and license, during the applicable Subscription Period, to
Use the Software with one Activation Code or Key File. Such license is for Professional Use limited to
performing archiving tasks for purposes of preservation and access in research collections, including
limited e-discovery, forensic examination and Mail Migration incidental to archiving.
Such license held by a government or non-profit Organization may be exercised to process any number
of Mail Accounts belonging to your Organization or to third parties, as long as the Software can be
operated from one Seat. However, you may not process Mail as part of a for-profit service to clients or
other third parties unless you have a separate valid license for each of their Mail Accounts. (Aid4Mail
eDiscovery Service may be more appropriate in this case.)
Such license held by an Organization (other than a government or non-profit Organization) may be
exercised for internal purposes only to process any number of Mail Accounts belonging to the
Organization as long as the Software can be operated from one Seat.
You may not make the Software available to other users in your Organization or third parties, whether
directly by offering access to the operating system user logon account from which it can be executed, or
indirectly through a network system.
An Activation Code may be transferred within your Organization from one Staff Member to another if the
initial Staff Member is no longer employed by your Organization or is permanently reassigned to another
post. Such a transfer may occur no sooner than one month after the start of a Subscription Period and
no more than four times within a yearly Subscription Period.
2.4.6. Aid4Mail eDiscovery Service.
Fookes Software hereby grants you the right and license, during the applicable Subscription Period, to
Use the Software with one Activation Code or Key File. Such license is for Professional Use limited to
providing paid or unpaid bona fide e-discovery, forensic examination and archiving services, but not for
Mail Migration services. Such license may be exercised to process any number of Mail Accounts
belonging to your Organization (government, non-profit or otherwise) or to third parties, as long as the
Software can be operated from one Seat.
You may not make the Software available to other users in your Organization or to third parties, whether
directly by offering access to the operating system user logon account from which it can be executed, or
indirectly through a network system.
An Activation Code may be transferred within your Organization from one Staff Member to another if the
initial Staff Member is no longer employed by your Organization or is permanently reassigned to another
post. Such a transfer may occur no sooner than one month after the start of a Subscription Period and
no more than four times within a yearly Subscription Period.
2.4.7. Aid4Mail eDiscovery Personal.
Fookes Software hereby grants you the right and license, during the applicable Subscription Period, to
Use the Software to process no more than one Mail Account per Activation Code or Key File. Such
license is for Professional Use to perform tasks that include e-discovery, forensic examination, archiving,
and Mail Migration purposes.
Copyright 2005-2016 Fookes Holding Ltd
163
Aid4Mail 4 Help
An Activation Code may be re-activated on a different computer or under a different operating system
user logon account as long as the Mail Account processed in the new location is the same as in the
original location. Once an Activation Code has been used to process one Mail Account, it may not be
used to process another Mail Account except as stated in the next paragraph.
An Activation Code may be transferred within your Organization from one Staff Member to another if the
initial Staff Member is no longer employed by your Organization or is permanently reassigned to another
post. Such a transfer may occur no sooner than one month after the start of a Subscription Period and
no more than four times within a yearly Subscription Period.
2.4.8. Aid4Mail Migrator.
Fookes Software hereby grants you the right and license, during the applicable Subscription Period, to
Use Aid4Mail (GUI + CLI) with a Key File for as many Seats as specified on the receipt for the Software
license. All Seats must be located at a single Site. You may process as many Mail Accounts as you
have Seats. Such license is for Professional Use to perform tasks that include Mail Migration,
conversion and archiving, but not e-discovery or forensic examination.
The Key File for this license may not be transferred to another Site.
2.4.9. Aid4Mail Console Archivist / Forensic / Service.
If you purchase a license to Aid4Mail eDiscovery Archivist (GUI format), you also are eligible to purchase
a corresponding license on the same terms to Aid4Mail Console Archivist (CLI format).
If you purchase a license to Aid4Mail eDiscovery Forensic (GUI format), you also are eligible to purchase
a corresponding license on the same terms to Aid4Mail Console Forensic (CLI format).
Aid4Mail eDiscovery Service (GUI format) is bundled and sold together on the same terms with Aid4Mail
Console Service (CLI format). There is no option to purchase Aid4Mail Console Service separately.
2.4.10. Aid4Mail Console Server.
Fookes Software hereby grants you the right and license, during the applicable Subscription Period, to
Use Aid4Mail Console on a server with a Key File. Pricing, Subscription Period, number of Seats
accessing the Software or number of Mail Accounts processed by it, type of usage (e.g., mail
conversion, filtering, data extraction, archiving, e-discovery, third-party processing), and other special
terms are agreed in writing by email or other means between you and Fookes Software prior to
purchase.
2.5 License Restrictions.
The Software is licensed, not sold. This Agreement only gives you the rights according to the chosen
license type (section 2); Fookes Software reserves all other rights. Especially you may not:
(a) modify, adapt, translate, rent, lease or sublicense (including offering the Software to third parties on
an application service provider, web service or time sharing basis) the Software except to the extent
explicitly permitted in the chosen license type (section 2) above; (b) disable, block or circumvent any
licensing, rights management or control features of the Software except as an intended part of the
Softwares programming features; (c) assign, loan, resell, transfer, distribute or otherwise make
accessible the Software, except as set forth in section 6; (d) modify, decompile, disassemble or reverse
engineer the Software, except to the limited extent permitted by applicable law; (e) remove or modify any
legal notices in the Software; or (f) make more copies of the Software, other than (i) for the use granted
Copyright 2005-2016 Fookes Holding Ltd
164
by the chosen license type (section 2), (ii) for back-up purposes, and/or (iii) except as set forth in
sections 2.1 and 6.
It is your responsibility to make a back-up copy of the Software installation file and your registration
details, including Activation Codes, Key Files and passwords if any, off your computer and place these
in a safe location that is not accessible to other users. If you manage Activation Codes for other users, it
is your responsibility to keep track of which Activation Codes and passwords are assigned to which
users.
3. Customer Support / Software Maintenance / Feedback.
Fookes Software provides customer support and software maintenance that is generally at no extra
charge during the Subscription Period and exclusively by email in English, to the extent that Fookes
Software at its sole discretion shall determine to be reasonable (Customer Support). If you are an
Organization, Customer Support is provided only to your support Staff Members, not all Staff Members.
Fookes Software has no obligation to provide Customer Support for any Trial Package, discontinued
products and old Software versions that were released more than six months prior to the release of the
latest update or upgrade. For OEM versions, contact your OEM or distributor for customer support, as
Fookes Software does not provide Customer Support for those versions.
You may choose to email, upload or otherwise submit orally or in writing to Fookes Software your Mail
files, log files, screen images, screen videos, email login information, email account information,
descriptions of your use of the Software, and/or your communications with Fookes Software concerning
Customer Support with respect to the foregoing materials and information (Support Materials). By
submitting Support Materials to Fookes Software, you hereby grant (or warrant that the owner of such
rights has granted) to Fookes Software the right internally to use, reproduce and modify the Support
Materials for the purposes of providing Customer Support to you and testing and improvement of Fookes
Software products and services. Fookes Software agrees to keep confidential your Support Materials,
except as may be required by applicable law.
You may choose to email, upload or otherwise submit orally or in writing to Fookes Software bug
reports, feature requests, general comments and suggestions, and/or other feedback regarding Fookes
Software products (Feedback). By submitting Feedback to Fookes Software, you hereby grant (or
warrant that the owner of such rights has granted) to Fookes Software a non-exclusive, worldwide,
perpetual, irrevocable, royalty-free, sublicensable right to make, use, sell, reproduce, modify, publish,
distribute, display, and perform, any such Feedback or products or services that include such Feedback,
without compensation to you, unless otherwise expressly agreed in writing by Fookes Software.
You bear all responsibility for ensuring that email replies from Fookes Software can reach you. Fookes
Software cannot be held responsible if its emails to you are blocked by your Internet service provider
(ISP), or your email server, or your email programs spam/junk-mail filters. If necessary, you will provide
an alternative email address that can receive emails from Fookes Software.
4. Refund Policy.
The Software in Trial Mode is available for download free of charge from the Fookes Software web site. It
is intended to allow potential customers to evaluate before purchase, whether the Software is compatible
with their computer systems, email programs and data, and will satisfy their requirements. AS A
RESULT, ALL SALES ARE FINAL AND REFUNDS ARE PROVIDED ONLY FOR ACCIDENTAL
DUPLICATE ORDERS. Refunds will be made only to the credit card or PayPal account through which
the original purchase was made. An administration fee may apply in such cases to cover processing
costs and third-party commissions.
165
Aid4Mail 4 Help
5. Ownership.
The Software is proprietary to Fookes Software and its suppliers, and is licensed, not sold, to you
notwithstanding any reference herein to purchases. You acknowledge and agree that: (a) the Software
is protected under U.S. copyright and other national and international copyright laws; (b) Fookes
Software and its suppliers retain all copyrights and other intellectual property rights in the Software; (c)
there are no implied licenses under this Agreement, and any rights not expressly granted to you
hereunder are reserved by Fookes Software; (d) you acquire no ownership or other interest (other than
your license rights) in or to the Software; and (e) Fookes Software and/or its suppliers owns all copies of
the Software, however made. You agree that you will not, at any time, contest anywhere in the world the
ownership of Fookes Software and/or its suppliers of, or rights in, the Software. You have no rights
hereunder to use any trademark or service mark belonging to Fookes Software.
6. Distribution of the Trial Package.
Provided that you are distributing the then-current Release Version of the Trial Package you are hereby
licensed to make as many copies of the Trial Package as you wish; give exact copies of the original
Trial Package to anyone; and distribute the Trial Package in its unmodified form via electronic means
(Internet, software distribution libraries, CD-ROMs, DVDs, etc.). You may charge a small distribution fee
for the Trial Package, but you must not represent in any way that you are selling or licensing the
Software itself. All copies must reproduce copyright notices of the Software.
You may not make the Trial Package available on any site, CD-ROM, DVD, or with any package, or with
any other medium or service, which makes available or contains viruses, virus source code, virus
construction programs, virus creation material, spyware, malware or other malicious code or material.
You will not make any advertising or representation relating to Fookes Software or Software that is
misleading or deceptive or that is inconsistent with Fookes Software marketing materials or web sites.
Permission to distribute the Trial Package is not transferable, assignable, saleable, or franchisable, and
any attempt to do so is void. Each entity wishing to distribute the Trial Package must independently
satisfy the terms of the foregoing distribution license.
7. Updates and Upgrades.
To Use an update or an upgrade of the Software or to upgrade your license type to a license type with
more features (Update), you must possess a valid license to the updateable or upgradeable version of
the Software or license type you want to Update. You agree that once you start using an Update, you
lose your right to Use the Software or license type (if replaced by a new one or other system) that was
the basis of the Update (Previous Version). You also agree that you will not transfer a Previous Version
to another person or entity, and that you may Use the Update only in accordance with the terms of this
Agreement.
8. Compliance.
You shall conduct your business in compliance with all laws and regulations in any way applicable to
the Software or to the performance of your obligations under this Agreement. Without limiting the
foregoing, you shall not take any action that would violate, or cause Fookes Software to be in violation
of, any applicable law of the United States or any other jurisdiction including but not limited to the U.S.
Foreign Corrupt Practices Act and all import and export laws, regulations and restrictions of the United
States or any foreign agency or authority.
9. U.S. Government Rights.
166
167
Aid4Mail 4 Help
12. Termination.
Fookes Software may terminate this Agreement at any time upon default by you of the license
provisions of this Agreement, or any other material default by you of this Agreement not cured within
thirty (30) days after written notice thereof. Except for Sections 2, 3 and 6, all provisions of this
Agreement shall survive termination of this Agreement.
13. Severability Clause.
If any provision of this Agreement is or becomes ineffective or if there is an omission from this
Agreement, this does not affect the legal validity of the remaining provisions. The ineffective provision will
be replaced by an effective provision that is as close as possible in economic terms to the provision
wanted by the parties. The same procedure applies in the case of an omission.
14. General.
You shall not assign, delegate or sublicense any of your rights or obligations under this Agreement, by
operation of law or otherwise, without prior written consent of Fookes Software, and any attempt without
such consent shall be void. Subject to the preceding sentence, this Agreement binds and benefits the
permitted successors and assigns of the parties. Fookes Software may change the terms, conditions
and pricing relating to the future licensing of its Software and other intellectual property rights, including
this Agreement, from time to time. No waiver will be implied from conduct or failure to enforce rights nor
is it effective unless in a writing signed on behalf of the party against whom the waiver is asserted.
There are no third-party beneficiaries to this Agreement. Fookes Software is not bound by additional and/
or conflicting provisions in any purchase order or other correspondence unless expressly agreed in
writing. This Agreement is the complete and exclusive statement of agreement between the parties as to
its subject matter and supersedes all proposals or prior agreements, verbal or written, advertising,
representations or communications concerning the Software.
Last update to Aid4Mail End User License Agreement: September 15, 2016
168
Version may contain errors and should be destroyed once testing is complete.
3. Beta Version License. This Beta Agreement applies whether you Use a Beta Version in Trial Mode
or Regular Mode. Subject to the terms and conditions of this Agreement, Fookes Software hereby grants
you a revocable, non-sublicensable, nonexclusive, nontransferable license without charge during the
Beta Test Period to Use the Beta Version as follows: (i) if you are licensed to use a current version of
the Software in Regular Mode, then you may Use the Beta Version in Regular Mode on the same terms
as your current version, except that you may use the Beta Version for evaluation purposes only in a nonproduction test environment; and (ii) otherwise, you may use the Beta Version only in Trial Mode and for
evaluation purposes only in a non-production test environment. You may make as many copies of the
Beta Version as is reasonably necessary for evaluating the Beta Version. All copies must reproduce
copyright notices of the Beta Version. Files created by the Beta Version are for evaluation purposes only
and must be destroyed once evaluation is complete. The Beta Test Period commences on the date
Fookes Software delivers the Beta Version to you and ends on the commercial release date of the
corresponding Release Version, or if earlier, the date specified in writing by Fookes Software. The Beta
Version may have limited functionality or may contain a time out feature that will cause it to be disabled
and non-functional upon conditions designated by Fookes Software in its sole discretion. YOU
UNDERSTAND AND AGREE THAT OPERATION OF THE BETA VERSION AND ACCESS TO YOUR
DATA MAY TERMINATE UPON ANY SUCH CONDITION, UNLESS YOU OBTAIN AN UPDATED BETA
VERSION OR PURCHASE A REGULAR VERSION OF THE SOFTWARE.
5. No License Fee. No license fees or royalties are payable under this Beta Agreement.
6. No Support. Unless stated otherwise in writing by Fookes Software, no Customer Support is provided
for any Beta Version.
7. Confidentiality.
(a) Confidential Information means any and all information concerning Fookes Softwares unreleased
products and services, trade secrets and other proprietary rights; descriptions of inventions, processes
and technical know-how; specifications; documentation, and any other business, marketing or technical
information disclosed in relation to this Beta Agreement.
(b) The parties expressly agree that the source and object code of each Beta Version is Confidential
Information of Fookes Software. In addition, if you received a copy of a Beta Version that is not available
in the public area of the Fookes Software website or its related forums, then all new features and
capabilities of that Beta Version are deemed Confidential Information of Fookes Software and must
remain strictly confidential until they are made available to the general public.
(c) Confidential Information shall not include information (i) already in your possession without an
obligation of confidentiality; (ii) publicly available without breach of this Agreement or any other beta
agreement or confidentiality agreement of Fookes Software; or (iii) required by law to be disclosed,
provided that the you give Fookes Software reasonable notice so that it may prevent or limit such
required disclosure.
(d) You shall hold all Confidential Information in strict confidence, and may disclose such Confidential
Information only to your employees and contractors who have a need to know such information. You
shall not use or permit the use of any Confidential Information for benefit of yourself or any third party
except as necessary to perform under this Beta Agreement. You are responsible for any violation of this
section by your directors, officers, employees, independent contractors and advisors.
(e) You acknowledge that any breach of this Section will result in irreparable harm to Fookes Software
for which damages would be an inadequate remedy and in the event of such breach and in addition to its
Copyright 2005-2016 Fookes Holding Ltd
169
Aid4Mail 4 Help
rights and remedies otherwise available at law, Fookes Software shall be entitled to equitable relief,
including injunctive relief, without the posting of a bond.
8. Feedback. By emailing, uploading, posting, or otherwise transmitting or submitting any content,
information or ideas to Fookes Software, you automatically grant (or warrant that the owner of such
rights has expressly granted) to Fookes Software a perpetual, irrevocable, royalty-free, worldwide, nonexclusive, sublicensable right and license to use, reproduce, modify, publish, distribute, display,
perform, and transmit such content, information and ideas, in public or non-public form, without
compensation to you, unless otherwise expressly agreed in writing by Fookes Software. However,
Fookes Software holds the contents of any Mail files and screen shots sent to us for software testing
and improvement strictly confidential, except as may be required by applicable law.
9. WARRANTY DISCLAIMER AND LIMITATION OF LIABILITY.
THE BETA VERSION IS PROVIDED ON AN AS IS BASIS. FOOKES SOFTWARE DISCLAIMS AS
FAR AS LEGALLY PERMISSIBLE ALL WARRANTIES RELATING TO THE BETA VERSION,
WHETHER EXPRESSED, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
IMPLIED WARRANTIES OF SATISFACTORY QUALITY, MERCHANTABILITY, FITNESS FOR A
PARTICULAR PURPOSE, OR NON-INFRINGEMENT . FOOKES SOFTWARE DOES NOT WARRANT
THAT THE BETA VERSION WILL MEET YOUR REQUIREMENTS OR BE UNINTERRUPTED,
SECURE, ERROR-FREE OR COMPATIBLE WITH ANY PRODUCT. NEITHER FOOKES SOFTWARE
NOR ANYONE ELSE WHO HAS BEEN INVOLVED IN THE CREATION, PRODUCTION, OR DELIVERY
OF THE BETA VERSION (SUPPLIERS) SHALL BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL,
CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES (INCLUDING BUT NOT LIMITED TO LOST
REVENUES, PROFITS AND/OR SAVINGS) ARISING OUT OF THE USE OR INABILITY TO USE THE
BETA VERSION, EVEN IF FOOKES SOFTWARE HAS BEEN ADVISED OF THE POSSIBILITY OF
SUCH DAMAGES OR CLAIMS. THE PERSON USING THE BETA VERSION BEARS ALL RISK AS TO
THE QUALITY AND PERFORMANCE OF THE BETA VERSION.
THE ENTIRE LIABILITY OF FOOKES SOFTWARE AND ITS SUPPLIERS, AND YOUR EXCLUSIVE
REMEDY, WITH RESPECT TO THE USE OF THE BETA VERSION OR ANY BREACH OF THIS BETA
AGREEMENT ARE LIMITED TO THE AMOUNT ACTUALLY PAID BY YOU, IF ANY, FOR USE OF THE
BETA VERSION. YOU HEREBY RELEASE FOOKES SOFTWARE AND SUCH OTHER PERSONS
FROM ANY AND ALL OBLIGATIONS, LIABILITIES AND CLAIMS IN EXCESS OF THIS LIMITATION.
YOU AGREE THAT ANY CLAIM OR CAUSE OF ACTION ARISING OUT OF OR RELATED TO USE OF
THE BETA VERSION OR THIS AGREEMENT MUST BE FILED WITHIN ONE (1) YEAR AFTER SUCH
CLAIM OR CAUSE OF ACTION AROSE OR BE FOREVER BARRED.
YOU ARE SOLELY RESPONSIBLE FOR SELECTION, INSTALLATION AND LAUNCH OF THE BETA
VERSION AND FOR BACKING UP YOUR DATA AND FILES, AND HEREBY RELEASE FOOKES
SOFTWARE AND ITS SUPPLIERS FROM ANY LIABILITY OR DAMAGES DUE TO THE LOSS OF
ANY SUCH DATA OR FILES.
FOOKES SOFTWARE IS NOT LIABLE FOR ANY INAPPROPRIATE OR ILLEGAL USE OF THE BETA
VERSION.
10. Governing Law / Jurisdiction. This Agreement is governed by Swiss Law, subject to the express
exclusion of the United Nations Convention on Contracts for the International Sale of Goods (CISG,
1980). The parties consent to the exclusive jurisdiction of the competent Swiss courts of Gruyre,
Switzerland, for the resolution of any litigation arising out or related to this Agreement.
3.7
170
171
Aid4Mail 4 Help
Adobe has a number of patents covering technology that is disclosed in the Portable Document Format
(PDF) Specification, version 1.3 and later, as documented in PDF Reference and associated Technical
Notes (the "Specification"). Adobe desires to promote the use of PDF for information interchange among
diverse products and applications. Accordingly, the following patents are licensed on a royalty-free,
nonexclusive basis for the term of each patent and for the sole purpose of developing software that
produces, consumes, and interprets PDF files that are compliant with the Specification:
U.S. Patent Numbers:
5,634,064
5,737,599
5,781,785
5,819,301
6,028,583
6,289,364
6,421,460
In addition, the following patent is licensed on a royalty-free, nonexclusive basis for its term and for the
sole purpose of developing software that produces PDF files that are compliant with the Specification
(specifically excluding, however, software that consumes and/or interprets PDF files):
U.S. Patent Number:
5,860,074
The above licenses are limited to only those rights required to implement the Specification and no
others. That is to say, Adobe grants only those rights in the above patent(s) necessarily practiced to
implement the Specification, and does not grant any rights not required to implement the Specification.
The licenses do not grant the right to practice any patent covering other technologies, such as
implementation techniques that are not explicitly disclosed in the Specification, nor does it allow the use
of any patented feature for any purpose other than as set forth in the applicable license grant. Adobe has
other patents in various fields, none of which are hereby licensed.
172
173
Aid4Mail 4 Help
3. All advertising materials mentioning features or use of this software must display the following
acknowledgment: "This product includes software developed by the OpenSSL Project for use in the
OpenSSL Toolkit. (http://www.openssl.org/)"
4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to endorse or promote
products derived from this software without prior written permission. For written permission, please
contact openssl-core@openssl.org.
5. Products derived from this software may not be called "OpenSSL" nor may "OpenSSL" appear in their
names without prior written permission of the OpenSSL Project.
6. Redistributions of any form whatsoever must retain the following acknowledgment: "This product
includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.
openssl.org/)"
THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY EXPRESSED OR
IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
EVENT SHALL THE OpenSSL PROJECT OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
This product includes cryptographic software written by Eric Young (eay@cryptsoft.com). This product
includes software written by Tim Hudson (tjh@cryptsoft.com).
174
the following disclaimer in the documentation and/or other materials provided with the distribution.
3. All advertising materials mentioning features or use of this software must display the following
acknowledgement: "This product includes cryptographic software written by Eric Young
(eay@cryptsoft.com)" The word 'cryptographic' can be left out if the routines from the library being
used are not cryptographic related.
4. If you include any Windows specific code (or a derivative thereof) from the apps directory (application
code) you must include an acknowledgement: "This product includes software written by Tim Hudson
(tjh@cryptsoft.com)"
THIS SOFTWARE IS PROVIDED BY ERIC YOUNG "AS IS" AND ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
OF THE POSSIBILITY OF SUCH DAMAGE.
The licence and distribution terms for any publicly available version or derivative of this code cannot be
changed. i.e. this code cannot simply be copied and put under another distribution licence [including the
GNU Public Licence.]
175
Aid4Mail 4 Help
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
176
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY
DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
177
Aid4Mail 4 Help
Other Information
4.1
Policies
1.
2.
3.
4.
We are perfectionists and strive to develop useful, original, and reliable software solutions.
We listen to our users and try to implement feature suggestions that benefit others.
We are committed to providing excellent customer support by email.
We are upfront about our services and products (no "small print") so that you can make an informed
buying decision.
Our Websites
http://www.fookes.com
http://www.aid4mail.com
http://www.toutmail.com
Business Details
Fookes Software Ltd is registered in Switzerland and owned by its parent company Fookes Holding Ltd.
The Fookes Software registration numbers are as follows:
Reference Number: 2420/2008
Federal Number: CH-217-3540396-6
Trade Register details:
Service du registre du commerce du Canton de Fribourg, Switzerland
http://www.fr.ch/rc/
Fook es is a registered trademark of Fookes Holding Ltd.
4.2
Other Information
178
Our free technical support service covers pre-sales questions, installation issues, license activation, and
troubleshooting Aid4Mail issues that are not covered by our documentation. Note that troubleshooting
software issues requires that you have the latest maintenance updates installed.
However, our free technical support service does not cover "hand-holding", in-depth training such as
developing templates and scripts, custom development, or assistance with third-party products. We have
invested much time in writing this Help file and feel confident that you will gain a good understanding of
Aid4Mail by studying it. If you are not familiar with the terms used in this documentation or need "handholding", please find an experienced user to help you.
We reserve the right to terminate support to users who in our judgment are unreasonable or abusive, or
who have problems which transcend the scope of our software.
We reply to email on business days from Monday to Friday. We usually reply within 24 hours, but on
occasions it may take up to 2 business days. Please take into account that your "urgent" message may
reach us in the middle of the night we are based in Switzerland (UTC+1). Note that technical support is
provided by email only.
Please visit our website for access to our extensive knowledge base and Help Desk contact form.
If you need to contact us by postal mail, our office address is as follows:
Fookes Software Ltd
La Petite Fin 27
1637 Charmey
Switzerland
Please do NOT send Purchase Orders to the above address. Aid4Mail sales are handled for us by
cleverbridge. Address and fax details are provided by cleverbridge after you select "Purchase Order" as a
payment option on the order form, which is available by first going through our website.
4.3
4.4
179
Aid4Mail 4 Help
4.5
Trademarks
Fookes is a registered trademark of Fookes Holding Ltd.
Aid4Mail is a trademark owned by Fookes Holding Ltd and licensed to Fookes Software Ltd.
Windows is a trademark of Microsoft Corporation registered in the U.S. and other countries.
All other trademarks and service marks are the property of their respective owners.
Other Information
4.6
180
Acknowledgements
Many thanks to the following people who provided much helpful feedback while Aid4Mail was undergoing
development and beta testing:
Jody Adair
Alec Burgess
Greg Chapman
Dennis Cummins
Alan Cummings
Jim Hall
Larry Hamilton
Jrme Monteil
Hugo Paulissen
Harvey Savage
Sheri Pierce
Aid4Mail is developed in Delphi, a Embarcadero product. Portions of the Aid4Mail GUI are created
with Raize Components. ZIP-file support is based on ZipForge from ComponentAce. This Help file
was authored in Help & Manual, an EC Software product. The Setup program is made with the Inno
Setup package developed by Jordan Russell. The license activation system is managed by
softWORKZ Innovation Inc.
See also the Third Party Software Notices and/or Additional Terms and Conditions topic.
181
Aid4Mail 4 Help
Index
-//a
102
/addresses
104
/AddWinmailDat
98
/attachments
104
/b
102
/BadImapMailFolder
107
/contents
104
/DataFolder
110
/dbs
104
/dc
107
/DelSource
98
/DisplayName
102
/dr
107
/ds
107
/eml
104
/emlExt
98
/ErrorLog
110
/exclude
107
/extract
106
/ExtractAll
106
/f 98
/fast
98
/FilterScope
107
/FilterScript
107
/IgnoreInvalidFormats
98
/ImapLog
110
/include
107
/IncludeAllItems
98
/IncludeTrash
98
/IncludeUnpurged
98
/Lf 106
/Log
110
/m
98
/MailDelimTest
98
/MapiConvOff 98
/MapiFixOff 98
/mbox
104
/md5Name
102
/mht
104
/moz
104
/msg
104
/NoFilterLog
110
/NoLimit
110
/OutputScript
104
/pdf 104
/plain
106
/PreserveSMTP
106
/pst
104
/QuitIfTrial
110
/rich
106
/s
98
/S_Log
98
/S_Namespace
98
/S_Profile
98
/S_PW
98
/S_UserId
98
/SaveBadImapMail
107
/SessionName
110
/ShrinkBadImapMail
107
/SkipAllDups
107
/SkipDups
107
/stop
110
/t
102
/T_Log
102
/T_Namespace
102
/T_Profile
102
/T_PstSize
102
/T_PW
102
/T_UserId
102
/temp
110
/TimeZone
102
/TocDate
98
/unattended
110
/UnicodePst
104
/UseDateField
102
/UseMapiTnefConverter
98
/utf8
106
/xls
104
/zip
104
-{{filename} token
68
-Aa4m.exe
96
About Fookes Software
177
Accessibility Mode
55
Copyright 2005-2016 Fookes Holding Ltd
Index
Accounts-Template.csv 125
Acknowledgements
180
Activation password
18
Add Metadata to Headers - Advanced Options
Additional Terms and Conditions
170
Address export options
72
Advanced Options
78
Aid4Mail archives
31
Aid4Mail buttons
54
Aid4Mail Console
96
Aid4Mail Console (comparison chart)
16
Aid4Mail Console Launcher
138
Aid4Mail eDiscovery
11
Aid4Mail eDiscovery (comparison chart)
16
Aid4Mail Editions
11
Aid4Mail Home
11
Aid4Mail Home (comparison chart)
16
Aid4Mail Migrator
11
Aid4Mail Professional
11
Aid4Mail Professional (comparison chart)
16
Aid4Mail Script Syntax
86
Aid4Mail Trial
17
AIM.Mail settings
139
ANSI PST 150
Anti-Virus Warnings
6
AOL Mail
23
AOL Mail settings
139
Apple computer
52
Apple Mail
52
Archive mail
67
Archiving Email
31
Attach.tab file
66
Attachment
151
attachments not found
143
-BBarca
23
-CCalculate command
93
Calypso
23
Check for Duplicates Across Folders - Advanced
Options
78
Check for news updates
20
CLI 151
Copyright 2005-2016 Fookes Holding Ltd
78
Command-Line Parameters
96
Comparison chart
16
console
96
Console command-line examples
132
Contacting Fookes Software
177
Converting Multiple Accounts With a CSV File
Copyright and Disclaimer
180
Courier
23
Create Unicode PST 68
CSV file for mail account settings
125
Custom formats using scripts
68
182
125
-DDates in Outlook
47
Daylight time
147
Delimiter
151
DNA.dll
18
DST.dat
147
Duplicate messages
72
-Ee-discovery
11
E-discovery or forensic-examination professional (but
not a service provider)
14
EIN
177
electronic filing
153
Email archivist (but not a service provider)
15
Email Contents Switches
106
Email Notifications (Aid4Mail Console Launcher)
138
Email Notifications (Aid4Mail Console)
128
Email Notifications (Aid4Mail)
76
Embedded contents
151
EML files
151
Employer Identification Number (IRS)
177
Entourage
52
Error adding new message to store
47
Error creating MAPI subfolder
47
Error creating PST file
47
Error log file
150
Error processing email
47
Eudora
23
Eudora for Macintosh
52
Eudora OSE
23
Evaluation period
17
Exchange mailbox
151
183
Aid4Mail 4 Help
-FFAQ
37
Fast Mail Processing - Advanced Options
78
FastMail settings
139
Filter Mail by Content
59
Filter Mail by Date
59
Filter Options
59
Filter Scripts
59
Filter Switches
107
Finding Mail Folders
32
Finding the Application Data folder
32
Firewall settings for product activation
18
Fix MAPI Header Errors - Advanced Options
78
Fixing attachment folder references
143
flash memory key
155
Folder
151
Folder tokens
145
forensic
11
Forte Agent
23
FoxMail
23
Frequently Asked Questions
37
80
11
-IIMAP
152
IMAP mail
23
IMAP mail - General Aid4Mail FAQ
41
IMAP Options
77
IMAP Settings
139
Import into a database
66
Incremental Processing - Advanced Options
78
Individual or organization migrating professional mail
12
Information store
152
INI File Settings
111
INI Filter Settings
122
INI Other Settings
123
INI Source Settings
112
INI Target Settings
115
Installation
6
Introduction
1
-KKey Features
-LLicense activation
18
Copyright 2005-2016 Fookes Holding Ltd
Index
License agreement
158
License Re-Activation
18
Live@edu settings
139
Local Folder For Failed Uploads - IMAP Options
77
Local time
147
Log file
150
Log for Incremental Processing - Advanced Options
78
Log IMAP Communications - IMAP Options
77
Lost attachments
143
Lotus Domino settings
139
-MMac computer
52
Mac Eudora
52
Mac OS X Mail
52
Mail Source screen
56
Mail.app
52
Mailbox
152
maildir folders
23
MAPI 152
MAPI folder
152
MAPI store
153
MAPI Store screen
58
MD5
153
memory stick
155
Message folder
153
Message-ID
153
MHT attachments
66
MHT files
66, 153
MHTML
153
Microsoft Entourage
52
Microsoft Outlook
23
Microsoft Outlook FAQ
47
Migrating accounts using a CSV file
125
MIME
153
MIME Types and File Extensions
147
Mime-Ext.dat
147
Module mspst32.dll error - FAQ
47
Mozilla
23
MS Outlook
23
-NNames in Outlook
47
Namespace (IMAP)
139
Copyright 2005-2016 Fookes Holding Ltd
184
Netscape Messenger
23
News and Updates screen
76
Not Responding error
41
NoteTab
178
Notification Options (Aid4Mail)
76
63
17
185
Aid4Mail 4 Help
-QQualcomm Eudora
23
-RRe-activation password
18
Read archived mail
31
Receive Email Notifications (Aid4Mail Console)
128
Recipient
154
Refund Policy
157
Remove Oversized Attachments - IMAP Options
77
Retry Download On Error - IMAP Options
77
Rich content
154
Rich text
155
ROOT folder
23
Skipped Messages
75
Software Piracy
157
Software updates
20
software_DNA
18
softWORKZ 18
Source IMAP Folders screen
58
Source Location screen
57
Source MAPI Folders screen
58
Source Switches
98
Speed up Aid4Mail
41
SSL
155
Start Processing Mail screen
74
Status flags
155
Status indicators
155
Strict File Format Check - Advanced Options
Strict mbox Mail Separator Format
78
Styled text
155
Subscription Renewals
156
Supported mail formats
21
System Requirements
5
System variables
145
78
Index
TrashFolders.dat
56
Trial limitations
17
Trial mode
17
Trial Mode screen
75
-U-
-Y-
55
Yahoo! Mail
23
Yahoo! Mail settings
139
52
139
47
186