home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / ftpmn12a.zip / ftpmon.txt < prev    next >
Text File  |  1996-10-11  |  13KB  |  255 lines
  1. FTPMon 1.2a for OS/2
  2.  
  3. DESCRIPTION
  4. ---------------------------------------------------------------------
  5. I wrote FTPMon so that I could scan the incoming directory of an
  6. anonymous FTP site and not have to look through a lot of old files
  7. to see what was new.  FTPMon maintains a list of all the files in the
  8. incoming directory of a site, but displays only those that you have
  9. not seen previously.  Once you see a file in the list, you can download
  10. it, view it, or tag it as boring.  Downloaded and boring files are
  11. removed from the list (but not, of course, the FTP site). They don't
  12. appear in the list again.  FTPMon will optionally refresh the list at a
  13. user-selectable frequency.  The user can also request an immediate refresh.
  14.  
  15.  
  16. COPYRIGHT AND DISTRIBUTION
  17. ---------------------------------------------------------------------
  18. See the file README.1ST for copyright and distribution information.
  19.  
  20.  
  21. HOW TO USE FTPMon
  22. ---------------------------------------------------------------------
  23. Install FTPMon according to the directions in README.1ST.  Double-
  24. click on the "FTP Monitor" program object to start FTPMon.  You may
  25. also enter the path and filename of a site file in the Parameters field
  26. of the settings notebook to start FTPMon with a specific site file.
  27.  
  28. _First time startup_
  29.  
  30. The first time you run FTPMon, you will see a Quickstart info... screen
  31. describing the next two dialogs you will see.  Click the OK button
  32. to continue.  You will then be asked for your e-mail address.
  33. The e-mail address is used to set your initial password for anonymous
  34. logins. You are then asked to create a site file.  A site file holds the
  35. information needed to connect to a specific site as well as the list of
  36. files you've already seen. You may create or switch to another site file
  37. by selecting the 'Open/Create' option from the 'File' menu.
  38.  
  39. After you pick the name and location of the site file to create, you
  40. are prompted to enter the site file parameters which, if you use
  41. your imagination, looks something like this (best when viewed with
  42. monospaced font):
  43.  
  44. .__________________________________________________________________.
  45. | Site file parameters                                             |
  46. |__________________________________________________________________|
  47. |                        ._____________________________.           |
  48. | Host name:             |                             |           |
  49. |                        +_____________________________+           |
  50. |                        ._____________________________.           |
  51. | Host directory:        |                             |           |
  52. |                        +_____________________________+           |
  53. |                        ._____________________________.           |
  54. | Username:              |anonymous                    |           |
  55. |                        +_____________________________+           |
  56. |                        ._____________________________.           |
  57. | Password:              |abbott@hiwaay.net            |           |
  58. |                        +_____________________________+           |
  59. |                        ._____________________________.           |
  60. | Download dir:          |G:\TMP                       |           |
  61. |                        +_____________________________+           |
  62. |                        .___________.__.                          |
  63. | Update interval:       | 1         |/\|   hours                  |
  64. |                        +___________+\/+                          |
  65. |                        .___________.__.                          |
  66. | Aging interval:        | 30        |/\|   days                   |
  67. |                        +___________+\/+                          |
  68. |                                                                  |
  69. | Get new list:          * when site file loaded                   |
  70. |                        O after update interval                   |
  71. |      .________.                                  .________.      |
  72. |      |   OK   |                                  | Cancel |      |
  73. |      +________+                                  +________+      |
  74. +__________________________________________________________________+
  75.  
  76. Most of the fields have defaults; all are required.  You will need to
  77. enter the name of the FTP site you want to monitor in the Host name field.
  78. For example, "hobbes.nmsu.edu".  You also need to enter
  79. the directory on the FTP site that you want to monitor in the Host directory
  80. field.  Do not include a leading '/'.  For example, "download".
  81. The username and password to log on to the site default to "anonymous"
  82. and your e-mail address, respectively. THE PASSWORD IS NOT ENCRYPTED
  83. IN THE SITE FILE.  IT IS NOT PROTECTED IN ANY WAY.  USE AT YOUR OWN RISK.
  84. The download dir defaults to the value of you TMP environment
  85. variable.  It should already exist -- FTPMon will not create the download
  86. directory.  The update interval specifies the time in hours between automatic
  87. queries for new files to the FTP server.  Specify 0 to disable
  88. automatic queries.  The Aging interval specifies how long should remember
  89. seeing a file in the FTP directory.  Aging the site file on a regular
  90. basis will keep down the size of the site file.  You can also specify
  91. whether or not FTPMon should query the FTP site immediately after loading
  92. the site file.
  93.  
  94. _Using FTPMon_
  95.  
  96. Once you enter the first time startup information, you will see the
  97. FTPMon main window.  It will look something like this (best viewed
  98. with a monospaced font and a good imagination):
  99.  
  100. .__________________________________________________________________.
  101. |\/| New Files - HOBBES                                            |
  102. |__________________________________________________________________|
  103. |File   Global                                                     |
  104. |__________________________________________________________________|
  105. |.________________________________________________________________.|
  106. ||                                                             |/\||
  107. ||                                                             |  ||
  108. ||                                                             |  ||
  109. ||                                                             |\/||
  110. |+________________________________________________________________+|
  111. |.________________________________________________________________.|
  112. || hobbes.nmsu.edu/incoming                                       ||
  113. |+________________________________________________________________+|
  114. | Download Directory                                               |
  115. |.________________________________________________________________.|
  116. || G:\TMP                                                         ||
  117. |+________________________________________________________________+|
  118. |.______________.         .______________.         .______________.|
  119. ||   Download   |         |     View     |         |   Boring!    ||
  120. |+______________+         +______________+         +______________+|
  121. |.________________________________________________________________.|
  122. ||                           Update Now                           ||
  123. |+________________________________________________________________+|
  124. +__________________________________________________________________+
  125.  
  126. The FTPMon window consists of the following parts:
  127.  
  128. (1) A File menu and a Global menu, which are described later.
  129.  
  130. (2) A list box.  The list box will eventually contain a list of files
  131. at an FTP site.
  132.  
  133. (3) An entry field.  The entry field contains the name of the
  134. FTP site you're interested in and the directory you want to
  135. monitor in the format <site>/<directory>.
  136.  
  137. (4) Another entry field, under the Text "Download Directory".  This field
  138. contains the drive and directory on your computer where you want the files
  139. you download to go.
  140.  
  141. (5) Four pushbuttons: Download, View, Boring!, and Update Now.
  142.  
  143. To download files in the list to the directory in the Download
  144. Directory entry field, highlight all the files in the list you want to
  145. download and push the Download button.  Multiple files may be selected
  146. via ctrl-click and (if the files are sequential) shift-click in the
  147. list box.  After downloading a file, it is removed from the list
  148. automatically.  You will not see those files in the list again.
  149.  
  150. To view files text files in the list, highlight the files you
  151. want to view and push the View button.
  152.  
  153. Both the Download and View buttons will display a progress indicator
  154. that shows how far along you are in terms of the number of files downloaded.
  155. For example, if you selected 5 files and clicked Download, after the
  156. third file is downloaded the progress indicator would show 3/5 = 60%.
  157. The progress indicator window also has a Stop button that will abort
  158. the current and all queued transfers.
  159.  
  160. To remove files from the list without downloading them, select the
  161. files you want to remove and push the Boring! button.  You will
  162. not see those files in the list again.
  163.  
  164. To update the list by re-scanning the FTP site, push the Update Now
  165. button.  FTPMon will then connect to the FTP site, get a list of files
  166. in the desired directory, disconnect from the FTP site, and update the
  167. list.  Note that updating the list involves adding files that you have
  168. never seen to the list as well as removing files from the list that
  169. are no longer there.  **If a file was removed from the list because
  170. you downloaded it or because you said it was Boring!, it will NOT
  171. reappear.**
  172.  
  173. The list is updated automatically at the frequency you
  174. specified in the Site file parameters window.
  175.  
  176. _The File menu_
  177.  
  178. The File menu has three items:
  179.  
  180. (1) Open/Create...  This option allows you to create or to switch to
  181. another site file.  All information for the current file is saved
  182. before opening the new file.
  183.  
  184. (2) Parameters...  This option redisplays the Site file parameters
  185. window and lets you make changes.
  186.  
  187. (3) Age... Aging a site file means removing old 'downloaded' and
  188. 'boring!' entries from it.  Aging took a long time in version 1.0
  189. of FTPMon.  It is quick now.
  190.  
  191. _The Global menu_
  192.  
  193. The Global menu has two items:
  194.  
  195. (1) Email (email address)...  This option allows you to change what FTPMon
  196. uses for your e-mail address.  The current setting for your e-mail address
  197. is displayed.
  198.  
  199. (2) Viewer... This option allows you to set the program started to
  200. View files.  The default is 'E', the OS/2 system editor.  If you specify
  201. '*', the file will be viewed with the default open action for a file of
  202. that type.  In other words, if you have PMJPEG associated with '*.GIF',
  203. viewing a GIF file will start PMJPEG.
  204.  
  205. (3) Cleanup TMP on exit... FTPMon stores the Viewed files in the user's
  206. TMP directory.  If this option is enabled, FTPMon will attempt to delete
  207. all the Viewed file for this session when it exits.  If you want to
  208. save some Viewed files, be sure to move them from the TMP directory
  209. before exiting FTPMon.  Possible reasons FTPMon might be unable
  210. to delete a viewed file include (1) the user might have moved the
  211. file to save it, and (2) the user might still be viewing the file.
  212.  
  213. KNOWN BUGS/LIMITATIONS
  214. ---------------------------------------------------------------------
  215. FTPMon has these limitations:
  216.  
  217. (1) Filenames are case sensitive.  If a file appears on the site twice,
  218.     once uppercase and once lowercase, the file will appear in the list
  219.     twice.
  220.  
  221. (2) Only a file's name is used when desiding if a file has been in
  222.     the list before.  If a file is uploaded to the FTP site, made Boring!,
  223.     removed from the FTP site, and another file with the same name is
  224.     uploaded to the FTP site, it will not appear in the list.  Aging the
  225.     site file should help lessen this problem.
  226.  
  227. (3) When the viewer is E.EXE, it opens in the background.
  228.  
  229. POSSIBLE ENHANCEMENTS FOR FUTURE VERSIONS
  230. ---------------------------------------------------------------------
  231. The following is a list of enhancements that may appear in future
  232. versions of FTPMon.  If you have any other ideas for enhancements,
  233. please e-mail them to abbott@hiwaay.net.
  234.  
  235. (1)     Rather than deleting a file from the list after the user
  236.         downloads the file or selects "Boring!", leave the file in the
  237.         list but change the color.
  238.  
  239. (2)     Add "View Group" option to download all selected files, concatenate
  240.         them together, and view them as a single file.
  241.  
  242. (3)     Add "Download all" option to dowload all files in the list.
  243.  
  244. (4)    Add a hands-off mode where FTPMon automatically downloads
  245.     any new files.
  246.  
  247. (5)     Display/sort based on file size, file date, etc.
  248.  
  249. Number 5 is probably the most requested.  It is unfortunately also the most
  250. difficult by far.  For those interested, the problem involves the format
  251. of the data returned by FTP servers.  I am currently requesting directory
  252. listings in LS format, which includes the filename only.  The DIR format,
  253. which includes the other information, is unfortunately not the same with
  254. all servers. 
  255.