home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / OLT_35.ZIP / SYSOP.DOC < prev    next >
Encoding:
Text File  |  1993-05-01  |  15.9 KB  |  402 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                               ON-LINE TRIVIA
  11.                               SYSOP'S MANUAL
  12.  
  13.                                   v3.5
  14.  
  15.                              March 6, 1993
  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.                           PAROLE TECHNOLOGIES
  25.                           311 Buffalo Rd
  26.                           Clayton, NC  27520
  27.                         (919) 965-3600 -> Voice
  28.                         (919) 965-9885 -> FAX
  29.  
  30.                           The Parole Board BBS
  31.  
  32.               (919) 965-4696 -> US Robotics Dual Standard
  33.  
  34.                             Free Advice BBS
  35.  
  36.                     Node 1 (919) 934-1002    USR HST
  37.  
  38.                                 OVERVIEW
  39.                                 ________
  40.  
  41.  
  42. CONGRATULATIONS!  You and your users will find ON-LINE TRIVIA
  43. entertaining and educational.  On-Line trivia is a carefully
  44. selected collection of 1750 questions segregated into user
  45. selectable multiple categories.  Your users can limit, mix or
  46. combine the question categories.  The program maintains a record of
  47. replies so the user may resume answering questions on another call. 
  48. The door displays a "top trivia player 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.      OLT.EXE      -- The main executable file
  60.      OLTSAMP.CFG  -- The sample configuration file
  61.      MASTER.DAT   -- The main trivia data file
  62.      SCREENS.ZIP  -- Screens for the OLT\SCREENS sub directory
  63.          ^┌──WELCOME.ANS  -- The program color Welcome Screen,
  64.          ││                  (Can be modified by Sysop).
  65.          ││  WELCOME.ASC  -- The program mono Welcome Screen
  66.          └┤                  (Can be modified by Sysop).
  67.           │  INSTRUCT.ANS -- The color user instruction file
  68.           └──INSTRUCT.ASC -- The mono user instruction file
  69.      SYSOP.DOC    -- The installation instructions...(this file)
  70.      QUIKUP.DOC   -- Quick and Dirty installation instructions.
  71.      REGISTER.TXT -- Information and registration form...This will
  72.                      give you a personalized door, voice or bbs   
  73.                      support services, new issues of master.dat   
  74.                      files, a clear conscience and a still poor but
  75.                      happy door programmer.
  76.      SAMPLE.BAT      Sample door batch file
  77.  
  78. IT IS FORBIDDEN TO DISTRIBUTE THIS ARCHIVE WITH THE "AV" REMOVED!
  79.      
  80. This ZIP file was created using the -AV function of PKZIP.  If my
  81. AV is missing then this file may not be complete of has been 
  82. tampered with.  Complete and current editions of this program are
  83. always available for D/L on The Parole Board BBS.  If the AV is
  84. missing please complain to your sysop to stop the practice of
  85. removing AV's as this is your assurance from the programmer that
  86. the file is complete and virus free.
  87.  
  88.  
  89.                               INSTALLATION
  90.                               ____________
  91.  
  92.    Installation is quite simple and straight-forward. Follow these
  93. steps and example and you should be up and running in a matter of
  94. minutes.  Although OLT is an easy program to install on most any
  95. BBS, there may be some Sysop who has trouble.  Support is available
  96. in those situations.
  97.  
  98.  
  99.       1) Create a directory to hold all OLT files
  100.  
  101.       2) Unzip OLT-xx.ZIP into the above directory
  102.  
  103.       3) Run INSTALL.BAT
  104.  
  105.       4) Create a configuration file, with a name of your choice
  106.          or modify the OLTSAMP.CFG file which is enclosed.
  107.  
  108.       5) Create a door batch file or use the sample enclosed.
  109.  
  110.  
  111.       6) Modify your particular BBS System Menus to add the
  112.          door.  The BBS setup various depending on the type BBS   
  113.          software you are running.  We assumed you are familiar   
  114.          with the general DOOR setup on your system.  Therefor our 
  115.          description includes only examples of the OLT specific   
  116.          configuration file and door batch file.  Refer to your
  117.          BBS documentation for door installation on your
  118.          particular software.
  119.  
  120.  
  121. BBS USER FILES
  122.  
  123.      The BBS user file provides information to OLT !!, such as COM
  124.      port, user name, time allowed in the door, etc.  This file is
  125.      necessary for OLT to function.  The complete path\filename of
  126.      the BBS user file must be passed to OLT.exe as the 1st
  127.      parameter in the command line.  The user file is created by
  128.      your BBS EACH time a user runs a door....The BBS USER file has
  129.      a different name on each type of BBS.  When you create your
  130.      OLT configuration file, you must tell OLT the name for your
  131.      particular BBS system.
  132.   
  133.      The following is a list of the user files used by the        
  134.      BBS types we support (we included a typical path).
  135.  
  136.        drive\dir\filename
  137.  
  138.    C:\WILDCAT\CALLINFO.BBS ──┐  <- For Wildcat!
  139.    C:\WC30\USERINFO.DAT      │  <- For Wildcat! 3.0 (Point to NODEx dir.)
  140.    C:\PCB\PCBOARD.SYS        │  <- For PCBoard using PCBOARD.SYS
  141.                              │     only
  142.    C:\PCB\USERS              │  <- For PCBoard using USERS only
  143.    C:\BBS\DOOR.SYS           │  <- For Systems which support
  144.                              │     DOOR.SYS
  145.    C:\BBS\DORINFOx.DEF       │  <- For QBBS/RBB/RA.  Replace x with
  146.                              │     Node #.
  147.    C:\BBS\GTUSER.BBS         │  <- For GT Power systems
  148.    C:\BBS\SFDOORS.DAT        │  <- For Spitfire
  149.    C:\BBS\CHAIN.TXT       ───┘  <- For WWIV
  150.  
  151.  
  152. NOTE: There are 2 additional lines necessary when using GTUSER.BBS. Since
  153.       this file does not provide the ComPort% and NodeNum% variables, advise
  154.       your Door users to add them to this .CFG file on lines 5 and 6
  155.       respectively. Both variables will default to 1.  All other lines
  156.       will move down 2 numbers.
  157.  
  158. CONFIGURATION FILE
  159.  
  160. One (and only ONE) of the above will be LINE 1 of your
  161. configuration file. You MUST specify the path and name (including
  162. any extension) correctly if you expect OLT to find it.  Sample for
  163. Lines 2 through 10 are:
  164.  
  165.    The Parole Board BBS         <- Your BBS Name
  166.    Dennis                       <- SysOp's First Name
  167.    Maidon                       <- SysOp's Last Name
  168.    00000                        <- Registration Number
  169.    100                          <- Minimum security level allowed
  170.                                    in door.
  171.    35                           <- Maximum questions allowed per visit
  172.                                    to the door.
  173.    C:\WC\BULL\BULL1.SCR         <- Path and Name of Color Bulletin
  174.    C:\WC\BULL\BULL1.BBS         <- Path and Name of ASCii Bulletin
  175.    WC                           <- WC = WC! 3.x Color Code Bulletins
  176.                                    PCB = PCBoard Color Code Bulletins
  177.                                    N = ANSI & ASCii Bulletins
  178.  
  179.    2                            <- Number of times per day a user may
  180.                                    enter the door
  181.  
  182.    RIP                          <- "RIP" enable RIP bulletins  "N"
  183.                                    disables
  184.  
  185.      Edit the Sample.CFG file to suit your individual BBS.  You
  186. must have all 12 lines and no extra characters.
  187.  
  188.   Line 1:  This line points to where OLT.EXE will find the callers
  189.            information file.  Just include the line that your     
  190.            particular BBS uses.  DO NOT put all of them in the CFG 
  191.            file.
  192.  
  193.    Line 2:  Place the name of your BBS on this line.
  194.  
  195.    Line 3:  SysOp's first name goes here.
  196.  
  197.    Line 4:  SysOp's last name goes here.
  198.  
  199.    Line 5:  Your Registration Number goes here if registered.  If
  200.             you haven't registered you can still use the          
  201.             door...just enter 00000 until you get your registration 
  202.             number.
  203.  
  204.    Line 6:  The minimum security level that is allowed in the door.
  205.  
  206.    Line 7:  Maximum number of questions allowed per visit to the door.
  207.             I would suggest 25-30 as a reasonable number.  The smaller
  208.             this number, the more likely that the users will continue to
  209.             use the door.
  210.  
  211.    Line 8:  Enter the complete path and name of the ANSI bulletin
  212.             that you want OLT to create.
  213.  
  214.    Line 9:  Enter the complete path and name of the ASCii bulletin
  215.             that  you want OLT to create.
  216.  
  217.    Line 10:  "WC" to create WC!3.x specific bulletins or "N" for ANSI and
  218.              ASCii bulletins.  Place "PCB" on this line for PCBoard
  219.              Color Coded bulletins. If you Config for WC! or PCB Bulls, Place
  220.              the name of the bulletin on Line 8 of the CFG file.  Be
  221.              sure to add the ".BBS" extension to it.  You may leave Line
  222.              9 blank but it still MUST be included in the CFG file.
  223.  
  224.    Line 11:  Place the number of times that you want the users to be
  225.              able to play OLT each day. For instance, a "2" placed on
  226.              this line will limit users to 2 plays per day.
  227.  
  228.    Line 12:  Place "RIP" on this line to create RIP style bulletins.
  229.              Place an "N" to disable.
  230.  
  231.          If you use the sample CFG file be sure to remove all
  232. remarks and use  a pure ASCII editor such as EDLIN or QEDIT.  Word
  233. processors typically leave hidden control codes. Those hidden codes
  234. could cause the program to depart for worlds unknown.  Save your
  235. newly edited file using any name you want....suggested OLT-01.cfg. 
  236.  
  237.  
  238.  
  239.  
  240.  
  241. DOOR BATCH FILE
  242.  
  243.          Create a batch file or modify the sample OLT.BAT file    
  244.          supplied. This is what you need:
  245.  
  246.   @ECHO OFF               Keeps a clean screen (optional)
  247.   CD \DOORS\OLT           Change to the OLT door files directory
  248.   OLT OLT-01.CFG          Run OLT using OLT-01.CFG configuration
  249.   CD\WCAT                 Change back to the WCAT BBS directory
  250.   CAT.BAT                 Restart the BBS.  On BBSs which shell to 
  251.                           dos to run the door this line may be    
  252.                           omitted or maybe the word "EXIT."  Check 
  253.                           your BBS door instructions.
  254.  
  255. MULTIPLE NODES
  256.  
  257.         Create a configuration file for each node.  Each file     
  258.         should have a unique name.  
  259.  
  260.         EX: OLT1.CFG  OLT2.CFG
  261.  
  262.         OLT has been tested under LIVECAT and DESQVIEW and performs 
  263.         very well under either or both.
  264.  
  265. COMM PORT IRQs
  266.  
  267. OLT is written using DoorFrame.   DoorFrame supports COM 1-4 on the
  268. standard IRQ's - COM1 or COM3 as a standard uses IRQ4 while  COM2
  269. and COM4 use IRQ3.  If your system uses a non-standard IRQ, add the
  270. IRQ  number after the configuration filename. Let's assume your
  271. Door is called FOOBAR and you want to use COM1 but non-standard
  272. IRQ5. The command line  passed to your Door would be:
  273.  
  274.         FOOBAR FOOBAR.CFG /5
  275.         FOOBAR FOOBAR.CFG *5
  276.  
  277.       The /5 tells DoorFrame to use IRQ5 rather than the standard
  278. IRQ4 normally used with COM1. No /x parameter is needed for the
  279. standard IRQ's.
  280.  
  281. Fossil Driver Support
  282. ---------------------
  283. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  284. Fossil driver instead of the standard COM ports, just put /FD on the command
  285. line when running the door. For example:
  286.  
  287.      MYDOOR MYDOOR.CFG /FD
  288.      MYDOOR MYDOOR.CFG *FD
  289.  
  290. indicates that a Fossil driver is present and should be used. If no Fossil
  291. driver is detected, DoorFrame will print a message to that effect and exit
  292. the door gracefully.
  293.  
  294.  
  295. TIPS AND TRAPS
  296.  
  297.       Be sure to read all the READ.ME, README.1ST AND UPGRADE.DOC
  298. files if they are included in the package.  They sometimes contain
  299. some very useful information. <G>  
  300. Of course you can do like me, just set the darn thing up without
  301. the docs then fuss at the door author for not making it simple
  302. enough to work the first time.
  303.  
  304.       IF You get an error...check every path to make sure you typed
  305. it correctly.  Check the file name...does it match exactly?  Does
  306. the configuration filename match?  Did you leave off the
  307. configuration file extension?   Do you have the correct BRUN module
  308. in a directory on your path?  If all those seem correct and the
  309. door still won't work...call me......preferably not in the middle
  310. of the night...no door is that important.
  311.  
  312.       When the door is in use...you can use the sysop options
  313. listed at the bottom of your screen to chat, increase or decrease
  314. the users time or log the user off.
  315.  
  316. LOCAL USE:
  317.  
  318.         You may type "OLT LOCAL" from the DOS prompt.  This will enable
  319. OLT to operate out of the BBS environment.
  320.  
  321.  
  322.  
  323.  
  324.                                 MISCELLANEOUS NOTES
  325.                                 ===================
  326.  
  327. DoorFrame requires DOS 3.x and up since all files are opened in SHARED mode.
  328.  
  329. When using PCBOARD.SYS, OLT requires that PCBOARD.DAT be in the same
  330. directory as PCBOARD.SYS. OLT also accesses the USERS file.
  331.  
  332. When using USERS.SYS, OLT also accesses PCBOARD.SYS, PCBOARD.DAT and the
  333. USERS file.
  334.  
  335. The DOOR.SYS used by OLT is the standard 52 line GAP (tm) file.
  336.  
  337. The CALLINFO.BBS used by OLT currently contains 36 lines.
  338.  
  339.  
  340.  
  341.  
  342.  
  343.                               LEGALITIES
  344.                               __________
  345.  
  346.  
  347.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS
  348. IS"  WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT
  349. NOT LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND
  350. FITNESS  FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE
  351. INVOLVED WITH THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE
  352. FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY
  353. USE THEREOF OR BREACH OF ANY WARRANTY.
  354.  
  355.  
  356.                              DISTRIBUTION
  357.                              ____________
  358.  
  359.    You may make this file available for downloading from your BBS
  360. or you may  upload it to any BBS of your choice, provided that you
  361. do not make any  changes to the contents of the archive (ZIP file).
  362. The archive and its  individual contents may not be used by any
  363. service that charges any money whatsoever, without the written
  364. permission of the author.  The "AV" of PAROLE software MAY NOT be
  365. removed from this archive.
  366.  
  367.                              REGISTRATION
  368.                              ____________
  369.  
  370.    I am not a subscriber to the "Crippleware" concept, and this
  371. program  reflects that philosophy. This is a full-featured program,
  372. whose functionality is not hampered in any way, whether you
  373. register it or  not.  It is only $15 to register this door.  There is a
  374. 15 second pause which will be removed upon registering OLT.
  375.  
  376.    Remember, whether you are registered or not, should you have any
  377. problems, questions or suggestions for improvements, feel free to call.
  378.  
  379.                                  THANKS
  380.                              --------------
  381.  
  382.     Special thanks goes out for my wife who is definitely a
  383.     "Computer Widow".
  384.  
  385.     Ted Freeman the author of DoorFrame, a first class BBS Doors
  386.     Development Library.
  387.  
  388.     My BBS users who have had to endure constant badgering to help 
  389.     me test the programs that I have written.
  390.  
  391.     A *VERY SPECIAL THANKS* to Mustang! Software for developing the 
  392.     greatest BBS Software on the market, WILDCAT! 3.x.  And about 
  393.     to be even better when they revamp the on-line chat feature.
  394.  
  395.     Liane Benway, SysOp, Running Wild !!! in Norcross, GA.  Without
  396.     Liane, you wouldn't have these fine DOCs.
  397.  
  398.     John Kutas, SysOp, THE SWINGERS CONNECTION BBS in Philadelphia, PA.
  399.     After countless long hours on the telephone, we finally solved the
  400.     world's problems.
  401.  
  402.