
                          PB-DoS-MaTRiX VeRSioN 1.00
                      < A _LOGIN.PEX for ProBoard 2.10 >
                             (C)1995 ڿ SoFTWaRe
                                     


  --- Introduction ---
Well this is the ProBoard Dos Matrix PEX ... So firstly i'll tell you what
that all means!
  (A)   ProBoard is (arguably the most configurable) bulletin board system
        for MS-DOS based systems.  It is written by Philippe Leybaert!
        If you dont use or know what ProBoard is then this program is
        -useless- to you! <G>
  (B)   Dos Matrix is a program that emulates a dos prompt which is used to
        log into a bbs, and a -lot- more! This program is exactly that.
  (C)   PEX is a Proboard EXecutable - A very fast "door" for ProBoard
        bulletin boards!


  --- Requirements ---
You obviously need a PC running ProBoard 2.10 (It will _not_ work on previous
versions such as 2.01... however it *may* work on future versions - only
time will tell!).  Anyway just try it (since it is shareware you are legally
*allowed* and *encouraged* to try it!) and if it doesnt work then... Well
sorry... I cant test it on *every* system...


  --- Disclaimer ---
Basically, there is NO WARRANTY, blah blah... By running this program you
accept all responsibility for any damage or loss that it may / may not
cause.  In other words, in the unlikely event that this program manages
to ruin your entire life, or you just feel like making my life miserable,
then you *can't* okay? If you dont agree please dont run this program!


  --- Licence ---
Yes, this is a shareware product. This implies that you are encouraged to
distribute this software in its original unmodified form to other people,
places, worlds etc.  You must NOT sell this software in any way, however
a minimal copying fee may be charged to cover the cost of the media /
duplication / shipping / phone call costs.  CDrom/shareware vendors are
included in the above condition. You may not reverse engineer or modify any
of the executable files (ie PEX files) in this package.


  --- Shareware ---
You are allowed to evaluate this software for a THIRTY DAY evaluation period.
If you decide that you would like to continue using this software, you must
register, as described below. Otherwise, you must discontinue using the
software.  Registeration is simple and inexpensive. Here's how to do it:
Write out a cheque (drawn on an Australian bank) or international money order
made payable to "Darryl Young" of value $10 (Australian dollars ONLY),
fill out the registration form and send a printed (or handwritten) copy to
the following address:

        LP Software
        PO Box 24
        Cherrybrook, NSW, 2126
        Australia

And you will recieve a registration code via netmail / email / snail mail
including instructions on how to use it. Easy huh? Well if you have any
questions just contact me at the contact addresses at the bottom of this
document!


  --- Archive contents ---
This software package consists of the following files:
  PBDOSMX.TXT   This file, in case you didnt notice!
  FILE_ID.DIZ   BBS description file, of course!
  INSTALL.QIK   *Quick* Installation guide for impatient people <G>
  _LOGIN.PEX    THE login matrix PEX file.
  _LOGIN.INI    Sample configuration file
  INIT.PEX      The pre-login PEX file
  REGFORM.PRN   Registration form  
  *.ANS         Sample ANSi files

  --- Installation ---
If you could install ProBoard then you can install this matrix! (i *hope*
that's re-assuring!)

I would advise that you install it this way:
 (1) Unzip the archive into a new directory (eg: C:\PB\MATRIX)
 (2) Move the *.PEX files into the pexfile directory (usually C:\PB\PEX).
     Move the _LOGIN.INI file into the pex directory also...
     Move the *.ANS files into the textfiles directory (eg C:\PB\TXTFILES).
 (3) The rest of the files are documentation / sample setups so leave them
     in a safe place :)
 (4) Look at the INI file - read the comments and make sure that it suits
     your setup. I suggest that you change the ANSi's also! :)
 (5) Test it out! Any errors should be logged in the PROBOARD.LOG file.
     If it doesnt work first time then you arent so lucky :( One common
     mistake (believe it or not!) is that you arent running ProBoard
     version 2.10!!!


  --- Configuration ---
All configuration info that the matrix requires can be found in the file
_LOGIN.INI (or if you have renamed _LOGIN.PEX to WELCOME.PEX then it will
search for WELCOME.INI instead). Inside the INI file, each line can begin
with a semi-colon (which indicates that it is a comment and should be
ignored), or it can begin with a variable name (keyword) and followed by a
equals sign and that variable's value.

For example: " prompt = C:\MaTRiX> " would make the prompt be the text
"C:\MaTRiX>" ....

The following is a list of ini variables and their meaning...

KEYWORDMEANING
ans_fatal      "fatal error" ansi filename
ans_video      "video" ansi filename
ans_memory     "memory count" ansi filename
ans_bios       "bios / starting DOS"  ansi filename
ans_login      "login prompt" ansi filename
ans_dir        "dir" command ansi filename
ans_help       "help" command ansi filename
ans_info       "info" command ansi filename
ans_format     "formt" command ansi filename
prompt         the "command prompt"
fast_local     skip login ansi's on local login? [y/n]
mem_count      memory count to be displayed after ans_memory is show? [y/n]
logcmd         log all user commands to PROBOARD.LOG? [y/n]
tell_syspw     show the system password after CHECK is successful? [y/n]
login_name_x   x co-ordinate of name prompt on login screen
login_name_y   y     "       "    "     "    "    "     "
login_pword_x  x co-ordinate of password prompt on login screen
login_pword_y  y     "       "      "       "    "    "     "
login_msg_x    x co-ordinate of status messages on login screen
login_msg_y    y     "       "     "       "     "    "     "
login_syspw_x  x co-ordinate of system password prompt on login screen
login_syspw_y  y     "       "     "       "       "    "    "     "
nup            new user password for the "apply" command (blank=none)
must_apply     are new users allowed to login without running APPLY? [y/n]
min_level      minimum security level the user must have to login [0-65535]
any_name       allow case sensitive names? [y/n]
new_ques       name of the Q-A file
input_char     character in the "background" in the input prompts
input_col      foreground colour on input prompts (0-15)
input_back     background colour on input prompts (0-7)
rego_num       registration number
DEFAULTLANGUAGEPROMPT
txt_axs_denied      "Access Denied"
txt_bad_cmd         "Bad command or filename"
txt_ask_name        "Whats your name?"
txt_ask_pword       "Whats your password?"
txt_max_tries       "Incorrect! Hanging up..."
txt_youre_verified  "You are verified!"
txt_sys_pw_is       "The system password is:"
txt_not_verified    "You are not verified!"
txt_ask_fsed        "Wanna use the full screen editor?"
txt_enter_nup       "Enter New User Password:"
txt_wrong_pword     "Incorrect!"
txt_empty_cmd       "Type DIR for commands"
txt_pre_opword      "Enter"
txt_post_opword     "Password:"
txt_try_again       "Incorrect! Try Again."
txt_pword_logoff    "Incorrect! Hanging up..."
txt_validating      "Validating..."
txt_no_name         "You must enter your name here!"
txt_both_names      "Enter BOTH first + last names!"
txt_must_apply      "You must apply first!"
txt_bad_name        "Invalid name!"



  --- Built-In Commands ---
COMMANDFUNCTION
logoff   same as the "Logoff" menu command - displays GOODBYE.ANS + hangs up
login    displays login screen & logs caller on.
help     displays HELP.ANS
info     displays INFO.ANS
dir      displays DIR.ANS
message  allows user tio enter a name and write a msg under that name
page     pages the sysop for a chat. same as page sysop menu command.
check    check to see if the caller is verified (ie has security > min_level)
apply    apply for access - logs into bbs after getting new user pword right
cd,cls   \
format    > "DOS Compatability" commands. Format displays FORMAT.ANS
del,exit /


To disable any command (built-in or sysop defined), assign it to "n" in
the INI file... For example "login = n" in the INI file would disable the
"login" command.


  --- Sysop Definable Commands ---
You can define commands that are not contained in the built-in command
set... Each command will execute a menu function (eg: run PEX file or
execute questionaire etc...).  The registered version has an unlimited
number of sysop-definable commands (Unregisted has one).

In the INI file you must have the following:

KEYWORD
other_cmd    the number of sysop definable commands that are defined
other_cmd_#  the command name where # is the command number (starting from 1)
other_nam_#  if set to "y" the user will be asked to enter a name
other_run_#  the number of the menu command followed by the options line
other_pwd_#  the password required to access the comand [blank=no password]


; example of a sysop-defined command called "DOWNLOAD"
other_cmd = 1
; command line = DOWNLOAD
other_cmd_1 = DOWNLOAD
; ask for name
other_nam_1 = y
; ask for password
other_pwd_1 = PASS
; menu command #32 - options "/F=[1]BEYOND.APP /I /T"
other_run_1 = 32 /F=[1]BEYOND.APP /I /T
;*** end of exapmle ***


  --- Special characters ---
In the ansi files and the prompts that you can define in the INI file,
you can use special sequences to change the foreground colour, or delay the
output by a specified time given in milliseconds.

Colours:
To change colour, use a two letter sequence, where the first letter is
the letter ` and the second letter is a number from 0 to 9 or A to F.
example: `1 will change the colout to dark blue while `E will change
the colour to yellow. Not that hard... is it?

ColourLetter
Black        0
Blue         1
Green        2
Cyan         3
Red          4
Purple       5
Brown        6
White        7
Gray         8
Lt Blue      9
Lt Green     A
Lt Cyan      B
Lt Red       C
Lt Purple    D
Lt Brown     E
Lt White     F


Delays:
To add a delay in an ANSI or a prompt, just enclose the delay in milliseconds
in two ~ symbols.
example: ~1000~ will delay the screen output for one second.


  --- Setting up a private bbs ---
Firstly, you can prevent new users from gaining access until they are
verified by the sysop.  You do this by:
 (1) setting "must_apply = y" in the INI file to disable new users from
     using the LOGIN command.
 (2) setting "min_level = 10" in the INI file to set the minimum login
     security level to 10 (for example) to stop new users from entering the
     BBS until they are verified.
 (3) setting up a new user password (if needed) in the INI file using
     the command "nup = pword" where pword is the password.
 (4) setting up a system password in PROCFG if needed. Make sure that
     you set "use system password" to "NO", or else ProBoard will ask
     for the system password before the login matrix is run. If you enable
     the system password it will be asked before the user name in LOGIN.
 (5) if you want to tell the system password to the user after a successful
     CHECK, then set "tell_syspw = y" in the INI file
 (6) if you want the new user to answer a questionaire, set
     "new_ques = [name]" where [name] is the name of the .Q-A file to
     run before being logged in as a new user. Here you can add for example
     a menufunction to the Q-A to force the new user to write a message
     to the sysop or to all in a message area, for example.
 (7) copy _LOGIN.PEX and _LOGIN.INI to NEWUSER.PEX and NEWUSER.INI
     so that when they login as a new user they cant enter the bbs until
     they have a security level above the "min_level".


  --- Contacting the author ---
My name is Darryl Young, and you can contact me several ways:

  Beyond Reality BBS: (+61-2) 9484-4804 24 hours (fidonet 3:711/951)
  Fidonet Netmail: "Darryl Young" at address 3:711/951
  PB-Net Netmail: "Darryl Young" at 246:8501/2005
  Internet Email: dyoung@extro.ucc.su.oz.au  (well at least for a while)
  Snail Mail: LP Software, PO Box 24, Cherrybrook, NSW, 2126, Australia
  Echomail: I am connected to the fidonet "PROBOARD" echo and most PB-Net
            echos. I should recieve any personal mail in these areas.
            Of course, Netmail is prefered by most echomail moderators! :)

The latest copy will be available for file request from Beyond Reality BBS
at 3:711/951 under the name "MATRIX", and copies will be posted on as many
proboard-specific internet ftp-sites as possible.  This will most probably
include the PB-Net site at "wl.iglou.com" or "ftp.iglou.com" in the
directory "/members/pbftp". Otherwise try the WWW page at 
"http://www.usyd.edu.au/~dyoung" for more details.  It will also hopefully
be hatched into the PB-Net file distribution network...


  --- Trademarks ---
The following trademarks were used in this document so please observe them
as trademarks! :)
  ProBoard, PB-Net, FidoNet, Zip

  --- The End ---
<sigh>.  You know, writing a document is a horrible job! At least its
finished! Well perhaps not totally finished, but it will have to do! :)


                    PB-DoS-MaTRiX VeRSioN 1.00ķ
                            (C)1995 ڿ SoFTWaRe        
                                                     
                    Ľ

