home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / ftprxfe1.zip / FTPMRXFE.DOC < prev   
Text File  |  1993-11-16  |  6KB  |  111 lines
  1.                     SEE NOTES BELOW FOR INSTALLATION
  2.  
  3. Synopsis:    Presentation Manager front end (through Visual REXX)
  4.              for the TCP/IP file transfer program FTPPM.
  5.  
  6. Author:      Michele Marziani
  7.              Dipartimento di Fisica
  8.              Universita' di Ferrara, ITALY
  9.              e-mail: marziani@ferrara.infn.it
  10.  
  11. Requirements:IBM OS/2 2.x with REXX installed
  12.              IBM TCP/IP version 1.2.1 or higher (only tested with 1.2.1)
  13.              IBM EWS VREXX 1.0 or higher
  14.                (available via anonymous ftp from any major OS/2 archive,
  15.                 e.g. ftp.cdrom.com or software.watson.ibm.com)
  16.  
  17. Description: Are you tired of re-typing the same information at all
  18.              times when FTPing to a remote host?
  19.              The TCP/IP FTPPM "Remote Logon" procedure reads your
  20.              NETRC file searching for "User" and "Password" for any
  21.              defined host name. However you are supposed to type in
  22.              the "Host" information anyway.
  23.              I think this is a very annoying feature of FTPPM.
  24.              This REXX procedure tries to remedy this behaviour.
  25.  
  26.              This REXX cmd file is used to start the FTPPM program
  27.              through a Presentation Manager front end. This allows
  28.              the choice of a remote host entry in the TCP/IP NETRC
  29.              file via a PM listbox, without any user typing.
  30.  
  31.              One more entry is added to the listbox: "UNLISTED HOST".
  32.              This allows the user to specify the name, user id (optional)
  33.              and password (optional) for an host not yet defined in the
  34.              NETRC file, by means of a standard PM dialog box (the
  35.              password is not echoed to the screen). This behaviour is
  36.              quite similar to the "Remote Logon" feature of FTPPM.
  37.              If you leave the user and password fields empty, however,
  38.              an anonymous ftp connection is tried with the specified
  39.              host, using "os2user@host.subdomain.domain" as a password.
  40.              The TCP/IP definition of "host.subdomain.domain" is
  41.              automatically retrieved from information returned by the
  42.              OS/2 TCP/IP command 'hostname'.
  43.              
  44.              This procedure expects a NETRC file in the standard format
  45.              as stated in an appendix of the TCP/IP 1.2.1 manual, i.e.
  46.                      machine NAME [login USER] [password PASS]
  47.              I think at least both NAME and USER have to specified in
  48.              order to have a reasonably automated login procedure.
  49.  
  50. License:     This program is FREEWARE. It is donated to the public domain
  51.              granted that you are not charging anything (money etc.) for
  52.              it and derivates based upon it. You may freely distribute this
  53.              program, provided that no changes are made to it and that the
  54.              accompanying doc file FTPMRXFE.DOC is being distributed
  55.              together with FTPMRXFE.CMD in the unmodified archive
  56.              file FTPRXFE1.ZIP.
  57.  
  58. Disclaimer:  The same standard disclaimers apply as for any piece of
  59.              shareware/freeware software. Therefore there is no guarantee
  60.              that it works without errors, etc. etc.
  61.  
  62.              In fact this is my second REXX program in my life! All the
  63.              code below was partly inspired by very useful pieces of code
  64.              I've found at ftp.cdrom.com or software.watson.ibm.com
  65.              (e.g. VARC10B3, ZIPENG10, VREXX TESTDLGS.CMD, etc...).
  66.              Many thanks to their respective authors.
  67.  
  68.              This program has only been tested with an 800x600 PM screen
  69.              mode. So there is a chance that the program windows are not
  70.              correctly positioned/displayed with different screen resolutions.
  71.              However window screen positioning shouldn't be dependent on PM
  72.              screen resolution. Furthermore, error checking is far from
  73.              extensive. So don't blame me too much.
  74.  
  75.              Please, if you find an error, post me a message describing it.
  76.              I will try to fix and rerelease it to the net.
  77.              If you can improve it, please do so. All I ask is that you
  78.              drop me a note with a copy of the improvements.
  79.  
  80.              You can contact me with suggestions or bug reports via e-mail
  81.              on the Internet at 'marziani@ferrara.infn.it' or on DECnet
  82.              at '39967::MARZIANI'.  Thank you.
  83.  
  84. Revision history:
  85.   v1.00: 11/11/93    Initial version (not released)
  86.   v1.01: 15/11/93    Fixed bug in the NETRC file search mechanism
  87.                      Improved NETRC file opening logic
  88.                      Modified sign-on window font size
  89.  
  90.  
  91.  
  92.                          INSTALLATION PROCEDURE
  93.  
  94. 1) Unpack FTPRXFE1.ZIP in any directory, then move FTPMRXFE.CMD to any
  95.    directory in your path, e.g. C:\TCPIP\BIN
  96.  
  97. 2) Create a new WPS object for FTPMRXFE.CMD, e.g. by dragging a Program
  98.    Template to the WPS or any folder of your choice. Open the Settings
  99.    Notebook for the object, fill in the "Path and file name" field with
  100.    the full qualified path of FTPMRXFE.CMD. In the "Working directory"
  101.    field specify the name of the directory where you usually download
  102.    files via FTP, e.g. C:\DOWNLOAD
  103.    Click on the "Session" tab and check "OS/2 window", then both "Start
  104.    minimized" and "Close window on exit".
  105.    Click on the "General" tab and choose a meaningful WPS object Title,
  106.    e.g. "FTP PM Front End". If you have extracted an icon file from the
  107.    TCP/IP program FTPPM, then you might associate it to this object in
  108.    the "Current icon" field. Use the "Find..." button for this purpose.
  109.  
  110. 3) Run FTPMRXFE.CMD by double clicking on the newly created object.
  111.