Appendix C
Command-Line Options for the Migration Wizard
You can work with the Migration Wizard by using the Administrator program or a combination of command-line options and a control file. The command-line options are as follows.
Option	Description	
		
/C:<control file>	Specifies the control file.	
/A:<account name>	The administrator account name for Microsoft Mail (PC) postoffice. Not needed for migration file import or Lotus cc:Mail migration.	
/P:<password>	The password for the administrator account or the Lotus cc:Mail postoffice. Not needed for migration file import.	
/S	Silent mode. No error dialogs are displayed. All errors are written to the Event Log.	
/?	Displays Help text.	

Example
mailmig /C:d:\migrate\po72195.txt 
mailmig /C:salespo.txt /A:admin /P:katmandu

When run in a batch mode, mailmig returns result codes depending on the success of the processing:
	0=success: no errors or warnings
	1=warnings, no errors
	2=errors, possible warnings

The control file is a text file that has the following options:
Option	Description	
		
Mode	The mode for this migration. Valid options are FILE, MSMAILPC, and CCMAIL. If included, it must be the first line in the control file.	
Function	(Optional, ignored unless Mode option is set to MSMAILPC or CCMAIL) The migration function to perform. Valid options are FULL, EXTRACT, and IMPORT. FULL means to do a full migration (extract and import). EXTRACT means to extract a userlist file (MS Mail PC) or to extract migration files (cc:Mail). IMPORT means to do an MS Mail (PC) import from a userlist file. Defaults to FULL.	
File	(Required when Mode option is set to FILE, or Function option is set to EXTRACT or IMPORT, or the Mode option is set to CCMAIL) Specify the path and file name of the packing list or userlist file, or for CCMAIL, specify the path to the temporary directory for migration files.	
Accounts	(Required and only used when Mode is set to CCMAIL or MSMAILPC when a userlist file is not specified by the File option) A userlist file with a listing of accounts to be migrated. Defaults to all accounts in the postoffice. The format of the names in the accounts file must match how the names are displayed in the Migration Wizard account selection dialog box. Each name is on a line by itself, followed by a carriage return and line feed.	
Mailbox	(Optional) Whether to extract mailbox creation information and whether to create the mailbox on Microsoft Exchange Server if it doesn’t exist. If this is set to FALSE, mail messages won’t create a mailbox if one does not exist. Valid options are TRUE and FALSE. Defaults to TRUE.	
Email	(Optional, ignored unless Mode option is set to MSMAILPC or CCMAIL) Whether to extract personal e-mail messages. Valid options are TRUE and FALSE. Defaults to TRUE.	
Public	(Optional, ignored unless Mode option is set to MSMAILPC or CCMAIL) Whether to extract shared folders or bulletin board information. Valid options are TRUE and FALSE. Defaults to TRUE.	
PAB	(Optional, ignored unless Mode option is set to MSMAILPC or CCMAIL) Whether to extract personal address book (PAB) entries and PAB distribution lists. Valid options are TRUE and FALSE. Defaults to TRUE.	
Schedule	(Optional)  Whether to extract schedule information. Valid options are TRUE and FALSE. Defaults to TRUE.	
EmailStart	(Optional, ignored unless Mode option is set to MSMAILPC or CCMAIL) The earliest (start) date for filtering which e-mail messages are moved. It is in the date/time format (YYYYMMDDHHMMSS). Defaults to none. Messages without dates are always migrated.	
EmailEnd	(Optional, ignored unless Mode option is set to MSMAILPC or CCMAIL) The end date for filtering which e-mail messages get moved. It is in the date/time format (YYYYMMDDHHMMSS). Defaults to none.	
Home-Server	(Required when Mailbox option is set to TRUE or mailboxes will be created) The Microsoft Exchange Server to be used. Defaults to the server that was used last if it exists.	
Container	(Optional, ignored unless Mailbox option is set to TRUE, mailbox data will be imported, or mailboxes will be created) The container and path on the specified home server where new mailboxes are to be put. The path is formatted:
Recipients/cn=users/cn=accnting
where users is a subcontainer of Recipients and accnting is a subcontainer of users. Defaults to the Recipients container. The directory name is visible on the property page of the Recipients container and can be different from the display name. For example, the display name of the default Recipients container on a French Microsoft Exchange Server is “Destinataires” but the directory name is “Recipients.”	
Template	(Optional, ignored unless Mailbox option is set to TRUE or mailboxes are created) The Microsoft Exchange Server alias for the template mailbox to be used in creating new mailboxes. If the mailbox is in a different Recipients container from the new mailbox, the template must be specified with the full distinguished name. Defaults to null. To find the distinguished name of a mailbox, you can use Directory Export and set the header line of the export file to: obj-class,common-name,obj-dist-name.	
NTAccounts	(Optional, ignored unless Mailbox option is set to TRUE or mailboxes will be created)  Whether to create Windows NT accounts for new users that don’t already have them and how. Valid options are RANDOM, ALIAS, and NO. RANDOM means to create Windows NT accounts and generate random passwords. ALIAS means to create Windows NT accounts and use the user’s Microsoft Exchange Server e-mail alias as the initial password. NO means to not create Windows NT accounts. Defaults to NO.	
NTDomain	(Optional, ignored unless Mailbox option is set to TRUE or mailboxes will be created) The Windows NT security domain to be used in creating new Windows NT accounts. Defaults to the domain you are logged on to.	
Postoffice	(Required if Mode option is set to MSMAILPC or CCMAIL) The full path to the postoffice.	
POName	(Required if Mode option is set to CCMAIL) The full name of a cc:Mail postoffice.	
DefFldPerms	(Optional) Used to assign default access permissions to all users for migrated public folders. Valid options are None, Author, and PubEditor. Defaults to none.	

Examples
Importing migration files created by a source extractor:
Mode,FILE
File,C:\MIGRATE\CCPO1225.PKL
Home-Server,HONGKONG01
Template,/o=FAB/ou=AP/cn=Recipients/cn=TemplateMailbox
NTAccounts,RANDOM
NTDomain,FAB-MAIN

Microsoft Mail (PC) Extracting a user list:
Mode,MSMAILPC
File,C:\MIGRATE\USERLIST.CSV
Function,Extract
Email,FALSE
PUBLIC,FALSE
PAB,FALSE
Schedule,FALSE
Postoffice,M:\

Microsoft Mail (PC) Importing with a userlist, the template mailbox is in a different recipient container:
Mode,MSMAILPC
File,C:\MIGRATE\USERLIST.CSV
Function,IMPORT
PUBLIC,FALSE
Postoffice,M:\
EmailStart,19950101000000
Home-Server,HONGKONG01
Template,/o=FAB/ou=AP/cn=Recipients /cn=Template/cn=zTemplateMailbox
NTAccounts,RANDOM
NTDomain,FAB-MAIN

Microsoft Mail (PC) one step migration:
Mode,MSMAILPC
Postoffice,\\HONGKONGPO\MAILDATA\
EmailStart,19950101000000
Home-Server,HONGKONG01
Template,/o=FAB/ou=AP/cn=Recipients/cn=TemplateMailbox
NTAccounts,RANDOM
NTDomain,FAB-MAIN

Lotus cc:Mail Extracting to migration files:
Mode,CCMAIL
File,C:\MIGRATE\
Function,EXTRACT	
Public,FALSE
Postoffice,M:\
POName,Region1PO

Lotus:cc:Mail Importing migration files
Mode,FILE
File,C:\MIGRATE\CCPO1225.PKL
Home-Server,HONGKONG01
Template,/o=FAB/ou=AP/cn=Recipients/cn=TemplateMailbox
NTAccounts,RANDOM
NTDomain,FAB-MAIN

Lotus cc:Mail One step migration
Mode,CCMAIL
File,C:\MIGRATE\
Function,FULL
Public,FALSE
Postoffice,M:\
POName,Region1PO
Home-Server,HONGKONG01
Template,/o=FAB/ou=AP/cn=Recipients/cn=TemplateMailbox
NTAccounts,RANDOM
NTDomain,FAB-MAIN

BLANK PAGE
IMPORTANT: This text will appear on screen, but will not print on a PostScript printer.
This page should be the last one in this file; it was inserted by running the InsertBlankPage macro.
Do not type any additional text on this page!