@database FTS.guide @master FTS.guide @$VER: 1.0 @author "Felix Schwarz" @(c) "Felix Schwarz" @index Main @node "Main" "File Transfering System-Documentation (c) 1997-98 by Felix Schwarz" @{fg shine} ########## ########### ########### ###### ####### ###### ########## ####### ###### ###### ####### ########### ###### ####### ###### ###### ####### ###########@{fg text} @{fg shine}@{bg fill}F@{fg text}@{bg shine}ile @{fg shine}@{bg fill}T@{fg text}@{bg shine}ransfering @{fg shine}@{bg fill}S@{fg text}@{bg shine}ystem V1.0@{bg back} @{fg shine}@{bg fill}(c)1997-98 by Felix Schwarz@{fg text}@{bg back} @{"Introduction" link "Introduction" 0} - what is FTS ? @{"Installation" link "Installation" 0} - how to install FTS @{"Usage" link "Usage" 0} - how to use FTS @{"ToDo-List" link "ToDo" 0} - what`s still to do @{"Registration" link "Registration" 0} - how to get a registered copy of FTS @{"Distribution" link "Distribution" 0} - how you may spread it.. @endnode @node "Introduction" "Introduction - what is FTS ?" @{fg shine}@{bg fill} Introduction - what is FTS ?@{fg text}@{bg back} FTS stands for File Transfering System and is a program to @{fg shine}transfer files between two AMIGAs@{fg text}. It is not a FileSystem, but you have a powerful client/server-package that is very easy to use and that works on any @{fg shine}AMIGA with OS 2.x or higher@{fg text}. Well, you can use FTS for transfering files over the @{fg shine}modem or via null-modem-cable@{fg text}. You can @{fg shine}execute, copy, delete, rename, download and upload files@{fg text} in a very simple manner. Dirs can also be created. You can even protect your FTS-server via password or do a Welcome- message at login. Well, this system is THE solution if you need files from another computer and you don`t want to carry around your computer (I had bad experience with that two times, so I wrote FTS). As FTS supports several devices it might be even possible to transfer files @{fg shine}via telnet@{fg text} via telser.device. But this possibility has not been tested yet. And if there`s enough demand, I`ll do a server for PeeCees, so that you can connect your AMIGA to one of those singletasking machines :-) If A\Box is available, I`ll of course write a server for it (also when there`s no demand). FTS is @{fg shine}@{bg fill}Shareware@{fg text}@{bg back}. I think @{fg shine}@{bg fill}30 DM or 20 US$@{fg text}@{bg back} aren`t too much money for such a nice software. Please note, that you won`t get support or new version, if you`re not registered! @endnode @node "Installation" "Installation - how to install FTS" @{fg shine}@{bg fill} Installation - how to install FTS@{fg text}@{bg back} The installation of FTS is VERY simple. So I`ll describe that in a short way: 1. @{fg shine}Copy "Message", "uuIn", "uuOut" to C:@{fg text} 2. @{fg shine}Do an assign FTS to the FTS-Maindir. e.g. if the maindir is Work:FTS/ add Assign FTS: Work:FTS/ to your S:user-startup@{fg text} 3. @{fg shine}That`s it!@{fg text} Well, now I`ll tell you @{fg shine}how to configure FTS@{fg text} @{fg shine}@{bg fill}Configuration of "FTS-Server"@{fg text}@{bg back} Click on FTS-Server and choose "Icons/Information" or "Piktogramme/Informationen" from the pull-down menu of the WB. Now you`ll be able to change the tool-types: @{fg shine}DEVICE=@{fg text} Enter the name of the device here. So if you want to use the standard serial port of the AMiGA, you`ve to type DEVICE=serial.device .. if your device supports several units, set the unit under UNIT (e.g. UNIT=0) @{fg shine}BAUD=@{fg text} Here you must enter the baudrate between the two computers you want to link. Several tests have showed, that a connection with 9600 baud is most stable and didn`t brake down that often (well, might be my modem, hehe). @{fg shine}DDIR=@{fg text} You can enter the directory you want a user logging in to start in. Well, if you login and want to start at sys:, enter the following: DDIR=sys: @{fg shine}TEMP=@{fg text} This is the directory, you want FTS to store temporary data in. Please note, that files are directly transfered from there! So don`t choose your disk-drive for that.. @{fg shine}LOGIN=@{fg text} Every user logging in your server must enter a login-name. You can enter it here. If you want to login as AMIGA, you should enter the following: LOGIN=AMIGA @{fg shine}PWD=@{fg text} Every user logging in your server must enter a password. You can enter it here. If you want to have abox for passowrd, enter the following: PWD=abox @{fg shine}WELCOME=@{fg text} Here you can enter the name of the file, that shall be sent, before LOGIN and PASSWORD are requested. This file must be an ASCII-File. If you want to send S:Welcome, enter the following: WELCOME=S:Welcome @{fg shine}ENABLED=11111111111@{fg text} You can enable/disable all functions(except the basic functions) wit this number. A 1 allows usage a 0 denies usage. The numbers stand for the following commands: @{fg shine}DIR OLM EXE CALLBACK QUITIT RESET DLA DLB RENAME MAKEDIR DEL@{fg text} This is useful, if you have a public FTS-server and don`t want people to format your HD :-) @{fg shine}SECURITYFILES=@{fg text} This option is also for security. If you only want to allow your user(s) to access to selected directories, you should install so called securityfiles. Before the user can dir, list, upload or download from/to a directory, FTS checks whether a file called exists in the directory. Well, if not - no access :-) If you don`t have this Tooltype set, there`s unnlimited access(only limited or not limited by ENABLED. @{fg shine}@{bg fill}Configuration of FTS-Client@{fg text}@{bg back} Click on FTS-Client and choose "Icons/Information" or "Piktogramme/Informationen" from the pull-down menu of the WB. Now you`ll be able to change the tool-types: @{fg shine}DEVICE=@{fg text} Enter the name of the device here. So if you want to use the standard serial port of the AMiGA, you`ve to type DEVICE=serial.device .. if your device supports several units, set the unit under UNIT (e.g. UNIT=0) @{fg shine}BAUD=@{fg text} Here you must enter the baudrate between the two computers you want to link. Several tests have showed, that a connection with 9600 baud is most stable and didn`t brake down that often (well, might be my modem, hehe). @{fg shine}DDIR=@{fg text} Here you must enter the name of the directory, you want to store your downloaded data in. If you want to use Downloads as Download Dir, type in following DDIR=Downloads/ @{fg shine}TEMP=@{fg text} This is the directory, you want FTS to store temporary data in. Please note, that files are directly transfered from there! So don`t choose your disk-drive for that.. @{fg shine}FONT=@{fg text} Here you can enter your prefered font. e.g. Xhelvetiva.font => FONT=Xhelvetica.font @{fg shine}FSIZE=@{fg text} Enter the size of your prefered font here. e.g. 11 => FSIZE=11 @endnode @node "Usage" "Usage - how to use FTS" @{fg shine}@{bg fill} Usage of FTS@{fg text}@{bg back} In this part of the documentation, you see how to use FTS. This part is splitted in three parts. The first for the server, 2nd for the client and last for description of command accepted by client and server. @{fg shine}@{bg fill}FTS-Server@{fg text}@{bg back} After having installed and configured FTS-Server, you can start it. FTS-Server doesn`t open a window. There`s only an appicon. When you doubleclick it, you can choose between the following: @{fg shine}Quit@{fg text} Ends the server and gives free the serial-device.. @{fg shine}Watch actions@{fg text} Here you can watch the actions of the current visitor like downloading, uploading, etc. @{fg shine}Close watcher@{fg text} Closes the watch-window. @{fg shine}Open login-dbg@{fg text} This is an important part of FTS-Server for debugging your connection. For example, if your phone rings, but FTS-Server doesn`t establish a connection, you must enter "ATA"+Return, so the modem will establish a connection. Well, this debugger is universal. You can also enter something, when the connection is already established, and you can read it at the client in the FTS-Client-CLI. @{fg shine}Close login-dbg@{fg text} This closes the login-debugger. @{fg shine}Cancel@{fg text} Closes the window.. Please note, that FTS-Server doesn`t work while the requester is up. @{fg shine}@{bg fill}FTS-Client@{fg text}@{bg back} After having installed and configured FTS-Client, you can start it. FTS-Client brings up two windows. The first is the graphical client the second below is the FTS Client CLI, where you can either enter something directly to the modem or, after connected the commands like in a Shell-window. In the GUI are the following buttons @{fg shine}Download/Delete/Rename/View/Execute@{fg text} Here you can choose what to do with the file you click in the req-like field above. @{fg shine}Ascii/Binary@{fg text} You can toggle between the two transfer-modes: Ascii and Binary. If you try to download binary data in Ascii-Mode, the connection will freeze.. so take Binary, if you don`t know what the data is like. It`s set to default, so if you simply start FTS-Client and download, nothing can happen .. @{fg shine}Create Dir@{fg text} Creates a dir with the name entered in an upcoming requester. @{fg shine}Upload@{fg text} Uploads the file you choose in the upcoming ASL-requester into the current remote-directory. @{fg shine}Execute@{fg text} Executes the command you enter in the upcoming requester from the ccurrent directory. @{fg shine}Scan@{fg text} Performs a "dir" in the current directory.. @{fg shine}Parent@{fg text} Changes to parent directory. @{fg shine}Phonebook@{fg text} A phonebook comes up. Here you can enter your Phone-numbers. If you want to link two AMiGAs via Nullmodem, type in CONNECT as Number. There`s also a gadget called "Get information about modem", that tells you the name of your Modem and FWare. @{fg shine}Quit@{fg text} Quits FTS Client and closes a connection to FTS Server if running.. @{fg shine}@{bg fill}FTS-Commands@{fg text}@{bg back} These are the commands supported by FTS Client`s CLI and FTS Server: @{fg shine}CD @{fg text} Change Directory. Changes Directory. Similiar to CD from Shell. @{fg shine}CDE @{fg text} Change Directory Exclusive. This command doesn`t check anything. It easily changes the directory. @{fg shine}DIR@{fg text} List the current directory. The result is also listed in the graphical client. @{fg shine}DEL @{fg text} Deletes the file from current directory. @{fg shine}EXE @{fg text} Executes the command . If the command was executed, it shows you what the command gave out to the shell. NOTE: You can`t enter anything while command is executed. @{fg shine}MAKEDIR @{fg text} Creates a new directory . Similiar to the shell`s MakeDir. @{fg shine}RENAME /@{fg text} Renames to . @{fg shine}OLM @{fg text} OLM stands for OnLine Message. You might know it from some BBSs. FTS opens up a requester in which you can see . FTS is NOT stopped by the requester. @{fg shine}QUITIT@{fg text} Closes the connection and quits the server. @{fg shine}RESET@{fg text} Performs a warm reboot. @{fg shine}DLA @{fg text} Downloads a file in ASCII-Mode. @{fg shine}DLB @{fg text} Downloads a file in Binary-Mode. @{fg shine}CLS@{fg text} Clears "screen". It clears FTS-Server CLI-window. @{fg shine}EXIT@{fg text} Closes the connection. @{fg shine}CALLBACK@{fg text} FTS-Server calls you back in a given number of seconds to a given number. Can be disabled via Tooltypes. @{fg shine}GETINFO@{fg text} Get information about the machine running FTS-Server. @{fg shine}CHAT@{fg text} Allows people to chat! @endnode @node "ToDo" "To Do - what`s still to do.." @{fg shine}@{bg fill} The "To Do" list@{fg text}@{bg back} Here you find things I`m still planning and I`ll include, when people register. - a Server-program for PeeCees(by interest) - @{fg shine}a Server-program for A\Box@{fg text} - @{fg shine}an ARexx-Port@{fg text} for both client and server @endnode @node "Registration" "Registration" @{fg shine}@{bg fill} Registration - how to register for FTS@{fg text}@{bg back} Well, if you are using FTS frequently, you should register. I have put a lot of time and money in the development of FTS, so I think 30 DM/20 US$ for the key-file are ok. The registered version has a lot of @{b}@{fg shine}extra-features@{ub}@{fg text}: - nerving 10-second-wait removed - you can deny access for commands - the about-requester doesn`t appear any longer. That`s useful, if you install FTS-Server in WBStartup and don`t want to close the about requester each time. - you get support for FTS via email, phone and mail - you have an exclusive keyfile :-) - you`ll support future development of FTS You @{fg shine}can receive the registered version the following ways@{fg text}: - via Mail - via Email and @{fg shine}you can pay these ways@{fg text}: - via cash - via cheque - via C.O.D./Nachnahme @{"Fill out the registerform" system "C:ed Register"} now! Then @{"print it" system "copy Register prt:"} and send it to @{i} Felix Schwarz Am Gründla 3 D-91074 Herzogenaurach GERMANY@{ui} @endnode @node "Distribution" "Distribution" @{fg shine}@{bg fill} Distribution@{fg text}@{bg back} This program package is copyrighted by Felix Schwarz. All rights are reserved. You may NOT change, rip or add any files of this package including the doc. You may also @{fg shine}not sell it to people for more than two US$ or equal in other currencies@{fg text} (exceptions: Aminet CDs, CDs in general, cover disks of magazines). Any other distribution is only allowed with written permission of me via mail. The only way you may change the binary data is to pack it via lha. It must be possible to decrunch this archive with standard lha from Stefan Boberg. @{fg shine}@{bg fill} Disclaimer@{fg text}@{bg back} The author can not be held responsible for any damages caused or not caused by FTS and its included programs. Use it at your own risk. (Not that I had any problems!) @endnode