April 4 1988



Mailing List Door v1.0

Raymond Andrews



MailDoor allows users to enter their name into a mailing list file,
and to edit that listing at a later date should they move or their
address change. The program is pretty straight forward, taking the first
and last names, company and title(optional), and address.
Once the information has been entered the user may: edit any element
of it, save the entry, or cancel without saving.


=============================================================================


MailDoor is distributed in two versions;

MAILDR-1.EXE to be run on an 8088/8086 processor.
MAILDR-2.EXE to be run on an 80186/80286/80386 processor.


A batch file to run the program need only contain a call to the program,
and then if necessary, a call back to the BBS batch file.


MailDoor is called as follows;

MAILDR-x port time mode graphics log [wd1] ... [wd6]
------------------------------------------------------------

port - must be 1 for COM1, 2 for COM2, or L for local.

time - is the maximum time allowed in the door in minutes (1 - 1400)

mode - must be either S for sysop mode, or N for normal mode.

graphics - must be either G to offer graphics, or N for non graphics.

log - is either N, L, or E, for; No Log, Regular Log, and Extended Log
respectively.

wd1 - wd6 - are up to 6 optional words of up to 20 characters each
that make up the BBS's name.


Port is used to tell the program which com: port to accept input from,
or that it is to be run locally.

Time is an integer value between 1 and 1400. Five minutes is about all
the time anyone should ever need to input their information. One minute
before the end of the time, the user is warned that his time is almost up.
In addition, there is a 90 second time limit between keystrokes.

Mode indicates use of the normal mode, or sysop mode. In the sysop mode
the sysop can Add, Edit, Delete, Print, List, or Sort entries in the list.
The edit and delete options should be usefull for weeding out the "joke"
entries that are bound to pop up on any public bulletin board. The print
option will allow the sysop to print his list on labels up to three wide.
Please be carefull with this though, attempting to print while on a remote
terminal can cause the system to hang if the printer is off. If this happens
you will have to reboot the system manually. For this reason I would
reccomend only using the print option locally. Also, please be sure to
initialize the printer and it's buffer('s) (if any) before printing for
the best results. When using the sysop mode you should remember to allow
yourself plenty of time so the system wont kick you off. The normal mode
is the one that you will want users to be able to run for strictly entering
the information.

Graphics is used to allow the option of ANSI graphics for the user.
When set for G ,the user will be asked if he/she would like ANSI graphics.
If the answer is Yes, they will be displayed. When this option is set for
N ,no graphics will be offered.

Log is used to tell the program wether or not to record entries to a
log file, and if so, how extensively. Saving entries to a file will help a
sysop to figure out who may be putting "joke" entries into the mailing list.
This log file (MAILDOOR.LOG) can be TYPE'ed or PRINT'ed from the Dos prompt
for easy cross referencing with the systems userlog. With Log set at "L"
an entry will be saved in the log whenever an entry is saved. With Log set
to "E", log entries will be made both when an entry is looked up, and when it
is saved.

W1 - W6 make up the BBS name. It's usually best to keep the name short
for the best centering in the title screen.


=============================================================================


Related Files
-------------

The mailing list for MailDoor is kept in the file MAILDOOR.TXT

The log file for MailDoor is kept in the file MAILDOOR.LOG

An optional welcome screen file for MailDoor is MAILDOOR.SCR
if this file is found, and the program has been called in the NORMAL mode,
it will be displayed before the program is run. This file may be usefull for
warning users that an entry log is being kept, or to let them know just
what the mailing list will be used for.

MailDoor does not access any files other than these. This makes it
entirely generic, so that it can run on any type BBS system without
needing to know the format of the user information file('s).


=============================================================================


Maildoor is written entirely in C . It uses no interupts, and does not
modify the com: port settings in any way. This was done so as not to affect
the communications procedures possibly installed by the host BBS system.
When called with 1 or 2 as the port parameter, the program will exit when
carrier is dropped. This program uses both direct port reads, and BIOS
interrupts for com: I/O. When called with Local as the port setting, the
com: port routines are skipped over entirely.



THANKS to my wife Natalie for letting me play on "that stupid computer"
far more than she would ever like too.

THANKS to Thom MacDonald, sysop of Com-Dat for his idea for this
program, and the CONTINUOUS help in trying to get all of the bugs out and
options in.


For the latest MailDoor or any further doorware contact me at:

Com-Dat BBS
Dover De.

(302) 736-6848
300/1200/2400
N-8-1



MailDoor is distributed as Shareware. You are free to use it and
distribute it as you like, All I ask is a small donation of $10.00
if you find it usefull. I dont think $10.00 is too much to ask for any
piece of usefull software, and of course any donations of more or less
than $10.00 will be most greatfully accepted.

Donations To : Raymond D Andrews
C-7 London Village
Magnolia De.
19962




DISCLAIMER
----------

1. This program is provided as is.
2. You may use it at your own risk.
3. There is no warranty of any kind and/or form covering this program,
or its related files.
4. I will in no way be held liable for any damage in any form, wether
inquired or arising from the use and/or misuse of this program.




=============================================================================
NOTE TO WILDCAT USERS an addendum from Thom MacDonald
=============================================================================


Running a Semi closed system because of the usual Pranksters out there,
new users on my system have extremely limited access until I personally
verify them!

I saw the need for this program, where as I sell Equipment and Supplies
through the COM-DAT BBS at special discount rates to the members of the BBS.

I have this program located in 2 areas on my system, in the doors, and from
the main. I have lowered the security on the DropDos sysop function, and
changed the menumd, and menulo to only allow 3 functions in the sysop area,
with menuhi only having sysop access. I personally do not use the Dropdos on
my BBS.

By setting it up as I have, all users have access at 1 place or the other.
New (lower security) users can run it through the DropDos whereas their
security level is not high enough to run it as a Live Program.

If you set it up from the DropDos Function from the main, you will need
Doorwy13.arc to shell it because there seems to be conflict with Wildcats
errorlevel 50 drop which will lock up without it. ** Note ** - Rays
maildoor used from DropDos will have to be configured in the Local mode
as not to conflict with Doorway's Com routine...


=======================

eg. DropDos.bat

echo off
MAKEPCB2
e:
cd\mail
mail.bat

=======================

eg. mail.bat in the mail directory.....

DOORWAY COM1 /G:ON /B:M /O: /S:D:\WILDCAT /P:MAILDR-1.EXE L 10 N G E The COM-DAT BBS
echo off
D:
cd\wildcat
cat

=======================

A typical live door bat would be as follows...

Live.bat

echo off
e:
cd\mail
maildr-1 1 10 N G E The COM-DAT BBS
d:
cd\wildcat
cat

=======================


You will note that I use both the Doorway.Bat and the Live.Bat off the
same directory, using the same exe file to bring it up..It works great and
works off of the same data file....

The usefulness of this program can be of benifit to those who want to
keep some sort of contact with their users, as to News of your BBS, Changes,
Subscription renewals, or Monthly Specials if you sell items over your board
as I do...

Try it out for yourselves, I think you will be impressed with the possibil-
ities you have, or call my BBS (302) 736-6848 and see how I personally use it.


Thom MacDonald
COM-DAT BBS
P.O. Box 411
Dover, De. 19903-0411

Data: (302) 736-6848
Voice: (302) 736-9916

*********************************************
*** Sysops can have immediate access by ***
*** sending me your sign on..name, BBS, ***
*** name, Pword, ect. ***
*********************************************


=============================================================================
End Of Document
=============================================================================