Liren Large Software Subsidy 11/11.iso/n/n007/22.ddi/USER.TXT

Text File | 1993-07-31 | 74.5 KB | 2,045 lines

_________________________________________________________________

FirstMail

_________________________________________________________________



Novell, Inc. makes no representations or warranties with respect
to the contents or use of this manual, and specifically disclaims
any express or implied warranties of merchantability or fitness
for any particular purpose. Further, Novell, Inc. reserves the
right to revise this manual and to make changes to its content,
at any time, without obligation to notify any person or entity
of such revisions or changes.

Further, Novell, Inc. makes no representations or warranties with
respect to any NetWare software, and specifically disclaims any
express or implied warranties of merchantability or fitness for
any particular purpose. Further, Novell, Inc. reserves the
right to make changes to any and all parts of NetWare software,
at any time, without any obligation to notify any person or
entity of such changes.

Novell, NetWare and the N design are registered trademarks and
FirstMail, NetWare Basic MHS, NetWare MHS, NetWare Loadable
Module, and NLM are trademarks of Novell, Inc.

FirstMail(tm) v1.0, copyright 1993, Novell, Inc. Portions
Copyright (c) 1990-1993, David Harris.



LIST OF TOPICS



1.0 INTRODUCTION

   1.1 What You Should Know Before Using FirstMail

      1.1.1 Conventions and Terms

      1.1.2 General Rules for Using FirstMail

      1.1.3 Assistance Features

   1.2 Starting FirstMail

   1.3 Quitting FirstMail

2.0 GETTING STARTED USING FirstMail

   2.1 Composing and Sending Messages

      2.1.1 Addressing Your Message

         2.1.1.1 Address Format

         2.1.1.2 SMF Long and Short Names Used in Addresses

            2.1.1.2.1 SMF Long Names

            2.1.1.2.2 SMF Short Names

      2.1.2 Composing Your Message

      2.1.3 Specifying Who Should Receive a Copy

      2.1.4 Sending Your Message

   2.2 Reading, Replying to, Forwarding, and Printing Messages

      2.2.1 Reading Your Messages

      2.2.2 Replying to Messages

      2.2.3 Forwarding Messages

      2.2.4 Printing Messages

   2.3 Organizing and Storing Your Messages in Folders

      2.3.1 Changing Folders

      2.3.2 Adding, Renaming, and Deleting Folders

      2.3.3 Copying and Moving Messages to Different Folders

      2.3.4 Deleting Messages from a Folder

      2.3.5 Changing the Order of Messages in a Folder

   2.4 Using Distribution Lists

      2.4.1 Creating DLists

      2.4.2 Addressing Messages to DLists

   2.5 Using Address Books

      2.5.1 Creating, Deleting, and Renaming Address Books

      2.5.2 Adding Entries to Address Books

      2.5.3 Editing Entries in Address Books

      2.5.4 Using Address Books When Addressing Messages

      2.5.5 Using the Quick Lookup Key

3.0 ADVANCED FEATURES

   3.1 Sending Attached Files with Messages

   3.2 Sending Files from a DOS Prompt

   3.3 Using Keystroke Macros

      3.3.1 Recording Macros

      3.3.2 Playing Back Macros

   3.4 Locating Text in Messages

   3.5 Using the Scratch Pad to Keep Notes

   3.6 Saving the Contents of a Message to DOS File

   3.7 Passing Messages to DOS Commands

4.0 SETTING PREFERENCES

   4.1 Changing Settings from the Preferences Menu

      4.1.1 "Copy-Self Settings" Option

      4.1.2 "Editor and Keyboard Settings" Option

         4.1.2.1 Setting the "Default editor right margin" Field

         4.1.2.2 Setting The "Default commenting string" Field

         4.1.2.3 Setting the "Editor string" Field

         4.1.2.4 Setting the "Scratch area" Field

         4.1.2.5 Setting the "Always use external editor" Field`

         4.1.2.6 Setting the "Keyboard layout" Field

      4.1.3 "General Settings" Option

         4.1.3.1 Setting the "Personal name" Field

         4.1.3.2 Setting the "Dflt reply-to" Field

         4.1.3.3 Setting the "Require password at startup" Field

         4.1.3.4 Setting the "Preserve deleted messages?" Field

         4.1.3.5 Setting the "Swap out when calling DOS" Field

         4.1.3.6 Setting the "Working directory" Field

         4.1.3.7 Setting the "Address only in browser" Field

         4.1.3.8 Setting the "Suppress print dialog" Field

         4.1.3.9 Setting the "Automatically open new mail" Field

         4.1.3.10 Setting the "Leave read new mail new" Field

      4.1.4 "NetWare SMF/MHS Settings" Option

         4.1.4.1 Setting the "My SMF/MHS username" Field

         4.1.4.2 Setting the "My SMF/MHS mailbox name" Field

         4.1.4.3 Setting the "My application name" Field

         4.1.4.4 Setting the "Scan the MHS user dir?" Field

      4.1.5 "Change Home Mailbox Location" Option

      4.1.6 "Print Settings" Option

      4.1.7 "Edit or Create Signatures" Option

   4.2 Message Options for Individual Messages

      4.2.1 Including a "CC" Header (Carbon Copy)

      4.2.2 Including a "BCC" Header (Blind Carbon Copy)

      4.2.3 Including a "Reply-to" Header

      4.2.4 Setting the "Keep a copy?" Option

      4.2.5 Setting the "Confirm reading" Option

      4.2.6 Setting the "Confirm delivery" Option

      4.2.7 Setting the "Urgent message" Option

5.0 COMMAND REFERENCE: INTERNAL-EDITOR COMMANDS

   5.1 Movement Commands

   5.2 Block and File Commands

   5.3 Search and Replace Commands

      5.3.1 Searching for a Regular Expression

      5.3.2 Setting Search Options

   5.4 Other Editor Commands



1.0 INTRODUCTION

FirstMail is an electronic mail utility that lets you compose and
send messages to other users on your server. The following
sections describe how to use FirstMail, including how to start
and quit FirstMail; get on-line help at any time; write, send,
read, reply to, forward, or print a message; organize and store
your messages; and use FirstMail's advanced features.



1.1 What You Should Know Before Using FirstMail

The following sections describe what you need to know before you
start using FirstMail.



1.1.1 Conventions and Terms

This manual uses the following conventions and terms:

<key_name> - Key name enclosed in angle brackets indicates one or
more keys you must press to perform the task described in the
related text. For example, <F10> means press the F10 key, <Delete>
means press the Delete key, and <Alt+A> means hold down the Alt
key and press the A key.

Variables - Variables representing filenames, addresses, or other
information that you must supply are enclosed in angle brackets.
For example, if this manual specifies the syntax of a line that
you must add to a file, such as "\title <name_of_dlist>", you
would replace <name_of_dlist> and add a line similar to the
following: "\title SALESDEPT".

Menu - A menu is a list of options from which you can choose.

Headers - Electronic mail messages are divided into two parts;
headers and message body; the headers are special lines at the
start of the message that contain information about the messages
(such as addressing information). For example, the "To" header
specifies the recipient's address and the "Subject" header
briefly describes the contents of the message.

Field - A field is an area of the screen where the program
expects you to enter text; you can normally identify the
current field by the pair of square brackets that appear when
your cursor is in that field. Fields are only one line long,
and often accept only certain types of data, including
addresses, numbers, or filenames. Many fields in FirstMail
accept more data on one line than can be displayed on the
screen; when this occurs, an arrow replaces the bracket at the
end of the field indicating that the information continues in
the direction indicated by the arrow. Using the <Left-arrow>
and <Right-arrow> keys, you can scroll through the field.

Folders - A folder is a mail file where you can organize and
store your messages (just as you sort papers into different file
folders); FirstMail provides a "Main" folder and automatically
puts messages there after you read them.

Filenames - Filenames that you specify in FirstMail can have up
to eight alphanumeric characters (A-Z, a-z, and 0-9) and follow
the DOS naming conventions. Do not use special characters, such
as the backslash (\) or the asterisk (*) in filenames, and do
not use spaces. You can specify a file in another directory
using either the DOS path syntax (d:\<path>\<filename.ext>), or
the full NetWare syntax (volume:<dir>/<path>/<filename.ext>).
Note that in either form, you can use the backslash (\) and
slash (/) characters (path separators) interchangeably.



1.1.2 General Rules for Using FirstMail

The following are some general rules for using FirstMail:

Selecting a menu option - Select an option by highlighting it
(using the <Up-arrow> or <Down-arrow> key) and pressing <Enter>,
or by typing the letter that precedes the option.

Selecting an item from a list - Highlight the item (such as a
message or an address) with the <Up-arrow> or <Down-arrow> key
and press <Enter>.

Scrolling through a list - If there are too many listed items to
fit in the window, small arrows appear near the top and bottom of
the left border of the window. You can scroll through the list
using <Up-arrow>, <Down-arrow>, <PgUp>, or <PgDn>.

Selecting multiple items from a list - Highlight the first item
and press either the <F5> key or the <Space> bar to mark it
(this places an asterisk (*) before the item); then repeat this
procedure for the second item, and so on. You can select all
listed items at the same time by pressing <Shift+F5>. After you
mark the items, you can issue a command that affects all the
marked items at the same time. For example, if you marked
several messages and then pressed <Delete>, FirstMail would
delete all the marked messages.

Unselecting a marked item from a list - Marked items are preceded
by an asterisk (*). If you mark an item by mistake, just
highlight it and press <F5> or the <Space> bar to remove the
asterisk.

Sending a message - When you finish writing a message, press
<Ctrl+Enter> to send it.

Moving between fields - Press <Enter> or <Down-arrow> to move to
the next field on the screen; press <Up-arrow> to move to the
previous field; press <PgUp> to move to the first field; and
press <PgDn> to move to the last field on the screen.

Moving within an editable field - Press <Home> to move to the
start of a field; press <End> to move to the end; press
<Ctrl+Left-arrow> to move one word to the left; press
<Ctrl+Right-arrow> to move one word to the right.

Accepting and saving settings - To accept and save settings in
any screen (and return to the previous screen), press
<Ctrl+Enter>. This is the standard command in FirstMail to
indicate that you are finished and wish to accept and save the
settings.


1.1.3 Assistance Features

FirstMail includes the following features to assist you:

Online Help -

Press the <F1> key at any time to get detailed information about
the part of the program you are using. If a pop-up menu of
relevant topics appears, just select the topic you want. When
there is more information than can fit on one screen, use the
arrow, <PgUp>, and <PgDn> keys to scroll through the screens.

To exit from a Help screen, press <Esc>. Note: Pressing <F1>
twice displays a list of the special keys you can use to access
FirstMail features (such as <F1> for help).

User Lookup -

The easiest way to add an address in an address field is by
pressing <F2> to display the "SMF Directory List" of users,
<F3> to display the Address Book, or <F4> to display the
logged-in user list, and then selecting an address from the
list. FirstMail immediately places the address you selected in
the address field.


1.2 Starting FirstMail

Before you run FirstMail, you must log in to your NetWare file
server. Ensure that your system administrator has loaded Basic
MHS.


To run FirstMail, enter the following command at the DOS prompt:

     MAIL

When you run FirstMail, the first thing you see is the "Mail
Options" menu. The menu contains a list of options describing the
main FirstMail functions.

The top line of the screen contains the date and time; the bottom
line of the screen contains informational text indicating the key
to press for help (<F1>), your username, the name of your file
server, and the filename of the current folder.



1.3 Quitting FirstMail

You can quit and return to the DOS prompt from anywhere in the
program by pressing <Alt+F10>. From the "Mail Options" menu, you
can also quit by either selecting the "Q: Quit using FirstMail"
option, pressingá<Q>, or pressing <Esc>.



2.0 GETTING STARTED USING FirstMail

The following sections provide the information you need to start
using FirstMail.



2.1 Composing and Sending Messages

To compose and send a message, either select the "S: Send a mail
message" option from the "Mail Options" menu and press <Enter>,
or press <S>. The "Send Message: Editing Screen" window
appears. The top of this window contains a "To" header, where
you enter the recipient's electronic mail address; a "Subject"
header, where you can type a short description of the message;
and a large blank area, where you type the message.



2.1.1 Addressing Your Message

When composing an electronic mail message, you must specify the
recipient's address. When the "Send Message: Editing Screen"
window opens, the cursor is located in the "To" header.

The easiest way to enter one or more recipients' addresses is to
press <F2> and then select the recipient from the "SMF Directory
List." When you select one or more recipients from the list,
FirstMail enters each address in the "To:"áheader.

You can also type addresses in the "To:" header using the format
described in the following section "2.1.1.1.Address Format."



2.1.1.1 Address Format

FirstMail supports addresses expressed as follows:

     <username>@<workgroup>

The <username> part is the user's MHS name and need not be the
same as the user's NetWare login name (that is, the name used
to login to the server). The <workgroup> part is the name that
the system administrator assigns to a logical grouping of
users. (Because all users on a Basic MHS server belong to the
same workgroup, you can omit the "@<workgroup> address part and
specify only the username. FirstMail automatically appends the
default workgroup to the username you specified.)

You can enter the addresses in either long or short name format,
as described in the next section.



2.1.1.2 SMF Long and Short Names Used in Addresses

FirstMail and other SMF v71-compatible applications use long name
format for addresses. SMF v70-compatible applications use only
short name format. Because some users with whom you want to
communicate may be running SMF v70 mail applications, FirstMail
supports both SMF long and short name format.



2.1.1.2.1 SMF Long Names

Long names can contain up to 253 characters, including spaces.
Because spaces are allowed, long names emulate the look of free-
form text, as shown in the following example:

     Evelyn [e-mail] Corp

The username part can be the user's full name (that is, first and
last name), but need not be. It can contain any printable
character except for the following: semicolons (;); left and
right parentheses (()); square brackets ([]), and braces ({});
commas (,); At signs (@); periods (.), and tabs. All non-printing
characters (such as the Delete character) are prohibited.

The workgroup part can be hierarchical (that is, it can consist
of a number of period-separated names). It can contain any
printable character except for the following: double quotation
marks ("); semicolons (;); left and right parentheses (()),
square brackets ([]), braces ({}); commas (,); At signs (@);
and periods (.). All non-printing characters are prohibited.

Note: The period character can only be used as a delimiter in the
workgroup.



2.1.1.2.2 SMF Short Names

Short names are the abbreviated equivalents of SMF long names;
the username and workgroup part can each contain up to eight
characters, as shown in the following example:

     enesbit @ acme

Spaces are not allowed in short names except on either side of
the '@' sign (although this is not required). The username and
workgroup parts can contain any of the following characters:

     A-Z
     a-z
     0-9
     - (hyphen)
     $ (dollar sign)
     # (hash mark)

All other characters are prohibited.



2.1.2 Composing Your Message

To compose your message, type the text into the "SendáMessage:
Editing Screen." FirstMail formats your message automatically.
You can edit your message using Internal-Editor commands (see
"5.0 Command Reference: Internal-Editor Commands").



2.1.3 Specifying Who Should Receive a Copy

Before you send your message, you can specify whether you want to
receive a copy of it. You can also specify one or more recipients
who should receive a Carbon copy (Cc) of your message.

Press <F9> in the "Send Message: Editing Screen" to display the
"Options for your message" window containing a list of additional
headers and options.

To send a copy of your message to other recipients, press <F2> in
the "Cc:" field and select one or more recipients from the
directory.

To save a copy for yourself, set the "Keep a copy?" field to Y.
Copies of your messages are saved in the "Copies to self" folder.

When you finish specifying recipients, press <Ctrl+Enter> to
return to the "SendáMessage: Editing Screen."

For information about all the fields on the "Options for your
message" window, see "4.2 Message Options for Individual
Messages."


2.1.4 Sending Your Message

To send your message, press <Ctrl+Enter>; FirstMail sends the
message and returns you to the "Mail Options" menu.



2.2 Reading, Replying to, Forwarding, and Printing Messages

From the "Mail Options" menu, select the "N:ácheck for New mail"
option to display a list of your new messages, or the "B:áBrowse
mail messages" option to display a list of messages that you read
previously. (Note: The "N:ácheck for New mail" option appears
only when you have new mail.) The "New mail" or "Browse mail"
window appears. The title of the window contains the name of
the current folder and the number of messages in the folder.
The window lists all the messages in the current folder.

You can scroll through the list using <Up-arrow>, <Down-arrow>,
<PgUp>, or <PgDn>.

Along the bottom border of the window is a list of the available
commands. You can select a command either by entering the
capitalized letter in the command (for example, press <R> for
Reply) or by pressing the key associated with the command you
want (for example, press <Esc> to exit the window).

Many of the commands in the "New mail" or "Browse mail" window
work on more than one message at a time. To mark multiple
messages, follow the instructions in "1.1.2 General Rules for
Using FirstMail."

To display more information about any message in the "New mail"
or "Browse mail" window, highlight the message and press <I>.

The "About this message" window appears, listing detailed
information about the message. Press any key to return to the
"New mail" or "Browse mail" window.

2.2.1 Reading Your Messages

To read a message, select the message from the list in the "New
mail" window (for a new message) or the "Browse mail" window (for
a previously-read message). The "Mail reader" window appears and
displays the message you selected.

The bottom of the "Mail reader" window lists the available
commands. In addition to many of the same commands in the "New
mail" or "Browse mail" window, you can display the next message
listed in the "New mail" or "Browse mail" window by pressing
<+> (the plus key) on your keypad, or the previous message by
pressing <-> (the minus key). To return to the list of messages
(so you can select one), press <Esc>.

By default, FirstMail displays only the "To" and "Subject"
headers. To display the complete set of headers, press <H>.
Press <H> again to hide them (this is a toggle switch).

While you are in the "Mail reader" window, you can use any of the
Internal-Editor commands to edit the text. For example, you can
mark a block of text, then copy and paste it into another message
(see "5.0 Command Reference: Internal-Editor Commands").



2.2.2 Replying to Your Messages

To reply to a message you received, highlight the message on the
"New mail" or "Browse mail" window and press <R>. You can also
reply to a message that you are reading by pressing <R> when
you are in the "Mail reader" window. The "Select reply format"
window appears, offering you a number of reply options.

The address options let you send your reply to any of the
addresses listed in the original message's headers. The
addresses found in the original header are listed to the right
of each header name; setting any of the "address options" to Y
adds the address in that header to the list of recipients of
your reply. Not all these fields have a value for every
message; generally, messages have only a "From" header, and
occasionally a "Reply-to" or "CC" header.

For example, if you want to send a copy of your reply to everyone
who received a copy of the original message, set "Copy CC" to Y.

To include the original message in the reply, set the "Include
message" option to Y.

To add the string you defined in your user preferences (see
"4.1.2.2 Setting the "Default commenting string" Field") to the
beginning of each line of the included message, set "Commented"
to Y; this is useful for distinguishing between the original
text and your reply.

When you finish setting the reply options, press <Ctrl+Enter> to
display the editing window where you can type your reply.

When you finish typing your reply, press <Ctrl+Enter> to send it
and return to the "New mail" or "Browse mail" window.



2.2.3 Forwarding Your Messages

To forward a message to someone else, highlight the message on
the "New mail" or "Browse mail" window and press <F>. You can
also forward a message that you are reading by pressing <F>
when you are in the "Mail reader" window.

The "Forward message or file to" window appears asking for the
address of the recipient. You can enter any valid address here
either by typing it or by pressing <F2> to select the address
from the "SMF Directory List" list.

If you want to forward the message as-is, set the "Edit before
sending?" field to N. When you finish setting the options, press
<Ctrl+Enter>. FirstMail forwards the message as-is and returns
you to the "New mail" or "Browse mail" window.

If you want to add text or edit the message before forwarding it,
set the "Edit before sending?" field to Y. When you finish
setting the options, press <Ctrl+Enter>. FirstMail displays the
message so that you can type additional text, edit it, or both.
When you are finished editing the message, press <Ctrl+Enter>.
FirstMail forwards the message and returns you the "New mail"
or "Browse mail" window.



2.2.4 Printing Your Messages

To print a message, highlight the message on the "New mail" or
"Browse mail" window and press <P>. You can also print a message
that you are reading by pressing <P> when you are in the "Mail
reader" window. The "Print settings" window appears.

To select a printer, a NetWare print queue, or a print file,
press <Enter> when you are in the "Print to" field. For help
setting your print options, contact your system administrator.

If you select a printer that is a PostScript printer, set
"PostScript?" to Y; you can then select a PostScript font from a
list of available fonts.

If you select "Queue" the next field is enabled and you can
specify a NetWare print queue. To list the available queues,
press <F2> when you are in that field.

If you select "File," the next field is enabled and you can
specify a filename on the file server. Filename expansion is
available; enter enough characters of the filename to identify
it uniquely, press <Tab> and FirstMail completes the name for
you. If the name matches more than one file, a small window
appears with a scrolling list of the possible options. Select a
file from this list using the arrow keys, or by typing the
first letter of the file you want.

You can also specify the number of lines per page; six lines
equals one inch. For example, the setting for an 11" page is 66
lines.
When you finish setting the print options, press <Ctrl+Enter> to
send the message to the printer.

The first time you print a message, you have to set these
options. After you set these options for the first time, you
can turn off suppress the "Print Settings" window, you can
print directly by pressing <P>. To do this, select the "P:
Preferences" option on the "Mail Options" menu. From the
"Preferences" menu, select the "General Settings" option and
set the "Suppress print dialog?" field to Y.

If you need to change your print setting at a later time, select
the "P:áPreferences" option and then select the "Print settings"
option to display the "Print settings" window.



2.3 Organizing and Storing Your Messages in Folders

You can organize and store your messages in different mail files
called folders. You can also organize the way that the "New mail"
or "Browse mail" window displays the messages within each folder.



2.3.1 Changing Folders

When you select the "B: Browse mail messages" option, FirstMail
always opens the folder that you were in last. If you want to
change to another folder (such as your "Copies to Self"
folder), press <F10>.

The "Select a folder" window appears listing the existing
folders. Select the folder you want; FirstMail opens that
folder and displays a list of the messages in it.



2.3.2 Adding, Renaming, and Deleting Folders

FirstMail provides the "Main" folder and automatically moves
messages there after you read them. If you specified that you
want to save a copy of a message you send, FirstMail creates a
"Copies to self" folder and places a copy of the message in it.
If you want to sort your messages into different folders, you
can create other folders. After you create the folders, you can
either move messages into them or place a copy of a message
into one or more folders.

To create a folder and add it to the "Select a folder" list,
press <F10> while you are in the "New mail" or "Browse mail"
window; the "Select a folder" window appears. Press <Insert> to
create a folder. You are prompted for a long name and a short
name for your new folder.

The long name should be a meaningful description because it is
the name displayed in the "Select a folder" window and at the
top of the "Browse mail" window.

The short name is the 8-character name of the file where the mail
messages in this folder are saved. It is the name that is
displayed at the bottom of the "Mail Options" menu indicating
the current folder. If you do not provide a short name,
FirstMail provides one for you. However, the name that
FirstMail provides is a combination of alphanumeric characters,
which might be difficult to relate to the long name.

To rename a folder, highlight it and press <Alt+R> to display the
"Enter New Name" window where you can change the long name, the
short name, or both.

To delete a folder and its contents, highlight it and press
<Delete>.



2.3.3 Copying and Moving Messages to Different Folders

You can organize your messages in different folders with the Copy
and Move commands. Using the Copy command, you can place a copy
of one or more messages in another folder. Using the Move
command, you can remove one or more messages from the current
folder and place them in another folder.

To place a copy of a message in another folder, highlight the
message on the "New mail" or "Browse mail" window and pressá<C>.
You can also copy the message that you are reading by pressing
<C> when you are in the "Mail reader" window. The "Select a
folder" window appears. Select the folder into which you want
to place a copy.

To move a message to another folder, highlight the message on the
"New mail" or "Browse mail" window and pressá<M>. You can also
move the message that you are reading by pressing <M> when you
are in the "Mail reader" window. The "Select a folder" window
appears. Select the folder into which you want the message moved.



2.3.4 Deleting Messages from a Folder

To delete a message from a folder, highlight the message on the
"New mail" or "Browse mail" window and press <Delete>. You can
also delete the message that you are reading by simply pressing
<Delete> when you are in the "Mail reader" window. If you mark
multiple messages, all the marked messages are deleted at the
same time.

You are always asked to confirm that you really want to delete
the messages. Note: Once you delete a message, it cannot be
recovered.


2.3.5 Changing the Order of Messages in a Folder

To change the order of the messages in a folder, press <O> when
you are in the "New mail" or "Browse mail" window. A list of
sorting options appears.

You can sort the messages by date, reverse order, or alphabetical
order (by sender or by subject). Select one and FirstMail
immediately re-sorts your messages. FirstMail retains these
settings from session to session.



2.4 Using Distribution Lists

You can store a group of addresses in a file called a
distribution list (DList). After you create a DList, you can
send a message to all the members of the group by addressing
the message to the DList.

A DList file must be an ASCII file and contain only one address
per line. Any address you could normally enter in FirstMail's
"To" header can be entered into the file, including other
DLists (up to a maximum of five levels deep).



2.4.1 Creating a DList

The easiest way to create a DList is by using FirstMail's
Distribution List Manager. When you press <F6>, the "Select a
distribution list" window appears, listing all current DLists.

To create a new DList, press <Insert>; you are prompted to
enter a long and short name for the DList. The long name should
be descriptive because it is used to identify the DList in the
"Select a distribution list" window. It can contain up to 50
characters (including spaces and double quotation marks). The
short name is the 8-character name of the ASCII file that
contains the addresses of the DList members.

When you finish, press <Ctrl+Enter> and an editing window opens
displaying the DList file. The first line of the file is the
title of this DList in the following format:

     \title <name_of_dlist>

This must be the first line in the file. Following the "\title"
line, you can enter any number of valid SMF addresses (one per
line) that you want to include in the DList. You can also
include names of other DLists. An easy way to add the addresses
is by pressing <F2> and selecting the address from the "SMF
Directory List."

You can also specify an address where you want replies to be
sent. This feature is useful if you want recipients to reply to
a specific address (such as the group's manager).

If you place the following entry in a DList file (immediately
after the "\title" line), FirstMail automatically includes a
"Reply-to" header (containing the address you specified) in any
message you send to the DList:

     \replyto <address_where_you_want_replies_sent>

where:

<address_where_you_want_replies_sent> is the address FirstMail
places in the "Reply-to" header of the message.

When you finish creating the DList file, press <Ctrl+Enter> to
save it.

Note: You can also create a DList by using the "Edit a file"
option on the "Mail Options" menu to create an ASCII file.

To delete a DList, press <F6>; the "Select a distribution list"
window appears. Highlight the DList you want to delete and press
<Delete>.

To rename a DList, press <F6>; the "Select a distribution list"
window appears. Highlight the DList you want to rename, press
<Alt+R>, and specify a new name when prompted.

To edit a DList file, press <F6>; the "Select a distribution
list" window appears. Highlight the DList you want to edit and
press <Alt+E>. FirstMail displays the file associated with that
DList.

To exit to the previous screen, press <Esc>.



2.4.2 Addressing Messages to a DList

The easiest way to address a message to a DList is by pressing
<F6> when you are in an address field and selecting a DList
from the displayed list. FirstMail enters it into the field for
you. You can also address a message to a DList by typing the At
character (@) in an address field followed immediately by the
name of the DList.


2.5 Using Address Books to Access Frequently-Used Addresses

Using FirstMail's Address Book feature, you can store frequently-
used addresses for easy lookup. You can create one or more
personal address books, each containing almost an unlimited
number of entries.

You can access the Address Book at any time by pressing <F3> to
display the "Select an address book" window.



2.5.1 Creating, Deleting, and Renaming Address Books

To create a new address book, press <Insert> while in the "Select
an address book" window. When you create an address book,
FirstMail prompts you for a long name and a short name. The
long name is the descriptive name that is displayed in the list
of address books. The short name is the 8-character name of the
file containing the address book. The short name is optional;
if you leave it blank, FirstMail generates a name for the file.
When you press <Ctrl+Enter> the long name is immediately added
to the list.

You can also rename or delete an existing address book.

To rename an address book, highlight it on the list, press
<Alt+R>, and specify a new name when prompted.

To delete an address book, highlight it on the list and press
<Delete>.



2.5.2 Adding Entries to Address Books

To add entries to a new or existing address book, select the
address book. The "Address book contents" window appears. Press
<Insert> to display the "Editing address book entry" window
where you can enter the address and information about each
entry. The following fields in the address book entry are
required (the other fields optional):

Name:

The name identifying the entry in the address book. This can be
the name of a user or a DList. Anything you enter in the "Name"
field of an address book entry can be used as an address
(unless it overrides a valid address). For example, if you
create an entry for Abraham Lincoln, specifying the name ABE in
the "Name" field and his electronic mail address in the "E-mail
address" field, you can then send a message to Lincoln by
typing ABE into the message's "To" header. FirstMail sends the
message to the address that you specified as the "E-mail
address."

Quick lookup key:

One or more characters that you can use to expand addresses (see
the section "2.5.5 Using the Quick Lookup Key").

E-mail address:

The electronic mail address for the person or DList associated
with this entry. It can be up to 100 characters in length.



2.5.3 Editing Entries in Address Books

To modify the existing entries in an address book, select the
appropriate address book to display a list of that book's
entries. You can then edit any entry in the address book by
highlighting it and pressing <Alt+E>. The "Editing address book
entry" window opens and you can modify the information
associated with the entry.


2.5.4 Using Address Books When Addressing Messages

An easy way to address a message is by selecting addresses from
the address book. Press <F3> to display the "Select an address
book" menu. Select the appropriate book to list the entries.
Select one or more addresses you want from the displayed list.
If you are in an address field, FirstMail copies the entry's
address into the address field.

To search for an entry in an address book, press <Alt+S>. When
prompted, type the search string you want and press <Enter>.
FirstMail highlights the next entry containing the string in
either the index or the description.



2.5.5 Using the Quick Lookup Key

The quick lookup key is a string of one or more keys that you
associated with the address book entry when you specified the
entry; typing this key (or keys) into an address field lets you
add an address to an address field without opening the address
book.

The easiest way to address a message is to type the quick lookup
key associated with the address you want into the address field.
You can type the whole key or enough characters from the key to
identify it uniquely. Press <Shift+F3> to expand the address and
add it to the address field.



3.0 ADVANCED FEATURES

This section describes advanced FirstMail features in the
following sections:

     3.1 Sending Attached Files with Messages

     3.2 Sending Files from a DOS Prompt

     3.3 Using Keystroke Macros

     3.4 Locating Text in Messages

     3.5 Using the Scratch Pad to Keep Notes

     3.6 Saving the Contents of a Message to DOS File

     3.7 Passing Messages to DOS Commands



3.1 Sending Attached Files with Messages

You can send up to 64 files (such as spreadsheets, word processor
documents, and graphics) with your messages. To send a file,
press <F7> when you are in the "Send Message: Editing Screen"
window. The "Attached to this message" window appears.

To add an attachment, press the <Insert> key. The "Enter
attachment information" window appears.

In the "Filename" field, enter the name of the file in either DOS
or NetWare format. The easiest way to do this is to type just
enough of the filename to identify it uniquely and press <Tab>.
FirstMail completes the name for you.

If the name matches more than one file, a small window appears
with a scrolling list of the possible options. Select from this
list using the arrow keys, or by typing the first letter of the
file you want. FirstMail expands directory names too, so you
can build complex paths with just a few keystrokes.

To specify multiple files, you can use the standard DOS wildcard
characters (* and ?) when typing the filename. FirstMail expands
up to 64 matching filenames and adds them to the list in the
"Attached to this message" window when you press <Ctrl+Enter>.

The "File type" field indicates the file format (Text or Binary)
or the word-processor used to produce the file. To specify the
format of the attachment, press <Enter> and scroll through the
list until you find the closest match. If you are unsure, select
"Unknown." Select "Text" for ASCII files and "Binary" for binary
files (files with line-draw or international characters must be
sent as binary files). If you are not sure whether a file
qualifies as an ASCII (Text) file, send it as "Binary" - this
is always safe.

FirstMail does not translate the file; therefore, you must ensure
that the file is usable by the recipient (for example, a PC
WordPerfect file sent to a Microsoft Word user on a Macintosh is
useless to the recipient).

To remove a file from the list of attachments, highlight the file
and press <Delete>.

When you finish specifying attachments, press <Ctrl+Enter> to
return to the "Send Message: Editing Screen" window; you can
either continue editing your message, or send the message with
the attachments by pressing <Ctrl+Enter>.



3.2 Sending Files from a DOS Prompt

You can send a file from the DOS prompt by using the FIRSTMAIL
command. The syntax in the command line is significant; you must
enter the command in the following order:

     MAIL <file_name> TO <recipient_address> "<subject_text>" /B

where:

<file_name> - Name of the file to be sent. You can only specify
one file on the command line; however, you can use DOS
wildcards to match multiple files (FirstMail can send a maximum
of 64 files). By default, FirstMail sends the file as ASCII
text in a message; if you do not want to send the file as a
message (that is, if you want to send it as a file), or if the
file is binary, specify the /B option as the last item on the
command line.

TO - (Optional) Using the word TO helps you remember the syntax.

<recipient_address> - Destination of the message or file. You can
specify any valid FirstMail address. If the address contains
spaces, it must be enclosed in quotation marks.

"<subject_text>" - The string that FirstMail places in the
"Subject" header of the message; <subject_text> is usually a
brief description of the message contents. The <subject_text>
string MUST be enclosed in double quotation marks ("");
otherwise, only the first word of the subject is sent.

/B - (Optional) specify that <file_name> is a binary file, or
should be sent as a file rather than as a message. This option
must be the last item on the command line if it is present.

For example, to send the spreadsheet SALES91 as a file to all the
members of the DList SalesDept, you would type the following at
the DOS prompt:

     MAIL SALES91 TO SalesDept "Sales Report for 1991" /B



3.3 Using Keystroke Macros

You can record sequences of keystrokes then play them back at a
later time. This is useful when performing a repetitive operation
or designing forms. The size of a keystroke macro is limited only
by available disk space.

Macros can contain stop codes; stop codes are markers indicating
that the macro should pause to let you enter information. Stop
codes are particularly useful if you want to create automated
forms that pause while the user answers a question or accepts a
field.


3.3.1 Recording Macros

Creating Your Macro:

You can record a keystroke macro at any time by pressing <Alt+U>;
FirstMail prompts you to specify a trigger, which is a string of
one or more keys that you must enter when you want to play back
the macro. Press any key or key combination (including keys that
normally have other purposes, such as <Alt+A> or <F10>).
FirstMail prompts you for a descriptive name for the macro. The
name is optional, but if you intend to use the macro
frequently, you should enter one. FirstMail uses the
descriptive name in a list of available macros. Press <Enter>
to accept the macro name. You can now record the macro. Every
keystroke you make is recorded.

Adding a Pause to Your Macro:

If you want the macro to pause when you play it back so that you
can enter text, press <Alt+P>. This places a stop-code marker in
the macro. When you play the macro back, it pauses when it
encounters the stop code and lets you enter text. To indicate the
end of a stop code while recording the macro, press <Alt+P>
again. You can have an unlimited number of stop codes in a macro.

Saving Your Macro:

When you finish recording the keystrokes, press <Alt+U> to stop
recording keystrokes and save the macro. You can press <Esc> at
any time to cancel recording the macro.



3.3.2 Playing Back the Macros

To play back a macro, press <Ctrl+U> followed by the trigger that
you specified when recording the macro.

If you want to select a macro from the "Select a macro" window,
press <Ctrl+U>. FirstMail displays a list of macros from which
you can choose.

If you specified a stop code when creating the macro, enter the
information required when the macro pauses. Press <Alt+P> when
you finish to indicate that you want to continue running the
macro.


3.4 Locating Text in Messages

When you are in either the "New mail" or the "Browse mail"
window, you can locate text in messages. Highlight the message
in the list where you want to start searching, and press <L>.
FirstMail prompts you for the text you want to use as a search
string. Enter the search string; the string can contain DOS
wildcards.

Note: FirstMail only searches within a line; it does not match
text that straddles two or more lines in the file.

You can also set the search options "Select files containing
string?" and "Search in headers only?."

If you set the "Select files containing string?" field to N,
FirstMail searches until it finds the first message containing
the text and then displays the message. If you set it to Y,
FirstMail does not display the message; instead, it marks all
the files containing the text with an asterisk (*).

If you set the "Search in headers only?" field to N, FirstMail
searches for the text in both the body and the headers of each
message. If you set it to Y, FirstMail searches in only the
headers. When you finish setting the options, press
<Ctrl+Enter>. FirstMail begins searching at the message you
highlighted.

In the "Mail reader" window, you can use the Internal-Editor to
search for text in the current message. Press <Ctrl+QF>.
FirstMail prompts you for the search string. All the
Internal-Editor search commands described in "5.0 Command
Reference: Internal-Editor Commands" are available.



3.5 Using the Scratch Pad to Keep Notes

You can write notes to yourself by using the FirstMail
Scratch-Pad feature. Press <F8> to display the "Scratch Pad"
window. You can use this area to write notes, and to copy and
paste between notes or messages. The Scratch Pad is always
saved when you exit from it, even if you exit by pressing <Esc>.

You can use the Internal-Editor commands described in "5.0
Command Reference: Internal-Editor Commands" to move text
between the Scratch Pad, other editors, and fields within
FirstMail.


3.6 Saving the Contents of a Message to DOS File

If you want to copy a message to a DOS file for later use, use
the eXtract command to "extract" the text from the message and to
specify the name of the file where you want to save the text.

If the message is a file transfer envelope (that is, a message
telling you that you received a file), this command "extracts"
the attachment file that was sent.



To extract text or an attachment file from a message when you are
in either the "New mail" or "Browse mail" window, highlight the
message and press <X>. If you are in the "Mail reader" window,
simply press <X>. (If the message has more than one attachment, a
list appears; select the one you want to extract.)

The "Extract message to what file?" window appears, prompting you
for the name of the destination file. If you do not specify the
file as a pathname, FirstMail creates the file in the directory
you were in when you started the session.

As with sending files, you can use the <Tab> key for filename and
pathname expansion.



3.7 Passing Messages to DOS Commands

You can pass a message to a DOS command when you are in either
the "New mail" or "Browse mail" window. To do so, highlight the
message and press <D>. The "Enter DOS command" window appears,
prompting you for a command. Enter any DOS command. FirstMail
adds the filename of the message to the end of the command. If
the filename must appear somewhere else in the command, place
the following characters at the point in the command where the
filename should appear:

     %s

If you marked multiple messages, FirstMail passes them to the DOS
command one after the other. This feature is useful when passing
messages to a word-processing application. When you pass a
message to a DOS command, only a copy of the message is passed.



4.0 SETTING PREFERENCES

From the "Preferences" menu, you can modify many aspects of the
way FirstMail operates. You can access this menu either by
selecting the "P: Preferences" option on the "Mail Options"
Menu or by pressing <Shift+F10> at any time. You can also set
preferences for an individual message by pressing <F9> when you
are in the "Send Message: Editing Screen."



4.1 Changing Settings from the Preferences Menu

When you select the "P: Preferences" option on the "Mail Options"
menu, the "Preferences" menu appears listing the settings you can
modify. As you highlight different options on this menu, the help
line at the bottom of the screen changes to give some information
about the highlighted choice. When you finish, press <Esc> to
return to the "Mail Options" menu.



4.1.1 "Copy-Self Settings" Option

After you specify that you want to keep copies of the messages
you send (by pressing <F9> when you are in the "Send Message:
Editing Screen" and setting the "Keep a copy?" field to Y or P)
you can specify the folder where your copies are saved. By
default, FirstMail saves a copy of each message in the "Copy to
self" folder; the filename for this folder is COPYSELF.

To save messages to another folder, specify an eight-character
filename in the "Folder for copies to self" field. If you type
the name of a file that does not exist, FirstMail creates it
for you.

If you want to be prompted each time you send a message, set the
"Always prompt copies to self" to Y.

By default, FirstMail names the new folder (associated with the
file you just created) "Copies to self." When you press <F10> to
display the "Select a folder" window, two "Copies to self"
folders are listed. To change the name of the new folder,
ensure that you select the correct "Copies to self" folder by
returning to the "Mail Options" menu; press <F10>, select the
folder and check the bottom right corner for the filename of
the folder. If the folder you selected is correct, press <F10>,
highlight the folder, and press <Alt+R> to display the "Enter
New Name" window. Enter a new name in the "Long name" field.



4.1.2 "Editor and Keyboard Settings" Option

This option lets you configure the way that FirstMail's editor
operates. Any changes you make affect the FirstMail message
editor, file editor (selected from the "Mail Options" menu),
distribution list editor, and the Scratch Pad. The following
sections describe the fields you can change.



4.1.2.1 Setting the "Default editor right margin" Field

You can set the default line length by specifying the right
margin. FirstMail wraps text that exceeds this length to the
next line. The value you enter here should be between 20 and
136. If you set a margin greater than the width of the editor
window, the window scrolls horizontally (as necessary) to keep
the cursor in view.


4.1.2.2 Setting The "Default commenting string" Field

When you reply to a message and include the original message in
the reply, you can specify that FirstMail is to place a
commenting string of one or more characters at the beginning of
each line of the included message. This commenting string is
used to differentiate the original from the reply. The default
string is a right angle-bracket (>) followed by a space. You
can change this string by typing a new string in the "Default
commenting string" field. This value in this field is also used
when you press <Ctrl+KM> to comment a block of text.



4.1.2.3 Setting the "Editor string" Field

If you want to use your own editor instead of FirstMail's
Internal Editor to edit messages and files, enter the command
that starts your editor (that is, the command you would
normally type at the DOS prompt to start it). Include a
complete path to the command. For example, enter "C:\BIN\EDLIN"
instead of just "qedit". FirstMail automatically adds the
filename of the message file at the end of the string. If the
filename must appear somewhere else in the string (for example,
if you need to specify switches), type the following
placeholder at the position in the string where the filename
should appear:

     %s

If your editor cannot accept a filename on the command line, it
cannot be used.

Note: When you run an external editor, it uses the memory that is
normally used by FirstMail's Internal Editor (typically from 230K
to 280K of system RAM). If your editor requires more memory, it
will not be able to run. Your editor must be a plain ASCII text
editor. Do not specify a word processor unless it creates plain
ASCII text (which most do not).

If you specify an external editor, you must also specify a
scratch directory (that is, a temporary workspace FirstMail
uses for creating some necessary files) in the "Scratch area"
field. If you have any questions, contact your system
administrator before attempting to use an external editor.



4.1.2.4 Setting the "Scratch area" Field

If you specify an external editor in the "Editor string" field,
you must enter the name of a directory (where you have write
access) into the "Scratch area" field. Ensure that the
directory you specify has sufficient space, because FirstMail
creates temporary editor files in this directory (RAM disks are
ideal for this purpose).

If you have any questions, contact your system administrator
before attempting to use an external editor.



4.1.2.5 Setting the "Always use external editor" Field

If you set this field to Y, FirstMail starts the editor you
defined in the "Editor string" field every time you edit a
message or a file. If you set it to N, FirstMail defaults to
its own Internal-Editor, but uses the editor value you
specified in the "Editor string" field as the default DOS
command when you use the <Ctrl+KE> command to escape to the
external editor.


4.1.2.6 Setting the "Keyboard layout" Field

Note: In this version of FirstMail, the "Keyboard layout" field
is set to the default layout; you cannot modify this field.



4.1.3 "General Settings" Option

This option lets you configure the way FirstMail operates. The
following sections describe the fields you can change.



4.1.3.1 Setting the "Personal name" Field

If you enter a string (such as your name or job title) in this
field, recipients see that string displayed (instead of your
address) in the "From" field in their "New mail" and "Browse
mail" windows. This makes your messages easier to find and
recognize. Keep your personal name short and descriptive. The
following characters are prohibited in your personal name:

      " ( ) { } [ ] @ % ! * ? . < > : ; \ /



4.1.3.2 Setting the "Dflt reply-to" Field

You can specify an address where you want all replies to your
messages sent (that is, FirstMail automatically copies this
address into your message's "Reply-to" header). This option is
useful when a manager wants all replies sent to a secretary. In
most instances, this field is left blank.



4.1.3.3 Setting the "Require Password at startup" Field

If you set this field to Y, you must enter your NetWare password
every time you start FirstMail. This option adds security to your
mailbox.



4.1.3.4 Setting the "Preserve deleted messages?" Field

If you set this field to Y, FirstMail copies the text of the
messages you delete (when you are in the "New mail" or "Browse
mail" window) to a special folder called "Deleted messages"
instead of immediately deleting them. You can browse this
folder like any other folder until you quit FirstMail. When you
quit FirstMail, the messages are permanently deleted. Although
this option can consume disk space temporarily, it prevents you
from permanently deleting something that you might need later.



4.1.3.5 Setting the "Swap out when calling DOS" Field

When either calling an external editor or running a DOS command
from the "New mail" or "Browse mail" window, FirstMail can move
itself to disk or to EMS memory (leaving only 960 bytes of itself
in main memory) and then reload itself afterwards. Although this
operation can free large amounts of memory, the results can be a
unreliable on some systems. If you set this field to Y and
FirstMail operates erratically, reset it to N.



4.1.3.6 Setting the "Working directory" Field

If you specify a directory in this field, FirstMail automatically
changes to that directory every time you run the program. This
option can be useful if you want to store extracted messages or
mail-related files in a particular place. FirstMail restores the
original directory when you exit from FirstMail.



4.1.3.7 Setting the "Address only in browser" Field

By default, FirstMail attempts to find the sender's long name in
the "From" header (instead of the sender's address) and displays
it in the "From" field of the messages listed in the "New mail"
and "Browse mail" windows. If you prefer to see addresses
instead of names, set this field to Y.



4.1.3.8 Setting the "Suppress print dialog" Field

When you are in either the "New mail" or "Browse mail" window and
press <P> for the first time, FirstMail opens the "Print
settings" window where you can change the active print
settings. FirstMail retains the print settings until you change
them; therefore, if you always use the same settings, you can
set this field to Y to suppress the "Print settings" window
from being displayed each time. You can still change the print
settings at any time by pressing <Shift+F10> to display the
"Preferences," menu where you can select the "Print settings"
options.


4.1.3.9 Setting the "Automatically open new mail" Field

If you set this field to Y, FirstMail automatically opens the
"New mail" window each time you run the program.



4.1.3.10 Setting the "Leave read new mail new" Field

If you set this field to Y, FirstMail leaves the new mail that
you have read (but did not move or delete) in your "New mail"
folder. The default is N (that is, FirstMail automatically
moves the messages you have read from the "New mail" folder
into your Main folder when you close the "New mail" folder).



4.1.4 "NetWare SMF/MHS Settings" Option

Use this option to configure specific details of the way
FirstMail interacts with MHS. If you are unsure of any of the
values for this option, leave the default values as they are
and consult your system administrator for assistance. The
following sections describe the fields you can change.



4.1.4.1 Setting the "My SMF/MHS username" Field

By default, FirstMail assumes that your MHS username is the same
as the first eight characters of your NetWare username (that is,
the name you use when logging into the file server). If your MHS
username and the first eight characters of your NetWare username
are different, enter your MHS username in this field. If you do
not know your MHS username, or if you get errors with FirstMail's
default value, contact your system administrator.



4.1.4.2 Setting the "My SMF/MHS mailbox name" Field

By default, New mail and configuration information is stored in
the directory <mv>/MHS/MAIL/USERS/<username> (where <username>
is the first eight characters of your NetWare username). Ensure
that the default value is correct; otherwise, FirstMail will
not able to find your new mail or attachments.



4.1.4.3 Setting the "My application name" Field

You can use more than one mail application on the same server but
your "preferred" is the one to which Basic MHS delivers mail. The
default value for this field is FIRST. Do not change it unless
your administrator tells you to do so.



4.1.4.4 Setting the "Scan the MHS user dir?" Field

When MHS creates a user, it sets the default mail application to
"MHS." If you set this field to Y, when FirstMail checks for new
mail, it scans for name "MHS" in addition to the name of the
application you specified in the "My application name" field. The
default value is Y. Although setting this field to Y can slightly
slow down checks for new mail, it is recommended that you leave
it set to Y.



4.1.5 "Change Home Mailbox Location" Option

When you use FirstMail, NetWare automatically creates your
mailbox on the file server. This mailbox is where all your
mail, address books, and DLists are stored. Because you have a
disk quota on the file server, the storage space in your
mailbox is limited. If you find that you need more space, you
can specify another place for FirstMail to store all your mail
and accessories.

Specify a location (such as your hard disk or a subdirectory on
the current server) in this field. When you enter a value,
FirstMail prompts whether to move the contents of your existing
mailbox to the new location.

If you specify N, the contents remain where they are but
FirstMail changes your home mailbox location. If you specify Y,
FirstMail attempts to copy all your mail and accessories to
your new location; if successful, FirstMail then deletes the
contents of your old mailbox.



4.1.6 "Print Settings" Option

This option lets you configure your print settings. This section
describes the fields you can change.

When you select this option, the "Print settings" window appears.

To change to destination of your print jobs, press <Enter> while
in the "Print to" field. A popup menu appears; select a
destination printer port, queue, or file.

Printing to a Printer:

If you select a printer port from the "Print to" field and the
printer is a Postscript printer, set the "PostScript?" field to
Y. To display a list of PostScript fonts, press <Enter> when
you are in the "PS font" field and select a font from the list
(if the font you choose is not available, the selection is
ignored).

Printing to a NetWare Print Queue:

If you select "Queue" from the "Print to" field, the next field
is enabled and you can type the name of a NetWare print queue
(on the current file server) in the "Queue name" field; if more
that one. queue is available, you can list the queues by
pressing <F2> when you are in that field.

Printing to a File:

If you select "File" from the "Print to" field, the next field is
enabled and you can specify the name of file. Filename expansion
is available when specifying the name of the file. Type enough
characters to uniquely identify the file and press the <Tab> key
to expand the name.

Setting the Page Length:

In the "Page length" field, you can indicate the length (at 6
lines per inch) of the paper on which you are printing (for
example, if printing on standard 8.5 x 11 paper, set "Page
Length" to 66 lines).

Printing a Banner Page:

If you set the "Print a banner page?" field to Y, FirstMail
prints a banner page when you print a message.



4.1.7 "Edit or Create Signatures" Option

A signature is a small text message that FirstMail automatically
adds to the end of messages you send (for example, your phone and
fax number). When you select this option, the "Editing" window
appears where you can write the text to be added to each outgoing
message. You can cut and paste between signatures and the Scratch
Pad using the Internal-Editor commands.



4.2 Message Options for Individual Messages

You can set options for individual messages. When you are in the
"Send Message: Editing Screen" window, press <F9> to display the
following list of headers your can include with your message and
options you can modify. The following sections list the settings
you can change.



4.2.1 Including a "CC" Header (Carbon Copy)

When you are composing a message, if you want to send a copy of
it to one or more additional recipients, specify their
addresses in this field. The recipient(s) specified in the "To"
header can see the "CC" header and the contents of that header.



4.2.2 Including a "BCC" Header (Blind Carbon Copy)

The "BCC" header is just like the "CC" header, except that only
the recipients of the Blind Copy see the "BCC" header in the
message. When you want to send a copy of the message to one or
more recipients but you do not want anyone else to know that
you did, specify those addresses in this field.



4.2.3 Including a "Reply-to" Header

If you enter an address in this header, it becomes the default
address for replies to this message. If you do not enter an
address, FirstMail examines the "From" header to determine a
return address and sends replies to you. This option is useful
when managers want the replies to their message sent directly
to their secretaries.


4.2.4 Setting the "Keep a copy?" Option

Set this to Y if you want to save a copy of the messages you
write, to N if you do not, or to P if you want FirstMail to
prompt you on a message-by-message basis whether to keep a
copy. FirstMail retains the value you set until you change it.
By default, FirstMail saves the copies in a "Copies to Self"
folder (the actual filename is COPYSELF); copies of messages
are listed as "To:SELF" in the "From" field of this folder. If
you want to save these copies to a different folder, see
section 4.1.1 "Copy-Self Settings Option."



4.2.5 Setting the "Confirm reading" Option

You can request confirmation that the message was read. If you
set this option to Y, FirstMail sends you for confirmation; if
you set this option to P, FirstMail prompts you on a
message-by-message basis whether you want confirmation. When
the message is read, FirstMail automatically sends you a notice
indicating the date and time the message was read.



4.2.6 Setting the "Confirm delivery" Option

You can request confirmation that the message was delivered to
the recipient. If you set this option to Y, FirstMail sends you
confirmation when the message is successfully delivered to the
recipient's mailbox.



4.2.7 Setting the "Urgent message" Option

Urgent messages appear in red on a color screen (or in boldface
on a monochrome screen) in the "New mail" window and are always
displayed the top of the list. However, applications other than
FirstMail might treat urgent messages differently or ignore the
urgent flag.



5.0 COMMAND REFERENCE: INTERNAL-EDITOR COMMANDS

FirstMail includes a full-featured text editor for editing
messages and files. While you are using the editor, press <F1>
at any time for a complete on-line reference to the editor.

Many of the editor commands require you to press three keys in
sequence such as <Ctrl+KR>; in this example, you would hold down
the <Ctrl> key while you press <K> and then press <R>. (In a
three-key sequence, you only have to hold down the <Ctrl> key
while pressing the first letter key; you can press the second
letter key without holding down <Ctrl>.)

The following sections list and describe the available editing
commands.



5.1 Movement Commands

<Left-arrow> or <Ctrl+S> - Moves the cursor one character to the
left.

<Right-arrow> or <Ctrl+D> - Moves the cursor one character right.

<Ctrl+Left-arrow> or <Ctrl+A> - Moves the cursor one word to the
left.

<Ctrl+Right-arrow> or <Ctrl+F> - Moves the cursor one word to the
right.

<PgUp> or <Ctrl+R> - Moves the cursor up one screen of text.

<PgDn> or <Ctrl+C> - Moves the cursor down one screen of text.

<Ctrl+PgUp> or <Ctrl+QR> - Moves the cursor to the top of the
message.

<Ctrl+PgDn> or <Ctrl+QC> - Moves the cursor to the end of the
message.

<Home> or <Ctrl+QS> - Moves the cursor to the start of the
current line.

<End> or <Ctrl+QD> - Moves the cursor to the end of the current
line.

<Tab> - Moves the cursor to the next tab stop; tabs are set 4
characters apart by default, but this can be changed with the Set
Tab command (<Ctrl+QT>).

<Ctrl+QG> - Goto line: Moves the cursor to a particular line in
the message.

<Ctrl+W> - Scrolls the screen up one line.

<Ctrl+Z> - Scrolls the screen down one line.



5.2 Block and File Commands

<Ctrl+KB> - Marks a block of text. Move the cursor to the start
of the text you want to select and press <Ctrl+KB>. Move the
cursor to the end of the text to be selected and enter one of
the following block commands in this section.

<Ctrl+KH> - Cancels marking without performing an operation.

<Ctrl+KC> - Copies the current block of marked text (or current
line, if none is marked) to the paste buffer.

<Ctrl+KV> - Copies current block of marked text to the paste
buffer then deletes the original.

<Ctrl+KI> - Inserts the current contents of the paste buffer at
the cursor position. The paste buffer is not cleared by this
command so you can repeatedly insert it into your message.

<Delete> or <Ctrl+KY> - Deletes the currently marked block of
text. The paste buffer is not affected by this command.

<Ctrl+KR> - Prompts for a filename then reads that text file into
the message at the cursor.

<Ctrl+KW> - Prompts for a filename then writes the currently
marked block of text (or the whole message if none marked) to
that text file.

<Ctrl+KS> - Suspends the session; this command interrupts the
current message, storing all the information you entered, and
returns you to the "Mail Options" menu. The next time you select
"Send a message" from the "Mail Options" menu, you are asked if
you want to resume editing the old message. You can have one
suspended session at any time.

<Ctrl+KE> - Starts the external editor, or DOS command. This
command lets you pass the currently marked block of text (or the
whole message, if none marked) to an external DOS command. You
are prompted for a command; the default is any value you
entered in your personal profile for an external editor. If you
enter just the command you want executed, FirstMail adds the
filename (of the temporary file created) to the end of the
command, or you can place the following string in the command
at the point where the filename should be placed:

     %s

FirstMail creates a temporary file containing the message or
text, and deletes the text from the message. After the external
command has returned, FirstMail reads the temporary file back
into the message.

<Ctrl+KM> - Adds a commenting string of one or more characters at
the beginning of each line of a marked block of text (or the
whole message, if none marked). This is useful for distinguishing
between the original text and your reply. When you press
<Ctrl+KM> you are prompted for a string of up to 20 characters;
either type a commenting string in this field or accept the
default by pressing <Enter>. Anything you enter is inserted at
the start of each marked line. See section "4.1.2.2 Setting The
Default commenting string Field."



<Ctrl+KT> - Trims trailing spaces on lines. By default, FirstMail
allows trailing spaces on lines. This is a toggle switch.
FirstMail retains this formatting setting until reset.

<Tab> - Moves every marked line one tab stop to the right.

<Shift+Tab> - Move every marked line one tab stop to the left.

<Ctrl+KO> - Centers a line or marked text. The current line or
marked text is centered within the current margins. Leading
spaces on the lines are removed, so this command can be used
after changing margins to re-center lines that are already
centered.


5.3 Search and Replace Commands

You can search for patterns of characters in your message and
replace matched text with new text by using the following
commands.

<Ctrl+QF> - Finds a string. The editor prompts you for a search
string and then for search options.

<Ctrl+QA> - Finds a string and replaces it with new text. The
editor prompts you for a search string, a replacement string,
and for search options. For example, to search for the string
JOHN in the text, and replace it with Peter 10 times
(regardless of the case of the text), press <Ctrl+QA>, type
JOHN in the "Find:" field that appears and press <Enter>, type
Peter in the "Replace with:" field that appears and press
<Enter>, and type U10 in the "Options" field that appears and
press <Enter>. The "Replace (Y/N/A/Q)?" field appears and you
can specify (Y or N) whether you want to replace each instance
of JOHN on a case-by-case basis, replace all 10 instances (A),
or quit the procedure (Q).

<Ctrl+L> - Repeats the last search or replace operation.



5.3.1 Searching for a Regular Expression

You can also use a special form of search called "regular
expression" that allows you much more flexibility in the patterns
you can match. A regular-expression search string can contain any
of the following special characters:

* - Matches any number of characters in the text. For example, to
find a name that could be Johnson, Johnston or Johannson, press
<Ctrl+QF>, enter the search string JOH*ON, and enter the option R
(to enable the search of a regular expression).

? - Matches any single character in the text.

[character_set] - Matches any set of characters specified within
the brackets, including a range of characters. For example,
[a-qz] matches any character from "a" to "q" inclusive, and "z".

[Ctrl+character_set] - Matches any character NOT contained in the
set.

+ - Matches any number of occurrences of the previous character,
set, or wildcard. For example, the set [a-p]+ matches text to any
length as long as it comprises only the characters from "a" to
"p"; the string =+ matches a sequence of any number of equals
signs.


5.3.2. Setting Search Options

Search options control the way the editor performs the search.
Specify options by entering any of the following characters (in
any order) when prompted:

G - Performs global search from the start of the message.

N - Replaces without asking permission before replacing.

n - Number of times to find or replace; this can be an integer
from 1 to 255.

R - Enables regular expressions in the search string.

U - Ignores case while searching; uppercase and lower case are
treated as equal.



5.4 Other Editor Commands

<Ctrl+T> - Deletes the word to the right of the cursor.

<Ctrl+End> or <Ctrl+QY> - Deletes text starting at the cursor and
ending at the end of the current line.

<Ctrl+Y> - Deletes the current line.

<Ctrl+N> - Inserts a line at the cursor position.

<Ctrl+P> - Inserts the literal value of the next key pressed.

<Insert> - Changes between insert and typeover modes.

<Ctrl+B> - Reformats the current paragraph (that is, the
paragraph where the cursor is located). FirstMail asks you for
an indent value (that is, the number of spaces it should add at
the left of the block). This lets you indent paragraphs. Enter
0 for no indentation. FirstMail recognizes when a block has
been "commented out" and preserves the formatting.

<Ctrl+QM> - Sets the right margin for word-wrap. When the cursor
reaches the right margin, the next word you type "wraps" to the
next line. The right margin must be a number between 20 and 136;
FirstMail ignores any value outside this range. (See section
4.1.2.1 "Setting the Default editor right margin Field.")

<Ctrl+QT> - Sets the number of space characters between tabs. The
default value is 4.