═══ 1. Application - Ftp Spy ═══ The Ftp Spy allows to work with Internet Ftp in a highly comfortable manner. Remote and local locations are presented in tree views. During an online session Ftp Spy "learns". New remote directories are added to the remote tree view and stored after application close. After restart the stored remote location teee is restored as it was saved before. A very impressiv "Stored marked files" feature allows to collect files that are uploaded and/or uploaded often. During application close these marked files are stored too and are restored after application startup again. This helps to repeat often done uploads/downloads with a single click on the mouse. ═══ 2. Disclaimer ═══ This product is supplied with no warranty, either expressed or implied. The author Harald Wilhelm will not accept responsibility for any adverse consequences that may arise from the use or misuse of Ftp Spy or its associated program and data files. Such adverse consequences include, but are not limited to, loss of profit, and loss of data. The author specifically disclaims all warranties, expressed or implied, including but not limited to, any implied warranty of merchantability or fitness for a particular purpose. ═══ 3. Copyright ═══ Ftp Spy is Copyright 1996 Harald Wilhelm. Ftp Spy exists in evaluation and licensed versions. The product information dialog specifies the type of each copy. Evaluation copies of Ftp Spy are supplied for evaluation only. You may distribute them freely, but they are not to be used commercially. After 21 days of evaluation, you must cease using Ftp Spy unless you register it. Licensed copies of Ftp Spy may be used commerically, but not freely distributed. Only one instance of each licensed copy may be used at any particular time. The copyright of Ftp Spy is currently held by the author Harald Wilhelm. ═══ 4. Licensing Ftp Spy ═══ Ftp Spy is useful to almost the entire OS/2 community. The author invites you to license Ftp Spy under negotiable terms. To contact the author, see Contacting the author. Alternatively, see How to register if you simply wish to continue using Ftp Spy. ═══ 5. How to register ═══ Ftp Spy is shareware. This means that you can use the program for a limited time (21 days) before you decide whether you want to keep it. If you want to continue using Ftp Spy after that time you are expected to register it. The registered version (which you will be sent when you register) is more uptodate, removes the sticky windows, but is otherwise identical to (or better than) the evaluation version. Once you have registered, technical support is available from the author via e-mail or mail. Voice support is not provided. Please see the file ORDER.TXT for order information. ═══ 6. Contacting the author ═══ You may register a single copy of Ftp Spy or initiate licensing negotiations with the author. You can contact him at the address below: Fax: +49 (0) 22 1 5 90 91 99 Mail: Harald Wilhelm Am Scheidweg 60 D-50765 Koeln (Cologne) Germany E-Mail: Harald_Wilhelm@hawi.de ═══ 7. Startup Parameter ═══ Several startup parameter allow to restrict the scan for local drives and/or directories to special ones: Parameter Meaning -i Only use the given directory in the local scan. For example -iD:\IMAGES will only scan drive D and the directory IMAGES and it's subdirectories on that drive. -n Don't scan network drives during local tree scan. -r Only use the given drive in the local scan. For example -rD will only scan drive D. ═══ 8. Actionbar Choices ═══ ═══ 8.1. Actionbar Choice - File ═══ ═══ 8.1.1. Pulldown menu Choice - Marked files ═══ After selecting this pulldown menu choice a dialog will show up that contains all stored marked files. From this dialog you can easily upload/download files that are often transfered. ═══ 8.1.2. Pulldown menu Choice - Close all hosts ═══ The FTP engine holds all open remote locations. After selecting this pulldown menu choice these remote locations are closed and the FTP engine logs off from them. ═══ 8.2. Actionbar Choice - Edit ═══ ═══ 8.2.1. Pulldown menu Choice - Collapse ═══ Pulldown menu Choice - Local Tree The entries in the local Tree View will shrink after selecting this pulldown menu choice. Pulldown menu Choice - Remote Tree The entries in the remote Tree View will shrink after selecting this pulldown menu choice. ═══ 8.2.2. Pulldown menu Choice - Expand ═══ Pulldown menu Choice - Local Tree The entries in the local Tree View will expand after selecting this pulldown menu choice. Pulldown menu Choice - Remote Tree The entries in the remote Tree View will expand after selecting this pulldown menu choice. Pulldown menu Choice - Quote command After selecting this pulldown menu choice a new dialog will show up. From this dialog you can enter and send a quote command to the remote location. Pulldown menu Choice - Site command After selecting this pulldown menu choice a new dialog will show up. From this dialog you can enter and send a site command to the remote location. ═══ 8.3. Actionbar Choice - Options ═══ ═══ 8.3.1. Pulldown menu Choice - Automatic FTP Groups ═══ Pulldown menu Choice - Keep During work the Ftp Spy will generate automatic entries in the remote Tree View. Selecting this pulldown menu choice will keep this new entries after closing this application. Pulldown menu Choice - Remove During work the Ftp Spy will generate automatic entries in the remote Tree View. Selecting this pulldown menu choice will remove this new entries after closing this application. ═══ 8.3.2. Pulldown menu Choice - Automatic logoff ═══ Pulldown menu Choice - Off The application will not process any automatic logoff if this choice is selected. Pulldown menu Choice - On Marked files transfer can become a time consuming process. After selecting this option the application will shutdown after trabsfer of marked files. Don't forget to enter a reasonable value in the timeout parameter of your dialer. ═══ 8.3.3. Pulldown menu Choice - Defaults ═══ After selecting this pulldown menu choice a new dialog will show up. On this dialog you can enter several application defaults. Currently these are the default User ID, the default Password and the default account that should be used when logging in remote locations. ═══ 8.3.4. Pulldown menu Choice - Get unique ═══ Pulldown menu Choice - Off If during a download a file with the same name is already found and can't be overwritten the transfer will fail. Pulldown menu Choice - On If during a download a file with the same name is already found and can't be overwritten the transfer utility will create a unique filename for this file automatically. ═══ 8.3.5. Pulldown menu Choice - Put unique ═══ Pulldown menu Choice - Off If during an upload a file with the same name is already found and can't be overwritten the transfer will fail. Pulldown menu Choice - On If during an upload a file with the same name is already found and can't be overwritten the transfer utility will create a unique filename for this file automatically. ═══ 8.3.6. Pulldown menu Choice - Security message on delete ═══ Pulldown menu Choice - Off Selecting this pulldown menu choice will switch off the generation of a security message box before deleting entries. Pulldown menu Choice - On Selecting this pulldown menu choice will switch on the generation of a security message box before deleting entries. ═══ 8.4. Actionbar Choice - Help ═══ ═══ 8.4.1. Pulldown menu Choice - General Help ═══ Shows General help. ═══ 8.4.2. Pulldown menu Choice - About ═══ Shows the Aboutbox. ═══ 8.4.3. Pulldown menu Choice - Register ═══ This choice is only available, if this product is not registered. Activating this action will bring up the dialog Register Shareware. ═══ 8.5. Popup Menu - Local Directory Item ═══ ═══ 8.5.1. Popup Menu Choice - Delete ═══ The selected entries in the container local directory will be deleted after selecting this menu choice. ═══ 8.5.2. Popup Menu Choice - Mark ═══ The selected entries in the container local directory will be added to the marked files list. These marked files will be stored during application close and will show up again after application restart. ═══ 8.5.3. Popup Menu Choice - Select ═══ Popup Menu Choice - All All entries in the container local directory will be selected after selecting this popup menu choice. Popup Menu Choice - None All entries in the container local directory will be deselected after selecting this popup menu choice. ═══ 8.5.4. Popup Menu Choice - Transfer ═══ The selected entries in the container local directory will be transfered to the remote directory after selecting this menu choice. ═══ 8.5.5. Popup Menu Choice - View ═══ The selected entries in the container local directory will be viewed with the standard editor of OS/2 named E.EXE. ═══ 8.6. Popup Menu Choice - Remote Directory Item ═══ ═══ 8.6.1. Popup Menu Choice - Delete ═══ The selected entries in the container remote directory will be deleted after selecting this menu choice. ═══ 8.6.2. Popup Menu Choice - Mark ═══ The selected entries in the container remote directory will be added to the marked files list. These marked files will be stored during application close and will show up again after application restart. ═══ 8.6.3. Popup Menu Choice - Select ═══ Popup Menu Choice - All All entries in the container remote directory will be selected after selecting this popup menu choice. Popup Menu Choice - None All entries in the container remote directory will be deselected after selecting this popup menu choice. ═══ 8.6.4. Popup Menu Choice - Transfer ═══ The selected entries in the container remote directory will be transfered to the local directory after selecting this menu choice. ═══ 8.6.5. Popup Menu Choice - View ═══ The selected entries in the container remote directory will be transfered to the local directory and viewed with the standard editor of OS/2 named E.EXE. ═══ 8.7. Popup Menu Choice - Local Tree FTP Group ═══ ═══ 8.7.1. Popup Menu Choice - Open ═══ The selected entry in the container local Tree View will be opened after selecting this menu choice. The contents of this local tree will be presented in the local directory container. ═══ 8.7.2. Popup Menu Choice - Create directory ═══ After selecting this menu choice a new dialog will appear. You can enter a name of a subdirectory. After leaving this dialog a new subdirectory will be created. ═══ 8.8. Popup Menu Choice - Remote Tree FTP Directory ═══ ═══ 8.8.1. Popup Menu Choice - Apply local ═══ After selecting this menu choice the currently selected local directory is set as the default local directory in the settings of this remote directory. ═══ 8.8.2. Popup Menu Choice - Create FTP Group ═══ After selecting this menu choice you'll see a dialog where you can enter data that form a new FTP Group. After leaving this dialog a new FTP group entry is added to the remote tree container. ═══ 8.8.3. Popup Menu Choice - Open ═══ After selecting this menu choice the remote directory will be scanned. The contents of this remote directory will be shown in the remote directory container. If Ftp Spy finds new sublocations in this remote location that are not known to Ftp Spy a new FTP directory will be added for every unknown sublocation. These new sublocations will be created with the information that the paranet location has. Only the remote location entry of the settings will change to this new sublocation. ═══ 8.8.4. Popup Menu Choice - Create FTP Directory ═══ After selecting this menu choice you'll see a dialog where you can enter data that form a new FTP directory. After leaving this dialog a new FTP directory entry is added to the remote tree container. ═══ 8.8.5. Popup Menu Choice - Settings ═══ The selected entry in the container remote tree view will show it's settings after selecting this menu choice. On this dialog you can change all stored settings. ═══ 8.8.6. Popup Menu Choice - Delete ═══ The selected entry in the container remote tree View will be deleted after selecting this menu choice. This action will delete the entry in the container only. There's another popup menu choice that deals with removing remote directories. ═══ 8.8.7. Popup Menu Choice - Remove ═══ The selected entry in the container remote tree View will be deleted after selecting this menu choice. This action will delete the entry in the container and the remote directory, if possible. ═══ 9. Container - Local Directory ═══ This container will show all files found at the selected local location. Directories will not be shown in this container. Directory entries will only show up in the tree view container of the local location. With the help of the right mouse button you can select entries and the popup menu will show all those actions that are possible. ═══ 10. Container - Remote Directory ═══ This container does contain all files found at the selected remote location. Directories will not be shown in this container. Directory entries will only show up in the tree view container of the remote location. With the help of the right mouse button you can select entries and the popup menu will show all those actions that are possible. ═══ 11. Container - Local Tree View ═══ This container shows a tree view of the local location. A double click on an entry will list it's contents in the local directory container. With the help of the right mouse button you can select entries and the popup menu will show all those actions that are possible. ═══ 12. Container - Remote Tree View ═══ This container shows a tree view of the remote location. A double click on an entry will list it's contents in the remote directory container. With the help of the right mouse button you can select entries and the popup menu will show all those actions that are possible. ═══ 13. Dialogs ═══ ═══ 13.1. Dialog - About ═══ This dialog will show information to the current application. ═══ 13.1.1. Pushbutton - Ok ═══ Activating this pushbutton will leave the current dialog. ═══ 13.2. Dialog - Register Shareware ═══ This dialog is only available if this product is not registered. ═══ 13.2.1. Entryfield - Registername ═══ Please enter the name you got from the author of this package. ═══ 13.2.2. Entryfield - Registercode ═══ Please enter the code you got from the author of this package. ═══ 13.2.3. Pushbutton - Ok ═══ Starts to register the product. If this action is successfull, the titlebar of the application will change. The word "Unregistered" will disappear. This is true for the pulldown choice Register too. ═══ 13.2.4. Pushbutton - Help ═══ Shows help for the selected dialog element. ═══ 13.3. Dialog - Defaults ═══ This dialog allows to specify some application defaults. These defaults will be used when creating a new FTP directory. ═══ 13.3.1. Entryfield - User ID ═══ Specify the default User ID in this entryfield. ═══ 13.3.2. Entryfield - Password ═══ Specify the default Password in this entryfield. ═══ 13.3.3. Entryfield - Account ═══ Specify the default Account in this entryfield. ═══ 13.3.4. Radiobutton - Include files/directories ═══ Select this radiobutton if you want to delete files and subdirectories during remove of a local tree entry. ═══ 13.3.5. Radiobutton - Exclude files/directories ═══ Select this radiobutton if you do not want to delete files and subdirectories during remove of a local tree entry. ═══ 13.3.6. Pushbutton - Ok ═══ Activating this pushbutton will leave the current dialog. Modified field entries are permanently stored. ═══ 13.3.7. Pushbutton - Help ═══ Shows help for the selected dialog element. ═══ 13.4. Dialog - Directory - new ═══ This dialog allows to create a directory. Enter the name of the new subdirectory. ═══ 13.4.1. Entryfield - Name ═══ Enter the name of the new directory in this entryfield. ═══ 13.4.2. Pushbutton - Ok ═══ Activating this pushbutton will leave the current dialog. ═══ 13.4.3. Pushbutton - Help ═══ Shows help for the selected dialog element. ═══ 13.5. Dialog - Insert FTP group ═══ This dialog allows to enter a new FTP group or change the data of an existing FTP group. ═══ 13.5.1. Entryfield - Name ═══ Enter the name of the new FTP group in this entryfield. ═══ 13.5.2. Pushbutton - Ok ═══ Activating this pushbutton will leave the current dialog. ═══ 13.5.3. Pushbutton - Help ═══ Shows help for the selected dialog element. ═══ 13.6. Dialog - Insert FTP directory ═══ This dialog allows to enter a new FTP directory or change the data of an existing FTP directory. ═══ 13.6.1. Entryfield - Name ═══ Enter a descriptive name of this FTP directory in this entryfield. ═══ 13.6.2. Entryfield - Location ═══ Enter the location of the host (without additional directory information) in this entryfield. ═══ 13.6.3. Entryfield - DefDir remote ═══ Enter additional directory information in this entryfield. ═══ 13.6.4. Entryfield - Filter ═══ Enter a filter in this entryfield. Default is a single asterisk (*). If you only want to search files with the extension ZIP, enter *.ZIP into this entryfield. ═══ 13.6.5. Entryfield - DefDir local ═══ Enter the default local directory for downloads/uploads into this entryfield. ═══ 13.6.6. Entryfield - User ID ═══ Enter your User ID here. Usually you can leave this field with the anonymous default. ═══ 13.6.7. Entryfield - Password ═══ Enter your password into this entryfield. Usually, when using anonymous, the password is your own internet address. ═══ 13.6.8. Entryfield - Account ═══ Enter additional account information into this entryfield. Usually, when using anonymous, you can leave this entryfield empty. ═══ 13.6.9. Radiobutton - Binary ═══ Select this radiobutton if you want to use the binary transfer mode (default). ═══ 13.6.10. Radiobutton - ASCII ═══ Select this radiobutton if you want to use the ASCII transfer mode. ═══ 13.6.11. Pushbutton - Ok ═══ Activating this pushbutton will leave the current dialog. ═══ 13.6.12. Pushbutton - Help ═══ Shows help for the selected dialog element. ═══ 13.7. Dialog - Marked files ═══ This dialog will show all stored marked files. You can select one or more entries and transfer them to the known locations. Marked files can be deleted on this dialog too. ═══ 13.7.1. Container - Quote command ═══ This container does contain all stored marked files. You can select one or more entries in this container. ═══ 13.7.2. Pushbutton - Help ═══ Shows help for the selected dialog element. ═══ 13.7.3. Pushbutton - Delete ═══ After clicking this pushbutton all selected entries in the container are deleted. ═══ 13.7.4. Pushbutton - Transfer ═══ After clicking this pushbutton the dialog disappears and the previously selected entries in the container are transfered to the known locations. ═══ 13.7.5. Pushbutton - Select all ═══ Clicking this pushbutton will select all entries in the container. ═══ 13.7.6. Pushbutton - Deselect all ═══ Clicking this pushbutton will deselect all entries in the container. ═══ 13.8. Dialog - Quote command ═══ This dialog allows to send a quote command to the remote location. ═══ 13.8.1. Entryfield - Quote command ═══ Enter the quote command in this entryfield. ═══ 13.8.2. Pushbutton - Ok ═══ Activating this pushbutton will leave the current dialog. The quote command will be send to the remote location. ═══ 13.8.3. Pushbutton - Help ═══ Shows help for the selected dialog element. ═══ 13.9. Dialog - Rename ═══ This dialog allows to rename an existing container entry. ═══ 13.9.1. Entryfield - New name ═══ Enter the new description in this entryfield. ═══ 13.9.2. Pushbutton - Ok ═══ Activating this pushbutton will leave the current dialog. The rename will be performed. ═══ 13.9.3. Pushbutton - Help ═══ Shows help for the selected dialog element. ═══ 13.10. Dialog - Site command ═══ This dialog allows to send a site command to the remote location. ═══ 13.10.1. Entryfield - Site command ═══ Enter the site command in this entryfield. ═══ 13.10.2. Pushbutton - Ok ═══ Activating this pushbutton will leave the current dialog. The site command will be send to the remote location. ═══ 13.10.3. Pushbutton - Help ═══ Shows help for the selected dialog element.