home *** CD-ROM | disk | FTP | other *** search
Text File | 1991-03-10 | 46.6 KB | 1,189 lines
DR. MATCHER All-Purpose Matchmaker for RBBS Systems Sysop Documentation RELEASE 0.98a 03/07/91 (C) 1988, 1989, 1990, 1991 Kevin Patz Capital of NH BBS (603)228-3820 Dr. Matcher is an all-purpose questionnaire matching system designed to be accessed as a "door" from RBBS-PC, version 15-1C through 17-3B and beyond, or from single and multi-user versions of Wildcat!, or PCBoard 14.0. Users who enter this door are given a series of questions defined by the sysop. The answers are put on file for other users to match against. The user can then set his preferences; i.e., what the user is looking for in his or her matches. This makes Dr. Matcher very flexible by allowing the user to find users that match his liking, even if it is very different from what he is like. Dr. Matcher then compares his preferences against other users' questionnaires; the percentages are calculated and the users listed, highest matches first. He can then view the matching questionnaire answers. Since the questions are completely sysop-defined, Dr. Matcher can be used for an unlimited range of applications. For example, a BBS run by an employment agency may use Dr. Matcher to match potential employers with employees. A BBS may use Dr. Matcher to allow users to learn more about one another or to "match up" users with the same computer type, etc. Then there's computer dating. The individual preferences with the "MUST MATCH" feature is useful for dating applications. A single man may want only single women to be listed. He would set up his preferences so that "female" and "single" MUST MATCH or the "match-ee" is not displayed. This .ZIP file or diskette contains the following files: DRINIT.EXE (Dr. Matcher Initialization Program) DRINSTR.DOC (Dr. Matcher user instructions) DRMATCH.EXE (Dr. Matcher Program) DR-OPEN.DOC (Dr. Matcher opening messages) DRQUEST.ASC (Sample ASCII questionnaire) DRSYSOP.DOC (This documentation) DRTO96.EXE (Conversion program from 0.95 to 0.97-up) Dr. Matcher 0.98a (C) 1991 K. Patz Page 1 Dr. Matcher 0.98a (C) 1991 K. Patz Page 1 Dr. Matcher 0.98a (C) 1991 K. Patz Page 1 Dr. Matcher License No, I'm not going into "legaleze". I'm not going to say "register your copy or I'll have your head removed." I'm not going to say anything is "strictly forbidden." No shrink wrap. No "crippled" demos. You may take this copy of Dr. Matcher and do what you like with it. However, for the sake of sanity (for both the sysops who use Dr. Matcher and me), I recommend that you abide by the following guidelines: Distribute it with the original files intact. It's ok to "zoo" it or otherwise pack it into a form other than the PKZIP I used, just as long as whoever downloads it ends up with the same stuff I uploaded. Do not alter or remove any copyright messages in the documentation or programs. Bear in mind that this program is being developed in my spare time (which is very limited) and that not all features may work properly. For example, some of the sysop functions aren't even implemented yet. If you do find bugs or ideas for enhancements, I'd like to know about them. My BBS number is at the top of this file, or you can reach me at the following BBS's: CompuServe 73007,3311 In the present stage, Dr. Matcher is compatible with RBBS-PC 15-1C and later, Wildcat!, PCBoard 14.0, and other BBSs that use a compatible DORINFOx.DEF or CALLINFO.BBS file. Support for other BBS's (Opus, etc.) is planned in the future. If you like Dr. Matcher, please register your copy. Registering Dr. Matcher and other shareware packages makes it possible for shareware authors to continue providing high quality software at a reasonable cost. Three registration options are available: Registration only. . . . . . . . . . . . . . . . . . $20.00 Registration and diskette updates. . . . . . . . . . $25.00 Registration, diskette, and printed documentation. . $30.00 Please make checks payable to Kevin J. Patz, and send to the following address: Kevin J. Patz 1 Oak Street Concord, NH 03301 If requesting diskette updates, please specify the desired If requesting diskette updates, please specify the desired If requesting diskette updates, please specify the desired diskette size and format (e.g. 5.25" high-density). diskette size and format (e.g. 5.25" high-density). diskette size and format (e.g. 5.25" high-density). Dr. Matcher 0.98a (C) 1991 K. Patz Page 2 Dr. Matcher 0.98a (C) 1991 K. Patz Page 2 Dr. Matcher 0.98a (C) 1991 K. Patz Page 2 Capital Doorware Features Dr. Matcher is 100% home-grown. No code was taken from other door programs. This allowed maximum flexibility in designing the door interface and the program itself. Several Dr. Matcher features will be standard in any doors I write in the future. * Sysop can Define the maximum number of users, answers and preferences per question. Each available answer or preference to a question takes up disk space. The space required increases as the number of users increases. The sysop can decide how much space he is willing to set aside. * Data files can be fixed or variable length. Fixed-length files can hold a specified number of users, but will work in any "shared" environment, such as LANs and multi-node BBS's. Variable-length files "grow" in length as users enter the database. While this allows as many users as disk space allows, some networks or multi-tasking operating systems may not support this option. Dr. Matcher supports either fixed or variable length files. * Maximum session time in the door can be set by the sysop. However, the time limit will never be greater than the time the user has available in the BBS session. The sysop can choose to limit time only by the BBS time remaining. The door program will warn the user when his or her time is almost up. * The maximum idle time can be set by the sysop. If a user sits idle for too long, the door will exit back to the BBS. A thirty-second warning is given to get the user's attention before exiting. * Any "beeps" sent to the user by the door will not be heard locally by the sysop, allowing the sysop to sleep better at night. * The door will, at the Sysop's option, drop DTR to the modem if the carrier is dropped. This feature is useful for BBS systems where the modem answers the phone instead of the BBS. With DTR dropped, the modem will not answer the phone until the BBS is safely reloaded. * The DORINFOx.DEF or CALLINFO.BBS file written by the BBS doesn't have to be in the current directory where Dr. Matcher resides. The sysop can specify a path to find the file, eliminating the need to copy it to the door directory if the sysop doesn't put the door in the BBS's current directory. This path can be fixed (set up during initialization), or specified via a command-line option. This is useful for multi-node Wildcat! BBS's. Dr. Matcher 0.98a (C) 1991 K. Patz Page 3 Dr. Matcher 0.98a (C) 1991 K. Patz Page 3 Dr. Matcher 0.98a (C) 1991 K. Patz Page 3 * In addition to checking the user name to see if it matches the sysop name, a minimum security level can be specified for sysop access. This feature is useful for BBS systems with co- sysops, where the sysop may want other users to be able to access the Dr. Matcher sysop functions. * Minimum security level to access the door, as well as a minimum security level for first-time access to the door, allow access to be restricted for whatever reason. Like RBBS conferences, the door can be made public, private or semi- private. * Individual override security levels can be specified. This provides the ultimate in flexibility. Up to ten individual security levels can be granted access to the door, regardless of the minimum security. In addition, up to ten security levels can be denied access to the door, regardless of the minimum security. An example of where this might be used is if you wanted to set up an "adults-only" Dr. Matcher questionnaire. You could set up your security levels as follows: 5 = normal user; 6 = adult normal user; 7 = contributing user; 8 = adult contributing user; 9 = donating user; 10 = adult donating user, and so on. You would then set up the override security levels to grant access to the door if you're at level 6, 8, or 10, and deny access to 5, 7, and 9. The Sysop is not restricted by security levels. * Support for RTS/CTS flow control is available, for users of high-speed and/or error correcting modems. * A daily maintenance routine automatically deletes users who have not accessed the door within the number of days specified by the sysop. The maintenance routine can run automatically each day when the door is invoked, or can be run separately (during a nightly maintenance cycle). * User records can be added, changed, or deleted by the sysop. The sysop can lock out individual users if necessary. * "Hang-proof" error trapping code has been incorporated. Even if a totally unexpected run-time error occurs, it is reported to the user (if possible), logged to an error file, and the program exits gracefully to the BBS, without waiting for a local sysop to "strike a key to return to system." * The sysop can take the user into chat anytime while the door is in operation. In addition, an emergency key will bail the door back out to DOS (and then to the BBS) in the event of a hang or an abusive user. * Baud rates up to 38400 are supported. * Sysop can include him or herself in the questionnaire with the option to remain anonymous (use the name "Sysop"). Dr. Matcher 0.98a (C) 1991 K. Patz Page 4 Dr. Matcher 0.98a (C) 1991 K. Patz Page 4 Dr. Matcher 0.98a (C) 1991 K. Patz Page 4 * Access to the user editor is limited to those with sysop access; in addition a password can be specified which the user must enter in order to access the editor. * Either BASIC communication I/O routines or a FOSSIL driver can be used for modem communication. The BASIC routines don't require any special drivers, but support only COM1 and COM2. By installing a FOSSIL driver, Dr. Matcher can access COM1-COM8 with no special action required short of installing and configuring the FOSSIL driver, and telling Dr. Matcher to use it. * Users with ANSI color support can access Dr. Matcher in color. The sysop has the option of suppressing colors on the local display, which is helpful for sysops with monochrome displays. No longer does the sysop have to squint to read a full screen of underlined text if a user chooses to use "blue" text. Dr. Matcher 0.98a (C) 1991 K. Patz Page 5 Dr. Matcher 0.98a (C) 1991 K. Patz Page 5 Dr. Matcher 0.98a (C) 1991 K. Patz Page 5 THE QUESTIONNAIRE The questionnaire is initially defined in an ASCII file. A sample questionnaire called DRQUEST.ASC is included in the archive. This file is read by DRINIT to produce DRQUEST.DR, the questionnaire file formatted for use with Dr. Matcher. The format for the questionnaire is as follows: ?question1 prefix # (max number of answers to this question) answer1 answer2 ?question2 prefix # (max number of answers to this question) answer1 answer2 The question prefix is prefaced by a question mark (?) and consists of the beginning part of the question. For example, if the question regards eye color, the prefix would be "?My eyes are". The user's answers are appended to this prefix when viewing the questionnaires. The max # of answers to this question is a numeric value (1 or greater) which specifies the maximum number of answers that will be accepted for this question. For example, for sex (male or female), you'll want to allow only one answer since nobody is both male and female. For eye color, you'll probably want to allow two for mixed colors. For hobbies, you'll want to allow more answers. Answer1, answer2, etc. are the answer choices for the question. A sample question format follows: ?I drive a 2 car truck bus van The maximum number of answers that can be given to this question are 2, and there are four choices to choose from: car, truck, bus, or van. When viewing, "I drive a" is followed by the choices given; for example, "I drive a truck." Blank lines can be inserted anywhere in the ASCII questionnaire file as they are ignored by DRINIT. Comment lines start with a semicolon (;); these are ignored by DRINIT. Dr. Matcher 0.98a (C) 1991 K. Patz Page 6 Dr. Matcher 0.98a (C) 1991 K. Patz Page 6 Dr. Matcher 0.98a (C) 1991 K. Patz Page 6 DRINIT DRINIT, the Dr. Matcher initialization program, loads the initial questionnaire and setup information for your Dr. Matcher. This program should be run only once, when you first set up the program. DRINIT will ask you a series of questions regarding the desired configuration of Dr. Matcher. The questions, and explanations, are given below. Enter the name of the ASCII file containing the questionnaire to be loaded. Default: DRQUEST.ASC: DRINIT is asking for the name of your ASCII questionnaire file, as defined above. Specifying no file name tells DRINIT to use DRQUEST.ASC. DRQUEST.ASC, which is included with Dr. Matcher, is an all-purpose file which is good to start with. This file is read to produce the Dr. Matcher questionnaire file DRQUEST.DR. What's the maximum number of answers a user can give per question? Dr. Matcher needs to assign file space for each answer a user gives to a question. Therefore, the sysop needs to define the maximum number of answers a user can give per question. The recommended amount is the largest number of answers that can be given to any question defined in the questionnaire file. For example, if one question in your questionnaire allows 8 answers, you should set this value to 8. There is a maximum of 26 answers per question (A-Z). What's the maximum number of preferred answers a user can give per question (when matchmaking)? Each takes up 23 bytes of disk space per user. Preferred answers, or preferences, are the answers to the questionnaire that a user wants to see matched against. When a user invokes the matchmaker, his or her preferences are matched against the other users' questionnaire answers. This provides great flexibility since the user's own questionnaire answers (which should reflect him or herself) don't have to be what he or she matches to (which may be completely different). I recommend allowing as many preferences as disk space will allow, but not more than the largest number of choices for a question in the questionnaire. What's the maximum number of users who can access Dr. Matcher and save their questionnaire results and preferences? Dr. Matcher 0.98a (C) 1991 K. Patz Page 7 Dr. Matcher 0.98a (C) 1991 K. Patz Page 7 Dr. Matcher 0.98a (C) 1991 K. Patz Page 7 The amount of disk space required per user is shown. This value defines the maximum number of users that can be in the Dr. Matcher file at one time. Unless disk space is tight, I recommend as many as your BBS system will handle. If a user enters Dr. Matcher and there is no room for his or her questionnaire, the user can access Dr. Matcher as a "guest", provided that questionnaires are not required (see below). In Dr. Matcher 0.96 and up, you can specify zero (0) as the maximum number of users. If this is done, the user and questionnaire/preference files will be initialized to a length of zero, and the files grow as users are added. The number of users is limited only by available disk space. However, some multitasking or network environments don't handle extending files properly. If you have a multi-node BBS and user records are being lost or garbled, try switching to fixed-length. What's the maximum number of minutes allowed per session? 0 indicates to limit time only by time available in the BBS session. Dr. Matcher allows you to set a session time limit in addition to BBS's built in time limits. If you specify a time limit here, a user can remain in Dr. Matcher no longer than the specified number of minutes, even if BBS allows more time. If you specify 0, then the only time limit will be the time remaining on the BBS. What's the maximum number of minutes that a user can be idle? If a user stays idle (doesn't respond to a prompt) for more than the specified number of minutes (I recommend 3 or whatever you use for maximum idle time on the BBS), Dr. Matcher will exit back to the BBS. A thirty second warning will be given beforehand. Drop DTR if carrier lost (Y,[N])? y This feature is useful for sysops who are "shooting themselves in the foot" by setting RBBS to answer on zero rings. If this option is set to Y, Dr. Matcher will force DTR low when carrier is lost, so the modem won't answer the phone until RBBS or Wildcat! is safely reloaded. However, some modems (such as the US Robotics Sportster 2400PC) may malfunction when this option is used. 0) RBBS-PC 1) Wildcat! 2) PCBoard 14.0 Select BBS type: If you're running RBBS-PC 15-1C or later or another BBS which uses the DORINFOx.DEF file, answer 0. If you're running Wildcat!, or another BBS which creates a compatible CALLINFO.BBS file, choose 1. If you're using PCBoard 14.0 (or compatible), choose 2. Dr. Matcher 0.98a (C) 1991 K. Patz Page 8 Dr. Matcher 0.98a (C) 1991 K. Patz Page 8 Dr. Matcher 0.98a (C) 1991 K. Patz Page 8 Enter the drive and/or path where DORINFOx.DEF can be found when Dr. Matcher is started. DORINFOx.DEF is created in the current directory where RBBS- PC resides. Specifying the path here eliminates the need to copy DORINFOx.DEF to your Dr. Matcher subdirectory in your door batch file. Enter the drive and path only, not the filename. The fully qualified pathname will be displayed for confirmation. If you don't enter a drive, the default drive will be used. If you don't specify a path, the current directory will be used. For Wildcat! users the file is CALLINFO.BBS instead of DORINFOx.DEF, and for PCBoard users it is PCBOARD.SYS and USERS. This path can be overriden with the /P command line option. Use /P if your file will be coming from a different directory for each node (e.g. multi-node Wildcat!). Enter the password that the Sysop must enter to access the editor. For security reasons, when a remote (not local) sysop uses the D command to access the editor, a password is required. Here you can set this password. It must be at least four characters, and upper and lower case are treated the same. DRINIT will allow you to confirm and correct the password before proceeding. Should password be required to access editor locally (Y,[N])? If you want to make it necessary to enter the editor password when logged on locally, answer Y. Answering N will make it unnecessary to enter the password when logged onto the BBS locally. Enter minimum security level to access Sysop functions. This option allows you to specify a minimum security level for access to Sysop functions (D-editor and L-list log). Note that this security level applies only to users other than the main sysop. The main sysop has full sysop access regardless of the security level. This level allows you to grant Dr. Matcher sysop access to other users based on security level. If you want no other users to have sysop access, set this level to a very high value (32767). Dr. Matcher 0.98a (C) 1991 K. Patz Page 9 Dr. Matcher 0.98a (C) 1991 K. Patz Page 9 Dr. Matcher 0.98a (C) 1991 K. Patz Page 9 Enter the minimum security level required to access Dr. Matcher: Dr. Matcher's access can be restricted by security level. This level is the minimum required for any user to access Dr. Matcher. Note that the Individual Override Security Levels explained below have precedence over this minimum security. Enter the minimum security for new users to access Dr. Matcher: This is the minimum security level for new users (users not in the Dr. Matcher user file) to join (be auto-added) to Dr. Matcher. By setting these levels appropriately, Dr. Matcher can be open (available to all), semi-private (available only to users with a minimum security), or closed (available only to users specifically added to the user file by the sysop). You can specify up to ten security levels which will be allowed access to Dr. Matcher regardless of the minimum security. To specify less than ten, leave the remainder blank. To specify none, leave all blank (or zero). INDIVIDUAL OVERRIDE SECURITY LEVELS add a new dimension of flexibility to access control of Dr. Matcher and future CNHBBS doors. Up to ten individual (not minimum) security levels can be specified that will be GRANTED or DENIED access to Dr. Matcher, regardless of the minimum security level. This feature would be useful for sysops who want to set up an "adults only" Dr. Matcher questionnaire. Alternate security levels could be defined for adults and non-adults on the BBS. Only the adult levels would be granted access to Dr. Matcher, yet the levels in the BBS could be arranged so that you can have a hierarchy of levels (new user, registered user, contributing user, sysop, etc.) This prompt lets you specify up to ten security levels that will be granted access to Dr. Matcher. You'll be prompted ten times for security levels. If you have less than ten (or none), simply press Enter through the remaining prompts. The next prompt works the same way, but lets you specify up to ten security levels that will be denied access to Dr. Matcher. Does your modem use RTS/CTS for flow control (Y,[N])? If you use an error-correcting modem, a high speed modem (over 2400 bps), a setup where the phone line rate is different from the rate between the modem and the computer, or any other situation where hardware flow control is needed, answer Y to this prompt. Software (XON/XOFF) flow control is supported regardless of the answer to this prompt. Dr. Matcher 0.98a (C) 1991 K. Patz Page 10 Dr. Matcher 0.98a (C) 1991 K. Patz Page 10 Dr. Matcher 0.98a (C) 1991 K. Patz Page 10 Will users be required to fill out the questionnaire (Y,[N])? If you answer N to this prompt, users can access the matchmaker function without filling out their questionnaires (only preferences are needed for matchmaking). However, the sysop may feel that too few users are filling out their questionnaires, making for few matches. If this is the case, answering Y to this prompt will require users to have an active questionnaire in order to invoke the matchmaker. In addition, the Toggle Questionnaire on/off (T command) will be unavailable to users, unless the Sysop hides the user's questionnaire, in which case the user can unhide it with the T command. In addition, users will be denied access if the users file is full, since such users cannot file a questionnaire. How many lines for a user profile (0 for none)? If you specify a number (n) of lines here, users will be able to file comments about themselves along with their questionnaire (up to n 72-character lines); this information can be viewed while matchmaking. If you specify 0, then users will not be able to enter or view profiles. How many days before deleting an inactive user? Dr. Matcher runs an automatic maintenance routine when the first user accesses it on a given day. This routine deletes any users who haven't logged onto Dr. Matcher within the number of days specified here. This keeps the file uncluttered with users who "try it once" and never access it again. Up to 365 days can be specified. Should Sysop remain anonymous (Y,[N])? If you answer N (default) to this question, the sysop's questionnaire will be filed under his or her real name as defined in the RBBS-PC configuration. If you answer Y, the sysop's questionnaire will have the name "Sysop." The following three questions appear only for Wildcat! and PCBoard users, since the door can get this information from RBBS. Enter the name of your Wildcat! (or PCBoard) BBS: Enter the name of your BBS here. Dr. Matcher uses this in the sign-on screen and when exiting ("Returning to _____...."). Dr. Matcher 0.98a (C) 1991 K. Patz Page 11 Dr. Matcher 0.98a (C) 1991 K. Patz Page 11 Dr. Matcher 0.98a (C) 1991 K. Patz Page 11 Enter Sysop's First name: Enter Sysop's Last name: Enter the main BBS sysop's name here. Dr. Matcher uses this to determine if the user is the sysop and grants appropriate privileges. In addition, this name is shown when the sysop enters chat mode ("Hi, I'm ______ and we're in chat mode."). Use FOSSIL calls (Y,[N])? If you answer Y, Dr. Matcher will use FOSSIL calls for communications in Wildcat! mode. In RBBS mode, FOSSIL will be used if RBBS is using FOSSIL. If you answer N, FOSSIL will not be used at all. RBBS users should answer Y to this question since then Dr. Matcher will determine from the DORINFOx.DEF whether to use FOSSIL or not. DRMATCH.DR File The file DRMATCH.DR is a file containing the configuration information generated by DRINIT. If you wish to change this configuration information without rerunning DRINIT, the following is a sample file with the records explained. It is an ASCII sequential file, which can be edited by any text editor that writes ASCII files. 70 <----------------- Line 1: DO NOT CHANGE! (Max users) 23 <----------------- Line 2: DO NOT CHANGE! (# questions) 8 <----------------- Line 3: DO NOT CHANGE! (Max answers) 10 <----------------- Line 4: DO NOT CHANGE! (Max preferences) 3 <----------------- Line 5: Maximum idle minutes -1 <----------------- Line 6: -1=Drop DTR on carrier loss, 0=no 30 <----------------- Line 7: Maximum minutes per session C:\TEST\ <---------------- Line 8: Path of DORINFOx.DEF (no filename) 0,0,0,0,0,0,0,0,0,0 <----- Line 9: Individual access security levels 0,0,0,0,0,0,0,0,0,0 <----- Line 10: Individual deny security levels 10 <----------------- Line 11: Minimum security for Sysop functions PASSWORD <--------------- Line 12: Sysop editor password 5 <----------------- Line 13: Minimum security for normal access 5 <----------------- Line 14: Minimum security for new users 0 <----------------- Line 15: -1=use RTS/CTS, 0=don't use 0 <----------------- Line 16: -1=require filled out questionnaire 30 <----------------- Line 17: Days before inactive user deleted 0 <----------------- Line 18: -1=sysop anonymous, 0=not anonymous 0 <----------------- Line 19: 0=RBBS-PC, 1=Wildcat!, 2=PCBoard 1 <----------------- Line 20: Color Support **** 0 <----------------- Line 21: -1=Use FOSSIL **** 0 <----------------- Line 22: Number of Lines in PROFILE **** 0 <----------------- Line 23: Require password in LOCAL **** My BBS <----------------- *Line 24: Name of bulletin board Joe <----------------- *Line 25: Sysop's first name Sysop <----------------- *Line 26: Sysop's last name **** New fields in 0.96+ * Wildcat!/PCBoard only Dr. Matcher 0.98a (C) 1991 K. Patz Page 12 Dr. Matcher 0.98a (C) 1991 K. Patz Page 12 Dr. Matcher 0.98a (C) 1991 K. Patz Page 12 DO NOT CHANGE LINES 1-4!! These records contain important information needed to properly read the user and answer/preference files. Lines 24-26 are only used in Wildcat! and PCBoard modes. In RBBS mode, this information comes from DORINFOx.DEF. SYSOP FUNCTIONS In addition to all normal Dr. Matcher functions (which are explained in the file DRINSTR.DOC which is readable on-line), there are two commands that can be accessed only by the sysop. L - List Activity Log The L command at the main Dr. Matcher prompt will list all activity that has occurred in Dr. Matcher. The sysop also has the option to delete this file after reading it. D - Sysop Editor The D command at the main Dr. Matcher prompt will access the Dr. Matcher editor. If you're accessing remotely (or as a non- RBBS user in local mode using the /L option), you'll be asked for the editor password. There are four options in the editor: Edit (U)sers, (R)eload questionnaire, [Q]uit? NOTICE: Only (U)ser and [Q]uit are available in beta 0.98a. Dr. Matcher 0.98a (C) 1991 K. Patz Page 13 Dr. Matcher 0.98a (C) 1991 K. Patz Page 13 Dr. Matcher 0.98a (C) 1991 K. Patz Page 13 Quit simply restarts Dr. Matcher. User allows the sysop to edit the Dr. Matcher user file. The following is a sample session: Edit (U)sers, (R)eload questionnaire, [Q]uit? u User name or search string ([Enter] quits)? kevin KEVIN PATZ (Y,[N])? y (A) Name: Kevin Patz Days since last on: 0 (B) User allowed to enter Dr. Matcher: YES (C) User's questionnaire is active: YES (D) Clear User's Questionnaire (E) Clear User's Preferences (F) DELETE this user [Q] Quit editing this user User command (?,A,B,C,D,E,F,[Q])? The "User name or search string" prompt allows the sysop to enter a full or partial name to search on. Any matches are shown with a "yes/no" prompt. If the specified user name is not found, the sysop is given the option to add the user to the file. This add capability is useful for special purposes or for giving users access to a closed Dr. Matcher. Option A allows the sysop to change the user's name. Days since last on cannot be changed in this version. Option B allows the sysop to lock a user out of Dr. Matcher, or to unlock a locked user. Note that the sysop can lock himself out of Dr. Matcher. If this happens, the sysop cannot access the standard matchmaker functions, but can still access the Editor and the Activity Log. Option C allows the sysop to hide or unhide a user's questionnaire. This option works like the "(T)oggle questionnaire on/off" option at the main prompt, except that the sysop can hide and unhide questionnaires even if the users are required to have a questionnaire to access the matcher. A hidden questionnaire is not included in a matchmaking operation. Hiding a questionnaire may be useful if a user goes on vacation and doesn't want users matching him or her and leaving large quantities of messages on the BBS. Option D allows the sysop to erase a user's answers to the questionnaire. Option E allows the sysop to erase a user's preferences. Option F allows the sysop to completely erase a user from Dr. Matcher's user file, making room for another user. Option Q quits editing the user so another user can be edited or the sysop can quit from there. Dr. Matcher 0.98a (C) 1991 K. Patz Page 14 Dr. Matcher 0.98a (C) 1991 K. Patz Page 14 Dr. Matcher 0.98a (C) 1991 K. Patz Page 14 DR. MATCHER SYSOP FUNCTION KEYS Dr. Matcher uses the following function keys: <F1> will immediately force Dr. Matcher to exit back to DOS. From here the door batch file will return control to the BBS if run as a door or live program. If run from the DOS prompt, <F1> will exit back to DOS. <F2> will cause Dr. Matcher to exit to a DOS Shell. This allows the sysop to temporarily suspend the Dr. Matcher session to execute DOS commands. After exiting from the shell (by typing EXIT at the DOS prompt), Dr. Matcher resumes at the point of interruption. Note that COMMAND.COM must be available in the path specified by the environment variable COMSPEC. If you boot from a hard drive, this should be the case. <F10> allows the sysop to enter chat mode with the user currently in Dr. Matcher. This key works the same way as <F10> in RBBS. When in chat, the user and sysop can type messages back and forth to each other. When the sysop presses <Esc>, chat mode ends and the user returns to the point where he or she was before chat mode was entered. Dr. Matcher 0.98a (C) 1991 K. Patz Page 15 Dr. Matcher 0.98a (C) 1991 K. Patz Page 15 Dr. Matcher 0.98a (C) 1991 K. Patz Page 15 SAMPLE DR. MATCHER DOOR BATCH FILE Dr. Matcher, once configured, is installed into the RBBS door system like any other door. No door monitor is needed. Create a batch file (e.g. MATCH.BAT) and insert MATCH (and a description) into your MENU5 or equivalent. If you're using Wildcat!, see the Wildcat! documentation for instructions on creating a batch file for live programs. Since Dr. Matcher's init program lets you specify a path to DORINFOx.DEF, there's no need to copy DORINFOx.DEF if you have Dr. Matcher in a different directory from RBBS. Here's a sample batch file for invoking Dr. Matcher from a RBBS running in C:\RBBS with Dr. Matcher in C:\MATCH (comments in parentheses must not be entered into the batch file) watchdg1 off (Dr. Matcher checks carrier; no watchdog needed) cd\match (change to Dr. Matcher subdirectory) drmatch %1 (Invoke Dr. Matcher and pass node number) cd\rbbs (Return to RBBS subdirectory) DR. MATCHER COMMAND SYNTAX The following describes the command-line syntax and options to invoke Dr. Matcher. Items in brackets [] are optional. [drive][path]DRMATCH [node] [/C] [/D] [/L] [/N] [/P:path] [/M] [/S] [drive] and [path] are the drive and path where the file DRMATCH.EXE resides. This is not necessary if Dr. Matcher is in the current directory or PATH. [node] is the RBBS node number. If omitted, node 1 is assumed. This parameter is not used in Wildcat! mode. In RBBS mode, it specifies which DORINFOx.DEF file to read. /C tells Dr. Matcher to ignore the CD (Carrier Detect) signal on the serial port. This may be useful when testing or running Dr. Matcher with a computer or terminal connected directly to the BBS's serial port. Without this option, Dr. Matcher terminates if CD is dropped (when the caller disconnects while in Dr. Matcher). /D activates Debugging mode. Use this option if you get a "Fatal error" message or a mysterious hang. /D defeats the "Hang-proof Error Handling" and causes a normal BASIC error termination to occur when an untrapped error occurs. This way you'll get an English error message instead of an error code, though the system will freeze until you strike a key to continue. Dr. Matcher 0.98a (C) 1991 K. Patz Page 16 Dr. Matcher 0.98a (C) 1991 K. Patz Page 16 Dr. Matcher 0.98a (C) 1991 K. Patz Page 16 /L activates Local mode. In this mode DORINFOx.DEF or CALLINFO.BBS is not read, no modem communication takes place, and the door runs as if it were a stand-alone program. This is useful for testing or setting up Dr. Matcher without using a modem. When /L is specified, you'll be prompted for your first and last names since it can't get them from a BBS in this mode. /N (Wildcat! mode only) tells Dr. Matcher to use the caller's baud rate instead of the port baud rate in CALLINFO.BBS. This option shouldn't be necessary unless a compatibility problem arises. /P:path overrides the path to search for DORINFOx.DEF, CALLINFO.BBS, or PCBOARD.SYS. Use this option to specify a different path where the file resides. This is useful for multi- node BBS's which put their door info file in a different directory for each node. /M causes Dr. Matcher to run its daily maintenance and compress the user profile file (if necessary) and then exit. No BBS or modem I/O is performed. Use /M to run maintenance manually (such as part of an automatic once-a-day BBS event), or if your profile file gets full. WARNING: DO NOT RUN MAINTENANCE ON A MULTI-USER OR NETWORK SYSTEM WHILE OTHER USERS ARE IN DR. MATCHER. /S tells Dr. Matcher not to run maintenance, even if it is due. Normally Dr. Matcher runs a maintenance cycle (which deletes inactive users and compresses the user profiles) the first time it is invoked on a given day. Use /S if you're running maintenance as a BBS event so it doesn't get run twice or at the wrong time. TROUBLES?? Fatal Errors?? If you get a fatal error when invoking Dr. Matcher, the most likely cause is a missing file. Check that the following files are available in the current directory when Dr. Matcher is invoked: DRMATCH.DR (Configuration file created by DRINIT) DRQUEST.DR (Questionnaire file created by DRINIT) DRPROF.DR (User Profile file created by DRINIT) DRANSWER.DR (Answer/preference file created by DRINIT) DRUSERS.DR (User file created by DRINIT) DORINFOx.DEF (Created by RBBS - make sure it's available in the drive/directory you specified when running DRINIT- x is the node number) CALLINFO.BBS (Created by Wildcat! - see DORINFOx.DEF above) Dr. Matcher 0.98a (C) 1991 K. Patz Page 17 Dr. Matcher 0.98a (C) 1991 K. Patz Page 17 Dr. Matcher 0.98a (C) 1991 K. Patz Page 17 Other Files Used: DRPRELOG.DOC (Pre-log messages - displayed first-optional) DAY.DR (Last day Dr. Matcher was accessed-created by Dr. Matcher) DR-OPEN.DOC (Dr. Matcher opening messages - optional) DRINSTR.DOC (Dr. Matcher user instructions) DRMATCH.LOG (Activity Log created by Dr. Matcher) ERRORS.DR (Fatal Error log, created by Dr. Matcher) Fatal errors are logged in ERRORS.DR in the current directory. The error number is a BASIC error code. If you have a GW-BASIC (tm) or QuickBASIC (tm) manual, you can look up the error code and find out what the error is. Error 53 is caused by missing files. Error 62 is caused by an incomplete file. If you get this error after upgrading from an earlier version of Dr. Matcher, check your DRMATCH.DR file (see the section above on this file). New fields may have been added. Here's some commonly encountered errors: Error 53 at line 400: DORINFOx.DEF was not found. Error 53 at line 410: CALLINFO.BBS was not found. Error 53 at line 420 or 425: PCBOARD.SYS or USERS was not found. Error 64 or 76 at line 400-425: Invalid path was specified in the /P option or in DRINIT for the door info file. Error 64 at line 59425: Invalid COM port parameters specified. Note that unless a FOSSIL driver is used, only COM1-2 can be used. Error 57 or 69: Communications error. This is usually caused by severe phone line disturbances. If you have modem troubles, check your handshaking. You may need to turn RTS/CTS on or off. Edit DRMATCH.DR as explained above or rerun DRINIT. If Dr. Matcher, for whatever reason, decides that there is no carrier when there is, try invoking Dr. Matcher with the /c option: DRMATCH /C %1. If you find a problem which you believe is a bug, please let me know. If you can reproduce the problem, leave a message on my BBS describing how you caused it to fail. If you could upload a capture file of the bug in action that would help too. If you as Sysop (running Dr. Matcher locally) find a bug that you can reproduce, run Dr. Matcher locally outside of RBBS with output redirection as follows: drmatch /l >filename This will direct the screen output to a file that you can then upload to my BBS (603-228-3820). * GW-BASIC and QuickBASIC are trademarks of Microsoft Corp. Dr. Matcher 0.98a (C) 1991 K. Patz Page 18 Dr. Matcher 0.98a (C) 1991 K. Patz Page 18 Dr. Matcher 0.98a (C) 1991 K. Patz Page 18 
