home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / DOOR / DMDTRV40.ZIP / SYSOP.DOC < prev    next >
Text File  |  1995-02-12  |  18KB  |  420 lines
  1.  
  2.  
  3.                         ENTERTAINMENT AWARDS TRIVIA
  4.                              DIAMOND TRIVIA
  5.                             MOVIETIME TRIVIA
  6.                            NCAA SPORTS TRIVIA
  7.                             CELEBRITY TRIVIA
  8.                             STAR TREK TRIVIA
  9.                         AMERICAN HISTORY TRIVIA
  10.                              QUOTES & QUIPS
  11.  
  12.                               SYSOP'S MANUAL
  13.  
  14.                                   v4.0
  15.  
  16.                            February 12, 1995
  17.                          PCBoard 14.x and GAP 4.x
  18.                            WILDCAT!, SPITFIRE
  19.                              QBBS, RBBS, RA
  20.  
  21.                                    by
  22.  
  23.                              Dennis Maidon
  24.                           PAROLE TECHNOLOGIES
  25.                           9411 Buffalo Rd
  26.                           Clayton, NC  27520
  27.  
  28.                           (919) 965-3600 -> Voice
  29.  
  30.                           The Parole Board BBS
  31.                             FIDO: 1:151/185
  32.                        InterNet: dmaidon@cris.com
  33.  
  34.             (919) 965-4696 -> USR Dual Standard v.Everything
  35.  
  36.                            -=-=-=-=-=-=-=-=-
  37.  
  38.                                 OVERVIEW
  39.                                 ________
  40. NOTE:  Since this documentation covers all the PAROLE Software trivia
  41. doors, I will refer to the EXE name as AWARD.EXE for the rest of this
  42. file.  Please substitute the correct name for the particular door you
  43. are attempting to setup.
  44.  
  45. CONGRATULATIONS!  You and your users will find this Trivia door
  46. entertaining and educational.  It consists of approximately 100 or
  47. so questions that were carefully selected for your entertainment.
  48. The door displays a "Trivia Royalty" bulletin to the caller while
  49. it creates bulletins and logs for your use.  Best of all..this door
  50. is not crippleware.  It isn't full of advertisements and
  51. limitations...best of all I don't charge an arm and a leg.  You'll
  52. also find we are responsive to your questions.  If you need help or
  53. have a suggestion for improving this product, let me know!
  54.                      FILES AND DESCRIPTIONS
  55.                      ______________________
  56.  
  57. The archive includes the following files:
  58.  
  59.      AWARD.EXE     -- The main executable file
  60.      SAMPLE.CFG     -- The sample configuration file
  61.      AWARD.DAT   -- The main trivia data file
  62.      AWARD.HIS   -- Release History and changes
  63.      SAMPLE.LOG     -- A sample of the log file produced
  64.      SCREENS.ZIP    -- Screens for the AWARD\SCREENS sub directory
  65.      SYSOP.DOC    -- The installation instructions...(this file)
  66.      QUIKUP.DOC   -- Quick and Dirty installation instructions.
  67.      MAINTAIN.ZIP -- Program to trim the scores database.
  68.      REGISTER.TXT -- Information and registration form...This will
  69.                      give you a personalized door, voice or bbs   
  70.                      support services, new issues of master.dat   
  71.                      files, a clear conscience and a still poor but
  72.                      happy door programmer.
  73.      DOOR.BAT        Sample door batch file
  74.      
  75. This ZIP file was created using the -AV function of PKZIP.  If my
  76. AV is missing then this file may not be complete or has been
  77. tampered with.  Complete and current editions of this program are
  78. always available for D/L on The Parole Board BBS.  If the AV is
  79. missing please complain to your sysop to stop the practice of
  80. removing AV's as this is your assurance from the programmer that
  81. the file is complete and virus free.
  82.  
  83.  
  84.                               INSTALLATION
  85.                               ____________
  86.  
  87.    Installation is quite simple and straight-forward. Follow these
  88. steps and example and you should be up and running in a matter of
  89. minutes.  Although AWARD is an easy program to install on most any
  90. BBS, there may be some Sysop who has trouble.  Support is available
  91. in those situations.
  92.  
  93.  
  94.       1) Create a directory to hold all AWARD files
  95.  
  96.       2) Unzip AWARDxx.ZIP into the above directory
  97.  
  98.       3) Run INSTALL.BAT  <-Important
  99.  
  100.       4) Create a configuration file, with a name of your choice
  101.          or modify the SAMPLE.CFG file which is enclosed.
  102.  
  103.       5) Create a door batch file or use the sample enclosed.
  104.  
  105.  
  106.       6) Modify your particular BBS System Menus to add the
  107.          door.  The BBS setup various depending on the type BBS   
  108.          software you are running.  We assumed you are familiar   
  109.          with the general DOOR setup on your system.  Therefore our
  110.          description includes only examples of the AWARD specific
  111.          configuration file and door batch file.  Refer to your
  112.          BBS documentation for door installation on your
  113.          particular software.
  114.  
  115.  
  116.  
  117. BBS USER FILES
  118.  
  119.      The BBS user file provides information to AWARD!!, such as COM
  120.      port, user name, time allowed in the door, etc.  This file is
  121.      necessary for AWARD to function.  The complete path\filename of
  122.      the BBS user file must be passed to AWARD.EXE as the 1st
  123.      parameter in the command line.  The user file is created by
  124.      your BBS EACH time a user runs a door....The BBS USER file has
  125.      a different name on each type of BBS.  When you create your
  126.      AWARD configuration file, you must tell AWARD the name for your
  127.      particular BBS system.
  128.   
  129.      The following is a list of the user files used by the        
  130.      BBS types we support (we included a typical path).
  131.  
  132. drive\dir\filename
  133.    C:\WILDCAT\CALLINFO.BBS              ──┐  <- For Wildcat! 2.x
  134.    C:\WC30\WCWORK\NODE1\USERINFO.DAT      │  <- For Wildcat! 3.x
  135.    C:\WC4\WCWORK\NODE1\DOOR.SYS           │  <- For Wildcat! 4.x
  136.    C:\PCB\PCBOARD.SYS                     │  <- For PCBoard using PCBOARD.SYS
  137.                                           │     only
  138.    C:\PCB\USERS                           │  <- For PCBoard using USERS only
  139.    C:\BBS\DOOR.SYS                        │  <- For Systems which support
  140.                                           │     DOOR.SYS
  141.    C:\BBS\DORINFOx.DEF                    │  <- For QBBS/RBB/RA.  Replace x
  142.                                           │     with Node#.
  143.    C:\BBS\TRIBBS.SYS                      │  <- fOR TriBBS
  144.    C:\BBS\SFDOORS.DAT                   ──┘  <- For Spitfire
  145.  
  146. CONFIGURATION FILE
  147.  
  148. One (and only ONE) of the above will be LINE 1 of your
  149. configuration file. You MUST specify the path and name (including
  150. any extension) correctly if you expect AWARD to find it.  Sample for
  151. Lines 2 through 10 are:
  152.  
  153.    The Parole Board BBS         <- Your BBS Name
  154.    Dennis                       <- SysOp's First Name
  155.    Maidon                       <- SysOp's Last Name
  156.    00000                        <- Registration Number
  157.    100                          <- Minimum security level allowed 
  158.                                    in door.
  159.    35                           <- Maximum questions allowed per visit
  160.                                    to the door.
  161.    C:\WC\BULL\BULL1.SCR         <- Path and Name of Color Bulletin
  162.    C:\WC\BULL\BULL1.BBS         <- Path and Name of ASCii Bulletin
  163.    WC                           <- WC Create WC!3.x specific bulls
  164.                                    PCB Create PCBoard specific bulls
  165.                                    Blank for ANSI & ASCii
  166.    2                            <- Number of times allowed to play door
  167.                                    each day.
  168.    RIP                          <- "RIP" create RIP bulletins
  169.                                    "N" do not create RIP bulls
  170.  
  171.    15                           <- Number of seconds to allow the user
  172.                                    to answer each question.  The door
  173.                                    will accept a timeout as an incorrect
  174.                                    answer.  The door defaults to 10
  175.                                    seconds.
  176.  
  177.  
  178.      Edit the Sample.CFG file to suit your individual BBS.  You
  179. must have all 13 lines and no extra characters.
  180.  
  181.   Line 1:  This line points to where AWARD.EXE will find the callers
  182.            information file.  Just include the line that your     
  183.            particular BBS uses.  DO NOT put all of them in the CFG 
  184.            file.
  185.  
  186.    Line 2:  Place the name of your BBS on this line.
  187.  
  188.    Line 3:  SysOp's first name goes here.
  189.  
  190.    Line 4:  SysOp's last name goes here.
  191.  
  192.    Line 5:  Your Registration Number goes here if registered.  If
  193.             you haven't registered you can still use the          
  194.             door...just enter 00000 until you get your registration 
  195.             number.
  196.  
  197.    Line 6:  The minimum security level that is allowed in the door.
  198.  
  199.    Line 7:  Maximum number of questions allowed per visit to the door.
  200.             I would suggest 25-30 as a reasonable number.  The smaller
  201.             this number, the more likely that the users will continue to
  202.             use the door.
  203.  
  204.    Line 8:  Enter the complete path and name of the ANSI bulletin
  205.             that you want AWARD to create.
  206.  
  207.    Line 9:  Enter the complete path and name of the ASCii bulletin
  208.             that  you want AWARD to create.
  209.  
  210.    Line 10:  "WC" to create WC!3.x specific bulletins or NO for ANSI and
  211.              ASCii bulletins. "PCB" on this line will enable the program
  212.              to create PCBoard specific color bulletins.  If you Config
  213.              for WC! or PCB bulletins, Place the name of the bulletin
  214.              on Line 8 of the CFG file.  Be sure to add the ".BBS"
  215.              extension to it.  You may leave Line 9 blank but it still
  216.              MUST be included in the CFG file.
  217.  
  218.     Line 11: Number of times users are allowed to enter the door each
  219.              day.
  220.  
  221.     Line 12:  Place "RIP" on this line if you wish to create RIP styple
  222.               bulletins.  If you do not support or need them, place an
  223.               "N" on this line.
  224.  
  225.     Line 13:  Place the number of seconds that you wish to allow to
  226.               answer each question.
  227.  
  228.  
  229.          If you use the sample CFG file be sure to remove all
  230. remarks and use  a pure ASCII editor such as EDLIN or QEDIT.  Word
  231. processors typically leave hidden control codes. Those hidden codes
  232. could cause the program to depart for worlds unknown.  Save your
  233. newly edited file using any name you want....suggested AWARD1.CFG.
  234.  
  235. DONOR.CL       Registered Users may create a file named DONOR.CL and place it
  236.                in the door directory.  If found, the door will display a
  237.                prompt thanking them for donating the door.
  238.  
  239. GOODBYE.NO     Place this file in the door directory to turn the
  240.                [G]oodbye option off.
  241.  
  242. DOOR BATCH FILE
  243.  
  244.          Create a batch file or modify the sample AWARD.BAT file
  245.          supplied. This is what you need:
  246.  
  247.   @ECHO OFF
  248.   CLS                   Keeps a clean screen (optional)
  249.   CD \DOORS\AWARD      Change to the AWARD door files directory
  250.   AWARD AWARD1.CFG    Run AWARD using AWARD1.CFG configuration
  251.                           Change back to the WCAT BBS directory
  252.                           Restart the BBS.  On BBSs which shell to
  253.                           dos to run the door this line may be    
  254.                           omitted or maybe the word "EXIT."  Check 
  255.                           your BBS door instructions.
  256.  
  257. The above DOOR.BAT file is for a Wildcat! 3.x system using SWAP instead
  258. of TERMINATE for doors.
  259.  
  260. MULTIPLE NODES
  261.  
  262.         Create a configuration file for each node.  Each file     
  263.         should have a unique name.  
  264.  
  265.         EX: AWARD1.CFG  AWARD2.CFG
  266.  
  267.         AWARD has been tested under LIVECAT and DESQVIEW and performs
  268.         very well under either or both.
  269.  
  270.  
  271.  
  272. COMM PORT IRQs
  273.  
  274. AWARD is written using DoorFrame.   DoorFrame supports COM 1-4 on the
  275. standard IRQ's - COM1 or COM3 as a standard uses IRQ4 while  COM2
  276. and COM4 use IRQ3.  If your system uses a non-standard IRQ, add the
  277. IRQ  number after the configuration filename. Let's assume your
  278. Door is called FOOBAR and you want to use COM1 but non-standard
  279. IRQ5. The command line  passed to your Door would be:
  280.  
  281.         FOOBAR FOOBAR.CFG /5
  282.         FOOBAR FOOBAR.CFG *5
  283.  
  284.       The /5 tells DoorFrame to use IRQ5 rather than the standard
  285. IRQ4 normally used with COM1. No /x parameter is needed for the
  286. standard IRQ's.
  287.  
  288. Fossil Driver Support
  289. ---------------------
  290. CatList supports the use of Fossil drivers.  To tell your Door to use the
  291. Fossil driver instead of the standard COM ports, just put /FD on the command
  292. line when running the door. For example:
  293.  
  294.      MYDOOR MYDOOR.CFG /FD
  295.      MYDOOR MYDOOR.CFG *FD
  296.  
  297. indicates that a Fossil driver is present and should be used. If no Fossil
  298. driver is detected, CatList will print a message to that effect and exit
  299. the door gracefully.
  300.  
  301.  
  302. TIPS AND TRAPS
  303.  
  304.       Be sure to read all the READ.ME, README.1ST AND UPGRADE.DOC
  305. files if they are included in the package.  They sometimes contain
  306. some very useful information. <G>  
  307. Of course you can do like me, just set the darn thing up without
  308. the docs then fuss at the door author for not making it simple
  309. enough to work the first time.
  310.  
  311.       IF You get an error...check every path to make sure you typed
  312. it correctly.  Check the file name...does it match exactly?  Does
  313. the configuration filename match?  Did you leave off the
  314. configuration file extension?   Do you have the correct BRUN module
  315. in a directory on your path?  If all those seem correct and the
  316. door still won't work...call me......preferably not in the middle
  317. of the night...no door is that important.
  318.  
  319.       When the door is in use...you can use the sysop options
  320. listed at the bottom of your screen to chat, increase or decrease
  321. the users time or log the user off.
  322.  
  323.  
  324.  
  325.  
  326.                                 MISCELLANEOUS NOTES
  327.                                 ===================
  328.  
  329. DoorFrame requires DOS 3.x and up since all files are opened in SHARED mode.
  330.  
  331. When using PCBOARD.SYS, AWARD requires that PCBOARD.DAT be in the same
  332. directory as PCBOARD.SYS. AWARD also accesses the USERS file.
  333.  
  334. When using USERS.SYS, AWARD also accesses PCBOARD.SYS, PCBOARD.DAT and the
  335. USERS file.
  336.  
  337. The DOOR.SYS used by AWARD is the standard 52 line GAP (tm) file.
  338.  
  339. The CALLINFO.BBS used by AWARD currently contains 36 lines.
  340.  
  341. DoorFrame doors may now make use of the IRQ environment variable. For
  342. example, instead of DOOR DOOR.CFG /5 you can use DOOR DOOR.CFG /%IRQ%.
  343. (I use this method here on The Parole Board for WC! and it works just
  344. fine.  Use "/%WCIRQID%".)
  345.  
  346. DoorFrame is now aware of the PCBoard environment variables %PCBDRIVE% and
  347. %PCBDIR%. If it finds those two variables on the first line of the .CFG
  348. file it will substitute the correct drive and path.
  349.  
  350.  
  351.  
  352.                               LEGALITIES
  353.                               __________
  354.  
  355.  
  356.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS
  357. IS"  WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT
  358. NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND
  359. FITNESS  FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE
  360. INVOLVED WITH THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE
  361. FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY
  362. USE THEREOF OR BREACH OF ANY WARRANTY.
  363.  
  364.  
  365.                              DISTRIBUTION
  366.                              ____________
  367.  
  368.    You may make this file available for downloading from your BBS
  369. or you may  upload it to any BBS of your choice, provided that you
  370. do not make any  changes to the contents of the archive (ZIP file).
  371. The archive and its  individual contents may not be used by any
  372. service that charges any money whatsoever, without the written
  373. permission of the author.
  374.  
  375.                              REGISTRATION
  376.                              ____________
  377.  
  378.    I am not a subscriber to the "Crippleware" concept, and this
  379. program  reflects that philosophy. This is a full-featured program,
  380. whose functionality is not hampered in any way, whether you
  381. register it or not.  It is only $15 to register this door.  Registered
  382. SysOps will receive an added utility that will allow you to edit and/or
  383. add questions to the database.  There is a 10 second delay that is
  384. removed once the program has been registered.
  385.  
  386.  
  387.                                  THANKS
  388.                              --------------
  389.  
  390.     Special thanks goes out for my wife who is definitely a
  391.     "Computer Widow".
  392.  
  393.     Ted Freeman the author of DoorFrame, a first class BBS Doors
  394.     Development Library.  May Ted be remembered always in the fine
  395.     programs he created.
  396.  
  397.     My BBS users who have had to endure constant badgering to help 
  398.     me test the programs that I have written.
  399.  
  400.     A *VERY SPECIAL THANKS* to Mustang! Software for developing the 
  401.     greatest BBS Software on the market, WILDCAT! 3.x.
  402.  
  403.     Liane Benway, SysOp, Running Wild !!! in Norcross, GA.  Without
  404.     Liane, you wouldn't have these fine DOCs.
  405.  
  406.     Ned Attayek, SysOp, Free Advice BBS in Smithfield, NC for his
  407.     tireless effort in coming up with all these questions.
  408.  
  409.     Award Trivia is written using MicroSoft's Visual Basic for DOS
  410.     v1.0.  VB/DOS is copyright 1992, MicroSoft Inc.
  411.  
  412.     The question database for Star Trek Trivia was written by Tom Walker
  413.     of "The Tholian Web" BBS in Hopewell Junction, NY. (914) 227-4402.
  414.     Robert Ferguson of "Klingon Software Labs" has also contributed to
  415.     the Star Trek Trivia database. (Philadelphia, PA (215) 426-5596)
  416.  
  417.     Many thanks for the excellent suggestions I've received from all of
  418.     you.
  419.  
  420.