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.

JSMail can be run as a service under NT. To do this, you need a copy
of srvany.exe (from Microsoft NT Resource Kit).

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.cfg   |
    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





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.


The program is started giving the configuration file as the 
only argument.

    mail c:\jsmail\mail.cfg


Various commands are available at the jsmail> prompt - type help

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@earthling.net
        or john@j-bg.demon.co.uk