Crawly Crypt Collection 1/crawlyvol1.bin/bbs/qbbsfm13/filemail.doc

Text File | 1992-05-14 | 9KB | 172 lines

                      *** QuickBBS F-Mail System v1.3 ***

                         - This program is SHAREWARE -

                       - Copyright (c) 1992  M.J.Matts -

                            - Released 30/04/92 -

             - Many thanks to Robert Darling of FolkeSTone BBS -

  LZH checklist.. if you do not have all the files contact me for the full .LZH

      FILEMAIL.TTP - main FMail program
      FILEMAIL.DOC - This document
      FILEMAIL.CFG - Example config file
      WELCOME.DOR  - Example .DOR file
      SEND.DOR     - Example .DOR file
      RECEIVE.DOR  - Example .DOR file
      FILEMAIL.MNU - Example menu

**** IMPORTANT *** YOU WILL HAVE TO CREATE A FOLDER CALLED 'FILEMAIL' IN THE
SAME FOLDER WHERE YOU KEEP THE MAIN FMail PROGRAM.. THE PROGRAM WILL NOT WORK
WITHOUT THIS FOLDER BEING PRESENT..

         Welcome the the QBBS FMail system. This program is designed to be
used as a local FILE mailing utility for users of your own BBS. All FMail sent
can be tagged with a short one line description or message and can only be
received by the person it is meant for. It supports X,Y and Z modem by using
the XYZ.TTP external driver written by Alan Hamilton. As QBBS FMail is only
for use with QuickBBS it takes advantage of the various settings a user may
have, namely their prefered graphics mode, screen clearing, screen length,
etc..

         QBBS Fmail uses two of QuickBBS's files to gain its information which
are DORINFO1.DEF which should be created when executing QBBS FMail from a .DOR
file and USERS.BBS where various checks are made to make sure FMail is being
sent to/from a valid user of the system. Your DOR file __MUST__ create the
DORINFO1.DEF file in the same directory as your USERS.BBS file for FMail to
work correctly.

                      - Setting up the QBBS FMail System -

         As stated above QBBS FMail needs to use the two QuickBBS files so it
needs to know where they are situated and it does this by reading a config
file called FILEMAIL.CFG. This simply consists of the full path to the system
files. ie.. H:\qbbs\   And that is it.. By including the drive as well as the
path you can have the QBBS FMail program on another drive/partition. The only
specific path that you CANNOT change is the folder where all the waiting FMail
is held.. This is in a folder called FILEMAIL which should be in the same
folder as the main FMail program..

                           - A note about XYZ.TTP -

      This program is used for the transfer of F-Mail and is NOT included in
the LZH file because it is an independant program. You will be able to get it
either from a good PD library or most BBS's. When I was developing File Mailer
I used v2.01 written by Alan Hamilton so I do not know how well it will work
with other versions, due to this I strongly recommend you get the same version
I used, freely available from my own BBS. This program is Shareware and you
are expected to make a contribution to the author if you use it. Without this
program File Mailer will not function as it checks for it's existance before
doing anything. ** XYZ.TTP __MUST__ BE IN THE SAME FOLDER AS THE MAIN FMAIL
PROGRAM OTHERWISE QBBS FMAIL WILL DO NOTHING **

                                 - PARAMETERS -

         File Mailer is a .TTP program (Tos Takes Parameters) which means its
operation is controlled by the type of instructions passed to it when it is
first run. There are four commands that can be passed to it which are RECEIVE,
SEND, QUICKSCAN and SYSOP.. These MUST be passed from within the .DOR files
for correct operation. When QBBS FMail is run the .DOR file must also write a
DORINFO1.DEF file.. The next few sections will describe what each parameter
does and how to use the resulting menus..

QUICKSCAN - This will simply inform a user whether they have any FMail waiting
and if so give them the option to receive it. If they decide to receive it
they will be asked which transfer protocol they want to use, if not the FMail
will be held until they do want to take it.. This is handy if there is a large
file waiting and it isn't wanted on that particular call. This option is best
run from the WELCOME.DOR file which QuickBBS executes immediatly after it has
finished the mail check at log on..

SEND - This allows the online user to send FMail to any other user of the BBS.
When they enter the name it is checked in the USERS.BBS file and if it is not
found the user is informed. Only FMail addressed to a valid BBS user will be
accepted.  All FMail sent will be stored in a folder called FILEMAIL which you
have to create and MUST be in the same folder as the main program.

RECEIVE - This will allow the online user to receive their FMail if QUICKSCAN
was not used or if they did not take it when QUICKSCAN asked them. If more
than 1 FMail item is waiting the online user can decide which to receive. They
can take as many or as few as they like.. Any FMail not taken will always be
kept on hold..

SYSOP - When FMail is run with this parameter you will automatically go
straight to the SYSOP ADMIN MENU instead of having to access it through the
send or receive menus.

         On each of the SEND or RECEIVE menus there will be an extra option if
the Sysop is logged on (locally or remotely). This gives the Sysop the chance
of editing or deleting ANY FMail entries plus you can also remove FMail
addressed to yourself without having to download it.. If QBBS FMail is run
locally it will automatically assume the Sysop is logged on..

         If you do experiance any problems check your SYSTEM.LOG file because
QBBS FMail enters a small amount of info when performing various functions,
this includes possible errors.. QBBS FMail also adds to the UPLOAD.LOG and
DOWNLOAD.LOG depending on what type of transfer has taken place.

         QBBS FMail checks the modem carrier every 20 seconds and will exit if
no carrier is detected.. If the program is first run locally there will be
checks made for the carrier.

         The QBBS FMail System is SHAREWARE so if you do decide to use it you
are expected to register it.. The cost is £10/$20 or the equivalent in your
own currency.. You will then receive a version with the UNREGISTERED logo
missing and your BBS name or whatever in its place. I will give support to any
user but registered users will ALWAYS be given priority. If you have any
suggestions please send them to me because I am always looking for good ideas
to add, again registered users suggestions will be considered much more.
Another plus for registered users, they will receive ALL my latest QuickBBS
programs including others released as Sharware..

The QBBS FMail System is only one of my QuickBBS programs, others include..

Make FILES.BBS - A very comprehensive FILES.BBS management program that has
features such as automatic alphabetic sorting, ALLFILES list generator which
can then be compressed as LZH,ARC or ZIP, prompts you to add a file
description if one does not exist, deletes the FILES.BBS description if the
file does not exist, allows you to specify full file names or extensions that
you DO NOT want included in the FILES.BBS, allows you to have text headers of
different sizes in each FILES.BBS, move or copy a file from one area to
another and will transfer the FILES.BBS description aswell.

Auto Crunch - Automatically generates ALL and NEW files lists and then packs
them into LZH, ARC and ZIP formats aswell as leaving a TXT file, Optional file
count and byte count can be added to each list, No limit on how many days you
want included in the NEW files list.

Download Total - Adds a download count to the FILES.BBS descriptions using
sysop definable brackets, can change existing brackets to new format at any
time.. Keeps a constant total even after the DOWNLOAD.LOG file has been
deleted.

SplitZ - A full duplex ASCII/split screen chat program that can be run as the
External chat program using QCONFIG. Supports users prefered Graphic settings
and will automatically go to Split mode if VT52 is detected, you can switch
between ASCII and SPLIT chat while still in the chat session.. VERY extended
'FUN mode' that allows the Sysop to define upto 100 word changes.
full wordwrap supported in both modes.

         If you are interested in any of these programs or if you have any
suggestions for others please contact me at any of the addresses below.

         If you are making a shareware contribution please try to make the
payment in English currency, if this cannot be done please send registered
post with cash.. This is because it costs me almost as much as the shareware
price to exchange foreign cheques.. if you are having problems or want to know
more, again, use the addresses below..

My Address & BBS Details : Mark Matts               System ST BBS
                           66 Telford Way           300/1200/2400
                           Leicester               10pm to 7am GMT
                           LE5 2LX                [phone]
                           England               Fidonet 2:255/375.3


Happy F-Mailing...