Lotus cc:Mail
800 El Camino Real West
Mountain View, CA 94040
415-961-8800 voice
415-961-8400 fax
Post Office Name: ccMail
Post Office Phone:  415-961-8884
BBS: 415-961-0401, 8-N-1



         Converting a DOS Remote Mailbox to Mobile for Windows

                      Support Services Technote


Purpose

The purpose of this technote is to provide you with the necessary steps to 
convert an existing cc:Mail Remote for DOS mailbox for use with cc:Mail 
Mobile for Windows.  To run this conversion procedure, you must have 
cc:Mail Mobile for Windows and be ready to install it on your PC.  This 
technote provides important information regarding the conversion of your 
DOS Remote mailbox that is not listed in the documentation.


Version

This technote describes DBXLATE, Version 1.10, which is a revised version 
as of March 1, 1994.  You can download this version from the cc:Mail BBS 
(file DBXLATE.EXE).  This version fixes the following problems:

*	DBXLATE converts messages that have no text item or file item 
	(previously resulted in a Message Cannot Be Read error message).
*	DBXLATE correctly handles addresses containing FAN (foreign alias name) 
	field information and certain types of aliases.  DBXLATE, Version 1.0, 
	created extra USR files, and entries with FAN field information were 
	incorrectly addressed.

 
Summary

Because cc:Mail Remote for DOS uses a different database format, you must 
convert a Remote mailbox for use in cc:Mail Mobile for Windows.  A 
database translation utility called DBXLATE is included with cc:Mail 
Mobile.  DBXLATE creates a Mobile mailbox and transfers your DOS Remote 
directory information, Home PO (post office) setup, Inbox, and folder 
messages to the new Mobile database structure.

(Note:	You have already created a Mobile mailbox if you ran cc:Mail 
Mobile in mobile mode.  In this case, DBXLATE cannot transfer information 
from your DOS Remote mailbox into the existing Mobile mailbox.  You must 
replace the existing Mobile mailbox with a new one created by DBXLATE.  
Alternatively, you can use the method outlined in the Conversion With 
Manual Procedure section of this technote to move your messages and 
directory from Remote to a preexisting Mobile mailbox.)


Time Required For Conversion

If your existing Remote directory is very large (for example, over 1,000 
entries), cc:Mail recommends that you use a RAM drive to convert the 
mailbox to Mobile, then copy the converted files to a local drive.  This 
process reduces the time of the conversion.  For example, in one test 
conducted in the Support Services lab on a 386 PC, we converted a mailbox 
with 10,500 directory entries and no messages from cc:Mail Remote to 
Mobile.  DBXLATE took over 12 hours to complete when running on disk and 7 
hours to perform the conversion in a RAM drive.  (For more information on 
this process, please refer to your MS-DOS manual on setting up 
RAMDRIVE.SYS.)  If you use a RAM drive, copy the files to a subdirectory 
on your hard drive between steps 5 and 6 of the Conversion With DBXLATE 
procedure.

In cases with large directories, you might prefer to use the Conversion 
With Manual Procedure because of the speed of Import over DBXLATE.  When 
run on the hard drive during a lab test, Import converted a directory of 
10,500 names twice as fast as DBXLATE and several times faster than RAM.  
However, that procedure requires you to manually move messages from Remote 
to Mobile, using the archive feature, because Import, Version 3.33, cannot 
import messages to the Mobile database.
 

Conversion With DBXLATE 

To convert the DOS Remote mailbox (including Inbox, folders, and 
directory) directly to a new Mobile mailbox, perform the following steps:

1.	Run SETUP.EXE as described in your manual to install cc:Mail 
	Mobile on your local drive.  When you have completed running SETUP.EXE, 
	reboot your PC according to the instructions to allow the new path to take 
	effect.  Do not start cc:Mail Mobile yet.

2.	Run cc:Mail Remote for DOS, and check to see if you have any 
	messages in the Outbox.  If so, send or delete them before converting your 
	mailbox to Mobile.  Also, make sure that you do not have more than 194 
	folders.  If so, you need to delete some before you run DBXLATE.   (You 
	can archive messages in folders before deletion and later retrieve them 
	into Mobile.)

3.	Change to the \CCMOBILE directory and create a subdirectory 
	called CCDATA1 by typing MD CCDATA1.  If a CCDATA1 directory already 
	exists in that location, then you already have an existing cc:Mail Mobile 
	mailbox on your local drive.  To convert the DOS Remote mailbox to Mobile 
	format, you must begin with an empty Mobile data directory.  Either delete 
	the contents of the existing directory, or create a new directory called 
	CCDATAn where n is the next available number.  

4.	To run DBXLATE, enter the following command and fill in the 
	correct information for each variable.

	DBXLATE "[UserName]" [UserPw] [PathToRemData] [PathToMobData]

	"[UserName]"		The name of your Remote mailbox.  For example, 
				if your cc:Mail name is "Smith, Robert", type "Smith, Robert" or "Robert 
				Smith".  Be sure to include the quotes.
	[UserPw]		Your cc:Mail password.
	[PathToRemData]		The full path to the DOS Remote database 
				directory.  For example, C:\REMOTE.
	[PathToMobData]		The full path to the Windows Mobile database 
				directory.  For example, :\CCMOBILE\CCDATA1.

5.	When DBXLATE runs, a report appears as follows: 

	DBXLATE Release 1.0  Copyright (c) 1994, Lotus Development Corp.  All 
	rights reserved.

	Exporting mailbox to file DBXLATE.EXP nn message(s) exported.
	Importing directory.
	Checking directory...  Importing mailbox "[name]" from file DBXLATE.EXP nn 
	message(s) imported.
	0 undelivered message(s) written to file CCMAIL.UND

	Database translation successful.

(Note:	If you see the database translation failed error message, then see 
	the Troubleshooting section of this technote for further information.)

6.	Copy the MOBILE.INI file from the \CCMOBILE directory to the 
	CCDATA1 subdirectory (type COPY C:\CCMOBILE\MOBILE.INI C:\CCMOBILE\CCDATA1).  

(Note:	This step overwrites a copy of this file created by 
	DBXLATE.  The MOBILE.INI file in the \CCMOBILE directory is more complete 
	and gives you access to the default Home, Office, and Hotel Location 
	profiles, as well as the predefined dialing rules.)  

7.	Start Windows and double-click the cc:Mail Mobile icon.  When 
	the Login dialog box appears, fill in your name and password as they 
	appear in DOS Remote.  Select Mobile mode.  Fill in the PO path to the new 
	cc:Mail Mobile database directory (for example, C:\CCMOBILE\CCDATA1), and 
	click OK.  When you are in cc:Mail Mobile, you should be able to see your 
	Inbox messages and folders, as well as your directory information.

8.	To complete your Home PO information in cc:Mail Mobile, click 
	the New Address Book icon or select Window and New Address Book from the 
	menu.  Double-click the directory entry for your Home PO.  Select the 
	country (it defaults to Unknown), and you may need to enter or correct the 
	Area/City code and/or the telephone number.  Select Replace to replace the 
	transferred information with the corrected information.

9.	When you save the changes, you see a message stating that you 
	did not select a corresponding communication method.  To select a method, 
	choose Mobile from the menu bar, select Location Setup, click OK on the 
	warning message, and click More to see the full location information.  For 
	each location beginning with Office, highlight communications and select 
	New.  Type a Method name (for example, Dialup Connection), and select a 
	Method type (for example, Modem).  You might also select a modem type, as 
	well as the COM port and speed, if this is a modem connection.  Click OK 
	when you complete these steps.  Select each location to apply, change, or 
	add additional communication types.  From this point, you can continue to 
	configure your cc:Mail Mobile mailbox according to the manual.  Please 
	contact Lotus cc:Mail Support Services for assistance with any part of 
	this conversion procedure.


Conversion With Manual Procedure

Use this procedure only if you have already created your Mobile mailbox 
using cc:Mail Mobile and do not want to replace it.  If you already ran 
DBXLATE to convert your Remote mailbox to Mobile, then you do not need to 
follow this procedure.


Messages

You can move messages from the Remote mailbox to the Mobile mailbox by 
archiving them in Remote and retrieving them with Mobile as follows:  

1.	Start Remote and select Retrieve Messages.  To archive all 
	messages from the Inbox and folders into one archive file, select Act on 
	Messages and Archive Messages.  When prompted, type an archive filename, 
	use the .CCA extension, and press Enter.  This step archives all messages.

2.	If you prefer to archive the Inbox and folder messages 
	separately, select Retrieve Messages and Retrieve from Inbox/Outbox.  
	Select Act on Messages and Archive Messages, and supply an archive 
	filename ending in .CCA.  After you archive the Inbox messages, return to 
	the main menu and repeat the procedure selecting from the folders. 

(Note:	You may append to an existing archive file by selecting the 
	file when prompted for an archive filename.)

3.	Exit Remote and start Mobile.  To access the archive files, 
	select File and Open.  Select Archive.   Navigate to the location of the 
	archive files and select them.  They are added to the archive list in the 
	container pane of your Mobile mailbox.


Directory

This procedure describes how to import your directory information to 
Mobile from Remote by hand if you choose not to use DBXLATE to convert 
your mailbox.  If you use DBXLATE to convert the mailbox, you do not need 
to follow this procedure.

1.	At a DOS prompt, change to the REMOTE directory.  Type the 
	following command: 

	REXPORT ["UserName"] [UserPw] [PathToRemData] @CCMDIR.EXP DIRECTORY

	["UserName"]	The name of the user associated with the mailbox.
	[UserPw]	The user's password.
	[PathToRemData]	The path to the directory with the REMOTE database 
			files (for example, MBOXDATA, FOLDDATA)

2.	Change to the \CCMOBILE directory and type the following command:

	IMPORT LOCALPO [UserPw] [PathToMobData] DIRECTORY @[PathToExportFile]

	[UserPw]		The user's password.
	[PathToMobData]		The path to the Mobile CCDATAn directory (for example, 
				C:\CCMOBILE\CCDATA1)
	[PathToExportFile]	The path to the location of the CCMDIR.EXP file 
				created in step 1.

(Note:	Because IMPORT does not make any changes to the Local user 
	in the existing Mobile PO, the name is written to an "undeliverable" file 
	if it exists in the export file.  This feature is not an error.)  

3.	Complete steps 8 and 9 of the Conversion With DBXLATE procedure 
	to correct the Home PO information.



Troubleshooting

DBXLATE works correctly under most circumstances.  However, if there are 
preexisting problems in the cc:Mail Remote mailbox, they might prevent 
DBXLATE from successfully completing until they are corrected. 


Problem

DBXLATE is unable to export messages from the Remote mailbox or fails at a 
certain point in the message import.  


Solution

You might have a corruption in the DOS Remote mailbox.  Run Remote and 
look through your Inbox and folders for messages with a Message Cannot Be 
Read error message.  Delete these messages.  If any folder titles, mailing 
list titles, or directory entries look abnormal (for example, they contain 
garbage or incorrect characters), then either delete them or try to 
reenter them correctly.  Exit Remote and type REMOTE RECLAIM at the DOS 
prompt.  Enter your password when prompted.  After the Reclaim has 
finished, try running DBXLATE again.

If you are still unable to run DBXLATE successfully, then transfer 
messages and the directory to the new Mobile mailbox by hand (use the 
Manual Procedure section of this technote).