INTRODUCTION Kermit is a file transfer program. It allows the transfer of files over terminal lines from a remote kermit program to the local kermit program. 1 @ This commamd opens an indirect file for command input. It is identical to the TAKE command. The format of the command is: Kermit-11>@ file-specification where 'file-specification' is any valid file specification on the system on which the server kermit is running. 1 BYE The BYE command will cause Kermit-11 (when in local mode) to tell the other kermit (which should be in server mode) to exit from kermit and if applicable terminate its job (or process, etc.). When Kermit-11 receives the acknowledgement that this is being done, it will prompt for another command. The DISCONNECT command should always follow the BYE command. The format for BYE is: Kermit-11>BYE 1 CONNECT The CONNECT command will allow you to connect in as a virtual terminal over the line that was specified by the set line command. (Using the CONNECT command before using the SET LINE command will result in an error message) The terminal line must be one which is accessable to the user. The format of the CONNECT command is: Kermit-11>CONNECT Since for RSX11M/M+ the SET SPEED command and the internal QIO issued to disable echoing require that Kermit be a privileged task, you may have to give the MCR SET /ECHO=TTnn: and SET /SPEED=TTnn:xxxx:xxxx first. This can be done using the SYSTEM command. 1 COPY The COPY command creates a copy of the input file. The Kermit-11 COPY command does NOT support wildcards in the filename, and while COPY does use multiblock buffering it is usually more efficient to use the system utilty PIP or the DCL command COPY for this. COPY uses RMS block i/o for both RSTS and RSX. Any executable RSTS file (*.TSK, *.BAC and *.SAV) copied will not be useable until it's run time system name and protection code is reset. Kermit-11> COPY From: ABCDEF.DAT To : FUBAR.LST or Kermit-11> COPY ABCDEF.DAT FUBAR.LST 1 DELETE The DELETE command will delete the specified file or file group from the system. Wildcards are permitted. Kermit-11>DELETE FUBAR.MAC Kermit-11>DELETE FUBAR.* 1 DIRECT The DIRECT command will display the current default directory when used in the format: Kermit-11>DIRECT If a directory other than the current default directory is desired then DIRECT may be used in the format: Kermit-11>DIRECT file-specification where 'file-specification' is any legitimate combination of device name, uic or ppn, and a filename which can include wild carding characters. 1 DISCONNECT The DISCONNECT command cuases Kermit-11 to 'hang-up' the line which was specified with the SET LINE command and connected with the CONNECT command. The format is: Kermit-11>DISCONNECT 1 ERASE The ERASE command will ERASE the specified file or file group from the system. Wildcards are permitted. Kermit-11>ERASE FUBAR.MAC Kermit-11>ERASE FUBAR.* The ERASE command is identical to the DELETE command. 1 EXIT The EXIT command will cause kermit to return to the command level. This command is the same as the QUIT command. The format is: Kermit-11>EXIT 1 FINISH The FINISH command will tell Kermit-11 ,which is in local mode, to signal the other kermit to exit from server mode. When Kermit-11 has received acknowledgement that this is being done it will prompt for another command. The command format is: Kermit-11>FINISH 1 GET The GET command tells the remote kermit which is in server mode to get a file or group of files. The format for this command is: Kermit-11>GET file-specification where 'file-specification' may include any legitimate device,ppn or uic as well as the file specification. Wildcarding may be used in the file-spec. to obtain a group of files. 1 HANGUP The HANGUP command will drop the remote line specified by the SET LINE command and connected by the CONNECT command. The same function is performed by the DISCONNECT command. The format of the HANGUP command is: Kermit-11>HANGUP 1 HELP As of this version (Version 1) of Kermit-11 the HELP command simply prints a list of all available commands in their proper format. The format of the HELP command is: Kermit-11>HELP 1 LOCAL The LOCAL command can be used to prefix any kermit command to insure that the command so prefixed will be carried out by the user's own kermit. All commands are local by default with the exceptions of BYE, FINISH,and GET. The LOCAL command format is: Kermit-11>LOCAL kermit command name 1 QUIT The QUIT command will cause Kermit-11 to return to the command level. This command is the same as the EXIT command. The format is: Kermit-11>QUIT 1 RECEIVE The RECEIVE command will put Kermit-11 into remote mode to wait for a single file transfer transaction. Kermit-11 will wait for a file transfer initialization from the other kermit. This command is useful if the other kermit does not support local server commands. Command format is: Kermit-11>RECEIVE Please note that this version of Kermit-11 (Version 1) does NOT support the RECEIVE Command in the format: Kermit-11>RECEIVE filename 1 REMOTE The REMOTE command is used as a prefix to indicate to Kermit-11 that the command so prefixed is to be executed by the other (remote) kermit server. Command format: Kermit-11>REMOTE will return a prompt requesting a command name: Remote Kermit cmd ? REMOTE can also be used with a command name as an argument: Kermit-11>REMOTE command name Please see HELP REMOTE command name for details. 2 BYE The REMOTE BYE command will cause Kermit-11 (when in local mode) to tell the other kermit (which should be in server mode) to exit from kermit and if applicable terminate its job (or process, etc.). When Kermit-11 receives the acknowledgement that this is being done, it will prompt for another command. The DISCONNECT command should always follow. This command (REMOTE BYE) is the same as the BYE command. The command format is: Kermit-11>REMOTE BYE or Kermit-11>REMOTE Remote Kermit cmd ?BYE 2 COPY The remote copy is just like the local copy command in that it creates a copy of the input file. Like the local Kermit-11 COPY command it does NOT support wildcards in the filename, and while COPY does use multiblock buffering it is usually more efficient to use the system utilty PIP or the DCL command COPY for this. COPY uses RMS block i/o for both RSTS and RSX. Any executable RSTS file (*.TSK, *.BAC and *.SAV) copied will not be useable until it's run time system name and protection code is reset. Kermit-11>REMOTE COPY From: ABCDEF.DAT To : FUBAR.LST or Kermit-11>REMOTE COPY ABCDEF.DAT FUBAR.LST 2 DIRECT The remote DIRECT command will tell the remote Kermit server to send a directory listing over the connection. Not all Kermit servers have this implemented. Kermit-11>REM DIR *.MAC The above example would tell the remote server to send a direc- tory listing of all files ending with a .MAC filetype. 2 ERASE The remote ERASE command will tell the remote Kermit server to delete any files matching the filespecification. For a Kermit-11 server, this can include wilcard characters. Kermit-11>REM ERASE *.MAC Files deleted: SY:[2,2]FUBAR.MAC SY:[2,2]HLPSUB.MAC Kermit-11> The remote Kermit server may respond with the filenames deleted, the above example is what a Kermit-11 server would respond with. 2 FINISH The REMOTE FINISH command will tell Kermit-11 , which is in local mode, to signal the other kermit to exit from server mode. When Kermit-11 has received acknowledgement that this is being done it will prompt for another command. REMOTE FINISH is the same as the FINISH command. The command format is: Kermit-11>REMOTE FINISH or Kermit-11>REMOTE Remote Kermit cmd ?FINISH 2 GET The REMOTE GET command tells the remote kermit which is in server mode to get a file or group of files. REMOTE GET is the same as the GET command. The format for this command is: Kermit-11>REMOTE GET or Kermit-11>REMOTE Remote Kermit cmd ?GET 2 HELP The REMOTE HELP command instructs a remote Kermit server to send a list of remote commands that it can process. 2 RENAME The remote RENAME command is used to rename a file or set of files. RENAME is used with two arguments in the format: Kermit-11>REMOTE RENAME oldname newname If the remote RENAME is used with one or no argument it will prompt for missing arguments: Kermit-11>REMOTE RENAME From: oldname To: newname When the remote RENAME is finished the remote Kermit server will most likely return either a list of files renamed or a count of the number of files renamed. For a Kermit-11 server running remotely you would get a count of the number of files renamed. Kermit-11>REMOTE RENAME t.* junk Remote ack: 3 files renamed 2 SPACE The REMOTE SPACE command sends a generic command to the remote kermit requesting information about the amounts of space avail- able and space used on the remote host. Command format is: Kermit-11>REMOTE SPACE or Kermit-11>REMOTE Kermit Remote cmd ?SPACE 2 TYPE The REMOTE TYPE command is just like the TYPE command but it tells a remote Kermit server to get the file to be typed on your terminal and send it over. Kermit-11>REMOTE TYPE FUBAR.MAC 2 WHO The REMOTE WHO command instructs a remote Kermit server to send a listing of who's logged into the system. This is currently only operational for Kermit server running under RSTS/E. Please note that this command may be restricted by the system manager. Kermit-11>REMOTE WHO 1 RENAME The RENAME command is used to rename a local (only) file. RENAME can be used with two arguments is the format: Kermit-11>RENAME oldname newname If RENAME is used with one or no argument it will prompt for missing arguments: Kermit-11>RENAME From: oldname To: newname When RENAME is finished it will return a 'report' of what it has done: Kermit-11>RENAME t.* junk File DB0:[1,8]T.T1 renamed to DB0:[1,8]JUNK.T1 File DB0:[1,8]T.T renamed to DB0:[1,8]JUNK.T 1 SEND The SEND command will allow the user to send a file(s) to the other kermit. If Kermit-11 is running in remote mode the file will be sent on the controlling terminal line after waiting the number of seconds specified by the SET DELAY command. This gives the user time to escape to the other kermit and issue a receive command. If Kermit-11 is running in local mode , the file will be sent immediately on the terminal line specified by the set line command. Format of the SEND command is: Kermit-11>SEND file-specification Where 'file-specification' can include device,ppn or uic,as well as the file-spec. which may use wildcarding. 1 SERVER The SERVER command will put Kermit-11 into server mode. When Kermit-11 is in server mode while runnuing as a remote kermit (transmitting over the controlling terminal line) the other kermit can issue server commands to send and receive files without having to give SEND or RECEIVE commands to Kermit-11. In order to correctly receive binary files while in server mode a SET FILETYPE BINARY must be done first. At this time there is no way for Kermit-11 to determine whether an incomming file is ascii or binary. Command format is: Kermit-11>SERVER 1 SET The SET command is used to set various parameters in kermit. The format of the SET command is: Kermit-11>SET parameter keyword 2 BLOCK-CHECK The SET BLOCKCHECK command is used to determine the block check sequence which will be used during transmission. The block check sequence is used to detect transmission errors. There are three types of block check available. These are the single character checksum (default), the two character checksum, and the three character CRC (cyclic redundancy check). This command does not ensure that the desired type of block check will be used, since both Kermit's involved in the transfer must agree on the block check type. Kermit-32 will request that the type of block check set by this command be used for a transfer. If the other Kermit has also had the same block check type requested, then the desired block check type will be used. Otherwise, the single character checksum will be used. The command should be given to BOTH Kermits since Kermit-11, when in server mode, has no say about what kind of checksum it wants to use. (See Kermit protocol manual for more information.) Kermit-11>SET BLOCK_CHECK keyword Where keyword is one of: 1_CHARACTER_CHECKSUM or ONE_CHARACTER_CHECKSUM 2_CHARACTER_CHECKSUM or TWO_CHARACTER_CHECKSUM 3_CHARACTER_CRC_CCITT or THREE_CHARACTER_CRC_CCITT 2 DEBUG The SET DEBUG command is used to specify the type and level of debugging to a disk file . This disk file must have been created by the SET LOGFILE command. The format for SET DEBUG is: Kermit-11>SET DEBUG qualifier 3 ALL SET DEBUG ALL will turn on logging for CONSOLE,CONNECT,FILE,PACKET and STATE to the disk file specified by SET LOGFILE. This commamd is the same as SET DEBUG ON. The command format is: Kermit-11>SET DEBUG ALL 3 CONSOLE SET DEBUG CONSOLE will turn on logging for all i/o during a remote connect to the disk file specified by SET LOGFILE. This command is the same as SET DEBUG CONNECT. The command format is: Kermit-11>SET DEBUG CONSOLE 3 CONNECT SET DEBUG CONNECT will turn on logging for all i/o during a remote connect to the disk file specified by SET LOGFILE. This command is the same as SET DEBUG CONSOLE. The command format is: Kermit-11>SET DEBUG CONNECT 3 FILE SET DEBUG FILE will log all file 'opens' and 'creates' to the file specified by SET LOGFILE. The command format is: Kermit-11>SET DEBUG FILE 3 HELP SET DEBUG HELP gives the user a list of all qualifiers which can be used with SET DEBUG. Command format is: Kermit-11>SET DEBUG HELP 3 NONE SET DEBUG NONE 'turns off' all debugging. This is the same as the SET DEBUG OFF command. Command format is: Kermit-11>SET DEBUG NONE 3 OFF SET DEBUG OFF 'turns off' all debugging. This is the same as the SET DEBUG NONE command. Command format is: Kermit-11>SET DEBUG OFF 3 ON SET DEBUG ON will'turn on' logging for CONSOLE,CONNECT,FILE,PACKET and STATE to the disk file specified by SET LOGFILE. This commamd is the same as SET DEBUG ALL. The command format is: Kermit-11>SET DEBUG ON 3 PACKET SET DEBUG PACKET will 'turn on' logging of all receive and transmit packets to the disk file specified by SET LOGFILE. The command format is: Kermit-11>SET DEBUG PACKET 3 STATE SET DEBUG STATE will turn on logging of all internal Kermit-11 state transitions 2 DELAY The DELAY parameter is the number of seconds to wait before sending data after a SEND command is given. This is used when Kermit-11 is running in remote mode to allow the user time to escape back to the other Kermit and give a RECEIVE command. Kermit-11>SET DELAY number-of-seconds Where number of seconds is the (decimal) number of second to wait before sending data. 2 DEFAULT The DEFAULT parameter allows you to specify a device and UIC (or PPN) for all subsequent file opens (for SENDING) and file creates (for RECEIVING). It is disabled by typing SET HOME. Kermit-11>SET DEFAULT device 2 END-OF-LINE The END-OF-LINE parameter sets the ascii character which will be used as a line terminator for all packets SENT to the other KERMIT. This is normally not needed for most versions of KERMIT. Kermit-11>SET END-OF-LINE octal value of character 2 ESCAPE This command will set the escape character for the CONNECT processing. The command will take the octal value of the character to use as the escape character. This is the character which is used to "escape" back to Kermit-32 after using the CONNECT command. It defaults to control \ (octal 34). It is usually a good idea to set this character to something which is not used (or at least not used very much) on the system being to which Kermit-11 is CONNECTing. Kermit-11>SET ESCAPE octal-character-value Where octal-character-value is the ASCII value of the character to use as the escape character (in octal). 2 FILETYPE This command will set the file type that Kermit is receiving. A file type of ASCII should be used to receive text files which are to be used as text files on the PDP11 system. The file type BINARY should be used for binary files, such as CP/M .COM files, which need to be kept in a format that allows the file to be returned without any changes. Kermit-11>SET FILE_TYPE type 3 ASCII File type ASCII is for text files. 3 BINARY File type BINARY is for non-text files. Note that binary files which are generated on a PDP11 system cannot be transferred to another PDP11 system without losing file attributes. This means that (for example), an RSM11 indexed file cannot be transmitted with Kermit-11. 2 HANGUP SET HANGUP is the same as the DISCONNECT command. It forces a connected line (specified via the SET LINE command) to be dropped. This is currently only supported for RSTS version 8. Kermit-11>SET HANGUP 2 HOME SET HOME resets the default device and UIC (or PPN) to nothing, ie, all file opens and creates use your default disk (SY:) and your UIC (or PPN). Kermit-11>SET HOME 2 IBMMODE IBM mode has not yet been implemented 2 LINE The SET LINE command sets the terminal name up for use with the connect command. To use this you must have access to that device. On many systems terminal lines other than your own are protected from access, and may require special procedures to access them. The form of the device name is TTnnn:, where 'nnn' is a decimal number for RSTS and an octal number for RSX11M/M+. Kermit-11>SET LINE TT55: 2 LOGFILE The SET LOGFILE command creates a debug dump file for you. It must be used BEFORE any SET DEBUG commands can be used. See HELP DEBUG for further information about debugging modes. Kermit-11>SET LOGFILE MYLOG.TXT Created debug file MYLOG.TXT Kermit-11> 2 PACKET-LENGTH You can alter the default transmitted packet length with the SET PACKET-LENGTH command. This should not normally be needed unless the line is very noisy, at which time you should probably give up anyway. Kermit-11>SET PACKET 60 2 PARITY This is used with the SET LINE and CONNECT commands to specify the type of parity for the remote link. It defaults to NONE and can be either ODD or EVEN, as in: Kermit-11>SET PARITY NONE Kermit-11>SET PARITY ODD Kermit-11>SET PARITY EVEN If you choose ODD or EVEN, you will be unable to send BINARY files using Kermit-11 (at this time, version 1). This is currently available only for Kermit on RSTS (25-Jan-84 15:11:01) 2 PAUSE PAUSE tells Kermit to wait the specified number of seconds between each packet being sent to the other Kermit. This may be useful under situations of heavy system load. This may be automatically computer by Kermit-11 in a future release as a function of line speed. Kermit-11>SET PAUSE 1 2 RECORD-FORMAT Kermit will, by default, create RMS11 variable length implied carriage control records for text files. You can override this and change it to create stream ascii records with the SET RECORD-FORMAT STREAM command. This is useful for RSTS/E systems if you need file compatibility with BASIC Plus. Kermit-11>SET RECORD-FORMAT STREAM Kermit-11>SET RECORD-FORMAT VARIABLE This command would be most useful in a KERMIT.INI file, which is executed by KERMIT when Kermit starts. 2 RETRY SET RETRY value tells Kermit to try that many times on a NAK'ed packet before giving up. This should only be needed if the line is extremely noisy or the PDP11 host is running very slowly due to the system load. Kermit-11>SET RETRY 10 2 SPEED SET SPEED value sets the line speed for the device specified via the SET LINE command, and used for the CONNECT command. Changing the speed of a terminal line requires privilege for RSTS and RSX11M/M+. Kermit-11>SET SPEED 1200 1200 Baud would be a normal speed to use with a VA212LS or a DF03. 2 TIMEOUT The timeout value tells Kermit how long to wait to get a packet from the other Kermit. If system loads are high, it may be desirable to increase this beyond the default of 10 seconds. 1 SHOW The SHOW command will display the settings made by the SET command and allow you to look at session statistics. Kermit-11>SHOW parameter 2 ALL Displays everything: BLOCK-CHECK DEBUG DEFAULT ESCAPE FILE-TYPE LINE PACKET PARAM TIME VERSION 2 BLOCK-CHECK-TYPE Displays the current type of checksum set. 2 DEBUG Shows the status of debugging. 2 DEFAULT Shows the device and UIC (or PPN) used for file operations. 2 ESCAPE Shows the escape character used to return to a local Kermit-11 2 FILE-TYPE Shows the current filetype (BINARY or ASCII) 2 LINE Displays parameters associated with the current connect line. 2 PACKET Prints out packets statistics from the last transaction and total so far. 2 PARAMETERS Prints out various send parameters 2 RECORD-FORMAT Shows what kind of file will be created by Kermit. 2 TIME The time of day 2 VERSION My current version and edit. 1 STARTUP You can place a file called KERMIT.INI in your account and have Kermit-11 automatically read commands from it before getting commands from your terminal. 1 SYSTEM The SYSTEM command takes a CCL/MCR/DCL command line and spawns a task to execute it. This is done via the SPWN$S directive for RSX and by spawning a job on a psuedo kerboard for RSTS. If the command fails for RSTS then Kermits protection code was set to run without privileges. Kermit-11>SYS PIP DB1:=FUBAR.DAT Kermit-11>SYS Command: SUB MYJOB Kermit-11> 1 TAKE The Take command is just like the  command. It opens a disk file for reading commands from, as in TAKE filename. Kermit-11>TAKE MYKERM.CMD 1 TYPE The TYPE command prints a file to your terminal, as in: Kermit-11>TYPE KERMIT.INI 1 WHO The WHO command (currently for RSTS/E only) prints a brief SYSTAT out.