home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / vrac / pbv_200.zip / PBBSVOTE.DOC < prev    next >
Text File  |  1994-08-01  |  15KB  |  349 lines
  1.  
  2.            PBBSVote Version 2.00 (C) 1993, 1994 by Bing Wu & IMC
  3.                         Released on August 1, 1994
  4. ┌─────────────────────────────────────────────────────────────────────────────┐
  5. │▓▓▓▓▓ Introduction ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  6. └─────────────────────────────────────────────────────────────────────────────┘
  7.  
  8.   This is PBBSVote Version 2.00. This program basically has the same function
  9.   as Most of other Voting doors. :-) But this one is easy to setup. It's
  10.   DesqView aware, Multiline operational, and many more features than other ones.
  11.  
  12.   To run this program online on your BBS, you need to run either one
  13.   of the following BBS systems or one of the compatible systems.
  14.  
  15.            ■ RemoteAccess 1.xx & 2.xx
  16.            ■ WildCat                         ■ QuickBBS
  17.            ■ ProBoard                        ■ SpitFire
  18.            ■ RBBS─PC                         ■ Telegard
  19.            ■ WWIV
  20.            ■ Any Software supports either one of above system's exit file
  21.              OR can create custom drop file.
  22.  
  23. ┌─────────────────────────────────────────────────────────────────────────────┐
  24. │▓▓▓▓▓ Features ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  25. └─────────────────────────────────────────────────────────────────────────────┘
  26.  
  27.   ■ Multi-Line / Major multi-taskers supported
  28.   ■ Multi Voting database Files supported (+)
  29.        > Multiple logon screens
  30.        > Multiple database files
  31.   ■ Internal carrier detector
  32.   ■ User access options - Sysop command Line options
  33.        > Should User allow to add question (global)
  34.        > Should User allow to delete question (global)
  35.        > Should user allow to add answer (global)
  36.   ■ Program configuration - Sysop editable configuration file
  37.   ■ Full detail Log File
  38.   ■ Co-sysop with sysop access (+)
  39.   ■ Support upto 200 questions with 15 answers each
  40.   ■ Full Screen External Voting Booth Editor
  41.   ■ Great Graphics
  42.   ■ Define a question to be Mandatory <Sysop Only>
  43.   ■ Non-Fossil BBS Supported
  44.   ■ Optional Customized Main Menu (+)
  45.  
  46.  (+) Registered Only Features
  47. ┌─────────────────────────────────────────────────────────────────────────────┐
  48. │▓▓▓▓▓ Licensing Information ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  49. └─────────────────────────────────────────────────────────────────────────────┘
  50. PBBSVote refers to all executables and text files contained in the PBBSVote
  51. archives released by Bing Wu (author) of Panda BBS! and International Meridian
  52. Company of Minneapolis, MN (IMC).
  53.  
  54. 1. PBBSVote is the copyrighted material of Bing Wu and IMC. It may only be
  55. used in accordance with the Licensing Conditions.
  56.  
  57. 2. You may use PBBSVote for period of three weeks on a trial basis in order to
  58. determine its suitability for your system. After this period, you MUST register
  59. each PBBSVote you run concurrently on same/different computers under same/
  60. different BBS Names. Multi─Line BBS sharing same system files ONLY needed to
  61. register one copy.
  62.  
  63. 3. Commercial Sites (School, business, organization, or any site that conduct
  64. commercial activities) must register this program first before it can be used.
  65.  
  66. 4. Registration entitles you to use PBBSVote and any future versions of it
  67. without any future registration.
  68.  
  69. 5. The Products are provided AS IS. Neither the author nor any BBS operator
  70. distributing this software is responsible for any damage incurred during the
  71. operation of the program.
  72.  
  73. 6. The Author (Bing Wu) and/or IMC can discontinue support and development
  74. of PBBSVote without notice and at anytime.
  75.  
  76. 7. You may not modify or otherwise reverse─engineer PBBSVote.
  77.  
  78. 8. You may not use PBBSVote in any unlawful and/or illegal manner.
  79.  
  80. 9. You are welcome to distribute PBBSVote as long as you don't charge more than
  81. $5 for it, modify the program in anyway, or delete and/or files from the
  82. original distribution archives. Distrbuting on CD-ROMs is welcome.
  83.  
  84. 10. A Registered Version of PBBSVote MAY/MUST not be distributed with or without
  85. Author and/or IMC's Permission.
  86.  
  87. ┌─────────────────────────────────────────────────────────────────────────────┐
  88. │▓▓ Registration & Support ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  89. └─────────────────────────────────────────────────────────────────────────────┘
  90.  
  91. -=[ Registration ]=-
  92.  
  93. This program is distributed as shareware. You are grant 21 days (three weeks)
  94. trail period, after that you must either send in $10.00 registration fee or
  95. discontinue use it. Also Commercial sites MUST register this program first
  96. before it can be used. Otherwise legal action may be brought against you since
  97. this program is CopyRighted. However, SISNet (Staying In Scouting Network)
  98. System operators can freely use this program without registration while with
  99. SISNet (a registration key will be sent to all SISNet operators freely
  100. upon request).
  101.  
  102. The $10 registration fee grant you to use to all future versions of this
  103. program without additional registration fee. Your registration will be either
  104. send to you via crash netmail or conventional mail at no extra charge within
  105. CANADA and USA. $5 charge applies for order outside USA and CANADA. See
  106. REGISTRA.REG for more registration information.
  107.  
  108. -=[ Support ]=-
  109.  
  110. Echo Areas:
  111. FidoNet: RA_UTIL, SYSOP, WILDCAT, PROBOARD, PCBOARD
  112. SISNet: SIS_COMPUTER, SIS_SYSOP
  113. Official Echo: PS_SUPPORT
  114. (Available/Requestable on all Panda Software beta/support sites)
  115.  
  116. Support/Distribution Site:
  117. ■ When Sending request/help to following support sites, specify that how should
  118. the support site reply your message. (ROUTE/HOLD)
  119.  
  120. Bing Wu @ Panda BBS!                   Mike Mcgrane
  121. Data: 1-612-378-7783 (28,800VFC)       1-612-537-0449 (14,400)
  122. Voice/FAX: 1-612-378-0885              FidoNet: 1:282/1024
  123. SISNet: 74:74/0
  124. FidoNet: 1:282/1016
  125. InterNet: wuxx0037@gold.tc.umn.edu
  126.  
  127. Distribution/Beta sites:
  128.  
  129. ■ Freq or DL the latest version of PBBSVote with magic name PBV from any of
  130. the following sites:
  131.  
  132. Curtiss Denson
  133. 1-915-821-0661 (14,400)
  134. FidoNet: 1:381/84
  135. RANet: 72:318/0
  136.  
  137. Todd A. Lyon
  138. 1-318-582-3150 (14,400)
  139. FidoNet: 1:3807/104
  140.  
  141. ┌─────────────────────────────────────────────────────────────────────────────┐
  142. │▓▓▓▓▓ Files In The Package ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  143. └─────────────────────────────────────────────────────────────────────────────┘
  144. PBBSVote.EXE  The main program
  145. PBBSVREN.EXE  The Maintenance Utility program for PBBSVote
  146. PBVEdit .EXE  External Full Screen Questionnaire Editor
  147. PBBSVote.A??  Screen to display to your user when they load the program (3)
  148. PBBSVote.CFG  Configuration file for this program (NOT REQUIRED)
  149. PBBSVote.DOC  This file
  150. BETATEST.APP  Application form for join Panda Software beta test team
  151. REGISTRA.REG  Regsitration Form
  152. PBBSDOOR.???  An utility for systems using DOOR.SYS drop file (2 - EXE and DOC)
  153.  
  154. ┌─────────────────────────────────────────────────────────────────────────────┐
  155. │▓▓▓▓▓ Upgrade ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  156. └─────────────────────────────────────────────────────────────────────────────┘
  157.  If you are currently running PBBSVote v1.xx, you can upgrade to the new
  158.  version by simply replace all the executables. You will need to delete the
  159.  old configuration file and reedit the new one if you are using the *.CFG file.
  160.  
  161.  The database file (PBBSVOTE.BBS or ????????.BBS) can be converted to the new
  162.  format using the enclosed program *UPDATE.EXE*. Run this program without
  163.  command line parameter will cause the program to use the default filename of
  164.  PBBSVOTE.BBS, if you have any other PBBSVote format voting booth format data
  165.  file, simply run "UPDATE [FILENAME]", this will update the file you specified.
  166.  
  167. ┌─────────────────────────────────────────────────────────────────────────────┐
  168. │▓▓▓▓▓ Setup ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  169. └─────────────────────────────────────────────────────────────────────────────┘
  170. The setup is easy and simple, it takes about 5 minutes in average time to
  171. setup. The program can be run under ANY BBS software, such as RemoteAccess,
  172. WildCat, QuickBBS, etc.,
  173.  
  174. This program doesn't require a configuration file, but it will certainly take
  175. advantage of a configuration file. (SAMPLE INCLUDED) The configuration file is
  176. self explanatory. Use a text editor open up the configuration file and modify
  177. it as the way you wanted it to be.
  178.  
  179. You can run this program with or without a batch file, it all depends on how
  180. you wish to do it.
  181.  
  182. The program takes advantage of the environment variable, but it's not required
  183. to use the program.
  184.  
  185.             SET PBBSV=[PathName]
  186.  
  187. ┌─────────────────────────────────────────────────────────────────────────────┐
  188. │▓▓▓▓▓ Setup Examples ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  189. └─────────────────────────────────────────────────────────────────────────────┘
  190.  Following samples are assuming that you ARE using the environment parameter
  191.  PBBSV. (SET PBBSV=D:\RA\DOOR\VOTE)
  192.  
  193.  -= Running Multi-Lines =-
  194.  
  195.  (type 7) Door call: *C /CD:\RA\BATS\VOTE.BAT *N *M
  196.  
  197.  Batch file:
  198.  D:
  199.  CD \RA\LINE%1
  200.  D:\RA\DOOR\VOTE\PBBSVOTE /SRA\LINE%1 /NOANS /NOQUE /NODEL /C100
  201.  
  202.  -= Running Single Line =-
  203.  
  204.  (type 7) Door call: *C /CD:\RA\BATS\VOTE.BAT *N *M
  205.  
  206.  batch file:
  207.  D:
  208.  CD \RA\LINE1
  209.  D:\RA\DOOR\VOTE\PBBSVOTE /SRA\LINE1 /NOANS /NOQUE /NODEL /C100
  210.  
  211.  -= Running Multiple voting database =-
  212.  
  213.  FIRST:  (type 7) *C /CD:\RA\BATS\VOTE.BAT *N 1 *M
  214.  SECOND: (type 7) *C /CD:\RA\BATS\VOTE.BAT *N 2 *M
  215.  
  216.  batch file:
  217.  D:
  218.  CD \RA\LINE%1
  219.  
  220.  if %2 == 2 goto SECOND
  221.  goto FIRST
  222.  
  223.  :FIRST
  224.  D:\RA\DOOR\VOTE\PBBSVOTE /SRA\LINE%1 /NOANS /PALTER
  225.  EXIT
  226.  ;Using Voting database ALTER.BBS instead of default PBBSVOTE.BBS
  227.  
  228.  :SECOND
  229.  D:\RA\DOOR\VOTE\PBBSVOTE /SRA\LINE%1 /NOANS /PCHOICE
  230.  ;Using Voting database CHOICE.BBS instead of default PBBSVOTE.BBS
  231.  
  232. ┌─────────────────────────────────────────────────────────────────────────────┐
  233. │▓▓▓▓▓ Registered Feature ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  234. └─────────────────────────────────────────────────────────────────────────────┘
  235.  Once your PBBSVote is registered, you can customize the main screen of PBBSVote
  236.  by create file(s) called PBVMENU.(ANS/ASC/AVT/RIP). and place them in the
  237.  same directory as rest of PBBSVote files.
  238.  
  239.  Once Registered, PBBSVRen recognizes two parameters instead of one, register
  240.  and find out which one.
  241.  
  242.  Once Registered, PBVEdit allows to edit PBBSVote format files other than
  243.  PBBSVOTE.QST
  244.  
  245. ┌─────────────────────────────────────────────────────────────────────────────┐
  246. │▓▓▓▓▓ PBVEdit - Full Screen Question Editor ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  247. └─────────────────────────────────────────────────────────────────────────────┘
  248.  PBVEdit is the full screen voting booth editor for PBBSVote. When you start
  249.  the program it will scan through the directory for any PBBSVote format file
  250.  if PBBSVote is registered, otherwise PBBSVOTE.QST will be used.
  251.  
  252.  Using PBVEdit, you can modify the answers, the questions, should the user
  253.  allow to add answer, is this question mandatory, and even the name of
  254.  the person created the question. But as always, you will not be able to
  255.  modify the # of votes each answer received.
  256.  
  257. ┌─────────────────────────────────────────────────────────────────────────────┐
  258. │▓▓▓▓▓ PBBSVRen - The Maintenance Utility Program ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  259. └─────────────────────────────────────────────────────────────────────────────┘
  260.  PBBSVRen is the program which *ACTUALLY* deletes those records marked as
  261.  as "deleted". And It also able to *RESET* the voting door database file by
  262.  reset all Questions' voting counters to 0;
  263.  
  264.  Parameters:
  265.  
  266.    RESET     -  Reset the Voting Booth Counter
  267.     PACK     -  Pack the Voting Booth
  268.  
  269. ┌─────────────────────────────────────────────────────────────────────────────┐
  270. │▓▓▓▓▓ Command Line Parameters ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  271. └─────────────────────────────────────────────────────────────────────────────┘
  272.  
  273.  /S[PathName]     - Points to the directory where the door drop file is
  274.                     created (i.e. /SC:\RA\LINE1)
  275.  
  276.  /D[PathName]     - Where PBBSVote.EXE and its files are located. Overwrites
  277.                     the PBBSV environment parameter if set. (i.e. /DC:\RA\VOTE)
  278.  
  279.  /P[FileName]     - Specify the file name (NO PATH) of the voting database file
  280.                     to be used. If no file specified or this option is not used,
  281.                     the default file "PBBSVOTE.BBS" is used. (+)
  282.  
  283.  /NOANS           - This parameter disables the user to add a new answer to
  284.                     a voting question
  285.  
  286.  /LOCAL           - Run The Program in local mode
  287.  
  288.  /NOQUE           - Disallow the user to add a new question to the voting Dbase
  289.  
  290.  /DEL             - Allow the user to delete a question from the Dbase
  291.  
  292.  /NOHANG          - Disallow the user to logoff within PBBSVote
  293.  
  294.  /NOPAGE          - Disable the paging feature of the program. Overrides all
  295.                     configuration settings.
  296.  
  297.  /C[n]            - Specified the security level of your co-sysop, if you wish
  298.                     to have your co-sysop to overwrite any commandline
  299.                     parameter. (i.e. /C100) (+)
  300.  
  301.   --- End ---
  302.  
  303.  NOTE: parameters /NOANS, /NOQUE, /NODEL will be ignored if and only if the
  304.        user is the sysop or a user whose security level match the one defined
  305.        with parameter /C.
  306.  
  307. ┌─────────────────────────────────────────────────────────────────────────────┐
  308. │▓▓▓▓▓ ErrorLevels ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  309. └─────────────────────────────────────────────────────────────────────────────┘
  310.             PBBSVote will exit with one of the following errorlevels:
  311.                         0 - Critical Door error (no fossil, etc.)
  312.                         1 - Carrier lost, user off-line
  313.                         2 - Sysop terminated call, user off-line
  314.                         3 - User time used up, user STILL ON-LINE
  315.                         4 - Keyboard inactivity timeout, user off-line
  316.                         5 - Sysop dropped user back to BBS, user ON-LINE
  317.                        10 - User chose to return to BBS
  318.                        11 - User chose to logoff, user off-line
  319.                        12 - Critical PBBSVote error
  320.  
  321. ┌─────────────────────────────────────────────────────────────────────────────┐
  322. │▓▓▓▓▓ Contact IMC and the Author ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│
  323. └─────────────────────────────────────────────────────────────────────────────┘
  324. Snail Mail:
  325.   Bing Wu
  326.   International Meridian Co.
  327.   604 Ontario Street SE
  328.   Minneapolis, MN 55414-3118
  329.  
  330. Voice:
  331.   (612)378-0885
  332.  
  333. Echo Mails:
  334.   PS_SUPPORT - Official Panda Software Echo, available on all beta/support sites
  335.   RA_UTIL, SYSOP, WILDCAT - FidoNet backbone echo
  336.  
  337. BBS:
  338.   Panda BBS! @ (612)378-7783
  339.  
  340. NetMail:
  341.   wuxx0037@gold.tc.umn.edu  of InterNet
  342.   bing wu@1:282/1016        of FidoNet
  343.   bing wu@74:74/0           of SISNet
  344.  
  345. ---
  346. EOF PBBSVOTE.DOC
  347. This program is based on Brian Pirier's EZVote. and Compiled with OD5.00ß10 and
  348. Borland C++ V3.1.
  349.