QK-KERMIT 3.1 --------------------------------------------------------------------------- SCRIPT/VS 3.2.0: DEVICE 1403QUCS CHARS MONO INTRODUCTION ____________ Kermit is a protocol for transferring files between com- puters over telecommunication lines. It does packetizing, checksumming, and retransmission to ensure data integrity. Microcomputer implementations of Kermit also provide termi- nal connection at any speed allowed by both the micro and the host. Kermit is like many other such protocols, but with several differences: y It's free. y It's documented. y It's well tested and in wide use. y Implementations exist for many different systems, in- cluding DEC and IBM mainframes and many microcomputers. Each implementation is written in the language best suited for a particular machine or operating system. Kermit was developed at the Columbia University Center for Computing Activities primarily to facilitate offline storage of DECSYSTEM-20 files on microcomputer floppy disks. The Kermit specification has since served as the basis for many implementations of Kermits on a wide variety of systems. Any Kermit can communicate with any other Kermit. Kermit does not rely on any host system software or servers. All actions are initiated explicitly by the user. Typi- cally, the user: y starts Kermit on a microcomputer, y "connects" through Kermit to the remote host, y logs on, y starts Kermit on the remote host, y "escapes" back to the micro, y and issues SEND and RECEIVE commands to send files back and forth between the two systems. Kermit can transfer files singly or in wildcard groups. QK-Kermit is a version of Kermit for MS-DOS and CP/M systems written at Queen's University in Turbo-PASCAL. The CP/M versions provide ADM3A terminal emulation; the MS-DOS ver- sion emulates a VT-100 terminal. When using the MS-DOS ver- sion with Queen's VM/CMS system, specify terminal type IBMPC. For the KAYPRO version, specify terminal type KAYPROK; for Apple IIe specify APPLE2E. Version 3.0 is for MsDos systems only. For CP/M systems use version 2.8 1 KERMIT --------------------------------------------------------------------| ------->|-- Connect ----------------------| | |-- --| |-- Wait -------------------------| |-- SENd -----------------------------------------| | |-- AS remote-filespec>----------------| | |-- AW --| | |-- RECeive -------------------------------------| | |-- AS -------------| | |-- EPLACE --| |-- SET -----------------------------------------------------------| | |-- <300|1200|2400|4800|9600> -----------| | |-- ----------------| | |-- -------------------------| | |-- ------------| | |-- -----------------------| | |-- ---------------------------| | |-- ----------------------| | |-- ------------------------| | |-- -----| | | |-- ------| | | |-- -----| | | |-- ---|-- --| | |-- -----| | | |-- --| | | | | | |-- ---|-- -----| | |-- ---| | |-- -----| |-- STatus --------------------------------------------------------| |-- DIrectory -----------------------------------------------------| | |-- --| |-- Erase ----------------------------------------| |-- REName -------------------| |-- TYpe -----------------------------------------| |-- RUn ------------------------------------------| |-- MKdir -- -------------------------------------| |-- CHdir -- -------------------------------------| |-- RMdir -- -------------------------------------| |-- REMote -----------| |-- Log -----------------------------------------------------------| | |-- --| |-- TAke --- --------------------------------------------| |-- CLear ---------------------------------------------------------| |-- INput ----------------------------------------| |-- utput--------------------------------------------------| |-- PAUse ------------------------------------------------| |-- Echo --------------------------------------------------| |-- DEfine --------------------------------------------------------| | |-- ------------------------| | |-- --| |-- udio-----------------------------------------------------------| |-- arms-----------------------------------------------------------| |-- Quit ----------------------------------------------------------| 2 |-- Local ---| |-- Remote --| |-- Discon --| |-- All -----| 3 QK-KERMIT COMMANDS __________________ The Kermit commands may be abbreviated to the minimum number of unique characters; i.e. CONNECT may be abbreviated to C and STATUS may be abbreviated to ST, but SET has no abbre- viation since there is a SEND command which also begins with SE. Commands may be issued in a string as parameters to the Kermit startup command to the operating system, or as internal commands once Kermit is running. All parameter specifications are optional. If the command requires a parameter specification and one is not supplied, then Kermit will prompt you for the required information. CONNECT < option settings> This command causes the micro to simulate a termi- nal connected to another computer. This allows one to sign on to the Host computer as a terminal. The optional parameters specify the option setting (See SET command for options). To exit this terminal connect mode and return to the Kermit command mode type in a CONTROL \ . Note: When the connect command is issued, Kermit checks the line for DSR and CTS signals and if it does not find them it assumes the modem is not connected. It then issues a message Please connect modem every few seconds until it finds the signal. It may be, however, that your particular computer does not detect the presence of these signals even when the modem is connected. In this case we can by pass the signal checking by hitting the SPACE bar on the keyboard. WAIT This command is similar to the CONNECT command ex- cept in this case it waits for some to connect to it. You may consider WAIT as answering, and the CONNECT as originating. SEND AS RAW Sends a file to the remote host system. Wild-card characters are permitted to send multiple files. Normally only the local filename is specified if you do not want a different file name on the host system. QK-Kermit Commands 4 The RAW specification is only used if the remote host does not have a Kermit, and we wish to send the file as is (unpacketed). For example: SEND ABCD.FIL SEND MYFILES.* AS YOURS.* SEND A:WXYZ.DAT Several single-character commands may be given while a file transfer is in progress: ^Z Stop sending this file, and don't send any further files. ^X (Control-X) Stop sending the current file and go on to the next one, if any. ^E Like ^C, but send an Error packet to the re- mote Kermit in an attempt to bring it back to server or interactive command level. ^C Return to Kermit-MS command level immediately without sending any kind of notification to the remote system. Control-X and Control-Z send the proper protocol messages to the remote Kermit to bring it grace- fully to the desired state. Control-C leaves the remote Kermit in whatever state it happens to be in. Control-E "aborts" any protocol that is tak- ing place. RECEIVE as REPLACE Gets a file from the remote host system and puts it to the destination device (usually the disk). If the local-filename is not specified then the local filename is the same as the remote file name with the remote filetype truncated to 3 char- acters. If the local file name already exist the local file name is modified with an '&'. If how- ever the REPLACE option is specified then the old file is replaced by the newly received file. For example: RECEIVE MYPROG.PASCAL REC D:*.SCRIPT AS *.WS Several single-character commands may be given while a file transfer is in progress: ^Z Stop sending this file, and don't send any further files. ^X (Control-X) Stop sending the current file and go on to the next one, if any. ^E Like ^C, but send an Error packet to the re- mote Kermit in an attempt to bring it back to server or interactive command level. QK-Kermit Commands 5 ^C Return to Kermit-MS command level immediately without sending any kind of notification to the remote system. Control-X and Control-Z send the proper protocol messages to the remote Kermit to bring it grace- fully to the desired state. Control-C leaves the remote Kermit in whatever state it happens to be in. Control-E "aborts" any protocol that is tak- ing place. SET