home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR2 / BULLCHK3.ZIP / BULLCHK.DOC < prev    next >
Text File  |  1994-01-07  |  8KB  |  162 lines
  1.  *************************************************************************
  2.  *                            BULLCHK.PPE                                *
  3.  *                   A PCBoard 15 Sysop Utility PPE                      *
  4.  *                   version: 1.3   date: 01/05/1994                     *
  5.  *        (c) Copyright 1994  A. Segura/Fax~An~Ad Marketing, Inc.        *
  6.  *************************************************************************
  7.  
  8. PURPOSE
  9. The purpose of this PPE is to allow automatic monitoring of bulletins
  10. read by users and to perform an automatic upgrade fo the user when the
  11. monitored bulletins have all been read.  (I.E.  such as monitoring for
  12. when a new user has read all the system rules and disclaimer bulletins).
  13.  
  14.  
  15. USAGE
  16. The Bulletin Read Checker (BULLCHK) PPE program is executed by placing
  17. a call to the program, along with bulletin sequence #, on the last line of a
  18. bulletin desired for monitoring.  For example, say you wanted your
  19. 'Bulletin #1--Board Rules' to be the first monitored bulletin--on the
  20. last line of the bulletin, first column, enter:  !C:\PCB\PPE\BULLCHK.PPE 1
  21. Don't forget the ! symbol, it tells PCBoard to execute the PPE--also
  22. include the path--and don't forget the last entry of the bulletin sequence
  23. number.  This number would be changed to 2 in the second monitored
  24. bulletin--and to 3 in the third monitored bulletin, etc.  Also, MKPCBTXT.EXE
  25. must be utilized to clear Record #2 question prompt (What CPU are you using)
  26. so as to deactivate User Comment field #1 from the user.
  27.  
  28.  
  29. I have included three PPE files in this package:
  30.  
  31.         a. BULLCHK.PPE -     which monitors for 3 bulletins
  32.                              and includes a sysop config file.
  33.  
  34.         b. BULLCHK5.PPE -    which monitors for 5 bulletins
  35.                              and includes a sysop config file.
  36.  
  37.         C. BULLCHKF.PPE   -  which monitors for 3 bulletins but has
  38.                              no config read file to promote faster
  39.                              operation.  The three config values programmed
  40.                              into this version are : new_level=15,
  41.                              trip_level=10, extra-days=0.
  42.  
  43.  
  44. The configuration file (BULLCHK.CFG) contains 3 line entry values which can
  45. be modified by the sysop per his/her needs (see sample file).  The first entry
  46. is a number value representing how many extra days to add to the user's account
  47. upon reading all the monitored bulletins (ie: 0 or 10 or 30 or 60, etc). The
  48. second entry is an integer value representing the trip level to stop the
  49. bulletin upgrade monitoring process, therefore, it should be at least one
  50. level below the new upgrade level (i.e. 10).  The third entry is an integer
  51. value representing the new upgrade level once all monitored bulletins are
  52. read (i.e 15).
  53.  
  54. The PPE stores the bulletin read information in user comment field #1 as
  55. follows:  bulletin #1 represented by 1, bulletin number 2 represented by 2,
  56. bulletin #3 represented by 4, therefore, when all three bulletins have been
  57. read by a user a 7 will be saved in the field.
  58.  
  59. File 'ALLBULL.TXT' is a sysop editable display file which is displayed
  60. to the user when he has read all monitored bulletins and is being
  61. automatically upgraded.  The file must be in same directory as PPE file. If
  62. file cannot be found the message 'Could not find ALL_Bulletin Read file
  63. (BULLCHK. PPE)!' will be written to the caller log.
  64.  
  65. If no number was entered in the bulletin after the PPE call, a message
  66. 'Did not detect a bulletin #' (BULLCHK.PPE)!' will be written to the
  67. caller log.
  68.  
  69. If for some reason you entered a bulletin callout number greater than 3
  70. (or 5 for the 5 # version) a message '.Bulletin # invalid (BULLCHK. PPE)!'
  71. will be written to the caller log.
  72.  
  73.  
  74. CONTENTS:
  75.    1.   BULLCHK.DOC  this file.
  76.    2.   BULLCHK.PPE  the subject PPE file (see description above).
  77.    3.   BULLCHK.CFG  the PPE config file.
  78.    4.   BULLCHK5.PPE (see description above).
  79.    5.   BULLCHKF.PPE (see description above).
  80.    6.   ALLBULL.TXT  text display message file
  81.    7.   FILE_ID.DIZ  a brief BBS text description of this item.
  82.  
  83.  
  84. UPDATES:
  85. The latest version of the PPE program can be obtained from my BBS:
  86. SBG Online! BBS (703) 450-9456.  If you have any comments or suggestions
  87. for improvement, you can leave them there also.  The file will be found
  88. in directory #1 as a FREE/NOTIME file.  The BBS runs PCBoard 15 at 14400v32bis.
  89.  
  90.  
  91. REGISTRATION:
  92. Registration cost is $5 US.  When registered, you can download a copy from
  93. my BBS that has the unregistered message removed (I will mail you a letter
  94. and receipt with a password for the BBS access--see order information below
  95. under SOURCE).
  96.  
  97.  
  98. SOURCE:
  99. If you desire a diskette containing the PPL source code so you can modify
  100. it for your own use, the cost is $15 US.  I accept cash, money order, VISA
  101. or Mastercard. You can place an order online on the BBS (703) 450-9456 or
  102. by mail at: A. Segura, P.O. Box 1089, Sterling, VA, 20167-1089.
  103.  
  104.  
  105. CUSTOMIZED CODE:
  106. If you might desire some changes to the code and a compiled version, leave
  107. me a message on my BBS or drop me a letter.
  108.  
  109.  
  110. Distribution:   You may freely distribute this complete package only in an
  111.                 unmodified form.  No remuneration may be collected or charged
  112.                 for this work by anyone other than the below noticed
  113.                 individual/company except for that cost incurred in actual
  114.                 electronic media production (i.e. diskette or CDROM).  In
  115.                 other words, it can be placed on BBSs, shareware CDROMS, etc.
  116.                 but I/my company reserves the right of copyright and
  117.                 remuneration for the actual work.  The source code may not
  118.                 be distributed by anyone other than the below listed company.
  119.  
  120.  
  121. Disclaimer:     The user agrees when utilizing this package that he does so
  122.                 at his own risk with no guarantees, implied or otherwise, as
  123.                 to the functional performance or liability of the package.
  124.  
  125. ***************************************************************************
  126. *        (c) Copyright 1994  A. Segura/Fax~An~Ad Marketing, Inc.          *
  127. ***************************************************************************
  128.  
  129.  
  130.  
  131.  ********************************************************************
  132.  *      Look for these other fine utilities at a BBS near you       *
  133.  ********************************************************************
  134.  
  135.  CALLERID.PPE   performs basic callerid identification, logs info
  136.                 in file log and user records if desired, and will
  137.                 also display desired text screens to users--must
  138.                 have callerid capable modem.  Several SysOp config-
  139.                 uable options. (for PCBoard 15)
  140.  
  141.  CALLBLOC.PPE   performs a call blocking function before the
  142.                 user can log on based upon a SysOp defined listing
  143.                 of undesirable phone numbers--must have callerid
  144.                 capable modem. Even sends the SysOp an alert message.
  145.                 (for PCBoard 15)
  146.  
  147.  SUBSCR.PPE     run as a script questionnaire, allows online credit
  148.                 card subscriptions to BBS (VISA/MC), completes log
  149.                 entries and sends alert message to SysOp. (for
  150.                 PCBoard 15)
  151.  
  152.  VULGAR.PPE     performs a vulgar word/phrase check on user names and
  153.                 city entries based on a file of names defined by
  154.                 SysOp, and performed before complete newuser login.
  155.                 (for PCBoard 15)
  156.  
  157.  VULGARID.PPE   same program as VULGAR.PPE except it automatically
  158.                 passes the callerid info to CALLBLOC.PPE program
  159.                 for future lock-outs. (must have both programs and a
  160.                 modem that supports callerid) (for PCBoard 15)
  161.  
  162.