home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / VVOTE616.ZIP / BCAVOTE.DOC < prev    next >
Text File  |  1994-02-16  |  9KB  |  204 lines
  1. FILE:   BCAVOTE.DOC
  2. Ref:    BCAVOTE.EXE and Archive (Known as VVOTE{###}.ZIP).
  3.  
  4.                                         !!!!!!!!!!!
  5.                                 BCAVOTE ! 6.16.02 !
  6.                                         !!!!!!!!!!!
  7.  
  8. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  9.  
  10. Disclaimer:
  11.         If it trashes your VBBS, I cannot be held responsible!  Use at your
  12.         own risk!  I have this program installed on my BBS and it works here.
  13.         If you need help, contact me VIA DirectMail, VirtualNET, or through 
  14.         at RushNET at the follow address(es) and I shall help as best I can.
  15.  
  16.       1 @ 1601004 VirtualNET
  17.       1 @ 160102  RushNET
  18.  
  19. Length of use.
  20.         You are granted a 30 day trial period.  If at the end of 30 days,
  21.         and you are still running the software, you or required to
  22.         register it.
  23.  
  24. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  25.  
  26. Suggestions or Comments:
  27.         PLEASE send these VIA the same routing as stated above.
  28.         Any and ALL suggestions and comments are WELCOMED and NEEDED!!!
  29.  
  30. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  31.  
  32. Main:
  33.  
  34.         NOTICE:  You will have to copy all the files over to their proper
  35.         directories.
  36.  
  37.         You can modify the BCAVOTE.MNU, BCAVOTE.RIP, BCAVHELP.MNU, and
  38.         BCAVOTE.SYS files as needed for your VBBS!  I'm not one of those
  39.         people that say, "It's either my way or nothing," so included
  40.         these files as external menus so they can be changed to match
  41.         YOUR VBBS!
  42.  
  43.         QUESTION LIMITS:
  44.                 IF BCAVOTE is not REGISTERED then you will be limited
  45.                 to a max. of 10 questions.  BCAVOTE no longer check to 
  46.                 see if VBBS is registered.  This is for those SysOps
  47.                 that are running VBBS OS/2, so they can try the program 
  48.                 also.
  49.  
  50.                 If you BCAVOTE is registered then the limit is 999
  51.                 questions, but this is definable in the configuration
  52.                 file.  Also, you will be able to change the limit on
  53.                 how many questions the users can enter.
  54.  
  55.         User Questions:
  56.                 Your Users CAN enter questions!  There is a limit of 1
  57.                 question PER USER.  Also, Users can delete their questions.
  58.                 NOTE:  In unregistered versions you cannot change this limit!
  59.                         This is a registered option ONLY.
  60.  
  61.         SysOp Access:
  62.                 If you are NOT user #1, the you will need to add your
  63.                 user number in BCAVOTE.SYS (SEE:  BCAVOTE.SYS INFO).
  64.                 BCAVOTE SysOps can be ANY USER.  BCAVOTE SysOps can
  65.                 delete any question and have (virtually) unlimited
  66.                 question entering capability.
  67.  
  68. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  69.  
  70. BCAVOTE.CFG
  71.       You MUST have this file or your program will terminate in error;
  72.       possibly causing a crash on the node that tried to access it!
  73.       it's format is as follows:
  74.  
  75. ---- Start File (Do NOT include this line!)
  76. ### {Number of Questions allowed in Booth, up to 999}
  77. ### {Number of Questions each user can own}
  78. $$$ {This line if for the FORCEVOTE operative...  See FORCEVOTE below.}
  79. ---- End File (Do NOT include this line!)
  80.  
  81. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  82.  
  83. BCAVOTE.SYS INFO
  84.         This file is 1 line long, on this line you will list the user(s)
  85.         that you wish to have SysOp access in BCAVOTE.  The User numbers
  86.         must begin and end with a backslash.  You must have atleast one
  87.         backslash before and after each number.
  88.                 Working Examples:
  89.                         /2/
  90.                         /2/45/91/
  91.                         /2//45//91//5/
  92.  
  93.         This line is read into BCAVOTE as string data and is then accessed
  94.         with the INSTR command to see if the user's number exists.
  95.  
  96. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  97.  
  98. AutoMatic UNVOTED QUESTIONS
  99.         To link into VBBS with the AUTO-UNVOTED QUESTIONS option
  100.         You use the same command as you would in a script or FB:
  101.        *SCRIPT (This needs to be the LAST command in your Script!)
  102.         -----
  103.         returnscript "{Next Script}"
  104.           {or}
  105.         returnfb "{Function Block to Exit to}"
  106.         door "BCAVOTE.EXE %1 CHECKNEW"
  107.         -----
  108.        *Function Block (Be sure to turn OFF Checking For new Questions
  109.                 in your VCONFIG!)
  110.         -----
  111.         {command key} {access level} 4 BCAVOTE.EXE %1 CHECKNEW
  112.         -----
  113.  
  114. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  115.  
  116. FORCEVOTE configuration operative:
  117.        *This command should reside on the 3rd line of your configuration
  118.         file if you decide to use it.  FORCEVOTE forces users to vote on
  119.         all UNVOTED questions.  It works from both the menu command
  120.         <U>nvoted Questions and the command-line CHECKNEW option.
  121.       **NOTE:  You do not have to add a blank line for this command at
  122.         this time, BUT you MUST HAVE an <!EOF!> marker ({CONTROL-Z}) at
  123.         the end of your file!!! If your editor does not put an <!EOF!>
  124.         marker, then you are required to put a blank line there or use
  125.         some other word line NOFORCE on that line.
  126.  
  127.      ***Example of usage:
  128.  
  129. ---- Start File (Do NOT include this line!)
  130. 999
  131. 1
  132. FORCEVOTE
  133. ---- End File (Do NOT include this line!)
  134.  
  135. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  136.  
  137. NIGHTLY EVENT:
  138.  
  139.     The BCAVNITE.EXE program is NOT required, but it is highly recomended
  140.     that you try using it!  To start the program, simply type it's name
  141.     followed by the node number that it *IS* running on.
  142.  
  143.     Ex:         BCAVNITE %1
  144.         where the '%1' is replaced by VBBS by the node number.
  145.  
  146.     This program helps straighten up any errors that may occur in the
  147.     shortened maintenance routines in BCAVOTE.EXE and recreates the
  148.     result file(s).
  149.  
  150. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  151.  
  152. Program Related Files Included:
  153.  
  154.     FileName        Description                             VBBS Directory
  155.     ------------    ------------------------------------    -----------
  156.     BCAVOTE.EXE     Main Program File.                      MAIN
  157.     BCAVOTE.DOC     This .DOC File!                         *Any*
  158.     BCAVOTE.CFG     Configuration File (Required)           MAIN
  159.     BCAVOTE.MNU     BCAVOTE Menu Screen.                    TXT
  160.     BCAVOTE.RIP     BCAVOTE .RIP Menu.                      TXT
  161.     BCAVHELP.MNU    BCAVOTE Help File.                      TXT
  162.     BCAVNTRO.MNU    Example Welcome(INTRO) Screen           TXT
  163.     BCAVNTRO.RIP    Example Welcome(INTRO) Screen in RIP    TXT
  164.     BCAVINST.EXE    Easy Install Program (See README.NOW)   UnPack Directory
  165.     README.NOW      Informational File (Opt. included)      *Any*
  166.     WHATS.NEW       Revision History (New Addition!)        *Any*
  167.  
  168. Program Related File Created:
  169.  
  170.     FileName        Description                             VBBS Directory
  171.     ------------    ------------------------------------    -----------
  172.     BCAVANSR.???    Storage Of Users Answers Per Question   DATA
  173.                         See: Vote Response (in Type Table)
  174.     BCAVOTE.NEW     Stores Data *IF* New Question is        DATA
  175.                         Entered
  176.     BCAVOTE.QTN     Storage Of VoteQuestions                DATA
  177.     BCAVUSER.DAT    Storage of VoteUserStats                DATA
  178.     BCAR???.RND     Quick Result File For Instant Results   DATA
  179.     BCAR???.MNU     Result File Created For Questions       TXT
  180.     BCAV???.MNU     Answer Menu Created For Questions       TXT
  181.     
  182. Additional Files (Optional):
  183.  
  184.     FileName        Description                             VBBS Directory
  185.     ------------    ------------------------------------    -----------
  186.     BCAVOTE.SYS     List Of ALL Users To Have SYSOP Access  DATA
  187.  
  188.  
  189. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  190.  
  191. MULTI-LINE BBSes:
  192.         This program should work!  If you find an error, PLEASE let me
  193.         know as soon as you can so I can fix it!
  194.  
  195.         Although, users may experience a rather long wait if someone
  196.         is voting on new questions.  The program locks the files so
  197.         new questions cannot be added, and old questions cannot be deleted.
  198.         There is a file that can be checked for prior to entering into
  199.         BCAVOTE called FILELOCK.BCA...  You *could* use this file to check
  200.         and see if the files are locked.
  201.  
  202. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  203. @END@
  204.