home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac_os2 / vxftp041.zip / README < prev    next >
Text File  |  1994-06-05  |  7KB  |  163 lines
  1. last updated June 5, 1994
  2.  
  3.                       /* **************************** *
  4.                        *                              *
  5.                        *          V x F T P           *
  6.                        *             beta             *
  7.                        *                              *
  8.                        *      by Howard T. Hyten      *
  9.                        *    hhyten@mail.utexas.edu    *
  10.                        *                              *
  11.                        * Multi-threaded FTP for OS/2  *
  12.                        *                              *
  13.                        * **************************** */
  14.  
  15. SINCE VxFTP INCLUDES NO 'HELP' SYSTEM AT THIS TIME, YOU SHOULD READ
  16. THIS README FILE FOR AN EXPLANATION OF HOW TO USE IT.
  17.  
  18. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=--=-=-=-=-=-=-=-=-=-=-=-=-
  19. INSTALLATION:
  20.  
  21. Execute INSTALL.CMD to install VxFTP properly. The install process
  22. will add  VROBJ.DLL to your OS2\DLL directory and RXFTP.DLL to your
  23. TCPIP\DLL directory. It will also create a VxFTP program object on
  24. your Desktop.
  25.  
  26. Requirements: You must have IBM TCP/IP for OS/2, either 1.2.1 or 2.x,
  27. installed on your machine.
  28.  
  29. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=--=-=-=-=-=-=-=-=-=-=-=-=-
  30. UPDATES:
  31.  
  32. If you'd like notification of updates to VxFTP, send mail to
  33. hhyten@mail.utexas.edu to add you to the Update mailing list.
  34.  
  35. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=--=-=-=-=-=-=-=-=-=-=-=-=-
  36. USING VxFTP:
  37.  
  38. Start VxFTP as you would any other OS/2 PM application, either from the 
  39. command line or by double-clicking its object somewhere on the desktop.
  40. (The installation program creates a WorkPlace Shell object for you.)
  41.  
  42. Once VxFTP loads, a dialog box appears for you to enter the remote host's
  43. name (or IP address), the logon account and password you want to use, and,
  44. optionally, the directory on the remote host you want to change to upon
  45. logging in. 
  46.  
  47. You can also provide command-line parameters in the form of:
  48.  
  49.     vxftp host userid [password] [directory]
  50.  
  51. For example, to log into kelly with my account and change to my docs directory:
  52.  
  53.     vxftp kelly.utexas.edu hhyten secrets docs
  54.  
  55.  
  56. Anonymous FTPs:
  57. --------------
  58. Clicking on the "Anonymous FTP" check-box in the login dialog box will fill
  59. in "anonymous" and an Internet email address in the login and password fields,
  60. respectively. You can modify the email address in the Settings notebook.For
  61. example, to log into ftp.cdrom.com anonymously, you would type:
  62.  
  63.     vxftp ftp.cdrom.com anonymous
  64.     vxftp ftp.cdrom.com anon
  65.  
  66. ("Anonymous" can be abbreviated to "anon".)
  67.  
  68. Transferring Files:
  69. ---------------
  70. To PUT or GET files, you can select one or multiple files, and click the
  71. "Put" or "Get" button. VxFTP will then transfer the file(s) you've
  72. selected. You can also transmit files by selecting them and right-mouse-
  73. clicking for a pop-up menu. (Since these interface elements are lists,
  74. and *not* containers, you must first select a file or directory (or 
  75. Shift-Click or Ctrl-Click) before obtaining a pop-up menu.
  76.  
  77. Right-mouse Button:
  78. -------------------
  79. To operate on remote or local files or directories (that is, to rename, 
  80. get, put, delete, or view), use the right-mouse button after selecting the 
  81. files or directories you want. Choose the operation you desire from the 
  82. pop-up menu.
  83.  
  84. Managing File Archives:
  85. -----------------------
  86. On the local side, the selection "Unzip" allows you to unzip a ZIP archive,
  87. provided you have InfoZIP's unzip.exe in your path. You can also start an 
  88. executable or command/batch file from VxFTP by choosing "Execute". Use "View"
  89. to view a text file in a viewer. (On the remote side, you can also download 
  90. a text file to view in the viewer.)
  91.  
  92. If you specify a /K parameter in the COMSPEC statement in your CONFIG.SYS,
  93. the Unzip and Execute functions will work only if you start VxFTP from the 
  94. command line. If you want these functions to work after launching from the
  95. Desktop, remove the parameter in your CONFIG.SYS and place it in the "OS/2
  96. Window" and "OS/2 Full Screen" objects' parameter line.
  97.  
  98. Multiple Threads:
  99. -----------------
  100. VxFTP is multi-threaded, thanks to the multi-threading capabilities of 
  101. Watcom's VX-REXX on top of which VxFTP is built. Multi-threading makes
  102. the application more responsive to the user. Since it is founded on REXX,
  103. VxFTP would be unbearably slow if all tasks were obliged to follow one another 
  104. sequentially. Basically, VxFTP uses two threads, one for local disk access 
  105. and updating the user interface, and another that talks to the remote host. 
  106. Thus, if you've changed to another directory remotely and are waiting for 
  107. the directory contents to be downloaded, you can change directories locally 
  108. and effect local file changes.
  109.  
  110.  
  111. Available Hosts:
  112. ----------------
  113. With release 0.40, VxFTP can display listings from most UNIX hosts (though
  114. ftp.nmsu.edu is problematic), other PCs running IBM's TCP/IP for OS/2, 
  115. Macintoshes running FTPd, DEC VMS, and IBM VM. VxFTP supports any 
  116. platform that provides a 'standard' UNIX file listing. I believe this
  117. covers 98% of the platforms in general use.
  118.  
  119. If you log onto a host and don't receive a file and directory listing,
  120. use the "Long Dir Listing" menu choice to view what VxFTP downloaded
  121. from the host and was not able to interpret. You can use the information
  122. in the long-style listing to navigate around the remote file system.
  123.  
  124. In the works:
  125. -------------
  126. VxFTP v0.40 is still a beta. There are still several user options I want
  127. to add to the Settings Notebook.
  128.  
  129. Yes, I know it'd be great if VxFTP provided some indication as to a file
  130. transfer's progress. Like most things IBM, the OS/2 FTP API is "non-
  131. standard" enough that it does *NOT* support getting information on the 
  132. amount of data being transmitted. It also does *NOT* provide the text 
  133. or numeric codes typical to FTP command conversations. Sorry. Maybe
  134. in six months or so, I (or someone else) can develop a lower-level .DLL
  135. that provides the functionality VxFTP needs for these features.
  136.  
  137. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=--=-=-=-=-=-=-=-=-=-=-=-=-
  138. LEGALESE:
  139. VxFTP is built on top of IBM's RXFTP REXX extensions (by Patrick Mueller) 
  140. and using Watcom's excellent, multithreading VX-REXX. 
  141.  
  142. VxFTP.EXE is FREEWARE, not SHAREWARE. This means that the executable is 
  143. under my copyright, but users may freely distribute and share it without 
  144. having to think of giving me a dime. (A postcard would be great though!)
  145. When you distribute this program, you must include this readme.
  146.  
  147. Commercial distribution and/or use is prohibited without written consent from
  148. the author. Because the program is licensed free of charge, there is no
  149. warranty for the program, to the extent permitted by applicable law. Except
  150. when otherwise stated in writing the copyright holders and/or other parties
  151. provide the program "AS IS" without warranty of any kind, either expressed or
  152. implied, including, but not limited to, the implied warranties of
  153. merchantability and fitness for a particular purpose. The entire risk as to
  154. the quality and performance of the program is with you, the user. Should the
  155. program prove defective, you assume the cost of all necessary servicing, 
  156. repair or correction.
  157.  
  158.  
  159. CONTACT INFO:
  160. hhyten@mail.utexas.edu
  161. Howard T. Hyten
  162. 1200 Barton Hill Drive #222
  163. Austin, TX 78704-1910