home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / bbs_ra / radb_300.arj / RADB2DAY.DOC next >
Text File  |  1991-11-06  |  12KB  |  313 lines
  1.    ───────────────────────────────────────────────────────────────────────
  2.    ▒▒ RADB2DAY ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ Version 3.00 ▒▒▒▒▒
  3.    ───────────────────────────────────────────────────────────────────────
  4.  
  5.           ░░░░ ▒▒▒ ▓▓▓▓ ▒▒▒▒▒ ▄███▄ ▓   ▓      Andy Williams  2:440/81
  6.           ░  ░  ▒  ▓      ▒   █   █ ▓▓  ▓           And
  7.           ░░░░  ▒  ▓▓▓▓   ▒   █   █ ▓ ▓ ▓      Peter Burnett  2:440/80
  8.           ░     ▒     ▓   ▒   █   █ ▓  ▓▓
  9.           ░    ▒▒▒ ▓▓▓▓   ▒   ▀███▀ ▓   ▓                ┌─┐
  10.                                   ┌───────░·░─┐          │ │
  11.          ┌───┐ ┌───┐              │       ░·░ │          │ │
  12.          │ ┌─┘ └─┐ └──────────────│       ░·░ │┌─────────┘ └──┐
  13.          │ │     │ ▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │       ░·░ │└───┬───┬      └───
  14.          │ └─┐ ┌─┘ ┌──────────────│       ░·░ │    └┬──┴┐
  15.          └───┘ └───┘              │       ░·░ │     └┬──┴┬      ┌────
  16.                                   └───────░·░─┘      └───┴──────┘
  17.  
  18.       Piston Popper BBS, Hastings, UK      ▓▓▓▓ ▄███▄ ░░░░ ▒▒▒▒ ▓▓▓▓ ███▄
  19.       +44-424-853361 - Hst / V32           ▓  ▓ █   █ ░  ░ ▒  ▒ ▓    █  █
  20.                                            ▓▓▓▓ █   █ ░░░░ ▒▒▒▒ ▓▓▓  ████
  21.       \/\/ho's in the House? Hastings, Uk  ▓    █   █ ░    ▒    ▓    █  █▌
  22.                                            ▓    ▀███▀ ░    ▒    ▓▓▓▓ █   █
  23.  
  24.  
  25.    ───────────────────────────────────────────────────────────────────────
  26.    ▒▒ RADB2DAY ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ Version 3.00 ▒▒▒▒▒
  27.    ───────────────────────────────────────────────────────────────────────
  28.  
  29.               ╔══════════════════════════════════════════════╗
  30.               ║ Piston Popper Software Systems, Hastings, UK ║
  31.               ╚══════════════════════════════════════════════╝
  32.  
  33.                       PO Box No. 4
  34.                     St Leonards On Sea
  35.                      East Sussex
  36.                        England
  37.  
  38.                 Piston Popper Software
  39.  
  40.                           Proudly Presents!
  41.  
  42.             RemoteAccess & D'Bridge Callers Today !!!  Version 3.00
  43.  
  44.         Copyright (C) November 1991 Andy Williams, All Rights Reserved
  45.  
  46.  
  47.  
  48.  
  49.    ───────────────────────────────────────────────────────────────────────
  50.    ▒▒ CREDITS ! ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  51.    ───────────────────────────────────────────────────────────────────────
  52.  
  53.  
  54.  
  55.      RemoteAccess is a trademark of Andrew Milner & Continental Software
  56.     
  57.                       D'Bridge is a trademark of Chris Irwin
  58.            
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.    ───────────────────────────────────────────────────────────────────────
  74.    ▒▒ DISCLAIMER & LICENSE ! ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  75.    ───────────────────────────────────────────────────────────────────────
  76.  
  77.  
  78.  ■ RADB2DAY is SHAREware *NOT* Public Domain!
  79.  
  80.  ■ The documentation and accompanying program are copyrighted material 
  81.    designed, produced and tested by the author of the software.
  82.  
  83.  ■ Although every care and attention has been taken to write and test the
  84.    program to make sure that it does what this documentation states, the
  85.    program is provided as it is, without warranty or guarantee of any kind,
  86.    either expressed or implied, as to the quality or performance of this
  87.    program, except that it will occupy disk space.
  88.  
  89.  ■ The author shall not be held liable to you or anyone else for any direct,
  90.    indirect, incidental or consequential damages, including any lost profits,
  91.    lost savings, lost business, which may result from the use or inability 
  92.    to use this program.
  93.  
  94.  ■ Your use of this program constitutes your agreement to this disclaimer and
  95.    your release of the author from any form of liability or litigation.
  96.  
  97.  ■ You are granted a license to use RADB2DAY 3.00 for an evaluation period
  98.    of 30 days. After this period has expired you must either REGISTER the
  99.    program or cease to use it. Details of the registration procedure is
  100.    included in the document file REGISTER.ME 
  101.  
  102.  ■ You are actively encouraged to copy and distribute it in an unmodified way 
  103.    as much as you want, as long as you still abide to the conditions mentioned 
  104.    here and that no money or monies or any other form of compensation is asked
  105.    or accepted.
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.    ───────────────────────────────────────────────────────────────────────
  122.    ▒▒ INTRODUCTION ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  123.    ───────────────────────────────────────────────────────────────────────
  124.  
  125.  
  126.    NOTE: RADB2DAY will *ONLY* function when RemoteAccess BBS software and
  127.      D'Bridge mail system are installed together. It is NOT currently
  128.          compatible with any mailer software whatsoever. It will NOT
  129.          function without the D'Bridge software being installed.
  130.  
  131.    What is RADB2DAY ?
  132.  
  133.    This program provides an improved display of the number of calls made
  134.    to a RemoteAccess BBS system that it is installed on. Improved in the
  135.    sense that it not only displays the human callers who have logged into 
  136.    the BBS during the day, but also a list of the inbound and outbound mail 
  137.    sessions which have taken place. This is of course providing a D'Bridge 
  138.    mailer system is installed on the front end of the BBS to handle the mail.
  139.  
  140.    I have seen similiar program which work with D'Bridge and RemoteAccess,
  141.    but my one has an advantage over the others in that it also displays 
  142.    the *NAME* of the bulletin board in the inbound and outbound mail session
  143.    summaries. It does this by directly accessing the nodelist files on your
  144.    hard disk.
  145.    ───────────────────────────────────────────────────────────────────────
  146.    ▒▒ WHAT IT DOES !!▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  147.    ───────────────────────────────────────────────────────────────────────
  148.  
  149.    RADB2DAY interrogates the LASTCALL.BBS file produced by RemoteAccess
  150.    and the D'Bridge DL1 & DL2 files, to determine the activity which has 
  151.    occurred so far on the BBS for the day. 
  152.  
  153.    It then produces two files, one ASCII & one ANSI which maybe displayed
  154.    via a Type 5 menu option ( Display .ASC/.ANS file ) inside RemoteAccess. 
  155.  
  156.    The files produced are called RADB2DAY.ASC and RADB2DAY.ANS respectively, 
  157.    they are automatically placed into your RemoteAccess textfiles directory 
  158.    which contain your text files for menus etc.
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.    ───────────────────────────────────────────────────────────────────────
  170.    ▒▒ HOW TO INSTALL IT !!▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  171.    ───────────────────────────────────────────────────────────────────────
  172.  
  173.    
  174.    Unpack the files from the archive and copy them into your RA directory.
  175.  
  176.    RADB2DAY can in actual fact be run from anywhere on your system as
  177.    it locates the path for RemoteAccess and D'Bridge from the DOS
  178.    environment variables. These variables *MUST* be declared before
  179.    RADB2DAY will run. The best way to do this is at the start of your
  180.    batch file put the following statements:
  181.  
  182.    SET RA=<Full Drive & Path to RA Directory> 
  183.    SET DBRIDGE=<Full Drive & Path to D'Bridge Directory )
  184.  
  185.    e.g.
  186.  
  187.    SET RA=C:\RA1
  188.    SET DBRIDGE=C:\DB
  189.  
  190.  
  191.    RABD2DAY should be installed into your mail BBS batch file, so that it is
  192.    executed when the following conditions occur:
  193.  
  194.     1) After every BBS caller logs-off
  195.     2) After every D'Bridge mail session
  196.     3) During your midnight maintainance schedule
  197.  
  198.    It is installed into your BBS batch file as simply:
  199.  
  200.     RADB2DAY.EXE
  201.  
  202.    There are NO command line or parameters required to be specified.
  203.  
  204.    The final stage is to create a menu option ( I prefer to have it on my
  205.    TOP menu ) to display the text files produced by RADB2DAY. Use a menu 
  206.    Type 5 ( Display .ANS/.ASC file ) - NOT a type 45 option. The text files
  207.    produced already contain prompts for the user to press a key to continue.
  208.    In the optional data field in the RAMENU editor enter:
  209.  
  210.     RADB2DAY      ( Do not specify an extension of .ASC or .ANS )
  211.  
  212.    Thats all there is to it !
  213.  
  214.    The program has been successfully tested on several systems under 
  215.    a wide range of video cards including Hercules, CGA, EGA & VGA.
  216.  
  217.    ───────────────────────────────────────────────────────────────────────
  218.    ▒▒ MULTIPLE NODELISTS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  219.    ───────────────────────────────────────────────────────────────────────
  220.  
  221.    RADB2DAY is now multiple nodelist aware. This means providing you
  222.    have compiled your nodelists with RANODE as per the RemoteAccess
  223.    documentation, then RADB2DAY will now recognise the new nodes in the
  224.    corresponding nodelist files.
  225.  
  226.    No configuration files are necessary, RADB2DAY uses the information
  227.    produced by RANODE to locate the respective nodelist files for the
  228.    information it requires.
  229.  
  230.    RADB2DAY is now also Point aware. If a point system off your BBS 
  231.    calls you his full network address including point number will be 
  232.    displayed. 
  233.  
  234.    The BBS name will still be that of the Boss Node of the calling
  235.    point. If anyone doesn't like this arrangement - I'm open to suggestions
  236.    on what to display in place of the Boss node's system name.
  237.  
  238.  
  239.  
  240.  
  241.    ───────────────────────────────────────────────────────────────────────
  242.    ▒▒ LOCAL CONSOLE LOGINS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  243.    ───────────────────────────────────────────────────────────────────────
  244.  
  245.    If a login is made to the BBS from the Sysops console keyboard i.e. not 
  246.    via a remote modem, the baud rate column has the word "Local" placed in 
  247.    it instead of "0" as per normal with RemoteAccess.
  248.  
  249.  
  250.  
  251.  
  252.    ───────────────────────────────────────────────────────────────────────
  253.    ▒▒ ERRORLEVELS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  254.    ───────────────────────────────────────────────────────────────────────
  255.  
  256.    I thought it was about time RADB2DAY produced some Errorlevels for all
  257.    you batch file fiends out there!
  258.  
  259.    RADB2DAY currently produces 6 different errorlevels as follows:
  260.  
  261.     0 - OK. Program Terminated Normally
  262.     1 - Error. Can't find RA in DOS environment
  263.     2 - Error. Can't find DBRIDGE in DOS environment
  264.     3 - Error. Can't find CONFIG.RA in specified path
  265.     4 - Error. Can't find NODEINC.RA in specified path
  266.     5 - Error. Can't find < Nodelist File > in specified path
  267.     6 - Error. Can't find NODEIDX.RA in specified path
  268.  
  269.   Errorlevel 5 is particularly useful when trapped in a batch file. This
  270.   error normally occurs if you apply a NODEDIFF to a NODELIST file, but
  271.   forget to run RANODE to compile it. You can now trap this error and make 
  272.   your batch file automatically process RANODE if it can't find the respective
  273.   nodelist file. 8-)
  274.  
  275.  
  276.    ───────────────────────────────────────────────────────────────────────
  277.    ▒▒ DESQview Users ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  278.    ───────────────────────────────────────────────────────────────────────
  279.  
  280.    When RADB2DAY initialises it checks for the presence of the DESQview
  281.    multi-tasking environment and if active re-directs the screen to the
  282.    DESQview window in which it is running.
  283.  
  284.    N.B.
  285.    ~~~~
  286.        Do NOT try and run RADB2DAY in a window simultaneously when
  287.            D'Bridge is active in another DESQview window. D'Bridge 1.30 
  288.            appears not to support file locking and unpredictable results
  289.            can occur when it tries to access the nodelist files.
  290.  
  291.  
  292.  
  293.    ───────────────────────────────────────────────────────────────────────
  294.    ▒▒ HELP!!! ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  295.    ───────────────────────────────────────────────────────────────────────
  296.  
  297.    If you have any other problems/bug reports/suggestions I can be contacted 
  298.    via Fidonet Netmail on my BBS system at (2:440/81) or via snail mail:
  299.  
  300.    \/\/ho's in the House? BBS 
  301.    C/O Piston Popper Software
  302.    PO Box No. 4
  303.    St Leonards On Sea
  304.    EAST SUSSEX
  305.    UK    
  306.  
  307.    If you have any other suggestions then drop me a line!!
  308.  
  309.    Thanks for using my program!
  310.  
  311.    Andy Williams - Author RADB2DAY
  312.  
  313.