home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / telecomm / autoscan / read_me.1st < prev   
Text File  |  1989-05-06  |  12KB  |  238 lines
  1.                            *** GE_AutoScan ***  
  2.  
  3.                             by  Chris Mueller 
  4.  
  5.                                  05/07/89
  6.  
  7.           The following files should be included in this archive:
  8.  
  9.                              - READ_ME.1ST 
  10.                              - ATARIST.CAT
  11.                              - GE_AUTO.DO 
  12.                              - AUTO_ST.DO 
  13.                              - AUTOSCAN.MSG
  14.  
  15.       This is set of all-purpose do files I wrote for myself to simplify
  16. and speed up my time on GENIE. As of today I have tested the file as good
  17. as I could and it seems to work flawlessly. It runs at 2400 as well as
  18. 1200 baud, but is less problematic at the lower speed. Since I will be 
  19. leaving soon for a three month trip abroad (It's my honeymoon as well as
  20. a rest from my law school exams) I didn't want to hold back the file just
  21. because it might not be absolutley fool-proof yet.
  22.  
  23.       There might be still some minor problems if you don't have a decent
  24. access to GEnie or when GEnie is really slow, I didn't have the chance to
  25. test and correct those problems so if they creep up and you don't know 
  26. what to do, leave a message in the topic I created for GE_AutoScan and 
  27. I'm sure someone will help you out (usually it's only a matter of the
  28. right timeout value). If not, I will as soon as I get back to my computer.
  29.  
  30.     Nevertheless I'll post the usual legal disclaimer at this point :
  31.  
  32.            These files are released into the public domain. 
  33.            You may distribute them in any way you see fit as 
  34.            long as all files of this archive are included and 
  35.            proper credit is given.
  36.            No express and or implied warranty of any kind are given. 
  37.            You may use these files at your own risk.
  38.  
  39. Here are some of the potential problems that I know of :
  40.  
  41.       The file AUTO_ST.DO is very sensitive as to what comes across 
  42. the screen. Should some of the text have a lot of erroneous characters 
  43. because of line noise or GEnie changed some of the prompts or menu items 
  44. you will either have to readjust it or, if you have constantly bad noise 
  45. in the phone line, you're out of luck.
  46.  
  47.       Also, there is no way to guard against a (fairly uncommon)
  48. "Library or file is busy...sleeping" problem when you try to download
  49. files. A problem is slow system response when you try to download
  50. single files. The timeout values are designed to identify single from
  51. multiple file downloads and don't like it if GEnie takes too long.
  52. The only solution is to call at times when demand is low, which you can
  53. do by putting a >WT XX:YY:ZZ| statement at the beginning of GE_AUTO.DO. 
  54. This way you can let the computer call at three in the morning while you're
  55. asleep and get everthing done with les risk of an "Abort".
  56.  
  57.       If your receive tons of e-mail (more than 90 seconds worth), you 
  58. should adjust the time-out value before the script aborts.
  59.  
  60.       The rest of this documentation file is rather short and simple, 
  61. I hope that most user are familiar with the basics of the do file script 
  62. language and use of GSCAN so they can adjust their set-up accordingly. 
  63.                          
  64.  Before you can use GE_AutoScan, you will have to do some modifications.
  65.  
  66.  1.) If you haven't already done so, get GSCAN by Alan Page. It is in 
  67.      LIB 8, File #7854.
  68.      
  69.  2.) This is presently not a problem but if there should ever be more than
  70.      32 categories available, using GSCAN version 0.91 will force you to
  71.      edit the ATARIST.CAT file so that there are ONLY 32 categories 
  72.      listed, INCLUDING the last category :  99 GE_AutoScan 
  73.  
  74.      Make sure you do not eliminate any categories with topics that do 
  75.      have the IGN PER flag set to off or you will capture those messages
  76.      but they won't show up if you use GSCAN. Then replace the one you
  77.      currently use with it.
  78.  
  79.  3.) Put the file AUTOSCAN.MSG together with all other .MSG files you use
  80.      with GSCAN. It will allow you to send feedback to the RT sysops, send
  81.      e-mail letter and keep a GE Mail address book, create new topics as
  82.      well as sending replies to all topics. There is NO limit as to the
  83.      number of replies, letters etc. you create.
  84.  
  85.  4.) Have your GE settings as follows :  (page 905, item 2). 
  86.  
  87.                1. Prompt Character            63   (?)
  88.                2. Break Char. (0=True Break)   3   (Ctrl-C)
  89.                8. Page Length (# of lines)     0
  90.  
  91.      Also set your prompts to BRIEF while in the ST roundtable by typing 
  92.      PROMPT BRIEF while in the bulletin section (it will be permanent).
  93.     
  94.  5.) Load the file GE_AUTO.DO in the capture buffer of Flash and edit the
  95.      lines marked with **EDIT** according to your own set-up. Save it to 
  96.      your default path of Flash. If you plan to run the file from your 
  97.      dial directory, put the second file AUTO_ST.DO in a folder where all
  98.      your stuff from GEnie is. If not, you can merge the file at the 
  99.      appropriate place into GE_AUTO.DO. Then edit the file AUTO_ST.DO 
  100.      according to your own set-up.
  101.  
  102.  6.) I have my system set up as follows:
  103.       
  104.      - GE_AUTO.DO is in the default path of Flash  
  105.      - AUTO_ST.DO, ATARIST.CAT and AUTOSCAN.MSG are in a separate folder
  106.        "GENIE" together with GSCAN and other GEnie related material 
  107.      - Path for downloading is  separate
  108.  
  109.      GE_AutoScan expects all files to be in the path that is specified
  110.      at the first line of the GE_AUTO.DO file. It will save everything
  111.      according to that path unless specified otherwise. If you do change
  112.      the paths make sure to be consistent by preceeding every save, load,
  113.      open and kill command with the correct path name. 
  114.     
  115.  
  116.      Here is a short run-down of how GE_AUTOSCAN is working :
  117.  
  118.  1.) You can start it as a regular .DO file, but make sure that the >BA XX|
  119.      statement in GE_AUTO.DO corresponds with the node you're calling
  120.      (300/1200/2400 baud) if that node doesn't support all three baud
  121.      speeds. 
  122.  
  123.  2.) You can also start it using the dial directory with a @GE_AUTO.DO
  124.      designation appended to your entry.
  125.  
  126.  3.) GE_AutoScan will log on correctly to GENIE, using the HHH key-in.
  127.      It will check for the appropriate number of times you have previously
  128.      checked for new messages and files. Then it will increase the counter
  129.      by one, saving the next messages and files scan with the new number. 
  130.  
  131.      e.g. If you did one previous scan   : ST_NEW1.MSG 
  132.           the next scan will be saved as : ST_NEW2.MSG 
  133.     
  134.      GE_AutoScan allows up to seven scans before deleting them all and 
  135.      starting at #1 again. This way you can call daily, edit and merge all
  136.      messages and new files on Sunday and start again on Monday. You won't
  137.      loose all messages and new files that were captured during the week.
  138.  
  139.      You can edit this segement easily to increase that number (if you're
  140.      really lazy), but it might take too much time to load the GE_AUTO.DO
  141.      file when using it from the dial directory ---> by the time the file
  142.      is loading connection has already been established and there is only
  143.      about 3 seconds time to type in the HHH before the U#= propmt shows 
  144.      up. There is no problem however if you run it as a normal .DO file, 
  145.      the size of your hard disk will be your only limitation.
  146.  
  147.  4.) Then GE_AutoScan will load the file AUTO_ST.DO, which does all the
  148.      hard and dirty work for you. It will proceed to the RT bulletin
  149.      section, capturing and saving the GE and ST news-headings to separate
  150.      files (GE_NEWS.TXT and ST_NEWS.TXT) as well as check for any e-mail
  151.      letters you may have received.  
  152.  
  153.  5.) In the bulletin section it will first run the SETPERM.DO file if one
  154.      exists, setting the IGN PER flags to ON for topics you want to skip 
  155.      in the future.
  156.  
  157.  6.) Then it will check the ATARIST.LST file to see whether any replies,
  158.      feedbacks, e-mail or new topics have to be uploaded. If there are
  159.      any it will first do the new topics, then the replies and e-mail.
  160.  
  161.  7.) Then it will proceed to do a message scan using BRO NEW NOR, after
  162.      that it will check the new files library for newly uploaded files. 
  163.      Messages will be saved to ST_NEW?.MSG, files to ST_NEW?.LST. The ? 
  164.      will be set to a number according to the counter stand [see 3.)].
  165.  
  166.  8.) If you requested a download by creating a DOWNLOAD.DO file with
  167.      GSCAN, GE_AUTO will then try to get that file or files using YMODEM
  168.      1k size blocks. It can handle single files, multiple files as well 
  169.      as single 7bit text files and will create a log of your download as
  170.      GE_LOG.TXT. It could be that in a multiple file request one file is a
  171.      7bit file, GEnie will then skip it and proceed or a file is no longer 
  172.      available (make sure you have joined ALL libraries, sometime things
  173.      get shuffled around). You can check any discrepancies with the log to
  174.      see what went wrong with the download.
  175.  
  176.  9.) After downloading is complete, GE_AUTO.DO will send feedback if it
  177.      has been created.
  178.   
  179. 10.) If you have received e-mail, it will go and capture it in the
  180.      buffer, then save it to GE_MAIL.TXT.
  181.  
  182. 11.) At this point, the script is done. You're given the option to remain
  183.      on GEnie manually. If you do so, the default path and function keys
  184.      that have been set will remain intact. You can enter any appropriate
  185.      command RIGHT AT THE CURSOR LOCATION and GEnie will proceed.
  186.  
  187. 12.) If you don't, you will then be given the option to run GSCAN. If you
  188.      don't, GE_AutoScan will reload the original function key definitions
  189.      and Flash configuration files and end by loading any e-mail you may
  190.      have received into the capture buffer for quick reading.
  191.  
  192. 13.) If you decide to run GSCAN, you can prepare replies and files to
  193.      download by using the normal reply and DO file functions.
  194.      You can also create replies to topics that have no messages in the 
  195.      current scan, create e-mail and new topics by loading the file 
  196.      AUTOSCAN.MSG into GSCAN and following the instructions given in the
  197.      individual messages.
  198.  
  199. 14.) After you quit GSCAN, you can post all replies and mail and
  200.      download new files or quit alltogether. If you have mail to post or
  201.      files to get, GE_AutoScan will repeat the above steps in the same
  202.      sequence with some changes :
  203.        
  204.         - It will NOT capture the GE and ST news headings again.
  205.         - It will NOT scan for new messages and files.
  206.         - It WILL check for any mail that might have been sent in the
  207.           meantime and get it.
  208.  
  209.      You can force GE_AUTO.DO to do this simplified procedure when you run
  210.      it the first time by defining a fuction key with the statement
  211.      >$T "MORE"| and pressing the function key before you run GE_AUTO.DO. 
  212.  
  213. 15.) Error checking is very simple. Usually a timeout value of 45 to 60
  214.      seconds is given, if the WA command fails it will send a break
  215.      and ask you if you want to continue manually. If not, it will log 
  216.      off, saving the capture buffer as GE_ERROR.TXT, loading it into the
  217.      buffer and end the script.
  218.  
  219.  
  220. Well, this turned out to be longer than I wanted it to be. I hope I did
  221. not forget anything important, but I would think that once you have
  222. used the file for a while you will see how it works and how nice it is.
  223. Feel free to peek into the inner workings of GE_AutoScan and change it
  224. to accomodate your own personal needs. 
  225.  
  226. Since most RT are structured the same way, you can potentially create a 
  227. number of auto scripts, calling all your favorite RT's by using GE_AutoScan as a guide.
  228.  
  229. There will be a separate topic created for GE_AutoScan. Please let me know
  230. of any problems, ideas or comments. I will try to improve the file as much
  231. as possible as soon as I am back. And if you have any other .DO files for
  232. other BBS's like DELPHI, CIS or local bbs's, please share them with all
  233. Flash users.
  234.  
  235.                                             Happy bbs'ing
  236.  
  237.                                             Chris Mueller
  238.