file_id.diz
______/\________ _____/\ ________________
\____/ ______// / \\______ ¬\____/
\_/ \_ ¬\/ /\ \| |\ \_/
\ | \ \/ /| /\/ /
\__ _____/\_______/ |___\ __/
·-\/--<GL0BAL 0VERÐOSE>--\/-·<ßmR
·P·R·E·S·E·N·T·S·
* D-ACCESS * Yet another arexx util by the DALAI LAMA of Global Overdose.
* DOCS FOR V1.5 *
The Dalai says, "Yeah, I'll learn C one of these days!"
«»«»«»«» «»«»«»«» «»«»«»«» «»«»«»«»»««»«»«»«» «»«»«»«» «»«»«»«» «»«»«»«»
CHANGES SINCE V1.4
~~~~~~~~~~~~~~~~~~
See sections on CONFIGURATION, APPLICATION FORMAT and SYSOP COMMANDS as all
of these sections have been changed from V1.4. Also the Application format
has changed and your old application will not function properly without some
modification, namely deleting all the ³ characters from the entire app. Have
a look at the new one and you will see what I mean. USE and ENJOY THIS TOOL!
This new upadate contains 2 versions of D-Access, D-Access.REXX is the
RexxPlus compiled version and D-Access.REXX.AREXX is the regular arexx
version. Use whichever one functions best on your system! If you are curious
as to which compiled arexx version you are running, just type Version
D-access.rexx.
-Dalai Lama-
INTRO
-----
Another util? Well yeah, so here's D-Access, a cool arexx util that
fills a niche in the /X package... it even works too. So what does this
thing do? Well I got tired (as I am sure you all have) of looking through
the "Answers" file (you know, that 200-500k monster lurking in every 'NODE'
drawer?!?) for some user that logged in only a couple days ago that
needs to be validated 'cause he didn't leave a message and neither you or your
cosys knew he applied and well, you know what it's like! D-access is a fully
configureable access questionare with lots of features to make it simple for
cosys to validate users, see their questionaires, check out any old
questionaires and a whole shitload of other things that are really quite
useful to help automate your BBS!
OVERVIEW
--------
With D-ACCESS installed you can shitcan all those 'Script' files, delete
those 'ole 'Answers' files and let IT do all the work (well, you and the
Cosys gotta help a little..). D-ACCESS is an Arexx door that can be ran a
couple of ways to get the questionaire. I've got mine set as an MCI command
in the node bulletin (~CC_ACCESS), if the user doesn't fill it out, no
access, simple as that. It has the option of kicking users from area codes
that you pre-set (I.E. Those damn local lame-ass, leechin' mo-fo's!) but of
course you have to hope that locals at least use their right area code. You
can also have it send a donation info text to those that qulify as 'locals'
if you want them to PAY for access (Like I do!) The questionaire is 100%
configureable, with seperate "record" and "send" lines (more on that later),
configureable multi-line responses, configureable hot-key responses, and
conditional responses, the option of 'auto-send' message to sysop, a logon
util that shows new users since you last logged on (works for cosys that
have access to the door too, which makes the sysop mail obsolete!), a nice
sysop function set when run from the menu prompt by someone with access and
well, just about everything I could think of.
INSTALLATION
------------
First, you need to copy the D-ACCESS drawer to your DOORS: directory. It
contains all the files that are necessary for D-ACCESS to operate. Next
copy the BBS:COMMANDS/ACCESS.info file to the BBS:commands dir, you can
reaname this to whatever you want to suit your needs.
CONFIGURING D-ACCESS
D-Access is configured by editing the tooltypes in the D-Access.INFO file
found in the D-Access Drawer. The tool types should look like this:
*NOTE* The first tooltype MUST be SYSOP_LEVEL, this speeds up the reading
process greatly when D-AccessShow is used!
------------------X8 SAMPLE 8X-----------------
SYSOP_LEVEL=250
DONATE_INFO=NO
SYSOP_MESSY=NO
AUTO_GOODBY=YES
ACODE_BLOCK=YES
AREA_CODE.1=513
AREA_CODE.2=606
AREA_CODE.3=812
BLANKLINE_LOGOFF=YES *NEW COMMAND*
COSY_ACCOUNT_EDIT=YES *NEW COMMAND*
COSY_NAME.1=DALAI LAMA *NEW COMMAND*
COSY_NAME.2=FREUD *NEW COMMAND*
SYSOP_PASSWORD=ENTER_ME *NEW COMMAND*
NEWUSER_UPLOAD=YES *NEW COMMAND*
UPLOAD_PATH=BBS:AMIGA/HOLD/ *NEW COMMAND*
DELETE_UPLOAD=YES *NEW COMMAND*
------------------X8 SAMPLE 8X-----------------
SYSOP_LEVEL - This the the minimum level assigned for SYSOP commands in
D-ACCESS. I have it at 250 so that cosys can see the apps
and can validate the users with the internal account editor.
*WARNING* Users that have access equal or higher than this have direct
use of the account editor through D-Access, please be careful
when setting this!
DONATE_INFO - This is a YES/NO switched option. YES means that the file
D-ACCESS.TXT will be sent to the user, you can change the
file to whatever you want, but look at the supplied file
for an idea.
SYSOP_MESSY - YES/NO switched, if YES D-Access automatically puts the user
into Comment to sysop so they can leave you a nice message
after they have completed the application.
*NOTE* SYSOP_MESSY and AUTO_GOODBYE cannot both be YES,
or it will hang up on the user before he leaves a message.
Use ONE ON, ONE OFF at all times.
AUTO_GOODBY - This is a YES/NO switchable option, if YES is selected the
user leaving an application will be automatically logged
off as soon as the application is finished. Click. Also it
hangs up if the user tries to leave another application or
if their application is in the BAD_APPS drawer.
ACODE_BLOCK - YES/NO switchable lets you hang up on users from area codes
you want to avoid new users from (I.E. Local calls,) enter
up to 9 area codes after this option, if NO it ignores all
AREA_CODE.X lines.
*NOTE* AreaCode Block also recognizes phone numbers that are less
than 9 numbers long as being local callers (i.e. 123-4567)
and will act accordingly.
AREA_CODE.X - Up to 9 area codes can be blocked for new users, just list
the ones you want blocked, one per line.
BLANKLINE_LOGOFF - If set to YES this function will display the text
D-Access.NONASWER and then log the user off when they hit
<return> on any Single Line response question without
leaving an answer.
COSY_ACCOUNT_EDIT - YES/NO switchable, this option lets you configure which
users have access to the account editor and forces password
protection for it. These options are set in COSY_NAME.X and
SYSOP_PASSWORD. If this option is NO then any user that has
access to this door can use the account editor without any
password protection.
COSY_NAME.X - Enter as many names as you want, only those listed will
have access to the account editor and must first pass the
password protection. Only works when COSY_ACCOUNT_EDIT=YES.
SYSOP_PASSWORD Enter the password you want to use to gain access to the
account editor. Only works when COSY_ACCOUNT_EDIT=YES.
NEWUSER_UPLOAD With this option switched ON a new user is given the text
D-ACCESS.ULTEXT and then is prompted to begin sending their
file. Upon completion of the transfer the filename is added
to the bottom of their app for easy viewing by the sysops.
This option has 2 sub-settings listed below.
UPLOAD_PATH - This is a full pathname that tells D-Access where to stick
the file if you wish to to keep all the files sent by the
new users for later viewing. This option only has an effect
if DELETE_UPLOAD=NO.
DELETE_UPLOAD - If this option is set to YES then the file that the new user
uploads is automatically deleted after it's info is recorded
in their application. RECCOMENDED METHOD.
THE UPLOAD TEXT
There is a file called D-ACCESS.ULTEXT which contains text that will be
shown immediately before the applicant is prompted to upload. You can change
this to whatever message you want to give the applicants before they start
Sending their newest file.
THE PRESHOW TEXT
There is a file called D-ACCESS.PRESHOW which contains text that will be
shown immediately before the application is given. You can change this to
whatever message you want to give the applicants before they start filling in
the blanks.
THE QUESTIONS FILE * THESE HAVE BEEN CHANGED FROM V1.4!!! *
Now lets have a look at the questions file. The supplied one looks like
this:
-----------------------------X8 SAMPLE 8X----------------------------------
¹REAL NAME
What IS Your Real FIRST Name? ~
¹CITY,STATE & COUNTRY
What CITY, STATE And COUNTRY Are You From? ~
¹GOT THE NUP FROM
Who gave you My NUP? ~
¹AGE
What Is Your Age? ~
¹SYSTEM:
What Computer Do You Own? ~
¹SEX
Are You MALE or FEMALE? ~M/F|MALE/FEMALE
¹BEST TIME TO CALL
When Is The Best Time To Call You? ~
¹GROUP MEMBER
Are You A Member Of A Group? ~Y/N|YES/NO
¹MEMBER OF
²YWhich Group Is That? ~
¹BEEN A MEMBER FOR
²YHow Long Have You Been In This Group? ~
³
¹BBS'S
List 3 Fast BBS's You Are On ~3
³
¹WARES
List Your 3 Newest Wares ~3
³
¹REFERENCES
List 3 GOOD References ~3
¹Agreed To Terms Of Disclamer
THE PøINT BLåNK BBS DISCLAIMER !!!
There is NO GUARANTEE of PRIVACY within this system and all
communications are subject to review and possible censorship by the System
Operator and/or Co-System Operators. ALL users who enter a name into this
system do hereby consent to be bound by the terms contained herein and
assume all risks of whatever nature or kind that may arise through the use
thereof and agree to hold harmless the System Operator, for any activities
regarding the use of this Electronic Bulletin Board System.
The System Operator shall NOT be responsible for the content of this
Bulletin Board System. The views expressed within this board are those of
the Registered Users and NOT necessarily that of the System Operator.
Users of this BBS acknowledge that if they choose to use this BBS they
do so voluntarily and at their OWN risk! Users may be removed from the
system at ANYTIME if in the Sysop's opinion the user hasin any way ABUSED
the Bulletin Board System.
This IS A PRIVATE SYSTEM!!! Usage is strictly limited to authorized
members! Usage by a Regulatory, State, and/or Governmental agency
for any purpose IS STRICKLY FORBIDDEN via various legal regulations as a
violation of our rights of PRIVACY, FREE SPEECH, and other lawful rights
guaranteed by The United States Constitution and other applicable laws and
regulations. Information, data, programming, and/or other information
contained within the system is strickly LIMITED for the private usage of
OUR members. NO other usage or dissemination is authorized by proper,
improper, false or illegal entry or other means of obtaining such
information, data, or programming including unauthorized dissemination by
our members. No member is to knowingly violate FCC, Copyright, Obscenity,
or other regulations. We assume that ALL programming is within the
Public Domain and reserve the right to free usage and copies thereof for the
purposes of testing, review, and archiving of said data or programming
without shareware, fees, or other compensation to others. If any member
advises us to the contrary of these regulations, we will gladly investigate
and remove any materials not compatible with these regulations and is sole
extent of liability herein. The System Operator(s) (SYSOP) is NOT
Responsible for any data contained in this system.
³
Do You Agree To Said Such Agreements and Terms? ~Y/N|Yes/No
²NWhy not? This could affect your access a lot! ~3
¹Member Of A Law Agency?
Are You, or any other member of your family, a member of any agency, group,
organization of an investigative, regulatory, or legal nature, or are you
acting in any capacity either privately or in co-operation with any of the
foresaid? ~Y/N|Yes/No
²YPlease Explain! ~2
¹Agreed To Keep Material Private?
Do you (New Applicant) agree to keep ALL materials/information
transfered/viewed from/on this Bulletin Board System (BBS) to yourself, and
NOT disclose ANY information/programs to anyone else? ~Y/N|Yes/No
²NWhy not? This could affect your access a lot! ~2
¹Permit Use Of This Info In Court
Do you grant permission for the members to use any such information
contained in this questonaire, AND, with your replys to the contained
said questions included in the Questionaire, ONLY in the case of a legal
dispute, battle, claims, or any such legal involved action? ~Y/N|Yes/No
²NPlease Explain! This could affect your access a lot! ~2
-----------------------------X8 SAMPLE 8X----------------------------------
The numbers in front of each line reperesent the type of question being
asked. They must be in the FIRST COLUMN and are as follows.
Left-Alt 1 (¹) This is a comment line. Anything on a comment line goes
in the saved application that you see when you read the app.
This means that you can write the saved questions smaller
than the actual question the user sees, thus saving
space! These have a maximum length of 35 character.
Left-Alt 2 (²) This is a conditional question in the format ²<RESPONSE>
(²Y) where it only asks the question if the response equals
the response to the previous HOTKEY question, for example:
DO YOU SMOKE CRACK? ~Y/N|YEP/NOPE
²YWHAT THE HELL FOR? ~2
In this case the second question would be asked ONLY if the
response to the previous question was "Y" (YEP).
*NOTE* You can now have mulit-line or hotkey questions as the
condition question!
Left-Alt 3 (³) * THIS HAS BEEN CHANGED FROM V1.4!!! *
This option, when used on a SINGLE LINE BY ITSELF, inserts
a blank line in the recorded application. This helps you
keep the recorded apps tidy and easy to read.
~ (The TILDE) The tilde can now be placed anywhere in the apps. It
now initiates the response mode for each question. There are
3 response modes availabe.
~ MODE 1 - TILDE WITH NO TRAILING CHARACTERS. This asks a
one-line short-answer question. The result of this mode is
placed in the app immediately following the text in the
previous ¹TEXT line.
~9 MODE 2 - TILDE WITH A NUMBER FROM 1 to 99 TRAILING. This
option initiates a Mulit-Line response. The user has x number
of lines for the respons. *NOTE* The user can now hit
<return> on a blank line to end the response before the
specified number of lines is reached. You can now prompt for
up to a 99 line response.
~Y/N|YES/NO MODE 3 - TILDE WITH HOTKEY CHARACTERS TRAILING.
This option initiates a HOTKEY response. The HOTKEYS appear
before the vertical bar (Y/N|...) and the HOTKEY WORDS appear
after the vertical bar. (...|YES/NO). The hotkeys are
automatically displayed to the user after the question is
given so there is no need to include them in your
questionaire. When the user types a key the WORD is displayed
so if the user hits "Y" he would see "YES" pop up onto the
screen. You can make the HOTKEYS and the HOTKEY WORDS
whatever you you like as long as they are in the format
KEY1/KEY2|WORD1/WORD2. The result of this mode is
placed in the app immediately following the text in the
previous ¹TEXT line.
PLAIN TEXT - You can use plain text not preceded by ¹,² or ³ anywhere
and it will be sent to the user, so you could have a
disclaimer print to the user but have it save "DISCLAIMER
ANSWER: YES" in the save file without all the other
text.
*NOTE*
~~~~~~
The questionaire parser has been completely re-written, it is now more
efficient and much more flexible. You can now initiate any TILDE command
anywhere in the application and it is no longer dependent on the ALT
preceding characters (¹,²,³) which makes it easier to create a questionaire
to suit your needs. Have a close look at the example questionaire and you
will see what I mean. Also have a look at the SAMPLE_OUTPUT drawer for an
updated sample that matches this new questionaire format!
USING THE AUTO-NOTIFY FUNCTION
There is an extra door included that you can put in your node bulletins
that will show the D-ACCESS.NEWLIST file to users whose access is the same
or greater than the SYSOP_LEVEL in the config file. It shows all new users
that have not been validated yet and enables you to remove message access
for all new users which eliminates lots of unnecessary mail to you the
sysop! There is a bulletin included with the necessary info in it or add
the following line to your NODE.X/BULL.X file and copy the DASHOW.INFO file
to your BBSCMD drawer.
------------------X8 SAMPLE 8X-----------------
~CC_DASHOW
------------------X8 SAMPLE 8X-----------------
NOTES ON FUNCTIONING
--------------------
When a user activates D-ACCESS it translates the handle so that it doesn't
include any illegal file characters (like /, [, ") and opens a file in the
NEW_APPS dir (in the D-ACCESs dir) whose name is the applicants handle. It
is automatically stamped with the users handle, date, time and Phone
Number and can easily be called upon from the D-ACCESS sysop menu.
USING D-ACCESS AS THE BUILT-IN SCRIPT FUNCTION
There are several ways to utilize D-Access, first, it CAN be used as a
replacement for the internal /X SCRIPT files but several features will not
function properly when used as such. /X will not save the new user's account
if carrier is lost during application so you *MUST* turn AUTO_GOODBY OFF, it
will save the D-Access application properly but will not save the user's
account. You must also turn SYSOP_MESSY OFF, since the internal "C"omment
function will not run from the script. Both DONATE_INFO and ACODE_BLOCK may
still be used with no bad side-effects.
------------------X8 SAMPLE 8X-----------------
SYSOP_LEVEL=250
DONATE_INFO=YES
SYSOP_MESSY=NO
AUTO_GOODBY=NO
ACODE_BLOCK=YES
AREA_CODE.1=513
AREA_CODE.2=606
AREA_CODE.3=812
.
.
.
------------------X8 SAMPLE 8X-----------------
USING D-ACCESS AS A NODE.X/BULL10.TXT MCI COMMAND
I have found that the most effective way to install D-Access is to add it as
an MCI command to the NEW USER conference's BULL10.txt (~CC_ACCESS). Using
this method allows you to let the user log on but does not allow then to get
to the menu unless AUTO_GOODBY is set to NO, and appears to run very similar
to the SCRIPT menthod of installation BUT all of the features are fully
funcitional unlike the SCRIPT installation so I reccommend this method.
------------------X8 SAMPLE 8X-----------------
SYSOP_LEVEL=250
DONATE_INFO=YES
SYSOP_MESSY=NO
AUTO_GOODBY=YES
ACODE_BLOCK=YES
AREA_CODE.1=513
AREA_CODE.2=606
AREA_CODE.3=812
.
.
.
------------------X8 SAMPLE 8X-----------------
APPLICATION DRAWERS
There are 3 application storage drawers, NEW_APPS, OLD_APPS and BAD_APPS.
If an application is left in the bad_apps drawer and AUTO-GOODBY is set to
YES then when the user tries to log on and still hasn't been given access
D-Access sends a friendly message saying that the user hasn't been validated
yet and to try back in 24 hours and then hangs up. This keeps new users from
wasting a lot of time at the menu prompt since they don't get that far.
Once an application has been "validated" it is moved to the NEW_APPS drawer
where it is stored unless moved to the BAD_APPS drawer or deleted.
When you move an application into the BAD_APPS drawer it can be considered
dead. The user will not be able to fill out another app and is given a
message saying that their app has been move to the BAD drawer and to please
not call again, sort of a Black Book of users you want to keep off for good.
If AUTO_GOODBY is set it hangs up on them each time they try and call,
hopefully they'll get the picute sooner or later and leave your system alone!
*SYSOP MODE*
~~~~~~~~~~~~
Sysop mode is initiated when a user with an access level greater than or
equal to the sysop access level set in the config file starts the door from
the menu prompt in the bbs. (I.E. type ACCESS at the menu prompt).
*IMPORTANT NOTE*
~~~~~~~~~~~~~~~~
The "S" command will NOT funtion if you enter the door through an MCI
command. As it is set up, there is never any reason to go into your NEWUSER
conference again and I suggest removing access to it from all of your
cosysops. This should be the only conference where D-Access is set up as an
MCI command. I also suggest putting the DASHOW MCI command into
NODEx/bullx.txt. It only shows new users to people that have high enough
access to run D-Access.
From the sysop's point of view he has many functions at hand, like viewing
any application, be it new, old (already validated) or bad, entering the
account editor, moving apps around and deleting apps. Online help is
available as well. D-ACCESS does not automatically validate and give
access to a user (It will in a future update,) so whoever validates the
user has to go into the sysop account editor and set the access for the new
user. The HELP file is quite informative and looks like this:
-----------------------------X8 SAMPLE 8X----------------------------------
<D-ACCESS> V1.5 - HELP FILE
~~~~~~~~~~~~~~~~~~~~~~~~~~~
R <OPTION> = REVIEW (R + App Number) - EXAMPLE: R 7 - Reviews application
#7 in current dir.
V <OPTION> = VERIFY (V + App Number or A=ALL) - EXAMPLE: V 7 - Moves App #7
to OLD Apps drawer. EXAMPLE: V A - Moves ALL apps in current
dir to OLD Apps drawer.
D <OPTION> = DELETE (D + App Number or A=ALL) - EXAMPLE: D 7 - Deletes App
#7. EXAMPLE: D A - Deletes ALL apps in current dir.
K <OPTION> = MAKE BAD (K + App Number or A=ALL) - EXAMPLE: K 7 - Moves App
#7 to the BAD APPS drawer. EXAMPLE: K A - Moves ALL apps in
the current dir to the BAD APPS drawer.
L <OPTION1> <OPTION2> = Re-List all apps in current area.
OPTION1 = list FROM number
OPTION2 = list TO number (OPTIONAL).
EXAMPLE: L - By itself lists all apps.
EXAMPLE: L 100 - Lists app numbers 100 and up.
EXAMPLE: L 50 101 - Lists app numbers 50 to 100.
C = Add A One-Line Comment To Any Application.
Q = QUIT D-Access.
N = Load NEW applications.
O = Load OLD applications.
B = Load BAD applications.
S = Go To The Sysop Accounts Editor.
? = This Help File.
-----------------------------X8 SAMPLE 8X----------------------------------
This help file is the complete list of sysop functions and their useage.
*NOTE*
~~~~~~
There is a new command added since V1.4, "C", now you can limit the users
that have access to the account editor (I.E. make is just YOU), but your
cosysops can leave one-line comments on any applications... this will let
them view the apps and leave you messages on each one as to whether they are
worth a shit or not... this will keep your account editor safe but still let
you be informed of the worthiness of each new user.
FINALLY
-------
By using this utility I have managed to cut the amount of space used for
application responses from:
Node1:answers = 323k
Node2:answers = 253k
Node3:answers = 202k
--------------------
TOTAL = 778k for 112 user applications.
Now I have 7 nodes and since I started running this util I have had 127 new
users and the answer files for all 127 new users is only 110k or about 85%
smaller than what you get with the internal system! Try it!
RELEASE INFO
------------
05-AUG-1993 - V0.1 - INTERNAL BETA RELEASE
VERSIONS 0.2 THRU 1.2 - INTERNAL RELEASE, BETA TESTERS ONLY - NO KNOWN BUGS
07-NOV-1993 - V1.4 - FIRST PUBLIC RELEASE - NO KNOWN BUGS
16-NOV-1993 - V1.5 - SECOND PUBLIC RELEASE - NEW FEATURES - NO KNOWN BUGS
GREETINGS TO ALL MY FRIENDS WORLDWIDE!
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
SPECIAL HELLOS TO: SHADOWER/D&R, CALYPSO/LOGIC, PARADOX/MYSTIC, Bytemaster
and Dr.Chaos.
SUPER-SPECIAL THANX TO MY MOST-EXCELLENT CO-SYSOPS WHO KEEP MY BBS FAST, SAFE
AND A REALLY COOL PLACE TO CALL!!!
ANY SUGGESTIONS OR BUG REPORTS CAN BE SENT TO ME AT THE:
__________ ________ _______________ _________ _
.:::::::::::.\_____ ¬\ _ ¬\___________ ¬\ _____ .:::::::::.
- ------------ / __| \_ | \_ ¬\_ | \_ ¬\_ ---------- -
· _/ \_______/ | / / | / /__ _ o
: _ ______|÷e÷\_________/_____/____|____/_____// :
| _ _ ___________ ____ _______ _________ _____ _____ . |
: \\______ ¬\ |_____\___ ¬\_____ ¬\ | __// :
o / |/ _/ | ¬\_ | \ | \_ . ¬\_ .
- ------- _/ |\ \ | / . \_ | / | / ------- -
.:::::::.\___________/_________/____|_____/__|____/____|____/.::::::::.
GLoBaL oVeRDoSe WHQ GOD-PC USHQ
ARCLiTE ASCii-WHQ DeZ!GN ASCii-USHQ
6.5 GiGS OnLInE, A-3000/MeRcUrY'o4o , 6 NoDeS RiNGDoWN, 1 NoDe PrIvAtE
AMiGA -/- iBM -/- CoNSoLe -/- ASCii
DiAL: +1 - 6o6 - 581 - 3776
SYSoP: dALAi LAMA
STaFF: FrEuD/ GoD, EXoCeT/AtX, SnOw/ LøGIC, ThE ShAdOw/ TdT, G.E.M./ TRsI