home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / telecomm / flashdl3 / flashdl3.doc next >
Encoding:
Text File  |  1987-12-02  |  10.4 KB  |  224 lines
  1.  
  2.                              FLASHDL3.PRG
  3.  
  4.                 Flash Auto-Batch Download DO File Generator
  5.  
  6.                               Version 3.0
  7.                              By Jinfu Chen
  8.                              November 1987
  9.  
  10.  
  11.     I. What is this program for and who should use it?
  12.  
  13.         FLASHDL is a program to allow you create a DO file to download
  14. several files from either GEnie or CompuServe automatically without human
  15. intervention. Obviously you must own a copy of Flash!, the utimate
  16. tele-communication program for the Atari ST.
  17.  
  18.         You might say "Hey, all my friends are using Interlink, who cares
  19. Flash anyway!". Yes, Interlink is very easy to use for inexperienced users,
  20. but at least one thing it cannot do: to download serveral files from a
  21. commercial service like GEnie or CompuServe automatically. The 'record'
  22. function only let you do what you have done already.
  23.  
  24.         Enough for bad-mouthing Interlink. Let me explain a little more on
  25. what this program can do and cannot do. For those who use FLASHDL2.PRG
  26. before you can skip the next couple paragraphes.
  27.  
  28.         It is a very common that you browse through GEnie or CIS several
  29. times a week and find out there are some files you want to download. The
  30. simple way is to sit down in front of the computer and download one by one,
  31. and probably watch that silly  "nnn Blocks"   status line for the whole
  32. night. You may say "I really should learn something about the DO file and
  33. create one to free myself from this!". Well, even you are an expert of DO
  34. file, you still have to edit a DO file everytime which is what I did
  35. before and I really did not like it.
  36.  
  37.         Now how about a program that will just prompt you to enter
  38. filenames which you want to download and create the DO file for you? This is
  39. exactly what my program for. All you have to know is a list of filenames
  40. in one of the service (in case of GEnie, file number is preferred). The best
  41. way is to write down the filenames/numbers in a piece of paper and then
  42. just double click FLASHDL3.PRG. The program will prompt you to enter file
  43. names/numbers. Once it is done go back to Flash and hold down the Alternate key
  44. and key 'A', select the DO file you just create and go to do whatever you want.
  45. The DO file will call the service, download all the files you want and log off
  46. by itself. Or you can run the DO file before going to bed and the files will be
  47. ready when you wake up next day.
  48.  
  49.     II. How to use the program?
  50.  
  51.         Double click FLASHDL3.PRG and walk through the menu.
  52.  
  53.     III. Is that all?
  54.  
  55.         Yes, I believe the program is simple enough to be used and there
  56. is even a HELP menu. However, several things need to be explained here in
  57. order to use all the features of the program.
  58.  
  59.     1) FLASHDL.DEF file.
  60.         This is a file contains some data so that you do not want to enter
  61. everytime when you use the program. Such as the telephone number of the
  62. GEnie or CompuServe, your user ids and passwords, and some customized
  63. initialization data(explained later). When you first time run the program,
  64. the program will create this file for you if you just click the OK button.
  65. All the information entered will be saved when you select the 'QUIT' item
  66. from menu.
  67.  
  68.         Since this file contains some vital information(user id and
  69. password), you are responsible to protect your account by not showing this
  70. file to anyone else.
  71.  
  72.     2) Initialization data.
  73.         Once you have created the FLASHDL.DEF file, you can use a
  74. word/text editor(FLASH's capture buffer is an excellent one) to examine
  75. the file. The first line is the version number which you should not change.
  76. The second line will look like this:
  77.  
  78.  >BA 1200|>ST ON|>TR OFF|>SB 1|>PY NONE|>XM 8 C R|>MO AT|>CA ON|
  79.  
  80.         This line will be appeared at the first line of the DO file you
  81. create. It is for initializing some parameters before calling GEnie or CIS.
  82. In case you do not remember what they mean, here is the explainations:
  83.  
  84.      Baud rate       : 1200
  85.      Strip bit       : On
  86.      Stop bit        : 1
  87.      Parity          : None
  88.      Translation     : Off
  89.      Xmodem          : 8 bit, CRC, 128 block
  90.      Monitor         : Atari (VT52)
  91.      Capture         : On
  92.  
  93.         Now you might want to change some of these parameters, for example
  94. the baud rate if you are in the fast lane. It is easy, just change what ever
  95. you like or add any legal FLASH commands to this line, and save the
  96. FLASHDL.DEF file. Next time the program will read this line and append it
  97. the DO file.
  98.  
  99.         In case of using CompuServe, the program will add a command to
  100. switch terminal type to Vidtex(tm) mode so no need to change the terminal
  101. type in the initialization.
  102.  
  103.  
  104.     3) Error trapping.
  105.  
  106.         The third line in the FLASHDL.DEF file is for those who have newer
  107. version of Flash(the latest at this writting is 1.5). Initially it will
  108. look like this:
  109.  
  110. >L: ERROR|>HG|>B2|>AL "[3][ Service timeout | Fatal error ][ OK ]"|
  111.  
  112.         It is used for error trapping when something goes wrong during the
  113. download session, such as non-existed file(wrong name or file being
  114. removed), or incorrect response from the service. You can change anything in
  115. this line except the first 10 charaters( >L: ERROR| ) since the label
  116. command is needed for the DO file.
  117.  
  118.         To understand what this line for and how you can modify it, we
  119. need to explain how a DO file generated by this program works.
  120.  
  121.         Basically, the DO file is a script of commands and some text to be
  122. sent to the modem. It is heavilly depends on what responses the service
  123. sends to your terminal. Any garbled characters from the service or wrong
  124. response will cause Flash not execute next command in the DO file. In the
  125. older version of Flash(pre-1.5), this will cause Flash waits forever until
  126. YOU hit the undo key to abort the session.
  127.  
  128.         In Flash version 1.5 and later, the 'wait' command has a timeout
  129. option so that if something goes wrong the DO file can jump to somewhere
  130. else. In our case, it will jump to the last line of the DO file which is the
  131. same as the one in FLASHDL.DEF. The way I handle error is to use the command
  132. >HG|(hangup). However, it may not work for all the modems as the command
  133. HANGUP toggles the Data-Terminal-Ready(DTR) line -- RS232C pin 20. There
  134. are several reasons your modem may not work with this command: the  modem
  135. cable does not connect pin 20, your modem does not support DTR toggle
  136. mode(there is no such thing as 100% compatible!), or the DIP
  137. switch/S-register is set to ignor DTR the line(most common setup).
  138.  
  139.         To determine if the HG command works in your modem, hit the INSERT
  140. key to enter the command mode in Flash and type HG <CR>(return) and see if
  141. the TR light(if you have one!) on the modem change or not( it may be just a
  142. flash), or call up a local BBS and wait until connection is made, then enter
  143. the command to see if you can hangup the modem(no hate-mail from sysops
  144. please).
  145.  
  146.         Chances are most of the modems support this command but you may
  147. not be in the right setting. Check the modem manual for further
  148. information.
  149.  
  150.         If you can not find a way to use the HANGUP command, you can
  151. either change the command to the +++ escape sequence and send a ATH to the
  152. modem to disconnect. It will look like this:
  153.  
  154. >L: ERROR|+|>PA 1|+|>PA 1|+|>WA OK|ATH|>B2|>AL...
  155.  
  156.         or just the B2 command(ring the bell continousely) to get your
  157. attention. The AL command just put an alert box on screen(see the DOC file
  158. in 1.5).
  159.  
  160.  
  161.     IV. Some most asked questions or questions you may ask:
  162.  
  163.     1. The DO file did work and it just hung in waiting the U#=
  164. prompt(GEnie login prompt), is anything wrong with the program?
  165.  
  166.     A: Nope, I use the program all the time and so do some other people.
  167. It could be a bad connection or something wrong with GEnie(it dropped me
  168. several times during a conference or download) or your local telephone
  169. company. Just abort the DO file and try it again. With Flash 1.5 or later,
  170. the DO file will hangup for you(see above).
  171.  
  172.     2. When I use the DO file to download some files, one of them was
  173. removed and the program hungup in the middle, your program does not work!
  174.  
  175.     A: Yes, but that is not my fault. Remember a DO file is a sequence of
  176. wait-something-and-do-something. If the service does not response precisely
  177. what we want, there is no way the DO file will think for you. A computer is
  178. a really dumb kid when thinking is involved. Again, in version 1.5 this is
  179. handled much better.
  180.  
  181.     3. The DO file aborted even nothing goes wrong and I get the timeout
  182. alert box(in this version), what is wrong with it?
  183.  
  184.     A: The timeout value I use is 90 seconds for each prompt which I think
  185. long enough for any reasonable connection. If you can not get a response
  186. from the service within a minute, chances are the service is in very heavy
  187. loading condition and not good for downloading! Just try in other less used
  188. time such as early morning in conjunction with the WTIME command.
  189.  
  190.     4. The download was bombed because disk is full.
  191.  
  192.     A: It is your responsibility to estimate how many files you can stuff
  193. into one disk when creating a DO file. Try to make a download session no
  194. more than twenty files. In this version the program will force you stop
  195. when more than fourty filenames are entered. When you enter the filenames
  196. there is a total file counts in the dialog box to remind you.
  197.  
  198.     5. Where are the files will be stored when using your program?
  199.  
  200.     A: The default directory set by Flash. Usually it is the same as the
  201. one the program Flash resides. You can change this to anywhere before
  202. running the DO file(highly recommanded).
  203.  
  204.     6. Can I use the program to create a DO file to download files from the
  205. MichTron RoundTable at GEnie or the Atari Developer SIG at CompuServe?
  206.  
  207.     A: Yes, but you will need to make some change. First create the DO file as
  208. what you would do usually, then use a text editor to edit the DO file. In case
  209. of the MichTron Roundtable at GEnie, change the number 476 right after your
  210. password to 491. In case of the Atari Developer SIG, change the string "go
  211. atari16" to "go ataridev".
  212.  
  213.     This ends the lengthy doc file. I am working on an accessory version of
  214. the program but it is in low priority now, unless there are popular requests.
  215. If you have any question or request, send me an E-Mail to either CompuServe
  216. or GEnie:
  217.  
  218. CompuServe:      72327,2434
  219. GEnie:           J.CHEN
  220. USENET:          Jinfu_Jinfu_Chen@cup.portal.com
  221.  
  222.  
  223.  
  224.