home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.wwiv.com
/
ftp.wwiv.com.zip
/
ftp.wwiv.com
/
pub
/
MISC
/
MATCHM24.ZIP
/
MATCHMKR.DOC
< prev
next >
Wrap
Text File
|
1995-01-04
|
23KB
|
594 lines
MATCH MAKER DOOR VERSION 2.4
January 22, 1994
PGP Communications
Copyright 1992-1994
Support BBS - The DUNGEON BBS
(416)214-1192/3
SysOp Operation
ALL RIGHTS RESERVED by PGP Communications (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 (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
acquired, 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 (tm).
PGP Communications assumes no liability for the use of this program, and
any person using it takes and assumes all liability and responsibility 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.
Introduction
Welcome to The Match MAKER(c) - VERSION 2.4!
The Match MAKER 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 (ASCII)
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
Minimum Requirements
You will need to have at least 320K 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 multitasker.
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
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 19 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:
C:\GAP <- path to BBS default directory
The DUNGEON BBS <- your BBS name
0 <- IRQ
0 <- Base Address
STANDARD
0
0
0
00000 <- registration number
you STUD <- used by The Match Maker in several prompts
STUDS <- used by The Match Maker in several prompts
C:\POSTLINK <- full path to UTI drivers
C:\GAP\DOORS\MATCHMKR\WORK1 <- full path to work directory
C:\GAP\DOORS\MATCHMKR\STORE <- full path to dir for packets
0 <- Forum number in which to import
0 <- bell toggle 1=on 0=off
45 <- Exchange security level
DUNGEON <- BBS exhange I.D.
0 <- Message import toggle 1=on 0=off
Line 1 - the full path to your BBS default directory. For GAP, this is
usually C:\GAP.
Line 2 - is the name of your BBS.
Line 3 - 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)
Line 4 - 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)
Line 5 - specifies the COM Port Interface to use:
STANDARD = Regular Communications Port Interface. This is what
you would normally use.
DIGIBOARD = Direct DigiBoard Programming Interface. Must be used
in conjunction with a program called RESETDIG.EXE.
If you don't have this program but have a DigiBoard,
then use the following option.
INT14/EBIOS = Indirect DigiBoard Support via a Device Driver. All
Communications to the DigiBoard (or any board that
supports INT14/EBIOS) are performed via a Software
Interrupt that the Device Driver handles.
Line 6 - If using a DigiBoard, this is the Memory Window, or the address
the card uses as a communications area between the card and the
Host Computer. Only needed if using an Interface set to DIGIBOARD.
If using STANDARD or INT14/EBIOS, can be set to 0.
Line 7 - If using a DigiBoard, this is the I/O Port address that the Board
is attached to. Only needed if using an Interface set to
DIGIBOARD. If using STANDARD or INT14/EBIOS, can be set to 0.
Line 8 - If using a DigiBoard, this is the Channel Number for this port on
the Digi. This is REQUIRED for DIGIBOARD and INT14/EBIOS
Interfaces. This is 1 - 8 for the DIGIBOARD Interface and usually
4 - 11 for the INT14/EBIOS Interface. This number tells the
program which of the Com Ports on the DigiBoard it should use.
Line 9 - is your registration number. If you have not registered your
copy, this line MUST remain 00000!
Line 10 - 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."
Line 11 - 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 Studs in the database >"
Line 12 - is the path to your 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.
Line 13 - is the path to The Match Maker's work directory. This MUST NOT
be the same as the directory the door program resides in.
Line 14 - is the path to move uploaded exchange files to pending import
into your user data base.
Line 15 - is the Forum number you wish The Match Maker to use for importing
its messages to.
Line 16 - 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.
Line 17 - is the security level require inorder to access the file transfer
commands in The Match Maker for data base exchange.
Line 18 - is your BBS exchange I.D. (Eight letters max.)
Line 19 - is the message import toggle. If you do not wish The Match Maker
to import a message into the BBS that a user has new mail in the
door, this should be a 0. Otherwise, to have the door import
messages into the BBS, set this toggle at 1.
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.
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 differences between the three would be the 1st line which points
to the default directory for the particular node and the node's work
directory.
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 <- For GAP BBS's
You also need to have a copy of your UTI.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.
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:
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)214-1192, and I'll do it for it for you.
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. The Match Maker 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.
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.
[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 received will
have a string of "****" in the TO field.
[3] Pack Message Base
This command will purge/pack and rebuild your message base files, deleting
any messages which have been received and flagged for deletion by the user.
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.
It will also allow you to reset an individual's BIO to null strings. If
this is done, the Match Maker will prompt the user to enter a bio when
next they logon. (I found this useful if a user entered a couple of
characters of garbage to get past the BIO request.)
In the next release, I will incorporate the use of command line parameters
so that you can use this utility program in an event. The program and
user files are all preped for the release of the next version which will
have the full functionality of exchanging user/message data bases with
other boards running this door.
**NOTE**
This version of The Match Maker is a DEMO. The door program itself is not
crippled in any way, but the unregistered version will only allow up to 20
users. 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 The 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, SysOp
The DUNGEON BBS
(416)214-1192/93 300-14.4K Baud