Contents
Mailbox Converter Contents

This help file contains a list of all Help topics available for the Mailbox Converter.  You can use the scroll bar to see the entries that are not currently visible in the Help window.  For information on how to use Help, press F1 or choose How to Use Help from the Help menu.

Overview	How to Use	Troubleshooting
Buttons

Control Menu


Buttons

The following buttons are available in the main Mailbox Converter dialog:

•	Convert: Converts the mail in the selected source folders into Z-Mail Pro, and places them into the selected destination folder.

•	Converts All: Converts all the mail in the selected folders into Z-Mail Pro folders with the same name. If  a Z-Mail Pro folder exists with the same name, the Folder already exists dialog appears.

•	Update Folders: Update Folders initiates the Mail Administration tool and the users Mailbox is regenerated to include the converted files.  Use Update Folders after all folders you require have been converted.

•	Help: Brings up the help files for this dialog.

•	Close: Exits the Mailbox Converter application.

•	Select All: Selects all the folders in the Source list.

•	Create: Creates a new folder in the destination mailbox.


Control Menu

Additional functions are available through the Control Menu.  To access the Control menu, click on the small box in the upper left corner of the window ( the Windows Control Menu icon), or in Windows95 click with the right mouse button over the top of the window. Using the keyboard press ALT + SPACEBAR.

Restore

Move

Size

Minimize

Maximize

Go IntraNet

Close

About Mailbox Converter...


Overview

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.


Converting Mail
How to Use Mailbox Converter

To use the Mailbox Converter, close any messaging applications (including 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:

•	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.

•	PROFS/OV: Not necessary to enter any details.  The necessary information is retrieved from Mail’s settings.

•	UNIX: Enter the directory where the UNIX Mailboxes (files) are located or the Mailbox name.

•	Z-Mail (4.0): Select the Z-Mail username for the mailbox you want to convert.  Select the Convert Aliases checkbox to have all your aliases converted into a Z-Mail Pro (ChameleonNFS-X) address book.

•	MCI MailRoom: Enter the directory where MCI MailRoom Mailboxes (files) are located or the Mailbox name. All non-internet addresses (for example CompuServe) are not converted, and are displayed in quote marks. Select the Convert Aliases checkbox to have all your aliases converted into a Z-Mail Pro address book.

4.	The Mailbox Converter dialog appears.  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 checkbox for all Mail to be displayed as read.  If the checkbox is not selected, all Mail will be displayed as unread.

When converting cc:Mail, the source folders list contains only the Inbox folder.

5.	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.

6.	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.

Note:  	Hierarchical folders from Z-Mail (4.0) and MCI MailRoom are converted into folders with a backslash in the folder name separating the original parent folder name from the subfolder name.

In case of a duplicate name (same name for source and destination folder) the Folder already exists dialog appears.

7.	Repeat this procedure, as necessary, for converting other folders.

8.	Choose the Update Folders button.  Your Mailbox is regenerated to include the converted files.

9.	Choose the close button.  If you did not chose to update folders earlier, you will be prompted to do so now.

You may also run the Mailbox Converter from a command line.


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.

•	Ensure a PROFS/OV transport has been defined in Z-Mail Pro before converting Mainframe folders

•	Before running Mailbox Converter, close all messaging applications ( Z-Mail Pro, Phone Tag, Tagit, NEWTCal and Forum), otherwise the "Mail is already running" dialog appears.

•	If the first dialog displays garbage entries, check that mailcvt.cfg exists in your netmanage 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  “File”" error message appears after selecting cc:Mail, you must install cc:Mail and Lotus VIM (Vendor Independent Messaging) on your machine.  Both directories should be in your path. Furthermore, if running on Win NT or Win 95, the 32 bit version of cc:Mail and Lotus VIM should be installed.


Folder already exists!

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.

•	Create a new Z-Mail Pro folder

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.

•	Select another existing folder

Select which folder you want the Mail from the selected source folder to be placed in after conversion.


Running Converter from a Command line
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\converter.exe

3.	Add the appropriate source system parameter:

-s	source system, such as PROFS, ccmail, Eudora, Unix

Note:  	this parameter must be entered

1.	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 or Z-Mail (4.0) system

-u	username in cc:Mail Z-Mail (4.0) system

Note:  	-d and -f parameters can not be used together.

An example of a command line is:

C:\NETMANAG.32\CONVERT.EXE -Scc:Mail -U<USERNAME> -P<PASSWPRD>


About Mailbox Converter

Choose the About Mailbox Converter command from the Help menu for information about this program.

Choose the Copy button to copy the application version information into the Windows Clipboard.  You can then paste this information into any application.

Choose the OK button to continue.


Restore

Returns the active window to its original size and position. Once you restore a window to its original size, you can fill the entire screen with a window or reduce the window to an icon. See Minimize command.

You can also return the active window to its original size and position by clicking the Restore button in the upper-right corner of the application window or the document window when the window is maximized.


Move

Moves the active window or dialog box. When you choose Move, the insertion point becomes a four-headed arrow. You can then use the arrow keys to move the window. When the window is in the location you want, press ENTER.

This command is unavailable if you maximize the window.


Size

Changes the size of the active window.  Select the size command, and use the arrow keys to select the border and change to the required size, when the border is in the right position press the enter button.


Minimize

Reduces the Word window or a document to an icon.

You can also reduce the Word window or a document to an icon by clicking the Minimize button in the upper-right corner of the application window or the document window.


Maximize;Control menu
Maximize

Enlarges the Active window to fill the screen.  You can also maximize a screen by clicking the upward arrow in the top right corner of the screen.


Close

Closes the active window or dialog box.


Active window

The window in which you are working.  The active window contains the insertion point or a selection of text or graphics.  The title bar in the active window is highlighted.


add an example of command line

C:\NETMANAG.32\CONVERT.EXE -Scc:Mail -U<USERNAME> -P<PASSWPRD>

check with Daphne - as earlier this was a bug