home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Monster Media 1994 #1
/
monster.zip
/
monster
/
BBS_GAME
/
MATCHM23.ZIP
/
MATCHMKR.DOC
< prev
next >
Wrap
Text File
|
1994-01-04
|
25KB
|
631 lines
MATCH MAKER DOOR VERSION 2.3
January 04, 1994
PGP Communications
Copyright 1992-1994
Support BBS - The DUNGEON BBS
(416)926-8734/39
SysOp Operation
Page 2
Table Of Contents
License Agreement................................................3
Introduction.....................................................4
Minimum Requirements.............................................5
Installation and SetUp...........................................6
Sysop SetUp and Functions.......................................12
Maintenance Utility - MM-UTIL.EXE...............................13
Notes...........................................................15
Page 3
ALL RIGHTS RESERVED by PGP Communications, Inc. (tm)
This legal document is an agreement between you, the end user, and PGP
Communications. BY USING THIS SOFTWARE, YOU ARE IN AGREEING TO BECOME
BOUND BY THE TERMS OF THIS AGREEMENT.
While every precaution has been taken in the preparation of this manual,
PGP Communications, Inc. (tm) assumes no responsibility for errors or
omissions. Neither is any liability assumed for damages resulting from
the use of the information contained herein.
PGP Communications retains the Copyright to this program. You are NOT
allowed to make changes to the compiled .EXE files without the expressed
written consent of PGP Communications. You are allowed to freely copy and
distribute this program as long as the original files which existed in the
archived file are distributed in their entirty with no additions. No fees
may be charged for distribution, other than a nominal fee of up to $5.00
for media expenses. You also agree NOT to disclose your registration
number, if and when aquired, to any other person(s) who(m) may use this
program.
PGP Communications, including but not limited to: INVOICE.EXE,
IN_MAIN.EXE, INVDEMO.EXE, MATCHMKR.EXE, CLASSAD.EXE and any other
program that is distributed under the PGP logo is/are
trademarked/copyrighted by PGP Communications, Inc.(tm)
PGP Communications assumes no liability for the use of this program,
and any SysOp using it takes and assumes all liability and respons-
ibility for it use and the damage that might occure through or during
it's use.
GAP, GAPUTI & GAPQBDR - are tradenames, trademarks and copyrighted
works of GAP Communications Development
BRUN45 & BRUN45.EXE - are tradenames, trademarks and copyrighted
works of MicroSoft Development Corp.
Page 4
Introduction
^^^^^^^^^^^^
Welcome to MATCHMKR(c) - VERSION 2.3!
The MATCHMKR Door allows callers to answer up to 72 questions that you
create pertaining to their likes and dislikes, and then indicate through
their responses, what it is they're looking for in someone else. The door
then compares their answers to the profiles given by other callers. It
then reports back to the caller, based on an indicated age range and the
caller's sexual preference, those other callers they match to and at what
percentage.
Matches are based on:
1st. Caller's sex
2nd. Caller's sexual preference.
3rd. Caller's chosen age range
4th. on the 72 questions
The following files should be included in the file: MATCHMxx.ZIP
MATCHMKR.EXE -* The main door program
MATCH1.CNF -* example config file for GAP (Node 1)
MATCH2.CNF - example config file for second node GAP
MM-UTIL.EXE -* Door utility program
WELCOME -* example of the WELCOME file (ASCII)
WELCOMEG -* example of the WELCOME file (ANSI)
QUEST.DAT -* example question file
NEWS -* sample News file
NEWSG -* sample News file (ANSI)
MATCHMKR.DOC - this file
REGISTER.DOC - registration form
-* means a required file and must be in the same
subdir as the door program
Page 5
Minimum Requirements
^^^^^^^^^^^^^^^^^^^^
You will need to have at least 256K of ram.
The door has file sharing set up and will require that SHARE.EXE is
loaded, even if you are not running two or more nodes, not running on
a network, nor running DDos or any other multi-tasker.
You may add the following command line to your AUTOEXEC.BAT FILE:
SHARE
If you are running in NON-GRAPHICS mode, you MUST have ANSI.SYS
installed as a device driver in your CONFIG.SYS file:
Example: DEVICE=ANSI.SYS
Page 6
Installation and SetUp
^^^^^^^^^^^^^^^^^^^^^^
First you will need to create a subdir where all the MATCHMxx.ZIP files
will be located. You may do this at a DOS prompt.
On The DUNGEON BBS, all door subdir's are located in the subdir
\GAP\DOORS. The command to create the MATCHMKR subdir would look like
this:
C>MKDIR \GAP\DOORS\MATCHMKR <enter>
Once you have created the subdir you will need to move your MATCHMKR
file into it. You may do this by using the DOS COPY command at a DOS
prompt. The command line would look something like this:
C>COPY A:*.* C:\GAP\DOORS\MATCHMKR <enter>
Once you have copied all the files, you will now need to run the
MM-UTIL.EXE program. This should be run within the MATCHMKR subdir.
You will need to change to that directory and may do so by entering
the following command at a DOS prompt:
C>CD \GAP\DOORS\MATCHMKR <enter>
Door programs written with the GAPQBDR Door Interface Module will run
on GAP Communications version 6 and greater and on PCB version 14 and
greater.
To configure the door for a particular BBS setup, a configuration file
must be used. The configuration file for MATCHMxx consists of 11
lines. The name of the file is usually the same as that of the door
program, but with a .CNF extension. The format of the file is as
follows:
Page 7
Installation and SetUp - Continued
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
C:\GAP <- path to BBS default directory
The DUNGEON BBS <- your BBS name
0 <- IRQ
0 <- Base Address
00000 <- registration number
you STUD <- used by the Match Maker
Horny Studs in several prompts
C:\POSTLINK <- full path to UTI drivers
C:\GAP\DOORS\MATCHMKR <- full path to work directory
0 <- Forum number in which to import
0 <- bell toggle 1=on 0=off
The first line is the full path to your BBS default directory. For
GAP, this is usually C:\GAP.
The second line is the name of your BBS.
The third line is used to indicate your com port's IRQ. The number must be
in the range of 1 - 7. (If you are using a standard com 1 or 2, keep this
at 0)
The fourth line is the Base Address which must be a Hexadecimal number in
the format of:
02E8
03E8
etc. (Again, if you are using a standard com 1 or com 2, you can
keep this value at 0)
The fourth line is your registration number. If you have not registered
your copy, this line should remain 00000.
The fifth line is used in the Match Maker prompt when a user attempts
to make a match. For example with the above line, the prompt would
be:
"Hiya USERNAME, you STUD! You have the Match Maker."
The sixth line is used in the opening screen when the Match Maker tells the
user how many people are in the database. For example, with the above line
the prompt would be:
"< 10 Horny Studs in the database >"
The seventh line is the path to GAP's UTI driver. This is needed as the
Match Maker will post a message to the recipient of mail in the Forum of
your choosing each time mail is left for them in the door.
The eighth line is the path to the Match Maker's work directory. This can
be the same as the directory the door program resides in.
The ninth line is the Forum number you wish the Match Maker to use for
importing its messages to.
The tenth line is the bell toggle. If you wish the system bell to sound if
a user pages you while inside the door, set this to 1. 0 will disable the
bell. Your original system setting will be restored when the user exits
the door.
Page 8
Installation and SetUp - Continued
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
GAPQBDR will obtain the sysop's name from the BBS configuration file.
Next, you will need to run the MM-UTIL.EXE program by entering the
following command at a DOS prompt:
C>MM-UTIL DOOR.CNF <enter>
**SEE NOTE AT THE END OF THIS FILE**
One of your created configuration files needs to be passed to MM-UTIL.EXE
as a command line parameter. The program uses this file to determine
if your copy of the door program is registered.
You will be presented with a menu of options. The first thing you
will need to do, is create the Match Maker working files. To do this,
choose menu option "1". The program will create the following files:
USERS.DAT - User file
MATCH.DAT - User Match preferences
MSGS.DAT - Mail message base
MSGS.IDX - Mail message base index
USER.LOG - User log
Once this is done, you can exit the utility program by simply pressing
<ENTER> at the command prompt.
Now, you can continue installing the door by working on the other
files.
You must now create a batch file to invoke the door. This batch file
is placed in your BBS default directory. Such a batch file might look
like this:
@ECHO OFF
CD \GAP\DOORS\MATCHMKR
MATCHMKR MATCH.CNF
CD \GAP
As you can see, the door is invoked by passing the configuration file
name as a parameter.
Page 9
Installation ans SetUp - Continued
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
You will also need to modify your doors menu files and the data file
that tells the BBS what your doors are and the security level needed
to access them. For GAP, these are respectively:
DOORM
DOORMG
DOORS.DAT
Please refer to your BBS documentation for details on setting these
files up.
If you are running multi-nodes, simply create a separate door configuration
file for each node, and number them. For instance, for a 3 node
system, you might have the following configuration files:
MATCH1.CNF
MATCH2.CNF
MATCH3.CNF
The only difference between the three would be the 1st line which
points to the default directory for the particular node.
Multi-user operation is automatic. For GAP, the presence of DUMMYLOK.DAT
in the MAIN directory triggers multi-user operation.
The following files are read during door initialization. They must be
present or the door will not operate.
DOOR.SYS
GAPBBS.CNF
In addition, this door program accesses the GAP USERS.DAT file for
information, but does not write to it. You also need to have a copy of
your GAPUTI.CNF file in the directory where the door resides. See the UTI
documentation to see how this is set up.
You will now want to set up the WELCOME and NEWS files. Samples of
these files have been included in this ZIP file. The WELCOME file is
shown to callers after they successfully log-on to the door. The NEWS
file is displayed immediately after this. Each of these files can
have an ASCII and a ANSI version. For instance, the ASCII welcome
file would be named WELCOME; the ANSI version would have a G appended
to the end of the name i.e WELCOMEG.
Next you will need to set up the QUEST file which will contain your
questions and answer choices. You may want to print out the QUEST.DAT
file to see an example of the set-up.
1) You may have up to 72 questions.
2) Each question can be up to 3 lines.
3) Each question can have up to 18 answers.
Page 10
Installation ans SetUp - Continued
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
The following is an explanation of how to set up this file:
38 <- number of questions about the caller
33 <- number of match questions
1 <- number of lines in the 1st question
1 <- Match question 1=use question 0=No
10 <- number of answers
How much do you weigh? <- question line 1
How hefty do you like 'em? <- Match question line 1
Less than 100 lbs. <- answer A
100 - 120 lbs. <- answer B
121 - 135 lbs. <- answer C
136 - 145 lbs. <- answer D
146 - 155 lbs. <- answer E
156 - 165 lbs. <- answer F
2 <- number of lines in the last question
0 <- Match ? Toggle (0 = don't use)
3 <- number of answers
Now honestly, did you tell the whole truth on the
questionnaire, and nothing but the truth so help you God?
<The next 2 lines are left blank since this question is not
being used in the MATCH questionnaire>
Yes, I told the whole truth
A few lies never hurt anyone
I told mostly the truth
In the above example the first line is the total number of questions
contained in the file.
Line 2 is the total number of "match" questions that a user responds to
when telling The Match Maker what they're looking for.
Line 3 is the number of lines in the first question.
Line 4 is the number of answers listed for the question.
Line 5 is the first question in the file.
Lines 6 to 14 are the answers for the first question.
The last 7 lines break down as follows:
Line 1 states that this question has two lines.
Line 2 states that there are 3 answers listed
Line 3 is the first line of the question.
Line 4 is the second line of the question.
Line 5 is the first answer.
Line 6 is the second answer.
Line 7 the third and last answer.
Remember that each question is displayed as the question lines plus a
blank line; the answer lines; plus a blank line and the prompt line.
If the total number of question lines + blank + answer lines + blank +
prompt line is greater than 13, you may end up with part of your
question scrolling off the caller's screen before they had a chance to
read it. So, keep it all within reason. The shorter the question,
the better. One liners are the best; two liners O.K, but three becomes
tedious and frustrating.
There are three questions you need not worry about including in
the file. These are:
Page 11
Installation ans SetUp - Continued
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
What is your Sex?
What is your sexual preference?
What is your age?
Since the program must have these to work correctly, they have been
included in the source code to eliminate problems.
NOTE: (1) If the question consists of 1 line, then you may have up to
18 answer choices. If the question consists of 2 lines, then you
may have up to 16 answer choices. If the question consists of 3
lines, then you may have up to 14 answer choices.
Once you have created your QUEST.DAT file, you are finished with the door
installation! Just be sure to test your questionnaire file before
putting the door up for callers to use. If you have problems, you may
upload your file to The DUNGEON BBS - (416)926-8734, and I'll do it for
it for you.
Page 12
SysOp Set-Up and Functions
^^^^^^^^^^^^^^^^^^^^^^^^^^
The following sysop functions are available while awaiting keyboard
input:
F5 - Shell to DOS.
F8 - Twit user and return to BBS.
F10 - Initiate chat with user.
CF10 - Answer user page bell.
Home - Main user stats.
End - Displays sysop keys available.
PgDn - Secondary user stats.
Up Arrow - Increase user's time remaining.
Dn Arrow - Decrease user's time remaining.
One of the nicer features about using the TWIT key, is the user is not
told that "the sysop wants them to return to the BBS". Instead, a
very plain and simple message of "returning you to the BBS" is displayed
This way, the user is given no indication that the sysop is hovering
about.
When using the F5 shell to DOS key, to return to the door program,
simply type EXIT at the DOS command prompt. It is not necessary to
change directories back to the door directory. GAPQBDR is smart
enough to know which drive and directory the door program is in and
will reset the defaults upon return from DOS.
The Up and Down Arrow keys increase and decrease the user's time
respectively by 5 minutes for each key press. There is no indication
of what is occurring (except by the fact the user's time remaining
will change), so the sysop should try not to have a lead finger. The
increase or decrease is effective only while the user is in the door.
Page 13
The Match Maker Maintenance Program - MM-UTIL.EXE
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Included with MATCHMxx, is a utility maintenance program. This is a
handy program to help you maintain the files associated with this
door. The following outlines what this program will do for you.
When invoked, you will be presented with a menu of options:
[1] Create All Default Files
This command was discussed earlier and is used to create all default
files needed to run the door program. This command should only be
used to create the files from scratch, not in attempts to reset or
re-create them.
[2] Re-Create Main User File
This command is used to recreate the USER.DAT file. It will delete
your old file and create a new one.
[3] Re-Create Message Files
This command is used to recreate the MSGS.DAT and MSGS.IDX files. It
will delete your old files and create new ones.
[4] Re-Create User Log
This command is used to recreate the USERLOG file. It will delete
your old file and create a new one.
[5] Rebuild USERS.IDX File
This command will rebuild the user .IDX file. The .IDX file may become
corrupt from time to time. An indication of this is if a user's correct
password is not recognized by the door.
[6] Rebuild MATCH.DAT File
If you change your QUEST.DAT file and add/delete match questions, this
command will reset the MATCH.DAT file. Users will then be prompted to re-
do their answers prior to being able to use the MATCH function of the door.
The difference between menu options 2 to 4 and menu option 1 is that
option 1 does not look for an existing file(s). So what will happen,
is that the start-up values will be changed, however all of the rest
of the information in the file will remain. Things would get quite
messy and you'd end up with lots of error messages. Of these, the
only command you will need to use on a regular basis is #4 to recreate
the USERLOG. This file will tend to grow quickly.
The bottom portion of the menu has the actual maintenance options.
[A] Message Base Utilities
When this is chosen, you will be presented with a sub-menu of choices.
Page 14
The Match Maker Maintenance Program - MM-UTIL.EXE - Continued
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
[1] Show Message Headers
This command will list the message headers only; TO:, FROM:, MSG #,
DATE: of message and TIME: of message. If there are no messages yet,
you will be notified.
[2] Show Messages
This command will list all of the above, along with the entire message.
You will have one message per screen. Messages that have been re-
ceived will have a string of "****" in the TO field.
[3] Pack Message Base
This command will purge/pack and rebuild you message base files,
deleting any messages which have been received. The original files,
MSGS.DAT and MSGS.IDX, will be renamed MSGS.BAK and IDX.BAK,
respectively.
Just press ENTER at the command prompt to return to the main menu.
[B] Pack User File
With this command, you will be prompted for a date to use for the
purging of inactive users. The date format is MM-DD-YYYY. Any users
with a last log-on date before and including this date will be flagged
for deletion. Prior to the users being deleted, you will be presented
with a list of the affected users and asked if you wish to continue.
The old user file will be named USERS.OLD.
[C] Convert User File to Text
This command will convert the USERS.DAT file into a text file which
will list the users REAL name as listed in the BBS's user file, the
handle and account number used in the door and the last date and time
the user was in the door.
[D] Edit Users
This command will allow you to edit some of the basic data on each user.
In the next release, I will incorporate the use of command line
parameters so that you can use this utility program in an event.
Page 15
**NOTE**
This version of Match Maker is a DEMO. The door program itself is not
crippled in any way. However, the utility program will not be fully
functional until you have registered the door. Until registration,
you will only be able to use the utility program to create the default
files.
This is released "As Is" and there is *NO* warranty or guarantee that
it will work for you and not cause any problems. You have chosen to
use this door, YOU are responsible for any unfortunate problems that
may develop from its use or misuse. I will gladly listen to any
suggestions or problems you may have, and I will do my best to fix
whatever needs to be fixed. I can not be held responsible for any
problems you may have, whether directly or indirectly due to the use
of the door.
Please read REGISTER.DOC for information on how you can register
your copy of Match Maker.
For complete support, contact the SYSOP on The DUNGEON BBS.
Registered users of any PGP Communications program will be given a
complementary user account on the BBS and free minor upgrades as they
become available.
Happy Exploring!
Peter Paulekat
The DUNGEON BBS
(416)926-8734/39 1200/2400 Baud