home *** CD-ROM | disk | FTP | other *** search
/ Piper's Pit BBS/FTP: ibm 0210 - 0219 / ibm0210-0219 / ibm0213.tar / ibm0213 / ANSR.ZIP / ANSR.DOC < prev    next >
Encoding:
Text File  |  1994-07-02  |  12.4 KB  |  313 lines
  1.  *************************************************************************
  2.  *                             ANSR.PPE                                  *
  3.  *                   A PCBoard 15 Sysop Utility PPE                      *
  4.  *                   version: 1.0    date: 7/2/1994                      *
  5.  *                   (c) Copyright 1994  A. Segura                       *
  6.  *************************************************************************
  7.  
  8.  
  9. Purpose:   To allow asking the user a question, generally requiring a
  10.            YES or NO response, and respond in user upgrade or downgrade
  11.            in response. ANSR.PPE is an expanded version of similar PPE's
  12.            that display a disclaimer to a user, then ask for a response.
  13.  
  14.  
  15.  
  16. Features:       1. Extremely user (SysOp) configurable! (See CFG file
  17.                    description--many, MANY options!).
  18.                 2. Performs error and self-integrity checks!
  19.                 3. Sends message to SysOp for negative responses!
  20.                 4. Allows security, language and graphics extension
  21.                    text display files!
  22.                 5. All display files are SysOp editable!
  23.                 6. Can be placed in ANY directory!
  24.                 7. Allows any language YES or NO response.
  25.                 8. Allows option of hanging-up on users.
  26.  
  27.  
  28.                 And on, and on, and on........
  29.  
  30.  
  31. Additional
  32. Requirements:   1. PCBoard version 15.x.
  33.  
  34.  
  35. Zip File
  36. Contents:       1. ANSR.PPE      The subject PPE file.
  37.                 2. ANSR.CFG      a sample PPE configuration file
  38.                 3. ANSR.DOC      this file.
  39.                 4. FILE_ID.DIZ   a brief BBS text description of this item.
  40.                 5. ASKF          a sample 'disclaimer/question' file
  41.                 6. BADF          a sample negative response text file
  42.                 7. GUDF          a sample affirmative response text file
  43.  
  44.  
  45.  
  46. Installation
  47. Usage:          A. Determine the directory in which you desire to place
  48.                    the PPE and its support files.  They may be placed in
  49.                    any directory as long as all the files go there.
  50.  
  51.                 B. Next, install the PPE wherever you desire, such as the
  52.                    NEWUSER text display file location or any other prompt-
  53.                    ing location.
  54.  
  55.  
  56.  
  57. CFG File Function:      The ANSR.CFG file provides the SysOp with the
  58.                         capability to customize and select options for
  59.                         ANSR.PPE to perform.  Below is a sample of
  60.                         the configuration file and the entry descriptions:
  61.  
  62. ---------------------------------------------------------------------------
  63. C:\PCB\PPE\ASKF
  64. C:\PCB\PPE\BADF
  65. C:\PCB\PPE\GUDF
  66. @X0FAnswer @X0EY@X0F for YES, @X0CAnswer @X0DN@X0C for NO.
  67. 1
  68. 0
  69.  
  70. 10
  71. 30
  72. 1
  73. 1
  74. 1
  75. 1
  76. 0
  77. 0
  78. UNREGISTERED
  79. --------------------------------------------------------------------------
  80.  
  81. Line 1:  Path/filename of Ask/Disclaimer Display File (sec/graph/lang options)
  82.  
  83.          Edit this file however you desire, but, it must be present for
  84.          the PPE to execute or it will terminate.
  85.  
  86.  
  87. Line 2:  Path/filename of "NO" Reply Display File (sec/graph/lang options)
  88.  
  89.           Text display file/path to show to negative responses.
  90.           (just leave blank for no-display) Edit this file however you
  91.           desire, or just delete it if you don't want another display and
  92.           leave the CFG file line blank--the must exist though, just blank.
  93.  
  94.  
  95. Line 3:  Path/filename of "YES" Reply Display File (sec/graph/lang options)
  96.  
  97.           Text display file/path to show to affirmative responses.
  98.           (just leave blank for no-display) Same as 'NO' file above.
  99.  
  100.  
  101. Line 4:  Display Prompt to show to user
  102.  
  103.         The questioning prompt to display to the user to get an answer.
  104.  
  105.  
  106. Line 5:  Flag for Y/N style of reply (1 to enable, 0 to disable)(most secure)
  107.  
  108.         Flag to indicate to use the Yes or No response option.  This is the
  109.         recommended option as it is the most secure and only allows a Y, N,
  110.         y, or n response (and in any language). (see line 7 if you set 0)
  111.  
  112.  
  113. Line 6:  Reverse affirmative reply (0=yes affirm, 1=no affirm)
  114.  
  115.         Indicates what is the affirmative desired response (Yes or No).
  116.         Ususally the affirmative response is YES, but in some cases you
  117.         might want NO to indicate a proper response.
  118.  
  119. Line 7:  Required Reply String for non-Y/N responses (just leave blank if
  120.            line 5 is set (1)  (least secure).
  121.  
  122.         This is an option for allowing some other response string other
  123.         than yes or no.  It should be any desired string.  Note: Line 5
  124.         overrides this selection, so, if you want to use this string option,
  125.         line 5 must be set to 0.  This option is less secure than Y/N.
  126.  
  127.  
  128. Line 8:  Security Level to downgrade user to for "negative" reply
  129.  
  130.          Line 10 must be set for this to activate.
  131.  
  132.  
  133. Line 9:  Security Level to upgrade user to for "affirmative" reply
  134.  
  135.          Line 11 must be set for this to activate.
  136.  
  137.  
  138. Line 10: Flag to enable Security Downgrade (1=enable, 0=disable)
  139.  
  140.          Flag to indicate whether you want to do a security downgrade for
  141.          negative responses.
  142.  
  143.  
  144. Line 11: Flag to enable Security Upgrade (1=enable, 0=disable)
  145.  
  146.          Flag to indicate whether you want to do a security upgrade for
  147.          affirmative responses.
  148.  
  149.  
  150. Line 12: Flag to generate affirm. reply log (1=enable, 0=disable)
  151.  
  152.          Generates a log containing user name, date/time.  Log is
  153.          in PPEs directory and named YES.LOG.
  154.  
  155.  
  156. Line 13: Flag to generate neg. reply log (1=enable, 0=disable)
  157.  
  158.          Generates a log containing user name, date/time.  Log is
  159.          in PPEs directory and named NO.LOG.
  160.  
  161.  
  162. Line 14: Flag to hangup on negative reply users (1=enable, 0=disable)
  163.  
  164.  
  165. Line 15: Flag to hangup on <Enter> key reply users (1=enable, 0=disable)
  166.  
  167.  
  168. Line 16: Registration key
  169.  
  170.          When you register, you will receive the key to replace the
  171.          UNREGISTER message with a REGISTERED message.
  172.  
  173.  
  174.  
  175.  
  176. PPE Execution:   The PPE is executed by calling it along with its CFG file.
  177.                  This allows the PPE to be used in various areas with
  178.                  different configurations.  The call should be such as:
  179.                  !C:\PPE\ANSR.PPE C:\PPE\ANSR-1.CFG
  180.  
  181.  
  182.  
  183. ERROR Checking:  ANSR.PPE has built-in error checking/monitoring and will
  184.                  enter its error messages in the PCBoard CALLER log for
  185.                  SysOp debugging.
  186.  
  187.  
  188. Registration:   Registration fee is $5 US.  See below for mailing address.
  189.  
  190.  
  191. Updates:        The latest version of the PPE program can be obtained from
  192.                 my BBS: SBG Online! BBS (703) 450-9456.  If you have any
  193.                 comments or suggestions for improvement, you can leave them
  194.                 there also.  The file will be found in directory #1 as a
  195.                 FREE/NOTIME file.  The BBS runs PCBoard 15 at 28800 VFC.
  196.  
  197.  
  198. Source          If you desire a diskette containing the PPL source code so
  199. Code:           you can modify it for your own use, the cost is $15 US.  I
  200.                 accept cash, check or money order.  Mailing address is:
  201.  
  202.                 A. Segura, P.O. Box 1089, Sterling, VA, 20167-1089.
  203.  
  204.  
  205.                 EXTRA, EXTRA!! In addition to the ANSR source, you
  206.                 will also receive source to a "Last TEN Caller" and
  207.                 "Running Log Caller" bulletin generators that I have
  208.                 developed as well.
  209.  
  210.  
  211.                 As another option, for $25, you can subscribe to the PPE
  212.                 conference on my BBS.  The conference will always contain
  213.                 the latest version of the source code for ANSR, CALLBLOC,
  214.                 CALLERID, VULGARID and several other PPEs for immediate
  215.                 downloading.  The subscription period lasts one year.  We
  216.                 also have the latest version of the PIER Shareware CDROM
  217.                 always online.  You can even subscribe online with your
  218.                 VISA/MC via (S)cript Questionaire #2 for immediate access.
  219.  
  220.  
  221.  
  222. Distribution:   You may freely distribute this complete package only in an
  223.                 unmodified form.  No remuneration may be collected or charged
  224.                 for this work by anyone other than the below noticed
  225.                 individual/company except for that cost incurred in actual
  226.                 electronic media production (i.e. diskette or CDROM).  In
  227.                 other words, it can be placed on BBSs, shareware CDROMS, etc.
  228.                 but I/my company reserves the right of copyright and
  229.                 remuneration for the actual work.  The source code MAY NOT
  230.                 be distributed by anyone other than the below listed company.
  231.  
  232.  
  233. Disclaimer:     The user agrees when utilizing this package that he does so
  234.                 at his own risk with no guarantees, implied or otherwise, as
  235.                 to the functional performance or liability of the package.
  236.  
  237.  
  238. Development
  239. History:        ver.   date       remarks
  240.                 ----   --------   ---------------------------------------
  241.                 1.0    07/02/94   Initial release.
  242.  
  243.  
  244. ***************************************************************************
  245. *                   (c) Copyright 1994  A. Segura                         *
  246. ***************************************************************************
  247.  
  248.  
  249. Other PPEs/Programs:
  250.  
  251.  ********************************************************************
  252.  *      Look for these other fine utilities at a BBS near you       *
  253.  ********************************************************************
  254.  
  255.  AUTOSUBS.PPE   run as a script questionnaire, allows online credit
  256.                 card subscriptions to BBS (VISA/MC), completes log
  257.                 entries and sends alert message to SysOp. (for
  258.                 PCBoard 15)
  259.  
  260.  ALLCALL.PPE    generates a text display bulletin, complete with PCB
  261.                 color codes, of all the callers to the board.
  262.  
  263.  ALLSTAT.PPE    generates a text display bulletin, complete with PCB
  264.                 color codes, of statistics of all the callers to the board.
  265.  
  266.  BULLCHK.PPE    performs automated tracking of bulletins read by the
  267.                 user and performs a user upgrade when all sysop selected
  268.                 bulletins have been read.
  269.  
  270.  CALLERID.PPE   performs basic callerid identification, logs info
  271.                 in file log and user records if desired, and will
  272.                 also display desired text screens to users--must
  273.                 have callerid capable modem.  Several SysOp config-
  274.                 uable options. (for PCBoard 15)
  275.  
  276.  CALLBLOC.PPE   performs a call blocking function before the
  277.                 user can log on based upon a SysOp defined listing
  278.                 of undesirable phone numbers--must have callerid
  279.                 capable modem. Even sends the SysOp an alert message.
  280.                 (for PCBoard 15)
  281.  
  282.  DUP-BLOC.PPE   Blocks current users from signing-on with duplicate
  283.                 records--uses CallerID info.  Should be used with
  284.                 CALLBLOC.PPE for complete blocking system.
  285.  
  286.  MAKEBLTN.EXE   Top callers, cities, down/uploaders bulletin generator
  287.  
  288.  PADLOADS.EXE   Automated uploads directory padder--makes your BBS look
  289.                 more active with more daily uploads.
  290.  
  291.  REPORT.EXE     Program generates reports of CallerID info, user record
  292.                 phone numbers, common passwords and several other goodies
  293.                 to aid Sysop in identifying abusive or questionable users.
  294.  
  295.  VULGAR.PPE     performs a vulgar word/phrase check on user names and
  296.                 city entries based on a file of names defined by
  297.                 SysOp, and performed before complete newuser login.
  298.                 (for PCBoard 15)
  299.  
  300.  VULGARID.PPE   same program as VULGAR.PPE except it automatically
  301.                 passes the callerid info to CALLBLOC.PPE program
  302.                 for future lock-outs. (must have both programs and a
  303.                 modem that supports callerid) (for PCBoard 15)
  304.  
  305.                 NOTE: VULGARID ver. 1.x only works with CALLBLOC
  306.                       ver. 1.x.  VULGARID ver. 2.x only works
  307.                       with CALLBLOC ver. 2.x.
  308.  
  309. ***************************************************************************
  310. *         (c) Copyright 1994  by A. Segura   ALL RIGHTS RESERVED          *
  311. ***************************************************************************
  312.  
  313.