home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / bbs / vfy_29a.zip / 4-TRIBBS.ZIP / TRISEC.DOC < prev    next >
Text File  |  1993-07-24  |  5KB  |  128 lines
  1.         **************************************************************
  2.         *                                                            *
  3.         *                      TRISEC.EXE v1.1                       *
  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\MWORK 100
  29.  
  30. FILES IN THIS PACKAGE
  31. ---------------------
  32.     TRISEC   EXE        Executable program.
  33.     TRISEC   DOC        Document file. (This file).
  34.     TEST     BAT        Batch file for initial testing.
  35.     USERS    DAT        Sample user database file from TRIBBS v3.3.
  36.     CHECK    EXE        Program that displays all caller's name and
  37.                 security levels, directly from USERS.DAT.
  38.     TRIBBS   SYS        Sample user info file created by TRIBBS.
  39.  
  40. SAMPLE TRAP DOOR BATCH FILE
  41. ---------------------------
  42. @ECHO OFF
  43. CLS
  44. ECHO ******* Entering VERIFY! *******>> C:\TRIBBS\MWORK\CALLERS.LOG
  45. C:
  46. CD C:\TRIBBS\VERIFY!
  47. VERIFY! /B:TRIBBS_T /D:C:\TRIBBS\MWORK /L:C:\TRIBBS\MWORK\CALLERS.LOG
  48. rem  ERRORLEVEL 0 and 1 means caller is verified.  
  49. rem  ERRORLEVEL 0 == local call
  50. rem  ERRORLEVEL 1 == long distance
  51. IF ERRORLEVEL 0 IF NOT ERRORLEVEL 2 goto ADJUST
  52. goto END
  53. :ADJUST
  54. CD C:\TRIBBS\MWORK
  55. rem  Adjust caller's security level to 50
  56. TRISEC C:\TRIBBS\MWORK 50
  57. :END
  58.  
  59. TECHNICAL
  60. ---------
  61.     TRISEC.EXE begins by reading the file TRIBBS.SYS, where it learns
  62.     the current caller's name.  Then, TRIBBS's database file USERS.DAT
  63.     is searched for the matching name.  When it finds the current
  64.     caller's name, the security level part of that record is changed
  65.     and written to the file.
  66.  
  67.     On exit of TRISEC, ERRORLEVELs are returned.  Your batch file can
  68.     check the ERRORLEVEL and determine what has happened.  The following
  69.     is a list of TRISEC's ERRORLEVELs and their meaning:
  70.  
  71.     ERRORLEVEL   0        Normal exit, adjustment successful.
  72.     ERRORLEVEL   1        Error exit, either a file cannot be found,
  73.                 the adjustment cannot be made, the user's
  74.                 name cannot be found, etc.  The actual
  75.                 reason for the error is written to the
  76.                 screen.
  77.  
  78.     Review your DOS manual for more information on ERRORLEVELs.
  79.  
  80.     For the purpose of verification, the program CHECK.EXE is included
  81.     with this program.  CHECK.EXE reads USERS.DAT and displays the names
  82.     and security levels of all the registered callers.  The names are
  83.     displayed in the same order as they are found in the database file.  
  84.  
  85. DISCLAIMER
  86. ----------
  87.     This program is distributed as is.  No warranty, either expressed or
  88.     implied is offered and the programmer is not responsible for any
  89.     damages or expenses that may occur through the use of this program.
  90.     The user shall determine its suitability.  Extensive testing has been
  91.     performed and every effort has been made to ensure satisfactory 
  92.     performance prior to release.  Please communicate any difficulties 
  93.     with the programmer through the BBS at (805) 723-6908.  Any problems
  94.     received will be treated as a top priority.
  95.  
  96. CREDITS
  97. -------
  98.     Thanks to James Mann of Littlerock, CA. for requesting this program.
  99.  
  100.     TRIBBS is copyrighted software by Mark Goodwin, 366 14th St.,
  101.     Bangor, ME 04401
  102.  
  103. PROGRAMMING SERVICES
  104. ====================
  105.     TRISEC.EXE is a custom program, and performs exactly as requested.
  106.  
  107.     Programming services are provided by Sagerquist Micro Engineering
  108.     by request.  The point of contact is the S M E Support BBS at
  109.     (805) 723-6908, or via mail at the following address:
  110.  
  111.     Sagerquist Micro Engineering
  112.     1414 W. Kerrick St.
  113.     Lancaster, CA 93534
  114.     BBS (805) 723-6908
  115.  
  116.     If you have a need for a program of any kind, please let us know.
  117.  
  118. HISTORY
  119. -------
  120.     06/05/93 v1.0 - First release.
  121.  
  122.     07/24/93 v1.1 - In version 1.0, if there were more than 256 callers
  123.             in the file USERS.DAT, TRISEC's writing position 
  124.             would start over at the beginning of the file for
  125.             record # 257.  This would overwrite someone else's
  126.             record, effectively placing two records for that
  127.             caller into the file.  FIXED!
  128.