Migrating to Exchange

Control File Parameters

The following parameters are used to set values in the control file.

Parameter Use Description
Mode  No default Required when using the control file. Valid settings
FILE, MSMAILPC, CCMAIL, EXCHANGE, NOTES, COLLABRA, GRPWISE, GRPWISE5, ADSI, and IMAP.
The mode for this migration. It must be the first line in the control file.

Note   Set Mode to FILE when importing migration files.

Exch55  Default: TRUE Required when Mode is set to EXCHANGE. Valid settings
TRUE means the migration is from an Exchange 5.5 server. FALSE means the migration is from an Exchange 2000 server.
Whether the source server is running Exchange 5.5 or Exchange 2000.
RestrictSearchtoSid  Default: FALSE Optional when Mode is set to EXCHANGE or IMPORT ONLY FROM PST. Valid settings
TRUE means to look for matching user objects based only on the object SID during the import phase of migration. FALSE means to accept all matches.
Whether to match user objects based only on the object SID.
SubjectFile  No default Optional when Mode is set to EXCHANGE. Valid setting is the path and filename of a file that consists of lists of subjects (in Unicode format). Normalized subject text is checked for a prefix match against any of the input subjects. If a match is found, the message is not copied to the destination. The file must end with a carriage return character and a line feed character.
ForcePwdChange  Default: FALSE Optional Valid settings
TRUE means that users must change their passwords. FALSE means that users do not have to change their passwords.
Whether to force users whose accounts were migrated to change their passwords.
Function  Default: FULL Optional
Used when Mode is set to MSMAILPC, CCMAIL, NOTES, COLLABRA, GRPWISE, GRPWISE5, ADSI, or IMAP.
Valid settings
FULL to perform a full migration (extract and import). EXTRACT to extract a user list file (Microsoft Mail for PC Networks) or to extract migration files (Lotus cc:Mail, Lotus Notes, Novell GroupWise 4.x, Novell GroupWise 5.x, Collabra Share, LDAP, and IMAP). IMPORT to perform an Microsoft Mail for PC Networks import from a user list file.
The migration function to perform.
File  No default Required when...
Mode is set to FILE, CCMAIL, NOTES, COLLABRA, GRPWISE, GRPWISE5, ADSI, or IMAP. Function is set to EXTRACT, IMPORT, or FULL.
Valid settings
For IMPORT, specify the path and file name of the packing list or user list file. For EXTRACT or FULL, specify the path to the temporary directory to which migration files should be written (for CCMAIL, NOTES, COLLABRA, GRPWISE, GRPWISE5, ADSI, or IMAP). For MSMAILPC EXTRACT, specify the path and filename of the new user list file to be created.
The path and file name of the packing list or user list file, or the path to the temporary directory to which migration files should be written.
Accounts  No default Required when Mode is set to IMAP. Required when Mode is set to EXCHANGE, CCMAIL, NOTES, ADSI, or MSMAILPC (when a user list file is not specified by File). Valid setting is a user list file. A user list file with a listing of accounts to be migrated. Users may be listed by alias, X.500 address, or SMTP address. For an alias list, the format of each entry must match the name format as it appears in the Full Name column of the Migration Wizard Account Migration screen. Each name is on one line and is followed by a carriage return and line feed. For X.500 or SMTP address lists, each entry should start with X500: or SMTP:, then the address, followed by a carriage return and line feed.
Mailbox  Default: TRUE Optional Valid settings
TRUE means mailboxes are created and messages are imported. FALSE means messages are imported to existing mailboxes but new mailboxes are not created.
Whether to extract mailbox creation information and create the mailbox on Exchange.
Email  Default: TRUE Optional
Ignored unless Mode is set to MSMAILPC, CCMAIL, NOTES, GRPWISE, GRPWISE5, COLLABRA, or IMAP.
TRUE | FALSE
Whether to extract personal e-mail messages.
Public  Default: TRUE Required when Mode is set to FILE, MSMAILPC, CCMAIL, or COLLABRA. TRUE | FALSE Whether to extract shared folders, bulletin board, or forum information.

Note   When you import from a file, if you are not migrating public folders, you must set this attribute to FALSE or an error will result.

PAB  Default: TRUE Optional
Ignored unless Mailbox is set to MSMAILPC or CCMAIL.
TRUE | FALSE
Whether to extract personal address book (PAB) entries and PAB distribution lists.
Schedule  Default: TRUE Optional
Ignored unless Mode is set to MSMAILPC, NOTES, GRPWISE, or GRPWISE5.
TRUE | FALSE
Whether to extract schedule (calendar) information.
EmailStart  Default:
 Jan 01, 1601
Optional
Ignored unless Mode is set to MSMAILPC, CCMAIL, NOTES, IMAP, GRPWISE, GRPWISE5, or EXCHANGE.
Valid setting
Must be in the date and time format (YYYYMMDDHHMMSS).
The earliest (start) date for filtering which e-mail messages are moved. Messages without dates are always migrated.
EmailEnd  No default Optional
Ignored unless Mode is set to MSMAILPC, CCMAIL, NOTES, IMAP, GRPWISE, GRPWISE5, or EXCHANGE.
Valid setting
Must be in the date and time format (YYYYMMDDHHMMSS).
The end date for filtering which e-mail messages are moved. Messages without dates are always migrated.
ExchStoreDN  No default Required when Function is not set to EXTRACT. Valid setting is a distinguished name. The distinguished name of the Exchange mailbox store in which user mailbox stores are to be created. Example
CN=New Mailbox Store,CN=My Storage Group,CN=InformationStore,CN=MYSERVER,CN=Servers,CN=First Administrative Group,CN=Administrative Groups,CN=FirstAdminGroup,CN=Microsoft Exchange,CN=Services,CN=Configuration,DC=MyDomain,DC=microsoft,DC=com
Container  No default Required when Function is not set to EXTRACT. Valid setting
Must be formatted as follows:
OU=New Users,DC=MyDomain, DC=microsoft,DC=com New Users is a subcontainer of MyDomain.
The distinguished name of the organizational unit (container) in which new Windows accounts are to be created. You can get the full distinguished name from a Lightweight Directory Access Protocol (LDAP) viewer such as Ldp.exe or Adsivw.exe.
NTAccounts  Default: RANDOM Optional; ignored unless Mailbox is set to TRUE. Valid settings
RANDOM creates Windows accounts and generate random passwords. ALIAS creates Windows accounts and uses the Exchange e-mail alias as the initial password.
Whether to create Microsoft Windows NT accounts for new users and which value to use as the Windows NT account password.
Postoffice  No default Required if Mode is set to MSMAILPC, EXCHANGE, CCMAIL, GRPWISE, ADSI, or IMAP. Valid setting is a universal naming convention (UNC) path or a mapped drive location. However, if you are migrating Exchange mailboxes, the valid setting is the name of the Exchange server. The full path to the post office.
GWDomain  No default Required if Mode is set to GRPWISE5. Valid setting is either a UNC path or a mapped drive location. The path to the GroupWise 5.x domain.
POName  No default Required if Mode is set to CCMAIL, NOTES, or GRPWISE5. The full name of a cc:Mail, Notes, or a GroupWise 5.x post office. The Notes post office should be in the form Notes Server/Domain. The GroupWise post office is in the domain stated in the GWDomain value.
DefFldPerms  Default: None Optional if Public is set to TRUE. Valid options are None, Author, and PubEditor. Used to assign default access permissions to all users for migrated shared information.
FldOwner  No default Required if Public is set to TRUE. Distinguished name of the account that will own the public folder. You should use the Exchange 5.5 version distinguished name rather than the Active Directory distinguished name. Example
/o=Microsoft/ou=London/cn=Recipients/cn=TheOwner
ImportDestination  Default: SERVER Optional
Ignored unless Mode is set to FILE, MSMAILPC, EXCHANGE, CCMAIL, NOTES, GRPWISE, GRPWISE5, OR IMAP.
Valid settings
SERVER migrates information to the Exchange information store.PST migrates information to personal folder (.pst) files and personal address book (.pab) files.
Specifies the destination store for migrated data.

Note   Public folder data does not migrate to .pst files.

PSTPath

Note   If you use the keyword ImportDestination, you can select the location where the PST file will be placed. If you don't specify the location, the PST file will be placed in the root directory of the drive where Exchange is installed.

Required if ImportDestination is set to PST. Valid setting is path name. The fully qualified path to the directory where personal folder (.pst) files are created.
GWUserGRPName  No default Required if Mode is set to GRPWISE. The name of the Novell GroupWise group whose members are to be migrated.
SchdStart  Default:
 Jan 01, 1601
Optional; ignored unless Mode is set to NOTES, GRPWISE, or GRPWISE5. Valid settings are in the date and time format (YYYYMMDDHHMMSS). The earliest (start) date for filtering which calendar data is moved. Information without dates is always migrated.
SchdEnd  Default:
 Current date
Optional; ignored unless Mode is set to NOTES, GRPWISE, or GRPWISE5. Valid settings are in the date and time format (YYYYMMDDHHMMSS). The end date for filtering which calendar data is moved. Messages without dates are always migrated.
Phone  Default: TRUE Optional; ignored unless Mode is set to GRPWISE or GRPWISE5. TRUE | FALSE Whether to migrate phone messages.
Appointments  Default: TRUE Optional; ignored unless Mode is set to NOTES, GRPWISE, or GRPWISE5. TRUE | FALSE Whether to migrate appointments.
Notes  Default: TRUE Optional; ignored unless Mode is set to GRPWISE or GRPWISE5. TRUE | FALSE Whether to migrate notes.
Tasks  Default: TRUE Optional; ignored unless Mode is set to GRPWISE or GRPWISE5. TRUE | FALSE Whether to migrate tasks.
GWRTF  Default: TRUE Optional; ignored unless Mode is set to GRPWISE. Valid settings
TRUE means messages are migrated in Rich Text Format (RTF). FALSE means messages are migrated in ANSI format.
Indicates whether messages are migrated in RTF.
IniFile   Default:
 Depends on the version of Lotus Notes installed.
Optional; ignored unless Mode is set to NOTES. The path to the Notes.ini file.
DocLinkConversion   Default: RTF Optional; ignored unless Mode is set to NOTES. Valid settings
URL to convert document links to URL shortcuts within the message. OLE to convert document links to OLE attachments within the message. RTF to convert document links to RTF attachments within the message.
How Notes document links are converted within the messages being migrated.
Secure  Default: FALSE Optional; ignored unless Mode is set to ADSI. Whether to use Secure authentication.
Encryption  Default: FALSE Optional; ignored unless Mode is set to ADSI or IMAP. Whether messages are encrypted. If set to TRUE, Secure Sockets Layer (SSL) is used to migrate the contents of the mailboxes. In this case, make sure you choose the correct value for Port.
Port  Default:
 389 for Mode ADSI
 143 for Mode IMAP
Optional; ignored unless Mode is set to ADSI, IMAP, or EXCHANGE. The port number.
! Optional A comment delimiter. Must be the first value in the line.
Home-Server  No default Required if ExchStoreDN is not specified. Valid setting is a server name. The common name of the Exchange server that will house the new, migrated mailboxes.
ExchStore  No default Required if ExchStoreDN is not specified. Valid setting is a mailbox database name. The common name of the Exchange mailbox database that will house the new, migrated mailboxes.

Related Topics

Sample Control Files