home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / PCBOARD / VOTE199C.ZIP / SETUP.DOC < prev    next >
Text File  |  1994-02-14  |  14KB  |  314 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                 ██┐    ██┐ ███████┐ ████████┐ ███████┐ ███████┐
  10.                 ██│    ██│ ██┌──██│ └──██┌──┘ ██┌────┘ ██┌──██│
  11.                  ██┐  ██┌┘ ██│  ██│    ██│    █████┐   ███████│
  12.                   ██┐██┌┘  ██│  ██│    ██│    ██┌──┘   █┌─██┌┘
  13.                    ███┌┘   ███████│    ██│    ███████┐ ██│ ███┐
  14.                    └──┘    └──────┘    └─┘    └──────┘ └─┘ └──┘
  15.  
  16.                 ███████┐ ██┐     ██┐  ██┐ ███████┐        ██┐
  17.                 ██┌──██│ ██│     ██│  ██│ ██┌────┘        ██│
  18.                 ███████│ ██│     ██│  ██│ ███████┐    ██████████┐
  19.                 ██┌────┘ ██│     ██│  ██│ └────██│     └──██┌───┘
  20.                 ██│      ██████┐ ███████│ ███████│        ██│
  21.                 └─┘      └─────┘ └──────┘ └──────┘        └─┘
  22.  
  23.            Premier Voting Door For Electronic Bulletin Board Systems
  24.  
  25.                           Written by: Keith N. Cochran 
  26.        Voter Plus Copyright 1992-94 Keith N. Cochran - All Rights Reserved.
  27.  
  28.                             ßeta Version: 1.99C
  29.  
  30.  
  31.  
  32. If an effort to get an updated version of Voter Plus released, I do not
  33. have the time needed to totally rewrite the documentation.
  34.  
  35. In the interim, this file, SETUP.DOC should explain what is involved in 
  36. setting up the door.
  37.  
  38.  
  39.         ------------------
  40.         Create a directory or subdirectory where you normally place doors. 
  41.         Extract  the  entire contents of VOTE199C.ZIP into  this  location.  
  42.         All  files  enclosed  in VOTE199C.ZIP must be located in  the  same 
  43.         location  with  VOTER.EXE  in order for  the  program  to  function 
  44.         properly. 
  45.  
  46.         ------------------
  47.         Voter Plus is not intended to be run as a PCBoard "SHELL" door, and 
  48.         while it may run successfully in SHELL mode on some systems,  it is 
  49.         recommended that it be run as a normal door. 
  50.  
  51.  
  52.         Install  a door called VOTE or whatever you decide to call it  into 
  53.         your   DOORS.LST  file  using  PCBSETUP.    Answer  the   following 
  54.         questions: 
  55.         
  56.                                          USER DOOR
  57.           Filename   Password  Sec Login SYS  SYS  Shell Path to DOOR Files
  58.           --------   --------  --- ----- ---  ---  ----- ------------------
  59.         #) VOTE                 30   N    N    N     N   (if appropriate)
  60.  
  61.         A password would usually NOT be required for your VOTE door.
  62.  
  63.         A USERS.SYS file is NOT needed and should not be created. 
  64.           
  65.         A DOOR.SYS file is NOT needed and should not be created.
  66.           
  67.  
  68.         If  you  are  using  BBS software other than  PCBoard,   check  the 
  69.         appropriate  documentation  for instructions on setting  up  doors. 
  70.  
  71.  
  72.         ------------------
  73.         The   purpose  of  this  section is to  explain  the  command  line  
  74.         calling  syntax  for Voter Plus.   Please refer to the manual  that 
  75.         accompanied  your  BBS software for a more complete  discussion  on 
  76.         door batch file installation.  If  you have named the door VOTE the 
  77.         following  examples  would be the contents of your door file  named 
  78.         VOTE  (NOTE:   do NOT place an extension such as .BAT on  the  VOTE 
  79.         file). 
  80.                               
  81.         Contents of sample VOTE file:
  82.         -----------------------------
  83.         @echo off
  84.         d:                                                                    
  85.         cd \pcbdoors\vote
  86.         VOTER.EXE  VOTER.CNF  C:\PCB <-| This is the node's home directory.
  87.         c:                               
  88.         cd \pcb  <-| Return to system directory.
  89.         board.bat  <-| Reload the BBS
  90.           
  91.  
  92.         Configuring VOTER.CNF
  93.         --------------------------
  94.         Enclosed with Voter Plus is a file called VOTER.CN$  This is a 
  95.         sample main configuration file for Voter Plus.  
  96.  
  97.  
  98. INTERRUPT                ;INTERRUPT or BIOS (Change to FOSSIL for /M compatibility)
  99. 0                        ;# of booths       ──┐
  100. 02/13/94                 ;date last created ──┤
  101. 18:23                    ;time last created ──┼──  Handled by the Door
  102. 12/02/92                 ;date last reset   ──┤
  103. 02:41                    ;time last reset   ──┘
  104. KEITH COCHRAN            ;sysop name
  105. 120                      ;level needed to access SysOp functions
  106. TRUE                     ;Are you RUNNING PCB14.5 or greater ?
  107. 10                       ;sec level needed to CREATE a booth
  108. 10                       ;sec level needed to VOTE on a booth
  109. 120                      ;sec level needed to DELETE a booth
  110. 120                      ;sec level needed to EDIT a booth
  111. 120                      ;sec level needed to specify an AUTO-RESET booth
  112. 120                      ;sec level needed to specify an AUTO-DELETE booth
  113. TRUE                     ;log entries to CALLERx file
  114. FALSE                    ;display verbose FILE handling messages
  115. FALSE                    ;force caller to VOTE on a booth before they may view it
  116. TRUE                     ;follow caller's EXPERT toggle when entering the door
  117.  
  118.  
  119. !!!! REMOVE ALL ;COMMENTS BEFORE USING !!!!
  120.  
  121. !!!! YOU MUST RENAME VOTER.CN$ TO VOTER.CNF BEFORE USING IT. !!!!
  122.         
  123. Only one VOTER.CNF file is required for all nodes.  
  124.         
  125.         
  126.         Detailed explanation:
  127.         --------------------------
  128.         
  129.         Line 1 - INTERRUPT is the fastest and the preferred choice.  If you 
  130.                  experience lock ups or other problems, try BIOS.  If you are
  131.                  using the /M version of PCBoard, this line should be FOSSIL
  132.  
  133.         Line 2 - This is where Voter Plus keeps track of how many booths are 
  134.                  currently defined.   This entry is maintained automatically  
  135.                  by  Voter  Plus when a new booth is created or when an  old  
  136.                  booth is deleted. 
  137.  
  138.         Line 3 - This line contains the date the most recent booth was created.
  139.  
  140.         Line 4 - This line contains the time the most recent booth was created.
  141.  
  142.         Line 5 - This line contains the date of the last RESET.
  143.  
  144.         Line 6 - This line contains the time of the last RESET.
  145.  
  146.         Line 7 - This should be the name you use when you log on to the BBS.  
  147.                  It  is  used to let Voter Plus recognize that you  are  the 
  148.                  SysOp so that global delete and edit functions can be used.  
  149.                  The SysOp may edit or delete ANY booth,  regardless of  who 
  150.                  created it or whether the door is registered or not. 
  151.  
  152.         Line 8 - This line should contain a numeric value equal to the
  153.                  minimum security level needed to access the SysOp Functions.
  154.                  Valid values range from 0 to 65536. 
  155.  
  156.         Line 9 - If you are running PCBoard 14.5 or greater then enter a TRUE
  157.                  in this line.  Otherwise enter a FALSE
  158.  
  159.         Line 10- This line should contain a numeric value  equal  to  the 
  160.                  minimum security level needed to CREATE a New Booth.  Valid 
  161.                  values range from 0 to 65536. 
  162.                  
  163.         Line 11- This line should contain a numeric value equal to  the 
  164.                  minimum  security level needed to VOTE On a Booth.    Valid 
  165.                  values range from 0 to 65536. 
  166.                   
  167.         Line 12- This line should contain a numeric value  equal  to  the 
  168.                  minimum security level needed to DELETE a New Booth.  Valid 
  169.                  values range from 0 to 65536. 
  170.                  
  171.         Line 13- This line should contain a numeric value equal to  the 
  172.                  minimum  security level needed to EDIT a Booth.    Valid 
  173.                  values range from 0 to 65536. 
  174.                   
  175.         Line 14- This line should contain a numeric value equal to  the 
  176.                  minimum  security level needed to specify that a new booth
  177.                  is to be AUTO-RESET every xxx days.  Valid values range 
  178.                  from 0 to 65536. 
  179.  
  180.         Line 15- This line should contain a numeric value equal to  the 
  181.                  minimum  security level needed to specify that a new booth
  182.                  is to be AUTO-DELETED after xxx days.  Valid values range 
  183.                  from 0 to 65536. 
  184.  
  185.         Line 16- If set to TRUE, an entry will be written to the CALLERx file 
  186.                  when a caller CREATES A BOOTH,  DELETES A BOOTH, VOTES ON A 
  187.                  BOOTH, EDITS A BOOTH or ADDS AN ANSWER to a booth. If set to
  188.                  FALSE, it will not make these entries.
  189.  
  190.                  I believe the current version of the CALLs program reads
  191.                  these entries for it's Door Stats report.
  192.                  
  193.         Line 17- Display verbose messages to the caller?  If TRUE, full info
  194.                  will be displayed to the caller.   If FALSE, info  displayed
  195.                  will be minimal. 
  196.  
  197.         Line 18- If set to TRUE, the caller will not be allowed to view the
  198.                  results of a booth, unless they have voted on it first. 
  199.                  Setting this to FALSE will allow them to view any and all
  200.                  booths.
  201.  
  202.         Line 19- Setting this to TRUE will cause to Door to "follow" the 
  203.                  caller's EXPERT status when they enter the door.  
  204.                  ie.  If the caller is in expert mode on the BBS and this
  205.                  line is set to TRUE, they will be in expert mode upon
  206.                  entering the door, and no menu will be displayed. Setting
  207.                  this to FALSE displays the menu, regardless and is probably
  208.                  perferred.
  209.  
  210.  
  211.         Other Files
  212.         --------------------------
  213.         The remainder of the door's file are maintained by the door and
  214.         do not require editing.
  215.  
  216.         Two optional files are WELCOME and CLOSE.
  217.  
  218.         They are standard display files that will be displayed when entering
  219.         and exiting the door, respectively.  A sample WELCOME file is included
  220.         in the Zipfile.  PCB sytle @x codes may be used.
  221.  
  222.  
  223.         Running Voter Plus In Stand-Alone Mode
  224.         -------------------------------------------
  225.         To  run  Voter Plus in stand-alone local mode,  type the  following 
  226.         from the DOS command line or via a batch file: 
  227.  
  228.         voter voter.cnf c:\pcb LOCAL 
  229.  
  230.         A valid PCBOARD.DAT file must reside in the directory pointed to by 
  231.         the  second parameter,  (c:\pcb above).   Also,  LOCAL must  be  in 
  232.         uppercase. 
  233.  
  234.  
  235.        Technical notes
  236.        --------------------
  237.        Voter  Plus has been designed to run primarily on  PCBoard  systems.  
  238.        It should  however,   operate  on  any  BBS  type  that  can produce 
  239.        PCBOARD.SYS,   PCBOARD.DAT  and USERS files,  either  directly,   or 
  240.        through the use of a door monitor or conversion program.  
  241.  
  242.        At  this time it has been successfully tested on PCB14.5a,  SpitFire 
  243.        3.4, and Prologon/ProDoor systems. 
  244.  
  245.        Carrier  is monitored by Voter Plus at all times.   Should a  caller 
  246.        drop  carrier while in Voter Plus they will be returned to the  BBS, 
  247.        which   will   detect  the  "no  carrier"    status   and   re-cycle 
  248.        appropriately. 
  249.  
  250.  
  251.         Caller log entries
  252.         -----------------------
  253.         Voter Plus makes pertinent entries into the caller log as follows:
  254.           
  255.         * VOTER PLUS - Deleted: BOOTHNAME 
  256.           - Caller Deleted The Listed Booth
  257.  
  258.         * VOTER PLUS - Created New Booth: BOOTHNAME 
  259.           - Caller Created The Listed Booth
  260.  
  261.         * VOTER PLUS - Added a New Answer to Booth: BOOTHNAME 
  262.           - Caller Added His Own Answer To Listed Booth
  263.  
  264.         * VOTER PLUS - Voted On Booth: BOOTHNAME 
  265.           - Caller Voted On The Listed Booth
  266.  
  267.         * VOTER PLUS - Deleted: BOOTHNAME 
  268.           - Caller Deleted The Listed Booth
  269.  
  270.         * VOTER PLUS - Left a Comment On Booth: BOOTHNAME 
  271.           - Caller Entered A Comment Following Voting On The Listed Booth
  272.  
  273.         * VOTER PLUS - Changed Vote In Booth: BOOTHNAME 
  274.           - Caller Changed His Vote In The Listed Booth
  275.  
  276.         * VOTER PLUS - *ERROR - Unable To Open: FILENAME 
  277.           - Voter Plus Was Unable To Open The Listed File
  278.  
  279.  
  280.         Disclaimer and warranty
  281.         ----------------------------
  282.         Voter  Plus is a shareware product.  Voter Plus may be uploaded  to 
  283.         BBS  systems  as long as no files are added or removed to/from  the 
  284.         original archive and the program and it's associated  documentation 
  285.         is in no way modified. 
  286.  
  287.         There  are no warranties,  expressed or implied,  for  unregistered 
  288.         copies  of  Voter Plus.   Sysops who install Voter  Plus  on  their 
  289.         systems  assume  any  and all liabilities for  anything  which  may 
  290.         result  as  a consequence of running Voter Plus.  
  291.  
  292.         Under no circumstances shall I, KEITH N.  COCHRAN be liable for any 
  293.         loss of profit or any other damages,  including but not limited  to 
  294.         special,  incidental, consequential, or other damages,  arising out 
  295.         of the use or inability to use Voter Plus. 
  296.  
  297.  
  298.         Where to receive assistance
  299.         --------------------------------
  300.         If  you experience difficulty either installing or operating  Voter 
  301.         Plus, you may reach me in the following ways: 
  302.         
  303.         Salt Air BBS - DOORS Conference.
  304.  
  305.         FIDO - DoorWare Echo
  306.  
  307.  
  308.         Registering Voter Plus
  309.         ---------------------------
  310.         Registration  removes  the [UNREGISTERED] message upon opening  and 
  311.         closing the door,  allows creating up to 99 booths,  and allows the 
  312.         caller  to  use  the Edit & Delete  features.    
  313.  
  314.