8/16/84 kermit Function: Kermit allows files to be transferred between computers. The files may be ascii or binary. A kermit program must be available on the target (micro) computer. Version: Multics Kermit 2.0g of 8/16/84 Syntax: kermit [] When invoked without control arguments, kermit will enter a request loop. Control arguments: -logout Logout after successfully transfering the file. Must be used in conjunction with -send or -receive. Will not logout if errors arise during the transfer. -send Send one (or a group) of files to the target system. -receive [] Receive a file from the micro. Send, receive and server are mutually exclusive arguments. -set See below. -status Will display the status of the last transmission. The name of the file, the total number of packets required and the total number of retries will be displayed. This arg is ignored whem -send, -receive or -server is used. -server Directs the Multics kermit to become a kermit server (slave). Subsequent commands for file transfer come directly from the remote computer. -show Show the state of all settable options. This arg is ignored when -send, -receive or -server is used. -debug Debugging option. Do not use. The set control arg: -set Set the options to the indicated state. This must be the last control_arg on the line. Options to be set are typed in following without commas or additional "-set"s The syntax for can be in one of two forms: } where is either send, receive or rec or . Both types may be intermixed freely on a line. All options for send or receive can be typed in following one instance of the send or receive keyword. For example, to set the text mode off (binary transfer), default dir to your home directory, the number of pad characters to 3 on send and the send pad character to 002 (octal), use the following command: kermit -send -set text off dir [hd] send padding 3 padchar 2 Note that -send, -receive or -server must be used to execute the program. When executed without one of these arguments, the only effect is to set option values. All set arguments retain values between invocations during the same process except trace and dir. See the section on the set command later in this info file for a complete description of the set parameters and their allowed values. Usage: The standard usage of Kermit to transfer files takes the following form: 1) Start Kermit on the micro. 2) Set any desired parameters (eg baud rate for the IBM PC). 3) Connect to the mainframe. The micro now appears to be an ordinary terminal. 4) Login to Multics as usual. 5) Execute the Multics command kermit. You will get the Multics prompt of Kermit-Multics> . 6) Set any desired parameters. 7) Execute either a SEND or a RECEIVE command. 8) Use the escape sequence ctrl-] c to get back to command level at the micro. You will see the micro Kermit prompt. 9) Execute the corresponding command (ie if the mainframe is expecting to RECEIVE a file, execute a SEND command and vice versa). 10) The micro will display the status of the transmission. After the file is transfered, a COMPLETED message will be displayed. If, for some reason, the file could not be transferred a FAILED message will be displayed. 11) To transfer more files, issue a CONNECT command to the micro. You will be back in Multics-Kermit. Type a carriage return to get the prompt. Go back to step 7. 12) If you are finished transferring files, EXIT (or QUIT also q) from Kermit and logout. 13) Use the ctrl-] c escape sequence to get back to micro-command level and exit the local Kermit. Alternative usage: Kermit may also be invoked as a command without entering the request loop. In this case, the action specified by a control argument is performed and Kermit will return to Multics command level. If the -logout arg is specified, Kermit will log you out on the Multics end if the transfer was completed successfully. This usage looks like: 1) Start Kermit on the micro. 2) Set any desired parameters (eg baud rate for the IBM PC). 3) Connect to the mainframe. The micro now appears to be an ordinary terminal. 4) Login to Multics as usual. 5) Issue the command kermit -receive or kermit -send file_name to receive or send a file. The file_name is optional on the -receive command, but necessary on the -send command. You can also put the -logout argument on the line to automatically log you out after the transfer completes successfully. 6) Use the escape sequence ctrl-] c to get the prompt on the micro. 7) Issue the corresponding SEND or RECEIVE command to the micro. 8) The micro will display the status of the transmission. When completed, you will get the micro Kermit prompt. 9) If the -logout argument was given, you do not have to reCONNECT to Multics, you will have been automatically logged out. 10) If the -logout argument was not given, CONNECT to Multics. You will be at command level, even though you may not see a ready message. Logout. You should also CONNECT if the transfer was unsuccessful. In that case, you can try again. The -logout argument will be ignored if the transfer was not successful. Usage as server: Multics Kermit may be placed into a special "slave" mode called server mode. In this case, commands will be issued by the remote computer to initiate file transfer. Once the server is started up, you do not have to tell it anything else directly. Your micro will do it for you. Not all micros support kermit server commands, and some will use a special form of the RECEIVE command instead of the GET command. Check the documentation on your version. 1) Start Kermit on the micro. 2) Set any desired parameters (eg baud rate for the IBM PC). 3) Connect to the mainframe. The micro now appears to be an ordinary terminal. 4) Login to Multics as usual. 5) Issue the command kermit -server. This puts Multics into a slave mode that you can take advantage of if your micro supports server commands. 6) Use the escape sequence ctrl-] c to get the prompt on the micro. 7) Issue the corresponding SEND or GET command to the micro. 8) The micro will display the status of the transmission. When transmission is complete, the micro kermit prompt will reappear. You can send or receive more files just by typing in a send or receive command to the micro. 9) When you are finished either type in a BYE command to logout the Multics kermit server or a FINISH command to terminate server mode and return to command level. In the latter case, you should reCONNECT. Available commands: The Multics implementation of Kermit allows the following commands. Optional arguments are enclosed in []. Items to be replaced by actual names or parameters (eg segment names) are enclosed in <>. SEND or SEND Sends either a single file to the micro or a group of files matching . At least one filename must match or the command is in error. If all is well, an OK prompt will appear and you can go back to the micro. RECEIVE [] Receive either a single file or multiple files from the micro. When sending files from the micro, the name of the file is also sent and will be used on the Multics side to name the segment. In the case of sending a single file, the file may be renamed by using an absolute or relative pathname for . By default, the files will be placed in your working directory. This may be changed by the SET DIR command (see below). You will get an OK prompt when Multics is ready to receive your file(s). More commands: HELP [] When issued without a command name, help will list the available kermit commands. When a command name is used, kermit will display a short description of the command, its parameters and actions. EXIT, QUIT, Q Leave Kermit and return to the Multics command level. EXEC or E or .. Send to the Multics command processor. Allows Multics commands to be executed without leaving Kermit. The line does not have to be enclosed in quotes. . Displays the current kermit version number and date. The set command: SET