home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / bbs / scanr104 / scanr104.doc next >
Text File  |  1989-10-19  |  8KB  |  212 lines
  1.  
  2.                              >>> SCANNER! <<<
  3.                     BBS Express! ST Online Program Utility
  4.  
  5.                                version 1.04
  6.                              by Dave Stelljes
  7.  
  8.                                  9-19-89
  9.  
  10.                           original date: 8-11-89
  11.  
  12.  
  13.  
  14.  
  15. >>> INTRODUCTION
  16.  
  17.      This  program allows the users on your system to view other users  on 
  18.      various search fields.  If a user desired to see all the other people 
  19.      on  the system from CAlifornia,  he could do just that- or any  other 
  20.      state  for  that matter.   He can also "see" all other users  on  the 
  21.      system that has an ATARI ST (or other computer) if he wanted.
  22.  
  23.      The  program  is  an External program that is called  from  the  bbs; 
  24.      either from a menu key- or a script file.
  25.  
  26.  
  27.  
  28. >>> NEW FEATURES FOR VERSION 1.04
  29.  
  30.     - Auto Set-Up (just run and .INFo file is automatically created!)
  31.     - Access info is written to call-log when user executes Scanner!
  32.  
  33.  
  34. >>> FEATURES
  35.  
  36.       * STATUS INDICATOR
  37.           A  local  status indicator will show the sysop if  the  mode  of 
  38.           operation is either LOCAL or ONLINE.   The indicator appears  at 
  39.           the bottom of the screen- on the left side.
  40.  
  41.       * TIME OUT
  42.           A time-out feature prevents the system from being tied up if the 
  43.           user  does not select any options after about 2  minutes.   When 
  44.           the time expires, control is turned back over to the bbs.
  45.  
  46.       * CARRIER DETECT
  47.           The modem's CARRIER DETECT is constantly monitored.   If a  user 
  48.           were  to  drop  carrier (hang up) while  in  this  program-  the 
  49.           software will see this- and abort.
  50.  
  51.       * SYSOP TERMINATE
  52.           The  sysop  can  force the termination of  the  user  online  by 
  53.           pressing the SHIFT Key at the same time with the F-10  Key.   As 
  54.           with the BBS,  this will hang-up the user so you can do whatever 
  55.           it is you must do!
  56.  
  57.       * PAUSE/ABORT
  58.           While  user is reading text,  pressing ^S will pause  the  text.  
  59.           Pressing  ^S again- or ^Q will resume the text  dump.   Pressing 
  60.           either ^X or ^C will abort the text dump.
  61.  
  62.  
  63.  
  64. >>> SET-UP
  65.  
  66.      You  need to define a menu key to activate this program- or  you  can 
  67.      have a script execute it like this:
  68.  
  69.          TOS 'D:\SCANNER.TOS'
  70.  
  71.  
  72.      You no longer have to create a file called SCANNER.INF... the program 
  73.      automatically does this for you!   In older versions it was necessary 
  74.      for  the sysop to create the file- and provide the userlog  filepath.  
  75.      NOTE:  When you run SCANNER!,  make sure your computer is in the  bbs 
  76.      configuration.  This will insure SCANNER! can access all needed files 
  77.      from the appropriate drives.
  78.  
  79.      The  SCANNER.INF file will be created to insure fast operations  each 
  80.      time SCANNER! is run.  The FIRST time SCANNER! is run- it will create 
  81.      the .INFo file (on the root drive SCANNER! is located on).  Each time 
  82.      thereafter SCANNER!  is run- it will load in the SCANNER.INF file and 
  83.      continue on with normal operations.
  84.  
  85.  
  86.  
  87.  
  88. >>> USING THE PROGRAM
  89.  
  90.      There  are  5  different  fields a user can  search  on  (4  in  this 
  91.      version).  Here they are:
  92.  
  93.           - Search On User NAME
  94.           - Search On User NUMBER
  95.           - Search On STATE
  96.           - Search On COMPUTER Type
  97.           - Search On Time/Date  (in later versions)
  98.  
  99.  
  100.      When  information  is  being shown- the user  can  pause  viewing  by 
  101.      pressing  CONTROL-S.   To  resume viewing once again,  he  can  press 
  102.      CONTROL-S or CONTROL-Q.   If the user wanted to abort the  operation- 
  103.      he could merely press CONTROL-X or CONTROL-C.
  104.  
  105.  
  106.    * SEARCH BY NAME.
  107.  
  108.      This  allows  the user to search for a user by  name.   If  the  user 
  109.      exists,  it will show his number,  name, type of computer, state, and 
  110.      last date called.
  111.  
  112.      One nice feature is the user can also search with wildcards.   If  he 
  113.      wanted  to  view all the users on the system that had DA  in  it,  he 
  114.      would  merely  type  'DA*'   and he would be  shown  all  names  that 
  115.      contained DA.   If you do not include the '*' in the end of the line, 
  116.      it will search for an EXACT field.   An asterix alone would show  ALL 
  117.      the users on the system.
  118.  
  119.      The name field that is searched on is actually the Alias name of  the 
  120.      user.   This protects his identity on the system, and allows searches 
  121.      as the names appear to all others.
  122.  
  123.  
  124.    * SEARCH BY NUMBER.
  125.  
  126.      Any  user on the system can be viewed by entering his  number.   Only 
  127.      valid number ranges are accepted.
  128.  
  129.  
  130.    * SEARCH BY STATE.
  131.  
  132.      The user can enter any state he wishes.   All users in that state are 
  133.      then  shown- if there are any.   Invalid state abbreviations are  not 
  134.      allowed, thus preventing a useless search.
  135.  
  136.  
  137.    * SEARCH BY COMPUTER.
  138.  
  139.      This  allows  a  person  to view all the  users'  with  a  particular 
  140.      computer  system.   There  are 9 defined computer systems  to  choose 
  141.      from,  and  a "OTHER" category that includes all  other  non-defined 
  142.      computers.   The  program  has  a  built-in  "name  recognizer"  that 
  143.      identifies  the various computer types.   Although the recognizer  is 
  144.      not perfect,  it does identify most computer types before classifying 
  145.      them as "OTHER".
  146.  
  147.      The problem with trying to determine computer-types with BBS Express! 
  148.      is that the name of the computer-type is defined by the user;  he can 
  149.      use  ANY  name  that he wants.   It would have been  much  nicer  had 
  150.      Express!  defined the system types- and allow the user to select  the 
  151.      computer-type he had from a menu.
  152.  
  153.  
  154.    * SEARCH BY TIME/DATE.
  155.  
  156.      This  feature  is not complete yet,  however,  but here  is  a  brief 
  157.      summary.  This  function will allow a person to show the  users  that 
  158.      have   called  within  a  certain  time-frame:   over  a  period   of 
  159.      hours,days,weeks, months and even years.  The range of search will of 
  160.      course  be limited to the time the bbs was started until the date  at 
  161.      present.
  162.  
  163.  
  164.  
  165. >>> FURTHER NOTES
  166.  
  167.      In the event the program does run across an error,  it will show  you 
  168.      the number and the program will abort.  Some possible things to watch 
  169.      for  are to make sure the program is run from the bbs  configuration.  
  170.      If SCANNER!  can not get at the USERLOG.DAT file,  then there will be 
  171.      trouble, of course.
  172.  
  173.      If you had earlier versions of SCANNER!  (1.03 and less),  make  sure 
  174.      you trash the SCANNER.INF file.  The new versions will try to read it 
  175.      in,  along  with  additional info that is not in that  file-  and  an 
  176.      error will occur.
  177.  
  178.  
  179.      I  have  developed some new routines in this program that I  did  not 
  180.      currently  have in my library of sub-routines.   One major routine  I 
  181.      wrote  was  the  modem  handler.
  182.  
  183.      After developing the handler,  I also began writing some routines for 
  184.      a  bbs  program,  and it has also turned out to be  quite  promising!  
  185.      (BBS Express!, watch out!)
  186.  
  187.  
  188.  
  189.  
  190. >>> CONCLUSION
  191.  
  192.      All ideas,  suggestions,  donations and comments are welcomed at  the 
  193.      below address.   Feel free to write & or call voice.   WESTAR BBS  is 
  194.      still  not back up at this time...  but I hope to have it back up  by 
  195.      December '89!
  196.  
  197.      Please make notes on any ERRORS you may encounter,  so you can inform 
  198.      me of them.  Also- make notes on any IDEAS you may have, so it can be 
  199.      integrated into the future versions.
  200.  
  201.  
  202.      Please call or write:
  203.  
  204.                             Dave Stelljes
  205.                             3008-B Pisgah Place
  206.                             Greensboro, NC  27408
  207.      
  208.                             (919)282-8022  Voice
  209.  
  210.      Thanks.
  211.  
  212.