Contents
Forum Contents

This help file contains a list of all Help topics available for Forum.  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

Connection

Groups

Articles

Threads

Services

Settings

Go IntraNet!

Help

Menus for New Article window

Menus for View Article window


File
File menu

New Configuration

Open Configuration…

Save Configuration

Save Configuration As…

Print...

Print Setup...

Exit


Connect Disconnect
Connection menu

Go Online

Go Offline


Groups
Groups menu

Open Group

Retrieve More Articles

Retrieve All Articles

Subscribe...

UnSubscribe

Catch Up

Download Group

Delete Downloaded in Group

Show Group List


these may or may not be in this release

Set Group for Inbox Delivery     Inbox_Delivery>main

Unset Group for Inbox Delivery  Inbox_Delivery>main


Articles
Articles menu

View…

Reassemble Articles…

Post…

Reply to

Forward…

Save as Text...

Set as Read

Set as Unread

Mark Flagged

Clear Mark

Download

Delete Downloaded

Search Open Group

Search Server


Threads
Threads menu

Expand All \ Current

Collapse All \ Current

Display


Services
Services menu

Address Books…

Outbox…

Log…

Keys


Settings
Settings menu

Preferences...

Display Info...

Fonts...

Toolbar

Smart Buttons

Status Bar

Network Settings

Add Server Wizard


Help
Help menu

Diagnose Connection…

Contents

Tip of the Day

Tech Support Web Site Home Page

Tech Support Web Site, Application FAQ

Online Manual

Support Wizard

Register With Us

About Forum...

About NetManage


How to Use Forum

The Usenet

News Group Types

Using Forum

Login Directory

Configuring Forum with Wizard

Reading and Handling Articles

Posting and Replying to Articles

Addressing Articles

Viewing and Editing an HTML Article

Using the Outbox

Adding a Server with Wizard

Using the Discussion Button

Setting Forum as your default news reader

Additional Publications


Overview

The Forum program allows you to connect to News Servers in your local IntraNet environment or in the Internet (e.g. Usenet).

Note:	Forum in previous versions was called NEWTNews.

Forum allows you to:

•	connect to more than one news server

•	subscribe to newsgroups

•	read articles

•	post articles, containing HTML and attachments

•	work offline


Troubleshooting

If you experience difficulties using the Forum program, refer to the following items:

•	Make sure the host name to which you are trying to connect to and its profile information are correctly entered in the Network Settings dialog, and that the system administrator assigned you access permissions to that server.

•	If Forum reports a failure to connect, use the Diagnose Connection command from the Help menu, which will verify the connection to the remote host.

•	Verify that the Forum settings are correct and the timer settings for retrieval of new articles from the host are set appropriately.


Usenet
The Usenet

Usenet is a public forum for the exchange of ideas in the form of news articles that are broadcast to member sites.  News articles posted on Usenet are classified into news groups according to their subject matter.  The number of news groups available to you will be set by your system administrator.  The number of available groups is sometimes restricted to limit telephone traffic and disk space usage.

See Also

News Group Types


News Group Types

The names, types and groups of news groups in the local IntraNet, are determined by the System Administrator who sets up the groups on the IntraNet news server.

News groups in the Usenet (on the Internet) are divided into the following seven main categories or hierarchies:

News group	Description
comp	groups relating to some aspect of computer science (for example, comp.ai)
sci	groups relating to sciences other than computer science (for example, sci.physics or sci.math.symbolic)
news	groups relating to news software in general and the administration of Usenet news (for example, news.admin or news.announce)
rec	groups relating to recreational activities and hobbies (for example, rec.arts.sf-lovers or rec.games.chess)
soc	groups for social interaction or discussion of social topics (for example, soc.singles or soc.culture.)
talk	groups prone to extended heated discussion (for example, talk.religion or talk.politics)
misc	groups that do not fit into any of the other categories (for example, misc.jobs.offered for job postings)
There are also local news groups whose names begin with a distribution prefix that restricts the distribution of the news group to certain geographical areas or organizations.  For example, a prefix ca. in the news group “ca.wanted” indicates that it will only be distributed to sites in California.

In addition to the standard seven hierarchies, and local or regional groups, there are several alternative hierarchies.  These are created by groups of people who agree to carry and distribute these groups, independently of the standard hierarchies.  Some of the major hierarchies are:

Hierarchy	Description
alt	Short for alternative.  The original alternative hierarchy.  A major feature is that anyone may create any group they please.  Major groups include alt.gourmand, alt.aquaria, alt. sources and alt.binaries.
gnu	A set of groups devoted to the Free Software Foundations GNU project.
pubnet	Groups devoted to the interests of public access UNIX sites.
bionet	Groups devoted to the exchange of information on the biological sciences.


Login Directory

When logging into Forum, use the same name and password that you would for Mail.  The Directory dialog box appears.

If you are already logged into your NetManage mail application, the login pop up will not appear.  If this is the first time you are running Forum, enter a directory name and choose the OK button. Your downloaded articles and your Forum configuration files will be written to this directory.


Publications

Additional information is available through the following publications:

Horton, M.R.; Adams, Standard for interchange of USENET messages. RFC1036, 1987 December.

Kantor, B.; Lapsley, Network News Transfer Protocol. RFC 977, 1986 February.

Crocker, David H., RFC822:Standard for ARPA Internet Text Messages.


New
New Configuration

Choose the New Configuration command from the File menu to create a new configuration file and open it in Forum. The network settings, the preferences and the display settings are saved into configuration files.  Enter a filename for the new configuration file. This file will contain the default settings.

By default, each user has a configuration file - USER.CFG, in the user’s directory.  The nmnews.cfg file, in the NetManage directory, contains information about users who logged into Forum, and the name and location of their personal .cfg files.

Note:	When Forum is started, it automatically loads the previously used configuration.


Open
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 are loaded  from the opened file.

By default, each user has a configuration file - USER.CFG, in the user’s directory.  The nmnews.cfg file, in the NetManage directory, contains information about users who logged into Forum, and the name and location of their personal .cfg files.

Note:	When Forum is started, it automatically loads the previously used configuration.

To open an existing configuration file, do the following:

1.	Choose the Open Configuration 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.

3.	Choose the OK button.


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

By default, each user has a configuration file - USER.CFG, in the user’s directory.  The nmnews.cfg file, in the NetManage directory, contains information about users who logged into Forum, and the name and location of their personal .cfg files.

Note:	When Forum is started, it automatically loads the previously used configuration.


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

By default, each user has a configuration file - USER.CFG, in the user’s directory.  The nmnews.cfg file, in the NetManage directory, contains information about users who logged into Forum, and the name and location of their personal .cfg files.

Note:	When Forum is started, it automatically loads the previously used configuration.

To save a configuration file to a different name, do the following:

1.	Choose the Save Configuration As command from the File menu.

2.	Select or type in the file you want to save to.

If necessary, locate the desired file by selecting the appropriate drive and directory.

3.	Choose the OK button.


Print
Print ...

Choose the Print command from the File menu to send the selected article(s) to the printer. Verify that your printer is defined by Windows and connected before you attempt to print an article.


Print Setup
Print Setup...

Allows you to modify the printer configuration.

To modify the printer setup:

1.	Choose the Print Setup command from the File menu.

2.	Select either the default printer or a specific printer.

3.	Select Portrait or Landscape page orientation, paper size, and paper source.

4.	Choose the Options button to set graphics mode, half toning, and print quality.

5.	Choose the OK button.


Exit

Choose the Exit command from the File menu to exit the application. If you are currently Online, Forum first changes its state to Offline.

Note:	For each user, Forum stores the window settings (size and position) when the user exits. The next time you log into Forum, the window appears in the same location and size.


Go-Online
Go Online

Choose the Go Online command from the Connection menu to change the program to the Online state.  In this state a connection is created and maintained with all currently enabled servers (set in the Network Settings dialog), and all server operations are be enabled, such as retrieving new articles from server. You must have an Internet connection to Go Online.

Note:	Go Online and Go Offline are toggle commands.  The Go Online command is only available while Forum is in an Offline state.


Go-Offline
Go Offline

Choose the Go Offline command from the Connection menu to change the program to the Offline state. In this state, all connections to servers are disconnected, and no attempt to reconnect them is performed.

Note:	If you choose this command while Forum is in the middle of an activity, you are first prompted to confirm canceling the activity.

While in an Offline state, there you do not have a Internet connection. However,  you are still able to:

•	Read downloaded articles.  It is advised that while online you download any articles you want to read, and then you can access them Offline.

•	Post and create articles and reply to downloaded ones. Your articles are saved in the Outbox, and sent when you are Online again.

•	Subscribe to news groups.

Note:	Go Online and Go Offline are toggle commands.  The Go Offline command is only available while Forum is in an Online state.


Open Group

Open Group from the Groups menu opens the selected news group and displays its articles in the right pane.

When Online, the Open Group option retrieves group’s articles from the server. Once retrieved, the right pane displays the newly retrieved articles, and any previously retrieved or downloaded articles.

The number of articles retrieved when a news group is opened is determined by the Max auto retrieve option in the Newsgroups tab of the Preferences dialog ( from the Settings menu).

When a news group is already open and you wish to retrieve the next batch of articles from the server, use the Retrieve More Articles option from the Articles menu.

When Offline, the Open Group option displays the downloaded articles of the selected group, in the right pane.


Retrieve Next Articles
Retrieve More Articles

Retrieve More Articles from the Groups menu retrieves the next batch of articles for the current news group from the server.

This option is only available when already in a news group (i.e. when the news group is open). You use the option to access the server and retrieve more articles. Any additonal articles are retrieved and displayed in the right pane, along with any articles already displayed.

The number of articles retrieved is determined by the Max auto retrieve option in the Newsgroups tab of the Preferences dialog ( Settings menu).

Note:	The Retrieve More Articles option is available only when online.


Retrieve All Articles

Retrieve All Articles from the Groups menu retrieves all articles, for the current news group, from the server.

This option is only available when already in a news group (i.e. when the news group is open). You use the option to access the server and retrieve all the articles. All additional articles are retrieved and displayed in the right pane, along with any articles already displayed.

Note:	The Retrieve All Articles option is available only when online.


Subscribe
Subscribe…

To subscribe to a news group:

1.	Choose the Subscribe command from the Groups menu.  The Subscribe dialog box appears.

2.	Select the News Server you require.

3.	Select the appropriate radio button for the view you require of Non subscribed groups:

•	All: full list of news groups.

•	New: a list of the newest groups on the server.

Note:  	The list of the new groups is preserved locally and can be displayed at any time by choosing the New radio button. This list is recreated each time Forum performs a check for new groups on the server, either when Forum automatically checks for new groups on startup (if so set in the setting of that server set in the Network Settings) or when Update List is performed (see below).

•	Pull down list of hierarchies: a list of the groups is displayed according to the type of group selected from the pull donw list.

4.	If you know the name or part of the name of the newsgroups you want to subscribe to, then type text into the edit box above the list. The current list will be filtered according to what you enter.

5.	Once you locate the desired news group(s) to which you want to subscribe, highlight them and choose the right arrow (>) button.  To subscribe to all the groups in the non-subscribed list choose the Subscribe to All (>>) button. The selected groups will appear in the Subscribed groups list.

6.	Additional activities available in the Subscribe dialog in the Bring List  form Server section:

•	Rebuild  - choose the Rebuild button to connect to the server and retrieve the full list of all groups from the server. The groups will appear in the list of Unsubscribed groups (except those you are already subscribed to - which will appear in the list of Subscribed groups, on the right side).

Note:  	This operation may take several minutes - depending on the amount of groups on the server.

•	Update - choose the Update button to connect to the server and retrieve a list of all the new groups from the server. These groups will be added to your current list of Unsubscribed groups.

•	Stop - choose the Stop button to abort the Rebuild List or Update List operations.

7.	You may unsubscribe a group by highlighting it in the list of Subscribed groups and choosing the left arrow (<) button.  To unsubscribe all groups in the subscribed list choose the Unsubscribe All (<<) button.  Alternatively in the main dialog use the Unsubscribe command in the Groups menu.

8.	When you are finished, choose the Close button to update your subscriptions.  All subscribed groups, which have articles, will now appear on the Forum screen.


Unsubscribe

To unsubscribe or delete your subscription to a news group, do the following:

1.	Select the news group from which you want to unsubscribe.

2.	Choose the Unsubscribe command from the Groups menu.  The selected news group will disappear from the view.

Note:	You may also Unsubscribe through the Subscribe dialog.  This option is also available in a menu which appears when the mouse is located in the left pane area and the right mouse button is clicked.


Catch Up

Catch up sets all articles in a particular news group to the read status, even if you have not read any of them.

To set all the articles in a news group to the read status, do the following:

Select the subscribed news group on the left pane, then choose the Catch Up command from the Groups menu.  This automatically sets all the articles in this news group as read.

All read articles disappear when you exit the current news group.  There are a number of ways to stop read articles from disappearing.

Note:	This option is also available in a menu which appears when the mouse is located in the left pane area and the right mouse button is clicked.


Stop read articles from disappearing

All read articles disappear when you exit the current news group.  To stop read articles from disappearing from the news group upon exit, you can do any of the following:

•	Before closing the article, choose the Set as Unread command from the Articles menu.  This sets the article to the unread status (closed book icon) so it will appear the next time you open the news group.

•	Choose the Mark Flagged command from the Articles menu. The book icon of the article appears with a red mark. This indicates that the article is flagged and that it should not disappear from the news group.

•	Choose the Preferences command from the Settings menu and select the Show previously read articles option.


download
Download Group

Downloading articles lets you  read the articles at your own leisure when Offline. To download all the articles in a group, select the group from the left pane, and choose the Download Group command from the Groups menu. All the articles within the selected group are downloaded to your local drive. The articles are automatically downloaded to a directory structure in your Login Directory.  This option is also available in a menu which appears when the mouse is located in the left pane area and the right mouse button is clicked.

Note:	The regular icon of a group (appearing to the left of the group name) is a folder, whereas the icon of a group containing downloaded articles is of a folder with a small diskette on it.


Delete Local
Delete Downloaded In Group

Delete Downloaded In Group allows you to delete from your local drive, all the downloaded articles in that group.

To do this, select the group containing downloaded articles from the left pane, and choose the Delete Downloaded In Group command. All the articles within the selected group, which were downloaded on your local drive, are then deleted. This option is also available in a menu which appears when the mouse is located in the left pane area and the right mouse button is clicked.

Note:	The regular icon of a group (appearing to the left of the group name) is a folder, whereas the icon of a group containing downloaded articles is of a folder with a small diskette on it.


Show Group List

Show Group List from the Groups menu shows or hides the left pane listing the servers or subscribed groups.  Hiding this information enables more information to be displayed in the right pane.


View
View…

View allows you to view an article or a number of articles that you have selected.  To view a selected article:

1.	Select the title of the article you want to view, from the right pane of the main Forum window (you may select more than one article by holding down the Shift key while selecting the articles).

2.	Choose the View command from the Articles menu, or double-click on the selected article.

Note:	The title of the article you viewed now has the icon to the left of it, indicating that the article has been read.

All read articles disappear when you exit the current news group.  There are a number of ways to stop read articles from disappearing.


Reassemble Articles
Reassemble Articles…

Reassemble Articles allows you to view articles that you have received in multiple parts.

Since some servers and clients have or allow a limitation of the article size.  Articles exceeding that limitation are sent out in multiple parts, each given the same subject, but with an additional marking specifying what part it is of the original article, e.g. part 1 of 2 and part 2 of 2.

To view multiple part articles such as these, do the following:

1.	Select the titles of all the parts of the original article, from the right pane of the main Forum window (in order to select more than one article, hold down the Shift key while selecting the articles).

2.	Choose the Reassemble Articles command from the Articles menu.

3.	The assembled article appears in the view article window.

Note:	This option is also available in a menu that appears when the mouse is located in the right pane area and the right mouse button is clicked.


post
Post…

Allows you to create and post an article to a news group and/or send it to email addresses.

To post an article, do the following:

1.	Choose the Post command from the Articles menu.

2.	A compose window will open. The address of the current news group will automatically appear in the recipient list.

3.	You can add to or edit the recipient list. See Addressing articles for more information.

4.	The From field displays the address set in Mail network settings.

5.	Enter the subject and article text.

6.	Press the Send button or choose the Send command from the Article menu to send the article to the designated newsgroups or email addresses.


Followup Email
Reply to

Allows you to send a reply to the selected article.

There are various reply commands, each creates a different recipient list:

•	Newsgroups: all the news groups from the recipient list of the original article.

•	Current Newsgroup: the current news group.

•	Sender: the email address of the sender of the original article.

•	All: combines all the options above.

In all cases, you may edit and/or add to this list.

To reply to an article, do the following:

1.	Select the article title from the right pane of the main Forum window, or first view the article by double clicking on it.

2.	Choose the Reply to command you want from the Articles menu.

3.	A compose window opens, with the selected article inside (if so set in the Preferences). The text is left intact, with a separator indicating where the original article begins.

4.	The From field displays the address set in Mail network settings.

5.	You can add to or edit the recipient list as desired. See Addressing articles for more information.

6.	Type in your reply above the separator that appears before the original article.

7.	Press the Send button when you are ready to send the article.

8.	Closing the window or pressing the Cancel button dismisses the article.

Note:	When replying to an article in HTML editing mode, the header of the included original will contain a link to the original article.  The reader of your reply in Forum or in Z-Mail Pro can use this link to open the original article in its newsgroup context in Forum.


Forward
Forward…

Allows you to forward the selected article to newsgroups and email addresses.

To forward an article, do the following:

1.	Select the article title from the right pane of the main Forum window, or first view the article by double clicking on it.

2.	Choose the Forward command from the Articles menu.

3.	The selected article appears in a compose 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 newsgroups and addresses for forwarding. Type in the recipient list. See Addressing articles for more information.

5.	The From field displays the address set in Mail network settings.

6.	Type in your message above the separator that appears before the original article.

7.	Press the Send button when you are ready to send the article.

8.	Closing the window or pressing the Cancel button dismisses the article.

Note:	When replying to an article in HTML editing mode, the header of the included original will contain a link to the original article.  The reader of your forwarded article in Forum or in Z-Mail Pro can use this link to open the original article in its newsgroup context in Forum.


Save
Save as Text...

Allows you to save a desired article as a text file, in a chosen location.

To save an article do the following:

1.	Select or view the article, then choose the Save as Text command from the Articles menu to display the Save As dialog box.

2.	Enter the Drive, Directory, File Type, and Filename and choose the OK button.


Mark Read
Set as Read

Changes the status of the selected articles to read, whether you have read them or not.

Note:	All read articles disappear when you exit the current news group. There are a number of ways to stop read articles from disappearing.

To set articles as read, do the following:

Select or view the article, then choose the Set as Read command from the Articles menu (you may select more than one article by holding down the Shift key while selecting the articles).

Note:	The article now has an open book icon to the left of it, indicating that the article has been read.

To mark all articles in a particular news group as read use the Catch Up command from the Groups menu.

Note:	This option is also available in a menu which appears when the mouse is located in the right pane area and the right mouse button is clicked.


Mark Unread
Set as Unread

Changes the status of the selected articles to unread.  All read articles disappear when you exit the current news group.  To stop read articles from disappearing from the news group you can change their status to unread.

To set articles as unread, do the following:

Select or view the article, then choose the Set as Unread command from the Articles menu (you may select more than one article by holding down the Shift key while selecting the articles).

Note:	The article now has a closed book icon to the left of it, indicating that the article has not been read.

You can also stop read articles from disappearing by:

•	Choose the Mark Flagged command from the Articles menu. The book icon of the article appears with a red mark. This indicates that the article is flagged and that it should not disappear from the news group.

•	Choose the Preferences command from the Settings menu, and select the Show previously read articles option.

Note:	This option is also available in a menu which appears when the mouse is located in the right pane area and the right mouse button is clicked.


Set Flag
Mark Flagged

Sets a mark to selected articles so that even if they are read, they will not disappear from your news groups when you hide the read articles, nor when you exit.

To mark articles with a flag, do the following:

Select or view the article, then choose the Mark Flagged command from the Articles menu (you may select more than one article by holding down the Shift key while selecting the articles).

Marked articles appear with a red mark on their book icon.  Marked articles will not be available permanently.  Ask your system administrator to find out how long news is kept on the server.

You can also stop read articles from disappearing by:

•	Before closing the article, choose the Set as Unread command from the Articles menu.  This sets the article to the unread status (closed book icon) so it will appear the next time you open the news group.

•	Choose the Preferences command from the Settings menu and select the Show previously read articles option.

Note:	This option is also available in a menu that appears when the mouse is located in the right pane area and the right mouse button is clicked.


Clear Flag
Clear Mark

Removes the mark from the selected articles.

To remove a mark, do the following:

Select or view the article, then choose the Clear Mark command from the Articles menu.(you may select more than one article by holding down the Shift key while selecting the articles).

Note:	This option is also available in a menu which appears when the mouse is located in the right pane area and the right mouse button is clicked.


Download

Downloading articles lets you read the articles at your own leisure, when Offline. To download articles, do the following:

Select or view the article, then choose the Download command from the Articles menu (you may select more than one article by holding down the Shift key while selecting the articles).  The articles are downloaded to your local drive. The articles are automatically downloaded to your Login Directory.

The icon of downloaded articles has a picture of a small diskette on it, indicating the article is downloaded.

Note:	This option is also available in a menu that appears when the mouse is located in the right pane area and the right mouse button is clicked.


Delete Local
Delete Downloaded

Delete Downloaded allows you to delete downloaded articles from your local drive.

To do this, select the downloaded article or view it, and choose the Delete Downloaded command from the Articles menu (you may select more than one article by holding down the Shift key while selecting the articles). All articles within the selection which were downloaded on your local drive, will be deleted.

Note:	This option is also available in a menu that appears when the mouse is located in the right pane area and the right mouse button is clicked.


Search Open Group

The Search Open Group command from the Articles menu allows you to search for strings that are (or are not) part of the Subject or From field of the articles appearing in the currently open group.

Note:	You can perform more complex searches by searching the news server using the Search Server option. However, this option is only available if you are using a NetManage Forum Server.


Search Server

Search Server allows you to search your news server for articles according to the contents of various header fields of the articles, as well as according to the contents of the articles.  The number of results given for a single search might be limited by your news server administrator.  Usually you will get up to 500 results per search.

To perform a search on a server:

1.	Choose the Search Server command from the Articles menu.

2.	Enter the following:

•	Condition tab: enter the search criteria. You may enter complex criteria using the Advanced button. Advanced criteria may include several conditions combined using ANDs and ORs.

•	Location tab: select a server and news groups where to search.

Note:  	A server search is only available on NetManage Forum Servers. Consult your news server’s administrator for details.

3.	Choose the Go button. A list of articles matching the criteria will appear on the bottom of the window.

4.	Double-click on articles in the search results list to view them.

Note:	When using a 'contains' condition, only words starting with the given string will be found.


Expand Current
Expand All \ Current

The Threading display organizes the article listing so that all articles and their associated responding articles (RE: and FW:) are grouped together.

To display an article and its associated responding articles hierarchically:

1.	From the list of articles, select the desired article.

2.	Choose the Expand Current command from the Threads menu.

Note:  	Use Expand All if you want to expand all threaded articles for all articles in the news group.


Collapse Current
Collapse All \ Current

The Threading display organizes the article listing so that all articles and their associated responding articles (RE: and FW:) are grouped together.

To collapse the threaded articles of an article:

1.	Select the article whose expanded thread of articles you want to collapse.

2.	Choose the Collapse Current command from the Thread menu.

Note:  	Use Collapse All if you want to collapse all threaded articles for all articles in the news group.


Display

The Display command from the Threads menu toggles the Threading display off and on.  The Threading display organizes the article listing so that all articles and their associated responding articles (RE: and FW:) are grouped together.

Note:	You can easily toggle the threads display state by double-clicking on the header of the Subject/Thread column in the right pane of Forum.


Outbox

The Outbox command from the Services menu launches the Outbox program.

All sent articles first go to the Outbox. From there, they are sent to their destinations.  The Outbox attempts to deliver an article as soon as it receives it.  If the Forum program is in the Offline state, articles are stored in the Outbox until you go online again.

The Outbox includes all messages sent using Forum, Mail, Tag It, Phone Tag and meetings you schedule in NEWTCal.

For further information see the Outbox help.


Diagnose Connection
Diagnose Connection…

Use the Diagnose Connection command from the Help menu to start Ping and verify that the currently selected server is available.


View in HTML Mode

All articles can be viewed in HTML format within Forum. HTML viewing allows you to see attached image files as inline images, and to see URL links as you would if using a web browser.

To view articles in HTML format, do the following:

1.	Select the View in HTML mode option in the Edit/View tab of the Preferences dialog (Settings menu).

2.	View the article. The article will appear in standard HTML format.

Note:	The View in HTML command is a toggle. After opening an article in either text or HTML format, you may toggle to the other state by selecting the HTML Mode option in the View menu of the View window.

To view HTML documents that are referenced as a URL pathname within an article, do the following:

1.	Open the article that contains the URL reference in HTML viewing mode - as described above.

2.	All URL links in the article will appear highlighted in blue.

3.	Click on a highlighted URL to directly link to its web page.  The link may be opened either inside the view window, or using the NetManage WebSurfer , according to the settings in the Misc tab in the Preferences dialog ( Settings menu).

The HTML viewing mode is automatically used when viewing articles with the HTML text type defined in their header (such as HTML articles posted from Forum or from NetManage WebSpider).


Edit in HTML Mode

To post an article in HTML format, do the following:

1.	Select Edit in HTML mode in the Edit/View tab of the Preferences dialog ( Settings menu).

2.	Select Post from the article menu, or the Post button.

3.	WebSpider is automatically launched for Windows 3.1. Write and format your article in the WebSpider window.  When you have finished the article choose the WebSpider Send button, or Send as Mail from the services menu.  The HTML document is placed in the New Article window.  Post the article in the normal way.

Note:	HTML is created, viewed and edited inline for Windows 95/NT.


Preferences
Preferences...

You can set preferences to control which articles you want to read and how they should be displayed.

The Preferences command from the Settings menu  has seven tabs:

Posting

Edit/View

Misc

International

Reply

Personal Info

Newsgroups


Inbox Delivery Inbox_Delivery>main


Preferences Posting
Posting

To set options for how to post articles, from the Setting menu choose Preferences, select the Posting tab and enter the following information:

Preference	Description
Close window after posting	Close the Edit window immediately after posting the article.
Confirm on exit without sending	Brings up a confirmation pop up when exiting a edit window that contains an article that has not been sent.
Include original in reply	Includes the original article when replying to an article.
Indent included message	Indents the included original in replies and forwarded articles using angled brackets.
Reply/Forward in original format (HTML/text)	Automatically sets the editing mode when replying or forwarding to be the same mode as that of the original message, overriding the default set in the Edit/View preferences tab
Attach signature	Attaches a signature to created articles. The signature used is the one set in NetManage Z-Mail Pro.
Attach personal icon	Attaches a personal icon to created articles.  The personal icon used is the one set in NetManage Z-Mail Pro.
Convert line break to CRLF	Converts line breaks into carriage return/line feed (new lines).
Bcc to myself	Sends a copy of each sent article, to your email address.  This option is useful for keeping track of all Forum outgoing articles.


Preferences Edit/view
Edit/view

To set options for how to view, create, reply or forward articles, from the Setting menu choose Preferences, select the Edit/view tab and enter the following information:

Preference	Description
Edit Window
No word wrap	The line will continue, until a new line is entered.  A scroll bar appears when the line is longer than the window.
Word wrap to window size	The line will wrap according the width of the window.
Word wrap to line length of (chars)	The line will wrap according to the number of characters set.
Edit in HTML mode	Compose articles using HTML editing.
View Window
No word wrap	The line will continue, until a new line is entered.  A scroll bar appears when the line is longer than the window.
Word wrap to window size	The line will wrap according the width of the window.
Word wrap to line length of (chars)	The line will wrap according to the number of characters set.
View in HTML mode	Displays articles using HTML viewing
Use a single view window	Only one view window will be open at a time.  When you open another article, it will replace the article in the current window.


Preferences Misc
Misc

To set options for deletion confirmation, loading outbox and viewing articles, from the Setting menu choose Preferences, select the Misc tab and enter the following information:

Preference	Description
Confirm on delete recipients	Recipient deletion operations in the Post window require a confirmation
Startup - Load Outbox	The Outbox is opened when Forum starts
View Article
Show header of article	Displays the full header in the article, including the article ID.
View UUEncoded files as attachments	Automatically displays UUEncoded files as article attachments.
Navigate using browser	In HTML view, follow URL links using your default Web browser.


Preferences International
International

To set options for how to handle characters, from the Setting menu choose Preferences, select the International tab and enter the following information:

Preference	Description
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	The NRC has supports 12 languages including USASCII. NRC is a method that partially solves multinational character problem in 7 bit mode.  It replaces some of the ASCII characters to the specified language's characters.  Therefore, in this mode, characters such as  #,@,[,\,]..can not be used.
8-Bit ANSI	Transfers all 8-bit characters to 8-bit characters only.


Preferences Reply
Reply

To set options for how to reply to articles, from the Setting menu choose Preferences, select the Reply tab and enter the following information:

Reply button behavior	Select which Reply option to be used by the Reply button on the toolbar
Preference	Description
Reply to newsgroups	Reply to all the newsgroups where this article was posted.
Reply to current newsgroups	Reply only to the newsgroup where you viewed the article
Reply to sender	Reply only to the sender who posted the article.
Reply to all	Reply to the sender, and all newsgroups.


Preferences Personal Info
Personal Info

To set information in the article header, from the Setting menu choose Preferences, select the Personal Info tab and enter the following information:

Preference	Description
Reply-To address	Inserts as the Reply-To field in the header of created articles. When the article is replied to, this field is used as the reply address.
Organization	Inserts as the Organization field in the header of created articles.


Preferences Newsgroups
Newsgroups

To set options for displaying and retrieving newsgroups, from the Setting menu choose Preferences, select the Newsgroups tab and enter the following information:

Preference	Description
Hide empty groups	Hides the news group if all articles in it are read.
Show previously read articles	Displays all articles, both read and unread articles.
Max auto retrieve (articles)	Sets the maximum number of articles that will be retrieved from the server, for the current news group, when choosing the Open Group or Retrieve More Articles commands from the Groups menu.
Max download time (min)	Sets maximum time for downloading articles.
Threads display field	The field (From or Subject) to be displayed in threads.


Wrap
Word Wrap

Describes when a sentence is continued on to the next (lower) line and not on the same line.


set display info
Display Info...

Allows you to select what information you want displayed regarding news group articles.  Selections include:  Status, From, Subject, Article Number, Date Sent, and Number of Lines

You can choose to have the information in the above options sorted by ascending or descending order.

You can also set sort option by:

•	Double-clicking on the column to you want to sort

•	Double-clicking on the arrow to the right of the column headings.


Fonts
Fonts...

Set the font type, style (including bold and italic), size and width of the text of an article.

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.


log
Log...

Allows you to diagnose client and host transmission problems.  You can use the Log for debugging purposes by saving data that is transferred between the news servers and Forum, into a file.

To Log data, choose the Log command from the Settings menu.  Use the following buttons as required:

•	Start: starts logging, or the Stop button to stop logging.

•	Save: saves the contents of the log window to the *.log file.

•	Print: prints the contents of the log window.

•	Copy: copies the contents of the log window onto the clipboard.

•	Clear: clears the log window.

•	Close: closes the Log dialog box.


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

Choose the Smart Buttons command from the Settings menu to display toolbar icons, including each icon's description.


Status Bar

Choose the Status Bar command from the Settings menu to display or hide the application's status bar, where messages and statistics are displayed.


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 Forum
About Forum...

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

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

Choose the OK button to continue.


Using Forum

To use Forum:

1.	Choose the Forum or NEWTNews icon.

2.	Log into Forum using the same name and password which you would use for mail.

If you are already logged into a NetManage mail application, the login pop up will not appear.

3.	If this is the first time you are using Forum, the Forum Configuration Wizard will guide you through the easy steps of configuring Forum.

4.	You are automatically connected to the enabled Servers specified in the news tab of the Network Settings dialog box.  If there are no active servers specified, select Network Settings from the Settings menu and enter the appropriate information.  The groups you are subscribed to are displayed.  If you are not subscribed to any groups, select subscribe from the Groups menu and subscribe to news groups.

Whenever there are no servers defined, or none of the defined servers are active, or no subscribed newgroups exist for a server, a Forum popup tip outlines the required above step.

5.	To view the articles in a group, select the group and either double click on it or choose the Open Group command from the Groups menu.

6.	You may view  existing articles, or post and reply to articles.

7.	You may toggle the Forum connectivity state, by choosing the Go Online and Go Offline commands.


Handling Articles
Reading and Handling Articles

To list and view the articles in a news group, do the following:

1.	Select the news group whose articles you want to view.  Shown next to each news group are the number of unread articles and the total number of articles.  To sort the news group of each server by group name or by the number of articles, double-click on the header of the appropriate column in the newsgroups list.

2.	Choose the Open Group command from the Groups menu or double-click on the group. The articles will appear in the right pane of the Forum window.

3.	The Threading feature organizes the article listing so that all articles and their associated responding articles (RE: and FW:) are grouped together.  To toggle the thread display mode, use the Display option under the Threads menu, or double-click the header of the Subject/Thread column in the list of articles.  You can display an article and its associated responding articles hierarchically by selecting the Expand All/Current command or double-clicking on the thread.  Use Expand All only if you want to expand all threaded articles.  If you want to hide all the responding articles hierarchically, then select the Collapse All/Current.

Note:  	When displaying threads, for each article you can view either the subject or the From address according to your setting in Newsgroups tab of the Preferences dialog ( Settings menu). When displaying the subject, all articles with a subject equal to the one in the thread’s first article will be indicated by showing “...” instead of the original subject.

4.	To change the column by which the articles are sorted, double-click the column header.  To change the sort order (ascending/descending), double-click the blue arrow.  You can also change the sort order by using the Display Info dialog.

5.	Select the article(s) you want to view and choose the View command from the Articles menu or double click the article.

6.	After you read the article, choose the Exit command from the File menu to close the article and return to the main screen.

Note that an open book icon appears to the left of a previously read article.

Use Catch Up to mark all articles in a particular news group as read, even if you have not read them all.  All read articles may disappear when you exit the current news group.  There are a number of ways to stop read articles from disappearing.


Posting Articles
Posting and Replying to Articles

You may post articles to newsgroups and email addresses.  The following options are available:

•	Post: Send an article to the selected news group.

•	Reply to: Send a reply to the selected article, you have a choice of different recipients: Newsgroups, Current Newsgroup, Sender and All.

•	Forward: Forward the selected article.


Addressing articles

You may address your article as follows:

•	By manually entering the address, using the boxes above the recipient list:

•	Select the news from the first pull down list.

•	Select To, Cc, or Bcc from the pull down list in the middle.

•	Enter the news group or e-mail address in the text box. When specifying a news group you may also specify the server name (place an @ sign after the news group and then specify the server name). If no server is specified, the Default Server, set in the Network Settings  dialog will be used.

•	By selecting an address from the address books.  Choose the Address button on the compose window to display the Address Book dialog box containing the 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.

Note:	The full format used for news group addresses is as following:

<@news:{news_group_name}@{news_server}>

for example:

<@news:rec.games.chess@news.netmanage.com>

You may also specify a news group address, without specifying a server name, in which case it should look as following:

<@news:{news_group_name}>

For such addresses the Default Server will be used (specified in the Network Settings dialog).


Inbox Delivery

The Inbox Delivery Agent screens new Forum articles from selected news groups for delivery to your Z-Mail Pro Inbox.  To turn this feature on or off, select Set Group for Inbox Delivery or Unset Group for Inbox Delivery in the Group Menu.

To setup the delivery, select Inbox Delivery Tab in the Preferences command of the Settings menu.  Complete the three sections

1.	Enter the hours and minutes fields for how often you wish the system to check for new articles.

2.	You may have new articles forwarded to you either through your Email address or placed directly in your inbox.  Choose either the Email button or Inbox button.  Only one will be active.  If you choose Email address, enter an address to which you would like the article mailed.  If you choose Inbox of, select a user into who's inbox the message will be placed.

3.	Choose if you want  to launch the Delivery Agent when you launch Windows.  The Delivery Agent will be placed in your Windows Startup group.  If you do not choose this option, and you have groups set for Inbox Delivery, the Delivery Agent will be launched whenever you start Forum.


Setting Forum as Your Default News Reader

When you open Forum you may set Forum to be your default Windows news reader.  Windows uses the default news reader whenever you click on a URL that links to a news article, a newsgroup, or a news server.  Setting Forum as your default reader means that Forum will show the appropriate news group or article whenever you click on such a URL.


Adding a Server with Wizard
Adding a Server with a Wizard

The Add Server Wizard, from the Settings menu, lets you easily add a new server to your Forum configuration.

You may enter only the host name or IP address of the news server.  This also will be used as the server profile name.

Alternatively, you may use the "Advanced >>“ button to enter the full details of the server in the Add Server Profile.

Note:	You may also add new servers, or see the list of all the defined servers, by using the Servers toolbar button or the Network Settings option under the Settings menu.


Configuring Forum with a Wizard

The Forum Configuration Wizard enables you to easily define your personal configuration before using Forum for the first time.  Follow the instructions in the Configuration Wizard and enter the required information on each screen.  To advance to the next screen use the Next button.  All the information you enter will be saved in your configuration file and will be used when you run Forum.

Though some of this information is used by Z-Mail Pro, additional information is required to read messages. Add this information either immediately after configuring Forum with the wizard, or using the Internet tab of Network Settings from the Setting menu in both Z-Mail Pro or Forum.


Whats New Forum
What’s New

Forum in Z-Mail Pro version 6.1 contains the following new and enhanced features:

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

•	The Forum Configuration Wizard allows you to quickly configure your Forum settings and start exploring news groups in no-time. The new Add Server Wizard and the easy-to-use Subscribe dialog help you add new servers and groups quickly and easily.

•	The Forum Discussion button provides you with the opportunity to view the same article in all of the different newsgroups where it was posted, and follow the threads.

•	You can set Forum as your default Windows news reader.

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

•	A Reply/Forward in Original Format (HTML/Text) option helps you remain compatible with the articles you read in Forum.

•	Forum now uses your default Web browser for navigating through the World Wide Web. You can also navigate in your view window without opening a Web browser at all.

•	Attachments may now be zipped or encrypted, see Attachments - New.

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

•	A Reply to all recipients button has been added to the Toolbar when viewing an article.

•	A blue triangle button allows you to collapse the header information of viewed articles for more viewing space.


and, if it gets in:

•	Inbox Delivery Agent option automatically forwards new Forum articles from your favorite news groups to your Z-Mail Pro Inbox.


Tip of the Day

Tip of the Day gives useful tips about how to use Forum in an easy, efficient and enjoyable way. To see the Tip of the Day window whenever you start Forum, select this option at the bottom of the Tip of the Day window.

The Tip of the Day window has the following buttons:

•	Tell me more - to get more details about the current tip.

•	Help contents - to see the Forum help file contents.

•	Next tip - to see the next Tip of the Day.

•	Close - to close this window.


Print
Print...

Choose the Print command from the File menu to send the article to the printer. Verify that your printer is defined by Windows and connected before you attempt to print a article.


Print Setup
Print Setup...

Allows you to modify the printer configuration.

To modify the printer setup:

1.	Choose Print Setup from the File menu.

2.	Select either the default printer or a specific printer.

3.	Choose the OK button.


Menus for New Message/Article window
Menus for New Article window

File menu

Edit menu

View menu

Article menu

Attachments menu

Insert menu

Format menu

Table menu

Tools menu

Go IntraNet!

Help menu


Article
Article (New Article window)

Send

Save to File...

Append to File...

Include Images

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

Encrypt Text

Decrypt Text


Help
Help (New/View Article window)

Contents

About Forum


About Forum

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

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

Choose the OK button to continue.


Menus for View Message/Article window
Menus for View Article window

File menu

Edit menu

View menu

Article menu

Attachments menu

Go IntraNet!

Help menu


Edit menu
Edit menu (View Article window)

Copy

Save ‘From’ Address

Save Recipient Addresses

Find...

Find Next..

Select All


Article menu
Article menu (View Article window)

Reply to

Forward...

Save to File...

Append to File...

Set as Unread

Mark Flagged

Download

Delete Download

Decrypt Text

Uudecode

Proxy Settings...


Reply to

Allows you to send a reply to the open article.

There are various reply commands, each creates a different recipients list:

•	Newsgroups: all the news groups from the recipient list of the original article.

•	Current Newsgroup: the current news group.

•	Sender: the email address of the sender of the original article.

•	 All: combines all the options above.

In all cases, you may edit and/or add to this list.

To reply to an article, do the following:

1.	Choose the Reply to command you want, from the Articles menu.

2.	An Edit window will open, with the original article included in it (if so set in the Preferences). The text is left intact, with a separator indicating where the original article begins. If the message is in HTML  Edit mode, refer to the topic, editing HTML Documents.

3.	You can add to or edit the recipient list as desired. See Addressing articles for more information.

4.	The From field displays your email address, as set in Mail network settings.

5.	Type in your reply 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.

You can also use the Reply button from the toolbar, the recipients that will be listed are set in Preferences.

If you want the original article to be included in the reply article, select Insert original in reply checkbox in the Preferences dialog.


Set as Unread

Changes the status of the selected articles to unread.  All read articles might disappear form the list when you exit the current news group (if so see in Preferences).  To stop read articles from disappearing from the news group you can change their status to unread.

To set articles as unread, do the following:

Select or view the article, then choose the Set as Unread command (you may select more than one article by holding down the Shift key while selecting the articles).

Note:	The article now has a closed book icon to the left of it, indicating that the article has not been read.

You can also stop read articles from disappearing by doing the following:

•	Choose the Mark Flagged command from the Articles menu. The book icon of the article appears with a red mark. This indicates that the article is flagged and that it should not disappear from the news group.

•	Choose the Preferences command from the Settings menu, and select the Show previously read articles option.

Note:	This option is also available in a menu that appears when the mouse is located in the right pane area and the right mouse button is clicked.


Mark Flagged

Sets a mark to selected articles so that even if they are read, they will not disappear from your news groups when you hide the read articles, nor when you exit.

To mark articles with a flag, do the following:

Select or view the article, then choose the Mark Flagged command (you may select more than one article by holding down the Shift key while selecting the articles).

Marked articles appear with a red mark on their book icon.  Marked articles are not available permanently.  Ask your system administrator to find out how long news articles are kept on the news server.

You can also stop read articles from disappearing by:

•	Before closing the article, choose the Set as Unread command from the Articles menu.  This sets the article to the unread status (closed book icon) so it will appear the next time you open the news group.

•	Choose the Preferences command from the Settings menu and select the Show previously read articles option.

Note:	This option is also available in a menu which appears when the mouse is located in the right pane area and the right mouse button is clicked.


Download

Downloading articles enables reading the articles at your own leisure, when working Offline. To download articles, do the following:

Select or view the article, then choose the Download command (you may select more than one article by holding down the Shift key while selecting the articles).  The articles will be downloaded to your local drive. The articles are automatically downloaded to your Login Directory.

The icon of downloaded articles has a picture of a small diskette on it, indicating the article is downloaded.

Note:	This option is also available in a menu which appears when the mouse is located in the right pane area and the right mouse button is clicked.


Delete Download
Delete Downloaded

Delete Downloaded allows you to delete downloaded articles from your local drive.

To do this, select the downloaded article or view it, and choose the Delete Downloaded command (you may select more than one article by holding down the Shift key while selecting the articles). All articles within the selection which were downloaded on your local drive, will be deleted. The articles might still be available for reading from the news server.

Note:	This option is also available in a menu which appears when the mouse is located in the right pane area and the right mouse button is clicked.


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. See Addressing articles for more information.

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.


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.


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

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

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


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.