                 VIEW - A SMTP Mailer for TCP/IP
                          January 1991


Introduction

View is a mailer designed to work with the networking software from Phil
Karn (KA9Q).  It is a full screen system that allows you to scroll
through a message file quickly and easily.  Mail can be read, or new
messages created.  You have the choice of selecting your own viewer and
editor programs.  This program creates the files, but it is up to the
external software to view and/or edit them.

View was written in Turbo Pascal 6.0.  It can operate in color, or
non-color modes.  The configuration page must be filled-in in order for
View to operate correctly.

View was written by Mark Bramwell, VE3PZR, London, Ontario.  I can be
reached during the day at (519) 661-3714, and at home (519) 473-3618. 
View can be downloaded from the internet from HAMSTER.business.uwo.ca
[129.100.22.100].  Hamster supports anonymous FTP logins.  If you want a
copy of view and have a modem, then call me at home and will make some
arrangements. Feel free to send any comments regarding view to
mbramwel@uwo.ca.  I can also be reached via packet by mailing to
VE3PZR@VE3GYQ.


**   A Novell network version of View is available.  The novell version uses
     POSTMAN to deliver the mail.  Up to 8 servers can be served by the
     POSTMAN machine.

Quick Setup

Copy VIEW.EXE to your computer.  Make sure that you have a PATH command in
your AUTOEXEC.BAT so that DOS can find VIEW.EXE

If you have been using BM.EXE for mail, then the setup is simple.

If you have not been using BM.EXE, then some directories are needed.
Type in the following commands:

C> MD \SPOOL
C> MD \SPOOL\MAIL
C> MD \SPOOL\MQUEUE

You are now ready to start View.

C> VIEW


Test Drive of View

Before you start, you must copy 3 files into your \SPOOL directory. 
These files are required to use some of the functions of View.
 
COPY CONFIGR.EXE  \SPOOL
COPY ADD-ON.EXE   \SPOOL
COPY MAILBOOK.EXE \SPOOL
COPY VIEW.HLP \SPOOL

When you enter View for the first time, you will have to configure it
for your system.  Select the f5 function key to enter the configuration
page.  Choose F1, main configuration.  Most items should be filled. 
Here is an example of some of my responses:



           Userid:  Mark
           Hostname: HAMSTER.business.uwo.ca
           Realname: Mark Bramwell

           Reply-To: mbramwel@uwo.ca

           editor: \util\qe.exe
           viewer: \util\list.com

           Comments:
           Signature: \spool\signatur.txt

           directory: \spool\mail         25+: Y  DirMask: *.TXT
           Color: Y    Timezone: EST   Filter: Y  Printer: LPT1



Remember to hit enter with each entry.  When you have filled in the
configuration page, hit ESC to save it.  View will resave the
configuration each time you exit the config screen.  

Some messages will appear on the screen if you had mail waiting.  If no
mail is waiting, then a short message will appear on the screen.

To read a message, use the arrows keys on the keyboard to move the
highlight bar.  When the desired message is highlighted, hit ENTER to
read the message.


Configuration:

In order to use VIEW, you must fill-in the configuration page.  It is
this info that tells the mailer who you are, where you are, and what
type of equipment that you are using.  The Gateway setup is only
required if you intend on sending email through a gateway.  Gateways are
being setup to allow hams to send mail through the Internet system.

USERID:  This is the userid that will be used for all outgoing mail.  VIEW
         will read the mailfile for this userid whenever you start VIEW.
           Example:  MARK

HOSTNAME:This is the hostname used by view and should be the same as the
         hostname set in AUTOEXEC.NET.   My hostname at the
         university is HAMSTER.Business.UWO.CA, but at home it is
         VE3PZR.ampr.org
           Example:  VE3PZR.ampr.org

REALNAME:The name that your mother gave to you when you were born (or
         close to it).  The mailer simply inserts this info into the outgoing
         mail header. (This entry is optional).
           Example: Mark Bramwell

Reply-To:Sometimes your incoming mailbox might have a different name
         than the userid used to send the original message.  This allows you
         to specify where you want mail to go if someone replies to one of
         your messages.  (This entry is optional.)
           Example:   mark@ve3pzr.ampr.org

EDITOR:  The full dos path and filename of the program that you want to
         use to create messages.  This entry must be filled in order to send
         outgoing mail.  It is not required to read mail.
           Example: c:\util\qe.exe

VIEWER:  The full dos path and filename of the program that you want to
         use to read messages.  If no filename is specify, then view will use
         a very simple built-in message reader.
           Example:  c:\util\list.com

COMMENTS:This allows you to place a comment in the header of all outgoing
         mail messages.  It can be almost anything, and is ignored by the
         mailer.
           Example: I like my MTV

SIGNATURE:The full dos path and filename of a text file that you want to be
         your signature file.  The signature file is appended to the end of
         all outgoing mail messages.  Some people like putting cute phrases,
         while others simply put there name, address, phone number where
         they can be reached.  (This entry is optional.)
           Example:  C:\mystuff\signatur.txt

DIRECTORY:The full dos path where your mail files your stored.  If you are
         using KA9Q NOS, then this should be set to \SPOOL\MAIL

25+:     If you have an ega/vga system, then setting this to yes will give
         you more than 25 lines per screen.  This entry does not effect cga
         or TTL monochrome monitors.

DIRMASK: DOS wildcard description of your mail files.  For most people,
         this setting should be *.TXT.

COLOR:   If you have a color monitor, then set this to yes.  VIEW uses
         slightly different patterns if this is set to Yes.  Try both to see
         what you like.  If you set it to 'A', view will try to determine the
         type of monitor you are running, and set the color on/off as
         required.

TIMEZONE:Where are you?  I am in the timezone called EST (Eastern
         Standard Time).  

FILTER:  Setting this to Yes will cause VIEW to filter out alot of useless
         header info.  This header info gets generated when mail passes
         from machine to machine.  This entry was created because I was
         tired of reading 1 line messages with 15 lines of headers.

PRINTER: Which printer do you want VIEW to use to print messages?  I use
         LPT1 on my computer.  VIEW closes the print job after every
         message allowing it to print on Novell networks without
         difficulties.


On the gateway setup screen....   (Stand-alone version only)


GATEWAY: Hostname of a machine that will accept your mail and push it
         onto the Internet or other mail system.

FORCE:   If set to 'YES', then all mail will be directed to the gateway host. 
         If set to 'NO', then you will need to use Shift-F2 to push mail
         through the gateway.

The configuration is stored in a file called \SPOOL\MAILER.CFG.  You can
use a normal editor to view the file.  The first word on each line is a
keyword or command for VIEW.  Unknown keywords are ignored.


Special Keys

Certain keys have functions assigned to them.  For example, you can move
the hi-lited bar by using the following keys:  Arrow up, Arrow down,
Home, End, PgUp, PgDn.  

You can mark messages for deletion with the DEL key.  

ALT-A Add-on manager.  This will allow you to run external programs from
within the mailer.  Programs can be assigned to any key on the keyboard.
Hitting that key will cause the program to execute.  The add-on manager
is simply a method of running programs without shelling to dos.

ALT-C The credits.

ALT-D allows you to jump to DOS without exiting view.  When you type
EXIT at the dos prompt, you will be returned to VIEW at the same point
that you left.  This is usefull when you are reading large files and it
takes a long time for view to read-it-in.  

ALT-F is the full display key.  It opens a window at the bottom of the
screen that will display the full hostname and subject of the current
message.  It can be toggled on and off and the mode is save in the
configuration.  This is stored in the config file as LINEMODE.

ALT-P will print the highlighted message on your printer.  Check config
page to ensure that you have the printer defined.

ALT-S will allow you to save the current message to a file.  View will
ask for a filename.  The message will be read and stored in that file. 
This will not erase the file if it already exists.  View appends
messages to the file if it already existed on your disk.

ALT-U is the update key, and forces view to immediately update the file
by removing marked messages.  View automatically updates the file
whenever you have finished reading the file and have selected another
file.  You can also setup View to automatically update the screen when
new mail arrives.  This is done through the configuration menus.

ALT-X is the same as f3.  This simply exits view completely.

ALT-Z reads the current mail file and checks for EOF markers.  I have
found that our IBM 4381 sticks control-z characters in mail files.  This
causes view mailer to think it is at the end of file even though there
are more messages waiting.  All messages after control-z characters are
lost.  I would make this routine run all the time except for the fact
that it slows down the initial mail file reading.  Packet radio mail,
and mail directly from the internet does not seem to have this problem.

/ pops up a menu.  Most functions of View can be accessed either through
the menu, or by using the function keys.

Using VIEW

f1:Help.  This displays a simple help screen for those who can't
  remember some of the special keys.

f2:Compose.  This will allow you to create and send your own messages. 
  You must enter something when View asks for 'To:'.  If you just hit
  enter, then the creation of the message is aborted and you are
  returned back to the normal screen.  It is not neccessary for you to
  enter anything in response to 'subject:'.  

  You must have previously configured View in order for it to find your
  editor program.

f3:Quit.  This exits Views, updates any messages that were deleted, and
  returns you to DOS.

f4:Print Msg.  This will print the current message to the printer.

f5:Configure.  Allows you to specify various items about your machine. 
  This screen must be filled-in, else some of the functions won't work
  properly.  All info is stored in the \SPOOL\MAILER.CFG config file.

f6:Split Digests / Read as mail.  (Stand-alone version only) This
  interesting function has the ability to read mail as normal messages,
  or try to split a long message into its' smaller parts.  I use this
  when I receive the info-hams digest.  This takes the 400 line message,
  and breaks it up into all the smaller messages.  It displays each host
  and subject separately.  This allows me to read only those messages
  that I am interested in, and ignore the rest.  This function can be
  toggled on/off and is stored in the MAILER.CFG file as MAILMODE.

f7:Select file.  This allows you to specify another .TXT file as your
  workfile.  For example: I have all info-hams mail come into my machine
  under the userid HAMRADIO.  All packet mail comes in for the userid
  PACKET.  This creates 3 files on my machine HAMRADIO.TXT, PACKET.TXT,
  and MARK.TXT.  Using select, I can choose which information I am
  interested in reading at this time.  Any marked messages are deleted
  before the new file is read.

f8:Transfer.  This will allow you to UUENCODE binary files.  When the
  file is encoded, you can email the file to someone even if the
  gateways don't support binary files.

f9:Forward a Message.  This will read the current message and allow you
  to forward it to someone else.  I use this to send a copy of
  interesting mail to my home machine. 

f10:Reply-to.  This will create a message using the hostname, subject,
  and text of the hi-lited message.  It allows you to reply to a message
  that you are reading.

EGA/VGA monitor support:

You can now have more than 25 lines on the screen when using view.  If
you have an ega or vga system, you set view for the larger text window. 
Set the 25+ parameter in the configuration page to Y.  You will now have
43 lines on an ega system, and 50 on a vga system.  All functions will
resize themselves to work on the larger window.  The larger text window
can be in color or black&white.

MOUSE support:

You can use a mouse to make selections while in view.  Moving the mouse
causes the screen to scroll up/down.  The Left button reads the current
message, while the Right button brings pops up a menu.  

SMTP Packet <> Internet Gateways (Stand-alone version)

View has the capability to push mail onto an Internet gateway.  At first
this would not seem like a big deal, however there are some problems in
doing this.  First of all, most hams have the hostname CALLSIGN.ampr.org.
Unfortunately, most Internet sites don't know about most ampr.org sites.
People on the Internet can't get a mail path to you.  One solution is
to have the local Internet guru setup an alias on a 'known' machine to
point to you.  People on the Internet can send email to the alias (which
is on a know machine), and the host will resend the mail to your home
machine.  This is quite easy to do.  

What happens if someone tries to 'reply' to your messages, or if your
mail gets bumped by the Internet.  It is possible (and most likely) that
the message will get lost or just go around in circles until someone
kills it.  VIEW allows your mail to take on the identity of that alias
when you send mail through the gateway.  Normally you would use F2 to
send mail.  If you use Shift-F2, then the message will be created using
information from the gateway setup instead of the main configuration.

For example:  My home email id is:   mark@ve3pzr.ampr.org
However, if you send email to  ve3pzr@hamster.business.uwo.ca, it will
be resent to my home machine.  I want the local hams to send email to my
home machine, but want the Internet community to send through hamster. 
The gateway setup allows my machine to appear differently to each group
of users.


ADD-ON Manager

What exactly is the add-on manager?

ADD-ON is a part of View that allows you to specify DOS programs to work
with View.  It is simply a fancy dos shell interface.  Anything that can
be ran from dos, should be able to run from within View.  I have written
some programs that I call 'View compatible'.  These programs will behave
slightly different in screen handling when called from within View,
instead of being executed from the DOS prompt.


NOVELL SUPPORT

There is a novell network version of View available.  This allows up to
8 servers to be served from an utility mailer machine, and allows novell
users to send mail onto the Internet (a SMTP server is required). 
POSTMAN.EXE is required to deliver any mail on the LAN.

