home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / BBS_UTIL / VFY_34A.ZIP / 4-TRIBBS.ZIP / TRISEC.DOC < prev    next >
Text File  |  1993-12-19  |  6KB  |  155 lines
  1.         **************************************************************
  2.         *                                                            *
  3.         *                      TRISEC.EXE v1.4                       *
  4.         *                                                            *
  5.         *       TRIBBS User Security Level Adjustment Program        *
  6.         *                                                            *
  7.         *                    Copyright (c) 1993                      *
  8.         *                Sagerquist Micro Engineering                *
  9.         *                                                            *
  10.         *                   1414 W. Kerrick Street                   *
  11.         *                    Lancaster, Ca. 93534                    *
  12.         *                    Data  (805) 723-6908                    *
  13.         *                                                            *
  14.         **************************************************************
  15.  
  16. DESCRIPTION
  17. -----------
  18.     TRISEC.EXE adjusts a TRIBBS caller's security level in the TRIBBS
  19.     user database file USERS.DAT.  This action is useful when invoking
  20.     BBS Doors such as a Call Back Verification, a Questionnaire or
  21.     Opinion Poll, etc., where the caller is to be rewarded with a
  22.     security level adjustment upon successful completion.
  23.  
  24. SYNTAX
  25. ------
  26.     TRISEC [Directory where TRIBBS.SYS is located] [Security Level]
  27.  
  28.     TRISEC C:\TRIBBS 100
  29.  
  30. SAMPLE TRAP DOOR BATCH FILE
  31. ---------------------------
  32.     Note:   TRIBBS places the callers logged actions into the file 
  33.         CALLERS.LOG in the NWORK directory.  When the caller hangs
  34.         up, all the information is written (appended) to the file
  35.         CALLERS.LOG in the MWORK directory.  The CALLERS.LOG in
  36.         the MWORK directory is the permanent log.  If VERIFY!.EXE
  37.         is going to log its action in CALLERS.LOG, be sure to
  38.         specify the CALLERS.LOG file in the NWORK directory with
  39.         the /L: switch.
  40.  
  41. @ECHO OFF
  42. CLS
  43. ECHO ******* Entering VERIFY! *******>> C:\TRIBBS\NWORK\CALLERS.LOG
  44. C:
  45. CD C:\TRIBBS\VERIFY!
  46. VERIFY! /B:TRIBBS /D:C:\TRIBBS /L:C:\TRIBBS\NWORK\CALLERS.LOG
  47. rem  ERRORLEVEL 0 and 1 means caller is verified.  
  48. rem  ERRORLEVEL 0 == local call
  49. rem  ERRORLEVEL 1 == long distance
  50. IF ERRORLEVEL 0 IF NOT ERRORLEVEL 2 goto ADJUST
  51. goto END
  52. :ADJUST
  53. CD C:\TRIBBS\MWORK
  54. rem  Adjust caller's security level to 50
  55. TRISEC C:\TRIBBS 50
  56. :END
  57.  
  58. TECHNICAL
  59. ---------
  60.     TRISEC.EXE begins by reading the file TRIBBS.SYS, where it learns
  61.     the current caller's name and password.  Then, TRIBBS's database 
  62.     file USERS.DAT is searched for the matching name and password.  When
  63.     it finds the matching name and password, the security level part of
  64.     that record is changed to the number from the command line and 
  65.     written to the file.  TRIBBS.SYS and DOOR.SYS are both updated with
  66.     the security level defined on the command line.
  67.  
  68.     On exit of TRISEC, ERRORLEVELs are returned.  Your batch file can
  69.     check the ERRORLEVEL and determine what has happened.  The following
  70.     is a list of TRISEC's ERRORLEVELs and their meaning:
  71.  
  72.     ERRORLEVEL   0        Normal exit, adjustment successful.
  73.     ERRORLEVEL   1        Error exit, either a file cannot be found,
  74.                 the adjustment cannot be made, the user's
  75.                 name cannot be found, etc.  The actual
  76.                 reason for the error is written to the
  77.                 screen.
  78.  
  79.     Review your DOS manual for more information on ERRORLEVELs.
  80.  
  81.     For the purpose of verification, the program CHECK.EXE is included
  82.     with this program.  CHECK.EXE reads USERS.DAT and displays the names
  83.     and security levels of all the registered callers.  The names are
  84.     displayed in the same order as they are found in the database file.  
  85.  
  86. DISCLAIMER
  87. ----------
  88.     This program is distributed as is.  No warranty, either expressed or
  89.     implied is offered and the programmer is not responsible for any
  90.     damages or expenses that may occur through the use of this program.
  91.     The user shall determine its suitability.  Extensive testing has been
  92.     performed and every effort has been made to ensure satisfactory 
  93.     performance prior to release.  Please communicate any difficulties 
  94.     with the programmer through the BBS at (805) 723-6908.  Any problems
  95.     received will be treated as a top priority.
  96.  
  97. CREDITS
  98. -------
  99.     Thanks to James Mann of Littlerock, CA. for requesting this program,
  100.     and testing it online.
  101.  
  102.     Thanks to Robert Massman of Dallas TX. for his assistance and
  103.     testing of this program on his TRIBBS system.
  104.  
  105.     Thanks to Rick Bretz of Columbus, OH. for finding the error in
  106.     version 1.2.  The caller's alias was part of the check, and 
  107.     apparently the caller's alias is not always included in the file
  108.     TRIBBS.SYS.  Now, the caller's name and password is compared rather
  109.     than the caller's name and alias.
  110.  
  111.     Thanks to John Knopf of Collierville, TN. for his efforts with
  112.     TRIBBS v5.01 and TRISEC.EXE.
  113.  
  114.     TRIBBS is copyrighted software by Mark Goodwin, 366 14th St.,
  115.     Bangor, ME 04401
  116.  
  117. PROGRAMMING SERVICES
  118. ====================
  119.     TRISEC.EXE is a custom program, and performs exactly as requested.
  120.  
  121.     Programming services are provided by Sagerquist Micro Engineering
  122.     by request.  The point of contact is the S M E Support BBS at
  123.     (805) 723-6908, or via mail at the following address:
  124.  
  125.     Sagerquist Micro Engineering
  126.     1414 W. Kerrick St.
  127.     Lancaster, CA 93534
  128.     BBS (805) 723-6908
  129.  
  130.     If you have a need for a program of any kind, please let us know.
  131.  
  132. HISTORY
  133. -------
  134.     12/19/93 v1.4 - Added code to also alter DOOR.SYS to be compatable
  135.             with TRIBBS v5.01 and above.
  136.  
  137.     08/18/93 v1.3 - The checking of the caller's alias from TRIBBS.SYS
  138.             is removed.  Comparison check is now only the
  139.             caller's name and password from TRIBBS.SYS to
  140.             USERS.DAT.
  141.  
  142.     08/15/93 v1.2 - More thorough checking of the caller against the
  143.             database in USERS.DAT.
  144.  
  145.               - Command line suggestion no longer misleading.
  146.  
  147.     07/24/93 v1.1 - In version 1.0, if there were more than 256 callers
  148.             in the file USERS.DAT, TRISEC's writing position 
  149.             would start over at the beginning of the file for
  150.             record # 257.  This would overwrite someone else's
  151.             record, effectively placing two records for that
  152.             caller into the file.  FIXED!
  153.  
  154.     06/05/93 v1.0 - First release.
  155.