home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
DP Tool Club 15
/
CD_ASCQ_15_070894.iso
/
vrac
/
canada10.zip
/
SYSOP.DOC
< prev
next >
Wrap
Text File
|
1994-06-01
|
18KB
|
409 lines
SCUBA DIVING TRAINING & TRIVIA
USCG CAPTAINS LICENSE QUIZ
CHEERS! TRIVIA
ELVIS PRESLEY! TRIVIA
JAMES BOND! TRIVIA
70'S! TRIVIA
FIRE-RESCUE! TRIVIA
CHRISTMAS! TRIVIA
CANADIAN! TRIVIA
and
Many more to come
SYSOP'S MANUAL
June 1, 1994
PCBoard 14.x and GAP 4.x
WILDCAT!, SPITFIRE
QBBS, RBBS, RA
by
Dan Bernasconi
db Software, Ltd.
P.O. Box 430955
South Miami, FL 33243
Blue Water BBS Systems
FIDO: 1:135/337
(305) 442-6000 -> US Robotics Dual Standard
-=-=-=-=-=-=-=-=-
OVERVIEW
________
NOTE: Since this documentation covers all the Software Trivia Doors,
I will refer to the EXE name as TRIVIA.EXE for the rest of this file.
Please substitute the correct name for the particular door you are
attempting to setup.
CONGRATULATIONS! You and your users will find this Trivia door
entertaining and educational. It consists of approximately 100 plus
questions that were carefully selected for your entertainment.
The door displays a "Trivia Royalty" bulletin to the caller while
it creates bulletins and logs for your use. Best of all..this door
is not crippleware. It isn't full of advertisements and limitations
...best of all I don't charge an arm and a leg. You'll also find we
are responsive to your questions. If you need help or have a suggestion
for improving this product, let me know!
FILES AND DESCRIPTIONS
______________________
The archive includes the following files:
TRIVIA .EXE -- The main executable file
SAMPLE .CFG -- The sample configuration file
TRIVIA .DAT -- The main trivia data file
TRIVIA .HIS -- Release History and changes
SAMPLE. LOG -- A sample of the log file produced
SCREENS .ZIP -- Screens for the TRIVIA\SCREENS sub directory
SYSOP .DOC -- The installation instructions...(this file)
QUIKUP .DOC -- Quick and Dirty installation instructions.
REGISTER.FRM -- Information and registration form...This will
give you a personalized door, voice or bbs
support services, new issues of master.dat
files, a clear conscience and a still poor but
happy door programmer.
DOOR .BAT -- Sample door batch file
CHARGE .IT -- Information on how you can charge the registration
fee to your major credit card and receive your
key file/registration number quicker.
DONOR .CL -- Put the name of the doors' sponsor here to display
each time it's played. This is an optional file but
you may want to leave it as is...
GOODBYE .NO -- To Disable Logging Off BBS from Door (Optional)
ERROR .QB -- Error Code List for QuickBASIC. Just to let you know
what the error may be before you call for help...<G>
INSTALL .BAT -- Installation Batch File to expedite the installation.
VERY IMPORTANT!!! Run this to Install the Door.
FILE_ID .DIZ -- Expanded File Description
This ZIP file was created using the -AV function of PKZIP. If my AV
is missing then this file may not be complete or has been tampered with.
Complete and current editions of this program are always available for D/L
on Blue Water BBS. If the AV is missing please complain to your sysop to
stop the practice of removing AV's as this is your assurance from the
programmer that the file is complete and virus free.
INSTALLATION
____________
Installation is quite simple and straight-forward. Follow these steps and
example and you should be up and running in a matter of minutes. Although
TRIVIA is an easy program to install on most any BBS, there may be some
Sysop who has trouble. Support is available in those situations.
1) Create a directory to hold all TRIVIA files
2) Unzip TRIVIAxx.ZIP into the above directory
3) Run INSTALL.BAT <-Important
4) Create a configuration file, with a name of your choice
or modify the SAMPLE.CFG file which is enclosed.
5) Create a door batch file or use the sample enclosed.
6) Modify your particular BBS System Menus to add the door.
The BBS setup various depending on the type BBS software you are
running. We assumed you are familiar with the general DOOR setup
on your system. Therefore our description includes only examples
of the TRIVIA specific configuration file and door batch file.
Refer to your BBS documentation for door installation on your
particular software.
BBS USER FILES
The BBS user file provides information to TRIVIA!, such as COM port,
user name, time allowed in the door, etc. This file is necessary for
TRIVIA to function. The complete path\filename of the BBS user file must
be passed to TRIVIA.EXE as the 1st parameter in the command line. The user
file is created by your BBS EACH time a user runs a door. The BBS USER file
has a different name on each type of BBS. When you create your TRIVIA
configuration file, you must tell TRIVIA the name for your particular BBS
system.
The following is a list of the user files used by the BBS types we
support (we included a typical path).
drive\dir\filename
C:\WILDCAT\CALLINFO.BBS ──┐ <- For Wildcat!
C:\WC30\WCWORK\NODE1\USERINFO.DAT │ <- For Wildcat! 3.x
C:\PCB\PCBOARD.SYS │ <- For PCBoard using PCBOARD.SYS
│ only
C:\PCB\USERS │ <- For PCBoard using USERS only
C:\BBS\DOOR.SYS │ <- For Systems which support
│ DOOR.SYS
C:\BBS\DORINFOx.DEF │ <- For QBBS/RBB/RA. Replace x
│ with Node#.
C:\BBS\TRIBBS.SYS │ <- fOR TriBBS
C:\BBS\SFDOORS.DAT ──┘ <- For Spitfire
CONFIGURATION FILE
One (and only ONE) of the above will be LINE 1 of your configuration file.
You MUST specify the path and name (including any extension) correctly if
you expect TRIVIA to find it. Sample for Lines 2 through 10 are:
Blue Water BBS Systems <- Your BBS Name
Dan <- SysOp's First Name
Bernasconi <- SysOp's Last Name
00000 <- Registration Number
10 <- Minimum security level allowed
in door.
25 <- Maximum questions allowed per visit
to the door.
C:\WC30\BULL\BULL1.SCR <- Path and Name of Color Bulletin
C:\WC30\BULL\BULL1.BBS <- Path and Name of ASCii Bulletin
WC <- WC Create WC!3.x specific bulls
PCB Create PCBoard specific bulls
Blank for ANSI & ASCii
2 <- Number of times allowed to play door
each day.
RIP <- "RIP" create RIP bulletins
"N" do not create RIP bulls
15 <- Number of seconds to allow the user
to answer each question. The door
will accept a timeout as an incorrect
answer. The door defaults to 10
seconds.
Edit the Sample.CFG file to suit your individual BBS. You must have all
13 lines and no extra characters.
Line 1: This line points to where TRIVIA.EXE will find the callers
information file. Just include the line that your
particular BBS uses. DO NOT put all of them in the CFG
file.
Line 2: Place the name of your BBS on this line.
Line 3: SysOp's first name goes here.
Line 4: SysOp's last name goes here.
Line 5: Your Registration Number goes here if registered. If
you haven't registered you can still use the
door...just enter 00000 until you get your registration
number.
Line 6: The minimum security level that is allowed in the door.
Line 7: Maximum number of questions allowed per visit to the door.
I would suggest 25-30 as a reasonable number. The smaller
this number, the more likely that the users will continue to
use the door.
Line 8: Enter the complete path and name of the Color bulletin
that you want TRIVIA to create. Even if you don't want
anything created you MUST still put something here.
The program will lock up if you leave this line blank
and specify either WC, PCB or NO in line 10. To avoid
the error of "Error #52 Line 0" do what I did.
Put the following in line 8.
NONE.BBS
This will just create a file NONE.BBS in the trivia doors
directory.
Line 9: Enter the complete path and name of the ASCii bulletin.
(Leave this blank if you put WC or PCB in line 10). can be blank but it MUST exist.
Line 10: "WC" to create WC!3.x specific bulletins or NO for ANSI and
ASCii bulletins. "PCB" on this line will enable the program
to create PCBoard specific color bulletins. If you Config
for WC! or PCB bulletins, Place the name of the bulletin
on Line 8 of the CFG file. Be sure to add the ".BBS"
extension to it. You may leave Line 9 blank but it still
MUST be included in the CFG file.
Line 11: Number of times users are allowed to enter the door each
day.
Line 12: Place "RIP" on this line if you wish to create RIP styple
bulletins. If you do not support or need them, place an
"N" on this line.
Line 13: Place the number of seconds that you wish to allow to
answer each question.
If you use the sample CFG file be sure to remove all remarks and use a
pure ASCII editor such as EDLIN or QEDIT. Word processors typically leave
hidden control codes. Those hidden codes could cause the program to depart
for worlds unknown. Save your newly edited file using any name you want.
...suggested TRIVIA1.CFG.
DONOR.CL Registered Users may create a file named DONOR.CL and place it
in the door directory. If found, the door will display a
prompt thanking them for donating the door.
GOODBYE.NO Place this file in the door directory to turn the [G]oodbye
option off.
DOOR BATCH FILE
Create a batch file or modify the sample DOOR.BAT file supplied.
This is what you need:
@ECHO OFF
CLS Keeps a clean screen (optional)
CD\WC30\DOORS\TRIVIA Change to the TRIVIA door files directory
TRIVIA TRIVIA1.CFG Run TRIVIA using TRIVIA1.CFG configuration
Change back to the WC! BBS directory
Restart the BBS. On BBS's which shell to
DOS to run the door this line may be
omitted or maybe the word "EXIT." Check
your BBS door instructions.
The above DOOR.BAT file is for a Wildcat! 3.x system using SWAP instead
of TERMINATE for doors.
MULTIPLE NODES
Create a configuration file for each node. Each file should have a unique
name.
EX: TRIVIA1.CFG TRIVIA2.CFG
TRIVIA has been tested under DOORMAN, LIVECAT and DESQVIEW and performs
very well under either .
COMM PORT IRQs
TRIVIA is written using DoorFrame. DoorFrame supports COM 1-4 on the
standard IRQ's - COM1 or COM3 as a standard uses IRQ4 while COM2 and COM4
use IRQ3. If your system uses a non-standard IRQ, add the IRQ number after
the configuration filename. Let's assume your Door is called FOOBAR and you
want to use COM1 but non-standard IRQ5. The command line passed to your
Door would be:
FOOBAR FOOBAR.CFG /5
FOOBAR FOOBAR.CFG *5
The /5 tells DoorFrame to use IRQ5 rather than the standard IRQ4 normally
used with COM1. No /x parameter is needed for the standard IRQ's.
Fossil Driver Support
---------------------
TRIVIA supports the use of Fossil drivers. To tell your Door to use the
Fossil driver instead of the standard COM ports, just put /FD on the command
line when running the door. For example:
MYDOOR MYDOOR.CFG /FD
MYDOOR MYDOOR.CFG *FD
Indicates that a Fossil driver is present and should be used. If no Fossil
driver is detected, TRIVIA will print a message to that effect and exit
the door gracefully.
TIPS AND TRAPS
The First and foremost TIP is that you DO run the INSTALL.BAT file that
is included in the archive. If you don't run this and have problems setting
the door up... Shame Shame.... When in doubt read the Docs!
Be sure to read all the READ.ME, README.1ST AND UPGRADE.DOC files if they
are included in the package. They sometimes contain some very useful
information. <G>
Of course you can do like me, just set the darn thing up without the docs
then fuss at the door author for not making it simple enough to work the
first time.
IF You get an error..check every path to make sure you typed it correctly.
Check the file name..does it match exactly? Does the configuration filename
match? Did you leave off the configuration file extension? Do you have the
correct BRUN module in a directory on your path? If all those seem correct
and the door still won't work...call me......preferably not in the middle
of the night...no door is that important.
When the door is in use...you can use the sysop options listed at the
bottom of your screen to chat, increase or decrease the users time or log
the user off.
MISCELLANEOUS NOTES
===================
DoorFrame requires DOS 3.x and up since all files are opened in SHARED
mode.
When using PCBOARD.SYS, TRIVIA requires that PCBOARD.DAT be in the same
directory as PCBOARD.SYS. TRIVIA also accesses the USERS file.
When using USERS.SYS, TRIVIA also accesses PCBOARD.SYS, PCBOARD.DAT and
the USERS file.
The DOOR.SYS used by TRIVIA is the standard 52 line GAP (tm) file.
The CALLINFO.BBS used by TRIVIA currently contains 36 lines.
DoorFrame doors may now make use of the IRQ environment variable. For
example, instead of DOOR DOOR.CFG /5 you can use DOOR DOOR.CFG /%IRQ%.
(This method is used on The Parole Board for WC! and it works just fine.
Use "/%WCIRQID%".)
DoorFrame is now aware of the PCBoard environment variables %PCBDRIVE% and
%PCBDIR%. If it finds those two variables on the first line of the .CFG
file it will substitute the correct drive and path.
LEGALITIES
__________
THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS
IS" WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT
NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH THE
CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT, SPECIAL,
OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF OR BREACH OF
ANY WARRANTY.
DISTRIBUTION
____________
You may make this file available for downloading from your BBS or you may
upload it to any BBS of your choice, provided that you do not make any
changes to the contents of the archive (ZIP file). The archive and its
individual contents may not be used by any service that charges any money
whatsoever, without the written permission of the author.
REGISTRATION
____________
I am not a subscriber to the "Crippleware" concept, and this program
reflects that philosophy. This is a full-featured program, whose
functionality is not hampered in any way, whether you register it or not.
It is only $19 to register this door.
Registered SysOps will receive a database of over 300 questions.
There is a 10 second delay that is removed once the program has been
registered.