@make(manual) @Style @modify(hd1,spacing 2,above 1,below 1) @modify(hd2,spacing 2,above 1,below 1) @modify(hd3,spacing 2,above 1,below 1) @modify(hd4,spacing 2,above 1,below 1) @PageHeading
@tabclear @tabs(12,42,54) @begin(Titlepage) @begin(Titlebox) @majorheading(KERMIT-65 USERS GUIDE) @heading(C64 Version 1.0 Beta Test) @end(Titlebox) @begin(heading) Compiled By: Eric Lavitsky @value(Date) Center For Computer and Information Services Rutgers University Piscataway, New Jersey @end(heading) @end(titlepage) @newpage(1) @set(page=1) @PageHeading(Even,Left="Page @ref(page)",Right="@b") @PageHeading(Odd,Left="@b<@Title[Chapter]>",Right="Page @ref(page)") @chapter(Introduction) @section(Overview) KERMIT-65 is a program that implements the KERMIT file transfer protocol for the Commodore 64 micro computer system. It is written in 6502 assembly language and should run on any C64. KERMIT-65 also Converts your C64 into a powerful computer terminal. It emulates the popular Digital Equipment Corporation VT52 terminal or a simple glass TTY. C64 Kermit-65 was translated by Dave Dermott from the original Apple version 1.0 by Antonio J. Mione. Several enhancements and bug fixes including many from Apple version 2.1 were added by Eric Lavitsky. @i @begin @tabclear()@tabset(3.5inches,4.0inches) Local operation:@\Yes Remote operation:@\No Transfers text files:@\Yes Transfers binary files:@\No? Wildcard send:@\No ^X/^Y interruption:@\No Filename collision avoidance:@\No Can time out:@\No 8th-bit prefixing:@\No? Repeat count prefixing:@\No Alternate block checks:@\No Terminal emulation:@\Yes (VT52) Communication settings:@\Yes; local echo, parity Transmit BREAK:@\Yes IBM communication:@\Yes? Transaction logging:@\No Session logging (raw download):@\No Raw upload:@\No Act as server:@\No Talk to server:@\Yes Advanced commands for servers:@\No Local file management:@\Yes Handle file attributes:@\No Command/init files:@\No Printer control:@\No @end(format) @tabs(12,42,54) @section(System Requirements) What you will need: @begin(itemize, spread 0) C64 and Disk drive Modem - any will do (300/1200, VIC, RS232) Supermon64.V1 (or any equivalent relocatable monitor) @end(itemize) @chapter(Known Bugs, Deficiencies) KERMIT-65 is currently missing some features which exist in Apple KERMIT-65. There are also some restrictions which apply. The differences and restrictions are as follows: @begin(itemize,spread 0) IBM mode is not supported. The FILE-WARNING option is not implemented. If a file already exists, a fatal error occurs. The SET PARITY option is not implemented. Parity must be set with SET RS232-REGISTERS. @end(itemize) @section(HINTS) If you wish to edit BASIC programs on the mainframe system, you should convert them to text files on the C64 before you send them since the BASIC interpreters store keywords as single character tokens. If the receiving system does not handle eight-bit ASCII or CBM ASCII characters well, KERMIT-65 should have its FILE-BYTE-SIZE set to SEVEN-BIT. It will send standard seven-bit ASCII to the receiving KERMIT. When KERMIT-65 is receiving from such a system, this will pick up the seven-bit characters and write out CBM ASCII on the disk file. @chapter(Running KERMIT) @section(Booting KERMIT) Insert your working KERMIT-65 disk into the 1541 drive label side up. Type the following: @begin(verbatim) LOAD"KERMIT",8 RUN @end(verbatim) The screen will come up with the following message: @begin(format) @\@b[C64 Kermit-65 V1.1 40 Column Mode] @\@b[Kermit-65>] @end(format) You are now in the KERMIT-65 parser which is modeled after the COMND parser of the TOPS-20 Operating System from Digital Equipment Corporation. You may now type commands to the parser to set options or begin actions. During interactive operation, you may use the ?-prompting help feature ("?") and recognition (ESC) features while typing commands. A question mark typed at any point in a command displays the options available at that point; typing an ESC character causes the current keyword to be completed (or default value to be supplied). If you have not typed sufficient characters to uniquely specify the keyword or filename (or if there is no default value) then a beep will be sounded and you may continue typing. Keywords may be abbreviated to any prefix that is unique. @section(Commands in KERMIT) Commands available in version 1.1 of Kermit-65 are: @tabclear @tabdivide(7) @begin(format) @b[ @\BYE@\CONNECT@\DOS@\EXIT@\FINISH@\GET @\QUIT@\RECEIVE@\SEND@\SET@\SHOW@\STATUS] @end(format) @begin(description) @b[BYE]@\@\ This command will cause Kermit-65 to tell a server Kermit at the other end of the connection to exit from Kermit and, if applicable, terminate its job (or process, etc.). When Kermit-65 receives the acknowledgement that this is being done, it will exit to DOS. @begin(center) @b[KERMIT-65>]BYE @end(center) @end(description) @begin(description) @b[CONNECT]@\@\The CONNECT command will allow you to connect to a remote job over the terminal line as a virtual terminal. The format of the CONNECT command is: @begin(center) @b[KERMIT-65>]CONNECT @end(center) @end(description) @begin(description) DOS@\@\The DOS command will invoke a separate parser to allow the sending of commands to the disk drive. The format is: @begin(center) @b[KERMIT-65>]DOS @end(center) @\Commands are in standard DOS format as decribed in the disk manual. They include $ for directory (note block counts are in hex!), S to scratch files. A blank line (RETURN) will display the disk error status if any. Enter Q to return to KERMIT. eg: @tabclear @tabdivide(9) @begin(format) @\@\@b[DOS>]$KER*@\-- directory of ker* files @\@\@b[DOS>]S0:a*@\-- delete files A* @\@\@b[DOS>]Q@\-- returns to KERMIT @end(format) @tabdivide(7) @end(description) @begin(description) EXIT@\@\The EXIT command will cause Kermit to return to BASIC command level. This command is the same as the QUIT command. An example of this command is: @begin(center) @b[KERMIT-65>]EXIT @end(center) @end(description) @begin(description) @b[FINISH]@\@\This command will cause Kermit-65 to tell a server Kermit at the other end of the connection to exit from Kermit. When Kermit-65 receives the acknowledgement that this is being done, Kermit-65 will prompt for another command. @begin(center) @b[KERMIT-65>]FINISH @end(center) @end(description) @begin(description) @b[GET]@\@\ This command can only be used in 'user' mode. It will cause Kermit-65 to request that the other Kermit (which must be running in server mode) transmit the specifed file to Kermit-65. @begin(center) @b[KERMIT-65>]GET file-specification @end(center) @\@\Where "file-specification" is a valid file specification for the system on which the other Kermit is running. @end(description) @begin(description) @b[QUIT]@\@\ This command will cause Kermit-65 to return to BASIC command level. This is the same as the EXIT command. @begin(center) @b[KERMIT-65>]QUIT @end(center) @end(description) @begin(description) @b[RECEIVE]@\@\The RECEIVE command is used to put Kermit-65 into remote mode waiting for a single file transfer transaction. If no file specification is given, Kermit-65 will wait for a file transfer initialization sequence from the other Kermit. If a file specification is given, that file specification will be used to store the received file(s), regardless of what name is supplied by the other Kermit. @begin(center) @b[KERMIT-65>]RECEIVE @end(center) or @begin(center) @b[KERMIT-65>]RECEIVE file-specification @end(center) @\@\Where "file-specification" is any valid CBM DOS file specification. @end(description) @begin(description) @b[SEND]@\@\ The SEND command will allow you to send a file to the other Kermit. The command format is: @begin(center) @b[KERMIT-65>]SEND file-specification @end(center) @\@\Where "file-specification" is any normal CBM DOS file specification. @end(description) @begin(description) @b[SET]@\@\ The SET command is used to set various parameters in Kermit. The format of the command is: @begin(center) @b[KERMIT-65>]SET