Contents
Z-Mail™ Pro 6.1 Readme Contents

NetManage Z-Mail™ Pro is the latest product release in the comprehensive Z-Mail messaging family. Z-Mail Pro includes several e-mail related applications, bundled together for your convenience. Z-Mail Pro Client can be used together with NetManage Z-Mail Servers, or any other standards-compliant e-mail server to provide an innovative solution for enterprise-based electronic mail needs.

This Readme help file explains how to install Z-Mail Pro and the online documentation. It also highlights some of the new and enhanced features and performance improvements in this release. This Readme file supplements the online help files and manual provided with the product.

You can use the scroll bar to see the entries that are not currently visible in the Help window.

How to Reach NetManage

Product Highlights

Windows 95 and NT Installation Instructions

Windows 3.1 Installation Instructions

Automatic Setup

Autorun

Online Manual Installation Notes

Open Directory Service (ODS) Sample Unix Scripts

Uninstalling Z-Mail Pro

Known Issues


How to Reach NetManage

NetManage, Inc. is located at 10725 North De Anza Blvd. Cupertino, CA 95014, USA and can be contacted at the following numbers:

	Phone Numbers:	Fax Numbers
USA (sales)	(408) 973-7171	(408)257-6405
USA(tech support)	(408) 973-8181	(408)973-8272
International phone:	+972-4-8550234	+972-4-8550122
France:	+33 1 47 72 08 08	+33 1 42 04 65 99
Germany	+49-(0)816-59470-0	+49-(0)816-59470-047
UK:	+44 (0)1483-881800	+44 (0)1483-881818
Japan:	+ 81-3-3221-8400	+ 81-3-3221-8484
Internet	support@netmanage.com, intl_support@netmanage.com


Product Highlights

Z-Mail Pro version 6.1 contains the following new and enhanced features.

•	A Send To feature has been added to Z-Mail Pro. It lets you send selected files from Windows NT or Windows 95 Explorer to a specified email address without opening Z-Mail or any other program.

•	IMAP has faster dialup, supports more servers and supports alternative folder locations and port numbers.

•	Z-Mail Pro and Forum attachments may be easily zipped or encrypted.

•	In Z-Mail Pro, the Forum Discussion button provides you with the opportunity to view the same article that you received as a mail message in all of the different Forum newsgroups where it is posted, and follow the threads.

•	New Forum Configuration Wizard allows you to quickly configure Forum settings

•	Messages and articles may be edited directly in HTML Mode without launching any other program. This allows you to compose messages and post articles to Forum with inline images, URL links, colors, tables and more. (Windows NT and Windows 95 only.)

•	A Reply to All recipients button has been added to the Toolbar.

•	A Reply/Forward in Original Format (HTML/Text) option helps you remain compatible with the messages and articles you receive. (Windows NT and Windows 95 only.)

•	A Retrieve Message button has been added to the Toolbar.

•	A Single View Window option helps save screen space when viewing Forum articles.

•	A Collapse Header button allows you to collapse the header information of viewed messages/articles for more viewing space.

•	The Address Book has usability enhancements.

•	The right mouse button displays menu commands, and is context sensitive to its location in the Z-Mail Pro window.  You can select file commands with the right mouse button when the pointer is in the message list, folder commands in the folder list, and remote commands when in the remote list.

•	Z-Mail Pro features performance improvements and faster startup.

Note:	PROFS (IBM Host Mail Transport) is not included in Z-Mail Pro 6.1 StandAlone.


Online Manual Installation Notes

The following manuals are available as an online reference, using the Adobe Acrobat Reader, which is bundled with this CD. The files are in portable document file (.PDF) format, which is an electronic version of the printed manual.

•	Z-Mail Pro for All Windows Platforms User's Guide, Version 6.1

•	NetManage Configuration Guide 6.0

The following table identifies the location of each PDF file included on this CD. In this table, drive "D" is assumed to be the CD drive. To open a product's online manual, double-click the appropriate PDF file.

Manual Title	Online Manual File

Z-Mail Pro User's Guide	D:\DOC\USERS\ZMAILPRO.PDF

NetManage Configuration Guide	D:\DOC\NMCONFIG\NMCONF.PDF

The online manual files are organized in book format, including a table of contents and an index, with hypertext links between chapters. The \DOC directory includes the online manual files and the Adobe Acrobat files you need to view and search an online document.

For additional information on the directory structure and the Acrobat Reader choose one of the following:

Adobe Acrobat Files

Online Manual Files for Z-Mail Pro User's Guide

Online Manual Files for NetManage Configuration Guide

Acrobat Reader

Acrobat Reader for Windows NT

Acrobat Search For CD

Instructions for Installing Acrobat Reader and CD Search Plug-in

Adding the Index


Adobe Acrobat Files

The directory structure for the Adobe Acrobat File is:

\DOC

     \ACROLOGO

     \ACROSRCH

\DISK1

README_R.TXT

\DISK2

HELP_R.PDF

\DISK3

\DISK4


Online Manual Files for Z-Mail Pro User's Guide

The directory structure for the Z-Mail Pro User's Guide 6.1 is:

\DOC

\ZMAIL

ZMAILPRO.PDF

INDEX.PDX

\INDEX

\ASSISTS

\MORGUE

\PARTS

\PDD

\STYLE

\TEMP

\TOPICIDX

\TRANS

\WORK


Online Manual Files for NetManage Configuration Guide

The directory structure for the NetManage Configuration Guide is:

\DOC

\NMCONFIG

NMCONF.PDF

INDEX.PDX

\INDEX

\ASSISTS

\MORGUE

\PARTS

\PDD

\STYLE

\TEMP

\TOPICIDX

\TRANS

\WORK


Acrobat Reader

With Acrobat Reader, you can view, navigate, and print on demand any Adobe PDF file on your CD.

Assuming that drive "D" is your CD drive, refer to the Acrobat Reader Readme and Help files at the following locations for additional help:

D:\DOC\ACROSRCH\DISK1\README_R.TXT

D:\DOC\ACROSRCH\DISK2\HELP_R.PDF


Acrobat Reader for Windows NT

The Adobe Acrobat Search plug-in is not supported in Windows NT 3.51. There is a free fix for this available from the Microsoft Web site, www.microsoft.com, called "Microsoft Maintenance Pack #2 for Windows NT."


Acrobat Search For CD

Acrobat Search lets you find information anywhere on the CD. To search, enter a keyword or phrase to conduct a full-text search of all files on your CD that have been indexed. Acrobat Search finds all the matching words on the CD, including text within graphics.


Installing Acrobat Reader and CD Search Plug-in

You must install the Adobe Acrobat Reader and CD Search Plug-in (this is the Search engine) software to add full-index search capabilities within PDF files. You can search for and quickly locate the following:

•	Signal words and terms such as phone numbers, license numbers, and other alphanumeric identifiers

•	Phrases

•	Word variations and character patterns specified with wildcard characters

•	Combinations of words and terms specified with Boolean expressions

•	Thesaurus, which finds words that mean the same thing as the search word

•	Word Stemming, which finds words that share a word stem with the search word (for example: walk, walked, and walking)

•	Sounds Like, which finds terms that begin with the same letter and are phonetically similar to the search term

•	Match Case, which finds terms and phrases that are capitalized as the search term or phrase is

•	Proximity, which changes the way AND searches work (With the Proximity option selected, ANDed terms must be near one another to be found.)

To install the Acrobat Reader and CD Search Plug-in, do the following:

1.	From the CD, open the DISK1 directory, and double-click the setup.exe file.

2.	Follow the on-screen prompts to install the Reader and CD Search Plug-in.


Adding the index

After you have installed the Reader and CD Search plug-in, you must add the index to make it available for searches. To add an index, do the following:

1.	Open the PDF file in which you want to conduct the search.

2.	From the Tools menu, select Search, then Indexes.

3.	The Starting Search Engine message displays and the Index Selection box appears.

4.	Choose the Add button to display the Add Index dialog box. Select the PDX file (index) to be added and choose the OK button The index file is then added to the Available Indexes box. When you are done adding indexes, choose the OK button.

5.	Click the Search icon (binoculars overlaying a document page) to display the Adobe Acrobat Search dialog box. Enter the text for which you want to conduct the search and click Search.

The Search Results dialog box displays, showing the document location of the text found.

6.	Choose View to see the selected instances of text on-screen in the corresponding PDF file.


Windows 95 Installation Instructions
Windows 95 and NT Installation Instructions

These installation instructions describe how to install Z-Mail Pro 6.1 for Windows 95 and NT and how to upgrade from the Z-Mail applications in ChameleonNFS 6.0 and Chameleon HostLink 6.0.

Installing Z-Mail Pro for Windows 95 and NT

Upgrading to Z-Mail Pro 6.1 for Windows 95 and NT

Custom Installation of Z-Mail Pro for Windows 95 and NT


Upgrading to Z-Mail Pro for Windows 95 and NT from ChameleonNFS 6.0 or Chameleon HostLink 6.0

To upgrade to Z-Mail Pro 6.1 for Windows 95 and NT, you must have ChameleonNFS 6.0 or Chameleon HostLink 6.0 running on Windows 95 or Windows NT.

Caution:  	You must upgrade from a version no earlier than 6.0. If you are using an earlier version, you must uninstall the earlier version and then install Z-Mail Pro as a stand-alone.

To upgrade to Z-Mail Pro 6.1 for Windows 95 and NT

1.	Start the Setup program by double-clicking its icon.
The Setup program is located at NM:\clients\win32\zmail\setup.exe

Note:  	If you are installing from CD, Autorun will install the program. Skip to step 2.

2.	In the Setup Option dialog box, select the Complete option to install all Z-Mail Pro applications.

Note:  	You must select Complete to upgrade Z-Mail Pro.

Choose the Next button to continue the installation.

3.	If Setup prompts you for your serial number and key, enter the appropriate information (see your license card for your serial number and key).
Choose the Next button to continue the installation.

4.	In the Select Directory dialog box, specify the directory in which the previous version was installed. During most upgrade installations, you will not be able to change the directory path.

5.	Choose the Next button.
Setup begins copying the Z-Mail Pro for Windows 95 and NT files. After all files have been copied, an instructional message box appears.

6.	Choose the Finish button.

7.	Choose the OK button to restart your computer.

Note:  	The Z-Mail Pro desktop folder includes additional folders that are shortcuts for the applications.


Installing Z-Mail Pro for Windows 95 and NT

To install Z-Mail Pro for Windows 95 and NT you must have Windows 95 or Windows NT installed on your computer.

To install Z-Mail Pro for Windows 95 and NT

1.	Start the Setup program by double-clicking its icon.
The Setup program is located at NM:\clients\win32\zmail\setup.exe

Note:  	If you are installing from CD, Autorun will install the program. Skip to step 2.

2.	In the Setup Option dialog box, select an installation option.

•	Complete installs all Z-Mail Pro applications.

•	Express installs a predefined set of Z-Mail Pro applications.

•	Custom installs only the program groups and applications you specify. See Custom Installation of Z-Mail Pro for Windows 95 and NT .

Choose the Next button to continue the installation.

3.	If Setup prompts you for your serial number and key, enter the appropriate information (see your license card for your serial number and key).
Choose the Next button to continue the installation.

4.	In the Select Directory dialog box, accept the default directory or specify the directory in which you want to install Z-Mail Pro for Windows 95 and NT.

5.	Choose the Next button; Setup begins copying the Z-Mail Pro for Windows 95 and NT files. After all files have been copied, an instructional message box appears.

6.	Choose the Finish button

7.	Choose the OK button to restart your computer.

Note:  	The Z-Mail Pro desktop folder includes additional folders that are shortcuts for the applications.


Custom Installation of Z-Mail Pro for Windows 95 and NT

To perform a custom installation of Z-Mail Pro for Windows 95 and NT you must have Windows 95 or Windows NT installed on your computer.

To perform a custom installation of Z-Mail Pro for Windows 95 and NT

1.	Start the Setup program by double-clicking its icon.
The Setup program is located at NM:\clients\win32\zmail\setup.exe

Note:  	If you are installing from CD, Autorun will install the program. Skip to step 2.

2.	In the Setup Option dialog box, select the Custom button to perform a custom installation.

Choose the Next button to continue the installation.

3.	If Setup prompts you for your serial number and key, enter the appropriate information (see your license card for your serial number and key).
Choose the Next button to continue the installation.

4.	In the Select Directory dialog box, accept the default directory or specify the directory in which you want to install Z-Mail Pro for Windows 95 and NT.
Choose the Next button to continue the installation.

5.	Select the check boxes of the applications that you want to install, and choose the OK button.

Z-Mail Pro	NEWTSound
Z-Mail Pro Administration	NEWTView
MailBox Converter	VBA ScriptEditor
Mail Alias Viewer	VBA Script Player
Outbox	Z-Mail Pro Uninstall
Phone-Tag	Readme
Tag-It!
Note:  	Note that all applications are selected by default. Deselect the applications you do not wish to install.

6.	Choose the Finish button

7.	Choose the OK button to restart your computer.


Windows 3.1 Installation Instructions

These installation instructions describe how to install Z-Mail Pro 6.1 for Windows 3.1. Refer to the topic that most suits your needs. To run Z-Mail Pro 6.1 you must install a TCP/IP network support stack in Windows 3.1 before proceeding with the Z-Mail Pro installation.

Installing the NetManage TCP/IP Stack

Installing Z-Mail Pro for Windows 3.1

Upgrading to Z-Mail Pro 6.1 for Windows 3.1

Custom Installation of Z-Mail Pro 6.1 for Windows 3.1


Installing the NetManage TCP/IP Stack

Note:	If a TCP/IP network stack is already installed on your computer, skip this procedure.

To install the NetManage TCP/IP stack on your computer, Windows 3.1 must be installed.

To install the NetManage TCP/IP stack

1.	Complete the NetManage TCP/IP Preparation Form.

2.	Run the Setup application from NM:\clients\NEWT16\NEWT\setup.exe.

Note:  	Install the NetManage TCP/IP stack in the same directory you will use for Z-Mail Pro 6.1.


Installing Z-Mail Pro for Windows 3.1

To install Z-Mail Pro for Windows 3.1 you must have Windows 3.1 and a TCP/IP network stack running on your computer.

Note:	If you do not already have a TCP/IP stack installed, complete the NetManage TCP/IP Preparation Form before installation.

To install Z-Mail Pro for Windows 3.1

1.	Run the Setup program from Clients\win16\zmail\setup.exe.

2.	In the Setup Option dialog box, select an installation option.

•	Complete installs all Z-Mail Pro applications.

•	Express installs a predefined set of Z-Mail Pro applications.

•	Custom installs only the program groups and applications you specify. See Custom Installation of Z-Mail Pro for Windows 3.1 . Before choosing the Custom install option, be sure to read the following notes on its restrictions.

Note:  	All of NetManages applications depend on the existence of a TCP/IP stack. We recommend that you install the NetManage TCP/IP stack if you are doing a custom installation.
If you are installing Z-Mail Pro for the first time, choose the Complete installation to install the NetManage TCP/IP stack automatically.

Choose the Next button to continue the installation.

3.	If Setup prompts you for your serial number and key, enter the appropriate information (see your license card for your serial number and key).
Choose the Next button to continue the installation.

Note:  	If you intend to use the NetManage TCP/IP stack configured as a BOOTP client and you are sure that the BOOTP server is configured to provide Chameleon serial numbers and keys dynamically, you may simply choose the Next button to continue the installation.

4.	In the Select Directory dialog box, accept the default directory or specify the directory in which you want to install Z-Mail Pro for Windows 3.1.

5.	Choose the Next button; Setup begins copying the Z-Mail Pro for Windows 3.1 files.
After all files have been copied, you will see messages that the following files need to be updated:

AUTOEXEC.BAT (original is backed up as C:\AUTOEXEC.xxx)

WIN.INI (original is backed up as C:\WINDOWS\win.xxx)

SYSTEM.INI (original is backed up as C:\WINDOWS\system.xxx)

In each case, choose the OK button to update the file.

6.	Choose the Finish button.

7.	After the installation is complete, you are prompted to choose the OK button to reboot your computer.
You need to reboot so that all your setup changes take effect.


Upgrading to Z-Mail Pro for Windows 3.1 from ChameleonNFS 6.0 or Chameleon HostLink 6.0
Upgrading to Z-Mail Pro for Windows 3.1 from ChameleonNFS 6.01 or Chameleon HostLink 6.01

To upgrade to Z-Mail Pro 6.1 for Windows 3.1, you must have the ChameleonNFS 6.01 or Chameleon HostLink 6.01 running on Windows 3.1.

Caution:  	You must upgrade from a version no earlier than 6.01. If you are using an earlier version, you must uninstall the earlier version and then install Z-Mail Pro as a stand-alone.

To upgrade to Z-Mail Pro 6.1 for Windows 3.1

1.	Run the Setup program from Clients\win16\zmail\setup.exe.

2.	In the Z-Mail Pro Setup Option dialog box, select the Complete button to install all Z-Mail Pro 6.1 for Windows 3.1 applications.

Note:  	You must select Complete to upgrade Z-Mail Pro.

Choose the Next button to continue the installation.

3.	In the Select Directory dialog box, specify the directory in which the previous version was installed. During most upgrade installations, you will not be able to change the directory path.

4.	Choose the Next button; Setup begins copying the Z-Mail Pro for Windows 3.1 files.
After all files have been copied, you will see messages that the following files need to be updated:

AUTOEXEC.BAT (original is backed up as C:\AUTOEXEC.xxx)

WIN.INI (original is backed up as C:\WINDOWS\win.xxx)

SYSTEM.INI (original is backed up as C:\WINDOWS\system.xxx)

In each case, choose the OK button to update the file.

5.	Choose the Finish button.

6.	After the installation is complete, you are prompted to choose the OK button to reboot your computer.
You need to reboot so that all your setup changes take effect.


Custom Installation of Z-Mail Pro for Windows 3.1

To perform a custom installation of Z-Mail Pro for Windows 3.1 you must have Windows 3.1 and a TCP/IP network stack running on your computer.

•	If you are installing Z-Mail Pro for the first time, choosing the Complete installation installs the NetManage TCP/IP stack automatically. See Installing Z-Mail Pro for Windows 3.1 for instructions on Complete installation.

•	The Custom application does not run with non-NetManage stacks. We recommend that you select the NetManage TCP/IP stack group from the list of available groups.

To perform a Custom installation of Z-Mail Pro

1.	Run the Setup program from Clients\win16\zmail\setup.exe.

2.	In the Z-Mail Pro Setup Option dialog box, select the Custom button to perform a custom installation.

3.	Choose the Next button to continue the installation.

4.	If Setup prompts you for your serial number and key, enter the appropriate information (see your license card for your serial number and key).
Choose the Next button to continue the installation.

Note:  	If you intend to use the NetManage TCP/IP stack configured as a BOOTP client and you are sure that the BOOTP server is configured to provide Chameleon serial numbers and keys dynamically, you may simply choose the Next button to continue the installation.

5.	In the Select Directory dialog box, accept the default directory or specify the directory in which you want to install Z-Mail Pro for Windows 3.1.
Choose the Next button.

6.	Select the check boxes of the applications that you want to install, and choose the OK button.

Z-Mail Pro	NEWTSound
Z-Mail Pro Administration	NEWTView
MailBox Converter	VBA ScriptEditor
Mail Alias Viewer	VBA Script Player
Outbox	WebSpider
Phone-Tag	Z-Mail Pro Uninstall
Tag-It!	Readme
Note:  	Note that all applications are selected by default. Deselect the applications you do not wish to install.

7.	Setup begins copying the Z-Mail Pro for Windows 3.1 files. After all files have been copied, an instructional message box appears. Choose the OK button.

8.	The Custom application is started and it prompts you for system-specific network data, such as your IP address. Refer to the NetManage Configuration Guide for more information about the Custom application. When you are done with the Custom application, choose the Exit option from the File menu, then choose the Yes button to save your changes.

9.	After installation is complete, you are prompted to choose the OK button to reboot your computer.
You need to reboot so that all your setup changes take effect.


Known Issues

NetManage is aware of the following issues that have not been addressed in this release.

•	(Windows 3.1) To empty a remote Trash folder, you must choose the Empty Trash command from the right mouse button shortcut menu.

•	(Windows 95 and NT) Remove PROFS before installing Z-Mail Pro 6.1.
PROFS Transport is not part of Z-Mail Pro 6.1. If PROFS has been previously installed, you will be unable to remove PROFS once Z-Mail Pro 6.1 is installed. An attempt to use PROFS may cause a general protection fault and terminate the application.

•	(Windows 95 and NT) If IMAP4 takes too long to load, Mail may stall when connecting to a University of Washington IMAP4 server. A potential cause is that the default folder location is your remote UNIX home directory. This directory contains non-IMAP4 files.
To avoid this problem, click here.


Installation Related Issues

Windows 3.1 Operating Related Issues

Windows 95 and NT Operating Related Issues


Windows 3.1 Operating Related Issues

•	Mailing a new or modified encryption key while creating a message with an encrypted attachment causes the computer to freeze.

•	The Reply and Forward function in HTML mode does not always operate properly.

•	If you attach files with two extensions (for example: readme.txt.doc), Z-Mail Pro displays a message warning that you cannot save an attachment with two extensions to an unsupported system.

•	Minimized messages may fail to display.

•	Shooting selected text as Mail Text may not put any text in the message window. As an alternative, use the Copy command.

•	Clicking on News Link may not produce any activity.

•	Printing very large messages may cause a general protection fault and terminate the application.

•	Viewing very large messages in HTML mode may produce unusual behavior.

•	If you include a URL with end punctuation (for example, http://www.netmanage.com!) in an e-mail message, choosing the URL in HTML view mode will produce an error.

•	Choosing the OK button in the Network Settings dialog box after creating a New Configuration may cause a general protection fault and terminate the application.


Windows 95 and NT Operating Related Issues

•	In Settings | Preferences, the "Confirm on exit without send" option is always enabled.

•	Do not select multiple files are for printing. This causes a general protection fault and terminates the application.

•	Remove PROFS before installing Z-Mail Pro 6.1.
PROFS Transport is not part of Z-Mail Pro 6.1. If PROFS has been previously installed, you will be unable to remove PROFS once Z-Mail Pro 6.1 is installed. An attempt to use PROFS may cause a general protection fault and terminate the application.

•	To empty a remote Trash folder, you must choose the Empty Trash command from the right mouse button shortcut menu.

•	If other applications are on screen, Z-Mail Pro may default to the background when a message is sent.

•	In Windows 95, using the 256 color display with a 640x480 resolution may cause a general protection fault and terminate Z-Mail Pro 6.1.

•	When viewing an HTML message while linked to a URL, the forward and back buttons may not work correctly.

•	Saving HTML formatted messages as draft or template does not function properly.

•	If you include a URL with end punctuation (for example, http://www.netmanage.com!) in an e-mail message, choosing the URL in HTML view mode will produce an error.

•	The time may not be displayed next to the date when viewing a message.

•	In Windows 95 only, if a large number of Rules are active, retrieving a large number of messages causes a general protection fault. To avoid this problem, disable the Rules.

•	Reply in Original Mode does not always work.

•	If IMAP4 takes too long to load, Mail may stall when connecting to a University of Washington IMAP4 server. A potential cause is that the default folder location is your remote UNIX home directory. This directory contains non-IMAP4 files.
To avoid this problem, click here.


Installation Related Issues

•	If you upgrade Z-Mail Pro from a version of ChameleonNFS older than 6.01 you may lose some of the applications functionality.

•	If you install Z-Mail Pro 6.1 on top of a version which includes PROFS, and you try to use PROFS, the application will crash.


Autorun

Autorun is a feature that Windows 95 and NT supports on CD-ROM drives. If this feature is enabled when you load a CD into the drive, Windows 95 will automatically run the AUTORUN.EXE file on the CD root directory. If you are running Windows NT or the Autorun feature is not enabled (it can be disabled by an entry in the SYSTEM.INI file), you can load AUTORUN.EXE from Windows 95 Explorer or Windows NT File Manager. Change to the drive which is your CD-ROM drive and double-click the AUTORUN.EXE file.

In the installation window that appears after AUTORUN.EXE starts, select the product that you wish to install.Then select and install the files you want from the CD.


Automatic Setup
Automatic Setup of Z-Mail Pro

Automatic Setup enables a system administrator to specify default system settings, user-group specific settings, and user-specific settings for the Z-Mail Pro application. These settings are used by Z-Mail Pro when it is invoked the first time by the end-user. Thus, the end-user does not need to enter these settings. This type of setup is particularly useful for sites with a large number of seats.

The system administrator provides the settings by creating an Automatic Setup file, using the format specified below, in the Automatic Setup File Format section.

The Automatic Setup file should be put in the \netmanag directory. It can be put there by an installation program, or by the system administrator. If the Automatic Setup file is not included in the \netmanag directory, the end user must specify the settings through the Network Settings dialog box, the Preferences dialog box and other Z-Mail Pro dialog boxes. The Setup file uses the CFG style, consisting of sections and entries.

The Automatic Setup file contains the following sections:

Transport

Forum

Mail Default

User Groups

User Section

Mail Configuration

Mail User Configuration

Z-Mail Pro Settings

See Also:

Sample Automatic Setup Files


Administration Section

The Administration section contains information regarding the setup file format. The setup file can be in one of two modes. It can be written for a single user, or it can be written for more than one user. In the second mode, the system administrator will compose one file which contains settings for many users.

The Administration section is to be used in the first mode. If the file is to be used for a single user, some settings of this user can be defined in this section. The entries in the Administration section are

•	User - the Z-Mail Pro user name.

•	Password - the Z-Mail Pro password for the user specified in the User entry.

•	Real Name - the Real Name of the user specified in the User entry.

When a user name is specified in the User entry, the New User Dialog will not be shown.

Example:

[Administration]

User = lizl

Password = querty

Real Name = Lizzie Lizard


Transport Section

The Transport section contains information regarding the transport type. A typical entry is in the following format:

<transport-Name> = <transport type>

For example,

NetManage IMAP= IMAP4

Internet = Internet Mail

news = Forum

Transport types can be Internet Mail, IMAP4, etc.

•	Only one Internet Mail transport can be specified, and its name must be Internet.

•	Only one Forum transport can be specified and its name must be news.

•	Other transport types allow more than one transport to be specified per user, and do not have any restriction on the transport- name.

For lists of possible Internet Mail and IMAP entries, see Z-Mail Pro Settings .


Forum Section

The Forum section specifies news servers. The Profilename and Name keys are the only mandatory keys. Without these keys, the server profile will not be created.

For example,

Profilename = <string>

Name = <string>

It is also possible to specify a list of profiles in the autosetup file and to designate which profiles autosetup installs for each user. Create a section with the name News Servers which contains the names of sections of available servers where each server's profile is defined. It is possible to have both of these methods present for a user.

For a list of possible Forum entries, see Z-Mail Pro Settings .


Mail Default Section

The Mail Default section contains a set of entries for each transport listed in the Transports section. The Mail Default section also specifies which transports should be installed by default. This section can contain entries of two types:

<transport-Name>.<parameter> = <value>

or

<transport-Name>=YES/NO

The first entry type specifies a default parameter for a transport. The second entry type specifies whether that transport should be installed by default.

For example,

NetManage IMAP.HostName = imap.company.com

Internet.Host = pop.company.jp

NetManage IMAP=YES

Internet = NO

The example specifies the name of the default host for the NetManage IMAP transport (which is of the IMAP4 type). It states that the NetManage IMAP transport should be installed by default. It also specifies the host for the Internet transport (which is of the Internet Mail type) and that the Internet transport should not be installed by default.


User Groups Section

The User Groups section contains names of user groups. The system administrator can define a user group, such as Engineers or Sales, and provide specific settings for each group.

For example:

[User Groups]

Engineers =

Sales =

The settings in a User Groups section override the settings specified in the Mail Default section.

A Users Group section can contain the two entry types specified in the Mail Default section. In addition, a third entry type can be specified in this section. The third entry defines a user contained in a group. The format of the third type is:

[Sales]

<user-name> =

For example:

 [Sales]

Internet.Host = 199.44.33.111

camille =

lizl =

The example states that the users camille and lizl are part of the Sales group. The example also specifies the Internet transport Host for the Sales group members.

A user can be part of only one group. If a user is listed in more than one group, only the settings for the first group(according to the groups order in the User Groups section) are used.


User Section

A User section is distinguished by a user name. The settings specified in a User section override the settings in the users Group section (if the user is part of a group), and the settings in the Mail Default section. The User section can contain entries in the two formats that are used in the Mail Default section. For example:

 [camille]

NetManage IMAP.HostName = imap2.company.com

NetManage IMAP=NO

Internet = YES

Internet.Host = mail.company.com

For the user whose name is camille, the NetManage IMAP transport should not be installed, although the Mail Default section setting is to install this transport.


Mail Configuration Section

The Mail Configuration section contains a list of entries that should be copied, as is, to the Mail.cfg file. The entry format is:

<Entry name>= <Value> = <Section name>

For example:

 [Mail Configuration]

shareit = X-Chameleon-ShareIt NONE NONE 0 1 = Mail Clients

In this example, the entry shareit is added to the Mail Clients section of the Mail configuration file with the value X-Chameleon-ShareIt NONE NONE 0 1.

This section can be used to define entries in the Mail.cfg file. Note that if this section does not exist, or it contains no entries, it will not break the automatic setup. Any entry that is used in the Mail.cfg file can be set if listed in this section. For a list of those entries see Z-Mail Pro Settings .


Mail User Configuration Section

The Mail User Configuration section contains a list of entries that should be copied, as is, to the Mail users configuration file. The entry format is:

<Entry name>= <Value> = <Section name>

For example:

 [Mail User Configuration]

HEADER ONLY RETRIEVAL = 1 = SETTINGS

HEADER ONLY KB LIMIT = 128 = SETTINGS

In this example, the entries HEADER ONLY RETRIEVAL and HEADER ONLY KB LIMIT are added to the SETTINGS section of the User configuration file.

This section can be used to define entries in the User.cfg file. Note that if this section does not exist, or it contains no entries, it will not break the automatic setup. Any entry that is used in the User.cfg file can be set if listed in this section. For a list of those entries see Z-Mail Pro Settings .


Z-Mail Pro Settings

List of possible entries in the Mail Configuration section

MAPI DIALOG DISPLAYED=1=MAPI

FLUSHOUTBOXQUEUE=NO=OUTBOX

List of possible entries in the Mail User Configuration section

From the SETTINGS section -

AUTO RETRIEVE=YES/NO

DELETE RETRIEVED=YES/NO.

REPLY ONLY TO SENDER=YES/NO

COPY ORIGINAL ON REPLY=YES/NO

INDENT INCLUDED TEXT=YES/NO

INTERNATIONAL ENCODING=8bit

CONV SOFT BREAK TO RCLF=YES/NO

HEADER ONLY RETRIEVAL=n

HEADER ONLY KB LIMIT=n

From the SECRET KEYS section -

<key name> = <encrypted key Value>

Supported Transport Types

The transport types supported in Z-Mail Pro are:

•	Internet Mail: Supports the SMTP and POP mail protocols.

•	IMAP4: Supports the Internet Message Access Protocol for accessing electronic mail messages on a remote server.

•	Forum: For sending news articles using the NNTP protocol.

Internet Mail Entries

The possible entries for the Internet Mail transport type are:

•	Host - The name or the IP number of the POP server.

•	User - The mail user name for the specified host.

•	Delete Retrieved - Should retrieved mail be deleted from the Host (YES/NO).

•	Gateway - The name or IP number of the SMTP server.

IMAP4 Entries

The possible entries for the IMAP4 transport type are:

•	HostName - Specifies the IMAP server IP or name.

•	UserName - Specifies the users name on this server. If a username is not specified here, the Z-Mail user name is used.

•	FolderLocation - Location of the users folder on the server.

•	KeepCache - Specified whether to keep the cache between sessions. Possible values are 0 or 1

•	ConnectOnStart - Specifies whether a connection should be established when mail is started. Possible values are 0 or 1

•	DirectDelete - Specifies whether to move deleted messages to the Trash folder. Possible values are 0 or 1

•	Port - Specifies the communication port.

Forum Entries

The possible entries for the Forum transport type are

•	Profilename - The name of the profile. This is a description of the server such as "NetVision news server" or "Intranet server" and is the string that appears in the left pane of Forum.

•	Name - The name or IP address of the news server to connect to such as news.netvision.net.il" or "194.90.15.1"

•	Port - The communication port of the news server specified in the Name field. The default value is 119.

•	Username - The user name needed to log into the news server.  The default entry is <blank>.

•	Password - The password needed to log into the news server. The default entry is <blank>.

•	CheckForNewGroups - Check new groups at startup: When checked, each time the Forum program is started,  Forum runs a check for new groups on the news server. You view the new groups in the Subscribe dialog.  Possible values are 0 or 1.  The default value is 0.

•	Autoretrieve - When checked, performs periodic checks for new articles in the subscribed groups on the news server, according to the check interval (below).  Possible values are 0 or 1.  The default value is 0.

•	CheckInterval - Specifies the interval for checking for new articles.  The default is 60 minutes.

•	Active - Specifies if the server is active. An inactive server is not displayed or connected to.  Possible values are 0 or 1.  The default value is 1.

•	Newsgroup# - Subscribe to the specified newsgroup where # is a consecutive number (starting with 1) that increases for each newsgroup specified.


Sample Automatic Setup Files

Automatic Setup File without User Groups or IP sections:

 [Transports]

Internet = Internet Mail

[Mail Defaults]

Internet = YES

Internet.Host = pop.company

Internet.DeleteRetrieved = YES

 [Mail Configuration]

Mail Clients = Phonetag = X-Chameleon-PhoneTag NMPHONETAG NMPhoneTagReceiveMemo 0 1

[Mail User Configuration]

AUTO RETRIEVE = NO = SETTINGS

REPLY ONLY TO SENDER = YES = SETTINGS

OurCompany = ERANERANERANERANERANERANERANERANERANERANERAN = Secret Keys

Automatic Setup File with User Groups and IP Sections:

 [Transports]

Internet = Internet Mail

[Mail Defaults]

Internet = YES

Internet.Host = pop.company

Internet.DeleteRetrieved = YES

[User Groups]

Sales =

QA =

Engineers =

[QA]

camille =

lizl =

Internet.Host = qa_pop.domain

Internet.Delete Retrieved = NO

[charlie]

Internet = NO

[lizl]

Internet.DeleteRetrieved = YES

Automatic Setup File without User Groups or IP sections:

[Transports]

Internet = Internet Mail

[Mail Defaults]

Internet = YES

Internet.Host = pop.company

Internet.DeleteRetrieved = YES

[Mail Configuration]

Mail Clients = Phonetag = X-Chameleon-PhoneTag NMPHONETAG

NMPhoneTagReceiveMemo 0 1

[Mail User Configuration]

AUTO RETRIEVE = NO = SETTINGS

REPLY ONLY TO SENDER = YES = SETTINGS

OurCompany = LIZLLIZLLIZLLIZLLIZLLIZLLIZLLIZLLIZLLIZLLIZL = Secret Keys

Automatic Setup File with User Groups and IP Sections:

[Transports]

Internet = Internet Mail

[Mail Defaults]

Internet = YES

Internet.Host = pop.company

Internet.DeleteRetrieved = YES

[User Groups]

Sales =

QA =

Engineers =

[QA]

camille =

lizl =

Internet.Host = qa_pop.domain

Internet.Delete Retrieved = NO

[charlie]

Internet = NO

[lizl]

Internet.DeleteRetrieved = YES

Automatic setup profile for the server "news.netvision.net" for user 'camille':

[Administration]

User=camille

[Transports]

news = Forum

[Mail Defaults]

news = YES

[camille]

news.Profilename = Netvision news server

news.Name = news.netvision.net

Automatic setup profile configured for two servers, with only one server installed for user 'camille':

[Administration]

User = camille

[Transports]

news = Forum

[Mail Defaults]

news = YES

[News Servers]

Netvision server=

Zeke=

[Netvision server]

;No Profilename specified - it is taken as "Netvision server"

Name=news.netvision.net.il

CheckForNewGroups=1

;Check for new articles once every 1 1/2 hours

Autoretrieve=1

CheckInterval=90

[Zeke]

Name = zeke.netmanage.com

[camille]

news.Netvision server = YES

Automatic setup profile configured to connect user camille to server news.netvision.net and subscribe to four newsgroups:

[Administration]

User=camille

[Transports]

news = Forum

[Mail Defaults]

news = YES

[camille]

news.Profilename = Netvision news server

news.Name = news.netvision.net

news.Newsgroup1 = rec.humor

news.Newsgroup2 = alt.weather

news.Newsgroup3 = local.il-talk

news.Newsgroup4 = rec.scuba


Uninstalling Z-Mail Pro

The Uninstall command will remove all directories and files under the directory in which you installed Z-Mail Pro. The default directory is C:\netmanage.32 directory.

To preserve your personal data, such as email messages, move your default email directory to another directory on your system. For example, if you installed Z-Mail Pro in the default directory (C:\netmanage.32), your default directory under that directory will be C:\netmanage\email\{your-name}. Move the {your-name} directory to another directory, or directly under C:\. For example: C:\{your-name}.


TCP/IP Stack

You must have a TCP/IP network stack installed on your computer in order to connect to the Internet and, therefore, in order to use Z-Mail Pro.

•	The Microsoft TCP/IP stack is included with Windows95 and Windows NT operating systems.

•	The NetManage TCP/IP stack is included with Z-Mail Pro for Windows 3.1, since Windows 3.1 does not include its own TCP/IP stack.


NetManage TCP/IP Preparation Form

The NetManage TCP/IP Preparation Form uses the following format:

Information needed [Sample information]	Your system information here

General

Where to install software [C:\NETMANAG]	_______________

Interface type [Ethernet]	_______________

Internet address [156.27.1.51]	_______________

Host name [my host]	_______________

Subnet mask [255.255.0.0]	_______________

For LAN interfaces

Adapter vendor name [3COM]	_______________

Adapter type [3C503]	_______________

Interrupt level [5]	_______________

I/O base address [0x300]	_______________

For SLIP/CSLIP/PPP interfaces

COM port [COM2}	_______________

Baud rate [9600]	_______________

Flow control [Hardware]	_______________

Modem type [Hayes]	_______________

Telephone number [408-123-1234]	_______________

For ISDN interfaces

Vendor [ISDN.TEK]	_______________

Board type [ISDN.TEK1]	_______________

IRQ_Level [5]	_______________

Memory [0x300]	_______________

SPID1	_______________

SPID2	_______________

Optional

Domain name [netmanage.com]	_______________

Default Gateway [156.27.1.1]	_______________

Domain server address [156.27.1.2]	_______________


BOOTP

BOOTP is a protocol that obtains all the information required for a computer to become fully operational on a TCP/IP network.

The BOOTP client allows a node to obtain information about IP addresses, operating system programs and TCP/IP network code from a BOOTP server.


To prevent a stall when connecting to a University of Washington IMAP4 server

1.	Create a root folder named Mail/.

2.	Choose Network Settings... from the Settings menu; the Network Settings dialog box opens.

3.	Choose the Advanced button in the IMAP tab; the Advanced IMAP Settings dialog box opens.

4.	Set the folder's location to Mail/ in the Location text box in the General section.

5.	Restart Z-Mail Pro.


Express Installation of Applications

Setup installs the following set of applications if you select the Express option during the installation process:

Z-Mail Pro	Tag-It!
Z-Mail Pro Administration	Z-Mail Pro Uninstall
Outbox	Readme
Phone-Tag


Online Manual Files for NetManage Configuration Guide 6.0

\DOC

\NMCONFIG

NMCONF.PDF

INDEX.PDX

\INDEX

\ASSISTS

\MORGUE

\PARTS

\PDD

\STYLE

\TEMP

\TOPICIDX

\TRANS

\WORK


Open Directory Service Sample Unix Scripts

Open Directory Service (ODS) is a simple general purpose directory service protocol designed for use with the Z-Mail Pro mail client.  In this release we provide several scripts for use with the Unix operating system.  The scripts provide examples of ODS used with an arbitrary text file, the Sendmail SMTP mail server aliases file, or the alias map provided by Sun NIS.

The scripts are provided on the release CD in the directory ODS.  The dirserv.d script is a script used by INETD to listen for and launch directory server requests.  The lookup.flat script is a script which can be launched by dirserv.d to search a user-supplied ASCII file.  The lookup.alias is a script which can be launched by dirserv.d to search a Sendmail aliases file or the Sun NIS aliases map.

The documentation for installing and using these scripts is provided in the Address book help file (NMADBKN.HLP or NMADDRBK.HLP), under How to use ODS. The prerequisite for installing and using these scripts is familiarity with Unix system administration, i.e., having a superuser account and familiarity with the use of INETD.  It is recommended that the script directory be copied from the CD onto a directory on a Window machine running either and NFS or FTP server. These files can then be copied to a Unix machine via either an NFS mount or an FTP transfer.