home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / RADB_400.ZIP / RADB2DAY.DOC < prev    next >
Encoding:
Text File  |  1993-10-10  |  16.9 KB  |  411 lines

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