home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / ra / radb_350.zip / RADB2DAY.DOC < prev    next >
Text File  |  1993-04-19  |  18KB  |  434 lines

  1.    ───────────────────────────────────────────────────────────────────────
  2.    ▒▒ RADB2DAY ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ Version 3.50 ▒▒▒▒▒
  3.    ───────────────────────────────────────────────────────────────────────
  4.  
  5.           ░░░░ ▒▒▒ ▓▓▓▓ ▒▒▒▒▒ ▄███▄ ▓   ▓      Andy Williams  2:441/80.2
  6.           ░  ░  ▒  ▓      ▒   █   █ ▓▓  ▓           And
  7.           ░░░░  ▒  ▓▓▓▓   ▒   █   █ ▓ ▓ ▓      Peter Burnett  2:441/80.0
  8.           ░     ▒     ▓   ▒   █   █ ▓  ▓▓
  9.           ░    ▒▒▒ ▓▓▓▓   ▒   ▀███▀ ▓   ▓                ┌─┐
  10.                                   ┌───────░·░─┐          │ │
  11.          ┌───┐ ┌───┐              │       ░·░ │          │ │
  12.          │ ┌─┘ └─┐ └──────────────│       ░·░ │┌─────────┘ └──┐
  13.          │ │     │ ▓▓▓▓▓▓▓▓▓▓▓▓▓▓ │       ░·░ │└───┬───┬      └───
  14.          │ └─┐ ┌─┘ ┌──────────────│       ░·░ │    └┬──┴┐
  15.          └───┘ └───┘              │       ░·░ │     └┬──┴┬      ┌────
  16.                                   └───────░·░─┘      └───┴──────┘
  17.  
  18.       Piston Popper BBS, Hastings, UK      ▓▓▓▓ ▄███▄ ░░░░ ▒▒▒▒ ▓▓▓▓ ███▄
  19.       +44-424-853361 - Hst / V32           ▓  ▓ █   █ ░  ░ ▒  ▒ ▓    █  █
  20.                                            ▓▓▓▓ █   █ ░░░░ ▒▒▒▒ ▓▓▓  ████
  21.                                            ▓    █   █ ░    ▒    ▓    █  █▌
  22.                                            ▓    ▀███▀ ░    ▒    ▓▓▓▓ █   █
  23.  
  24.  
  25.    ───────────────────────────────────────────────────────────────────────
  26.    ▒▒ RADB2DAY ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ Version 3.50 ▒▒▒▒▒▒
  27.    ───────────────────────────────────────────────────────────────────────
  28.  
  29.               ╔══════════════════════════════════════════════╗
  30.               ║ Piston Popper Software Systems, Hastings, UK ║
  31.               ╚══════════════════════════════════════════════╝
  32.  
  33.                                10 Parsons Close
  34.                                St. leonards On Sea
  35.                                East Sussex
  36.                                UK         TN38 9QT
  37.  
  38.                                Piston Popper Software
  39.  
  40.                           Proudly Presents!
  41.  
  42.             RemoteAccess & D'Bridge Callers Today !!!  Version 3.50
  43.  
  44.          Copyright (C) 1991,1992,1993 Andy Williams, All Rights Reserved
  45.  
  46.  
  47.    ───────────────────────────────────────────────────────────────────────
  48.    ▒▒ CREDITS ! ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  49.    ───────────────────────────────────────────────────────────────────────
  50.  
  51.    RemoteAccess(tm) is a trademark of Andrew Milner & Continental Software
  52.     
  53.                   D'Bridge(tm) is a trademark of Chris Irwin
  54.  
  55.    RADB2DAY & RADB286 was written in PASCAL and ASSEMBLER and is compiled by
  56.            Borlands Pascal v7.00 & Borlands Turbo Assembler v3.20
  57.  
  58.  
  59.    ───────────────────────────────────────────────────────────────────────
  60.    ▒▒ DISCLAIMER & LICENSE ! ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  61.    ───────────────────────────────────────────────────────────────────────
  62.  
  63.  
  64.  ■ RADB2DAY is SHAREware *NOT* Public Domain!
  65.  
  66.  ■ The documentation and accompanying program are copyrighted material 
  67.    designed, produced and tested by the author of the software.
  68.  
  69.  ■ Although every care and attention has been taken to write and test the
  70.    program to make sure that it does what this documentation states, the
  71.    program is provided as it is, without warranty or guarantee of any kind,
  72.    either expressed or implied, as to the quality or performance of this
  73.    program, except that it will occupy disk space.
  74.  
  75.  ■ The author shall not be held liable to you or anyone else for any direct,
  76.    indirect, incidental or consequential damages, including any lost profits,
  77.    lost savings, lost business, which may result from the use or inability 
  78.    to use this program.
  79.  
  80.  ■ Your use of this program constitutes your agreement to this disclaimer and
  81.    your release of the author from any form of liability or litigation.
  82.  
  83.  ■ You are granted a license to use RADB2DAY 3.50 for an evaluation period
  84.    of 30 days. After this period has expired you must either REGISTER the
  85.    program or cease to use it. Details of the registration procedure are
  86.    included in the document file REGISTER.ME 
  87.  
  88.  ■ You are actively encouraged to copy and distribute it in an unmodified way 
  89.    as much as you want, as long as you still abide to the conditions mentioned 
  90.    here and that no money or monies or any other form of compensation is asked
  91.    or accepted.
  92.  
  93.  
  94.    ───────────────────────────────────────────────────────────────────────
  95.    ▒▒ INTRODUCTION ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  96.    ───────────────────────────────────────────────────────────────────────
  97.  
  98.  
  99.    NOTE: RADB2DAY will *ONLY* function when RemoteAccess BBS software and
  100.      D'Bridge mail system are installed together. It is NOT currently
  101.          compatible with any other mailer software whatsoever. It will NOT
  102.          function without the D'Bridge software being installed.
  103.  
  104.          This version of RADB2DAY will only work with v2.00 of RA. Version
  105.          3.01 of RADB2DAY ( 'RADB_301.*' ) is for RA v1.1x.
  106.  
  107.    What is RADB2DAY ?
  108.  
  109.    This program provides an improved display of the number of calls made
  110.    to a RemoteAccess BBS system that it is installed on. Improved in the
  111.    sense that it not only displays the human callers who have logged into 
  112.    the BBS during the day, but also a list of the inbound and outbound mail 
  113.    sessions which have taken place. This is of course providing a D'Bridge 
  114.    mailer system is installed on the front end of the BBS to handle the mail.
  115.  
  116.    I have seen similiar program which work with D'Bridge and RemoteAccess,
  117.    but my one has an advantage over the others in that it also displays 
  118.    the *NAME* of the bulletin board in the inbound and outbound mail session
  119.    summaries. It does this by directly accessing the nodelist files on your
  120.    hard disk.
  121.  
  122.    The archive you downloaded/received should be named RADB_350.??? where
  123.    ??? will be one of the many archive type extensions, ( Lzh, Pak, Arc
  124.    Zip, Arj ).
  125.  
  126.    The RADB_350.??? archive may be converted to another archive format
  127.    provided that all the listed files below are included and no others
  128.    are added either.
  129.  
  130.    RADB2DAY.EXE    The generic executable program.
  131.    RADB286.EXE     The 80286+ executable program.
  132.    RADB2DAY.DOC    This documentation you are reading now.
  133.    THANK.YOU       List of sites that have registered PP Software
  134.    REGISTER.ME     Registration Information & Form
  135.    WHATSNEW.350    Update, Debug & History Information
  136.  
  137.  
  138.    ───────────────────────────────────────────────────────────────────────
  139.    ▒▒ WHAT IT DOES !!▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  140.    ───────────────────────────────────────────────────────────────────────
  141.  
  142.    RADB2DAY interrogates the LASTCALL.BBS file produced by RemoteAccess
  143.    and the D'Bridge DL1 & DL2 files, to determine the activity which has 
  144.    occurred so far on the BBS for the day. 
  145.  
  146.    It then produces two files, one ASCII & one ANSI which maybe displayed
  147.    via a Type 5 menu option ( Display .ASC/.ANS file ) inside RemoteAccess. 
  148.  
  149.    The files produced are called RADB2DAY.ASC and RADB2DAY.ANS respectively, 
  150.    they are automatically placed into your RemoteAccess textfiles directory 
  151.    which contain your text files for menus etc.
  152.  
  153.  
  154.    ───────────────────────────────────────────────────────────────────────
  155.    ▒▒ HOW TO INSTALL IT !!▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  156.    ───────────────────────────────────────────────────────────────────────
  157.  
  158.    
  159.    Unpack the files from the archive and copy them into your RA directory.
  160.  
  161.    RADB2DAY can in actual fact be run from anywhere on your system as
  162.    it locates the path for RemoteAccess and D'Bridge system files from
  163.    the "PATH" environment variable. 
  164.    
  165.    SET PATH=C:\;C:\DOS;C:\RA;C:\DB.........
  166.  
  167.    This variable *MUST* be declared before RADB2DAY will run. 
  168.    
  169.    If the "PATH" search fails, then RADB2DAY will search the directories
  170.    defined by the "RA", "DB" or "DBRIDGE" environment variables.
  171.    
  172.    SET RA=<Full Drive & Path to RA Directory>
  173.    SET DBRIDGE=<Full Drive & Path to D'Bridge Directory )
  174.  
  175.    e.g.
  176.  
  177.    SET RA=C:\RA1
  178.    SET DBRIDGE=C:\DB
  179.  
  180.    Note
  181.    ----
  182.    In some multi-line configurations it is useful to be able to specify a
  183.    path other than the RA system.  In this case set an environment variable
  184.    called RADB2DAY to the path of your choice.  It will automatically override
  185.    any setting specified in the RA path variable.
  186.  
  187.    The search order for the CONFIG.RA is :-
  188.  
  189.    1. Via the "RADB2DAY" environment variable
  190.    2. Via the "PATH" environment variable
  191.    3. Via the "RA" environment variable
  192.  
  193.    The search order for the D'Bridge System files is :-
  194.  
  195.    1. Via the "PATH" environment variable
  196.    2. Via the "DB" environment variable
  197.    3. Via the "DBRIDGE" environment variable
  198.  
  199.    RABD2DAY should be installed into your mail BBS batch file, so that it is
  200.    executed when the following conditions occur:
  201.  
  202.     1) After every BBS caller logs-off
  203.     2) After every D'Bridge mail session
  204.     3) During your midnight maintainance schedule
  205.  
  206.    It is installed into your BBS batch file as simply:
  207.  
  208.     RADB2DAY.EXE or RADB286.EXE
  209.  
  210.    There are NO command line or parameters required to be specified.
  211.  
  212.    The final stage is to create a menu option ( I prefer to have it on my
  213.    TOP menu ) to display the text files produced by RADB2DAY. Use a menu 
  214.    Type 5 ( Display .ANS/.ASC file ) - NOT a type 45 option. The text files
  215.    produced already contain prompts for the user to press a key to continue.
  216.    In the optional data field in the RAMENU editor enter:
  217.  
  218.     RADB2DAY      ( Do not specify an extension of .ASC or .ANS )
  219.  
  220.    Thats all there is to it !
  221.  
  222.    The program has been successfully tested on several systems under 
  223.    a wide range of video cards including Hercules, CGA, EGA & VGA.
  224.  
  225.  
  226.    ───────────────────────────────────────────────────────────────────────
  227.    ▒▒ MULTIPLE NODELISTS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  228.    ───────────────────────────────────────────────────────────────────────
  229.  
  230.    RADB2DAY is now multiple nodelist aware. This means providing you
  231.    have compiled your nodelists with RANODE as per the RemoteAccess
  232.    documentation, then RADB2DAY will now recognise the new nodes in the
  233.    corresponding nodelist files.
  234.  
  235.    No configuration files are necessary, RADB2DAY uses the information
  236.    produced by RANODE to locate the respective nodelist files for the
  237.    information it requires.
  238.  
  239.    RADB2DAY is now also Point aware. If a point system off your BBS 
  240.    calls you his full network address including point number will be 
  241.    displayed. 
  242.  
  243.    The BBS name will still be that of the Boss Node of the calling
  244.    point. If anyone doesn't like this arrangement - I'm open to suggestions
  245.    on what to display in place of the Boss node's system name.
  246.  
  247.  
  248.    ───────────────────────────────────────────────────────────────────────
  249.    ▒▒ LOCAL CONSOLE LOGINS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  250.    ───────────────────────────────────────────────────────────────────────
  251.  
  252.    If a login is made to the BBS from the Sysops console keyboard i.e. not 
  253.    via a remote modem, the baud rate column has the word "Local" placed in 
  254.    it instead of "0" as per normal with RemoteAccess.
  255.  
  256.  
  257.    ───────────────────────────────────────────────────────────────────────
  258.    ▒▒ ERRORLEVELS ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  259.    ───────────────────────────────────────────────────────────────────────
  260.  
  261.    I thought it was about time RADB2DAY produced some Errorlevels for all
  262.    you batch file fiends out there!
  263.  
  264.    RADB2DAY currently produces the different errorlevels as follows:
  265.  
  266.        -6   - Not Enough EMS Memory
  267.        -5   - EMS Driver Not Installed
  268.        -4   - Overlay File I/O Error
  269.        -3   - Not Enough Memory For Overlay Buffer
  270.        -2   - Overlay File Not Found
  271.        -1   - Overlay Manager Error
  272.     0   - OK. Program Terminated Normally
  273.         1   - Invalid Function Number
  274.         2   - File Not Found
  275.         3   - Path Not Found
  276.         4   - Too Many Open Files
  277.         5   - File Access Denied
  278.         6   - Invalid File Handle
  279.         8   - Not Enough MEMORY !
  280.         10  - Invalid Environment
  281.         11  - Invalid Format
  282.         12  - Invalid File Access Code
  283.         15  - Invalid Drive Number
  284.         16  - Cannot Remove Current Directory
  285.         17  - Cannot Rename Accross Drives
  286.         18  - No More Files
  287.         32  - Sharing violation
  288.         33  - Lock violation
  289.         34  - Invalid disk change
  290.         35  - FCB unavailable
  291.         36  - Sharing buffer overflow
  292.         50  - Network request not supported
  293.         51  - Remote computer not listening
  294.         52  - Duplicate name on network
  295.         53  - Network name not found
  296.         54  - Network busy
  297.         55  - Network device no longer exists
  298.         56  - Net BIOS command limit exceeded
  299.         57  - Network adapter hardware error
  300.         58  - Incorrect response from network
  301.         59  - Unexpected network error
  302.         60  - Incompatible remote adapter
  303.         61  - Print queue full
  304.         62  - Not enough space for print file
  305.         63  - Print file was deleted
  306.         64  - Network name was deleted
  307.         65  - Access denied
  308.         66  - Network device type incorrect
  309.         67  - Network name not found
  310.         68  - Network name limit exceeded
  311.         69  - Net BIOS session limit reached
  312.         70  - Temporarily paused
  313.         71  - Network request not accepted
  314.         72  - Print of disk redirection is paused
  315.         80  - File exists
  316.         82  - Cannot make directory entry
  317.         83  - Fail no INT 24
  318.         84  - Too many redirections
  319.         85  - Duplicate redirection
  320.         86  - Invalid password
  321.         87  - Invalid parameter
  322.         88  - Network data fault
  323.         100 - Disk Read Error
  324.         101 - Disk Write Error
  325.         102 - File Not Assigned
  326.         103 - File Not Open
  327.         104 - File Not Open For Input
  328.         105 - File Not Open For Output
  329.         106 - Invailid Numeric Format
  330.         150 - Disk Is Write Protected
  331.         151 - Unknown Unit
  332.         152 - Drive Not Ready
  333.         153 - Unknown Command
  334.         154 - CRC Error In Data
  335.         155 - Bad Drive Request Structure Length
  336.         156 - Disk Seek Error
  337.         157 - Unknown Media Type
  338.         158 - Sector Not Found
  339.         159 - Printer Out Of Paper
  340.         160 - Device Write Fault
  341.         161 - Device Read Fault
  342.         162 - Hardware Failure / Sharing violation
  343.         200 - Division By Zero
  344.         201 - Range Check Error
  345.         202 - Stack Overflow Error
  346.         203 - Heap Overflow Error
  347.         204 - Invalid Pointer Operation
  348.         205 - Foating Point Overflow
  349.         206 - Foating Point Underflow
  350.         207 - Invalid Floating Point Operation
  351.         208 - Overlay Manager Not Installed
  352.         209 - Overlay File Read Error
  353.         210 - Object Not Initialised
  354.         211 - Call To Abstract Method
  355.         212 - Stream Registration Error
  356.         213 - Collection Index Out Of Range
  357.         214 - Collection Overflow Error
  358.         215 - Arthimetic Overflow Error
  359.         216 - General Protection Error
  360.  
  361.     241 - Error. Can't find CONFIG.RA "PATH" in DOS environment
  362.     242 - Error. Can't find D'Bridge directory "PATH" in DOS environment
  363.     243 - Error. Can't find CONFIG.RA in specified path
  364.     244 - Error. Invalid configuration file: CONFIG.RA
  365.     245 - Error. Can't find NODEINC.RA in specified path
  366.     246 - Error. Problem trying to access NODEINC.RA
  367.     247 - Error. Fatal software error!
  368.         248 - Error. Can't find NODEIDX.RA in path
  369.     249 - Error. Problem accessing registration key!
  370.         250 - Error. Can't find < Nodelist File > in specified path
  371.  
  372.   Errorlevel 245 is particularly useful when trapped in a batch file. This
  373.   error normally occurs if you apply a NODEDIFF to a NODELIST file, but
  374.   forget to run RANODE to compile it. You can now trap this error and make 
  375.   your batch file automatically process RANODE if it can't find the respective
  376.   nodelist file. 8-)
  377.  
  378.  
  379.    ───────────────────────────────────────────────────────────────────────
  380.    ▒▒ DESQview Users ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  381.    ───────────────────────────────────────────────────────────────────────
  382.  
  383.    When RADB2DAY initialises it checks for the presence of the DESQview
  384.    multi-tasking environment and if active re-directs the screen to the
  385.    DESQview window in which it is running.
  386.  
  387.    N.B.
  388.    ~~~~
  389.        Be carefull when trying to run RADB2DAY in a window simultaneously
  390.            when  D'Bridge is active in another DESQview window. D'Bridge 
  391.            appears at times not to support file locking and unpredictable 
  392.            results  can occur when it tries to access the nodelist files.
  393.  
  394.  
  395.    ───────────────────────────────────────────────────────────────────────
  396.    ▒▒ Registered Copies ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  397.    ───────────────────────────────────────────────────────────────────────
  398.  
  399.    If you have registered your copy of RADB2DAY ( see REGISTER.ME for more
  400.    details ), you will have received your key in the form of a file
  401.    called RADB2DAY.KEY.  This file must either reside in your working
  402.    directory, or in a directory that appears somewhere in your PATH 
  403.    environment variable.
  404.  
  405.  
  406.    ───────────────────────────────────────────────────────────────────────
  407.    ▒▒ HELP!!! ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
  408.    ───────────────────────────────────────────────────────────────────────
  409.  
  410.    If you have any other problems/bug reports/suggestions I can be contacted 
  411.    via E-Mail at the following addresses :-
  412.    
  413.    2:441/80.3@fidonet
  414.    44:1000/80.3@chatnet
  415.    73:7440/80.3@ranet
  416.    bostick@popper.fidouk.fidonet.org
  417.  
  418.    .........or via snail mail :-
  419.  
  420.    Andy Williams / Peter Burnett
  421.    C/O Piston Popper Software
  422.    10 Parsons Close
  423.    St Leonards On Sea
  424.    EAST SUSSEX
  425.    UK         TN38 9QT
  426.  
  427.    If you have any other suggestions then drop me a line!!
  428.  
  429.    Thanks for using our program!
  430.  
  431.    Andy Williams & Peter Burnett - Authors of RADB2DAY
  432.  
  433.  
  434.