Z-Mail Pro 6.1 User's Guide

Chapter 7. Mailbox Converter

The Mailbox Converter is used to convert messages stored in various Mail systems into the Z-Mail™ Pro message base. This conversion process needs to be run only once, to convert accumulated messages from a different Mail system into Z-Mail™ Pro. You may also run the Mailbox Converter from a command line.

How to Use the Mailbox Converter

To use the Mailbox Converter, close your messaging applications and Forum, then complete the following steps:

1. Start the Mailbox Converter application.
2. At the prompt, Z-Mail™ Pro Login, enter the username and password as you use when you login to the Z-Mail™ Pro messaging applications.
   
   Note: If any messaging applications or Forum are already running, close them at the prompt.
   
   
3. Select the type of source Mail system you want to convert and enter any specific information that the source Mail system requires:
   
   
   • Z-Mail 4.0 Enter Z-Mail user name. Select whether you would like to convert your aliases.
   • cc:Mail: Enter the VIM Login required when you run cc:Mail.
   • Eudora: Enter the directory where Eudora Mailboxes (files) are located or the Mailbox name.
   • UNIX: Enter the directory where the UNIX Mailboxes (files) are located or the Mailbox name.
   • MCI MailRoom: Enter the directory where the MCI MailRoom Mailboxes (files) are located or the Mailbox name.
     
     
4. The Mailbox Converter dialog appears.
   

   

5. Select one or more source folders or choose the Select All button if all folders are required.
   Source folders are the Mail folders containing the Mail in the original format that you want to convert into Z-Mail™ Pro.
   When converting Eudora Mail, PROFS/OV or UNIX, select Mark messages as Read check box for all Mail to be displayed as read. If the check box is not selected, all Mail will be displayed as unread.
   When converting cc:Mail, the source folders list contains only the Inbox folder.
6. Select the destination folder where you want the selected mail to reside after conversion.
   If you require an additional folder select the Create button and type the folder name in the New Folder dialog.
   Selecting the Convert All button overrides the destination folder selection.
7. Choose the Convert button, to convert the Mail in the Source folders and place into the destination folder.
   Or choose Convert All, to convert all the Source folders into Z-Mail™ Pro folders with the same name as the original source folder.
   In case of a duplicate name (same name for source and destination folder), the Folder already exists dialog appears.
8. Repeat this procedure, as necessary, for converting other folders.
9. Choose the Update Folders button. Your mailbox is regenerated to include the converted files.
10. Choose the close button. If you did not chose to update folders earlier, you will be prompted to do so now.

Folder already exists!

This dialog appears when the folder you are trying to create already exists as a Z-Mail™ Pro folder. Choose one of the following options:

• Append messages to existing folder
  The messages in the selected source folder will be converted and placed into the existing Z-Mail™ Pro folder of the same name.
• Always Append messages to existing folders
  The messages in the selected source folder will be converted and placed into the existing Z-Mail™ Pro folder of the same name. This action will automatically be taken for any future source folders with the same name as destination folders. This message will not appear again.
• Skip this folder
  The selected folder will not be converted.
  Enter the name you require for a new folder. This folder will be created and the Mail for the selected folder converted and placed here.
• Create a new Z-Mail™ Pro folder
• Select another existing folder
  Select which folder you want the Mail from the selected source folder to be placed in after conversion.

Running Mailbox Converter from a Command line

Do the following to run Mailbox Converter from a command line:

1. Select Run... from the File menu in the Program Manager.
2. Enter the application name and path, such as
   

   C:\netmanag\convert.exe

3. Add the appropriate source system parameter:
   
   -s ; source system, such as ccmail, Eudora, UNIX
   
   Note: this parameter must be entered.
4. Add any other required source system parameters:
   
   -d : Eudora mailbox directory
   -f : Eudora or UNIX mailbox file
   -mp: Z-Mail™ Pro password
   -mu : Z-Mail™ Pro user
   -p : password in cc:Mail
   -u : username in cc:Mail system
   
   Note: -d and -f parameters can not be used together.

Additional Online Information

The online help file for Mailbox Converter includes a description of each menu command and a "How to Use" section.

Troubleshooting

If you experience difficulties using the Mailbox Converter, refer to the following items:

• Ensure that you are already defined as a Z-Mail™ Pro user, before running Mailbox Converter.
• Before running Mailbox Converter, close all messaging applications ( Z-Mail™ Pro, Phone Tag, Tag-It!, Forum), otherwise the "Mail is already running" dialog appears.
• If the first dialog displays garbage entries, check that mailcvt.cfg exists in your netmanag directory. Its items should be of the type:
  <source name>=<existing DLL name>.
  If there is a problem, please contact NetManage Tech Support for a valid file.
• If "Missing DLL" error message appears after selecting cc:Mail, you must install cc:Mail on your machine, and its directory should be in your path. Furthermore, if running on Windows NT or Windows 95, the 32 bit version of cc:Mail should be installed.

Table of Contents|Chapter 1|Chapter 2|Chapter 3|Chapter 4|Chapter 5|Chapter 6|Chapter 7
Chapter 8|Chapter 9|Chapter 10|Chapter 11|Chapter 12|Glossary

Top