_________________________________________________________________

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 Nesbit@Sales.Acme 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 "SendMessage: 
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 "SendMessage: 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.

