Contents

Welcome to OPMail. This is a Windows-based front-end for the UUPC/Extended E-mail package from Kendra Electronic Wonderworks.

The OPMail program makes handling and organization of all your mail quick and easy. It is very easy to configure (it may not need any configuration at all), and with its Drag-And-Drop functionality the organization of your mail couldn´t be simpler.

Main window

Menus

Configuration

Options

MIME support

PGP support

RFC compliances

Author

This is Enviraware


Main window

The main window contains a list of folders and a list of messages. When you select a folder, its contents is shown in the message list.

The message list shows all the messages in the selected folder. When the InBox folder is selected, all messages received but not yet read have a + in front of them.

If you double-click on a message (or select it and press Ctrl-V or Enter) you can view the contents of the message in a separate window.

You can press the Del key to delete a message, or you can use the mouse to drag a message to another folder. The message line will then show a `d´ or `m´ at the start of the line. However, in order to make OPMail more fluent to work with this action is not actually carried out untill you choose another (or the same) folder or leave OPMail.

The Reply button lets you write a reply to the selected message. When you press it (or drag a message onto it) the Recipient window appears, where you can change the subject and recipient(s) of the message and start the message editor.

The Forward button allows you to forward the selected message to someone else. When you press it (or drag a message onto it) the Recipient window appears, where you can specify to whom it will be forwarded. The subject cannot be changed, and you cannot edit the message.

Tip: If the list of folders contains more folders than can be viewed at once, you can enlarge the list by dragging the space between the lists.

Tip: You can adjust the width of the space used to show sender names by dragging horizontally from a point just before the subjects. When the cursor is in the right place it changes to a left-right arrow.


Menus

File

Open to Send

Save Message As

Exit

Folder

Add

Delete

Message

Send New

View

Forward

Reply

Move to Folder

Delete

Undo

Setup

Font

Options

View raw

Help

Contents

About

This is Enviraware


Open to Send (File menu)

Chose this command to select a file to send to someone. You will be prompted for a file to send in the Open To Send window.

This is Enviraware


Save Message As (File menu)

Chose this command to save the currently selected message as a disk file. You will be prompted for the file name to store the message in in the Save Message As window.

This is Enviraware


Exit (File menu)

This command terminates OPMail. Changes in the selected folder are updated before the program exits.

This is Enviraware


Add (Folder menu)

This command is used to create a new folder. When you select it the Add Folder window appears when you can enter the name of the new folder.

This is Enviraware


Delete (Folder menu)

Select this command if you want to delete the selected folder. The InBox cannot be deleted.

This is Enviraware


Send New (Message menu)

Select this command to send a new message to someone. When you select this command, the Recipient window will appear, where you can specify subject and recipient(s) of the message.

This is Enviraware


View (Message menu)

Select this command to open a viewer window with the contents of the selected message. If the message contains something other than plain text you may want to set up a viewer that can handle this kind of data.

This is Enviraware


Forward (Message menu)

Select this command to forward the selected message to someone else. When you select this command, the Recipient window will appear, where you can specify recipient(s) of the message.

This is Enviraware


Reply (Message menu)

Select this command to create and send a reply to the selected message. When you select this command, the Recipient window will appear, where you can verify the subject and recipient(s) of the reply.

This is Enviraware


Move to Folder (Message menu)

Use this command to move the selected message to another folder. When you select this command, the Move To Folder window will appear where you can select the folder to move the message to.

To indicate that the message has been moved an m is shown to the left on the message line.

Shortcut: Use the mouse to drag the message from the message list to its new folder.

This is Enviraware


Delete (Message menu)

This command deletes the selected message. The actual deletion takes does not take place until you click on another (or the same) folder in the folder list or you leave the program.

To indicate that the message has been deleted a d is shown to the left on the message line.

This is Enviraware


Undo (Message menu)

This command is available when the selected message has been deleted or moved to another folder. Select this command to cancel a deletion or movement after it has been done.

This is Enviraware


Fonts (Setup menu)

This command displays the Font selection window, where you can select the font to be used for the folder and message lists.

This is Enviraware


Options (Setup menu)

This command displays the Options window, where you can specify which editor and viewers to use to write messages and view messages.

This is Enviraware


View raw (Setup menu)

This command is either checked or unchecked. Switch between checked and unchecked by selecting this command.

When this command is unchecked, OPMail will apply all necessary handling of the contents of the message to bring it into the form prior to transmission from the sender. This handling includes QuotedPrintable decoding, Base64 decoding, conversion to the Windows character set, PGP decryption, and displaying the message in the appropriate viewer.

When this command is checked you will see the raw contents of the messages, including the complete e-mail headers, when you view them. The viewer used in this case will be the one set up for the text/plain MIME type.

This is Enviraware


Contents (Help menu)

This command brings up the Contents page of this help file.

This is Enviraware


About (Help menu)

This command displays the programs About box.

This is Enviraware


Multipart Message window

The message you have chosen to view is composed of several parts, shown in the list. Double-click on the part you want to view or select it and press the View button.

This is Enviraware


Font selection window

Select the font to be used in the Folders and Messages lists. Since only fixed pitch fonts can be used in these lists, only fixed pitch fonts will be suggested.

This is Enviraware


Save Message As window

In this window you enter a file name in which to save the selected message.

If the file contains a Base64 encoded message it will automatically be decoded to its original binary contents.

This is Enviraware


Recipient window

In this window you specify the subject, primary recipient(s), and carbon copy (CC) recipients of the message to be sent. For a message being forwarded, the subject cannot be changed.

Press the Edit button to edit the message (not allowed for forwarded messages or when sending a file). The editor then pops up in another window.

If you are replying to a received message, the received message is shown quoted in the new message, i.e. each line of the old message is preceeded by a > . You may remove as much of the old message as you like.

When you have finished editing the message, save it and leave the editor. You can edit it again by pressing the Edit button once more.

Once the message is completed and you have filled in the Subject and Recipient values you can press the Send button. OPMail then hands over the message to the UUPC RMAIL program which enqueues it for transmission. However, if you have PGP installed, the Message Encryption window appears first.

If you have used non-ASCII characters in your message, such as accented or cyrillic characters, you may want to send the message in 8bit format. To do that, check the Send as 8bit option box before you press Send. This is useful if the recipient does not have a MIME-capable mail reader, but it presumes that the message is guaranteed to pass through 8bit-aware mail gateways all the way to the recipient. Today, there are still many gateways, which only pass the lower 7 bits of each character, rendering 8bit messages almost unreadable, so if you do not have to send as 8bit, then dont!

This is Enviraware


Message Encryption window

This window allows you to specify encryption options when you have PGP installed. The window contains the following options:

Sign message

Pass Phrase

Keep message readable

Encrypt with receiver´s key


Sign message

When you check this option the message will be encrypted with you private, secret key before transmission. Use this to allow the recipient to verify that you were indeed the sender of the message. When you sign a message, you must supply the correct pass phrase in order for PGP to be able to use your private key.

See also:

   Message Encryption window


Pass phrase

The pass phrase is the password to the your secret key. You must supply the pass phrase if you want to sign a message.

See also:

   Message Encryption window


Keep text readable

Check this option if you want your original message to be readable after PGP encryption. In this case PGP only appends your signature to the message. Recipients without PGP can still read the message while recipients, who do have PGP, can still verify that it really was you who sent the message.

If you do not check this option, PGP will compress your message which makes it readable only to recipients who have PGP.

This option is only available if you are sending a plain ASCII text message.

See also:

   Message Encryption window


Encrypt with receivers key
Encrypt with receiver´s key

Check this option if the message is for the receiver´s eyes only.

This option is only available if you actually have the receiver´s public key on your public keyring.

See also:

   Message Encryption window


Move Message window

Select the destination folder from the list and press Enter or click the OK button.

To leave without moving the message press Esc or click the Cancel button.

Shortcut: Use the mouse to drag the message from the message list to its new folder.

This is Enviraware


Add Folder window

Enter the new name and press the Enter key or click on the OK button to create the new folder.

Press Esc or click on the Cancel button if you do not want to create a folder.

If you do not enter a name, a new folder will not be created.

In the folder name case is not significant, and the name must be 1-8 characters.

This is Enviraware


Open To Send window

Select the file you want to send to someone and press OK. The Recipient window then appears, where you can specify the Subject and Recipient(s) of the file.

If the file contains binary data it is automatically Base64 encoded before it is sent. If the file appears to be DOS text with international characters from the current code page it is automatically converted to the Windows character set. Only the first 512 bytes of the file are examined when the type is being determined.

This is Enviraware


Configuration

Since this program is meant as a front end to the UUPC/Extended package from Kendra Electronic Wonderworks, it also uses the same configuration files etc. Before you can use OPMail you must install the UUPC/Extended package (but since you are interested in OPMail in the first place I assume that you have already done it.)

With UUPC installed chances are that you do not need to make any configuration of OPMail at all. However, in case of difficulties, this is what OPMail requires:

Two DOS environment variables must be defined:

UUPCUSRRC	Must point to a user settings file.

UUPCSYSRC	Must point to a system settings file.

If necessary, add these lines to your AUTOEXEC.BAT:

SET UUPCSYSRC=C:\UUPC\UUPC.RC

SET UUPCUSRRC=C:\USER\PERSONAL.RC

Be sure to use the paths relevant to your system.

The UUPC.RC file must include the following settings

Domain=mymachine.domain.net

MailDir=C:/uupc/spool/mail

TempDir=C:/temp

MailExt=spb

The PERSONAL.RC file must include the following settings

Mailbox=myname

Name=My Full Name

Home=C:/user

Folders=~/mail

Signature=signatur.txt

Again, be sure to use the values relevant to your system in both files. You can find a detailed description of the files in the UUPC documentation.

With the values as shown, OPMail will place its folder files in C:/user/mail/*.spb.

See also

   Options

This is Enviraware


Options

In the Options window you can change a few of the standard settings that OPMail uses. The settings are:

MIME Type

Viewer

Editor

Character Set

OPMail knows about a number of predefined MIME Types and automatically detects if you have a suitable viewer for each of these types. The types for which a viewer has been found are shown in the list of MIME Types when this window is opened.


MIME Type

Here you specify the MIME Type for which you want to configure a viewer. The MIME Type consists of a type and a subtype, as in text/plain.

The type should be one of "text", "application", "audio", "image", or "video". The subtype should be one registered with IANA for the given type, or an X extension (such as X-MyType). The currently registered types and subtypes can be found at this URL: ftp://ftp.isi.edu/in-notes/iana/assignments/media-types/media-types.

The MIME standard also defines the types multipart and message, but you do not have to install viewers for these, as OPMail handles them internally. However, you can define your own, if you really want to.

The purpose of MIME types is to have a common base of types so that a receiver is able to view (or hear) the message you sent using whatever appropriate viewer (or player) he has on his system and vice versa.

See also

   Options


Viewer

Enter the name of the program you wish to use for viewing messages of the selected MIME Type. It must be a program that can be started with the file name to be viewed on the command line. The Windows notepad.exe program is one example.

notepad.exe has the limitation that it can only handle small files (<64kB). If you receive larger messages you will have to install another viewer that can handle large files.

See also

   Options


Editor

Enter the name of the program you wish to use for writing new messages and replies. It must be a program that handles plain ASCII text files and that can be started with the file name to be edited on the command line. The Windows notepad.exe program is one example and is also the default.

See also

   Options


Character Set

This option allows you to indicate the name of the character set that your messages are written in. OPMail uses this in mail you send as an indication to the receiver, so that he will view your message with the same letters and symbols as you wrote it.

In many parts of the world the ISO-8859-1 set matches the arrangement of the Windows fonts, so this is the default for OPMail.

See also

   Options


MIME Support

OPMail is MIME-conformant beyond the basic requirements according to RFC-1521. It contains support for these MIME features:

-	Adds MIME header lines to messages being sent.

-	Always sends messages with ISO-8859-1 compliant characters.

-	Automatically sends text messages Quoted-Printable encoded.

-	Automatically sends binary files Base64 encoded.

-	Automatically decodes Quoted-Printable encoded messages.

-	Automatically decodes Base64 encoded messages.

-	Can launch message viewers according to MIME message types/subtypes.

-	Handles Multipart/Mixed, Multipart/Parallel, Multipart/Alternative, and Message/rfc822 types internally.


PGP Support

OPMail contains automatic support for PGP, if it is installed on your computer. OPMail detects the presence of PGP if the environment variable PGPPATH points to the directory where PGP.EXE is, or if PGP.EXE can be found in a directory in the PATH. If there is a PGP.PIF file OPMail will use that instead.

When you send a message, you will be given the opportunity to choose if the message should be signed with your private key, if the message body should remain readable (in case the receiver does not have PGP), and if the message should be encrypted with the recipient´s public key (provided you have a copy of it), see the Message Encryption window.

When you receive a PGP encrypted message OPMail will automatically detect this and let PGP decrypt the message before displaying it.


RFC Compliances

OPMail complies with the following RFCs (Internet Standards):

RFC-822  Format of ARPA Internet Text Messages

RFC-1521  MIME


Enviraware

So, what is Enviraware ?

It is software, which you earn the right to use by being environment aware, that is, you do your part to preserve our environment. That includes one or more of the following items:

-	Help save the whales, dolphins, sharks, pandas, tigers, and other endangered or abused animals.

-	Help preserve the rainforests of the world.

-	Stop the pollution of our atmosphere, lakes, rivers, oceans, forests, and the rest of the nature around us.

-	Participate in environment restoration projects.

-	Recycle as much as you can, and support or take initiatives to more recycling projects.

-	When you visit our wonderful nature, do it in a minimal impact fashion.

-	Save natural resources, like clean water and rainforest timber.

-	Give financial and moral support to organizations that work for these topics.

-	Spread knowledge to others about the importance of doing all of these things.

When we all participate in every way we can, perhaps there is still time to keep the world in a healthy state and to undo some of the abuse that we and our ancestors have done to this world in ignorance.

Even if you do not want to use this program, and therefore do not need to pay the price for it, these issues should still have enough justification of their own.


Ole Perch Jensen

Harløsevej 55

DK-3400 Hillerød

Denmark

<oleperch@zaphod.ping.dk>


Base64 is a MIME standard for safely sending binary data through a mail system that may have a 7-bit limitation. In this encoding scheme the data are split into groups of 3 binary bytes which are encoded as 4 characters that are all within the 7-bit ASCII character set.


MIME stands for Multipurpose Internet Mail Extensions. It is an Internet standard (RFC-1521) for sending all kinds of data through 7-bit limited Internet mail systems. MIME defines a variety of text and data types and formats, and specifies how different character sets and data types can be handled within the frames of existing Internet mail systems.


Code pages is a technique used by DOS to support various national character sets. A code page is identified by a number, for instance 437 for US and 850 for Scandinavian. See your DOS manual for more information.


The Windows character set is identical to the character set defined in the ISO-8859-1 standard. This is also the one of the legal character sets to be used for MIME compliant mail messages.


Quoted-Printable is a MIME defined method of encoding non-7bit characters into 7bit sequences. The method replaces a character by an `=´ followed by the character´s binary value represented by 2 hexadecimal digits. For instance, an `A´ would become `=41´ (although most characters valued between 20 and 7E may be represented by themselves).


PGP stands for Pretty Good Privacy. It is a free Public Key Cryptography program originally written by Philip Zimmerman, and it is available for a variety of computers, including PCs with MS-DOS.

PGP can be downloaded from all major Anonymous-FTP sites, but beware of US export restrictions. If you live in the US, you must get a version from a site in the US; if you live outside, you must get a version from outside.

If you have access to the World Wide Web, you should take a look at the URL: http://www.ifi.uio.no/~staalesc/PGP/versions.html, for information about the latest versions of PGP.


Uniform Resource Locator. This is a way to tell where an electronic document can be found on the Internet and which method to use to get it.


Internet Assigned Numbers Authority. This is the Internet committee in charge of ensuring that everyone on the Internet have their own unique Internet address, and that there is a general agreement on what to call things.


A message of type Multipart/Mixed contains several independent messages. OPMail handles this type of message by displaying a list of the contained messages. Each message can then be viewed by selecting it from the list.


A message of type Multipart/Parallel contains several messages to be viewed simultaneously. OPMail handles this type of message by starting a viewer for each contained message.


A message of type Multipart/Alternative contains several versions of the same message, ordered by increasing preference by the sender. Usually, the first version will be in plain text, so that a receiver without special viewers can read it, while the last message will be in the most advanced format.

OPMail handles this type of message by starting a viewer for last version for which OPMail knows a viewer.


A Character Set is a relation between binary codes and characters. It does not define how each character looks.

This is not to be confused with a Font, which defines the glyphs, i.e. the graphical appearances, of a set of characters.

A Windows font is actually two-in-one, because it directly defines the relation between binary codes and character appearances.