Sei sulla pagina 1di 193

Aid4Mail 4

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

Special thanks to:


We want to thank EC Software who wrote this great help tool called
HELP & MANUAL which printed this document.

Aid4Mail 4 Help

Table of Contents
Foreword

Part I General Information

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

Part II Reference Information

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

Copyright 2005-2016 Fookes Holding Ltd

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

Copyright 2005-2016 Fookes Holding Ltd

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

Part III Purchasing and License Agreement

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

Part IV Other Information

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

Part V Copyright and Disclaimer


Index

180
181

Copyright 2005-2016 Fookes Holding Ltd

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.

Context Sensitive Help


You can display the relevant help topic at any point in the Aid4Mail program simply by pressing your
keyboard's F1 function key. This manual is for Aid4Mail version 4.0, so earlier versions may not have
some of the capabilities discussed here.

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

Copyright 2005-2016 Fookes Holding Ltd

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.

Who Uses Aid4Mail?


Aid4Mail clients include:
fortune 500 corporations,
leading law and e-discovery firms,
government and law enforcement agencies,
intelligence and military organizations,
educational and scientific institutions,
small and medium sized businesses,
home users and students.
Aid4Mail Console is used as the mail processing engine for a major financial institution as well as a
leading search engine. An OEM version runs seamlessly within several well-known e-discovery
products.

User-Friendly and Fast


Aid4Mail offers a modern and user-friendly interface, with fast mail processing to save time and
ultimately cut costs. Its comprehensive documentation fully covers all the software features.
In our testing, even with large mail files Aid4Mail produced problem-free exports in a few seconds.
Reprinted from PC Magazine (USA) w ith permission.

Why Choose Aid4Mail Over a Competing Product?


Email conversion is a complex task with many pitfalls and no product is perfect. However Aid4Mail
consistently produces more accurate results than any of its closest competitors, notably when importing
or exporting from Outlook, Exchange, PST and MSG files. You cannot afford to lose important email
data during large-scale migrations or forensic investigations. If you value the integrity of your data, try
Aid4Mail for free and carefully compare its output with any competing solution.

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.

E-discovery and Forensic-Examination


Aid4Mail eDiscovery can search PST files and all supported mail formats, by date range and by
keywords in the message body or header. Special Boolean operations are supported, as are wildcards
and Regular Expressions. Custom filters and output formats can be created through the new scripting
language.
Aid4Mail eDiscovery can launch external console applications and can export to non-proprietary formats
including MHT, XML, PDF, and the new industry standard PDF/A. It supports various hash functions and

Copyright 2005-2016 Fookes Holding Ltd

Aid4Mail 4 Help

maintains formatting, sender/recipient information, attachments, embedded contents, and message


status more faithfully than any of its competitors.

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.

Supported Mail Formats


Aid4Mail supports many email applications including Office Outlook for Windows (MAPI email profiles,
MSG files, and mounted/unmounted PST files), Microsoft Exchange, Outlook Express, Windows Mail,
Windows Live Mail, Mozilla Mail and Thunderbird, Netscape Messenger, Eudora for Windows and Mac,
Pegasus Mail, UNIX mbox, Pine mbox, Entourage MBOX, Backupify mbox, Google Takeout, Google
Apps Vault, maildir, EML, Apple Mail (EMLX), Mail.app for Mac, The Bat!, PocoMail, Barca, Opera Mail,
Forte Agent, FoxMail (up to version 6.5), Calypso, Courier, PMMail, HTML, MHT, Excel.
IMAP accounts and web mail services such as Office 365, Gmail, Yahoo! Mail, Zoho Mail, AIM.Mail
(AOL Mail), FastMail, and GMX Mail. Export to PDF, PDF/A, CSV, XML, and custom output formats.
Supported IMAP servers include Courier, Cyrus, Dovecot, Zimbra, Microsoft Exchange, Novell
GroupWise, Lotus Domino, etc.
For a full list of Aid4Mail's supported formats, see the Supported Mail Formats page.

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.

Copyright 2005-2016 Fookes Holding Ltd

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.

All editions of Aid4Mail


Import/export Microsoft Outlook mail from PST and MSG files.
(Requires Outlook for Windows either the full version or a free trial version.)
Over 40 supported mail formats (see Supported Mail Formats for a complete list).
Support for the IMAP protocol so you can connect to a remote mail server and upload/download
messages. Works with popular services like Office 365, Outlook.com, Gmail and Yahoo! Mail.
Fast mail conversion, with greater fidelity than competing solutions.
User-friendly wizard interface, designed with accessibility in mind.
Many useful and unique export options.
Process mail folders and files from any drive, even off a CD-ROM, DVD, or USB drive.
Create highly compressed mail archives in standard ZIP files (see the Archiving Email page for more
information.)
Merge mailbox files into a single one, or splits a large mailbox into smaller ones.
Process huge mailbox files successfully processed a 264 GB mbox file with 3 million emails.
Process huge email messages successfully converted a 270 MB email message.
Correctly exports emails with attachments, embedded contents, rich text, and status information (see
examples).
Easily extract file attachments, embedded contents, and email addresses.
Rebuild Qualcomm Eudora, PocoMail, Calypso, and Courier archive messages back to standard
MIME format.
Strip attachments from messages and even save emails in plain text format.
Filter out duplicate emails.

Aid4Mail Professional, Aid4Mail eDiscovery, and Aid4Mail Console only


Import/export Microsoft Exchange mail through a MAPI profile.
(Requires Outlook for Windows either the full version or a free trial version.)
Filter messages by date range and/or by matching text in the mail header and/or message body.
Create filter scripts and export scripts, for full control on email filtering, data extraction, and export to
custom formats.
Export mail to PDF files.
Export mail to the MHT format for viewing in Internet Explorer.
Export mail details to a tab-delimited file for import into a database.

Aid4Mail eDiscovery and Aid4Mail Console only


Process unpurged email from most mail clients (except Office Outlook and Exchange.)
Restore unpurged email during export operation.
Export mail to PDF/A files (long-term archiving format).
Export mail to encrypted PDF files (password protected).
Embed either original RFC header or full email in exported PDF files.
Receive email notifications (notifications in Aid4Mail Console) to alert you when a migration/conversion
session ends as well as when an account fails to process.
Offline activation.

Aid4Mail Console only


Copyright 2005-2016 Fookes Holding Ltd

Aid4Mail 4 Help

Includes Aid4Mail Console Launcher to easily manage concurrent migrations/conversions.


Supports CSV files with settings for multiple migrations.
Run from batch files, scripts, the Windows Start/Run dialog, and any application that can execute
other programs.
Process more than one PST file unattended.
Run from a server (custom Server license). Note that due to third-party licensing terms, the server
edition of Aid4Mail Console currently does not include the PDF export option.

Aid4Mail Console (Site, Migrator, and OEM licenses) only


Does not require product activation.
Run from a USB flash drive or a server, to speed up migration when going from one desktop computer
to the next.

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)

64 MB of RAM, 8 MB of free disk space.


Pentium (or compatible) processor.
To process (from/to) Outlook MSG files, PST files, and Outlook/MAPI mail profiles, Aid4Mail
requires Office Outlook for Windows (their free 60-day trial version is sufficient).
Microsoft Exchange messages can either be processed through an Outlook/MAPI mail profile (see
requirements in previous point), or through the IMAP protocol in which case the Exchange server
needs to be set up for IMAP access (see Microsoft's instructions).
Note:
Aid4Mail is compatible with all 32-bit versions of Outlook for Windows, but may encounter
compatibility issues with versions older than Outlook 2003.
We offer a separate edition of Aid4Mail that supports the 64-bit version of Office Outlook 2010,
2013 and 2016.
Aid4Mail is an out-of-process application and is not compatible with Click-to-Run installations of
Outlook 2010; if available, you will need to re-install Outlook using another method, following
Microsoft's instructions.
If you have Outlook 98/2000 then it should be installed in Corporate/ WorkGroup mode in order to
process PST and MSG files. If it is installed in Internet Mail Only (IMO) mode, then only the default
MAPI profile can be processed.
PST files from Outlook 8.x for Mac are not supported. Note that Outlook 2011 for Mac can import
Copyright 2005-2016 Fookes Holding Ltd

General Information

PST files created by Aid4Mail.

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.

Office Outlook Compatibility


Our website download page provides an edition of Aid4Mail that is compatible with Outlook 32-bit, which
is by far the most common version (it's also installed by default under Windows 64-bit). However, if the
regular Aid4Mail edition detects Outlook 64-bit on your system, it will prompt you to download the
compatible version. Aid4Mail will guide you step-by-step through the process. If for some reason you are
unable to get the Outlook 64-bit compatible edition of Aid4Mail, please contact us for help.

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.

Office Outlook Compatibility


Our website download page provides an edition of Aid4Mail that is compatible with Outlook 32-bit, which
is by far the most common version (it's also installed by default under Windows 64-bit). However, if the
regular Aid4Mail edition detects Outlook 64-bit on your system, it will prompt you to download the
compatible version. Aid4Mail will guide you step-by-step through the process. If for some reason you are
unable to get the Outlook 64-bit compatible edition of Aid4Mail, please contact us for help.
The Aid4Mail version with support for Outlook 64-bit can be recognized by the [O64b] displayed next to
the version number in the program interface.

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

Setup Command-Line Parameters


The Setup program used for installing Aid4Mail accepts optional command line parameters. These can
be useful to system administrators, and to other programs calling the Setup program.
/SPDisables the "This will install... Do you wish to continue?" prompt at the beginning of Setup.
/SILENT, /VERYSILENT
Instructs Setup to be silent or very silent. When Setup is silent the wizard and the background window
are not displayed but the installation progress window is. When a setup is very silent this installation
progress window is not displayed. Everything else is normal so for example error messages during
installation are displayed and the startup prompt is (if you haven't disabled it with the '/SP-' command
line option explained above.)
If a restart is necessary and the '/NORESTART' command isn't used (see below) and Setup is silent, it
will display a "Reboot now?" message box. If it's very silent it will reboot without asking.
/SUPPRESSMSGBOXES
Instructs Setup to suppress message boxes. Only has an effect when combined with '/SILENT' and '/
VERYSILENT'.
The default response in situations where there's a choice is:
Yes in a 'Keep newer file?' situation.
No in a 'File exists, confirm overwrite.' situation.
Abort in Abort/Retry situations.
Cancel in Retry/Cancel situations.
Yes (=continue) in a DiskSpaceWarning/DirExists/DirDoesntExist/NoUninstallWarning/
ExitSetupMessage/ConfirmUninstall situation.
Yes (=restart) in a FinishedRestartMessage/UninstalledAndNeedsRestart situation.

Copyright 2005-2016 Fookes Holding Ltd

General Information

5 message boxes are not suppressible:


The About Setup message box.
The Exit Setup? message box.
The FileNotInDir2 message box displayed when Setup requires a new disk to be inserted and the disk
was not found.
Any (error) message box displayed before Setup (or Uninstall) could read the command line
parameters.
Any message box displayed by [Code] support function MsgBox.
/LOG
Causes Setup to create a log file in the user's TEMP directory detailing file installation and execution
actions taken during the installation process. This can be a helpful debugging aid. For example, if you
suspect a file isn't being replaced when you believe it should be (or vice versa), the log file will tell you if
the file was really skipped, and why.
The log file is created with a unique name based on the current date. (It will not overwrite or append to
existing files.)
The information contained in the log file is technical in nature and therefore not intended to be
understandable by end users. Nor is it designed to be machine-parseable; the format of the file is
subject to change without notice.
/LOG="filename"
Same as /LOG, except it allows you to specify a fixed path/file name to use for the log file. If a file with
the specified name already exists it will be overwritten. If the file cannot be created, Setup will abort with
an error message.
/NOCANCEL
Prevents the user from cancelling during the installation process, by disabling the Cancel button and
ignoring clicks on the close button. Useful along with '/SILENT' or '/VERYSILENT'.
/NORESTART
Instructs Setup not to reboot even if it's necessary.
/RESTARTEXITCODE=exit code
Specifies the custom exit code that Setup is to return when a restart is needed. Useful along with '/
NORESTART'. Also see Setup Exit Codes.
/LOADINF="filename"
Instructs Setup to load the settings from the specified file after having checked the command line. This
file can be prepared using the '/SAVEINF=' command as explained below.
Do not forget to use quotes if the file name contains spaces.
/SAVEINF="filename"
Instructs Setup to save installation settings to the specified file. Do not forget to use quotes if the file
name contains spaces.
/DIR="x:\dirname"
Overrides the default directory name displayed on the Select Destination Location wizard page. A fully
qualified pathname must be specified.
/GROUP="folder name"
Copyright 2005-2016 Fookes Holding Ltd

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

Setup Exit Codes


The Aid4Mail Setup program may return one of the following exit codes:
0 Setup was successfully run to completion.
1 Setup failed to initialize.
2 The user clicked Cancel in the wizard before the actual installation started, or chose "No" on the
opening "This will install..." message box.
3 A fatal error occurred while preparing to move to the next installation phase (for example, from
displaying the pre-installation wizard pages to the actual installation process). This should never
happen except under the most unusual of circumstances, such as running out of memory or Windows
resources.
4 A fatal error occurred during the actual installation process.
Note: Errors that cause an Abort-Retry-Ignore box to be displayed are not fatal errors. If the user
Copyright 2005-2016 Fookes Holding Ltd

General Information

10

chooses Abort at such a message box, exit code 5 will be returned.


5 The user clicked Cancel during the actual installation process, or chose Abort at an Abort-RetryIgnore box.
Before returning an exit code of 1, 3, or 4, an error message explaining the problem will normally be
displayed.
Future versions of the Aid4Mail Setup program may return additional exit codes, so applications
checking the exit code should be programmed to handle unexpected exit codes gracefully. Any non-zero
exit code indicates that Setup was not run to completion.

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.

Uninstaller Command-Line Parameters


The uninstaller program (unins???.exe) accepts optional command line parameters. These can be useful
to system administrators, and to other programs calling the uninstaller program.
/SILENT, /VERYSILENT
When specified, the uninstaller will not ask the user for startup confirmation or display a message
stating that uninstall is complete. Shared files that are no longer in use are deleted automatically without
prompting. Any critical error messages will still be shown on the screen. When '/VERYSILENT' is
specified, the uninstallation progress window is not displayed.
If a restart is necessary and the '/NORESTART' command isn't used (see below) and '/VERYSILENT' is
specified, the uninstaller will reboot without asking.
/SUPPRESSMSGBOXES
Instructs the uninstaller to suppress message boxes. Only has an effect when combined with '/SILENT'
and '/VERYSILENT'. See '/SUPPRESSMSGBOXES' under Setup Command Line Parameters for more
details.
/LOG
Causes Uninstall to create a log file in the user's TEMP directory detailing file uninstallation and
[UninstallRun] actions taken during the uninstallation process. This can be a helpful debugging aid.
The log file is created with a unique name based on the current date. (It will not overwrite or append to
existing files.) Currently, it is not possible to customize the file name.
The information contained in the log file is technical in nature and therefore not intended to be
understandable by end users. Nor is it designed to be machine-parseable; the format of the file is
subject to change without notice.
/NORESTART
Instructs the uninstaller not to reboot even if it's necessary.

Copyright 2005-2016 Fookes Holding Ltd

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

Which version do I need?


Please click the link below that matches your intended usage of Aid4Mail:
Home user migrating non-professional mail
Individual or organization migrating professional mail
Service provider (including e-discovery, forensic-examination, and archiving services)
E-discovery or forensic-examination professional (but not a service provider)
Email archivist (but not a service provider)

1.6.1

Home user migrating non-professional mail


For home users and students migrating non-professional mail:

1. Aid4Mail Home Personal


Features:
Process over 40 mail formats
Support for Microsoft Outlook MSG and PST files
Export to generic mail formats (mbox and EML)
Create non-proprietary ZIP archives
Extract email addresses and attachments
Rebuild proprietary formats to internet standards

Copyright 2005-2016 Fookes Holding Ltd

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:

2. Aid4Mail Professional Personal


Same features as Aid4Mail Home Personal, plus:
Support for Microsoft Exchange, through MAPI profile
Export to searchable PDF, Excel, and HTML
Save to CSV and database formats
Filter emails by date, keywords, and text
Scriptable (custom filters and output formats)
Can be used in a professional context
Customer support included in subscription
Important:
This license 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).

3. Aid4Mail eDiscovery Personal


Same features as Aid4Mail Professional Personal, plus:
Process unpurged mail
Export to PDF/A format
Scripting supports various hash functions
Exchange email data with external console programs
Offline activation
Optional Aid4Mail Console bundle
Important:
This license 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).

1.6.2

Individual or organization migrating professional mail


The following licenses are for migrating mail in a professional/business context:

1. Aid4Mail Professional Personal


Features:
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, Excel, and HTML
Save to CSV and database formats
Extract email addresses and attachments
Copyright 2005-2016 Fookes Holding Ltd

13

Aid4Mail 4 Help

Rebuild proprietary formats to internet standards


Filter emails by date, keywords, and text
Scriptable (custom filters and output formats)
Transferable (see EULA terms)
Customer support included in subscription
Important:
This license 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).

2. Aid4Mail Professional Site


Same features as Aid4Mail Professional Personal, plus:
One license and activation code covers multiple seats
Choose any number of seats between 3 and 20,000
Online control panel to manage seats
Important:
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).

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:

4. Aid4Mail eDiscovery Personal


Same features as Aid4Mail Professional Personal, plus:
Process unpurged mail

Copyright 2005-2016 Fookes Holding Ltd

General Information

14

Export to PDF/A format


Scripting supports various hash functions
Exchange email data with external console programs
Offline activation
Important:
This license 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).

1.6.3

Service provider (including e-discovery, forensic-examination, and archiving


services)
The following license is for service providers:

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

E-discovery or forensic-examination professional (but not a service provider)


The following license is for e-discovery / forensic-examination professionals:

Aid4Mail Forensic
Features:
Process unlimited mail accounts from a single seat

Copyright 2005-2016 Fookes Holding Ltd

15

Aid4Mail 4 Help

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)
Customer support included in subscription
Important:
This license is for e-discovery and forensic-examination professionals who are not service providers, i.e.
who are processing mail under investigation, in-house (e.g. police, law firm), and not as a service to a
clients (e.g. company offering forensic-examination services). It does not allow for mail migration.
If you are a service provider, you need Aid4Mail Service instead. If you need to migrate mail, one of the
Aid4Mail Professional licenses or Aid4Mail Migrator would be necessary.

1.6.5

Email archivist (but not a service provider)


The following license is for professional email archivists:

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)

Copyright 2005-2016 Fookes Holding Ltd

General Information

16

Customer support included in subscription


Important:
This license is for professional email archivists who are not service providers, i.e. who are archiving mail
in-house (e.g. a law firm archiving their client mail) and not as part of a service to clients (e.g. company
offering archiving services).
If you are a service provider, you need Aid4Mail Service instead. If you need to migrate mail, one of the
Aid4Mail Professional licenses or Aid4Mail Migrator would be necessary.

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

Allows processing of professional mail

No

Yes

Yes

Yes

Process over 40 mail formats, including Yes


Outlook MSG and PST files *

Yes

Yes

Yes

Export/import generic mail formats


(mbox and EML)

Yes

Yes

Yes

Yes

Extract email addresses and


attachments

Yes

Yes

Yes

Yes

Create non-proprietary ZIP archives

Yes

Yes

Yes

Yes

Export/import MS Exchange mail *

No

Yes

Yes

Yes

Save to CSV and database formats

No

Yes

Yes

Yes

Export to searchable PDF, Excel, and No


HTML files

Yes

Yes

Yes

Filter emails by date, keywords, and


text

No

Yes

Yes

Yes

Scriptable (custom filters and output


formats)

No

Yes

Yes

Yes

Script functions offering hash support


and data exchange with 3rd party CLI

No

No

Yes

Yes

Process unpurged mail

No

No

Yes

Yes

Export to PDF/A format

No

No

Yes

Yes

Offline activation option

No

No

Yes

Yes

Aid4Mail Console bundle option

No

Yes

Yes
(Forensic)

N/A

Full command-line interface

No

No

No

Yes

Please visit our website for a more complete comparison chart.


* As stated in the System Requirements section of the Specifications page, Aid4Mail requires Office
Outlook for Windows to process messages from/to Outlook PST and MSG files, and MAPI profiles (used
to access an Exchange or PST store); you can use a free 60-day trial version of Outlook if you don't
have a license. Note that there may be some compatibility issues with Outlook 97.

Copyright 2005-2016 Fookes Holding Ltd

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.

1. Processing an Unlimited Number of Emails


This is the default option when you run Aid4Mail eDiscovery, Forensic, Service and Migrator in trial
mode. This feature is particularly useful when you want to evaluate the performance of Aid4Mail.
However, unlike "Preserving the Subject Line Text", the original subject line is not preserved in exported
emails: it is replaced with a trial notice. When exporting to individual message files (like EML and MSG),
the file names will always be based on the unique MD5 signature instead of the Subject line.
To enable this trial option, click on the "Software" button in the Aid4Mail wizard screen and choose the
"Test Unlimited Emails per Folder" option. This feature is turned on by default in Aid4Mail Console.

2. Preserving the Subject Line Text


This is the default option when you run Aid4Mail Home, Professional and Site in trial mode. When set,
Aid4Mail will process a maximum of 50 messages per mail folder (or 10 if you are exporting to one of the
MHT formats). The original subject line is preserved in exported messages but a numbered trial tag is
inserted in it. Example:
[Aid4Mail Trial tag #3] View your Office 365 Business billing statement

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.

Copyright 2005-2016 Fookes Holding Ltd

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.

Why should I care about piracy?


For an answer to this question, please see the Software Piracy topic.

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.)

Copyright 2005-2016 Fookes Holding Ltd

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.

Offline activation and re-activation


Offline activation and re-activation are available for Aid4Mail eDiscovery customers who need to work on
a computer that has restricted or no access to internet. They are also available for some Aid4Mail
Console licenses. Offline activation ties your license to the hardware signature of the offline computer.
For Aid4Mail Forensic customers, offline activation and re-activation is free of charge, and can be set up
by the user. For the other Aid4Mail eDiscovery licenses, offline activation is available on request and
needs to be set up by our customer support staff. There is no charge for initial activation but subsequent
re-activations require payment of a service fee. Please contact us for instructions on how to set up offline
activation.

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.

Frequently asked questions (FAQ)


For answers to frequently asked questions, please see the Product Activation FAQ topic.

1.10

How to Get Program Updates


When a new Aid4Mail update is available, you will see it listed in the News and Updates screen, which
is available from the Check News & Get Updates menu command displayed when you click on the
Software button. In some cases, the Setup file will be downloadable and installable directly from within
Aid4Mail. In other cases, your browser window will open to a download page on our website. A single
mouse click on the update item will start the download to your computer.
If you enable the Check for news updates setting on the News and Updates screen, Aid4Mail will
automatically check our website at regular intervals for updates and other news. No information about

Copyright 2005-2016 Fookes Holding Ltd

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

Supported Mail Formats


1. Aid4Mail can read mail from:
Microsoft Exchange through an Outlook profile1 (not available in Aid4Mail Home) or IMAP,
Outlook Personal Storage files 1 (*.pst),
Outlook MSG files 1 (*.msg),
Outlook Express versions 5 and 6 (*.dbx, *.eml and *.nws),
Outlook Express version 4 (*.idx and *.mbx),
Windows Live Mail2 (*.eml;*.nws),
Windows Mail2 (Vista mail client),
IMAP accounts (supported servers include Courier, Cyrus, Dovecot, Zimbra, Microsoft Exchange,
Novell GroupWise, Lotus Domino, etc.),
Webmail services that offer IMAP access, e.g. Gmail, Outlook.com, Outlook 365, Yahoo! Mail, Zoho
Mail, AOL Mail, FastMail, GMX Mail, etc.,
Mozilla mailbox files (including Thunderbird, SeaMonkey, Eudora OSE, and Netscape),
Google Takeout (*.mbox),
Google Apps Vault (*.mbox; not available in Aid4Mail Home),
Apple Mail exported mailbox files,
Apple Mail (Mail.app) message files (*.emlx),
Qualcomm Eudora mailbox files (*.toc and *.mbx),
Mac Eudora mailbox files 2,
Generic mailbox files (mbox, Entourage MBOX, Backupify, Evolution, Berkeley mail, BSD mail, Unix
mail format),
EML message files (*.eml, *.wdseml),
MHT Web Archive files (*.mht),
Pegasus mailbox files (*.pmi, *.pmm, and *.cnm),
The Bat! mailbox files 2 (*.msb and *.tbb),
PocoMail and Barca mailbox files (*.idx, *.idb, and *.mbx),
FoxMail mailbox files up to version 6.5 2 (*.box),
Opera mailbox files 2 (*.mbs),
Calypso and Courier archive files,
Forte Agent mailbox files 2 (*.idx),
Pine mbox files (with limited "From " escaping),

Copyright 2005-2016 Fookes Holding Ltd

General Information

22

PMMail message files 2 (*.msg),


Maildir folders (local copies),
MSN Mail v8 (*.MailDB),
Mailbag Assistant mailbox files (*.mbg),
E-mail Examiner mailbox files (*.pmx),
Aid4Mail ZIP archives (*.zip).
2. Aid4Mail can export/save mail to:
Microsoft Exchange through an Outlook profile1 (not available in Aid4Mail Home) or IMAP,
Outlook Personal Storage files 1 (*.pst),
Outlook MSG files 1 (*.msg) only if source mail comes from an Outlook profile or Outlook PST and
MSG files,
Windows Live Mail2,
Windows Mail2 (Vista mail client),
IMAP accounts (supported servers include Courier, Cyrus, Dovecot, Zimbra, Microsoft Exchange,
Novell GroupWise, Lotus Domino, etc.),
Webmail services that offer IMAP access, e.g. Yahoo! Mail, Gmail, Zoho Mail, AOL Mail, FastMail,
GMX Mail, Outlook.com, Outlook 365, etc,
Mozilla mailbox files (including Thunderbird, SeaMonkey, and Eudora OSE),
PocoMail and Barca mailbox files (*.mbx),
Generic mailbox files, (mbox, Entourage MBOX, Evolution, Berkeley mail, BSD mail, Unix mail
format),
EML message files (*.eml),
Plain text files
MHT Web Archive files (*.mht) linked from an HTML index page or an MS Excel Workbook file (not
available in Aid4Mail Home),
MHT files with tab-delimited data file for import into a database (not available in Aid4Mail Home),
XML message files (not available in Aid4Mail Home),
Adobe Acrobat PDF files (not available in Aid4Mail Home),
Aid4Mail ZIP archives (*.zip).
Notes:
1. To process messages from/to Outlook MSG, PST files, and MAPI mail profiles, Aid4Mail requires
Office Outlook for Windows. For more details, free options, and limitations, see the system
requirements.
Currently only Aid4Mail Console can export a source MAPI profile or PST file to a target MAPI profile
or PST file. With Aid4Mail Home, Aid4Mail Professional, and Aid4Mail eDiscovery, the workaround is
to first export your emails to the Outlook MSG format, and then re-export those files to your target
format.
2. Aid4Mail currently cannot retrieve or restore mail status information (unread, read, replied, etc.) for
Windows Mail, Windows Live Mail, Mac Eudora, Entourage, Opera Mail, Forte Agent, PMMail,
FoxMail (up to version 6.5), Calypso and Courier.
3. 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.
4. Aid4Mail currently does not offer tools to convert address books, filters, or account settings from one
format to another.
Copyright 2005-2016 Fookes Holding Ltd

23

1.12

Aid4Mail 4 Help

Information About Mail Formats


1. Office Outlook and Microsoft Exchange through Extended MAPI (includes PST and MSG files)
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.
This format option is only available on computers that have a working version of Office Outlook for
Windows.
Our website download page provides an edition of Aid4Mail that is compatible with Outlook 32-bit, which
is by far the most common version (it's also installed by default under Windows 64-bit). However, if the
regular Aid4Mail edition detects Outlook 64-bit on your system, it will prompt you to download the
compatible version. Aid4Mail will guide you step-by-step through the process. If for some reason you are
unable to get the Outlook 64-bit compatible edition of Aid4Mail, please contact us for help.
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 Aid4Mail wizard can only process one PST file at a time. You will need Aid4Mail Console if you
want to process large numbers of PST files unattended. MAPI cannot access PST files that are on readonly media or write protected (Read-Only files). As a result, if the PST file is stored on a CD-ROM or
DVD, Aid4Mail will have to make a temporary copy of it in your Windows Temporary folder. If there is
insufficient space on your hard drive, Aid4Mail will not be able to process the contents of your Read-Only
PST file. Note also that PST files are not supported on file shares.
When exporting emails stored in the root of a MAPI folder tree (unusual, but can occur) to a generic
mailbox format with the restore folder option, Aid4Mail saves them to a target folder called ROOT. This
feature makes it easy to find those orphan messages.
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.
Known Issues:
Aid4Mail does not work with Click-to-Run installations of Outlook 2010.
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

Copyright 2005-2016 Fookes Holding Ltd

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

option as your Mail Source.


Before exporting messages to Windows Mail 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. Open Windows Mail once Aid4Mail has completed the transfer.
Windows Mail 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 Windows Mail.
4. Outlook Express
Many people think Outlook Express and Outlook are the same mail clients, or closely related. In fact,
other than the fact that they are both developed by Microsoft and have the "Outlook" part of the name in
common, these mail clients are totally unrelated. Their approach to storing mail is completely different
and the file formats that they produce are not interchangeable. Outlook Express only supports Simple
MAPI, which is a small subset of the Extended MAPI system.
Aid4Mail can read Outlook Express mail files directly; it does not need a copy of Outlook Express
installed on your computer to do so. Unlike most other conversion programs, Aid4Mail is capable of
retrieving status information (unread, read, replied, etc.) from your messages and restore these in the
output format.
During conversion, Aid4Mail won't access IMAP accounts configured in Outlook Express. Only local
mailbox files are processed. If you need to convert mail from IMAP accounts, choose the IMAP Mail
option as your Mail Source.
Outlook Express stores deleted messages in the Deleted Items.dbx file. Unfortunately, it corrupts the
messages during this process. Aid4Mail can extract these deleted messages, but it cannot fix corrupted
data. As a result, some messages may exhibit unusual characters or display code that you would not
normally see. Attachments and embedded contents in these messages will usually also be corrupted.
EML files produced by Aid4Mail can 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.
5. Thunderbird, SeaMonkey Mail, Eudora OSE, Mozilla Mail, Netscape Messenger
Thunderbird, Mozilla Mail, SeaMonkey, Eudora OSE, and recent versions of Netscape Messenger all
share the same mailbox format, which is very close to the mbox format. The main difference is in the
way mail status information (unread, read, replied, etc.) is stored. Aid4Mail can read the Mozilla status
flags and correctly convert them to other formats.
Note that Eudora OSE is basically a skin operating on top of Thunderbird. So if you need to export or
import from Eudora OSE, choose Mozilla Thunderbird as your mail format.
Mail stores are usually composed of two files: an index file (*.msf or *.snm) and a mailbox file (same
name as index file but without a file extension). Aid4Mail only processes mailbox files since that is
where the email messages are stored. As a result, missing or corrupted index files have no negative
influence on the quality of email conversions. Note that when the Windows Search Integration option is
set in Thunderbird, a copy of each message is stored with the .wdseml extension in a .mozmsg folder;
the file format is identical to EML files.

Copyright 2005-2016 Fookes Holding Ltd

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.

Copyright 2005-2016 Fookes Holding Ltd

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

17. Pine mbox (limited "From " escaping)


Pine supports a variety of mailbox formats, including its own variation of the mbox format. Like the other
generic mailbox formats, Pine uses a "From " delimiter line that marks the beginning of each message.
However, unlike most other mbox formats (based on mboxo, mboxrd, and mboxcl), the Pine variation
does not escape all occurrences of lines beginning with the "From " delimiter inside the message. As a
result, if a Pine mbox file is processed the same way as a regular generic mailbox file, some messages
may get split up into smaller parts instead of being treated as a single email. This often produces
unusable messages.
To avoid this problem when processing Pine mbox files, make sure you select "Pine mbox" instead of
"Generic mailboxes" as your Mail Source.
Note that Pine also supports a proprietary MBX format that is in no way related to the mbox format.
Aid4Mail currently cannot process those Pine MBX files.
18. Others
Aid4Mail currently cannot retrieve mail status information (unread, read, replied, etc.) from Opera Mail,
Forte Agent, PMMail, FoxMail (up to version 6.5), Calypso and Courier. Most of the time, MHT files do
not have any status information except for those created with Aid4Mail. Note that Foxmail does not store
date information for messages in the out.BOX. As a result, these outgoing messages are exported with
a default "unknown" date set to 1 Jan 1972. Also, Aid4Mail cannot restore the FoxMail folder hierarchy
and names are based on the mailbox file names.
Unless you use IMAP, you can only process Maildir folders if the files are available locally (i.e., they can
also be accessed through Windows Explorer). In most cases, you will first have to download the folders
from a remote server with an FTP utility to your computer.

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.

Copyright 2005-2016 Fookes Holding Ltd

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

Finding Mail Folders


If Aid4Mail cannot find the folder that contains your mail files, you will have to search for them either by
browsing through your disk folders using the Source Location file browser or the Folder Browser available
on the Target Settings page by clicking on the [] button in the Folder field. You might find it helpful to
use the Search tool provided by Windows under the Start menu; make sure you enable searching
through hidden folders (you may also need to use "Tools | Folder Options | View" in Windows Explorer
and select "Show hidden files and folders").
IMPORTANT: If you are exporting mail to a new mail client, the appropriate target folder may only exist
once you have set up a profile and/or mail account in it. We recommend that you fully configure your
new mail program before attempting to export mail to it with Aid4Mail.
The information below should help you find the mail folder for the specified mail client program. Many
programs store their data files under the "Application Data" folder. This is indicated below with the
<Application Data> token. The path to this folder depends on your Windows version and your system's
configuration. See the topic "Finding the Application Data folder" below for information on where to find it.

Copyright 2005-2016 Fookes Holding Ltd

33

Aid4Mail 4 Help

Finding the Application Data folder


On Windows 10, 8, 7 and Vista systems, look for
<SYSTEMDRIVE>\Users\<user>\AppData\Roaming
and in the case of Microsoft Outlook, Windows Mail, and Windows Live Mail:
<SYSTEMDRIVE>\Users\<user>\AppData\Local
On Windows 2000 and XP systems, look for
<SYSTEMDRIVE>\Documents and Settings\<user>\Application Data
and in the case of Microsoft Outlook and Windows Live Mail:
<SYSTEMDRIVE>\Documents and Settings\<user>\Local Settings\Application Data
On a Windows 98 system without individual user logins, look for
<SYSTEMDRIVE>\Windows\Application Data
On a Windows 98 system with individual user logins, look for
<SYSTEMDRIVE>\Windows\Profiles\<user>\Application Data
and in the case of Microsoft Outlook:
<SYSTEMDRIVE>\Windows\Profiles\<user>\Local Settings\Application Data
On a Windows NT system, look for
<SYSTEMDRIVE>\Winnt\Profiles\<user>\Application Data
and in the case of Microsoft Outlook:
<SYSTEMDRIVE>\Winnt\Profiles\<user>\Local Settings\Application Data
<SYSTEMDRIVE> is usually drive "C:". <user> represents the name you use to log on to Windows. On
an NT system or a Windows 98 system with user profiles, mail files will probably be located by default in
the second set of Application Data folders.

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

Frequently Asked Questions (FAQ)


Please choose one of the following Frequently Asked Questions topics:
Ordering Aid4Mail FAQ
Product Activation FAQ
General Aid4Mail FAQ
Office Outlook FAQ
Using Aid4Mail with Macs FAQ

1.15.1 Ordering Aid4Mail FAQ


Q. Where can I buy your software from? Do you have a local dealer?
A. 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.
Q. I have a license for Aid4Mail version 1. How do I get an upgrade discount for the latest
version?

Copyright 2005-2016 Fookes Holding Ltd

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.

Copyright 2005-2016 Fookes Holding Ltd

39

Aid4Mail 4 Help

1.15.2 Product Activation FAQ


Q. I have an internet connection and entered my code correctly. Why does activation fail?
A. The most typical reason is one or more firewall programs (Norton, Zone Alarm, Windows Firewall) are
blocking Aid4Mail's access to the internet. Make sure that all your firewalls allow both Aid4Mail.exe and
DNA.dll to reach the activation server. If you are accessing the internet through a Proxy server and
you've configured the Aid4Mail proxy settings, make sure these are valid. If you are not using Internet
Explorer as your browser, it may be configured with invalid proxy settings; unchecking the "Use IE proxy
configuration" option in the Proxy Settings screen could help resolve the connection issue.
It is also possible that a connection fails because of heavy internet traffic. The only solution in this case
is to wait 15 minutes or more and then repeat the activation procedure.
Important: If you are using Windows Firewall and Aid4Mail cannot reach the license server, make sure
that you uncheck the option labeled "Block all incoming connections" (Windows Vista) or "Don't allow
exceptions" (Windows XP); you will find the option in the Windows Firewall settings window which opens
from the Control Panel. If this setting is enabled, you are not notified when Windows Firewall blocks
programs, and programs on the Exceptions list are ignored.
Q. Can I activate Aid4Mail version 4 with my activation code from v1?
A. No. Starting with Aid4Mail version 2 activation codes are different from those of version 1.
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 4. Simply visit our upgrade page and enter either
one of your activation codes or your Plimus order number.
Q. What happens when my Aid4Mail subscription runs out?
A. The Aid4Mail program simply reverts to trial mode. This does not affect any of the files you created
during the subscription period. Do you have an annual subscription? If so, renew before your annual
subscription period runs out and benefit from a significant discount over the regular price. You can also
renew after your annual subscription expires, but the discount is smaller.
Q. I am having problems activating my license under Windows 10, 8, 7 or Vista. How can I fix
this?
A. You may need to put a specific exemption for Aid4Mail under the Data Execution Prevention (DEP)
settings. This will allow Aid4Mail to both activate its license in the first place and run subsequently.
Q. Re-activation is not working although I am entering the correct activation code and
password. Why?
A. This usually happens because the character case of the entered password does not match the case
of the original password. Check that your Caps Lock key isn't engaged while you are entering your
password. Check also that you are typing the characters in the same case as the original password.
Make sure you are entering your current and new password in the corresponding fields. Another
password-related problem is when you try to re-activate your license with a new password that you have
already used before. Make sure that the password you type in the "New Password" field has never been
used before in Aid4Mail.
In some rare cases when internet traffic is high, the connection to the license server may time out.

Copyright 2005-2016 Fookes Holding Ltd

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)

1.15.3 General Aid4Mail FAQ


Q. How do I transfer mail from my old computer to my new one?
A. First install Aid4Mail on your old computer and activate your license. On your old computer, use
Aid4Mail to convert your source mail to the Aid4Mail ZIP Archive format. Next, transfer the resulting ZIP
file to your new computer and install Aid4Mail on it; then re-activate your license. Finally, use Aid4Mail
on your new computer to export your ZIP Archive contents to your new mail program.
Q. How do I migrate my Outlook Express mailboxes from my old Windows XP computer to
Office Outlook on my new PC?
A. The simplest solution is to transfer your Outlook Express mail folders from your old PC to your new
computer.
First, you need to find where your OE files are. These are the possible default locations for Outlook
Express under Windows XP:
C:\Documents and Settings\<user>\Application Data\Identities\<GUID>\Microsoft\Outlook
Express\

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?

Copyright 2005-2016 Fookes Holding Ltd

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

Copyright 2005-2016 Fookes Holding Ltd

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.

2) To find locally stored IMAP folders (when message synchronizing is enabled):


First choose the Tools -> Account Settings menu command to open the dialog box. Then select the
"Server Settings" item under the IMAP account name you are searching for. You will find the root folder
path in the "Local directory" field. Note that you should not choose that location as your target
destination for converted emails.
Q. After exporting my messages to Thunderbird, I find that some of my mail folders are
missing. Why?
A. 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.
Q. Why do exported EML and MSG file have the current date stamp instead of the original
email date?
A. This problem is usually caused by the Windows file indexing feature, which updates the file date
stamp on reading it. Suggestion: in Windows, go to Control Panel -> Indexing Options -> Advanced ->
File Types, and uncheck the extensions "eml" and "msg" from the list.
Q. Why does Aid4Mail slow down when converting many emails to individual files (EML and
MSG)?
A. This problem may be caused by the Windows file indexing feature or your anti-virus program.
Suggestion: in Windows, go to Control Panel -> Indexing Options -> Advanced -> File Types, and
uncheck the extensions "eml" and "msg" from the list.
Q. How do I import EML files into Outlook Express?
A. EML files produced by Aid4Mail can 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.
Q. The CSV file I created with Aid4Mail does not display correctly in Microsoft Excel. Why?
A. Microsoft Excel cannot handle cell data that exceeds 32 KB. Excel will split any email that exceeds
the data size limit into smaller chunks and spread them across several columns. As a result, columns
will contain incorrect data in certain rows.
Note that Excel does not recognize CSV files using the UTF-8 text encoding unless the data is
proceeded with a byte order mark (BOM) encoding signature. If you open a UTF-8 encoded CSV file that
lacks a BOM in Excel, all special extended characters will be rendered incorrectly.
Q. Attachments in MHT files get saved with a bad file name. Why?

Copyright 2005-2016 Fookes Holding Ltd

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

the messages will be found in the target mailbox created by Aid4Mail.


Q. Are there known issues when processing email files?
A. Aid4Mail currently does not support certain folder file names that contain Unicode characters. Such
folders and files cannot be processed unless they are renamed so as to remove unsupported characters.

1.15.4 Office Outlook FAQ


Q. I cannot see options to process Office Outlook mail. Why?
A. Make sure Office Outlook for Windows is correctly installed on your system. Aid4Mail cannot
process MAPI mail accounts, PST, and MSG files if Extended MAPI is not available. For more details,
free options, and limitations, see the system requirements.
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. How do I import my old Outlook files to another mail program on a new computer that does
not have Office Outlook?
A. If you still have your old computer with Office Outlook, first install Aid4Mail on it and activate your
license. Then convert your Outlook mail to the Aid4Mail ZIP Archive format. Next, transfer the resulting
ZIP file to your new computer and install Aid4Mail on it; then re-activate your license. Finally, use
Aid4Mail to export your ZIP Archive contents to your new mail program.
Q. When I select a PST file or a MAPI profile, Aid4Mail does not see any mail folders/
messages.
A. This issue could be due to one of the following reasons...
1.

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

Copyright 2005-2016 Fookes Holding Ltd

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.

Copyright 2005-2016 Fookes Holding Ltd

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.

1.15.5 Aid4Mail ZIP Archives FAQ


Q. How do I read archived mail?
A. 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.15.6 Using Aid4Mail with Macs FAQ


Q. Can Aid4Mail run on a Mac system?
A. Aid4Mail will run on Intel-based Macs that are running Windows or Wine, and on PowerPC Macs
using Virtual PC. However, we do recommend that you try Aid4Mail first before purchasing a license to
ensure that it is compatible with your computer system and that it satisfies your requirements.
Q. Does Aid4Mail support Apple Mail (Mac OS X)?
A. Yes. 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
Copyright 2005-2016 Fookes Holding Ltd

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.

Copyright 2005-2016 Fookes Holding Ltd

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

Section 508 Voluntary Product Accessibility Template (VPAT)


The Voluntary Product Accessibility Template (VPAT) is a document that contains a list of requirements
needed for a product to conform to Section 508 of the Rehabilitation Act. The template format allows
vendors to state their products' conformance to Section 508, requirement by requirement. For more
information on Section 508 visit www.section508.gov
The Aid4Mail VPAT is available for download in the Adobe Acrobat (PDF) and Microsoft Word (DOC)
formats:
Download VPAT in Adobe Acrobat (PDF) format
Download VPAT in Microsoft Word (DOC) format
NOTICE: The VPAT document is provided for market research purposes only and its contents are
subject to change without notice. The information in this document does not constitute legal advice,
warranty, or guarantee regarding a person's ability to comply with applicable accessibility requirements.
Such a determination is the sole responsibility of the purchaser.

Copyright 2005-2016 Fookes Holding Ltd

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.

Copyright 2005-2016 Fookes Holding Ltd

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

Copyright 2005-2016 Fookes Holding Ltd

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

4. Source MAPI Folders


This screen is only displayed if you have selected a PST file or MAPI as your mail source. When
Aid4Mail opens your MAPI profile successfully, you will see a hierarchical tree structure with folder
names and the number of messages they contain in parentheses. Uncheck the MAPI 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.
If you do not see message folders listed in this screen, this could be due to one of the following
reasons...
1.

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

5. Source IMAP Folders


This screen is only displayed if you have selected IMAP as your mail source. When Aid4Mail opens
your IMAP account successfully, you will see a hierarchical tree structure with folder names and the
number of messages they contain in parentheses. The message count includes deleted emails that
haven't been expunged (these are skipped unless you have an eDiscovery edition that is set to process

Copyright 2005-2016 Fookes Holding Ltd

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.

Filter Mail by Date


Use the two date fields to define a date range limiting which email messages will be processed. Dates
use the international yyyy/mm/dd format (4-digit year/2-digit month/2-digit day). You can select a date
from a popup calendar by clicking on the arrow button. No date filtering will occur if both fields are blank.
You can leave one of the date fields blank to include all messages at one end of the date-range
spectrum.
Configure the "Date to check" field to define whether Aid4Mail should use the date when the message
was sent to you (Mail Sent), when it was received by your mail server (Mail Received), or when it was
downloaded by your mail client (Mail Stored). With outgoing mail there is no difference between the Mail
Sent and Mail Received fields. With some mail clients, the Mail Stored value cannot be determined. In
this case, Aid4Mail uses the Mail Received or Mail Sent value instead. For emails that are stored as
EML, MHT, or CNM files, Aid4Mail determines the Mail Stored date from the file date stamp; this may
not correspond to the date when the mail was downloaded in your mail client though.
The date filter is very useful for creating incremental backups of your emails. Define a date range and
then save all the messages from that period in a ZIP archive and do this at regular intervals, whether it be
once a day, once a week, once a month, once a year, etc.
In the following example, Aid4Mail will only process emails that were received during year 2004:
Ignore if older than:
Ignore if newer than:
Date to check:

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>

Copyright 2005-2016 Fookes Holding Ltd

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

Filter Mail by Content


You can define a list of words that Aid4Mail will search for in each message header (found in header),
message body text (found in message text), both the header and body text (found in header or text), or
the whole email in raw MIME format (found in whole email). Depending on the option you select,
Aid4Mail will either reject or accept a message that contains the text search criteria. The list should
contain one search criteria per line. The longer the list, the longer it will take Aid4Mail to filter each
email. You can improve performance by placing the most common search terms at the beginning of the
list. Leave the list blank if you do not want to filter by content.
In theory, the list can contain up to 134,217,728 words. However, you're likely going to run out of RAM
well before that amount. Furthermore, the longer your list, the longer it will take to process your mail.
Matching is case sensitive for lines that have one or more uppercase characters, and case insensitive for
lowercase search criteria. A match only occurs if the search criteria covers whole words. For example, if
your search criteria is "spam" (without the quotes), it will match the word "SPAM", but not "spammer".
The search criteria "FREE" will only match the word "FREE", but not "free" or "FREEWAY". The search
criteria "jane doe" will match "Jane Doe" and "JANE DOE", but not "Jane M. Doe".
Aid4Mail currently does not support filtering using Unicode search text. When searching Unicode
messages, Aid4Mail first converts the message body text to the current ANSI character set. Unicode
characters that do not have an ANSI equivalent character are substituted with a "?" character.
You can negate the effect of a text criteria by starting it with a minus character (-). If you must start a
regular search criteria with a minus or hyphen character, just add a second one to cancel the negate
effect. A match with a negate criteria will reject a message if the "found in header" option is set, and will
accept the message if the "not found in header" option is set.
You can start a text criteria with a plus character (+) to instruct Aid4Mail to combine it with the previous
criteria. If you must start a regular search criteria with a plus character, just add a second one to cancel
the addition effect. If the "found in header" option is set, the message is only accepted if it contains
occurrences of the preceding and current criteria. If the "not found in header" option is set, the message
is only rejected if it contains occurrences of both the preceding and current criteria. Note that the plus
character is ignored if it follows a negate criteria. See example #3 below.
Message headers usually contain the email date, subject, sender name and address, recipient names
and addresses, server relay path (or travel history), and sometimes organization name and mailer name.
Typically, you will create search criteria with email addresses and/or keywords that may appear
regularly in a message subject.
The "Manage Words List" button gives you access to a drop-down menu with commands to open a
Words List, save a Words List under a new name, and clear the list. Aid4Mail automatically saves
modified Words Lists. If no name has been assigned, it saves the list in a file called "WordsList.txt"
under the "Application Data\Aid4Mail" folder.
Copyright 2005-2016 Fookes Holding Ltd

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&iuml;ve", and "na&#239;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&eacute;", and "caf&#233;".
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=

produces a normal search


produces a wildcard search
produces a regular-expression search

Words list example #1:


-spam@fookes.com
@fookes.com
Assuming the "found in header" option is set, Aid4Mail will accept all messages that have an "@fookes.
com" address except those that have the address "spam@fookes.com". Other messages that do not
have "@fookes.com" in the header are rejected. The order of the text search criteria is important here. If
"@fookes.com" is placed before "-spam@fookes.com", then the negate criteria never gets tested
Copyright 2005-2016 Fookes Holding Ltd

Reference Information

62

because the message is already accepted because "@fookes.com" is found.


Words list example #2:
FREE
mortgage~
home owner~
pharma*
pill~
prescr?pt??n~
spam@fookes.com
@adpromailer.com
@emailfactory
R=free (bonus|debt|loan|money)
R=c(i|1)(a|@)l(i|1)s
R=v(i|1)(a|@)gr(a|@)
R=x(a|@)n(a|@)x
Assuming the "not found in header" option is set, Aid4Mail will reject all messages that have any of the
listed search criteria in the header. The above list includes criteria with wildcards and regular expression
patterns.
Words list example #3:
important@fookes.com
+aid4mail
important@fookes.com
+mailbag assistant
Assuming the "found in header" option is set, 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
Subject line.

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.

Copyright 2005-2016 Fookes Holding Ltd

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

Office Outlook & Microsoft Exchange


Other mail clients
Export email to remote server
Generic mail formats (Outlook Express)
Extract message contents only
MHT Web Archive files
Mail archives
Custom formats using scripts

Office Outlook & Microsoft Exchange


The first option is not available in Aid4Mail Home. Note also that the two first options below will not be
available if your mail source is a MAPI profile or a PST file.
IMPORTANT
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.

1. Email Profile (export to an Outlook or Exchange mail account)


Select this option to save your source mail into a MAPI store. Please make sure you have correctly
configured an email profile in Outlook before using this option.
Aid4Mail will display the folders of default store connected to the chosen profile. Starting with Outlook
2003, you can store up to 20 GB of data into a MAPI store if your profile is connected to a Unicode PST
file (up to 50 GB with Outlook 2010, 2013 and 2016). But with older versions of Microsoft Outlook you
cannot exceed 2 GB of data. Aid4Mail cannot detect when the size limit is reached so you need to
ensure that your mail files are well within the limits. If necessary, you can break down large exports into
smaller units by using the Aid4Mail filter feature.
2. Office Outlook PST file
Aid4Mail can create a new PST file and import your selected source mail into it or open an existing PST
file and append mail. Please make sure you have correctly configured an account in Outlook if you plan
to export your mail to the default account PST file.
When Aid4Mail has finished processing, you can open your PST file through the File/Open/Outlook Data
File menu command in Microsoft Outlook. With Outlook 2003 and 2007 you can store up to 20 GB of
data into a MAPI store (Unicode format), and up to 50 GB with Outlook 2010, 2013 and 2016. But with
older versions of Microsoft Outlook you cannot exceed 2 GB. The size limit may be set smaller through
registry settings (see this Microsoft Knowledge Base). If the PST file size limit is exceeded during
import, Aid4Mail returns an error message informing the MAPI store is full.
Note that if the target PST file exists and is open in Outlook while you are running Aid4Mail, then email
is added to the existing file instead of a new copy of the PST file when the "Append messages to target
mailbox file" option is unchecked.
3. Office Outlook MSG files
Use the MSG format if you prefer to save your messages in individual files. MSG files are displayed in an
Copyright 2005-2016 Fookes Holding Ltd

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.

Issues with dates and contact names in the Folder Pane


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.
2.3.7.2

Other mail clients


A generic mailbox is a file that contains email messages that are stored in a non-proprietary format. The
file format complies with the mbox standard, which most mail clients can read or import.
IMPORTANT: Please make sure you have correctly configured an account in your target mail client
program before migrating your messages.
1. Mozilla-compatible mailboxes (Thunderbird, SeaMonkey Mail, Mozilla Mail, and Eudora
OSE)
Use this format if you want to import your mail into one of the Mozilla mail clients: Thunderbird,
SeaMonkey Mail, Mozilla Mail, and Eudora OSE. The Mozilla format is very similar to the mbox format.
The main difference is in the way status information (unread, read, replied, etc.) is stored in the message
header. Mozilla defines its own system for managing status details and stores them in fields that are
different from standard mbox files.
You should avoid appending your source mail to mailboxes that are in use. Instead save it under a new
subfolder or in a new mailbox file. If you save the target files in the active mail folders of Thunderbird,
SeaMonkey Mail, Mozilla Mail, and Eudora OSE, you must restart the mail client to see them listed in
the Folder window.

2. PocoMail & Barca compatible mailboxes


Choose this format if you want to import your message into PocoMail or Barca. The mailbox files are
saved with the .mbx extension. PocoMail/Barca will automatically create the corresponding index files
(*.idx) when it finds the new files. Note that PocoMail and Barca may fail to correctly interpret some
exported messages flags; the Replied, Forwarded, and Bounced flags show up as a Read icon.
You should avoid appending your source mail to mailboxes that are in use. Instead save it under a new
subfolder or in a new mailbox file. If you save the target files in the PocoMail or Barca folder, you must
restart the program to see them listed in the Mailboxes window.

3. Windows Live Mail


Before exporting messages to Windows Live Mail (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. Aid4Mail automatically suggests the appropriate
default mail folder, if it exists. If you type a new subfolder, Aid4Mail will automatically create it before
Copyright 2005-2016 Fookes Holding Ltd

65

Aid4Mail 4 Help

exporting your messages.


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.
Note that the current version of Aid4Mail cannot change email status information (unread, read, replied,
etc.) on messages exported to WLM. As a result, all these messages are listed as unread.

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

Export email to remote server


Aid4Mail can download and upload email from and to a remote mail server using the IMAP protocol.
Works with popular services like Yahoo! Mail, Gmail, Zoho Mail, FastMail, and GMX Mail. See the IMAP
Settings topic for details.

2.3.7.4

Generic mail formats


An EML file contains a single email message stored in a non-proprietary format that conforms to the
RFC-2822 text format. Many email programs can handle and display EML files, including Mozilla
Thunderbird, Windows Live Mail, and Outlook Express.
A generic mailbox is a file that contains one or more email messages stored sequentially in a nonproprietary format which complies with the mbox standard. Aid4Mail creates mbox files that conform to
the mboxrd format. Many email programs can import messages from mbox files. You should avoid
appending your source mail to mailboxes that are in use. Instead save it under a new subfolder or in a
new mailbox file.

2.3.7.4.1 Outlook Express

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

Extract message contents only


1. Extract attached files
Choose this option to extract all the attachments contained in the messages processed by Aid4Mail.
Embedded files (typically pictures inserted in a message) are not extracted with this option. Extracted
attachments have a date stamp that matches the message date based on your local time (unless you
use the /TimeZone command-line switch). After processing, Aid4Mail creates a tab-delimited file in the
target folder called Attach.tab. This file makes it easy to identify which message an attachment belongs
to. You can open Attach.tab in a text editor, a spreadsheet program like Microsoft Excel, or import it
into a database program.
Attachments from a Macintosh mail client often come in pairs, with one part containing the actual file
and the other a resource document called a "resource fork". Aid4Mail only extracts the data file part and
ignores the resource document since it serves no purpose on Windows and UNIX/Linux platforms.
Note that Ai4Mail currently cannot create Unicode file names. If an attachment name has Unicode
characters, Aid4Mail will try to convert them to their equivalent ANSI character, if available, or substitute
them before saving the file to disk.
2. Extract email attachments and inserted files
Choose this option to extract all attachments and embedded contentscontained in the messages
processed by Aid4Mail. Extracted files have a date stamp that matches the message date. Extracted
attachments are saved in the Attach subfolder and embedded contents in the Embedded subfolder. After
processing, Aid4Mail creates a tab-delimited file in the target folder called Attach.tab. This file makes it
easy to identify which message an extracted file belongs to. You can open Attach.tab in a text editor, a
spreadsheet program like Microsoft Excel, or import it into a database program.
Attachments from a Macintosh mail client often come in pairs, with one part containing the actual file
and the other a resource document called a "resource fork". Aid4Mail only extracts the data file part and
ignores the resource document since it serves no purpose on Windows and UNIX/Linux platforms.
Note that Ai4Mail currently cannot create Unicode file names. If an attachment name has Unicode
characters, Aid4Mail will try to convert them to their equivalent ANSI character, if available, or substitute
them before saving the file to disk.
3. Extract email addresses of recipients
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 choose the most appropriate output format on the next screen:
comma separated values (*.csv), tab separated values (*.tab), and plain-text values (*.txt).

2.3.7.6

MHT Web Archive files


This section offers formats that enable you to display messages without using an mail client. This
feature is invaluable if you need an easy way to share important mail with customers or to display
messages to an audience. Note that this format is not available in Aid4Mail Home.
Email messages are stored in MHT files that can be viewed in Internet Explorer or any other compatible

Copyright 2005-2016 Fookes Holding Ltd

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.

1. MHT message files for viewing from Web browser


When you select this format, Aid4Mail saves your messages into MHT files and creates an index file in
HTML format for viewing in your web browser. After processing, you can burn the contents of the target
folder onto a CD-ROM. Next time you insert your CD-ROM into a computer drive, Internet Explorer will
start up automatically and display the index file for your saved mail. The format of the index page is
based on templates (*.html, *.css) that are stored in the Template subfolder under the Aid4Mail program
folder. If you are familiar with HTML code, you can edit these templates to modify the default layout.
2. MHT message files for viewing from Office Excel
Use this option to create an index file for viewing in Excel 2002, 2003, 2007, 2010, 2013 and 2016. Each
message folder or mail file is placed on a separate worksheet tab. Excel does impose some limits that
you may need to take into account before you select your mail source. Each worksheet can only store a
maximum of 65,536 emails and its name cannot exceed 31 characters. The format of the index page is
based on templates (*.xls) that are stored in the Template subfolder under the Aid4Mail program folder. If
you are familiar with XML code, you can edit these templates to modify the default layout.
Note that there is a bug in Internet Explorer 8 that causes failure to display linked email messages if
there is a space in the file path. If you experience this issue, simply copy your exported folder to a
location that has no blank characters in the path name.
3. MHT message files for importing into a database
Select this format to export your mail details into a tab-delimited file, which most database programs
can read. Mail details that are saved into this file include the mailbox name, message date, priority,
status, size, sender address, subject, recipient addresses, attachment names, and a link to the
corresponding MHT message file. The format of the tab-delimited file is based on the database.tab
template that is stored in the Template subfolder under the Aid4Mail program folder. If necessary, you
can edit this template in a text editor to modify the choice of fields and their sequential order. The first
line in the template represents the field names.
2.3.7.7

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

Custom formats using scripts


For the ultimate control over email export and data extraction, you can create Output Scripts that can
access any part of the email message being processed. For example, you could create a script that
generates statistics on information contained in the source emails. Or produce custom export formats
like the XML and CSV scripts included with Aid4Mail.
Output scripts are files with the .s4o extension. Any such file placed in the Scripts subfolder of the
Aid4Mail program or AppData folder will be listed under the "Custom formats using scripts" section on
the Target Format screen. A right-click on a script name opens a shortcut menu with commands to
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 Output scripts that you can experiment with and use as the basis for a
new script.

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

Copyright 2005-2016 Fookes Holding Ltd

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

9. Target MAPI Folder


Select the MAPI folder that should receive the exported mail. If you do not see folder names listed in this
screen, this could be due to one of the following reasons...
1.

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

2.3.10 10. Target IMAP Folder


Select the IMAP folder that should receive the exported mail. This screen is empty if Aid4Mail was not
able to connect to the remote mail server using the IMAP protocol. See the IMAP Settings topic for more
details.
Processing mail from an IMAP server is considerably slower that processing mail on a local disk drive,
and uploading usually is slower than downloading. If you have a large volume of mail to upload, 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.
Beware! Gmail enforces daily bandwidth limits. As of this writing, you can upload up to 500 MB of email
per day.

2.3.11 11. Export Options


The export options available to you depend on the selected target format. Options that are not available
are grayed-out and cannot be changed. The options for address exporting are different from those for
other target formats and are explained further down.

Standard Export Options


1. Export Format
1.1 Preserve full message
Select this option to export the complete email message, including its attachments and embedded
contents.
1.2 Only keep rich content (attachments are removed)
Use this option if you do not want to keep attachments in the target format. Embedded contents like
pictures are preserved. This option is useful if you want to reduce the size of your target files.
1.3 Only keep plain text message
Select this option to discard all attachments, embedded contents, and rich text formatting. Only plain
text is preserved. Email headers are also simplified to preserve only the most important fields (like
subject, date, sender, and recipients). Aid4Mail takes care of converting HTML messages into plain text
so that no important information is lost. This option can significantly reduce the size of your target files.
Use the "Convert UTF-8 to ANSI" setting to define how messages based on the UTF-8 character set
should be processed. When the box is checked, UTF-8 characters are converted to plain ANSI
characters based on the default Windows character set. When unchecked, UTF-8 characters 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 leave this option unchecked.
2. Export Options
2.1 Restore source folder structure
When this option is set, Aid4Mail attempts to restore the original folder structure in the target format.
When you export MAPI folders, Aid4Mail creates corresponding disk folders that contain the messages
and subfolders matching the original structure. If this option is unchecked, all messages are saved under
Copyright 2005-2016 Fookes Holding Ltd

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.

Address Export Options


1. Comma separated values
Use this format if you plan to import your data into the address book of a mail client. By default, the file
produced has a .csv extension. It contains two comma-separated columns of data, the first for the user
name (when available) and the second for the user email address.
2. Tab separated values
This format is similar to the comma separated values option. Values are separated by tab characters
instead of commas. By default, the file produced has a .tab extension. This format is ideal for importing
addresses into a spreadsheet or database program.
3. Plain-text values
Select this option if you want to create a mailing list. Data is stored in plain-text format with one address
per line. The addresses are formatted just as you would use them in a mail client (e.g. "User Name"
<name@domain.com>)

2.3.12 12. Start Processing Mail


This screen shows you the main processing settings you have selected. In most cases, you will have to
close your mail client before clicking on the Start button (this is not necessary with Office Outlook
though). Once you click on the Start button, Aid4Mail starts reading your source mail and processes it
to the output format. The main window is updated as each item is processed. If the Launch box is
checked and at least one mail was processed, Aid4Mail will open Windows Explorer, Internet Explorer,
or MS Excel to show the newly created output files. If you want to start alternative applications, you will
have to edit the Aid4Mail.ini file which is saved under the Applications Data folder. The path of the
Aid4Mail.ini is usually similar to the following (change {User} with the appropriate user name):
under Windows 10, 8, 7 or Vista:
c:\Users\{User}\AppData\Roaming\Aid4Mail\Aid4Mail.ini

under Windows XP:


c:\Documents and Settings\{User}\Application Data\Aid4Mail\Aid4Mail.ini

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

Copyright 2005-2016 Fookes Holding Ltd

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.

2.3.13 Other Screens


2.3.13.1 Trial Mode
This screen is only displayed when Aid4Mail is running in trial mode. It usually shows up when you start
Aid4Mail. There is an 8 second delay before you can continue to the main screen. You can click on the
Buy Now button to connect to the Aid4Mail order page on the web and purchase an activation code.
Once you have an activation code, click on the Activate button to enter it and remove the trial mode.
When Aid4Mail is operating in Trial mode, it offers all the features corresponding to the selected edition.
See the Trial Mode topic for options and details about the limitations.
Copyright 2005-2016 Fookes Holding Ltd

Reference Information

76

2.3.13.2 News and Updates


This screen is available through the Check News & Get Updates command in drop-down menu
displayed after clicking on the Software button. Use it to check the internet for news and software
updates from Fookes Software. News items are organized by category. A single mouse click on a news
item will display the corresponding web page in your browser or starts a file download. Icons are
displayed next to news items and have the following meaning:
The news
The news
The news
The news
The news

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

Software Button Menu


This drop-down menu offers commands to check for software updates, visit the Aid4Mail website, get
information about ordering an Aid4Mail license, commands to activate Aid4Mail, Notification Options,
IMAP options and Advanced Options.

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

Copyright 2005-2016 Fookes Holding Ltd

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

Copyright 2005-2016 Fookes Holding Ltd

Reference Information

78

them in a secure location.

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.

Copyright 2005-2016 Fookes Holding Ltd

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.

Use MAPI RFC 1521 Converter


With Outlook 2003 and more recent versions, 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 often 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 turn off this option if you are encountering conversion issues with it
or if processing speed is critical. This option is turned on by default when you start Aid4Mail. You can
also control this option through the command line with the /MapiConvOff switch.
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.
Fix MAPI Header Errors
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. This option is turned on by
default when you start Aid4Mail. You can also control this option through the command line with the /
MapiFixOff switch.
Use MAPI TNEF Converter
Prior to Aid4Mail v2.1, both TNEF and regular emails were processed by the MAPI RFC 1521 Converter
when the option was set. 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,
turn this option off to use Aid4Mail's own converter whenever a TNEF email is encountered. You can also
set this option through the command line with the /UseMapiTnefConverter switch.
Note that turning on this option as well as "Save TNEF as Winmail.dat Attachments" restores the default
behavior prior to Aid4Mail 2.1.
Save TNEF as Winmail.dat Attachments
When "Use MAPI TNEF Converter" is turned on, use this option to save TNEF data in a winmail.dat
attachment when converting mail to the RFC 1521 format. Turn this option off if you do not wish to create
winmail.dat attachments. You can also set this option through the command line with the /
AddWinmailDat switch.

Fast Mail Processing (less safe)


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
Copyright 2005-2016 Fookes Holding Ltd

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.

Warn When Skipping Invalid File Format


Turn this option on to display invalid file format warnings in the Aid4Mail progress screen.

2.5

GUI Command-Line Switches


The GUI version of Aid4Mail (i.e. not the console) supports several command-line switches that you can
use to alter some of its default features. You can specify several switches in the command line as long
as each one is separated by a space. You can either use a forward slash (/) or a hyphen (-) to mark the
start of a switch. If you need more control over operations through the command-line, please consider
using Aid4Mail Console.
There are two main ways you can run Aid4Mail with one or more command-line switches. Either launch
Aid4Mail from the Windows cmd.exe command-line prompt. Example:
Aid4Mail.exe /Switch1 /Switch2

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

Aid4Mail normally automatically detects when an accessibility feature is


running, like a screen reader or High Contrast display mode, and sets itself in a
mode that improves compatibility. Use this switch to override this detection and
turn accessibility mode on or off depending on switch value.

Copyright 2005-2016 Fookes Holding Ltd

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

See the Error Log File topic for details.

/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

Resets all the Aid4Mail program settings to their default values.

/RESETWND

Resets the Aid4Mail window position at startup.

/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.

Writing Aid4Mail Scripts


In creating this new scripting language, our aim is to make it as simple to learn and use as possible. We
believe the learning curve is less steep than other scripting languages and better suited for processing
mail data. Although the syntax is relatively basic and lacks features available in other scripting
languages, it provides a tremendous amount of power and flexibility.

Type of Scripts

Copyright 2005-2016 Fookes Holding Ltd

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.

Copyright 2005-2016 Fookes Holding Ltd

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])

Examples of accepted variations using the String.Extract function:


String.Exists("charm"; "Hello from 1637 Charmey")
String.Extract("[0-9]+"; "Hello from 1637 Charmey"; "R")
String.Extract("from ([0-9]+)"; "Hello from 1637 Charmey"; "R"; "$1")

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.

Copyright 2005-2016 Fookes Holding Ltd

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.

Trial Mode Limitations


The Message.SetHeader function and Mime object are not available during trial mode. They will throw a
"error 1014 - unsupported feature error" message if you use them in that mode.

2.6.1

Aid4Mail Script Syntax


Strings are automatically converted to UTF-8 if they are different from the system character set. If
Charset=UTF-8 then system character sets are also converted to UTF-8.
[Script.Info]
Title=Unpurged to EMLs
Summary=Export unpurged mail as individual EML files
Type=Input|Output|Filter|Plain
Version=1.0
CharSet=UTF-8|System|Western
Author=Fookes Software Ltd
Copyright=Copyright (c) 2014 Fookes Software
Contact=support@fookes.com
Website=www.aid4mail.com
Compatible=1.0
Requirements=Trial|Activated|eDiscovery|GUI|Console
;This is a comment
[Script.GUI.Enable]
TargetSettingsScreen=False
ExportOptionsScreen
TargetFolder
TargetFileName
TargetLineFormat
ExportOptions
TargetMailFormat
TargetAddressFormat
RestoreHierarchy
ExtractContents
AppendMessages
SkipDuplicates
UseHashNames
[Script.Code]
[Template=]

Copyright 2005-2016 Fookes Holding Ltd

87

Aid4Mail 4 Help

Events and Scope:


::OnStart
::OnNewFolder
::OnNewMessage
::OnFinish
Insert code:
![FileName]
Variables:
%Variable
%Array.Variable // special variable for handling arrays
%Stats.Variable // special variable for handling string-counter array
%Real.Variable // special variable for handling string arrays associated with decimal
numbers
%Sigs.Variable // special array variable for handling hash data [ <-- only in Aid4Mail
eDiscovery]
%Template.Variable // special variable containing template data
%XML.Variable // special variable for handling XML data
%%Array // shorthand for array variable
#Template // shorthand for template variable
Predefined Variables:
%CR (Carriage Return)
%LF (Line Feed)
%LB = CRLF (Line Break)
%CRLF
%FF (Form Feed = page break)
%Tab
%DQ = " (double quote)
%CB (Column break)
%OH (Optional hyphen)
%NBH (Non-breaking hyphen)
%NBS (non-breaking space)

: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:

Copyright 2005-2016 Fookes Holding Ltd

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)

Copyright 2005-2016 Fookes Holding Ltd

Reference Information

90

File.UnZip(ZipFile; TargetFolder[; Specs])


File.Zip(ZipFile; FileName; Data)
File.Zip(ZipFile; Specs[; Options]) // Options = Subfolders
FileName.ChangeExtension(FileName; NewExt)
FileName.Clean(FileName)
FileName.Expand(FileName) // "%Documents%\Export\" -> "c:\Documents and
Settings\John\My Documents\Export\"; tokens: %Pictures%, %Documents%, %Desktop%, %
ProgramData%, %AppData%, %IniFolder%, %TempFolder%, %SharedDocuments%, %SharedDesktop
%, %SharedData%, %ExeFolder%, %UsbDrv%, %ExeDrv%
FileName.Expand(FolderName; FileName) // FileName.Expand(%MyDocs%; "Doc.txt") -> c:
\Documents and Settings\John\My Documents\Doc.txt
FileName.GetExtension(FileName)
FileName.GetLongName(ShortFileName)
FileName.GetName(FileName)
FileName.GetPath(FileName)
FileName.GetShortName(LongFileName)
Folder.Copy(Source; Target[; Options]) // Options = SkipIfExists
Folder.Create(Folder)
Folder.Delete(Folder) // Only deletes folders under MyDocuments and Temp folders
Folder.Exists(Folder)
Folder.IsEmpty(Folder)
FolderName.Append(Folder; Subfolder)
FolderName.Clean(Folder)
FolderName.GetName(Folder) // "%MyDocs%\Export\" -> "Export"
FolderName.GetParent(Folder) // "%MyDocs%\Export\" -> "c:\Documents and
Settings\Eric\My Documents\"
FolderName.GetRelativePath(BaseFolder; DestFolder)
FormatDateTime(DateTime; Format);
GetDateTime[("UTC")]
GetUserValue(Question[; DefaultValue])
GoTo(Label)
GoToIf(Condition; LabelIfTrue[; LabelIfFalse]) // Condition Operators: =, <> or !=, <,
>, <=, >=
GoToIfError(Label)
GoToIfFalse(Condition; Label)
Increment(Number[; Count])
Increment(Array; Item)
IsEmpty(Variable)
IsFalse(Condition)
IsNotEmpty(Variable)
IsNumber(Variable)
IsString(Variable)
IsTrue(Condition)
Message.Export(FileName[; Format; Options]) // Format = EML, MHT, msg, mbox, Mozilla,
Contents, Addresses; Options = Full, Extract, Rich, Plain
Message.Extract(TargetFolder[; Specs; Options]) // Specs = *.eml; Options =
Attachments, Embedded, All
Message.FileName
Message.GetAddress(Field[; Part; Delim]) // Field = Who, From, To, Cc, Bcc, Sender,
Reply-To, Resent-From, Resent-Sender, Resent-To, Resent-Cc, Resent-Bcc; Part = All,
AddrSpec, DisplayName

Copyright 2005-2016 Fookes Holding Ltd

91

Aid4Mail 4 Help

Message.GetBody[(Part; Options)] // Part = Display, Text, Html, Rich; Options =


Decoded, Raw, PlainText
Message.GetDate[(DateField; Format; TimeZone)] // DateField = Display,Sent,Received,
Stored; Format = binary or yyyy/mm/dd; TimeZone = Local,System,UTC
Message.GetEmlName[(Options)] // Options = Subject, MD5
Message.GetFileNames[(Specs; Options; Delim)] // Options = Attachments, Embedded, All
Message.GetFlags //N R A F D M T E U O I (New, Read, Answered, Forwarded, Deleted,
Marked, aTtachments, Email, Usenet, Outgoing, Incoming)
Message.GetFolder[(Options)] // Options = Mailbox, Source
Message.GetFolderFlags // I O D T U (Incoming, Outgoing, Drafts, Trash/junk, Unknown)
Message.GetHeader[(Field; Options)] // Field = All, FromDelimiter, Subject, MessageId, ...; Options = Decoded, Raw
Message.GetMailboxName
Message.GetRaw[(Options)] // Options = Full, Extract, Rich, Plain
Message.GetSize
Message.IsDateInRange(DateStart; DateEnd[; DateField]) // DateStart = yyyy-mm-dd
Message.IsOutgoing // message going out (not received)
Message.Priority // 0 = none, 1 = highest, 5 = lowest
Message.SetHeader(Name; Value)
Number.Abs(Variable)
Number.Div(Numerator; Denominator)
Number.Log(Variable) // returns the natural logarithm (Ln(e) = 1)
Number.LogN(Base; X) // LogN returns the log base Base of X
Number.Mod(Numerator; Denominator)
Number.Negate(Variable)
Number.Percentage(Numerator; Denominator)
Number.Power(Base; Exponent)
Number.Round(Variable[; Decimals])
Number.Sqrt(Variable)
Number.ToString(Variable[; Decimals; ThousandSeparator]) // ThousandSeparator can be
Boolean value (True/False) or a character (,')
Number.Trunc(Variable[; Decimals])
Print.Data(String)
Print.FontSetup[(Name; Size; Style; CharSet)] // Style = B,I,U,S
Print.PageSetup[(MarginLeft; MarginRight; MarginTop; MarginBottom; Orientation)] //
Margins in mm; Orientation = Portrait, Landscape
Print.PrinterSetup[(PrinterName)]
Print.TextFile(FileName)
Print.Title(String)
RefreshScreen
Return // Use in label section to return back to previous source section
RunConsole(Executable; Parameters[; StdInput]) [ <-- only in Aid4Mail eDiscovery]
RunShell(Command[; Options]) // Options = Wait
Settings.AppendMail
Settings.CurrentFolder // returns current folder path. Example: Inbox\Urgent\Today
Settings.ExtractContents
Settings.Filter
Settings.HashFileNames
Settings.ProgramParam(Switch)
Settings.ProgramTrialMode // True/False
Settings.ProgramType // Home, Professional, eDiscovery, Console
Settings.ProgramVersion //3000, 3010, ...

Copyright 2005-2016 Fookes Holding Ltd

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

Copyright 2005-2016 Fookes Holding Ltd

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

Copyright 2005-2016 Fookes Holding Ltd

Reference Information

94

ArcSinh: function, returns the inverse hyperbolic sine of a number


Cos: function, returns the cosine of the angle in radians
ArcCos: function, returns the inverse cosine of a number
Cosh: function, returns the hyperbolic cosine of an angle
ArcCosh: function, returns the inverse hyperbolic cosine of a number
Tan: function, returns the tangent of the angle
ArcTan: function, returns the arctangent of a number
Tanh: function, returns the hyperbolic tangent of an angle
ArcTanh: function, the inverse hyperbolic tangent of a number
CoTan: function, returns the cotangent of the angle
ArcCoTan: function, returns the inverse cotangent of a number
CoTanh: function, returns the hyperbolic cotangent of an angle
ArcCoTanh: function, the inverse hyperbolic cotangent of a number
Sec: function, returns the secant of an angle
ArcSec: function, returns the inverse secant of a number
Sech: function, returns the hyperbolic secant of an angle
ArcSech: function, returns the inverse hyperbolic secant of a number
Csc: function, returns the cosecant of an angle
ArcCsc: function, returns the inverse cosecant of a number
Csch: function, returns the hyperbolic cosecant of an angle
ArcCsch: function, returns the inverse hyperbolic secant of a number
Abs: function, returns an absolute value
Ln: function, returns the natural log of an expression
Lg: function, returns log base 10
Log: function, returns the log of expression for a specified base
Pi: function, returns 3.1415926535897932385
Exp: function, returns the exponential of an expression
!: function, returns factorial of an expression
^: function, raises expression to any power
ArcTan2 [Y, X: Double] function, calculates ArcTan(Y/X), and returns an angle in the correct quadrant.
The values of X and Y must be between 2^64 and 2^64. Inaddition, the value of X cant be 0. The return
value will fall in the range from -Pi to Pi radians.
Hypot [X, Y: Double] function, returns the length of the hypotenuse of a right triangle. Specify the lengths
of the sides adjacent to the right angle in X and Y. Hypot usesthe formula Sqrt(X**2 + Y**2)
RadToDeg function, converts radians to degrees

Copyright 2005-2016 Fookes Holding Ltd

95

Aid4Mail 4 Help

RadToGrad function, converts radians to grads


RadToCycle function, converts radians to cycles
DegToRad function, returns the value of a degree measurement expressed in radians
DegToGrad function, returns the value of a degree measurement expressed in grads
DegToCycle function, returns the value of a degree measurement expressed in cycles
GradToRad function, converts grad measurements to radians
GradToDeg function, converts grad measurements to degrees
GradToCycle function, converts grad measurements to cycles
CycleToRad function, converts an angle measurement from cycles to radians
CycleToDeg function, converts an angle measurement from cycles to degrees
CycleToGrad function, converts an angle measurement from cycles to grads.
LnXP1 function, returns the natural log of (X+1)
Log10 function, calculates log base 10
Log2 function, calculates log base 2
IntPower [Base: Double; Exponent: Integer] function, calculates the integral power of a base value
Power [Base: Double; Exponent: Double] function, Raises Base to any power
Ldexp [X: Double; P: Double] function, calculates X times (2 to the power of P)
Ceil function, rounds variables up toward positive infinity
Floor function, rounds variables toward negative infinity
Poly [X: Double; Coefficients(1)..Coefficients(N): Double] function, evaluates a uniform polynomial of one
variable at the value X
Mean [Data(1)..Data(N): Double] function, returns the average of all values in an array
Sum [Data(1)..Data(N): Double] function, returns the sum of the elements in an array
SumInt [Data(1)..Data(N): Integer] function, returns the sum of the elements in an integer array
SumOfSquares [Data(1)..Data(N): Double] function, returns the sum of the squared values from a data
array
MinValue [Data(1)..Data(N): Double] function, returns smallest signed value in an array
MinIntValue [Data(1)..Data(N): Integer] function, returns the smallest signed value in an integer array
Min [A,B: Double] function, returns the lesser of two numeric values
MaxValue [Data(1)..Data(N): Double] function, returns the largest signed value in an array
MaxIntValue [Data(1)..Data(N): Integer] function, returns the largest signed value in an integer array
Max [A,B: Double] function, returns the greater of two numeric values
StdDev [Data(1)..Data(N): Double] function, returns the sample standard deviation for elements in an
array
PopnStdDev [Data(1)..Data(N): Double] function, calculates the population standard deviation

Copyright 2005-2016 Fookes Holding Ltd

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]

Source [file name or specs, or "mapi", or "imap"]

Copyright 2005-2016 Fookes Holding Ltd

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

Target [file or folder name, or "mapi", or "imap"]


Optional name and/or folder for target mailbox file. This parameter must come second if used. If you do
not specify a name, the program will save the exported mail into the current folder, or the "My
Documents" folder if it is write protected. Use double quotes if Target contains spaces. Tokens and
system variables are supported. If you choose to export mail to the EML or MSG format, Target should
represent a folder. If you export to an mbox format, Target 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
through the /T_Profile switch.
Use the "imap" token to export your mail 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.
Use double quotes if it contains spaces. Example.
a4m.exe %Outlook%\Test.pst "imap:INBOX\Imports 2012\"

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

Copyright 2005-2016 Fookes Holding Ltd

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

Copyright 2005-2016 Fookes Holding Ltd

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 (/

Copyright 2005-2016 Fookes Holding Ltd

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"

To convert a date like 13:51 19/03/14, use:

Copyright 2005-2016 Fookes Holding Ltd

Reference Information

102

a4m.exe /TocDate="h:n d/m/yy"

/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

Copyright 2005-2016 Fookes Holding Ltd

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"

Copyright 2005-2016 Fookes Holding Ltd

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.

Filter emails by date


/dr=yyyy/mm/dd-yyyy/mm/dd
Defines a date range filter based on the email received date based on the moment it reaches your mail
server. With outgoing mail, the sent date is used instead of the received date.
Dates use the international yyyy/mm/dd format (4-digit year/2-digit month/2-digit 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 one end of the date-range spectrum.
In the following example, Aid4Mail will only process emails that were received during year 2009:

Copyright 2005-2016 Fookes Holding Ltd

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.

Filter emails by text


/include="Words list file name"
Filters mail by contents based on the words listed in the specified file. Aid4Mail loads the search criteria
from the specified file and checks each email for a match. Emails that do not contain any of the text
criteria in the list are skipped during processing. By default, Aid4Mail only searches the email header.
You can extend the search to the message text by using the /FilterScope switch described below. See
the Words List File topic to learn how to create such a file.
/exclude="Words list file name"
Filters mail by contents based on the words listed in the specified file. Aid4Mail loads the search criteria
from the specified file and checks each email for a match. Emails that contain any of the text criteria in
the list are skipped during processing. By default, Aid4Mail only searches the email header. You can
extend the search to the message text by using the /FilterScope switch described below. See the
Words List File topic to learn how to create such a file. You cannot use both the /Include and /Exclude
switches at the same time.
/FilterScope=all OR message OR header OR raw
Only use this switch if you have defined a Words List with the /Include or /Exclude parameters. The
FilterScope switch can have one of four values: "All", "Message", "Header" or "Raw". Use the "All" value
to search through both the email header and the message text, the "Message" value to search through
the subject line and message text, and "Header" to search through the email header only. Use "Raw" to
search through the whole email in MIME format; this option is useful if you want to search for specific
content types. When this switch is missing, only the email header is searched. Note that searching
through the message text can significantly slow down the filtering process.

Advanced filtering using scripts


/FilterScript="Script Name"
Loads and then runs the specified script file. The script name can either be a fully qualified file name or
Copyright 2005-2016 Fookes Holding Ltd

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.

Eliminate duplicate emails


/SkipAllDups
/SkipAllDups="Incremental Log File"
Skips duplicates of emails that have already been processed (across all folders). Note that checking for
duplicates with this option usually decreases processing speed and uses more system memory, though
the impact is usually minimal.
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 it is listed. Otherwise, unless it is blocked by other filter settings, the
email is processed and its reference is stored in the log file. This feature is useful for running incremental
email exports.
Note that a log file created with the /SkipAllDups option should not be used with the /SkipDups option.
Email references are not generated the same way between these options so duplicates would not be
identified.
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 only 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.
/SkipDups
/SkipDups="Incremental Log File"
Skips duplicates of emails that have already been transferred to the target mail folder. This switch is
ignored if /SkipAllDups is also used. Note that checking for duplicates with this option usually
decreases processing speed and uses more system memory, though the impact is usually minimal.
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 it is listed. Otherwise, unless it is blocked by other filter settings, the
email is processed and its reference is stored in the log file. This feature is useful for running incremental
email exports.
Note that a log file created with the /SkipDups option should not be used with the /SkipAllDups option.
Email references are not generated the same way between these options so duplicates would not be
identified.
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
Copyright 2005-2016 Fookes Holding Ltd

Reference Information

110

contain any data.


2.7.1.4

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

Copyright 2005-2016 Fookes Holding Ltd

111

Aid4Mail 4 Help

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.
/stop
Terminates program execution just before mail processing starts. This feature is useful to verify the
validity of settings without processing mail.
/temp="folder name"
By default, Aid4Mail stores temporary files in the Windows Temp folder under the logon user folder. Use
this switch to specify an alternative location for storing temporary files. The folder name can include
tokens and system variables; example: /temp=%AllUsersProfile%\Aid4Mail\Temp
/unattended
Runs Aid4Mail without user intervention when an error occurs. 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.

2.7.2

INI File Settings


Aid4Mail Console can retrieve setting values from an INI file instead of through the command line.
However, if a setting is specified through the command line, the corresponding setting in the INI file is
ignored. You can use the /INI command-line switch to specify which INI file to use. If this switch is not
used, Aid4Mail will look for the a4m.ini file in the same folder as the a4m.exe program file.
To make it easier for you to create the INI file, simply rename the a4m.txt file stored in your Aid4Mail
program folder to a4m.ini and open it in a text editor. Settings must be placed under the line with the
"[Settings]" header. You can comment out a setting by placing a semi-colon (;) in front of it. Example:
[Settings]
ErrorLog=%MyDocs%\Aid4Mail Errors.txt
IncludeAllItems=True
IncludeTrash=True
IncludeUnpurged=True
SkipDuplicates=none
; this line and the following is commented out
;TempFolder=C:\Temp\

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

Copyright 2005-2016 Fookes Holding Ltd

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

Copyright 2005-2016 Fookes Holding Ltd

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

you to enter in a separate dialog box.


IMAP accounts: if the SourcePassword setting and /S_PW switch are not used, Aid4Mail takes the
password from the source imap.ini file.
SourceUserName=Logon User name
Use this setting to specify the logon user name for the source IMAP account. The /S_UserId commandline switch overrides this setting. If the SourceUserName setting and /S_UserId switch are not used,
Aid4Mail takes the user name from the source imap.ini file.
SourceProfile=MAPI profile name
SourceProfile=IMAP INI file
If your source mail is defined by the "mapi" token, use this setting to specify a profile name for your
source MAPI account if it is different from your default profile name. The /S_Profile command-line switch
overrides this setting.
If your source mail is defined by the "imap" token, this setting 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. The /S_Profile command-line
switch overrides this setting.
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 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:
TocDate=h:n ampm m/d/yyyy

To convert a date like 13:51 19/03/14, use:


TocDate=h:n d/m/yy

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.

Copyright 2005-2016 Fookes Holding Ltd

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.

Copyright 2005-2016 Fookes Holding Ltd

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

Copyright 2005-2016 Fookes Holding Ltd

123

Aid4Mail 4 Help

FilterExclude=Words list file name


Use this setting to filter mail by contents. Aid4Mail loads the words list from the specified file and
searches each email for a match. Emails that contain any of the text criteria in the list are not
processed. By default, Aid4Mail only searches the email header. You can extend the search to the
message text by using the FilterScope setting described below. See the Words List File topic to learn
how to create such a file. You cannot use both the Include and Exclude settings at the same time. The /
FilterExclude and /FilterInclude command-line switches override this setting.
FilterInclude=Words list file name
Use this setting to filter mail by contents. Aid4Mail loads the words list from the specified file and
searches each email for a match. Emails that do not contain any of the text criteria in the list are not
processed. By default, Aid4Mail only searches the email header. You can extend the search to the
message text by using the FilterScope setting described below. See the Words List File topic to learn
how to create such a file. You cannot use both the Include and Exclude settings at the same time. The /
FilterExclude and /FilterInclude command-line switches override this setting.
FilterScope=All or Message or Header or Raw
Only use this setting if you have defined a Words List with the Include or Exclude setting. The
FilterScope setting can have one of three values: "All", "Message", "Header" or "Raw". Use the "All"
value to search through both the email header and the message text, the "Message" value to search
through the subject line and message text, and "Header" to search through the email header only. Use
"Raw" to search through the whole email in MIME format; this option is useful if you want to search for
specific content types. By default, only the email header is searched. Note that searching through the
message text can significantly slow down the filtering process. The /FilterScope command-line switch
overrides this setting.
FilterScript=Script Name
Use the FilterScript 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 about Filter Scripts. The /FilterScript command-line switch overrides this setting.
NoFilterLog=True or False
If you are going to process large amounts of emails, you can improve speed slightly by setting the
NoFilterLog to True. When true, Aid4Mail stops showing progress information on messages that are
skipped as a result of the Aid4Mail filter settings. The /NoFilterLog command-line switch overrides this
setting.
2.7.2.4

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

Converting Multiple Accounts with a CSV File


Aid4Mail Console version 4 introduces the use of CSV files to store migration/conversion settings. This
new CSV feature makes it easier to configure and process multiple mail accounts sequentially. Better
still, with our new Aid4Mail Console Launcher you can significantly speed up your migration by
processing multiple accounts concurrently.

1. How to create and populate a CSV file


CSV files can be created and edited in most spreadsheet programs, like Microsoft Excel, OpenOffice
Calc and Google Sheets. The first line in the CSV file must have the setting name for each column. It is
then followed by the settings for each mail account or set of files to migrate or convert. Each row in the
CSV file contains the settings for an individual migration/conversion session.
You will find a CSV template under the Samples subfolder in your Aid4Mail program folder, AccountsTemplate.csv, which lists all the available setting names. Those names are equivalent to those defined
under the INI File Settings section of this manual. And to help you get started, you can look at the
Office365-Migration.csv file, which provides an example with settings to perform a migration to Office
365 (note that most settings are imaginary).
When you create your own CSV file, you only need to include the settings that are required for your
migration/conversion job. If you are processing diverse types of mail accounts or files, you may need
columns that have values in some rows and are empty in others. This is okay and will not negatively
impact the migration/conversion. If you have a column in your CSV file that has no values, you can
remove it.

2. Encrypting sensitive information in your CSV file


If you need to share one or more CSV files with other people during a migration project, you may want to
protect sensitive data such as email account logon credentials. You can do this easily with Aid4Mail
Console. To encrypt all password columns in the CSV file, all you need to do is run the command-line
with the CSV file name and an encryption password. The password can be up to 16 characters long
(longer passwords will be truncated). Example:
a4m.exe /EncryptCsv="My CSV File.csv" /pw="My Password"

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:

Copyright 2005-2016 Fookes Holding Ltd

Reference Information

126

a4m.exe /EncryptCsv=Accounts.csv /pw="123456" /CsvColumns=IMAP-source:UserName,IMAPsource:Password,IMAP-target:UserName,IMAP-target:Password /TargetCsv=Accounts-Team01.


safe.csv

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.

3. How to invoke a CSV file from Aid4Mail Console


Aid4Mail Console version 4 offers several command-line switches and combinations of switches, which
let you control how it uses the data stored in your CSV file. These are explained below.

a) Minimal command-line using default unencrypted CSV file:


The most basic command-line requires just the /csv switch. It requires that your CSV file be called
Accounts.csv. It must be placed either in the Aid4Mail Console folder (%ExeFolder% token) or the
Aid4Mail AppData folder (%ProgramData% token). Because no password is specified, the CSV file
should not contain any encrypted columns. On execution, Aid4Mail will process each row sequentially
and in order, from the first line with data to the last. Example:
a4m.exe /csv

b) Minimal command-line using default encrypted CSV file:


If your CSV file has been encrypted with Aid4Mail, you must add the password switch (/pw) to the
command line. The password must match the one that was used to encrypt the data. The CSV file must
be called either Accounts.safe.csv or Accounts.csv. The rest of the requirements and behavior are
identical to the previous example.
a4m.exe /csv /pw="My Password"

c) Resume an incomplete migration:


If you have accounts that either failed or weren't processed during a previous migration based on a CSV

Copyright 2005-2016 Fookes Holding Ltd

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\"

e) Other command-line examples:


Migrates all the accounts listed in the Students.csv CSV file located under the C:\
\Documents\Migrations folder.
a4m.exe /csv="%Documents%\Migrations\Students.csv"

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

Copyright 2005-2016 Fookes Holding Ltd

Reference Information

2.7.4

128

Receive Email Notifications


Aid4Mail Console version 4 introduces email notifications. These 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's progress.
In order to work, Aid4Mail needs access to our server on the web (www.fookes.com) and you will have to
specify and 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.
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.

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.

3. How to Test the Notification Feature


Before relying on the email notification feature, we recommend that you run a test after you've opted-in.
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.
To trigger a test notification, simply run Aid4Mail Console with the following two command-line switches
(replacing "user@aid4mail.com" with your own address):
a4m.exe /Notify=user@aid4mail.com /NotifyCommand=test

4. How to Display Your Email Address Status in Aid4Mail Console

Copyright 2005-2016 Fookes Holding Ltd

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

Words List File


You can create a list of words stored in a file that Aid4Mail can use to search for matches in each
processed message. The list should contain one search criteria per line. The longer the list, the longer it
will take Aid4Mail to filter each email. You can improve performance by placing the most common
search terms at the beginning of the list.
Matching is case sensitive for lines that have one or more uppercase characters, and case insensitive for
lowercase search criteria. A match only occurs if the search criteria covers whole words. For example, if
your search criteria is "spam" (without the quotes), it will match the word "SPAM", but not "spammer".
The search criteria "FREE" will only match the word "FREE", but not "free" or "FREEWAY". The search
criteria "jane doe" will match "Jane Doe" and "JANE DOE", but not "Jane M. Doe".
You can negate the effect of a text criteria by starting it with a minus character (-). If you must start a
regular search criteria with a minus or hyphen character, just add a second one to cancel the negate
effect. A match with a negate criteria will reject a message if the "found in header" option is set, and will
accept the message if the "not found in header" option is set.
You can start a text criteria with a plus character (+) to instruct Aid4Mail to combine it with the previous
criteria. If you must start a regular search criteria with a plus character, just add a second one to cancel
the addition effect. If the "found in header" option is set, the message is only accepted if it contains
occurrences of the preceding and current criteria. If the "not found in header" option is set, the message
is only rejected if it contains occurrences of both the preceding and current criteria. Note that the plus
character is ignored if it follows a negate criteria. See example #3 below.
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. 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&iuml;ve", and "na&#239;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",

Copyright 2005-2016 Fookes Holding Ltd

Reference Information

130

"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&eacute;", and "caf&#233;".
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=

produces a normal search


produces a wildcard search
produces a regular-expression search

Words list example #1:


-spam@fookes.com
@fookes.com
Aid4Mail will accept all messages that have an "@fookes.com" address except those that have the
address "spam@fookes.com". Other messages that do not have "@fookes.com" are rejected. The order
of the text search criteria is important here. If "@fookes.com" is placed before "-spam@fookes.com",
then the negate criteria never gets tested because the message is already accepted because "@fookes.
com" is found.

Words list example #2:


FREE
mortgage~
home owner~
pharma*
pill~
prescr?pt??n~
spam@fookes.com
@adpromailer.com
@emailfactory
R=free (bonus|debt|loan|money)
R=c(i|1)(a|@)l(i|1)s
R=v(i|1)(a|@)gr(a|@)
R=x(a|@)n(a|@)x
Aid4Mail will reject all messages that have any of the listed search criteria. The above list includes
criteria with wildcards and regular expression patterns.
Words list example #3:
important@fookes.com
+aid4mail
Copyright 2005-2016 Fookes Holding Ltd

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

Processing a List of Files


Aid4Mail Console can process file lists, which you can specify instead of a source mailbox file. File lists
are plain text files that must have the .lst extension. Each line should represent a file name or file search
criteria. A file list must only contain one type of mail file to process; in other words, you cannot mix
Eudora and Mozilla mailbox files in a single list.
Tokens and system variables are supported in the path name and you can use wildcards "*" and "?" in
the file names. You will find details about the tokens and system variables under the topic Useful Tokens
and System Variables. You can instruct Aid4Mail to search subfolders for the specified criteria by
beginning the line with a "+" sign.
File List Example:
%Thunderbird%\Local Folders\Orders Paid.msf
+%Thunderbird%\Local Folders\Test.sbd\*.msf
The above lines show two source criteria. The first instructs Aid4Mail to process the "Orders Paid"
Thunderbird mailbox. The %Thunderbird% token tells Aid4Mail to substitute it with the Thunderbird mail
storage path. The second line instructs Aid4Mail to process all mailbox files in and under the Test
mailbox folder.
The name of the file list is used in place of the source mailbox name. It is the first parameter in the
Aid4Mail Console command line. Example:
a4m.exe c:\Test\Files.lst %Outlook%\Test.pst

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)

Copyright 2005-2016 Fookes Holding Ltd

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

the "OE Mail.pst" file on PC2.

2. Thunderbird to Outlook or Exchange


a4m.exe %Thunderbird%\*.* mapi /m=moz

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.

3. Outlook or Exchange to Thunderbird


a4m.exe mapi %Thunderbird% /moz

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.

4. Converting between Outlook/Exchange and mbox


a4m.exe mapi /mbox /a

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

a4m.exe "T:\Thumbdrive Data\Outlook.pst" "%Documents%\Imported Mail\*.mbx" /mbox

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).

5. Converting between Outlook/Exchange and EML


a4m.exe "T:\Thumbdrive Data\*.eml" mapi /b="Imported Mail"

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

Attach and Embedded subfolders respectively.

6. Converting from Outlook/Exchange to Outlook/Exchange


a4m.exe %Outlook%\Backup_2012.pst "mapi:Backups\2012" /T_Profile="John Doe"

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.

7. Migrating between IMAP and PST


a4m.exe imap mapi /b="Imported Mail"

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.

8. Migrating between two IMAP accounts


a4m.exe imap:Inbox\ imap:Inbox\Exports\

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.

Copyright 2005-2016 Fookes Holding Ltd

137

Aid4Mail 4 Help

a4m.exe mapi "T:\Thumbdrive Data\Mail.txt" /t /ExtractAll

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.

10. Merging mail


a4m.exe "%Documents%\Mail Archives\*.mbox" "T:\Thumbdrive Data\All Mail.mbox" /t

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.

11. Filtering messages

a4m.exe mapi "%Documents%\VIP Mail\April 2012\*.msg" /dr=2012/04/01-2012/04/30 /Include="VIP Email

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.

a4m.exe "%Thunderbird%\*.*" "%Documents%\Mail\*.eml" /m=moz /FilterScript="Has jpg mov avi" /Extra

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.

12. Other examples


a4m.exe "%Thunderbird%\*.*" "%Documents%\Mail Archives\" /m=moz /eml

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.

Copyright 2005-2016 Fookes Holding Ltd

Reference Information

2.8

138

Aid4Mail Console Launcher


Aid4Mail version 4 introduces a new utility called Aid4Mail Console Launcher. It is designed to work
with Aid4Mail Console and the new CSV feature. Note that it is only intended for clients with a valid
Aid4Mail Console license.
Aid4Mail Console Launcher is designed to significantly speed up large-scale migrations and
conversions. It takes advantage of the multithreading capabilities of your processor and lets you run
multiple migrations concurrently. Under optimal conditions, it can cut down processing time by a factor
of 5 or more (performance will depend heavily on the quality of your processor and your bandwidth). So,
for example, a large-scale email migration may be completed in less than a day instead of five days.
With Aid4Mail Console Launcher, you can:
Schedule your migration.
Choose how many concurrent migration/conversion sessions you want to run.
Monitor the progress of each running session and view live processing notifications.
List failed sessions, correct mistakes in the settings, and resume the migration.
Receive email notifications when your migration starts, when a session fails and when all accounts
have been migrated.
If you have the full installation, you will find the Aid4Mail Console Launcher in the Aid4Mail program
folder under the name a4m-launcher.exe. We have designed the program to be intuitive and selfexplanatory. However, should you need any assistance with using the Aid4Mail Console Launcher,
please do not hesitate to contact us.
Note that the optimal setting for the number of concurrent sessions will depend on the capabilities of
your processor. With a modern desktop processor, performance may drop when you exceed 6
concurrent sessions. If you are dealing with a large-scale migration, we recommend that you test a
variety of values to find the optimal number of concurrent sessions for your hardware and mail account
set up. You can define this value through the Settings dialog box, which opens when you click on the
Settings button.

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.

How to Use this Tool


You will need a CSV file with valid migration settings before you can run a migration with Aid4Mail
Console Launcher. Click on the Open button (or use the Ctrl+O keyboard shortcut) to select your CSV
file. If your CSV data is encrypted, you will be prompted for the password. Next, click the Start button to
begin your migration. You can monitor the progress of each migration by clicking on the Open Log
button. Use the Abort button to abort your migration.

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.

IMAP Settings Screen


Complete all the fields under Server Configuration required to connect to an IMAP account. Values are
automatically saved when you click on the "Next" button. Click on the "Save As" button to store settings
under new name. To delete settings, select a name from the Settings drop-down list and then press the
Delete key while the field has the focus.
Connection Security Options
None No security protocol is used for accessing the IMAP account.
Smart Aid4Mail automatically determines the most appropriate security setting.
STARTTLS Aid4Mail checks the server response to determine if a plain text connection needs to be
upgraded to an secure one.
SSL/TLS The SSL/TLS security protocol is used for accessing the IMAP account.
You should only fill-in the Namespace field if you need to access shared or public mail folders, or if
Aid4Mail is unable to correctly identify your private account top-level folder. The namespace for a shared
folder may be "shared" or "#shared" and the namespace for a public folder may be "public" or
"#public" (without the quotes). Contact your account administrator if you don't know the namespace for
the shared or public mail folders you need to access.

Copyright 2005-2016 Fookes Holding Ltd

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.

How to Deal with Failed Uploads


Aid4Mail offers several options to save locally emails and attachments that fail to upload to an IMAP
server. As a result, you preserve all the data that is rejected by the IMAP server. For example, if an
email exceeds IMAP size limits, Aid4Mail can remove its attachments, save them locally, and then try
uploading again. You will find the settings controlling this behavior in the IMAP Options submenu, which
is displayed when you click on the Software button in Aid4Mail.

Log IMAP Communications


You can create a log file storing all communications between Aid4Mail and an IMAP server by turning on
the Log IMAP Communications option available through the Software button menu. 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 enable this option through the
command line with the /ImapLog switch.

Fixing Folder Names with Invalid Characters


Some IMAP servers are fussy about which characters can be used in a folder name. If you try to migrate
a folder that has forbidden characters in the name, the target IMAP server will error. As a result, none of
the emails and subfolders contained in the source folder are migrated. You can solve this type of issue
by using a special template file called NameFilter.dat. Open the file NameFilter.txt for instructions and a
working example.

Recommended Settings for Popular IMAP Services


AIM.Mail (AOL Mail)
Although AIM.MAIL supports a multi-level folder structure through IMAP, this is not the case with the
web interface which only allows one level of folders and limits their length to 32 characters. Folder that
contain subfolders are not displayed in the web interface.
Server Name: imap.aim.com
Copyright 2005-2016 Fookes Holding Ltd

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

Copyright 2005-2016 Fookes Holding Ltd

Reference Information

142

Max. folder length: 30

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

Office 365 and Office 365 Education (formerly Live@edu)


The folder hierarchy displayed through the Office 365 interface is consistent with the folder hierarchy
available through the IMAP protocol.
Server Name: outlook.office365.com
Port: 993
Connection Security: SSL/TLS

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.

Copyright 2005-2016 Fookes Holding Ltd

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

Other IMAP Accounts


The above list only covers the most popular IMAP services currently available. If your service is not
listed, you will have to check its documentation or contact the help desk to determine the appropriate
settings. Supported IMAP servers include Courier, Cyrus, Dovecot, Zimbra, Microsoft Exchange, Novell
GroupWise, etc.

2.10

Fixing Attachment Folder References


Some email client programs like Eudora, Calypso, The Bat!, PocoMail, and Barca, extract attachments
from messages and store them in a separate folder. A reference to the disk file is then inserted in the
corresponding email to preserve the link between them. Unfortunately, email clients do not provide a
means to update this reference when the location of the attachment folder is changed. When the link is
broken, the message can no longer open the extracted contents.
Aid4Mail uses links stored in messages to find the corresponding attachments. If it cannot find the files
at the indicated location, Aid4Mail searches for the location relative to the mailbox file being processed.
When this fails, the extracted contents are lost during the conversion process. To avoid this, you can
define a configuration file to tell Aid4Mail where to look for extracted attachments. To do so, create an
INI file called Tokens.ini and save it in the Aid4Mail program folder or place it in the Aid4Mail folder
under Application Data. 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.
when using Tokens.ini, a log file is automatically created whenever attachments are not found. It stores
all the alternative search paths used by Aid4Mail to look for missing files. This can help you determine if
you have correctly configured Tokens.ini. The log file is called AttachmentsNotFound.log and is
Copyright 2005-2016 Fookes Holding Ltd

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:

Copyright 2005-2016 Fookes Holding Ltd

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

Useful Tokens and System Variables


Aid4Mail supports tokens that represent either fully qualified folder names, system variables, or userdefined strings. A token must be delimited with either a percent character (%) or a dollar sign ($). If you
are going to use tokens in a batch-file script, you must use the "$" character as a delimiter instead of
"%".
The following tokens are defined in Aid4Mail and recognized under all versions of Windows:
%AppData%
returns the Application Data folder of the logged on user
%SharedData%
returns the common Application Data folder shared by all users
%ExeFolder%
returns the folder of the Aid4Mail program file
%ExeDrv%
returns the drive of the Aid4Mail program file
%UsbDrv%
returns the USB drive letter (e.g., E:) if Aid4Mail is running with the USB option (see related /USB
command-line switch)
%ProgramData%
returns the folder used by Aid4Mail to store program settings
%TempFolder%
returns the Windows "Temp" folder or the user-defined Temp folder
%Desktop%
returns the Windows "Desktop" folder
%SharedDesktop%
returns the Windows "Public\Desktop" or "All Users\Desktop" folder shared by all users
%Documents%
returns the Windows "My Documents" folder
%SharedDocuments%
returns the Windows "Public\Documents" or "All Users\Documents" folder shared by all users
%Pictures%

Copyright 2005-2016 Fookes Holding Ltd

Reference Information

146

returns the Windows "My Pictures" folder

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

MIME Types and File Extensions


A MIME type is used to describe the message content and consists of a type and subtype; example:
image/jpeg. Most MIME types have one or more associated file extensions; for example, the .jpg, .
jpeg, .jpe extensions are associated with the image/jpeg MIME type. Aid4Mail uses this information
when it needs to determine what file extension to add to an extracted attachment, or what MIME type it
must assign to a file that it is inserting back into an email.
Aid4Mail uses two lists stored in plain-text files to determine the relation between MIME Types and File
Extensions: Mime-Ext.dat and Ext-Mime.dat. If necessary, these lists can be edited by advanced
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
custom versions of those two files 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
Note that 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.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.

Copyright 2005-2016 Fookes Holding Ltd

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

Australian Central Time


Australian Central Western Time
Australian Eastern Time
Australian Eastern Time
Alaska Time
Atlantic Time
Australian Western Time
Central European Time
Central Time
Eastern European Time

Copyright 2005-2016 Fookes Holding Ltd

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

Templates and Fields


Aid4Mail includes several templates that are used to create the target files for Internet Explorer,
Microsoft Excel, and database import. These are stored in the Template subfolder of the Aid4Mail
program folder. Advanced users can edit these to modify the format of the target files created by
Aid4Mail during mail conversion. If you plan to edit template files, make sure you keep a backup copy of
the original files. Also make sure you save backup copies of your modified templates before you install a
new Aid4Mail update, or your custom templates will be overwritten by the default Aid4Mail templates.
Note that 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.
IMPORTANT: Please note that Fookes Software does not provide support for custom templates. If you
choose to create or modify a template, you accept that you will receive no help from Fookes Software's
customer support service.
The following fields can be used in the Aid4Mail templates:
{attachment_count}
{attachment_names}
{attachments}
{date}
{display_date}
{mailbox}
{mailbox_file}
{message_file}
{message_id}
{message_name}
{Priority}
{recipient_bcc}
{recipient_cc}
{recipient_to}
{sender}
{sender_email}
{sender_name}
{size}
{size_kb}
{source_file}
{source_name}
{status}
{subject}

Copyright 2005-2016 Fookes Holding Ltd

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

Error Log File


Unfortunately, email conversions are not always perfect and errors can occur. These errors may result
from corrupted mail files, missing attachment files, or software bugs. Aid4Mail automatically stores error
messages resulting from email processing in a log file called ErrorLog.txt. By default, the Aid4Mail GUI
saves the file under the "Application Data\Aid4Mail" folder, whereas Aid4Mail Console saves it in the
program folder. Once email has been processed, Aid4Mail automatically opens the log file in the
associated application (e.g. Windows Notepad) if errors were encountered.
The log is a tab-delimited file with 5 columns of data. The first column shows the error message, the
second has the name of the file that is being processed, the third is the name of the mailbox, the fourth
has the date taken from the email header, and the fifth the email subject line. In some cases, the three
last columns may be empty if Aid4Mail wasn't able to retrieve the information before the error occurred.
You can view this file in a text editor or a spreadsheet program like MS Excel.
You can use the /ErrorLog command-line switch to define an alternative file name for the log file.
Aid4Mail recognizes "shorthand" tokens used in the path name; see the Useful Tokens and System
Variables topic for more details. The following example will create a log file called "Conversion Errors.txt"
that is saved in the Aid4Mail subfolder under the "My Documents" folder:
Aid4Mail.exe /ErrorLog="%MyDocs%\Aid4Mail\Conversion Errors.txt"

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

2.16.1 ANSI PST


ANSI PST files can be created and read by all versions of Office Outlook. They are typically used to
store mail, addresses, calendar items, and notes. Each file has a maximum storage capacity of 2 GB.
Outlook 2003 and 2007 can create Unicode PST files that have a maximum storage capacity of 20 GB,
but they cannot be opened in Outlook 97, 98, 2000, and 2002. The default Outlook 2010, 2013 and 2016
file size limit for Unicode PST is 50 GB. Note that the PST size limit may be set smaller through registry
settings (see this Microsoft Knowledge Base).

Copyright 2005-2016 Fookes Holding Ltd

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.5 Embedded contents


Embedded contents are very similar to attachments. However, unlike attachments, embedded contents
appear in the message itself if the mail client is capable of rendering them.

2.16.6 EML files


EML files are local email messages usually created by Outlook Express and stored on disk with the .
eml extension. These files can contain embedded content such as images and sound files.

2.16.7 Exchange mailbox


The delivery location for all incoming mail messages addressed to a designated owner. Information in a
user's mailbox is stored in the private information store on a Microsoft Exchange Server computer. A
mailbox can contain received messages, message attachments, folders, folder hierarchy, and more.
Server applications for Microsoft Exchange Server are often designed with a mailbox for communication.

2.16.8 Folder
See Message Folder and Mailbox.

2.16.9 Generic mailbox


A generic mailbox is a file that contains email messages that are stored in a non-proprietary format. All
messages in a generic mailbox are concatenated and stored as plain text. Each message 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, and space. The file format complies with the mbox
standard, which most mail clients can read or import.

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

Copyright 2005-2016 Fookes Holding Ltd

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.12 Information store


The default message store provider for Microsoft Exchange Server. The information store consists of
three implementations of MAPI message stores: the public information store, the private information
store, and the personal folder store (PST). The information store organization of public folders, private
folders, and messages is referred to as the organization hierarchy. Another implementation of a MAPI
message store is configured when a user works offline. It is called the offline folder store (OST) and
mirrors the structure of the mailbox while offline.

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.15 MAPI folder


A MAPI folder is a kind of message folder that groups related messages in an internal file structure such
as a PST file.

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.

Copyright 2005-2016 Fookes Holding Ltd

153

Aid4Mail 4 Help

2.16.17 MAPI store


A MAPI store can be an Exchange Server store or the PST (personal folders) file that is stored on a file
system like any other file.

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.19 Message folder


A message folder represents either a mailbox file (Outlook Express, Eudora, Mozilla), or a disk folder
(The Bat!), or an internal file structure (Office Outlook) that groups related messages together.

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.21 MHT files


MHT files are very similar to EML files. The main difference is that EML files are usually displayed in
Outlook Express (or any other compatible mail client) and MHT files in Internet Explorer (or any other
compatible web browser). Microsoft calls these files "Web archives."
A "Web archive" usually consist of a web page and its contents saved in Multipurpose Internet Mail
Extension HTML (MHTML) format with a .mht file extension. All relative links in the web page are
remapped and the embedded content is included in the .mht file, rather than being saved in a separate
folder. The absolute references or hyperlinks on the web page remain unchanged and the .mht file is
viewed using Internet Explorer.

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.25 Personal folder store (PST)


An information store at the client used to store an individual's personal folders if directed to do so by a
rule. PSTs are often used so that messages will be accessible while the user is offline.

2.16.26 Plain text


A document that contains nothing but the standard range of numbers, letters and punctuation included in
the ASCII character set. Plain text has no formatting code; so no type styles (e.g. bold and italic),
embedded images or charts, etc. On the Windows platform, plain text documents typically have file
names which end with the .txt extension. Plain text is the most portable format because it is supported
by nearly every application on every machine.

2.16.27 Private information store


The MAPI message store implementation (part of the Microsoft Exchange Server information store) that
stores mailboxes for users. While the public information store contains information to be shared between
users, the private information store contains information to be secured from other users.

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.29 Public information store


The MAPI message store implementation (part of the Microsoft Exchange Server information store) that
stores public folders. While the private information store contains information to be secured from other
users, the public information store contains information to be shared between users.

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.

2.16.31 Rich content


An email with rich content usually consists of a message with text in HTML or RTF format (rich text).
These messages often have embedded contents, like pictures, that are displayed in the message body.

Copyright 2005-2016 Fookes Holding Ltd

155

Aid4Mail 4 Help

2.16.32 Rich text


Also known as styled text. The result of adding information to plain text. Examples of information that
can be added include font data, color, formatting information, phonetic annotations, interlinear text, and
so on. The most common forms of rich text are HTML, RTF, ETF (Enriched Text Format), and SGML.
When everything except primary content is removed from rich text, only plain text should remain.
As of this writing, all mainstream mail clients support and produce rich text based on the HTML format.
Other rich-text formats, however, may not render correctly in modern mail clients.

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.34 Status Flags/Indicators


The symbols, icons, or text that is displayed in the message index grid which represent whether the
message has been unread, read, forwarded, redirected, priorities, and attachments. Not all email clients
and mailbox types display (support) all the different statuses, but most do. For instance, the Generic
(mbox, Unix) mailboxes do not support Redirect and Forward statuses, and Microsoft Outlook and
Outlook Express do not differentiate the high from highest and low from lowest priorities; they just show
high or low.

2.16.35 Styled Text


See Rich Text.

2.16.36 Thumb drive


A thumb drive, USB flash drive, USB key, USB pen, USB pen drive, memory stick, or flash memory key
are all synonyms for a portable memory storage which plugs into a computer's USB port.

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).

2.16.39 Unicode PST


Unicode PST files are a new storage format introduced by Outlook 2003. They are typically used to store
mail, addresses, calendar items, and notes. Under Outlook 2003 and 2007, each file has a maximum
storage capacity of 20 GB, which is 10 times more than ANSI PST files. The default Outlook 2010, 2013
and 2016 file size limit is 50 GB. Unlike ANSI PST files, they cannot be opened in Outlook 97, 98, 2000,
and 2002. Note that the PST size limit may be set smaller through registry settings (see this Microsoft
Knowledge Base).
Copyright 2005-2016 Fookes Holding Ltd

Reference Information

156

2.16.40 Unpurged mail


When you move a message from one folder to another in your email client, or delete a message, the
process is more complicated that it would initially seem. A copy of the message is placed in the
appropriate destination folder, but the original message is not removed immediately. Instead it is flagged
as "unpurged", and hidden from display, until such a time that the folder that contains it is compacted or
expunged.
The reason for this behavior is to optimize the move/delete process by not having to reorganize a
mailbox every time a message is removed from it. As mailboxes can become very large, and messages
can usually be moved around without limitation, this can provide a considerable time-saving. However it
also means that when you process a mailbox with Aid4Mail, the mailbox can potentially contain
unpurged messages.
As these messages are generally unwanted, they are automatically skipped by the Home and
Professional versions of Aid4Mail. The eDiscovery versions offer an option to process unpurged mail,
which is usually only required in a forensics context.

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.

Purchasing and License Agreement

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:

Copyright 2005-2016 Fookes Holding Ltd

157

Aid4Mail 4 Help

1. benefit from a big renewal discount


2. and continue using Aid4Mail without interruption.
Make sure you fill in the Subscription Reminders dialog box that pops up after your first successful
license activation. This will start the opt-in procedure. Within a few minutes you will receive an email
from Fookes Software. Use the link in it to confirm your subscription request.
If you choose not to fill in the Subscription Reminders dialog box, Aid4Mail will not prompt you again
during the validity period of your license.

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.

Copyright 2005-2016 Fookes Holding Ltd

Purchasing and License Agreement

3.6

158

End User License Agreement


AID4MAIL END USER LICENSE AGREEMENT
(Version: September 2016)
This End User License Agreement (this Agreement), governs the terms and conditions of the
Licensees access and use of Aid4Mail software (Aid4Mail), and is made between the Licensee (you)
and Fookes Software Ltd, La Petite Fin 27, 1637 Charmey, Switzerland (Fookes Software). However, if
you are using an Evaluation License as or on behalf of an entity, and/or have registered for any other
license as or on behalf of an entity, such as a corporation, partnership, limited liability company or other
entity, the term you used below refers to the entity which will be bound by this Agreement. You
represent and warrant that you have power and authority to enter into this Agreement on behalf of the
entity. This Agreement does not address any third-party or free or open source software separately
licensed to you.
By clicking the I accept the Agreement option during installation and/or by accepting the Agreement on
the online order form and/or by using Aid4Mail, you confirm your acceptance of, and agree to be bound
by, this Agreement. If you do not agree to this Agreement or if you do not understand it, do not
purchase, install, or use Aid4Mail.
In case you have another written agreement directly with Fookes Software, such written agreement
prevails in the event of any conflict with the terms and conditions of this Agreement.
1. Definitions.
Activation Code means a unique string of characters (for example PY-7XH4ESFNFJHW) that is entered
into a license activation dialog box. There are three types of activation codes: single-user codes (one
unique activation code per Seat), multi-user codes (one unique activation code for multiple Seats), and
temporary trial codes. An activation code ties a Seat to an operating system user logon account of the
computer (not a server) on which the Software is activated or re-activated.
CLI means a command line interface format (used in console editions).
GUI means a graphical user interface format.
Individual End User means one natural person, not an Organization.
Key File means a special file created by Fookes Software for a Licensee that contains information used
to unlock Software features when pre-defined conditions are met. A Key File is offered with certain
eDiscovery, console, and OEM editions of Aid4Mail.
Mail means email messages, email files, mailbox files, email folders, email profiles, email stores, and/
or email databases.
Mail Account means Mail stored from one or more related email addresses that are assigned to one
Individual End User for receiving, sending, and/or archiving email messages. Email addresses are related
in a Mail Account holding more than one email address if all addresses are connected to an Individual
End Users single email profile or, if there is no such profile, to the Individual End Users single email
client program.
Mail Migration means exporting Mail from one system to another, the latter system being used to
receive and/or send email messages.
Organization means any for-profit or non-profit sole proprietorship, unincorporated association, joint

Copyright 2005-2016 Fookes Holding Ltd

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.

Copyright 2005-2016 Fookes Holding Ltd

Purchasing and License Agreement

160

2.2.1. Activation Codes.


If you purchase and/or use an Activation Code, you agree to comply with the license activation and
verification procedure described in part in this section of the Agreement, and more fully on the Product
Activation page of the Aid4Mail website. The activation technology may prevent your use of the Software
if you do not follow the activation process described in the Software. Activation requires an internet
connection (unless you have purchased or received an offline option for activation).
An Activation Code may be moved from an old computer to a new one that replaces it, as long as such
Activation Code is not reused again on the old computer. Conditions for transferring an Activation Code
to another user depend on the type of license purchased (see License Types section).
Moving an Activation Code to another computer or user account requires license re-activation through an
Internet connection (unless you have an offline option for the new location). Our activation technology
allows a reasonable number of re-activations within a certain time period. If the number of re-activations
exceeds the re-activation quota, it locks out further re-activations until the lockout period expires.
The Subscription Period starts when the Activation Code is activated for the first time, or immediately
following a previous Subscription Period if it was renewed prior to termination, or on re-activation of the
code after the expiry of a previous Subscription Period.
2.2.2. Key Files.
A Key File is a special file that ties the Software to pre-determined hardware or bundled software. Trial
Mode is deactivated only if the data stored in the Key File matches the pre-determined hardware or
software. Furthermore, depending on the nature of the key, the Software may require a system clock set
to the correct date and/or access to a Fookes Software license validation server on the Internet. Failing
this, the license protection technology may prevent your use of the Software.
If a Subscription Period is defined in the Key File, it starts on the date that the Key File was created by
Fookes Software. If you obtained your copy from an OEM, your OEM will inform you of the Subscription
Period.
2.4. License Types.
The specific license type is specified on the receipt for the Software license that you purchased from
Fookes Software, a reseller or original equipment manufacturer (OEM). Each of the following licenses is
subject to your compliance with the terms and conditions of this Agreement, including payment.
2.4.1. Aid4Mail Home Personal.
Fookes Software hereby grants you the right and license, during the applicable Subscription Period, to
Use the Software exclusively to process non-Professional Mail belonging to one Individual End User.
An Activation Code may be re-activated on a different computer or under a different user account as long
as the Mail processed in the new location belongs to the same Individual End User.
2.4.2. Aid4Mail Professional 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. Such license is for
Professional Use to perform tasks that include Mail Migration and archiving, but not e-discovery or
forensic examination.
Copyright 2005-2016 Fookes Holding Ltd

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

Purchasing and License Agreement

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

Purchasing and License Agreement

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.

Copyright 2005-2016 Fookes Holding Ltd

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.

Copyright 2005-2016 Fookes Holding Ltd

Purchasing and License Agreement

166

This is a notice to U.S. Government End Users:


The Software and the documentation which accompanies the Software are Commercial Items, as that
term is defined at 48 C.F.R. 2.101, consisting of Commercial Computer Software and Commercial
Computer Software Documentation, as such terms are used in 48 C.F.R. 12.212 or 48 C.F.R.
227.7202, as applicable. Consistent with 48 C.F.R. 12.212 or 48 C.F.R. 227.7202-1 through
227.7202-4, as applicable, the Commercial Computer Software and Commercial Computer Software
Documentation are being licensed to U.S. Government end users (a) only as Commercial Items and (b)
with only those rights as are granted to all other end users pursuant to the terms and conditions herein.
Fookes Software Ltd, La Petite Fin 27, 1637 Charmey, Switzerland.
10. WARRANTY DISCLAIMER AND LIMITATION OF LIABILITY.
THE SOFTWARE AND CUSTOMER SUPPORT IS PROVIDED ON AN AS IS BASIS. FOOKES
SOFTWARE DISCLAIMS AS FAR AS LEGALLY PERMISSIBLE ALL WARRANTIES RELATING TO
THE SOFTWARE AND CUSTOMER SUPPORT, 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 SOFTWARE 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 SOFTWARE OR CUSTOMER SUPPORT (SUPPLIERS)
SHALL BE LIABLE FOR ANY 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 SUCH SOFTWARE, EVEN IF FOOKES
SOFTWARE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR CLAIMS. THE
PERSON USING THE SOFTWARE BEARS ALL RISK AS TO THE QUALITY AND PERFORMANCE
OF THE SOFTWARE.
THE ENTIRE LIABILITY OF FOOKES SOFTWARE AND ITS SUPPLIERS, AND YOUR EXCLUSIVE
REMEDY, WITH RESPECT TO THE USE OF THE SOFTWARE OR CUSTOMER SUPPORT OR ANY
BREACH OF THIS AGREEMENT ARE LIMITED TO THE AMOUNT ACTUALLY PAID BY YOU, IF ANY,
FOR USE OF THE SOFTWARE. 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 SOFTWARE 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
SOFTWARE 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
SOFTWARE.
11. 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.

Copyright 2005-2016 Fookes Holding Ltd

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

AID4MAIL BETA AGREEMENT


(Version: March 2010)
This Beta Agreement (this Beta Agreement), governs the terms and conditions of the Licensees
access to and use of certain beta test and pre-release versions of the Software (each a Beta Version)
and is made between you and Fookes Software.
1. General. The terms and conditions of the Aid4Mail End User License Agreement between you and
Fookes Software, as the same may be updated from time to time (the EULA) are incorporated herein
by reference, and apply to the Beta Version. Defined terms used without definition in this Beta
Agreement have the meanings given in the EULA. In the event of any conflict between the EULA and this
Beta Agreement, this Beta Agreement controls.
2. Beta Version Background. Fookes Software may offer to you, and you may consent to receive, one
or more Beta Versions from time to time prior to the commercial release of an official update or upgrade
(Release Version). The primary purpose of a Beta Version is to facilitate user testing, identify defects
and obtain user feedback. A Beta Version usually contains features and functionality that have not been
tested or re-tested in full or in part and therefore may not work as specified. Do not use the Beta Version
on any sensitive data unless you have backup copies in a safe location. Files produced by the Beta
Copyright 2005-2016 Fookes Holding Ltd

Purchasing and License Agreement

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.

Last update to Aid4Mail Beta Agreement: March 26, 2010


Copyright 2005-2016 Fookes Holding Ltd

Purchasing and License Agreement

3.7

170

Third Party Software Notices and/or Additional Terms and


Conditions
Portions of Aid4Mail utilize or include third-party products and other copyrighted material.
Acknowledgements, licensing terms and additional disclaimers for such material are contained in this
document, and your use of such material is governed by their respective terms.

Adobe Portable Document Format (PDF)


Intellectual Property
The general idea of using an interchange format for electronic documents is in the public domain.
Anyone is free to devise a set of unique data structures and operators that define an interchange format
for electronic documents. However, Adobe Systems Incorporated owns the copyright for the particular
data structures and operators and the written specification constituting the interchange format called the
Portable Document Format. Thus, these elements of the Portable Document Format may not be copied
without Adobes permission.
Adobe will enforce its copyright. Adobes intention is to maintain the integrity of the Portable Document
Format standard. This enables the public to distinguish between the Portable Document Format and
other interchange formats for electronic documents. However, Adobe desires to promote the use of the
Portable Document Format for information interchange among diverse products and applications.
Accordingly, Adobe gives anyone copyright permission, subject to the conditions stated below, to:
Prepare files whose content conforms to the Portable Document Format
Write drivers and applications that produce output represented in the Portable Document Format
Write software that accepts input in the form of the Portable Document Format and displays, prints, or
otherwise interprets the contents
Copy Adobes copyrighted list of data structures and operators, as well as the example code and
PostScript language function definitions in the written specification, to the extent necessary to use the
Portable Document Format for the purposes above
The conditions of such copyright permission are:
Authors of software that accepts input in the form of the Portable Document Format must make
reasonable efforts to ensure that the software they create respects the access permissions and
permissions controls listed in Table 3.20 of this specification, to the extent that they are used in any
particular document. These access permissions express the rights that the documents author has
granted to users of the document. It is the responsibility of Portable Document Format consumer
software to respect the authors intent.
Anyone who uses the copyrighted list of data structures and operators, as stated above, must include
an appropriate copyright notice.
This limited right to use the copyrighted list of data structures and operators does not include the right to
copy this book, other copyrighted material from Adobe, or the software in any of Adobes products that
use the Portable Document Format, in whole or in part, nor does it include the right to use any Adobe
patents, except as may be permitted by an official Adobe Patent Clarification Notice (see the
Bibliography).
Adobe Patent Clarification Notice: Reading and writing PDF files

Copyright 2005-2016 Fookes Holding Ltd

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.

Delphi Encryption Compendium version 5.2 (DEC Part I)


A compendium of various strong encryption algorithms and hash functions for Delphi. Some of the
algorithms Aid4Mail uses from this library include MD5, SHA1, SHA256, SHA384, and SHA512.
Copyright 2006 Hagen Reddmann, HaReddmann@t-online.de
Modifications 2008 Arvid Winkelsdorf, digivendo GmbH, info@digivendo.de
THIS SOFTWARE IS PROVIDED BY THE AUTHORS ''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 AUTHORS 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.

Copyright 2005-2016 Fookes Holding Ltd

Purchasing and License Agreement

172

FastMM library: http://fastmm.sourceforge.net/


Copyright 2004-2012, Professional Software Development / Pierre le Riche.
This library and its usage are covered by the Mozilla Public License v1.1. The source code for this library
is available from http://fastmm.sourceforge.net/. No modifications to this library have been made by
Fookes Software.

Independent JPEG Group: http://www.ijg.org/


This software is based in part on the work of the Independent JPEG Group:
The authors make NO WARRANTY or representation, either express or implied, with respect to this
software, its quality, accuracy, merchantability, or fitness for a particular purpose. This software is
provided "AS IS", and you, its user, assume the entire risk as to its quality and accuracy.
This software is copyright (C) 1991-1998, Thomas G. Lane. All Rights Reserved except as specified
below.
Permission is hereby granted to use, copy, modify, and distribute this software (or portions thereof) for
any purpose, without fee, subject to these conditions:
(1) If any part of the source code for this software is distributed, then this README file must be
included, with this copyright and no-warranty notice unaltered; and any additions, deletions, or changes
to the original files must be clearly indicated in accompanying documentation.
(2) If only executable code is distributed, then the accompanying documentation must state that "this
software is based in part on the work of the Independent JPEG Group".
(3) Permission for use of this software is granted only if the user accepts full responsibility for any
undesirable consequences; the authors accept NO LIABILITY for damages of any kind.
These conditions apply to any software derived from or based on the IJG code, not just to the unmodified
library. If you use our work, you ought to acknowledge us.
Permission is NOT granted for the use of any IJG author's name or company name in advertising or
publicity relating to this software or products derived from it. This software may be referred to only as
"the Independent JPEG Group's software".
We specifically permit and encourage the use of this software as the basis of commercial products,
provided that all warranty or liability claims are assumed by the product vendor.

OpenSSL Toolkit version 1.0.2h: http://www.openssl.org/


Copyright 1998-2016 The OpenSSL Project. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided
that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice, this list of conditions and the
following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and
the following disclaimer in the documentation and/or other materials provided with the distribution.

Copyright 2005-2016 Fookes Holding Ltd

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).

Original SSLeay License


Copyright 1995-1998 Eric Young (eay@cryptsoft.com). All rights reserved.
This package is an SSL implementation written by Eric Young (eay@cryptsoft.com). The
implementation was written so as to conform with Netscape's SSL.
This library is free for commercial and non-commercial use as long as the following conditions are
adhered to. The following conditions apply to all code found in this distribution, be it the RC4, RSA,
lhash, DES, etc., code; not just the SSL code. The SSL documentation included with this distribution is
covered by the same copyright terms except that the holder is Tim Hudson (tjh@cryptsoft.com).
Copyright remains Eric Young's, and as such any Copyright notices in the code are not to be removed. If
this package is used in a product, Eric Young should be given attribution as the author of the parts of the
library used. This can be in the form of a textual message at program startup or in documentation (online
or textual) provided with the package.
Redistribution and use in source and binary forms, with or without modification, are permitted provided
that the following conditions are met:
1. Redistributions of source code must retain the copyright notice, this list of conditions and the
following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and
Copyright 2005-2016 Fookes Holding Ltd

Purchasing and License Agreement

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.]

PCRE License: http://www.pcre.org/


PCRE is a library of functions to support regular expressions whose syntax and semantics are as close
as possible to those of the Perl 5 language.
Release 8 of PCRE is distributed under the terms of the "BSD" licence, as specified below. The
documentation for PCRE is distributed under the same terms as the software itself.
The basic library functions are written in C and are freestanding. Also included in the distribution is a set
of C++ wrapper functions.
The basic library functions are written by Philip Hazel
Copyright (c) 1997-2013 University of Cambridge. All rights reserved.
The C++ wrapper functions are contributed by Google Inc.
Copyright (c) 2007-2012, Google Inc. All rights reserved.
THE "BSD" LICENCE:
Redistribution and use in source and binary forms, with or without modification, are permitted provided
that the following conditions are met:
Redistributions of source code must retain the above copyright notice, this list of conditions and the
following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and
the following disclaimer in the documentation and/or other materials provided with the distribution.
Neither the name of the University of Cambridge nor the name of Google Inc. nor the names of their
contributors may be used to endorse or promote products derived from this software without specific
prior written permission.
Copyright 2005-2016 Fookes Holding Ltd

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.

PNG Delphi version 1.56: http://pngdelphi.sourceforge.net/


Copyright Gustavo Huffenbacher Daud

RSA's MD5 disclaimer


Copyright 1991-1992, RSA Data Security, Inc. Created 1991. All rights reserved.
License to copy and use this software is granted provided that it is identified as the "RSA Data Security,
Inc. MD5 Message-Digest Algorithm" in all material mentioning or referencing this software or this
function.
License is also granted to make and use derivative works provided that such works are identified as
"derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm" in all material mentioning or
referencing the derived work.
RSA Data Security, Inc. makes no representations concerning either the merchantability of this software
or the suitability of this software for any particular purpose. It is provided "as is" without express or
implied warranty of any kind.
These notices must be retained in any copies of any part of this documentation and/or software.

Synapse library release 39: http://synapse.ararat.cz/


Synapse is a Delphi library providing functions for network communications based on Winsock.
Copyright (c)1999-2010, Lukas Gebauer. All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided
that the following conditions are met:
Redistributions of source code must retain the above copyright notice, this list of conditions and the
following disclaimer.
Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the
following disclaimer in the documentation and/or other materials provided with the distribution.
Neither the name of Lukas Gebauer nor the names of its contributors may be used to endorse or
promote products derived from this software without specific prior written permission.

Copyright 2005-2016 Fookes Holding Ltd

Purchasing and License Agreement

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.

SZCodeBaseX library version 1.3.5b: www.szutils.net


SZCodeBaseX is a Delphi library with universal encode/decode algorithms for Base16, Base32 and
Base64.
Copyright 2004-2007 Sasa Zeman. All Rights Reserved.
This library, as modified by Fookes Software, and its usage are covered by the Mozilla Public License
v1.1. The modified source code for this library is available from http://www.fookes.com/ftp/mpl/
SZCodeBaseX.zip.

wPDF Engine V3: http://www.wpcubed.com/


Copyright (C) 2003-2013 WPCubed GmbH and Julian Ziersch

WPTools V6: http://www.wpcubed.com/


Copyright (C) 2004-2013 WPCubed GmbH and Julian Ziersch

ZLib library version 1.2.3: http://www.zlib.net/


zlib is a general purpose compression library.
Copyright (C) 1995-2005 Jean-loup Gailly and Mark Adler
This software is provided 'as-is', without any express or implied warranty. In no event will the authors be
held liable for any damages arising from the use of this software.
Permission is granted to anyone to use this software for any purpose, including commercial
applications, and to alter it and redistribute it freely, subject to the following restrictions:
1. The origin of this software must not be misrepresented; you must not claim that you wrote the original
software. If you use this software in a product, an acknowledgment in the product documentation would
be appreciated but is not required.
2. Altered source versions must be plainly marked as such, and must not be misrepresented as being
the original software.
3. This notice may not be removed or altered from any source distribution.

Copyright 2005-2016 Fookes Holding Ltd

177

Aid4Mail 4 Help

Other Information

4.1

About Fookes Software


Company
Fookes currently comprises three entities: Fookes Holding Ltd, Fookes Software Ltd and Fookes
Photography.
Fookes Software was originally founded in 1996 in Geneva, Switzerland. Now a Limited (Ltd) company
based in Charmey, in the Swiss Pre-Alps, it is fully owned by its parent Fookes Holding Ltd. For 20
years now, we have been developing award-winning tools and productivity software. Our clients include
government and law enforcement agencies, Fortune 500 corporations, top universities and other
educational institutions, international organizations, as well as individuals and home users world-wide.

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

Contacting Fookes Software


Answers to most of the questions we receive already exist in our documentation. Before contacting us,
we suggest you first look through our Help files and online FAQs; this will help you get a solution in the
shortest time possible. Please also verify that you are using the latest software update before reporting a
problem.
Copyright 2005-2016 Fookes Holding Ltd

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

Other Fookes Software Titles


ToutMail
This is a localized version of Aid4Mail for French-speaking users. It is the only software on the market
that is capable of correctly processing mailbox files created with the French version of Eudora.
http://www.toutmail.com/
NoteTab Pro
For those who demand the best. NoteTab Pro offers all the features HTML authors, programmers,
businesses and other demanding users need to speed up their work. The registered version adds a
thesaurus and a multilingual spell checker.
http://www.notetab.com/

4.4

Popular Mail Clients


Eudora (www.eudora.com)
Eudora is one of the oldest Personal Computer based mail clients. Its features include multiple addressbook-formatting options and the ability to filter, redirect, and forward mail. Eudora is available in different
flavors, including a free version. It is no longer being developed by QUALCOMM. An open source edition

Copyright 2005-2016 Fookes Holding Ltd

179

Aid4Mail 4 Help

called Eudora OSE is currently distributed by the Mozilla Foundation.


Foxmail (fox.foxmail.com.cn/english)
Foxmail is a popular email client, especially in China, with more than 3 million users. The English
version is also widely used in more than 20 countries. Freeware.
Mozilla Thunderbird (www.mozilla.org/products/thunderbird)
Thunderbird is a free, open-source and cross-platform mail client for most operating systems including,
but not limited to, Windows, Linux and Macintosh. It is based on the Mozilla codebase. It is a robust
and easy to use client, similar to competing products like Outlook Express, but with some major
advantages such as junk mail classification.
Microsoft Outlook (www.microsoft.com)
In its latest incarnation, Microsoft Outlook is a rock solid mail client with a very extensive feature set
including full MAPI support. It is the most popular mail client in the corporate world. Commercial.
Outlook Express (www.microsoft.com)
The free mail client from Microsoft that is fully integrated with Windows XP and earlier versions.
Windows Mail (www.microsoft.com)
The free mail client from Microsoft that is fully integrated with Windows Vista. It is replaced by Windows
Live Mail on Windows 7.
Windows Live Mail (www.microsoft.com)
Windows Live Mail 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.
Pegasus Mail (www.pmail.com)
Pegasus Mail is a free, standards-based electronic mail client suitable for use by single or multiple
users on single computers or on local area networks. It has special support for Novell NetWare LANs
that allow it to operate intuitively and with almost no maintenance.
PocoMail and Barca (www.pocomail.com)
PocoMail was developed from the ground-up to protect users from viruses and spam that plague other
commonly used products. This means that PocoMail is powerful, fast, secure, safe, and easy to
maintain. Shareware.
Barca is based on PocoMail and includes many extras including a flexible Calendar, Tasks and Planner
to schedule events, popup Notes to gather information and Diary to keep track of your daily activities; all
united with a smart interface.
The Bat! (www.ritlabs.com/the_bat)
The Bat! is an email application that supports multiple POP3 accounts, multithreading, MIME and
UUencode standards, multimedia, APOP authorization, and PGP. You also will find a fast and
comfortable message editor with text highlighting, as well as a mail dispatcher for managing messages
on servers. Shareware.

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.

Copyright 2005-2016 Fookes Holding Ltd

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.

Copyright and Disclaimer


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.
Products that are referred to in this document may be either trademarks and/or registered trademarks of
the respective owners. The publisher and the author make no claim to these trademarks.
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.

Copyright 2005-2016 Fookes Holding Ltd

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

Exit Codes (Aid4Mail Console)


131
Export addresses
72
Export Generic mail formats
65
Export options screen
72
Export Outlook Express
65
Export to (Thunderbird,
64
Export to Exchange
63
Export to Internet Explorer
66
Export to Microsoft Excel
66
Export to Mozilla-compatible mailboxes
64
Export to MSG
63
Export to Outlook
63
Export to PocoMail & Barca compatible mailboxes
64
Export to PST 63
Export to Windows Live Mail and Windows Mail
64
Export to ZIP file
67
Export Windows Live Mail
65
Export Windows Mail
65
Extended Download Warranty
37
Extended MAPI 23, 152
Ext-Mime.dat
147
Extract message contents only
66

-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

-GGeneral Aid4Mail FAQ


41
Generic mailbox
151
Generic mailbox format
23
Gmail
23
Gmail settings
139
GMX Mail settings
139
Google Apps Vault
23
Google Takeout
23
GUI 151
GUI Command-Line Switches

80

-HHome user migrating non-professional mail


Hotmail
23

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

-OOffice 365 settings


139
Office Outlook
23
Office Outlook & Microsoft Exchange
Office Outlook FAQ
47
Office365-Migration.csv 125
Offline activation
18
Opera Mail
23
Order by phone or fax
156
Ordering Aid4Mail FAQ
37
Ordering information
156
Other mail clients
64
Other Switches
110
Outlook 2010 bug
78
Outlook Express
23
Outlook for Mac
23
Outlook Personal Storage
68
Outlook.com settings
139

63

-Ppartial EMLX files


23
Password - Product Activation FAQ
39
Payment options
156
PDF Settings
68
PDF/A
153
PDF/A-1a
153
Pegasus Mail
23
Personal folder store
154
Pine mbox Format
23
Pine MBX Format
23
Piracy
157
Plain text
154
PMMail
23
PocoMail
23
Popular mail clients
178
Preserving the Subject Line Text (Trial Mode)
Pricing
156
Private information store
154
Processing a list of files
131

17

185

Aid4Mail 4 Help

Processing an Unlimited Number of Emails (Trial


Mode)
17
Product activation
18
Product Activation FAQ
39
Profile
154
Program interface
54
Program updates
20
Proxy Settings (IMAP)
139
Proxy settings (license activation)
18
PST files
154
pstloadtmp000 - FAQ
47
Public information store
154
Purchase Orders
156

-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

-SSave Failed Uploads Locally - IMAP Options


77
Save TNEF as Winmail.dat Attachments - Advanced
Options
78
Screen readers
55
SeaMonkey Mail
23
Section 508
55
Secure online ordering
156
Service provider (including e-discovery,
forensic-examination, and archiving services)
14
Setup Command-Line Parameters
7
Setup Exit Codes
9
Silent installation
7
Silent uninstall
10
Simple MAPI 152

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

-TTarget Format screen


63
Target Format Switches
104
Target IMAP Folder screen
72
Target Line Format
68
Target Location
68
Target MAPI Folder screen
71
Target Settings screen
68
Target Switches
102
Templates and Fields
149
Temporary Profiles - FAQ
47
Testing Unlimited Emails
17
The Bat! 23
Third Party Software Notices
170
thumb drive
155
Thunderbird
23
Time Zones
147
TimeZones.dat
147
TLS
155
TNEF
155
Tokens.ini
143
Torrent downloads
157
ToutMail
178
Trademarks
179
TrashFiles.dat
56
Copyright 2005-2016 Fookes Holding Ltd

Index

TrashFolders.dat
56
Trial limitations
17
Trial mode
17
Trial Mode screen
75

-XX.400 addressing format - FAQ

-U-

-Y-

Unicode PST 155


Uninstall
10
Uninstaller Command-Line Parameters
10
Unpurged mail
156
Update Now
20
Upgrade policy
157
USB flash drive
155
USB key
155
USB pen
155
USB pen drive
155
Use MAPI RFC 1521 Converter - Advanced Options
78
Use MAPI TNEF Converter - Advanced Options
78
Use Received Date Field - Advanced Options
78
Using Aid4Mail with Macs FAQ
52
Using cracks
157
Using keygens
157
UTC
156

-VView archived mail


31
Virtual PC
5
Virus warning
6
Voluntary Product Accessibility Template
VPAT 55

55

-WWarn When Skipping Invalid File Format - Advanced


Options
78
Which version do I need?
11
Wildcard tokens
59
Windows Live Mail
23
Windows Mail
23
Windows Service
96
Wine
5
Words List File
129
Writing Aid4Mail Scripts
82

Copyright 2005-2016 Fookes Holding Ltd

Yahoo! Mail
23
Yahoo! Mail settings

139

-ZZIP Archives - FAQ


Zoho Mail settings

52
139

47

186

Potrebbero piacerti anche