home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbs_door / olt_10.arj / SYSOP.DOC < prev   
Text File  |  1992-01-09  |  15KB  |  380 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                               ON-LINE TRIVIA
  11.                               SYSOP'S MANUAL
  12.  
  13.                                  v1.0
  14.  
  15.                                Jan 11, 1992
  16.                          PCBoard 14.x and GAP 4.x
  17.                            WILDCAT!, SPITFIRE
  18.                              QBBS, RBBS, RA
  19.                                   WWIV
  20.  
  21.                                    by
  22.  
  23.                              Dennis Maidon
  24.  
  25.                           The Parole Board BBS
  26.  
  27.        (919) 965-4696 - Node 1 - Dual Standard - 1200 - 19200 Bps
  28.  
  29.          (919) 965-0068 - Node 2 - Intel 24EX - 1200 - 2400 Bps
  30.  
  31.  
  32.  
  33.                                 OVERVIEW
  34.                                 ________
  35.  
  36.  
  37. CONGRATULATIONS!  You and your users will find ON-LINE TRIVIA
  38. entertaining and educational.  On-Line trivia is a carefully
  39. selected collection of 1750 questions segregated into user
  40. selectable multiple categories.  Your users can limit, mix or
  41. combine the question categories.  The program maintains a record of
  42. replies so the user may resume answering questions on another call. 
  43. The door displays a "top trivia player bulletin to the caller while
  44. it creates bulletins and logs for your use.  Best of all..this door
  45. is not crippleware.  It isn't full of advertisements and
  46. limitations...best of all I don't charge an arm and a leg.  You'll
  47. also find we are responsive to your questions.  If you need help or
  48. have a suggestion for improving this product, let me know!
  49.                      FILES AND DESCRIPTIONS
  50.                      ______________________
  51.  
  52. The archive includes the following files:
  53.  
  54.      OLT-01.EXE   -- The main executable file
  55.      OLTSAMP.CFG  -- The sample configuration file
  56.      MASTER.DAT   -- The main trivia data file
  57.      SAMPLE.LOG   -- A sample of the log file produced
  58.      SCREENS.ZIP  -- Screens for the OLT\SCREENS sub directory
  59.          ^┌──WELCOME.ANS  -- The program color Welcome Screen,
  60.          ││                  (Can be modified by Sysop).
  61.          ││  WELCOME.ASC  -- The program mono Welcome Screen
  62.          └┤                  (Can be modified by Sysop).
  63.           │  INSTRUCT.ANS -- The color user instruction file
  64.           └──INSTRUCT.ASC -- The mono user instruction file
  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.      LOCAL.ZIP    -- Sample door.sys and userinfo.dat for
  69.                      local testing.
  70.      REGISTER.TXT -- Information and registration form...This will
  71.                      give you a personalized door, voice or bbs   
  72.                      support services, new issues of master.dat   
  73.                      files, a clear conscience and a still poor but
  74.                      happy door programmer.
  75.      SAMPLE.BAT      Sample door batch file
  76.      
  77. This ZIP file was created using the -AV function of PKZIP.  If my
  78. AV is missing then this file may not be complete of has been 
  79. tampered with.  Complete and current editions of this program are
  80. always available for D/L on The Parole Board BBS.  If the AV is
  81. missing please complain to your sysop to stop the practice of
  82. removing AV's as this is your assurance from the programmer that
  83. the file is complete and virus free.
  84.  
  85.  
  86.                               INSTALLATION
  87.                               ____________
  88.  
  89.    Installation is quite simple and straight-forward. Follow these
  90. steps and example and you should be up and running in a matter of
  91. minutes.  Although OLT is an easy program to install on most any
  92. BBS, there may be some Sysop who has trouble.  Support is available
  93. in those situations.
  94.  
  95.  
  96.       1) Create a directory to hold all OLT files
  97.  
  98.       2) Unzip OLT-xx.ZIP into the above directory
  99.  
  100.       3) Run INSTALL.BAT
  101.  
  102.       4) Create a configuration file, with a name of your choice
  103.          or modify the OLTSAMP.CFG file which is enclosed.
  104.  
  105.       5) Create a door batch file or use the sample enclosed.
  106.  
  107.  
  108.       6) Modify your particular BBS System Menus to add the
  109.          door.  The BBS setup various depending on the type BBS   
  110.          software you are running.  We assumed you are familiar   
  111.          with the general DOOR setup on your system.  Therefor our 
  112.          description includes only examples of the OLT specific   
  113.          configuration file and door batch file.  Refer to your
  114.          BBS documentation for door installation on your
  115.          particular software.
  116.  
  117.       7) If not already on your system, be sure to add BRUN45.exe
  118.          into a directory on your path.  BRUN45.EXE is NOT included 
  119.          but IS required !!!  You can download  BRUNxx.EXE modules 
  120.          from many BBS systems or they are available on the PAROLE 
  121.          BOARD.  You only need one copy, even if you run other    
  122.          doors which use BRUN45.EXE.
  123.  
  124.  
  125.  
  126. BBS USER FILES
  127.  
  128.      The BBS user file provides information to OLT !!, such as COM
  129.      port, user name, time allowed in the door, etc.  This file is
  130.      necessary for OLT to function.  The complete path\filename of
  131.      the BBS user file must be passed to OLT.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.      OLT configuration file, you must tell OLT 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\USERINFO.DAT      │  <- For Wildcat! 3.0
  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 with 
  150.                                    Node #.
  151.    C:\BBS\SFDOORS.DAT        │  <- For Spitfire
  152.    C:\BBS\CHAIN.TXT       ───┘  <- For WWIV
  153.  
  154.  
  155. CONFIGURATION FILE
  156.  
  157. One (and only ONE) of the above will be LINE 1 of your
  158. configuration file. You MUST specify the path and name (including
  159. any extension) correctly if you expect OLT to find it.  Sample for
  160. Lines 2 through 10 are:
  161.  
  162.    The Parole Board BBS         <- Your BBS Name
  163.    Dennis                       <- SysOp's First Name
  164.    Maidon                       <- SysOp's Last Name
  165.    00000                        <- Registration Number
  166.    100                          <- Minimum security level allowed 
  167.                                    in door.
  168.    35                           <- Maximum questions allowed per visit
  169.                                    to the door.
  170.    C:\WC\BULL\BULL1.SCR         <- Path and Name of Color Bulletin
  171.    C:\WC\BULL\BULL1.BBS         <- Path and Name of ASCii Bulletin
  172.    Y                            <- (Y/N) Create WC!3.x specific
  173.                                    bulletins or not.  Y = WC! Bulls
  174.  
  175.      Edit the Sample.CFG file to suit your individual BBS.  You
  176. must have all 10 lines and no extra characters.
  177.  
  178.   Line 1:  This line points to where OLT.EXE will find the callers
  179.            information file.  Just include the line that your     
  180.            particular BBS uses.  DO NOT put all of them in the CFG 
  181.            file.
  182.  
  183.    Line 2:  Place the name of your BBS on this line.
  184.  
  185.    Line 3:  SysOp's first name goes here.
  186.  
  187.    Line 4:  SysOp's last name goes here.
  188.  
  189.    Line 5:  Your Registration Number goes here if registered.  If
  190.             you haven't registered you can still use the          
  191.             door...just enter 00000 until you get your registration 
  192.             number.
  193.  
  194.    Line 6:  The minimum security level that is allowed in the door.
  195.  
  196.    Line 7:  Maximum number of questions allowed per visit to the door.
  197.             I would suggest 25-30 as a reasonable number.  The smaller
  198.             this number, the more likely that the users will continue to
  199.             use the door.
  200.  
  201.    Line 8:  Enter the complete path and name of the ANSI bulletin
  202.             that you want OLT to create.
  203.  
  204.    Line 9:  Enter the complete path and name of the ASCii bulletin
  205.             that  you want OLT to create.
  206.  
  207.    Line 10:  YES to create WC!3.x specific bulletins or NO for ANSI and
  208.              ASCii bulletins.  If you Config for WC! bulletins, Place
  209.              the name of the bulletin on Line 8 of the CFG file.  Be
  210.              sure to add the ".BBS" extension to it.  You may leave Line
  211.              9 blank but it still MUST be included in the CFG file.
  212.  
  213.  
  214.          If you use the sample CFG file be sure to remove all
  215. remarks and use  a pure ASCII editor such as EDLIN or QEDIT.  Word
  216. processors typically leave hidden control codes. Those hidden codes
  217. could cause the program to depart for worlds unknown.  Save your
  218. newly edited file using any name you want....suggested OLT-01.cfg. 
  219.  
  220.  
  221.  
  222.  
  223.  
  224. DOOR BATCH FILE
  225.  
  226.          Create a batch file or modify the sample OLT.BAT file    
  227.          supplied. This is what you need:
  228.  
  229.   @ECHO OFF               Keeps a clean screen (optional)
  230.   CD \DOORS\OLT           Change to the OLT door files directory
  231.   OLT OLT-01.CFG          Run OLT using OLT-01.CFG configuration
  232.   CD\WCAT                 Change back to the WCAT BBS directory
  233.   CAT.BAT                 Restart the BBS.  On BBSs which shell to 
  234.                           dos to run the door this line may be    
  235.                           omitted or maybe the word "EXIT."  Check 
  236.                           your BBS door instructions.
  237.  
  238. MULTIPLE NODES
  239.  
  240.         Create a configuration file for each node.  Each file     
  241.         should have a unique name.  
  242.  
  243.         EX: OLT-01.CFG  OLT-02.CFG
  244.  
  245.         OLT has been tested under LIVECAT and DESQVIEW and performs 
  246.         very well under either or both.
  247.  
  248.  
  249. LIVECAT! USERS  (WILDCAT!3.0 ONLY!!!!!!)
  250.  
  251.     If you are using LIVECAT! to control your doors you will need
  252. to make one small change in your door.bat file.  LC! changes
  253. DOOR.SYS to DOOR.ORG when it shells out to the door.  You will need
  254. to add this line in your script right after echo off 
  255.  
  256.                 COPY DOOR.ORG DOOR.SYS
  257.  
  258.     If you don't do this, OLT just gives up and dies a very unhappy
  259. death.  Don't worry about deleting the copied file when OLT
  260. finishes ....there are no reported problems with it.  
  261.  
  262.  
  263. COMM PORT IRQs
  264.  
  265. OLT is written using DoorFrame.   DoorFrame supports COM 1-4 on the
  266. standard IRQ's - COM1 or COM3 as a standard uses IRQ4 while  COM2
  267. and COM4 use IRQ3.  If your system uses a non-standard IRQ, add the
  268. IRQ  number after the configuration filename. Let's assume your
  269. Door is called FOOBAR and you want to use COM1 but non-standard
  270. IRQ5. The command line  passed to your Door would be:
  271.  
  272.         FOOBAR FOOBAR.CFG /5
  273.  
  274.       The /5 tells DoorFrame to use IRQ5 rather than the standard
  275. IRQ4 normally used with COM1. No /x parameter is needed for the
  276. standard IRQ's.
  277.  
  278.  
  279. TIPS AND TRAPS
  280.  
  281.       Be sure to read all the READ.ME, README.1ST AND UPGRADE.DOC
  282. files if they are included in the package.  They sometimes contain
  283. some very useful information. <G>  
  284. Of course you can do like me, just set the darn thing up without
  285. the docs then fuss at the door author for not making it simple
  286. enough to work the first time.
  287.  
  288.       IF You get an error...check every path to make sure you typed
  289. it correctly.  Check the file name...does it match exactly?  Does
  290. the configuration filename match?  Did you leave off the
  291. configuration file extension?   Do you have the correct BRUN module
  292. in a directory on your path?  If all those seem correct and the
  293. door still won't work...call me......preferably not in the middle
  294. of the night...no door is that important.
  295.  
  296.       When the door is in use...you can use the sysop options
  297. listed at the bottom of your screen to chat, increase or decrease
  298. the users time or log the user off.
  299.  
  300.  
  301.  
  302.  
  303.                                 MISCELLANEOUS NOTES
  304.                                 ===================
  305.  
  306. DoorFrame requires DOS 3.x and up since all files are opened in SHARED mode.
  307.  
  308. When using PCBOARD.SYS, OLT requires that PCBOARD.DAT be in the same
  309. directory as PCBOARD.SYS. OLT also accesses the USERS file.
  310.  
  311. When using USERS.SYS, OLT also accesses PCBOARD.SYS, PCBOARD.DAT and the
  312. USERS file.
  313.  
  314. The DOOR.SYS used by OLT is the standard 52 line GAP (tm) file.
  315.  
  316. The CALLINFO.BBS used by OLT currently contains 36 lines.
  317.  
  318.  
  319.  
  320.                               LEGALITIES
  321.                               __________
  322.  
  323.  
  324.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS
  325. IS"  WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT
  326. NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND
  327. FITNESS  FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE
  328. INVOLVED WITH THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE
  329. FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY
  330. USE THEREOF OR BREACH OF ANY WARRANTY.
  331.  
  332.  
  333.                              DISTRIBUTION
  334.                              ____________
  335.  
  336.    You may make this file available for downloading from your BBS
  337. or you may  upload it to any BBS of your choice, provided that you
  338. do not make any  changes to the contents of the archive (ZIP file).
  339. The archive and its  individual contents may not be used by any
  340. service that charges any money whatsoever, without the written
  341. permission of the author.
  342.  
  343.                              REGISTRATION
  344.                              ____________
  345.  
  346.    I am not a subscriber to the "Crippleware" concept, and this
  347. program  reflects that philosophy. This is a full-featured program,
  348. whose functionality is not hampered in any way, whether you
  349. register it or  not.  It is only $15 to register this door.
  350.  
  351.    Remember, whether you are registered or not, should you have any
  352. problems, questions or suggestions for improvements, be sure to
  353. drop me a message on either of the aforementioned BBS or via the
  354. DOORS or SYSOP conference on RIME(tm), Node ID = PAROLE.
  355.  
  356.  
  357.                                  THANKS
  358.                              --------------
  359.  
  360.     Special thanks goes out for my wife who is definitely a
  361.     "Computer Widow".
  362.  
  363.     Ted Freeman the author of DoorFrame, a first class BBS Doors
  364.     Development Library.
  365.  
  366.     My BBS users who have had to endure constant badgering to help 
  367.     me test the programs that I have written.
  368.  
  369.     A *VERY SPECIAL THANKS* to Mustang! Software for developing the 
  370.     greatest BBS Software on the market, WILDCAT! 3.x.  And about 
  371.     to be even better when they revamp the on-line chat feature.
  372.  
  373.     Liane Benway, SysOp, Running Wild !!! in Norcross, GA.  Without
  374.     Liane, you wouldn't have these fine DOCs.
  375.  
  376.     John Kutas, SysOp, THE SWINGERS CONNECTION BBS in Philadelphia, PA.
  377.     After countless long hours on the telephone, we finally solved the
  378.     world's problems.
  379.  
  380.