home *** CD-ROM | disk | FTP | other *** search
/ Beijing Paradise BBS Backup / PARADISE.ISO / software / BBSDOORW / FDBBS102.ZIP / FDBBS.DOC < prev    next >
Encoding:
Text File  |  1995-03-13  |  9.1 KB  |  187 lines
  1.  
  2.                   FD Last BBS Call (FDBBS) Version 1.02
  3.  
  4.                      for Frontdoor and Remote Access
  5.  
  6.              Copyright (C) 1995 Donald Kerr 2:259/88@fidonet
  7.  
  8.                          Released 13th March 1995
  9.  
  10. ┌──────────────────────────────────────────────────────────────────────────┐
  11. │ ▒▒▒▒ Introduction ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  12. └──────────────────────────────────────────────────────────────────────────┘
  13.  
  14.  FD Last BBS Call (FDBBS) is a program which alters the details displayed
  15.  on Frontdoor's main mailer screen to include those of your last Remote
  16.  Access BBS call.  These details include the caller's name, location, date,
  17.  time, number of calls, connect speed, node number and time on in minutes.   
  18.  
  19.  Frontdoor's INBOUND.HIS (Alt-I) file is appended with the above details
  20.  along with the callers upload/download details.
  21.  
  22.  Number of Calls, connect speed, node number and time on are stored in the 
  23.  space normally occupied by the incoming call's mail node number.   You can 
  24.  expect to see something similar to "14:28800/1.12" for a caller who has 
  25.  called 14 times, connected at 28800 on Node 1 and who has been using your 
  26.  BBS for 12 minutes.
  27.  
  28.  FDBBS was designed to be run as part of you 'after call' BBS maintenance 
  29.  i.e. as part of your BBS batch file.  An example is given later in this 
  30.  document.
  31.  
  32. ┌──────────────────────────────────────────────────────────────────────────┐
  33. │ ▒▒▒▒ Disclaimer ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  34. └──────────────────────────────────────────────────────────────────────────┘
  35.  
  36.  I am responsible for nothing!   The program has been throughly tested and 
  37.  should present no problems when used as described.   
  38.  
  39. ┌──────────────────────────────────────────────────────────────────────────┐
  40. │ ▒▒▒▒ Installation ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  41. └──────────────────────────────────────────────────────────────────────────┘
  42.  
  43.  Installation is straightforward.   Just unzip the file FDBBS.ZIP to a
  44.  directory of your chosing e.g. "C:\FDBBS".   See 'Distribution' below for
  45.  a list of files included in the archive.
  46.  
  47. ┌──────────────────────────────────────────────────────────────────────────┐
  48. │ ▒▒▒▒ Operation ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  49. └──────────────────────────────────────────────────────────────────────────┘
  50.  
  51.  Usage "FDBBS" + "?", "REG", "T", "NOHIDE", "NOHIS" or "BBS=xxx"
  52.  
  53.  Simply type "FDBBS" without parameters to have Frontdoor display the last 
  54.  BBS call details on Frontdoor's main screen.   This will by default do the 
  55.  following:-
  56.  
  57.  If a caller is not flagged as 'hidden' (see the user's record in USERS.BBS),
  58.  then FDBBS will display the caller's name, location, date and time on in
  59.  Frontdoor's main mailer screen.   The Node number will comprise of the 
  60.  user's number of calls, connect speed, node number and time on in minutes.
  61.  You can expect to see something similar to "14:28800/1.12" for a caller who 
  62.  has called 14 times, connected at 28800 on Node 1 and who has been using 
  63.  your BBS for 12 minutes.
  64.  
  65.  Frontdoor's INBOUND.HIS (Alt-I) file is appended with the above details
  66.  along with the callers upload/download details:-
  67.  
  68.  Sent = Total number if kilobytes that the user has downloaded.
  69.  Rcvd = Total number if kilobytes that the user has uploaded.
  70.  Cost = Total number if kilobytes that the user has downloaded today.
  71.  
  72.  Now for the command line parameters.
  73.  
  74.  "FDBBS ?" will display a help screen and "FDBBS REG" will give 
  75.  registration information.   See below for more details on registering.
  76.  
  77.  The following command line parameters can be run in any order or in any 
  78.  combination:-
  79.  
  80.  "T" - Specifying this will cause FDBBS to display details ONLY when a 
  81.  caller has logged off within one minute of FDBBS being run.   This stops
  82.  FDBBS from altering details every time that it is run.   I have noticed 
  83.  that new users who log off after completing Remote Access' default 'new 
  84.  user' questionairre but before completing any 'new user' questionairre 
  85.  that you have configured do not appear in your USERS.BBS file (as if they 
  86.  never called).   Without the "T" parameter, FDBBS would have recalculated 
  87.  the previous users times and displayed those details as if he/she had 
  88.  called again.   I use this parameter on my own BBS.
  89.  
  90.  "NOHIDE" - This will cause every user who calls to be displayed on the
  91.  screen whether or not their record in USERS.BBS is flagged as hidden or 
  92.  not.   If it is just local/keyboard users that you don't want to display
  93.  then you should configure your BBS batch file so that it doesn't run FDBBS 
  94.  after local calls e.g. "IF %1==1 THEN GOTO MAINTAIN" where "%1" is the 
  95.  node number passed to your BBS batch file as a command line parameter and
  96.  maintain is the area of the batch file that runs FDBBS and other 'after 
  97.  call' utilities.
  98.  
  99.  "NOHIS" - This option will display the caller's details on screen but will 
  100.  not append them to the file INBOUND.HIS.
  101.  
  102.  "BBS=xxx" - This allows you to specify a word or symbol to appear as a 
  103.  prefix to the caller's name. I have this specified as "BBS=BBS_-" for my
  104.  own system.  If Joe Bloggs calls his name appears as "BBS - Joe Bloggs".
  105.  This makes it easy to differentiate between mail and human callers.
  106.  Notice that under-scores are translated into spaces and a space is 
  107.  automatically added to the end of the word you specify.
  108.  
  109.  Ideally, FDBBS should be run from your BBS batch file.   Just add the
  110.  following lines to your batch file as part of your 'after call' 
  111.  maintenance:-
  112.  
  113.  REM -----------------------------------------
  114.  C:
  115.  CD\FDBBS
  116.  FDBBS T BBS=BBS_-
  117.  REM These are the command line parameters that I use
  118.  REM -----------------------------------------
  119.  
  120.  The following lines are required in your AUTOEXEC.BAT file to allow FDBBS
  121.  to locate the files LASTCALL.FD and LASTCALL.BBS :-
  122.  
  123.  "SET FD=C:\FD" where "C:\FD" is the location of the file LASTCALL.FD.
  124.  "SET FD=C:\RA" where "C:\RA" is the location of the file LASTCALL.BBS.
  125.  
  126.  Please note that I have included a small utility called DELINHIS.EXE
  127.  which will delete a given record number from the file INBOUND.HIS.   Just 
  128.  specify the record number to be deleted as a command line parameter. i.e.
  129.  to delete record number 12 just type "DELINHIS 12".   To find the record 
  130.  number of the entry that you want to delete, from Frontdoor's main mailer 
  131.  screen press ALT-I then enter.   The record number will be at the top left 
  132.  in braces e.g. "[12]".   This will allow you to test FDBBS and configure it
  133.  the way in which you want before returning the INBOUND.HIS file to how it
  134.  was before you started.
  135.  
  136. ┌───────────────────────────────────────────────────────────────────────────┐
  137. │ ▒▒▒▒ Distribution ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  138. └───────────────────────────────────────────────────────────────────────────┘
  139.  
  140.  You are encouraged to copy this program and share it with others.  If you
  141.  can personally pass this program to another BBS I would be most grateful.
  142.  
  143.  Please ensure that the archive contains the following files:-
  144.  
  145.         DELINHIS.EXE - Delete individual records from INBOUND.HIS
  146.         FDBBS.DOC    - This documentation file.
  147.         FDBBS.EXE    - The main program.
  148.         FILE_ID.DIZ  - A description file.
  149.  
  150. ┌──────────────────────────────────────────────────────────────────────────┐
  151. │ ▒▒▒▒ Registration ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  152. └──────────────────────────────────────────────────────────────────────────┘
  153.  
  154.  Registration is not a requirement for non-commercial sites but would be 
  155.  appreciated if your financial situation permits.   Commercial sites must
  156.  register if they use this utility in any regular way i.e. as part of an
  157.  'after call' maintenance routine.   Non-commercial sites may send a
  158.  postcard of their home town as an alternative to the registration fee.
  159.  
  160.  The cost of registering is only five UK pounds/10 US dollars or equivalent.
  161.  
  162.  Send your registration fee to - Donald Kerr
  163.                                  2 Rowans Gardens
  164.                                  Bothwell
  165.                                  Glasgow G71 8BE
  166.                                  United Kingdom
  167.  
  168.  The use of other small utilities written by the author is included in the 
  169.  fee.
  170.  
  171. ┌──────────────────────────────────────────────────────────────────────────┐
  172. │ ▒▒▒▒ Support ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  173. └──────────────────────────────────────────────────────────────────────────┘
  174.  
  175.  Help is available by Netmail from the Fidonet address 2:259/88   A short 
  176.  list of other programs written by the author may be freqed as "PROGS" from 
  177.  the same address, or you may call the Firelink BBS on +44-1698-854685 and 
  178.  download the File "PROGS.TXT".
  179.  
  180. ┌──────────────────────────────────────────────────────────────────────────┐
  181. │ ▒▒▒▒ Ideas? ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  182. └──────────────────────────────────────────────────────────────────────────┘
  183.  
  184.  If you have any ideas for short utilities connected with Comms or BBS then 
  185.  please let me know.
  186.  
  187.