______/\________ _____/\ ________________ \____/ ______// / \\______ ¬\____/ \_/ \_ ¬\/ /\ \| |\ \_/ \ | \ \/ /| /\/ / \__ _____/\_______/ |___\ __/ ·-\/----\/-·<ß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 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 ² (²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 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---------------------------------- V1.5 - HELP FILE ~~~~~~~~~~~~~~~~~~~~~~~~~~~ R