
Installation
------------
This is a 32 bit console program, and hence requires Win95 or NT.

There is no installation needed as such. All that is required is that
an appropriate directory structure is in place, tcp/ip is functioning
and you have the appropriate files.

The individual maildrops are all kept in their own subdirectory from
a root maidrop directory ( [MBOX] ). 

        [MBOX] -
                |
                |-[USER1]
                |
                |-[USER2]
                |
                   etc

There should be a directory that will contain the mails waiting to be
routed ( [QUEUE] ).

There should be a directory that will contain the mails waiting to be
sent to the smarthost ( usually your ISPs SMTP server ) [OUTBOUND].

There should be a directory that will contain the .FGR files for
users that want to be able to be 'fingered' ( [FINGER] )..

The suggested layout for all the files is...


    [JSMAIL] ---
    mail.exe    |
    mail.conf   |
    passwd      |
    responders  |
                |
                |- [MBOX] -
                |          |
                |          |-[USER1]
                |          |
                |          |-[USER2]
                |          |
                |             etc
                |
                |- [FINGER]
                |    user1.fgr     
                |    user2.fgr      
                |         
                |      etc
                |   
                |         
                |-[QUEUE]
                |
                |-[OUTBOUND]



The password file ( passwd ) contains all the valid users passwords and 
aliases. The format for entries in this file are...

    username,u,password
or  username,r,password
or  username,f,password
or  aliasname,a,username,username,...

u indicates an ordinary user
r indicates a user that is allowed to start a remote console
  for the server or use mailcmd.exe.
f indicates a user that is allowed to redirect their mail via
  a remote console or mailcmd.exe
a indicates a alias


Passwords can be changed by the users by telneting to password port
(defaults to 5001 )


There is a utility that uses the same encryption algorithm ( code.exe )
so that you can add entries to the password file. It takes its input
from stdin and writes to stdout.


The reponders config file is of the form

    a,b,c,d
or  a,b,c
or  a,b,!,d
or  a,b


where 

    a = subject to look for
    b = text_file_to_return
    c = executable_to_run, possibly to generate b
    d = user_to_forward_mail_to
    ! = place holder - do not execute anything

If an executable is given, it is called with the name of the file
containing the original mail as its only parameter.


The finger files ( *.fgr ) are of the form


    Some 
    text
    [WIDE]
    Some more
    Text


The text before the [WIDE] marker is returned as the short form. The 
whole text ( without '[WIDE]' ) is retyrned as the long form.

Starting
========
On windows 95, the program is started 

    mail

you can optionally give the configuration file as an argument. If you
do not, mail.conf is assumed.

    mail c:\jsmail\mail.conf

Under NT, you must also add -console

    mail -console
or  mail c:\jsmail\mail.conf -console


NT Service
==========
JSMail can be installed as a service under NT. At the
comand prompt enter

    mail [config_file] -install [service_name]

config_file defaults to mail.conf and service_name defaults
to JSMail. It can be installed several times under different
service names. This is useful for mult-homed machines and each
instance of JSMail is to run bound to a different address.

To start the service, either use the control panel services applet
or at the prompt enter
    net start JSMail

Once installed, it can be removed by entering
    mail -remove  [service_name]


System Tray
===========
JSMail can be run in the system tray - specify -tray on the 
command line

    mail mail.conf -tray

or at the JSMail> promtp, enter 'tray'.

When running in the tray, double left clicking on the icon
will restore the console. Double right clicking will terminate
JSMail.


Commands
========
Various commands are available at the jsmail> prompt - type help
or see the 'commands.txt' file enclosed.


General
=======
Also enclosed is a command-line utility to send mail to an SMTP
server - xmail. The text to be sent can either be entered at the
prompt or redirected in from a file.


Also enclosed is a remote-control utility that allows single
commands to be sent to the server from the command-line (mailcmd.exe),
and a utility to read a standard unix mbox file and send it to an 
smtp server ( mbox2smtp.exe ).


Please ensure you have the TZ environment variable set up correctly. This
tells various programs about the timezone you are in.

For Britain, this would be something like TZ=GMT0BST1 if your machine is
set to use British Summer Time, or TZ=GMT0 if not.

If it is not set, it defaults to Pacific Standard Time (PST8PDT).


Comments/questions to:
E-mail: jsmail@j-bg.demon.co.uk




