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