MSAuto 1993 by Doug McLean
                          ~~~~~~~~~~~~~~~~~~~~~~~~~~

What is MSAuto?
~~~~~~~~~~~~~~~
MSAuto implements auto-login for DLG BBS/OS. To use it, you need a modem
that supports caller ID, MSCid (the arexx script and executable), and
MSAuto.

These will be quick docs since I am feeling lazy right now.

MSAuto is optional for the user. MSCid generates a data file for fast
access to user's names and phone numbers, MSAuto uses this.


Disadvantages
~~~~~~~~~~~~~
The main dis-advantage of MSAuto is that it by-passes the login.dlgbatch
file. It uses the same method of logging a user in that you probably use
for your main local port. Levels are not implemented in this beta version.

This is a very beta version. It seems to work well, but still lacks a lot
of the features future versions will have.

You can (sort of) get around the problem of not executing the login batch
file by creating a hidden menu entry on your main menu to execute a
menuscript. My login.dlgbatch looks like:

doors:cid/mscid %PORT logs:cid.log "Doug McLean" Y
dlg:msg2new %UNAME "Doug McLean" "Welcome" "dial:letters/newuser"

I also have a force.menuscript, which is attached to the ~ key on the
main menu, and hidden. I set TR0 (in the globals config) to force this
to be executed:

EXE dlgconfig:misc/security/security %PORT Doug_McLean f1 c5 m256 h19
EXE dlg:tdih
EXE dlg:wmail

Both will be executed for a normal login, but only the forced.menuscript
gets executed for an auto-login.


Files Included
~~~~~~~~~~~~~~
MSAUTO       - The auto-login executable
MSREMOVEAUTO - An executable to remove a user from the cid.fast data file
MSADD        - An executable to add a user to the cid.fast data file
MSLIST       - An executable to list users in the cid.fast file


Setting it up
~~~~~~~~~~~~~
Edit your tr0.startup file to replace dlg:door with doors:cid/msauto. See
the included sample tr0.startup file for an example.

MSCid will now ask users if they want to use the auto-login feature, if
you specify Y on the command line. If you don't want to use MSCid, you will
have to use MSADD to add users to the database.


Using it
~~~~~~~~
Not much to say about MSAUTO, once it is set up it does it's thing.
The other executables will print usage info if invoked with no command
line parameters, except MSLIST, which lists users in the data file.


MSADD
~~~~~
USAGE: doors:cid/msadd "First Last" CID-Number

This adds the user to the database. It doesn't check to see if the user
is there already, use MSLIST to check this.

The CID-Number must be the number exactly the same as the number contained
in the t:TRx.CID file, NOT the number formatted as in the user file. No
spaces allowed.


MSREMOVEAUTO
~~~~~~~~~~~~
USAGE: doors:cid/msremoveauto "%NAME" Y|N

This deletes a user from the data file so that they can log on normally
again. If Y is specified, it will ask if you really want to remove the
user (good for online usage), N will remove the user without asking. For
online use, use cli mode. I wrote this to use in a batch file for when
I delete users, but couldn't fined a deleteduser.batch in DLG :-(

MSPURGE
~~~~~~~
USAGE: doors:cid/mspurge p

This deletes any users in the fast CID file that are no longer in the
DLG userlist.

Hints
~~~~~
To prevent a user from auto-logging in, use MSADD to make his phone
number 0000000. He will then have to log in normally. If you do this,
the user will still be able to remove this restriction if he has access
to MSREMOVEAUTO online. MSCid also does this if the user answers NO to
"Use auto-login".


That's All
~~~~~~~~~~
That's about it, if you have questions/comments/etc, feel free to send me
netmail (see cid.doc).

Changes
~~~~~~~
MSAuto now performs the same banned check as MSCid. The name of the text file
to display is doors:cid/banned.autotxt, if it is not found the user will
briefly be informed that they have been banned. I did this to prevent users
calling from banned numbers still being able to log in under a new account
before being booted off. In MSAuto, called from banned numbers are always
dropped (and logged).

The user is now shown the number they are calling from.