aid4mail3 manual

178
Copyright © 2005-2013, Fookes Holding Ltd Aid4Mail 3 User Manual

Upload: gopal-singh

Post on 20-Jan-2016

133 views

Category:

Documents


7 download

TRANSCRIPT

Page 1: Aid4Mail3 Manual

Copyright © 2005-2013, Fookes Holding Ltd

Aid4Mail 3User Manual

Page 2: Aid4Mail3 Manual

Aid4Mail 3The Swiss Army knife of email conversion tools

by Fookes Holding Ltd

Aid4Mail™ is a leading email conversion tool used for email migration, emaildiscovery (searching and data extraction), and email archiving. It supportsover 40 mail client programs and mailbox formats, and all webmail accountsoffering IMAP access. Mail folders and files can be processed even whendisconnected (unmounted) from their email client including those stored onCD, DVD, and USB drives.

Aid4Mail retains more information during conversion than any of itscompetitors, including the native import and export features of most emailapplications. Formatting, sender/recipient and other header details,attachments, embedded contents, and message status are converted withunmatched fidelity. This capability is crucial to large-scale migrations and forthose involved in e-discovery and email archiving.

Page 3: Aid4Mail3 Manual

All rights reserved. No parts of this work may be reproduced in any form or by any means - graphic, electronic, ormechanical, including photocopying, recording, taping, or information storage and retrieval systems - without thewritten permission of the publisher.

Products that are referred to in this document may be either trademarks and/or registered trademarks of therespective 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 noresponsibility for errors or omissions, or for damages resulting from the use of information contained in thisdocument or from the use of programs and source code that may accompany it. In no event shall the publisher andthe author be liable for any loss of profit or any other commercial damage caused or alleged to have been causeddirectly or indirectly by this document.

Printed: June 2013 in Charmey, Switzerland

Aid4Mail

Copyright © 2005-2013, Fookes Holding Ltd, Switzerland

PublisherSpecial thanks to:

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

Fookes Holding Ltd

Page 4: Aid4Mail3 Manual

Aid4Mail 3 HelpI

Copyright © 2005-2013 Fookes Holding Ltd

Table of Contents

Foreword 0

Part I General Information 1

................................................................................................................................... 11 Introduction

................................................................................................................................... 42 Key Features

................................................................................................................................... 53 System Requirements

................................................................................................................................... 64 Installation

.......................................................................................................................................................... 7Setup Command-Line Parameters

.......................................................................................................................................................... 9Setup Exit Codes

.......................................................................................................................................................... 9Uninstall

................................................................................................................................... 105 Aid4Mail Editions

................................................................................................................................... 116 Which version do I need?

.......................................................................................................................................................... 11Home user migrating non-professional mail

.......................................................................................................................................................... 12Individual or organization migrating professional mail

.......................................................................................................................................................... 13Service provider (including e-discovery, forensic-examination, and archiving services)

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

.......................................................................................................................................................... 14Email archivist (but not a service provider)

................................................................................................................................... 157 Comparison Chart

................................................................................................................................... 168 Trial Mode

................................................................................................................................... 179 Product Activation

................................................................................................................................... 1910 How to Get Program Updates

................................................................................................................................... 2011 Supported Mail Formats

................................................................................................................................... 2212 Information About Mail Formats

................................................................................................................................... 2913 Archiving Email

................................................................................................................................... 3014 Finding Mail Folders

................................................................................................................................... 3515 Frequently Asked Questions (FAQ)

.......................................................................................................................................................... 35Ordering Aid4Mail FAQ

.......................................................................................................................................................... 36Product Activation FAQ

.......................................................................................................................................................... 39General Aid4Mail FAQ

.......................................................................................................................................................... 44Office Outlook FAQ

.......................................................................................................................................................... 49Aid4Mail ZIP Archives FAQ

.......................................................................................................................................................... 50Using Aid4Mail w ith Macs FAQ

Part II Reference Information 51

................................................................................................................................... 511 Program Interface

................................................................................................................................... 522 Accessibility Mode

................................................................................................................................... 533 Wizard Screens

.......................................................................................................................................................... 531. Mail Source

.......................................................................................................................................................... 542. Source Location

.......................................................................................................................................................... 553. MAPI Store

.......................................................................................................................................................... 554. Source MAPI Folders

.......................................................................................................................................................... 565. Source IMAP Folders

Page 5: Aid4Mail3 Manual

IIContents

II

Copyright © 2005-2013 Fookes Holding Ltd

.......................................................................................................................................................... 566. Filter Options

.......................................................................................................................................................... 607. Target Format

......................................................................................................................................................... 60Office Outlook & Microsoft Exchange

......................................................................................................................................................... 61Other mail clients

......................................................................................................................................................... 62Export email to remote server

......................................................................................................................................................... 62Generic mail formats

......................................................................................................................................... 62Outlook Express

......................................................................................................................................................... 63Extract message contents only

......................................................................................................................................................... 63MHT Web Archive f iles

......................................................................................................................................................... 64Mail archives

......................................................................................................................................................... 65Custom formats using scripts

.......................................................................................................................................................... 658. Target Settings

.......................................................................................................................................................... 689. Target MAPI Folder

.......................................................................................................................................................... 6810. Target IMAP Folder

.......................................................................................................................................................... 6911. Export Options

.......................................................................................................................................................... 7112. Start Processing Mail

......................................................................................................................................................... 72Skipped Messages

.......................................................................................................................................................... 72Other Screens

......................................................................................................................................................... 72Trial Mode

......................................................................................................................................................... 73New s and Updates

................................................................................................................................... 734 Writing Aid4Mail Scripts

.......................................................................................................................................................... 77Aid4Mail Script Syntax

.......................................................................................................................................................... 84Calculate command

................................................................................................................................... 875 Aid4Mail Console

.......................................................................................................................................................... 87Command-Line Parameters

......................................................................................................................................................... 89Source Sw itches

......................................................................................................................................................... 91Target Sw itches

......................................................................................................................................... 94Target Format Sw itches

......................................................................................................................................... 96Email Contents Sw itches

......................................................................................................................................... 96Special IMAP Sw itches

......................................................................................................................................................... 97Filter Sw itches

......................................................................................................................................................... 99Other Sw itches

.......................................................................................................................................................... 100INI File Settings

......................................................................................................................................................... 101Source Settings

......................................................................................................................................................... 104Target Settings

......................................................................................................................................................... 110Filter Settings

......................................................................................................................................................... 111Other Settings

.......................................................................................................................................................... 112Words List File

.......................................................................................................................................................... 114Processing a List of Files

.......................................................................................................................................................... 115Exit Codes

.......................................................................................................................................................... 115Command-Line Examples

................................................................................................................................... 1216 IMAP Settings

................................................................................................................................... 1257 Fixing Attachment Folder References

................................................................................................................................... 1268 Useful Tokens and System Variables

................................................................................................................................... 1299 MIME Types and File Extensions

................................................................................................................................... 12910 Time Zones

................................................................................................................................... 13011 Templates and Fields

................................................................................................................................... 13112 Error Log File

................................................................................................................................... 13213 Advanced Options

................................................................................................................................... 13414 GUI Command-Line Switches

Page 6: Aid4Mail3 Manual

Aid4Mail 3 HelpIII

Copyright © 2005-2013 Fookes Holding Ltd

................................................................................................................................... 13615 Glossary

.......................................................................................................................................................... 136ANSI PST

.......................................................................................................................................................... 136Attachment

.......................................................................................................................................................... 136CLI

.......................................................................................................................................................... 137Delimiter

.......................................................................................................................................................... 137Embedded contents

.......................................................................................................................................................... 137EML files

.......................................................................................................................................................... 137Exchange mailbox

.......................................................................................................................................................... 137Folder

.......................................................................................................................................................... 137Generic mailbox

.......................................................................................................................................................... 137GUI

.......................................................................................................................................................... 137IMAP

.......................................................................................................................................................... 138Information store

.......................................................................................................................................................... 138Mailbox

.......................................................................................................................................................... 138MAPI

.......................................................................................................................................................... 138MAPI folder

.......................................................................................................................................................... 138mbox

.......................................................................................................................................................... 138MAPI store

.......................................................................................................................................................... 138MD5

.......................................................................................................................................................... 139Message folder

.......................................................................................................................................................... 139Message-ID

.......................................................................................................................................................... 139MHT files

.......................................................................................................................................................... 139MHTML

.......................................................................................................................................................... 139MIME

.......................................................................................................................................................... 139PDF/A

.......................................................................................................................................................... 140Personal folder store (PST)

.......................................................................................................................................................... 140Plain text

.......................................................................................................................................................... 140Private information store

.......................................................................................................................................................... 140Profile

.......................................................................................................................................................... 140Public information store

.......................................................................................................................................................... 140Recipient

.......................................................................................................................................................... 140Rich content

.......................................................................................................................................................... 140Rich text

.......................................................................................................................................................... 141SSL

.......................................................................................................................................................... 141Status Flags/Indicators

.......................................................................................................................................................... 141Styled Text

.......................................................................................................................................................... 141Thumb drive

.......................................................................................................................................................... 141TLS

.......................................................................................................................................................... 141TNEF

.......................................................................................................................................................... 141Unicode PST

.......................................................................................................................................................... 141Unpurged mail

.......................................................................................................................................................... 142UTC

Part III Purchasing and License Agreement 142

................................................................................................................................... 1421 Ordering Information

................................................................................................................................... 1422 Upgrade Policy

................................................................................................................................... 1423 Refund Policy

................................................................................................................................... 1424 Software Piracy

................................................................................................................................... 1435 End User License Agreement

................................................................................................................................... 1556 Third Party Software Notices and/or Additional Terms and Conditions

Page 7: Aid4Mail3 Manual

IVContents

IV

Copyright © 2005-2013 Fookes Holding Ltd

Part IV Other Information 162

................................................................................................................................... 1621 About Fookes Software

................................................................................................................................... 1632 Contacting Fookes Software

................................................................................................................................... 1633 Other Fookes Software Titles

................................................................................................................................... 1644 Popular Mail Clients

................................................................................................................................... 1655 Trademarks

................................................................................................................................... 1656 Acknowledgements

Part V Copyright and Disclaimer 165

Index 166

Page 8: Aid4Mail3 Manual

Aid4Mail 3 Help1

Copyright © 2005-2013 Fookes Holding Ltd

1 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 suitablefor both small and large scale projects, from home use to large corporate migrations, and mission-criticalforensic work.

Aid4Mail supports over 40 email client programs and mail formats, as well as many popular webmailservices and remote accounts through IMAP. Local mail folders and files can be processed even whendisconnected (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 areused by e-discovery experts worldwide. The filter tool enables refined searches on emails usingwildcards and even complex regular expressions if necessary. The integrated scripting language makesit 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 Aid4Mailexcels. All editions can export mail to a non-proprietary highly compressed ZIP file format or indexableEML files. Aid4Mail eDiscovery also offers the option to convert messages to PDF/A, an importantelectronic 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. Seethe 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 Exchange to Google Apps,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 yourkeyboard's F1 function key. This manual is for Aid4Mail version 3.2, so earlier versions may not havesome of the capabilities discussed here.

Unmatched Fidelity

Aid4Mail retains more information during conversion than any of its competitors, including the nativeimport and export features of most email applications. Formatting, sender/recipient and other header

Page 9: Aid4Mail3 Manual

General Information 2

Copyright © 2005-2013 Fookes Holding Ltd

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

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 aleading search engine. An OEM version runs seamlessly within several well-known e-discoveryproducts.

User-Friendly and Fast

Aid4Mail offers a modern and user-friendly interface, with fast mail processing to save time andultimately 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 Aid4Mailconsistently produces more accurate results than any of its closest competitors, notably when importingor exporting from Outlook, Exchange, PST and MSG files. You cannot afford to lose important emaildata during large-scale migrations or forensic investigations. If you value the integrity of your data, tryAid4Mail 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 andcut costs. There is no need to install Aid4Mail Console on an end-user's computer; simply place it on aUSB key (thumb drive) or on your network server. You can then automate the migration process througha 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 bykeywords in the message body or header. Special Boolean operations are supported, as are wildcardsand Regular Expressions. Custom filters and output formats can be created through the new scriptinglanguage.

Aid4Mail eDiscovery can launch external console applications and can export to non-proprietary formatsincluding MHT, XML, PDF, and the new industry standard PDF/A. It supports various hash functions and

Page 10: Aid4Mail3 Manual

Aid4Mail 3 Help3

Copyright © 2005-2013 Fookes Holding Ltd

maintains formatting, sender/recipient information, attachments, embedded contents, and messagestatus 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-proprietaryformats. 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 lossof valuable business information. Proprietary email archives risk becoming obsolete long before theretention period is up. See our Archiving Email page for more information.

Supported Mail Formats

Aid4Mail supports many email applications including all 32-bit versions of Office Outlook (MAPI emailprofiles, MSG files, and mounted/unmounted PST files), Microsoft Exchange, Outlook Express,Windows Mail, Windows Live Mail, Mozilla Mail and Thunderbird, Netscape Messenger, Eudora forWindows and Mac, Pegasus Mail, UNIX mbox, Pine mbox, Entourage MBOX, maildir, EML, Apple Mail(EMLX), Mail.app for Mac, The Bat!, PocoMail, Barca, Opera Mail, Forte Agent, FoxMail (up to version6.5), Calypso, Courier, PMMail, HTML, MHT, Excel.

New in version 2: IMAP accounts and web mail services such as Gmail, Yahoo! Mail, Zoho Mail, AIM.Mail (AOL Mail), FastMail, and GMX Mail. Export to PDF, PDF/A, CSV, XML, and custom outputformats. Supported IMAP servers include Courier, Cyrus, Dovecot, Zimbra, Microsoft Exchange, NovellGroupWise, 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 isdistinguished by a specific set of features. The main feature differences are listed in the comparisonchart. An edition is further subdivided into one or more license types. Each license type corresponds toa specific set of usage terms, which are defined in the End User License Agreement. For help inchoosing 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 anintegral part of our toolset for dealing with these volumes of email. We are very impressed with yourcommitment 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 referto the same mail client software. However, Outlook Express is a completely different mail program andshould not be confused with Outlook.

Page 11: Aid4Mail3 Manual

General Information 4

Copyright © 2005-2013 Fookes Holding Ltd

1.2 Key Features

Aid4Mail contains the following key features, listed by edition. For help in choosing the appropriatelicense, see the Which version do I need? topic.

All editions of Aid4Mail

Import/export Microsoft Outlook mail from PST and MSG files.(Requires the standalone MAPI or the 32-bit version of Outlook for Windows – either the full version ora 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/downloadmessages. Works with popular services like Gmail, Yahoo! Mail, and Outlook Live.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 moreinformation.)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 (seeexamples).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 the standalone MAPI or the 32-bit version of Outlook for Windows – either the full version ora 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 tocustom 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.Offline activation.

Aid4Mail Console only

Page 12: Aid4Mail3 Manual

Aid4Mail 3 Help5

Copyright © 2005-2013 Fookes Holding Ltd

Run from batch files, scripts, the Windows Start/Run dialog, and any application that can executeother programs.Process more than one PST file unattended.Run from a server (custom Server license). Note that due to third-party licensing terms, the serveredition 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 thumb drive or a server, to speed up migration when going from one desktopcomputer to the next.

1.3 System Requirements

Aid4Mail has the following minimum requirements:

Windows® 8 / 7 / Vista / XP / 2000, Server 2012 / 2008 / 2003Both 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, Aid4Mailrequires either a 32-bit version of Office Outlook for Windows (their free 60-day trial version issufficient) or Microsoft's free standalone version of MAPI (but it does not support Unicode PST fileswhich are created by Outlook 2003 and more recent versions).

Microsoft Exchange messages can either be processed through an Outlook/MAPI mail profile (seerequirements in previous point), or through the IMAP protocol in which case the Exchange serverneeds to be set up for IMAP access (see Microsoft's instructions).

Note:Aid4Mail currently does not support the 64-bit version of Office Outlook 2010 and 2013 (Windows64-bit with Outlook 32-bit works fine).Aid4Mail is an out-of-process application and so is not compatible with Click-to-Run installationsof 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 toprocess PST and MSG files. If it is installed in Internet Mail Only (IMO) mode, then only the defaultMAPI profile can be processed.There may be compatibility issues with Outlook 97.PST files from Outlook 8.x for Mac are not supported. Note that Outlook 2011 for Mac can importPST files created by Aid4Mail.

Page 13: Aid4Mail3 Manual

General Information 6

Copyright © 2005-2013 Fookes Holding Ltd

After you purchase an Aid4Mail license, you will need to activate your copy of the software. This simpleprocedure requires an internet connection and usually takes just a few seconds. Aid4Mail eDiscoveryForensic offers an option for offline activation.

1.4 Installation

Please read the System Requirements before installing Aid4Mail.

To install Aid4Mail, just execute the Setup program (Setup.exe or a similar name) and follow theinstructions. If you have purchased a license and received an activation code, start the Aid4Mailprogram, click on the Software button, select Activate Product from the drop-down menu, and then enteryour code in the dialog box. Note that product activation requires an internet connection. Please readthe 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 touninstall it. By default, Aid4Mail version 2 installs in a different program folder and can be used withoutinterfering with version 1. Note that if you have received an upgrade discount on purchasing version 2, theSetup 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 oncontrolling 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 ifit becomes infected by a virus or if it detects attempts to infect it. If you are sure that your computer hasno viruses and Aid4Mail still doesn't run, please contact us so that we can help you resolve the issue.

Anti-Virus Warnings

Unfortunately, certain anti-virus products – especially those using proactive protection – frequentlygenerate false positives when scanning programs. In other words, they think a file contains a virus orother 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 43 different anti-virusproducts and all showed it to be clean. If you have downloaded the software from our website, our onlinestore, 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 yourcomputer 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 theycan fix the issue in their next maintenance release. Until the issue is fixed, you may be able to white-listthe software that is affected by the false positive, or turn off proactive protection in your anti-virusproduct.

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

Page 14: Aid4Mail3 Manual

Aid4Mail 3 Help7

Copyright © 2005-2013 Fookes Holding Ltd

1.4.1 Setup Command-Line Parameters

The Setup program used for installing Aid4Mail accepts optional command line parameters. These canbe useful to system administrators, and to other programs calling the Setup program.

/SP-Disables the "This will install... Do you wish to continue?" prompt at the beginning of Setup.

/SILENT, /VERYSILENTInstructs Setup to be silent or very silent. When Setup is silent the wizard and the background windoware not displayed but the installation progress window is. When a setup is very silent this installationprogress window is not displayed. Everything else is normal so for example error messages duringinstallation are displayed and the startup prompt is (if you haven't disabled it with the '/SP-' commandline option explained above.)

If a restart is necessary and the '/NORESTART' command isn't used (see below) and Setup is silent, itwill 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.

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 diskwas not found.Any (error) message box displayed before Setup (or Uninstall) could read the command lineparameters.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 executionactions taken during the installation process. This can be a helpful debugging aid. For example, if yoususpect a file isn't being replaced when you believe it should be (or vice versa), the log file will tell you ifthe 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 toexisting files.)The information contained in the log file is technical in nature and therefore not intended to beunderstandable by end users. Nor is it designed to be machine-parseable; the format of the file issubject to change without notice.

/LOG="filename"

Page 15: Aid4Mail3 Manual

General Information 8

Copyright © 2005-2013 Fookes Holding Ltd

Same as /LOG, except it allows you to specify a fixed path/file name to use for the log file. If a file withthe specified name already exists it will be overwritten. If the file cannot be created, Setup will abort withan error message.

/NOCANCELPrevents the user from cancelling during the installation process, by disabling the Cancel button andignoring clicks on the close button. Useful along with '/SILENT' or '/VERYSILENT'.

/NORESTARTInstructs Setup not to reboot even if it's necessary.

/RESTARTEXITCODE=exit codeSpecifies 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. Thisfile 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 filename contains spaces.

/DIR="x:\dirname"Overrides the default directory name displayed on the Select Destination Location wizard page. A fullyqualified pathname must be specified.

/GROUP="folder name"Overrides the default folder name displayed on the Select Start Menu Folder wizard page.

/NOICONSInstructs Setup to initially check the Don't create any icons check box on the Select Start Menu Folderwizard page.

/COMPONENTS="comma separated list of component names"Overrides the default components settings. Using this command line parameter causes Setup toautomatically 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 itsname 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/deselectsome 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:

Page 16: Aid4Mail3 Manual

Aid4Mail 3 Help9

Copyright © 2005-2013 Fookes Holding Ltd

/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 wouldhave otherwise been selected by default.

If UsePreviousTasks is set to yes, the specified tasks will be selected/deselected after any previoustasks 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 neverhappen except under the most unusual of circumstances, such as running out of memory or Windowsresources.

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 userchooses 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-Retry-Ignore box.

Before returning an exit code of 1, 3, or 4, an error message explaining the problem will normally bedisplayed.

Future versions of the Aid4Mail Setup program may return additional exit codes, so applicationschecking the exit code should be programmed to handle unexpected exit codes gracefully. Any non-zeroexit 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 theUninstall Aid4Mail shortcut in the Start menu. Unless mentioned otherwise, there is no need to uninstallyour 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 usefulto system administrators, and to other programs calling the uninstaller program.

Page 17: Aid4Mail3 Manual

General Information 10

Copyright © 2005-2013 Fookes Holding Ltd

/SILENT, /VERYSILENTWhen specified, the uninstaller will not ask the user for startup confirmation or display a messagestating that uninstall is complete. Shared files that are no longer in use are deleted automatically withoutprompting. Any critical error messages will still be shown on the screen. When '/VERYSILENT' isspecified, the uninstallation progress window is not displayed.If a restart is necessary and the '/NORESTART' command isn't used (see below) and '/VERYSILENT' isspecified, the uninstaller will reboot without asking.

/SUPPRESSMSGBOXESInstructs the uninstaller to suppress message boxes. Only has an effect when combined with '/SILENT'and '/VERYSILENT'. See '/SUPPRESSMSGBOXES' under Setup Command Line Parameters for moredetails.

/LOGCauses 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 toexisting 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 beunderstandable by end users. Nor is it designed to be machine-parseable; the format of the file issubject to change without notice.

/NORESTARTInstructs the uninstaller not to reboot even if it's necessary.

1.5 Aid4Mail Editions

Aid4Mail 3 is available in several editions, which are listed below:

Aid4Mail HomeAid4Mail Home is competitively priced, but lacks support for Microsoft Exchange, PDF export, emailfiltering, and scripts. It may only be used to process private mail.

Aid4Mail ProfessionalAid4Mail Professional includes all the main features but lacks forensic-specific capabilities. It may notbe used to process other people's accounts in a forensic or e-discovery context.

Aid4Mail eDiscoveryAid4Mail eDiscovery offers the full set of features and can be activated offline.

Aid4Mail ConsoleAid4Mail Console is based on a command-line interface (CLI), which you can use to automate themigration process through a batch file or other script. Automation can significantly save time andultimately cut costs. The Aid4Mail Console Migrator license, which can either be run from a server orthumb drives, is ideally suited for large-scale email migrations. Due to third-party licensing terms, theserver version of Aid4Mail Console currently does not include the PDF export option.

Aid4Mail Console is included with the Aid4Mail Console Migrator and Aid4Mail eDiscovery Servicelicenses. And it is available as a bundle option with Aid4Mail eDiscovery Forensic, Aid4Mail eDiscoveryArchivist and Aid4Mail eDiscovery Personal.

Page 18: Aid4Mail3 Manual

Aid4Mail 3 Help11

Copyright © 2005-2013 Fookes Holding Ltd

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 mailIndividual or organization migrating professional mailService 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 formatsSupport for Microsoft Outlook MSG and PST filesExport to generic mail formats (mbox and EML)Create non-proprietary ZIP archivesExtract email addresses and attachmentsRebuild proprietary formats to internet standards

Important:This license can only be used in a non-professional context and is not transferable. It can only be usedto process one end-user mail account. A single mail account can consist of several email addressesbelonging to the same person (see definition in EULA). Note that Aid4Mail Home does not supportMicrosoft 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 profileExport to searchable PDF, Excel, and HTMLSave to CSV and database formatsFilter emails by date, keywords, and textScriptable (custom filters and output formats)Can be used in a professional contextCustomer support included in subscription

Important:This license can only be used to process one end-user mail account. A single mail account can consistof several email addresses belonging to the same person (see definition in EULA).

3. Aid4Mail eDiscovery Personal

Page 19: Aid4Mail3 Manual

General Information 12

Copyright © 2005-2013 Fookes Holding Ltd

Same features as Aid4Mail Professional Personal, plus:Process unpurged mailExport to PDF/A formatScripting supports various hash functionsExchange email data with external console programsOffline activationOptional Aid4Mail Console bundle

Important:This license can only be used to process one end-user mail account. A single mail account can consistof 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 formatsSupport for Microsoft Outlook and ExchangeExport to generic mail formats (mbox and EML)Create non-proprietary ZIP archivesExport to searchable PDF, Excel, and HTMLSave to CSV and database formatsExtract email addresses and attachmentsRebuild proprietary formats to internet standardsFilter emails by date, keywords, and textScriptable (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 consistof 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 seatsChoose any number of seats between 3 and 20,000Online 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 ofseveral email addresses belonging to the same person (see definition in EULA).

3. Aid4Mail Console Migrator

Features:Process over 40 mail formats

Page 20: Aid4Mail3 Manual

Aid4Mail 3 Help13

Copyright © 2005-2013 Fookes Holding Ltd

Support for Microsoft Outlook and ExchangeCommand-line interface for faster migrationCan be run from other applications and batch filesCopy to, and run from, a thumb drive or a serverThe server version can be run through a Windows ServiceOption to run unattended (with no user-interaction)Choose any number of seats between 25 and 500,000Does not use online activationIncludes the GUI version of Aid4MailCustomer support included in subscription

Important:This license can only be used for mail migration. It can only be used to process one end-user mailaccount per seat. A single mail account can consist of several email addresses belonging to the sameperson (see definition in EULA).

The following license can also be used instead of Aid4Mail Professional Personal if you require extrafeatures:

4. Aid4Mail eDiscovery Personal

Same features as Aid4Mail Professional Personal, plus:Process unpurged mailExport to PDF/A formatScripting supports various hash functionsExchange email data with external console programsOffline activationOptional Aid4Mail Console bundle

Important:This license can only be used to process one end-user mail account. A single mail account can consistof several email addresses belonging to the same person (see definition in EULA).

1.6.3 Service provider (including e-discovery, forensic-examination, and archivingservices)

The following license is for service providers:

Aid4Mail eDiscovery Service

Features:Process unlimited mail accounts from a single seatProcess over 40 mail formatsSupport for Microsoft Outlook and ExchangeExport to generic mail formats (mbox and EML)Create non-proprietary ZIP archivesExport to searchable PDF, PDF/A, Excel, and HTMLSave to CSV and database formatsExtract email addresses and attachmentsRebuild proprietary formats to internet standardsFilter emails by date, keywords, and text

Page 21: Aid4Mail3 Manual

General Information 14

Copyright © 2005-2013 Fookes Holding Ltd

Scriptable (custom filters and output formats)Process unpurged mailScripting supports various hash functionsExchange email data with external console programsOffline activationBundled with Aid4Mail Console (included in price)Transferable (see EULA terms)Customer support included in subscription

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 migratemail, one of the Aid4Mail Professional licenses or Aid4Mail Console 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 eDiscovery Forensic

Features:Process unlimited mail accounts from a single seatProcess over 40 mail formatsSupport for Microsoft Outlook and ExchangeExport to generic mail formats (mbox and EML)Create non-proprietary ZIP archivesExport to searchable PDF, PDF/A, Excel, and HTMLSave to CSV and database formatsExtract email addresses and attachmentsRebuild proprietary formats to internet standardsFilter emails by date, keywords, and textScriptable (custom filters and output formats)Process unpurged mailScripting supports various hash functionsExchange email data with external console programsOffline activationOptional Aid4Mail Console bundleTransferable (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 aclients (e.g. company offering forensic-examination services). It does not allow for mail migration.

If you are a service provider, you need Aid4Mail eDiscovery Service instead. If you need to migrate mail,one of the Aid4Mail Professional licenses or Aid4Mail Console Migrator would be necessary.

1.6.5 Email archivist (but not a service provider)

The following license is for professional email archivists:

Page 22: Aid4Mail3 Manual

Aid4Mail 3 Help15

Copyright © 2005-2013 Fookes Holding Ltd

Aid4Mail eDiscovery Archivist

Features:Process unlimited mail accounts from a single seatProcess over 40 mail formatsSupport for Microsoft Outlook and ExchangeExport to generic mail formats (mbox and EML)Create non-proprietary ZIP archivesExport to searchable PDF, PDF/A, Excel, and HTMLSave to CSV and database formatsExtract email addresses and attachmentsRebuild proprietary formats to internet standardsFilter emails by date, keywords, and textScriptable (custom filters and output formats)Process unpurged mailScripting supports various hash functionsExchange email data with external console programsOffline activationOptional Aid4Mail Console bundleTransferable (see EULA terms)Customer support included in subscription

Important:This license is for professional email archivists who are not service providers, i.e. who are archiving mailin-house (e.g. a law firm archiving their client mail) and not as part of a service to clients (e.g. companyoffering archiving services).

If you are a service provider, you need Aid4Mail eDiscovery Service instead. If you need to migrate mail,one of the Aid4Mail Professional licenses or Aid4Mail Console 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, includingOutlook MSG and PST files *

Yes Yes Yes Yes

Export/import generic mail formats(mbox and EML)

Yes Yes Yes Yes

Extract email addresses andattachments

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, andHTML files

No Yes Yes Yes

Filter emails by date, keywords, andtext

No Yes Yes Yes

Page 23: Aid4Mail3 Manual

General Information 16

Copyright © 2005-2013 Fookes Holding Ltd

Scriptable (custom filters and outputformats)

No Yes Yes Yes

Script functions offering hash supportand 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 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 eitherOffice Outlook for Windows or Microsoft's free standalone version of MAPI to process messages from/toOutlook PST and MSG files, and MAPI profiles (used to access an Exchange or PST store); you canuse the free standalone version of MAPI or a free 60-day trial version of Outlook if you don't have alicense. Note that the free standalone version of MAPI does not support Unicode PST files. Note alsothat there may be some compatibility issues with Outlook 97.

For help in choosing the appropriate license, see the Which version do I need? topic.

1.8 Trial Mode

When Aid4Mail is operating in Trial mode, it offers all the features available in the selected edition, butwith the following limitations:

A trial-mode information screen is displayed for at least 8 seconds each time you start Aid4Mail.Processing is limited to a maximum of 50 messages per mail folder (*).When exporting to the MHT format, the limit is 10 messages per mail folder (*).A numbered trial tag is added to the subject line of processed messages.Files created by Aid4Mail in Trial mode are for evaluation purposes only and must be destroyed onceevaluation is complete.

(*) If you need to run performance tests on an unlimited number of emails during trial mode, add the /NoLimit switch to your Aid4Mail command line. Using it removes the 50 emails per folder trial limitationand instead replaces all exported subject lines with a trial notice.

When you purchase a license and activate Aid4Mail, all the above limitations are removed.

Important

When using Aid4Mail in Trial mode, only convert email to target test folders and mailbox files. Since bydefault Aid4Mail does not modify or delete your source email, you can safely select existing mail foldersand stores during your tests – except for Outlook 2010 users (see warning below).

Outlook 2010 bugOutlook 2010 had a serious bug that caused data loss in source messages processed with the MAPIRFC 1521 Converter. Original SMTP headers were replaced with a simplified version. For most users theeffects of this bug are not noticeable, or at most a minor inconvenience. However, for those working inthe field of e-discovery and forensic examination such loss of data is unacceptable. We recommend that

Page 24: Aid4Mail3 Manual

Aid4Mail 3 Help17

Copyright © 2005-2013 Fookes Holding Ltd

you download and install the latest maintenance release for Outlook 2010.

1.9 Product Activation

Aid4Mail uses a license activation system to help prevent piracy and protect your investment in oursoftware. 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 notcollect any details about you or your computer although you may optionally enter your email address foreasy 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 usingonline activation. Essentially, your license is tied to your activation code and the password that youdefine. This facilitates re-activating Aid4Mail after reformatting your hard drive, upgrading hardwarecomponents in your computer, logging in under a different user profile, or moving your software to a newcomputer.

Note that the Aid4Mail License Agreement allows the software to be moved from an old computer to anew one that replaces it. However it does not allow a license to be re-activated on a different computeror 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. ForAid4Mail eDiscovery licenses, and some Aid4Mail Console licenses, an offline activation option isavailable.

Once Aid4Mail has been activated, the Trial Mode limitations are removed. If Aid4Mail was activatedonline, 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 ofthe 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 usingAid4Mail. 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 Consolelicenses, it can also be done offline.

If your license subscription period has expired, then Aid4Mail can only be re-activated if the subscriptionis renewed, or if a new subscription is purchased. (License renewal is significantly cheaper than a

Page 25: Aid4Mail3 Manual

General Information 18

Copyright © 2005-2013 Fookes Holding Ltd

corresponding new subscription.)

To ensure compliance with the License Agreement, the number of re-activations allowed in a given timeperiod is limited. If this limit is exceeded, the activation server will perform a lockout and you must waitbefore being allowed to reactivate. Too many failed password attempts can also result in a lockout toprotect your code from theft. Note that software_DNA also includes an anti-fraud system that disablesactivation 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, youcan 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 addresstoo.

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 thesituations 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, youcan 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 "ForgotPassword?" button and your password will be sent to you (as long as you have previously specified anemail address). If it does not arrive within minutes, check your junk mail folder in case it wasmisidentified 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 accessibleto the license administrator through the Softworkz License Control Panel (LCP). The LCP can be usedto manage seats linked to the activation code and change its password. Details on accessing theLCP 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. Confirmthe new password.

5. Click on the "Re-Activate" button.

software_DNA then checks online that the activation code and your password match the information onthe server. If the match is successful, Aid4Mail is re-activated and the new password is stored on thelicense server, replacing the current one. If the match is unsuccessful, re-activation fails and you mustretry. The number of failed password attempts allowed is limited, as is the number of re-activations in agiven time period. Exceeding these limits can result in a lockout.

Page 26: Aid4Mail3 Manual

Aid4Mail 3 Help19

Copyright © 2005-2013 Fookes Holding Ltd

Note that to ensure the re-activation procedure is as quick and simple as possible, we strongly suggestyou 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 yourcomputer 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 ona computer that has restricted or no access to internet. They are also available for some Aid4MailConsole licenses. Offline activation ties your license to the hardware signature of the offline computer.

For Aid4Mail eDiscovery Forensic customers, offline activation and re-activation is free of charge, andcan be set up by the user. For the other Aid4Mail eDiscovery licenses, offline activation is available onrequest and needs to be set up by our customer support staff. There is no charge for initial activation butsubsequent re-activations require payment of a service fee. Please contact us for instructions on how toset up offline activation.

Proxy settings

A "proxy Server" is typically used to block access to the internet by Local Area Network users unlessthey are authenticated with a user name and password. If Aid4Mail resides behind a proxy server theninternet 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 includesthe 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, youcan 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 proxysettings" is not checked, then software_DNA will automatically use the proxy settings of InternetExplorer including any automatic configuration scripts. As long as Internet Explorer has connectivity tothe 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 proxyconfiguration" 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, whichis available from the Check News & Get Updates menu command displayed when you click on theSoftware button. In some cases, the Setup file will be downloadable and installable directly from withinAid4Mail. In other cases, your browser window will open to a download page on our website. A singlemouse click on the update item will start the download to your computer.

Page 27: Aid4Mail3 Manual

General Information 20

Copyright © 2005-2013 Fookes Holding Ltd

If you enable the Check for news updates setting on the News and Updates screen, Aid4Mail willautomatically check our website at regular intervals for updates and other news. No information aboutyou or your computer will be revealed during this operation. If it detects that the news file has beenupdated, Aid4Mail will automatically display its contents on startup. Just click on the link to view a newsitem or download a program update. Note that Aid4Mail needs access to the internet for this feature. Ifyou 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 awarethat some download managers may take over this download process and interfere with normaloperations. When this happens, you may see a prompt from Aid4Mail asking you to click a button oncethe download has been completed. With other download managers, the download may fail altogether. Inthis case, turn off your download manager and try again.

We recommend that you enable the Check for news updates option to keep your Aid4Mail programup-to-date. However, if you prefer to check for updates manually, then use the Update Now button onthe News and Updates screen instead. Updates during the subscription period are available at nocharge. See the Upgrade Policy topic for further details.

Visit our online FAQ for more information about this feature.

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 files1 (*.pst),

Outlook MSG files1 (*.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. Yahoo! Mail, Gmail, Zoho Mail, AOL Mail, FastMail,GMX Mail, Outlook.com, Outlook 365, etc.,Mozilla mailbox files (including Thunderbird, SeaMonkey, Eudora OSE, and Netscape),Apple Mail exported mailbox files,Apple Mail (Mail.app) message files (*.emlx),Qualcomm Eudora mailbox files (*.toc and *.mbx),

Mac Eudora mailbox files2,Generic mailbox files (mbox, Entourage MBOX, 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 files2 (*.msb and *.tbb),PocoMail and Barca mailbox files (*.idx, *.idb, and *.mbx),

FoxMail mailbox files up to version 6.5 2 (*.box),

Opera mailbox files2 (*.mbs),Calypso and Courier archive files,

Forte Agent mailbox files2 (*.idx),

Page 28: Aid4Mail3 Manual

Aid4Mail 3 Help21

Copyright © 2005-2013 Fookes Holding Ltd

Pine mbox files (with limited "From " escaping),

PMMail message files2 (*.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 files1 (*.pst),

Outlook MSG files1 (*.msg) – only if source mail comes from an Outlook profile or Outlook PST andMSG 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 mailformat),EML message files (*.eml),Plain text filesMHT Web Archive files (*.mht) – linked from an HTML index page or an MS Excel Workbook file (notavailable 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 requiresOffice Outlook 32-bit or Microsoft's free standalone version of MAPI. 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 profileor PST file. With Aid4Mail Home, Aid4Mail Professional, and Aid4Mail eDiscovery, the workaround isto first export your emails to the Outlook MSG format, and then re-export those files to your targetformat.

2. Aid4Mail currently cannot retrieve or restore mail status information (unread, read, replied, etc.) forWindows 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 yourmessages with The Bat! to a Generic mailbox format, which Aid4Mail can then process to any of thesupported formats.

4. Aid4Mail currently does not offer tools to convert address books, filters, or account settings from one

Page 29: Aid4Mail3 Manual

General Information 22

Copyright © 2005-2013 Fookes Holding Ltd

format to another.

1.12 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 clientsoftware. However, Outlook Express is a completely different mail program and should not be confusedwith Outlook.

This format option is only available on computers that have a working version of 32-bit Office Outlook forWindows or Microsoft's free standalone version of MAPI.

To reliably export mail into a PST file or MAPI profile, we recommend that you turn on the MAPI RFC1521 Converter option (default setting) and avoid using a version of Outlook older than 2003. Outlookcalendar 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 incompletedata that is of little use.

TNEF emails are a proprietary format used by Microsoft Outlook and Exchange. They are created whenOutlook 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 allmodern mail clients can display correctly. Aid4Mail offers several advanced options to control how TNEFemails are converted. Under default settings, Aid4Mail saves RTF text as a file attachment which can beviewed in Windows Wordpad or Microsoft Word.

The Aid4Mail wizard can only process one PST file at a time. You will need Aid4Mail Console if youwant to process large numbers of PST files unattended. MAPI cannot access PST files that are on read-only media or write protected (Read-Only files). As a result, if the PST file is stored on a CD-ROM orDVD, Aid4Mail will have to make a temporary copy of it in your Windows Temporary folder. If there isinsufficient space on your hard drive, Aid4Mail will not be able to process the contents of your Read-OnlyPST 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 genericmailbox format with the restore folder option, Aid4Mail saves them to a target folder called ROOT. Thisfeature makes it easy to find those orphan messages.

Unlike Aid4Mail Console, the current GUI version of Aid4Mail cannot export a source MAPI profile orPST file to a target MAPI profile or PST file – the workaround is to first export your emails to the OutlookMSG format, and then re-export those files to your target format.

Known Issues:Outlook 2010 had a serious bug that caused data loss in source messages processed with the MAPIRFC 1521 Converter. Original SMTP headers were replaced with a simplified version. For most users theeffects of this bug are not noticeable, or at most a minor inconvenience. However, for those working inthe field of e-discovery and forensic examination such loss of data is unacceptable. We recommend thatyou download and install the latest maintenance release for Outlook 2010.

Aid4Mail is currently a 32-bit program and so does not work with the 64-bit release of Office Outlook2010 and 2013, nor does it work with Click-to-Run installations of Outlook 2010.

Outlook versions prior to Outlook 2003 as well as the free standalone version of MAPI cannot process

Page 30: Aid4Mail3 Manual

Aid4Mail 3 Help23

Copyright © 2005-2013 Fookes Holding Ltd

Unicode PST and MSG files. Aid4Mail will give an error message when you try to open a Unicode PSTfile with a MAPI version that does not support it. Unfortunately, there is no such warning with UnicodeMSG files. Aid4Mail will appear to process them correctly, but a large part of the original email headerfails to convert.

The MAPI subsystem installed in the Internet Mail Only mode (IMO; Outlook 98/2000) is a stub thatprovides minimal MAPI support for the basic functionality of Office Outlook, and might not work properlywith Aid4Mail. How to tell which setup option you have: in Outlook 98/2000 on the Help menu, clickAbout 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 ExtendedMAPI installed.

The current version of Aid4Mail does not support folder and file names with Unicode characters. Anysuch character that doesn't translate to the ANSI character set will be replaced with a substitutioncharacter.

Aid4Mail may not be able to process your PST file if it is damaged or oversized. If you experienceissues, 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 isintended to be a replacement for Outlook Express on Windows XP and Windows Mail on WindowsVista. Unlike Outlook Express, it saves messages as individual EML files. Aid4Mail can read WLM diskfolders and convert locally stored messages to any of the supported output formats. However, the currentversion is not capable of retrieving or setting email status information (unread, read, replied, etc.) Pleasenote that the folder names on disk may not reflect the names you see in WLM.

Before exporting messages to WLM with Aid4Mail, make sure you have configured it with at least onemail 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 startindexing your new folders and messages; during this time the "Unread email" count increasesprogressively. Make sure you give it enough time to complete the task. Sometimes new folders do notappear 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 savesmessages as individual EML files. Aid4Mail can read Windows Mail disk folders and convert themessages to any of the supported output formats. However, the current version is not capable ofretrieving or setting email status information (unread, read, replied, etc.) Please note that the foldernames on disk may not reflect the names you see in Windows Mail.

Before exporting messages to Windows Mail with Aid4Mail, make sure you have configured it with atleast one mail account so that the appropriate target folder is created. You must export your source mailunder the "Local Folders" location. Open Windows Mail once Aid4Mail has completed the transfer.

Page 31: Aid4Mail3 Manual

General Information 24

Copyright © 2005-2013 Fookes Holding Ltd

Windows Mail will start indexing your new folders and messages. Make sure you give it enough time tocomplete the task. Sometimes new folders do not appear immediately under "Local Folders"; thisdisplay 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 incommon, these mail clients are totally unrelated. Their approach to storing mail is completely differentand the file formats that they produce are not interchangeable. Outlook Express only supports SimpleMAPI, 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 Expressinstalled on your computer to do so. Unlike most other conversion programs, Aid4Mail is capable ofretrieving status information (unread, read, replied, etc.) from your messages and restore these in theoutput format.

Outlook Express stores deleted messages in the Deleted Items.dbx file. Unfortunately, it corrupts themessages during this process. Aid4Mail can extract these deleted messages, but it cannot fix corrupteddata. As a result, some messages may exhibit unusual characters or display code that you would notnormally 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. Simplyselect 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 ofyour choice.

5. Thunderbird, SeaMonkey Mail, Eudora OSE, Mozilla Mail, Netscape Messenger

Thunderbird, Mozilla Mail, SeaMonkey, Eudora OSE, and recent versions of Netscape Messenger allshare the same mailbox format, which is very close to the mbox format. The main difference is in theway mail status information (unread, read, replied, etc.) is stored. Aid4Mail can read the Mozilla statusflags 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 orimport 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 (samename as index file but without a file extension). Aid4Mail only processes mailbox files since that iswhere the email messages are stored. As a result, missing or corrupted index files have no negativeinfluence on the quality of email conversions. Note that when the Windows Search Integration option isset 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.

Before exporting messages to any of these mail clients with Aid4Mail, make sure you have configuredthem 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 storagepath length that exceeds 128 characters. If you run into this limit, you can display more folders bymoving the profile or the accounts directory closer to the root of the drive, so that less of the total pathlength is wasted. Another solution is to rename your source mail folders to shorter names beforeconverting them with Aid4Mail.

Page 32: Aid4Mail3 Manual

Aid4Mail 3 Help25

Copyright © 2005-2013 Fookes Holding Ltd

Unless you enabled message synchronization, local mailboxes for IMAP accounts are empty and onlyindex 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 theMozilla Foundation and use a different mailbox format, which is identical to Mozilla Thunderbird (seesection #5 above).

Aid4Mail can read both the Eudora index files (*.toc) and its mailbox files (*.mbx). Mail statusinformation (unread, read, replied, etc.) is stored in the index files, not in the mailbox files. So unlessthey are corrupted or missing, you should always select the *.toc files instead of the *.mbx files toprocess in Aid4Mail.

Eudora creates very compact mailbox files. It does so by extracting attachments and embeddedcontents from messages, and saves these in separate folders. The advantage of this approach is thatmailbox files grow less quickly when you receive mail and attachments are easily accessible throughWindows Explorer or another file manager. The disadvantage of Eudora's approach is that the originalmessage MIME format is lost and the message header information no longer reflects the format of themessage body. Eudora also has a tendency to corrupt its own mailbox files by adding binary charactersthat do not belong there and messing up the message delimiters. Most of the time, the mailbox files thatEudora produces no longer conform to RFC 822 rules. As a result, most mail clients are incapable ofimporting Eudora mail reliably.

Aid4Mail is one of the few programs that is capable of rebuilding email in Eudora mailboxes back to theiroriginal MIME format. It can also fix most corrupted messages. As a result, you can reliably migrateyour 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 thecorresponding 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 locationthrough 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"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 embeddedcontents files are in a different location, see the instructions under the Fixing Attachment FolderReferences 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 astandards-compliant date format. That is because Eudora stores the sent date in the Out.toc file using atext format based on the Windows or Mac short date setting. And over time, with each OS upgrade andmail migration, the date format can change. As a result, it cannot be reliably converted through softwaremethods to a standard format. To work around this issue, Aid4Mail uses the From-delimiter date fromOut.mbx, which uses a standards-compliant date format. Note, however, that this date corresponds tothe time when the email was added to the mailbox. If the email is moved to a different folder, then thedate no longer corresponds to the sent date.

7. Apple Mail (Mac OS X)

Page 33: Aid4Mail3 Manual

General Information 26

Copyright © 2005-2013 Fookes Holding Ltd

Aid4Mail is capable of processing email files stored by all versions of Apple Mail. Since Aid4Mail is aWindows application, it will only run on Intel-based Macs that are running Windows or Wine, and onPowerPC Macs using Virtual PC. We recommend that you run Aid4Mail on a Windows system as it willprocess mail much faster that way.

If you want to migrate your Apple Mail to a Windows email program, first transfer your files from Mac toWindows. You can also copy your Apple Mail folders and files to a CD, DVD, or USB drive, whichAid4Mail can then access from your Windows computer. Aid4Mail can read the MBOX files created byApple Mail 1 (that comes with Mac OS X 10.0 to 10.3) – if that is the format you have, use the "Genericmailboxes" Mail Source option under the "Generic Mailbox Format" section in Aid4Mail. Later versions ofApple 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 inAid4Mail.

To migrate your Windows email messages to Apple Mail, run Aid4Mail on your Windows computer andconvert your mail to the "Generic mailboxes" format, which is listed under the "Generic formats" sectionon the Target Format screen in Aid4Mail. We recommend that you set the "File name" field on theTarget 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.

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 Outlook365. Please note that, at this time of writing, IMAP access to a Yahoo! Mail account is not officiallysupported 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 anddownload up to 2,500 MB of email per day.

9. Generic Mailbox Format

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 arecapable 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 filesare stored in encrypted format so that other programs cannot access them. Before you can processthese messages in Aid4Mail, you must first save your *.box files to Calypso or Courier archives (theseare equivalent the generic mailbox files). To do this, use the Mailbox/Save to Archive menu command inCalypso or Courier and choose the option to save with attachments. Message status information islimited 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 tothe mbox format.

10. Pegasus Mail

Aid4Mail can read both the Pegasus index files (*.pmi) and its mailbox files (*.pmm). Mail statusinformation (unread, read, replied, etc.) is stored in the index files, not in the mailbox files. So unless

Page 34: Aid4Mail3 Manual

Aid4Mail 3 Help27

Copyright © 2005-2013 Fookes Holding Ltd

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 theother mail folders, choose "Pegasus Mail (index)" as the source format and select the folder thatcontains all the Pegasus mailbox files (do not highlight any of the PMI files otherwise Aid4Mail willignore all CNM file). With Aid4Mail Console, simply specify "*.pmi" as your source mail in order toinclude all CNM files during processing.

11. PocoMail and Barca

Aid4Mail can read both the PocoMail/Barca index files (*.idx) and its mailbox files (*.mbx). Aid4Mail onlyreads mail status information (unread, read, replied, etc.) from the index files, not in the mailbox files. Sounless they are corrupted or missing, you should always select the *.idx files instead of the *.mbx files.

PocoMail and Barca offer options to create compact mailbox files. The mail client does so by extractingfile attachments from messages, and saves these in a separate folder. The advantage of this approach isthat mailbox files grow less quickly when you receive mail and attachments are easily accessiblethrough Windows Explorer or another file manager. The disadvantage of this approach is that the originalemail 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 mailboxesback to their original MIME format. As a result, you can reliably migrate your PocoMail/Barca mailwithout 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-insertthem into the corresponding email messages. In such cases, the attachments will show up with nocontents. There is, however, a way to instruct Aid4Mail where to look for attachment folders that havechanged location through a file called Tokens.ini. See instructions under the Fixing Attachment FolderReferences topic.

Before exporting messages to PocoMail or Barca with Aid4Mail, make sure you have configured themwith at least one mail account so that the appropriate target folder is created.

12. The Bat!

Recent versions of The Bat! offer an option to create very compact mailbox files. It does so by extractingfile attachments and embedded contents from messages, and saves these in a separate folder. Theadvantage of this approach is that mailbox files grow less quickly when you receive mail andattachments are easily accessible through Windows Explorer or another file manager. The disadvantageof 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.

If you have deleted or moved extracted The Bat! attachments, Aid4Mail won't be able to re-insert theminto 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 changedlocation through a file called Tokens.ini. See instructions under the Fixing Attachment Folder Referencestopic.

Please note that Aid4Mail cannot process encrypted The Bat! mail files. In this case, you will first haveto export your messages with The Bat! to a Generic mailbox format, which Aid4Mail can then process to

Page 35: Aid4Mail3 Manual

General Information 28

Copyright © 2005-2013 Fookes Holding Ltd

any of the supported formats.

13. Opera Mail

Over the years, Opera's mail client has changed storage format several times. The more recent versionsdo not organize messages in mailboxes with corresponding names. Instead, Opera uses virtualmailboxes that classify messages according to use-defined filters. Aid4Mail does not have the capabilityto interpret Opera filters. As a result, messages are classified according to their nature. Incoming mail isstored in the "Received" mailbox, outgoing mail is exported to the "Sent" mailbox, and Usenetmessages are placed in the "News" mailbox.

Opera only supports the email status Read and Unread. Unfortunately, the current version of Aid4Mailcannot extract this information from the Opera data files.

14. Microsoft Entourage

Aid4Mail does not process Microsoft Entourage's native mail database stores, but it does handle theMBOX file format that Entourage supports.

If you want to migrate your Entourage mail to a Windows email program, first convert your Entouragemail folders to MBOX files. The simplest way to do this is to drag each folder of messages to the Macdesktop. Entourage will automatically create an MBOX file for each folder you drag-and drop to thedesktop. Next, you will have to transfer your MBOX files from Mac to Windows. You can also copy yourMBOX 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 Aid4Mailto 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 Windowscomputer and convert your mail to the "Generic mailboxes" format, which is listed under the "Genericformats" 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 yourMac 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-and-drop the MBOX files to the Entourage folder window.

15. Pine mbox Format (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 variationdoes not escape all occurrences of lines beginning with the "From " delimiter inside the message. As aresult, if a Pine mbox file is processed the same way as a regular generic mailbox file, some messagesmay get split up into smaller parts instead of being treated as a single email. This often producesunusable 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.

Page 36: Aid4Mail3 Manual

Aid4Mail 3 Help29

Copyright © 2005-2013 Fookes Holding Ltd

16. 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 donot have any status information except for those created with Aid4Mail. Note that Foxmail does not storedate information for messages in the out.BOX. As a result, these outgoing messages are exported witha default "unknown" date set to 1 Jan 1972. Also, Aid4Mail cannot restore the FoxMail folder hierarchyand 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 canalso be accessed through Windows Explorer). In most cases, you will first have to download the foldersfrom 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 lossof valuable business information. Download the free report, "Manage Your Email So It Doesn't ManageYou", 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 havethe luxury of telling investigators and litigators to wait until you find what you need. You need toproduce it now.Time-proof your email archives. Long retention periods are becoming the norm, but proprietary archivesmay not be available long-term. Learn how to easily set and observe retention periods, and how toprotect 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'llalways be able to get them back again. Proprietary email archives risk becoming obsolete long beforethe retention period is up.

2. Your email files are highly compressed in standard ZIP files. This saves you a huge amount of roomon 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 themin separate folders inside the archived ZIP file. This way you can easily access attachments andembedded contents without using special utilities.

4. Aid4Mail automatically removes duplicates of attachments and embedded contents. When you havebroadcast the same email with attachments to multiple users, only the original email is archived. Thissignificantly reduces the size of ZIP archives and doesn't return 20 copies of the very same email insearches.

5. Use any storage media you like for your archived email. Aid4Mail can easily read your archive filesfrom any drive that Windows Explorer can access, including CD-ROMs and DVDs, local or networkdrives, hard drives or tape.

6. Supports most of the popular email formats, including Outlook, Mozilla Thunderbird, Eudora, Pegasusand 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.

Page 37: Aid4Mail3 Manual

General Information 30

Copyright © 2005-2013 Fookes Holding Ltd

How to read archived mail

There are several ways you can access and read mail stored in Aid4Mail ZIP archives. The best way isto use Aid4Mail filters to extract just the messages you're looking for. Simply select your ZIP archive asthe source mail, set the filter options so that they find the specific messages you want to view, andchoose an appropriate target format. Select a temporary target folder if you plan to remove the exportedmessages after viewing. An ideal target format is "MHT message files for viewing from Web browser" ifyou 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 filemanager (e.g. Windows Explorer) will normally display the message in a new window created by acompatible email program (Outlook Express, Windows Mail, Thunderbird). Of course, you can alsoexport 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 attachmentsstored as regular files under the Attach folder. If you are looking for pictures or other documents thatwere inserted in the email message, search the Embedded folder instead.

If you do not want to use Aid4Mail to extract messages from your ZIP archive, you can also simplyextract the mbox files with Windows Explore or a ZIP utility, and then view them "raw" in a text editor oran mbox reader (mail client or utility). Fookes Software offers a program called Mailbag Assistant thatcan read mbox files, search messages, and display them for reading.

1.14 Finding Mail Folders

If Aid4Mail cannot find the folder that contains your mail files, you will have to search for them either bybrowsing through your disk folders using the Source Location file browser or the Folder Browser availableon the Target Settings page by clicking on the [•••] button in the Folder field. You might find it helpful touse the Search tool provided by Windows under the Start menu; make sure you enable searchingthrough hidden folders (you may also need to use "Tools | Folder Options | View" in Windows Explorerand select "Show hidden files and folders").

IMPORTANT: If you are exporting mail to a new mail client, the appropriate target folder may only existonce you have set up a profile and/or mail account in it. We recommend that you fully configure yournew 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. Manyprograms 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'sconfiguration. See the topic "Finding the Application Data folder" below for information on where to find it.

Finding the Application Data folder

On Windows 8, 7 and Vista systems, look for<SYSTEMDRIVE>\Users\<user>\AppData\Roamingand 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 Dataand in the case of Microsoft Outlook and Windows Live Mail:

Page 38: Aid4Mail3 Manual

Aid4Mail 3 Help31

Copyright © 2005-2013 Fookes Holding Ltd

<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 Dataand 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 Dataand 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. Onan NT system or a Windows 98 system with user profiles, mail files will probably be located by default inthe second set of Application Data folders.

1. Microsoft Outlook

Typical default location:<Application Data>\Microsoft\Outlook\<Documents>\Outlook Files\

File to search for:Outlook.pst

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-4032-AB71-B48918A73052}. The specific numbers and letters is different on every system.

Files to search for with Outlook Express 5.x and 6.x:Inbox.dbxSent Items.dbxDeleted Items.dbx

Files to search for with Outlook Express 4.x:Inbox.idxSent Items.idxDeleted Items.idx

3. Windows Live Mail

Typical default location:<Application Data>\Microsoft\Windows Live Mail\

Page 39: Aid4Mail3 Manual

General Information 32

Copyright © 2005-2013 Fookes Holding Ltd

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 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.tocOut.tocTrash.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.msfSent.msfTrash.msf

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 Thunderbirdversion 3, choose Properties from the menu and then select and copy all the text in the Location field ofthe Folder Properties dialog box. In Thunderbird version 2, choose the "Copy Folder Location" commandfrom the shortcut menu.

If you want to set Thunderbird as your source mail client, stop when you reach the Source Locationscreen in Aid4Mail. Then right click in the folder field and choose the "Go to Folder" command from theshortcut 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 screenin Aid4Mail. Paste the Clipboard contents in the field labeled Folder. The resulting path will look

Page 40: Aid4Mail3 Manual

Aid4Mail 3 Help33

Copyright © 2005-2013 Fookes Holding Ltd

somewhat like this: "mailbox:///C:/Users/.../Mail/Local Folders/Inbox" or "mailbox:/C|/Documents andSettings/.../Mail/Local Folders/Inbox". Once you click on the Next button, Aid4Mail will automaticallyconvert 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.msfSent.msfTrash.msf

8. Netscape Messenger

Possible default location:<SYSTEMDRIVE>\Program Files\Netscape\Users\

Files to search for:Inbox.snmSent.snmTrash.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 8/7/Vista/XP/2000:<Application Data>\PocoMail\Mail\<Application Data>\Barca\Mail\

Typical default locations, Windows 95/98/ME/NT:<SYSTEMDRIVE>\Program Files\PocoMail\Mail\<SYSTEMDRIVE>\Program Files\Barca\Mail\

Files to search for:in.idx or in.idbOut.idx or Out.idbTrash.idx or Trash.idb

11. The Bat!

Typical default locations:<Application Data>\The Bat!\

Page 41: Aid4Mail3 Manual

General Information 34

Copyright © 2005-2013 Fookes Holding Ltd

Typical default location:<SYSTEMDRIVE>\Program Files\The Bat!\MAIL\

Files to search for:MESSAGES.TBBMESSAGES.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.IDXGROUPS.DATfolders.dat

16. Foxmail

Typical default location:<SYSTEMDRIVE>\Program Files\FoxMail\mail\<SYSTEMDRIVE>\Users\<USER>\AppData\Local\Foxmail\Data\Boxes\

Files to search for:in.BOXsent.BOXtrash.BOX

Page 42: Aid4Mail3 Manual

Aid4Mail 3 Help35

Copyright © 2005-2013 Fookes Holding Ltd

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 FAQProduct Activation FAQGeneral Aid4Mail FAQOffice Outlook FAQUsing 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 online order page. We have no local dealers. Our software is soldworld-wide by cleverbridge, a leading e-commerce company. Cleverbridge is under contract with FookesSoftware 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, purchaseorder.

Q. I have a license for Aid4Mail version 1. How do I get an upgrade discount for the latestversion?

If you have a valid license for Aid4Mail version 1, you can benefit from a significant upgrade discountwhen purchasing a corresponding license of version 3. Simply visit our upgrade page and enter eitherone of your activation codes or your Plimus order number. Please note that you can only use thisupgrade 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 companyletterhead. You will receive the cleverbridge fax number in a later step. If you require immediate productdelivery, please use the credit card or PayPal payment option instead.

Page 43: Aid4Mail3 Manual

General Information 36

Copyright © 2005-2013 Fookes Holding Ltd

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 willbe taken to a page with detailed instructions, including your order reference number and the bank detailsfor your payment.

Q. I have purchased an Aid4Mail license but still haven't received my activation code. Whenwill I get it?

A. All information regarding your order, including activation code(s), are sent to you via email – usuallywithin minutes of your payment being accepted. However, sometimes these emails may be caught byyour "Spam Protection" tool, or may be automatically sent to your "Junk" folder. Please be sure tocheck 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 severalhours are possible in these situations. In other cases, your ISP may be blocking the emails before theyeven reach your account. When this happens, the only solution is for you to provide an alternativeaddress 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 yourcompleted 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 yourcredit card bank has declined the transaction, usually a quick call to your credit card bank's customerservice 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.When your annual subscription period runs out, you will have the option to renew it at a significantdiscount over the regular price.

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) areblocking Aid4Mail's access to the internet. Make sure that all your firewalls allow both Aid4Mail.exe andDNA.dll to reach the activation server. If you are accessing the internet through a Proxy server andyou've configured the Aid4Mail proxy settings, make sure these are valid. If you are not using InternetExplorer as your browser, it may be configured with invalid proxy settings; unchecking the "Use IE proxyconfiguration" option in the Proxy Settings screen could help resolve the connection issue.

Page 44: Aid4Mail3 Manual

Aid4Mail 3 Help37

Copyright © 2005-2013 Fookes Holding Ltd

It is also possible that a connection fails because of heavy internet traffic. The only solution in this caseis 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 surethat you uncheck the option labeled "Block all incoming connections" (Windows Vista) or "Don't allowexceptions" (Windows XP); you will find the option in the Windows Firewall settings window which opensfrom the Control Panel. If this setting is enabled, you are not notified when Windows Firewall blocksprograms, and programs on the Exceptions list are ignored.

Q. Can I activate Aid4Mail v2 or v3 with my activation code from v1?

A. No. Aid4Mail version 2 and 3 use different activation codes from those of version 1.

If you have a valid license for Aid4Mail version 1, you can benefit from a significant upgrade discountwhen purchasing a corresponding license of version 3. Simply visit our upgrade page and enter eitherone 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 createdduring the subscription period. If you have an annual subscription, you will have the option to renew it ata significant discount over the regular price.

Q. I am having problems activating my license under Windows 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 andpassword. Why?

A. This usually happens because the character case of the entered password does not match the caseof the original password. Check that your Caps Lock key isn't engaged while you are entering yourpassword. 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. Anotherpassword-related problem is when you try to re-activate your license with a new password that you havealready used before. Make sure that the password you type in the "New Password" field has never beenused before in Aid4Mail.

In some rare cases when internet traffic is high, the connection to the license server may time out.When this happens, Aid4Mail may display the Activation screen instead of the Re-activation screen. Ifthis 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 codesA. If you can't remember your password, click on the "Forgot Password?" button in the Activation dialogbox, which appears on the screen after you enter your activation code. Your password will then be sentto the email address you entered when you first activated your license. If the email doesn't reach youwithin 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 yourlicense. If you chose not to provide an email address during activation, then it is your responsibility to

Page 45: Aid4Mail3 Manual

General Information 38

Copyright © 2005-2013 Fookes Holding Ltd

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 SoftworkzLicense Control Panel (LCP). Details on accessing the LCP are sent by email to the address entered onactivating 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 manyunsuccessful communications with the license server (e.g., because of failed password attempts) in theallowed time period. Note that the Aid4Mail License Agreement allows the software to be moved froman old computer to a new one that replaces it. However it does not allow a license to be re-activated ona 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 LicenseAgreement to ensure that you are complying to its terms.

Q. Will Aid4Mail activations still be possible if softWORKZ or Fookes Software suspendsservice?

A. If softWORKZ or Fookes Software suspends service, customers will be able to download a patch thatbypasses the activation system or a special version of Aid4Mail that does not use any activationsystem.

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 ofyour subscription period.

Q. Do hardware upgrades/new computers cause the previously activated software to stopworking?

A. No. License activation is not tied to your hardware. If you need to reinstall your software afterreformatting your hard drive or moving to a new computer, you just need to re-activate your software. Re-activation is a quick and simple method to get your software fully operational again. Note, however, thatthe copy on your previous computer will revert to trial mode if you re-activate your code on anothercomputer.

Q. Aid4Mail will reside on computers that are not permitted access to the internet via ourfirewall. Can you provide the port, IP-address of the verification server, and the domain inwhich that server resides. This way we may permit outbound access to just the activation siteand 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)

Page 46: Aid4Mail3 Manual

Aid4Mail 3 Help39

Copyright © 2005-2013 Fookes Holding Ltd

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, useAid4Mail to convert your source mail to the Aid4Mail ZIP Archive format. Next, transfer the resulting ZIPfile to your new computer and install Aid4Mail on it; then re-activate your license. Finally, use Aid4Mailon your new computer to export your ZIP Archive contents to your new mail program.

Q. Aid4Mail fails to convert some or all of my mailbox files. Why?

A. The most typical reason for such an issue is that your file is locked by another program. To avoidthis, and unless you are using Office Outlook, make sure you close your mail client before clicking onthe Start button in Aid4Mail. Check also that you haven't got an anti-virus or anti-spam programmonitoring the mail that Aid4Mail is processing. Other possible reasons include a source file that iscorrupted or does not correspond to the selected mail type, or the target location has insufficient freespace or is write protected. Sometimes it may help to compact your mail folders before processing themwith Aid4Mail.

Aid4Mail checks both the file extension and contents to see if they conform with the selected sourceformat. You can instruct Aid4Mail to be more "tolerant" with certain file types by turning off the Strict FileFormat Check option or using the /m command-line switch. This can be useful with files that start with anon-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 (IMAPaccount) 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 exampleOutlook), 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 theprocess, 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 yourmessages can grow very big. Outlook 2003 and 2007 can store up to 20 GB of data in a single file usingthe Unicode PST format, and Outlook 2010 and 2013 up to 50 GB. Older versions of Microsoft Outlookcreate ANSI PST files that are limited to 2 GB in size (note that Aid4Mail cannot detect when this sizelimit 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 4GB. An Aid4Mail ZIP archive can easily exceed a size of 20 GB; in fact the maximum file size is limitedonly by your system's resources.

Q. Why do I see my own email address instead of the recipient details after exporting my Sentfolder?

A. Most mail programs and webmail interfaces check the folder location of a message to determinewhich field to use for the contact details. For mail stored in the default Sent folder, the recipient detailsare taken from the email To, Cc, and Bcc fields. And for mail stored in any other folder, the senderdetails are taken from the email From field. To correct this display issue, simply move your outgoingemails to the default Sent folder.

Page 47: Aid4Mail3 Manual

General Information 40

Copyright © 2005-2013 Fookes Holding Ltd

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

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 othersoftware/plugin that monitor email messages, turn them off temporarily when using Aid4Mail. Doing socan significantly improve processing speed. You can also speed up processing by unchecking the "Donot add duplicate messages" setting on the Export Options screen or, if you are running Aid4MailConsole, avoid using the /SkipDups and /SkipAllDups command-line switches.

Aid4Mail does extensive text parsing and format analysis when reading generic mailbox files, includingthose created by Mozilla Thunderbird and Eudora. It does so to ensure it doesn't miss any emails whenprocessing mailbox files that contain a mix of storage formats (e.g. a Mac or Unix mbox file imported inWindows Thunderbird with new messages added to it). If you are processing mailbox files that areentirely created by a single mail client, then you can increase performance without sacrificing reliabilityby 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 mailfrom Outlook PST and MSG files, and Exchange server stores. The advantage of this method is that itconverts messages with non-Latin characters and certain special email types more reliably than theAid4Mail method. The disadvantage of the internal MAPI converter is that it is usually slower thanAid4Mail'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 fastermethod 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 beenremoved) can also improve conversion speed significantly. If you are responsible for migrating mailaccounts in your company, you should encourage staff members to compact their mail folders beforeyou 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 containdata that does not match the selected source file type.

Also, certain proprietary file formats, like DBX files from Outlook Express and PST files from OfficeOutlook, 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

Page 48: Aid4Mail3 Manual

Aid4Mail 3 Help41

Copyright © 2005-2013 Fookes Holding Ltd

Thunderbird version 3 and 5, choose Properties from the menu and then select and copy all the text inthe Location field of the Folder Properties dialog box. In Thunderbird version 2, choose the "Copy FolderLocation" command from the shortcut menu.

If you want to set Thunderbird as your source mail client, stop when you reach the Source Locationscreen in Aid4Mail. Then right click in the folder field and choose the "Go to Folder" command from theshortcut 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 screenin Aid4Mail. Paste the Clipboard contents in the field labeled Folder. The resulting path will looksomewhat like this: "mailbox:///C:/Users/.../Mail/Local Folders/Inbox" or "mailbox:/C|/Documents andSettings/.../Mail/Local Folders/Inbox". Once you click on the Next button, Aid4Mail will automaticallyconvert 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 folderpath in the "Local directory" field. Note that you should not choose that location as your targetdestination for converted emails.

Q. After exporting my messages to Thunderbird, I find that some of my mail folders aremissing. Why?

A. Prior to version 3, Thunderbird has a bug that makes it fail to display mail folders that have a storagepath length that exceeds 128 characters. If you run into this limit, you can display more folders bymoving the profile or the accounts directory closer to the root of the drive, so that less of the total pathlength is wasted. Another solution is to rename your source mail folders to shorter names beforeconverting them with Aid4Mail.

Q. Why do exported EML and MSG file have the current date stamp instead of the originalemail date?

A. This problem is usually caused by the Windows file indexing feature, which updates the file datestamp 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 andMSG)?

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, anduncheck 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 currentfolder) and then drag them into the Outlook Express application window and drop them into the mailfolder of your choice.

Q. The CSV file I created with Aid4Mail does not display correctly in Microsoft Excel. Why?

Page 49: Aid4Mail3 Manual

General Information 42

Copyright © 2005-2013 Fookes Holding Ltd

A. Microsoft Excel cannot handle cell data that exceeds 32 KB. Excel will split any email that exceedsthe data size limit into smaller chunks and spread them across several columns. As a result, columnswill contain incorrect data in certain rows.

Note that Excel does not recognize CSV files using the UTF-8 text encoding unless the data isproceeded with a byte order mark (BOM) encoding signature. If you open a UTF-8 encoded CSV file thatlacks 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?

A. This issue is due to a bug in Internet Explorer. When you click on an attachment link in an MHT fileto save the document to disk, Internet Explorer displays an incorrect file name in the Save As dialogbox. You should replace it with a more meaningful name and especially add the appropriate fileextension. (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 aremissing or failed to convert as expected. Why?

A. Some mail clients extract attachments and store them in a separate location from messages. This isthe case with Eudora and Calypso/Courier, as well as with The Bat!, PocoMail, and Barca, depending onthe settings you've chosen. These mail clients usually store the path and file name of extractedattachments to maintain a link between the message and its files. Unfortunately, if you move theattachments 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 theattachment, Aid4Mail still adds the file placeholder; instead of the file data Aid4Mail inserts the full nameof the file that was not found. Note that some programs may show an incorrect attachment size forempty 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 fordetails.

There is, however, a way to instruct Aid4Mail where to look for attachment folders that have changedlocation through a file called Tokens.ini. See instructions under the Fixing Attachment Folder Referencestopic.

Q. How does Aid4Mail detect duplicates?

A. Aid4Mail checks for email duplicates by comparing the value of the Message-ID field in eachprocessed email header. If this field is empty or missing (usually in outbound messages), Aid4Mail usesother 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 othertypes of messages, Aid4Mail uses the email date and subject line for the comparison, or other headerfields (To, Cc, Bcc, From delimiter) if either of those values are missing, or the whole header if none ofthose fields contain any data.

When extracting attachments and other embedded contents, Aid4Mail first checks if a file with the samename exists in the target folder. If there is, it checks whether the contents are identical. If they are, theduplicate is not saved. If the files are different, then Aid4Mail saves the file with a new name – theoriginal file name followed by an index number in square brackets. Example:

Untitled.docUntitled[1].doc

Page 50: Aid4Mail3 Manual

Aid4Mail 3 Help43

Copyright © 2005-2013 Fookes Holding Ltd

Untitled[2].doc

Q. Sometimes my source email client reports more and sometimes less messages than thetarget email client. How am I gaining messages or loosing mail during the conversion? Whydoesn'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 duplicatesand/or ignore deleted mail checked which would result in fewer message in the target mailbox. Yoursource email client may have duplicated messages in its mailboxes causing the mismatch of the emailmessage count. Secondly, some mailboxes get corrupted at the place which marks the start of the nextmessage (the email delimiter) in the mailbox. If that line is corrupt, the next message in the mailboxmay 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, Aid4Mailattempts to correct some corrupted mailboxes which often also causes an email message countdifference.

Q. Some of my message status flags, the icons in the index message grid, that are in thesource email client do not show up in the target email client and some are different. Are thesebugs?

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 thetarget email client. All status flags are not all supported in all email programs, therefore, some may notshow up in the target email client. We also found that some email clients have glitches in them thatcause incorrect status icons to be displayed in their own program. Aid4Mail converts the correct datafound in the email client's index file (or mailbox) where the status information is stored to the target emailclient that displays them correctly which causes the discrepancy in the two. Aid4Mail does not convertemail messages based on the status icon displayed, nor does it make the target email client display thesame wrong status icon/indicator.

If you feel that the problem you see is within Aid4Mail, and not the email client, please contact us andexplain to us the problem you are experiencing. We may then ask you to send us a sample mailbox fileor messages if the need arises.

Q. When exporting messages to put on a CD-ROM you recommend using the MD5 file namingoption to limit the length of file names and avoid name conflicts. However, sometimes I like toopen specific MHT email files or EML email messages. It's difficult to do so with themeaningless MD5 names (mixed letters and numbers). How can I locate the messages I want toopen 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 NoteTabtext and HTML editor has such a feature called Search Disk that will find the search criteria in themessages that contain it and open each message(s) (of choice) in its own tab. You can then simply usethe Find dialog (Ctrl+F) and quickly bring the tab in focus at the word(s) searched for. NoteTab isavailable in free and commercial versions.

Q. When making EML, MHT, and MSG message files and the "Subject:" of the message is usedas 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 themailbox(es) into EML, MHT, and MSG files. Character conversion can be customized through a

Page 51: Aid4Mail3 Manual

General Information 44

Copyright © 2005-2013 Fookes Holding Ltd

specialized template file called NameFilter.dat. Open the file NameFilter.txt for instructions and aworking 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 arenot in that folder. It just has an appearance of the messages. The "messages" act sort of like ashortcuts so that when you see the messages in the index grid and click on one, it is actually openingthe message from another PocoMail mailbox. If you convert all your mailboxes, the messages willindeed be processed! If you know which mailbox(es) they are actually stored in, you can process it andthe 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. Suchfolders 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 a 32-bit editions of Office Outlook for Windows or Microsoft's free standalone version ofMAPI is correctly installed on your system. Aid4Mail cannot process MAPI mail accounts, PST, andMSG files if Extended MAPI is not available. For more details, free options, and limitations, see thesystem requirements.

Unlike Aid4Mail Console, the current GUI version of Aid4Mail cannot export a source MAPI profile orPST file to a target MAPI profile or PST file – the workaround is to first export your emails to the OutlookMSG 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 doesnot have Office Outlook?

A. If you still have your old computer with Office Outlook, first install Aid4Mail on it and activate yourlicense. Then convert your Outlook mail to the Aid4Mail ZIP Archive format. Next, transfer the resultingZIP file to your new computer and install Aid4Mail on it; then re-activate your license. Finally, useAid4Mail 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 freesolutions.

2. You are using the 64-bit version of Outlook 2010 or 2013. Install the 32-bit MSI edition to fix thisissue (Windows 64-bit with Outlook 32-bit works fine).

3. You have an Outlook 2010 Click-to-Run installation. Re-install without the Click-to-Run method ifavailable.

4. You are trying to access a Unicode PST file with a MAPI system that does not support the newformat.

Page 52: Aid4Mail3 Manual

Aid4Mail 3 Help45

Copyright © 2005-2013 Fookes Holding Ltd

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 copyof Outlook is not the default email client. In that case, see if temporarily setting it as the default clientfixes the issue and restart Aid4Mail. To change the default email client, open the Internet Propertiesdialog box. (This can be done either by right-clicking on the Internet Explorer program shortcut andselecting "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 fieldlabeled 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 theTarget Format screen. Why?

A. Unlike Aid4Mail Console, the current GUI version of Aid4Mail cannot export a source MAPI profile orPST file to a target MAPI profile or PST file – the workaround is to first export your emails to the OutlookMSG 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 formatinstead 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. [email protected]). To do so, Aid4Mail searches through all your address books (as listed inthe Addressing configuration of your Outlook profile) for a case-insensitive exact match of the X.400address. The X.400 to SMTP conversion fails if there is no match or if the matching contact item doesnot 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 theinformation necessary for the X.400 to SMTP conversion is stored in an external list (GAL or otherdirectory service), then first create an Outlook profile that is connected to your directory service (useLDAP 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 SentItems folder). With incoming messages, Aid4Mail restores the original SMTP email header whichnormally 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 toolsto 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):

Page 53: Aid4Mail3 Manual

General Information 46

Copyright © 2005-2013 Fookes Holding Ltd

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 or 2013, check whether you have the 32 or 64-bit version installed.Aid4Mail currently only supports the 32-bit version. Note also that Click-to-Run installations of Outlook2010 are not supported. If your version of Microsoft Outlook is older than Outlook 2003, this issue mayoccur because your copy of Outlook is not the default email client. In that case, see if temporarilysetting 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 InternetExplorer 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 "MicrosoftOffice 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 occurswith Microsoft Office 2007 Service Pack 2. It appears modifications made in Office 2007 SP2 affectfeatures that worked unchanged since Outlook 97. Microsoft have now fixed the problem so the solutionis 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 mailto 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 creatingtarget folder names. However, we have found that with some versions of Outlook the problem disappearsafter rebooting the computer. If this does not help, try renaming the source mail folder that is causing theproblem.

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 clientis set to a program that does not support Extended MAPI. If that is the case, go to the Internet ExplorerProperties and select the Programs tab; then select "Microsoft Office Outlook" or ExchangeMAPI in theE-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 MicrosoftOutlook. Older versions of Outlook may use slightly different names for the menu command. Note that Unicode PST files created with Outlook 2003, 2007, 2010, and 2013 cannot be opened with an olderversion of Outlook.

Page 54: Aid4Mail3 Manual

Aid4Mail 3 Help47

Copyright © 2005-2013 Fookes Holding Ltd

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 formessages in the Sent Items folder, and the server Received date and the contact name from the Fromfield for messages in other folders. As a result, you may see unexpected dates and names in the FolderPane 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 quickestway to do this is press the Ctrl+A keyboard shortcut to select all the messages in a folder, then use theCtrl+Shift+V keyboard shortcut to open the Move to Folder dialog box, and then select the Sent Itemsfolder in the list.

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 astub that provides minimal MAPI support for the basic functionality of Office Outlook, and may not workproperly 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 2000mode 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 orWorkgroup", 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 othersoftware/plugin that monitor email messages, turn them off temporarily when using Aid4Mail. Doing socan significantly improve processing speed. You can also speed up processing by unchecking the "Donot add duplicate messages" setting on the Export Options screen or, if you are running Aid4MailConsole, avoid using the /SkipDups and /SkipAllDups command-line switches.

Aid4Mail does extensive text parsing and format analysis when reading generic mailbox files, includingthose created by Mozilla Thunderbird and Eudora. It does so to ensure it doesn't miss any emails whenprocessing mailbox files that contain a mix of storage formats (e.g. a Mac or Unix mbox file imported inWindows Thunderbird with new messages added to it). If you are processing mailbox files that areentirely created by a single mail client, then you can increase performance without sacrificing reliabilityby 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 mailfrom Outlook PST and MSG files, and Exchange server stores. The advantage of this method is that itconverts messages with non-Latin characters and certain special email types more reliably than theAid4Mail method. The disadvantage of the internal MAPI converter is that it is usually slower thanAid4Mail'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 fastermethod 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 beenremoved) can also improve conversion speed significantly. If you are responsible for migrating mailaccounts in your company, you should encourage staff members to compact their mail folders before

Page 55: Aid4Mail3 Manual

General Information 48

Copyright © 2005-2013 Fookes Holding Ltd

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 beable to open a Unicode PST. If you are using Outlook 2003 or a later version then select the root folder ofthe PST file, in the Outlook Mail list column. Right-click on the folder, and choose Properties from themenu. From the Properties dialog box, click on the Advanced button to open the Personal Folders dialogbox. This contains a field called Format. If it shows "Personal Folders File (97-2002)", then the file is anANSI PST, otherwise it is a Unicode PST.

Q. My mail is stored on an IMAP server, which Office Outlook connects to. Why is Aid4Mail onlyexporting message headers?

A. You need to configure Outlook to download the complete email, not just the header. To make thechange, 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. Onceyou'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 boxusing 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 MAPIRFC 1521 Converter. Original SMTP headers were replaced with a simplified version. For most users theeffects of this bug are not noticeable, or at most a minor inconvenience. However, for those working inthe field of e-discovery and forensic examination such loss of data is unacceptable. We recommend thatyou download and install the latest maintenance release for Outlook 2010.

Aid4Mail is currently a 32-bit program and so does not work with the 64-bit release of Office Outlook2010 and 2013, nor does it work with Click-to-Run installations of the Outlook 2010 32-bit version.

Outlook does not support email messages with invalid information (for example with a malformed emailaddress). Unfortunately, Aid4Mail does not receive an error message from Outlook when it fails to importsuch 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 itcontains an invalid recipient."

Outlook versions prior to Outlook 2003 as well as the free standalone version of MAPI cannot processUnicode PST and MSG files. Aid4Mail will give an error message when you try to open a Unicode PSTfile with a MAPI version that does not support it. Unfortunately, there is no such warning with UnicodeMSG files. Aid4Mail will appear to process them correctly, but a large part of the original email headerfails to convert.

To reliably export mail into a PST file or MAPI profile, we recommend that you turn on the MAPI RFC1521 Converter option (default setting) and avoid using a version of Outlook older than 2003. Outlookcalendar 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 incompletedata that is of little use.

TNEF emails are a proprietary format used by Microsoft Outlook and Exchange. They are created when

Page 56: Aid4Mail3 Manual

Aid4Mail 3 Help49

Copyright © 2005-2013 Fookes Holding Ltd

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 allmodern mail clients can display correctly. Aid4Mail offers several advanced options to control how TNEFemails are converted. Under default settings, Aid4Mail saves RTF text as a file attachment which can beviewed in Windows Wordpad or Microsoft Word.

The current version of Aid4Mail does not support folder and file names with Unicode characters. Anysuch character that doesn't translate to the ANSI character set will be replaced with a substitutioncharacter.

The MAPI subsystem installed in the Internet Mail Only mode (IMO; Outlook 98/2000) is a stub thatprovides minimal MAPI support for the basic functionality of Office Outlook, and might not work properlywith Aid4Mail. How to tell which setup option you have: in Outlook 98/2000 on the Help menu, clickAbout 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 ExtendedMAPI installed.

The following applies only if you are using a version of Outlook that is older than Outlook 2003, or whenunchecking 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. Werecommend 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-Latincharacter set (like Cyrillic and Chinese). Converting such messages to or from Microsoft Outlook mayproduce unexpected results. Furthermore, MAPI does not support Unicode attachment file names soAid4Mail 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 wayis to use Aid4Mail filters to extract just the messages you're looking for. Simply select your ZIP archiveas the source mail, set the filter options so that they find the specific messages you want to view, andchoose an appropriate target format. Select a temporary target folder if you plan to remove the exportedmessages after viewing. An ideal target format is "MHT message files for viewing from Web browser" ifyou 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 filemanager (e.g. Windows Explorer) will normally display the message in a new window created by acompatible email program (Outlook Express, Windows Mail, Thunderbird). Of course, you can alsoexport 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 attachmentsstored as regular files under the Attach folder. If you are looking for pictures or other documents thatwere inserted in the email message, search the Embedded folder instead.

If you do not want to use Aid4Mail to extract messages from your ZIP archive, you can also simplyextract the mbox files with Windows Explore or a ZIP utility, and then view them "raw" in a text editor oran mbox reader (mail client or utility). Fookes Software offers a program called Mailbag Assistant that

Page 57: Aid4Mail3 Manual

General Information 50

Copyright © 2005-2013 Fookes Holding Ltd

can read mbox files, search messages, and display them for reading.

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 Macsusing Virtual PC. However, we do recommend that you try Aid4Mail first before purchasing a license toensure 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. SinceAid4Mail 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 Windowssystem 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 toWindows. You can also copy your Apple Mail folders and files to a CD, DVD, or thumb drive, whichAid4Mail can then access from your Windows computer. Aid4Mail can read the MBOX files created byApple Mail 1 (that comes with Mac OS X 10.0 to 10.3) – if that is the format you have, use the "Genericmailboxes" mail source option under the "Generic Mailbox Format" section in Aid4Mail. Later versions ofApple 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 inAid4Mail.

To migrate your Windows email messages to Apple Mail, run Aid4Mail on your Windows computer andconvert your mail to the "Generic mailboxes" format, which is listed under the "Generic formats" sectionon the Target Format screen in Aid4Mail. We recommend that you set the "File name" field on theTarget 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 withOutlook for Windows. Outlook 2001 and 2011 for Mac can read PST files created by Outlook forWindows. So if you have access to a Windows system, you can use Aid4Mail to export your mail to aPST 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 theMBOX file format that Entourage supports.

If you want to migrate your Entourage mail to a Windows email program, first convert your Entouragemail folders to MBOX files. The simplest way to do this is to drag each folder of messages to the Macdesktop. Entourage will automatically create an MBOX file for each folder you drag-and drop to thedesktop. Next, you will have to transfer your MBOX files from Mac to Windows. You can also copy yourMBOX files to a CD, DVD, or thumb drive, which Aid4Mail can then access from your Windowscomputer. Use the "Generic mailboxes" mail source option under the "Generic Mailbox Format" section

Page 58: Aid4Mail3 Manual

Aid4Mail 3 Help51

Copyright © 2005-2013 Fookes Holding Ltd

in Aid4Mail to select your MBOX files and then choose the appropriate target email format when youreach the Target Format screen.

To migrate your Windows email messages to Microsoft Entourage, run Aid4Mail on your Windowscomputer and convert your mail to the "Generic mailboxes" format, which is listed under the "Genericformats" 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 yourMac 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-and-drop 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 Eudoramailbox files. Since Aid4Mail is a Windows application, it will only run on Intel-based Macs that arerunning Windows or Wine, and on PowerPC Macs using Virtual PC. We recommend that you runAid4Mail on a Windows system as it will process mail much faster that way.

To migrate your Mac Eudora messages to a Windows email program, first transfer your files from Mac toWindows. You can also copy your Mac Eudora mailbox files to a CD, DVD, or thumb drive, whichAid4Mail can then access from your Windows computer. Use the "Mac Eudora" mail source optionunder the "Eudora" section in Aid4Mail to select your mailbox files and then choose the appropriatetarget 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 sharethe same parent folder. If your attachment and embedded contents files are in a different location, seethe instructions under the Fixing Attachment Folder References topic.

2 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 thedesired format and location. The wizard screens are divided into three parts. The top of the programwindow displays an information area that provides a short explanation about the current screen. Thebottom part of the screen includes the navigation buttons (Back, Next) and the status bar. The middlepart 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 thecurrent context.

Aid4Mail Buttons

SoftwareThis button gives you access to a drop-down menu with commands to check for software updates, ashortcut to visit the Aid4Mail homepage on the web, a link to the Help topic with information aboutordering an Aid4Mail license, a shortcut to the Aid4Mail order page on the web, commands to activateAid4Mail, and advanced options.

Page 59: Aid4Mail3 Manual

Reference Information 52

Copyright © 2005-2013 Fookes Holding Ltd

BackUse this button to move to the previous screen.

NextUse this button to move to the next screen. This button may be disabled if your settings are incomplete.

StartClick on the Start button to begin processing your mail.

CancelUse this button to quit the Aid4Mail program, or cancel the current operation like mail processing or afile download in the "News and Updates" screen.

HelpClick to open the Help window.

Wizard Screens

1. Mail Source2. Source Location3. MAPI Store4. Source MAPI Folders5. Source IMAP Folders6. Filter Options7. Target Format8. Target Settings9. Target MAPI Folder10. Target IMAP Folder11. Export Options12. Start Processing Mail

2.2 Accessibility Mode

Aid4Mail has been developed with accessibility in mind. All program features are accessible through thekeyboard. Furthermore, Aid4Mail detects whether Windows is set to High Contrast mode and whether ascreen reader is running. In these situations, Aid4Mail starts up in a special Accessibility Mode thataffects the display of menus as well as the selection of the first control receiving input focus when thewizard screen changes or a dialog is opened. The text "Accessibility Mode" appears in the program titlebar when it is turned on.

Aid4Mail includes configuration files for the three most popular screen readers: Dolphin Hal, JAWS forWindows, and Window-Eyes. These files improve recognition of Aid4Mail user-interface elements andcan be installed to the appropriate location by running Aid4Mail with the following command-lineparameter:

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, usethe /acc command-line switch to turn it on or off. Example:Aid4Mail.exe /acc=on

Page 60: Aid4Mail3 Manual

Aid4Mail 3 Help53

Copyright © 2005-2013 Fookes Holding Ltd

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 requirementsneeded for a product to conform to Section 508 of the Rehabilitation Act. The template format allowsvendors to state their products' conformance to Section 508, requirement by requirement. For moreinformation 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 aresubject 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.

2.3 Wizard Screens

2.3.1 1. Mail Source

The Mail Source screen lets you choose the type of mail you want to process. The list is subdivided intocategories of related formats. You must choose an item from one of the highlighted categories beforeyou can proceed to the next screen. Unless you are using Office Outlook, you should close your mailclient 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. Wheneverpossible, always choose the index files. Processing these is usually faster and more information can beextracted from emails, like status details (unread, read, replied, etc.) Furthermore, deleted mail that isno longer listed in the index files is skipped during processing. Use mailbox files if the correspondingindex files are corrupted, missing, or if you want to retrieve all mail including deleted messages. See thetopic Information About Mail Formats for details about the different formats that Aid4Mail can process.

Are you using Eudora OSE? If so, select Mozilla Thunderbird as your source mail. Eudora OSE isbasically 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 DeletedItems folders. The names of such folders are stored in the files TrashFiles.dat and TrashFolders.dat thatyou will find in the Aid4Mail program folder. You can add more folder names to these two files ifnecessary (one name per line). The TrashFolders.dat file is for message folder names created by MAPIclients like Office Outlook. Aid4Mail uses the names stored in TrashFiles.dat to determine whichmailbox files from other mail clients contain deleted or unwanted messages.

An option labeled "Include unpurged mail" is displayed if you are running Aid4Mail eDiscovery. Whenavailable and checked, Aid4Mail will process moved and deleted items found in mailbox files and foldersthat 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 certaindegree of corruption as the deletion process partially damages the remaining email. By default, Aid4Mail

Page 61: Aid4Mail3 Manual

Reference Information 54

Copyright © 2005-2013 Fookes Holding Ltd

skips messages that have been marked as removed from a mailbox. Currently, Aid4Mail cannot extractthese type of messages from Microsoft Outlook.

Another option that is only available in the eDiscovery edition is "Restore unpurged mail". It is availablewhen the "Include unpurged mail" option is checked. When this feature is used, Aid4Mail removes theDeleted status flag during export from messages that have been marked as deleted (and hidden by themail client) but not yet removed from the mailbox file. Once a mailbox file has been compacted by themail 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 correctlyidentify the location of their default mail files, so this feature might not always work properly. When thesearch fails, you will have to browse through your drives to find the correct location. You can contact usif you need help to find where your mail is stored.

If available, use the "Profile name" field to help refine the search for the location of your mail. WithOutlook Express, the profile name is equivalent to your identity name. With Mozilla Mail andThunderbird, 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 subfoldername containing your mail.

The current version of Aid4Mail cannot extract email status information (unread, read, replied, etc.) frommessages stored in Windows Mail, Windows Live Mail, Mac Eudora, Entourage, Opera Mail, ForteAgent, PMMail, FoxMail, Calypso and Courier.

Note that working on compacted or expunged mailbox files (unpurged mail has been removed) canimprove conversion speed significantly. If you are responsible for migrating mail accounts in yourcompany, you could encourage staff members to compact their mail folders before you start processingtheir data with Aid4Mail. Please see the General Aid4Mail FAQ topic for more tips on speeding upAid4Mail.

2.3.2 2. Source Location

This screen is displayed for all mail source types except IMAP and MAPI profiles. Use it to select themail folders and/or files your want to process. See the topic Finding Mail Folders if you need help to findthe 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 andclick on names to select multiple files/folders. Hold down the Shift key to select a range of names, andpress 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 namebefore continuing to the next screen.

Set the option "Include subfolders" if you want to process all the mail files in and under the currentfolder. If this setting is unchecked, only the mail files directly under the selected folders will beprocessed; their subfolders and contents will be ignored.

If you select a password-protected PST file, make sure you enter the password in the correspondingfield. Otherwise Outlook will prompt you for the password whenever Aid4Mail needs to access itscontents (usually once when it displays the folder hierarchy and once just before starting emailprocessing).

Page 62: Aid4Mail3 Manual

Aid4Mail 3 Help55

Copyright © 2005-2013 Fookes Holding Ltd

Navigating folders with the mouse can be quite laborious depending on where your source files are. If youknow where to find your files, right click with your mouse in the folder/file list window to open a contextmenu that gives you access to a folder or file name input dialog box. You can then paste or type a folderor file name. If you do not specify a fully qualified name, Aid4Mail searches the location relative to thecurrent folder. Aid4Mail recognizes "shorthand" tokens used in the path name; see the Useful Tokensand System Variables topic for more details. The following example will select the file Test.pst in theOffice 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 Thunderbirdversion 3, choose Properties from the menu and then select and copy all the text in the Location field ofthe Folder Properties dialog box. In Thunderbird version 2, choose the "Copy Folder Location" commandfrom the shortcut menu. When you reach the Source Location screen in Aid4Mail, right click in the folderfield and choose the "Go to specific folder" command from the shortcut menu. Aid4Mail will thenautomatically 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 & MicrosoftExchange) Mail Source option. Choose from the drop-down list the mail profile to process. Aid4Mail willdisplay 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. WhenAid4Mail opens your MAPI profile successfully, you will see a hierarchical tree structure with foldernames and the number of messages they contain in parentheses. Uncheck the MAPI folders you do notwant to process. You can check/uncheck a whole tree branch by holding down the Ctrl key while youclick in a checkbox.

If you do not see message folders listed in this screen, this could be due to one of the followingreasons...

1. You are using the 64-bit version of Outlook 2010 or 2013. Install the 32-bit edition to fix this issue.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.).

Page 63: Aid4Mail3 Manual

Reference Information 56

Copyright © 2005-2013 Fookes Holding Ltd

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-Runmethod 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 opensyour IMAP account successfully, you will see a hierarchical tree structure with folder names and thenumber of messages they contain in parentheses. The message count includes deleted emails thathaven't been expunged (these are skipped unless you have an eDiscovery edition that is set to processdeleted mail). Uncheck the mail folders you do not want to process. You can check/uncheck a wholetree 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. Ifyou have a large volume of mail to download, make sure your connection to the internet is as good ascan be (avoid Wi-Fi unless you have a constant strong signal) and choose a time of the day when thereis less internet traffic.

Note that Aid4Mail uses the backslash character (\) as a folder name delimiter. As a result, it cannothandle an IMAP folder name that contains a backslash character. In most cases, IMAP servers don'tallow the creation of such folder names so this issue is very rarely encountered. If you do have a foldername 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 ofemail 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. Datesuse the international yyyy/mm/dd format (4-digit year/2-digit month/2-digit day). You can select a datefrom 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-rangespectrum.

Configure the "Date to check" field to define whether Aid4Mail should use the date when the messagewas sent to you (Mail Sent), when it was received by your mail server (Mail Received), or when it wasdownloaded by your mail client (Mail Stored). With outgoing mail there is no difference between the MailSent and Mail Received fields. With some mail clients, the Mail Stored value cannot be determined. Inthis case, Aid4Mail uses the Mail Received or Mail Sent value instead. For emails that are stored asEML, MHT, or CNM files, Aid4Mail determines the Mail Stored date from the file date stamp; this maynot 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

Page 64: Aid4Mail3 Manual

Aid4Mail 3 Help57

Copyright © 2005-2013 Fookes Holding Ltd

then save all the messages from that period in a ZIP archive and do this at regular intervals, whether it beonce 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: 2004/01/01Ignore if newer than: 2004/12/31Date to check: Mail Received

In the following example, Aid4Mail will only process emails that were received after year 2004:

Ignore if older than: 2005/01/01Ignore if newer than: <blank>Date to check: Mail Received

In the following example, Aid4Mail will only process emails that were sent before year 2004:

Ignore if older than: <blank>Ignore if newer than: 2003/12/31Date to check: Mail Sent

Filter Mail by Content

You can define a list of words that Aid4Mail will search for in each message header, message body text,both the header and body, or the whole email in raw format. Depending on the option you select,Aid4Mail will either reject or accept a message that contains the text search criteria. The list shouldcontain one search criteria per line. The longer the list, the longer it will take Aid4Mail to filter eachemail. You can improve performance by placing the most common search terms at the beginning of thelist. Leave the list blank if you do not want to filter by content.

Matching is case sensitive for lines that have one or more uppercase characters, and case insensitive forlowercase search criteria. A match only occurs if the search criteria covers whole words. For example, ifyour 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 searchcriteria "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 Unicodemessages, Aid4Mail first converts the message body text to the current ANSI character set. Unicodecharacters 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 aregular search criteria with a minus or hyphen character, just add a second one to cancel the negateeffect. A match with a negate criteria will reject a message if the "found in header" option is set, and willaccept 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 previouscriteria. If you must start a regular search criteria with a plus character, just add a second one to cancelthe addition effect. If the "found in header" option is set, the message is only accepted if it containsoccurrences of the preceding and current criteria. If the "not found in header" option is set, the messageis only rejected if it contains occurrences of both the preceding and current criteria. Note that the pluscharacter is ignored if it follows a negate criteria. See example #3 below.

Page 65: Aid4Mail3 Manual

Reference Information 58

Copyright © 2005-2013 Fookes Holding Ltd

Message headers usually contain the email date, subject, sender name and address, recipient namesand 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 appearregularly in a message subject.

The "Manage Words List" button gives you access to a drop-down menu with commands to open aWords List, save a Words List under a new name, and clear the list. Aid4Mail automatically savesmodified Words Lists. If no name has been assigned, it saves the list in a file called "WordsList.txt"under the "Application Data\Aid4Mail" folder.

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 expressionengine is based on PCRE 8.31. 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 startswith "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 "naïve","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 byan equal sign. The following are recognized:

N= produces a normal search

W= produces a wildcard search

R= produces a regular-expression search

Page 66: Aid4Mail3 Manual

Aid4Mail 3 Help59

Copyright © 2005-2013 Fookes Holding Ltd

Words list example #1:[email protected]@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 "[email protected]". Other messages that do nothave "@fookes.com" in the header are rejected. The order of the text search criteria is important here. If"@fookes.com" is placed before "[email protected]", then the negate criteria never gets testedbecause the message is already accepted because "@fookes.com" is found.

Words list example #2:FREEmortgage~home owner~pharma*[email protected]@adpromailer.com@emailfactoryR=free (bonus|debt|loan|money)R=c(i|1)(a|@)l(i|1)sR=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 thelisted search criteria in the header. The above list includes criteria with wildcards and regular expressionpatterns.

Words list example #3:[email protected][email protected]+mailbag assistant

Assuming the "found in header" option is set, Aid4Mail will only accept messages that were sent to the<[email protected]> address and mention either the aid4mail or mailbag assistant products in theSubject line.

Filter Scripts

For the ultimate control over email filtering, you can create Filter Scripts that can access any part of theemail message being processed. For example, you could create a script to identify duplicates using adifferent method from Aid4Mail's deduplicating feature. Or filter messages based on the presence ofspecific header field values – for example all incoming messages marked as urgent and that containinserted images.

Filter scripts are files with the .s4f extension. Any such file placed in the Scripts subfolder of theAid4Mail program or AppData folder will be listed in the Filter Scripts window. If the "Filter sourcemessages" option is unchecked or if you haven't selected a filter, no filter script will be used whenprocessing your source emails. To use a script for email filtering, simply click on its name to select it.

Page 67: Aid4Mail3 Manual

Reference Information 60

Copyright © 2005-2013 Fookes Holding Ltd

You can unselect a script by holding down the Ctrl key and clicking on its name. A right-click on a scriptname opens a shortcut menu with commands to unselect, create, edit, delete, and display informationabout the script (if such data is available in the file). Another way to delete a script is to first select it andthen hit the Delete key.

Aid4Mail includes several sample Filter scripts that you can experiment with and use as the basis for anew script.

2.3.7 7. Target Format

This screen lets you choose what to do with your selected mail source. The following options areavailable...

1. Office Outlook & Microsoft Exchange2. Other mail clients3. Export email to remote server4. Generic mail formats (Outlook Express)5. Extract message contents only6. MHT Web Archive files7. Mail archives8. Custom formats using scripts

2.3.7.1 Office Outlook & Microsoft Exchange

This section is not available in Aid4Mail Home. Note that the two first options below will not be availableif your mail source is a MAPI profile or a PST file.

1. Email Profile (export to an Outlook or Exchange mail account)Select this option to save your source mail into a MAPI store. Aid4Mail will display the folders of defaultstore connected to the chosen profile. Starting with Outlook 2003, you can store up to 20 GB of datainto a MAPI store if your profile is connected to a Unicode PST file (up to 50 GB with Outlook 2010 and2013). But with older versions of Microsoft Outlook you cannot exceed 2 GB of data. Aid4Mail cannotdetect 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 fileAid4Mail can create a new PST file and import your selected source mail into it or open an existing PSTfile and append mail. When Aid4Mail has finished processing, you can open your PST file through theFile/Open/Outlook Data File menu command in Microsoft Outlook. With Outlook 2003 and 2007 you canstore up to 20 GB of data into a MAPI store (Unicode format), and up to 50 GB with Outlook 2010 and2013. But with older versions of Microsoft Outlook you cannot exceed 2 GB. The size limit may be setsmaller through registry settings (see this Microsoft Knowledge Base). If the PST file size limit isexceeded 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 emailis added to the existing file instead of a new copy of the PST file when the "Append messages to targetmailbox file" option is unchecked.

3. Office Outlook MSG filesUse the MSG format if you prefer to save your messages in individual files. MSG files are displayed in anMicrosoft Outlook window when you double-click on the file name in Windows Explorer or another filemanager. Note that MSG files use a proprietary format and can only be opened in Microsoft Outlook.

Page 68: Aid4Mail3 Manual

Aid4Mail 3 Help61

Copyright © 2005-2013 Fookes Holding Ltd

Issues with dates and contact names in the Folder PaneBy default, Microsoft Outlook displays the Sent date and the contact name from the To field formessages in the Sent Items folder, and the server Received date and the contact name from the Fromfield for messages in other folders. As a result, you may see unexpected dates and names in the FolderPane 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 quickestway to do this is press the Ctrl+A keyboard shortcut to select all the messages in a folder, then use theCtrl+Shift+V keyboard shortcut to open the Move to Folder dialog box, and then select the Sent Itemsfolder 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. Thefile format complies with the mbox standard, which most mail clients can read or import.

1. Mozilla-compatible mailboxes (Thunderbird, SeaMonkey Mail, Mozilla Mail, and EudoraOSE)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 messageheader. Mozilla defines its own system for managing status details and stores them in fields that aredifferent from standard mbox files.

You should avoid appending your source mail to mailboxes that are in use. Instead save it under a newsubfolder 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 inthe Folder window.

2. PocoMail & Barca compatible mailboxesChoose this format if you want to import your message into PocoMail or Barca. The mailbox files aresaved 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 someexported 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 newsubfolder or in a new mailbox file. If you save the target files in the PocoMail or Barca folder, you mustrestart the program to see them listed in the Mailboxes window.

3. Windows Live MailBefore exporting messages to Windows Live Mail (WLM) with Aid4Mail, make sure you have configuredit with at least one mail account so that the appropriate target folder is created. You must export yoursource mail under the "Storage Folders" location. Aid4Mail automatically suggests the appropriatedefault mail folder, if it exists. If you type a new subfolder, Aid4Mail will automatically create it beforeexporting your messages.

Open WLM once Aid4Mail has completed the transfer. WLM will start indexing your new folders andmessages; during this time the "Unread email" count increases progressively. Make sure you give itenough time to complete the task. Sometimes new folders do not appear immediately under "StorageFolders"; this display issue is usually fixed by restarting WLM.

Page 69: Aid4Mail3 Manual

Reference Information 62

Copyright © 2005-2013 Fookes Holding Ltd

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 MailBefore exporting messages to Windows Mail (WM) with Aid4Mail, make sure you have configured it withat least one mail account so that the appropriate target folder is created. You must export your sourcemail under the "Local Folders" location. Aid4Mail automatically suggests the appropriate default mailfolder, if it exists. If you type a new subfolder, Aid4Mail will automatically create it before exporting yourmessages.

Open WM once Aid4Mail has completed the transfer. WM will start indexing your new folders andmessages. Make sure you give it enough time to complete the task. Sometimes new folders do notappear 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 IMAPSettings 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 MozillaThunderbird, Windows Live Mail, and Outlook Express.

A generic mailbox is a file that contains one or more email messages stored sequentially in a non-proprietary format which complies with the mbox standard. Aid4Mail creates mbox files that conform tothe mboxrd format. Many email programs can import messages from mbox files. You should avoidappending your source mail to mailboxes that are in use. Instead save it under a new subfolder or in anew 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, EMLfiles can be displayed in an Outlook Express window when you double-click on the file name in WindowsExplorer or another file manager. Aid4Mail sets the file date stamp according to the message datebased on your local time (unless you use the /TimeZone command-line switch). This way you can easilysort your messages by date in your file manager. Note that the Windows File Indexing feature maycause the date stamp of your target EML and MSG files to be changed to the current date. To avoid thisissue, go to Control Panel -> Indexing Options -> Advanced -> File Types, and uncheck the extensions"eml" and "msg" from the list.

EML files can easily be imported into Outlook Express with Windows Explorer. Simply select the EMLfiles in Windows Explorer (the Ctrl+A shortcut selects all the files in your current folder) and then dragthem into the Outlook Express application window and drop them into the mail folder of your choice.

Page 70: Aid4Mail3 Manual

Aid4Mail 3 Help63

Copyright © 2005-2013 Fookes Holding Ltd

2.3.7.5 Extract message contents only

1. Extract attached filesChoose 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. Extractedattachments have a date stamp that matches the message date based on your local time (unless youuse the /TimeZone command-line switch). After processing, Aid4Mail creates a tab-delimited file in thetarget folder called Attach.tab. This file makes it easy to identify which message an attachment belongsto. You can open Attach.tab in a text editor, a spreadsheet program like Microsoft Excel, or import itinto a database program.

Attachments from a Macintosh mail client often come in pairs, with one part containing the actual fileand the other a resource document called a "resource fork". Aid4Mail only extracts the data file part andignores 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 Unicodecharacters, Aid4Mail will try to convert them to their equivalent ANSI character, if available, or substitutethem before saving the file to disk.

2. Extract email attachments and inserted filesChoose this option to extract all attachments and embedded contentscontained in the messagesprocessed by Aid4Mail. Extracted files have a date stamp that matches the message date. Extractedattachments are saved in the Attach subfolder and embedded contents in the Embedded subfolder. Afterprocessing, Aid4Mail creates a tab-delimited file in the target folder called Attach.tab. This file makes iteasy to identify which message an extracted file belongs to. You can open Attach.tab in a text editor, aspreadsheet 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 fileand the other a resource document called a "resource fork". Aid4Mail only extracts the data file part andignores 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 Unicodecharacters, Aid4Mail will try to convert them to their equivalent ANSI character, if available, or substitutethem before saving the file to disk.

3. Extract email addresses of recipientsThis feature is ideal if you need to rebuild an address book or to create a mailing list with addresses ofpeople that have been corresponding with you. Aid4Mail automatically removes duplicates and sortsaddresses 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. Thisfeature is invaluable if you need an easy way to share important mail with customers or to displaymessages 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 compatibleweb browser. In most cases, messages are rendered the same way as in a mail client. However certainspecial types of emails, like digests and partial messages, may not display any contents at all inInternet Explorer. Embedded contents like pictures and sounds are displayed too and you can click onattachment names to extract them from the message and save them to disk. Aid4Mail sets the file datestamp of MHT files according to the email date based on your local time (unless you use the /TimeZonecommand-line switch). This way you can easily sort your messages by date in your file manager.

Page 71: Aid4Mail3 Manual

Reference Information 64

Copyright © 2005-2013 Fookes Holding Ltd

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 filename in the Save As dialog box. It's best to replace it with a meaningful name and especially to add theappropriate 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 showingactive content. If you know your mail is safe, right click on the warning bar and select "Allow BlockedContent" from the popup menu.

1. MHT message files for viewing from Web browserWhen you select this format, Aid4Mail saves your messages into MHT files and creates an index file inHTML format for viewing in your web browser. After processing, you can burn the contents of the targetfolder onto a CD-ROM. Next time you insert your CD-ROM into a computer drive, Internet Explorer willstart up automatically and display the index file for your saved mail. The format of the index page isbased on templates (*.html, *.css) that are stored in the Template subfolder under the Aid4Mail programfolder. 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 ExcelUse this option to create an index file for viewing in Excel 2002, 2003, 2007, 2010, and 2013. Eachmessage folder or mail file is placed on a separate worksheet tab. Excel does impose some limits thatyou may need to take into account before you select your mail source. Each worksheet can only store amaximum of 65,536 emails and its name cannot exceed 31 characters. The format of the index page isbased on templates (*.xls) that are stored in the Template subfolder under the Aid4Mail program folder. Ifyou 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 ifthere is a space in the file path. If you experience this issue, simply copy your exported folder to alocation that has no blank characters in the path name.

3. MHT message files for importing into a databaseSelect this format to export your mail details into a tab-delimited file, which most database programscan 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 thecorresponding MHT message file. The format of the tab-delimited file is based on the database.tabtemplate that is stored in the Template subfolder under the Aid4Mail program folder. If necessary, youcan edit this template in a text editor to modify the choice of fields and their sequential order. The firstline 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 WindowsExplorer under Windows XP or more recent, or with any of the popular ZIP utilities like WinZip andPkZip. 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 storedin these PDF files is searchable in Adobe Reader. Email attachments are embedded in the resultingPDF 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 AConformance) files for long-term archiving or to encrypt and password-protect your PDF files. Anotheruseful option only available in the eDiscovery edition lets you choose whether to embed the originalemail header or full email in RFC format with each message in the PDF file.

Page 72: Aid4Mail3 Manual

Aid4Mail 3 Help65

Copyright © 2005-2013 Fookes Holding Ltd

PDF files are not designed to store huge amounts of data. You should avoid exporting too manymessages into a single PDF file. In our tests, we managed to create PDF files with just under 10,000emails (the limit may vary depending on the type of emails converted). Use the Aid4Mail filtering featuresto export just the subset of emails you need.

Note that in some cases, complex HTML mail (typically advertisements and some newsletters) exportedto PDF are not rendered correctly. If graphic elements are stored on the web, Aid4Mail will try todownload 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 internetand 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 canaccess any part of the email message being processed. For example, you could create a script thatgenerates statistics on information contained in the source emails. Or produce custom export formatslike 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 theAid4Mail program or AppData folder will be listed under the "Custom formats using scripts" section onthe Target Format screen. A right-click on a script name opens a shortcut menu with commands tocreate, edit, delete, and display information about the script (if such data is available in the file). Anotherway 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 anew script.

2.3.8 8. Target Settings

Target LocationChoose the disk folder that is to receive the exported mail and/or message contents. Click on the buttonwith the three dots [•••], or hit the F4 keyboard shortcut while in the field, to browse through your drivesfor the folder name. On some Windows systems, you may need to use "Tools | Folder Options | View" inWindows Explorer and select "Show hidden files and folders". See the topic Finding Mail Folders if youneed help to find the location of your target mail (usually the appropriate target folder is only available ifyou have already set up a mail account in your target mail client). Note that if you add new folder namesin this field, Aid4Mail will automatically create them before saving the target file(s) into them. The Folderfield 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 tocreate 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. Ifyou want to use a different extension, use an asterisk wildcard followed by the extension you wish tohave (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 subjectline. If you also want to control the target extension of exported EML files, just add it after the token (e.g.

Page 73: Aid4Mail3 Manual

Reference Information 66

Copyright © 2005-2013 Fookes Holding Ltd

"{filename}.txt").

Unless you use the {filename} token or choose the MD5 File names option, exported EML, MSG, and

MHT files will be saved with a file name taken from the message subject line. Note that Ai4Mail currentlycannot create Unicode file names. If a subject line or source file name used for creating the target filename has Unicode characters, Aid4Mail will try to convert them to their equivalent ANSI character, ifavailable, 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 proceedto the next screen.

With other target formats, you can choose to either leave this field blank or specify a file name. If youleave this field blank, the target file name will be based on the source file name, or folder name ifmessages are stored in individual files. If you specify a file name and the export option "Restore sourcefolder structure" is unchecked, then all source files are exported into the single target file. Werecommend you leave the file name field blank when processing multiple mail folders, unless you want tomerge them all into a single file.

If you have the Aid4Mail Home edition and want to export mail to your default Outlook profile, select theOutlook.pst file name under the folder "<Application Data>\Microsoft\Outlook\" or in some cases withOutlook 2010 and 2013 under "<Documents>\Outlook Files\". Make sure you tick the "Appendmessages to target mailbox file" box on the Export Options screen.

Exporting to Thunderbird, SeaMonkey, Mozilla, PocoMail, Barca: If you want exported mail to appear inyour mail client, it is important that you have an existing mail profile and that you select the appropriatefolder for the Target Location. Normally, Aid4Mail will suggest the appropriate location if it finds yourdefault 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 wantthe exported mail folder names to be the same as those in your source mail. Finally, before exportingyour messages, make sure your mail client is closed. Once the operation is finished and you reopenyour 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 thefield and double click in it with your mouse. Aid4Mail will then try to determine the appropriate targetfolder for you and enter the value.

Target Line FormatThis option is available when you export your email to EML or generic mailbox formats. Only use it if youplan to transfer your converted files to a non-Windows operating system. Aid4Mail will adjust the formatof line endings of exported emails to suit the selected operating system.

Outlook Personal StorageThis section is only displayed if you have chosen the PST output format. You can specify a DisplayName used when creating a new PST file and the name of the base folder that will be receiving theexported mail. The Display Name must contain a value; it is shown in the Outlook Folder List when youopen the new PST file. The Base Folder value can either be a default Outlook folder name like Inbox orSent Items, or any other name you choose. You can also specify a sequence of subfolder names byseparating each name with a backslash. Example:Inbox\Imported Mail\August 2012

Page 74: Aid4Mail3 Manual

Aid4Mail 3 Help67

Copyright © 2005-2013 Fookes Holding Ltd

Use the password field to create a new encrypted PST file or to add mail to an existing password-protected PST file. When you create a password-protected ANSI PST file with Aid4Mail, the highencryption format is used if the password exceeds 8 characters and the weaker compressible-encryptionformat is used with shorter passwords. With Unicode PST files, the default compressible-encryptionformat 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 monitorthe 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 exportingmail to the current PST file, creates a new PST file based on the name of the first one but with an indexnumber, and then continues the mail export to the new PST file. For example, if you set the size limit to2 GB for a file called Outlook.pst and have 5 GB of mail to export, Aid4Mail will create the following fileson completion:

Outlook.pstOutlook[001].pstOutlook[002].pst

Note that Aid4Mail cannot determine exactly when the limit is reached because Outlook uses a datacache. In other words, Outlook will still send data to the PST file after Aid4Mail has measured the filesize 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 thissetting, Aid4Mail will create a PST file that has a storage capacity of up to 20 GB in Outlook 2003 and2007, and 50 GB in Outlook 2010 and 2013. The main drawback with Unicode PST files is that they arenot compatible with Microsoft Outlook 97, 98, 2000, and 2002. If you uncheck this option, Aid4Mail willcreate an ANSI PST file that is compatible with all versions of Microsoft Outlook but has a storagecapacity limited to 2 GB. Note that the PST size limit may be set smaller through registry settings (seethis Microsoft Knowledge Base).

PDF SettingsThese options are displayed if you select Adobe PDF file as your target format. Several categories ofsettings are available through the tabs below the option fields (two in Aid4Mail Professional and three ineDiscovery). You must define a target file name if you choose to export all your emails into one PDFdocument; 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 onePDF per email. Other options let you set the page size and orientation, the default display mode whenthe PDF file is opened, the level of compression (fastest means lowest compression but fastest PDFcreation and opening), and whether to embed fonts in the file or not. For the smallest PDF files, setcompression to "maximum" and Fonts to "No font embedding".

Some email messages rely on external images for their presentation. Aid4Mail can download suchcontents and include them in the target PDF file. This feature, however, only works if Aid4Mail hasaccess to the internet. If you are working in a restricted environment or if processing speed is moreimportant to you than including external images, simply set the "External links" field to "Nodownloading".

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) exportedto PDF are not rendered correctly. If graphic elements are stored on the web, Aid4Mail will try to

Page 75: Aid4Mail3 Manual

Reference Information 68

Copyright © 2005-2013 Fookes Holding Ltd

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 internetand 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 thatare encrypted and password protected or PDF/A archival files. Note that you cannot create encryptedPDF/A files. To preserve your original source data within the target PDF file, Aid4Mail gives you theoption to store either the original message header or the whole email as embedded data in regular PDFfiles (not PDF/A). A right-click on the corresponding icon in the PDF file gives you access to the save todisk command. You also have the option to print in the PDF file the hash signature (MD5 or SHA1) ofeach processed email.

Unfortunately the PDF/A format does not allow embedding files in it in such a way that they can besaved to disk by end users afterwards. As a result, email attachments and source mail files (headers orwhole emails) are exported in corresponding subfolders of the target PDF folder instead of beingembedded 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 thisscreen, this could be due to one of the following reasons...

1. You are using the 64-bit version of Outlook 2010 or 2013. Install the 32-bit edition to fix this issue.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 InternetOnly Mode (IMO).

Create and save under following subfolderEnter a name in this field if you want the imported mail stored in a new folder under the selected targetMAPI folder. You can also specify a sequence of subfolder names by separating each name with abackslash. Example:Imported Mail\August 2012

2.3.10 10. Target IMAP Folder

Select the IMAP folder that should receive the exported mail. This screen is empty if Aid4Mail was notable to connect to the remote mail server using the IMAP protocol. See the IMAP Settings topic for moredetails.

Page 76: Aid4Mail3 Manual

Aid4Mail 3 Help69

Copyright © 2005-2013 Fookes Holding Ltd

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, makesure your connection to the internet is as good as can be (avoid Wi-Fi unless you have a constantstrong 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 emailper day.

2.3.11 11. Export Options

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

Standard Export Options

1. Export Format

1.1 Preserve full messageSelect this option to export the complete email message, including its attachments and embeddedcontents.

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 likepictures are preserved. This option is useful if you want to reduce the size of your target files.

1.3 Only keep plain text messageSelect this option to discard all attachments, embedded contents, and rich text formatting. Only plaintext is preserved. Email headers are also simplified to preserve only the most important fields (likesubject, date, sender, and recipients). Aid4Mail takes care of converting HTML messages into plain textso 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 setshould be processed. When the box is checked, UTF-8 characters are converted to plain ANSIcharacters based on the default Windows character set. When unchecked, UTF-8 characters arepreserved 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 (?). Ifmessages become unreadable because of this, then you should leave this option unchecked.

2. Export Options

2.1 Restore source folder structureWhen 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 messagesand subfolders matching the original structure. If this option is unchecked, all messages are saved undera single folder.

2.2 Detach attachments and inserted files from email messagesIf your selected target corresponds to a generic mailbox format or EML files, you can save themessages with all contents (file attachments, embedded pictures, etc.) extracted and saved in aseparate folder. Aid4Mail saves the modified messages using the MIME External-Body Access-Typeformat defined in RFC 1521. Using this setting has several advantages: a) attachments and embedded

Page 77: Aid4Mail3 Manual

Reference Information 70

Copyright © 2005-2013 Fookes Holding Ltd

contents are easy to find and open with Windows Explorer or any other file manager; b) duplicate filesare automatically removed; c) the total size of exported files can be significantly smaller than the sourcefile(s). The main disadvantage with this format is that most mail clients do not handle it correctly andmay not be able to render the extracted files. However, you can always use Aid4Mail to pull detachedfile contents back into the messages if necessary.

2.3 Append messages to target mailbox fileIf your selected target corresponds to a PST file or a generic mailbox format, you can add messages toan existing file if this option is set. If the "Do not add duplicate messages" option is set, only newmessages are appended to the target file. If this option is unchecked, Aid4Mail will first make a backupcopy of the target file if it already exists and then replace the contents with messages from the mailsource.

2.4 Do not add duplicate messagesWhen available, set this option to block adding duplicate messages. By default, Aid4Mail skipsduplicates 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 thisoption usually decreases processing speed and uses more system memory, though the impact isusually 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 emailheader. If this field is empty or missing (usually in outbound messages), Aid4Mail uses other headerdata for the comparison. In MAPI messages (from Office Outlook and Microsoft Exchange), Aid4Mailuses the email creation and submit dates, subject line, and stored message size. In other types ofmessages, 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 fieldscontain any data.

2.5 Use unique MD5 file namesWhen you save messages to individual MSG, EML, or MHT files, you can choose to have their file namebased on the message subject line or based on a unique (and usually shorter) MD5 signature. If youplan to save your message files to a CD-ROM, it is recommended that you set this option. This ensuresyou won't encounter problems with file names that are too long. The following example is an MD5 filename: 6a4b080de66b2dafb4f6bceb4916aaf4.eml

With Outlook MSG files, the MD5 signature is based on the unique Message-ID field, which is normallypresent in the header of all received email messages. If this field is empty or missing (usually inoutbound messages), Aid4Mail uses the email creation and submit dates, subject line, and storedmessage 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 characterin an EML or MHT message file will result in a completely different MD5 file name. Only two messagesthat are 100% identical will produce an identical MD5 file name. Unfortunately, when exportingmessages from Outlook 2003 and more recent, most messages (those with a MIME format) will notproduce the same MD5 file name each time you rerun the conversion with Aid4Mail. The reason is thatOutlook uses a random element to create boundary markers between message parts. You can workaround this problem by unchecking the Use MAPI RFC 1521 Converter option or using the /MapiConvOff command-line switch.

Page 78: Aid4Mail3 Manual

Aid4Mail 3 Help71

Copyright © 2005-2013 Fookes Holding Ltd

Address Export Options

1. Comma separated valuesUse this format if you plan to import your data into the address book of a mail client. By default, the fileproduced has a .csv extension. It contains two comma-separated columns of data, the first for the username (when available) and the second for the user email address.

2. Tab separated valuesThis format is similar to the comma separated values option. Values are separated by tab charactersinstead of commas. By default, the file produced has a .tab extension. This format is ideal for importingaddresses into a spreadsheet or database program.

3. Plain-text valuesSelect this option if you want to create a mailing list. Data is stored in plain-text format with one addressper line. The addresses are formatted just as you would use them in a mail client (e.g. "User Name"<[email protected]>)

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 Outlookthough). Once you click on the Start button, Aid4Mail starts reading your source mail and processes itto the output format. The main window is updated as each item is processed. If the Launch box ischecked 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 willhave to edit the Aid4Mail.ini file which is saved under the Applications Data folder. The path of theAid4Mail.ini is usually similar to the following (change {User} with the appropriate user name):

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

or under Windows 7 or Vista:c:\Users\{User}\AppData\Roaming\Aid4Mail\Aid4Mail.ini

Make sure you close Aid4Mail before you edit its INI file. You can specify the alternative programs underthe [LaunchApp] section in the INI file. Use the WebBrowser key to launch a different browser fromInternet 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 applicationname can be followed by command-line switches. Use the "%s" token to tell Aid4Mail where it mustinsert the name of the target folder or file. Example:

[LaunchApp]WebBrowser=NetCaptor.exe -nohome %sFileManager=Explorer.exe /e,%sXlsViewer=Excel.exe %s

If you are going to process large amounts of emails, you can improve speed and reduce memory usageby setting the "Skip filter details in log" checkbox. When set, this option tells the log screen to not showinformation 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 mayhave skipped during processing.

Page 79: Aid4Mail3 Manual

Reference Information 72

Copyright © 2005-2013 Fookes Holding Ltd

2.3.12.1 Skipped Messages

Once your messages have been processed, Aid4Mail displays information about the number of emails ithas 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 filtersettings, non-email items, empty emails (no header and body), or emails that were not processed orsaved due to errors.

Duplicates are skipped if you set the "Do not add duplicate messages" checkbox on the ExportOptions 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 existon IMAP servers with index errors. Outlook Express files may also include links to remote emails thathave 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 mailboxfiles. They are the original copies of emails that have been deleted or moved from the mail folder. Thesetype of messages disappear when you compact or expunge your mail folders. Note that Aid4Mail cannotsee unpurged messages in Microsoft Outlook because Extended MAPI doesn't provide methods to findthem. Unpurged emails can be extracted with the eDiscovery edition of Aid4Mail by setting the "Includeunpurged mail" checkbox on the Mail Source screen.

Filtered messages are typically emails that did not match your filter settings on the Filter Optionsscreen. If your source mail is from a MAPI store (Office Outlook, PST) and the "Process only emailmessages" option is checked, non-email items such as Calendar, Contacts, and Tasks, are skippedand added to the Filtered count.

Errors that cause a failure to process or save a message are counted under this item. Such errorstypically occur when you process a corrupted file, or malformed messages, or the file is locked byanother process, or the target location is write protected, or the target lacks the necessary space for thenew 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 startAid4Mail. 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 available in the selected edition, butwith the following limitations:

A trial-mode information screen is displayed for at least 8 seconds each time you start Aid4Mail.Processing is limited to a maximum of 50 messages per mail folder. *When exporting to the MHT format, the limit is 10 messages per mail folder. *A trial tag is added to the subject line of every converted message.

When you purchase a license and activate Aid4Mail, the above limitations are removed.

* If you need to run performance tests on an unlimited number of emails during trial mode, add the /NoLimit switch to your Aid4Mail command line. Using it removes the 50 emails per folder trial limitation

Page 80: Aid4Mail3 Manual

Aid4Mail 3 Help73

Copyright © 2005-2013 Fookes Holding Ltd

and instead replaces all exported subject lines with a trial notice.

2.3.13.2 News and Updates

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

The news item has either been added today or after you last displayed news.The news item has already been displayed before.

The news item link points to an .exe Setup file.

The news item link points to a .zip file.The news item is an email address link.

The News and Updates screen is useful to find out if a new Aid4Mail update is available. It also displaysnews 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 oryour computer will be revealed during this operation. Aid4Mail determines locally what relevant news todisplay to you. See our online FAQ for more information about this feature.

Usually, program updates are downloaded and installed directly from within Aid4Mail — updating yoursoftware this way couldn't be easier. However, be aware that some download managers may take overthis download process and interfere with normal operations. When this happens, you may see a promptfrom Aid4Mail asking you to click a button once the download has been completed. With other downloadmanagers, 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 Checkfor news updates setting. The News and Updates screen will automatically pop up if news items havebeen added or modified since the last viewing.

2.4 Writing Aid4Mail Scripts

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

Type of Scripts

Aid4Mail currently supports three types of scripts. They are 1) Filter Scripts which can be selected fromthe Filter Options screen; 2) Output Scripts which can be selected from the Target Format screen; and3) Plain Scripts which can be executed from the "Run Plain Script" menu command opened by clickingon the Software button.

The main purpose of Filter Scripts is to control which emails are skipped or passed on to the nextprocessing 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 arestored 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

Page 81: Aid4Mail3 Manual

Reference Information 74

Copyright © 2005-2013 Fookes Holding Ltd

Scripts to create custom formats not available by default in Aid4Mail or to extract data from emailmessages. Output Scripts use the .s4o extension and are stored in the Scripts subfolder under theAid4Mail 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 dataare not available in these type of scripts. You can use Plain Scripts for setup purposes, to test newcode, or to help you learn the scripting syntax. Plain Scripts can be executed without prior installation orthe 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 provideinformation to Aid4Mail. For example, the [Script.Info] section has a Title field that Aid4Mail uses to listthe script in the relevant part of its interface. The Requirements field tells Aid4Mail if the script can rununder 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 andwhich 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) ofemail processing. Each section starts with a double colon (::) followed by an identifier. The followingevents 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 thefolder is processed.

::OnNewMessage

This event occurs each time a message is loaded for processing. The script code has access to all theemail-related commands.

::OnFinish

Code under this section executes after the last email has been processed.

Aid4Mail scripts recognize several different kinds of data types. These are character strings (blocks oftext), which have to be placed between double quotes. Example: "blocks of text"Boolean values: True or FalseIntegers: 123Decimal numbers: 123.456and Hexadecimal characters: $41 (= letter A).

Variables are named memory blocks that can store any of the above data types. Variable names alwaysstart with the % character followed by a series of alphanumerical characters - spaces, controlcharacters, diacritics, and special symbols are not allowed in a variable name.

Page 82: Aid4Mail3 Manual

Aid4Mail 3 Help75

Copyright © 2005-2013 Fookes Holding Ltd

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 aconvenient way to construct XML data structures.

Array variables can be subdivided into four types: plain arrays (%Array.variable) with just one column ofdata, 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 duplicatedata 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 variablename must correspond to the name of a template stored in the templates section at the end of the scriptfile. 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" keywordwhich 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 curlybrackets. 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 inthe corresponding script variable. Using the above example, with %Address = "[email protected]",produces the following result:Email address: [email protected]

Aid4Mail variables exist within a scope that is defined by where they are first used. Data in variables thatare defined in the OnStart section are accessible in all parts of the script. Variables defined in theOnNewFolder section can also be accessed in the OnNewMessage section, but not in the OnFinishsection. Variables defined in OnNewMessage can only be accessed in that section.

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

Page 83: Aid4Mail3 Manual

Reference Information 76

Copyright © 2005-2013 Fookes Holding Ltd

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 flowbased on conditions defined by the script. Use the "Return" command in a label section to return to thescript line following the "GoTo" command that brought you to it.

Script execution starts at the beginning of an event section, and processed statements in sequentialorder until a "GoTo" instruction is encountered, or a label, or the next event section, or the start of thetemplates section.

Aid4Mail supports over 180 functions. On execution, they all return a value that can be one of the datatypes mentioned higher up. Most of these function take on or more parameters, which must beseparated 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. Usethe + 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 useparentheses 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". Thedifferent results between %Val2 and %Val3 are due to differences in operator precedence between thetwo 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 theyare left out. Optional parameters are identified in the functions list by enclosing them between squarebrackets. 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 Aid4Mailactivated for eDiscovery. Aid4Mail Home can only use scripts in trial mode.

You'll find usage examples of most of the functions in the "Test All.s4p" and "Test Mime.s4o" samplescripts. To execute the "Test All.s4p" script, click on the Software button in Aid4Mail, select "Run PlainScript", and then open the file. We encourage you to open the sample scripts in a text editor and thenrun 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 PCRE8.31. The regular expression syntax is documented in the Regex.chm Help file.

Page 84: Aid4Mail3 Manual

Aid4Mail 3 Help77

Copyright © 2005-2013 Fookes Holding Ltd

2.4.1 Aid4Mail Script Syntax

Strings are automatically converted to UTF-8 if they are different from the system character set. IfCharset=UTF-8 then system character sets are also converted to UTF-8.

[Script.Info]Title=Unpurged to EMLsSummary=Export unpurged mail as individual EML filesType=Input|Output|Filter|PlainVersion=1.0CharSet=UTF-8|System|WesternAuthor=Fookes Software LtdCopyright=Copyright (c) 2012 Fookes [email protected]=www.aid4mail.comCompatible=1.0Requirements=Trial|Activated|eDiscovery|GUI|Console;This is a comment

[Script.GUI.Enable]TargetSettingsScreen=FalseExportOptionsScreenTargetFolderTargetFileNameTargetLineFormatExportOptionsTargetMailFormatTargetAddressFormatRestoreHierarchyExtractContentsAppendMessagesSkipDuplicatesUseHashNames

[Script.Code]

[Template=]

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 decimalnumbers%Sigs.Variable // special array variable for handling hash data [ <-- only in Aid4MaileDiscovery]

Page 85: Aid4Mail3 Manual

Reference Information 78

Copyright © 2005-2013 Fookes Holding Ltd

%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, HALTRUNTIME_ERROR

Types:"String"True/False123123.456$0A

Assignment:%Variable = Value

Mathematical operators:+ - * /

Comparison operators:=, <> or !=, <, >, <=, >=

Comments in Script code section:// ...

Object:Mime.Attr[(Name)] // Returns current field attribute, or attribute value if a name isspecifiedMime.Attr.CountMime.Attr.Find(AttrName)Mime.Attr.GoFirstMime.Attr.GoLastMime.Attr.GoNextMime.Attr.NameMime.Attr.Set(Name; Value) // Added if Name doesn't exist; deleted if Value is emptyMime.Attr.Value

Page 86: Aid4Mail3 Manual

Aid4Mail 3 Help79

Copyright © 2005-2013 Fookes Holding Ltd

Mime.Body[(Format)] // Format = Decoded, RawMime.Body.Set(Value)Mime.BoundaryMime.CharsetMime.ContentTypeMime.CountMime.EmailMime.Field[(Name)] // Returns current field, or field value is a name is specifiedMime.Field.CountMime.Field.Find(FieldName)Mime.Field.GoFirstMime.Field.GoLastMime.Field.GoNextMime.Field.NameMime.Field.Set(Name; Value) // Added if Name doesn't exist; deleted if Value is emptyMime.Field.ValueMime.FileNameMime.Find(Section) // Section = Display, Text, Html, XML, Rich, TNef, AttachmentsMime.FromDelimiterMime.GoChildrenMime.GoFirstMime.GoLastMime.GoNextMime.GoParentMime.HasChildrenMime.HasParentMime.Header[(Format)] // Format = Decoded, RawMime.Header.Set(Value)Mime.IsAttachmentMime.IsEmbeddedMime.IsMessageMime.IsMultipartMime.Preamble // This is a multi-part message in MIME format.Mime.Size

Commands:

// All Array data is stored in same Charset, which is determined by data added (ASCII-7 -> System -> UTF-8)Array.Add(Array; Value[; Delimiter])Array.Add(Array; Value[; Number])Array.Exists(Array; Value)Array.Format(Array[; Delimiter; Options]) // Options = SortArray.Format(StatsArray[; Format]) // Format = "^1"+%Tab+"^2"+%Tab+"^3"+%LB // ^1 =Name; ^2 = Count; ^3 = PercentageArray.Format(StatsArray[; Format]) // Format = CSVArray.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)

Page 87: Aid4Mail3 Manual

Reference Information 80

Copyright © 2005-2013 Fookes Holding Ltd

Array.Replace(Array; NewValue)Array.Replace(Array; OldValue; NewValue)Array.Save(Array; FileName[; Options]) // Options = Overwrite, Backup, Increment,Skip, ErrorArray.SetIndex(Array; Index)

Calculate(Expression)Clear(Variable[; Type]) // Type = Plain, ArrayDecrement(Number[; Count])Decrement(Array; Item)Define(Variable[; Type]) // Type = String, Boolean, Number, Array, StatsArray,RealArray, XMLDefine(Variable; SigsArray[; HashMethod]) // HashMethod = CRC32, MD5, SHA1, SHA256,SHA384, SHA512 [ <-- only in Aid4Mail eDiscovery]ErrorCodeErrorLineErrorMessage

File.Append(FileName; Data[; CharSet]) // Creates BOM on new file if CharSet = UTF-16or UTF-8b; CharSet can be numerical value or Charset name like UTF-8File.Copy(Source; Target[; Options]) // Options = Overwrite, Append, Backup,Increment, Skip, ErrorFile.Delete(FileName) // Does not delete files in system foldersFile.Exists(FileName)File.Exists(ZipFile; Specs)File.GetDate(FileName[; DateField]) // DateField=create, modified, accessedFile.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 = ParseFile.Rename(FileName; NewName[; Options]) // Options = Overwrite, Backup, Skip, ErrorFile.Save(FileName; Data[; Options; CharSet]) // Options = Overwrite, Append, Backup,Increment, Skip, Error; Creates BOM on new file if CharSet = UTF-16 or UTF-8b; CharSetcan be numerical value or Charset name like UTF-8File.SetIni(FileName; ValueName; Value)File.SetIni(FileName; SectionName; ValueName; Value)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 andSettings\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.txtFileName.GetExtension(FileName)FileName.GetLongName(ShortFileName)FileName.GetName(FileName)FileName.GetPath(FileName)FileName.GetShortName(LongFileName)

Page 88: Aid4Mail3 Manual

Aid4Mail 3 Help81

Copyright © 2005-2013 Fookes Holding Ltd

Folder.Copy(Source; Target[; Options]) // Options = SkipIfExistsFolder.Create(Folder)Folder.Delete(Folder) // Only deletes folders under MyDocuments and Temp foldersFolder.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 andSettings\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, PlainMessage.Extract(TargetFolder[; Specs; Options]) // Specs = *.eml; Options =Attachments, Embedded, AllMessage.FileNameMessage.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, DisplayNameMessage.GetBody[(Part; Options)] // Part = Display, Text, Html, Rich; Options =Decoded, Raw, PlainTextMessage.GetDate[(DateField; Format; TimeZone)] // DateField = Display,Sent,Received,Stored; Format = binary or yyyy/mm/dd; TimeZone = Local,UTCMessage.GetEmlName[(Options)] // Options = Subject, MD5Message.GetFileNames[(Specs; Options; Delim)] // Options = Attachments, Embedded, AllMessage.GetFlags //N R A F D M T E U O I (New, Read, Answered, Forewarded, Deleted,Marked, aTtachments, Email, Usenet, Outgoing, Incoming)Message.GetFolder[(Options)] // Options = Mailbox, SourceMessage.GetFolderFlags // I O D T U (Incoming, Outgoing, Drafts, Trash/junk, Unknown)Message.GetHeader[(Field; Options)] // Field = All, FromDelimiter, Subject, Message-Id, ...; Options = Decoded, RawMessage.GetMailboxNameMessage.GetRaw[(Options)] // Options = Full, Extract, Rich, PlainMessage.GetSizeMessage.IsDateInRange(DateStart; DateEnd[; DateField]) // DateStart = yyyy-mm-ddMessage.IsOutgoing // message going out (not received)Message.Priority // 0 = none, 1 = highest, 5 = lowest

Page 89: Aid4Mail3 Manual

Reference Information 82

Copyright © 2005-2013 Fookes Holding Ltd

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 XNumber.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 beBoolean value (True/False) or a character (,')Number.Trunc(Variable[; Decimals])

Print.Data(String)Print.FontSetup[(Name; Size; Style; CharSet)] // Style = B,I,U,SPrint.PageSetup[(MarginLeft; MarginRight; MarginTop; MarginBottom; Orientation)] //Margins in mm; Orientation = Portrait, LandscapePrint.PrinterSetup[(PrinterName)]Print.TextFile(FileName)Print.Title(String)

RefreshScreenReturn // Use in label section to return to back to previous source sectionRunConsole(Executable; Parameters[; StdInput]) [ <-- only in Aid4Mail eDiscovery]RunShell(Command[; Options]) // Options = Wait

Settings.AppendMailSettings.CurrentFolder // returns current folder path. Example: Inbox\Urgent\TodaySettings.ExtractContentsSettings.FilterSettings.HashFileNamesSettings.ProgramParam(Switch)Settings.ProgramTrialMode // True/FalseSettings.ProgramType // Home, Professional, eDiscovery, ConsoleSettings.ProgramVersion //2000, 2010, ...Settings.RestoreFoldersSettings.SkipDuplicatesSettings.SourceFolderSettings.SourceMailSettings.TargetFileNameSettings.TargetFolderSettings.TargetFormatSettings.TargetLineFormat

ShowInfo(Message[; Options]) // Options = ProgressLog, DialogBoxSound(SoundName)

String.ChangeCase(String; Options) // Options = Lower, Upper, Capitalize, InvertString.ChangeCharSet(String; NewCharSet) // NewCharSet can be numerical value orCharset name like UTF-8String.Contains(Chars; Set) // Contains("AZ"; "ABCDZEF") -> TrueString.Copy(String; Offset[; Amount]) // if Offset is negative position is calculatedfrom string end

Page 90: Aid4Mail3 Manual

Aid4Mail 3 Help83

Copyright © 2005-2013 Fookes Holding Ltd

String.Decode(String[; Options]) // Options = quoted-printable quoted base64 CSV HTMLRTF URL UUE ROT13String.Delete(String; Offset[; Amount]) // if Offset is negative position iscalculated from string endString.Encode(String; Options) // Options = quoted-printable quoted base64 CSV URL UUEROT13String.Escape(String; Chars; EscChar)String.Exists(Pattern; String[; SearchOptions]) // SearchOptions = C,W,?,RString.Extract(Pattern; String[; SearchOptions; Format]) // SearchOptions = C,W,?,RString.ExtractAll(Pattern; String[; SearchOptions; Format]) // SearchOptions = C,W,?,RString.Filter(String; OldChars[; NewChars]) // deletes found OldChars if nocorresponding NewCharsString.Format(String; Format[; Charset]) // Format = Windows, Mac, UNIX; CharSet canbe numerical value or Charset name like UTF-8String.GetCharCount(String)String.GetCharSet(String) // 0 = System; 20127 = ASCII; 65001 = UTF-8String.GetCount(Substring; String[; SearchOptions; Offset]) // SearchOptions = C,W,?,RString.GetHash(String[; Options]) // Options = CRC32, MD5, SHA1, SHA256, SHA384,SHA512 [ <-- only in Aid4Mail eDiscovery]String.GetPosition(Substring; String[; SearchOptions; Offset]) // SearchOptions = C,W,?,RString.GetPositionRight(Substring; String[; SearchOptions; Offset]) // SearchOptions =C,WString.Insert(Substring; String; Offset) // if Offset is negative position iscalculated from string endString.IsSameAs(Pattern; String2[; MatchOptions]) // MatchOptions = ?,RString.IsSameAs(String1; String2[; MatchOptions]) // MatchOptions = CString.Pad(String; Width[; Char]) // Negative width pads left sideString.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 substitutionstringString.Trim(String[; Chars; Options]) // Options = Left, Right, LeftRightString.Unwrap(String)String.UrlDecode(String)String.UrlEncode(String)String.Wrap(String; Width[; Indent])

System.ComputerNameSystem.DateTime[(Format; "UTC")]System.LogonNameSystem.TimeZone

ValueIf(Condition; ValueIfTrue[; ValueIfFalse]) // Condition Operators: =, <> or !=,<, >, <=, >=

Wait(Time) // Causes script to pause for specified amount of time. Time value is inmilliseconds

// All XML data is stored in UTF-8 format

Page 91: Aid4Mail3 Manual

Reference Information 84

Copyright © 2005-2013 Fookes Holding Ltd

XML.AddAttribute(XML.Variable; Name; Value)XML.AddData(XML.Variable; Data)XML.TagAdd(XML.Variable; TagName; Data) // Opens tag, adds data, then closes itXML.TagClose(XML.Variable)XML.TagName(XML.Variable)XML.TagOpen(XML.Variable; TagName[; Data; CloseIt]) // CloseIt = True/False

2.4.2 Calculate command

This topic documents the mathematics operators and functions supported by the Calculate commandavailable 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

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

Page 92: Aid4Mail3 Manual

Aid4Mail 3 Help85

Copyright © 2005-2013 Fookes Holding Ltd

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 6̂4 and 2 6̂4. Inaddition, the value of X can’t 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

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)

Page 93: Aid4Mail3 Manual

Reference Information 86

Copyright © 2005-2013 Fookes Holding Ltd

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

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

Page 94: Aid4Mail3 Manual

Aid4Mail 3 Help87

Copyright © 2005-2013 Fookes Holding Ltd

2.5 Aid4Mail Console

Aid4Mail Console is the Win32 CLI version of Aid4Mail and its file name is a4m.exe. It is a differentprogram from the regular GUI version of Aid4Mail (file name Aid4Mail.exe). It is included with theAid4Mail Console Migrator and Aid4Mail eDiscovery Service licenses. And it is available as a bundleoption with Aid4Mail eDiscovery Forensic, Aid4Mail eDiscovery Archivist and Aid4Mail eDiscoveryPersonal.

Aid4Mail Console can be run from batch files, the Windows Start/Run dialog, and any application thatcan execute other programs; conversion options can either be set through command-line switches, anINI file, or both. Unlike the other versions of Aid4Mail, the Console can process more than one PST fileunattended. This capability is particularly useful if you need to process dozens or hundreds of PST filesin a batch.

The server edition of Aid4Mail Console can be launched as a Windows Service through the EasyService Launcher (ESLaunch.exe) utility included in the distribution package. You will find usageinstructions 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 iferrors occurred.

2.5.1 Command-Line Parameters

Aid4Mail Console supports an array of command-line switches that you can use to configure mailprocessing 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 yourcommand 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"]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 mailboxfile name or search criteria (allows the wildcards "*" and "?"). Use double quotes if the Source namecontains 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 specifiedthrough the /S_Profile switch.

Use the "imap" token to retrieve email from an IMAP account. The account logon settings are taken fromthe 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 issaved in the default file storage location for Office Outlook. You can open the newly created file throughthe File/Open/Outlook Data File menu command in Office Outlook (older versions of Outlook may useslightly 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

Page 95: Aid4Mail3 Manual

Reference Information 88

Copyright © 2005-2013 Fookes Holding Ltd

from or to. Simply use a colon (:) after the token name followed by the folder path using a backslash toseparate 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 donot specify a name, the program will save the exported mail into the current folder, or the "MyDocuments" folder if it is write protected. Use double quotes if Target contains spaces. Tokens andsystem variables are supported. If you choose to export mail to the EML or MSG format, Target shouldrepresent a folder. If you export to an mbox format, Target can either represent a folder or file name. Ifthe Target name ends with a backslash (\), the contents of each mail folder is stored into its own mboxfile with a name matching that of the mail folder. If you want the exported files to use the same name asthe 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 specifiedthrough the /T_Profile switch.

Use the "imap" token to export your mail to an IMAP account. The account logon settings are takenfrom the target.imap.ini file (located in the program folder), which you must modify beforehand. Whenusing the "imap" token, you can specify the name of the folder you want to export to. Simply use acolon (:) 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 thesource mail files.

Options switchesSee the following topics for a list of available optional command-line switches:

Source SwitchesTarget SwitchesFilter SwitchesOther Switches

/INI=FileNameUse this switch to specify an INI file with settings for Aid4Mail Console. Use double quotes if the filename contains spaces. Tokens and system variables are supported. Example:

a4m.exe /ini="%MyData%\Aid4Mail Settings.ini"

You do not need to use this switch if your INI file is named a4m.ini and is stored in the same folder asa4m.exe. 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 anuninterrupted batch process. Progress information and error messages are stored in the specified file. Ifan error occurs, no user input is required (like press Enter key to continue) so batch operations can

Page 96: Aid4Mail3 Manual

Aid4Mail 3 Help89

Copyright © 2005-2013 Fookes Holding Ltd

continue unattended. Alternatively, you can also use the /unattended switch if you do not want toredirect output.

Note that you cannot use this redirect method from the Windows Run feature. You need to launchAid4Mail from the command prompt of the Windows CMD console or a Windows batch file to redirectoutput with the ">" symbol.

2.5.1.1 Source Switches

This topic covers Aid4Mail Console optional command-line parameters that control how source mail isaccessed and processed.

/AddWinmailDatConverts TNEF messages to the RFC 1521 format using the MAPI internal converter and saves theoriginal TNEF data in a winmail.dat email attachment.

/DelSource=FastPermanently deletes source messages that have been successfully processed. The delete feature workson 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, andNetscape). Only use this feature with the greatest care as in most cases you will not be able to undeletethe source messages. We strongly recommend that you first test this feature on data that you can fullyrestore from backups if necessary. When using this switch, YOU AGREE TO RELEASE FOOKESSOFTWARE AND ITS SUPPLIERS FROM ANY LIABILITY OR DAMAGES DUE TO THE LOSS OFANY SUCH DATA OR FILES. Example:a4m.exe %Outlook%\Outlook.pst D:\Mail\Generic\*.mbox /DelSource=Fast

/emlExt=extEnables 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

/f="folder name"Exports mail from from the specified source folder in a PST file or an Outlook/Exchange store. Usedouble quotes if the folder name contains spaces. You can use the wildcards "*" and "?" to broaden thescope of folder that should match the criteria. Use a backslash "\" character as a separator in a folderpath. 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\NoReply\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

/fastAid4Mail does extensive data analysis when reading generic mailbox files, including those created byMozilla Thunderbird and Eudora. It does this to avoid missing messages when dealing with mailbox filesthat contain a mix of storage formats (e.g. a Mac or UNIX mbox file imported in Windows Thunderbird

Page 97: Aid4Mail3 Manual

Reference Information 90

Copyright © 2005-2013 Fookes Holding Ltd

with new messages added to it). If you are processing mailbox files that are entirely created by a singlemail program, then you can increase performance without sacrificing reliability by using the /fast switch.

/IncludeAllItemsIncludes Calendar, Contacts, Tasks, and other non-email items in an Outlook/Exchange mail storeduring processing. By default, Aid4Mail only processes email items. Note that the current version ofAid4Mail only exports email-related fields, so special data fields used in Calendar, Contacts, Tasksitems are not transfered.

/IncludeTrashIncludes mail stored in the Trash, Junk, and Deleted Items folders during processing. The names of suchfolders are stored in the files TrashFiles.dat and TrashFolders.dat that you will find in the Aid4Mailprogram folder. You can add more folder names to these two files if necessary (one name per line). TheTrashFolders.dat file is for message folder names created by Outlook and Exchange. Aid4Mail uses thenames stored in TrashFiles.dat to determine which mailbox files from other mail clients contain deletedor unwanted messages. By default, mail in these folders is ignored.

/IncludeUnpurgedIncludes moved and deleted items still present in mailbox files and folders that haven't been compactedor 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 certaindegree of corruption as the deletion process partially damages the stored email. By default, Aid4Mailskips messages that have been flagged as removed from a mailbox.

/m/m=mbox OR pine OR moz OR eudora OR mc_eudora OR calypso OR maildir OR eml OR msgOR pmmail_msgTells Aid4Mail what the source mail format is. This switch is useful if Aid4Mail's automatic formatdetection fails due to insufficient information. This switch can also be used without specifying a value (/m); in this case Aid4Mail performs less strict format checking on certain mailbox types. The followingswitch values are available:

mbox - use if source is a generic mailbox file (mbox, Berkeley mail format, BSD mail format, Unix mailformat)pine - use if source is a Pine mbox file with limited "From " escapingmoz - use if source is Mozilla Mail, Thunderbird, Eudora OSE, or Netscapeeudora - use if source is a Qualcomm Eudora MBX filemc_eudora - use if source is a Macintosh Eudora mailbox filecalypso - use if source is Calypso Mail or Couriermaildir - use if source represents Maildir folderseml - use if source represents eml mail filesmsg - use if source represents Outlook MSG mail filespmmail_msg - use if source represents PMMail MSG mail files

Example:a4m.exe D:\Mail\*. D:\Archives\Backup2012.zip /m=mbox

/MapiConvOffWith Outlook 2003 and more recent versions, Aid4Mail uses a special MAPI feature to import/exportmail from Outlook PST and MSG files, and Exchange server stores. The advantage of this method is thatit converts messages with non-Latin characters and certain special email formats more reliably thanother methods. The disadvantage is that it is usually slower than Aid4Mail's alternative method. Addthe /MapiConvOff switch to turn off the special MAPI conversion feature if you are encountering issues

Page 98: Aid4Mail3 Manual

Aid4Mail 3 Help91

Copyright © 2005-2013 Fookes Holding Ltd

when using it or if conversion speed is critical.

/MapiFixOffWhen converting mail from Outlook PST and MSG files, and Exchange server store formats to RFC text-based 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 originalemail. The disadvantage of this procedure is that it slows down conversion and in some very rare casesfails to correctly render emails based on unusual formats. Use the /MapiFixOff switch to turn off thedefault email fixing feature.

/s=True OR FalseIncludes mail stored in source subfolders when set. This option is on by default so you only need to usethis 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 inthe 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 containsspaces.

/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 yoursource MAPI account if it is different from your default profile name. Use double quotes if the profilename contains spaces.

If your source mail is defined by the "imap" token, this switch tells Aid4Mail where to find the logonsettings file for your source IMAP account. If no file path is specified, Aid4Mail looks for it in its programfolder or under the IMAP subfolder. Tokens and system variables are supported. If this setting is notused, 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=passwordDefines a password for the source PST file or IMAP account. Use double quotes if the passwordcontains spaces. Note that this password has nothing to do with the profile password, which MAPIautomatically 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 containsspaces.

/UseMapiTnefConverterConverts TNEF messages to the RFC 1521 format with the MAPI internal converter. This switch shouldonly be used if you are encountering conversion issues with those type of emails.

2.5.1.2 Target Switches

This topic covers Aid4Mail Console optional command-line parameters that control how target mail isaccessed and processed. You will find additional switches listed under the topics Target FormatSwitches and Email Contents Switches.

Page 99: Aid4Mail3 Manual

Reference Information 92

Copyright © 2005-2013 Fookes Holding Ltd

/aAppends message to target store or mailbox file if it already exists. If this switch is not used, a backupcopy of the mailbox file is created before the export procedure starts. This option is ignored if you areexporting 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 exportedmail. This option is ignored if you are exporting to other mail formats. Use double quotes if the foldername 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 "ImportedFolders (April 14, 2011)" when this switch is not used. This switch is ignored if the target is not a PSTfile.

/md5Name/md5Name=MessageIdCreates MSG, EML, and MHT files with a name based on their MD5 signature. This switch is ignoredwith other types of target mail.

By default, the MD5 signature for EML and MHT file names is computed from the full email (messageheader + body). When the switch has the "MessageId" value, the MD5 signature for EML and MHT filenames is based on the Message-ID field value. If this field is empty or missing (usually in outboundmessages), 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 wholeheader.

/tBy default, Aid4Mail normally restores the source folder structure at the target end. Use the /t switch tosave all processed mail into a single target folder. When used with the /xls export option, all email itemsare grouped into a single worksheet page. This switch is ignored if you are exporting mail to the /mhtand /dbs formats.

/T_Log="file name"Enables logging of communications between Aid4Mail and the target IMAP account; data is stored inthe 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 containsspaces.

/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. Usedouble quotes if the profile name contains spaces. Aid4Mail will access your default Outlook profilewhen this switch is not used.

When using the "imap" token, this switch tells Aid4Mail where to find the logon settings file for yourtarget IMAP account. If no file path is specified, Aid4Mail looks for it in its program folder or in the IMAP

Page 100: Aid4Mail3 Manual

Aid4Mail 3 Help93

Copyright © 2005-2013 Fookes Holding Ltd

subfolder. Tokens and system variables are supported. Use double quotes if the profile name containsspaces. 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 isspecified, Aid4Mail looks for it in its program folder. Tokens and system variables are supported. If thisswitch 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 MBIf you think your export will exceed the capacity of a single PST file, you can use /T_PstSize switch toset a threshold value. Setting the value to zero or leaving it blank instructs Aid4Mail to not monitor thePST 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 tothe 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 toexport, Aid4Mail will create the following files on completion:

Outlook.pstOutlook[001].pstOutlook[002].pst

Note that Aid4Mail cannot determine exactly when the limit is reached because Outlook uses a datacache. In other words, Outlook will still send data to the PST file after Aid4Mail has measured the filesize 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=passwordDefines a password for the target PST file or IMAP account. Use double quotes if the password containsspaces.

PST files: the password enables creating a new password-protected PST file or adding mail to anexisting password-protected PST file. When you create a password-protected ANSI PST file withAid4Mail, the high encryption format is used if the password exceeds 8 characters and the weakercompressible-encryption format is used with shorter passwords. With Unicode PST files, the defaultcompressible-encryption format is used (high encryption is not supported.) Note that this password hasnothing to do with the profile password, which MAPI automatically prompts you to enter in a separatedialog box.

/T_UserId="User name"Defines the logon user name for the target IMAP account. Use double quotes if the user name containsspaces.

/TimeZoneChanges the default time zone Aid4Mail uses when setting the date stamp of exported message filesand date values in the corresponding column of MHT target formats. The switch accepts a time zonevalue in one of several formats: numerical, time zone abbreviation, time zone in short form, or Windowsregistry time-zone name. See the Time Zones topic for more information. If this switch is missing,Aid4Mail uses UTC time.

/UseDateFieldWhen exporting mail to eml, mht, and msg files, as well as when extracting files (attachments andembedded contents), Aid4Mail sets the file stamp to match the email date. By default, Aid4Mail uses

Page 101: Aid4Mail3 Manual

Reference Information 94

Copyright © 2005-2013 Fookes Holding Ltd

the server Received date taken from the header of incoming messages (Aid4Mail always uses the Datefield for outgoing mail). You can use the /UseDateField to tell Aid4Mail to always get the date from themessage header Date field instead of the server Received date.

2.5.1.2.1 Target Format Sw itches

This topic covers Aid4Mail Console optional command-line parameters that determine the target mailformat.

/addresses=csv OR tab OR txtThis feature is ideal if you need to rebuild an address book or to create a mailing list with addresses ofpeople that have been corresponding with you. Aid4Mail automatically removes duplicates and sortsaddresses 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).

/attachmentsExports only the file attachments contained in the processed source mail. Aid4Mail also saves anAttach.tab file in the target folder, which contains a tab-delimited list of all the extracted attachment files.

/contentsExports 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 attachmentsunder the "Attach" folder. Aid4Mail also saves an Attach.tab file in the target folder, which contains atab-delimited list of all the extracted files.

/dbsSimilar to the /mht switch, but produces an index file for importing mail data into a database.

/emlExports each source mail into a corresponding EML file. The resulting file name is built from themessage's subject line, unless it is specified in the target parameter, or if you use the /md5Nameswitch. Aid4Mail also saves a Mail.tab file in the target folder, which contains a tab-delimited list of allthe exported EML files (useful if you want to import mail in a database.) This switch is not required ifyour target name includes the .eml file extension.

/mapiExports 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"

/mboxExports the mail into an mbox-compatible (generic) mailbox file. This export option is used by default ifnone 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.

/mhtExports each source mail into a corresponding MHT file (HTML Web Archive). The resulting file name isbuilt from the message's subject line, unless it is specified in the target parameter. The format is similarto EML files. MHT files can be viewed in Internet Explorer like a regular HTML file; embedded picturesare 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

Page 102: Aid4Mail3 Manual

Aid4Mail 3 Help95

Copyright © 2005-2013 Fookes Holding Ltd

Explorer; just open the file index.html in your browser. This switch is not required if your target nameincludes the .mht file extension.

/mozExports the source mail into a Mozilla-compatible mailbox file (Netscape, Mozilla, Thunderbird, EudoraOSE).

/msgExports each MAPI source mail into a corresponding MSG file. The resulting file name is built from themessage's subject line. The source must be a PST file or a MAPI mail profile. This switch cannot beused if the source is also MSG files. This switch is not required if your target name includes the .msgfile extension.

/OutputScript="Script Name"Use the OutputScript switch to load the specified script name. The script name can either be a fullyqualified file name or just a file name without path and extension. See the Writing Aid4Mail Scripts topicfor more information about Output Scripts.

/pdfExports mail to Adobe PDF file(s). By default, the PDF format options are taken from the pdf.ini file inthe program folder. You can specify a different configuration file through the /T_Profile command-lineswitch. Note that due to third-party licensing terms, the server edition of Aid4Mail Console currently doesnot include the PDF export option. This switch is not required if your target name includes the .pdf fileextension.

/pstExports the source mail into a standard Outlook PST file (ANSI format). You can use the /b switchdescribed under Optional Switches to specify which mail folder should be receiving the messages. Thistype of PST file has a maximum storage capacity of 2 GB and is compatible with all versions of OfficeOutlook. This switch is ignored if you use the "mapi" token (to access a MAPI profile) as the Targetvalue.

/UnicodePstExports the source mail into a Unicode PST file (Outlook 2003 or newer). You can use the /b switchdescribed above to specify which mail folder should be receiving the messages. This type of PST file hasa maximum storage capacity of 20 GB in Outlook 2003 and 2007, 50 GB in Outlook 2010 and 2013, andis not compatible with Outlook 97, 98, 2000, and 2002. Note that this switch will create a regular ANSIPST file if your version of Microsoft Outlook is older than Outlook 2003 or if you use the standaloneversion of MAPI. This switch is ignored if you use the "mapi" token (to access a MAPI profile) as theTarget value. This switch is not required if your target name includes the .pst file extension.

/xlsSimilar to the /mht switch, but produces an index file for viewing in Office Excel instead of InternetExplorer.

/zipExports mail into generic mailbox files (mbox) and stores them in a standard ZIP file. Attachments andembedded contents are stored under subfolders in the ZIP file. The resulting ZIP file is compatible withall popular ZIP utilities, like WinZip, and with Windows Explorer under Windows XP or more recent. Youmust specify a target ZIP file name without wildcards (*, ?). If the target name already exists, Aid4Mailcreates a backup of it and builds a new ZIP file. This switch is not required if your target name includesthe .zip file extension.

Page 103: Aid4Mail3 Manual

Reference Information 96

Copyright © 2005-2013 Fookes Holding Ltd

2.5.1.2.2 Email Contents Sw itches

This topic covers Aid4Mail Console optional command-line parameters that determine the target mailformat.

/extractAttachments contained in exported mail are extracted and saved under the "Attach" folder. Theadvantage of this method (RFC 1521) is that attachments are easily accessible and the resulting mailfiles are often much smaller. The disadvantage with this method is that many mail clients cannot accessthe extracted attachments. This switch is ignored if you're exporting mail to an IMAP account or theMSG format.

/ExtractAllAttachments and embedded contents contained in exported mail are extracted and saved under twosubfolders. Embedded contents (inline attachments) are saved under the "Embedded" folder and fileattachments under the "Attach" folder. The advantage of this method (RFC 1521) is that attachments areeasily accessible and the resulting mail files are often much smaller. The disadvantage with this methodis that many mail clients cannot access these extracted attachments. This switch is ignored if you'reexporting mail to an IMAP account or the MSG format.

/lf=Mac OR UNIX OR LinuxThe line-format switch can have one of three values: "Mac", "UNIX", or "Linux". It is used when youexport your email to EML or generic mailbox formats. Only use it if you plan to transfer your convertedfiles to a non-Windows operating system. Aid4Mail will adjust the format of line endings of exportedemails to suit the chosen operating system.

/richAttachments in exported mail are discarded. Only the message text, formatting, and embeddedcontents are preserved. This switch can significantly reduce the size of the exported mail.

/plainAttachments and embedded contents (e.g. pictures, sounds) in exported mail are discarded. Only theplain message text with no formatting is preserved. Email headers are also simplified to preserve onlythe most important fields (like subject, date, sender, and recipients). Messages based on the UTF-8character set are converted to plain ANSI characters based on the default Windows character set. Inmost cases, messages will be easier to read when UTF-8 is converted to ANSI. However, charactersthat do not exist in the default character set are converted to a question mark (?). If messages becomeunreadable 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.

/utf8This switch is similar to the /plain switch described above. The only difference is that UTF-8 charactersare not converted to ANSI, they are preserved as-is. In most cases, messages will be easier to readwhen UTF-8 is converted to ANSI. However, characters that do not exist in the default character set areconverted to a question mark (?). If messages become unreadable because of this, then you should usethe /utf8 switch instead of /plain. The /utf8 switch can significantly reduce the size of the exported mail.

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

Page 104: Aid4Mail3 Manual

Aid4Mail 3 Help97

Copyright © 2005-2013 Fookes Holding Ltd

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 containsspaces. The folder name can include tokens and system variables. This switch is only valid when usedtogether with /SaveBadImapMail.

/SaveBadImapMailTells Aid4Mail to save a copy of rejected emails in EML format. The files are saved under the Mailsubfolder in the folder specified by the /BadImapMailFolder switch. If no folder is defined, Aid4Mail thenchooses the location of the target IMAP log file if set, or the Aid4Mail program folder.

/ShrinkBadImapMailMany IMAP servers reject emails that are too big. You can use this switch to tell Aid4Mail to try againafter 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.5.1.3 Filter Switches

This topic covers Aid4Mail Console optional command-line parameters that control how source mail isfiltered.

Filter emails by date

/dr=yyyy/mm/dd-yyyy/mm/ddDefines a date range filter based on the email received date based on the moment it reaches your mailserver. 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 usedto separate the two values that define the date range. The date on the left defines the start of the daterange and the date on the right defines the end of the date range. You can leave out one of the datefields 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: /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/01-

In the following example, Aid4Mail will only process emails that were received before year 2009: /dr=-2008/12/31

/ds=yyyy/mm/dd-yyyy/mm/ddThis switch is nearly identical to the /dr switch described above except that it is based on the email sentdate. This usually corresponds to the date stored in the message header Date field. You cannot usethe /ds switch at the same time as the other date switches.

/dc=yyyy/mm/dd-yyyy/mm/ddThis switch is nearly identical to the /dr switch described above except that it is based on the mail clientprogram's download date. You cannot use the /dc switch at the same time as the other date switches.

Page 105: Aid4Mail3 Manual

Reference Information 98

Copyright © 2005-2013 Fookes Holding Ltd

Not all email client programs record the download date. When it is missing, Aid4Mail uses the emailreceived or sent date instead. For emails that are stored as EML, MHT, or CNM files, Aid4Mail takes thedownload 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 criteriafrom the specified file and checks each email for a match. Emails that do not contain any of the textcriteria 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. Seethe 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 criteriafrom the specified file and checks each email for a match. Emails that contain any of the text criteria inthe list are skipped during processing. By default, Aid4Mail only searches the email header. You canextend the search to the message text by using the /FilterScope switch described below. See theWords List File topic to learn how to create such a file. You cannot use both the /Include and /Excludeswitches at the same time.

/FilterScope=all OR message OR header OR rawOnly use this switch if you have defined a Words List with the /Include or /Exclude parameters. TheFilterScope switch can have one of four values: "All", "Message", "Header" or "Raw". Use the "All" valueto search through both the email header and the message text, the "Message" value to search throughthe subject line and message text, and "Header" to search through the email header only. Use "Raw" tosearch through the whole email in MIME format; this option is useful if you want to search for specificcontent types. When this switch is missing, only the email header is searched. Note that searchingthrough 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 orjust a file name without path and extension. If you leave out the file path, Aid4Mail will first look for thescript in the "Scripts" subfolder and then the program folder. See the Writing Aid4Mail Scripts topic formore 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 forduplicates with this option usually decreases processing speed and uses more system memory, thoughthe 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 ifit doesn't exist. Before Aid4Mail processes a source email, it checks if a matching reference exists in

Page 106: Aid4Mail3 Manual

Aid4Mail 3 Help99

Copyright © 2005-2013 Fookes Holding Ltd

the log file. The email is skipped if it is listed. Otherwise, unless it is blocked by other filter settings, theemail is processed and its reference is stored in the log file. This feature is useful for running incrementalemail 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 beidentified.

Aid4Mail checks for duplicates by comparing the value of the Message-ID field in each processed emailheader. If this field is empty or missing (usually in outbound only messages), Aid4Mail uses otherheader 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 othertypes of messages, Aid4Mail uses the email date and subject line for the comparison, or other headerfields (To, Cc, Bcc, From delimiter) if either of those values are missing, or the whole header if none ofthose 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 isignored if /SkipAllDups is also used. Note that checking for duplicates with this option usuallydecreases 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 ifit doesn't exist. Before Aid4Mail processes a source email, it checks if a matching reference exists inthe log file. The email is skipped if it is listed. Otherwise, unless it is blocked by other filter settings, theemail is processed and its reference is stored in the log file. This feature is useful for running incrementalemail 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 beidentified.

Aid4Mail checks for duplicates by comparing the value of the Message-ID field in each processed emailheader. If this field is empty or missing (usually in outbound messages), Aid4Mail uses other headerdata for the comparison. In MAPI messages (from Office Outlook and Microsoft Exchange), Aid4Mailuses the email creation and submit dates, subject line, and stored message size. In other types ofmessages, 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 fieldscontain any data.

2.5.1.4 Other Switches

This topic covers optional command-line parameters that control how Aid4Mail Console operates.

/Log/Log="file name"Use this switch to save the progress information to a text file. It is faster than redirecting output to a textfile. The folder name can include tokens and system variables. If you omit the file name, Aid4Mail willcreate a log file stored in its program folder called ProcessLog.txt.

/ErrorLog/ErrorLog="file name"See the topic Error Log File for details about this switch. The folder name can include tokens and

Page 107: Aid4Mail3 Manual

Reference Information 100

Copyright © 2005-2013 Fookes Holding Ltd

system variables.

/ImapLogCreates a log file storing all communications between Aid4Mail and an IMAP server. This feature isuseful 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 fileextension (unless you specified a fully qualified file name through the /S_Log and /T_Log switches). Thisswitch is ignored when using /S_Log or /T_Log.

/NoFilterLogIf 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 toskipped messages as a result of Aid4Mail's filter settings.

/NoLimitAdd the /NoLimit switch to your Aid4Mail command line if you need to run performance tests on anunlimited number of emails during trial mode. Using it removes the 50 emails per folder trial limitationand instead replaces all exported subject lines with a trial notice. Only use this switch during trial modeor else you will get a command-line error message.

/QuitIfTrialTerminates 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). Thisfeature helps you identify multiple simultaneous instances of the console. When used, Aid4Mail saves atext file with conversion statistics; the file name is based on the session name. The text file is saved inthe program folder unless the session name includes a folder name to another location. The folder namecan include tokens and system variables. Examples:/SessionName=Account072/SessionName="%AllUsersProfile%\Aid4Mail Migration\Account 072"

/stopTerminates program execution just before mail processing starts. This feature is useful to verify thevalidity of settings without processing mail.

/temp="folder name"By default, Aid4Mail stores temporary files in the Windows Temp folder under the logon user folder. Usethis switch to specify an alternative location for storing temporary files. The folder name can include tokens and system variables; example: /temp=%AllUsersProfile%\Aid4Mail\Temp

/unattendedRuns Aid4Mail without user intervention when an error occurs. This feature is particularly useful if youplan to run Aid4Mail Console in an uninterrupted batch process. If an error occurs, no user input isrequired (like press Enter key to continue) so batch operations can continue unattended.

2.5.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 isignored. You can use the /INI command-line switch to specify which INI file to use. If this switch is notused, Aid4Mail will look for the a4m.ini file in the same folder as the a4m.exe program file.

Page 108: Aid4Mail3 Manual

Aid4Mail 3 Help101

Copyright © 2005-2013 Fookes Holding Ltd

To make it easier for you to create the INI file, simply rename the a4m.txt file stored in your Aid4Mailprogram 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.txtIncludeAllItems=TrueIncludeTrash=TrueIncludeUnpurged=TrueSkipDuplicates=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 SettingsTarget SettingsFilter SettingsOther Settings

2.5.2.1 Source Settings

This page lists settings you can use in the Aid4Mail Console INI file to control the handling of sourcemail.

DelSource=Fast or FalseUse this setting to permanently delete source messages that have been successfully processed. Thedelete feature works on the following source formats: IMAP accounts, MAPI profiles ("Default messagestore" only), PST, MSG, and EML files, and Mozilla mailboxes (including Thunderbird, SeaMonkey,Eudora OSE, and Netscape). This feature is turned off by default. Only use it with the greatest care as inmost cases you will not be able to undelete your processed source messages. We strongly recommendthat you first only test this feature on data that you can fully restore from backups to ensure no valuablemail is lost. The /DelSource command-line switch overrides this setting.

When using the DelSource setting, YOU AGREE TO RELEASE FOOKES SOFTWARE AND ITSSUPPLIERS FROM ANY LIABILITY OR DAMAGES DUE TO THE LOSS OF ANY SUCH DATA ORFILES.

emlExt=extUse this setting if you need to process EML files that do not have the standard .eml file extension. Setthe "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

ImapSource=FileName.iniTells Aid4Mail where to find the logon settings file for your source IMAP account. If no file path isspecified, Aid4Mail looks for it in its program folder. Tokens and system variables are supported. If thissetting is not used, Aid4Mail will look for the source.imap.ini file in the same folder as the a4m.exeprogram file. Example: ImapSource=%MyData%\IMAP Settings.ini

IncludeAllItems=True or FalseUse this setting when processing Office Outlook mail to include Calendar, Contacts, Tasks, and othernon-email items during the export. By default, Aid4Mail will only process email items. The /

Page 109: Aid4Mail3 Manual

Reference Information 102

Copyright © 2005-2013 Fookes Holding Ltd

IncludeAllItems command-line switch overrides this setting.

IncludeTrash=True or FalseUse this setting to process mail stored in the Trash, Junk, and Deleted Items folders. The names ofsuch folders are stored in the files TrashFiles.dat and TrashFolders.dat that you will find in the Aid4Mailprogram folder. You can add more folder names to these two files if necessary (one name per line). TheTrashFolders.dat file is for message folder names created by MAPI clients like Office Outlook. Aid4Mailuses the names stored in TrashFiles.dat to determine which mailbox files from other mail clients containdeleted or unwanted messages. By default, mail in these folders is ignored. The /IncludeTrashcommand-line switch overrides this setting.

IncludeUnpurged=True or FalseUse this setting to process moved and deleted items found in mailbox files and folders that haven't beencompacted or expunged. These email items are not usually visible in your mail client. Note that if youuse this option with Outlook Express .dbx files, processed messages all have a certain degree ofcorruption as the deletion process partially damages the remaining email. By default, Aid4Mail skipsmessages that have been marked as deleted from a mailbox. The /IncludeUnpurged command-lineswitch overrides this setting.

SearchSubFolders=True or FalseTells Aid4Mail whether to search subfolders at the location pointed by the Source criteria. This option ison by default so you only need to include this setting if you want to ignore subfolders. The /s command-line switch overrides this setting.

SkipDuplicates=none or folder or allUse 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 forduplicates irrespective of the target folder. By default, Aid4Mail does not skip duplicates. Note thatchecking for duplicates with this option may decrease processing speed and require more systemresources. 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 emailheader. If this field is empty or missing (usually in outbound messages), Aid4Mail uses other headerdata for the comparison. In MAPI messages (from Office Outlook and Microsoft Exchange), Aid4Mailuses the email creation and submit dates, subject line, and stored message size. In other types ofmessages, 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 fieldscontain any data.

SkipDuplicatesFile=Incremental Log FileYou can specify a log file to keep track of which emails have been processed. A new log file is created ifit doesn't exist. Before Aid4Mail processes a source email, it checks if a matching reference exists inthe log file. The email is skipped if its reference is found. Otherwise, if it isn't blocked by other filtersettings, the email is processed and its reference is stored in the log file. This feature is useful when youneed 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 theSkipDuplicates ALL option, and vice versa. Email references are not generated the same way undereach option so matches would not be recognized.

SourceFormat=formatUse this setting if Aid4Mail fails to correctly identify your source mail format. The /m command-line

Page 110: Aid4Mail3 Manual

Aid4Mail 3 Help103

Copyright © 2005-2013 Fookes Holding Ltd

switch overrides this setting. The following values are available:

QuickCheck - use for less in-depth automatic format checking. Useful if source files have an unusualformatmbox - use if source is a generic mailbox file (mbox, Berkeley mail format, BSD mail format, Unix mailformat)pine - use if source is a Pine mbox file with limited "From " escapingmoz - use if source is Mozilla Mail, Thunderbird, or Netscapeeudora - use if source is a Eudora MBX filemc_eudora - use if source is a Macintosh Eudora mailbox filecalypso - use if source is Calypso Mail or Couriermaildir - use if source represents Maildir folderseml - use if source represents eml mail filesoutlook_msg - use if source represents Office Outlook msg mail filespmmail_msg - use if source represents PMMail msg mail files

SourceMail=file name or specs, or "mapi" or "imap" tokensThe value can represent a token (mapi or imap), or a PST, MSG, EML, Mozilla or other generic mailboxfile name or search criteria (allows the wildcards "*" and "?"). Tokens and system variables aresupported in the path name.

Use the "mapi" token to access a MAPI profile; the default profile is used if no profile name is specifiedwith the MapiProfile setting or the /n switch.

Use the "imap" token to retrieve email from an IMAP account. The account logon settings are taken fromthe 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 exportfrom. Simply use a colon (:) after the token name followed by the folder path using a backslash toseparate folder names. Wildcards are supported. Example.SourceMail=imap:INBOX\Archives\*

SourceNamespace=IMAP NamespaceDefines the Namespace for the source IMAP account. The /S_Namespace command-line switchoverrides this setting.

SourcePassword=passwordUse this setting to specify a password for the source PST file or IMAP account. The /S_PW command-line switch overrides this setting.

PST files: Note that this password has nothing to do with the profile password, which MAPI will promptyou to enter in a separate dialog box.

IMAP accounts: if the SourcePassword setting and /S_PW switch are not used, Aid4Mail takes thepassword from the source imap.ini file.

SourceUserName=Logon User nameUse this setting to specify the logon user name for the source IMAP account. The /S_UserId command-line 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 nameSourceProfile=IMAP INI file

Page 111: Aid4Mail3 Manual

Reference Information 104

Copyright © 2005-2013 Fookes Holding Ltd

If your source mail is defined by the "mapi" token, use this setting to specify a profile name for yoursource MAPI account if it is different from your default profile name. The /S_Profile command-line switchoverrides this setting.

If your source mail is defined by the "imap" token, this setting tells Aid4Mail where to find the logonsettings file for your source IMAP account. If no file path is specified, Aid4Mail looks for it in its programfolder. Tokens and system variables are supported. If this setting is not used, Aid4Mail will look for thesource.imap.ini file in the same folder as the a4m.exe program file. The /S_Profile command-lineswitch overrides this setting.

UnzipSource=True or FalseTells Aid4Mail whether source mail is contained in a ZIP file that needs to be unzipped prior toprocessing. Do not use this setting with Aid4Mail ZIP Archives.

2.5.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 tabExports extracted email addresses to the specified file format. Aid4Mail automatically removesduplicates and sorts addresses in alphabetical order. You can specify the most appropriate outputformat after the equal sign: comma separated values (*.csv), tab separated values (*.tab), and plain-textvalues (*.txt). By default, Aid4Mail uses the plain-text format. The /Addresses command-line switchoverrides this setting.

AddWinmailDat=True or FalseWhen UseMapiTnefConverter and AddWinmailDat are set to True, TNEF data is saved in a winmail.datattachment when converting mail to the RFC 1521 format. Set to False if you do not wish to createwinmail.dat attachments. The /AddWinmailDat command-line switch overrides this setting.

AppendMail=True or FalseAppends message to target mailbox file if it already exists. If this switch is not used, a backup copy ofthe mailbox file is made before the export procedure starts. This option is ignored if you are exporting toOutlook or Exchange profile, EML, MHT, XLS, DBS, and MSG files. By default, Aid4Mail does notappend messages to an existing mailbox. The /a command-line switch overrides this setting.

BadImapMailFolder=folder nameTells Aid4Mail where to locally save emails rejected by the target IMAP server. The folder name caninclude tokens and system variables. This option is only valid when used together with theSaveBadImapMail option.

ExportFormat=formatDefines the target format of exported messages. By default, Aid4Mail restores the full email contents onexport. The /extract, /ExtractAll, /rich, /plain, and /utf8 command-line switches override this setting.Available format values and their purpose are listed below:

fullThe full email contents are restored on export.

extractAttachments contained in exported mail are extracted and saved under the "Attach" folder. Theadvantage of this method (RFC 1521) is that attachments are easily accessible and the resulting mailfiles are often much smaller. The disadvantage with this method is that many mail clients cannot access

Page 112: Aid4Mail3 Manual

Aid4Mail 3 Help105

Copyright © 2005-2013 Fookes Holding Ltd

the extracted attachments. This value is ignored if you are exporting mail to an IMAP account or theMSG format.

ExtractAllAttachments and embedded contents contained in exported mail are extracted and saved under twosubfolders. Embedded contents (inline attachments) are saved under the "Embedded" folder and fileattachments under the "Attach" folder. The advantage of this method (RFC 1521) is that attachments areeasily accessible and the resulting mail files are often much smaller. The disadvantage with this methodis that many mail clients cannot access these extracted attachments. This value is ignored if you areexporting mail to an IMAP account or the MSG format.

richAttachments in exported mail are discarded. Only the message text, formatting, and embeddedcontents are preserved. This value can significantly reduce the size of the exported mail.

plainAttachments and embedded contents (e.g. pictures, sounds) in exported mail are discarded. Only theplain message text with no formatting is preserved. Email headers are also simplified to preserve onlythe most important fields (like subject, date, sender, and recipients). Messages based on the UTF-8character set are converted to plain ANSI characters based on the default Windows character set. Inmost cases, messages will be easier to read when UTF-8 is converted to ANSI. However, charactersthat do not exist in the default character set are converted to a question mark (?). If messages becomeunreadable because of this, then you should use the utf8 value described below instead of plain. Theplain value can significantly reduce the size of the exported mail.

utf8This value is similar to the plain value described above. The only difference is that UTF-8 characters arenot converted to ANSI, they are preserved as-is. In most cases, messages will be easier to read whenUTF-8 is converted to ANSI. However, characters that do not exist in the default character set areconverted to a question mark (?). If messages become unreadable because of this, then you should usethe utf8 value instead of plain. The utf8 value can significantly reduce the size of the exported mail.

ExportSingleFolder=True or FalseDepending on the criteria that you use, Aid4Mail creates subfolders in the target folder to match thesource folder structure. If you do not want exported mail files split up into several subfolders, set theExportSingleFolder value to True to force Aid4Mail to store all files in a single disk folder. Note that whenTargetFormat is set to xls, all email items are grouped into a single worksheet page. This setting isignored if TargetFormat is set to mht or dbs. The /t command-line switch overrides this setting.

HeaderBasedMd5Names=True or FalseWhen False, the MD5 signature for EML and MHT file names is computed from the full email (messageheader + body). When True, the MD5 signature is based on the Message-ID field value. If this field isempty or missing (usually in outbound messages), Aid4Mail generates the signature from the email dateand subject line, or other fields (To, Cc, Bcc, From delimiter) from the message header if either of thosevalues are blank, or the whole header. This setting was introduced in Aid4Mail 2.11 and is True bydefault.

LineFormat=windows or mac or unixThe LineFormat setting controls the type of line break characters Aid4Mail uses to create EML orgeneric mailbox formats. It can have one of three values: "Mac", "UNIX", or "Windows". By defaultAid4Mail uses the Windows line format. Only use other values if you plan to transfer your converted filesto a non-Windows operating system. Aid4Mail will adjust the format of line endings of exported emails tosuit the chosen operating system. The /Lf command-line switch overrides this setting.

Page 113: Aid4Mail3 Manual

Reference Information 106

Copyright © 2005-2013 Fookes Holding Ltd

MapiConvOff=True or FalseUnder Outlook 2003 and more recent, Aid4Mail uses a MAPI function to convert mail between RFC text-based 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 specialemail types more reliably than the alternative method. The disadvantage of this MAPI function is that it isusually slower than the other Aid4Mail method. Set MapiConvOff to True to turn off the special MAPIconversion feature. The /MapiConvOff command-line switch overrides this setting.

MapiFixOff=True or FalseWhen converting mail from Outlook PST and MSG files, and Exchange server store formats to RFC text-based formats (MIME), Aid4Mail performs a series of fixes on the messages converted by MAPI. Thesefixes are necessary to make the converted email as faithful as possible to the original email and avoidloss of data. The disadvantage of this procedure is that it slows down conversion and in some very rarecases 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 nameUse this switch to specify a profile name for your target MAPI account if it is different from your defaultprofile name. This switch is only valid if the "mapi" token is used for the target mail. The /MapiTargetcommand-line switch overrides this setting.

MD5name=True or FalseUse this setting to produce MSG, EML, and MHT files with an MD5 signature as file name. This switchonly works with the msg, eml, and mht TargetFormat values. By default Aid4Mail creates file namesbased on the message subject line. Set MD5name to True to use MD5 names. The method used tocalculate MD5 values depends on the HeaderBasedMd5Names setting.

With Outlook MSG files, the MD5 signature is based on the unique Message-ID field, which is normallypresent in the header of all received email messages. If this field is empty or missing (usually inoutbound messages), Aid4Mail uses the email creation and submit dates, subject line, and storedmessage size.

The /MD5name command-line switch overrides this setting.

OutputScript=Script NameUse this setting to load the specified script name. The script name can either be a fully qualified filename or just a file name without path and extension. See the Writing Aid4Mail Scripts topic for moreinformation on Output Scripts. The /OutputScript command-line switch overrides this setting.

PstDisplayName=PST display nameUse this setting to define a display name when exporting to a new PST file. By default, Aid4Mail createsa name like "Imported Folders (July 01, 2012)" when this setting is not used. The /PstDisplayNamecommand-line switch overrides this setting.

SaveBadImapMail=True or FalseTells Aid4Mail to save a copy of emails rejected by the target IMAP server in EML format. The files aresaved under the Mail subfolder in the folder specified by the BadImapMailFolder option. If no folder isdefined, Aid4Mail then chooses the location of the target IMAP log file if set, or the Aid4Mail programfolder.

ShrinkBadImapMail=True or FalseMany IMAP servers reject emails that are too big. You can use this switch to tell Aid4Mail to try again

Page 114: Aid4Mail3 Manual

Aid4Mail 3 Help107

Copyright © 2005-2013 Fookes Holding Ltd

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 withthe SaveBadImapMail option.

TargetFormat=formatUse this setting to define the target mail format if this information cannot be determined from your targetname. 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 areavailable:

mboxexports the mail into an mbox-compatible (generic) mailbox file. This export option is used by default ifnone of the export format switches are specified and the target name has a different extension from .eml,.mht, .msg, .pst, .zip.

mozexports the source mail into a Mozilla-compatible mailbox file (Netscape, Mozilla, Thunderbird).

pstexports the source mail into a standard Outlook PST file (ANSI format). This type of PST file has amaximum storage capacity of 2 GB and is compatible with all versions of Office Outlook. This switch isignored if you use the "mapi" token (to access a MAPI profile) as the Target value.

unicodepstexports the source mail into a Unicode PST file (Outlook 2003 or newer). This type of PST file has amaximum storage capacity of 20 GB in Outlook 2003 and 2007, 50 GB in Outlook 2010 and 2013, andis not compatible with Outlook 97, 98, 2000, and 2002. Note that this switch will create a regular ANSIPST file if your version of Microsoft Outlook is older than Outlook 2003. This switch is ignored if you usethe "mapi" token (to access a MAPI profile) as the Target value.

msgexports each MAPI source mail into a corresponding MSG file. The source must be a PST file or a MAPImail profile. This switch cannot be used if the source is also MSG files.

emlexports each source message into a corresponding EML file. Aid4Mail also saves a Mail.tab file in thetarget folder, which contains a tab-delimited list of all the exported EML files (useful if you want to importmail in a database.) This setting is not required if you specify a target name with the .eml extension.

mhtexports each source mail into a corresponding MHT file (HTML Web Archive). The format is similar toEML files. MHT files can be viewed in Internet Explorer like a regular HTML file; embedded pictures aredisplayed in the browser window and attachments can be extracted by clicking on their link. Aid4Mailautomatically 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 withthe .mht extension.

xlssimilar to the mht value, but produces an index file for viewing in Office Excel instead of InternetExplorer.

dbssimilar to the mht value, but produces an index file for importing mail data into a database.

Page 115: Aid4Mail3 Manual

Reference Information 108

Copyright © 2005-2013 Fookes Holding Ltd

attachmentsexports only the file attachments contained in the processed source mail. Aid4Mail also saves anAttach.tab file in the target folder, which contains a tab-delimited list of all the extracted attachment files.

contentsexports 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 attachmentsunder the "Attach" folder. Aid4Mail also saves an Attach.tab file in the target folder, which contains atab-delimited list of all the extracted files.

addressesexports extracted email addresses extracted from source messages. Aid4Mail automatically removesduplicates and sorts addresses in alphabetical order.

pdfexports mail to Adobe PDF file(s). By default, the PDF format options are taken from the pdf.ini file in theprogram 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 ofAid4Mail Console currently does not include the PDF export option.

zipexports mail into generic mailbox files (mbox) and stores them in a standard ZIP file. Attachments andembedded contents are stored under subfolders in the ZIP file. The resulting ZIP file is compatible withall popular ZIP utilities, like WinZip, and with Windows Explorer under Windows XP or more recent. Youmust specify a target ZIP file name without wildcards (*, ?). If the target name already exists, Aid4Mailcreates a backup of it and builds a new ZIP file. This setting is not required if you specify a target namewith the .zip extension.

TargetMail=file or folder name, "mapi", or "imap" tokenUse this setting to define a target file or folder name receiving exported mail. Tokens and systemvariables are supported. If you choose to export mail to the EML or MSG format, TargetMail shouldrepresent 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 mboxfile with a name matching that of the mail folder. If you want the exported files to use the same name asthe 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 specifiedwith the MapiProfile setting or the /n switch.

Use the "imap" token to export email to an IMAP account. The account logon settings are taken fromthe target.imap.ini file (located in the program folder), which you must modify beforehand. When usingthe "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 toinstruct Aid4Mail to create target message files that have the same name as the source mail files.

TargetNamespace=IMAP NamespaceDefines the Namespace for the target IMAP account. The /T_Namespace command-line switch overridesthis setting.

Page 116: Aid4Mail3 Manual

Aid4Mail 3 Help109

Copyright © 2005-2013 Fookes Holding Ltd

TargetPassword=passwordUse this setting to specify a password for the target PST file or IMAP account. The /T_PW command-line switch overrides this setting.

PST files: the password will create a new password-protected PST file or allow adding mail to an existingpassword-protected PST file. When you create a password-protected ANSI PST file with Aid4Mail, thehigh 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 dowith 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 thepassword from the target imap.ini file.

TargetPstFolder=folder nameDefines the base folder (or parent folder) in a PST file or Outlook email profile that will receive exportedmail. This setting is ignored if you are exporting to other mail formats. Use a backslash "\" character toseparate folder names in a path. The /b command-line switch overrides this setting.

TargetPstMaxSize=size in GB or MBIf you think your export will exceed the capacity of a single PST file, you can use TargetPstMaxSize toset a threshold value. Setting the value to zero or leaving it blank instructs Aid4Mail to not monitor thePST 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 tothe 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 overridesthis setting.

For example, if you set the size limit to 2 GB for a file called Outlook.pst and have 5 GB of mail toexport, Aid4Mail will create the following files on completion:

Outlook.pstOutlook[001].pstOutlook[002].pst

Note that Aid4Mail cannot determine exactly when the limit is reached because Outlook uses a datacache. In other words, Outlook will still send data to the PST file after Aid4Mail has measured the filesize 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 nameUse this setting to specify the logon user name for the target IMAP account. The /T_UserId command-line 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 nameTargetProfile=IMAP INI fileTargetProfile=PDF INI fileIf your target mail is defined by the "mapi" token, use this setting to specify a profile name for your targetMAPI account if it is different from your default profile name. The /T_Profile command-line switchoverrides this setting.

If your target mail is defined by the "imap" token, this setting tells Aid4Mail where to find the logonsettings file for your target IMAP account. If no file path is specified, Aid4Mail looks for it in its program

Page 117: Aid4Mail3 Manual

Reference Information 110

Copyright © 2005-2013 Fookes Holding Ltd

folder. Tokens and system variables are supported. If this setting is not used, Aid4Mail will look for thetarget.imap.ini file in the same folder as the a4m.exe program file. The /T_Profile command-line switchoverrides this setting.

If your target is a PDF file, this setting tells Aid4Mail where to find the PDF settings file. If no file path isspecified, Aid4Mail looks for it in its program folder. Tokens and system variables are supported. If thissetting 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=valueUse this setting to change the default time zone Aid4Mail uses when setting the date stamp of exportedmessage files and date values in the corresponding column of MHT target formats. The switch accepts atime zone value in one of several formats: numerical, time zone abbreviation, time zone in short form, orWindows registry time-zone name. See the Time Zones topic for more information. The /TimeZonecommand-line switch overrides this setting. Example: TimeZone=PST

UseDateField=True or FalseBy default, incoming message dates used for creating file date stamps (eml, mht, msg, extractedattachments) and Microsoft Exchange delivery time are based on the server Received date instead of theheader Date field. Set UseDateField to True to instruct Aid4Mail to extract the date from the messageDate field instead of the server Received date. The /UseDateField command-line switch overrides thissetting.

UseMapiTnefConverter=True or FalsePrior to Aid4Mail v2.1, both TNEF and regular emails were processed by the MAPI RFC 1521 Converterwhen the MapiConvOff setting was False. The MAPI RFC 1521 Converter does a good job convertingregular emails to the standards-compliant RFC 1521 format, but it produces poor results with TNEFmessages (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 isencountered. The /UseMapiTnefConverter command-line switch overrides this setting.

XMailer=valueWhen converting outgoing mail from Outlook or Exchange, Aid4Mail has to reconstruct the email headerduring the conversion procedure. To easily identify such headers, Aid4Mail inserts a standard X-Mailerfield with the value "FOOKES SOFTWARE Aid4Mail (MAPI source mail)". You can define an alternativevalue through the XMailer setting. If the value is left blank then Aid4Mail will not insert the X-Mailer field inreconstructed email headers.

2.5.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 StoredThis setting is used in conjunction with the FilterDateRange setting. It tells Aid4Mail which date field touse when filtering emails by date. By default, Aid4Mail uses the Sent date. The /ds, /dr, /dc command-line switches override this setting.

FilterDateRange=yyyy/mm/dd-yyyy/mm/ddDefines a date range filter. 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 leftdefines the start of the date range and the date on the right defines the end of the date range. You canleave 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.

Page 118: Aid4Mail3 Manual

Aid4Mail 3 Help111

Copyright © 2005-2013 Fookes Holding Ltd

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

In the following example, Aid4Mail will only process emails that were received before year 2009:FilterDateRange=-2008/12/31

FilterExclude=Words list file nameUse this setting to filter mail by contents. Aid4Mail loads the words list from the specified file andsearches each email for a match. Emails that contain any of the text criteria in the list are notprocessed. By default, Aid4Mail only searches the email header. You can extend the search to themessage text by using the FilterScope setting described below. See the Words List File topic to learnhow 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 nameUse this setting to filter mail by contents. Aid4Mail loads the words list from the specified file andsearches each email for a match. Emails that do not contain any of the text criteria in the list are notprocessed. By default, Aid4Mail only searches the email header. You can extend the search to themessage text by using the FilterScope setting described below. See the Words List File topic to learnhow 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 RawOnly use this setting if you have defined a Words List with the Include or Exclude setting. TheFilterScope 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 searchthrough 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 forspecific content types. By default, only the email header is searched. Note that searching through themessage text can significantly slow down the filtering process. The /FilterScope command-line switchoverrides this setting.

FilterScript=Script NameUse the FilterScript setting to load the specified script name. The script name can either be a fullyqualified file name or just a file name without path and extension. See the Writing Aid4Mail Scripts topicfor more information about Filter Scripts. The /FilterScript command-line switch overrides this setting.

NoFilterLog=True or FalseIf you are going to process large amounts of emails, you can improve speed slightly by setting theNoFilterLog to True. When true, Aid4Mail stops showing progress information on messages that areskipped as a result of the Aid4Mail filter settings. The /NoFilterLog command-line switch overrides thissetting.

2.5.2.4 Other Settings

This page lists miscellaneous settings you can use in the Aid4Mail Console INI file to control mailconversion.

ErrorLog=FileName

Page 119: Aid4Mail3 Manual

Reference Information 112

Copyright © 2005-2013 Fookes Holding Ltd

See the Error Log File topic for details about this switch. The /ErrorLog command-line switch overridesthis setting.

Fast=True or FalseAid4Mail does extensive text parsing and format analysis when reading generic mailbox files, includingthose created by Mozilla Thunderbird and Eudora. It does so to ensure it doesn't miss any emails whenprocessing mailbox files that contain a mix of storage formats (e.g. a Mac or Unix mbox file imported inWindows Thunderbird with new messages added to it). If you are processing mailbox files that areentirely created by a single mail client, then you can increase performance without sacrificing reliabilityby setting Fast to True. The /Fast command-line switch overrides this setting.

ImapLog=True or FalseSet this option to True to create a log file storing all communications between Aid4Mail and an IMAPserver. This feature is useful to identify issues encountered when connecting to an IMAP account orwhen uploading/downloading messages to it. These log files are saved in the "My Documents" folder anduse the .log file extension.

NoLimit=True or FalseSet this option to True if you need to run performance tests on an unlimited number of emails during trialmode. Using this feature removes the 50 email/folder trial limitation and instead replaces all exportedsubject lines with a trial notice. The /NoLimit command-line switch overrides this setting.

QuitIfTrial=True or FalseSet this option to True to terminate program execution if Aid4Mail starts in trial mode. If such atermination occurs, Aid4Mail returns an EXIT code with a value of 6. The /QuitIfTrial command-line switchoverrides this setting.

SessionName=session nameUse this option to display a session name in the console window or the output file (if redirected). Thisfeature helps you identify multiple simultaneous instances of the console. The /SessionName command-line switch overrides this setting. When used, Aid4Mail saves a text file with conversion statistics; thefile name is based on the session name. The text file is saved in the program folder unless the sessionname includes a folder name to another location. The folder name can include tokens and systemvariables. Examples:SessionName=Account072SessionName=%AllUsersProfile%\Aid4Mail Migration\Account 072

TempFolder=folder nameBy default, Aid4Mail stores temporary files in the Windows Temp folder under the logon user folder. Usethis 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 FalseSet this option to True to run Aid4Mail without user intervention. This feature is particularly useful if youplan to run Aid4Mail Console in an uninterrupted batch process. If an error occurs, no user input isrequired (like press Enter key to continue) so batch operations can continue unattended. The /Unattended command-line switch overrides this setting.

2.5.3 Words List File

You can create a list of words stored in a file that Aid4Mail can use to search for matches in eachprocessed message. The list should contain one search criteria per line. The longer the list, the longer it

Page 120: Aid4Mail3 Manual

Aid4Mail 3 Help113

Copyright © 2005-2013 Fookes Holding Ltd

will take Aid4Mail to filter each email. You can improve performance by placing the most commonsearch terms at the beginning of the list.

Matching is case sensitive for lines that have one or more uppercase characters, and case insensitive forlowercase search criteria. A match only occurs if the search criteria covers whole words. For example, ifyour 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 searchcriteria "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 aregular search criteria with a minus or hyphen character, just add a second one to cancel the negateeffect. A match with a negate criteria will reject a message if the "found in header" option is set, and willaccept 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 previouscriteria. If you must start a regular search criteria with a plus character, just add a second one to cancelthe addition effect. If the "found in header" option is set, the message is only accepted if it containsoccurrences of the preceding and current criteria. If the "not found in header" option is set, the messageis only rejected if it contains occurrences of both the preceding and current criteria. Note that the pluscharacter 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 expressionengine is based on PCRE 8.31. 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 startswith "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 "naïve","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

Page 121: Aid4Mail3 Manual

Reference Information 114

Copyright © 2005-2013 Fookes Holding Ltd

"_".

You can set or override the type of search performed by starting a line with a token character followed byan equal sign. The following are recognized:

N= produces a normal search

W= produces a wildcard search

R= produces a regular-expression search

Words list example #1:[email protected]@fookes.com

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

Words list example #2:FREEmortgage~home owner~pharma*[email protected]@adpromailer.com@emailfactoryR=free (bonus|debt|loan|money)R=c(i|1)(a|@)l(i|1)sR=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 includescriteria with wildcards and regular expression patterns.

Words list example #3:[email protected][email protected]+mailbag assistant

Aid4Mail will only accept messages that were sent to the <[email protected]> address andmention either the aid4mail or mailbag assistant products in the email.

2.5.4 Processing a List of Files

Aid4Mail Console can process file lists, which you can specify instead of a source mailbox file. File listsare plain text files that must have the .lst extension. Each line should represent a file name or file search

Page 122: Aid4Mail3 Manual

Aid4Mail 3 Help115

Copyright © 2005-2013 Fookes Holding Ltd

criteria. A file list must only contain one type of mail file to process; in other words, you cannot mixEudora and Mozilla mailbox files in a single list.

Tokens and system variables are supported in the path name and you can use wildcards "*" and "?" inthe file names. You will find details about the tokens and system variables under the topic Useful Tokensand System Variables. You can instruct Aid4Mail to search subfolders for the specified criteria bybeginning 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 mailstorage path. The second line instructs Aid4Mail to process all mailbox files in and under the Testmailbox folder.

The name of the file list is used in place of the source mailbox name. It is the first parameter in theAid4Mail Console command line. Example:

a4m.exe c:\Test\Files.lst %Outlook%\Test.pst

2.5.5 Exit Codes

Aid4Mail Console produces one of the following Exit Codes when it terminates processing:

0 = no error detected1 = command-line error2 = source file not found or format not recognized3 = one or more errors occurred during mail processing (see error log for details)4 = could not run console or unexpected fatal error5 = no messages found in source location6 = program terminated in response to the QuitIfTrial setting7 = no messages due to error accessing source account or mailbox8 = no messages due to error accessing target account or mailbox9 = processing was aborted by user

101 to 111 = a license validation error was detected (only occurs with key file)

2.5.6 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% tokentells Aid4Mail to look for the Outlook Express DBX files in the default storage location.

a4m.exe %OE%\*.dbx mapi /b="Imported Mail"

Page 123: Aid4Mail3 Manual

Reference Information 116

Copyright © 2005-2013 Fookes Holding Ltd

Similar to the previous example except that the source folder hierarchy is created under the Outlook orExchange "Imported Mail" folder (which is created if it doesn't exist) instead of the root folder. Thisapproach 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 ofthe 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 tellsAid4Mail to look for the Outlook Express DBX files in the default storage location. When the target PSTfile reaches a size of 20 GB, Aid4Mail stops transferring mail to it, creates a new Outlook[001].pst fileand 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:\ThumbdriveData\" 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 MicrosoftOutlook (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 tothe "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 Outlookemail profile. The %Thunderbird% token tells Aid4Mail to look for the Thunderbird mailbox files in thedefault 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 orExchange "Imported Mail" folder (which is created if it doesn't exist) instead of the root folder. Thisapproach 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 isexported to the "John Doe" email profile instead of the default profile.

a4m.exe %Thunderbird%\*.* %Outlook%\Outlook.pst /m=moz /a /T_PstSize=20

Imports locally stored mail (not IMAP folders) from Thunderbird and appends it to the default Outlook.pstfile. The %Thunderbird% token tells Aid4Mail to look for the Thunderbird mailbox files in the defaultstorage location. When the target PST file reaches a size of 20 GB, Aid4Mail stops transferring mail toit, creates a new Outlook[001].pst file and resumes mail export to the new PST until the size limit isreached, 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, youcan open the TBird.pst file through the File/Open/Outlook Data File menu command in Microsoft Outlook

Page 124: Aid4Mail3 Manual

Aid4Mail 3 Help117

Copyright © 2005-2013 Fookes Holding Ltd

(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 "LocalFolders").

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 theOutlook'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, fromthe "T:\Thumbdrive Data\" folder and stores them under the "Imported Mail" folder in Thunderbird. If theOutlook.pst includes related split files (Outlook[001].pst, Outlook[002].pst, etc.), Aid4Mail will processthem 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 orthe "My Documents" folder instead if it is write protected. The resulting mailbox files are namedaccording to the source mail folder names are are stored in the mbox format. Emails are appended toexisting mbox files.

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 mboxformat 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.), Aid4Mailwill 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 defaultOutlook email profile.

Page 125: Aid4Mail3 Manual

Reference Information 118

Copyright © 2005-2013 Fookes Holding Ltd

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 "MyDocuments" folder. Because the "/a" append switch is not used here, Aid4Mail always creates a newPST file. If the Mbox_Archives_2011.pst file already exists, Aid4Mail renames it to preserve a backupcopy. When the target PST file reaches a size of 20 GB, Aid4Mail stops transferring mail to it, creates anew Mbox_Archives_2011[001].pst file and resumes mail export to the new PST until the size limit isreached, 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 underthe 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 thedefault 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 (Aid4Mailcreates if it it doesn't already exist). Once completed, you can open the Archives.pst file through theFile/Open/Outlook Data File menu command in Microsoft Outlook (older versions of Outlook may useslightly 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 individualEML file under the "Imported Mail" folder. The source folder hierarchy is reproduced under the targetfolder. All attachments and embedded contents are extracted from the messages and stored under theAttach 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

Page 126: Aid4Mail3 Manual

Aid4Mail 3 Help119

Copyright © 2005-2013 Fookes Holding Ltd

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 profileto 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 /msga4m.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 profileto 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 theWindows "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 emailprofile. 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 logonsettings are taken from the Gmail.imap.ini file (placed in the program folder), which you must modifybeforehand.

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.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 IMAPlogon settings are taken from the source.imap.ini file (placed in the program folder), which you mustmodify 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.

Page 127: Aid4Mail3 Manual

Reference Information 120

Copyright © 2005-2013 Fookes Holding Ltd

a4m.exe %Outlook%\Backup.pst imap

Exports mail from the Backup.pst file in the Outlook data folder to an IMAP account. The IMAP logonsettings are taken from the target.imap.ini file (placed in the program folder), which you must modifybeforehand.

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 ofthe target IMAP account. The source IMAP logon settings are taken from the source.imap.ini file andthe target settings from the target.imap.ini file (placed in the program folder), which you must modifybeforehand.

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 takenfrom the Yahoo.imap.ini file and the target settings from the Gmail.imap.ini file (placed in the programfolder), 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 embeddedcontents are detached from the messages and stored under the Attach and Embedded subfoldersrespectively; these contents are easy accessible by opening Backup.zip in Windows Explorer or a ZIPutility.

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 "RestoredMail" folder. Detached attachments and embedded contents are re-inserted into their correspondingmessages 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 formatcan then easily be imported into a database.

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 embeddedcontents are detached from the messages and stored under the Attach and Embedded subfoldersrespectively.

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 filefor viewing in Internet Explorer. Progress information and error messages are redirected from the consolewindow to the log.txt file.

Page 128: Aid4Mail3 Manual

Aid4Mail 3 Help121

Copyright © 2005-2013 Fookes Holding Ltd

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 Addresses.lst" /DelSource=Fast

Extracts mail from the default Outlook email profile received during April 2012 and matching one of theemail addresses listed in the "VIP Email Addresses.lst" file (placed in the program folder). Matchingmessages are saved as MSG files under the "April 2012" folder and then deleted from the defaultOutlook email profile.

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

Exports Thunderbird messages that contain JPG images, or .mov and .avi movie files (using the Has jpgmov avi.s4f script) to EML files. File attachments and embedded contents are detached from themessages 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 namesare 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.

2.6 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 byediting an INI file in a text editor. The settings INI files are stored either in the Aid4Mail program folder orunder the Aid4Mail AppData (or Application Data) folder. The file name starts with the settings namefollowed 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

Page 129: Aid4Mail3 Manual

Reference Information 122

Copyright © 2005-2013 Fookes Holding Ltd

supported by Synapse TCP include IPv4, IPv6, SSL/TLS, SOCKS4/4a/SOCKS5 proxy servers (outgoingconnections 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 areautomatically saved when you click on the "Next" button. Click on the "Save As" button to store settingsunder new name. To delete settings, select a name from the Settings drop-down list and then press theDelete key while the field has the focus.

Connection Security OptionsNone – 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 beupgraded 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 ifAid4Mail is unable to correctly identify your private account top-level folder. The namespace for a sharedfolder 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 forthe shared or public mail folders you need to access.

You should only set the "Max. folder depth" field if the target IMAP account only supports a limiteddepth of folders. For example, GMX Mail only supports 3. With some accounts running under a DovecotIMAP 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 foldernames (number of characters). Most IMAP servers allow folder names with more than 100 characters sothis field can be left blank. Some popular mail services like GMX Mail and Zoho Mail only allow foldernames with less than 100 characters (30 for GMX and 50 for Zoho), so to ensure successful exports youneed 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 isset to None. Aid4Mail supports SOCKS4 and SOCKS5 proxy servers, and tunneling through an HTTPproxy server. Select the appropriate proxy protocol from the drop-down list in the Type field.

Log IMAP Communications

You can create a log file storing all communications between Aid4Mail and an IMAP server by turning onthe Log IMAP Communications option available through the Software button menu. This feature is usefulto identify issues encountered when connecting to an IMAP account or when uploading/downloadingmessages 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 thecommand 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 migratea folder that has forbidden characters in the name, the target IMAP server will error. As a result, none of

Page 130: Aid4Mail3 Manual

Aid4Mail 3 Help123

Copyright © 2005-2013 Fookes Holding Ltd

the emails and subfolders contained in the source folder are migrated. You can solve this type of issueby using a special template file called NameFilter.dat. Open the file NameFilter.txt for instructions and aworking 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 theweb interface which only allows one level of folders and limits their length to 32 characters. Folder thatcontain subfolders are not displayed in the web interface.

Server Name: imap.aim.comPort: 993Connection Security: SSL/TLSMax. folder length: 100

FastMail

The folder hierarchy displayed through the FastMail web interface is consistent with the folder hierarchyavailable through the IMAP protocol.

Server Name: imap.messagingengine.comPort: 993Connection Security: SSL/TLS

Gmail

If you haven't already done so, please make sure to Enable IMAP in Gmail before connecting to youraccount with Aid4Mail. Note also that you'll have to set up an application-specific password for Aid4Mailif 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 webinterface 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 manyfolders/labels with duplicate mail. If you are exporting mail from a Gmail account, you can filter outduplicates by setting the "Check for Duplicates Across Folders" option under the Advanced Optionsmenu and the "Do not add duplicate messages" setting on the Export Options screen. To optimize thisduplicates 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 anddownload up to 2,500 MB of email per day. Furthermore, the maximum email size you can upload is 35MB (including all attachments).

Server Name: imap.gmail.comPort: 993Connection Security: SSL/TLS

Page 131: Aid4Mail3 Manual

Reference Information 124

Copyright © 2005-2013 Fookes Holding Ltd

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 serversaccept (like +, #, [, ], !, "). Aid4Mail automatically corrects invalid folder names on export to GMX, butyou must set the "Max. folder depth" field to 3 and the "Max. folder length" field to 30 in the configurationsettings.

Server Name: imap.gmx.comPort: 993Connection Security: SSL/TLSMax. folder depth: 3Max. folder length: 30

Outlook.com

The folder hierarchy displayed through the Outlook.com interface is consistent with the folder hierarchyavailable through the IMAP protocol. Some common characters are not accepted in the folder name.These include &, <, >, :, ", ', (, ), +, ;, /, \. Aid4Mail automatically corrects invalid folder names on exportto Outlook.com.

Server Name: imap-mail.outlook.comPort: 993Connection Security: SSL/TLS

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

The folder hierarchy displayed through the Office 365 interface is consistent with the folder hierarchyavailable through the IMAP protocol.

Server Name: outlook.office365.comPort: 993Connection Security: SSL/TLS

Yahoo! Mail

Please note that, at this time of writing, IMAP access to a Yahoo! Mail account is not officiallysupported by Yahoo. As a result, there is no guarantee that this option will be available in the future orthat it will work the same way.

Although Yahoo! Mail supports a multi-level folder structure through IMAP, this is not the case with theweb interface which only displays one level of folders and limits their length to 30 characters. Subfoldernames are part of the top level name and separated with a forward slash character. Example: Folder1/Folder2/Folder3.

Server Name: imap.mail.yahoo.comPort: 993

Page 132: Aid4Mail3 Manual

Aid4Mail 3 Help125

Copyright © 2005-2013 Fookes Holding Ltd

Connection Security: SSL/TLS

Zoho Mail

If you haven't already done so, please make sure to enable IMAP access before connecting to youraccount 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 hierarchyavailable through the IMAP protocol. In both access methods, folder names allow up to 50 characters.

Server Name: imap.zoho.comPort: 993Connection Security: SSL/TLSMax. folder length: 50

Other IMAP Accounts

The above list only covers the most popular IMAP services currently available. If your service is notlisted, you will have to check its documentation or contact the help desk to determine the appropriatesettings. Supported IMAP servers include Courier, Cyrus, Dovecot, Zimbra, Microsoft Exchange, NovellGroupWise, Lotus Domino, etc.

2.7 Fixing Attachment Folder References

Some email client programs like Eudora, Calypso, The Bat!, PocoMail, and Barca, extract attachmentsfrom messages and store them in a separate folder. A reference to the disk file is then inserted in thecorresponding email to preserve the link between them. Unfortunately, email clients do not provide ameans to update this reference when the location of the attachment folder is changed. When the link isbroken, 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 filesat 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 candefine a configuration file to tell Aid4Mail where to look for extracted attachments. To do so, create anINI file called Tokens.ini and save it in the Aid4Mail program folder or place it in the Aid4Mail folderunder Application Data. Note that any changes you make to the file must be saved before you launchAid4Mail, or else they might not be picked up by the software.

Add the section [SubstPaths] to the Tokens.ini file followed by the old drive/path names and theircorresponding 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 beenmoved around several times, you may have several different path references that need correcting. In thiscase, Aid4Mail will test each item sequentially until it finds the file or reaches the end of the list. You do

Page 133: Aid4Mail3 Manual

Reference Information 126

Copyright © 2005-2013 Fookes Holding Ltd

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 Pro\=C:\Program Files\Eudora 7\C:\Program Files\Eudora 4\=C:\Program Files\Eudora 7\C:\Program Files\Eudora 5\=C:\Program Files\Eudora 7\C:\Program Files\Eudora 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 modifythe 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 ormoved all the files to one location, then you can use the special Attachments and Embedded values toidentify 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.docD:\My Documents\My Pictures\Drafts\Logo-1.jpgD:\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:

[SubstPaths]Attachments=F:\My Documents\Eudora\Attachments\

that will then instruct Aid4Mail to look for the three attachment files in the following place:F:\My Documents\Eudora\Attachments\Contract.docF:\My Documents\Eudora\Attachments\Logo-1.jpgF:\My Documents\Eudora\Attachments\Logo.tif

2.8 Useful Tokens and System Variables

Aid4Mail supports tokens that represent either fully qualified folder names, system variables, or user-defined strings. A token must be delimited with either a percent character (%) or a dollar sign ($). If youare going to use tokens in a batch-file script, you must use the "$" character as a delimiter instead of"%".

Page 134: Aid4Mail3 Manual

Aid4Mail 3 Help127

Copyright © 2005-2013 Fookes Holding Ltd

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 /USBcommand-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%returns the Windows "My Pictures" folder

The following tokens are usually recognized if you have the corresponding mail client installed. Thesetokens return the folder that contains the mail files if it exists:

%Agent%%Barca%%Eudora%%Mozilla%%Netscape%%OE%%Outlook%%Pegasus%%PocoMail%

Page 135: Aid4Mail3 Manual

Reference Information 128

Copyright © 2005-2013 Fookes Holding Ltd

%TheBat%%Thunderbird%%WindowsMail%

Depending on your mail client's setup, Aid4Mail may not find the correct folder containing your mail. Ifthat happens the token returns an empty string. If you know the full path to your mail folder, you canredefine 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) orplace it in the Aid4Mail folder under Application Data. Add the section [Tokens] followed by the tokennames and their values. Note that any changes you make to the file must be saved before you launchAid4Mail, 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\2007Thunderbird=%AppData%\Backups\MailBackups=D:\Backups\Netscape

The following lists a small selection of predefined system variables typically available under Windows2000, XP, Vista, and Win7 with examples of possible default values assuming "Administrator" is thename 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

%ProgramFiles%C:\Program Files

%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

Page 136: Aid4Mail3 Manual

Aid4Mail 3 Help129

Copyright © 2005-2013 Fookes Holding Ltd

2.9 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 informationwhen it needs to determine what file extension to add to an extracted attachment, or what MIME type itmust 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 FileExtensions: Mime-Ext.dat and Ext-Mime.dat. If necessary, these lists can be edited by advancedusers as long as the simple data format is preserved (one item per line and a tab character separatesthe two columns). In order to avoid losing edits when updating the Aid4Mail software, you should storecustom versions of those two files in the Aid4Mail user folder under Application Data; example:

On a Windows 2000/XP system, look forC:\Documents and Settings\<user>\Application Data\Aid4Mail

On a Windows 7 and Vista systems, look forC:\Users\<user>\AppData\Roaming\Aid4Mail

Note that any changes you make to these files must be saved before you launch Aid4Mail, or else theymight not be picked up by the software.

2.10 Time Zones

A time zone is a region of the World where a common standard time is used, usually referred to as thelocal time. Email messages usually include this information in the header date field. Most emailprograms convert such dates to your local time for display purposes. Doing so ensures that you canreliably sort messages from around the World by date no matter what time zone you are in.

Unlike an email client program, Aid4Mail usually does not have to adjust dates to a local time zonewhen converting mail to another format – the target mail program takes care of that when it displaysemail 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 calculatedwhen you export to one of the MHT target formats (Excel worksheets, web pages, or database files).

Dates are adjusted to your local time zone by default – just like your mail client program. Prior to thatversion, dates were adjusted to UTC time. If necessary, you can use the /TimeZone command-lineswitch to change the default time zone used by Aid4Mail. The switch is supported by both the Aid4MailGUI 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

Page 137: Aid4Mail3 Manual

Reference Information 130

Copyright © 2005-2013 Fookes Holding Ltd

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

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 longas the simple data format is preserved (one item per line and a tab character separates the twocolumns). In order to avoid losing edits when updating the Aid4Mail software, you should store modifiedversions of the file in the Aid4Mail user folder under Application Data; example:

On a Windows 2000/XP system, look forC:\Documents and Settings\<user>\Application Data\Aid4Mail

On a Windows 7 and Vista systems, look forC:\Users\<user>\AppData\Roaming\Aid4Mail

The list below shows the main time-zone abbreviations with daylight settings that Aid4Mail recognizesthrough the /TimeZone switch (settings stored in the DST.dat file):

ACST Australian Central TimeACWST Australian Central Western TimeAEST Australian Eastern TimeAET Australian Eastern TimeAKST Alaska TimeAST Atlantic TimeAWST Australian Western TimeCET Central European TimeCST Central TimeEET Eastern European TimeEST Eastern TimeGMT Western European TimeMCK Moscow TimeMET Central European TimeMSK Moscow TimeMST Mountain TimeNZST New Zealand TimePST Pacific TimeWET Western European Time

Any changes you make to these files must be saved before you launch Aid4Mail, or else they might notbe picked up by the software.

2.11 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 Aid4Mailprogram folder. Advanced users can edit these to modify the format of the target files created byAid4Mail during mail conversion. If you plan to edit template files, make sure you keep a backup copy ofthe original files. Also make sure you save backup copies of your modified templates before you install anew 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 theymight not be picked up by the software.

Page 138: Aid4Mail3 Manual

Aid4Mail 3 Help131

Copyright © 2005-2013 Fookes Holding Ltd

IMPORTANT: Please note that Fookes Software does not provide support for custom templates. If youchoose to create or modify a template, you accept that you will receive no help from Fookes Software'scustomer 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}{target_folder}{time_zone}

Aid4Mail Console and Aid4Mail eDiscovery also support the following field, which inserts the MD5 valueof the email message:

{message_md5}

2.12 Error Log File

Unfortunately, email conversions are not always perfect and errors can occur. These errors may resultfrom corrupted mail files, missing attachment files, or software bugs. Aid4Mail automatically stores errormessages resulting from email processing in a log file called ErrorLog.txt. By default, the Aid4Mail GUIsaves the file under the "Application Data\Aid4Mail" folder, whereas Aid4Mail Console saves it in theprogram folder. Once email has been processed, Aid4Mail automatically opens the log file in theassociated 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, thesecond has the name of the file that is being processed, the third is the name of the mailbox, the fourthhas the date taken from the email header, and the fifth the email subject line. In some cases, the threelast 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.

Page 139: Aid4Mail3 Manual

Reference Information 132

Copyright © 2005-2013 Fookes Holding Ltd

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 SystemVariables 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 filename. 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 logfile name without a file extension. Example:Aid4Mail.exe /ErrorLog="%MyDocs%\Aid4MailErrors"

2.13 Advanced Options

The special options listed below are available either through command-line switches or the AdvancedOptions submenu of the Software button menu.

Strict File Format CheckWhen this option is set, Aid4Mail checks both the file extension and contents to see if they conformwith the selected source format. You can instruct Aid4Mail to be more "tolerant" with certain file typesby turning off this option. This option is turned on by default when you start Aid4Mail. You can alsocontrol this option through the command line with the /m switch.

Use Received Date FieldBy default, incoming message dates used for creating file date stamps (eml, mht, msg, extractedattachments) and Microsoft Exchange delivery time are based on the server Received date instead of theheader Date field. Turn off this option to instruct Aid4Mail to extract the date from the message Date fieldinstead of the server Received date. You can also control this option through the command line with the /UseDateField switch.

Header-based MD5 File NamesPrior to Aid4Mail version 2.11, the MD5 signature for EML and MHT file names was computed from thefull 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 ormissing (usually in outbound messages), Aid4Mail uses the email date and subject line for thecomparison, or other fields (To, Cc, Bcc, From delimiter) from the message header if either of thosevalues are blank, or the whole header.

Check for Duplicates Across FoldersThis option affects the behavior of the "Do not add duplicate messages" setting on the Export Optionsscreen and is ignored if the setting is unchecked. When this option is unchecked, filtering for duplicatesis limited to the contents of the target folder. When the option is set, Aid4Mail filters out all messageduplicates, including those of emails exported to previous target folders. You can also control this optionthrough the command line with the /SkipAllDups switch.

Use MAPI TNEF Converter

Page 140: Aid4Mail3 Manual

Aid4Mail 3 Help133

Copyright © 2005-2013 Fookes Holding Ltd

Prior to Aid4Mail v2.1, both TNEF and regular emails were processed by the MAPI RFC 1521 Converterwhen the option was set. The MAPI RFC 1521 Converter does a good job converting regular emails tothe standards-compliant RFC 1521 format, but it produces poor results with TNEF messages (to avoiddata 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 alsoset 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 defaultbehavior prior to Aid4Mail 2.1.

Save TNEF as Winmail.dat AttachmentsWhen "Use MAPI TNEF Converter" is turned on, use this option to save TNEF data in a winmail.datattachment when converting mail to the RFC 1521 format. Turn this option off if you do not wish to createwinmail.dat attachments. You can also set this option through the command line with the /AddWinmailDat switch.

Due to their impact on email processing, changes to the options below are not restored across Aid4Mailsessions. You will have to reset them again, if necessary, after you restart Aid4Mail.

Fast Mail Processing (less safe)Aid4Mail does extensive text parsing and format analysis when reading generic mailbox files, includingthose created by Mozilla Thunderbird and Eudora. It does so to ensure it doesn't miss any emails whenprocessing mailbox files that contain a mix of storage formats (e.g. a Mac or Unix mbox file imported inWindows Thunderbird with new messages added to it). If you are processing mailbox files that areentirely created by a single mail client, then you can increase performance without sacrificing reliabilityby turning this option on.This option is turned off by default when you start Aid4Mail. You can alsocontrol this option through the command line with the /fast switch.

Use MAPI RFC 1521 ConverterWith Outlook 2003 and more recent versions, Aid4Mail uses the internal MAPI converter to import/exportmail from Outlook PST and MSG files, and Exchange server stores. The advantage of this method is thatit often converts messages with non-Latin characters and certain special email types more reliably thanthe Aid4Mail method. The disadvantage of the internal MAPI converter is that it is usually slower thanAid4Mail's conversion method. Only turn off this option if you are encountering conversion issues with itor if processing speed is critical. This option is turned on by default when you start Aid4Mail. You canalso 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 MAPIRFC 1521 Converter. Original SMTP headers were replaced with a simplified version. For most users theeffects of this bug are not noticeable, or at most a minor inconvenience. However, for those working inthe field of e-discovery and forensic examination such loss of data is unacceptable. We recommend thatyou download and install the latest maintenance release for Outlook 2010.

Fix MAPI Header ErrorsWhen using the MAPI RFC 1521 converter to process mail from Outlook PST and MSG files, andExchange server store formats to RFC text-based formats (MIME), results may differ significantly fromthe original format. When this option is set, Aid4Mail fixes all format inconsistencies it detects based onthe original header data. These fixes ensure that the converted email is as faithful as possible to theoriginal message and reduces the risk of data loss. The disadvantage of this option is that it slows downconversion and in some very rare cases may cause incorrect conversions. This option is turned on bydefault when you start Aid4Mail. You can also control this option through the command line with the /MapiFixOff switch.

Page 141: Aid4Mail3 Manual

Reference Information 134

Copyright © 2005-2013 Fookes Holding Ltd

Log IMAP CommunicationsTurn 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 whenuploading/downloading messages to it. These log files are saved in the "My Documents" folder and usethe .log file extension. This option is turned off by default when you start Aid4Mail. You can also set thisoption through the command line with the /ImapLog switch.

Log for Incremental Processing...This option affects the behavior of the "Do not add duplicate messages" setting on the Export Optionsscreen and is ignored if the setting is unchecked. Use it to create or open a log file that keeps track ofwhich emails have been processed. If you open an existing log file, Aid4Mail will skip any email that isreferenced in it. This feature is useful if you want to avoid exporting the same email more than once evenafter you restart Aid4Mail.

Note that the references stored in the log file are sensitive to the state of the "Check for DuplicatesAcross Folders" option. In other words, if the log file was created when the option was unchecked, thenrunning Aid4Mail again with the option checked will result in failure to match any of the references. As aresult all emails will be processed again.

In Aid4Mail Console you can set the log file through the /SkipDups and /SkipAllDups command-lineswitches.

2.14 GUI Command-Line Switches

The GUI version of Aid4Mail (i.e. not the console) supports several command-line switches that you canuse to alter some of its default features. You can specify several switches in the command line as longas each one is separated by a space. You can either use a forward slash (/) or a hyphen (-) to mark thestart of a switch. If you need more control over operations through the command-line, please considerusing Aid4Mail Console.

There are two main ways you can run Aid4Mail with one or more command-line switches. Either launchAid4Mail 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'sshortcut Properties dialog box and adding one or more switches at the end of the Target field on theShortcut 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 amode that improves compatibility. Use this switch to override this detection andturn accessibility mode on or off depending on switch value.

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

Page 142: Aid4Mail3 Manual

Aid4Mail 3 Help135

Copyright © 2005-2013 Fookes Holding Ltd

eml file extension. Set the "ext" value either to the corresponding file extensionor 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 genericmailbox files, including those created by Mozilla Thunderbird and Eudora. It doesso to ensure it doesn't miss any emails when processing mailbox files thatcontain a mix of storage formats (e.g. a Mac or Unix mbox file imported inWindows Thunderbird with new messages added to it). If you are processingmailbox files that are entirely created by a single mail client, then you canincrease performance without sacrificing reliability by using the /fast switch. Thissetting is also available through the "Software/Advanced Options/Fast MailProcessing" menu command. Example: Aid4Mail.exe /fast

/ImapLog Use this switch to create a log file storing all communications between Aid4Mailand an IMAP server. This feature is useful to identify issues encountered whenconnecting 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 fileextension. This setting is also available through the "Software/AdvancedOptions/Log IMAP Communications" menu command. Example: Aid4Mail.exe/ImapLog

/m Aid4Mail checks both the file extension and contents to see if they conform withthe selected source format. You can instruct Aid4Mail to be more "tolerant" withcertain file types by running it with the /m command-line switch. This can beuseful with files that start with a non-conforming format. This setting is alsoavailable 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 converterto import/export mail from Outlook PST and MSG files, and Exchange serverstores. The advantage of this method is that it converts messages with non-Latincharacters and certain special email types more reliably than the Aid4Mailmethod. The disadvantage of the internal MAPI converter is that it is usuallyslower than Aid4Mail's conversion method. Only use the /MapiConvOff switch ifyou are encountering conversion issues with it or if processing speed is critical.This setting is also available through the "Software/Advanced Options/Use MAPIRFC 1521 Converter" menu command. Example: Aid4Mail.exe /MapiConvOff

/MapiFixOff When using the MAPI RFC 1521 converter to process mail from Outlook PSTand MSG files, and Exchange server store formats to RFC text-based formats (MIME), results may differ significantly from the original format. When this optionis set, Aid4Mail fixes all format inconsistencies it detects based on the originalheader data. These fixes ensure that the converted email is as faithful aspossible to the original message and reduces the risk of data loss. Thedisadvantage of this option is that it slows down conversion and in some veryrare cases may cause incorrect conversions. Use the /MapiFixOff switch toturn 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

/NoLimit If you need to run performance tests on an unlimited number of emails, add the /

Page 143: Aid4Mail3 Manual

Reference Information 136

Copyright © 2005-2013 Fookes Holding Ltd

NoLimit switch to your Aid4Mail command line. Using it removes the 50 email/folder trial limitation and instead replaces all exported subject lines with a trialnotice.

/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 AcrossFolders" option under the Advanced Options menu.

/TimeZone Use this switch to change the default time zone Aid4Mail uses when setting thedate stamp of exported message files and date values in the correspondingcolumn of MHT target formats. The switch accepts a time zone value in one ofseveral formats: numerical, time zone abbreviation, time zone in short form, orWindows registry time-zone name. See the Time Zones topic for moreinformation.

/trial Removes the local activation data files and starts Aid4Mail in trial mode. Thisoption is also available through the "Software/Clear Activation Code" menucommand.

/UseDateField By default, incoming message dates used for creating file date stamps (eml,mht, msg, extracted attachments) and Microsoft Exchange delivery time arebased on the server Received date instead of the header Date field. Use the /UseDateField to instruct Aid4Mail to extract the date from the message Datefield instead of the server Received date. This setting is also available throughthe "Software/Advanced Options/Use Received Date Field" menu command.

2.15 Glossary

2.15.1 ANSI PST

ANSI PST files can be created and read by all versions of Office Outlook. They are typically used tostore 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 and 2013 filesize limit for Unicode PST is 50 GB. Note that the PST size limit may be set smaller through registrysettings (see this Microsoft Knowledge Base).

2.15.2 Attachment

An attachment is a file such as a word processing document, spreadsheet, graphics or sound that hasbeen sent along with an email message. The contents of the attachment usually do not appear in themessage itself, but instead must be opened separately.

2.15.3 CLI

CLI stands for command-line interface. It is a text-only interface that receives instructions through akeyboard or is executed from other programs. Unlike a graphical user interface (GUI), it does notrespond to mouse clicks and does not display buttons, menus, and graphics. Aid4Mail Console uses acommand-line interface; all the other Aid4Mail editions use a graphical user interface.

Page 144: Aid4Mail3 Manual

Aid4Mail 3 Help137

Copyright © 2005-2013 Fookes Holding Ltd

2.15.4 Delimiter

Commas, quotes, spaces, tabs, semi-colons, words, phrases, line breaks, and mixtures of thereof (butnot 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 bycommas. The comma is the delimiter, because it separates the items from each other. Email clientsuse delimiters to separate each message in the mailboxes. It tells the program where one messageends and the next one starts. For example, Eudora uses "From ???@???" (without the quotes) at thebeginning of a line to separate, or delimit the email messages from one another. Aid4Mail can makeaddress books from email using commas or tabs as delimiters (or separators).

2.15.5 Embedded contents

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

2.15.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.15.7 Exchange mailbox

The delivery location for all incoming mail messages addressed to a designated owner. Information in auser's mailbox is stored in the private information store on a Microsoft Exchange Server computer. Amailbox 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.15.8 Folder

See Message Folder and Mailbox.

2.15.9 Generic mailbox

A generic mailbox is a file that contains email messages that are stored in a non-proprietary format. Allmessages in a generic mailbox are concatenated and stored as plain text. Each message begins with aFrom_ line, continues with a series of non-From_ lines, and ends with a blank line. A From_ line meansany line that begins with the characters F, r, o, m, and space. The file format complies with the mboxstandard, which most mail clients can read or import.

2.15.10 GUI

GUI stands for graphical user interface. It is a type of user interface that allows interaction between amouse, keyboard, and/or touch-screen and graphical elements like buttons, menus, and other visualobjects. 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 acommand-line interface (CLI) which only offers a text-based interface.

2.15.11 IMAP

IMAP is an acronym for Internet Message Access Protocol. It is an internet standard protocol used toaccess and organize messages on a remote mail server. Popular services like Gmail offer IMAP accessto their mail accounts.

Page 145: Aid4Mail3 Manual

Reference Information 138

Copyright © 2005-2013 Fookes Holding Ltd

2.15.12 Information store

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

2.15.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. Mailboxesand folders generally mean the same thing, but if you tell somebody that is using Outlook to look in theirSent mailbox they might not understand you since Outlook uses the term folders all the time for theirmailboxes.

2.15.14 MAPI

The Messaging Application Program Interface (MAPI) is an extensive set of functions that developerscan use to create mail-enabled applications. The full function library is known as MAPI 1.0 or ExtendedMAPI. 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 soforth.

Simple MAPI is a subset of Extended MAPI, which supports only basic messaging functionality. Itincludes functions to send and receive messages, and read mail stored in the Inbox.

2.15.15 MAPI folder

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

2.15.16 mbox

The mbox format is a common storage structure for email messages. An mbox is a single file containingzero or more email messages. A message stored in mbox format begins with a From_ line, continueswith a series of non-From_ lines, and ends with a blank line. A From_ line means any line that beginswith the characters F, r, o, m, space.

This format should not be confused with the Pine MBX format. Although there's only one characterdistinguishing 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.

2.15.17 MAPI store

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

2.15.18 MD5

MD5 is a message-digest algorithm. The algorithm takes as input a message of arbitrary length andproduces as output a 128-bit "fingerprint" or "message digest" of the input. It is conjectured that it iscomputationally infeasible to produce two messages having the same message digest, or to produce

Page 146: Aid4Mail3 Manual

Aid4Mail 3 Help139

Copyright © 2005-2013 Fookes Holding Ltd

any message having a given pre-specified target message digest.

2.15.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.15.20 Message-ID

Message-ID is the name of a field usually present in the header of all email messages that havetransited through a mail server. Its value, which is enclosed in angle brackets (<>), is required to beglobally unique. That is, no two different messages should ever have the same Message-ID value. Theuniqueness of the message identifier is normally guaranteed by the host which generates it. A commontechnique used by many message systems is to create a value with a time and date stamp along withthe local host's domain name. Example: <[email protected]>.

2.15.21 MHT files

MHT files are very similar to EML files. The main difference is that EML files are usually displayed inOutlook Express (or any other compatible mail client) and MHT files in Internet Explorer (or any othercompatible web browser). Microsoft calls these files "Web archives."

A "Web archive" usually consist of a web page and its contents saved in Multipurpose Internet MailExtension HTML (MHTML) format with a .mht file extension. All relative links in the web page areremapped and the embedded content is included in the .mht file, rather than being saved in a separatefolder. The absolute references or hyperlinks on the web page remain unchanged and the .mht file isviewed using Internet Explorer.

2.15.22 MHTML

MHTML stands for "MIME Encapsulation of Aggregate HTML Documents." It is an internet standard thatdefines the MIME (Multipurpose Internet Mail Extensions) structure used to send HTML content in emailmessage bodies. MHTML enables you to send and receive webpages and other HTML documents usingemail 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 thanattaching them to the message.

2.15.23 MIME

Multipurpose Internet Mail Extensions (MIME) defines a format and general framework for therepresentation of a wide variety of data types in internet mail.

2.15.24 PDF/A

PDF/A is a file format (ISO standard) for the long-term preservation of self-contained electronicdocuments. It is a subset of PDF, obtained by leaving out PDF features not suited to long-term archiving.All of the information necessary for reliably displaying the document is embedded in the file. However, aPDF/A document may not be reliant on external information, for example links to external image files orfonts that are not embedded.

Note that federal courts in the U.S. are moving towards adopting PDF/A as the standard format forelectronic filing to ensure the long-term preservation of case-related documents. All courts currentlyaccept 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.

Page 147: Aid4Mail3 Manual

Reference Information 140

Copyright © 2005-2013 Fookes Holding Ltd

2.15.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 arule. PSTs are often used so that messages will be accessible while the user is offline.

2.15.26 Plain text

A document that contains nothing but the standard range of numbers, letters and punctuation included inthe 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 filenames which end with the .txt extension. Plain text is the most portable format because it is supportedby nearly every application on every machine.

2.15.27 Private information store

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

2.15.28 Profile

A file containing essential information used by mail clients, which may include the location of arecipient's Inbox, Outbox, address lists, information stores, and other information services.

2.15.29 Public information store

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

2.15.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 (notan entity such as a company, institution, school, or any other organization) to whom an email messageis sent. If an email account is not assigned to a natural person, then the entity's corresponding serviceor department constitutes the "recipient"; for example, the Sales Department of an organization would bethe recipient of the address <[email protected]> if more than one staff member is responsible forreplying to messages sent to the email account.

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

2.15.32 Rich text

Also known as styled text. The result of adding information to plain text. Examples of information thatcan be added include font data, color, formatting information, phonetic annotations, interlinear text, andso 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.

Page 148: Aid4Mail3 Manual

Aid4Mail 3 Help141

Copyright © 2005-2013 Fookes Holding Ltd

2.15.33 SSL

SSL stands for Secure Socket Layer and is a cryptographic protocol that provides security forcommunications over networks such as the internet. It is the predecessor of the Transport LayerSecurity (TLS). OpenSSL is a widely used open source implementation of the SSL and TLS protocols.

2.15.34 Status Flags/Indicators

The symbols, icons, or text that is displayed in the message index grid which represent whether themessage has been unread, read, forwarded, redirected, priorities, and attachments. Not all email clientsand 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 andOutlook Express do not differentiate the high from highest and low from lowest priorities; they just showhigh or low.

2.15.35 Styled Text

See Rich Text.

2.15.36 Thumb drive

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

2.15.37 TLS

TLS stands for Transport Layer Security and is a cryptographic protocol that provides security forcommunications 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.15.38 TNEF

TNEF (Transport Neutral Encapsulation Format) is a proprietary format of email attachment used byMicrosoft Outlook and Microsoft Exchange Server when sending messages formatted as Rich TextFormat (RTF). Most non-Microsoft mail clients cannot decipher TNEF data. Consequently, when youreceive a TNEF-encoded message with a non-Microsoft mail client, the TNEF part usually appears as anattached file (usually named WINMAIL.DAT).

2.15.39 Unicode PST

Unicode PST files are a new storage format introduced by Outlook 2003. They are typically used to storemail, addresses, calendar items, and notes. Under Outlook 2003 and 2007, each file has a maximumstorage capacity of 20 GB, which is 10 times more than ANSI PST files. The default Outlook 2010 and2013 file size limit is 50 GB. Unlike ANSI PST files, they cannot be opened in Outlook 97, 98, 2000, and2002. Note that the PST size limit may be set smaller through registry settings (see this MicrosoftKnowledge Base).

2.15.40 Unpurged mail

When you move a message from one folder to another in your email client, or delete a message, theprocess is more complicated that it would initially seem. A copy of the message is placed in theappropriate destination folder, but the original message is not removed immediately. Instead it is flaggedas "unpurged", and hidden from display, until such a time that the folder that contains it is compacted orexpunged.

The reason for this behavior is to optimize the move/delete process by not having to reorganize amailbox every time a message is removed from it. As mailboxes can become very large, and messages

Page 149: Aid4Mail3 Manual

Reference Information 142

Copyright © 2005-2013 Fookes Holding Ltd

can usually be moved around without limitation, this can provide a considerable time-saving. However italso means that when you process a mailbox with Aid4Mail, the mailbox can potentially containunpurged messages.

As these messages are generally unwanted, they are automatically skipped by the Home andProfessional versions of Aid4Mail. The eDiscovery versions offer an option to process unpurged mail,which is usually only required in a forensics context.

2.15.41 UTC

UTC is a time system called Coordinated Universal Time. Time zones around the World are expressedas positive or negative offsets from UTC.

3 Purchasing and License Agreement

3.1 Ordering Information

You can buy Aid4Mail through our online order page. We have no local dealers. Our software is soldworld-wide by cleverbridge, a leading e-commerce company. Cleverbridge is under contract with FookesSoftware 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, purchaseorder.

Purchase orders are only available to corporate customers and must use your official companyletterhead. You will receive the cleverbridge fax number in a later step. If you require immediate productdelivery, please use the credit card or PayPal payment option instead.

3.2 Upgrade Policy

Maintenance releases, updates, and upgrades are free during the validity of your subscription period.

3.3 Refund Policy

All of Fookes Software's products can be evaluated, free of charge, through a trial mode or separate trialversion that can be downloaded directly from our website. Use the trial before you purchase to ensurethat the full product will be compatible with your computer systems and satisfy your requirements. If youdo not, you accept that the product may not meet your needs and that this will not justify a refund orchargeback. If you experience an issue with our software, then please contact our customer supportservice for help in solving the problem.

All sales are final and refunds are provided only for accidental duplicate orders. Refunds will only bemade to the credit card or PayPal account through which the original purchase was made. Anadministration 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.4 Software Piracy

Software piracy may be tempting to those who are not familiar with the risks. But far from being aninnocent, victimless crime, software piracy exposes users to many cyber-security hazards like identitytheft and malware such as viruses, worms, and trojans. It also weakens the value of intellectual property,

Page 150: Aid4Mail3 Manual

Aid4Mail 3 Help143

Copyright © 2005-2013 Fookes Holding Ltd

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. FookesSoftware 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 mindknowing that your programs are safe, stable, and absolutely free of viruses and other malware. Youcannot put a price on that kind of confidence.

Report Piracy Confidentially

Software piracy, or unlicensed software is the unauthorized copying or distribution of copyrightedsoftware. This can be done by copying, downloading, sharing, selling, or installing multiple copies ontopersonal or work computers. It is illegal, increases security risks and results in economic harm such asloss of jobs and tax revenue.

Visit the nopiracy.com site to report piracy confidentially. You could be eligible for a $1 million reward.

3.5 End User License Agreement

AID4MAIL END USER LICENSE AGREEMENT(Version: August 2011)

This End User License Agreement (this "Agreement"), governs the terms and conditions of theLicensee's 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, ifyou are using an Evaluation License as or on behalf of an entity, and/or have registered for any otherlicense as or on behalf of an entity, such as a corporation, partnership, limited liability company or otherentity, the term "you" used below refers to the entity which will be bound by this Agreement. Yourepresent and warrant that you have power and authority to enter into this Agreement on behalf of theentity. This Agreement does not address any third-party or free or open source software separatelylicensed to you.

By clicking the "I accept the Agreement" option during installation and/or by accepting the Agreementon the online order form and/or by using Aid4Mail, you confirm your acceptance of, and agree to bebound by, this Agreement. If you do not agree to this Agreement or if you do not understand it, do notpurchase, install, or use Aid4Mail.

In case you have another written agreement directly with Fookes Software, such written agreementprevails 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 SW-7XH4ESFNFJHW) that isentered 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 ofthe 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.

Page 151: Aid4Mail3 Manual

Purchasing and License Agreement 144

Copyright © 2005-2013 Fookes Holding Ltd

"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 informationused to unlock Software features when pre-defined conditions are met. A Key File is offered with certaineDiscovery, 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 oneIndividual End User for receiving, sending, and/or archiving email messages. Email addresses are relatedin a Mail Account holding more than one email address if all addresses are connected to an IndividualEnd User's single email profile or, if there is no such profile, to the Individual End User's single emailclient program.

"Mail Migration" means exporting Mail from one system to another, the latter system being used toreceive and/or send email messages.

"Organization" means any for-profit or non-profit sole proprietorship, unincorporated association, jointventure, 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 othercommercial or professional purposes, whether for-profit, non-profit or governmental.

"Regular Mode" means Software operating with a purchased Activation Code or Key File that deactivatesTrial Mode.

"Seat" means one operating system user logon account (for example a Windows user logon account) onone computer (not a server) with the ability to run the Software in Regular Mode.

"Site" means an Organization's work location within a geographical area whose radius is 10 miles (16km). The geographical restriction does not apply to Staff Members at the Site who Use the Software ona laptop for their work at home or while traveling.

"Software" means the relevant version of Aid4Mail in executable form (GUI and/or CLI format) anddocumentation, 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 youare licensed to run the Software in Regular Mode and, for Software licenses purchased from FookesSoftware 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 whichyou are obtaining a no-charge evaluation license.

"Trial Package" means the edition of Aid4Mail available in the public area of the Fookes Softwarewebsite without any Activation Code or Key File.

"Use" means loading, installing, executing, displaying, performing and/or transmitting the Software foryour internal business purposes, and not for distribution or resale.

2. Software License Grants.

Page 152: Aid4Mail3 Manual

Aid4Mail 3 Help145

Copyright © 2005-2013 Fookes Holding Ltd

2.1. Trial Mode License.

Subject to the terms and conditions of this Agreement, Fookes Software hereby grants you a non-sublicensable, nonexclusive, nontransferable license to Use the Software in Trial Mode without chargeand for evaluation purposes only in a non-production test environment. You may make as many copiesof the Software as is reasonably necessary for evaluating the Software. All copies must reproducecopyright notices of the Software. Files created by the Software in Trial Mode are for evaluation purposesonly 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/oruse of either a valid Activation Code or Key File. Regular Mode licenses are available for purchase forPersonal Use and/or Professional Use.

2.2.1. Activation Codes.

If you purchase and/or use an Activation Code, you agree to comply with the license activation andverification procedure described in part in this section of the Agreement, and more fully on the ProductActivation page. The activation technology may prevent your use of the Software if you do not follow theactivation process described in the Software. Activation requires an internet connection (unless you havepurchased 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 suchActivation Code is not reused again on the old computer. Conditions for transferring an Activation Codeto 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 anInternet connection (unless you have an offline option for the new location). Our activation technologyallows a reasonable number of re-activations within a certain time period. If the number of re-activationsexceeds 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 immediatelyfollowing a previous Subscription Period if it was renewed prior to termination, or on re-activation of thecode 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. TrialMode is deactivated only if the data stored in the Key File matches the pre-determined hardware orsoftware. Furthermore, depending on the nature of the key, the Software may require a system clock setto the correct date and/or access to a Fookes Software license validation server on the Internet. Failingthis, 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 byFookes Software. If you obtained your copy from an OEM, your OEM will inform you of the SubscriptionPeriod.

2.4. License Types.

Page 153: Aid4Mail3 Manual

Purchasing and License Agreement 146

Copyright © 2005-2013 Fookes Holding Ltd

The specific license type is specified on the receipt for the Software license that you purchased fromFookes Software, a reseller or original equipment manufacturer (OEM). Each of the following licenses issubject 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, toUse 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 longas 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, toUse the Software to process no more than one Mail Account per Activation Code. Such license is forProfessional Use to perform tasks that include Mail Migration and archiving, but not e-discovery orforensic examination.

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 systemuser logon account as long as the Mail Account processed in the new location is the same as in theoriginal location. Once an Activation Code has been used to process one Mail Account, it may not beused 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 ifthe initial Staff Member is no longer employed by your Organization or is permanently reassigned toanother post. Such a transfer may occur no sooner than one month after the start of a SubscriptionPeriod 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, toUse one multi-user Activation Code for as many Seats as specified on the receipt for the Softwarelicense. All Seats linked to the Activation Code must be located at a single Site. You may process asmany Mail Accounts as you have Seats. Such license is for Professional Use to perform tasks thatinclude 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 alicense control panel ("LCP") account. The LCP is provided for managing the Activation Code andassociated Seats.

The Activation Code cannot be transferred to another Site. A Seat may be transferred from one StaffMember to another at the same Site if the initial Staff Member is no longer employed at the Site or ispermanently reassigned to another post. The transfer process requires that the old Seat be de-activatedprior to transfer. A delay of between 24 and 72 hours is imposed before activation of another Seat ispossible.

2.4.4. Aid4Mail eDiscovery Forensic.

Fookes Software hereby grants you the right and license, during the applicable Subscription Period, to

Page 154: Aid4Mail3 Manual

Aid4Mail 3 Help147

Copyright © 2005-2013 Fookes Holding Ltd

Use the Software with one Activation Code or Key File. Such license is for Professional Use to performtasks 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 MailAccounts belonging to your Organization or to third parties, as long as the Software can be operatedfrom one Seat. However, you may not process Mail as part of a for-profit service to clients or other thirdparties unless you have a separate valid license for each of their Mail Accounts. (Aid4Mail eDiscoveryService may be more appropriate in this case.)

Such license held by an Organization (other than a government Organization) may be exercised forinternal purposes only to process any number of Mail Accounts belonging to the Organization as long asthe Software can be operated from one Seat.

You may not make the Software available to other users in your Organization or third parties, whetherdirectly by offering access to the operating system user logon account from which it can be executed, orindirectly through a network system.

An Activation Code may be transferred within your Organization from one Staff Member to another if theinitial Staff Member is no longer employed by your Organization or is permanently reassigned to anotherpost. Such a transfer may occur no sooner than one month after the start of a Subscription Period andno 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, toUse the Software with one Activation Code or Key File. Such license is for Professional Use limited toperforming archiving tasks for purposes of preservation and access in research collections, includinglimited 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 numberof Mail Accounts belonging to your Organization or to third parties, as long as the Software can beoperated from one Seat. However, you may not process Mail as part of a for-profit service to clients orother third parties unless you have a separate valid license for each of their Mail Accounts. (Aid4MaileDiscovery Service may be more appropriate in this case.)

Such license held by an Organization (other than a government or non-profit Organization) may beexercised for internal purposes only to process any number of Mail Accounts belonging to theOrganization 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, whetherdirectly by offering access to the operating system user logon account from which it can be executed, orindirectly through a network system.

An Activation Code may be transferred within your Organization from one Staff Member to another if theinitial Staff Member is no longer employed by your Organization or is permanently reassigned to anotherpost. Such a transfer may occur no sooner than one month after the start of a Subscription Period andno 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, toUse the Software with one Activation Code or Key File. Such license is for Professional Use limited toproviding paid or unpaid bona fide e-discovery, forensic examination and archiving services, but not for

Page 155: Aid4Mail3 Manual

Purchasing and License Agreement 148

Copyright © 2005-2013 Fookes Holding Ltd

Mail Migration services. Such license may be exercised to process any number of Mail Accountsbelonging to your Organization (government, non-profit or otherwise) or to third parties, as long as theSoftware can be operated from one Seat.

You may not make the Software available to other users in your Organization or to third parties, whetherdirectly by offering access to the operating system user logon account from which it can be executed, orindirectly through a network system.

An Activation Code may be transferred within your Organization from one Staff Member to another if theinitial Staff Member is no longer employed by your Organization or is permanently reassigned to anotherpost. Such a transfer may occur no sooner than one month after the start of a Subscription Period andno 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, toUse the Software to process no more than one Mail Account per Activation Code or Key File. Suchlicense is for Professional Use to perform tasks that include e-discovery, forensic examination, archiving,and Mail Migration purposes.

An Activation Code may be re-activated on a different computer or under a different operating systemuser logon account as long as the Mail Account processed in the new location is the same as in theoriginal location. Once an Activation Code has been used to process one Mail Account, it may not beused 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 theinitial Staff Member is no longer employed by your Organization or is permanently reassigned to anotherpost. Such a transfer may occur no sooner than one month after the start of a Subscription Period andno more than four times within a yearly Subscription Period.

2.4.8. Aid4Mail Console Migrator.

Fookes Software hereby grants you the right and license, during the applicable Subscription Period, toUse Aid4Mail Console with a Key File for as many Seats as specified on the receipt for the Softwarelicense. All Seats must be located at a single Site. You may process as many Mail Accounts as youhave Seats. Such license is for Professional Use to perform tasks that include Mail Migration andarchiving, 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 Personal / Archivist / Forensic / Service / Site.

If you purchase a license to Aid4Mail eDiscovery Personal (GUI format), you also are eligible topurchase a corresponding license on the same terms to Aid4Mail Console Personal (CLI format).

If you purchase a license to Aid4Mail eDiscovery Archivist (GUI format), you also are eligible to purchasea 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 purchasea 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 Aid4MailConsole Service (CLI format). There is no option to purchase Aid4Mail Console Service separately.

Page 156: Aid4Mail3 Manual

Aid4Mail 3 Help149

Copyright © 2005-2013 Fookes Holding Ltd

If you purchase a license to Aid4Mail Professional Site (GUI format) with 50 or more Seats, you also areeligible on request and at no extra charge to receive a corresponding license on the same terms toAid4Mail Console Site (CLI format). There is no option to purchase Aid4Mail Console Site (CLI format)separately.

2.4.10. Aid4Mail Console Server.

Fookes Software hereby grants you the right and license, during the applicable Subscription Period, toUse Aid4Mail Console on a server with a Key File. Pricing, Subscription Period, number of Seatsaccessing the Software or number of Mail Accounts processed by it, type of usage (e.g., mailconversion, filtering, data extraction, archiving, e-discovery, third-party processing), and other specialterms are agreed in writing by email or other means between you and Fookes Software prior topurchase.

2.5 License Restrictions.

The Software is licensed, not sold. This Agreement only gives you the rights according to the chosenlicense 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 onan application service provider, web service or time sharing basis) the Software except to the extentexplicitly permitted in the chosen license type (section 2) above; (b) disable, block or circumvent anylicensing, rights management or control features of the Software except as an intended part of theSoftware's programming features; (c) assign, loan, resell, transfer, distribute or otherwise makeaccessible the Software, except as set forth in section 6; (d) modify, decompile, disassemble or reverseengineer the Software, except to the limited extent permitted by applicable law; (e) remove or modify anylegal notices in the Software; or (f) make more copies of the Software, other than (i) for the use grantedby the chosen license type (section 2), (ii) for back-up purposes, and/or (iii) except as set forth insections 2.1 and 6.

It is your responsibility to make a back-up copy of the Software installation file and your registrationdetails, including Activation Codes, Key Files and passwords if any, off your computer and place thesein a safe location that is not accessible to other users. If you manage Activation Codes for other users, itis your responsibility to keep track of which Activation Codes and passwords are assigned to whichusers.

3. Customer Support / Software Maintenance / Feedback.

Fookes Software provides customer support and software maintenance that is generally at no extracharge during the Subscription Period and exclusively by email in English, to the extent that FookesSoftware at its sole discretion shall determine to be reasonable ("Customer Support"). If you are anOrganization, 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, discontinuedproducts and old Software versions that were released more than six months prior to the release of thelatest update or upgrade. For OEM versions, contact your OEM or distributor for customer support, asFookes Software does not provide Customer Support for those versions.

By emailing, uploading, posting, or otherwise transmitting or submitting any content, information or ideasto Fookes Software, you automatically grant (or warrant that the owner of such rights has expresslygranted) to Fookes Software a perpetual, irrevocable, royalty-free, worldwide, non-exclusive,sublicensable right and license to use, reproduce, modify, publish, distribute, display, perform, andtransmit 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

Page 157: Aid4Mail3 Manual

Purchasing and License Agreement 150

Copyright © 2005-2013 Fookes Holding Ltd

contents of any Mail files and screen shots sent to us for software testing and improvement strictlyconfidential, except as may be required by applicable law.You bear all responsibility for ensuring that email replies from Fookes Software can reach you. FookesSoftware cannot be held responsible if its emails to you are blocked by your Internet service provider(ISP), or your email server, or your email program's spam/junk-mail filters. If necessary, you will providean 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. Itis intended to allow potential customers to evaluate before purchase, whether the Software is compatiblewith their computer systems, email programs and data, and will satisfy their requirements. AS ARESULT, ALL SALES ARE FINAL AND REFUNDS ARE PROVIDED ONLY FOR ACCIDENTALDUPLICATE ORDERS. Refunds will be made only to the credit card or PayPal account through whichthe original purchase was made. An administration fee may apply in such cases to cover processingcosts and third-party commissions.

5. Ownership.

The Software is proprietary to Fookes Software and its suppliers, and is licensed, not sold, to younotwithstanding any reference herein to "purchases." You acknowledge and agree that: (a) the Softwareis protected under U.S. copyright and other national and international copyright laws; (b) FookesSoftware 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 youhereunder are reserved by Fookes Software; (d) you acquire no ownership or other interest (other thanyour license rights) in or to the Software; and (e) Fookes Software and/or its suppliers owns all copies ofthe Software, however made. You agree that you will not, at any time, contest anywhere in the world theownership of Fookes Software and/or its suppliers of, or rights in, the Software. You have no rightshereunder 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 herebylicensed to make as many copies of the Trial Package as you wish; give exact copies of the originalTrial 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 feefor the Trial Package, but you must not represent in any way that you are selling or licensing theSoftware 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 withany other medium or service, which makes available or contains viruses, virus source code, virusconstruction 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 ismisleading 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, andany attempt to do so is void. Each entity wishing to distribute the Trial Package must independentlysatisfy 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 withmore features ("Update"), you must possess a valid license to the updateable or upgradeable version of

Page 158: Aid4Mail3 Manual

Aid4Mail 3 Help151

Copyright © 2005-2013 Fookes Holding Ltd

the Software or license type you want to Update. You agree that once you start using an Update, youlose your right to Use the Software or license type (if replaced by a new one or other system) that wasthe basis of the Update ("Previous Version"). You also agree that you will not transfer a Previous Versionto another person or entity, and that you may Use the Update only in accordance with the terms of thisAgreement.

8. Compliance.

You shall conduct your business in compliance with all laws and regulations in any way applicable tothe Software or to the performance of your obligations under this Agreement. Without limiting theforegoing, you shall not take any action that would violate, or cause Fookes Software to be in violationof, 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 UnitedStates or any foreign agency or authority.

9. U.S. Government Rights.

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

The Software and the documentation which accompanies the Software are "Commercial Items," as thatterm is defined at 48 C.F.R. §2.101, consisting of "Commercial Computer Software" and "CommercialComputer 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 through227.7202-4, as applicable, the Commercial Computer Software and Commercial Computer SoftwareDocumentation 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. FOOKESSOFTWARE DISCLAIMS AS FAR AS LEGALLY PERMISSIBLE ALL WARRANTIES RELATING TOTHE 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 . FOOKESSOFTWARE DOES NOT WARRANT THAT THE SOFTWARE WILL MEET YOUR REQUIREMENTS ORBE UNINTERRUPTED, SECURE, ERROR-FREE OR COMPATIBLE WITH ANY PRODUCT. NEITHERFOOKES 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 PUNITIVEDAMAGES (INCLUDING BUT NOT LIMITED TO LOST REVENUES, PROFITS AND/OR SAVINGS)ARISING OUT OF THE USE OR INABILITY TO USE SUCH SOFTWARE, EVEN IF FOOKESSOFTWARE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR CLAIMS. THEPERSON USING THE SOFTWARE BEARS ALL RISK AS TO THE QUALITY AND PERFORMANCEOF THE SOFTWARE.

THE ENTIRE LIABILITY OF FOOKES SOFTWARE AND ITS SUPPLIERS, AND YOUR EXCLUSIVEREMEDY, WITH RESPECT TO THE USE OF THE SOFTWARE OR CUSTOMER SUPPORT OR ANYBREACH 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 OTHERPERSONS FROM ANY AND ALL OBLIGATIONS, LIABILITIES AND CLAIMS IN EXCESS OF THISLIMITATION. YOU AGREE THAT ANY CLAIM OR CAUSE OF ACTION ARISING OUT OF ORRELATED TO USE OF THE SOFTWARE OR THIS AGREEMENT MUST BE FILED WITHIN ONE (1)

Page 159: Aid4Mail3 Manual

Purchasing and License Agreement 152

Copyright © 2005-2013 Fookes Holding Ltd

YEAR AFTER SUCH CLAIM OR CAUSE OF ACTION AROSE OR BE FOREVER BARRED.

YOU ARE SOLELY RESPONSIBLE FOR SELECTION, INSTALLATION AND LAUNCH OF THESOFTWARE AND FOR BACKING UP YOUR DATA AND FILES, AND HEREBY RELEASE FOOKESSOFTWARE AND ITS SUPPLIERS FROM ANY LIABILITY OR DAMAGES DUE TO THE LOSS OFANY SUCH DATA OR FILES.

FOOKES SOFTWARE IS NOT LIABLE FOR ANY INAPPROPRIATE OR ILLEGAL USE OF THESOFTWARE.

11. Governing Law / Jurisdiction.

This Agreement is governed by Swiss Law, subject to the express exclusion of the United NationsConvention on Contracts for the International Sale of Goods (CISG, 1980). The parties consent to theexclusive jurisdiction of the competent Swiss courts of Gruyère, Switzerland, for the resolution of anylitigation arising out or related to this Agreement.

12. Termination.

Fookes Software may terminate this Agreement at any time upon default by you of the licenseprovisions of this Agreement, or any other material default by you of this Agreement not cured withinthirty (30) days after written notice thereof. Except for Sections 2, 3 and 6, all provisions of thisAgreement 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 thisAgreement, this does not affect the legal validity of the remaining provisions. The ineffective provision willbe replaced by an effective provision that is as close as possible in economic terms to the provisionwanted 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, byoperation of law or otherwise, without prior written consent of Fookes Software, and any attempt withoutsuch consent shall be void. Subject to the preceding sentence, this Agreement binds and benefits thepermitted successors and assigns of the parties. Fookes Software may change the terms, conditionsand pricing relating to the future licensing of its Software and other intellectual property rights, includingthis Agreement, from time to time. No waiver will be implied from conduct or failure to enforce rights noris 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 inwriting. This Agreement is the complete and exclusive statement of agreement between the parties as toits 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: August 05, 2011

AID4MAIL BETA AGREEMENT(Version: March 2010)

Page 160: Aid4Mail3 Manual

Aid4Mail 3 Help153

Copyright © 2005-2013 Fookes Holding Ltd

This Beta Agreement (this "Beta Agreement"), governs the terms and conditions of the Licensee'saccess 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 andFookes Software, as the same may be updated from time to time (the "EULA") are incorporated hereinby reference, and apply to the Beta Version. Defined terms used without definition in this BetaAgreement have the meanings given in the EULA. In the event of any conflict between the EULA and thisBeta Agreement, this Beta Agreement controls.

2. Beta Version Background. Fookes Software may offer to you, and you may consent to receive, oneor 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 defectsand obtain user feedback. A Beta Version usually contains features and functionality that have not beentested or re-tested in full or in part and therefore may not work as specified. Do not use the Beta Versionon any sensitive data unless you have backup copies in a safe location. Files produced by the BetaVersion 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 Modeor Regular Mode. Subject to the terms and conditions of this Agreement, Fookes Software hereby grantsyou a revocable, non-sublicensable, nonexclusive, nontransferable license without charge during theBeta Test Period to Use the Beta Version as follows: (i) if you are licensed to use a current version ofthe Software in Regular Mode, then you may Use the Beta Version in Regular Mode on the same termsas your current version, except that you may use the Beta Version for evaluation purposes only in a non-production test environment; and (ii) otherwise, you may use the Beta Version only in Trial Mode and forevaluation purposes only in a non-production test environment. You may make as many copies of theBeta Version as is reasonably necessary for evaluating the Beta Version. All copies must reproducecopyright notices of the Beta Version. Files created by the Beta Version are for evaluation purposes onlyand must be destroyed once evaluation is complete. The "Beta Test Period" commences on the dateFookes Software delivers the Beta Version to you and ends on the commercial release date of thecorresponding Release Version, or if earlier, the date specified in writing by Fookes Software. The BetaVersion may have limited functionality or may contain a time out feature that will cause it to be disabledand non-functional upon conditions designated by Fookes Software in its sole discretion. YOUUNDERSTAND AND AGREE THAT OPERATION OF THE BETA VERSION AND ACCESS TO YOURDATA MAY TERMINATE UPON ANY SUCH CONDITION, UNLESS YOU OBTAIN AN UPDATED BETAVERSION 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 providedfor any Beta Version.

7. Confidentiality.

(a) "Confidential Information" means any and all information concerning Fookes Software's unreleasedproducts and services, trade secrets and other proprietary rights; descriptions of inventions, processesand technical know-how; specifications; documentation, and any other business, marketing or technicalinformation disclosed in relation to this Beta Agreement.

(b) The parties expressly agree that the source and object code of each Beta Version is ConfidentialInformation of Fookes Software. In addition, if you received a copy of a Beta Version that is not availablein the public area of the Fookes Software website or its related forums, then all new features and

Page 161: Aid4Mail3 Manual

Purchasing and License Agreement 154

Copyright © 2005-2013 Fookes Holding Ltd

capabilities of that Beta Version are deemed Confidential Information of Fookes Software and mustremain strictly confidential until they are made available to the general public.

(c) "Confidential Information" shall not include information (i) already in your possession without anobligation of confidentiality; (ii) publicly available without breach of this Agreement or any other betaagreement 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 suchrequired disclosure.

(d) You shall hold all Confidential Information in strict confidence, and may disclose such ConfidentialInformation only to your employees and contractors who have a "need to know" such information. Youshall not use or permit the use of any Confidential Information for benefit of yourself or any third partyexcept as necessary to perform under this Beta Agreement. You are responsible for any violation of thissection 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 Softwarefor which damages would be an inadequate remedy and in the event of such breach and in addition to itsrights 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 suchrights has expressly granted) to Fookes Software a perpetual, irrevocable, royalty-free, worldwide, non-exclusive, 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, withoutcompensation 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 testingand 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 ASFAR AS LEGALLY PERMISSIBLE ALL WARRANTIES RELATING TO THE BETA VERSION,WHETHER EXPRESSED, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANYIMPLIED WARRANTIES OF SATISFACTORY QUALITY, MERCHANTABILITY, FITNESS FOR APARTICULAR PURPOSE, OR NON-INFRINGEMENT . FOOKES SOFTWARE DOES NOT WARRANTTHAT THE BETA VERSION WILL MEET YOUR REQUIREMENTS OR BE UNINTERRUPTED,SECURE, ERROR-FREE OR COMPATIBLE WITH ANY PRODUCT. NEITHER FOOKES SOFTWARENOR ANYONE ELSE WHO HAS BEEN INVOLVED IN THE CREATION, PRODUCTION, OR DELIVERYOF THE BETA VERSION ("SUPPLIERS") SHALL BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL,CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES (INCLUDING BUT NOT LIMITED TO LOSTREVENUES, PROFITS AND/OR SAVINGS) ARISING OUT OF THE USE OR INABILITY TO USE THEBETA VERSION, EVEN IF FOOKES SOFTWARE HAS BEEN ADVISED OF THE POSSIBILITY OFSUCH DAMAGES OR CLAIMS. THE PERSON USING THE BETA VERSION BEARS ALL RISK AS TOTHE QUALITY AND PERFORMANCE OF THE BETA VERSION.

THE ENTIRE LIABILITY OF FOOKES SOFTWARE AND ITS SUPPLIERS, AND YOUR EXCLUSIVEREMEDY, WITH RESPECT TO THE USE OF THE BETA VERSION OR ANY BREACH OF THIS BETAAGREEMENT ARE LIMITED TO THE AMOUNT ACTUALLY PAID BY YOU, IF ANY, FOR USE OF THEBETA VERSION. YOU HEREBY RELEASE FOOKES SOFTWARE AND SUCH OTHER PERSONSFROM 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 OFTHE BETA VERSION OR THIS AGREEMENT MUST BE FILED WITHIN ONE (1) YEAR AFTER SUCH

Page 162: Aid4Mail3 Manual

Aid4Mail 3 Help155

Copyright © 2005-2013 Fookes Holding Ltd

CLAIM OR CAUSE OF ACTION AROSE OR BE FOREVER BARRED.

YOU ARE SOLELY RESPONSIBLE FOR SELECTION, INSTALLATION AND LAUNCH OF THE BETAVERSION AND FOR BACKING UP YOUR DATA AND FILES, AND HEREBY RELEASE FOOKESSOFTWARE AND ITS SUPPLIERS FROM ANY LIABILITY OR DAMAGES DUE TO THE LOSS OFANY SUCH DATA OR FILES.

FOOKES SOFTWARE IS NOT LIABLE FOR ANY INAPPROPRIATE OR ILLEGAL USE OF THE BETAVERSION.

10. Governing Law / Jurisdiction. This Agreement is governed by Swiss Law, subject to the expressexclusion 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 Gruyère,Switzerland, for the resolution of any litigation arising out or related to this Agreement.

Last Update to Aid4Mail Beta Agreement: March 26, 2010

3.6 Third Party Software Notices and/or Additional Terms andConditions

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 thisdocument, 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 formatfor electronic documents. However, Adobe Systems Incorporated owns the copyright for the particulardata structures and operators and the written specification constituting the interchange format called thePortable Document Format. Thus, these elements of the Portable Document Format may not be copiedwithout Adobe’s permission.

Adobe will enforce its copyright. Adobe’s intention is to maintain the integrity of the Portable DocumentFormat standard. This enables the public to distinguish between the Portable Document Format andother interchange formats for electronic documents. However, Adobe desires to promote the use of thePortable 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 FormatWrite drivers and applications that produce output represented in the Portable Document FormatWrite software that accepts input in the form of the Portable Document Format and displays, prints, orotherwise interprets the contentsCopy Adobe’s copyrighted list of data structures and operators, as well as the example code andPostScript language function definitions in the written specification, to the extent necessary to use thePortable Document Format for the purposes above

The conditions of such copyright permission are:

Page 163: Aid4Mail3 Manual

Purchasing and License Agreement 156

Copyright © 2005-2013 Fookes Holding Ltd

Authors of software that accepts input in the form of the Portable Document Format must makereasonable efforts to ensure that the software they create respects the access permissions andpermissions controls listed in Table 3.20 of this specification, to the extent that they are used in anyparticular document. These access permissions express the rights that the document’s author hasgranted to users of the document. It is the responsibility of Portable Document Format consumersoftware to respect the author’s intent.Anyone who uses the copyrighted list of data structures and operators, as stated above, must includean appropriate copyright notice.

This limited right to use the copyrighted list of data structures and operators does not include the right tocopy this book, other copyrighted material from Adobe, or the software in any of Adobe’s products thatuse the Portable Document Format, in whole or in part, nor does it include the right to use any Adobepatents, except as may be permitted by an official Adobe Patent Clarification Notice (see theBibliography).

Adobe Patent Clarification Notice: Reading and writing PDF files

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 TechnicalNotes (the "Specification"). Adobe desires to promote the use of PDF for information interchange amongdiverse 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 thatproduces, consumes, and interprets PDF files that are compliant with the Specification:

U.S. Patent Numbers:5,634,0645,737,5995,781,7855,819,3016,028,5836,289,3646,421,460

In addition, the following patent is licensed on a royalty-free, nonexclusive basis for its term and for thesole 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 noothers. That is to say, Adobe grants only those rights in the above patent(s) necessarily practiced toimplement 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 asimplementation techniques that are not explicitly disclosed in the Specification, nor does it allow the useof any patented feature for any purpose other than as set forth in the applicable license grant. Adobe hasother 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 thealgorithms Aid4Mail uses from this library include MD5, SHA1, SHA256, SHA384, and SHA512.

Page 164: Aid4Mail3 Manual

Aid4Mail 3 Help157

Copyright © 2005-2013 Fookes Holding Ltd

Copyright © 2006 Hagen Reddmann, [email protected] © 2008 Arvid Winkelsdorf, digivendo GmbH, [email protected]

THIS SOFTWARE IS PROVIDED BY THE AUTHORS ''AS IS'' AND ANY EXPRESS OR IMPLIEDWARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFMERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NOEVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOTLIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, ORPROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OFLIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISEDOF THE POSSIBILITY OF SUCH DAMAGE.

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 libraryis available from http://fastmm.sourceforge.net/. No modifications to this library have been made byFookes 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 thissoftware, its quality, accuracy, merchantability, or fitness for a particular purpose. This software isprovided "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 specifiedbelow.

Permission is hereby granted to use, copy, modify, and distribute this software (or portions thereof) forany 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 beincluded, with this copyright and no-warranty notice unaltered; and any additions, deletions, or changesto the original files must be clearly indicated in accompanying documentation.(2) If only executable code is distributed, then the accompanying documentation must state that "thissoftware 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 anyundesirable 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 unmodifiedlibrary. 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 orpublicity relating to this software or products derived from it. This software may be referred to only as"the Independent JPEG Group's software".

Page 165: Aid4Mail3 Manual

Purchasing and License Agreement 158

Copyright © 2005-2013 Fookes Holding Ltd

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.1e: http://www.openssl.org/Copyright © 1998-2011 The OpenSSL Project. All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted providedthat the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and thefollowing disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions andthe 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 followingacknowledgment: "This product includes software developed by the OpenSSL Project for use in theOpenSSL Toolkit. (http://www.openssl.org/)"

4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to endorse or promoteproducts derived from this software without prior written permission. For written permission, pleasecontact [email protected].

5. Products derived from this software may not be called "OpenSSL" nor may "OpenSSL" appear in theirnames without prior written permission of the OpenSSL Project.

6. Redistributions of any form whatsoever must retain the following acknowledgment: "This productincludes 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 ORIMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFMERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NOEVENT 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 THEORYOF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCEOR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IFADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

This product includes cryptographic software written by Eric Young ([email protected]). This productincludes software written by Tim Hudson ([email protected]).

Original SSLeay LicenseCopyright © 1995-1998 Eric Young ([email protected]). All rights reserved.

This package is an SSL implementation written by Eric Young ([email protected]). Theimplementation 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 areadhered 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 iscovered by the same copyright terms except that the holder is Tim Hudson ([email protected]).

Copyright remains Eric Young's, and as such any Copyright notices in the code are not to be removed. If

Page 166: Aid4Mail3 Manual

Aid4Mail 3 Help159

Copyright © 2005-2013 Fookes Holding Ltd

this package is used in a product, Eric Young should be given attribution as the author of the parts of thelibrary used. This can be in the form of a textual message at program startup or in documentation (onlineor textual) provided with the package.

Redistribution and use in source and binary forms, with or without modification, are permitted providedthat the following conditions are met:

1. Redistributions of source code must retain the copyright notice, this list of conditions and thefollowing disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions andthe 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 followingacknowledgement: "This product includes cryptographic software written by Eric Young([email protected])" The word 'cryptographic' can be left out if the routines from the library beingused are not cryptographic related.

4. If you include any Windows specific code (or a derivative thereof) from the apps directory (applicationcode) you must include an acknowledgement: "This product includes software written by Tim Hudson([email protected])"

THIS SOFTWARE IS PROVIDED BY ERIC YOUNG "AS IS" AND ANY EXPRESS OR IMPLIEDWARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OFMERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NOEVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOTLIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, ORPROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OFLIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OROTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISEDOF THE POSSIBILITY OF SUCH DAMAGE.

The licence and distribution terms for any publicly available version or derivative of this code cannot bechanged. i.e. this code cannot simply be copied and put under another distribution licence [including theGNU Public Licence.]

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

PCRE is a library of functions to support regular expressions whose syntax and semantics are as closeas possible to those of the Perl 5 language.

Release 8 of PCRE is distributed under the terms of the "BSD" licence, as specified below. Thedocumentation 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 setof C++ wrapper functions.

The basic library functions are written by Philip HazelCopyright (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:

Page 167: Aid4Mail3 Manual

Purchasing and License Agreement 160

Copyright © 2005-2013 Fookes Holding Ltd

Redistribution and use in source and binary forms, with or without modification, are permitted providedthat the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and thefollowing disclaimer.Redistributions in binary form must reproduce the above copyright notice, this list of conditions andthe 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 theircontributors may be used to endorse or promote products derived from this software without specificprior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" ANDANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE AREDISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FORANY 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 ONANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDINGNEGLIGENCE 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 disclaimerCopyright © 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 thisfunction.

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 orreferencing the derived work.

RSA Data Security, Inc. makes no representations concerning either the merchantability of this softwareor the suitability of this software for any particular purpose. It is provided "as is" without express orimplied 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

Page 168: Aid4Mail3 Manual

Aid4Mail 3 Help161

Copyright © 2005-2013 Fookes Holding Ltd

that the following conditions are met:

Redistributions of source code must retain the above copyright notice, this list of conditions and thefollowing disclaimer.

Redistributions in binary form must reproduce the above copyright notice, this list of conditions and thefollowing 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 orpromote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" ANDANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIEDWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE AREDISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANYDIRECT, 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 ONANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDINGNEGLIGENCE 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 andBase64.

Copyright © 2004-2007 Sasa Zeman. All Rights Reserved.

This library, as modified by Fookes Software, and its usage are covered by the Mozilla Public Licensev1.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 beheld liable for any damages arising from the use of this software.

Page 169: Aid4Mail3 Manual

Purchasing and License Agreement 162

Copyright © 2005-2013 Fookes Holding Ltd

Permission is granted to anyone to use this software for any purpose, including commercialapplications, 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 originalsoftware. If you use this software in a product, an acknowledgment in the product documentation wouldbe appreciated but is not required.2. Altered source versions must be plainly marked as such, and must not be misrepresented as beingthe original software.3. This notice may not be removed or altered from any source distribution.

4 Other Information

4.1 About Fookes Software

Company

Fookes Software was originally founded in 1996 in Geneva, Switzerland. Now a Limited (Ltd) companybased in Charmey, in the Swiss Pre-Alps, it is fully owned by its parent Fookes Holding Ltd. For over 15years we have been developing award-winning tools and productivity software. Our clients includegovernment and law enforcement agencies, Fortune 500 corporations, top universities and othereducational institutions, international organizations, as well as individuals and home users world-wide.

Policies

1. We are perfectionists and strive to develop useful, original, and reliable software solutions.2. We listen to our users and try to implement feature suggestions that benefit others.3. We are committed to providing excellent customer support by email.4. 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.comhttp://www.aid4mail.comhttp://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/2008Federal Number: CH-217-3540396-6

Trade Register details:

Service du registre du commerce du Canton de Fribourg, Switzerlandhttp://www.fr.ch/rc/

Fookes is a registered trademark of Fookes Holding Ltd.

Page 170: Aid4Mail3 Manual

Aid4Mail 3 Help163

Copyright © 2005-2013 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 theshortest time possible. Please also verify that you are using the latest software update before reporting aproblem.

Technical support from Fookes Software representatives covers pre-sales questions, installation issues,license activation, and troubleshooting unexpected behavior related to documented features. It does notcover consulting, product training, help resolving unusual configurations, or assistance with developingscripts, templates, or search tasks. Troubleshooting software issues requires that you have the latestmaintenance updates installed.

We reply to email on business days from Monday to Friday. We usually reply within 24 hours, but onoccasions it may take up to 3 business days. Please take into account that your "urgent" message mayreach us in the middle of the night – we are based in Switzerland (UTC+1). Note that technical support isprovided by email only.

Due to the high volume of spam reaching us, we no longer publish our email addresses on our websiteand in our documentation. As a result, it is now necessary to go through our mail form to establish thefirst contact. We apologize for any inconvenience.

If you need to contact us by post, our office address is as follows:

Fookes Software LtdLa Petite Fin 271637 CharmeySwitzerland

Please do NOT send Purchase Orders to the above address. Aid4Mail sales are handled for us bycleverbridge. Address and fax details are provided by cleverbridge after you select "Purchase Order" as apayment option on the order form, which is available by first going through our Order page.

4.3 Other Fookes Software Titles

ToutMailThis is a localized version of Aid4Mail for French-speaking users. It is the only software on the marketthat is capable of correctly processing mailbox files created with the French version of Eudora.

http://www.toutmail.com/

Mailbag AssistantIf you're buried in email, Mailbag Assistant is guaranteed to save you time and frustration. This user-friendly application complements your mail program and offers powerful tools to search, organize, extractinformation, and view your messages.

http://www.fookes.com/mailbag/

NoteTab ProFor 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 athesaurus and a multilingual spell checker.

Page 171: Aid4Mail3 Manual

Other Information 164

Copyright © 2005-2013 Fookes Holding Ltd

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 address-book-formatting options and the ability to filter, redirect, and forward mail. Eudora is available in differentflavors, including a free version. It is no longer being developed by QUALCOMM. An open source editioncalled Eudora OSE is now being developed and 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 Englishversion 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 robustand easy to use client, similar to competing products like Outlook Express, but with some majoradvantages 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 setincluding 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 now replaced byWindows 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 bea 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 multipleusers on single computers or on local area networks. It has special support for Novell NetWare LANsthat 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 othercommonly used products. This means that PocoMail is powerful, fast, secure, safe, and easy tomaintain. Shareware.Barca is based on PocoMail and includes many extras including a flexible Calendar, Tasks and Plannerto schedule events, popup Notes to gather information and Diary to keep track of your daily activities; allunited with a smart interface.

The Bat! (www.ritlabs.com/the_bat)The Bat! is an email application that supports multiple POP3 accounts, multithreading, MIME andUUencode standards, multimedia, APOP authorization, and PGP. You also will find a fast andcomfortable message editor with text highlighting, as well as a mail dispatcher for managing messages

Page 172: Aid4Mail3 Manual

Aid4Mail 3 Help165

Copyright © 2005-2013 Fookes Holding Ltd

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.

4.6 Acknowledgements

Many thanks to the following people who provided much helpful feedback while Aid4Mail was undergoingdevelopment and beta testing:

Jody AdairAlec BurgessGreg ChapmanDennis CumminsAlan CummingsJim HallLarry HamiltonJérôme MonteilHugo PaulissenHarvey SavageSheri Pierce

Aid4Mail is developed in Delphi, a Embarcadero product. Portions of the Aid4Mail GUI are createdwith Raize Components. ZIP-file support is based on ZipForge from ComponentAce. This Help filewas authored in Help & Manual, an EC Software product. The Setup program is made with the InnoSetup package developed by Jordan Russell. The license activation system is managed bysoftWORKZ Innovation Inc.

See also the Third Party Software Notices and/or Additional Terms and Conditions topic.

5 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 retrievalsystems – without the written permission of the publisher.

Products that are referred to in this document may be either trademarks and/or registered trademarks ofthe 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 authorassume no responsibility for errors or omissions, or for damages resulting from the use of informationcontained in this document or from the use of programs and source code that may accompany it. In noevent shall the publisher and the author be liable for any loss of profit or any other commercial damagecaused or alleged to have been caused directly or indirectly by this document.

Page 173: Aid4Mail3 Manual

Index 166

Copyright © 2005-2013 Fookes Holding Ltd

Index- / -/a 91

/addresses 94

/AddWinmailDat 89

/attachments 94

/b 91

/BadImapMailFolder 96

/contents 94

/dbs 94

/dc 97

/DelSource 89

/DisplayName 91

/dr 97

/ds 97

/eml 94

/emlExt 89

/ErrorLog 99

/exclude 97

/extract 96

/ExtractAll 96

/f 89

/fast 89

/FilterScope 97

/FilterScript 97

/ImapLog 99

/include 97

/IncludeAllItems 89

/IncludeTrash 89

/IncludeUnpurged 89

/Lf 96

/Log 99

/m 89

/MapiConvOff 89

/MapiFixOff 89

/mbox 94

/md5Name 91

/mht 94

/moz 94

/msg 94

/NoFilterLog 99

/NoLimit 99

/OutputScript 94

/pdf 94

/plain 96

/pst 94

/QuitIfTrial 99

/rich 96

/s 89

/S_Log 89

/S_Namespace 89

/S_Profile 89

/S_PW 89

/S_UserId 89

/SaveBadImapMail 96

/SessionName 99

/ShrinkBadImapMail 96

/SkipAllDups 97

/SkipDups 97

/stop 99

/t 91

/T_Log 91

/T_Namespace 91

/T_Profile 91

/T_PstSize 91

/T_PW 91

/T_UserId 91

/temp 99

/TimeZone 91

/unattended 99

/UnicodePst 94

/UseDateField 91

/UseMapiTnefConverter 89

/utf8 96

/xls 94

/zip 94

- { -{filename} token 65

- A -a4m.exe 87

About Fookes Software 162

Accessibility Mode 52

Acknowledgements 165

Activation password 17

Additional Terms and Conditions 155

Address export options 69

Advanced Options 132

Page 174: Aid4Mail3 Manual

Aid4Mail 3 Help167

Copyright © 2005-2013 Fookes Holding Ltd

Aid4Mail archives 29

Aid4Mail buttons 51

Aid4Mail Console 10, 87

Aid4Mail Console (comparison chart) 15

Aid4Mail eDiscovery 10

Aid4Mail eDiscovery (comparison chart) 15

Aid4Mail Editions 10

Aid4Mail Home 10

Aid4Mail Home (comparison chart) 15

Aid4Mail Migrator 10

Aid4Mail Professional 10

Aid4Mail Professional (comparison chart) 15

Aid4Mail Script Syntax 77

Aid4Mail Trial 16

AIM.Mail settings 121

ANSI PST 136

Anti-Virus Warnings 6

AOL Mail 22

AOL Mail settings 121

Apple computer 50

Apple Mail 50

Archive mail 64

Archiving Email 29

Attach.tab file 63

Attachment 136

attachments not found 125

- B -Barca 22

- C -Calculate command 84

Calypso 22

Check for Duplicates Across Folders - AdvancedOptions 132

Check for news updates 19

CLI 136

Command-Line Parameters 87

Comparison chart 15

console 87

Console command-line examples 115

Contacting Fookes Software 163

Copyright and Disclaimer 165

Courier 22

Create Unicode PST 65

Custom formats using scripts 65

- D -Dates in Outlook 44

Daylight time 129

Delimiter 137

DNA.dll 17

DST.dat 129

Duplicate messages 69

- E -e-discovery 10

E-discovery or forensic-examination professional (butnot a service provider) 14

EIN 163

electronic filing 139

Email archivist (but not a service provider) 14

Email Contents Switches 96

Embedded contents 137

EML files 137

Employer Identification Number (IRS) 163

Entourage 50

Error adding new message to store 44

Error creating MAPI subfolder 44

Error creating PST file 44

Error log file 131

Error processing email 44

Eudora 22

Eudora for Macintosh 50

Eudora OSE 22

Evaluation period 16

Exchange mailbox 137

Exit Codes (Aid4Mail Console) 115

Export addresses 69

Export Generic mail formats 62

Export options screen 69

Export Outlook Express 62

Export to (Thunderbird, 61

Export to Exchange 60

Export to Internet Explorer 63

Export to Microsoft Excel 63

Export to Mozilla-compatible mailboxes 61

Export to MSG 60

Export to Outlook 60

Export to PocoMail & Barca compatible mailboxes 61

Page 175: Aid4Mail3 Manual

Index 168

Copyright © 2005-2013 Fookes Holding Ltd

Export to PST 60

Export to Windows Live Mail and Windows Mail 61

Export to ZIP file 64

Export Windows Live Mail 62

Export Windows Mail 62

Extended Download Warranty 35

Extended MAPI 22, 138

Ext-Mime.dat 129

Extract message contents only 63

- F -FAQ 35

Fast Mail Processing - Advanced Options 132

FastMail settings 121

Filter Mail by Content 56

Filter Mail by Date 56

Filter Options 56

Filter Scripts 56

Filter Switches 97

Finding Mail Folders 30

Finding the Application Data folder 30

Firewall settings for product activation 17

Fix MAPI Header Errors - Advanced Options 132

Fixing attachment folder references 125

flash memory key 141

Folder 137

Folder tokens 126

forensic 10

Forte Agent 22

FoxMail 22

Frequently Asked Questions 35

- G -General Aid4Mail FAQ 39

Generic mailbox 137

Generic mailbox format 22

Gmail 22

Gmail settings 121

GMX Mail settings 121

GUI 137

GUI Command-Line Switches 134

- H -Home user migrating non-professional mail 11

Hotmail 22

- I -IMAP 137

IMAP mail 22

IMAP mail - General Aid4Mail FAQ 39

IMAP Settings 121

Import into a database 63

Incremental Processing - Advanced Options 132

Individual or organization migrating professional mail 12

Information store 138

INI File Settings 100

INI Filter Settings 110

INI Other Settings 111

INI Source Settings 101

INI Target Settings 104

Installation 6

Introduction 1

- K -Key Features 4

- L -License activation 17

License agreement 143

License Re-Activation 17

Live@edu settings 121

Local time 129

Log file 131

Log for Incremental Processing - Advanced Options 132

Log IMAP Communications - Advanced Options 132

Lost attachments 125

- M -Mac computer 50

Mac Eudora 50

Mac OS X Mail 50

Mail Source screen 53

Mail.app 50

Mailbag Assistant 163

Mailbox 138

Page 176: Aid4Mail3 Manual

Aid4Mail 3 Help169

Copyright © 2005-2013 Fookes Holding Ltd

maildir folders 22

MAPI 138

MAPI folder 138

MAPI store 138

MAPI Store screen 55

MD5 138

memory stick 141

Message folder 139

Message-ID 139

MHT attachments 63

MHT files 63, 139

MHTML 139

Microsoft Entourage 50

Microsoft Outlook 22

Microsoft Outlook FAQ 44

MIME 139

MIME Types and File Extensions 129

Mime-Ext.dat 129

Module mspst32.dll error - FAQ 44

Mozilla 22

MS Outlook 22

- N -Names in Outlook 44

Namespace (IMAP) 121

Netscape Messenger 22

News and Updates screen 73

Not Responding error 39

NoteTab 163

- O -Office 365 settings 121

Office Outlook 22

Office Outlook & Microsoft Exchange 60

Office Outlook FAQ 44

Offline activation 17

Opera Mail 22

Order by phone or fax 142

Ordering Aid4Mail FAQ 35

Ordering information 142

Other mail clients 61

Other Switches 99

Outlook 2010 bug 132

Outlook Express 22

Outlook for Mac 22

Outlook Personal Storage 65

Outlook.com settings 121

- P -partial EMLX files 22

Password - Product Activation FAQ 36

Payment options 142

PDF Settings 65

PDF/A 139

PDF/A-1a 139

Pegasus Mail 22

Personal folder store 140

Pine mbox Format 22

Pine MBX Format 22

Piracy 142

Plain text 140

PMMail 22

PocoMail 22

Popular mail clients 164

Pricing 142

Private information store 140

Processing a list of files 114

Product activation 17

Product Activation FAQ 36

Profile 140

Program interface 51

Program updates 19

Proxy Settings (IMAP) 121

Proxy settings (license activation) 17

PST files 140

pstloadtmp000 - FAQ 44

Public information store 140

Purchase Orders 142

- Q -Qualcomm Eudora 22

- R -Re-activation password 17

Read archived mail 29

Recipient 140

Refund Policy 142

Rich content 140

Rich text 140

Page 177: Aid4Mail3 Manual

Index 170

Copyright © 2005-2013 Fookes Holding Ltd

ROOT folder 22

- S -Save TNEF as Winmail.dat Attachments - AdvancedOptions 132

Screen readers 52

SeaMonkey Mail 22

Section 508 52

Secure online ordering 142

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

Setup Command-Line Parameters 7

Setup Exit Codes 9

Silent installation 7

Silent uninstall 9

Simple MAPI 138

Skipped Messages 72

Software Piracy 142

Software updates 19

software_DNA 17

softWORKZ 17

Source IMAP Folders screen 56

Source Location screen 54

Source MAPI Folders screen 55

Source Switches 89

Speed up Aid4Mail 39

SSL 141

Start Processing Mail screen 71

Status flags 141

Status indicators 141

Strict File Format Check - Advanced Options 132

Styled text 141

Supported mail formats 20

System Requirements 5

System variables 126

- T -Target Format screen 60

Target Format Switches 94

Target IMAP Folder screen 68

Target Line Format 65

Target Location 65

Target MAPI Folder screen 68

Target Settings screen 65

Target Switches 91

Templates and Fields 130

Temporary Profiles - FAQ 44

The Bat! 22

Third Party Software Notices 155

thumb drive 141

Thunderbird 22

Time Zones 129

TimeZones.dat 129

TLS 141

TNEF 141

Torrent downloads 142

ToutMail 163

Trademarks 165

TrashFiles.dat 53

TrashFolders.dat 53

Trial limitations 16

Trial mode 16

Trial Mode screen 72

- U -Unicode PST 141

Uninstall 9

Uninstaller Command-Line Parameters 9

Unpurged mail 141

Update Now 19

Upgrade policy 142

USB flash drive 141

USB key 141

USB pen 141

USB pen drive 141

Use MAPI RFC 1521 Converter - Advanced Options 132

Use MAPI TNEF Converter - Advanced Options 132

Use Received Date Field - Advanced Options 132

Using Aid4Mail with Macs FAQ 50

Using cracks 142

Using keygens 142

UTC 142

- V -View archived mail 29

Virtual PC 5

Virus warning 6

Voluntary Product Accessibility Template 52

VPAT 52

Page 178: Aid4Mail3 Manual

Aid4Mail 3 Help171

Copyright © 2005-2013 Fookes Holding Ltd

- W -Which version do I need? 11

Wildcard tokens 56

Windows Live Mail 22

Windows Mail 22

Windows Service 87

Wine 5

Words List File 112

Writing Aid4Mail Scripts 73

- X -X.400 addressing format - FAQ 44

- Y -Yahoo! Mail 22

Yahoo! Mail settings 121

- Z -ZIP Archives - FAQ 49

Zoho Mail settings 121