home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / TYCB15.ZIP / TYCB.DOC < prev    next >
Text File  |  1993-10-07  |  15KB  |  267 lines
  1.                                ┌────────────────┐
  2.                                │  T.Y.C.B  1.5  │
  3.                                └────────────────┘
  4.  
  5.                      "Today/Yesterday Callers Bulletin"
  6.  
  7.                       Compliments of:  The HOTware BBS
  8.                               Net/Node 064/003
  9.  
  10.  
  11.        ──────────────────────────────────────────────────────────────
  12.                                   History
  13.        ──────────────────────────────────────────────────────────────
  14.  
  15.          08-12-92   Ver 1.0 Initial Release
  16.          08-29-92   Ver 1.1 Bug fix and new feature release.  First
  17.                     for the minor bug.  TYCB was not resetting the
  18.                     TYCB.DAT file on a daily basis if a Yesterdays
  19.                     caller bulletin was not being used.  This meant
  20.                     that TYCB kept an ongoing listing of number of
  21.                     calls and callers, FIXED.  The new feature that
  22.                     was added was a suggestion by Alex Mottram at
  23.                     034/004.  TYCB now allows configuration of access
  24.                     levels to be EXCLUDED from the listing.  Any
  25.                     access level that is placed in the EXCLUDE list
  26.                     will not be shown in the Today/Yesterday bulletins
  27.                     even if their access is above the minimum access
  28.                     that is configured.  This allows Sysops to prevent
  29.                     thereselves from being listed in the bulletins.
  30.          09-06-92   Ver 1.2 will now look into the GT.CNF for an entry
  31.                     in the LAN Path configuration.  If you have an
  32.                     entry here TYCB will read the USER.CTL file from
  33.                     this location.  This is done to make the program
  34.                     a little more useful for those running a LAN.
  35.                     This feature was added at the request of Jon Hagee,
  36.                     032/014.
  37.          09-07-92   Ver 1.3 adds the ability to place a "Total Calls"
  38.                     display at the end of the bulletins.
  39.          02-21-92   Ver 1.4 now has the ability to detect an incomplete
  40.                     logon and not increment that previous callers totals.
  41.                     This version also adds one item to the configuration.
  42.                     TYCB can now optionally place an ANSI clear screen
  43.                     ESCAPE Sequence at the beginning of the bulletins.
  44.                     This is optional....
  45.          10-07-93   Ver 1.5 At the suggestion of Daryl Stout, TYCB now can
  46.                     be configured to create ASCII (mono) bulletins using 7
  47.                     bit characters rather than 8 bit extended graphics
  48.                     characters.  Option B on the configuration screen
  49.                     controls this setting.
  50.  
  51.  
  52.  
  53.        ──────────────────────────────────────────────────────────────
  54.                                 What is It?
  55.        ──────────────────────────────────────────────────────────────
  56.          What in the heck is TYCB?  TYCB stands for "Today/Yesterday
  57.          Callers Bulletin".  TYCB is a simple little program that will
  58.          create both an ANSI and ASCII listing of Todays callers and
  59.          Yesterdays Callers.  The program is designed to run ON EVERY
  60.          CALL!  This program should be run either in the GTLOGON.BAT
  61.          or GTLOGOFF.BAT.  TYCB will read the callers name from the
  62.          GTUSER.BBS file, then proceed to lookup other information
  63.          in the USER.CTL file.  TYCB will continue to save information
  64.          for each caller until the date changes.  On the first run
  65.          after a date change, TYCB will create the "Who Called
  66.          Yesterday Bulletin", discard the "Yesterday's Info", and
  67.          begin collecting information for "Today's Info".  All the
  68.          "Today's Info" will be held in a file called TYCB.DAT which
  69.          will be located in your GTPATH directory.
  70.  
  71.        ──────────────────────────────────────────────────────────────
  72.                                   Why Is It?
  73.        ──────────────────────────────────────────────────────────────
  74.  
  75.          You may be asking about now, Why would you want to do this?
  76.          It's simple.  I like to list a bulletin of the users that
  77.          call my system on a daily basis.  Well while I'm at it I'll
  78.          list the users that called yesterday for any users that want
  79.          to know.....
  80.  
  81.        ──────────────────────────────────────────────────────────────
  82.                                Configuration
  83.        ──────────────────────────────────────────────────────────────
  84.  
  85.          TYCB will enter config mode automatically the first time it
  86.          is executed.  Any time thereafter you need to run TYCB /CONFIG
  87.          anytime you need to change the configuration.  Once in config
  88.          mode you will be presented with the following screen....
  89.  
  90.  
  91.        ┌───────────────────────────────────────────────────────────────┐
  92.        │                       TYCB Configuration                      │
  93.        │                                                               │
  94.        │  1. Your BBS Name:   Unknown BBS                              │
  95.        │                                                               │
  96.        │  2. Yesterday ASCII: NONE                                     │
  97.        │                                                               │
  98.        │  3. Yesterday ANSI:  NONE                                     │
  99.        │                                                               │
  100.        │  4. Today ASCII:     NONE                                     │
  101.        │                                                               │
  102.        │  5. Today ANSI:      NONE                                     │
  103.        │                                                               │
  104.        │  6. Configure ANSI Colors        7. Minimum Access:  z        │
  105.        │                                                               │
  106.        │  8. Exclude Access Lvls  NONE                                 │
  107.        │                                                               │
  108.        │  9. Include Total Calls  YES  A. Add ANSI Clear Screen? YES   │
  109.        │                                                               │
  110.        │  B. Use 7 or 8 Bit Characters For ASCII Bulletin?  8          │
  111.        │                                                               │
  112.        │   S)ave and Exit   [ESC] Abort and Exit   D)os Shell          │
  113.        └───────────────────────────────────────────────────────────────┘
  114.  
  115.           1. Your BBS Name:   This is quite simply the name of your BBS,
  116.                               for the purpose of including it in the header
  117.                               information of the bulletin.
  118.  
  119.           2. Yesterday ASCII: This option is the path and filename of the
  120.                               file that you would like to use for your
  121.                               Yesterdays Callers bulletin.  This file will
  122.                               contain only ASCII characters and will be
  123.                               updated daily on the first execution of
  124.                               TYCB.
  125.  
  126.           3. Yesterday ANSI:  This option is the path and filename of the
  127.                               file that you would like to use for your
  128.                               Yesterdays Callers bulletin.  This file will
  129.                               contain ANSI Escape characters and will be
  130.                               updated daily on the first execution of
  131.                               TYCB.
  132.  
  133.           4. Today ASCII:     This option is the path and filename of the
  134.                               file that you would like to use for your
  135.                               Todays Callers bulletin.  This file will
  136.                               contain only ASCII characters and will be
  137.                               updated using information found in the
  138.                               GTUSER.BBS and USER.CTL files on each
  139.                               execution of TYCB.
  140.  
  141.           5. Today ANSI:      This option is the path and filename of the
  142.                               file that you would like to use for your
  143.                               Todays Callers bulletin.  This file will
  144.                               contain ANSI Escape characters and will be
  145.                               updated using information found in the
  146.                               GTUSER.BBS and USER.CTL files on each
  147.                               execution of TYCB.
  148.  
  149.           6. Configure Ansi Colors:
  150.                               This option will take you to menu level 2 and
  151.                               allow you configure the colors of the ANSI
  152.                               Bulletins.
  153.  
  154.           7. Minimum Access:  This option allows you to only include
  155.                               users above a configurable Access Level.
  156.                               This was requested by folks running systems
  157.                               that require registration that do not wish
  158.                               to include non-registered users in the list.
  159.                               The default is 'z' which is the lowest avail-
  160.                               able access level.  This option is inclusive,
  161.                               ie. if level 'z' is configured, users of that
  162.                               level will be included in the report.
  163.  
  164.           8. Exclude Access Levl:  This option allows you to specify
  165.                               what access levels you would like to
  166.                               EXCLUDE from the listing.  Up to 36
  167.                               Access levels can be excluded from the
  168.                               bulletins.
  169.  
  170.           9. Include Total Calls:  This option allows you to place a
  171.                               "Total Calls" box at the bottom of the
  172.                               bulletin.  If you select YES, this box
  173.                               will be placed on the bottom of the
  174.                               bulletin, otherwise the totals will not
  175.                               be included in the bulletin.
  176.  
  177.           A. Add ANSI Clear Screen: This option allows you to add or
  178.                               not add an ASCII clear screen sequence
  179.                               at the beginning of the bulletins.  If
  180.                               you would like your bulletins to
  181.                               automatically clear the screen prior to
  182.                               display select YES for this option.
  183.  
  184.           B. Use 7 or 8 Bit Characters For ASCII Bulletin?:  If you would
  185.                               prefer to create ASCII Bulletins with 7 bit
  186.                               characters, select 7 for this option,
  187.                               otherwise select 8.
  188.  
  189.  
  190.  
  191.        ──────────────────────────────────────────────────────────────
  192.                                  Execution..
  193.        ──────────────────────────────────────────────────────────────
  194.          Running the program is very easy.  The only things that are
  195.          required are: 1. A valid GTPATH statement, 2. A valid GTUSER.BBS
  196.          in the GTPATH directory and  3. A valid USER.CTL file in the
  197.          GTPATH directory.  After the program has been configured
  198.          all you have to do is run TYCB either in the GTLOGON.BAT or
  199.          GTLOGOFF.BAT file and your bulletins will magically appear.
  200.  
  201.        ──────────────────────────────────────────────────────────────
  202.                                 Registration
  203.        ──────────────────────────────────────────────────────────────
  204.  
  205.         I am not requesting any money for this program, but I would
  206.         not turn any down either <g>.  If you want to slip $5.00 into
  207.         and envelope I'll accept it.  Although I don't require a
  208.         registration fee I would appreciate knowing that you are using
  209.         the program on a normal basis.  Therefore I have provided a
  210.         simple and easy way for you to register this program.  From
  211.         the DOS prompt type:   
  212.  
  213.  
  214.         TYCB REGISTER
  215.  
  216.       TYCB will the proceed to send me a netmail message informing me
  217.       that you are using the program.  Please use this feature ONCE.
  218.  
  219.  
  220.  
  221.        ──────────────────────────────────────────────────────────────
  222.                                  Errorlevels
  223.        ──────────────────────────────────────────────────────────────
  224.          Here are the possible errorlevel exits the program will give.
  225.       
  226.                   ERRORLEVEL 0  No Problems, Good Run.....
  227.                   ERRORLEVEL 1  Unable to Open TYCB.DAT.
  228.                   ERRORLEVEL 2  Unable to Open USER.CTL.
  229.                   ERRORLEVEL 3  GTPATH Environment Not Set
  230.                   ERRORLEVEL 4  Error Reading Configuration
  231.  
  232.        ──────────────────────────────────────────────────────────────
  233.                             Who Is Responsible for This?
  234.        ──────────────────────────────────────────────────────────────
  235.                                  Rob Roesch
  236.                               The HOTware BBS
  237.                          GT Power Net-Node 064/003
  238.                                 Rt 7 Box 566
  239.                                Mocksville, NC
  240.                          704-492-2081 (USR 16.8 DS)
  241.  
  242.           If you start using this utility, and get a chance, let me know 
  243.           (see above procedures).  If you don't have any use for it, delete
  244.           it for your total refund of all the disk space that it was
  245.           occupying.  This program comes with no warranty, no guarantee,
  246.           and no promises.  If it works GREAT, if not let me know and I
  247.           will gladly take a look at it in my spare time.  If you really
  248.           really really like the program and want to make any donations,
  249.           feel free, but it is not an absolute requirement.....
  250.  
  251.        ──────────────────────────────────────────────────────────────
  252.                         Alternate Distribution Sites
  253.        ──────────────────────────────────────────────────────────────
  254.  
  255.            The HOTware Utilities now have alternate Distribution
  256.            Centers for your convenience.  The following BBS always
  257.            have the latest and greatest HOTware utilities online and
  258.            available for download.
  259.  
  260.      BBS Name          BBS Phone          Location     GT Net/Node    Hours
  261.  ┌──────────────────┬───────────────┬────────────────────┬───────┬──────────┐
  262.  │ Laboratory 386   │ 618-549-2322  │ Carbondale IL      │064/400│ 10pm-8am │
  263.  └──────────────────┴───────────────┴────────────────────┴───────┴──────────┘
  264.  
  265.  
  266.  
  267.