P r o S c r i p t

Script Questionnaire DOOR

Copyright 1990 Samuel H. Smith; All Rights Reserved


This door will ask a PCBoard-style script questionnaire and will save
the results in the standard format. It also has the ability to upgrade
the user security level after answering a script.

This door can be used in conjunction with ProLogon to present automatic
scripts based on security level.



Configuration Files
-------------------

ProScript is controlled by a configuration file. The config file
specifies the script file to use for questions, the answer file where
answeres are stored, and a new security level to assign after completion
of the questionnaire.


Sample configuration file:

INTERRUPT
l:\pcb\gen\script1
l:\pcb\main\answer1
10

----------------------------------
ProScrip Configuration File Format:

line 1 = Driver type (INTERRUPT, BIOS, PCBTRAP)
line 2 = Script Questionnaire Filename
line 3 = Script Answer Filename
line 4 = New security level after answering script (0=keep same level)
note: will only change lower levels to this one, will never
lower the level.



Script File Format
------------------

ProScript can read PCBOARD-compatible "script questionnaire" files. It
also extends this file format to allow a limited form of input
validation.

To perform input validation, you must insert a "validation" line into
the script immediately before the question line. Validation lines must
start with "\" to differentiate them from questions or displays.

Validation lines can have the following format:

\? ;require Y or N response
\# ;require numeric response
\$ ;require any character as response
\_ ;optional but allowed response

Any other character must be entered exactly by the caller. Append extra
underline characters "_" to the end of the validation line to specify a
limit to how long a response is allowed.

Examples: (line numbers are not part of the script file)

1. \$$$$____________________
2. What is your full name? (REAL names only)
3. What is your street address?
4. \#__
5. How old are you?
6. \?_________________________________________________________________
7. Do you plan on contributing to the thru-put of the board (files or msgs)?
8. \?_________________________________________________________________
9. Are you SYSOP of a bulletin board? (YES/NO) (please do script #2 if yes)

Line 1 validates te "full name" question on line 2. The caller is
required to enter at least 4 characters, but it allowed up to 25.

Line 3 asks a normal question and the response is not validated.

Line 4 requires the "age" question to be answered with at least 1 digit,
but limits input to 3 characters.

Lines 6 and 8 requires that the questions be aswered beginning with YES
or NO, but allows a full line of input.



LICENSE
=======

SourceWare: What is it?
-----------------------

SourceWare is my name for a unique concept in user supported
software.

Programs distributed under the SourceWare concept always offer source
code.

This package can be freely distributed so long as it is not modified
or sold for profit. If you find that this program is valuable, you
can send me a donation for what you think it is worth. I suggest
about $10.


Send your contributions to:
Samuel H. Smith The Tool Shop BBS
5119 N. 11th Ave., #332 (602) 264-3969 (2400) - Free node
Phoenix AZ 85013 (602) 279-0230 (HAYES 9600)
(602) 279-2673 (HST 9600)


Why SourceWare?
---------------
Why do I offer source code? Why isn't the donation manditory? The
value of good software should be self-evident. The source code is
the key to complete understanding of a program. You can read it to
find out how things are done. You can also change it to suit your
needs, so long as you do not distribute the modified version without
my consent.


Copyright
---------
If you modify this program, I would appreciate a copy of the new
source code. I am holding the copyright on the source code, so
please don't delete my name from the program files or from the
documentation.


DISCLAIMER
==========
I make no warranty of any kind, express or implied, including without
limitation, any warranties of merchantability and/or fitness for a
particular purpose. I shall not be liable for any damages, whether
direct, indirect, special or consequential arising from a failure of
this program to operate in the manner desired by the user. I shall
not be liable for any damage to data or property which may be caused
directly or indirectly by the use of this program.

IN NO EVENT WILL I BE LIABLE TO YOU FOR ANY DAMAGES, INCLUDING ANY
LOST PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR CONSEQUENTIAL
DAMAGES ARISING OUT OF YOUR USE OR INABILITY TO USE THE PROGRAM, OR
FOR ANY CLAIM BY ANY OTHER PARTY.



Revision History
----------------

28-Jul-89
Initial coding and beta release.

03-Aug-89
Added script validation, time and byte updates.

06-Aug-89
Added a check for F8(dump) to prevent script being accepted.

16-Feb-90
Recompiled with ProKit 3.2 beta libraries.
New support for F6(update user) and F2(lockout) sysop function keys.
Added additional user error messages when inputs are rejected.