You are on page 1of 178

Aid4Mail 3 User Manual

Copyright 2005-2013, Fookes Holding Ltd

Aid4Mail 3
The Swiss Army knife of email conversion tools
by Fookes Holding Ltd

Aid4Mail is a leading email conversion tool used for email migration, email discovery (searching and data extraction), and email archiving. It supports over 40 mail client programs and mailbox formats, and all webmail accounts offering IMAP access. Mail folders and files can be processed even when disconnected (unmounted) from their email client including those stored on CD, DVD, and USB drives. Aid4Mail retains more information during conversion than any of its competitors, including the native import and export features of most email applications. Formatting, sender/recipient and other header details, attachments, embedded contents, and message status are converted with unmatched fidelity. This capability is crucial to large-scale migrations and for those involved in e-discovery and email archiving.

Aid4Mail
Copyright 2005-2013, Fookes Holding Ltd, Switzerland
All rights reserved. No parts of this work may be reproduced in any form or by any means - graphic, electronic, or mechanical, including photocopying, recording, taping, or information storage and retrieval systems - without the written permission of the publisher. Products that are referred to in this document may be either trademarks and/or registered trademarks of the respective owners. The publisher and the author make no claim to these trademarks. While every precaution has been taken in the preparation of this document, the publisher and the author assume no responsibility for errors or omissions, or for damages resulting from the use of information contained in this document or from the use of programs and source code that may accompany it. In no event shall the publisher and the author be liable for any loss of profit or any other commercial damage caused or alleged to have been caused directly or indirectly by this document. Printed: June 2013 in Charmey, Switzerland

Publisher Fook es Holding Ltd

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

Aid4Mail 3 Help

Table of Contents
Foreword 0

Part I General Information

1 Introduction ................................................................................................................................... 1 2 Key Features ................................................................................................................................... 4 3 System................................................................................................................................... Requirements 5 4 Installation ................................................................................................................................... 6


Setup Com m and-Line .......................................................................................................................................................... Param eters 7 Setup Exit Codes .......................................................................................................................................................... 9 Uninstall .......................................................................................................................................................... 9

5 Aid4Mail ................................................................................................................................... Editions 10 6 Which................................................................................................................................... version do I need? 11


Hom e user m.......................................................................................................................................................... igrating non-professional m ail 11 Individual or organization .......................................................................................................................................................... m igrating professional m ail 12 Service provider .......................................................................................................................................................... (including e-discovery, forensic-exam ination, and archiving services) 13 E-discovery or .......................................................................................................................................................... forensic-exam ination professional (but not a service provider) 14 Em ail archivist .......................................................................................................................................................... (but not a service provider) 14

7 Comparison ................................................................................................................................... Chart 15 8 Trial Mode ................................................................................................................................... 16 9 Product ................................................................................................................................... Activation 17 10 How to ................................................................................................................................... Get Program Updates 19 11 Supported ................................................................................................................................... Mail Formats 20 12 Information ................................................................................................................................... About Mail Formats 22 13 Archiving ................................................................................................................................... Email 29 14 Finding ................................................................................................................................... Mail Folders 30 15 Frequently ................................................................................................................................... Asked Questions (FAQ) 35
Ordering Aid4Mail .......................................................................................................................................................... FAQ 35 Product Activation .......................................................................................................................................................... FAQ 36 General Aid4Mail .......................................................................................................................................................... FAQ 39 Office Outlook .......................................................................................................................................................... FAQ 44 Aid4Mail ZIP Archives .......................................................................................................................................................... FAQ 49 Using Aid4Mail .......................................................................................................................................................... w ith Macs FAQ 50

Part II Reference Information

51

1 Program ................................................................................................................................... Interface 51 2 Accessibility ................................................................................................................................... Mode 52 3 Wizard ................................................................................................................................... Screens 53


1. Mail Source.......................................................................................................................................................... 53 2. Source Location .......................................................................................................................................................... 54 3. MAPI Store .......................................................................................................................................................... 55 4. Source MAPI .......................................................................................................................................................... Folders 55 5. Source IMAP .......................................................................................................................................................... Folders 56

Copyright 2005-2013 Fookes Holding Ltd

Contents

II

6. Filter Options .......................................................................................................................................................... 56 7. Target Form .......................................................................................................................................................... at 60 Office Outlook ......................................................................................................................................................... & Microsoft Exchange 60 Other mail clients ......................................................................................................................................................... 61 Export email ......................................................................................................................................................... to remote server 62 Generic mail ......................................................................................................................................................... formats 62 Outlook Express ......................................................................................................................................... 62 Extract message ......................................................................................................................................................... contents only 63 MHT Web Archive ......................................................................................................................................................... files 63 Mail archives ......................................................................................................................................................... 64 Custom formats ......................................................................................................................................................... using scripts 65 8. Target Settings .......................................................................................................................................................... 65 9. Target MAPI .......................................................................................................................................................... Folder 68 10. Target IMAP .......................................................................................................................................................... Folder 68 11. Export Options .......................................................................................................................................................... 69 12. Start Processing .......................................................................................................................................................... Mail 71 Skipped Messages ......................................................................................................................................................... 72 Other Screens .......................................................................................................................................................... 72 Trial Mode ......................................................................................................................................................... 72 New s and ......................................................................................................................................................... Updates 73

4 Writing ................................................................................................................................... Aid4Mail Scripts 73


Aid4Mail Script .......................................................................................................................................................... Syntax 77 Calculate com.......................................................................................................................................................... m and 84

5 Aid4Mail ................................................................................................................................... Console 87


Com m and-Line .......................................................................................................................................................... Param eters 87 Source Sw......................................................................................................................................................... itches 89 Target Sw itches ......................................................................................................................................................... 91 Target Format Sw ......................................................................................................................................... itches 94 Email Contents Sw ......................................................................................................................................... itches 96 Special IMAP Sw itches ......................................................................................................................................... 96 Filter Sw itches ......................................................................................................................................................... 97 Other Sw itches ......................................................................................................................................................... 99 INI File Settings .......................................................................................................................................................... 100 Source Settings ......................................................................................................................................................... 101 Target Settings ......................................................................................................................................................... 104 Filter Settings ......................................................................................................................................................... 110 Other Settings ......................................................................................................................................................... 111 Words List File .......................................................................................................................................................... 112 Processing a .......................................................................................................................................................... List of Files 114 Exit Codes .......................................................................................................................................................... 115 Com m and-Line .......................................................................................................................................................... Exam ples 115

6 IMAP................................................................................................................................... Settings 121 7 Fixing ................................................................................................................................... Attachment Folder References 125 8 Useful ................................................................................................................................... Tokens and System Variables 126 9 MIME ................................................................................................................................... Types and File Extensions 129 10 Time................................................................................................................................... Zones 129 11 Templates ................................................................................................................................... and Fields 130 12 Error................................................................................................................................... Log File 131 13 Advanced ................................................................................................................................... Options 132 14 GUI Command-Line ................................................................................................................................... Switches 134
Copyright 2005-2013 Fookes Holding Ltd

II

III

Aid4Mail 3 Help 15 Glossary ................................................................................................................................... 136


ANSI PST .......................................................................................................................................................... 136 Attachm ent .......................................................................................................................................................... 136 CLI .......................................................................................................................................................... 136 Delim iter .......................................................................................................................................................... 137 Em bedded contents .......................................................................................................................................................... 137 EML files .......................................................................................................................................................... 137 Exchange m ailbox .......................................................................................................................................................... 137 Folder .......................................................................................................................................................... 137 Generic m ailbox .......................................................................................................................................................... 137 GUI .......................................................................................................................................................... 137 IMAP .......................................................................................................................................................... 137 Inform ation store .......................................................................................................................................................... 138 Mailbox .......................................................................................................................................................... 138 MAPI .......................................................................................................................................................... 138 MAPI folder .......................................................................................................................................................... 138 m box .......................................................................................................................................................... 138 MAPI store .......................................................................................................................................................... 138 MD5 .......................................................................................................................................................... 138 Message folder .......................................................................................................................................................... 139 Message-ID .......................................................................................................................................................... 139 MHT files .......................................................................................................................................................... 139 MHTML .......................................................................................................................................................... 139 MIME .......................................................................................................................................................... 139 PDF/A .......................................................................................................................................................... 139 Personal folder .......................................................................................................................................................... store (PST) 140 Plain text .......................................................................................................................................................... 140 Private inform .......................................................................................................................................................... ation store 140 Profile .......................................................................................................................................................... 140 Public inform .......................................................................................................................................................... ation store 140 Recipient .......................................................................................................................................................... 140 Rich content .......................................................................................................................................................... 140 Rich text .......................................................................................................................................................... 140 SSL .......................................................................................................................................................... 141 Status Flags/Indicators .......................................................................................................................................................... 141 Styled Text .......................................................................................................................................................... 141 Thum b drive.......................................................................................................................................................... 141 TLS .......................................................................................................................................................... 141 TNEF .......................................................................................................................................................... 141 Unicode PST.......................................................................................................................................................... 141 Unpurged m ail .......................................................................................................................................................... 141 UTC .......................................................................................................................................................... 142

Part III Purchasing and License Agreement

142

1 Ordering ................................................................................................................................... Information 142 2 Upgrade ................................................................................................................................... Policy 142 3 Refund ................................................................................................................................... Policy 142 4 Software ................................................................................................................................... Piracy 142 5 End User ................................................................................................................................... License Agreement 143 6 Third................................................................................................................................... Party Software Notices and/or Additional Terms and Conditions 155

Copyright 2005-2013 Fookes Holding Ltd

Contents

IV

Part IV Other Information

162

1 About ................................................................................................................................... Fookes Software 162 2 Contacting ................................................................................................................................... Fookes Software 163 3 Other ................................................................................................................................... Fookes Software Titles 163 4 Popular ................................................................................................................................... Mail Clients 164 5 Trademarks ................................................................................................................................... 165 6 Acknowledgements ................................................................................................................................... 165

Part V Copyright and Disclaimer Index

165 166

Copyright 2005-2013 Fookes Holding Ltd

IV

Aid4Mail 3 Help

1
1.1

General Information
Introduction
Aid4Mail is a fast and highly accurate mail conversion program covering three main areas of expertise: email migration, email e-discovery (searching and data extraction), and email archiving. It is suitable for both small and large scale projects, from home use to large corporate migrations, and mission-critical forensic work. Aid4Mail supports over 40 email client programs and mail formats, as well as many popular webmail services and remote accounts through IMAP. Local mail folders and files can be processed even when disconnected (unmounted) from their email client, including those stored on CD, DVD, and USB drives. The powerful search and data extraction features provided in the professional editions of Aid4Mail are used by e-discovery experts worldwide. The filter tool enables refined searches on emails using wildcards and even complex regular expressions if necessary. The integrated scripting language makes it possible to extract just about any imaginable information from emails, including header metadata. Email archiving for long term data retention and legal compliance is another area in which Aid4Mail excels. All editions can export mail to a non-proprietary highly compressed ZIP file format or indexable EML files. Aid4Mail eDiscovery also offers the option to convert messages to PDF/A, an important electronic filing format used for long-term preservation of case-related documents. Aid4Mail is a Windows program, but can run under Unix/Linux and Mac under certain conditions. See the System Requirements for details. If you need an easy and reliable way to: export mail from Thunderbird to Outlook, import Outlook into Windows Live Mail, migrate 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 your keyboard's F1 function key. This manual is for Aid4Mail version 3.2, so earlier versions may not have some of the capabilities discussed here.

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

Copyright 2005-2013 Fookes Holding Ltd

General Information

details, attachments, embedded contents, and message status are converted with unmatched fidelity. This capability is crucial to large-scale migrations and for those involved in forensic and other e-discovery investigations.

Who Uses Aid4Mail?


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

User-Friendly and Fast


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

Why Choose Aid4Mail Over a Competing Product?


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

Migration
If you are planning large-scale mail migrations, Aid4Mail Console is the ideal solution to save time and cut costs. There is no need to install Aid4Mail Console on an end-user's computer; simply place it on a USB key (thumb drive) or on your network server. You can then automate the migration process through a batch file or other script.

E-discovery and Forensic-Examination


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

Copyright 2005-2013 Fookes Holding Ltd

Aid4Mail 3 Help

maintains formatting, sender/recipient information, attachments, embedded contents, and message status more faithfully than any of its competitors.

Email Archiving
Aid4Mail is one of the few products on the market that can export to industry standard PDF/A files (archival format). It also offers powerful archiving features which store your email in non-proprietary formats. This means that you'll always be able to get it back again. Badly managed email archives present a tempting target for litigators and regulators, and can cause loss of valuable business information. Proprietary email archives risk becoming obsolete long before the retention period is up. See our Archiving Email page for more information.

Supported Mail Formats


Aid4Mail supports many email applications including all 32-bit versions of Office Outlook (MAPI email profiles, MSG files, and mounted/unmounted PST files), Microsoft Exchange, Outlook Express, Windows Mail, Windows Live Mail, Mozilla Mail and Thunderbird, Netscape Messenger, Eudora for Windows and Mac, Pegasus Mail, UNIX mbox, Pine mbox, Entourage MBOX, maildir, EML, Apple Mail (EMLX), Mail.app for Mac, The Bat!, PocoMail, Barca, Opera Mail, Forte Agent, FoxMail (up to version 6.5), Calypso, Courier, PMMail, HTML, MHT, Excel. 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 output formats. Supported IMAP servers include Courier, Cyrus, Dovecot, Zimbra, Microsoft Exchange, Novell GroupWise, Lotus Domino, etc. For a full list of Aid4Mail's supported formats, see the Supported Mail Formats page.

Aid4Mail Versions
Aid4Mail is available in several editions: Home, Professional, eDiscovery, and Console. Each edition is distinguished by a specific set of features. The main feature differences are listed in the comparison chart. An edition is further subdivided into one or more license types. Each license type corresponds to a specific set of usage terms, which are defined in the End User License Agreement. For help in choosing the appropriate license, see the Which version do I need? topic.

Testimonial
We work with over 1TB [one terabyte] of email per month and your Aid4Mail product has shown to be an integral part of our toolset for dealing with these volumes of email. We are very impressed with your commitment to your products and appreciate the strong customer support. -- Jason Rappoport, Capsicum Group, LLC.

Note
In this documentation the names Office Outlook , Microsoft Outlook , MS Outlook , and Outlook all refer to the same mail client software. However, Outlook Express is a completely different mail program and should not be confused with Outlook.

Copyright 2005-2013 Fookes Holding Ltd

General Information

1.2

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

All editions of Aid4Mail


Import/export Microsoft Outlook mail from PST and MSG files. (Requires the standalone MAPI or the 32-bit version of Outlook for Windows either the full version or a free trial version.) Over 40 supported mail formats (see Supported Mail Formats for a complete list). Support for the IMAP protocol so you can connect to a remote mail server and upload/download messages. Works with popular services like 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 more information.) Merge mailbox files into a single one, or splits a large mailbox into smaller ones. Process huge mailbox files successfully processed a 264 GB mbox file with 3 million emails. Process huge email messages successfully converted a 270 MB email message. Correctly exports emails with attachments, embedded contents, rich text, and status information (see examples). Easily extract file attachments, embedded contents, and email addresses. Rebuild Qualcomm Eudora, PocoMail, Calypso, and Courier archive messages back to standard MIME format. Strip attachments from messages and even save emails in plain text format. Filter out duplicate emails.

Aid4Mail Professional, Aid4Mail eDiscovery, and Aid4Mail Console only


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

Aid4Mail eDiscovery and Aid4Mail Console only


Process unpurged email from most mail clients (except Office Outlook and Exchange.) Restore unpurged email during export operation. Export mail to PDF/A files (long-term archiving format). Export mail to encrypted PDF files (password protected). Embed either original RFC header or full email in exported PDF files. Offline activation.

Aid4Mail Console only


Copyright 2005-2013 Fookes Holding Ltd

Aid4Mail 3 Help

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

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


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

1.3

System Requirements
Aid4Mail has the following minimum requirements: Windows 8 / 7 / Vista / XP / 2000, Server 2012 / 2008 / 2003 Both 32-bit and 64-bit versions of Windows are supported. The following operating systems should also work but are not officially supported: + Windows NT4 / ME / 98 / 95 + Windows on a Mac with BootCamp or Parallels + Mac OS X (requires Wine, or Parallels with Windows) + Linux (requires Wine)

64 MB of RAM, 8 MB of free disk space. Pentium (or compatible) processor. To process (from/to) Outlook MSG files, PST files, and Outlook/MAPI mail profiles, Aid4Mail requires either a 32-bit version of Office Outlook for Windows (their free 60-day trial version is sufficient) or Microsoft's free standalone version of MAPI (but it does not support Unicode PST files which are created by Outlook 2003 and more recent versions). Microsoft Exchange messages can either be processed through an Outlook/MAPI mail profile (see requirements in previous point), or through the IMAP protocol in which case the Exchange server needs to be set up for IMAP access (see Microsoft's instructions). Note: Aid4Mail currently does not support the 64-bit version of Office Outlook 2010 and 2013 (Windows 64-bit with Outlook 32-bit works fine). Aid4Mail is an out-of-process application and so is not compatible with Click-to-Run installations of Outlook 2010; if available, you will need to re-install Outlook using another method, following Microsoft's instructions. If you have Outlook 98/2000 then it should be installed in Corporate/ WorkGroup mode in order to process PST and MSG files. If it is installed in Internet Mail Only (IMO) mode, then only the default MAPI profile can be processed. 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 import PST files created by Aid4Mail.
Copyright 2005-2013 Fookes Holding Ltd

General Information

After you purchase an Aid4Mail license, you will need to activate your copy of the software. This simple procedure requires an internet connection and usually takes just a few seconds. Aid4Mail eDiscovery Forensic 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 the instructions. If you have purchased a license and received an activation code, start the Aid4Mail program, click on the Software button, select Activate Product from the drop-down menu, and then enter your code in the dialog box. Note that product activation requires an internet connection. Please read the Trial Mode topic to see what limitations you will encounter during the evaluation period. If you have a licensed copy of Aid4Mail version 1 installed on your computer, there is no need to uninstall it. By default, Aid4Mail version 2 installs in a different program folder and can be used without interfering with version 1. Note that if you have received an upgrade discount on purchasing version 2, the Setup program does not require the presence of version 1 to install successfully. If you are a system administrator, see the topic Setup Command-Line Parameters for details on controlling the Aid4Mail Setup process. See also the Setup Exit Codes topic. If Aid4Mail fails to run when you launch it, please scan your computer for viruses. Aid4Mail will not run if it becomes infected by a virus or if it detects attempts to infect it. If you are sure that your computer has no viruses and Aid4Mail still doesn't run, please contact us so that we can help you resolve the issue. Anti-Virus Warnings Unfortunately, certain anti-virus products especially those using proactive protection frequently generate false positives when scanning programs. In other words, they think a file contains a virus or other malware when there is none. You may experience this issue with our products too. All our products are uploaded to the internet virus-free. Aid4Mail was scanned by 43 different anti-virus products and all showed it to be clean. If you have downloaded the software from our website, our online store, or a reputable software repository, then you can be confident it did not come with a virus. However, a virus on your computer may have infected our software after installation. If you are sure your computer has no virus, then any warning you are getting on our software is probably a false positive. If you encounter a false positive, make sure you inform the company of your anti-virus product so they can fix the issue in their next maintenance release. Until the issue is fixed, you may be able to white-list the software that is affected by the false positive, or turn off proactive protection in your anti-virus product. You can read more about false positives here: http://www.viruslist.com/en/glossary?glossid=153654932 And here is an article about a well-known false positive that caused a lot of trouble for many users: http://support.microsoft.com/kb/2025695

Copyright 2005-2013 Fookes Holding Ltd

Aid4Mail 3 Help

1.4.1

Setup Command-Line Parameters


The Setup program used for installing Aid4Mail accepts optional command line parameters. These can be useful to system administrators, and to other programs calling the Setup program. /SPDisables the "This will install... Do you wish to continue?" prompt at the beginning of Setup. /SILENT, /VERYSILENT Instructs Setup to be silent or very silent. When Setup is silent the wizard and the background window are not displayed but the installation progress window is. When a setup is very silent this installation progress window is not displayed. Everything else is normal so for example error messages during installation are displayed and the startup prompt is (if you haven't disabled it with the '/SP-' command line option explained above.) If a restart is necessary and the '/NORESTART' command isn't used (see below) and Setup is silent, it will display a "Reboot now?" message box. If it's very silent it will reboot without asking. /SUPPRESSMSGBOXES Instructs Setup to suppress message boxes. Only has an effect when combined with '/SILENT' and '/ VERYSILENT'. The default response in situations where there's a choice is: Yes in a 'Keep newer file?' situation. No in a 'File exists, confirm overwrite.' situation. Abort in Abort/Retry situations. Cancel in Retry/Cancel situations. Yes (=continue) in a DiskSpaceWarning/DirExists/DirDoesntExist/NoUninstallWarning/ ExitSetupMessage/ConfirmUninstall situation. Yes (=restart) in a FinishedRestartMessage/UninstalledAndNeedsRestart situation. 5 message boxes are not suppressible: The About Setup message box. The Exit Setup? message box. The FileNotInDir2 message box displayed when Setup requires a new disk to be inserted and the disk was not found. Any (error) message box displayed before Setup (or Uninstall) could read the command line parameters. Any message box displayed by [Code] support function MsgBox. /LOG Causes Setup to create a log file in the user's TEMP directory detailing file installation and execution actions taken during the installation process. This can be a helpful debugging aid. For example, if you suspect a file isn't being replaced when you believe it should be (or vice versa), the log file will tell you if the file was really skipped, and why. The log file is created with a unique name based on the current date. (It will not overwrite or append to existing files.) The information contained in the log file is technical in nature and therefore not intended to be understandable by end users. Nor is it designed to be machine-parseable; the format of the file is subject to change without notice. /LOG="filename"

Copyright 2005-2013 Fookes Holding Ltd

General Information

Same as /LOG, except it allows you to specify a fixed path/file name to use for the log file. If a file with the specified name already exists it will be overwritten. If the file cannot be created, Setup will abort with an error message. /NOCANCEL Prevents the user from cancelling during the installation process, by disabling the Cancel button and ignoring clicks on the close button. Useful along with '/SILENT' or '/VERYSILENT'. /NORESTART Instructs Setup not to reboot even if it's necessary. /RESTARTEXITCODE=exit code Specifies the custom exit code that Setup is to return when a restart is needed. Useful along with '/ NORESTART'. Also see Setup Exit Codes. /LOADINF="filename" Instructs Setup to load the settings from the specified file after having checked the command line. This file can be prepared using the '/SAVEINF=' command as explained below. Do not forget to use quotes if the file name contains spaces. /SAVEINF="filename" Instructs Setup to save installation settings to the specified file. Do not forget to use quotes if the file name contains spaces. /DIR="x:\dirname" Overrides the default directory name displayed on the Select Destination Location wizard page. A fully qualified pathname must be specified. /GROUP="folder name" Overrides the default folder name displayed on the Select Start Menu Folder wizard page. /NOICONS Instructs Setup to initially check the Don't create any icons check box on the Select Start Menu Folder wizard page. /COMPONENTS="comma separated list of component names" Overrides the default components settings. Using this command line parameter causes Setup to automatically select a custom type. /TASKS="comma separated list of task names" Specifies a list of tasks that should be initially selected or deselected. To deselect a task, prefix its name with a "!" character. Only the specified tasks (and their children) will be selected; the rest will be deselected. Use the / MERGETASKS parameter instead if you want to keep the default set of tasks and only select/deselect some of them. Examples: Deselect all tasks, then select the "desktopicon" and "fileassoc" tasks: /TASKS="desktopicon,fileassoc" Deselect all tasks, then select a parent task item, but exclude one of its children:
Copyright 2005-2013 Fookes Holding Ltd

Aid4Mail 3 Help

/TASKS="parent,!parent\child" /MERGETASKS="comma separated list of task names" Like the /TASKS parameter, except the specified tasks will be merged with the set of tasks that would have otherwise been selected by default. If UsePreviousTasks is set to yes, the specified tasks will be selected/deselected after any previous tasks are restored. Examples: Keep the default set of selected tasks, but additionally select the "desktopicon" and "fileassoc" tasks: /MERGETASKS="desktopicon,fileassoc" Keep the default set of selected tasks, but deselect the "desktopicon" task: /MERGETASKS="!desktopicon"

1.4.2

Setup Exit Codes


The Aid4Mail Setup program may return one of the following exit codes: 0 Setup was successfully run to completion. 1 Setup failed to initialize. 2 The user clicked Cancel in the wizard before the actual installation started, or chose "No" on the opening "This will install..." message box. 3 A fatal error occurred while preparing to move to the next installation phase (for example, from displaying the pre-installation wizard pages to the actual installation process). This should never happen except under the most unusual of circumstances, such as running out of memory or Windows resources. 4 A fatal error occurred during the actual installation process. Note: Errors that cause an Abort-Retry-Ignore box to be displayed are not fatal errors. If the user chooses Abort at such a message box, exit code 5 will be returned. 5 The user clicked Cancel during the actual installation process, or chose Abort at an Abort-RetryIgnore box. Before returning an exit code of 1, 3, or 4, an error message explaining the problem will normally be displayed. Future versions of the Aid4Mail Setup program may return additional exit codes, so applications checking the exit code should be programmed to handle unexpected exit codes gracefully. Any non-zero exit code indicates that Setup was not run to completion.

1.4.3

Uninstall
You can uninstall Aid4Mail by using the Control Panel's Add/Remove Programs dialog box or the Uninstall Aid4Mail shortcut in the Start menu. Unless mentioned otherwise, there is no need to uninstall your Aid4Mail copy when you upgrade to a newer version.

Uninstaller Command-Line Parameters


The uninstaller program (unins???.exe) accepts optional command line parameters. These can be useful to system administrators, and to other programs calling the uninstaller program.

Copyright 2005-2013 Fookes Holding Ltd

General Information

10

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

1.5

Aid4Mail Editions
Aid4Mail 3 is available in several editions, which are listed below: Aid4Mail Home Aid4Mail Home is competitively priced, but lacks support for Microsoft Exchange, PDF export, email filtering, and scripts. It may only be used to process private mail. Aid4Mail Professional Aid4Mail Professional includes all the main features but lacks forensic-specific capabilities. It may not be used to process other people's accounts in a forensic or e-discovery context. Aid4Mail eDiscovery Aid4Mail eDiscovery offers the full set of features and can be activated offline. Aid4Mail Console Aid4Mail Console is based on a command-line interface (CLI), which you can use to automate the migration process through a batch file or other script. Automation can significantly save time and ultimately cut costs. The Aid4Mail Console Migrator license, which can either be run from a server or thumb drives, is ideally suited for large-scale email migrations. Due to third-party licensing terms, the server version of Aid4Mail Console currently does not include the PDF export option. Aid4Mail Console is included with the Aid4Mail Console Migrator and Aid4Mail eDiscovery Service licenses. And it is available as a bundle option with Aid4Mail eDiscovery Forensic , Aid4Mail eDiscovery Archivist and Aid4Mail eDiscovery Personal.

Copyright 2005-2013 Fookes Holding Ltd

11

Aid4Mail 3 Help

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

1.6

Which version do I need?


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

1.6.1

Home user migrating non-professional mail


For home users and students migrating non-professional mail:

1. Aid4Mail Home Personal


Features: Process over 40 mail formats Support for Microsoft Outlook MSG and PST files Export to generic mail formats (mbox and EML) Create non-proprietary ZIP archives Extract email addresses and attachments Rebuild proprietary formats to internet standards Important: This license can only be used in a non-professional context and is not transferable. It can only be used to process one end-user mail account. A single mail account can consist of several email addresses belonging to the same person (see definition in EULA). Note that Aid4Mail Home does not support Microsoft Exchange. For this you would need Aid4Mail Professional Personal.

The following licenses can also be used if you require extra features:

2. Aid4Mail Professional Personal


Same features as Aid4Mail Home Personal, plus: Support for Microsoft Exchange, through MAPI profile Export to searchable PDF, Excel, and HTML Save to CSV and database formats Filter emails by date, keywords, and text Scriptable (custom filters and output formats) Can be used in a professional context Customer support included in subscription Important: This license can only be used to process one end-user mail account. A single mail account can consist of several email addresses belonging to the same person (see definition in EULA).

3. Aid4Mail eDiscovery Personal


Copyright 2005-2013 Fookes Holding Ltd

General Information

12

Same features as Aid4Mail Professional Personal, plus: Process unpurged mail Export to PDF/A format Scripting supports various hash functions Exchange email data with external console programs Offline activation Optional Aid4Mail Console bundle Important: This license can only be used to process one end-user mail account. A single mail account can consist of several email addresses belonging to the same person (see definition in EULA).

1.6.2

Individual or organization migrating professional mail


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

1. Aid4Mail Professional Personal


Features: Process over 40 mail formats Support for Microsoft Outlook and Exchange Export to generic mail formats (mbox and EML) Create non-proprietary ZIP archives Export to searchable PDF, Excel, and HTML Save to CSV and database formats Extract email addresses and attachments Rebuild proprietary formats to internet standards Filter emails by date, keywords, and text Scriptable (custom filters and output formats) Transferable (see EULA terms) Customer support included in subscription Important: This license can only be used to process one end-user mail account. A single mail account can consist of several email addresses belonging to the same person (see definition in EULA).

2. Aid4Mail Professional Site


Same features as Aid4Mail Professional Personal, plus: One license and activation code covers multiple seats Choose any number of seats between 3 and 20,000 Online control panel to manage seats Important: It can only be used to process one end-user mail account per seat. A single mail account can consist of several email addresses belonging to the same person (see definition in EULA).

3. Aid4Mail Console Migrator


Features: Process over 40 mail formats
Copyright 2005-2013 Fookes Holding Ltd

13

Aid4Mail 3 Help

Support for Microsoft Outlook and Exchange Command-line interface for faster migration Can be run from other applications and batch files Copy to, and run from, a thumb drive or a server The server version can be run through a Windows Service Option to run unattended (with no user-interaction) Choose any number of seats between 25 and 500,000 Does not use online activation Includes the GUI version of Aid4Mail Customer support included in subscription Important: This license can only be used for mail migration. It can only be used to process one end-user mail account per seat. A single mail account can consist of several email addresses belonging to the same person (see definition in EULA).

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

4. Aid4Mail eDiscovery Personal


Same features as Aid4Mail Professional Personal, plus: Process unpurged mail Export to PDF/A format Scripting supports various hash functions Exchange email data with external console programs Offline activation Optional Aid4Mail Console bundle Important: This license can only be used to process one end-user mail account. A single mail account can consist of several email addresses belonging to the same person (see definition in EULA).

1.6.3

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


The following license is for service providers:

Aid4Mail eDiscovery Service


Features: Process unlimited mail accounts from a single seat Process over 40 mail formats Support for Microsoft Outlook and Exchange Export to generic mail formats (mbox and EML) Create non-proprietary ZIP archives Export to searchable PDF, PDF/A, Excel, and HTML Save to CSV and database formats Extract email addresses and attachments Rebuild proprietary formats to internet standards Filter emails by date, keywords, and text
Copyright 2005-2013 Fookes Holding Ltd

General Information

14

Scriptable (custom filters and output formats) Process unpurged mail Scripting supports various hash functions Exchange email data with external console programs Offline activation Bundled 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 migrate mail, 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 seat Process over 40 mail formats Support for Microsoft Outlook and Exchange Export to generic mail formats (mbox and EML) Create non-proprietary ZIP archives Export to searchable PDF, PDF/A, Excel, and HTML Save to CSV and database formats Extract email addresses and attachments Rebuild proprietary formats to internet standards Filter emails by date, keywords, and text Scriptable (custom filters and output formats) Process unpurged mail Scripting supports various hash functions Exchange email data with external console programs Offline activation Optional Aid4Mail Console bundle Transferable (see EULA terms) Customer support included in subscription Important: This license is for e-discovery and forensic-examination professionals who are not service providers, i.e. who are processing mail under investigation, in-house (e.g. police, law firm), and not as a service to a clients (e.g. company offering forensic-examination services). It does not allow for mail migration. If you are a service provider, you need Aid4Mail 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:

Copyright 2005-2013 Fookes Holding Ltd

15

Aid4Mail 3 Help

Aid4Mail eDiscovery Archivist


Features: Process unlimited mail accounts from a single seat Process over 40 mail formats Support for Microsoft Outlook and Exchange Export to generic mail formats (mbox and EML) Create non-proprietary ZIP archives Export to searchable PDF, PDF/A, Excel, and HTML Save to CSV and database formats Extract email addresses and attachments Rebuild proprietary formats to internet standards Filter emails by date, keywords, and text Scriptable (custom filters and output formats) Process unpurged mail Scripting supports various hash functions Exchange email data with external console programs Offline activation Optional Aid4Mail Console bundle Transferable (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 mail in-house (e.g. a law firm archiving their client mail) and not as part of a service to clients (e.g. company offering archiving services). If you are a service provider, you need Aid4Mail 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 Allows processing of professional mail Home No Professional eDiscovery Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Yes Console Yes Yes Yes Yes Yes Yes Yes Yes Yes

Process over 40 mail formats, including Yes Outlook MSG and PST files * Export/import generic mail formats (mbox and EML) Extract email addresses and attachments Create non-proprietary ZIP archives Export/import MS Exchange mail * Save to CSV and database formats Yes Yes Yes No No

Export to searchable PDF, Excel, and No HTML files Filter emails by date, keywords, and text No

Copyright 2005-2013 Fookes Holding Ltd

General Information

16

Scriptable (custom filters and output formats) Script functions offering hash support and data exchange with 3rd party CLI Process unpurged mail Export to PDF/A format Offline activation option Aid4Mail Console bundle option Full command-line interface

No No No No No No No

Yes No No No No Yes No

Yes Yes Yes Yes Yes Yes No

Yes Yes Yes Yes Yes N/A Yes

Please visit our website for a more complete comparison chart. * As stated in the System Requirements section of the Specifications page, Aid4Mail requires either Office Outlook for Windows or Microsoft's free standalone version of MAPI to process messages from/to Outlook PST and MSG files, and MAPI profiles (used to access an Exchange or PST store); you can use the free standalone version of MAPI or a free 60-day trial version of Outlook if you don't have a license. Note that the free standalone version of MAPI does not support Unicode PST files. Note also that 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, but with 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 once evaluation 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 limitation and 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 by default Aid4Mail does not modify or delete your source email, you can safely select existing mail folders and stores during your tests except for Outlook 2010 users (see warning below). Outlook 2010 bug Outlook 2010 had a serious bug that caused data loss in source messages processed with the MAPI RFC 1521 Converter. Original SMTP headers were replaced with a simplified version. For most users the effects of this bug are not noticeable, or at most a minor inconvenience. However, for those working in the field of e-discovery and forensic examination such loss of data is unacceptable. We recommend that
Copyright 2005-2013 Fookes Holding Ltd

17

Aid4Mail 3 Help

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 our software. This enables us to continue its development at a competitive price. The license activation system is managed by software_DNA from softWORKZ Innovation Inc. It does not collect any details about you or your computer although you may optionally enter your email address for easy password retrieval if required.

Why should I care about piracy?


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

What it does
Unlike other activation systems, software_DNA does not tie your license to your hardware when using online activation. Essentially, your license is tied to your activation code and the password that you define. This facilitates re-activating Aid4Mail after reformatting your hard drive, upgrading hardware components in your computer, logging in under a different user profile, or moving your software to a new computer. Note that the Aid4Mail License Agreement allows the software to be moved from an old computer to a new one that replaces it. However it does not allow a license to be re-activated on a different computer or user account (e.g. Windows logon) in order to access another person's mail.

How it works
Once Aid4Mail is installed it will run in Trial Mode until activated. Usually activation is carried out online. It is a quick and simple process that requires an internet connection, and is described below. For Aid4Mail eDiscovery licenses, and some Aid4Mail Console licenses, an offline activation option is available. Once Aid4Mail has been activated, the Trial Mode limitations are removed. If Aid4Mail was activated online, then it will also require an internet connection at least once a month to verify the license status (this does not apply to licenses activated offline). Aid4Mail will remain in an activated state unless any of the following situations are encountered, in which case it will revert to Trial Mode : it is accessed from a different Windows user login, installed and run on another computer, re-installed on the same computer after a disk reformat, has not connected to the license server for at least four weeks (licenses activated online only), your license subscription period has expired. If your license subscription is still valid you can simply re-activate your license and continue using Aid4Mail. Re-activation is a quick and simple process and free of charge. Again it is usually done online, requiring an internet connection. For Aid4Mail eDiscovery licenses, and some Aid4Mail Console licenses, it can also be done offline. If your license subscription period has expired, then Aid4Mail can only be re-activated if the subscription is renewed, or if a new subscription is purchased. (License renewal is significantly cheaper than a

Copyright 2005-2013 Fookes Holding Ltd

General Information

18

corresponding new subscription.) To ensure compliance with the License Agreement, the number of re-activations allowed in a given time period is limited. If this limit is exceeded, the activation server will perform a lockout and you must wait before being allowed to reactivate. Too many failed password attempts can also result in a lockout to protect your code from theft. Note that software_DNA also includes an anti-fraud system that disables activation codes in cases of credit-card chargeback or refunds.

Online activation
Activating Aid4Mail online is quick and simple and requires an internet connection. To activate Aid4Mail: 1. Click on the "Software" button and select "Activate License" (if you have just started Aid4Mail, you can click directly on the "Activate" button). This will open the "Product Activation" dialog. 2. Enter your activation code and click on the "Next" button. 3. On the next screen, enter a password of your choice, and confirm it. Optionally, enter an email address that can be used to send your password to you if you forget it. Confirm the email address too. 4. Click on the "Activate" button.

Online re-activation
Once Aid4Mail has been successfully activated online, it will need to be re-activated in any of the situations listed above. Re-activation is quick and simple and requires an internet connection. To re-activate Aid4Mail: 1. Click on the "Software" button and select "Activate License" (if you have just started Aid4Mail, you can click directly on the "Activate" button). This will open the "Product Activation" dialog. 2. Enter your activation code and click on the "Next" button. 3. On the next screen, enter your current password. Note that it is CASE SENSITIVE. Single-user activation codes: If you cannot remember your current password, click on the "Forgot Password?" button and your password will be sent to you (as long as you have previously specified an email address). If it does not arrive within minutes, check your junk mail folder in case it was misidentified as spam. You should ensure that your spam filter allows emails from softworkz.com. Multi-user activation codes (Aid4Mail Professional Site): The activation code password is accessible to the license administrator through the Softworkz License Control Panel (LCP). The LCP can be used to manage seats linked to the activation code and change its password. Details on accessing the LCP are sent by email to the address entered on activating the first seat of the site license. 4. On the same screen, enter a new password that you have never used before in Aid4Mail. Confirm the new password. 5. Click on the "Re-Activate" button. software_DNA then checks online that the activation code and your password match the information on the server. If the match is successful, Aid4Mail is re-activated and the new password is stored on the license server, replacing the current one. If the match is unsuccessful, re-activation fails and you must retry. The number of failed password attempts allowed is limited, as is the number of re-activations in a given time period. Exceeding these limits can result in a lockout.
Copyright 2005-2013 Fookes Holding Ltd

19

Aid4Mail 3 Help

Note that to ensure the re-activation procedure is as quick and simple as possible, we strongly suggest you keep a record of your current password and any previous passwords you have used in Aid4Mail (because new passwords must not have been used before). It is preferable to keep this list off your computer so that you do not lose it if your hard disk fails.

Offline activation and re-activation


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

Proxy settings
A "proxy Server" is typically used to block access to the internet by Local Area Network users unless they are authenticated with a user name and password. If Aid4Mail resides behind a proxy server then internet access will also be blocked for the software_DNA license activation system. In this case, software_DNA must know the proxy server settings in order to work. The required information includes the server name or address, the server port number, user name, and password. You can access Aid4Mail's "Proxy Settings" as follows: 1. Click on the "Software" button and select "Activate License" (if you have just started Aid4Mail, you can click directly on the "Activate" button). This will open the "Product Activation" dialog. 2. Click on the "Proxy Settings" button to open the "Proxy Settings" dialog. On the "Proxy Settings" dialog, if "Use IE proxy configuration" is checked and "Use custom proxy settings" is not checked, then software_DNA will automatically use the proxy settings of Internet Explorer including any automatic configuration scripts. As long as Internet Explorer has connectivity to the internet (i.e. any required proxy settings are correct) then software_DNA will function properly. You should only set the "Use custom proxy settings" option, and fill in the proxy fields, if "Use IE proxy configuration" doesn't work on your system.

Frequently asked questions (FAQ)


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

1.10

How to Get Program Updates


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

Copyright 2005-2013 Fookes Holding Ltd

General Information

20

If you enable the Check for news updates setting on the News and Updates screen, Aid4Mail will automatically check our website at regular intervals for updates and other news. No information about you or your computer will be revealed during this operation. If it detects that the news file has been updated, Aid4Mail will automatically display its contents on startup. Just click on the link to view a news item or download a program update. Note that Aid4Mail needs access to the internet for this feature. If you use a firewall product like ZoneAlarm or Norton Personal Firewall, make sure you let the Aid4Mail. exe program file make the connection. Usually, program updates are downloaded and installed directly from within Aid4Mail. However, be aware that some download managers may take over this download process and interfere with normal operations. When this happens, you may see a prompt from Aid4Mail asking you to click a button once the download has been completed. With other download managers, the download may fail altogether. In this case, turn off your download manager and try again. We recommend that you enable the Check for news updates option to keep your Aid4Mail program up-to-date. However, if you prefer to check for updates manually, then use the Update Now button on the News and Updates screen instead. Updates during the subscription period are available at no charge. See the Upgrade Policy topic for further details. 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 files 1 (*.pst), Outlook MSG files 1 (*.msg), Outlook Express versions 5 and 6 (*.dbx, *.eml and *.nws), Outlook Express version 4 (*.idx and *.mbx), Windows Live Mail2 (*.eml;*.nws), Windows Mail2 (Vista mail client), IMAP accounts (supported servers include Courier, Cyrus, Dovecot, Zimbra, Microsoft Exchange, Novell GroupWise, Lotus Domino, etc.), Webmail services that offer IMAP access, e.g. 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 files 2, 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 files 2 (*.msb and *.tbb), PocoMail and Barca mailbox files (*.idx, *.idb, and *.mbx), FoxMail mailbox files up to version 6.5 2 (*.box), Opera mailbox files 2 (*.mbs), Calypso and Courier archive files, Forte Agent mailbox files 2 (*.idx),

Copyright 2005-2013 Fookes Holding Ltd

21

Aid4Mail 3 Help

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

General Information

22

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 client software. However, Outlook Express is a completely different mail program and should not be confused with Outlook. This format option is only available on computers that have a working version of 32-bit Office Outlook for Windows 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 RFC 1521 Converter option (default setting) and avoid using a version of Outlook older than 2003. Outlook calendar and contact items are only fully preserved when converting them between Outlook formats (PST, MSG, and MAPI profiles). Exporting such items to EML or mbox formats will produce incomplete data that is of little use. TNEF emails are a proprietary format used by Microsoft Outlook and Exchange. They are created when Outlook is configured to compose messages in Rich Text (RTF) instead of HTML or Plain Text. Unfortunately this proprietary format rarely converts well to a standards-compliant email format that all modern mail clients can display correctly. Aid4Mail offers several advanced options to control how TNEF emails are converted. Under default settings, Aid4Mail saves RTF text as a file attachment which can be viewed in Windows Wordpad or Microsoft Word. The Aid4Mail wizard can only process one PST file at a time. You will need Aid4Mail Console if you want to process large numbers of PST files unattended. MAPI cannot access PST files that are on readonly media or write protected (Read-Only files). As a result, if the PST file is stored on a CD-ROM or DVD, Aid4Mail will have to make a temporary copy of it in your Windows Temporary folder. If there is insufficient space on your hard drive, Aid4Mail will not be able to process the contents of your Read-Only PST file. Note also that PST files are not supported on file shares. When exporting emails stored in the root of a MAPI folder tree (unusual, but can occur) to a generic mailbox format with the restore folder option, Aid4Mail saves them to a target folder called ROOT. This feature makes it easy to find those orphan messages. Unlike Aid4Mail Console, the current GUI version of Aid4Mail cannot export a source MAPI profile or PST file to a target MAPI profile or PST file the workaround is to first export your emails to the Outlook MSG format, and then re-export those files to your target format. Known Issues: Outlook 2010 had a serious bug that caused data loss in source messages processed with the MAPI RFC 1521 Converter. Original SMTP headers were replaced with a simplified version. For most users the effects of this bug are not noticeable, or at most a minor inconvenience. However, for those working in the field of e-discovery and forensic examination such loss of data is unacceptable. We recommend that you download and install the latest maintenance release for Outlook 2010. Aid4Mail is currently a 32-bit program and so does not work with the 64-bit release of Office Outlook 2010 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

Copyright 2005-2013 Fookes Holding Ltd

23

Aid4Mail 3 Help

Unicode PST and MSG files. Aid4Mail will give an error message when you try to open a Unicode PST file with a MAPI version that does not support it. Unfortunately, there is no such warning with Unicode MSG files. Aid4Mail will appear to process them correctly, but a large part of the original email header fails to convert. The MAPI subsystem installed in the Internet Mail Only mode (IMO; Outlook 98/2000) is a stub that provides minimal MAPI support for the basic functionality of Office Outlook, and might not work properly with Aid4Mail. How to tell which setup option you have: in Outlook 98/2000 on the Help menu, click About Microsoft Outlook. Next, look at the second line of text in the About Microsoft Outlook dialog box. If it shows "Corporate or Workgroup", then you have a fully working version of Outlook with Extended MAPI installed. The current version of Aid4Mail does not support folder and file names with Unicode characters. Any such character that doesn't translate to the ANSI character set will be replaced with a substitution character. Aid4Mail may not be able to process your PST file if it is damaged or oversized. If you experience issues, you could try one of the following Microsoft tools to repair your PST file: How to use the Inbox Repair Tools to recover email messages in Outlook 2002, 2003, 2007, and 2010 (scanpst.exe): http://support.microsoft.com/kb/287497/ Oversized PST and OST crop tool (Pst2gb.exe): http://support.microsoft.com/kb/q296088 2. Windows Live Mail Windows Live Mail (WLM) is the email client from Microsoft's Windows Live set of products. It is intended to be a replacement for Outlook Express on Windows XP and Windows Mail on Windows Vista. Unlike Outlook Express, it saves messages as individual EML files. Aid4Mail can read WLM disk folders and convert locally stored messages to any of the supported output formats. However, the current version is not capable of retrieving or setting email status information (unread, read, replied, etc.) Please note that the folder names on disk may not reflect the names you see in WLM. Before exporting messages to WLM with Aid4Mail, make sure you have configured it with at least one mail account so that the appropriate target folder is created. You must export your source mail under the "Storage Folders" location. Open WLM once Aid4Mail has completed the transfer. WLM will start indexing your new folders and messages; during this time the "Unread email" count increases progressively. Make sure you give it enough time to complete the task. Sometimes new folders do not appear immediately under "Storage Folders"; this display issue is usually fixed by restarting WLM. 3. Windows Mail Windows Mail replaces Outlook Express under Windows Vista. Unlike Outlook Express, it saves messages as individual EML files. Aid4Mail can read Windows Mail disk folders and convert the messages to any of the supported output formats. However, the current version is not capable of retrieving or setting email status information (unread, read, replied, etc.) Please note that the folder names on disk may not reflect the names you see in Windows Mail. Before exporting messages to Windows Mail with Aid4Mail, make sure you have configured it with at least one mail account so that the appropriate target folder is created. You must export your source mail under the "Local Folders" location. Open Windows Mail once Aid4Mail has completed the transfer.
Copyright 2005-2013 Fookes Holding Ltd

General Information

24

Windows Mail will start indexing your new folders and messages. Make sure you give it enough time to complete the task. Sometimes new folders do not appear immediately under "Local Folders"; this display issue is usually fixed by restarting Windows Mail. 4. Outlook Express Many people think Outlook Express and Outlook are the same mail clients, or closely related. In fact, other than the fact that they are both developed by Microsoft and have the "Outlook" part of the name in common, these mail clients are totally unrelated. Their approach to storing mail is completely different and the file formats that they produce are not interchangeable. Outlook Express only supports Simple MAPI, which is a small subset of the Extended MAPI system. Aid4Mail can read Outlook Express mail files directly; it does not need a copy of Outlook Express installed on your computer to do so. Unlike most other conversion programs, Aid4Mail is capable of retrieving status information (unread, read, replied, etc.) from your messages and restore these in the output format. Outlook Express stores deleted messages in the Deleted Items.dbx file. Unfortunately, it corrupts the messages during this process. Aid4Mail can extract these deleted messages, but it cannot fix corrupted data. As a result, some messages may exhibit unusual characters or display code that you would not normally see. Attachments and embedded contents in these messages will usually also be corrupted. EML files produced by Aid4Mail can be imported into Outlook Express with Windows Explorer. Simply select the EML files in Windows Explorer (the Ctrl+A shortcut selects all the files in your current folder) and then drag them into the Outlook Express application window and drop them into the mail folder of your choice. 5. Thunderbird, SeaMonkey Mail, Eudora OSE, Mozilla Mail, Netscape Messenger Thunderbird, Mozilla Mail, SeaMonkey, Eudora OSE, and recent versions of Netscape Messenger all share the same mailbox format, which is very close to the mbox format. The main difference is in the way mail status information (unread, read, replied, etc.) is stored. Aid4Mail can read the Mozilla status flags and correctly convert them to other formats. Note that Eudora OSE is basically a skin operating on top of Thunderbird. So if you need to export or import from Eudora OSE, choose Mozilla Thunderbird as your mail format. Mail stores are usually composed of two files: an index file (*.msf or *.snm) and a mailbox file (same name as index file but without a file extension). Aid4Mail only processes mailbox files since that is where the email messages are stored. As a result, missing or corrupted index files have no negative influence on the quality of email conversions. Note that when the Windows Search Integration option is set in Thunderbird, a copy of each message is stored with the .wdseml extension in a .mozmsg folder; the file format is identical to EML files. Before exporting messages to any of these mail clients with Aid4Mail, make sure you have configured them with at least one mail account so that the appropriate target folder is created. Prior to version 3, Thunderbird has a bug that makes it fail to display mail folders that have a storage path length that exceeds 128 characters. If you run into this limit, you can display more folders by moving the profile or the accounts directory closer to the root of the drive, so that less of the total path length is wasted. Another solution is to rename your source mail folders to shorter names before converting them with Aid4Mail.

Copyright 2005-2013 Fookes Holding Ltd

25

Aid4Mail 3 Help

Unless you enabled message synchronization, local mailboxes for IMAP accounts are empty and only index files for managing the remote messages are created. 6. Qualcomm Eudora This section concerns the Qualcomm version of Eudora. More recent versions are developed by the Mozilla Foundation and use a different mailbox format, which is identical to Mozilla Thunderbird (see section #5 above). Aid4Mail can read both the Eudora index files (*.toc) and its mailbox files (*.mbx). Mail status information (unread, read, replied, etc.) is stored in the index files, not in the mailbox files. So unless they are corrupted or missing, you should always select the *.toc files instead of the *.mbx files to process in Aid4Mail. Eudora creates very compact mailbox files. It does so by extracting attachments and embedded contents from messages, and saves these in separate folders. The advantage of this approach is that mailbox files grow less quickly when you receive mail and attachments are easily accessible through Windows Explorer or another file manager. The disadvantage of Eudora's approach is that the original message MIME format is lost and the message header information no longer reflects the format of the message body. Eudora also has a tendency to corrupt its own mailbox files by adding binary characters that do not belong there and messing up the message delimiters. Most of the time, the mailbox files that Eudora produces no longer conform to RFC 822 rules. As a result, most mail clients are incapable of importing Eudora mail reliably. Aid4Mail is one of the few programs that is capable of rebuilding email in Eudora mailboxes back to their original MIME format. It can also fix most corrupted messages. As a result, you can reliably migrate your Eudora mail without losing file attachments, embedded contents, rich text, and status information. Note that old versions of Eudora produced rich text based on the Enriched Text Format (emails start with <x-rich>), which may not supported by all modern mail clients. If you have deleted or moved Eudora attachments, Aid4Mail won't be able to re-insert them into the corresponding email messages. In such cases, the attachments will show up with no contents. There is, however, a way to instruct Aid4Mail where to look for attachment folders that have changed location through a file called Tokens.ini. See instructions under the Fixing Attachment Folder References topic. If you are converting Macintosh Eudora mailbox files, Aid4Mail expects to find the mailbox files under the "Mail Folder" folder, attachments in the "Attachments Folder" folder, and embedded contents in the "Parts Folder" folder. All three folders share the same parent folder. If your attachment and embedded contents files are in a different location, see the instructions under the Fixing Attachment Folder References topic. Aid4Mail currently cannot retrieve mail status information (unread, read, replied, etc.) from Mac Eudora. Sent dates stored in the Out mailbox rarely convert well when exported to formats that require a standards-compliant date format. That is because Eudora stores the sent date in the Out.toc file using a text format based on the Windows or Mac short date setting. And over time, with each OS upgrade and mail migration, the date format can change. As a result, it cannot be reliably converted through software methods to a standard format. To work around this issue, Aid4Mail uses the From-delimiter date from Out.mbx, which uses a standards-compliant date format. Note, however, that this date corresponds to the time when the email was added to the mailbox. If the email is moved to a different folder, then the date no longer corresponds to the sent date. 7. Apple Mail (Mac OS X)
Copyright 2005-2013 Fookes Holding Ltd

General Information

26

Aid4Mail is capable of processing email files stored by all versions of Apple Mail. Since Aid4Mail is a Windows application, it will only run on Intel-based Macs that are running Windows or Wine, and on PowerPC Macs using Virtual PC. We recommend that you run Aid4Mail on a Windows system as it will process mail much faster that way. If you want to migrate your Apple Mail to a Windows email program, first transfer your files from Mac to Windows. You can also copy your Apple Mail folders and files to a CD, DVD, or USB drive, which Aid4Mail can then access from your Windows computer. Aid4Mail can read the MBOX files created by Apple Mail 1 (that comes with Mac OS X 10.0 to 10.3) if that is the format you have, use the "Generic mailboxes" Mail Source option under the "Generic Mailbox Format" section in Aid4Mail. Later versions of Apple Mail (starting with version 2) store their messages in EMLX format. To migrate those messages, use the "Apple Mail message files" Mail Source option under the "Popular mail clients" section in Aid4Mail. To migrate your Windows email messages to Apple Mail, run Aid4Mail on your Windows computer and convert your mail to the "Generic mailboxes" format, which is listed under the "Generic formats" section on the Target Format screen in Aid4Mail. We recommend that you set the "File name" field on the Target Settings screen to "*.MBOX" (without the quotes), and set the "Target Line Format" option to "Macintosh (CR)". You will then have to transfer the mbox files created by Aid4Mail to your Mac system, and use the Apple Mail import command to copy your emails into it. 8. IMAP Mail Aid4Mail can download and upload email from and to a remote mail server using the IMAP protocol. IMAP is available with popular services like Yahoo! Mail, Gmail, AOL Mail, Outlook.com, and Outlook 365. Please note that, at this time of writing, IMAP access to a Yahoo! Mail account is not officially supported by Yahoo. As a result, there is no guarantee that this option will be available in the future. Beware! Gmail enforces daily bandwidth limits. As of this writing, you can upload up to 500 MB and download up to 2,500 MB of email per day. 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 are capable of reading or importing messages from generic mailbox files. Note that Aid4Mail cannot read the *.box mailbox files from Calypso and Courier. Messages in BOX files are stored in encrypted format so that other programs cannot access them. Before you can process these messages in Aid4Mail, you must first save your *.box files to Calypso or Courier archives (these are equivalent the generic mailbox files). To do this, use the Mailbox/Save to Archive menu command in Calypso or Courier and choose the option to save with attachments. Message status information is limited to Read and Unread in Calypso and Courier. Aid4Mail also cannot process Pine MBX files, which use a proprietary format that is in no way related to the mbox format. 10. Pegasus Mail Aid4Mail can read both the Pegasus index files (*.pmi) and its mailbox files (*.pmm). Mail status information (unread, read, replied, etc.) is stored in the index files, not in the mailbox files. So unless
Copyright 2005-2013 Fookes Holding Ltd

27

Aid4Mail 3 Help

they are corrupted or missing, you should always select the *.pmi files instead of the *.pmm files. Pegasus stores new mail in separate *.cnm files. If you want Aid4Mail to convert those along with the other mail folders, choose "Pegasus Mail (index)" as the source format and select the folder that contains all the Pegasus mailbox files (do not highlight any of the PMI files otherwise Aid4Mail will ignore all CNM file). With Aid4Mail Console, simply specify "*.pmi" as your source mail in order to include all CNM files during processing. 11. PocoMail and Barca Aid4Mail can read both the PocoMail/Barca index files (*.idx) and its mailbox files (*.mbx). Aid4Mail only reads mail status information (unread, read, replied, etc.) from the index files, not in the mailbox files. So unless they are corrupted or missing, you should always select the *.idx files instead of the *.mbx files. PocoMail and Barca offer options to create compact mailbox files. The mail client does so by extracting file attachments from messages, and saves these in a separate folder. The advantage of this approach is that mailbox files grow less quickly when you receive mail and attachments are easily accessible through Windows Explorer or another file manager. The disadvantage of this approach is that the original email MIME format is lost and most mail clients fail to import such messages reliably. Aid4Mail is the only program that is capable of rebuilding messages in PocoMail and Barca mailboxes back to their original MIME format. As a result, you can reliably migrate your PocoMail/Barca mail without losing file attachments, embedded contents, rich text, and status information. If you have deleted or moved extracted PocoMail/Barca attachments, Aid4Mail won't be able to re-insert them into the corresponding email messages. In such cases, the attachments will show up with no contents. There is, however, a way to instruct Aid4Mail where to look for attachment folders that have changed location through a file called Tokens.ini. See instructions under the Fixing Attachment Folder References topic. Before exporting messages to PocoMail or Barca with Aid4Mail, make sure you have configured them with at least one mail account so that the appropriate target folder is created. 12. The Bat! Recent versions of The Bat! offer an option to create very compact mailbox files. It does so by extracting file attachments and embedded contents from messages, and saves these in a separate folder. The advantage of this approach is that mailbox files grow less quickly when you receive mail and attachments are easily accessible through Windows Explorer or another file manager. The disadvantage of this approach is that few programs are capable of migrating such messages reliably. Aid4Mail can rebuild messages in The Bat! mailboxes back to their original MIME format. As a result, you can reliably migrate your The Bat! mail without losing file attachments, embedded contents, rich text , and status information. If you have deleted or moved extracted The Bat! attachments, Aid4Mail won't be able to re-insert them into the corresponding email messages. In such cases, the attachments will show up with no contents. There is, however, a way to instruct Aid4Mail where to look for attachment folders that have changed location through a file called Tokens.ini. See instructions under the Fixing Attachment Folder References topic. Please note that Aid4Mail cannot process encrypted The Bat! mail files. In this case, you will first have to export your messages with The Bat! to a Generic mailbox format, which Aid4Mail can then process to
Copyright 2005-2013 Fookes Holding Ltd

General Information

28

any of the supported formats. 13. Opera Mail Over the years, Opera's mail client has changed storage format several times. The more recent versions do not organize messages in mailboxes with corresponding names. Instead, Opera uses virtual mailboxes that classify messages according to use-defined filters. Aid4Mail does not have the capability to interpret Opera filters. As a result, messages are classified according to their nature. Incoming mail is stored in the "Received" mailbox, outgoing mail is exported to the "Sent" mailbox, and Usenet messages are placed in the "News" mailbox. Opera only supports the email status Read and Unread. Unfortunately, the current version of Aid4Mail cannot extract this information from the Opera data files. 14. Microsoft Entourage Aid4Mail does not process Microsoft Entourage's native mail database stores, but it does handle the MBOX file format that Entourage supports. If you want to migrate your Entourage mail to a Windows email program, first convert your Entourage mail folders to MBOX files. The simplest way to do this is to drag each folder of messages to the Mac desktop. Entourage will automatically create an MBOX file for each folder you drag-and drop to the desktop. Next, you will have to transfer your MBOX files from Mac to Windows. You can also copy your MBOX files to a CD, DVD, or USB drive, which Aid4Mail can then access from your Windows computer. Use the "Generic mailboxes" mail source option under the "Generic Mailbox Format" section in Aid4Mail to select your MBOX files and then choose the appropriate target email format when you reach the Target Format screen. To migrate your Windows email messages to Microsoft Entourage, run Aid4Mail on your Windows computer and convert your mail to the "Generic mailboxes" format, which is listed under the "Generic formats" section on the Target Format screen in Aid4Mail. We recommend that you set the "File name" field on the Target Settings screen to "*.MBOX" (without the quotes), and set the "Target Line Format" option to "Macintosh (CR)". You will then have to transfer the mbox files created by Aid4Mail to your Mac system. Then either use the Entourage import command to copy your emails into it (File / Import / Contacts or Messages from a text file / Import messages from an MBOX-format text file), or drag-anddrop the MBOX files to the Entourage folder window. 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 variation does not escape all occurrences of lines beginning with the "From " delimiter inside the message. As a result, if a Pine mbox file is processed the same way as a regular generic mailbox file, some messages may get split up into smaller parts instead of being treated as a single email. This often produces unusable messages. To avoid this problem when processing Pine mbox files, make sure you select "Pine mbox" instead of "Generic mailboxes" as your Mail Source. Note that Pine also supports a proprietary MBX format that is in no way related to the mbox format. Aid4Mail currently cannot process those Pine MBX files.

Copyright 2005-2013 Fookes Holding Ltd

29

Aid4Mail 3 Help

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 do not have any status information except for those created with Aid4Mail. Note that Foxmail does not store date information for messages in the out.BOX. As a result, these outgoing messages are exported with a default "unknown" date set to 1 Jan 1972. Also, Aid4Mail cannot restore the FoxMail folder hierarchy and names are based on the mailbox file names. Unless you use IMAP, you can only process Maildir folders if the files are available locally (i.e., they can also be accessed through Windows Explorer). In most cases, you will first have to download the folders from a remote server with an FTP utility to your computer.

1.13

Archiving Email
Protect Your Business with Your Email Archives Badly managed email archives present a tempting target for litigators and regulators, and can cause loss of valuable business information. Download the free report, "Manage Your Email So It Doesn't Manage You", and learn how to: Significantly reduce email storage space. Email archives are growing and there is no end in sight. Learn how to shrink your email storage without compromising your archives. Easily access archived email content. In a regulatory investigation or legal discovery, you don't have the luxury of telling investigators and litigators to wait until you find what you need. You need to produce it now. Time-proof your email archives. Long retention periods are becoming the norm, but proprietary archives may not be available long-term. Learn how to easily set and observe retention periods, and how to protect yourself from obsolete archives. What Aid4Mail will do for you 1. Aid4Mail stores your email archives as non-proprietary, generic mailbox files. This means that you'll always be able to get them back again. Proprietary email archives risk becoming obsolete long before the retention period is up. 2. Your email files are highly compressed in standard ZIP files. This saves you a huge amount of room on your archive tapes and drives and makes it extremely simple to open them again. 3. Aid4Mail extracts attachments and embedded contents like images and sound files and stores them in separate folders inside the archived ZIP file. This way you can easily access attachments and embedded contents without using special utilities. 4. Aid4Mail automatically removes duplicates of attachments and embedded contents. When you have broadcast the same email with attachments to multiple users, only the original email is archived. This significantly reduces the size of ZIP archives and doesn't return 20 copies of the very same email in searches. 5. Use any storage media you like for your archived email. Aid4Mail can easily read your archive files from any drive that Windows Explorer can access, including CD-ROMs and DVDs, local or network drives, hard drives or tape. 6. Supports most of the popular email formats, including Outlook, Mozilla Thunderbird, Eudora, Pegasus and a host of others. 7. Search and filter by folder, date range and/or by matching text. 8. You can also extract names and email addresses of people that have been corresponding with you an ideal feature if you need to rebuild an address book or create a mailing list.

Copyright 2005-2013 Fookes Holding Ltd

General Information

30

How to read archived mail There are several ways you can access and read mail stored in Aid4Mail ZIP archives. The best way is to use Aid4Mail filters to extract just the messages you're looking for. Simply select your ZIP archive as the source mail, set the filter options so that they find the specific messages you want to view, and choose an appropriate target format. Select a temporary target folder if you plan to remove the exported messages after viewing. An ideal target format is "MHT message files for viewing from Web browser" if you haven't got too many messages in your selection and you don't mind using Internet Explorer. Alternatively, you can export messages to the EML format; double-clicking on such a file in your file manager (e.g. Windows Explorer) will normally display the message in a new window created by a compatible email program (Outlook Express, Windows Mail, Thunderbird). Of course, you can also export all your archived mail to any of the supported mail programs. If you are looking for an archived attachment, simply open your ZIP archive in Windows Explorer (requires Windows XP or more recent) or a ZIP utility (e.g. 7-Zip, WinZip). You will find attachments stored as regular files under the Attach folder. If you are looking for pictures or other documents that were inserted in the email message, search the Embedded folder instead. If you do not want to use Aid4Mail to extract messages from your ZIP archive, you can also simply extract the mbox files with Windows Explore or a ZIP utility, and then view them "raw" in a text editor or an mbox reader (mail client or utility). Fookes Software offers a program called Mailbag Assistant that can 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 by browsing through your disk folders using the Source Location file browser or the Folder Browser available on the Target Settings page by clicking on the [] button in the Folder field. You might find it helpful to use the Search tool provided by Windows under the Start menu; make sure you enable searching through hidden folders (you may also need to use "Tools | Folder Options | View" in Windows Explorer and select "Show hidden files and folders"). IMPORTANT: If you are exporting mail to a new mail client, the appropriate target folder may only exist once you have set up a profile and/or mail account in it. We recommend that you fully configure your new mail program before attempting to export mail to it with Aid4Mail. The information below should help you find the mail folder for the specified mail client program. Many programs store their data files under the "Application Data" folder. This is indicated below with the <Application Data> token. The path to this folder depends on your Windows version and your system's configuration. See the topic "Finding the Application Data folder" below for information on where to find it. Finding the Application Data folder On Windows 8, 7 and Vista systems, look for <SYSTEMDRIVE>\Users\<user>\AppData\Roaming and in the case of Microsoft Outlook, Windows Mail, and Windows Live Mail: <SYSTEMDRIVE>\Users\<user>\AppData\Local On Windows 2000 and XP systems, look for <SYSTEMDRIVE>\Documents and Settings\<user>\Application Data and in the case of Microsoft Outlook and Windows Live Mail:

Copyright 2005-2013 Fookes Holding Ltd

31

Aid4Mail 3 Help

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

1. Microsoft Outlook Typical default location: <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-4032AB71-B48918A73052}. The specific numbers and letters is different on every system. Files to search for with Outlook Express 5.x and 6.x: Inbox.dbx Sent Items.dbx Deleted Items.dbx Files to search for with Outlook Express 4.x: Inbox.idx Sent Items.idx Deleted Items.idx 3. Windows Live Mail Typical default location: <Application Data>\Microsoft\Windows Live Mail\

Copyright 2005-2013 Fookes Holding Ltd

General Information

32

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.toc Out.toc Trash.toc 6. Thunderbird and Eudora OSE Typical default location: <Application Data>\Thunderbird\Profiles\default\<code>.slt\Mail\ Often the main account is stored under Mail\Local Folders\ Files to search for: Inbox.msf Sent.msf Trash.msf TIP: Here's a simple trick to find where any Thunderbird mail folder is stored... Right click with your mouse on a folder name in Thunderbird to open the shortcut menu. In Thunderbird version 3, choose Properties from the menu and then select and copy all the text in the Location field of the Folder Properties dialog box. In Thunderbird version 2, choose the "Copy Folder Location" command from the shortcut menu. If you want to set Thunderbird as your source mail client, stop when you reach the Source Location screen in Aid4Mail. Then right click in the folder field and choose the "Go to Folder" command from the shortcut menu. Aid4Mail will automatically show the correct folder path in the dialog box. If you want to set Thunderbird as your target mail client, stop when you reach the Target Settings screen in Aid4Mail. Paste the Clipboard contents in the field labeled Folder. The resulting path will look
Copyright 2005-2013 Fookes Holding Ltd

33

Aid4Mail 3 Help

somewhat like this: "mailbox:///C:/Users/.../Mail/Local Folders/Inbox" or "mailbox:/C|/Documents and Settings/.../Mail/Local Folders/Inbox". Once you click on the Next button, Aid4Mail will automatically convert the path to the correct Windows format. 7. Mozilla Mail & Netscape 6.x, 7.x Possible default location: <Application Data>\Mozilla\Profiles\default\<code>.slt\Mail\ Files to search for: Inbox.msf Sent.msf Trash.msf 8. Netscape Messenger Possible default location: <SYSTEMDRIVE>\Program Files\Netscape\Users\ Files to search for: Inbox.snm Sent.snm Trash.snm 9. Pegasus Mail Typical default locations: <SYSTEMDRIVE>\PMAIL\MAIL <SYSTEMDRIVE>\Program Files\PMAIL\MAIL Files to search for: *.pmi *.pmm 10. PocoMail and Barca Typical default location, Windows 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.idb Out.idx or Out.idb Trash.idx or Trash.idb 11. The Bat! Typical default locations: <Application Data>\The Bat!\
Copyright 2005-2013 Fookes Holding Ltd

General Information

34

Typical default location: <SYSTEMDRIVE>\Program Files\The Bat!\MAIL\ Files to search for: MESSAGES.TBB MESSAGES.TBX 12. Calypso Email Typical default location: <SYSTEMDRIVE>\Program Files\Calypso3\Mailbox\ Files to search for: *.box 13. Courier Email Typical default location: <SYSTEMDRIVE>\Program Files\Courier\Mailbox\ Files to search for: *.box 14. Opera Mail Typical default locations: <Application Data>\Opera\Opera\mail\store\ <SYSTEMDRIVE>\Program Files\Opera\Mail\storage\ Files to search for: *.mbs 15. Forte Agent Typical default location: <SYSTEMDRIVE>\Program Files\Agent\Data\ Files to search for: 00000001.IDX GROUPS.DAT folders.dat 16. Foxmail Typical default location: <SYSTEMDRIVE>\Program Files\FoxMail\mail\ <SYSTEMDRIVE>\Users\<USER>\AppData\Local\Foxmail\Data\Boxes\ Files to search for: in.BOX sent.BOX trash.BOX
Copyright 2005-2013 Fookes Holding Ltd

35

Aid4Mail 3 Help

17. PMMail Typical default location: <SYSTEMDRIVE>\Program Files\PMMail 2000\ Files to search for: *.MSG 18. Evolution (under Ubuntu) Typical default locations: <SYSTEMDRIVE>\home\ubuntu\.local\share\evolution\mail\local\ <SYSTEMDRIVE>\home\<user>\.local\share\evolution\mail\local\ File to search for: Inbox.

1.15

Frequently Asked Questions (FAQ)


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

1.15.1 Ordering Aid4Mail FAQ


Q. Where can I buy your software from? Do you have a local dealer? A. You can buy Aid4Mail through our online order page. We have no local dealers. Our software is sold world-wide by cleverbridge, a leading e-commerce company. Cleverbridge is under contract with Fookes Software to process orders and collect payments. They accept orders online using a credit card (Visa, MasterCard, American Express, JCB), PayPal, wire transfer and, under certain conditions, purchase order. Q. I have a license for Aid4Mail version 1. How do I get an upgrade discount for the latest version? If you have a valid license for Aid4Mail version 1, you can benefit from a significant upgrade discount when purchasing a corresponding license of version 3. Simply visit our upgrade page and enter either one of your activation codes or your Plimus order number. Please note that you can only use this upgrade discount once; it is not available for subsequent orders. Q. Can I use a Purchase Order? Purchase orders are only available to corporate customers and must use your official company letterhead. You will receive the cleverbridge fax number in a later step. If you require immediate product delivery, please use the credit card or PayPal payment option instead.

Copyright 2005-2013 Fookes Holding Ltd

General Information

36

Q. I want to pay by wire transfer and need your bank details. A. Select "Wire transfer" as payment option in the order form. After clicking the "Next" button, you will be taken to a page with detailed instructions, including your order reference number and the bank details for your payment. Q. I have purchased an Aid4Mail license but still haven't received my activation code. When will I get it? A. All information regarding your order, including activation code(s), are sent to you via email usually within minutes of your payment being accepted. However, sometimes these emails may be caught by your "Spam Protection" tool, or may be automatically sent to your "Junk" folder. Please be sure to check those locations if you do not receive the emails shortly. In some cases, your email service may be experiencing a slowdown in email delivery delays of several hours are possible in these situations. In other cases, your ISP may be blocking the emails before they even reach your account. When this happens, the only solution is for you to provide an alternative address to which we can send the registration emails. Please contact us if the email with your activation code(s) hasn't reached you within minutes of your completed order. Q. How can I download Aid4Mail again? A. Simply visit the Aid4Mail website to download the latest update. Q. Why was my order was declined? A. When the message "Credit card was declined" appears while processing an order it means that your credit card bank has declined the transaction, usually a quick call to your credit card bank's customer service will clarify most of the issues. If problems persist, please use a different payment option. Q. What is your Refund Policy? A. Please go to the Refund Policy topic in this document to find the answer to this question. Q. What is your Upgrade Policy? A. Maintenance releases, updates, and upgrades are free during the validity of your subscription period. When your annual subscription period runs out, you will have the option to renew it at a significant discount 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) are blocking Aid4Mail's access to the internet. Make sure that all your firewalls allow both Aid4Mail.exe and DNA.dll to reach the activation server. If you are accessing the internet through a Proxy server and you've configured the Aid4Mail proxy settings, make sure these are valid. If you are not using Internet Explorer as your browser, it may be configured with invalid proxy settings; unchecking the "Use IE proxy configuration" option in the Proxy Settings screen could help resolve the connection issue.

Copyright 2005-2013 Fookes Holding Ltd

37

Aid4Mail 3 Help

It is also possible that a connection fails because of heavy internet traffic. The only solution in this case is to wait 15 minutes or more and then repeat the activation procedure. Important: If you are using Windows Firewall and Aid4Mail cannot reach the license server, make sure that you uncheck the option labeled "Block all incoming connections" (Windows Vista) or "Don't allow exceptions" (Windows XP); you will find the option in the Windows Firewall settings window which opens from the Control Panel. If this setting is enabled, you are not notified when Windows Firewall blocks programs, and programs on the Exceptions list are ignored. Q. Can I activate Aid4Mail 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 discount when purchasing a corresponding license of version 3. Simply visit our upgrade page and enter either one of your activation codes or your Plimus order number. Q. What happens when my Aid4Mail subscription runs out? A. The Aid4Mail program simply reverts to trial mode. This does not affect any of the files you created during the subscription period. If you have an annual subscription, you will have the option to renew it at a 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 and password. Why? A. This usually happens because the character case of the entered password does not match the case of the original password. Check that your Caps Lock key isn't engaged while you are entering your password. Check also that you are typing the characters in the same case as the original password. Make sure you are entering your current and new password in the corresponding fields. Another password-related problem is when you try to re-activate your license with a new password that you have already used before. Make sure that the password you type in the "New Password" field has never been used before in Aid4Mail. In some rare cases when internet traffic is high, the connection to the license server may time out. When this happens, Aid4Mail may display the Activation screen instead of the Re-activation screen. If this happens, wait 15 minutes or more and then repeat the activation procedure. Q. I have forgotten my activation password. How do I retrieve it? Single-user activation codes A. If you can't remember your password, click on the "Forgot Password?" button in the Activation dialog box, which appears on the screen after you enter your activation code. Your password will then be sent to the email address you entered when you first activated your license. If the email doesn't reach you within minutes, check your junk mailbox in case it was misidentified as spam. Note that this feature will only work if you supplied your email address when you first activated your license. If you chose not to provide an email address during activation, then it is your responsibility to
Copyright 2005-2013 Fookes Holding Ltd

General Information

38

keep track of your current password. Multi-user activation codes (Aid4Mail Professional Site) A. The activation code password is accessible to the license administrator through the Softworkz License Control Panel (LCP). Details on accessing the LCP are sent by email to the address entered on activating the first seat of the site license. Q. Why am I in "Lockout mode"? A. Lockout mode usually occurs because you have attempted too many re-activations or too many unsuccessful communications with the license server (e.g., because of failed password attempts) in the allowed time period. Note that the Aid4Mail License Agreement allows the software to be moved from an old computer to a new one that replaces it. However it does not allow a license to be re-activated on a different computer or user account (e.g. Windows logon) in order to access another person's mail. If you are in lockout mode because of too many re-activations, please read the Aid4Mail License Agreement to ensure that you are complying to its terms. Q. Will Aid4Mail activations still be possible if softWORKZ or Fookes Software suspends service? A. If softWORKZ or Fookes Software suspends service, customers will be able to download a patch that bypasses the activation system or a special version of Aid4Mail that does not use any activation system. Q. Will you stop offering activations on products that are x years old? A. No. Activations and re-activations will be available to all versions of our products during the validity of your subscription period. Q. Do hardware upgrades/new computers cause the previously activated software to stop working? A. No. License activation is not tied to your hardware. If you need to reinstall your software after reformatting your hard drive or moving to a new computer, you just need to re-activate your software. Reactivation is a quick and simple method to get your software fully operational again. Note, however, that the copy on your previous computer will revert to trial mode if you re-activate your code on another computer. Q. Aid4Mail will reside on computers that are not permitted access to the internet via our firewall. Can you provide the port, IP-address of the verification server, and the domain in which that server resides. This way we may permit outbound access to just the activation site and port. A. The following is the information that you need to setup your firewall: Main server IP address: reg1.softworkz.com Backup server IP: reg2.softworkz.com Port: 80 (Standard HTTP) Domain: softworkz.com User agent: Aid4Mail (case sensitive)

Copyright 2005-2013 Fookes Holding Ltd

39

Aid4Mail 3 Help

1.15.3 General Aid4Mail FAQ


Q. How do I transfer mail from my old computer to my new one? A. First install Aid4Mail on your old computer and activate your license. On your old computer, use Aid4Mail to convert your source mail to the Aid4Mail ZIP Archive format. Next, transfer the resulting ZIP file to your new computer and install Aid4Mail on it; then re-activate your license. Finally, use Aid4Mail on your new computer to export your ZIP Archive contents to your new mail program. Q. 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 avoid this, and unless you are using Office Outlook, make sure you close your mail client before clicking on the Start button in Aid4Mail. Check also that you haven't got an anti-virus or anti-spam program monitoring the mail that Aid4Mail is processing. Other possible reasons include a source file that is corrupted or does not correspond to the selected mail type, or the target location has insufficient free space or is write protected. Sometimes it may help to compact your mail folders before processing them with Aid4Mail. Aid4Mail checks both the file extension and contents to see if they conform with the selected source format. You can instruct Aid4Mail to be more "tolerant" with certain file types by turning off the Strict File Format Check option or using the /m command-line switch. This can be useful with files that start with a non-conforming format. Q. Aid4Mail freezes during processing and the title bar shows (Not Responding). Is this a bug? A. Probably not. Aid4Mail may appear to hang when it is trying to connect to a remote server (IMAP account) or processing a very big email (typically a message with one or more huge attachments). Depending on your processor speed, amount of available RAM, and source or target format (for example Outlook), such a message may take as long as several hours to process. If you encounter this situation, don't assume Aid4Mail has stopped working. Instead of terminating the process, simply give it enough time to finish its job. Q. Are there file size limits that need to be taken into account when exporting mail? A. Yes. If you have a large amount of mail or many big attachments, the target file receiving your messages can grow very big. Outlook 2003 and 2007 can store up to 20 GB of data in a single file using the Unicode PST format, and Outlook 2010 and 2013 up to 50 GB. Older versions of Microsoft Outlook create ANSI PST files that are limited to 2 GB in size (note that Aid4Mail cannot detect when this size limit is reached). Note that the PST size limit may be set smaller through registry settings (see this Microsoft Knowledge Base). Some email clients cannot read generic mailbox files that are bigger than 4 GB. An Aid4Mail ZIP archive can easily exceed a size of 20 GB; in fact the maximum file size is limited only by your system's resources. Q. Why do I see my own email address instead of the recipient details after exporting my Sent folder? A. Most mail programs and webmail interfaces check the folder location of a message to determine which field to use for the contact details. For mail stored in the default Sent folder, the recipient details are taken from the email To, Cc, and Bcc fields. And for mail stored in any other folder, the sender details are taken from the email From field. To correct this display issue, simply move your outgoing emails to the default Sent folder.

Copyright 2005-2013 Fookes Holding Ltd

General Information

40

Q. Can I run multiple instances of Aid4Mail? A. Yes you can, as long as you don't attempt to convert mail to the same target file in different instances. Q. Are there ways to make Aid4Mail process emails faster? A. Yes. If you are using anti-virus, anti-spam, Windows file indexing, archiving products, or any other software/plugin that monitor email messages, turn them off temporarily when using Aid4Mail. Doing so can significantly improve processing speed. You can also speed up processing by unchecking the "Do not add duplicate messages" setting on the Export Options screen or, if you are running Aid4Mail Console, avoid using the /SkipDups and /SkipAllDups command-line switches. Aid4Mail does extensive text parsing and format analysis when reading generic mailbox files, including those created by Mozilla Thunderbird and Eudora. It does so to ensure it doesn't miss any emails when processing mailbox files that contain a mix of storage formats (e.g. a Mac or Unix mbox file imported in Windows Thunderbird with new messages added to it). If you are processing mailbox files that are entirely created by a single mail client, then you can increase performance without sacrificing reliability by turning on the Fast Mail Processing option or using the /fast command-line switch. With Outlook 2003 and more recent, Aid4Mail uses the internal MAPI converter to import/export mail from Outlook PST and MSG files, and Exchange server stores. The advantage of this method is that it converts messages with non-Latin characters and certain special email types more reliably than the Aid4Mail method. The disadvantage of the internal MAPI converter is that it is usually slower than Aid4Mail's conversion method. Uncheck the Use MAPI RFC 1521 Converter option or use the / MapiConvOff command-line switch to turn off the internal MAPI converter and use Aid4Mail's faster method instead. Example: Aid4Mail.exe /MapiConvOff The two command-line switches mentioned above can be used together if necessary. Example:
Aid4Mail.exe /fast /MapiConvOff

Note that working on compacted or expunged mailbox files (i.e. those in which unpurged mail has been removed) can also improve conversion speed significantly. If you are responsible for migrating mail accounts in your company, you should encourage staff members to compact their mail folders before you start processing their data with Aid4Mail. Q. I have a huge mailbox file and Aid4Mail says it has no messages. Why? A. Usually this happens when a mailbox file only contains deleted or moved messages (unpurged mail) and has never (or not recently) been compacted or expunged. The file may also be corrupted or contain data that does not match the selected source file type. Also, certain proprietary file formats, like DBX files from Outlook Express and PST files from Office Outlook, never have a size of zero bytes when empty and compacted. Q. Is there an easy way to find where a Thunderbird mail folder is stored? A. Yes there is. See the following instructions. 1) To find Local Folders: Right click with your mouse on a local folder name in Thunderbird to open the shortcut menu. In
Copyright 2005-2013 Fookes Holding Ltd

41

Aid4Mail 3 Help

Thunderbird version 3 and 5, choose Properties from the menu and then select and copy all the text in the Location field of the Folder Properties dialog box. In Thunderbird version 2, choose the "Copy Folder Location" command from the shortcut menu. If you want to set Thunderbird as your source mail client, stop when you reach the Source Location screen in Aid4Mail. Then right click in the folder field and choose the "Go to Folder" command from the shortcut menu. Aid4Mail will automatically show the correct folder path in the dialog box. If you want to set Thunderbird as your target mail client, stop when you reach the Target Settings screen in Aid4Mail. Paste the Clipboard contents in the field labeled Folder. The resulting path will look somewhat like this: "mailbox:///C:/Users/.../Mail/Local Folders/Inbox" or "mailbox:/C|/Documents and Settings/.../Mail/Local Folders/Inbox". Once you click on the Next button, Aid4Mail will automatically convert the path to the correct Windows format.

2) To find locally stored IMAP folders (when message synchronizing is enabled): First choose the Tools -> Account Settings menu command to open the dialog box. Then select the "Server Settings" item under the IMAP account name you are searching for. You will find the root folder path in the "Local directory" field. Note that you should not choose that location as your target destination for converted emails. Q. After exporting my messages to Thunderbird, I find that some of my mail folders are missing. Why? A. Prior to version 3, Thunderbird has a bug that makes it fail to display mail folders that have a storage path length that exceeds 128 characters. If you run into this limit, you can display more folders by moving the profile or the accounts directory closer to the root of the drive, so that less of the total path length is wasted. Another solution is to rename your source mail folders to shorter names before converting them with Aid4Mail. Q. Why do exported EML and MSG file have the current date stamp instead of the original email date? A. This problem is usually caused by the Windows file indexing feature, which updates the file date stamp on reading it. Suggestion: in Windows, go to Control Panel -> Indexing Options -> Advanced -> File Types, and uncheck the extensions "eml" and "msg" from the list. Q. Why does Aid4Mail slow down when converting many emails to individual files (EML and MSG)? A. This problem may be caused by the Windows file indexing feature or your anti-virus program. Suggestion: in Windows, go to Control Panel -> Indexing Options -> Advanced -> File Types, and uncheck the extensions "eml" and "msg" from the list. Q. How do I import EML files into Outlook Express? A. EML files produced by Aid4Mail can be imported into Outlook Express with Windows Explorer. Simply select the EML files in Windows Explorer (the Ctrl+A shortcut selects all the files in your current folder) and then drag them into the Outlook Express application window and drop them into the mail folder of your choice. Q. The CSV file I created with Aid4Mail does not display correctly in Microsoft Excel. Why?
Copyright 2005-2013 Fookes Holding Ltd

General Information

42

A. Microsoft Excel cannot handle cell data that exceeds 32 KB. Excel will split any email that exceeds the data size limit into smaller chunks and spread them across several columns. As a result, columns will contain incorrect data in certain rows. Note that Excel does not recognize CSV files using the UTF-8 text encoding unless the data is proceeded with a byte order mark (BOM) encoding signature. If you open a UTF-8 encoded CSV file that lacks a BOM in Excel, all special extended characters will be rendered incorrectly. Q. Attachments in MHT files get saved with a bad file name. Why? A. This issue is due to a bug in Internet Explorer. When you click on an attachment link in an MHT file to save the document to disk, Internet Explorer displays an incorrect file name in the Save As dialog box. You should replace it with a more meaningful name and especially add the appropriate file extension. (Use the same extension as displayed in the attachment link.) Q. After exporting my messages to a new mail client, I find that some of my attachments are missing or failed to convert as expected. Why? A. Some mail clients extract attachments and store them in a separate location from messages. This is the case with Eudora and Calypso/Courier, as well as with The Bat!, PocoMail, and Barca, depending on the settings you've chosen. These mail clients usually store the path and file name of extracted attachments to maintain a link between the message and its files. Unfortunately, if you move the attachments to another location, or the original drive is assigned another letter, then the link is lost. Aid4Mail uses this link to find the attachments of the messages it processes. If it cannot find the attachment, Aid4Mail still adds the file placeholder; instead of the file data Aid4Mail inserts the full name of the file that was not found. Note that some programs may show an incorrect attachment size for empty attachments, and even produce a "garbage" file on extraction. Attachments that Aid4Mail doesn't find are listed in the error log file; see the Error Log File topic for details. There is, however, a way to instruct Aid4Mail where to look for attachment folders that have changed location through a file called Tokens.ini. See instructions under the Fixing Attachment Folder References topic. Q. How does Aid4Mail detect duplicates? A. Aid4Mail checks for email duplicates by comparing the value of the Message-ID field in each processed email header. If this field is empty or missing (usually in outbound messages), Aid4Mail uses other header data for the comparison. In MAPI messages (from Office Outlook and Microsoft Exchange), Aid4Mail uses the email creation and submit dates, subject line, and stored message size. In other types of messages, Aid4Mail uses the email date and subject line for the comparison, or other header fields (To, Cc, Bcc, From delimiter) if either of those values are missing, or the whole header if none of those fields contain any data. When extracting attachments and other embedded contents, Aid4Mail first checks if a file with the same name exists in the target folder. If there is, it checks whether the contents are identical. If they are, the duplicate is not saved. If the files are different, then Aid4Mail saves the file with a new name the original file name followed by an index number in square brackets. Example: Untitled.doc Untitled[1].doc
Copyright 2005-2013 Fookes Holding Ltd

43

Aid4Mail 3 Help

Untitled[2].doc Q. Sometimes my source email client reports more and sometimes less messages than the target email client. How am I gaining messages or loosing mail during the conversion? Why doesn't the message count of the email clients always equal each other? A. There are a few reasons that this can happen. First, you may have the options to remove duplicates and/or ignore deleted mail checked which would result in fewer message in the target mailbox. Your source email client may have duplicated messages in its mailboxes causing the mismatch of the email message count. Secondly, some mailboxes get corrupted at the place which marks the start of the next message (the email delimiter) in the mailbox. If that line is corrupt, the next message in the mailbox may be considered part of the previous message causing less total messages. Thirdly, the index file (such as *.idx, *.toc) may be corrupt causing the mismatch of email messages. Lastly, Aid4Mail attempts to correct some corrupted mailboxes which often also causes an email message count difference. Q. Some of my message status flags, the icons in the index message grid, that are in the source email client do not show up in the target email client and some are different. Are these bugs? A. There are at least two reasons for status indicators (such as: read, unread, replied, forwarded, redirected, and priorities) not to get converted or what appears to be the wrong icons displaying in the target email client. All status flags are not all supported in all email programs, therefore, some may not show up in the target email client. We also found that some email clients have glitches in them that cause incorrect status icons to be displayed in their own program. Aid4Mail converts the correct data found in the email client's index file (or mailbox) where the status information is stored to the target email client that displays them correctly which causes the discrepancy in the two. Aid4Mail does not convert email messages based on the status icon displayed, nor does it make the target email client display the same wrong status icon/indicator. If you feel that the problem you see is within Aid4Mail, and not the email client, please contact us and explain to us the problem you are experiencing. We may then ask you to send us a sample mailbox file or messages if the need arises. Q. When exporting messages to put on a CD-ROM you recommend using the MD5 file naming option to limit the length of file names and avoid name conflicts. However, sometimes I like to open specific MHT email files or EML email messages. It's difficult to do so with the meaningless MD5 names (mixed letters and numbers). How can I locate the messages I want to open in a text editor? A. This is not as hard to do as you might think. Your text editor might have a feature to search for words/ phrases in disk files without the need to open the files into a text editor first. Our award winning NoteTab text and HTML editor has such a feature called Search Disk that will find the search criteria in the messages that contain it and open each message(s) (of choice) in its own tab. You can then simply use the Find dialog (Ctrl+F) and quickly bring the tab in focus at the word(s) searched for. NoteTab is available in free and commercial versions. Q. When making EML, MHT, and MSG message files and the "Subject:" of the message is used as the file name. Some of the characters are changed? Why is this? A. Windows does not allow certain characters in file names such as: / ? | * : < >. Aid4Mail converts the "Subject:" lines that have those characters in them to legal file name characters before processing the mailbox(es) into EML, MHT, and MSG files. Character conversion can be customized through a
Copyright 2005-2013 Fookes Holding Ltd

General Information

44

specialized template file called NameFilter.dat. Open the file NameFilter.txt for instructions and a working example. Q. My PocoMail "Special mailboxes" contain messages, but Aid4Mail does not process them. Why is this? A. Your PocoMail email client's "Special mailboxes" are a type of virtual mailboxes. The messages are not in that folder. It just has an appearance of the messages. The "messages" act sort of like a shortcuts so that when you see the messages in the index grid and click on one, it is actually opening the message from another PocoMail mailbox. If you convert all your mailboxes, the messages will indeed be processed! If you know which mailbox(es) they are actually stored in, you can process it and the messages will be found in the target mailbox created by Aid4Mail. Q. Are there known issues when processing email files? A. Aid4Mail currently does not support certain folder file names that contain Unicode characters. Such folders and files cannot be processed unless they are renamed so as to remove unsupported characters.

1.15.4 Office Outlook FAQ


Q. I cannot see options to process Office Outlook mail. Why? A. Make sure a 32-bit editions of Office Outlook for Windows or Microsoft's free standalone version of MAPI is correctly installed on your system. Aid4Mail cannot process MAPI mail accounts, PST, and MSG files if Extended MAPI is not available. For more details, free options, and limitations, see the system requirements. Unlike Aid4Mail Console, the current GUI version of Aid4Mail cannot export a source MAPI profile or PST file to a target MAPI profile or PST file the workaround is to first export your emails to the Outlook MSG format, and then re-export those files to your target format. Q. How do I import my old Outlook files to another mail program on a new computer that does not have Office Outlook? A. If you still have your old computer with Office Outlook, first install Aid4Mail on it and activate your license. Then convert your Outlook mail to the Aid4Mail ZIP Archive format. Next, transfer the resulting ZIP file to your new computer and install Aid4Mail on it; then re-activate your license. Finally, use Aid4Mail to export your ZIP Archive contents to your new mail program. Q. When I select a PST file or a MAPI profile, Aid4Mail does not see any mail folders/ messages. A. This issue could be due to one of the following reasons... 1. 2. 3. 4. Outlook for Windows is not installed on your system. See the System Requirements topic for free solutions. You are using the 64-bit version of Outlook 2010 or 2013. Install the 32-bit MSI edition to fix this issue (Windows 64-bit with Outlook 32-bit works fine). You have an Outlook 2010 Click-to-Run installation. Re-install without the Click-to-Run method if available. You are trying to access a Unicode PST file with a MAPI system that does not support the new format.

Copyright 2005-2013 Fookes Holding Ltd

45

Aid4Mail 3 Help

5. 6.

You are trying to access a mail store that is write protected or has limited access rights. You have Outlook 98/2000 installed in Internet Mail Only Mode (IMO). Re-install in Corporate/ WorkGroup mode. 7. The MAPI profile details you provided were incorrect. 8. You have installed Outlook but have not yet configured a default mail account. 9. Your mail is on a remote computer that is not accessible. 10. The mail file is empty. 11. A third-party utility is interfering with Aid4Mail (synchronization software, backup, anti-virus, etc.). If your version of Microsoft Outlook is older than Outlook 2003, this issue may occur because your copy of Outlook is not the default email client. In that case, see if temporarily setting it as the default client fixes the issue and restart Aid4Mail. To change the default email client, open the Internet Properties dialog box. (This can be done either by right-clicking on the Internet Explorer program shortcut and selecting "Properties", or by opening Internet Explorer and selecting "Internet Options" from the "Tools" menu.) Then select the Programs tab, and select the "Microsoft Office Outlook" value in the field labeled E-mail. If none of the above applies, see if rebooting your computer fixes the issue. Q. When I select a source MAPI profile or PST file, those options are not available on the Target Format screen. Why? A. Unlike Aid4Mail Console, the current GUI version of Aid4Mail cannot export a source MAPI profile or PST file to a target MAPI profile or PST file the workaround is to first export your emails to the Outlook MSG format, and then re-export those files to your target format. Q. Why do some messages exported from Outlook have email addresses in the X.400 format instead of SMTP? A. If your Outlook source mail has addresses in the X.400 addressing format (e.g. /o=Fookes software/ ou=fs/cn=recipients/cn=customer support), Aid4Mail will try to convert them to the regular SMTP format (e.g. support@fookes.com). To do so, Aid4Mail searches through all your address books (as listed in the Addressing configuration of your Outlook profile) for a case-insensitive exact match of the X.400 address. The X.400 to SMTP conversion fails if there is no match or if the matching contact item does not have a corresponding email address in SMTP format. If your mail source is a PST file, Aid4Mail can only search contact items in the local address book. If the information necessary for the X.400 to SMTP conversion is stored in an external list (GAL or other directory service), then first create an Outlook profile that is connected to your directory service (use LDAP to connect your GAL). Next, add your PST file to the profile and set it as the default store. Finally, in Aid4Mail choose the Email Profile option instead of the PST file as your Mail Source. Note that X.400 to SMTP conversion is limited to outgoing source messages (usually stored in the Sent Items folder). With incoming messages, Aid4Mail restores the original SMTP email header which normally never has email addresses in the X.400 format. Q. I have a damaged/corrupted PST file. Can Aid4Mail process it? A. The only way to find out is to try. If it doesn't work, you could try one of the following Microsoft tools to repair your PST file: How to use the Inbox Repair Tools to recover e-mail messages in Outlook 2010, 2007, 2003 and 2002 (scanpst.exe):
Copyright 2005-2013 Fookes Holding Ltd

General Information

46

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 Outlook 2010 are not supported. If your version of Microsoft Outlook is older than Outlook 2003, this issue may occur because your copy of Outlook is not the default email client. In that case, see if temporarily setting it as the default client fixes the issue and restart Aid4Mail. To change the default email client, open the Internet Properties dialog box. (This can be done either by right-clicking on the Internet Explorer program shortcut and selecting "Properties", or by opening Internet Explorer and selecting "Internet Options" from the "Tools" menu.) Then select the Programs tab, and select the "Microsoft Office Outlook" value in the field labeled E-mail. If the above doesn't apply, see if rebooting your computer fixes the issue. Q. With Outlook 2007 SP2, why do I get an error in "Module mspst32.dll"? A. The error occurs when you use Aid4Mail to convert mail to a new PST file. This issue only occurs with Microsoft Office 2007 Service Pack 2. It appears modifications made in Office 2007 SP2 affect features that worked unchanged since Outlook 97. Microsoft have now fixed the problem so the solution is to update to the latest maintenance release of Office 2007 SP2. If for any reason this is not possible, a workaround in Aid4Mail is to convert mail to an existing MAPI profile instead of a new PST file. Q. What could cause an "Error adding new message to store" message? A. The error may be triggered by a break in your network connection. For example when converting mail to a mapped drive using a wireless connection that times out. Q. Why do I get an "Error creating MAPI subfolder" message? A. Your source mail folders may contain characters or a format that MAPI cannot use when creating target folder names. However, we have found that with some versions of Outlook the problem disappears after rebooting the computer. If this does not help, try renaming the source mail folder that is causing the problem. Q. Why do I get an "Error processing email" message? A. This error may be triggered by different types of problems. It can occur when your default email client is set to a program that does not support Extended MAPI. If that is the case, go to the Internet Explorer Properties and select the Programs tab; then select "Microsoft Office Outlook" or ExchangeMAPI in the E-mail field. Q. How do I display my Aid4Mail created PST files in Microsoft Outlook? A. You can open PST files through the File/Open/Outlook Data File menu command in Microsoft Outlook. Older versions of Outlook may use slightly different names for the menu command. Note that Unicode PST files created with Outlook 2003, 2007, 2010, and 2013 cannot be opened with an older version of Outlook.

Copyright 2005-2013 Fookes Holding Ltd

47

Aid4Mail 3 Help

Q. Why is Microsoft Outlook showing wrong dates/contact names in the Folder Pane? A. By default, Microsoft Outlook displays the Sent date and the contact name from the To field for messages in the Sent Items folder, and the server Received date and the contact name from the From field for messages in other folders. As a result, you may see unexpected dates and names in the Folder Pane for imported "outgoing emails" that are not saved in the Sent Items folder. To correct this display issue, simply move those outgoing emails to the Sent Items folder. The quickest way to do this is press the Ctrl+A keyboard shortcut to select all the messages in a folder, then use the Ctrl+Shift+V keyboard shortcut to open the Move to Folder dialog box, and then select the Sent Items folder in the list. Q. I have Office Outlook installed in Internet Mail Only mode (IMO). Is it supported by Aid4Mail? A. The MAPI subsystem installed in the Internet Mail Only mode (only exists in Outlook 98/2000) is a stub that provides minimal MAPI support for the basic functionality of Office Outlook, and may not work properly with Aid4Mail. When using Office Outlook 98 and 2000, it must be installed in Corporate/ WorkGroup mode to ensure full compatibility with Aid4Mail. Instructions for changing Outlook 2000 mode are available on Microsoft's website. How to tell which setup option you have: In Outlook on the Help menu, click About Microsoft Outlook. Next, look at the second line of text in the About Microsoft Outlook dialog box. If it shows "Corporate or Workgroup", then you have a fully working version of Outlook with Extended MAPI installed. Q. Are there ways to make Aid4Mail process emails faster? A. Yes. If you are using anti-virus, anti-spam, Windows file indexing, archiving products, or any other software/plugin that monitor email messages, turn them off temporarily when using Aid4Mail. Doing so can significantly improve processing speed. You can also speed up processing by unchecking the "Do not add duplicate messages" setting on the Export Options screen or, if you are running Aid4Mail Console, avoid using the /SkipDups and /SkipAllDups command-line switches. Aid4Mail does extensive text parsing and format analysis when reading generic mailbox files, including those created by Mozilla Thunderbird and Eudora. It does so to ensure it doesn't miss any emails when processing mailbox files that contain a mix of storage formats (e.g. a Mac or Unix mbox file imported in Windows Thunderbird with new messages added to it). If you are processing mailbox files that are entirely created by a single mail client, then you can increase performance without sacrificing reliability by turning on the Fast Mail Processing option or using the /fast command-line switch. With Outlook 2003 and more recent, Aid4Mail uses the internal MAPI converter to import/export mail from Outlook PST and MSG files, and Exchange server stores. The advantage of this method is that it converts messages with non-Latin characters and certain special email types more reliably than the Aid4Mail method. The disadvantage of the internal MAPI converter is that it is usually slower than Aid4Mail's conversion method. Uncheck the Use MAPI RFC 1521 Converter option or use the / MapiConvOff command-line switch to turn off the internal MAPI converter and use Aid4Mail's faster method instead. Example: Aid4Mail.exe /MapiConvOff The two command-line switches mentioned above can be used together if necessary. Example:
Aid4Mail.exe /fast /MapiConvOff

Note that working on compacted or expunged mailbox files (i.e. those in which unpurged mail has been removed) can also improve conversion speed significantly. If you are responsible for migrating mail accounts in your company, you should encourage staff members to compact their mail folders before

Copyright 2005-2013 Fookes Holding Ltd

General Information

48

you start processing their data with Aid4Mail. Q. How do I check what type (ANSI or Unicode) of PST I have? A. Open the PST file in Outlook. If your version of Outlook is older than Outlook 2003, then it will not be able to open a Unicode PST. If you are using Outlook 2003 or a later version then select the root folder of the PST file, in the Outlook Mail list column. Right-click on the folder, and choose Properties from the menu. From the Properties dialog box, click on the Advanced button to open the Personal Folders dialog box. This contains a field called Format. If it shows "Personal Folders File (97-2002)", then the file is an ANSI PST, otherwise it is a Unicode PST. Q. My mail is stored on an IMAP server, which Office Outlook connects to. Why is Aid4Mail only exporting message headers? A. You need to configure Outlook to download the complete email, not just the header. To make the change, you must open the Send/Receive Settings dialog box in Outlook, select your IMAP account, and then select "Download complete item including attachments" in the Folder Options section. Once you've done that, Aid4Mail should be fetching the whole email. To reach the Send/Receive Settings dialog box, you must first open the Send/Receive Groups dialog box using the Ctrl+Alt+S keyboard shortcut, or the following menu command: Tools -> Send/Receive -> Send/Receive Settings -> Define Send/Receive Groups..., then click on the Edit button. Q. Are there known issues when processing Microsoft Outlook PST files or MAPI profiles? A. Outlook 2010 had a serious bug that caused data loss in source messages processed with the MAPI RFC 1521 Converter. Original SMTP headers were replaced with a simplified version. For most users the effects of this bug are not noticeable, or at most a minor inconvenience. However, for those working in the field of e-discovery and forensic examination such loss of data is unacceptable. We recommend that you download and install the latest maintenance release for Outlook 2010. Aid4Mail is currently a 32-bit program and so does not work with the 64-bit release of Office Outlook 2010 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 email address). Unfortunately, Aid4Mail does not receive an error message from Outlook when it fails to import such emails. The only way to find out whether an email is not supported by Outlook is by displaying it. You will see a text like the following in the message body: "This message was not processed because it contains an invalid recipient." Outlook versions prior to Outlook 2003 as well as the free standalone version of MAPI cannot process Unicode PST and MSG files. Aid4Mail will give an error message when you try to open a Unicode PST file with a MAPI version that does not support it. Unfortunately, there is no such warning with Unicode MSG files. Aid4Mail will appear to process them correctly, but a large part of the original email header fails to convert. To reliably export mail into a PST file or MAPI profile, we recommend that you turn on the MAPI RFC 1521 Converter option (default setting) and avoid using a version of Outlook older than 2003. Outlook calendar and contact items are only fully preserved when converting them between Outlook formats (PST, MSG, and MAPI profiles). Exporting such items to EML or mbox formats will produce incomplete data that is of little use. TNEF emails are a proprietary format used by Microsoft Outlook and Exchange. They are created when
Copyright 2005-2013 Fookes Holding Ltd

49

Aid4Mail 3 Help

Outlook is configured to compose messages in Rich Text (RTF) instead of HTML or Plain Text. Unfortunately this proprietary format rarely converts well to a standards-compliant email format that all modern mail clients can display correctly. Aid4Mail offers several advanced options to control how TNEF emails are converted. Under default settings, Aid4Mail saves RTF text as a file attachment which can be viewed in Windows Wordpad or Microsoft Word. The current version of Aid4Mail does not support folder and file names with Unicode characters. Any such character that doesn't translate to the ANSI character set will be replaced with a substitution character. The MAPI subsystem installed in the Internet Mail Only mode (IMO; Outlook 98/2000) is a stub that provides minimal MAPI support for the basic functionality of Office Outlook, and might not work properly with Aid4Mail. How to tell which setup option you have: in Outlook 98/2000 on the Help menu, click About Microsoft Outlook. Next, look at the second line of text in the About Microsoft Outlook dialog box. If it shows "Corporate or Workgroup", then you have a fully working version of Outlook with Extended MAPI installed.

The following applies only if you are using a version of Outlook that is older than Outlook 2003, or when unchecking the Use MAPI RFC 1521 Converter option or using the /MapiConvOff command-line switch: Importing a PST file created with this method into Outlook may result in loss of data or formatting. We recommend that you open the PST file in Outlook instead of using the import command. Another issue may occur when you attempt to process messages with text that is written in a non-Latin character set (like Cyrillic and Chinese). Converting such messages to or from Microsoft Outlook may produce unexpected results. Furthermore, MAPI does not support Unicode attachment file names so Aid4Mail cannot restore the correct name for such files.

1.15.5 Aid4Mail ZIP Archives FAQ


Q. How do I read archived mail? A. There are several ways you can access and read mail stored in Aid4Mail ZIP archives. The best way is to use Aid4Mail filters to extract just the messages you're looking for. Simply select your ZIP archive as the source mail, set the filter options so that they find the specific messages you want to view, and choose an appropriate target format. Select a temporary target folder if you plan to remove the exported messages after viewing. An ideal target format is "MHT message files for viewing from Web browser" if you haven't got too many messages in your selection and you don't mind using Internet Explorer. Alternatively, you can export messages to the EML format; double-clicking on such a file in your file manager (e.g. Windows Explorer) will normally display the message in a new window created by a compatible email program (Outlook Express, Windows Mail, Thunderbird). Of course, you can also export all your archived mail to any of the supported mail programs. If you are looking for an archived attachment, simply open your ZIP archive in Windows Explorer (requires Windows XP or more recent) or a ZIP utility (e.g. 7-Zip, WinZip). You will find attachments stored as regular files under the Attach folder. If you are looking for pictures or other documents that were inserted in the email message, search the Embedded folder instead. If you do not want to use Aid4Mail to extract messages from your ZIP archive, you can also simply extract the mbox files with Windows Explore or a ZIP utility, and then view them "raw" in a text editor or an mbox reader (mail client or utility). Fookes Software offers a program called Mailbag Assistant that

Copyright 2005-2013 Fookes Holding Ltd

General Information

50

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 Macs using Virtual PC. However, we do recommend that you try Aid4Mail first before purchasing a license to ensure that it is compatible with your computer system and that it satisfies your requirements. Q. Does Aid4Mail support Apple Mail (Mac OS X)? A. Yes. Aid4Mail is capable of processing email files stored by all versions of Apple Mail. Since Aid4Mail is a Windows application, it will only run on Intel-based Macs that are running Windows or Wine, and on PowerPC Macs using Virtual PC. We recommend that you run Aid4Mail on a Windows system as it will process mail much faster that way. If you want to migrate your Apple Mail to a Windows email program, first transfer your files from Mac to Windows. You can also copy your Apple Mail folders and files to a CD, DVD, or thumb drive, which Aid4Mail can then access from your Windows computer. Aid4Mail can read the MBOX files created by Apple Mail 1 (that comes with Mac OS X 10.0 to 10.3) if that is the format you have, use the "Generic mailboxes" mail source option under the "Generic Mailbox Format" section in Aid4Mail. Later versions of Apple Mail (starting with version 2) store their messages in EMLX format. To migrate those messages, use the "Apple Mail message files" Mail Source option under the "Popular mail clients" section in Aid4Mail. To migrate your Windows email messages to Apple Mail, run Aid4Mail on your Windows computer and convert your mail to the "Generic mailboxes" format, which is listed under the "Generic formats" section on the Target Format screen in Aid4Mail. We recommend that you set the "File name" field on the Target Settings screen to "*.MBOX" (without the quotes), and set the "Target Line Format" option to "Macintosh (CR)". You will then have to transfer the mbox files created by Aid4Mail to your Mac system, and use the Apple Mail import command to copy your emails into it. Q. Does Aid4Mail support Microsoft Outlook for Mac? A. Aid4Mail can only process Outlook PST and MSG files on a system running Outlook for Windows. PST files from Outlook 8.x for Mac are not supported as they use a format that is incompatible with Outlook for Windows. Outlook 2001 and 2011 for Mac can read PST files created by Outlook for Windows. So if you have access to a Windows system, you can use Aid4Mail to export your mail to a PST file, and then import the PST file into your Outlook for Mac mail store. Q. Does Aid4Mail support Microsoft Entourage? A. Aid4Mail does not process Microsoft Entourage's native mail database stores, but it does handle the MBOX file format that Entourage supports. If you want to migrate your Entourage mail to a Windows email program, first convert your Entourage mail folders to MBOX files. The simplest way to do this is to drag each folder of messages to the Mac desktop. Entourage will automatically create an MBOX file for each folder you drag-and drop to the desktop. Next, you will have to transfer your MBOX files from Mac to Windows. You can also copy your MBOX files to a CD, DVD, or thumb drive, which Aid4Mail can then access from your Windows computer. Use the "Generic mailboxes" mail source option under the "Generic Mailbox Format" section

Copyright 2005-2013 Fookes Holding Ltd

51

Aid4Mail 3 Help

in Aid4Mail to select your MBOX files and then choose the appropriate target email format when you reach the Target Format screen. To migrate your Windows email messages to Microsoft Entourage, run Aid4Mail on your Windows computer and convert your mail to the "Generic mailboxes" format, which is listed under the "Generic formats" section on the Target Format screen in Aid4Mail. We recommend that you set the "File name" field on the Target Settings screen to "*.MBOX" (without the quotes), and set the "Target Line Format" option to "Macintosh (CR)". You will then have to transfer the mbox files created by Aid4Mail to your Mac system. Then either use the Entourage import command to copy your emails into it (File / Import / Contacts or Messages from a text file / Import messages from an MBOX-format text file), or drag-anddrop the MBOX files to the Entourage folder window. Q. Does Aid4Mail support Eudora for Macintosh (Mac Eudora)? A. Aid4Mail can process and export mail from Mac Eudora mailbox files, but it cannot create Eudora mailbox files. Since Aid4Mail is a Windows application, it will only run on Intel-based Macs that are running Windows or Wine, and on PowerPC Macs using Virtual PC. We recommend that you run Aid4Mail on a Windows system as it will process mail much faster that way. To migrate your Mac Eudora messages to a Windows email program, first transfer your files from Mac to Windows. You can also copy your Mac Eudora mailbox files to a CD, DVD, or thumb drive, which Aid4Mail can then access from your Windows computer. Use the "Mac Eudora" mail source option under the "Eudora" section in Aid4Mail to select your mailbox files and then choose the appropriate target email format when you reach the Target Format screen. Aid4Mail expects to find the mailbox files under the "Mail Folder" folder, attachments in the "Attachments Folder" folder, and embedded contents in the "Parts Folder" folder. All three folders share the same parent folder. If your attachment and embedded contents files are in a different location, see the instructions under the Fixing Attachment Folder References topic.

2
2.1

Reference Information
Program Interface
Aid4Mail is based on a user-friendly wizard interface, which is also designed with accessibility in mind. The wizard helps you adjust program settings step-by-step so that you can process your mail to the desired format and location. The wizard screens are divided into three parts. The top of the program window displays an information area that provides a short explanation about the current screen. The bottom part of the screen includes the navigation buttons (Back, Next) and the status bar. The middle part of the screen contains all the settings instructing Aid4Mail how to handle your mail. Note that grayed controls, menu items, fields, and buttons indicate they are not available for use in the current context.

Aid4Mail Buttons
Software This button gives you access to a drop-down menu with commands to check for software updates, a shortcut to visit the Aid4Mail homepage on the web, a link to the Help topic with information about ordering an Aid4Mail license, a shortcut to the Aid4Mail order page on the web, commands to activate Aid4Mail, and advanced options.
Copyright 2005-2013 Fookes Holding Ltd

Reference Information

52

Back Use this button to move to the previous screen. Next Use this button to move to the next screen. This button may be disabled if your settings are incomplete. Start Click on the Start button to begin processing your mail. Cancel Use this button to quit the Aid4Mail program, or cancel the current operation like mail processing or a file download in the "News and Updates" screen. Help Click to open the Help window.

Wizard Screens
1. Mail Source 2. Source Location 3. MAPI Store 4. Source MAPI Folders 5. Source IMAP Folders 6. Filter Options 7. Target Format 8. Target Settings 9. Target MAPI Folder 10. Target IMAP Folder 11. Export Options 12. Start Processing Mail

2.2

Accessibility Mode
Aid4Mail has been developed with accessibility in mind. All program features are accessible through the keyboard. Furthermore, Aid4Mail detects whether Windows is set to High Contrast mode and whether a screen reader is running. In these situations, Aid4Mail starts up in a special Accessibility Mode that affects the display of menus as well as the selection of the first control receiving input focus when the wizard screen changes or a dialog is opened. The text "Accessibility Mode" appears in the program title bar when it is turned on. Aid4Mail includes configuration files for the three most popular screen readers: Dolphin Hal, JAWS for Windows, and Window-Eyes. These files improve recognition of Aid4Mail user-interface elements and can be installed to the appropriate location by running Aid4Mail with the following command-line parameter:
Aid4Mail.exe /acc=install

Note that you may have to restart your screen reader to have it pick up the installed configuration file. If for some reason, Aid4Mail does not set itself in Accessibility Mode, or if you wish to turn it off, use the /acc command-line switch to turn it on or off. Example:
Aid4Mail.exe /acc=on

Copyright 2005-2013 Fookes Holding Ltd

53

Aid4Mail 3 Help

Aid4Mail.exe /acc=off

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

2.3
2.3.1

Wizard Screens
1. Mail Source
The Mail Source screen lets you choose the type of mail you want to process. The list is subdivided into categories of related formats. You must choose an item from one of the highlighted categories before you can proceed to the next screen. Unless you are using Office Outlook, you should close your mail client if it is connected to the source emails you plan to process. With some mail clients, you have a choice between accessing index files or mailbox files. Whenever possible, always choose the index files. Processing these is usually faster and more information can be extracted from emails, like status details (unread, read, replied, etc.) Furthermore, deleted mail that is no longer listed in the index files is skipped during processing. Use mailbox files if the corresponding index files are corrupted, missing, or if you want to retrieve all mail including deleted messages. See the topic Information About Mail Formats for details about the different formats that Aid4Mail can process. Are you using Eudora OSE? If so, select Mozilla Thunderbird as your source mail. Eudora OSE is basically a skin operating on top of Thunderbird. Set the option "Include mail in trash" if you also want to process mail in the Trash, Junk, and Deleted Items folders. The names of such folders are stored in the files TrashFiles.dat and TrashFolders.dat that you will find in the Aid4Mail program folder. You can add more folder names to these two files if necessary (one name per line). The TrashFolders.dat file is for message folder names created by MAPI clients like Office Outlook. Aid4Mail uses the names stored in TrashFiles.dat to determine which mailbox files from other mail clients contain deleted or unwanted messages. An option labeled "Include unpurged mail" is displayed if you are running Aid4Mail eDiscovery. When available and checked, Aid4Mail will process moved and deleted items found in mailbox files and folders that haven't been compacted or expunged. These email items are not usually visible in your mail client. Note that if you use this option with Outlook Express .dbx files, processed messages all have a certain degree of corruption as the deletion process partially damages the remaining email. By default, Aid4Mail

Copyright 2005-2013 Fookes Holding Ltd

Reference Information

54

skips messages that have been marked as removed from a mailbox. Currently, Aid4Mail cannot extract these type of messages from Microsoft Outlook. Another option that is only available in the eDiscovery edition is "Restore unpurged mail". It is available when the "Include unpurged mail" option is checked. When this feature is used, Aid4Mail removes the Deleted status flag during export from messages that have been marked as deleted (and hidden by the mail client) but not yet removed from the mailbox file. Once a mailbox file has been compacted by the mail client, all hidden deleted messages are definitely lost unless a copy remains in the trash folder. Set the "Search for mail location" option to let Aid4Mail search for the default folder containing your mail. This option is only available for some mail formats. Some mail clients make it very difficult to correctly identify the location of their default mail files, so this feature might not always work properly. When the search fails, you will have to browse through your drives to find the correct location. You can contact us if you need help to find where your mail is stored. If available, use the "Profile name" field to help refine the search for the location of your mail. With Outlook Express, the profile name is equivalent to your identity name. With Mozilla Mail and Thunderbird, storage of profile details is different in older versions and its retrieval may be less reliable. With Foxmail and PMMail, the profile name is treated by Aid4Mail as corresponding to the subfolder name containing your mail. The current version of Aid4Mail cannot extract email status information (unread, read, replied, etc.) from messages stored in Windows Mail, Windows Live Mail, Mac Eudora, Entourage, Opera Mail, Forte Agent, PMMail, FoxMail, Calypso and Courier. Note that working on compacted or expunged mailbox files (unpurged mail has been removed) can improve conversion speed significantly. If you are responsible for migrating mail accounts in your company, you could encourage staff members to compact their mail folders before you start processing their data with Aid4Mail. Please see the General Aid4Mail FAQ topic for more tips on speeding up Aid4Mail.

2.3.2

2. Source Location
This screen is displayed for all mail source types except IMAP and MAPI profiles. Use it to select the mail folders and/or files your want to process. See the topic Finding Mail Folders if you need help to find the location of your mail. For most file types, Aid4Mail only lists files that contain email messages; empty files or files that do not correspond to the selected mail source are not displayed in this screen. For most mail source types you can select one or more folders and files. Hold down the Ctrl key and click on names to select multiple files/folders. Hold down the Shift key to select a range of names, and press Ctrl+A to select all listed names. Aid4Mail can only process one PST (Office Outlook) or ZIP (Aid4Mail archives) file at a time, so if this is your mail source type you can only select one file name before continuing to the next screen. Set the option "Include subfolders" if you want to process all the mail files in and under the current folder. If this setting is unchecked, only the mail files directly under the selected folders will be processed; their subfolders and contents will be ignored. If you select a password-protected PST file, make sure you enter the password in the corresponding field. Otherwise Outlook will prompt you for the password whenever Aid4Mail needs to access its contents (usually once when it displays the folder hierarchy and once just before starting email processing).

Copyright 2005-2013 Fookes Holding Ltd

55

Aid4Mail 3 Help

Navigating folders with the mouse can be quite laborious depending on where your source files are. If you know where to find your files, right click with your mouse in the folder/file list window to open a context menu that gives you access to a folder or file name input dialog box. You can then paste or type a folder or file name. If you do not specify a fully qualified name, Aid4Mail searches the location relative to the current folder. Aid4Mail recognizes "shorthand" tokens used in the path name; see the Useful Tokens and System Variables topic for more details. The following example will select the file Test.pst in the Office Outlook data folder: %Outlook%\Test.pst

TIP: Here's a simple trick to find where any Thunderbird mail folder is stored... Right click with your mouse on a folder name in Thunderbird to open the shortcut menu. In Thunderbird version 3, choose Properties from the menu and then select and copy all the text in the Location field of the Folder Properties dialog box. In Thunderbird version 2, choose the "Copy Folder Location" command from the shortcut menu. When you reach the Source Location screen in Aid4Mail, right click in the folder field and choose the "Go to specific folder" command from the shortcut menu. Aid4Mail will then automatically show the real folder path in the dialog box.

2.3.3

3. MAPI Store
This screen is only displayed if you have chosen the Email Profile (Office Outlook & Microsoft Exchange) Mail Source option. Choose from the drop-down list the mail profile to process. Aid4Mail will display the folders of default store connected to the chosen profile. Office Outlook will prompt you for a profile password if required to access the mail account.

2.3.4

4. Source MAPI Folders


This screen is only displayed if you have selected a PST file or MAPI as your mail source. When Aid4Mail opens your MAPI profile successfully, you will see a hierarchical tree structure with folder names and the number of messages they contain in parentheses. Uncheck the MAPI folders you do not want to process. You can check/uncheck a whole tree branch by holding down the Ctrl key while you click in a checkbox. If you do not see message folders listed in this screen, this could be due to one of the following reasons... 1. 2. You are using the 64-bit version of Outlook 2010 or 2013. Install the 32-bit edition to fix this issue. 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.).

Copyright 2005-2013 Fookes Holding Ltd

Reference Information

56

Note that Aid4Mail requires a fully functioning Extended MAPI system in order to access MAPI folders. Extended MAPI is not available if you have Microsoft Outlook 2010 installed through the Click-to-Run method or Outlook 98/2000 installed in the Internet Only Mode (IMO). Outlook mail stores may also contain items that are not email messages, like appointments, contacts, and tasks. You can instruct Aid4Mail to skip those items by setting the "Process only email messages" option.

2.3.5

5. Source IMAP Folders


This screen is only displayed if you have selected IMAP as your mail source. When Aid4Mail opens your IMAP account successfully, you will see a hierarchical tree structure with folder names and the number of messages they contain in parentheses. The message count includes deleted emails that haven't been expunged (these are skipped unless you have an eDiscovery edition that is set to process deleted mail). Uncheck the mail folders you do not want to process. You can check/uncheck a whole tree branch by holding down the Ctrl key while you click in a checkbox. Processing mail from an IMAP server is considerably slower that processing mail on a local disk drive. If you have a large volume of mail to download, make sure your connection to the internet is as good as can be (avoid Wi-Fi unless you have a constant strong signal) and choose a time of the day when there is less internet traffic. Note that Aid4Mail uses the backslash character (\) as a folder name delimiter. As a result, it cannot handle an IMAP folder name that contains a backslash character. In most cases, IMAP servers don't allow the creation of such folder names so this issue is very rarely encountered. If you do have a folder name with a backslash character, please rename it temporarily prior to exporting it with Aid4Mail. Beware! Gmail enforces daily bandwidth limits. As of this writing, you can download up to 2,500 MB of email per day. See the IMAP Settings topic for more details.

2.3.6

6. Filter Options
Note that this screen is not available in the Aid4Mail Home edition.

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

57

Aid4Mail 3 Help

then save all the messages from that period in a ZIP archive and do this at regular intervals, whether it be once a day, once a week, once a month, once a year, etc. In the following example, Aid4Mail will only process emails that were received during year 2004: Ignore if older than: Ignore if newer than: Date to check: 2004/01/01 2004/12/31 Mail Received

In the following example, Aid4Mail will only process emails that were received after year 2004: Ignore if older than: Ignore if newer than: Date to check: 2005/01/01 <blank> Mail Received

In the following example, Aid4Mail will only process emails that were sent before year 2004: Ignore if older than: Ignore if newer than: Date to check: <blank> 2003/12/31 Mail Sent

Filter Mail by Content You can define a list of words that Aid4Mail will search for in each message header, 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 should contain one search criteria per line. The longer the list, the longer it will take Aid4Mail to filter each email. You can improve performance by placing the most common search terms at the beginning of the list. Leave the list blank if you do not want to filter by content. Matching is case sensitive for lines that have one or more uppercase characters, and case insensitive for lowercase search criteria. A match only occurs if the search criteria covers whole words. For example, if your search criteria is "spam" (without the quotes), it will match the word "SPAM", but not "spammer". The search criteria "FREE" will only match the word "FREE", but not "free" or "FREEWAY". The search criteria "jane doe" will match "Jane Doe" and "JANE DOE", but not "Jane M. Doe". Aid4Mail currently does not support filtering using Unicode search text. When searching Unicode messages, Aid4Mail first converts the message body text to the current ANSI character set. Unicode characters that do not have an ANSI equivalent character are substituted with a "?" character. You can negate the effect of a text criteria by starting it with a minus character (-). If you must start a regular search criteria with a minus or hyphen character, just add a second one to cancel the negate effect. A match with a negate criteria will reject a message if the "found in header" option is set, and will accept the message if the "not found in header" option is set. You can start a text criteria with a plus character (+) to instruct Aid4Mail to combine it with the previous criteria. If you must start a regular search criteria with a plus character, just add a second one to cancel the addition effect. If the "found in header" option is set, the message is only accepted if it contains occurrences of the preceding and current criteria. If the "not found in header" option is set, the message is only rejected if it contains occurrences of both the preceding and current criteria. Note that the plus character is ignored if it follows a negate criteria. See example #3 below.

Copyright 2005-2013 Fookes Holding Ltd

Reference Information

58

Message headers usually contain the email date, subject, sender name and address, recipient names and addresses, server relay path (or travel history), and sometimes organization name and mailer name. Typically, you will create search criteria with email addresses and/or keywords that may appear regularly in a message subject. The "Manage Words List" button gives you access to a drop-down menu with commands to open a Words List, save a Words List under a new name, and clear the list. Aid4Mail automatically saves modified Words Lists. If no name has been assigned, it saves the list in a file called "WordsList.txt" under the "Application Data\Aid4Mail" folder. You can combine a Mail by Content filter with a Mail by Date filter to refine your selection of messages. Matching Words with Wildcards Aid4Mail also supports wildcards and regular expressions in the word list feature. The regular expression engine is based on PCRE 8.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 starts with "N=" or "R=" (without the quotes). The following wildcards are supported: * matches 0 or more word characters. Example: "jo*" matches "Jo", "John", "Jody", "joint", "join_leave". # matches 0 or more word characters, including HTML entity characters. Example: "na#" matches "nave", "na&iuml;ve", and "na&#239;ve". ** matches 0 or more characters and can span across words within a line. Example: "click**link" matches "click link", "click on link", "clicking on link", "Click on this link", but not "click on links". ? matches exactly one word character. Example: "jo?" matches "Job" and "jot", but not "Jo", "John", "Jody", and "joint". ~ matches 0 or one word characters. Example: "jo~" matches "Jo", "Job", and "jot", but not "John", "Jody", and "joint". & matches exactly one word character or one HTML entity. Example: "caf&" matches "caf", "caf&eacute;", and "caf&#233;". Note that word characters include alphanumeric characters, all extended ANSI characters, as well as "_".

You can set or override the type of search performed by starting a line with a token character followed by an equal sign. The following are recognized: N= W= R= produces a normal search produces a wildcard search produces a regular-expression search

Copyright 2005-2013 Fookes Holding Ltd

59

Aid4Mail 3 Help

Words list example #1: -spam@fookes.com @fookes.com Assuming the "found in header" option is set, Aid4Mail will accept all messages that have an "@fookes. com" address except those that have the address "spam@fookes.com". Other messages that do not have "@fookes.com" in the header are rejected. The order of the text search criteria is important here. If "@fookes.com" is placed before "-spam@fookes.com", then the negate criteria never gets tested because the message is already accepted because "@fookes.com" is found. Words list example #2: FREE mortgage~ home owner~ pharma* pill~ prescr?pt??n~ spam@fookes.com @adpromailer.com @emailfactory R=free (bonus|debt|loan|money) R=c(i|1)(a|@)l(i|1)s R=v(i|1)(a|@)gr(a|@) R=x(a|@)n(a|@)x Assuming the "not found in header" option is set, Aid4Mail will reject all messages that have any of the listed search criteria in the header. The above list includes criteria with wildcards and regular expression patterns. Words list example #3: important@fookes.com +aid4mail important@fookes.com +mailbag assistant Assuming the "found in header" option is set, Aid4Mail will only accept messages that were sent to the <important@fookes.com> address and mention either the aid4mail or mailbag assistant products in the Subject line.

Filter Scripts For the ultimate control over email filtering, you can create Filter Scripts that can access any part of the email message being processed. For example, you could create a script to identify duplicates using a different method from Aid4Mail's deduplicating feature. Or filter messages based on the presence of specific header field values for example all incoming messages marked as urgent and that contain inserted images. Filter scripts are files with the .s4f extension. Any such file placed in the Scripts subfolder of the Aid4Mail program or AppData folder will be listed in the Filter Scripts window. If the "Filter source messages" option is unchecked or if you haven't selected a filter, no filter script will be used when processing your source emails. To use a script for email filtering, simply click on its name to select it.
Copyright 2005-2013 Fookes Holding Ltd

Reference Information

60

You can unselect a script by holding down the Ctrl key and clicking on its name. A right-click on a script name opens a shortcut menu with commands to unselect, create, edit, delete, and display information about the script (if such data is available in the file). Another way to delete a script is to first select it and then hit the Delete key. Aid4Mail includes several sample Filter scripts that you can experiment with and use as the basis for a new script.

2.3.7

7. Target Format
This screen lets you choose what to do with your selected mail source. The following options are available... 1. 2. 3. 4. 5. 6. 7. 8. Office Outlook & Microsoft Exchange Other mail clients Export email to remote server Generic mail formats (Outlook Express) Extract message contents only MHT Web Archive files Mail archives Custom formats using scripts

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 available if 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 default store connected to the chosen profile. Starting with Outlook 2003, you can store up to 20 GB of data into a MAPI store if your profile is connected to a Unicode PST file (up to 50 GB with Outlook 2010 and 2013). But with older versions of Microsoft Outlook you cannot exceed 2 GB of data. Aid4Mail cannot detect when the size limit is reached so you need to ensure that your mail files are well within the limits. If necessary, you can break down large exports into smaller units by using the Aid4Mail filter feature. 2. Office Outlook PST file Aid4Mail can create a new PST file and import your selected source mail into it or open an existing PST file and append mail. When Aid4Mail has finished processing, you can open your PST file through the File/Open/Outlook Data File menu command in Microsoft Outlook. With Outlook 2003 and 2007 you can store up to 20 GB of data into a MAPI store (Unicode format), and up to 50 GB with Outlook 2010 and 2013. But with older versions of Microsoft Outlook you cannot exceed 2 GB. The size limit may be set smaller through registry settings (see this Microsoft Knowledge Base). If the PST file size limit is exceeded during import, Aid4Mail returns an error message informing the MAPI store is full. Note that if the target PST file exists and is open in Outlook while you are running Aid4Mail, then email is added to the existing file instead of a new copy of the PST file when the "Append messages to target mailbox file" option is unchecked. 3. Office Outlook MSG files Use the MSG format if you prefer to save your messages in individual files. MSG files are displayed in an Microsoft Outlook window when you double-click on the file name in Windows Explorer or another file manager. Note that MSG files use a proprietary format and can only be opened in Microsoft Outlook.

Copyright 2005-2013 Fookes Holding Ltd

61

Aid4Mail 3 Help

Issues with dates and contact names in the Folder Pane By default, Microsoft Outlook displays the Sent date and the contact name from the To field for messages in the Sent Items folder, and the server Received date and the contact name from the From field for messages in other folders. As a result, you may see unexpected dates and names in the Folder Pane for imported "outgoing emails" that are not saved in the Sent Items folder. To correct this display issue, simply move those outgoing emails to the Sent Items folder. The quickest way to do this is press the Ctrl+A keyboard shortcut to select all the messages in a folder, then use the Ctrl+Shift+V keyboard shortcut to open the Move to Folder dialog box, and then select the Sent Items folder in the list. 2.3.7.2 Other mail clients A generic mailbox is a file that contains email messages that are stored in a non-proprietary format. The file format complies with the mbox standard, which most mail clients can read or import. 1. Mozilla-compatible mailboxes (Thunderbird, SeaMonkey Mail, Mozilla Mail, and Eudora OSE) Use this format if you want to import your mail into one of the Mozilla mail clients: Thunderbird, SeaMonkey Mail, Mozilla Mail, and Eudora OSE. The Mozilla format is very similar to the mbox format. The main difference is in the way status information (unread, read, replied, etc.) is stored in the message header. Mozilla defines its own system for managing status details and stores them in fields that are different from standard mbox files. You should avoid appending your source mail to mailboxes that are in use. Instead save it under a new subfolder or in a new mailbox file. If you save the target files in the active mail folders of Thunderbird, SeaMonkey Mail, Mozilla Mail, and Eudora OSE, you must restart the mail client to see them listed in the Folder window.

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

3. Windows Live Mail Before exporting messages to Windows Live Mail (WLM) with Aid4Mail, make sure you have configured it with at least one mail account so that the appropriate target folder is created. You must export your source mail under the "Storage Folders" location. Aid4Mail automatically suggests the appropriate default mail folder, if it exists. If you type a new subfolder, Aid4Mail will automatically create it before exporting your messages. Open WLM once Aid4Mail has completed the transfer. WLM will start indexing your new folders and messages; during this time the "Unread email" count increases progressively. Make sure you give it enough time to complete the task. Sometimes new folders do not appear immediately under "Storage Folders"; this display issue is usually fixed by restarting WLM.
Copyright 2005-2013 Fookes Holding Ltd

Reference Information

62

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

4. Windows Mail Before exporting messages to Windows Mail (WM) with Aid4Mail, make sure you have configured it with at least one mail account so that the appropriate target folder is created. You must export your source mail under the "Local Folders" location. Aid4Mail automatically suggests the appropriate default mail folder, if it exists. If you type a new subfolder, Aid4Mail will automatically create it before exporting your messages. Open WM once Aid4Mail has completed the transfer. WM will start indexing your new folders and messages. Make sure you give it enough time to complete the task. Sometimes new folders do not appear immediately under "Local Folders"; this display issue is usually fixed by restarting WM. Note that the current version of Aid4Mail cannot change email status information (unread, read, replied, etc.) on messages exported to WM. As a result, all these messages are listed as unread. 2.3.7.3 Export email to remote server Aid4Mail can download and upload email from and to a remote mail server using the IMAP protocol. Works with popular services like Yahoo! Mail, Gmail, Zoho Mail, FastMail, and GMX Mail. See the IMAP Settings topic for details. 2.3.7.4 Generic mail formats An EML file contains a single email message stored in a non-proprietary format that conforms to the RFC-2822 text format. Many email programs can handle and display EML files, including Mozilla Thunderbird, Windows Live Mail, and Outlook Express. A generic mailbox is a file that contains one or more email messages stored sequentially in a nonproprietary format which complies with the mbox standard. Aid4Mail creates mbox files that conform to the mboxrd format. Many email programs can import messages from mbox files. You should avoid appending your source mail to mailboxes that are in use. Instead save it under a new subfolder or in a new mailbox file.
2.3.7.4.1 Outlook Express

Use the EML format to save your messages in individual files. Depending on your system setup, EML files can be displayed in an Outlook Express window when you double-click on the file name in Windows Explorer or another file manager. Aid4Mail sets the file date stamp according to the message date based on your local time (unless you use the /TimeZone command-line switch). This way you can easily sort your messages by date in your file manager. Note that the Windows File Indexing feature may cause the date stamp of your target EML and MSG files to be changed to the current date. To avoid this issue, go to Control Panel -> Indexing Options -> Advanced -> File Types, and uncheck the extensions "eml" and "msg" from the list. EML files can easily be imported into Outlook Express with Windows Explorer. Simply select the EML files in Windows Explorer (the Ctrl+A shortcut selects all the files in your current folder) and then drag them into the Outlook Express application window and drop them into the mail folder of your choice.

Copyright 2005-2013 Fookes Holding Ltd

63

Aid4Mail 3 Help

2.3.7.5

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

2.3.7.6

MHT Web Archive files This section offers formats that enable you to display messages without using an mail client. This feature is invaluable if you need an easy way to share important mail with customers or to display messages to an audience. Note that this format is not available in Aid4Mail Home. Email messages are stored in MHT files that can be viewed in Internet Explorer or any other compatible web browser. In most cases, messages are rendered the same way as in a mail client. However certain special types of emails, like digests and partial messages, may not display any contents at all in Internet Explorer. Embedded contents like pictures and sounds are displayed too and you can click on attachment names to extract them from the message and save them to disk. Aid4Mail sets the file date stamp of MHT files according to the email date based on your local time (unless you use the /TimeZone command-line switch). This way you can easily sort your messages by date in your file manager.
Copyright 2005-2013 Fookes Holding Ltd

Reference Information

64

Note that there is an issue that affects message attachments, which is due to a bug in Internet Explorer. When you click on an attachment link to save the file to disk, Internet Explorer displays an incorrect file name in the Save As dialog box. It's best to replace it with a meaningful name and especially to add the appropriate file extension for it. (Use the same extension displayed in the real attachment name.) You may get a security warning that tells you Internet Explorer has restricted the MHT file from showing active content. If you know your mail is safe, right click on the warning bar and select "Allow Blocked Content" from the popup menu.

1. MHT message files for viewing from Web browser When you select this format, Aid4Mail saves your messages into MHT files and creates an index file in HTML format for viewing in your web browser. After processing, you can burn the contents of the target folder onto a CD-ROM. Next time you insert your CD-ROM into a computer drive, Internet Explorer will start up automatically and display the index file for your saved mail. The format of the index page is based on templates (*.html, *.css) that are stored in the Template subfolder under the Aid4Mail program folder. If you are familiar with HTML code, you can edit these templates to modify the default layout. 2. MHT message files for viewing from Office Excel Use this option to create an index file for viewing in Excel 2002, 2003, 2007, 2010, and 2013. Each message folder or mail file is placed on a separate worksheet tab. Excel does impose some limits that you may need to take into account before you select your mail source. Each worksheet can only store a maximum of 65,536 emails and its name cannot exceed 31 characters. The format of the index page is based on templates (*.xls) that are stored in the Template subfolder under the Aid4Mail program folder. If you are familiar with XML code, you can edit these templates to modify the default layout. Note that there is a bug in Internet Explorer 8 that causes failure to display linked email messages if there is a space in the file path. If you experience this issue, simply copy your exported folder to a location that has no blank characters in the path name. 3. MHT message files for importing into a database Select this format to export your mail details into a tab-delimited file, which most database programs can read. Mail details that are saved into this file include the mailbox name, message date, priority, status, size, sender address, subject, recipient addresses, attachment names, and a link to the corresponding MHT message file. The format of the tab-delimited file is based on the database.tab template that is stored in the Template subfolder under the Aid4Mail program folder. If necessary, you can edit this template in a text editor to modify the choice of fields and their sequential order. The first line in the template represents the field names. 2.3.7.7 Mail archives Aid4Mail can save your mail in highly compressed ZIP archives that you can open with Windows Explorer under Windows XP or more recent, or with any of the popular ZIP utilities like WinZip and PkZip. See the topic Advantages of Aid4Mail Archives for more details about this unique feature. The Aid4Mail Professional and eDiscovery editions offer the option to export your email in PDF format, which makes it easy to view and share your important messages without a mail client. Mail text stored in these PDF files is searchable in Adobe Reader. Email attachments are embedded in the resulting PDF file and can be opened or saved to disk by right-clicking on the icon next to the file name. Furthermore, the Aid4Mail eDiscovery edition gives you the choice to create PDF/A-1a (Level A Conformance) files for long-term archiving or to encrypt and password-protect your PDF files. Another useful option only available in the eDiscovery edition lets you choose whether to embed the original email header or full email in RFC format with each message in the PDF file.
Copyright 2005-2013 Fookes Holding Ltd

65

Aid4Mail 3 Help

PDF files are not designed to store huge amounts of data. You should avoid exporting too many messages into a single PDF file. In our tests, we managed to create PDF files with just under 10,000 emails (the limit may vary depending on the type of emails converted). Use the Aid4Mail filtering features to export just the subset of emails you need. Note that in some cases, complex HTML mail (typically advertisements and some newsletters) exported to PDF are not rendered correctly. If graphic elements are stored on the web, Aid4Mail will try to download them and integrate them into the converted email unless you set the "External links" option to "No downloading". Of course, this kind of processing will fail if Aid4Mail cannot connect to the internet and corresponding messages will be rendered in the PDF file without the graphics. 2.3.7.8 Custom formats using scripts For the ultimate control over email export and data extraction, you can create Output Scripts that can access any part of the email message being processed. For example, you could create a script that generates statistics on information contained in the source emails. Or produce custom export formats like the XML and CSV scripts included with Aid4Mail. Output scripts are files with the .s4o extension. Any such file placed in the Scripts subfolder of the Aid4Mail program or AppData folder will be listed under the "Custom formats using scripts" section on the Target Format screen. A right-click on a script name opens a shortcut menu with commands to create, edit, delete, and display information about the script (if such data is available in the file). Another way to delete a script is to first select it and then hit the Delete key. Aid4Mail includes several sample Output scripts that you can experiment with and use as the basis for a new script.

2.3.8

8. Target Settings
Target Location Choose the disk folder that is to receive the exported mail and/or message contents. Click on the button with the three dots [], or hit the F4 keyboard shortcut while in the field, to browse through your drives for the folder name. On some Windows systems, you may need to use "Tools | Folder Options | View" in Windows Explorer and select "Show hidden files and folders". See the topic Finding Mail Folders if you need help to find the location of your target mail (usually the appropriate target folder is only available if you have already set up a mail account in your target mail client). Note that if you add new folder names in this field, Aid4Mail will automatically create them before saving the target file(s) into them. The Folder field supports "shorthand" tokens; see the Useful Tokens and System Variables topic for more details. Example:
%MyDocs%\email\

Note for keyboard users: in the Target Folder dialog box, you can use the Ctrl+Ins keyboard shortcut to create a new subfolder and Ctrl+Del to delete the selected folder. If you are exporting messages using the EML target format, you can choose to leave the "File name" field blank or specify a file extension. If the field is left blank, the .eml extension is added by default. If you want to use a different extension, use an asterisk wildcard followed by the extension you wish to have (e.g. "*.txt"). In both cases, the file name is determined by the message subject line. If the source messages are stored in EML, MSG, and MHT files, then you can use the {filename} token to create EML target file names that are based on the source file names instead of the subject line. If you also want to control the target extension of exported EML files, just add it after the token (e.g.

Copyright 2005-2013 Fookes Holding Ltd

Reference Information

66

"{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 currently cannot create Unicode file names. If a subject line or source file name used for creating the target file name has Unicode characters, Aid4Mail will try to convert them to their equivalent ANSI character, if available, or substitute them with compatible characters before saving the email file to disk. You cannot specify a file name if you have chosen MHT files or message contents as your target format. With PST and ZIP as your output formats, you are required to enter a file name before you can proceed to the next screen. With other target formats, you can choose to either leave this field blank or specify a file name. If you leave this field blank, the target file name will be based on the source file name, or folder name if messages are stored in individual files. If you specify a file name and the export option "Restore source folder structure" is unchecked, then all source files are exported into the single target file. We recommend you leave the file name field blank when processing multiple mail folders, unless you want to merge them all into a single file. If you have the Aid4Mail Home edition and want to export mail to your default Outlook profile, select the Outlook.pst file name under the folder "<Application Data>\Microsoft\Outlook\" or in some cases with Outlook 2010 and 2013 under "<Documents>\Outlook Files\". Make sure you tick the "Append messages to target mailbox file" box on the Export Options screen. Exporting to Thunderbird, SeaMonkey, Mozilla, PocoMail, Barca: If you want exported mail to appear in your mail client, it is important that you have an existing mail profile and that you select the appropriate folder for the Target Location. Normally, Aid4Mail will suggest the appropriate location if it finds your default profile. If it doesn't, read through the Finding Mail Folders topic to determine the correct location. With Thunderbird, the folder usually looks something like this:
<Application Data>\Thunderbird\Profiles\default\<code>.slt\Mail\Local Folders

In most cases, you'll want to leave the "File name" field blank. This is especially important if you want the exported mail folder names to be the same as those in your source mail. Finally, before exporting your messages, make sure your mail client is closed. Once the operation is finished and you reopen your mail client, you should see your newly exported messages. To reset the value of this field to the default folder location for the current target format, simply clear the field and double click in it with your mouse. Aid4Mail will then try to determine the appropriate target folder for you and enter the value. Target Line Format This option is available when you export your email to EML or generic mailbox formats. Only use it if you plan to transfer your converted files to a non-Windows operating system. Aid4Mail will adjust the format of line endings of exported emails to suit the selected operating system. Outlook Personal Storage This section is only displayed if you have chosen the PST output format. You can specify a Display Name used when creating a new PST file and the name of the base folder that will be receiving the exported mail. The Display Name must contain a value; it is shown in the Outlook Folder List when you open the new PST file. The Base Folder value can either be a default Outlook folder name like Inbox or Sent Items, or any other name you choose. You can also specify a sequence of subfolder names by separating each name with a backslash. Example:
Inbox\Imported Mail\August 2012

Copyright 2005-2013 Fookes Holding Ltd

67

Aid4Mail 3 Help

Use the password field to create a new encrypted PST file or to add mail to an existing passwordprotected PST file. When you create a password-protected ANSI PST file with Aid4Mail, the high encryption format is used if the password exceeds 8 characters and the weaker compressible-encryption format is used with shorter passwords. With Unicode PST files, the default compressible-encryption format is used (high encryption is not supported.) If you think your export will exceed the capacity of a single PST file, you can set a threshold value in the "Limit file size" field. Setting the value to zero or leaving the field blank instructs Aid4Mail to not monitor the PST file size. Otherwise, Aid4Mail treats values equal to or below 500 as representing gigabytes (GB) and values above as megabytes (MB). When the size limit is reached, Aid4Mail stops exporting mail to the current PST file, creates a new PST file based on the name of the first one but with an index number, and then continues the mail export to the new PST file. For example, if you set the size limit to 2 GB for a file called Outlook.pst and have 5 GB of mail to export, Aid4Mail will create the following files on completion: Outlook.pst Outlook[001].pst Outlook[002].pst Note that Aid4Mail cannot determine exactly when the limit is reached because Outlook uses a data cache. In other words, Outlook will still send data to the PST file after Aid4Mail has measured the file size and stopped exporting mail to it. As a result, a PST file may slightly exceed the size limit you set. To avoid problems, choose a smaller size that ensures your PST file will never get too big. The "Create Unicode PST" setting is only used if you have Outlook 2003 or newer. When you check this setting, Aid4Mail will create a PST file that has a storage capacity of up to 20 GB in Outlook 2003 and 2007, and 50 GB in Outlook 2010 and 2013. The main drawback with Unicode PST files is that they are not compatible with Microsoft Outlook 97, 98, 2000, and 2002. If you uncheck this option, Aid4Mail will create an ANSI PST file that is compatible with all versions of Microsoft Outlook but has a storage capacity limited to 2 GB. Note that the PST size limit may be set smaller through registry settings (see this Microsoft Knowledge Base). PDF Settings These options are displayed if you select Adobe PDF file as your target format. Several categories of settings are available through the tabs below the option fields (two in Aid4Mail Professional and three in eDiscovery). You must define a target file name if you choose to export all your emails into one PDF document; you can leave the "File name" field blank for the other options. You can choose whether all messages are saved into a single PDF file, or one PDF per folder, or one PDF per email. Other options let you set the page size and orientation, the default display mode when the PDF file is opened, the level of compression (fastest means lowest compression but fastest PDF creation and opening), and whether to embed fonts in the file or not. For the smallest PDF files, set compression to "maximum" and Fonts to "No font embedding". Some email messages rely on external images for their presentation. Aid4Mail can download such contents and include them in the target PDF file. This feature, however, only works if Aid4Mail has access to the internet. If you are working in a restricted environment or if processing speed is more important to you than including external images, simply set the "External links" field to "No downloading". The "Document Information" tab gives you access to fields where you can enter the author name, document title and subject, and keywords. Note that in some cases, complex HTML mail (typically advertisements and some newsletters) exported to PDF are not rendered correctly. If graphic elements are stored on the web, Aid4Mail will try to
Copyright 2005-2013 Fookes Holding Ltd

Reference Information

68

download them and integrate them into the converted email unless you set the "External links" option to "No downloading". Of course, this kind of processing will fail if Aid4Mail cannot connect to the internet and corresponding messages will be rendered in the PDF file without the graphics. If you have the eDiscovery edition, use the Advanced tab to access options for creating PDF files that are encrypted and password protected or PDF/A archival files. Note that you cannot create encrypted PDF/A files. To preserve your original source data within the target PDF file, Aid4Mail gives you the option to store either the original message header or the whole email as embedded data in regular PDF files (not PDF/A). A right-click on the corresponding icon in the PDF file gives you access to the save to disk command. You also have the option to print in the PDF file the hash signature (MD5 or SHA1) of each processed email. Unfortunately the PDF/A format does not allow embedding files in it in such a way that they can be saved to disk by end users afterwards. As a result, email attachments and source mail files (headers or whole emails) are exported in corresponding subfolders of the target PDF folder instead of being embedded in the PDF/A file.

2.3.9

9. Target MAPI Folder


Select the MAPI folder that should receive the exported mail. If you do not see folder names listed in this screen, this could be due to one of the following reasons... 1. 2. You are using the 64-bit version of Outlook 2010 or 2013. Install the 32-bit edition to fix this issue. You have an Outlook 2010 Click-to-Run installation. Re-install without the Click-to-Run method if available. 3. You are trying to access a Unicode PST file with a MAPI system that does not support the new format. 4. You are trying to access a mail store that is write protected or has limited access rights. 5. You have Outlook 98/2000 installed in Internet Mail Only Mode (IMO). Re-install in Corporate/ WorkGroup mode. 6. The MAPI profile details you provided were incorrect. 7. You have installed Outlook but have not yet configured a default mail account. 8. Your mail is on a remote computer that is not accessible. 9. The mail file is empty. 10. A third-party utility is interfering with Aid4Mail (synchronization software, backup, anti-virus, etc.). Note that Aid4Mail requires a fully functioning Extended MAPI system in order to access MAPI folders. Extended MAPI is usually not available if you have Microsoft Outlook 98/2000 installed in the Internet Only Mode (IMO). Create and save under following subfolder Enter a name in this field if you want the imported mail stored in a new folder under the selected target MAPI folder. You can also specify a sequence of subfolder names by separating each name with a backslash. Example:
Imported Mail\August 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 not able to connect to the remote mail server using the IMAP protocol. See the IMAP Settings topic for more details.
Copyright 2005-2013 Fookes Holding Ltd

69

Aid4Mail 3 Help

Processing mail from an IMAP server is considerably slower that processing mail on a local disk drive, and uploading usually is slower than downloading. If you have a large volume of mail to upload, make sure your connection to the internet is as good as can be (avoid Wi-Fi unless you have a constant strong signal) and choose a time of the day when there is less internet traffic. Beware! Gmail enforces daily bandwidth limits. As of this writing, you can upload up to 500 MB of email per day.

2.3.11 11. Export Options


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

Standard Export Options


1. Export Format 1.1 Preserve full message Select this option to export the complete email message, including its attachments and embedded contents. 1.2 Only keep rich content (attachments are removed) Use this option if you do not want to keep attachments in the target format. Embedded contents like pictures are preserved. This option is useful if you want to reduce the size of your target files. 1.3 Only keep plain text message Select this option to discard all attachments, embedded contents, and rich text formatting. Only plain text is preserved. Email headers are also simplified to preserve only the most important fields (like subject, date, sender, and recipients). Aid4Mail takes care of converting HTML messages into plain text so that no important information is lost. This option can significantly reduce the size of your target files. Use the "Convert UTF-8 to ANSI" setting to define how messages based on the UTF-8 character set should be processed. When the box is checked, UTF-8 characters are converted to plain ANSI characters based on the default Windows character set. When unchecked, UTF-8 characters are preserved as-is. In most cases, messages will be easier to read when UTF-8 is converted to ANSI. However, characters that do not exist in the default character set are converted to a question mark (?). If messages become unreadable because of this, then you should leave this option unchecked. 2. Export Options 2.1 Restore source folder structure When this option is set, Aid4Mail attempts to restore the original folder structure in the target format. When you export MAPI folders, Aid4Mail creates corresponding disk folders that contain the messages and subfolders matching the original structure. If this option is unchecked, all messages are saved under a single folder. 2.2 Detach attachments and inserted files from email messages If your selected target corresponds to a generic mailbox format or EML files, you can save the messages with all contents (file attachments, embedded pictures, etc.) extracted and saved in a separate folder. Aid4Mail saves the modified messages using the MIME External-Body Access-Type format defined in RFC 1521. Using this setting has several advantages: a) attachments and embedded

Copyright 2005-2013 Fookes Holding Ltd

Reference Information

70

contents are easy to find and open with Windows Explorer or any other file manager; b) duplicate files are automatically removed; c) the total size of exported files can be significantly smaller than the source file(s). The main disadvantage with this format is that most mail clients do not handle it correctly and may not be able to render the extracted files. However, you can always use Aid4Mail to pull detached file contents back into the messages if necessary. 2.3 Append messages to target mailbox file If your selected target corresponds to a PST file or a generic mailbox format, you can add messages to an existing file if this option is set. If the "Do not add duplicate messages" option is set, only new messages are appended to the target file. If this option is unchecked, Aid4Mail will first make a backup copy of the target file if it already exists and then replace the contents with messages from the mail source. 2.4 Do not add duplicate messages When available, set this option to block adding duplicate messages. By default, Aid4Mail skips duplicates based on the target mail folder. But you can increase the scope to all folders by setting the "Check for Duplicates Across Folders" option under Advanced Options. Checking for duplicates with this option usually decreases processing speed and uses more system memory, though the impact is usually minimal. You can also use this option to process mail incrementally. See the "Log for Incremental Processing" option under Advanced Options for more details. Aid4Mail checks for duplicates by comparing the value of the Message-ID field in each processed email header. If this field is empty or missing (usually in outbound messages), Aid4Mail uses other header data for the comparison. In MAPI messages (from Office Outlook and Microsoft Exchange), Aid4Mail uses the email creation and submit dates, subject line, and stored message size. In other types of messages, Aid4Mail uses the email date and subject line for the comparison, or other header fields (To, Cc, Bcc, From delimiter) if either of those values are missing, or the whole header if none of those fields contain any data. 2.5 Use unique MD5 file names When you save messages to individual MSG, EML, or MHT files, you can choose to have their file name based on the message subject line or based on a unique (and usually shorter) MD5 signature. If you plan to save your message files to a CD-ROM, it is recommended that you set this option. This ensures you won't encounter problems with file names that are too long. The following example is an MD5 file name: 6a4b080de66b2dafb4f6bceb4916aaf4.eml With Outlook MSG files, the MD5 signature is based on the unique Message-ID field, which is normally present in the header of all received email messages. If this field is empty or missing (usually in outbound messages), Aid4Mail uses the email creation and submit dates, subject line, and stored message size. With EML and MHT files the method used for creating the MD5 signature depends on the "Header-based MD5 File Names" option under Advanced Options. Note that when the the "Header-based MD5 File Names" option is turned off, a single different character in an EML or MHT message file will result in a completely different MD5 file name. Only two messages that are 100% identical will produce an identical MD5 file name. Unfortunately, when exporting messages from Outlook 2003 and more recent, most messages (those with a MIME format) will not produce the same MD5 file name each time you rerun the conversion with Aid4Mail. The reason is that Outlook uses a random element to create boundary markers between message parts. You can work around this problem by unchecking the Use MAPI RFC 1521 Converter option or using the / MapiConvOff command-line switch.

Copyright 2005-2013 Fookes Holding Ltd

71

Aid4Mail 3 Help

Address Export Options


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

2.3.12 12. Start Processing Mail


This screen shows you the main processing settings you have selected. In most cases, you will have to close your mail client before clicking on the Start button (this is not necessary with Office Outlook though). Once you click on the Start button, Aid4Mail starts reading your source mail and processes it to the output format. The main window is updated as each item is processed. If the Launch box is checked and at least one mail was processed, Aid4Mail will open Windows Explorer, Internet Explorer, or MS Excel to show the newly created output files. If you want to start alternative applications, you will have to edit the Aid4Mail.ini file which is saved under the Applications Data folder. The path of the Aid4Mail.ini is usually similar to the following (change {User} with the appropriate user name):
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 under the [LaunchApp] section in the INI file. Use the WebBrowser key to launch a different browser from Internet Explorer. Use the FileManager key to launch a different file manager from Windows Explorer. Use the XlsViewer key to launch a different spreadsheet application from MS Excel. The application name can be followed by command-line switches. Use the "%s" token to tell Aid4Mail where it must insert the name of the target folder or file. Example:
[LaunchApp] WebBrowser=NetCaptor.exe -nohome %s FileManager=Explorer.exe /e,%s XlsViewer=Excel.exe %s

If you are going to process large amounts of emails, you can improve speed and reduce memory usage by setting the "Skip filter details in log" checkbox. When set, this option tells the log screen to not show information about which messages are skipped as a result of the Aid4Mail filter settings. Go to the Skipped Messages topic for a detailed explanation on the type of emails that Aid4Mail may have skipped during processing.

Copyright 2005-2013 Fookes Holding Ltd

Reference Information

72

2.3.12.1 Skipped Messages Once your messages have been processed, Aid4Mail displays information about the number of emails it has analyzed and processed. Depending on your settings, Aid4Mail may skip certain kinds of emails. Skipped messages are either duplicates, unpurged or invisible emails, messages not matching your filter settings, non-email items, empty emails (no header and body), or emails that were not processed or saved due to errors. Duplicates are skipped if you set the "Do not add duplicate messages" checkbox on the Export Options screen or when Aid4Mail encounters empty emails (no header and body). Blank messages are emails that have no data (no header and body). These rarely occur but may exist on IMAP servers with index errors. Outlook Express files may also include links to remote emails that have not been downloaded and therefore have no local contents to show. Unpurged messages are emails you cannot see in your mail client but that are stored in your mailbox files. They are the original copies of emails that have been deleted or moved from the mail folder. These type of messages disappear when you compact or expunge your mail folders. Note that Aid4Mail cannot see unpurged messages in Microsoft Outlook because Extended MAPI doesn't provide methods to find them. Unpurged emails can be extracted with the eDiscovery edition of Aid4Mail by setting the "Include unpurged mail" checkbox on the Mail Source screen. Filtered messages are typically emails that did not match your filter settings on the Filter Options screen. If your source mail is from a MAPI store (Office Outlook, PST) and the "Process only email messages" option is checked, non-email items such as Calendar, Contacts, and Tasks, are skipped and added to the Filtered count. Errors that cause a failure to process or save a message are counted under this item. Such errors typically occur when you process a corrupted file, or malformed messages, or the file is locked by another process, or the target location is write protected, or the target lacks the necessary space for the new data.

2.3.13 Other Screens


2.3.13.1 Trial Mode This screen is only displayed when Aid4Mail is running in trial mode. It usually shows up when you start Aid4Mail. There is an 8 second delay before you can continue to the main screen. You can click on the Buy Now button to connect to the Aid4Mail order page on the web and purchase an activation code. Once you have an activation code, click on the Activate button to enter it and remove the trial mode. When Aid4Mail is operating in Trial mode, it offers all the features available in the selected edition, but with 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

Copyright 2005-2013 Fookes Holding Ltd

73

Aid4Mail 3 Help

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 menu displayed after clicking on the Software button. Use it to check the internet for news and software updates from Fookes Software. News items are organized by category. A single mouse click on a news item will display the corresponding web page in your browser or starts a file download. Icons are displayed next to news items and have the following meaning: The news The news The news The news The news item item item item item has either been added today or after you last displayed news. has already been displayed before. link points to an .exe Setup file. link points to a .zip file. is an email address link.

The News and Updates screen is useful to find out if a new Aid4Mail update is available. It also displays news about our other major releases and occasionally special offers that we make available to our users. Information is transmitted one way only, from our server to your computer. No information about you or your computer will be revealed during this operation. Aid4Mail determines locally what relevant news to display to you. See our online FAQ for more information about this feature. Usually, program updates are downloaded and installed directly from within Aid4Mail updating your software this way couldn't be easier. However, be aware that some download managers may take over this download process and interfere with normal operations. When this happens, you may see a prompt from Aid4Mail asking you to click a button once the download has been completed. With other download managers, the download may fail altogether. In this case, turn off your download manager and try again. You can configure Aid4Mail to automatically check for news at regular intervals by checking the Check for news updates setting. The News and Updates screen will automatically pop up if news items have been added or modified since the last viewing.

2.4

Writing Aid4Mail Scripts


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

Type of Scripts
Aid4Mail currently supports three types of scripts. They are 1) Filter Scripts which can be selected from the Filter Options screen; 2) Output Scripts which can be selected from the Target Format screen; and 3) Plain Scripts which can be executed from the "Run Plain Script" menu command opened by clicking on the Software button. The main purpose of Filter Scripts is to control which emails are skipped or passed on to the next processing stage. But a Filter Script can also be used to save a detailed log of each email it analyses, or influence how emails are saved in the target format. Filter Scripts use the .s4f extension and are stored in the Scripts subfolder under the Aid4Mail program folder or under the Application Data folder. Use Output Scripts when you want complete control over the target format. You can create Output

Copyright 2005-2013 Fookes Holding Ltd

Reference Information

74

Scripts to create custom formats not available by default in Aid4Mail or to extract data from email messages. Output Scripts use the .s4o extension and are stored in the Scripts subfolder under the Aid4Mail program folder or under the Application Data folder. Plain Scripts do not process email data. So features related to email filtering and access to email data are not available in these type of scripts. You can use Plain Scripts for setup purposes, to test new code, or to help you learn the scripting syntax. Plain Scripts can be executed without prior installation or the need to run an email conversion, so they make a quick job of testing multiple versions of your code. Plain Scripts use the .s4p extension and do not need to be stored in a particular folder.

Script Structure
An Aid4Mail script is divided into several parts. The first part has several sections that provide information to Aid4Mail. For example, the [Script.Info] section has a Title field that Aid4Mail uses to list the script in the relevant part of its interface. The Requirements field tells Aid4Mail if the script can run under the activated version of the license (Aid4Mail Professional or Aid4Mail eDiscovery). The [Script.GUI.Enable] section tells Aid4Mail which interface features the script needs to use and which ones need to be disabled. The actual script code comes under the [Script.Code] section, and finally there is a [Template=] section where you can define one or more templates that are to be used by the script.

The script code is divided into several sections that are executed at specific moments (or events) of email processing. Each section starts with a double colon (::) followed by an identifier. The following events are available:
::OnStart

Code under this section executes before the first email is processed.
::OnNewFolder

This event occurs each time a new folder is starting to process. It occurs before the first email in the folder is processed.
::OnNewMessage

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

Code under this section executes after the last email has been processed. Aid4Mail scripts recognize several different kinds of data types. These are character strings (blocks of text), which have to be placed between double quotes. Example: "blocks of text" Boolean values: True or False Integers: 123 Decimal numbers: 123.456 and Hexadecimal characters: $41 (= letter A). Variables are named memory blocks that can store any of the above data types. Variable names always start with the % character followed by a series of alphanumerical characters - spaces, control characters, diacritics, and special symbols are not allowed in a variable name.
Copyright 2005-2013 Fookes Holding Ltd

75

Aid4Mail 3 Help

Aid4Mail supports four kinds of variables: plain single value variables (%plain), array variables (%Array. variable or %%variable) that can store multiple values, template variables (%Template.variable or #variable) that refer to a pre-defined template, and XML variables (%XML.variable) that provide a convenient way to construct XML data structures. Array variables can be subdivided into four types: plain arrays (%Array.variable) with just one column of data, statistics arrays (%Stats.variable) that increment a counter each time a duplicate value is added (no duplicates stored) - the value is in the first column and the counter in the second, Real arrays (% Real.variable) that can store decimal values (real numbers) in the second column, and signature arrays (%Sigs.variable) that store hash values of any data entered - useful for quickly determining if duplicate data is being processed. Aid4Mail provides several pre-defined variables. these are as follows: %CR = carriage-return character ($0D in hexadecimal) %LF = line-feed character ($0A in hexadecimal) %LB = line break (combines %CR+%LF) %CRLF = same as %LB %Tab = tab character ($09 in hexadecimal) %DQ = double-quote character (") Template variables represent a pre-defined layout for text and/or other variables. The template variable name must correspond to the name of a template stored in the templates section at the end of the script file. For example, #Log.Header (or %Template.Log.Header) refers to the template stored under the [Template=Log.Header] section. Templates that contain references to script variables must be identified by the "Variables" keyword which follows the template name and a semi-colon. Example:
[Template=Log.Data; Variables]

Variable place-markers in such templates are identified by the variable name placed between curly brackets. Here's an example with a place-marker for the %Address variable:
Email address: {Address}

When a template variable is processed, variable place-markers are substituted by the value contained in the corresponding script variable. Using the above example, with %Address = "me@gmail.com", produces the following result:
Email address: me@gmail.com

Aid4Mail variables exist within a scope that is defined by where they are first used. Data in variables that are defined in the OnStart section are accessible in all parts of the script. Variables defined in the OnNewFolder section can also be accessed in the OnNewMessage section, but not in the OnFinish section. Variables defined in OnNewMessage can only be accessed in that section. 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

Copyright 2005-2013 Fookes Holding Ltd

Reference Information

76

You can insert labels in a script to define separate blocks of code. A label starts with a colon character (:) followed by an identifier. Aid4Mail offers several "GoTo" commands that can alter the execution flow based on conditions defined by the script. Use the "Return" command in a label section to return to the script line following the "GoTo" command that brought you to it. Script execution starts at the beginning of an event section, and processed statements in sequential order until a "GoTo" instruction is encountered, or a label, or the next event section, or the start of the templates section. Aid4Mail supports over 180 functions. On execution, they all return a value that can be one of the data types mentioned higher up. Most of these function take on or more parameters, which must be separated with a semi-colon character (;). Parameters can consist of any of the supported data types. They can be literal values, variables, other functions, as well as concatenations of any of those. Use the + symbol to concatenate data. Example:
RunShell("Notepad.exe "+FileName.GetShortName(%TargetFile))

The script parser supports several operators that you can use for simple arithmetics. These are + (addition), - (subtraction), * (multiplication), and / (division). Unlike the Calculate function, you cannot use parentheses and there is no operator precedence; operations are evaluated from left to right. Examples:
%Val1 = 3 + 5 + " " + "apples" %Val2 = 3 - 1 * 5 - 2 + " " + "oranges" %Val3 = Calculate("3 - 1 * 5 - 2") + " " + "oranges"

%Val1 is assigned "8 apples"; %Val2 is assigned "8 oranges"; %Val3 is assigned "-4 oranges". The different results between %Val2 and %Val3 are due to differences in operator precedence between the two methods. Operators and functions supported by the Calculate script function are listed in the Calculate command topic. In some cases, one or more parameters are optional and a pre-defined default value is used when they are left out. Optional parameters are identified in the functions list by enclosing them between square brackets. Example:
String.Extract(Pattern; String[; SearchOptions; RegExFormat])

Examples of accepted variations using the String.Extract function:


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

Some functions and special features are only available to specific licenses. For example, the %Sigs. Variable, File.GetHash, String.GetHash, and RunConsole are only available when running Aid4Mail activated for eDiscovery. Aid4Mail Home can only use scripts in trial mode. You'll find usage examples of most of the functions in the "Test All.s4p" and "Test Mime.s4o" sample scripts. To execute the "Test All.s4p" script, click on the Software button in Aid4Mail, select "Run Plain Script", and then open the file. We encourage you to open the sample scripts in a text editor and then run them to compare results with the syntax. See the Aid4Mail Script Syntax topic for a list of syntax elements. Note that the regular expression engine used in some of the Aid4Mail script functions is based on PCRE 8.31. The regular expression syntax is documented in the Regex.chm Help file.

Copyright 2005-2013 Fookes Holding Ltd

77

Aid4Mail 3 Help

2.4.1

Aid4Mail Script Syntax


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

Events and Scope: ::OnStart ::OnNewFolder ::OnNewMessage ::OnFinish Insert code: ![FileName] Variables: %Variable %Array.Variable // special variable for handling arrays %Stats.Variable // special variable for handling string-counter array %Real.Variable // special variable for handling string arrays associated with decimal numbers %Sigs.Variable // special array variable for handling hash data [ <-- only in Aid4Mail eDiscovery]

Copyright 2005-2013 Fookes Holding Ltd

Reference Information

78

%Template.Variable // special variable containing template data %XML.Variable // special variable for handling XML data %%Array // shorthand for array variable #Template // shorthand for template variable Predefined Variables: %CR (Carriage Return) %LF (Line Feed) %LB = CRLF (Line Break) %CRLF %FF (Form Feed = page break) %Tab %DQ = " (double quote) %CB (Column break) %OH (Optional hyphen) %NBH (Non-breaking hyphen) %NBS (non-breaking space)

:Label Predefined Labels: NEXT_LINE, SKIP_LINE, SKIP_MESSAGE, SKIP_FOLDER, FINISH, HALT RUNTIME_ERROR Types: "String" True/False 123 123.456 $0A Assignment: %Variable = Value Mathematical operators: + - * / Comparison operators: =, <> or !=, <, >, <=, >= Comments in Script code section: // ... Object: Mime.Attr[(Name)] // Returns current field attribute, or attribute value if a name is specified Mime.Attr.Count Mime.Attr.Find(AttrName) Mime.Attr.GoFirst Mime.Attr.GoLast Mime.Attr.GoNext Mime.Attr.Name Mime.Attr.Set(Name; Value) // Added if Name doesn't exist; deleted if Value is empty Mime.Attr.Value
Copyright 2005-2013 Fookes Holding Ltd

79

Aid4Mail 3 Help

Mime.Body[(Format)] // Format = Decoded, Raw Mime.Body.Set(Value) Mime.Boundary Mime.Charset Mime.ContentType Mime.Count Mime.Email Mime.Field[(Name)] // Returns current field, or field value is a name is specified Mime.Field.Count Mime.Field.Find(FieldName) Mime.Field.GoFirst Mime.Field.GoLast Mime.Field.GoNext Mime.Field.Name Mime.Field.Set(Name; Value) // Added if Name doesn't exist; deleted if Value is empty Mime.Field.Value Mime.FileName Mime.Find(Section) // Section = Display, Text, Html, XML, Rich, TNef, Attachments Mime.FromDelimiter Mime.GoChildren Mime.GoFirst Mime.GoLast Mime.GoNext Mime.GoParent Mime.HasChildren Mime.HasParent Mime.Header[(Format)] // Format = Decoded, Raw Mime.Header.Set(Value) Mime.IsAttachment Mime.IsEmbedded Mime.IsMessage Mime.IsMultipart Mime.Preamble // This is a multi-part message in MIME format. Mime.Size

Commands: // All Array data is stored in same Charset, 7 -> System -> UTF-8) Array.Add(Array; Value[; Delimiter]) Array.Add(Array; Value[; Number]) Array.Exists(Array; Value) Array.Format(Array[; Delimiter; Options]) // Array.Format(StatsArray[; Format]) // Format Name; ^2 = Count; ^3 = Percentage Array.Format(StatsArray[; Format]) // Format Array.GetNumber(Array[; Index]) Array.GetNumber(Array; Value) Array.GetIndex(Array[; Value]) Array.GetSize(Array) Array.GetValue(Array[; Index]) Array.Load(Array; FileName) Array.Remove(Array[; Index]) Array.Remove(Array; Value) Array.Replace(Array; Index; NewValue) which is determined by data added (ASCII-

Options = Sort = "^1"+%Tab+"^2"+%Tab+"^3"+%LB // ^1 = = CSV

Copyright 2005-2013 Fookes Holding Ltd

Reference Information

80

Array.Replace(Array; NewValue) Array.Replace(Array; OldValue; NewValue) Array.Save(Array; FileName[; Options]) // Options = Overwrite, Backup, Increment, Skip, Error Array.SetIndex(Array; Index) Calculate(Expression) Clear(Variable[; Type]) // Type = Plain, Array Decrement(Number[; Count]) Decrement(Array; Item) Define(Variable[; Type]) // Type = String, Boolean, Number, Array, StatsArray, RealArray, XML Define(Variable; SigsArray[; HashMethod]) // HashMethod = CRC32, MD5, SHA1, SHA256, SHA384, SHA512 [ <-- only in Aid4Mail eDiscovery] ErrorCode ErrorLine ErrorMessage File.Append(FileName; Data[; CharSet]) // Creates BOM on new file if CharSet = UTF-16 or UTF-8b; CharSet can be numerical value or Charset name like UTF-8 File.Copy(Source; Target[; Options]) // Options = Overwrite, Append, Backup, Increment, Skip, Error File.Delete(FileName) // Does not delete files in system folders File.Exists(FileName) File.Exists(ZipFile; Specs) File.GetDate(FileName[; DateField]) // DateField=create, modified, accessed File.GetHash(FileName[; Options]) // Options = CRC32, MD5, SHA1, SHA256, SHA384, SHA512 [ <-- only in Aid4Mail eDiscovery] File.GetIni(FileName; ValueName) File.GetIni(FileName; SectionName; ValueName) File.GetSize(FileName) File.Load(FileName[; Options]) // Options = Parse File.Rename(FileName; NewName[; Options]) // Options = Overwrite, Backup, Skip, Error File.Save(FileName; Data[; Options; CharSet]) // Options = Overwrite, Append, Backup, Increment, Skip, Error; Creates BOM on new file if CharSet = UTF-16 or UTF-8b; CharSet can be numerical value or Charset name like UTF-8 File.SetIni(FileName; ValueName; Value) File.SetIni(FileName; SectionName; ValueName; Value) File.UnZip(ZipFile; TargetFolder[; Specs]) File.Zip(ZipFile; FileName; Data) File.Zip(ZipFile; Specs[; Options]) // Options = Subfolders FileName.ChangeExtension(FileName; NewExt) FileName.Clean(FileName) FileName.Expand(FileName) // "%Documents%\Export\" -> "c:\Documents and Settings\John\My Documents\Export\"; tokens: %Pictures%, %Documents%, %Desktop%, % ProgramData%, %AppData%, %IniFolder%, %TempFolder%, %SharedDocuments%, %SharedDesktop %, %SharedData%, %ExeFolder%, %UsbDrv%, %ExeDrv% FileName.Expand(FolderName; FileName) // FileName.Expand(%MyDocs%; "Doc.txt") -> c: \Documents and Settings\John\My Documents\Doc.txt FileName.GetExtension(FileName) FileName.GetLongName(ShortFileName) FileName.GetName(FileName) FileName.GetPath(FileName) FileName.GetShortName(LongFileName)

Copyright 2005-2013 Fookes Holding Ltd

81

Aid4Mail 3 Help

Folder.Copy(Source; Target[; Options]) // Options = SkipIfExists Folder.Create(Folder) Folder.Delete(Folder) // Only deletes folders under MyDocuments and Temp folders Folder.Exists(Folder) Folder.IsEmpty(Folder) FolderName.Append(Folder; Subfolder) FolderName.Clean(Folder) FolderName.GetName(Folder) // "%MyDocs%\Export\" -> "Export" FolderName.GetParent(Folder) // "%MyDocs%\Export\" -> "c:\Documents and Settings\Eric\My Documents\" FolderName.GetRelativePath(BaseFolder; DestFolder) FormatDateTime(DateTime; Format); GetDateTime[("UTC")] GetUserValue(Question[; DefaultValue]) GoTo(Label) GoToIf(Condition; LabelIfTrue[; LabelIfFalse]) // Condition Operators: =, <> or !=, <, >, <=, >= GoToIfError(Label) GoToIfFalse(Condition; Label) Increment(Number[; Count]) Increment(Array; Item) IsEmpty(Variable) IsFalse(Condition) IsNotEmpty(Variable) IsNumber(Variable) IsString(Variable) IsTrue(Condition) Message.Export(FileName[; Format; Options]) // Format = EML, MHT, msg, mbox, Mozilla, Contents, Addresses; Options = Full, Extract, Rich, Plain Message.Extract(TargetFolder[; Specs; Options]) // Specs = *.eml; Options = Attachments, Embedded, All Message.FileName Message.GetAddress(Field[; Part; Delim]) // Field = Who, From, To, Cc, Bcc, Sender, Reply-To, Resent-From, Resent-Sender, Resent-To, Resent-Cc, Resent-Bcc; Part = All, AddrSpec, DisplayName Message.GetBody[(Part; Options)] // Part = Display, Text, Html, Rich; Options = Decoded, Raw, PlainText Message.GetDate[(DateField; Format; TimeZone)] // DateField = Display,Sent,Received, Stored; Format = binary or yyyy/mm/dd; TimeZone = Local,UTC Message.GetEmlName[(Options)] // Options = Subject, MD5 Message.GetFileNames[(Specs; Options; Delim)] // Options = Attachments, Embedded, All Message.GetFlags //N R A F D M T E U O I (New, Read, Answered, Forewarded, Deleted, Marked, aTtachments, Email, Usenet, Outgoing, Incoming) Message.GetFolder[(Options)] // Options = Mailbox, Source Message.GetFolderFlags // I O D T U (Incoming, Outgoing, Drafts, Trash/junk, Unknown) Message.GetHeader[(Field; Options)] // Field = All, FromDelimiter, Subject, MessageId, ...; Options = Decoded, Raw Message.GetMailboxName Message.GetRaw[(Options)] // Options = Full, Extract, Rich, Plain Message.GetSize Message.IsDateInRange(DateStart; DateEnd[; DateField]) // DateStart = yyyy-mm-dd Message.IsOutgoing // message going out (not received) Message.Priority // 0 = none, 1 = highest, 5 = lowest

Copyright 2005-2013 Fookes Holding Ltd

Reference Information

82

Message.SetHeader(Name; Value) Number.Abs(Variable) Number.Div(Numerator; Denominator) Number.Log(Variable) // returns the natural logarithm (Ln(e) = 1) Number.LogN(Base; X) // LogN returns the log base Base of X Number.Mod(Numerator; Denominator) Number.Negate(Variable) Number.Percentage(Numerator; Denominator) Number.Power(Base; Exponent) Number.Round(Variable[; Decimals]) Number.Sqrt(Variable) Number.ToString(Variable[; Decimals; ThousandSeparator]) // ThousandSeparator can be Boolean value (True/False) or a character (,') Number.Trunc(Variable[; Decimals]) Print.Data(String) Print.FontSetup[(Name; Size; Style; CharSet)] // Style = B,I,U,S Print.PageSetup[(MarginLeft; MarginRight; MarginTop; MarginBottom; Orientation)] // Margins in mm; Orientation = Portrait, Landscape Print.PrinterSetup[(PrinterName)] Print.TextFile(FileName) Print.Title(String) RefreshScreen Return // Use in label section to return to back to previous source section RunConsole(Executable; Parameters[; StdInput]) [ <-- only in Aid4Mail eDiscovery] RunShell(Command[; Options]) // Options = Wait Settings.AppendMail Settings.CurrentFolder // returns current folder path. Example: Inbox\Urgent\Today Settings.ExtractContents Settings.Filter Settings.HashFileNames Settings.ProgramParam(Switch) Settings.ProgramTrialMode // True/False Settings.ProgramType // Home, Professional, eDiscovery, Console Settings.ProgramVersion //2000, 2010, ... Settings.RestoreFolders Settings.SkipDuplicates Settings.SourceFolder Settings.SourceMail Settings.TargetFileName Settings.TargetFolder Settings.TargetFormat Settings.TargetLineFormat ShowInfo(Message[; Options]) // Options = ProgressLog, DialogBox Sound(SoundName) String.ChangeCase(String; Options) // Options = Lower, Upper, Capitalize, Invert String.ChangeCharSet(String; NewCharSet) // NewCharSet can be numerical value or Charset name like UTF-8 String.Contains(Chars; Set) // Contains("AZ"; "ABCDZEF") -> True String.Copy(String; Offset[; Amount]) // if Offset is negative position is calculated from string end

Copyright 2005-2013 Fookes Holding Ltd

83

Aid4Mail 3 Help

String.Decode(String[; Options]) // Options = quoted-printable quoted base64 CSV HTML RTF URL UUE ROT13 String.Delete(String; Offset[; Amount]) // if Offset is negative position is calculated from string end String.Encode(String; Options) // Options = quoted-printable quoted base64 CSV URL UUE ROT13 String.Escape(String; Chars; EscChar) String.Exists(Pattern; String[; SearchOptions]) // SearchOptions = C,W,?,R String.Extract(Pattern; String[; SearchOptions; Format]) // SearchOptions = C,W,?,R String.ExtractAll(Pattern; String[; SearchOptions; Format]) // SearchOptions = C,W,?,R String.Filter(String; OldChars[; NewChars]) // deletes found OldChars if no corresponding NewChars String.Format(String; Format[; Charset]) // Format = Windows, Mac, UNIX; CharSet can be numerical value or Charset name like UTF-8 String.GetCharCount(String) String.GetCharSet(String) // 0 = System; 20127 = ASCII; 65001 = UTF-8 String.GetCount(Substring; String[; SearchOptions; Offset]) // SearchOptions = C,W,?,R String.GetHash(String[; Options]) // Options = CRC32, MD5, SHA1, SHA256, SHA384, SHA512 [ <-- only in Aid4Mail eDiscovery] String.GetPosition(Substring; String[; SearchOptions; Offset]) // SearchOptions = C, W,?,R String.GetPositionRight(Substring; String[; SearchOptions; Offset]) // SearchOptions = C,W String.Insert(Substring; String; Offset) // if Offset is negative position is calculated from string end String.IsSameAs(Pattern; String2[; MatchOptions]) // MatchOptions = ?,R String.IsSameAs(String1; String2[; MatchOptions]) // MatchOptions = C String.Pad(String; Width[; Char]) // Negative width pads left side String.Replace(String; Pattern; NewText[; SearchOptions; Offset]) // SearchOptions = C,W,?,R,S (S = SmartReplace) String.Shorten(String; Width[; EndMarker]) String.ToBoolean(String) String.ToCSV(String) String.ToDateTime(String; Format) String.ToNumber(String) String.ToString(Variable) String.ToTSV(String[; SubstTab; SubstLB]) //SubstLB="unwrap" or any other substitution string String.Trim(String[; Chars; Options]) // Options = Left, Right, LeftRight String.Unwrap(String) String.UrlDecode(String) String.UrlEncode(String) String.Wrap(String; Width[; Indent]) System.ComputerName System.DateTime[(Format; "UTC")] System.LogonName System.TimeZone ValueIf(Condition; ValueIfTrue[; ValueIfFalse]) // Condition Operators: =, <> or !=, <, >, <=, >= Wait(Time) // Causes script to pause for specified amount of time. Time value is in milliseconds // All XML data is stored in UTF-8 format

Copyright 2005-2013 Fookes Holding Ltd

Reference Information

84

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

2.4.2

Calculate command
This topic documents the mathematics operators and functions supported by the Calculate command available in the Aid4Mail Script Syntax. +: operand, executes adding operation -: operand, executes subtraction operation *: function, executes multiplying operation /: function, executes division operation Sqrt: functions, root of a number. Root can have any degree Div: functions, executes integer division operation Mod: functions, executes remainder operation Int: function, returns the integer part of a number Frac: function, returns the fractional part of a number Random: function, returns random number within the range 0 <= value < 1 Trunc: function, truncates a number to an integer Round: function, returns the value rounded to the nearest whole number Sin: function, returns the sine of the angle in radians ArcSin: function, returns the inverse sine of a number Sinh: function, returns the hyperbolic sine of an angle 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

Copyright 2005-2013 Fookes Holding Ltd

85

Aid4Mail 3 Help

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

Copyright 2005-2013 Fookes Holding Ltd

Reference Information

86

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

Copyright 2005-2013 Fookes Holding Ltd

87

Aid4Mail 3 Help

2.5

Aid4Mail Console
Aid4Mail Console is the Win32 CLI version of Aid4Mail and its file name is a4m.exe . It is a different program from the regular GUI version of Aid4Mail (file name Aid4Mail.exe ). It is included with the Aid4Mail Console Migrator and Aid4Mail eDiscovery Service licenses. And it is available as a bundle option with Aid4Mail eDiscovery Forensic , Aid4Mail eDiscovery Archivist and Aid4Mail eDiscovery Personal. Aid4Mail Console can be run from batch files, the Windows Start/Run dialog, and any application that can execute other programs; conversion options can either be set through command-line switches, an INI file, or both. Unlike the other versions of Aid4Mail, the Console can process more than one PST file unattended. This capability is particularly useful if you need to process dozens or hundreds of PST files in a batch. The server edition of Aid4Mail Console can be launched as a Windows Service through the Easy Service Launcher (ESLaunch.exe) utility included in the distribution package. You will find usage instructions in the ESLaunch.txt file. You can download the server edition from the following link: http://www.aid4mail.com/get.php?a4m-srv Aid4Mail Console uses Exit Codes to inform the calling process if a conversion was successful or if errors occurred.

2.5.1

Command-Line Parameters
Aid4Mail Console supports an array of command-line switches that you can use to configure mail processing tasks. The command line length should not exceed 2000 characters under Windows 7, Vista, XP and NT. You can define settings through an INI file to simplify and reduce the length of your command line (see the INI File Settings topic for details). Command-line syntax:
a4m.exe Source [Target] [/optional switches] [>filename] a4m.exe /INI=FileName [/optional switches] [>filename] a4m.exe [/optional switches] [>filename]

Source [file name or specs, or "mapi", or "imap"] Required parameter for finding the mail to convert unless this information is provided through an INI file. The value can represent a token (mapi or imap), or a PST, MSG, EML, Mozilla or other generic mailbox file name or search criteria (allows the wildcards "*" and "?"). Use double quotes if the Source name contains spaces. Tokens and system variables are supported in the path name. Use the "mapi" token to access a MAPI profile; the default profile is used if no profile name is specified through the /S_Profile switch. Use the "imap" token to retrieve email from an IMAP account. The account logon settings are taken from the source.imap.ini file (located in the program folder), which you must modify beforehand. Example:
a4m.exe imap %Outlook%\Test.pst

The above example converts mail from your IMAP account to a new PST file called Test.pst, which is saved in the default file storage location for Office Outlook. You can open the newly created file through the File/Open/Outlook Data File menu command in Office Outlook (older versions of Outlook may use slightly different names for the menu command.) When using the "mapi" and "imap" tokens, you can specify the name of the folder you want to export

Copyright 2005-2013 Fookes Holding Ltd

Reference Information

88

from or to. Simply use a colon (:) after the token name followed by the folder path using a backslash to separate folder names. Use double quotes if it contains spaces. Wildcards are supported. Example.
a4m.exe imap:INBOX\Archives\* %Outlook%\Test.pst

Target [file or folder name, or "mapi", or "imap"] Optional name and/or folder for target mailbox file. This parameter must come second if used. If you do not specify a name, the program will save the exported mail into the current folder, or the "My Documents" folder if it is write protected. Use double quotes if Target contains spaces. Tokens and system variables are supported. If you choose to export mail to the EML or MSG format, Target should represent a folder. If you export to an mbox format, Target can either represent a folder or file name. If the Target name ends with a backslash (\), the contents of each mail folder is stored into its own mbox file with a name matching that of the mail folder. If you want the exported files to use the same name as the source files, but with a different extension, use the asterisk wildcard followed by the extension. Example: *.txt -> files are created with the name of the source file and the TXT extension. Use the "mapi" token to access a MAPI profile; the default profile is used if no profile name is specified through the /T_Profile switch. Use the "imap" token to export your mail to an IMAP account. The account logon settings are taken from the target.imap.ini file (located in the program folder), which you must modify beforehand. When using the "imap" token, you can specify the name of the folder you want to export to. Simply use a colon (:) after the token name followed by the folder path using a backslash to separate folder names. Use double quotes if it contains spaces. Example.
a4m.exe %Outlook%\Test.pst "imap:INBOX\Imports 2012\"

If you are exporting EML, MHT, or MSG files to the EML, MHT, or MSG format, you can use the {filename} token to instruct Aid4Mail to create target message files that have the same name as the source mail files.

Options switches See the following topics for a list of available optional command-line switches: Source Switches Target Switches Filter Switches Other Switches

/INI=FileName Use this switch to specify an INI file with settings for Aid4Mail Console. Use double quotes if the file name contains spaces. Tokens and system variables are supported. Example:
a4m.exe /ini="%MyData%\Aid4Mail Settings.ini"

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

Copyright 2005-2013 Fookes Holding Ltd

89

Aid4Mail 3 Help

continue unattended. Alternatively, you can also use the /unattended switch if you do not want to redirect output. Note that you cannot use this redirect method from the Windows Run feature. You need to launch Aid4Mail from the command prompt of the Windows CMD console or a Windows batch file to redirect output with the ">" symbol. 2.5.1.1 Source Switches This topic covers Aid4Mail Console optional command-line parameters that control how source mail is accessed and processed. /AddWinmailDat Converts TNEF messages to the RFC 1521 format using the MAPI internal converter and saves the original TNEF data in a winmail.dat email attachment. /DelSource=Fast Permanently deletes source messages that have been successfully processed. The delete feature works on the following source formats: IMAP accounts, MAPI profiles ("Default message store" only), PST, MSG, and EML files, and Mozilla mailboxes (including Thunderbird, SeaMonkey, Eudora OSE, and Netscape). Only use this feature with the greatest care as in most cases you will not be able to undelete the source messages. We strongly recommend that you first test this feature on data that you can fully restore from backups if necessary. When using this switch, YOU AGREE TO RELEASE FOOKES SOFTWARE AND ITS SUPPLIERS FROM ANY LIABILITY OR DAMAGES DUE TO THE LOSS OF ANY SUCH DATA OR FILES. Example:
a4m.exe %Outlook%\Outlook.pst D:\Mail\Generic\*.mbox /DelSource=Fast

/emlExt=ext Enables processing EML files with an extension that is different from the standard ".eml" one. Set the "ext" value either to the corresponding file extension or use "*" to accept any file extension. Example:
a4m.exe D:\Messages\ D:\Archives\Mail_2011.zip /emlExt=txt

Note that you can also use the /m=eml switch instead of /emlExt. Example:
a4m.exe D:\Messages\*.txt D:\Archives\Mail_2011.zip /m=eml

/f="folder name" Exports mail from from the specified source folder in a PST file or an Outlook/Exchange store. Use double quotes if the folder name contains spaces. You can use the wildcards "*" and "?" to broaden the scope of folder that should match the criteria. Use a backslash "\" character as a separator in a folder path. Example: Inbox\Urgent ("Urgent" is a subfolder of the "Inbox" folder). Example: if you use / f="*Urgent", Aid4Mail will export mail from folders called "Urgent", "Inbox\urgent", "Sent Items\No Reply\URGENT". If the search subfolders option is set, then the two following examples are equivalent:
a4m.exe %Outlook%\Outlook.pst D:\Mail\Generic\*.mbox /f=Inbox a4m.exe %Outlook%\Outlook.pst D:\Mail\Generic\*.mbox /f=Inbox\*

If you only want to process the Inbox (without subfolders if any), then add the /s=False switch:
a4m.exe %Outlook%\Outlook.pst D:\Mail\Generic\*.mbox /f=Inbox /s=False

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

Copyright 2005-2013 Fookes Holding Ltd

Reference Information

90

with new messages added to it). If you are processing mailbox files that are entirely created by a single mail program, then you can increase performance without sacrificing reliability by using the /fast switch. /IncludeAllItems Includes Calendar, Contacts, Tasks, and other non-email items in an Outlook/Exchange mail store during processing. By default, Aid4Mail only processes email items. Note that the current version of Aid4Mail only exports email-related fields, so special data fields used in Calendar, Contacts, Tasks items are not transfered. /IncludeTrash Includes mail stored in the Trash, Junk, and Deleted Items folders during processing. The names of such folders are stored in the files TrashFiles.dat and TrashFolders.dat that you will find in the Aid4Mail program folder. You can add more folder names to these two files if necessary (one name per line). The TrashFolders.dat file is for message folder names created by Outlook and Exchange. Aid4Mail uses the names stored in TrashFiles.dat to determine which mailbox files from other mail clients contain deleted or unwanted messages. By default, mail in these folders is ignored. /IncludeUnpurged Includes moved and deleted items still present in mailbox files and folders that haven't been compacted or expunged prior to processing. These type of emails are usually not displayed in your mail program. Note that if you use this option with Outlook Express .dbx files, processed messages all have a certain degree of corruption as the deletion process partially damages the stored email. By default, Aid4Mail skips messages that have been flagged as removed from a mailbox. /m /m=mbox OR pine OR moz OR eudora OR mc_eudora OR calypso OR maildir OR eml OR msg OR pmmail_msg Tells Aid4Mail what the source mail format is. This switch is useful if Aid4Mail's automatic format detection fails due to insufficient information. This switch can also be used without specifying a value (/ m); in this case Aid4Mail performs less strict format checking on certain mailbox types. The following switch values are available: mbox - use if source is a generic mailbox file (mbox, Berkeley mail format, BSD mail format, Unix mail format) pine - use if source is a Pine mbox file with limited "From " escaping moz - use if source is Mozilla Mail, Thunderbird, Eudora OSE, or Netscape eudora - use if source is a Qualcomm Eudora MBX file mc_eudora - use if source is a Macintosh Eudora mailbox file calypso - use if source is Calypso Mail or Courier maildir - use if source represents Maildir folders eml - use if source represents eml mail files msg - use if source represents Outlook MSG mail files pmmail_msg - use if source represents PMMail MSG mail files Example:
a4m.exe D:\Mail\*. D:\Archives\Backup2012.zip /m=mbox

/MapiConvOff With Outlook 2003 and more recent versions, Aid4Mail uses a special MAPI feature to import/export mail from Outlook PST and MSG files, and Exchange server stores. The advantage of this method is that it converts messages with non-Latin characters and certain special email formats more reliably than other methods. The disadvantage is that it is usually slower than Aid4Mail's alternative method. Add the /MapiConvOff switch to turn off the special MAPI conversion feature if you are encountering issues
Copyright 2005-2013 Fookes Holding Ltd

91

Aid4Mail 3 Help

when using it or if conversion speed is critical. /MapiFixOff When converting mail from Outlook PST and MSG files, and Exchange server store formats to RFC textbased formats (MIME), Aid4Mail automatically restores original data that is lost by the MAPI converter. These fixes are necessary to ensure that the converted email is as faithful as possible to the original email. The disadvantage of this procedure is that it slows down conversion and in some very rare cases fails to correctly render emails based on unusual formats. Use the /MapiFixOff switch to turn off the default email fixing feature. /s=True OR False Includes mail stored in source subfolders when set. This option is on by default so you only need to use this switch to ignore subfolders during processing. Example: /S=False /S_Log="file name" Enables logging of communications between Aid4Mail and the source IMAP account; data is stored in the specified log file. Use double quotes if the file name contains spaces. The folder name can include tokens and system variables. /S_Namespace="IMAP Namespace" Defines the Namespace for the source IMAP account. Use double quotes if the user name contains spaces. /S_Profile="name of MAPI profile" /S_Profile="IMAP INI file" If your source mail is defined by the "mapi" token, use this switch to specify a profile name for your source MAPI account if it is different from your default profile name. Use double quotes if the profile name contains spaces. If your source mail is defined by the "imap" token, this switch tells Aid4Mail where to find the logon settings file for your source IMAP account. If no file path is specified, Aid4Mail looks for it in its program folder or under the IMAP subfolder. Tokens and system variables are supported. If this setting is not used, Aid4Mail will look for the source.imap.ini file in the same folder as the a4m.exe program file. Example: /S_Profile="%MyData%\IMAP Settings.ini" /S_PW=password Defines a password for the source PST file or IMAP account. Use double quotes if the password contains spaces. Note that this password has nothing to do with the profile password, which MAPI automatically prompts you to enter in a separate dialog box. /S_UserId="User name" Defines the logon user name for the source IMAP account. Use double quotes if the user name contains spaces. /UseMapiTnefConverter Converts TNEF messages to the RFC 1521 format with the MAPI internal converter. This switch should only be used if you are encountering conversion issues with those type of emails. 2.5.1.2 Target Switches This topic covers Aid4Mail Console optional command-line parameters that control how target mail is accessed and processed. You will find additional switches listed under the topics Target Format Switches and Email Contents Switches.
Copyright 2005-2013 Fookes Holding Ltd

Reference Information

92

/a Appends message to target store or mailbox file if it already exists. If this switch is not used, a backup copy of the mailbox file is created before the export procedure starts. This option is ignored if you are exporting to an Outlook email profile, or EML, MHT, XLS, DBS, and MSG files. /b="folder name" Defines the base folder (or parent folder) in a PST file or Outlook email profile that will receive exported mail. This option is ignored if you are exporting to other mail formats. Use double quotes if the folder name contains spaces. Use a backslash "\" character to separate folder names in a path. Example: / b="Inbox\Imported Mail" /DisplayName="PST display name" Defines a display name for a new target PST file. By default, Aid4Mail creates a name like "Imported Folders (April 14, 2011)" when this switch is not used. This switch is ignored if the target is not a PST file. /md5Name /md5Name=MessageId Creates MSG, EML, and MHT files with a name based on their MD5 signature. This switch is ignored with other types of target mail. By default, the MD5 signature for EML and MHT file names is computed from the full email (message header + body). When the switch has the "MessageId" value, the MD5 signature for EML and MHT file names is based on the Message-ID field value. If this field is empty or missing (usually in outbound messages), Aid4Mail generates the signature from the email date and subject line, or other fields (To, Cc, Bcc, From delimiter) from the message header if either of those values are blank, or the whole header. /t By default, Aid4Mail normally restores the source folder structure at the target end. Use the /t switch to save all processed mail into a single target folder. When used with the /xls export option, all email items are grouped into a single worksheet page. This switch is ignored if you are exporting mail to the /mht and /dbs formats. /T_Log="file name" Enables logging of communications between Aid4Mail and the target IMAP account; data is stored in the specified log file. Use double quotes if the file name contains spaces. The folder name can include tokens and system variables. /T_Namespace="IMAP Namespace" Defines the Namespace for the target IMAP account. Use double quotes if the user name contains spaces. /T_Profile="name of MAPI profile" /T_Profile="IMAP INI file" /T_Profile="PDF INI file" When using the "mapi" token, this switch defines a profile name for your target MAPI account. Use double quotes if the profile name contains spaces. Aid4Mail will access your default Outlook profile when this switch is not used. When using the "imap" token, this switch tells Aid4Mail where to find the logon settings file for your target IMAP account. If no file path is specified, Aid4Mail looks for it in its program folder or in the IMAP
Copyright 2005-2013 Fookes Holding Ltd

93

Aid4Mail 3 Help

subfolder. Tokens and system variables are supported. Use double quotes if the profile name contains spaces. Aid4Mail will look for the target.imap.ini file when this switch is not used. Example: / T_Profile="%MyData%\IMAP Settings.ini" If your target is a PDF file, this switch tells Aid4Mail where to find the PDF settings file. If no file path is specified, Aid4Mail looks for it in its program folder. Tokens and system variables are supported. If this switch is missing, Aid4Mail will look for the pdf.ini file in the same folder as the a4m.exe program file. Example: /T_Profile="%MyData%\PDF Settings.ini" /T_PstSize=Value in GB or MB If you think your export will exceed the capacity of a single PST file, you can use /T_PstSize switch to set a threshold value. Setting the value to zero or leaving it blank instructs Aid4Mail to not monitor the PST file size. Otherwise, Aid4Mail treats values equal to or below 500 as representing gigabytes (GB) and values above as megabytes (MB). When the size limit is reached, Aid4Mail stops exporting mail to the current PST file, creates a new PST file based on the name of the first one but with an index number, and then continues the mail export to the new PST file. For example, if you set the size limit to 2 GB for a file called Outlook.pst and have 5 GB of mail to export, Aid4Mail will create the following files on completion: Outlook.pst Outlook[001].pst Outlook[002].pst Note that Aid4Mail cannot determine exactly when the limit is reached because Outlook uses a data cache. In other words, Outlook will still send data to the PST file after Aid4Mail has measured the file size and stopped exporting mail to it. As a result, a PST file may slightly exceed the size limit you set. To avoid problems, choose a smaller size that ensures your PST file will never get too big. /T_PW=password Defines a password for the target PST file or IMAP account. Use double quotes if the password contains spaces. PST files: the password enables creating a new password-protected PST file or adding mail to an existing password-protected PST file. When you create a password-protected ANSI PST file with Aid4Mail, the high encryption format is used if the password exceeds 8 characters and the weaker compressible-encryption format is used with shorter passwords. With Unicode PST files, the default compressible-encryption format is used (high encryption is not supported.) Note that this password has nothing to do with the profile password, which MAPI automatically prompts you to enter in a separate dialog box. /T_UserId="User name" Defines the logon user name for the target IMAP account. Use double quotes if the user name contains spaces. /TimeZone Changes the default time zone Aid4Mail uses when setting the date stamp of exported message files and date values in the corresponding column of MHT target formats. The switch accepts a time zone value in one of several formats: numerical, time zone abbreviation, time zone in short form, or Windows registry time-zone name. See the Time Zones topic for more information. If this switch is missing, Aid4Mail uses UTC time. /UseDateField When exporting mail to eml, mht, and msg files, as well as when extracting files (attachments and embedded contents), Aid4Mail sets the file stamp to match the email date. By default, Aid4Mail uses
Copyright 2005-2013 Fookes Holding Ltd

Reference Information

94

the server Received date taken from the header of incoming messages (Aid4Mail always uses the Date field for outgoing mail). You can use the /UseDateField to tell Aid4Mail to always get the date from the message header Date field instead of the server Received date.
2.5.1.2.1 Target Format Sw itches

This topic covers Aid4Mail Console optional command-line parameters that determine the target mail format. /addresses=csv OR tab OR txt This feature is ideal if you need to rebuild an address book or to create a mailing list with addresses of people that have been corresponding with you. Aid4Mail automatically removes duplicates and sorts addresses in alphabetical order. You can specify the most appropriate output format after the equal sign: comma separated values (*.csv), tab separated values (*.tab), and plain-text values (*.txt). /attachments Exports only the file attachments contained in the processed source mail. Aid4Mail also saves an Attach.tab file in the target folder, which contains a tab-delimited list of all the extracted attachment files. /contents Exports only the file attachments and embedded contents contained in the processed source mail. Embedded contents (inline attachments) are saved under the "Embedded" folder and file attachments under the "Attach" folder. Aid4Mail also saves an Attach.tab file in the target folder, which contains a tab-delimited list of all the extracted files. /dbs Similar to the /mht switch, but produces an index file for importing mail data into a database. /eml Exports each source mail into a corresponding EML file. The resulting file name is built from the message's subject line, unless it is specified in the target parameter, or if you use the /md5Name switch. Aid4Mail also saves a Mail.tab file in the target folder, which contains a tab-delimited list of all the exported EML files (useful if you want to import mail in a database.) This switch is not required if your target name includes the .eml file extension. /mapi Exports the source mail to a MAPI profile. The profile name is specified through the Target name. Example:
a4m.exe %Thunderbird%\*.msf "John Doe" /mapi

Note that Aid4Mail now provides an alternative format using the mapi token. Example:
a4m.exe %Thunderbird%\*.msf mapi /T_Profile="John Doe"

/mbox Exports the mail into an mbox-compatible (generic) mailbox file. This export option is used by default if none of the export format switches are specified and the target name has a different extension from .eml, .mht, .msg, .pst, .zip. This switch is not required if your target name includes the .mbox file extension. /mht Exports each source mail into a corresponding MHT file (HTML Web Archive). The resulting file name is built from the message's subject line, unless it is specified in the target parameter. The format is similar to EML files. MHT files can be viewed in Internet Explorer like a regular HTML file; embedded pictures are displayed in the browser window and attachments can be extracted by clicking on their link. Aid4Mail automatically creates web pages that enable you to easily view your converted mail in Internet
Copyright 2005-2013 Fookes Holding Ltd

95

Aid4Mail 3 Help

Explorer; just open the file index.html in your browser. This switch is not required if your target name includes the .mht file extension. /moz Exports the source mail into a Mozilla-compatible mailbox file (Netscape, Mozilla, Thunderbird, Eudora OSE). /msg Exports each MAPI source mail into a corresponding MSG file. The resulting file name is built from the message's subject line. The source must be a PST file or a MAPI mail profile. This switch cannot be used if the source is also MSG files. This switch is not required if your target name includes the .msg file extension. /OutputScript="Script Name" Use the OutputScript switch to load the specified script name. The script name can either be a fully qualified file name or just a file name without path and extension. See the Writing Aid4Mail Scripts topic for more information about Output Scripts. /pdf Exports mail to Adobe PDF file(s). By default, the PDF format options are taken from the pdf.ini file in the program folder. You can specify a different configuration file through the /T_Profile command-line switch. Note that due to third-party licensing terms, the server edition of Aid4Mail Console currently does not include the PDF export option. This switch is not required if your target name includes the .pdf file extension. /pst Exports the source mail into a standard Outlook PST file (ANSI format). You can use the /b switch described under Optional Switches to specify which mail folder should be receiving the messages. This type of PST file has a maximum storage capacity of 2 GB and is compatible with all versions of Office Outlook. This switch is ignored if you use the "mapi" token (to access a MAPI profile) as the Target value. /UnicodePst Exports the source mail into a Unicode PST file (Outlook 2003 or newer). You can use the /b switch described above to specify which mail folder should be receiving the messages. This type of PST file has a maximum storage capacity of 20 GB in Outlook 2003 and 2007, 50 GB in Outlook 2010 and 2013, and is not compatible with Outlook 97, 98, 2000, and 2002. Note that this switch will create a regular ANSI PST file if your version of Microsoft Outlook is older than Outlook 2003 or if you use the standalone version of MAPI. This switch is ignored if you use the "mapi" token (to access a MAPI profile) as the Target value. This switch is not required if your target name includes the .pst file extension. /xls Similar to the /mht switch, but produces an index file for viewing in Office Excel instead of Internet Explorer. /zip Exports mail into generic mailbox files (mbox) and stores them in a standard ZIP file. Attachments and embedded contents are stored under subfolders in the ZIP file. The resulting ZIP file is compatible with all popular ZIP utilities, like WinZip, and with Windows Explorer under Windows XP or more recent. You must specify a target ZIP file name without wildcards (*, ?). If the target name already exists, Aid4Mail creates a backup of it and builds a new ZIP file. This switch is not required if your target name includes the .zip file extension.

Copyright 2005-2013 Fookes Holding Ltd

Reference Information

96

2.5.1.2.2 Email Contents Sw itches

This topic covers Aid4Mail Console optional command-line parameters that determine the target mail format. /extract Attachments contained in exported mail are extracted and saved under the "Attach" folder. The advantage of this method (RFC 1521) is that attachments are easily accessible and the resulting mail files are often much smaller. The disadvantage with this method is that many mail clients cannot access the extracted attachments. This switch is ignored if you're exporting mail to an IMAP account or the MSG format. /ExtractAll Attachments and embedded contents contained in exported mail are extracted and saved under two subfolders. Embedded contents (inline attachments) are saved under the "Embedded" folder and file attachments under the "Attach" folder. The advantage of this method (RFC 1521) is that attachments are easily accessible and the resulting mail files are often much smaller. The disadvantage with this method is that many mail clients cannot access these extracted attachments. This switch is ignored if you're exporting mail to an IMAP account or the MSG format. /lf=Mac OR UNIX OR Linux The line-format switch can have one of three values: "Mac", "UNIX", or "Linux". It is used when you export your email to EML or generic mailbox formats. Only use it if you plan to transfer your converted files to a non-Windows operating system. Aid4Mail will adjust the format of line endings of exported emails to suit the chosen operating system. /rich Attachments in exported mail are discarded. Only the message text, formatting, and embedded contents are preserved. This switch can significantly reduce the size of the exported mail. /plain Attachments and embedded contents (e.g. pictures, sounds) in exported mail are discarded. Only the plain message text with no formatting is preserved. Email headers are also simplified to preserve only the most important fields (like subject, date, sender, and recipients). Messages based on the UTF-8 character set are converted to plain ANSI characters based on the default Windows character set. In most cases, messages will be easier to read when UTF-8 is converted to ANSI. However, characters that do not exist in the default character set are converted to a question mark (?). If messages become unreadable because of this, then you should use the /utf8 switch described below instead of /plain. The / plain switch can significantly reduce the size of the exported mail. /utf8 This switch is similar to the /plain switch described above. The only difference is that UTF-8 characters are not converted to ANSI, they are preserved as-is. In most cases, messages will be easier to read when UTF-8 is converted to ANSI. However, characters that do not exist in the default character set are converted to a question mark (?). If messages become unreadable because of this, then you should use the /utf8 switch instead of /plain. The /utf8 switch can significantly reduce the size of the exported mail.
2.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.
Copyright 2005-2013 Fookes Holding Ltd

97

Aid4Mail 3 Help

Microsoft Exchange servers are particularly strict in this respect. To avoid email loss, Aid4Mail offers several options to control what happens to rejected emails: /BadImapMailFolder="folder name" Tells Aid4Mail where to locally save rejected emails. Use double quotes if the folder name contains spaces. The folder name can include tokens and system variables. This switch is only valid when used together with /SaveBadImapMail. /SaveBadImapMail Tells Aid4Mail to save a copy of rejected emails in EML format. The files are saved under the Mail subfolder in the folder specified by the /BadImapMailFolder switch. If no folder is defined, Aid4Mail then chooses the location of the target IMAP log file if set, or the Aid4Mail program folder. /ShrinkBadImapMail Many IMAP servers reject emails that are too big. You can use this switch to tell Aid4Mail to try again after extracting attachment from the rejected email. Extracted attachments are stored under the Contents subfolder in the parent folder of the EML files. This switch is only valid when used together with /SaveBadImapMail. 2.5.1.3 Filter Switches This topic covers Aid4Mail Console optional command-line parameters that control how source mail is filtered.

Filter emails by date


/dr=yyyy/mm/dd-yyyy/mm/dd Defines a date range filter based on the email received date based on the moment it reaches your mail server. With outgoing mail, the sent date is used instead of the received date. Dates use the international yyyy/mm/dd format (4-digit year/2-digit month/2-digit day). A hyphen is used to separate the two values that define the date range. The date on the left defines the start of the date range and the date on the right defines the end of the date range. You can leave out one of the date fields to include all messages at one end of the date-range spectrum. In the following example, Aid4Mail will only process emails that were received during year 2009: /dr=2009/01/01-2009/12/31 In the following example, Aid4Mail will only process emails that were received after year 2009: /dr=2010/01/01In the following example, Aid4Mail will only process emails that were received before year 2009: /dr=-2008/12/31 /ds=yyyy/mm/dd-yyyy/mm/dd This switch is nearly identical to the /dr switch described above except that it is based on the email sent date. This usually corresponds to the date stored in the message header Date field. You cannot use the /ds switch at the same time as the other date switches. /dc=yyyy/mm/dd-yyyy/mm/dd This switch is nearly identical to the /dr switch described above except that it is based on the mail client program's download date. You cannot use the /dc switch at the same time as the other date switches.

Copyright 2005-2013 Fookes Holding Ltd

Reference Information

98

Not all email client programs record the download date. When it is missing, Aid4Mail uses the email received or sent date instead. For emails that are stored as EML, MHT, or CNM files, Aid4Mail takes the download date from the file date stamp. However, this may not correspond to the actual download date.

Filter emails by text


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

Advanced filtering using scripts


/FilterScript="Script Name" Loads and then runs the specified script file. The script name can either be a fully qualified file name or just a file name without path and extension. If you leave out the file path, Aid4Mail will first look for the script in the "Scripts" subfolder and then the program folder. See the Writing Aid4Mail Scripts topic for more information about Filter Scripts.

Eliminate duplicate emails


/SkipAllDups /SkipAllDups="Incremental Log File" Skips duplicates of emails that have already been processed (across all folders). Note that checking for duplicates with this option usually decreases processing speed and uses more system memory, though the impact is usually minimal. You can specify a log file to keep track of which emails have been processed. A new log file is created if it doesn't exist. Before Aid4Mail processes a source email, it checks if a matching reference exists in

Copyright 2005-2013 Fookes Holding Ltd

99

Aid4Mail 3 Help

the log file. The email is skipped if it is listed. Otherwise, unless it is blocked by other filter settings, the email is processed and its reference is stored in the log file. This feature is useful for running incremental email exports. Note that a log file created with the /SkipAllDups option should not be used with the /SkipDups option. Email references are not generated the same way between these options so duplicates would not be identified. Aid4Mail checks for duplicates by comparing the value of the Message-ID field in each processed email header. If this field is empty or missing (usually in outbound only messages), Aid4Mail uses other header data for the comparison. In MAPI messages (from Office Outlook and Microsoft Exchange), Aid4Mail uses the email creation and submit dates, subject line, and stored message size. In other types of messages, Aid4Mail uses the email date and subject line for the comparison, or other header fields (To, Cc, Bcc, From delimiter) if either of those values are missing, or the whole header if none of those fields contain any data. /SkipDups /SkipDups="Incremental Log File" Skips duplicates of emails that have already been transferred to the target mail folder. This switch is ignored if /SkipAllDups is also used. Note that checking for duplicates with this option usually decreases processing speed and uses more system memory, though the impact is usually minimal. You can specify a log file to keep track of which emails have been processed. A new log file is created if it doesn't exist. Before Aid4Mail processes a source email, it checks if a matching reference exists in the log file. The email is skipped if it is listed. Otherwise, unless it is blocked by other filter settings, the email is processed and its reference is stored in the log file. This feature is useful for running incremental email exports. Note that a log file created with the /SkipDups option should not be used with the /SkipAllDups option. Email references are not generated the same way between these options so duplicates would not be identified. Aid4Mail checks for duplicates by comparing the value of the Message-ID field in each processed email header. If this field is empty or missing (usually in outbound messages), Aid4Mail uses other header data for the comparison. In MAPI messages (from Office Outlook and Microsoft Exchange), Aid4Mail uses the email creation and submit dates, subject line, and stored message size. In other types of messages, Aid4Mail uses the email date and subject line for the comparison, or other header fields (To, Cc, Bcc, From delimiter) if either of those values are missing, or the whole header if none of those fields contain 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 text file. The folder name can include tokens and system variables. If you omit the file name, Aid4Mail will create a log file stored in its program folder called ProcessLog.txt. /ErrorLog /ErrorLog="file name" See the topic Error Log File for details about this switch. The folder name can include tokens and
Copyright 2005-2013 Fookes Holding Ltd

Reference Information

100

system variables. /ImapLog Creates a log file storing all communications between Aid4Mail and an IMAP server. This feature is useful to identify issues encountered when connecting to an IMAP account or when uploading/ downloading messages to it. These log files are saved in the "My Documents" folder and use the .log file extension (unless you specified a fully qualified file name through the /S_Log and /T_Log switches). This switch is ignored when using /S_Log or /T_Log. /NoFilterLog If you are going to process large amounts of emails, you can slightly improve speed by using the / NoFilterLog switch. When added, this switch tells Aid4Mail to hide progress information related to skipped messages as a result of Aid4Mail's filter settings. /NoLimit Add the /NoLimit switch to your Aid4Mail command line if you need to run performance tests on an unlimited number of emails during trial mode. Using it removes the 50 emails per folder trial limitation and instead replaces all exported subject lines with a trial notice. Only use this switch during trial mode or else you will get a command-line error message. /QuitIfTrial Terminates program execution if Aid4Mail starts in trial mode. When this happens, Aid4Mail returns an EXIT code with a value of 6. /SessionName="session name" Use this switch to display a session name in the console window or the output file (if redirected). This feature helps you identify multiple simultaneous instances of the console. When used, Aid4Mail saves a text file with conversion statistics; the file name is based on the session name. The text file is saved in the program folder unless the session name includes a folder name to another location. The folder name can include tokens and system variables. Examples: /SessionName=Account072 /SessionName="%AllUsersProfile%\Aid4Mail Migration\Account 072" /stop Terminates program execution just before mail processing starts. This feature is useful to verify the validity of settings without processing mail. /temp="folder name" By default, Aid4Mail stores temporary files in the Windows Temp folder under the logon user folder. Use this switch to specify an alternative location for storing temporary files. The folder name can include tokens and system variables; example: /temp=%AllUsersProfile%\Aid4Mail\Temp /unattended Runs Aid4Mail without user intervention when an error occurs. This feature is particularly useful if you plan to run Aid4Mail Console in an uninterrupted batch process. If an error occurs, no user input is required (like press Enter key to continue) so batch operations can continue unattended.

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

Copyright 2005-2013 Fookes Holding Ltd

101

Aid4Mail 3 Help

To make it easier for you to create the INI file, simply rename the a4m.txt file stored in your Aid4Mail program folder to a4m.ini and open it in a text editor. Settings must be placed under the line with the "[Settings]" header. You can comment out a setting by placing a semi-colon (;) in front of it. Example: [Settings] ErrorLog=%MyDocs%\Aid4Mail Errors.txt IncludeAllItems=True IncludeTrash=True IncludeUnpurged=True SkipDuplicates=none ; this line and the following is commented out ;TempFolder=C:\Temp\

See the following topics for a list of available INI file settings used to control the mail conversion process: Source Settings Target Settings Filter Settings Other Settings 2.5.2.1 Source Settings This page lists settings you can use in the Aid4Mail Console INI file to control the handling of source mail. DelSource =Fast or False Use this setting to permanently delete source messages that have been successfully processed. The delete feature works on the following source formats: IMAP accounts, MAPI profiles ("Default message store" only), PST, MSG, and EML files, and Mozilla mailboxes (including Thunderbird, SeaMonkey, Eudora OSE, and Netscape). This feature is turned off by default. Only use it with the greatest care as in most cases you will not be able to undelete your processed source messages. We strongly recommend that you first only test this feature on data that you can fully restore from backups to ensure no valuable mail is lost. The /DelSource command-line switch overrides this setting. When using the DelSource setting, YOU AGREE TO RELEASE FOOKES SOFTWARE AND ITS SUPPLIERS FROM ANY LIABILITY OR DAMAGES DUE TO THE LOSS OF ANY SUCH DATA OR FILES. emlExt=ext Use this setting if you need to process EML files that do not have the standard .eml file extension. Set the "ext" value either to the corresponding file extension or use "*" to accept any file extension. The / emlExt command-line switch overrides this setting. Example: emlExt=txt ImapSource =FileName.ini Tells Aid4Mail where to find the logon settings file for your source IMAP account. If no file path is specified, Aid4Mail looks for it in its program folder. Tokens and system variables are supported. If this setting is not used, Aid4Mail will look for the source.imap.ini file in the same folder as the a4m.exe program file. Example: ImapSource=%MyData%\IMAP Settings.ini IncludeAllItems=True or False Use this setting when processing Office Outlook mail to include Calendar, Contacts, Tasks, and other non-email items during the export. By default, Aid4Mail will only process email items. The /
Copyright 2005-2013 Fookes Holding Ltd

Reference Information

102

IncludeAllItems command-line switch overrides this setting. IncludeTrash=True or False Use this setting to process mail stored in the Trash, Junk, and Deleted Items folders. The names of such folders are stored in the files TrashFiles.dat and TrashFolders.dat that you will find in the Aid4Mail program folder. You can add more folder names to these two files if necessary (one name per line). The TrashFolders.dat file is for message folder names created by MAPI clients like Office Outlook. Aid4Mail uses the names stored in TrashFiles.dat to determine which mailbox files from other mail clients contain deleted or unwanted messages. By default, mail in these folders is ignored. The /IncludeTrash command-line switch overrides this setting. IncludeUnpurged=True or False Use this setting to process moved and deleted items found in mailbox files and folders that haven't been compacted or expunged. These email items are not usually visible in your mail client. Note that if you use this option with Outlook Express .dbx files, processed messages all have a certain degree of corruption as the deletion process partially damages the remaining email. By default, Aid4Mail skips messages that have been marked as deleted from a mailbox. The /IncludeUnpurged command-line switch overrides this setting. SearchSubFolders=True or False Tells Aid4Mail whether to search subfolders at the location pointed by the Source criteria. This option is on by default so you only need to include this setting if you want to ignore subfolders. The /s commandline switch overrides this setting. SkipDuplicates=none or folder or all Use this setting to discard duplicates of emails that have already been saved in the target mail folder. Use the "folder" value to check for duplicates at the folder level only and the "all" value to check for duplicates irrespective of the target folder. By default, Aid4Mail does not skip duplicates. Note that checking for duplicates with this option may decrease processing speed and require more system resources. The /SkipDups and /SkipAllDups command-line switches override this setting. Aid4Mail checks for duplicates by comparing the value of the Message-ID field in each processed email header. If this field is empty or missing (usually in outbound messages), Aid4Mail uses other header data for the comparison. In MAPI messages (from Office Outlook and Microsoft Exchange), Aid4Mail uses the email creation and submit dates, subject line, and stored message size. In other types of messages, Aid4Mail uses the email date and subject line for the comparison, or other header fields (To, Cc, Bcc, From delimiter) if either of those values are missing, or the whole header if none of those fields contain any data. SkipDuplicatesFile =Incremental Log File You can specify a log file to keep track of which emails have been processed. A new log file is created if it doesn't exist. Before Aid4Mail processes a source email, it checks if a matching reference exists in the log file. The email is skipped if its reference is found. Otherwise, if it isn't blocked by other filter settings, the email is processed and its reference is stored in the log file. This feature is useful when you need to perform incremental email exports. You must set the SkipDuplicates option to "folder" or "all" otherwise this setting will be ignored. Note that a log file created with the SkipDuplicates FOLDER option should not be used with the SkipDuplicates ALL option, and vice versa. Email references are not generated the same way under each option so matches would not be recognized. SourceFormat=format Use this setting if Aid4Mail fails to correctly identify your source mail format. The /m command-line
Copyright 2005-2013 Fookes Holding Ltd

103

Aid4Mail 3 Help

switch overrides this setting. The following values are available: QuickCheck - use for less in-depth automatic format checking. Useful if source files have an unusual format mbox - use if source is a generic mailbox file (mbox, Berkeley mail format, BSD mail format, Unix mail format) pine - use if source is a Pine mbox file with limited "From " escaping moz - use if source is Mozilla Mail, Thunderbird, or Netscape eudora - use if source is a Eudora MBX file mc_eudora - use if source is a Macintosh Eudora mailbox file calypso - use if source is Calypso Mail or Courier maildir - use if source represents Maildir folders eml - use if source represents eml mail files outlook_msg - use if source represents Office Outlook msg mail files pmmail_msg - use if source represents PMMail msg mail files SourceMail=file name or specs, or "mapi" or "imap" tokens The value can represent a token (mapi or imap), or a PST, MSG, EML, Mozilla or other generic mailbox file name or search criteria (allows the wildcards "*" and "?"). Tokens and system variables are supported in the path name. Use the "mapi" token to access a MAPI profile; the default profile is used if no profile name is specified with the MapiProfile setting or the /n switch. Use the "imap" token to retrieve email from an IMAP account. The account logon settings are taken from the source.imap.ini file (located in the program folder), which you must modify beforehand. When using the "mapi" and "imap" tokens, you can specify the name of the folder you want to export from. Simply use a colon (:) after the token name followed by the folder path using a backslash to separate folder names. Wildcards are supported. Example. SourceMail=imap:INBOX\Archives\* SourceNamespace =IMAP Namespace Defines the Namespace for the source IMAP account. The /S_Namespace command-line switch overrides this setting. SourcePassword=password Use this setting to specify a password for the source PST file or IMAP account. The /S_PW commandline switch overrides this setting. PST files: Note that this password has nothing to do with the profile password, which MAPI will prompt you to enter in a separate dialog box. IMAP accounts: if the SourcePassword setting and /S_PW switch are not used, Aid4Mail takes the password from the source imap.ini file. SourceUserName =Logon User name Use this setting to specify the logon user name for the source IMAP account. The /S_UserId commandline switch overrides this setting. If the SourceUserName setting and /S_UserId switch are not used, Aid4Mail takes the user name from the source imap.ini file. SourceProfile =MAPI profile name SourceProfile =IMAP INI file
Copyright 2005-2013 Fookes Holding Ltd

Reference Information

104

If your source mail is defined by the "mapi" token, use this setting to specify a profile name for your source MAPI account if it is different from your default profile name. The /S_Profile command-line switch overrides this setting. If your source mail is defined by the "imap" token, this setting tells Aid4Mail where to find the logon settings file for your source IMAP account. If no file path is specified, Aid4Mail looks for it in its program folder. Tokens and system variables are supported. If this setting is not used, Aid4Mail will look for the source.imap.ini file in the same folder as the a4m.exe program file. The /S_Profile command-line switch overrides this setting. UnzipSource =True or False Tells Aid4Mail whether source mail is contained in a ZIP file that needs to be unzipped prior to processing. Do not use this setting with Aid4Mail ZIP Archives. 2.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 tab Exports extracted email addresses to the specified file format. Aid4Mail automatically removes duplicates and sorts addresses in alphabetical order. You can specify the most appropriate output format after the equal sign: comma separated values (*.csv), tab separated values (*.tab), and plain-text values (*.txt). By default, Aid4Mail uses the plain-text format. The /Addresses command-line switch overrides this setting. AddWinmailDat=True or False When UseMapiTnefConverter and AddWinmailDat are set to True, TNEF data is saved in a winmail.dat attachment when converting mail to the RFC 1521 format. Set to False if you do not wish to create winmail.dat attachments. The /AddWinmailDat command-line switch overrides this setting. AppendMail=True or False Appends message to target mailbox file if it already exists. If this switch is not used, a backup copy of the mailbox file is made before the export procedure starts. This option is ignored if you are exporting to Outlook or Exchange profile, EML, MHT, XLS, DBS, and MSG files. By default, Aid4Mail does not append messages to an existing mailbox. The /a command-line switch overrides this setting. BadImapMailFolder=folder name Tells Aid4Mail where to locally save emails rejected by the target IMAP server. The folder name can include tokens and system variables. This option is only valid when used together with the SaveBadImapMail option. ExportFormat=format Defines the target format of exported messages. By default, Aid4Mail restores the full email contents on export. The /extract, /ExtractAll, /rich, /plain, and /utf8 command-line switches override this setting. Available format values and their purpose are listed below: full The full email contents are restored on export. extract Attachments contained in exported mail are extracted and saved under the "Attach" folder. The advantage of this method (RFC 1521) is that attachments are easily accessible and the resulting mail files are often much smaller. The disadvantage with this method is that many mail clients cannot access
Copyright 2005-2013 Fookes Holding Ltd

105

Aid4Mail 3 Help

the extracted attachments. This value is ignored if you are exporting mail to an IMAP account or the MSG format. ExtractAll Attachments and embedded contents contained in exported mail are extracted and saved under two subfolders. Embedded contents (inline attachments) are saved under the "Embedded" folder and file attachments under the "Attach" folder. The advantage of this method (RFC 1521) is that attachments are easily accessible and the resulting mail files are often much smaller. The disadvantage with this method is that many mail clients cannot access these extracted attachments. This value is ignored if you are exporting mail to an IMAP account or the MSG format. rich Attachments in exported mail are discarded. Only the message text, formatting, and embedded contents are preserved. This value can significantly reduce the size of the exported mail. plain Attachments and embedded contents (e.g. pictures, sounds) in exported mail are discarded. Only the plain message text with no formatting is preserved. Email headers are also simplified to preserve only the most important fields (like subject, date, sender, and recipients). Messages based on the UTF-8 character set are converted to plain ANSI characters based on the default Windows character set. In most cases, messages will be easier to read when UTF-8 is converted to ANSI. However, characters that do not exist in the default character set are converted to a question mark (?). If messages become unreadable because of this, then you should use the utf8 value described below instead of plain. The plain value can significantly reduce the size of the exported mail. utf8 This value is similar to the plain value described above. The only difference is that UTF-8 characters are not converted to ANSI, they are preserved as-is. In most cases, messages will be easier to read when UTF-8 is converted to ANSI. However, characters that do not exist in the default character set are converted to a question mark (?). If messages become unreadable because of this, then you should use the utf8 value instead of plain. The utf8 value can significantly reduce the size of the exported mail. ExportSingleFolder=True or False Depending on the criteria that you use, Aid4Mail creates subfolders in the target folder to match the source folder structure. If you do not want exported mail files split up into several subfolders, set the ExportSingleFolder value to True to force Aid4Mail to store all files in a single disk folder. Note that when TargetFormat is set to xls, all email items are grouped into a single worksheet page. This setting is ignored if TargetFormat is set to mht or dbs. The /t command-line switch overrides this setting. HeaderBasedMd5Names=True or False When False, the MD5 signature for EML and MHT file names is computed from the full email (message header + body). When True, the MD5 signature is based on the Message-ID field value. If this field is empty or missing (usually in outbound messages), Aid4Mail generates the signature from the email date and subject line, or other fields (To, Cc, Bcc, From delimiter) from the message header if either of those values are blank, or the whole header. This setting was introduced in Aid4Mail 2.11 and is True by default. LineFormat=windows or mac or unix The LineFormat setting controls the type of line break characters Aid4Mail uses to create EML or generic mailbox formats. It can have one of three values: "Mac", "UNIX", or "Windows". By default Aid4Mail uses the Windows line format. Only use other values if you plan to transfer your converted files to a non-Windows operating system. Aid4Mail will adjust the format of line endings of exported emails to suit the chosen operating system. The /Lf command-line switch overrides this setting.
Copyright 2005-2013 Fookes Holding Ltd

Reference Information

106

MapiConvOff=True or False Under Outlook 2003 and more recent, Aid4Mail uses a MAPI function to convert mail between RFC textbased formats (MIME) and proprietary Outlook PST and MSG files, and Exchange server store formats. The advantage of this method is that it converts messages with non-Latin characters and certain special email types more reliably than the alternative method. The disadvantage of this MAPI function is that it is usually slower than the other Aid4Mail method. Set MapiConvOff to True to turn off the special MAPI conversion feature. The /MapiConvOff command-line switch overrides this setting. MapiFixOff=True or False When converting mail from Outlook PST and MSG files, and Exchange server store formats to RFC textbased formats (MIME), Aid4Mail performs a series of fixes on the messages converted by MAPI. These fixes are necessary to make the converted email as faithful as possible to the original email and avoid loss of data. The disadvantage of this procedure is that it slows down conversion and in some very rare cases some emails don't convert correctly. Set MapiFixOff to True to turn off the email fixing feature. The /MapiFixOff command-line switch overrides this setting. MapiTarget=profile name Use this switch to specify a profile name for your target MAPI account if it is different from your default profile name. This switch is only valid if the "mapi" token is used for the target mail. The /MapiTarget command-line switch overrides this setting. MD5name =True or False Use this setting to produce MSG, EML, and MHT files with an MD5 signature as file name. This switch only works with the msg, eml, and mht TargetFormat values. By default Aid4Mail creates file names based on the message subject line. Set MD5name to True to use MD5 names. The method used to calculate MD5 values depends on the HeaderBasedMd5Names setting. With Outlook MSG files, the MD5 signature is based on the unique Message-ID field, which is normally present in the header of all received email messages. If this field is empty or missing (usually in outbound messages), Aid4Mail uses the email creation and submit dates, subject line, and stored message size. The /MD5name command-line switch overrides this setting. OutputScript=Script Name Use this setting to load the specified script name. The script name can either be a fully qualified file name or just a file name without path and extension. See the Writing Aid4Mail Scripts topic for more information on Output Scripts. The /OutputScript command-line switch overrides this setting. PstDisplayName =PST display name Use this setting to define a display name when exporting to a new PST file. By default, Aid4Mail creates a name like "Imported Folders (July 01, 2012)" when this setting is not used. The /PstDisplayName command-line switch overrides this setting. SaveBadImapMail=True or False Tells Aid4Mail to save a copy of emails rejected by the target IMAP server in EML format. The files are saved under the Mail subfolder in the folder specified by the BadImapMailFolder option. If no folder is defined, Aid4Mail then chooses the location of the target IMAP log file if set, or the Aid4Mail program folder. ShrinkBadImapMail=True or False Many IMAP servers reject emails that are too big. You can use this switch to tell Aid4Mail to try again
Copyright 2005-2013 Fookes Holding Ltd

107

Aid4Mail 3 Help

after extracting attachment from the rejected email. Extracted attachments are stored under the Contents subfolder in the parent folder of the EML files. This option is only valid when used together with the SaveBadImapMail option. TargetFormat=format Use this setting to define the target mail format if this information cannot be determined from your target name. The /pst, /unicodepst, /msg, /eml, /mbox, /moz, /dbs, /mht, /xls, /zip, /imap, /attachments, / contents, /addresses command-line switches override this setting. The following format values are available: mbox exports the mail into an mbox-compatible (generic) mailbox file. This export option is used by default if none of the export format switches are specified and the target name has a different extension from .eml, .mht, .msg, .pst, .zip. moz exports the source mail into a Mozilla-compatible mailbox file (Netscape, Mozilla, Thunderbird). pst exports the source mail into a standard Outlook PST file (ANSI format). This type of PST file has a maximum storage capacity of 2 GB and is compatible with all versions of Office Outlook. This switch is ignored if you use the "mapi" token (to access a MAPI profile) as the Target value. unicodepst exports the source mail into a Unicode PST file (Outlook 2003 or newer). This type of PST file has a maximum storage capacity of 20 GB in Outlook 2003 and 2007, 50 GB in Outlook 2010 and 2013, and is not compatible with Outlook 97, 98, 2000, and 2002. Note that this switch will create a regular ANSI PST file if your version of Microsoft Outlook is older than Outlook 2003. This switch is ignored if you use the "mapi" token (to access a MAPI profile) as the Target value. msg exports each MAPI source mail into a corresponding MSG file. The source must be a PST file or a MAPI mail profile. This switch cannot be used if the source is also MSG files. eml exports each source message into a corresponding EML file. Aid4Mail also saves a Mail.tab file in the target folder, which contains a tab-delimited list of all the exported EML files (useful if you want to import mail in a database.) This setting is not required if you specify a target name with the .eml extension. mht exports each source mail into a corresponding MHT file (HTML Web Archive). The format is similar to EML files. MHT files can be viewed in Internet Explorer like a regular HTML file; embedded pictures are displayed in the browser window and attachments can be extracted by clicking on their link. Aid4Mail automatically creates web pages that enable you to easily view your converted mail in Internet Explorer; just open the file index.html in your browser. This setting is not required if you specify a target name with the .mht extension. xls similar to the mht value, but produces an index file for viewing in Office Excel instead of Internet Explorer. dbs similar to the mht value, but produces an index file for importing mail data into a database.
Copyright 2005-2013 Fookes Holding Ltd

Reference Information

108

attachments exports only the file attachments contained in the processed source mail. Aid4Mail also saves an Attach.tab file in the target folder, which contains a tab-delimited list of all the extracted attachment files. contents exports only the file attachments and embedded contents contained in the processed source mail. Embedded contents (inline attachments) are saved under the "Embedded" folder and file attachments under the "Attach" folder. Aid4Mail also saves an Attach.tab file in the target folder, which contains a tab-delimited list of all the extracted files. addresses exports extracted email addresses extracted from source messages. Aid4Mail automatically removes duplicates and sorts addresses in alphabetical order. pdf exports mail to Adobe PDF file(s). By default, the PDF format options are taken from the pdf.ini file in the program folder. You can specify a different configuration file through the TargetProfile setting or the / T_Profile command-line switch. Note that due to third-party licensing terms, the server edition of Aid4Mail Console currently does not include the PDF export option. zip exports mail into generic mailbox files (mbox) and stores them in a standard ZIP file. Attachments and embedded contents are stored under subfolders in the ZIP file. The resulting ZIP file is compatible with all popular ZIP utilities, like WinZip, and with Windows Explorer under Windows XP or more recent. You must specify a target ZIP file name without wildcards (*, ?). If the target name already exists, Aid4Mail creates a backup of it and builds a new ZIP file. This setting is not required if you specify a target name with the .zip extension. TargetMail=file or folder name, "mapi", or "imap" token Use this setting to define a target file or folder name receiving exported mail. Tokens and system variables are supported. If you choose to export mail to the EML or MSG format, TargetMail should represent a folder. If you export to an mbox format, TargetMail can either represent a folder or file name. If the target name ends with a backslash (\), the contents of each mail folder is stored into its own mbox file with a name matching that of the mail folder. If you want the exported files to use the same name as the source files, but with a different extension, use the asterisk wildcard followed by the extension. Example: *.txt -> files are created with the name of the source file and the TXT extension. Use the "mapi" token to access a MAPI profile; the default profile is used if no profile name is specified with the MapiProfile setting or the /n switch. Use the "imap" token to export email to an IMAP account. The account logon settings are taken from the target.imap.ini file (located in the program folder), which you must modify beforehand. When using the "imap" token, you can specify the name of the folder you want to export to. Simply use a colon (:) after the token name followed by the folder path using a backslash to separate folder names. Example. TargetMail=imap:INBOX\Imports 2012\ If you are exporting EML, MHT, or MSG files to the EML format, you can use the {filename} token to instruct Aid4Mail to create target message files that have the same name as the source mail files. TargetNamespace =IMAP Namespace Defines the Namespace for the target IMAP account. The /T_Namespace command-line switch overrides this setting.
Copyright 2005-2013 Fookes Holding Ltd

109

Aid4Mail 3 Help

TargetPassword=password Use this setting to specify a password for the target PST file or IMAP account. The /T_PW commandline switch overrides this setting. PST files: the password will create a new password-protected PST file or allow adding mail to an existing password-protected PST file. When you create a password-protected ANSI PST file with Aid4Mail, the high encryption format is used if the password exceeds 8 characters and the weaker compressibleencryption format is used with shorter passwords. With Unicode PST files, the default compressibleencryption format is used (high encryption is not supported.) Note that this password has nothing to do with the profile password, which MAPI will prompt you to enter in a separate dialog box. IMAP accounts: if the TargetPassword setting and /T_PW switch are not used, Aid4Mail takes the password from the target imap.ini file. TargetPstFolder=folder name Defines the base folder (or parent folder) in a PST file or Outlook email profile that will receive exported mail. This setting is ignored if you are exporting to other mail formats. Use a backslash "\" character to separate folder names in a path. The /b command-line switch overrides this setting. TargetPstMaxSize =size in GB or MB If you think your export will exceed the capacity of a single PST file, you can use TargetPstMaxSize to set a threshold value. Setting the value to zero or leaving it blank instructs Aid4Mail to not monitor the PST file size. Otherwise, Aid4Mail treats values equal to or below 500 as representing gigabytes (GB) and values above as megabytes (MB). When the size limit is reached, Aid4Mail stops exporting mail to the current PST file, creates a new PST file based on the name of the first one but with an index number, and then continues the mail export to the new PST file. The /T_PstSize command-line switch overrides this setting. For example, if you set the size limit to 2 GB for a file called Outlook.pst and have 5 GB of mail to export, Aid4Mail will create the following files on completion: Outlook.pst Outlook[001].pst Outlook[002].pst Note that Aid4Mail cannot determine exactly when the limit is reached because Outlook uses a data cache. In other words, Outlook will still send data to the PST file after Aid4Mail has measured the file size and stopped exporting mail to it. As a result, a PST file may slightly exceed the size limit you set. To avoid problems, choose a smaller size that ensures your PST file will never get too big. TargetUserName =Logon User name Use this setting to specify the logon user name for the target IMAP account. The /T_UserId commandline switch overrides this setting. If the TargetUserName setting and /T_UserId switch are not used, Aid4Mail takes the user name from the target imap.ini file. TargetProfile =MAPI profile name TargetProfile =IMAP INI file TargetProfile =PDF INI file If your target mail is defined by the "mapi" token, use this setting to specify a profile name for your target MAPI account if it is different from your default profile name. The /T_Profile command-line switch overrides this setting. If your target mail is defined by the "imap" token, this setting tells Aid4Mail where to find the logon settings file for your target IMAP account. If no file path is specified, Aid4Mail looks for it in its program
Copyright 2005-2013 Fookes Holding Ltd

Reference Information

110

folder. Tokens and system variables are supported. If this setting is not used, Aid4Mail will look for the target.imap.ini file in the same folder as the a4m.exe program file. The /T_Profile command-line switch overrides this setting. If your target is a PDF file, this setting tells Aid4Mail where to find the PDF settings file. If no file path is specified, Aid4Mail looks for it in its program folder. Tokens and system variables are supported. If this setting is not used, Aid4Mail will look for the pdf.ini file in the same folder as the a4m.exe program file. The /T_Profile command-line switch overrides this setting. TimeZone =value Use this setting to change the default time zone Aid4Mail uses when setting the date stamp of exported message files and date values in the corresponding column of MHT target formats. The switch accepts a time zone value in one of several formats: numerical, time zone abbreviation, time zone in short form, or Windows registry time-zone name. See the Time Zones topic for more information. The /TimeZone command-line switch overrides this setting. Example: TimeZone=PST UseDateField=True or False By default, incoming message dates used for creating file date stamps (eml, mht, msg, extracted attachments) and Microsoft Exchange delivery time are based on the server Received date instead of the header Date field. Set UseDateField to True to instruct Aid4Mail to extract the date from the message Date field instead of the server Received date. The /UseDateField command-line switch overrides this setting. UseMapiTnefConverter=True or False Prior to Aid4Mail v2.1, both TNEF and regular emails were processed by the MAPI RFC 1521 Converter when the MapiConvOff setting was False. The MAPI RFC 1521 Converter does a good job converting regular emails to the standards-compliant RFC 1521 format, but it produces poor results with TNEF messages (to avoid data loss Aid4Mail always saved the TNEF information in a winmail.dat attachment). For better results, set this option to False to use Aid4Mail's own converter whenever a TNEF email is encountered. The /UseMapiTnefConverter command-line switch overrides this setting. XMailer=value When converting outgoing mail from Outlook or Exchange, Aid4Mail has to reconstruct the email header during the conversion procedure. To easily identify such headers, Aid4Mail inserts a standard X-Mailer field with the value "FOOKES SOFTWARE Aid4Mail (MAPI source mail)". You can define an alternative value through the XMailer setting. If the value is left blank then Aid4Mail will not insert the X-Mailer field in reconstructed email headers. 2.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 Stored This setting is used in conjunction with the FilterDateRange setting. It tells Aid4Mail which date field to use when filtering emails by date. By default, Aid4Mail uses the Sent date. The /ds, /dr, /dc commandline switches override this setting. FilterDateRange =yyyy/mm/dd-yyyy/mm/dd Defines a date range filter. Dates use the international yyyy/mm/dd format (4-digit year/2-digit month/2digit day). A hyphen is used to separate the two values that define the date range. The date on the left defines the start of the date range and the date on the right defines the end of the date range. You can leave out one of the date fields to include all messages at either end of the date-range spectrum. The / ds, /dr, /dc command-line switches override this setting.
Copyright 2005-2013 Fookes Holding Ltd

111

Aid4Mail 3 Help

In the following example, Aid4Mail will only process emails that were received during year 2009: FilterDateRange=2009/01/01-2009/12/31 In the following example, Aid4Mail will only process emails that were received after year 2009: FilterDateRange=2010/01/01In the following example, Aid4Mail will only process emails that were received before year 2009: FilterDateRange=-2008/12/31 FilterExclude =Words list file name Use this setting to filter mail by contents. Aid4Mail loads the words list from the specified file and searches each email for a match. Emails that contain any of the text criteria in the list are not processed. By default, Aid4Mail only searches the email header. You can extend the search to the message text by using the FilterScope setting described below. See the Words List File topic to learn how to create such a file. You cannot use both the Include and Exclude settings at the same time. The / FilterExclude and /FilterInclude command-line switches override this setting. FilterInclude =Words list file name Use this setting to filter mail by contents. Aid4Mail loads the words list from the specified file and searches each email for a match. Emails that do not contain any of the text criteria in the list are not processed. By default, Aid4Mail only searches the email header. You can extend the search to the message text by using the FilterScope setting described below. See the Words List File topic to learn how to create such a file. You cannot use both the Include and Exclude settings at the same time. The / FilterExclude and /FilterInclude command-line switches override this setting. FilterScope =All or Message or Header or Raw Only use this setting if you have defined a Words List with the Include or Exclude setting. The FilterScope setting can have one of three values: "All", "Message", "Header" or "Raw". Use the "All" value to search through both the email header and the message text, the "Message" value to search through the subject line and message text, and "Header" to search through the email header only. Use "Raw" to search through the whole email in MIME format; this option is useful if you want to search for specific content types. By default, only the email header is searched. Note that searching through the message text can significantly slow down the filtering process. The /FilterScope command-line switch overrides this setting. FilterScript=Script Name Use the FilterScript setting to load the specified script name. The script name can either be a fully qualified file name or just a file name without path and extension. See the Writing Aid4Mail Scripts topic for more information about Filter Scripts. The /FilterScript command-line switch overrides this setting. NoFilterLog=True or False If you are going to process large amounts of emails, you can improve speed slightly by setting the NoFilterLog to True. When true, Aid4Mail stops showing progress information on messages that are skipped as a result of the Aid4Mail filter settings. The /NoFilterLog command-line switch overrides this setting. 2.5.2.4 Other Settings This page lists miscellaneous settings you can use in the Aid4Mail Console INI file to control mail conversion. ErrorLog=FileName
Copyright 2005-2013 Fookes Holding Ltd

Reference Information

112

See the Error Log File topic for details about this switch. The /ErrorLog command-line switch overrides this setting. Fast=True or False Aid4Mail does extensive text parsing and format analysis when reading generic mailbox files, including those created by Mozilla Thunderbird and Eudora. It does so to ensure it doesn't miss any emails when processing mailbox files that contain a mix of storage formats (e.g. a Mac or Unix mbox file imported in Windows Thunderbird with new messages added to it). If you are processing mailbox files that are entirely created by a single mail client, then you can increase performance without sacrificing reliability by setting Fast to True. The /Fast command-line switch overrides this setting. ImapLog=True or False Set this option to True to create a log file storing all communications between Aid4Mail and an IMAP server. This feature is useful to identify issues encountered when connecting to an IMAP account or when uploading/downloading messages to it. These log files are saved in the "My Documents" folder and use the .log file extension. NoLimit=True or False Set this option to True if you need to run performance tests on an unlimited number of emails during trial mode. Using this feature removes the 50 email/folder trial limitation and instead replaces all exported subject lines with a trial notice. The /NoLimit command-line switch overrides this setting. QuitIfTrial=True or False Set this option to True to terminate program execution if Aid4Mail starts in trial mode. If such a termination occurs, Aid4Mail returns an EXIT code with a value of 6. The /QuitIfTrial command-line switch overrides this setting. SessionName =session name Use this option to display a session name in the console window or the output file (if redirected). This feature helps you identify multiple simultaneous instances of the console. The /SessionName commandline switch overrides this setting. When used, Aid4Mail saves a text file with conversion statistics; the file name is based on the session name. The text file is saved in the program folder unless the session name includes a folder name to another location. The folder name can include tokens and system variables. Examples: SessionName=Account072 SessionName=%AllUsersProfile%\Aid4Mail Migration\Account 072 TempFolder=folder name By default, Aid4Mail stores temporary files in the Windows Temp folder under the logon user folder. Use this setting to specify an alternative location for storing temporary files. The folder name can include Tokens and system variables. The /Temp command-line switch overrides this setting. Example: TempFolder=%AllUsersProfile%\Aid4Mail\Temp Unattended=True or False Set this option to True to run Aid4Mail without user intervention. This feature is particularly useful if you plan to run Aid4Mail Console in an uninterrupted batch process. If an error occurs, no user input is required (like press Enter key to continue) so batch operations can continue unattended. The / Unattended command-line switch overrides this setting.

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 each processed message. The list should contain one search criteria per line. The longer the list, the longer it

Copyright 2005-2013 Fookes Holding Ltd

113

Aid4Mail 3 Help

will take Aid4Mail to filter each email. You can improve performance by placing the most common search terms at the beginning of the list. Matching is case sensitive for lines that have one or more uppercase characters, and case insensitive for lowercase search criteria. A match only occurs if the search criteria covers whole words. For example, if your search criteria is "spam" (without the quotes), it will match the word "SPAM", but not "spammer". The search criteria "FREE" will only match the word "FREE", but not "free" or "FREEWAY". The search criteria "jane doe" will match "Jane Doe" and "JANE DOE", but not "Jane M. Doe". You can negate the effect of a text criteria by starting it with a minus character (-). If you must start a regular search criteria with a minus or hyphen character, just add a second one to cancel the negate effect. A match with a negate criteria will reject a message if the "found in header" option is set, and will accept the message if the "not found in header" option is set. You can start a text criteria with a plus character (+) to instruct Aid4Mail to combine it with the previous criteria. If you must start a regular search criteria with a plus character, just add a second one to cancel the addition effect. If the "found in header" option is set, the message is only accepted if it contains occurrences of the preceding and current criteria. If the "not found in header" option is set, the message is only rejected if it contains occurrences of both the preceding and current criteria. Note that the plus character is ignored if it follows a negate criteria. See example #3 below. Matching Words with Wildcards Aid4Mail also supports wildcards and regular expressions in the word list feature. The regular expression engine is based on PCRE 8.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 starts with "N=" or "R=" (without the quotes). The following wildcards are supported: * matches 0 or more word characters. Example: "jo*" matches "Jo", "John", "Jody", "joint", "join_leave". # matches 0 or more word characters, including HTML entity characters. Example: "na#" matches "nave", "na&iuml;ve", and "na&#239;ve". ** matches 0 or more characters and can span across words within a line. Example: "click**link" matches "click link", "click on link", "clicking on link", "Click on this link", but not "click on links". ? matches exactly one word character. Example: "jo?" matches "Job" and "jot", but not "Jo", "John", "Jody", and "joint". ~ matches 0 or one word characters. Example: "jo~" matches "Jo", "Job", and "jot", but not "John", "Jody", and "joint". & matches exactly one word character or one HTML entity. Example: "caf&" matches "caf", "caf&eacute;", and "caf&#233;". Note that word characters include alphanumeric characters, all extended ANSI characters, as well as
Copyright 2005-2013 Fookes Holding Ltd

Reference Information

114

"_". You can set or override the type of search performed by starting a line with a token character followed by an equal sign. The following are recognized: N= W= R= produces a normal search produces a wildcard search produces a regular-expression search

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

Words list example #2: FREE mortgage~ home owner~ pharma* pill~ prescr?pt??n~ spam@fookes.com @adpromailer.com @emailfactory R=free (bonus|debt|loan|money) R=c(i|1)(a|@)l(i|1)s R=v(i|1)(a|@)gr(a|@) R=x(a|@)n(a|@)x Aid4Mail will reject all messages that have any of the listed search criteria. The above list includes criteria with wildcards and regular expression patterns. Words list example #3: important@fookes.com +aid4mail important@fookes.com +mailbag assistant Aid4Mail will only accept messages that were sent to the <important@fookes.com> address and mention either the aid4mail or mailbag assistant products in the email.

2.5.4

Processing a List of Files


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

Copyright 2005-2013 Fookes Holding Ltd

115

Aid4Mail 3 Help

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

2.5.5

Exit Codes
Aid4Mail Console produces one of the following Exit Codes when it terminates processing: 0= 1= 2= 3= 4= 5= 6= 7= 8= 9= no error detected command-line error source file not found or format not recognized one or more errors occurred during mail processing (see error log for details) could not run console or unexpected fatal error no messages found in source location program terminated in response to the QuitIfTrial setting no messages due to error accessing source account or mailbox no messages due to error accessing target account or mailbox 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% token tells Aid4Mail to look for the Outlook Express DBX files in the default storage location.
a4m.exe %OE%\*.dbx mapi /b="Imported Mail"

Copyright 2005-2013 Fookes Holding Ltd

Reference Information

116

Similar to the previous example except that the source folder hierarchy is created under the Outlook or Exchange "Imported Mail" folder (which is created if it doesn't exist) instead of the root folder. This approach ensures imported mail is not mixed with current mail.
a4m.exe %OE%\*.dbx mapi /T_Profile="John Doe" /b="Imported Mail"

Similar to the previous example except that mail is exported to the "John Doe" email profile instead of the default profile.
a4m.exe %OE%\*.dbx %Outlook%\Outlook.pst /a /T_PstSize=20

Imports mail from Outlook Express and appends it to the default Outlook.pst file. The %OE% token tells Aid4Mail to look for the Outlook Express DBX files in the default storage location. When the target PST file reaches a size of 20 GB, Aid4Mail stops transferring mail to it, creates a new Outlook[001].pst file and resumes mail export to the new PST until the size limit is reached, and so on.
a4m.exe "T:\Thumbdrive Data\*.dbx" %Outlook%\OE.pst /IncludeTrash /IncludeUnpurged

Exports all Outlook Express messages, including unpurged and deleted mail, from the "T:\Thumbdrive Data\" folder and stores them in the OE.pst file under the default Outlook files folder. Once completed, you can open the OE.pst file through the File/Open/Outlook Data File menu command in Microsoft Outlook (older versions of Outlook may use slightly different names for the menu command.)
a4m.exe "\\PC1\Outlook Express\*.dbx" "\\PC2\Outlook Files\OE Mail.pst" Exports messages contained in the DBX mailbox files under the "Outlook Express" folder on PC1 to

the "OE Mail.pst" file on PC2.

2. Thunderbird to Outlook or Exchange


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

Imports locally stored mail (not IMAP folders) from Thunderbird and appends it to the default Outlook email profile. The %Thunderbird% token tells Aid4Mail to look for the Thunderbird mailbox files in the default storage location.
a4m.exe %Thunderbird%\*.* mapi /m=moz /b="Imported Mail"

Similar to the previous example except that the source folder hierarchy is created under the Outlook or Exchange "Imported Mail" folder (which is created if it doesn't exist) instead of the root folder. This approach ensures imported mail is not mixed with current mail.
a4m.exe "%Thunderbird%\Local Folders\*.*" mapi /m=moz /T_Profile="John Doe" / b="Imported Mail"

Similar to the previous example except that mail is taken from Thunderbird's Local Folders store and is exported to the "John Doe" email profile instead of the default profile.
a4m.exe %Thunderbird%\*.* %Outlook%\Outlook.pst /m=moz /a /T_PstSize=20

Imports locally stored mail (not IMAP folders) from Thunderbird and appends it to the default Outlook.pst file. The %Thunderbird% token tells Aid4Mail to look for the Thunderbird mailbox files in the default storage location. When the target PST file reaches a size of 20 GB, Aid4Mail stops transferring mail to it, creates a new Outlook[001].pst file and resumes mail export to the new PST until the size limit is reached, and so on.
a4m.exe "T:\Thumbdrive Data\*.*" %Outlook%\TBird.pst /m=moz /IncludeTrash / IncludeUnpurged

Exports all Thunderbird messages, including unpurged and deleted mail, from the "T:\Thumbdrive Data\" folder and stores them in the TBird.pst file under the default Outlook files folder. Once completed, you can open the TBird.pst file through the File/Open/Outlook Data File menu command in Microsoft Outlook
Copyright 2005-2013 Fookes Holding Ltd

117

Aid4Mail 3 Help

(older versions of Outlook may use slightly different names for the menu command.)
a4m.exe "\\PC1\Thunderbird\*.*" "\\PC2\Outlook Files\TBird Mail.pst" /m=moz

Exports messages contained in the Thunderbird mailbox files under the Thunderbird folder on PC1 to the "TBird Mail.pst" file on PC2.

3. Outlook or Exchange to Thunderbird


a4m.exe mapi %Thunderbird% /moz

Imports mail from the default Outlook email profile and appends it to the Thunderbird local mail store. The %Thunderbird% token tells Aid4Mail to look for Thunderbird's default storage location (under "Local Folders").
a4m.exe mapi "%Thunderbird%\Imported Mail\" /moz

Similar to the previous example except that the source folder hierarchy is created under the Thunderbird "Imported Mail" folder (which is created if it doesn't exist) instead of the root folder of "Local Folders". This approach ensures imported mail is not mixed with current mail.
a4m.exe mapi "%Thunderbird%\Imported Mail\" /S_Profile="John Doe" / f="Inbox\Archives" /moz

Similar to the previous example except that mail is taken from the "John Doe" email profile instead of the Outlook's default profile. Only mail under the "Inbox\Archives" folder is exported to Thunderbird.
a4m.exe "T:\Thumbdrive Data\Outlook.pst" "%Thunderbird%\Imported Mail\" / IncludeAllItems /IncludeTrash /moz

Exports all Outlook items (mail, notes, contacts, calendar, etc.), including deleted and Junk mail, from the "T:\Thumbdrive Data\" folder and stores them under the "Imported Mail" folder in Thunderbird. If the Outlook.pst includes related split files (Outlook[001].pst, Outlook[002].pst, etc.), Aid4Mail will process them all sequentially.
a4m.exe "\\PC1\Thunderbird\*.*" "\\PC2\Outlook Files\TBird Mail.pst" /m=moz

Exports messages contained in the Thunderbird mailbox files under the Thunderbird folder on PC1 to the "TBird Mail.pst" file on PC2.

4. Converting between Outlook/Exchange and mbox


a4m.exe mapi /mbox /a

Exports messages from the default Outlook email profile and stores them under the the current folder or the "My Documents" folder instead if it is write protected. The resulting mailbox files are named according to the source mail folder names are are stored in the mbox format. Emails are appended to existing mbox files.
a4m.exe "T:\Thumbdrive Data\Outlook.pst" "%Documents%\Imported Mail\*.mbx" /mbox

Exports mail from the Outlook.pst store in the "T:\Thumbdrive Data\" folder and saves them in mbox format with the .mbx extension under the "Imported Mail" subfolder in the Windows "My Documents" folder. If the Outlook.pst includes related split files (Outlook[001].pst, Outlook[002].pst, etc.), Aid4Mail will process them all sequentially.
a4m.exe "T:\Thumbdrive Data\*.*" mapi /m=mbox

Imports mail from mbox files under the "T:\Thumbdrive Data\" folder and appends them to the default Outlook email profile.

Copyright 2005-2013 Fookes Holding Ltd

Reference Information

118

a4m.exe "%Documents%\Imported Mail\*.mbx" %Outlook%\Mbox_Archives_2011.pst / T_PstSize=20 /m=mbox

Imports mail stored in mbox files with the .mbx extension and saves them to the Mbox_Archives_2011. pst store. The %Documents% token tells Aid4Mail to look for the mbox files under the Windows "My Documents" folder. Because the "/a" append switch is not used here, Aid4Mail always creates a new PST file. If the Mbox_Archives_2011.pst file already exists, Aid4Mail renames it to preserve a backup copy. When the target PST file reaches a size of 20 GB, Aid4Mail stops transferring mail to it, creates a new Mbox_Archives_2011[001].pst file and resumes mail export to the new PST until the size limit is reached, and so on.
a4m.exe %Netscape%\Inbox.snm %Outlook%\Outlook.pst /t /a /b="Inbox\Netscape"

Exports messages from Netscape's Inbox mailbox to the "Inbox/Netscape" folder in Outlook.pst. Aid4Mail automatically creates the target folder and PST file if they do not exist.
a4m.exe "D:\My Mail\*.msg" "%Documents%\MSG mail." /t /mbox

Converts all MSG files under the "D:\My Mail" folder and stores them in the "MSG mail" mbox file under the Windows "My Documents" folder.
a4m.exe "T:\Thumbdrive Data\Archives.pst" %Documents%\Mail.txt /t /plain

Saves mail from Archives.pst to the single mbox file Mail.txt in the Windows "My Documents" folder. Messages are saved as plain text (attachments and embedded contents are discarded).

5. Converting between Outlook/Exchange and EML


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

Exports all EML message files under the "Thumbdrive Data" folder into the "Imported Mail" folder of the default Outlook email profile.
a4m.exe "%Documents%\Mail Archives\*.eml" %Outlook%\Archives.pst /a

Appends all EML message files under the "Mail Archives" folder to the Archives.pst file (Aid4Mail creates if it it doesn't already exist). Once completed, you can open the Archives.pst file through the File/Open/Outlook Data File menu command in Microsoft Outlook (older versions of Outlook may use slightly different names for the menu command.)
a4m.exe mapi "%Documents%\Imported Mail\*.eml"

Exports messages from the default Outlook email profile and saves them under the "Imported Mail" folder as individual EML message files. The source folder hierarchy is reproduced under the target folder.
a4m.exe "T:\Thumbdrive Data\*.pst" "%Documents%\Imported Mail\" /eml /ExtractAll

Processes all PST files under the "Thumbdrive Data" folder. Each message is saved as an individual EML file under the "Imported Mail" folder. The source folder hierarchy is reproduced under the target folder. All attachments and embedded contents are extracted from the messages and stored under the Attach and Embedded subfolders respectively.

6. Converting from Outlook/Exchange to Outlook/Exchange


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

Exports email messages from the Backup_2012.pst file to the "Backups\2012" folder in the "John Doe" email profile.
a4m.exe "mapi:Backups\2012" %Outlook%\Backup_2012.pst /S_Profile="John Doe"

Exports email messages from the "Backups\2012" folder in the "John Doe" email profile to the
Copyright 2005-2013 Fookes Holding Ltd

119

Aid4Mail 3 Help

Backup_2012.pst file (based on the Unicode format if you have Outlook 2003 or newer).
a4m.exe mapi mapi /S_Profile="John Doe" /T_Profile=Backups /IncludeAllItems

Exports all items (emails, appointments, contacts, tasks, etc.) contained in the "John Doe" email profile to the "Backups" email profile.
a4m.exe mapi:Inbox\* "mapi:Inbox\Imported Mail" /S_Profile="John Doe" / T_Profile=Backups

Exports email messages from the Inbox folder and its subfolders in the "John Doe" email profile to the "Inbox\Imported Mail" subfolder in "Backups" email profile.
a4m.exe mapi "T:\Thumbdrive Data\MSG Files\" /S_Profile="John Doe" /IncludeAllItems / msg a4m.exe mapi "T:\Thumbdrive Data\MSG Files\*.msg" /S_Profile="John Doe" / IncludeAllItems

Exports all items (emails, appointments, contacts, tasks, etc.) contained in the "John Doe" email profile to the "MSG Files" folder as Outlook MSG files.
a4m.exe "mapi:Inbox\" "%Documents%\MSG Files\*.msg" /S_Profile="John Doe"

Exports mail from the Inbox folder in the "John Doe" email profile to the "MSG Files" subfolder under the Windows "My Documents" folder.
a4m.exe "T:\Thumbdrive Data\MSG Files\*.msg" mapi:Imports /IncludeAllItems / T_Profile="John Doe"

Exports all items (emails, appointments, contacts, tasks, etc.) stored in Outlook MSG files under the "MSG Files" folder to the "Imports" folder in the "John Doe" email profile.

7. Migrating between IMAP and PST


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

Exports all messages from an IMAP account to the "Imported Mail" folder in the default Outlook email profile. The IMAP logon settings are taken from the source.imap.ini file (placed in the program folder), which you must modify beforehand.
a4m.exe imap mapi /S_Profile="Gmail.imap.ini"

Exports all messages from a Gmail account to the default Outlook email profile. The IMAP logon settings are taken from the Gmail.imap.ini file (placed in the program folder), which you must modify beforehand.
a4m.exe imap mapi /S_UserId=JDoe /S_PW="secret password" /T_Profile="John Doe"

Exports all messages from an IMAP account to the "John Doe" email profile. Aid4Mail uses the "JDoe" user ID and password to connect to the IMAP account; other IMAP settings are taken from the source. imap.ini file (placed in the program folder), which you must modify beforehand.
a4m.exe imap %Outlook%\Backup.pst

Exports all messages from an IMAP account to the Backup.pst file in the Outlook data folder. The IMAP logon settings are taken from the source.imap.ini file (placed in the program folder), which you must modify beforehand.
a4m.exe mapi imap /T_UserId="John Doe" /T_PW="secret password"

Exports mail from the default Outlook email profile to an IMAP account. Aid4Mail uses the "John Doe" user ID and password to connect to the IMAP account; other IMAP settings are taken from the target. imap.ini file (placed in the program folder), which you must modify beforehand.
Copyright 2005-2013 Fookes Holding Ltd

Reference Information

120

a4m.exe %Outlook%\Backup.pst imap

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

8. Migrating between two IMAP accounts


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

Exports all messages under the Inbox folder of the source IMAP account to the "Inbox/Exports" folder of the target IMAP account. The source IMAP logon settings are taken from the source.imap.ini file and the target settings from the target.imap.ini file (placed in the program folder), which you must modify beforehand.
a4m.exe imap imap /S_Profile="Yahoo.imap.ini" /T_Profile="Gmail.imap.ini"

Exports all messages from a Yahoo! Mail to a Gmail account. The source IMAP logon settings are taken from the Yahoo.imap.ini file and the target settings from the Gmail.imap.ini file (placed in the program folder), which you must modify beforehand.

9. Archiving email
a4m.exe "%Thunderbird%\*.*" "T:\Thumbdrive Data\Backup.zip" /m=moz

Archives Thunderbird's locally stored mail in the Backup.zip archive file. File attachments and embedded contents are detached from the messages and stored under the Attach and Embedded subfolders respectively; these contents are easy accessible by opening Backup.zip in Windows Explorer or a ZIP utility.
a4m.exe "T:\Thumbdrive Data\Backup.zip" "mapi:Restored Mail"

Copies all mail from the Backup.zip archive file to the default Outlook email profile under the "Restored Mail" folder. Detached attachments and embedded contents are re-inserted into their corresponding messages during the export.
a4m.exe "%Documents%\MSG Files\*.msg" "%Documents%\Archives\Mail_2012.pdf"

Copies the contents of MSG files under the "MSG Files" folder to the "Mail_2012.pdf" Adobe file. Settings that control the PDF format and how emails are saved into the PDF file are defined through the pdf.ini file (placed in the program folder).
a4m.exe %Outlook%\Outlook.pst "%Documents%\Mail\db.csv" /OutputScript="Export-csv"

Uses the "Export-csv" script to export mail from Outlook.pst to the db.csv file. The data in CSV format can then easily be imported into a database.
a4m.exe mapi "T:\Thumbdrive Data\Mail.txt" /t /ExtractAll

Exports mail from the default Outlook email profile to the Mail.txt file. File attachments and embedded contents are detached from the messages and stored under the Attach and Embedded subfolders respectively.
a4m.exe mapi:Important %Documents%\Web /mht >log.txt

Converts mail in the "Important" folder in default Outlook email profile to MHT files with an index.html file for viewing in Internet Explorer. Progress information and error messages are redirected from the console window to the log.txt file.

Copyright 2005-2013 Fookes Holding Ltd

121

Aid4Mail 3 Help

10. Merging mail


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

Merges all the mbox files under the "Mail Archives" folder into one file called "All Mail.mbox".
a4m.exe "%Documents%\Mail Files\*.eml" "T:\Thumbdrive Data\Mail.mbox" /s=False

Exports EML mail from the "Mail Files" folder (but not subfolders) to the "Mail.mbox" file.
a4m.exe %Outlook%\*.pst mapi /T_Profile=Archive

Merges mail from all the source PST files into the target mail store attached to the Archive profile.
a4m.exe %Outlook%\*.pst d:\Mail\Archives\Merged.pst /a

Merges mail from all the source PST files into the target Merged.pst file.

11. Filtering messages

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

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

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

Exports Thunderbird messages that contain JPG images, or .mov and .avi movie files (using the Has jpg mov avi.s4f script) to EML files. File attachments and embedded contents are detached from the messages and stored under the Attach and Embedded subfolders respectively.

12. Other examples


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

Converts Thunderbird's locally stored mail to EML files under the "Mail Archives" folder. EML file names are based on their message's subject line.
a4m.exe "\\PC1\Mail Files\*.eml" \\PC2\Outlook\Imports.pst

Exports EML messages from the "Mail Files" folder on PC1 to the "Imports.pst" file on PC2.
a4m.exe "%Documents%\MSG Files\*.msg" "%Documents%\EML Files\{filename}.eml"

Converts MSG mail files under the "MSG Files" folder to EML files under the "EML Files" folder. The {filename} token tells Aid4Mail to base the EML file names on those of source files.

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 by editing an INI file in a text editor. The settings INI files are stored either in the Aid4Mail program folder or under the Aid4Mail AppData (or Application Data) folder. The file name starts with the settings name followed by the extension ".imap.ini". For example, the settings called "source" are stored in a file called "source.imap.ini" Aid4Mail uses the TCP component from the Synapse library to access an IMAP account. Features
Copyright 2005-2013 Fookes Holding Ltd

Reference Information

122

supported by Synapse TCP include IPv4, IPv6, SSL/TLS, SOCKS4/4a/SOCKS5 proxy servers (outgoing connections and limited incoming), and TCP through an HTTP proxy tunnel.

IMAP Settings Screen


Complete all the fields under Server Configuration required to connect to an IMAP account. Values are automatically saved when you click on the "Next" button. Click on the "Save As" button to store settings under new name. To delete settings, select a name from the Settings drop-down list and then press the Delete key while the field has the focus. Connection Security Options None No security protocol is used for accessing the IMAP account. Smart Aid4Mail automatically determines the most appropriate security setting. STARTTLS Aid4Mail checks the server response to determine if a plain text connection needs to be upgraded to an secure one. SSL/TLS The SSL/TLS security protocol is used for accessing the IMAP account. You should only fill-in the Namespace field if you need to access shared or public mail folders, or if Aid4Mail is unable to correctly identify your private account top-level folder. The namespace for a shared folder may be "shared" or "#shared" and the namespace for a public folder may be "public" or "#public" (without the quotes). Contact your account administrator if you don't know the namespace for the shared or public mail folders you need to access. You should only set the "Max. folder depth" field if the target IMAP account only supports a limited depth of folders. For example, GMX Mail only supports 3. With some accounts running under a Dovecot IMAP server, the maximum folder depth may be set by the administrator. Use the "Max. folder length" field if your target IMAP account imposes a limit on the length of folder names (number of characters). Most IMAP servers allow folder names with more than 100 characters so this field can be left blank. Some popular mail services like GMX Mail and Zoho Mail only allow folder names with less than 100 characters (30 for GMX and 50 for Zoho), so to ensure successful exports you need to set this field to the appropriate maximum value.

Proxy Settings
All settings on this Proxy screen are ignored if the Server Name field is left blank or if the Type field is set to None. Aid4Mail supports SOCKS4 and SOCKS5 proxy servers, and tunneling through an HTTP proxy server. Select the appropriate proxy protocol from the drop-down list in the Type field.

Log IMAP Communications


You can create a log file storing all communications between Aid4Mail and an IMAP server by turning on the Log IMAP Communications option available through the Software button menu. This feature is useful to identify issues encountered when connecting to an IMAP account or when uploading/downloading messages to it. These log files are saved in the "My Documents" folder and use the .log file extension. This option is turned off by default when you start Aid4Mail. You can also enable this option through the command line with the /ImapLog switch.

Fixing Folder Names with Invalid Characters


Some IMAP servers are fussy about which characters can be used in a folder name. If you try to migrate a folder that has forbidden characters in the name, the target IMAP server will error. As a result, none of

Copyright 2005-2013 Fookes Holding Ltd

123

Aid4Mail 3 Help

the emails and subfolders contained in the source folder are migrated. You can solve this type of issue by using a special template file called NameFilter.dat. Open the file NameFilter.txt for instructions and a working example.

Recommended Settings for Popular IMAP Services AIM.Mail (AOL Mail)


Although AIM.MAIL supports a multi-level folder structure through IMAP, this is not the case with the web interface which only allows one level of folders and limits their length to 32 characters. Folder that contain subfolders are not displayed in the web interface. Server Name: imap.aim.com Port: 993 Connection Security: SSL/TLS Max. folder length: 100

FastMail
The folder hierarchy displayed through the FastMail web interface is consistent with the folder hierarchy available through the IMAP protocol. Server Name: imap.messagingengine.com Port: 993 Connection Security: SSL/TLS

Gmail
If you haven't already done so, please make sure to Enable IMAP in Gmail before connecting to your account with Aid4Mail. Note also that you'll have to set up an application-specific password for Aid4Mail if you have protected your account with Google's 2-Step authentication. Although Gmail supports a multi-level folder structure through IMAP, this is not the case with the web interface which only displays one level of folders called "labels" and limits their length to 40 characters. Subfolder names are part of the label name and separated with a forward slash character. Example: Folder1/Folder2/Folder3. Depending on how you manage you mail on Gmail, you may have many folders/labels with duplicate mail. If you are exporting mail from a Gmail account, you can filter out duplicates by setting the "Check for Duplicates Across Folders" option under the Advanced Options menu and the "Do not add duplicate messages" setting on the Export Options screen. To optimize this duplicates filtering feature, Aid4Mail processes the "[Gmail]/All Mail" folder last. Beware! Gmail enforces daily bandwidth limits. As of this writing, you can upload up to 500 MB and download up to 2,500 MB of email per day. Furthermore, the maximum email size you can upload is 35 MB (including all attachments). Server Name: imap.gmail.com Port: 993 Connection Security: SSL/TLS

Copyright 2005-2013 Fookes Holding Ltd

Reference Information

124

GMX Mail
Note that GMX Mail only allows folder structures no more than three levels deep (Folder1\Folder2 \Folder3) and does not permit the use of certain characters in the folder name that most IMAP servers accept (like +, #, [, ], !, "). Aid4Mail automatically corrects invalid folder names on export to GMX, but you must set the "Max. folder depth" field to 3 and the "Max. folder length" field to 30 in the configuration settings. Server Name: imap.gmx.com Port: 993 Connection Security: SSL/TLS Max. folder depth: 3 Max. folder length: 30

Outlook.com
The folder hierarchy displayed through the Outlook.com interface is consistent with the folder hierarchy available through the IMAP protocol. Some common characters are not accepted in the folder name. These include &, <, >, :, ", ', (, ), +, ;, /, \. Aid4Mail automatically corrects invalid folder names on export to Outlook.com. Server Name: imap-mail.outlook.com Port: 993 Connection Security: SSL/TLS

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


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

Yahoo! Mail
Please note that, at this time of writing, IMAP access to a Yahoo! Mail account is not officially supported by Yahoo. As a result, there is no guarantee that this option will be available in the future or that it will work the same way. Although Yahoo! Mail supports a multi-level folder structure through IMAP, this is not the case with the web interface which only displays one level of folders and limits their length to 30 characters. Subfolder names are part of the top level name and separated with a forward slash character. Example: Folder1/ Folder2/Folder3. Server Name: imap.mail.yahoo.com Port: 993

Copyright 2005-2013 Fookes Holding Ltd

125

Aid4Mail 3 Help

Connection Security: SSL/TLS

Zoho Mail
If you haven't already done so, please make sure to enable IMAP access before connecting to your account with Aid4Mail. You will find the option in the Zoho Mail web app under Settings > Mail > POP/ IMAP > IMAP Access > Status. The folder hierarchy displayed through the Zoho Mail web interface is consistent with the folder hierarchy available through the IMAP protocol. In both access methods, folder names allow up to 50 characters. Server Name: imap.zoho.com Port: 993 Connection Security: SSL/TLS Max. folder length: 50

Other IMAP Accounts


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

2.7

Fixing Attachment Folder References


Some email client programs like Eudora, Calypso, The Bat!, PocoMail, and Barca, extract attachments from messages and store them in a separate folder. A reference to the disk file is then inserted in the corresponding email to preserve the link between them. Unfortunately, email clients do not provide a means to update this reference when the location of the attachment folder is changed. When the link is broken, the message can no longer open the extracted contents. Aid4Mail uses links stored in messages to find the corresponding attachments. If it cannot find the files at the indicated location, Aid4Mail searches for the location relative to the mailbox file being processed. When this fails, the extracted contents are lost during the conversion process. To avoid this, you can define a configuration file to tell Aid4Mail where to look for extracted attachments. To do so, create an INI file called Tokens.ini and save it in the Aid4Mail program folder or place it in the Aid4Mail folder under Application Data. Note that any changes you make to the file must be saved before you launch Aid4Mail, or else they might not be picked up by the software. Add the section [SubstPaths] to the Tokens.ini file followed by the old drive/path names and their corresponding new values. Example: [SubstPaths] D:\=C:\ C:\=\\server\c$\ C:\Documents and Settings\William\=C:\Documents and Settings\Bill\ Typically, you will only enter one item under the [SubstPaths] section. But if your mail files have been moved around several times, you may have several different path references that need correcting. In this case, Aid4Mail will test each item sequentially until it finds the file or reaches the end of the list. You do
Copyright 2005-2013 Fookes Holding Ltd

Reference Information

126

not need to enter the full path to the attachments folder, but only the start until the changed part. Example: [SubstPaths] C:\Program Files\Eudora C:\Program Files\Eudora C:\Program Files\Eudora C:\Program Files\Eudora

Pro\=C:\Program Files\Eudora 7\ 4\=C:\Program Files\Eudora 7\ 5\=C:\Program Files\Eudora 7\ 6\=C:\Program Files\Eudora 7\

Supposing your Eudora attachments are now stored under the following folder: C:\Program Files\Eudora 7\Attach\ but were previously stored under: C:\Program Files\Eudora Pro\Attach\ then the first item in the above example under the [SubstPaths] section will instruct Aid4Mail to modify the following attachment link: C:\Program Files\Eudora Pro\Attach\Contract.doc to this: C:\Program Files\Eudora 7\Attach\Contract.doc Alternatively, if you have attachment references pointing to many different places but have copied or moved all the files to one location, then you can use the special Attachments and Embedded values to identify the folder. Note that the Embedded value normally only applies to Eudora's embedded files. This feature makes it possible to simplify the example above: [SubstPaths] Attachments=C:\Program Files\Eudora 7\attach\ Embedded=C:\Program Files\Eudora 7\Embedded\ Supposing your Eudora sent attachments originally had the following names: D:\My Documents\Word\Contract.doc D:\My Documents\My Pictures\Drafts\Logo-1.jpg D:\My Documents\My Pictures\Final\Logo.tif but are now all stored in this folder: F:\My Documents\Eudora\Attachments\ Create the following entry in your Tokens.ini file: [SubstPaths] Attachments=F:\My Documents\Eudora\Attachments\ that will F:\My F:\My F:\My then instruct Aid4Mail to look for the three attachment files in the following place: Documents\Eudora\Attachments\Contract.doc Documents\Eudora\Attachments\Logo-1.jpg Documents\Eudora\Attachments\Logo.tif

2.8

Useful Tokens and System Variables


Aid4Mail supports tokens that represent either fully qualified folder names, system variables, or userdefined strings. A token must be delimited with either a percent character (%) or a dollar sign ($). If you are going to use tokens in a batch-file script, you must use the "$" character as a delimiter instead of "%".

Copyright 2005-2013 Fookes Holding Ltd

127

Aid4Mail 3 Help

The following tokens are defined in Aid4Mail and recognized under all versions of Windows: %AppData% returns the Application Data folder of the logged on user %SharedData% returns the common Application Data folder shared by all users %ExeFolder% returns the folder of the Aid4Mail program file %ExeDrv% returns the drive of the Aid4Mail program file %UsbDrv% returns the USB drive letter (e.g., E:) if Aid4Mail is running with the USB option (see related /USB command-line switch) %ProgramData% returns the folder used by Aid4Mail to store program settings %TempFolder% returns the Windows "Temp" folder or the user-defined Temp folder %Desktop% returns the Windows "Desktop" folder %SharedDesktop% returns the Windows "Public\Desktop" or "All Users\Desktop" folder shared by all users %Documents% returns the Windows "My Documents" folder %SharedDocuments% returns the Windows "Public\Documents" or "All Users\Documents" folder shared by all users %Pictures% returns the Windows "My Pictures" folder

The following tokens are usually recognized if you have the corresponding mail client installed. These tokens return the folder that contains the mail files if it exists: %Agent% %Barca% %Eudora% %Mozilla% %Netscape% %OE% %Outlook% %Pegasus% %PocoMail%
Copyright 2005-2013 Fookes Holding Ltd

Reference Information

128

%TheBat% %Thunderbird% %WindowsMail% Depending on your mail client's setup, Aid4Mail may not find the correct folder containing your mail. If that happens the token returns an empty string. If you know the full path to your mail folder, you can redefine the token to the value of your choice (or create new tokens). To do so, create an INI file called Tokens.ini and save it in the same folder as the Aid4Mail program file (Aid4Mail.exe or a4m.exe) or place it in the Aid4Mail folder under Application Data. Add the section [Tokens] followed by the token names and their values. Note that any changes you make to the file must be saved before you launch Aid4Mail, or else they might not be picked up by the software. Token values can contain Windows predefined variables (see below). Example: [Tokens] Eudora=C:\Archives\2007 Thunderbird=%AppData%\Backups\Mail Backups=D:\Backups\Netscape

The following lists a small selection of predefined system variables typically available under Windows 2000, XP, Vista, and Win7 with examples of possible default values assuming "Administrator" is the name of the logged on user: %AllUsersProfile% C:\Documents and Settings\All Users %AppData% C:\Documents and Settings\Administrator\Application Data %CommonProgramFiles% C:\Program Files\Common Files %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
Copyright 2005-2013 Fookes Holding Ltd

129

Aid4Mail 3 Help

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 information when it needs to determine what file extension to add to an extracted attachment, or what MIME type it must assign to a file that it is inserting back into an email. Aid4Mail uses two lists stored in plain-text files to determine the relation between MIME Types and File Extensions: Mime-Ext.dat and Ext-Mime.dat. If necessary, these lists can be edited by advanced users as long as the simple data format is preserved (one item per line and a tab character separates the two columns). In order to avoid losing edits when updating the Aid4Mail software, you should store custom versions of those two files in the Aid4Mail user folder under Application Data; example: On a Windows 2000/XP system, look for C:\Documents and Settings\<user>\Application Data\Aid4Mail On a Windows 7 and Vista systems, look for C:\Users\<user>\AppData\Roaming\Aid4Mail Note that any changes you make to these files must be saved before you launch Aid4Mail, or else they might not be picked up by the software.

2.10

Time Zones
A time zone is a region of the World where a common standard time is used, usually referred to as the local time. Email messages usually include this information in the header date field. Most email programs convert such dates to your local time for display purposes. Doing so ensures that you can reliably sort messages from around the World by date no matter what time zone you are in. Unlike an email client program, Aid4Mail usually does not have to adjust dates to a local time zone when converting mail to another format the target mail program takes care of that when it displays email information. However, there are certain Aid4Mail tasks which require adjusting the date time zone. These include setting the file date stamp when Aid4Mail exports messages into individual files (EML, MHT, MSG) and also when it extracts attachments. Time zone adjustments to dates are also calculated when you export to 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 that version, dates were adjusted to UTC time. If necessary, you can use the /TimeZone command-line switch to change the default time zone used by Aid4Mail. The switch is supported by both the Aid4Mail GUI and the console version. The switch accepts a time zone value in one of several formats: numerical, time zone abbreviation, time zone in short form, or Windows registry time-zone name (starts with a $ sign). Examples: /TimeZone=+0100 /TimeZone=CET /TimeZone=UTC-8 /TimeZone=UTC+5:30 /TimeZone="$Eastern Standard Time" When you specify a time-zone name or abbreviation, or when you use the default local time (when this

Copyright 2005-2013 Fookes Holding Ltd

Reference Information

130

switch is not specified), Aid4Mail will try to calculate the local date based on standard or daylight time. Aid4Mail determines the daylight time period based on settings in the DST.dat file or the Windows registry. Time zone abbreviations and their corresponding offset values are stored in the TimeZones.dat file, under the Aid4Mail program folder. If necessary, these lists can be edited by experienced users as long as the simple data format is preserved (one item per line and a tab character separates the two columns). In order to avoid losing edits when updating the Aid4Mail software, you should store modified versions of the file in the Aid4Mail user folder under Application Data; example: On a Windows 2000/XP system, look for C:\Documents and Settings\<user>\Application Data\Aid4Mail On a Windows 7 and Vista systems, look for C:\Users\<user>\AppData\Roaming\Aid4Mail

The list below shows the main time-zone abbreviations with daylight settings that Aid4Mail recognizes through the /TimeZone switch (settings stored in the DST.dat file): ACST ACWST AEST AET AKST AST AWST CET CST EET EST GMT MCK MET MSK MST NZST PST WET Australian Central Time Australian Central Western Time Australian Eastern Time Australian Eastern Time Alaska Time Atlantic Time Australian Western Time Central European Time Central Time Eastern European Time Eastern Time Western European Time Moscow Time Central European Time Moscow Time Mountain Time New Zealand Time Pacific Time Western European Time

Any changes you make to these files must be saved before you launch Aid4Mail, or else they might not be picked up by the software.

2.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 Aid4Mail program folder. Advanced users can edit these to modify the format of the target files created by Aid4Mail during mail conversion. If you plan to edit template files, make sure you keep a backup copy of the original files. Also make sure you save backup copies of your modified templates before you install a new Aid4Mail update, or your custom templates will be overwritten by the default Aid4Mail templates. Note that any changes you make to these files must be saved before you launch Aid4Mail, or else they might not be picked up by the software.

Copyright 2005-2013 Fookes Holding Ltd

131

Aid4Mail 3 Help

IMPORTANT: Please note that Fookes Software does not provide support for custom templates. If you choose to create or modify a template, you accept that you will receive no help from Fookes Software's customer support service. The following fields can be used in the Aid4Mail templates: {attachment_count} {attachment_names} {attachments} {date} {display_date} {mailbox} {mailbox_file} {message_file} {message_id} {message_name} {Priority} {recipient_bcc} {recipient_cc} {recipient_to} {sender} {sender_email} {sender_name} {size} {size_kb} {source_file} {source_name} {status} {subject} {target_folder} {time_zone} Aid4Mail Console and Aid4Mail eDiscovery also support the following field, which inserts the MD5 value of the email message: {message_md5}

2.12

Error Log File


Unfortunately, email conversions are not always perfect and errors can occur. These errors may result from corrupted mail files, missing attachment files, or software bugs. Aid4Mail automatically stores error messages resulting from email processing in a log file called ErrorLog.txt. By default, the Aid4Mail GUI saves the file under the "Application Data\Aid4Mail" folder, whereas Aid4Mail Console saves it in the program folder. Once email has been processed, Aid4Mail automatically opens the log file in the associated application (e.g. Windows Notepad) if errors were encountered. The log is a tab-delimited file with 5 columns of data. The first column shows the error message, the second has the name of the file that is being processed, the third is the name of the mailbox, the fourth has the date taken from the email header, and the fifth the email subject line. In some cases, the three last columns may be empty if Aid4Mail wasn't able to retrieve the information before the error occurred. You can view this file in a text editor or a spreadsheet program like MS Excel.

Copyright 2005-2013 Fookes Holding Ltd

Reference Information

132

You can use the /ErrorLog command-line switch to define an alternative file name for the log file. Aid4Mail recognizes "shorthand" tokens used in the path name; see the Useful Tokens and System Variables topic for more details. The following example will create a log file called "Conversion Errors.txt" that is saved in the Aid4Mail subfolder under the "My Documents" folder:
Aid4Mail.exe /ErrorLog="%MyDocs%\Aid4Mail\Conversion Errors.txt"

If you do not want any log file created, simply use the /ErrorLog command-line switch without a file name. Example:
Aid4Mail.exe /ErrorLog

If you do want a log file, but do not want it opened when email processing is finished, simply define a log file name without a file extension. Example:
Aid4Mail.exe /ErrorLog="%MyDocs%\Aid4MailErrors"

2.13

Advanced Options
The special options listed below are available either through command-line switches or the Advanced Options submenu of the Software button menu. Strict File Format Check When this option is set, Aid4Mail checks both the file extension and contents to see if they conform with the selected source format. You can instruct Aid4Mail to be more "tolerant" with certain file types by turning off this option. This option is turned on by default when you start Aid4Mail. You can also control this option through the command line with the /m switch. Use Received Date Field By default, incoming message dates used for creating file date stamps (eml, mht, msg, extracted attachments) and Microsoft Exchange delivery time are based on the server Received date instead of the header Date field. Turn off this option to instruct Aid4Mail to extract the date from the message Date field instead of the server Received date. You can also control this option through the command line with the / UseDateField switch. Header-based MD5 File Names Prior to Aid4Mail version 2.11, the MD5 signature for EML and MHT file names was computed from the full email (message header + body). This behavior is preserved when this option is unchecked. When checked, the MD5 signature is based on the Message-ID field value. If this field is empty or missing (usually in outbound messages), Aid4Mail uses the email date and subject line for the comparison, or other fields (To, Cc, Bcc, From delimiter) from the message header if either of those values are blank, or the whole header. Check for Duplicates Across Folders This option affects the behavior of the "Do not add duplicate messages" setting on the Export Options screen and is ignored if the setting is unchecked. When this option is unchecked, filtering for duplicates is limited to the contents of the target folder. When the option is set, Aid4Mail filters out all message duplicates, including those of emails exported to previous target folders. You can also control this option through the command line with the /SkipAllDups switch.

Use MAPI TNEF Converter

Copyright 2005-2013 Fookes Holding Ltd

133

Aid4Mail 3 Help

Prior to Aid4Mail v2.1, both TNEF and regular emails were processed by the MAPI RFC 1521 Converter when the option was set. The MAPI RFC 1521 Converter does a good job converting regular emails to the standards-compliant RFC 1521 format, but it produces poor results with TNEF messages (to avoid data loss Aid4Mail always saved the TNEF information in a winmail.dat attachment). For better results, turn this option off to use Aid4Mail's own converter whenever a TNEF email is encountered. You can also set this option through the command line with the /UseMapiTnefConverter switch. Note that turning on this option as well as "Save TNEF as Winmail.dat Attachments" restores the default behavior prior to Aid4Mail 2.1. Save TNEF as Winmail.dat Attachments When "Use MAPI TNEF Converter" is turned on, use this option to save TNEF data in a winmail.dat attachment when converting mail to the RFC 1521 format. Turn this option off if you do not wish to create winmail.dat attachments. You can also set this option through the command line with the / AddWinmailDat switch.

Due to their impact on email processing, changes to the options below are not restored across Aid4Mail sessions. 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, including those created by Mozilla Thunderbird and Eudora. It does so to ensure it doesn't miss any emails when processing mailbox files that contain a mix of storage formats (e.g. a Mac or Unix mbox file imported in Windows Thunderbird with new messages added to it). If you are processing mailbox files that are entirely created by a single mail client, then you can increase performance without sacrificing reliability by turning this option on.This option is turned off by default when you start Aid4Mail. You can also control this option through the command line with the /fast switch. Use MAPI RFC 1521 Converter With Outlook 2003 and more recent versions, Aid4Mail uses the internal MAPI converter to import/export mail from Outlook PST and MSG files, and Exchange server stores. The advantage of this method is that it often converts messages with non-Latin characters and certain special email types more reliably than the Aid4Mail method. The disadvantage of the internal MAPI converter is that it is usually slower than Aid4Mail's conversion method. Only turn off this option if you are encountering conversion issues with it or if processing speed is critical. This option is turned on by default when you start Aid4Mail. You can also control this option through the command line with the /MapiConvOff switch. Outlook 2010 had a serious bug that caused data loss in source messages processed with the MAPI RFC 1521 Converter. Original SMTP headers were replaced with a simplified version. For most users the effects of this bug are not noticeable, or at most a minor inconvenience. However, for those working in the field of e-discovery and forensic examination such loss of data is unacceptable. We recommend that you download and install the latest maintenance release for Outlook 2010. Fix MAPI Header Errors When using the MAPI RFC 1521 converter to process mail from Outlook PST and MSG files, and Exchange server store formats to RFC text-based formats (MIME), results may differ significantly from the original format. When this option is set, Aid4Mail fixes all format inconsistencies it detects based on the original header data. These fixes ensure that the converted email is as faithful as possible to the original message and reduces the risk of data loss. The disadvantage of this option is that it slows down conversion and in some very rare cases may cause incorrect conversions. This option is turned on by default when you start Aid4Mail. You can also control this option through the command line with the / MapiFixOff switch.
Copyright 2005-2013 Fookes Holding Ltd

Reference Information

134

Log IMAP Communications Turn this option on to create a log file storing all communications between Aid4Mail and an IMAP server. This feature is useful to identify issues encountered when connecting to an IMAP account or when uploading/downloading messages to it. These log files are saved in the "My Documents" folder and use the .log file extension. This option is turned off by default when you start Aid4Mail. You can also set this option through the command line with the /ImapLog switch. Log for Incremental Processing... This option affects the behavior of the "Do not add duplicate messages" setting on the Export Options screen and is ignored if the setting is unchecked. Use it to create or open a log file that keeps track of which emails have been processed. If you open an existing log file, Aid4Mail will skip any email that is referenced in it. This feature is useful if you want to avoid exporting the same email more than once even after you restart Aid4Mail. Note that the references stored in the log file are sensitive to the state of the "Check for Duplicates Across Folders" option. In other words, if the log file was created when the option was unchecked, then running Aid4Mail again with the option checked will result in failure to match any of the references. As a result all emails will be processed again. In Aid4Mail Console you can set the log file through the /SkipDups and /SkipAllDups command-line switches.

2.14

GUI Command-Line Switches


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

Or add the switch to the Windows desktop shortcut for Aid4Mail. You can do this by opening Aid4Mail's shortcut Properties dialog box and adding one or more switches at the end of the Target field on the Shortcut tab. Example:
"C:\Program Files\Aid4Mail2\Aid4Mail.exe" /Switch1 /Switch2

/acc /acc=on /acc=off

Aid4Mail normally automatically detects when an accessibility feature is running, like a screen reader or High Contrast display mode, and sets itself in a mode that improves compatibility. Use this switch to override this detection and turn accessibility mode on or off depending on switch value. Use this switch to copy screen reader configuration files for Window-Eyes, JAWS, and/or Dolphin Hal to the appropriate folder locations. These files inform screen readers how to deal with non-standard controls used in Aid4Mail. Use this switch if you need to process EML files that do not have the standard .

/acc=install

/emlExt= ext

Copyright 2005-2013 Fookes Holding Ltd

135

Aid4Mail 3 Help

eml file extension. Set the "ext" value either to the corresponding file extension or use "*" to accept any file extension. Example: Aid4Mail.exe /emlExt=txt /ErrorLog /fast See the Error Log File topic for details. Aid4Mail does extensive text parsing and format analysis when reading generic mailbox files, including those created by Mozilla Thunderbird and Eudora. It does so to ensure it doesn't miss any emails when processing mailbox files that contain a mix of storage formats (e.g. a Mac or Unix mbox file imported in Windows Thunderbird with new messages added to it). If you are processing mailbox files that are entirely created by a single mail client, then you can increase performance without sacrificing reliability by using the /fast switch. This setting is also available through the "Software/Advanced Options/Fast Mail Processing" menu command. Example: Aid4Mail.exe /fast Use this switch to create a log file storing all communications between Aid4Mail and an IMAP server. This feature is useful to identify issues encountered when connecting to an IMAP account or when uploading/downloading messages to it. These log files are saved in the "My Documents" folder and use the .log file extension. This setting is also available through the "Software/Advanced Options/Log IMAP Communications" menu command. Example: Aid4Mail.exe
/ImapLog

/ImapLog

/m

Aid4Mail checks both the file extension and contents to see if they conform with the selected source format. You can instruct Aid4Mail to be more "tolerant" with certain file types by running it with the /m command-line switch. This can be useful with files that start with a non-conforming format. This setting is also available through the "Software/Advanced Options/Strict File Format Check" menu command. Example: Aid4Mail.exe /m With Outlook 2003 and more recent, Aid4Mail uses the internal MAPI converter to import/export mail from Outlook PST and MSG files, and Exchange server stores. The advantage of this method is that it converts messages with non-Latin characters and certain special email types more reliably than the Aid4Mail method. The disadvantage of the internal MAPI converter is that it is usually slower than Aid4Mail's conversion method. Only use the /MapiConvOff switch if you are encountering conversion issues with it or if processing speed is critical. This setting is also available through the "Software/Advanced Options/Use MAPI RFC 1521 Converter" menu command. Example: Aid4Mail.exe /MapiConvOff When using the MAPI RFC 1521 converter to process mail from Outlook PST and MSG files, and Exchange server store formats to RFC text-based formats ( MIME), results may differ significantly from the original format. When this option is set, Aid4Mail fixes all format inconsistencies it detects based on the original header data. These fixes ensure that the converted email is as faithful as possible to the original message and reduces the risk of data loss. The disadvantage of this option is that it slows down conversion and in some very rare cases may cause incorrect conversions. Use the /MapiFixOff switch to turn off the default email fixing feature. This setting is also available through the "Software/Advanced Options/Fix MAPI Header Errors" menu command. Example: Aid4Mail.exe /MapiFixOff If you need to run performance tests on an unlimited number of emails, add the /
Copyright 2005-2013 Fookes Holding Ltd

/MapiConvOff

/MapiFixOff

/NoLimit

Reference Information

136

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 trial notice. /RESET /RESETWND /SkipAllDups Resets all the Aid4Mail program settings to their default values. Resets the Aid4Mail window position at startup. This switch has the same effect as setting the "Check for Duplicates Across Folders" option under the Advanced Options menu. Use this switch to change the default time zone Aid4Mail uses when setting the date stamp of exported message files and date values in the corresponding column of MHT target formats. The switch accepts a time zone value in one of several formats: numerical, time zone abbreviation, time zone in short form, or Windows registry time-zone name. See the Time Zones topic for more information. Removes the local activation data files and starts Aid4Mail in trial mode. This option is also available through the "Software/Clear Activation Code" menu command. By default, incoming message dates used for creating file date stamps (eml, mht, msg, extracted attachments) and Microsoft Exchange delivery time are based on the server Received date instead of the header Date field. Use the / UseDateField to instruct Aid4Mail to extract the date from the message Date field instead of the server Received date. This setting is also available through the "Software/Advanced Options/Use Received Date Field" menu command.

/TimeZone

/trial

/UseDateField

2.15

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

2.15.1 ANSI PST

2.15.2 Attachment
An attachment is a file such as a word processing document, spreadsheet, graphics or sound that has been sent along with an email message. The contents of the attachment usually do not appear in the message itself, but instead must be opened separately.

2.15.3 CLI
CLI stands for command-line interface. It is a text-only interface that receives instructions through a keyboard or is executed from other programs. Unlike a graphical user interface (GUI), it does not respond to mouse clicks and does not display buttons, menus, and graphics. Aid4Mail Console uses a command-line interface; all the other Aid4Mail editions use a graphical user interface.

Copyright 2005-2013 Fookes Holding Ltd

137

Aid4Mail 3 Help

2.15.4 Delimiter
Commas, quotes, spaces, tabs, semi-colons, words, phrases, line breaks, and mixtures of thereof (but not limited to), that are used to separate data. For example, an address book could have: Name, Address,City,State,Zip,Phone,Email; one line for each entry. The different items are separated by commas. The comma is the delimiter, because it separates the items from each other. Email clients use delimiters to separate each message in the mailboxes. It tells the program where one message ends and the next one starts. For example, Eudora uses "From ???@???" (without the quotes) at the beginning of a line to separate, or delimit the email messages from one another. Aid4Mail can make address books from email using commas or tabs as delimiters (or separators).

2.15.5 Embedded contents


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

2.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 a user's mailbox is stored in the private information store on a Microsoft Exchange Server computer. A mailbox can contain received messages, message attachments, folders, folder hierarchy, and more. Server applications for Microsoft Exchange Server are often designed with a mailbox for communication.

2.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. All messages in a generic mailbox are concatenated and stored as plain text. Each message begins with a From_ line, continues with a series of non-From_ lines, and ends with a blank line. A From_ line means any line that begins with the characters F, r, o, m, and space. The file format complies with the mbox standard, which most mail clients can read or import.

2.15.10 GUI
GUI stands for graphical user interface. It is a type of user interface that allows interaction between a mouse, keyboard, and/or touch-screen and graphical elements like buttons, menus, and other visual objects. Most Windows programs offer a graphical user interface, including Windows Explorer, Notepad, and Microsoft Outlook. A graphical user interface is usually easier to understand and use than a command-line interface (CLI) which only offers a text-based interface.

2.15.11 IMAP
IMAP is an acronym for Internet Message Access Protocol. It is an internet standard protocol used to access and organize messages on a remote mail server. Popular services like Gmail offer IMAP access to their mail accounts.

Copyright 2005-2013 Fookes Holding Ltd

Reference Information

138

2.15.12 Information store


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

2.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. Mailboxes and folders generally mean the same thing, but if you tell somebody that is using Outlook to look in their Sent mailbox they might not understand you since Outlook uses the term folders all the time for their mailboxes.

2.15.14 MAPI
The Messaging Application Program Interface (MAPI) is an extensive set of functions that developers can use to create mail-enabled applications. The full function library is known as MAPI 1.0 or Extended MAPI. Extended MAPI allows complete control over the messaging system on the client computer, creation and management of messages, management of the client mailbox, service providers, and so forth. Simple MAPI is a subset of Extended MAPI, which supports only basic messaging functionality. It includes functions to send and receive messages, and read mail stored in the Inbox.

2.15.15 MAPI folder


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

2.15.16 mbox
The mbox format is a common storage structure for email messages. An mbox is a single file containing zero or more email messages. A message stored in mbox format begins with a From_ line, continues with a series of non-From_ lines, and ends with a blank line. A From_ line means any line that begins with the characters F, r, o, m, space. This format should not be confused with the Pine MBX format. Although there's only one character distinguishing the two format names, they are completely different and incompatible from each other. Aid4Mail does not read the MBX format. You will find a more detailed definition on the Wikipedia website.

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 file system like any other file.

2.15.18 MD5
MD5 is a message-digest algorithm. The algorithm takes as input a message of arbitrary length and produces as output a 128-bit "fingerprint" or "message digest" of the input. It is conjectured that it is computationally infeasible to produce two messages having the same message digest, or to produce

Copyright 2005-2013 Fookes Holding Ltd

139

Aid4Mail 3 Help

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 have transited through a mail server. Its value, which is enclosed in angle brackets (<>), is required to be globally unique. That is, no two different messages should ever have the same Message-ID value. The uniqueness of the message identifier is normally guaranteed by the host which generates it. A common technique used by many message systems is to create a value with a time and date stamp along with the local host's domain name. Example: <972381.2319756@domain.com>.

2.15.21 MHT files


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

2.15.22 MHTML
MHTML stands for "MIME Encapsulation of Aggregate HTML Documents." It is an internet standard that defines the MIME (Multipurpose Internet Mail Extensions) structure used to send HTML content in email message bodies. MHTML enables you to send and receive webpages and other HTML documents using email programs such as Microsoft Exchange, Microsoft Outlook, and Microsoft Outlook Express. MHTML enables you to embed images directly into the body of your email messages rather than attaching them to the message.

2.15.23 MIME
Multipurpose Internet Mail Extensions (MIME) defines a format and general framework for the representation of a wide variety of data types in internet mail.

2.15.24 PDF/A
PDF/A is a file format (ISO standard) for the long-term preservation of self-contained electronic documents. It is a subset of PDF, obtained by leaving out PDF features not suited to long-term archiving. All of the information necessary for reliably displaying the document is embedded in the file. However, a PDF/A document may not be reliant on external information, for example links to external image files or fonts that are not embedded. Note that federal courts in the U.S. are moving towards adopting PDF/A as the standard format for electronic filing to ensure the long-term preservation of case-related documents. All courts currently accept PDF/A files if they are uploaded to the CM/ECF system. Aid4Mail produces files based on the PDF/A-1a (Level A Conformance) format.
Copyright 2005-2013 Fookes Holding Ltd

Reference Information

140

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 a rule. 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 in the ASCII character set. Plain text has no formatting code; so no type styles (e.g. bold and italic), embedded images or charts, etc. On the Windows platform, plain text documents typically have file names which end with the .txt extension. Plain text is the most portable format because it is supported by nearly every application on every machine.

2.15.27 Private information store


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

2.15.28 Profile
A file containing essential information used by mail clients, which may include the location of a recipient's Inbox, Outbox, address lists, information stores, and other information services.

2.15.29 Public information store


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

2.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 (not an entity such as a company, institution, school, or any other organization) to whom an email message is sent. If an email account is not assigned to a natural person, then the entity's corresponding service or department constitutes the "recipient"; for example, the Sales Department of an organization would be the recipient of the address <sales@domain.com> if more than one staff member is responsible for replying to messages sent to the email account.

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

Copyright 2005-2013 Fookes Holding Ltd

141

Aid4Mail 3 Help

2.15.33 SSL
SSL stands for Secure Socket Layer and is a cryptographic protocol that provides security for communications over networks such as the internet. It is the predecessor of the Transport Layer Security (TLS). OpenSSL is a widely used open source implementation of the SSL and TLS protocols.

2.15.34 Status Flags/Indicators


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

2.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 key are 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 for communications over networks such as the internet. It is the successor, Secure Socket Layer (SSL). OpenSSL is a widely used open source implementation of the SSL and TLS protocols.

2.15.38 TNEF
TNEF (Transport Neutral Encapsulation Format) is a proprietary format of email attachment used by Microsoft Outlook and Microsoft Exchange Server when sending messages formatted as Rich Text Format (RTF). Most non-Microsoft mail clients cannot decipher TNEF data. Consequently, when you receive a TNEF-encoded message with a non-Microsoft mail client, the TNEF part usually appears as an attached file (usually named WINMAIL.DAT).

2.15.39 Unicode PST


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

2.15.40 Unpurged mail


When you move a message from one folder to another in your email client, or delete a message, the process is more complicated that it would initially seem. A copy of the message is placed in the appropriate destination folder, but the original message is not removed immediately. Instead it is flagged as "unpurged", and hidden from display, until such a time that the folder that contains it is compacted or expunged. The reason for this behavior is to optimize the move/delete process by not having to reorganize a mailbox every time a message is removed from it. As mailboxes can become very large, and messages
Copyright 2005-2013 Fookes Holding Ltd

Reference Information

142

can usually be moved around without limitation, this can provide a considerable time-saving. However it also means that when you process a mailbox with Aid4Mail, the mailbox can potentially contain unpurged messages. As these messages are generally unwanted, they are automatically skipped by the Home and Professional versions of Aid4Mail. The eDiscovery versions offer an option to process unpurged mail, which is usually only required in a forensics context.

2.15.41 UTC
UTC is a time system called Coordinated Universal Time. Time zones around the World are expressed as positive or negative offsets from UTC.

3
3.1

Purchasing and License Agreement


Ordering Information
You can buy Aid4Mail through our online order page. We have no local dealers. Our software is sold world-wide by cleverbridge, a leading e-commerce company. Cleverbridge is under contract with Fookes Software to process orders and collect payments. They accept orders online using a credit card (Visa, MasterCard, American Express, JCB), PayPal, wire transfer and, under certain conditions, purchase order. Purchase orders are only available to corporate customers and must use your official company letterhead. You will receive the cleverbridge fax number in a later step. If you require immediate product delivery, please use the credit card or PayPal payment option instead.

3.2 3.3

Upgrade Policy
Maintenance releases, updates, and upgrades are free during the validity of your subscription period.

Refund Policy
All of Fookes Software's products can be evaluated, free of charge, through a trial mode or separate trial version that can be downloaded directly from our website. Use the trial before you purchase to ensure that the full product will be compatible with your computer systems and satisfy your requirements. If you do not, you accept that the product may not meet your needs and that this will not justify a refund or chargeback. If you experience an issue with our software, then please contact our customer support service for help in solving the problem. All sales are final and refunds are provided only for accidental duplicate orders. Refunds will only be made to the credit card or PayPal account through which the original purchase was made. An administration fee may apply in such cases to cover processing costs and third-party commissions. Ordering a software license signifies your acceptance of this Refund Policy.

3.4

Software Piracy
Software piracy may be tempting to those who are not familiar with the risks. But far from being an innocent, victimless crime, software piracy exposes users to many cyber-security hazards like identity theft and malware such as viruses, worms, and trojans. It also weakens the value of intellectual property,

Copyright 2005-2013 Fookes Holding Ltd

143

Aid4Mail 3 Help

which is one of the key drivers of innovation and the way millions of people earn a living. When you buy authentic software, the benefits of ownership far exceed the software itself. Fookes Software stands behind its products, and as a partner you can depend on us for customer support, important updates, and future upgrades. By purchasing our products legally, you gain peace of mind knowing that your programs are safe, stable, and absolutely free of viruses and other malware. You cannot put a price on that kind of confidence. Report Piracy Confidentially Software piracy, or unlicensed software is the unauthorized copying or distribution of copyrighted software. This can be done by copying, downloading, sharing, selling, or installing multiple copies onto personal or work computers. It is illegal, increases security risks and results in economic harm such as loss of jobs and tax revenue. Visit the nopiracy.com site to report piracy confidentially. You could be eligible for a $1 million reward.

3.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 the Licensee'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, if you are using an Evaluation License as or on behalf of an entity, and/or have registered for any other license as or on behalf of an entity, such as a corporation, partnership, limited liability company or other entity, the term "you" used below refers to the entity which will be bound by this Agreement. You represent and warrant that you have power and authority to enter into this Agreement on behalf of the entity. This Agreement does not address any third-party or free or open source software separately licensed to you. By clicking the "I accept the Agreement" option during installation and/or by accepting the Agreement on the online order form and/or by using Aid4Mail, you confirm your acceptance of, and agree to be bound by, this Agreement. If you do not agree to this Agreement or if you do not understand it, do not purchase, install, or use Aid4Mail. In case you have another written agreement directly with Fookes Software, such written agreement prevails in the event of any conflict with the terms and conditions of this Agreement. 1. Definitions. "Activation Code" means a unique string of characters (for example SW-7XH4ESFNFJHW) that is entered into a license activation dialog box. There are three types of activation codes: single-user codes (one unique activation code per Seat), multi-user codes (one unique activation code for multiple Seats), and temporary trial codes. An activation code ties a Seat to an operating system user logon account of the computer (not a server) on which the Software is activated or re-activated. "CLI" means a command line interface format (used in console editions). "GUI" means a graphical user interface format.

Copyright 2005-2013 Fookes Holding Ltd

Purchasing and License Agreement

144

"Individual End User" means one natural person, not an Organization. "Key File" means a special file created by Fookes Software for a Licensee that contains information used to unlock Software features when pre-defined conditions are met. A Key File is offered with certain eDiscovery, console, and OEM editions of Aid4Mail. "Mail" means email messages, email files, mailbox files, email folders, email profiles, email stores, and/ or email databases. "Mail Account" means Mail stored from one or more related email addresses that are assigned to one Individual End User for receiving, sending, and/or archiving email messages. Email addresses are related in a Mail Account holding more than one email address if all addresses are connected to an Individual End User's single email profile or, if there is no such profile, to the Individual End User's single email client program. "Mail Migration" means exporting Mail from one system to another, the latter system being used to receive and/or send email messages. "Organization" means any for-profit or non-profit sole proprietorship, unincorporated association, joint venture, partnership, trust, limited liability company, corporation, or other legal entity, or government (including but not limited to any agency, bureau, department division or instrumentality). "Professional" means in connection with activities of your Organization (if any), or for any other commercial or professional purposes, whether for-profit, non-profit or governmental. "Regular Mode" means Software operating with a purchased Activation Code or Key File that deactivates Trial Mode. "Seat" means one operating system user logon account (for example a Windows user logon account) on one computer (not a server) with the ability to run the Software in Regular Mode. "Site" means an Organization's work location within a geographical area whose radius is 10 miles (16 km). The geographical restriction does not apply to Staff Members at the Site who Use the Software on a laptop for their work at home or while traveling. "Software" means the relevant version of Aid4Mail in executable form (GUI and/or CLI format) and documentation, and including operation in Trial Mode or Regular Mode. "Staff Member" means an employee and/or individual contractor working for an Organization. "Subscription Period" means a period of time specified on the receipt for the Software during which you are licensed to run the Software in Regular Mode and, for Software licenses purchased from Fookes Software or its resellers, to receive free Software updates and customer support as described herein. "Trial Mode" means Software operating without a purchased Activation Code or Key File, and for which you are obtaining a no-charge evaluation license. "Trial Pack age" means the edition of Aid4Mail available in the public area of the Fookes Software website without any Activation Code or Key File. "Use" means loading, installing, executing, displaying, performing and/or transmitting the Software for your internal business purposes, and not for distribution or resale. 2. Software License Grants.
Copyright 2005-2013 Fookes Holding Ltd

145

Aid4Mail 3 Help

2.1. Trial Mode License. Subject to the terms and conditions of this Agreement, Fookes Software hereby grants you a nonsublicensable, nonexclusive, nontransferable license to Use the Software in Trial Mode without charge and for evaluation purposes only in a non-production test environment. You may make as many copies of the Software as is reasonably necessary for evaluating the Software. All copies must reproduce copyright notices of the Software. Files created by the Software in Trial Mode are for evaluation purposes only and must be destroyed once evaluation is complete. Software in Trial Mode operates with limitations as described on the Aid4Mail website (www.aid4mail. com). By accepting this Agreement you also accept the limitations described on the Aid4Mail website. 2.2. Regular Mode License. A Regular Mode license becomes effective when Trial Mode is deactivated through the purchase and/or use of either a valid Activation Code or Key File. Regular Mode licenses are available for purchase for Personal Use and/or Professional Use. 2.2.1. Activation Codes. If you purchase and/or use an Activation Code, you agree to comply with the license activation and verification procedure described in part in this section of the Agreement, and more fully on the Product Activation page. The activation technology may prevent your use of the Software if you do not follow the activation process described in the Software. Activation requires an internet connection (unless you have purchased or received an offline option for activation). An Activation Code may be moved from an old computer to a new one that replaces it, as long as such Activation Code is not reused again on the old computer. Conditions for transferring an Activation Code to another user depend on the type of license purchased (see License Types section). Moving an Activation Code to another computer or user account requires license re-activation through an Internet connection (unless you have an offline option for the new location). Our activation technology allows a reasonable number of re-activations within a certain time period. If the number of re-activations exceeds the re-activation quota, it locks out further re-activations until the lockout period expires. The Subscription Period starts when the Activation Code is activated for the first time, or immediately following a previous Subscription Period if it was renewed prior to termination, or on re-activation of the code after the expiry of a previous Subscription Period. 2.2.2. Key Files. A Key File is a special file that ties the Software to pre-determined hardware or bundled software. Trial Mode is deactivated only if the data stored in the Key File matches the pre-determined hardware or software. Furthermore, depending on the nature of the key, the Software may require a system clock set to the correct date and/or access to a Fookes Software license validation server on the Internet. Failing this, the license protection technology may prevent your use of the Software. If a Subscription Period is defined in the Key File, it starts on the date that the Key File was created by Fookes Software. If you obtained your copy from an OEM, your OEM will inform you of the Subscription Period. 2.4. License Types.
Copyright 2005-2013 Fookes Holding Ltd

Purchasing and License Agreement

146

The specific license type is specified on the receipt for the Software license that you purchased from Fookes Software, a reseller or original equipment manufacturer (OEM). Each of the following licenses is subject to your compliance with the terms and conditions of this Agreement, including payment. 2.4.1. Aid4Mail Home Personal. Fookes Software hereby grants you the right and license, during the applicable Subscription Period, to Use the Software exclusively to process non-Professional Mail belonging to one Individual End User. An Activation Code may be re-activated on a different computer or under a different user account as long as the Mail processed in the new location belongs to the same Individual End User. 2.4.2. Aid4Mail Professional Personal. Fookes Software hereby grants you the right and license, during the applicable Subscription Period, to Use the Software to process no more than one Mail Account per Activation Code. Such license is for Professional Use to perform tasks that include Mail Migration and archiving, but not e-discovery or forensic examination. An Activation Code may be transferred only if the license Subscription Period is a minimum of one year. An Activation Code may be re-activated on a different computer or under a different operating system user logon account as long as the Mail Account processed in the new location is the same as in the original location. Once an Activation Code has been used to process one Mail Account, it may not be used to process another Mail Account except as stated in the next paragraph. An Activation Code may be transferred only within your Organization from one Staff Member to another if the initial Staff Member is no longer employed by your Organization or is permanently reassigned to another post. Such a transfer may occur no sooner than one month after the start of a Subscription Period and no more than four times within a yearly Subscription Period. 2.4.3. Aid4Mail Professional Site. Fookes Software hereby grants you the right and license, during the applicable Subscription Period, to Use one multi-user Activation Code for as many Seats as specified on the receipt for the Software license. All Seats linked to the Activation Code must be located at a single Site. You may process as many Mail Accounts as you have Seats. Such license is for Professional Use to perform tasks that include Mail Migration and archiving, but not e-discovery or forensic examination. The user who activates the first Seat will receive an email with all the instructions required to open a license control panel ("LCP") account. The LCP is provided for managing the Activation Code and associated Seats. The Activation Code cannot be transferred to another Site. A Seat may be transferred from one Staff Member to another at the same Site if the initial Staff Member is no longer employed at the Site or is permanently reassigned to another post. The transfer process requires that the old Seat be de-activated prior to transfer. A delay of between 24 and 72 hours is imposed before activation of another Seat is possible. 2.4.4. Aid4Mail eDiscovery Forensic. Fookes Software hereby grants you the right and license, during the applicable Subscription Period, to
Copyright 2005-2013 Fookes Holding Ltd

147

Aid4Mail 3 Help

Use the Software with one Activation Code or Key File. Such license is for Professional Use to perform tasks that include e-discovery, forensic examination, and archiving, but not Mail Migration. Such license held by a government Organization may be exercised to process any number of Mail Accounts belonging to your Organization or to third parties, as long as the Software can be operated from one Seat. However, you may not process Mail as part of a for-profit service to clients or other third parties unless you have a separate valid license for each of their Mail Accounts. (Aid4Mail eDiscovery Service may be more appropriate in this case.) Such license held by an Organization (other than a government Organization) may be exercised for internal purposes only to process any number of Mail Accounts belonging to the Organization as long as the Software can be operated from one Seat. You may not make the Software available to other users in your Organization or third parties, whether directly by offering access to the operating system user logon account from which it can be executed, or indirectly through a network system. An Activation Code may be transferred within your Organization from one Staff Member to another if the initial Staff Member is no longer employed by your Organization or is permanently reassigned to another post. Such a transfer may occur no sooner than one month after the start of a Subscription Period and no more than four times within a yearly Subscription Period. 2.4.5. Aid4Mail eDiscovery Archivist. Fookes Software hereby grants you the right and license, during the applicable Subscription Period, to Use the Software with one Activation Code or Key File. Such license is for Professional Use limited to performing archiving tasks for purposes of preservation and access in research collections, including limited e-discovery, forensic examination and Mail Migration incidental to archiving. Such license held by a government or non-profit Organization may be exercised to process any number of Mail Accounts belonging to your Organization or to third parties, as long as the Software can be operated from one Seat. However, you may not process Mail as part of a for-profit service to clients or other third parties unless you have a separate valid license for each of their Mail Accounts. (Aid4Mail eDiscovery Service may be more appropriate in this case.) Such license held by an Organization (other than a government or non-profit Organization) may be exercised for internal purposes only to process any number of Mail Accounts belonging to the Organization as long as the Software can be operated from one Seat. You may not make the Software available to other users in your Organization or third parties, whether directly by offering access to the operating system user logon account from which it can be executed, or indirectly through a network system. An Activation Code may be transferred within your Organization from one Staff Member to another if the initial Staff Member is no longer employed by your Organization or is permanently reassigned to another post. Such a transfer may occur no sooner than one month after the start of a Subscription Period and no more than four times within a yearly Subscription Period. 2.4.6. Aid4Mail eDiscovery Service. Fookes Software hereby grants you the right and license, during the applicable Subscription Period, to Use the Software with one Activation Code or Key File. Such license is for Professional Use limited to providing paid or unpaid bona fide e-discovery, forensic examination and archiving services, but not for
Copyright 2005-2013 Fookes Holding Ltd

Purchasing and License Agreement

148

Mail Migration services. Such license may be exercised to process any number of Mail Accounts belonging to your Organization (government, non-profit or otherwise) or to third parties, as long as the Software can be operated from one Seat. You may not make the Software available to other users in your Organization or to third parties, whether directly by offering access to the operating system user logon account from which it can be executed, or indirectly through a network system. An Activation Code may be transferred within your Organization from one Staff Member to another if the initial Staff Member is no longer employed by your Organization or is permanently reassigned to another post. Such a transfer may occur no sooner than one month after the start of a Subscription Period and no more than four times within a yearly Subscription Period. 2.4.7. Aid4Mail eDiscovery Personal. Fookes Software hereby grants you the right and license, during the applicable Subscription Period, to Use the Software to process no more than one Mail Account per Activation Code or Key File. Such license is for Professional Use to perform tasks that include e-discovery, forensic examination, archiving, and Mail Migration purposes. An Activation Code may be re-activated on a different computer or under a different operating system user logon account as long as the Mail Account processed in the new location is the same as in the original location. Once an Activation Code has been used to process one Mail Account, it may not be used to process another Mail Account except as stated in the next paragraph. An Activation Code may be transferred within your Organization from one Staff Member to another if the initial Staff Member is no longer employed by your Organization or is permanently reassigned to another post. Such a transfer may occur no sooner than one month after the start of a Subscription Period and no more than four times within a yearly Subscription Period. 2.4.8. Aid4Mail Console Migrator. Fookes Software hereby grants you the right and license, during the applicable Subscription Period, to Use Aid4Mail Console with a Key File for as many Seats as specified on the receipt for the Software license. All Seats must be located at a single Site. You may process as many Mail Accounts as you have Seats. Such license is for Professional Use to perform tasks that include Mail Migration and archiving, but not e-discovery or forensic examination. The Key File for this license may not be transferred to another Site. 2.4.9. Aid4Mail Console Personal / Archivist / Forensic / Service / Site. If you purchase a license to Aid4Mail eDiscovery Personal (GUI format), you also are eligible to purchase 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 purchase a corresponding license on the same terms to Aid4Mail Console Archivist (CLI format). If you purchase a license to Aid4Mail eDiscovery Forensic (GUI format), you also are eligible to purchase a corresponding license on the same terms to Aid4Mail Console Forensic (CLI format). Aid4Mail eDiscovery Service (GUI format) is bundled and sold together on the same terms with Aid4Mail Console Service (CLI format). There is no option to purchase Aid4Mail Console Service separately.
Copyright 2005-2013 Fookes Holding Ltd

149

Aid4Mail 3 Help

If you purchase a license to Aid4Mail Professional Site (GUI format) with 50 or more Seats, you also are eligible on request and at no extra charge to receive a corresponding license on the same terms to Aid4Mail 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, to Use Aid4Mail Console on a server with a Key File. Pricing, Subscription Period, number of Seats accessing the Software or number of Mail Accounts processed by it, type of usage (e.g., mail conversion, filtering, data extraction, archiving, e-discovery, third-party processing), and other special terms are agreed in writing by email or other means between you and Fookes Software prior to purchase. 2.5 License Restrictions. The Software is licensed, not sold. This Agreement only gives you the rights according to the chosen license type (section 2); Fookes Software reserves all other rights. Especially you may not: (a) modify, adapt, translate, rent, lease or sublicense (including offering the Software to third parties on an application service provider, web service or time sharing basis) the Software except to the extent explicitly permitted in the chosen license type (section 2) above; (b) disable, block or circumvent any licensing, rights management or control features of the Software except as an intended part of the Software's programming features; (c) assign, loan, resell, transfer, distribute or otherwise make accessible the Software, except as set forth in section 6; (d) modify, decompile, disassemble or reverse engineer the Software, except to the limited extent permitted by applicable law; (e) remove or modify any legal notices in the Software; or (f) make more copies of the Software, other than (i) for the use granted by the chosen license type (section 2), (ii) for back-up purposes, and/or (iii) except as set forth in sections 2.1 and 6. It is your responsibility to make a back-up copy of the Software installation file and your registration details, including Activation Codes, Key Files and passwords if any, off your computer and place these in a safe location that is not accessible to other users. If you manage Activation Codes for other users, it is your responsibility to keep track of which Activation Codes and passwords are assigned to which users. 3. Customer Support / Software Maintenance / Feedback. Fookes Software provides customer support and software maintenance that is generally at no extra charge during the Subscription Period and exclusively by email in English, to the extent that Fookes Software at its sole discretion shall determine to be reasonable ("Customer Support"). If you are an Organization, Customer Support is provided only to your support Staff Members, not all Staff Members. Fookes Software has no obligation to provide Customer Support for any Trial Package, discontinued products and old Software versions that were released more than six months prior to the release of the latest update or upgrade. For OEM versions, contact your OEM or distributor for customer support, as Fookes Software does not provide Customer Support for those versions. By emailing, uploading, posting, or otherwise transmitting or submitting any content, information or ideas to Fookes Software, you automatically grant (or warrant that the owner of such rights has expressly granted) to Fookes Software a perpetual, irrevocable, royalty-free, worldwide, 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, without compensation to you, unless otherwise expressly agreed in writing by Fookes Software. However, Fookes Software holds the
Copyright 2005-2013 Fookes Holding Ltd

Purchasing and License Agreement

150

contents of any Mail files and screen shots sent to us for software testing and improvement strictly confidential, except as may be required by applicable law. You bear all responsibility for ensuring that email replies from Fookes Software can reach you. Fookes Software cannot be held responsible if its emails to you are blocked by your Internet service provider (ISP), or your email server, or your email program's spam/junk-mail filters. If necessary, you will provide an alternative email address that can receive emails from Fookes Software. 4. Refund Policy. The Software in Trial Mode is available for download free of charge from the Fookes Software web site. It is intended to allow potential customers to evaluate before purchase, whether the Software is compatible with their computer systems, email programs and data, and will satisfy their requirements. AS A RESULT, ALL SALES ARE FINAL AND REFUNDS ARE PROVIDED ONLY FOR ACCIDENTAL DUPLICATE ORDERS. Refunds will be made only to the credit card or PayPal account through which the original purchase was made. An administration fee may apply in such cases to cover processing costs and third-party commissions. 5. Ownership. The Software is proprietary to Fookes Software and its suppliers, and is licensed, not sold, to you notwithstanding any reference herein to "purchases." You acknowledge and agree that: (a) the Software is protected under U.S. copyright and other national and international copyright laws; (b) Fookes Software and its suppliers retain all copyrights and other intellectual property rights in the Software; (c) there are no implied licenses under this Agreement, and any rights not expressly granted to you hereunder are reserved by Fookes Software; (d) you acquire no ownership or other interest (other than your license rights) in or to the Software; and (e) Fookes Software and/or its suppliers owns all copies of the Software, however made. You agree that you will not, at any time, contest anywhere in the world the ownership of Fookes Software and/or its suppliers of, or rights in, the Software. You have no rights hereunder to use any trademark or service mark belonging to Fookes Software. 6. Distribution of the Trial Package. Provided that you are distributing the then-current Release Version of the Trial Package you are hereby licensed to make as many copies of the Trial Package as you wish; give exact copies of the original Trial Package to anyone; and distribute the Trial Package in its unmodified form via electronic means (Internet, software distribution libraries, CD-ROMs, DVDs, etc.). You may charge a small distribution fee for the Trial Package, but you must not represent in any way that you are selling or licensing the Software itself. All copies must reproduce copyright notices of the Software. You may not make the Trial Package available on any site, CD-ROM, DVD, or with any package, or with any other medium or service, which makes available or contains viruses, virus source code, virus construction programs, virus creation material, spyware, malware or other malicious code or material. You will not make any advertising or representation relating to Fookes Software or Software that is misleading or deceptive or that is inconsistent with Fookes Software marketing materials or web sites. Permission to distribute the Trial Package is not transferable, assignable, saleable, or franchisable, and any attempt to do so is void. Each entity wishing to distribute the Trial Package must independently satisfy the terms of the foregoing distribution license. 7. Updates and Upgrades. To Use an update or an upgrade of the Software or to upgrade your license type to a license type with more features ("Update"), you must possess a valid license to the updateable or upgradeable version of
Copyright 2005-2013 Fookes Holding Ltd

151

Aid4Mail 3 Help

the Software or license type you want to Update. You agree that once you start using an Update, you lose your right to Use the Software or license type (if replaced by a new one or other system) that was the basis of the Update ("Previous Version"). You also agree that you will not transfer a Previous Version to another person or entity, and that you may Use the Update only in accordance with the terms of this Agreement. 8. Compliance. You shall conduct your business in compliance with all laws and regulations in any way applicable to the Software or to the performance of your obligations under this Agreement. Without limiting the foregoing, you shall not take any action that would violate, or cause Fookes Software to be in violation of, any applicable law of the United States or any other jurisdiction including but not limited to the U.S. Foreign Corrupt Practices Act and all import and export laws, regulations and restrictions of the United States or any foreign agency or authority. 9. U.S. Government Rights. This is a notice to U.S. Government End Users: The Software and the documentation which accompanies the Software are "Commercial Items," as that term is defined at 48 C.F.R. 2.101, consisting of "Commercial Computer Software" and "Commercial Computer Software Documentation," as such terms are used in 48 C.F.R. 12.212 or 48 C.F.R. 227.7202, as applicable. Consistent with 48 C.F.R. 12.212 or 48 C.F.R. 227.7202-1 through 227.7202-4, as applicable, the Commercial Computer Software and Commercial Computer Software Documentation are being licensed to U.S. Government end users (a) only as Commercial Items and (b) with only those rights as are granted to all other end users pursuant to the terms and conditions herein. Fookes Software Ltd, La Petite Fin 27, 1637 Charmey, Switzerland. 10. WARRANTY DISCLAIMER AND LIMITATION OF LIABILITY. THE SOFTWARE AND CUSTOMER SUPPORT IS PROVIDED ON AN "AS IS" BASIS. FOOKES SOFTWARE DISCLAIMS AS FAR AS LEGALLY PERMISSIBLE ALL WARRANTIES RELATING TO THE SOFTWARE AND CUSTOMER SUPPORT, WHETHER EXPRESSED, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF SATISFACTORY QUALITY, MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT . FOOKES SOFTWARE DOES NOT WARRANT THAT THE SOFTWARE WILL MEET YOUR REQUIREMENTS OR BE UNINTERRUPTED, SECURE, ERROR-FREE OR COMPATIBLE WITH ANY PRODUCT. NEITHER FOOKES SOFTWARE NOR ANYONE ELSE WHO HAS BEEN INVOLVED IN THE CREATION, PRODUCTION, OR DELIVERY OF THE SOFTWARE OR CUSTOMER SUPPORT ("SUPPLIERS") SHALL BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES (INCLUDING BUT NOT LIMITED TO LOST REVENUES, PROFITS AND/OR SAVINGS) ARISING OUT OF THE USE OR INABILITY TO USE SUCH SOFTWARE, EVEN IF FOOKES SOFTWARE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR CLAIMS. THE PERSON USING THE SOFTWARE BEARS ALL RISK AS TO THE QUALITY AND PERFORMANCE OF THE SOFTWARE. THE ENTIRE LIABILITY OF FOOKES SOFTWARE AND ITS SUPPLIERS, AND YOUR EXCLUSIVE REMEDY, WITH RESPECT TO THE USE OF THE SOFTWARE OR CUSTOMER SUPPORT OR ANY BREACH OF THIS AGREEMENT ARE LIMITED TO THE AMOUNT ACTUALLY PAID BY YOU, IF ANY, FOR USE OF THE SOFTWARE. YOU HEREBY RELEASE FOOKES SOFTWARE AND SUCH OTHER PERSONS FROM ANY AND ALL OBLIGATIONS, LIABILITIES AND CLAIMS IN EXCESS OF THIS LIMITATION. YOU AGREE THAT ANY CLAIM OR CAUSE OF ACTION ARISING OUT OF OR RELATED TO USE OF THE SOFTWARE OR THIS AGREEMENT MUST BE FILED WITHIN ONE (1)
Copyright 2005-2013 Fookes Holding Ltd

Purchasing and License Agreement

152

YEAR AFTER SUCH CLAIM OR CAUSE OF ACTION AROSE OR BE FOREVER BARRED. YOU ARE SOLELY RESPONSIBLE FOR SELECTION, INSTALLATION AND LAUNCH OF THE SOFTWARE AND FOR BACKING UP YOUR DATA AND FILES, AND HEREBY RELEASE FOOKES SOFTWARE AND ITS SUPPLIERS FROM ANY LIABILITY OR DAMAGES DUE TO THE LOSS OF ANY SUCH DATA OR FILES. FOOKES SOFTWARE IS NOT LIABLE FOR ANY INAPPROPRIATE OR ILLEGAL USE OF THE SOFTWARE. 11. Governing Law / Jurisdiction. This Agreement is governed by Swiss Law, subject to the express exclusion of the United Nations Convention on Contracts for the International Sale of Goods (CISG, 1980). The parties consent to the exclusive jurisdiction of the competent Swiss courts of Gruyre, Switzerland, for the resolution of any litigation arising out or related to this Agreement. 12. Termination. Fookes Software may terminate this Agreement at any time upon default by you of the license provisions of this Agreement, or any other material default by you of this Agreement not cured within thirty (30) days after written notice thereof. Except for Sections 2, 3 and 6, all provisions of this Agreement shall survive termination of this Agreement. 13. Severability Clause. If any provision of this Agreement is or becomes ineffective or if there is an omission from this Agreement, this does not affect the legal validity of the remaining provisions. The ineffective provision will be replaced by an effective provision that is as close as possible in economic terms to the provision wanted by the parties. The same procedure applies in the case of an omission. 14. General. You shall not assign, delegate or sublicense any of your rights or obligations under this Agreement, by operation of law or otherwise, without prior written consent of Fookes Software, and any attempt without such consent shall be void. Subject to the preceding sentence, this Agreement binds and benefits the permitted successors and assigns of the parties. Fookes Software may change the terms, conditions and pricing relating to the future licensing of its Software and other intellectual property rights, including this Agreement, from time to time. No waiver will be implied from conduct or failure to enforce rights nor is it effective unless in a writing signed on behalf of the party against whom the waiver is asserted. There are no third-party beneficiaries to this Agreement. Fookes Software is not bound by additional and/ or conflicting provisions in any purchase order or other correspondence unless expressly agreed in writing. This Agreement is the complete and exclusive statement of agreement between the parties as to its subject matter and supersedes all proposals or prior agreements, verbal or written, advertising, representations or communications concerning the Software.

Last Update to Aid4Mail End User License Agreement: August 05, 2011

AID4MAIL BETA AGREEMENT (Version: March 2010)


Copyright 2005-2013 Fookes Holding Ltd

153

Aid4Mail 3 Help

This Beta Agreement (this "Beta Agreement"), governs the terms and conditions of the Licensee's access to and use of certain beta test and pre-release versions of the Software (each a "Beta Version") and is made between you and Fookes Software. 1. General. The terms and conditions of the Aid4Mail End User License Agreement between you and Fookes Software, as the same may be updated from time to time (the "EULA") are incorporated herein by reference, and apply to the Beta Version. Defined terms used without definition in this Beta Agreement have the meanings given in the EULA. In the event of any conflict between the EULA and this Beta Agreement, this Beta Agreement controls. 2. Beta Version Background. Fookes Software may offer to you, and you may consent to receive, one or more Beta Versions from time to time prior to the commercial release of an official update or upgrade ("Release Version"). The primary purpose of a Beta Version is to facilitate user testing, identify defects and obtain user feedback. A Beta Version usually contains features and functionality that have not been tested or re-tested in full or in part and therefore may not work as specified. Do not use the Beta Version on any sensitive data unless you have backup copies in a safe location. Files produced by the Beta Version may contain errors and should be destroyed once testing is complete. 3. Beta Version License. This Beta Agreement applies whether you Use a Beta Version in Trial Mode or Regular Mode. Subject to the terms and conditions of this Agreement, Fookes Software hereby grants you a revocable, non-sublicensable, nonexclusive, nontransferable license without charge during the Beta Test Period to Use the Beta Version as follows: (i) if you are licensed to use a current version of the Software in Regular Mode, then you may Use the Beta Version in Regular Mode on the same terms as your current version, except that you may use the Beta Version for evaluation purposes only in a nonproduction test environment; and (ii) otherwise, you may use the Beta Version only in Trial Mode and for evaluation purposes only in a non-production test environment. You may make as many copies of the Beta Version as is reasonably necessary for evaluating the Beta Version. All copies must reproduce copyright notices of the Beta Version. Files created by the Beta Version are for evaluation purposes only and must be destroyed once evaluation is complete. The "Beta Test Period" commences on the date Fookes Software delivers the Beta Version to you and ends on the commercial release date of the corresponding Release Version, or if earlier, the date specified in writing by Fookes Software. The Beta Version may have limited functionality or may contain a time out feature that will cause it to be disabled and non-functional upon conditions designated by Fookes Software in its sole discretion. YOU UNDERSTAND AND AGREE THAT OPERATION OF THE BETA VERSION AND ACCESS TO YOUR DATA MAY TERMINATE UPON ANY SUCH CONDITION, UNLESS YOU OBTAIN AN UPDATED BETA VERSION OR PURCHASE A REGULAR VERSION OF THE SOFTWARE. 5. No License Fee. No license fees or royalties are payable under this Beta Agreement. 6. No Support. Unless stated otherwise in writing by Fookes Software, no Customer Support is provided for any Beta Version. 7. Confidentiality. (a) "Confidential Information" means any and all information concerning Fookes Software's unreleased products and services, trade secrets and other proprietary rights; descriptions of inventions, processes and technical know-how; specifications; documentation, and any other business, marketing or technical information disclosed in relation to this Beta Agreement. (b) The parties expressly agree that the source and object code of each Beta Version is Confidential Information of Fookes Software. In addition, if you received a copy of a Beta Version that is not available in the public area of the Fookes Software website or its related forums, then all new features and
Copyright 2005-2013 Fookes Holding Ltd

Purchasing and License Agreement

154

capabilities of that Beta Version are deemed Confidential Information of Fookes Software and must remain strictly confidential until they are made available to the general public. (c) "Confidential Information" shall not include information (i) already in your possession without an obligation of confidentiality; (ii) publicly available without breach of this Agreement or any other beta agreement or confidentiality agreement of Fookes Software; or (iii) required by law to be disclosed, provided that the you give Fookes Software reasonable notice so that it may prevent or limit such required disclosure. (d) You shall hold all Confidential Information in strict confidence, and may disclose such Confidential Information only to your employees and contractors who have a "need to know" such information. You shall not use or permit the use of any Confidential Information for benefit of yourself or any third party except as necessary to perform under this Beta Agreement. You are responsible for any violation of this section by your directors, officers, employees, independent contractors and advisors. (e) You acknowledge that any breach of this Section will result in irreparable harm to Fookes Software for which damages would be an inadequate remedy and in the event of such breach and in addition to its rights and remedies otherwise available at law, Fookes Software shall be entitled to equitable relief, including injunctive relief, without the posting of a bond. 8. Feedback. By emailing, uploading, posting, or otherwise transmitting or submitting any content, information or ideas to Fookes Software, you automatically grant (or warrant that the owner of such rights has expressly granted) to Fookes Software a perpetual, irrevocable, royalty-free, worldwide, nonexclusive, sublicensable right and license to use, reproduce, modify, publish, distribute, display, perform, and transmit such content, information and ideas, in public or non-public form, without compensation to you, unless otherwise expressly agreed in writing by Fookes Software. However, Fookes Software holds the contents of any Mail files and screen shots sent to us for software testing and improvement strictly confidential, except as may be required by applicable law. 9. WARRANTY DISCLAIMER AND LIMITATION OF LIABILITY. THE BETA VERSION IS PROVIDED ON AN "AS IS" BASIS. FOOKES SOFTWARE DISCLAIMS AS FAR AS LEGALLY PERMISSIBLE ALL WARRANTIES RELATING TO THE BETA VERSION, WHETHER EXPRESSED, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY IMPLIED WARRANTIES OF SATISFACTORY QUALITY, MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT . FOOKES SOFTWARE DOES NOT WARRANT THAT THE BETA VERSION WILL MEET YOUR REQUIREMENTS OR BE UNINTERRUPTED, SECURE, ERROR-FREE OR COMPATIBLE WITH ANY PRODUCT. NEITHER FOOKES SOFTWARE NOR ANYONE ELSE WHO HAS BEEN INVOLVED IN THE CREATION, PRODUCTION, OR DELIVERY OF THE BETA VERSION ("SUPPLIERS") SHALL BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE DAMAGES (INCLUDING BUT NOT LIMITED TO LOST REVENUES, PROFITS AND/OR SAVINGS) ARISING OUT OF THE USE OR INABILITY TO USE THE BETA VERSION, EVEN IF FOOKES SOFTWARE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR CLAIMS. THE PERSON USING THE BETA VERSION BEARS ALL RISK AS TO THE QUALITY AND PERFORMANCE OF THE BETA VERSION. THE ENTIRE LIABILITY OF FOOKES SOFTWARE AND ITS SUPPLIERS, AND YOUR EXCLUSIVE REMEDY, WITH RESPECT TO THE USE OF THE BETA VERSION OR ANY BREACH OF THIS BETA AGREEMENT ARE LIMITED TO THE AMOUNT ACTUALLY PAID BY YOU, IF ANY, FOR USE OF THE BETA VERSION. YOU HEREBY RELEASE FOOKES SOFTWARE AND SUCH OTHER PERSONS FROM ANY AND ALL OBLIGATIONS, LIABILITIES AND CLAIMS IN EXCESS OF THIS LIMITATION. YOU AGREE THAT ANY CLAIM OR CAUSE OF ACTION ARISING OUT OF OR RELATED TO USE OF THE BETA VERSION OR THIS AGREEMENT MUST BE FILED WITHIN ONE (1) YEAR AFTER SUCH
Copyright 2005-2013 Fookes Holding Ltd

155

Aid4Mail 3 Help

CLAIM OR CAUSE OF ACTION AROSE OR BE FOREVER BARRED. YOU ARE SOLELY RESPONSIBLE FOR SELECTION, INSTALLATION AND LAUNCH OF THE BETA VERSION AND FOR BACKING UP YOUR DATA AND FILES, AND HEREBY RELEASE FOOKES SOFTWARE AND ITS SUPPLIERS FROM ANY LIABILITY OR DAMAGES DUE TO THE LOSS OF ANY SUCH DATA OR FILES. FOOKES SOFTWARE IS NOT LIABLE FOR ANY INAPPROPRIATE OR ILLEGAL USE OF THE BETA VERSION. 10. Governing Law / Jurisdiction. This Agreement is governed by Swiss Law, subject to the express exclusion of the United Nations Convention on Contracts for the International Sale of Goods (CISG, 1980). The parties consent to the exclusive jurisdiction of the competent Swiss courts of Gruyre, Switzerland, for the resolution of any litigation arising out or related to this Agreement.

Last Update to Aid4Mail Beta Agreement: March 26, 2010

3.6

Third Party Software Notices and/or Additional Terms and Conditions


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

Adobe Portable Document Format (PDF)


Intellectual Property The general idea of using an interchange format for electronic documents is in the public domain. Anyone is free to devise a set of unique data structures and operators that define an interchange format for electronic documents. However, Adobe Systems Incorporated owns the copyright for the particular data structures and operators and the written specification constituting the interchange format called the Portable Document Format. Thus, these elements of the Portable Document Format may not be copied without Adobes permission. Adobe will enforce its copyright. Adobes intention is to maintain the integrity of the Portable Document Format standard. This enables the public to distinguish between the Portable Document Format and other interchange formats for electronic documents. However, Adobe desires to promote the use of the Portable Document Format for information interchange among diverse products and applications. Accordingly, Adobe gives anyone copyright permission, subject to the conditions stated below, to: Prepare files whose content conforms to the Portable Document Format Write drivers and applications that produce output represented in the Portable Document Format Write software that accepts input in the form of the Portable Document Format and displays, prints, or otherwise interprets the contents Copy Adobes copyrighted list of data structures and operators, as well as the example code and PostScript language function definitions in the written specification, to the extent necessary to use the Portable Document Format for the purposes above The conditions of such copyright permission are:

Copyright 2005-2013 Fookes Holding Ltd

Purchasing and License Agreement

156

Authors of software that accepts input in the form of the Portable Document Format must make reasonable efforts to ensure that the software they create respects the access permissions and permissions controls listed in Table 3.20 of this specification, to the extent that they are used in any particular document. These access permissions express the rights that the documents author has granted to users of the document. It is the responsibility of Portable Document Format consumer software to respect the authors intent. Anyone who uses the copyrighted list of data structures and operators, as stated above, must include an appropriate copyright notice. This limited right to use the copyrighted list of data structures and operators does not include the right to copy this book, other copyrighted material from Adobe, or the software in any of Adobes products that use the Portable Document Format, in whole or in part, nor does it include the right to use any Adobe patents, except as may be permitted by an official Adobe Patent Clarification Notice (see the Bibliography). Adobe Patent Clarification Notice: Reading and writing PDF files Adobe has a number of patents covering technology that is disclosed in the Portable Document Format (PDF) Specification, version 1.3 and later, as documented in PDF Reference and associated Technical Notes (the "Specification"). Adobe desires to promote the use of PDF for information interchange among diverse products and applications. Accordingly, the following patents are licensed on a royalty-free, nonexclusive basis for the term of each patent and for the sole purpose of developing software that produces, consumes, and interprets PDF files that are compliant with the Specification: U.S. Patent Numbers: 5,634,064 5,737,599 5,781,785 5,819,301 6,028,583 6,289,364 6,421,460 In addition, the following patent is licensed on a royalty-free, nonexclusive basis for its term and for the sole purpose of developing software that produces PDF files that are compliant with the Specification (specifically excluding, however, software that consumes and/or interprets PDF files): U.S. Patent Number: 5,860,074 The above licenses are limited to only those rights required to implement the Specification and no others. That is to say, Adobe grants only those rights in the above patent(s) necessarily practiced to implement the Specification, and does not grant any rights not required to implement the Specification. The licenses do not grant the right to practice any patent covering other technologies, such as implementation techniques that are not explicitly disclosed in the Specification, nor does it allow the use of any patented feature for any purpose other than as set forth in the applicable license grant. Adobe has other patents in various fields, none of which are hereby licensed.

Delphi Encryption Compendium version 5.2 (DEC Part I)


A compendium of various strong encryption algorithms and hash functions for Delphi. Some of the algorithms Aid4Mail uses from this library include MD5, SHA1, SHA256, SHA384, and SHA512.
Copyright 2005-2013 Fookes Holding Ltd

157

Aid4Mail 3 Help

Copyright 2006 Hagen Reddmann, HaReddmann@t-online.de Modifications 2008 Arvid Winkelsdorf, digivendo GmbH, info@digivendo.de THIS SOFTWARE IS PROVIDED BY THE AUTHORS ''AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

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


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

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


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

Copyright 2005-2013 Fookes Holding Ltd

Purchasing and License Agreement

158

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 provided that the following conditions are met: 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. All advertising materials mentioning features or use of this software must display the following acknowledgment: "This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. (http://www.openssl.org/)" 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact openssl-core@openssl.org. 5. Products derived from this software may not be called "OpenSSL" nor may "OpenSSL" appear in their names without prior written permission of the OpenSSL Project. 6. Redistributions of any form whatsoever must retain the following acknowledgment: "This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www. openssl.org/)" THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT "AS IS" AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. This product includes cryptographic software written by Eric Young (eay@cryptsoft.com). This product includes software written by Tim Hudson (tjh@cryptsoft.com).

Original SSLeay License Copyright 1995-1998 Eric Young (eay@cryptsoft.com). All rights reserved. This package is an SSL implementation written by Eric Young (eay@cryptsoft.com). The implementation was written so as to conform with Netscape's SSL. This library is free for commercial and non-commercial use as long as the following conditions are adhered to. The following conditions apply to all code found in this distribution, be it the RC4, RSA, lhash, DES, etc., code; not just the SSL code. The SSL documentation included with this distribution is covered by the same copyright terms except that the holder is Tim Hudson (tjh@cryptsoft.com). Copyright remains Eric Young's, and as such any Copyright notices in the code are not to be removed. If
Copyright 2005-2013 Fookes Holding Ltd

159

Aid4Mail 3 Help

this package is used in a product, Eric Young should be given attribution as the author of the parts of the library used. This can be in the form of a textual message at program startup or in documentation (online or textual) provided with the package. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: 1. Redistributions of source code must retain the copyright notice, this list of conditions and the following disclaimer. 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. 3. All advertising materials mentioning features or use of this software must display the following acknowledgement: "This product includes cryptographic software written by Eric Young (eay@cryptsoft.com)" The word 'cryptographic' can be left out if the routines from the library being used are not cryptographic related. 4. If you include any Windows specific code (or a derivative thereof) from the apps directory (application code) you must include an acknowledgement: "This product includes software written by Tim Hudson (tjh@cryptsoft.com)" THIS SOFTWARE IS PROVIDED BY ERIC YOUNG "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. The licence and distribution terms for any publicly available version or derivative of this code cannot be changed. i.e. this code cannot simply be copied and put under another distribution licence [including the GNU Public Licence.]

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


PCRE is a library of functions to support regular expressions whose syntax and semantics are as close as possible to those of the Perl 5 language. Release 8 of PCRE is distributed under the terms of the "BSD" licence, as specified below. The documentation for PCRE is distributed under the same terms as the software itself. The basic library functions are written in C and are freestanding. Also included in the distribution is a set of C++ wrapper functions. The basic library functions are written by Philip Hazel Copyright (c) 1997-2013 University of Cambridge. All rights reserved. The C++ wrapper functions are contributed by Google Inc. Copyright (c) 2007-2012, Google Inc. All rights reserved. THE "BSD" LICENCE:
Copyright 2005-2013 Fookes Holding Ltd

Purchasing and License Agreement

160

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. Neither the name of the University of Cambridge nor the name of Google Inc. nor the names of their contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

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


Copyright Gustavo Huffenbacher Daud

RSA's MD5 disclaimer


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

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


Synapse is a Delphi library providing functions for network communications based on Winsock. Copyright (c)1999-2010, Lukas Gebauer. All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided

Copyright 2005-2013 Fookes Holding Ltd

161

Aid4Mail 3 Help

that the following conditions are met: Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. Neither the name of Lukas Gebauer nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

SZCodeBaseX library version 1.3.5b: www.szutils.net


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

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


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

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


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

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


zlib is a general purpose compression library. Copyright (C) 1995-2005 Jean-loup Gailly and Mark Adler This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software.

Copyright 2005-2013 Fookes Holding Ltd

Purchasing and License Agreement

162

Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions: 1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required. 2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software. 3. This notice may not be removed or altered from any source distribution.

4
4.1

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

Policies
1. 2. 3. 4. We are perfectionists and strive to develop useful, original, and reliable software solutions. We listen to our users and try to implement feature suggestions that benefit others. We are committed to providing excellent customer support by email. We are upfront about our services and products (no "small print") so that you can make an informed buying decision.

Our Websites
http://www.fookes.com http://www.aid4mail.com http://www.toutmail.com

Business Details
Fookes Software Ltd is registered in Switzerland and owned by its parent company Fookes Holding Ltd. The Fookes Software registration numbers are as follows: Reference Number: 2420/2008 Federal Number: CH-217-3540396-6 Trade Register details: Service du registre du commerce du Canton de Fribourg, Switzerland http://www.fr.ch/rc/ Fook es is a registered trademark of Fookes Holding Ltd.

Copyright 2005-2013 Fookes Holding Ltd

163

Aid4Mail 3 Help

4.2

Contacting Fookes Software


Answers to most of the questions we receive already exist in our documentation. Before contacting us, we suggest you first look through our Help files and online FAQs; this will help you get a solution in the shortest time possible. Please also verify that you are using the latest software update before reporting a problem. Technical support from Fookes Software representatives covers pre-sales questions, installation issues, license activation, and troubleshooting unexpected behavior related to documented features. It does not cover consulting, product training, help resolving unusual configurations, or assistance with developing scripts, templates, or search tasks. Troubleshooting software issues requires that you have the latest maintenance updates installed. We reply to email on business days from Monday to Friday. We usually reply within 24 hours, but on occasions it may take up to 3 business days. Please take into account that your "urgent" message may reach us in the middle of the night we are based in Switzerland (UTC+1). Note that technical support is provided by email only. Due to the high volume of spam reaching us, we no longer publish our email addresses on our website and in our documentation. As a result, it is now necessary to go through our mail form to establish the first contact. We apologize for any inconvenience. If you need to contact us by post, our office address is as follows: Fookes Software Ltd La Petite Fin 27 1637 Charmey Switzerland Please do NOT send Purchase Orders to the above address. Aid4Mail sales are handled for us by cleverbridge. Address and fax details are provided by cleverbridge after you select "Purchase Order" as a payment option on the order form, which is available by first going through our Order page.

4.3

Other Fookes Software Titles


ToutMail This is a localized version of Aid4Mail for French-speaking users. It is the only software on the market that is capable of correctly processing mailbox files created with the French version of Eudora. http://www.toutmail.com/ Mailbag Assistant If you're buried in email, Mailbag Assistant is guaranteed to save you time and frustration. This userfriendly application complements your mail program and offers powerful tools to search, organize, extract information, and view your messages. http://www.fookes.com/mailbag/ NoteTab Pro For those who demand the best. NoteTab Pro offers all the features HTML authors, programmers, businesses and other demanding users need to speed up their work. The registered version adds a thesaurus and a multilingual spell checker.

Copyright 2005-2013 Fookes Holding Ltd

Other Information

164

http://www.notetab.com/

4.4

Popular Mail Clients


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

Copyright 2005-2013 Fookes Holding Ltd

165

Aid4Mail 3 Help

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 undergoing development and beta testing: Jody Adair Alec Burgess Greg Chapman Dennis Cummins Alan Cummings Jim Hall Larry Hamilton Jrme Monteil Hugo Paulissen Harvey Savage Sheri Pierce Aid4Mail is developed in Delphi, a Embarcadero product. Portions of the Aid4Mail GUI are created with Raize Components. ZIP-file support is based on ZipForge from ComponentAce . This Help file was authored in Help & Manual, an EC Software product. The Setup program is made with the Inno Setup package developed by Jordan Russell. The license activation system is managed by softWORKZ Innovation Inc. See also the Third Party Software Notices and/or Additional Terms and Conditions topic.

Copyright and Disclaimer


All rights reserved. No parts of this work may be reproduced in any form or by any means graphic, electronic, or mechanical, including photocopying, recording, taping, or information storage and retrieval systems without the written permission of the publisher. Products that are referred to in this document may be either trademarks and/or registered trademarks of the respective owners. The publisher and the author make no claim to these trademarks. While every precaution has been taken in the preparation of this document, the publisher and the author assume no responsibility for errors or omissions, or for damages resulting from the use of information contained in this document or from the use of programs and source code that may accompany it. In no event shall the publisher and the author be liable for any loss of profit or any other commercial damage caused or alleged to have been caused directly or indirectly by this document.

Copyright 2005-2013 Fookes Holding Ltd

Index

166

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

/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

-Aa4m.exe 87 About Fookes Software 162 Accessibility Mode 52 Acknowledgements 165 Activation password 17 Additional Terms and Conditions Address export options 69 Advanced Options 132

155

167

Aid4Mail 3 Help

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

Custom formats using scripts

65

-DDates in Outlook 44 Daylight time 129 Delimiter 137 DNA.dll 17 DST.dat 129 Duplicate messages 69

-Ee-discovery 10 E-discovery or forensic-examination professional (but not 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
Copyright 2005-2013 Fookes Holding Ltd

-BBarca 22

-CCalculate command 84 Calypso 22 Check for Duplicates Across Folders - Advanced Options 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

Index

168

Export to PST 60 Export to Windows Live Mail and Windows Mail 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

Hotmail 61

22

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

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

-KKey Features 4

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

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

-M134 Mac computer 50 Mac Eudora 50 Mac OS X Mail 50 Mail Source screen 53 Mail.app 50 Mailbag Assistant 163 Mailbox 138

-HHome user migrating non-professional mail


Copyright 2005-2013 Fookes Holding Ltd

11

169

Aid4Mail 3 Help

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

Outlook Personal Storage 65 Outlook.com settings 121

-Ppartial 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 60

-NNames in Outlook 44 Namespace (IMAP) 121 Netscape Messenger 22 News and Updates screen Not Responding error 39 NoteTab 163 73

-OOffice 365 settings 121 Office Outlook 22 Office Outlook & Microsoft Exchange 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

-QQualcomm Eudora 22

-RRe-activation password 17 Read archived mail 29 Recipient 140 Refund Policy 142 Rich content 140 Rich text 140
Copyright 2005-2013 Fookes Holding Ltd

Index

170

ROOT folder

22

-SSave TNEF as Winmail.dat Attachments - Advanced Options 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

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

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

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

-VView archived mail 29 Virtual PC 5 Virus warning 6 Voluntary Product Accessibility Template VPAT 52 52

171

Aid4Mail 3 Help

-WWhich version do I need? Wildcard tokens 56 Windows Live Mail 22 Windows Mail 22 Windows Service 87 Wine 5 Words List File 112 Writing Aid4Mail Scripts 11

73

-XX.400 addressing format - FAQ 44

-YYahoo! Mail 22 Yahoo! Mail settings 121

-ZZIP Archives - FAQ Zoho Mail settings 49 121

Copyright 2005-2013 Fookes Holding Ltd

You might also like