Contents
Z-Mail Pro Contents

This help file contains a list of all Help topics available for Z-Mail Pro.  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	What's New
Menus

File

Message

Folders

Services

 Settings

Go IntraNet!

Help

Menus for New Message window

Menus for View Message window

Drop-down menus


Overview

The Z-Mail Pro application provides electronic mail services for the TCP/IP network environment. (Support for SNA network environments is not provided in the Z-Mail Pro Standalone product.  To use the SNA mail transport, you must have Chameleon Hostlink for SNA network environments.)  To communicate within the standard Internet (TCP/IP) environment, Z-Mail Pro uses the Simple Mail Transfer Protocol (SMTP) to both send and receive mail, and the Post Office Protocol (POP2 and POP3) to retrieve mail from a server.  You can use these protocols to directly integrate with UNIX mail.   Z-Mail Pro supports MIME (Multi-purpose Internet Mail Extensions ) which allows you to attach files to mail messages.

Z-Mail Pro in previous versions was called Mail.

Features include the ability to:

•	read and prepare messages off-line, saving you connection costs

•	attach multimedia files to your messages through MIME (Multi-purpose Internet Mail Extensions)

•	view a message in standard HTML(Hypertext Markup Language) format and Edit HTMLformatted text directly in Z-Mail Pro for Windows 95 and NT and in WebSpider for Windows 3.1

•	Internet message access through Internet Message Access Protocol (IMAP4) with support MAPI-enabled (Messaging Application Programming Interface) applications.  Also see IMAP Transport of Mail

•	route messages to others one after another

•	retrieve message header only information using the Smart Pop feature

•	create rules for automatically filtering and filing incoming mail

•	create your own personal address books

•	attach binary files through uuencode/uudecode

•	set up multiple mail accounts

•	create rules to activate the new Z-Mail Pro scripting language ( using  VBA scripts)

•	view graphic attachments using Inline Images

•	send files to recipients without opening Z-Mail Pro

•	access Forum directly from Z-Mail Pro


Z-Mail Pro Administration

The Z-Mail Pro Administration application allows you to manage your Mail database.  Z-Mail Pro Administration is a separate icon that is used exclusively with Mail.  Features include the ability to:

•	merge two mailboxes

•	compact mailbox

•	generate mailbox from message files

•	remove unmatched entries

•	rebuild folder information

Note:	For detailed online help information about Z-Mail Pro Administration, select the Help button from within the Z-Mail Pro Administration application.


Mail Transports Setup

This dialog appears when you open the Z-Mail Pro application for the first time as a specific user. You may select any of the available checkbox items:

•	Internet Mail: Indicates that you want the Z-Mail Pro application to be set up for handling standard Internet email.

•	IMAP: Internet Mail Access Protocol is a client/server protocol , for manipulating remote message files. IMAP accesses mailboxes (folders) on remote servers as if they were local mailboxes, using the same commands such as moving to folders, search, marking messages.

•	Forum: Forum send-message support sends news articles using the NNTP-Usenet protocol. This transport is installed automatically and cannot be deselected.


Prompt for Automatic Login

If you want to include the Login Prompt and the Password Prompt as part of your Connection Profile, you should connect and log in to the host and write down the prompts that are displayed for username and password.  The specified text string must match the prompts (or a portion of the prompts) as they are displayed.  They are case-sensitive.


Configuration File

The application’s configuration file contains settings for various options used by the application.

When you first open an application or when you open a New configuration file, the configuration file contains default values for the various options.

While using the application, you may select additional options and/or modify some of the default settings.  These changes can be saved to the existing configuration file, or you can use the Save As command to save the changes to a configuration file with a new name.


Login
Login Dialog Box

Anytime you launch Forum, NEWTCal, Mailbox Converter, Phone Tag, Tag-It!! or Z-Mail Pro and you already have an established account, you will need to complete the Login dialog box.  This dialog box prompts you for your username and password.  It also provides you with the Offline option.

The Offline option disables the automatic timers for sending and receiving mail.  If you select Offline, you will need to:

1.	Manually retrieve your messages by selecting the Retrieve Messages option from the Mail menu.

2.	Open Outbox and manually send all queued outbound messages.

Note:  	Refer to the section on Dial On Demand in Custom for information about using Offline with dial-up connections.


Help

Diagnose Connection

Contents

Legend...

Tech Support Web Site

Support Wizard

Tech Support Web Site, Application FAQ

Online Manual

Register With Us

About Z-Mail Pro...

About NetManage


Diagnose Connection

Use the Diagnose Connection command to start Ping and verify that the server is available.  The server name or IP address can be found under Network Settings in the Settings menu.


Legend
Legend...

The Legend menu provides a graphic and description for each type of Z-Mail Pro message entry.  You can tell if a message is urgent (red), has an attachment (paper clip), has not been read (yellow), is a draft letter (pen symbol), or has other descriptions.


Contents

Displays the contents of the application's Help system.

While using Help, you can return to the Contents screen by choosing the Contents button in the Help window.


About Z-Mail Pro
About Z-Mail Pro...

Choose the About Z-Mail Pro... command from the Help menu for version 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.

Additional information on electronic mail is available through the following publications:

Su, Zaw-Sing, and Jon Postel, The Domain Naming Convention for Internet User Applications, RFC 819, Network Information Center, SRI International, Menlo Park, Calif., August 1982.

Postel, Jon, Simple Mail Transfer Protocol, RFC 821, Network Information Center, SRI International, Menlo Park, Calif., August 1982.

Crocker, Dave, Standard for the Format of ARPA-Internet Text Messages,  RFC 822, Network Information Center, SRI International, Menlo Park, Calif., August 1982.


Troubleshooting

If you experience difficulties using the Z-Mail Pro application, refer to the following items:

General Information:

•	If you are having trouble starting mail, make sure the path in your mail.cfg correctly points to your mailbox directory.

•	If you cannot open your mailbox because you forgot your password, then edit the MAIL.CFG file and remove the encrypted password next to your name.  For example, if John=fg78%$, then fg78%$ is the encrypted password.

•	Use the Ping application to verify connectivity to the domain portion of any destination address if Mail reports a failure to deliver.  Verify connectivity to your mail server is defined.

•	Use the logging feature ( from the Settings menu) to help diagnose client transmission and mail server retrieval problems.  Check replies for connection errors or destination address errors.

•	Make sure the user name portion of the destination address is defined at the destination.  The Postmaster may define new users by using the Mailboxes item under the Services menu.

•	If after creating a rule using scripts mail is not being retrieved, check you have closed all dialog boxes for scripts and rules. While the VSE is open through mail, mail is not being retrieved.

InternetMail Information

•	If you are having trouble retrieving Internet mail, make sure that the remote system supports the SMTP protocol.  Verify that the POP2 or POP3 daemons are running on the mail server system. The POP2 known port is 109 and the POP3 port is 110.  To verify if the daemons are running, use the Telnet application to connect to ports 109 or 110.  The system replies with a message indicating if the correct daemons are running on ports 109 or 110.

•	If you have trouble sending Internet mail, verify that SMTP is available on the remote host, and you have specified the correct mail gateway address under InternetMail Network.  Also verify that the To: field (destination address) is complete.  For example, steven@netmanage.com.

•	For POP2 only, you also need to verify that the mail directory settings are correct.  Make sure that your password and mail path (/user/spool/mail/username) are correct.  Contact your system administrator for more information.

Outbox Information:

•	If you are having trouble sending mail, make sure that the remote system supports the SMTP protocol.

•	If you have trouble sending mail, verify that SMTP is available on the remote host, and you have specified the correct mail gateway address under Network settings.

•	Use the Ping application to verify connectivity to the domain portion of any destination address if Outbox reports a failure to send.


Personal icons
Personal icons...

Personal icons lets you create a Personal icon collection, attach a Personal icon to your outgoing messages, and choose how you want to view a message with a picon.  To do this:

1.	Enter the pathname of the .BMP, .GIF, or .XMB file you want to attach as a Personal icon to your outgoing Mail in the Your Personal icon text box.

2.	Select the Attach to outgoing mail check box if you want the Personal icon automatically attached to all your outgoing messages.

3.	Enter the pathname of your Personal icon directory in the Personal icons collection text box.  Use the Browse...button to locate an existing directory.  Place your Personal icon directory in the location where Chameleon Z-Mail Pro is installed.  The default directory is C:\NETMANAG.32\PICONS.  Note that all directory names in your hierarchy are automatically truncated to eight characters.

4.	If you want Z-Mail Pro to search the entire path of the sender's e-mail address for a FACE.BMP file (within your Personal icon directory), then select the Enable use of Personal icons collection check box.

For example, if the sender is Tom@netmanage.com, then Z-Mail Pro would first search within your Personal icon directory for the Personal icon file FACE.BMP in directory Tom.  If this file was not found in Tom, then Z-Mail Pro would look for the file next in directory Netmanag, and then directory COM and so on up to the root until it finds it.

5.	If you want Z-Mail Pro to display the Personal icon that was attached to the sender's email before looking for a matching Personal icon in your Personal icon collection, then select the Look first for Message icon check box.

6.	If you want to view a message that does not have an attached picon, but you want Z-Mail Pro to search your Personal icon database and display an icon associated with the exact sender, select the Use collection only on exact match check box.

For example, if the sender's e-mail address is Tom@netmanage.com, then the Personal icon file (FACE.BMP) would have to reside in directory Tom.

7.	Choose the OK button.

Note:	The Chameleon logo is printed instead of the personal icon if your print settings are set to Print Personal Icon in Header and the message being viewed, or selected for printing, is using a color icon from the icon database.


Using Personal icons

A Personal Icon, is graphics file that appears in a mail message window.   Most commonly used Personal icons are a picture of your face, company logo, or some other symbol you want to appear in your message. This file must have a .BMP, .GIF, or .XMB extension and must measure 48 x 48 pixels.

The Personal icon feature lets you attach Personal icons to messages and view messages with Personal icons.

You can, however, view a message and see its Personal icon even if the Personal icon is not directly attached to the message. To do this, you need to create a Personal icon collection and store Personal icon files that are associated with specific Z-Mail Pro users.  You can specifically set Personal icon settings so that Z-Mail Pro searches your Personal icon collection for a file that matches the sender's e-mail address (in the From text box). Then, when you view the message, a Personal icon that matches the sender's address appears in their message.

If there is no Personal icon file (FACE.BMP file) that matches the exact e-mail address of the sender, then Z-Mail Pro searches up the directory path of the e-mail address for a FACE.BMP file.

See also

Creating a Personal Icon Database

Sending Messages with Attached Personal icons

Viewing Messages with Personal icons


Creating Personal icon Collection
Creating a Personal icon Database

Create a Personal icon collection to store Personal icons that are associated with Z-Mail Pro users.  To do this,

1.	Choose the Personal icons command from the Settings menu.  The Personal icons Setup dialog box appears.

2.	Create a directory where you want to store your Personal icons and place it in the directory path where Chameleon Z-Mail Pro is installed.  The default database directory is C:\NETMANAG.95\PICONS.  Enter this directory path in the Your Personal icon text box.

3.	Within this directory, create a directory hierarchy that contains the sender's exact e-mail address, and place the FACE.BMP file at the bottom of the hierarchy.  Note that all directory names are truncated to eight characters.  For example, if your Personal icon collection directory is C:\NETMANAG.95\PICONS, and the sender's e-mail address is Tom@netmanage.com, then the directory structure for Tom's Personal icon would look like this:

C:\

NETMANAG.95

PICONS

COM

NETMANAG

TOM

FACE.BMP

If there is no FACE.BMP file in directory Tom, then Z-Mail Pro would next search in directory UNKNOWN, then directory NETMANAG, and then directory COM for a FACE.BMP (or FACE.GIF, FACE.XBM) file.

Note:	Personal icons located in the Personal icon collection must be 48 x48 pixels, be named FACE and have the extension .BMP, .GIF, or .XBM and may be color or black and white.


Sending Messages with Attached Personal icons

You can attach a Personal icon to your outgoing messages. The Personal icon must have a .BMP, .GIF, or .XBM extension, be black and white, and measure 48 x 48 pixels.

To attach a Personal icon to your outgoing messages, choose the Personal icons command from the Settings menu.  The Personal icon previously setup in Settings, Personal Icon, will be used.

Note:	If you are directly attaching a Personal icon to a message, then it must be black and white.


Viewing Messages with Personal icons

There are several ways that you can view a message with a picon.  The Personal icon can be attached to the message, or reside in your Personal icon collection.

If you want to view a message without seeing the sender's Personal icon under any condition choose the Personal icons command from the Settings menu.  It is a toggle switch that allows a personal icon to appear or not appear.

If you want to view a message that does not have an attached picon, but you want Z-Mail Pro to search your Personal icon collection and display an icon associated with the sender, do the following:

1.	Choose the Personal icons command from the Settings menu.

2.	Enter the name of your Personal icon directory in the Personal icons collection text box.

3.	Select the Use collection only on exact match check box.

This instructs Z-Mail Pro to search for the Personal icon file that exactly matches the sender's e-mail address path.  For example, if the sender's e-mail address is Tom@netmanage.com, then the Personal icon file (FACE.BMP) would have to reside in directory Tom.

4.	Or, select the Enable use of Personal icons check box, if you want Z-Mail Pro to search the entire path of the sender's e-mail address for the Personal icon file FACE.BMP.  For example, if the sender is Tom@netmanage.com, then Z-Mail Pro would first search for the Personal icon file FACE.BMP in directory Tom. If this file was not found in Tom, then Z-Mail Pro would look for the file next in directory netmanag, and then directory COM and so on up to the root until it finds it.

Note:	If you choose to print the message, the Chameleon logo is printed instead of the personal icon if your print settings are set to Print Personal Icon in Header and the message being viewed, or selected for printing, is using a color icon from the icon database.

See also

Saving a Personal icon from a Viewed Message

Showing/Hiding a Personal icon in a Viewed Message


Saving a Personal Icon from a Viewed Message

If you view a message containing a Personal icon that was attached by the sender, you can save this Personal icon to your Personal icon collection.  To do this:

1.	Select the message you want to view.

2.	If it contains a Personal icon you want to save to your Personal icon collection, then choose the Save Personal icon command from the Edit menu.

Note that you have to already have your Personal icon collection set up.  If not, you will receive an error message stating that no Personal icon collection exists.  If this occurs, simply set up your Personal icon collection using the Personal icon Setup dialog box.


Showing/Hiding a Personal Icon in a Viewed Message

You can choose to show or hide the Personal icon in a message you are viewing.  To do this, do the following,

1.	Select the message you want to view.

2.	Check the Show Personal icon command to show the picon.  This is the default.

3.	Uncheck the Show Personal icon command to hide the picon.

Note:	To automatically hide Personal icons from all messages you view, select the Always check box on the Personal icons Setup dialog box.


Rules Overview

Many users find that their Inbox becomes full of messages that need sorting into different folders, deleting, forwarding and so forth.  To make sorting easier and faster, you can create rules to automatically apply a specified action to all incoming mail that meets a set criteria.

Prioritizing and Sorting Mail

For example, you may want all mail that is addressed to you personally to be moved immediately into a folder called personal.  Another rule could move all mail that is addressed to your alias “salesteam” to be moved to a folder named sales.  In this way, when you retrieve mail, all your mail will no longer be placed just into the Inbox.  This not only saves you the time of moving mail between folders as you manually sort out the new messages, it also allows you to prioritize. You can easily focus on mail addressed specifically to you first, then messages addressed to your alias salesteam, and afterwards read the mail in your Inbox, which contains mail from your other aliases, such as the company alias.

You may sort your messages according to who sent the message.  You can create a rule, so that all your mail from your boss is moved into a folder called important, and all your mail from colleagues/friends is moved into a folders named after each person.

Rules for Deleting Mail

Rules allow you to delete messages.  You may belong to an alias that no longer interests you, but you have not yet been removed from that alias, so all these messages can be moved straight into the trash folder.  Or, you do not want to receive messages that have certain text in the subject line, such as “humor” - these messages can all be moved into the trash folder.

Rules for Forwarding Mail

Messages may be automatically forwarded.  Any message sent to the salesteam alias you can forward to the sales manager, who does not belong to this alias yet. Using the address group, you can define a group, such a “saleslead”, containing a list of addresses from your addressbook, such as janet@somewhere.com, fred@somewhere.com and jean@somehwere.edu.  Using rules you set the criteria, for example, all mail with the word “order” in the subject line, to be forwarded to the group you created, such as “saleslead”.  In this example, all messages with the word order in the subject filed are forwarded to Janet, Fred and Jean.

Rules using Scripts

More advanced users can create their own scripts to apply different rules to messages.  A script for vacations is provided.

Rules offer endless possibilities for you to effortlessly manipulate your messages and to make organizing your mail very convenient.

Note:	Only one rule can be applied to each message.  The highest rule in the rule list will be applied, in instances where the criteria for multiple rules is met.  For example, I have a rule that moves all messages addressed to Lizzie into a folder named Personal.  I have another rule specifying that all mail sent by Betty will be moved into a folder named Betty.  If Betty sends a mail to Lizzie, the message will be moved into the folder, according to the rule higher in the list.  So if the rule moving messages into the Folder named Personal is higher in the list, this is where the message is moved.

See Also

Creating Rules


Confirmation When Retrieving Header Only Messages

If you want to be prompted before you retrieve an entire mail message, then select the Confirm before retrieving the entire message option on the Smart POP dialog tab. If  you select this option, then a dialog box containing a prompt asking you if you want to retrieve the entire message appears.  Choose the Yes button to retrieve the message.  You can also disable the prompt from appearing again by selecting Don't display this prompt again.


Remote Host Has Changed
Message Status on the Mail Server Has Changed

The message status on the mail server has changed since you last retrieved mail using THIS mail client.

Note:	This occurs because your mail was retrieved and deleted from the server using a different mail client since your last connected with this mail client.  When mail is retrieved but not deleted (set under Internet Settings) this does not occur.

If you have any header only messages from your last mail connection, they will be removed from your local Mailbox.


What's New

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.

•	Z-Mail Pro and Forum attachments may now be zipped or encrypted, see Attachments - New.

•	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 newsgroups where it was posted, and follow the threads.

•	Encryption and Decryption of attached files are easier to use.  See Using Encryption.

•	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 opton helps save screen space when viewing Forum articles.

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

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

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


Send To...

The Z-Mail Pro Send To feature lets you send a selected file as an e-mail attachment without opening Z-Mail Pro or any other program. You may zip and/or encrypt these file attachments. The Send To feature only operates from the Windows NT or Windows 95 Explorer.

Note:	In order to read an encrypted attachment, the recipient must use Z-Mail Pro version 6.1 or greater.

To use the Send To feature:

1.	Open the File Explorer.

2.	Select a file, using the right mouse button. A pop-up menu appears.

3.	Choose the Send To option and select the Z-Mail Pro as Attachment from the pop-up menu. This opens the Z-Mail Pro SendTo window.

4.	Enter the Z-Mail address in the To field of the dialog box. If you wish, you may select an email address from the Z-Mail Address Book by choosing the Address Book button.

5.	Enter any desired message information in the Body field. Z-Mail Pro may be opened from here, if necessary, for message editing.

6.	Choose one of the Option buttons to select an entry. The possible entries are

•	Normal: is the default and immediately sends the file.

•	Encrypted: uses the DES40 algorithm, giving a .NZE file extension.

•	Zipped: zips (compresses) the file into a ZIP format with a .ZIP file extension.

•	Zipped and Encrypted: zips (compresses) the file to a ZIP format then encrypts it, giving a .NZE file extension

•	Zipped with Password: zips the file and prompts you for a password.

Note:  	If you selected Encrypted or Zipped with Password, a dialog box opens for key selection. The dialog box is the same for both Zipped with Password and Encrypted files. Files that are only Zipped are sent immediately.

7.	In the File Encryption/Zip file password protection dialog box select an existing key or choose the New button to make a new key. New keys may be saved for future use.

8.	If you choose the New button, the New Key window appears. Enter a key name in the Name field. Enter a value in the Value field. The longer the value the more effective the key.  Choose the OK button to return to the File Encryption window.

9.	Choose the OK button for the file to be sent.

The zipped or encrypted files have the extension of .ZIP if zipped or .NZE if encrypted. To view a .NZE file you must have Z-Mail Pro, release 6.1 or higher. Any mail user may view a zipped with password file by specifying the key value as a password.


Threading

Use the Go to thread in Forum command in the View menu (View Message/Article window) to view all the newsgroups and articles in Forum related to this message.  The Toolbar Thread button gives you the same access.  The threading display in Forum organizes the article listing so that all articles and their related articles are grouped together.  You may view articles in HTML format if they are HTML articles.

Forum in previous versions was called NEWTNews.  Forum allows you to:

•	connect to more than one news server

•	subscribe to newsgroups

•	work offline

•	read articles

•	post and mail articles containing mult-media (HTML) and attachments


IMAP4

Z-Mail Pro uses IMAP4 (Internet Message Access Protocol), which is a client/server protocol, for manipulating remote message files.  Remote and local folders are fully integrated in Z-Mail Pro; messages are viewed and folders managed in the same way.  IMAP accesses mailboxes (folders) on remote servers as if they were local mailboxes, using the same commands such as moving to folders, search, marking messages.  For further information on IMAP, see IMAP Transport of Mail.


Mail Procedures
How to Use Z-Mail Pro

You can perform the following operations in Z-Mail Pro.  Select the desired topic for more information.

Creating and Sending Mail Procedures

Creating and Using an Address Book

Defining a Z-Mail Pro Server and Gateway

Displaying and Organizing Mail Messages

Encryption

IMAP Transport of Mail

Saving Changes to a Configuration File

Setting Up Z-Mail Pro

Using Command Line Options

Using Rules

Using the Outbox

Viewing and Editing HTML Documents

Setting Up Open Directory Service


Displaying Mail Messages
Displaying and Organizing Mail Messages

Deleting Mail

Organizing Your Mail Messages

Retrieving Message Headers Only

Viewing Mail Messages


Creating and Sending Mail Procedures

Appending Mail Messages to a File

Creating and Saving a Template

Creating and Sending Mail

Creating and Updating a Draft Message

Editing Mail Messages

Routing Messages

Saving Mail Messages to Files

Using Attachments

Using Personal Icons

Uuencoding and Uudecoding Messages


settingupMail
Setting Up Z-Mail Pro

To set up Z-Mail Pro, you need to set up a mail account for the first time user, and/or for additional users.


Organizing Your Mail Messages

Z-Mail Pro allows you to create folders for organizing your mail messages.

When the main Mail window is displayed, you will notice that the window is split into two panes:  the left pane is called the Containers pane and the right pane is called the Contents pane. If you have installed the IMAP transport, the Containers pane is also split into two panes;  the top pane contains a list of all local mail folders, and the bottom pane contains a list of remote mail folders used with IMAP (Internet Message Access Protocol).  The Contents pane contains a list of all the messages in the current folder.

In the Containers pane, the names of existing folders, for both local and IMAP, are displayed along with each folder's icon, number of unread messages and total number of messages.  The default folders in descending order are:  Inbox, Draft, Routing, Sent Mail, Template, and Trash.  All other folders you create are listed alphabetically.

Note:	You cannot delete the Inbox, Draft, Routing  Sent Mail, Template, or Trash folders.  These folders always appear at the beginning of the Containers Pane  list even when they are empty.

In the Contents pane, a list of all the messages in the currently selected  folder are displayed.  You can drag and drop a message from the right side of the window into the desired local folder on the left side, much like moving files into directories in File Manager.  You can also drag and drop messages between remote and local folders and between folders on the same remote host.

You can also associate attributes to your incoming messages by selecting the Rules command from the Services menu.  You can create a rule so that all messages addressed to you are automatically moved to a specific folder. Or, create a rule so that all messages you receive from a particular person are automatically forwarded to that person.


Creating and Sending Mail

To create and send a mail message:

1.	From the main Z-Mail Pro window, choose the Create button or use the key combination CTRL+E.

2.	A new mail message window appears.  If you have enabled settings. for more than one transport (Internet Mail), the New Mail dialog box contains a drop-down list from which you can select the desired Mail Transport.

•	Internet Mail: Select this transport to create a standard Internet Mail email message.

•	News: select this transport to post a message to a specified newsgroup.

The Date field is automatically set to the current date and time.  The From field is automatically set to the From field that you defined in Network Settings.  If this has not been defined it is automatically set to your user@localhost.domain. If this host has not been defined, it is set to user@popserver.

3.	You may address your message as follows:

•	Enter the e-mail name and address of the person you want to send the message to in the text box next to the To field.  Then, using the down arrow, select either To (primary recipient),  CC (carbon copy),  or Bcc (blind carbon copy).

•	To add additional recipients from an address book:  choose the Address button to display the Address Book dialog box containing your address book(s) and their entries. Then, select or type each entry you want to add as a recipient, and choose the To, Cc, or Bcc buttons.  Choose the OK button to return to the new mail window.

•	News: If you have selected News, type the newsgroup you require and press ENTER. When the address appears in the field below, <@News:> is automatically added to the address.

Note:  	The Bcc recipient will show up in the header unless a To recipient or CC recipient has been entered.

Note:  	To route your message to others, choose the Add Routing Slip  command from the Message menu.

4.	If desired, you can select the Confirm Read and Confirm Delivery options.  Select Confirm Read if you want the system to return an acknowledgment that the addressee opened the message. Select Confirm Delivery if you want the system to return an acknowledgment that the message reached the addressee's mail server.  Acknowledgments are returned directly to your Mail Inbox folder.

Note:  	This option is applicable only if the receiver of the message is running Z-Mail Pro.

5.	If desired, select the priority type of the message you are sending.  You can select high, normal, or low priority.  Normal priority is the default.  If you assign high priority to your message, then a red exclamation point appears next to your message header in the recipient’s Inbox.  Assigning low priority to your message causes a down arrow to appear next to your message header in the recipient's Inbox.

6.	Type the subject and message text, and if desired, choose an option from the Feelings menu to add a smiling, frowning, or winking symbol in your message.

7.	Choose the Send button to transmit your message to the Outbox. The message is immediately queued in the Outbox for subsequent delivery to the defined destination.


 Deleting Mail

To delete one or more messages:

1.	Select the message(s) you want to delete.

2.	Choose the Trash icon or the Delete command from the Message menu.

The deleted message is automatically transferred to the Trash folder.  All messages remain in the Trash folder until you select Empty Trash from the Services menu or until you exit Z-Mail Pro (depending on your setting in Preferences).

To empty the local Trash folder, choose the Empty Trash from the Services menu.  You can also select the Empty trash on exit option from the Preference dialog box if you want to delete mail in the Trash folder everytime you exit Z-Mail Pro.

Note:	For Remote mailboxes the Trash folder is on the remote server - either on the root directory or under the Inbox.  To empty the remote Trash folder, click the right mouse button and choose the Empty command.


Configuration File

You can save current mail settings to a configuration file (default is USERNAME.CFG) which is loaded when you start the Z-Mail Pro application.  Other files that are created by Z-Mail Pro are dependent on the name of the current user and are kept in the user's mail directory.  For example, if the current user is Steven then mail files residing in Steven's mail directory include:

•	STEVEN.ADB - personal address book

•	STEVEN.FLD - list of folders

•	STEVEN.SGN - signature

•	STEVEN.CFG - personal settings

•	12345678.MG? - individual numbered mail messages

•	STEVEN.DB - database file


Appending Mail Messages to a File

Z-Mail Pro allows you to append the contents of one or more messages to the end of a specified existing file.

While viewing or creating a message, choose the Append to File... command from the Message menu and specify the file you want to append to.  The contents of the message will be appended at the end of the specified file.

Note:	If you select more than one message, the information will be appended in the order in which you selected the messages.


Saving Mail Messages to Files

Z-Mail Pro allows you to save the contents of one or more messages to a new or existing file.

While viewing or creating a message, choose the Save to File... command from the Message menu and specify or select the file to which you want to save the message. The contents of the message will be saved to the specified file.

Note:	If you select more than one message, the information will be saved in the order in which you selected the messages.


Routing Messages

The Routing Slip feature lets you send a message to a predefined route of addresses in the order you specify.  Instead of sending a message to multiple recipients simultaneously, the Routing Slip feature lets you send a message to recipients one after the other. That is, after the message is viewed by a recipient, he or she can choose to send the message to the next recipient on the routing slip.

See Also

Routing a Message to Others

Viewing Routed Messages


Routing a Message to Others

To create and route a message to others, do the following:

1.	From the main mail window, choose the Create or the key combination CTRL+E.  A New Mail window appears.

2.	Choose the Add Routing Slip command from the Message menu.  A New Mail-Routing Slip dialog box appears.

3.	Choose the Add Address button to display the Address Book dialog box that contains your address book(s) and their entries. Then, select or type each entry you want to add as a recipient to your routing slip and choose the To button. Choose the OK button to return to the New Mail-Routing Slip dialog box.  Notice that all mail recipients are listed and numbered in the Route text box.

4.	To modify the order of recipients, select an address and move it using the up or down buttons to the right of the address list.

5.	If desired, select the Return At End, and/or the Allow Modifications options, and choose the OK button.  The name "Routing List"  appears in the address textbox.

The Return At End option sets your address as the last address on the route, thus making the route into a loop.

If desired, you may later edit the route before sending it or deleting it.  Do this by displaying the Routing Slip dialog box or by selecting Routing List in the address text box and choosing the Modify or Delete buttons, respectively.

6.	Finish completing your message and choose the Send command from the Message menu, or choose the Send button to mail the message. The newly sent message is placed in the Routing folder.

7.	The status of the routed message is updated as the message moves along from one recipient to the next.  Whenever the status is updated, the message is marked as unread.   All routed messages are stored by default in the Routing folder.


Viewing Routed Messages

You can view a routed message the same way you view a regular message.  Routed messages are stored in the Inbox folder unless otherwise moved by a previously set rule.

When you view a routed message, a new menu named Routing appears in the menu bar.  This menu has the following three options:

•	Route to Next: Lets you send the message to the next recipient listed in the route and notify the originator of the progress along the route.

•	Information: Lets you display information about the route.  The Routing Information dialog box appears containing a list of addresses (if you are a recipient) or the message status (if you are the originator).

•	Block Route: Lets you stop the message from being routed to any other recipients.  The originator of the message is also automatically notified that the routing has stopped.


Retrieving Message Headers Only
Retrieving Message Headers

The Smart POP feature lets you retrieve message header information only (subject, date, time, sender) without needing to retrieve the entire message or attachments. This feature applies only to Internet protocols.

Note:	The Smart POP feature is considered an advanced Mail option and should be used with caution.

Normally, most users want to retrieve their mail messages in their entirety including attachments.  However there may be circumstances, during serial dialup for example, when you only want to retrieve the message headers only. This is very convenient for users who do not want to retrieve large messages from the server to their own machine when working remotely.  Smart POP also lets you do the following:

•	Retrieve message headers only for very large messages

•	Retrieve message headers only for all messages

•	Retrieve entire messages

•	Apply rules, or any other existing action, to entire messages whose header information you have already retrieved.

•	Do all other existing actions (such as replying or forwarding) on header only retrieved messages

If you want to retrieve header only messages at a later date as entire messages, first change the option on the Smart POP tab to Always retrieve entire message, then choose the Refresh from Host  command from the Message menu.

Note:	When a message belongs to another Z-Mail Pro related application such as Phone Tag or Tag-It!, or is part of a routing slip, then the message is retrieved in its entirety.


Creating and Updating a Draft Message

You can save and store an unfinished mail message and then send it at a later date by using the Save As Draft and Update Draft mail features.

To create a draft message:

1.	Choose the Create... command from the Message menu.  A New Mail message form appears.

2.	Enter the subject, addressee, and message text you normally would when creating a new message.

3.	Save the unfinished message by selecting the Save As Draft option from the Message menu.  The unfinished message is now saved in the Draft folder..

Note:  	The Draft folder always appears at the top of the Folder list, after the Inbox folder, even when it is empty.  You cannot delete the Draft folder.

To update an existing draft message.

1.	Select the Draft folder and then select the draft message you want to update.

2.	Make the desired changes to the message and select the Update Draft option from the Message menu and close the message.

The draft message is now updated and stored in the Draft folder.

To complete and send a draft message, simply select the desired draft message and complete it.  Then send the message by choosing the Send icon on the Toolbar or select the Send option from the Message menu.


Creating and Saving a Template

To create a template:

1.	Choose the Create... command from the Message menu.  A New Mail template appears.

2.	Enter the subject and message text you want to be part of the template. If desired, you can also enter an addressee.  You can create a template without entering a subject, however a template is easier to identify in the Template folder if it contains a subject.

3.	Save the template by selecting the Save As Template option from the Message menu.  The template is now saved in the Template folder.

Note:  	The Template folder always appears at the top of the Folder list even when it is empty.  You cannot delete the Template folder.

To update an existing template:

1.	Select the Template folder and then select the template you want to update.

2.	Make the desired changes to the template and select the Update Template option from the Message menu and close the template.

The template is now updated and stored in the Template folder.

To complete and send a template, simply select the template and add any additional information.   Then send the template by choosing the Send icon on the Toolbar or select the Send option from the Message menu.


Using Attachments

The Z-Mail Pro application allows you to attach one or more physical files or a pointer to a file in a mail message. If you send a pointer to a file, then the recipient can access the file through the FTP client.  However, for the recipient to access the file through the FTP client, the sender’s FTP server must be running on his or her system.

All files can be either binary or ASCII. For example, you can attach a spreadsheet file (binary) to a mail message that you are sending to a list of recipients.

See Also

Sending a File as an Attachment

Viewing and Saving File Attachments

Sending a File Pointer as an Attachment

Receiving File Pointer Attachments


Editing Mail Messages

Z-Mail Pro provides several features that let you edit messages you create.  You can find text, replace text, fill paragraphs, check spelling, or edit HTML formatted text documents directly in Z-Mail Pro for Windows 95 and NT, and in WebSpider for Windows 3.1.


Uuencoding and uudecoding Messages

Uuencode and uudecode allow the mail user to convert binary files from and into ASCII format. Choose the uuencode option to uuencode a binary file before you send it out and the uudecode option to uudecode a message you have received as a specified file on your machine.

Note:	A mail message can have both a file attached to it and a uuencoded file included in its body.

To uuencode a file, do the following:

1.	Create a new mail message.

2.	Choose the Uuencode... command from the Message Menu.

3.	Select or enter the file that you want to uuencode and choose the OK button.  The file will display in ASCII form in the body of your mail message.

4.	Fill out both the To and Subject fields and send your message.

To uudecode a file mailed to you, do the following:

1.	Select the message you want to uudecode.

2.	Choose the View button to display the message.

3.	Choose the uudecode... command from the Message menu.

4.	Select or enter the file to which you want the uudecoded message to be saved. Then, choose the OK button.  The file is now converted into its original binary format.

Note:  	Some mail applications can uudecode only one uuencoded file at a time.  Therefore, you may want to uuencode only one file at a time.


Using Command Line Options

You can use one or any possible combination of the following options to customize your Z-Mail Pro login.  The options are:

•	-u{username} automatically enters the user's Mailbox name.

•	-p{password} automatically enters the user's Mailbox password

•	-offline enables the Offline option

•	-nologo removes the splash screen (large Mailbox with copyright information) upon startup

To set one or more Z-Mail Pro command line options, do the following:

1.	Single-click (highlight) your mail icon.  Z-Mail Pro can be closed or opened.

2.	From the Program Manager, choose the Properties... command from the File menu.  The Program Item Properties dialog box appears.

3.	Enter the option or options at the end of the Command Line text box.

For example, to set up Z-Mail Pro so that your username and password are entered automatically, thus bypassing the login box, enter the -p and -u options as follows:

C:\NETMANAG\MAIL.EXE -UJack -Pmypassword

where Jack is the user's mailbox name and mypassword is the user's mailbox (Jack) password.

Note:  	All options are case insensitive. If you use the -p option your password will appear in the command line text box, thus making mail less secure.


Using the Outbox

Anytime you send a message it first goes to the Outbox and then is delivered to the mail gateway, if defined.  This includes all messages sent using Z-Mail Pro, Tag-It!, Phone Tag, and messages you mail using Forum and meetings you schedule in NEWTCal.

The Outbox attempts to deliver a message as soon as it receives it.  Messages that remain in the Outbox past a specified amount of time expire and Mail messages are returned to the sender as undeliverable.

See also:

Opening the Outbox

Setting Preferences

Using the Messages Menu


Setting Up a New Mail Account for a User (First Time Only)

To set up a mail account for a user for the first time, you need to complete the New User dialog box.

Note:	The same prerequsit applies for using Phone Tag, Tag-It!, Forum, NEWTCal, and In Person.

To set up a mail account for a user for the first time, follow these steps:

1.	Start Z-Mail Pro. The Z-Mail Pro - New User dialog box appears.

2.	Under Local, enter the user's name, user's password (optional), user's name in real life, and local mail directory in the designated fields.

The local mail directory identifies where all configuration files and individual mail messages are saved on your machine.  You may set up a separate mail directory for each user.  For example, the mail directory, c:\netmanag\email\steven, is set up only for user Steven.

Choose the OK button.

3.	Next, the Mail Transport Setup dialog box appears.  You may select any one of the checkbox items:

•	Internet Mail: Indicates that you want the Z-Mail Pro application to be set up for handling standard Internet e-mail. You also need it to specify an outgoing mail gateway for IMAP.

•	IMAP4: Indicates that you want the Z-Mail Pro application to be set up for handling mail on remote servers using the IMAP protocol. If you want to select this option see IMAP overview.

Choose the OK button.

4.	The Network Setting dialog appears, with a tab for each of the Mail transports you selected earlier.  Use the various tabs to set the appropriate information:

•	Internet Mail:  for standard email

•	IMAP

After you have specified these settings, Z-Mail Pro will automatically invoke the appropriate settings when you select the type of mail that you want to create.

Note:	When upgrading from a previous version of Z-Mail Pro, you will not need to create a user account again.  The following message will be displayed the first time Z-Mail Pro is opened after upgrading:  "This version requires a conversion of your current messages into a new format.  This may take a while."  Choose the Continue button to complete the conversion.  Your rules, folders, and messages will remain intact.  You must convert your current messages to use this version of Z-Mail Pro.


Setting Up Mail Accounts for Additional Users
Setting Up Z-Mail Pro Accounts for Additional Users

Once you have set up an account for a new user for the first time, you can set up mail accounts for additional users.  First login as Postmaster and then as User.  The steps are as follows:

Postmaster Login Steps

To log in as Postmaster and set up accounts for additional users, do the following:

1.	Open Z-Mail Pro.  The Z-Mail Pro - Login dialog box appears.  Select Postmaster from the Username drop-down list box and choose the OK button.

2.	The Z-Mail Pro Transports Setup dialog box appears.

•	If you do not want to receive or send mail as a postmaster, for instance you only want to add/modify additional user, choose the cancel button.

•	If you want to send/receive mail as a postmaster, select any of the checkbox items:  Internet Mail or IMAP4 and choose the OK button.  The Network Settings dialog box appears.  Choose the Apply and then OK buttons.

3.	Choose the Mailboxes... command from the Services menu to display the Mailboxes dialog box.

Note:	The Mailboxes... command under the Services menu only appears when you are logged in as Postmaster.  This is the only dialog box in which you can add and delete users and specify a user's mail directory.

4.	Enter the user's name in the User text box and choose the Add... button.  The Enter Information for new user dialog box appears.

5.	Under Local, enter the user's name, user's password, user's name in real life, and local mail directory in the designated fields.

The local mail directory identifies where all configuration files and individual mail messages are saved.  You may set up a separate mail directory for each user.  For example, the mail directory, c:\netmanag\email\steven, is set up only for user Steven.

Choose the OK button.

Logging into Z-Mail Pro as a User

To login into Z-Mail Pro as a user, do the following:

1.	Open Z-Mail Pro.  The Mail - Login dialog box appears.  Enter your previously defined user name and password and choose the OK button.

2.	The Mail Transport Setup dialog box appears.  You may select any one of the checkbox items:

•	Internet Mail: Indicates that you want the Z-Mail Pro application to be set up for handling standard Internet e-mail.

•	IMAP4: Indicates that you want the Z-Mail Pro application to be set up for handling mail on remote servers using the IMAP protocol. If you want to select this option see IMAP overview.

Choose the OK button.

4.	The Network Setting dialog appears, with a tab for each of the Mail transports you selected earlier.  Use the various tabs to set the appropriate information:

•	Internet Mail:  for standard email

•	IMAP

5.	After you have specified these settings, Z-Mail Pro will automatically invoke the appropriate settings when you select the type of mail that you want to create.


Opening the Outbox

You can open and close the Outbox by choosing its icon, or you can choose the Outbox command from the Services menu.


Setting Preferences

Allows you to set the Retry and Return Undelivered Mail times for your Outbox, Default mail gateway, and Log popup window.

•	Retry determines how often messages are sent from the Outbox in terms of days, hours, and minutes.

•	Return Undelivered Mail determines how long messages will stay in the Outbox before they are returned to your Mail Inbox folder.

To set both of these options, enter values in terms of hours, day, and minutes in the appropriate fields.

Default mail gateway routes all mail messages that are transmitted.  Note that the mail gateway specified in Z-Mail Pro supersedes the mail gateway defined in the Outbox.  However, if no mail gateway is specified in Z-Mail Pro, then the mail gateway defaults to the one specified in Outbox.

Normally, the Outbox application attempts to connect to the domain portion of a mail address and transmit the mail to the specified user.  Note that a mail gateway is often used for access to the Internet.  Be sure to specify a mail gateway that is configured to perform as an SMTP relay, because the Z-Mail Pro application does not support SMTP relay functions.

Select the Log window on sending if you want the Log window to appear every time a message is sent.


Using the Messages Menu

The Message Menu in Outbox lets you view, send, abort and delete messages in the Outbox.  Select the desired message and then select the View, Send, Abort, or Delete command.

Pause Sending Messages stops messages in the Outbox from being sent.  This is especially useful if you are using a dialup connection.

For example, before you disconnect you can select this option and the Outbox will not try to send messages.  Then, when you reconnect you can try to send your messages again by deselecting this option.

Use the Check Unmatched Message Files... option from the Message menu when sent messages fail to arrive to the Outbox.  This option places the sent messages into the Outbox list.


Sending a File as an Attachment

To attach a file to a mail message, do the following:

1.	Create a new message.

2.	Choose the New... command from the Attachments menu.

3.	Select or type the name of the file you want to attach to your current message.

4.	Choose the OK button.

5.	The Attachment Description dialog appears, specify the following:

•	Description : Default,  is the current file name, modify if required.

•	File Path: Default is the original file path, modify if required.

•	File Type selection includes text, Message, Application, Audio, Image and Video.  The Subtype field will change according to the defined Type.

•	You may zip or encrypt the file by making a zip or encrypt selection.

6.	Choose the OK button to attach the specified file to your mail message.

The Attachment Description dialog box displays, for your verification, the name and path of your selected file.

Information regarding the attached file such as its type, name and size displays at the bottom of your window above the status bar.

Note:  	To modify the attachment description or delete one or more attachments, select the attachment or attachments, then choose either the Modify... or Delete option from the Attachments menu.  You may also add more than one attachment.

See Also

Zip-n-Encrypt Attachments


Viewing and Saving File Attachments

To view a file attachment of an incoming message, do the following

1.	Select the message that includes the attachment., and click on the file attachment you want to view.

2.	Choose the View command from the Attachments menu.  The attached file appears using the appropriate editor. For example, if the attached file a .BMP file, the file will be opened using Window's Paintbrush application.  Files use the File Manager Association file extensions.

To save a file attachment to a specific location, do the following:

1.	Select the message that includes the attachment, and click on the file attachment you want to save to another location.  You may select multiple attachments.

2.	Choose the Save command from the Attachments menu.  The Save Attachment As dialog box appears.

3.	Select the desired drive, directory, and file type.  Enter the name of the file you want to save the attachment as in the Filename text box.

4.	Choose the OK button.

See Also

Zip-n-Encrypt Attachments


Sending a File Pointer as an Attachment

If desired, you can send a pointer to a file as an attachment rather than the actual file itself.  This way the recipient can simply FTP the actual file to their system.   The appropriate FTP Server must be running for the recipient to access the file through the FTP Client.

To do this:

1.	Create a new message.

2.	Choose the New... command from the Attachments menu.

3.	Select or type the name of the file you want to send as a pointer with your current message.

4.	Choose the OK button.

5.	The Attachment Description dialog appears, specify the following:

•	Description : Default,  is the current file name, modify if required.

•	File Path: Default is the original file path, modify if required.

•	File Type: Select Message.

•	Subtype:  Select external-body option.

You must choose both these options for File Type and Subtype in order to send the file pointer.

6.	Choose the OK button to attach the specified file to your mail message.

Information regarding the attached file such as its type, name and size displays at the bottom of your window above the status bar.

Note:  	To modify the attachment description or delete one or more attachments, select the attachment or attachments, then choose either the Modify... or Delete option from the Attachments menu.


Receiving File Pointer Attachments

To view file pointer attachment, do the following

1.	Select the message that includes the attachment.

2.	Double Click the attachment at the bottom of your mail window. A message appears that says the attachment is a pointer to the actual document and the message also displays the filename and path.  Choose the OK button to close the message.

3.	Select the FTP client application to access the file.


Using MAPI-Enabled Applications

The Z-Mail Pro application supports MAPI-enabled (Messaging Application Programming Interface) applications.  This means that all MAPI-enabled applications, such as Word, Excel, or WinZip,  can use NetManage's Z-Mail Pro application to transport messages and files.

The current implementation of MAPI32.DLL/MAPI.DLL is a subset of the API defined by Microsoft. More details can be found in NetManage's SDK documentation. A special entry point is provided, depending upon the MAPI-enabled application you are using, to enter the NetManage Z-Mail Pro client.  For example, there may be a Send Mail command under the File menu of a MAPI-enable application that invokes Z-Mail Pro when you choose it.

To install Chameleon's MAPI support, do the following:

1.	If you have MAPI32.DLL/MAPI.DLL in your Windows system32/system directory, rename it to MAPI.OLD.

2.	Copy MAPI32.DLL/MAPI.DLL from your NetManage directory into your Windows system32/system directory.

3.	Make sure WIN.INI in your Windows directory contains the following lines:

      [MAIL]

      MAPI = 1

4.	Restart Windows.  Your applications should now be MAPI-enabled.

Note:	Installing NetManage's MAPI32.DLL/MAPI.DLL will disable Microsoft Mail systems.


Finding Text

You can find a particular word, part of a word or any combination of characters in the mail message body.  To do this:

1.	With the cursor in the body of the mail message, choose the Find... command from the Edit menu.  The Find dialog box appears.

2.	Type the word or text characters you want to find in the Find what field.

3.	Select the option you want to control your search:

•	Match Whole Word Only:  Find the specified text as a whole word only.

•	Match Case:  Find the specified text as having the same case as the text in the Find what field.  For example, if you search for "What" you will not find "what."

•	Up:  Search the text above the cursor.

•	Down:  Search the text below the cursor.

4.	Choose the Find Next button to begin or continue the search.

5.	Choose the Cancel button when you have finished your search.


Replacing Text

You can replace text in your mail message by using the Replace option.  To do this:

1.	With the cursor in the body of the mail message you are creating, choose the Replace... command from the Edit menu.  The Replace dialog box appears.

2.	Enter the text you want replaced in the Find what field.

3.	Enter the text you want to replace it with in the Replace with field.

4.	Select the option you want to control your search:

•	Match Whole Word Only:  Find the specified text as a whole word only.

•	Match Case:  Find the specified text as having the same case as the text in the Find what field.  For example, if you search for "What" you will not find "what."

5.	Choose the Find Next button to find an occurrence.

6.	To replace the text, choose the Replace button.  To leave the text unchanged and continue the search, choose the Find Next button.

7.	To change all occurrences of the text for which you are searching without confirming, choose the Replace All button.

8.	When you are finished searching and replacing, choose the Cancel button.


Filling Paragraphs

You can close any gaps in the text of a mail message you are creating by selecting a section of text you want to close and selecting the Fill Paragraph option from the Tools menu.


Sorting the Date, From, and Subject Fields
Sorting the Date, From, Subject and Status Fields

You can sort by the Date, From and Subject fields  while viewing the contents of a folder

1.	Select the folder containing the messages you want to sort.

2.	Double-click in the field above the column of :

•	Date: sorted by either the date the message was sent or received.

•	From: sorted alphabetically to allow you to view all messages sent from a particular sender.

•	Subject:  sorted alphabetically to allow you to group messages sent about the same topic.

•	Message icons:  sorted by Status

Message Priority:  All messages in the folder are sorted in order of High, Normal, and Low priority.

Message State:  Select this option to sort your messages in order by the following states:  marked, header only, unread, and read.

Message Type:  Select this option to sort your messages in order of text messages only and then messages with attachments.

The arrow to the right of the Subject field determines how messages in each field are sorted:

•	If the arrow is pointing up:  Sorts messages in the Date field from most recent to oldest date.   Sorts messages in the From and Subject fields alphabetically from Z to A.

•	If the arrow is pointing down:  Sorts messages in the Date field from oldest to most recent date.  Sorts messages in the From and Subject fields alphabetically from A to Z.

To sort by any of the above fields, double click on the arrow to determine how the messages will be sorted for a particular field, then double click on the desired field.


Display Information

The Display Information command allows you to choose how information is displayed.  You can have the number of unread messages and total number of messages in a folders displayed or hidden along with folder names.  (Default folder names are always displayed).

Under Messages, you can choose to have the information in the Status, Date, From and Subject fields sorted by ascending or descending order.


Format

Note:	 The commands in the Format menu are only enabled when editing in HTML mode on a Windows NT or Windows  95 system.

Font Style...

Paragraph Style...

Document Colors...

Background Image...

List...

Increase List Indent

Decrease List Indent


Table

Note:	The commands in the Format menu are only enabled when editing in HTML mode on a Windows NT or Windows 95 system.

Insert Table...

Insert Row...

Insert Column...

Insert Cell...

Merge Cells

Split Cells

Table Properties...

Row Properties...

Column Properties...

Cell Properties...

Delete Row

Delete Column

Delete Cell

Gridlines


Character Styles
Font Style...

Applies different style options to the selected or upcoming characters.  The options are:

•	Bold

•	Italic

•	Underline

•	Fixed Font

Fixed Font indicates that the text should be displayed using monospace (fixed size) font. The font is browser dependent.  The common implementation is Courier.

•	Size

The default font size is set per paragraph style.  For example, the default font size for the smallest heading (the H6 tag) is -2 and for the largest heading (the H1 tag) it is +3. You can select a new font size from the drop-down list.

The relative sizes relate to an absolute value of zero which is the Normal Style Font size.  If Normal is defined as Times Roman 10 font, then defining a style as +3 makes it 3 font sizes larger than 10.

•	Color

This option lets you set the color of the characters (either selected or upcoming). The default is black. You can change colors by selecting one of the options in the drop-down list.

The color can also be set by selecting the paintbrush icon on the toolbar. Note that the brush changes to the color of the current font.

To apply a font style:

1.	Select the text or put the cursor before the position of the upcoming text to which you want to apply.

2.	Choose Font Style... from the Format menu on the main toolbar or from the drop-down menu that appears when you click on the right mouse button.

3.	Set the required style.

4.	Choose the OK button.

To revert back to the defaults, choose the Defaults button.

Note:	To apply or remove a character style, you may also select the associated button from the toolbar. If you are changing  the font color using the button on the toolbar, the Color dialog box will be displayed.  Select the desired color or define a custom color.

See Also

Keyboard Shortcuts


Paragraph Styles
Paragraph Style...

Applies a predefined HTML style to the paragraph containing the cursor and lets you select the paragraph alignment.

The following styles are available:

•	Heading 1 (H1) to Heading 6 (H6)

Defines heading text in different font sizes.  H1 is the largest font.  The common implementation is Bold.  Each of these styles becomes progressively smaller, but still Bold.  For H6, the common implementation is smaller than the Normal font.

•	Pre-Formatted (PRE)

Defines that the current paragraph should be displayed in a fixed font, and that no browser adjustments should be performed on this text.

For example, browsers usually eliminate white space such as double spaces and tabs.  In a pre-formatted paragraph, no adjustments are performed.  The common implementation uses the Courier font.  This style is often used with tabs to create simple tables.

•	Address

Defines that the current paragraph should be displayed as an address.  The common browser implementation is Italic.  This style is often used for e-mail addresses.

•	Normal

Defines that the current paragraph should be displayed as a regular paragraph, with no styles applied.

To apply a style to a paragraph:

1.	Place the cursor in the paragraph you wish to format.

Choose Paragraph Style from the Format menu on the main toolbar or from the drop-down menu that appears when you click on the right mouse button. Select the required style from the list.

or

Choose the associated paragraph style button from the toolbar. In this case there is no need to open the Format menu.

3.   Choose the OK button.

Paragraphs can be aligned to the left and center.  They can also be left indented.  This means a paragraph can be aligned left and left indented or aligned center and left indented. (The left indentation is determined by a separate HTML tag, BLOCKQUOTE, while the paragraph alignment is just an attribute.) To change the paragraph alignment, choose the associated button from the toolbar or select one of the options on the Paragraph Style dialog box.

To change the paragraph alignment, choose the associated button from the toolbar or select one of the options on the Paragraph Style dialog box.

To revert back to the defaults, choose the Defaults button.

See Also

Keyboard Shortcuts


Keyboard Shortcuts

Paragraph and font styles can also be set using the following keyboard shortcuts.

Key Combinations	Shortcut for
Ctrl-Alt-1	Heading 1
Ctrl-Alt-2	Heading 2
Ctrl-Alt-3	Heading 3
Ctrl-Alt-4	Heading 4
Ctrl-Alt-5	Heading 5
Ctrl-Alt-6	Heading 6
Ctrl-Shift-N	Normal
Ctrl-Shift-P	Pre
Ctrl-B	Bold
Ctrl-I	Italic
Ctrl-U	Underline


Document Colors
Document Colors...

Applies colors to the working document and links within the document.  To set the background and text colors, select an option from the drop-down list.  By default the background is white and the text is black.

You can also set the color for links.  The default colors are set when you enter HTML mode.  To change the defaults,  select an option from the drop-down list.

Note:	If your Mail settings contain non-default background and text colors, these colors will be passed to the HTML editor rather than the defaults.

After you have made your selections, choose the OK button. If you do not like the colors you selected, choose the Defaults button.  This changes all the colors back to the default.

Note:	Choosing the Defaults button changes all colors back to their default.  You cannot change just one of the colors.  To change only one color back to its default, select Default from the specific drop-down list.


Background Image
Background Image...

Changes the background from white to an image of your choice. The background image can be of any displayable format: gif, jpg, bmp.  If you choose an undisplayable format,  the background remains white.

To change the background image:

1.	Choose Background Image... from the Format menu.

2.	Enter the location (full path name) of the image you want to insert or choose the Browse button to browse your network drives and select a graphic file.

3.	Choose the OK button.  The image you selected is now the background image.

To delete a background image:

1.	Choose Background Image...from the Format menu.

2.	Choose the Clear button.

3.	Choose the OK button.  The background image reverts back to white.


List...

Creates a numbered or bulleted list.  This command can be selected either before starting a list or after you have entered the data.

To create a list:

1.	Select a number of paragraphs to format or place the cursor inside the paragraph you want to start the list.  Each paragraph is formatted into a list item.

2.	Choose the List... command from the Format menu or use the associated button for numbered or bulleted list in the toolbar.

3.	If you choose List..., select the list style, numbered or bulleted.

4.	Choose the OK button.

To cancel an existing list select the None option on the List Style dialog.

To indent the list or create a sublist, see Increase List Indent.

See Also:

Decrease List Indent


Increase List Indent

Creates a nested list by moving the selected list items to the right by one level.

To indent an item:

1.	Place the cursor in a list item or select the list items.

2.	Choose the Increase List Indent command from the Format menu or the associated button in the toolbar.

Note:	This command is available only when the cursor is positioned in a list.


Decrease List Indent

Moves the selected list item(s) back (to the left) one level.  If used a list item that is at the first level, this list item changes to a regular paragraph.

To decrease the indentation of an item:

1.	Place the cursor inside a list item or select the list items.

2.	Choose the Decrease List Indent command from the Format menu or the associated button in the toolbar.

Note:	This command is available only when the cursor is positioned in a List.


Background

Select the Background command from the View menu to show or hide the background image or color. The default is to show the background image or color.

Note:	Hiding the background in a message/news article is for your convenience. The message/news article is sent with the background image or color visible to the recipient.


Targets

Select the Targets command from the View menu to show or hide targets in the document. If you show targets, they are highlighted in the text. The default is to highlight targets.


Import HTML....
Import...

Imports a file into the current mail message/news article.  If you open a text file, it will be imported as text. If you open an HTML file it will be imported as HTML.

After importing the file, you can edit it as you would any other message/article.  All links in the imported file remain active unless you remove them using the Remove Link option.

To import a file:

1.	Select the Import... command from the File menu.  You will be warned that this action replaces the existing message/article contents. Choose the OK button to continue. The Import dialog box will appear.

2.	Select the file type you want to import - Text or HTML.

3.	Select the drive and directory where the file is located.

4.	Select the required file and choose the OK button.

Note:	 When you import a text file, the imported file receives the Normal paragraph style as the default.


Text Mode

Creates a mail message in the standard text format.

Note:	 If you select this option after working in HTML mode, all HTML tags are lost.


 HTML Mode

Creates a mail message/news article in standard HTML format.  The HTML tags, and formatting styles supported by Z-Mail Pro become available. You can also create images, links and targets as you would in any HTML editor.

You can switch from Text Mode to HTML mode while creating or editing a message/article.  In this case, the HTML options can be applied to the entire message.

In Windows 95 and Windows NT, HTML Mode is the default mode.

Note:	When converting from text to HTML mode, the text is converted to Pre-Formatted paragraphs.

See Also

Editing HTML Documents in Windows 95 and Windows NT


Image Properties...
Image Properties

Allows you to change the file or attributes of an image in the current document.

To edit an inline image:

1.	Select the image (either by double-clicking it or dragging the mouse over it) or place the cursor before or after the image you want to edit.

2.	Choose Image  from the Edit menu.  The Properties submenu will appear.

3.	Select the Properties command.

4.	The Inline Image dialog box appears. Change text as needed.  See Image for detailed information on the options.

Note:	The Image command is enabled in the Edit menu only if you have selected an image in the message/article.


Link Properties...
Link

Allows you to edit or remove the link in which the cursor is placed by selecting either the Properties or Remove submenus.

Note:	The Link command is enabled in the Edit menu only if you have selected a link in the message/article or the cursor is positioned within a link.


Link Properties

To edit a link:

1.	Place the cursor inside the link you want to edit.

2.	Choose Link Properties... from the Edit menu.

3.	The Link dialog box appears, displaying the current URL.  Modify the components as needed. See Link for detailed information on the options.


Remove Link

Removes the HTML tags that created the selected link.

To remove a link:

1.	Place the cursor in the text marked as a link.

2.	Choose Link Remove from the Edit menu.


Target Properties...
Target

Allows you to change or remove the target name by selecting either the Properties or Remove submenus

Note:	TheTarget command is enabled in the Edit menu only if  you have selected a target in the message/news article.


Target Properties

To edit the target:

1.	Place the cursor in the target you want to modify.

2.	Choose the Target Properties... command from the Edit menu. The Target dialog box displays the current target name.

3.	Enter the new target name.

4.	Choose the OK button.


Remove Target

Removes the target tags from the text of the selected target.

To remove a target:

1.	Place the cursor in the text marked as a target.

2.	Choose the Target Remove command from the Edit menu.


Include Images

Select this command for all images in your HTML document to be sent (as attachments) with the message/article.  When the message/article is delivered and viewed, the images will appear in the HTML document.

The default is to include the images.

The Include Images command is a toggle. When checked it includes the images with the document.  When unchecked, it does not.


Include Text Version

Determines the content-type (see header) of the message/article to be sent.

To send a message/article of content-type multipart/alternative, select the Include Text Version command in the Message/Article menu. Sending a multipart/alternative message increases the file size as the file is sent with both a text portion and an HTML portion. However, it also guarantees that the message can be viewed by all systems whether or not they support HTML viewing.

To send a content-type text/html type message/article, deselect the Include Text Version command in the Message/Article menu.


Horizontal Line

Inserts a horizontal line (the HR tag) within the text.  The horizontal line will appear in a separate line.

To insert a horizontal line:

1.	Place the cursor where you want the line to be inserted.

2.	Choose Horizontal Line from the Insert menu.


Line Break

Inserts a line break (the BR tag) at the cursor position.

To insert a line break:

1.	Place the cursor where you want the line break to be inserted.

2.	Choose Line Break from the Insert menu.


Nonbreaking Spaces
Nonbreaking Space

Inserts a nonbreaking space between words. Words separated by a nonbreaking space will not be split across two lines by the browser. When using HTML tags, except PRE, this is the only way to create more than a single space between words.

To insert a nonbreaking space:

1.	Place the cursor where you want the space to be inserted.

2.	Choose NonBreaking Space from the Insert menu.


Image...

Inserts a picture into the document as an inline image at the current cursor position, and allows you to set the image's attributes.  Various graphic formats are supported, but it is advised to use the GIF format for maximum browser compatibility.  If your graphics are of a format other than the GIF format, use NEWTView to convert them to the GIF format.

To insert a picture into your document:

1.	Position the cursor where you want the picture to be inserted.

2.	Choose the Image command from the Insert menu, or choose the Image button in the toolbar. The Inline Image dialog box appears.

3.	To specify the location of the image file fill in the following fields:

•	Protocol - Select the communication protocol required to access the image: HTTP, FILE or None.

•	If the image file is located in the same directory as your HTML file or in a directory relative to your current directory, select None for Protocol, and do not fill in the Host and Port fields.

Note:  	To view Images that use the None Protocol, in the server environment, the image files must be placed on the server while preserving the relative directory structure.

•	Host - Enter the name of the host where the destination file resides. This is the server that the protocol you have selected connects with to retrieve the image.  If Protocol is set to None, this field should be left blank.

•	Port - The port displayed is the standard port used by the chosen protocol.  If Protocol is set to None, this field should be left blank.

•	Path and File Name - Enter the destination file name, including the directory path.

•	Choose the Browse button to browse your network drives and select a graphic file.  After choosing the OK button, the Image information is updated with the location of the selected file. The same information is automatically added to the Internet address field.

•	You may also directly type the graphic file’s name and relative path into the Path and File Name field (for example, dir2\dir3\image.gif).

•	For image files that reside on another computer, use the HTTP protocol (the FILE protocol is also available, if necessary).

Note:  	When inserting an image using the HTTP protocol, it will be displayed as a mona-lisa.  This is because the editor does not connect dynamically to the server (as is does to the viewer).

4.	Set the image alignment, height and width (if you are satisfied with the original image dimensions, leave the corresponding fields blank).

5.	Select the Image Map box if the image file contains more than one link.

Image maps are defined in a coordination and definition file that resides on the HTTP Server.  For your image map to work in the server environment, you should surround the Inline Image with a link that points to the Image Map definition file on the server.

6.	Choose the OK button.


Link...

Creates a hyperlink (jump) from the selected text to another specified document or Internet resource. The hyperlink (also referred to as link and URL) is used as a  reference to any resource on the Internet.  When a link appears in the document, the Web browser or the inline HTML viewer uses the link to go directly to that resource, using the protocol selected when creating the link.

To create a link:

1.	Either select the text you want to be a link to the destination document or enter the text that you want to become the link text in the Text filed of the Link dialog box..

2.	Choose Link... from the Insert menu or choose the associated button from the toolbar.

In the Link dialog box that appears, specify the appropriate URL components for the type of link that you are creating:

For internal links (within the same document), specify only the target.

For links that point to a file on another computer, see external links for further details about the URL components.

Text - Contains the text you have selected as the link text. If you have not selected any text, you can enter the desired link text into the Text field when the dialog appears. If no text is entered or selected, the HTML editor will create its own link text using the address supplied in the Internet address field.

Protocol - Select the communication protocol required to access the host for the requested data from the following list:

•	HTTP

•	GOPHER

•	FTP

•	FILE

•	TELNET

•	TN3270

•	TN5250

•	MAILTO

•	NEWS

Host - Enter the name of the destination host.

Port - The port displayed is the standard port used by the selected protocol.

Path and File Name - Enter the destination filename, including the directory path if necessary.

Use the Browse button to browse your network drives and select a file.  After choosing the OK button, the link information is updated with the location of the selected file.

You may also directly type the file name and relative path into the Path and File Name field.

Target - Optional, by default the link transfers to the beginning of a document.  With the HTTP and FILE protocols, it is possible to link to a specified point inside a document if it has been defined as a target. Enter the target name you want to link to.  Use this option to link to a different point within the same document.

User Name - Enter the appropriate username for protocols that require a username for connection.

Password - Enter the appropriate password for protocols that require a password for connection.

Internet Address - The information that you entered in the Path and file name field automatically appears in this field.

You can enter the string, if known, directly into this field, eliminating the need to fill in all the options of Link Information (that is, the URL components).

Note:  	It is recommended that you enter the details into each of the Link Information fields.  This information is used to create a valid URL, which is displayed in the Target file location field.  Advanced users or users who know the exact URL they wish to link to may enter the information directly in the Target file location field.

Test Link - Choose this button to test the validity of the link you have just created. The default Web browser will be launched to perform the test.

3.	Choose the OK button. The style of the selected text changes to reflect the existence of a link.

This command is available only when you select text that is not already a link.


Target
Target...

Creates a target in the selected location for a link to jump to.

To create a target:

1.	Select the text for the target.

2.	Choose Target... from the Insert menu. The Target dialog box appears.

3.	Enter the name you want to use to define this target.

4.	Choose the OK button.

This command is available only when you select text that is not currently defined as a target.


Insert Table
Insert Table...

Inserts a table with the number of rows and columns you specify. You can also specify the alignment and border colors. To create a table:

1.	Position the cursor at the point in the text where you want the table to appear.

2.	Choose the Insert Table command from the Table menu or choose the associated toolbar button. The Insert Table dialog appears.

3.	Fill in the data under  the three tabs, as necessary (you can use the defaults): General, Format, and Colors that let you design the table layout.

Note:	Fill in the data under each tab before choosing the OK button.


General Tab

This tab of the Insert Table and Table Properties dialog lets you specify the number of rows and columns in your table as well as the table title and position.

Number of Columns	Type or select the number of columns in the table.
Number of Rows	Type or select the number of rows in the table.
Title	Type the text you want as the caption of the table.  Note: This field is only editable when creating a new table or if the current table has no title.  However, once you have entered the initial title, you can edit it as you would any other part of the message/news article.
Title position	Select either Top or Bottom, depending where you want the title to appear.
When you have completed the data on this tab, select one of the other two tabs. Do not choose the OK button until you have entered data under all three tab sections.

See Also

Format Tab

Colors Tab

Table Properties


Format Tab

This tab of the Insert Table and Table Properties dialog lets you specify the table alignment and spacing.

Alignment	Select how you want to align the table within your message/article: left, right or center.
Cell Spacing	Select the amount of space inserted between individual cells in a table. By default, the HTML editor uses a cell spacing of 2. This option only applies when the Border option is selected.
Cell Padding	Select the amount of space between the border of the cell and its contents. By default, the HTML editor uses a cell spacing of 1. Setting a cell padding of 0 will cause the text to touch the cell borders and is therefore, not recommended.
Border	Indicates whether or not to put a visible border around your table. If this option is not selected, the table will appear as a columned list. The Gridlines command only toggles correctly if this option is not selected.
Set width to	Enter the width of the table either as a percentage of the document width or as an absolute width in pixels.
When you have completed the data on this tab, select one of the other two tabs. Do not choose the OK button until you have entered data under all three tab sections.

See Also

General Tab

Colors Tab

Table Properties


Colors Tab

This tab dialog lets you specify the background color and the border color.

Background	Select the background color of the table. By default, this is white. Any of the predefined color names in the drop-down list can be used.
Border Color	Select the border color of the table. By default, this is white. Any of the predefined color names in the drop-down list can be used. For this option to work you must select the Border option on the Format tab.
Border Light	Select a lighter version of the border color to provide shading around the table. Any of the predefined color names in the drop-down list can be used. For this option to work you must select the Border option on the Format tab.
Border Dark	Select a darker version of the border color to provide  the table. Any of the predefined color names in the drop-down list can be used. For this option to work you must select the Border option on the Format tab.
When you have completed the data on this tab and the other two tabs, choose the OK button. Do not choose the OK button until you have entered data under all three tab sections, as necessary.

See Also

General Tab

Format Tab

Table Properties

Column Properties

Row Properties

Cell Properties


Insert Row
Insert Row...

Inserts rows above the selected row.

To insert rows:

1.	Select the row above which the new row should be inserted.

2.	Choose the Insert Row command from the Table menu.  The Add Rows dialog appears. Enter or select the number of rows you want to insert. The default is 1.

3.	Choose the OK button.

See Also

Insert Cell

Insert Column


Insert Column
Insert Column...

Inserts columns to the right of the selected columns.

To insert columns:

1.	Select the column that you want to insert a column to the right of.

2.	Choose the Insert Column command from the Table menu.  The Add Columns dialog appears. Enter or select the number of columns you want to insert. The default is 1.

3.	Choose the OK button.

See Also

Insert Row

Insert Cell


Insert Cell
Insert Cell...

Inserts the number of cells that you select.

To insert cells:

1.	Select the cell you want to insert cells to the right of.

2.	Choose the Insert Cell command from the Table menu.  The Add Cells Properties dialog appears. Enter or select the number of cells you want to insert. The default is 1.

3.	Choose the OK button.

See Also

Insert Row

Insert Column


Delete Cell

Deletes the selected cells or the cell where the cursor is located.

To delete cells:

1.	Select the number of cells you want to delete.

2.	Choose the Delete Cell command from the Table menu on the main menu bar or from the drop-down menu that appears when you click on the right mouse button.   The selected cell(s) is deleted.

See Also

Delete Row

Delete Column


Delete Rows
Delete Row

Deletes the selected rows.

To delete rows:

1.	Select the number of rows you want to delete.

2.	Choose the Delete Row command from the Table menu on the main menu bar or from the drop-down menu that appears when you click on the right mouse button.  The selected row(s) is deleted.

See Also

Delete Cell

Delete Column


Delete Columns
Delete Column

Deletes the selected columns.

To delete columns:

1.	Select the number of columns you want to delete.

2.	Choose the Delete Column command from the Table menu on the main menu bar or from the drop-down menu that appears when you click on the right mouse button. The selected column(s) is deleted.

See Also

Delete Row

Delete Column


Merge Cells

Combines the contents of adjacent cells into a single cell. You can only merge cells horizontally.

To merge cells:

1.	Select the cells you want to merge.

2.	Choose the Merge Cells command from the Table menu on the main menu bar or from the drop-down menu that appears when you click on the right mouse button.

Note:	This command is only available when you select two or more cells in a row.


Split Cells

Splits cells either into rows or columns.

To split cells:

1.	Select the cells you want to split.

2.	Choose the Split Cells command from the Table menu on the main menu bar or from the drop-down menu that appears when you click on the right mouse button. The Split Cells dialog appears.

3.	Select either the Split into Rows or Split into Columns option.

4.	Enter or select the number of rows or columns you want to split the cells into.

5.	Choose the OK button.


Table Properties
Table Properties...

Use this command to edit an existing table:

1.	Place the cursor inside the table you want to edit.

2.	Choose Table Properties command from the Table menu on the main menu bar or from the drop-down menu that appears when you click on the right mouse button.  The Table Properties dialog appears. This dialog is the same as the Insert Properties dialog.

3.	Change the fields as desired. For a detailed explanation of each of the fields see, General Tab, Format Tab, and Colors Tab.


Row Properties
Row Properties...

This command lets you change the alignment, width and color of the columns in a table.  To edit the row properties:

1.	Place the cursor inside the row you want to edit.

2.	Choose Row Properties command from the Table menu on the main menu bar or from the drop-down menu that appears when you click on the right mouse button .  The Row Properties dialog appears.

3.	Change the fields under the Format Tab and the Colors Tab, as desired. Choose the OK button only after you have edited data under both tabs (if necessary).

See Also

Format Tab

Colors Tab


Column Properties
Column Properties...

This command lets you change the alignment, width and color of the columns in a table.  To edit the column properties:

1.	Place the cursor inside the column you want to edit.

2.	Choose Column Properties command from the Table menu on the main menu bar or from the drop-down menu that appears when you click on the right mouse button .  The Column Properties dialog appears.

3.	Change the fields under the Format Tab and the Colors Tab, as desired. Choose the OK button only after you have edited data under both tabs (if necessary).

See Also

Format Tab

Colors Tab


Format Tab

The Format Tab lets you change the column, row or cell alignment and width. You can also indicate that a particular cell will be a header cell.  The fields on this dialog tab are:

Horizontal Alignment	Select the horizontal alignment of the column contents: left, right or center.
Vertical Alignment	Select the vertical alignment of the column contents: top, middle or bottom.

Note:	The alignment value determines the placing of the text within the column, row or cell. For example, if you set a Center Horizontal and a Bottom Vertical alignment for a particular cell, the text will be entered in the center on the bottom line.

Header Cell	Select this option if the cell is a header.
No text wrapping	Select this option if you do not want the text in the cells to automatically wrap.
Set width to	Enter the width of the column either as a percentage of the table width or as an absolute width in pixels.
See Also

Column Properties

Row Properties

Cell Properties


Cell Properties
Cell Properties...

This command lets you change the alignment, width and color of the cells in a table.  To edit the cell properties:

1.	Place the cursor inside the cell you want to edit.

2.	Choose Cell Properties command from the Table menu on the main menu bar or from the drop-down menu that appears when you click on the right mouse button .  The Cell Properties dialog appears. The options are the same as those on the Column Properties dialog.

3.	Change the fields under the Format Tab and the Colors Tab, as desired. Choose the OK button only after you have edited data under both tabs (if necessary).

For a detailed explanation of the options, see Format Tab and Colors Tab


Gridlines

Displays or hides the dotted lines that appear on the screen between cells in a table. The toggle takes effect only if the Table Border option on the Table Properties dialog is turned off (not selected).


Viewing and Editing HTML Documents

Z-Mail Pro provides the ability to view an HTML formatted document in standard HTML format when it is part of the message body, included as an attachment, or referenced as a URL pathname within a message.

You can also edit an HTML formatted document in standard HTML format when it is part of the message body or referenced as a URL pathname within a message.

For more detailed information:

See Also

Viewing an HTML Document

Editing HTML Documents in Windows 95 and Windows NT

Editing HTML Documents in Windows 3.1


Viewing an HTML Document

You can easily view an HTML document, or directly link to its web page without having to use a Web browser.  To view an HTML document when it is part of the message/article body or as an attachment, do the following:

To set the Default for viewing messages/articles in HTML format:

1.	Under Preferences (Settings menu), Edit/View tab, select the View in HTML (WEB) checkbox and choose the OK button.

2.	Select the message/article that contains the HTML formatted document.

Or, to view a single message/article in HTML format:

1.	Select the message/article that contains the HTML formatted document.

2.	Choose the In HTML command from the View menu.

The HTML formatted document appears in standard HTML format.  You can view this document and any of its jumpers or links as you would if using a Web browser.

Note:  	An HTML message/article will be viewed in HTML mode even if  the preference is set to Text Viewing.

To view an HTML document when it is referenced as a URL pathname within a message, do the following:

1.	View the message that contains the URL pathname reference. By default, the message is displayed in HTML mode.

2.	Single click the highlighted URL pathname to directly link to its web page.  You can view the web page in Z-Mail Pro and Forum.

Note:	To view the link destinations in your default Web browser, select Navigate Using Browser from the View/Article menu in the View window. Then open the message.

See Also

Editing HTML Documents in Windows 3.1

Editing HTML Documents in Windows 95 and Windows NT


Editing an HTML Document In Windows 3.1

You can edit or create an HTML formatted document by sending it directly to WebSpider, NetManage’s Web authoring tool.  After editing in WebSpider, you can send it as a mail message/news article to another user.  To do this:

1.	Under Preferences (Settings menu), Edit/View tab, select the Edit in HTML checkbox.

2.	Z-Mail Pro: Select Create, Reply or Forward command from the Message menu.

Forum: Select Post, Reply or Forward from the Articles menu or the associated toolbar button.

3.	Confirm the prompt asking if you wish to use the HTML editor.

4.	WebSpider is automatically launched. Write and format your message/article in the WebSpider window.

Note:  	In WebSpider images are inserted using the Inline image command. Set the protocol to none to send the image with the message.  If the protocol is set to File the image will not be sent with the message.

5.	When you have finished the article choose the WebSpider Send button, or Send as Mail from the services menu.

6.	The HTML document is placed in the New Message/Article window.  Send or post the article in the normal way.

See Also

Editing HTML Documents in Windows 95 and Windows NT

Viewing an HTML Document


Editing HTML Documents in Windows 95 and Windows NT

You can create or edit an HTML document and create links to its web page as part of your mail message or news article, without having to use a Web browser. This inline feature lets you create or edit a document using the HTML tags and formatting features, without the time needed to link to and display images through a browser. While editing you can also create and manipulate tables.

To edit or create an HTML document when it is part of the message body do the following:

1.	Under Preferences (Settings menu), Edit/View tab, select the Edit in HTML(WEB) checkbox and choose the OK button.

2.	In Z-Mail Pro, select the Create, Reply or Forward command from Message menu or the associated button from the toolbar.  In Forum, select the Post, Reply or Forward command from the Articles menu or the associated toolbar button.

3.	Edit the HTML document as desired. If you followed steps 1 and 2, you are automatically in HTML mode (the HTML Mode command in the Edit menu is selected).

See Also

Format Menu

Insert Menu

File Menu

Edit Menu

Viewing an HTML Document


In HTML

Lets you view a single message/article in HTML format.  Viewing in HTML is the default.

To view a single message/article in HTML format:

1.	Select the message/article that contains the HTML formatted document.

2.	Choose the In HTML command from the View menu.

The HTML formatted document appears in standard HTML format.  You can view this document and any of its jumpers or links as you would if using a Web browser.

Note:  	An HTML message/article will be viewed in HTML mode even if  the preference is set to Text Viewing.

To view all messages/articles in HTML mode:

Select the View in HTML(Web) checkbox under Preferences (Settings menu), Edit/View tab, and choose the OK button.

See Also

In Text

Viewing an HTML Document


In Text

Lets you view a single message/article in standard text format.

Note:  	An HTML message/article will be viewed in HTML mode even if  the preference is set to Text Viewing.  If the message/article has been sent as type text/html, selecting In Text will display the HTML source. However, if the message/article has been sent as a multipart/alternative message/article, you will see the text portion of the message/article.

See Also

In HTML


Internal Links

Internal links point to a location in the current file. For internal links, the targeted location must first be defined as a target.  This Target Name should be specified in the Target name field of the Link Information dialog box.  The Protocol should be set to None and the Host, Port, Path and File Name fields should be blank.


External Links

External links point to a file on another computer. These links can also access other Internet resources such as Gopher, FTP, and News.  The user specifies which host to access, and which protocol to use to communicate with that host.

The guidelines for creating external links using various types of protocols are:

•	To point to an HTML file on an HTTP host:

Protocol: Select HTTP.

Host: Enter the HTTP host address, such as www.netmanage.com.

Port: Change the default port only if you know a different port to access.

Path and File Name: Specify the path and file name you wish to access, such as netmanag\nm3.html.

Target: If desired, fill in a specific target located in the file specified in the Path and File Name field.

•	To access a file on an FTP host:

Protocol: Select FTP.

Host: Enter the FTP host address, such as ftp.netmanage.com.

Port: Change the default port only if you know a different port to access.

Path and File Name: Specify the path and file name you wish to access.

User Name: Enter the user name.

Password: Enter the user’s password.

•	To access a file using the FILE protocol:

Protocol: Select FILE.

Host: Enter the server address.

Port: Change the default port only if you know a different port to access.

Path and File Name: Specify the path and file name you wish to access.

•	To access a file on a Gopher host:

Protocol: Select GOPHER.

Host: Enter the Gopher host address.

Port: Change the default port only if you know a different port to access.

Path and File Name: Specify the index you wish to access.

•	To start a Telnet session to access a file on a Gopher host:

Protocol: Select TELNET.

Host: Enter the host address.

User Name: Enter the user name.

Password: Enter the user’s password.

•	To send an e-mail message:

Protocol: Select MAILTO.

Host: Enter the mail host for the user you wish to send a message to (this is the portion of the e-mail address that appears to the right of the @ sign), such as netmanage.com.

User Name: Enter the user name for the user you wish to send a message to (this is the portion of the e-mail address that appears to the left of the @ sign), such as support.

•	To access a news group:

Protocol: Select NEWS.

Host: Enter the news server you wish to access, for example, news.netmanage.com.

User Name: Enter the user name.


Test Link

Activates the link you created.

To test a link, choose the Test Link button. This launches your default browser and displays the mail message/news article.  After verifying that the link jumps to the correct location, close the browser. This returns you to the Link Information dialog.

Do not save changes to your browser configuration file.


HTML Mode Only

This option is only available when editing in HTML mode on Windows 95 and Windows NT. When editing in text mode on either of these systems, it is disabled (grayed out).

On Windows 3.1 this option is not listed as one of the menu options. Editing in HTML mode in Windows 3.1 launches the WebSpider application and displays WebSpider menus and toolbar.


Target

Corresponds to HTML tag A, attribute NAME.  Using a target lets you link to the middle of a very long HTML page,  by assigning an arbitrary name to a word on the HTML page.


Cells

Basic unit of a table.  The intersection of a row and a column in a table creates a cell.


IMAP Transport of Mail

Z-Mail Pro uses the IMAP4 (Internet Message Access Protocol), which is a client/server protocol , for manipulating remote message files.   Remote and local folders are fully integrated in Z-Mail Pro, messages are viewed and folders managed in the same way.  IMAP accesses mailboxes (folders) on remote servers as if they were local mailboxes, using the same commands such as moving to folders, search, marking messages. IMAP features include:

•	access to multiple hierarchical structured mailboxes on the same or different remote servers

•	shared mailboxes among multiple users

•	only headers displayed - message are not fetched until you view them, avoiding unnecessary retrieval of large attachments and saving bandwidth.

•	the ability to work with remote mailboxes as if they were local folders: creating, renaming, opening and deleting mailboxes, and searching the current remote folder

•	the ability to download specific messages or the full contents of a specific remote mailbox

•	emptying remote trash

•	reading new mail through the IMAP server by selecting your private remote folders

•	periodic/on demand checking and retrieval of recent mail from all connected INBOX folders.

•	dragging and dropping between folders - messages from your old folders are easily moved into new IMAP remote folders

•	application of multiple Rules

•	right mouse button (or ALT + Enter) drop down shortcut menus to access commands on a remote host

•	connecting and disconnecting from remote servers in the main window

•	printing without logos

•	Forum newsgroup thread support

•	support of other NetManage messaging applications, such as Phone Tag and Tag-it!

IMAP4 is used to manage messages on a remote host.  IMAP provides access to multiple hierarchically structured mailboxes on the same or different remote servers and to shared mailboxes.  Only headers are retrieved, which avoids unnecessary retrieval of large attachments and saves bandwidth.  When a message is viewed, it is fetched and stored online in the local cache for the duration of the mail session.  Mail can also be stored between sessions.

You may access multiple remote servers, or add numerous occurrences of the same server with different user names.  Additional servers are added through the Network Settings dialog.  Each server you add appears as a separate branch on the Remote tree displayed in the left pane of Z-Mail Pro’s main window.   Messages can be moved between mailboxes on the same server (same user tree), or to local folders.

IMAP does not post mail; this function is handled by SMTP.

See Also

Connecting to a IMAP Server

Downloading Mail from an IMAP Server

Handling Multiple Servers

IMAP Terminology

Permissions

Preparing for Working Offline

Checking for New Mail

Shared Mailboxes

Uploading Mail to an IMAP Server

Creating Hierarchical Folders

Remote Folder Drop Down Menus

Remote Host Drop Down Menus


IMAP Terminology

IMAP uses different terminology to Internet mail.  Following are some of the common words.

IMAP Term	Explanation
ACL	Access Control List - list of flags or permissions set by the Cyrus style server, such as; read only, administrator.  Washington style servers use regular UNIX/NT permissions mechanism.
Envelope	Message header information
Fetch	Mail retrieval
Mailboxes	Folders, may be remote and nested (hierarchical)
Nested Mailboxes	Sub-folders, inferior folders
Recent	New mail not previously fetched/listed by user
Selected Mailbox	Current folder
UID	Unique ID for each message ( kept by the server and preserved over sessions)


IMAP Permissions

IMAP permissions are dealt with differently by different types of servers.

•	In Cyrus style servers, the administrator of the remote servers set the permissions (flags) on the remote mailboxes and can modify the permissions.

Each mailbox has an ACL (access control list).  The ACL specifies for each mailbox which permissions are granted for each identifier (user).  Typically a mailbox specifies which identifiers can read files, write files, delete files, and see the list.

•	In Washington style servers, the end user can use Telnet to set up permissions. See NetManage Telnet Help for more information.


Shared Mailboxes

IMAP allows access to shared mailboxes on the remote host.  Messages can be accessed by a number of users.

Mailboxes are shared in one of two ways - depending on the type of server being used.

•	Cyrus type servers: When you log in, all shared mailboxes are displayed, and private mailboxes are in a  sub-folder of the users inbox.   The system administrator, by modifying permissions, is responsible for restricting the access to private mailboxes.

•	Washington University type servers: When you log in, only the user’s private inbox and tree of private folders are displayed.  To share mailboxes on this system, additional mailboxes must be added through the IMAP4 tab of  Network Settings.  Enter the path of the other mailboxes you need to see into the shared mailbox textbox.  The mailboxes are displayed in accordance with the permissions the login user has been allocated.

In the Shared Mailbox textbox of the Network Settings dialog box, enter the full UNIX path of the other mailboxes you wish to view.  For example, to access shared mailboxes under the user, “lizzie’s” account, you might specify ~lizzie/

(The mailboxes are displayed and accessible in accordance with the permissions the login user has been allocated.)


IMAP Servers
Types of IMAP Servers

There are two styles of servers that use the IMAP protocol: Cyrus Carnegie Mellon University and Washington University styles. They have some notable differences:

Note:	Sun servers behavior in a similar way to the Washington style explained here.

Mailbox Types	Cyrus	Washington
Shared Mailboxes	By default you can view all shared mailboxes at the root level. The ACL can be modified so that specific mailboxes can not be viewed.	By default there are no shared mailboxes. Shared mailboxes are set through the Network Settings dialog box.  You must have permission to view them.
Private Mailboxes (Folders)	Private mailboxes appear only under the user’s Inbox. They can not be created outside the Inbox.	Private mailboxes appear at any level under the IMAP server icon. They can not be created inside the user's Inbox.
Nested Mailboxes (Folders)	By default, mailboxes can be nested.	To create nested mailboxes, you must specify a separator in the path when creating the parent mailbox - see create folders for details. For example, if you specify “hello/” the hello mailbox created is a type of mailbox that can have sub-mailboxes within it
Trash (remote)	Trash is under the inbox.	Trash is at the root level under the IMAP server icon.


Handling Multiple Servers

You may access multiple remote servers, or add numerous occurrences of the same server with different user names.  Additional servers are added through the Network Settings dialog.  To add additional servers, choose the Add button, and enter the appropriate information in the new IMAP tab.


Working Offline
Preparing to work Offline

To view your mail while working offline, you will need to save your remote mail to a local folder, to do this:

1.	Click the remote folder with the mail you want to download.

2.	Click the right button, to bring up the pop up menu, and select download.

3.	Choose the local folder to place the downloaded mail, this is the target destination.


Remote Host Drop Down Menus

While a remote host is highlighted, click the right mouse button to access the following drop down menus:

Expand All

Expand Branch

Collapse All

Collapse Branch

Check New Mail

Create Sub Folders

Connect/Disconnect

Settings


Remote Folder Drop Down Menus

While a remote folder is highlighted, click the right mouse button to access the following drop down menus:

Expand All

Expand Branch

Collapse All

Collapse Branch

Create Sub Folders

Delete

Rename

Open

Empty Trash

Download


Expand All

Expands to display all the folders and sub folders under the Remote Host.


Expand Branch

Expands, to display the folders and sub folders under the selected Server or folder.


Collapse All

Modifies the display to show only Remote Server icons.


Collapse Branch

Modifies the display to show on the top level folder of the selected branch.


Check New Mail

Retrieves any new mail from the Remote Server.  Places messages in folders according to Z-Mail Pro rules.  You may apply multiple rules, and continue to the next rule.


Connect
Connect/Disconnect

Connect establishes a connection with the selected Remote Server.

Disconnect closes the connection with the selected Remote Server.


Create SubFolder
Create Sub Folders

IMAP provides access to multiple hierarchically structured mailboxes (a folder within a folder).  To create folders on the  remote server, do the following:

1.	Connect to a Remote IMAP Server.

2.	Select the desired folder within with you wish to created an additional subfolder, and click the right mouse button to access the drop down menus.

3.	Choose the Create Sub Folders command to create a sub-folder (a folder within a folder) in the selected remote folder.

For remote Washington style servers, to create sub-folders, the directory (parent folder) name must end with a separator.  For example, if you want to create a folder Staff, and inside this folder have a sub folder Tom (without any sub-folders) do the following:

•	Create a folder STAFF/

•	inside this folder create a folder TOM

5.	To display the contents of the folder, double click on the folder name from the Folder field in the current window or select the Open... option from the Folder menu.

Note:	For remote mailboxes (folders), Server permissions will determine if a new mailbox can be created - for example the user must have write permission.


Delete

Deletes the selected remote folder.


Rename

Renames the selected remote folder.


Open

Opens the selected folder, and display the folder’s messages in the right  side pane.


Empty
Empty Trash

Empties the trash on the remote host of the selected folder.


Download

Copies the selected folder’s messages to the specified local folder (cache).


Connecting to a Remote IMAP Server
Connecting to an IMAP Server

When you specify Network Settings for your remote IMAP server, you may select the option to automatically connect to that server when Z-Mail Pro is opened.

If you do not select the automatic connection option, you can connect to a Remote IMAP Server as follows:

1.	Select the desired remote server icon, and click the right mouse button to access the drop-down menu commands

2.	Choose the Connect command to establish a connection with the selected Remote Server.

Alternatively, you can connect by double-clicking the server icon in the Remote Server window.

To disconnect from a remote server:

1.	Select the desired remote server icon, and click the right mouse button to access the drop-down menu commands

2.	Choose the Disconnect command to close the connection with the selected Remote Server.

Note:	Exiting Z-Mail Pro automatically closes all active IMAP connections.


Checking for New Mail

You can check for new mail on the remote IMAP server, in a similar manner to way to retrieve mail to your local mail folders.  Places messages in folders according to Z-Mail Pro rules. Do one of the following:

•	Choose Retrieve Mail command from the Message menu, this checks for new mail on all the remote servers specified in network settings.

•	Select a Remote IMAP Server, click the right mouse button to access the drop-down menu commands and choose Check New Mail.

•	Double click on any remote folder to check for mail in this specific folder.


Downloading Mail from an IMAP Server

You can download messages from folders on a remote IMAP server to your local mail folders, as follows:

1.	When you are connected to the remote server, select a folder from the list.

2.	Click the right mouse button to access the drop-down menu commands, and choose Download.

3.	A dialog is displayed prompting you to select a local mail folder to receive the downloaded mail.  If you specify a folder that does not exist, Z-Mail Pro creates a new folder and moves the selected mail into it.

You can also use drag-and-drop to select messages from a remote folder and move them to one of your local mail folders.


Uploading Mail to an IMAP Server

You can move mail from your local mail folders to one of your personal or shared folders on an IMAP server by using drag-and-drop:

•	Select the mail message(s) that you want to move, and drag the highlighted message icons into the desired  folder on an IMAP server.


Creating Hierarchical Folders

IMAP provides access to multiple hierarchically structured mailboxes.  To create folders on the  remote server, do the following:

1.	Connect to a Remote IMAP Server.

2.	Select the desired folder within which you wish to create an additional subfolder, and click the right mouse button to access the drop down menu.

3.	Choose the Create Sub Folders command to creates a sub folder ( a folder within a folder) in the selected remote folder.

For remote Washington style servers, to create sub-folders, the directory (parent folder) name must end with a separator.  For example, if you want to create a folder staff, and inside this folder have a sub folder Tom(without any sub-folders) do the following:

•	Create a folder STAFF/

•	inside this folder create a folder TOM

5.	To display the contents of the folder, double click on the folder name from the Folder field in the current window or select the Open... option from the Folder menu.

Note:	For remote mailboxes (folders), Server permissions will determine if a new mailbox can be created - for example the user must have write permission.


This file is accessed by both forum and mail - and contains the joint topics.  The following topics, in this order, appear in this file:

Network settings

file menu items

menu items from the view and edit windows

encryption

FAQ


Network Settings

You may specify settings for Internet Mail, IMAP and/or News.  After you have specified these settings; Z-Mail Pro automatically invokes the appropriate mail transport when you select the type of mail that you want to create and Forum automatically invokes all enabled new servers. The Network Settings dialog box is where you define the Z-Mail Pro server, Z-Mail Pro gateway and Forum news servers.  You can set your network settings upon invoking Z-Mail Pro for the first time.  To add transports:

1.	Choose the Network Settings command from the Settings menu.

2.	Select the Add button.

3.	Select the Transport you require and add the appropriate information:

•	Internet Mail

•	IMAP4

•	News

4.	Select the OK button.


IMAP Settings
IMAP Network Settings

Use the IMAP Network Settings tab dialog to specify information for Remote mailboxes using the IMAP protocol:

IMAP Network Setting	Description
IMAP Server	Specify the fully qualified name or IP address of the computer system acting as the mail server. To verify that your server is supporting IMAP4, Telnet to port 143 and check for the IMAP server greetings
User name	Specify the Mail user for remote login authentication.
Password	Specify the password of the Mail user for remote login authentication.
Name	Enter the name you want to appear on the IMAP tab in Network Settings and on the IMAP server icon. This field is only available when you add a new IMAP4 tab to the Network Settings dialog box.
Note:	More than one IMAP transport can be added by selecting the Add button and then double clicking on the IMAP4 item.

Each server you add appears as a separate branch on the Remote tree displayed in the left pane of Z-Mail Pro’s main window.

Messages can be moved between mailboxes on the SAME server, or to/from local folders.

See Also

IMAP Advanced Settings


Internet Mail Network Settings

Use the Internet Mail Network Settings tab dialog to specify information for standard email:

Internet Mail Network Setting	Description
Host	Specify the name of the computer system acting as the mail POP3 server.
User	Specify the Mail user.
Password	Specify the password for the Mail user.
Mail Directory	Specify the directory on the Mail Server where your mail is stored. This setting is only required by certain POP2 servers.
Delete retrieved mail from server	Select this option if you want your mail automatically deleted from the server after you have retrieved it.  This helps to keep the storage on the server down
Outgoing Mail Gateway	Type or select the name of the mail gateway. A mail gateway routes all mail messages that are transmitted to the Outbox. A mail gateway is often used for access to the Internet.  The mail gateway must be configured to perform as an SMTP relay. If you do not define a mail gateway in Z-Mail Pro, the mail gateway you define in Outbox is used instead.
From Address	Type or select the name you want to appear as the sender in the From field when mailing a message.  Example: Jane Doe <jane@netmanage.com>


News Transport Network Settings
News Network Settings

The news tab  in Network Settings (from the Settings menu) allows you to specify the news servers used during your Forum sessions. You may add, modify, delete, enable and disable profiles, which contain the various connection parameters and behavior settings for the news servers.

When you select Network Settings in Forum, the Network Settings dialog appears with the news tab selected. This dialog contains a list of all the profiles in the current configuration file.  Each profile contains all the required specifications for a connection to a news server.   All enabled profiles appear with an asterisk to the left of the profile name (disabled servers do not have an asterisk).

To create a new profile choose the Add button and enter the relevant information in the Add Server Profile dialog.

To modify an existing profile, select the profile in the News Server Profiles list, and choose the Modify button.  Change the relevant information in the Modify Server Profile dialog then choose the OK button.

To Enable a profile, select the profile in the News Server Profiles list, and choose the Enable button (toggles with disabled).  An enabled profile name has an asterisk to the left.  When you open Forum, or go online, a connection is made to all the enabled servers.

To Disable a profile, select the profile in the News Server Profiles list, and choose the Disable button (toggles with enabled).  The profile name no longer has an asterisk to the left. The disabled profiles are kept in the configuration file, but are not active and no connection is attempted to this profile.

To delete a profile, select the profile and choose the Delete button.

Default Server: Select which profile should be used as your default server. It is advised to set the profile defining the Usenet server as the default. Forum uses the server specified in this profile, in the following cases:

•	When an article sent from Forum specifies news group addresses without specifying a server, Forum posts the article to the news group on the Default Server.

•	When Forum receives a URL request (e.g. when activating a jump to a news group from your Web browser) which does not specify a server, Forum searches for the specified news group or article on the Default Server.

Note:  	Forum supports URL requests using the NEWS protocol.


Server Profile

Enter the following details for your News Server profile:

•	Profile Name: Specify a name for the profile. This is the name that will appear in the News Server Profiles list box.

•	Server Information section: Specify the remote news server:

Host: Specify the name or IP address of the news server.

Port: Specify the number of the port to connect to on the news server.  The default is 119.

•	Login section: Specify the login details for accessing the news server (for servers that require Authentication)

Username: Specify the user name needed to  log into the news server.

Password: Specify the password needed to log into the news server.  The password is not displayed.

•	General Preferences section:

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.

Check for new articles: when checked, performs periodic checks for new articles in the subscribed groups on the news server, according to the set interval.

Check interval: Specifies the interval for checking for new articles (in hours and minutes).

Choose the OK button when you have completed entering the required information.

Note:  	If the profile name is changed, the Profile Information is considered a new profile (to be added) and not an update to an existing profile.


Undo

In text mode this feature cancels the last editing action.


Cut

Use Cut to remove selected text from your screen and put it on the Clipboard.  Cutting text to the Clipboard replaces the contents previously stored there.  You may place this text at the cursor location using the Paste command.

To cut text:

1.	Select the text.

2.	Choose Cut from the Edit menu to remove the selected text. You may also use the CTRL-X keyboard shortcut.


Copy

Use Copy to copy selected text from your screen to the Clipboard, leaving the original intact and erasing the previous Clipboard contents.  You may place this text at the cursor location using the Paste command.

To copy text:

1.	Select the text.

2.	Choose Copy from the Edit menu to copy the selected text. You may also use the CTRL-C keyboard shortcut.


Paste

Inserts the clipboard contents into the file, at the position of the cursor.

1.	Choose the Paste command from the Edit menu. You may also use the CTRL-V keyboard shortcut.


Find...

You can find a particular word, part of a word or any combination of characters in the message/article body.  To do this:

1.	With the cursor in the body of the message/article, choose the Find... command from the Edit menu.  The Find What dialog box appears.

2.	Type the word or text characters you want to find in the Find What field.

3.	Select the option you want to control your search:

•	Match whole word only:  Find the specified text as a whole word only.

•	Match case:  Find the specified text as having the same case as the text in the Find What field.  For example, if you search for "What" you will not find "what".

•	Up:  Search the text above the cursor.

•	Down:  Search the text below the cursor.

4.	Choose the Find Next button to begin or continue the search.

5.	Choose the Cancel button when you have finished your search.


Replace...

You can replace text in your mail/article by using the Replace option.  To do this:

1.	With the cursor in the body of the message/article you are creating, choose the Replace... command from the Edit menu.  The Replace dialog box appears.

2.	Enter the text you want replaced in the Find What field.

3.	Enter the text you want to replace it with in the Replace With field.

4.	Select the option you want to control your search:

•	Match Whole word only:  Find the specified text as a whole word only.

•	Match case:  Find the specified text as having the same case as the text in the Find What field.  For example, if you search for "What" you will not find "what".

5.	Choose the Find Next button to find the next occurrence.

6.	To replace the text, choose the Replace button.  To leave the text unchanged and continue the search, choose the Find Next button.

7.	To change all occurrences of the text for which you are searching without confirming, choose the Replace All button.

8.	When you are finished searching and replacing, choose the Cancel button.


Search Again
Find Next

Searches for the next occurrence of text that was searched for using the Find command.

To find the next occurrence of text:

•	Choose Find Next command from the Edit menu.


Select All

In text mode this feature selects all the text in the message/article.  You can perform various editing options on the selected text.


Send

Choose the Send command from the Message/Article menu to send the message/article to the designated email addresses or newsgroups.

Note:	The Send command is not available if there is no address in the To (recipient) field.


Save to File
Save to File...

To save the message/article as a file, choose the Save to File... command from the Message/Article menu.  A dialog box appears.

In the File Name box, select the drive and directory  and type the name of the file to which you want to save the message/article.  Choose the Save button.


Append to File
Append to File...

Allows you to append the contents of the open message/article to the end of a specified existing file.

While viewing or creating a message/article, choose the Append to File... command from the Message/Article menu.  Select the drive and directory and then the name of the existing file to which you want to append the message /article then choose the Save button.  The contents of the message will be appended at the end of the specified file.


Uuencode
Uuencode...

Uuencode and uudecode allow the conversion of binary files from and into ASCII format. Choose the uuencode option to uuencode a binary file before you send it out

MIME attachments are an alternative, more advanced way to attach binary files to articles. It is advised that you use MIME attachments (from the Attachments menu) whenever possible. Use uuencoded files only if the readers of your article might be using software that does not support MIME attachments.  To uuencode a file, do the following:

1.	Choose the Uuencoded File... command from the Insert Menu.

2.	Select or enter the file that you want to uuencode and choose the OK button.  The file will display in ASCII form in the body of your mail message.

Note:  	Some mail and news applications can uudecode only one uuencoded file at a time.  Therefore, you may want to uuencode only one file at a time.


NEWWIN_File_Menu
File Menu (New Message/Article window)

Import... (This command is only available in Windows NT and Windows 95)

Print...

Print Setup...

Close


NEWWIN_Edit_Menu_(mail)
Edit Menu(New Message/Article window)

Undo

Cut

Copy

Paste

Select All

HTML Mode (This command is only available in Windows NT and Windows 95)

Text Mode (This command is only available in Windows NT and Windows 95)

Find...

Replace...

Find Next...

Image (This command is only available in Windows NT and Windows 95)

Link (This command is only available in Windows NT and Windows 95)

Target (This command is only available in Windows NT and Windows 95)


NEWWIN View Menu
View Menu (New Message/Article window)

Personal Icon

Background (This command is only available in Windows NT and Windows 95)

Targets (This command is only available in Windows NT and Windows 95)


Show Personal Icon

Select the option to view your Personal Icon, that will be attached to the message/article you send.


Exit

Choose the Exit command from the File menu to close the current message/article.


Attachments
Attachments (New Message/Article window)

New...

Delete

Modify...


New
New...

Choose the New command from the Attachments menu to attach one or more files to a message/article that you are sending.

You may select to compress the file and/or add security-protection to the attached file by using the following options of the New Attachments command:

•	zip

•	encrypt

•	encrypt and zip

•	zip and password protect

To attach a file to a mail message, do the following:

1.	Choose the New command from the Attachments menu.

2.	Select or type the name of the file you want to attach to your current message.

3.	Choose the OK button.

4.	The Attachment Description dialog appears, specify the following:

•	Description: Default is the current file name.  Modify if necessary.

•	File Path: Default is the original file path.  Modify if necessary.

•	File Type selection includes text, Message, Application, Audio, Image and Video.  The Subtype field changes according to the defined Type. Default is set according to the name extension of the file you attach.

•	Options: Zip and/or encrypt attachments.

Note:	An attachment in zipped/encrypted format may be decrypted and unzipped by a recipient using Z-Mail Pro version 6.1 or higher.

To zip or encrypt a file:

a)	Choose one of the Option buttons. The choices are:

•	Normal: is the default and immediately attaches the selected file to the message/article.

•	Encrypted: uses the DES40 algorithm, giving a .NZE file extension. Encrypted files prompt for an encryption key.

•	Zipped: Compresses the file into a ZIP format with a .ZIP file extension.

•	Zipped and Encrypted: Compresses the file to a ZIP format, then encrypts it, giving a .NZE file extension

•	Zipped with Password: zips the file then prompts you to give a password.  The password may be an existing password or you may create a new one by following the prompts

b)	Choose the OK button to continue.

c)	If you select Encrypted, Zipped and Encrypted, or Zipped with Password a key list dialog box opens for setting a key.  See Key List for more information.

d)	Enter the mail address of the recipient.

e)	Choose the OK button and the Key is transferred to the recipient. You return to the File Encryption window.

Note:	The attached files have the extension of .ZIP if zipped or .NZE if encrypted. To read a .NZE file you must have Z-Mail Pro, release 6.1 or higher. To protect attachments sent to users without Z-Mail Pro version 6.1, use the Zip with Password option.

5.	Choose the OK button to attach the file to your message.

Note:	You may add multiple attachments to your message by repeating this procedure.

See also:

View

Save...


NEWWIN Insert Menu
Insert Menu (New Message/Article window)

File...

Uuencoded File...

Original Message

Signature

Horizontal Line (This command is only available in Windows NT and Windows 95)

Line Break (This command is only available in Windows NT and Windows 95)

Nonbreaking Space (This command is only available in Windows NT and Windows 95)

Image... (This command is only available in Windows NT and Windows 95)

Link... (This command is only available in Windows NT and Windows 95)

Target... (This command is only available in Windows NT and Windows 95)

Happy Face

Sad Face

Wink


Insert Original
Original Message

In text mode, choose the Original Message command from the Insert menu to include the original mail you are replying to or forwarding either as plain or indented text.


Signature

In text mode, this feature allows you to add your signature to the new message/article.  The signature is pasted into the bottom of your message/article.  The signature is set in Z-Mail Pro with the Signature command from the Settings menu.  You can also set the signature to be automatically attached to every outgoing message in the Signature dialog from the Settings menu.

Example:

            *******************************************************************

Camille, NetManage mascot   camille@NetManage.co.il

NetManage Ltd

Matam Science Park	Phone	972-(0)4-8550123

Haifa 31905, Israel	Fax	972-(0)4-8550122

Date: @date@

Time: @time@

This message was sent by Z-Mail Pro - from NetManage

NetManage - delivers Standards Based IntraNet Solutions

             ******************************************************************


File (insert)

In text mode, this feature allows you to include the text of a selected file in the message/article.

To Insert a file:

1.	Position the insertion point in the appropriate position in the message/article.

2.	Choose File... from the Insert menu.

3.	Select the file you want to insert and choose the OK button.


Happy
Happy Face

Choose the Happy Face command from the Insert menu to add a smiling symbol

 : -)  in your message/article.

If you are editing in HTML mode, the Happy Face command will insert a .GIF image of a happy face.


Sad
Sad Face

Choose the Sad Face command from the Insert menu to add a frowning symbol,

: - (  in your message/article.

If you are editing in HTML mode, the Sad Face command will insert a .GIF image of a sad face.


Wink

Choose the Wink command from the Insert menu to add a winking symbol

; - ) in your message/article.

If you are editing in HTML mode, the Wink command will insert a .GIF image of a winking face.


Delete

To Delete an attachment:

1.	Select the attachment

2.	Choose the Delete command from the Attachments menu.


Modify
Modify...

To Modify an attachment:

1.	Select the attachment.

2.	Choose the Modify... command from the Attachments menu.

3.	Make the necessary modifications in the Attachment dialog:

•	Select or type the name of the file you want to attach to your current message.

•	File Type selection includes text, Message, Application, Audio, Image and Video.  The Subtype field changes according to the defined Type.

4.	Choose the OK button to attach the specified file to your mail message.

The Attachment Description dialog box displays, for your verification, the name and path of your selected file.

Information regarding the attached file (such as its type, name and size) displays at the bottom of your window above the status bar.


Tools
Tools (New Message/Article window)

Check Spelling...

Fill Paragraph


Check Spelling
Check Spelling...

To check the spelling of your message/article:

1.	With the cursor in the body of the message/article you are creating, select the text in which you want to check spelling.  If you do not select text, the entire mail message is checked beginning at the cursor.

2.	Select the Check Spelling... command from the Tools menu.  The  Spelling Check dialog box appears if there are errors.

The spelling checker begins checking the selected text or the mail message.  When it finds a word that is not in the default dictionary, it displays the word in the dialog box and highlights it in the message.

For each word found, you can:

•	Correct the spelling - In the Replace With field, type the correct spelling.  Or, in the Suggestions field, select a correction.  Then, choose the Replace button to change the current word only, or Replace All to change all instances of the word.

•	Leave the word unchanged and continue the spelling check by choosing the Ignore button.

•	Skip the current word and all other instances by choosing the Ignore All button.

•	Add the word to a user dictionary so the spell checker will not consider it misspelled in the future.

3.	Choose the OK button to return to the message/article.  The Spell Checking is Complete dialog box appears when the speller has finished.

See also

Spell Checker Options


Fill Paragraph

In text mode, you can close any additional spaces in the text of a message/article you are creating by selecting a section of text you want to close and selecting the Fill Paragraph command under the Tools menu.


Contents

Displays the contents of the application's Help system.

While using Help, you can return to the Contents screen by choosing the Contents button in the Help window.


File Menu
File Menu (View Message/Article window)

Print...

Print Setup...

Close


Attachment menu
Attachments menu (View Message/Article window)

View

Save...


View

To view an attachment:

1.	Select the attachment.

2.	Choose the View command from the Attachment menu.

The attachment is opened with its associated application.  If no program is associated with this file you are prompted to select an .exe to open the file.

You may also view an attachment by double-clicking on the attachment line with the left mouse button.

Note:	You can read a zipped (.zip) or an encrypted (NZE) file attachment from within Z-Mail Pro. The attachment is automatically extracted and displayed. You will be prompted for a key when reading encrypted or password-protected zipped files.

Note:	You may also view the attachment by choosing it with the right mouse button.


Save
Save...

To save an attachment:

1.	Select the attachment.

2.	Choose Save command from the Attachment menu.

3.	Select the appropriate directory and enter the filename.

4.	Choose the Save button.

Note:	You may also save the attachment by choosing it with the right mouse button.

Saving an encrypted or zipped file:

If you select to save an encrypted or zipped file attachment, a dialog box appears asking you if you want to extract the encrypted or zipped file. Select No to save the file in its present form. Select Yes, to save the file decrypted and unzipped. You will be prompted for a key or password if necessary.


VIEWWIN View menu
View menu (View Message/Article window)

Next Message/Article

Previous Message/Article

In HTML

In Text

Navigate Using Browser

Go to Forum Discussion

Header

Personal Icon

Collapse Envelope


Next

Close the current message/article, and opens the following message/article.

You can also open the next message/article by clicking on the right arrow icon.


Previous

Close the current message/article, and opens the previous message/article in the window.

You can also open the previous message/article by clicking on the left arrow icon.


Show Header
Header

When selected, the header is displayed at the top of the View message/article. The header includes information about the sender and server that sent the message; the date and time the message was sent; the message's destination; and the message content type.

Here is a sample message header:

Received: from lizzie.netmanage.com (lizzie.netmanage.com [123.45.678.90]) by nm-gate.netmanage.com (1.2.3/3.2.1) with SMTP id LAA09876; Mon, 16 Dec 1996 11:07:55 +0200

Date: Mon, 16 Dec 96 09:37:36 PST

From: Lizzie Lizard <lizzie@netmanage.com>

Subject: Re:Cammie Chameleon's computer

To: moe@netmanage.co.uk, larry, joe

Cc: cammie, larrie

X-Mailer: Chameleon V0.05, TCP/IP for Windows, NetManage Inc.

Message-ID: <Chameleon.961216102731.lizzie@lizzie.netmanage.com>

MIME-Version: 1.0

Content-Type: TEXT/PLAIN; charset=US-ASCII

X-UIDL: deaf743932efabde67012b8dc67f9149


Show Personal Icon
Personal Icon

Select the command to view the attached Personal Icon


Copy

Use Copy to copy selected text from your screen to the Clipboard, leaving the original intact and erasing the previous Clipboard contents.  You may place this text at the cursor location using the Paste command.

To copy text:

1.	Select the text.

2.	Choose the Copy command from the Edit menu to copy the selected text. You may also use the CTRL-C keyboard shortcut.


Save From Address
Save ‘From’ Address

Saves the address listed in the From field into the address book you select.


Save Recipient Address
Save Recipient Addresses

Saves the address listed in the To field into the selected address book.


Find
Find...

You can find a particular word, part of a word or any combination of characters in the message/article body.  To do this:

1.	With the cursor in the body of the message/article, choose the Find... command from the Edit menu.  The Find What dialog box appears.

2.	Type the word or text characters you want to find in the Find what field.

3.	Select the option you want to control your search:

•	Match whole word only:  Find the specified text as a whole word only.

•	Match case:  Find the specified text as having the same case as the text in the Find What field.  For example, if you search for "What" you will not find "what".

•	Up:  Search the text above the cursor.

•	Down:  Search the text below the cursor.

4.	Choose the Find Next button to begin or continue the search.

5.	Choose the Cancel button when you have finished your search.


Select All

In text mode this feature selects all the text in the message/article.  You can perform various editing options on the selected text.


Forward
Forward...

Allows you to forward the selected message/article to email addresses and . newsgroups

To forward an message/article, do the following:

1.	Select the message/article title or first view the message/article by double clicking on it.

2.	Choose the Forward... command.

3.	The selected message/article appears in an edit window. The text is left intact, with a separator indicating where the original article begins.

4.	The list of recipients is cleared to allow specifying addresses and newsgroups for forwarding. Type in the recipient list.

5.	Type in your message above the separator that appears before the original article.

6.	Press the Send button when you are ready to send the article.

7.	Closing the window or pressing the Cancel button dismisses the article.


Save to File
Save to File...

To save the article as a file, choose the Save to File... command from the Article menu.  A dialog box appears.

In the File Name box, type the name of the file to which you want to save the message/article.  Or, select the drive and directory and then the name of the existing file to which you want to save the message/article.  Then choose the Save button.


Append to File
Append to File...

Allows you to append the contents of the open article to the end of a specified existing file.

While viewing or creating a message, choose the Append to File... command from the Article menu and type the name of the file to which you want to append the message /article.  Or, select the drive and directory and then the name of the existing file to which you want to append the message /article.  Then choose the Save button.  The contents of the message will be appended at the end of the specified file.


Navigate Using Browser

The Navigate using Browser command invokes your Web Browser for viewing links in HTML.  To view the URL link, using your Web Browser, do the following:

1.	Open the message/article containing the link.

2.	Choose the Navigate Using Browser command from Message/Article menu.

3.	Click on the URL highlighted in a contrasting color.

Your Web Browser is invoked and opens with the linked URL.

Note:	If this option is not selected, a clicked URL link appears inside the view window.


Uudecode
Uudecode...

To uudecode a file that was uuencoded in the message/article you are reading, do the following:

1.	Select the message/article you want to uudecode.

2.	Choose the View button to display the message/article.

3.	Choose the uudecode... command from the Message/Article menu.

Select or enter the file to which you want the uudecoded message/article to be saved. Then, choose the OK button.  The file is now converted into its original binary format.

Note:	You may have uuencoded file be automatically uudecoded and turned into an attachment. This will save you the need to uudecode them manually, and with image files, HTML viewing will open the articles with the uuencoded file already appearing as an embedded image. To uudecode files automatically, select the View Uuencoded files as attachments option in the Preferences dialog.


Encrypt Text

In text mode, encrypt text encodes a message/article or a selected portion of a message/article, which can later be decoded, to return to plain text. To encrypt text do the following:

1.	In New Mail/article or Edit Mail window, select the text in the mail message/article you want to encrypt.

Note:  	If no text is selected the whole message/article will be encrypted.

2.	Choose the Encrypt Text command from the Message/Article menu.

The Encryption dialog appears

3.	Select the Key you require for encryption, or create a new key.

4.	Select the OK button.

5.	The text is now changed into encrypted text, to reverse to readable text, select decrypt.

Note:	The Encrypt Text  command is only available in New Mail/Article or Edit Mail window.

See Also

Using Encryption

Decrypt Text

Making New Keys

Key List

Zip-n-Encrypt Attachments


Key List

Use the Key List to add new keys, delete keys in the list, and modify existing keys for encrypting text.

Choose the Encrypt Text command from the Message/Article menu (in New, Edit or View Mail/article window).

Select the necessary button:

•	New: Creates a New Key

•	Delete: Select the key name in the Key List and choose Delete. The key is removed from the list.

•	Modify: Select the Key Name in the Keys List, , the Modify Key dialog appears.  Change the Name and/or Value as required, and choose the OK button.

•	The Key list can be sorted by  Key type, or Key Name:

•	Double click on Key, the list is sorted according to the length of key - that is the number of characters in the key value.

•	Double click on Key Name, the list is sorted alphabetically.

•	Double click on left side arrows, to change the order of  display - between descending and ascending.

See Also

Using Encryption

Encrypt Text

Decrypt Text

Making New Keys

Zip-n-Encrypt Attachments


New Key

You may add as many keys to the Keys List  as required.  To make a new key, do the following:

1.	Select the New button in the Encryption or Keys dialog to make a new key.

2.	Enter the following:

Name: the name that will be listed in the Key List for this value

Value: the password needed to  decrypt the message/article.  The password uses the first ten characters.  This is case insensitive.

Use the key now without saving it: the key will encrypt the message, but will not be saved to the key list.  To decrypt a new key must be made with the same name and value.

Mail the Key: the key (name and value) is sent in a special mail message.  Select this box, and choose OK, the Mail the Key To dialog appears, type the email address of the receivers of the key or select it from the address book.  When the addressee downloads mail, a New Key Received dialog appears, with the sender’s address and the key name.  Choose Save to add the key to the Key list.  If a key with this name already exists,  a warning appears.

The key icon (under Value) changes to represent the security level of the password.  The more characters you enter, the safer the password, and the longer the key icon.  It is recommended for maximum security you use the ten characters.

All encrypted messages/articles are saved in the database as encrypted.

Select the Use the Key now without saving checkbox if you require the key for only this message/article.

Note:  	You must obtain the appropriate Key value from the person that sent the message/article or save the key sent through email.

See Also

Using Encryption

Encrypt Text

Decrypt Text

Key List

Receiving Keys

Zip-n-Encrypt Attachments


Receiving Keys

When a key is received, a dialog appears with the sender’s email address, the key name and an icon representing the key length. Choose the Save button to add the key to your key list.  Choose the Cancel button to ignore the key.  This means that the key can not be retrieved later.  If the key already exists, a warning is displayed in the bottom of the dialog.  If neither Save nor Cancel is selected within 10 seconds, the message dialog closes and pops up again the next time encryption is used.


Dencrypt Text
Decrypt Text

In text mode, the Decrypt text command, removes the encryption and returns the text to readable text. To Decrypt text, do the following:

1.	View the message/article you want to decrypt.

2.	Choose Decrypt from the Message/Article menu.

3.	If you have the correct key in your key list, the message/article is automatically decrypted.

4.	If you do not have the key, the New Key dialog appears.  Enter the value for that key.  For messages encrypted with a number of different keys, you will be prompted for the value for each key.

The new  key and its value is saved in the key list.

To decrypt just one block of encrypted text, select only that text, then choose Decrypt.

All encrypted messages/articles are saved in the database as encrypted.  After decrypting, when you forward the message/article, encrypting is again enforced.

The Decrypt Text command is available in Edit  and View message/article windows.

See Also

Using Encryption

Encrypt Text

Making New Keys

Key List

Receiving Keys

Zip-n-Encrypt Attachments


Using Encrpytion
Using Encryption

Encryption is a means of permitting higher security for your mail/articles when writing in text mode.  The contents of a mail message/article are encoded, and secured with a key. In  order to read the mail/article, the message must be decrypted in Z-Mail Pro.

The Encryption is secured with a key.  A key is like a password. The command used for decryption is only used when a key with the same value as the key that encrypted the message/article is used.  The user may create numerous keys, each key has a name and value.

The Sender creates a key, and encrypts the message, then informs the receiver of the encrypted message/article of the value of the key used.  The Sender can use the Send Key option to email the key to the receiver. The receiver will use this same value to create a key in Z-Mail Pro to decrypt  the text.   If the receiver does not have the appropriate key ( key with the same name and value) in the key list, a dialog box appears, and the value must be entered.  The user may create numerous keys, each key has a name and value.   In one message, you may use as many different keys as required.  The encryption algorithm used is DES-40.  It is exportable by US law.

Also, you may zip and encrypt attachments to messages/articles.  The options include none (default), zipping, encrypting, zipping and encrypting or zipping with a password.

See Also

Encrypt Text

Decrypt Text

Making New Keys

Key List

Receiving Keys

Zip-n-Encrypt Attachments


Application FAQ

Invokes a frequently asked questions (FAQ) Web page that will provide the latest information on NetManage applications.


IMAP Advanced Settings

Use the Advanced IMAP Network Settings dialog to specify additional information for Remote mailboxes:

Use the Advanced button to set the following:

Advanced IMAP Network Setting	Description
Keep messages cached between sessions	Viewed messages are automatically saved on the local drive  while Z-Mail Pro is running.  Select this option to save these messages upon exiting mail, and retrieve upon invoking mail.
IMAP cache location	Enter the location in the text box, or use the browse button to select the directory where you want to store the cached files.  The IMAP.CHE directory will be created in that specific location and the cached files will be kept there.
Shared Mailboxes	In the top text box enter the additional shared mailboxes that you wish to access. To display the contents of someone else's directory in your Remote Folders list, add the ~ character as a prefix to the directory name. For example, to add the contents of Camille's home directory named camille, type ~camille/ Choose the Add button.  The additional shared mailboxes are listed in the bottom box. To modify or remove a shared mailbox, select the mailbox from the list and choose the appropriate button. Note: Shared mailboxes are not available on Cyrus style servers.
Folder’s location	Sets the default folder location (usually the user’s home directory) for the IMAP account.  To display only the subfolders under a specific folder, enter the folder location with a delimiter.  This is useful when you only want your mailbox folder and not the contents viewed For example: Washington style: /home/Jane/mail/   Cyrus style: inbox.mail. Note: Separators may be different on different servers.
Port number	Default is 143.  Enter a different Port number if required.
Connect when mail starts	Select this option to automatically connect to this specific server when you open your Z-Mail Pro application.
Move to Trash on Delete	Messages are moved to the trash folder when Delete is used.  This options allows you to retrieve mail that you did not mean to delete by selecting it from the trash folder and moving it back to another folder.  For faster usage and deletions keep this box unselected.


In Text Mode

This feature is available in text mode only (not HTML).


Collapse Envelope

Collapses window envelope to give you more viewing space.  This acts as a toggle, collapsing or expanding the envelope as the menu entry is selected or deselected.  The small blue triangle at the left margin of the envelope is the icon for this function and may be used instead of the pulldown menu.


Spell Checker Options

You can customize the Spelling Checker for your own special needs.  Once you run Spell Checker, a dialog box appears.  From the Spelling dialog box, choose the Options... button.  A Preferences dialog box appears that lists the following options:

•	Ignore capitalized words - Spell checker will not display any improperly capitalized words.  However, if they are misspelled the checker will still find them.

•	Ignore words with numbers -  Spell checker will not display any words containing numeric characters..

•	Ignore words with mixed case - Spell checker will not display any words because there are mixed case letters.  However, if they are misspelled the checker will still find them.

•	Report doubled words - Spell checker will display any words that appear twice next to each other.  However, if they are misspelled the checker will still find them.

•	Always suggest - The Suggestion box automatically displays suggested words.  The default for this option is On.


Forum Discussion

The Forum Discussion button, in both Z-Mail Pro and Forum, provides you with the opportunity to view the same article in all of the different newsgroups where it was posted. This helps prevent you from missing a response to an article where the reply was only to one group and not to all the groups where the original article was posted.  This is especially useful in mail messages - you may not even be aware of the newsgroup where the article you received as a message is also posted. The Forum Discussion button draws your attention to this, and offers a convenient way to view the newsgroups.

To open the article in another one of the newsgroups where is posted, do the following:

1.	Open the article in Z-Mail Pro or in Forum.

2.	From the View menu choose Go To Forum Discussion or click the Discussion button.

3.	A list of all the newsgroups where the article was posted is displayed.  Choose the newsgroup in which you wish to see this article.

For example, you may post an article on a Shakespeare lecture to; janet@somewhere.com, soc.culture, rec.plays and rec.books. When Janet reads this email and chooses the Go To Forum Discussion button, the other newsgroups; soc.culture rec.plays and rec.books are listed. Choose one of these to see the thread of articles that may have been created in the different groups.


Close

Choose the Close command from the File menu to close the current message/article.


Proxy Settings

A Proxy server caches (temporarily saves) http files so they may be accessed locally.  This prevents multiple users from having to access the same file remotely.

For example both Janet and Linda have set up their mail to use the same Proxy Server.  If Janet, access a URL from http:\\www.remote.server.com, this file is cached on the Proxy Server http:\\www.local.server.com.  When Linda wants to access the URL, it is retrieved from http:\\www.local.server.com, instead of http:\\www.remote.server.com.

Proxy Settings are only available for messages/articles viewed in HTML mode. To set your Proxy Server:

1.	Open a message/article in HTML mode.

2.	From the Message/Article menu select Proxy Settings.

3.	Check the Use HTTP Proxy Settings box.

4.	Enter the IP address or name of your Proxy Server. For example, HTTP:\\www.server.com.  If you do not know the name of your Proxy Server ask your System Administrator.

5.	Enter the Port number - the default Port is 80.

6.	If you want specific http sites not to use the Proxy Server, select Proxy Exclude and enter the following:

a)	Exclude Host: Enter the name of the Host whose files you do not want to cache.

b)	Exclude Domain: Enter the name of a domain, whose files on all the Web Servers in this domain you do not want to cache.

c)	Choose Add to add this entry to the list.  Repeat the process until you have added all your excluded Proxy servers.

d)	Choose the Close button.

This option allows you to exclude local Web Servers.  There is no advantage to caching files from a local Web Server on a Proxy Server - as both are local and equally as fast to access.

1.	Choose OK.


This file contains the descriptions of menu items.  Most are here, if it is a menu item shared with Forum, it will be found in mailforu.doc.  Address book has its own file - nmadbkn.doc

File menu

Folders menu

Message menu

Settings menu

Services menu

Right click drop down menus


File

New configuration

Open configuration...

Save configuration

Save configuration As...

Print...

Print Setup...

Exit


New configuration

Choose the New Configuration command from the File menu to create a new configuration file.  The network settings, preferences and the display settings are saved to this configuration file.  Enter a filename for the new configuration file.

Each user has, by default a configuration file - USERNAME.CFG, in the user’s directory, where USERNAME is the name of the user.

Note:	When starting Z-Mail Pro, the previously used configuration is automatically loaded.


Open configuration
Open configuration...

Choose the Open Configuration command from the File menu to open an existing configuration file. The network settings, the preferences and the display settings will be read from the opened file.

Each user has, by default a configuration file - USERNAME.CFG, in the user’s directory, where USERNAME is the name of the user. When starting Z-Mail Pro, the previously used configuration is automatically loaded.

Note:	When starting Z-Mail Pro, the previously used configuration is automatically loaded.

To open an existing configuration file, do the following:

1.	Choose the Open command from the File menu.

2.	Select the file you want to open.

If necessary, locate the desired file by selecting the appropriate drive and directory.

Choose the OK button.


Save configuration

Choose the Save Configuration command from the File menu to save the current network settings, the preferences and the display settings to the current configuration file.

Each user has, by default a configuration file - USERNAME.CFG, in the user’s directory, where USERNAME is the name of the user. When starting Z-Mail Pro, the previously used configuration is automatically loaded.

Note:	When starting Z-Mail Pro, the previously used configuration is automatically loaded.


Save configuration As
Save configuration As...

Choose the Save Configuration As command from the File menu to save the current network settings, the preferences and the display settings to a different configuration file.  Enter a filename for the new configuration file.

Each user has, by default a configuration file - USERNAME.CFG, in the user’s directory, where USERNAME is the name of the user. When starting Z-Mail Pro, the previously used configuration is automatically loaded.

Note:	When starting Z-Mail Pro, the previously used configuration is automatically loaded.

To save a configuration file to a different name, do the following:

1.	Choose the Open command from the File menu.

2.	Select the file you want to open.

If necessary, locate the desired file by selecting the appropriate drive and directory.

Choose the OK button.


Print
Print...

Choose the Print... command from the File menu to send a message to the printer. Verify that your printer is defined by Windows and connected before you attempt to print a message/article.


Print Setup
Print Setup...

Allows you to choose how the logo or icon is printed in the message header.  Choose one of three radio buttons to:

•	Print No Logo in header: Select this option to print no logo in the message header.

•	Print Default logo in header: When you select this option the Chameleon logo is printed in the message header.

•	Print Personal Icon in header: Select this option to print the personal icon of the sender in the message header.  This option may be cancelled by selecting a different option.

Note:  	If you use the Picon Database collection,then the picon in the database is printed. The Chameleon logo is printed instead of the Personal Icon if the picon in the database is in color and you print to a black and white printer.

Also allows you to modify the printer configuration.

To modify the printer setup:

1.	Choose the Setup button in the Printer Settings dialog box.  This opens the Print Setup menu.

2.	Select either the default printer or a specific printer.

3.	Select additional options according to the specific printer.

4.	Choose the OK button.


Exit

Choose the Exit command from the File menu to exit the application.

Note:	The mail application remembers your window setting (size and position) as you exit (per user). The next time you log into Z-Mail Pro, the window will appear in the same place and same size.


Folders

With the exception of Create,  these menu items are also available by clicking the right mouse button, while the cursor is over Folder pane.

Create...

Rename...

Open...

Delete...


Create folder
Create...

In order to organize your messages efficiently, the Z-Mail Pro application allows you to create folders into which you can place your mail messages.

To create a folder, do the following:

1.	Choose the Create... command from the Folders menu to display the Create Folder dialog box.

2.	Select either Local or Remote as required.  Double click remote to display a list of all remote servers available.

3.	Enter the name of the folder and choose the OK button.

4.	Sub folders can be created on remote hosts.

For remote Washington style servers, to create sub-folders, the parent folder name must end with a separator.  For example, if you want to create a folder staff, and inside this folder have a sub folder Tom(without any sub-folders) do the following:

•	Create a folder STAFF/

•	inside this folder create a folder TOM

5.	To display the contents of the folder, double click on the folder name from the Folder field in the current window or select the Open... option from the Folder menu.

Note:	For remote mailboxes (folders), Server permissions will determine if a new mailbox can be created - for example the user must have write permission.


Rename
Rename...

To rename a folder (mailbox), do the following:

1.	Choose the Rename... command from the Folders menu.

2.	Select either Local or Remote as required.  Double click remote to display a list of all remote servers available.

3.	Select the folder name you want to rename, and then enter the new name in the From field.

4.	Choose the OK button.

Note:	To rename mailboxes on remote servers you must have write permission on that server.


open
Open...

To open a folder (mailbox):

1.	From the main Z-Mail Pro window, double click the folder you want to open.

2.	Or, choose the Open... command from the Folders menu.

3.	Select either local or remote as required.  Click on remote to display a list of all remote servers available.

4.	Select the folder you want to open and choose the OK button.


Delete folder
Delete...

To delete a folder, do the following:

1.	Choose the Delete... command from the Folder menu.  The Delete Folder dialog box appears.

2.	Select the folder you want to delete and choose the OK button.

3.	Choose the Yes button at the prompt.  The folder including all its messages are now deleted.  Any folder you delete is permanently deleted and is not first moved to the Trash folder.

Note:	You cannot delete the Inbox, Draft, Template, Sent Mail, Routing or Trash folders.  These folders always appear at the beginning of the Folder list even when they are empty.

To delete a remote mailbox (folder), do the following:

1.	Place the mouse over the mailbox you want to delete .

2.	Click the right mouse button, choose delete from the drop down menu.

 To delete remote mailboxes on remote servers you must have delete permission for that mailbox.


Message

Many of these menu items are also available by clicking the right mouse button, while the cursor is over Message pane.

Create...

View

Delete

Reply To

Forward

Search

Mark

Move To Folder...

Save To File...

Append To File...

Retrieve Mail

Refresh from Host

Select All


Create

To create and send a mail message:

1.	From the main mail window, choose the Create button, or choose the Create command (CTRL+E) from the Message menu.

2.	A new mail message window appears.  If you have enabled settings for more than one transport, the New Mail dialog box contains a drop-down list to select the desired Mail Transport.

•	Internet: Select this transport to create a standard Internet Mail email message.

•	News: select this transport to post a message to a specified newsgroup.

The Date field is automatically set to the current date and time.  The From field is automatically set to the From field that you defined in Network Settings.  If this has not been defined it is automatically set to user@localhost.domain. If the localhost is undefined, it is set to user@popserver.

3.	You may address your message as follows:

•	Enter the e-mail name and address of the person you want to send the message to in the text box next to the To field.  Then, using the down arrow, select either To (primary recipient),  CC (carbon copy),  or Bcc (blind carbon copy).

•	To add additional recipients from an address book:  choose the Address button to display the Address Book dialog box containing your address book(s) and their entries. Then, select or type each entry you want to add as a recipient, and choose the To, Cc, or Bcc buttons.  Choose the OK button to return to the new mail window.

•	News: If you have selected News, type the newsgroup you require and press ENTER. When the address appears in the field below, <@News:> is automatically added to the address.

Note:  	The Bcc will show up in the header unless a To recipient or a CC recipient is selected.

Note:  	To route your message to others, choose the Add Routing Slip  command from the Message menu.

4.	If desired, you can select the Confirm Delivery and Confirm Read options.  Select Confirm Delivery if you want the system to return an acknowledgment that the message reached the addressee's mail server.  Select Confirm Read if you want the system to return an acknowledgment that the addressee opened the message.  Acknowledgments are returned directly to your Mail Inbox folder.

Note:  	This option is applicable only if the receiver of the message is running Z-Mail Pro.

5.	If desired, select the priority type of the message you are sending.  You can select high, normal, or low priority.  Normal priority is the default.  If you assign high priority to your message, then a red exclamation point appears next to your message header in the recipient’s Inbox.  Assigning low priority to your message causes a down arrow to appear next to your message header in the recipient's Inbox.

6.	Type the subject and message text, and if desired, choose the Feelings menu to add a smiling, frowning, or winking symbol in your message.

7.	Choose the Send button to transmit your message to the Outbox. The message is immediately queued in the Outbox for subsequent delivery to it defined destination.

Note:  	To route your message to others, choose the Add Routing Slip  command from the Message menu.

See Also

New Mail Dialog


View

Any mail message may be viewed by selecting one or more messages and pressing the View button from the Inbox or Outbox.  The view window displays the date, source address, subject, list of recipients, and the message text.  None of these fields can be modified, but the Copy item within the Edit menu is available.

Functions available from within the view window include Reply to sender, Reply to all recipients, Forward, Move, Save, Print, and Delete.  You may also press the Next button to display the next mail message within the view window.  See specific help topics for replying and forwarding mail.  Save is used to store the mail message to a specific file, while Delete removes it from the folder.

The following menus are available;

File menu

Edit

Message

Attachment

Help menu

The Edit menu provides the copy function for transferring message text to other applications.  An override option to show the mail header is also provided.  The initial setting of Show Header is determined from the setting in the Preferences dialog box.

For Remote mail, IMAP displays headers on the remote server.  Viewed messages are automatically cached on the local drive for the duration of the mail session.  If the message is viewed again in the same session it is retrieved from the local cache.  Unless specified otherwise (in Network Settings) these messages are no saved between sessions.


Delete

Deletes a message from your Inbox. The deleted message will be stored in the Trash folder until you choose to select the Empty Trash command under the Services Menu. While it is still in the Trash folder, you can forward the message back to yourself or to others.

You can set the Empty trash on exit under the Preferences... selection under your Settings Menu to automatically delete all your mail messages stored in the Trash folder when you exit Z-Mail Pro.


Reply To

To reply to a mail message, select or view the message and choose reply (to Sender, or All) from the Message menu.  Or press either of the two Reply buttons in the toolbar, Reply to sender and Reply to all recipients.  The option of Reply to All is set in Preferences, Outgoing mail, and includes a reply to myself.  A window identical to the create mail display appears.  The Date and From fields are set as usual.  If All was selected, the list of recipients contains the source address of the original message and any carbon copy addresses as well.

Note that if you select Reply to All in the Preferences, Outgoing mail, your OWN address will appear as well. If you are not interested in getting a copy of the message you are about to send, delete your name from the list.

The subject remains the same, with Re: added to the beginning

The text of the original message can be left intact with a separator indicating where the original message begins.  The original copy may be included or not by setting the Preferences as required. You can also select Indented or Bracketed to specify the format of the included message or set it in your Preferences.

The text insertion point is placed above this separator so that you can type your reply above the original message.  Press the send button when you are ready to send the mail message. Closing the window or pressing the Cancel button dismisses the mail message

Note:  	If the original message was sent to recipients on other transports, when Replying to All, they will be included as well. Please verify that you have installed the same transports.


Forward

To forward mail received in the Inbox, select or view the mail and select Forward command from the Message menu, or press the Forward button.  A window identical to the create mail display appears.  The Date field is set as usual and the From field is maintained.  The list of recipients is cleared to allow specification of the addresses for forwarding.

The text of the original message is left intact, with a separator indicating where the original message begins.  The text insertion point is placed above this separator so that you can type your forward text above the original message.  Press the Send button when you are ready to send the mail message.  Closing the window or pressing the Cancel button dismisses the mail message.


Mark

Allows you to mark, with a red colored icon, any messages in any folder that you want to prioritize or stand out.  For example, you could mark messages that are of importance to you but that you do not want to read now, or a message that you have read but do not want to delete.  To mark a message:

1.	Highlight the message you want to mark

2.	Choose the Mark command from the Message menu.  The icon next to the marked message will appear red.

3.	To unmark a message, simply highlight the marked message and deselect the Mark command.


Search

Search lets you search mail headers and mail messages for specific strings.  A string can be a letter, word, or phrase.  To search for a specific string in a mail header or message body, do the following:

1.	Choose the Search... command from the Message menu.  The Search dialog box appears.

2.	In the Search Condition section enter the following:

•	Left box (If): Select which field to search for the string: Subject, From field, To field, Sender, Message body, or the Entire message.

•	Middle box: Select the determining parameter: Contains, Does not contain, Equals to or  Is not equal to.

•	Right box: Enter the string match in the search.

3.	In the Folders to search section, select the folder or folders you want searched.  Choose the Select all button if you want all the folders searched.

Note:  	On remote servers, only the selected mailbox is searched.

4.	In the Options section, select Match Case if you want the string you are searching for to be in the exact case you entered.  Select Wildcard/Regular expression if a wildcard symbol is included in your search string.

Note:	When searching in remote folders the 'Match Case' option is cleared and disabled and the 'Wildcard/Regular Expression' option is unchecked and disabled.

5.	Choose the Search button.  A window containing a list of all messages that contain the stated search conditions appears.  The Date, From (sender) Subject and Folder of each message are listed.

Double click to view the selected message.


Move to Folder
Move to Folder...

To move mail to a folder do the following:

1.	Select the message you want to move from the message list.

2.	Choose the Move to Folder... command from the Message Menu.

A dialog box that contains a list of folders appears.

3.	Select the desired folder and choose the OK button.

Your message will be placed in the specified folder.

Mail can be moved between folders in the following instances:

•	From a local folder to another local folder

•	From a remote folder to a local folder

•	From a remote folder to another remote folder on the same Remote server

•	From a local folder to a remote folder - the mail is copied, not moved.

Or,

1.	Select the message you wish to move from the message list.

2.	Choose the Move folder button in the toolbar or select Move from the Message menu. A Move To Folder box appears.

3.	Select the desired folder and choose the OK button

Or,

Select the message you wish to move and drag it to the desired folder, using the Windows drag-and-drop technique.

Or,

To move an open message:

1.	Select Move to folder from the Message menu or choose the Move button in the toolbar

The Move to Folder dialog appears.

A dialog box that contains a list of folders appears.

2.	Select the desired folder and choose the OK button.

Your message will be placed in the specified folder.


save to File
Save to File...

To save mail received in the Inbox to a file complete the following:

1.	Select the desired mail message

2.	Choose the Save to File... command from the Message menu.  A dialog box appears.

3.	In the File Name box, type the name of the file and the desired text file to which you want to save the message.  Or, select the drive and directory and then the name of the existing file to which you want to save the message.

4.	Choose the OK button.


Append To File
Append To File...

Allows you to append the contents of one or more messages to the end of a specified existing file. Do the following:

1.	View or create a message

2.	Choose the Append to File... command from the Message menu

3.	Specify the file you want to append to.  The contents of the message will be appended at the end of the specified file.

Note:	If you select more than one message, the information will be appended in the order in which you selected the messages.


Retrieve Mail

Allows you to manually retrieve mail.  If you have received some mail and your messages have not yet been retrieved, choose the Retrieve Mail command from the Message.

Mail is normally retrieved periodically by the Timers settings under the Settings Menu.

Also, you may retrieve mail using the retrieve mail button on toolbar


Refresh from Host

Refresh from Host deletes all the current header only messages on your computer and then retrieves all current messages in their entirety from the server.

To do this:

Choose the Refresh from Host command from the Message menu.

or

You may choose the Retrieve mail button in the toolbar.

Note:	This command applies to local mail only


Select All

Allows you to select all mail messages displayed in the current folder.

To select all messages in current folder:

1.	Choose the Select All command from the Message menu.

2.	To deselect all messages, click on any selected message.


Settings

Preferences...

Display Info...

Fonts...

Colors...

Log...

Signature...

Password...

Timers...

Toolbar

Smart Buttons

Status Bar

Network Settings...

Personal icons...


Preferences Setting
Preferences...

Allows you to modify preferences for Z-Mail Pro.  There are five tabs on the Preferences dialog box from where you can activate preferences.  The five tabs are: Outgoing Mail, Edit/View, Misc, International, and Smart Pop .  Select the preferences you want, and choose the OK button.


Outgoing Mail Tab

•	Close window after send:  After sending a mail message, closes the window. If not checked, the "Send" button will go gray and stay until you modify the text or mailing list. This allows you to easily re-send messages with slight modifications

•	Confirm on exit without send: This protects you from accidentally exiting a message you are currently writing and about to send.

•	"Reply to All" includes myself:  When the reply button is used, the recipient field contains all the addresses on the original mail.

•	Include original in reply: When you chose reply, the original message is placed into the new message.

•	Convert line break to CRLF:  Converts line breaks into carriage return/line feed (new lines).

•	Save copy to Sent Mail folder: With every mail sent a copy is placed in the send mail folder.

•	Bcc to myself: With every mail sent a copy is sent to the sender - and, unless a rule is applied, is delivered to the inbox folder.

•	Indent included message: When you choose reply he original message is placed into the new message and indented.

•	Reply/Forward in original format (HTML/Text): Select this option to make replies in HTML or Text according to the received message. This applies to Windows 95 and NT, only.


Edit/View Tab

•	Word wrap to window width:  The line will wrap according the width of the window.

•	Word wrap to max line length: The line will wrap according to the number of characters set in Max Line Length

•	No word wrap: the line will continue, until a paragraph return is entered.  A scroll bar appears when the line is longer than the window.

•	Max Line Length (chars): Setting used when Word wrap to max line length in selected.  Sets the amount of characters before the line is wrapped.

•	Edit in HTML mode: . Select the HTML mode in the Edit/View tab under Preferences in the Settings menu.

Windows 95 and NT: The message may be edited directly in Z-Mail.

Windows 3.1: WebSpider is automatically launched when operating in Windows 3.1.  Write your mail message in the WebSpider window. Choose the WebSpider Send button, or Send as Mail command from the File menu.  The HTML document is placed in the New Message window.  Send as a mail message in the usual way.

•	View in HTML mode: Select for HTML formatted documents to appear in standard HTML format.  You can view this document and any of its jumpers or links as you would if using a web browser.


Wrap

Describes when a sentence is continued on to the next (lower) line and not on the same line.


Misc Tab

•	Incoming Mail:

Audible notification:  Choose this button if you want to play a wave file on receiving Mail messages.  A sound driver is required.  If no sound driver is installed or if the file does not exist, you will hear a beep instead.

•	Start-up

Load Outbox:  Automatically launches the Outbox application when Z-Mail Pro is started.

•	View Mail

Show header

Show next mail after delete

•	On-exit:

Empty trash on exit

•	Confirm on delete recipient operations: When creating a message, you will be prompted when you try to delete a mail recipient who is on the (To: Cc: Bcc:) list of recipients.


International Tab

The International tab is used to set how international characters are displayed.  Z-Mail Pro supports Quoted Printable, NRC Conversion and 8-Bit ANSI.  If the recipient of your mail is using a program that only supports a specific standard, select that standard.

•	Quoted-Printable: The Internet standard converts 8-Bit characters to 7-Bit characters.  In order for the addressee to see the characters properly, the mailer used should support quoted-printables.

•	NRC Conversion: NRC supports 12 Western languages including US-ASCII. NRC is a method that partially solves multinational character problems in 7-bit mode.  It replaces some of the standard ASCII characters (such as #, @, [, and \).with the specified language's special characters (such as Ü, é, å, and Ç).

•	8-Bit ANSI:  Transfers all 8-bit characters to 8-bit characters only.


Smart POP Tab

The Smart POP dialog box has the following options.

Option	Description
Retrieve Headers Only for messages over xx KB	Lets you retrieve message headers only for messages that are above a certain size.  All messages under the stated size are retrieved in their entirety.  You can set the maximum message size in the KB text box. (Default is 1024 KB)
Always retrieve headers only	Lets you retrieve message header information only from messages on the server.  The entire message still resides on the server.  If desired, you can later retrieve an entire message by double clicking on the header message icon or by selecting a command from the menu or toolbar that needs the entire message (such as reply or forward).
Always retrieve entire message	This is the default setting. Lets you retrieve all messages as you normally do.  That is, in their entirety including attachments.
Do not apply rules to the  Header Only messages	If selected, your rules will not apply to header only messages, but only to messages that are entirely retrieved.
Confirm before retrieving  the entire message	If selected, displays a prompt stating that the message resides on the server and it asks you if you want to retrieve the message now.  You can also choose not to display the prompt again by selecting the Don't display this prompt again option.
See also

Retrieving Message Headers Only


Display Info
Display Info...

Allows you to choose how information is displayed.  You can have the number of unread messages and total number of messages in a folder displayed or hidden along with folder names.  (Default folder names are always displayed).

Under Messages, you can choose to have the information in the Status, Date, From and Subject fields sorted by ascending or descending order.


Fonts Setting
Fonts...

Lets you set the

•	font type style ( including bold and italic )

•	size and width of the message body in the application's main window

To select a font, do the following:

1.	Choose the Fonts... command from the Settings menu.

2.	Select the font, font type, and font size you want to use.

3.	Choose the Apply button to apply your selections  Then choose the OK button.


Colors Setting
Colors...

Allows you to set colors for your mail folders and individual messages. You can set both foreground and background colors for the Inbox and Trash folders, message body and list of message headers.  Colors can be selected from a palette of 16 colors. An area that shows the resulting combination is also displayed.

Each of the above fields has also a built-in default. To set the default colors color for a particular folder, select it from the "items" list. and click "Default". Clicking the "All Defaults" sets all fields to the factory-set default colors.

To select color for a folder, or a specific message when it is open, do the following:

1.	Choose the Colors... command from the Settings menu.

2.	Select the folder you want to change from the Items list.

3.	Select the desired background and foreground colors and choose the OK button.


Log
Log...

Helps you to diagnose client transmission and mail server retrieval problems.  Check replies for connection errors or destination address errors.

•	Choose the Log... command from the Settings menu.

•	Choose the Start button to start logging, or the Stop button to stop logging.

•	Choose the Save button to save the contents of the log window to the MAIL.LOG file.

•	Choose the Print button to print the contents of the log window.

•	Choose the Copy button to copy the contents of the log window onto the clipboard.

•	Choose the Clear button to clear the log window.

•	Choose the Options button to log to file or window.

•	Choose the Close button to close the Log... option dialog


Signature
Signature...

In text mode, this feature allows you to design a signature that can be automatically attached to the end of each mail message you send out.  To create a mail signature, do the following:

1.	Choose the Signature... command from the Settings menu.  The Signature dialog box appears.

2.	Type your own personal signature that you want to attach to outgoing mail.

3.	If desired, select the Attach to outgoing mail box if you want it automatically attached to every outgoing message.


Password
Password...

Allows you to change the password for the current user at any time.

1.	Choose the Password... command from the Settings menu.

2.	Type the original password and the new password twice for confirmation and choose the OK button.

Passwords for all users can be changed by the Postmaster user from the Mailboxes dialog box.


Timers
Timers...

Timers... lets you specify how often you want your mail retrieved from the mail server.

Your Inbox queries the server periodically, as specified by this time value.  Specify timing parameters in terms of days, hours, and minutes.  You can also select the Retrieve Mail option from the Message menu to manually retrieve server mail, if mail is not automatically retrieved.


Toolbar Setting
Toolbar

Choose the Toolbar command from the Settings menu to display or hide the application's toolbar.  The toolbar gives you quick mouse access to some of the application's functions.


Smart Buttons Setting
Smart Buttons

Choose the Smart Buttons command from the Settings menu to display toolbar icons, including each icon's description.


Statusbar Setting
Status Bar

Choose the Status Bar command from the Settings menu to display or hide the application's status bar.

The application displays messages and statistical information in the status bar, which is located at the bottom of the application's window.


Services

Address Book...

Outbox...

Rules...

Keys

Mailboxes (Postmaster only)

Empty Trash

Phone Tag

Tag-It!

Mail Alias Viewer

Share-It


Outbox
Outbox...

Anytime you send a message it first goes to the Outbox and then is delivered to the mail gateway, if defined.  This includes all messages sent using Z-Mail Pro, Tag-It!, Phone Tag, and messages you mail using Forum and meetings you schedule in NEWTCal.

The Outbox attempts to deliver a message as soon as it receives it.  Messages that remain in the Outbox past a specified amount of time expire and Z-Mail Pro messages are returned to the sender as undeliverable.

See Also

Opening the Outbox

Setting Preferences

Using the Messages Menu


Rules
Rules...

Rules are created to help you organize your incoming messages.  A screen shot of the example given here appears at the bottom of this help screen.  To create a rule:

1.	Select Rule... from the Services menu.

2.	Enter the following information:

Rule name:	Enter the name of the rule, this name will appear in the Rule window.    For example, Jane’s Mail
Select when the rule is to be applied:

This rule applies to any message:	When selected, all messages will have the rule applied. This is particularly useful in instances such as vacation, when a vacation script would be applied to all messages.
Only when criteria is matched:	Only messages matching the set criteria will have the rule applied.   Note: In instances where more than one rule meets the criteria, the first rule in the rule list is applied.  If a previous rule has been applied, this rule will not be performed.
String to match:	Enter the string searched for by the system.  A string can be a single word or several words.  If several words are entered as a string, all these words must be matched of r the action to be performed.   For example, Jane@somewhere.com
Where required select Match case.

From, To, Subject or Sender	Select the field where the search for the string will be performed. For example, selecting To, results in the defined action being applied to all mail addressed to Jane@somewhere.com
Select the action you want executed when the matched string is found:

Move to Folder:	Mail is moved into the selected folder.   The folder does not have to previously exist.  You can define the folder when you make the rule. If an IMAP server is defined a Remote button is available.  Choose this button to access a list of the remote folders and select the required remote folder.  Messages can be moved from the inbox of an IMAP server to another folder on the same IMAP server, or from a local inbox to a remote folder.  Messages cannot be moved from one remote server to another remote server.  If the IMAP server is not connected the Remote button is dimmed.   Note: The rule, to move a message to a remote folder, can only be applied if there is an active connection to the IMAP server.  In cases where there is no connection the message will remain in the inbox.
Forward:	Mail is forwarded to the entered address.
Delete:	Mail is deleted.
Run Script:	Runs the Script you selected. For example, select Move to Folder Jane, for all mail addressed to Jane@somewhere.com to automatically be placed in the Jane folder.
3.	Choose the Add button to add the new rule.

The Rules list window, in the left of the dialog box displays all rules.  Active rules are marked with an asterisk.  Select a rule and chose deactivate or activate (the button toggles between the two states) to change the status of the rule.

Note:  	If you have a message that more than one rule applies to, then the system will apply the first rule that is listed in the Rules list.  The Up and Down buttons allow you to change the positions of rules in the list

Use the appropriate button to modify, delete or create new rules.

See Also

Rules Overview

This embedded picture is too large for the Microsoft Help Compiler.  See Converting Pictures into Help Graphics in the ROBOHELP documentation.


Scripts

1.	Select the RunScript radio button.

•	To edit a script, select the file you want to edit using the Browse button,

•	To create a new script, do not select any file

2.	Select the Edit Script button.

The Visual Script Editor is invoked.

3.	Select Assist from the menu bar

The Script Commands Assistance dialog appears.

4.	Select MailRules from the Command Class drop down list.

All available commands are listed under Script Commands:

Mail information script commands:

•	MailRuleGetFieldFrom

•	MailRuleGetFieldSubject

•	MailRuleGetFieldTo

•	MailRuleGetFile

•	MailRuleGetSender

Mail action script commands:

•	MailRuleDelete

•	MailRuleForward

•	MailRuleMoveToFolder

You may use all the other commands available under the other class.  For detailed instructions on creating scripts refer to the Visual Script Editor online help.

5.	Use these commands to build a script to be performed on incoming mail messages.

Scripts can only perform one mail action ( from the MailRules command class). If, more than one mail action script command from the MailRules class is used only the last mail action in the script is performed.

While the VSE is open through mail, mail is not being retrieved.  You must close all dialog boxes for scripts and rules to retrieve messages again.

A sample script, vacation.vba, is provided.  This script automatically sends a reply (with a body message that you enter) to the senders of all the messages you receive.  This is ideal in a vacation situation, where you can inform all senders of the time duration you are not replying to email.  Another sample script, mailrule.vba, demonstrates several of the MailRules commands.


Mail Boxes
Mail Boxes (Postmaster Only)...

Allows you to enter additional users to the mail system.

To do this:

1.	Open Z-Mail Pro and log on as Postmaster without a password.

2.	Choose the Mailboxes... command from the Services menu.  The Mailboxes dialog box appears.

3.	Enter the username you want to add in the User text box and choose the Add button.

4.	A second dialog box is displayed.  Enter the user's name in real life and the password (optional) and select the directory where you want the new user's mail stored.

5.	Choose the OK button.

6.	Choose the Save button to save the changes, or choose the Cancel button to cancel the changes.

7.	To delete existing users, select the username you want to delete and choose the Delete button, and then the OK button at the prompt.

Note:	It is advised to assign each user a unique directory for the mail.


empty trash
Empty Trash...

Empties your local trash folder that stores all deleted messages.

To empty your local trash folder, choose the Empty Trash... command from the Services menu.

Note:	You can also set under the Preferences Menu the Empty trash on exit. If you set this option on, upon exiting mail your Trash folder will automatically be deleted.

To empty Remote or Local Trash folders, select the trash folder, and click the right mouse button, and select Empty.


Expand
Mail Alias Viewer

Mail Alias Viewer provides you with a list of all mail addresses listed under an alias.  For example,  you want to know who you are sending mail to when you send to alias sales@office.com - Mail Alias Viewer lists all the mail addresses who are listed under this alias .

To use Mail Alias Viewer do the following:

1.	Choose the Mail Alias Viewer icon or Mail Alias Viewer from the Services menu in Mail.

2.	Host: Enter the name of the Host where the alias list for the group you want to expand is stored.

Ask the system administrator, of this mail gateway, for the name of the Host.

3.	Alias: Enter the name of the Alias you want to expand.

4.	Choose the Expand button.

All addressees under this alias are listed.

Double click one of the addresses, it appears in the status bar. Then the following options can be performed for this address:

•	Addressbook: Saves the address to the address book you select.

•	Send Mail: Brings up the edit message dialog, with the address automatically placed in the from field.

•	Abort: The Expand button toggles to Abort, when the expand process is in process. Choose Abort to terminate the process, before completion.

•	Use the shortcut keys to copy (ctrl + c) and paste (ctrl + ins) to copy the addresses from the alias list.

See Also - Menu Options

File: Exit

Settings: Personal Icons

Settings: Status Bar


Personal icon database

Sets the directory where the Personal icon database (library) is available. Once set, personal icons associated with an email addressee will be displayed, when that name is selected.

1.	Select Personal icon database from the Settings menu.

2.	Select the appropriate drive and directory where the icon files are stored.

3.	Choose the OK button.


Personal icon

A Personal Icon, is graphics file that appears in a mail message window.   Most commonly used Personal icons are a picture of your face, company logo, or some other symbol you want to appear in your message. This file must have a .BMP, .GIF, or .XMB extension and must measure 48 x 48 pixels.

The Personal icon feature lets you attach Personal icons to messages and view messages with Personal icons.

You can, however, view a message and see its Personal icon even if the Personal icon is not directly attached to the message. To do this, you need to create a Personal icon database and store Personal icon files that are associated with specific Z-Mail Pro users.  You can specifically set Personal icon settings so that Z-Mail Pro searches your Personal icon collection for a file that matches the sender's e-mail address (in the From text box). Then, when you view the message, a Personal icon that matches the sender's address appears in their message.

For more information about how to create a Personal icon database, refer to Z-Mail Pro online help.

If there is no Personal icon file (FACE.BMP file) that matches the exact e-mail address of the sender, then Z-Mail Pro searches up the directory path of the e-mail address for a FACE.BMP file.


Exit

To exit the Mail Alias Viewer program:

Choose the Exit command from the File menu.


Statusbar Setting
Status Bar

Allows you to display or hide the application's status bar.  The status bar is displayed at the bottom of the window where it shows messages and provides statistics about the current application.


Phone Tag

Allows you to directly access the Phone Tag application.  To do this:

Choose the Phone Tag command from the Services menu.

A Phone Tag create memo appears.

For detailed information, refer to the on-line help within Phone Tag


Tag-It!

Allows you to directly access the Tag-It! application.  To do this:

Choose the Tag-It! command from the Services menu.

The Tag-It! memo pad appears.

For detailed information, refer to the on-line help within Tag-It!


Drop down menus

For convenience and ease of use drop down menus can be accessed with a right mouse click.  The menu that appears, depends on the location of the mouse:

Local Folders

Local Messages

Remote Host

Remote Folders

HTML Edit


Local Messages Drop Down Menu

View

Delete

Reply To

Forward

Mark

Move To Folder...


Local Folders Drop Down Menu

Open...

Rename...

Delete...

Empty

Note:	Delete is disabled when system folders are selected.
Empty is only available when the Trash folder is selected.


HTML Edit

For convenience and ease of use drop down menus can be accessed with a right mouse click.  Highlight the part to be edited and press the right mouse button.  The options that appear are:

Cut

Copy

Paste

Font Styles

Paragraph Styles

Tables


Print
Print...

Choose the Print command from the File menu to send the message/article to the printer. Verify that your printer is defined by Windows and connected before you attempt to print a message/article.

Note:	The Chameleon logo will be printed instead of the personal icon if your print settings are set to Print Personal Icon in Header and the message being viewed, or selected for printing, is using a color icon from the icon database.


Print Setup
Print Setup...

Allows you to alter the logo or icon in the message header.  Choose one of three radio buttons to:

•	Print No Logo in header: Select this option to print no logo in the message header.

•	Print Default logo in header: When you select this option the Chameleon logo is printed in the message header.

•	Print Personal Icon in header: Select this option to print the sender's personal icon in the message header.  This option may be cancelled by selecting a different option here.

Also allows you to modify the printer configuration.

To modify the printer setup:

1.	Choose the Setup button in the Printer Settings dialog box.  This opens the Print Setup menu.

2.	Select either the default printer or a specific printer.

3.	Select additional options according to the specific printer.

4.	Choose the OK button.

Note:	The Chameleon logo is printed instead of a personal icon if your print settings are set to Print Personal Icon in Header and the message being viewed, or selected for printing, is using a color icon from the icon database.


Share-It!

Select Share-It form the Services mail to begin the OpSession application.  For information on how to use OpSession refer to OpSession's online help.

Note:	Share-it command is only available if you already have OpSession installed.


Menus for New Message window

File menu

Edit menu

View menu

Message menu

Attachments menu

Insert menu

Format menu

Table menu

Tools menu

Go IntraNet!

Help menu


Message
Message Menu (New Message window)

Send

Add Routing Slip

Save to File...

Append to File...

Save As Draft

Save As Template

Include Images

Include Text Version (This command is only available in Windows NT and Windows 95)

Encrypt Text

Decrypt Text


Add Routing Slip

The Routing Slip feature lets you send a message to a predefined route of addresses in the order you specify.  Instead of sending a message to multiple recipients simultaneously, the Routing Slip feature lets you send a message to recipients one after the other. That is, after the message is viewed by a recipient, he or she can choose to send the message to the next recipient on the routing slip.

To create and route a message to others, do the following:

1.	In the New Mail window choose the Add Routing Slip command from the Message menu.  A New Mail-Routing Slip dialog box appears.

2.	Choose the Add Address button to display the Address Book dialog box that contains your address book(s) and their entries. Then, select or type each entry you want to add as a recipient to your routing slip and choose the To button. Choose the OK button to return to the New Mail-Routing Slip dialog box.  Notice that all mail recipients are listed and numbered in the Route text box.

3.	To modify the order of recipients, select an address and move it using the up or down buttons to the right of the address list.

4.	If desired, select the Return At End, and/or the Allow Modifications options, and choose the OK button.  The name "Routing List"  appears in the address textbox.

The Return At End option sets your address as the last address on the route, thus making the route into a loop.

If desired, you may later edit the route before sending it or deleting it.  Do this by displaying the Routing Slip dialog box or by selecting Routing List in the address text box and choosing the Modify or Delete buttons, respectively.

6.	Finish completing your message and choose the Send command from the Message menu, or choose the Send button to mail the message. The newly sent message is placed in the Routing folder.

7.	The status of the routed message is updated as the message moves along from one recipient to the next.  Whenever the status is updated, the message is marked as unread.   All routed messages are stored by default in the Routing folder.


Save As Draft

You can save and store an unfinished mail message and then send it at a later date by using the Save As Draft and Update Draft mail features.

To create a draft message:

1.	Choose the Create... command from the Message menu.  A New Mail message form appears.

2.	Enter the subject, addressee, and message text you normally would when creating a new message.

3.	Save the unfinished message by selecting the Save As Draft option from the Message menu.  The unfinished message is now saved in the Draft folder..

Note:  	The Draft folder always appears at the top of the Folder list, after the Inbox folder, even when it is empty.  You cannot delete the Draft folder.

To update an existing draft message.

1.	Select the Draft folder and then select the draft message you want to update.

2.	Make the desired changes to the message and select the Update Draft option from the Message menu and close the message.

The draft message is now updated and stored in the Draft folder.

To complete and send a draft message, simply select the desired draft message and complete it.  Then send the message by choosing the Send icon on the Toolbar or select the Send option from the Message menu.


Save As Template

To create a template:

1.	Choose the Create... command from the Message menu.  A New Mail template appears.

2.	Enter the subject and message text you want to be part of the template. If desired, you can also enter an addressee.  You can create a template without entering a subject, however a template is easier to identify in the Template folder if it contains a subject.

3.	Save the template by selecting the Save Template option from the Message menu.  The template is now saved in the Template folder.

Note:  	The Template folder always appears at the top of the Folder list even when it is empty.  You cannot delete the Template folder.

To update an existing template:

1.	Select the Template folder and then select the template you want to update.

2.	Make the desired changes to the template and select the Update Template option from the Message menu and close the template.

The template is now updated and stored in the Template folder.

To complete and send a template, simply select the template and add any additional information.   Then send the template by choosing the Send icon on the Toolbar or select the Send option from the Message menu.


Help
Help (New Message window)

Contents

About Z-Mail Pro...


Menus for View Message window

File menu

Edit menu

View menu

Message menu

Attachment menu

Routing  menu

Help menu


Edit menu
Edit menu (View Message window)

Copy

Save 'From' Address

Save Recipient Addresses

Save Personal Icon

Find...

Find Next

Select All


Message menu
Message menu (View Message window)

Delete

Reply to

Forward

Mark

Move to Folder...

Save to File...

Append to File...

Decrypt Text

Uudecode...

Proxy Settings...


Save Personnal Icon
Save Personal Icon

Saves the Personal Icon in the open message to the Personal icon database.  This icon will be displayed with messages  with the corresponding email address when no personal icon is attached.


Delete

Deletes the open message


Reply to

Allows you to send a reply to the open message/article.  To reply to a mail message, select or view the message and choose reply (to Sender, or All) from the Message menu.  Or press the Reply to Sender or Reply to All button in the toolbar. An option to include yourself in the Reply to All set in Preferences, Outgoing mail.  A window identical to the create mail display appears.  The Date and From fields are set as usual.  If All was selected, the list of recipients contains the source address of the original message and any carbon copy addresses as well.

Note that if you select Reply to All including myself in the Preferences, Outgoing mail will include your OWN address as well. If you are not interested in getting a copy of the message you are about to send, delete your name from the list.

The subject remains the same, with Re: added to the beginning

The text of the original message can be left intact with a separator indicating where the original message begins.  The original copy may be included or not by setting the Preferences as required. You can also select Indented or Bracketed to specify the format of the included message or set it in your Preferences.

The text insertion point is placed above this separator so that you can type your reply above the original message.  Press the send button when you are ready to send the mail message. Closing the window or pressing the Cancel button dismisses the mail message

Note:  	If the original message was sent to recipients on other transports, when Replying to All, they will be included as well. Please verify that you have installed the same transports.


Mark

Allows you to mark, with a red colored icon, any messages that you want to prioritize or stand out.  For example, you could mark messages that are of importance to you but that you do not want to read now, or a message that you have read but do not want to delete.  To mark a message:

1.	Open the message you want to mark

2.	Choose the Mark command from the Message menu.  The icon next to the marked message will appear red.

3.	To unmark a message, simply highlight the marked message and deselect the Mark command.


Move to Folder

Moves the open message to a different folder. To move the open message:

1.	Select Move to folder from the Message menu

The Move to Folder dialog appears.

A dialog box that contains a list of folders appears.

2.	Select the desired folder and choose the OK button.

Your message will be placed in the specified folder.

Mail can be moved between folders in the following instances:

•	From a local folder to another local folder

•	From a remote folder to a local folder

•	From a remote folder to another remote folder on the same Remote server

•	From a local folder to a remote folder - the mail is copied, not moved.

Or

If the message is not open, you may still move it to a selected folder.

1.	Select the message you wish to move.

2.	Choose the Move folder button in the toolbar or select Move from the Message menu. A Move To Folder box appears.

3.	Select the desired folder and choose the OK button

Or

If the message is not open, you may select it and drag it to the desired folder, using the Windows drag-and-drop technique.


Routing
Routing Menu

Routing menu in the View window, only appears when a routed message is opened.

Route to Next

Information

Block Route


Route to Message
Route to Next

Lets you send the message to the next recipient listed in the route and notify the originator of the progress along the route.


Information

Lets you display information about the route.  The Routing Information dialog box appears containing a list of addresses (if you are a recipient) or the message status (if you are the originator).


Block Route

Lets you stop the message from being routed to any other recipients.  The originator of the message is also automatically notified that the routing has stopped.


Address Book Contents

This help file contains a list of all Help topics available for the Address Book.  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

Menus

Address Book

Edit

Settings


Address Book

Open...

Add New Book...

Delete

Properties...

Copy To...

Update Remote

Setting Up Open Directory Service


Edit

Add Name

Add Group

Members...

Delete Name


Settings Address Book
Settings

ECCO Setup...


Overview

The Address Book allows you to create and save email addresses that you wish to use more than once, so that you do not have to repeatedly type the addresses each time you send email.  After you have specified an email address in an Address Book, you can select it from the book instead.

You can access the Address Books through Z-Mail Pro, Phone Tag, Forum, NEWTCal, InPerson, and Tag-It!.  E-mail addresses from your ECCO phonebook can also be added into one or more of your Mail Address Books.

The Address Book provides a number of useful features:

•	Create new address books

•	Add individuals to your list

•	Create new groups or distribution lists

•	Add members to new or existing groups

Note:	Forum automatically creates an address book for each of its news server profiles. These address books contain the addresses of the subscribed news groups on each of the servers.

You can access the Address Book by choosing the Address Book menu command or the Address button.

Z-Mail Pro: Choose the Address Book... command from the Services menu, or choose the Address... button located on the new message/article window. The new message/article window appears when you choose the Create..., Reply to or Forward… commands from the Message menu

Forum: Choose the Address Book... command from the Services menu, or choose the Address... button located on the new message/article window. The new message/article window appears when you choose the Post…, Reply to or Forward… commands from the Article menu.

PhoneTag: Choose the Address command from the Control menu, or by choose the Address... button located on the new message/article window.

Tag-It!: Choose the Address command from the Control menu, or by choose the Address... button located on the new message/article window.

NewtCal: Choose the Appointments command from the Edit menu, and select the Attendees button.

Note:	When the Address book is accessed from the Service menu, a number of the menu items are also available as buttons.

See Also

Accessing the Address Book

Adding Groups to an Address Book

Adding Individuals to an Address Book

Addressing Your Mail Message

Copying Names Between Address Books

Creating Additional Address Books

Deleting Existing Address Books

ECCO Setup Option

Viewing Address Book Properties


How to Use
How to Use the Address Book

Accessing the Address Book

Adding Groups to an Address Book

Adding Individuals to an Address Book

Addressing Your Mail Message

Copying Names Between Address Books

Creating Additional Address Books

Deleting Existing Address Books

ECCO Setup Option

Using Remote Address Books.

Viewing Address Book Properties

Setting up Open Directory Service


Addressing Your Mail Message

You can address your mail message using your Address Book entries by doing the following:

1.	Choose the Address Book... button from the Z-Mail Pro/Forum new message/article window.  The Address Book dialog box appears.

2.	Double click on the address book in the left window containing the addresses you require.

3.	Select each email address you want to add as a recipient:

•	Local address book:  Choose the address you require

•	Remote address book: Enter the search pattern or name and choose Search.  The results of the search are displayed, choose the name you require. See Using Remote Address Books.

4.	Choose the To (primary recipient), and if desired, the Cc (carbon copy), or Bcc (blind carbon copy) buttons.

5.	Choose the Close button to return to the Mail new message/article window.

Note:	With a remote address book (in search mode), when the book is opened, no addresses are displayed. You must enter a search pattern and choose the search button, to display addressees.  To display all addresses enter *.*.


Open
Open...

Open allows you to open an existing Address Book.  To do this:

1.	Open Address Book from either the Services menu or the Z-Mail Pro/Forum new message/article window.

2.	Select the Address Book you want to open

3.	Choose the Open... command from the Address Book menu or

•	double-click on the desired Address Book or

•	press enter


Add New Book
Add New Book...

You can create a new Address Book, add additional Address Books that are stored locally, access an existing Address Book that resides on a remote host or access an ECCO E-Mail list in an ECCO file.

To create a new or add another Address Book:

1.	Open the Address Book from either the Services menu or the Z-Mail Pro/Forum new message/article window.

2.	Choose the Add New Book... command from the Address Book menu.  The Add Address Book dialog box appears.

3.	Enter the following information:

Local or Remote	Select the location of your address book.
Name	Enter the name, up to 15 characters, you want to give to the new Address Book, this will appear in the Address book list.
File(local)	Enter the Address Book's path and filename.  You can enter the pathname directly or use the Browse button to browse for the selected drive and directory.  For a new address book, you will be prompted to confirm you want to create a new file.  This is only applicable for local address books. For an ECCO addressbook: choose the browse button, the Open dialog appears.  Change the file type in the drop down list to *.eco. Select the file from the list of all available ECCO files or leave the file name blank.  Refer to ECCO Setup for more details. Note: You cannot create a new .eco files from within address book, the .eco file you specified must already exist.
Host (remote)	Enter the name or IP address of the host in the Host text box.  This is where the Address Book you want to access remotely is stored.  See Using Remote Address Books.
Protocol	Whois++ - For address books created to support Whois++ Z-Mail ODS  - For address books created using Z-Mail Pro.  See Setting Up Open Directory Service
Port	Default Port for Whois++ is 43 Default Port for Z-Mail ODS is 15213
Advanced	The Advanced button sets additional options for remote address books.
Delimiter	A delimiter is used as a marker between the email address and freeform information (that is additional information, such as telephone numbers, address etc., entered by the system administrator). A space, by default is read as the delimiter.  Enter here any other characters that are used as a delimiter, such as underscore, tab etc.
Search for Addresses	Addresses are searched for on the remote host, where the address book is located.  These addresses are not cached locally.
Download All Addresses	Default. The Address book is downloaded to the local drive.  A temporary file is created on your local drive which is automatically deleted when the address book is deleted. To update this address book choose Update Remote form the Address menu.
4.	Choose the OK button.

Note:	Address Book changes the default settings to the last parameters you defined when setting up an Address Book.


Using the Remote Address book
Using the Remote Address Books

A remote Address book is created with the Add New Book command and modified with the Properties command.

You can open the remote Address Book by double clicking on its name in the listbox.   There are two types of Remote Address books, depending on the setting selected in the Properties dialog box:

Search for Addresses

Addresses are searched for on the remote host, where the address book is located.  These addresses are not cached locally.  When this type of remote address book is opened the addresses are not displayed automatically. You must enter a name or search pattern and choose the search button, to display addresses.  To display all addresses enter *.*.

Download All Addresses

The Address book is downloaded to the local drive.  The first time you open the book, the application connects to Directory Server, downloads all the addresses, and displays them in the listbox. These addresses are cached in a local file so you can open the Address Book repeatedly without having to go through the network. If you want to update the Address Book contents from the network, choose the Update Remote command from the Address Book menu. This file is automatically deleted when the address book is deleted.

These type of remote address book is used in the same way as a local address book.  All addresses are displayed.


Delete

Lets you delete existing Address Books.  To do this:

1.	Open the Address Book from the Services menu or the Mail new message/article window.

2.	Select the book(s) you want to delete and choose the Delete command from the Address Book menu.

3.	Select the book(s) you want to delete and choose the Delete command from the Address Book menu.

4.	A dialog box prompts you to confirm you want to delete the name from the address Book list.

5.	With local address books a second dialog prompts you to decide if you want to delete the local file (.adb) from the hard drive. If an .adb file is deleted the information is removed permanently.


properties
Properties...

Lets you view and modify the properties of a an existing Address Book.  You can also modify the name of an Address Book and the file name (pathname).  To do this:

1.	Open the Address Book from the Services menu or the Mail new message/article window.

2.	Select the desired Address Book and then choose the Properties... command from the Address Book menu.

3.	A Properties dialog box appears that lists:

Local or Remote	The location of your address book.
Name	Enter the name you want to give to the new Address Book.  This will appear in the Address book list.
File(local)	The Address Book's path and filename.  You can enter the pathname directly or use the Browse button to browse for the selected drive and directory.  For a new address book, you will be prompted to confirm you want to create a new file.  This is only applicable for local address books. For an ECCO addressbook: choose the browse button, the Open dialog appears.  Change the file type in the drop down list to *.eco. Select the file from the list of all available ECCO files or type in a new file name.  Refer to ECCO Setup for more details. You cannot create a new .eco files from within address book, the .eco file you specified must already exist.
Host (remote)	The name of the host where the Address Book you want to access remotely is stored.
Protocol	Whois++ - For address books created to support Whois++ Z-Mail ODS  - For address books created using Z-Mail Pro.  See Setting Up Open Directory Service
Port	Default Port for Whois++ is 43 Default Port for Z-Mail ODS is 15213
Advanced	The Advance button shows additional options for remote address books.
Delimiter	A delimiter is used as a marker between the email address and freeform information (that is additional information, such as telephone numbers, address etc., entered by the system administrator).Any other characters that are used as a delimiter are entered here.
Search for Addresses	Addresses are searched for on the remote host, where the address book is located.  These addresses are not cached locally.
Download All Addresses	The Address book is downloaded to the local drive.  To update this address book choose Update Remote form the Address menu.
4.	Modify as required.


Copy To
Copy To...

Lets you copy one or more individual or group names from one Address Book to another.  To do this:

1.	Open the Address Book from the Services menu or the Mail new message/article window.

2.	Open the Address Book you want to copy from.

3.	Highlight the name(s) of individuals or groups you want to copy.

4.	Choose the Copy To... command from the Address Book menu to display the Copy Address To dialog box.

5.	Select the Address Book you want  the names and addresses copied into and choose the OK button.


Update Remote

Remotely stored Address Books can be cached in a local file (set through Properties) so you can repeatedly open the Address Book without having to go through the network.  If you want to update the Address Book contents from the network, choose the Update Remote command from the Address Book menu.


Add Name

Allows you add an individual or group to an Address Book.

To add an individual to an Address Book:

1.	Open the Address Book from the Services menu or the Z-Mail Pro/Forum new message/article window.

2.	Open the appropriate address book.

3.	Enter the user's name and e-mail address in the Search pattern or new name text box.  For example,

John Doe <john@netmanage.com.>

555-111@mcimail.com

71234.1234@compuserve.com

john@[156.27.10.107]

4.	Or enter the news group address in the Search pattern or new name text box.  For example,

<@news:rec.games.chess@news.netmanage.com>

You may also specify a news group address, without specifying a server name (the default server defined in Forum will automatically be used) in which case it should look as following:

<@news:rec.games.chess>

5.	Choose the Add Name command from the Edit menu, or the Add Name button  The name appears on the list and is automatically added to the Address Book.


Add Group

To add a group to the Address Book, do the following:

1.	Open the Address Book from the Services menu or the Z-Mail Pro/Forum new message/article window.

2.	Open the appropriate address book.

3.	Type the group name in the Search pattern or new name text box.

4.	Choose the Add Group command from the Edit menu, or the Add Group button.

5.	The Address list text box appears for you to add members to this group.  Enter or select the name and email address of the member you want to include in this group.  The right side pull down menu lists the different transports available, and the bottom text box lists the addresses available.  Select any address you require and choose the Add button, or double click on the name.

The selected names appear in the Group Members list.  All group names appear in the Address Book dialog box in square brackets.  For example, [groupname].

6.	Choose the OK button.

Select an individual name and choose the Members... command from the Edit menu to see if they belong to a group.

You may rename entries by selecting them and pressing the Rename button.  Select one or more entries and press the Delete button to remove them from the Address Book.  Addresses are automatically saved when you enter them.


Members
Members...

Lets you see:

•	All members who are assigned to a group, for example

Group [salesteam] has members mark@somewhere.com,  Bill@somewhere.com and Kenley@somewhere.else.com

•	All groups an email address is a member of, for example

Mark@somewhere.com is a member of [sales], [finance] and [swimteam]

To do this:

1.	Open the Address Book from the Services menu or the new message/article window.

2.	Open the desired Address Book.

3.	Select the group whose members you want to see or the email address whose group memebership you want to see.

4.	Choose the Members... command from the Edit menu.  A dialog box appears displaying the group name and its members or the email address and group names which the address is a member of.


Delete Name

Lets you delete an individual or group name from an Address Book.

To do this:

1.	Open the Address Book from the Services menu or the Mail new message/article window.

2.	Select the name(s) you want to delete.

3.	Choose the Delete Name command from the Edit menu.


ECCO Setup

The ECCO Setup option in the Address Book dialog is provided for the convenience of ECCO users.  If you have the ECCO software package on your system, you can add e-mail addresses from your ECCO phonebook into one of your Mail address books. You can choose to add all the e-mail addresses from your ECCO phonebook or only a selected set of addresses.  Do the following:

1.	Open the Address Book from the Services menu or the Z-Mail Pro/Forum new message/article window.

2.	Choose the Add New Book... command from the Address Book menu.

3.	Enter the following information:

Local or Remote	The location of your address book.
Name	Enter the name you want to give to the new Address Book, this will appear in the Address book list.
File(local)	Enter the Address Book's path and filename.  You can enter the pathname directly or choose the browse button, the Open dialog appears.  Change the file type in the drop down list to *.eco. Select the file from the list of all available ECCO files or type in a new file name. You cannot create a new .eco files from within address book, the .eco file you specified must already exist.
1.	Choose the ECCO Setup...command from the Settings menu.  The ECCO Setup dialog box is displayed.

2.	Enter the column name from your ECCO Address Book that contains e-mail addresses into the Field Name text box in the ECCO Setup dialog box.  The default is E-Mail, but the name should be the same, or blank.

Note:  	In releases prior to ECCO 3.0, the column name for e-mail addresses was an optional, user-specified field name in the ECCO phonebook.  Therefore, the name you enter in the Field Name text box depends on what you named the column in your ECCO phonebook.  For example, if the ECCO phonebook column name was “E-Mail”, enter “E-Mail” in the Field Name text box.

3.	In the Criteria drop-down list box, select All to add all the e-mail addresses from your ECCO Address Book to the Mail Address book. Or, scroll to select an alpha character to add only the addresses beginning with that character.

For example, if you want to include only e-mail addresses beginning with the letter B, select the letter B from the list.

Note:	To keep your Z-Mail Pro address book current, you must refresh your Z-Mail Pro address book copied from ECCO each time you update the ECCO address file.


Troubleshooting Address Book
Troubleshooting

If you experience difficulties using the Address book, refer to the following items:

Remote Address book:

•	If the remote Address book does not open verify that the correct protocol (Whois++ or Z-Mail ODS) and port are selected.

•	Make sure that the host name where the remote addressbook resides is correctly entered, and that you have access permissions.

•	If a dialog reports a failure to retrieve the remote address book, verify the directory server on the remote host is running.

•	If no names appear in the address list, enter a name into the  Search pattern text box, and choose the search button.

Note:  	If the option   “Search for Address” is selected, addresses in Remote address books are not displayed automatically. In this case, a  search string must be entered.  To change this option to “Download all Addresses”, choose Properties from the Address menu, and choose the Advance button.

•	If Additional information appears after the email address, enter the correct Delimiter In the Properties dialog ( advanced button) form the Address book menu.

ECCO Addressbooks:

•	If your ECCO addressbook does not initialize the ECCO program, choose Properties from the Address menu,  select the file and choose the brows button.  Ensure that the File type selected is *.ECO ( not *.ADB).  Select the ECCO Setup command from the Settings menu, and enter the appropriate information.  Refer to ECCO Setup for more detailed information.


Installing and Configuring the Z-Mail Pro Open Directory Service

Z-Mail Pro users have the option of using a remote centralized directory service. This directory service is a file of searchable email addresses (and other information) accessible only when connected to the network. Users can cache frequently used addresses by copying search results from the centralized address book to a local address book (using the address book’s Copy To… menu item).

Features of ODS

Installing an ODS Server

Configuring Your Directory Server Host

Configuring Z-Mail Pro's Address Book

Testing the directory service

Compose a message using the directory service

Advanced Settings for ODS

Samples


Features of ODS

A centralized address book allows you to:

•	Easily - keep the address book up-to-date by eliminating the need to modify numerous copies.

•	Save disk space on each user’s PC; large address books reside on a server.

•	Control contents; the  “read only” attribute allows only an administrator with server access to perform modifications.

•	Include additional information associated with each email address, such as phone number, office location, department and employee number. Users can then use this directory service as a telephone book and other services.


Installing an ODS Server

The following topics briefly describes the installation and use of directory services for Z-Mail Pro. A basic knowledge of UNIX networking and shell scripts is required.  Z-Mail Pro provides access to a directory service, not the directory service itself.  When a user requests a directory lookup, Z-Mail passes the request to a Directory Service (DS) residing on a UNIX (or other) machine.  Since the Directory Service is separate from Z-Mail Pro, you may use any directory lookup mechanism to validate or suggest e-mail addresses.

Configuring Your Directory Server Host

Testing Directory Services

Uninstalling Directory Services

At the end of this appendix are sample UNIX shell scripts that perform simple directory lookups. Also provided is a sample DS listener shell script that is launched by INETD when a DS request arrives on the UNIX host.

See Also

Configuring Z-Mail Pro's Address Book

Advanced Settings for ODS


Configuring Your Directory Server Host

You must have root (superuser) privileges to install directory services.  Complete the following steps:

1.	Choose one of the lookup.* scripts (or a script of your own) and copy it to your UNIX host. Usually, these scripts are kept in /usr/local/lib, but this location may vary according your host’s configuration.

2.	Put the DS listener script dirserv.d in /usr/local/etc, or in the directory where scripts are stored on your system.

3.	Edit the dirserv.d script to call the lookup script you have chosen (or pass it the name of the lookup script as it’s first argument by configuring INETD.conf properly. See step 4 below and  the Sample Lookup Request Dispatcher for details.)

4.	Add the following line to your /usr/etc/INETD.conf file; this starts the DS listener dirserv.d when a request arrives:

zmailds stream tcp nowait guest /usr/local/etc/dirserv.d

Note:  	You may want to add command line arguments to dirserv.d (including arg0, the full path of dirserv.d) in order to specify the lookup program from INETD.conf instead of hardcoding it in dirserv.d.

5.	Replace guest in the above line with a user name on your system that has the correct privileges to run dirserv.d, but no additional privileges. The guest user exists on many UNIX systems.

6.	Replace the path to dirserv.d in the above entry with the path to dirserv.d on your system.

7.	Add the following line to your /etc/services (or equivalent) file:

zmailds 15213/tcp zmaildsd # Z-Mail Address Lookup Service

8.	You can replace 15213 in the above entry with another port.  15213 is the Z-Mail Pro default and is unlikely to conflict with existing services at your site.

9.	Send a HUP signal to INETD to cause it to re-read INETD.conf (you may have to do this twice on some systems). To send a HUP signal, find the process-id of INETD and enter:

kill -HUP process-id

Directory services are now installed on your UNIX host.

See Also

Installing an ODS Server

Testing Directory Services

Uninstalling Directory Services

Configuring Z-Mail Pro's Address Book

Advanced Settings for ODS


Testing Directory Services

To test your directory services, use Telnet to connect to the port you specified in /etc/services on the UNIX host and query the server. For example:

1.	To Connect to the host enter:

telnet ds-host 15213

The response should be similar to the following:

Trying 192.0.1.1... Connected to ds-host. Escape character is '^]'.

If telnet displays the error message:

telnet: Unable to connect to remote host: Connection refused

recheck the parameters you entered in /etc/INETD.conf and /etc/services, and ensure you are connecting to the correct host and port. You may need to send another HUP signal to INETD.

2.	Query the server by entering an integer followed by the pattern to match (a regular expression).

For example, to search for no more than 10 matches for all addresses containing “bob” enter:

10 bob

The server response should be similar to the following:

bob@baker.com

bob@butcher.com

betty@bobbin.org

Connection closed by foreign host.

Once directory services are correctly installed, you must configure Z-Mail Pro to query the Directory Service host.

See Also

Installing an ODS Server

Configuring Your Directory Server Host

Uninstalling Directory Services

Configuring Z-Mail Pro's Address Book

Advanced Settings for ODS


Uninstalling Directory Services

To uninstall Directory Services from the UNIX host, complete the following steps:

1.	Delete (or comment out) the line in /usr/etc/INETD.conf that begins with zmailds. The line should look like the following:

zmailds stream tcp nowait guest /usr/local/etc/dirserv.d

2.	Delete (or comment out) the line in /etc/services that begins with zmailds. The line should look like the following:

zmailds 15213/tcp zmaildsd # Z-Mail Address Lookup Service

3.	Send a HUP signal to INETD. To send a HUP signal, find the process-id of INETD and enter:

kill -HUP process-id

Directory services are now uninstalled. It is not necessary to remove dirserv.d or the lookup script(s).

See Also

Installing an ODS Server

Configuring Your Directory Server Host

Testing Directory Services

Configuring Z-Mail Pro's Address Book

Advanced Settings for ODS


Configuring Z-Mail Pro's Address Book

After a directory service has been Installed, Configured and Tested you need to configure Z-Mail Pro.  First make a new address book, then test and use this address book.

Making a new address book

Testing the directory service

Compose a message using the directory service

See Also

Installing an ODS Server

Configuring Your Directory Server Host

Testing Directory Services

Advanced Settings for ODS

Samples for ODS


Making a new address book for ODS

 To make a new Address book complete the following steps:

1.	Start Z-Mail Pro

2.	From the Services menu, choose the Address Book… command.

3.	From the Address Book menu, choose the Add New Book… command.

4.	Select the Remote radio button.

5.	Enter a name for your centralized address book (e.g. Corporate).

6.	Enter the IP address or host name of the ODS server.

7.	Choose Z-Mail ODS as the protocol.

8.	Click on the Advanced button and choose the Search for Addresses button.

9.	If necessary (users should consult the administrator) change the field delimiter (under Advanced), so that it matches the delimiter specified by the lookup program (or the address book data in a flat file).

See Also

Testing the directory service

Compose a message using the directory service

Advanced Settings for ODS


Testing the directory service

To test that your Remote Address book can be accessed:

1.	Type in a search pattern string (e.g. bob)

2.	Choose the Search Remote button (all users with bob as part of their email address (or optional comments) should be displayed)

See Also

Making a new address book

Compose a message using the directory service

Advanced Settings for ODS


Compose a message using the directory service

You can now use your Directory Service Address book to address your mail:

1.	Choose the Compose button, or the New command form the Message menu

2.	Choose the Address… button

3.	Select the Corporate centralized address book

4.	Enter a search pattern

5.	Choose the Search Remote button

6.	Select an address from the search results

7.	Choose the To, Cc, or Bcc buttons to use the selected address

8.	Choose the Close button when finished addressing your message

Note:	 If “comment” information is being added to your message’s To, Cc, or Bcc header, check that your address book’s Delimiter (Advanced) property is set correctly.

See Also

Making a new address book

Testing the directory service

Advanced Settings for ODS


Advanced Settings for ODS

The script run from dirserv.d via the INETD port can perform numerous tasks, based on the script itself and the search criteria used. For instance you can use a set of "arg1" keywords that take different actions.

For example, use a keyword "online" which would trigger a shell or Perl script to perform a "who" command and then for each on those userids and map to a NIS or flat file alias list and pass the names and address back to Z-Mail.

It is possible to use this technique to access an online phone directory, show local majordomo mailing lists, show users at a given site, and so on.

Z-Mail Pro lets you set up multiple address books, so you can set up multiple Open Directory Service servers. If they are to run on the same host, just use different port numbers for each.

The server examples here are scripted in Bourne shell or Perl. For performance reasons, you may want to write your own server in C.

You are not restricted to using a flat file as your address database. You can adapt the examples to access whatever lookup mechanism you prefer (searching the password file (or NIS), sendmail’s alias file, querying a PH, X.500, or SQL server, etc.).

If you develop useful directory service enhancements, please share your ideas with the rest of the Z-Mail community by posting them to the comp.mail.zmail newsgroup.

See Also

Installing an ODS Server

Making a new address book

Samples for ODS


Samples for ODS

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

•	The dirserv.d script is a script used by INETD to listen for and launch directory server requests.

Sample Lookup Request Dispatcher, dirserv.d

•	The lookup.flat script is a script which can be launched by dirserv.d to search a user-supplied ASCII file.

Sample Lookup Service Program, lookup.flat

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

Sample Perl dirserv.d with Integrated Lookup Service

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.


Sample Lookup Request Dispatcher, dirserv.d

#! /bin/sh -

#

# dirserv.d  Z-Mail Open Directory Service support script

# Copyright (c) 1993-96 NetManage, Inc.

#

# This script listens on a socket for what is presumed to be

# a connection from a Z-Mail client requesting a directory

# service lookup. Dirserv.d runs a directory service program

# specified as its (optional) first argument and prints back

# to the socket first the exit status and then the output of

# the directory service (address lookup) program.

#

# The client needs to provide two parameters to this program via the

# socket. The first is an integer denoting the maximum number of

# matches to return. A value of -1 indicates no limit. (This parameter

# is given to the lookup service program “as is” and might even be

# ignored.) The second parameter is the search pattern, which is also

# passed to the lookup service “as is”. The “regular expression” syntax

# of the search pattern is defined by the lookup service.

#

# Z-Mail interprets the exit status of the directory service program

# as follows:

#    0 No problems, addresses that match are on standard output.

#    1 Execution failed for some reason, error message on standard

#      output or standard error.

#    2 More than the maximum number of addresses matched, error

#      message on standard output or standard error.

#    3 Incorrect number of arguments.

#    4 No addresses matched, original address on standard output.

#    5 One known-correct matching address on standard output.

#

# Setting up the socket connections is assumed to be handled by INETD.

# Modify your INETD.conf and /etc/services files to cause this script

# to be started when a connection arrives on port 15213.  Here's a

# sample INETD.conf entry:

#

#      zmailds  stream  tcp  nowait  guest  /usr/local/etc/dirserv.d

#

# Or if you wanted to explicitly specify the name of a lookup program:

#

#      zmailds  stream  tcp  nowait  guest  /usr/local/etc/dirserv.d \

#        /usr/local/etc/dirserv.d /usr/lib/Zmail/bin/lookup.flat

#

# And here's a sample /etc/services entry:

#

#      zmailds  15213/tcp   zmaildsd  # Z-Mail directory service

#####################################################################

#

# Default lookup service -- edit as necessary.

SERVICE="${1-/usr/lib/Zmail/bin/lookup.flat}"

CR=`echo | tr '\012' '\015'`

#

OUTPUT="${TMPDIR-/tmp}/zmODS$$"

# Obtain search probe from client (an integer and a search pattern)

read lookupmax pattern

# Strip trailing CR-NL if any

pattern="`echo \"$pattern\" | tr -d '\015\012'`"

"$SERVICE" "$lookupmax" "$pattern" > "$OUTPUT" 2>&1

# Send numeric result code and CR-NL on each line of the search results

(echo $? ; cat "$OUTPUT") | sed 's/$/'"$CR"/

rm -f "$OUTPUT"

See Also

Sample Lookup Service Program, lookup.flat

Sample Perl dirserv.d with Integrated Lookup Service


Sample Lookup Service Program, lookup.flat

#

# Z-Mail Pro directory lookup script to search flat files (both

# public and personal).

#

# The format of the files is simple:

#    Place one E-Mail address on each line.

#    Descriptive comments that should be displayed but NOT included in

#       the address headers may follow the address, separated by a

#       delimiter.

#       The delimiter that is selected must also be configured in the

#       Z-Mail Pro address book's "Advanced" property setting.

#

# Samples (assuming a delimiter of ';'):

#    "Mickey Mouse" <mickey.mouse@disney.com>;Our favorite cartoon

#    job@sackcloth.com;Job under the Juniper tree

#    herod@palace.jerusalem.il;Hateful Herod

#    joseph@egypt.com;Joseph our rags to riches hero

#

# The ADDRESSES environment variable can be used to reference a "public"

# address file. If it exists, a private $HOME/.addresses file will also

# be searched. For convenience, set ADDRESSES in dirserv.d before it

# invokes this script.

#

# Ensure sed, egrep, fgrep, wc are on your path.

#

if [ $# -ne 2 ]

then

    echo "`basename $0`: Expected 2 args, got $#"

    exit 3	# Incorrect arguments

fi

# Uncomment the line below if you want to prevent users from seeing the

# comment information associated with each email address.

#NO_COMMENT="TRUE"

# This field delimiter separates the email address from the comment and

# must match what the Z-Mail Pro client Address Book delimiter is set

# to.

# (Test this delimiter carefully, some characters (or strings) can cause

# problems.  Definitely don't use '&' '.' '!' '<' '>' '%' or '@')

DELIMITER=';'

matches=${TMPDIR-/tmp}/admatch$$

# If a global (public) address book is defined, search it

if [ -n "$ADDRESSES" ]

then

    if [ -n "$NO_COMMENT" ]

    then

        (egrep -i -e "$2" $ADDRESSES || \

         fgrep -i -e "$2" $ADDRESSES) | \

         # strip off the delimiter and comment field

         sed "s/\(.*\)${DELIMITER}\(.*\)/\1/" >> $matches 2>/dev/null

    else

        (egrep -i -e "$2" $ADDRESSES || \

         fgrep -i -e "$2" $ADDRESSES) >> $matches 2>/dev/null

    fi

fi

# If the user has a personal address book, search it

# (if we haven't already)

if [ -r $HOME/.addresses -a "$ADDRESSES" != "$HOME/.addresses" ]

then

    if [ -n "$NO_COMMENT" ]

    then

        (egrep -i -e "$2" $HOME/.addresses || \

         fgrep -i -e "$2" $HOME/.addresses) | \

         # strip off the delimiter and comment field

         sed "s/\(.*\)${DELIMITER}\(.*\)/\1/" >> $matches 2>/dev/null

    else

        (egrep -i -e "$2" $HOME/.addresses || \

         fgrep -i -e "$2" $HOME/.addresses) >> $matches 2>/dev/null

    fi

fi

count=`wc -l < $matches`

EXIT=1	# Execution failure

if [ $count -eq 0 ]

then

    echo "$2"

    EXIT=4	# No matches found

elif [ $count -gt $1 -a $1 -gt 0 ]

then

    echo "Matched $count names (max $1)"

    echo "Use a more specific pattern please."

    EXIT=2	# Too many matches

else

    cat $matches

    if [ $count -eq 1 ]

    then

EXIT=5	# Exactly one match

    else

EXIT=0	# At least one match

    fi

fi

rm -f $matches

exit $EXIT

See Also

Sample Lookup Request Dispatcher, dirserv.d

Sample Perl dirserv.d with Integrated Lookup Service


Sample Perl dirserv.d with Integrated Lookup Service

#!/usr/local/bin/perl

# Perl Open Directory Service routine for Z-Mail, adapted from the

# basic dirserv.d shell script.

#

# Search a text file of addresses for matching entries, then return

# no more than 100 matches.

#

# This script assumes $ADDRBOOK points to a file containing

# email addresses, one per line. E.g.

# joseph@egypt.com

# job@sackcloth.com

# herod@palace.jerusalem.il

#

# Location of address book data – edit as necessary

$ADDRBOOK = “/usr/local/zmail/addrbook.txt”

$total = 0;

($lookupmax, $pattern, $p1, $p2, $p3, $p4) = split(" ", <STDIN>);

$pattern =~ s/\./\.\*/g;

$pattern = $pattern.".*".$p1 if $p1 ne "";

$pattern = $pattern.".*".$p2 if $p2 ne "";

$pattern = $pattern.".*".$p3 if $p3 ne "";

$pattern = $pattern.".*".$p4 if $p4 ne "";

$pattern =~ s/\.\./\./g;

$pattern =~ s/\"//g;

open (DIR, '/usr/bin/grep -Ei "' . $pattern . '” '. $ADDRBOOK |');

while(<DIR>) {

    chop;

    if (m!$pattern!i)

    {

  $total++;

  if($total <= 100 || $total < $lookupmax)

        {

      push (@results,"$_");

      push (@results, "\r\n");

  }

    }

}

close(DIR);

if ($total == 0)

{

    print "4\r\n$pattern\r\n";

}

elsif ($total > 100)

{

    print "2\r\nMore than 100 matches found.\r\n";

    print "Please use a more specific pattern.\r\n";

}

else

{

    if ($total == 1)

    {

print "5\r\n";

    } else

    {

print "0\r\n";

    }

    foreach $entry (@results)

    {

print $entry;

    }

}

exit(0);

See Also

Sample Lookup Request Dispatcher, dirserv.d

Sample Lookup Service Program, lookup.flat