Migrator for Notes to Exchange 4.16.1 - Program Parameters Reference Guide

Parameters for the Self-Service Desktop Migrator (SSDM)

[ArchiveData] section

Determines whether the program will migrate calendar data among the archives. For example:

... tells the program to not migrate archive calendar data. By default (MigrateCalData=1), the program will migrate archive calendar data.

Determines whether the SSDM should attempt to migrate the encrypted portions of encrypted messages in the source user archives. This feature can also be applied to encrypted messages in the source server, by this same parameter name in the [ServerData] section of notesdtapp.ini. The feature is also available for the Data Migration Wizard (same parameters in the same sections, but in Migrator for Notes to Exchange's Global Defaults and Task Parameters), but in the wizard the default is 0.

The SSDM can migrate the encrypted portion of an encrypted message if it has the access credentials of the user who is authorized to decrypt the encrypted portion. This is the typical case in most organizations who use the SSDM, where individual users run the SSDM under their own login credentials, to migrate their own data. But in the rare case where the access credentials for a user's encrypted data are different from the credentials of the user running the program, this parameter lets you control how the SSDM should handle encrypted data. If the program attempts to migrate an encrypted message but lacks the necessary credentials, it can migrate the unencrypted portions, skip the encrypted portions, and insert text notices to explain that the encrypted portions could not be migrated. On the other hand:

… tells the SSDM to not even attempt migrating the encrypted portions, but to just migrate the unencrypted portions and insert the notice text. If MigrateEncryptedMessages=1, the program will attempt to migrate the encrypted portions, and will succeed or fail depending on whether the account running the SSDM has the necessary credentials. If it fails, the SSDM will migrate the message, skip the unencrypted portion and insert the notice—the same outcome as for MigrateEncryptedMessages=0.

A related Migrator for Notes to Exchange parameter lets you tell the SSDM to skip an entire message (both encrypted and unencrypted portions) if the program is already configured to skip the encrypted portion (only) by MigrateEncryptedMessages=0. See SkipEntireEncryptedMessage in this same [ArchiveData] section for more information.

This value corresponds to a GUI element in the SSDM: the Migrate archive check box of the Specify Data for Migration screen. The SSDM writes this value to notesdtapp.ini from the user's GUI entry; Quest recommends you do not manually enter or change this value except at the direction of Quest Support.

Determines whether the program will migrate task data among the archives. For example: MigrateTaskData=0 tells the program to not migrate archived tasks. By default (MigrateTaskData=1), the program will migrate archived tasks.

... tells the program to not migrate the trash folder if the Specify Data for Migration screen does not appear, or sets the associated check box in that screen to be unmarked by default. The default setting (MigrateTrashFolder=1) tells the program to migrate the trash folder if the screen does not appear, or sets the associated check box to be marked by default. The most common use of this parameter is to provide the necessary entry value when the program is configured to hide the Specify Data screen. Chapter 4 of the Migrator for Notes to Exchange Scenarios Guide explains how this parameter relates to others used to customize the SSDM.

Determines whether and how the SSDM will migrate archive items that occur within Notes views. For example: MigrateViews=1 tells the SSDM to migrate items only from the first view in which they are found. Valid parameter values are:

Note that the SSDM will initialize this parameter to 1 if it is omitted from notesdtapp.ini, even though technically the program default is 1. You must explicitly include the parameter in notesdtapp.ini if you want the SSDM to run with MigrateViews=0 or MigrateViews=2.

Determines whether the SSDM, when migrating archives to a different target folder, will add a keyword to the archive message that identifies the message’s original folder name. For example, a different target folder would include subfolders under a pseudo root (with [ArchiveData] UsePseudoRoot=1) as compared to the primary Outlook mailbox (the main root).

... tells the program not to add the keyword in the format of "Folder: ArchiveTitle\\OriginalFolderName" to the archive message when migrating it to a different target folder. By default (1), the program adds the keyword to the migrated archive message.

Determines whether the SSDM will skip entire encrypted messages (skip both encrypted and unencrypted portions) in the source user archives if the SSDM is already configured to skip the encrypted portions by MigrateEncryptedMessages=0 (also in this [ArchiveData] section).

… tells the program to skip any encrypted messages in their entirety if MigrateEncryptedMessages=0. This SkipEntireEncryptedMessage parameter is irrelevant and ignored if MigrateEncryptedMessages=1.

For more information about how encrypted messages are migrated, and how this SkipEntireEncryptedMessage parameter helps control how the SSDM processes encrypted messages, see the parameter notes for the MigrateEncryptedMessages parameter earlier in this [ArchiveData] section.

[Categories] section

These [Categories] parameters are all auto-set parameters (see GUI-set and other “auto-set” parameters) that define the Outlook categories that correspond to various English equivalents. The Setup program automatically sets these parameters to their English defaults. If a default is not correct for your locale, be sure to change it before you run the SSDM.

See the explanatory note at the beginning of this [Categories] section. The English equivalent (default) for this parameter is: C=Clients

See the explanatory note at the beginning of this [Categories] section. The English equivalent (default) for this parameter is: H=Holiday

See the explanatory note at the beginning of this [Categories] section. The English equivalent (default) for this parameter is: P=Projects

See the explanatory note at the beginning of this [Categories] section. The English equivalent (default) for this parameter is: PC=Phone Calls

See the explanatory note at the beginning of this [Categories] section. The English equivalent (default) for this parameter is: T=Travel

See the explanatory note at the beginning of this [Categories] section. The English equivalent (default) for this parameter is: V=Vacation

[ErrorsToIgnore] section

Each Error<#> parameter identifies a single particular runtime error that the program should ignore when documenting its activities and outcomes in its log file. Each parameter value:

For example:

The digit(s) appended to an Error<#> key name arbitrarily differentiate one parameter from another. Multiple Error<#> parameters need not appear in numerical order, need not form an uninterrupted numeric sequence, and need not begin at 0. But the SSDM will read only Error<#> parameters whose differentiating digits are within the range 0-99 inclusive.