3 %%DocumentFonts: (atend)
4 %%Creator: Frank da Cruz,718W,0000, and Scribe 7(1700)
5 %%CreationDate: 25 May 1991 14:10
8 % PostScript Prelude for Scribe.
9 /BS {/SV save def 0.0 792.0 translate .01 -.01 scale} bind def
10 /ES {showpage SV restore} bind def
11 /SC {setrgbcolor} bind def
14 {SSZ 0.0 0.0 SSZ neg 0.0 0.0 FMTX astore}
15 {SSZ 0.0 SLT neg sin SLT cos div SSZ mul SSZ neg 0.0 0.0 FMTX astore}
16 ifelse makefont setfont} bind def
18 /SI { /SLT exch cvr def RDF} bind def
19 /WFT /Courier findfont def
20 /SF { /WFT exch findfont def RDF} bind def
22 /SS { /SSZ exch 100.0 mul def RDF} bind def
23 /AF { /WFT exch findfont def /SSZ exch 100.0 mul def RDF} bind def
25 /XM {currentpoint exch pop moveto} bind def
26 /UL {gsave newpath moveto dup 2.0 div 0.0 exch rmoveto
27 setlinewidth 0.0 rlineto stroke grestore} bind def
28 /LH {gsave newpath moveto setlinewidth
30 gsave stroke grestore} bind def
31 /LV {gsave newpath moveto setlinewidth
33 gsave stroke grestore} bind def
34 /BX {gsave newpath moveto setlinewidth
37 exch 0.0 exch neg rlineto
40 gsave stroke grestore} bind def
41 /BX1 {grestore} bind def
42 /BX2 {setlinewidth 1 setgray stroke grestore} bind def
43 /PB {/PV save def newpath translate
44 100.0 -100.0 scale pop /showpage {} def} bind def
45 /PE {PV restore} bind def
46 /GB {/PV save def newpath translate rotate
47 div dup scale 100.0 -100.0 scale /showpage {} def} bind def
48 /GE {PV restore} bind def
49 /FB {dict dup /FontMapDict exch def begin} bind def
50 /FM {cvn exch cvn exch def} bind def
51 /FE {end /original-findfont /findfont load def /findfont
52 {dup FontMapDict exch known{FontMapDict exch get} if
53 original-findfont} def} bind def
54 /BC {gsave moveto dup 0 exch rlineto exch 0 rlineto neg 0 exch rlineto closepath clip} bind def
55 /EC /grestore load def
57 /MX {exch show 0.0 rmoveto} bind def
58 /W {0 32 4 -1 roll widthshow} bind def
59 /WX {0 32 5 -1 roll widthshow 0.0 rmoveto} bind def
60 /RC {100.0 -100.0 scale
63 .01 -.01 scale} bind def
64 /URC {100.0 -100.0 scale
67 .01 -.01 scale} bind def
68 /RCC {100.0 -100.0 scale
69 0.0 -792.0 translate 90.0 rotate
70 .01 -.01 scale} bind def
71 /URCC {100.0 -100.0 scale
72 -90.0 rotate 0.0 792.0 translate
73 .01 -.01 scale} bind def
80 (CP/M-80 KERMIT VERSION 4.11 USER GUIDE)SH
85 (Columbia University Center for Computing Activities)SH
87 (New York, New York 10027)SH
93 (Copyright \050C\051 1981,1991)SH
95 (Trustees of Columbia University in the City of New York)SH
98 (Permission is granted to any individual or institution to use, copy,)SH
100 (or redistribute this document so long as it is not sold for profit, and)SH
102 (provided this copyright notice is retained.)SH
109 (1. CP/M-80 KERMIT)SH
113 46800 50 8280 5709 UL
116 (1. CP/M-80 KERMIT)SH
122 (Mike Freeman, Bonneville Power Administration, Vancouver, WA, USA,)
123 139 W( with contributions from)138 W
131 (8080 Assembler, LASM, M80, or MAC80)SH
149 (Christine Gianone, Columbia University, with contributions from many others.)SH
152 (KERMIT-80 Capabilities At A Glance:)SH
159 (Remote operation:)SH
161 (Partial, Auto-receive only)SH
167 (Transfer text files:)SH
171 (Transfer binary files:)SH
179 (File transfer interruption:)SH
183 (Filename collision avoidance:)SH
191 (8th-bit prefixing:)SH
195 (Repeat count prefixing:)SH
199 (Alternate block checks:)SH
203 (Terminal emulation:)SH
205 (Yes, VT52 and others)SH
207 (Communication settings:)SH
211 (Support for dial-out modems:)SH
217 (Yes; most versions)SH
219 (IBM communication:)SH
223 (Transaction logging:)SH
235 (Raw file transmit:)SH
247 (Advanced commands for servers:)SH
251 (Command/init files:)SH
259 (Local file management:)SH
263 (Handle file attributes:)SH
271 (International Character Sets:)SH
287 (CP/M Kermit is the first)
288 170 W( of all the Kermit programs. It was originally written by Bill Catchings of Columbia)171 W
290 (University in 1981.)
292 486 W( the years, contributions have been added by many people, including Charles Carvalho)118 W
294 (\050ACC\051, Bernie Eiben \050DEC\051, Nick Bush \050Stevens Institute of Technology\051, John Bray)
295 109 W( \050University of Tennessee\051,)110 W
297 (Bruce Tanner \050Cerritos College\051, Greg Small \050University)
298 99 W( of California at Berkeley\051, Kimmo Laaksonen \050Helskini)98 W
300 (University of Technology\051, Bertil Schou \050Loughborough)
301 391 W( University\051, Jon Warbrick \050Plymouth Polytechnic)392 W
303 (University\051, Brian Robertson \050Aberdeen University\051, A.J. Cole)
304 99 W( \050Leeds University\051, John Shearwood \050Birmingham)98 W
306 (University\051, Tony Addyman \050Salford University\051,)
307 180 W( Godfrey Nix and Martin Carter \050Nottingham University\051, Ian)181 W
317 (Kermit User Guide: CP/M-80 KERMIT 1.1)SH
318 46800 50 6120 5709 UL
321 (Young \050Edinburgh University\051, Chris Miles \050Manchester University\051,)
322 144 W( Richard Russell, Dave Roberts, and many,)143 W
326 (Version 4.11 is the work of Mike Freeman of the Bonneville Power Administration in Vancouver, WA, USA, with)49 W
328 (assistance from Russell Lang of Monash University in Australia, Jay S Rouman of Mt Pleasant MI, and others.)SH
334 (Features added since version 4.09 include:)SH
340 (SET COLLISION {BACKUP/DISCARD/OVERWRITE/RENAME})SH
346 (SET INCOMPLETE-FILES {DISCARD/KEEP})SH
352 (Many REMOTE commands, including some REMOTE SET commands)SH
358 (RENAME command to rename CP/M files from within Kermit-80)SH
364 (SET RECEIVE/SEND PACKET-LENGTH nn \050nn <= 94\051)SH
371 122 W( ON now implies that Kermit-80 ALWAYS tries to receive more files when a)121 W
373 (RECEIVE transaction has completed. The user can cancel with ^C.)SH
379 (QUIT is now a synonym for EXIT.)SH
385 (STAY is now a synonym for SET NO-EXIT.)SH
391 (CONNECT, RECEIVE and SEND may be abbreviated to C, R and S, respectively.)SH
397 (Cancellation of TAKE, TYPE, and PRINT commands from the keyboard.)SH
409 (Kermit-80 Version 4.11 now supports the Microbee family)
410 67 W( of computers \05056K, 64K, 128K and 256K\051)68 W
412 (manufactured by Microbee Systems, Ltd, of Australia.)SH
418 (Kermit-80 now supports the Ampro Little Board system.)SH
421 (1.3. Overview of Kermit Operation)SH
424 (Use the SET command to)
425 210 W( establish necessary communication parameters like SPEED and PARITY. Use the)209 W
427 (CONNECT to establish a terminal connection to the remote computer. If you are dialing out with a modem, type)76 W
429 (the necessary dialing commands to the modem first. The dialing process can be automated to some extent)
433 17 W( file containing INPUT, OUTPUT, and PAUSE commands. Then log in to the remote computer or)18 W
435 (service and conduct a session.)SH
437 (To transfer a text file, start the Kermit)
438 137 W( program on the remote computer and tell it to SEND the desired file \050if)136 W
440 (uploading\051 or to)
441 49 W( RECEIVE \050if downloading\051. "Escape back" to CP/M Kermit, usually by typing Ctrl-] \050hold down)50 W
443 (the Control key and press the right bracket key\051 and then)
444 181 W( type the letter C. At the CP/M Kermit prompt type)180 W
446 (RECEIVE \050if you gave a SEND command to the remote Kermit\051 or SEND)3 W
453 3 W( receive command)4 W
455 (to the remote Kermit\051.)SH
457 (To transfer a binary file, give the command)
458 13 W( SET FILE TYPE BINARY to the remote Kermit and SET FILE-MODE)12 W
460 (BINARY to CP/M Kermit before issuing any SEND or RECEIVE commands.)SH
462 (Multiple files of the same type \050text or binary\051)
463 107 W( can be transferred in a single operation using "wildcard notation")108 W
465 (\050including special characters like asterisk in the filename\051.)SH
472 (1.3. Overview of Kermit Operation)SH
476 46800 50 8280 5709 UL
479 (When file transfer is complete, CONNECT back to the remote computer, use the)
480 73 W( EXIT command to exit from the)72 W
482 (remote Kermit program, finish your work on the remote computer, log out from it, escape back to)
483 111 W( CP/M Kermit)112 W
485 (again, and EXIT from CP/M Kermit.)SH
487 (The remote Kermit may also be put into "server)
488 57 W( mode" to simplify these operations. Give the SERVER command)56 W
490 (to the remote Kermit, escape back to CP/M Kermit, and)
491 89 W( then issue SEND commands to send files \050upload\051, GET)90 W
497 (commands to receive \050download\051 files, REMOTE commands to request)
498 259 W( various other services \050like)258 W
500 (directory listings\051 from the remote Kermit. When you are)
501 103 W( done, give a BYE command to terminate your remote)104 W
504 87 W( a FINISH command to tell the remote Kermit to return to its prompt so you can CONNECT back and)86 W
506 (conduct further business.)SH
508 (That's all there is to it.)SH
511 (1.4. Summary of CP/M)SH
514 (There are essentially two versions of CP/M - Versions 2.2 and 3.0 \050sometimes also called CP/M PLUS.\051)SH
516 (CP/M-80 Version 2)95 W
521 95 W( a single 64 Kbyte "page", usually the largest amount of memory on Z80 or 8080)96 W
524 682 W( BIOS \050Basic input/output system\051, BDOS \050Basic Disk Operating System\051 and)
525 216 W( CCP \050Command)215 W
527 (console processor\051 all share memory with)
528 58 W( any transient program the user may wish to run. Some basic commands)59 W
530 (are available through the)
531 38 W( CCP, like DIR, ERA etc,while others are loaded from disk into the transient program area)37 W
533 (and run as a program, like PIP or STAT.)SH
539 (0 \050or CP/M PLUS\051 effectively removes the requirement of having the CCP and)
540 33 W( BDOS along with)34 W
543 54 W( BIOS code being resident in the single 64k byte page of memory. This allows even more space for)53 W
546 20 W( TPA, but still a little less than the maximum of 64k. It is substantially different from CP/M version)21 W
552 (2, with lots of added features. Kermit-80)
553 239 W( uses very few additional version 3)238 W
557 (0 features, and only where)238 W
559 (absolutely necessary.)SH
561 (CP/M file specifications are of the form)SH
582 500 W( omitted, the device name defaults to your)125 W
584 (connected diskette.)SH
596 (of up to 8 characters.)SH
607 (, up to 3 characters.)SH
609 (File names and file types may contain letters, digits, and some special characters, including dash, dollar)
612 (underscore, but no imbedded spaces. Upper and lower case letters are equivalent.)SH
614 ("Wildcard" file-group specifications are)
615 30 W( permitted in file names and file types \050but not device names\051 within certain)31 W
621 (" matches a whole field, a ")134 W
626 518 W( a single character, including space.)
634 (specifies all files whose)24 W
640 (start with F and are 1, 2, or 3 characters long; ")24 W
644 (" specifies all files whose names)25 W
646 (start with F and are no more than two characters long \050before the trailing spaces\051.)SH
648 (The five CP/M commands are:)SH
656 (Lists the the names of)
657 165 W( the specified files. The default file specification is "*.*". Example:)164 W
671 (Erases \050deletes\051 the specified file\050s\051; wildcards allowed.)SH
679 (Changes the name of a file from)SH
694 (REN NEW.FOR=OLD.FOR)SH
700 (Saves the specified number of memory blocks into a file. \050Not on CP/M Plus systems\051)SH
708 (Types the specified file on the screen, e.g. ")SH
722 (Kermit User Guide: CP/M-80 KERMIT 1.4)SH
723 46800 50 6120 5709 UL
726 (The most important programs are:)SH
730 (Gives statistics on disk usage; sets and displays IOBYTE. \050Not on CP/M Plus systems\051)SH
734 (Peripheral Interchange)
735 51 W( Program. Copies files. In response to the ")52 W
739 (" prompt, give a command)52 W
740 556 50 14120 11454 UL
741 333 50 18531 11454 UL
742 556 50 23553 11454 UL
747 (disk:outfile=disk:infile)SH
750 (Wildcards \050")71 W
754 (" for a whole field or ")71 W
759 392 W( a letter\051 can be used. Examples:)
766 (copy a whole disk, ")56 W
770 (" to copy all the Fortran programs)
771 56 W( from disk B to disk A. If)57 W
773 (the disk specification is omitted, your "connected" disk is assumed. Command line arguments)78 W
775 (are also accepted, e.g. ")SH
781 (There are equivalent commands for CP/M Version 3.0, but are not loaded into memory in the same)
782 4 W( way as for CP/M)5 W
784 (Version 2.2. For further information on CP/M, consult your microcomputer manual or a CP/M handbook.)SH
787 (1.5. Kermit-80 Description)SH
790 (Since Kermit-80 runs on a standalone micro, it is always in control of the screen --)
791 47 W( it is always in ")46 W
798 (includes a terminal emulator for establishing)
799 42 W( a connection to a remote computer or service, and during file transfer,)43 W
801 (it keeps the screen updated with the file name and the packet number, whether sending or receiving.)SH
804 12 W( capable of an imprecise or "fuzzy" timeout on an input request, and can break deadlocks automatically.)11 W
806 (In most cases, this is not important, because the Kermit program on)
807 55 W( the other side is most likely able to handle the)56 W
811 61 W( done by Kermit-80 are fuzzy because they depend on the speed of the processor and other)60 W
813 (factors that can vary from system to system.)SH
815 (If, despite the timeout capability, the transmission appears to be stuck \050and you)
816 26 W( can tell that this has happened if the)27 W
818 (screen fails to change for a while\051 you can type carriage return to have the micro do what it would)
819 56 W( have done on a)55 W
821 (timeout, namely NAK the expected packet to cause theforeign host to send it again \050or, if the micro is sending,)
824 (retransmit the last packet\051. Micro/micro or micro/IBM-mainframe)
825 207 W( transfers could require this kind of manual)206 W
829 (File transfers may be interrupted in several ways.)SH
833 (This will return you to Kermit-80 command level immediately, so that you can)
834 46 W( connect back to)47 W
836 (the remote system, or take any other desired action.)SH
840 (When sending a file, this will)
841 182 W( terminate the sending of the current file with a signal to the)181 W
843 (KERMIT on the other side to discard what it got so far. If there are more files to be sent,)157 W
845 (KERMIT-80 will go on to)
846 53 W( the next one. When receiving a file, KERMIT-80 will send a signal)52 W
848 (to the remote KERMIT to stop sending this file. If the remote KERMIT understands this)
851 (\050not all implementations of KERMIT do\051, it will comply, otherwise the file will keep coming.)91 W
853 (In any case, the remote KERMIT will go on to the next file in the group, if any.)SH
857 (Like Control-X, except if a file)
858 39 W( group is being transmitted, this will stop the transmission of the)40 W
860 (entire group. If only a single file is being transmitted, it works exactly like Control-X.)SH
864 (If you type a carriage return Kermit-80 will resend the current packet. You)
865 233 W( may do this)232 W
867 (repeatedly, up to the)
868 142 W( packet retry limit \050somewhere between 5 and 16 times\051 for a particular)143 W
877 (1.5. Kermit-80 Description)SH
881 46800 50 8280 5709 UL
884 (Kermit-80 Commands)SH
887 (Kermit-80 is an interactive program. It issues a prompt, you type a command. The process repeats until you)
890 (the EXIT command to leave the program.)SH
892 (Commands consist of keywords, filenames, and numbers. Keywords)
893 190 W( may be abbreviated to minumum unique)191 W
896 296 W( may be typed to request a menu of the available options)
897 23 W( for the current field at any point in a command.)22 W
899 (ESC may be typed at any point in a command to fill out the current keyword or filename;)
900 93 W( if sufficient characters)94 W
902 (have not been typed to identify the current field uniquely, Kermit-80 will)
903 75 W( sound a beep and allow you to continue)74 W
905 (from that point. Here are Kermit-80's commands:)SH
910 144 W( condition to the remote computer. This is only possible if your system is capable of)145 W
912 (sending breaks. It is intended to be used with PAUSE, OUTPUT, etc and)
913 136 W( the TAKE command to do)135 W
915 (wierd and wonderful things, like automatic logging on to a remote host.)SH
919 (When talking to a remote Kermit Server, this command shuts down the server)
920 103 W( and logs it out, and also)104 W
922 (exits from Kermit-80 to CP/M command level.)SH
926 (Establish a terminal connection to the computer, service, or)
927 135 W( device that is connected to the serial port,)136 W
930 SH( all typein to the serial port)
931 34 W( and display all input from the serial port on the screen. Also, emulate)33 W
933 (a DEC VT52 to allow)
934 62 W( cursor control, screen clearing, etc., if VT52-EMULATION is ON \050see below\051, in)63 W
936 (which case you should also set your terminal type on the remote host to VT52.)
938 385 W( versions emulate)67 W
940 (other terminals.\051 The CONNECT command may be abbreviated by the single letter C.)SH
942 (Warning: VT52 emulation is only successful if your system or its attached terminal can do the same)
946 47 W( a genuine VT52. Things to beware of are cursor addressing, clear to end of page and end)46 W
948 (of line, clear screen, home)
949 192 W( cursor, and clear-and-home functions. The useability of VT52 emulation)193 W
951 (depends entirely on how many of the VT52 functions can be emulated by your micro or terminal.)SH
954 103 W( character differs from micro to micro; when you issue the CONNECT command, the micro)102 W
957 40 W( a message telling you how to get back. The escape sequence is generally an uncommonly-used)41 W
959 (control character, like CTRL-backslash or CTRL-rightbracket, followed by a single letter "command":)SH
963 (Close Connection, return to)SH
973 (Display Status of connection, but maintain remote connection.)SH
979 (List available single-character commands.)SH
983 (\050zero\051 Send a null \0500\051 character.)SH
987 (Send a BREAK signal. Most systems provide this function.)SH
991 (Drop the line. Used on)
992 51 W( the Apple with modem. Automatically closes the connection after dropping)50 W
994 (the line. The TORCH system acknowledges this command but does nothing.)SH
998 (Toggle printer on or off. Allows you to copy whatever goes to the screen to the printer.)SH
1002 (Temporarily suspend logging to the log file.)SH
1006 (Restart logging to the log file)SH
1012 (\050or whatever - a second copy of the escape character\051 Send the escape character itself)
1013 69 W( to the remote)70 W
1020 (source destination)SH
1023 (Copy a named file to another file, either on the same drive or another drive.)SH
1027 (This provides a directory listing of the specified files.)
1029 303 W( no files are specified, all files on the default disk)26 W
1031 (are listed. File sizes, in K, are included. You may interrupt the listing)
1032 1 W( at any time by typing any character.)2 W
1034 (The listing \050even if interrupted\051 concludes with a display of the amount of free storage left)
1035 99 W( on the disk.)98 W
1037 (You can inhibit the display of file sizes by SET DIRECTORY OFF.)SH
1045 (This executes the CP/M ERA command on the specified file\050s\051. The names of the files being erased)
1052 (Quit back to CP/M. The return is made by a JMP 0 \050Warmstart\051. QUIT is a synonym for EXIT.)SH
1056 (Like LOGOUT, but shuts down the remote server)
1057 199 W( without logging it out. Leaves you at Kermit-80)200 W
1067 (Kermit User Guide: CP/M-80 KERMIT 1.5)SH
1068 46800 50 6120 5709 UL
1071 (command level; subsequent CONNECT commands will put you back at host system command level.)SH
1085 (When Kermit-80 is talking)
1086 67 W( to a Kermit Server on the host, you should use the GET command to request)68 W
1088 (the server to send files to you, for example:)SH
1094 (You may specify a local filename)
1095 264 W( if you want to save the remote file under a different filename.)263 W
1097 (Limitation: If you request an alternate block check type using)
1098 194 W( the SET BLOCK command, the GET)195 W
1100 (command will not communicate it to the remote server. If you want to have)
1101 7 W( type 2 or 3 block checks done)6 W
1103 (when getting files from the server, you have to issue)
1104 11 W( the appropriate SET BLOCK command to the remote)12 W
1106 (KERMIT before putting it in server mode.)SH
1110 (List all these commands,)
1111 27 W( with a short description on what the commands do. A question mark will do the)26 W
1114 408 W( you have already typed a command but do not know)
1115 79 W( what the parameters are, type a space \050to)80 W
1117 (indicate the end of the command\051 and a question mark.)
1119 335 W( will be informed of what Kermit can expect)42 W
1130 55 W( line and time delay for your CP/M system to expect from the host, then wait up to the given)54 W
1132 (number of seconds \050approximately\051 for text to be sent to your CP/M-80 system.)SH
1140 (When CONNECTed to a foreign host as a terminal, log the terminal session to the specified diskette file.)49 W
1142 (This functionality depends to some extent)
1143 13 W( on the remote host's ability to do XON/XOFF flow control, and)14 W
1145 (does not guarantee a complete transcript \050after all, that's what the KERMIT protocol is for\051. The log file)48 W
1147 (is closed when the connection is closed by typing the escape character followed by the single-character)104 W
1151 (It is possible to temporarily)
1152 98 W( suspend logging during connect state. Typing an escape sequence can turn)97 W
1154 (file logging on \050<escape-character> R for Resume\051 or off \050<escape-character> Q for quiet\051.)SH
1156 (Re-entering connect state will re-open the previously opened log file and append to that file.)SH
1160 (Like BYE, but leaves you at Kermit-80 command level.)SH
1168 (Send the text to the remote computer as if you had typed it.)SH
1176 (If this command is issued your CP/M system will wait)
1177 42 W( a while before proceeding with another command.)41 W
1179 (This is intended for use)
1180 21 W( in TAKE commands, where you may want to pause for a while before proceeding)22 W
1182 (with the rest of the TAKE file. The actual delay)
1183 62 W( is very variable between systems, and values should be)61 W
1185 (determined on a trial and error basis.)SH
1190 64 W( the console and printer. Output to the printer is buffered by the Kermit-maintained printer)65 W
1193 338 W( routine is identical)
1194 44 W( to TYPE but characters are echoed to the printer as well as to the screen.)43 W
1196 (Suspending and canceling output is as described in TYPE.)SH
1200 (Synonym for EXIT.)SH
1208 (Receive file\050s\051 from the remote)
1209 185 W( Kermit, and save them under the names provided in the file headers)184 W
1212 37 W( the remote host. If a local filespec is given, the file is saved under the given filename. If the)38 W
1214 (names aren't legal, use)
1215 104 W( as many legal characters from the name as possible \050see the description of SET)103 W
1217 (FILE-WARNING below\051. If there's)
1218 128 W( a conflict, and FILE-WARNING is ON, warn the user and try to)129 W
1220 (build a unique name for the file by)
1225 (" characters to the name. RECEIVE can be abbreviated to)70 W
1227 (the single letter R.)SH
1235 (Send a command to a remote Kermit server.)
1237 381 W( results are sent back to your CP/M screen. When two)65 W
1239 (arguments are required and specify less than two in)
1240 73 W( the command, you will be prompted for the missing)74 W
1243 250 W( commands include:)SH
1245 (REMOTE CD [directory])SH
1252 (1.5. Kermit-80 Description)SH
1256 46800 50 8280 5709 UL
1259 (Ask the remote server to change its default directory. If no directory is)
1260 36 W( specified, the server changes)37 W
1262 (to its login directory.)SH
1264 (REMOTE COPY file1 file2)SH
1266 (Ask the remote server to copy file1 to file2.)SH
1268 (REMOTE RENAME file1 file2)SH
1270 (Ask the remote server to rename file1 to file2.)SH
1272 (REMOTE DELETE filespec)SH
1274 (Ask the remote server to delete the named file or files.)SH
1276 (REMOTE DIRECTORY [filespec])SH
1278 (Ask the remote server to display a directory listing of the given files or, if the filespec is)
1279 41 W( omitted, all)40 W
1281 (the files in the current device or directory.)SH
1283 (REMOTE DISK-USAGE)SH
1285 (Ask the remote server to display information about its disk usage \050such as free or used space\051.)SH
1287 (REMOTE ERASE filespec)SH
1289 (Same as REMOTE DELETE.)SH
1297 (Ask the remote server to display a list of the commands it can respond to.)SH
1299 (REMOTE HOST command)SH
1301 (Ask the remote server to have its operating system execute the given command.)SH
1303 (REMOTE KERMIT command)SH
1305 (Ask the remote server to execute the given Kermit command, given)
1306 35 W( in the server Kermit's command)36 W
1310 (REMOTE LOGIN user password)SH
1312 (Log in to a remote Kermit server which has been set up to require a username and password.)SH
1314 (REMOTE MESSAGE text)SH
1316 (Send the text to the remote server for display on its screen \050useful with MS-DOS Kermit servers\051.)SH
1318 (REMOTE SET parameter value)SH
1321 145 W( remote server to set the given parameter to the given value, for example REMOTE SET)146 W
1323 (FILE TYPE BINARY. Type REMOTE SET ? to see a list of the REMOTE SET options.)SH
1327 (Same as REMOTE DISK-USAGE.)SH
1331 (Ask the remote server to provide a status report.)SH
1333 (REMOTE TYPE file)SH
1335 (Ask the remote server to display the named file on the micro's screen.)SH
1337 (REMOTE WHO [user])SH
1339 (Ask the remote server for a list)
1340 13 W( of users who are logged in, or if a user is specified, for a report on the)12 W
1344 (RENAME file1 file2)SH
1346 (Rename local CP/M file1 to file2.)SH
1354 (Send file\050s\051 specified by)13 W
1360 (to the remote Kermit. The)13 W
1366 (may contain CP/M wildcards.)
1369 (may be abbreviated to the single letter S.)SH
1383 (Set the specified parameter to the specified value. Possible parameter settings:)SH
1387 (ON \050or OFF\051.)
1389 563 W( several files to be received without having to type RECEIVE on the)156 W
1399 (Kermit User Guide: CP/M-80 KERMIT 1.5)SH
1400 46800 50 6120 5709 UL
1403 (receiving machine. The routine simply looks for activity on)
1404 91 W( the serial line, and if so fudges a)92 W
1406 (RECEIVE command. The packet sent by the sender will be lost.)SH
1408 (BLOCK-CHECK-TYPE)SH
1414 (The options are:)SH
1416 (1-CHARACTER-CHECKSUM)SH
1418 (Normal, default, standard 6-bit checksum.)SH
1420 (2-CHARACTER-CHECKSUM)SH
1422 (A 12-bit checksum encoded as two characters.)SH
1424 (3-CHARACTER-CRC-CCITT)SH
1426 (A 16-bit CCITT-format Cyclic Redundancy Check, encoded as 3 characters.)SH
1434 (This allows you to set a buffer size during transfer of data. On some systems)
1435 86 W( it takes so long)87 W
1437 (that the remote end times)
1438 9 W( out while the local system is reading or writing to disk. The size is the)8 W
1440 (number of 128 disk sectors \050nominal\051 and can be from 1 \050128 bytes\051 to 64 \0508 kbytes\051.)SH
1442 (CP/M-80 filenames will still be mapped to uppercase characters.)SH
1446 (What to do when a file arrives that has the same name as an existing file.)
1448 380 W( means to)65 W
1450 (rename the existing file. DISCARD means to discard)
1451 444 W( and reject the incoming file.)445 W
1453 (OVERWRITE means to overwrite the existing file. RENAME means to rename the existing)126 W
1459 (ON \050or OFF\051. Enables/disables displaying of packets on the screen during)
1460 122 W( file transfer. Not)123 W
1462 (performed if the QUIET option has been set for the terminal \050SET TERMINAL QUIET\051)SH
1470 (This allows you to set the)
1471 94 W( default disk as source and destination of file transfers. In addition,)95 W
1473 (issuing this command)
1474 134 W( causes you to switch to the specified disk and log it in, write-enabled.)133 W
1476 (The colon must be included in the disk name \050A:\051. The selected disk appears in)
1479 (KERMIT-80 prompt, for instance)SH
1485 (DIRECTORY-FILE-SIZE ON \050or OFF\051.)SH
1487 (By setting DIRECTORY-FILE-SIZE OFF you)
1488 71 W( can get an abreviated listing of your disk drive.)70 W
1490 (File sizes are not)
1491 2 W( calculated, and five files are shown on a line. Setting this option ON will show)3 W
1493 (file sizes of each file.)SH
1495 (Both options will list the free space remaining.)SH
1500 5 W( character for virtual terminal connections. Kermit-80 will prompt you for the)4 W
1502 (new escape character, which you enter literally.)SH
1510 (Tells KERMIT-80 what kind of file it is)
1511 69 W( sending, so that KERMIT can correctly determine the)68 W
1513 (end of the file. SET FILE BINARY means to send all the 128-byte blocks \050ie)
1514 119 W( logical CP/M)120 W
1516 (sectors\051 of the file, including the last block in its entirety; SET FILE ASCII)
1517 14 W( is used for text files,)13 W
1519 (and transmission stops when the first Control-Z is encountered anywhere in the)
1520 70 W( file \050this is the)71 W
1522 (CP/M convention for marking the end of a text file\051.)SH
1525 99 W( DEFAULT tells Kermit to attempt to determine the file type by examining)98 W
1528 50 W( being transmitted. If a Control-Z appears before the last block of the file, it is assumed)51 W
1530 (to be BINARY; if, when the first Control-Z is encountered, the remainder)
1531 104 W( of the file contains)103 W
1533 (only control-Z's, it is assumed to be a text file. Unfortunately,)
1534 253 W( not all programs fill the)254 W
1536 (remainder of the last record of a text file with Control-Z's, so this algorithm is not)
1541 (If binary transmission is used on a text)
1542 238 W( file, or a compressed file \050eg a .DQC file\051 some)239 W
1544 (extraneous characters \050up to 127 of them\051 may appear at the end of the file on the target system.)SH
1546 (If ASCII transmission is used on a binary file, any 8th)
1547 96 W( bits set will be stripped and a warning)95 W
1549 (sent to the console. When the first control-Z is encountered, the file is assumed to be at)
1557 (1.5. Kermit-80 Description)SH
1561 46800 50 8280 5709 UL
1564 (even if it is not.)SH
1566 (FLOW-CONTROL ON \050or OFF\051)SH
1568 (Sets XON/XOFF flow control on or off. If set ON the host is expected to respond)
1569 48 W( to an XOFF)49 W
1571 (or XON sent by Kermit-80. If set)
1572 177 W( off, no flow control is assumed and any XON/XOFF is)176 W
1576 (IBM ON \050or OFF\051)SH
1578 (Allow the transfer)
1579 125 W( of files to and from an IBM mainframe computer. This makes Kermit-80)124 W
1581 (wait for the IBM turnaround)
1582 61 W( character \050XON\051, ignore parity on input, add appropriate parity to)62 W
1584 (output, and use local echoing during)
1585 167 W( CONNECT. As distributed, KERMIT-80 uses MARK)166 W
1587 (parity for IBM communication. If you)
1588 4 W( don't give this command, IBM mode is OFF. Since IBM)5 W
1590 (VM/CMS KERMIT does not have timeout capability,)
1591 118 W( SET IBM ON also turns on the "fuzzy)117 W
1593 (timer" automatically.)SH
1595 (LOCAL-ECHO ON \050or OFF\051)SH
1597 (When you CONNECT to a)
1598 136 W( remote host, you must set LOCAL-ECHO ON if the host is half)135 W
1600 (duplex, OFF if full duplex. OFF by default.)SH
1602 (LOGGING ON \050or OFF\051)SH
1604 (Cease or resume logging whenever)
1605 25 W( connect mode is entered. This is really only applicable after)24 W
1607 (a LOG command is no longer required.)SH
1611 (This command is applicable only)
1612 145 W( for Kermit initiated with a command tail. For example, if)144 W
1614 (Kermit was initiated by:)SH
1616 (KERMIT ;SEND HELLO;NO-EXIT)SH
1618 (Kermit would first seek out and execute the KERMIT.INI file \050if present\051, then)
1619 248 W( send file)249 W
1621 (HELLO to a remote system.)
1623 265 W( Kermit would exit back to CP/M, but NO-EXIT over-rides)7 W
1626 250 W( is a synonym for NO-EXIT.)SH
1628 (Note the leading semicolon. This clears leading spaces from the first command.)SH
1636 (Send a line of text)
1637 121 W( to the remote computer \050or modem\051. This simply copies the string to the)120 W
1639 (correct line, and assumes all appropriate parameters have been set to be used, e.g. speed, parity)54 W
1642 250 W( is intended for use in TAKE command files.)SH
1650 (Sets parity for outgoing characters to one of)
1651 49 W( the following: NONE, SPACE, MARK, EVEN, or)50 W
1654 286 W( input, if parity is NONE, then the 8th bit is kept \050as data\051, otherwise it is stripped)
1658 558 W( parity setting applies to both terminal)
1659 154 W( connection and file transfer. If you set)155 W
1662 236 W( anything other than none, KERMIT-80 will attempt to use "8th bit prefixing" to)235 W
1664 (transfer binary files.)
1666 341 W( the other KERMIT is also capable of 8th bit prefixing, then binary files)46 W
1668 (can be transferred successfully; if not, the 8th bit of each data byte)
1669 75 W( will be lost \050you will see a)74 W
1671 (warning on your screen if this happens\051.)SH
1679 (Allows you to switch between different communication ports. This command is not available)96 W
1681 (on all systems. Type)56 W
1687 (for a list of valid options for your system. \050Note: If your)57 W
1689 (system does not support several)
1690 105 W( ports, this command will return a "Not implemented" error if)104 W
1692 (you try to set a port.\051)SH
1696 (ON \050or OFF\051)SH
1698 (Turns copying of CONNECT session)
1699 151 W( to printer on and off. It is also possible to toggle the)152 W
1701 (printer on/off from the connect state, by typing <escape character> followed by P.)SH
1715 (Set a RECEIVE parameter.)SH
1719 (Set the PAD character to use while receiving files. Currently a dummy, as for SET)100 W
1731 (Kermit User Guide: CP/M-80 KERMIT 1.5)SH
1732 46800 50 6120 5709 UL
1737 (Set the number of PAD characters to use while receiving files. Same as SET)
1742 (START-OF-PACKET [value])SH
1744 (Set the default start of Packet character for receiving files.)
1746 364 W( the same rules and)57 W
1748 (considerations as for SET SEND START-OF-PACKET.)SH
1750 (PACKET-LENGTH number)SH
1752 (Tell the other Kermit the longest packet length CP/M Kermit)
1753 171 W( is willing to receive)170 W
1755 (during file transfer. The maximum length is 94, which is also the default length.)SH
1769 (Set a SEND parameter.)SH
1774 98 W( Pad character to be used while sending files. It is currently a dummy entry,)99 W
1776 (and does not do anything.)SH
1780 (Set the number of PAD-CHARS)
1781 249 W( to be used while sending files. This too does)250 W
1787 (Set the default start of packet character to another character than control-A. This)
1791 439 W( systems \050including intervening networks\051 that trap control-A)438 W
1793 (characters. Choose)
1794 272 W( a control character not otherwise used, ie not carriage return)
1797 (ODH\051, line feed)
1798 108 W( \05010D, OAN\051, tabs \05009D, 09H\051, backspace \05008H\051, and bell \05007H\051 or)107 W
1800 (any other used between you and your remote system.)SH
1809 23 W( baud rate of the communications port. This command only works on some systems.)22 W
1815 (is the numeric baud rate \050300, 9600, etc.\051 desired. Type)
1816 182 W( SET SPEED followed by a)183 W
1818 (question mark for a list of supported baud rates. On systems that do)
1819 36 W( not support this command,)35 W
1821 (you must set the port baud rate from CP/M or other setup mechanism outside of KERMIT-80.)SH
1825 (Set the TAC intercept character. If you are attached to a TAC it will)
1826 149 W( swallow the intercept)148 W
1828 (character \050commercial AT sign by default\051 so Kermit sends)
1829 94 W( it twice. With this command you)95 W
1831 (can set the intercept character \050ie the one to send twice\051 to another character.)SH
1839 (Select one of the following terminal characteristics:)SH
1843 (sets emulation off, and its up to the)
1844 63 W( attached terminal to respond to escape sequences)64 W
1846 (sent from the remote host system.)SH
1850 (Like off, but carriage return)
1851 123 W( and line feed characters are the only control characters)122 W
1854 250 W( other control characters are simply ignored. \050Really a "Glass TTY"\051.)SH
1858 (Emulation is provided for by a)
1859 259 W( routine in the system dependent part of Kermit.)258 W
1862 236 W( this option without having and externally supplied routine will)237 W
1864 (returna "Not Implemented" error.)SH
1868 (All characters are passed directly to the terminal without any interpretation by Kermit.)SH
1873 101 W( as a terminal to a foreign host, the micro emulates a VT52. VT52)100 W
1875 (emulation is set by default, except on micros that already have terminal functionality)74 W
1878 35 W( as the DEC VT180 and DECmate \050these act as VT100-series terminals\051.)34 W
1880 (Some systems emulate other terminals, like the ADM3A; see table 1-5.)SH
1884 (Do not display any file transfer information onto the console. This mode is useful)
1888 58 W( a long time to update the display. Only the file name is displayed.)57 W
1890 (DEBUGging information is not displayed even if selected.)SH
1894 (Inverse of QUIET. All packets etc displayed, as ususal.)SH
1901 (1.5. Kermit-80 Description)SH
1905 46800 50 8280 5709 UL
1908 (TIMER ON \050or OFF\051)SH
1911 131 W( the "fuzzy timer". The timer is off by default, because in the normal case)132 W
1913 (KERMIT-80 is communicating with a mainframe KERMIT that has its own timer.)
1914 62 W( Mainframe)372 W
1916 (KERMIT timers tend to be more precise or adaptable to changing conditions.)
1918 343 W( should SET)47 W
1920 (TIMER ON if you are communicating with a KERMIT that does not have a)
1921 41 W( timer. You should)40 W
1923 (SET TIMER OFF if you are communicating over a network with long delays.)SH
1931 (Sets another user number to be active. Acceptable user numbers are)
1932 203 W( 0 to 31, though it is)202 W
1934 (recommended to use user numbers 0 to 15 only. This is really only useful for Winchester)184 W
1936 (Systems with high disk capacities.)SH
1938 (WARNING ON \050or OFF\051)SH
1940 (Warn user of filename)
1941 5 W( conflicts when receiving files from remote host, and attempt to generate a)6 W
1944 19 W( by adding ")18 W
1948 (" characters to the given name. ON by default, which is equivalent to)18 W
1950 (SET COLLISION RENAME.)SH
1954 (Display all settable parameters. You will get a page or so)
1955 83 W( of the status af all parameters that can be set)84 W
1957 (using the SET command.)SH
1961 (The same function as Show.)SH
1965 (Equivalent to SET NO-EXIT.)SH
1973 (Take characters and commands from the specified file as if they)
1974 40 W( were entered from the keyboard. This is)41 W
1976 (useful if you want to set up a batch job. A command file can send, get,)
1977 210 W( receive, set functions etc)209 W
1980 250 W( TAKE command can be interrupted with ^C.)SH
1983 67 W( "TAKE KERMIT.INI" is executed from the default drive when Kermit-80 is loaded. This)68 W
1985 (can be used to set defaults of band rate, parity, filetype, default drive etc.)SH
1987 (If KERMIT.INI does not exist, control is given directly to the user.)SH
1992 (filespec turnaround)SH
1995 (Send the specified file)
1996 70 W( to the system on the other end of the connection as though it were being typed at)71 W
1998 (the terminal, one line at a time. Each line sent is terminated with a carriage return, and any line)
1999 36 W( feeds are)35 W
2001 (stripped from the file sent.)
2003 311 W( each line has been sent Kermit waits for a character string from the host)31 W
2005 (\050eg a acrriage return\051. If not specified, a carriage return is assumed. No KERMIT protocol)
2006 76 W( is involved.)75 W
2008 (An asterisk \050star\051 is sent to the console for every line sent,)
2009 1 W( to indicate how the transfer is progressing. This)2 W
2011 (is useful for sending files to systems)
2012 43 W( that don't have a KERMIT program. During transmission, you may)42 W
2014 (type one of these single-character commands:)SH
2018 (Cease transmission, and drop into terminal emulation mode.)SH
2022 (\050carriage return\051 Re-transmit the previous line.)SH
2027 49 W( local CP/M file or files on the CP/M screen. A Control-C will cancel the command and return to)50 W
2029 (the Kermit prompt. A Ctrl-X will cancel the current file and go on to the next one, if)
2030 81 W( any. Typing any)80 W
2033 86 W( while the file is being displayed will suspend the output. Another character will resume)87 W
2039 (Show the name, edit number, and edit date of several of the modules that make up Kermit-80.)SH
2049 (Kermit User Guide: CP/M-80 KERMIT 1.6)SH
2050 46800 50 6120 5709 UL
2053 (1.6. Kermit-80 Flavors)SH
2057 152 W( systems supported use an external terminal, rather than a built-in console. Kermit may be further)153 W
2059 (customized for these systems by)
2060 98 W( defining \050at assembly time\051 the terminal type to be used. If the terminal type is)97 W
2063 29 W( does not match any of the existing terminal options, the generic "CRT" option may be selected. In this)30 W
2065 (case, Kermit cannot do fancy screen control during file transfer; it simply types the file names, packet)
2066 25 W( numbers, and)24 W
2068 (messages in sequence across and down the screen. This works best)
2069 183 W( if you can put your micro or terminal in)184 W
2071 ("autowrap" mode; otherwise the packet numbers will pile up in the rightmost column;)
2072 69 W( the filenames and messages)68 W
2074 (will always appear on)
2075 150 W( a new line, however. If no specific terminal has been selected, Kermit cannot do VT52)151 W
2077 (emulation; it can act as a "dumb terminal" \050sometimes called a "glass TTY"\051, or else its own built in)
2078 167 W( terminal)166 W
2080 (firmware provides cursor control functions independent of the Kermit program.)SH
2083 (1.6.1. Generic Kermit-80)SH
2086 ("Generic Kermit-80" is an implementation of Kermit that should run on any)
2087 11 W( 8080-compatible CP/M 2.2 system with)12 W
2090 7 W( at all, or perhaps only a minor one. Unlike other Kermit-80 implementations, it contains no system-)6 W
2092 (dependent manipulation of the serial port. All)
2093 87 W( I/O is done with standard CP/M BIOS calls, and I/O redirection is)88 W
2095 (done using the CP/M IOBYTE function, which, according to the Digital Research)24 W
2098 (CP/M Operating System Manual)24 W
2102 (is an optional feature of any particular CP/M implementation.)
2104 665 W( your system does not provide the IOBYTE)208 W
2106 (function, Generic Kermit-80 will not work; furthermore, not all systems that implement IOBYTE do so in)
2110 360 W( SET PORT command may be used to select the)
2111 55 W( devices to be used for input and output. Table 1-1 lists)56 W
2113 (the options to the SET PORT command and their effects.)SH
2114 46800 50 6120 35171 UL
2126 7200 50 17220 37452 UL
2127 6000 50 26820 37452 UL
2128 5400 50 36420 37452 UL
2130 (CRT CRT: CRT:)6600 W
2132 (PTR PTR: PTP:)6600 W
2134 (TTY TTY: TTY:)6600 W
2136 (UC1 UC1: UC1:)6600 W
2138 (UR1 UR1: UP1:)6600 W
2140 (UR2 UR2: UP2:)6600 W
2146 (Kermit-80 SET PORT Options)SH
2147 46800 50 6120 46858 UL
2149 (The default is SET PORT)
2150 105 W( PTR. In all cases, the console \050CON:\051 and list \050LST:\051 devices used are those selected)104 W
2152 (when Kermit is started.)SH
2154 (The reason all Kermit-80 implementations aren't generic is that a good deal of speed is)
2155 128 W( sacrificed by getting all)129 W
2157 (services from the operating system. While a specific implementation of Kermit-80 may be able to operate)
2160 (9600, or even 56 Kilo baud, generic Kermit will fail to work on some systems at speeds in excess)
2161 30 W( of 1200 baud. In)31 W
2163 (addition, many features of Kermit require more specific knowledge of the hardware)
2164 171 W( involved. Generic Kermit)170 W
2166 (cannot send a BREAK signal, or change the baud rate, for example.)SH
2169 (1.6.2. CP/M 3 Kermit)SH
2172 (CP/M-3 Kermit \050also known as CP/M-Plus Kermit\051 is)
2173 161 W( a version of generic Kermit-80, and should run on most)162 W
2175 (CP/M-3 \050CP/M-Plus\051 systems. It uses the auxilliary port \050AUX:\051 to communicate to the remote Kermit. The SET)60 W
2177 (BAUD and SET PORT commands are not supported; nor can a BREAK be sent. Like generic Kermit-80, a terminal)3 W
2179 (may be selected at assembly time.)SH
2186 (1.6.3. System-Specific Versions)SH
2190 46800 50 8280 5709 UL
2193 (1.6.3. System-Specific Versions)SH
2196 (There are also many versions of Kermit-80 tailored to specific systems. Most)
2197 39 W( of these operate uniformly, but some)38 W
2199 (of them take advantage \050or suffer limitations\051 of the specific system. Here are some of the special features)
2202 (particular systems:)SH
2204 (Amstrad: -- Two versions:)SH
2205 3444 50 8280 14329 UL
2209 (The PCW 8256/8512 with the serial inerafce attached.)SH
2213 (The 664 with add on memory and 6128 are both)
2214 10 W( supported. Both systems must run CP/M Plus, so the 664)9 W
2216 (will need an add on RAM pack and CP/M upgrade. A high speed transfer rate of)
2217 70 W( 38k baud can be used)71 W
2219 (between Amstrad computers.)SH
2222 3779 50 8280 23908 UL
2224 (Access Matrix computer using port J5. Supports SET BAUD-RATE for rates of 300-9600 baud.)SH
2226 (Apple II -- four variations:)SH
2227 3360 50 8280 26590 UL
2231 (Apple with Z80 Softcard and Micromodem II in slot 2 Dialout capability provided in)
2232 63 W( connect command;)62 W
2234 (user is prompted for phone number)
2235 124 W( if carrier is not present. During connect mode,)125 W
2241 (drops carrier.)125 W
2243 (BYE command also causes carrier to be dropped.)SH
2247 (Apple with Z80 Softcard, and one of several 6551-based communication cards; the slot)
2248 198 W( number is a)199 W
2250 (compile-time parameter \050default is slot 2\051. SET BAUD-RATE supported; speeds are 110-19200 baud.)SH
2254 (Apple with Z80 Softcard and CP Multi-Function Card. The)
2255 279 W( slot number is again a compile-time)280 W
2258 250 W( BAUD-RATE is supported for baud rates from 50 baud to 19200 baud.)SH
2263 72 W( with Z80 Softcard and a 6850-based USART in slot 2-the slot being a compile-time parameter.)73 W
2265 (SET BAUD-RATE is not supported.)SH
2268 2001 50 8280 44848 UL
2270 (Acorn Computers BBC Computer with Acorn Z80 second processor running CP/M-80.)
2274 (BAUD-RATE and can send breaks.)SH
2277 4805 50 8280 48635 UL
2280 47 W( port A. To use port B, change mnport, mnprts, and baudrt and reassemble. Can generate BREAK.)48 W
2282 (SET SPEED supported; speeds are 300-38400 baud.)SH
2285 2055 50 8280 52422 UL
2287 (Originally coded for Cifer 1886)
2288 81 W( using the VL: port set as TTYI: and TTYO: but works successfully on 18xx)82 W
2290 (and 28xx series machines.)SH
2292 (There are now two versions, each with two variations: Either running)
2293 2 W( CP/M Version 2.2 or 3.0, and either using)1 W
2296 61 W( AUX: ports. The VL: port version can only use seven bits of data, so parity prefixing is required)62 W
2298 (for binary file transfers. This restriction is removed by using the AUX: port. For those interested, the)
2301 (is due to the interprocessor link between the video and CPU \050!\051 boards. The VL:)
2302 1 W( port is on the video board, and)2 W
2304 (the AUX: port on the CPU board, and the inter processor link can only transfer seven bits of data.)SH
2306 (Supports SET SPEED, and can generate breaks on some models with a BREAK key.)SH
2309 3000 50 8280 63783 UL
2311 (Comart Communicator-Similar to Northstar equipment. Can generate BREAK.)SH
2314 4278 50 8280 66465 UL
2316 (Based on Kermit 3.x, and has been merged into V4.09)SH
2318 (CPT-85xx word processors:)SH
2319 10943 50 8280 69147 UL
2321 (Can generate BREAK. SET SPEED supported; speeds are 50-9600 baud.)SH
2324 4444 50 8280 71829 UL
2334 (Kermit User Guide: CP/M-80 KERMIT 1.6.3)SH
2335 46800 50 6120 5709 UL
2338 (Cromemco computers with TU-ART card. Supports SET BAUD-RATE \050110-9600 baud\051.)SH
2340 (DEC DECmate II word processor \050with Z80 card\051:)SH
2341 20023 50 6120 9663 UL
2343 (Can generate BREAK.)SH
2345 (DEC VT180 \050Robin\051:)SH
2346 8444 50 6120 12345 UL
2348 (Three output ports, referred to as COMMUNICATIONS, GENERAL, and PRINTER. Can generate BREAK.)SH
2350 (Digicomp Delphi 100:)SH
2351 8722 50 6120 15027 UL
2353 (SET SPEED supported; speeds are 50-19200 baud.)SH
2356 4110 50 6120 17709 UL
2358 (Action Computer Enterprises "Discovery" Multi-user Computer. Uses Port)
2359 31 W( B on an 83U user board. Supports)30 W
2361 (SET SPEED for 50-19200 baud. Can generate BREAK.)SH
2364 2500 50 6120 21496 UL
2366 (Epson PX-8 with LCD display. Although it is quite different in displaying of Packet Information, it)
2369 (any other CP/M-80 Kermit. Supports SET SPEED and can generate BREAK.)SH
2372 6248 50 6120 25283 UL
2374 (Two versions, one for CP/M version 2)46 W
2378 (2 and version 3. These systems use IOBYTE flipping \050V2)46 W
2386 306 W( to communicate to the serial line. You may have to SET PORT)
2387 28 W( xxx before the version 2)29 W
2393 (work, as Kermit needs to know what device is the serial line.)SH
2396 2388 50 6120 30175 UL
2398 (Eaca Video Genie.)SH
2400 (Heath: Three Versions:)SH
2401 2388 50 6120 32857 UL
2405 (for Heath-8 systems with the quad io board. This system has been derived from V3.x code. Note)
2406 14 W( that this)13 W
2408 (version will not run "as is" on H89 systems.)SH
2412 (For Heath-89 machines suports baud rates from 50 to 56,000 baud.)SH
2416 (For Z-100 running CP/M-85. This version does not support setting of baud rates.)SH
2418 (Intertec Superbrain: Two Versions:)SH
2419 7692 50 6120 42908 UL
2423 (For superbrain using AUX port. Breaks and SET BAUD both supported)SH
2427 (As above, but using the MAIN port.)SH
2430 2443 50 6120 50277 UL
2432 (Ithaca Intersystems based computer using the VIO card for all IO to the outside world. The system is strictly)60 W
2434 (speaking a home-brew variant of the Ithaca machine, using an S100 cardcage without)
2435 24 W( a front panel. It uses the)23 W
2437 (Extended BIOS by EuroMicro of London. However, I see no reason for this version not running on)
2438 38 W( a genuine)39 W
2440 (Ithaca Intersystems machine. There are patches needed to the EuroMicro BIOS to make this version work.)SH
2443 3277 50 6120 56274 UL
2445 (Should work on most Kaypro models, as well)
2446 24 W( as some related systems \050Ferguson BigBoard I, Xerox 820\051. For)25 W
2448 (the newer Kaypros with multiple ports, Kermit uses)
2449 14 W( the one labeled "serial data"; it cannot use the serial printer)13 W
2451 (or internal modem ports \050but it should)
2452 81 W( be possible to modify the values for mnport, mnprts, and baudrt to do)82 W
2455 250 W( generate BREAK. SET SPEED supported; speeds are 50-19200 baud.)SH
2458 2111 50 6120 62271 UL
2460 (Lobo MAX-80. Supports SET SPEED and can generate BREAKS.)SH
2463 2722 50 6120 64953 UL
2465 (British Telecom Merlin M2215 \050also Rair Black Box, possibly also the ICL PC?\051. Requires a terminal.)SH
2468 3832 50 6120 67635 UL
2470 (Microbee Systems computer made in Australia. Works on Microbee 56K \050Series 2 APC\051, 64K)
2471 26 W( \050Computer in a)27 W
2473 (Book\051, 128K \050Dynamic\051, and 256K)
2474 94 W( \050256TC\051. Can generate BREAK. SET BAUD-RATE supported; speeds)93 W
2476 (are 75-9600. All serial I/O is via software, not)
2477 86 W( hardware. Simultaneous transmit and receive possible on all)87 W
2479 (speeds except 75/1200, 1200/75, 4800, and 9600.)SH
2486 (1.6.3. System-Specific Versions)SH
2490 46800 50 8280 5709 UL
2494 4388 50 8280 8086 UL
2496 (PMC 101 Micromate. Supports SET SPEED and can generate BREAK.)SH
2498 (Micromint: Two versions)SH
2499 4278 50 8280 10768 UL
2503 (The Ciarcia/Micromint sb-180 board with a 6Mhz procoessor. System requires a terminal.)SH
2507 (As above, but with a 9Mhz processor.)SH
2510 2056 50 8280 15927 UL
2512 (Decisionmate 5. Uses the 2651 and is largely the same as the Ithaca Intersystems machine implementation.)SH
2514 (Northstar: -- There are four versions available:)SH
2515 3777 50 8280 18609 UL
2519 (Northstar Horizon with HS10-4 board. Supports SET SPEED and SET PORT.)SH
2523 (Northstar Horizon using the serial ports on the Mother board. Can generate BREAK.)SH
2527 (Basic Northstar Horizon using the printer port. Can generate BREAK.)SH
2531 (Northstar Advantage. Supports SET SPEED and can generate BREAK. Traps Control-0 in the)
2536 (Morrow Decision I:)SH
2537 7665 50 8280 32447 UL
2539 (Uses the Multi-I/O board. Port 1 is the console, port 3 is the communications line. SET SPEED)
2540 89 W( supported;)88 W
2542 (speeds are 75-56000 baud.)SH
2544 (Morrow Micro Decision I:)SH
2545 10359 50 8280 36234 UL
2547 (Nokia MicroMikko:)SH
2548 7805 50 8280 37811 UL
2550 (Will not echo control-O \050which locks keyboard\051. SET SPEED supported; speeds are 75-9600 baud.)SH
2552 (Ohio Scientific:)SH
2553 6083 50 8280 40493 UL
2555 (Doesn't have screen control.)SH
2558 4138 50 8280 43175 UL
2560 (Uses serial line, not internal modem. Left-arrow key generates)
2561 39 W( <DEL> \050"delete" or "rubout" character\051 during)38 W
2563 (connect mode. SET SPEED supported; speeds are 300 and 1200 baud. Now supports multi-sector buffering.)SH
2565 (Research Machines: Two Versions:)SH
2566 7803 50 8280 46962 UL
2570 (380Z and 5.25" disks supports SET BAUD.RATE)SH
2574 (380Z and 8" disks, otherwise as above.)SH
2577 2500 50 8280 54331 UL
2579 (Sanyo MBC-1100. This version derived from Kermit V3.x)SH
2582 5109 50 8280 57013 UL
2586 (TRS-80: Three versions:)SH
2587 3167 50 8280 59695 UL
2591 (TRS-80 with Lifeboat CP/M)SH
2595 (TRS-80 with Pickles and Trout CP/M)SH
2599 (TRS-80 Model 4 with Montezuma CP/M)SH
2602 2999 50 8280 69746 UL
2604 (Teletek Systemaster. Supports SET BAUD.)SH
2614 (Kermit User Guide: CP/M-80 KERMIT 1.6.3)SH
2615 46800 50 6120 5709 UL
2619 2777 50 6120 8086 UL
2621 (TELCON ZOBRA portable computer.)SH
2624 2388 50 6120 10768 UL
2626 (Torch Unicorn 5 initially, but the code runs on other Z80 based CP/N \050as in Nut!\051 systems.)
2628 410 W( uses the BBC)80 W
2630 (Computer as a "Base processor", and is similar to the BBC version. The base processors RS423)
2631 77 W( port is used)76 W
2633 (rather than any built in Modem. \050UK telecoms legislation effectively)
2634 109 W( makes modem control software tricky)110 W
2636 (business...\051. Two)
2637 591 W( potential versions exist-one using cursor positioning codes for a MCP and CCCP ROM)170 W
2639 (combination of revision less than 1.00, the other version uses the additional facility MCP/CCCP)
2640 196 W( versions)197 W
2642 (greater than 1. Supports SET SPEED and can generate BREAKs.)SH
2644 (Note that binary files must be transferred using SET PARITY to anything other than)
2645 45 W( NONE! Parity is neither)44 W
2647 (generated nor checked.)SH
2650 6333 50 6120 21657 UL
2652 (S-100-8 based computer.)SH
2654 (Vector Graphics:)SH
2655 6581 50 6120 24339 UL
2660 2499 50 6120 27021 UL
2665 3222 50 6120 29703 UL
2667 (Development Kermit on a PC running the)
2668 298 W( Z80MU Z80 and CP/M 2)299 W
2672 (2 development system. Allows)299 W
2674 (development of the system independent modules to be done on an IBM)
2675 241 W( PC or clone. Also allows the)240 W
2677 (generation of new .HEX files, that may then be KERMITed to the target system. Note:)
2679 359 W( all the BDOS or)55 W
2681 (BIOS routines are supported, so avoid "unusual" BIOS/BDOS calls. \050For example,)
2682 92 W( DIR from within Kermit)91 W
2684 (will fail as one of the BIOS routines returning disk parameters is not supported.\051)SH
2687 (1.7. Installation of Kermit-80)SH
2690 (Kermit-80 was written originally for the Intertec SuperBrain in lowest-common-denominator)
2692 445 W( code with the)98 W
2694 (standard assembler, ASM \050single source module, no macros, no advanced)
2695 293 W( instructions\051, so that it could be)292 W
2697 (assembled on any CP/M-80 system \050the 8080 assembler is distributed as a standard)
2698 83 W( part of CP/M-80, whereas the)84 W
2700 (fancier Z80 or macro assemblers are normally commercial products\051. It has since been modified to run on many)99 W
2702 (other systems as well. Kermit-80 should be able)
2703 106 W( to run on any 8080-, 8085- or Z80-based microcomputer under)107 W
2705 (CP/M with appropriate minor changes to reflect the port I/O and screen control for the system \050see below\051.)SH
2707 (The proliferation of new systems supported by Kermit-80 made)
2708 66 W( the program grow so large and complicated that it)65 W
2711 138 W( broken up into system-independent and system-dependent modules, as of version 4 \050this was done by)139 W
2713 (Charles Carvalho of ACC\051. Each module is composed of multiple files. This has reduced the time and disk)
2716 (necessary for assembly; Kermit-80 may)
2717 126 W( once again be assembled on a CP/M system with roughly 250Kbytes of)127 W
2720 302 W( majority of the code does not)
2721 26 W( need to be reassembled to support a new system. Unfortunately, it can no)25 W
2723 (longer be assembled with ASM, since ASM does not support multiple input files.)
2725 398 W( allow it to be assembled on)74 W
2728 103 W( the public-domain assembler LASM is included in the distribution kit. Kermit-80 may also be)102 W
2730 (assembled with Microsoft's M80 \050not supplied\051. In theory, any 8080)
2731 33 W( assembler supporting the INCLUDE directive)34 W
2733 (ought to work, as well.)SH
2735 (All versions of Kermit-80 are)
2736 72 W( assembled from the same set of sources, with system dependencies taken care of by)71 W
2738 (assembly-time conditionals within the system-dependent module \050eventually, the system-dependent module)
2741 (itself be broken up into multiple files, one for each system\051. The most important)
2742 45 W( system dependencies are terminal)44 W
2744 (emulation \050when CONNECTed to)
2745 153 W( the remote host\051 and screen handling, which are dependent on the individual)154 W
2747 (micro's escape codes \050these features are table driven and easily modified for other CP/M)
2748 74 W( systems\051, and the lowest)73 W
2750 (level I/O routines for the serial communications port. The)
2751 93 W( port routines are best done only with BDOS calls, but)94 W
2753 (some systems do not allow this, primarily because the BDOS)
2754 91 W( routines strip the parity bit during port I/O, and the)90 W
2756 (parity bit is used for data when transmitting binary files.)SH
2758 (Kermit-80's I/O routines must check the port status and go elsewhere if no input is available; this allows for virtual)38 W
2765 (1.7. Installation of Kermit-80)SH
2769 46800 50 8280 5709 UL
2772 (terminal connection, keyboard interruption of stuck transmissions, etc. On systems that fully)
2773 246 W( implement I/O)245 W
2775 (redirection via the optional CP/M IOBYTE facility, this may be done by switching)
2776 127 W( the IOBYTE definition. On)128 W
2778 (others, however, IN/OUT instructions explicitly referencing the port device registers must be used.)SH
2781 110 W( versions 3.8 and later include a "fuzzy timer" that allows a timeout to occur after an interval)109 W
2783 (ranging from 5 to 20 seconds \050depending upon the speed)
2784 32 W( of the processor and the operating system routines\051 during)33 W
2786 (which expected input does not appear at the port. In this)
2787 2 W( case, retransmission occurs automatically. In any case, you)1 W
2789 (may type a carriage return during transmission to simulate a timeout when the transfer appears to be stuck.)SH
2792 (1.7.1. Organization of Kermit-80)SH
2795 (Kermit-80 consists of two modules, each of which is generated from multiple source files.)
2797 669 W( first module)210 W
2799 (contains the system-independent code;)
2800 27 W( the second module is configured for a particular system and merged with the)26 W
2802 (system-independent module to produce a customized Kermit-80.)SH
2804 (The distribution kit contains:)SH
2810 (the system-independent module,)SH
2821 (the system-dependent modules,)SH
2827 (\050see table 1-2 and 1-3\051;)SH
2833 (the source files,)SH
2850 (the public-domain CP/M assembler,)SH
2861 (the public-domain CP/M load/patch utility,)SH
2874 (Kermit User Guide: CP/M-80 KERMIT 1.7.1)SH
2875 46800 50 6120 5709 UL
2876 46800 50 6120 8086 UL
2881 3600 50 6120 10367 UL
2882 4800 50 10920 10367 UL
2883 3600 50 16320 10367 UL
2885 (ACCESS CPVACC)600 W
2891 (ADVANT CPVADV)600 W
2894 (Northstar Advantage)SH
2897 (AP6551 CPVAPL)600 W
2900 (Apple II, Z80 Softcard, 6551 ACIA in serial interface)SH
2903 (AP6850 CPVA65)600 W
2906 (Apple II, Z80 Softcard, 6850 ACIA in Serial Iiterface)SH
2909 (APMMDM CPVAPM)600 W
2912 (Apple II, Z80 Softcard, Micromodem II in slot 2)SH
2915 (APCPS CPVCPS)1200 W
2918 (Apple II, Z80 Softcard, with CPS multifunction card)SH
2924 (Northstar Horizon \050terminal required\051)SH
2930 (Acorn "BBC" computer with Acorn Z80 second processor)SH
2936 (BigBoard II \050terminal required\051)SH
2939 (BRAINM CPVBRM)600 W
2942 (Intertec Superbrain using the main port)SH
2945 (BRAINA CPVBRA)600 W
2948 (Intertec Superbrain using the Aux port)SH
2951 (CIFER2 CPVCIF)600 W
2954 (Cifer 1886 using the VL: Serial port and CP/M V2.2)SH
2957 (CIFER3 CPVCI3)600 W
2960 (Cifer 1886 using the VL: Serial port and CP/M V3.0)SH
2963 (CIFER2 CPVCA2)600 W
2966 (Cifer 1886 using the AUX: Serial port and CP/M V2.2)SH
2969 (CIFER3 CPVCA3)600 W
2972 (Cifer 1886 using the AUX: Serial port and CP/M V3.0)SH
2975 (CMEMCO CPVCRO)600 W
2978 (Cromemco with TU-ART card. Terminal required\051)SH
2981 (COMART CPVCOM)600 W
2984 (Comart Communicator \050terminal required\051)SH
2987 (COMPRO CPVPRO)600 W
2990 (Compupro with Interfacer 4 \050or 3\051. Terminal required.)SH
2996 (Amstrad CPC 664 and 6128 and CP/M 3)SH
3002 ("Generic": CP/M 3.0 \050CP/M Plus\051 systems \050terminal req'd\051)SH
3008 (CPT-85xx wordprocessor with CP/M)SH
3011 (DELPHI CPVDEL)600 W
3014 (Digicomp Delphi 100 \050terminal required\051)SH
3020 (Action Computer Enterprises "Discovery" \050terminal req'd\051)SH
3026 (DECmate II with CP/M option)SH
3029 (GENER CPVGEN)1200 W
3032 ("Generic": CPM 2.2 systems with IOBYTE \050terminal req'd\051)SH
3035 (GENIE CPVGNI)1200 W
3041 (H8QUAD CPVH8Q)600 W
3044 (Heath-8 with Quad 8 i/o board)SH
3047 (HEATH CPVH89)1200 W
3050 (Heath/Zenith H89)SH
3056 (Northstar Horizon \050terminal required\051)SH
3062 (Kaypro-II \050and 4; probably supports all Kaypro systems\051)SH
3070 ("symbol" is the symbol used to select the target system, in)SH
3077 ("filename" is the name under which the module is supplied in the distribution.)SH
3083 (Systems supported by Kermit-80 \050Part 1\051)SH
3084 46800 50 6120 50222 UL
3091 (1.7.1. Organization of Kermit-80)SH
3095 46800 50 8280 5709 UL
3096 46800 50 8280 8086 UL
3101 3600 50 8280 10367 UL
3102 4800 50 13080 10367 UL
3103 3600 50 18480 10367 UL
3105 (M2215 CPVMRL)1200 W
3108 (British Telecom Merlin/Rair Black Box \050terminal required\051)SH
3120 (Morrow Decision I \050terminal required\051)SH
3123 (MIKKO CPVMIK)1200 W
3132 (PMC 101 Micromate \050terminal required\051)SH
3138 (Morrow Micro Decision I \050terminal required\051)SH
3141 (NCRDMV CPVDMV)600 W
3144 (NCR Decision Mate V. \050Terminal required?\051)SH
3150 (Northstar Horizon with HSIO-4 card \050terminal req'd\051)SH
3153 (OSBRN1 CPVOSB)600 W
3168 (Ithaca Intersystems with VI0 card \050terminal required\051)SH
3174 (Amstrad PCW 8256/8512 with serial interface)SH
3186 (Research Machines 380Z with MDS \0505.25" discs\051)SH
3192 (Research Machines 380Z with FDS \0508" discs\051)SH
3195 (ROBIN CPVROB)1200 W
3201 (S1008 CPVUSM)1200 W
3204 (US Microsales S-100-8 \050terminal required\051)SH
3207 (SANYO CPVSAN)1200 W
3216 (Micromint SB-180 with 6Mhz CPU \050terminal required\051)SH
3222 (Micromint SB-180 with 9Mhz CPU \050terminal required\051)SH
3225 (SCNTPR CPVSCN)600 W
3231 (TELCON CPVTEL)600 W
3234 (TELCON Zobra portable)SH
3240 (Teletek Systemaster)SH
3243 (TORCH CPVTRC)1200 W
3246 (Torch computers BBC-B with Z80 second processors)SH
3252 (TRS-80 model II with Lifeboat 2.25C CP/M Display)SH
3258 (TRS-80 model II with Pickles + Trout CP/M Display)SH
3261 (TRSM4 CPVTM4)1200 W
3267 (VECTOR CPVVEC)600 W
3273 (XER820 CPVXER)600 W
3282 (Z-100 under CP/M-85)SH
3285 (Z80MU CPVZ80)1200 W
3288 (Z80MU development system on a PC)SH
3290 ("symbol" is the symbol used to select the target system, in)SH
3297 ("filename" is the name under which the module is supplied in the distribution.)SH
3303 (Systems supported by Kermit-80 \050Part 2\051)SH
3304 46800 50 8280 50222 UL
3314 (Kermit User Guide: CP/M-80 KERMIT 1.7.1)SH
3315 46800 50 6120 5709 UL
3316 46800 50 6120 8086 UL
3321 3600 50 6120 10367 UL
3322 4800 50 10920 10367 UL
3323 2400 50 16320 10367 UL
3328 (Dumb terminal type. Does not do cursor addressing)SH
3334 (Lear Seigler ADM 3A)SH
3340 (Lear Seigler ADM 22)SH
3358 (Netronics Smartvid)SH
3376 (Televideo 925 or Freedom 100)SH
3382 (Dec VT52 or equivalent \050H19\051)SH
3388 (Dec VT100 or equivalent)SH
3396 ("symbol" is the symbol used to select the target system, in)SH
3403 ("Terminal type" is the type of terminal "symbol" selects.)SH
3409 (Terminals supported by Kermit-80)SH
3410 46800 50 6120 30633 UL
3413 (1.7.2. Downloading Kermit-80)SH
3416 (You'll need either a pre-configured)4 W
3422 (file or the system-independent module,)5 W
3427 (, in binary \050)5 W
3437 (\051 format and the system-dependent overlay for your system \050from Tables 1-2 and 1-3\051. If your system is)
3440 (listed in the table, get the generic CP/M 2)12 W
3445 12 W( or the generic CP/M 3 Kermit. If you already have a version of)13 W
3448 75 W( your micro and you want to install a new version, simply use your present version to get the new files.)74 W
3450 (Transfer the files to your system and skip ahead to "merging the modules".)SH
3453 27 W( not have a copy of Kermit on your micro, and you cannot borrow a Kermit floppy but you do have access)28 W
3455 (to a mainframe computer with a copy of the Kermit-80 distribution, you should read this section.)SH
3457 (There are several ways to get CP/M Kermit)
3458 106 W( from a host system to your micro. The easiest is to "download" the)105 W
3460 (necessary "hex" files into your micro's memory and then save them on the disk.)
3462 419 W( you have a terminal emulator)85 W
3464 (program on your micro which can save a copy of the session to disk, connect to your host, and type)
3465 69 W( the necessary)68 W
3468 316 W( from the emulator, saving)
3469 33 W( the session log, and edit the session log to extract the hex files. Skip ahead to)34 W
3471 ("merging the files".)SH
3473 (The following is a procedure which, though far from foolproof, should allow you to get a version of Kermit to your)32 W
3475 (CP/M based micro. It depends upon the host prompt, or at least the first character of the host)
3476 62 W( prompt, being some)63 W
3478 (character that cannot appear in a hex)
3479 58 W( file \050the valid characters for hex files are the digits 0-9, the upper case letters)57 W
3481 (A-F, the colon ``)55 W
3485 ('', carriage return, and line feed\051. As soon the prompt character is encountered, the transfer)
3490 19 W( does not issue a prompt that will accommodate this scheme, you can achieve the same effect)18 W
3492 (by adding an atsign ``@'' to the very end of the hex file before sending it from the host. The)
3493 36 W( program below looks)37 W
3495 (for an atsign \050the normal DEC-20 prompt, hex 40\051. DECSYSTEM-10 users would)
3496 241 W( look for a dot, hex 2E;)240 W
3498 (VAX/VMS or UNIX users would look for a dollar sign, hex 24; UNIX C-Shell users would look)
3499 29 W( for a percent sign,)30 W
3509 (2 systems, connect to a floppy disk with plenty)
3510 44 W( of free space. Run DDT and type in the)43 W
3512 (following \050the comments should not be typed in; they are there just to tell you what's happening\051:)137 W
3514 (\050Note that this wont work for CP/M Plus or 3)SH
3525 (1.7.2. Downloading Kermit-80)SH
3529 46800 50 8280 5709 UL
3530 46800 50 8280 8086 UL
3534 10800 W( assembling code at 100)SH
3539 3600 W( to store in memory)SH
3544 4200 W( pointer there)SH
3554 4800 W( to PUNCH \050send to HOST\051)SH
3562 4800 W( from READER \050read from HOST\051)SH
3570 5400 W( parity bit)SH
3575 4200 W( a and flags)SH
3580 4800 W( char to E for echo)SH
3585 4800 W( to screen)SH
3593 4800 W( A and flags)SH
3598 5400 W( 4E,24,26,etc\051 System prompt?)SH
3603 5400 W( have whole file in memory)SH
3608 4200 W( store another byte)SH
3613 4800 W( another byte)SH
3618 4200 W( a Control-Z \050CP/M EOF mark\051)SH
3623 4200 W( it in memory)SH
3628 3600 W( memory pointer)SH
3633 4200 W( as DMA pointer)SH
3638 4800 W( 'HI' byte of memory pointer)SH
3643 4800 W( store it as 'LO' one)SH
3651 4800 W( 'HI' byte \050slow *256\051)SH
3669 4200 W( 128 bytes \050sector\051)SH
3674 4200 W( another sector)SH
3679 3000 W( a 16-bit Minus One)SH
3688 4200 W( 256-byte counter)SH
3692 SH( ;Decrement)6000 W
3697 4200 W( store back)SH
3707 6000 W( 256-byte counter down to offset)SH
3712 5400 W( we're done)SH
3717 4800 W( writing..)SH
3722 4200 W( file-pointer)SH
3731 4200 W( DMA-address)SH
3739 4200 W( sector \050128 bytes\051)SH
3752 4200 W( file-pointer)SH
3756 SH( ;128-bytes)4200 W
3761 6000 W( to file-pointer)SH
3775 4200 W( Memory-pointer)SH
3780 4800 W( character)SH
3812 6000 W( WARM BOOT)SH
3822 (Kermit User Guide: CP/M-80 KERMIT 1.7.2)SH
3823 46800 50 6120 5709 UL
3829 12000 W( Control-C\051 Return to CP/M)SH
3831 (A>SAVE 1 FETCH.COM)
3833 3000 W( program, we need to run it twice.)SH
3839 (Bootstrap program for Kermit-80 and CP/M Version 2.2)SH
3840 46800 50 6120 13306 UL
3842 (Alternatively, an assembler source file for this program is distributed with)
3843 374 W( CP/M Kermit as)373 W
3849 478 W( might prefer to type the assembler)
3850 114 W( version in and assemble and load it \050ASM)115 W
3852 (CPKFET, LOAD CPKFET, or MASM CPKFET,)
3853 43 W( MLOAD CPKFET\051, to let the assembler and loader)42 W
3855 (catch any typing errors.)SH
3859 (Connect to your host using a terminal or a terminal emulation program. Ensure that your host does)
3862 (have your terminal in "page mode" \050does not pause at the end of each screenful\051.)SH
3866 (Tell the host to display the first hex file \050the)
3867 38 W( system-independent module\051 at your terminal, e.g. give a)37 W
3877 (without a terminating carriage return)SH
3880 3001 50 24564 24968 UL
3884 (Return to your micro by switching the cable from the terminal to the micro, or by terminating)
3887 (micro's terminal program.)SH
3891 (Make sure your IOBYTE is set so that)17 W
3903 (correspond to the I/O port that is connected to)16 W
3905 (the host \050this would normally be the case unless you have done something special to change things\051.)SH
3909 (Load the program you entered in the first step with DDT, and use it to capture the first hex file:)SH
3914 (-icpsker.hex ;Setup)
3915 6600 W( FCB for file CPSKER.HEX)SH
3917 (-g100,179 ;Execute)
3918 8400 W( the program.)SH
3921 (Now there should be a file)SH
3927 (on your connected disk.)SH
3931 (Return to the host, and tell it)
3932 112 W( to display the second hex file \050the system-dependent module for your)113 W
3934 (configuration\051. Again,)
3935 250 W( do not type the terminating carriage return.)SH
3939 (Return to your micro, and run the capture program again:)SH
3944 (-icpxovl.hex ;Setup)
3945 6600 W( FCB to create CPXOVL.HEX)SH
3947 (-g100,179 ;Execute)
3948 8400 W( the program.)SH
3951 (Now there should be a file)132 W
3957 (on your connected disk. Replace)131 W
3965 (example with the appropriate overlay file for your system.)SH
3967 (Merging the files:)SH
3971 (For purposes of illustration, we will assume the system-dependent overlay is called "cpxovl)162 W
3978 1 W( files may be combined with MLOAD or DDT. If you already have a running Kermit, you)SH
3986 (to your system and create)209 W
3992 (by running LOAD. If you're)209 W
3994 (bootstrapping Kermit, you could transfer)27 W
4000 (to your system the same way you got the)
4009 (files, but it's probably simpler to use DDT to get Kermit running, and get MLOAD later if)41 W
4015 (Using MLOAD, the two pieces may be easily merged:)SH
4018 (A>mload kerm411=cpsker,cpxovl)SH
4019 16200 50 12720 64278 UL
4022 (\050Some messages about program size, etc...\051)SH
4030 (If you don't have MLOAD running, it's a bit more complex:)SH
4037 (1.7.2. Downloading Kermit-80)SH
4041 46800 50 8280 5709 UL
4044 (A>ddt cpsker.hex)SH
4045 8400 50 14880 8024 UL
4052 6600 50 14280 11117 UL
4055 600 50 14280 12148 UL
4062 1200 50 14280 15241 UL
4071 11400 50 14880 16272 UL
4075 50 W( \050"dd"\051 used in the SAVE command is calculated from the last address \050"xxxx"\051 given)49 W
4078 48 W( response to the R command: drop the last two digits and add 1 if they were not zero, then)49 W
4080 (convert from hexadecimal \050base 16\051 to decimal \050base 10\051: 684F)
4081 11 W( becomes 69 hex, which is 105 decimal)10 W
4083 (\0505 times 16 plus 9\051)
4084 89 W( -- but 6700 becomes 67 hex, or 103 decimal \050consult an introductory computing)90 W
4086 (book if you don't understand number base conversion\051.)SH
4090 (If you are using the Z80MU)
4091 53 W( CP/M and Z80 development toolkit on an IBM PC or clone, then follow)52 W
4093 (the same instructions as for a genuine CP/M system. When you have loaded your file, you will)
4096 (to ship the .COM or two .HEX files to the target CP/M system. \050Possibly)
4097 108 W( using a previous issue of)107 W
4103 (Note that CP/M hex files have checksums on each line. If there were any transmission)
4104 67 W( errors during)68 W
4106 (the downloading process, MLOAD or DDT will)
4107 210 W( notice a bad checksum and will report an error)209 W
4109 (\050something like "Illegal Format"\051. If you get any errors during loading, either fix the hex)
4110 63 W( file locally)64 W
4112 (with an editor, or repeat the transfer.)SH
4114 (You now should have a running version of Kermit-80, called)SH
4121 (Test your new Kermit by running it. If)
4122 96 W( it gives you a prompt, it might be OK. \050don't delete your old one yet...\051.)95 W
4124 (Instead of a prompt, you could get one of two messages indicating that the configuration information is invalid:)SH
4127 (?Kermit has not been configured for a target system)SH
4133 (?Consistency check on configuration failed)SH
4136 (Of course, neither of these messages should appear)
4137 109 W( if you're building Kermit from the distribution kit. The first)110 W
4139 (message indicates that)
4140 1 W( the overlay was not found where the system-independent module expected to find it, probably)SH
4142 (because the overlay address is incorrect; the second indicates that the version of CPXLNK used in the system-)157 W
4144 (dependent module is incompatible with the system-independent module.)SH
4146 (Once you are satisfied that KERMIT40 works correctly, you should rename your old)76 W
4173 (1.7.3. Assembling Kermit-80 from the sources)SH
4176 (Kermit-80 is built in two pieces from the following files:)SH
4179 (The system-independent files:)SH
4191 (definitions for both KERMIT and KERSYS)SH
4197 (initialization, main loop, miscellaneous commands \050BYE, EXIT, LOG, SET,)
4198 30 W( SHOW, STATUS,)31 W
4206 (second part of commands, status and set file)SH
4212 (part 1 of the KERMIT protocol handler \050SEND, RECEIVE, LOGOUT,and FINISH commands\051)SH
4218 (part 2 of the KERMIT protocol handler)SH
4224 (REMOTE routines \050FINISH, BYE and LOGOUT in CPXPK*.ASM\051)SH
4230 (SERVER routines \050for the future\051)SH
4236 (the transparent commands \050TRANSMIT, CONNECT\051)SH
4246 (Kermit User Guide: CP/M-80 KERMIT 1.7.3)SH
4247 46800 50 6120 5709 UL
4253 (CP/M commands \050DIR, ERA, USER, TYPE, PRINT, COPY\051)SH
4259 (the wildcard handler)SH
4265 (the command parser)SH
4271 (utility routines and data)SH
4277 (data space and the overlay definitions)SH
4283 (linkage area description)SH
4286 (The system-dependent files:)SH
4292 (system selection)SH
4298 (system overlay specification and jump table)SH
4304 (common routines for all systems)SH
4310 (system selector or switcher)SH
4318 (family file for some system-specific code)SH
4324 (family file for Torch, Superbrain, PCI2651 etc)SH
4330 (family file for Northstar and Comart machines)SH
4336 (family file for British Telecom Merlin/Rair Black Box)SH
4342 (family file for Micromint SB-180 systems)SH
4348 (family file for Cifer systems)SH
4354 (family file for Heath/Zenith systems)SH
4360 (family file for Apple II systems)SH
4366 (family file for Amstrad PCW 8256/8512 machines)SH
4372 (family file for BigBoard, Kaypro and Xerox 820 systems)SH
4384 (family file for Sanyo MBS-1100 systems)SH
4390 (family file for Tandy Model 4 with CP/M systems)SH
4396 (family file for Video Genie systems)SH
4402 (family file for Compupro systems)SH
4408 (family file for the Z80MU development system)SH
4410 (and if you use a terminal,)SH
4416 (display codes for VDUs etc. Not always required)SH
4418 (The system-independent module contains all of the system-independent files)
4419 135 W( except for)134 W
4426 (assembled into the system-dependent module to provide the structures needed to connect the)
4427 156 W( two modules. As)157 W
4429 (distributed, the system-independent module is named)28 W
4443 (not need to reassemble the system-independent module to configure Kermit for your system.)SH
4445 (The system-dependent module consists of)503 W
4471 675 W( the family files)674 W
4536 (, and possibly)23 W
4542 23 W( system uses a terminal for the console. One)22 W
4545 1 W( system-dependent module is supplied already assembled for each supported system; the filename may be)2 W
4547 (obtained from tables 1-2 and 1-3. If a terminal is)
4548 170 W( required for a system, a CRT \050glass TTY device\051 has been)169 W
4552 (After assembling the two pieces separately, they are combined with DDT or MLOAD into a system-specific Kermit.)SH
4554 (If you want to rebuild the system-independent module, the only change you may)
4555 159 W( need to make is to select the)160 W
4557 (assembler to be used, in)182 W
4563 614 W( one of MAC80, M80, or LASM to TRUE to select)
4564 182 W( it as the)181 W
4566 (assembler; the others should be defined FALSE.)SH
4568 (Assuming you have the Microsoft Macro Assembler package \050M80/L80\051, you'll need to do the following:)SH
4571 (A>m80 cpsker=cpsker.asm)SH
4572 12600 50 9720 70273 UL
4574 (A>l80 /p:100,cpsker,cpsker/n/e)SH
4575 16800 50 9720 71304 UL
4582 (1.7.3. Assembling Kermit-80 from the sources)SH
4586 46800 50 8280 5709 UL
4589 (This will produce)SH
4596 (If you are using LASM instead, do this:)SH
4600 6600 50 11880 12133 UL
4603 (LASM will generate)53 W
4615 358 W( allows options to be specified in the same way as)54 W
4617 (the standard assembler, ASM, so the command)SH
4620 (A>lasm cpsker.abz)SH
4621 9000 50 11880 16701 UL
4624 (will read the source files from drive A, send the)SH
4630 (file to drive B, and suppress the listing file.)SH
4633 128 W( the Z80MU development system on an IBM PC or clone, then assemble your files using either)127 W
4635 (LASM and MLOAD or M80 and L80, as)
4636 3 W( if you were using a genuine CP/M-80 system. Note that you will still have)4 W
4638 (the problem of transferring your assembled files to the target CP/M system.)SH
4640 (If you want to generate a system-dependent overlay for a particular system, or want to change the terminal)247 W
4642 (supported, you'll need to check three areas in)SH
4649 (First, the overlay start ADDRESS. The symbol)
4650 83 W( "ovladr" is EQUated to the address of "LNKFLG" in the system-)84 W
4652 (independent module, as the starting address of the overlay \0507000H for version)109 W
4658 468 W( need to know this)109 W
4660 (value if you're building the overlay with M80/L80. You won't normally need to change this value.)SH
4662 (Second, the assembler being used. Again, define one of MAC80, M80, and LASM to be TRUE to)
4663 104 W( select it, and)105 W
4665 (define the others to be FALSE. The two modules \050system-independent and system-dependent\051)
4666 100 W( do not need to be)99 W
4668 (built with the same assembler.)SH
4670 (Third, the system configuration. Locate your system in)
4671 158 W( tables 1-2 and 1-3, then define the appropriate symbol)159 W
4673 (TRUE, and the rest FALSE.)
4675 417 W( the system comes with a builtin console terminal, define all the terminal switches)83 W
4678 558 W( the system uses an external terminal as the console, locate the terminal in)
4679 154 W( table 1-5 and define the)155 W
4681 (appropriate symbol TRUE, and the remainder FALSE.)
4683 289 W( the terminal is not listed in table 1-5, use the CRT switch;)19 W
4685 (in this case, VT52 emulation is not supported.)SH
4687 (In addition, there are a few general and system-specific symbols which may be altered to fit your system:)SH
4691 (For Apple with 6551 ACIA, defines the slot number of the serial card)SH
4695 (Processor speed in units of 100KHz \050currently used only for bbII and kpII for timing loops\051)SH
4699 (For users connecting through ARPAnet TACs: set to TRUE if you)
4700 53 W( wish the default TACTRAP)54 W
4702 (status to be ON. \050This may be overridden with the SET TACTRAP command\051. If)
4703 99 W( you're not)98 W
4705 (connecting through a TAC, set tac to FALSE and ignore tacval.)SH
4709 (For ARPANET TAC users: defines the default TAC)
4710 4 W( intercept character \050may be overridden with)5 W
4712 (the SET TACTRAP command\051.)SH
4714 (If you are just assembling an existing configuration,)
4715 141 W( you'll need to edit)140 W
4722 530 W( you are adding)140 W
4725 16 W( system, you should not modify)17 W
4736 (; if you do, you'll have to change)17 W
4738 (the system-independent module also. Eventually,)28 W
4744 (will be split into separate)
4745 28 W( files, each of which will)27 W
4747 (generate one or more related systems. When this happens, you'll want to pick the one closest to your)
4748 29 W( system to use)30 W
4750 (as a starting point.)SH
4758 (as necessary, assemble and link the overlay as follows:)SH
4764 (With M80 \050where "xxxx" is the hex value of ovladr from)SH
4772 (A>m80 cpxtyp=cpxtyp.asm)SH
4773 12600 50 14380 68891 UL
4775 (A>l80 /p:xxxx,cpxtyp,cpxtyp/n/x/e)SH
4776 18600 50 14380 69922 UL
4792 (Kermit User Guide: CP/M-80 KERMIT 1.7.3)SH
4793 46800 50 6120 5709 UL
4797 6600 50 12220 8024 UL
4800 (With an IBM PC or clone using the Z80MU softwrae, follow the instructions as if)
4801 128 W( you were using a real CP/M)127 W
4805 (The overlay \050)6 W
4809 (\051 may then be merged with the system-independent module as)
4810 6 W( described above \050creating)7 W
4812 (a runnable Kermit from the distribution kit\051.)SH
4814 (If you are using the Z80MU development system on a PC, and already have a running)
4815 42 W( Kermit-80 v3.9 or later, you)41 W
4830 (file with LINK80 \050TOPS 10/20\051, MLOAD \050Z80MU\051, L80 \050Z80MU\051, and)2 W
4832 (transfer the new)SH
4838 (file to your micro with Kermit:)SH
4844 (Z80MU on a PC and MLOAD:)SH
4847 (@MLOAD KERNEW=CPSKER,CPXTYP)SH
4848 15600 50 11620 23544 UL
4854 (Z80MU on a PC and C80:)SH
4857 (@L80 /P:xxxx,CPXTYP,CPXTYP/N/X/E)SH
4858 18600 50 11620 27188 UL
4867 46800 50 6120 30589 UL
4871 (Terminal description)SH
4872 3112 50 6120 33018 UL
4873 8360 50 16920 33018 UL
4877 (Basic CRT, no cursor positioning)SH
4881 (ADM3A Display or lookalike)SH
4885 (ADM22 Display or lookalike)SH
4897 (Netronics Smartvid-80)SH
4909 (TVI 925, Freedom 100)SH
4913 (VT 52 or VT52 emulator such as Heath H19, H29, etc.)SH
4917 (VT 100 or emulator \050most ANSI terminals should work\051)SH
4927 (Terminals known to Kermit-80)SH
4928 46800 50 6120 49498 UL
4931 (1.8. Adding Support For A New System)SH
4934 (Kermit-80 is built from a common set of source files; the system-dependent module makes heavy use)
4935 23 W( of conditional)22 W
4937 (assembly \050this complication will be removed in future releases\051. The)
4938 90 W( system dependencies arise from attempts to)91 W
4940 (answer some questions:)SH
4945 (What kind of terminal is to be supported?)SH
4948 (For many micros, the console is an integral part of the system, but others)
4949 25 W( can use an external terminal.)24 W
4951 (In either case, the commands to manipulate the screen \050position)
4952 38 W( the cursor, erase the screen, etc\051 must)39 W
4959 (How is the serial line accessed?)SH
4962 (For systems supporting the IOBYTE function,)
4963 38 W( this is straightforward; the symbol "IOBYT" is defined)37 W
4966 554 W( the serial line is accessed with IN and OUT instructions, it may be possible to use the)152 W
4968 (simple I/O routines provided. In this case, the symbol "INOUT" is)
4969 36 W( defined TRUE, the MNPORT and)35 W
4971 (MNPRTS are defined to be the data and control addresses, respectively, and)
4972 64 W( bit masks for testing for)65 W
4979 (1.8. Adding Support For A New System)SH
4983 46800 50 8280 5709 UL
4986 ("input data available")
4987 123 W( and "output buffer empty" must be defined. If the interface is strange, leave)122 W
4989 (IOBYT and INOUT set to FALSE, and provide the I/O routines.)SH
4994 (What initialization is necessary?)SH
4997 (You may wish to set the baud rate or configure the serial line at startup. Examples)
4998 86 W( for a number of)87 W
5000 (devices are present.)SH
5005 (What special features are to be supported?)SH
5008 (You may want to provide the capability to select one of several serial lines with the SET)
5011 (command, or to change the speed)
5012 24 W( of the serial line with the SET SPEED command. To do this, you'll)25 W
5014 (need to build a command table, using the systems already)
5015 2 W( supported as examples. The ability to send a)1 W
5017 (BREAK signal is desirable. Again, examples for several different interfaces \050ACIA, SIO,)
5018 149 W( etc\051 are)150 W
5025 (Do you want to design an external terminal type?)SH
5028 (There is a jump entry in the overlay file to allow users to add their own termainl emulator.)
5032 (write the code for)
5033 223 W( such an emulator, you must load this jump address with the address of your)224 W
5036 106 W( TERMINAL EXTERNAL from within Kermit. All characters will be passed to)105 W
5038 (this routine during connect mode.)SH
5041 (1.9. Notes on New Features in Kermit-80 Version 4)SH
5047 (Debugging aids:)218 W
5050 (SET DEBUG ON will add two fields to the SEND/RECEIVE display, labelled)218 W
5053 40 W( "Rpack". These display the last packet sent and received. Of course, this slows down the)39 W
5055 (transfer, especially if the console is an external)
5056 24 W( terminal. SET DEBUG OFF removes these fields. The)25 W
5059 27 W( displays the name, edit number, and edit date of several of the modules that make)26 W
5070 (ARPAnet TACs \050and many other communication devices)
5071 32 W( such as terminal concentrators,)33 W
5073 (modems, port contention units, network PADs, etc\051 use a printing character \050like)
5074 79 W( "@"\051 as an intercept)78 W
5076 (character, to allow commands to be issued to the TAC, or modem, etc. In order to send this character)
5079 (the host, it must be typed)
5080 163 W( twice. The command "SET TAC CHARACTER" to Kermit enables the)162 W
5082 ("TACtrap" and asks the)
5083 358 W( user to specify the TAC intercept character. This character will be)359 W
5085 (automatically doubled when it)
5086 94 W( appears in Kermit protocol messages \050sent by the SEND or RECEIVE)93 W
5088 (commands\051 or when it appears in a)
5089 295 W( file being sent with the TRANSMIT command. It is not)296 W
5091 (automatically doubled when typed by the user in CONNECT mode. "SET TAC)
5092 192 W( ON" enables the)191 W
5094 (TACtrap but does not change the TAC intercept character, which)
5095 109 W( is initially "@". "SET TAC OFF")110 W
5097 (disables the TACtrap.)SH
5103 (File buffering:)96 W
5106 (Previous versions of Kermit-80 buffered only)
5107 96 W( one sector \050128 bytes\051 at a time during)95 W
5109 (file transfer operations. This version buffers 16Kbytes at a time, reducing the number of)
5110 151 W( times the)152 W
5112 (floppy drive must be)
5113 33 W( spun up and down, and increasing the effective throughput of the link. If the disk)32 W
5116 89 W( too slow, however, the remote Kermit may time out and retransmit packets. This will)90 W
5118 (show up on the screen in the "Retries:" field; if this occurs after disk activity, you)
5119 26 W( may want to increase)25 W
5121 (the timeout value on the remote Kermit,)
5122 135 W( SET BUFFER <new value> while in Kermit,or reassemble)136 W
5124 (Kermit with a smaller value for MAXSEC \050in)304 W
5130 304 W( buffer is also used by the)303 W
5132 (TRANSMIT command; the log file enabled by the LOG command is still written a sector at a time.)SH
5134 (This section is intended for people wanting to implement their own versions)
5135 16 W( of Kermit-80 for computers not already)17 W
5139 (The system independent code communicates to routines for a specific system through a set of tables.)
5143 (are defined in CPXLNK.ASM, and)
5144 106 W( should not be modified between revisions of Kermit. If an entry is added or)107 W
5154 (Kermit User Guide: CP/M-80 KERMIT 1.9)SH
5155 46800 50 6120 5709 UL
5159 199 W( the whole of Kermit-80 needs reassembling. Make sure that the changes to CPXLNK.ASM are)198 W
5161 (duplicated in CPSUTL.ASM, which has the system independent equivalent of CPXLNK.ASM.)SH
5163 (The following entries/definitions apply)
5164 140 W( to revision 4.09. There have been three additional entries since revision)141 W
5169 56 W( is split into three sectors; The first section defines two byte "words" giving 16 bits of interface data; The)55 W
5171 (second set is a set of jumps to various functions, and finally the third set a set of pure data bytes.)SH
5174 (1.9.1. Interface Data.)SH
5179 (Must be first entry in overlay at overlay address. Is a two byte address giving the size of the)98 W
5180 3944 50 10120 21516 UL
5182 (linkage table. This is used to check for consistency of overlay's)SH
5185 4055 50 10120 25050 UL
5187 (Length of entry table, also used for consistency checking after the overlay. Currently 6)SH
5191 (The address of a dollar-terminated string giving the overlay revision level and date. Points)
5193 3778 50 10120 28584 UL
5195 (string like: CPXSYS.ASM\05033\051 4-JUN-1986$)SH
5199 (The address of a dollar-terminated string giving the Family overlay revision)
5200 80 W( level and date. If)79 W
5201 3833 50 10120 32118 UL
5203 (the system is in CPXSYS.ASM rather than a)
5204 46 W( particular Family overlay, it is simply a pointer to)47 W
5209 (1.9.2. Jump Table.)SH
5212 (This is split into three main sectors-)SH
5216 (Input/Output routines)SH
5220 (Screen formatting routines)SH
5224 (other system dependent routines)SH
5227 4278 50 7120 52446 UL
5245 (selects the modem port. Most)
5246 56 W( systems do nothing and simply return. HL,DE and BC registers)55 W
5251 4555 50 7120 59295 UL
5269 (Output the character in E register to the communications line. BC,DE,HL registers preserved.)SH
5272 4111 50 7120 65039 UL
5284 (Accumulator either 0 or character from comms line if available)SH
5291 90 W( for character and if so, return it in A. HL,DE,BC registers preserved, flags and)91 W
5293 (accumulator lost.)SH
5296 4223 50 7120 71888 UL
5303 (1.9.2. Jump Table.)SH
5307 46800 50 8280 5709 UL
5324 (Clear any pending characters in the input buffer from the modem. No registers are preserved.)SH
5327 3889 50 9280 12725 UL
5345 (Select the console.)
5347 337 W( is a null subroutine for most systems, but for IOBYTE systems selects)43 W
5352 4166 50 9280 19574 UL
5370 (Send the character in E to the console. Any quirks)
5371 145 W( of system responding in an odd manner)146 W
5373 (should be handled. No registers preserved.)SH
5376 3722 50 9280 26423 UL
5388 (Zero or character in A.)SH
5394 (Get a character from the console or return a null if no character to be read.)
5396 486 W( registers are)118 W
5401 3833 50 9280 33272 UL
5419 (Send the character in E to the printer. The console is selected. Only DE registers are preserved)SH
5422 4278 50 9280 39016 UL
5434 (00H or 0FFH in A register)SH
5440 (Test the printer to see if it is ready to receive a character to)
5441 20 W( be printed. If a 00H is returned then)21 W
5443 (the printer is ready to receive a character.)SH
5446 3833 50 9280 45865 UL
5452 (Character to be sent to the user supplied terminal emulator in the E register)SH
5464 (If the user has supplied a terminal emulator in)
5465 67 W( the overlay code, EXTTER will be a JMP <non)66 W
5467 (zero address>. If SET TERMINAL EXTERNAL has been)
5468 148 W( set, all caharcters will be passed)149 W
5470 (verbatim to this terminal emulator. If there is)
5471 155 W( no external emulator, this code will never be)154 W
5474 320 W( user should reset terminal conditions on initialisation of both the system and)
5478 250 W( registers should be preserved.)SH
5481 3389 50 9280 56029 UL
5487 (Any required for calling BDOS)SH
5493 (Any expected from the called BDOS routine)SH
5499 (This is an alternative entry to BDOS. This entry will)
5500 53 W( also check the printer status etc. For full)52 W
5502 (details see the code for the BDOS trap in CPSUTL.ASM.)SH
5507 3611 50 16280 65307 UL
5525 (Clear the current line on the terminal)SH
5528 3724 50 9280 71051 UL
5544 (Kermit User Guide: CP/M-80 KERMIT 1.9.2)SH
5545 46800 50 6120 5709 UL
5557 (Erase the current position \050after a backspace\051)SH
5560 4000 50 7120 11620 UL
5578 (Make delete \0507FH\051 look like a backspace. Some systems do a backspace, space, backspace)163 W
5580 (automatically others have to simulate it)SH
5583 3834 50 7120 18469 UL
5601 (Clear the screen and place the cursor at the top LH corner)SH
5604 3945 50 7120 24213 UL
5622 (Place the cursor on the line for the Kermit-80 prompt after a file transfer. \050Usually line 13\051)SH
5625 3835 50 7120 29957 UL
5643 (Move cursor to the error message field on the file transfer format screen)SH
5646 3779 50 7120 35701 UL
5664 (Move the cursor to the filename field)SH
5667 3168 50 7120 41445 UL
5685 (Move the cursor to the packet count field)SH
5688 3890 50 7120 47189 UL
5706 (Move cursor to the retry count field)SH
5709 3057 50 7120 52933 UL
5727 (Move cursor to the status field)SH
5730 3057 50 7120 58677 UL
5748 (Move to the receive packet field \050debugging use\051)SH
5751 2946 50 7120 64421 UL
5769 (Move to the send packet field \050for debugging use\051)SH
5774 3833 50 14120 72594 UL
5781 (1.9.2. Jump Table.)SH
5785 46800 50 8280 5709 UL
5802 (Initialize the system specific)
5803 49 W( items. No registers are preserved. Any initialization is done once)48 W
5805 (only when Kermit-80 is first loaded.)SH
5808 4111 50 9280 13830 UL
5826 (Program termination. De-initialize anything in preparation for a return to CP/M)SH
5829 3945 50 9280 19574 UL
5847 (Initialize anything before entering the connect state.)SH
5850 3668 50 9280 25318 UL
5868 (System dependent close routine when exiting connect state)SH
5871 3611 50 9280 31062 UL
5889 (Help routine to test for any extensions to the escape menu during the connect state.)
5891 331 W( a system)41 W
5893 (has any special feature it)
5894 499 W( can use during connect mode, then it can be tested as)498 W
5896 (<escape-character>xxx. This)
5898 560 W( is a string for printing to the console for an)561 W
5900 (<escape-character>? Often)
5901 250 W( used for generating breaks or controlling a modem.)SH
5904 3500 50 9280 40121 UL
5922 (This is a test-and-jump on receipt of an escape sequence not understood by Kermit-80.)
5926 (character in A is not recognized by your version of Kermit=80, do a rskip)SH
5929 3612 50 9280 46970 UL
5941 (Character in E. Either a 00H or anything else in A)SH
5947 (Test the character in E. If it may not be printed to the console, set A to zero.)
5949 317 W( other registers)34 W
5953 (NB <XON>,<XOFF>,<DEL>,<NULL> are always rejected.)SH
5956 3834 50 9280 54924 UL
5974 (System dependent processing for the BYE command. \050eg hang up the phone\051)SH
5977 3668 50 9280 60668 UL
5983 (Value from table in DE)SH
5995 (The system dependent code for baud rate)
5996 9 W( change. DE contains the two byte value from the baud)8 W
5998 (rate table. This value is also stored in "SPEED")SH
6001 3668 50 9280 67517 UL
6019 (The system dependent code for setting the port. The parameters are passed in DE,)
6020 106 W( which are)107 W
6022 (obtained from the port tables)SH
6032 (Kermit User Guide: CP/M-80 KERMIT 1.9.2)SH
6033 46800 50 6120 5709 UL
6037 3724 50 7120 9610 UL
6043 (String pointer in DE)SH
6055 (Setup the screen display for file transfer. The Kermit version string is pointed to by DE. If)
6058 (terminal is not capable of cursor addressing \050eg dumb glass TTY\051 then)
6059 12 W( only the screen is cleared)13 W
6061 (and the version string is printed.)SH
6064 3724 50 7120 17564 UL
6070 (Row number in B, column number in C)SH
6082 (Move the cursor to)
6083 74 W( row B, column C where B=1,C=1 is top LH corner of screen. The routine)73 W
6085 (should first end a)
6086 19 W( "cursor position" leading string \050up to four characters\051 then use the parameters)20 W
6088 (given to complete the versions cursor position function)SH
6091 3613 50 7120 25518 UL
6103 (K bytes free in HL)SH
6109 (Get the amount of free disk space on the selected disk drive. This could be in the system)179 W
6111 (independent code. Automatically detects CP/M V2.2 or V3.0. No registers saved.)SH
6114 3611 50 7120 32367 UL
6120 (Source Pointer in HL)SH
6122 (Destination Pointer in DE)SH
6124 (Byte count in BC)SH
6136 (Move \050BC\051 bytes from \050HL\051 to \050DE\051 Z80 based)
6137 50 W( systems do an LDIR, while 8080 systems do it)51 W
6139 (as a loop. All registers destroyed)SH
6142 3668 50 7120 41426 UL
6148 ($ terminated string pointed to by DE)SH
6160 (Print the string onto the console.)SH
6168 (Points to VT52 equivalent escape sequences.)SH
6169 3167 50 7120 50704 UL
6175 (Address of baud-rate command table, or 0 if table does not exist)SH
6176 3834 50 7120 53133 UL
6182 (Address of baud-rate help table, or 0 if SET SPEED is not supported.)SH
6183 3723 50 7120 55562 UL
6189 (Address of port command table or 0 if SET PORT is not supported.)SH
6190 3834 50 7120 57991 UL
6196 (Address of port help table or 0 if SET PORT is not supported)SH
6197 3723 50 7120 60420 UL
6204 582 W( to value suitable to your system \050depends largely)
6206 3888 50 7120 62849 UL
6214 (VT52 emulation flag. Set to 0 if terminal)
6215 23 W( emulates a VT52, 01 if emulation is)24 W
6216 3222 50 7120 66383 UL
6218 (required, or 0FFH if emulations not possible \050eg for "CRT"\051)SH
6224 (default escape character-usually control-] but sometimes control-\134)SH
6225 3890 50 7120 69917 UL
6231 (Storage space for baud-rate. Set to 0FFFFH as)
6232 303 W( baud rates are initially)302 W
6233 3056 50 7120 72346 UL
6240 (1.9.2. Jump Table.)SH
6244 46800 50 8280 5709 UL
6248 250 W( that the STATUS routine only looks at the first \050least significant\051 byte.)SH
6254 (Storage space for port. Set to 0FFFFH as ports may not be implemented, and)43 W
6255 2556 50 9280 10515 UL
6257 (is initially unknown)SH
6263 (Printer copy flag-if O no copy. Anything else => copy to printer)SH
6264 3834 50 9280 14049 UL
6270 (Debugging flag. If O then no debugging to be)
6271 24 W( done. \050ie writing of debugging)23 W
6272 4000 50 9280 16478 UL
6274 (info during a file transfer\051)SH
6280 (Local ECHO flag \050default is off\051)SH
6281 3889 50 9280 20012 UL
6287 (File warning flag. If set to 1 will not overwrite files already existing)
6289 4000 50 9280 22441 UL
6291 (with some-named files being transferred)SH
6297 (IBM system is the host-assume IBM file transfers etc)SH
6298 3778 50 9280 25975 UL
6305 322 W( type of CP/M files to be transferred. Default setting -)321 W
6306 4001 50 9280 28404 UL
6314 (Type of parity in use)SH
6315 3611 50 9280 31938 UL
6321 (6 = No parity \0508th bit is data\051)SH
6325 (12 = Space parity)SH
6331 (Size of send packet)SH
6332 2612 50 9280 39892 UL
6338 (Size of receive packet)SH
6339 2723 50 9280 42321 UL
6345 (Send timer \050time-out\051)SH
6346 3000 50 9280 44750 UL
6352 (Receive timer \050time-out\051)SH
6353 3111 50 9280 47179 UL
6359 (Send Padding \050default=0\051)SH
6360 2556 50 9280 49608 UL
6366 (Receive Padding \050default=0\051)SH
6367 2667 50 9280 52037 UL
6373 (Send Padding character \050default=NULL\051)SH
6374 3945 50 9280 54466 UL
6380 (Receive Padding character \050default=NULC\051)SH
6381 4056 50 9280 56895 UL
6387 (Send EOL character \050default=CR\051)SH
6388 2500 50 9280 59324 UL
6394 (Receive EOL character \050default=CR\051)SH
6395 2611 50 9280 61753 UL
6401 (Send quote character \050default=#\051)SH
6402 3944 50 9280 64182 UL
6408 (Receive quote character \050default=#\051)SH
6409 4055 50 9280 66611 UL
6415 (Ascii value of checktype)SH
6416 4000 50 9280 69040 UL
6418 (31H="1"=checktype1 \0506bits\051)SH
6420 (32H="2"=checktype2 \05012bits\051)SH
6430 (Kermit User Guide: CP/M-80 KERMIT 1.10)SH
6431 46800 50 6120 5709 UL
6434 (33H="3"=CCITT checksum \050CRC\051)SH
6436 (Default is 31H\050"1"\051)SH
6442 (If set to on \050non zero\051 send the TACCHR twice. This is for ARPA TAC users,)3 W
6443 3889 50 7120 11620 UL
6445 (where the TAC swallows one "wakeup" character.)
6447 271 W( sent twice the TAC will pas one on and go)10 W
6449 (back to normal mode.)SH
6455 (Desired TAC character. It is ignored if TAC trapping is turned off. Value)
6457 4056 50 7120 16259 UL
6459 (send twice if TAC interception is set on. Default=0, but set to commercial)
6460 16 W( AT if the conditional)15 W
6462 (assembly flag TAC is set true)SH
6468 (Address of Multi-Sector buffering for I/O)SH
6469 4056 50 7120 20898 UL
6475 (The number of bytes the big buffers can hold. Default is 1. \0500=256 sectors\051.)SH
6476 3779 50 7120 23327 UL
6483 491 W( funny characters may be used in CP/M file names \050eg)492 W
6484 3668 50 7120 25756 UL
6489 (\051 If zero, allow anything. Default is nonzero.)SH
6493 (SPACE:\0502bytes\051 Highest block number on selected disk drive)SH
6494 3000 50 7120 29290 UL
6498 (SPACE:\0501byte\051 \050Records/block\051-1)SH
6499 3556 50 7120 31719 UL
6503 (SPACE:\0501byte\051 Number of shifts to multiply by rec.block)SH
6504 4001 50 7120 34148 UL
6508 (SPACE:\0501byte\051 Counter for file-names per line)SH
6509 3611 50 7120 36577 UL
6512 (1.10. Future Work)SH
6515 (Work that needs to be done in future releases includes:)SH
6521 (Merge in support for additional CP/M-80 systems, particularly)
6522 135 W( those for which support was recently)134 W
6524 (added to the monolithic v3.x source.)SH
6536 (into discrete source files, one for each system. These source files should serve)
6539 (simple models for adding support for new)
6540 308 W( systems to Kermit-80 -- only the very basic screen)307 W
6542 (definitions, flags, i/o primitives,)
6543 131 W( initializations, and so forth should appear in each system-dependent)132 W
6551 (Addition of missing)
6552 352 W( features -- compression of repeated characters during packet transmission,)351 W
6554 (transmission of file attributes \050particularly size, so that "percent done")
6555 243 W( can be displayed for both)244 W
6557 (incoming and outbound files\051, command macros, more advanced login scripts, remote operation)
6560 (server mode, etc etc. Any offers??)SH
6571 46800 50 8280 5709 UL
6592 (Attention Character)
6597 (Autoreceive 7)400 W
6612 (Bootstrapping CP/M Kermit)
6634 (Set Start of packet)
6662 (Terminal Emulation)
6690 (Directory file size)
6695 (Downloading 20)400 W
6719 (External Terminal Emulation)
6731 (File-Warning 6)400 W
6749 (Intercept Character)
6781 (Kermit User Guide)SH
6782 46800 50 6120 5709 UL
6793 46800 50 8280 5709 UL
6796 (Table of Contents)SH
6799 (1. CP/M-80 KERMIT)SH
6812 (1.3. Overview of Kermit Operation)SH
6816 (1.4. Summary of CP/M)SH
6820 (1.5. Kermit-80 Description)SH
6824 (1.6. Kermit-80 Flavors)SH
6828 (1.6.1. Generic Kermit-80)SH
6832 (1.6.2. CP/M 3 Kermit)SH
6836 (1.6.3. System-Specific Versions)SH
6840 (1.7. Installation of Kermit-80)SH
6844 (1.7.1. Organization of Kermit-80)SH
6848 (1.7.2. Downloading Kermit-80)SH
6852 (1.7.3. Assembling Kermit-80 from the sources)SH
6856 (1.8. Adding Support For A New System)SH
6860 (1.9. Notes on New Features in Kermit-80 Version 4)SH
6864 (1.9.1. Interface Data.)SH
6868 (1.9.2. Jump Table.)SH
6872 (1.10. Future Work)SH
6889 (Kermit User Guide)SH
6890 46800 50 6120 5709 UL
6901 46800 50 8280 5709 UL
6909 500 W( program for Kermit-80 and CP/M Version 2.2)SH
6921 (Kermit User Guide)SH
6922 46800 50 6120 5709 UL
6933 46800 50 8280 5709 UL
6941 500 W( SET PORT Options)SH
6947 500 W( supported by Kermit-80 \050Part 1\051)SH
6953 500 W( supported by Kermit-80 \050Part 2\051)SH
6959 500 W( supported by Kermit-80)SH
6965 500 W( known to Kermit-80)SH
6971 %%DocumentFonts: Times-Roman Times-Bold Times-Italic Courier Symbol Courier-Oblique