%!PS-Adobe-1.0 %%Title: kuser.mss %%DocumentFonts: (atend) %%Creator: Frank da Cruz,718W,0000, and Scribe 6(1600) %%CreationDate: 8 November 1988 15:15 %%Pages: (atend) %%EndComments % PostScript Prelude for Scribe. /BS {/SV save def 0.0 792.0 translate .01 -.01 scale} bind def /ES {showpage SV restore} bind def /SC {setrgbcolor} bind def /FMTX matrix def /RDF {WFT SLT 0.0 eq {SSZ 0.0 0.0 SSZ neg 0.0 0.0 FMTX astore} {SSZ 0.0 SLT neg sin SLT cos div SSZ mul SSZ neg 0.0 0.0 FMTX astore} ifelse makefont setfont} bind def /SLT 0.0 def /SI { /SLT exch cvr def RDF} bind def /WFT /Courier findfont def /SF { /WFT exch findfont def RDF} bind def /SSZ 1000.0 def /SS { /SSZ exch 100.0 mul def RDF} bind def /AF { /WFT exch findfont def /SSZ exch 100.0 mul def RDF} bind def /MT /moveto load def /XM {currentpoint exch pop moveto} bind def /UL {gsave newpath moveto dup 2.0 div 0.0 exch rmoveto setlinewidth 0.0 rlineto stroke grestore} bind def /LH {gsave newpath moveto setlinewidth 0.0 rlineto gsave stroke grestore} bind def /LV {gsave newpath moveto setlinewidth 0.0 exch rlineto gsave stroke grestore} bind def /BX {gsave newpath moveto setlinewidth exch dup 0.0 rlineto exch 0.0 exch neg rlineto neg 0.0 rlineto closepath gsave stroke grestore} bind def /BX1 {grestore} bind def /BX2 {setlinewidth 1 setgray stroke grestore} bind def /PB {/PV save def newpath translate 100.0 -100.0 scale pop /showpage {} def} bind def /PE {PV restore} bind def /GB {/PV save def newpath translate rotate div dup scale 100.0 -100.0 scale /showpage {} def} bind def /GE {PV restore} bind def /FB {dict dup /FontMapDict exch def begin} bind def /FM {cvn exch cvn exch def} bind def /FE {end /original-findfont /findfont load def /findfont {dup FontMapDict exch known{FontMapDict exch get} if original-findfont} def} bind def /BC {gsave moveto dup 0 exch rlineto exch 0 rlineto neg 0 exch rlineto closepath clip} bind def /EC /grestore load def /SH /show load def /MX {exch show 0.0 rmoveto} bind def /W {0 32 4 -1 roll widthshow} bind def /WX {0 32 5 -1 roll widthshow 0.0 rmoveto} bind def %%EndProlog %%Page: 0 1 BS 0 SI 15 /Times-Bold AF 23719 28325 MT (KERMIT USER GUIDE)SH 10 /Times-Italic AF 28527 31041 MT (Seventh Edition)SH /Times-Roman SF 26527 35825 MT (Christine Gianone, Editor)SH 20860 38217 MT (Columbia University Center for Computing Activities)SH 25862 39413 MT (New York, New York 10027)SH 28888 43001 MT (May 26, 1988)SH 26610 57353 MT (Copyright \050C\051 1981,1988)SH 20111 58549 MT (Trustees of Columbia University in the City of New York)SH /Times-Italic SF 18429 60941 MT (Permission is granted to any individual or institution to use, copy,)SH 18178 62137 MT (or redistribute this document so long as it is not sold for profit, and)SH 23291 63333 MT (provided this copyright notice is retained.)SH ES %%Page: 1 2 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (. PREFACE)SH 10 /Times-Italic AF 52275 XM (Page 1)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 27902 8272 MT (PREFACE)SH 10 /Times-Italic AF 8280 10566 MT (Kermit)SH /Times-Roman SF 11423 XM (is the name of a protocol for transferring files from) 115 W( one computer to another over ordinary asynchronous)114 W 8280 11762 MT (terminal connections. Kermit programs have been written) 116 W( for many different computers, and in general any two)117 W 8280 12958 MT (computers that have Kermit programs can exchange) 46 W( sequential files correctly and completely. This manual gives a)45 W 8280 14154 MT (brief and general overview of what Kermit is and how) 55 W( to use it, but consists mostly of detailed instructions for use)56 W 8280 15350 MT (and installation of specific Kermit programs.)SH 8280 17742 MT (For a more detailed introduction to Kermit, complete with illustrations, diagrams, and tutorials, consult the book)122 W /Times-Italic SF 8280 18938 MT (Kermit, A File) 25 W( Transfer Protocol)26 W /Times-Roman SF (, by Frank da Cruz, Digital Press, Bedford MA \0501987\051, ISBN 0-932376-88-6, DEC)26 W 8280 20134 MT (order number EY-6705E-DP \050phone 1-800-343-8321\051.) 23 W( The) 295 W( Kermit book describes Kermit in detail, from the points)22 W 8280 21330 MT (of view of the beginner, the user, the computer professional who must install Kermit programs or) 40 W( support their use,)41 W 8280 22526 MT (and the) 60 W( programmer who wishes to write new Kermit implementations. Also included are general introductions to)59 W 8280 23722 MT (computers, data communications, and file organization, plus a) 92 W( detailed troubleshooting guide, bootstrapping hints,)93 W 8280 24918 MT (and various appendices and tables. The latter half of the book is taken up by a complete description of the Kermit)57 W 8280 26114 MT (file transfer protocol, with programming examples) 8 W( in the C language, plus some analysis and comparisons of Kermit)9 W 8280 27310 MT (with other popular protocols such as Xmodem.)SH 8280 29702 MT (The seventh edition of the)42 W /Times-Italic SF 19183 XM (Kermit User Guide)42 W /Times-Roman SF 27225 XM (\050May 1988\051 includes chapters on new releases) 42 W( of most major Kermit)41 W 8280 30898 MT (programs, including MS-DOS Kermit 2.30, VAX/VMS) 168 W( Kermit 3.3, Portable IBM Mainframe Kermit 4.0, Unix)169 W 8280 32094 MT (Kermit 4E, Macintosh Kermit, CP/M-80 Kermit 4.09, plus a new chapter on PDP-11 Kermit.)SH 13 /Times-Bold AF 22832 35453 MT (History and Acknowledgements)SH 10 /Times-Roman AF 8280 37826 MT (The Kermit file transfer protocol was designed at the Columbia University Center) 268 W( for Computing Activities)267 W 8280 39022 MT (\050CUCCA\051 in 1981-82 by Bill) 246 W( Catchings and Frank da) 247 W( Cruz.) SH( Bill) 744 W( wrote the first two programs, one for the)247 W 8280 40218 MT (DECSYSTEM-20 and one for a CP/M-80 microcomputer.)SH 8280 42610 MT (The initial) 74 W( objective was to allow users of our DEC-20 and IBM 370 timesharing systems to archive their files on)73 W 8280 43806 MT (microcomputer floppy disks. The design owes much to the ANSI and ISO/OSI models, and some ideas were)183 W 8280 45002 MT (borrowed from similar projects at Stanford University and the University of Utah. The protocol was designed to)103 W 8280 46198 MT (accommodate the "sensitive" communications front end of the full-duplex DEC-20) 356 W( system as well as the)357 W 8280 47394 MT (peculiarities of half-duplex IBM) 260 W( mainframe linemode communications. The protocol was soon implemented)259 W 8280 48590 MT (successfully on our IBM mainframe systems under VM/CMS by Daphne Tzoar of CUCCA.)SH 8280 50982 MT (Meanwhile it was becoming apparent that Kermit was useful) 176 W( for more than just file archiving; IBM PCs were)177 W 8280 52178 MT (beginning to appear in the offices and) 99 W( departments, and there arose a general need for file transfer among all our)98 W 8280 53374 MT (systems, as well as a need to use the IBM PCs as terminals. Daphne soon had prepared an IBM PC implementation.)SH 8280 55766 MT (After our initial success with Kermit, we presented it at) 66 W( conferences of user groups like DECUS and SHARE, and)67 W 8280 56962 MT (began to get requests for it from other) 88 W( sites. Since we had written down a description of the protocol, some sites)87 W 8280 58158 MT (wrote their own implementations for new computers,) 107 W( or adapted one of our implementations to run on additional)108 W 8280 59354 MT (systems, and sent back these) 69 W( new versions to us so that we could share them with others. In this way, Kermit has)68 W 8280 60550 MT (grown to support nearly 300 different machines and operating systems; it has been sent on) 23 W( magnetic tape or diskette)24 W 8280 61746 MT (from Columbia University to nearly) 107 W( ten thousand sites all over the world, and has reached many thousands more)106 W 8280 62942 MT (through various user groups and networks.)SH 8280 65334 MT (Thanks to the hundreds of individuals and institutions who have contributed to the Kermit storehouse over the years.)SH 8280 67726 MT (The Kermit protocol was named after) 21 W( Kermit the Frog, star of the television series)22 W /Times-Italic SF 41716 XM (THE MUPPET SHOW)22 W /Times-Roman SF (; the name)22 W 8280 68922 MT (Kermit is used by permission of Henson Associates, Inc., New York.)SH ES %%Page: 2 3 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 2)SH 12 /Times-Bold AF 35588 XM (Kermit User Guide: PREFACE \050\051)SH 46800 50 6120 5709 UL 13 SS 26524 8071 MT (Disclaimer)SH 10 /Times-Roman AF 6120 10444 MT (Neither Columbia University, nor the editor, nor the authors of the individual chapters,) 212 W( nor any individual or)211 W 6120 11640 MT (institution contributing Kermit programs or documentation to the Columbia) 330 W( University Kermit Distribution,)331 W 6120 12836 MT (acknowledge any liability for any claims arising from use or misuse of) 70 W( Kermit programs or for inaccuracies in the)69 W 6120 14032 MT (documentation or bugs in the programs. Kermit programs are produced on a voluntary basis and contributed freely)41 W 6120 15228 MT (for public use in the hope that they will be useful, but) 263 W( without any kind of warranty or guarantee, or any)262 W 6120 16424 MT (commitment to address or fix problems. In practice, Kermit programs and documentation are) 78 W( contributed in good)79 W 6120 17620 MT (faith, and will be supported on a best-effort basis, time and other commitments permitting.)SH 13 /Times-Bold AF 22296 20979 MT (Customizing This Manual)SH 10 /Times-Roman AF 6120 23352 MT (Although the)34 W /Times-Italic SF 11688 XM (Kermit User Guide)34 W /Times-Roman SF 19706 XM (was produced at Columbia University, all attempts have been made to keep it free)34 W 6120 24548 MT (of site-specific information. However, due to the large number of Kermit implementations, descriptions of each) 14 W( one)15 W 6120 25744 MT (would make the manual) 360 W( prohibitively thick. Therefore, the manual is sent from Columbia with specific)359 W 6120 26940 MT (documentation about a) 78 W( selection of systems. Some of these descriptions may not be of interest at your site, while)79 W 6120 28136 MT (others that are may be lacking.)SH 6120 30528 MT (Each site, upon receiving a Kermit tape, may decide which versions of Kermit are) 75 W( important to it, and include the)74 W 6120 31724 MT (appropriate documentation in this manual. This is most conveniently done if your site has) 12 W( the Scribe text formatting)13 W 6120 32920 MT (system \050from UNILOGIC Ltd in Pittsburgh) 121 W( PA, USA\051, with which this manual was produced. Scribe runs on a)120 W 6120 34116 MT (wide variety) 52 W( of systems. There are also Scribe subsets, such as Perfect Writer and Final Word, that run on various)53 W 6120 35312 MT (microcomputers. Many) 380 W( have asked why Scribe is used) 65 W( for Kermit manuals instead of TeX. The answer is simply)64 W 6120 36508 MT (that TeX can only produce output for typesetters, not plain-text) 248 W( ASCII files, which are necessary for online)249 W 6120 37704 MT (documentation.)SH 6120 40096 MT (The system-specific parts of the Kermit User Guide are included with ")111 W /Courier SF (@INCLUDE)SH /Times-Roman SF (" statements at the end of) 111 W( the)110 W 6120 41292 MT (Scribe source file for) 43 W( this manual, whose filename is)44 W /Courier SF 27787 XM (KUSER.MSS)SH /Times-Roman SF (. You) 338 W( may add or delete)44 W /Courier SF 43604 XM (@INCLUDE)SH /Times-Roman SF 48698 XM (statements)SH 6120 42488 MT (to suit your needs, and run the result through the text formatter to produce a customized) 18 W( manual. If you do this, you)17 W 6120 43684 MT (should include an indication on the title page that the manual has been customized for your site.)SH 6120 46076 MT (Not all system-specific documentation is provided in)86 W /Courier SF 28137 XM (.MSS)SH /Times-Roman SF 30873 XM (\050Scribe input\051 format, since some Kermit contributors)87 W 6120 47272 MT (do not have Scribe at their sites. In that case, you will either have to add Scribe formatting commands, or else)131 W 6120 48468 MT (enclose the whole subfile in)1 W /Courier SF 17540 XM (@BEGIN\050VERBATIM\051...@END\050VERBATIM\051)SH /Times-Roman SF 37591 XM (brackets \050and) 1 W( replace all atsigns \050)2 W /Courier SF (@)SH /Times-Roman SF (\051 in)2 W 6120 49664 MT (the text with double atsigns \050)SH /Courier SF (@@)SH /Times-Roman SF (\051\051.)SH 6120 52056 MT (If you do not have SCRIBE, you) 35 W( may still use an editor to delete or add sections to the finished documentation file,)34 W 6120 53252 MT (though the results will not be as satisfactory) 39 W( -- the table of contents, index, cross references, and page numbers will)40 W 6120 54448 MT (not be automatically adjusted.)SH 6120 56840 MT (If you are running a version of Kermit for which adequate documentation has not been provided) 56 W( \050after all, this is a)55 W 6120 58036 MT (distributed, volunteer effort!\051, please feel free to write) 66 W( some, preferably in Scribe input format, and send it back to)67 W 6120 59232 MT (Columbia so that others may benefit) 116 W( from it. Likewise if you produce a new implementation of Kermit. If you)115 W 6120 60428 MT (don't know Scribe, you can use one of the existing chapters as a model.)SH ES %%Page: 3 4 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (. How To Get Kermit)SH 10 /Times-Italic AF 52275 XM (Page 3)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 8280 8272 MT (How To Get Kermit)SH 10 /Times-Roman AF 8280 10566 MT (The Kermit software is) 18 W( free and available to all, source code and documentation included, from a variety of sources.)19 W 8280 11762 MT (For example, most universities are connected to academic computer) 221 W( networks from which the Kermit files at)220 W 8280 12958 MT (Columbia University can be reached.) 6 W( The) 263 W( Kermit files are also available from many user groups, dialup information)7 W 8280 14154 MT (or bulletin board services, diskette reproduction services, and private volunteers.)SH 8280 16546 MT (Kermit software is not in the public) 13 W( domain. The Kermit manuals and most Kermit programs bear copyright notices)12 W 8280 17742 MT (to protect) 87 W( Columbia University and the various contributors from having their work taken by others and sold as a)88 W 8280 18938 MT (product, for profit. This is not to say that the Kermit file transfer protocol can) 73 W( never be included as a feature of a)72 W 8280 20134 MT (commercial product; the conditions under which this may be done are spelled) 297 W( out in a flyer)298 W /Times-Italic SF 49698 XM (POLICY ON)298 W 8280 21330 MT (COMMERCIAL USE AND DISTRIBUTION OF KERMIT)SH /Times-Roman SF (.)SH 8280 23722 MT (Columbia University distributes Kermit programs by mail order on) 214 W( various magnetic media \050primarily 9-track)213 W 8280 24918 MT (reel-to-reel tape and certain kinds of diskettes\051, charging a distribution fee to defray costs) 191 W( for media, printing,)192 W 8280 26114 MT (postage, materials, labor, and computing resources.) 93 W( This) 434 W( is not a software license fee; no license is required. To)92 W 8280 27310 MT (receive a current list of Kermit implementations, the statement) 142 W( on commercial policy, and a Kermit order form,)143 W 8280 28506 MT (write to:)SH 10280 30116 MT (Kermit Distribution)SH 10280 31221 MT (Columbia University Center for Computing Activities)SH 10280 32326 MT (612 West 115th Street)SH 10280 33431 MT (New York, NY 10025)SH 8280 35823 MT (Everyone is free to copy and redistribute Kermit programs and documentation, and) 36 W( is encouraged to do so, with the)35 W 8280 37019 MT (following stipulations: Kermit programs should not be sold for commercial gain;) 55 W( credit should be given where it is)56 W 8280 38215 MT (due; and new material should be sent back to Columbia University at the address above so that we can) 71 W( maintain a)70 W 8280 39411 MT (definitive and comprehensive set of Kermit implementations for further distribution.)SH 8280 41803 MT (Since new Kermit programs) 71 W( are added -- and old ones improved -- so frequently, sites that use Kermit heavily are)72 W 8280 42999 MT (encouraged to contact Columbia for updates two or three times a year for news.)SH 14430 48648 MT (-- PLEASE USE KERMIT ONLY FOR PEACEFUL AND HUMANE PURPOSES --)SH ES %%Page: 4 5 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 4)SH 12 /Times-Bold AF 26281 XM (Kermit User Guide: Organization of This Manual \050\051)SH 46800 50 6120 5709 UL ES %%Page: 5 6 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (. Organization of This Manual)SH 10 /Times-Italic AF 52275 XM (Page 5)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 8280 8272 MT (Organization of This Manual)SH 10 /Times-Roman AF 8280 10566 MT (Chapter 2,)46 W /Times-Italic SF 12788 XM (How to Use Kermit)46 W /Times-Roman SF (, describes the basics of text file transfer, and shows some specific examples. If) 46 W( you)45 W 8280 11762 MT (follow the examples but you can't make a terminal connection or you can't transfer) 184 W( files successfully, consult)185 W 8280 12958 MT (Chapter 3,)SH /Times-Italic SF 12696 XM (When Things Go Wrong)SH /Times-Roman SF (.)SH 8280 15350 MT (If you expect to be a heavy user of Kermit, you should read Section 4,)39 W /Times-Italic SF 37165 XM (Kermit Commands)39 W /Times-Roman SF (, which describes most) 39 W( of)38 W 8280 16546 MT (Kermit's features and commands.) 62 W( You) 375 W( may find that familiarity with the material in this section will help you get)63 W 8280 17742 MT (past difficulties that can crop up when) 98 W( you are making new kinds of connections or transferring unusual kinds of)97 W 8280 18938 MT (files. You) 379 W( will also find descriptions of some advanced file management features that have been omitted from the)65 W 8280 20134 MT (earlier sections.)SH 8280 22526 MT (The subsequent chapters describe selected popular Kermit programs in detail.) 158 W( You) 565 W( should read the appropriate)157 W 8280 23722 MT (section for each system you expect to) 140 W( use; each section describes the file naming conventions and other system)141 W 8280 24918 MT (features that) 55 W( are important to Kermit users, and lists the Kermit commands for that system mainly in terms of their)54 W 8280 26114 MT (differences from the "ideal" Kermit described in section 4.)SH ES %%Page: 6 7 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 6)SH 12 /Times-Bold AF 25681 XM (Kermit User Guide: Organization of This Manual \0501\051)SH 46800 50 6120 5709 UL ES %%Page: 7 8 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (1. Introduction)SH 10 /Times-Italic AF 52275 XM (Page 7)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 8280 8272 MT (1. Introduction)SH 10 /Times-Roman AF 8280 10566 MT (There is an ever-increasing need to move information from one computer to another. Information can be) 15 W( exchanged)16 W 8280 11762 MT (using magnetic media -- tapes or disks -- or over networks. Networks are expensive, and when your computer) 10 W( is not)9 W 8280 12958 MT (connected to) 142 W( one \050or to the right one\051, you must find other means to transfer information. In the early days of)143 W 8280 14154 MT (computing, magnetic media) 3 W( formats were relatively standardized, but with the arrival of microcomputers things have)2 W 8280 15350 MT (changed: most microcomputer users have no access) 194 W( to tapes, and disk formats are incompatible between most)195 W 8280 16546 MT (microcomputer makes and models. Even when disk) 115 W( formats agree, the disk must be physically moved from one)114 W 8280 17742 MT (system to the) 31 W( other in order for information to be exchanged -- the effort and delay can be significant if the systems)32 W 8280 18938 MT (are widely separated.)SH 8280 21330 MT (The telecommunication line provides a cheap and widely available alternative to networks and magnetic media.)151 W 8280 22526 MT (Asynchronous telecommunication is) 186 W( the method used by most terminals to connect to most computers. When)187 W 8280 23722 MT (dedicated "hardwired" connections, such as those) 28 W( found between a timesharing computer and its local terminals, are)27 W 8280 24918 MT (not available, computer users can create their own dialup connections with a telephone and a modem.)SH 8280 27310 MT (Most computers come) 128 W( equipped with asynchronous telecommunications interfaces, or "serial ports", which allow)129 W 8280 28506 MT (them to act as, or communicate with, terminals. The question is how to use the serial port to exchange) 182 W( data.)181 W 8280 29702 MT (Fortunately, the standards for connecting terminals to computers are almost universally followed: connector)301 W 8280 30898 MT (configuration \050DB-25 or DB-9\051, transmission signals \050EIA RS-232\051, a) 214 W( commonly accepted set of transmission)213 W 8280 32094 MT (speeds \050baud rates\051, and a convention for encoding characters in storage and) 92 W( during transmission \050ASCII\051. These)93 W 8280 33290 MT (standards provide the physical medium and the data format, but they do not specify a process for exchanging data.)SH 14 /Times-Bold AF 8280 36892 MT (1.1. Why Kermit?)SH 10 /Times-Roman AF 8280 39010 MT (When data is) 77 W( transmitted from one computer to another; the receiving computer has to be instructed to take in the)76 W 8280 40206 MT (data and put it somewhere, and it also needs a way of ensuring that the data has been) 189 W( received correctly and)190 W 8280 41402 MT (completely in spite of several factors that will tend to interfere with this process:)SH 10280 43193 MT (1.)SH /Times-Italic SF 11280 XM (Noise)SH /Times-Roman SF 13877 XM (-- It) 388 W( is rarely safe to assume that there will be no electrical interference on a line; any long) 69 W( or)68 W 11280 44298 MT (switched data communication line will have occasional) 76 W( interference, or noise, which typically results)77 W 11280 45403 MT (in garbled or extra characters.) 76 W( Noise) 401 W( corrupts data, perhaps in subtle ways that might not be noticed)75 W 11280 46508 MT (until it's too late.)SH 10280 48718 MT (2.)SH /Times-Italic SF 11280 XM (Synchronization)SH /Times-Roman SF 18102 XM (-- Data must not come in faster than the receiving machine can handle it. Although)73 W 11280 49823 MT (line speeds at the two ends of the connection must match before communication can) 101 W( take place, the)100 W 11280 50928 MT (receiving machine might not be able to process a steady stream of input at that) 148 W( speed. Its central)149 W 11280 52033 MT (processor may be too slow or too heavily loaded, its buffers) 42 W( too full or too small, or its disk too slow.)41 W 11280 53138 MT (The typical symptom of a) 147 W( timing problem is lost data; most operating systems will simply discard)148 W 11280 54243 MT (incoming data they are not prepared to receive.)SH 8280 56034 MT (To prevent) 25 W( corruption of data and to synchronize communication, cooperating computers can send special messages)24 W 8280 57230 MT (to one another along with the data.) 5 W( Intermingling) 261 W( of control information with data together requires a set of rules for)6 W 8280 58426 MT (distinguishing messages from data, and specifying what the) 184 W( messages are and the actions associated with each)183 W 8280 59622 MT (message. Such) 250 W( a set of rules is called a)SH /Times-Italic SF 24249 XM (protocol)SH /Times-Roman SF (.)SH 8280 62014 MT (Kermit is a file transfer) 305 W( protocol. It is specifically designed for transfer of sequential files over ordinary)306 W 8280 63210 MT (telecommunication lines. Kermit is not necessarily better) 11 W( than other terminal-oriented file transfer protocols but it is)10 W 8280 64406 MT (free, it is well documented, and it has been implemented compatibly on a wide variety) 124 W( of microcomputers, PCs,)125 W 8280 65602 MT (workstations, minicomputers, mainframes, and supercomputers.)SH ES %%Page: 8 9 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 8)SH 12 /Times-Bold AF 33217 XM (Kermit User Guide: Introduction \0501.2\051)SH 46800 50 6120 5709 UL 14 SS 6120 8138 MT (1.2. How Kermit Works)SH 10 /Times-Roman AF 6120 10256 MT (Kermit transfers data by encapsulating it in)320 W /Times-Italic SF 26454 XM (packets)SH /Times-Roman SF 30022 XM (of control information. This information includes a)319 W 6120 11452 MT (synchronization marker, a packet sequence number to allow detection of lost) 170 W( packets, a length indicator, and a)171 W 6120 12648 MT ("block check" to allow verification of) 66 W( the data, as shown in Figure 1-1. The MARK \050usually an ASCII Control-A)65 W 46800 50 6120 14639 UL /Courier SF 8520 16094 MT (+------+------+------+------+--------- - - - -+-------+)SH 8520 17125 MT (| MARK | LEN | SEQ | TYPE | DATA) SH( |) 6600 W( CHECK |)SH 8520 18156 MT (+------+------+------+------+--------- - - - -+-------+)SH /Times-Bold SF 23535 19873 MT (Figure 1-1:)SH /Times-Roman SF 28784 XM (A Kermit Packet)SH 46800 50 6120 21683 UL 6120 23274 MT (character\051 appears at the beginning of the) 64 W( packet. The next character is a length field \050LEN\051, specifying how long)65 W 6120 24470 MT (the rest of the packet is. The sequence number \050SEQ\051 is used to detect lost) 42 W( or duplicated packets; retransmission is)41 W 6120 25666 MT (requested for lost packets and duplicate packets are discarded. The TYPE field specifies whether) 219 W( the packet)220 W 6120 26862 MT (contains data or control information. The CHECK field) 123 W( contains a quantity obtained by combining all the other)122 W 6120 28058 MT (characters in the packet together in one of several ways; the sender computes this) 86 W( value and sends it. The packet)87 W 6120 29254 MT (receiver also) 79 W( computes the value and checks it against the value sent; if they agree, the packet is accepted; if they)78 W 6120 30450 MT (disagree, then the packet has been corrupted and retransmission is) 100 W( requested. The DATA field contains up to 90)101 W 6120 31646 MT (characters of data. All fields except the mark are encoded as printable ASCII characters, to) 24 W( prevent host or network)23 W 6120 32842 MT (interference. Figure) 290 W( 1-2 shows how) 20 W( a typical file transfer proceeds. Figure 1-2 does not show how Kermit recovers)21 W 6120 34038 MT (from errors. Very briefly, here's how it works:)SH /Symbol SF 7910 35943 MT (\267)SH /Times-Roman SF 8620 XM (If a packet is corrupted in transit by noise or loss of characters, the block check will be wrong. A file)61 W 8620 37048 MT (receiver will NAK \050"negatively acknowledge"\051 a corrupted) 344 W( packet, which causes the sender to)345 W 8620 38153 MT (retransmit the same packet \050or, alternatively, it will ACK the) 84 W( last correctly received packet again\051. A)83 W 8620 39258 MT (file sender only receives ACKs and NAKs from the receiver; a) 111 W( corrupted ACK, or a NAK, from the)112 W 8620 40363 MT (receiver causes the sender to retransmit its most recent packet.)SH /Symbol SF 7910 42352 MT (\267)SH /Times-Roman SF 8620 XM (If the file sender does not receive an ACK within the prescribed timeout interval, it retransmits the same)5 W 8620 43457 MT (packet. If) 420 W( the file receiver does not receive an expected packet within the timeout interval, it) 85 W( sends a)86 W 8620 44562 MT (NAK for the expected packet \050or another ACK for the most recently correct packet\051.)SH 6120 46353 MT (Many encoding, compression, block check, timeout, and packet length options are provided.) 154 W( These) 557 W( options are)153 W 6120 47549 MT (automatically negotiated by the two Kermit programs when they initially) 10 W( make contact, and the greatest common set)11 W 6120 48745 MT (of features is used.) 17 W( For) 282 W( this reason, any two Kermit programs should be able to communicate successfully, from the)16 W 6120 49941 MT (oldest, most bare-bones version, to the newest, most feature-laden version. The protocol is described in detail in) 17 W( the)18 W 6120 51137 MT (Kermit book.)SH ES %%Page: 9 10 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (2. How to Use Kermit)SH 10 /Times-Italic AF 52275 XM (Page 9)SH 46800 50 8280 5709 UL 46800 50 8280 8086 UL /Courier SF 9480 9541 MT (Sender Receiver)9600 W 3600 50 9480 9741 UL 4800 50 23280 9741 UL 9480 11603 MT (Send-Init ------------->)SH /Times-Italic SF 29280 XM (Sender and Receiver exchange greetings)SH /Courier SF 12480 12634 MT (<-------------------- ACK)SH 9480 14696 MT (File-Header ----------->)SH /Times-Italic SF 29280 XM (Sender sends first file name to Receiver)SH /Courier SF 12480 15727 MT (<-------------------- ACK)SH /Times-Italic SF 29280 XM (Receiver acknowledges)SH /Courier SF 9480 17789 MT (File-Data ------------->)SH /Times-Italic SF 29280 XM (Sender sends first file data packet)SH /Courier SF 12480 18820 MT (<-------------------- ACK)SH 9480 20882 MT (File-Data ------------->)SH /Times-Italic SF 29280 XM (Sender sends second file data packet)SH /Courier SF 12480 21913 MT (<-------------------- ACK)SH 9480 23975 MT (File-Data --xx~~~p'''-->)SH /Times-Italic SF 29280 XM (Third data packet is corrupted by noise)SH /Courier SF 12480 25006 MT (<-------------------- NAK)SH /Times-Italic SF 29530 XM (and Receiver negatively acknowledges it)SH /Courier SF 9480 27068 MT (File-Data ------------->)SH /Times-Italic SF 29280 XM (Sender retransmits third packet)SH /Courier SF 12480 28099 MT (<-------------------- ACK)SH /Times-Italic SF 9480 30161 MT (File-Data packets are sent and acknowledged until the whole file is sent)SH /Courier SF 9480 32223 MT (End-Of-File ----------->)SH /Times-Italic SF 29280 XM (Sender indicates first file is complete)SH /Courier SF 12480 33254 MT (<-------------------- ACK)SH 9480 35316 MT (File-Header ----------->)SH /Times-Italic SF 29280 XM (Name second of file)SH /Courier SF 12480 36347 MT (<-------------------- ACK)SH 9480 38409 MT (File-Data ------------->)SH /Times-Italic SF 29280 XM (First data packet for second file)SH /Courier SF 12480 39440 MT (<-------------------- ACK)SH /Times-Italic SF 9480 41502 MT (File-Data packets are sent and ack'd until the whole file is sent)SH /Courier SF 9480 43564 MT (End-Of-File ----------->)SH /Times-Italic SF 29280 XM (Sender indicates second file is complete)SH /Courier SF 12480 44595 MT (<-------------------- ACK)SH 9480 46657 MT (End-Of-Transaction ---->)SH /Times-Italic SF 29280 XM (Sender indicates no more files to come)SH /Courier SF 12480 47688 MT (<------------------- ACK)600 W /Times-Bold SF 24917 49405 MT (Figure 1-2:)SH /Times-Roman SF 30166 XM (Kermit File Transfer)SH 46800 50 8280 51215 UL ES %%Page: 10 11 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 10)SH 12 /Times-Bold AF 34117 XM (Kermit User Guide: Introduction \0502\051)SH 46800 50 6120 5709 UL ES %%Page: 11 12 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (2. How to Use Kermit)SH 10 /Times-Italic AF 51775 XM (Page 11)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 8280 8272 MT (2. How to Use Kermit)SH 10 /Times-Roman AF 8280 10566 MT (Kermit embodies a) 45 W( set of rules for transferring files reliably between two computers. In general, one computer is a)44 W 8280 11762 MT (large system \050a)63 W /Times-Italic SF 14773 XM (host)SH /Times-Roman SF (, for instance a timesharing system with many terminals\051, and) 63 W( the other is a personal computer)64 W 8280 12958 MT (\050PC\051. The) 442 W( host believes that the PC is an ordinary terminal. In order for the Kermit protocol to occur, a Kermit)96 W /Times-Italic SF 8280 14154 MT (program)SH /Times-Roman SF 12030 XM (must be running on each end of the communication line -- one on the host, one on the PC.)SH 8280 16546 MT (Your task is just to get) 155 W( the two Kermits started. You have to use a single keyboard and screen to talk to two)156 W 8280 17742 MT (different computers, two different programs. Let's talk about a common case: you are sitting at a personal computer)11 W 8280 18938 MT (\050PC\051, which has a serial communication port. The serial port is connected) 76 W( to a host computer using, say, a dialup)77 W 8280 20134 MT (modem.)SH 8280 22526 MT (Normally, when you use your PC, you are "talking") 108 W( directly to it; your commands are interpreted directly by the)107 W 8280 23722 MT (PC's operating system \050CP/M, MS-DOS, UNIX, etc\051, or by some program that runs on) 118 W( the PC \050an editor, a text)119 W 8280 24918 MT (formatter, space invaders...\051. The version of Kermit on your PC is a) 109 W( program like any other, but it has a special)108 W 8280 26114 MT (ability to) 16 W( either interpret your commands directly, like other programs, or to pass everything you type through to the)17 W 8280 27310 MT (other, remote) 42 W( computer. When you tell Kermit to CONNECT, it sends every character you type out the serial port,)41 W 8280 28506 MT (and it puts every character that comes in the serial port onto) 60 W( the screen. This is called "terminal emulation" -- one)61 W 8280 29702 MT (computer acts as if it) 91 W( were a terminal to the other. You are now "talking" to the remote computer, and the PC is)90 W 8280 30898 MT (\050mostly\051 ignoring you.)SH 8280 33290 MT (Kermit, like most interactive programs, has a)4 W /Times-Italic SF 26611 XM (prompt)SH /Times-Roman SF (. The) 258 W( prompt is a string of characters it types on the left margin)4 W 8280 34486 MT (to indicate that it is ready for you to type) 160 W( a command. Kermit's prompt is normally ")159 W /Courier SF (Kermit-)SH /Times-Italic SF (xx)SH /Courier SF (>)SH /Times-Roman SF (". The)568 W /Times-Italic SF 54192 XM (xx)SH /Times-Roman SF 8280 35682 MT (identifies the implementation of Kermit; the Kermit that runs on MS-DOS systems) 96 W( is called "Kermit-MS" and its)97 W 8280 36878 MT (prompt is ")32 W /Courier SF (Kermit-MS>)SH /Times-Roman SF ("; the Kermit that runs on Z80 and 8080-based microcomputers is called) 32 W( "Kermit-80" and)31 W 8280 38074 MT (its prompt is) 95 W( ")96 W /Courier SF (Kermit-80>)SH /Times-Roman SF (", and so forth. If you become confused about which Kermit you are talking to, the)96 W 8280 39270 MT (prompt should provide a clue. In addition, most Kermits print an informative message like)SH /Courier SF 10680 40925 MT ([Connecting to remote host, type CTRL-]C to return])SH /Times-Roman SF 8280 42642 MT (when you CONNECT, and type another message like)SH /Courier SF 10680 44297 MT ([Connection closed, back at PC])SH /Times-Roman SF 8280 46014 MT (when you return.)SH 8280 48406 MT (Having "connected" to the) 70 W( host, there must be a way for you to "get back" to the PC. This is accomplished by an)69 W /Times-Italic SF 8280 49602 MT (escape sequence)84 W /Times-Roman SF (. As) 419 W( Kermit passes your characters through to the host, it checks each one to see if it's a special)85 W 8280 50798 MT (predefined)SH /Times-Italic SF 12834 XM (escape character)28 W /Times-Roman SF (. When) 306 W( the PC sees this) 28 W( character, it stops ignoring you -- you are once again "talking")27 W 8280 51994 MT (to the) 65 W( PC, not to the host. The escape character is normally chosen to be one that you will not need to type while)66 W 8280 53190 MT (talking to the host, and one that is hard) 95 W( to type by accident -- it's usually a)94 W /Times-Italic SF 39772 XM (control character)94 W /Times-Roman SF (, such as Control-)94 W /Courier SF (])SH /Times-Roman SF (,)SH 8280 54386 MT (which is entered by holding down the key marked CTRL or CONTROL and typing the) 60 W( indicated character \050in this)61 W 8280 55582 MT (case, a right bracket ")104 W /Courier SF (])SH /Times-Roman SF ("\051. The) 458 W( CTRL key) 104 W( works just like a SHIFT key. Control characters are written either as)103 W 8280 56778 MT (Ctrl-A or)SH /Courier SF 12224 XM (^A)SH /Times-Roman SF (, where A is the character to be typed while holding down the Ctrl key.)SH 14 /Times-Bold AF 8280 60380 MT (2.1. Transferring a File)SH 10 /Times-Roman AF 8280 62498 MT (From system command) 42 W( level on your PC, first run the Kermit program. Then tell Kermit to CONNECT you to the)43 W 8280 63694 MT (host. Now) 250 W( you're talking to the remote host -- at this point you must log in, and then run Kermit on the host.)SH 8280 66086 MT (Now you have a Kermit program on each end of) 78 W( the connection. The next step is to tell)77 W /Times-Italic SF 45079 XM (each)SH /Times-Roman SF 47294 XM (Kermit what to do.)77 W 8280 67282 MT (Suppose you want to) 63 W( transfer a file from the host to the PC; you would first tell the host Kermit to SEND the file,)64 W 8280 68478 MT (then "escape" back to the PC Kermit and tell it to RECEIVE the file. The transfer begins -- you can sit) 77 W( back and)76 W 8280 69674 MT (watch, or go make yourself a sandwich. The PC Kermit will produce a running display on your screen as) 157 W( the)158 W 8280 70870 MT (transfer proceeds, and will notify you when it is complete.)SH ES %%Page: 12 13 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 12)SH 12 /Times-Bold AF 29852 XM (Kermit User Guide: How to Use Kermit \0502.1\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (The desired file should now be on your PC's disk. The) 70 W( Kermit protocol has ensured that the file arrived correctly)69 W 6120 9082 MT (and completely. Now you must clean up) 41 W( after yourself: CONNECT back to the host, exit from Kermit on the host,)42 W 6120 10278 MT (log out from the host, "escape") 33 W( back to PC Kermit and exit from it. Now you can do whatever you had planned for)32 W 6120 11474 MT (your file -- edit it, print it on your PC printer, etc. Transferring a file in the other direction works the same way,) 22 W( but)23 W 6120 12670 MT (with the SEND and RECEIVE commands exchanged.)SH 6120 15062 MT (The Kermit protocol, and most Kermit programs, allow you to send text files reliably from the host to the PC, from)36 W 6120 16258 MT (the PC to the host, from host to host, or PC to PC, usually without any special regard) 25 W( for the nature of the particular)26 W 6120 17454 MT (machines involved. Most implementations also allow files to be sent in groups, with a single) 108 W( command, such as)107 W 6120 18650 MT (")SH /Courier SF (send *.*)58 W /Times-Roman SF (" The scenario for each of these is the same as above -- only the details of how to establish the actual)58 W 6120 19846 MT (connection differ.)SH 6120 22238 MT (Kermit works best with "printable" files -- files composed only of letters, digits, punctuation) 10 W( marks, carriage returns,)9 W 6120 23434 MT (tabs, and so forth -- since these can be represented on almost any kind) 49 W( of computer. Kermit is also able to transfer)50 W 6120 24630 MT ("binary" files -- files such as executable programs -- composed of) 14 W( arbitrary bit patterns, but binary files normally are)13 W 6120 25826 MT (meaningful only to the kind of computer on which they are generated.) 26 W( Nevertheless,) 304 W( Kermit can usually move such)27 W 6120 27022 MT (files from system A to system) 92 W( B \050where they are not much use\051 and back to system A in their original condition,)91 W 6120 28218 MT (although in most cases special measures must be taken to accomplish this.)SH 6120 30610 MT (Let's look at some more concrete examples. First you need to know what the basic Kermit commands are.)SH 14 /Times-Bold AF 6120 34212 MT (2.2. Basic Kermit Commands)SH 10 /Times-Roman AF 6120 36330 MT (These are generic descriptions of the most basic Kermit) 32 W( commands. Detailed descriptions will come later. In these)33 W 6120 37526 MT (descriptions,)SH /Times-Italic SF 11582 XM (local)SH /Times-Roman SF 13961 XM (refers to the system that you are using directly,)129 W /Times-Italic SF 34119 XM (remote)SH /Times-Roman SF 37275 XM (refers to the) 129 W( system to which you are)128 W 6120 38722 MT (CONNECTed via Kermit. Commands may take) 93 W( one or more operands on the same line, and are terminated by a)94 W 6120 39918 MT (carriage return.)SH 6120 41709 MT (SEND)SH /Times-Italic SF 8981 XM (filespec)SH /Times-Roman SF 8120 42814 MT (Send the file or file group specified by)45 W /Times-Italic SF 24144 XM (filespec)SH /Times-Roman SF 27494 XM (from this) 45 W( Kermit to the other. The name of each file is passed)46 W 8120 43919 MT (to the other Kermit in a special control packet, so it can be stored there with the same name. A file group) 75 W( is)74 W 8120 45024 MT (usually specified by including "wildcard" characters like ")SH /Courier SF (*)SH /Times-Roman SF (" in the file specification. Examples:)SH /Courier SF 10520 46679 MT (send foo.txt)SH 10520 47710 MT (send *.for)SH /Times-Roman SF 8120 49427 MT (Some implementations of Kermit may not) 203 W( support transfer of file groups; these versions would require a)204 W 8120 50532 MT (separate SEND command for each file to be transferred.)SH 6120 52109 MT (RECEIVE)SH 8120 53214 MT (Receive a file or file group from the other Kermit. If) 153 W( an incoming file name is not legal, then attempt to)154 W 8120 54319 MT (transform it to a similar legal name. Options are be provided for handling filename collisions.)SH 6120 55896 MT (CONNECT)SH 8120 57001 MT (Make a terminal connection to the) 96 W( remote system. To "escape" from the terminal connection, type Kermit's)97 W /Times-Italic SF 8120 58106 MT (escape character)SH /Times-Roman SF 15229 XM (\050e.g.)SH /Courier SF 17256 XM (CTRL-])SH /Times-Roman SF (, control-rightbracket\051, followed by the letter "C" for "Close Connection".)SH 6120 59683 MT (SET)SH 8120 XM (Establish various nonstandard settings, such as CONNECT escape character,) 89 W( file characteristics, communica-)88 W 8120 60788 MT (tion line number, speed \050baud rate\051, parity, or flow control. All of these are explained later.)SH 6120 62365 MT (SHOW)SH 8120 63470 MT (\050or STATUS\051 Display the values of SET options.)SH 6120 65047 MT (HELP)SH 8120 66152 MT (Type a summary of Kermit commands and what they do.)SH 6120 67729 MT (EXIT)SH 8120 68834 MT (Exit from Kermit back to the host operating system.)SH /Courier SF 6120 70411 MT (?)SH /Times-Roman SF 8120 XM (Typed almost anywhere within a Kermit command: List the commands, options, or operands that) 40 W( are possible)39 W 8120 71516 MT (at this point. This command may or may not require a carriage return, depending on the host operating system.)SH ES %%Page: 13 14 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (2.3. Real Examples)SH 10 /Times-Italic AF 51775 XM (Page 13)SH 46800 50 8280 5709 UL 14 /Times-Bold AF 8280 8138 MT (2.3. Real Examples)SH 10 /Times-Roman AF 8280 10256 MT (Kermit can be used in several ways: from a PC that is) 79 W( connected to a larger host computer; from a host computer)80 W 8280 11452 MT (which is connected to another host; from one PC to another.)SH 12 /Times-Bold AF 8280 14568 MT (2.3.1. PC to Host)SH 10 /Times-Roman AF 8280 16510 MT (In this example, the user is sitting at an IBM Personal) 11 W( Computer \050PC\051, which is connected through its serial port to a)10 W 8280 17706 MT (DEC VAX/VMS host computer. The IBM PC is)80 W /Times-Italic SF 28889 XM (local)SH /Times-Roman SF (, the VAX is)80 W /Times-Italic SF 36514 XM (remote)SH /Times-Roman SF (. This) 412 W( example will also apply almost)81 W 8280 18902 MT (literally to any other microcomputer implementation of Kermit.)SH 8280 21294 MT (You have started up your PC and have the Kermit program on your) 27 W( disk. Begin by running Kermit on the PC. Use)26 W 8280 22490 MT (Kermit's CONNECT command to become a terminal to the VAX. In) 174 W( fact, the PC emulates the popular DEC)175 W 8280 23686 MT (VT-102 \050VT-100\051, so so it is desirable to tell the host that your terminal is of this type. Login) 36 W( on the VAX and run)35 W 8280 24882 MT (Kermit there. Here is an) 71 W( example of this procedure with commands you type underlined; the material lined up on)72 W 8280 26078 MT (the right is commentary, not system typeout or part of a command:)SH /Courier SF 10680 27793 MT (A>Kermit)SH /Times-Italic SF 24680 XM (Run Kermit on the PC.)SH 3600 50 11880 27993 UL /Courier SF 10680 28824 MT (Kermit-MS V2.30)SH 10680 29855 MT (IBM-PC Kermit-MS: V2.30 8 Jan 88)SH 10680 30886 MT (Type ? for help)SH 10680 32601 MT (Kermit-MS>)SH /Times-Italic SF 24680 XM (This is the Kermit prompt for the PC.)SH /Courier SF 10680 33632 MT (Kermit-MS>connect)SH /Times-Italic SF 24680 XM (Connect to the VAX.)SH 4200 50 16680 33832 UL /Courier SF 10680 34663 MT ([Connecting to host, type Control-] to return to PC])SH /Times-Italic SF 24680 36378 MT (You are now connected to the VAX.)SH /Courier SF 10680 38033 MT (Welcome to CUMIN, MicroVMS V4.6) SH( i\050The) 1800 W( system prints its herald.\051)SH 10680 39748 MT (Username: my-id)SH /Times-Italic SF 24680 XM (Type your user ID.)SH 3000 50 16680 39948 UL /Courier SF 10680 40779 MT (Password: my-password)SH /Times-Italic SF 24680 XM (Type your password.)SH 6600 50 16680 40979 UL 10680 42494 MT (\050Various greeting or notice messages are displayed.\051)SH /Courier SF 10680 44209 MT ($)SH /Times-Italic SF 24680 XM (This is the VMS system prompt.)SH /Courier SF 10680 45240 MT ($ Kermit)SH /Times-Italic SF 24680 XM (Run Kermit on the VAX.)SH 3600 50 11880 45440 UL /Courier SF 10680 46895 MT (VMS Kermit-32 version 3.3.111)SH 10680 47926 MT (Default terminal for transfers is: _TXA0:)SH 10680 48957 MT (Kermit-32>)SH /Times-Italic SF 24680 XM (This is VMS Kermit's prompt.)SH /Times-Roman SF 8280 50674 MT (You are now ready to transfer files between the two machines.)SH 8280 53066 MT (The following example) 122 W( illustrates how to send files from the VAX to the PC. Note the use of the "*")121 W /Times-Italic SF 51524 XM (wildcard)SH /Times-Roman SF 8280 54262 MT (character to denote a)SH /Times-Italic SF 16832 XM (file group)SH /Times-Roman SF (.)SH /Courier SF 10680 55977 MT (Kermit-32>send *.for)SH /Times-Italic SF 24680 XM (Send all my FORTRAN files.)SH 6000 50 16680 56177 UL /Courier SF 10680 57008 MT (^]c)SH /Times-Italic SF 24680 XM (Now return back to the PC by)SH 1800 50 10680 57208 UL 24680 58039 MT (typing the escape sequence, in this case)SH /Courier SF 24680 59070 MT (^]C)SH /Times-Italic SF 27080 XM (\050Control-)SH /Courier SF (])SH /Times-Italic SF 31708 XM (followed by "C")SH /Courier SF (\051)SH 10680 60101 MT ([Back at PC.])SH 10680 61132 MT (Kermit-MS>receive)SH /Times-Italic SF 24680 XM (Tell the PC that files are coming.)SH 4200 50 16680 61332 UL /Times-Roman SF 8280 63524 MT (If you take more than about 5 seconds to get) 33 W( back to Kermit-MS and issue the)34 W 8 SS 40539 XM (RECEIVE)SH 10 SS 44202 XM (command, the first packets)34 W 8280 64720 MT (from Kermit-32 may) 100 W( arrive prematurely and appear on your screen, but no harm will be done because the packet)99 W 8280 65916 MT (will be retransmitted by the VAX until the PC acknowledges it.)SH 8280 68308 MT (Once the connection) 19 W( is established, the PC will show you what is happening -- it first clears the screen and waits for)20 W 8280 69504 MT (incoming packets; as packets arrive, the current file name and packet number will be continuously displayed on the)41 W 8280 70700 MT (screen. When) 328 W( the PC's)39 W /Courier SF 18084 XM ("Kermit-MS>")SH /Times-Roman SF 25573 XM (prompt returns to your screen \050with an accompanying beep to catch) 39 W( your)40 W 8280 71896 MT (attention\051 the) 88 W( transfer is done. Notice the screen display; the status should be indicated as "complete". If not, an)87 W ES %%Page: 14 15 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 14)SH 12 /Times-Bold AF 28952 XM (Kermit User Guide: How to Use Kermit \0502.3.1\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (error has occurred and an appropriate message should be displayed to tell you why.)SH 6120 10278 MT (After you're finished transferring files,) 173 W( you must CONNECT back to the VAX host, EXIT from Kermit there,)174 W 6120 11474 MT (logout, and "escape back" to the PC as you did previously:)SH /Courier SF 8520 13189 MT (Kermit-MS>connect)SH /Times-Italic SF 22520 XM (Get back to the VAX.)SH 4200 50 14520 13389 UL /Courier SF 8520 14220 MT ([Connecting to host. Type CTRL-]C to return to PC.])SH 8520 15251 MT (Kermit-32>)SH /Times-Italic SF 22520 XM (Here we are.)SH /Courier SF 8520 16282 MT (Kermit-32>exit)SH /Times-Italic SF 22520 XM (Get out of VMS Kermit.)SH 2400 50 14520 16482 UL /Courier SF 8520 17313 MT ($ logout)SH /Times-Italic SF 22520 XM (Logout from the VAX.)SH 3600 50 9720 17513 UL /Courier SF 8520 18968 MT (MY-ID logged) 1200 W( out at 25-JAN-1988 15:12:27.85)SH 8520 20683 MT (^]c)SH /Times-Italic SF 22520 XM (Now "escape" back to the PC,)SH 1800 50 8520 20883 UL /Courier SF 8520 21714 MT ([Back at PC.])SH 8520 22745 MT (Kermit-MS>exit)SH /Times-Italic SF 22520 XM (and exit from the PC's Kermit.)SH 2400 50 14520 22945 UL /Courier SF 8520 23776 MT (A>)SH /Times-Italic SF 22520 XM (Now you see the DOS prompt again.)SH /Times-Roman SF 6120 25493 MT (The files you transferred should now be on your PC disk.)SH 6120 27885 MT (To send files from the PC to the VAX, follow a) 124 W( similar procedure. First follow the instructions in the previous)123 W 6120 29081 MT (section to log in to the VAX through the PC. Then in response to the host Kermit's ")70 W /Courier SF (Kermit-32>)SH /Times-Roman SF (" prompt you)71 W 6120 30277 MT (type RECEIVE) 330 W( rather than SEND. Now escape back to the PC and use the SEND command to send) 40 W( the local PC)39 W 6120 31473 MT (files to VAX. The PC will show you the progress of the transmission on its screen.)SH 6120 33865 MT (When the ")165 W /Courier SF (Kermit-MS>)SH /Times-Roman SF (" prompt) 165 W( indicates that the transmission is complete you should follow the procedure)166 W 6120 35061 MT (shown above to logout) 26 W( from the VAX host, except that you may first wish to confirm that the files have been stored)25 W 6120 36257 MT (correctly in your directory on the VAX.)SH 12 /Times-Bold AF 6120 39373 MT (2.3.2. Host to Host)SH 10 /Times-Roman AF 6120 41315 MT (A "host" is considered to be a large or multi-user system, whose) 56 W( distinguishing characteristic is that it has multiple)57 W 6120 42511 MT (terminals. Use) 266 W( of Kermit for host-to-host file) 8 W( transfers differs from the PC-to-host case in that the line your terminal)7 W 6120 43707 MT (is connected to) 146 W( is not the same as the line over which the data is being transferred, and that some special SET)147 W 6120 44903 MT (commands may have to be issued to allow one Kermit to conform to unusual requirements of the other host.)SH 6120 47295 MT (In this example, you are already logged in to a Unix system, and you use an)57 W /Times-Italic SF 37583 XM (autodialer)SH /Times-Roman SF 42057 XM (to connect) 57 W( to an IBM 370-)56 W 6120 48491 MT (series system running VM/CMS through Unix device)SH /Courier SF 27758 XM (/dev/tty12)SH /Times-Roman SF (.)SH /Courier SF 8520 50146 MT (% kermit)SH 3600 50 9720 50346 UL 8520 51177 MT (C-Kermit, 4E\050070\051 24 Jan 88, 4.2 BSD)SH 8520 52208 MT (Type ? for help)SH 8520 53239 MT (C-Kermit>set modem hayes)SH 9000 50 13920 53439 UL 8520 54270 MT (C-Kermit>set line /dev/tty12)SH 11400 50 13920 54470 UL 8520 55301 MT (C-Kermit>set speed 1200)SH 8400 50 13920 55501 UL 8520 56332 MT (C-Kermit>dial 7654321)SH 7200 50 13920 56532 UL 8520 57363 MT (Connected!)SH /Times-Roman SF 6120 59080 MT (Other methods exist for) 84 W( connecting two hosts with a serial line. For instance, dedicated hookups can be made by)85 W 6120 60276 MT (running an RS-232) 5 W( "null modem" cable between TTY ports on the two systems \050null modem cables, RS-232 signals,)4 W 6120 61472 MT (modems, and other data communication apparati are described in) 227 W( detail in the Kermit book\051. The following)228 W 6120 62668 MT (procedure would be the same in any case, once a connection is made.) 3 W( The) 254 W( four "set" commands below are necessary)2 W 6120 63864 MT (when connecting to IBM mainframes in "linemode" \050as) 105 W( opposed to full-screen 3270 mode; if you don't use IBM)106 W 6120 65060 MT (mainframes, you can ignore them for now\051.)SH /Courier SF 8520 66775 MT (C-Kermit>set duplex half)SH /Times-Italic SF 30120 XM (The IBM mainframe is half duplex.)SH 9000 50 13920 66975 UL /Courier SF 8520 67806 MT (C-Kermit>set flow none)SH /Times-Italic SF 30120 XM (No full duplex XON/XOFF.)SH 7800 50 13920 68006 UL /Courier SF 8520 68837 MT (C-Kermit>set handshake xon)SH /Times-Italic SF 30120 XM (Use XON for line turnaround handshake.)SH 10200 50 13920 69037 UL /Courier SF 8520 69868 MT (C-Kermit>set parity mark)SH /Times-Italic SF 30120 XM (Our IBM system uses mark parity.)SH 9000 50 13920 70068 UL /Courier SF 8520 70899 MT (C-Kermit>connect)SH /Times-Italic SF 30120 XM (Connect to the mainframe.)SH 4200 50 13920 71099 UL /Courier SF 8520 71930 MT (Connecting thru /dev/tty31, speed 1200.)SH ES %%Page: 15 16 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (2.3.2. Host to Host)SH 10 /Times-Italic AF 51775 XM (Page 15)SH 46800 50 8280 5709 UL /Courier SF 10680 7824 MT (The escape character is CTRL-\134 \05028\051.)SH 10680 8855 MT (Type the escape character followed by C to get back,)SH 10680 9886 MT (or followed by ? to see other options.)SH /Times-Italic SF 32280 10917 MT (\050Type carriage return here.\051)SH /Courier SF 10680 11948 MT (VM/370 ONLINE)SH /Times-Italic SF 32280 XM (The IBM system prints its herald.)SH /Courier SF 10680 13663 MT (.login myuserid mypassword)SH /Times-Italic SF 32280 XM (Login to IBM system.)SH 15000 50 11280 13863 UL /Courier SF 10680 15318 MT (LOGON AT 15:33:02 EST MONDAY 02/08/88)SH 10680 16349 MT (CUVMA CMS 3.1 8409 01/25/85)SH 10680 17380 MT (.)SH 10680 18411 MT (.Kermit)SH 3600 50 11280 18611 UL 10680 19442 MT (Kermit-CMS Version 4.0 \05087/12/17\051)SH 10680 20473 MT (Enter ? for a list of valid commands)SH 10680 22128 MT (Kermit-CMS>.send profile exec)SH 10200 50 17880 22328 UL 10680 23159 MT (^\134c)SH /Times-Italic SF 32280 XM (C-Kermit's escape sequence typed here.)SH 1800 50 10680 23359 UL /Courier SF 10680 24190 MT ([Back at Local System])SH 10680 25221 MT (C-Kermit>receive)SH /Times-Italic SF 32280 XM (Tell Unix Kermit to RECEIVE.)SH 4200 50 16080 25421 UL /Times-Roman SF 8280 26938 MT (The transfer takes place now; Unix Kermit will print the names) 78 W( of incoming files, followed by dots or percents to)77 W 8280 28134 MT (indicate the packet traffic \050a dot for every 4 packets successfully) 237 W( transferred, a percent for every timeout or)238 W 8280 29330 MT (retransmission\051. The) 295 W( transfer is complete when when you see ")22 W /Courier SF ([OK])SH /Times-Roman SF (", a beep is sounded, and the C-Kermit prompt)22 W 8280 30526 MT (next appears. At that point we connect back to the remote IBM system, exit from the remote Kermit and log out.)SH /Courier SF 10680 32181 MT (.)SH 10680 33212 MT (profile.exec ..%%.[OK])SH 10680 34243 MT (C-Kermit>connect)SH /Times-Italic SF 24680 XM (Get back to mainframe and clean up.)SH 4200 50 16080 34443 UL /Courier SF 10680 35898 MT (Kermit-CMS>.)SH 10680 36929 MT (Kermit-CMS>.exit)SH 2400 50 17880 37129 UL 10680 37960 MT (R;)SH 10680 38991 MT (.)SH 10680 40022 MT (SP/CMS)SH 10680 41053 MT (.logout)SH 10680 42708 MT (CONNECT= 00:03:01 VIRTCPU= 000:00.12 TOTCPU= 000:00.60)SH 10680 43739 MT (LOGOFF AT 15:40:13 EST MONDAY 02/08/88)SH 10680 45454 MT (^\134c)SH /Times-Italic SF 24680 XM (Type C-Kermit's escape sequence)SH 1800 50 10680 45654 UL /Courier SF 10680 46485 MT ([Back at Local System])SH 10680 47516 MT (C-Kermit>exit)SH /Times-Italic SF 24680 XM (All done with Kermit.)SH 2400 50 16080 47716 UL /Times-Roman SF 8280 49233 MT (That's the whole procedure. The file is in your Unix directory,) 91 W( completely readable, as)92 W /Courier SF 44808 XM (profile.exec)SH /Times-Roman SF 52350 XM (-- note)92 W 8280 50429 MT (that Kermit-CMS translated from the IBM EBCDIC character encoding into standard ASCII, and) 155 W( converted the)154 W 8280 51625 MT (space between the file name and file type to a dot.)SH 8280 54017 MT (To send a file from the local host to the) 119 W( remote host, we would merely have reversed the SEND and RECEIVE)120 W 8280 55213 MT (commands in the example above.)SH 12 /Times-Bold AF 8280 58329 MT (2.3.3. Micro to Micro)SH 10 /Times-Roman AF 8280 60271 MT (Kermit also works between personal computers \050microcomputers, workstations\051.) 270 W( The) 788 W( difference here is that)269 W 8280 61467 MT (commands are typed on)14 W /Times-Italic SF 18112 XM (two)SH /Times-Roman SF 19821 XM (keyboards, rather than a single one. This is because a personal computer normally only)15 W 8280 62663 MT (accepts commands from its own keyboard. If one PC Kermit CONNECTs to) 113 W( another, there will normally be no)112 W 8280 63859 MT (program on the other side to listen.)SH 8280 66251 MT (You can make the physical connection between two micros in two ways: direct or dialup. If the two units are in)94 W 8280 67447 MT (close proximity \050say, 50 feet or less\051, you can connect their serial ports with a null modem cable.)SH 8280 69839 MT (Connections at longer distances can be made via dialup, providing the required modems are available \050one side)146 W 8280 71035 MT (needs autoanswer capability\051, or) 41 W( using any kind of dedicated or switched circuit that may be available -- CBX, port)42 W ES %%Page: 16 17 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 16)SH 12 /Times-Bold AF 28952 XM (Kermit User Guide: How to Use Kermit \0502.3.3\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (contention unit, almost anything you can plug an EIA connector into.)SH 6120 10278 MT (In this example, a DEC VT180 "Robin" CP/M-80 microcomputer is connected to a) 45 W( Intertec "SuperBrain" CP/M-80)44 W 6120 11474 MT (micro, using a female-to-male null modem cable \050these systems have nostalgia value, being among the) 151 W( first for)152 W 6120 12670 MT (which Kermit programs were written\051. The) 22 W( connection can be tested by running Kermit and issuing the CONNECT)21 W 6120 13866 MT (command on both ends: typein from each micro should appear on the screen of the other.)SH 6120 16258 MT (Suppose you want to send a file)SH /Courier SF 19091 XM (FOO.HEX)SH /Times-Roman SF 23541 XM (from the Robin to the SuperBrain. Proceed as follows:)SH 8120 18049 MT (1.)SH 9120 XM (Run Kermit on the SuperBrain, and give the RECEIVE command:)SH /Courier SF 11520 19704 MT (A>Kermit)SH 3600 50 12720 19904 UL 11520 20735 MT (Intertec SuperBrain Kermit-80 - V4.09)SH 11520 21766 MT (Kermit-80>receive)SH 4200 50 17520 21966 UL /Times-Roman SF 8120 23976 MT (2.)SH 9120 XM (Run Kermit on the Robin, and give the SEND command for)SH /Courier SF 33396 XM (FOO.HEX)SH /Times-Roman SF (.)SH /Courier SF 11520 25631 MT (A>Kermit)SH 3600 50 12720 25831 UL 11520 26662 MT (DEC VT18X Kermit-80 - V4.09)SH 11520 27693 MT (Kermit-80>send foo.hex)SH 7200 50 17520 27893 UL /Times-Roman SF 9120 29410 MT (Watch the packets fly. When you get the next)93 W /Courier SF 28796 XM (Kermit-80>)SH /Times-Roman SF 35139 XM (prompt, the transfer is) 93 W( done, and you)94 W 9120 30515 MT (can EXIT from both Kermits.)SH 6120 32306 MT (The key point) 12 W( is to start the)11 W /Times-Italic SF 17393 XM (receiving)SH /Times-Roman SF 21375 XM (end first -- some microcomputer Kermits do not include a timeout facility, and)11 W 6120 33502 MT (if the receiver is not ready to receive when the sender first sends, there will be a protocol deadlock.)SH 14 /Times-Bold AF 6120 37104 MT (2.4. Another Way -- The Kermit Server)SH 10 /Times-Roman AF 6120 39222 MT (So far,) 189 W( we have been describing the bare-bones version of the Kermit protocol. An optional extension to the)190 W 6120 40418 MT (protocol includes the concept) 1 W( of a)SH /Times-Italic SF 19898 XM (Kermit server)SH /Times-Roman SF (. A) 250 W( Kermit server is a Kermit program that does not interact directly)SH 6120 41614 MT (with the user, but only with another Kermit program. You do not type commands to a Kermit server, you merely)75 W 6120 42810 MT (start it at one end of the connection, and then type all further commands at the other end.)SH 6120 45202 MT (Not all implementations of Kermit can be servers, and not all know how) 56 W( to talk to servers -- but most of the major)55 W 6120 46398 MT (ones can and do. The server is run on the remote computer, which would normally be a timesharing system, such as)12 W 6120 47594 MT (an IBM mainframe, a Unix system, or VAX/VMS, but may be a minicomputer or) 11 W( even a PC. It depends on whether)10 W 6120 48790 MT (the particular Kermit program has a "server" command. You must still connect to) 15 W( the remote host to log in and start)16 W 6120 49986 MT (the server, but you no longer have to tell one side to SEND and the other) 42 W( to RECEIVE, nor must you connect back)41 W 6120 51182 MT (to the) 5 W( remote side to clean up and log out when you're done. Using the server, you can do as many send and receive)6 W 6120 52378 MT (operations as you) 17 W( like without ever having to connect back to the remote host. Some servers also provide additional)16 W 6120 53574 MT (services, such as directory listings, file deletion, or disk usage inquiries.)SH 6120 55966 MT (A Kermit server is just a Kermit program running in a special way. It acts much like) 10 W( ordinary Kermit does after you)11 W 6120 57162 MT (give it a RECEIVE command -- it waits for a message from the other Kermit, but in this case) 129 W( the message is a)128 W 6120 58358 MT (command saying what to do, normally to send) 26 W( or to receive a file or group of files. After escaping back to the local)27 W 6120 59554 MT (system, you can give as many SEND and GET commands as you like, and when you're) 62 W( finished transferring files,)61 W 6120 60750 MT (you can give the BYE command, which sends a message to the remote Kermit server to log itself out.) 74 W( You) 399 W( don't)75 W 6120 61946 MT (have to connect back) 1 W( to the remote host and clean up. However, if you)SH /Times-Italic SF 34811 XM (want)SH /Times-Roman SF 37006 XM (to connect back to the host, you can use)SH 6120 63142 MT (the FINISH command instead of BYE, to shut down the Kermit server on) 96 W( the remote host without logging it off,)97 W 6120 64338 MT (allowing you to CONNECT back to your job there.)SH 6120 66730 MT (Here's an example of the use of a) 72 W( Kermit server. The user is sitting at an IBM PC and a DECSYSTEM-20 is the)71 W 6120 67926 MT (remote host.)SH /Courier SF 8520 69641 MT (A>Kermit)SH /Times-Italic SF 22520 XM (Run Kermit on the micro.)SH 3600 50 9720 69841 UL /Courier SF 8520 70672 MT (Kermit-MS V2.30)SH 8520 71703 MT (IBM-PC Kermit-MS: V2.30 8 Jan 88)SH ES %%Page: 17 18 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (2.4. Another Way -- The Kermit Server)SH 10 /Times-Italic AF 51775 XM (Page 17)SH 46800 50 8280 5709 UL /Courier SF 10680 7824 MT (Type ? for help)SH 10680 9539 MT (Kermit-MS>)SH /Times-Italic SF 24680 XM (This is the Kermit prompt for the PC.)SH /Courier SF 10680 10570 MT (Kermit-MS>connect)SH /Times-Italic SF 24680 XM (Connect to the VAX.)SH 4200 50 16680 10770 UL /Courier SF 10680 12285 MT (CU20B)SH /Times-Italic SF 24680 XM (The DEC-20 prints its herald.)SH /Courier SF 10680 13316 MT (@login my-id password)SH /Times-Italic SF 24680 XM (Log in normally.)SH 12000 50 11280 13516 UL 8280 15031 MT (\050The DEC-20 prints various login messages here.\051)SH /Courier SF 10680 16746 MT (@Kermit)SH /Times-Italic SF 24680 XM (Run Kermit-20 normally)SH 3600 50 11280 16946 UL /Courier SF 10680 17777 MT (Kermit-20>server)SH /Times-Italic SF 24680 XM (Tell it to be a server.)SH 3600 50 16680 17977 UL /Courier SF 10680 19432 MT (Kermit Server running on DEC-20 host. Please type your escape)SH 10680 20463 MT (sequence to return to your local machine. Shut down the server by)SH 10680 21494 MT (typing the Kermit BYE command on your local machine.)SH 10680 23209 MT (^]c)SH /Times-Italic SF 24680 XM (Now escape back to the PC.)SH 1800 50 10680 23409 UL /Courier SF 10680 24924 MT (Kermit-MS>get *.pas)SH /Times-Italic SF 24680 XM (Get all my DEC-20 Pascal programs.)SH 5400 50 16680 25124 UL /Courier SF 10680 25955 MT (Kermit-MS>send foo.*)SH /Times-Italic SF 24680 XM (Send all the "foo" files from my PC.)SH 6000 50 16680 26155 UL /Courier SF 10680 26986 MT (Kermit-MS>exit)SH /Times-Italic SF 24680 XM (Exit from Kermit back to DOS.)SH 2400 50 16680 27186 UL /Courier SF 10680 28017 MT (A>)SH /Times-Italic SF 8280 29732 MT (\050Here you can do some work on the micro, edit files, whatever you like.\051)SH /Courier SF 10680 31447 MT (A>Kermit)SH /Times-Italic SF 24680 XM (Run Kermit-80 some more.)SH 3600 50 11880 31647 UL /Courier SF 10680 32478 MT (Kermit-MS>send file.pas)SH /Times-Italic SF 24680 XM (Send another file.)SH 7800 50 16680 32678 UL /Courier SF 10680 33509 MT (Kermit-MS>bye)SH /Times-Italic SF 24680 XM (That's all. Shut down the Kermit server.)SH 1800 50 16680 33709 UL /Courier SF 10680 34540 MT (A>)SH /Times-Italic SF 24680 XM (Back at DOS automatically.)SH /Times-Roman SF 8280 36257 MT (This is)79 W /Times-Italic SF 11383 XM (much)SH /Times-Roman SF 13878 XM (simpler. Note) 408 W( that once you've started the Kermit) 79 W( Server on the remote end, you can run Kermit as)80 W 8280 37453 MT (often as you like on the micro without having to go back and forth any more; just make sure to shut the) 17 W( server down)16 W 8280 38649 MT (when you're done by typing the BYE command.)SH 8280 41041 MT (If it's so) 53 W( much simpler, why not do it this way all the time? You can, provided your remote Kermit has a "server")54 W 8280 42237 MT (command. But) 316 W( server operation, plus the special commands the local Kermit needs to) 33 W( communicate with the server)32 W 8280 43433 MT (\050GET, REMOTE, BYE, FINISH\051 are) 27 W( optional Kermit features, so some Kermit programs might not have them. All)28 W 8280 44629 MT (Kermit programs, however, should provide the basic SEND/RECEIVE mode of operation.)SH 8280 47021 MT (Here are the basic commands available for talking to servers:)SH 8280 48812 MT (SEND)SH /Times-Italic SF 11141 XM (filespec)SH /Times-Roman SF 16280 XM (Sends a file or file group from the local host to the remote host in the normal way.)SH 8280 50389 MT (GET)SH /Times-Italic SF 10474 XM (filespec)SH /Times-Roman SF 16280 XM (Ask the remote host to send a file or file group. Example:)SH /Courier SF 18680 52044 MT (get *.c)SH /Times-Roman SF 16280 53761 MT (This command is exactly equivalent to typing "send)224 W /Courier SF 39090 XM (*.c)SH /Times-Roman SF (" at) 224 W( the remote host followed by)223 W 16280 54866 MT ("receive" on the local host. Note that the local Kermit does not attempt) 40 W( to validate the filespec.)41 W 16280 55971 MT (If the server cannot access the specified file\050s\051,) 75 W( it will send back an appropriate error message.)74 W 16280 57076 MT (Please note that GET and RECEIVE are not the) 22 W( same! RECEIVE tells Kermit to passively wait)23 W 16280 58181 MT (for a file. GET actively sends a request to a Kermit server to send the named file.)SH 8280 59758 MT (REMOTE)SH /Times-Italic SF 12641 XM (command)SH /Times-Roman SF 16779 XM ([)SH /Times-Italic SF (argument)SH /Times-Roman SF (])SH 16280 60863 MT (Ask the server to perform the specified command, and send the results to your screen. Not all)72 W 16280 61968 MT (servers are capable) 31 W( of performing REMOTE commands; those that can most commonly provide)30 W 16280 63073 MT (REMOTE DIRECTORY, REMOTE DELETE, REMOTE SPACE, and similar) 21 W( file management)22 W 16280 64178 MT (services.)SH 8280 65755 MT (BYE)SH 16280 XM (Shut down the remote server and exit from Kermit. This will cause the) 31 W( job at the remote end to)30 W 16280 66860 MT (log itself out. You need not connect back and clean up) 154 W( unless you get an error message in)155 W 16280 67965 MT (response to this command.)SH 8280 69542 MT (FINISH)SH 16280 XM (Shut down the server without having it log itself out, and don't exit from Kermit. A) 26 W( subsequent)25 W 16280 70647 MT (CONNECT command will put you back at your job on the remote) 131 W( host, at system command)132 W 16280 71752 MT (level.)SH ES %%Page: 18 19 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 18)SH 12 /Times-Bold AF 29852 XM (Kermit User Guide: How to Use Kermit \0502.4\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (Server operation is not limited to mainframes.) 92 W( Some) 433 W( PC Kermit implementations can also act as servers, notably)91 W 6120 9082 MT (MS-DOS and Unix. For instance, an IBM PC at the) 21 W( office with an autoanswer modem can be left in server mode at)22 W 6120 10278 MT (the end of the day, and then dialed up from home in the evening for file transfer.)SH ES %%Page: 19 20 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (3. When Things Go Wrong)SH 10 /Times-Italic AF 51775 XM (Page 19)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 8280 8272 MT (3. When Things Go Wrong)SH 10 /Times-Roman AF 8280 10566 MT (Connecting two computers can be) 19 W( a tricky business, and many things can go wrong. Before you can transfer files at)18 W 8280 11762 MT (all, you must first establish terminal communication.) 29 W( But) 309 W( successful terminal connection does not necessarily mean)30 W 8280 12958 MT (that file transfer will also work. And even when) 14 W( file transfer seems to be working, things can happen to ruin it. The)13 W 8280 14154 MT (following sections treat a few basic problems. See the troubleshooting section of the Kermit book for greater detail.)SH 14 /Times-Bold AF 8280 17756 MT (3.1. Basic Connection Problems)SH 10 /Times-Roman AF 8280 19874 MT (If you have a version of Kermit on your microcomputer, but the CONNECT command doesn't seem to work at all,)41 W 8280 21070 MT (please:)SH /Symbol SF 10070 22975 MT (\267)SH /Times-Roman SF 10780 XM (Make sure all the required physical connections have been made) 10 W( and have not wiggled loose. If you are)9 W 10780 24080 MT (using a modem, make sure the carrier light is on.)SH /Symbol SF 10070 26069 MT (\267)SH /Times-Roman SF 10780 XM (If you have more than one connector on your micro, make sure you are using the right one.)SH /Symbol SF 10070 28058 MT (\267)SH /Times-Roman SF 10780 XM (Make sure that the port is set to the right communication speed, or)20 W /Times-Italic SF 37816 XM (baud rate)21 W /Times-Roman SF (. Some) 292 W( versions of Kermit)21 W 10780 29163 MT (have a built-in SET BAUD or SET) 50 W( SPEED command, others require that you set the baud rate using a)49 W 10780 30268 MT (system command or) 79 W( setup mode before you start the Kermit program. Some versions of Kermit have)80 W 10780 31373 MT (SHOW or STATUS commands that will tell you what the current baud rate is.)SH /Symbol SF 10070 33362 MT (\267)SH /Times-Roman SF 10780 XM (Make sure that the other communication line parameters, like parity, bits per character, handshake,) 42 W( and)41 W 10780 34467 MT (flow control are set correctly.)SH 8280 36258 MT (You may have to consult the appropriate manuals for the systems and equipment in question.)SH 8280 38650 MT (If all settings and connections appear to be correct, and communication still does not take place, the fault may be) 32 W( in)33 W 8280 39846 MT (your modem. Internal modems \050i.e. those that plug in to a slot inside the microcomputer chassis\051 are)247 W /Times-Italic SF 53802 XM (not)SH /Times-Roman SF 8280 41042 MT (recommended for use with Kermit unless they totally mimic the asynchronous serial) 64 W( port hardware they purport to)65 W 8280 42238 MT (replace, or unless the Kermit program claims) 197 W( to support the particular internal modem. Many microcomputer)196 W 8280 43434 MT (Kermit programs are written to) 57 W( control the communication hardware explicitly; internal modems can interfere with)58 W 8280 44630 MT (that control.)SH 8280 47022 MT (Even external modems can cause trouble -- the "smarter" they are, the more potential danger) 196 W( of disagreement)195 W 8280 48218 MT (between the modem and the microcomputer about settings of baud rate, character framing, echo, and so forth. Make)8 W 8280 49414 MT (sure your modem is set up correctly \050consult your modem manual\051.)SH 14 /Times-Bold AF 8280 53016 MT (3.2. Terminal Connection Works But The Transfer Won't Start)SH 10 /Times-Roman AF 8280 55134 MT (Once you've made a terminal connection to the remote system, you) 27 W( will generally also be able to transfer files. But)26 W 8280 56330 MT (not always. If Kermit's terminal emulation seems to work correctly, but a file transfer will not start at all,) 125 W( then)126 W 8280 57526 MT (something in the communication path is probably interfering with the packet data:)SH 8280 59317 MT (PARITY:)SH 10280 60422 MT (A device can impose)19 W /Times-Italic SF 18965 XM (parity)SH /Times-Roman SF 21623 XM (upon the communication line. This) 19 W( means that the 8th bit of each character is used)20 W 10280 61527 MT (by the equipment to check for correct transmission. Use of parity will:)SH /Symbol SF 12070 63432 MT (\267)SH /Times-Roman SF 12780 XM (Cause packet checksums to appear incorrect to the receiver and foil any attempt at file) 25 W( transfer. In)24 W 12780 64537 MT (most cases, not even the first packet will get through.)SH /Symbol SF 12070 66526 MT (\267)SH /Times-Roman SF 12780 XM (Prevent the use of the 8th bit for binary file data.)SH 10280 68317 MT (If terminal connection works but file transfer does not,) 146 W( parity is the most likely culprit. To overcome this)147 W 10280 69422 MT (impediment, you should find out what parity is being used, and inform the Kermits one side or) 38 W( both \050using the)37 W 10280 70527 MT (SET PARITY command\051 so that they can:)SH ES %%Page: 20 21 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 20)SH 12 /Times-Bold AF 27116 XM (Kermit User Guide: When Things Go Wrong \0503.2\051)SH 46800 50 6120 5709 UL 10 /Symbol AF 9910 8000 MT (\267)SH /Times-Roman SF 10620 XM (Compose and interpret the checksums correctly.)SH /Symbol SF 9910 9989 MT (\267)SH /Times-Roman SF 10620 XM (Employ a special encoding to allow 8-bit data to pass through the 7-bit communication channel.)SH 8120 11780 MT (Many packet-switched networks,) 41 W( such as GTE TELENET, require parity to be set, as do IBM mainframes and)42 W 8120 12885 MT (their front end processors.)SH 6120 14462 MT (ECHOING:)SH 8120 15567 MT (Some communication processors, typically front ends,) 168 W( echo their input. When this happens, every Kermit)169 W 8120 16672 MT (packet that is sent to it will bounce right back, causing no end of confusion. Some Kermit) 21 W( programs have been)20 W 8120 17777 MT (designed to ignore echoed packets, but others have not. If) 191 W( you encounter this problem, there are several)192 W 8120 18882 MT (possible solutions:)SH /Symbol SF 9910 20787 MT (\267)SH /Times-Roman SF 10620 XM (Disable the front end echoing by) 18 W( typing some special command, if such a command is provided by)17 W 10620 21892 MT (the system.)SH /Symbol SF 9910 23881 MT (\267)SH /Times-Roman SF 10620 XM (Some front ends) 53 W( respond to certain escape or control sequences as commands to turn off echoing,)54 W 10620 24986 MT (either from that point onward, or else on a per-line) 146 W( basis. In this case, the appropriate control)145 W 10620 26091 MT (sequence can be inserted between packets by Kermit programs instructed to do so,) 135 W( for instance)136 W 10620 27196 MT (using the SET PAD command.)SH /Symbol SF 9910 29185 MT (\267)SH /Times-Roman SF 10620 XM (If the echoing cannot be disabled, then the two) 206 W( Kermit programs should be instructed to use)205 W 10620 30290 MT (differing packet start markers, using) 48 W( the SET START-OF-PACKET command -- for instance, one)49 W 10620 31395 MT (Kermit uses Control-A as usual, and the other uses Control-B. This can only be done if both)160 W 10620 32500 MT (Kermits have this SET command.)SH 14 /Times-Bold AF 6120 36102 MT (3.3. Special Characters)SH 10 /Times-Roman AF 6120 38220 MT (There is one problem that can prevent a file transfer from starting at all, or) 111 W( may crop up after the file transfer is)112 W 6120 39416 MT (underway. For) 474 W( instance, during a file transfer operation you might find your smart modem suddenly hanging up)111 W 6120 40612 MT (your current connection and) 203 W( placing a call to Tasmania. Or you might find that packets containing a certain)204 W 6120 41808 MT (character like ")SH /Courier SF (@)SH /Times-Roman SF (" cannot be transmitted successfully.)SH 6120 44200 MT (This is the problem of "special characters". Some device in the communication path -- a front end, a port switcher,) 5 W( a)4 W 6120 45396 MT (multiplexer, a "smart" modem -- interprets certain characters) 50 W( in the data stream as commands rather than as data to)51 W 6120 46592 MT (be passed them along to the other side. Usually such) 130 W( equipment interferes only with the transmission of ASCII)129 W 6120 47788 MT (control characters; so long as Control-A and Carriage Return -- Kermit's normal packet start and end) 72 W( delimiters --)73 W 6120 48984 MT (are not molested, then Kermit can operate. However, equipment may exist which) 280 W( swallows even printable)279 W 6120 50180 MT (characters. Since) 628 W( Kermit assumes that ALL printable ASCII) 189 W( characters \050ASCII 40 through 176, octal\051 can be)190 W 6120 51376 MT (transmitted without interference or modification, such equipment) 289 W( will prevent Kermit file transfer unless its)288 W 6120 52572 MT (printable-character-swallowing features can be disabled.)SH 14 /Times-Bold AF 6120 56174 MT (3.4. The Transfer Starts But Then Gets Stuck)SH 10 /Times-Roman AF 6120 58292 MT (Once a Kermit file transfer has begun, there are certain conditions under which it can become stuck.) 82 W( Since) 416 W( many)83 W 6120 59488 MT (hosts are capable of generating timeout interrupts when input doesn't appear within a) 63 W( reasonable interval, they can)62 W 6120 60684 MT (resend unacknowledged packets or request that missing packets be retransmitted. But since not all Kermit programs)14 W 6120 61880 MT (are capable) 21 W( of timing out, a means for manual intervention is provided in the local Kermit -- you can type a carriage)20 W 6120 63076 MT (return on the keyboard of most micros to wake up and continue the transfer.)SH 6120 65468 MT (The following sections discuss various reasons why a transfer in progress could become stuck. Before examining)80 W 6120 66664 MT (these, first make sure that you really have a Kermit on the other end of) 22 W( the line, and you have issued the appropriate)21 W 6120 67860 MT (command: SEND, RECEIVE, or SERVER.) 11 W( If) 273 W( the remote side is not a server, remember that you must connect back)12 W 6120 69056 MT (between each transfer and issue a new SEND or RECEIVE command.)SH ES %%Page: 21 22 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (3.4.1. The Connection is Broken)SH 10 /Times-Italic AF 51775 XM (Page 21)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (3.4.1. The Connection is Broken)SH 10 /Times-Roman AF 8280 9946 MT (Check the connection. Make sure) 55 W( no connectors have wiggled loose from their sockets. If you're using a modem,)54 W 8280 11142 MT (make sure you still have a carrier signal. Reestablish your connection if you have to.)SH 8280 13534 MT (If upon reconnection you) 23 W( get no response, maybe the remote host or the remote Kermit program crashed. Get back)24 W 8280 14730 MT (to command level on the local Kermit \050on microcomputer) 93 W( implementations, you may be able to do this by typing)92 W 8280 15926 MT (about five RETURNs, or one or more Control-C's\051. Issue the CONNECT command so that you can see) 162 W( what)163 W 8280 17122 MT (happened. If) 294 W( the remote system has crashed then you will have to wait for it) 22 W( to come back, and restart whatever file)21 W 8280 18318 MT (that was being transferred at the time.)SH 12 /Times-Bold AF 8280 21434 MT (3.4.2. The Disk is Full)SH 10 /Times-Roman AF 8280 23376 MT (If your local floppy disk or remote directory fills) 55 W( up, the Kermit on the machine where this occurs will inform you)56 W 8280 24572 MT (and then terminate the transfer. You can continue the transfer by repeating the) 46 W( whole procedure either with a fresh)45 W 8280 25768 MT (floppy or after cleaning up your directory. Some Kermits also have a feature) 51 W( that allows you to keep incompletely)52 W 8280 26964 MT (received files; this would allow you go back to the sending system,) 15 W( extract the unsent portion of the file, and send it,)14 W 8280 28160 MT (and then append the two received portions) 30 W( together using an editor or other system utility. Kermit does not provide)31 W 8280 29356 MT (the ability to switch disks during a file transfer.)SH 12 /Times-Bold AF 8280 32472 MT (3.4.3. Transmission Delays)SH 10 /Times-Roman AF 8280 34414 MT (Packet transmission can be delayed by various agents:) 70 W( congested timesharing systems or networks, earth satellites,)69 W 8280 35610 MT (etc. When) 406 W( transmission delay exceeds the) 78 W( per-packet timeout interval for a significant length of time, the transfer)79 W 8280 36806 MT (could fail.) 115 W( Most) 479 W( Kermit programs provide commands that allow you to adjust the timeout interval or the packet)114 W 8280 38002 MT (transmission retry threshhold in order to accommodate to severe transmission delays.)SH 12 /Times-Bold AF 8280 41118 MT (3.4.4. Noise Corruption)SH 10 /Times-Roman AF 8280 43060 MT (If your connection is extremely) 95 W( noisy, packets will become corrupted -- and require retransmission -- more often.)96 W 8280 44256 MT (The probability that successive retransmissions will fail) 162 W( because of corruption rises with the noise level until it)161 W 8280 45452 MT (exceeds the retry threshhold, at which point the file transfer fails. There are several) 18 W( recourses. First, try to establish)19 W 8280 46648 MT (a new connection. If that is impractical, then use SET commands \050when available\051 to reduce the packet length and)47 W 8280 47844 MT (increase the retry threshhold. Shorter packets reduce the probability that a particular packet will be) 77 W( corrupted and)78 W 8280 49040 MT (the retransmission) 47 W( overhead when corruption does occur, but they also increase the overall protocol overhead. In a)46 W 8280 50236 MT (noisy environment, you should also request a higher level of error checking \050SET BLOCK 2 or 3\051.)SH 12 /Times-Bold AF 8280 53352 MT (3.4.5. Host Errors)SH 10 /Times-Roman AF 8280 55294 MT (Various error conditions can occur on the remote host that) 43 W( could effect file transmission. Whenever any such error)44 W 8280 56490 MT (occurs, the remote Kermit normally attempts to send an informative error message to) 36 W( the local one, and then breaks)35 W 8280 57686 MT (transmission, putting you back at Kermit command level on the local system.)SH 14 /Times-Bold AF 8280 61288 MT (3.5. File is Garbage)SH 10 /Times-Roman AF 8280 63406 MT (There are certain conditions under which Kermit can believe it transferred a file correctly when) 79 W( in fact, it did not.)80 W 8280 64602 MT (The most likely cause has to do with the tricky business of)131 W /Times-Italic SF 33517 XM (file attributes)131 W /Times-Roman SF (, such as text) 131 W( vs binary, 7-bit vs 8-bit,)130 W 8280 65798 MT (blocked vs stream, and so) 68 W( forth. Each system has its own peculiarities, and each Kermit has special commands to)69 W 8280 66994 MT (allow you to specify how a file should be sent or stored.) 113 W( However,) 474 W( these difficulties usually crop up only when)112 W 8280 68190 MT (sending binary files. Textual files should normally present no problem between any two Kermit programs.)SH ES %%Page: 22 23 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 22)SH 12 /Times-Bold AF 28016 XM (Kermit User Guide: When Things Go Wrong \0504\051)SH 46800 50 6120 5709 UL ES %%Page: 23 24 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (4. Kermit Commands)SH 10 /Times-Italic AF 51775 XM (Page 23)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 8280 8272 MT (4. Kermit Commands)SH 10 /Times-Roman AF 8280 10566 MT (An "ideal") 119 W( Kermit program will be described here, which has most of the features specified in the Kermit book.)120 W 8280 11762 MT (Few Kermit programs will have all) 98 W( these commands or support all these options. The exact form of some of the)97 W 8280 12958 MT (commands may differ from version to version. Some Kermit programs) 57 W( may support system-dependent options not)58 W 8280 14154 MT (described here. The intention of this description is to provide a base from which specific Kermit programs can) 66 W( be)65 W 8280 15350 MT (described in terms of their differences from the "ideal.")SH 14 /Times-Bold AF 8280 18952 MT (4.1. Remote and Local Operation)SH 10 /Times-Roman AF 8280 21070 MT (In any connection between two Kermit programs, one Kermit) 12 W( is)13 W /Times-Italic SF 34203 XM (remote)SH /Times-Roman SF 37243 XM (and the other is)13 W /Times-Italic SF 43683 XM (local)SH /Times-Roman SF (. The) 276 W( remote Kermit is)13 W 8280 22266 MT (usually running on a mainframe,) 61 W( which you have CONNECTed to through a PC or other computer. When Kermit)60 W 8280 23462 MT (runs remotely, all file transfer is done over the job's controlling terminal line) 8 W( -- the same line over which you logged)9 W 8280 24658 MT (in, and to which you would type interactive commands. What the system thinks is your terminal is really) 76 W( another)75 W 8280 25854 MT (computer, usually a microcomputer, running its own copy of Kermit.)SH 8280 28246 MT (When Kermit is in "local mode", file transfer is) 138 W( done over an external device, such as a microcomputer's serial)139 W 8280 29442 MT (communication port, or an assigned terminal line on a mainframe.) 24 W( The) 296 W( local Kermit is connected in some way \050like)23 W 8280 30638 MT (a dialout mechanism\051 to another computer, again running its own copy of Kermit. A local Kermit is in control of the)SH 8280 31834 MT (screen, a remote Kermit has no direct access to it. Microcomputer Kermits are run) 56 W( in local mode unless instructed)55 W 8280 33030 MT (otherwise; mainframe Kermits run remotely unless some special command places them in) 209 W( local mode. Some)210 W 8280 34226 MT (commands make sense only for) 12 W( remote Kermits, others only for local, still others can be used with either. Local and)11 W 8280 35422 MT (remote operation of Kermit is shown schematically here: The Kermit program on the PC is) 54 W( a)55 W /Times-Italic SF 46778 XM (local)SH /Times-Roman SF 49083 XM (Kermit. It) 360 W( can)55 W 46800 50 8280 37413 UL /Times-Italic SF 8280 38409 MT (PC is Local, Mainframe is Remote:)SH /Courier SF 17280 40064 MT (Communication)SH 17280 41095 MT (Line \050Packets\051)11400 W 17280 42126 MT (+---------------/ /-----------------+ Other) 600 W( terminals)SH 17280 43157 MT (| |) 21000 W( | | |)600 W 17280 44188 MT (| |) 21000 W( | | |)600 W 11280 45219 MT (PC |) 4200 W( LOCAL) 2400 W( Mainframe) 7800 W( |) 1200 W( | | | REMOTE)600 W 10680 46250 MT (+----------+----------+ +------------+--+--+--+--------+)6600 W 10680 47281 MT (| Serial) 1200 W( Port) SH( |) 3600 W( | |) 6600 W( |)9600 W 10680 48312 MT (| |) 12000 W( | |) 6600 W( |)9600 W 10680 49343 MT (| |) 12000 W( | |) 6600 W( |)9600 W 10680 50374 MT (| +---------------+ |) 600 W( | Your) 6600 W( job's) SH( |)4200 W 10680 51405 MT (| |) 600 W( Packets: 724 | |) SH( | terminal) 6600 W( line) SH( |)2400 W 10680 52436 MT (| |) 600 W( Retries:) SH( 7) 1200 W( | |) 600 W( |) 6600 W( |)17400 W 10680 53467 MT (| |) 600 W( File: FOO.BAR | |) SH( |) 6600 W( |)17400 W 10680 54498 MT (| +---------------+ |) 600 W( |) 6600 W( |)17400 W 10680 55529 MT (| Screen) 1200 W( | |) 6600 W( |)17400 W 10680 56560 MT (| |) 12000 W( |) 6600 W( |)17400 W 10680 57591 MT (+---------------+-----+ +------------------------------+)6600 W 20280 58622 MT (|)SH 20280 59653 MT (| \050Commands\051)SH 20280 60684 MT (|)SH 12480 61715 MT (+------------+---------+)SH 13080 62746 MT (\134 Keyboard \134)3600 W 13680 63777 MT (+----------------------+)SH 20280 64808 MT (You)SH /Times-Bold SF 23653 66525 MT (Figure 4-1:)SH /Times-Roman SF 28902 XM (Local and Remote Kermits)SH 46800 50 8280 68335 UL 8280 69926 MT (control the screen, the keyboard, and the port separately, thus it can update the screen with status information, watch)11 W 8280 71122 MT (for interrupt signals from the keyboard, and transfer packets on the communications port, all at the same time.)SH ES %%Page: 24 25 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 24)SH 12 /Times-Bold AF 29851 XM (Kermit User Guide: Kermit Commands \0504.1\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (The Kermit program running on the) 91 W( mainframe is a)92 W /Times-Italic SF 27745 XM (remote)SH /Times-Roman SF 30864 XM (Kermit. The) 434 W( user logs in to the mainframe through a)92 W 6120 9082 MT (terminal port. The host computer cannot tell that) 176 W( the user is really coming in through a microcomputer. The)175 W 6120 10278 MT (keyboard, screen, and port functions are all combined in user's mainframe terminal line. Therefore a remote) 15 W( Kermit)16 W 6120 11474 MT (is cut off from your screen and keyboard during file transfer.)SH 14 /Times-Bold AF 6120 15076 MT (4.2. The Command Dialog)SH 10 /Times-Roman AF 6120 17194 MT (Most Kermit programs communicate with you through interactive) 174 W( keyword-style command dialog \050a prominent)173 W 6120 18390 MT (exception is Macintosh Kermit, which uses pulldown) 192 W( menus that overlay the terminal emulation screen\051. The)193 W 6120 19586 MT (program issues a)SH /Times-Italic SF 13091 XM (prompt)SH /Times-Roman SF (, indicating that it is waiting for you to type a command. The prompt is usually of the form)SH /Courier SF 8520 21301 MT (Kermit-)SH /Times-Italic SF (xx)SH /Courier SF (>)SH /Times-Roman SF 6120 23018 MT (where)SH /Times-Italic SF 9028 XM (xx)SH /Times-Roman SF 10381 XM (indicates the version) 215 W( of Kermit --)214 W /Courier SF 25220 XM (Kermit-MS>)SH /Times-Roman SF 31684 XM (for MS-DOS Kermit,)214 W /Courier SF 41103 XM (Kermit-86>)SH /Times-Roman SF 47567 XM (for CP/M-86)214 W 6120 24214 MT (Kermit, etc.)SH 6120 26606 MT (In response to the program's prompt you may type a keyword, such) 199 W( as SEND, RECEIVE, or EXIT, possibly)200 W 6120 27802 MT (followed by additional keywords or operands, each of which is called a)12 W /Times-Italic SF 35008 XM (field)SH /Times-Roman SF (. You) 274 W( can abbreviate keywords) 12 W( \050but not)11 W 6120 28998 MT (file names\051 to any length that makes them distinguishable from any other keyword valid for that field.) 11 W( You) 273 W( can type)12 W 6120 30194 MT (a question mark at any time to get information about what's expected or valid) 148 W( at that point. The ESC and "?")147 W 6120 31390 MT (features work best on full duplex systems, where) 35 W( the program can "wake up" immediately and perform the required)36 W 6120 32586 MT (function. On) 262 W( half duplex or record-oriented systems, the ESC feature is) 6 W( not available, and the "?" requires a carriage)5 W 6120 33782 MT (return to follow.)SH 6120 36174 MT (In this example, the user types "set" and then a question mark to) 51 W( find out what the SET options are. The user then)52 W 6120 37370 MT (continues the command at the point where the question) 41 W( mark was typed, adding a "d" and another question mark to)40 W 6120 38566 MT (see what set options start with "d".) 22 W( The) 295 W( user then adds a "u" to select "duplex" \050the only SET option that starts with)23 W 6120 39762 MT ("du"\051 followed by an ESC \050shown here by a dollar sign\051 to complete) 18 W( the current field, then another question mark to)17 W 6120 40958 MT (see what the possibilities are for the next field, and so forth.) 1 W( The) 254 W( command is finally terminated by a carriage return.)2 W 6120 42154 MT (Before carriage return is typed, however, the command can be edited or erased using RUBOUT or) 56 W( other command)55 W 6120 43350 MT (editing keys. Finally, the same command is entered again with a minimum of keystrokes, with each) 276 W( field)277 W 6120 44546 MT (abbreviated to its) 144 W( shortest unique length. In the example, the parts the user types are underlined; all the rest is)143 W 6120 45742 MT (system typeout:)SH /Courier SF 8520 48228 MT (Kermit-20>set ? one of the following:)SH 3000 50 14520 48428 UL 9120 49259 MT (debugging delay) 4200 W( duplex) 7200 W( escape)6600 W 9120 50290 MT (file handshake) 7200 W( IBM) 4800 W( line)8400 W 9120 51321 MT (parity receive send)6000 W 8520 52352 MT (Kermit-20>set d? one of the following:)SH 1200 50 16920 52552 UL 9120 53383 MT (debugging delay) 1200 W( duplex)4200 W 8520 54414 MT (Kermit-20>set du$plex \050to\051 ? one of the following:)SH 1200 50 17520 54614 UL 600 50 24720 54614 UL 9120 55445 MT (full half)1200 W 8520 56476 MT (Kermit-20>set duplex \050to\051 h$alf)SH 1200 50 24120 56676 UL 8520 57507 MT (Kermit-20>set du h)SH 4800 50 14520 57707 UL 14 /Times-Bold AF 6120 61109 MT (4.3. Notation)SH 10 /Times-Roman AF 6120 63227 MT (In the command descriptions, the following notation is used:)SH /Times-Italic SF 6120 65018 MT (italics)SH /Times-Roman SF 12120 XM (A parameter - the) 225 W( symbol in italics is replaced by an argument of the specified type \050number,)226 W 12120 66123 MT (filename, etc\051.)SH 6120 67700 MT ([)SH /Times-Italic SF (anything)SH /Times-Roman SF (])SH 12120 XM (A field enclosed in square brackets is optional. If omitted, the field defaults to an appropriate) 41 W( value.)40 W 12120 68805 MT (You don't type the brackets.)SH 6120 70382 MT ({x,y,z})SH 12120 XM (A list of alternatives is enclosed in curly braces; you type one of the alternatives.)SH /Times-Italic SF 6120 71959 MT (number)SH /Times-Roman SF 12120 XM (A whole number, entered in prevailing notation of the system.)SH ES %%Page: 25 26 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (4.3. Notation)SH 10 /Times-Italic AF 51775 XM (Page 25)SH 46800 50 8280 5709 UL 8280 7886 MT (character)SH /Times-Roman SF 14280 XM (A single character,) 73 W( entered literally, or as a number \050perhaps octal or hexadecimal\051 representing the)74 W 14280 8991 MT (ASCII value of the character.)SH /Times-Italic SF 8280 10568 MT (floating-point-number)SH /Times-Roman SF 14280 11673 MT (A "real" number, possibly containing a decimal point and a fractional part.)SH /Times-Italic SF 8280 13250 MT (filespec)SH /Times-Roman SF 14280 XM (A file specification, i.e. the name) 6 W( of a file, possibly including a search path, device or directory name,)7 W 14280 14355 MT (or other qualifying information, and) 25 W( possibly containing "wildcard" or pattern-matching characters to)24 W 14280 15460 MT (denote a group of files.)SH /Courier SF 8280 17037 MT (^X)SH /Times-Roman SF 14280 XM (A control character may be written using "uparrow" or "caret" notation, since many) 58 W( systems display)59 W 14280 18142 MT (control characters this way. Control characters are produced by holding down the key) 17 W( marked CTRL)16 W 14280 19247 MT (or Control and typing the appropriate character, e.g. X.) 220 W( Control characters may also be written)221 W 14280 20352 MT (Ctrl-X, CTRL-X, CTRL/X, etc.)SH 8280 22143 MT (Commands are shown in upper case, but can be entered in any combination of upper and lower case.)SH ES %%Page: 26 27 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 26)SH 12 /Times-Bold AF 29851 XM (Kermit User Guide: Kermit Commands \0504.3\051)SH 46800 50 6120 5709 UL 14 SS 6120 8138 MT (4.4. Summary of Kermit Commands)SH 10 /Times-Roman AF 6120 10256 MT (Here is a brief list) 63 W( of Kermit commands as they are to be found in most Kermit programs. The following sections)62 W 6120 11452 MT (will describe these commands in detail.)SH /Times-Italic SF 6120 13241 MT (For exchanging files:)SH /Times-Roman SF 8120 14346 MT (SEND, RECEIVE, GET)SH /Times-Italic SF 6120 16004 MT (For connecting to a remote host:)SH /Times-Roman SF 8120 17109 MT (CONNECT, SET LINE, SET PARITY, SET DUPLEX, SET HANDSHAKE,) 741 W( SET ESCAPE,)742 W 8120 18214 MT (SET FLOW-CONTROL, SET SPEED \050or BAUD\051)SH /Times-Italic SF 6120 19872 MT (For acting as a server:)SH /Times-Roman SF 8120 20977 MT (SERVER)SH /Times-Italic SF 6120 22635 MT (For talking to a server:)SH /Times-Roman SF 8120 23740 MT (BYE, FINISH, GET, SEND, REMOTE)SH /Times-Italic SF 6120 25398 MT (Setting nonstandard transmission and file parameters:)SH /Times-Roman SF 8120 26503 MT (SET BLOCK-CHECK, SET DEBUG, SET) 154 W( DELAY, SET FILE, SET INCOMPLETE, SET PARITY, SET)155 W 8120 27608 MT (RETRY;)SH 8120 28713 MT (SET SEND \050or RECEIVE\051 END-OF-LINE, START-OF-PACKET,) 35 W( PACKET-LENGTH, PAUSE, TIMEOUT,)34 W 8120 29818 MT (PADDING)SH /Times-Italic SF 6120 31476 MT (For defining and executing "macros" of commands:)SH /Times-Roman SF 8120 32581 MT (DEFINE, DO)SH /Times-Italic SF 6120 34239 MT (For interrupting transmission:)SH /Times-Roman SF 8120 35344 MT (Control-X, Control-Z, Control-C, Control-E)SH /Times-Italic SF 6120 37002 MT (Getting information:)SH /Times-Roman SF 8120 38107 MT (HELP, STATISTICS, SHOW)SH /Times-Italic SF 6120 39765 MT (Executing command files:)SH /Times-Roman SF 8120 40870 MT (TAKE)SH /Times-Italic SF 6120 42528 MT (For recording the history of a file transfer operation:)SH /Times-Roman SF 8120 43633 MT (LOG TRANSACTIONS)SH /Times-Italic SF 6120 45291 MT (For non-protocol file capture or transmission:)SH /Times-Roman SF 8120 46396 MT (LOG SESSION, TRANSMIT, INPUT, OUTPUT, PAUSE, CLEAR, SCRIPT)SH /Times-Italic SF 6120 48054 MT (For closing log files:)SH /Times-Roman SF 8120 49159 MT (CLOSE)SH /Times-Italic SF 6120 50817 MT (Leaving the program:)SH /Times-Roman SF 8120 51922 MT (EXIT, QUIT)SH 6120 53713 MT (If you have a file called)151 W /Courier SF 16745 XM (KERMIT.INI)SH /Times-Roman SF 23146 XM (in your default or home disk,) 151 W( Kermit will execute an automatic TAKE)152 W 6120 54909 MT (command on it upon initial startup.)300 W /Courier SF 22776 XM (KERMIT.INI)SH /Times-Roman SF 29326 XM (may contain any Kermit commands,) 300 W( for instance SET)299 W 6120 56105 MT (commands, or DEFINEs) 22 W( for macros to configure Kermit to various systems or communications media.)23 W /Times-Italic SF 48097 XM (Note:)SH /Times-Roman SF 50865 XM (Your)SH 6120 57301 MT (particular implementation of Kermit) 156 W( may use a different name for this file, like)155 W /Courier SF 39966 XM (MSKERMIT.INI)SH /Times-Roman SF 47571 XM (for MS-DOS)155 W 6120 58497 MT (Kermit, or)SH /Courier SF 10536 XM (VMSKERMIT.INI)SH /Times-Roman SF 18586 XM (for VAX/VMS Kermit.)SH ES %%Page: 27 28 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (4.4. Summary of Kermit Commands)SH 10 /Times-Italic AF 51775 XM (Page 27)SH 46800 50 8280 5709 UL 14 /Times-Bold AF 8280 8138 MT (4.5. The SEND Command)SH 10 /Times-Roman AF 8280 10256 MT (Syntax:)SH 8280 12648 MT (Sending a single file:)SH /Courier SF 10280 14166 MT (SEND)SH /Times-Italic SF 13280 XM (filespec1)SH /Courier SF 17435 XM ([)SH /Times-Italic SF (filespec2)SH /Courier SF (])SH /Times-Roman SF 8280 16558 MT (Sending multiple files:)SH /Courier SF 10280 18076 MT (SEND)SH /Times-Italic SF 13280 XM (wild-filespec1)SH /Times-Roman SF 8280 20468 MT (The SEND command causes a file or file group to be sent to the other system. There are two forms) SH( of the command,)1 W 8280 21664 MT (depending on whether)126 W /Times-Italic SF 17795 XM (filespec1)SH /Times-Roman SF 21726 XM (contains "wildcard" characters. Use) 126 W( of wildcard characters is the most common)125 W 8280 22860 MT (method of indicating a group of files in a single file) 146 W( specification. For instance if)147 W /Courier SF 43368 XM (FOO.FOR)SH /Times-Roman SF 47965 XM (is a single file, a)147 W 8280 24056 MT (FORTRAN program named FOO, then)SH /Courier SF 24223 XM (*.FOR)SH /Times-Roman SF 27473 XM (might be a group of FORTRAN programs.)SH /Times-Bold SF 10280 26334 MT (Sending a File Group --)SH /Times-Roman SF 8280 28726 MT (If)SH /Times-Italic SF 9226 XM (filespec1)SH /Times-Roman SF 13061 XM (contains wildcard characters then all matching files) 30 W( will be sent, in directory-listing order by name. If a)29 W 8280 29922 MT (file can't be opened for read access, it will be skipped.)SH /Times-Bold SF 10280 32200 MT (Sending a Single File --)SH /Times-Roman SF 8280 34592 MT (If)SH /Times-Italic SF 9421 XM (filespec1)SH /Times-Roman SF 13451 XM (does not contain any wildcard) 225 W( characters, then the single file specified by)226 W /Times-Italic SF 45736 XM (filespec1)SH /Times-Roman SF 49767 XM (will be sent.)226 W 8280 35788 MT (Optionally,)SH /Times-Italic SF 13080 XM (filespec2)SH /Times-Roman SF 16907 XM (may be used to specify the name under which the file will arrive at the target system;)22 W /Times-Italic SF 51525 XM (filespec2)SH /Times-Roman SF 8280 36984 MT (is not parsed or validated locally in any way. If)SH /Times-Italic SF 27610 XM (filespec2)SH /Times-Roman SF 31415 XM (is not specified, the file will be sent with its own name.)SH /Times-Bold SF 10280 39262 MT (SEND Command General Operation --)SH /Times-Roman SF 8280 41654 MT (Files will be) 2 W( sent with their filename and filetype \050for instance)3 W /Courier SF 33502 XM (FOO.BAR)SH /Times-Roman SF (, no device or directory field, no generation)3 W 8280 42850 MT (number or attributes\051. If communication line parity is being) 154 W( used \050see SET PARITY\051, the sending Kermit will)153 W 8280 44046 MT (request that the other Kermit accept a special kind of prefix notation for binary files.) 68 W( This) 388 W( is an advanced feature,)69 W 8280 45242 MT (and not all Kermits have it; if) 182 W( the other Kermit does not agree to use this feature, binary files cannot be sent)181 W 8280 46438 MT (correctly.)SH 8280 48830 MT (The sending Kermit will also ask the) 140 W( other Kermit whether it can handle a special prefix encoding for repeated)141 W 8280 50026 MT (characters. If) 758 W( it can, then files with long strings) 254 W( of repeated characters will be transmitted very efficiently.)253 W 8280 51222 MT (Columnar data, highly indented text, and binary files are the major beneficiaries of this technique.)SH /Times-Bold SF 10280 53500 MT (SEND Remote Operation --)SH /Times-Roman SF 8280 55892 MT (If you are running Kermit remotely \050for instance, from a microcomputer\051, you should "escape) 86 W( back" to your local)87 W 8280 57088 MT (Kermit within a reasonable amount) 90 W( of time and give the RECEIVE command. Don't take more than a minute or)89 W 8280 58284 MT (two to complete the switch, or Kermit may "time out" and give up \050in that case, you'll have to CONNECT back) 51 W( to)52 W 8280 59480 MT (the remote system and reissue the SEND command\051.)SH /Times-Bold SF 10280 61758 MT (SEND Local Operation --)SH /Times-Roman SF 8280 64150 MT (If you're running Kermit locally, for) 161 W( instance on a microcomputer, you should have already run Kermit on the)160 W 8280 65346 MT (remote system and issued either a RECEIVE or a SERVER command.)SH 8280 67738 MT (Once you give Kermit the SEND command, the) 119 W( name of each file will be printed on your screen as the transfer)120 W 8280 68934 MT (begins, and information) 68 W( will be displayed to indicate the packet traffic. When the specified operation is complete,)67 W 8280 70130 MT (the program will sound a) 77 W( beep, and the status of the operation will be indicated by a message like OK, Complete,)78 W 8280 71326 MT (Interrupted, or Failed.)SH ES %%Page: 28 29 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 28)SH 12 /Times-Bold AF 29851 XM (Kermit User Guide: Kermit Commands \0504.5\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (If you see many packet retry indications, you) 55 W( are probably suffering from a noisy connection. You may be able to)54 W 6120 9082 MT (cut down on the retransmissions by using SET SEND) 81 W( PACKET-LENGTH to decrease the packet length; this will)82 W 6120 10278 MT (reduce the probability that a given packet will be corrupted by) 84 W( noise, and reduce the time required to retransmit a)83 W 6120 11474 MT (corrupted packet.)SH 6120 13866 MT (If you notice a file being sent which you do) 59 W( not really want to send, you may cancel the operation immediately by)60 W 6120 15062 MT (typing either Control-X or Control-Z.) 80 W( If) 409 W( your are sending a file group, Control-X will cause the current file to be)79 W 6120 16258 MT (skipped, and Kermit will go on to the next file, whereas Control-Z will cancel sending the entire) 73 W( group and return)74 W 6120 17454 MT (you to Kermit-20 command level.)SH 14 /Times-Bold AF 6120 21056 MT (4.6. The RECEIVE Command)SH 10 /Times-Roman AF 6120 23174 MT (Syntax:)SH /Courier SF 9676 XM (RECEIVE [)SH /Times-Italic SF (filespec)SH /Courier SF (])SH /Times-Roman SF 6120 25566 MT (The RECEIVE command) 38 W( tells Kermit to wait for the arrival a file or file group sent by a SEND command from the)37 W 6120 26762 MT (other system.) 134 W( If) 520 W( only one file is being received, you may include the optional)135 W /Times-Italic SF 39390 XM (filespec)SH /Times-Roman SF 42830 XM (as the name to store the)135 W 6120 27958 MT (incoming file under; otherwise, the name is taken) 45 W( from the incoming file header. If the name in the header is not a)44 W 6120 29154 MT (legal file name on the local system, Kermit will attempt to transform it to a legal name.)SH 6120 31546 MT (If an incoming file has the same name as an existing file, Kermit will either overwrite) 1 W( the old file or else try to create)2 W 6120 32742 MT (a new unique name, depending on the setting of FILE WARNING.)SH 6120 35134 MT (If you have SET PARITY, then 8th-bit prefixing will be requested. If the other side cannot do this,) 114 W( binary files)113 W 6120 36330 MT (cannot be transferred correctly. The sending Kermit may also request that repeated characters be compressed.)SH 6120 38722 MT (If an incoming file does not arrive in its entirety, Kermit will normally discard it; it will) 5 W( not appear in your directory.)6 W 6120 39918 MT (You may change this behavior by using the command SET INCOMPLETE KEEP, which will cause as) 31 W( much of the)30 W 6120 41114 MT (file as arrived to be saved in your directory.)SH /Times-Bold SF 8120 43392 MT (RECEIVE Remote Operation --)SH /Times-Roman SF 6120 45784 MT (If your are running Kermit remotely, you should escape back to your local Kermit and give the SEND command.)85 W 6120 46980 MT (You should do this within about two minutes, or) 93 W( the protocol may time out and give up; if this happens, you can)92 W 6120 48176 MT (CONNECT back to the remote system and reissue the RECEIVE command.)SH /Times-Bold SF 8120 50454 MT (RECEIVE Local Operation --)SH /Times-Roman SF 6120 52846 MT (If you are running Kermit) 11 W( locally, you should already have issued a SEND command to the remote Kermit, and then)12 W 6120 54042 MT (escaped back to) 1 W( DEC-20 Kermit \050you can not issue a RECEIVE command to a Kermit server, you must use the GET)SH 6120 55238 MT (command for that\051.)SH 6120 57630 MT (As files arrive, their names will be shown on your screen, along with a continuous display the packet traffic.)SH 6120 60022 MT (If a file begins to arrives that you don't really) 60 W( want, you can attempt to cancel it by typing Control-X; this sends a)61 W 6120 61218 MT (cancellation request to the remote Kermit. If the remote Kermit understands this request) 15 W( \050not all implementations of)14 W 6120 62414 MT (Kermit support this feature\051, it will comply; otherwise it will continue to send. If a file group is) 25 W( being sent, you can)26 W 6120 63610 MT (request the entire group be cancelled by typing Control-Z.)SH ES %%Page: 29 30 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (4.7. The GET Command)SH 10 /Times-Italic AF 51775 XM (Page 29)SH 46800 50 8280 5709 UL 14 /Times-Bold AF 8280 8138 MT (4.7. The GET Command)SH 10 /Times-Roman AF 8280 10256 MT (Syntax:)SH /Courier SF 11586 XM (GET [)SH /Times-Italic SF (remote-filespec)SH /Courier SF (])SH /Times-Roman SF 8280 12648 MT (The GET command requests a Kermit)90 W /Times-Italic SF 24317 XM (server)SH /Times-Roman SF 27156 XM (to send the file or file group specified by)89 W /Times-Italic SF 44482 XM (remote-filespec)SH /Times-Roman SF (. Note) 428 W( the)89 W 8280 13844 MT (distinction between the RECEIVE) 23 W( and GET commands: RECEIVE instructs the program to wait passively, whereas)24 W 8280 15040 MT (GET actively sends a request to a server.)SH 8280 17432 MT (The remote filespec is any character sequence that can be a legal file specification) 77 W( for the remote system; it is not)76 W 8280 18628 MT (parsed or validated locally. As) 71 W( files arrive, their names will be displayed on your screen, along with a continuous)72 W 8280 19824 MT (indication of the packet traffic. As in the RECEIVE command, you may type Control-X to request) 47 W( that the current)46 W 8280 21020 MT (incoming file be cancelled, Control-Z to request that the entire incoming batch be cancelled.)SH /Times-Italic SF 8280 23412 MT (Optional Syntax:)101 W /Times-Roman SF 15537 XM (If you are requesting a single file, you may type) 101 W( the GET command without a filespec. In that)102 W 8280 24608 MT (case, Kermit programs that implement the optional GET syntax) 159 W( will prompt you for the remote filespec on the)158 W 8280 25804 MT (subsequent line, and the name to store it under when it arrives on the line after that:)SH /Courier SF 10680 27459 MT (Kermit-MS>get)SH 1800 50 16680 27659 UL 11280 28490 MT (Remote Source File: aux.txt)SH 4200 50 23280 28690 UL 11280 29521 MT (Local Destination File: auxfile.txt)SH 6600 50 25680 29721 UL 14 /Times-Bold AF 8280 33123 MT (4.8. The SERVER Command)SH 10 /Times-Roman AF 8280 35241 MT (Syntax:)SH /Courier SF 11586 XM (SERVER)SH /Times-Roman SF 8280 37633 MT (The SERVER command instructs Kermit to cease taking commands) 109 W( from the keyboard and to receive all further)110 W 8280 38829 MT (instructions in the form of Kermit packets from another system.) 208 W( The) 664 W( other Kermit must have commands for)207 W 8280 40025 MT (communicating with remote servers; these include GET, SEND, FINISH, and BYE.)SH 8280 42417 MT (After issuing this command, return to the "client" system and) 110 W( issue SEND, GET, BYE, FINISH, or other server-)111 W 8280 43613 MT (directed commands from there. If your local Kermit does not have a BYE command, then) 48 W( it does not have the full)47 W 8280 44809 MT (ability to communicate with a Kermit server and you should not put the remote Kermit into SERVER mode. If your)11 W 8280 46005 MT (local Kermit does have a BYE command, use it to shut down and log out the Kermit server) 23 W( when you are done with)22 W 8280 47201 MT (it.)SH 8280 49593 MT (Any nonstandard parameters should be selected with SET commands before putting Kermit in server mode.)SH 14 /Times-Bold AF 8280 53195 MT (4.9. The BYE Command)SH 10 /Times-Roman AF 8280 55313 MT (Syntax:)SH /Courier SF 11586 XM (BYE)SH /Times-Roman SF 8280 57705 MT (When running) 61 W( talking to a Kermit server, use the BYE command to shut down the server and, if the server is on a)62 W 8280 58901 MT (timesharing system, also log out the job. This will also close any open log files and exit from the local Kermit.)SH 14 /Times-Bold AF 8280 62503 MT (4.10. The FINISH Command)SH 10 /Times-Roman AF 8280 64621 MT (Syntax:)SH /Courier SF 11586 XM (FINISH)SH /Times-Roman SF 8280 67013 MT (When running) 8 W( as a local Kermit talking to a remote Kermit server use the FINISH command to shut down the server)7 W 8280 68209 MT (without logging out the remote job, so that you can CONNECT back to it.)SH ES %%Page: 30 31 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 30)SH 12 /Times-Bold AF 29251 XM (Kermit User Guide: Kermit Commands \0504.11\051)SH 46800 50 6120 5709 UL 14 SS 6120 8138 MT (4.11. The REMOTE Command)SH 10 /Times-Roman AF 6120 10256 MT (Syntax:)SH /Courier SF 9426 XM (REMOTE)SH /Times-Italic SF 13276 XM (command)SH /Times-Roman SF 6120 12648 MT (When talking to a remote Kermit server, use the REMOTE) 132 W( command to request special functions of the remote)133 W 6120 13844 MT (server. If) 430 W( the server does not understand the command or) 90 W( offer the requested service \050all of these commands and)89 W 6120 15040 MT (services are optional features of the Kermit protocol\051, it will reply with a message like "Unknown Kermit) 115 W( server)116 W 6120 16236 MT (command". If) 562 W( it does) 156 W( understand, it will send the results back, and they will be displayed on the screen. The)155 W 6120 17432 MT (REMOTE commands include:)SH 6120 19223 MT (REMOTE CWD [)SH /Times-Italic SF (directory)SH /Times-Roman SF (])SH 8120 20328 MT (Change Working Directory. If no directory name is provided, the server will change) 74 W( to the default directory.)73 W 8120 21433 MT (Otherwise, you will be prompted for a password,) 225 W( and the server will attempt to change to the specified)226 W 8120 22538 MT (directory. If) 354 W( access is not granted, the server will provide a message to that effect. If) 52 W( the remote system does)51 W 8120 23643 MT (not require a password for changing directories \050UNIX) 119 W( is an example\051, then you can simply type a carriage)120 W 8120 24748 MT (return in response to the password prompt.)SH 6120 26325 MT (REMOTE DELETE)SH /Times-Italic SF 14508 XM (filespec)SH /Times-Roman SF 8120 27430 MT (Delete the specified file or files. The names of the files that are deleted should be displayed on your screen.)SH 6120 29007 MT (REMOTE DIRECTORY [)SH /Times-Italic SF (filespec)SH /Times-Roman SF (])SH 8120 30112 MT (The names of the files that match the given file specification will be) 59 W( displayed on your screen, possibly along)58 W 8120 31217 MT (with additional information about file sizes and dates.) 17 W( If) 285 W( no file specification is given, all files from the current)18 W 8120 32322 MT (directory will be listed.)SH 6120 33899 MT (REMOTE SPACE [)SH /Times-Italic SF (directory)SH /Times-Roman SF (])SH 8120 35004 MT (Information about disk usage in the current remote) 50 W( directory -- quota, current storage, or amount of remaining)51 W 8120 36109 MT (free space -- is displayed on your screen.)SH 6120 37686 MT (REMOTE HELP)SH 8120 38791 MT (A list of available server functions is displayed.)SH 6120 40368 MT (REMOTE HOST [)SH /Times-Italic SF (command)SH /Times-Roman SF (])SH 8120 41473 MT (The given command is passed to the server's host) 25 W( command processor, and the resulting output is displayed on)24 W 8120 42578 MT (your screen.)SH 6120 44155 MT (REMOTE KERMIT [)SH /Times-Italic SF (command)SH /Times-Roman SF (])SH 8120 45260 MT (The given command, which is expressed in the server Kermit's own interactive-mode) 165 W( command syntax, is)164 W 8120 46365 MT (passed to the server for execution. This is useful for changing settings, logging, and other functions.)SH 6120 47942 MT (REMOTE TYPE)SH /Times-Italic SF 13231 XM (filespec)SH /Times-Roman SF 8120 49047 MT (The contents of the specified file is displayed on your screen.)SH 6120 50624 MT (REMOTE WHO [)SH /Times-Italic SF (username)SH /Times-Roman SF (])SH 8120 51729 MT (List users, or a specified user, logged in on the server's system.)SH 14 /Times-Bold AF 6120 55331 MT (4.12. Local Commands)SH 10 /Times-Roman AF 6120 57449 MT (Syntax:)SH /Courier SF 9426 XM ([LOCAL])SH /Times-Italic SF 14226 XM (command)SH /Times-Roman SF 6120 59841 MT (Execute the specified command on the local system -- on the) 99 W( system where Kermit to which your are typing this)100 W 6120 61037 MT (command is running.) 46 W( These) 340 W( commands provide some local file management capability without having to leave the)45 W 6120 62233 MT (Kermit program, which is particularly useful on microcomputers. On most systems, the LOCAL) 104 W( prefix for these)105 W 6120 63429 MT (commands can be omitted.)SH 6120 65220 MT (CWD [)SH /Times-Italic SF (directory)SH /Times-Roman SF (])SH 8120 66325 MT ("Change Working Directory" to the specified directory.)SH 6120 67902 MT (DELETE)SH /Times-Italic SF 10147 XM (filespec)SH /Times-Roman SF 8120 69007 MT (Delete the specified file or files.)SH 6120 70584 MT (DIRECTORY [)SH /Times-Italic SF (filespec)SH /Times-Roman SF (])SH 8120 71689 MT (Provide a directory listing of the specified files.)SH ES %%Page: 31 32 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (4.12. Local Commands)SH 10 /Times-Italic AF 51775 XM (Page 31)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (SPACE)SH 10280 8991 MT (Display local disk usage and/or free space.)SH 8280 10568 MT (RUN)SH /Times-Italic SF 10641 XM (filespec)SH /Times-Roman SF 13946 XM ([)SH /Times-Italic SF (operands)SH /Times-Roman SF (])SH 10280 11673 MT (Run the indicated program with the supplied command-line operands.)SH 8280 13250 MT (PUSH Invoke) 250 W( the local system command interpreter in such a way that it can return \050or) 104 W( "pop" or "exit"\051 back to)105 W 10280 14355 MT (Kermit.)SH 8280 16146 MT (Some Kermit programs may provide commands for these or) 16 W( other functions in the syntax of their own system, when)15 W 8280 17342 MT (this would cause no confusion. For instance, CP/M Kermit may use ERA in place of LOCAL DELETE.)SH 14 /Times-Bold AF 8280 20944 MT (4.13. The CONNECT Command)SH 10 /Times-Italic AF 8280 23062 MT (LOCAL ONLY)SH /Times-Roman SF 14393 XM (-- Syntax:)SH /Courier SF 18615 XM (CONNECT [)SH /Times-Italic SF (terminal-designator)SH /Courier SF (])SH /Times-Roman SF 8280 25454 MT (Establish a terminal connection to the system at the other end of the communication line.) 26 W( On) 304 W( a microcomputer, this)27 W 8280 26650 MT (is normally the serial port. On a mainframe, you will have to specify a terminal line number or other) 114 W( identifier,)113 W 8280 27846 MT (either in the CONNECT command itself, or in a SET LINE) 55 W( command. Get back to the local Kermit by typing the)56 W 8280 29042 MT (escape character followed by a single character "command". Several single-character commands are possible:)SH /Courier SF 9280 30833 MT (C)SH /Times-Roman SF 11280 XM (Close the connection and return to the local Kermit.)SH /Courier SF 9280 31938 MT (S)SH /Times-Roman SF 11280 XM (Show status of the connection.)SH /Courier SF 9280 33043 MT (B)SH /Times-Roman SF 11280 XM (Send a BREAK signal.)SH /Courier SF 9280 34148 MT (0)SH /Times-Roman SF 11280 XM (\050zero\051 Send a NUL \0500\051 character.)SH /Courier SF 9280 35253 MT (F)SH /Times-Roman SF 11280 XM (Copy the current screen into a disk file.)SH /Courier SF 9280 36358 MT (D)SH /Times-Roman SF 11280 XM (Drop the line, hangup the modem.)SH /Courier SF 9280 37463 MT (P)SH /Times-Roman SF 11280 XM (Push to the local system command processor without breaking the connection.)SH /Courier SF 9280 38568 MT (Q)SH /Times-Roman SF 11280 XM (Quit logging session transcript.)SH /Courier SF 9280 39673 MT (R)SH /Times-Roman SF 11280 XM (Resume logging session transcript.)SH /Courier SF 9280 40778 MT (?)SH /Times-Roman SF 11280 XM (List all the possible single-character arguments.)SH /Courier SF 9280 41883 MT (^])SH /Times-Roman SF 10730 XM (\050or whatever you have set the escape character to be\051)SH 11280 42988 MT (Typing the escape character twice sends one copy of it to the connected host.)SH 8280 44779 MT (You can use the SET) 37 W( ESCAPE command to define a different escape character, and SET PARITY, SET DUPLEX,)38 W 8280 45975 MT (SET FLOW-CONTROL, SET HANDSHAKE to establish or change those parameters.)SH 14 /Times-Bold AF 8280 49577 MT (4.14. HELP)SH 10 /Times-Roman AF 8280 51695 MT (Syntax:)SH /Courier SF 11586 XM (The HELP Command)SH /Times-Roman SF 8280 54087 MT (Typing HELP alone prints a brief summary of Kermit and its commands, and possibly instructions) 118 W( for obtaining)117 W 8280 55283 MT (more detailed help on particular topics. Most Kermit implementations also allow the use) 50 W( of "?" within a command)51 W 8280 56479 MT (to produce a short help message.)SH 14 /Times-Bold AF 8280 60081 MT (4.15. The TAKE Command)SH 10 /Times-Roman AF 8280 62199 MT (Syntax:)SH /Courier SF 11586 XM (TAKE)SH /Times-Italic SF 14586 XM (filespec)SH /Times-Roman SF 8280 64591 MT (Execute Kermit commands from the specified file. The) 169 W( file may contain contain any valid Kermit commands,)168 W 8280 65787 MT (including other TAKE commands.)SH ES %%Page: 32 33 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 32)SH 12 /Times-Bold AF 29251 XM (Kermit User Guide: Kermit Commands \0504.16\051)SH 46800 50 6120 5709 UL 14 SS 6120 8138 MT (4.16. The EXIT and QUIT Commands)SH 10 /Times-Roman AF 6120 10256 MT (Exit from Kermit.)SH /Courier SF 13814 XM (QUIT)SH /Times-Roman SF 16464 XM (is a synonym for EXIT.)SH 14 /Times-Bold AF 6120 13858 MT (4.17. The SET Command)SH 10 /Times-Roman AF 6120 15976 MT (Syntax:)SH /Courier SF 9426 XM (SET)SH /Times-Italic SF 11826 XM (parameter)SH /Courier SF 16592 XM ([)SH /Times-Italic SF (option)SH /Courier SF (] [)SH /Times-Italic SF (value)SH /Courier SF (])SH /Times-Roman SF 6120 18368 MT (Establish or modify various parameters for file transfer or terminal connection.)SH 6120 20760 MT (When a file transfer operation begins, the two Kermits automatically exchange special) 117 W( initialization messages, in)118 W 6120 21956 MT (which each program) 262 W( provides the other with certain information about itself. This information includes the)261 W 6120 23152 MT (maximum packet) 31 W( size it wants to receive, the timeout interval it wants the other Kermit to use, the number and type)32 W 6120 24348 MT (of padding characters it needs, the end-of-line character it needs to terminate each packet \050if any\051,) 67 W( the block check)66 W 6120 25544 MT (type, the desired prefixes) 102 W( for control characters, characters with the "high bit" set, and repeated characters. Each)103 W 6120 26740 MT (Kermit program has its) 207 W( own preset "default" values for these parameters, and you normally need not concern)206 W 6120 27936 MT (yourself with them. You can examine their values with the SHOW command; the SET command is provided) 111 W( to)112 W 6120 29132 MT (allow you to change them in order to adapt to unusual conditions.)SH 6120 31524 MT (The following parameters may be SET:)SH 12287 33315 MT (BAUD)SH 15620 XM (Set the speed of the current communications port)SH 8009 34420 MT (BLOCK-CHECK)SH 15620 XM (Packet transmission error detection method)SH 11676 35525 MT (DEBUG)SH 15620 XM (Mode or log file)SH 11732 36630 MT (DELAY)SH 15620 XM (How long to wait before starting to send)SH 11176 37735 MT (DUPLEX)SH 15620 XM (For terminal connection, full \050remote echo\051 or half \050local echo\051)SH 13065 38840 MT (END)SH 15620 XM (Packet termination character \050normally CR\051)SH 11397 39945 MT (ESCAPE)SH 15620 XM (Character for terminal connection)SH 13009 41050 MT (FILE)SH 15620 XM (For setting file parameters like name conversion and byte size)SH 7232 42155 MT (FLOW-CONTROL)SH 15620 XM (Selecting flow control method, like XON/XOFF)SH 8899 43260 MT (HANDSHAKE)SH 15620 XM (For turning around half duplex communication line)SH 13231 44365 MT (IBM)SH 15620 XM (Set parameters for IBM mainframe linemode connection)SH 8787 45470 MT (INCOMPLETE)SH 15620 XM (What to do with an incomplete file)SH 13065 46575 MT (KEY)SH 15620 XM (Establish a key redefinition or keyboard macro)SH 8732 47680 MT (LOCAL-ECHO)SH 15620 XM (Specify who echoes during terminal connection)SH 12843 48785 MT (LINE)SH 15620 XM (Terminal line to use for terminal connection or file transfer)SH 11287 49890 MT (MODEM)SH 15620 XM (Modem type or characteristics)SH 11509 50995 MT (PARITY)SH 15620 XM (Character parity to use)SH 12564 52100 MT (PORT)SH 15620 XM (For switching communication ports)SH 11119 53205 MT (PROMPT)SH 15620 XM (For changing the program's command prompt)SH 10898 54310 MT (RECEIVE)SH 15620 XM (Various parameters for receiving files)SH 11842 55415 MT (RETRY)SH 15620 XM (How many times to retry a packet before giving up)SH 12509 56520 MT (SEND)SH 15620 XM (Various parameters for sending files)SH 12064 57625 MT (SPEED)SH 15620 XM (Synomym for BAUD.)SH 9954 58730 MT (TERMINAL)SH 15620 XM (Parameters for terminal emulation)SH 12009 59835 MT (TIMER)SH 15620 XM (Enable/disable timeouts)SH 10288 60940 MT (WARNING)SH 15620 XM (Filename collision protection)SH 6120 63332 MT (The DEFINE command may be used to compose "macros" by combining SET and possibly other commands.) 55 W( The)358 W 6120 64528 MT (SET commands are now described in detail.)SH ES %%Page: 33 34 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (4.17. The SET Command)SH 10 /Times-Italic AF 51775 XM (Page 33)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (SET BAUD)SH 10 /Times-Roman AF 8280 9418 MT (Set or change the baud rate) 6 W( \050approximate translation: transmission speed in bits per second\051 on the currently selected)7 W 8280 10614 MT (communications device. Ten bits per second) 53 W( is usually equivalent to one character per second; 300 baud = 30 cps.)52 W 8280 11810 MT (The way of specifying the baud rate) 6 W( varies from system to system; in most cases, the actual number \050such as 1200 or)7 W 8280 13006 MT (9600\051 is typed. Systems that do not provide this command generally) 81 W( expect that the speed of the line has already)80 W 8280 14202 MT (been set appropriately outside of Kermit. Common values are 300, 1200, 2400, 4800, 9600, 19200.)SH 12 /Times-Bold AF 8280 16790 MT (SET BLOCK-CHECK {1, 2, 3})SH 10 /Times-Roman AF 8280 18204 MT (Kermit normally uses a 1-character block check, or "checksum",) 7 W( on each packet. The sender of the packet computes)8 W 8280 19400 MT (the block check based on the other characters in the packet, and the receiver recomputes it the same way.) 64 W( If) 376 W( these)63 W 8280 20596 MT (quantities agree, the packet is accepted and) 168 W( transmission proceeds. If they disagree, the packet is rejected and)169 W 8280 21792 MT (retransmission is requsted.)SH 8280 24184 MT (However, the block check is not a foolproof method of error detection. The normal single-character Kermit) 69 W( block)68 W 8280 25380 MT (check is only a 6-bit quantity \050the low order 8 bits of the) 61 W( arithmetic sum folded upon itself\051. With only six bits of)62 W 8 SS 22813 26231 MT (6)SH 10 SS 8280 26576 MT (accuracy, the chances are one in 2)150 W 23613 XM (-- that is, 1/64 -- that an) 150 W( error can occur which will not be detected in the)149 W 8280 27772 MT (checksum, assuming that all errors are equally likely \050they aren't\051.)SH 8280 30164 MT (You can decrease the probability that an error can slip through, at) 60 W( the expense of transmission efficiency, by using)61 W 8280 31360 MT (the SET BLOCK-CHECK command to select more rigorous block check methods. Note) 28 W( that all three methods will)27 W 8280 32556 MT (detect any single-bit error, or any error in an odd number of bits. The options are:)SH 8280 34347 MT (1-CHARACTER-CHECKSUM:)SH 10280 35452 MT (The normal single-character 6-bit checksum.)SH 8280 37029 MT (2-CHARACTER-CHECKSUM:)SH 10280 38134 MT (A 2-character, 12-bit checksum. Reduces) 73 W( the probability of an error going undetected to 1/4096, but adds an)74 W 10280 39239 MT (extra character to each packet.)SH 8280 40816 MT (3-CHARACTER-CRC:)SH 10280 41921 MT (A 3-character, 16-bit Cyclic Redundancy Check, CCITT format.) 96 W( In) 443 W( addition to errors in any odd number of)97 W 10280 43026 MT (bits, this method detects double bit errors, all error bursts of length 16 or less, and more than 99.99%) 107 W( of all)106 W 10280 44131 MT (possible longer bursts. Adds two extra characters to each packet.)SH 8280 45922 MT (The single character checksum has proven to be quite) 424 W( adequate in practice, much more effective than)425 W 8280 47118 MT (straightforward analysis would indicate, since all errors are)33 W /Times-Italic SF 32455 XM (not)SH /Times-Roman SF 34016 XM (equally likely, and a simple) 33 W( checksum is well suited)32 W 8280 48314 MT (to catching the kinds of errors) 58 W( that are typical of telecommunication lines. The other methods should be requested)59 W 8280 49510 MT (only when the connection is)94 W /Times-Italic SF 20221 XM (very)SH /Times-Roman SF 22286 XM (noisy and/or when sending binary files,) 94 W( or when using "long packets" \050see SET)93 W 8280 50706 MT (RECEIVE PACKET-LENGTH\051.)SH 8280 53098 MT (Note that the 2- and 3-character block checks) 63 W( are not available in all versions of Kermit; if the other Kermit is not)64 W 8280 54294 MT (capable of performing) 144 W( the higher-precision block checks, the transfer will automatically use the standard single-)143 W 8280 55490 MT (character method.)SH 12 /Times-Bold AF 8280 58078 MT (SET DEBUG {ON, OFF})SH 10 /Times-Roman AF 8280 59492 MT (Syntax:)SH /Courier SF 11586 XM (SET DEBUG)SH /Times-Italic SF 17586 XM (options)SH /Times-Roman SF 8280 61884 MT (Record debugging information, either on your terminal or in a file. Options are:)SH 9280 63675 MT (ON)SH 11280 XM (Turn on debugging.)SH 9280 65252 MT (OFF)SH 11280 XM (Don't display debugging) 84 W( information \050this is the default\051. If debugging was in effect, turn it off and close)85 W 11280 66357 MT (any log file.)SH 8280 68148 MT (or possibly others, like STATES, PACKETS, SESSION, etc., to select logging of different phenomena. Some)172 W 8280 69344 MT (Kermit programs may control debugging by use of the LOG DEBUG command.)SH ES %%Page: 34 35 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 34)SH 12 /Times-Bold AF 29251 XM (Kermit User Guide: Kermit Commands \0504.17\051)SH 46800 50 6120 5709 UL 6120 8004 MT (SET DELAY)SH 10 /Times-Roman AF 6120 9418 MT (Syntax:)SH /Courier SF 9426 XM (SET DELAY)SH /Times-Italic SF 15426 XM (number)SH /Times-Roman SF 6120 11810 MT (Specify how many seconds to wait before sending the first packet after a SEND command. Use when remote and)66 W 6120 13006 MT (SENDing files back to) 69 W( your local Kermit. This gives you time to "escape" back and issue a RECEIVE command.)68 W 6120 14202 MT (The normal delay is 5 seconds. In local mode or server mode, Kermit does not delay before sending the first packet.)SH 12 /Times-Bold AF 6120 16790 MT (SET DUPLEX)SH 10 /Times-Roman AF 6120 18204 MT (Syntax:)SH /Courier SF 9426 XM (SET DUPLEX {FULL, HALF})SH /Times-Roman SF 6120 20596 MT (For use when CONNECTed to a remote system. The keyword choices are FULL and HALF.) 111 W( FULL) 474 W( means the)112 W 6120 21792 MT (remote system echoes the characters you type, HALF means the local) 5 W( system echoes them. FULL is the default, and)4 W 6120 22988 MT (is used by most hosts.) 58 W( HALF) 367 W( is necessary when connecting to IBM mainframes. Half duplex is also called "local)59 W 6120 24184 MT (echo"; in some Kermits, use SET LOCAL-ECHO ON instead of SET DUPLEX HALF.)SH 12 /Times-Bold AF 6120 26772 MT (SET ESCAPE)SH 10 /Times-Roman AF 6120 28186 MT (Syntax:)SH /Courier SF 9426 XM (SET ESCAPE)SH /Times-Italic SF 16026 XM (character)SH /Times-Roman SF 6120 30578 MT (Specify or change the) 59 W( character you want to use to "escape" from remote connections back to Kermit. This would)58 W 6120 31774 MT (normally be a character you don't expect to be using on the) 27 W( remote system, perhaps a control character like)28 W /Courier SF 49742 XM (^\134)SH /Times-Roman SF (,)SH /Courier SF 51470 XM (^])SH /Times-Roman SF (,)SH /Courier SF 6120 32970 MT (^^)SH /Times-Roman SF (, or)102 W /Courier SF 9107 XM (^_)SH /Times-Roman SF (. Most) 454 W( versions of Kermit use one of these by default. After you type the escape character,) 102 W( you must)101 W 6120 34166 MT (follow it by a single-character "argument", such as) 147 W( "C" for Close Connection. The arguments are listed above,)148 W 6120 35362 MT (under the description of the CONNECT command.)SH 12 /Times-Bold AF 6120 37950 MT (SET FILE)SH 10 /Times-Roman AF 6120 39364 MT (Syntax:)SH /Courier SF 9426 XM (SET FILE)SH /Times-Italic SF 14826 XM (parameter value)SH /Times-Roman SF 6120 41756 MT (Establish file-related parameters. Depending on the) 27 W( characteristics of the system, it may be necessary to tell Kermit)26 W 6120 42952 MT (how to fetch an outbound file from the disk, or how to store an incoming file.) 148 W( The) 547 W( actual parameters you can)149 W 6120 44148 MT (specify in this command will vary from system to system, and you) 175 W( should consult the documentation for your)174 W 6120 45344 MT (particular version of Kermit. Some examples would be) 83 W( file type \050text or binary\051, byte size \050PDP-10 architecture\051,)84 W 6120 46540 MT (record length or block size) 3 W( \050record oriented systems\051, end-of-file detection method \050on microcomputers\051, file naming)2 W 6120 47736 MT (conversion option.)SH 6120 50128 MT (This can be a very important command if you intend to transfer) 225 W( binary files, but is normally unecessary for)226 W 6120 51324 MT (transmitting textual files.)SH 12 /Times-Bold AF 6120 53912 MT (SET FLOW-CONTROL)SH 10 /Times-Roman AF 6120 55326 MT (Syntax:)SH /Courier SF 9426 XM (SET FLOW-CONTROL {XON/XOFF,NONE})SH /Times-Roman SF 6120 57718 MT (For communicating with full duplex systems. System-level flow control is not necessary to the Kermit) 13 W( protocol, but)12 W 6120 58914 MT (it can help to use it if the) 20 W( same method is available on both systems. The most common type of flow control on full)21 W 6120 60110 MT (duplex systems is) 144 W( XON/XOFF. When a system's input buffer comes close to being full, it will send an XOFF)143 W 6120 61306 MT (character \050Control-S\051 to request the other system to stop) 15 W( sending. When it has emptied sufficient characters from its)16 W 6120 62502 MT (input buffer, it signals the other system to resume sending by transmitting an) 131 W( XON character \050Control-Q\051. This)130 W 6120 63698 MT (process operates in both) 79 W( directions simultaneously. The options for the Kermit SET FLOW command are usually)80 W 6120 64894 MT (restricted to XON/XOFF and NONE, which is used to disable this feature.)SH ES %%Page: 35 36 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (4.17. The SET Command)SH 10 /Times-Italic AF 51775 XM (Page 35)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (SET HANDSHAKE)SH 10 /Times-Roman AF 8280 9418 MT (Syntax:)SH /Courier SF 11586 XM (SET HANDSHAKE)SH /Times-Italic SF 19986 XM (option)SH /Times-Roman SF 8280 11810 MT (For communicating with half duplex systems.) 84 W( This) 417 W( lets you specify the line turnaround character sent by the half)83 W 8280 13006 MT (duplex host to indicate it has ended its transmission and is granting you permission) 39 W( to transmit. When a handshake)40 W 8280 14202 MT (is set, Kermit will not send a packet until the) 121 W( half duplex host has sent the specified character \050or a timeout has)120 W 8280 15398 MT (occurred\051. The) 250 W( options may include:)SH 10280 17189 MT (NONE)SH 14280 XM (No handshake; undo the effect of any previous SET HANDSHAKE.)SH 10280 18294 MT (XOFF)SH 14280 XM (Control-S.)SH 10280 19399 MT (XON)SH 14280 XM (Control-Q.)SH 10280 20504 MT (BELL)SH 14280 XM (Control-G.)SH 10280 21609 MT (CR)SH 14280 XM (Carriage Return, Control-M.)SH 10280 22714 MT (LF)SH 14280 XM (Linefeed, Control-J.)SH 10280 23819 MT (ESC)SH 14280 XM (Escape, Control-)SH /Courier SF ([)SH /Times-Roman SF (.)SH 8280 25610 MT (Some Kermit programs may require the option to be specified by) 199 W( typing the character literally or entering its)200 W 8280 26806 MT (numeric ASCII value. If you use this command to enable handshaking, you should also SET FLOW OFF.)SH 12 /Times-Bold AF 8280 29394 MT (SET INCOMPLETE)SH 10 /Times-Roman AF 8280 30808 MT (Syntax:)SH /Courier SF 11586 XM (SET INCOMPLETE {KEEP, DISCARD})SH /Times-Roman SF 8280 33200 MT (Specify what to do when a file transfer fails before it is completed.) 95 W( The) 438 W( options are DISCARD \050the default\051 and)94 W 8280 34396 MT (KEEP. If) 716 W( you choose KEEP, then if a transfer fails to complete) 233 W( successfully, you will be able to keep the)234 W 8280 35592 MT (incomplete part that was received.)SH 12 /Times-Bold AF 8280 38180 MT (SET LINE)SH 10 /Times-Roman AF 8280 39594 MT (Syntax:)SH /Courier SF 11586 XM (SET LINE [)SH /Times-Italic SF (terminal-designator)SH /Courier SF (])SH /Times-Roman SF 8280 41986 MT (Specify the terminal line to use for file transfer or CONNECT. This command is found on mainframe) 122 W( Kermits,)121 W 8280 43182 MT (which normally run in "remote mode" using) 74 W( their own controlling terminal for file transfer. Specifying a separate)75 W 8280 44378 MT (line puts the program in "local mode." If no line is specified,) 29 W( revert to the job's controlling terminal, i.e. go back to)28 W 8280 45574 MT ("remote mode.")SH 12 /Times-Bold AF 8280 48162 MT (SET PORT)SH 10 /Times-Roman AF 8280 49576 MT (Syntax:)SH /Courier SF 11586 XM (SET PORT)SH /Times-Italic SF 16986 XM (terminal-designator)SH /Times-Roman SF 8280 51968 MT (Specify the communications port for file transfer or CONNECT. This command is found on) 224 W( microcomputer)225 W 8280 53164 MT (Kermits that run in "local" mode. SET PORT does) 35 W( not change the remote/local status but simply selects a different)34 W 8280 54360 MT (port for local operation.)SH 12 /Times-Bold AF 8280 56948 MT (SET PARITY)SH 10 /Times-Roman AF 8280 58362 MT (Syntax:)SH /Courier SF 11586 XM (SET PARITY {EVEN, ODD, MARK, SPACE, NONE})SH /Times-Roman SF 8280 60754 MT (Parity is a technique used by) 56 W( communications equipment for detecting errors on a per-character basis; the "8th bit")57 W 8280 61950 MT (of each character acts as a check bit for the other seven bits.) 89 W( Kermit) 426 W( uses block checks to detect errors on a per-)88 W 8280 63146 MT (packet basis, and it does not use character parity.) 177 W( However,) 606 W( some systems that Kermit runs on, or equipment)178 W 8280 64342 MT (through which these systems communicate, may be using character parity. If) 136 W( Kermit does not know about this,)135 W 8280 65538 MT (arriving data will have been modified and the block check will appear to be wrong, and packets will be rejected.)SH 8280 67930 MT (If parity is being used) 20 W( on the communication line, you must inform both Kermits, so the desired parity can be added)21 W 8280 69126 MT (to outgoing characters, and stripped from incoming ones. SET PARITY should be used) 106 W( for communicating with)105 W 8280 70322 MT (hosts that require character parity \050IBM mainframes are typical) 12 W( examples\051 or through devices or networks \050like GTE)13 W 8280 71518 MT (TELENET\051 that add parity to characters that pass through them. Both Kermits should be) 3 W( set to the same parity. The)2 W ES %%Page: 36 37 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 36)SH 12 /Times-Bold AF 29251 XM (Kermit User Guide: Kermit Commands \0504.17\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (specified parity is used both for terminal connection \050CONNECT\051 and file transfer \050SEND, RECEIVE, GET\051.)SH 6120 10278 MT (The choices for SET PARITY are:)SH 7120 12069 MT (NONE)SH 10120 XM (\050the default\051 eight data bits and no parity bit.)SH 7120 13506 MT (MARK)SH 10120 14611 MT (seven data bits with the parity bit set to one.)SH 7120 16048 MT (SPACE)SH 10120 17153 MT (seven data bits with the parity bit set to zero.)SH 7120 18590 MT (EVEN)SH 10120 XM (seven data bits with the parity bit set to make the overall parity even.)SH 7120 20027 MT (ODD)SH 10120 XM (seven data bits with the parity bit set to make the overall parity odd.)SH 6120 21818 MT (NONE means no parity processing is done, and the 8th) 33 W( bit of each character can be used for data when transmitting)34 W 6120 23014 MT (binary files.)SH 6120 25406 MT (If you have set parity to ODD, EVEN, MARK,) 97 W( or SPACE, then most versions of Kermit will request that binary)96 W 6120 26602 MT (files be transferred using 8th-bit-prefixing. If the Kermit on the other side knows) 7 W( how to do 8th-bit-prefixing \050this is)8 W 6120 27798 MT (an optional feature of the Kermit protocol, and not all) 62 W( implementations of Kermit have it\051, then binary files can be)61 W 6120 28994 MT (transmitted successfully. If NONE is specified, 8th-bit-prefixing will not be requested.)SH 12 /Times-Bold AF 6120 31582 MT (SET PROMPT)SH 10 /Times-Roman AF 6120 32996 MT (Syntax:)SH /Courier SF 9426 XM (SET PROMPT)SH /Times-Italic SF 16026 XM (string)SH /Times-Roman SF 6120 35388 MT (This allows you to change the program's prompt. This is particularly useful if you are) 22 W( using Kermit to transfer files)23 W 6120 36584 MT (between two systems of the same kind, in which case you can change the prompts of) 31 W( the Kermit programs involved)30 W 6120 37780 MT (to include appropriate distinguishing information.)SH 12 /Times-Bold AF 6120 40368 MT (SET SEND)SH 10 /Courier AF 6120 41780 MT (SET SEND)SH /Times-Italic SF 11520 XM (parameter value)SH /Times-Roman SF 6120 44172 MT (Establish parameters for outgoing packets.) 133 W( This) 518 W( command is generally used to override negotiated values, or to)134 W 6120 45368 MT (establish before negotiation takes place.)SH 6120 47159 MT (END-OF-LINE)SH /Times-Italic SF 12646 XM (character)SH /Times-Roman SF 10120 48264 MT (The ASCII character to be used as a line terminator for outbound packets, if one is required by the) 63 W( other)64 W 10120 49369 MT (system, carriage return by default. You will only have to use) 18 W( this command for systems that require a line)17 W 10120 50474 MT (terminator other than carriage return.)SH 6120 52051 MT (PACKET-LENGTH)SH /Times-Italic SF 14591 XM (number)SH /Times-Roman SF 10120 53156 MT (Maximum packet) 53 W( length to send between 10 and 94 \050decimal\051. Shortening the packets might allow more)52 W 10120 54261 MT (of them to get through through without error on noisy communication lines. Lengthening) 146 W( the packets)147 W 10120 55366 MT (increases the throughput on clean lines. This command can) 87 W( be used to specify a shorter length than the)86 W 10120 56471 MT (one requested by the other Kermit, but not a longer one.)SH 6120 58048 MT (TIMEOUT)SH /Times-Italic SF 10869 XM (number)SH /Times-Roman SF 10120 59153 MT (How many seconds to wait for a packet before trying again. A value of zero means don't time out --) 28 W( wait)27 W 10120 60258 MT (forever.)SH 6120 61835 MT (PAUSE)SH /Times-Italic SF 9537 XM (floating-point-number)SH /Times-Roman SF 10120 62940 MT (How many seconds to) 20 W( pause before sending each data packet. Setting this to a nonzero value may allow a)19 W 10120 64045 MT (slow system enough time to) 129 W( consolidate itself before the next packet arrives. Normally, no per-packet)130 W 10120 65150 MT (pausing is done.)SH 6120 66727 MT (PADDING)SH /Times-Italic SF 10869 XM (number)SH /Times-Roman SF (, PADCHAR)SH /Times-Italic SF 19452 XM (character)SH /Times-Roman SF 10120 67832 MT (How much padding to send before a packet, if the other side) 32 W( needs padding, and what character to use for)33 W 10120 68937 MT (padding. Defaults) 374 W( are no padding, and NUL \0500\051 for the padding character. This command is) 62 W( also handy)61 W 10120 70042 MT (for inserting special characters that may be required by communications equipment.)SH 6120 71619 MT (QUOTE)SH /Times-Italic SF 9758 XM (character)SH ES %%Page: 37 38 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (4.17. The SET Command)SH 10 /Times-Italic AF 51775 XM (Page 37)SH 46800 50 8280 5709 UL /Times-Roman SF 12280 7886 MT (What printable character to use for quoting of control characters, "#" \05043\051 by default.) 37 W( There) 322 W( should be no)36 W 12280 8991 MT (reason to change this.)SH 8280 10568 MT (START-OF-PACKET)SH /Times-Italic SF 17530 XM (character)SH /Times-Roman SF 12280 11673 MT (The start-of-packet character is the) 207 W( only control character used "bare" by the Kermit protocol. It is)206 W 12280 12778 MT (Control-A by default. If a bare Control-A causes problems) 11 W( for your communication hardware or software,)12 W 12280 13883 MT (you can use this command to select a different control character) 59 W( to mark the start of a packet. You must)58 W 12280 14988 MT (also issue the reciprocal) 153 W( command \050SET RECEIVE START-OF-PACKET\051 to the Kermit on the other)154 W 12280 16093 MT (system \050providing it has such a command\051.)SH 12 /Times-Bold AF 8280 18681 MT (SET RECEIVE)SH 10 /Times-Roman AF 8280 20095 MT (Syntax:)SH /Courier SF 11586 XM (SET RECEIVE)SH /Times-Italic SF 18786 XM (parameter value)SH /Times-Roman SF 8280 22487 MT (Parameters to request or expect for incoming packets, as follows:)SH 8280 24278 MT (END-OF-LINE)SH /Times-Italic SF 14806 XM (character)SH /Times-Roman SF 12280 25383 MT (Carriage return \05015\051 by default.)SH 8280 26960 MT (PACKET-LENGTH)SH /Times-Italic SF 16751 XM (number)SH /Times-Roman SF 12280 28065 MT (Maximum length packet for the other side to send, decimal number, between) 69 W( 10 and 94, decimal. Some)68 W 12280 29170 MT (Kermit programs also support a "long) 47 W( packet" protocol extension for improved file transfer efficiency. If)48 W 12280 30275 MT (you specify a value greater than 94 \050and normally less than 1000 or 2000\051, then the two Kermits will)142 W 12280 31380 MT (attempt to negotiate the use of long packets in) 60 W( the receiver's direction. If the negotiation is unsuccessful)61 W 12280 32485 MT (\050e.g. because the sending Kermit does not support long packets\051, then ordinary packets will be) 202 W( used)201 W 12280 33590 MT (automatically.)SH 8280 35167 MT (TIMEOUT)SH /Times-Italic SF 13029 XM (number)SH /Times-Roman SF 12280 36272 MT (How many seconds the other Kermit should wait for a packet before asking for retransmission.)SH 8280 37849 MT (PAUSE)SH /Times-Italic SF 11697 XM (floating-point-number)SH /Times-Roman SF 12280 38954 MT (How many seconds to pause before acknowledging a packet.) 109 W( Setting) 470 W( this to a nonzero value will slow)110 W 12280 40059 MT (down the rate at which data packets arrive, which may be necessary for) 13 W( systems that have "sensitive" front)12 W 12280 41164 MT (ends and cannot accept input at a high rate.)SH 8280 42741 MT (PADDING)SH /Times-Italic SF 13029 XM (number)SH /Times-Roman SF (, PADCHAR)SH /Times-Italic SF 21612 XM (character)SH /Times-Roman SF 12280 43846 MT (How many padding characters to request before each) 120 W( incoming packet, and what the padding character)119 W 12280 44951 MT (should be. No Kermits) 13 W( are known to need padding, and if one did, it would request it without your having)14 W 12280 46056 MT (to tell it to do so. This command would only be necessary, therefore, under very unusual circumstances.)SH 8280 47633 MT (QUOTE)SH /Times-Italic SF 11918 XM (character)SH /Times-Roman SF 12280 48738 MT (What printable character to use for) 36 W( quoting of control characters, "#" \05043\051 by default. There should be no)37 W 12280 49843 MT (reason to change this.)SH 8280 51420 MT (START-OF-PACKET)SH /Times-Italic SF 17530 XM (character)SH /Times-Roman SF 12280 52525 MT (The control character to mark the beginning of incoming packets. Normally SOH \050Control-A,) 74 W( ASCII 1\051)75 W 12280 53630 MT (\050see SET SEND START-OF-PACKET, above\051.)SH 12 /Times-Bold AF 8280 56218 MT (SET RETRY)SH 10 /Courier AF 8280 57630 MT (SET RETRY)SH /Times-Italic SF 14280 XM (option number)SH /Times-Roman SF 8280 60022 MT (Set the maximum number of retries allowed for:)SH 8280 61813 MT (INITIAL-CONNECTION)SH 12280 62918 MT (How many times to try establishing the initial protocol connection before giving) 63 W( up, normally something)64 W 12280 64023 MT (like 15.)SH 8280 65600 MT (PACKETS)SH 12280 66705 MT (How many times to try sending a particular packet before giving up,) 69 W( normally 5. If a line is very noisy,)70 W 12280 67810 MT (you might want to increase this number.)SH ES %%Page: 38 39 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 38)SH 12 /Times-Bold AF 29251 XM (Kermit User Guide: Kermit Commands \0504.17\051)SH 46800 50 6120 5709 UL 6120 8004 MT (SET WARNING)SH 10 /Courier AF 6120 9356 MT (SET WARNING {ON, OFF})SH /Times-Roman SF 6120 11748 MT (Tell Kermit whether to let incoming files overwrite existing files of the same name. If WARNING is ON,) 120 W( then)119 W 6120 12944 MT (Kermit will warn you of filename collisions and will attempt to construct) 61 W( a new, unique name for the arriving file,)62 W 6120 14140 MT (and inform you what the new name is. When OFF, Kermit silently overwrites existing files when) 85 W( there's a name)84 W 6120 15336 MT (collision. This) 250 W( command may also be called SET FILE WARNING.)SH 14 /Times-Bold AF 6120 18938 MT (4.18. The DEFINE Command)SH 10 /Courier AF 6120 21056 MT (DEFINE)SH /Times-Italic SF 9970 XM (macroname)SH /Times-Roman SF 14941 XM ([)SH /Times-Italic SF (command)SH /Times-Roman SF 19412 XM ([,)SH /Times-Italic SF 20245 XM (command)SH /Times-Roman SF 24383 XM ([, ...] ] ])SH 6120 23448 MT (Define a "macro" to allow convenient association of one) 66 W( or more Kermit commands with a mnemonic keyword of)67 W 6120 24644 MT (your choice. The definition consists of a list a list of one or more Kermit commands, separated by commas.) 33 W( If) 314 W( you)32 W 6120 25840 MT (use Kermit to communicate with several different kinds of systems, you may set up a macro for each, for instance:)SH /Courier SF 6720 27495 MT (DEFINE IBM SET PARITY MARK, SET DUPLEX HALF, SET HANDSHAKE XON)SH 6720 28526 MT (DEFINE UNIX SET PARITY NONE, SET DUPLEX FULL, SET HANDSHAKE NONE)SH 6720 29557 MT (DEFINE TELENET SET PARITY MARK, SET RECEIVE TIMEOUT 20)SH /Times-Roman SF 6120 31274 MT (You may then type DO) 27 W( IBM, DO UNIX, and so forth to set all the desired parameters with a single command. It is)28 W 6120 32470 MT (convenient to include these definitions in your Kermit initialization file.)SH 6120 34862 MT (Another other handy use for macros would be for rapid adaptation to different conditions of line noise:)SH /Courier SF 6720 36517 MT (DEFINE CLEAN SET BLOCK-CHECK 1, SET REC PACKET-LEN 94, SET RETRY 5)SH 6720 37548 MT (DEFINE NOISY SET BLOCK 2, SET SEND PACKET 60, SET RETRY 10)SH 6720 38579 MT (DEFINE VERY-NOISY SET BLOCK 3, SET SEND PACKET 40, SET RETRY 20)SH /Times-Roman SF 6120 40971 MT (You may redefine an existing macro in the same manner as you) 39 W( defined it. You can undefine an existing macro by)38 W 6120 42167 MT (typing an empty DEFINE command for it, for instance:)SH /Courier SF 6720 43822 MT (DEFINE IBM)SH /Times-Roman SF 6120 46214 MT (You can list) 94 W( all your macros and their definitions with the SHOW MACROS command. Syntax of SET and DO)95 W 6120 47410 MT (commands may vary among Kermit programs.)SH 14 /Times-Bold AF 6120 51012 MT (4.19. The SHOW Command)SH 10 /Times-Roman AF 6120 53130 MT (Syntax:)SH /Courier SF 9426 XM (SHOW)SH /Times-Roman SF 12076 XM ([)SH /Times-Italic SF (option)SH /Times-Roman SF (])SH 6120 55522 MT (The SHOW command displays the values of the parameters settable by the SET) 37 W( command. If a particular option is)36 W 6120 56718 MT (not requested, a complete display will be provided. Type "show ?" for a list of what can be shown.)SH 14 /Times-Bold AF 6120 60320 MT (4.20. The STATISTICS Command)SH 10 /Times-Roman AF 6120 62438 MT (Give statistics about the most recent file transfer, such as the total number of characters transmitted, the effective)95 W 6120 63634 MT (baud rate, and so forth. On some systems, this is SHOW STATISTICS.)SH ES %%Page: 39 40 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (4.21. The LOG Command)SH 10 /Times-Italic AF 51775 XM (Page 39)SH 46800 50 8280 5709 UL 14 /Times-Bold AF 8280 8138 MT (4.21. The LOG Command)SH 10 /Times-Roman AF 8280 10256 MT (Syntax:)SH /Courier SF 11586 XM (LOG)SH /Times-Roman SF 13636 XM ([)SH /Times-Italic SF (option)SH /Times-Roman SF (] [)SH /Times-Italic SF (filespec)SH /Times-Roman SF (])SH 8280 12648 MT (Log the specified entity to the specified log file.)SH 8280 14439 MT (TRANSACTIONS)SH 16280 XM (Direct Kermit to log transactions, such as) 84 W( files successfully sent or received or files that could)83 W 16280 15544 MT (not be successfully sent or received. A) 102 W( transaction is useful recording the progress of a long,)103 W 16280 16649 MT (unattended multifile transfer.)SH 8280 18226 MT (SESSION)SH 16280 XM (Create a transcript of a CONNECT) 36 W( session, when running a local Kermit connected to a remote)35 W 16280 19331 MT (system, in the specified file. The log is closed when connection is closed.) 347 W( In) 945 W( some)348 W 16280 20436 MT (implementations, logging can be "toggled" by typing the) 76 W( connect escape character followed by)75 W 16280 21541 MT (Q \050Quit logging\051 or R \050Resume logging\051 or similar single-character commands.) 9 W( Session-logging)269 W 16280 22646 MT (is useful for recording dialog with an interactive system, and for "capturing") 44 W( from) 336 W( systems that)43 W 16280 23751 MT (don't have) 67 W( Kermit. No guarantee can be made that the file will arrive correctly or completely,)68 W 16280 24856 MT (since no error checking takes place.)SH 8280 26433 MT (DEBUGGING)SH 16280 XM (Record debugging information in the specified file. There may be several options to) 65 W( select the)64 W 16280 27538 MT (desired information -- entire packets, state transitions, internal program trace, etc) 15 W( -- available via)16 W 16280 28643 MT (the SET DEBUGGING command.)SH 8280 30220 MT (PACKETS)SH 16280 XM (Record packets, and all communication line traffice during file transfer, in the specified file.)SH 14 /Times-Bold AF 8280 33822 MT (4.22. The TRANSMIT Command)SH 10 /Times-Roman AF 8280 35940 MT (Syntax:)SH /Courier SF 11586 XM (TRANSMIT)SH /Times-Italic SF 16636 XM (filespec)SH /Times-Roman SF 8280 38332 MT (Send the contents of the specified file to the other system "bare", without protocol, packets,) 168 W( error checking, or)167 W 8280 39528 MT (retransmission. This) 372 W( command is useful for sending files to systems that) 61 W( don't have Kermit. No guarantee can be)62 W 8280 40724 MT (made that the target system will receive the file correctly and completely. When receiving a file,) 53 W( the target system)52 W 8280 41920 MT (would normally be running a text editor in text collection mode.)SH 8280 44312 MT (The current communication settings, such as parity, flow control, and handshake, are obeyed) 211 W( by most Kermit)212 W 8280 45508 MT (versions that have a TRANSMIT command. The action is normally) 116 W( line-at-a-time. Each line of the file is sent,)115 W 8280 46704 MT (terminated by a carriage return \050no linefeed\051, just as you would type it.) 1 W( Kermit) 253 W( waits for the remote system to echo a)2 W 8280 47900 MT (linefeed \050as it does when you type carriage return\051 before it sends the next line.)SH 8280 50292 MT (Thus TRANSMIT provides) 131 W( a "raw upload" capability. The opposite, "raw download", may be accomplished by)130 W 8280 51488 MT (using the LOG SESSION command.)SH 14 /Times-Bold AF 8280 55090 MT (4.23. Login Scripts: The INPUT, OUTPUT, CLEAR, and PAUSE Commands)SH 10 /Times-Roman AF 8280 57208 MT (When running Kermit in local mode, you) 32 W( may use the INPUT, OUTPUT, CLEAR, and PAUSE commands to carry)33 W 8280 58404 MT (on a dialog with the remote system. When combined into a "script" in a Kermit TAKE command file,) 191 W( these)190 W 8280 59600 MT (commands provide the ability to initially connect and log in to a remote system, and to set it up for) 103 W( file transfer.)104 W 8280 60796 MT (While you may do this yourself manually using the CONNECT command, the) 41 W( login script facility allows this often)40 W 8280 61992 MT (tedious task to be automated, and more important, allows it to take) 1 W( place unattended -- perhaps late at night when the)2 W 8280 63188 MT (phone rates are low and the system is faster.)SH ES %%Page: 40 41 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 40)SH 12 /Times-Bold AF 29251 XM (Kermit User Guide: Kermit Commands \0504.23\051)SH 46800 50 6120 5709 UL 13 SS 22910 8071 MT (The CLEAR Command)SH 10 /Times-Roman AF 6120 10444 MT (Syntax:)SH /Courier SF 9426 XM (CLEAR)SH /Times-Roman SF 6120 12836 MT (Clear the input and output buffers of the currently selected line, and attempt to clear any XOFF deadlock.)SH 13 /Times-Bold AF 23055 16195 MT (The PAUSE Command)SH 10 /Times-Roman AF 6120 18568 MT (Syntax:)SH /Courier SF 9426 XM (PAUSE)SH /Times-Roman SF 12676 XM ([)SH /Times-Italic SF (interval)SH /Times-Roman SF (])SH 6120 20960 MT (Pause the specified number of seconds before executing the next command. The default interval is one second.)SH 13 /Times-Bold AF 23163 24319 MT (The INPUT Command)SH 10 /Times-Roman AF 6120 26692 MT (Syntax:)SH /Courier SF 9426 XM (INPUT)SH /Times-Roman SF 12676 XM ([)SH /Times-Italic SF (interval)SH /Times-Roman SF (] [)SH /Times-Italic SF (string)SH /Times-Roman SF (])SH 6120 29084 MT (On the currently selected communication line, look for the given string for the) 76 W( specified interval of time, which is)75 W 6120 30280 MT (specified in seconds. If) 66 W( no interval is specified, then wait for the default interval, which may be specified by SET)67 W 6120 31476 MT (INPUT DEFAULT-TIMEOUT, and is normally 5 seconds. Specifying an interval of 0 \050or less\051) 8 W( means no timeout --)7 W 6120 32672 MT (wait forever for the specified string. An INPUT) 157 W( command can normally be interrupted by typing one or more)158 W 6120 33868 MT (Control-C's, which will return you to Kermit prompt level.)SH 6120 36260 MT (Characters coming in from the line will be scanned for the search string, and when a) 49 W( match is found, the command)48 W 6120 37456 MT (will terminate successfully; if the) 256 W( string is not found within the given interval, the command will terminate)257 W 6120 38652 MT (unsuccessfully.)SH 6120 41044 MT (The search string may contain any printable characters. Control or other special characters that) 172 W( you could not)171 W 6120 42240 MT (normally type as part of a command may be included by preceding their ASCII) 13 W( values with a backslash, for instance)14 W /Courier SF 6120 43436 MT (foo\13413)SH /Times-Roman SF 9992 XM (is "foo" followed by a carriage return \050ASCII 13, decimal\051. \050Some Kermit programs expect) 22 W( or allow other)21 W 6120 44632 MT (number bases, such as octal or hexadecimal.\051)SH 6120 47024 MT (While scanning, alphabetic case is ignored \050"a" = "A"\051 unless you) 1 W( have SET INPUT CASE OBSERVE. If no search)2 W 6120 48220 MT (string is given, then the INPUT command will simply display all) 62 W( incoming characters on your screen until it times)61 W 6120 49416 MT (out or is interrupted.)SH 6120 51808 MT (If the INPUT command finds the specified string within the alloted amount) 161 W( of time, it terminates immediately,)162 W 6120 53004 MT (without an error message, and the next command will be executed. If the INPUT command fails to find the)196 W 6120 54200 MT (requested string, it) 88 W( will "fail"; failure is only significant if the command was issued from a TAKE command, and)89 W 6120 55396 MT (INPUT TIMEOUT-ACTION is SET to QUIT. When a timeout) 43 W( occurs under these conditions, the command file is)42 W 6120 56592 MT (immediately terminated and control is returned to the invoking) 187 W( level, either Kermit prompt level or a superior)188 W 6120 57788 MT (command file. If) 174 W( INPUT TIMEOUT-ACTION is SET to PROCEED, then the next command \050if any\051 will be)173 W 6120 58984 MT (executed from the current command file.)SH 6120 61376 MT (In addition to otherwise untypable control characters \050like Control-C\051, certain printable characters in the search)167 W 6120 62572 MT (string may need to be "quoted" using the backslash mechanism,) 12 W( including at-sign, question mark, or other characters)11 W 6120 63768 MT (that are significat to Kermit's command processor.)SH ES %%Page: 41 42 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (4.23. Login Scripts: The INPUT, OUTPUT, CLEAR, and PAUSE Commands)SH 10 /Times-Italic AF 51775 XM (Page 41)SH 46800 50 8280 5709 UL 13 /Times-Bold AF 24637 8071 MT (The OUTPUT Command)SH 10 /Times-Roman AF 8280 10444 MT (Syntax:)SH /Courier SF 11586 XM (OUTPUT)SH /Times-Italic SF 15436 XM (string)SH /Times-Roman SF 8280 12836 MT (The given string is sent) 19 W( out the currently selected communication line. The string is in the same form as the INPUT)20 W 8280 14032 MT (string; control or special characters may be included by prefacing their) 84 W( octal ASCII value with a backslash. Note)83 W 8280 15228 MT (that any terminating carriage return must be included explicitly as)SH /Courier SF 34887 XM (\13413)SH /Times-Roman SF 36937 XM (\050decimal\051.)SH 13 /Times-Bold AF 24602 18587 MT (How to Use Login Scripts)SH 10 /Times-Roman AF 8280 20960 MT (Login scripts are useful on computers that have) 175 W( autodialers or TTY ports hardwired or otherwise connected to)176 W 8280 22156 MT (terminal ports on other systems. Scripts can be used to automate the task of connecting and logging) 182 W( in. For)181 W 8280 23352 MT (instance, suppose your) 50 W( PC is connected to a VAX Unix system through a hardwired line on communication port 2.)51 W 8280 24548 MT (To send a) 42 W( file to the VAX, you must connect to the VAX through the port, log in, run Unix Kermit, escape back to)41 W 8280 25744 MT (the PC, and issue the appropriate file transfer commands, then connect back to the VAX and logout. This may all) 4 W( be)5 W 8280 26940 MT (automated by means of the following "script" stored in a PC file invoked by the Kermit TAKE command:)SH /Courier SF 10680 28595 MT (set port 2)SH 10680 29626 MT (output \13413)SH 10680 30657 MT (input login:)SH 10680 31688 MT (out myuserid\13413)SH 10680 32719 MT (in 10 Password:)SH 10680 33750 MT (out mypassword\13413)SH 10680 34781 MT (in 20 %)SH 10680 35812 MT (out kermit -r\13413)SH 10680 36843 MT (send foo.bar)SH 10680 37874 MT (out \1344)SH 10680 38905 MT (input)SH /Times-Roman SF 8280 40622 MT (The first line points Kermit at the communication line.) 100 W( The) 449 W( next line sends a carriage return, which makes Unix)99 W 8280 41818 MT (issue a ")61 W /Courier SF (login:)SH /Times-Roman SF (" prompt; the following INPUT) 61 W( command waits for this prompt to appear. When it does, Kermit)62 W 8280 43014 MT (outputs "myuserid" followed by) 136 W( a carriage return. Unix then prompts for a password; after the prompt appears,)135 W 8280 44210 MT (Kermit supplies the password.) 97 W( Then,) 446 W( Kermit waits up to 20 seconds for the Unix shell's ")98 W /Courier SF (%)SH /Times-Roman SF (" prompt; this allows)98 W 8280 45406 MT (time for various system messages to be displayed. When) 141 W( the shell prompt appears, Kermit sends the command)140 W 8280 46602 MT ("kermit -r", which tells Unix Kermit to) 14 W( receive a file; then a SEND command is given to the local Kermit. After the)15 W 8280 47798 MT (file is successfully transferred, Kermit sends a logout) 210 W( command \050Control-D, "\1344"\051 to Unix. The final INPUT)209 W 8280 48994 MT (command causes Kermit to display any) 8 W( typeout \050in this case the Unix system's logout message\051 that occurs up to the)9 W 8280 50190 MT (default timeout interval.)SH 8280 52582 MT (The INPUT command is) 24 W( very important, because it ensures synchronization. One might expect to be able to simply)23 W 8280 53778 MT (send all the characters out the communication) 194 W( line at once, and let the remote host's typeahead and buffering)195 W 8280 54974 MT (facilities take care) 151 W( of the synchronization. In rare or simple cases, this might work, but it assumes that \050a\051 the)150 W 8280 56170 MT (remote host allows typeahead, \050b\051) 187 W( the remote host's typeahead buffers are big enough to accommodate all the)188 W 8280 57366 MT (characters,)SH /Times-Italic SF 12851 XM (and)SH /Times-Roman SF 14619 XM (\050c\051 that the remote) 18 W( host never clears pending typeahead. These conditions rarely hold. For instance,)17 W 8280 58562 MT (Unix clears its input) 18 W( buffer)19 W /Times-Italic SF 19398 XM (after)SH /Times-Roman SF 21556 XM (issuing the ")19 W /Courier SF (Password:)SH /Times-Roman SF (" prompt; any typeahead will be lost. Interactive users as)19 W 8280 59758 MT (well as login script facilities) 123 W( must wait for the prompt before entering the password. This is the function of the)122 W 8280 60954 MT (INPUT command. On half duplex systems, this function) 146 W( is critical -- these systems cannot accept any input in)147 W 8280 62150 MT (advance of a prompt; there is no typeahead.)SH 8280 64542 MT (The Kermit script facility is not a programming language; there is no conditional execution of) 198 W( commands, no)197 W 8280 65738 MT (branching, no labels. Nevertheless,) 112 W( the SET INPUT command provides a degree of control. If the Unix system)113 W 8280 66934 MT (were down in the sample script above, Kermit would still proceed) 154 W( merrily through the entire script, sending its)153 W 8280 68130 MT (output into the void and waiting the) 27 W( entire timeout interval on each INPUT command, then attempting to send a file)28 W 8280 69326 MT (to a Kermit that wasn't there. It could take several minutes of timing out to terminate the script.) 110 W( This) 468 W( could be)109 W 8280 70522 MT (avoided by including the command)SH ES %%Page: 42 43 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 42)SH 12 /Times-Bold AF 29251 XM (Kermit User Guide: Kermit Commands \0504.23\051)SH 46800 50 6120 5709 UL 10 /Courier AF 8520 7824 MT (SET INPUT TIMEOUT-ACTION QUIT)SH /Times-Roman SF 6120 9541 MT (at the top of the) 109 W( script. When the ")110 W /Courier SF (login:)SH /Times-Roman SF (" prompt failed to appear within the timeout interval, the rest of the)110 W 6120 10737 MT (script would be cancelled.)SH 6120 13129 MT (See the chapters on MS-DOS and DEC-20 Kermit for further examples of login scripts.)SH ES %%Page: 43 44 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5. MS-DOS KERMIT)SH 10 /Times-Italic AF 51775 XM (Page 43)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 8280 8272 MT (5. MS-DOS KERMIT)SH 10 /Times-Italic AF 8280 10566 MT (Program:)SH /Times-Roman SF 16280 XM (Joe R.) 122 W( Doupnik \050Utah State University\051, with contributions by James Harvey \050Indiana/Purdue)121 W 16280 11671 MT (University\051, James Sturdevant \050A.C. Nielson Company\051, and many others.) 290 W( Originally) 831 W( by)291 W 16280 12776 MT (Daphne Tzoar and Jeff Damens \050Columbia University\051. See History.)SH /Times-Italic SF 8280 14434 MT (Language:)SH /Times-Roman SF 16280 XM (Microsoft Macro Assembler \050MASM\051)SH /Times-Italic SF 8280 16092 MT (Version:)SH /Courier SF 16280 XM (2.31)SH /Times-Italic SF 8280 17750 MT (Released:)SH /Times-Roman SF 16280 XM (July 1, 1988.)SH /Times-Italic SF 8280 19408 MT (Documentation:)SH /Times-Roman SF 16280 XM (Christine Gianone, Frank da Cruz \050Columbia University\051,)SH 16280 20513 MT (Joe R. Doupnik \050Utah State University\051)SH /Times-Italic SF 8280 22171 MT (Dedicated To:)SH /Times-Roman SF 16280 XM (Peppi)SH 12 /Times-Bold AF 8280 24759 MT (Kermit-MS Capabilities At A Glance:)SH 10 /Times-Roman AF 10440 26550 MT (Local operation:)SH 33480 XM (Yes)SH 10440 27655 MT (Remote operation:)SH 33480 XM (Yes)SH 10440 28760 MT (Transfers text files:)SH 33480 XM (Yes)SH 10440 29865 MT (Transfers binary files:)SH 33480 XM (Yes)SH 10440 30970 MT (Wildcard send:)SH 33480 XM (Yes)SH 10440 32075 MT (File transfer interruption:)SH 33480 XM (Yes)SH 10440 33180 MT (Filename collision avoidance:)SH 33480 XM (Yes)SH 10440 34285 MT (Can time out:)SH 33480 XM (Yes)SH 10440 35390 MT (8th-bit prefixing:)SH 33480 XM (Yes)SH 10440 36495 MT (Repeat count compression:)SH 33480 XM (Yes)SH 10440 37600 MT (Alternate block check types:)SH 33480 XM (Yes)SH 10440 38705 MT (Terminal emulation:)SH 33480 XM (VT102, H19, VT52, Tektronix 4010)SH 10440 39810 MT (Communication settings:)SH 33480 XM (Speed, Parity, Flow Control, Echo)SH 10440 40915 MT (Transmit BREAK:)SH 33480 XM (Yes \050and Long BREAK\051)SH 10440 42020 MT (IBM mainframe communication:)SH 33480 XM (Yes)SH 10440 43125 MT (Transaction logging:)SH 33480 XM (Yes)SH 10440 44230 MT (Session logging \050raw download\051:)SH 33480 XM (Yes)SH 10440 45335 MT (Raw upload:)SH 33480 XM (Yes)SH 10440 46440 MT (Act as server:)SH 33480 XM (Yes)SH 10440 47545 MT (Talk to server:)SH 33480 XM (Yes)SH 10440 48650 MT (Advanced server functions:)SH 33480 XM (Yes)SH 10440 49755 MT (Advanced commands for servers:)SH 33480 XM (Yes)SH 10440 50860 MT (Local file management:)SH 33480 XM (Yes)SH 10440 51965 MT (Command/init files:)SH 33480 XM (Yes)SH 10440 53070 MT (Command macros:)SH 33480 XM (Yes)SH 10440 54175 MT (Extended-length packets:)SH 33480 XM (Yes)SH 10440 55280 MT (Local area networks:)SH 33480 XM (Yes \050NetBIOS and other support\051)SH 10440 56385 MT (MS-Windows compatibility:)SH 33480 XM (Yes)SH 10440 57490 MT (Attribute packets:)SH 33480 XM (Yes)SH 10440 58595 MT (Sliding windows:)SH 33480 XM (No)SH 8280 60987 MT (MS-DOS Kermit, or "Kermit-MS") 76 W( \050or MS-Kermit\051, is a program that implements the Kermit file transfer protocol)75 W 8280 62183 MT (for the entire IBM PC family, including the PS/2 series, IBM compatibles, and several other machines based on the)37 W 8280 63379 MT (Intel 8086 processor series \0508088, 80286, 80386,) 44 W( etc\051 and the DOS operating system family \050PC-DOS or MS-DOS,)43 W 8280 64575 MT (henceforth referred to collectively as MS-DOS or simply DOS\051.)SH 8280 66967 MT (It is assumed you are acquainted with your PC and with DOS, and that you are familiar with the general ideas) 86 W( of)87 W 8280 68163 MT (data communication and Kermit file transfer. A very brief overview is given here,) 59 W( but for details consult the early)58 W 8280 69359 MT (chapters of) 160 W( the)161 W /Times-Italic SF 14899 XM (Kermit User Guide)161 W /Times-Roman SF 23298 XM (\050of which this document is a chapter\051, or the book Kermit, A File Transfer)161 W 9981 50 45099 69559 UL 8280 70555 MT (Protocol, by Frank da Cruz, Digital Press \0501987\051, order number EY-6705E-DP \050phone 1-800-343-8321\051,) 30 W( which also)29 W 3389 50 8280 70755 UL 8280 71751 MT (includes background tutorials on computers, file systems, and data communication \050including modems, cabling,) 2 W( etc\051.)3 W ES %%Page: 44 45 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 44)SH 12 /Times-Bold AF 30685 XM (Kermit User Guide: MS-DOS KERMIT \0505\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (For further information) 221 W( about Kermit documentation, updates, lists of current available versions, and ordering)220 W 6120 9082 MT (information, write to:)SH 8120 10692 MT (Kermit Distribution)SH 8120 11797 MT (Columbia University Center for Computing Activities)SH 8120 12902 MT (612 West 115th Street)SH 8120 14007 MT (New York, NY 10025 \050USA\051)SH 14 /Times-Bold AF 6120 17609 MT (5.1. System Requirements)SH 10 /Times-Roman AF 6120 19727 MT (Kermit-MS version 2.31 runs) 16 W( in as little as 100K of memory, but will occupy up to 148K if it can be found for extra)17 W 6120 20923 MT (screen rollback memory. Versions not using screen rollback) 67 W( memory will not require the additional space. It will)66 W 6120 22119 MT (also try to leave 24 Kbytes free for a second copy of)144 W /Courier SF 29009 XM (COMMAND.COM)SH /Times-Roman SF 36003 XM (which is needed for execution) 144 W( of certain)145 W 6120 23315 MT (commands.)SH 6120 25707 MT (On the IBM) 132 W( PC family, Kermit-MS)131 W /Courier SF 21436 XM (2.31)SH /Times-Roman SF 24217 XM (performs almost complete emulation of the DEC VT-102 and Heath/)131 W 6120 26903 MT (Zenith-19 terminals at speeds up to 19,200 baud) 4 W( or greater, lacking only the VT102's smooth scrolling and \050on some)5 W 6120 28099 MT (display boards\051 132 column features. And as of version 2.30, Kermit-MS also performs) 94 W( Tektronix 4010 graphics)93 W 6120 29295 MT (terminal emulation on IBM PC family systems equipped with CGA, EGA, or other graphics adapters,) 97 W( with either)98 W 6120 30491 MT (color or monochrome monitors.)SH 6120 32883 MT (Much of) 36 W( Kermit's speed is accomplished by direct writes to screen memory, but this is done in a "TopView-aware")35 W 6120 34079 MT (manner to allow successful operation in windowing environments like MS-Windows,) 178 W( DesqView, and TopView)179 W 6120 35275 MT (itself. Speed) 684 W( is) 217 W( also due to direct access of the serial port 8250 UART \050Universal Asynchronous Receiver/)216 W 6120 36471 MT (Transmitter\051 chip, with) 147 W( buffered, interrupt-driven receipt of characters and selectable XON/XOFF flow control.)148 W 6120 37667 MT (Full speed 9600 baud operation is possible on 4.77Mhz) 5 W( systems without flow control, but flow control is required on)4 W 6120 38863 MT (these systems for 19,200) 70 W( baud or higher rates. The IBM PC version should also run on near-clones like the DG/1)71 W 6120 40059 MT (that differ from true PCs) 94 W( only in their choice of UART; non-8250 UARTs are detected automatically, and slower)93 W 6120 41255 MT (non-interrupt driven Bios serial port i/o is used, in which case the top speed is in the 1200 baud range.)SH 6120 43647 MT (Kermit-MS)SH /Courier SF 10988 XM (2.31)SH /Times-Roman SF 13645 XM (runs on) 7 W( the entire IBM PC family \050the PC, XT, AT, PCjr, Portable PC, PC Convertible, PS/2\051 and)8 W 6120 44843 MT (compatibles \050Compaq, VAXmate, Z150,) 1 W( etc\051, and there are also specially tailored versions for non-IBM-compatibles)SH 6120 46039 MT (like the DEC Rainbow, HP-110, HP-150, HP Portable) 131 W( Plus, Grid Compass II, and others, plus a "generic DOS")132 W 6120 47235 MT (version that should run \050slowly\051 on any 8086-based MS-DOS machine.) 108 W( This) 465 W( document concentrates on the IBM)107 W 6120 48431 MT (version; some of the system-dependent) 107 W( capabilities described here may be lacking in the non-IBM versions. See)108 W 6120 49627 MT (section 5.10 for features of different systems.)SH /Courier SF 6120 52019 MT (KERMIT.EXE)SH /Times-Roman SF 12423 XM (for the IBM PC family occupies about 99K of) 53 W( disk storage \050the figure will vary for other versions\051.)52 W 6120 53215 MT (This can be reduced by about 15K if you run) 48 W( it through EXEPACK. MS-Kermit is not distributed in packed form,)49 W 6120 54411 MT (because problems have been reported on certain systems when this is done. So if you decide to pack it, make) 4 W( sure to)3 W 6120 55607 MT (keep an unpacked version available to fall back to in case of problems.)SH 14 /Times-Bold AF 6120 59209 MT (5.2. History)SH 10 /Times-Roman AF 6120 61327 MT (Over the years, MS-Kermit) 1 W( has grown from a Kermit file transfer program that embodied a simple terminal emulator)2 W 6120 62523 MT (into a complex and powerful communication program that includes the Kermit file transfer protocol.) 5 W( As) 258 W( a result, the)4 W 6120 63719 MT (bulk of this manual is devoted to the communication features,) 35 W( rather than Kermit protocol operation. Skip ahead to)36 W 6120 64915 MT (the next section if you're not interested in the history of MS-Kermit.)SH 6120 67307 MT (MS-DOS Kermit \050like the Kermit file transfer protocol itself\051 is a product of the Systems Group of the Columbia)91 W 6120 68503 MT (University Center for Computing) 84 W( Activities, and it was one of the four original Kermit programs \050with the CP/M,)85 W 6120 69699 MT (DEC-20, and IBM mainframe versions\051. It was initially written for the IBM PC with DOS 1.1 by) 39 W( Daphne Tzoar in)38 W 6120 70895 MT (1981-1982, based largely on Bill Catchings's original CP/M 8080) 74 W( assembler version. PC-Kermit \050as it was called)75 W ES %%Page: 45 46 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.2. History)SH 10 /Times-Italic AF 51775 XM (Page 45)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (then\051 provided basic Kermit file transfer and VT52 emulation. Joellen Windsor of the) 38 W( University of Arizona added)37 W 8280 9082 MT (conditional assembly support for) 293 W( the Heath/Zenith-100 shortly thereafter, and soon after that Dave King of)294 W 8280 10278 MT (Carnegie-Mellon University added Heath-19 terminal emulation,) 36 W( and some patches to let the program run under the)35 W 8280 11474 MT (new DOS version, 2.0. During this era, the program version numbers went from 1.0 to 1.20.)SH 8280 13866 MT (With the) 94 W( appearance in the marketplace of many new MS-DOS machines that were not compatible with the IBM)95 W 8280 15062 MT (PC, it became apparent) 236 W( that conditionally assembled code supporting each of these machines within a single)235 W 8280 16258 MT (monolithic source file was not the best way) 23 W( to organize the program. Therefore Daphne, along with Jeff Damens of)24 W 8280 17454 MT (Columbia, undertook to reorganize the program in a) 21 W( modular way, isolating system dependencies into separate files.)20 W 8280 18650 MT (The result was version 2.26,) 2 W( released in July 1984. It included support for the DEC Rainbow, the HP-150, the Wang)3 W 8280 19846 MT (PC, and generic MS-DOS, as well as for the IBM PC family and the H/Z-100.) 40 W( It) 329 W( also included many new features,)39 W 8280 21042 MT (like 8th-bit prefixing \050code contributed by) 68 W( The Source Telecomputing\051, alternate block check selection, byte-count)69 W 8280 22238 MT (compression, server/client operation,) 95 W( access to local file and DOS operations, command macros, initialization and)94 W 8280 23434 MT (command files,) 74 W( screen rollback, key redefinition, and more. For the 2.26 release, the executable Kermit programs)75 W 8280 24630 MT (were encoded) 239 W( printably as ``)238 W /Courier SF (.BOO)SH /Times-Roman SF ('' files, designed by Bill Catchings as part of this effort, for network and)238 W 8280 25826 MT (electronic-mail distribution.)SH 8280 28218 MT (Release 2.27 was produced by Daphne and Jeff in December 1984. Unlike 2.26, it ran correctly on) 32 W( the new PC/AT)33 W 8280 29414 MT (under DOS 3.0, and included support for the NEC APC from) 38 W( Ron Blanford of Seattle, WA, and Ian Gibbons of the)37 W 8280 30610 MT (University of Hawaii, and for the TI Professional from Joe Smith) 55 W( of the Colorado School of Mines, plus some bug)56 W 8280 31806 MT (fixes and reorganization. 2.27 is the last version that runs under pre-2.0 versions of DOS.)SH 8280 34198 MT (Version 2.28 \050Daphne, Jeff, June) 33 W( 1985\051 added dynamic memory allocation to reduce disk storage for the)32 W /Courier SF 50815 XM (.EXE)SH /Times-Roman SF 53497 XM (file,)SH 8280 35394 MT (and to allow the program to adjust itself to the) 141 W( PC's memory size, plus the inevitable bug fixes \050many of them)142 W 8280 36590 MT (contributed by Edgar Butt of the University of Maryland and Gregg Small of the University of California) 219 W( at)218 W 8280 37786 MT (Berkeley\051. During) 250 W( this period, support for additional MS-DOS systems was added by various people.)SH 8280 40178 MT (In December 1985, a tape showed up at Columbia) 52 W( sent by Prof.) 53 W( Joe) SH( R.) 53 W( Doupnik) SH( of the Center for Atmospheric and)53 W 8280 41374 MT (Space Studies and EE Department at Utah State University.) 141 W( This) 530 W( tape contained version 2.28 modified to fully)140 W 8280 42570 MT (support the DOS 2.0 file system, and to which many new) 194 W( features had been added, notably the ability of the)195 W 8280 43766 MT (MS-DOS Kermit server to process various REMOTE commands \050DIR, CWD, SPACE, etc\051. And at about) 23 W( the same)22 W 8280 44962 MT (time, a tape arrived from James) 200 W( Harvey of Indiana/Purdue University, who had changed Kermit's CONNECT)201 W 8280 46158 MT (command to emulate the popular DEC VT100 terminal. James's material was sent to Joe, who) 121 W( then laboriously)120 W 8280 47354 MT (fitted the VT100 emulation into his) 10 W( own code, keeping the VT52 and H19 emulation alive as options, and upgrading)11 W 8280 48550 MT (the VT100 emulation to VT102 by adding features such as line and character insertion and deletion. The result was)25 W 8280 49746 MT (version 2.29, released in May 1986.)SH 8280 52138 MT (Soon after the release of 2.29, some disks were sent in by) 228 W( James Sturdevant of the A.C. Nielson Company,)229 W 8280 53334 MT (containing a full implementation of the Kermit script facility, as described in the) 79 W( Kermit book. This material was)78 W 8280 54530 MT (sent to Joe, who) 84 W( had by now become keeper of MS-DOS Kermit and had already begun work on version 2.30 by)85 W 8280 55726 MT (adding support for extended-length packets. Joe) 285 W( had been carrying on voluminous network correspondence)284 W 8280 56922 MT (\050Thanks, BITNET!\051 with Columbia and with MS-DOS Kermit) 81 W( users and testers all over the world, giving birth to)82 W 8280 58118 MT (many new features, including) 5 W( Tektronix graphics terminal emulation, support for operation over local area networks,)4 W 8280 59314 MT (support for 8-bit ASCII terminal connections and international) 331 W( character sets, ANSI printer control, and a)332 W 8280 60510 MT (redesigned, more powerful, more portable key redefinition mechanism.)SH 8280 62902 MT (Version 2.30 was formally released on January 1, 1988, after) 143 W( many "alpha" and "beta" tests. Among the many)142 W 8280 64098 MT (contributors to this version were Brian Holley and Joe Smith for the Tektronix emulation, Robert Goeke for) 129 W( the)130 W 8280 65294 MT (NEC AP3 support, Brian Peterson and Andreas Stumpf for the) 107 W( Victor 9000, Bob Babcock and Joe White for the)106 W 8280 66490 MT (Sanyos, Christopher Lent for the Wang PC, Jack Bryans for an Intel iRMX version, Jim Noble for) 219 W( the Grid)220 W 8280 67686 MT (Compass, Geoff Mulligan and others for the Zenith 100, and) 90 W( David Knoell for the special Rainbow edition. And)89 W 8280 68882 MT (thanks to Gisbert Selke, Jack Bryans, and others for) 1 W( proofreading drafts of this manual. And apologies to anyone we)2 W 8280 70078 MT (neglected to mention.)SH ES %%Page: 46 47 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 46)SH 12 /Times-Bold AF 29785 XM (Kermit User Guide: MS-DOS KERMIT \0505.2\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (Work on version 2.31 began within weeks of the release of 2.30. The) 179 W( emphasis in this new version is on an)178 W 6120 9082 MT (improved command interface, more sophisticated script commands, and inclusion) 77 W( of file attributes packets to send)78 W 6120 10278 MT (the time, date and size of files along with the data. This version can operate with input redirected) 5 W( to a file or pipe, as)4 W 6120 11474 MT (in)SH /Courier SF 8520 13129 MT (kermit < todo.lst > todo.log)SH /Times-Roman SF 6120 14846 MT (or)SH /Courier SF 8520 16501 MT (sort < todo.lst | kermit)SH /Times-Roman SF 6120 18218 MT (Support for Ungermann-Bass Net One LAN is new, thanks to) 146 W( contributions from Henrik Levkowetz and Renne)147 W 6120 19414 MT (Rehmann. These) 438 W( changes) 94 W( led to a fairly thorough revision of the interior while providing the familiar commands)93 W 6120 20610 MT (and new features.)SH 6120 23002 MT (In contrast to parts of the commercial marketplace, Kermit-MS version numbers grow by small digits,) 26 W( more like the)27 W 6120 24198 MT (serial numbers they really are. 2.31 is the follow-on to version 2.30, regardless of level) 67 W( of improvement. Like all)66 W 6120 25394 MT (Kermit programs, MS-DOS Kermit may be freely copied and shared, so long as this is not done for profit.)SH 14 /Times-Bold AF 6120 28996 MT (5.3. Using MS-Kermit)SH 10 /Times-Roman AF 6120 31114 MT (MS-DOS Kermit performs two major functions, terminal emulation and file transfer.) 3 W( File) 257 W( transfer can be done using)4 W 6120 32310 MT (either the Kermit file transfer protocol, or else \050without error checking\051, ASCII or XON/XOFF capture) 267 W( and)266 W 6120 33506 MT (transmission methods. To use Kermit for) 167 W( "raw" uploading or downloading of files, see the descriptions of the)168 W 6120 34702 MT (TRANSMIT and LOG SESSION commands.)SH 6120 37094 MT (Before you can transfer files with another system using) 62 W( Kermit protocol, you must first connect to it as a terminal,)61 W 6120 38290 MT (login if necessary, and start up a Kermit program there. Kermit's CONNECT command lets you do) 32 W( this by making)33 W 6120 39486 MT (your PC act like a terminal. After) 11 W( setting things up on the other computer, you must return to the PC and tell it what)10 W 6120 40682 MT (to do. Returning to the PC is accomplished by typing a special sequence of characters, called the "escape sequence.")SH 6120 43074 MT (The following example shows this process; the other computer is a Unix system, but the method) 83 W( is the same with)84 W 6120 44270 MT (most others. The parts you type are underlined \050if this document was printed on a printer that can underline\051,) 71 W( and)70 W 6120 45466 MT (when you type a command, you terminate it with a carriage return, which) 172 W( you can't see in the example. The)173 W 6120 46662 MT (mysterious ``)69 W /Courier SF (^]c)SH /Times-Roman SF ('' is) 69 W( MS-Kermit's escape sequence, which you enter by holding down the Control \050Ctrl\051 key and)68 W 6120 47858 MT (pressing ``)49 W /Courier SF (])SH /Times-Roman SF ('' \050right square) 49 W( bracket\051, and then typing the letter C. The example assumes the MS-Kermit program is)50 W 6120 49054 MT (stored on disk as)SH /Courier SF 13064 XM (KERMIT.EXE)SH /Times-Roman SF (.)SH /Times-Italic SF 8520 50769 MT (Program Dialog:)SH 28680 XM (Explanation:)SH /Courier SF 8520 52424 MT (A>kermit)SH 3600 50 9720 52624 UL 8520 53455 MT (IBM PC Kermit-MS V2.31 17 July 1988)SH /Times-Italic SF 30120 XM (Program's greeting.)SH /Courier SF 8520 54486 MT (Type ? or HELP for help)SH 8520 56201 MT (Kermit-MS>set speed 1200)SH /Times-Italic SF 28680 XM (Set the right baud rate)SH /Courier SF (.)SH 8400 50 14520 56401 UL 8520 57232 MT (Kermit-MS>connect)SH /Times-Italic SF 28680 XM (Connect as a terminal.)SH 4200 50 14520 57432 UL /Courier SF 8520 58263 MT (ATDT7654321)SH /Times-Italic SF 28680 XM (Dial the modem if necessary.)SH 6600 50 8520 58463 UL /Courier SF 8520 59294 MT (CONNECT 1200)SH /Times-Italic SF 28680 XM (The modem tells you you're connected.)SH 9720 61009 MT (Now you're talking to the Unix system.)SH 9720 62040 MT (Type a carriage return to get its attention.)SH /Courier SF 8520 63755 MT (Login: christin)SH /Times-Italic SF 28680 XM (Login to the host.)SH 4800 50 12720 63955 UL /Courier SF 8520 64786 MT (password:)SH /Times-Italic SF 28680 XM (\050Passwords normally don't echo.\051)SH 3600 50 13920 64986 UL /Courier SF 8520 65817 MT (% kermit)SH /Times-Italic SF 28680 XM (Run Kermit on the host.)SH 3600 50 9720 66017 UL /Courier SF 8520 66848 MT (C-Kermit>receive)SH /Times-Italic SF 28680 XM (Tell it to receive a file.)SH 4200 50 13920 67048 UL /Courier SF 8520 67879 MT (^]c)SH /Times-Italic SF 28680 XM (Escape back to the PC.)SH 1800 50 8520 68079 UL /Courier SF 8520 68910 MT (Kermit-MS>send autoexec.bat)SH /Times-Italic SF 28680 XM (Send a file.)SH 10200 50 14520 69110 UL 9720 70627 MT (\050The file is transferred)SH /Times-Roman SF 18998 XM (. . .)SH /Times-Italic SF 20498 XM (\051)SH ES %%Page: 47 48 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.3. Using MS-Kermit)SH 10 /Times-Italic AF 51775 XM (Page 47)SH 46800 50 8280 5709 UL /Courier SF 10680 7884 MT (Kermit-MS>)SH /Times-Italic SF 30840 XM (Transfer complete, prompt reappears.)SH /Times-Roman SF 8280 9601 MT (In this example, the user types "kermit", and sees the program's herald and its prompt, ``)15 W /Courier SF (Kermit-MS>)SH /Times-Roman SF (''. Then) 280 W( she)14 W 8280 10797 MT (sets the appropriate communication speed \050"baud rate"\051,) 169 W( connects as a terminal, issues a dialing command to a)170 W 8280 11993 MT (Hayes-like modem \050you would skip this step if you had a direct connection\051, logs in to her) 65 W( ID on the Unix system)64 W 8280 13189 MT (which she has dialed, starts "C-Kermit" on the Unix system, tells it to receive a file, escapes back to the PC, and) 2 W( tells)3 W 8280 14385 MT (MS-Kermit to send a file. After the file is transferred, the user would) 81 W( normally connect back to the Unix system,)80 W 8280 15581 MT (exit from the Kermit program there, and log out:)SH /Courier SF 10680 17296 MT (Kermit-MS>connect)SH /Times-Italic SF 28680 XM (Connect again.)SH 4200 50 16680 17496 UL /Courier SF 10680 18327 MT (C-Kermit>exit)SH 2400 50 16080 18527 UL 10680 19358 MT (% ^D)SH /Times-Italic SF 28680 XM (Logout from Unix by typing Ctrl-D.)SH 1200 50 11880 19558 UL /Courier SF 10680 20389 MT (^]c)SH /Times-Italic SF 28680 XM (Escape back to the PC.)SH 1800 50 10680 20589 UL /Courier SF 10680 21420 MT (Kermit-MS>exit)SH /Times-Italic SF 28680 XM (Return to DOS.)SH 2400 50 16680 21620 UL /Times-Roman SF 8280 23137 MT (To transfer a file in the other direction, simply exchange the "send" and "receive" commands above. That's) 124 W( the)125 W 8280 24333 MT (easiest and quickest way to use Kermit. If) 27 W( this simple scenario does not work for you, issue the MS-Kermit SHOW)26 W 8280 25529 MT (COMMUNICATIONS command and) 138 W( look for any obvious incorrect settings \050port, speed, parity\051, fix them with)139 W 8280 26725 MT (SET commands \050described in Section 5.6.10\051, and try again. \050IBM mainframe linemode connections have so many)40 W 8280 27921 MT ("different" settings, there's a) 62 W( special command to do them all at once, "do ibm", which you would type as the first)63 W 8280 29117 MT (Kermit-MS command above.\051 If that doesn't help, read on. Many problems can crop) 148 W( up when you attempt to)147 W 8280 30313 MT (connect two unlike systems over a possibly hostile communication medium. And if you intend to be a frequent user)16 W 8280 31509 MT (of Kermit, there are many options) 61 W( you can take advantage of to adapt MS-Kermit to different systems, improve its)60 W 8280 32705 MT (performance, and automate common tasks.)SH 14 /Times-Bold AF 8280 36307 MT (5.4. The MS-DOS File System)SH 10 /Times-Roman AF 8280 38425 MT (The features of) 68 W( the MS-DOS file system of greatest interest to Kermit users are the form of the file specifications,)69 W 8280 39621 MT (and the formats of the files themselves.)SH 12 /Times-Bold AF 8280 42737 MT (5.4.1. File Specifications)SH 10 /Times-Roman AF 8280 44679 MT (MS-DOS file specifications \050in version 2.0 or later of DOS\051 are of the form)SH /Courier SF 10680 46334 MT (DEVICE:\134PATHNAME\134NAME.TYPE)SH /Times-Roman SF 8280 48051 MT (where the DEVICE is a single character identifier \050for instance, A for the first floppy) 23 W( disk, C for the first fixed disk,)22 W 8280 49247 MT (D for a RAM disk emulator\051 followed by) 4 W( a colon \050``)5 W /Courier SF (:)SH /Times-Roman SF (''\051, PATHNAME is up to 63 characters of identifier\050s\051 \050up to 8)5 W 8280 50443 MT (characters each\051 surrounded by backslashes \050``)102 W /Courier SF (\134)SH /Times-Roman SF (''\051, NAME) 102 W( is an identifier of up to 8 characters, and TYPE is an)101 W 8280 51639 MT (identifier of up to 3 characters in length. Device and pathname may) 5 W( be omitted. The first backslash in the pathname)6 W 8280 52835 MT (may be omitted if the specified path is relative to the current directory. In) 91 W( the path field, ``)90 W /Courier SF (.)SH /Times-Roman SF ('' means the current)90 W 8280 54031 MT (directory, ``)49 W /Courier SF (..)SH /Times-Roman SF ('' means the parent directory. Some DOS implementations \050like Wang\051 may) 49 W( use slash \050``)50 W /Courier SF (/)SH /Times-Roman SF (''\051 rather)50 W 8280 55227 MT (than backslash as a directory separator.)SH 8280 57619 MT (Pathname is normally omitted, but can be specified in all Kermit-MS commands \050as of version)35 W /Courier SF 46968 XM (2.29)SH /Times-Roman SF (\051. Device) 319 W( and)34 W 8280 58815 MT (directory pathnames, when omitted, default) 24 W( to either the user's current disk and directory, or to the current directory)25 W 8280 60011 MT (search path as specified in the DOS PATH environment variable, depending on the context in which the file) 65 W( name)64 W 8280 61207 MT (appears.)SH 10280 62998 MT (When this document says that) 65 W( a file is searched for "in the current path," it means that Kermit-MS looks)66 W 10280 64103 MT (on the current disk) 55 W( and directory first, and if the file is not found, then the directories listed in the PATH)54 W 10280 65208 MT (environment variable are searched. If the PATH environment variable is empty, Kermit looks only at) 40 W( the)41 W 10280 66313 MT (current disk and directory.)SH /Courier SF 8280 68104 MT (NAME.TYPE)SH /Times-Roman SF 13975 XM (is sufficient to specify a file on the current disk and directory, and) 45 W( only this information is sent along)44 W 8280 69300 MT (by Kermit-MS with an outgoing file.)SH 8280 71692 MT (The device, path, name, and type fields) 20 W( may contain uppercase letters, digits, and the special characters ``)21 W /Courier SF (-)SH /Times-Roman SF ('' \050dash\051,)21 W ES %%Page: 48 49 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 48)SH 12 /Times-Bold AF 28885 XM (Kermit User Guide: MS-DOS KERMIT \0505.4.1\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (``)SH /Courier SF (_)SH /Times-Roman SF ('' \050underscore\051, ``)122 W /Courier SF ($)SH /Times-Roman SF ('' \050dollar sign\051, ``)122 W /Courier SF (&)SH /Times-Roman SF ('' \050ampersand\051, ``)122 W /Courier SF (#)SH /Times-Roman SF ('' \050number sign\051, ``)122 W /Courier SF (@)SH /Times-Roman SF ('' \050at sign\051,) 122 W( ``)121 W /Courier SF (!)SH /Times-Roman SF ('' \050exclamation)492 W 6120 9082 MT (mark\051, ``)50 W /Courier SF (')SH /Times-Roman SF ('' \050single quote\051, ``)50 W /Courier SF (\050\051)SH /Times-Roman SF ('' \050parentheses\051, ``)50 W /Courier SF ({})SH /Times-Roman SF ('' \050curly braces\051,) 50 W( ``)51 W /Courier SF (^)SH /Times-Roman SF ('' \050caret or circumflex\051, ``)51 W /Courier SF (~)SH /Times-Roman SF ('' \050tilde\051, and)51 W 6120 10278 MT (``)SH /Courier SF (`)SH /Times-Roman SF ('' \050accent) 424 W( grave\051. Normally, you should confine your filenames to letters and digits for maximum)423 W 6120 11474 MT (transportability to non-DOS systems. When you type lowercase letters in filenames, they are) 379 W( converted)380 W 6120 12670 MT (automatically to uppercase. There are no imbedded or trailing spaces. Other characters may not be included; there)42 W 6120 13866 MT (is no mechanism for "quoting") 59 W( otherwise illegal characters in filenames. The fields of the file specification are set)60 W 6120 15062 MT (off from one another by the punctuation indicated above.)SH 6120 17454 MT (The name field is the primary identifier for the file. The type, also called the extension or suffix, is an) 102 W( indicator)101 W 6120 18650 MT (which, by convention,) 78 W( tells what kind of file we have. For instance)79 W /Courier SF 34308 XM (FOO.BAS)SH /Times-Roman SF 38837 XM (is the source of a BASIC program)79 W 6120 19846 MT (named FOO;)11 W /Courier SF 11586 XM (FOO.OBJ)SH /Times-Roman SF 16047 XM (might be the relocatable object module) 11 W( produced by compiling)10 W /Courier SF 41500 XM (FOO.BAS)SH /Times-Roman SF (;)SH /Courier SF 46238 XM (FOO.EXE)SH /Times-Roman SF 50698 XM (could)SH 6120 21042 MT (be an executable program produced) 75 W( by loading)76 W /Courier SF 25671 XM (FOO.OBJ)SH /Times-Roman SF (, and so forth.)76 W /Courier SF 36278 XM (.EXE)SH /Times-Roman SF 39004 XM (and)SH /Courier SF 40774 XM (.COM)SH /Times-Roman SF 43500 XM (are the normal suffixes)76 W 6120 22238 MT (for executable programs.)SH 6120 24630 MT (MS-DOS allows a group of files to be specified in a single file specification) 117 W( by including the special "wildcard")116 W 6120 25826 MT (characters, ``)16 W /Courier SF (*)SH /Times-Roman SF ('' and ``)16 W /Courier SF (?)SH /Times-Roman SF (''. A) 282 W( ``)16 W /Courier SF (*)SH /Times-Roman SF ('' matches any string of) 16 W( characters from the current position to the end of the field,)17 W 6120 27022 MT (including no characters at all; a ``)SH /Courier SF (?)SH /Times-Roman SF ('' matches any single character. Here are some examples:)SH /Courier SF 7120 28813 MT (*.BAS)SH /Times-Roman SF 11120 XM (All files of type)SH /Courier SF 17675 XM (BAS)SH /Times-Roman SF 19725 XM (\050BASIC source files\051 in the current directory.)SH /Courier SF 7120 30471 MT (FOO.*)SH /Times-Roman SF 11120 XM (Files of all types with name)SH /Courier SF 22453 XM (FOO)SH /Times-Roman SF (.)SH /Courier SF 7120 32129 MT (F*.*)SH /Times-Roman SF 11120 XM (All files whose names start with F.)SH /Courier SF 7120 33787 MT (*.?)SH /Times-Roman SF 11120 XM (All files whose types are exactly one character long, or have no type at all.)SH 6120 36179 MT (Wildcard notation is used on) 16 W( many computer systems in similar ways, and it is the mechanism most commonly used)15 W 6120 37375 MT (to instruct Kermit to send a group of files.)SH 6120 39767 MT (Users of Kermit-MS) 53 W( should bear in mind that other \050non-MS-DOS\051 systems may use different wildcard characters.)54 W 6120 40963 MT (For instance VMS and the DEC-20 use ``)273 W /Courier SF (%)SH /Times-Roman SF ('' instead of ``)273 W /Courier SF (?)SH /Times-Roman SF ('' as the single) 273 W( character wildcard; when using)272 W 6120 42159 MT (Kermit-MS to request a wildcard file group from a Kermit-20 server, the DOS ``)195 W /Courier SF (?)SH /Times-Roman SF ('' must be replaced by the)196 W 6120 43355 MT (DEC-20 ``)SH /Courier SF (%)SH /Times-Roman SF (''.)SH 12 /Times-Bold AF 6120 46471 MT (5.4.2. File Formats)SH 10 /Times-Roman AF 6120 48413 MT (MS-DOS systems store files as streams of 8-bit bytes, with no particular distinction among) 41 W( text, program code, and)40 W 6120 49609 MT (binary files. ASCII text files) 144 W( consist of lines separated by carriage-return-linefeed sequences \050CRLFs\051, and this)145 W 6120 50805 MT (conforms exactly to the way Kermit represents) 47 W( text files during transmission, so Kermit-MS has no need for a SET)46 W 6120 52001 MT (FILE TYPE BINARY command. But since a) 27 W( non-MS-DOS receiving system might need to make distinctions as to)28 W 6120 53197 MT (file type, you will probably have to issue SET FILE TYPE commands there if you are sending it non-text) 53 W( files. In)52 W 6120 54393 MT (transmitting files between Kermit-MS programs, regardless of file contents, the receiving MS-DOS system is)235 W 6120 55589 MT (equally capable of) 21 W( processing text, code, and data, and in fact requires no knowledge of how the bytes in the file are)20 W 6120 56785 MT (to be used.)SH 6120 59177 MT (MS-DOS \050unlike CP/M\051 knows the exact end of a file because it keeps a byte count) 54 W( in the directory, so one would)55 W 6120 60373 MT (expect no particular confusion in this) 190 W( regard. However, certain MS-DOS programs continue to use the CP/M)189 W 6120 61569 MT (convention of terminating a) 41 W( text file with a Control-Z character, and won't operate correctly unless this terminating)42 W 6120 62765 MT (byte is present. Therefore, you should be aware of a) 20 W( special SET EOF option for both incoming and outbound files,)19 W 6120 63961 MT (described later.)SH 6120 66353 MT (Non-MS-DOS systems may be confused by nonstandard ASCII files sent by Kermit-MS:)SH /Symbol SF 7910 68258 MT (\267)SH /Times-Roman SF 8620 XM (Files containing any of the) 82 W( 8-bit "extended ASCII" characters may need conversion \050or translation\051 to)83 W 8620 69363 MT (7-bit ASCII.)SH /Symbol SF 7910 71352 MT (\267)SH /Times-Roman SF 8620 XM (Files produced by word processing programs like Word Perfect) 197 W( or Word Star may contain special)196 W ES %%Page: 49 50 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.4.2. File Formats)SH 10 /Times-Italic AF 51775 XM (Page 49)SH 46800 50 8280 5709 UL /Times-Roman SF 10780 7886 MT (binary formatting codes, and could need conversion to conventional 7-bit ASCII format prior) 267 W( to)268 W 10780 8991 MT (transmission, using an "export" procedure.)SH /Symbol SF 10070 10980 MT (\267)SH /Times-Roman SF 10780 XM (Files created by word processors that store formatting data at the end of) 19 W( the file, after the Control-Z and)18 W 10780 12085 MT (before physical end, may require special processing via SET EOF) 43 W( to strip the formatting data, lest they)44 W 10780 13190 MT (confuse non-MS-DOS recipients.)SH /Symbol SF 10070 15179 MT (\267)SH /Times-Roman SF 10780 XM (Spreadsheet or database files usually need special formatting to be meaningful to non-MS-DOS)294 W 10780 16284 MT (recipients \050though they can be transmitted between MS-DOS systems with Kermit-MS\051.) 333 W( Such)918 W 10780 17389 MT (programs usually come with an "export" procedure to convert their files to plain ASCII text.)SH /Symbol SF 10070 19378 MT (\267)SH /Times-Roman SF 10780 XM (BASIC programs are normally saved in a binary "tokenized") 42 W( form. Use BASIC's ``)41 W /Courier SF (,a)SH /Times-Roman SF ('' SAVE option)41 W 10780 20483 MT (to save them as regular ASCII text, as in)SH /Courier SF 13180 22138 MT (save"foofa",a)SH /Times-Roman SF 8280 23929 MT (In general,) 58 W( when attempting to transfer non-text files between MS-DOS and a different kind of system, consult the)59 W 8280 25125 MT (Kermit manual for that system.)SH 14 /Times-Bold AF 8280 28727 MT (5.5. Program Setup and Invocation)SH 10 /Times-Roman AF 8280 30845 MT (The MS-DOS Kermit program can) 78 W( be run from any disk without any special installation procedure. On hard disk)77 W 8280 32041 MT (systems, it is convenient to store the program in one of the directories listed in your DOS PATH, and it is often)111 W 8280 33237 MT (desirable to customize Kermit's operation to your communications and computing environment by) 201 W( creating an)200 W 8280 34433 MT (initialization file.)SH 8280 36825 MT (Kermit-MS can be run interactively, from a batch file,) 90 W( or as an "external" DOS command. Commands consist of)91 W 8280 38021 MT (one or more fields, separated by "whitespace" -- one or more spaces or tabs.)SH 8280 40413 MT (Upon initial startup, the program executes any commands found in the file)31 W /Courier SF 38676 XM (MSKERMIT.INI)SH /Times-Roman SF 46156 XM (on the current disk, or)30 W 8280 41609 MT (in the current path. This initialization file may contain command macro) 107 W( definitions, communications settings for)108 W 8280 42805 MT (one or) 8 W( more ports, or any other Kermit-MS commands, and you may create it using any text editor capable of saving)7 W 8280 44001 MT (files in plain ASCII text format. Here is a sample:)SH /Courier SF 10680 45656 MT (comment -- MSKERMIT.INI, MS-DOS Kermit initialization file)SH 10680 47311 MT (comment -- Don't overwrite my files!)SH 11280 48342 MT (set warning on)SH 10680 49997 MT (comment -- Define macros for the systems I use...)SH 11280 51028 MT (define unix set local-echo off,set par non,set flow xon,set timer off)SH 11280 52059 MT (def ibm set par odd,set loc on,set hands xon,set flo none,set tim on)SH 11280 53090 MT (def modem set port 2, set speed 1200)SH 10680 54745 MT (comment -- Define a macro for quickly adapting to noisy connections...)SH 11280 55776 MT (def noisy set block-check 3, set send packet-length 40, set retry 20)SH 10680 57431 MT (comment -- I always start out by connecting to my UNIX system...)SH 11280 58462 MT (set port 1)SH 11280 59493 MT (set speed 4800)SH 11280 60524 MT (do unix)SH 11280 61555 MT (connect)SH /Times-Roman SF 8280 63272 MT (A different file may be substituted for)SH /Courier SF 23694 XM (MSKERMIT.INI)SH /Times-Roman SF 31144 XM (by using ")SH /Courier SF (-f)SH /Times-Italic SF 37019 XM (filename)SH /Times-Roman SF (" on the DOS command line, e.g.)SH /Courier SF 10680 64927 MT (kermit -f monday.ini)SH /Times-Roman SF 8280 67319 MT (The meanings of these) 122 W( commands will emerge below. For now, just note how you can use command files \050and)123 W 8280 68515 MT ("macro definitions"\051 to easily adapt) 2 W( MS-Kermit to widely differing communication environments. A more advanced)1 W 8280 69711 MT (initialization file is shown in section 5.9.)SH ES %%Page: 50 51 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 50)SH 12 /Times-Bold AF 29785 XM (Kermit User Guide: MS-DOS KERMIT \0505.5\051)SH 46800 50 6120 5709 UL 6120 8004 MT (Interactive Operation:)SH 10 /Times-Roman AF 6120 9418 MT (To run Kermit-MS interactively, invoke the program) 203 W( from DOS command level by typing its name, normally)204 W 6120 10614 MT ("kermit" \050this means the program should be stored in your path with the name)61 W /Courier SF 38398 XM (KERMIT.EXE)SH /Times-Roman SF (\051. When) 372 W( you see the)60 W 6120 11810 MT (program's prompt,)SH /Courier SF 8520 13465 MT (Kermit-MS>)SH /Times-Roman SF 6120 15182 MT (you may type Kermit commands repeatedly until you are ready to exit the program, as in) 111 W( the following example)112 W 6120 16378 MT (\050which assumes there's already a Kermit "server" set up on the other end\051:)SH /Courier SF 8520 18033 MT (A>)SH 8520 19064 MT (A>kermit)SH 3600 50 9720 19264 UL 8520 20719 MT (IBM PC Kermit-MS V2.31 17 July 1988)SH 8520 21750 MT (Type ? or HELP for help)SH 8520 23405 MT (Kermit-MS>set speed 19200)SH 9000 50 14520 23605 UL 8520 24436 MT (Kermit-MS>send foo.*)SH 6000 50 14520 24636 UL /Times-Italic SF 9720 26151 MT (The files are sent.)SH /Courier SF 8520 27806 MT (Kermit-MS>get fot.*)SH 5400 50 14520 28006 UL /Times-Italic SF 9720 29521 MT (The requested files are received.)SH /Courier SF 8520 31176 MT (Kermit-MS>exit)SH 2400 50 14520 31376 UL 8520 32207 MT (A>)SH /Times-Roman SF 6120 33924 MT (Interactive commands are described in Section 5.6.)SH 12 /Times-Bold AF 6120 36512 MT (Command Line Invocation:)SH 10 /Times-Roman AF 6120 37926 MT (Kermit-MS may be invoked with command line arguments from DOS command level, for instance:)SH /Courier SF 8520 39581 MT (A>kermit send peter.amy)SH 12600 50 9720 39781 UL /Times-Roman SF 6120 40883 MT (or)SH /Courier SF 8520 42123 MT (A>kermit set port 1, set baud 9600, connect)SH 24600 50 9720 42323 UL /Times-Roman SF 6120 44515 MT (In this case, help and completion) 115 W( are) 479 W( not available \050because the program that provides them won't start running)114 W 6120 45711 MT (until after you type the entire command line\051, and Kermit-MS) 52 W( will exit back to DOS after completing the specified)53 W 6120 46907 MT (command or commands. Therefore, when invoked with) 77 W( command line arguments, Kermit-MS will behave as if it)76 W 6120 48103 MT (were an external DOS command, like MODE. Note that several commands may be given on the command) 105 W( line,)106 W 6120 49299 MT (separated by commas. This can't be done interactively or from TAKE command files.)SH 6120 51691 MT (As of version 2.30, two new Kermit) 2 W( commands can be given on the DOS command line. First is the keyword STAY)1 W 6120 52887 MT (which prevents Kermit from exiting naturally when the last) 109 W( command has completed \050unless, of course, EXIT or)110 W 6120 54083 MT (QUIT was among the commands\051. The second command is)SH /Courier SF 8520 55798 MT (-F)SH /Times-Italic SF 10320 XM (filename)SH /Times-Roman SF 6120 57515 MT (This means) 164 W( use the indicated filename as the initialization file rather than)163 W /Courier SF 37628 XM (MSKERMIT.INI)SH /Times-Roman SF (. The) 576 W( path will be)163 W 6120 58711 MT (searched for this file, if necessary. A space or tab must separate -F from the) 23 W( filename, and the F may be in upper or)24 W 6120 59907 MT (lower case. Example:)SH /Courier SF 8520 61562 MT (kermit -f tuesday.ini, set port 2, do ibm, stay)SH /Times-Roman SF 6120 63279 MT (You can run Kermit with no initialization file at all by using the command)SH /Courier SF 8520 64934 MT (kermit -f nul)SH /Times-Roman SF 6120 66651 MT (If)SH /Courier SF 7036 XM (-F)SH /Times-Roman SF 8486 XM (is the only command line option, STAY is implied.)SH ES %%Page: 51 52 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.5. Program Setup and Invocation)SH 10 /Times-Italic AF 51775 XM (Page 51)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (Redirected Input and Output)SH 10 /Times-Roman AF 8280 9418 MT (Kermit-MS also can be operated by redirecting input to it from a file, as in:)SH /Courier SF 10680 11073 MT (C>kermit < myscript.txt > myscript.log)SH 21600 50 11880 11273 UL /Times-Roman SF 8280 12790 MT (or from a DOS "pipe", as in)SH /Courier SF 10680 14445 MT (C>sort < sends.txt | kermit)SH 15000 50 11880 14645 UL /Times-Roman SF 8280 16162 MT (The file)12 W /Courier SF 11692 XM (MYSCRIPT.TXT)SH /Times-Roman SF 19153 XM (contains Kermit commands as if they were typed manually. The DOS symbol ")11 W /Courier SF (<)SH /Times-Roman SF (" means)11 W 8280 17358 MT (that Kermit should read from the following file rather from the keyboard.)SH 8280 19750 MT (Kermit knows this is occurring and takes special steps to avoid the) 34 W( real keyboard and to quit when the file has been)35 W 8280 20946 MT (completely examined. The filename can also be the) 63 W( name of a device, such as COM1, to converse on the same or)62 W 8280 22142 MT (different line as file transfer traffic. Information destined for the screen still goes to the screen) 33 W( unless the phrase ")34 W /Courier SF (>)SH /Times-Italic SF 8280 23338 MT (filespec)SH /Times-Roman SF (" is added to the command line above to send the) 5 W( normal screen output to a file or device \050device COM1 also)4 W 8280 24534 MT (works\051. Note) 250 W( that the terminal emulation screen cannot be redirected.)SH 12 /Times-Bold AF 8280 27122 MT (Batch Operation:)SH 10 /Times-Roman AF 8280 28536 MT (Like many other MS-DOS programs, Kermit-MS may be operated under DOS batch) 22 W( with command line arguments.)23 W 8280 29732 MT (If you invoke it without command line arguments,) 96 W( it will run interactively, reading commands from the keyboard)95 W 8280 30928 MT (and not the batch file. When it exits, batch processing will continue to the end of the batch file.)SH 8280 33320 MT (Kermit-MS returns the "errorlevel" parameter used as program exit status. Present values are in the range 0 to 7)102 W 8280 34516 MT (with three areas yielding success or failure reports for the entire Kermit session. The errorlevel values are:)SH 9030 36126 MT (errorlevel)SH 19800 XM (Kermit session status)SH 3887 50 9030 36326 UL 8500 50 19800 36326 UL 10280 37231 MT (0)SH 19800 XM (entirely successful operation)SH 10280 38336 MT (1)SH 19800 XM (a Send command completed unsuccessfully)SH 10280 39441 MT (2)SH 19800 XM (a Receive or GET command completed unsuccessfully)SH 10280 40546 MT (4)SH 19800 XM (a REMOTE command completed unsuccessfully)SH 9530 41651 MT (3,5,6,7)SH 19800 XM (combinations \050addition\051 of the above conditions)SH 8280 44043 MT (Note that failures are remembered for the whole session and) 24 W( are not canceled by a following successful operation of)23 W 8280 45239 MT (the same type. Thus, sending several files individually yields an errorlevel of 0 only if all the files) 190 W( were sent)191 W 8280 46435 MT (successfully. The) 468 W( "errorlevel" parameter also applies to script commands) 109 W( where OUTPUT corresponds to SEND)108 W 8280 47631 MT (and INPUT to RECEIVE. An example of Batch invocation of Kermit is shown in Figure 5-4.)SH 8280 50023 MT (New to version 2.31 are the commands SET) 6 W( ERRORLEVEL number, to force a result code, and IF ERRORLEVEL,)7 W 8280 51219 MT (to test the value within scripts.)SH 12 /Times-Bold AF 8280 53807 MT (Remote Operation:)SH 10 /Times-Roman AF 8280 55221 MT (The MS-DOS CTTY command allows) 360 W( an MS-DOS system to be used from a terminal connected to its)359 W 8280 56417 MT (communication port. Such sessions must be conducted with great care, since many programs assume) 62 W( that they are)63 W 8280 57613 MT (running on the real console, and explicitly reference screen memory or keyboard scan codes.) 24 W( Kermit) 297 W( can be used in)23 W 8280 58809 MT (this manner too, but before you give it any file transfer commands, you must inform it that) 49 W( it is running in "remote)50 W 8280 60005 MT (mode" rather than its) 68 W( normal "local mode." Use the SET REMOTE ON command for this purpose, to prevent the)67 W 8280 61201 MT (file transfer display from being sent out the port.)SH 12 /Times-Bold AF 8280 63789 MT (RAM Disk Operation:)SH 10 /Times-Roman AF 8280 65203 MT (If you invoke Kermit frequently, and you have sufficient memory on your PC, you) 64 W( may find it convenient to copy)65 W 8280 66399 MT (Kermit and its initialization file to a RAM disk when you start your system. This allows Kermit to be started) 70 W( and)69 W 8280 67595 MT (used quickly and silently, with no mechanical disk operations.)SH 8280 69987 MT (For instance, if you're using IBM's VDISK facility) 84 W( to create the RAM disk, you might put statements like this in)85 W 8280 71183 MT (your)SH /Courier SF 10363 XM (CONFIG.SYS)SH /Times-Roman SF 16613 XM (file:)SH ES %%Page: 52 53 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 52)SH 12 /Times-Bold AF 29785 XM (Kermit User Guide: MS-DOS KERMIT \0505.5\051)SH 46800 50 6120 5709 UL 10 /Courier AF 8520 7824 MT (DEVICE=VDISK.SYS 384 512 128 /e)SH /Times-Roman SF 6120 9541 MT (This assumes you have 384K of extended \050)98 W /Courier SF (/e)SH /Times-Roman SF (\051 memory installed and)98 W /Courier SF 35144 XM (VDISK.SYS)SH /Times-Roman SF 40892 XM (is in the root) 98 W( directory of the)97 W 6120 10737 MT (boot disk. It creates a 384K RAM) 10 W( disk with 512B sector size and space for 128 directories in the extended memory,)11 W 6120 11933 MT (assigning it the disk letter of your first) 82 W( unused disk. And then in your)81 W /Courier SF 35452 XM (AUTOEXEC.BAT)SH /Times-Roman SF 42983 XM (file \050assuming the RAM)81 W 6120 13129 MT (disk is disk)SH /Courier SF 10871 XM (D:)SH /Times-Roman SF (\051 . . .)SH /Courier SF 8520 14784 MT (COPY KERMIT.EXE) SH( D:) 1200 W( >NUL)SH 8520 15815 MT (COPY MSKERMIT.INI D: >NUL)SH 8520 16846 MT (COPY COMMAND.COM D: >NUL)SH 8520 17877 MT (SET COMSPEC=D:\134COMMAND.COM)SH 8520 18908 MT (PATH D:\134; ...)SH /Times-Roman SF 6120 20625 MT (The PATH command allows DOS to find)529 W /Courier SF 26683 XM (KERMIT.EXE)SH /Times-Roman SF (, and Kermit to) 529 W( find)530 W /Courier SF 43496 XM (MSKERMIT.INI)SH /Times-Roman SF 51476 XM (and)SH /Courier SF 6120 21821 MT (COMMAND.COM)SH /Times-Roman SF (, on the RAM disk. If you use Kermit transfer) 1 W( files to your RAM disk, remember to copy those files)SH 6120 23017 MT (to a real disk before you turn off the system.)SH 12 /Times-Bold AF 6120 25605 MT (Use of MS-Kermit in Windowing Environments:)SH 10 /Times-Roman AF 6120 27019 MT (Kermit-MS can operate within windowing environments like such as TopView, DESqview,) 83 W( and MS-Windows. It)84 W 6120 28215 MT (runs in an active window under MS-Windows, accepts cut and paste) 2 W( material, talks with mice, and shrinks to an icon)1 W 6120 29411 MT (\050a boxed "KER"\051. An) 16 W( MS-Windows)17 W /Courier SF 21171 XM (.PIF)SH /Times-Roman SF 23838 XM (file can be constructed for Kermit using the PIFEDIT program, supplied)17 W 6120 30607 MT (with Windows. Memory requirements should be listed as 100 to 148KB. It should state) 155 W( that Kermit does not)154 W 6120 31803 MT (modify the screen, keyboard, memory,) 76 W( COM1, or COM2 \050not true but it satisfies Windows\051. Program switch and)77 W 6120 32999 MT (exchange should be marked as Text,) 30 W( and Close Window on Exit should be checked. This configuration will let you)29 W 6120 34195 MT (run Kermit with all the Windows features,) 144 W( but slowly. To run at full speed under Windows, tell PIFEDIT that)145 W 6120 35391 MT (Kermit modifies the screen. Then you lose the Windows) 87 W( features \050cutting, pasting, running the clock at the same)86 W 6120 36587 MT (time, etc\051, but you still get back to the Windows interface when you EXIT Kermit.)SH 12 /Times-Bold AF 6120 39175 MT (Local Area Network Operation:)SH 10 /Times-Roman AF 6120 40589 MT (MS-Kermit 2.31 is capable of) 39 W( using a serial port on another local area network \050LAN\051 node, so long as that node is)40 W 6120 41785 MT (running an asynchronous) 50 W( communication server and you have installed a device driver on your own PC that makes)49 W 6120 42981 MT (COM1 or other communication port i/o use the network server. This type of connection works) 31 W( because MS-Kermit)32 W 6120 44177 MT (2.30 and) 123 W( later releases on IBM PCs check the selected port to see if it's a real 8250 UART chip, and if it isn't,)122 W 6120 45373 MT (Kermit uses only Bios calls for port i/o, and the network routes these through your network) 13 W( device driver. It may be)14 W 6120 46569 MT (desirable to give the command SET PORT BIOS)27 W /Times-Italic SF (n)SH /Times-Roman SF 26724 XM (\050)SH /Times-Italic SF (n)SH /Times-Roman SF 27834 XM (is a digit) 27 W( 1-4\051 to actively select the Bios port rather than a real)26 W 6120 47765 MT (hardware device. This style of operation) 22 W( should be transparent to Kermit, but not all asynchronous communications)23 W 6120 48961 MT (servers utilize this technique.)SH 6120 51353 MT (As of version 2.30, the IBM PC version of Kermit can also communicate directly) 74 W( with another PC on a local area)73 W 6120 52549 MT (network through the IBM NetBIOS emulator distributed with the LAN.) 127 W( In) 505 W( essence, the LAN substitutes for the)128 W 6120 53745 MT (serial port, modem, and other wiring. Kermit) 81 W( running on one user machine can transfer files with another Kermit)80 W 6120 54941 MT (also on the network much as if they were connected by modems, and Kermit can talk with some larger machines) 14 W( the)15 W 6120 56137 MT (same way. The important network command is)SH /Courier SF 8520 57852 MT (SET PORT NETBIOS)SH /Times-Italic SF 18720 XM (nodename)SH /Times-Roman SF 6120 59569 MT (for NetBios, or)SH /Courier SF 8520 61284 MT (SET PORT UB-NET1)SH /Times-Italic SF 18720 XM (nodename)SH /Times-Roman SF 6120 63001 MT (for Ungermann-Bass Net-One NETCI.) 39 W( For) 326 W( details, see the description of the SET PORT and SERVER commands,)38 W 6120 64197 MT (and \050if you're interested\051 Section 5.17.1 for a technical description.)SH 6120 66589 MT (Kermit can even) 171 W( communicate with some other computers, such as Unix systems, which accept logins via this)172 W 6120 67785 MT (remote pathway. The initial startup is the same as calling a mainframe and logging in except the) 101 W( command SET)100 W 6120 68981 MT (PORT NET)72 W /Times-Italic SF 11264 XM (nodename)SH /Times-Roman SF 15696 XM (is used instead of SET PORT COM1. A connection is established with the first use) 72 W( of the)73 W 6120 70177 MT (communications circuit, such as CONNECT, REMOTE DIR, SEND, or other file transfer command, and terminated)8 W 6120 71373 MT (with the HANGUP command.)SH ES %%Page: 53 54 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.6. Kermit-MS Commands)SH 10 /Times-Italic AF 51775 XM (Page 53)SH 46800 50 8280 5709 UL 14 /Times-Bold AF 8280 8138 MT (5.6. Kermit-MS Commands)SH 10 /Times-Roman AF 8280 10256 MT (MS-DOS Kermit supplies most of the commands and features of "ideal" Kermit. Here's a summary:)SH /Courier SF 16124 13190 MT (-)SH /Times-Roman SF (F)SH 17780 XM (specify alternate init file name on DOS command line.)SH 15280 14295 MT (BYE)SH 17780 XM (to remote server, exit from MS-Kermit.)SH 14002 15400 MT (CLEAR)SH 17780 XM (serial port buffer.)SH 14113 16505 MT (CLOSE)SH 17780 XM (log files and stop logging remote session.)SH 12169 17610 MT (COMMENT)SH 17780 XM (For including comments in command files.)SH 12558 18715 MT (CONNECT)SH 17780 XM (as terminal to remote system \050C\051.)SH 12225 19820 MT (CWD or CD)SH 17780 XM (change local working directory.)SH 13725 20925 MT (DEFINE)SH 17780 XM (a macro of Kermit-MS commands.)SH 13503 22030 MT (DELETE)SH 17780 XM (local files.)SH 11558 23135 MT (DIRECTORY)SH 17780 XM (listing of local files.)SH 13058 24240 MT (DISABLE)SH 17780 XM (server recognition of selected commands.)SH 15836 25345 MT (DO)SH 17780 XM (a command macro.)SH 14558 26450 MT (ECHO)SH 17780 XM (a line of text on the screen.)SH 13336 27555 MT (ENABLE)SH 17780 XM (server recognition of selected commands.)SH 15003 28660 MT (EXIT)SH 17780 XM (from Kermit-MS.)SH 14058 29765 MT (FINISH)SH 17780 XM (Shut down a remote Kermit server.)SH 15336 30870 MT (GET)SH 17780 XM (remote files from server.)SH 14503 31975 MT (GOTO)SH 17780 XM (jump to labeled line in script file.)SH 13114 33080 MT (HANGUP)SH 17780 XM (the phone or network connection.)SH 14780 34185 MT (HELP)SH 17780 XM (about Kermit-MS.)SH 16391 35290 MT (IF)SH 17780 XM (decision-making in Take or Macro scripts.)SH 14336 36395 MT (INPUT)SH 17780 XM (specified string from serial port, for scripts.)SH 15225 37500 MT (LOG)SH 17780 XM (remote terminal session, transactions, or packets.)SH 13170 38605 MT (LOGOUT)SH 17780 XM (remote server, don't exit from Kermit-MS.)SH 14725 39710 MT (MAIL)SH 17780 XM (send file to remote Mailer via Kermit.)SH 13336 40815 MT (OUTPUT)SH 17780 XM (string out serial port, for scripts.)SH 14113 41920 MT (PAUSE)SH 17780 XM (between commands.)SH 15446 43025 MT (POP)SH 17780 XM (exit Take file or Macro.)SH 14724 44130 MT (PUSH)SH 17780 XM (to MS-DOS command level.)SH 14892 45235 MT (QUIT)SH 17780 XM (from Kermit-MS \050same as EXIT\051.)SH 13058 46340 MT (RECEIVE)SH 17780 XM (files from remote Kermit \050R\051.)SH 13058 47445 MT (REINPUT)SH 17780 XM (reread script Input buffer.)SH 13169 48550 MT (REMOTE)SH 17780 XM (Prefix for remote file management commands.)SH 15169 49655 MT (RUN)SH 17780 XM (an MS-DOS program or command.)SH 14669 50760 MT (SEND)SH 17780 XM (files to remote Kermit \050S\051.)SH 13446 51865 MT (SERVER)SH 17780 XM (mode of remote operation.)SH 15502 52970 MT (SET)SH 17780 XM (various parameters.)SH 14336 54075 MT (SHOW)SH 17780 XM (various parameters.)SH 14168 55180 MT (SPACE)SH 17780 XM (inquiry \050about disk space\051.)SH 13502 56285 MT (STATUS)SH 17780 XM (inquiry \050about settings\051.)SH 14669 57390 MT (STAY)SH 17780 XM (stay within Kermit after DOS command line invocation.)SH 14835 58495 MT (STOP)SH 17780 XM (exit all Take files or Macros.)SH 14614 59600 MT (TAKE)SH 17780 XM (commands from a file.)SH 12169 60705 MT (TRANSMIT)SH 17780 XM (a file "raw" \050no error checking\051.)SH 14780 61810 MT (TYPE)SH 17780 XM (a local file on the screen.)SH 12947 62915 MT (VERSION)SH 17780 XM (display Kermit-MS program version number.)SH 14670 64020 MT (WAIT)SH 17780 XM (for the specified modem signal to appear.)SH 8280 66412 MT (Not all of these commands are necessarily) 21 W( available on all MS-DOS systems, and some of the commands may work)22 W 8280 67608 MT (somewhat differently between DOS versions.)SH 8280 70000 MT (A command keyword, such as SEND, RECEIVE, HELP, etc, may be abbreviated, so long) 5 W( as you have typed enough)4 W 8280 71196 MT (letters to distinguish it from other keywords that are) 134 W( valid in that position. For instance, you can type CLE for)135 W ES %%Page: 54 55 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 54)SH 12 /Times-Bold AF 29785 XM (Kermit User Guide: MS-DOS KERMIT \0505.6\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (CLEAR and CLO for CLOSE. Several common commands also have special non-unique abbreviations,) 54 W( like C for)53 W 6120 9082 MT (CONNECT, S for SEND, and R for RECEIVE. Kermit will notify you if you have typed a word) 147 W( with too few)148 W 6120 10278 MT (letters.)SH 6120 12670 MT (During interactive operation, you may edit the command you're currently) 80 W( typing using BACKSPACE to erase the)79 W 6120 13866 MT (character most recently typed, Ctrl-W to delete the most recent field, or Ctrl-U to delete the entire command.) 63 W( The)377 W 6120 15062 MT (editing characters may be used in any combination until the command is finally entered by typing) 217 W( RETURN)216 W 6120 16258 MT (\050Carriage Return, Enter\051 or Ctrl-L.)SH 6120 18650 MT (You may use the) 66 W( help \050``)67 W /Courier SF (?)SH /Times-Roman SF (''\051 and keyword completion \050ESC\051 features freely while typing Kermit-MS commands.)67 W 6120 19846 MT (A question mark typed at almost) 180 W( any point in a command produces a brief description, or "menu", of what is)179 W 6120 21042 MT (expected or possible at that) 27 W( point. ESC typed at any point, except in a local filename, will cause the current field to)28 W 6120 22238 MT (be filled out if what you) 47 W( have typed so far is sufficient to identify it, and will leave you in position to type the next)46 W 6120 23434 MT (field \050or to type a ``)42 W /Courier SF (?)SH /Times-Roman SF ('' to find out what the next field is\051; otherwise, the program will beep at) 42 W( you and wait for you)43 W 6120 24630 MT (to type more characters.)SH 6120 27022 MT (As of version) 13 W( 2.31, Kermit-MS recognizes full 8-bit character inputs, with only NUL, ESC, DEL/BS, Ctrl-W \050delete)12 W 6120 28218 MT (word\051, Ctrl-U \050delete line\051,) 246 W( and Ctrl-C being special. This is to enhance support for various languages and)247 W 6120 29414 MT (keyboards. The) 668 W( SET KEY and SHOW KEY) 209 W( commands can prompt for keyboard input and understand 8-bit)208 W 6120 30610 MT (characters but only at their interactive prompt. The SET KEY, INPUT,) 23 W( and OUTPUT commands accept "backslash)24 W 6120 31806 MT (number format" on the main) 111 W( Kermit command line. Thus, national characters which are full 8-bit codes can be)110 W 6120 33002 MT (expressed on command lines in backslash number form \050\134ddd\051, provided the Kermit command itself can understand)39 W 6120 34198 MT (the form. Most commands that want numbers or single characters as operands understand this) 79 W( notation. To enter)78 W 6120 35394 MT (characters in backslash number format, type a backslash \050``)67 W /Courier SF (\134)SH /Times-Roman SF (''\051 followed by a number corresponding to the ASCII)67 W 6120 36590 MT (code for the character. MS-Kermit) 239 W( accepts many different backslash codes in different contexts. These are)238 W 6120 37786 MT (summarized in Table 5-1; letters following the backslach may be either upper or lower case.)SH 46800 50 6120 39777 UL /Courier SF 7120 42692 MT (\134123)SH /Times-Roman SF 12520 XM (\050up to 3 decimal digits\051 - A decimal number)SH /Courier SF 7120 43797 MT (\134d123)SH /Times-Roman SF 12520 XM (\050up to 3 decimal digits\051 - A decimal number)SH /Courier SF 7120 44902 MT (\134o123)SH /Times-Roman SF 12520 XM (\050up to 3 octal digits\051 - An octal \050base 8\051 number)SH /Courier SF 7120 46007 MT (\134x123)SH /Times-Roman SF 12520 XM (\050up to 3 hexadecimal digits\051 - a hexadecimal \050base 16\051 number)SH /Courier SF 7120 47112 MT (\134{ })SH /Times-Roman SF 12520 XM (For grouping, e.g.)SH /Courier SF 19964 XM (\134{12}6 = Ctrl-L 6)SH /Times-Roman SF (, not)SH /Courier SF 32192 XM (~)SH 7120 48217 MT (\134;)SH /Times-Roman SF 12520 XM (Include a semicolon in a TAKE-file command or macro definition.)SH /Courier SF 7120 49322 MT (\134%)SH /Times-Roman SF 12520 XM (Introduce a Kermit variable,)SH /Courier SF 24100 XM (\134%1, \134%2, ..., \134%a, \134%b, ... \134%z)SH 7120 50427 MT (\134K)SH /Times-Roman SF 12520 XM (A Kermit connect-mode verb like)SH /Courier SF 26267 XM (\134Kexit)SH /Times-Roman SF 30117 XM (\050see Table 5-6\051)SH /Courier SF 7120 51532 MT (\134B)SH /Times-Roman SF 12520 XM (Send a BREAK \050OUTPUT command only\051)SH /Courier SF 7120 52637 MT (\134255)SH /Times-Roman SF 12520 XM (Shorthand for CRLF or LFCR \050INPUT command only\051)SH /Courier SF 7120 53742 MT (\134CD)SH /Times-Roman SF 12520 XM (Carrier Detect RS-232 signal \050WAIT command only\051)SH /Courier SF 7120 54847 MT (\134DSR)SH /Times-Roman SF 12520 XM (Data Set Ready RS-232 signal \050WAIT command only\051)SH /Courier SF 7120 55952 MT (\134CTS)SH /Times-Roman SF 12520 XM (Clear to Send RS-232 signal \050WAIT command only\051)SH /Times-Bold SF 20131 57743 MT (Table 5-1:)SH /Times-Roman SF 24992 XM (MS-DOS Kermit Backslash Codes)SH 46800 50 6120 59553 UL 6120 61745 MT (Table 5-2 shows) 138 W( all of the 7-bit ASCII codes in decimal. Most Kermit commands understand backslash-ASCII)139 W 6120 62941 MT (codes, both imbedded within character strings, and alone, as when a single character or number is to be specified.)SH 6120 65333 MT (Some Kermit-MS commands like GET, SHOW KEY, and SET KEY, may prompt for additional information) 124 W( on)123 W 6120 66529 MT (subsequent lines. If) 84 W( you have reached one of these prompts and then wish to cancel the command, you may type)85 W 6120 67725 MT (Control-C to get back to the main)SH /Courier SF 19814 XM (Kermit-MS>)SH /Times-Roman SF 26064 XM (prompt.)SH ES %%Page: 55 56 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.6. Kermit-MS Commands)SH 10 /Times-Italic AF 51775 XM (Page 55)SH 46800 50 8280 5709 UL 46800 50 8280 8086 UL /Courier SF 10680 10865 MT (Dec Name Ctrl) SH( Dec) 6600 W( Char) SH( Dec) 3000 W( Char) SH( Dec) 2400 W( Char)SH 1800 50 10680 11065 UL 2400 50 13080 11065 UL 2400 50 16080 11065 UL 1800 50 25680 11065 UL 2400 50 28080 11065 UL 1800 50 34080 11065 UL 2400 50 36480 11065 UL 1800 50 41880 11065 UL 2400 50 44280 11065 UL 11280 12927 MT (0 NUL) 1200 W( ^@) 600 W( |) 6000 W( 32 SP |) 600 W( 64 @ | 96) 1200 W( `)600 W 11280 13958 MT (1 SOH) 1200 W( ^A) 600 W( |) 6000 W( 33) 600 W( !) 1200 W( |) 1800 W( 65 A | 97) 1200 W( a)600 W 11280 14989 MT (2 STX) 1200 W( ^B) 600 W( |) 6000 W( 34) 600 W( ") 1200 W( |) 1800 W( 66 B | 98) 1200 W( b)600 W 11280 16020 MT (3 ETX) 1200 W( ^C) 600 W( |) 6000 W( 35) 600 W( #) 1200 W( |) 1800 W( 67 C | 99) 1200 W( c)600 W 11280 17051 MT (4 EOT) 1200 W( ^D) 600 W( |) 6000 W( 36) 600 W( $) 1200 W( |) 1800 W( 68 D |) 1200 W( 100 d)600 W 11280 18082 MT (5 ENQ) 1200 W( ^E) 600 W( |) 6000 W( 37) 600 W( %) 1200 W( |) 1800 W( 69 E |) 1200 W( 101 e)600 W 11280 19113 MT (6 ACK) 1200 W( ^F) 600 W( |) 6000 W( 38) 600 W( &) 1200 W( |) 1800 W( 70 F |) 1200 W( 102 f)600 W 11280 20144 MT (7 BEL) 1200 W( ^G) 600 W( beep) SH( |) 3000 W( 39) 600 W( ') 1200 W( |) 1800 W( 71 G |) 1200 W( 103 g)600 W 11280 21175 MT (8 BS ^H) 1200 W( backspace | 40) SH( \050) 1200 W( |) 1800 W( 72 H |) 1200 W( 104 h)600 W 11280 22206 MT (9 HT ^I) 1200 W( tab) SH( |) 3600 W( 41) 600 W( \051) 1200 W( |) 1800 W( 73 I |) 1200 W( 105 i)600 W 10680 23237 MT (10 LF ^J) 1200 W( linefeed | 42) SH( *) 1200 W( |) 1800 W( 74 J |) 1200 W( 106 j)600 W 10680 24268 MT (11 VT ^K) 1200 W( |) 6000 W( 43) 600 W( +) 1200 W( |) 1800 W( 75 K |) 1200 W( 107 k)600 W 10680 25299 MT (12 FF ^L) 1200 W( formfeed | 44) SH( ,) 1200 W( |) 1800 W( 76 L |) 1200 W( 108 l)600 W 10680 26330 MT (13 CR ^M) 1200 W( return) SH( |) 1800 W( 45) 600 W( -) 1200 W( |) 1800 W( 77 M |) 1200 W( 109 m)600 W 10680 27361 MT (14 SO ^N) 1200 W( shift out | 46) SH( .) 1200 W( |) 1800 W( 78 N |) 1200 W( 110 n)600 W 10680 28392 MT (15 SI ^O) 1200 W( shift in | 47) SH( /) 1200 W( |) 1800 W( 79 O |) 1200 W( 111 o)600 W 10680 29423 MT (16 DLE) 1200 W( ^P) 600 W( |) 6000 W( 48) 600 W( 0) 1200 W( |) 1800 W( 80 P |) 1200 W( 112 p)600 W 10680 30454 MT (17 DC1) 1200 W( ^Q) 600 W( XON) SH( |) 3600 W( 49) 600 W( 1) 1200 W( |) 1800 W( 81 Q |) 1200 W( 113 q)600 W 10680 31485 MT (18 DC2) 1200 W( ^R) 600 W( |) 6000 W( 50) 600 W( 2) 1200 W( |) 1800 W( 82 R |) 1200 W( 114 r)600 W 10680 32516 MT (19 DC3) 1200 W( ^S) 600 W( XOFF) SH( |) 3000 W( 51) 600 W( 3) 1200 W( |) 1800 W( 83 S |) 1200 W( 115 s)600 W 10680 33547 MT (20 DC4) 1200 W( ^T) 600 W( |) 6000 W( 52) 600 W( 4) 1200 W( |) 1800 W( 84 T |) 1200 W( 116 t)600 W 10680 34578 MT (21 NAK) 1200 W( ^U) 600 W( |) 6000 W( 53) 600 W( 5) 1200 W( |) 1800 W( 85 U |) 1200 W( 117 u)600 W 10680 35609 MT (23 ETB) 1200 W( ^W) 600 W( |) 6000 W( 54) 600 W( 6) 1200 W( |) 1800 W( 86 V |) 1200 W( 118 v)600 W 10680 36640 MT (22 SYN) 1200 W( ^V) 600 W( |) 6000 W( 55) 600 W( 7) 1200 W( |) 1800 W( 87 W |) 1200 W( 119 w)600 W 10680 37671 MT (24 CAN) 1200 W( ^X) 600 W( |) 6000 W( 56) 600 W( 8) 1200 W( |) 1800 W( 88 X |) 1200 W( 120 x)600 W 10680 38702 MT (25 EM ^Y) 1200 W( |) 6000 W( 57) 600 W( 9) 1200 W( |) 1800 W( 89 Y |) 1200 W( 121 y)600 W 10680 39733 MT (26 SUB) 1200 W( ^Z) 600 W( |) 6000 W( 58) 600 W( :) 1200 W( |) 1800 W( 90 Z |) 1200 W( 122 z)600 W 10680 40764 MT (27 ESC) 1200 W( ^[) 600 W( escape) SH( |) 1800 W( 59) 600 W( ;) 1200 W( |) 1800 W( 91 [ |) 1200 W( 123 {)600 W 10680 41795 MT (28 FS ^\134) 1200 W( |) 6000 W( 60) 600 W( <) 1200 W( |) 1800 W( 92 \134 |) 1200 W( 124 |)600 W 10680 42826 MT (29 GS ^]) 1200 W( |) 6000 W( 61) 600 W( =) 1200 W( |) 1800 W( 93 ] |) 1200 W( 125 })600 W 10680 43857 MT (30 RS ^^) 1200 W( |) 6000 W( 62) 600 W( >) 1200 W( |) 1800 W( 94 ^ |) 1200 W( 126 ~)600 W 10680 44888 MT (31 US ^_) 1200 W( |) 6000 W( 63) 600 W( ?) 1200 W( |) 1800 W( 95 _ |) 1200 W( 127 RUBOUT,DELETE)600 W /Times-Bold SF 19543 46605 MT (Table 5-2:)SH /Times-Roman SF 24404 XM (The US ASCII Character Set \050ANSI X3.4-1977\051)SH 46800 50 8280 48415 UL 12 /Times-Bold AF 8280 50803 MT (Summary of Kermit-MS command editing characters:)SH 10 /Times-Roman AF 10280 52594 MT (SPACE)SH 14280 XM (Separates fields within the command.)SH 10280 54171 MT (TAB)SH 14280 XM (Same as Space, and echoes as Space. You may also use Ctrl-I for Tab.)SH 10280 55748 MT (BACKSPACE)SH 14280 56853 MT (Deletes the character most recently typed. May be typed repeatedly to delete all) 37 W( the way back to the)38 W 14280 57958 MT (prompt. You) 250 W( may also use DELETE, RUBOUT, Ctrl-H, or equivalent keys.)SH 10280 59535 MT (Ctrl-W)SH 14280 XM (Deletes the most recent "word", or field, on the command line. May be typed repeatedly.)SH 10280 61112 MT (Ctrl-U)SH 14280 XM (Deletes the entire command line, back to the prompt.)SH 10280 62689 MT (Ctrl-C)SH 14280 XM (Cancels the current command and) 2 W( returns to the ")1 W /Courier SF (Kermit-MS>)SH /Times-Roman SF (" prompt. Also, terminates execution)1 W 14280 63794 MT (of a TAKE command file.)SH 10280 65371 MT (ESC)SH 14280 XM (If enough characters have been supplied) 44 W( in the current keyword to identify it uniquely the remainder)45 W 14280 66476 MT (of the field is supplied and the cursor is positioned to the next field of the command.) 79 W( Otherwise,) 407 W( a)78 W 14280 67581 MT (beep is sounded. ESC does not provide filename completion in version 2.31.)SH /Courier SF 10280 69158 MT (?)SH /Times-Roman SF 14280 XM (Displays a brief message describing what may be typed in the current) 5 W( command field. Also, wildcard)6 W 14280 70263 MT (character for matching any single character in all but the first position of a filename.)SH /Courier SF 10280 71840 MT (#)SH /Times-Roman SF 14280 XM (Wildcard character for matching single characters in filenames. Equivalent to) 121 W( MS-DOS ``)120 W /Courier SF (?)SH /Times-Roman SF ('', but)120 W ES %%Page: 56 57 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 56)SH 12 /Times-Bold AF 29785 XM (Kermit User Guide: MS-DOS KERMIT \0505.6\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 12120 7886 MT (used in the first position of a filename only, so that ``)3 W /Courier SF (?)SH /Times-Roman SF ('' may be used to get help at the beginning of a)3 W 12120 8991 MT (filename field.)SH 8120 10568 MT (RETURN)SH 12120 11673 MT (Enters the command. On most keyboards, you may also use ENTER or Ctrl-M.)SH 8120 13250 MT (Ctrl-L)SH 12120 XM (Clears the screen and enters the command.)SH 6120 15642 MT (Liberal use of ``)50 W /Courier SF (?)SH /Times-Roman SF ('' allows you to feel) 50 W( your way through the commands and their fields. This feature is sometimes)51 W 6120 16838 MT (called "menu on demand" or "context sensitive help" -- unlike systems that force you to) 84 W( negotiate menus at every)83 W 6120 18034 MT (turn, menu-on-demand provides help only when it is needed.)SH 6120 20426 MT (Command reading is done through DOS calls) 67 W( and Kermit key redefinition does not apply at Kermit-MS command)68 W 6120 21622 MT (level. But)340 W /Courier SF 10644 XM (ANSI.SYS)SH /Times-Roman SF 15739 XM (or other external console drivers can be used for this purpose, for) 45 W( instance to assign ESC to)44 W 6120 22818 MT (the PC's) 33 W( backquote key \050)34 W /Courier SF (ANSI.SYS)SH /Times-Roman SF 21393 XM (is the IBM-supplied extended screen and keyboard device driver, described in)34 W 6120 24014 MT (the IBM DOS Technical Reference Manual\051. Other console drivers available include ProKey,) 353 W( SuperKey,)352 W /Courier SF 6120 25210 MT (NANSI.SYS)SH /Times-Roman SF 11770 XM (\050a public-domain replacement for)SH /Courier SF 25433 XM (ANSI.SYS)SH /Times-Roman SF (\051, and FANSICONSOLE.)SH 6120 27602 MT (The notation used in command descriptions is as follows:)SH /Courier SF 8120 29393 MT ([)SH /Times-Roman SF (square brackets)SH /Courier SF (])SH /Times-Roman SF 12120 30498 MT (An optional field. This field may be omitted.)SH /Courier SF 8120 32075 MT ({)SH /Times-Roman SF (curly braces)SH /Courier SF (})SH /Times-Roman SF 12120 33180 MT (A list of alternatives, separated by commas. Choose one of the items from the list.)SH /Times-Italic SF 8120 34757 MT (italics)SH /Times-Roman SF 12120 XM (Shows parameters, such as numbers or filenames, are shown in italics \050providing) 224 W( the printer is)225 W 12120 35862 MT (capable of printing italics\051. You substitute the actual number or filename.)SH 8120 37439 MT (underlining)SH 4611 50 8120 37639 UL 12120 38544 MT (In dialog examples, the characters) 107 W( you should type are underlined \050on printers that can show it\051 to)108 W 12120 39649 MT (distinguish them from computer typeout.)SH /Courier SF 8120 41226 MT (hh:mm:ss)SH /Times-Roman SF 12120 42331 MT (A time of day,) 93 W( in 24-hour notation \05010:00:00 is 10 AM; 23:30:00 is 11:30 PM\051, which may not be)94 W 12120 43436 MT (more than 12 hours later than the current time.)SH 6120 45227 MT (The following sections) 219 W( describe all the MS-DOS Kermit commands. Since some command descriptions may)218 W 6120 46423 MT (contain references to other commands that) 37 W( haven't been explained yet, you might find that this manual makes more)38 W 6120 47619 MT (sense on a second reading.)SH 12 /Times-Bold AF 6120 50735 MT (5.6.1. Program Management Commands)SH 10 /Times-Roman AF 6120 52677 MT ("Program management" is a rubric for Kermit-MS commands like TAKE, EXIT, HELP,) 61 W( COMMENT, ECHO, and)60 W 6120 53873 MT (VERSION, that don't fall into any other category.)SH 6120 56265 MT (HELP displays a one screen introduction to frequently used Kermit commands and their editing keys, and) 52 W( suggests)53 W 6120 57461 MT (using the question mark command to see the terse list of primary level Kermit commands.)SH 6120 59853 MT (VERSION displays the MS-Kermit program version number, which you should know in case you are reporting) 7 W( bugs)6 W 6120 61049 MT (or seeking technical assistance.)SH 6120 63441 MT (Other program management commands require a bit more explanation.)SH ES %%Page: 57 58 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.6.1. Program Management Commands)SH 10 /Times-Italic AF 51775 XM (Page 57)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (The EXIT Command)SH 10 /Times-Roman AF 8280 9418 MT (Syntax:)SH /Courier SF 11586 XM (EXIT)SH /Times-Italic SF 14486 XM (or)SH /Courier SF 15875 XM (QUIT)SH /Times-Roman SF 8280 11810 MT (EXIT and QUIT are synonyms for each other.) 191 W( They) 634 W( cause MS-Kermit to return control to DOS or whatever)192 W 8280 13006 MT (program invoked MS-Kermit. The specific actions taken are:)SH /Symbol SF 10070 14911 MT (\267)SH /Times-Roman SF 10780 XM (Close any open log or other files.)SH /Symbol SF 10070 16016 MT (\267)SH /Times-Roman SF 10780 XM (Close any open network connection.)SH /Symbol SF 10070 17121 MT (\267)SH /Times-Roman SF 10780 XM (Release all memory claimed by the program.)SH /Symbol SF 10070 18226 MT (\267)SH /Times-Roman SF 10780 XM (Return interrupts for the currently selected communication device to their original owner.)SH /Symbol SF 10070 19331 MT (\267)SH /Times-Roman SF 10780 XM (Terminate execution.)SH 8280 21122 MT (The serial port RS-232 signals are left alone upon EXIT, so that modem connections are not broken. Kermit-MS)88 W 8280 22318 MT (may be restarted with the connection intact. Use HANGUP to explicitly break a modem connection; and) SH( use SHOW)1 W 8280 23514 MT (MODEM or SHOW COMMUNICATIONS to view the) 44 W( status of modem signals CARRIER DETECT, DATA SET)43 W 8280 24710 MT (\050modem\051 READY, and CLEAR TO SEND.)SH 12 /Times-Bold AF 8280 27298 MT (The STAY Command)SH 10 /Times-Roman AF 8280 28712 MT (Syntax:)SH /Courier SF 11586 XM (STAY)SH /Times-Roman SF 8280 31104 MT (The STAY command, if included among command line arguments, instructs MS-Kermit not to exit) 339 W( upon)340 W 8280 32300 MT (completion but rather to enter interactive mode, unless EXIT or) 30 W( QUIT was among the command arguments. STAY)29 W 8280 33496 MT (has no effect when entered interactively or from a TAKE file.)SH 12 /Times-Bold AF 8280 36084 MT (The PUSH Command)SH 10 /Times-Roman AF 8280 37498 MT (Syntax:)SH /Courier SF 11586 XM (PUSH)SH /Times-Roman SF 8280 39890 MT (PUSH is similar to EXIT, except it leaves MS-Kermit intact by invoking an MS-DOS command processor) 53 W( "under")54 W 8280 41086 MT (Kermit-MS, either)3 W /Courier SF 15924 XM (COMMAND.COM)SH /Times-Roman SF 22777 XM (or whatever shell you have specified with COMSPEC) 3 W( \050or SHELL, depending on)2 W 8280 42282 MT (the system\051 in your)23 W /Courier SF 16316 XM (CONFIG.SYS)SH /Times-Roman SF 22589 XM (file. You) 296 W( can return to Kermit-MS by typing the MS-DOS EXIT command,) 23 W( and)24 W 8280 43478 MT (you will find Kermit-MS as you left it, with) 13 W( all settings and the terminal emulation screen intact. The same function)12 W 8280 44674 MT (is invoked by the CONNECT escape-level command P. Example:)SH /Courier SF 10680 46389 MT (Kermit-MS>push)SH /Times-Italic SF 28680 XM (Push to DOS.)SH 2400 50 16680 46589 UL /Courier SF 10680 47420 MT (Command v3.10)SH 28680 XM (COMMAND.COM)SH /Times-Italic SF 35880 XM (program herald.)SH /Courier SF 10680 49135 MT (C>diskcopy a: b:)SH /Times-Italic SF 28680 XM (Run a DOS program.)SH 8400 50 11880 49335 UL 11880 50852 MT (DISKCOPY dialog here)SH /Times-Roman SF 21741 XM (. . .)SH /Courier SF 10680 52569 MT (C>dir b:)SH /Times-Italic SF 28680 XM (More DOS commands)SH /Times-Roman SF 37817 XM (. . .)SH 3600 50 11880 52769 UL /Times-Italic SF 11880 54286 MT (DOS session continues)SH /Times-Roman SF 21296 XM (. . .)SH /Courier SF 10680 56001 MT (C>exit)SH /Times-Italic SF 28680 XM (When done, type DOS EXIT command.)SH 2400 50 11880 56201 UL /Courier SF 10680 57032 MT (Kermit-MS>)SH /Times-Italic SF 28680 XM (Back at Kermit.)SH 12 /Times-Bold AF 8280 59620 MT (The TAKE Command)SH 10 /Times-Roman AF 8280 61034 MT (Syntax:)SH /Courier SF 11586 XM (TAKE)SH /Times-Italic SF 14586 XM (filespec)SH /Times-Roman SF 8280 63426 MT (The TAKE command gives you way a to collect MS-Kermit) 77 W( commands into a single file, so that you can execute)78 W 8280 64622 MT (many commands by typing a single \050TAKE\051 command. TAKE instructs MS-Kermit to execute) 21 W( commands from the)20 W 8280 65818 MT (file that you specify. The current directory is searched) 34 W( for the file first, and then any directories listed in the PATH)35 W 8280 67014 MT (environment variable. The command file may include any valid Kermit-MS commands, including TAKE, but it)124 W 8280 68210 MT (cannot include characters to) 92 W( be sent to a remote host after a CONNECT command \050use scripts for that, described)93 W 8280 69406 MT (below\051. Execution) 250 W( of a TAKE file may be cancelled by typing Control-C at the keyboard.)SH 8280 71798 MT (An implicit TAKE command is executed upon the initialization) 63 W( file,)62 W /Courier SF 36434 XM (MSKERMIT.INI)SH /Times-Roman SF 43946 XM (\050or another file specified in)62 W ES %%Page: 58 59 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 58)SH 12 /Times-Bold AF 28885 XM (Kermit User Guide: MS-DOS KERMIT \0505.6.1\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (the ``)217 W /Courier SF (-f)SH /Times-Roman SF ('' command-line argument\051, whenever you start MS-Kermit. The)217 W /Courier SF 38206 XM (MSKERMIT.INI)SH /Times-Roman SF 45874 XM (file contains any)218 W 6120 9082 MT (commands you want) 94 W( to be executed each time you run Kermit. A sample is shown above, and a more ambitious)93 W 6120 10278 MT (example is shown in section 5.9.)SH 6120 12670 MT (Commands within TAKE files,) 351 W( unlike interactive commands, may include trailing comments, preceded by)352 W 6120 13866 MT (semicolons:)SH /Courier SF 8520 15521 MT (set port 2) SH( ;) 3000 W( Select the modem port.)SH 8520 16552 MT (set speed 1200 ; Set the baud rate for the modem.)SH 8520 17583 MT (connect ;) 4800 W( Conduct a terminal session.)SH 8520 18614 MT (hangup ;) 5400 W( Hang up the phone after escaping back.)SH /Times-Roman SF 6120 20331 MT (Note the HANGUP command after CONNECT. The HANGUP command is not executed until) 108 W( after you escape)107 W 6120 21527 MT (back from your CONNECT session.) 101 W( If) 454 W( this file were called)102 W /Courier SF 31289 XM (MODEM.CMD)SH /Times-Roman SF (, the following TAKE command would)102 W 6120 22723 MT (execute it:)SH /Courier SF 8520 24378 MT (Kermit-MS>take modem.cmd)SH 8400 50 14520 24578 UL /Times-Roman SF 6120 26095 MT (This directs MS-Kermit to find the)26 W /Courier SF 20442 XM (MODEM.CMD)SH /Times-Roman SF 26118 XM (file, open it, execute the commands in it, close) 26 W( it, and return to the)25 W /Courier SF 6120 27291 MT (MS-Kermit>)SH /Times-Roman SF 12370 XM (prompt when done. This process can take a while on floppy-disk based systems.)SH 6120 29683 MT (Since TAKE file processing discards) 27 W( all characters from a line beginning with the first semicolon, it is normally not)28 W 6120 30879 MT (possible to include semicolons as part of the commands themselves, e.g.)SH /Courier SF 8520 32534 MT (get dska:foo.bar;6)SH /Times-Roman SF 6120 34251 MT (To get around this restriction, you may precede such semicolons with a backslash:)SH /Courier SF 8520 35906 MT (get dska:foo.bar\134;6)SH /Times-Roman SF 6120 38298 MT (Commands from the TAKE file will normally not be displayed on your screen during execution. If) 28 W( you want to see)27 W 6120 39494 MT (them as they) 257 W( are executing, you can SET TAKE-ECHO ON \050for instance, at the beginning or end of your)258 W /Courier SF 6120 40690 MT (MSKERMIT.INI)SH /Times-Roman SF 13623 XM (file\051. With) 354 W( the echoing ON, comments are also displayed for reference, but the semicolon is not)52 W 6120 41886 MT (shown.)SH 6120 44278 MT (TAKE files may be nested to a reasonable level. A command file that was) 168 W( invoked by another command file)169 W 6120 45474 MT (normally returns to its invoking command file, rather than to the)193 W /Courier SF 34241 XM (MS-Kermit>)SH /Times-Roman SF 40684 XM (prompt, when the end of the)192 W 6120 46670 MT (command file is reached.)SH 6120 49062 MT (TAKE files have two commands to quit processing before the end of the file is reached.) 61 W( The) 373 W( POP command exits)62 W 6120 50258 MT (the current TAKE file \050or macro\051 and returns control to the previously executing TAKE or macro,) 127 W( where one is)126 W 6120 51454 MT (invoked within another. The STOP command exits all TAKE) 89 W( files and macros and returns directly to the Kermit)90 W 6120 52650 MT (prompt.)SH 6120 55042 MT (In TAKE files \050and macro definitions, which are discussed later\051, long commands may be continued on subsequent)47 W 6120 56238 MT (lines by terminating each continued line with a hyphen \050minus sign\051. If a line) 83 W( needs to terminate on a real minus)84 W 6120 57434 MT (sign it may be expressed numerically) 47 W( as)46 W /Courier SF 22639 XM (\13445)SH /Times-Roman SF 24735 XM (or can be extented with extra spaces. The overall command length is)46 W 6120 58630 MT (normally 127 bytes \050a beep sounds near this limit\051.)SH 6120 61022 MT (An explicit quertion mark \050``)60 W /Courier SF (?)SH /Times-Roman SF (''\051 in a TAKE file will cause a help message to be displayed and the rest of the line)60 W 6120 62218 MT (will be read as another command. If you need to include a question mark) 56 W( in a command, use the ASCII backslash)55 W 6120 63414 MT (notation ")SH /Courier SF (\13463)SH /Times-Roman SF (".)SH ES %%Page: 59 60 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.6.1. Program Management Commands)SH 10 /Times-Italic AF 51775 XM (Page 59)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (The -F Command)SH 10 /Times-Roman AF 8280 9418 MT (Syntax:)SH /Courier SF 11586 XM (-F)SH /Times-Italic SF 13386 XM (filespec)SH /Times-Roman SF 8280 11810 MT (The ``)9 W /Courier SF (-f)SH /Times-Roman SF ('' command is effective only on the DOS command line.) 9 W( It) 270 W( instructs MS-Kermit to use the specified file as)10 W 8280 13006 MT (its initialization) 2 W( file, rather than)1 W /Courier SF 21174 XM (MSKERMIT.INI)SH /Times-Roman SF (. Unlike) 252 W( other command-line arguments, ``)1 W /Courier SF (-f)SH /Times-Roman SF ('' does not, of itself,)1 W 8280 14202 MT (cause MS-Kermit to exit upon completion. Example:)SH /Courier SF 10680 15857 MT (C>kermit -f sunday.ini)SH 12000 50 11880 16057 UL 10680 16888 MT (Kermit-MS>)SH /Times-Roman SF 8280 18605 MT (The -F command line) 211 W( option allows different MS-Kermit initialization files to coexist. You can create batch)212 W 8280 19801 MT (commands to invoke Kermit in different ways, for instance)371 W /Courier SF 35504 XM (MONDAY.BAT)SH /Times-Roman SF 42125 XM (might contain) 371 W( ``)370 W /Courier SF (kermit -f)370 W 8280 20997 MT (monday.ini)SH /Times-Roman SF ('',)SH /Courier SF 15446 XM (TUESDAY.BAT)SH /Times-Roman SF 22296 XM (``)SH /Courier SF (kermit -f tuesday.ini)SH /Times-Roman SF ('', etc.)SH 12 /Times-Bold AF 8280 23585 MT (The ECHO Command)SH 10 /Times-Roman AF 8280 24999 MT (Syntax:)SH /Courier SF 11586 XM (ECHO [)SH /Times-Italic SF (string)SH /Courier SF (])SH /Times-Roman SF 8280 27391 MT (The ECHO command writes the string to the screen, without adding a) 65 W( carriage return or line feed. ECHO may be)66 W 8280 28587 MT (used to report) 96 W( progress during execution of a TAKE command file, or to issue prompts during the execution of a)95 W 8280 29783 MT (script.)SH /Courier SF 10680 31438 MT (ECHO Part one completed...\13413)SH /Times-Roman SF 8280 33155 MT (The number at the end is a "backslash codes" for ASCII control characters, in) 15 W( this case carriage return \050)16 W /Courier SF (\13413)SH /Times-Roman SF (\051. Since)282 W 8280 34351 MT (the ECHO command) 245 W( interprets backslash codes,)244 W /Courier SF 29326 XM (ANSI.SYS)SH /Times-Roman SF 34620 XM (and similar console drivers can be programmed)244 W 8280 35547 MT (through this command by embedding ANSI escape sequences \050see section 5.16.3\051 in the echo) 93 W( string. The ECHO)94 W 8280 36743 MT (command always outputs a linefeed before the string.)SH 12 /Times-Bold AF 8280 39331 MT (The COMMENT Command)SH 10 /Times-Roman AF 8280 40941 MT (Syntax:)SH /Courier SF 11586 XM (COMMENT)SH /Times-Italic SF 16386 XM (text)SH /Times-Roman SF 8280 43333 MT (The COMMENT command lets you add comments to a TAKE command file. The) 162 W( word COMMENT \050or any)161 W 8280 44529 MT (unique prefix thereof\051 must appear as the first word on the line.) 86 W( The) 424 W( COMMENT command may also be entered)87 W 8280 45725 MT (interactively. It) 250 W( has no effect at all. Example:)SH /Courier SF 10680 47380 MT (COMMENT - MS-Kermit command file to connect port 2 to an IBM mainframe)SH 10680 48411 MT (set port 2)SH 10680 49442 MT (set speed 4800) SH( ;) 1200 W( Transmission rate is 4800)SH 10680 50473 MT (do ibm) SH( ;) 6000 W( Set parameters for IBM linemode)SH 10680 51504 MT (connect ;) 5400 W( Be a terminal)SH /Times-Roman SF 8280 53221 MT (Question marks can be included in comments without invoking the help function.)SH 12 /Times-Bold AF 8280 56337 MT (5.6.2. Local File Management Commands)SH 10 /Times-Roman AF 8280 58279 MT (These commands are executed on your local PC, and generally invoke DOS services.) 73 W( This) 394 W( allows you to perform)72 W 8280 59475 MT (common DOS functions without leaving Kermit. All file specifications may include device and/or) 48 W( directory fields.)49 W 8280 60671 MT (The local file management commands are:)SH /Times-Bold SF 8280 62460 MT (CWD)SH /Times-Italic SF 10974 XM (path)SH /Times-Roman SF 12280 63565 MT (Changes the current working directory to the given) 194 W( path. All references to local file names without)195 W 12280 64670 MT (explicit paths will refer to that path. A drive letter may be included to) 135 W( also change disk drives. This)134 W 12280 65775 MT (command affects Kermit and any inferior) 14 W( programs that you RUN or PUSH to, but your previous disk and)15 W 12280 66880 MT (directory are restored when you exit from Kermit. For consistency with DOS, you may also type CD.)SH /Times-Bold SF 8280 68457 MT (DELETE)SH /Times-Italic SF 12587 XM (filespec)SH /Times-Roman SF 12280 69562 MT (Deletes the specified file or files.) 166 W( As) 583 W( in DOS, the names of the deleted files are not listed, only the)167 W 12280 70667 MT (message "file\050s\051 deleted" or "file\050s\051 not found", and if you give the command "delete)91 W /Courier SF 47671 XM (*.*)SH /Times-Roman SF (", Kermit-MS)90 W 12280 71772 MT (will prompt "Are you sure?" since DOS is doing the work.)SH ES %%Page: 60 61 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 60)SH 12 /Times-Bold AF 28885 XM (Kermit User Guide: MS-DOS KERMIT \0505.6.2\051)SH 46800 50 6120 5709 UL 10 SS 6120 7886 MT (DIRECTORY)SH /Times-Roman SF 12481 XM ([)SH /Times-Italic SF (filespec)SH /Times-Roman SF (])SH 10120 8991 MT (Lists the names,) 58 W( sizes, and creation dates of files that match the given file specification. If no filespec is)57 W 10120 10096 MT (given, the command is equivalent to)SH /Courier SF 24869 XM (DIR *.*)SH /Times-Roman SF (. Normal) 250 W( DOS switches are effective.)SH /Times-Bold SF 6120 11673 MT (SPACE)SH /Times-Roman SF 10120 XM (Tells how much space is available on the current disk.)SH /Times-Bold SF 6120 13250 MT (RUN)SH /Times-Italic SF 8536 XM (command)SH /Times-Roman SF 10120 14355 MT (Passes the command line to)223 W /Courier SF 22540 XM (COMMAND.COM)SH /Times-Roman SF 29613 XM (for execution. Any legal DOS operation) 223 W( is permitted:)222 W 10120 15460 MT (running a program \050perhaps with command line arguments or i/o redirection\051, executing a DOS command,)14 W 10120 16565 MT (or executing a batch file. Kermit is suspended while the command is executed and) 28 W( automatically resumes)27 W 10120 17670 MT (afterward. You) 558 W( may even nest RUN) 154 W( KERMIT commands several times if memory is available. The)155 W 10120 18775 MT (command will be executed directly by)SH /Courier SF 25673 XM (COMMAND.COM)SH /Times-Roman SF 32523 XM (so follow the rules of DOS. Example:)SH /Courier SF 12520 20430 MT (Kermit-MS>run more < kim.txt)SH 10800 50 18520 20630 UL /Times-Bold SF 6120 22219 MT (TYPE)SH /Times-Italic SF 9037 XM (filespec)SH /Times-Roman SF 10120 23324 MT (Displays the specified local file on the screen. Automatic pause is not available) 47 W( at the end of a page \050but)48 W 10120 24429 MT (see above example for how to accomplish this\051. On most systems, Ctrl-S) 82 W( can be typed to stop scrolling)81 W 10120 25534 MT (and Ctrl-Q to continue scrolling.)SH 6120 27325 MT (In most cases when you issue) 31 W( a local command, Kermit attempts to run the equivalent DOS command. If you get a)32 W 6120 28521 MT (message like ")34 W /Courier SF (?Unable to execute program)34 W /Times-Roman SF (", it means that Kermit could not find)34 W /Courier SF 43171 XM (COMMAND.COM)SH /Times-Roman SF (, or that)33 W 6120 29717 MT (there was not enough memory left to) 29 W( load it. To ensure that Kermit can find)30 W /Courier SF 37395 XM (COMMAND.COM)SH /Times-Roman SF (, you should include a)30 W 6120 30913 MT (PATH statement in your)155 W /Courier SF 16795 XM (AUTOEXEC.BAT)SH /Times-Roman SF 24399 XM (file, which includes the device and directory where)154 W /Courier SF 46320 XM (COMMAND.COM)SH /Times-Roman SF 6120 32109 MT (resides.)SH 6120 34501 MT (You can add your own local commands by defining macros for them. For example:)SH /Courier SF 8520 36156 MT (define edit run epsilon \134%1)SH 8520 37187 MT (define more run more < \134%1)SH 8520 38218 MT (define rename run ren \134%1 \134%2)SH /Times-Roman SF 6120 39935 MT (Then you can use these commands at Kermit-MS prompt) 158 W( level: "edit foo.bar", "more oofa.txt", "rename old.txt)159 W 6120 41131 MT (new.txt". However,) 250 W( you cannot redefine built-in commands, for example:)SH /Courier SF 8520 42786 MT (define send receive \134%1)SH /Times-Roman SF 6120 44503 MT (See Section 5.7 for further information about macros.)SH ES %%Page: 61 62 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.6.2. Local File Management Commands)SH 10 /Times-Italic AF 51775 XM (Page 61)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (5.6.3. COMMANDS FOR TERMINAL CONNECTION)SH 10 /Times-Roman AF 8280 9946 MT (The CONNECT command connects your PC as a terminal to the remote) 53 W( system so that you may conduct a session)52 W 8280 11142 MT (there, and the HANGUP command may be used to) 157 W( disconnect your modem \050if you have one\051 from the remote)158 W 8280 12338 MT (system. There) 341 W( is presently no built-in DIAL command. Modems may be dialed "manually" during CONNECT, or)45 W 8280 13534 MT (you can construct your own DIAL command by using scripts, which are described in detail in subsequent sections.)SH 8280 15926 MT (For completeness, the descriptions below contain copious reference to the SET commands, which let you) 19 W( modify all)20 W 8280 17122 MT (sorts of terminal and communication parameters \050the SET commands are described in a later) 2 W( section\051. MS-Kermit is)1 W 8280 18318 MT (initially set up with the following parameters, so that you only need to issue SET commands for) 58 W( those that need to)59 W 8280 19514 MT (be changed:)SH 10280 21305 MT (PORT)SH 22280 XM (1 \050in most cases, e.g. COM1 on the IBM PC family\051)SH 10280 22410 MT (TERMINAL)SH 22280 XM (VT102\050*\051 emulation \050IBM PC, DEC Rainbow\051)SH 10280 23515 MT (SPEED)SH 22280 XM (Whatever the serial card is currently set to.)SH 10280 24620 MT (PARITY)SH 22280 XM (None)SH 10280 25725 MT (FLOW-CONTROL)SH 22280 XM (XON/XOFF)SH 10280 26830 MT (HANDSHAKE)SH 22280 XM (None)SH 10280 27935 MT (LOCAL-ECHO)SH 22280 XM (Off)SH 10280 29040 MT (DISPLAY)SH 22280 XM (7-bit characters)SH 10280 30145 MT (INPUT TRANSLATION)SH 22280 XM (Off)SH 10280 31250 MT (ESCAPE)SH 22280 XM (Control-Rightbracket)SH 8280 33041 MT (\050*\051 The VT102 terminal is compatible with the VT100, but includes a few additional functions.)SH 12 /Times-Bold AF 8280 35629 MT (The CONNECT Command)SH 10 /Times-Roman AF 8280 37043 MT (Syntax:)SH /Courier SF 11586 XM (CONNECT)SH /Times-Italic SF 16386 XM (-or-)SH /Courier SF 18541 XM (C)SH /Times-Roman SF 8280 39435 MT (The CONNECT command establishes an) 94 W( interactive terminal connection to the remote system using the currently)93 W 8280 40631 MT (selected communications) 183 W( port \050SET PORT COM1 or COM2\051 with all settings currently in effect for that port,)184 W 8280 41827 MT (emulating the currently selected type of terminal.)SH 8280 44219 MT (During CONNECT, the characters you type are sent out the communication port, and the characters that arrive) 5 W( at the)4 W 8280 45415 MT (port are displayed on the screen or interpreted by the selected terminal) 60 W( emulator. If you SET LOCAL-ECHO ON,)61 W 8280 46611 MT (MS-Kermit itself will display the characters you type on the screen.)SH 8280 49003 MT (Before you issue the CONNECT command, be sure to) 48 W( set the correct communication speed \050SET SPEED\051 and any)47 W 8280 50199 MT (other necessary communication parameters \050e.g. SET PARITY, SET LOCAL-ECHO\051.) 93 W( If) 438 W( you have SET DEBUG)94 W 8280 51395 MT (ON, then) 140 W( \050on certain systems, particularly the IBM PC\051, received control characters will be displayed in special)139 W 8280 52591 MT (notation and no particular terminal will be emulated.)SH 8280 54983 MT (By default, 7-bit ASCII characters are displayed on the screen. If you SET DISPLAY 8,) 57 W( then 8-bit characters will)58 W 8280 56179 MT (be used \050useful for "national" character sets\051.) 363 W( Character) 975 W( translation will be done according to any SET)362 W 8280 57375 MT (TRANSLATION INPUT and SET KEY commands you have issued. In addition, characters) 124 W( that are sent to the)125 W 8280 58571 MT (screen will also be recorded in a disk file or on a printer if you have issued a LOG SESSION command.)SH 8280 60963 MT (The CONNECT command turns your PC into a terminal to the other computer. To get) 106 W( back to the PC, type the)105 W 8280 62159 MT (escape character followed by the letter C \050for "Close connection"\051. On most MS-DOS systems the) 29 W( escape character)30 W 8280 63355 MT (is Ctrl-)SH /Courier SF (])SH /Times-Roman SF 11936 XM (\050Control-Rightbracket\051. That) 250 W( means, hold down the Ctrl key, press ``)SH /Courier SF (])SH /Times-Roman SF ('', and then type the letter C.)SH /Courier SF 10680 65070 MT (Kermit-MS>connect)SH /Times-Italic SF 28680 XM (Connect to remote system.)SH 4200 50 16680 65270 UL 11880 66787 MT (Conduct terminal session here)SH /Times-Roman SF 24324 XM (. . .)SH /Courier SF 10680 68502 MT (^]c)SH /Times-Italic SF 28680 XM (Escape back to PC.)SH 1800 50 10680 68702 UL /Courier SF 10680 69533 MT (Kermit-MS>)SH /Times-Italic SF 28680 XM (Prompt reappears.)SH /Times-Roman SF 8280 71250 MT (This is called "escaping back".) 221 W( You) 691 W( can use the SET ESCAPE command to change the escape character to)220 W ES %%Page: 62 63 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 62)SH 12 /Times-Bold AF 28885 XM (Kermit User Guide: MS-DOS KERMIT \0505.6.3\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (something besides ``)94 W /Courier SF (^])SH /Times-Roman SF ('', or you can assign the escaping-back) 94 W( operation to a single key or key combination with)95 W 6120 9082 MT (SET KEY \050on the IBM PC the default for this is Alt-X\051.)SH 6120 11474 MT (You can include the CONNECT command in a TAKE command file, but not "bare" text to be sent to the remote)87 W 6120 12670 MT (system during CONNECT) 223 W( \050use scripts for that, see Section 5.8\051. When a TAKE file includes a CONNECT)224 W 6120 13866 MT (command, no) 48 W( further commands will be executed from the file until after you escape back. A curious side effect of)47 W 6120 15062 MT (allowing Kermit to accept input redirected from a file or device is that Connect) 35 W( mode will read characters from that)36 W 6120 16258 MT (file or device; not really that useful but it works if you happen to need it.)SH 6120 18650 MT (When you CONNECT, the program attempts to raise the DTR and) 18 W( RTS RS-232 signals \050see Table 5-3\051, and it takes)17 W 6120 19846 MT (no specific action to lower them unless you explicitly issue the HANGUP) 163 W( command; thus you can EXIT from)164 W 6120 21042 MT (Kermit-MS and restart it without dropping a dialup connection. While CONNECTed, you can communicate directly)SH 6120 22238 MT (with an) 73 W( autodialer or "smart modem" to control the communications line, hang it up, and the like, for instance, by)74 W 6120 23434 MT (typing AT commands to a Hayes-like modem.)SH /Courier SF 8520 25149 MT (Kermit-MS>set speed 2400)SH /Times-Italic SF 26520 XM (\050See Section 5.6.10\051)SH 8400 50 14520 25349 UL /Courier SF 8520 26180 MT (Kermit-MS>connect)SH 4200 50 14520 26380 UL 8520 27211 MT (AT)SH /Times-Italic SF 26520 XM (Now you're talking to the modem.)SH 1200 50 8520 27411 UL /Courier SF 8520 28242 MT (OK)SH /Times-Italic SF 26520 XM (Your modem responds)SH /Courier SF 8520 29273 MT (ATDT8765432)SH /Times-Italic SF 26520 XM (Type the modem's dialing command.)SH 6600 50 8520 29473 UL /Courier SF 8520 30304 MT (RINGING)SH 8520 31335 MT (CONNECT 2400)SH 8520 32366 MT (Welcome to ...)SH /Times-Italic SF 26520 XM (Now you're talking to the host computer.)SH /Courier SF 8520 33397 MT (Please login:)SH /Times-Roman SF 6120 35114 MT (MS-Kermit makes no attempt to monitor the modem's Carrier Detect \050CD\051 or Data Set Ready \050DSR\051 signals \050see)85 W 6120 36310 MT (Table 5-3\051, and will take no notice if they drop. Thus it is) 74 W( not possible to automatically terminate a session if the)75 W 6120 37506 MT (connection is broken. However, you may query or test the status of these) 79 W( modem signals yourself using Kermit's)78 W 6120 38702 MT (SHOW MODEM, SHOW COMMUNICATIONS, and WAIT commands.)SH 46800 50 6120 40693 UL 7120 43608 MT (Signal)SH 11440 XM (DB25)SH 15040 XM (DB9)SH 18640 XM (Description)SH 2556 50 7120 43808 UL 2389 50 11440 43808 UL 1889 50 15040 43808 UL 4666 50 18640 43808 UL 7370 44713 MT (FG)SH 12410 XM (1)SH 15760 XM (-)SH 18640 XM (Frame \050protective\051 ground)SH 7370 45818 MT (TD)SH 12410 XM (2)SH 15760 XM (3)SH 18640 XM (Transmitted data \050from PC to modem\051)SH 7370 46923 MT (RD)SH 12410 XM (3)SH 15760 XM (2)SH 18640 XM (Received data \050by PC from modem\051)SH 7370 48028 MT (RTS)SH 12410 XM (4)SH 15760 XM (7)SH 18640 XM (Request to Send \050by PC\051)SH 7370 49133 MT (CTS)SH 12410 XM (5)SH 15760 XM (8)SH 18640 XM (Clear to Send \050by modem\051)SH 7370 50238 MT (DSR)SH 12410 XM (6)SH 15760 XM (6)SH 18640 XM (Dataset Ready \050Modem is turned on\051)SH 7370 51343 MT (SG)SH 12410 XM (7)SH 15760 XM (5)SH 18640 XM (Signal Ground)SH 7370 52448 MT (CD)SH 12410 XM (8)SH 15760 XM (1)SH 18640 XM (Carrier Detect \050Modem is communicating with remote modem\051)SH 7370 53553 MT (DTR)SH 12160 XM (20)SH 15760 XM (4)SH 18640 XM (Data Terminal Ready \050PC is online\051)SH 7370 54658 MT (RI)SH 12160 XM (22)SH 15760 XM (9)SH 18640 XM (Ring Indicate \050Modem tells PC phone is ringing\051)SH /Times-Bold SF 21783 56449 MT (Table 5-3:)SH /Times-Roman SF 26644 XM (RS-232-C Modem Signals)SH 46800 50 6120 58259 UL 6120 60451 MT (When using Kermit to connect two PCs "back) 62 W( to back," SET LOCAL-ECHO ON so that when you CONNECT to)63 W 6120 61647 MT (the other PC to send messages to its operator, you can see what you are typing. You should also SET TERMINAL)37 W 6120 62843 MT (NEWLINE ON, so that that a linefeed will be automatically supplied for each carriage return you type.)SH ES %%Page: 63 64 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.6.3. COMMANDS FOR TERMINAL CONNECTION)SH 10 /Times-Italic AF 51775 XM (Page 63)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (The HANGUP Command)SH 10 /Times-Roman AF 8280 9418 MT (On serial port) 112 W( connections, the HANGUP command attempts to momentarily lower the modem signals DTR and)113 W 8280 10614 MT (RTS \050Table 5-3\051. It may be used to hang up the) 48 W( phone when dialed up through a modem, or to get the attention of)47 W 8280 11810 MT (port contention units or terminal concentrators that operate in this manner.) 65 W( On) 381 W( direct connections, it will probably)66 W 8280 13006 MT (have no effect. On local) 38 W( area network connections, the network session is fully terminated. HANGUP affects only)37 W 8280 14202 MT (the currently selected port.)SH 12 /Times-Bold AF 8280 16790 MT (TERMINAL EMULATION)SH 10 /Times-Roman AF 8280 18204 MT (The IBM PC version of) 101 W( Kermit-MS emulates the DEC VT102 terminal by default, and may also be instructed to)102 W 8280 19400 MT (emulate the) 34 W( DEC VT52, the Heath/Zenith-19, the Tektronix 4010 graphics terminal, or no terminal at all, selectable)33 W 8280 20596 MT (with the SET TERMINAL command \050or you may "toggle" among) 30 W( the different emulations by typing the Alt-Minus)31 W 8280 21792 MT (key\051. Emulation) 326 W( of each of these terminals is nearly complete. VT102 emulation lacks only smooth scroll and 132)38 W 8280 22988 MT (column mode \050132 column mode is supported for a) 127 W( number of popular EGA and VGA boards\051. Double-height,)128 W 8280 24184 MT (double-width characters are supported, but simulated using ordinary characters.)SH 8280 26576 MT (The IBM PC's 40-column \050large character\051 screen mode may be) 30 W( used during CONNECT \050but you may also have to)29 W 8280 27772 MT (inform the remote host that your screen width is) 92 W( 40\051. This can provide improved readability to visually impaired)93 W 8280 28968 MT (persons. To use 40-column mode, enter the DOS command "MODE) 14 W( 40" \050or CO40 or BW40\051. Other screen sizes are)13 W 8280 30164 MT (also sensed and used automatically.)SH 8280 32556 MT (On color monitors, the foreground and background colors may be set using SET TERMINAL) 248 W( COLOR, and)249 W 8280 33752 MT (inverse/normal video display may also be selected, along with many other terminal parameters. A complete) 59 W( list of)58 W 8280 34948 MT (the commands, default key configurations,) 18 W( and escape sequences accepted by the IBM PC Kermit terminal emulator)19 W 8280 36144 MT (is given in section 5.16.1. Non-IBM-compatible PCs have different terminal emulation options. See section 5.10.)SH 12 /Times-Bold AF 8280 38732 MT (Escape-Level Commands)SH 10 /Times-Roman AF 8280 40146 MT (The escape character, normally Control-)20 W /Courier SF (])SH /Times-Roman SF (, is used to regain the attention of Kermit-MS during CONNECT \050you) 20 W( can)19 W 8280 41342 MT (change the) 4 W( escape character using SET ESCAPE\051. When you type the escape character, Kermit-MS waits for you to)5 W 8280 42538 MT (follow it with a) 139 W( single character command. For instance, the single character command ``)138 W /Courier SF (?)SH /Times-Roman SF ('' produces a list of)138 W 8280 43734 MT (available single character commands. This command is executed immediately; it may not be edited, and) 217 W( the)218 W 8280 44930 MT (program does not wait for a carriage return to confirm it.) 133 W( Table) 514 W( 5-4 shows CONNECT escape-level commands)132 W 8280 46126 MT (available in Kermit-MS. Typing any other character \050except the space bar, which) 58 W( is the "null command"\051 after the)59 W 46800 50 8280 48117 UL /Courier SF 10280 51032 MT (?)SH /Times-Roman SF 12280 XM (Help -- Lists the available single-character commands.)SH /Courier SF 10280 52137 MT (0)SH /Times-Roman SF 12280 XM (\050the digit zero\051 Transmit a NUL \050ASCII 0\051.)SH /Courier SF 10280 53242 MT (B)SH /Times-Roman SF 12280 XM (Transmit a BREAK signal.)SH /Courier SF 10280 54347 MT (L)SH /Times-Roman SF 12280 XM (Transmit a Long BREAK signal \050on some systems\051.)SH /Courier SF 10280 55452 MT (C)SH /Times-Roman SF 12280 XM (Close the connection and return to Kermit-MS prompt level.)SH /Courier SF 10280 56557 MT (H)SH /Times-Roman SF 12280 XM (Hangup the phone by lowering DTR and CTS momentarily.)SH /Courier SF 10280 57662 MT (F)SH /Times-Roman SF 12280 XM (File the current screen in the screen dump file.)SH /Courier SF 10280 58767 MT (M)SH /Times-Roman SF 12280 XM (Toggle the mode line, i.e. turn it off if it is on or vice versa.)SH /Courier SF 10280 59872 MT (P)SH /Times-Roman SF 12280 XM (Push to DOS; get back to CONNECT by typing EXIT.)SH /Courier SF 10280 60977 MT (Q)SH /Times-Roman SF 12280 XM (Temporarily quit logging the remote session.)SH /Courier SF 10280 62082 MT (R)SH /Times-Roman SF 12280 XM (Resume logging the remote session.)SH /Courier SF 10280 63187 MT (S)SH /Times-Roman SF 12280 XM (Show the status of the connection.)SH /Courier SF 10280 64292 MT (^])SH /Times-Roman SF 12280 XM (\050or whatever you have set the escape character to be\051)SH 12280 65397 MT (Typing the escape character twice sends one copy of it to the connected host.)SH /Times-Bold SF 17001 67188 MT (Table 5-4:)SH /Times-Roman SF 21862 XM (Kermit-MS Single-Character CONNECT Escape Commands)SH 46800 50 8280 68998 UL 8280 70589 MT (escape character will cause Kermit-MS to beep, but will) 5 W( do no harm. These actions are also Kermit action verbs and)4 W 8280 71785 MT (can be assigned to single keys. See SET KEY for details.)SH ES %%Page: 64 65 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 64)SH 12 /Times-Bold AF 28885 XM (Kermit User Guide: MS-DOS KERMIT \0505.6.3\051)SH 46800 50 6120 5709 UL 6120 8004 MT (The Mode Line)SH 10 /Times-Roman AF 6120 9418 MT (When you first issue the CONNECT command, a message \050on some systems, an) 102 W( inverse video "mode line"\051 will)103 W 6120 10614 MT (display the most important facts about the connection you've just established, so that you) 41 W( can quickly diagnose any)40 W 6120 11810 MT (problems. Here's) 250 W( what the IBM PC mode line looks like:)SH /Courier SF 7320 13465 MT (Esc-chr:^] help:^]? port:1 speed:9600 parity:odd echo:rem VT102 .... PRN)SH /Times-Roman SF 6120 15182 MT (This shows that the escape character is Ctrl-Rightbracket, that you would type Ctrl-rightbracket followed) 250 W( by)251 W 6120 16378 MT (question mark \050``)115 W /Courier SF (^]?)SH /Times-Roman SF (''\051 to get help during CONNECT,) 115 W( that you are connected on port 1 at 9600 baud with odd)114 W 6120 17574 MT (parity and remote echo,) 87 W( and that a VT102 terminal is being emulated. The four dots represent the VT102s LEDs)88 W 6120 18770 MT (\050they turn into the digits 1,2,3,4 when "lit"\051 and PRN will show up if the printer is) 362 W( activated \050e.g. by)361 W 6120 19966 MT (Ctrl-PrintScreen\051.)SH 6120 22358 MT (The mode line may be turned on and off using SET MODE, or the CONNECT escape character followed by) 101 W( the)102 W 6120 23554 MT (letter M.)SH 12 /Times-Bold AF 6120 26142 MT (Screen Rollback)SH 10 /Times-Roman AF 6120 27556 MT (On the IBM PC and some other systems \050see Table 5-7\051, Kermit-MS provides several pages) 149 W( of screen memory)148 W 6120 28752 MT (which let you recall earlier terminal screens. These may be scrolled up and down using keys as shown in Table) 16 W( 5-8.)17 W 6120 29948 MT (For instance, the IBM PC uses PgUp \050previous screen\051, PgDn \050next screen\051, Ctrl-PgUp and) 25 W( Ctrl-PgDn \050one line at a)24 W 6120 31144 MT (time\051. Only) 266 W( lines that scroll off the) 8 W( top of the screen are saved. When an application clears the screen, that screen is)9 W 6120 32340 MT (not saved. These functions and others may be assigned to different keys with the SET KEY command.)SH 6120 34732 MT (If you have rolled the screen back and a new character must be displayed, it will) 120 W( normally appear at the current)119 W 6120 35928 MT (cursor position on the old screen.) 41 W( This) 333 W( is useful when you are trying to copy something from a previous screen. If)42 W 6120 37124 MT (you wish new characters to appear in) 76 W( their proper place on the "newest" screen, you can SET TERMINAL ROLL)75 W 6120 38320 MT (ON.)SH 6120 40712 MT (The number of lines in the roll back buffer depends on the machine,) 208 W( 10 full screens for IBM PCs and DEC)209 W 6120 41908 MT (Rainbows, and on the amount of memory available in the machine. Each screen) 93 W( needs 4KB on IBM PCs. Denser)92 W 6120 43104 MT (displays receive fewer roll back lines.)SH 12 /Times-Bold AF 6120 45692 MT (Screen Dump)SH 10 /Times-Roman AF 6120 47106 MT (The screen dump feature writes the contents of the current screen to a file \050)79 W /Courier SF (KERMIT.SCN)SH /Times-Roman SF 43546 XM (unless another file was)79 W 6120 48302 MT (selected by the SET DUMP command\051 when the CONNECT escape-level command F is typed.) 64 W( The) 377 W( screen dump)63 W 6120 49498 MT (file is appended to on each successive screen dump, with each screen separated by a formfeed \050Ctrl-L\051. This) 15 W( feature)16 W 6120 50694 MT (may be used in conjunction with screen rollback -- a handy way to recapture screenfuls of laboriously) 42 W( typed-in text)41 W 6120 51890 MT (after a remote host has crashed without saving your work. The corresponding action verb is) 33 W( "dump". Screen dump)34 W 6120 53086 MT (does not function when in Tektronix graphics mode;) 40 W( instead one of many graphics screen capture programs may be)39 W 6120 54282 MT (used independently commonly via the DOS Shift PrtSc key combination or by LOGging the incoming byte stream.)SH 6120 56674 MT (A screen dump differs from a session log in two ways. First, each desired screen must be manually) 150 W( filed, and)151 W 6120 57870 MT (second, the screen dump file has been stripped) 55 W( of any escape sequences, whereas the session log records them \050see)54 W 6120 59066 MT (LOG SESSION\051.)SH 12 /Times-Bold AF 6120 61654 MT (Printer Control)SH 10 /Times-Roman AF 6120 63068 MT (During terminal emulation, a locally attached printer may be controlled) 128 W( in the normal manner, on most systems.)129 W 6120 64264 MT (Pushing the) 37 W( "Print Screen" key \050shifted on some systems\051 will cause the current contents of the screen to be printed)36 W 6120 65460 MT (by DOS; holding down Ctrl while depressing Print Screen will) 81 W( alternately start and stop the spooling of incoming)82 W 6120 66656 MT (characters to the printer. On the IBM PC, the mode line will) 8 W( show PRN when the printer is activated in this manner.)7 W /Courier SF 6120 67852 MT (^P)SH /Times-Roman SF 7635 XM (or)SH /Courier SF 8783 XM (^N)SH /Times-Roman SF 10298 XM (are sent to the host during terminal emulation) 65 W( and do not toggle printing as they do when you're talking)66 W 6120 69048 MT (directly to DOS. CTRL-Print-Screen can be simulated with the Kermit-MS LOG PRN and) 137 W( CLOSE commands.)136 W 6120 70244 MT (VT102 \050ANSI\051 style host-controlled transparent printing is also supported on the IBM PC.) 83 W( See) 417 W( section 5.17.6 for)84 W 6120 71440 MT (technical information about MS-Kermit's printer control.)SH ES %%Page: 65 66 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.6.3. COMMANDS FOR TERMINAL CONNECTION)SH 10 /Times-Italic AF 51775 XM (Page 65)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (Graphics)SH 10 /Times-Roman AF 8280 9418 MT (MS-Kermit on the IBM PC, compatibles, and several other systems, is capable of emulating a Tektronix 4010)177 W 8280 10614 MT (graphics terminal, for) 147 W( use with host-based software that can generate Tektronix control codes. When you enter)148 W 8280 11810 MT (Tektronix emulation, your cursor will disappear. Don't be alarmed, this is how Tektronix terminals behave.)SH 8280 14202 MT (The Tektronix) 52 W( emulator implements a mixture of Tek 4010 and 4014 features to draw characters, lines, and dots in)51 W 8280 15398 MT (graphics mode. These Tektronix) 122 W( terminals have a graphics display 780 dots high by 1024 dots wide. They use)123 W 8280 16594 MT (storage tube technology whereby a dot stays illuminated until the full screen is erased. They also lack) 47 W( cursor keys.)46 W 8280 17790 MT (Kermit's Tek emulator maps the 1024 by 780 dot display to the PC's current screen dimensions,) 48 W( say 640 across by)49 W 8280 18986 MT (200 or 350 dots high, and retains) 66 W( limited use of the cursor keys. It automatically senses the active display adapter)65 W 8280 20182 MT (\050EGA, CGA, Hercules, Mono, and AT&T/Olivetti style 640x400\051 and retains screen) 11 W( coloring \050EGA\051 and the current)12 W 8280 21378 MT (graphics image \050EGA and Hercules\051 if the adapter has) 157 W( sufficient memory. Automatic sensing can be manually)156 W 8280 22574 MT (overriden to select a particular display mode, such as VGA) 62 W( \050640x480\051, by SET TERMINAL GRAPHICS . Pure monochrome systems, of course, lack a) 213 W( graphics capability; in this case Kermit approximates the)212 W 8280 24966 MT (graphic image by writing dots as plus signs.)SH 8280 27358 MT (Tektronix graphics mode is entered two different ways, automatically and voluntarily:)SH 10280 29149 MT (1.)SH 11280 XM (Automatically \050which you can prevent) 39 W( via the Kermit command DISABLE TEK\051. While emulating a)40 W 11280 30254 MT (VT102, VT52, or Heath-19,) 39 W( reception of the byte pair ESCAPE Control-L causes the PC to change to)38 W 11280 31359 MT (graphics mode, clear the screen, and obey new) 120 W( input as Tektronix commands. A second automatic)121 W 11280 32464 MT (entry is reception of the escape sequence ``)24 W /Courier SF (ESC [ ? 3 8 h)24 W /Times-Roman SF ('' which does the same as above) 24 W( except)23 W 11280 33569 MT (the screen is not cleared. Automatic mode is exited by either reception of) 424 W( Control-X or)425 W 11280 34674 MT (``)SH /Courier SF (ESC [ ? 3 8 l)259 W /Times-Roman SF ('' \050lower case L\051,) 259 W( or by toggling the terminal type \050ALT minus, Kermit)258 W 11280 35779 MT (verb)SH /Courier SF (\134KTermtype)SH /Times-Roman SF (\051 to VT102, or something other than TEK. \050These ``)187 W /Courier SF (ESC [ ? 3 8 h/l)187 W /Times-Roman SF ('')SH 11280 36884 MT (sequences derive from the DEC VT340 terminal.\051)SH 10280 39094 MT (2.)SH 11280 XM (Voluntary mode is when terminal type TEK4010 is selected by the Kermit) 406 W( command SET)405 W 11280 40199 MT (TERMINAL TEK4010) 245 W( or by toggling to it using Alt-Minus. It is exited by SET TERMINAL)246 W 11280 41304 MT (another-kind or by toggling to another kind. ENABLE or DISABLE) 155 W( TEK and the exit-Tek-mode)154 W 11280 42409 MT (escape sequences are not applicable to voluntary mode.)SH 8280 44801 MT (Here are several common questions about Tek mode, and their answers:)SH 10280 46592 MT (1.)SH /Times-Italic SF 11280 XM ("How do I escape from graphics mode back) 44 W( to being a regular terminal?")45 W /Times-Roman SF 42018 XM (Within CONNECT mode,)45 W 11280 47697 MT (you can type the)23 W /Courier SF 18204 XM (\134KTermtype)SH /Times-Roman SF 24477 XM (key, which is assigned) 23 W( by default to Alt-Minus. Repeated pressing of)22 W 11280 48802 MT (this key "toggles" among Kermit's) 60 W( terminal types, VT102, VT52, Heath-19, and Tektronix. You can)61 W 11280 49907 MT (also escape back to) 94 W( Kermit-MS command level and issue an explicit SET TERMINAL command to)93 W 11280 51012 MT (change the terminal type.)SH 10280 53222 MT (2.)SH /Times-Italic SF 11280 XM ("How can I return to the graphics screen without erasing it?")7 W /Times-Roman SF 36537 XM (The graphics screen is preserved if your)8 W 11280 54327 MT (graphics adapter has sufficient) 159 W( memory \050see Table 5-5\051. In this case, both your text and graphics)158 W 11280 55432 MT (screens will be preserved) 70 W( when you toggle back and forth between a character terminal \050e.g. VT102\051)71 W 11280 56537 MT (and Tektronix.)SH 10280 58747 MT (3.)SH /Times-Italic SF 11280 XM ("How do I erase the graphics screen?")52 W /Times-Roman SF 27756 XM (You can) 52 W( type the)51 W /Courier SF 35015 XM (\134KReset)SH /Times-Roman SF 39516 XM (key, which is normally assigned)51 W 11280 59852 MT (to Alt-=. The screen also clears if the host sends a Control-L or ESC Control-L.)SH 10280 62062 MT (4.)SH /Times-Italic SF 11280 XM ("How do I print or save the graphics screen?")16 W /Times-Roman SF 30445 XM (Kermit does not currently provide a) 16 W( way to do this, but)17 W 11280 63167 MT (you can load drivers like)SH /Courier SF 21417 XM (GRAPHICS.COM)SH /Times-Roman SF 28867 XM (alongside Kermit for this purpose.)SH 8280 65559 MT (While acting as a Tek terminal Kermit uses the) 53 W( keyboard translation appropriate to the VT102 terminal. However,)52 W 8280 66755 MT (received escape sequences are interpreted by the Tek emulator and VT102 escape codes are inoperative.) 74 W( The) 399 W( Tek)75 W 8280 67951 MT (emulator absorbs the ESCAPE and following character and treats any additional unknown items as ordinary text.)SH 8280 70343 MT (The emulator can display text characters from a built-in 8-by-8 dot font for characters Space) 92 W( through DELete \050no)91 W 8280 71539 MT (control codes nor special characters\051. Tabs are converted to single spaces. Only the low 7 bits of the) 60 W( character are)61 W ES %%Page: 66 67 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 66)SH 12 /Times-Bold AF 28885 XM (Kermit User Guide: MS-DOS KERMIT \0505.6.3\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (used.)SH 6120 10278 MT (While in Tek mode the emulator behaves as a simple TTY device for ordinary text and as a line or) 114 W( dot drawing)113 W 6120 11474 MT (Tektronix device for commands listed in Table 5-10. The screen) 4 W( resolution is governed by the kind of active display)5 W 6120 12670 MT (adapter and monitor) 197 W( in the PC \050Table 5-5\051. Kermit senses this automatically when graphics mode is entered.)196 W 6120 13866 MT (Graphics are saved on page 1 of screen memory. Coloring is determined by the current) 76 W( terminal status, either the)77 W 6120 15062 MT (default screen or that overridden by the command SET TERMINAL COLOR.)SH 46800 50 6120 17053 UL 6120 19787 MT (Display Adapter)SH 16920 XM (Display)SH 27720 XM (Mode)SH 33120 XM (Screen Resolution and Coloring)SH 6582 50 6120 19987 UL 3111 50 16920 19987 UL 2333 50 27720 19987 UL 12805 50 33120 19987 UL 6120 20892 MT (VGA)SH 16920 XM (Hi res color)SH 27720 XM (18)SH 33120 XM (640x480, graphics saved \050407 lines\051,)SH 33370 23102 MT (16 colors.)SH 6120 24207 MT (VGA)SH 16920 XM (Monochrome)SH 27720 XM (17)SH 33120 XM (640x480, graphics saved \050407 lines\051)SH 6120 25312 MT (EGA w/256KB)SH 16920 XM (Hi res color)SH 27720 XM (16 dec)SH 33120 XM (640x350, graphics saved, 16 colors.)SH 16920 26417 MT (Med res color)SH 27720 XM (14)SH 33120 XM (640x200, graphics saved, 8 colors.)SH 16920 27522 MT (Monochrome)SH 27720 XM (15)SH 33120 XM (640x350, graphics saved, b/w.)SH 6120 28627 MT (EGA w/64KB)SH 16920 XM (Hi res color)SH 27720 XM (16)SH 33120 XM (640x350, graphics not saved,)SH 33370 29732 MT (4 colors of red, white, blue, black.)SH 16920 30837 MT (Med res color)SH 27720 XM (14)SH 33120 XM (640x200, graphics saved, 8 colors.)SH 16920 31942 MT (Monochrome)SH 27720 XM (15)SH 33120 XM (640x350, graphics not saved.)SH 6120 33047 MT (CGA)SH 16920 XM (Color)SH 27720 XM (6)SH 33120 XM (640x200, graphics not saved, b/w.)SH 6120 34152 MT (Hercules)SH 16920 XM (Monochrome)SH 27720 XM (none)SH 33120 XM (720x348, graphics saved if memory.)SH 6120 35257 MT (Monochrome)SH 16920 XM (Monochrome)SH 27720 XM (7)SH 33120 XM (80 by 25 text, graphics not saved.)SH 6120 36362 MT (AT&T/Olivetti)SH 16920 XM (any)SH 27720 XM (72)SH 33120 XM (640x400, grahics not saved, b/w.)SH 6120 37467 MT (DEC VAXMATE)SH 16920 XM (any)SH 27720 XM (208)SH 33120 XM (640x400, graphics not saved, b/w.)SH 6120 38572 MT (TOSHIBA T3100)SH 16920 XM (any)SH 27720 XM (116)SH 33120 XM (640x400, graphics not saved, b/w.)SH /Times-Bold SF 13229 40182 MT (Table 5-5:)SH /Times-Roman SF 18090 XM (Adapters Supported by IBM PC MS-Kermit for Tektronix Emulation)SH 46800 50 6120 41992 UL 6120 44184 MT (The technical details of Tektronix emulation are presented in section 5.16.7.)SH ES %%Page: 67 68 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.6.3. COMMANDS FOR TERMINAL CONNECTION)SH 10 /Times-Italic AF 51775 XM (Page 67)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (5.6.4. COMMANDS FOR FILE TRANSFER)SH 10 /Times-Roman AF 8280 9946 MT (MS-Kermit's SEND, GET,) 11 W( and RECEIVE invoke the Kermit file transfer protocol for error-checked transmission of)10 W 8280 11142 MT (files between MS-Kermit and another Kermit program on the other end of the) 3 W( connection. There are also commands)4 W 8280 12338 MT (for "raw" transfer of files \050no error checking\051) 77 W( with systems that don't have Kermit programs: LOG SESSION \050for)76 W 8280 13534 MT (capturing text files on your PC\051 and TRANSMIT \050for uploading text files to the remote system\051. The LOG)216 W 8280 14730 MT (TRANSACTION command opens a file to record the status, time, date, names, sizes of each file transfer.)SH 8280 17122 MT (During file transfer, MS-Kermit normally displays its progress on the screen) 56 W( as shown in Figure 5-1. The items in)55 W 8280 18318 MT (the right-hand column are updated more or less at random. The percent done is) 29 W( always filled in when sending files,)30 W 8280 19514 MT (and when receiving if) 61 W( the other Kermit sends the file's size in a special file-attribute packet. Several other display)60 W 8280 20710 MT (options are also available; see SET DISPLAY.)SH 46800 50 8280 22701 UL /Courier SF 17280 25480 MT (Kermit-MS: V2.31 17 July 1988)SH 17280 27542 MT (File name: FOT.)SH 11880 28573 MT (KBytes transferred: 7)SH 11280 29604 MT (Percent transferred: 52%)SH 18480 30635 MT (Sending: In progress)SH 12480 32697 MT (Number of packets: 74)SH 14880 33728 MT (Packet length: 93)SH 12480 34759 MT (Number of retries: 2)SH 16680 35790 MT (Last error: None)SH 15480 36821 MT (Last warning: None)SH /Times-Bold SF 20862 38538 MT (Figure 5-1:)SH /Times-Roman SF 26111 XM (MS-Kermit File Transfer Display Screen)SH 46800 50 8280 40348 UL 8280 42540 MT (Although MS-Kermit makes no distinction between text and binary files, most) 319 W( other Kermit programs do.)320 W 8280 43736 MT (Therefore, before) 245 W( you attempt to transfer binary files with another type of system \050say, a VAX, or an IBM)244 W 8280 44932 MT (mainframe\051, be sure to give the) 24 W( appropriate command -- usually something like SET FILE TYPE BINARY -- to the)25 W 8280 46128 MT (Kermit on) 126 W( the remote end. Kermit-MS itself neither has nor needs the command SET FILE TYPE, because the)125 W 8280 47324 MT (MS-DOS format for text) 14 W( files is exactly the same as Kermit's text-file transfer format, which means that MS-Kermit)15 W 8280 48520 MT (never needs to convert file data, no matter whether it be text or binary.)SH 8280 50912 MT (File transfers involving floppy disks will be slow and noisy. Hard disks) 91 W( are much faster \050and quieter\051, and RAM)90 W 8280 52108 MT (disks faster still \050and totally silent\051. But if you store new) 46 W( files on a RAM disk, be sure to move them to a real disk)47 W 8280 53304 MT (before turning off your PC.)SH 8280 55696 MT (Before attempting to transfer files to the PC, make sure you) 27 W( have enough room on the selected device. Kermit does)26 W 8280 56892 MT (not provide a way for) 46 W( you to change disks during a file transfer. However, the Kermit protocol will help you out a)47 W 8280 58088 MT (little bit by attempting to prevent transfer of files that are too big to) 41 W( fit in the available space. As of version)40 W /Courier SF 52430 XM (2.31)SH /Times-Roman SF (,)SH 8280 59284 MT (MS-Kermit supports "file attributes" exchange, and if the other Kermit supports this option too,) 72 W( then the receiving)73 W 8280 60480 MT (program will check free disk space before letting the) 112 W( transfer proceed. MS-Kermit allows a margin of 6 percent)111 W 8280 61676 MT (inflation upon reception, because file construction differs) 85 W( markedly between systems. A multiple-file transfer can)86 W 8280 62872 MT (even skip automatically past files that are too big, allowing the little ones to pass though.)SH 8280 65264 MT (Other attributes exchanged by MS-Kermit include the file's creation) 30 W( date and time, and the system of origin. When)29 W 8280 66460 MT (two Kermit programs) 200 W( both have attribute capability, then files will be stored with the same timestamp on the)201 W 8280 67656 MT (receiving system as they had on the sending system.)SH 8280 70048 MT (Since exchange of attributes is a new feature to MS-Kermit, and a relatively) 24 W( scarce one elsewhere, it is possible that)23 W 8280 71244 MT (two Kermit programs) 43 W( might misunderstand each other because of differing interpretations by the programmers, and)44 W ES %%Page: 68 69 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 68)SH 12 /Times-Bold AF 28885 XM (Kermit User Guide: MS-DOS KERMIT \0505.6.4\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (this could) 32 W( prevent otherwise normal file transfers from taking place. An escape clause is provided by the command)31 W 6120 9082 MT (SET ATTRIBUTES OFF, which makes MS-Kermit forget that it has attribute capability.)SH 6120 11474 MT (You may record the progress of a file transfer in a log file by issuing the command LOG TRANSACTIONS.)SH 12 /Times-Bold AF 6120 14062 MT (The SEND Command)SH 10 /Times-Roman AF 6120 15476 MT (Syntax:)SH /Courier SF 9676 XM (SEND)SH /Times-Italic SF 12326 XM (filespec1)SH /Times-Roman SF 16131 XM ([)SH /Times-Italic SF (filespec2)SH /Times-Roman SF (])SH 6120 17868 MT (The SEND command causes a file or file group to be sent from the local MS-DOS system to the Kermit on) 119 W( the)120 W 6120 19064 MT (remote system. The remote Kermit may be running in server or interactive mode; in the latter case,) 123 W( you should)122 W 6120 20260 MT (already have given) 65 W( it a RECEIVE command and escaped back to your PC. S is a special non-unique abbreviation)66 W 6120 21456 MT (for SEND.)SH /Times-Italic SF 6120 23848 MT (filespec1)SH /Times-Roman SF 10032 XM (may contain the wildcard characters ``)107 W /Courier SF (*)SH /Times-Roman SF ('' to match zero or) 107 W( more characters within a field, and/or ``)106 W /Courier SF (#)SH /Times-Roman SF ('')SH 6120 25044 MT (\050first position\051 or ``)41 W /Courier SF (?)SH /Times-Roman SF ('' \050elsewhere\051 to match) 41 W( any single character \050a question mark in first position gives you a help)42 W 6120 26240 MT (message\051. If)588 W /Times-Italic SF 12014 XM (filespec1)SH /Times-Roman SF 15988 XM (contains wildcard characters then) 169 W( all matching files will be sent, in the same order that)168 W 6120 27436 MT (MS-DOS would show them in a directory listing. If)55 W /Times-Italic SF 27808 XM (filespec1)SH /Times-Roman SF 31669 XM (specifies a single file, you may direct Kermit-MS to)56 W 6120 28632 MT (send that file with a different name, given in)SH /Times-Italic SF 24117 XM (filespec2)SH /Times-Roman SF (, as in:)SH /Courier SF 8520 30287 MT (Kermit-MS>send foo.bar framus.widget)SH 15600 50 14520 30487 UL /Times-Italic SF 6120 32004 MT (filespec2)SH /Times-Roman SF 10096 XM (begins with) 171 W( the first nonblank character after)170 W /Times-Italic SF 29477 XM (filespec1)SH /Times-Roman SF 33452 XM (and ends with the carriage return; thus it may)170 W 6120 33200 MT (contain blanks or other) 89 W( unusual characters that may be appropriate on the target machine. The alphabetic case of)90 W 6120 34396 MT (text in)170 W /Times-Italic SF 9238 XM (filespec2)SH /Times-Roman SF 13213 XM (is preserved in transmission, so if case matters on) 170 W( the target system, be sure to type)169 W /Times-Italic SF 49365 XM (filespec2)SH /Times-Roman SF 6120 35592 MT (appropriately.)SH 6120 37984 MT (If the SEND command is specified by itself on the command line, then you will be prompted separately for the) SH( name)1 W 6120 39180 MT (of the file to send, and the name to send it under:)SH /Courier SF 8520 40835 MT (Kermit-MS>send)SH 2400 50 14520 41035 UL 9120 41866 MT (Local Source File: c:\134chris\134xcom1.txt)SH 10800 50 20520 42066 UL 9120 42897 MT (Remote Destination File: com1.txt)SH 4800 50 24120 43097 UL /Times-Roman SF 6120 45289 MT (If a file can't be opened for read access, the message "Unable to find file" will be shown) 164 W( or else the standard)163 W 6120 46485 MT (MS-DOS recovery procedures will take place:)SH /Courier SF 8520 48140 MT (Not ready error reading drive A)SH 8520 49171 MT (Abort, Retry, Ignore?)SH /Times-Roman SF 6120 50888 MT (Kermit remains active even if you select "Abort" \050DOS's word, not ours\051.)SH 6120 53280 MT (Files will be sent with their MS-DOS filename and filetype \050for instance)201 W /Courier SF 37751 XM (FOO.TXT)SH /Times-Roman SF (, no device or) 201 W( pathname\051.)202 W 6120 54476 MT (Special characters in the file name are not converted. If there is no filetype, then only) 8 W( the name will be sent, without)7 W 6120 55672 MT (the terminating dot. Each file is sent as is, with no) 55 W( conversions done on the data, except for possibly stopping at a)56 W 6120 56868 MT (terminating Control-Z character \050see the SET EOF command\051.)SH 6120 59260 MT (Once you give Kermit-MS the SEND command, the name of each file will) 154 W( be displayed on your screen as the)153 W 6120 60456 MT (transfer begins.) 145 W( Packet,) 541 W( retry, and other counts will be displayed along with informational messages during the)146 W 6120 61652 MT (transfer, in the style specified by SET DISPLAY. If the file is successfully) 10 W( transferred, you will see ``)9 W /Courier SF (Complete)SH /Times-Roman SF ('',)SH 6120 62848 MT (otherwise there will be an error message. When the specified operation is done, the program will sound a beep.)SH 6120 65240 MT (Several single-character commands may be given while a file transfer is in progress:)SH /Courier SF 7120 67031 MT (^X)SH /Times-Roman SF 9120 XM (\050Control-X\051 Stop sending the current file and go on to the next one, if any.)SH /Courier SF 7120 68608 MT (^Z)SH /Times-Roman SF 9120 XM (Stop sending this file, and don't send any further files.)SH /Courier SF 7120 70185 MT (^C)SH /Times-Roman SF 9120 XM (Return to Kermit-MS command) 120 W( level immediately without sending any kind of notification to the remote)121 W 9120 71290 MT (system. \050)250 W /Courier SF (^Z)SH /Times-Roman SF 14431 XM (or even)SH /Courier SF 17652 XM (^E)SH /Times-Roman SF 19102 XM (is preferable.\051)SH ES %%Page: 69 70 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.6.4. COMMANDS FOR FILE TRANSFER)SH 10 /Times-Italic AF 51775 XM (Page 69)SH 46800 50 8280 5709 UL /Courier SF 9280 7886 MT (^E)SH /Times-Roman SF 11280 XM (Like)SH /Courier SF 13390 XM (^C)SH /Times-Roman SF (, but send an Error packet) 27 W( to the remote Kermit in an attempt to bring it back to server or interactive)26 W 11280 8991 MT (command level.)SH /Courier SF 9280 10568 MT (CR)SH /Times-Roman SF 11280 XM (Simulate a timeout: resend the current packet, or NAK the expected one.)SH 8280 12960 MT (Control-X, Control-Z, and Control-E) 53 W( send the proper protocol messages to the remote Kermit to bring it gracefully)54 W 8280 14156 MT (to the desired state. Control-C leaves the) 320 W( remote Kermit in whatever state it happens to be in, possibly)319 W 8280 15352 MT (retransmitting its last packet over and over, up to its retry limit. You should only have) 116 W( to use Control-C in dire)117 W 8280 16548 MT (emergencies \050the remote Kermit is stuck, the remote system crashed, etc\051, or at those) 90 W( times when you realize that)89 W 8280 17744 MT (you have given a file transfer command to Kermit-MS without first having told the remote Kermit about it.)SH 8280 20136 MT (MS-Kermit does not have a built-in mechanism for) 58 W( sending an entire directory structure, but this may still be done)59 W 8280 21332 MT (using command files. A program called) 4 W( XSEND, distributed along with MS-Kermit, will construct such a command)3 W 8280 22528 MT (file automatically.)SH 12 /Times-Bold AF 8280 25116 MT (The RECEIVE Command)SH 10 /Times-Roman AF 8280 26530 MT (Syntax:)SH /Courier SF 11586 XM (RECEIVE [)SH /Times-Italic SF (filespec)SH /Courier SF (])SH /Times-Roman SF 8280 28922 MT (The RECEIVE command tells Kermit-MS to receive a file) 80 W( or file group from the other system. The file is stored)81 W 8280 30118 MT (under the name it) 233 W( was transmitted with, except that any illegal characters are translated to X's. Kermit-MS)232 W 8280 31314 MT (passively waits for the) 56 W( file to arrive; this command is not to be used when talking to a Kermit server \050use GET for)57 W 8280 32510 MT (that\051. You) 474 W( should already) 112 W( have issued a SEND command to the remote Kermit and escaped back to Kermit-MS)111 W 8280 33706 MT (before issuing) 4 W( the RECEIVE command. The RECEIVE command is intended for situations where the file name and)5 W 8280 34902 MT (sending operation originates at the other side; GET) 172 W( originates the request from our side and asks the server to)171 W 8280 36098 MT (perform the operation. R is a special non-unique abbreviation for RECEIVE.)SH 8280 38490 MT (If the optional filespec is provided, incoming files will be stored under that) 16 W( name. If the filespec is really just a path)17 W 8280 39686 MT (then files are stored where the path indicates. If it is an actual filename the first incoming) 61 W( file is renamed and any)60 W 8280 40882 MT (additional files either overwrite the first \050if) 140 W( FILE WARNING is OFF\051 or are renamed slightly from the filespec)141 W 8280 42078 MT (\050digits are added to) 46 W( the end of the main filename part before the dot and extension\051 if FILE WARNING is ON \050the)45 W 8280 43274 MT (default\051. The filespec may include any combination of the following fields:)SH /Times-Italic SF 9280 45063 MT (Device designator)SH /Times-Roman SF 11280 46168 MT (Store the file on the designated device, in the current directory) 103 W( for that device. If no device designator is)102 W 11280 47273 MT (given, store it on the current default device.)SH /Times-Italic SF 9280 48850 MT (Directory path)SH /Times-Roman SF 11280 49955 MT (Store the file in the designated directory on the) 88 W( current disk. If no path given, store the file in the current)87 W 11280 51060 MT (directory.)SH /Times-Italic SF 9280 52637 MT (File name)SH /Times-Roman SF 11280 53742 MT (Store the file under the name given. If no name is given, store it under) 208 W( the name it was sent under,)207 W 11280 54847 MT (converted, if necessary, to suit DOS conventions, and modified, if SET WARNING) 345 W( ON, to avoid)346 W 11280 55952 MT (overwriting any file of the same name in the same directory.)SH 8280 58344 MT (If an incoming file does not arrive in its entirety, Kermit-MS will normally discard it and it will not) 49 W( appear in your)48 W 8280 59540 MT (directory. You) 392 W( may change this behavior by using the command SET INCOMPLETE KEEP, which will cause as)72 W 8280 60736 MT (much of the file as arrived to be saved on the disk.)SH 8280 63128 MT (The same single-character commands are available as during SEND:)SH /Courier SF 9280 64919 MT (^X)SH /Times-Roman SF 11280 XM (Request that the remote Kermit stop sending the current file, and proceed to) 5 W( the next one immediately. Since)4 W 11280 66024 MT (this is an optional feature of the Kermit protocol, the remote Kermit might not honor the request.)SH /Courier SF 9280 67601 MT (^Z)SH /Times-Roman SF 11280 XM (Request that the remote Kermit terminate the entire transfer;) 35 W( this is also an optional feature that may or may)36 W 11280 68706 MT (not be supported by the remote Kermit.)SH /Courier SF 9280 70283 MT (^C)SH /Times-Roman SF (,)SH /Courier SF 11016 XM (^E)SH /Times-Roman SF (, and)36 W /Courier SF 14482 XM (CR)SH /Times-Roman SF 15968 XM (operate in the same way as they do during SEND. In this case,)36 W /Courier SF 41912 XM (^E)SH /Times-Roman SF 43398 XM (should always do) 36 W( what)35 W /Courier SF 52928 XM (^Z)SH /Times-Roman SF 54413 XM (is)SH 11280 71388 MT (supposed to do.)SH ES %%Page: 70 71 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 70)SH 12 /Times-Bold AF 28885 XM (Kermit User Guide: MS-DOS KERMIT \0505.6.4\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (If WARNING is OFF and you type)4 W /Courier SF 20563 XM (^X)SH /Times-Roman SF 22017 XM (or)SH /Courier SF 23104 XM (^Z)SH /Times-Roman SF 24558 XM (to interrupt the transfer,) 4 W( you'll either get a partial new file, or else both)5 W 6120 9082 MT (the old and the new file of that name will be lost, depending on SET INCOMPLETE. In any case, when)250 W 6120 10278 MT (WARNING is off, old files with the same name as incoming files will not survive.)SH /Times-Italic SF 6120 12670 MT (Caution:)SH /Times-Roman SF 9929 XM (If an incoming file's name \050the part before the dot\051 corresponds to an MS-DOS device name, such) 3 W( as NUL,)4 W 6120 13866 MT (COM1, CON, AUX, or PRN,) 39 W( output will go to that device, rather than to a file with that name. This is a feature of)38 W 6120 15062 MT (MS-DOS.)SH 12 /Times-Bold AF 6120 18178 MT (5.6.5. Hints for Transferring Large Files)SH 10 /Times-Roman AF 6120 20120 MT (During a prolonged file transfer session, things can go wrong that are) 134 W( beyond Kermit's control. The longer the)135 W 6120 21316 MT (session, the greater the probability it will be fatally interrupted. But you can take a few precautions:)SH /Symbol SF 7910 23221 MT (\267)SH /Times-Roman SF 8620 XM (Make sure there is sufficient disk space at the receiving) 27 W( end. If possible, first run a disk utility \050such as)26 W 8620 24326 MT (CHKDSK\051 to clean out any bad disk blocks.)SH /Symbol SF 7910 26315 MT (\267)SH /Times-Roman SF 8620 XM (If you are using a telephone connection, make sure your session won't be interrupted) 85 W( by call waiting,)86 W 8620 27420 MT (people picking up other extensions, etc.)SH /Symbol SF 7910 29409 MT (\267)SH /Times-Roman SF 8620 XM (Don't attempt to transfer a single file of many megabytes) 48 W( over a telephone connection. The longer the)47 W 8620 30514 MT (call, the greater the chance of disconnection \050carrier loss\051. Although it's a bother, it may save time) 68 W( in)69 W 8620 31619 MT (the long run to break the file up into smaller pieces, transfer the pieces, and then recombine) 12 W( on the other)11 W 8620 32724 MT (end.)SH /Symbol SF 7910 34713 MT (\267)SH /Times-Roman SF 8620 XM (SET INCOMPLETE KEEP on the receiving end, so that if the transfer fails, then the) 26 W( partial file will be)27 W 8620 35818 MT (retained. Then) 408 W( chop the part that wasn't transferred into a separate file, reconnect, and send it. Then)79 W 8620 36923 MT (join the pieces together.)SH 6120 38714 MT (Consider moving truly massive amounts of data on magnetic media. "Never understimate the bandwidth of a station)7 W 6120 39910 MT (wagon full of magnetic tapes!" \050or diskettes\051.)SH 12 /Times-Bold AF 6120 43026 MT (5.6.6. Commands for Raw Uploading and Downloading)SH 10 /Times-Roman AF 6120 44968 MT (MS-Kermit can be used to send files) 106 W( to, or capture files from, remote systems that do not have Kermit programs)105 W 6120 46164 MT (available. No) 280 W( error checking) 15 W( or correction is done, so the results can very likely contain corrupted characters, spurts)16 W 6120 47360 MT (of noise, gaps,) 112 W( or extraneous system messages or prompts. The command for uploading is TRANSMIT, and for)111 W 6120 48556 MT (downloading LOG SESSION.)SH 6120 50948 MT (To minimize loss of data during these operations,) 205 W( be sure to SET the FLOW-CONTROL and HANDSHAKE)206 W 6120 52144 MT (parameters to match the characteristics of the system on the other end.)SH 12 /Times-Bold AF 6120 54732 MT (The TRANSMIT Command)SH 10 /Times-Roman AF 6120 56146 MT (Syntax:)SH /Courier SF 9426 XM (TRANSMIT)SH /Times-Italic SF 14826 XM (filespec)SH /Courier SF 18481 XM ([)SH /Times-Italic SF (prompt-character)SH /Courier SF (])SH /Times-Roman SF 6120 58538 MT (The TRANSMIT) 21 W( command provides a basic raw upload \050export\051 facility to send straight ASCII text files to the host)20 W 6120 59734 MT (without packets, error checking, or retransmissions, but using all the currently) 79 W( selected communication parameters)80 W 6120 60930 MT (for flow control, parity, etc. Information) 61 W( is read from the disk file a line at a time, sent out the serial port, and the)60 W 6120 62126 MT (command waits for a single character) 36 W( prompt \050normally linefeed\051 from the host before sending the next file line. A)37 W 6120 63322 MT (disk file) 89 W( line ends with carriage-return-linefeed \050CRLF\051, but only the carriage return is sent, just as you only type)88 W 6120 64518 MT (carriage return at the end of a line, not CR and LF. Most remote systems will echo the CR and then also supply a)59 W 6120 65714 MT (LF, which indicates that they have processed) 80 W( the line and are ready for another one. Setting the prompt to binary)79 W 6120 66910 MT (zero,)SH /Courier SF 8435 XM (\1340)SH /Times-Roman SF (, makes the TRANSMIT command proceed without waiting for) 94 W( a prompt. Pressing the local Return key)95 W 6120 68106 MT (simulates arrival of a prompt character.)SH 6120 70498 MT (Typically, before using this) 1 W( command to upload a file, you would start a text editor \050preferably a line-oriented, rather)SH 6120 71694 MT (than full-screen, editor\051 on the remote host and put it into text insertion mode.) 65 W( When) 381 W( the file has been completely)66 W ES %%Page: 71 72 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.6.6. Commands for Raw Uploading and Downloading)SH 10 /Times-Italic AF 51775 XM (Page 71)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (transmitted, you would manually enter the required sequence for) 79 W( getting the editor out of text insertion mode, and)78 W 8280 9082 MT (then make any necessary corrections by hand. Here's an example for VAX/VMS:)SH /Courier SF 10680 10797 MT (Kermit-MS>set flow xon/xoff)SH /Times-Italic SF 30480 XM (Set flow control to match VAX/VMS.)SH 10200 50 16680 10997 UL /Courier SF 10680 11828 MT (Kermit-MS>connect)SH /Times-Italic SF 30480 XM (Connect to VAX.)SH 4200 50 16680 12028 UL /Courier SF 10680 12859 MT ($ edt foo.txt)SH /Times-Italic SF 30480 XM (Start the EDT editor.)SH 6600 50 11880 13059 UL /Courier SF 10680 13890 MT (*i)SH /Times-Italic SF 30480 XM (Put it into "insert" mode.)SH 600 50 11280 14090 UL /Courier SF 10680 14921 MT (^]c)SH /Times-Italic SF 30480 XM (Escape back to Kermit-MS.)SH 1800 50 10680 15121 UL /Courier SF 10680 15952 MT (Kermit-MS>transmit foo.txt)SH /Times-Italic SF 30480 XM (Upload the file a line at a time.)SH 9600 50 16680 16152 UL /Courier SF 11280 16983 MT (...)SH /Times-Italic SF 30480 XM (The lines are displayed on your screen.)SH /Courier SF 10680 18014 MT (Kermit-MS>connect)SH /Times-Italic SF 30480 XM (When done, connect back to the VAX.)SH 4200 50 16680 18214 UL /Courier SF 10680 19045 MT (^Z)SH /Times-Italic SF 30480 XM (Type Ctrl-Z to exit EDT insert mode.)SH 1200 50 10680 19245 UL /Courier SF 10680 20076 MT (*exit)SH /Times-Italic SF 30480 XM (Exit from EDT to save the file.)SH 2400 50 11280 20276 UL /Courier SF 10680 21107 MT ($)SH /Times-Roman SF 8280 23499 MT (If transmission appears to be stuck, you can wake it up by typing a carriage return on the keyboard.) 19 W( You) 290 W( can cancel)20 W 8280 24695 MT (the TRANSMIT command by typing a Control-C. Control-Z's or other control characters) 149 W( in the file may have)148 W 8280 25891 MT (adverse effects on the host. For this reason,) 90 W( you should use TRANSMIT only for files that contain 7-bit printing)91 W 8280 27087 MT (ASCII characters, spaces, tabs, carriage returns, linefeeds, and possibly formfeeds.)SH 12 /Times-Bold AF 8280 29675 MT (The LOG SESSION Command)SH 10 /Times-Roman AF 8280 31089 MT (Syntax:)SH /Courier SF 11586 XM (LOG SESSION)SH /Times-Roman SF 18786 XM ([)SH /Times-Italic SF (filespec)SH /Times-Roman SF (])SH 8280 33481 MT (The LOG SESSION command lets you copy the characters that appear on your screen) 69 W( during CONNECT into the)68 W 8280 34677 MT (specified file on the PC. You can use this) 41 W( command to download files by displaying \050usually with a command like)42 W 8280 35873 MT (TYPE\051 the file on the remote system while logging is in effect. Example:)SH /Courier SF 10680 37588 MT (Kermit-MS>set flow xon/xoff)SH /Times-Italic SF 30480 XM (Set flow control to match VAX/VMS.)SH 10200 50 16680 37788 UL /Courier SF 10680 38619 MT (Kermit-MS>connect)SH /Times-Italic SF 30480 XM (Connect to the VAX.)SH 4200 50 16680 38819 UL /Courier SF 10680 39650 MT ($ type foo.bar)SH /Times-Italic SF 30480 XM (Give this command, but don't type CR yet.)SH 7200 50 11880 39850 UL /Courier SF 10680 40681 MT (^]c)SH /Times-Italic SF 30480 XM (Escape back.)SH 1800 50 10680 40881 UL /Courier SF 10680 41712 MT (Kermit-MS>log session foo.bar)SH /Times-Italic SF 30480 XM (Start logging.)SH 11400 50 16680 41912 UL /Courier SF 10680 42743 MT (Kermit-MS>connect)SH /Times-Italic SF 30480 XM (Connect back.)SH 4200 50 16680 42943 UL 30480 43774 MT (Now type the carriage return.)SH /Courier SF 10680 44805 MT (This is the file FOO.BAR.)SH /Times-Italic SF 30480 XM (The file is displayed on your screen)SH /Courier SF 10680 45836 MT (Blah blah ...)SH /Times-Italic SF 30480 XM (and captured into PC file)SH /Courier SF 41247 XM (FOO.BAR.)SH 10680 46867 MT ($)SH /Times-Italic SF 30480 XM (The prompt is captured too.)SH /Courier SF 10680 47898 MT (^]c)SH /Times-Italic SF 30480 XM (When done, escape back)SH 1800 50 10680 48098 UL /Courier SF 10680 48929 MT (Kermit-MS>close session)SH /Times-Italic SF 30480 XM (and close the log file.)SH 7800 50 16680 49129 UL /Times-Roman SF 8280 50646 MT (The PC file)194 W /Courier SF 13723 XM (FOO.BAR)SH /Times-Roman SF 18367 XM (now contains a \050possibly mutilated\051 copy of the remote) 194 W( computer's)193 W /Courier SF 47357 XM (FOO.BAR)SH /Times-Roman SF 52000 XM (file. It)636 W 8280 51842 MT (probably has the remote system's prompt at the end, which you) 79 W( can edit out. The session log can also be used to)80 W 8280 53038 MT (record typescripts, editing sessions, Tektronix graphics output, or any other) 49 W( output from, or dialog with, the remote)48 W 8280 54234 MT (computer.)SH 8280 56626 MT (During terminal emulation, the LOG command records all the) 132 W( characters that arrive from the remote host in the)133 W 8280 57822 MT (specified file, including escape sequences, with any input character translations applied according to) 355 W( SET)354 W 8280 59018 MT (TRANSLATION INPUT. If you have SET LOCAL-ECHO ON, the characters you type will also be) 146 W( recorded.)147 W 8280 60214 MT (Logging may be suspended and resumed within) 71 W( a terminal session with the CONNECT escape-level commands Q)70 W 8280 61410 MT (and R. The log file will be composed of 7-bit ASCII bytes if \050a\051 PARITY is other than) 49 W( NONE, or \050b\051 DISPLAY is)50 W 8280 62606 MT (SET to 7. If DISPLAY is 8 and PARITY is NONE, or if DEBUG is ON, then the log will contain 8-bit bytes.)SH 8280 64998 MT (You may LOG SESSION PRN to cause the) 43 W( logging information to be printed directly on your printer. Any escape)42 W 8280 66194 MT (sequences that are sent to the screen are also sent to the printer.)SH 8280 68586 MT (If you) 32 W( want to record information without imbedded escape sequences, use the screen dump feature, invoked by the)33 W 8280 69782 MT (CONNECT escape-level command F, which is described under the CONNECT command.)SH ES %%Page: 72 73 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 72)SH 12 /Times-Bold AF 28885 XM (Kermit User Guide: MS-DOS KERMIT \0505.6.6\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (A session log cannot be played back directly on the PC from the log file. To relive the session, you must transfer) 29 W( it)28 W 6120 9082 MT (to the remote system and display it in "binary mode" \050e.g. cat in Unix\051 while CONNECTed.)SH 12 /Times-Bold AF 6120 12198 MT (5.6.7. Kermit Server Commands)SH 10 /Times-Roman AF 6120 14140 MT (Kermit-MS can act as a Kermit server, and can also interact with other Kermit servers. Normally, the remote)170 W 6120 15336 MT (Kermit is put into server mode. Then the local Kermit becomes a "client", and may issue repeated commands to the)19 W 6120 16532 MT (server without having to connect and escape back repeatedly.) 168 W( Servers) 587 W( can not only transfer files, but can also)169 W 6120 17728 MT (provide a variety of file management functions.) 17 W( The) 282 W( SERVER command puts MS-Kermit into server mode, and the)16 W 6120 18924 MT (DISABLE and ENABLE commands modify the behavior of the server.)SH 6120 21316 MT (Kermit servers respond only) 77 W( to information sent as Kermit protocol packets and not to ordinary CONNECT-mode)78 W 6120 22512 MT (commands. When) 348 W( MS-Kermit is the client,) 49 W( it uses the SEND command \050described above\051 to send files to a server,)48 W 6120 23708 MT (the GET command \050)279 W /Times-Italic SF (not)SH /Times-Roman SF 16957 XM (RECEIVE\051 to get files from a server,) 279 W( the REMOTE commands to invoke the file)280 W 6120 24904 MT (management functions) 52 W( of the server, and the BYE, FINISH, or LOGOUT commands to shut down the server. The)51 W 6120 26100 MT (MS-Kermit server can also be returned to interactive mode by typing Ctrl-C) 150 W( or Ctrl-Break on the PC's console)151 W 6120 27296 MT (keyboard.)SH 12 /Times-Bold AF 6120 29884 MT (The SERVER Command)SH 10 /Times-Roman AF 6120 31298 MT (Syntax: SERVER [timeout])SH 6120 33690 MT (Kermit-MS is capable of acting as a) 357 W( full-fledged Kermit server for users coming in through one of the)356 W 6120 34886 MT (communication ports or a local area network. To put Kermit-MS into) 137 W( server mode, first issue any desired SET)138 W 6120 36082 MT (commands to select and configure the desired port,) 176 W( then DISABLE any undesired functions, and then type the)175 W 6120 37278 MT (SERVER command. Kermit-MS will await all further instructions from the client Kermit) 86 W( on the other end of the)87 W 6120 38474 MT (connection, which may be hardwired, or connected through a network or autoanswer modem.)SH 6120 40866 MT (In the following example, a Kermit server is set up for dialing in:)SH /Courier SF 8520 42521 MT (Kermit-MS>set port 1)SH 6000 50 14520 42721 UL 8520 43552 MT (Kermit-MS>set baud 1200)SH 7800 50 14520 43752 UL 8520 44583 MT (Kermit-MS>hangup)SH 3600 50 14520 44783 UL 8520 45614 MT (Kermit-MS>connect)SH 4200 50 14520 45814 UL 8520 46645 MT (ATS0=1)SH 3600 50 8520 46845 UL 8520 47676 MT (OK)SH 8520 48707 MT (^]c)SH 1800 50 8520 48907 UL 8520 49738 MT (Kermit-MS>set timer off)SH 7800 50 14520 49938 UL 8520 50769 MT (Kermit-MS>set warning on)SH 8400 50 14520 50969 UL 8520 51800 MT (Kermit-MS>disable all)SH 6600 50 14520 52000 UL 8520 52831 MT (Kermit-MS>server)SH 3600 50 14520 53031 UL /Times-Roman SF 6120 54548 MT (Before putting) 126 W( Kermit in server mode in this case it was necessary to connect to the modem \050in this example, a)125 W 6120 55744 MT (Hayes\051 and put it into autoanswer mode by typing the ATS0=1 command. Since Kermit packets typically start with)37 W 6120 56940 MT (a Control-A character check) 86 W( the modem's manual to ensure that character is not a modem command signal; some)85 W 6120 58136 MT (brands regard Control-A as a hangup request!)SH 6120 60528 MT (Note the command SET TIMER OFF. This disables MS-Kermit's ability to time) 17 W( out when waiting for a packet, but)18 W 6120 61724 MT (it may be necessary in some cases. For example,) 7 W( certain modems or PBX's will be taken out of answer mode if they)6 W 6120 62920 MT (receive any characters from the PC before a call is) 10 W( received. SET TIMER OFF prevents the MS-Kermit server from)11 W 6120 64116 MT (transmitting the periodic NAK packets that would cause this problem, but you should) 28 W( ensure that the calling Kermit)27 W 6120 65312 MT (has its timer ON) 87 W( to avoid protocol deadlocks. Version 2.31A and later have a special command to disable server)88 W 6120 66508 MT (timeouts, SET SERVER TIMEOUT 0, while leaving regular protocol timeouts operational.)SH 6120 68900 MT (An optional timeout value can be specified to exit server mode automatically) 45 W( at a certain time. The timeout can be)44 W 6120 70096 MT (expressed as a number, meaning seconds from now, or as the)17 W /Courier SF 30996 XM (hh:mm:ss)SH /Times-Roman SF 36063 XM (form, in 24-hour time of day. Both forms)17 W 6120 71292 MT (recognize times greater than 12 hours from now as being in the) 118 W( past. For instance, if you want to run a Kermit)117 W ES %%Page: 73 74 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.6.7. Kermit Server Commands)SH 10 /Times-Italic AF 51775 XM (Page 73)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (server for an hour, and then have it exit so that another program can run, use a command file like:)SH /Courier SF 10680 9541 MT (set port 1) SH( ;) 4200 W( Use COM1)SH 10680 10572 MT (set speed 2400) SH( ;) 1800 W( at 2400 bps.)SH 10680 11603 MT (disable all) SH( ;) 3600 W( Only allow file transfers in current directory.)SH 10680 12634 MT (server 3600) SH( ;) 3600 W( Be a server for 3600 seconds = 1 hour.)SH 10680 13665 MT (exit ;) 7800 W( Exit when done.)SH /Times-Roman SF 8280 15456 MT (MS-Kermit)SH /Courier SF 13141 XM (2.31)SH /Times-Roman SF 15791 XM (server mode supports the following requests:)SH 10280 17247 MT (SEND)SH 21080 XM (REMOTE CWD \050CD\051)SH 35480 XM (REMOTE MESSAGE)SH 10280 18352 MT (GET)SH 21080 XM (REMOTE DELETE)SH 35480 XM (REMOTE SEND)SH 10280 19457 MT (FINISH)SH 21080 XM (REMOTE DIRECTORY)SH 35480 XM (REMOTE SPACE)SH 10280 20562 MT (BYE)SH 21080 XM (REMOTE HELP)SH 35480 XM (REMOTE TYPE)SH 10280 21667 MT (LOGO)SH 21080 XM (REMOTE HOST)SH 35480 XM (REMOTE WHO)SH 8280 24059 MT (REMOTE CWD \050CD\051 can be used to change both directories and devices.) 97 W( The) 446 W( REMOTE MESSAGE command)98 W 8280 25255 MT (accepts a one line message on the command line which will be displayed on the operator's console. An) 25 W( MS-Kermit)24 W 8280 26451 MT (Server can DISABLE recognition of selected REMOTE commands to help reduce accidents.)SH /Times-Italic SF 10280 28242 MT (CAUTION:)SH /Times-Roman SF 15278 XM (The method used for most of the REMOTE commands is to invoke a task with) 137 W( the user's)138 W 10280 29347 MT (command line, redirect standard output to a temporary file,)96 W /Courier SF 35001 XM ($KERMIT$.TMP)SH /Times-Roman SF (, send that file back to) 96 W( the)95 W 10280 30452 MT (remote end, and then delete the file.) 30 W( Sufficient) 311 W( space must be available to store this file. To service DOS)31 W 10280 31557 MT (commands or user tasks)SH /Courier SF 20112 XM (COMMAND.COM)SH /Times-Roman SF 26962 XM (must be located on the DOS PATH.)SH /Times-Italic SF 10280 33858 MT (FURTHER CAUTION:)127 W /Times-Roman SF 20089 XM (Any of these DOS tasks or programs may encounter an error, and in) 127 W( that case,)126 W 10280 34963 MT (DOS will generally put the familiar "Abort, Retry, Ignore?" message) 22 W( on the server's screen, and will wait)23 W 10280 36068 MT (for an answer from the keyboard. This will hang) 122 W( the server until a human comes to the keyboard and)121 W 10280 37173 MT (gives a response. The same thing will happen) 89 W( when any program is invoked that interacts with the real)90 W 10280 38278 MT (console. DISABLE) 250 W( ALL seems to avoid most unpleasant situations of this kind.)SH 8280 40069 MT (For local network operation with NetBios,) 146 W( the SET PORT NET command \050with no node name\051 must be issued)145 W 8280 41265 MT (before the SERVER command. MS-Kermit then becomes a network-wide server, and other) 26 W( client Kermits can start)27 W 8280 42461 MT (a network session with) 34 W( it by using the name of the Kermit Server, which is shown on the server's screen when SET)33 W 8280 43657 MT (PORT NET is given. The Kermit Server accepts connections from other Kermits, but only one at) 11 W( a time. There may)12 W 8280 44853 MT (be many Kermit Servers active on) 81 W( the network simultaneously because each has a unique node name. Operations)80 W 8280 46049 MT (are exactly the same as with serial port usage and the session \050equivalent to a dialed phone) SH( connection\051 is maintained)1 W 8280 47245 MT (between the pair until too many timeouts occur, or the client Kermit) 34 W( issues a HANGUP command, exits to DOS, or)33 W 8280 48441 MT (SETs PORT NET to another node. In the latter cases, the server remains available for use by) 50 W( other client Kermits.)51 W 8280 49637 MT (If a client Kermit issues the BYE or FINISH command,) 45 W( the network server is shut down \050unless it was started with)44 W 8280 50833 MT (FIN disabled\051.)SH 12 /Times-Bold AF 8280 53421 MT (The DISABLE and ENABLE Commands)SH 10 /Times-Roman AF 8280 54835 MT (For security purposes, it may be desirable to leave your PC in Kermit server mode so that it can) 36 W( be dialed in to, but)37 W 8280 56031 MT (with certain functions unavailable to those who dial in. The DISABLE and ENABLE commands provide this)177 W 8280 57227 MT (control.)SH 8280 59619 MT (The DISABLE and ENABLE commands affect the following functions, with the effect of DISABLEs noted:)SH 10280 61410 MT (CWD)SH 14280 XM (\050CD\051 Changing of directories, disabled entirely.)SH 10280 62515 MT (DEL)SH 14280 XM (Deletion of files confined to current directory.)SH 10280 63620 MT (DIR)SH 14280 XM (Production of directory listings confined to current directory.)SH 10280 64725 MT (FIN)SH 14280 XM (Shutting down the server \050applies also to BYE\051 disabled entirely.)SH 10280 65830 MT (GET)SH 14280 XM (Getting files from the server confined to current directory.)SH 10280 66935 MT (HOST)SH 14280 XM (Execution of all REMOTE HOST \050DOS\051 commands disabled entirely.)SH 10280 68040 MT (SEND)SH 14280 XM (Forces files sent to server into current directory.)SH 10280 69145 MT (SPACE)SH 14280 XM (Asking the server for a disk space report, disabled.)SH 10280 70250 MT (TYPE)SH 14280 XM (REMOTE TYPE files confined to current directory.)SH 10280 71355 MT (ALL)SH 14280 XM (All of the above.)SH ES %%Page: 74 75 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 74)SH 12 /Times-Bold AF 28885 XM (Kermit User Guide: MS-DOS KERMIT \0505.6.7\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 8120 7886 MT (TEK)SH 12120 XM (Automatic invocation of Tektronix graphics mode by) 27 W( host commands. This function is not related to)28 W 12120 8991 MT (server mode, and is not included in the ALL term.)SH 6120 10782 MT (For reasons which should be obvious, the Kermit server does not provide a REMOTE ENABLE command!)SH 12 /Times-Bold AF 6120 13370 MT (The GET Command)SH 10 /Times-Roman AF 6120 14784 MT (Syntax:)SH /Courier SF 9426 XM (GET)SH /Times-Italic SF 11826 XM (remote-filespec)SH /Times-Roman SF 6120 17176 MT (The GET command requests a Kermit server to send) 189 W( the file or file group specified by)188 W /Times-Italic SF 43851 XM (remote-filespec)SH /Times-Roman SF (. This)626 W 6120 18372 MT (command can be used only when Kermit-MS has a Kermit server active on the other end of the) 75 W( connection. This)76 W 6120 19568 MT (usually means that you have CONNECTed to the other system, logged in, run Kermit there,) 103 W( issued the SERVER)102 W 6120 20764 MT (command, and escaped back \050e.g. ``)47 W /Courier SF (^]C)SH /Times-Roman SF (''\051 to the local Kermit-MS. In) 47 W( the case of LAN operation, a Kermit server)48 W 6120 21960 MT (must be running somewhere on the network. If the remote Kermit does not have a SERVER command,) 82 W( then you)81 W 6120 23156 MT (should use SEND and RECEIVE as described above.)SH 6120 25548 MT (You may use the GET command in a special way to specify a different name for storing the incoming) 10 W( file. Just type)11 W 6120 26744 MT (GET alone on a line, and you will be prompted separately for the remote filespec and the local filespec:)SH /Courier SF 8520 28399 MT (Kermit-MS>get)SH 1800 50 14520 28599 UL 9120 29430 MT (Remote Source File: com1 txt)SH 4800 50 21120 29630 UL 9120 30461 MT (Local Destination File: a:xcom1.txt)SH 6600 50 23520 30661 UL /Times-Roman SF 6120 32178 MT (The local file name may) 24 W( contain a device field, and/or a directory specification. Device and directory specifications)23 W 6120 33374 MT (in the local destination file name work the same way as in the RECEIVE command.) 48 W( The) 347 W( multiline GET command)49 W 6120 34570 MT (is provided so that the distinction between the two files is always clear, which would not otherwise be the case if) 12 W( the)11 W 6120 35766 MT (foreign filename had spaces in it.)SH 6120 38158 MT (The remote filespec is any string that can) 137 W( be a legal file specification for the remote system; it is not parsed or)138 W 6120 39354 MT (validated locally. It can contain whatever wildcard or file-group notation is valid on the remote system,) 72 W( including)71 W 6120 40550 MT (spaces. If the string) 27 W( needs to begin with a question mark \050?\051 then use a sharp sign \050#\051 instead to avoid Kermit's help)28 W 6120 41746 MT (message; it will be transmitted as a question mark.)SH 6120 44138 MT (Once the file transfer begins, the GET command behaves exactly like the RECEIVE command.)SH /Times-Italic SF 6120 46530 MT (Warning:)SH /Times-Roman SF 10649 XM (If the remote filespec) 98 W( is to contain a semicolon,)97 W /Times-Italic SF 30744 XM (and)SH /Times-Roman SF 32591 XM (the GET command is being issued from a TAKE)97 W 6120 47726 MT (command file, you must prefix the semicolon with a backslash.) 208 W( Otherwise,) 667 W( all characters beginning with the)209 W 6120 48922 MT (semicolon will be ignored:)SH /Courier SF 8520 50577 MT (get me.home\134;2)SH 12 /Times-Bold AF 6120 53693 MT (5.6.8. Commands for Controlling Remote Kermit Servers)SH 10 /Times-Roman AF 6120 55635 MT (The BYE, FINISH, and LOGOUT commands allow you to shut down a remote Kermit server:)SH /Courier SF 6120 57426 MT (BYE)SH /Times-Roman SF 10120 XM (When communicating with a remote Kermit server, use the BYE command) 82 W( to shut down the server, log)81 W 10120 58531 MT (out its job, and exit locally from Kermit-MS to DOS. On local) 86 W( area networks, BYE also terminates the)87 W 10120 59636 MT (network session.)SH /Courier SF 6120 61213 MT (FINISH)SH /Times-Roman SF 10120 XM (Like BYE, FINISH shuts down the remote server. However,) 92 W( FINISH does not log out the server's job.)91 W 10120 62318 MT (You are left at Kermit-MS prompt level so that you) 14 W( can connect back to the job on the remote system. On)15 W 10120 63423 MT (local area nets,) 44 W( FINISH shuts down the MS-Kermit server, but in a way that allows it to be restarted as if)43 W 10120 64528 MT (no interruption had occurred.)SH /Courier SF 6120 66105 MT (LOGOUT)SH /Times-Roman SF 10120 XM (The LOGOUT command is identical to the BYE command, except) 31 W( you will remain at Kermit-MS prompt)32 W 10120 67210 MT (level, rather than exit to DOS, so that you can establish or use another) 8 W( connection without having to restart)7 W 10120 68315 MT (MS-Kermit.)SH ES %%Page: 75 76 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.6.8. Commands for Controlling Remote Kermit Servers)SH 10 /Times-Italic AF 51775 XM (Page 75)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (The REMOTE Commands)SH 10 /Times-Roman AF 8280 9418 MT (The REMOTE) 19 W( keyword is a prefix for a number of commands. It indicates that the command is to be performed by)20 W 8280 10614 MT (a remote Kermit server. Not all Kermit servers are capable) 68 W( of executing all of these commands, and some Kermit)67 W 8280 11810 MT (servers may be able to perform functions for which Kermit-MS does not yet have the corresponding commands.) 34 W( In)320 W 8280 13006 MT (case you send) 175 W( a command the server cannot execute, it will send back a message stating that the command is)174 W 8280 14202 MT (unknown to it. If the remote server can execute the command, it will send the results, if any, to your screen.)SH 8280 16594 MT (Here are the REMOTE commands that Kermit-MS may issue:)SH /Courier SF 8280 18385 MT (REMOTE CWD)SH /Times-Roman SF 14880 XM ([)SH /Times-Italic SF (directory)SH /Times-Roman SF (])SH 12280 19490 MT (\050Also REMOTE CD\051 Ask the server to Change your Working Directory on the remote) 95 W( host, that is, the)94 W 12280 20595 MT (default source and destination area for file transfer and management. You) 243 W( will be prompted for a)244 W 12280 21700 MT (password, which will not echo as you type it. If you do not supply a) 151 W( password \050i.e. you type only a)150 W 12280 22805 MT (carriage return\051,) 7 W( the server will attempt to access the specified directory without a password. If you do not)8 W 12280 23910 MT (supply a directory name, your default or login) 97 W( directory on the remote system will be assumed and you)96 W 12280 25015 MT (will not be prompted for a password.)SH /Courier SF 8280 26592 MT (REMOTE DELETE)SH /Times-Italic SF 16680 XM (filespec)SH /Times-Roman SF 12280 27697 MT (Ask the server to delete) 153 W( the specified file or files on the remote system. In response, the server may)152 W 12280 28802 MT (display a list of the files that were or were not successfully deleted.)SH /Courier SF 8280 30379 MT (REMOTE DIRECTORY)SH /Times-Roman SF 18480 XM ([)SH /Times-Italic SF (filespec)SH /Times-Roman SF (])SH 12280 31484 MT (Ask the server to display a directory listing of the) 102 W( specified files. If no files are specified, then the list)101 W 12280 32589 MT (should include all files in the current working directory.)SH /Courier SF 8280 34166 MT (REMOTE HELP)SH /Times-Roman SF 12280 35271 MT (Ask the server to list the services it provides.)SH /Courier SF 8280 36848 MT (REMOTE HOST)SH /Times-Roman SF 15480 XM ([)SH /Times-Italic SF (command)SH /Times-Roman SF (])SH 12280 37953 MT (Ask the server to send the command to the remote system's command processor for execution.)SH /Courier SF 8280 39530 MT (REMOTE KERMIT)SH /Times-Italic SF 16680 XM (command)SH /Times-Roman SF 12280 40635 MT (Send the command to the remote Kermit for interpretation as a Kermit command in the) 113 W( remote Kermit)112 W 12280 41740 MT (server's own command syntax.)SH /Courier SF 8280 43317 MT (REMOTE MESSAGE)SH /Times-Italic SF 17280 XM (text)SH /Times-Roman SF 12280 44422 MT (Send the one line text message to be displayed on the Server's screen.)SH /Courier SF 8280 45999 MT (REMOTE SPACE)SH /Times-Roman SF 16080 XM ([)SH /Times-Italic SF (directory)SH /Times-Roman SF (])SH 12280 47104 MT (Ask the server to provide a brief summary of disk usage in) 1 W( the specified area on the remote host or, if none)2 W 12280 48209 MT (specified, the default or current area.)SH /Courier SF 8280 49786 MT (REMOTE TYPE)SH /Times-Italic SF 15480 XM (filespec)SH /Times-Roman SF 12280 50891 MT (Ask the server to display the contents of the specified remote file or files on your screen.)SH /Courier SF 8280 52468 MT (REMOTE WHO [)SH /Times-Italic SF (who-spec)SH /Courier SF (])SH /Times-Roman SF 12280 53573 MT (Ask the server to list actively logged on users; optional who-spec qualifies the list and uses the syntax) 54 W( of)53 W 12280 54678 MT (the server system.)SH 12 /Times-Bold AF 8280 57266 MT (The Mail Command)SH 10 /Times-Roman AF 8280 58680 MT (Syntax:)SH /Courier SF 11836 XM (MAIL)SH /Times-Italic SF 14486 XM (filespec address)SH /Times-Roman SF 8280 61072 MT (The MAIL command is a very close relative of Kermit's SEND command. Mail sends a file,) 107 W( or file group, to a)108 W 8280 62268 MT (Kermit server with instructions \050in an Attribute packet\051 to submit the) 76 W( file\050s\051 to the host's Mailer utility rather than)75 W 8280 63464 MT (store them on disk. To round) 50 W( out a mail request a field following the filename is required, and into it we place the)51 W 8280 64660 MT (address to which the files are to be mailed. Mail addresses vary) 181 W( substantially, but several common forms are)180 W 8280 65856 MT ("username", "username)105 W /Courier SF (@)SH /Times-Roman SF (host", and "host)105 W /Courier SF (::)SH /Times-Roman SF (username". The) 460 W( MAIL command will) 105 W( work only if the Kermit server)106 W 8280 67052 MT (understands it, otherwise the mail request will be rejected before any) 27 W( files are sent. Kermit-MS can send mail but it)26 W 8280 68248 MT (cannot receive it, because MS-DOS does not have) 80 W( a mail facility. When sending, there is no way to transmit any)81 W 8280 69444 MT (fields other than the recipient's address and the message body; fields like subject and cc are not supported.)SH ES %%Page: 76 77 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 76)SH 12 /Times-Bold AF 28885 XM (Kermit User Guide: MS-DOS KERMIT \0505.6.9\051)SH 46800 50 6120 5709 UL 6120 8004 MT (5.6.9. The LOG and CLOSE Commands)SH 10 /Times-Roman AF 6120 9946 MT (Syntax:)SH /Courier SF 9426 XM (LOG {PACKET, SESSION, TRANSACTION})SH /Times-Roman SF 30426 XM ([)SH /Times-Italic SF (filespec)SH /Times-Roman SF (])SH /Courier SF 8120 11051 MT (CLOSE {PACKET, SESSION, TRANSACTION})SH /Times-Roman SF 6120 13443 MT (The LOG command tells MS-Kermit to record) 131 W( the terminal session, file transfer transactions, or the file transfer)130 W 6120 14639 MT (protocol packets themselves in a log file. If the log file already exists then new material is appended to it.) 12 W( Open) 276 W( log)13 W 6120 15835 MT (files may be closed \050and the associated) 155 W( logging disabled\051 using the CLOSE command. Open log files are also)154 W 6120 17031 MT (closed when you EXIT from Kermit.)SH 6120 19423 MT (LOG SESSION is used to record) 49 W( your terminal emulation typescript. It was described above, in the section on file)50 W 6120 20619 MT (transfer.)SH 12 /Times-Bold AF 6120 23207 MT (The LOG TRANSACTION Command)SH 10 /Times-Roman AF 6120 24621 MT (Syntax:)SH /Courier SF 9426 XM (LOG TRANSACTION)SH /Times-Roman SF 19026 XM ([)SH /Times-Italic SF (filespec)SH /Times-Roman SF (])SH 6120 27013 MT (The Transaction log is a file recording a pair of) 49 W( text lines describing each file transfer \050SEND, GET, RECEIVE, or)48 W 6120 28209 MT (some REMOTE commands\051. The lines indicate the local filename \050and remote) 39 W( name if different\051, the time and date)40 W 6120 29405 MT (of the start of the transfer, the number of bytes transferred, and the status of) 84 W( the transfer. New entries are always)83 W 6120 30601 MT (appended to old to prevent loss of records. The default filename is)171 W /Courier SF 35339 XM (TRANSACT.LOG)SH /Times-Roman SF (. The) 594 W( command SHOW)172 W 6120 31797 MT (LOGGING displays the current names and which logs are active. The command CLOSE) 128 W( TRANSACTION will)127 W 6120 32993 MT (voluntarily terminate this class of log; otherwise, it will be closed automatically when Kermit exits.)SH 12 /Times-Bold AF 6120 35581 MT (The LOG PACKETS Command)SH 10 /Times-Roman AF 6120 36995 MT (Syntax:)SH /Courier SF 9426 XM (LOG PACKETS)SH /Times-Roman SF 16626 XM ([)SH /Times-Italic SF (filespec)SH /Times-Roman SF (])SH 6120 39387 MT (The packet log is for diagnostic purposes and records each Kermit protocol packet sent and received) 108 W( in printable)109 W 6120 40583 MT (format. Control) 268 W( characters are written as caret-letter and characters with the high bit) 9 W( set are shown as their 7-bit part)8 W 6120 41779 MT (preceeded by a) 112 W( tilde. The default filename is)113 W /Courier SF 25408 XM (PACKET.LOG)SH /Times-Roman SF (. If) 476 W( you experience difficulty with file transfers the)113 W 6120 42975 MT (packet log is valuable in discovering) 55 W( who said what to whom, even though a copy of the Kermit book is needed to)54 W 6120 44171 MT (unravel the meaning of each character in a packet.)SH ES %%Page: 77 78 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.6.9. The LOG and CLOSE Commands)SH 10 /Times-Italic AF 51775 XM (Page 77)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (5.6.10. The SET Command)SH 10 /Times-Roman AF 8280 9946 MT (Syntax:)SH /Courier SF 11586 XM (SET)SH /Times-Italic SF 13986 XM (parameter)SH /Courier SF 18402 XM ([)SH /Times-Italic SF (parameter)SH /Courier SF (])SH /Times-Italic SF 24368 XM (value)SH /Times-Roman SF 8280 12338 MT (The SET) 100 W( command establishes or modifies parameters for file transfer or terminal connection. You can examine)101 W 8280 13534 MT (their values with the SHOW or STATUS commands. The following SET commands are available in Kermit-MS:)SH 19069 16468 MT (ALARM)SH 23180 XM (Set alarm clock time, for IF ALARM testing)SH 16569 17573 MT (ATTRIBUTES)SH 23180 XM (Controls whether MS-Kermit uses Attribute packets)SH 19847 18678 MT (BAUD)SH 23180 XM (Communications port line speed \050synonym for SPEED\051)SH 20180 19783 MT (BELL)SH 23180 XM (Whether to beep at the end of a transaction)SH 12736 20888 MT (BLOCK-CHECK-TYPE)SH 23180 XM (Level of error checking for file transfer)SH 19236 21993 MT (COUNT)SH 23180 XM (Variable for TAKE file and macro IF COUNT testing)SH 19236 23098 MT (DEBUG)SH 23180 XM (Display packet contents during file transfer)SH 15459 24203 MT (DEFAULT-DISK)SH 23180 XM (Default disk drive for file i/o)SH 19292 25308 MT (DELAY)SH 23180 XM (Wait number seconds before Sending a file)SH 16015 26413 MT (DESTINATION)SH 23180 XM (Default destination device for incoming files)SH 18458 27518 MT (DISPLAY)SH 23180 XM (For selecting the type of file transfer display)SH 19791 28623 MT (DUMP)SH 23180 XM (Screen dump file \050or device\051 name)SH 16404 29728 MT (END-OF-LINE)SH 23180 XM (Packet termination character)SH 20791 30833 MT (EOF)SH 23180 XM (Method for determining or marking end of file)SH 16180 31938 MT (ERRORLEVEL)SH 23180 XM (Value returned to DOS Batch files)SH 18957 33043 MT (ESCAPE)SH 23180 XM (Escape character for CONNECT)SH 14792 34148 MT (FLOW-CONTROL)SH 23180 XM (Enable or disable XON/XOFF)SH 16459 35253 MT (HANDSHAKE)SH 23180 XM (Half-duplex line turnaround option)SH 16347 36358 MT (INCOMPLETE)SH 23180 XM (What to do with an incompletely received file)SH 19736 37463 MT (INPUT)SH 23180 XM (Behavior of INPUT command for scripts)SH 20625 38568 MT (KEY)SH 23180 XM (Specify key redefinitions)SH 16292 39673 MT (LOCAL-ECHO)SH 23180 XM (Specify which computer does the echoing during CONNECT)SH 17126 40778 MT (MODE-LINE)SH 23180 XM (Whether to display a mode line during terminal emulation)SH 19069 41883 MT (PARITY)SH 23180 XM (Character parity to use)SH 20124 42988 MT (PORT)SH 23180 XM (Select a communications port)SH 18679 44093 MT (PROMPT)SH 23180 XM (Change the ")SH /Courier SF (Kermit-MS>)SH /Times-Roman SF (" prompt to something else)SH 18458 45198 MT (RECEIVE)SH 23180 XM (Request remote Kermit to use specified parameters)SH 18569 46303 MT (REMOTE)SH 23180 XM (For running Kermit-MS interactively from back port)SH 19402 47408 MT (RETRY)SH 23180 XM (Packet retransmission threshold)SH 20069 48513 MT (SEND)SH 23180 XM (Use the specified parameters during file transfer)SH 19624 49618 MT (SPEED)SH 23180 XM (Communications port line speed \050synonym for BAUD\051)SH 16959 50723 MT (TAKE-ECHO)SH 23180 XM (Control echoing of commands from TAKE files)SH 17514 51828 MT (TERMINAL)SH 23180 XM (Emulation and parameters)SH 19569 52933 MT (TIMER)SH 23180 XM (Enable/disable timeouts during file transfer)SH 15681 54038 MT (TRANSLATION)SH 23180 XM (Enable/disable/specify conversion of arriving characters)SH 17848 55143 MT (WARNING)SH 23180 XM (Specify how to handle filename collisions)SH 8280 57535 MT (The SET commands are now described in detail, in alphabetical order.)SH 12 /Times-Bold AF 8280 60123 MT (SET ALARM)SH 10 /Times-Roman AF 8280 61537 MT (Syntax:)SH /Courier SF 11586 XM (SET ALARM {)SH /Times-Italic SF (seconds, hh:mm:ss)SH /Courier SF (})SH /Times-Roman SF 8280 63929 MT (The alarm is) 6 W( a timer, like an alarm clock, available for testing by IF ALARM statements. The alarm time is given as)5 W 8280 65125 MT (seconds from the present or as a 24-hour specific) 90 W( time of day. Both need to be within 12 hours of the present to)91 W 8280 66321 MT (avoid being mistaken for times in the past. SHOW SCRIPT displays the current alarm setting.)SH ES %%Page: 78 79 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 78)SH 12 /Times-Bold AF 28285 XM (Kermit User Guide: MS-DOS KERMIT \0505.6.10\051)SH 46800 50 6120 5709 UL 6120 8004 MT (SET ATTRIBUTES)SH 10 /Times-Roman AF 6120 9418 MT (Syntax:)SH /Courier SF 9426 XM (SET ATTRIBUTES {ON, OFF})SH /Times-Roman SF 6120 11810 MT (Disables or enables use of Kermit file Attribute protocol packets, which contain the size, time, and) 133 W( date of files)132 W 6120 13006 MT (transferred with packets. This command) 86 W( is a safety feature so that a small misunderstanding with another Kermit)87 W 6120 14202 MT (cannot block transfers. SHOW FILE tells whether attributes are on or off; they are normally ON.)SH 12 /Times-Bold AF 6120 16790 MT (SET BAUD)SH 10 /Times-Roman AF 6120 18204 MT (Syntax:)SH /Courier SF 9426 XM (SET BAUD)SH /Times-Italic SF 14826 XM (number)SH /Times-Roman SF 6120 20596 MT (Synonym for SET SPEED \050q.v.\051.)SH 12 /Times-Bold AF 6120 23184 MT (SET BELL)SH 10 /Times-Roman AF 6120 24598 MT (Syntax:)SH /Courier SF 9426 XM (SET BELL {ON, OFF})SH /Times-Roman SF 6120 26990 MT (Specifies whether the bell \050beeper\051 should sound upon completion of a file transfer operation. Normally ON.)SH 12 /Times-Bold AF 6120 29578 MT (SET BLOCK-CHECK-TYPE)SH 10 /Times-Roman AF 6120 30992 MT (Syntax:)SH /Courier SF 9426 XM (SET BLOCK-CHECK-TYPE {1, 2, 3})SH /Times-Roman SF 6120 33384 MT (Selects the error detection) 68 W( method: a 1-character 6-bit checksum \050the normal case\051, a 2-character 12-bit checksum,)67 W 6120 34580 MT (or a 3-character 16-bit cyclic redundancy check \050CRC\051. If the other Kermit program is not capable of type 2 or) 73 W( 3)74 W 6120 35776 MT (checking methods, automatic fallback) 194 W( to type 1 will occur. The more secure type 2 and 3 block checks take)193 W 6120 36972 MT (essentially no more execution time than the simple 1 character checksum. SET BLOCK 3) 51 W( is a stronger check than)52 W 6120 38168 MT (SET BLOCK 2. SET BLOCK 2 or 3 is recommended for use with long packets \050see below\051, noisy) 38 W( communication)37 W 6120 39364 MT (lines, binary \0508-bit data\051 files, and text files containing critical data \050budgets, grades, etc\051.)SH 12 /Times-Bold AF 6120 41952 MT (SET COUNT)SH 10 /Times-Roman AF 6120 43366 MT (Syntax:)SH /Courier SF 9426 XM (SET COUNT)SH /Times-Italic SF 15426 XM (number)SH /Times-Roman SF 6120 45758 MT (Set the value of the script COUNT variable to be) 180 W( between 0 and 65535. COUNT is used with IF COUNT to)181 W 6120 46954 MT (construct counted loops in script TAKE files and macros. Each active TAKE file or macro uses a) 34 W( private version of)33 W 6120 48150 MT (COUNT. The default) 53 W( value is zero, and the SHOW SCRIPT command displays the current value \050meaningful only)54 W 6120 49346 MT (when given within a TAKE file or macro\051.)SH 12 /Times-Bold AF 6120 51934 MT (SET DEBUG)SH 10 /Times-Roman AF 6120 53348 MT (Syntax:)SH /Courier SF 9426 XM (SET DEBUG {PACKET, SESSION, ON, OFF})SH /Times-Roman SF 6120 55740 MT (With DEBUG PACKET, Kermit will display the actual packets on your screen during file transfer.) 8 W( With) 264 W( the normal)7 W 6120 56936 MT (file transfer display, regular-length packets sent and received are) 189 W( displayed in fixed-size slots. The display of)190 W 6120 58132 MT (extended-length packets, however \050see SET RECEIVE PACKET-LENGTH\051, tends to overlap.) 58 W( If) 365 W( this bothers you,)57 W 6120 59328 MT (then also SET DISPLAY SERIAL, or LOG the packets rather than displaying them.)SH 6120 61720 MT (With DEBUG SESSION, during terminal) 1 W( emulation \050on the IBM PC, Rainbow, and a few others\051, control characters)2 W 6120 62916 MT (are displayed in uparrow \050``)2 W /Courier SF (^)SH /Times-Roman SF (''\051 notation and characters with the) 2 W( 8th bit set are preceded by the tilde \050``)1 W /Courier SF (~)SH /Times-Roman SF (''\051 sign, and)1 W 6120 64112 MT (your session log \050if any\051 will record 8-bit bytes, rather than 7-bit ASCII, regardless of SET DISPLAY or) 162 W( SET)163 W 6120 65308 MT (PARITY. Character) 384 W( translation \050SET TRANSLATION INPUT\051 is not done during session) 67 W( debugging. The effect)66 W 6120 66504 MT (of SET DEBUG SESSION during terminal connection can be disconcerting, but it gives you a) 163 W( convenient line)164 W 6120 67700 MT (monitor equivalent to a specialized device that costs several thousand dollars, and it can prove very handy for)175 W 6120 68896 MT (tracking down data communication problems.)SH 6120 71288 MT (SET DEBUG ON turns on both SESSION and PACKET debugging, and SET DEBUG OFF turns them both off.)SH ES %%Page: 79 80 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.6.10. The SET Command)SH 10 /Times-Italic AF 51775 XM (Page 79)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (SET DEFAULT-DISK)SH 10 /Times-Roman AF 8280 9418 MT (Syntax:)SH /Courier SF 11586 XM (SET DEFAULT-DISK)SH /Times-Italic SF 21786 XM (x)SH /Courier SF (:[)SH /Times-Italic SF (directory)SH /Courier SF (])SH /Times-Roman SF 8280 11810 MT (Specify the default disk drive to use for file transfer, directory listings, and so forth. Equivalent) 47 W( to typing the DOS)48 W 8280 13006 MT (command for changing disks \050)156 W /Courier SF (A:)SH /Times-Roman SF (,)SH /Courier SF 22925 XM (B:)SH /Times-Roman SF (, etc\051.) 156 W( Affects) 561 W( Kermit and all inferior processes, but when you exit from)155 W 8280 14202 MT (Kermit, you will still have) 166 W( the same default disk as when you entered. As a convenience, a directory may be)167 W 8280 15398 MT (specified with or without the drive to change one or the other or both. This command is a synonym for CWD \050CD\051.)SH 12 /Times-Bold AF 8280 17986 MT (SET DELAY)SH 10 /Times-Roman AF 8280 19400 MT (Syntax:)SH /Courier SF 11586 XM (SET DELAY)SH /Times-Italic SF 17586 XM (number)SH /Times-Roman SF 8280 21792 MT (Wait the specified number of seconds before starting a file transfer. Intended for use) 119 W( when the other side needs)118 W 8280 22988 MT (appreciable time to become ready, such as) 24 W( rearranging cables, changing programs, etc., or when MS-DOS Kermit is)25 W 8280 24184 MT (the remote Kermit \050e.g. after CTTY COM1, SET REMOTE ON\051. The)SH /Times-Italic SF 36831 XM (number)SH /Times-Roman SF 40136 XM (is 0 to 63 seconds, normally 0.)SH 12 /Times-Bold AF 8280 26772 MT (SET DESTINATION)SH 10 /Times-Roman AF 8280 28186 MT (Syntax:)SH /Courier SF 11586 XM (SET DESTINATION {DISK, PRINTER, SCREEN})SH /Times-Roman SF 8280 30578 MT (SET DESTINATION PRINTER will cause incoming files) 148 W( to be sent directly to the printer; SCREEN will send)147 W 8280 31774 MT (output normally destined for the) 44 W( disk to the screen. The normal destination is DISK. SET DESTINATION affects)45 W 8280 32970 MT (only files transferred with SEND,) 24 W( GET, or RECEIVE; it cannot be used to reroute the output from REMOTE server)23 W 8280 34166 MT (commands.)SH 12 /Times-Bold AF 8280 36754 MT (SET DISPLAY)SH 10 /Times-Roman AF 8280 38168 MT (Syntax:)SH /Courier SF 11586 XM (SET DISPLAY {QUIET, REGULAR, SERIAL, 7-BIT, 8-BIT})SH /Times-Roman SF 8280 40560 MT (During file transfer, MS-DOS Kermit's) 131 W( regular display is a formatted screen whose fields are randomly updated)132 W 8280 41756 MT (with file names, packet numbers, error counts, percent done, error messages, and so forth, as shown in Figure 5-1.)SH 8280 44148 MT (If you wish to run Kermit-MS interactively through the back port, for instance after the operator) 96 W( has done CTTY)95 W 8280 45344 MT (COM1, you must give the command SET REMOTE ON \050which, currently at least, is) 47 W( equivalent to SET DISPLAY)48 W 8280 46540 MT (QUIET\051; this suppresses the file transfer display screen, so that the display won't interfere with) 136 W( the file transfer)135 W 8280 47736 MT (itself. You) 428 W( can also use this command to suppress) 89 W( the display in local mode, in case you are using a system that)90 W 8280 48932 MT (allows you to do other work while file transfer proceeds in the background.)SH 8280 51324 MT (If you have your PC connected to a speaking device \050a common practice for visually impaired people\051, or) 72 W( you are)71 W 8280 52520 MT (logging the display) 155 W( screen to a printer \050using DOS)156 W /Courier SF 30041 XM (^P)SH /Times-Roman SF 31647 XM (or)SH /Courier SF 32886 XM (kermit > prn)156 W /Times-Roman SF (\051, the random nature of the regular)156 W 8280 53716 MT (display will make the results of little use. SET DISPLAY SERIAL is provided for this purpose; it causes) 168 W( the)167 W 8280 54912 MT (program to report progress "serially" on the screen. In serial mode, error messages are preceeded with the word)114 W 8280 56108 MT ("Error" and repeat messages with the word "Retry". Packets are numbered as dots with every) 106 W( tenth being a plus)105 W 8280 57304 MT (sign. The) 337 W( packet display is automatically broken across lines at every 70th packet. The serial display makes much)44 W 8280 58500 MT (more sense when spoken than does the regular display.)SH 8280 60892 MT (The serial display does not show the percent and kilobytes transferred. It) 116 W( is the default display style for generic)115 W 8280 62088 MT (MS-DOS Kermit; REGULAR is the default for all others.)SH 8280 64480 MT (The last two) 251 W( parameters, 7-BIT and 8-BIT, control the size of characters sent to the screen during terminal)252 W 8280 65676 MT (emulation. 7-BIT) 380 W( is the default and includes) 65 W( all ASCII characters. 8-BIT is useful with national and line drawing)64 W 8280 66872 MT (characters.)SH ES %%Page: 80 81 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 80)SH 12 /Times-Bold AF 28285 XM (Kermit User Guide: MS-DOS KERMIT \0505.6.10\051)SH 46800 50 6120 5709 UL 6120 8004 MT (SET DUMP)SH 10 /Times-Roman AF 6120 9418 MT (Syntax:)SH /Courier SF 9426 XM (SET DUMP)SH /Times-Italic SF 14826 XM (filespec)SH /Times-Roman SF 6120 11810 MT (On those systems that support this feature, change the file or device) 42 W( name of the screen dump file. The normal file)43 W 6120 13006 MT (name is)44 W /Courier SF 9541 XM (KERMIT.SCN)SH /Times-Roman SF (. See) 338 W( the section on terminal emulation for details about screen dumps. If the) 44 W( specified file)43 W 6120 14202 MT (already exists then new material is) 38 W( appended to old. If you want to start a new screen dump file, delete the old one)39 W 6120 15398 MT (first.)SH 12 /Times-Bold AF 6120 17986 MT (SET END-OF-LINE)SH 10 /Times-Roman AF 6120 19400 MT (Syntax:)SH /Courier SF 9426 XM (SET END-OF-LINE)SH /Times-Italic SF 19026 XM (number)SH /Times-Roman SF 6120 21792 MT (If the remote system needs packets to be) 143 W( terminated by anything other than carriage return, specify the decimal)142 W 6120 22988 MT (value, 0-31, of the desired ASCII character.) 17 W( Equivalent) 285 W( to SET SEND END-OF-LINE \050SET END-OF-LINE is kept)18 W 6120 24184 MT (only for historical reasons, and the parameter really should be called END-OF-PACKET anyway.\051)SH 12 /Times-Bold AF 6120 26772 MT (SET EOF)SH 10 /Times-Roman AF 6120 28186 MT (Syntax:)SH /Courier SF 9426 XM (SET EOF {CTRL-Z, NOCTRL-Z})SH /Times-Roman SF 6120 30578 MT (Controls how the end of file is handled. CTRL-Z specifies a) 45 W( Control-Z character should be appended to the end of)44 W 6120 31774 MT (an incoming file.) 192 W( Certain) 636 W( MS-DOS text editors and other applications require files to be in this format. For)193 W 6120 32970 MT (outbound files, treat the first Control-Z as the end) 47 W( of the local file, and do not send it or any subsequent characters.)46 W 6120 34166 MT (NOCTRL-Z is the default; incoming files are stored, and MS-DOS files are sent, exactly as is, in their entirety.) 18 W( Use)288 W 6120 35362 MT (SHOW FILE to see the current SET EOF status.)SH 12 /Times-Bold AF 6120 37950 MT (SET ERRORLEVEL)SH 10 /Times-Roman AF 6120 39364 MT (Syntax:)SH /Courier SF 9426 XM (SET ERRORLEVEL)SH /Times-Italic SF 18426 XM (number)SH /Times-Roman SF 6120 41756 MT (Forces the DOS "errorlevel" variable to a given value.) 82 W( This) 413 W( is used mainly in scripts when other controls or tests)81 W 6120 42952 MT (determine that the) 161 W( cumulative errorlevel reported to DOS Batch when Kermit exits needs to be modified. The)162 W 6120 44148 MT (number can be 0 to 255 decimal.)SH 12 /Times-Bold AF 6120 46736 MT (SET ESCAPE)SH 10 /Times-Roman AF 6120 48150 MT (Syntax:)SH /Courier SF 9426 XM (SET ESCAPE)SH /Times-Italic SF 16026 XM (character)SH /Times-Roman SF 6120 50542 MT (Specify the control character you want to use to) 85 W( "escape" from remote connections back to Kermit-MS. On most)84 W 6120 51738 MT (systems the default is) 262 W( ``)263 W /Courier SF (^])SH /Times-Roman SF ('' \050Control-Rightbracket\051, which was chosen because it is a character you would)263 W 6120 52934 MT (otherwise rarely type.)SH 6120 55326 MT (The)SH /Times-Italic SF 8044 XM (character)SH /Times-Roman SF 12300 XM (is entered literally after SET ESCAPE or in backslash number form \050)118 W /Courier SF (\13429)SH /Times-Roman SF (\051, and should be chosen)118 W 6120 56522 MT (from the ASCII control range. It is) 74 W( not possible to use non-ASCII characters \050like function keys\051 for this purpose)75 W 6120 57718 MT (\050but see SET KEY for a way around this restriction\051.)SH 12 /Times-Bold AF 6120 60306 MT (SET FLOW-CONTROL)SH 10 /Times-Roman AF 6120 61720 MT (Syntax:)SH /Courier SF 9426 XM (SET FLOW-CONTROL {XON/XOFF, NONE})SH /Times-Roman SF 6120 64112 MT (Specify the full duplex flow control to be done on) 119 W( the currently selected port. The options are XON/XOFF and)118 W 6120 65308 MT (NONE. The) 588 W( specified type of flow control) 169 W( will be done during both terminal emulation and file transfer. By)170 W 6120 66504 MT (default, XON/XOFF flow control is selected. XON/XOFF should not) 293 W( be used on half-duplex \050local echo\051)292 W 6120 67700 MT (connections, or when the other system does not support it. If XON/XOFF is used, HANDSHAKE should) 48 W( be set to)49 W 6120 68896 MT (NONE.)SH ES %%Page: 81 82 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.6.10. The SET Command)SH 10 /Times-Italic AF 51775 XM (Page 81)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (SET HANDSHAKE)SH 10 /Times-Roman AF 8280 9418 MT (Syntax:)SH /Courier SF 11586 XM (SET HANDSHAKE {CODE)SH /Times-Italic SF 23586 XM (number)SH /Courier SF (, BELL, CR, LF, NONE, XOFF, XON})SH /Times-Roman SF 8280 11810 MT (Specify any half-duplex line turnaround handshake character to be) 20 W( used during file transfer on the currently selected)19 W 8280 13006 MT (port. The) 252 W( CODE)1 W /Times-Italic SF 15422 XM (number)SH /Times-Roman SF 18728 XM (form allows any ASCII character) 1 W( to be specified by its decimal ASCII code. Handshake is)2 W 8280 14202 MT (NONE by default; if set to other than) 103 W( NONE, then FLOW-CONTROL should be set to NONE. In operation the)102 W 8280 15398 MT (handshake character is sought at the end of each received packet, following the normal) 93 W( END-OF-LINE character,)94 W 8280 16594 MT (but is not sent for outgoing packets.)SH 12 /Times-Bold AF 8280 19182 MT (SET INCOMPLETE)SH 10 /Times-Roman AF 8280 20596 MT (Syntax:)SH /Courier SF 11586 XM (SET INCOMPLETE {DISCARD, KEEP})SH /Times-Roman SF 8280 22988 MT (Specifies what to do with files that arrive incompletely: discard them or keep them. They are normally discarded.)SH 12 /Times-Bold AF 8280 25576 MT (SET INPUT)SH 10 /Times-Roman AF 8280 26990 MT (Syntax:)SH /Courier SF 11586 XM (SET INPUT {CASE, DEFAULT-TIMEOUT, ECHO, TIMEOUT-ACTION})SH /Times-Roman SF 8280 29382 MT (This command is described in Section 5.8, SCRIPTS.)SH 12 /Times-Bold AF 8280 31970 MT (SET KEY)SH 10 /Times-Roman AF 8280 33384 MT (Syntax:)SH /Courier SF 11586 XM (SET KEY)SH /Times-Italic SF 16386 XM (key-specifier)SH /Courier SF 22095 XM ([)SH /Times-Italic SF (key-definition)SH /Courier SF (])SH /Times-Italic SF 8780 34580 MT (Also:)SH /Courier SF 11141 XM (SET KEY)SH /Times-Roman SF 15591 XM ({ON, OFF, CLEAR})SH /Times-Italic SF 10280 36371 MT (WARNING:)SH /Times-Roman SF 15376 XM (The format and functions of) 69 W( this command have changed substantially since version)68 W /Courier SF 50080 XM (2.29B)SH /Times-Roman SF 10280 37476 MT (and earlier. The changes were made in order to allow key redefinition to work on a wider variety of)145 W 10280 38581 MT (systems and) 136 W( keyboards without customization of the program source code for each configuration. See)135 W 10280 39686 MT (section 5.11 for further details.)SH 8280 42078 MT (Typical uses of SET KEY:)SH /Symbol SF 10070 43983 MT (\267)SH /Times-Roman SF 10780 XM (You're used) 24 W( to having the ESC key in the upper left corner of the keyboard, but your new PC keyboard)25 W 10780 45088 MT (has an accent grave \050``)36 W /Courier SF (`)SH /Times-Roman SF (''\051 there. You can use SET KEY) 36 W( to make the accent key transmit an ESC, and)35 W 10780 46193 MT (you can assign accent grave to some other key.)SH /Symbol SF 10070 48182 MT (\267)SH /Times-Roman SF 10780 XM (You send a lot of electronic mail, and always sign it the same way. You can put) 43 W( your "signature" on a)44 W 10780 49287 MT (single key to save yourself a lot of repetitive typing.)SH /Symbol SF 10070 51276 MT (\267)SH /Times-Roman SF 10780 XM (You must set up your PC's function keys or numeric keypad to work properly with a host application.)SH /Symbol SF 10070 53265 MT (\267)SH /Times-Roman SF 10780 XM (You have trouble with Kermit's 2-character escape sequences \050like Ctrl-)88 W /Courier SF (])SH /Times-Roman SF 41474 XM (C\051, and you want to assign)88 W 10780 54370 MT (these functions to single keys, like F10.)SH 8280 56161 MT (The SET KEY command) 59 W( does these things and more, and SHOW KEY gives us assistance. A key can be defined)60 W 8280 57357 MT (to:)SH /Symbol SF 10070 59262 MT (\267)SH /Times-Roman SF 10780 XM (send a single character other than what it would normally send,)SH /Symbol SF 10070 60367 MT (\267)SH /Times-Roman SF 10780 XM (send a string of multiple characters,)SH /Symbol SF 10070 61472 MT (\267)SH /Times-Roman SF 10780 XM (invoke a CONNECT-mode Kermit action verb,)SH /Symbol SF 10070 62577 MT (\267)SH /Times-Roman SF 10780 XM (send itself again.)SH 8280 64969 MT (SET KEY) 140 W( specifies that when the designated key is struck during terminal emulation, the specified character or)139 W 8280 66165 MT (string is sent or the specified Kermit action verb is performed. Key definitions operate only) 23 W( during CONNECT, not)24 W 8280 67361 MT (at)SH /Courier SF 9252 XM (Kermit-MS>)SH /Times-Roman SF 15502 XM (or DOS command level.)SH 8280 69753 MT (The key-specifier is the identification of the key) 33 W( expressed in system-dependent terms. This can be a letter, such as)32 W 8280 70949 MT (Q for the) 66 W( key which produces an uppercase Q, or the numeric ASCII value of the letter in backslash notation \050e.g.)67 W ES %%Page: 82 83 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 82)SH 12 /Times-Bold AF 28285 XM (Kermit User Guide: MS-DOS KERMIT \0505.6.10\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (``)SH /Courier SF (\13481)SH /Times-Roman SF (''\051, or else) 187 W( the numerical "scan code" observed by the system when the key is pressed \050e.g. "\1343856" for)186 W 6120 9082 MT (Ctrl-Alt-Shift-Q on an IBM PC\051. Material printed on keycaps is not) 83 W( necessarily a guide to what the key-specifier)84 W 6120 10278 MT (should be. When the word CLEAR is used in place of a key-specifier, all key definitions) 56 W( are cleared and then any)55 W 6120 11474 MT (built-in definitions are restored.)SH 6120 13866 MT (A string definition is one or more characters, including 8-bit values expressed in backslash form, such as)SH /Courier SF 8520 15583 MT (SET KEY \134315 directory\13413)SH /Times-Roman SF 26520 XM (IBM F1 key sends ``)SH /Courier SF (directory)SH /Times-Roman SF ('')SH /Courier SF 8520 16614 MT (SET KEY S X)SH /Times-Roman SF 26520 XM (S key sends upper case X \050a mean trick\051)SH /Courier SF 8520 17645 MT (SET KEY T \13427[m)SH /Times-Roman SF 26520 XM (T key sends three bytes:)SH /Courier SF 36785 XM (ESC [ m)SH 8520 18676 MT (SET KEY \13423336 {del }xxx)SH /Times-Roman SF 26520 XM (Alt-D sends ")SH /Courier SF (del)SH /Times-Roman SF 34383 XM (")SH /Courier SF 8520 19707 MT (SET KEY \134324 \134Kexit)SH /Times-Roman SF 26520 XM (F10 escapes back to)SH /Courier SF 35146 XM (Kermit-MS>)SH /Times-Roman SF 41746 XM (prompt.)SH 6120 22099 MT (The string begins with the first non-spacing character following the key identification and continues until) 26 W( the end of)27 W 6120 23295 MT (line, exclusive of any trailing spaces. If a semicolon comment is used and) 8 W( the definition is given in a TAKE file, the)7 W 6120 24491 MT (line ends at the last non-spacing) 100 W( character before the semicolon. Curly braces,)101 W /Courier SF 39115 XM ({)SH /Times-Roman SF 39965 XM (. . .)SH /Courier SF 41465 XM (})SH /Times-Roman SF (, can be use to delimit the)101 W 6120 25687 MT (string in case you want the definition to include trailing spaces. All text after the closing bracket is ignored.)SH 6120 28079 MT (This manual does not contain a list of all the scan codes for all the keys on) 179 W( all the keyboards on all the PCs)178 W 6120 29275 MT (supported by MS-Kermit -- that would be a manual in itself. Rather, in order to) 13 W( obtain the key-specifier for the SET)14 W 6120 30471 MT (KEY command, you must type a SHOW KEY command) 62 W( and then press the desired key or key combination. This)61 W 6120 31667 MT (will report a scan code that you can use as the key specifier in a SET KEY command. To do this) 17 W( for many keys is a)18 W 6120 32863 MT (laborious process, so you should collect all) 9 W( your SET KEY commands into a file, which you can TAKE, or put them)8 W 6120 34059 MT (in your)SH /Courier SF 9231 XM (MSKERMIT.INI)SH /Times-Roman SF 16681 XM (file.)SH 6120 36451 MT (If you) 52 W( enter SET KEY by itself, with no key specifier, the command will prompt you to press the selected key and)53 W 6120 37647 MT (again for the definition string. Certain characters, like ESC and CR, may not be entered literally into the) 32 W( string, but)31 W 6120 38843 MT (can be included by inserting escape codes of the form)185 W /Courier SF 29687 XM (\134nnn)SH /Times-Roman SF (, a backslash followed by a) 185 W( 1- to 4-digit number)186 W 6120 40039 MT (corresponding to the ASCII value of the) 38 W( desired character. Where an ASCII digit follows directly after a backslash)37 W 6120 41235 MT (number, confusion can be avoided by placing curly braces)191 W /Courier SF 31389 XM ({})SH /Times-Roman SF 33030 XM (around the) 191 W( backslashed number; thus,)192 W /Courier SF 49320 XM (\134{27}5)SH /Times-Roman SF 6120 42431 MT (represents the two ASCII characters ESC and 5.)SH 6120 44823 MT (Here is an example of the use of SET KEY to assign ESC \050ASCII 27\051 to the) 6 W( accent grave key. First the user gets the)5 W 6120 46019 MT (key-specifier for the key:)SH /Courier SF 8520 47674 MT (Kermit-MS>show key)SH 4800 50 14520 47874 UL 9720 48705 MT (Push key to be shown \050? shows all\051: `)SH 600 50 31320 48905 UL 9720 49736 MT (ASCII char: ` \13496 decimal is defined as)SH 9720 50767 MT (Self, no translation.)SH 8520 51798 MT (Free space: 129 key and 100 string definitions, 837 string characters.)SH /Times-Roman SF 6120 53515 MT (The free space report says that 129 more keys may be redefined, and up to) 75 W( 100 of them may have multi-character)76 W 6120 54711 MT (strings assigned to them \050as opposed to single characters\051, and that there are 837 bytes left for these) 28 W( strings, in total.)27 W 6120 55907 MT (Confident that there is enough space left for a new key definition, the user proceeds:)SH /Courier SF 8520 57562 MT (Kermit-MS>set key)SH 4200 50 14520 57762 UL 9720 58593 MT (Push key to be defined: `)SH 600 50 24120 58793 UL 9720 59624 MT (Enter new definition: \13427)SH 1800 50 22920 59824 UL /Times-Roman SF 6120 62016 MT (Once a key definition is constructed and tested, it may be entered on a single line in a command) 160 W( file \050such as)161 W /Courier SF 6120 63212 MT (MSKERMIT.INI)SH /Times-Roman SF (\051:)SH /Courier SF 8520 64867 MT (set key \13496 \13427)SH /Times-Roman SF 6120 66584 MT (To prevent accidents, SET KEY) 20 W( shows the current definition before asking for a new one; enter a Control-C to keep)19 W 6120 67780 MT (the current definition, or a carriage return to undefine the key, or a query mark)SH /Courier SF 37750 XM (\050?\051)SH /Times-Roman SF 39800 XM (to see available choices.)SH 6120 70172 MT (The keyboard can) 47 W( be restored to its startup state, that is all redefinitions removed and all built-in defitions restored,)48 W 6120 71368 MT (by using the keyword CLEAR in place of the key identification:)SH ES %%Page: 83 84 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.6.10. The SET Command)SH 10 /Times-Italic AF 51775 XM (Page 83)SH 46800 50 8280 5709 UL /Courier SF 10680 7824 MT (SET KEY CLEAR)SH /Times-Roman SF 8280 9541 MT (Undefined keys which do not send ASCII characters are trapped by the keyboard translator and are rejected; a) 36 W( beep)35 W 8280 10737 MT (results from using an undefined non-ASCII key.)SH 8280 13129 MT (SET KEY) 169 W( OFF directs MS-Kermit to read keycodes from DOS, rather than BIOS, so that console drivers like)170 W /Courier SF 8280 14325 MT (ANSI.SYS)SH /Times-Roman SF 13379 XM (that operate at the DOS level may be used during Kermit CONNECT sessions. This would also apply)48 W 8280 15521 MT (to any) 76 W( special keyboard replacements that come with DOS-level drivers. SET KEY ON turns key definition back)77 W 8280 16717 MT (on, and returns Kermit to processing keystrokes at the BIOS level.)SH 12 /Times-Bold AF 8280 19305 MT (Kermit Action Verbs)SH 10 /Times-Roman AF 8280 20719 MT (An action verb is the shorthand expression for a named Kermit procedure, such as "generate) 15 W( the proper sequence for)14 W 8280 21915 MT (a left arrow," "show status," "send a) 32 W( BREAK," and others; verbs are complex actions and each verb has a name. In)33 W 8280 23111 MT (a key definition the verb name is preceeded by backslash K \050)48 W /Courier SF (\134K)SH /Times-Roman SF (\051 to avoid being confused with a string. Verbs and)47 W 8280 24307 MT (strings cannot be used together on a key.)SH /Courier SF 10680 25962 MT (SET KEY \134331 \134Klfarr)SH 10680 26993 MT (SET KEY \1342349 \134Kexit)SH /Times-Roman SF 8280 28710 MT (makes the IBM keyboard left arrow key execute the verb named)5 W /Courier SF 34300 XM (lfarr)SH /Times-Roman SF 37555 XM (which sends the proper escape sequence) 5 W( for)6 W 8280 29906 MT (a VT102 left arrow key \050which changes) 2 W( depending on the internal state of the VT102\051. The leading)1 W /Courier SF 48434 XM (\134K)SH /Times-Roman SF 49885 XM (identifies the)1 W 8280 31102 MT (definition as a Kermit verb, so no string can start as)47 W /Courier SF 29683 XM (\134K)SH /Times-Roman SF 31180 XM (or as)47 W /Courier SF 33440 XM (\134{K)SH /Times-Roman SF 35537 XM (in upper or lower case \050use)47 W /Courier SF 46871 XM (\13492K)SH /Times-Roman SF (\051. The) 346 W( second)48 W 8280 32298 MT (example has Alt-X invoking the) 10 W( Leave-Connect-Mode verb "exit" \050same as Kermit escape character ``)9 W /Courier SF (^])SH /Times-Roman SF ('' followed)9 W 8280 33494 MT (by C\051.)SH 8280 35886 MT (Each system has its own list of verbs and predefined keys. Table 5-6) 38 W( shows those available for the IBM PC family)39 W 8280 37082 MT (\050there are also some additional verbs for reassigning Heath) 64 W( or VT100 function keys, see section 5.16.2\051. The SET)63 W 8280 38278 MT (KEY command shows the list of available verbs when a query mark)110 W /Courier SF 37095 XM (\050?\051)SH /Times-Roman SF 39255 XM (is given as a definition. SHOW) 110 W( KEY)111 W 8280 39474 MT (displays all currently defined keys or individually selected ones; SHOW KEY can be executed only interactively.)SH 8280 41866 MT (Some systems have preset key definitions when Kermit first begins \050those for the IBM PC are shown in) 125 W( section)124 W 8280 43062 MT (5.16.2\051. You) 282 W( can find out what they are on your system by typing) 16 W( SHOW KEY, and then question mark on the next)17 W 8280 44258 MT (line. You) 600 W( may supplement or change the predefined keys with SET KEY commands typed interactively) 175 W( or in)174 W /Courier SF 8280 45454 MT (MSKERMIT.INI)SH /Times-Roman SF 15730 XM (or other command files.)SH 8280 47846 MT (The MS-Kermit) 98 W( CONNECT command may be used in conjunction with certain console drivers that do their own)99 W 8280 49042 MT (key redefinitions. Since) 22 W( MS-Kermit intercepts keystrokes at the BIOS level, drivers like)21 W /Courier SF 44246 XM (ANSI.SYS)SH /Times-Roman SF 49317 XM (which work at)21 W 8280 50238 MT (the DOS level will have no effect during CONNECT,) 35 W( even though they work at MS-Kermit command level. Other)36 W 8280 51434 MT (drivers, like SuperKey and ProKey,) 45 W( work at the BIOS level, and their key assignments will remain effective during)44 W 8280 52630 MT (Kermit terminal sessions, and additional Kermit SET KEY assignments may be made "on top" of them.)SH 12 /Times-Bold AF 8280 55218 MT (SET LOCAL-ECHO)SH 10 /Times-Roman AF 8280 56632 MT (Syntax:)SH /Courier SF 11586 XM (SET LOCAL-ECHO {ON, OFF})SH /Times-Roman SF 8280 59024 MT (Specify how characters are echoed during terminal emulation on) 163 W( the currently selected port. ON specifies that)164 W 8280 60220 MT (characters are) 68 W( to be echoed by Kermit-MS \050because neither the remote computer nor the communications circuitry)67 W 8280 61416 MT (has been requested to echo\051, and is appropriate for half-duplex connections. LOCAL-ECHO is OFF by default,) 41 W( for)42 W 8280 62612 MT (full-duplex, remote echo operation.)SH ES %%Page: 84 85 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 84)SH 12 /Times-Bold AF 28285 XM (Kermit User Guide: MS-DOS KERMIT \0505.6.10\051)SH 46800 50 6120 5709 UL 46800 50 6120 8086 UL 10 /Times-Roman AF 7120 11001 MT (Verb)SH 17920 XM (Meaning)SH 1999 50 7120 11201 UL 3555 50 17920 11201 UL 7120 12106 MT (\134Kupscn)SH 17920 XM (Roll up \050back\051 to previous screen)SH 7120 13211 MT (\134Kdnscn)SH 17920 XM (Roll down \050forward\051 to next screen)SH 7120 14316 MT (\134Khomscn)SH 17920 XM (Roll up to top of screen memory)SH 7120 15421 MT (\134Kendscn)SH 17920 XM (Roll down to end of screen memory \050current position\051)SH 7120 16526 MT (\134Kupone)SH 17920 XM (Roll screen up one line)SH 7120 17631 MT (\134Kdnone)SH 17920 XM (Roll screen down one line)SH 7120 18736 MT (\134Kprtscn)SH 17920 XM (Print the current screen)SH 7120 19841 MT (\134Kdump)SH 17920 XM (Append the current screen to dump file)SH 7120 20946 MT (\134Kholdscrn)SH 17920 XM (Toggle hold screen mode)SH 7120 22051 MT (\134Klogoff)SH 17920 XM (Turn off session logging)SH 7120 23156 MT (\134Klogon)SH 17920 XM (Turn on session logging)SH 7120 24261 MT (\134Ktermtype)SH 17920 XM (Toggle terminal type)SH 7120 25366 MT (\134Kreset)SH 17920 XM (Reset terminal emulator to initial state)SH 7120 26471 MT (\134Kmodeline)SH 17920 XM (Toggle modeline off/on)SH 7120 27576 MT (\134Kbreak)SH 17920 XM (Send a BREAK signal)SH 7120 28681 MT (\134Klbreak)SH 17920 XM (Send a "long BREAK" signal)SH 7120 29786 MT (\134Khangup)SH 17920 XM (Drop DTR so modem will hang up phone)SH 7120 30891 MT (\134Knull)SH 17920 XM (Send a null \050ASCII 0\051)SH 7120 31996 MT (\134Kdos)SH 17920 XM ("Push" to DOS)SH 7120 33101 MT (\134Khelp)SH 17920 XM (Display CONNECT help message)SH 7120 34206 MT (\134Kstatus)SH 17920 XM (Display STATUS message)SH 7120 35311 MT (\134Kexit)SH 17920 XM (Escape back from CONNECT mode)SH 7120 36416 MT (\134Kgold,\134Kpf1)SH 17920 XM (VT102 keypad function key PF1)SH 7120 37521 MT (\134Kpf2..\134Kpf4)SH 17920 XM (VT102 keypad function keys)SH 7120 38626 MT (\134Kkp0..\134Kkp9)SH 17920 XM (VT102 keypad numeric keys)SH 7120 39731 MT (\134Kkpdot,\134Kkpminus,\134Kkpcoma,\134Kkpenter Other) 500 W( VT102 keypad keys)SH 7120 40836 MT (\134Kuparr,\134Kdnarr,\134Klfarr,\134Krtarr VT102) 500 W( cursor \050arrow\051 keys)SH /Times-Bold SF 18673 42627 MT (Table 5-6:)SH /Times-Roman SF 23534 XM (Kermit-MS Verbs for the IBM PC Family)SH 46800 50 6120 44437 UL 12 /Times-Bold AF 6120 46825 MT (SET MODE-LINE)SH 10 /Times-Roman AF 6120 48239 MT (Syntax:)SH /Courier SF 9426 XM (SET MODE-LINE {ON, OFF})SH /Times-Roman SF 6120 50631 MT (On systems, like the IBM PC family, which are capable of displaying a status, or "mode" line on the) 162 W( 25th \050or)161 W 6120 51827 MT (bottom\051 line during terminal connection, disable or enable this function. This command has no) 88 W( effect on systems)89 W 6120 53023 MT (that do not display a mode line during connect.)SH 6120 55415 MT (The mode line) 76 W( shows several important facts about the connection, like which port is being used, the transmission)75 W 6120 56611 MT (speed and parity, the current escape character, etc. When the) 1 W( mode line is enabled, it may be turned on and off using)2 W 6120 57807 MT (the CONNECT escape-level command M or the Kermit verb "modeline".)SH 6120 60199 MT (The mode line occupies the 25th line of) 84 W( those systems that have such a thing, and is not affected by scrolling \050on)83 W 6120 61395 MT (some systems that have large screens, the mode line should appear on whatever the bottom) 89 W( line is, e.g. the 43rd\051.)90 W 6120 62591 MT (When emulating a VT102 or Heath-19, Kermit will allow the host to) 130 W( address the 25th line directly using cursor)129 W 6120 63787 MT (positioning commands. If this happens, Kermit will remove) 46 W( its mode line and relinquish control of the 25th line to)47 W 6120 64983 MT (the host \050as if you had typed SET MODE OFF\051. When the Tektronix, or no terminal at all,) 62 W( is being emulated, the)61 W 6120 66179 MT (25th line \050if any\051 is available for scrolling. If) 60 W( the mode line is disabled by an application or by the command SET)61 W 6120 67375 MT (MODE OFF then the only way to revive Kermit's mode line display is to give the command SET MODE ON.)SH ES %%Page: 85 86 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.6.10. The SET Command)SH 10 /Times-Italic AF 51775 XM (Page 85)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (SET PARITY)SH 10 /Times-Roman AF 8280 9418 MT (Syntax:)SH /Courier SF 11586 XM (SET PARITY {EVEN, ODD, MARK, SPACE, NONE})SH /Times-Roman SF 8280 11810 MT (Specify the character parity to be used on the currently selected) 127 W( port. You will need to SET PARITY to ODD,)126 W 8280 13006 MT (EVEN, MARK, or possibly SPACE when communicating with a system, or over a network, or through) 97 W( modems,)98 W 8280 14202 MT (concentrators, multiplexers, or front ends that) 105 W( require or impose character parity on the communication line. For)104 W 8280 15398 MT (instance, most IBM mainframe) 9 W( computers use EVEN or MARK parity; Telenet normally uses MARK parity. If you)10 W 8280 16594 MT (neglect to SET PARITY) 221 W( when the communications equipment requires it, the symptom may be that terminal)220 W 8280 17790 MT (emulation works \050well or maybe only partially\051, but file transfer or script INPUT commands do not work at all.)SH 8280 20182 MT (NONE means that no parity processing is done, and the 8th bit of each character can) 200 W( be used for data when)201 W 8280 21378 MT (transmitting binary files. This is the normal case. If parity is other than none, then) 42 W( there will be 7 data bits \050use of)41 W 8280 22574 MT (parity with 8 data bits is not supported\051.)SH 8280 24966 MT (If you have set parity to ODD, EVEN, MARK, or SPACE, then Kermit-MS will) 208 W( request that binary files be)209 W 8280 26162 MT (transferred using 8th-bit-prefixing. If) 9 W( the other Kermit knows how to do 8th-bit-prefixing \050this is an optional feature)8 W 8280 27358 MT (of the Kermit protocol, and some implementations of) 4 W( Kermit don't have it\051, then 8-bit binary files can be transmitted)5 W 8280 28554 MT (successfully. If) 284 W( NONE) 17 W( is specified, 8th-bit-prefixing will not be requested. Note that there is no advantage to using)16 W 8280 29750 MT (parity. It) 358 W( reduces Kermit's file transfer efficiency without providing additional error detection. The SET PARITY)54 W 8280 30946 MT (command is provided only to allow Kermit to adapt to conditions where parity) 65 W( is required, or 8-bit transmission is)64 W 8280 32142 MT (otherwise thwarted.)SH 8280 34534 MT (If parity is in use, then the display) 23 W( during terminal emulation, as well as any session log, will be 7-bit ASCII, unless)24 W 8280 35730 MT (you have SET DEBUG ON \050q.v.\051.)SH 8280 38122 MT (There may be situations in which you require 7-bit ASCII with no parity during terminal emulation, but) 19 W( still want to)18 W 8280 39318 MT (force 8th bit prefixing during file transfer. To accomplish this, SET PARITY SPACE.)SH 8280 41710 MT (The INPUT and TRANSMIT commands use) 206 W( 7 or 8 bits if parity is NONE, according to the SET DISPLAY)207 W 8280 42906 MT (command, and this may upset recognition of received characters when the host unexpectedly) 108 W( sends them with its)107 W 8280 44102 MT (own parity.)SH 12 /Times-Bold AF 8280 46690 MT (SET PORT)SH 10 /Times-Roman AF 8280 48104 MT (Syntax:)SH /Courier SF 11586 XM (SET PORT {)SH /Times-Italic SF (number)SH /Courier SF (, COM)SH /Times-Italic SF (n)SH /Courier SF (, BIOS)SH /Times-Italic SF (n)SH /Courier SF (, NET [)SH /Times-Italic SF (nodename)SH /Courier SF (], UB-NET1 [)SH /Times-Italic SF (nodename)SH /Courier SF (]})SH /Times-Roman SF 8280 50496 MT (On machines with more than one communications port, select the port to use for file transfer) 32 W( and CONNECT. This)33 W 8280 51692 MT (command lets you use a different asynchronous adapter, or switch between two) 206 W( or more simultaneous remote)205 W 8280 52888 MT (sessions. Subsequent) 278 W( SET SPEED,) 14 W( PARITY, HANDSHAKE, FLOW, and LOCAL-ECHO commands will apply to)15 W 8280 54084 MT (this port only -- each port remembers its own parameters,) 84 W( so that you may set them for each port and then switch)83 W 8280 55280 MT (between ports conveniently with the SET PORT command.)SH 8280 57672 MT (SET PORT 1 selects COM1, SET PORT 2 selects COM2. All versions) 47 W( default to port 1, except for the IBM PCjr,)48 W 8280 58868 MT (which uses port 2 if its internal modem is installed. Additionally, COM3 and COM4 are supported) 199 W( for IBM)198 W 8280 60064 MT (PC/AT's and PS/2's, as explained in Section 5.17.3.)SH 8280 62456 MT (SET PORT BIOS)61 W /Times-Italic SF (n)SH /Times-Roman SF (, on machines which support it, instructs Kermit to do serial port input and output by) 61 W( Bios calls)62 W 8280 63652 MT (rather than going directly to the hardware \050)163 W /Times-Italic SF (n)SH /Times-Roman SF 27524 XM (is a digit between 1 and 4\051.) 163 W( The) 575 W( most important use is allowing)162 W 8280 64848 MT (selected network packages to intercept such Bios calls and relay the characters across the network.)SH 8280 67240 MT (In "generic" MS-DOS Kermit, the following alternate forms allow you to experiment with device names or) 15 W( numbers)16 W 8280 68436 MT (until you find the communication port:)SH /Courier SF 10680 70091 MT (SET PORT {DEVICE, FILE-HANDLE})SH /Times-Roman SF 8280 71808 MT (Just type a carriage) 21 W( return after either of these commands, and you will be prompted for a device name or a numeric)20 W ES %%Page: 86 87 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 86)SH 12 /Times-Bold AF 28285 XM (Kermit User Guide: MS-DOS KERMIT \0505.6.10\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (port-handle. Keep) 308 W( trying till you find one that works. File-handle 3, the system) 29 W( auxillary device, is conventional on)30 W 6120 9082 MT (many machines, as are device names COM1, COM2, and AUX.)SH 6120 11474 MT (MS-Kermit for the IBM PC family is able to operate) 46 W( over local area networks through the NetBIOS interface. The)45 W 6120 12670 MT (command)SH /Courier SF 8520 14385 MT (SET PORT NET [)SH /Times-Italic SF (nodename)SH /Courier SF (])SH /Times-Roman SF 6120 16102 MT (redirects communications the LAN board installed) 180 W( in the local computer and the associated NetBIOS emulator)181 W 6120 17298 MT (software, if active, rather than the serial port or the COM device driver. It installs a) 8 W( unique Kermit node name in the)7 W 6120 18494 MT (local LAN, so that other nodes can refer) 26 W( to it when files are transferred or terminal emulation is done. This name is)27 W 6120 19690 MT (displayed when you give the SET PORT NET command. The server) 91 W( should use SET PORT NET, and the client)90 W 6120 20886 MT (should use SET PORT NAME)79 W /Times-Italic SF 19043 XM (nodename)SH /Times-Roman SF (, specifying the server's name, e.g.)80 W /Courier SF 37796 XM (mskermit.K)SH /Times-Roman SF (. Note) 410 W( that alphabetic)80 W 6120 22082 MT (case is significant in node names!)SH 6120 24474 MT (Both the regular serial port and a network connection can be kept alive) 2 W( simultaneously; clearly, only one can be used)1 W 6120 25670 MT (at a time under MS-DOS. MS-DOS 3.x is not required) 10 W( for Kermit network usage, but most LANS do need DOS 3.1)11 W 6120 26866 MT (or later for conventional file server work. Kermit needs only the NetBIOS emulator network software.)SH 6120 29258 MT (SET PORT UB-NET1 is implemented on the IBM PC version of Kermit to allow connection) 85 W( to Ungermann-Bass)84 W 6120 30454 MT (Net One LAN NETCI interface and behaves similarly to the NetBIOS method.)SH 12 /Times-Bold AF 6120 33042 MT (SET PROMPT)SH 10 /Times-Roman AF 6120 34456 MT (Syntax:)SH /Courier SF 9426 XM (SET PROMPT [)SH /Times-Italic SF (string)SH /Courier SF (])SH /Times-Roman SF 6120 36848 MT (This command allows you to change the MS-DOS Kermit program's prompt.) 52 W( The) 356 W( string may be enclosed in curly)53 W 6120 38044 MT (braces. Control) 312 W( characters like) 31 W( ESC can be included as backslashed numbers like ``)30 W /Courier SF (\13427)SH /Times-Roman SF (''.)SH /Courier SF 43338 XM (ANSI.SYS)SH /Times-Roman SF 48418 XM (and similar)30 W 6120 39240 MT (console drivers can be programmed through this command to get a boldface, inverse, and/or blinking prompt. The)54 W 6120 40436 MT (prompt string must be less than 128 characters. If the string is omitted \050missing\051) 176 W( Kermit's original prompt of)175 W 6120 41632 MT (``)SH /Courier SF (Kermit-MS>)SH /Times-Roman SF ('' is restored.)SH 12 /Times-Bold AF 6120 44220 MT (SET RECEIVE)SH 10 /Times-Roman AF 6120 45634 MT (Syntax:)SH /Courier SF 9426 XM (SET RECEIVE)SH /Times-Italic SF 16626 XM (parameter value)350 W /Times-Roman SF 6120 48026 MT (This command lets you modify the ways in which MS-Kermit asks) 48 W( the other Kermit to behave. That is, it controls)49 W 6120 49222 MT (the file transfer protocol options for packets sent) 11 W( to MS-Kermit by the other Kermit. The parameters and values you)10 W 6120 50418 MT (specify in the SET RECEIVE command are sent to the other Kermit during initial negotiations. Numbers may be)74 W 6120 51614 MT (specified as ordinary decimal numbers \05074\051, or in backslash notation \050\134x03F\051.)SH /Courier SF 6120 53403 MT (END-OF-LINE)SH /Times-Italic SF 13320 XM (number)SH /Times-Roman SF 10120 54508 MT (The ASCII value of terminating) 6 W( character to look for on incoming packets. Normally carriage return. Use)7 W 10120 55613 MT (this command if the other Kermit is terminating its packets with some other control character.)SH /Courier SF 6120 57190 MT (PACKET-LENGTH)SH /Times-Italic SF 14520 XM (number)SH /Times-Roman SF 10120 58295 MT (Ask the remote Kermit to use the specified maximum length for packets that it sends to Kermit-MS.) 40 W( The)331 W 10120 59400 MT (normal length is 94 bytes. Use this command to shorten packets if the communication line is noisy or)114 W 10120 60505 MT (terminal buffers somewhere along the path are too small. Shorter packets decrease the) 66 W( probability that a)67 W 10120 61610 MT (particular packet will be corrupted, and will reduce the retransmission overhead when corruption occurs,)73 W 10120 62715 MT (but will increase the file transfer throughput.)SH 10120 64292 MT (If a length greater than 94 is specified, a protocol option called "long packets" will be used, provided) 55 W( the)56 W 10120 65397 MT (other Kermit also supports it. Kermit-MS can receive extended-length packets up) 141 W( to 1000 bytes long.)140 W 10120 66502 MT (Long Packets can improve efficiency by reducing the per-packet overhead for a file, but they will not be)64 W 10120 67607 MT (used unless you issue this command. Before using this option, ensure that the) 276 W( equipment on the)275 W 10120 68712 MT (communications pathway can absorb a long packet, and that the connection is clean \050retransmission) 131 W( of)132 W 10120 69817 MT (long packets is expensive!\051.) 223 W( You) 695 W( should also SET BLOCK-CHECK 2 or 3 for more reliable error)222 W 10120 70922 MT (checking.)SH ES %%Page: 87 88 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.6.10. The SET Command)SH 10 /Times-Italic AF 51775 XM (Page 87)SH 46800 50 8280 5709 UL /Courier SF 8280 7884 MT (PADCHAR)SH /Times-Italic SF 13080 XM (number)SH /Times-Roman SF 12280 8989 MT (Ask the remote Kermit to use the given control) 7 W( character \050expressed as a decimal number 0-31, or 127\051 for)6 W 12280 10094 MT (interpacket padding. Kermit-MS should never require any padding.)SH /Courier SF 8280 11671 MT (PADDING)SH /Times-Italic SF 13080 XM (number)SH /Times-Roman SF 12280 12776 MT (Ask the remote Kermit to insert the) 171 W( given number of padding characters before each packet it sends.)170 W 12280 13881 MT (MS-Kermit never needs padding, but this mechanism might be) 288 W( required to keep some intervening)289 W 12280 14986 MT (communication equipment happy.)SH /Courier SF 8280 16563 MT (START-OF-PACKET)SH /Times-Italic SF 17880 XM (number)SH /Times-Roman SF 12280 17668 MT (If the) 244 W( remote Kermit will be marking the beginning of packets with a control character other than)245 W 12280 18773 MT (Control-A, use this command to tell Kermit-MS) 56 W( about it \050the number should be the decimal ASCII value)55 W 12280 19878 MT (of a control character\051. This will) 114 W( be necessary only if the hosts or communication equipment involved)115 W 12280 20983 MT (cannot pass a Control-A through as data, or if some piece of communication equipment is echoing) 14 W( packets)13 W 12280 22088 MT (back at you.)SH /Courier SF 8280 23665 MT (TIMEOUT)SH /Times-Italic SF 13080 XM (number)SH /Times-Roman SF 12280 24770 MT (Ask the remote Kermit) 55 W( to time out and retransmit after the given number of seconds if a packet expected)54 W 12280 25875 MT (from Kermit-MS has not arrived. Use this command to change the other Kermit's) 235 W( normal timeout)236 W 12280 26980 MT (interval.)SH 12 /Times-Bold AF 8280 29568 MT (SET REMOTE)SH 10 /Times-Roman AF 8280 30982 MT (Syntax:)SH /Courier SF 11586 XM (SET REMOTE {ON, OFF})SH /Times-Roman SF 8280 33374 MT (SET REMOTE ON removes the file transfer display \050as if you had given the command SET DISPLAY) 28 W( QUIET\051. It)27 W 8280 34570 MT (should be used when you are running Kermit-MS) 112 W( in remote mode when coming in from another PC through the)113 W 8280 35766 MT (Kermit-MS's "back port", to which the console has been reassigned using the DOS CTTY command, e.g.)SH /Courier SF 10680 37421 MT (CTTY COM1)SH /Times-Roman SF 8280 39138 MT (It is necessary to issue the SET REMOTE) 103 W( ON command because \050a\051 Kermit-MS has no way of knowing that its)102 W 8280 40334 MT (console has been redirected, and \050b\051 when the console is the same as the port, the file transfer display) 46 W( will interfere)47 W 8280 41530 MT (with the file transfer itself.) 14 W( SET) 276 W( REMOTE OFF returns the file transfer display to its preferred style \050REGULAR or)13 W 8280 42726 MT (SERIAL\051. When) 322 W( you SET REMOTE ON, you might also want) 36 W( to SET DELAY 5 or thereabouts, to allow yourself)37 W 8280 43922 MT (time to escape back to the local system before MS-Kermit starts sending packets.)SH 8280 46314 MT (On the IBM PC, CTTY CON returns control to the) 5 W( normal keyboard and screen \050other systems may use other device)4 W 8280 47510 MT (names\051. See) 250 W( section 5.17.4 for further details about remote operation.)SH /Times-Italic SF 8280 49902 MT (WARNING)SH /Times-Roman SF (: During CTTY console redirection, many programs still output to the real screen) 38 W( and require input from)39 W 8280 51098 MT (the real keyboard and will hang the system until keyboard requests are satisfied.)SH 12 /Times-Bold AF 8280 53686 MT (SET RETRY)SH 10 /Times-Roman AF 8280 55100 MT (Syntax:)SH /Courier SF 11586 XM (SET RETRY)SH /Times-Italic SF 17586 XM (number)SH /Times-Roman SF 8280 57492 MT (Sets the number of times a packet is retransmitted before the protocol gives up.) 156 W( The) 561 W( number of retries can be)155 W 8280 58688 MT (between 1 and 63, and is 5 by default.) 10 W( This) 272 W( is an especially useful parameter when the communications line is noisy)11 W 8280 59884 MT (or the remote) 65 W( host is very busy. The initial packet of a file exchange is given three times as many retries to allow)64 W 8280 61080 MT (both systems to become ready.)SH 12 /Times-Bold AF 8280 63668 MT (SET SEND)SH 10 /Times-Roman AF 8280 65082 MT (Syntax:)SH /Courier SF 11586 XM (SET SEND)SH /Times-Italic SF 16986 XM (parameter value)350 W /Times-Roman SF 8280 67474 MT (The SET SEND command is used primarily) 14 W( to override negotiated protocol options, or to establish them before they)15 W 8280 68670 MT (are negotiated.)SH ES %%Page: 88 89 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 88)SH 12 /Times-Bold AF 28285 XM (Kermit User Guide: MS-DOS KERMIT \0505.6.10\051)SH 46800 50 6120 5709 UL 10 /Courier AF 6120 7884 MT (END-OF-LINE)SH /Times-Italic SF 13320 XM (number)SH /Times-Roman SF 10120 8989 MT (ASCII value of packet terminator to put on outbound) 227 W( packets. Normally carriage return. Use this)228 W 10120 10094 MT (command if the other Kermit needs its packets terminated with a nonstandard control character.)SH /Courier SF 6120 11671 MT (PACKET-LENGTH)SH /Times-Italic SF 14520 XM (number)SH /Times-Roman SF 10120 12776 MT (Use this as the maximum length for outbound packets, regardless of what) 182 W( the other Kermit asks for.)183 W 10120 13881 MT (Normally, you would use this command only) 182 W( to send shorter packets than the other Kermit requests,)181 W 10120 14986 MT (because you know something) 34 W( the other Kermit doesn't know, e.g. there's a device on the communication)35 W 10120 16091 MT (path with small buffers.)SH /Courier SF 6120 17668 MT (PADCHAR)SH /Times-Italic SF 10920 XM (number)SH /Times-Roman SF 10120 18773 MT (Use the specified control character for interpacket padding.) 222 W( Some) 695 W( hosts may require some padding)223 W 10120 19878 MT (characters \050normally NUL or DEL\051 before a packet, and) 231 W( certain front ends or other communication)230 W 10120 20983 MT (equipment may need certain control characters to put them in) 52 W( the right modes. The number is the ASCII)53 W 10120 22088 MT (decimal value of the padding character, \0500 - 31, or 127\051.)SH /Courier SF 6120 23665 MT (PADDING)SH /Times-Italic SF 10920 XM (number)SH /Times-Roman SF 10120 24770 MT (How many copies of the pad character to send before each packet, normally zero.)SH /Courier SF 6120 26347 MT (PAUSE)SH /Times-Italic SF 9720 XM (number)SH /Times-Roman SF 10120 27452 MT (How many milliseconds to pause before sending each packet, 0-127, normally zero. This may) 202 W( help)201 W 10120 28557 MT (half-duplex or slow systems prepare for reception of our) 8 W( packet. Padding characters are sent only after the)9 W 10120 29662 MT (time limit expires.)SH /Courier SF 6120 31239 MT (QUOTE)SH /Times-Italic SF 9720 XM (number)SH /Times-Roman SF 10120 32344 MT (Use the indicated) 19 W( printable character for prefixing \050quoting\051 control characters and other prefix characters.)20 W 10120 33449 MT (The only reason to change this would be for sending a very) 194 W( long file that contains very many ``)193 W /Courier SF (#)SH /Times-Roman SF ('')SH 10120 34554 MT (characters \050the normal control prefix\051 as data.)SH /Courier SF 6120 36131 MT (START-OF-PACKET)SH /Times-Italic SF 15720 XM (number)SH /Times-Roman SF 10120 37236 MT (Mark the beginning of outbound packets with some control) 63 W( character other than Control-A. This will be)62 W 10120 38341 MT (necessary if the remote host or the communication) 145 W( channel cannot accept a Control-A as data, or if it)146 W 10120 39446 MT (echoes back your packets. The remote host must have been given the corresponding SET) 165 W( RECEIVE)164 W 10120 40551 MT (START-OF-PACKET command.)SH /Courier SF 6120 42128 MT (TIMEOUT)SH /Times-Italic SF 10920 XM (number)SH /Times-Roman SF 10120 43233 MT (Change Kermit-MS's normal timeout interval; this command) 7 W( is effective only if TIMER is set to be ON; it)6 W 10120 44338 MT (is normally ON, with a default interval of 13 seconds.)SH 12 /Times-Bold AF 6120 46926 MT (SET SPEED)SH 10 /Times-Roman AF 6120 48340 MT (Syntax:)SH /Courier SF 9426 XM (SET SPEED)SH /Times-Italic SF 15426 XM (rate)SH /Times-Roman SF 6120 50732 MT (Set the transmission speed \050in bits per) 342 W( second, commonly called)343 W /Times-Italic SF 35403 XM (baud)SH /Times-Roman SF (\051 of the currently selected terminal)343 W 6120 51928 MT (communications port to 300, 1200, 1800, 2400, 4800, 9600, or other common speed, and on the IBM PC family,)97 W 6120 53124 MT (higher speeds including 19200, 38400, 57600, and 115200. Both connected) 128 W( systems, as well as any intervening)129 W 6120 54320 MT (communication equipment, must be able to support the) 16 W( specified transmission speed, and both systems should be set)15 W 6120 55516 MT (to the same speed.)SH 6120 57908 MT (Some implementations do not support the SET SPEED command. But Kermit-MS leaves) 444 W( the current)445 W 6120 59104 MT (communication port settings alone unless you issue explicit SET commands to change them, so you may use MODE)8 W 6120 60300 MT (or other DOS programs to establish the desired settings before running Kermit.)SH 6120 62692 MT (On certain systems, when you first run Kermit after powering the system up, you may get) 19 W( a message "Unrecognized)20 W 6120 63888 MT (baud rate". This means that Kermit tried to read the baud rate from the port and none was set.) 96 W( Simply) 440 W( use SET)95 W 6120 65084 MT (SPEED \050if available\051 or the DOS MODE command to set the desired baud rate.)SH 6120 67476 MT (SET BAUD is a synonym for SET SPEED.)SH ES %%Page: 89 90 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.6.10. The SET Command)SH 10 /Times-Italic AF 51775 XM (Page 89)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (SET TAKE-ECHO)SH 10 /Times-Roman AF 8280 9418 MT (Syntax:)SH /Courier SF 11586 XM (SET TAKE-ECHO {ON, OFF})SH /Times-Roman SF 8280 11810 MT (Specifies whether screen display should occur during implicit or explicit TAKE operations) 47 W( on)48 W /Courier SF 46749 XM (MSKERMIT.INI)SH /Times-Roman SF 54247 XM (or)SH 8280 13006 MT (other Kermit-MS command files, and during evaluation of) 169 W( macro definitions by the DO command. Handy for)168 W 8280 14202 MT (finding errors in TAKE files or macro definitions.)SH 12 /Times-Bold AF 8280 16790 MT (SET TERMINAL)SH 10 /Times-Roman AF 8280 18204 MT (Syntax:)SH /Courier SF 11586 XM (SET TERMINAL {)SH /Times-Italic SF (type)SH /Courier SF (,)SH /Times-Italic SF 22852 XM (parameter)SH /Courier SF 27618 XM ([)SH /Times-Italic SF (value)SH /Courier SF (]})SH /Times-Roman SF 8280 20596 MT (This command controls most aspects of terminal emulation.) 305 W( Most) 862 W( of the parameters are only settable \050or)306 W 8280 21792 MT (meaningful\051 on the IBM PC family and compatibles.) 56 W( \050Programmers) 361 W( who are proficient on other MS-DOS systems)55 W 8280 22988 MT (are invited) 92 W( to fill in these functions for those systems and send the results back to Columbia.\051 On other systems,)93 W 8280 24184 MT (built-in setup modes or DOS commands can be used to accomplish the same functions.)SH 8280 26576 MT (The first group of parameters tells which kind of terminal to emulate. When Kermit-MS uses its built-in software)71 W 8280 27772 MT (for emulation, incoming characters) 91 W( are examined for screen control commands \050escape sequences\051 specific to that)92 W 8280 28968 MT (terminal, and if encountered, the commands are executed on the PC screen.)SH /Courier SF 8280 30759 MT (NONE)SH /Times-Roman SF 12280 XM (Act as a dumb terminal. All incoming) 28 W( characters will be sent to the screen "bare", as-is, through DOS. If)27 W 12280 31864 MT (you have loaded a device driver into DOS for the)6 W /Courier SF 32281 XM (CON)SH /Times-Roman SF 34338 XM (device, such as)7 W /Courier SF 40635 XM (ANSI.SYS)SH /Times-Roman SF (, then that driver will be)7 W 12280 32969 MT (able to interpret the codes itself. Many non-IBM systems have) 70 W( their own screen control code interpreter)69 W 12280 34074 MT (built into DOS or firmware, or available as a loadable device driver.)SH /Courier SF 8280 35651 MT (VT52)SH /Times-Roman SF 12280 XM (The DEC VT-52 terminal.)SH /Courier SF 8280 37228 MT (HEATH)SH /Times-Roman SF 12280 XM (The Heath/Zenith-19 terminal \050H19\051,) 166 W( which supports all the VT52 commands, plus line and character)167 W 12280 38333 MT (insert/delete editing functions, an ANSI mode, and a 25th line.)SH /Courier SF 8280 39910 MT (VT102)SH /Times-Roman SF 12280 XM (The DEC VT102 \050ANSI\051 terminal, which is the same as) 206 W( the VT100 but also supports line/character)205 W 12280 41015 MT (insert/delete editing functions and ANSI printer controls.)SH /Courier SF 8280 42592 MT (TEK4010)SH /Times-Roman SF 12280 43697 MT (A Tektronix 4010 graphics terminal. Currently only available on IBM, TI, and Victor PCs.) 51 W( On) 351 W( the IBM)50 W 12280 44802 MT (family, Kermit automatically senses and adapts to) 59 W( the CGA, EGA, Monochrome, Hercules, or ATT style)60 W 12280 45907 MT (board.)SH 8280 47698 MT (On the IBM family, you may "toggle" among the supported terminal emulations by typing Alt-Minus.)SH 8280 50090 MT (The specific escape sequences supported by Kermit for each of these terminal types are listed in) 136 W( section 5.16.1.)135 W 8280 51286 MT (Note that when a Kermit program) 253 W( includes Tektronix emulation, this can be invoked automatically while in)254 W 8280 52482 MT (character mode \050VT102, VT52, or Heath emulation\051 when the emulator receives certain escape sequences.) 18 W( This) 285 W( can)17 W 8280 53678 MT (be turned off using the DISABLE TEK command.)SH 8280 56070 MT (The remaining SET TERMINAL commands specify setup options for the selected terminal:)SH /Courier SF 8280 57799 MT (CHARACTER-SET {UK, US})SH /Times-Roman SF 12280 58904 MT (UK displays ``)135 W /Courier SF (#)SH /Times-Roman SF ('' \050ASCII 35, number sign\051 as a pound sterling) 135 W( sign, US displays ``)134 W /Courier SF (#)SH /Times-Roman SF ('' as ``)134 W /Courier SF (#)SH /Times-Roman SF (''. This)518 W 12280 60009 MT (command applies during VT100/102 emulation.)SH /Courier SF 8280 61586 MT (COLOR)SH /Times-Italic SF 11880 XM (number)SH /Courier SF 15535 XM ([,)SH /Times-Italic SF 17335 XM (number)SH /Courier SF 20990 XM ([,)SH /Times-Italic SF 22790 XM (number)SH /Courier SF (]])SH /Times-Roman SF 12280 62691 MT (Several numbers, applied in left to right sequence, separated by commas or spaces:)SH 13280 64030 MT (0)SH 15280 XM (Reset the) 17 W( colors to normal intensity white characters on a black background and use the "no-snow")16 W 15280 65135 MT (mode on the IBM Color Graphics Adapter \050CGA\051.)SH 13280 66240 MT (1)SH 15280 XM (High intensity foreground)SH 13280 67345 MT (10)SH 15280 XM (Request fast screen updating for use on the IBM Mono, EGA, or VGA) 130 W( \050usually sensed and set)131 W 15280 68450 MT (internally by Kermit\051, and some non-IBM CGAs.)SH 13280 69555 MT (3)SH /Times-Italic SF (x)SH /Times-Roman SF 15280 XM (Foreground color)SH ES %%Page: 90 91 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 90)SH 12 /Times-Bold AF 28285 XM (Kermit User Guide: MS-DOS KERMIT \0505.6.10\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 11120 7886 MT (4)SH /Times-Italic SF (x)SH /Times-Roman SF 13120 XM (Background color)SH 10120 9225 MT (where)SH /Times-Italic SF 12813 XM (x)SH /Times-Roman SF 13507 XM (is a single digit from 0 to 7, which is the sum of the desired colors:)SH 11120 11016 MT (1)SH 13120 XM (Red)SH 11120 12121 MT (2)SH 13120 XM (Green)SH 11120 13226 MT (4)SH 13120 XM (Blue)SH 10120 15017 MT (Example: "SET TERMINAL COLOR 0 1 37 44" on an IBM CGA would) 69 W( produce bold white characters)68 W 10120 16122 MT (on a blue field with no snow. The snow removal business) 115 W( has to do with whether the program should)116 W 10120 17227 MT (synchronize with vertical retrace when updating screen memory. This is necessary with certain color)163 W 10120 18332 MT (adaptors \050like the CGA\051 and unnecessary for others \050like the EGA\051.)SH /Courier SF 6120 19909 MT (CURSOR-STYLE {BLOCK, UNDERLINE})SH /Times-Roman SF 10120 21014 MT (Sets the cursor rendition to your preference. Note that on some early IBM PCs and) 157 W( compatibles, the)156 W 10120 22119 MT (cursor may not be restored correctly after escaping) 88 W( back from CONNECT because of a bug in the early)89 W 10120 23224 MT (IBM BIOS.)SH /Courier SF 6120 24801 MT (KEYCLICK {ON, OFF})SH /Times-Roman SF 10120 25906 MT (Turns electronic keyclick ON or OFF. If your keyboard has a mechanical clicker \050as IBM boards do\051,) 11 W( you)12 W 10120 27011 MT (may not notice the effect of this command.)SH /Courier SF 6120 28588 MT (GRAPHICS {AUTO-SENSING, CGA, EGA, VGA, HERCULES, ATT})SH /Times-Roman SF 10120 29693 MT (Manually selects the) 152 W( kind of display adapter for Tektronix graphics. AUTO-SENSING is the default,)153 W 10120 30798 MT (VGA means 640x480x16) 114 W( colors, and ATT encompasses the ATT 6300 series, Olivetti M24/M28, DEC)113 W 10120 31903 MT (VAXmate II, and the Toshiba T3100 in 640x400 b/w \050see Table 5-5\051.)SH /Courier SF 6120 33480 MT (MARGIN-BELL {ON, OFF})SH /Times-Roman SF 10120 34585 MT (Controls whether the bell should be sounded when the cursor passes column 72 near the right screen)165 W 10120 35690 MT (margin; wider displays set the bell 8 columns from the right edge.)SH /Courier SF 6120 37267 MT (NEWLINE-MODE {ON, OFF})SH /Times-Roman SF 10120 38372 MT (ON sends a carriage-return-linefeed combination \050CRLF\051 when you type carriage) 202 W( return \050CR\051 during)201 W 10120 39477 MT (terminal emulation. OFF \050default\051 just sends a CR when you type CR.) 72 W( Useful) 395 W( in conjunction with SET)73 W 10120 40582 MT (LOCAL-ECHO ON when CONNECTing two PC's back-to-back.)SH /Courier SF 6120 42159 MT (ROLL {ON, OFF})SH /Times-Roman SF 10120 43264 MT (ON unrolls the screen to the bottom before adding new material if the screen had been) 19 W( rolled back, e.g. by)20 W 10120 44369 MT (Ctrl-PgUp. ROLL) 273 W( OFF \050the default\051 displays new material on the current screen, possibly overwriting old)11 W 10120 45474 MT (material.)SH /Courier SF 6120 47051 MT (SCREEN-BACKGROUND {NORMAL, REVERSE})SH /Times-Roman SF 10120 48156 MT (NORMAL means dark background, light characters. REVERSE means light background, dark characters.)SH /Courier SF 6120 49733 MT (TAB {AT)SH /Times-Italic SF 10920 XM (n)SH /Courier SF (, CLEAR AT)SH /Times-Italic SF 18020 XM (n)SH /Courier SF (, CLEAR ALL})SH /Times-Roman SF 10120 50838 MT (Sets tab stops or clears one or all) 71 W( tab stops;)72 W /Times-Italic SF 28276 XM (n)SH /Times-Roman SF 29098 XM (is the numeric position of the tab to be set or cleared. By)72 W 10120 51943 MT (default, tabs are every 8 spaces, at positions 9, 17, 25, etc.) 76 W( Only) 401 W( meaningful when emulating a terminal)75 W 10120 53048 MT (that has settable tabs \050the VT52 doesn't really but the emulator can) 117 W( set them anyway\051. More than one)118 W 10120 54153 MT (tabstop may be specified by separating column numbers with commas, spaces, or tabs. 132 columns are)66 W 10120 55258 MT (supported.)SH /Courier SF 6120 56835 MT (WRAP {ON, OFF})SH /Times-Roman SF 10120 57940 MT (ON automatically breaks screen lines \050by inserting a CRLF\051 when they reach) 167 W( the right margin. OFF)166 W 10120 59045 MT (disables wrapping -- if a line is too long, the excess characters go off the screen. WRAP is OFF by)157 W 10120 60150 MT (default, since most hosts format lines to fit on your screen.)SH 12 /Times-Bold AF 6120 62738 MT (SET TIMER)SH 10 /Times-Roman AF 6120 64152 MT (Syntax:)SH /Courier SF 9426 XM (SET TIMER {ON, OFF})SH /Times-Roman SF 6120 66544 MT (This command enables or disables) 129 W( the timer that is used during file transfer to break deadlocks that occur when)128 W 6120 67740 MT (expected packets do not arrive. By default, the timer is ON. If the other Kermit is providing) 111 W( timeouts, you can)112 W 6120 68936 MT (safely turn the timer OFF to avoid unnecessary retransmissions that occur when two timers go off simultaneously.)SH ES %%Page: 91 92 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.6.10. The SET Command)SH 10 /Times-Italic AF 51775 XM (Page 91)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (SET TRANSLATION)SH 10 /Times-Roman AF 8280 9418 MT (Syntax:)SH /Courier SF 11586 XM (SET TRANSLATION INPUT {ON, OFF,)SH /Times-Italic SF 30786 XM (char1 char2)350 W /Courier SF (})SH /Times-Roman SF 8280 11810 MT (This command provides multi-language support \050and perhaps other special effects\051 during CONNECT, and) 75 W( during)74 W 8280 13006 MT (execution of) 98 W( the INPUT, OUTPUT, PAUSE, and TRANSMIT script commands, but not during file transfer or at)99 W 8280 14202 MT (MS-Kermit command level. A character that arrives at the communication port \050)15 W /Times-Italic SF (char1)SH /Times-Roman SF (\051 will be translated) 15 W( to another)14 W 8280 15398 MT (character \050)257 W /Times-Italic SF (char2)SH /Times-Roman SF (\051 before display on the screen. As many as) 257 W( 256 characters may have translations specified)258 W 8280 16594 MT (concurrently. But) 402 W( to see characters with ASCII values higher than 127, you must also SET DISPLAY 8 and SET)76 W 8280 17790 MT (PARITY NONE.)SH 8280 20182 MT (SET TRANSLATION INPUT ON enables translation \050the keyword INPUT is) 93 W( required to allow future translation)94 W 8280 21378 MT (mechanisms\051. OFF) 418 W( disables the translation and) 84 W( is the default. So even if you have set up a translation table, you)83 W 8280 22574 MT (must SET) 1 W( TRANSLATION INPUT ON before it will take effect. SHOW TRANSLATION tells whether translation)2 W 8280 23770 MT (is OFF or ON, and displays any current table entries.)SH 8280 26162 MT (Translation table entries are made by specifying byte pairs in ASCII or numeric backslash form:)SH /Courier SF 10680 27817 MT (SET TRANS INPUT \1343 \13413)SH /Times-Roman SF 8280 29534 MT (converts incoming ASCII ETX characters \050decimal 3\051) 125 W( to ASCII CR \050decimal 13\051. 8-bit values are allowed, and)124 W 8280 30730 MT (refer to characters in the "upper half") 56 W( of the PC's character set, either the ROM characters supplied with the PC or)57 W 8280 31926 MT (else substitutions provided by a special device driver.)SH 8280 34318 MT (A more) 42 W( practical example shows how the user of a German PC could use the SET TRANSLATION and SET KEY)41 W 8280 35514 MT (commands to make the PC's umlaut-a key \050key code 132\051 send a) 35 W( left curly brace \050``)36 W /Courier SF ({)SH /Times-Roman SF ('', ASCII 123\051, and to display)36 W 8280 36710 MT (incoming curly braces as umlaut-a's:)SH /Courier SF 10680 38365 MT (SET KEY \134d132 \134d123)SH 10680 39396 MT (SET TRANS INP { \134d132)SH /Times-Roman SF 8280 41113 MT (\050This example applies to the IBM PC German keyboard, and assumes the) 56 W( German keyboard driver, KEYBGR, has)55 W 8280 42309 MT (been loaded. This is usually done in)SH /Courier SF 23140 XM (AUTOEXEC.BAT)SH /Times-Roman SF (.\051)SH 12 /Times-Bold AF 8280 44897 MT (SET WARNING)SH 10 /Times-Roman AF 8280 46311 MT (Syntax:)SH /Courier SF 11586 XM (SET WARNING {ON, OFF})SH /Times-Roman SF 8280 48703 MT (Specify what to do when an incoming file is about to be stored under) 31 W( the same name as an existing file in the target)32 W 8280 49899 MT (device and directory. If ON, Kermit will warn you when an incoming file has the same) 8 W( name as an existing file, and)7 W 8280 51095 MT (automatically rename the incoming file \050as indicated in) 78 W( the warning message\051 so as not to destroy \050overwrite\051 any)79 W 8280 52291 MT (existing one.) 200 W( If) 648 W( OFF, the pre-existing file is destroyed, even if the incoming file does not arrive completely.)199 W 8280 53487 MT (WARNING is ON by default as a safety measure, and the current setting may be observed in) 136 W( the SHOW FILE)137 W 8280 54683 MT (display.)SH 8280 57075 MT (The new name is formed by adding numbers to the part of the name before the dot.) 175 W( For) 598 W( instance,)174 W /Courier SF 50880 XM (ABC.TXT)SH /Times-Roman SF 8280 58271 MT (becomes)SH /Courier SF 12275 XM (ABC00001.TXT)SH /Times-Roman SF (,)SH /Courier SF 20221 XM (ABC00001.TXT)SH /Times-Roman SF 27917 XM (becomes)SH /Courier SF 31912 XM (ABC00002.TXT)SH /Times-Roman SF (, etc. If the) 246 W( name already has eight)247 W 8280 59467 MT (characters, then digits replace the rightmost characters.)SH 12 /Times-Bold AF 8280 62583 MT (5.6.11. The STATUS and SHOW Commands)SH 10 /Times-Roman AF 8280 64525 MT (The values of MS-Kermit options that can be SET, DEFINEd, ENABLEd, or DISABLEd can be displayed) 5 W( using the)4 W 8280 65721 MT (STATUS or SHOW commands.)SH ES %%Page: 92 93 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 92)SH 12 /Times-Bold AF 28285 XM (Kermit User Guide: MS-DOS KERMIT \0505.6.11\051)SH 46800 50 6120 5709 UL 6120 8004 MT (The STATUS Command)SH 10 /Times-Roman AF 6120 9418 MT (Syntax:)SH /Courier SF 9426 XM (STATUS)SH /Times-Roman SF 6120 11810 MT (The STATUS command) 2 W( displays the values of all the current SET options on a single screen. There are currently no)3 W 6120 13006 MT (operands for the STATUS command. Use) 171 W( the SHOW command to see logically-grouped settings, e.g. SHOW)170 W 6120 14202 MT (COMMUNICATIONS, SHOW TERMINAL.)SH 12 /Times-Bold AF 6120 16790 MT (The SHOW Command)SH 10 /Times-Roman AF 6120 18204 MT (Syntax:)SH /Courier SF 9426 XM (SHOW)SH /Times-Italic SF 12426 XM (option)SH /Times-Roman SF 6120 20596 MT (The SHOW command is used for displaying communication parameters,) 100 W( protocol settings, macro definitions, key)101 W 6120 21792 MT (redefinitions, file transfer statistics, translations, and other common groupings.)SH /Courier SF 6120 23521 MT (SHOW COMMUNICATIONS)SH /Times-Roman SF 10120 24626 MT (displays the settings of the current serial) 153 W( port \050port, speed, parity, echo, etc\051 and the status of modem)154 W 10120 25731 MT (signals Carrier Detect, Data Set \050modem\051 Ready, and Clear To Send.)SH /Courier SF 6120 27308 MT (SHOW FILE)SH /Times-Roman SF 10120 28413 MT (displays the file transfer control settings, such as the current) 96 W( path, file discard, attributes packets on/off,)97 W 10120 29518 MT (warning, end-of-file convention, etc.)SH /Courier SF 6120 31095 MT (SHOW KEY)SH /Times-Roman SF 10120 32200 MT (allows you to determine a key's identification code and what it will send in CONNECT mode, most) 8 W( useful)9 W 10120 33305 MT (for obtaining the identification of a key when SET KEY commands will be placed in a TAKE file.) 60 W( This)369 W 10120 34410 MT (command can be done only interactively \050use a)201 W /Courier SF 30835 XM (?)SH /Times-Roman SF 31886 XM (to see all defined keys\051. Refer to the SET KEY)201 W 10120 35515 MT (description for details.)SH /Courier SF 6120 37092 MT (SHOW LOGGING)SH /Times-Roman SF 10120 38197 MT (Displays the names of the session, packet, and transaction logs, and tells whether logging is in effect.)SH /Courier SF 6120 39774 MT (SHOW MACROS [macroname])SH /Times-Roman SF 10120 40879 MT (displays the definitions) 35 W( of all currently defined macros, as well as the amount of space left for new macro)34 W 10120 41984 MT (definitions. A macro name, or abbreviation, can be included to) 36 W( restrict the list, e.g. SHOW MACRO IBM)37 W 10120 43089 MT (will display the definition of) 16 W( the IBM macro, and SHOW MACRO X will list the definitions of all macros)15 W 10120 44194 MT (whose names begin with X.)SH /Courier SF 6120 45771 MT (SHOW MODEM)SH /Times-Roman SF 10120 46876 MT (displays the status of the modem signals DSR \050dataset ready, modem tells) 3 W( the PC that it is turned on and in)2 W 10120 47981 MT (data mode\051, CTS \050clear to send, modem grants) 91 W( the PC permission to send data\051, and CD \050carrier detect,)92 W 10120 49086 MT (local modem tells the PC that it is connected to the remote) 107 W( modem\051. The results may be misleading if)106 W 10120 50191 MT (your asynchronous adapter,) 143 W( or the connector or cable that is attached to it, is strapped to supply these)144 W 10120 51296 MT (modem signals itself.)SH /Courier SF 6120 52873 MT (SHOW PROTOCOL)SH /Times-Roman SF 10120 53978 MT (displays the values of the Kermit protocol-related parameters, including) 194 W( all the SET SEND and SET)195 W 10120 55083 MT (RECEIVE parameters, plus whether the timer, attribute packets, and logging are enabled.)SH /Courier SF 6120 56660 MT (SHOW SCRIPTS)SH /Times-Roman SF 10120 57765 MT (displays the script-related variables.)SH /Courier SF 6120 59342 MT (SHOW SERVER)SH /Times-Roman SF 10120 60447 MT (displays which server functions are enabled and disabled.)SH /Courier SF 6120 62024 MT (SHOW STATISTICS)SH /Times-Roman SF 10120 63129 MT (displays counts of) 55 W( characters sent and received during file transfers, for both the most recent transfer and)56 W 10120 64234 MT (the entire session, and an estimate of the average baud rate while sending and listening.)SH /Courier SF 6120 65811 MT (SHOW TERMINAL)SH /Times-Roman SF 10120 66916 MT (displays the terminal settings, which terminal is being emulated, the tab stops, etc.)SH /Courier SF 6120 68493 MT (SHOW TRANSLATION)SH /Times-Roman SF 10120 69598 MT (displays the entries in the 256 byte input translation table. Values are expressed numerically) 139 W( to avoid)138 W 10120 70703 MT (confusion with) 12 W( different display adapters, and the command shows only entries for which input and output)13 W 10120 71808 MT (codes differ.)SH ES %%Page: 93 94 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.7. Macros)SH 10 /Times-Italic AF 51775 XM (Page 93)SH 46800 50 8280 5709 UL 14 /Times-Bold AF 8280 8138 MT (5.7. Macros)SH 10 /Times-Roman AF 8280 10256 MT (Like TAKE files, macros provide) 148 W( a way of collecting many commands into a single command. The difference)147 W 8280 11452 MT (between a macro and a TAKE file) 14 W( is that Kermit keeps all its macro definitions in memory, and can execute them as)15 W 8280 12648 MT (many times as you like, without having to look them up on disk, whereas every time you issue a) 50 W( TAKE command,)49 W 8280 13844 MT (Kermit has to access a disk. But) 61 W( . . .) SH( you) 312 W( can have as many TAKE command files as you like, and they can be as)62 W 8280 15040 MT (long as you want,) 174 W( whereas MS-Kermit's memory for storing macro definitions is limited. You can put macro)173 W 8280 16236 MT (definitions and DO commands for them in TAKE files, or for that matter,) 64 W( you can put TAKE commands in macro)65 W 8280 17432 MT (definitions. There) 517 W( is a limit of 25 simultaneously active TAKE files plus active macros; a TAKE file or macro)133 W 8280 18628 MT (remains active if the last item invokes another TAKE or macro command. Active) 111 W( here means Kermit is reading)112 W 8280 19824 MT (commands from them, not just storing them for later.)SH 12 /Times-Bold AF 8280 22412 MT (The DEFINE Command)SH 10 /Times-Roman AF 8280 23826 MT (Syntax:)SH /Courier SF 11586 XM (DEFINE)SH /Times-Italic SF 15786 XM (macro-name)SH /Courier SF 21440 XM ([)SH /Times-Italic SF (command)SH /Courier SF 26528 XM ([,)SH /Times-Italic SF 28328 XM (command)SH /Courier SF 32816 XM ([, ...]]])SH /Times-Roman SF 8280 26218 MT (Kermit-MS command macros are constructed with the DEFINE command. Any Kermit-MS commands may) 139 W( be)138 W 8280 27414 MT (included. Example:)250 W /Courier SF 10680 29069 MT (define telenet set parity mark, set baud 1200, connect)SH /Times-Roman SF 8280 30786 MT (A macro can be undefined by typing an empty DEFINE command for it, like)SH /Courier SF 10680 32441 MT (define telenet)SH /Times-Roman SF 8280 34158 MT (A macro definition may be up to 255 character long. This example shows a long) 147 W( definition in which lines are)148 W 8280 35354 MT (continued with hyphenation:)SH /Courier SF 10680 37009 MT (define setup set port 1, set speed 19200, set parity even,-)SH 10680 38040 MT (set flow none, set handshake xon, set local-echo on,-)SH 10680 39071 MT (set timer on, set terminal color 1 31 45,-)SH 10680 40102 MT (set warning on, set incomplete keep, connect)SH /Times-Roman SF 8280 41819 MT (Longer definitions can be accomplished by "chaining." Example \050even though this one isn't really longer\051:)SH /Courier SF 10680 43474 MT (define setup set port 1, set speed 19200, set par even, do setup2)SH 10680 44505 MT (define setup2 set flo no, set handsh xon, set local on, do setup3)SH 10680 45536 MT (define setup3 set timer on, set terminal color 1 31 45, do setup4)SH 10680 46567 MT (define setup4 set warning on, set incomplete keep, connect)SH /Times-Roman SF 8280 48959 MT (DO SETUP or just SETUP will invoke all of these commands. Commas are used to) 63 W( separate commands in macro)62 W 8280 50155 MT (definitions; carriage returns \050)48 W /Courier SF (\13413)SH /Times-Roman SF (\051 cannot be used.) 48 W( When) 347 W( control or other special characters are needed in a macro)49 W 8280 51351 MT (they may be expressed in backslash number form,)SH /Courier SF 28526 XM (\134)SH /Times-Italic SF (nnn)SH /Times-Roman SF (.)SH 8280 53743 MT (The SHOW MACROS command displays) 58 W( the values of currently defined macros, and tells how much space is left)57 W 8280 54939 MT (for further definitions.)SH 12 /Times-Bold AF 8280 57527 MT (The DO Command)SH 10 /Times-Roman AF 8280 58941 MT (Syntax:)SH /Courier SF 11586 XM (DO)SH /Times-Italic SF 13386 XM (macro-name)SH /Courier SF 19040 XM ([)SH /Times-Italic SF (parameters...)SH /Courier SF (])SH /Times-Roman SF 8280 61333 MT (A Kermit-MS macro is invoked using the DO command.) 42 W( For) 336 W( instance, Kermit-MS comes with a predefined macro)43 W 8280 62529 MT (to allow convenient setup for IBM mainframe line-mode communications; to invoke it, you would type DO) 85 W( IBM.)84 W 8280 63725 MT (The IBM macro is defined as "set timer on, set local-echo on, set parity mark, handshake xon, set flow none". You)34 W 8280 64921 MT (can use the DEFINE command to redefine this macro or remove the definition altogether.)SH 8280 67313 MT (There is) 63 W( no automatic way to undo the effect of a macro. If you need to accomplish this effect, you should define)62 W 8280 68509 MT (another macro for that purpose. For instance, to undo the effect of "do ibm" so that you could connect to, say,) 93 W( a)94 W 8280 69705 MT (DEC VAX, you could:)SH /Courier SF 9480 71360 MT (def vax set parity none, set handshake none, set flow xon/xoff,-)SH ES %%Page: 94 95 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 94)SH 12 /Times-Bold AF 29785 XM (Kermit User Guide: MS-DOS KERMIT \0505.7\051)SH 46800 50 6120 5709 UL 10 /Courier AF 7320 7824 MT (set timer off, set local-echo off)SH /Times-Roman SF 6120 9541 MT (Then you can "do ibm" whenever you want to use the IBM system, and "do vax" whenever you want) 109 W( to use the)108 W 6120 10737 MT (VAX.)SH 6120 13129 MT (If you wish to view the macro expansion whenever you issue a DO command, you can SET TAKE-ECHO ON.)SH 6120 15521 MT (As a convenience the) 186 W( word DO may be omitted. However, when question-mark help is sought at the Kermit)187 W 6120 16717 MT (prompt, only the main keyword help table will be shown. If you want) 77 W( to see the available macros, type "do ?" or)76 W 6120 17913 MT (SHOW MACROS. Use of DO is recommended for overall clarity unless a favorite macro is executed frequently.)SH 12 /Times-Bold AF 6120 20501 MT (Variables)SH 10 /Times-Roman AF 6120 21915 MT (Syntax:)SH /Courier SF 9426 XM (\134%x)SH /Times-Italic SF 11826 XM (text)SH /Times-Roman SF 6120 24307 MT (Both TAKE files and Macros can) 220 W( use substitution variables similar to those of DOS Batch. The name of a)221 W 6120 25503 MT (substitution variable is of the form "\134%character" where the single character is a digit or a letter) 165 W( or other 8-bit)164 W 6120 26699 MT (character whose ASCII value is 48 decimal or larger;) 108 W( upper and lower case letters are considered to be the same)109 W 6120 27895 MT (character. A) 384 W( substitution variable is defined as a string of text by the DEFINE command \050the variables) 67 W( are in fact)66 W 6120 29091 MT (macros\051 and Kermit replaces occurrences of the variable name with that text, hence the word "substitution".) 128 W( For)129 W 6120 30287 MT (example,)SH /Courier SF 8520 31942 MT (Kermit-MS>define \134%a this is substituted material)SH 23400 50 14520 32142 UL 8520 32973 MT (Kermit-MS>echo I wonder if \134%a or not.)SH 16800 50 14520 33173 UL /Times-Roman SF 6120 34690 MT (yields the display:)SH /Courier SF 8520 36345 MT (I wonder if this is substituted material or not.)SH /Times-Roman SF 6120 38062 MT (Another example:)SH /Courier SF 8520 39717 MT (Kermit-MS>define \134%c set port 1,set speed 9600,set parity even,connect)SH 36000 50 14520 39917 UL /Times-Roman SF 6120 41434 MT (Then)SH /Courier SF 8520 43089 MT (Kermit-MS>\134%c)SH 1800 50 14520 43289 UL /Times-Roman SF 6120 44806 MT (is equivalent to)SH /Courier SF 8520 46461 MT (Kermit-MS>set port com1)SH 7800 50 14520 46661 UL 8520 47492 MT (Kermit-MS>set speed 9600)SH 8400 50 14520 47692 UL 8520 48523 MT (Kermit-MS>set parity even)SH 9000 50 14520 48723 UL 8520 49554 MT (Kermit-MS>connect)SH 4200 50 14520 49754 UL /Times-Roman SF 6120 51271 MT (The special subset of) 77 W( substitution variables,)76 W /Courier SF 24272 XM (\134%1 .. \134%9)76 W /Times-Roman SF (, is similar to the DOS Batch variable set)76 W /Courier SF 47718 XM (%1 .. %9)76 W /Times-Roman SF (.)SH 6120 52467 MT (The DO command can accept arguments) 78 W( after the macro name and the individual words in the arguments become)79 W 6120 53663 MT (the definitions of)SH /Courier SF 13203 XM (\134%1)SH /Times-Roman SF (, etc, for up to nine words, in order. For example, given the following definition:)SH /Courier SF 8520 55318 MT (def dial ATDT\134%1\13413,input 30 CONNECT,connect,in Login:,out \134%2\13413)SH /Times-Roman SF 6120 57035 MT (the following command can be used to dial any phone number:)SH /Courier SF 8520 58690 MT (Kermit-MS>do dial 555-1212 myname)SH 13800 50 14520 58890 UL /Times-Roman SF 6120 60407 MT (The word DO may be omitted, as in:)SH /Courier SF 8520 62062 MT (Kermit-MS>dial 555-1212 myname)SH 12000 50 14520 62262 UL /Times-Roman SF 6120 63779 MT (This command automatically assigns the value) 125 W( "555-1212" to variable the)124 W /Courier SF 37178 XM (\134%1)SH /Times-Roman SF 39352 XM (and "myname" to)124 W /Courier SF 46956 XM (\134%2)SH /Times-Roman SF (, and uses)124 W 6120 64975 MT (these values while dialing the phone and logging into the host system. If fewer than nine words are seen) 175 W( the)176 W 6120 66171 MT (remaining variables are not changed.) 1 W( For) 250 W( example, if the line above was busy, you could dial a different number and)SH 6120 67367 MT (omit the username because it will be remembered from last time.)SH 6120 69759 MT (Substitution variables can reference) 190 W( other substitution variables in their definitions. Care is needed to prevent)191 W 6120 70955 MT (circular definitions, but) 18 W( even those are detected by Kermit. Subtle circular executions could cause Kermit to go into)17 W ES %%Page: 95 96 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.7. Macros)SH 10 /Times-Italic AF 51775 XM (Page 95)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (an endless loop; if you think this is happening, type a Control-C) 105 W( to interrupt the process. To clarify matters, the)106 W 8280 9082 MT (definition string of a variable is substituted for the variable's name when) 27 W( the name is observed in a left to right scan)26 W 8280 10278 MT (of a command. For example,)SH /Courier SF 10680 11933 MT (Kermit-MS>define \134%a echo This is \134%b example: \134%b.)SH 24600 50 16680 12133 UL 10680 12964 MT (Kermit-MS>define \134%b a mac\134%c expansion)SH 17400 50 16680 13164 UL 10680 13995 MT (Kermit-MS>define \134%c ro string)SH 12000 50 16680 14195 UL 10680 15026 MT (Kermit-MS>\134%a)SH 1800 50 16680 15226 UL /Times-Roman SF 8280 16743 MT (displays:)SH /Courier SF 10680 18398 MT (This is a macro string expansion example: a macro string expansion.)SH /Times-Roman SF 8280 20115 MT (If this example is entered manually then) 4 W( when the final)5 W /Courier SF 30598 XM (\134%a)SH /Times-Roman SF 32653 XM (is typed the command line is immediately replaced with)5 W 8280 21311 MT (the fully expanded command and more input is solicited \050such as a carriage return\051. Try it. Check the variable)121 W 8280 22507 MT (definitions with the SHOW MACRO command.)SH 8280 24899 MT (A variable can be undefined \050deleted\051 by defining it as an empty string:)SH /Courier SF 10680 26554 MT (Kermit-MS>define \134%c)SH 6000 50 16680 26754 UL /Times-Roman SF 8280 28271 MT (Finally, macros) 263 W( may contain labels, GOTO label commands, IF statements, and other script control features)264 W 8280 29467 MT (discussed below the same as if the macro were a TAKE file. Macros may also invoke TAKE files, and vice versa.)SH 14 /Times-Bold AF 8280 33069 MT (5.8. SCRIPTS)SH 10 /Times-Roman AF 8280 35187 MT (A script is a file or a macro containing Kermit commands to be executed. What) 17 W( distinguishes a script from ordinary)16 W 8280 36383 MT (TAKE files or macros is) 67 W( the presence of INPUT, REINPUT, OUTPUT, PAUSE, ECHO, CLEAR, IF, GOTO, and)68 W 8280 37579 MT (WAIT commands to automatically detect and respond to information flowing though the serial) 65 W( port, actions which)64 W 8280 38775 MT (otherwise would be performed) 30 W( by the user during CONNECT. The login sequence of a host computer is a classical)31 W 8280 39971 MT (example.)SH 8280 42363 MT (It is a common, but incorrect, assumption that text to be sent to the remote computer can be included in a) 14 W( TAKE file)13 W 8280 43559 MT (after the CONNECT command:)SH /Courier SF 10680 45214 MT (set speed 9600) SH( ;) 4200 W( MS-Kermit command)SH 10680 46245 MT (connect ;) 8400 W( MS-Kermit command)SH 10680 47276 MT (run kermit) SH( ;) 6600 W( Text to be sent to other system)SH 10680 48307 MT (send foo.bar) SH( ;) 5400 W( Text to be sent to other system)SH 10680 49338 MT (^]c ;) 10800 W( Escape sequence to get back to MS-Kermit)SH 10680 50369 MT (receive ;) 8400 W( MS-Kermit command)SH /Times-Roman SF 8280 52086 MT (The reason this doesn't work is that during CONNECT,) 78 W( MS-Kermit always reads from the real keyboard, and not)79 W 8280 53282 MT (from the take file. Even if this technique did work, it would still run into synchronization problems. But) 41 W( these can)40 W 8280 54478 MT (be avoided when there is a way to coordinate the commands) 154 W( that we send with the remote system's responses.)155 W 8280 55674 MT (Kermit's script commands provide this ability. They may be freely) 78 W( intermixed in a TAKE file or macro with any)77 W 8280 56870 MT (other Kermit) 37 W( commands to achieve any desired effect. The OUTPUT command sends the specified characters as if)38 W 8280 58066 MT (the user had typed them; the INPUT) 145 W( command reads the responses and compares them with specified character)144 W 8280 59262 MT (strings, just as the user would do.)SH 8280 61654 MT (The script commands include INPUT, REINPUT, OUTPUT, PAUSE, WAIT, ECHO, IF, and) 224 W( GOTO. These)225 W 8280 62850 MT (commands may be interrupted by typing Ctrl-C) 169 W( at the keyboard. The INPUT, REINPUT, PAUSE, and WAIT)168 W 8280 64046 MT (commands accept a following number as a timeout value. The) 29 W( number is interpreted as seconds from the present or,)30 W 8280 65242 MT (if given in)42 W /Courier SF 12767 XM (hh:mm:ss)SH /Times-Roman SF 17859 XM (form, as a specific time of day. In either case, the timeout interval must be within) 42 W( 12 hours)41 W 8280 66438 MT (of the present to avoid it being considered as in the past \050expired\051.)SH ES %%Page: 96 97 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 96)SH 12 /Times-Bold AF 29785 XM (Kermit User Guide: MS-DOS KERMIT \0505.8\051)SH 46800 50 6120 5709 UL 6120 8004 MT (The CLEAR Command)SH 10 /Times-Roman AF 6120 9418 MT (Syntax:)SH /Courier SF 9426 XM (CLEAR)SH /Times-Roman SF 6120 11810 MT (The CLEAR command empties) 106 W( the buffers of the serial port to forget any earlier material. This gets the INPUT)107 W 6120 13006 MT (command off) 76 W( to a clean start. \050This command was called CLRINP in 2.29B and earlier, and CLEAR was used to)75 W 6120 14202 MT (erase macro and key definition memory\051.)SH 12 /Times-Bold AF 6120 16790 MT (The ECHO Command)SH 10 /Times-Roman AF 6120 18204 MT (Syntax:)SH /Courier SF 9426 XM (ECHO)SH /Times-Italic SF 12426 XM (text)SH /Times-Roman SF 6120 20596 MT (The ECHO command) 84 W( is useful for reporting progress of a script, or prompting the user for interactive input. The)85 W 6120 21792 MT (text is displayed on the screen, and may include backslash notation for control or 8-bit) 150 W( characters. An implied)149 W 6120 22988 MT (linefeed is included at the beginning of the text.)SH 12 /Times-Bold AF 6120 25576 MT (SET INPUT)SH 10 /Times-Roman AF 6120 26990 MT (Syntax:)SH /Courier SF 9426 XM (SET INPUT {CASE, DEFAULT-TIMEOUT, ECHO, TIMEOUT-ACTION})SH /Times-Roman SF 6120 29382 MT (The SET INPUT command controls the behavior of the script INPUT command:)SH /Courier SF 6120 31111 MT (SET INPUT CASE {IGNORE, OBSERVE})SH /Times-Roman SF 8120 32216 MT (Says whether or not to distinguish upper and lower) 16 W( case letters when doing a matchup in the INPUT command.)15 W 8120 33321 MT (OBSERVE causes upper and lower case letters) 305 W( to be distinguished. The default is to IGNORE case)306 W 8120 34426 MT (distinctions.)SH /Courier SF 6120 36003 MT (SET INPUT DEFAULT-TIMEOUT)SH /Times-Italic SF 21720 XM (seconds)SH /Times-Roman SF 8120 37108 MT (Changes the default waiting time from one second to this new value. The) 162 W( value is used when an INPUT)163 W 8120 38213 MT (command has no timeout specified.)SH /Courier SF 6120 39790 MT (SET INPUT ECHO {ON, OFF})SH /Times-Roman SF 8120 40895 MT (Show on the screen characters read) 5 W( from the serial port during the script operation, or not. Default is ON, show)6 W 8120 42000 MT (them.)SH /Courier SF 6120 43577 MT (SET INPUT TIMEOUT-ACTION {PROCEED, QUIT})SH /Times-Roman SF 8120 44682 MT (Determines whether or not the current macro) 55 W( or TAKE command file is to be continued or exited if a timeout)56 W 8120 45787 MT (occurs. PROCEED) 368 W( is the default and means that timeouts are ignored.) 59 W( QUIT) 366 W( causes the current script file to)58 W 8120 46892 MT (be exited and control passed to either the next higher level script file \050if there is one\051 or) 143 W( to Kermit's main)144 W 8120 47997 MT (prompt.)SH 6120 49788 MT (The SHOW SCRIPTS command displays the SET INPUT values.)SH 12 /Times-Bold AF 6120 52376 MT (The INPUT command)SH 10 /Times-Roman AF 6120 53790 MT (Syntax:)SH /Courier SF 9426 XM (INPUT [)SH /Times-Italic SF (timeout)SH /Courier SF (] {)SH /Times-Italic SF (search-string)SH /Courier SF (, @)SH /Times-Italic SF (filespec)SH /Courier SF (})SH /Times-Roman SF 6120 56182 MT (INPUT is the most powerful of the script commands. It reads characters from) 34 W( the serial port continuously until one)33 W 6120 57378 MT (of two) 62 W( things occurs: the received characters match the search string or the time limit expires. Matching strings is)63 W 6120 58574 MT (the normal use, as in:)SH /Courier SF 8520 60229 MT (Kermit-MS>input 5 Login please:)SH 12600 50 14520 60429 UL /Times-Roman SF 6120 61946 MT (to recognize the phrase) 119 W( "Login please:", or else time out after waiting for 5 seconds. A special binary character)118 W /Courier SF 6120 63142 MT (\134255)SH /Times-Roman SF 8885 XM (or)SH /Courier SF 10083 XM (\134o377)SH /Times-Roman SF 13449 XM (or)SH /Courier SF 14648 XM (\134xFF)SH /Times-Roman SF 17414 XM (stands for the combination carriage return and a line feed, in either order, to simplify)116 W 6120 64338 MT (pattern matching. The command reports a testable status of) 351 W( SUCCESS or FAILURE and sets the DOS)350 W 6120 65534 MT (ERRORLEVEL parameter to 2 if it fails to match within the timeout) 69 W( interval. Characters are stored in a 128 byte)70 W 6120 66730 MT (buffer for later examination by REINPUT, discussed below.)SH 6120 69122 MT (Beware of characters arriving with parity set) 74 W( because the pattern matching considers all 8 bits of a byte unless the)73 W 6120 70318 MT (local parity is other than NONE and SET DISPLAY is 7-BITS. Arriving characters are modified by) 37 W( first removing)38 W 6120 71514 MT (the parity bit, if parity is other than NONE, then they are passed through) 229 W( the SET TRANSLATION INPUT)228 W ES %%Page: 97 98 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.8. SCRIPTS)SH 10 /Times-Italic AF 51775 XM (Page 97)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (converter, the high bit is again suppressed if) 90 W( SET DISPLAY is 7-BITs, the result is logged and stored for pattern)91 W 8280 9082 MT (matching.)SH 12 /Times-Bold AF 8280 11670 MT (The REINPUT command)SH 10 /Times-Roman AF 8280 13084 MT (Syntax:)SH /Courier SF 11586 XM (REINPUT [)SH /Times-Italic SF (timeout)SH /Courier SF (] {)SH /Times-Italic SF (search-string)SH /Courier SF (, @)SH /Times-Italic SF (filespec)SH /Courier SF (})SH /Times-Roman SF 8280 15476 MT (The REINPUT command is like INPUT) 55 W( except that characters are read from the 128 byte serial port history buffer)54 W 8280 16672 MT (rather than always seeking fresh input from the port.) 144 W( The) 539 W( purpose is to permit the current text to be examined)145 W 8280 17868 MT (several times, looking for different match strings. A common case is reading the results of a connection message)85 W 8280 19064 MT (from a modem which might be "CONNECT 1200" or) 80 W( "CONNECT 2400", depending on the other modem. If the)81 W 8280 20260 MT (history buffer has less than 128 bytes then fresh input may be requested while seeking a match, until) 78 W( the buffer is)77 W 8280 21456 MT (full. REINPUT) 664 W( match searches begin at the start of the buffer whereas INPUT searches never) 207 W( go back over)208 W 8280 22652 MT (examined characters. REINPUT sets the testable status of SUCCESS or FAILURE and DOS ERRORLEVEL, just)48 W 8280 23848 MT (as for INPUT.)SH 8280 26240 MT (The INPUT, REINPUT,) 178 W( and OUTPUT commands have a special syntax to replace the normal string with text)179 W 8280 27436 MT (obtained from a file or device:)SH /Courier SF 10680 29151 MT (OUTPUT @)SH /Times-Italic SF (filespec)SH /Courier SF 10680 30182 MT (INPUT @)SH /Times-Italic SF (filespec)SH /Times-Roman SF 8280 31899 MT (Both forms read one line of text from the file or device and use it as the desired string. A common use is to wait for)15 W 8280 33095 MT (a password prompt and then read the password from the console keyboard. A string) 13 W( starts with the first non-spacing)14 W 8280 34291 MT (character and ends at either the end of line or, if executed within a TAKE file, at) 60 W( a semicolon. Indirectly obtained)59 W 8280 35487 MT (strings, the)18 W /Courier SF 12955 XM (@)SH /Times-Italic SF (filespec)SH /Times-Roman SF 16878 XM (form, read the first line of) 18 W( the file up to but not including the explicit carriage return. Note if a)19 W 8280 36683 MT (trailing carriage return is needed it must be expressed numerically, such as)SH /Courier SF 38357 XM (\13413)SH /Times-Roman SF 40407 XM (decimal. Example:)250 W /Courier SF 10680 38338 MT (input 7 Password:)SH 10680 39369 MT (echo Please type your password:)SH 10680 40400 MT (output @con)SH 10680 41431 MT (output \13413)SH 10680 42462 MT (echo \13413\13410Thank you!)SH /Times-Roman SF 8280 44179 MT (In this example, a TAKE file requests the user to type in the password interactively, so that it does not have to be)72 W 8280 45375 MT (stored on disk as part of the TAKE file.)SH 8280 47767 MT (When a script fails) 179 W( because an INPUT or REINPUT command did not encounter the desired string within the)180 W 8280 48963 MT (timeout interval the message "?Timeout" is displayed.)SH 12 /Times-Bold AF 8280 51551 MT (The OUTPUT command)SH 10 /Times-Roman AF 8280 52965 MT (Syntax:)SH /Courier SF 11586 XM (OUTPUT {)SH /Times-Italic SF (string)SH /Courier SF (, @)SH /Times-Italic SF (filespec)SH /Courier SF (})SH /Times-Roman SF 8280 55357 MT (The OUTPUT command writes the indicated character string to the serial port as) 127 W( ordinary text. The string may)126 W 8280 56553 MT (contain control or other special) 70 W( binary characters by representing them in backslash form. Carriage Return)71 W /Courier SF 52430 XM (\050CR\051)SH /Times-Roman SF (,)SH 8280 57749 MT (for example, is)136 W /Courier SF 14909 XM (\13413 decimal)136 W /Times-Roman SF (,)SH /Courier SF 22281 XM (\134o15)SH /Times-Roman SF 25066 XM (octal, or)135 W /Courier SF 28863 XM (\134x0D)SH /Times-Roman SF 31648 XM (hexadecimal. The) 520 W( string may use 8-bit characters if the)135 W 8280 58945 MT (communications parity is type NONE.) 3 W( A) 257 W( special notation is also provided,)4 W /Courier SF 38543 XM (\134b)SH /Times-Roman SF 39997 XM (or)SH /Courier SF 41084 XM (\134B)SH /Times-Roman SF (, which causes a BREAK signal)4 W 8280 60141 MT (to be transmitted.)SH 8280 62533 MT (The string to) 135 W( be transmitted starts with the first non-spacing character after the OUTPUT command and ends at)134 W 8280 63729 MT (either the end of line or,) 94 W( if executed within a TAKE file, at a semicolon \050if you need to output a semicolon from)95 W 8280 64925 MT (within a TAKE file, use backslash notation, e.g. ``)67 W /Courier SF (\13459)SH /Times-Roman SF (''\051. Indirectly) 382 W( obtained strings, the)66 W /Courier SF 45340 XM (@)SH /Times-Italic SF (filespec)SH /Times-Roman SF 49311 XM (form, read the)66 W 8280 66121 MT (first line of the file up to but not including the explicit carriage return.)SH 8280 68513 MT (As a convenience,) 141 W( text arriving at the serial port during the OUTPUT command is shown on the screen if SET)142 W 8280 69709 MT (INPUT-ECHO is ON, and stored in a 128-byte internal buffer for rereading by subsequent \050RE\051INPUT commands.)SH ES %%Page: 98 99 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 98)SH 12 /Times-Bold AF 29785 XM (Kermit User Guide: MS-DOS KERMIT \0505.8\051)SH 46800 50 6120 5709 UL 6120 8004 MT (The PAUSE command)SH 10 /Times-Roman AF 6120 9418 MT (Syntax:)SH /Courier SF 9426 XM (PAUSE [{)SH /Times-Italic SF (number)SH /Courier SF (,)SH /Times-Italic SF 18481 XM (hh:mm:ss)SH /Courier SF (}])SH /Times-Roman SF 6120 11810 MT (PAUSE simply waits one or more seconds, or) 27 W( until the specified time of day, before Kermit executes the next script)26 W 6120 13006 MT (command. Pauses) 496 W( are frequently necessary to avoid) 123 W( overdriving the host and to let a modem proceed through a)124 W 6120 14202 MT (dialing sequence) 105 W( without interruptions from Kermit. The default waiting time is set by SET INPUT DEFAULT-)104 W 6120 15398 MT (TIMEOUT and is normally one second. The optional integer number) 4 W( selects the number of seconds to pause for this)5 W 6120 16594 MT (command, and the)25 W /Times-Italic SF 13805 XM (hh:mm:ss)SH /Times-Roman SF 17968 XM (selects a) 25 W( specific time of day. An explicit value of zero produces a pause of just a few)24 W 6120 17790 MT (milliseconds which can be useful in some situations.)SH 6120 20182 MT (Text arriving during the PAUSE interval is shown on the screen, if SET INPUT-ECHO is ON, and stored) 149 W( in a)150 W 6120 21378 MT (128-byte internal buffer for rereading by a following INPUT command.)SH 6120 23770 MT (PAUSE is interrupted if there is any activity on the keyboard. Thus PAUSE can be useful for operations like:)SH /Courier SF 8520 25425 MT (echo "Type any key when ready...")SH 8520 26456 MT (pause 9999)SH /Times-Roman SF 6120 28848 MT (PAUSE is useful in scripts that are) 25 W( to be executed at some future time. For instance, if you want your PC to dial up)24 W 6120 30044 MT (another computer and transfer some files at 9:30pm, when the phone rates are lower, you can put the command)SH /Courier SF 8520 31699 MT (PAUSE 21:30:00)SH /Times-Roman SF 6120 33416 MT (in your script file. Note that you cannot specify a time more than 12 hours in) 5 W( the future. If you need to pause until a)6 W 6120 34612 MT (specific time that is more than 12 hours away, you can use multiple PAUSE statements:)SH /Courier SF 8520 36267 MT (PAUSE 21:30:00 ; Pause until 9:30pm tonight)SH 8520 37298 MT (PAUSE 9:30:00 ;) 600 W( Pause until 9:30am tomorrow morning)SH 12 /Times-Bold AF 6120 39886 MT (The WAIT Command)SH 10 /Times-Roman AF 6120 41300 MT (Syntax:)SH /Courier SF 9426 XM (WAIT [{)SH /Times-Italic SF (number)SH /Courier SF (,)SH /Times-Italic SF 17881 XM (hh:mm:ss)SH /Courier SF (}] [\134CD] [\134CTS] [\134DSR])SH /Times-Roman SF 6120 43692 MT (WAIT performs a timed PAUSE, as above, but) 110 W( also examines the optional modem control signals Carrier Detect)109 W 6120 44888 MT (\050)SH /Courier SF (\134CD)SH /Times-Roman SF (\051, Clear To Send \050)124 W /Courier SF (\134CTS)SH /Times-Roman SF (\051, and Data Set \050modem\051 Ready \050)124 W /Courier SF (\134DSR)SH /Times-Roman SF (\051. If) 498 W( all) 124 W( of the specified signals are ON, or)125 W 6120 46084 MT (become ON before the timeout interval, the wait operation) 141 W( ceases with an indication of SUCCESS. If the time)140 W 6120 47280 MT (interval expires without all of the specified signals on, the status is FAILURE. Example:)SH /Courier SF 8520 48935 MT (Kermit-MS> wait 12:45:00 \134cd \134dsr)SH /Times-Roman SF 6120 50652 MT (This waits until both CD and DSR asserted or until 45 minutes past noon, whichever) 199 W( happens first, returning)200 W 6120 51848 MT (SUCCESS or FAILURE respectively.)SH 6120 54240 MT (If no modem signals are specified, then WAIT is the same as PAUSE.)SH 12 /Times-Bold AF 6120 56828 MT (Labels and the GOTO Command)SH 10 /Times-Roman AF 6120 58242 MT (Labels and the GOTO) 59 W( command work together in the same fashion as in DOS Batch files. A label is a line which)58 W 6120 59438 MT (starts with a colon \050:\051 in the leftmost column followed immediately by a word of text) 168 W( \050no intervening spaces\051;)169 W 6120 60634 MT (material on the line after the label is ignored. The GOTO command is followed by a label,) 114 W( the leading colon is)113 W 6120 61830 MT (optional in the GOTO command.) 30 W( The) 311 W( label may be located either before or after the GOTO command and is found)31 W 6120 63026 MT (by searching the TAKE) 237 W( file or macro from the beginning. Thus, duplicated labels will always use the first)236 W 6120 64222 MT (occurrence. The) 480 W( target label must be in the current TAKE file or macro; one) 115 W( may not GOTO a label in another)116 W 6120 65418 MT (TAKE file or macro. Example:)SH /Courier SF 8520 67073 MT (:LOOP)SH 8520 68104 MT (echo again and\13413)SH 8520 69135 MT (goto loop)SH /Times-Roman SF 6120 70852 MT (will print "again and again and again and..." forever \050until you type Ctrl-C\051. As a macro:)SH ES %%Page: 99 100 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.8. SCRIPTS)SH 10 /Times-Italic AF 51775 XM (Page 99)SH 46800 50 8280 5709 UL /Courier SF 10680 7824 MT (define test :loop,echo again and\13413,goto loop)SH 10680 8855 MT (do test)SH /Times-Roman SF 8280 10572 MT (Note that if a label follows a comma in a macro definition, there must be no intervening spaces:)SH /Courier SF 10680 12227 MT (define test ..., :top, ..., goto top ; bad, space before colon.)SH 10680 13258 MT (define best ...,:top, ..., goto top) SH( ;) 1200 W( good, no space.)SH /Times-Roman SF 8280 14975 MT (In this example, the best macro will work, the test macro won't.)SH 8280 17367 MT (MS-Kermit searches for the target of a GOTO starting from the top of the TAKE file, or) 11 W( the beginning of the macro,)10 W 8280 18563 MT (in which it occurs. Labels are strictly local to the current TAKE file or macro. You cannot GOTO a label outside of)5 W 8280 19759 MT (the current TAKE file or macro.)SH 12 /Times-Bold AF 8280 22347 MT (The IF Command)SH 10 /Times-Roman AF 8280 23761 MT (Syntax:)SH /Courier SF 11586 XM (IF)SH /Times-Italic SF 13386 XM (test-condition MS-Kermit) 350 W( Command)SH /Times-Roman SF 8280 26153 MT (The IF command gives MS-Kermit scripts the ability to make a decision based upon the criterion specified) 85 W( as the)84 W /Times-Italic SF 8280 27349 MT (test-condition)SH /Times-Roman SF (. If) 576 W( the test) 163 W( condition is true, then the command is executed. Otherwise, it is skipped. The test)164 W 8280 28545 MT (conditions are:)SH 10280 30336 MT (NOT)SH 14280 XM (Modifier for other conditions below.)SH 10280 31913 MT (ALARM)SH 14280 XM (True if the current time of day is at or later than the alarm clock) 21 W( time. The alarm clock time is set by)20 W 14280 33018 MT (the command SET ALARM) 66 W( time. IF ALARM distinguishes early from late with a 12 hour field of)67 W 14280 34123 MT (view.)SH 10280 35700 MT (COUNT)SH 14280 XM (True if the current COUNT variable is greater than zero. COUNT is) 97 W( a special Kermit variable for)96 W 14280 36805 MT (each active TAKE file or macro. It is set by the command SET COUNT and it is both tested and)100 W 14280 37910 MT (modified by the IF COUNT) 97 W( command. The intent is to construct simple script loops where the IF)96 W 14280 39015 MT (COUNT command) 140 W( first decreases COUNT by one \050but never below zero\051 and then if COUNT is)141 W 14280 40120 MT (greater than zero the following Kermit command is executed.) 195 W( Because) 638 W( COUNT exists only for)194 W 14280 41225 MT (TAKE files and macros it cannot be used interactively. Each TAKE file or macro has) 3 W( its own distinct)4 W 14280 42330 MT (copy of COUNT, and nested TAKE files or macros do not interact through their COUNTs.) 47 W( Initially)342 W 14280 43435 MT (COUNT is zero.)SH 10280 45012 MT (DEFINED)SH /Times-Italic SF 14807 XM (symbol)SH /Times-Roman SF 14280 46117 MT (True if the named macro or variable is defined. You can use this feature to) 130 W( remember things for)129 W 14280 47222 MT (future reference.)SH 10280 48799 MT (ERRORLEVEL)SH /Times-Italic SF 17030 XM (number)SH /Times-Roman SF 14280 49904 MT (True if the DOS errorlevel number matches or exceeds the given \050decimal\051 number.)SH 10280 51481 MT (EXIST)SH /Times-Italic SF 13363 XM (filespec)SH /Times-Roman SF 14280 52586 MT (True if the specified file exists.)SH 10280 54163 MT (FAILURE)SH 14280 55268 MT (True if the previous status-returning Kermit command reported failure.)SH 10280 56845 MT (SUCCESS)SH 14280 57950 MT (True if the previous status-returning) 74 W( Kermit command reported success. When using IF SUCCESS)75 W 14280 59055 MT (and IF FAILURE, it is important to SET INPUT TIMEOUT PROCEED,) 121 W( otherwise the script will)120 W 14280 60160 MT (quit immediately upon a failing INPUT or REINPUT, before getting to the IF statement.)SH 8280 62552 MT (IF commands are closely) 100 W( modeled on those of DOS Batch files, for familiarity. They consist of a test condition,)101 W 8280 63748 MT (perhaps modified by the) 92 W( leading word NOT, and then any legal Kermit command. GOTO is an especially useful)91 W 8280 64944 MT (command here to branch in the TAKE file or macro.)SH 8280 67336 MT (The "object" of an IF command is a Kermit command, which can be:)SH /Symbol SF 10070 69241 MT (\267)SH /Times-Roman SF 10780 XM (A regular, predefined Kermit command, like)SH /Courier SF 28887 XM (SEND FOO.BAR)SH /Times-Roman SF 36337 XM (or)SH /Courier SF 37420 XM (SET SPEED 1200)SH /Times-Roman SF (.)SH /Symbol SF 10070 71230 MT (\267)SH /Times-Roman SF 10780 XM (A GOTO, allowing subsequent statements to be skipped.)SH ES %%Page: 100 101 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 100)SH 12 /Times-Bold AF 29785 XM (Kermit User Guide: MS-DOS KERMIT \0505.8\051)SH 46800 50 6120 5709 UL 10 /Symbol AF 7910 8000 MT (\267)SH /Times-Roman SF 8620 XM (Another IF command,) 133 W( as in)134 W /Courier SF 20509 XM (IF DEFINED \134%3 IF EXIST FOO.BAR SEND FOO.BAR)134 W /Times-Roman SF (. The)518 W 8620 9105 MT (SEND command is executed only if both IF conditions are true.)SH /Symbol SF 7910 11094 MT (\267)SH /Times-Roman SF 8620 XM (A macro. This allows) 166 W( a semblence of structured programming, with an implied "begin" and "end")165 W 8620 12199 MT (around the commands that compose the macro. For instance:)SH /Courier SF 11020 13854 MT (define giveup echo I give up!, hangup, stop)SH 11020 14885 MT (input 10 Login:)SH 11020 15916 MT (if failure giveup)SH 11020 16947 MT (output myusername)SH /Times-Roman SF 6120 19339 MT (The Kermit commands which yield SUCCESS) 15 W( or FAILURE conditions are: GET, SEND, RECEIVE, the REMOTE)16 W 6120 20535 MT (commands, INPUT, REINPUT, BYE, FINISH, LOGOUT, and WAIT.)SH 12 /Times-Bold AF 6120 23123 MT (The POP and STOP Commands)SH 10 /Times-Roman AF 6120 24537 MT (Use these commands for terminating execution of a TAKE file or macro. POP terminates the current) 133 W( level and)132 W 6120 25733 MT (returns to the previous level. For example, if you gave the command "take shower", and the SHOWER file)214 W 6120 26929 MT (contained a command "take bath", and the BATH file contained a command "take hike", and a POP) 50 W( command was)49 W 6120 28125 MT (encountered in the HIKE file, then the next command executed would be) 241 W( the one following the "take hike")242 W 6120 29321 MT (command in the BATH file. If) 68 W( a STOP command was encountered in any of these files, MS-Kermit would return)67 W 6120 30517 MT (immediately to interactive command level. POP and STOP) 41 W( work in similar fashion with nested macro invocations:)42 W 6120 31713 MT (POP returns to the invoking macro, STOP returns to command level.)SH 12 /Times-Bold AF 6120 34301 MT (Script Examples)SH 10 /Times-Roman AF 6120 35715 MT (A counting loop. This TAKE file excerpt says hello three times, then says goodbye:)SH /Courier SF 8520 37370 MT (set count 3) SH( ;) 7200 W( Prime the loop counter for three passes)SH 8520 38401 MT (:TOP ;) 11400 W( A label for GOTO)SH 8520 39432 MT (echo Hello\13413) SH( ;) 6000 W( Something to see, with carriage return)SH 8520 40463 MT (if count goto top) SH( ;) 3600 W( Loop if COUNT is greater than zero)SH 8520 41494 MT (echo Goodbye!\13413)SH /Times-Roman SF 6120 43886 MT (Figure 5-2 shows a simple script file that logs in to a computer, prompting the) 9 W( user for her password using the)8 W /Courier SF 50520 XM (@con)SH /Times-Roman SF 6120 45082 MT (construction, and then connects as a terminal. Notice the semicolons used to indicate comments in) 51 W( TAKE files. If)52 W 46800 50 6120 47073 UL /Courier SF 8520 49852 MT (define ermsg echo %\1341\13413, stop) SH( ;) 3600 W( Define an error handling macro.)SH 8520 50883 MT (clear ;) 18600 W( Clear the input buffer.)SH 8520 51914 MT (set speed 9600) SH( ;) 13200 W( Set the transmission speed.)SH 8520 52945 MT (output \13413) SH( ;) 15600 W( Carriage return to awaken host.)SH 8520 53976 MT (input 15 Login:) SH( ;) 12600 W( Wait up to 15 secs for prompt.)SH 8520 55007 MT (if failure ermsg No_login_prompt!) SH( ;) 1800 W( Give up if none.)SH 8520 56038 MT (output Sari\13413) SH( ;) 13200 W( Send username and CR.)SH 8520 57069 MT (set input echo off) SH( ;) 10800 W( Privacy, please.)SH 8520 58100 MT (input 5 Password:) SH( ;) 11400 W( Quietly wait for this.)SH 8520 59131 MT (if failure ermsg No_password_prompt! ; Give up if it doesn't come.)SH 8520 60162 MT (echo Type your password now...) SH( ;) 3600 W( Make our own prompt.)SH 8520 61193 MT (output @CON) SH( ;) 15000 W( Send console keystrokes.)SH 8520 62224 MT (output \13413) SH( ;) 15600 W( Add a real carriage return.)SH 8520 63255 MT (input 30 $) SH( ;) 15600 W( Wait for system prompt.)SH 8520 64286 MT (if failure ermsg No_system_prompt!) SH( ;) 1200 W( Give up if none.)SH 8520 65317 MT (connect ;) 17400 W( Start terminal emulation.)SH /Times-Bold SF 20201 67034 MT (Figure 5-2:)SH /Times-Roman SF 25450 XM (MS-Kermit Script for Logging In)SH 46800 50 6120 68844 UL 6120 70435 MT (these same commands) 18 W( were typed by hand at the Kermit prompt the semicolon material would be considered part of)17 W 6120 71631 MT (a string! Typing a Control-C will interrupt and terminate any of the commands.)SH ES %%Page: 101 102 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.8. SCRIPTS)SH 10 /Times-Italic AF 51275 XM (Page 101)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (Figure 5-3 illustrates some detailed control of the Hayes modem. Some understanding of the Hayes) 236 W( dialing)237 W 8280 9082 MT (language is helpful for deciphering this script \050consult your Hayes modem manual\051. If the script is stored in a) 64 W( file)63 W 8280 10278 MT (called)SH /Courier SF 10918 XM (HAYES.SCR)SH /Times-Roman SF (, then a DIAL macro can be defined like this:)SH /Courier SF 10680 11933 MT (define dial take hayes.scr)SH /Times-Roman SF 8280 13650 MT (The trick here is that any invocation of the "dial") 49 W( or "do dial" command with an operand will set the variable)50 W /Courier SF 53030 XM (\134%1)SH /Times-Roman SF (,)SH 8280 14846 MT (which is used in the TAKE file, for instance:)SH /Courier SF 10680 16501 MT (dial 765-4321)SH /Times-Roman SF 8280 18218 MT (will set)SH /Courier SF 11447 XM (\134%1)SH /Times-Roman SF 13497 XM (to "765-4321", the number to be dialed.)SH 8280 20610 MT (A combination of) 30 W( DOS Batch and Kermit Script files is shown in Figures 5-4 and 5-5 \050see your DOS manual for an)29 W 8280 21806 MT (explanation of the batch file syntax\051.) 43 W( The) 337 W( purpose is to allow a user to say ``)44 W /Courier SF (SEND)SH /Times-Italic SF 42711 XM (filename)SH /Times-Roman SF ('' at the DOS prompt.)44 W 8280 23002 MT (The DOS batch shell,)39 W /Courier SF 17296 XM (SEND.BAT)SH /Times-Roman SF (, and the login script,)39 W /Courier SF 30985 XM (KX)SH /Times-Roman SF (, are combined to login to a VAX through) 39 W( a data switch,)38 W 8280 24198 MT (run VMS Kermit in server mode, transfer the file, submit it to VMS Mail, delete the) 42 W( disk file, shut down the server)43 W 8280 25394 MT (and logout from the VAX, and report the overall transfer status.) 255 W( The) 758 W( user is asked to provide a password)254 W 8280 26590 MT (interactively.)SH 14 /Times-Bold AF 8280 30192 MT (5.9. Initialization Files Revisited)SH 10 /Times-Roman AF 8280 32310 MT (At Columbia University, we have IBM 370-series mainframes running VM/CMS,) 136 W( DECSYSTEM-20 mainframes)137 W 8280 33506 MT (running TOPS-20, a VAX 8700 running Unix. All of these systems are accessible through a Gandalf) 85 W( PACX port)84 W 8280 34702 MT (contention unit. The) 40 W( IBM systems have two different kinds of front ends, a COMTEN 3695 \050similar to IBM 3705\051)41 W 8280 35898 MT (for linemode half-duplex connections, and various Series/1-style protocol converters \050including the 7171 and 4994\051)45 W 8280 37094 MT (for full-screen, full-duplex 3270 emulation, all of which use various combinations) 183 W( of parity and other settings.)184 W 8280 38290 MT (Figure 5-6 shows) 188 W( an)187 W /Courier SF 17418 XM (MSKERMIT.INI)SH /Times-Roman SF 25055 XM (file composed by Vace Kundakci of Columbia to automate the task of)187 W 8280 39486 MT (switching his PC/AT among all) 43 W( these systems. It illustrates the creative use of macros and scripts. Numerous site-)44 W 8280 40682 MT (and system-dependent key definitions have been omitted.)SH 8280 43074 MT (A bit of explanation might clarify some of this. PACX is) 13 W( our port contention unit. Its output appears in even parity.)12 W 8280 44270 MT (It prompts us to "Enter node name =>", and we respond with the name of) 107 W( one of our systems or front ends, like)108 W 8280 45466 MT (CU20B or CU20D) 123 W( \050DEC-20s\051, SIMA or SIMB \0507171s\051, CUVMA or CUVMB \050IBM mainframes front ended by)122 W 8280 46662 MT (COMTEN\051, or CUNIXC \050a VAX\051. To connect to a given system, Vace types) 45 W( "do cu20b" or "do sima" to invoke a)46 W 8280 47858 MT ("connecting" macro. Each of these, in turn, invokes) 41 W( the PACX macro to navigate through the PACX to the desired)40 W 8280 49054 MT (system, and then invokes the appropriate macro \0503695, 7171, etc\051 to get past any associated front end \050e.g. to tell the)14 W 8280 50250 MT (COMTEN which IBM mainframe is wanted, or to tell the protocol) 36 W( converter what terminal to emulate\051, and then to)35 W 8280 51446 MT (login on the desired system, prompting on the screen for user ID and password. Finally, a macro like) 73 W( "vml" \050VM)74 W 8280 52642 MT (linemode\051, "xed" \050XEDIT, i.e. VM full screen\051, or "dec" \050DEC-20 or) 86 W( VAX\051 is executed to set the communication)85 W 8280 53838 MT (parameters for the system just logged in to. The key definitions that are shown in) 144 W( the "vml", "xed", and "dec")145 W 8280 55034 MT (macros assign the host's character deletion code \050backspace or rubout\051 to the AT's backarrow key.)SH 14 /Times-Bold AF 8280 58636 MT (5.10. MS-Kermit Features for Different Systems)SH 10 /Times-Roman AF 8280 60754 MT (As noted early on, MS-Kermit was designed primarily for the IBM PC family, and later) 242 W( adapted to various)241 W 8280 61950 MT (non-IBM-compatible MS-DOS) 249 W( \050and even non-MS-DOS\051 systems. Some of these adaptations provide all the)250 W 8280 63146 MT (features of the IBM PC version, others provide only a subset, and still others may) 50 W( include features not available on)49 W 8280 64342 MT (the IBM family. These features are all of the) 46 W( system-dependent variety; the Kermit file transfer protocol should be)47 W 8280 65538 MT (implemented identically on all versions of MS-Kermit. The most obvious) 42 W( differences are in the terminal emulation)41 W 8280 66734 MT (options and the keyboards. Table 5-7 shows the terminal emulation options for) 47 W( the systems presently supported by)48 W 8280 67930 MT (Kermit-MS, and Table) 135 W( 5-8, shows which keys are used for screen rollback on the various systems supported by)134 W 8280 69126 MT (MS-Kermit.)SH 8280 71518 MT (Another difference) 14 W( is the default communication port, the number of communication ports supported, and the names)15 W ES %%Page: 102 103 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 102)SH 12 /Times-Bold AF 29185 XM (Kermit User Guide: MS-DOS KERMIT \0505.10\051)SH 46800 50 6120 5709 UL 10 /Courier AF 8520 7824 MT (if defined \134%1 goto start) SH( ;) 6600 W( Make sure number specified.)SH 8520 8855 MT (echo Please supply a phone number!\13413)SH 8520 9886 MT (stop)SH 8520 10917 MT (:START)SH 8520 11948 MT (clear ;) 18600 W( Clear the input buffer.)SH 8520 12979 MT (set speed 2400) SH( ;) 13200 W( Dial at high speed.)SH 8520 14010 MT (wait 10 \134dsr) SH( ;) 14400 W( Is modem turned on?)SH 8520 15041 MT (if success goto init)SH 8520 16072 MT (echo Please turn on your modem.\13413) SH( ;) 1200 W( It's not, complain,)SH 8520 17103 MT (stop ;) 19200 W( and exit the script.)SH 8520 18134 MT (:INIT)SH 8520 19165 MT (echo Initializing modem...\13413\13410) SH( ;) 2400 W( Modem is turned on.)SH 8520 20196 MT (output ATZ F1 Q0 V1 X4 S0=0\13413) SH( ;) 3600 W( Initialize the modem.)SH 8520 21227 MT (input 5 OK) SH( ;) 15600 W( Get its response.)SH 8520 22258 MT (if success goto dial) SH( ;) 9600 W( If OK, go ahead and dial)SH 8520 23289 MT (echo Can't initialize the modem!\13413 ; Not OK, give up.)SH 8520 24320 MT (stop)SH 8520 25351 MT (:DIAL ;) 18600 W( Ready to dial.)SH 8520 26382 MT (set count 5) SH( ;) 15000 W( Set the redial limit.)SH 8520 27413 MT (define \134%d \13413Dialing) SH( ;) 9000 W( Initial dial message.)SH 8520 28444 MT (:REDIAL)SH 8520 29475 MT (echo \134%d \134%1...\13413) SH( ;) 10800 W( Tell them we're dialing.)SH 8520 30506 MT (output ATDT \134%1\13413) SH( ;) 10800 W( Dial the phone number.)SH 8520 31537 MT (clear ;) 18600 W( Clear away the command echo.)SH 8520 32568 MT (input 30 CONNECT) SH( ;) 12000 W( Wait for CONNECT message.)SH 8520 33599 MT (if success goto speed) SH( ;) 9000 W( Got it, go check speed.)SH 8520 34630 MT (define \134%m No dialtone or no answer. ; Make this the error message.)SH 8520 35661 MT (reinput BUSY) SH( ;) 14400 W( Didn't connect. Was it busy?)SH 8520 36692 MT (if failure goto later) SH( ;) 9000 W( No, something else.)SH 8520 37723 MT (Echo \13413Busy...) SH( ;) 12600 W( It's busy, let them know.)SH 8520 38754 MT (pause 60) SH( ;) 16800 W( Wait one minute.)SH 8520 39785 MT (define \134%d \13413Redialing) SH( ;) 7800 W( Change message to "Redialing".)SH 8520 40816 MT (if count goto redial) SH( ;) 9600 W( Then go redial.)SH 8520 41847 MT (define \134%m \13413Line busy.) SH( ;) 7200 W( After 5 tries set this message.)SH 8520 42878 MT (:LATER ;) 18000 W( Get here upon giving up.)SH 8520 43909 MT (echo \134%m\13410\13413Try again later.\13413) SH( ;) 1800 W( Issue error message.)SH 8520 44940 MT (stop ;) 19200 W( Exit from the script.)SH 8520 45971 MT (:SPEED ;) 18000 W( Connected!)SH 8520 47002 MT (pause 1) SH( ;) 17400 W( Wait for text after CONNECT.)SH 8520 48033 MT (define \134%s 2400) SH( ;) 12600 W( Assume speed is 2400.)SH 8520 49064 MT (reinput 1 2400) SH( ;) 13200 W( Rescan current text for "2400")SH 8520 50095 MT (if success goto done) SH( ;) 9600 W( It is.)SH 8520 51126 MT (define \134%s 1200) SH( ;) 12600 W( It isn't, so assume 1200.)SH 8520 52157 MT (reinput 1 1200) SH( ;) 13200 W( Is it?)SH 8520 53188 MT (if failure define \134%s 300) SH( ;) 6600 W( It isn't, so it must be 300.)SH 8520 54219 MT (:DONE ;) 18600 W( We know the speed.)SH 8520 55250 MT (set speed \134%s) SH( ;) 13800 W( So set it.)SH 8520 56281 MT (echo Connecting at \134%s bps...\13413) SH( ;) 2400 W( Tell the user.)SH 8520 57312 MT (connect ;) 17400 W( And start terminal emulation.)SH /Times-Bold SF 13813 59029 MT (Figure 5-3:)SH /Times-Roman SF 19062 XM (MS-Kermit Script for More Control of a Hayes 2400 bps Modem)SH 46800 50 6120 60839 UL 6120 62430 MT (given to them. For instance, the IBM) 255 W( PC family supports COM1 and COM2, and uses COM1 by default.)254 W 6120 63626 MT (MS-Kermit may be persuaded) 75 W( to support higher-numbered IBM ports using the method outlined in section 5.17.3.)76 W 6120 64822 MT (For remote operation, IBM's name) 47 W( for the console is CON, so if you CTTY COM1, you do CTTY CON to put the)46 W 6120 66018 MT (PC back to normal.)SH ES %%Page: 103 104 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.10. MS-Kermit Features for Different Systems)SH 10 /Times-Italic AF 51275 XM (Page 103)SH 46800 50 8280 5709 UL 46800 50 8280 8086 UL /Times-Roman SF 8280 10406 MT (File)SH /Courier SF 10086 XM (SEND.BAT)SH /Times-Roman SF (, DOS batch program:)SH /Courier SF 10680 12061 MT (echo off)SH 10680 13092 MT (Rem Kermit, one-line file mailer, by Joe Doupnik.)SH 10680 14123 MT (Rem Logon to VAX, run Kermit, Send user's file,)SH 10680 15154 MT (Rem post) 600 W( via MAIL, logout from VAX.)SH 10680 16185 MT (if ".%2" == "." goto usage)SH 10680 17216 MT (if exist %1 goto proceed)SH 10680 18247 MT (echo No file to send!)SH 10680 19278 MT (:usage)SH 10680 20309 MT (echo Usage is SEND filename username)SH 10680 21340 MT (goto done)SH 10680 22371 MT (:proceed)SH 10680 23402 MT (echo Logging onto the Vax ...)SH 10680 24433 MT (kermit set disp q,take kx,send %1,pau,rem host mail %1 %2,pau 2,bye,)SH 10680 25464 MT (if errorlevel 3 goto badrem)SH 10680 26495 MT (if errorlevel 2 goto badrcv)SH 10680 27526 MT (if errorlevel 1 goto badsnd)SH 10680 28557 MT (echo File\050s\051 "%1" has been mailed to %2.)SH 10680 29588 MT (goto done)SH 10680 30619 MT (:badrem)SH 10680 31650 MT (echo Mail did not cooperate!)SH 10680 32681 MT (:badrcv)SH 10680 33712 MT (echo Receive failed!)SH 10680 34743 MT (goto done)SH 10680 35774 MT (:badsnd)SH 10680 36805 MT (echo Send failed!)SH 10680 37836 MT (goto done)SH 10680 38867 MT (:done)SH 10680 39898 MT (echo on)SH /Times-Bold SF 17583 41615 MT (Figure 5-4:)SH /Times-Roman SF 22832 XM (MS-DOS Batch File Invoking Kermit to Send VAX Mail)SH 46800 50 8280 43425 UL 12 /Times-Bold AF 8280 45813 MT (The DEC Rainbow)SH 10 /Times-Roman AF 8280 47227 MT (The DEC Rainbow version of MS-Kermit 2.31 uses the built-in VT102 terminal) 16 W( firmware and setup modes, and can)17 W 8280 48423 MT (operate at speeds up to 9600 baud. It has) 2 W( no 25th screen line, and therefore no Kermit mode line during CONNECT.)1 W 8280 49619 MT (It supports only the Rainbow's single communication port, and) 44 W( not the printer port, so SET PORT for the Rainbow)45 W 8280 50815 MT (is not implemented \050but of course) 55 W( the printer may be used for printing.\051 The Rainbow may be put in remote mode)54 W 8280 52011 MT (by CTTY AUX, and returned to normal with CTTY SCRN. The Rainbow) 175 W( supports several SET TERMINAL)176 W 8280 53207 MT (commands: VT102, VT52, and ROLL.)SH 8280 55599 MT (The keypad and cursor keys all work properly in VT102 and VT52 modes and in application as well as native) 21 W( states)20 W 8280 56795 MT (\050they never had in previous versions\051. Newline mode is activated) 37 W( for received characters \050LF ==> CR/LF\051. Screen)38 W 8280 57991 MT (roll back is almost 11 screenfuls. Table 5-9 shows the verb names and default key) 88 W( assignments for the Rainbow.)87 W 8280 59187 MT (On the main typewriter keyboard the shifted comma and period are converted to special keys available for) 48 W( Set Key)49 W 8280 60383 MT (assignment without impacting the normal unshifted ASCII actions; Shift Lock has no effect on these keys.)SH 12 /Times-Bold AF 8280 62971 MT (The DECmate II)SH 10 /Times-Roman AF 8280 64385 MT (MS-Kermit for the DECmate II with) 161 W( the XPU option is somewhat similar to Rainbow Kermit. It uses built-in)160 W 8280 65581 MT (terminal VT100 firmware and setup modes and baud rates up to 9600) 4 W( on the single communication port. The printer)5 W 8280 66777 MT (port is not available for communications in this version.) 24 W( There) 297 W( is no mode line, but other connect-mode escapes are)23 W 8280 67973 MT (supported, including sending BREAK. Disks A through I are supported,) 73 W( and the floppy disk format is compatible)74 W 8280 69169 MT (with the Rainbow. DEC utilities are available for file conversion between DOS and WPS-8 files.)SH ES %%Page: 104 105 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 104)SH 12 /Times-Bold AF 29185 XM (Kermit User Guide: MS-DOS KERMIT \0505.10\051)SH 46800 50 6120 5709 UL 46800 50 6120 8086 UL 10 /Times-Roman AF 6120 10406 MT (File KX, Kermit script:)SH /Courier SF 8520 12061 MT (Comment Login script for VAXA via Micom data PBX Switch.)SH 8520 13092 MT (set input timeout quit)SH 8520 14123 MT (set input echo off)SH 8520 15154 MT (set display quiet)SH 8520 16185 MT (output \13413)SH 8520 17216 MT (comment - "slowly." and "CLASS" are part of the switch's prompt.)SH 8520 18247 MT (input 10 slowly.)SH 8520 19278 MT (input 10 CLASS)SH 8520 20309 MT (pause)SH 8520 21340 MT (comment - Slowly tell switch "vaxa", wait for beep.)SH 8520 22371 MT (output v)SH 8520 23402 MT (output a)SH 8520 24433 MT (output x)SH 8520 25464 MT (output a)SH 8520 26495 MT (output \13413)SH 8520 27526 MT (pause)SH 8520 28557 MT (input 5 \1347)SH 8520 29588 MT (comment - Done with Switch, wake up the VAX and log in.)SH 8520 30619 MT (pause)SH 8520 31650 MT (output \13413)SH 8520 32681 MT (pause)SH 8520 33712 MT (input 5 Username:)SH 8520 34743 MT (set input timeout proceed)SH 8520 35774 MT (output MYNAME\13413)SH 8520 36805 MT (input 2 Password:)SH 8520 37836 MT (comment - Prompt ourselves, then get password from console.)SH 8520 38867 MT (echo Enter password:)SH 8520 39898 MT (output @con)SH 8520 40929 MT (comment - Send a carriage return at the end of the password.)SH 8520 41960 MT (output \13413)SH 8520 42991 MT (comment - Expect ESC Z from the VAX's Set Term/Inquire...)SH 8520 44022 MT (comment - Respond ESC [ 6 c) SH( \050say) 1200 W( we are VT102\051.)SH 8520 45053 MT (comment - Note syntax for including question mark!)SH 8520 46084 MT (input 15 \13427Z)SH 8520 47115 MT (output \13427[\134{63}6c)SH 8520 48146 MT (comment Look for VMS dollar sign prompt)SH 8520 49177 MT (input 15 $)SH 8520 50208 MT (comment Start VMS Kermit and place it in server mode)SH 8520 51239 MT (output kermit server\13413)SH 8520 52270 MT (comment - allow server's message to finish, "machine." appears twice.)SH 8520 53301 MT (input 10 machine.)SH 8520 54332 MT (input 10 machine.)SH 8520 55363 MT (pause)SH /Times-Bold SF 14951 57080 MT (Figure 5-5:)SH /Times-Roman SF 20200 XM (MS-Kermit Script for Logging into VAX and Sending Mail)SH 46800 50 6120 58890 UL 12 /Times-Bold AF 6120 61278 MT (The NEC APC3)SH 10 /Times-Roman AF 6120 62692 MT (The NEC APC3 version of MS-Kermit assumes that the)169 W /Courier SF 30334 XM (ANSI.SYS)SH /Times-Roman SF 35553 XM (driver has been installed and that a color)168 W 6120 63888 MT (monitor is being used; the color graphics option is not used by Kermit. Although the) 118 W( display should be entirely)119 W 6120 65084 MT (sensible with a monochrome system, it has not been tested. Differences from the IBM PC version include:)SH 6120 67476 MT (SET BAUD: The useful baud rates supported range from 300 to 9600.)SH 6120 69868 MT (SET PORT: The available ports are 1, 2, 3, or their equivalents AUX, AUX2, AUX3.)SH ES %%Page: 105 106 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.10. MS-Kermit Features for Different Systems)SH 10 /Times-Italic AF 51275 XM (Page 105)SH 46800 50 8280 5709 UL 46800 50 8280 8086 UL /Courier SF 10680 10865 MT (; MSKERMIT.INI for IBM PC/AT Kermit 2.31, by Vace Kundakci)SH 10680 12927 MT (COMMENT - INPUT command defaults for scripts)SH 10680 13958 MT (set inp tim quit)SH 10680 14989 MT (set inp echo off)SH 10680 16020 MT (set inp case observe)SH 10680 18082 MT (COMMENT - Macros for connecting to PACX and selecting various systems)SH 10680 19113 MT (def cu20b do pacx,o cu20b\13413,do 2065)SH 10680 20144 MT (def cu20d do pacx,o cu20d\13413,do 2065)SH 10680 21175 MT (def sima do pacx,o sima\13413,do 7171)SH 10680 22206 MT (def simb do pacx,o simb\13413,do 4994)SH 10680 23237 MT (def cunixc do pacx,o cunixc\13413,do 8700)SH 10680 24268 MT (def cuvma do pacx,o cuvm\13413,do 3695,o vma\13413,do 3083)SH 10680 25299 MT (def cuvmb do pacx,o cuvm\13413,do 3695,o vmb\13413,do 3083)SH 10680 27361 MT (COMMENT - Macros for logging in to various systems.)SH 10680 28392 MT (def pacx cle,set par e,o \13413,i 5 Enter node name =>\13432,pau)SH 10680 29423 MT (def 3695 i 5 SWITCHING CHARACTERS:\13432\13432)SH 10680 30454 MT (def 3083 i 5 ONLINE,o L\13432,do pwd,do vml,c)SH 10680 31485 MT (def 8700 i 5 login:\13432,do pwd,do dec,c)SH 10680 32516 MT (def 2065 i 5 \13413\13410\13464,o ter vt102\13413,do pwd,do dec,c)SH 10680 33547 MT (def 7171 pau,cle,o \13413,i 5 TERMINAL TYPE:\13432,o vt-100\13413,do 3270)SH 10680 34578 MT (def 4994 pau,cle,o \13413,i 5 terminal type:\13432,pau,o vt100\13413,do 3270)SH 10680 35609 MT (def 3270 pau,cle,o \13413,o L\13432,do pwd,do xed,c)SH 10680 37671 MT (COMMENT - Macros for communicating with various systems)SH 10680 38702 MT (def vml set par m,set k \134270 \1348,set k \1343 \134Kbreak,do tty)SH 10680 39733 MT (def xed set par e,set k \134270 \1348,set k \1343,do def)SH 10680 40764 MT (def dec set par n,set k \134270 \134127,set k \1343,do def)SH 10680 41795 MT (def def set tim of,set loc of,set ter wr of,set han non,set flo xon)SH 10680 42826 MT (def tty set tim on,set loc on,set ter wr on,set han xon,set flo non)SH 10680 44888 MT (COMMENT - Macro for obtaining user ID and password)SH 10680 45919 MT (def pwd echo user:,o @con,o \13413, echo Password:,o @con,o \13413)SH /Times-Bold SF 20278 47636 MT (Figure 5-6:)SH /Times-Roman SF 25527 XM (An Advanced MS-Kermit Initialization File)SH 46800 50 8280 49446 UL 8280 51638 MT (SET TERMINAL COLOR: Instead of specifying colors by number, the words) 32 W( BLUE, RED, MAGENTA, GREEN,)31 W 8280 52834 MT (CYAN, YELLOW, or WHITE are appropriate. This is the color of the text in) 19 W( connect mode; background colors are)20 W 8280 54030 MT (not available. Monochrome monitors will) 19 W( respond with display changing from most dim to most bright if the colors)18 W 8280 55226 MT (are specified in the order given.)SH 8280 57618 MT (SET TERMINAL KEYCLICK: Not implemented in Kermit; use the NEC provided command.)SH 8280 60010 MT (SET TERMINAL SCREEN-BACKGROUND: Not implemented.)SH 8280 62402 MT (During terminal) 75 W( emulation, screen scroll is handled by the PgUp and PgDn keys. If used in combination with the)76 W 8280 63598 MT (Ctrl key, the display moves but one line. If) 50 W( used in combination with the Fnc key, the display scrolls to the end of)49 W 8280 64794 MT (the buffer. The Fnc-INS combination toggles the) 19 W( mode line on/off. The Fnc-DEL combination toggles the terminal)20 W 8280 65990 MT (emulation type. The Fnc-Break) 7 W( combination resets the emulator. The Help key pulls down the connect mode menu.)6 W 8280 67186 MT (The ANSI escape sequence for disable/enable cursor is implemented.)SH ES %%Page: 106 107 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 106)SH 12 /Times-Bold AF 29185 XM (Kermit User Guide: MS-DOS KERMIT \0505.11\051)SH 46800 50 6120 5709 UL 46800 50 6120 8086 UL 10 /Times-Roman AF 7120 11001 MT (System)SH 17920 XM (EscChar)SH 25120 XM (Capabilities)SH 34480 XM (Terminal Service)SH 2945 50 7120 11201 UL 3388 50 17920 11201 UL 4778 50 25120 11201 UL 6915 50 34480 11201 UL 7120 12106 MT (ACT Apricot)SH /Courier SF 18420 XM (^])SH 28720 XM (K)SH /Times-Roman SF 34480 XM (VT52 ???)SH 7120 13211 MT (DEC Rainbow)SH /Courier SF 18420 XM (^])SH 25120 XM (R P) 1200 W( K D)SH /Times-Roman SF 34480 XM (VT102 firmware)SH 7120 14316 MT (DECmate/DOS)SH /Courier SF 18420 XM (^])SH 28720 XM (K)SH /Times-Roman SF 34480 XM (VT100)SH 7120 15421 MT (Generic DOS)SH /Courier SF 18420 XM (^])SH 28720 XM (K)SH /Times-Roman SF 34480 XM (Depends on system)SH 7120 16526 MT (Grid Compass)SH /Courier SF 18420 XM (^])SH 28720 XM (K)SH /Times-Roman SF 34480 XM (???)SH 7120 17631 MT (HP-110)SH /Courier SF 18420 XM (^])SH 28720 XM (K)SH /Times-Roman SF 34480 XM (Dumb terminal)SH 7120 18736 MT (HP-150)SH /Courier SF 18420 XM (^])SH 25120 XM (R K)2400 W /Times-Roman SF 34480 XM (HP-2623 firmware)SH 7120 19841 MT (IBM PC family)SH /Courier SF 18420 XM (^])SH 25120 XM (R M P K D)SH /Times-Roman SF 34480 XM (H19,VT52,VT102,Tek emulation)SH 7120 20946 MT (Intel 3xx)SH /Courier SF 18420 XM (^])SH 28720 XM (K)SH /Times-Roman SF 34480 XM (Uses real terminal)SH 7120 22051 MT (NEC 9801)SH /Courier SF 18420 XM (^])SH 26320 XM (M P K D)SH /Times-Roman SF 34480 XM (VT102, Tektronix emulation)SH 7120 23156 MT (NEC APC3)SH /Courier SF 18420 XM (^])SH 25120 XM (R M P K D)SH /Times-Roman SF 34480 XM (H19,VT52,VT102 emulation)SH 7120 24261 MT (NEC APC)SH /Courier SF 18420 XM (^])SH 25120 XM (R P) 1200 W( K)SH /Times-Roman SF 34480 XM (VT100, ADM3A firmware)SH 7120 25366 MT (Olivetti M24)SH /Courier SF 18420 XM (^])SH 25120 XM (R M P K D)SH /Times-Roman SF 34480 XM (Same as IBM PC)SH 7120 26471 MT (Sanyo MBC55x)SH /Courier SF 18420 XM (^])SH 25120 XM (R M P K D)SH /Times-Roman SF 34480 XM (H19,VT52,VT102 emulation)SH 7120 27576 MT (Wang PC)SH /Courier SF 18420 XM (^A)SH 28720 XM (K)SH /Times-Roman SF 34480 XM (Wang firmware)SH 7120 28681 MT (TI Pro)SH /Courier SF 18420 XM (^])SH 26320 XM (M P K)SH /Times-Roman SF 34480 XM (VT100/Tektronix)SH 7120 29786 MT (Victor 9000)SH /Courier SF 18420 XM (Alt-])SH 26320 XM (M P K D)SH /Times-Roman SF 34480 XM (H19,VT52,VT102 and/or Tek4010)SH 7120 30891 MT (Zenith Z100)SH /Courier SF 18420 XM (^])SH 28720 XM (K)SH /Times-Roman SF 34480 XM (Heath-19 emulation)SH /Courier SF 13042 32682 MT (R)SH /Times-Roman SF (=Rollback,)SH /Courier SF 18317 XM (M)SH /Times-Roman SF (=Modeline,)SH /Courier SF 23814 XM (P)SH /Times-Roman SF (=Printer control,)SH /Courier SF 31283 XM (K)SH /Times-Roman SF (=Key redefinition,)SH /Courier SF 39529 XM (D)SH /Times-Roman SF (=screen Dump)SH /Times-Bold SF 18909 34292 MT (Table 5-7:)SH /Times-Roman SF 23770 XM (Kermit-MS Terminal Emulation Options)SH 46800 50 6120 36102 UL 46800 50 6120 37893 UL 6120 40627 MT (System)SH 13320 XM (Screen Down)SH 23400 XM (Line Down)SH 34920 XM (Screen Up)SH 43560 XM (Line Up)SH 2945 50 6120 40827 UL 5415 50 13320 40827 UL 4527 50 23400 40827 UL 4193 50 34920 40827 UL 3305 50 43560 40827 UL 6120 41732 MT (IBM PC)SH 13320 XM (PgUp)SH 23400 XM (Ctrl-PgUp)SH 34920 XM (PgDn)SH 43560 XM (Ctrl-PgDn)SH 6120 42837 MT (Rainbow)SH 13320 XM (PrevScreen)SH 23400 XM (Ctrl-PrevScreen)SH 34920 XM (NextScreen)SH 43560 XM (Ctrl-NextScreen)SH 6120 43942 MT (HP-150)SH 13320 XM (Prev)SH 23400 XM (Shift-UpArrow)SH 34920 XM (Next)SH 43560 XM (Shift-DownArrow)SH 6120 45047 MT (NEC APC)SH 13320 XM (Uparrow)SH 23400 XM (Ctrl-UpArrow)SH 34920 XM (DownArrow)SH 43560 XM (Ctrl-DownArrow)SH 6120 46152 MT (NEC APC3)SH 13320 XM (PgUp)SH 23400 XM (Ctrl-PgUp)SH 34920 XM (PgDn)SH 43560 XM (Ctrl-PgDn)SH 6120 47257 MT (Sanyo 55x)SH 13320 XM (PgUp)SH 23400 XM (Ctrl-RtArrow)SH 34920 XM (PgDn)SH 43560 XM (Ctrl-PgDn)SH 6120 48867 MT (The IBM PC also allows use of the Home key to get to the top of its display) 104 W( memory and End key to get to the)105 W 6120 50063 MT (bottom, and the keypad) 50 W( minus \050)49 W /Courier SF (-)SH /Times-Roman SF (\051 key to toggle the mode line on and off. The Rainbow uses Shift-Next-Screen to)49 W 6120 51259 MT (get to the bottom of its display memory, but provides no key for moving directly to the top.)SH /Times-Bold SF 20826 52869 MT (Table 5-8:)SH /Times-Roman SF 25687 XM (Kermit-MS Screen Scroll Keys)SH 46800 50 6120 54679 UL 14 /Times-Bold AF 6120 58081 MT (5.11. Compatibility with Older Versions of MS-DOS Kermit)SH 10 /Times-Roman AF 6120 60199 MT (The last monolithic \050single source file\051 release of MS-DOS) 3 W( Kermit was 1.20. Meanwhile, implementations based on)4 W 6120 61395 MT (versions of that vintage will have at least the following incompatibilies from the version described here:)SH /Symbol SF 7910 63300 MT (\267)SH /Times-Roman SF 8620 XM ("RECEIVE filespec" is used instead of "GET filespec".) 67 W( There) 382 W( is no GET command in older versions,)66 W 8620 64405 MT (and no way to specify a new name for an incoming file.)SH /Symbol SF 7910 65510 MT (\267)SH /Times-Roman SF 8620 XM (No LOCAL or REMOTE commands.)SH /Symbol SF 7910 66615 MT (\267)SH /Times-Roman SF 8620 XM (No 8th-bit prefixing, repeat counts, CRCs or 2-character checksums.)SH /Symbol SF 7910 67720 MT (\267)SH /Times-Roman SF 8620 XM (No TAKE or initialization files.)SH /Symbol SF 7910 68825 MT (\267)SH /Times-Roman SF 8620 XM (No command macros or command line arguments.)SH /Symbol SF 7910 69930 MT (\267)SH /Times-Roman SF 8620 XM (No terminal session logging.)SH 6120 71721 MT (and others, depending on the specific version.)SH ES %%Page: 107 108 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.11. Compatibility with Older Versions of MS-DOS Kermit)SH 10 /Times-Italic AF 51275 XM (Page 107)SH 46800 50 8280 5709 UL 46800 50 8280 8086 UL /Courier SF 10680 10865 MT (Rainbow Key) SH( Verb) 6000 W( Name) SH( Operation)3000 W 6600 50 10680 11065 UL 5400 50 23880 11065 UL 5400 50 32880 11065 UL 10680 12927 MT (PF1 \134Kpf1,\134Kgold) 10800 W( Keypad) 1200 W( function key)SH 10680 13958 MT (PF2..PF4 \134Kpf2..\134Kpf4) 7800 W( Keypad) 1200 W( function keys)SH 10680 14989 MT (keypad 0..9) SH( \134Kkp0..\134Kkp9) 6000 W( Keypad) 1200 W( digit keys)SH 10680 16020 MT (keypad -) SH( \134Kkpminus) 7800 W( Keypad) 3000 W( minus key)SH 10680 17051 MT (keypad ,) SH( \134Kkpcoma) 7800 W( Keypad) 3600 W( commma)SH 10680 18082 MT (keypad .) SH( \134Kkpdot) 7800 W( Keypad) 4200 W( dot \050period\051 key)SH 10680 19113 MT (keypad Enter) SH( \134Kkpenter) 5400 W( Keypad) 3000 W( Enter key)SH 10680 21175 MT (up arrow) SH( \134Kuparr) 7800 W( Cursor) 4200 W( keys)SH 10680 22206 MT (down arrow) SH( \134Kdnarr)6600 W 10680 23237 MT (left arrow) SH( \134Klfarr)6600 W 10680 24268 MT (right arrow) SH( \134Krtarr)6000 W 10680 25299 MT (Shift Prev Screen) SH( \134Khome) 2400 W( Rewind) 4800 W( to start of screen buffer)SH 10680 26330 MT (Shift Next Screen) SH( \134Kend Unwind) 2400 W( to end of screen buffer)SH 10680 27361 MT (Ctrl Prev screen) SH( \134Kupone) 3000 W( Backup) 4200 W( one screen line)SH 10680 28392 MT (Ctrl Next screen) SH( \134Kdnone) 3000 W( Advance) 4200 W( one screen line)SH 10680 29423 MT (Prev screen) SH( \134Kupscn) 6000 W( Backup) 4200 W( one screen)SH 10680 30454 MT (Next screen) SH( \134Kdnscn) 6000 W( Advance) 4200 W( one screen)SH 10680 31485 MT (Print Screen) SH( \134Kprtscr) 5400 W( Copy) 3600 W( screen to printer)SH 10680 32516 MT (Ctrl Print Screen) SH( \134Ktoggle_prn) 2400 W( Toggle) 1200 W( echoing screen to printer)SH 33480 33547 MT (\050printer failure resets toggle\051)SH 10680 34578 MT (Do \134Kdump) 11400 W( Copy) 4800 W( screen to file \050KERMIT.SCN\051)SH 10680 35609 MT (Break \134Kbreak) 9600 W( Send) 4200 W( a BREAK)SH 10680 36640 MT (Shift Break) SH( \134Klbreak) 6000 W( Send) 3600 W( a Long BREAK)SH 10680 37671 MT (Main Screen) SH( \134KDOS) 6000 W( Push) 5400 W( to DOS)SH 10680 38702 MT (Help \134Khelp) 10200 W( Show) 4800 W( Connect mode help menu)SH 10680 39733 MT (Exit \134Kexit) 10200 W( Exit) 4800 W( Connect mode)SH 10680 40764 MT (* \134Knull) 12000 W( send) 4800 W( a null out the serial port)SH 10680 41795 MT (* \134Khangup) 12000 W( hangup) 3600 W( phone by dropping DTR, RTS)SH 10680 42826 MT (* \134Klogon) 12000 W( resume) 4200 W( logging, if active)SH 10680 43857 MT (* \134Klogof) 12000 W( suspend) 4200 W( logging)SH 10680 44888 MT (* \134Kstatus) 12000 W( display) 3600 W( status table)SH 10680 46950 MT (* \050verbs not pre-assigned to keys\051)SH /Times-Bold SF 21125 49698 MT (Table 5-9:)SH /Times-Roman SF 25986 XM (Kermit-MS Verbs for the DEC Rainbow)SH 46800 50 8280 51508 UL 8280 53700 MT (Incompatibilities between 2.29 and both 2.30 and 2.31 include:)SH /Symbol SF 10070 55605 MT (\267)SH /Times-Roman SF 10780 XM (LOCAL command has been removed from 2.30 and 2.31.)SH /Symbol SF 10070 56710 MT (\267)SH /Times-Roman SF 10780 XM (CLEAR command now means clear serial port buffer rather than key and macro definitions.) 66 W( Key) 384 W( and)67 W 10780 57815 MT (macro definition string space is) 98 W( now garbage collected, so a CLEAR command for them is no longer)97 W 10780 58920 MT (necessary.)SH /Symbol SF 10070 60025 MT (\267)SH /Times-Roman SF 10780 XM (CLRINP command is gone \050replaced by CLEAR\051.)SH /Symbol SF 10070 61130 MT (\267)SH /Times-Roman SF 10780 XM (Numbers of the form \134)SH /Times-Italic SF (nnn)SH /Times-Roman SF 21473 XM (default to decimal rather than octal.)SH /Symbol SF 10070 62235 MT (\267)SH /Times-Roman SF 10780 XM (Status of Default Disk is now shown as default disk and path.)SH /Symbol SF 10070 63340 MT (\267)SH /Times-Roman SF 10780 XM (LOG)SH /Times-Italic SF 13085 XM (filespec)SH /Times-Roman SF 16390 XM (replaced by LOG SESSION)SH /Times-Italic SF 27888 XM (filespec)SH /Times-Roman SF 31193 XM (and LOG PACKET)SH /Times-Italic SF 39331 XM (filespec)SH /Times-Roman SF (.)SH /Symbol SF 10070 64445 MT (\267)SH /Times-Roman SF 10780 XM (SET KEY and SHOW KEY commands use different key identifications and syntax:)SH 8280 66236 MT (MS-Kermit no longer understands keycap names such as F1 and BACKSPACE because the codes) 78 W( are now highly)79 W 8280 67432 MT (dependent on individual keyboards, software, and computers. Also,) 82 W( not every key press combination is supported)81 W 8280 68628 MT (by the system) 145 W( software and key codes do depend on the keyboard in use. Thus, the SHOW KEY command is)146 W 8280 69824 MT (normally used to obtain codes for keys on your system. In most cases, defining one key also redefines all other keys)8 W 8280 71020 MT (sending the same character. This is a side effect of not knowing the physical details) 50 W( of every keyboard. However,)51 W ES %%Page: 108 109 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 108)SH 12 /Times-Bold AF 29185 XM (Kermit User Guide: MS-DOS KERMIT \0505.11\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (efforts have) 176 W( been made to recognize many such "aliased" keys and to generate unique identifications for each.)175 W 6120 9082 MT (Special keys, such) 60 W( as F1, F2 and others which do not send an ASCII code are usually unique and are identified by)61 W 6120 10278 MT (scan codes.)SH 6120 12670 MT (Previous versions of MS Kermit used a different key coding algorithm and) 94 W( not all old codes map to the expected)93 W 6120 13866 MT (keys. However,) 438 W( Kermit does attempt to use the older SET) 94 W( KEY syntax properly as much as possible. The older)95 W 6120 15062 MT (syntax required the keyword SCAN followed by a number WITHOUT the BACKSLASH.) 42 W( The) 333 W( current MS Kermit)41 W 6120 16258 MT (uses decimal as the default number) 75 W( base and previous versions used octal in certain commands. So, when Kermit)76 W 6120 17454 MT (senses an old) 183 W( style SET KEY command it converts the number, displays the new format and gives a warning)182 W 6120 18650 MT (message. It) 250 W( is best to make a new style SET KEY file.)SH 14 /Times-Bold AF 6120 22252 MT (5.12. What's Missing)SH 10 /Times-Roman AF 6120 24370 MT (Kermit-MS has plenty of room for improvement. Missing features \050which may be added in future releases\051 include:)SH /Symbol SF 7910 26275 MT (\267)SH /Times-Roman SF 8620 XM (Sliding window transport protocol.)SH /Symbol SF 7910 27380 MT (\267)SH /Times-Roman SF 8620 XM (Default filetype for TAKE command files.)SH /Symbol SF 7910 28485 MT (\267)SH /Times-Roman SF 8620 XM (Passing paramaters in TAKE command, like in DO command.)SH /Symbol SF 7910 29590 MT (\267)SH /Times-Roman SF 8620 XM (A way to send files with their full path names.)SH /Symbol SF 7910 30695 MT (\267)SH /Times-Roman SF 8620 XM (A way to play back session logs directly from disk to screen.)SH /Symbol SF 7910 31800 MT (\267)SH /Times-Roman SF 8620 XM (Trapping of carrier loss during CONNECT or file transfer.)SH /Symbol SF 7910 32905 MT (\267)SH /Times-Roman SF 8620 XM (Pause at end of screen during local TYPE.)SH /Symbol SF 7910 34010 MT (\267)SH /Times-Roman SF 8620 XM (A better built-in help facility.)SH /Symbol SF 7910 35115 MT (\267)SH /Times-Roman SF 8620 XM (A byte-stuffing) 251 W( mechanism during file transfer to get past devices that are not transparent to all)252 W 8620 36220 MT (printable ASCII characters.)SH 6120 38011 MT (Future releases of MS-Kermit will probably have major portions of the) 30 W( program \050now written entirely in assembler\051)29 W 6120 39207 MT (replaced by C-language code. This would include the file transfer portions, the command parser, etc.)SH 14 /Times-Bold AF 6120 42809 MT (5.13. Installation of Kermit-MS)SH 10 /Times-Roman AF 6120 44927 MT (If you already) 64 W( have Kermit on your PC, you can use it to obtain new versions of Kermit-MS when they appear on)65 W 6120 46123 MT (the central system at your site. If you do not have) 32 W( Kermit or any other reliable file capture facility on your PC, you)31 W 6120 47319 MT (can order a Kermit diskette from Columbia \050write to Kermit) 317 W( Distribution, Columbia University Center for)318 W 6120 48515 MT (Computing Activities, 612 West 115th Street, New York, NY 10025, USA, for information\051, or from any) 170 W( of a)169 W 6120 49711 MT (number of user groups or diskette services. If you don't have Kermit already,) 111 W( and absolutely can't get a Kermit)112 W 6120 50907 MT (diskette, but have access to another computer that has a copy) 37 W( of the MS-DOS Kermit program \050usually in ``)36 W /Courier SF (.BOO)SH /Times-Roman SF ('')SH 6120 52103 MT (format, explained below\051, there are two recommended methods for getting it onto your PC:)SH 8120 53894 MT (1.)SH 9120 XM (Use another file capture facility to get it.)SH 8120 55552 MT (2.)SH 9120 XM (Type in and run the "baby Kermit" program \05072 lines\051 from chapter 7 of the Kermit book.)SH 6120 57343 MT (The first method involves either "raw capture" \050no error checking\051,) 61 W( or else use of \050gasp!\051 another protocol, such as)62 W 6120 58539 MT (Xmodem, which, like Kermit, requires a program to execute the same protocol on both ends of the connection.)SH 6120 60931 MT (Raw capture generally involves "typing" the file) 193 W( on the other computer, with your PC taking the place of the)192 W 6120 62127 MT (terminal, and rather than displaying the file on the screen as it's being typed, your PC is storing it on the disk.) 30 W( This)312 W 6120 63323 MT (is a tricky process, however, because data can easily be lost or corrupted. For instance, you) 19 W( could write a very short)18 W 6120 64519 MT (BASIC program to capture a file in this way, but it could probably not) 32 W( keep up -- even at low baud rates -- with the)33 W 6120 65715 MT (transmission speed unless you included the tricky serial port BASIC commands.) 14 W( The) 277 W( DOS command COPY COM1)13 W /Times-Italic SF 6120 66911 MT (filename)SH /Times-Roman SF 9888 XM (command has the same speed problem, and it stops only when it receives a) 74 W( Control-Z character from the)75 W 6120 68107 MT (other computer.)SH 6120 70499 MT (If the other computer has Kermit on) 79 W( it -- which is likely, since this is probably the reason you want to get Kermit)78 W 6120 71695 MT (onto your PC -- you should type in the receive-only BASIC Kermit program listed on pp.186-188) 117 W( of the Kermit)118 W ES %%Page: 109 110 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.13. Installation of Kermit-MS)SH 10 /Times-Italic AF 51275 XM (Page 109)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (book, and then use it in conjunction with the other) 65 W( computer's Kermit to transfer the file. Make sure to set a long)64 W 8280 9082 MT (enough delay on the other computer to) 61 W( give yourself time to escape back to the PC and start up the "baby Kermit")62 W 8280 10278 MT (before packets start to arrive, otherwise you'll probably get fatal DOS i/o errors.)SH 8280 12670 MT (Note that Kermit programs) 61 W( are often distributed under names other than "Kermit". The Columbia Kermit program)60 W 8280 13866 MT (library contains hundreds) 71 W( of Kermit programs, which must be given unique names. MS-DOS Kermit for the IBM)72 W 8280 15062 MT (PC, for instance,) 5 W( is called)4 W /Courier SF 18773 XM (MSVIBM)SH /Times-Roman SF (. Once) 258 W( you have this program in)4 W /Courier SF 35764 XM (.EXE)SH /Times-Roman SF 38418 XM (format on your disk, you probably should)4 W 8280 16258 MT (rename it to)SH /Courier SF 13307 XM (KERMIT.EXE)SH /Times-Roman SF (, because the distribution name is harder to remember \050and type\051.)SH 8280 18650 MT (You will probably also want to create an MS-Kermit initialization file. A sample is distributed) 46 W( with MS-Kermit as)47 W /Courier SF 8280 19846 MT (MSVIBM.INI)SH /Times-Roman SF (. This) 458 W( should be) 104 W( tailored to your requirements, and then renamed to)103 W /Courier SF 43036 XM (MSKERMIT.INI)SH /Times-Roman SF (, and stored)103 W 8280 21042 MT (where Kermit can find it \050in the current directory or any directory in your DOS PATH\051.)SH 12 /Times-Bold AF 8280 23630 MT (".BOO Files")SH 10 /Times-Roman AF 8280 25044 MT (MS-Kermit \050and many other) 23 W( Kermit programs\051 are often distributed using a special encoding called "boo" \050short for)24 W 8280 26240 MT ("bootstrap"\051 format, developed especially for distribution of) 120 W( MS-Kermit over networks and communication lines.)119 W 8280 27436 MT (MS-Kermit has grown to have so many) 93 W( features that the binary program image \050the)94 W /Courier SF 43195 XM (.EXE)SH /Times-Roman SF 45939 XM (file\051 has become quite)94 W 8280 28632 MT (large. But) 272 W( binary files are generally not compatible with the common labeled tape formats \050e.g. ANSI D\051, electronic)11 W 8280 29828 MT (mail, or raw downloading -- the methods most commonly used for Kermit distribution.)SH 8280 32220 MT (A common practice) 64 W( is to encode)65 W /Courier SF 21832 XM (.EXE)SH /Times-Roman SF 24547 XM (and other binary files into printable characters, such as hexadecimal digits,)65 W 8280 33416 MT (for transportability. A) 126 W( simple "hex" encoding results in two characters per 8-bit binary byte, plus CRLFs added)125 W 8280 34612 MT (every 80 \050or less\051 hex characters to allow the file to pass through) 62 W( card-oriented links. A hex file is therefore more)63 W 8280 35808 MT (than twice as large as the original binary file.)SH 8280 38200 MT (A)SH /Courier SF 9303 XM (.BOO)SH /Times-Roman SF 12004 XM (file is a more compact, but somewhat more complicated, encoding. Every three) 51 W( binary bytes \05024 bits\051 are)50 W 8280 39396 MT (split up into four 6-bit bytes with 48 \050ASCII character ``)158 W /Courier SF (0)SH /Times-Roman SF (''\051 added to each, resulting) 158 W( in four ASCII characters)159 W 8280 40592 MT (ranging from ``)54 W /Courier SF (0)SH /Times-Roman SF ('' \050ASCII 48\051 to ``)54 W /Courier SF (o)SH /Times-Roman SF ('' \050ASCII 111\051, with) 54 W( CRLFs added at or near "column 76". The resulting file)53 W 8280 41788 MT (size would therefore) 216 W( be about 4/3 the)217 W /Courier SF 24877 XM (.EXE)SH /Times-Roman SF 27744 XM (file size. This is still quite large, so)217 W /Courier SF 44169 XM (.BOO)SH /Times-Roman SF 47036 XM (files also compress)217 W 8280 42984 MT (consecutive null \050zero\051 bytes. Up to 78 consecutive nulls are compressed into two characters. Tilde) 77 W( \050``)76 W /Courier SF (~)SH /Times-Roman SF (''\051 is the)76 W 8280 44180 MT (null-compression lead-in, and the following character indicates how) 99 W( many nulls are represented \050subtract 48 from)100 W 8280 45376 MT (this character's ASCII value\051. For instance ``)29 W /Courier SF (~A)SH /Times-Roman SF ('' means 17 consecutive nulls; ``)29 W /Courier SF (~~)SH /Times-Roman SF ('' means 78 of them.) 29 W( Repeated)307 W 8280 46572 MT (nulls are very common in)SH /Courier SF 18751 XM (.EXE)SH /Times-Roman SF 21401 XM (files.)SH 8280 48964 MT (4-for-3 encoding combined with null compression reduces the size of the encoded file to approximately) 99 W( the same)100 W 8280 50160 MT (size as the original)70 W /Courier SF 16281 XM (.EXE file)70 W /Times-Roman SF (, and sometimes even smaller. The first line of a)70 W /Courier SF 42267 XM (.BOO)SH /Times-Roman SF 44986 XM (file is the name \050in plain)69 W 8280 51356 MT (text\051 of the original file. Here's what the first few lines of a typical)SH /Courier SF 35441 XM (.BOO)SH /Times-Roman SF 38091 XM (file look like:)SH /Courier SF 9480 53011 MT (MSVIBM.EXE)SH 9480 54042 MT (CEYP0Id05@0P~3oomo2Y01FWeP8@007P000040HB4001`W~28bL005\134W~2JBP00722V0ZHPYP:)SH 9480 55073 MT (\1348:H2]R2V0[`PYP:68>H2S23V0YHPiP:Xg800;Qd~2UWD006Yg~2Ogl009]o~2L8000;20~~~~)SH 9480 56104 MT (~~~~~~~:R2H008TV?P761T4100i7n0o1]e7[@2\134PO=8LH60@00Raj>04^97Xh0)SH 12 /Times-Bold AF 8280 59723 MT (Programs for Handling .BOO Files)SH 10 /Times-Roman AF 8280 61137 MT (Kermit Distribution includes several useful)SH /Courier SF 25806 XM (.BOO)SH /Times-Roman SF (-file programs:)SH /Courier SF 8280 62928 MT (MSBPCT.BAS)SH /Times-Roman SF 16280 XM (This Microsoft BASIC program can be used on) 64 W( any PC that has BASIC to decode a)65 W /Courier SF 51032 XM (.BOO)SH /Times-Roman SF 53747 XM (file)SH 16280 64033 MT (into an)SH /Courier SF 19280 XM (.EXE)SH /Times-Roman SF 21930 XM (file. It's) 250 W( about 50 lines line, so it can be typed in.)SH /Courier SF 8280 65610 MT (MSBPCT.BOO)SH /Times-Roman SF 16280 XM (BASIC programs run rather slowly, so)53 W /Courier SF 32291 XM (.BOO)SH /Times-Roman SF (-file decoders have) 53 W( also been written in high-level)52 W 16280 66715 MT (languages like C. The)266 W /Courier SF 26315 XM (MSBPCT.EXE)SH /Times-Roman SF 32831 XM (file that was) 266 W( produced by compiling)267 W /Courier SF 49096 XM (MSBPCT.C)SH /Times-Roman SF 54413 XM (is)SH 16280 67820 MT (encoded into)545 W /Courier SF 22758 XM (MSBPCT.BOO)SH /Times-Roman SF (, which) 545 W( can be decoded back into)544 W /Courier SF 46119 XM (MSBPCT.EXE)SH /Times-Roman SF 52913 XM (using)SH /Courier SF 16280 68925 MT (MSBPCT.BAS)SH /Times-Roman SF (. Once) 538 W( you've done that, you don't need to run) 144 W( the slow BASIC version any)145 W 16280 70030 MT (more, which is a blessing, because the MS-Kermit)39 W /Courier SF 36978 XM (.BOO)SH /Times-Roman SF 39667 XM (file takes) 39 W( up to half an hour to decode)38 W 16280 71135 MT (using the BASIC version \050depending on the system\051, but only seconds using)SH /Courier SF 47029 XM (MSBPCT.EXE)SH /Times-Roman SF (.)SH ES %%Page: 110 111 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 110)SH 12 /Times-Bold AF 29185 XM (Kermit User Guide: MS-DOS KERMIT \0505.13\051)SH 46800 50 6120 5709 UL 10 /Courier AF 6120 7886 MT (MSBPCT.*)SH /Times-Roman SF 14120 XM (There are)203 W /Courier SF 18579 XM (.BOO)SH /Times-Roman SF (-file decoders written in other languages too, like assembler, Turbo Pascal,)203 W 14120 8991 MT (Fortran, etc. Take your pick. They all do the same thing.)SH /Courier SF 6120 10568 MT (MSBMKB.*)SH /Times-Roman SF 14120 XM (This is the program for encoding an)2 W /Courier SF 28715 XM (.EXE)SH /Times-Roman SF 31367 XM (file into a)2 W /Courier SF 35456 XM (.BOO)SH /Times-Roman SF 38107 XM (file. It) 252 W( is written in C, compiled, and)1 W 14120 11673 MT (translated \050by itself\051 into)9 W /Courier SF 24266 XM (.BOO)SH /Times-Roman SF 26925 XM (format, suitable for decoding back into)9 W /Courier SF 42782 XM (.EXE)SH /Times-Roman SF 45441 XM (form by any of the)9 W 14120 12778 MT (MSBPCT programs. Also in other languages, including Fortran and Turbo Pascal.)SH /Courier SF 6120 14569 MT (MSBHEX.*)SH /Times-Roman SF 11170 XM (are C programs for producing and decoding straight hex files.)SH 14 /Times-Bold AF 6120 18171 MT (5.14. Program Organization)SH 10 /Times-Roman AF 6120 20289 MT (Kermit-MS version 2) 136 W( is composed of separate assembler source files, assembled separately, and linked together.)135 W 6120 21485 MT (The modules are:)SH /Times-Italic SF 6120 23877 MT (System/Device Independent:)SH /Courier SF 6120 25668 MT (MSSKER.ASM)SH /Times-Roman SF 14120 XM (Main program)SH /Courier SF 6120 26773 MT (MSSSEN.ASM)SH /Times-Roman SF 14120 XM (File sender)SH /Courier SF 6120 27878 MT (MSSRCV.ASM)SH /Times-Roman SF 14120 XM (File receiver)SH /Courier SF 6120 28983 MT (MSSSER.ASM)SH /Times-Roman SF 14120 XM (Server operation)SH /Courier SF 6120 30088 MT (MSSFIL.ASM)SH /Times-Roman SF 14120 XM (File i/o)SH /Courier SF 6120 31193 MT (MSSCMD.ASM)SH /Times-Roman SF 14120 XM (Command parser)SH /Courier SF 6120 32298 MT (MSSTER.ASM)SH /Times-Roman SF 14120 XM (CONNECT command)SH /Courier SF 6120 33403 MT (MSSCOM.ASM)SH /Times-Roman SF 14120 XM (Packet reader and sender)SH /Courier SF 6120 34508 MT (MSSSET.ASM)SH /Times-Roman SF 14120 XM (SET, SHOW, and STATUS commands)SH /Courier SF 6120 35613 MT (MSSSCP.ASM)SH /Times-Roman SF 14120 XM (Script CLEAR, ECHO, INPUT, OUTPUT, PAUSE, TRANSMIT commands)SH /Courier SF 6120 36718 MT (MSSFIN.ASM)SH /Times-Roman SF 14120 XM (Dummy module for the end of the data segment; must be linked LAST.)SH /Courier SF 6120 37823 MT (MSSDEF.H)SH /Times-Roman SF 14120 XM (Data structure definitions and equates)SH /Times-Italic SF 6120 39612 MT (System/Device Dependent:)SH /Courier SF 6120 41403 MT (MSG)SH /Times-Italic SF (xxx)SH /Courier SF (.ASM)SH /Times-Roman SF 14120 XM (System-dependent graphics terminal for system)SH /Times-Italic SF 33423 XM (xxx)SH /Courier SF 6120 42508 MT (MSU)SH /Times-Italic SF (xxx)SH /Courier SF (.ASM)SH /Times-Roman SF 14120 XM (System-dependent keyboard translator for system)SH /Times-Italic SF 34200 XM (xxx)SH /Courier SF 6120 43613 MT (MSX)SH /Times-Italic SF (xxx)SH /Courier SF (.ASM)SH /Times-Roman SF 14120 XM (System-dependent code for system)SH /Times-Italic SF 28340 XM (xxx)SH /Courier SF 6120 44718 MT (MSY)SH /Times-Italic SF (xxx)SH /Courier SF (.ASM)SH /Times-Roman SF 14120 XM (Terminal emulation for system)SH /Times-Italic SF 26730 XM (xxx)SH /Courier SF 6120 45823 MT (MSZ)SH /Times-Italic SF (xxx)SH /Courier SF (.ASM)SH /Times-Roman SF 14120 XM (More terminal emulation for system)SH /Times-Italic SF 28813 XM (xxx)SH /Times-Roman SF 6120 48215 MT (The)SH /Times-Italic SF 8078 XM (xxx)SH /Times-Roman SF 9813 XM (is replaced by a 3-letter code for the) 153 W( particular system, e.g. IBM for the IBM PC family, RB1 for the)154 W 6120 49411 MT (Rainbow-100, etc.)SH 6120 51803 MT (The modular) 140 W( organization allows easier modification of the program, quicker transfer of modified portions from)139 W 6120 52999 MT (system-to-system. The) 496 W( modules are designed to be well-defined and) 123 W( self-contained, such that they can be easily)124 W 6120 54195 MT (replaced. For) 346 W( instance, someone who prefers windows and mice to typing commands should be able to replace the)48 W 6120 55391 MT (command parsing module without having to worry about the effect on the other modules.)SH 6120 57783 MT (To assemble any of the Kermit modules, file)SH /Courier SF 24201 XM (MSSDEF.H)SH /Times-Roman SF 29251 XM (must be on the default disk.)SH 6120 60175 MT (All the Kermit implementations require the) 294 W( modules MSSCMD, MSSCOM, MSSFIL, MSSKER, MSSRCV,)295 W 6120 61371 MT (MSSSCP, MSSSEN, MSSSER, MSSSET, MSSTER, MSSFIN. MSSFIN)SH /Times-Italic SF 36018 XM (must)SH /Times-Roman SF 38157 XM (be linked last.)SH 6120 63763 MT (Each particular implementation requires at least an) 35 W( MSX)34 W /Times-Italic SF (xxx)SH /Times-Roman SF 30726 XM (module, usually an MSU)34 W /Times-Italic SF (xxx)SH /Times-Roman SF 42444 XM (module, and, if it is doing)34 W 6120 64959 MT (terminal emulation in software, also an MSY)106 W /Times-Italic SF (xxx)SH /Times-Roman SF 26470 XM (and possible also an MSZ)106 W /Times-Italic SF (xxx)SH /Times-Roman SF 38915 XM (module, and for graphics terminal)106 W 6120 66155 MT (emulation, also an MSG)56 W /Times-Italic SF (xxx)SH /Times-Roman SF 17648 XM (module. See) 362 W( the batch or make files from) 56 W( the source distribution for details of exactly)55 W 6120 67351 MT (which modules are required for a particular implementation.)SH 6120 69743 MT (Once all the required object modules exist, they may be linked together to produce a Kermit) 16 W( program. For example,)17 W 6120 70939 MT (on the IBM PC:)SH ES %%Page: 111 112 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.14. Program Organization)SH 10 /Times-Italic AF 51275 XM (Page 111)SH 46800 50 8280 5709 UL /Courier SF 9480 7824 MT (A>link)SH 2400 50 10680 8024 UL 11280 9479 MT (Microsoft Object Linker V2.00)SH 9480 10510 MT (\050C\051 Copyright 1982 by Microsoft Inc.)SH 9480 12165 MT (Object Modules [.OBJ]: msscmd+msscom+mssfil+mssker+mssrcv+mssscp+msssen+)SH 29400 50 23280 12365 UL 9480 13196 MT (mssser+mssset+msster+msgibm+msuibm+msxibm+msyibm+mszibm+mssfin)SH 37200 50 9480 13396 UL 9480 14227 MT (Run File [MSSCMD.EXE]: kermit)SH 3600 50 23280 14427 UL 9480 15258 MT (List File [NUL.MAP]:;)SH 11880 16913 MT (A>)SH /Times-Roman SF 8280 19305 MT (Warning: old versions of MASM may not be) 46 W( able to assemble several of the large files now present in Kermit-MS.)45 W 8280 20501 MT (The solution is to acquire Microsoft MASM 4.0 or later.)SH 14 /Times-Bold AF 8280 24103 MT (5.15. Bringing Kermit to New Systems)SH 10 /Times-Roman AF 8280 26221 MT (You can bring Kermit-MS) 6 W( to MS-DOS systems that are not explicitly supported in one of two ways -- attempt to run)7 W 8280 27417 MT (the "generic" MS-DOS Kermit on it, or add explicit code to support your system.)SH 8280 29809 MT (To get started with Kermit on a new system, try running "generic" MS-DOS Kermit; in many cases, it will run as) 18 W( is.)17 W 8280 31005 MT (The generic version accomplishes all its port and console i/o through DOS calls, and during terminal) 118 W( connection)119 W 8280 32201 MT (does not attempt to emulate any) 109 W( particular kind of terminal. In some cases, the generic version may still require)108 W 8280 33397 MT (some fiddling to run) 27 W( on a new system; for instance, different systems refer to their communication ports in different)28 W 8280 34593 MT (ways -- COM1, J1, AUX, etc. The SET PORT command allows you to specify the port using any) 61 W( of these device)60 W 8280 35789 MT (names, or using DOS file handles -- keep trying until you find the one) 76 W( that works. Generic MS-DOS Kermit will)77 W 8280 36985 MT (probably run no faster than 1200 baud, and it only works with DOS 2.0 or later.)SH 8280 39377 MT (If you want to write code to explicitly support a new system, first call or write Kermit Distribution at Columbia to)61 W 8280 40573 MT (make sure no one else is) 256 W( already doing the same work. If you're the first, then begin by reading the file)257 W /Courier SF 8280 41769 MT (MSXAAA.DOC)SH /Times-Roman SF (, provided) 183 W( with the MS-DOS Kermit sources in the Kermit distribution, which is a guide to the)182 W 8280 42965 MT (system dependent modules of Kermit-MS.) 45 W( Then) 342 W( create new)46 W /Courier SF 33019 XM (MSU)SH /Times-Italic SF (xxx)SH /Courier SF (.ASM)SH /Times-Roman SF 38847 XM (and)SH /Courier SF 40587 XM (MSX)SH /Times-Italic SF (xxx)SH /Courier SF (.ASM)SH /Times-Roman SF 46415 XM (modules, and, if your)46 W 8280 44161 MT (version is also doing terminal emulation) 26 W( in software, also an)25 W /Courier SF 32894 XM (MSY)SH /Times-Roman SF 34969 XM (and possibly an)25 W /Courier SF 41516 XM (MSZ)SH /Times-Roman SF 43591 XM (module patterned after those)25 W 8280 45357 MT (that have been written for other systems.)SH ES %%Page: 112 113 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 112)SH 12 /Times-Bold AF 29185 XM (Kermit User Guide: MS-DOS KERMIT \0505.15\051)SH 46800 50 6120 5709 UL 14 SS 6120 8138 MT (5.16. Kermit-MS VT102 Terminal Emulator Technical Summary)SH 12 SS 6120 11254 MT (5.16.1. Treatment of Inbound Characters During Terminal Emulation)SH 10 /Times-Roman AF 6120 13196 MT (Many things can happen) 5 W( to a character that arrives at the communication port before you see it. The actual sequence)6 W 6120 14392 MT (of events is:)SH 8120 16183 MT (1.)SH 9120 XM (Obtain character from serial port.)SH 8120 17288 MT (2.)SH 9120 XM (Remove high bit if parity is other than none.)SH 8120 18393 MT (3.)SH 9120 XM (Detect and remove xon/xoff if FLOW is XON/XOFF.)SH 8120 19498 MT (4.)SH 9120 XM (If DEBUG is active \050ON or SESSION\051 then put character to debug style display, otherwise:)SH 8120 20603 MT (5.)SH 9120 XM (If transparent printing is active \050for VT102 emulators\051 then print the character but do) 82 W( not show it on)81 W 9120 21708 MT (the display, otherwise:)SH 8120 22813 MT (6.)SH 9120 XM (Remove high-order bit if DISPLAY is 7-bit)SH 8120 23918 MT (7.)SH 9120 XM (If an escape sequence is not in progress and TRANSLATE INPUT is ON, translate.)SH 8120 25023 MT (8.)SH 9120 XM (If LOG SESSION is active then copy character to the log file)SH 8120 26128 MT (9.)SH 9120 XM (Pass the character to the terminal emulator for interpretation or display.)SH 6120 28520 MT (The following sections summarize the Kermit-MS keyboard) 65 W( and screen operation during emulation of H19, VT52,)66 W 6120 29716 MT (and VT102 terminals, prinicipally for the IBM PC but also used by the NEC APC3, Victor 9000,) 95 W( and Sanyo 55x)94 W 6120 30912 MT (systems.)SH ES %%Page: 113 114 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.16.1. Treatment of Inbound Characters During Terminal Emulation)SH 10 /Times-Italic AF 51275 XM (Page 113)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (5.16.2. Keyboard Layout and Characters Sent)SH 10 /Times-Roman AF 8280 9946 MT (Here is how the keypad functions are assigned to the IBM keyboard function keys. You may change them) 25 W( by using)26 W 8280 11142 MT (the SET KEY command to define a desired key as the appropriate Kermit action verb; use SET) 126 W( KEY without a)125 W 8280 12338 MT (definition to undefine a key. Names of appropriate verbs are also shown for use in the Set Key command, such as)SH /Courier SF 10680 14055 MT (Set Key \1342352 \134Kbreak)SH /Times-Roman SF 29880 XM (\050IBM Alt-B assigned to verb BREAK\051)SH 8280 16447 MT (Verb names are system dependent, use)56 W /Courier SF 24362 XM (?)SH /Times-Roman SF 25268 XM (in the Set Key definition part for a list of local verbs. IBM) 56 W( PC verbs are)57 W 8280 17643 MT (listed in Table 5-6; IBM key values are either straight ASCII or the IBM Bios scan code,) 4 W( plus 256, plus 512 for Shift)3 W 8280 18839 MT (key held down, plus 1024 for Control key held down, plus 2048 for Alt key held down; non-ASCII) 29 W( keys are always)30 W 8280 20035 MT (256 decimal or greater. Keys particular to the Enhanced Keyboard have 4096 added to the result.)SH 46800 50 8280 21952 UL /Courier SF 10680 23407 MT (Heath-19 and VT52 Keypads) SH( VT102) 9600 W( keypad)SH 12480 24438 MT (IBM Keys) SH( IBM) 19200 W( keys)SH 8280 25469 MT (+------+------+-------+----------+ +------+------+------+------+)1200 W 8280 26500 MT (| Blue | Red | Grey | up arrow |) SH( |) 1200 W( PF1) 600 W( | PF2 | PF3 | PF4 |)SH 8280 27531 MT (| F1 | F2 | F3) 600 W( |) 1200 W( up arrow |) SH( |) 1200 W( F1 | F2 | F3 | F4 |)600 W 8280 28562 MT (+------+------+-------+----------+ +------+------+------+------+)1200 W 8280 29593 MT (| 7) 600 W( |) 1200 W( 8) 600 W( |) 1200 W( 9 |down) 600 W( arrow|) SH( |) 1200 W( 7) 600 W( |) 1200 W( 8) 600 W( |) 1200 W( 9) 600 W( |) 1200 W( -) 600 W( |)1200 W 8280 30624 MT (| F5 | F6 | F7) 600 W( |down) 1200 W( arrow|) SH( |) 1200 W( F5 | F6 | F7 | F8 |)600 W 8280 31655 MT (+------+------+-------+----------+ +------+------+------+------+)1200 W 8280 32686 MT (| 4) 600 W( |) 1200 W( 5) 600 W( |) 1200 W( 6 |) 600 W( rgt arrow|) SH( |) 1200 W( 4) 600 W( |) 1200 W( 5) 600 W( |) 1200 W( 6) 600 W( |) 1200 W( ,) 600 W( |)1200 W 8280 33717 MT (| F9 | F10) 600 W( | SF1 | rgt arrow|) SH( |) 1200 W( F9 | F10) 600 W( | SF1 | SF2 |)SH 8280 34748 MT (+------+------+-------+----------+ +------+------+------+------+)1200 W 8280 35779 MT (| 1) 600 W( |) 1200 W( 2) 600 W( |) 1200 W( 3 |left) 600 W( arrow|) SH( |) 1200 W( 1) 600 W( |) 1200 W( 2) 600 W( |) 1200 W( 3) 600 W( |) 1200 W( E) 600 W( |)1200 W 8280 36810 MT (| SF3) 600 W( | SF4 | SF5 |left arrow|) SH( |) 1200 W( SF3) 600 W( | SF4 | SF5 | n S|)SH 8280 37841 MT (+------+------+-------+----------+ +------+------+------+) 1200 W( t F|)600 W 8280 38872 MT (| 0------0) 600 W( |) 1200 W( . | Enter) 600 W( | |) 1200 W( 0------0) 600 W( |) 1200 W( .) 600 W( |) 1200 W( e 6|)600 W 8280 39903 MT (| SF7) 600 W( |) 4200 W( SF8 | SF6) 600 W( |) 2400 W( | SF7) 1200 W( |) 3600 W( SF8) 600 W( | r) SH( |)1200 W 8280 40934 MT (+-------------+-------+----------+ +-------------+------+------+)1200 W /Times-Italic SF 8280 42649 MT (SF1 means push Shift and F1 keys simultaneously)SH 46800 50 8280 43954 UL 8880 45469 MT (CURSOR KEYS:)SH /Courier SF 31680 46500 MT (H-19 & VT52) SH( VT102)6000 W 8880 47531 MT (VT52/H19 key) SH( IBM) 1200 W( Verb IBM key) SH( All) 3600 W( Modes) SH( Numeric) 3000 W( Application)1200 W 8880 49593 MT (up arrow) SH( UPARR) 3600 W( up) 1800 W( arrow) SH( ESC) 3600 W( A) SH( ESC) 5400 W( [ A) SH( ESC) 1200 W( O A)SH 8880 50624 MT (down arrow) SH( DNARR) 2400 W( down) 1800 W( arrow) SH( ESC) 2400 W( B) SH( ESC) 5400 W( [ B) SH( ESC) 1200 W( O B)SH 8880 51655 MT (right arrow) SH( RTARR right) 1800 W( arrow) SH( ESC) 1800 W( C) SH( ESC) 5400 W( [ C) SH( ESC) 1200 W( O C)SH 8880 52686 MT (left arrow) SH( LFARR) 2400 W( left) 1800 W( arrow) SH( ESC) 2400 W( D) SH( ESC) 5400 W( [ D) SH( ESC) 1200 W( O D)SH /Times-Italic SF 8880 54748 MT (AUXILIARY KEYPAD:)SH /Courier SF 31080 55779 MT (Heath-19 & VT52) SH( VT102)4800 W 8880 56810 MT (VT52/H19 key) SH( IBM) 1200 W( Verb IBM key) SH( Numeric) 2400 W( Applic.) SH( Numeric Applic.)1200 W 8880 58872 MT (PF1/HF7/Blue GOLD,PF1 F1) 1200 W( ESC) 4800 W( P) SH( ESC) 1200 W( P) SH( ESC) 2400 W( O P) SH( ESC) 1200 W( O P)SH 8880 59903 MT (PF2/HF8/Red PF2 F2) 1800 W( ESC) 4800 W( Q) SH( ESC) 1200 W( Q) SH( ESC) 2400 W( O Q) SH( ESC) 1200 W( O Q)SH 8880 60934 MT (PF3/HF9/Grey PF3) 1200 W( F3) 4200 W( ESC) 4800 W( R) SH( ESC) 1200 W( R) SH( ESC) 2400 W( O R) SH( ESC) 1200 W( O R)SH 8880 61965 MT (PF4/HF1 PF4 F4) 4200 W( ESC) 4800 W( S) SH( ESC) 1200 W( S) SH( ESC) 2400 W( O S) SH( ESC) 1200 W( O S)SH 8880 62996 MT (0 KP0) 7800 W( SF7 0) 4200 W( ESC) 3600 W( ? p) SH( 0) 1200 W( ESC) 4800 W( O p)SH 8880 64027 MT (1 KP1) 7800 W( SF3 1) 4200 W( ESC) 3600 W( ? q) SH( 1) 1200 W( ESC) 4800 W( O q)SH 8880 65058 MT (2 KP2) 7800 W( SF4 2) 4200 W( ESC) 3600 W( ? r) SH( 2) 1200 W( ESC) 4800 W( O r)SH 8880 66089 MT (3 KP3) 7800 W( SF5 3) 4200 W( ESC) 3600 W( ? s) SH( 3) 1200 W( ESC) 4800 W( O s)SH 8880 67120 MT (4 KP4) 7800 W( F9) 4200 W( 4) 4800 W( ESC) 3600 W( ? t) SH( 4) 1200 W( ESC) 4800 W( O t)SH 8880 68151 MT (5 KP5) 7800 W( F10 5) 4200 W( ESC) 3600 W( ? u) SH( 5) 1200 W( ESC) 4800 W( O u)SH 8880 69182 MT (6 KP6) 7800 W( SF1 6) 4200 W( ESC) 3600 W( ? v) SH( 6) 1200 W( ESC) 4800 W( O v)SH 8880 70213 MT (7 KP7) 7800 W( F5) 4200 W( 7) 4800 W( ESC) 3600 W( ? w) SH( 7) 1200 W( ESC) 4800 W( O w)SH 8880 71244 MT (8 KP8) 7800 W( F6) 4200 W( 8) 4800 W( ESC) 3600 W( ? x) SH( 8) 1200 W( ESC) 4800 W( O x)SH ES %%Page: 114 115 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 114)SH 12 /Times-Bold AF 28285 XM (Kermit User Guide: MS-DOS KERMIT \0505.16.2\051)SH 46800 50 6120 5709 UL 10 /Courier AF 6720 7824 MT (9 KP9) 7800 W( F7) 4200 W( 9) 4800 W( ESC) 3600 W( ? y) SH( 9) 1200 W( ESC) 4800 W( O y)SH 6720 8855 MT (comma \050,\051) 600 W( KPCOMA SF2) 2400 W( ,) 4200 W( ESC) 3600 W( ? l) SH( ,) 1200 W( ESC) 4800 W( O l)SH 6720 9886 MT (minus \050-\051) 600 W( KPMINUS) 2400 W( F8) 1800 W( -) 4800 W( ESC) 3600 W( ? m) SH( -) 1200 W( ESC) 4800 W( O m)SH 6720 10917 MT (period \050.\051) SH( KPDOT) 2400 W( SF8) 3000 W( .) 4200 W( ESC) 3600 W( ? n) SH( .) 1200 W( ESC) 4800 W( O n)SH 6720 11948 MT (Enter KPENTER) 5400 W( SF6 ^M\050cr\051) 1800 W( ESC) 600 W( ? M) SH( ^M) 1200 W( ESC) 4200 W( O M)SH /Times-Italic SF 6720 14010 MT (\050SFn means hold down Shift key while pressing Function key n.\051)SH /Times-Roman SF 6120 16402 MT (An often confusing item) 71 W( is knowing the mode of the auxillary keypad: numeric or application. Digital Equipment)70 W 6120 17598 MT (Corporation designed) 71 W( the terminal to change modes only under command from the remote computer and not at all)72 W 6120 18794 MT (from the keyboard. So the startup state is numeric/cursor mode, and reception of escape sequences ``)45 W /Courier SF (ESC [ ?) 45 W( 1)44 W 6120 19990 MT (h)SH /Times-Roman SF ('' or) 49 W( ``)50 W /Courier SF (l)SH /Times-Roman SF ('' changes the mode. Kermit verbs for the keypad and cursor keys generate the correct escape sequences)50 W 6120 21186 MT (appropriate to the current mode and terminal type.)SH 6120 23578 MT (A best attempt is made to safely test for the 101/102 key Enhanced keyboard and use it if) 74 W( present. If it is present)73 W 6120 24774 MT (then the keyboard translator separates the individual arrow) 234 W( keys from those on the numeric keypad and also)235 W 6120 25970 MT (separates the asterisk and forward) 69 W( slash keys on the keypad from those on the regular typewriter keyboard. These)68 W 6120 27166 MT (special Enhanced keyboard keys are reported as scan codes with 4096 added to the base scan code.)SH /Times-Italic SF 6720 28881 MT (OTHER IBM KEYS OPERATIONAL IN CONNECT MODE:)SH /Courier SF 6720 30943 MT (IBM key) SH( IBM) 4800 W( Verb) SH( Action)3000 W 6720 33005 MT (Keypad Del) SH( Send) 11400 W( ASCII Del code \050rubout\051 \134127)SH 6720 34036 MT (Backspace \050<-\051) SH( Send) 9000 W( ASCII Del code \050rubout\051 \134127 \050BS is \1348\051)SH 6720 35067 MT (Keypad -) SH( MODELINE) 4200 W( Toggle) 3000 W( mode line on/off \050only if Mode Line is)SH 24720 36098 MT (enabled and not used by the host\051.)SH 6720 37129 MT (Alt -) SH( TERMTYPE) 6000 W( Toggle) 3000 W( among H-19, VT52, and VT100 emulations.)SH 6720 38160 MT (Alt =) SH( RESET) 6000 W( Clear) 4800 W( screen and reset terminal emulator to)SH 24720 39191 MT (starting \050setup\051 state.)SH 6720 40222 MT (Alt B) SH( BREAK) 6000 W( Send) 4800 W( a BREAK signal)SH 6720 41253 MT (Alt H) SH( HELP) 6000 W( Show) 5400 W( drop down help menu \050detailed below\051)SH 6720 42284 MT (Alt S) SH( STATUS) 6000 W( Show) 4200 W( settings)SH 6720 43315 MT (Alt X) SH( EXIT) 6000 W( Exit) 5400 W( Connect mode, back to Kermit prompt)SH 6720 45377 MT (Home HOMSCN) 6600 W( Roll) 4200 W( screen up \050text down\051 to beginning of)SH 25320 46408 MT (storage.)SH 6720 47439 MT (End ENDSCN) 7200 W( Roll) 4200 W( screen down \050text up\051 to end of storage.)SH 6720 48470 MT (PgUp UPSCN) 6600 W( Roll) 4800 W( screen up \050back, earlier\051 one screen.)SH 6720 49501 MT (PgDn DNSCN) 6600 W( Roll) 4800 W( screen down \050forward, later\051 one screen.)SH 6720 50532 MT (Ctrl-PgUp UPONE) 3600 W( Roll) 4800 W( screen up one line.)SH 6720 51563 MT (Ctrl-PdDn DNONE) 3600 W( Roll) 4800 W( screen down one line.)SH 6720 53625 MT (Control PrtSc) SH( PRTSCN) 1200 W( Toggle) 4200 W( on/off) 600 W( copying of received text to)SH 24720 54656 MT (printer, "PRN" shows on far right of mode)SH 24720 55687 MT (line when activated.)SH 6720 57749 MT (Control-End DUMP Dump) 2400 W( image of screen to a disk file or device.)SH 24720 58780 MT (Default filename is KERMIT.SCN in the current)SH 24720 59811 MT (directory. Use command SET DUMP to change the)SH 24720 60842 MT (filename. Screen) 600 W( images are appended to the)SH 24720 61873 MT (file, separated by formfeeds.)SH 6720 63935 MT (Shift-PrtSc Standard) 2400 W( DOS Print-screen, dump screen image to printer.)SH 6720 65997 MT (unassigned HOLDSCRN DEC) 3000 W( style Holdscreen, same as typing Control-S.)SH /Times-Roman SF 6120 68389 MT (")SH /Courier SF (Alt -)69 W /Times-Roman SF (" means hold down Alt and type minus on the) 69 W( upper key rank. This switches among the various kinds of)70 W 6120 69585 MT (emulation but does not change most operating parameters of the emulator.)SH /Times-Italic SF 6120 71977 MT (CONNECT ESCAPE COMMANDS:)SH ES %%Page: 115 116 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.16.2. Keyboard Layout and Characters Sent)SH 10 /Times-Italic AF 51275 XM (Page 115)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (Type the Kermit escape character \050normally ``)SH /Courier SF (^])SH /Times-Roman SF (''\051, then one of the keys below:)SH /Courier SF 42480 9541 MT (\050equivalent IBM Verb\051)SH 11280 10572 MT (? display) 1200 W( this short list.) SH( HELP)18600 W 11280 11603 MT (0 send) 1200 W( a null character.) SH( NULL)19800 W 11280 12634 MT (B send) 1200 W( a BREAK signal.) SH( BREAK)21000 W 11280 13665 MT (C close) 1200 W( connect session & return to Kermit prompt.) SH( EXIT)4200 W 11280 14696 MT (F dump) 1200 W( screen to filespec, default is KERMIT.SCN.) SH( DUMP)4800 W 11280 15727 MT (H hangup) 1200 W( the phone or network connection) SH( HANGUP)10200 W 11280 16758 MT (L send) 1200 W( a Long BREAK signal) SH( LBREAK)18600 W 11280 17789 MT (M toggle) 1200 W( mode line on/off.) SH( MODELINE)18600 W 11280 18820 MT (P push) 1200 W( to DOS.) SH( DOS)25800 W 11280 19851 MT (Q quit) 1200 W( \050suspend\051 logging.) SH( LOGOFF)19200 W 11280 20882 MT (R resume) 1200 W( logging.) SH( LOGON)24000 W 11280 21913 MT (S show) 1200 W( status.) SH( STATUS)25800 W 11280 22944 MT (Kermit escape character itself: send it to the host.)SH 12 /Times-Bold AF 8280 26060 MT (5.16.3. Responses To Characters Received By the Terminal Emulator)SH 10 /Times-Roman AF 8280 28002 MT (Spaces shown between characters of escape sequences are) 65 W( there for ease of reading. The actual sequences contain)64 W 8280 29198 MT (no spaces. Unknown escape sequences of the form "ESC char" are absorbed by the emulator without further effect;)26 W 8280 30394 MT (longer unknown escape sequences echo the extra characters.)SH 8280 32786 MT (DEC VT102 functions while in ANSI \050VT102\051 mode, unsupported features marked by an asterisk \050*\051:)SH /Courier SF 8880 34441 MT (Escape Seq) SH( Mnemonic) 2400 W( Description) 3600 W( of Action)SH 8880 36503 MT (ESC D) SH( IND) 5400 W( Index,) 6600 W( moves cursor down one line, can scroll)SH 8880 37534 MT (ESC E) SH( NEL) 5400 W( Move) 6600 W( cursor to start of line below, can scroll)SH 8880 38565 MT (ESC H) SH( HTS) 5400 W( Set) 6600 W( one horizontal tab at current position)SH 8880 39596 MT (ESC M) SH( RI) 5400 W( Reverse) 7200 W( Index, cursor up one line, can scroll)SH 8880 40627 MT (ESC Z) SH( DECID Identify) 5400 W( terminal \050response is ESC [ ? 6 c\051)SH 8880 41658 MT (ESC c) SH( RIS) 5400 W( Reset) 6600 W( terminal to initial state)SH 8880 42689 MT (ESC =) SH( DECKPAM) 5400 W( Enter) 4200 W( keypad application mode)SH 8880 43720 MT (ESC >) SH( DECKNPNM) 5400 W( Enter) 3600 W( keypad numeric mode)SH 8880 44751 MT (ESC 7) SH( DECSC Save) 5400 W( cursor position and attributes)SH 8880 45782 MT (ESC 8) SH( DECRC Restore) 5400 W( cursor from previously saved position)SH 8880 46813 MT (ESC # 3) SH( DECDHL) 4200 W( Double) 4800 W( height and width line, top half)SH 8880 47844 MT (ESC # 4) SH( DECDHL) 4200 W( Double) 4800 W( height and width line, bottom half)SH 8880 48875 MT (ESC # 5) SH( DECSWL) 4200 W( Single) 4800 W( height and width line)SH 8880 49906 MT (ESC # 6) SH( DECDWL) 4200 W( Double) 4800 W( width single height line)SH 8880 50937 MT (ESC # 8) SH( DECALN) 4200 W( Test) 4800 W( screen alignment, fill screen with E's)SH 8880 51968 MT (ESC [ Pn @) SH( ICH) 2400 W( ANSI) 6600 W( insert Pn spaces at and after cursor)SH 8880 52999 MT (ESC [ Pn A) SH( CUU) 2400 W( Cursor) 6600 W( up Pn lines, does not scroll)SH 8880 54030 MT (ESC [ Pn B) SH( CUD) 2400 W( Cursor) 6600 W( down Pn lines, does not scroll)SH 8880 55061 MT (ESC [ Pn C) SH( CUF) 2400 W( Cursor) 6600 W( forward, stays on same line)SH 8880 56092 MT (ESC [ Pn D) SH( CUB) 2400 W( Cursor) 6600 W( backward, stays on same line)SH 8880 57123 MT (ESC [ Pn; Pn H CUP) SH( Set) 6600 W( cursor to row, column \050same as HVP\051)SH 8880 58154 MT (ESC [ Ps J) SH( ED) 2400 W( Erase) 7200 W( in display:)SH 27480 59185 MT (0 = cursor to end of screen, inclusive)SH 27480 60216 MT (1 = start of screen to cursor, inclusive)SH 27480 61247 MT (2 = entire screen, reset lines to single)SH 29880 62278 MT (width, cursor does not move.)SH 8880 63309 MT (ESC [ Ps K) SH( EL) 2400 W( Erase) 7200 W( in line:)SH 27480 64340 MT (0 = cursor to end of line, inclusive)SH 27480 65371 MT (1 = start of line to cursor, inclusive)SH 27480 66402 MT (2 = entire line, cursor does not move)SH 8880 67433 MT (ESC [ Pn L) SH( IL) 2400 W( Insert) 7200 W( Pn lines preceding current line.)SH 8880 68464 MT (ESC [ Pn M) SH( DL) 2400 W( Delete) 7200 W( Pn lines from current downward, incl.)SH 8880 69495 MT (ESC [ Pn P) SH( DCH) 2400 W( Delete) 6600 W( Pn chars from cursor to left, incl.)SH 8880 70526 MT (ESC [ Pn; Pn R CPR) SH( Cursor) 6600 W( report \050row, column\051, sent by terminal)SH 26880 71557 MT (Example: home position yields ESC [ 1; 1 R)SH ES %%Page: 116 117 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 116)SH 12 /Times-Bold AF 28285 XM (Kermit User Guide: MS-DOS KERMIT \0505.16.3\051)SH 46800 50 6120 5709 UL 10 /Courier AF 6720 7824 MT (ESC [ Pn c) SH( DA) 2400 W( Device) 7200 W( attributes \050reports ESC [ ? 6 c\051)SH 6720 8855 MT (ESC [ Pn; Pn f HVP) SH( Set) 6600 W( cursor to row, column \050same as CUP\051)SH 6720 9886 MT (ESC [ Ps g) SH( TBC) 2400 W( Tabs) 6600 W( clear, 0 = at this position, 3 = all)SH 6720 10917 MT (ESC [ 4 h) SH( IRM Insert) 3000 W( mode on)SH 6720 11948 MT (ESC [ 20 h) SH( LNM) 2400 W( Set) 6600 W( newline mode \050cr => cr/lf\051)SH 6720 12979 MT (ESC [ 4 l) SH( IRM Replacement) 3000 W( mode on)SH 6720 14010 MT (ESC [ 20 l) SH( LNM) 2400 W( Reset) 6600 W( newline mode \050cr => cr\051)SH 6720 15041 MT (ESC [ ? Ps;...;Ps h SM) SH( Set) 3600 W( mode, see table below)SH 6720 16072 MT (ESC [ ? Ps;...;Ps l RM) SH( Reset) 3600 W( mode, see table below)SH 11520 17103 MT (Ps Mnemonic) 2400 W( Mode) 3600 W( Set) 6000 W( \050h\051) SH( Reset) 4200 W( \050l\051)SH 11520 18134 MT (0 error) 12000 W( \050ignored\051)SH 11520 19165 MT (1 DECCKM) 3000 W( cursor) 4800 W( keys) SH( application cursor/numeric)1800 W 11520 20196 MT (2 DECANM) 3000 W( ANSI/VT52) 4800 W( ANSI/VT102) 3000 W( VT52)2400 W 11520 21227 MT (3 DECCOLM) 3000 W( Columns +132) 4200 W( col) SH( 80) 3600 W( col)SH 11520 22258 MT (4 DECSCLM) 3000 W( *Scrolling) 3600 W( smooth) 3000 W( jump)4800 W 11520 23289 MT (5 DECSCNM) 3000 W( Screen) 4200 W( reverse) 4800 W( video normal)SH 11520 24320 MT (6 DECOM) 3000 W( Origin) 5400 W( relative) 4800 W( absolute)3600 W 11520 25351 MT (7 DECAWM) 3000 W( Autowrap) 4800 W( on) 3600 W( off)7200 W 11520 26382 MT (8 DECARM) 3000 W( *Autorepeat) 4200 W( on) 2400 W( off)7200 W 11520 27413 MT (9 DECINLM) 3000 W( *Interlace) 3600 W( on) 3000 W( off)7200 W 11520 28444 MT (18 DECPFF) 2400 W( Printer) 4800 W( termination character, use FF if set)SH 11520 29475 MT (19 DECPEX) 2400 W( Printer) 4800 W( extent,set=screen,off=scrolling region)SH 11520 30506 MT (38 n/a) 2400 W( Graphics) 6600 W( \050Tek\051 ++graphics) SH( text)2400 W 23520 31537 MT (+ See comments on EGA boards.)SH 22920 32568 MT (++ Ignored if DISABLE TEK has been given.)SH 6720 33599 MT (ESC [ Pn i) SH( MC) 2400 W( Printer) 7200 W( controls \050Media Copy\051)SH 11520 34630 MT (0 Print) 12600 W( whole Screen)SH 11520 35661 MT (4 Exit) 12600 W( printer controller \050transparent print\051)SH 11520 36692 MT (5 Enter) 12600 W( printer controller \050transparent print\051)SH 6720 37723 MT (ESC [ ? Pn i) SH( MC) 1200 W( Printer) 7200 W( controls \050Media Copy\051)SH 11520 38754 MT (1 Print) 12600 W( line containing cursor)SH 11520 39785 MT (4 Exit) 12600 W( auto print \050stop echoing to printer\051)SH 11520 40816 MT (5 Enter) 12600 W( autoprint \050echo screen chars to printer\051)SH 6720 41847 MT (ESC [ Ps;...;Ps m SGR) SH( Select) 4200 W( graphic rendition)SH 25320 42878 MT (0 = all attributes off \050#'s 1, 4, 5, 7\051)SH 25320 43909 MT (1 = bold, intensify foreground)SH 25320 44940 MT (4 = underscore \050reverse video on IBM CGA\051)SH 25320 45971 MT (5 = blink)SH 25320 47002 MT (7 = reverse video)SH 15720 48033 MT (non-DEC extensions: 30-37 = foreground color = 30 + colors)SH 27720 49064 MT (40-47 = background color = 40 + colors)SH 27720 50095 MT (colors: 1 = red, 2 = green, 4 = blue)SH 6720 51126 MT (ESC [ Ps n) SH( DSR) 2400 W( Device) 6600 W( Status Report.)SH 24720 52157 MT (Response from VT100: 0=ready, 3=malfunction.)SH 24720 53188 MT (Command to VT100: 5=report status with DSR,)SH 24720 54219 MT (6=report cursor position using CPR sequence.)SH 6720 55250 MT (ESC [ Ps;...;Ps q DECLL) SH( Load) 3000 W( LEDs, Ps = 0 means clear LED #1-4)SH 24720 56281 MT (Ps = 1,2,3,4 sets LED # 1,2,3,4 on status line.)SH 6720 57312 MT (ESC [ Pn; Pn r DECSTBM) SH( Set) 4200 W( top and bottom scrolling margins, resp.)SH 24720 58343 MT (ESC [ r resets margin to full screen.)SH 6720 59374 MT (ESC [ sol x) SH( DECREQTPARM Request) 1800 W( terminal parameters, see table below)SH 6720 60405 MT (ESC [ sol; par; nbits; xspeed; rspeed; clkmul; flags x)SH 15720 61436 MT (DECREPTPARM Reports) 1800 W( terminal parameters)SH 24720 62467 MT (sol = 0 request; terminal can send unsolicited)SH 25920 63498 MT (reports - supported as sol = 1 below.)SH 24720 64529 MT (sol = 1, request; term reports only on request)SH 24720 65560 MT (sol = 2, this is a report \050DECREPTPARM\051)SH 24720 66591 MT (sol = 3, terminal reporting only on request)SH 24720 67622 MT (par = 1 none, 2 space, 3 mark, 4 odd, 5 even)SH 24720 68653 MT (nbits = 1 \0508 bits/char\051, 2 \0507 bits/char\051)SH 24720 69684 MT (xspeed,rspeed = transmit & receive speed index)SH 7320 70715 MT (0,8,16,24,32,40,48,56,64,72,80,88,96,104,112,120,128 correspond to speeds of)SH 7320 71746 MT (50,75,110,134.5,150,200,300,600,1200,1800,2000,2400,3600,4800,9600,19200,)SH ES %%Page: 117 118 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.16.3. Responses To Characters Received By the Terminal Emulator)SH 10 /Times-Italic AF 51275 XM (Page 117)SH 46800 50 8280 5709 UL /Courier SF 9480 7824 MT (and 38400 baud.) SH( clkmul) 7800 W( = 1 \050clock rate multiplier is 16\051)SH 26880 8855 MT (flags = 0-15 \050Setup Block #5\051, always 0 here)SH 8880 9886 MT (ESC [ 2; Ps y DECST) SH( *Confidence) 5400 W( tests - not supported)SH 17880 10917 MT (SCS Select) 6600 W( character sets.)SH 8880 11948 MT (ESC \050 A) SH( SCS) 4200 W( G0) 6600 W( points to UK symbols)SH 8880 12979 MT (ESC \051 A) SH( SCS) 4200 W( G1) 6600 W( points to UK symbols)SH 8880 14010 MT (ESC \050 B) SH( SCS) 4200 W( G0) 6600 W( points to ASCII symbols)SH 8880 15041 MT (ESC \051 B) SH( SCS) 4200 W( G1) 6600 W( points to ASCII symbols)SH 8880 16072 MT (ESC \050 0) SH( SCS) 4200 W( G0) 6600 W( points to special \050line drawing\051 graphics)SH 8880 17103 MT (ESC \051 0) SH( SCS) 4200 W( G1) 6600 W( points to special \050line drawing\051 graphics)SH 8880 18134 MT (ESC \050 1) SH( SCS) 4200 W( G0) 6600 W( points to alt char ROM - UK symbols)SH 8880 19165 MT (ESC \051 1) SH( SCS) 4200 W( G1) 6600 W( points to alt char ROM - UK symbols)SH 8880 20196 MT (ESC \050 2) SH( SCS) 4200 W( G0) 6600 W( points to alt graphics ROM - as ESC \050 0)SH 8880 21227 MT (ESC \051 2) SH( SCS) 4200 W( G1) 6600 W( points to alt graphics ROM - as ESC \051 0)SH 27480 22258 MT (\050Separate graphics used for DEC and Heath\051)SH 8880 23289 MT (^E ENQ) 7200 W( *Answerback) 6000 W( message \050not supported\051)SH 8880 24320 MT (^G BELL) 7200 W( Sound) 6000 W( VT102 style beep)SH 8880 25351 MT (^H BS Backspace,) 7200 W( move cursor left one character)SH 8880 26382 MT (^I HT Horizontal) 7200 W( tab, move cursor to next tabstop)SH 8880 27413 MT (^J LF Linefeed,) 7200 W( move cursor down one line)SH 8880 28444 MT (^K VT Vertical) 7200 W( Tab, treated as a line feed)SH 8880 29475 MT (^L FF Formfeed,) 7200 W( treated as a line feed)SH 8880 30506 MT (^M CR Carriage) 7200 W( return, move cursor to col 1)SH 8880 31537 MT (^N SO Select) 7200 W( usage of G1 character set)SH 8880 32568 MT (^O SI Select) 7200 W( usage of G0 character set)SH 8880 33599 MT (^X CAN) 7200 W( Cancel) 6600 W( escape sequence in progress)SH 8880 34630 MT (^Z SUB) 7200 W( Treated) 6600 W( as a CAN)SH 8880 36692 MT (Other extensions:)SH 8880 37723 MT (ESC [ 25; Pc f) SH( VT52/VT100) 9000 W( move cursor to 25th line.)SH 8880 38754 MT (ESC [ 25; Pc H) SH( VT52/VT100) 9000 W( move cursor to 25th line.)SH 26880 39785 MT (\050These will disable Kermit's own status line.\051)SH 8880 40816 MT (ESC * char) SH( VT200) 11400 W( series graphics command, ignored.)SH 8880 41847 MT (ESC ^L) SH( Enter) 13800 W( Tektronix sub-mode, clear Tek screen.)SH 26880 42878 MT (\050This is ignored if DISABLE TEK has been given\051)SH 12 /Times-Bold AF 8280 45994 MT (5.16.4. DEC VT102 Functions While in VT52 Mode)SH 10 /Courier AF 8880 47874 MT (Escape sequence) SH( Description) 8400 W( of action)SH 8880 49936 MT (ESC A) SH( Cursor) 14400 W( up)SH 8880 50967 MT (ESC B) SH( Cursor) 14400 W( down)SH 8880 51998 MT (ESC C) SH( Cursor) 14400 W( right)SH 8880 53029 MT (ESC D) SH( Cursor) 14400 W( left)SH 8880 54060 MT (ESC F) SH( Enter) 14400 W( graphics mode)SH 8880 55091 MT (ESC G) SH( Exit) 14400 W( graphics mode)SH 8880 56122 MT (ESC H) SH( Cursor) 14400 W( home)SH 8880 57153 MT (ESC I) SH( Reverse) 14400 W( line feed)SH 8880 58184 MT (ESC J) SH( Erase) 14400 W( to end of screen)SH 8880 59215 MT (ESC K) SH( Erase) 14400 W( to end of line)SH 8880 60246 MT (ESC V) SH( Print) 14400 W( cursor line)SH 8880 61277 MT (ESC X) SH( Exit) 14400 W( Printer Controller mode, transparent print)SH 8880 62308 MT (ESC Y row column) SH( Direct) 7800 W( cursor address, offset from space)SH 8880 63339 MT (ESC W) SH( Enter) 14400 W( Printer Controller mode,transparent print)SH 8880 64370 MT (ESC Z) SH( Identify) 14400 W( \050response is ESC / Z\051)SH 8880 65401 MT (ESC ^ \050caret\051) SH( Enter) 9600 W( autoprint mode \050printer echoes screen\051)SH 8880 66432 MT (ESC _ \050underscore\051) SH( Exit) 6600 W( autoprint mode)SH 8880 67463 MT (ESC ]) SH( Print) 14400 W( Screen)SH 8880 68494 MT (ESC =) SH( Enter) 14400 W( alternate keypad mode)SH 8880 69525 MT (ESC >) SH( Exit) 14400 W( alternate keypad mode)SH 8880 70556 MT (ESC <) SH( Enter) 14400 W( ANSI mode \050changes to VT102\051)SH ES %%Page: 118 119 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 118)SH 12 /Times-Bold AF 28285 XM (Kermit User Guide: MS-DOS KERMIT \0505.16.5\051)SH 46800 50 6120 5709 UL 6120 8004 MT (5.16.5. Heath-19 Functions While in Non-ANSI Mode)SH 10 /Courier AF 6720 9884 MT (Escape seq) SH( Mnemonic) 2400 W( Description) 3600 W( of action)SH 6720 11946 MT (ESC A) SH( HCUU) 5400 W( Cursor) 6000 W( Up)SH 6720 12977 MT (ESC B) SH( HCUD) 5400 W( Cursor) 6000 W( Down)SH 6720 14008 MT (ESC C) SH( HCUF) 5400 W( Cursor) 6000 W( Forward, stays on same line)SH 6720 15039 MT (ESC D) SH( HCUB) 5400 W( Cursor) 6000 W( Backward, stays on same line)SH 6720 16070 MT (ESC E) SH( HCD) 5400 W( Clear) 6600 W( display)SH 6720 17101 MT (ESC F) SH( HEGM) 5400 W( Enter) 6000 W( Graphics mode)SH 6720 18132 MT (ESC G) SH( HXGM) 5400 W( Exit) 6000 W( Graphic mode)SH 6720 19163 MT (ESC H) SH( HCUH) 5400 W( Cursor) 6000 W( Home)SH 6720 20194 MT (ESC I) SH( HRI) 5400 W( Reverse) 6600 W( Index)SH 6720 21225 MT (ESC J) SH( HEOP) 5400 W( Erase) 6000 W( to end of page)SH 6720 22256 MT (ESC K) SH( HEOL) 5400 W( Erase) 6000 W( to end of line)SH 6720 23287 MT (ESC L) SH( HIL) 5400 W( Insert) 6600 W( line)SH 6720 24318 MT (ESC M) SH( HDL) 5400 W( Delete) 6600 W( line)SH 6720 25349 MT (ESC N) SH( HDCH) 5400 W( Delete) 6000 W( character)SH 6720 26380 MT (ESC O) SH( HERM) 5400 W( Exit) 6000 W( Insert Char mode)SH 6720 27411 MT (ESC Y row col HDCA) SH( Direct) 6000 W( cursor addressing, offset from space)SH 6720 28442 MT (ESC Z) SH( HID) 5400 W( Identify) 6600 W( \050response is ESC / K which is a VT52\051)SH 6720 29473 MT (ESC b) SH( HBD) 5400 W( Erase) 6600 W( Beginning of display)SH 6720 30504 MT (ESC j) SH( HSCP) 5400 W( Save) 6000 W( cursor position)SH 6720 31535 MT (ESC k) SH( HRCP) 5400 W( Set) 6000 W( cursor to saved position)SH 6720 32566 MT (ESC l) SH( HEL) 5400 W( Erase) 6600 W( entire line)SH 6720 33597 MT (ESC n) SH( HCPR) 5400 W( Cursor) 6000 W( Position Report request)SH 6720 34628 MT (ESC o) SH( HEBL) 5400 W( Erase) 6000 W( beginning of line)SH 6720 35659 MT (ESC p) SH( HERV) 5400 W( Enter) 6000 W( Reverse Video mode)SH 6720 36690 MT (ESC q) SH( HXRV) 5400 W( Exit) 6000 W( Reverse Video mode)SH 6720 37721 MT (ESC r Bn) SH( HMBR) 3600 W( *Modify) 6000 W( baud rate - not supported)SH 6720 38752 MT (ESC t) SH( HEKS) 5400 W( *Enter) 6000 W( Keypad shifted mode, not supported)SH 6720 39783 MT (ESC u) SH( HXKS) 5400 W( *Exit) 6000 W( Keypad shifted mode, not supported)SH 6720 40814 MT (ESC v) SH( HEWA) 5400 W( Wrap) 6000 W( around at end of line)SH 6720 41845 MT (ESC w) SH( HXWA) 5400 W( Discard) 6000 W( at end of line)SH 6720 42876 MT (ESC x Ps) SH( HSM) 3600 W( Set) 6600 W( Mode. See table below)SH 6720 43907 MT (ESC y Ps) SH( HRM) 3600 W( Reset) 6600 W( Mode. See table below)SH 11520 45969 MT (Ps Mnemonic) 2400 W( Mode) 3600 W( Set) 6600 W( \050x\051) SH( Reset) 4200 W( \050y\051)SH 11520 47000 MT (1 HSM/HRM) 3000 W( 25th) 4200 W( line) SH( enabled +disabled)3600 W 11520 48031 MT (2 *keyclick) 11400 W( off) 4200 W( on)6600 W 11520 49062 MT (3 *holdscreen) 11400 W( enabled) 3000 W( disabled)4200 W 11520 50093 MT (4 cursor) 12000 W( type) SH( block underline)2400 W 11520 51124 MT (5 cursor) 12000 W( on/off) SH( on) 1200 W( off)7200 W 11520 52155 MT (6 *keypad-shifted) 11400 W( shifted) 600 W( unshifted)4200 W 11520 53186 MT (7 alt) 12000 W( app keypad enabled) SH( disabled)4200 W 11520 54217 MT (8 *linefeed) 11400 W( lf=>cr/lf) 4200 W( lf=>lf)3000 W 11520 55248 MT (9 newline) 12000 W( mode) SH( cr=>cr/lf) 1800 W( cr=>cr)3000 W 24120 56279 MT (+ disabling the 25th line also clears it)SH 6720 58341 MT (ESC z) SH( HRAM) 5400 W( Reset) 6000 W( to power-up configuration)SH 6720 59372 MT (ESC =) SH( HAKM) 5400 W( Enter) 6000 W( Alternate Keypad mode)SH 6720 60403 MT (ESC >) SH( HXAM) 5400 W( Exit) 6000 W( Alternate Keypad mode)SH 6720 61434 MT (ESC <) SH( HEAM) 5400 W( Enter) 6000 W( ANSI mode \050ESC [ stuff\051)SH 6720 62465 MT (ESC @) SH( HEIM) 5400 W( Enter) 6000 W( Insert Char mode)SH 6720 63496 MT (ESC [) SH( HEHS *Enter) 5400 W( Hold Screen mode, not supported)SH 6720 64527 MT (ESC \134) SH( HXHS *Exit) 5400 W( Hold Screen mode, not supported)SH 6720 65558 MT (ESC { and }) SH( HEK,) 1800 W( HDK) SH( *Keyboard) 3000 W( enable/disable, not supported)SH 6720 66589 MT (ESC ]) SH( HX25 *Transmit) 5400 W( 25th line, not supported)SH 6720 67620 MT (ESC #) SH( HXMP *Transmit) 5400 W( page, not supported)SH ES %%Page: 119 120 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.16.6. Heath-19 Functions While in ANSI Mode)SH 10 /Times-Italic AF 51275 XM (Page 119)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (5.16.6. Heath-19 Functions While in ANSI Mode)SH 10 /Courier AF 8880 9884 MT (Escape Seq) SH( Mnenonic) 2400 W( Description) 3600 W( of Action)SH 8880 11946 MT (ESC [ s) SH( PSCP) 4200 W( Save) 6000 W( cursor position & attributes)SH 8880 12977 MT (ESC [ u) SH( PRCP) 4200 W( Restore) 6000 W( cursor position & attributes)SH 8880 14008 MT (ESC [ z) SH( PRAM) 4200 W( Reset) 6000 W( to power-up configuration)SH 8880 15039 MT (ESC [ 2 J) SH( ED) 3000 W( Erase) 7200 W( entire screen but do not move cursor;)SH 26880 16070 MT (regular Heath-19 moves cursor to Home.)SH 8880 17101 MT (ESC [ ? 2 h) SH( PEHM) 1800 W( Revert) 6000 W( to normal Heath-19 non-ANSI mode)SH 8880 18132 MT (ESC [ > Ps h) SH( SM) 1200 W( Same) 7200 W( as ESC x Ps)SH 8880 19163 MT (ESC [ > Ps l) SH( RM) 1200 W( Same) 7200 W( as ESC y Ps)SH /Times-Roman SF 8280 20880 MT (Plus most of the ANSI escape sequences listed for the VT102.)SH 12 /Times-Bold AF 8280 23996 MT (5.16.7. Tektronix 4010/4014 Graphics Terminal Functions)SH 10 /Times-Roman AF 8280 25938 MT (MS-Kermit's Tektronix 4010 emulator) 116 W( responds to ordinary text, several special control codes \050for drawing lines)115 W 8280 27134 MT (and dots\051, and several escape sequences, as shown in Table 5-10. The) 276 W( commands SET DEBUG and SET)277 W 8280 28330 MT (TRANSLATION INPUT are effective in Tek mode.)SH 46800 50 8280 30321 UL 8280 33055 MT (Control Code)SH 29880 XM (Action)SH 5417 50 8280 33255 UL 2722 50 29880 33255 UL /Courier SF 8280 34160 MT (FS,)SH /Times-Roman SF 10930 XM (Control-)SH /Courier SF (\134)SH /Times-Roman SF 19080 XM (Backslash)SH 29880 XM (draw dots)SH /Courier SF 8280 35265 MT (GS,)SH /Times-Roman SF 10930 XM (Control-)SH /Courier SF (])SH /Times-Roman SF 19080 XM (Right square bracket)SH 29880 XM (draw lines)SH /Courier SF 8280 36370 MT (RS,)SH /Times-Roman SF 10930 XM (Control-)SH /Courier SF (^)SH /Times-Roman SF 19080 XM (Caret)SH 29880 XM (Draw dots incrementally)SH /Courier SF 8280 37475 MT (US,)SH /Times-Roman SF 10930 XM (Control-)SH /Courier SF (_)SH /Times-Roman SF 19080 XM (Underscore)SH 29880 XM (Display text)SH /Courier SF 8280 38580 MT (BEL,)SH /Times-Roman SF 10930 XM (Control-)SH /Courier SF (G)SH /Times-Roman SF 29880 XM (Beep, make a noise)SH /Courier SF 8280 39685 MT (BS,)SH /Times-Roman SF 10930 XM (Control-)SH /Courier SF (H)SH /Times-Roman SF 29880 XM (Backspace, non-destructive)SH /Courier SF 8280 40790 MT (HT,)SH /Times-Roman SF 10930 XM (Control-)SH /Courier SF (I)SH /Times-Roman SF 29880 XM (Tab, convert to single space)SH /Courier SF 8280 41895 MT (LF,)SH /Times-Roman SF 10930 XM (Control-)SH /Courier SF (J)SH /Times-Roman SF 29880 XM (Line feed, go down one line)SH /Courier SF 8280 43000 MT (VT,)SH /Times-Roman SF 10930 XM (Control-)SH /Courier SF (K)SH /Times-Roman SF 29880 XM (Move up one text line)SH /Courier SF 8280 44105 MT (FF,)SH /Times-Roman SF 10930 XM (Control-)SH /Courier SF (L)SH /Times-Roman SF 29880 XM (Clears the screen)SH /Courier SF 8280 45210 MT (CR,)SH /Times-Roman SF 10930 XM (Control-)SH /Courier SF (M)SH /Times-Roman SF 29880 XM (Carriage return, start of line)SH /Courier SF 8280 46315 MT (CAN,)SH /Times-Roman SF 10930 XM (Control-)SH /Courier SF (X)SH /Times-Roman SF 29880 XM (Exit Tek sub-mode, or ignore)SH 8280 47420 MT (DEL, RUBOUT)SH 29880 XM (Delete code, same as BS)SH 8280 49630 MT (Escape Sequence)SH 29880 XM (Action)SH 6914 50 8280 49830 UL 2722 50 29880 49830 UL /Courier SF 8280 50735 MT (ESC)SH /Times-Roman SF 10680 XM (Control-)SH /Courier SF (E)SH /Times-Roman SF 29880 XM (Send a status report, turn on Bypass mode)SH /Courier SF 8280 51840 MT (ESC)SH /Times-Roman SF 10680 XM (Control-)SH /Courier SF (L)SH /Times-Roman SF 29880 XM (Clear the screen \050enter sub-mode from VT102\051)SH /Courier SF 8280 52945 MT (ESC)SH /Times-Roman SF 10680 XM (Control-)SH /Courier SF (X)SH /Times-Roman SF 29880 XM (Turn on Bypass mode)SH /Courier SF 8280 54050 MT (ESC)SH /Times-Roman SF 10680 XM (Control-)SH /Courier SF (Z)SH /Times-Roman SF 29880 XM (Activate crosshairs \050GIN mode\051 and Bypass mode)SH /Courier SF 8280 55155 MT (ESC Z)SH /Times-Roman SF 29880 XM (Send terminal identification)SH /Courier SF 8280 56260 MT (ESC `)SH /Times-Roman SF 11530 XM (\050accent grave\051)SH 29880 XM (Use solid lines in drawing)SH /Courier SF 8280 57365 MT (ESC a)SH /Times-Roman SF 11530 XM (through)SH /Courier SF 14891 XM (ESC e)SH /Times-Roman SF 29880 XM (Use dashed line patterns:)SH 30130 58470 MT (a=fine dots, b=short dashes)SH 30130 59575 MT (c=dash dot, d=long dash dot)SH 30130 60680 MT (e=dash dot dot.)SH /Courier SF 8280 61785 MT (ESC [ Pn ; Pn m)SH /Times-Roman SF 29880 XM (Set ANSI colors. Same as for VT102.)SH /Courier SF 8280 62890 MT (ESC [ ? 3 8 l)SH /Times-Roman SF 29880 XM (Exit Tek mode \050become text terminal, VT102 etc\051)SH /Courier SF 8280 63995 MT (ESC [ ? 3 8 h)SH /Times-Roman SF 29880 XM (Enter Tek mode \050from VT102 mode\051)SH /Times-Bold SF 15265 65605 MT (Table 5-10:)SH /Times-Roman SF 20626 XM (Response of MS-Kermit Tektronix Emulator to Received Characters)SH 46800 50 8280 67415 UL 8280 69607 MT (In the table, US is) 55 W( the name for the ASCII character Control-Underscore, 31 decimal. Text is written starting with)54 W 8280 70803 MT (the last drawn point being) 15 W( the lower left corner of the first 8 by 8 character cell. The drawing position is updated by)16 W 8280 71999 MT (8 dots to the right for each character,) 35 W( and lines wrap at column 80 \050column 90 for Hercules boards\051. If text extends)34 W ES %%Page: 120 121 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 120)SH 12 /Times-Bold AF 28285 XM (Kermit User Guide: MS-DOS KERMIT \0505.16.7\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT ("below the screen" the sign ")118 W /Courier SF (More >)118 W /Times-Roman SF (" is shown at the bottom right corner and the user) 118 W( needs to press a key to)119 W 6120 9082 MT (continue. Then) 312 W( the screen will) 31 W( be cleared and the new text will start at the top of the screen \050no scrolling is done in)30 W 6120 10278 MT (graphics mode\051. A real Tek 4010 begins new text at) 71 W( column 40 and will overwrite dots from older material. The)72 W 6120 11474 MT (high resolution EGA screen and the Hercules screen will hold 43 lines, the CGA and Monochome) 62 W( screens hold 25)61 W 6120 12670 MT (lines, and the AT&T screen holds 50 lines. Hercules screens are 90 characters wide and others are 80 characters)94 W 6120 13866 MT (wide. Monochrome) 449 W( systems lack graphics so the text is the normal hardware character font placed at the nearest)99 W 6120 15062 MT (normal 80x25 location \050similarly, "drawing" on Monochrome systems is achieved by using a text plus) 109 W( \050"+"\051 sign)110 W 6120 16258 MT (where a dot would appear\051. Text mode is interrupted by the drawing commands discussed below.)SH 6120 18650 MT (Bypass Mode:)SH 5472 50 6120 18850 UL 6120 21042 MT (Certain Tektronix commands turn on or off "Bypass" mode whereby) 75 W( incoming text is not displayed on the screen.)74 W 6120 22238 MT (Removal of echos of the GIN mode, discussed below, is the major use) 119 W( of Bypass. Bypass mode is turned on by)120 W 6120 23434 MT (receipt of ESC Control-E, ESC Control-X, and ESC Control-Z and it is turned off upon receipt of BEL, LF, CR,) 4 W( US,)3 W 6120 24630 MT (other escape sequences, and resetting the terminal.)SH 6120 27022 MT (Drawing commands GS, FS, RS:)SH 12945 50 6120 27222 UL 6120 29414 MT (1. Draw a line or move to a point: GS <)SH /Times-Italic SF (xy xy)SH /Times-Roman SF 24514 XM (. . .)SH /Times-Italic SF 26264 XM (xy)SH /Times-Roman SF (>)SH 6120 31806 MT (GS is the name for ASCII character) 68 W( Control-)69 W /Courier SF (])SH /Times-Roman SF 25429 XM (\050right square bracket\051, decimal 29. <)69 W /Times-Italic SF (xy)SH /Times-Roman SF (> stands for an encoded x,y)69 W 6120 33002 MT (coordinate as explained below.) 1 W( One) 250 W( or more x,y coordinates may follow GS and line segments are drawn from point)SH 6120 34198 MT (to point. The first point is reached) 27 W( without drawing so that GS and the initial <)28 W /Times-Italic SF (xy)SH /Times-Roman SF (> is a simple "move-to" command)28 W 6120 35394 MT (rather than a) 45 W( "draw-to" command. Lines may be constructed from six dash patterns described in Table 5-10. <)44 W /Times-Italic SF (xy)SH /Times-Roman SF (>)SH 6120 36590 MT (coordinates are encoded by separating the 10 bit value of x and of) 16 W( y into 5 bit components and then adding two high)17 W 6120 37786 MT (bits to each to) 27 W( identify which component is being represented: high-y, low-y, high-x, or low-x. They are transmitted)26 W 6120 38982 MT (in that order, with the low-x byte always sent last. In fact,) 18 W( bytes may be omitted if they do not change from point to)19 W 6120 40178 MT (point, provided that low-x is always sent. These bytes range from ASCII space \05032 decimal\051 to ASCII DEL) 82 W( \050127)81 W 6120 41374 MT (decimal\051. Details) 255 W( are given below, and summarized in Table 5-12. This mode completes when a new command or a)3 W 6120 42570 MT (CR LF \050carriage return,) 50 W( line feed\051 arrives; escape sequences are processed transparently but other control codes are)49 W 6120 43766 MT (ignored. The) 250 W( interrupting character is accepted and processed next.)SH 6120 46158 MT (2. Draw dots at given locations: FS <)SH /Times-Italic SF (xy xy)SH /Times-Roman SF 23543 XM (. . .)SH /Times-Italic SF 25293 XM (xy)SH /Times-Roman SF (>)SH 6120 48550 MT (FS is the name for) 7 W( the ASCII character Control-\134 \050backslash\051, decimal 28. <)8 W /Times-Italic SF (xy)SH /Times-Roman SF (> is in the same form as above. A dot)8 W 6120 49746 MT (is drawn at each x,y point. This mode completes when a) 179 W( new command or a CRLF character arrives; escape)178 W 6120 50942 MT (sequences are processed transparently but other control codes are ignored.) 102 W( The) 456 W( interrupting character is accepted)103 W 6120 52138 MT (and processed next.)SH 6120 54530 MT (3. Draw dots from the current location: RS)SH /Times-Italic SF 23479 XM ( )SH /Times-Roman SF 37195 XM (. . .)SH /Times-Italic SF 38945 XM ()SH /Times-Roman SF 6120 56922 MT (RS is the name for the ASCII character Control-)80 W /Courier SF (^)SH /Times-Roman SF 27020 XM (\050caret\051, decimal 30.)80 W /Times-Italic SF 35615 XM (pen)SH /Times-Roman SF 37389 XM (is the character Space \05032 decimal\051 to)80 W 6120 58118 MT (move without drawing or P \05080 decimal\051 to draw while moving.)SH /Times-Italic SF 32201 XM ()SH /Times-Roman SF 37412 XM (is one of) SH( the letters A, E, D, F, B, J, H,)1 W 6120 59314 MT (I as shown in Table 5-11.)SH 6120 61706 MT (Example:)SH /Courier SF 10268 XM (RS P J J J)65 W /Times-Roman SF 16843 XM (\050no spaces) 65 W( here, naturally\051 means draw three dots in the southwest direction, stepping to)64 W 6120 62902 MT (each in turn. This mode completes) 7 W( when a new command or a non-)8 W /Times-Italic SF ()SH /Times-Roman SF 36376 XM (or non-)8 W /Times-Italic SF ()SH /Times-Roman SF 44519 XM (character arrives; the)8 W 6120 64098 MT (interrupting character is accepted and processed next.)SH ES %%Page: 121 122 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.16.7. Tektronix 4010/4014 Graphics Terminal Functions)SH 10 /Times-Italic AF 51275 XM (Page 121)SH 46800 50 8280 5709 UL 46800 50 8280 8086 UL 8280 10818 MT (direction)SH 17280 XM (Move One Tek Dot This Way)SH 3611 50 8280 11018 UL 11581 50 17280 11018 UL /Times-Roman SF 11880 11923 MT (A)SH 17280 XM (East \050right\051)SH 11880 13028 MT (E)SH 17280 XM (East and North)SH /Courier SF 34080 XM (F D E)1200 W /Times-Roman SF 11880 14133 MT (D)SH 17280 XM (North \050up\051)SH 11880 15238 MT (F)SH 17280 XM (North and West)SH /Courier SF 34080 XM (B * A)1200 W /Times-Roman SF 40730 XM (\050)SH /Courier SF (*)SH /Times-Roman SF 41913 XM (is current location\051)SH 11880 16343 MT (B)SH 17280 XM (West)SH 11880 17448 MT (J)SH 17280 XM (South and West)SH /Courier SF 34080 XM (J H I)1200 W /Times-Roman SF 11880 18553 MT (H)SH 17280 XM (South)SH 11880 19658 MT (I)SH 17280 XM (South and East)SH /Times-Bold SF 21833 21268 MT (Table 5-11:)SH /Times-Roman SF 27194 XM (Tektronix Dot-Drawing Commands)SH 46800 50 8280 23078 UL 8280 25270 MT (Graphics INput \050GIN\051 mode:)SH 11358 50 8280 25470 UL 8280 27662 MT (Graphics input mode is entered when ESC Control-Z is received. A crosshair is drawn) 81 W( on the screen and may be)80 W 8280 28858 MT (moved by the numeric keypad arrows \050fine scale motion\051 or) 80 W( the Shift key and these arrows \050coarse scale motion\051.)81 W 8280 30054 MT (Pressing an ASCII-producing key sends the position of the crosshairs to the host as) 34 W( the sequence of: pressed key, X)33 W 8280 31250 MT (coordinate, Y coordinate, carriage return, then removes the crosshairs, and then returns to text mode.) 278 W( The)807 W 8280 32446 MT (coordinates are encoded) 83 W( by splitting them into five bit fields, adding an ascii space \05020H\051 to each, and are sent as)82 W 8280 33642 MT (high-y, low-y,) 31 W( high-x and low-x bytes. Bypass mode is active while the report is sent to supress echos of the report.)32 W 8280 34838 MT (One may prematurely exit GIN mode by) 195 W( typing Control-C or Control-Break. Shift-PrtSc \050DOS screen dump\051)194 W 8280 36034 MT (remains active, however.)SH 8280 38426 MT (Status or Position Report:)SH 10029 50 8280 38626 UL 8280 40818 MT (ESCAPE Control-E requests a status report from the emulator.) 95 W( Tek) 441 W( terminals have many sub-fields. Kermit-MS)96 W 8280 42014 MT (sends a byte of 24 hex for being in text mode or 20 hex otherwise, followed by the) 66 W( encoded X then Y coordinates)65 W 8280 43210 MT (and a carriage return. Coordinates are encoded 5 bits at a time similar to the GIN report.)SH 8280 45602 MT (Identification Report:)SH 8360 50 8280 45802 UL 8280 47994 MT (ESCAPE Z requests terminal identification, as for VT52 and VT102. Currently this report) 173 W( is the 10 character)174 W 8280 49190 MT (sequence)SH /Courier SF 12195 XM (IBM_TEK ESCAPE / Z)SH /Times-Roman SF 23245 XM (\050no spaces\051.)SH 8280 51582 MT (Screen Capturing:)SH 6971 50 8280 51782 UL 8280 53974 MT (Kermit does not implement a graphics screen capture facility.) 88 W( There) 425 W( are many such Terminate-and-Stay-Resident)87 W 8280 55170 MT (\050TSR\051 programs in circulation, as either public domain offerings or) 72 W( parts of commercial packages \050Paint programs)73 W 8280 56366 MT (and even)158 W /Courier SF 12428 XM (GRAPHICS.COM)SH /Times-Roman SF 20036 XM (from DOS\051. High resolution EGA screens require more than the)158 W /Courier SF 47880 XM (GRAPHICS.COM)SH /Times-Roman SF 8280 57562 MT (program. MS) 285 W( Windows tells the program \050Kermit-MS\051 the system is using a pure text-only monochrome adapter so)18 W 8280 58758 MT (dots are shown as plus signs.)SH 8280 61150 MT (Although Kermit cannot save graphics screens directly \050e.g. via) 146 W( the)145 W /Courier SF 36899 XM (^]F)SH /Times-Roman SF 39094 XM (connect-mode command\051, the received)145 W 8280 62346 MT (Tektronix escape sequences can still be logged to a PC file using the LOG SESSION command. The resulting) 54 W( log)55 W 8280 63542 MT (cannot be "played back" directly on the PC, but) 146 W( it can be transferred to the host and run through Kermit's Tek)145 W 8280 64738 MT (emulator again, just like a character-mode Kermit session log.)SH ES %%Page: 122 123 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 122)SH 12 /Times-Bold AF 28285 XM (Kermit User Guide: MS-DOS KERMIT \0505.16.7\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (VGA Modes:)SH 5138 50 6120 8086 UL 6120 10278 MT (Considerable effort went into ensuring the graphics display would work automatically and not damage monitors.)123 W 6120 11474 MT (Thus, Kermit-MS safely tests the active) 65 W( display adapter for its kind and capabilities before starting graphics mode.)64 W 6120 12670 MT (Recent VGA and EGA+ display boards are capable of the) 6 W( 640 by 480 scan-line 16-color "VGA" mode which is now)7 W 6120 13866 MT (available on IBM PS/2 computers. The Tek emulator will) 53 W( happily run with 480 scan lines, but: the normal 256KB)52 W 6120 15062 MT (of video memory is sufficient to save only the top 407 lines) 180 W( of the graphics image. So activating this higher)181 W 6120 16258 MT (resolution mode is accomplished by the command SET TERMINAL GRAPHICS VGA) 383 W( and is not done)382 W 6120 17454 MT (automatically \050the VGA is used in EGA) 70 W( mode\051. The 320 by 200 line by 256 color MCGA mode has too coarse a)71 W 6120 18650 MT (resolution for graphics line drawing and is not supported by Kermit.)SH 6120 21042 MT (Coordinate Encoding:)SH 8527 50 6120 21242 UL 6120 23434 MT (Coordinate 0,0 is the lower left corner and the X axis is horizontal. Tektronix positions are mapped) 6 W( into the typically)5 W 6120 24630 MT (640 dots wide by 200 or 350 dots high PC screen and thus adjacent Tek positions may yield the same PC screen dot.)SH 6120 27022 MT (4010-like devices use positions from 0 to 1023 for both X and Y, although only 0 to 779) 83 W( are visible for Y due to)84 W 6120 28218 MT (screen geometry. The Tek screen is 10.24 by 7.80 inches and coordinates are sent as 1-4 characters.)SH 6120 30610 MT (4014-like devices use positions 0 to 4095, but each) 25 W( movement is a multiple of 4 positions unless the high-resolution)24 W 6120 31806 MT (LSBXY are sent. This makes it compatible) 99 W( with the 4010 in that a full sized plot fills the screen. The emulator)100 W 6120 33002 MT (accepts the LSBXY components but does not use them.)SH 6120 35394 MT (The various modes are summarized in Table 5-12, in which the following notation is used:)SH 8120 36914 MT (HIX, HIY = High order 5 bits of a 10 or 12 bit position.)SH 8120 38019 MT (LOX, LOY = Middle order 5 bits of position \050low order of Tek 4010\051.)SH 8120 39124 MT (LSBXY = Low order 2 bits of X + low order 2 bits of Y \0504014 mode\051,)SH 8870 40229 MT (recognized by the Tek emulator but not used to calculate position.)SH 46800 50 6120 42220 UL 6120 44954 MT (Hi Y)SH 11520 XM (Lo Y)SH 16920 XM (Hi X)SH 22320 XM (LSBXY)SH 27720 XM (Characters Sent \050Lo-X Always Sent\051)SH 1972 50 6120 45154 UL 2083 50 11520 45154 UL 1972 50 16920 45154 UL 3278 50 22320 45154 UL 14719 50 27720 45154 UL 6120 46059 MT (Same)SH 11520 XM (Same)SH 16920 XM (Same)SH 22320 XM (Same)SH 44280 XM (Lo-X)SH 6120 47164 MT (Same)SH 11520 XM (Same)SH 16920 XM (Same)SH 22320 XM (Diff)SH 32040 XM (LSB,)SH 35640 XM (Lo-Y,)SH 44280 XM (Lo-X)SH 48960 XM (4014)SH 6120 48269 MT (Same)SH 11520 XM (Same)SH 16920 XM (Diff)SH 22320 XM (Same)SH 35640 XM (Lo-Y,)SH 39960 XM (Hi-X,)SH 44280 XM (Lo-X)SH 6120 49374 MT (Same)SH 11520 XM (Same)SH 16920 XM (Diff)SH 22320 XM (Diff)SH 32040 XM (LSB,)SH 35640 XM (Lo-Y,)SH 39960 XM (Hi-X,)SH 44280 XM (Lo-X)SH 48960 XM (4014)SH 6120 50479 MT (Same)SH 11520 XM (Diff)SH 16920 XM (Same)SH 22320 XM (Same)SH 35640 XM (Lo-Y,)SH 44280 XM (Lo-X)SH 6120 51584 MT (Same)SH 11520 XM (Diff)SH 16920 XM (Same)SH 22320 XM (Diff)SH 32040 XM (LSB,)SH 35640 XM (Lo-Y,)SH 44280 XM (Lo-X)SH 48960 XM (4014)SH 6120 52689 MT (Same)SH 11520 XM (Diff)SH 16920 XM (Diff)SH 22320 XM (Same)SH 35640 XM (Lo-Y,)SH 39960 XM (Hi-X,)SH 44280 XM (Lo-X)SH 6120 53794 MT (Same)SH 11520 XM (Diff)SH 16920 XM (Diff)SH 22320 XM (Diff)SH 32040 XM (LSB,)SH 35640 XM (Lo-Y,)SH 39960 XM (Hi-X,)SH 44280 XM (Lo-X)SH 48960 XM (4014)SH 6120 54899 MT (Diff)SH 11520 XM (Same)SH 16920 XM (Same)SH 22320 XM (Same)SH 27720 XM (Hi-Y,)SH 44280 XM (Lo-X)SH 6120 56004 MT (Diff)SH 11520 XM (Same)SH 16920 XM (Same)SH 22320 XM (Diff)SH 27720 XM (Hi-Y,)SH 32040 XM (LSB,)SH 35640 XM (Lo-Y,)SH 44280 XM (Lo-X)SH 48960 XM (4014)SH 6120 57109 MT (Diff)SH 11520 XM (Same)SH 16920 XM (Diff)SH 22320 XM (Same)SH 27720 XM (Hi-Y,)SH 35640 XM (Lo-Y,)SH 39960 XM (Hi-X,)SH 44280 XM (Lo-X)SH 6120 58214 MT (Diff)SH 11520 XM (Same)SH 16920 XM (Diff)SH 22320 XM (Diff)SH 27720 XM (Hi-Y,)SH 32040 XM (LSB,)SH 35640 XM (Lo-Y,)SH 39960 XM (Hi-X,)SH 44280 XM (Lo-X)SH 48960 XM (4014)SH 6120 59319 MT (Diff)SH 11520 XM (Diff)SH 16920 XM (Same)SH 22320 XM (Same)SH 27720 XM (Hi-Y,)SH 35640 XM (Lo-Y,)SH 44280 XM (Lo-X)SH 6120 60424 MT (Diff)SH 11520 XM (Diff)SH 16920 XM (Same)SH 22320 XM (Diff)SH 27720 XM (Hi-Y,)SH 32040 XM (LSB,)SH 35640 XM (Lo-Y,)SH 44280 XM (Lo-X)SH 48960 XM (4014)SH 6120 61529 MT (Diff)SH 11520 XM (Diff)SH 16920 XM (Diff)SH 22320 XM (Same)SH 27720 XM (Hi-y,)SH 35640 XM (Lo-Y,)SH 39960 XM (Hi-X,)SH 44280 XM (Lo-X)SH 6120 62634 MT (Diff)SH 11520 XM (Diff)SH 16920 XM (Diff)SH 22320 XM (Diff)SH 27720 XM (Hi-y,)SH 32040 XM (LSB,)SH 35640 XM (Lo-Y,)SH 39960 XM (Hi-X,)SH 44280 XM (Lo-X)SH 48960 XM (4014)SH 6120 64244 MT (Kind code for byte:)SH 27720 XM (20h)SH 32040 XM (60h)SH 35640 XM (60h)SH 39960 XM (20h)SH 44280 XM (40h)SH 27720 65349 MT (\050transmitted left to right\051)SH /Times-Bold SF 17243 66959 MT (Table 5-12:)SH /Times-Roman SF 22604 XM (MS-Kermit Tektronix Coordinate Interpretation)SH 46800 50 6120 68769 UL 6120 70961 MT (Note that LO-Y must be sent if HI-X has changed so that the) 154 W( Tektronix knows the HI-X byte \050in the range of)153 W ES %%Page: 123 124 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.16.7. Tektronix 4010/4014 Graphics Terminal Functions)SH 10 /Times-Italic AF 51275 XM (Page 123)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (20h-3Fh\051 is HI-X and not HI-Y. LO-Y must also be sent if LSBXY has changed, so that) 140 W( the 4010 will ignore)141 W 8280 9082 MT (LSBXY and accept LO-Y. The LSBXY byte is)SH 10280 10602 MT (60)SH /Times-Italic SF (h)SH /Times-Roman SF (+\050)SH /Times-Italic SF (MARGIN)SH /Symbol SF (\264)SH /Times-Roman SF (10)SH /Times-Italic SF (h)SH /Times-Roman SF (\051+\050)SH /Times-Italic SF (LSBY)SH /Symbol SF (\264)SH /Times-Roman SF (4\051+)SH /Times-Italic SF (LSBX)SH /Times-Roman SF 8280 12122 MT (MARGIN is 0 here and refers to splitting) 48 W( the screen left and right for text rollover, which the Kermit Tek emulator)47 W 8280 13318 MT (does not do.)SH 8280 15710 MT (Tek 4010 Example:)SH 7610 50 8280 15910 UL 8280 18102 MT (Suppose <)12 W /Times-Italic SF (xy)SH /Times-Roman SF (> is point y) 12 W( = 300, x = 500 in Tektronix coordinates. Split each 10-bit coordinate into 5-bit groups, add)13 W 8280 19298 MT (add the Kind code to each. Send the X part last.)SH /Courier SF 20280 20953 MT (HI-Y LO-Y) 2400 W( HI-X) 10800 W( LO-X)2400 W 10680 21984 MT (Y=300d=012Ch= 01001 01100) 600 W( X=500d=01F4h=) 1200 W( 01111 10100)600 W 11880 23015 MT (+Kind code +100000 +1100000) SH( +kind) 2400 W( code +100000 +1000000)SH 3600 50 19080 23215 UL 4200 50 23880 23215 UL 3600 50 38280 23215 UL 4200 50 43080 23215 UL 10680 24046 MT (Binary 101001) 4200 W( 01101100) SH( 101111) 9600 W( 1000100)600 W 10680 25077 MT (ASCII \051) 6600 W( l) 3600 W( /) 13200 W( D)3600 W /Times-Roman SF 8280 26794 MT (So <)SH /Times-Italic SF (xy)SH /Times-Roman SF (> = \050500,300\051 is sent or received in a GS command as ``)SH /Courier SF (\051l/D)SH /Times-Roman SF (''. An) 250 W( example in C \050program fragments\051:)SH /Courier SF 8280 28449 MT (#define ESC 27)SH 8280 29480 MT (#define GS) SH( 29)1200 W 8280 30511 MT (#define US) SH( 31)1200 W 8280 31542 MT (FILE *fp;) SH( /*) 12600 W( File descriptor for terminal */)SH 8880 32573 MT (. . .)SH 10680 34228 MT (fputc\050 GS, fp\051; coord\050 75, 65\051;) SH( /*) 3600 W( Move to 75,65) SH( */)3000 W 10680 35259 MT (fputc\050 ESC, fp\051; fputs\050"[31m", fp\051;) SH( /*) 1200 W( Set foreground to red */)SH 10680 36290 MT (fputc\050 US, fp\051; fputs\050"A House", fp\051; /* Annotate at 75,65 */)SH 10680 37321 MT (fputc\050 ESC, fp\051; fputs\050"[33m", fp\051;) SH( /*) 1200 W( Set foreground to yellow */)SH 10680 38352 MT (fputc\050 GS, fp\051;) SH( /*) 13200 W( Now draw lines... */)SH 10680 39383 MT (coord\050 50, 50\051; coord\050300, 50\051;) SH( /*) 3600 W( Bottom side) SH( */)4200 W 10680 40414 MT (coord\050300,200\051; coord\050 50,200\051;) SH( /*) 3600 W( Right wall, top) SH( */)1800 W 10680 41445 MT (coord\050175,250\051; coord\050300,200\051;) SH( /*) 3600 W( Roof) SH( */)8400 W 10680 42476 MT (fputc\050 GS, fp\051;) SH( /*) 13200 W( Start a new line) SH( */)1200 W 10680 43507 MT (coord\050 50, 50\051; coord\050 50,200\051;) SH( /*) 3600 W( Left wall at 50,50 */)SH 10680 44538 MT (fputc\050 ESC, fp\051; fputs\050"[37m", fp\051;) SH( /*) 1200 W( Set foreground to white */)SH 10680 45569 MT (. . .)SH 8280 47224 MT (coord\050x, y\051 int x, y; {) SH( /*) 4200 W( Send x,y coordinates to Tek 4010 */)SH 10680 48255 MT (fputc\050\050y / 32\051 + 32, fp\051;) SH( /*) 7200 W( High y */)SH 10680 49286 MT (fputc\050\050y % 32\051 + 96, fp\051;) SH( /*) 7200 W( Low y */)SH 10680 50317 MT (fputc\050\050x / 32\051 + 32, fp\051;) SH( /*) 7200 W( High x */)SH 10680 51348 MT (fputc\050\050x % 32\051 + 64, fp\051;) SH( /*) 7200 W( Low x */)SH 8280 52379 MT (})SH 14 /Times-Bold AF 8280 55981 MT (5.17. IBM PC Kermit Technical Summaries)SH 10 /Times-Roman AF 8280 58099 MT (Under normal circumstances, MS-Kermit) 155 W( takes advantage of the computer's hardware, and often bypasses DOS)154 W 8280 59295 MT (\050sometimes even BIOS\051 to achieve high performance, to exercise special machine features, or to) 241 W( produce an)242 W 8280 60491 MT (attractive screen display. Thus, it is not in all respects a "well behaved" DOS program.)SH 8280 62883 MT (MS-Kermit redirects interrupts 0BH \050COM2/4\051 or 0CH \050COM1/3\051, 14H \050serial port\051, 23H \050Control-Break\051,) 139 W( 24H)138 W 8280 64079 MT (\050DOS Critical Error\051 and returns them when done. It uses the BIOS for keyboard, video display,) 214 W( and system)215 W 8280 65275 MT (information interrupts. It examines segment 40H for EGA operating modes) 146 W( and it does direct screen reads and)145 W 8280 66471 MT (writes. Memory) 720 W( for the screen roll backbuffer is) 235 W( negotiated with DOS to leave room for a second copy of)236 W /Courier SF 8280 67667 MT (COMMAND.COM)SH /Times-Roman SF 15187 XM (to run) 57 W( tasks within Kermit; about 100KB to 148KB is needed for the entire program. Video page)56 W 8280 68863 MT (zero is normally used, but page one is) 35 W( employed to save screens with non-standard dimensions. Hercules and other)36 W 8280 70059 MT (graphics mode displays are supported only) 121 W( in Tektronix terminal mode. Kermit's timing delays are dynamically)120 W 8280 71255 MT (adjusted each time the serial port is started to accomodate machines of different speeds;) 147 W( duration of the normal)148 W ES %%Page: 124 125 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 124)SH 12 /Times-Bold AF 29185 XM (Kermit User Guide: MS-DOS KERMIT \0505.17\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (software timing loop is measured with the hardware timer chip and looping is adjusted) 8 W( to produce uniform delays on)7 W 6120 9082 MT (8088 through 80386 machines.)SH 12 /Times-Bold AF 6120 12198 MT (5.17.1. Kermit-MS/IBM on Local Area Networks)SH 10 /Times-Roman AF 6120 14140 MT (The IBM version of Kermit-MS has) 69 W( support for the IBM Local Area Network NetBIOS \050and emulators\051 interface,)70 W 6120 15336 MT (Interrupt 5CH, with additional support for selected vendor specific) 180 W( features \050presently just AT&T STARLAN\051,)179 W 6120 16532 MT (activated by the SET PORT NET command, described above, direct support for the Ungermann Bass Net) 165 W( One)166 W 6120 17728 MT (proprietary Interrupt 14h interface, and via SET PORT BIOSn support for many other networks which) 35 W( intercept the)34 W 6120 18924 MT (Bios serial port interrupt 14h. Communications across a LAN occurring through the NetBIOS interface) 52 W( use virtual)53 W 6120 20120 MT (circuits \050Sessions\051, named nodes, and conventional NetBIOS) 195 W( packets. Kermit-MS does not use LAN terminal)194 W 6120 21316 MT (interface packages nor the Redirector or similar functions.)SH 6120 23708 MT (Kermit LAN operations are harmonious with normal network activity and many pairs) 48 W( of Kermits can communicate)49 W 6120 24904 MT (simultaneously. Kermit) 462 W( does not use LAN File Server functions, since these) 106 W( are proprietary and vendor-specific.)105 W 6120 26100 MT (Kermit can, however, send and receive files to/from a LAN file server.)SH 6120 28492 MT (Since Kermit uses the standard NetBIOS interrupt 5CH interface, it will run on most LANS including) 29 W( IBM PC Net,)30 W 6120 29688 MT (IBM Token Ring, AT&T STARLAN, and many others, and will run with Novell NetWare software.) 132 W( Presently,)513 W 6120 30884 MT (Kermit knows some details) 23 W( of STARLAN and is able to send a BREAK across the net and can use ISN node names)24 W 6120 32080 MT (with long path parts. If STARLAN is not operating these features are not available.) 50 W( As) 349 W( more detailed information)49 W 6120 33276 MT (becomes available special features of other networks can be built-in.)SH 6120 35668 MT (The sequence of operations is similar for a client or server Kermit. The SET PORT NET command is issued) 100 W( by)101 W 6120 36864 MT (both. This command causes Kermit to validate the presence of the Interrupt 5CH interface, test for) 15 W( vendor additions,)14 W 6120 38060 MT (test for a session already underway,) 146 W( establish and display a unique Kermit node name, but not make a network)147 W 6120 39256 MT (session. The) 418 W( node name of the remote server) 84 W( machine follows the word NET; this is not to be confused with our)83 W 6120 40452 MT (own node name discussed below.)SH 6120 42844 MT (If an earlier LAN session is still active then the current remote node name field of the command is examined for)96 W 6120 44040 MT (presence of a name. If a name is given then Kermit asks the user whether to RESUME the) 61 W( session or start a NEW)60 W 6120 45236 MT (one. Starting) 392 W( a new one results in Kermit hanging up the old session \050HANGUP\051 before proceeding; resuming) 71 W( an)72 W 6120 46432 MT (old one requires no further work at this point.)SH 6120 48824 MT (When Kermit attaches to the network for the first time it needs to) 146 W( select a unique local node name so that two)145 W 6120 50020 MT (systems can form a Session by using these names as addresses. Kermit uses a) 64 W( simple algorithm to make the name.)65 W 6120 51216 MT (Kermit probes the network adapter board/software) 58 W( for the name of the local system. If the name is present Kermit)57 W 6120 52412 MT (makes its own name by appending a dot K \050.K\051 to the local) 10 W( name. If the local name is absent then Kermit first tries a)11 W 6120 53608 MT (standard name of "mskermit.K"; should the network report that) 91 W( the name is not unique \050another node is using the)90 W 6120 54804 MT (name\051 then the user is asked to choose a name. This process continues until a unique name is) 70 W( obtained or the user)71 W 6120 56000 MT (decides to quit. The) 11 W( final Kermit node name is reported on the screen; client Kermits will need to know the name of)10 W 6120 57196 MT (the server Kermit.)SH 6120 59588 MT (Communication across the LAN begins) 4 W( differently for client and server Kermits. The server must be started first, by)5 W 6120 60784 MT (simply placing a Kermit in server mode. This results in a network Listen) 145 W( request being posted so that arriving)144 W 6120 61980 MT (packets with the correct node name) 62 W( can be delivered to the server Kermit. Next, a client Kermit tries to connect to)63 W 6120 63176 MT (the server by issuing a Kermit server command) 66 W( to the proper node name \050as given in the client's SET PORT NET)65 W 6120 64372 MT (node command\051; REMOTE WHO is) 50 W( a satisfactory choice. The client machine actually issues a network Call to the)51 W 6120 65568 MT (server's node name to make a connection) 78 W( and then follows it with data packets holding the Kermit server request.)77 W 6120 66764 MT (The initial exchange of packets establishes a particular virtual circuit) 163 W( between the two nodes. If the connection)164 W 6120 67960 MT (cannot be started then the client Kermit reports this fact to the user. The most common causes of a failure at this)94 W 6120 69156 MT (point are:)SH 8120 70947 MT (1.)SH 9120 XM (The client Kermit did not specify the correct server Kermit node name \050spelling errors, wrong) 21 W( case for)22 W ES %%Page: 125 126 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.17.1. Kermit-MS/IBM on Local Area Networks)SH 10 /Times-Italic AF 51275 XM (Page 125)SH 46800 50 8280 5709 UL /Times-Roman SF 11280 7886 MT (letters, missing dot K\051,)SH 10280 10096 MT (2.)SH 11280 XM (One or both machines are using a network adapter board which is not) 39 W( the first in the machine; Kermit)38 W 11280 11201 MT (uses only the first board,)SH 10280 13411 MT (3.)SH 11280 XM (The LAN NetBIOS emulator does not fully support IBM standard virtual circuits,)SH 10280 15621 MT (4.)SH 11280 XM (The server machine was not started on the network before the client.)SH 8280 18013 MT (A virtual circuit will be broken if a sender or receiver gets no response to a request within a short time) SH( interval set by)1 W 8280 19209 MT (the LAN hardware/software. However, the LAN procedures within Kermit automatically) 163 W( reestablish the circuit)162 W 8280 20405 MT (transparently to the user when new information) 95 W( is communicated; the last used remote node name is remembered)96 W 8280 21601 MT (internally for this purpose. This also means the server Kermit will respond to a connection from a) 3 W( new client Kermit)2 W 8280 22797 MT (if the first client is idle for say a minute or so. A session can) 95 W( be terminated by the user by issuing the HANGUP)96 W 8280 23993 MT (command or by exiting Kermit. A session will not be broken this way if the user on the client Kermit changes to a)53 W 8280 25189 MT (regular serial port.)SH 8280 27581 MT (Finally, when Kermit returns control) 141 W( to DOS, but not via the PUSH command, its unique Kermit node name is)142 W 8280 28777 MT (removed from the network adapter board.)SH 8280 31169 MT (During network communications Kermit uses network packets holding 256 bytes of data. If both) 28 W( Kermits are given)27 W 8280 32365 MT (the command)SH /Courier SF 10680 34020 MT (SET RECEIVE PACKET 1000)SH /Times-Roman SF 8280 35737 MT (then the network and Kermit will be used to best efficiency. Experience has shown) 89 W( that the client Kermit should)90 W 8280 36933 MT (have its TIMER OFF because the server may be asked to do an operation) 38 W( via DOS which does not complete before)37 W 8280 38129 MT (the client side would timeout. An) 20 W( observation of some token passing networks indicates that Kermit packets slightly)21 W 8280 39325 MT (longer than 256, 512, etc bytes) 41 W( result in marked slowing down because the remaining small piece is not sent until a)40 W 8280 40521 MT (net timer expires. Carrier sense \050Ethernet, STARLAN\051 boards seem to be more agressive and export small packets)46 W 8280 41717 MT (immediately.)SH 8280 44109 MT (Support for the Ungermann-Bass Net/One network, with its NET Command Interface \050NETCI\051, was) 38 W( contributed by)37 W 8280 45305 MT (Renne Rehmann and Henrik) 45 W( Levkowetz. In addition to the SET PORT NET [nodename] command, which may be)46 W 8280 46501 MT (used to connect to other nodes on the net with the) 78 W( standard NetBIOS calls, NETCI provides the means to connect)77 W 8280 47697 MT (directly to serial ports on the Ungermann-Bass network. Use SET PORT UB-Net1) 88 W( and enter Connect mode. The)89 W 8280 48893 MT (NETCI prompt,)248 W /Courier SF 15359 XM (>>)SH /Times-Roman SF (, should appear and all the usual NETCI commands \050connect, get,) 248 W( list, resume, abandon,)247 W 8280 50089 MT (examine, identify, set, logout, quit\051 may be selected. This line is disconnected when) 9 W( Kermit exits. However, the line)10 W 8280 51285 MT (may be put on hold, exit Kermit, then later restart Kermit and give) 187 W( the SET PORT UB-Net1 and CONNECT)186 W 8280 52481 MT (commands, and Resume the line.)SH 8280 54873 MT (Some LANs intercept the normal serial port Bios interrupt) 86 W( 14H and masquerade as a modem. This service can be)87 W 8280 56069 MT (engaged within Kermit by the SET PORT BIOSn command, where n is 1,) 97 W( 2, 3, or 4, as appropriate for the LAN)96 W 8280 57265 MT (software. To work properly the LAN must support) 74 W( the same use of registers as the system Bios. Several X.25 and)75 W 8280 58461 MT (TCP/IP packages have been operated successfully) 10 W( with the SET PORT BIOSn command. Since this channel appears)9 W 8280 59657 MT (to Kermit) 187 W( as a simple software level serial port, Kermit provides neither interrupt driven i/o nor LAN session)188 W 8280 60853 MT (support.)SH 8280 63245 MT (Kermit can access files on the LAN file server via DOS even while using the LAN as) 69 W( a communications medium.)68 W 8280 64441 MT (Network administrators should note) 44 W( this point because a user operating Kermit in Server mode can allow his or her)45 W 8280 65637 MT (file server directories to be) 236 W( available to other network users also running Kermit, without additional security)235 W 8280 66833 MT (checking of the other users. The network drives visible to the Server) 145 W( Kermit can become devices available for)146 W 8280 68029 MT (Kermit-to-Kermit file transfers, etc, unless the DISABLE command is used to confine access to) 20 W( the current disk and)19 W 8280 69225 MT (directory. A corollary is when files are accessible to DOS commands they can become public.)SH ES %%Page: 126 127 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 126)SH 12 /Times-Bold AF 28285 XM (Kermit User Guide: MS-DOS KERMIT \0505.17.2\051)SH 46800 50 6120 5709 UL 6120 8004 MT (5.17.2. Use of Kermit-MS with External Device Drivers)SH 10 /Times-Roman AF 6120 9946 MT (It is often) 119 W( desirable to supplement or modify the behavior of a DOS program by loading it with special external)120 W 6120 11142 MT (device drivers. These drivers may operate at either the DOS or BIOS) 62 W( level. When Kermit-MS accesses the BIOS)61 W 6120 12338 MT (directly, DOS-level drivers are) 135 W( ineffective. When Kermit accesses the hardware directly, both the DOS and the)136 W 6120 13534 MT (BIOS level drivers are bypassed. Kermit-MS provides several mechanisms to allow) 4 W( these external drivers to operate)3 W 6120 14730 MT (as intended.)SH 6120 17122 MT (Here are a few examples:)SH /Symbol SF 7910 19027 MT (\267)SH /Times-Roman SF 8620 XM (IBM's)SH /Courier SF 11566 XM (ANSI.SYS)SH /Times-Roman SF 16701 XM (console driver operates at the DOS level. It allows the major IBM PC keys) 85 W( to be)86 W 8620 20132 MT (redefined, and) 55 W( also interprets selected ANSI-format escape sequences for screen control. It works fine)54 W 8620 21237 MT (at Kermit-MS command level, except) 162 W( SHOW KEY does not recognize strings assigned to keys via)163 W /Courier SF 8620 22342 MT (ANSI.SYS)SH /Times-Roman SF (, and) 323 W( fine at CONNECT level. To use)322 W /Courier SF 31900 XM (ANSI.SYS)SH /Times-Roman SF 37272 XM (at CONNECT level, issue the)322 W 8620 23447 MT (Kermit-MS commands SET KEY OFF \050to read) 3 W( keys via DOS\051 and SET TERMINAL NONE \050to display)4 W 8620 24552 MT (characters through DOS\051.)SH /Symbol SF 7910 26541 MT (\267)SH /Times-Roman SF 8620 XM (Blind people often have speaking or Braille machines) 58 W( attached to their PCs. DOS-level device drivers)57 W 8620 27646 MT (are generally) 93 W( used to redirect screen output to these devices, which works OK at DOS or MS-Kermit)94 W 8620 28751 MT (command level. SET TERMINAL NONE will allow) 54 W( this redirection to take place during CONNECT.)53 W 8620 29856 MT (But these devices also need to have the computer's output appear as) 43 W( a coherent stream of text, so users)44 W 8620 30961 MT (should also) 42 W( take care to inform the remote host to format its output for a "dumb" or hardcopy terminal.)41 W 8620 32066 MT (In addition, Kermit-MS' normal file transfer display does not mesh well with these devices, but) 12 W( that can)13 W 8620 33171 MT (be remedied using SET DISPLAY SERIAL.)SH /Symbol SF 7910 35160 MT (\267)SH /Times-Roman SF 8620 XM (People with motor impairments) 91 W( may be using special keyboard replacements supported by DOS-level)90 W 8620 36265 MT (device drivers. As with)17 W /Courier SF 18482 XM (ANSI.SYS)SH /Times-Roman SF (, Kermit-MS may be directed to use such keyboard drivers with the)18 W 8620 37370 MT (command SET KEY OFF.)SH /Symbol SF 7910 39359 MT (\267)SH /Times-Roman SF 8620 XM (Other keyboard drivers are available that work, like Kermit-MS, at BIOS) 175 W( level. Examples include)174 W 8620 40464 MT (ProKey and SuperKey. These may be used at) 109 W( DOS or Kermit-MS command level as well as during)110 W 8620 41569 MT (CONNECT.)SH /Symbol SF 7910 43558 MT (\267)SH /Times-Roman SF 8620 XM (Conceivably, drivers exist that allow DOS communication programs to emulate) 139 W( terminals other than)138 W 8620 44663 MT (ANSI. You) 316 W( should be able) 33 W( to use them, if they exist, in conjunction with Kermit-MS by telling Kermit)34 W 8620 45768 MT (to SET TERMINAL NONE, but the speed may not be high because of the intervening DOS calls.)SH 12 /Times-Bold AF 6120 48884 MT (5.17.3. Kermit-MS/IBM Serial Port Information)SH 10 /Times-Roman AF 6120 50826 MT (Kermit-MS for IBM PC's and compatibles does testing of serial ports before use. This section) 31 W( describes those tests)30 W 6120 52022 MT (so users may understand what Kermit does.)SH 6120 54414 MT (When a serial port is selected by) 186 W( the SET PORT COMx command Kermit looks at low memory addresses in)187 W 6120 55610 MT (segment 40H assigned to hold the base address of each) 106 W( COMx port; COM1 is in word 40:0H, COM2 is in word)105 W 6120 56806 MT (40:2H, and so on. If the value in the appropriate word is binary zero) 17 W( then Kermit declares the port to be unavailable.)18 W 6120 58002 MT (Otherwise, Kermit runs read-only \050i.e., safe\051 tests at the base address to validate the presence of an) 110 W( official 8250)109 W 6120 59198 MT (UART chip. If the tests fail Kermit indicates it will do i/o through the slow Bios pathway; some) 35 W( PC clones need to)36 W 6120 60394 MT (work this) 44 W( way even though the Bios has speed problems even at 1200 baud. Otherwise, interrupt driven i/o will be)43 W 6120 61590 MT (done through the 8250 UART \050that is, very fast\051.)SH 6120 63982 MT (There is a special case when a) 73 W( communications board is present, set for COM2, but a normal COM1 serial port is)74 W 6120 65178 MT (not. Kermit) 250 W( detects this situation.)SH 6120 67570 MT (Many machines now have more than two serial ports, but until) 50 W( recently there has been no standard about addresses)49 W 6120 68766 MT (for COM3 and COM4. PC DOS 3.30 does not assign them either because it) 21 W( is really a problem of the system ROM)22 W 6120 69962 MT (Bios boot) 1 W( code run when the power is turned on. However, Kermit will use COM3 and/or COM4 if the base address)SH 6120 71158 MT (of a port is placed in low memory words 40:4H \050COM3\051 or) 140 W( 40:6H \050COM4\051; the tests described above are then)141 W ES %%Page: 127 128 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.17.3. Kermit-MS/IBM Serial Port Information)SH 10 /Times-Italic AF 51275 XM (Page 127)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (carried out. One restriction is that the) 125 W( Interrupt ReQuest number \050IRQ in the serial port board manual\051 must be)124 W 8280 9082 MT (either IRQ4 or IRQ3. Kermit attempts to locate) 19 W( which line is correct with a short test. If the test is not successful it)20 W 8280 10278 MT (uses the IRQ4 for COM3 \050and for COM1\051 and IRQ3 for COM4 \050and for COM2\051 on the PC/AT, and on the) 48 W( PS/2 it)47 W 8280 11474 MT (uses IRQ3 for COM2, COM3, and COM4. Check the board and its manual.) 71 W( DOS) 393 W( utility DEBUG can be used to)72 W 8280 12670 MT (create a short program to insert the board's addresses into the segment) 36 W( 40H memory locations; a sample program is)35 W 8280 13866 MT (given below.)SH 46800 50 8280 15857 UL 9280 18772 MT (Serial Port)SH 20080 XM (Address)SH 28720 XM (IRQ Line)SH 40600 XM (Conventions)SH 4250 50 9280 18972 UL 3277 50 20080 18972 UL 3805 50 28720 18972 UL 5056 50 40600 18972 UL 9280 19877 MT (COM1)SH 20080 XM (03F8H)SH 28720 XM (4)SH 40600 XM (IBM standard)SH 9280 20982 MT (COM2)SH 20080 XM (02F8H)SH 28720 XM (3)SH 40600 XM (IBM standard)SH 9280 22087 MT (COM3)SH 20080 XM (?)SH 28720 XM (4 \0503 for PS/2\051)SH 40600 XM (Board)SH 9280 23192 MT (COM4)SH 20080 XM (?)SH 28720 XM (3)SH 40600 XM (Board)SH /Times-Bold SF 21499 24983 MT (Table 5-13:)SH /Times-Roman SF 26860 XM (IBM PC/XT/AT Serial Port Numbers)SH 46800 50 8280 26793 UL 8280 28985 MT (The addresses shown as query marks are to be found in the board's reference manual; values) 120 W( such as 2E8H and)121 W 8280 30181 MT (2E0H would be common. However, there is no standard for anything to do with COM3 and COM4 on non-PS/2's.)SH 8280 32573 MT (Assuming that you have selected an address in harmony) 39 W( with the rest of the system \050good luck on that part\051, set the)38 W 8280 33769 MT (board's switches or jumpers, and use DEBUG to insert the address\050es\051 in segment 40H memory.) 147 W( The) 546 W( example)148 W 8280 34965 MT (below creates a small program named)131 W /Courier SF 24451 XM (SETCOM3.COM)SH /Times-Roman SF 31432 XM (to put address 02E8H into the memory word 40:04H) 131 W( for)130 W 8280 36161 MT (COM3 and writes the program to drive A. \050Disregard the xxxx items below\051:)SH /Courier SF 10680 37876 MT (A> DEBUG)SH /Times-Italic SF 29880 XM (don't type these comments)SH /Courier SF 10680 38907 MT (-n a:setcom3.com)SH /Times-Italic SF 29880 XM (sets name of output file)SH /Courier SF 10680 39938 MT (-a)SH /Times-Italic SF 29880 XM (assemble command)SH /Courier SF 10680 40969 MT (xxxx:100 mov ax,40)SH /Times-Italic SF 29880 XM (value 40h)SH /Courier SF 10680 42000 MT (xxxx:103 mov es,ax)SH /Times-Italic SF 29880 XM (put it into register es)SH /Courier SF 10680 43031 MT (xxxx:105 mov ah,02)SH /Times-Italic SF 29880 XM (the 02 part of 02E8H)SH /Courier SF 10680 44062 MT (xxxx:107 mov al,e8)SH /Times-Italic SF 29880 XM (the E8 part of same)SH /Courier SF 10680 45093 MT (xxxx:109 es:)SH 10680 46124 MT (xxxx:10A mov [4],ax)SH /Times-Italic SF 29880 XM (store in 40:4 for com3 \050[6] for com4\051)SH /Courier SF 10680 47155 MT (xxxx:10D int 20)SH /Times-Italic SF 29880 XM (return to DOS)SH /Courier SF 10680 48186 MT (xxxx:10F)SH /Times-Italic SF 29880 XM (blank line to end assemble mode)SH /Courier SF 10680 49217 MT (-r cx)SH /Times-Italic SF 29880 XM (show contents of register cx)SH /Courier SF 10680 50248 MT (CX 0000)SH 10680 51279 MT (: 0f)SH /Times-Italic SF 29880 XM (set register cx to write 0fh bytes)SH /Courier SF 10680 52310 MT (-w)SH /Times-Italic SF 29880 XM (write material to the disk file)SH /Courier SF 10680 53341 MT (-q)SH /Times-Italic SF 29880 XM (quit debug)SH /Courier SF 10680 54372 MT (A> DEBUG setcom3.com)SH 10680 55403 MT (-u)SH /Times-Italic SF 29880 XM (unassemble to see if all is well)SH /Courier SF 10680 56434 MT (-q)SH /Times-Italic SF 29880 XM (quit debug)SH /Times-Roman SF 8280 58151 MT (Note, for COM4, use)157 W /Courier SF 17629 XM ([6])SH /Times-Roman SF 19836 XM (above rather than)157 W /Courier SF 27499 XM ([4])SH /Times-Roman SF (, and of course employ your board's port) 157 W( address in place of)158 W 8280 59347 MT (02E8H \050check the manual\051. Finally, try it:)SH /Courier SF 10680 61062 MT (A> setcom3)SH /Times-Italic SF 29880 XM (run the program)SH /Courier SF 10680 62093 MT (A> DEBUG)SH /Times-Italic SF 29880 XM (now see what's down there)SH /Courier SF 10680 63124 MT (-d 40:00)SH /Times-Italic SF 29880 XM (display bytes in seg 40H)SH 14880 64839 MT (\050 Shows many bytes. See yours? Good. \051)SH /Courier SF 10680 66494 MT (-q)SH 10680 67525 MT (A>)SH /Times-Roman SF 8280 69917 MT (A small side effect noted in) 31 W( practice is the first time the extra port is used there may be garbage from it. Just return)30 W 8280 71113 MT (to the) 17 W( Kermit prompt and try again, if necessary SET PORT to the other COM lines momentarily, all should be well)18 W ES %%Page: 128 129 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 128)SH 12 /Times-Bold AF 28285 XM (Kermit User Guide: MS-DOS KERMIT \0505.17.3\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (the second time.)SH 6120 10278 MT (More technical comments, for those with an interest. When Kermit finishes with) 15 W( a port it disables interrupts for that)14 W 6120 11474 MT (serial port) 70 W( and returns the IRQ signal line to its state found when Kermit started since many devices can share the)71 W 6120 12670 MT (same Interrupt ReQuest line but only one) 2 W( device at a time can be active on it. If you find that transmissions are good)1 W 6120 13866 MT (but there is no reception) 80 W( then another device has stolen the IRQ; disable it or find a guru. Kermit will work with)81 W 6120 15062 MT (non-standard addresses for COM1 and COM2 but the IRQ's must) 5 W( be as in the table above. Accessing a non-existent)4 W 6120 16258 MT (port produces a message and all communications are discarded safely in the bit bucket.)SH 12 /Times-Bold AF 6120 19374 MT (5.17.4. CTTY COMx for IBM Machines)SH 10 /Times-Roman AF 6120 21316 MT (The DOS command) 327 W( CTTY COMx redirects the standard input and output from the keyboard and screen,)328 W 6120 22512 MT (respectively, to the indicated communications channel.) 70 W( If) 388 W( a Kermit Server is operated this way, "through the back)69 W 6120 23708 MT (port", then both DOS and Kermit can access the port hardware simultaneously; a deadlock) 214 W( develops on IBM)215 W 6120 24904 MT (machines. The) 250 W( items below refer to only the IBM version of Kermit-MS.)SH 6120 27296 MT (Kermit-MS/IBM version 2.31 successfully resolves the) 90 W( deadlock in the following manner. When Kermit requires)89 W 6120 28492 MT (the serial port it also attaches itself to Interrupt 16H, the Bios RS232) 172 W( serial port routine. Code within Kermit)173 W 6120 29688 MT (receives the DOS serial port requests via Interrupt) 51 W( 14H and either passes the request to the Bios if the COM line is)50 W 6120 30884 MT (not that used by Kermit or it handles the request internally for conflicting situations. When the same port) 17 W( is used by)18 W 6120 32080 MT (both DOS and Kermit, Kermit discards DOS output material \050typically a) 87 W( prompt, but could be the dreaded Abort,)86 W 6120 33276 MT (Retry, Ignore message\051 and returns a success code to DOS, it) 32 W( returns an ascii Backspace code to DOS read requests)33 W 6120 34472 MT (\050this is) 1 W( a key item to keep DOS complacent while Kermit communicates\051, and it returns reasonable status for modem)SH 6120 35668 MT (status. The) 434 W( interception ceases when) 92 W( Kermit releases the port, such as when the Kermit prompt is displayed, and)93 W 6120 36864 MT (this lets DOS converse out the serial port.)SH 6120 39256 MT (It is worth restating that a large number of programs bypass DOS to achieve higher performance.) 167 W( When) 583 W( such)166 W 6120 40452 MT (programs are started through the back door they may still require input from the real keyboard and will) 176 W( hang,)177 W 6120 41648 MT (waiting for it. There) 45 W( is nothing to do about this situation except a\051 don't let it happen, b\051 contact the local operator)44 W 6120 42844 MT (to push some keys.)SH 12 /Times-Bold AF 6120 45960 MT (5.17.5. Screen Sizes and the EGA Board, IBM Versions)SH 10 /Times-Roman AF 6120 47902 MT (Support has been included for Enhanced Graphics Adapter \050EGA\051 video display boards which can be configured for)16 W 6120 49098 MT (other than the standard 80 columns by 25 lines, say 132 columns or 43 lines or other. Several boards,) 94 W( the Tseng)93 W 6120 50294 MT (Labs EVA \050also Orchid Designer\051 board with the) 143 W( 132 column kit installed, the ATI EGA Wonder, the Video 7)144 W 6120 51490 MT (Deluxe and VGA, and the Everex EV-659 \050ega\051 and EV-673 \050vga\051, can be controlled directly by) 36 W( Kermit for 80/132)35 W 6120 52686 MT (column changes. Other boards need to be placed in the desired display mode by the user. Kermit then adapts to) 19 W( the)20 W 6120 53882 MT (settings if the board) 131 W( obeys standard rules for using the Bios EGA memory areas in segment 40H. The Video-7)130 W 6120 55078 MT (boards have been used successfully in all screen sizes, including 132 columns by 43 lines, with an NEC) 57 W( Multisync)58 W 6120 56274 MT (monitor.)SH 6120 58666 MT (The IBM EGA board has) 51 W( several noteworthy bugs which are now standards. One is the cursor dots are not always)50 W 6120 59862 MT (on the correct) 52 W( scan lines when the number of screen lines is other than 25. Kermit-MS attempts to compensate for)53 W 6120 61058 MT (this attribute. Screen roll back space is fixed in) 137 W( size so there are fewer pages for more dense screens; standard)136 W 6120 62254 MT (screens use an internal buffer, non-standard screens use) 19 W( a buffer plus video page 1.)20 W /Courier SF 39772 XM (ANSI.SYS)SH /Times-Roman SF 44842 XM (is hard coded for 25)20 W 6120 63450 MT (line displays so all) 236 W( DOS i/o will eventually overwrite itself on line 25; the emulator does not use DOS i/o.)235 W 6120 64646 MT (Commercial replacements for)SH /Courier SF 18256 XM (ANSI.SYS)SH /Times-Roman SF 23306 XM (should be able to use all screen lines.)SH 6120 67038 MT (Screen dumps work correctly if done with) 4 W( Kermit commands. DOS PrintScreen may or may not, depending on your)5 W 6120 68234 MT (EGA board. Graphics dumps are not managed by Kermit.)SH 6120 70626 MT (When the VT102 receives escape) 7 W( sequences to change between 80 and 132 column modes the screen is reset and the)6 W 6120 71822 MT (ATI EGA Wonder, or Everex) 46 W( EV-659 \050ega\051 or EV-673 \050vga\051, Tseng Labs \050and Orchid Designer\051, or Video 7 Vega)47 W ES %%Page: 129 130 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (5.17.5. Screen Sizes and the EGA Board, IBM Versions)SH 10 /Times-Italic AF 51275 XM (Page 129)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (or VGA board is) 83 W( asked to change modes \050but only if that board is present\051; other display adapters are left in their)82 W 8280 9082 MT (current state. The right margin is enforced strongly so a board in 132 column) 38 W( mode will not display material to the)39 W 8280 10278 MT (right of column 80 if the emulator is in 80 column mode.) 153 W( Similarly,) 555 W( material to the right of column 80 is not)152 W 8280 11474 MT (preserved in the emulator if the display adapter is operating) 106 W( in 80 column mode; real VT102s keep that invisible)107 W 8280 12670 MT (material in hardware memory whereas the emulator does not.)SH 8280 15062 MT (Reference is made to) 73 W( line 25 in the emulator; this is normally the status/mode line in Kermit. Real VT102's have)72 W 8280 16258 MT (only 24 line displays. If the display adapter is set for a) 95 W( different number of lines per screen then the 25th line is)96 W 8280 17454 MT (interpreted to mean the bottom display) 103 W( adapter line, such as line 43. Should the host access the status/mode line)102 W 8280 18650 MT (then the line is declared to be disabled \050same as SET MODE OFF\051 so that Kermit's own status information does not)18 W 8280 19846 MT (overwrite the host's when the screen is restored. Toggling a disabled mode line has no effect; only SET MODE ON)14 W 8280 21042 MT (will enable it again. The Heath-19 terminal has the unusual feature) 49 W( that disabling the mode line)50 W /Courier SF 47669 XM (\050ESC y 1\051)50 W /Times-Roman SF 53469 XM (also)SH 8280 22238 MT (clears it.)SH 12 /Times-Bold AF 8280 25354 MT (5.17.6. Kermit-MS/IBM Printer Control)SH 10 /Times-Roman AF 8280 27296 MT (The IBM PC) 22 W( MS-Kermit VT102 terminal emulator also supports full transparent printing of 8-bit binary bytes. The)21 W 8280 28492 MT (escape sequence ``)19 W /Courier SF (ESC [ 5) 19 W( i)20 W /Times-Roman SF ('' turns on transparent printing, in which all further 8-bit characters are sent directly)20 W 8280 29688 MT (to the printer, bypassing the SET TRANSLATION INPUT filter,) 10 W( and are not shown on the screen. Escape sequence)9 W 8280 30884 MT (``)SH /Courier SF (ESC [ 4 i)69 W /Times-Roman SF ('' turns) 69 W( off transparent printing and the escape sequence is not sent to the printer. Non-transparent)70 W 8280 32080 MT (printing is controlled by the ``)210 W /Courier SF (ESC [ ?) 210 W( 5 i)209 W /Times-Roman SF ('' and ``)209 W /Courier SF (ESC [ ? 4 i)209 W /Times-Roman SF ('' sequences. Such printing simply)209 W 8280 33276 MT (duplicates text intended for the screen, excluding escape sequences. The text also appears on the screen.)SH 8280 35668 MT (Kermit-MS accesses the system printer through DOS calls several ways;) 21 W( neither the Bios nor the hardware are used.)22 W 8280 36864 MT (Files directed to the printer by the SET DESTINATION PRINTER) 36 W( command are written by opening a file with the)35 W 8280 38060 MT (name PRN \050DOS's name for the system printer\051 and writing to it the same as) 71 W( to a disk file; DOS provides limited)72 W 8280 39256 MT (buffering. LOGging) 364 W( to device PRN works the same way, as can be noticed by the last line or so) 57 W( not being printed)56 W 8280 40452 MT (until the log file) 81 W( is CLOSED. DOS is used again while emulating a terminal in CONNECT mode. If the VT102)82 W 8280 41648 MT (emulator found in the IBM PC is used for) 87 W( transparent or Controller printing, single characters are written to DOS)86 W 8280 42844 MT (file handle 4, the DOS standard print device. If the screen is echoed to the printer via the) 34 W( typical Control PrtSc key)35 W 8280 44040 MT (combination, or equivalent, single characters are) 7 W( written by the DOS function 05H Printer Output call. In both cases)6 W 8280 45236 MT (of terminal emulation the) 38 W( printer's ready status is found by the DOS IOCTL 44H call. Only the Control PrtSc case)39 W 8280 46432 MT (results in the PRN message being displayed on the) 50 W( status line. Finally, the classical IBM PC Shift PrtSc command)49 W 8280 47628 MT (to copy) 6 W( the whole screen to the printer is unknown to Kermit because the system Bios traps the key combination and)7 W 8280 48824 MT (does not tell Kermit about it. If the Control P command is given to DOS) 36 W( before Kermit starts then again characters)35 W 8280 50020 MT (are echoed by the system Bios without Kermit's knowledge; this situation can result in lost characters.)SH 8280 52412 MT (Print spoolers generally operate by being told an existing filename) 32 W( and then in the background they steal cpu cycles)33 W 8280 53608 MT (to read from disk and write to the printer. The DOS PRINT command invokes such a spooler. Although an active)45 W 8280 54804 MT (Kermit does not feed these software) 163 W( programs directly the spooler and Kermit can compete for cpu cycles and)164 W 8280 56000 MT (characters can be lost. If a non-DOS) 153 W( resident program intercepts characters destined for the printer device and)152 W 8280 57196 MT (spools them Kermit does not know about it and similar competion can occur.)SH 8280 59588 MT (During file transfers printing is carefully sequenced to) 214 W( occur only when the local Kermit is in control of the)215 W 8280 60784 MT (communications line so that a small pause will not result in) 113 W( missing characters arriving at the serial port. When)112 W 8280 61980 MT (terminal emulation is active then printing competes for cpu time with the serial port routines. Generally,) 57 W( the serial)58 W 8280 63176 MT (port wins such contests if the port is interrupt driven \050Generic Kermit is not interrupt driven, so) 31 W( beware\051. However,)30 W 8280 64372 MT (the printing itself can use enough cpu cycles to delay processing of characters to the screen and) 156 W( eventually the)157 W 8280 65568 MT (receive buffer of the serial port) 13 W( fills to the high water mark and an XOFF flow control character is sent to the host to)12 W 8280 66764 MT (suspend further transmissions until we send an XON. If FLOW) 83 W( is NONE then expect lost characters at the serial)84 W 8280 67960 MT (port. Experience) 378 W( with ordinary IBM PC's through 80386 machines at very high baud rates indicates) 64 W( no characters)63 W 8280 69156 MT (are lost when FLOW) 20 W( is XON/XOFF. However, it is possible on some machines for the printer to have priority over)21 W 8280 70352 MT (the serial port, and hence to have lost characters, especially if a) 228 W( Terminate Stay Resident program intercepts)227 W 8280 71548 MT (characters destined for the printer and keeps interrupts turned off too long.)SH ES %%Page: 130 131 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 130)SH 12 /Times-Bold AF 30685 XM (Kermit User Guide: MS-DOS KERMIT \0506\051)SH 46800 50 6120 5709 UL ES %%Page: 131 132 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (6. UNIX KERMIT)SH 10 /Times-Italic AF 51275 XM (Page 131)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 8280 8272 MT (6. UNIX KERMIT)SH 10 /Times-Italic AF 8280 10566 MT (Program:)SH /Times-Roman SF 14280 XM (Frank da Cruz, Bill Catchings, Jeff Damens, Columbia University;) 261 W( Herm Fischer, Encino CA;)262 W 14280 11671 MT (contributions by many others.)SH /Times-Italic SF 8280 12776 MT (Language:)SH /Times-Roman SF 14280 XM (C)SH /Times-Italic SF 8280 13881 MT (Documentation:)SH /Times-Roman SF 14280 14986 MT (Christine Gianone, Frank da Cruz)SH /Times-Italic SF 8280 16091 MT (Version:)SH /Courier SF 14280 XM (4E\050070\051)SH /Times-Italic SF 8280 17196 MT (Date:)SH /Times-Roman SF 14280 XM (January 24, 1988)SH 8280 19588 MT (C-Kermit is an implementation of Kermit, written modularly) 103 W( and transportably in C. The protocol state transition)104 W 8280 20784 MT (table is written in)98 W /Times-Italic SF 15894 XM (wart)SH /Times-Roman SF (, a) 98 W( \050non-proprietary\051 lex-like preprocessor for C. System-dependent primitive functions are)97 W 8280 21980 MT (isolated into separately compiled modules so that the program should) 88 W( be easily portable among Unix systems and)89 W 8280 23176 MT (also to) 138 W( non-Unix systems that have C compilers, such as VAX/VMS, Data General AOS/VS, Apollo Aegis, the)137 W 8280 24372 MT (Apple Macintosh, and the Commodore) 6 W( Amiga. This document applies to Unix implementations of C-Kermit, and in)7 W 8280 25568 MT (most ways also to the VMS, Data General, and other implementations.)SH 12 /Times-Bold AF 8280 28156 MT (Unix Kermit Capabilities At A Glance:)SH 10 /Times-Roman AF 9280 29947 MT (Local operation:)SH 34480 XM (Yes)SH 9280 31052 MT (Remote operation:)SH 34480 XM (Yes)SH 9280 32157 MT (Login scripts:)SH 34480 XM (Yes \050UUCP style\051)SH 9280 33262 MT (Transfer text files:)SH 34480 XM (Yes)SH 9280 34367 MT (Transfer binary files:)SH 34480 XM (Yes)SH 9280 35472 MT (Wildcard send:)SH 34480 XM (Yes)SH 9280 36577 MT (File transfer interruption:)SH 34480 XM (Yes)SH 9280 37682 MT (Filename collision avoidance:)SH 34480 XM (Yes)SH 9280 38787 MT (Can time out:)SH 34480 XM (Yes)SH 9280 39892 MT (8th-bit prefixing:)SH 34480 XM (Yes)SH 9280 40997 MT (Repeat count prefixing:)SH 34480 XM (Yes)SH 9280 42102 MT (Alternate block checks:)SH 34480 XM (Yes)SH 9280 43207 MT (Terminal emulation:)SH 34480 XM (Yes)SH 9280 44312 MT (Communication settings:)SH 34480 XM (Yes)SH 9280 45417 MT (Transmit BREAK:)SH 34480 XM (Yes \050most versions\051)SH 9280 46522 MT (Support for dialout modems:)SH 34480 XM (Yes)SH 9280 47627 MT (IBM mainframe communication:)SH 34480 XM (Yes)SH 9280 48732 MT (Transaction logging:)SH 34480 XM (Yes)SH 9280 49837 MT (Session logging:)SH 34480 XM (Yes)SH 9280 50942 MT (Debug logging:)SH 34480 XM (Yes)SH 9280 52047 MT (Packet logging:)SH 34480 XM (Yes)SH 9280 53152 MT (Act as server:)SH 34480 XM (Yes)SH 9280 54257 MT (Talk to server:)SH 34480 XM (Yes)SH 9280 55362 MT (Advanced server functions:)SH 34480 XM (Yes)SH 9280 56467 MT (Local file management:)SH 34480 XM (Yes)SH 9280 57572 MT (Command/Init files:)SH 34480 XM (Yes)SH 9280 58677 MT (UUCP and multiuser line locking:)SH 34480 XM (Yes)SH 9280 59782 MT (Long packets:)SH 34480 XM (Yes)SH 9280 60887 MT (Sliding Windows:)SH 34480 XM (No)SH 9280 61992 MT (File attributes packets:)SH 34480 XM (No)SH 9280 63097 MT (Command macros:)SH 34480 XM (No)SH 9280 64202 MT (Raw file transmit:)SH 34480 XM (No)SH /Times-Italic SF 8280 66594 MT (All numbers in the C-Kermit documentation are decimal unless noted otherwise.)SH /Times-Roman SF 8280 68986 MT (C-Kermit provides traditional Unix command line operation as) 291 W( well as interactive command prompting and)290 W 8280 70182 MT (execution. The) 458 W( command line options provide access to a basic subset of) 104 W( C-Kermit's capabilities; the interactive)105 W 8280 71378 MT (command set is far richer.)SH ES %%Page: 132 133 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 132)SH 12 /Times-Bold AF 32287 XM (Kermit User Guide: UNIX KERMIT \0506\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (On systems with dialout modems, C-Kermit's command file, DIAL command, and login script) 76 W( facilities provide a)75 W 6120 9082 MT (counterpart to UUCP for file transfer with non-UNIX operating systems, including) 97 W( the use of scheduled \050e.g. late)98 W 6120 10278 MT (night\051 unattended operation.)SH 14 /Times-Bold AF 6120 13880 MT (6.1. The Unix File System)SH 10 /Times-Roman AF 6120 15998 MT (Consult your Unix manual for details about) 41 W( the file system under your version of Unix. In general, Unix files have)40 W 6120 17194 MT (lowercase names, possibly containing one or more dots or other special characters. Unix directories are tree-)200 W 6120 18390 MT (structured. Directory) 250 W( levels are separated by slash \050``)SH /Courier SF (/)SH /Times-Roman SF (''\051 characters. For example,)SH /Courier SF 8520 20045 MT (/usr/foo/bar)SH /Times-Roman SF 6120 21762 MT (denotes the file)71 W /Courier SF 12692 XM (bar)SH /Times-Roman SF 14812 XM (in the directory)70 W /Courier SF 21382 XM (/usr/foo)SH /Times-Roman SF (. Alphabetic) 390 W( case is significant in Unix file and directory names,)70 W 6120 22958 MT (i.e. ``)146 W /Courier SF (a)SH /Times-Roman SF ('' is a different) 146 W( file \050or directory\051 from ``)147 W /Courier SF (A)SH /Times-Roman SF (''. Wildcard) 544 W( or "meta" characters allow groups of files to be)147 W 6120 24154 MT (specified. ``)250 W /Courier SF (*)SH /Times-Roman SF ('' matches any string; ``)SH /Courier SF (?)SH /Times-Roman SF ('' matches any single character.)SH 6120 26546 MT (When C-Kermit is invoked with file arguments specified on) 56 W( the Unix command line, the Unix shell \050Bourne Shell,)55 W 6120 27742 MT (C-Shell, K-Shell, etc\051 expands the meta characters itself, and in this case a wider variety is available. For example,)SH /Courier SF 8520 29397 MT (kermit -s ~/ck[uvm]*.{upd,bwr}])SH /Times-Roman SF 6120 31114 MT (is expanded) 72 W( by the Berkeley C-Shell into a list of all the files in the user's home directory \050)73 W /Courier SF (~/)SH /Times-Roman SF (\051 that start with the)73 W 6120 32310 MT (characters ")46 W /Courier SF (ck)SH /Times-Roman SF (", followed by a single character ``)46 W /Courier SF (u)SH /Times-Roman SF ('', ``)46 W /Courier SF (v)SH /Times-Roman SF ('', or ``)46 W /Courier SF (m)SH /Times-Roman SF ('', followed by zero) 46 W( or more characters, followed)45 W 6120 33506 MT (by a dot, followed by one of the strings ``)72 W /Courier SF (upd)SH /Times-Roman SF ('' or ``)72 W /Courier SF (bwr)SH /Times-Roman SF (''. Internally,) 394 W( the C-Kermit program itself expands only)73 W 6120 34702 MT (the ``)SH /Courier SF (*)SH /Times-Roman SF ('' and ``)SH /Courier SF (?)SH /Times-Roman SF ('' meta characters.)SH 6120 37094 MT (Unix files are linear \050sequential\051 streams of 8-bit bytes. Text files consist of 7-bit ASCII characters, with) 47 W( the high-)46 W 6120 38290 MT (order bit) 201 W( off \0500\051, and lines separated by the Unix newline character, which is linefeed \050LF, ASCII 10\051. This)202 W 6120 39486 MT (distinguishes Unix text files from those on most other ASCII systems, in) 93 W( which lines are separated by a carriage-)92 W 6120 40682 MT (return linefeed sequence \050CRLF, ASCII 13, followed by linefeed, ASCII 10\051.) 29 W( Binary) 310 W( files are likely to contain data)30 W 6120 41878 MT (in the high bits of the file bytes, and have no particular line or record structure.)SH 6120 44270 MT (When transferring files, C-Kermit will convert between upper and lower case filenames and between LF and CRLF)35 W 6120 45466 MT (line terminators automatically, unless told to do otherwise. When binary files must be transferred,) 8 W( the program must)9 W 6120 46662 MT (be instructed not to perform LF/CRLF conversion \050)71 W /Courier SF (-i)SH /Times-Roman SF 28720 XM (on the command line or "set file type) 71 W( binary" interactively;)70 W 6120 47858 MT (see below\051.)SH 14 /Times-Bold AF 6120 51460 MT (6.2. File Transfer)SH 10 /Times-Roman AF 6120 53578 MT (If C-Kermit is in local mode, the screen \050stdout\051 is continously updated to show the progress of) 58 W( the file transer. A)59 W 6120 54774 MT (dot is printed for every four data packets, other packets are shown by type:)SH 8120 56565 MT (I)SH 9120 XM (Exchange Parameter Information)SH 8120 57670 MT (R)SH 9120 XM (Receive Initiate)SH 8120 58775 MT (S)SH 9120 XM (Send Initiate)SH 8120 59880 MT (F)SH 9120 XM (File Header)SH 8120 60985 MT (G)SH 9120 XM (Generic Server Command)SH 8120 62090 MT (C)SH 9120 XM (Remote Host Command)SH 8120 63195 MT (N)SH 9120 XM (Negative Acknowledgement \050NAK\051)SH 8120 64300 MT (E)SH 9120 XM (Fatal Error)SH 8120 65405 MT (T)SH 9120 XM (Indicates a timeout occurred)SH 8120 66510 MT (Q)SH 9120 XM (Indicates a damaged, undesired, or illegal packet was received)SH /Courier SF 8120 67615 MT (%)SH /Times-Roman SF 9120 XM (Indicates a packet was retransmitted)SH 6120 69406 MT (You may type certain "interrupt" commands during file transfer:)SH 8120 71197 MT (Control-F:)SH 14120 XM (Interrupt the current File, and go on to the next \050if any\051.)SH ES %%Page: 133 134 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (6.2. File Transfer)SH 10 /Times-Italic AF 51275 XM (Page 133)SH 46800 50 8280 5709 UL /Times-Roman SF 10280 7886 MT (Control-B:)SH 16280 XM (Interrupt the entire Batch of files, terminate the transaction.)SH 10280 8991 MT (Control-R:)SH 16280 XM (Resend the current packet)SH 10280 10096 MT (Control-A:)SH 16280 XM (Display a status report for the current transaction.)SH 8280 11887 MT (These interrupt) 264 W( characters differ from the ones used in other Kermit implementations to avoid conflict with)263 W 8280 13083 MT (commonly used Unix shell interrupt) 145 W( characters. With Version 7, System III, and System V implementations of)146 W 8280 14279 MT (Unix, interrupt commands must be preceeded by the 'connect' escape character \050e.g.) 10 W( normally-)9 W /Courier SF (\134)SH /Times-Roman SF (\051. Ctrl-F) 268 W( and Ctrl-B)9 W 8280 15475 MT (are effective only) 51 W( during the transfer of data \050D\051 packets, and cannot be used to interrupt a transfer that has not yet)52 W 8280 16671 MT (reached that stage.)SH /Times-Italic SF 10280 18462 MT (CAUTION:)SH /Times-Roman SF 15635 XM (If Control-F or Control-B is) 122 W( used to cancel an incoming file, and a file of the same name)121 W 10280 19567 MT (previously existed,)102 W /Times-Italic SF 18289 XM (and)SH /Times-Roman SF 20141 XM (the "file warning" feature is not enabled, then the) 102 W( previous copy of the file will)103 W 10280 20672 MT (disappear.)SH /Times-Italic SF 8280 23064 MT (EMERGENCY EXIT:)12 W /Times-Roman SF 17399 XM (When running Unix Kermit in remote) 12 W( mode, if you have started a protocol operation \050sending)11 W 8280 24260 MT (or receiving a file, server command) 41 W( wait, etc\051, you will not be able to communicate with the terminal in the normal)42 W 8280 25456 MT (way. In) 374 W( particular, you cannot stop the protocol by typing the normal Unix interrupt characters,) 62 W( since the terminal)61 W 8280 26652 MT (has been put in "raw mode". If you need to regain control quickly) 70 W( -- for instance, because the protocol is stuck --)71 W 8280 27848 MT (you can type two Control-C's directly to the Unix Kermit program \050"connect" first if necessary\051:)SH 10280 29368 MT (Control-C Control-C)SH 8280 30888 MT (This will cause the program to exit and restore the terminal to normal.)SH 14 /Times-Bold AF 8280 34490 MT (6.3. Command Line Operation)SH 10 /Times-Roman AF 8280 36608 MT (The C-Kermit) 97 W( command line syntax conforms to the Proposed Syntax Standards for Unix System Commands put)96 W 23187 50 30269 36808 UL 8280 37804 MT (forth by Kathy Hemenway and Helene Armitage of AT&T Bell Laboratories in)SH /Times-Italic SF 40329 XM (Unix/World)SH /Times-Roman SF (, Vol.1, No.3, 1984.) SH( The)252 W 8280 39000 MT (rules that apply are:)SH /Symbol SF 10070 40905 MT (\267)SH /Times-Roman SF 10780 XM (Command names must be between 2 and 9 characters \050"kermit" is 6\051.)SH /Symbol SF 10070 42010 MT (\267)SH /Times-Roman SF 10780 XM (Command names must include lower case letters and digits only.)SH /Symbol SF 10070 43115 MT (\267)SH /Times-Roman SF 10780 XM (An option name is a single character.)SH /Symbol SF 10070 44220 MT (\267)SH /Times-Roman SF 10780 XM (Options are delimited by ')SH /Courier SF (-)SH /Times-Roman SF ('.)SH /Symbol SF 10070 45325 MT (\267)SH /Times-Roman SF 10780 XM (Options with no arguments may be grouped \050bundled\051 behind one delimiter.)SH /Symbol SF 10070 46430 MT (\267)SH /Times-Roman SF 10780 XM (Option-arguments cannot be optional.)SH /Symbol SF 10070 47535 MT (\267)SH /Times-Roman SF 10780 XM (Arguments immediately follow options, separated by whitespace.)SH /Symbol SF 10070 48640 MT (\267)SH /Times-Roman SF 10780 XM (The order of options does not matter.)SH /Symbol SF 10070 49745 MT (\267)SH /Times-Roman SF 10780 XM (')SH /Courier SF (-)SH /Times-Roman SF (' preceded and followed by whitespace means standard input.)SH 8280 51536 MT (A group of bundled options may end with an option that has an argument.)SH 8280 53928 MT (The following notation is used in command descriptions:)SH /Times-Italic SF 8280 55719 MT (fn)SH /Times-Roman SF 12280 XM (A Unix file specification, possibly containing the "wildcard" characters `)250 W /Courier SF (*)SH /Times-Roman SF (' or `)250 W /Courier SF (?)SH /Times-Roman SF (' \050`)250 W /Courier SF (*)SH /Times-Roman SF (' matches all)249 W 12280 56824 MT (character strings, `)SH /Courier SF (?)SH /Times-Roman SF (' matches) 250 W( any single character\051.)SH /Times-Italic SF 8280 58401 MT (fn1)SH /Times-Roman SF 12280 XM (A Unix file specification which may not contain `)SH /Courier SF (*)SH /Times-Roman SF (' or `)SH /Courier SF (?)SH /Times-Roman SF ('.)SH /Times-Italic SF 8280 59978 MT (rfn)SH /Times-Roman SF 12280 XM (A remote file specification in the remote system's own syntax, which) 49 W( may denote a single file or a group)50 W 12280 61083 MT (of files.)SH /Times-Italic SF 8280 62660 MT (rfn1)SH /Times-Roman SF 12280 XM (A remote file specification which should denote only a single file.)SH /Times-Italic SF 8280 64237 MT (n)SH /Times-Roman SF 12280 XM (A decimal number between 0 and 94.)SH /Times-Italic SF 8280 65814 MT (c)SH /Times-Roman SF 12280 XM (A decimal number between 0 and 127 representing the value of an ASCII character.)SH /Times-Italic SF 8280 67391 MT (cc)SH /Times-Roman SF 12280 XM (A decimal number between 0) 148 W( and 31, or else exactly 127, representing the value of an ASCII control)147 W 12280 68496 MT (character.)SH /Courier SF 8280 70073 MT ([ ])SH /Times-Roman SF 12280 XM (Any field in square braces is optional.)SH /Courier SF 8280 71650 MT ({x,y,z})SH ES %%Page: 134 135 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 134)SH 12 /Times-Bold AF 31387 XM (Kermit User Guide: UNIX KERMIT \0506.3\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 10120 7886 MT (Alternatives are listed in curly braces.)SH 6120 10278 MT (C-Kermit command line options may specify any combination of actions and settings.) 41 W( If) 331 W( C-Kermit is invoked with)40 W 6120 11474 MT (a command line that specifies no actions,) 84 W( then it will issue a prompt and begin interactive dialog. Action options)85 W 6120 12670 MT (specify either protocol transactions or terminal connection.)SH /Courier SF 6120 14461 MT (-s)SH /Times-Italic SF 7920 XM (fn)SH /Times-Roman SF 10120 XM (Send the specified file or files. If)50 W /Times-Italic SF 24156 XM (fn)SH /Times-Roman SF 25234 XM (contains wildcard \050meta\051 characters, the Unix shell expands) 50 W( it into a)49 W 10120 15566 MT (list. If)250 W /Times-Italic SF 13009 XM (fn)SH /Times-Roman SF 14037 XM (is ')SH /Courier SF (-)SH /Times-Roman SF (' then kermit sends from standard input, which may come from a file:)SH /Courier SF 12520 17221 MT (kermit -s - < foo.bar)SH /Times-Roman SF 10120 18938 MT (or a parallel process:)SH /Courier SF 12520 20593 MT (ls -l | grep christin | kermit -s -)SH /Times-Roman SF 10120 22310 MT (You cannot use this mechanism to send terminal typein.) 55 W( If) 361 W( you want to send a file whose actual name is)56 W 10120 23415 MT (``)SH /Courier SF (-)SH /Times-Roman SF ('' you can precede it with a path name, as in)SH /Courier SF 12520 25070 MT (kermit -s ./-)SH 6120 26787 MT (-r)SH /Times-Roman SF 10120 XM (Receive a file or files. Wait passively for files to arrive.)SH /Courier SF 6120 28364 MT (-k)SH /Times-Roman SF 10120 XM (Receive \050passively\051 a file or files, sending them to standard) 107 W( output. This option can be used in several)106 W 10120 29469 MT (ways:)SH /Courier SF 10120 31198 MT (kermit -k)SH /Times-Roman SF 12120 32303 MT (Displays the incoming files on your screen; to be used only in "local mode" \050see below\051.)SH /Courier SF 10120 33880 MT (kermit -k >)SH /Times-Italic SF 17320 XM (fn1)SH /Times-Roman SF 12120 34985 MT (Sends the incoming file or files to the named file,)241 W /Times-Italic SF 34556 XM (fn1)SH /Times-Roman SF (. If) 732 W( more than) 241 W( one file arrives, all are)242 W 12120 36090 MT (concatenated together into the single file)SH /Times-Italic SF 28617 XM (fn1)SH /Times-Roman SF (.)SH /Courier SF 10120 37667 MT (kermit -k | command)SH /Times-Roman SF 12120 38772 MT (Pipes the incoming data \050single or multiple files\051 to the indicated command, as in)SH /Courier SF 14520 40427 MT (kermit -k | sort > sorted.stuff)SH 6120 42218 MT (-a)SH /Times-Italic SF 7920 XM (fn1)SH /Times-Roman SF 10120 XM (If you have specified a file transfer option, you may give) 73 W( an alternate name for a single file with the)74 W /Courier SF 51720 XM (-a)SH /Times-Roman SF 10120 43323 MT (\050"as"\051 option. For example,)SH /Courier SF 12520 44978 MT (kermit -s foo -a bar)SH /Times-Roman SF 10120 46695 MT (sends the file)60 W /Courier SF 15827 XM (foo)SH /Times-Roman SF 17937 XM (telling the receiver that its name is)60 W /Courier SF 32383 XM (bar)SH /Times-Roman SF (. If) 370 W( more than one file arrives or) 60 W( is sent, only)59 W 10120 47800 MT (the first file is affected by the)SH /Courier SF 22145 XM (-a)SH /Times-Roman SF 23595 XM (option:)SH /Courier SF 12520 49455 MT (kermit -ra baz)SH /Times-Roman SF 10120 51172 MT (stores the first incoming file under the name)SH /Courier SF 28062 XM (baz)SH /Times-Roman SF (.)SH /Courier SF 6120 52749 MT (-x)SH /Times-Roman SF 10120 XM (Begin server operation. May be used in either local or remote mode.)SH 6120 55141 MT (Before proceeding, a few words about remote and local operation are) 27 W( necessary. C-Kermit is "local" if it is running)28 W 6120 56337 MT (on PC or workstation that you are using directly, or if it is running on a multiuser system and transferring files over)33 W 6120 57533 MT (an external communication line -- not your job's controlling terminal or console. C-Kermit is remote if it is running)16 W 6120 58729 MT (on a multiuser system) 209 W( and transferring files over its own controlling terminal's communication line \050normally)208 W /Courier SF 6120 59925 MT (/dev/tty)SH /Times-Roman SF (\051, connected to your PC or workstation.)SH 6120 62317 MT (If you are) 111 W( running C-Kermit on a PC, it is normally used in local mode, with the "back port" designated for file)112 W 6120 63513 MT (transfer and terminal connection.) 61 W( If) 371 W( you are running C-Kermit on a multiuser \050timesharing\051 system, it is in remote)60 W 6120 64709 MT (mode unless you explicitly point it at an external line for) 194 W( file transfer or terminal connection. The following)195 W 6120 65905 MT (command sets C-Kermit's "mode":)SH /Courier SF 6120 67696 MT (-l)SH /Times-Italic SF 7920 XM (dev)SH /Times-Roman SF 10120 XM (Line -- Specify a terminal line to use for file transfer and terminal connection, as in)SH /Courier SF 12520 69351 MT (kermit -l /dev/ttyi5)SH /Times-Roman SF 6120 71743 MT (When an external line is being used, you will also) 38 W( need some additional options for successful communication with)37 W ES %%Page: 135 136 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (6.3. Command Line Operation)SH 10 /Times-Italic AF 51275 XM (Page 135)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (the remote system:)SH /Courier SF 8280 9677 MT (-b)SH /Times-Italic SF 10080 XM (n)SH /Times-Roman SF 12280 XM (Baud -- Specify the baud rate for the line given in the)SH /Courier SF 33887 XM (-l)SH /Times-Roman SF 35337 XM (option, as in)SH /Courier SF 14680 11332 MT (kermit -l /dev/ttyi5 -b 9600)SH /Times-Roman SF 12280 13049 MT (This option) 173 W( should always be included with the)174 W /Courier SF 32837 XM (-l)SH /Times-Roman SF 34461 XM (option, since the speed of an external line is not)174 W 12280 14154 MT (necessarily what you expect.)SH /Courier SF 8280 15731 MT (-p)SH /Times-Italic SF 10080 XM (x)SH /Times-Roman SF 12280 XM (Parity -- e,o,m,s,n \050even, odd, mark, space, or none\051. If parity is other than none, then the 8th-bit) 6 W( prefixing)5 W 12280 16836 MT (mechanism will be used for transferring 8-bit binary data, provided the opposite Kermit) 174 W( agrees. The)175 W 12280 17941 MT (default parity is none.)SH /Courier SF 8280 19518 MT (-t)SH /Times-Roman SF 12280 XM (Specifies half duplex, line turnaround with XON as the handshake character.)SH 8280 21910 MT (The following commands may be used only with) 31 W( a C-Kermit which is local either by default or else because the)30 W /Courier SF 53880 XM (-l)SH /Times-Roman SF 8280 23106 MT (option has been specified.)SH /Courier SF 8280 24897 MT (-g)SH /Times-Italic SF 10080 XM (rfn)SH /Times-Roman SF 12280 XM (Actively request a remote server to send the named file) 99 W( or files;)100 W /Times-Italic SF 39132 XM (rfn)SH /Times-Roman SF 40649 XM (is a file specification in the remote)100 W 12280 26002 MT (host's own syntax. If)111 W /Times-Italic SF 21723 XM (fn)SH /Times-Roman SF 22862 XM (happens to contain any special shell characters, like space, ')111 W /Courier SF (*)SH /Times-Roman SF (', ')111 W /Courier SF ([)SH /Times-Roman SF (', etc, these)111 W 12280 27107 MT (must be quoted, as in)SH /Courier SF 14680 28762 MT (kermit -g x\134*.\134?)SH /Times-Roman SF 12280 30479 MT (or)SH /Courier SF 14680 32134 MT (kermit -g "profile exec")SH 8280 33851 MT (-f)SH /Times-Roman SF 12280 XM (Send a 'finish' command to a remote server.)SH /Courier SF 8280 35428 MT (-c)SH /Times-Roman SF 12280 XM (Establish a) 168 W( terminal connection over the specified or default communication line, before any protocol)169 W 12280 36533 MT (transaction takes place. Get back to the local system by typing the) 343 W( escape character \050normally)342 W 12280 37638 MT (Control-Backslash\051 followed by the letter 'c'.)SH /Courier SF 8280 39215 MT (-n)SH /Times-Roman SF 12280 XM (Like)SH /Courier SF 14395 XM (-c)SH /Times-Roman SF (, but)32 W /Times-Italic SF 17687 XM (after)SH /Times-Roman SF 19858 XM (a protocol) 32 W( transaction takes place;)33 W /Courier SF 33880 XM (-c)SH /Times-Roman SF 35363 XM (and)SH /Courier SF 37090 XM (-n)SH /Times-Roman SF 38573 XM (may both be used in the same command.)33 W 12280 40320 MT (The use of)SH /Courier SF 16751 XM (-n)SH /Times-Roman SF 18201 XM (and)SH /Courier SF 19895 XM (-c)SH /Times-Roman SF 21345 XM (is illustrated below.)SH 8280 42111 MT (If the other Kermit is on a remote system, the)76 W /Courier SF 27454 XM (-l)SH /Times-Roman SF 28980 XM (and)SH /Courier SF 30750 XM (-b)SH /Times-Roman SF 32276 XM (options should also be included with the)76 W /Courier SF 49169 XM (-r)SH /Times-Roman SF (,)SH /Courier SF 50945 XM (-k)SH /Times-Roman SF (, or)76 W /Courier SF 53880 XM (-s)SH /Times-Roman SF 8280 43307 MT (options.)SH 8280 45699 MT (Several other command-line options are provided:)SH /Courier SF 8280 47490 MT (-i)SH /Times-Roman SF 12280 XM (Specifies that files should be sent or received exactly "as is" with no conversions. This option is) 4 W( necessary)5 W 12280 48595 MT (for transmitting binary files. It may also be used in Unix-to-Unix) 31 W( transfers \050it must be given to)30 W /Times-Italic SF 51022 XM (both)SH /Times-Roman SF 53080 XM (Unix)SH 12280 49700 MT (Kermit programs\051, where it will improve performance by) 53 W( circumventing the normal text-file conversions,)54 W 12280 50805 MT (and will allow mixture of text and binary files in a single file group.)SH /Courier SF 8280 52382 MT (-w)SH /Times-Roman SF 12280 XM (Write-Protect -- Avoid filename collisions for incoming files.)SH /Courier SF 8280 53959 MT (-e)SH /Times-Italic SF 10080 XM (n)SH /Times-Roman SF 12280 XM (Extended packet length -- Specify that C-Kermit is) 10 W( allowed to receive packets up to length)9 W /Times-Italic SF 48888 XM (n)SH /Times-Roman SF (, where)9 W /Times-Italic SF 52599 XM (n)SH /Times-Roman SF 53358 XM (may)SH 12280 55064 MT (be between 10 and some large number, like 1000, depending on the system.) 21 W( The) 293 W( default maximum length)22 W 12280 56169 MT (for received packets is 90. Packets longer than 94 will be used only if the other) 123 W( Kermit supports, and)122 W 12280 57274 MT (agrees to use, the "long packet" protocol extension.)SH /Courier SF 8280 58851 MT (-q)SH /Times-Roman SF 12280 XM (Quiet -- Suppress screen update during file transfer, for instance to allow a file transfer to proceed in the)62 W 12280 59956 MT (background.)SH /Courier SF 8280 61533 MT (-d)SH /Times-Roman SF 12280 XM (Debug -- Record debugging information in the file)41 W /Courier SF 33105 XM (debug.log)SH /Times-Roman SF 38796 XM (in the current directory. Use this) 41 W( option)40 W 12280 62638 MT (if you believe the program is misbehaving, and show the resulting log to your local Kermit maintainer.)SH /Courier SF 8280 64215 MT (-h)SH /Times-Roman SF 12280 XM (Help -- Display a brief synopsis of the command line options.)SH 8280 66006 MT (The command line may contain no more than one protocol action option.)SH 8280 68398 MT (Files are sent with their own names, except that lowercase letters are raised to upper, pathnames are stripped) 99 W( off,)100 W 8280 69594 MT (certain special characters like \050`)37 W /Courier SF (~)SH /Times-Roman SF ('\051 and \050`)37 W /Courier SF (#)SH /Times-Roman SF ('\051 are changed to `)37 W /Courier SF (X)SH /Times-Roman SF (', and) 37 W( if the file name begins with a period, an `)36 W /Courier SF (X)SH /Times-Roman SF (' is)36 W 8280 70790 MT (inserted before it. Incoming files are stored under their own names except) 19 W( that uppercase letters are lowered, and, if)20 W /Courier SF 8280 71986 MT (-w)SH /Times-Roman SF 9781 XM (was specified, a "generation number" is appended to the name if it has the same name as an existing file) 51 W( which)50 W ES %%Page: 136 137 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 136)SH 12 /Times-Bold AF 31387 XM (Kermit User Guide: UNIX KERMIT \0506.3\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (would otherwise be overwritten.) 73 W( If) 397 W( the)74 W /Courier SF 22464 XM (-a)SH /Times-Roman SF 23988 XM (option is included, then the same rules apply to its argument. The file)74 W 6120 9082 MT (transfer display shows any transformations performed upon filenames.)SH 6120 11474 MT (During transmission, files are encoded as follows:)SH /Symbol SF 7910 13379 MT (\267)SH /Times-Roman SF 8620 XM (Control characters are converted to prefixed printables.)SH /Symbol SF 7910 15368 MT (\267)SH /Times-Roman SF 8620 XM (Sequences of repeated characters are collapsed via repeat counts, if the other Kermit is also capable of)56 W 8620 16473 MT (repeated-character compression.)SH /Symbol SF 7910 18462 MT (\267)SH /Times-Roman SF 8620 XM (If parity is being used) 197 W( on the communication line, data characters with the 8th \050parity\051 bit on are)198 W 8620 19567 MT (specially prefixed, provided the other Kermit is capable of) 119 W( 8th-bit prefixing; if not, 8-bit binary files)118 W 8620 20672 MT (cannot be successfully transferred.)SH /Symbol SF 7910 22661 MT (\267)SH /Times-Roman SF 8620 XM (Conversion is done between Unix newlines and carriage-return-linefeed sequences) 18 W( unless the)19 W /Courier SF 46395 XM (-i)SH /Times-Roman SF 47864 XM (option)SH 8620 23766 MT (was specified.)SH 12 /Times-Bold AF 6120 26354 MT (Command Line Examples:)SH 10 /Courier AF 8520 28840 MT (kermit -l /dev/ttyi5 -b 1200 -cn -r)SH /Times-Roman SF 6120 30557 MT (This command connects you to the system) 59 W( on the other end of)58 W /Courier SF 31875 XM (ttyi5)SH /Times-Roman SF 35183 XM (at 1200 baud, where you presumably log in)58 W 6120 31753 MT (and run Kermit with a 'send' command. After you escape back, C-Kermit waits for a file \050or files\051 to arrive. When)23 W 6120 32949 MT (the file transfer is completed, you are reconnected to the remote system so that you can logout.)SH /Courier SF 8520 35435 MT (kermit -l /dev/ttyi4 -b 1800 -cntp m -r -a foo)SH /Times-Roman SF 6120 37152 MT (This command is like the preceding one,) 13 W( except the remote system in this case uses half duplex communication with)12 W 6120 38348 MT (mark parity. The first file that arrives is stored under the name)SH /Courier SF 31504 XM (foo)SH /Times-Roman SF (.)SH /Courier SF 8520 40834 MT (kermit -l /dev/ttyi6 -b 9600 -c | tek)SH /Times-Roman SF 6120 42551 MT (This example uses Kermit to connect your terminal to the system at the other end of)SH /Courier SF 39949 XM (ttyi6)SH /Times-Roman SF (. The) 250 W( C-Kermit terminal)SH 6120 43747 MT (connection does not provide any particular) 221 W( terminal emulation, so C-Kermit's standard i/o is piped through a)220 W 6120 44943 MT (\050hypothetical\051 program called tek, which performs \050say\051 Tektronix emulation.)SH /Courier SF 8520 47429 MT (kermit -l /dev/ttyi6 -b 9600 -nf)SH /Times-Roman SF 6120 49146 MT (This command would) 56 W( be used to shut down a remote server and then connect to the remote system, in order to log)57 W 6120 50342 MT (out or to make further use of it. The)SH /Courier SF 20923 XM (-n)SH /Times-Roman SF 22373 XM (option is invoked)SH /Times-Italic SF 29568 XM (after)SH /Courier SF 31707 XM (-f)SH /Times-Roman SF 33157 XM (\050)SH /Courier SF (-c)SH /Times-Roman SF 34940 XM (would have been invoked before\051.)SH /Courier SF 8520 52828 MT (kermit -l /dev/ttyi6 -b 9600 -qg foo.\134* &)SH /Times-Roman SF 6120 54545 MT (This command causes C-Kermit to be invoked in) 11 W( the background, getting a group of files from a remote server \050note)10 W 6120 55741 MT (the quoting of the `)32 W /Courier SF (*)SH /Times-Roman SF (' character\051.) 32 W( No) 315 W( display occurs on the screen, and the keyboard is not sampled for interruption)33 W 6120 56937 MT (commands. This) 250 W( allows other work to be done while file transfers proceed in the background.)SH /Courier SF 8520 59423 MT (kermit -l /dev/ttyi6 -b 9600 -g foo.\134* > foo.log < /dev/null &)SH /Times-Roman SF 6120 61140 MT (This command is like the previous one, except the file transfer display has been redirected to) 108 W( the file)107 W /Courier SF 48470 XM (foo.log)SH /Times-Roman SF (.)SH 6120 62336 MT (Standard input is also redirected, to prevent C-Kermit from sampling it for interruption commands.)SH /Courier SF 8520 64822 MT (kermit -iwx)SH /Times-Roman SF 6120 66539 MT (This command starts up C-Kermit as a server. Files) 234 W( are transmitted with no newline/carriage-return-linefeed)235 W 6120 67735 MT (conversion; the)256 W /Courier SF 13020 XM (-i)SH /Times-Roman SF 14726 XM (option is necessary for binary file transfer and recommended for) 256 W( Unix-to-Unix transfers.)255 W 6120 68931 MT (Incoming files that have the same names as existing files are given new, unique names.)SH /Courier SF 8520 71417 MT (kermit -l /dev/ttyi6 -b 9600)SH ES %%Page: 137 138 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (6.3. Command Line Operation)SH 10 /Times-Italic AF 51275 XM (Page 137)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (This command) 53 W( sets the communication line and speed. Since no action is specified, C-Kermit issues a prompt and)54 W 8280 9082 MT (enters an interactive dialog with you. Any settings given on the command line remain in) 85 W( force during the dialog,)84 W 8280 10278 MT (unless explicitly changed.)SH /Courier SF 10680 12764 MT (kermit)SH /Times-Roman SF 8280 14481 MT (This command starts up Kermit interactively with all default settings.)SH 8280 16873 MT (The next example shows how Unix Kermit might be used to send an entire directory tree from) 54 W( one Unix system to)55 W 8280 18069 MT (another, using the tar program as Kermit's standard input and output.) 113 W( On) 474 W( the orginating system, in this case the)112 W 8280 19265 MT (remote, type \050for instance\051:)SH /Courier SF 10680 21751 MT (tar cf - /usr/fdc | kermit -is -)SH /Times-Roman SF 8280 23468 MT (This causes tar to send the directory)90 W /Courier SF 23546 XM (/usr/fdc)SH /Times-Roman SF 28686 XM (\050and all) 90 W( its files and all its subdirectories and all their files...\051 to)91 W 8280 24664 MT (standard output instead of to a tape; kermit receives this as standard input and sends it as a binary) 129 W( file. On the)128 W 8280 25860 MT (receiving system, in this case the local one, type \050for instance\051:)SH /Courier SF 10680 28346 MT (kermit -il /dev/ttyi5 -b 9600 -k | tar xf -)SH /Times-Roman SF 8280 30063 MT (Kermit receives the tar archive,) 121 W( and sends it via standard output to its own copy of tar, which extracts from it a)122 W 8280 31259 MT (replica of the original directory tree.)SH 8280 33651 MT (A final example shows how a Unix compression utility might be used to speed up Kermit file transfers:)SH /Courier SF 10680 35366 MT (compress file | kermit -is -) SH( \050)2400 W /Times-Italic SF (sender)SH /Courier SF (\051)SH 10680 36397 MT (kermit -ik | uncompress) SH( \050)5400 W /Times-Italic SF (receiver)SH /Courier SF (\051)SH 12 /Times-Bold AF 8280 38985 MT (Exit Status Codes:)SH 10 /Times-Roman AF 8280 40399 MT (Unix Kermit returns an exit status of zero, except when a fatal error) 80 W( is encountered, where the exit status is set to)79 W 8280 41595 MT (one. With) 754 W( background operation \050e.g., `)252 W /Courier SF (&)SH /Times-Roman SF (' at) 252 W( end of invoking command line\051 driven by scripted interactive)253 W 8280 42791 MT (commands \050redirected) 29 W( standard input and/or take files\051, any failed interactive command \050such as failed dial or script)28 W 8280 43987 MT (attempt\051 causes the fatal error exit.)SH 14 /Times-Bold AF 8280 47589 MT (6.4. Interactive Operation)SH 10 /Times-Roman AF 8280 49707 MT (C-Kermit's interactive command prompt is ")123 W /Courier SF (C-Kermit>)SH /Times-Roman SF (". In) 496 W( response) 123 W( to this prompt, you may type any valid)124 W 8280 50903 MT (interactive C-Kermit command. C-Kermit executes the command and then prompts you for) 16 W( another command. The)15 W 8280 52099 MT (process continues until you instruct the program to terminate.)SH 8280 54491 MT (Commands begin with a keyword, normally an English verb, such as "send". You may) 10 W( omit trailing characters from)11 W 8280 55687 MT (any keyword, so long as you specify sufficient characters to distinguish it from any other keyword valid in) 6 W( that field.)5 W 8280 56883 MT (Certain commonly-used keywords \050such as "send", "receive", "connect"\051 also have) 16 W( special non-unique abbreviations)17 W 8280 58079 MT (\050"s" for "send", "r" for "receive", "c" for "connect"\051.)SH 8280 60471 MT (Certain characters have special functions during typein of interactive commands:)SH /Courier SF 10280 62262 MT (?)SH /Times-Roman SF 12280 XM (Question mark, typed at any point in a command, will produce a message explaining what) 72 W( is possible or)71 W 12280 63367 MT (expected at that point. Depending on the context, the message may be a brief phrase, a menu) 3 W( of keywords,)4 W 12280 64472 MT (or a list of files.)SH /Courier SF 10280 66049 MT (ESC)SH /Times-Roman SF 12280 XM (\050The Escape or Altmode key\051 -- Request) 45 W( completion of the current keyword or filename, or insertion of a)44 W 12280 67154 MT (default value. The result will be a beep if the requested operation fails.)SH /Courier SF 10280 68731 MT (DEL)SH /Times-Roman SF 12280 XM (\050The Delete or Rubout key\051) 92 W( -- Delete the previous character from the command. You may also use BS)93 W 12280 69836 MT (\050Backspace, Control-H\051 for this function.)SH /Courier SF 10280 71413 MT (^W)SH /Times-Roman SF 12280 XM (\050Control-W\051 -- Erase the rightmost word from the command line.)SH ES %%Page: 138 139 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 138)SH 12 /Times-Bold AF 31387 XM (Kermit User Guide: UNIX KERMIT \0506.4\051)SH 46800 50 6120 5709 UL 10 /Courier AF 8120 7886 MT (^U)SH /Times-Roman SF 10120 XM (\050Control-U\051 -- Erase the entire command.)SH /Courier SF 8120 9463 MT (^R)SH /Times-Roman SF 10120 XM (\050Control-R\051 -- Redisplay the current command.)SH /Courier SF 8120 11040 MT (SP)SH /Times-Roman SF 10120 XM (\050Space\051 -- Delimits fields \050keywords, filenames, numbers\051 within a command.) 56 W( HT) 361 W( \050Horizontal Tab\051 may)55 W 10120 12145 MT (also be used for this purpose.)SH /Courier SF 8120 13722 MT (CR)SH /Times-Roman SF 10120 XM (\050Carriage Return\051 -- Enters the command for execution. LF \050Linefeed\051 or FF \050formfeed\051 may also be used)15 W 10120 14827 MT (for this purpose.)SH /Courier SF 8120 16404 MT (\134)SH /Times-Roman SF 10120 XM (\050Backslash\051 --) 78 W( Enter any of the above characters into the command, literally. To enter a backslash, type)77 W 10120 17509 MT (two backslashes in a row \050)140 W /Courier SF (\134\134)SH /Times-Roman SF (\051. A) 530 W( backslash at the end of a command line causes the next line to) 140 W( be)141 W 10120 18614 MT (treated as a continuation line; this is useful for readability in command files,) 153 W( especially in the 'script')152 W 10120 19719 MT (command.)SH /Courier SF 8120 21296 MT (^Z)SH /Times-Roman SF 10120 XM (\050Control-Z\051 -- On systems \050like Berkeley Unix, Ultrix\051 with job control, suspend Kermit, i.e. put it into the)8 W 10120 22401 MT (background in such a way that it can be brought back into the foreground \050e.g. with an ')222 W /Courier SF (fg)SH /Times-Roman SF (' shell)222 W 10120 23506 MT (command\051 with all its settings intact.)SH 6120 25297 MT (You may type the) 39 W( editing characters \050)40 W /Courier SF (DEL)SH /Times-Roman SF (,)SH /Courier SF 23749 XM (^W)SH /Times-Roman SF (, etc\051 repeatedly, to delete all the way back to the prompt. No action)40 W 6120 26493 MT (will be performed until the command is entered by typing carriage return, linefeed, or formfeed. If you) 72 W( make any)71 W 6120 27689 MT (mistakes, you will receive an informative error) 4 W( message and a new prompt -- make liberal use of `)5 W /Courier SF (?)SH /Times-Roman SF (' and ESC to feel)5 W 6120 28885 MT (your way through the commands. One important command is "help" -- you should use it) 126 W( the first time you run)125 W 6120 30081 MT (C-Kermit.)SH 6120 32473 MT (A command line beginning with a percent sign ``)145 W /Courier SF (%)SH /Times-Roman SF ('' is ignored. Such lines may) 145 W( be used to include illustrative)146 W 6120 33669 MT (commentary in Kermit command dialogs.)SH 6120 36061 MT (Interactive C-Kermit accepts) 122 W( commands from files as well as from the keyboard. When you start C-Kermit, the)121 W 6120 37257 MT (program looks for the file)48 W /Courier SF 16886 XM (.kermrc)SH /Times-Roman SF 21384 XM (in your home or current directory \050first it) 48 W( looks in the home directory, then in)49 W 6120 38453 MT (the current) 123 W( one\051 and executes any commands it finds there. These commands must be in interactive format, not)122 W 6120 39649 MT (Unix command-line format. A "take" command is) 12 W( also provided for use at any time during an interactive session, to)13 W 6120 40845 MT (allow interactive-format commands to be executed from a file; command files may be nested) 148 W( to any reasonable)147 W 6120 42041 MT (depth.)SH 6120 44433 MT (Here is a brief list of C-Kermit interactive commands:)SH 16087 46043 MT (%)SH 17420 XM (Comment)SH 16587 47148 MT (!)SH 17420 XM (Execute a Unix shell command, or start a shell.)SH 15476 48253 MT (bye)SH 17420 XM (Terminate and log out a remote Kermit server.)SH 14865 49358 MT (close)SH 17420 XM (Close a log file.)SH 13810 50463 MT (connect)SH 17420 XM (Establish a terminal connection to a remote system.)SH 15254 51568 MT (cwd)SH 17420 XM (Change Working Directory.)SH 15420 52673 MT (dial)SH 17420 XM (Dial a telephone number.)SH 13310 53778 MT (directory)SH 17420 XM (Display a directory listing.)SH 15032 54883 MT (echo)SH 17420 XM (Display arguments literally.)SH 15420 55988 MT (exit)SH 17420 XM (Exit from the program, closing any open files.)SH 14642 57093 MT (finish)SH 17420 XM (Instruct a remote Kermit server to exit, but not log out.)SH 15698 58198 MT (get)SH 17420 XM (Get files from a remote Kermit server.)SH 15198 59303 MT (help)SH 17420 XM (Display a help message for a given command.)SH 15642 60408 MT (log)SH 17420 XM (Open a log file -- debugging, packet, session, transaction.)SH 15364 61513 MT (quit)SH 17420 XM (Same as 'exit'.)SH 14033 62618 MT (receive)SH 17420 XM (Passively wait for files to arrive.)SH 14143 63723 MT (remote)SH 17420 XM (Issue file management commands to a remote Kermit server.)SH 14698 64828 MT (script)SH 17420 XM (Execute a login script with a remote system.)SH 15087 65933 MT (send)SH 17420 XM (Send files.)SH 14477 67038 MT (server)SH 17420 XM (Begin server operation.)SH 15809 68143 MT (set)SH 17420 XM (Set various parameters.)SH 14809 69248 MT (show)SH 17420 XM (Display values of 'set' parameters.)SH 14699 70353 MT (space)SH 17420 XM (Display current disk space usage.)SH 13475 71458 MT (statistics)SH 17420 XM (Display statistics about most recent transaction.)SH ES %%Page: 139 140 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (6.4. Interactive Operation)SH 10 /Times-Italic AF 51275 XM (Page 139)SH 46800 50 8280 5709 UL /Times-Roman SF 17414 7886 MT (take)SH 19580 XM (Execute commands from a file.)SH 8280 10278 MT (The 'set' parameters are:)SH 14193 11888 MT (block-check)SH 19580 XM (Level of packet error detection.)SH 16914 12993 MT (delay)SH 19580 XM (How long to wait before sending first packet.)SH 16358 14098 MT (duplex)SH 19580 XM (Specify which side echoes during 'connect'.)SH 12418 15203 MT (escape-character)SH 19580 XM (Prefix for "escape commands" during 'connect'.)SH 17747 16308 MT (file)SH 19580 XM (Set various file parameters.)SH 14081 17413 MT (flow-control)SH 19580 XM (Communication line full-duplex flow control.)SH 14859 18518 MT (handshake)SH 19580 XM (Communication line half-duplex turnaround character.)SH 14636 19623 MT (incomplete)SH 19580 XM (Disposition for incompletely received files.)SH 17580 20728 MT (line)SH 19580 XM (Communication line device name.)SH 13470 21833 MT (modem-dialer)SH 19580 XM (Type of modem-dialer on communication line.)SH 16747 22938 MT (parity)SH 19580 XM (Communication line character parity.)SH 16191 24043 MT (prompt)SH 19580 XM (The C-Kermit program's interactive command prompt.)SH 16193 25148 MT (receive)SH 19580 XM (Parameters for inbound packets.)SH 17192 26253 MT (retry)SH 19580 XM (Packet retransmission limit.)SH 17247 27358 MT (send)SH 19580 XM (Parameters for outbound packets.)SH 16803 28463 MT (speed)SH 19580 XM (Communication line speed.)SH 15747 29568 MT (terminal)SH 19580 XM (Terminal parameters.)SH 8280 31960 MT (The 'remote' commands are:)SH 17414 33570 MT (cwd)SH 19580 XM (Change remote working directory.)SH 16692 34675 MT (delete)SH 19580 XM (Delete remote files.)SH 15470 35780 MT (directory)SH 19580 XM (Display a listing of remote file names.)SH 17358 36885 MT (help)SH 19580 XM (Request help from a remote server.)SH 17413 37990 MT (host)SH 19580 XM (A command to the remote host in its own command language.)SH 16859 39095 MT (space)SH 19580 XM (Display current disk space usage on remote system.)SH 17358 40200 MT (type)SH 19580 XM (Display a remote file on your screen.)SH 17358 41305 MT (who)SH 19580 XM (Display who's logged in, or get information about a user.)SH 8280 43697 MT (Most of these commands are described adequately in the Kermit User Guide or the Kermit book. Special) 22 W( aspects of)23 W 8280 44893 MT (certain Unix Kermit commands are described below.)SH 13 /Times-Bold AF 25829 48252 MT (The 'send' command)SH 10 /Times-Roman AF 8280 50625 MT (Syntax:)SH /Courier SF 11836 XM (send)SH /Times-Italic SF 14836 XM (fn)SH /Courier SF 16814 XM (-)SH /Times-Italic SF 18014 XM (or)SH /Courier SF 19503 XM (- send)600 W /Times-Italic SF 24303 XM (fn1 rfn1)350 W /Times-Roman SF 8280 53017 MT (Send the file or files denoted by)95 W /Times-Italic SF 21971 XM (fn)SH /Times-Roman SF 23094 XM (to the other Kermit, which should be running as) 95 W( a server, or which should be)94 W 8280 54213 MT (given the 'receive' command. Each file is sent under its) 50 W( own name \050as described above, or as specified by the 'set)51 W 8280 55409 MT (file names' command\051. If the second form of the 'send' command is used, i.e. with)23 W /Times-Italic SF 42526 XM (fn1)SH /Times-Roman SF 44076 XM (denoting a single Unix file,)22 W /Times-Italic SF 8280 56605 MT (rfn1)SH /Times-Roman SF 10204 XM (may be specified as a name to send it under. The 'send' command) 7 W( may be abbreviated to 's', even though 's' is)8 W 8280 57801 MT (not a unique abbreviation for a top-level C-Kermit command.)SH 8280 60193 MT (The wildcard \050meta\051) 32 W( characters `)31 W /Courier SF (*)SH /Times-Roman SF (' and `)31 W /Courier SF (?)SH /Times-Roman SF (' are accepted in)31 W /Times-Italic SF 32282 XM (fn)SH /Times-Roman SF (. If) 312 W( `)31 W /Courier SF (?)SH /Times-Roman SF (' is to be included, it must be prefixed by `)31 W /Courier SF (\134)SH /Times-Roman SF (' to)31 W 8280 61389 MT (override its normal function of providing help.) 115 W( `)481 W /Courier SF (*)SH /Times-Roman SF (' matches any string, `)116 W /Courier SF (?)SH /Times-Roman SF (' matches any single character. Other)116 W 8280 62585 MT (notations for file groups, like `)132 W /Courier SF ([a-z]og)SH /Times-Roman SF (', are not available in interactive commands \050though) 132 W( of course they are)131 W 8280 63781 MT (available on the) 52 W( command line\051. When)53 W /Times-Italic SF 24646 XM (fn)SH /Times-Roman SF 25727 XM (contains `)53 W /Courier SF (*)SH /Times-Roman SF (' or `)53 W /Courier SF (?)SH /Times-Roman SF (' characters, there is a limit to the number of files that)53 W 8280 64977 MT (can be matched, which varies from system) 78 W( to system. If you get the message "Too many files match" then you'll)77 W 8280 66173 MT (have to make a more judicious selection. If)SH /Times-Italic SF 25999 XM (fn)SH /Times-Roman SF 27027 XM (was of the form)SH /Courier SF 10680 67828 MT (usr/longname/anotherlongname/*)SH /Times-Roman SF 8280 69545 MT (then C-Kermit's string space will fill up rapidly -- try doing a cwd \050see) 34 W( below\051 to the path in question and reissuing)35 W 8280 70741 MT (the command.)SH ES %%Page: 140 141 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 140)SH 12 /Times-Bold AF 31387 XM (Kermit User Guide: UNIX KERMIT \0506.4\051)SH 46800 50 6120 5709 UL 10 /Times-Italic AF 6120 7886 MT (Note)SH /Times-Roman SF 8389 XM (-- C-Kermit sends only from the current or) 130 W( specified directory. It does not traverse directory trees. If the)129 W 6120 9082 MT (source directory contains subdirectories, they will be skipped. By the same) 222 W( token, C-Kermit does not create)223 W 6120 10278 MT (directories when receiving) 49 W( files. If you have a need to do this, you can pipe tar through C-Kermit, as shown in the)48 W 6120 11474 MT (example on page 137, or under System III/V Unix you can use cpio.)SH /Times-Italic SF 6120 13866 MT (Another Note)138 W /Times-Roman SF 12007 XM (-- The 'send' command does not skip over "invisible" files that match) 138 W( the file specification; Unix)139 W 6120 15062 MT (systems usually treat files whose names start with a dot \050like)180 W /Courier SF 32570 XM (.login)SH /Times-Roman SF (,)SH /Courier SF 36849 XM (.cshrc)SH /Times-Roman SF (, and)179 W /Courier SF 43001 XM (.kermrc)SH /Times-Roman SF (\051 as invisible.)179 W 6120 16258 MT (Similarly for "temporary" files whose names start with ")SH /Courier SF (#)SH /Times-Roman SF (".)SH 13 /Times-Bold AF 22986 19617 MT (The 'receive' command)SH 10 /Times-Roman AF 6120 21990 MT (Syntax:)SH /Courier SF 9676 XM (receive -)600 W /Times-Italic SF 16276 XM (or)SH /Courier SF 17765 XM (- receive)600 W /Times-Italic SF 24365 XM (fn1)SH /Times-Roman SF 6120 24382 MT (Passively wait for files to arrive from the other Kermit,) 83 W( which must be given the 'send' command -- the 'receive')84 W 6120 25578 MT (command does not work in conjunction) 22 W( with a server \050use 'get' for that\051. If)21 W /Times-Italic SF 36934 XM (fn1)SH /Times-Roman SF 38483 XM (is specified, store the first incoming)21 W 6120 26774 MT (file under that name. The 'receive' command may be abbreviated to 'r'.)SH 13 /Times-Bold AF 23887 30133 MT (The 'get' command:)SH 10 /Times-Roman AF 6120 32506 MT (Syntax:)SH /Courier SF 10376 XM (get)SH /Times-Italic SF 12776 XM (rfn)SH 10920 34221 MT (or)SH /Courier SF (: get)SH /Times-Italic SF 15720 35252 MT (rfn)SH 15720 36283 MT (fn1)SH /Times-Roman SF 6120 38000 MT (Request a remote Kermit server to send the named file or files. Since a remote file specification \050or) 125 W( list\051 might)126 W 6120 39196 MT (contain spaces, which normally delimit fields of a C-Kermit command, an alternate form of the command is)224 W 6120 40392 MT (provided to allow the inbound file to be given a new name:) 98 W( type 'get' alone on a line, and you will be prompted)99 W 6120 41588 MT (separately for the remote and local file specifications, for example)SH /Courier SF 8520 43243 MT (C-Kermit>get)SH 1800 50 13920 43443 UL 9120 44274 MT (Remote file specification: profile exec)SH 7200 50 25320 44474 UL 9120 45305 MT (Local name to store it under: profile.exec)SH 7200 50 27120 45505 UL /Times-Roman SF 6120 47022 MT (As with 'receive', if more than one file arrives as a result of the 'get' command, only the first will be stored under)57 W 6120 48218 MT (the alternate name given by)50 W /Times-Italic SF 17673 XM (fn1)SH /Times-Roman SF (; the remaining files will be stored under their own names if possible. If a `)50 W /Courier SF (?)SH /Times-Roman SF (' is) 50 W( to)51 W 6120 49414 MT (be included) 38 W( in the remote file specification, you must prefix it with `)37 W /Courier SF (\134)SH /Times-Roman SF (' to suppress its normal function of providing)37 W 6120 50610 MT (help.)SH 6120 53002 MT (If you have started a multiline 'get') 89 W( command, you may escape from its lower-level prompts by typing a carriage)90 W 6120 54198 MT (return in response to the prompt, e.g.)SH /Courier SF 8520 55853 MT (C-Kermit>get)SH 1800 50 13920 56053 UL 9120 56884 MT (Remote file specification: foo)SH 1800 50 25320 57084 UL 9120 57915 MT (Local name to store it under:)SH /Times-Italic SF 27120 XM (\050Type a carriage return here\051)SH /Courier SF 8520 58946 MT (\050cancelled\051)SH 8520 59977 MT (C-Kermit>)SH ES %%Page: 141 142 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (6.4. Interactive Operation)SH 10 /Times-Italic AF 51275 XM (Page 141)SH 46800 50 8280 5709 UL 13 /Times-Bold AF 25145 8071 MT (The 'server' command:)SH 10 /Times-Roman AF 8280 10444 MT (The 'server') 37 W( command places C-Kermit in "server mode" on the currently selected communication line. All further)36 W 8280 11640 MT (commands must arrive as valid Kermit packets from the) 130 W( Kermit on the other end of the line. The Unix Kermit)131 W 8280 12836 MT (server can respond to the following commands:)SH 8280 14627 MT (Command)SH 24480 XM (Server Response)SH 4167 50 8280 14827 UL 6693 50 24480 14827 UL 8780 15732 MT (get)SH 24980 XM (Sends files)SH 8780 16837 MT (send)SH 24980 XM (Receives files)SH 8780 17942 MT (bye)SH 24980 XM (Attempts to log itself out)SH 8780 19047 MT (finish)SH 24980 XM (Exits to level from which it was invoked)SH 8780 20152 MT (remote directory)SH 24980 XM (Sends directory lising)SH 8780 21257 MT (remote delete)SH 24980 XM (Removes files)SH 8780 22362 MT (remote cwd)SH 24980 XM (Changes working directory)SH 8780 23467 MT (remote type)SH 24980 XM (Sends files to your screen)SH 8780 24572 MT (remote space)SH 24980 XM (Reports about its disk usage)SH 8780 25677 MT (remote who)SH 24980 XM (Shows who's logged in)SH 8780 26782 MT (remote host)SH 24980 XM (Executes a Unix shell command)SH 8780 27887 MT (remote help)SH 24980 XM (Lists these capabilities)SH 8280 29678 MT (The Unix Kermit server cannot always) 201 W( respond properly to a BYE command. It will attempt to do so using)200 W 8280 30874 MT (")SH /Courier SF (kill\050\051)SH /Times-Roman SF (", but this) 218 W( will not work on all systems or under all conditions because of the complicated process)219 W 8280 32070 MT (structures that can be set up under Unix.)SH 8280 34462 MT (If the Kermit server is directed at an external line) 45 W( \050i.e. it is in "local mode"\051 then the console may be used for other)44 W 8280 35658 MT (work if you have 'set file display off'; normally the program expects the console) 29 W( to be used to observe file transfers)30 W 8280 36854 MT (and enter status queries or interruption commands. The way) 188 W( to get C-Kermit into background operation from)187 W 8280 38050 MT (interactive command level varies from) 2 W( system to system \050e.g. on Berkeley Unix you would halt the program with)3 W /Courier SF 53880 XM (^Z)SH /Times-Roman SF 8280 39246 MT (and then use the C-Shell 'bg' command to continue it in the background\051. The) 53 W( more common method is to invoke)52 W 8280 40442 MT (the program with the desired command line arguments, including ")SH /Courier SF (-q)SH /Times-Roman SF (", and with a terminating ")SH /Courier SF (&)SH /Times-Roman SF (".)SH 8280 42834 MT (When the Unix Kermit server is given a 'remote host' command, it executes) 61 W( it using the shell invoked upon login,)62 W 8280 44030 MT (e.g. the Bourne shell or the Berkeley C-Shell.)SH 13 /Times-Bold AF 19421 47389 MT (The 'remote', 'bye', and 'finish' commands:)SH 10 /Times-Roman AF 8280 49762 MT (C-Kermit may itself request services from a remote Kermit server.) 104 W( In) 457 W( addition to 'send' and 'get', the following)103 W 8280 50958 MT (commands may also be sent from C-Kermit to a Kermit server:)SH 10280 52749 MT (remote cwd [)SH /Times-Italic SF (directory)SH /Times-Roman SF (])SH 12280 53854 MT (If the optional remote directory specification is included, you will be) 110 W( prompted on a separate line for a)109 W 12280 54959 MT (password, which will not echo as you type it. If the remote) 76 W( system does not require a password for this)77 W 12280 56064 MT (operation, just type a carriage return.)SH 10280 57855 MT (remote delete rfn)SH 22280 XM (delete remote file or files.)SH 10280 58960 MT (remote directory [)SH /Times-Italic SF (rfn)SH /Times-Roman SF (])SH 22280 XM (directory listing of remote files.)SH 10280 60065 MT (remote host)SH /Times-Italic SF 15224 XM (command)SH /Times-Roman SF 22280 XM (command in remote host's own command language.)SH 10280 61170 MT (remote space)SH 22280 XM (disk usage report from remote host.)SH 10280 62275 MT (remote type [)SH /Times-Italic SF (rfn)SH /Times-Roman SF (])SH 22280 XM (display remote file or files on the screen.)SH 10280 63380 MT (remote who [)SH /Times-Italic SF (user)SH /Times-Roman SF (])SH 22280 XM (display information about who's logged in.)SH 10280 64485 MT (remote help)SH 22280 XM (display remote server's capabilities.)SH 10280 66276 MT (bye)SH /Times-Italic SF 11974 XM (and)SH /Times-Roman SF 13724 XM (finish:)SH 12280 67381 MT (When connected to a remote Kermit server, these commands cause the remote server to terminate; 'finish')17 W 12280 68486 MT (returns it to Kermit or system command level \050depending on the implementation or how the) 40 W( program was)39 W 12280 69591 MT (invoked\051; 'bye' also requests it to log itself out.)SH ES %%Page: 142 143 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 142)SH 12 /Times-Bold AF 31387 XM (Kermit User Guide: UNIX KERMIT \0506.4\051)SH 46800 50 6120 5709 UL 13 SS 20492 8071 MT (The 'log' and 'close' commands:)SH 10 /Times-Roman AF 6120 10444 MT (Syntax:)SH /Courier SF 9426 XM (log {debugging, packets, session, transactions})SH /Times-Roman SF 38226 XM ([)SH /Times-Italic SF 38809 XM (fn1)SH /Times-Roman SF 40337 XM (])SH 6120 12836 MT (C-Kermit's progress) 47 W( may be logged in various ways. The 'log' command opens a log, the 'close' command closes)48 W 6120 14032 MT (it. In) 258 W( addition, all open logs are closed by the) 4 W( 'exit' and 'quit' commands. A name may be specified for a log file; if)3 W 6120 15228 MT (the name is omitted, the file is created with a default name as shown below.)SH 6120 17019 MT (log debugging)SH 8120 18124 MT (This produces a voluminous log of) 268 W( the internal workings of C-Kermit, of use to Kermit developers or)267 W 8120 19229 MT (maintainers in tracking down suspected bugs in the C-Kermit program. Use of this) 45 W( feature dramatically slows)46 W 8120 20334 MT (down the Kermit protocol. Default name:)SH /Courier SF 25173 XM (debug.log)SH /Times-Roman SF (.)SH 6120 21911 MT (log packets)SH 8120 23016 MT (This produces a record of all the packets that go in and out) 78 W( of the communication port. This log is of use to)79 W 8120 24121 MT (Kermit maintainers who are) 49 W( tracking down protocol problems in either C-Kermit or any Kermit that C-Kermit)48 W 8120 25226 MT (is connected to. Default name:)SH /Courier SF 21062 XM (packet.log)SH /Times-Roman SF (.)SH 6120 26803 MT (log session)SH 8120 27908 MT (This log will contain a copy of everything you see) 84 W( on your screen during the 'connect' command, except for)83 W 8120 29013 MT (local messages or interaction with local escape commands. Default name:)SH /Courier SF 38364 XM (session.log)SH /Times-Roman SF (.)SH 6120 30590 MT (log transactions)SH 8120 31695 MT (The transaction log is a record of all the files that were sent or received while transaction logging was) 17 W( in effect.)16 W 8120 32800 MT (It includes time stamps and statistics, filename) 218 W( transformations, and records of any errors that may have)219 W 8120 33905 MT (occurred. The) 300 W( transaction log allows you to have long unattended) 25 W( file transfer sessions without fear of missing)24 W 8120 35010 MT (some vital screen message. Default name:)SH /Courier SF 25644 XM (transact.log)SH /Times-Roman SF (.)SH 6120 36801 MT (The 'close' command explicitly closes a log, e.g. 'close debug'.)SH /Times-Italic SF 6120 39193 MT (Note:)SH /Times-Roman SF 9073 XM (Debug and Transaction logs are a compile-time option; C-Kermit may be compiled without these logs, in)116 W 6120 40389 MT (which case it will run faster, it will take up less space on the disk, and the commands relating to) 75 W( them will not be)74 W 6120 41585 MT (present.)SH 13 /Times-Bold AF 19392 44944 MT (Local File Management Commands:)SH 10 /Times-Roman AF 6120 47317 MT (Unix Kermit allows some degree of local file management from interactive command level:)SH 6120 49108 MT (directory [)SH /Times-Italic SF (fn)SH /Times-Roman SF (])SH 8120 50213 MT (Displays a listing of the names,) 13 W( modes, sizes, and dates of files matching)12 W /Times-Italic SF 37667 XM (fn)SH /Times-Roman SF 38707 XM (\050which defaults to `)12 W /Courier SF (*)SH /Times-Roman SF ('\051. Equivalent)274 W 8120 51318 MT (to `)SH /Courier SF (ls -l)SH /Times-Roman SF ('.)SH 6120 52895 MT (cwd [directory-name])SH 8120 54000 MT (Changes Kermit's working directory to the one given, or to the default directory if the directory name is)188 W 8120 55105 MT (omitted. This) 250 W( command affects only the Kermit process and any processes it may subsequently create.)SH 6120 56682 MT (space)SH 8120 57787 MT (Display information about disk space and/or quota in the current directory and device.)SH /Courier SF 6120 59364 MT (!)SH /Times-Roman SF 7320 XM ([)SH /Times-Italic SF (command)SH /Times-Roman SF (])SH 8120 60469 MT (The command is executed by the Unix shell. If no command is specified, then an interactive shell is) 76 W( started;)77 W 8120 61574 MT (exiting from the shell, e.g. by typing Control-D or 'exit', will) 34 W( return you to C-Kermit command level. Use the)33 W 8120 62679 MT (`)SH /Courier SF (!)SH /Times-Roman SF (' command to provide file management or other functions not explicitly provided by C-Kermit) 84 W( commands.)85 W 8120 63784 MT (The `)SH /Courier SF (!)SH /Times-Roman SF (' command has certain peculiarities:)SH /Symbol SF 9910 65689 MT (\267)SH /Times-Roman SF 10620 XM (C-Kermit attempts to use your preferred, customary \050login\051 shell.)SH /Symbol SF 9910 66794 MT (\267)SH /Times-Roman SF 10620 XM (At least one space must separate the '!' from the shell command.)SH /Symbol SF 9910 67899 MT (\267)SH /Times-Roman SF 10620 XM (A 'cd' \050change directory\051 command) 264 W( executed in this manner will have no effect -- use the)263 W 10620 69004 MT (C-Kermit 'cwd' command instead.)SH ES %%Page: 143 144 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (6.4. Interactive Operation)SH 10 /Times-Italic AF 51275 XM (Page 143)SH 46800 50 8280 5709 UL 13 /Times-Bold AF 22470 8071 MT (The 'set' and 'show' Commands:)SH 10 /Times-Roman AF 8280 10444 MT (Since Kermit is designed to allow diverse systems to communicate, it) 24 W( is often necessary to issue special instructions)25 W 8280 11640 MT (to allow the program to adapt to peculiarities of) 53 W( the another system or the communication path. These instructions)52 W 8280 12836 MT (are accomplished by the 'set' command. The) 62 W( 'show' command may be used to display current settings. Here is a)63 W 8280 14032 MT (brief synopsis of settings available in the current release of C-Kermit:)SH 8280 15823 MT (block-check {1, 2, 3})SH 10280 16928 MT (Determines the level of per-packet error detection. "1" is a single-character 6-bit) 55 W( checksum, folded to include)56 W 10280 18033 MT (the values of all bits from each character. "2" is a 2-character, 12-bit checksum. "3" is a 3-character, 16-bit)84 W 10280 19138 MT (cyclic redundancy check \050CRC\051. The higher the block check, the) 49 W( better the error detection and correction and)50 W 10280 20243 MT (the higher) 388 W( the resulting overhead. Type 1 is most commonly used; it is supported by all Kermit)387 W 10280 21348 MT (implementations, and it has proven adequate in most) 38 W( circumstances. Types 2 or 3 would be used to advantage)39 W 10280 22453 MT (when transferring 8-bit binary files over noisy lines.)SH 8280 24030 MT (delay)SH /Times-Italic SF 10696 XM (n)SH /Times-Roman SF 10280 25135 MT (How many seconds to wait before sending the first) 80 W( packet after a 'send' command. Used in remote mode to)81 W 10280 26240 MT (give you time to escape back to your local Kermit and issue a 'receive' command. Normally 5 seconds.)SH 8280 27817 MT (duplex {full, half})SH 10280 28922 MT (For use during 'connect'. Specifies which side is doing the echoing; 'full' means) 60 W( the other side, 'half' means)61 W 10280 30027 MT (C-Kermit must echo typein itself.)SH 8280 31604 MT (escape-character)SH /Times-Italic SF 15192 XM (cc)SH /Times-Roman SF 10280 32709 MT (For use during 'connect' to get C-Kermit's attention. The escape character acts as a prefix to) 170 W( an 'escape)171 W 10280 33814 MT (command', for instance to close the connection and return to) 79 W( C-Kermit or Unix command level. The normal)78 W 10280 34919 MT (escape character is Control-Backslash \05028\051.) 20 W( The) 291 W( escape character is also used in System III/V implementations)21 W 10280 36024 MT (to prefix interrupt commands during file transfers.)SH 8280 37601 MT (file {display, names, type, warning})SH 10280 38706 MT (Establish various file-related parameters:)SH 10280 40497 MT (display {on, off})SH 12280 41602 MT (Normally 'on'; when in local mode, display progress of file transfers on the screen \050stdout\051, and) 59 W( listen to)58 W 12280 42707 MT (the keyboard \050stdin\051 for interruptions.) 163 W( If) 578 W( off \050-q on command line\051 none of this is done, and the file)164 W 12280 43812 MT (transfer may proceed in the background oblivious to any other work concurrently) 156 W( done at the console)155 W 12280 44917 MT (terminal.)SH 10280 46494 MT (names {converted, literal})SH 12280 47599 MT (Normally converted, which means that) 117 W( outbound filenames have path specifications stripped, lowercase)116 W 12280 48704 MT (letters raised to upper, tildes and extra periods changed to X's, and an X inserted in front) 18 W( of any name that)19 W 12280 49809 MT (starts with period. Incoming files have uppercase letters lowered. Literal means that) 200 W( none of these)199 W 12280 50914 MT (conversions are done; therefore, any directory path appearing in) 115 W( a received file specification must exist)116 W 12280 52019 MT (and be write-accessible. When literal naming) 64 W( is being used, the sender should not use path names in the)63 W 12280 53124 MT (file specification unless the same path exists on the target system and is writable.)SH 10280 54701 MT (type {binary, text} [{7, 8}])SH 12280 55806 MT (The file type is normally text, which means that conversion is done between Unix) 42 W( newline characters and)41 W 12280 56911 MT (the carriage-return/linefeed sequences required by the canonical) 111 W( Kermit file transmission format, and in)112 W 12280 58016 MT (common use on non-Unix systems. Binary means) 104 W( to transmit file contents without conversion. Binary)103 W 12280 59121 MT (\050`)SH /Courier SF (-i)SH /Times-Roman SF (' in) 338 W( command line notation\051 is necessary for binary files, and desirable in all Unix-to-Unix)339 W 12280 60226 MT (transactions to cut down on overhead.)SH 12280 61803 MT (The optional) 50 W( trailing parameter tells the bytesize for file transfer. It is 8 by default. If you specify 7, the)49 W 12280 62908 MT (high order bit will be stripped from each byte of sent and) 8 W( received files. This is useful for transferring text)9 W 12280 64013 MT (files that may have) 112 W( extraneous high order bits set in their disk representation \050e.g. Wordstar or similar)111 W 12280 65118 MT (word processor files\051.)SH 10280 66695 MT (warning {on, off})SH 12280 67800 MT (Normally off, which means that incoming files will silently overwrite existing files of the same) 137 W( name.)136 W 12280 68905 MT (When on \050`)27 W /Courier SF (-w)SH /Times-Roman SF (' on command line\051 Kermit will check) 27 W( if an arriving file would overwrite an existing file; if)28 W 12280 70010 MT (so, it will construct a new name for the arriving) 20 W( file, of the form)19 W /Courier SF 38384 XM (foo~)SH /Times-Italic SF (n)SH /Times-Roman SF (, where foo is the name they share)19 W 12280 71115 MT (and)SH /Times-Italic SF 14008 XM (n)SH /Times-Roman SF 14792 XM (is a "generation number"; if)34 W /Times-Italic SF 26304 XM (foo)SH /Times-Roman SF 27866 XM (exists, then the new file will be called)34 W /Courier SF 43497 XM (foo~1)SH /Times-Roman SF (. If)318 W /Courier SF 48266 XM (foo)SH /Times-Roman SF 50351 XM (and)SH /Courier SF 52080 XM (foo~1)SH ES %%Page: 144 145 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 144)SH 12 /Times-Bold AF 31387 XM (Kermit User Guide: UNIX KERMIT \0506.4\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 10120 7886 MT (exist, the new file will be)31 W /Courier SF 20666 XM (foo~2)SH /Times-Roman SF (, and so) 31 W( on. If the new name would be longer than the maximum length)30 W 10120 8991 MT (for a filename, then characters would be deleted from the end) 20 W( first, for instance,)21 W /Courier SF 42534 XM (thelongestname)SH /Times-Roman SF 51205 XM (on a)21 W 10120 10096 MT (system with a limit of 14 characters would become)SH /Courier SF 30756 XM (thelongestn~1)SH /Times-Roman SF (.)SH /Times-Italic SF 12120 11887 MT (CAUTION:)SH /Times-Roman SF 17312 XM (If Control-F or Control-B is used to cancel an incoming file, and a file of the same)40 W 12120 12992 MT (name previously existed,)12 W /Times-Italic SF 22377 XM (and)SH /Times-Roman SF 24139 XM (the "file warning" feature is not enabled,) 12 W( then the previous copy of)13 W 12120 14097 MT (the file will disappear.)SH 6120 15888 MT (flow-control {none, xon/xoff})SH 8120 16993 MT (Normally xon/xoff for full duplex flow) 27 W( control. Should be set to 'none' if the other system cannot do xon/xoff)28 W 8120 18098 MT (flow control, or) 1 W( if you have issued a 'set handshake' command. If set to xon/xoff, then handshake should be set)SH 8120 19203 MT (to none.) 48 W( This) 348 W( setting applies during both terminal connection and file transfer.)49 W /Times-Italic SF 40746 XM (Warning:)SH /Times-Roman SF 44878 XM (This command may)49 W 8120 20308 MT (have no effect on certain Unix systems, where Kermit puts the communication line into 'rawmode',) 215 W( and)214 W 8120 21413 MT (rawmode precludes flow control.)SH 6120 22990 MT (incomplete {discard, keep})SH 8120 24095 MT (Disposition for incompletely received files. If an incoming file is interrupted or an error occurs during transfer,)10 W 8120 25200 MT (the part that was received so far is normally discarded. If you "set incomplete keep" then such file) 61 W( fragments)62 W 8120 26305 MT (will be kept.)SH 6120 27882 MT (handshake {xon, xoff, cr, lf, bell, esc, none})SH 8120 28987 MT (Normally none. Otherwise, half-duplex communication line turnaround handshaking is done,) 148 W( which means)149 W 8120 30092 MT (Unix Kermit will not reply to a packet until it has received the indicated handshake character or has) 47 W( timed out)46 W 8120 31197 MT (waiting for it;) 43 W( the handshake setting applies only during file transfer. If you set handshake to other than none,)44 W 8120 32302 MT (then flow should be set to none.)SH 6120 33879 MT (line [device-name])SH 8120 34984 MT (The device name for the communication line to be) 274 W( used for file transfer and terminal connection, e.g.)275 W /Courier SF 8120 36089 MT (/dev/ttyi3)SH /Times-Roman SF (. If) 284 W( you specify a device name, Kermit will be in local mode, and you should remember to issue)16 W 8120 37194 MT (any other necessary 'set' commands, such as 'set speed'.) 19 W( If) 290 W( you omit the device name, Kermit will revert to its)20 W 8120 38299 MT (default mode of operation. If you specify)45 W /Courier SF 25393 XM (/dev/tty)SH /Times-Roman SF (, Kermit) 45 W( will enter remote mode \050useful when logged in)44 W 8120 39404 MT (through the "back port" of) 100 W( a system normally used as a local-mode workstation\051. When Unix Kermit enters)101 W 8120 40509 MT (local mode, it attempts to synchronize with other) 4 W( programs \050like uucp\051 that use external communication lines so)3 W 8120 41614 MT (as to prevent two programs using the same line at once; before attempting to lock the specified line, it will close)SH 8120 42719 MT (and unlock any external) 67 W( line that was previously in use. The method used for locking is the "uucp lock file",)66 W 8120 43824 MT (explained in more detail later.)SH 6120 45401 MT (modem-dialer {direct, hayes, racalvadic, ventel, ...})SH 8120 46506 MT (The type) 59 W( of modem dialer on the communication line. "Direct" indicates either there is no dialout modem, or)58 W 8120 47611 MT (that if the line requires carrier detection) 217 W( to open, then 'set line' will hang waiting for an incoming call.)218 W 8120 48716 MT ("Hayes", "Ventel", and the others indicate that 'set line' \050or the -l argument\051 will) 4 W( prepare for a subsequent 'dial')3 W 8120 49821 MT (command for the given dialer. Support for new dialers is added from time to time, so type 'set modem ?' for) 24 W( a)25 W 8120 50926 MT (list of those supported in your copy of Kermit. See the description of the 'dial' command)SH 6120 52503 MT (parity {even, odd, mark, space, none})SH 8120 53608 MT (Specify character) 225 W( parity for use in packets and terminal connection, normally none. If other than none,)226 W 8120 54713 MT (C-Kermit will seek to use the 8th-bit) 22 W( prefixing mechanism for transferring 8-bit binary data, which can be used)21 W 8120 55818 MT (successfully only if the other Kermit agrees; if not, 8-bit binary data cannot be successfully transferred.)SH 6120 57395 MT (prompt [string])SH 8120 58500 MT (The given string will be substituted for ")66 W /Courier SF (C-Kermit)SH /Times-Roman SF (>" as this program's prompt. If the string is omitted, the)65 W 8120 59605 MT (prompt will revert to ")32 W /Courier SF (C-Kermit>)SH /Times-Roman SF (". If) 314 W( the) 32 W( string is enclosed in doublequotes, the quotes will be stripped and)33 W 8120 60710 MT (any leading and trailing blanks will be retained.)SH 6120 62287 MT (send)SH /Times-Italic SF 8203 XM (parameter)SH /Times-Roman SF 8120 63392 MT (Establish parameters to use when sending packets. These) 20 W( will be in effect only for the initial packet sent, since)21 W 8120 64497 MT (the other Kermit may override these parameters during the protocol parameter exchange \050unless noted below\051.)SH 8120 66288 MT (end-of-packet)SH /Times-Italic SF 13923 XM (cc)SH /Times-Roman SF 10120 67393 MT (Specifies the control character needed by the other Kermit to recognize the end of a packet.) 113 W( C-Kermit)477 W 10120 68498 MT (sends this character at the end of each packet.) 249 W( Normally) 747 W( 13 \050carriage return\051, which most Kermit)248 W 10120 69603 MT (implementations require. Other Kermits require no terminator at all,) 96 W( still others may require a different)97 W 10120 70708 MT (terminator, like linefeed \05010\051.)SH ES %%Page: 145 146 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (6.4. Interactive Operation)SH 10 /Times-Italic AF 51275 XM (Page 145)SH 46800 50 8280 5709 UL /Times-Roman SF 10280 7886 MT (packet-length)SH /Times-Italic SF 15973 XM (n)SH /Times-Roman SF 12280 8991 MT (Specify the maximum packet length to send. Normally 90. Shorter packet lengths) 29 W( can be useful on noisy)30 W 12280 10096 MT (lines, or with systems or front ends) 11 W( or networks that have small buffers. The shorter the packet, the higher)10 W 12280 11201 MT (the overhead, but the lower the chance of a packet being corrupted by noise, and the less time) 3 W( to retransmit)4 W 12280 12306 MT (corrupted packets. This command overrides the value requested by the) 179 W( other Kermit during protocol)178 W 12280 13411 MT (initiation unless the other Kermit requests a shorter length.)SH 10280 14988 MT (pad-character)SH /Times-Italic SF 15971 XM (cc)SH /Times-Roman SF 12280 16093 MT (Designate a character to send before each packet.) 275 W( Normally,) 799 W( none is sent. Outbound padding is)274 W 12280 17198 MT (sometimes necessary for communicating with slow half duplex systems that provide no other means of)117 W 12280 18303 MT (line turnaround control. It can also be used to send) 56 W( special characters to communications equipment that)55 W 12280 19408 MT (needs to be put in "transparent" or "no echo" mode, when this can be accomplished in by feeding it a)132 W 12280 20513 MT (certain control character.)SH 10280 22090 MT (padding)SH /Times-Italic SF 13752 XM (n)SH /Times-Roman SF 12280 23195 MT (How many pad characters to send, normally 0.)SH 10280 24772 MT (start-of-packet)SH /Times-Italic SF 16361 XM (cc)SH /Times-Roman SF 12280 25877 MT (The normal Kermit packet prefix is Control-A \0501\051; this command changes the prefix C-Kermit puts) 126 W( on)125 W 12280 26982 MT (outbound packets. The only reasons this should ever be) 135 W( changed would be: Some piece of equipment)136 W 12280 28087 MT (somewhere between the two Kermit programs will not pass through a Control-A; or, some piece of of)132 W 12280 29192 MT (equipment similarly placed is echoing its input. In the latter case, the recipient of such an echo can) 3 W( change)4 W 12280 30297 MT (the packet prefix for outbound packets to be different from that of arriving packets,) 123 W( so that the echoed)122 W 12280 31402 MT (packets will be ignored. The opposite) 169 W( Kermit must also be told to change the prefix for its inbound)170 W 12280 32507 MT (packets.)SH 10280 34084 MT (timeout)SH /Times-Italic SF 13586 XM (n)SH /Times-Roman SF 12280 35189 MT (Specifies the number of seconds you want the other Kermit to wait for a packet before timing) 73 W( it out and)74 W 12280 36294 MT (requesting retransmission.)SH 8280 38085 MT (receive)SH /Times-Italic SF 11417 XM (parameter)SH /Times-Roman SF 10280 39190 MT (Establish parameters to request the other Kermit to use when sending packets.)SH 10280 40981 MT (end-of-packet)SH /Times-Italic SF 16083 XM (cc)SH /Times-Roman SF 12280 42086 MT (Requests the other Kermit to terminate its packets with the specified character.)SH 10280 43663 MT (packet-length)SH /Times-Italic SF 15973 XM (n)SH /Times-Roman SF 12280 44768 MT (Specify the maximum packet length to that you want the other Kermit to send,) 174 W( normally 90. If you)175 W 12280 45873 MT (specify a length of 95) 71 W( or greater, then it will be used if the other Kermit supports, and agrees to use, the)70 W 12280 46978 MT (Kermit protocol extension for long packets. In this case, the maximum length depends) 57 W( upon the systems)58 W 12280 48083 MT (involved, but there would normally be no reason for packets to be more than about 1000 characters) 126 W( in)125 W 12280 49188 MT (length. The) 250 W( 'show parameters' command displays C-Kermit's current and maximum packet lengths.)SH 10280 50765 MT (pad-character)SH /Times-Italic SF 15971 XM (cc)SH /Times-Roman SF 12280 51870 MT (C-Kermit normally does not need to have incoming packets) 21 W( preceded with pad characters. This command)20 W 12280 52975 MT (allows C-Kermit to request the other Kermit to use)SH /Times-Italic SF 32861 XM (cc)SH /Times-Roman SF 33999 XM (as a pad character. Default)SH /Times-Italic SF 45133 XM (cc)SH /Times-Roman SF 46271 XM (is NUL, ASCII 0.)SH 10280 54552 MT (padding)SH /Times-Italic SF 13752 XM (n)SH /Times-Roman SF 12280 55657 MT (How many pad characters to ask for, normally 0.)SH 10280 57234 MT (start-of-packet)SH /Times-Italic SF 16361 XM (cc)SH /Times-Roman SF 12280 58339 MT (Change the prefix C-Kermit looks for on inbound packets to correspond with what) 123 W( the other Kermit is)124 W 12280 59444 MT (sending.)SH 10280 61021 MT (timeout)SH /Times-Italic SF 13586 XM (n)SH /Times-Roman SF 12280 62126 MT (Normally, each Kermit partner sets its packet timeout interval) 7 W( based on what the opposite Kermit requests.)8 W 12280 63231 MT (This command) 201 W( allows you to override the normal procedure and specify a timeout interval for Unix)200 W 12280 64336 MT (Kermit to use when waiting for packets from the other Kermit. If you) 102 W( specify 0, then no timeouts will)103 W 12280 65441 MT (occur, and Unix Kermit will wait forever for expected packets to arrive.)SH 8280 67232 MT (speed {0, 110, 150, 300, 600, 1200, 1800, 2400, 4800, 9600})SH 10280 68337 MT (The baud) 27 W( rate for the external communication line. This command cannot be used to change the speed of your)28 W 10280 69442 MT (own console terminal.) 63 W( Many) 375 W( Unix systems are set up in such a way that you must give this command after a)62 W 10280 70547 MT ('set line' command before you can use the line. 'set baud' is a synomym for 'set speed'.)SH ES %%Page: 146 147 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 146)SH 12 /Times-Bold AF 31387 XM (Kermit User Guide: UNIX KERMIT \0506.4\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (terminal)SH 8120 8991 MT (Used for specifying terminal parameters. Currently, 'bytesize' is the only parameter provided, and it can be) 15 W( set)14 W 8120 10096 MT (to 7 or 8. It's 7 by default.)SH 13 /Times-Bold AF 23127 13455 MT (The 'show' Command:)SH 10 /Times-Roman AF 6120 15828 MT (Syntax:)SH /Courier SF 9426 XM (show {parameters, versions})SH /Times-Roman SF 6120 18220 MT (The "show" command) 156 W( with the default argument of "parameters" displays the values of all the 'set' parameters)157 W 6120 19416 MT (described above. If) 69 W( you type "show versions", then C-Kermit will display the version numbers and dates of all its)68 W 6120 20612 MT (internal modules. You) 77 W( should use the "show versions" command to ascertain the vintage of your Kermit program)78 W 6120 21808 MT (before reporting problems to Kermit maintainers.)SH 13 /Times-Bold AF 22153 25167 MT (The 'statistics' Command:)SH 10 /Times-Roman AF 6120 27540 MT (The statistics command displays) 84 W( information about the most recent Kermit protocol transaction, including file and)83 W 6120 28736 MT (communication line i/o, timing and efficiency, as) 153 W( well as what encoding options were in effect \050such as 8th-bit)154 W 6120 29932 MT (prefixing, repeat-count compression\051.)SH 13 /Times-Bold AF 20022 33291 MT (The 'take' and 'echo' Commands:)SH 10 /Times-Roman AF 6120 35664 MT (Syntax:)SH /Courier SF 9426 XM (take)SH /Times-Italic SF 12426 XM (fn1)SH /Courier SF 7370 36860 MT (echo)SH /Times-Italic SF 10370 XM ([text to be echoed])SH /Times-Roman SF 6120 39252 MT (The 'take' command instructs C-Kermit to execute commands from the named file.) 172 W( The) 593 W( file may contain any)171 W 6120 40448 MT (interactive C-Kermit commands, including 'take'; command files) 22 W( may be nested to any reasonable depth, but it may)23 W 6120 41644 MT (not contain text to be sent to a remote system during the 'connect' command. This means that a command file like)41 W 6120 42840 MT (this:)SH /Courier SF 8520 44495 MT (set line /dev/tty17)SH 8520 45526 MT (set speed 9600)SH 8520 46557 MT (connect)SH 8520 47588 MT (login myuserid)SH 8520 48619 MT (mypassword)SH /Times-Italic SF 8520 49650 MT (etc)SH /Times-Roman SF 6120 51367 MT (will not send "login myserid" or any) SH( of the following text to the remote system. To carry on a canned dialog, use the)1 W 6120 52563 MT ('script' command, described later.)SH 6120 54955 MT (The ')26 W /Courier SF (%)SH /Times-Roman SF (' command is useful for including comments in take-command files.) 26 W( It) 301 W( may only be used at the beginning of)25 W 6120 56151 MT (a line.)SH 6120 58543 MT (The 'echo' command may be used within command files to issue greetings, announce progress, ring the terminal)106 W 6120 59739 MT (bell, etc. The 'echo' command should not be confused with the Unix 'echo' command, which can) 42 W( be used to show)41 W 6120 60935 MT (how meta characters would be expanded. The Kermit echo command simply displays its) 111 W( text argument \050almost\051)112 W 6120 62131 MT (literally at the terminal; the argument may contain octal escapes) 122 W( of the form ``)121 W /Courier SF (\134ooo)SH /Times-Roman SF ('', where)121 W /Courier SF 45447 XM (o)SH /Times-Roman SF 46418 XM (is an octal digit)121 W 6120 63327 MT (\0500-7\051, and there may be 1, 2, or 3 such digits, whose value specify an ASCII) 13 W( character, such as ``)14 W /Courier SF (\134007)SH /Times-Roman SF ('' \050or ``)14 W /Courier SF (\13407)SH /Times-Roman SF ('')SH 6120 64523 MT (or just ``)117 W /Courier SF (\1347)SH /Times-Roman SF (''\051 for) 117 W( beep, ``)116 W /Courier SF (\134012)SH /Times-Roman SF ('' for newline, etc. Of course, each backslash must be must be entered twice in)116 W 6120 65719 MT (order for it to be passed along to the echo command by the Kermit command parser.)SH 6120 68111 MT (Take-command files are in exactly the same syntax as interactive commands. Note that this implies) 13 W( that if you want)14 W 6120 69307 MT (to include special characters like question) 125 W( mark or backslash that you would have to quote with backslash when)124 W 6120 70503 MT (typing interactive commands,) 47 W( you must quote these characters the same way in command files. Long lines may be)48 W 6120 71699 MT (continued by ending them with a single backslash.)SH ES %%Page: 147 148 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (6.4. Interactive Operation)SH 10 /Times-Italic AF 51275 XM (Page 147)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (Command files may be used in lieu of command macros, which have) 167 W( not been implemented in this version of)166 W 8280 9082 MT (C-Kermit. For) 410 W( instance, if you commonly connect to a system) 80 W( called 'B' that is connected to ttyh7 at 4800 baud,)81 W 8280 10278 MT (you could create a file called)SH /Courier SF 20054 XM (b)SH /Times-Roman SF 20904 XM (containing the commands)SH /Courier SF 10680 11933 MT (% C-Kermit command file to connect to System B thru /dev/ttyh7)SH 10680 12964 MT (set line /dev/ttyh7)SH 10680 13995 MT (set speed 4800)SH 10680 15026 MT (% Beep and give message)SH 10680 16057 MT (echo \134\134007Connecting to System B...)SH 10680 17088 MT (connect)SH /Times-Roman SF 8280 18805 MT (and then simply type 'take b' \050or 't b' since no) 117 W( other commands begin with the letter 't'\051 whenever you wish to)116 W 8280 20001 MT (connect to system B. Note the comment lines and the beep inserted into the 'echo' command.)SH 8280 22393 MT (For connecting to IBM) 173 W( mainframes, a number of 'set' commands are required; these, too, can be conveniently)174 W 8280 23589 MT (collected into a 'take' file like this one:)SH /Courier SF 10680 25244 MT (% Sample C-Kermit command file to set up current line)SH 10680 26275 MT (% for IBM mainframe communication)SH 10680 27306 MT (%)SH 10680 28337 MT (set parity mark)SH 10680 29368 MT (set handshake xon)SH 10680 30399 MT (set flow-control none)SH 10680 31430 MT (set duplex half)SH /Times-Roman SF 8280 33822 MT (Note that no single command is available to wipe out all of these settings and return) 46 W( C-Kermit to its default startup)45 W 8280 35018 MT (state; to do that, you can either restart) 76 W( the program, or else make a command file that executes the necessary 'set')77 W 8280 36214 MT (commands:)SH /Courier SF 10680 37869 MT (% Sample C-Kermit command file to restore normal settings)SH 10680 38900 MT (%)SH 10680 39931 MT (set parity none)SH 10680 40962 MT (set handshake none)SH 10680 41993 MT (set flow-control xon/xoff)SH 10680 43024 MT (set duplex full)SH /Times-Roman SF 8280 45416 MT (An implicit 'take' command is executed upon your)47 W /Courier SF 29320 XM (.kermrc)SH /Times-Roman SF 33817 XM (file when C-Kermit starts up, upon either interactive)46 W 8280 46612 MT (or command-line invocation. The)17 W /Courier SF 22252 XM (.kermrc)SH /Times-Roman SF 26719 XM (file should contain 'set' or other commands you) 17 W( want to be in effect at)18 W 8280 47808 MT (all times. For instance, you might want) 103 W( override the default action when incoming files have the same names as)102 W 8280 49004 MT (existing files -- in that case, put the command)SH /Courier SF 10680 50659 MT (set file warning on)SH /Times-Roman SF 8280 52376 MT (in your)52 W /Courier SF 11495 XM (.kermrc)SH /Times-Roman SF 15997 XM (file. On) 354 W( some non-Unix systems that run C-Kermit, the initialization file might have a) 52 W( different)53 W 8280 53572 MT (name, such as)SH /Courier SF 14112 XM (kermit.ini)SH /Times-Roman SF (.)SH 8280 55964 MT (Errors encountered during execution of take files) 211 W( \050such as failure to complete dial or script operations\051 cause)210 W 8280 57160 MT (termination of) 119 W( the current take file, popping to the level that invoked it \050take file, interactive level, or the shell\051.)120 W 8280 58356 MT (When kermit is executed in the background, errors during execution of a take file are fatal.)SH 8280 60748 MT (Under Unix, you may also use the shell's redirection mechanism to cause C-Kermit to execute commands from a)90 W 8280 61944 MT (file:)SH /Courier SF 10680 63599 MT (kermit < cmdfile)SH /Times-Roman SF 8280 65316 MT (or you can even pipe commands in from another process:)SH /Courier SF 10680 66971 MT (cmdprocess | kermit)SH ES %%Page: 148 149 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 148)SH 12 /Times-Bold AF 31387 XM (Kermit User Guide: UNIX KERMIT \0506.4\051)SH 46800 50 6120 5709 UL 13 SS 22406 8071 MT (The 'connect' Command:)SH 10 /Times-Roman AF 6120 10444 MT (The 'connect' command \050'c' is an acceptable non-unique abbreviation for 'connect'\051 links) 52 W( your terminal to another)53 W 6120 11640 MT (computer as if it were a local terminal to that computer, through the device specified in the) 92 W( most recent 'set line')91 W 6120 12836 MT (command, or through the default device if your system is a PC or workstation. All characters) 129 W( you type at your)130 W 6120 14032 MT (keyboard are sent out the communication line \050and if you have 'set duplex half', also) 18 W( displayed on your screen\051, and)17 W 6120 15228 MT (all characters arriving at the communication port are displayed on the screen.) 142 W( Current) 536 W( settings of speed, parity,)143 W 6120 16424 MT (duplex, and) 89 W( flow-control are honored, and the data connection is 7 bits wide unless you have given the command)88 W 6120 17620 MT ('set terminal bytesize 8'. If you have issued a 'log) 51 W( session' command, everything you see on your screen will also)52 W 6120 18816 MT (be recorded to your session log. This provides a way to "capture" files from remote systems that don't have) 26 W( Kermit)25 W 6120 20012 MT (programs available.)SH 6120 22404 MT (To get back to) 73 W( your own system, you must type the escape character, which is Control-Backslash \050)74 W /Courier SF (^\134)SH /Times-Roman SF (\051 unless you)74 W 6120 23600 MT (have changed it with the 'set escape' command, followed by a single-character command,) 127 W( such as 'c' for "close)126 W 6120 24796 MT (connection". Single-character) 250 W( commands include:)SH 7120 26587 MT (c)SH 10120 XM (Close the connection)SH 7120 28134 MT (b)SH 10120 XM (Send a BREAK signal)SH 7120 29681 MT (0)SH 10120 XM (\050zero\051 send a null)SH 7120 31228 MT (s)SH 10120 XM (Give a status report about the connection)SH 7120 32775 MT (h)SH 10120 XM (Hangup the phone)SH /Courier SF 7120 34322 MT (^\134)SH /Times-Roman SF 10120 XM (Send Control-Backslash itself \050whatever you have) 17 W( defined the escape character to be, typed twice in a row)18 W 10120 35427 MT (sends one copy of it\051.)SH 6120 37218 MT (Uppercase and control equivalents for \050most of\051 these letters are also accepted.) 149 W( A) 546 W( space typed after the escape)148 W 6120 38414 MT (character is ignored. Any other character will produce a beep.)SH 6120 40806 MT (The connect command simply displays incoming characters on the screen. It is) 236 W( assumed any screen control)237 W 6120 42002 MT (sequences sent by the host will be handled by the firmware or emulation) 23 W( software in your terminal or PC. If special)22 W 6120 43198 MT (terminal emulation is desired, then the 'connect' command can invoked from the Unix command line \050)81 W /Courier SF (-c)SH /Times-Roman SF 49972 XM (or)SH /Courier SF 51137 XM (-n)SH /Times-Roman SF (\051,)SH 6120 44394 MT (piped through a terminal emulation filter, e.g.)SH /Courier SF 8520 46049 MT (kermit -l /dev/acu -b 1200 -c | tek)SH 13 /Times-Bold AF 23670 49408 MT (The 'dial' command:)SH 10 /Times-Roman AF 6120 51781 MT (Syntax:)SH /Courier SF 9426 XM (dial)SH /Times-Italic SF 12426 XM (telephone-number-string)SH /Times-Roman SF 6120 54173 MT (This command controls dialout modems; you should have already issued a "set) 84 W( line" and "set speed" command to)83 W 6120 55369 MT (identify the terminal device, and a "set modem" command to identify the type) 48 W( of modem to be used for dialing. In)49 W 6120 56565 MT (the "dial" command, you supply the phone number and the Kermit program feeds it to the modem in the appropriate)17 W 6120 57761 MT (format and then) 112 W( interprets dialer return codes and modem signals to inform you whether the call was completed.)113 W 6120 58957 MT (The telephone-number-string may contain imbedded modem-dialer commands, such) 52 W( as comma for Hayes pause, or)51 W 6120 60153 MT (`)SH /Courier SF (&)SH /Times-Roman SF (' for Ventel dialtone wait and `)SH /Courier SF (%)SH /Times-Roman SF (' for Ventel pause \050consult your modem manual for details\051.)SH 6120 62545 MT (At the time of this writing, support is included for the following modems:)SH /Symbol SF 7910 64450 MT (\267)SH /Times-Roman SF 8620 XM (AT&T 7300 Internal Modem)SH /Symbol SF 7910 65555 MT (\267)SH /Times-Roman SF 8620 XM (Cermetek Info-Mate 212A)SH /Symbol SF 7910 66660 MT (\267)SH /Times-Roman SF 8620 XM (Concord Condor CDS 220)SH /Symbol SF 7910 67765 MT (\267)SH /Times-Roman SF 8620 XM (DEC DF03-AC)SH /Symbol SF 7910 68870 MT (\267)SH /Times-Roman SF 8620 XM (DEC DF100 Series)SH /Symbol SF 7910 69975 MT (\267)SH /Times-Roman SF 8620 XM (DEC DF200 Series)SH /Symbol SF 7910 71080 MT (\267)SH /Times-Roman SF 8620 XM (General DataComm 212A/ED)SH ES %%Page: 149 150 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (6.4. Interactive Operation)SH 10 /Times-Italic AF 51275 XM (Page 149)SH 46800 50 8280 5709 UL /Symbol SF 10070 8000 MT (\267)SH /Times-Roman SF 10780 XM (Hayes Smartmodem 1200 and compatibles)SH /Symbol SF 10070 9105 MT (\267)SH /Times-Roman SF 10780 XM (Penril)SH /Symbol SF 10070 10210 MT (\267)SH /Times-Roman SF 10780 XM (Racal Vadic)SH /Symbol SF 10070 11315 MT (\267)SH /Times-Roman SF 10780 XM (US Robotics 212A)SH /Symbol SF 10070 12420 MT (\267)SH /Times-Roman SF 10780 XM (Ventel)SH 8280 14211 MT (Support for) 42 W( new modems is added to the program from time to time; you can check the current list by typing ")43 W /Courier SF (set)SH 8280 15407 MT (modem ?)SH /Times-Roman SF (".)SH 8280 17799 MT (The device used for dialing out is the one selected in the most recent "set line" command) 58 W( \050or on a workstation, the)57 W 8280 18995 MT (default line if no "set line" command was given\051.) 50 W( The) 352 W( "dial" command calls locks the path \050see the section on line)51 W 8280 20191 MT (locking below\051 and establishes a call on an exclusive basis. If it is desired to dial a) 42 W( call and then return to the shell)41 W 8280 21387 MT (\050such as to do kermit) 132 W( activities depending on standard in/out redirection\051, it is necessary to place the dialed call)133 W 8280 22583 MT (under one device name \050say, ")23 W /Courier SF (/dev/cua0)SH /Times-Roman SF ("\051 and) 23 W( then escape to the shell)22 W /Times-Italic SF 38232 XM (within Kermit)22 W /Times-Roman SF 44055 XM (on a linked device which is)22 W 8280 23779 MT (separate from the dialed line \050say, ")57 W /Courier SF (/dev/cul0)SH /Times-Roman SF ("\051. This) 364 W( is the same technique used by) 57 W( uucp \050to allow locks to be)58 W 8280 24975 MT (placed separately for dialing and conversing\051.)SH 8280 27367 MT (Because modem dialers have strict requirements to override the carrier-detect signal most Unix) 137 W( implementations)136 W 8280 28563 MT (expect, the sequence for dialing is more rigid than most other C-Kermit procedures.)SH 8280 30955 MT (Example one:)SH /Courier SF 10680 32610 MT (kermit -l /dev/cul0 -b 1200)SH 16200 50 10680 32810 UL 10680 33641 MT (C-Kermit>set modem-dialer hayes)SH /Times-Italic SF 31680 XM (hint: abbreviate)SH /Courier SF 38696 XM (set m h)SH 13200 50 16080 33841 UL 10680 34672 MT (C-Kermit>dial 9,5551212)SH 8400 50 16080 34872 UL 10680 35703 MT (Connected!)SH 10680 36734 MT (C-Kermit>connect)SH /Times-Italic SF 31680 XM (hint: abbreviate)SH /Courier SF 38696 XM (c)SH 4200 50 16080 36934 UL /Times-Italic SF 10680 37765 MT (logon, request remote server, etc.)SH /Courier SF 10680 38796 MT (^\134c)SH /Times-Italic SF 31680 XM (escape back)SH 1800 50 10680 38996 UL /Courier SF 10680 39827 MT (C-Kermit> ...)SH 10680 40858 MT (C-Kermit>quit)SH /Times-Italic SF 31680 XM (hint: abbreviate)SH /Courier SF 38696 XM (q)SH 2400 50 16080 41058 UL /Times-Roman SF 8280 42575 MT (this disconnects modem, and unlocks line.)SH 8280 44967 MT (Example two:)SH /Courier SF 10680 46622 MT (kermit)SH 3600 50 10680 46822 UL 10680 47653 MT (C-Kermit>set modem-dialer ventel)SH 13800 50 16080 47853 UL 10680 48684 MT (C-Kermit>set line /dev/cul0)SH 10800 50 16080 48884 UL 10680 49715 MT (C-Kermit>dial 9&5551212%)SH 9000 50 16080 49915 UL 10680 50746 MT (Connected!)SH 10680 51777 MT (C-Kermit> ...)SH /Times-Roman SF 8280 53494 MT (Example three:)SH /Courier SF 10680 55149 MT (kermit)SH 10680 56180 MT (C-Kermit>take my-dial-procedure)SH 13200 50 16080 56380 UL 10680 57211 MT (Connected!)SH /Times-Italic SF 10680 58926 MT (file my-dial-procedure)SH /Courier SF (:)SH 10680 59957 MT (set modem hayes)SH 10680 60988 MT (set line /dev/tty99)SH 10680 62019 MT (dial 5551212)SH 10680 63050 MT (connect)SH /Times-Roman SF 8280 64767 MT (In general, C-Kermit requires that the modem provide the "carrier detect" \050CD\051 signal when a call is in progress, and)7 W 8280 65963 MT (remove that signal when the call completes or the line drops. If a modem) 37 W( switch setting is available to force CD, it)36 W 8280 67159 MT (should normally not be in that setting. C-Kermit also requires \050on) 234 W( most systems\051 that the modem track the)235 W 8280 68355 MT (computer's "data terminal ready" \050DTR\051 signal. If a switch setting is available to simulate DTR asserted within) 35 W( the)34 W 8280 69551 MT (modem, then it should normally not) 16 W( be in that setting. Otherwise the modem will be unable to hang up at the end of)17 W 8280 70747 MT (a call or when interrupts are received by Kermit.)SH ES %%Page: 150 151 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 150)SH 12 /Times-Bold AF 31387 XM (Kermit User Guide: UNIX KERMIT \0506.4\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (For Hayes dialers, two important switch settings are #1 and #6. Switch #1 should be normally be UP so) 77 W( that the)76 W 6120 9082 MT (modem can act according) 94 W( to your computer's DTR signal. But if your computer, or particular implementation of)95 W 6120 10278 MT (Kermit, cannot control DTR, then switch 1 should be DOWN. Switch #6 should normally be) 65 W( UP so carrier-detect)64 W 6120 11474 MT (functions properly \050but put) 56 W( it DOWN if you have trouble with the UP position\051. Switches #2 \050English versus digit)57 W 6120 12670 MT (result codes\051 and #4 \050Hayes echoes modem commands\051 may be in either position.)SH 6120 15062 MT (If you want to interrupt a dial command in progress \050for instance, because you just realize that) 7 W( you gave it the wrong)6 W 6120 16258 MT (number\051, type a Control-C to get back to command level.)SH 13 /Times-Bold AF 22948 19617 MT (The 'script' Command:)SH 10 /Times-Roman AF 6120 21990 MT (Syntax:)SH /Courier SF 9426 XM (script)SH /Times-Italic SF 13626 XM (expect send [expect send] . . .)SH /Times-Roman SF 6120 24382 MT ("expect" has the syntax:)SH /Times-Italic SF 15990 XM (expect[-send-expect[-send-expect[...]]])SH /Times-Roman SF 6120 26774 MT (The 'script' command carries on a "canned dialog" with a remote) 119 W( system, in which data is sent according to the)120 W 6120 27970 MT (remote system's responses. The typical use is for logging in to a remote system automatically.)SH 6120 30362 MT (C-Kermit's script facility operates in a manner similar to that commonly used by the Unix UUCP) 1 W( system's ")SH /Courier SF (L.sys)SH /Times-Roman SF (")SH 6120 31558 MT (file entries. A login script is a sequence of the form:)SH /Times-Italic SF 8520 33273 MT (expect send [expect send] . . .)SH /Times-Roman SF 6120 34990 MT (where)SH /Times-Italic SF 8843 XM (expect)SH /Times-Roman SF 11677 XM (is a prompt or message to be issued by the remote site,) 30 W( and)31 W /Times-Italic SF 35844 XM (send)SH /Times-Roman SF 37958 XM (is the string \050names, numbers, etc\051 to)31 W 6120 36186 MT (return, and expects are separated) 8 W( from sends by spaces. The send may also be the keyword EOT, to send Control-D,)7 W 6120 37382 MT (or BREAK, to send a break signal. Letters in sends may be prefixed by `)SH /Courier SF (~)SH /Times-Roman SF (' to send special characters, including:)SH /Courier SF 8120 39173 MT (~b)SH /Times-Roman SF 10120 XM (backspace)SH /Courier SF 8120 40278 MT (~s)SH /Times-Roman SF 10120 XM (space)SH /Courier SF 8120 41383 MT (~q)SH /Times-Roman SF 10120 XM (`)SH /Courier SF (?)SH /Times-Roman SF ('\050trapped by Kermit's command interpreter\051)SH /Courier SF 8120 42488 MT (~n)SH /Times-Roman SF 10120 XM (linefeed)SH /Courier SF 8120 43593 MT (~r)SH /Times-Roman SF 10120 XM (carriage return)SH /Courier SF 8120 44698 MT (~t)SH /Times-Roman SF 10120 XM (tab)SH /Courier SF 8120 45803 MT (~')SH /Times-Roman SF 10120 XM (single quote)SH /Courier SF 8120 46908 MT (~~)SH /Times-Roman SF 10120 XM (tilde)SH /Courier SF 8120 48013 MT (~")SH /Times-Roman SF 10120 XM (double quote)SH /Courier SF 8120 49118 MT (~x)SH /Times-Roman SF 10120 XM (XON \050Control-Q\051)SH /Courier SF 8120 50223 MT (~c)SH /Times-Roman SF 10120 XM (don't append a carriage return)SH /Courier SF 8120 51328 MT (~)SH /Times-Italic SF (o[o[o]])SH /Times-Roman SF 12276 XM (an octal character)SH /Courier SF 8120 52433 MT (~d)SH /Times-Roman SF 10120 XM (delay approx 1/3 second during send)SH /Courier SF 8120 53538 MT (~w)SH /Times-Italic SF ([d[d]])SH /Times-Roman SF 12376 XM (wait specified interval during expect, then time out)SH 6120 55329 MT (As with some UUCP systems, sent strings are followed by)SH /Courier SF 29758 XM (~r)SH /Times-Roman SF 31208 XM (unless they have a)SH /Courier SF 38762 XM (~c)SH /Times-Roman SF (.)SH 6120 57721 MT (Only the last 7 characters in each expect are) 31 W( matched. A null)32 W /Times-Italic SF 31299 XM (expect)SH /Times-Roman SF (, e.g.)32 W /Courier SF 36111 XM (~0)SH /Times-Roman SF 37593 XM (or two adjacent dashes, causes a short)32 W 6120 58917 MT (delay before proceeding to the next send sequence. A null expect always succeeds.)SH 6120 61309 MT (As with UUCP, if the expect string does) 31 W( not arrive, the script attempt fails. If you expect that a sequence might not)30 W 6120 62505 MT (arrive, as with UUCP, conditional sequences may be expressed in the form:)SH /Times-Italic SF 8520 64220 MT (-send-expect[-send-expect[...]])SH /Times-Roman SF 6120 65937 MT (where dashed sequences are followed as long as previous expects fail.) 40 W( Timeouts) 332 W( for expects can be specified using)41 W /Courier SF 6120 67133 MT (~w)SH /Times-Roman SF (;)SH /Courier SF 7848 XM (~w)SH /Times-Roman SF 9298 XM (with no arguments waits 15 seconds.)SH /Times-Italic SF 6120 69525 MT (Expect/send)SH /Times-Roman SF 11399 XM (transactions can be easily be debugged by) 197 W( logging transactions. This records all exchanges, both)196 W 6120 70721 MT (expected and actual. The script execution will also be logged in the session log, if that is activated.)SH ES %%Page: 151 152 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (6.4. Interactive Operation)SH 10 /Times-Italic AF 51275 XM (Page 151)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (Note that `)SH /Courier SF (\134)SH /Times-Roman SF (' characters in login scripts, as in) SH( any other C-Kermit interactive commands, must be doubled up. A line)1 W 8280 9082 MT (may be ended with a single `)SH /Courier SF (\134)SH /Times-Roman SF (' for continuation.)SH 8280 11474 MT (Example one:)SH 8280 13866 MT (Using a modem, dial a UNIX host) 14 W( site. Expect "login" \050...gin\051, and if it doesn't come, simply send a null string with)13 W 8280 15062 MT (a)SH /Courier SF 9035 XM (~r)SH /Times-Roman SF (. \050Some) 372 W( Unixes require either an EOT or a BREAK instead of the null sequence, depending on the particular)61 W 8280 16258 MT (site's "logger" program.\051 After providing user id and password, respond "x" to a question-mark prompt, expect the)43 W 8280 17454 MT (Bourne shell ")100 W /Courier SF ($)SH /Times-Roman SF (" prompt \050and send return if it doesn't arrive\051. Then cd to directory kermit, and) 100 W( run the program)101 W 8280 18650 MT (called "wermit", entering the interactive connect state after wermit is loaded.)SH /Courier SF 10680 20305 MT (set modem ventel)SH 10680 21336 MT (set line /dev/tty77)SH 10680 22367 MT (set baud 1200)SH 10680 23398 MT (dial 9&5551212)SH 10680 24429 MT (script gin:--gin:--gin: smith ssword: mysecret ~q x $--$ \134)SH 11280 25460 MT (cd~skermit $ wermit)SH 10680 26491 MT (connect)SH /Times-Roman SF 8280 28208 MT (Note that 'set line' is issued)SH /Times-Italic SF 19668 XM (after)SH /Times-Roman SF 21807 XM ('set modem', but)SH /Times-Italic SF 28862 XM (before)SH /Times-Roman SF 31667 XM ('set baud' or other line-related parameters.)SH 8280 30600 MT (Example two:)SH 8280 32992 MT (Using a modem, dial the Telenet network.) 133 W( This) 515 W( network expects three returns with slight delays between them.)132 W 8280 34188 MT (These are sent following null expects. The single return is here sent as a null string, with a) 119 W( return appended by)120 W 8280 35384 MT (default. Four) 542 W( returns are sent to be safe before looking for the prompt. Then) 146 W( the Telenet id and password are)145 W 8280 36580 MT (entered. Then) 320 W( Telenet is instructed to connect to a host site \050c) 35 W( 12345\051. The host has a data switch that asks "which)36 W 8280 37776 MT (system"; the script responds "myhost" \050if the "which system" prompt doesn't appear, the Telenet connect) 40 W( command)39 W 8280 38972 MT (is reissued\051.) 177 W( The) 606 W( script waits for an ``)178 W /Courier SF (@)SH /Times-Roman SF ('' prompt from the host, then sends the user ID \050"joe"\051 and password)178 W 8280 40168 MT (\050"secret"\051, looks for another ``)161 W /Courier SF (@)SH /Times-Roman SF ('' prompt,) 161 W( runs Kermit, and in response to the Kermit's prompt \050which ends in)160 W 8280 41364 MT (``)SH /Courier SF (>)SH /Times-Roman SF (''\051, gives the commands "set parity even" and "server". Files are then exchanged.) 55 W( The) 362 W( commands are in a take)56 W 8280 42560 MT (file; note the continuation of the 'script' command onto several lines using the `)SH /Courier SF (\134)SH /Times-Roman SF (' terminator.)SH /Courier SF 10680 44215 MT (set modem hayes)SH 10680 45246 MT (set line /dev/acu)SH 10680 46277 MT (set speed 1200)SH 10680 47308 MT (set parity mark)SH 10680 48339 MT (dial 9,5551212)SH 10680 49370 MT (script ~0 ~0 ~0 ~0 ~0 ~0 ~0 ~0 @--@--@ id~saa001122 = 002211 @ \134)SH 13080 50401 MT (c~s12345 ystem-c~s12345-ystem myhost @ joe~ssecret @ kermit \134)SH 13080 51432 MT (> set~sparity~seven > server)SH 10680 52463 MT (send some.stuff)SH 10680 53494 MT (get some.otherstuff)SH 10680 54525 MT (bye)SH 10680 55556 MT (quit)SH /Times-Roman SF 8280 57273 MT (Since these commands may be executed totally in the background, they can also be scheduled.) 150 W( A) 548 W( typical shell)149 W 8280 58469 MT (script, which might be scheduled by cron, would be as follows \050csh used for this example\051:)SH /Courier SF 10680 60124 MT (#)SH 10680 61155 MT (#keep trying to dial and log onto remote host and exchange files)SH 10680 62186 MT (#wait 10 minutes before retrying if dial or script fail.)SH 10680 63217 MT (#)SH 10680 64248 MT (cd someplace)SH 10680 65279 MT (while \050 1 \051)SH 15480 66310 MT (kermit < /tonight.cmd >> nightly.log &)SH 15480 67341 MT (if \050 ! $status \051 break)SH 15480 68372 MT (sleep 600)SH 10680 69403 MT (end)SH /Times-Roman SF 8280 71120 MT (File)SH /Courier SF 10192 XM (tonight.cmd)SH /Times-Roman SF 17148 XM (might have two takes in it, for example, one to take a file with the) 106 W( set modem, set line, set)107 W ES %%Page: 152 153 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 152)SH 12 /Times-Bold AF 31387 XM (Kermit User Guide: UNIX KERMIT \0506.4\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (baud, dial, and script, and a second take of a file with send/get commands) 70 W( for the remote server. The last lines of)69 W /Courier SF 6120 9082 MT (tonight.cmd)SH /Times-Roman SF 12970 XM (should be a bye and a quit.)SH 13 /Times-Bold AF 23344 12441 MT (The 'help' Command:)SH 10 /Times-Roman AF 6120 14814 MT (Syntax:)SH /Courier SF 9776 XM (help)SH /Times-Italic SF 7920 15845 MT (or)SH /Courier SF (: help)SH /Times-Italic SF 13009 XM (keyword)SH 7920 16876 MT (or)SH /Courier SF (: help {set, remote})SH /Times-Italic SF 21409 XM (keyword)SH /Times-Roman SF 6120 19268 MT (Brief help messages or menus are always available) 69 W( at interactive command level by typing a question mark at any)70 W 6120 20464 MT (point. A) 276 W( slightly more verbose form of help is available) 13 W( through the 'help' command. The 'help' command with no)12 W 6120 21660 MT (arguments prints a brief summary of how to enter commands and how) 58 W( to get further help. 'help' may be followed)59 W 6120 22856 MT (by one of the top-level C-Kermit command keywords, such) 136 W( as 'send', to request information about a command.)135 W 6120 24052 MT (Commands such as 'set' and) 12 W( 'remote' have a further level of help. Thus you may type 'help', 'help set', or 'help set)13 W 6120 25248 MT (parity'; each will provide a successively more detailed level of help.)SH 13 /Times-Bold AF 20347 28607 MT (The 'exit' and 'quit' Commands:)SH 10 /Times-Roman AF 6120 30980 MT (These two commands are identical. Both of them do the following:)SH /Symbol SF 7910 32885 MT (\267)SH /Times-Roman SF 8620 XM (Attempt to insure that the terminal is returned to normal.)SH /Symbol SF 7910 33990 MT (\267)SH /Times-Roman SF 8620 XM (Relinquish access to any communication line assigned via 'set line'.)SH /Symbol SF 7910 35095 MT (\267)SH /Times-Roman SF 8620 XM (Relinquish any uucp and multiuser locks on the communications line.)SH /Symbol SF 7910 36200 MT (\267)SH /Times-Roman SF 8620 XM (Hang up the modem, if the communications line supports data terminal ready.)SH /Symbol SF 7910 37305 MT (\267)SH /Times-Roman SF 8620 XM (Close any open logs or other files.)SH 6120 39096 MT (After exit from C-Kermit, your default directory will be the same) 141 W( as when you started the program. The 'exit')140 W 6120 40292 MT (command is issued) 151 W( implicitly whenever C-Kermit halts normally, e.g. after a command line invocation, or after)152 W 6120 41488 MT (certain kinds of interruptions.)SH 14 /Times-Bold AF 6120 45090 MT (6.5. UUCP Lock Files)SH 10 /Times-Roman AF 6120 47208 MT (Unix has no standard way of) 14 W( obtaining exclusive access to an external communication line. When you issue the 'set)13 W 6120 48404 MT (line' command to Unix Kermit, Unix would normally grant you access to the line even) 124 W( if some other process is)125 W 6120 49600 MT (making use of it.) 150 W( The) 549 W( method adopted by most Unix systems to handle this situation is the "UUCP lock file".)149 W 6120 50796 MT (UUCP, the Unix-to-Unix Copy program, creates a file) 174 W( in its directory \050usually)175 W /Courier SF 39709 XM (/usr/spool/uucp)SH /Times-Roman SF (, on some)175 W 6120 51992 MT (systems)SH /Courier SF 9537 XM (/etc/locks)SH /Times-Roman SF (\051 with a name like)SH /Courier SF 23008 XM (LCK..)SH /Times-Italic SF (name)SH /Times-Roman SF (, where)SH /Times-Italic SF 31367 XM (name)SH /Times-Roman SF 33783 XM (is the device name, for instance)SH /Courier SF 46641 XM (tty07)SH /Times-Roman SF (.)SH 6120 54384 MT (Unix Kermit uses UUCP lock files in) 97 W( order to avoid conflicts with UUCP, tip, or other programs that follow this)96 W 6120 55580 MT (convention. Whenever) 278 W( you attempt to access an external line using) 14 W( the 'set line' command or `)15 W /Courier SF (-l)SH /Times-Roman SF (' on the command)15 W 6120 56776 MT (line, Kermit looks in the UUCP directory for a lock file corresponding to that device. For instance, if you 'set) 49 W( line)48 W 6120 57972 MT (/dev/ttyi6' then Kermit looks for the file)SH /Courier SF 8520 59627 MT (/usr/spool/uucp/LCK..ttyi6)SH /Times-Roman SF 6120 61344 MT (If it finds this file, it gives you) 11 W( an error message and a directory listing of the file so that you can see who is using it,)12 W 6120 62540 MT (e.g.)SH /Courier SF 8520 64195 MT (-r--r--r-- 1) 600 W( fdc) SH( 4) 4200 W( May 7 13:02 /usr/spool/uucp/LCK..ttyi6)SH /Times-Roman SF 6120 65912 MT (In this case, you would look up user fdc to find out how soon the line will become free.)SH 6120 68304 MT (This convention requires) 115 W( that the uucp directory be publicly readable and writable. If it is not, the program will)114 W 6120 69500 MT (issue an appropriate warning message,) 66 W( but will allow you to proceed at your own risk \050and the risk of anyone else)67 W 6120 70696 MT (who might also be using the same line\051.)SH ES %%Page: 153 154 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (6.5. UUCP Lock Files)SH 10 /Times-Italic AF 51275 XM (Page 153)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (If no lock file is found, Unix Kermit will attempt create one, thus) 53 W( preventing anyone who subsequently tries to run)52 W 8280 9082 MT (Kermit, UUCP, tip, or similar programs on the same line from) 62 W( gaining access until you release the line. If Kermit)63 W 8280 10278 MT (could not create the lock file \050for instance) 109 W( because the uucp directory is write-protected\051, then you will receive a)108 W 8280 11474 MT (warning message but) 109 W( will be allowed to proceed at your -- and everyone else's -- risk. When Kermit terminates)110 W 8280 12670 MT (normally, your lock file is removed.)SH 8280 15062 MT (Even when the lock directory is writable and readable,) 133 W( the locking mechanism depends upon all users using the)132 W 8280 16258 MT (same name for the same device. If a device has more than one path associated with it, then) 221 W( a lock can be)222 W 8280 17454 MT (circumvented by using an alias.)SH 8280 19846 MT (When a lock-creating program abruptly terminates, e.g. because it crashes or is killed via shell) 69 W( command, the lock)68 W 8280 21042 MT (file remains in the uucp directory, spuriously indicating that the line is in use. If) 35 W( the lock file is owned by yourself,)36 W 8280 22238 MT (you may remove it. Otherwise,) 48 W( you'll have to get the owner or the system manager to remove it, or else wait for a)47 W 8280 23434 MT (system task to do so; uucp supports a function \050uuclean\051 which removes these files after a predetermined age -- uucp)9 W 8280 24630 MT (sites tend to run this function periodically via crontab.)SH 8280 27022 MT (Locking is not needed, or used, if communications occur over the user's login terminal line \050normally)SH /Courier SF 49219 XM (/dev/tty)SH /Times-Roman SF (\051.)SH 8280 29414 MT (It may be seen that line locking is fraught with peril.) 179 W( It) 607 W( is included in Unix Kermit only because other Unix)178 W 8280 30610 MT (communication programs rely on it. While) 109 W( it is naturally desirable to assure exclusive access to a line, it is also)110 W 8280 31806 MT (undesirable to refuse access to a vacant line only because of a) 10 W( spurious lock file, or because the uucp directory is not)9 W 8280 33002 MT (appropriately protected.)SH 14 /Times-Bold AF 8280 36604 MT (6.6. C-Kermit under Berkeley or System III/V Unix:)SH 10 /Times-Roman AF 8280 38722 MT (C-Kermit may be interrupted at command level or during file transfer by typing) 168 W( Control-C. The program will)169 W 8280 39918 MT (perform its normal exit function, restoring the terminal and) 138 W( releasing any lock. If a protocol transaction was in)137 W 8280 41114 MT (progress, an error packet will be sent to the opposite Kermit so that it can terminate cleanly.)SH 8280 43506 MT (C-Kermit may be invoked in the background \050")5 W /Courier SF (&)SH /Times-Roman SF (" on shell commmand line\051.) 5 W( If) 261 W( a background process is "killed", the)6 W 8280 44702 MT (user will have to manually remove any lock file and may need to restore the modem. This is) 28 W( because the kill signal)27 W 8280 45898 MT (\050)SH /Courier SF (kill\050)SH /Times-Italic SF (x)SH /Courier SF (,9\051)SH /Times-Roman SF (\051 cannot be trapped by Kermit.)SH 8280 48290 MT (During execution of a system command \050'directory', 'cwd', or `)105 W /Courier SF (!)SH /Times-Roman SF ('\051, C-Kermit can often be) 105 W( returned to command)106 W 8280 49486 MT (level by typing a single Control-C. \050With System III/V,) 21 W( the usual interrupt function \050often the DEL key\051 is replaced)20 W 8280 50682 MT (by Control-C.\051)SH 8280 53074 MT (Under Berkeley Unix only: C-Kermit may also be interrupted by)70 W /Courier SF 35144 XM (^Z)SH /Times-Roman SF 36665 XM (to put the process in the background. In this)71 W 8280 54270 MT (case the terminal is not restored. You will have to type Control-J followed by "reset" followed by another Control-J)17 W 8280 55466 MT (to get your terminal back to normal.)SH 8280 57858 MT (Control-C, Control-Z, and Control-)141 W /Courier SF (\134)SH /Times-Roman SF 23833 XM (lose their normal functions) 141 W( during terminal connection and also during file)142 W 8280 59054 MT (transfer when the controlling tty line is being used for packet i/o.)SH 8280 61446 MT (If you are running C-Kermit in "quiet mode" in the foreground, then interrupting the) 199 W( program with a console)198 W 8280 62642 MT (interrupt like Control-C will not restore the terminal to normal conversational operation. This is) 21 W( because the system)22 W 8280 63838 MT (call to enable console interrupt traps will cause the program to block if it's running in) 145 W( the background, and the)144 W 8280 65034 MT (primary reason for quiet mode is to allow the program to run in the background without blocking,) 9 W( so that you can do)10 W 8280 66230 MT (other work in the foreground.)SH 8280 68622 MT (If C-Kermit is) 144 W( run in the background \050"&" on shell commmand line\051, then the interrupt signal \050Control-C\051 \050and)143 W 8280 69818 MT (System III/V quit) 206 W( signal\051 are ignored. This prevents an interrupt signal intended for a foreground job \050say a)207 W 8280 71014 MT (compilation\051 from being trapped by a background Kermit session.)SH ES %%Page: 154 155 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 154)SH 12 /Times-Bold AF 31387 XM (Kermit User Guide: UNIX KERMIT \0506.7\051)SH 46800 50 6120 5709 UL 14 SS 6120 8138 MT (6.7. C-Kermit on the DEC Pro-3xx with Pro/Venix Version 1)SH 10 /Times-Roman AF 6120 10256 MT (The DEC Professional 300 series are) 254 W( PDP-11/23 based personal computers. Venix Version 1 is a Unix v7)253 W 6120 11452 MT (derivative. It) 472 W( should not be confused with Venix Version 2, which is based on ATT System V; these) 111 W( comments)112 W 6120 12648 MT (apply to Venix) 87 W( Version 1 only. C-Kermit runs in local mode on the Pro-3)86 W /Times-Italic SF (xx)SH /Times-Roman SF 38131 XM (when invoked from the console; the)86 W 6120 13844 MT (default device is)1 W /Courier SF 12927 XM (/dev/com1.dout)SH /Times-Roman SF (. When) 252 W( connected to a remote) 1 W( system \050using C-Kermit's 'connect' command\051,)2 W 6120 15040 MT (Pro/Venix itself \050not Kermit\051 provides VT52) 158 W( terminal emulation. Terminal operation at high speeds \050like 9600)157 W 6120 16236 MT (baud\051 requires xon/xoff flow) 53 W( control, which unfortunately interferes with applications such as the EMACS that use)54 W 6120 17432 MT (Control-Q and Control-S as commands.)SH 6120 19824 MT (When logging in to a Pro-3xx \050or any workstation\051 through the "back port", it may be necessary to give the)210 W 6120 21020 MT (command "set line /dev/tty") 43 W( in order to get C-Kermit to function correctly in remote mode \050on a system in which it)44 W 6120 22216 MT (normally expects to be operating in local mode\051.)SH 14 /Times-Bold AF 6120 25818 MT (6.8. C-Kermit under VAX/VMS)SH 10 /Times-Roman AF 6120 27936 MT (C-Kermit can be built using VAX-11 C to run under VMS. Most of the descriptions in this manual hold) 29 W( true, but it)28 W 6120 29132 MT (should be noted that as of this writing) 63 W( the VMS support is not thoroughly tested, and no explicit support exists for)64 W 6120 30328 MT (the various types of VMS files and their attributes.)SH 6120 32720 MT (The C-Kermit init file for VMS is called)SH /Courier SF 22563 XM (KERMIT.INI)SH /Times-Roman SF (.)SH 14 /Times-Bold AF 6120 36322 MT (6.9. C-Kermit on the Macintosh and other Systems)SH 10 /Times-Roman AF 6120 38440 MT (The "protocol kernel") 42 W( of C-Kermit is also used by Columbia's Macintosh Kermit. The user and system interface is)41 W 6120 39636 MT (entirely different, and is covered in a separate document.)SH 6120 42028 MT (There is also a Kermit for the Commodore Amiga based on) 174 W( C-Kermit, as well as versions for MS-DOS, Data)175 W 6120 43224 MT (General operating systems, etc.)SH 14 /Times-Bold AF 6120 46826 MT (6.10. C-Kermit Restrictions and Known Bugs)SH 10 /Times-Roman AF 8120 48944 MT (1.)SH 9120 XM (Editing characters:) 235 W( The) 719 W( program's interactive command interrupt, delete, and kill characters are)234 W 7483 50 9120 49144 UL 9120 50049 MT (Control-C, Delete \050or Backspace\051, and Control-U,) 77 W( respectively. There is currently no way to change)78 W 9120 51154 MT (them to suit your taste or match those used by your shell, in case those are different.)SH 8120 53364 MT (2.)SH 9120 XM (Flow control: C-Kermit attempts to use XON/XOFF flow control during protocol operations,) 103 W( but it)102 W 5242 50 9120 53564 UL 9120 54469 MT (also puts the communication) 36 W( line into "rawmode". On many systems, rawmode disables flow control,)37 W 9120 55574 MT (so even though you may have "set flow) 16 W( xon/xoff", no flow control will be done. This is highly system)15 W 9120 56679 MT (and Unix-version dependent.)SH 8120 58889 MT (3.)SH 9120 XM (High baud rates: There's) 98 W( no way to specify baud rates higher than 9600 baud. Most Unix systems)99 W 6528 50 9120 59089 UL 9120 59994 MT (don't supply symbols for them \050unless you use EXTA, EXTB\051, and even when they do,) 73 W( the program)72 W 9120 61099 MT (has no way of knowing whether a specific port's serial i/o controller supports those rates.)SH 8120 63309 MT (4.)SH 9120 XM (Modem controls: If a connection is made) 88 W( over a communication line \050rather than on the controlling)89 W 6671 50 9120 63509 UL 9120 64414 MT (terminal line\051, and that) 245 W( line has modem controls, \050e.g. data terminal ready and carrier detection)244 W 9120 65519 MT (implementation\051, returning to the shell level will disconnect the conversation. In that case, one should)24 W 9120 66624 MT (use interactive mode commands, and avoid use of piped shell-level operation \050also) 387 W( see 'set)386 W 9120 67729 MT (modem-dialer' and 'dial' commands.\051)SH 8120 69939 MT (5.)SH 9120 XM (Login Scripts:) 204 W( The) 659 W( present login scripts implementation follows the Unix conventions of uucp's)205 W 5621 50 9120 70139 UL 9120 71044 MT (")SH /Courier SF (L.sys)SH /Times-Roman SF (" file, rather than the normal Kermit "INPUT/OUTPUT" style.)SH ES %%Page: 155 156 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (6.10. C-Kermit Restrictions and Known Bugs)SH 10 /Times-Italic AF 51275 XM (Page 155)SH 46800 50 8280 5709 UL /Times-Roman SF 10280 7886 MT (6.)SH 11280 XM (Dial-out vs dial-in communications lines: C-Kermit requires a dial-out or dedicated line for) 84 W( the "set)83 W 16669 50 11280 8086 UL 11280 8991 MT (line" or "-l" options. Most systems have some lines dedicated to dial-in, which) 51 W( they enable "loggers")52 W 11280 10096 MT (on, and some lines) 338 W( available for dial-out. Recent releases of Unix \050ATT & Berkeley\051 have)337 W 11280 11201 MT (mechanisms for changing the directionality of a line.)SH 10280 13411 MT (7.)SH 11280 XM (Using C-Kermit) 114 W( on Local Area Networks: C-Kermit can successfully operate at speeds up to 9600)115 W 17154 50 11280 13611 UL 11280 14516 MT (baud over LANs, provided the network buffers are big enough to accommodate Kermit packets.)SH 11280 16726 MT (When computers are connected to LAN's through) 377 W( asynchronous terminal interfaces, then the)376 W 11280 17831 MT (connection should be configured to do XON/XOFF flow control between the network interface) 2 W( and the)3 W 11280 18936 MT (computer, rather than passing these signals through transparently. This can) 46 W( help prevent Kermit from)45 W 11280 20041 MT (overrunning the LAN's buffers if they are small \050or if the LAN is congested\051,) 3 W( and will can also prevent)4 W 11280 21146 MT (the LAN from overrunning a slow Kermit's buffers.)SH 11280 23356 MT (If the network hardware cannot accept 100 characters at a time, and flow control cannot be done)174 W 11280 24461 MT (between the network and the computer,) 66 W( then Kermit's "set send/receive packet-length" command can)67 W 11280 25566 MT (be used to shorten the packets.)SH 10280 27776 MT (8.)SH 11280 XM (Resetting terminal after abnormal termination or kill: When C-Kermit) 42 W( terminates abnormally \050say, for)41 W 21250 50 11280 27976 UL 11280 28881 MT (example, by a kill command issued by the operator\051 the user may need to reset) 70 W( the terminal state. If)71 W 11280 29986 MT (commands do not seem to be accepted at) 130 W( the shell prompt, try Control-J "stty sane" Control-J \050use)129 W 11280 31091 MT ("reset" on Berkeley Unix\051. That should take the terminal out of "raw mode" if it was stuck there.)SH 10280 33301 MT (9.)SH 11280 XM (Remote host commands may) 260 W( time-out on lengthy activity: Using "remote host" to instruct the)261 W 24796 50 11280 33501 UL 11280 34406 MT (C-Kermit server to invoke Unix functions \050like "make"\051) 38 W( that might take a long time to produce output)37 W 11280 35511 MT (can cause timeout conditions.)SH 9780 37721 MT (10.)SH 11280 XM (XOFF deadlocks: When connecting back to C-Kermit after a transaction, or after finishing) 26 W( the server,)27 W 6831 50 11280 37921 UL 11280 38826 MT (it may be necessary to type a Control-Q to) 8 W( clear up an XOFF deadlock. There's not much the program)7 W 11280 39931 MT (can do about this...)SH 14 /Times-Bold AF 8280 43533 MT (6.11. How to Build C-Kermit for a Unix System)SH 10 /Times-Roman AF 8280 45651 MT (The C-Kermit files, as distributed from Columbia, all begin with the prefix "ck". You should make a directory for)55 W 8280 46847 MT (these files and) 42 W( then cd to it. A makefile is provided to build C-Kermit for various Unix systems \050there are separate)41 W 8280 48043 MT (makefiles for VMS and the) 77 W( Macintosh\051. As distributed, the makefile has the name ")78 W /Courier SF (ckuker.mak)SH /Times-Roman SF (". You) 406 W( should)78 W 8280 49239 MT (rename it to ")38 W /Courier SF (makefile)SH /Times-Roman SF (" and then type "make xxx", where xxx is the symbol) 38 W( for your system, for instance "make)37 W 8280 50435 MT (bsd" to make C-Kermit for 4.x BSD Unix. The result will be a program called "wermit". You should test) 78 W( this to)79 W 8280 51631 MT (make sure it works; if it does, then you can rename) 28 W( it to "kermit" and install it for general use. See the makefile for)27 W 8280 52827 MT (a list of the systems supported and the corresponding "make" arguments.)SH 14 /Times-Bold AF 8280 56429 MT (6.12. Adapting C-Kermit to Other Systems)SH 10 /Times-Roman AF 8280 58547 MT (C-Kermit is designed for portability. The level of) 22 W( portability is indicated in parentheses after the module name: "C")23 W 8280 59743 MT (means any system that has a C compiler that conforms to) 114 W( the description in "The C Programming Language" by)113 W 8280 60939 MT (Kernighan & Ritchie \050Prentice-Hall, 1978\051. "Cf" is like "C", but also requires "standard" features like printf) 106 W( and)107 W 8280 62135 MT (fprintf, argument passing via argv/argc, and so on, as described in Kernighan) 40 W( & Ritchie. "Unix" means the module)39 W 8280 63331 MT (should be useful under any Unix implementation; it) 18 W( requires features such as fork\050\051 and pipes. Anything else means)19 W 8280 64527 MT (that the module is particular to the indicated system. C-Kermit file names are of the form:)SH /Courier SF 8280 66919 MT (ck<)SH /Times-Italic SF (system)SH /Courier SF (><)SH /Times-Italic SF (what)SH /Courier SF (>.<)SH /Times-Italic SF (type)SH /Courier SF (>)SH /Times-Roman SF 8280 69311 MT (where the part before the dot is no more) 13 W( than 6 characters long, the part after the dot no more than 3 characters long,)12 W 8280 70507 MT (and:)SH ES %%Page: 156 157 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 156)SH 12 /Times-Bold AF 30787 XM (Kermit User Guide: UNIX KERMIT \0506.12\051)SH 46800 50 6120 5709 UL 10 /Courier AF 6120 7886 MT (<)SH /Times-Italic SF (type)SH /Courier SF (>)SH /Times-Roman SF 9236 XM (is the file type:)SH 7120 9677 MT (c:)SH 10120 XM (C language source)SH 7120 10782 MT (h:)SH 10120 XM (Header file for C language source)SH 7120 11887 MT (w:)SH 10120 XM (Wart preprocessor source, converted by Wart \050or Lex\051 to a C program)SH 7120 12992 MT (nr:)SH 10120 XM (Nroff/Troff text formatter source)SH 7120 14097 MT (mss:)SH 10120 XM (Scribe text formatter source)SH 7120 15202 MT (doc:)SH 10120 XM (Documentation)SH 7120 16307 MT (hlp:)SH 10120 XM (Help text)SH 7120 17412 MT (bld:)SH 10120 XM (Instructions for building the program)SH 7120 18517 MT (bwr:)SH 10120 XM (A "beware" file - list of known bugs)SH 7120 19622 MT (upd:)SH 10120 XM (Program update log)SH 7120 20727 MT (mak:)SH 10120 XM (Makefile)SH /Courier SF 6120 23119 MT (<)SH /Times-Italic SF (system)SH /Courier SF (>)SH /Times-Roman SF 10236 XM (is a single character to tell what system the file applies to:)SH 7120 24910 MT (a:)SH 10120 XM (Descriptive material, documentation)SH 7120 26015 MT (c:)SH 10120 XM (All systems with C compilers)SH 7120 27120 MT (d:)SH 10120 XM (Data General)SH 7120 28225 MT (h:)SH 10120 XM (Harris computers \050reserved\051)SH 7120 29330 MT (i:)SH 10120 XM (Commodore Amiga \050Intuition\051)SH 7120 30435 MT (m:)SH 10120 XM (Macintosh)SH 7120 31540 MT (p:)SH 10120 XM (IBM PC, PC-DOS \050reserved\051)SH 7120 32645 MT (u:)SH 10120 XM (Unix)SH 7120 33750 MT (v:)SH 10120 XM (VAX/VMS)SH 7120 34855 MT (w:)SH 10120 XM (Wart)SH /Courier SF 6120 37247 MT (<)SH /Times-Italic SF (what)SH /Courier SF (>)SH /Times-Roman SF 9515 XM (is mnemonic \050up to 3 characters\051 for what's in the file:)SH 7120 39038 MT (aaa:)SH 10120 XM (A "read-me" file, like this one)SH 7120 40143 MT (cmd:)SH 10120 XM (Command parsing)SH 7120 41248 MT (con:)SH 10120 XM (Connect command)SH 7120 42353 MT (deb:)SH 10120 XM (Debug/Transaction Log formats, Typedefs)SH 7120 43458 MT (dia:)SH 10120 XM (Modem/Dialer control)SH 7120 44563 MT (fio:)SH 10120 XM (System-depdendent File I/O)SH 7120 45668 MT (fns:)SH 10120 XM (Protocol support functions)SH 7120 46773 MT (fn2:)SH 10120 XM (More protocol support functions)SH 7120 47878 MT (ker:)SH 10120 XM (General C-Kermit definitions, information, documentation)SH 7120 48983 MT (mai:)SH 10120 XM (Main program)SH 7120 50088 MT (pro:)SH 10120 XM (Protocol)SH 7120 51193 MT (scr:)SH 10120 XM (Script command)SH 7120 52298 MT (tio:)SH 10120 XM (System-dependent terminal i/o & control and interrupt handing)SH 7120 53403 MT (usr:)SH 10120 XM (User interface)SH 7120 54508 MT (us2:)SH 10120 XM (More user interface)SH 7120 55613 MT (us3:)SH 10120 XM (Still more user interface)SH 6120 58005 MT (Examples:)SH /Courier SF 6120 59796 MT (ckufio.c)SH /Times-Roman SF 14120 XM (File i/o for Unix)SH /Courier SF 6120 60901 MT (ckmtio.c)SH /Times-Roman SF 14120 XM (Terminal i/o for Macintosh)SH /Courier SF 6120 62006 MT (ckuker.mss)SH /Times-Roman SF 14120 XM (Scribe source for for Kermit User Guide chapter)SH /Courier SF 6120 63111 MT (ckuker.nr)SH /Times-Roman SF 14120 XM (Nroff source file for Unix C-Kermit man page)SH 6120 65503 MT (The following material discusses each of the C-Kermit modules briefly.)SH /Courier SF 6120 67294 MT (ckcmai.c, ckcker.h, ckcdeb.h \050Cf\051)SH /Times-Roman SF (:)SH 8120 68399 MT (This is the main program. It contains declarations for global variables and) 34 W( a small amount of code to initialize)33 W 8120 69504 MT (some variables and invoke the command parser. In its distributed form, it assumes) 248 W( that command line)249 W 8120 70609 MT (arguments are passed to) 40 W( it via argc and argv. Since this portion of code is only several lines long, it should be)39 W 8120 71714 MT (easy to replace for systems that have different styles of user interaction. The header files define symbols) 65 W( and)66 W ES %%Page: 157 158 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (6.12. Adapting C-Kermit to Other Systems)SH 10 /Times-Italic AF 51275 XM (Page 157)SH 46800 50 8280 5709 UL /Times-Roman SF 10280 7886 MT (macros used by the various modules of C-Kermit.)16 W /Courier SF 30866 XM (ckcdeb.h)SH /Times-Roman SF 35932 XM (is the only header file that is included by all the)15 W 10280 8991 MT (C-Kermit modules, so it contains not only the debug format definitions, but) 200 W( also any compiler-dependent)201 W 10280 10096 MT (typedefs.)SH /Courier SF 8280 11673 MT (ckwart.c \050Cf\051, ckcpro.w \050C\051)SH /Times-Roman SF (:)SH 10280 12778 MT (The ckcpro module embodies the Kermit protocol state table and the code) 49 W( to accomplish state switching. It is)50 W 10280 13883 MT (written in "wart", a language which may be regarded as a subset) 69 W( of the Unix "lex" lexical analyzer generator.)68 W 10280 14988 MT (Wart implements enough of lex to allow the ckprot module to function.) 69 W( Lex) 389 W( itself was not used because it is)70 W 10280 16093 MT (proprietary. The) 736 W( protocol module)243 W /Courier SF 25326 XM (ckcpro.w)SH /Times-Roman SF 30619 XM (is read by wart, and a system-independent C program is)243 W 10280 17198 MT (produced. The) 250 W( syntax of a Wart program is illustrated by)SH /Courier SF 33498 XM (ckcpro.w)SH /Times-Roman SF (, and is described in)SH /Courier SF 46519 XM (ckwart.doc)SH /Times-Roman SF (.)SH /Courier SF 8280 18775 MT (ckcfns.c \050C\051)SH /Times-Roman SF (:)SH 10280 19880 MT (The module contains all the Kermit protocol support functions) 56 W( -- packet formation, encoding, decoding, block)55 W 10280 20985 MT (check calculation, filename and data) 179 W( conversion, protocol parameter negotiation, and high-level interaction)180 W 10280 22090 MT (with the communication line and file system. To accommodate small systems, this module) 49 W( has been split into)48 W 10280 23195 MT (two --)SH /Courier SF 12946 XM (ckcfns.c)SH /Times-Roman SF 17996 XM (and)SH /Courier SF 19690 XM (ckcfn2.c)SH /Times-Roman SF (.)SH /Courier SF 8280 24772 MT (ckutio.c)SH /Times-Roman SF (:)SH 10280 25877 MT (This module contains the system-dependent primitives for communication line i/o, timers, and) 6 W( interrupts for the)5 W 10280 26982 MT (various versions of Unix. Certain important variables are defined in this module, which determine whether)126 W 10280 28087 MT (C-Kermit is by default remote or local,) 8 W( what the default communication device is, and so forth. The tio module)7 W 10280 29192 MT (maintains its own private database of file descriptors) 78 W( and modes for the console terminal and the file transfer)79 W 10280 30297 MT (communication line so that other modules \050like ckcfns or the terminal connect module\051 need not be concerned)47 W 10280 31402 MT (with them. The variations among) 227 W( Unix implementations with respect to terminal control and timers are)228 W 10280 32507 MT (accommodated via conditional compilation.)SH /Courier SF 8280 34084 MT (ckufio.c)SH /Times-Roman SF (:)SH 10280 35189 MT (This module contains system-dependent primitives for file i/o, wildcard) 266 W( \050meta character\051 expansion, file)267 W 10280 36294 MT (existence and access checking, and system command execution) 58 W( for the various versions of Unix. It maintains)57 W 10280 37399 MT (an internal database of i/o "channels" \050file pointers) 56 W( in this case\051 for the files C-Kermit cares about -- the input)57 W 10280 38504 MT (file \050the file which is being sent\051, the output file \050the file being received\051, the various logs, the screen, and) 71 W( so)70 W 10280 39609 MT (forth. This) 586 W( module varies little among Unix implementations) 168 W( except for the wildcard expansion code; the)169 W 10280 40714 MT (directory structure of 4.2bsd Unix is different from that of other Unix systems. Again, variation among Unix)67 W 10280 41819 MT (systems is selected using conditional compilation.)SH /Courier SF 8280 43396 MT (ckuusr.h, ckuusr.c, ckuus2.c, ckuus3.c)SH /Times-Roman SF 31330 XM (\050Unix\051:)SH 10280 44501 MT (This is the "user interface" for C-Kermit. It includes the command parser,) 124 W( the screen output functions, and)123 W 10280 45606 MT (console input functions. The command parser comes in) 187 W( two pieces -- the traditional Unix command line)188 W 10280 46711 MT (decoder \050which is quite small and compact\051, and the interactive keyword parser \050which is rather large\051. This)82 W 10280 47816 MT (module is fully replacable; its interface to the other modules is very simple,) 4 W( and is explained at the beginning of)5 W 10280 48921 MT (the source file. The ckuusr module also includes code to execute) 61 W( any commands directly which don't require)60 W 10280 50026 MT (the Kermit protocol -- local file management, etc. The module is rated "Unix" because it makes) 18 W( occasional use)19 W 10280 51131 MT (of the)SH /Courier SF 12835 XM (system\050\051)SH /Times-Roman SF 17885 XM (function.)SH 10280 52708 MT (Note that while)1 W /Courier SF 16699 XM (ckuusr)SH /Times-Roman SF 20550 XM (is logically one module, it has been) 1 W( split up into three C source files, plus a header file)SH 10280 53813 MT (for the symbols) 19 W( they share in common. This is to accommodate small systems that cannot handle big modules.)20 W /Courier SF 10280 54918 MT (ckuusr.c)SH /Times-Roman SF 15622 XM (has the command line and top-level) 292 W( interactive command parser;)291 W /Courier SF 44380 XM (ckuus2.c)SH /Times-Roman SF 49721 XM (has the help)291 W 10280 56023 MT (command and strings;)274 W /Courier SF 20185 XM (ckuus3)SH /Times-Roman SF 24309 XM (has the set and remote commands along with the logging, screen, and)275 W 10280 57128 MT ("interrupt" functions.)SH /Courier SF 8280 58705 MT (ckucmd.c, ckucmd.h)SH /Times-Roman SF 19330 XM (\050Cf\051:)SH 10280 59810 MT (This is an) 76 W( interactive command parsing package developed for C-Kermit. It is written portably enough to be)77 W 10280 60915 MT (usable on any system that has a C compiler that supports functions like printf. The) 25 W( file name parsing functions)24 W 10280 62020 MT (depend upon) 66 W( primitives defined in the fio module; if these primitives cannot be supplied for a certain system,)67 W 10280 63125 MT (then the filename parsing functions can be deleted, and the package) 79 W( will still be useful for parsing keywords,)78 W 10280 64230 MT (numbers, arbitrary text strings, and so forth. The style of interaction is the same as) 241 W( that found on the)242 W 10280 65335 MT (DECSYSTEM-20.)SH /Courier SF 8280 66912 MT (ckucon.c)SH /Times-Roman SF 13330 XM (\050Unix\051:)SH 10280 68017 MT (This is the connect module. As supplied, it should operate in any Unix) 266 W( environment, or any C-based)267 W 10280 69122 MT (environment that provides the fork\050\051 function. The module requires access to global variables that) 35 W( specify line)34 W 10280 70227 MT (speed, parity, duplex, flow control, etc, and invokes functions from the tio module) 90 W( to accomplish the desired)91 W 10280 71332 MT (settings and input/output, and) 282 W( functions from the fio module to perform session logging. No terminal)281 W ES %%Page: 158 159 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 158)SH 12 /Times-Bold AF 30787 XM (Kermit User Guide: UNIX KERMIT \0506.12\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 8120 7886 MT (emulation is performed, but since standard i/o is) 112 W( used for the console, this may be piped through a terminal)113 W 8120 8991 MT (emulation filter.) 1 W( The) 250 W( ckucon function may be entirely replaced, so long as the global settings are honored by its)SH 8120 10096 MT (replacement. PC) 472 W( implementations of C-Kermit may require the ck?con module to) 111 W( do screen control, escape)112 W 8120 11201 MT (sequence interpretation, etc, and may also wish to write special code to get the best possible performance.)SH /Courier SF 6120 12778 MT (ckudia.c)SH /Times-Roman SF 11170 XM (\050Unix\051:)SH 8120 13883 MT (This is the dialer module. As supplied, it handles Hayes, Ventel, Penril, Racal-Vadic, and) 210 W( several other)211 W 8120 14988 MT (modems.)SH /Courier SF 6120 16565 MT (ckuscr.c)SH /Times-Roman SF 11170 XM (\050Unix\051:)SH 8120 17670 MT (This is the login script module. As supplied, it handles uucp-style scripts.)SH 6120 20062 MT (Moving C-Kermit to a new system entails:)SH 8120 21853 MT (1.)SH 9120 XM (Creating a new)15 W /Courier SF 15469 XM (ck?tio)SH /Times-Roman SF 19334 XM (module in C,) 15 W( assembler, or whatever language is most appropriate for system)16 W 9120 22958 MT (programming on the new) 102 W( system. If the system is Unix-like, then support may be added within the)101 W /Courier SF 9120 24063 MT (ckutio.c)SH /Times-Roman SF 14170 XM (module itself using conditional compilation.)SH 8120 26273 MT (2.)SH 9120 XM (Creating a new)SH /Courier SF 15424 XM (ck?fio)SH /Times-Roman SF 19274 XM (module, as above.)SH 8120 28483 MT (3.)SH 9120 XM (If the system is not Unix-like, then a new)119 W /Courier SF 26967 XM (ckuusr)SH /Times-Roman SF 30937 XM (module may be required, as well as a different)120 W 9120 29588 MT (invocation of it from)SH /Courier SF 17675 XM (ckcmai)SH /Times-Roman SF (.)SH 8120 31798 MT (4.)SH 9120 XM (If the distributed connect module doesn't work or performs poorly, then it may be replaced.) 172 W( For)593 W 9120 32903 MT (instance, interrupt-driven i/o may be required, especially if the system doesn't have forks.)SH 6120 34694 MT (Those who favor a different style of) 118 W( user/program interaction from that provided in)119 W /Courier SF 41182 XM (ckuusr.c)SH /Times-Roman SF 46351 XM (may replace the)119 W 6120 35890 MT (entire module, for instance with one that) 313 W( provides a mouse/window/icon environment, a menu/function-key)312 W 6120 37086 MT (environment, etc.)SH 6120 39478 MT (A few guidelines should be followed to maintain portability:)SH /Symbol SF 7910 41383 MT (\267)SH /Times-Roman SF 8620 XM (Keep variable and function names to 6 characters or less.) 90 W( Don't) 432 W( use identifiers that are distinguished)91 W 8620 42488 MT (from one another only by alphabetic case.)SH /Symbol SF 7910 44477 MT (\267)SH /Times-Roman SF 8620 XM (Keep modules small.) 166 W( For) 581 W( instance, on a PDP-11 it is necessary to keep the code segment of each)165 W 8620 45582 MT (module below 8K in order to allow the segment mapping to occur which is necessary to) 62 W( run programs)63 W 8620 46687 MT (larger than 64K on a non-I-and-D-space machine.)SH /Symbol SF 7910 48676 MT (\267)SH /Times-Roman SF 8620 XM (Keep strings) 116 W( short; many compilers have restrictive maximum lengths; 128 is the smallest maximum)115 W 8620 49781 MT (string constant length we've encountered so far.)SH /Symbol SF 7910 51770 MT (\267)SH /Times-Roman SF 8620 XM (Keep \050f,s\051printf formats) 43 W( short. If these exceed some compiler dependent maximum \050say, 128\051 memory)44 W 8620 52875 MT (will be overwritten and the program will probably core dump.)SH /Symbol SF 7910 54864 MT (\267)SH /Times-Roman SF 8620 XM (Do not introduce system dependencies into)SH /Courier SF 26118 XM (ckcpro.w)SH /Times-Roman SF 31168 XM (or)SH /Courier SF 32251 XM (ckcfn*.c)SH /Times-Roman SF (.)SH /Symbol SF 7910 56853 MT (\267)SH /Times-Roman SF 8620 XM (If a variable is a character,) 112 W( declare as CHAR, not int, to prevent the various sign extension and byte)111 W 8620 57958 MT (swapping foulups that occur when characters are placed in integer variables.)SH /Symbol SF 7910 59947 MT (\267)SH /Times-Roman SF 8620 XM (Remember that different systems may use different length words for different things. Don't assume an)39 W 8620 61052 MT (integer can be used as a pointer, etc.)SH /Symbol SF 7910 63041 MT (\267)SH /Times-Roman SF 8620 XM (Don't declare static functions; these can wreak havoc with systems that do segment mapping.)SH /Symbol SF 7910 65030 MT (\267)SH /Times-Roman SF 8620 XM (In conditional compilations expressions,) 262 W( use)261 W /Courier SF 27927 XM (#ifdef)SH /Times-Roman SF 32038 XM (and)SH /Courier SF 33993 XM (#ifndef)SH /Times-Roman SF 38704 XM (and not)261 W /Courier SF 42448 XM (#if)SH /Times-Roman SF (, which is not)261 W 8620 66135 MT (supported by) 36 W( some compilers. Also, don't use any operators in these expressions; many compilers will)37 W 8620 67240 MT (fail to understand expressions like)18 W /Courier SF 22625 XM (#ifdef FOO | BAR)18 W /Times-Roman SF (. Also,) 286 W( don't put trailing) 18 W( tokens on)17 W /Courier SF 46698 XM (#else)SH /Times-Roman SF ('s)SH 8620 68345 MT (or)SH /Courier SF 9703 XM (#endif)SH /Times-Roman SF ('s \050use)SH /Courier SF 16191 XM (/*)SH /Times-Roman SF 17641 XM (comments)SH /Courier SF 22002 XM (*/)SH /Times-Roman SF (\051.)SH /Symbol SF 7910 70334 MT (\267)SH /Times-Roman SF 8620 XM (Don't define multiline macros.)SH ES %%Page: 159 160 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (6.12. Adapting C-Kermit to Other Systems)SH 10 /Times-Italic AF 51275 XM (Page 159)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (In general, remember that this program will have to be compilable by old compilers and runnable on small systems.)SH ES %%Page: 160 161 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 160)SH 12 /Times-Bold AF 32287 XM (Kermit User Guide: UNIX KERMIT \0507\051)SH 46800 50 6120 5709 UL ES %%Page: 161 162 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (7. MACINTOSH KERMIT)SH 10 /Times-Italic AF 51275 XM (Page 161)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 8280 8272 MT (7. MACINTOSH KERMIT)SH 10 /Times-Italic AF 8280 10566 MT (Program:)SH /Times-Roman SF 16280 XM (Bill Catchings, Bill Schilit, Frank da Cruz \050Columbia University\051,)SH 16280 11671 MT (Davide Cervone \050University of Rochester\051,)SH 16280 12776 MT (Matthias Aebi \050ECOFIN Research and Consulting, Ltd., Zuerich\051,)SH 16280 13881 MT (Paul Placeway \050Ohio State University\051.)SH /Times-Italic SF 8280 14986 MT (Language:)SH /Times-Roman SF 16280 XM (C \050MPW\051)SH /Times-Italic SF 8280 16091 MT (Documentation:)SH /Times-Roman SF 16280 XM (Christine Gianone, Frank da Cruz, Paul Placeway)SH /Times-Italic SF 8280 17196 MT (Version:)SH /Courier SF 16280 XM (0.9\05040\051)SH /Times-Italic SF 8280 18301 MT (Date:)SH /Times-Roman SF 16280 XM (May 26, 1988)SH 12 /Times-Bold AF 8280 20889 MT (MacKermit Capabilities At A Glance:)SH 10 /Times-Roman AF 9280 22680 MT (Local operation:)SH 34480 XM (Yes)SH 9280 23785 MT (Remote operation:)SH 34480 XM (Yes \050server mode only\051)SH 9280 24890 MT (Login scripts:)SH 34480 XM (No)SH 9280 25995 MT (Transfer text files:)SH 34480 XM (Yes)SH 9280 27100 MT (Transfer binary files:)SH 34480 XM (Yes)SH 9280 28205 MT (MacBinary transfers:)SH 34480 XM (No)SH 9280 29310 MT (Wildcard send:)SH 34480 XM (Yes \050whole HFS folders\051)SH 9280 30415 MT (File transfer interruption:)SH 34480 XM (Yes)SH 9280 31520 MT (Filename collision avoidance:)SH 34480 XM (Yes)SH 9280 32625 MT (Can time out:)SH 34480 XM (Yes)SH 9280 33730 MT (8th-bit prefixing:)SH 34480 XM (Yes)SH 9280 34835 MT (Repeat count prefixing:)SH 34480 XM (Yes)SH 9280 35940 MT (Alternate block checks:)SH 34480 XM (Yes)SH 9280 37045 MT (Terminal emulation:)SH 34480 XM (Yes \050VT100,VT102\051)SH 9280 38150 MT (Communication settings:)SH 34480 XM (Yes \050Speed, Parity, Echo\051)SH 9280 39255 MT (XON/XOFF:)SH 34480 XM (Yes)SH 9280 40360 MT (Transmit BREAK:)SH 34480 XM (Yes)SH 9280 41465 MT (IBM mainframe communication:)SH 34480 XM (Yes)SH 9280 42570 MT (Transaction logging:)SH 34480 XM (Yes)SH 9280 43675 MT (Session logging:)SH 34480 XM (Yes)SH 9280 44780 MT (Debug logging:)SH 34480 XM (No)SH 9280 45885 MT (Packet logging:)SH 34480 XM (No)SH 9280 46990 MT (Act as server:)SH 34480 XM (Yes)SH 9280 48095 MT (Talk to server:)SH 34480 XM (Yes)SH 9280 49200 MT (Advanced server functions:)SH 34480 XM (Yes)SH 9280 50305 MT (Local file management:)SH 34480 XM (Yes)SH 9280 51410 MT (Command/Init files:)SH 34480 XM (No)SH 9280 52515 MT (Key redefinition/macros:)SH 34480 XM (Yes)SH 9280 53620 MT (File attributes packets:)SH 34480 XM (No)SH 9280 54725 MT (Command macros:)SH 34480 XM (No)SH 9280 55830 MT (Raw file transmit:)SH 34480 XM (No)SH 9280 56935 MT (Long packets:)SH 34480 XM (Yes)SH 9280 58040 MT (Sliding windows:)SH 34480 XM (No)SH 14 /Times-Bold AF 8280 61642 MT (7.1. Introduction)SH 10 /Times-Roman AF 8280 63760 MT (Macintosh Kermit, or "MacKermit", is an implementation of the) 260 W( Kermit file transfer protocol for the Apple)261 W 8280 64956 MT (Macintosh family of computers. It was developed at Columbia University, based) 16 W( on C-Kermit \050which also forms the)15 W 8280 66152 MT (nucleus of Unix Kermit and many other Kermit programs\051. Version) 49 W( 0.9 of MacKermit runs on the Macintosh 512,)50 W 8280 67348 MT (XL \050Apple Lisa running MacWorks\051, 512e, Plus, SE, and II, under) 141 W( the regular Finder and the Multifinder, with)140 W 8280 68544 MT (which it can transfer files in the background. MacKermit 0.9 probably does not run on a 128k \050original, classic\051)101 W 8280 69740 MT (Macintosh, due to lack of sufficient memory, but should run OK on a "fat) 68 W( Mac" \050a 128K Mac upgraded to 512K\051.)67 W 8280 70936 MT (Version 0.8 should be retained for 128K Macs.)SH ES %%Page: 162 163 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 162)SH 12 /Times-Bold AF 26919 XM (Kermit User Guide: MACINTOSH KERMIT \0507.1\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (This manual assumes you are acquainted with your Macintosh, and that you) 80 W( are familiar with the general ideas of)81 W 6120 9082 MT (data communication and Kermit file transfer. A very brief overview is given here,) 59 W( but for details consult the early)58 W 6120 10278 MT (chapters of) 160 W( the)161 W /Times-Italic SF 12739 XM (Kermit User Guide)161 W /Times-Roman SF 21138 XM (\050of which this document is a chapter\051, or the book Kermit, A File Transfer)161 W 9981 50 42939 10478 UL 6120 11474 MT (Protocol, by Frank da Cruz, Digital Press \0501987\051. For) 117 W( further information about Kermit documentation, updates,)116 W 3389 50 6120 11674 UL 6120 12670 MT (lists of current available versions, and ordering information, write to:)SH 8120 14461 MT (Kermit Distribution)SH 8120 15566 MT (Columbia University Center for Computing Activities)SH 8120 16671 MT (612 West 115th Street)SH 8120 17776 MT (New York, NY 10025 \050USA\051)SH 14 /Times-Bold AF 6120 21378 MT (7.2. Installation)SH 10 /Times-Roman AF 6120 23496 MT (Before you can use Macintosh Kermit or any other communication program on your Mac, you must) 54 W( have a way to)55 W 6120 24692 MT (connect it to the other computers you wish to communicate with. This means) 167 W( either a direct cable connection)166 W 6120 25888 MT (\050usually using a "null modem" cable\051, or a modem connected to your Mac and to a telephone. The Macintosh poses)19 W 6120 27084 MT (two special problems at this level.) 34 W( First,) 316 W( its connectors are not the standard 25-pin RS-232 style, but either 9-pin or)33 W 6120 28280 MT (8-pin special connectors which you need) 189 W( special adapters for. Second, the Macintosh does not supply a Data)190 W 6120 29476 MT (Terminal Ready \050DTR\051 signal, which is required by most modems before they will operate. To use) 10 W( your Mac with a)9 W 6120 30672 MT (modem that is not designed specifically for the) 30 W( Mac, you have to either \050a\051 configure the modem to ignore the DTR)31 W 6120 31868 MT (signal, or \050b\051 feed some other active signal) 127 W( into the modem's DTR input. The former is usually done with DIP)126 W 6120 33064 MT (switches on the modem, the latter can be done in the connector that plugs into the modem by) 97 W( installing a jumper)98 W 6120 34260 MT (wire between DTR \050pin 20\051 and DSR \050pin) 81 W( 6\051, or by connecting the Mac's +12V output \050pin 6 on the Mac's 9-pin)80 W 6120 35456 MT (connector\051 to DTR \050pin 20\051 on the modem end.)SH 6120 37848 MT (If you have received) 16 W( a Macintosh Kermit diskette from Columbia University, there's no special software installation)17 W 6120 39044 MT (procedure -- just insert the diskette,) 36 W( double-click on the appropriate start-up file, or on MacKermit itself, and go. If)35 W 6120 40240 MT (all the communication) 84 W( and other settings agree with your requirements, there's nothing else you need to do. This)85 W 6120 41436 MT (process is illustrated in the next section, just below.)SH 6120 43828 MT (MacKermit is not) 21 W( copy-protected, and nothing out of the ordinary is required to make copies onto other diskettes, or)20 W 6120 45024 MT (onto your hard disk if you have one. Just use the ordinary Macintosh methods of copying files, folders, etc.)SH 6120 47416 MT (Later, you may wish to create settings files tailored) 4 W( to your communication environment, and you might also want to)5 W 6120 48612 MT (customize the keyboard configuration. Use the various Settings options for this, and then select Save) 36 W( Settings from)35 W 6120 49808 MT (the File menu. Settings and settings files are explained in Sections 7.10 and 7.11.)SH 14 /Times-Bold AF 6120 53410 MT (7.3. Getting Started)SH 10 /Times-Roman AF 6120 55528 MT (Kermit programs perform two major functions, terminal emulation and) 224 W( file transfer. Before transferring files)225 W 6120 56724 MT (between two systems you must establish a) 84 W( terminal connection from your system to the other one, either direct or)83 W 6120 57920 MT (else dialed up using a modem.) 117 W( Then) 486 W( to transfer files, login to the remote system if necessary, start up a Kermit)118 W 6120 59116 MT (program there, and then tell the two Kermit programs which files to transfer, and in what direction.)SH 6120 61508 MT (Most Kermit programs present you with a prompt, in) 33 W( response to which you type a command, repeating the process)32 W 6120 62704 MT (until you exit from) 7 W( the program. If you want to establish a terminal connection to another system, you must give the)8 W 6120 63900 MT (CONNECT command. Unlike these programs, MacKermit is)44 W /Times-Italic SF 31469 XM (always)SH /Times-Roman SF 34541 XM (connected, and whatever) 44 W( keystrokes you type)43 W 6120 65096 MT (are sent to the other system. To give commands to MacKermit itself, you must use the mouse to) 50 W( pull down menus)51 W 6120 66292 MT (from the menu bar that overlays your terminal session, or type special Command-key equivalents.)SH 6120 68684 MT (The following example shows how to transfer a) 65 W( file with MacKermit. The remote computer is a Unix system, but)64 W 6120 69880 MT (the method is the same with most others.)SH /Symbol SF 7910 71785 MT (\267)SH /Times-Roman SF 8620 XM (First insert the MacKermit diskette. It) 135 W( should appear on the screen as a diskette icon titled)136 W /Times-Bold SF 47310 XM (Kermit)SH ES %%Page: 163 164 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (7.3. Getting Started)SH 10 /Times-Italic AF 51275 XM (Page 163)SH 46800 50 8280 5709 UL /Times-Bold SF 10780 7886 MT (0.9\05040\051)SH /Times-Roman SF (. Click) 250 W( on it twice to open if it did not open automatically when you inserted it in the drive.)SH /Symbol SF 10070 9875 MT (\267)SH /Times-Roman SF 10780 XM (Once the disk is opened, you will see three MacKermit icons across the top of) 24 W( the screen. For the Unix)23 W 10780 10980 MT (system and most others you can use the ")102 W /Times-Bold SF (Normal Settings)102 W /Times-Roman SF (" icon -- to) 102 W( start the Kermit program click)103 W 10780 12085 MT (twice on it. For linemode connections to IBM mainframes, you) 223 W( would click twice on the ")222 W /Times-Bold SF (IBM)SH 10780 13190 MT (Mainframe Linemode Settings)SH /Times-Roman SF (" icon.)SH /Symbol SF 10070 15179 MT (\267)SH /Times-Roman SF 10780 XM (You will see a white backround with menus stored under) 107 W( the headings)108 W /Times-Bold SF 40396 XM (File)SH /Times-Roman SF (,)SH /Times-Bold SF 42615 XM (Edit)SH /Times-Roman SF (,)SH /Times-Bold SF 45057 XM (Settings)SH /Times-Roman SF (,)SH /Times-Bold SF 49054 XM (Remote)SH /Times-Roman SF (,)SH 10780 16284 MT (and)SH /Times-Bold SF 12474 XM (Log)SH /Times-Roman SF (.)SH /Symbol SF 10070 18273 MT (\267)SH /Times-Roman SF 10780 XM (Move the mouse pointer to the)SH /Times-Bold SF 23279 XM (Settings)SH /Times-Roman SF 26918 XM (menu and select)SH /Times-Bold SF 33611 XM (Communications...)SH /Times-Roman SF 41889 XM (by clicking on it once.)SH /Symbol SF 10070 20262 MT (\267)SH /Times-Roman SF 10780 XM (MacKermit normally sets the communication speed to 9600 bits per second.) 15 W( Click) 279 W( on the circle in front)14 W 10780 21367 MT (of 1200 \050or whatever speed you need to match the baud rate of your modem) 116 W( and/or remote system\051.)117 W 10780 22472 MT (Check to see that the other) 46 W( communication settings like parity are as required, and make any necessary)45 W 10780 23577 MT (changes.)SH /Symbol SF 10070 25566 MT (\267)SH /Times-Roman SF 10780 XM (Click on the ")SH /Courier SF (OK)SH /Times-Roman SF (" box to accept the settings.)SH /Symbol SF 10070 27555 MT (\267)SH /Times-Roman SF 10780 XM (If you have a Hayes-like dialout modem, follow the next two steps:)SH 12780 29346 MT (1.)SH 13780 XM (Type AT \050uppercase\051 and then press the Enter key. The modem should respond with) 74 W( "OK" or)75 W 13780 30451 MT (the digit "0" \050zero\051. If it doesn't, check the cable, the modem, etc) 34 W( \050consult your modem manual)33 W 13780 31556 MT (for details\051.)SH 12780 33766 MT (2.)SH 13780 XM (Now type) 27 W( ATDT 7654321 followed by Enter \050replace 7654321 by the actual phone number\051. If)28 W 13780 34871 MT (the connection succeeds, you'll get a) 190 W( message like CONNECT \050or the digit "1"\051, otherwise)189 W 13780 35976 MT (you'll see an error message like NO CARRIER, ERROR, etc, or a digit like 3 or 4 \050see your)108 W 13780 37081 MT (modem manual\051.)SH 10780 38872 MT (For non-Hayes-compatible modems, follow the instructions in your modem) 308 W( manual. For direct)307 W 10780 39977 MT (connections, skip this step altogether.)SH 8280 41768 MT (Now you should be talking to the Unix system. Type a carriage return to get its attention, and it will issue) 36 W( its login)37 W 8280 42964 MT (prompt. In) 250 W( the examples below, underlining is used to show the parts that you would type.)SH /Courier SF 10680 44679 MT (Login: christin)SH /Times-Italic SF 28680 XM (Login to the host.)SH 4800 50 14880 44879 UL /Courier SF 10680 45710 MT (password:)SH /Times-Italic SF 28680 XM (\050Passwords normally don't echo.\051)SH 3600 50 16080 45910 UL /Courier SF 10680 47425 MT (% kermit)SH /Times-Italic SF 28680 XM (Run Kermit on the host.)SH 3600 50 11880 47625 UL /Courier SF 10680 49140 MT (C-Kermit>receive)SH /Times-Italic SF 28680 XM (Tell it to receive a file.)SH 4200 50 16080 49340 UL /Times-Roman SF 8280 51532 MT (Now tell MacKermit what file to send:)SH /Symbol SF 10070 53437 MT (\267)SH /Times-Roman SF 10780 XM (Use the mouse to point to the)42 W /Times-Bold SF 23046 XM (File)SH /Times-Roman SF 24949 XM (menu and select the)42 W /Times-Bold SF 33282 XM (Send File...)41 W /Times-Roman SF 38628 XM (option. You) 332 W( can either type in the)41 W 10780 54542 MT (name of the file) 80 W( \050if you know the name\051 or select the alternate drive to see what files are on the disk.)81 W 10780 55647 MT (Once you see the) 87 W( file you want to send, click on the filename and then click on the SEND option \050or)86 W 10780 56752 MT (you can just click twice on the filename\051.)SH /Symbol SF 10070 58741 MT (\267)SH /Times-Roman SF 10780 XM (A "File Transfer Status" box will appear to report the progress of the transer.)49 W /Times-Italic SF 42715 XM (NOTE:)SH /Times-Roman SF 45904 XM (If the number of)50 W 10780 59846 MT (retries is increasing but not the number of) 50 W( packets, you should check your)49 W /Times-Bold SF 41197 XM (Communications...)SH /Times-Roman SF 49524 XM (settings)SH 10780 60951 MT (under the)SH /Times-Bold SF 14779 XM (Settings)SH /Times-Roman SF 18418 XM (menu.)SH /Symbol SF 10070 62940 MT (\267)SH /Times-Roman SF 10780 XM (When the file transfer is) 69 W( completed, the "File Transfer Status" box should disappear and the C-Kermit)70 W 10780 64045 MT (prompt should reappear.)SH 8280 66437 MT (You have just transferred a file from the Macintosh to the Unix system. To) 27 W( transfer a file in the other direction, use)26 W 8280 67633 MT (the ")4 W /Courier SF (send)SH /Times-Italic SF 13168 XM (filename)SH /Times-Roman SF (" command on Unix instead of ")4 W /Courier SF (receive)SH /Times-Roman SF (", and click on ")4 W /Times-Bold SF (Receive File...)4 W /Times-Roman SF (" from) 258 W( the Mac's)5 W /Times-Bold SF 53469 XM (File)SH /Times-Roman SF 8280 68829 MT (menu, instead of ")SH /Times-Bold SF (Send File...)SH /Times-Roman SF (".)SH 8280 71221 MT (After the file is transferred, your) 256 W( terminal connection is automatically resumed. Once your Unix session is)255 W ES %%Page: 164 165 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 164)SH 12 /Times-Bold AF 26919 XM (Kermit User Guide: MACINTOSH KERMIT \0507.3\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (complete, you can log out, and then exit from MacKermit:)SH /Courier SF 8520 9541 MT (C-Kermit>exit)SH 2400 50 13920 9741 UL 8520 11256 MT (% ^D)SH /Times-Italic SF 26520 XM (Logout from Unix by typing Ctrl-D.)SH 1200 50 9720 11456 UL /Times-Roman SF 8120 13047 MT (1.)SH 9120 XM (Select the)SH /Times-Bold SF 13286 XM (Quit)SH /Times-Roman SF 15481 XM (option in the)SH /Times-Bold SF 20787 XM (File)SH /Times-Roman SF 22648 XM (menu by clicking on it.)SH 8120 14705 MT (2.)SH 9120 XM (Select the)121 W /Times-Bold SF 13528 XM (Close)SH /Times-Roman SF 16232 XM (option in) 121 W( the)122 W /Times-Bold SF 21903 XM (File)SH /Times-Roman SF 23886 XM (menu by clicking on it \050assuming you want to close the current)122 W 9120 15810 MT (folder\051.)SH 8120 17468 MT (3.)SH 9120 XM (Select the)85 W /Times-Bold SF 13456 XM (Eject)SH /Times-Roman SF 16012 XM (option in the)85 W /Times-Bold SF 21573 XM (File)SH /Times-Roman SF 23519 XM (menu by clicking on it \050assuming you ran) 85 W( Kermit from a diskette)84 W 9120 18573 MT (that you want to eject\051.)SH 6120 20364 MT (That's the easiest and quickest way to use Kermit.) 137 W( If) 526 W( this simple scenario does not work for you, look for any)138 W 6120 21560 MT (obvious incorrect settings \050speed, parity\051, fix them, and try again. Otherwise, read on.)SH 14 /Times-Bold AF 6120 25162 MT (7.4. The Macintosh File System)SH 10 /Times-Roman AF 6120 27280 MT (The Macintosh file system consists of one or more disks, each) 215 W( disk containing files. There are actually two)214 W 6120 28476 MT (Macintosh file systems, which work slightly differently.)SH 6120 30868 MT (Disks formatted for the) 95 W( older Macintosh File System \050MFS\051 are essentially "flat". All files on one of these disks)96 W 6120 32064 MT (must have a unique name. Files may be collected together into "folders", but folders are not) 7 W( analogous to directories)6 W 6120 33260 MT (on other file systems, and no two folders on the same disk may contain files of the same name; the folders) 10 W( exist only)11 W 6120 34456 MT (to make things look nicer in the Finder. All Macintoshes have support for MFS.)SH 6120 36848 MT (Disks formatted with the newer) 18 W( Hierarchical File System \050HFS\051 are not "flat"; each folder is a directory. There may)17 W 6120 38044 MT (not be more than one file with) 12 W( the same name in a single folder, but there may be identically named files in different)13 W 6120 39240 MT (folders.)SH 6120 41632 MT (Macintosh file names may contain practically any printable characters, including space and punctuation -- but colon)28 W 6120 42828 MT (\050``)SH /Courier SF (:)SH /Times-Roman SF (''\051 may not be used; it is used in device names and as the HFS path element separator.)SH 14 /Times-Bold AF 6120 46430 MT (7.5. Menus)SH 10 /Times-Roman AF 6120 48548 MT (The major menus) 133 W( are)134 W /Times-Bold SF 15374 XM (Apple)SH /Times-Roman SF (,)SH /Times-Bold SF 18564 XM (File)SH /Times-Roman SF (,)SH /Times-Bold SF 20809 XM (Edit)SH /Times-Roman SF (,)SH /Times-Bold SF 23277 XM (Settings)SH /Times-Roman SF (,)SH /Times-Bold SF 27300 XM (Remote)SH /Times-Roman SF (, and)134 W /Times-Bold SF 33038 XM (Log)SH /Times-Roman SF (. The)518 W /Times-Bold SF 37662 XM (Apple)SH /Times-Roman SF 40602 XM (menu gives some information)134 W 6120 49744 MT (about the program, including the MacKermit version number and the C-Kermit protocol mudule version number)127 W 6120 50940 MT (\050useful in reporting bugs\051. It also shows statistics about the most recent file transfer.)SH 6120 53332 MT (The)SH /Times-Bold SF 7957 XM (File)SH /Times-Roman SF 9850 XM (menu invokes Kermit's file transfer functions,)32 W /Times-Bold SF 28789 XM (Send)SH /Times-Roman SF (,)SH /Times-Bold SF 31433 XM (Get)SH /Times-Roman SF (, and)32 W /Times-Bold SF 35246 XM (Receive)SH /Times-Roman SF (. It) 314 W( also allows) 32 W( settings to be saved)33 W 6120 54528 MT (and restored, and like most Macintosh applications, includes a "quit" entry for leaving the program, and a) 30 W( "transfer")29 W 6120 55724 MT (entry for transferring to another program without going through the Finder.)SH 6120 58116 MT (The)SH /Times-Bold SF 8020 XM (Edit)SH /Times-Roman SF 10199 XM (menu provides support for Macintosh desk accessories that need to have this menu to do cut and) 95 W( paste.)96 W 6120 59312 MT (This menu does not currently do anything in MacKermit.)SH 6120 61704 MT (The)SH /Times-Bold SF 8025 XM (Settings)SH /Times-Roman SF 11764 XM (menu provides dialog boxes for file, communications, and protocol settings; these will) 100 W( be discussed)99 W 6120 62900 MT (below.)SH 6120 65292 MT (The)SH /Times-Bold SF 8036 XM (Remote)SH /Times-Roman SF 11673 XM (menu has the commands that can be sent to Kermit servers, as well as an) 111 W( option to turn Macintosh)112 W 6120 66488 MT (Kermit itself into a server \050also discussed below\051.)SH 6120 68880 MT (The)SH /Times-Bold SF 7998 XM (Log)SH /Times-Roman SF 9988 XM (menu contains commands to start and stop session and transaction logging. It also has an entry to dump)72 W 6120 70076 MT (the current screen image to the session log, which is only enabled when the session log is open.)SH ES %%Page: 165 166 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (7.6. Terminal Emulation)SH 10 /Times-Italic AF 51275 XM (Page 165)SH 46800 50 8280 5709 UL 14 /Times-Bold AF 8280 8138 MT (7.6. Terminal Emulation)SH 10 /Times-Roman AF 8280 10256 MT (Before you can transfer files, you have to establish a terminal connection with the other computer. You) 41 W( don't have)42 W 8280 11452 MT (to give MacKermit) 240 W( any special command to do this, just start the program. Assuming you have a physical)239 W 8280 12648 MT (connection, then the software will use it. If you think you have a physical connection, but) 104 W( don't see any results,)105 W 8280 13844 MT (click on the)73 W /Times-Bold SF 13415 XM (Settings)SH /Times-Roman SF 17127 XM (menu and) 73 W( select)72 W /Times-Bold SF 24037 XM (Communications)SH /Times-Roman SF 31637 XM (to make sure you have the right speed and parity. If you)72 W 8280 15040 MT (have to dial out to make the connection, you must do this yourself -- Mac Kermit won't do it) 7 W( for you. Depending on)8 W 8280 16236 MT (the type of modem, you must either type dialing commands to it directly \050like the Hayes) 101 W( ATDT command in the)100 W 8280 17432 MT (example in) 113 W( section 7.3\051, or else dial the phone manually, wait for an answer and a carrier tone, and then put the)114 W 8280 18628 MT (modem in data mode.)SH 8280 21020 MT (Once you've made the connection, you can) 49 W( use MacKermit's terminal emulator, which conforms to ANSI standard)48 W 8280 22216 MT (X3.64, providing a subset of the features of the DEC VT102 terminal \050a VT100 with) 73 W( line and character insert and)74 W 8280 23412 MT (delete functions added\051. The functions provided are sufficient to allow MacKermit) 158 W( to act as a terminal for the)157 W 8280 24608 MT (EMACS full-screen editor as it exists on most) 162 W( timesharing systems, and for most host-resident display-oriented)163 W 8280 25804 MT (applications that expect to do cursor positioning and) 104 W( editing on the VT100 or VT102 screen, such as VAX TPU.)103 W 8280 27000 MT (MacKermit does not currently support the following VT100/102 functions:)SH /Symbol SF 10070 28905 MT (\267)SH /Times-Roman SF 10780 XM (Double height or double width lines)SH /Symbol SF 10070 30010 MT (\267)SH /Times-Roman SF 10780 XM (Blinking)SH /Symbol SF 10070 31115 MT (\267)SH /Times-Roman SF 10780 XM (132 columns)SH /Symbol SF 10070 32220 MT (\267)SH /Times-Roman SF 10780 XM (DEC-style line wrapping)SH /Symbol SF 10070 33325 MT (\267)SH /Times-Roman SF 10780 XM (Control characters embedded in escape sequences)SH /Symbol SF 10070 34430 MT (\267)SH /Times-Roman SF 10780 XM (VT52 mode)SH 8280 36221 MT (\050this is not an exhaustive list\051)SH 8280 38613 MT (The keyboard is set up by default as follows: If your Macintosh has a Control) 54 W( key \050ie. an SE or II\051, Kermit uses it,)55 W 8280 39809 MT (and the Command \050Fan, Cloverleaf\051 key can) 112 W( be used for keyboard equivalents for menus. If your Mac does not)111 W 8280 41005 MT (have a Control key, then the Command key) 39 W( is used as the Control key. The CAPS LOCK key forces all alphabetic)40 W 8280 42201 MT (characters to upper case. The terminal emulator sends) 85 W( ESC \050escape\051 when the ``)84 W /Courier SF (`)SH /Times-Roman SF ('' \050accent grave\051 key is pressed)84 W 8280 43397 MT (unshifted \050even if your keyboard has an ESC key\051. The character ``)9 W /Courier SF (`)SH /Times-Roman SF ('' can be sent by typing Control) 9 W( \050or Command\051)10 W 8280 44593 MT (and the same key. The Backspace) 39 W( key sends a Delete \050Rubout\051 and Control-Backspace sends a Backspace. On the)38 W 8280 45789 MT (original Mac keyboards, the) 63 W( main keypad Enter key sends a "short" \050250ms\051 BREAK signal. The Mac+, Mac SE,)64 W 8280 46985 MT (and Mac II do not have a main keypad Enter key, so the BREAK function must be reassigned to another key.)SH 8280 49377 MT (You can modify) 63 W( the keyboard layout any way you like, defining keyboard macros, defining or moving the Control)62 W 8280 50573 MT (and Escape keys, etc., using MacKermit's built-in key configuration) 72 W( features. Older MacKermits \050version 0.8 and)73 W 8280 51769 MT (earlier\051 came with a separate) 18 W( key configuration program called CKMKEY. This should not be used, because it does)17 W 8280 52965 MT (not understand the format of the 0.9 and later keyboard configuration software.)SH 8280 55357 MT (MacKermit includes a mouse-controlled) 11 W( cursor positioning feature for use during terminal emulation. If the "Mouse)12 W 8280 56553 MT (-> Arrow Keys" feature is turned on \050via) 41 W( the)40 W /Times-Bold SF 26642 XM (Terminal)SH /Times-Roman SF 30932 XM (entry of the)40 W /Times-Bold SF 35912 XM (Settings)SH /Times-Roman SF 39591 XM (menu\051, then when the mouse button is)40 W 8280 57749 MT (pressed, the program acts as if) 80 W( you typed the VT100 keypad arrow keys to move the terminal cursor to where the)81 W 8280 58945 MT (mouse cursor is. MacKermit does this by sending the) 21 W( absolute strings for arrow keys, independant of what is bound)20 W 8280 60141 MT (to the actual arrow keys of the keyboard.)SH 8280 62533 MT (MacKermit sets the Mac hardware to do 8-bit data communication with no parity,) 43 W( and then correctly sets the parity)44 W 8280 63729 MT (bit of each character itself in software, as requested in the)62 W /Times-Bold SF 32232 XM (Communication)SH /Times-Roman SF 39432 XM (settings menu. This has the benefit of)61 W 8280 64925 MT (avoiding the problem of a machine which requires a different) 157 W( input parity than it sends back. MacKermit will)158 W 8280 66121 MT (correctly receive all of the characters sent to it, no matter which parity they are.)SH 8280 68513 MT (To allow useful coexistence of) 53 W( desk accessories and Kermit, the terminal emulation window may be dragged using)52 W 8280 69709 MT (the drag bar. If a desk accessory overlays the emulation window, the emulation window can) 114 W( be clicked upon to)115 W 8280 70905 MT (move it in front of the DA, and later dragged to reveal the hidden desk accessory so that it can be restored) 86 W( to the)85 W ES %%Page: 166 167 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 166)SH 12 /Times-Bold AF 26919 XM (Kermit User Guide: MACINTOSH KERMIT \0507.6\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (foreground. The) 360 W( same thing can be) 55 W( done with Kermit's own remote response window as well. Note that Kermit's)56 W 6120 9082 MT (terminal emulation window does not accept input when any other window is in the foreground.)SH 6120 11474 MT (MacKermit uses XON/XOFF \050control-Q and control-S\051 flow control during terminal emulation and) 43 W( file transfer. If)42 W 6120 12670 MT (the other system does not understand XON/XOFF, problems may result at high speeds. The terminal emulator can)49 W 6120 13866 MT (normally keep up at 9600 baud, and) 74 W( has a very large input buffer, but after several continuous scrolling screens at)73 W 6120 15062 MT (this speed, some characters may be lost. When running) 112 W( at high baud rates on a system that does not understand)113 W 6120 16258 MT (XON/XOFF flow control, either) 42 W( keep your terminal in page mode, use a text paging program such as Unix "more",)41 W 6120 17454 MT (or view text with a non-scrolling) 1 W( screen editor. Also, don't drag the terminal emulation window while characters are)2 W 6120 18650 MT (arriving; if you do, the characters may be lost and the display may become confused.)SH 6120 21042 MT (During terminal emulation, the characters displayed on the screen may also be saved on the disk. This allows you to)7 W 6120 22238 MT (record interactions with the) 118 W( remote system, or to "capture" files that you can't transfer with Kermit protocol, for)119 W 6120 23434 MT (example when) 39 W( the remote system does not have a Kermit program. Use the)38 W /Times-Bold SF 37175 XM (Log)SH /Times-Roman SF 39130 XM (menu, and choose session logging)38 W 6120 24630 MT (to activate this feature. The result goes into a file called "Kermit Session") 102 W( in the current folder, which is always)103 W 6120 25826 MT (appended to, rather than overwritten. To create a new session log, delete or rename the old one first.)SH 6120 28218 MT (The following features are missing from the MacKermit terminal emulator,) 232 W( and may be added in subsequent)231 W 6120 29414 MT (releases:)SH /Symbol SF 7910 31319 MT (\267)SH /Times-Roman SF 8620 XM (Restoration of character attributes such as underlining or highlighting.)SH /Symbol SF 7910 32424 MT (\267)SH /Times-Roman SF 8620 XM (Cutting text from screen to clipboard.)SH /Symbol SF 7910 33529 MT (\267)SH /Times-Roman SF 8620 XM (Transmission of raw text to host \050e.g. pasting to screen\051.)SH /Symbol SF 7910 34634 MT (\267)SH /Times-Roman SF 8620 XM (Screen rollback.)SH /Symbol SF 7910 35739 MT (\267)SH /Times-Roman SF 8620 XM (Screen resizing.)SH /Symbol SF 7910 36844 MT (\267)SH /Times-Roman SF 8620 XM (Explicit modem or dialer control.)SH /Symbol SF 7910 37949 MT (\267)SH /Times-Roman SF 8620 XM (Login scripts.)SH /Symbol SF 7910 39054 MT (\267)SH /Times-Roman SF 8620 XM (Printer support.)SH /Symbol SF 7910 40159 MT (\267)SH /Times-Roman SF 8620 XM (Ability to use the printer port for terminal emulation.)SH /Symbol SF 7910 41264 MT (\267)SH /Times-Roman SF 8620 XM (A way to disable XON/XOFF flow control, or select other flow controls.)SH 14 /Times-Bold AF 6120 44866 MT (7.7. File Transfer)SH 10 /Times-Roman AF 6120 46984 MT (Like most Kermit programs, MacKermit allows you to send and receive) 62 W( text or binary files singly or in groups. It)63 W 6120 48180 MT (will interact with a remote Kermit server,) 36 W( and it can act as a server itself. However, due to the unique nature of the)35 W 6120 49376 MT (Macintosh file system, there are some special considerations:)SH /Symbol SF 7910 51281 MT (\267)SH /Times-Roman SF 8620 XM (Mode -) 37 W( Text or Binary. Binary means the data is sent or stored without modification. Text means that)38 W 2333 50 8620 51481 UL 8620 52386 MT (every carriage return character \050CR\051 in) 232 W( a Macintosh file is translated to a carriage-return-linefeed)231 W 8620 53491 MT (\050CRLF\051 sequence when sending, and every CRLF in an incoming file is) 60 W( turned into a CR when stored)61 W 8620 54596 MT (on the Mac disk. A text file is produced when) 119 W( you save a file from MacWrite or other applications)118 W 8620 55701 MT (using the "text only" option; text files are not associated with any particular) 49 W( Macintosh application and)50 W 8620 56806 MT (can be sent in a useful fashion to other kinds of computers.)SH 8620 58795 MT (A word of caution about Macintosh text files: The Macintosh) 80 W( supports an extended version of ASCII,)79 W 8620 59900 MT (with characters like accented and umlauted) 214 W( vowels in the 128-255 range. These characters allow)215 W 8620 61005 MT (representation of Roman-based languages other than English, but) 132 W( they do not follow any of the ISO)131 W 8620 62110 MT (standards for extended character sets,) 60 W( and thus are only useful on a Mac. When transferring text files,)61 W 8620 63215 MT (you should ensure that either there are no extended characters in) 84 W( the file, or that the other system can)83 W 8620 64320 MT (understand the Mac's 8-bit characters.)SH /Symbol SF 7910 66309 MT (\267)SH /Times-Roman SF 8620 XM (Fork - Data or Resource. Macintosh files may have two "forks".) 103 W( The) 458 W( data fork contains data for an)104 W 1889 50 8620 66509 UL 8620 67414 MT (application; the resource fork contains icons, strings, dialog) 232 W( boxes, and so forth. For instance, a)231 W 8620 68519 MT (MacWrite document contains) 27 W( text and formatting information in the data fork, and fonts in the resource)28 W 8620 69624 MT (fork. For) 250 W( applications, the executable code is stored in the resource fork.)SH ES %%Page: 167 168 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (7.7. File Transfer)SH 10 /Times-Italic AF 51275 XM (Page 167)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (File transfer is initiated when you select)71 W /Times-Bold SF 25025 XM (Send file...)71 W /Times-Roman SF (,)SH /Times-Bold SF 30111 XM (Receive File...)70 W /Times-Roman SF (, or)70 W /Times-Bold SF 37791 XM (Get file from server...)70 W /Times-Roman SF 47484 XM (from MacKermit's)70 W /Times-Bold SF 8280 9082 MT (File)SH /Times-Roman SF 10141 XM (menu.)SH 8280 11474 MT (File transfers can be canceled by clicking on the Cancel File) 121 W( or Cancel Group buttons. These will always work)122 W 8280 12670 MT (when sending. When receiving, they will work if the opposite Kermit honors this \050optional\051 feature) 28 W( of the protocol.)27 W 8280 13866 MT (There is also an "emergency exit" from any) 269 W( protocol operation, which can be taken at any time by typing)270 W 8280 15062 MT ("Command-)SH /Courier SF (.)SH /Times-Roman SF (" -- that is, hold down the Command \050Fan, Cloverleaf\051 key and type period.)SH 8280 17454 MT (The progress of file transfer operations can) 35 W( be logged into a Macintosh file called a "transaction log". This log will)34 W 8280 18650 MT (show the names of the files transferred, the date and time, and the completion) 1 W( status. This feature is useful with long)2 W 8280 19846 MT (unattended transfers -- you can come back later and read the transaction log to find out what happened.) 186 W( The)621 W 8280 21042 MT (transaction log is called "Kermit Log".)SH 8280 23434 MT (The current version of Mac Kermit can) 24 W( only send one fork of a file at a time. When a file has two forks, there is no)25 W 8280 24630 MT (provision for sending both) 197 W( forks together. This restriction may be lifted in future releases of MacKermit, for)196 W 8280 25826 MT (example by converting applications to MacBinary format during transmission.)SH 12 /Times-Bold AF 8280 28942 MT (7.7.1. Sending Files)SH 10 /Times-Roman AF 8280 30884 MT (To send files, first put) 109 W( the remote Kermit in server mode, or else give it the RECEIVE command. Then use the)110 W 8280 32080 MT (mouse to) 37 W( select)36 W /Times-Bold SF 14805 XM (Send file...)36 W /Times-Roman SF 19572 XM (from the)36 W /Times-Bold SF 23310 XM (File)SH /Times-Roman SF 25207 XM (menu. This) 322 W( will give you a MacKermit file-open box, which includes the)36 W 8280 33276 MT (standard Macintosh dialog items -- a file list, Disk and Eject buttons, etc. You can either send one file at a time, by)29 W 8280 34472 MT (clicking on its name in the file list, or send the entire contents of the current HFS) 105 W( folder \050for HFS disks only, of)104 W 8280 35668 MT (course\051. Clicking) 526 W( the Disk) 138 W( button will switch the file list to another physical disk. If desired, you can type an)139 W 8280 36864 MT (alternate name) 87 W( to send the file under. When you select a file, MacKermit examines its type; if the type is APPL,)86 W 8280 38060 MT (then MacKermit expects) 34 W( to send the resource fork in binary mode, otherwise the data fork in text mode. The Mode)35 W 8280 39256 MT (and Fork radio buttons will display these choices; you may change them before clicking the Send button.)SH 12 /Times-Bold AF 8280 42372 MT (7.7.2. Receiving Files)SH 10 /Times-Roman AF 8280 44314 MT (You can) 55 W( receive or get multiple files, providing the opposite Kermit is capable of sending multiple files in a single)54 W 8280 45510 MT (transaction \050most are\051.) 109 W( To) 469 W( receive files, first give the remote Kermit a SEND command and then select)110 W /Times-Bold SF 51804 XM (Receive)SH 8280 46706 MT (file...)SH /Times-Roman SF 10678 XM (from the)65 W /Times-Bold SF 14474 XM (File)SH /Times-Roman SF 16400 XM (menu. To) 380 W( get files from a server,) 65 W( first put the remote Kermit into server mode, then select the)64 W /Times-Bold SF 8280 47902 MT (Get file from server...)64 W /Times-Roman SF 17949 XM (option from the)64 W /Times-Bold SF 24613 XM (File menu)64 W /Times-Roman SF (, and type in the name of the file you want to get,) 64 W( or a wildcard)65 W 8280 49098 MT (designator for multiple files, in the remote system's filename syntax.)SH 8280 51490 MT (As each) 58 W( file arrives at the Mac, it will be decoded according to the current mode \050text or binary\051, and stored in the)57 W 8280 52686 MT (default fork \050data or resource\051. The file names) 83 W( will be either the names the files arrive with \050overwriting existing)84 W 8280 53882 MT (files of the same names\051 or new unique names \050when name conflicts occur\051, according) 121 W( to the current default for)120 W 8280 55078 MT (name collisions. You may also) 12 W( elect to perform an "attended" receive, in which you have an opportunity to override)13 W 8280 56274 MT (file defaults on a per-file basis \050do this in the)45 W /Times-Bold SF 26893 XM (Protocol)SH /Times-Roman SF 30797 XM (section of the)44 W /Times-Bold SF 36567 XM (Settings)SH /Times-Roman SF 40250 XM (menu\051. But) 338 W( attended operation must)44 W 8280 57470 MT (be used with caution -- if you take too long \050more than about a minute\051 to execute an incoming) 15 W( file's dialog box, the)16 W 8280 58666 MT (opposite Kermit could time out and terminate the transaction.) 18 W( If) 285 W( this happens, tell the opposite Kermit to send again)17 W 8280 59862 MT (and try again with the receive dialog.)SH 8280 62254 MT (The folder for new) 64 W( files is the same as the location of the settings file, or if no settings file was used then the new)65 W 8280 63450 MT (files appear on the desktop. If you are) 7 W( transferring a lot of files and want to keep them together, create a folder, drag)6 W 8280 64646 MT (the settings file into it, and double click on the settings file; all created files will appear in that folder.)SH ES %%Page: 168 169 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 168)SH 12 /Times-Bold AF 26919 XM (Kermit User Guide: MACINTOSH KERMIT \0507.8\051)SH 46800 50 6120 5709 UL 14 SS 6120 8138 MT (7.8. Remote Commands)SH 10 /Times-Roman AF 6120 10256 MT (When connected to a Kermit server, MacKermit is capable of issuing special file management and other commands)35 W 6120 11452 MT (to it. The)15 W /Times-Bold SF 10319 XM (Remote)SH /Times-Roman SF 13860 XM (menu contains these commands. You may request directory listings,) 15 W( you can delete files, change)14 W 6120 12648 MT (directories, etc, on server's machine. The response from these commands \050if any\051 is displayed in a special) 65 W( pop-up)66 W 6120 13844 MT (window. Responses) 414 W( to multiple Remote commands are separated by a dashed line. The response window) 82 W( can be)81 W 6120 15040 MT (scrolled, sized, and positioned, and) 126 W( can be hidden by clicking the menu item ")127 W /Times-Bold SF (Hide Response)127 W /Times-Roman SF (" or the window's)127 W 6120 16236 MT (go-away box; all text remains intact and will) 7 W( be appended to the next time you do a Remote command; it can also be)6 W 6120 17432 MT (brought to the foreground by clicking the)4 W /Times-Bold SF 22896 XM (Show Response)4 W /Times-Roman SF 29738 XM (menu item. Note that typein to) 4 W( the terminal emulator will)5 W 6120 18628 MT (not take effect when the response window -- or any other window \050such as a desk accessory\051 -- is up front.) 45 W( This) 339 W( is)44 W 6120 19824 MT (not a bug, but a feature of the Macintosh user interface guidelines.)SH 6120 22216 MT (If the response buffer gets too full \050greater than 30,000 characters\051, MacKermit will) 85 W( remove enough text from the)86 W 6120 23412 MT (beginning of the buffer, in 512 byte chunks, to make it less than 30,000 characters again.)SH 6120 25804 MT (A Remote command can be canceled by taking the Emergency Exit \050Command-)55 W /Courier SF (.)SH /Times-Roman SF (\051. To) 360 W( disengage from the remote)54 W 6120 27000 MT (Kermit server, click on)SH /Times-Bold SF 15590 XM (Bye)SH /Times-Roman SF 17451 XM (or)SH /Times-Bold SF 18534 XM (Finish)SH /Times-Roman SF 21452 XM (in the)SH /Times-Bold SF 23952 XM (Remote)SH /Times-Roman SF 27478 XM (menu.)SH 14 /Times-Bold AF 6120 30602 MT (7.9. Server Operation)SH 10 /Times-Roman AF 6120 32720 MT (MacKermit may itself act as a Kermit server. Just set the desired parameters in the)21 W /Times-Bold SF 39922 XM (Settings)SH /Times-Roman SF 43583 XM (menu, then click on)22 W /Times-Bold SF 51809 XM (Be)SH 6120 33916 MT (a Server)166 W /Times-Roman SF 10284 XM (in the)165 W /Times-Bold SF 13114 XM (Remote)SH /Times-Roman SF 16805 XM (menu. The) 580 W( MacKermit server can respond to SEND, GET, REMOTE DIRECTORY,)165 W 6120 35112 MT (FINISH, and BYE commands.) 127 W( You) 506 W( can send single or multiple files to a MacKermit server, and you can get a)128 W 6120 36308 MT (single file from it by name. You can also get all) 80 W( the files in the current folder by using a colon \050``)79 W /Courier SF (:)SH /Times-Roman SF (''\051 as the file)79 W 6120 37504 MT (specification in the GET command:)SH /Courier SF 8520 39159 MT (GET :)SH /Times-Roman SF 6120 40876 MT (If you) 97 W( give the FINISH command, MacKermit will return to terminal mode. If you give the BYE command, the)98 W 6120 42072 MT (Macintosh will reboot itself.)SH 6120 44464 MT (You can take MacKermit out of server mode from the Mac keyboard by typing the emergency exit) 185 W( sequence,)184 W 6120 45660 MT (Command-dot.)SH 14 /Times-Bold AF 6120 49262 MT (7.10. Settings)SH 10 /Times-Roman AF 6120 51380 MT (You can) 91 W( change File, Communications, Protocol, Terminal, Keyboard macros, and Keyboard modifier settings by)92 W 6120 52576 MT (using the)62 W /Times-Bold SF 10133 XM (Settings)SH /Times-Roman SF 13834 XM (pull-down menu. You can save and load these settings) 62 W( by invoking the appropriate selection in)61 W 6120 53772 MT (the)SH /Times-Bold SF 7624 XM (File)SH /Times-Roman SF 9517 XM (menu. If) 314 W( the "bundle bit" has been correctly set on) 32 W( your version of MacKermit \050it should be\051, then you can)33 W 6120 54968 MT (double-click on the resulting document to start MacKermit with those settings.)SH 6120 57360 MT (The)SH /Times-Bold SF 7925 XM (File)SH /Times-Roman SF 9786 XM (settings establish the defaults for file transfer:)SH /Symbol SF 7910 59265 MT (\267)SH /Times-Roman SF 8620 XM (Attended versus Unattended operation for incoming files.)SH 3666 50 8620 59465 UL 4610 50 15341 59465 UL /Symbol SF 7910 61254 MT (\267)SH /Times-Roman SF 8620 XM (Naming: When doing) 61 W( unattended file reception, whether incoming files should supersede existing files)60 W 3222 50 8620 61454 UL 4388 50 17718 61454 UL 8620 62359 MT (of the same name, or a new unique name should) 104 W( be assigned to them. If the latter, the new name is)105 W 8620 63464 MT (formed by adding a dot and a) 98 W( number to the end. For instance, if a file called FOO exists and a file)97 W 8620 64569 MT (called FOO arrives, MacKermit will store the arriving file as FOO.1; if FOO.1 exists, then FOO.2, etc.)SH /Symbol SF 7910 66558 MT (\267)SH /Times-Roman SF 8620 XM (Mode: text or binary.) 95 W( Used) 441 W( for received files only. When sending, MacKermit tries to figure out an)96 W 2333 50 8620 66758 UL 8620 67663 MT (appropriate mode for the file being sent \050but then lets you override it the Send File dialog\051.)SH /Symbol SF 7910 69652 MT (\267)SH /Times-Roman SF 8620 XM (Fork: which fork -- data or resource -- to send, or to store an incoming file into.)SH 1889 50 8620 69852 UL ES %%Page: 169 170 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (7.10. Settings)SH 10 /Times-Italic AF 51275 XM (Page 169)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (The)SH /Times-Bold SF 10104 XM (Communications)SH /Times-Roman SF 17651 XM (settings allow you to set the baud rate \050anywhere between 300 baud) 19 W( and 57)18 W /Courier SF (.)SH /Times-Roman SF (6K baud, except)18 W 8280 9082 MT (38)SH /Courier SF (.)SH /Times-Roman SF (4K baud\051, and parity \050odd, even, mark, space, or none\051. When the parity is set to none the Macintosh) 72 W( uses an)73 W 1944 50 43736 9282 UL 8280 10278 MT (8-bit-wide connection. All other parity settings tell the Macintosh to use a 7-bit-wide connection,) 108 W( and to request)107 W 8280 11474 MT (8th-bit prefixing when transferring 8-bit data. If the remote) 20 W( host or the communication path uses any kind of parity,)21 W 8280 12670 MT (then you won't be able to transfer files successfully unless) 2 W( you tell MacKermit \050and in most cases also the Kermit on)1 W 8280 13866 MT (the other end\051 about it. Duplex is selected in the)SH /Times-Bold SF 27944 XM (Terminal)SH /Times-Roman SF 32194 XM (settings.)SH 8280 16258 MT (The)SH /Times-Bold SF 10155 XM (Protocol)SH /Times-Roman SF 14085 XM (settings allow you to set packet parameters for both incoming) 70 W( and outbound packets. These include)71 W 8280 17454 MT (the block check type \0501 or 2 character checksum, 3-character 16-bit) 209 W( CRC-CCITT\051, line turnaround handshake)208 W 8280 18650 MT (character \050for file transfer with half duplex systems\051, packet start and end characters, padding, packet) 2 W( length, timeout)3 W 8280 19846 MT (interval, and packet length. Characters are specified by entering their) 30 W( ASCII value in decimal, e.g. 1 for Control-A,)29 W 8280 21042 MT (13 for Control-M \050Carriage Return\051, etc. The RECEIVE parameters are conveyed by MacKermit to the) 186 W( other)187 W 8280 22238 MT (Kermit. For) 528 W( instance, if you set the receive-packet-length to 500, MacKermit will tell the other Kermit to) 139 W( send)138 W 8280 23434 MT (500-character packets. The SEND parameters are used to override negotiated values, and need rarely be used.)SH 8280 25826 MT (Long packets are selected by setting the RECEIVING packet) 78 W( length between 95 and 1000. Normally, you should)79 W 8280 27022 MT (not change the) 128 W( sending length because MacKermit, and most other Kermits, will configure themselves correctly.)127 W 8280 28218 MT (Note also that the fastest file transfers will happen with long packets in the range of 300-500. Very long packets)89 W 8280 29414 MT (actually end up being much slower, because the operating systems) 9 W( in both the Mac and the other machine have to do)8 W 8280 30610 MT (more work to cope with such long inputs, and, under noisy) 36 W( conditions, the probability is higher that a longer packet)37 W 8280 31806 MT (will be struck by noise, and will take longer to retransmit.)SH 8280 34198 MT (The)SH /Times-Bold SF 10169 XM (Terminal)SH /Times-Roman SF 14503 XM (settings let you modify the characteristics) 84 W( of the VT102 emulator, such as auto-linefeed, autowrap,)83 W 8280 35394 MT (autorepeat keys, block) 92 W( vs underline cursor, blinking vs steady cursor, inverted screen \050reverse video\051, and smooth)93 W 8280 36590 MT (scrolling. There) 642 W( is also a "visible bell" for those) 196 W( who can't hear the audible bell produced upon receipt of a)195 W 8280 37786 MT (Control-G, and an option to display control characters visibly by showing their numeric ASCII values \050in decimal\051)59 W 8280 38982 MT (in a single character cell. If local echo is needed, as in half-duplex connections, that must be specified here also.)SH 14 /Times-Bold AF 8280 42584 MT (7.11. Settings Files)SH 10 /Times-Roman AF 8280 44702 MT (You can start MacKermit with all its "factory settings" by double clicking on the MacKermit) 32 W( icon. Factory settings)31 W 8280 45898 MT (are designed for direct communication with most other microcomputers, DEC minis and mainframes, etc: 9600) 24 W( bps,)25 W 8280 47094 MT (no parity, XON/XOFF, remote echo, etc.) 6 W( You) 261 W( can change the communication, protocol, file, keyboard, and terminal)5 W 8280 48290 MT (settings by going through the options in the)73 W /Times-Bold SF 26476 XM (Settings)SH /Times-Roman SF 30189 XM (menu. Once) 398 W( you have set all parameters as desired, you can)74 W 8280 49486 MT (save your settings in a "MacKermit settings file" by selected ")43 W /Times-Bold SF (Save Settings...)43 W /Times-Roman SF (" from the)43 W /Times-Bold SF 44426 XM (File)SH /Times-Roman SF 46329 XM (menu. A) 334 W( settings file)42 W 8280 50682 MT (is, in Macintosh terminology, a "MacKermit document".) 25 W( You'll) 302 W( recognize it because it looks like a dog-eared piece)26 W 8280 51878 MT (of paper with the MacKermit icon superimposed. You can have more than one settings file.)SH 8280 54270 MT (There are two ways to) 165 W( use a settings file. First, you can double-click on it, just as you can double-click on a)164 W 8280 55466 MT (MacWrite document to start up MacWrite to edit a particular file. This method starts up MacKermit with all the)98 W 8280 56662 MT (saved settings. The other method is to click on the ")229 W /Times-Bold SF (Load Settings...)229 W /Times-Roman SF (" option in) 229 W( the)228 W /Times-Bold SF 45480 XM (File)SH /Times-Roman SF 47569 XM (menu from inside)228 W 8280 57858 MT (MacKermit. This) 354 W( lets you change settings without leaving and restarting the program.)52 W /Times-Bold SF 44006 XM (Load Settings...)53 W /Times-Roman SF 51277 XM (shows all)53 W 8280 59054 MT (MacKermit settings) 129 W( files in the selected folder. Opening one of them loads all its settings, removing all current)128 W 8280 60250 MT (settings.)SH 8280 62642 MT (You can "edit" a) 96 W( MacKermit settings file by loading it, going through the)97 W /Courier SF 39074 XM (Settings)SH /Times-Roman SF 44221 XM (menu, and then saving the)97 W 8280 63838 MT (settings either in a new file, or overwriting the same file.)SH 8280 66230 MT (As distributed by Columbia, Mac Kermit comes with two settings files. One is called "Normal Settings", and) 115 W( is)114 W 8280 67426 MT (pretty much identical to Mac Kermit's factory settings. The other is "IBM Mainframe Linemode Settings".) 161 W( It)574 W 8280 68622 MT (selects mark parity, local echo, XON half-duplex line turnaround) 249 W( handshake. You can use these files as-is,)248 W 8280 69818 MT (customize them for your own environment, or create new settings files for all the different kinds of) 16 W( systems that you)17 W 8280 71014 MT (use.)SH ES %%Page: 170 171 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 170)SH 12 /Times-Bold AF 26319 XM (Kermit User Guide: MACINTOSH KERMIT \0507.12\051)SH 46800 50 6120 5709 UL 14 SS 6120 8138 MT (7.12. Reconfiguring the Keyboard)SH 10 /Times-Roman AF 6120 10256 MT (Beginning with version 0.9, MacKermit has keyboard configuration functions built in. These) 54 W( are accessed through)53 W 6120 11452 MT (the)SH /Times-Bold SF 7592 XM (Set Key Macros)SH /Times-Roman SF 14618 XM (and the)SH /Times-Bold SF 17784 XM (Set Modifiers)SH /Times-Roman SF 23783 XM (entries in the)SH /Times-Bold SF 29199 XM (Settings)SH /Times-Roman SF 32838 XM (menu.)SH 6120 13844 MT (The Macintosh keyboard is composed of normal keys and modifier keys.) 63 W( Modifier) 377 W( keys are those keys that, when)64 W 6120 15040 MT (held down, change the) 41 W( meaning of other keys. On the Mac these are: SHIFT, CAPS LOCK, OPTION, CONTROL)40 W 6120 16236 MT (\050only on the Mac II and SE\051, and COMMAND \050also) 62 W( known as APPLE, CLOVER, or FAN\051. Normal keys are the)63 W 6120 17432 MT (letters, numbers, special symbols, arrow keys, space bar,) 30 W( and function keys. Only one normal key can be typed at a)29 W 6120 18628 MT (time, but one or more modifier keys can be pressed down along with it.)SH 6120 21020 MT (When you type a key, Kermit reads both the ASCII value, and the keyboard-independent) 108 W( scan code for that key.)109 W 6120 22216 MT (Kermit looks in its table of key macros to see if there is a macro for this combination of key and modifiers, and) 14 W( if so)13 W 6120 23412 MT (sends the macro. If there is no macro, Kermit then looks in its modifier table to see if any of the modifiers) 128 W( do)129 W 6120 24608 MT (special things to the character; if so, it does) 141 W( these to the character. Finally, Kermit sends the character. In the)140 W 6120 25804 MT (normal case when there is no macro) 80 W( and no modifiers apply, the character sent is simply the ASCII value for that)81 W 6120 27000 MT (character.)SH 6120 29392 MT (It is important to) 137 W( keep in mind that if the parity setting is something other than none, the high \0508th\051 bit will be)136 W 1944 50 39910 29592 UL 6120 30588 MT (stripped off of the characters when they are transmitted. Since most systems do not understand characters) 105 W( in the)106 W 6120 31784 MT (range 128 -- 255 \050decimal\051, you should avoid using the) 72 W( Apple extended characters \050accented vowels, for example\051)71 W 6120 32980 MT (during terminal connection.)SH 12 /Times-Bold AF 6120 36096 MT (7.12.1. Defining Key Macros)SH 10 /Times-Roman AF 6120 38038 MT (To define a new key macro, select the)5 W /Times-Bold SF 21572 XM (Key Macros)5 W /Times-Roman SF 27025 XM (entry. A) 260 W( dialog window will appear, asking) 5 W( you to press the key)6 W 6120 39234 MT (to define. Type the key \050including any of the modifiers\051. A new dialog) 27 W( will appear, with an editable text field in it.)26 W 6120 40430 MT (Enter the definition for the key here. Your definition may) 64 W( be up to 255 characters long, and can include all of the)65 W 6120 41626 MT (control characters \050including NUL\051. Special characters can be included in the macro by entering a ``)11 W /Courier SF (\134)SH /Times-Roman SF ('' \050backslash\051,)10 W 6120 42822 MT (followed by up to 3)54 W /Times-Italic SF 14473 XM (octal)SH /Times-Roman SF 16777 XM (\050base 8\051 digits for the value \050just like in the C) 54 W( programming language\051. For example, an)55 W 6120 44018 MT (ASCII NUL \050value 0\051 would be written as ``)21 W /Courier SF (\134000)SH /Times-Roman SF ('', carriage return \050ASCII 13\051 would be written ``)21 W /Courier SF (\134015)SH /Times-Roman SF ('' \0501 x 8) 21 W( +)20 W 6120 45214 MT (5 = 13\051. Also, control characters may) 168 W( be entered with a backslash, followed by a caret \050or circumflex, ``)169 W /Courier SF (^)SH /Times-Roman SF (''\051,)SH 6120 46410 MT (followed by the corresponding letter. Thus a Control-G \050value 7\051 could be entered as ``)5 W /Courier SF (\134007)SH /Times-Roman SF ('', ``)5 W /Courier SF (\134^G)SH /Times-Roman SF ('', or) 5 W( ``)4 W /Courier SF (\134^g)SH /Times-Roman SF (''.)SH 6120 47606 MT (To include a literal backslash in a definition, type in two of them: ``)SH /Courier SF (\134\134)SH /Times-Roman SF (''.)SH 6120 49998 MT (BREAK conditions are also programmable as macros. If the entire macro the string is ``)33 W /Courier SF (\134break)SH /Times-Roman SF ('', then) 33 W( typing the)34 W 6120 51194 MT (defined key will send a short \0501/4 second\051 break. A long \0503.5 second\051 BREAK is defined with ``)68 W /Courier SF (\134longbreak)SH /Times-Roman SF (''.)SH 6120 52390 MT (Note that a macro can define either a BREAK, or a string of normal characters, but not both.)SH 12 /Times-Bold AF 6120 55506 MT (7.12.2. Defining Key Modifiers)SH 10 /Times-Roman AF 6120 57448 MT (Skip ahead to the next section if you already know about things like SHIFT, CAPS LOCK, CONTROL, and META.)SH 6120 59840 MT (On a typewriter the only modifier key is SHIFT.) 156 W( Typing) 564 W( a character with no modifier key depressed selects a)157 W 6120 61036 MT (lowercase letter) 18 W( or the character printed on the lower face of the keytop \050say, the digit "4"\051. Typing a character with)17 W 6120 62232 MT (SHIFT depressed selects) 77 W( an uppercase letter or the character printed on the upper face of the keytop \050say, a dollar)78 W 6120 63428 MT (sign\051. Some) 392 W( keyboards also have a SHIFT LOCK key, which stays down once pressed and pops up) 71 W( the next time)70 W 6120 64624 MT (it's pressed; its operation is equivalent to holding down SHIFT. And some keyboards have) 120 W( a CAPS LOCK key)121 W 6120 65820 MT (which operates like SHIFT LOCK, but only upon letters.)SH 6120 68212 MT (Computer terminals also have a modifier key) 20 W( called CONTROL \050or CTRL\051. Its function is a little less obvious: it is)19 W 6120 69408 MT (intended to produce one of the 33 characters in the "control range" of the ASCII alphabet. Control) 1 W( characters are not)2 W 6120 70604 MT (graphic -- they are intended for use as format effectors \050like carriage return,) 270 W( formfeed, tab, backspace\051, for)269 W 6120 71800 MT (transmission control, or for device control. The remaining 95 characters -- letters, digits, punctuation, and) 54 W( space --)55 W ES %%Page: 171 172 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (7.12.2. Defining Key Modifiers)SH 10 /Times-Italic AF 51275 XM (Page 171)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (are the graphic characters. When a character) 15 W( is typed with the CONTROL modifier pressed, its "control equivalent")14 W 8280 9082 MT (\050if any\051 is transmitted.) 63 W( By) 378 W( convention, the control equivalent of A is Control-A, B is Control-B, etc, and there are)64 W 8280 10278 MT (also seven special control characters generally associated) 188 W( with punctuation characters or special keys. For the)187 W 8280 11474 MT ("alphabetic" control characters Control-A through Control-Z, SHIFT or CAPS LOCK modifiers are ignored; for) 29 W( the)30 W 8280 12670 MT (others, operation varies from terminal to terminal.)SH 8280 15062 MT (The SHIFT and CONTROL modifiers allow all 128 ASCII characters) 162 W( to be sent from a normal typewriter-like)161 W 8280 16258 MT (keyboard that has about 50 keys. However, certain host-resident computer applications -- notably the) 106 W( full screen)107 W 8280 17454 MT (text editor EMACS and its descendents -- can be used to greater advantage with a 256 character 8-bit) 150 W( alphabet)149 W 8280 18650 MT (\050EMACS responds to single-character commands, and the more) 22 W( characters a terminal can send, the more commands)23 W 8280 19846 MT (are directly available\051.)SH 8280 22238 MT (For this purpose, some terminals also provide a META modifier key. This key simply causes the high-order \050"8th"\051)21 W 8280 23434 MT (bit of the selected 7-bit ASCII value to be set) 65 W( to 1 upon transmission. This can only work when the connection is)66 W 8280 24630 MT (8-data-bits-no-parity. When) 260 W( parity is in use, EMACS allows a sequence of two 7-bit ASCII characters) 5 W( to represent a)4 W 8280 25826 MT (single meta character. The advantage) 96 W( of having a real META modifier key is that it can be held down while the)97 W 8280 27022 MT (actual key is struck repeatedly or even autorepeats, whereas a use of a "meta prefix" such as requires) 2 W( much)1 W 8280 28218 MT (more typing. To illustrate, suppose META-F is the command to go forward one word.) 46 W( If) 343 W( you want to execute this)47 W 8280 29414 MT (operation repeatedly, just hold down META and F and let it autorepeat.) 23 W( If) 295 W( you don't have a META key, then you'd)22 W 8280 30610 MT (have to type FFF..., etc.)SH 8280 33002 MT (A common problem faced by computer users who switch from one terminal or PC) 15 W( to another is the placement of the)16 W 8280 34198 MT (modifiers and) 41 W( other special keys. DEC, IBM, Apple, and other manufacturers consistently move these keys around)40 W 8280 35394 MT (on new models of their keyboards. MacKermit allows you to assign any of various functions to any of the) 75 W( Mac's)76 W 8280 36590 MT (modifier keys, and to assign any desired character or character sequence) 71 W( to the regular keys, so that you can tailor)70 W 8280 37786 MT (the layout of your Mac's keyboard to suit your taste.)SH 12 /Times-Bold AF 8280 40902 MT (7.12.3. Modifiers Dialog)SH 10 /Times-Roman AF 8280 42844 MT (To change) 70 W( the action of any of the modifier keys, select)71 W /Times-Bold SF 31555 XM (Modifiers)SH /Times-Roman SF 36042 XM (from the)71 W /Times-Bold SF 39850 XM (Settings)SH /Times-Roman SF 43560 XM (menu. A) 392 W( dialog will appear)71 W 8280 44040 MT (that looks roughly like the one in Figure 7-1 \050the ``)SH /Courier SF (%)SH /Times-Roman SF ('' represents the Apple or Clover key\051.)SH 46800 50 8280 46031 UL /Courier SF 13680 48810 MT (Modifier Pattern: -->) SH( Modification:)1200 W 11880 50872 MT (Ctrl Opt Lock Shift %) SH( Unmodify) 3000 W( Caps Ctrl Meta Prefix string:)SH 43680 51903 MT (____________)SH 11880 52934 MT ([X] [) 600 W( ] [ ] [ ]) SH( [) 1200 W( ]) SH( | [) 1200 W( ]) SH( [) 1800 W( ] [X] [ ] [____________])SH 11880 53965 MT ([ ] [ ] [ ] [ ]) SH( [X] | [) 1200 W( ]) SH( [) 1800 W( ] [X] [ ] [____________])SH 11880 54996 MT ([ ] [X] [ ] [ ]) SH( [) 1200 W( ]) SH( | [x]) 1200 W( [) 1800 W( ] [ ] [ ] [\134033) SH( ])4200 W 7200 50 43680 55196 UL 11880 56027 MT ([ ] [ ] [ ] [ ]) SH( [) 1200 W( ]) SH( | [) 1200 W( ]) SH( [) 1800 W( ] [ ] [ ] [____________])SH 20280 58089 MT (\050Cancel\051 \050Help\051 \050) 1200 W( OK \051)SH /Times-Bold SF 22404 59806 MT (Figure 7-1:)SH /Times-Roman SF 27653 XM (MacKermit Key Modifier Dialog)SH 46800 50 8280 61616 UL 8280 63808 MT (The check boxes are divided into rows, each one describing a modification. The left half of) 38 W( each row describes the)37 W 8280 65004 MT (modifier combination to look for; a checked box means that this key is down, and an unchecked box means) 56 W( "don't)57 W 8280 66200 MT (care". Note) 382 W( that there is no) 66 W( way to specify a key being up, and lines with nothing checked on the left side will be)65 W 8280 67396 MT (ignored; the character will be modified in the normal Macintosh way.)SH 8280 69788 MT (The right half describes what modification to do to the characters. The Unmodify modification says "make) 39 W( this the)40 W 8280 70984 MT (character that would be sent from the same key with no modifer keys pressed". In other) 11 W( words, un-Option, un-Caps,)10 W ES %%Page: 172 173 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 172)SH 12 /Times-Bold AF 25419 XM (Kermit User Guide: MACINTOSH KERMIT \0507.12.3\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (un-Control, and un-Shift this character. The Caps modification translates all letters to upper case,) 93 W( Ctrl makes the)94 W 6120 9082 MT (letter a contol character, Meta sets the high \0508th\051 bit) 2 W( on the character, and if a Prefix string is present, it is sent before)1 W 6120 10278 MT (the character is.)SH /Times-Italic SF 6120 12670 MT (Hints about modifiers:)SH /Symbol SF 7910 14575 MT (\267)SH /Times-Roman SF 8620 XM (Beware of the Option key. It changes the value of any characters you) 9 W( use with it. If you type Option-F,)10 W 8620 15680 MT (the Mac will send a D,) 110 W( if you type Option-B, the Mac will send a ``)109 W /Courier SF (:)SH /Times-Roman SF ('', etc. If you want to use the)109 W 8620 16785 MT (option key as a modifier, be sure to check the "Unmodify" box.)SH /Symbol SF 7910 18774 MT (\267)SH /Times-Roman SF 8620 XM (To use MacKermit with a version of EMACS that does not accept 8-bit Meta characters, define a key,)59 W 8620 19879 MT (like Option, to be unmodified,) 6 W( with a prefix string of)5 W /Courier SF 30006 XM (\134033)SH /Times-Roman SF 32661 XM (\050ASCII Escape\051, as in Figure 7-1. Then you)5 W 8620 20984 MT (can hold down Option) 7 W( and type F \050or any other key\051 repeatedly, or let it autorepeat, and MacKermit will)8 W 8620 22089 MT (send the correct prefix-Meta sequence.)SH /Symbol SF 7910 24078 MT (\267)SH /Times-Roman SF 8620 XM (When interpreting a keystoke, MacKermit) 34 W( checks the list of modifiers from top to bottom, applying the)33 W 8620 25183 MT (first one that) 53 W( matches. This means that if you want a different modifier for Command-Option and just)54 W 8620 26288 MT (plain Command, you must put the definition for Command-Option first in the list.)SH 14 /Times-Bold AF 6120 29890 MT (7.13. Bootstrapping)SH 10 /Times-Roman AF 6120 32008 MT (This section applies if you do not have a MacKermit diskette, but MacKermit is) 113 W( available for downloading from)112 W 6120 33204 MT (some other computer.)SH 6120 35596 MT (MacKermit is distributed in source) 150 W( form for building on a Macintosh, running Apple's Macintosh Programmers)151 W 6120 36792 MT (Workbench \050in MPW C\051, in)5 W /Courier SF 17843 XM (.HQX)SH /Times-Roman SF 20498 XM ("BinHex 4" form, and sometimes also as a binary resource file. Those who want)4 W 6120 37988 MT (to work from the source are referred to the file)SH /Courier SF 24947 XM (CKMKER.BLD)SH /Times-Roman SF 31197 XM (for instructions.)SH 6120 40380 MT (If you're downloading, it's best to work with)157 W /Courier SF 25624 XM (CKMKER.HQX)SH /Times-Roman SF (, a) 157 W( textual encoding of the MacKermit application.)158 W 6120 41576 MT (Download this using any technique available to) 53 W( you -- an old release of Kermit, an Xmodem implementation, even)52 W 6120 42772 MT (raw screen capture. Then run BinHex \050version 4\051 to convert it into a working application \050select)182 W /Times-Bold SF 48472 XM (Upload ->)183 W 6120 43968 MT (Application)SH /Times-Roman SF 11371 XM (from the)SH /Times-Bold SF 15037 XM (File)SH /Times-Roman SF 16898 XM (menu\051. Eveything) 250 W( will be set up correctly -- icons, forks, etc.)SH 6120 46360 MT (If you don't) 150 W( have the)149 W /Courier SF 15504 XM (.HQX)SH /Times-Roman SF 18303 XM (file available, but you do have access to the binary resource file \050its name will be)149 W /Courier SF 6120 47556 MT (CKMKER.RSRC)SH /Times-Roman SF (,)SH /Courier SF 13702 XM (ckmker.rsrc)SH /Times-Roman SF (,)SH /Courier SF 21285 XM (CKMKER.RSR)SH /Times-Roman SF (,)SH /Courier SF 28268 XM (ckmker.rsr)SH /Times-Roman SF (,)SH /Courier SF 35251 XM (%ckmker)SH /Times-Roman SF 40184 XM (or some variation on these,)483 W 6120 48752 MT (depending on) 124 W( what system it's stored on and how it got there\051, AND if you have "MacPut" on your system and)123 W 6120 49948 MT (MacTerminal on your Mac, AND if you have an 8-bit-wide \050no parity\051 data path between your Mac) 173 W( and your)174 W 6120 51144 MT (system, then you can use MacPut to download the binary resource file) 299 W( to your Mac using MacTerminal's)298 W 6120 52340 MT ("MacBinary" format \050a variant of) 4 W( XMODEM\051. After doing this you must use a program such as SetFile or ResEdit)5 W 6120 53536 MT (on the Mac to set the) 165 W( author to KR09, the type to APPL, and turn on the bundle bit. Do not bother with the)164 W 6120 54732 MT (CKMKEY program, as it is not used with newer MacKermits. If you have an earlier release of) 101 W( MacKermit, you)102 W 6120 55928 MT (may use it in place of MacTerminal and MacPut.)SH 14 /Times-Bold AF 6120 59530 MT (7.14. Differences Between Versions 0.8 and 0.9)SH 10 /Times-Roman AF 6120 61648 MT (MacKermit 0.8\05034\051 runs on the 128K Mac, the 512K Mac, and the Mac) 97 W( Plus, but not on the Macintosh II or SE.)96 W 6120 62844 MT (MacKermit 0.9\05040\051 runs on all Macs except the 128K original. You should use version 0.9 unless you have a) 25 W( 128K)26 W 6120 64040 MT (Mac.)SH 6120 66432 MT (The second major difference is that the program is has been translated into Apple MPW C,) 48 W( so that it can be edited,)47 W 6120 67628 MT (compiled, and built on the Macintosh itself. This) 264 W( was done originally by Jim Noble of Planning Research)265 W 6120 68824 MT (Corporation, who converted MacKermit from SUMACC C \050which) 48 W( had to be cross compiled on a UNIX system\051 to)47 W 6120 70020 MT (Megamax C. Jim's version was converted to MPW C by Matthias Aebi, who also added most of the new) 76 W( features)77 W 6120 71216 MT (listed below. Paul) 68 W( Placeway integrated the program with the current \050long packet\051 version of C-Kermit and added)67 W ES %%Page: 173 174 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (7.14. Differences Between Versions 0.8 and 0.9)SH 10 /Times-Italic AF 51275 XM (Page 173)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (additional new features.)SH 8280 10278 MT (Besides these important differences, there were many other changes from version 0.8 to version 0.9, including:)SH /Symbol SF 10070 12183 MT (\267)SH /Times-Roman SF 10780 XM (The Cursor with open desk accessories now works correctly)SH /Symbol SF 10070 13509 MT (\267)SH /Times-Roman SF 10780 XM (Long packet support)SH /Symbol SF 10070 14835 MT (\267)SH /Times-Roman SF 10780 XM (New program icon)SH /Symbol SF 10070 16161 MT (\267)SH /Times-Roman SF 10780 XM (New settings files are no longer TEXT)SH /Symbol SF 10070 17487 MT (\267)SH /Times-Roman SF 10780 XM (Settings can now be written back to an already existing settings file)SH /Symbol SF 10070 18813 MT (\267)SH /Times-Roman SF 10780 XM (Key redefinition function built in to Kermit, no more CKMKEY)SH /Symbol SF 10070 20139 MT (\267)SH /Times-Roman SF 10780 XM (Server mode directory listing feature)SH /Symbol SF 10070 21465 MT (\267)SH /Times-Roman SF 10780 XM (Multifile \050folder\051 send)SH /Symbol SF 10070 22791 MT (\267)SH /Times-Roman SF 10780 XM (Server "Delete" file command)SH /Symbol SF 10070 24117 MT (\267)SH /Times-Roman SF 10780 XM (Server "Space" command)SH /Symbol SF 10070 25443 MT (\267)SH /Times-Roman SF 10780 XM (Get whole folder content from the server with filename ``)SH /Courier SF (:)SH /Times-Roman SF ('')SH /Symbol SF 10070 26769 MT (\267)SH /Times-Roman SF 10780 XM (Recognition of all the different Mac keyboards)SH /Symbol SF 10070 28095 MT (\267)SH /Times-Roman SF 10780 XM (Support of menu command keys \050key macros\051)SH /Symbol SF 10070 29421 MT (\267)SH /Times-Roman SF 10780 XM (Terminal settings dialog separated from communication settings)SH /Symbol SF 10070 30747 MT (\267)SH /Times-Roman SF 10780 XM (Non-transparent terminal mode)SH /Symbol SF 10070 32073 MT (\267)SH /Times-Roman SF 10780 XM (Display of statistics and protocol version to "About Kermit" dialog.)SH /Symbol SF 10070 33399 MT (\267)SH /Times-Roman SF 10780 XM (Parity problems fixed)SH /Symbol SF 10070 34725 MT (\267)SH /Times-Roman SF 10780 XM (Session logging)SH /Symbol SF 10070 36051 MT (\267)SH /Times-Roman SF 10780 XM (Transaction logging)SH /Symbol SF 10070 37377 MT (\267)SH /Times-Roman SF 10780 XM (Multifinder support)SH /Symbol SF 10070 38703 MT (\267)SH /Times-Roman SF 10780 XM (Additions to the VT102 emulator \050smooth scrolling, etc\051)SH /Symbol SF 10070 40029 MT (\267)SH /Times-Roman SF 10780 XM (Rearrangement of menus and displays)SH /Symbol SF 10070 41355 MT (\267)SH /Times-Roman SF 10780 XM (Program no longer hangs if remote response window gets too full)SH /Symbol SF 10070 42681 MT (\267)SH /Times-Roman SF 10780 XM (Program now works correctly on 64K ROM machines)SH /Symbol SF 10070 44007 MT (\267)SH /Times-Roman SF 10780 XM (A new manual)SH 8280 45798 MT (This manual applies in large part) 49 W( to version 0.8\05034\051, except that the older version is missing the new features listed)50 W 8280 46994 MT (above, and it comes) 14 W( in two pieces: CKMKER and CKMKEY. The CKMKEY program is used to program the keys,)13 W 8280 48190 MT (like the)112 W /Times-Bold SF 11726 XM (Set Key Macros...)112 W /Times-Roman SF 19839 XM (and)SH /Times-Bold SF 21646 XM (Set Modifiers)113 W /Times-Roman SF 27871 XM (described in this manual, and creates a settings file which Kermit)113 W 8280 49386 MT (itself uses. The old version only works well with early Macintosh keyboards.)SH ES %%Page: 174 175 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 174)SH 12 /Times-Bold AF 27819 XM (Kermit User Guide: MACINTOSH KERMIT \0508\051)SH 46800 50 6120 5709 UL ES %%Page: 175 176 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (8. IBM 370 KERMIT)SH 10 /Times-Italic AF 51275 XM (Page 175)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 8280 8272 MT (8. IBM 370 KERMIT)SH 10 /Times-Italic AF 8280 10566 MT (Program:)SH /Times-Roman SF 15280 XM (John Chandler \050Harvard/Smithsonian Center for Astrophysics\051; contributions from Vace) 31 W( Kundakci)30 W 15280 11671 MT (and Daphne Tzoar \050Columbia) 211 W( U\051, Bob Shields \050U. Maryland\051, Victor Lee \050Queens U.\051, Gary)212 W 15280 12776 MT (Bjerke \050U. Texas at Austin\051, Greg Small \050UC Berkeley\051, Clark Frazier \050Harvard) 67 W( Bus. Sch.\051, Bob)66 W 15280 13881 MT (Bolch and Steve Blankinship \050Triangle\051, Ron Rusnak \050U. Chicago\051, Roger Fajman and) 19 W( Dale White)20 W 15280 14986 MT (\050NIH\051, Andre Pirard \050U. Liege\051)SH /Times-Italic SF 8280 16091 MT (Language:)SH /Times-Roman SF 15280 XM (IBM 370 Assembler)SH /Times-Italic SF 8280 17196 MT (Documentation:)SH /Times-Roman SF 15280 XM (John Chandler \050CfA\051)SH /Times-Italic SF 8280 18301 MT (Version:)SH /Times-Roman SF 15280 XM (4.0)SH /Times-Italic SF 8280 19406 MT (Date:)SH /Times-Roman SF 15280 XM (1988 February)SH 8280 21798 MT (Kermit-370 is a family of) 344 W( programs implementing the KERMIT file transfer protocol for IBM 370-series)343 W 8280 22994 MT (mainframes \050System/370, 303x, 43xx, 308x, etc.\051 under) 81 W( a variety of operating systems. Kermit-370 operates over)82 W 8280 24190 MT (asynchronous ASCII communication lines attached to 3705-style) 27 W( front ends \050``)26 W /Courier SF (TTY)SH /Times-Roman SF ('' devices\051, to a Series/1 or 4994)26 W 8280 25386 MT (running the Yale ASCII Terminal Communication System or the IBM) 68 W( 7171 ASCII Device Control Unit or a 9370)69 W 8280 26582 MT (with ASCII subsystem \050``)4 W /Courier SF (SERIES1)SH /Times-Roman SF ('' devices\051, or to SNA-type front-ends with) 4 W( graphics pass-through mode, such as)3 W 8280 27778 MT (the MICOM 7400, Datastream/Leedata 8010, and PCI 1076 \050``)18 W /Courier SF (GRAPHICS)SH /Times-Roman SF ('' devices\051,) 18 W( or, in some configurations, to)19 W 8280 28974 MT (an IBM 3708 \050``)19 W /Courier SF (FULLSCREEN)SH /Times-Roman SF ('' device\051. As of this writing, the pending implementation of full 7171) 19 W( compatibility)18 W 8280 30170 MT (in the program product SIM3278 has not been) 146 W( completed. For more details on front-ends, see the section SET)147 W 8280 31366 MT (CONTROLLER.)SH 8280 33758 MT (The source is coded in IBM 370 assembly language and is divided) 37 W( into sections, some generic and some specific to)36 W 8280 34954 MT (an individual operating system. While the details of file-system) 69 W( and supervisor interaction vary widely among the)70 W 8280 36150 MT (systems available for IBM 370's, the basic features are essentially the same.) 33 W( This) 315 W( chapter will describe the features)32 W 8280 37346 MT (common to all variants of Kermit-370, and a separate chapter will deal with) 129 W( the system-specific details for each)130 W 8280 38542 MT (variant.)SH 8280 40934 MT (IBM 370 systems have some peculiarities that users should be aware of.) 154 W( First,) 556 W( they are essentially half-duplex)153 W 8280 42130 MT (systems; the communication line must "turn around" before any data can be sent to it. The ``)127 W /Courier SF (TTY)SH /Times-Roman SF ('' devices) 127 W( are)128 W 8280 43326 MT (strictly half-duplex, and even the ``)174 W /Courier SF (SERIES1)SH /Times-Roman SF ('' and ``)174 W /Courier SF (GRAPHICS)SH /Times-Roman SF ('' devices, although) 174 W( they maintain full-duplex)173 W 8280 44522 MT (communication with the terminal,) 23 W( must transmit a block at a time to the mainframe. The fact that a packet has been)24 W 8280 45718 MT (received from the IBM system through a ``)83 W /Courier SF (TTY)SH /Times-Roman SF ('' device is) 83 W( no guarantee that it is ready for a reply; generally, the)82 W 8280 46914 MT (true indicator of readiness is the) 94 W( line turnaround character \050XON\051, which the operating system sends immediately)95 W 8280 48110 MT (before issuing a read request. On some systems, however, it is possible for Kermit to do away with) 291 W( the)290 W 8280 49306 MT (system-supplied turnaround and schedule read requests immediately after the) 76 W( corresponding writes. It is up to the)77 W 8280 50502 MT (user to tell the other Kermit that it must conform to the requirements of the IBM mainframe.)SH 8280 52894 MT (Second, disk files are encoded using the EBCDIC character set. Consequently, there are three layers of character)87 W 8280 54090 MT (translation on packets exchanged on a ``)75 W /Courier SF (TTY)SH /Times-Roman SF ('' device. For an incoming packet, the outer layer is provided by) 75 W( the)76 W 8280 55286 MT (operating system, which translates) 186 W( all characters from ASCII to EBCDIC. Kermit-370 must then translate the)185 W 8280 56482 MT (packets back to ASCII \050the middle layer\051 in order to calculate and verify the checksum. Data arriving through) 104 W( a)105 W 8280 57678 MT (``)SH /Courier SF (SERIES1)SH /Times-Roman SF ('' or ``)92 W /Courier SF (GRAPHICS)SH /Times-Roman SF ('' device are still in) 92 W( ASCII and therefore bypass the two outer layers. In any case,)91 W 8280 58874 MT (Kermit-370 translates) 144 W( everything finally into EBCDIC \050the inner layer\051 before storing on disk \050except BINARY)145 W 8280 60070 MT (files\051. When) 650 W( Kermit-370 sends a file, the opposite translations occur. In) 200 W( translation, EBCDIC characters not)199 W 8280 61266 MT (representable in ASCII are replaced by nulls.) 63 W( In) 377 W( some cases, several EBCDIC characters are mapped into a single)64 W 8280 62462 MT (ASCII character, but) 305 W( no two 7-bit ASCII characters are translated into the same EBCDIC character. The)304 W 8280 63658 MT (middle-layer tables used by Kermit must be the inverses of the corresponding) 137 W( outer-layer ones used by the host)138 W 8280 64854 MT (operating system if file transfers are to work at all. If necessary,) 24 W( the system programmer should add the appropriate)23 W 8280 66050 MT (SET TATOE/TETOA/TTABLE subcommands \050)15 W /Times-Italic SF (q.v.)SH /Times-Roman SF (\051 to) 281 W( the global ``)16 W /Courier SF (INIT)SH /Times-Roman SF ('' file \050see the next section\051. Indeed, it is)16 W 8280 67246 MT (usually a good idea to set TTABLE ON in the global ``)29 W /Courier SF (INIT)SH /Times-Roman SF ('' file to) 29 W( force using different built-in sets of tables for)28 W 8280 68442 MT (the inner and middle layers, whenever the system has ``)2 W /Courier SF (TTY)SH /Times-Roman SF ('' devices. The standard ASCII-to-EBCDIC translations)3 W 8280 69638 MT (can be found in the Appendix or the IBM System/370 Reference Card.)SH ES %%Page: 176 177 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 176)SH 12 /Times-Bold AF 30852 XM (Kermit User Guide: IBM 370 KERMIT \0508\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (Another distinction of IBM 370's is that they store and retrieve files as records) 75 W( rather than byte streams. Records)74 W 6120 9082 MT (may be either fixed-length with some sort of padding) 114 W( \050as needed\051 or varying-length with some sort of \050generally)115 W 6120 10278 MT (hidden\051 delimiters. Thus, Kermit-370 must assemble incoming data packets into records by stripping off) 89 W( carriage)88 W 6120 11474 MT (return-linefeed pairs \050CRLF's\051 and padding with blanks) 81 W( or truncating as needed and must strip trailing blanks and)82 W 6120 12670 MT (append CRLF's to outgoing records.) 235 W( Further,) 719 W( disk files typically have the records combined into blocks for)234 W 6120 13866 MT (efficiency. One) 370 W( consequence of this) 60 W( form of storage is that files have attributes describing the component records:)61 W 6120 15062 MT (maximum record length \050LRECL\051, record format \050RECFM\051, and sometimes block size \050BLKSIZE\051.)SH 6120 17454 MT (As mentioned before, Kermit-370 is a family of programs. At present, only the CMS and TSO) 210 W( versions are)209 W 6120 18650 MT (operational. Versions) 390 W( for DOS/VSE and MTS have) 70 W( at least reached the "drawing board," but no others have even)71 W 6120 19846 MT (been started. Volunteers are always welcome to port) 44 W( Kermit-370 to other operating systems or add new features to)43 W 6120 21042 MT (the existing family. Anyone interested should) 223 W( first get in touch with the Center for Computing Activities at)224 W 6120 22238 MT (Columbia University to find out what projects of a similar nature are already pending) 259 W( \050and thereby prevent)258 W 6120 23434 MT (unnecessary duplication of effort\051.)SH 14 /Times-Bold AF 6120 27036 MT (8.1. Program Operation)SH 10 /Times-Roman AF 6120 29154 MT (Kermit-370 can be invoked directly or from a command) 307 W( procedure. In either case, it reads and executes)308 W 6120 30350 MT (subcommands sequentially until) 107 W( directed to quit and then returns. A subcommand consists of one or more fields)106 W 6120 31546 MT (\050words\051 separated by spaces.)SH 6120 33938 MT (Upon initial startup, the program looks for two \050optional\051 initialization) 36 W( files, one system-wide and a second specific)37 W 6120 35134 MT (to the user. Both)98 W /Times-Italic SF 13721 XM (filespecs)SH /Times-Roman SF 17513 XM (are, of course, system-dependent. The purpose of these files is to allow Kermit to) 98 W( be)97 W 6120 36330 MT (customized for a particular system and for a) 230 W( user's specific settings without changing the source code. The)231 W 6120 37526 MT (system-wide file, which) 23 W( is maintained by a systems programmer, should contain Kermit subcommands that all users)22 W 6120 38722 MT (would need to issue in order for Kermit to run on the system, such as) 42 W( subcommands to modify the ASCII/EBCDIC)43 W 6120 39918 MT (tables used by Kermit-370. The user-specific file, if any, should contain subcommands that the user generally issues)5 W 6120 41114 MT (every time Kermit is run.) 30 W( Kermit-370) 312 W( executes any subcommands found in these files as though they were typed at)31 W 6120 42310 MT (the terminal. Here is a sample ``)SH /Courier SF (INIT)SH /Times-Roman SF ('' file:)SH /Courier SF 8520 43965 MT (* Asterisk in column one is a comment.)SH 8520 44996 MT (set debug on)SH 8520 46027 MT (set warning on)SH 8520 47058 MT (set block 3)SH /Times-Roman SF 6120 49450 MT (During interactive execution, you may use the built-in help feature while) 167 W( typing Kermit-370 subcommands. A)166 W 6120 50646 MT (question mark \050"?"\051 typed at almost any point in a subcommand, followed by a carriage return, produces a) 123 W( brief)124 W 6120 51842 MT (description of what is expected or possible at that point. Moreover, mistyping a subcommand will generally produce)SH 6120 53038 MT (a helpful) 42 W( error message or a list of possible options at the point of error. Keywords in such lists are displayed with)43 W 6120 54234 MT (the minimum-length abbreviation in upper case and the remainder, if any, in lower case. In entering) 211 W( Kermit)210 W 6120 55430 MT (subcommands, any keyword may be shortened to any substring that contains the minimum abbreviation.)SH 14 /Times-Bold AF 6120 59032 MT (8.2. Kermit-370 Subcommands)SH 10 /Times-Roman AF 6120 61150 MT (The following is a brief summary) 135 W( of Kermit subcommands. The starred subcommands can be issued as remote)136 W 6120 62346 MT (Kermit commands to Kermit-370 when) 84 W( it is in server mode. System-specific subcommands are omitted from this)83 W 6120 63542 MT (list.)SH 13120 65152 MT (BYE)SH 16700 XM (logs out other Kermit server.)SH 12787 66257 MT (CWD)SH (*)SH 16700 XM (establishes a new working directory.)SH 9398 67362 MT (DIRECTORY)SH (*)SH 16700 XM (displays all or part of the disk directory.)SH 12398 68467 MT (ECHO)SH 16700 XM (a line back to the user.)SH 12843 69572 MT (EXIT)SH 16700 XM (from Kermit-370.)SH 11898 70677 MT (FINISH)SH 16700 XM (other Kermit server.)SH 13176 71782 MT (GET)SH 16700 XM (file\050s\051 from a Kermit server.)SH ES %%Page: 177 178 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (8.2. Kermit-370 Subcommands)SH 10 /Times-Italic AF 51275 XM (Page 177)SH 46800 50 8280 5709 UL /Times-Roman SF 14780 7886 MT (HELP)SH 18860 XM (about Kermit-370.)SH 14669 8991 MT (HOST)SH (*)SH 18860 XM (executes a system command.)SH 13447 10096 MT (KERMIT)SH (*)SH 18860 XM (executes a Kermit subcommand.)SH 14892 11201 MT (QUIT)SH 18860 XM (from Kermit-370.)SH 13058 12306 MT (RECEIVE)SH 18860 XM (file\050s\051 from other Kermit.)SH 14669 13411 MT (SEND)SH 18860 XM (file\050s\051 to other Kermit.)SH 13446 14516 MT (SERVER)SH 18860 XM (mode of remote operation.)SH 15502 15621 MT (SET)SH (*)SH 18860 XM (various parameters.)SH 14336 16726 MT (SHOW)SH (*)SH 18860 XM (various parameters.)SH 14168 17831 MT (SPACE)SH (*)SH 18860 XM (displays disk storage allocation.)SH 13502 18936 MT (STATUS)SH (*)SH 18860 XM (inquiry.)SH 14614 20041 MT (TAKE)SH (*)SH 18860 XM (subcommands from file.)SH 13780 21146 MT (TDUMP)SH (*)SH 18860 XM (dumps the contents of a table.)SH 14780 22251 MT (TYPE)SH (*)SH 18860 XM (a file.)SH 13836 23356 MT (XECHO)SH 18860 XM (echoes a line \050transparently\051.)SH 14058 24461 MT (XTYPE)SH 18860 XM (displays a file \050transparently\051.)SH 8280 26853 MT (Although Kermit-370 is) 72 W( generally a remote Kermit, it has the capability of communicating with another Kermit in)73 W 8280 28049 MT (server mode. In that situation, the subcommand) 138 W( prefixes REMOTE and LOCAL refer to the Kermit server and)137 W 8280 29245 MT (Kermit-370, respectively, even when Kermit-370 is, strictly speaking, the remote) 146 W( Kermit. Any replies from the)147 W 8280 30441 MT (Kermit server are added to a disk file \050whose)75 W /Times-Italic SF 27200 XM (filespec)SH /Times-Roman SF 30580 XM (is, of course, system-dependent\051. Such a) 75 W( transaction can be)74 W 8280 31637 MT (carried out, for example, under control of a TAKE file if Kermit-370 is not operating locally. If the) 4 W( local Kermit has)5 W 8280 32833 MT (a "magic" character sequence that switches it from) 59 W( terminal emulation to server mode, then an entire session could)58 W 8280 34029 MT (be controlled from the mainframe, possibly in response to a single command issued by a naive user. For example,)SH /Courier SF 10680 35684 MT (grab)SH 2400 50 10680 35884 UL /Times-Italic SF 13680 37399 MT (Kermit-370 is invoked and executes the following TAKE file)SH /Courier SF 10680 39114 MT (ECHO Serve Me!)SH /Times-Italic SF 23880 XM (the local Kermit switches to server mode)SH /Courier SF 10680 40145 MT (GET file.a)SH /Times-Italic SF 23880 XM (the server uploads file.a)SH /Courier SF 10680 41176 MT (FINISH)SH /Times-Italic SF 23880 XM (the server switches back to terminal mode)SH /Times-Roman SF 8280 43568 MT (The remainder of) 41 W( this section concentrates on the subcommands that have special form or meaning for Kermit-370,)42 W 8280 44764 MT (but neglects those with highly system-dependent syntax or use.)SH 13 /Times-Bold AF 24708 48123 MT (The SEND Subcommand)SH 10 /Times-Roman AF 8280 50496 MT (Syntax:)SH /Courier SF 11586 XM (SEND [)SH /Times-Italic SF (filespec)SH /Courier SF 18841 XM ([)SH /Times-Italic SF (foreign-filespec)SH /Courier SF (]])SH /Times-Roman SF 8280 52888 MT (The SEND subcommand) 112 W( tells Kermit-370 to send a file or file group to the other Kermit. If no such file exists,)111 W 8280 54084 MT (Kermit-370 simply displays an) 49 W( error message and issues another prompt. If one or more files are sent, their names)50 W 8280 55280 MT (are recorded in memory) 55 W( and may be viewed later via the TDUMP subcommand \050but with no indication of whether)54 W 8280 56476 MT (any of them were rejected or cancelled by the other Kermit\051. If this subcommand is issued without any arguments,)44 W 8280 57672 MT (Kermit-370 will prompt the user for both native and foreign)34 W /Times-Italic SF 32839 XM (filespecs)SH /Times-Roman SF 36566 XM (\050and will insist on getting the former, but will)33 W 8280 58868 MT (do without the latter\051.)SH 8280 61260 MT (When Kermit-370 sends files) 40 W( using long packets \050longer than 96\051, the throughput is especially sensitive to the level)41 W 8280 62456 MT (of noise on the line because retries are so time-consuming. Therefore, Kermit-370 adds) 19 W( an extra, heuristic size limit)18 W 8280 63652 MT (for packets when retries have been found necessary.) 13 W( When) 277 W( that is the case, after every 20 packets, Kermit computes)14 W 8280 64848 MT (the packet size for maximum throughput assuming that the transmission errors) 536 W( were due to sparse,)535 W 8280 66044 MT (Poisson-distributed noise bursts.) 53 W( The) 358 W( result of this calculation is then used as another limit on the size of outgoing)54 W 8280 67240 MT (packets besides the one specified by the other Kermit. If no retries) 2 W( are required, then Kermit-370 assumes the line to)1 W 8280 68436 MT (be noiseless and sends packets of the maximum length the other Kermit allows. For more) 124 W( details on the SEND)125 W 8280 69632 MT (subcommand syntax and operation, see the chapter on the desired system-specific version of Kermit-370.)SH ES %%Page: 178 179 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 178)SH 12 /Times-Bold AF 29952 XM (Kermit User Guide: IBM 370 KERMIT \0508.2\051)SH 46800 50 6120 5709 UL 13 SS 21320 8071 MT (The RECEIVE Subcommand)SH 10 /Times-Roman AF 6120 10444 MT (Syntax:)SH /Courier SF 9426 XM (RECEIVE [)SH /Times-Italic SF (filespec)SH /Courier SF (])SH /Times-Roman SF 6120 12836 MT (The RECEIVE subcommand tells Kermit-370 to accept a file) 50 W( or file group. The user must issue the corresponding)49 W 6120 14032 MT (SEND subcommand to the other Kermit. Under some circumstances, the records of the) 134 W( received file\050s\051 may be)135 W 6120 15228 MT (truncated; when this happens, Kermit does not stop, but notes the fact as an error \050unless something more serious)88 W 6120 16424 MT (happens later\051.) 10 W( For) 272 W( more details on the RECEIVE subcommand syntax and operation, see the chapter on the desired)11 W 6120 17620 MT (system-specific version of Kermit-370.)SH 13 /Times-Bold AF 22910 20979 MT (The GET Subcommand)SH 10 /Times-Roman AF 6120 23352 MT (Syntax:)SH /Courier SF 9426 XM (GET [)SH /Times-Italic SF (foreign-filespec)SH /Courier SF 19303 XM ([)SH /Times-Italic SF (filespec)SH /Courier SF (]])SH /Times-Roman SF 6120 25744 MT (The GET subcommand tells) 37 W( Kermit to request a file or file group from the other system, which must have a Kermit)36 W 6120 26940 MT (running in server mode. Provided the other Kermit complies, the) 23 W( effect is the same as if SEND)24 W /Times-Italic SF 44925 XM (foreign-filespec)SH /Times-Roman SF 51476 XM (had)SH 6120 28136 MT (been issued directly to the other Kermit and RECEIVE [)327 W /Times-Italic SF (filespec)SH /Times-Roman SF (] to Kermit-370. other Kermit\051.) 327 W( If) 902 W( this)326 W 6120 29332 MT (subcommand is issued without) 13 W( any arguments, Kermit-370 will prompt the user for both foreign and native)14 W /Times-Italic SF 49476 XM (filespecs)SH /Times-Roman SF 6120 30528 MT (\050and will insist on getting the former, but will do without the latter\051. See the respective SEND and) 152 W( RECEIVE)151 W 6120 31724 MT (subcommands for a description of the each)SH /Times-Italic SF 23533 XM (filespec)SH /Times-Roman SF (.)SH 13 /Times-Bold AF 22440 35083 MT (The TAKE Subcommand)SH 10 /Times-Roman AF 6120 37456 MT (Syntax:)SH /Courier SF 9426 XM (TAKE)SH /Times-Italic SF 12426 XM (filespec)SH /Times-Roman SF 6120 39848 MT (Execute Kermit subcommands from the specified file, usually called) 140 W( a TAKE file. The TAKE file may in turn)141 W 6120 41044 MT (include TAKE subcommands to a nesting depth of ten. If a TAKE file includes) 206 W( the subcommand SERVER,)205 W 6120 42240 MT (however, the nesting) 84 W( count starts over again in server mode. The user has the option of seeing the subcommands)85 W 6120 43436 MT (echoed from the TAKE file as they are executed and also the option of automatically exiting from a TAKE) 60 W( file on)59 W 6120 44632 MT (error. See) 250 W( the subcommand SET TAKE for details.)SH 13 /Times-Bold AF 21645 47991 MT (The SERVER Subcommand)SH 10 /Times-Roman AF 6120 50364 MT (Kermit-370 is capable of acting as a server. In server) 92 W( mode, Kermit-370 can send and receive files, execute host)93 W 6120 51560 MT (commands, execute a restricted set of Kermit subcommands,) 136 W( and perform a variety of generic Kermit functions.)135 W 6120 52756 MT (The following list) 151 W( shows the typical local Kermit commands along with the server functions they elicit. When)152 W 6120 53952 MT (Kermit-370 is talking to another Kermit running in server mode, these same) 22 W( subcommands may be used in the other)21 W 6120 55148 MT (direction.)SH 6120 56758 MT (BYE)SH 20520 XM (log out the Kermit server.)SH 6120 57863 MT (FINISH)SH 20520 XM (server mode.)SH 6120 58968 MT (GET)SH 20520 XM (a file or files from the server.)SH 6120 60073 MT (REMOTE)SH 6620 61178 MT (COPY)SH 20520 XM (a file or files.)SH 6620 62283 MT (CWD)SH 20520 XM (set new working directory.)SH 6620 63388 MT (DIRECTORY)SH 20520 XM (display file attributes.)SH 6620 64493 MT (ERASE)SH 20520 XM (a file or files.)SH 6620 65598 MT (HELP)SH 20520 XM (display this command summary.)SH 6620 66703 MT (HOST)SH 20520 XM (execute a system command.)SH 6620 67808 MT (KERMIT)SH 20520 XM (execute a Kermit-370 subcommand.)SH 6620 68913 MT (RENAME)SH 20520 XM (a file or files.)SH 6620 70018 MT (SPACE)SH 20520 XM (display disk space.)SH 6620 71123 MT (TYPE)SH 20520 XM (a file.)SH ES %%Page: 179 180 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (8.2. Kermit-370 Subcommands)SH 10 /Times-Italic AF 51275 XM (Page 179)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (SEND)SH 22680 XM (a file or files to the server.)SH 8280 10278 MT (If your local Kermit does not support the REMOTE KERMIT command,) 24 W( you may need to issue SET subcommands)25 W 8280 11474 MT (to select various options) 40 W( before typing the SERVER subcommand. Once in server mode, Kermit-370 will await all)39 W 8280 12670 MT (further instructions from the user Kermit on the other end of the) 99 W( connection until a FINISH or BYE command is)100 W 8280 13866 MT (given.)SH 8280 16258 MT (Command execution in server mode is different in some respects from normal operation. First of all, some) 51 W( Kermit)50 W 8280 17454 MT (subcommands are not allowed) 130 W( \050see the list at the beginning of this section\051. Moreover, command errors always)131 W 8280 18650 MT (terminate any active TAKE file. Also, all commands will be run in the special environment that Kermit sets) 117 W( up)116 W 8280 19846 MT (during protocol transfers. Among other) 9 W( things, Kermit intercepts all terminal I/O \050if possible\051 in this environment in)10 W 8280 21042 MT (order to transmit the data to the local Kermit as text packets.)SH 8280 23434 MT (Note that) 7 W( some operations can be requested by several different commands. If for example, the IBM 370 system has)6 W 8280 24630 MT (a command ``)29 W /Courier SF (PRT)SH /Times-Roman SF ('' for displaying a file, a) 29 W( user interacting with a Kermit-370 server can choose to display a file by)30 W 8280 25826 MT (issuing any of) 165 W( the commands: REMOTE TYPE, REMOTE HOST PRT, REMOTE KERMIT TYPE, REMOTE)164 W 8280 27022 MT (KERMIT HOST PRT, or \050if SYSCMD has been set ON\051 REMOTE KERMIT PRT. The first form) 26 W( simply transfers)27 W 8280 28218 MT (the requested file as text, but the others invoke the ``)169 W /Courier SF (PRT)SH /Times-Roman SF ('' command with) 169 W( any specified options, intercept the)168 W 8280 29414 MT (terminal output, and return the results to the local Kermit.)SH 13 /Times-Bold AF 25214 32773 MT (The SET Subcommand)SH 10 /Times-Roman AF 8280 35146 MT (Syntax:)SH /Courier SF 11586 XM (SET)SH /Times-Italic SF 13986 XM (parameter)SH /Courier SF 18752 XM ([)SH /Times-Italic SF (value)SH /Courier SF (])SH /Times-Roman SF 8280 37538 MT (The SET) 20 W( subcommand establishes or modifies various parameters controlling file transfers. The values can, in turn,)21 W 8280 38734 MT (be examined with the SHOW subcommand. Some parameters have two) 231 W( levels. In particular, there are two)230 W 8280 39930 MT (matching lists of) 114 W( SEND and RECEIVE sub-parameters corresponding to the values exchanged by Kermits in the)115 W 8280 41126 MT (Send-Init/ACK sequence. For each) 62 W( of these SEND/RECEIVE pairs one element is encoded in outgoing parameter)61 W 8280 42322 MT (packets, and the other is decoded from incoming ones. Setting the latter by) 15 W( hand may be needed to establish contact)16 W 8280 43518 MT (and also has the effect of redefining the default value for decoding from) 53 W( subsequent parameter packets. Generally,)52 W 8280 44714 MT (the distinction between SEND) 168 W( and RECEIVE parameters is unambiguous, the only exception being TIMEOUT)169 W 8280 45910 MT (\050q.v.\051. The) 250 W( following SET subcommands are available in Kermit-370:)SH 8280 47520 MT (APPEND)SH 22680 XM (Append if file name collision.)SH 8280 48625 MT (ATOE)SH 22680 XM (Modify the Kermit-370 ASCII-to-EBCDIC table.)SH 8280 49730 MT (BLOCK-CHECK)SH 22680 XM (Level of error checking for file transfer.)SH 8280 50835 MT (CONTROLLER)SH 22680 XM (Indicate type of terminal connection.)SH 8280 51940 MT (DEBUG)SH 22680 XM (Log packet traffic during file transfer.)SH 8280 53045 MT (DELAY)SH 22680 XM (Length of pause before a SEND subcommand.)SH 8280 54150 MT (EOF)SH 22680 XM (Text file truncation at CTRL-Z.)SH 8280 55255 MT (ETOA)SH 22680 XM (Modify the Kermit-370 EBCDIC-to-ASCII table.)SH 8280 56360 MT (FILE)SH 22680 XM (Attributes for incoming or outgoing files...)SH 8780 57465 MT (TYPE)SH 22680 XM (... text or binary.)SH /Times-Italic SF 8780 58570 MT (other)SH /Times-Roman SF 22680 XM (... system-specific attributes.)SH 8280 59675 MT (FOREIGN)SH 22680 XM (Strings added to outgoing filespec...)SH 8780 60780 MT (PREFIX)SH 8780 61885 MT (SUFFIX)SH 8280 62990 MT (INCOMPLETE)SH 22680 XM (Determine the action on an aborted file transfer.)SH 8280 64095 MT (LINE)SH 22680 XM (Specify alternate communication line.)SH 8280 65200 MT (MARGIN)SH 22680 XM (for sending files...)SH 8780 66305 MT (LEFT)SH 8780 67410 MT (RIGHT)SH 8280 68515 MT (PARITY)SH 22680 XM (Indicate if 7-bit or 8-bit data.)SH 8280 69620 MT (RETRY)SH 22680 XM (Maximum retry count...)SH 8780 70725 MT (INIT)SH 22680 XM (... for initial packet exchange.)SH 8780 71830 MT (PACKET)SH 22680 XM (... per packet for ongoing transfer.)SH ES %%Page: 180 181 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 180)SH 12 /Times-Bold AF 29952 XM (Kermit User Guide: IBM 370 KERMIT \0508.2\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (SYSCMD)SH 20520 XM (Try apparently invalid Kermit subcommands on host system.)SH 6120 8991 MT (TABS-EXPAND)SH 20520 XM (Determine tab-to-space conversion on reception.)SH 6120 10096 MT (TAKE)SH 6620 11201 MT (ECHO)SH 20520 XM (Echo subcommands read from TAKE files.)SH 6620 12306 MT (ERROR-ACTION)SH 20520 XM (Exit from TAKE file on command error.)SH 6120 13411 MT (TEST)SH 20520 XM (Facilitate testing of Kermit.)SH 6120 14516 MT (TATOE)SH 20520 XM (Modify the Kermit-370 ASCII-to-EBCDIC table.)SH 6120 15621 MT (TETOA)SH 20520 XM (Modify the Kermit-370 EBCDIC-to-ASCII table.)SH 6120 16726 MT (TTABLE)SH 20520 XM (Determine which tables undo the terminal translation.)SH 6120 17831 MT (WARNING)SH 20520 XM (Rename if filename collision.)SH 6120 18936 MT (8-BIT-QUOTE)SH 20520 XM (Determine state of 8th-bit prefixing.)SH 6120 20041 MT (SEND or RECEIVE)SH 6620 21146 MT (END-OF-LINE)SH 20520 XM (Packet terminator.)SH 6620 22251 MT (PACKET-SIZE)SH 20520 XM (Maximum packet size.)SH 6620 23356 MT (PAD-CHAR)SH 20520 XM (Character to insert before each packet.)SH 6620 24461 MT (PADDING)SH 20520 XM (Number of pad characters to insert.)SH 6620 25566 MT (QUOTE)SH 20520 XM (Use to quote control characters in packets.)SH 6620 26671 MT (START-OF-PACKET)SH 20520 XM (Packet beginning marker.)SH 6620 27776 MT (TIMEOUT)SH 20520 XM (Time limit for response.)SH 12 /Times-Bold AF 6120 30364 MT (SET APPEND)SH 10 /Times-Roman AF 6120 31778 MT (Syntax:)SH /Courier SF 9426 XM (SET APPEND ON)SH /Times-Italic SF 17826 XM (or)SH /Courier SF 19315 XM (OFF)SH /Times-Roman SF 6120 33569 MT (ON)SH 10120 XM (If an) 78 W( incoming file has the same name as an existing one, the new file is appended to the old one. This)77 W 10120 34674 MT (option supersedes SET WARNING.)SH 6120 36332 MT (OFF)SH 10120 XM (Filename collision is handled according to the WARNING parameter. \050Default.\051)SH 12 /Times-Bold AF 6120 38920 MT (SET ATOE etc.)SH 10 /Times-Roman AF 6120 40334 MT (Syntax:)SH /Courier SF 9426 XM (SET)SH /Times-Italic SF 11826 XM (table)SH /Courier SF 14426 XM ([)SH /Times-Italic SF (num1 num2)350 W /Courier SF (])SH /Times-Roman SF 6120 42726 MT (This modifies one of the ASCII/EBCDIC) 93 W( translation tables used by Kermit-370 \050for example, to conform to your)94 W 6120 43922 MT (system\051. The) 496 W( valid table names are ATOE, ETOA, TATOE, and TETOA. The arguments) 123 W( are, respectively, the)122 W 6120 45118 MT (offset within the named table and the new value for that offset. If the arguments are omitted, the table) 24 W( is restored to)25 W 6120 46314 MT (its initial arrangement. Both)95 W /Times-Italic SF 18317 XM (num1)SH /Times-Roman SF 20884 XM (and)SH /Times-Italic SF 22673 XM (num2)SH /Times-Roman SF 25240 XM (should be) 95 W( in the range 0-255 \050decimal\051. For example, in ATOE or)94 W 6120 47510 MT (TATOE, the offset is the ASCII character code, and the new value) 15 W( is the new EBCDIC result code. Initially, ATOE)16 W 6120 48706 MT (and TATOE each contain two identical copies of the 7-bit ASCII character table. Note: the meaning) 72 W( of the tables)71 W 6120 49902 MT (depends on the TTABLE setting -- if TTABLE is OFF, the TATOE and TETOA tables are not used.)SH 12 /Times-Bold AF 6120 52490 MT (SET BLOCK-CHECK)SH 10 /Times-Roman AF 6120 53904 MT (Syntax:)SH /Courier SF 9426 XM (SET BLOCK-CHECK)SH /Times-Italic SF 19026 XM (number)SH /Times-Roman SF 6120 56296 MT (This determines the type of block check used during file transfer, provided the) 60 W( other Kermit agrees. Valid options)61 W 6120 57492 MT (for)SH /Times-Italic SF 7666 XM (number)SH /Times-Roman SF 11101 XM (are: 1 \050for a one-character checksum\051, 2 \050for a two-character checksum\051 and 3 \050for a) 130 W( three-character)129 W 6120 58688 MT (CRC\051. This) 250 W( is one of only two Send-Init parameters that cannot be SET separately for SEND and RECEIVE.)SH 12 /Times-Bold AF 6120 61276 MT (SET CONTROLLER)SH 10 /Times-Roman AF 6120 62690 MT (Syntax:)SH /Courier SF 9426 XM (SET CONTROLLER)SH /Times-Italic SF 18426 XM (type)SH /Times-Roman SF 6120 65082 MT (The)SH /Times-Italic SF 8006 XM (type)SH /Times-Roman SF 10003 XM (may be TTY, SERIES1, GRAPHICS, or FULLSCREEN. Kermit-370 automatically determines) 81 W( whether)82 W 6120 66278 MT (you are connected via a Series/1 \050or similar\051 emulation controller or) 107 W( a TTY line. This subcommand is provided,)106 W 6120 67474 MT (though, to allow that choice to be superseded, and because) 261 W( Kermit may not be able to distinguish between)262 W 6120 68670 MT (Series/1-type and) 193 W( other 3270-emulation controllers. When CONTROLLER is set to SERIES1 or GRAPHICS,)192 W 6120 69866 MT (Kermit disables the 3270 protocol conversion function by putting the) 100 W( terminal controller into "transparent mode",)101 W 6120 71062 MT (which allows Kermit packets to pass through intact.)SH ES %%Page: 181 182 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (8.2. Kermit-370 Subcommands)SH 10 /Times-Italic AF 51275 XM (Page 181)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (SET DEBUG)SH 10 /Times-Roman AF 8280 9418 MT (Syntax:)SH /Courier SF 11586 XM (SET DEBUG ON)SH /Times-Italic SF 19386 XM (or)SH /Courier SF 20875 XM (RAW)SH /Times-Italic SF 23275 XM (or)SH /Courier SF 24764 XM (OFF)SH /Times-Roman SF 8280 11209 MT (ON)SH 12280 XM (Keep a journal of all packets sent and received in a log file on disk. If the file already exists,) 51 W( it is erased)50 W 12280 12314 MT (and overwritten. The)189 W /Times-Italic SF 21895 XM (filespec)SH /Times-Roman SF 25389 XM (of the) 189 W( log is, of course, system-dependent. All packets are logged in)190 W 12280 13419 MT (EBCDIC for legibility, even when CONTROLLER is set to SERIES1 or GRAPHICS. In addition to) 57 W( the)56 W 12280 14524 MT (packets themselves, which are labelled "S" or "R") 191 W( for packets sent or received, the log includes any)192 W 12280 15629 MT (additional status information \050labelled "A"\051, such as the AID returned by a SERIES1 device.)SH 8280 17287 MT (RAW)SH 12280 XM (The same as ON, but packets are logged in the form that is) 81 W( passed to or from the operating system, i.e.,)80 W 12280 18392 MT (EBCDIC for TTY terminals, and ASCII for SERIES1 and GRAPHICS terminals.)SH 8280 20050 MT (OFF)SH 12280 XM (Stop logging packets and close the the log file. \050Default.\051)SH 12 /Times-Bold AF 8280 22638 MT (SET DELAY)SH 10 /Times-Roman AF 8280 24052 MT (Syntax:)SH /Courier SF 11586 XM (SET DELAY)SH /Times-Italic SF 17586 XM (number)SH /Times-Roman SF 8280 26444 MT (Normally, Kermit-370 waits 10 seconds after the SEND subcommand before starting the) 5 W( transfer, but this delay may)6 W 8280 27640 MT (be SET to any non-negative value. Two DELAY values have special meaning. When DELAY) 148 W( is 1, the usual)147 W 8280 28836 MT (two-line greeting displayed during protocol mode is abbreviated to a short message \050the default Kermit prompt) 26 W( with)27 W 8280 30032 MT (three dots...\051, and when DELAY is 0, the greeting is suppressed entirely, along with the extra one-second pause) 45 W( for)44 W 8280 31228 MT (the RECEIVE and SERVER subcommands.)SH 12 /Times-Bold AF 8280 33816 MT (SET EOF)SH 10 /Times-Roman AF 8280 35230 MT (Syntax:)SH /Courier SF 11586 XM (SET EOF ON)SH /Times-Italic SF 18186 XM (or)SH /Courier SF 19675 XM (OFF)SH /Times-Roman SF 8280 37021 MT (ON)SH 12280 XM (Scan each incoming TEXT file for the first) 101 W( occurrence of CTRL-Z and ignore the remainder of the file)102 W 12280 38126 MT (\050but continue decoding up to the actual end of the file\051. BINARY files are not affected.)SH 8280 39784 MT (OFF)SH 12280 XM (Accept incoming files in their entirety. \050Default.\051)SH 12 /Times-Bold AF 8280 42372 MT (SET FILE TYPE)SH 10 /Times-Roman AF 8280 43786 MT (Syntax:)SH /Courier SF 11586 XM (SET FILE TYPE TEXT)SH /Times-Italic SF 22986 XM (or)SH /Courier SF 24475 XM (BINARY)SH /Times-Italic SF 28675 XM (or)SH /Courier SF 30164 XM (V-BINARY)SH /Times-Italic SF 35564 XM (or)SH /Courier SF 37053 XM (D-BINARY)SH /Times-Roman SF 8280 45577 MT (TEXT)SH 13780 XM (Specifies ordinary text.) 3 W( ASCII-to-EBCDIC) 255 W( or EBCDIC-to-ASCII translation is performed on the data.)2 W 13780 46682 MT (Trailing blanks are removed, and CRLF's are appended to outgoing records. CRLF's) 22 W( are used, in turn,)23 W 13780 47787 MT (to determine the) 100 W( end of incoming records, which are padded with blanks if necessary to fill buffers.)99 W 13780 48892 MT (\050Default.\051)SH 8280 50550 MT (BINARY)SH 13780 XM (Specifies bit-stream) 38 W( data. No translation is performed, no CRLF's are added to outgoing records, and)39 W 13780 51655 MT (blanks are neither added) 103 W( nor removed. Incoming bytes are added successively to the current record)102 W 13780 52760 MT (buffer, which is written out when the current LRECL is reached. Padding, if necessary,) 62 W( is done with)63 W 13780 53865 MT (nulls.)SH 8280 55523 MT (V-BINARY)SH 13780 XM (Specifies varying-length-record binary data. This type is like BINARY, except that a) 34 W( two-byte binary)33 W 13780 56628 MT (prefix is added to each outgoing record giving the number of data bytes, and incoming records are set)41 W 13780 57733 MT (off by \050and stripped of\051 their prefixes on receipt.)SH 8280 59391 MT (D-BINARY)SH 13780 XM (Is like V-BINARY except that the length prefixes) 3 W( are five-byte ASCII-encoded decimal \050right-justified)2 W 13780 60496 MT (with leading zeroes\051.)SH 12 /Times-Bold AF 8280 63084 MT (SET FOREIGN)SH 10 /Times-Roman AF 8280 64498 MT (Syntax:)SH /Courier SF 11586 XM (SET FOREIGN PREFIX)SH /Times-Italic SF 22986 XM (string)SH /Times-Roman SF 8280 66890 MT (This defines a prefix string to) 11 W( be added to the outgoing)12 W /Times-Italic SF 30599 XM (filespec)SH /Times-Roman SF 33916 XM (generated by the SEND subcommand. For example,)12 W 8280 68086 MT (the string might be set to ``)29 W /Courier SF (B:)SH /Times-Roman SF ('' to specify output to the B disk drive on) 29 W( the other Kermit's system. The default is a)28 W 8280 69282 MT (null string. There is also a FOREIGN SUFFIX handled in the same manner.)SH ES %%Page: 182 183 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 182)SH 12 /Times-Bold AF 29952 XM (Kermit User Guide: IBM 370 KERMIT \0508.2\051)SH 46800 50 6120 5709 UL 6120 8004 MT (SET HANDSHAKE)SH 10 /Times-Roman AF 6120 9418 MT (Syntax:)SH /Courier SF 9426 XM (SET HANDSHAKE)SH /Times-Italic SF 17826 XM (number)SH /Times-Roman SF 6120 11810 MT (This defines) 4 W( the character, if any, that Kermit-370 should send \050or cause to be sent\051 immediately before reading each)5 W 6120 13006 MT (packet. The) 274 W( character is) 12 W( given as the decimal of an ASCII control character, or as zero if no handshake is to be sent.)11 W 6120 14202 MT (The default is 17 \050XON\051, and any value in the range 0-31 is valid, but 13 \050CR\051 should not be used) 111 W( because it is)112 W 6120 15398 MT (generally the end-of-packet character. When Kermit-370 is running through a full-duplex connection \050such) 132 W( as a)131 W 6120 16594 MT (``)SH /Courier SF (SERIES1)SH /Times-Roman SF (''\051, the traditional IBM handshaking is not necessary, and HANDSHAKE should be set) 37 W( to 0 \050as long as)38 W 6120 17790 MT (the other Kermit can be instructed not to expect a handshake\051. Note the distinction between)53 W /Courier SF 43988 XM (SET HANDSHAKE)52 W /Times-Roman SF 52142 XM (in)SH 6120 18986 MT (Kermit-370 \050where it defines a character to be sent\051 and) 54 W( in many micro Kermits \050where it defines a character to be)55 W 6120 20182 MT (expected\051.)SH 12 /Times-Bold AF 6120 22770 MT (SET INCOMPLETE)SH 10 /Times-Roman AF 6120 24184 MT (Syntax:)SH /Courier SF 9426 XM (SET INCOMPLETE DISCARD)SH /Times-Italic SF 23226 XM (or)SH /Courier SF 24715 XM (KEEP)SH /Times-Roman SF 6120 25975 MT (DISCARD)SH 11120 XM (Specifies that incomplete) 214 W( files \050that is, files partially received in a transfer cancelled by the other)213 W 11120 27080 MT (Kermit\051 are to be erased. This is the) 115 W( default. Note that when APPEND is ON, incomplete files are)116 W 11120 28185 MT (never erased, lest pre-existing data be lost.)SH 6120 29843 MT (KEEP)SH 11120 XM (Specifies that incomplete files are to be kept.)SH 12 /Times-Bold AF 6120 32431 MT (SET LINE)SH 10 /Times-Roman AF 6120 33845 MT (Syntax:)SH /Courier SF 9426 XM (SET LINE [)SH /Times-Italic SF (name)SH /Courier SF (])SH /Times-Roman SF 6120 36237 MT (This specifies an alternate communication line for file transfers. If the)53 W /Times-Italic SF 35222 XM (name)SH /Times-Roman SF 37691 XM (is omitted, the) 53 W( default line \050the user's)52 W 6120 37433 MT (terminal\051 is used. The format of)106 W /Times-Italic SF 20082 XM (name)SH /Times-Roman SF 22604 XM (is, of course, system-dependent, and some versions of Kermit-370 do not)107 W 6120 38629 MT (support any alternate lines. No version currently allows Kermit-370 to CONNECT over an alternate line.)SH 12 /Times-Bold AF 6120 41217 MT (SET MARGIN)SH 10 /Times-Roman AF 6120 42631 MT (Syntax:)SH /Courier SF 9426 XM (SET MARGIN)SH /Times-Italic SF 16026 XM (side column)350 W /Times-Roman SF 6120 45023 MT (When Kermit-370 sends a) 1 W( text file, each line may be truncated on the left or right \050or both\051 at fixed column numbers.)SH 6120 46219 MT (Only the text from the left margin to the right margin \050inclusive\051 will be sent, and) 1 W( any trailing blanks in the truncated)2 W 6120 47415 MT (lines will be stripped. A value of zero for either margin disables truncation on that side.)SH 12 /Times-Bold AF 6120 50003 MT (SET PARITY)SH 10 /Times-Roman AF 6120 51417 MT (Syntax:)SH /Courier SF 9426 XM (SET PARITY MARK)SH /Times-Italic SF 19026 XM (or)SH /Courier SF 20515 XM (NONE)SH /Times-Roman SF 6120 53809 MT (Transparent-mode ASCII) 43 W( data received from a ``)42 W /Courier SF (SERIES1)SH /Times-Roman SF ('' or ``)42 W /Courier SF (GRAPHICS)SH /Times-Roman SF ('' device will typically have either all)42 W 6120 55005 MT (Mark parity \050seven) 3 W( data bits with the eighth bit set\051 or no parity \050eight data bits\051. Kermit-370 must know which kind)4 W 6120 56201 MT (of parity to expect in order to calculate checksums) 64 W( properly. Since Kermit-370 does not actually verify parity, the)63 W 6120 57397 MT (other possible variants \050ODD, EVEN, and SPACE\051 are lumped together with MARK parity for the purpose) 62 W( of this)63 W 6120 58593 MT (subcommand, which merely chooses between 7-bit and 8-bit data transfer. The default is MARK.)SH 12 /Times-Bold AF 6120 61181 MT (SET PROMPT)SH 10 /Times-Roman AF 6120 62595 MT (Syntax:)SH /Courier SF 9426 XM (SET PROMPT)SH /Times-Italic SF 16026 XM (string)SH /Times-Roman SF 6120 64987 MT (This defines the character string that Kermit-370 displays when asking for a subcommand. The prompt may) 28 W( be any)27 W 6120 66183 MT (string of up to 20 characters. The default is the name of the system-specific version of Kermit-370) 75 W( followed by a)76 W 6120 67379 MT (">" sign, e.g.,)SH /Courier SF 11861 XM (Kermit-CMS>)SH /Times-Roman SF (.)SH ES %%Page: 183 184 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (8.2. Kermit-370 Subcommands)SH 10 /Times-Italic AF 51275 XM (Page 183)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (SET RETRY)SH 10 /Times-Roman AF 8280 9418 MT (Syntax:)SH /Courier SF 11586 XM (SET RETRY INITIAL)SH /Times-Italic SF 22386 XM (or)SH /Courier SF 23875 XM (PACKETS)SH /Times-Italic SF 28675 XM (number)SH /Times-Roman SF 8280 11810 MT (Kermit-370 resends its last packet after receiving a NAK or) 115 W( bad packet, but it eventually gives up after repeated)114 W 8280 13006 MT (failures or the same packet. The) 69 W( limit on retries can be set separately for the initial packet exchange \050Send-Init or)70 W 8280 14202 MT (server-mode command\051 and for ordinary packets.) 17 W( The) 282 W( default for INITIAL is 16 and for PACKETS, 5. Either limit)16 W 8280 15398 MT (can be set to any positive value.)SH 12 /Times-Bold AF 8280 17986 MT (SET SYSCMD)SH 10 /Times-Roman AF 8280 19400 MT (Syntax:)SH /Courier SF 11586 XM (SET SYSCMD ON)SH /Times-Italic SF 19986 XM (or)SH /Courier SF 21475 XM (OFF)SH /Times-Roman SF 8280 21191 MT (ON)SH 12280 XM (If the user enters) 89 W( a command string which is not a valid Kermit subcommand, Kermit-370 will pass the)90 W 12280 22296 MT (string along to the host operating system for execution. If the string is rejected by the system) 117 W( as well,)116 W 12280 23401 MT (Kermit will report it as an) 112 W( invalid)113 W /Times-Italic SF 26704 XM (Kermit)SH /Times-Roman SF 29845 XM (subcommand. Otherwise,) 476 W( Kermit will assume the string was)113 W 12280 24506 MT (intended as a host command and will simply report the completion code if non-zero.)SH 8280 26164 MT (OFF)SH 12280 XM (Invalid Kermit) 14 W( subcommands are simply rejected as such. System commands may be executed, of course,)13 W 12280 27269 MT (but only by specifying) 19 W( the generic prefix ``)20 W /Courier SF (HOST)SH /Times-Roman SF ('' or the appropriate system-specific prefix, such as CMS)20 W 12280 28374 MT (or TSO. \050Default.\051)SH 12 /Times-Bold AF 8280 30962 MT (SET TABS-EXPAND)SH 10 /Times-Roman AF 8280 32376 MT (Syntax:)SH /Courier SF 11586 XM (SET TABS-EXPAND ON [)SH /Times-Italic SF (list)SH /Courier SF (])SH /Times-Italic SF 26009 XM (or)SH /Courier SF 27498 XM (OFF)SH /Times-Roman SF 8280 34167 MT (ON)SH 12280 XM (Tab characters in incoming TEXT files are replaced by one or more blanks to bring the) 56 W( record size up to)55 W 12280 35272 MT (the next higher multiple of eight for each tab. If tab settings other than columns 1, 9, 17, etc.) 37 W( are desired,)38 W 12280 36377 MT (they may be specified explicitly in a list following the keyword ``)29 W /Courier SF (ON)SH /Times-Roman SF (''. Items) 308 W( in the list may be) 29 W( separated)28 W 12280 37482 MT (by spaces or commas.)SH 8280 39140 MT (OFF)SH 12280 XM (Incoming tabs are retained. \050Default.\051)SH 12 /Times-Bold AF 8280 41728 MT (SET TAKE ECHO)SH 10 /Times-Roman AF 8280 43142 MT (Syntax:)SH /Courier SF 11586 XM (SET TAKE ECHO ON)SH /Times-Italic SF 21786 XM (or)SH /Courier SF 23275 XM (OFF)SH /Times-Roman SF 8280 44933 MT (ON)SH 12280 XM (Subcommands are echoed to the terminal as they are executed from a TAKE file.)SH 8280 46591 MT (OFF)SH 12280 XM (Subcommands from a TAKE file are executed "silently." \050Default.\051)SH 12 /Times-Bold AF 8280 49179 MT (SET TAKE ERROR-ACTION)SH 10 /Times-Roman AF 8280 50593 MT (Syntax:)SH /Courier SF 11586 XM (SET TAKE ERROR-ACTION CONTINUE)SH /Times-Italic SF 30186 XM (or)SH /Courier SF 31675 XM (HALT)SH /Times-Roman SF 8280 52384 MT (CONTINUE)SH 13780 XM (Execution continues in a TAKE file regardless of illegal commands, except in server mode. This is) SH( the)1 W 13780 53489 MT (default.)SH 8280 55147 MT (HALT)SH 13780 XM (A command error in a TAKE file causes immediate exit to Kermit subcommand level.)SH 12 /Times-Bold AF 8280 57735 MT (SET TEST)SH 10 /Times-Roman AF 8280 59149 MT (Syntax:)SH /Courier SF 11586 XM (SET TEST ON)SH /Times-Italic SF 18786 XM (or)SH /Courier SF 20275 XM (OFF)SH /Times-Roman SF 8280 60940 MT (ON)SH 12280 XM (Allow setting the START-OF-PACKET and other special characters to) 24 W( any value, and suppress checksum)23 W 12280 62045 MT (testing on received packets.)SH 8280 63703 MT (OFF)SH 12280 XM (Normal operation. \050Default.\051)SH ES %%Page: 184 185 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 184)SH 12 /Times-Bold AF 29952 XM (Kermit User Guide: IBM 370 KERMIT \0508.2\051)SH 46800 50 6120 5709 UL 6120 8004 MT (SET TTABLE)SH 10 /Times-Roman AF 6120 9418 MT (Syntax:)SH /Courier SF 9426 XM (SET TTABLE ON)SH /Times-Italic SF 17826 XM (or)SH /Courier SF 19315 XM (OFF)SH /Times-Roman SF 6120 11209 MT (ON)SH 10120 XM (The translation that undoes the terminal) 48 W( controller's ASCII/EBCDIC conversion comes from the TATOE)49 W 10120 12314 MT (and TETOA tables, rather than the ATOE and ETOA tables \050which are used only for translating) 153 W( disk)152 W 10120 13419 MT (files\051. This) 378 W( option has no effect) 64 W( when there is no translation built into the controller, i.e., with SERIES1)65 W 10120 14524 MT (and GRAPHICS connections.)SH 6120 16182 MT (OFF)SH 10120 XM (The ATOE and ETOA tables are used for all translations by Kermit-370. \050Default.\051)SH 12 /Times-Bold AF 6120 18770 MT (SET WARNING)SH 10 /Times-Roman AF 6120 20184 MT (Syntax:)SH /Courier SF 9426 XM (SET WARNING ON)SH /Times-Italic SF 18426 XM (or)SH /Courier SF 19915 XM (OFF)SH /Times-Roman SF 6120 21975 MT (ON)SH 10120 XM (If an incoming file has the same)113 W /Times-Italic SF 23992 XM (filespec)SH /Times-Roman SF 27410 XM (as an existing) 113 W( file on disk, Kermit will attempt to rename the)112 W 10120 23080 MT (incoming file so as not to destroy \050overwrite\051 the pre-existing one.)SH 6120 24738 MT (OFF)SH 10120 XM (Upon filename collision, the existing file will be erased and replaced by the incoming file. \050Default.\051)SH 12 /Times-Bold AF 6120 27326 MT (SET 8-BIT-QUOTE)SH 10 /Times-Roman AF 6120 28740 MT (Syntax:)SH /Courier SF 9426 XM (SET 8-BIT-QUOTE)SH /Times-Italic SF 19026 XM (char or)SH /Courier SF 22598 XM (ON)SH /Times-Italic SF 24398 XM (or)SH /Courier SF 25887 XM (OFF)SH /Times-Roman SF 6120 31132 MT (This controls whether eighth-bit prefixing is done and can be used to specify the character to be used.) 10 W( This) 272 W( is one of)11 W 6120 32328 MT (only two Send-Init parameters that cannot be SET separately for SEND and RECEIVE.)SH 6120 34119 MT (char)SH 10120 XM (Eighth-bit prefixing will be done using)SH /Times-Italic SF 25953 XM (char)SH /Times-Roman SF (, provided the other Kermit agrees.)SH 6120 35777 MT (ON)SH 10120 XM (Eighth-bit prefixing will) 223 W( be done, provided the other Kermit explicitly requests it \050and specifies the)222 W 10120 36882 MT (character\051.)SH 6120 38540 MT (OFF)SH 10120 XM (Eighth-bit prefixing will not be done. \050Default.\051)SH 12 /Times-Bold AF 6120 41128 MT (SET SEND/RECEIVE)SH 10 /Times-Roman AF 6120 42542 MT (The following parameters can be set either as SEND or RECEIVE options. As a rule, in) 152 W( each pair, one is the)153 W 6120 43738 MT (operational value, and the) 69 W( other is used to change the default for Send-Init packets received from the other Kermit)68 W 6120 44934 MT (and to set up parameter values as if the other Kermit had specified) 122 W( them on the previous exchange. When both)123 W 6120 46130 MT (values are) 10 W( described, the operational one will be first. After a transfer, the operational values will be unchanged, but)9 W 6120 47326 MT (the others \050as displayed by SHOW\051 will reflect the parameters specified by the) 178 W( other Kermit. The underlying)179 W 6120 48522 MT (defaults established by previous SET subcommands will still be in effect. In the syntax) 14 W( descriptions,)13 W /Times-Italic SF 46950 XM (mode)SH /Times-Roman SF 49379 XM (is SEND)13 W 6120 49718 MT (or RECEIVE.)SH 12 /Times-Bold AF 6120 52306 MT (END-OF-LINE)SH 10 /Times-Roman AF 6120 53720 MT (Syntax:)SH /Courier SF 9426 XM (SET)SH /Times-Italic SF 11826 XM (mode)SH /Courier SF 14592 XM (END-OF-LINE)SH /Times-Italic SF 21792 XM (number)SH /Times-Roman SF 6120 56112 MT (RECEIVE should not be changed.)SH 6120 58504 MT (SEND may be needed to establish contact. If the other system needs packets to be terminated by anything) SH( other than)1 W 6120 59700 MT (carriage return, specify the decimal value of) 197 W( the desired ASCII character.)196 W /Times-Italic SF 38246 XM (number)SH /Times-Roman SF 41747 XM (must be in the range 0-31)196 W 6120 60896 MT (\050decimal\051. The) 250 W( default is 13 \050CR\051.)SH 12 /Times-Bold AF 6120 63484 MT (PACKET-SIZE)SH 10 /Times-Roman AF 6120 64898 MT (Syntax:)SH /Courier SF 9426 XM (SET)SH /Times-Italic SF 11826 XM (mode)SH /Courier SF 14592 XM (PACKET-SIZE)SH /Times-Italic SF 21792 XM (number)SH /Times-Roman SF 6120 67290 MT (RECEIVE defines)46 W /Times-Italic SF 13822 XM (number)SH /Times-Roman SF 17173 XM (as the maximum) 46 W( length for incoming packets. The valid range is 26-9024, but 94 is the)47 W 6120 68486 MT (limit for normal short-packet protocol. The default) 123 W( is 80. In practice, the size may be limited by hardware and)122 W 6120 69682 MT (programming considerations. See the system-specific chapters for details.)SH ES %%Page: 185 186 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (8.2. Kermit-370 Subcommands)SH 10 /Times-Italic AF 51275 XM (Page 185)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (SEND might be needed for sending files to a minimal Kermit that neither specifies) 105 W( a buffer size in the Send-Init)106 W 8280 9082 MT (sequence nor can accept) 40 W( the default \05080\051. This parameter has no other function and is meaningful only in the range)39 W 8280 10278 MT (26-94.)SH 12 /Times-Bold AF 8280 12866 MT (PAD-CHAR)SH 10 /Times-Roman AF 8280 14280 MT (Syntax:)SH /Courier SF 11586 XM (SET)SH /Times-Italic SF 13986 XM (mode)SH /Courier SF 16752 XM (PAD-CHAR)SH /Times-Italic SF 22152 XM (number)SH /Times-Roman SF 8280 16672 MT (RECEIVE defines)36 W /Times-Italic SF 15962 XM (number)SH /Times-Roman SF 19303 XM (as the character to be used by the other Kermit for padding packets. The character must)37 W 8280 17868 MT (be an ASCII control character \050in the range 0-31\051. The default is 0 \050NULL\051. This option is seldom useful.)SH 8280 20260 MT (SEND may be needed to establish contact if the other Kermit \050or the transmission line\051 needs padded packets.)SH 12 /Times-Bold AF 8280 22848 MT (PADDING)SH 10 /Times-Roman AF 8280 24262 MT (Syntax:)SH /Courier SF 11586 XM (SET)SH /Times-Italic SF 13986 XM (mode)SH /Courier SF 16752 XM (PADDING)SH /Times-Italic SF 21552 XM (number)SH /Times-Roman SF 8280 26654 MT (RECEIVE defines the)14 W /Times-Italic SF 17404 XM (number)SH /Times-Roman SF 20723 XM (of pad characters to) 14 W( be used for padding packets from the other Kermit. This number)13 W 8280 27850 MT (may be anywhere from 0 to 94. The default is 0. This option is seldom useful.)SH 8280 30242 MT (SEND may be needed to establish contact if the other Kermit \050or the transmission line\051 needs padded packets.)SH 12 /Times-Bold AF 8280 32830 MT (QUOTE)SH 10 /Times-Roman AF 8280 34244 MT (Syntax:)SH /Courier SF 11586 XM (SET)SH /Times-Italic SF 13986 XM (mode)SH /Courier SF 16752 XM (QUOTE)SH /Times-Italic SF 20352 XM (char)SH /Times-Roman SF 8280 36636 MT (SEND indicates a printable character for prefixing \050quoting\051 control) SH( characters and other prefix characters. The only)1 W 8280 37832 MT (good reason to change this would be for sending a file that contains many ``)160 W /Courier SF (#)SH /Times-Roman SF ('' characters \050the normal control)159 W 8280 39028 MT (prefix\051 as data. It must be a single character with ASCII value 33-62 or 96-126 \050decimal\051.)SH 8280 41420 MT (RECEIVE would be needed only for talking to) 109 W( a crippled Kermit that uses a non-standard quoting character, but)110 W 8280 42616 MT (does not admit it.)SH 12 /Times-Bold AF 8280 45204 MT (START-OF-PACKET)SH 10 /Times-Roman AF 8280 46618 MT (Syntax:)SH /Courier SF 11586 XM (SET)SH /Times-Italic SF 13986 XM (mode)SH /Courier SF 16752 XM (START-OF-PACKET)SH /Times-Italic SF 26352 XM (number)SH /Times-Roman SF 8280 49010 MT (RECEIVE defines)59 W /Times-Italic SF 16008 XM (number)SH /Times-Roman SF 19372 XM (as the character to be expected to mark the start) 59 W( of packets from the other Kermit. The)58 W 8280 50206 MT (character must be an ASCII control character \050in the range 0-31\051. The default is 1 \050SOH\051. This may be) 57 W( needed to)58 W 8280 51402 MT (establish contact.)SH 8280 53794 MT (SEND may also be needed to establish contact.) 123 W( It) 494 W( defines)122 W /Times-Italic SF 33014 XM (number)SH /Times-Roman SF 36441 XM (as the character to be used to mark outgoing)122 W 8280 54990 MT (packets.)SH 12 /Times-Bold AF 8280 57578 MT (TIMEOUT)SH 10 /Times-Roman AF 8280 58992 MT (Syntax:)SH /Courier SF 11586 XM (SET)SH /Times-Italic SF 13986 XM (mode)SH /Courier SF 16752 XM (TIMEOUT)SH /Times-Italic SF 21552 XM (time)SH /Times-Roman SF 8280 61384 MT (RECEIVE defines) 8 W( the)9 W /Times-Italic SF 17388 XM (time)SH /Times-Roman SF 19369 XM (in seconds the other Kermit is to wait for a response from Kermit-370 before resending a)9 W 8280 62580 MT (packet. The) 250 W( default is 5. A value of 0 means the other Kermit should wait indefinitely.)SH 8280 64972 MT (SEND defines the)94 W /Times-Italic SF 16033 XM (time)SH /Times-Roman SF 18099 XM (in seconds Kermit-370 is to wait for a response from the) 94 W( other Kermit before resending a)93 W 8280 66168 MT (packet. The) 250 W( default is 0.)SH ES %%Page: 186 187 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 186)SH 12 /Times-Bold AF 29952 XM (Kermit User Guide: IBM 370 KERMIT \0508.2\051)SH 46800 50 6120 5709 UL 13 SS 22260 8071 MT (The SHOW Subcommand)SH 10 /Times-Roman AF 6120 10444 MT (Syntax:)SH /Courier SF 9426 XM (SHOW [)SH /Times-Italic SF (option)SH /Courier SF (])SH /Times-Roman SF 6120 12836 MT (The SHOW subcommand displays the values of all parameters) 135 W( that can be changed with the SET subcommand,)136 W 6120 14032 MT (except for ATOE, ETOA, TATOE, and TETOA \050for) 27 W( those, see the TDUMP subcommand\051. If specified,)26 W /Times-Italic SF 48700 XM (option)SH /Times-Roman SF 51532 XM (can)SH 6120 15228 MT (be a particular parameter or the keyword ``)178 W /Courier SF (ALL)SH /Times-Roman SF ('' \050the default\051. Groups of parameters, such) 178 W( as SEND, can be)179 W 6120 16424 MT (displayed by requesting the group name, or individual sub-parameters) 58 W( can be displayed by specifying the complete)57 W 6120 17620 MT (name. For) 250 W( example,)SH /Courier SF 8520 19275 MT (SHOW RECEIVE EOL)SH /Times-Roman SF 6120 20992 MT (will display the decimal value of the packet terminator that Kermit-370 currently expects, i.e., 13. Similarly,)SH /Courier SF 8520 22647 MT (SHOW FOREIGN)SH /Times-Roman SF 6120 24364 MT (will display the character strings currently in use for prefix and suffix on each outgoing)SH /Times-Italic SF 41308 XM (filespec)SH /Times-Roman SF (.)SH 13 /Times-Bold AF 21753 27723 MT (The STATUS Subcommand)SH 10 /Times-Roman AF 6120 30096 MT (Syntax:)SH /Courier SF 9426 XM (STATUS)SH /Times-Roman SF 6120 32488 MT (This subcommand displays information about the previously executed subcommand. The response) 160 W( will include)161 W 6120 33684 MT (either the appropriate error message or the message ``)362 W /Courier SF (No errors)362 W /Times-Roman SF (''. The) 974 W( initial status is ``)362 W /Courier SF (No file)361 W 6120 34880 MT (transfers yet)29 W /Times-Roman SF (''. If) 308 W( the status reflects) 29 W( an error condition, the name of the last file used \050excluding TAKE files\051)30 W 6120 36076 MT (will be displayed as well. If the error was detected by the) 30 W( other Kermit, the message will be ``)29 W /Courier SF (Micro aborted)29 W /Times-Roman SF ('')SH 6120 37272 MT (followed by the) 144 W( text from the Error packet. Conversely, if Kermit-370 detected the error, the text of the status)145 W 6120 38468 MT (message will have constituted the error packet sent out. In any case, if the last) 27 W( file transfer was cancelled \050by virtue)26 W 6120 39664 MT (of an attribute mismatch or manual intervention\051, the reason for cancellation is) 6 W( displayed. Also, if the error occurred)7 W 6120 40860 MT (in disk I/O, any available explanatory information is displayed. Normally, the error status) 96 W( is altered only when a)95 W 6120 42056 MT (transfer-initiating subcommand \050SEND or RECEIVE\051 is executed, but) 271 W( in server mode)272 W /Times-Italic SF 43711 XM (every)SH /Times-Roman SF 46398 XM (subcommand is)272 W 6120 43252 MT (received through a transfer from the other Kermit and may affect the status \050except the STATUS) 2 W( subcommand itself,)1 W 6120 44448 MT (of course\051. When Kermit-370 has been forced to truncate one or) 19 W( more records in a RECEIVE operation \050because of)20 W 6120 45644 MT (the current maximum record length\051, the number of records truncated) 66 W( is reported. The status display also includes)65 W 6120 46840 MT (throughput statistics for the last transfer: number of files) 78 W( sent, duration, number of packets, number of retries, and)79 W 6120 48036 MT (averages of bytes/packet and bytes/second. These last) 112 W( two quantities are calculated separately for bytes sent and)111 W 6120 49232 MT (received on) 2 W( the communication \050including padding, if any\051, and the last quantity is also calculated on the basis of the)3 W 6120 50428 MT (number of bytes read from or written to disk.)SH 6120 52820 MT (Finally, if retries were necessary, Kermit-370 computes the optimum packet size assuming the retries to have) 61 W( been)60 W 6120 54016 MT (due to sparse, Poisson-distributed bursts of noise. This is the same heuristic optimum that Kermit-370 computes) 3 W( and)4 W 6120 55212 MT (uses as an alternative packet-size limit when sending long packets.)SH 13 /Times-Bold AF 21899 58571 MT (The TDUMP Subcommand)SH 10 /Times-Roman AF 6120 60944 MT (Syntax:)SH /Courier SF 9426 XM (TDUMP)SH /Times-Italic SF 13026 XM (table-name or)350 W /Courier SF 19614 XM (NAMES)SH /Times-Roman SF 6120 63336 MT (This displays the contents of)8 W /Times-Italic SF 17854 XM (table-name)SH /Times-Roman SF (. The) 265 W( same table can be modified using the SET subcommand. The ATOE,)7 W 6120 64532 MT (ETOA, TATOE, and TETOA tables can presently be displayed and changed. Alternatively, the)23 W /Times-Italic SF 45045 XM (filespec)SH /Times-Roman SF 48374 XM (of each file)24 W 6120 65728 MT (sent in the last transfer can be displayed.)SH ES %%Page: 187 188 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (8.2. Kermit-370 Subcommands)SH 10 /Times-Italic AF 51275 XM (Page 187)SH 46800 50 8280 5709 UL 13 /Times-Bold AF 24781 8071 MT (The GIVE Subcommand)SH 10 /Times-Roman AF 8280 10444 MT (Syntax:)SH /Courier SF 11586 XM (GIVE)SH /Times-Italic SF 14586 XM (table-name filespec)350 W /Times-Roman SF 8280 12836 MT (This compares the named table with its default values and saves the differences) 214 W( in the form of a TAKE file)213 W 8280 14032 MT (consisting of SET subcommands that would convert the default into the current arrangement.) 198 W( ATOE,) 648 W( ETOA,)199 W 8280 15228 MT (TATOE, and TETOA are the available tables. The details of the)100 W /Times-Italic SF 35585 XM (filespec)SH /Times-Roman SF 38990 XM (are system-dependent, but) 100 W( those details)99 W 8280 16424 MT (will, in general, be the same as for the TAKE subcommand.)SH 13 /Times-Bold AF 24636 19783 MT (The HOST Subcommand)SH 10 /Times-Roman AF 8280 22156 MT (Syntax:)SH /Courier SF 11586 XM (HOST)SH /Times-Italic SF 14586 XM (text of command)SH /Times-Roman SF 8280 24548 MT (This issues a command to) 197 W( the host operating system from Kermit-370. When a command returns a non-zero)198 W 8280 25744 MT (completion code, the code will be displayed. Generally, the name of) 13 W( the system \050e.g., CMS\051 is treated as a synonym)12 W 8280 26940 MT (for the HOST subcommand.)SH 13 /Times-Bold AF 23734 30299 MT (The KERMIT Subcommand)SH 10 /Times-Roman AF 8280 32672 MT (Syntax:)SH /Courier SF 11586 XM (KERMIT)SH /Times-Italic SF 15786 XM (text of subcommand)SH /Times-Roman SF 8280 35064 MT (This is provided for redundancy as the counterpart of the HOST subcommand. Kermit-370 executes) 73 W( the specified)74 W 8280 36260 MT (text as a Kermit subcommand just as if the LOCAL prefix had been entered.)SH 13 /Times-Bold AF 20519 39619 MT (The ECHO and XECHO Subcommands)SH 10 /Times-Roman AF 8280 41992 MT (Syntax:)SH /Courier SF 11586 XM ([X]ECHO)SH /Times-Italic SF 16386 XM (line)SH /Times-Roman SF 8280 44384 MT (These subcommands type the)118 W /Times-Italic SF 20805 XM (line)SH /Times-Roman SF 22672 XM (back at the user. The)117 W /Times-Italic SF 32177 XM (line)SH /Times-Roman SF 34044 XM (may contain control characters or any desired text,)117 W 8280 45580 MT (including upper or lower case. These subcommands) 24 W( may be used, for example, to test the ASCII/EBCDIC translate)25 W 8280 46776 MT (tables or to issue) 128 W( coded commands to the user's terminal. XECHO differs from ECHO primarily in that it uses)127 W 8280 47972 MT (transparent mode if CONTROLLER is SERIES1 or GRAPHICS. It) 76 W( also offers its own brand of control-character)77 W 8280 49168 MT (quoting, using the ``)108 W /Courier SF (^)SH /Times-Roman SF ('' character to indicate that only the five low-order bits of) 108 W( the ASCII codes are to be used.)107 W 8280 50364 MT (Thus, ``)64 W /Courier SF (^a)SH /Times-Roman SF ('', ``)64 W /Courier SF (^A)SH /Times-Roman SF ('', and ``)64 W /Courier SF (^!)SH /Times-Roman SF ('' are all translated to SOH \050CTRL-A\051,) 64 W( while ``)65 W /Courier SF (^[)SH /Times-Roman SF ('' becomes ESC. However, there)65 W 8280 51560 MT (must be one exception for ``)89 W /Courier SF (^)SH /Times-Roman SF ('' itself: ``)89 W /Courier SF (^>)SH /Times-Roman SF ('' and ``)89 W /Courier SF (^~)SH /Times-Roman SF ('' are both translated to RS \050CTRL-)88 W /Courier SF (^)SH /Times-Roman SF (\051, but ``)88 W /Courier SF (^^)SH /Times-Roman SF ('' becomes)88 W 8280 52756 MT (just ``)SH /Courier SF (^)SH /Times-Roman SF (''.)SH 13 /Times-Bold AF 20880 56115 MT (The TYPE and XTYPE Subcommands)SH 10 /Times-Roman AF 8280 58488 MT (Syntax:)SH /Courier SF 11586 XM ([X]TYPE)SH /Times-Italic SF 16386 XM (filespec)SH /Times-Roman SF 8280 60880 MT (These subcommands type the) 64 W( named file. XTYPE differs from TYPE primarily in that it uses transparent mode if)65 W 8280 62076 MT (CONTROLLER is SERIES1 or GRAPHICS, and sends the data in bursts no larger) 264 W( than the current SEND)263 W 8280 63272 MT (PACKET-SIZE. TYPE) 298 W( is effectively a synonym) 24 W( for \050and allows the same options as\051 the host system command for)25 W 8280 64468 MT (listing files, but XTYPE merely sends the file "raw".)SH ES %%Page: 188 189 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 188)SH 12 /Times-Bold AF 29952 XM (Kermit User Guide: IBM 370 KERMIT \0508.3\051)SH 46800 50 6120 5709 UL 14 SS 6120 8138 MT (8.3. Before Connecting to the Mainframe)SH 10 /Times-Roman AF 6120 10256 MT (Several flags must be set on the micro version of Kermit before connecting) 123 W( to an IBM 370 system as a ``)122 W /Courier SF (TTY)SH /Times-Roman SF ('')SH 6120 11452 MT (device. You) 408 W( should set the LOCAL-ECHO flag to ON \050to indicate half-duplex\051. This) 79 W( is the norm but not true in)80 W 6120 12648 MT (absolutely every case; if each) 114 W( character appears twice on your terminal screen, set the LOCAL-ECHO flag OFF.)113 W 6120 13844 MT (FLOW-CONTROL should be set to NONE, and) 7 W( on some systems HANDSHAKE should be set to XON. The parity)8 W 6120 15040 MT (should be set according to the system's specifications. On some micro versions of Kermit, all of the) 46 W( above is done)45 W 6120 16236 MT (in one step using the DO IBM macro \050or SET IBM ON\051. Set the baud rate to correspond to the line speed.)SH 6120 18628 MT (Connecting through a ``)120 W /Courier SF (SERIES1)SH /Times-Roman SF ('' or ``)120 W /Courier SF (GRAPHICS)SH /Times-Roman SF ('' device also requires that certain flags be set on the micro)120 W 6120 19824 MT (version of Kermit. You should set the LOCAL-ECHO flag to OFF \050to indicate full-duplex\051.) 92 W( FLOW-CONTROL)433 W 6120 21020 MT (should be set to XON/XOFF, and HANDSHAKE should be set to) 30 W( OFF. For many systems, the PARITY should be)31 W 6120 22216 MT (set to EVEN. Set the baud rate to correspond to the line speed.)SH 6120 24608 MT (One exception) 256 W( to these rules is the case where the micro Kermit is attempting automated file transfer, e.g.,)255 W 6120 25804 MT (downloading several separate files from Kermit-370 running in server mode. In) 113 W( fact, under those circumstances,)114 W 6120 27000 MT (handshaking is necessary even with ``)82 W /Courier SF (SERIES1)SH /Times-Roman SF ('' connections, and the two Kermits must be instructed to adopt a)81 W 6120 28196 MT (common handshake character \050e.g., by SET) 105 W( HANDSHAKE 10 to Kermit-370 and SET HANDSHAKE LF to the)106 W 6120 29392 MT (micro\051.)SH 6120 31784 MT (In any case, you should make sure that either the micro Kermit or Kermit-370) 133 W( will provide timeouts during file)132 W 6120 32980 MT (transfers \050if not both\051. Some versions of Kermit-370 \050notably CMS\051) 35 W( cannot provide timeouts, and you may need to)36 W 6120 34176 MT (set the TIMER to ON in the micro.)SH 14 /Times-Bold AF 6120 37778 MT (8.4. After Returning from Kermit-370)SH 10 /Times-Roman AF 6120 39896 MT (When Kermit-370 receives a) 1 W( QUIT or EXIT subcommand or finishes the subcommand or subcommands specified in)SH 6120 41092 MT (the original command string that invoked Kermit,) 114 W( control is returned to the caller. Before returning, Kermit-370)115 W 6120 42288 MT (closes any active TAKE files \050the EXIT or QUIT subcommand may be issued) 77 W( from a TAKE file\051. On return, the)76 W 6120 43484 MT (completion code is set from the current error status according to the codes in Table 8-0.)SH 14 /Times-Bold AF 6120 47086 MT (8.5. What's New)SH 10 /Times-Roman AF 6120 49204 MT (Below is a list of the additions in Version 4.0 of Kermit-370:)SH 8120 50995 MT (1.)SH 9120 XM (Code reorganization into generic 370 and system-specific sections.)SH 8120 52653 MT (2.)SH 9120 XM (Optional separate translation tables for counteracting the system conversion of terminal I/O.)SH 8120 54311 MT (3.)SH 9120 XM (New)SH /Courier SF 11258 XM (GIVE)SH /Times-Roman SF 13908 XM (subcommand for saving a modified translation table.)SH 8120 55969 MT (4.)SH 9120 XM (A new, RAW debug mode for recording) 346 W( the packet traffic as actually sent and received on)347 W 9120 57074 MT (``)SH /Courier SF (GRAPHICS)SH /Times-Roman SF ('' and ``)SH /Courier SF (SERIES1)SH /Times-Roman SF ('' devices.)SH 8120 58732 MT (5.)SH 9120 XM (Preservation of the case of subcommands as typed, with uppercase conversion) 6 W( of only those words that)5 W 9120 59837 MT (must be uppercase.)SH 8120 61495 MT (6.)SH 9120 XM (New)SH /Courier SF 11258 XM (SET MARGIN)SH /Times-Roman SF 17508 XM (subcommand for limiting the width of a file to be sent.)SH 8120 63153 MT (7.)SH 9120 XM (Settable tab stops for Kermit's conversion of tabs to spaces \050alternative to the default 1, 9, 17, etc.\051.)SH 8120 64811 MT (8.)SH 9120 XM (Replace)SH /Courier SF 12637 XM (SET SERIES1)46 W /Times-Roman SF 19579 XM (subcommand with new)46 W /Courier SF 29244 XM (SET CONTROLLER)46 W /Times-Roman SF (. Support) 342 W( for multiple terminal)46 W 9120 65916 MT (controller types.)SH 8120 67574 MT (9.)SH 9120 XM (New)SH /Courier SF 11258 XM (DIRECTORY)SH /Times-Roman SF 16908 XM (and)SH /Courier SF 18602 XM (HOST)SH /Times-Roman SF 21252 XM (subcommands following Kermit standard.)SH 7620 69232 MT (10.)SH 9120 XM (Combination of file-attribute)200 W /Courier SF 21525 XM (SET)SH /Times-Roman SF 23775 XM (subcommands \050FILE-TYPE, LRECL, and) 200 W( RECFM\051 into a new)199 W 9120 70337 MT (group)SH /Courier SF 11703 XM (SET FILE)SH /Times-Roman SF (.)SH 7620 71995 MT (11.)SH 9120 XM (Separate retry limits for initial and subsequent packet exchanges.)SH ES %%Page: 189 190 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (8.5. What's New)SH 10 /Times-Italic AF 51275 XM (Page 189)SH 46800 50 8280 5709 UL 46800 50 8280 8086 UL /Times-Roman SF 8280 10315 MT (Code)SH 12600 XM (Symbol)SH 18360 XM (Error Message)SH 2111 50 8280 10515 UL 3112 50 12600 10515 UL 5859 50 18360 10515 UL 8530 11420 MT (0)SH 12600 XM (NOE)SH 18360 XM (No errors)SH 8530 12525 MT (1)SH 12600 XM (NFT)SH 18360 XM (No file transfers yet)SH 8530 13630 MT (2)SH 12600 XM (TRC)SH 18360 XM (Transfer cancelled)SH 8530 14735 MT (3)SH 12600 XM (USC)SH 18360 XM (Invalid server command)SH 8530 15840 MT (4)SH 12600 XM (TIE)SH 18360 XM (Terminal I/O error)SH 8530 16945 MT (5)SH 12600 XM (BPC)SH 18360 XM (Bad packet count or chksum)SH 8530 18050 MT (6)SH 12600 XM (IPS)SH 18360 XM (Invalid packet syntax)SH 8530 19155 MT (7)SH 12600 XM (IPT)SH 18360 XM (Invalid packet type)SH 8530 20260 MT (8)SH 12600 XM (MIS)SH 18360 XM (Lost a packet)SH 8530 21365 MT (9)SH 12600 XM (NAK)SH 18360 XM (Micro sent a NAK)SH 8280 22470 MT (10)SH 12600 XM (ABO)SH 18360 XM (Micro aborted)SH 8280 23575 MT (11)SH 12600 XM (FNE)SH 18360 XM (Invalid file name)SH 8280 24680 MT (12)SH 12600 XM (FNF)SH 18360 XM (File not found)SH 8280 25785 MT (13)SH 12600 XM (FUL)SH 18360 XM (Disk or file is full)SH 8280 26890 MT (14)SH 12600 XM (DIE)SH 18360 XM (Disk I/O error)SH 8280 27995 MT (15)SH 12600 XM (MOP)SH 18360 XM (Missing operand)SH 8280 29100 MT (16)SH 12600 XM (SYS)SH 18360 XM (Illegal system command)SH 8280 30205 MT (17)SH 12600 XM (KCE)SH 18360 XM (Kermit command error)SH 8280 31310 MT (18)SH 12600 XM (TIM)SH 18360 XM (No packet received)SH 8280 32415 MT (19)SH 12600 XM (RTR)SH 18360 XM (Records truncated)SH 8280 33520 MT (20)SH 12600 XM (COM)SH 18360 XM (Bad communication line)SH /Times-Bold SF 20904 35130 MT (Table 8-1:)SH /Times-Roman SF 25765 XM (Error messages and codes for Kermit-370)SH 46800 50 8280 38464 UL 9780 39922 MT (12.)SH 11280 XM (Pad binary records on disk with nulls, rather than blanks.)SH 9780 41580 MT (13.)SH 11280 XM (Automatically tune packet) 29 W( length when sending long packets according to heuristic optimum based on)30 W 11280 42685 MT (sparse Poisson statistics, provided that transmission errors do occur.)SH 9780 44343 MT (14.)SH 11280 XM (Expand STATUS report to include the number of files in the last transfer, throughput statistics,)232 W 11280 45448 MT (heuristic optimum packet length \050when) 31 W( long packets are enabled\051, and the reason for any file rejection)32 W 11280 46553 MT (based on A-packets.)SH 9780 48211 MT (15.)SH 11280 XM (New subcommand)SH /Courier SF 19001 XM (TDUMP NAMES)SH /Times-Roman SF 25851 XM (to display the list of files sent in the last transfer.)SH 9780 49869 MT (16.)SH 11280 XM (Add file creation date to A-packet repertoire.)SH 9780 51527 MT (17.)SH /Courier SF 11280 XM (REMOTE COPY)SH /Times-Roman SF 18130 XM (and)SH /Courier SF 19824 XM (REMOTE RENAME)SH /Times-Roman SF 27874 XM (commands to a server at the other end.)SH 9780 53185 MT (18.)SH 11280 XM (Allow long packets through a 7171 with VTAM.)SH 9780 54843 MT (19.)SH 11280 XM (New type)SH /Courier SF 15390 XM (D-BINARY)SH /Times-Roman SF 20440 XM (for binary files with undelimited variable-length records.)SH 9780 56501 MT (20.)SH /Courier SF 11280 XM (SET 8-BIT-QUOTE)SH /Times-Roman SF (. Allow) 250 W( 8-bit data where possible via)SH /Courier SF 35528 XM (SET PARITY)SH /Times-Roman SF (.)SH 9780 58159 MT (21.)SH /Courier SF 11280 XM (SET SYSCMD)127 W /Times-Roman SF (, so that Kermit can be told to try "illegal" subcommands as) 127 W( host system commands)126 W 11280 59264 MT (instead of just rejecting them.)SH 9780 60922 MT (22.)SH /Courier SF 11280 XM (SET PROMPT)SH /Times-Roman SF 17530 XM (subcommand.)SH 9780 62580 MT (23.)SH 11280 XM (Do not forget parameters specified by the other Kermit in I-packets.)SH 9780 64238 MT (24.)SH 11280 XM (Keep track) 77 W( of truncated records during a RECEIVE operation and report the count in STATUS; also)78 W 11280 65343 MT (call truncation an error after everything is received.)SH 9780 67001 MT (25.)SH /Courier SF 11280 XM (SET HANDSHAKE)59 W /Times-Roman SF 19448 XM (subcommand to alter or suppress) 59 W( handshake character Kermit-370 sends out after)58 W 11280 68106 MT (each packet.)SH 8280 70498 MT (Both)SH /Courier SF 10475 XM (SEND)SH /Times-Roman SF 13125 XM (and)SH /Courier SF 14819 XM (GET)SH /Times-Roman SF 16869 XM (prompt the user for native and foreign)SH /Times-Italic SF 32338 XM (filespecs)SH /Times-Roman SF 36032 XM (if no arguments are entered.)SH ES %%Page: 190 191 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 190)SH 12 /Times-Bold AF 29952 XM (Kermit User Guide: IBM 370 KERMIT \0508.6\051)SH 46800 50 6120 5709 UL 14 SS 6120 8138 MT (8.6. What's Missing)SH 10 /Times-Roman AF 6120 10256 MT (Work on Kermit-370 will continue. Features that need to be improved or added include:)SH /Symbol SF 7910 12161 MT (\267)SH /Times-Roman SF 8620 XM (Detect file properties from Attribute packets and allow overriding current parameter settings. Also)169 W 8620 13266 MT (implement file archiving.)SH /Symbol SF 7910 15255 MT (\267)SH /Times-Roman SF 8620 XM (Add)SH /Courier SF 10592 XM (SET REPEAT)SH /Times-Roman SF 16842 XM (subcommand.)SH /Symbol SF 7910 17244 MT (\267)SH /Times-Roman SF 8620 XM (Improve Kermit-370 operation as a local Kermit.)SH /Symbol SF 7910 19233 MT (\267)SH /Times-Roman SF 8620 XM (Recover from sudden line degradation by retransmitting partial packets.)SH /Symbol SF 7910 21222 MT (\267)SH /Times-Roman SF 8620 XM (System-specific upgrades; see the respective chapters for details.)SH ES %%Page: 191 192 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (9. IBM VM/CMS KERMIT)SH 10 /Times-Italic AF 51275 XM (Page 191)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 8280 8272 MT (9. IBM VM/CMS KERMIT)SH 10 /Times-Italic AF 8280 10566 MT (Program:)SH /Times-Roman SF 15280 XM (John Chandler \050Harvard/Smithsonian Center for Astrophysics\051; contributions from Vace) 31 W( Kundakci)30 W 15280 11671 MT (and Daphne Tzoar \050Columbia) 211 W( U\051, Bob Shields \050U. Maryland\051, Victor Lee \050Queens U.\051, Gary)212 W 15280 12776 MT (Bjerke \050U. Texas at Austin\051, Greg Small \050UC Berkeley\051, Clark Frazier \050Harvard) 67 W( Bus. Sch.\051, Bob)66 W 15280 13881 MT (Bolch and Steve Blankinship \050Triangle\051, Ron Rusnak \050U. Chicago\051, Andre Pirard \050U. Liege\051)SH /Times-Italic SF 8280 14986 MT (Language:)SH /Times-Roman SF 15280 XM (IBM/370 Assembler)SH /Times-Italic SF 8280 16091 MT (Documentation:)SH /Times-Roman SF 15280 XM (John Chandler \050CfA\051)SH /Times-Italic SF 8280 17196 MT (Version:)SH /Times-Roman SF 15280 XM (4.0 \05088/1/31\051)SH /Times-Italic SF 8280 18301 MT (Date:)SH /Times-Roman SF 15280 XM (1988 February)SH 12 /Times-Bold AF 8280 20889 MT (Kermit-CMS Capabilities At A Glance:)SH 10 /Times-Roman AF 9280 22680 MT (Local operation:)SH 34480 XM (No)SH 9280 23785 MT (Remote operation:)SH 34480 XM (Yes)SH 9280 24890 MT (Transfers text files:)SH 34480 XM (Yes)SH 9280 25995 MT (Transfers binary files:)SH 34480 XM (Yes)SH 9280 27100 MT (Wildcard send:)SH 34480 XM (Yes)SH /Courier SF 9280 28205 MT (^X/^Z)SH /Times-Roman SF 12530 XM (interruption:)SH 34480 XM (Yes \050through micro\051)SH 9280 29310 MT (Filename collision avoidance:)SH 34480 XM (Yes)SH 9280 30415 MT (Can time out:)SH 34480 XM (No)SH 9280 31520 MT (8th-bit prefixing:)SH 34480 XM (Yes)SH 9280 32625 MT (Repeat count prefixing:)SH 34480 XM (Yes)SH 9280 33730 MT (Alternate block checks:)SH 34480 XM (Yes)SH 9280 34835 MT (Terminal emulation:)SH 34480 XM (No)SH 9280 35940 MT (Communication settings:)SH 34480 XM (No)SH 9280 37045 MT (Transmit BREAK:)SH 34480 XM (No)SH 9280 38150 MT (Transaction logging:)SH 34480 XM (Yes)SH 9280 39255 MT (Session logging:)SH 34480 XM (No)SH 9280 40360 MT (Raw transmit:)SH 34480 XM (Yes \050no prompts\051)SH 9280 41465 MT (Sliding window:)SH 34480 XM (No)SH 9280 42570 MT (Long packets:)SH 34480 XM (Yes)SH 9280 43675 MT (Act as server:)SH 34480 XM (Yes)SH 9280 44780 MT (Talk to server:)SH 34480 XM (Yes)SH 9280 45885 MT (Advanced server functions:)SH 34480 XM (Yes)SH 9280 46990 MT (Advanced commands for servers:)SH 34480 XM (Yes)SH 9280 48095 MT (Local file management:)SH 34480 XM (Yes)SH 9280 49200 MT (Handle Attribute Packets:)SH 34480 XM (Yes)SH 9280 50305 MT (Command/init files:)SH 34480 XM (Yes)SH 9280 51410 MT (Command macros:)SH 34480 XM (No)SH 8280 53802 MT (Kermit-CMS is a member of the generic Kermit-370 family and) 66 W( shares most of the features and capabilities of the)67 W 8280 54998 MT (group. As) 538 W( its name implies, Kermit-CMS is the version of) 144 W( Kermit-370 that runs under the VM/CMS operating)143 W 8280 56194 MT (system. The) 690 W( primary documentation for Kermit-CMS is actually the chapter) 220 W( on Kermit-370, which describes)221 W 8280 57390 MT (general properties; the present) 35 W( chapter assumes the reader is familiar with that material. Only the details specific to)34 W 8280 58586 MT (CMS operation will be discussed here, e.g., command syntax relating to the) 140 W( CMS file system or commands not)141 W 8280 59782 MT (offered in general by Kermit-370.)SH 12 /Times-Bold AF 8280 62370 MT (CMS Specifics of Kermit-370:)SH 10 /Times-Roman AF 9280 64161 MT (Global INIT file:)SH /Courier SF 34480 XM (SYSTEM KERMINI *)SH /Times-Roman SF 9280 65266 MT (User INIT file:)SH /Courier SF 34480 XM ( KERMINI *)SH /Times-Roman SF 9280 66371 MT (Debug packet log:)SH /Courier SF 34480 XM (KER LOG A1)SH /Times-Roman SF 9280 67476 MT (Server reply log:)SH /Courier SF 34480 XM (KER REPLY A1)SH /Times-Roman SF 9280 68581 MT (Maximum packet size:)SH 34480 XM (1913)SH 9280 69686 MT (Maximum disk LRECL:)SH 34480 XM (65535)SH ES %%Page: 192 193 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 192)SH 12 /Times-Bold AF 26753 XM (Kermit User Guide: IBM VM/CMS KERMIT \0509.1\051)SH 46800 50 6120 5709 UL 14 SS 6120 8138 MT (9.1. The VM/CMS File System)SH 10 /Times-Roman AF 6120 10256 MT (The features of the CMS file system of greatest interest to Kermit users are) 135 W( the format of file specifications \050or)134 W /Times-Italic SF 6120 11452 MT (filespecs)SH /Times-Roman SF (\051 and the concept of records. The latter is described in the Kermit-370 chapter.)SH 6120 13844 MT (The VM/CMS)SH /Times-Italic SF 12176 XM (filespec)SH /Times-Roman SF 15481 XM (takes the form)SH /Courier SF 8520 15499 MT (filename filetype filemode)SH /Times-Roman SF 6120 17216 MT (\050often abbreviated FN FT FM\051. The filename and filetype are one to eight characters each. The name field is) 69 W( the)70 W 6120 18412 MT (primary identifier for the file,) 98 W( and the type is an indicator which, by convention, tells what kind of file it is. For)97 W 6120 19608 MT (instance,)SH /Courier SF 9920 XM (TEST FORTRAN)23 W /Times-Roman SF 17416 XM (is the source of a Fortran) 23 W( program named TEST.)24 W /Courier SF 37564 XM (MODULE)SH /Times-Roman SF 41438 XM (is the filetype for executable)24 W 6120 20804 MT (programs \050as distinct from object code, which has a filetype of)29 W /Courier SF 31712 XM (TEXT)SH /Times-Roman SF (!\051. Although) 308 W( some) 29 W( operating systems consider)28 W 6120 22000 MT (the filetype optional,) 3 W( VM/CMS requires a type for each file. Therefore, Kermit-CMS supplies a default type of ``)4 W /Courier SF ($)SH /Times-Roman SF ('')SH 6120 23196 MT (for any received file if no type is provided by the remote system. The same default is used) 47 W( for a missing filename.)46 W 6120 24392 MT (At the same time, the FN and FT are forced to conform to CMS rules in) 147 W( other respects. The FN and FT may)148 W 6120 25588 MT (contain, in any order, uppercase letters, digits, and the special characters ``)19 W /Courier SF ($)SH /Times-Roman SF ('' \050dollar) 19 W( sign\051, ``)18 W /Courier SF (#)SH /Times-Roman SF ('' \050pound sign\051, ``)18 W /Courier SF (@)SH /Times-Roman SF ('')SH 6120 26784 MT (\050at sign\051, ``)1 W /Courier SF (+)SH /Times-Roman SF ('' \050plus\051, ``)1 W /Courier SF (-)SH /Times-Roman SF ('' \050hyphen\051, ``)1 W /Courier SF (:)SH /Times-Roman SF ('' \050colon\051, and ``)1 W /Courier SF (_)SH /Times-Roman SF ('' \050underscore\051. Other characters may be not be included.)2 W 6120 27980 MT (If an invalid character is found in the FN or FT field, it is replaced by an underscore \050or converted to uppercase if it)28 W 6120 29176 MT (is a lowercase letter\051. Also, both FN and FT are truncated, if necessary, to eight characters.)SH 6120 31568 MT (The filemode, which consists of a letter and a number, is similar to a) 209 W( device specification on microcomputer)210 W 6120 32764 MT (systems:)SH /Courier SF 10000 XM (FN FT FM)185 W /Times-Roman SF 15605 XM (would translate to)185 W /Courier SF 23576 XM (FM:FN.FT)SH /Times-Roman SF 28811 XM (in CP/M or MS-DOS if the filemode number is ignored.)185 W 6120 33960 MT (Indeed, the filemode number is more properly an attribute of a file than part of its name -- no two files can) 38 W( co-exist)39 W 6120 35156 MT (with names that match all but the filemode number. Even the filemode letter is not a fixed part of) 139 W( the)138 W /Times-Italic SF 49865 XM (filespec)SH /Times-Roman SF 6120 36352 MT (because the) 87 W( same mini-disk could be accessed under a different mode letter. In some ways, the filemode letter is)88 W 6120 37548 MT (also like a disk directory designator, since) 9 W( many such mini-disks may reside on the same disk drive. For this reason,)8 W 6120 38744 MT (the Kermit concept of the "working directory" is equated with a particular disk) 10 W( mode letter under Kermit-CMS. The)11 W 6120 39940 MT (current "working directory" is, thus, the "home" filemode \050normally ``)10 W /Courier SF (A)SH /Times-Roman SF ('', which is the primary user) 10 W( mini-disk under)9 W 6120 41136 MT (CMS\051, and file transfers take place preferentially to and from the "home" disk. If the) 91 W( filemode is omitted from a)92 W /Times-Italic SF 6120 42332 MT (filespec)SH /Times-Roman SF 9480 XM (when sending, the "home") 55 W( disk is normally used, but there is an option for using a default of ``)54 W /Courier SF (*)SH /Times-Roman SF ('' instead.)54 W 6120 43528 MT (In this case, the user's disks are scanned according to the search order and the first occurrence) 43 W( of the file is the one)44 W 6120 44724 MT (that is sent. If the filemode is omitted from a)123 W /Times-Italic SF 25804 XM (filespec)SH /Times-Roman SF 29231 XM (when receiving, the "home" disk is used with a filemode)122 W 6120 45920 MT (number of ``)SH /Courier SF (1)SH /Times-Roman SF (''.)SH 6120 48312 MT (To provide compatibility with other operating systems, when Kermit-CMS sends a file, it) 109 W( ordinarily makes a file)110 W 6120 49508 MT (header with only the filename and filetype. It also converts the intervening blank to a period. On) 73 W( the other hand,)72 W 6120 50704 MT (extra information may be added by way of the SET FOREIGN subcommand.)SH 6120 53096 MT (VM/CMS allows a group of files to be specified in a single)67 W /Times-Italic SF 30812 XM (filespec)SH /Times-Roman SF 34185 XM (by including the special "wildcard" characters)68 W 6120 54292 MT (``)SH /Courier SF (*)SH /Times-Roman SF ('' and ``)40 W /Courier SF (%)SH /Times-Roman SF (''. A) 330 W( ``)40 W /Courier SF (*)SH /Times-Roman SF ('' matches any string of characters \050even a null string\051 from) 40 W( the current position to the end of)39 W 6120 55488 MT (the field; a ``)SH /Courier SF (%)SH /Times-Roman SF ('' matches any single character. Here are some examples:)SH /Courier SF 7120 57279 MT (* COBOL A)SH /Times-Roman SF 13120 XM (All files of type)SH /Courier SF 19675 XM (COBOL)SH /Times-Roman SF 22925 XM (\050all COBOL source files\051 on the A disk.)SH /Courier SF 7120 58937 MT (F* * *)SH /Times-Roman SF 13120 XM (All files whose names start with F.)SH /Courier SF 7120 60595 MT (% * B)SH /Times-Roman SF 13120 XM (All B-disk files with one-character FN's.)SH 6120 62987 MT (CMS files, like) 230 W( those in other IBM 370 systems, are record-oriented \050see the introduction to the Kermit-370)231 W 6120 64183 MT (chapter\051. In) 578 W( particular, CMS files are characterized by record) 164 W( format \050RECFM\051, which may be fixed-length or)163 W 6120 65379 MT (varying-length, and by maximum record length \050LRECL\051. The size of) 19 W( record blocks is irrelevant, however, because)20 W 6120 66575 MT (CMS performs) 97 W( the blocking and deblocking operations automatically and transparently, including the spanning of)96 W 6120 67771 MT (records across block boundaries. Records in CMS files may be up to 65535 bytes long.)SH 6120 70163 MT (Another file system feature of) 24 W( occasional interest is the means of reporting errors. When Kermit-CMS encounters a)25 W 6120 71359 MT (disk error, it records the function) 14 W( and error code for inclusion in the)13 W /Courier SF 33566 XM (STATUS)SH /Times-Roman SF 37429 XM (report. The) 276 W( explanations can be found)13 W ES %%Page: 193 194 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (9.1. The VM/CMS File System)SH 10 /Times-Italic AF 51275 XM (Page 193)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (in the CMS reference manual under the FSREAD and FSWRITE macros \050which correspond) 130 W( to the RDBUF and)131 W 8280 9082 MT (WRBUF functions\051.)SH 14 /Times-Bold AF 8280 12684 MT (9.2. Program Operation)SH 10 /Times-Roman AF 8280 14802 MT (At startup) 233 W( time, Kermit-CMS looks for two initialization files,)232 W /Courier SF 35508 XM (SYSTEM KERMINI)232 W /Times-Roman SF 44622 XM (and)SH /Times-Italic SF 46548 XM ()SH /Courier SF 50880 XM (KERMINI)SH /Times-Roman SF 8280 15998 MT (\050where)SH /Times-Italic SF 11394 XM ()SH /Times-Roman SF 15582 XM (is the user's logon ID\051.) 88 W( If) 428 W( either of these files exists on more than one disk, it will be read and)89 W 8280 17194 MT (executed from the first copy in the search order. The file)152 W /Courier SF 33180 XM (SYSTEM KERMINI)151 W /Times-Roman SF 42132 XM (should be placed on a publicly)151 W 8280 18390 MT (accessible disk by a systems programmer, preferably the same disk where the Kermit executable module is) 113 W( kept.)114 W 8280 19586 MT (The file)SH /Times-Italic SF 11668 XM ()SH /Courier SF 15768 XM (KERMINI)SH /Times-Roman SF 20218 XM (can be maintained by the user on any convenient disk.)SH 8280 21978 MT (One important distinction between Kermit-CMS and other Kermits is that a program) 126 W( running under VM/CMS is)125 W 8280 23174 MT (unable to interrupt a read on its "console". This means) 167 W( that the CMS version of Kermit cannot time out after)168 W 8280 24370 MT (sending a packet. The only way to time out is from the other side: typing a carriage) 115 W( return to the local Kermit)114 W 8280 25566 MT (causing it to retransmit its last packet, or an automatic timeout as provided by most other Kermits.)SH 8280 27958 MT (Five CP SET parameters \050MSG, IMSG, WNG, ACNT, and TIMER\051 are set OFF) 3 W( during protocol mode \050and restored)4 W 8280 29154 MT (afterwards\051 to prevent CP from interrupting any I/O in progress, and RUN is set ON to ensure) 145 W( that Kermit can)144 W 8280 30350 MT (recover from accidental attention interrupts. Also, on a TTY) 15 W( line, the TERMINAL LINESIZE is set OFF to prevent)16 W 8280 31546 MT (CP from inserting carriage return-linefeed pairs into packets, TERMINAL SCROLL is set to CONT to prevent CP)59 W 8280 32742 MT (pauses, LINEDIT is set OFF to ensure that all characters are taken) 63 W( literally, and the CMS user terminal translation)64 W 8280 33938 MT (tables \050established via the CMS SET INPUT and OUTPUT commands\051) 93 W( are temporarily suppressed for both short)92 W 8280 35134 MT (and long packet protocols. The settings in effect when Kermit starts up are saved) 159 W( as a sort of "normal" status)160 W 8280 36330 MT (snapshot \050as opposed to the "protocol" status just described\051. The protocol status is selected whenever Kermit enters)6 W 8280 37526 MT (protocol mode and also after Kermit executes a CP) 72 W( command in server mode. Similarly, normal status is selected)73 W 8280 38722 MT (when Kermit leaves protocol) 58 W( mode and before Kermit executes a CP command in server mode. Note: if Kermit is)57 W 8280 39918 MT (interrupted in the midst) 106 W( of a transfer or while in server mode, these parameters will be left with peculiar settings)107 W 8280 41114 MT (\050namely, the protocol status\051, and they may need to be restored by hand.)SH 8280 43506 MT (CMS is different from some other IBM mainframe systems in that allows a program to take control) 88 W( of prompting)87 W 8280 44702 MT (and synchronization on ``)224 W /Courier SF (TTY)SH /Times-Roman SF ('' lines. Kermit-CMS takes advantage of this option, and it is not,) 224 W( in general,)225 W 8280 45898 MT (necessary to enable handshaking on the micro Kermit before connecting to CMS.) 148 W( In) 544 W( other words, handshaking)147 W 8280 47094 MT (should be suppressed for both ``)26 W /Courier SF (TTY)SH /Times-Roman SF ('' and ``)26 W /Courier SF (SERIES1)SH /Times-Roman SF ('' devices \050the micro Kermit should have) 26 W( HANDSHAKE set)27 W 8280 48290 MT (OFF, and Kermit-CMS should have HANDSHAKE set to 0\051. Since the generic Kermit-370 default handshake)163 W 8280 49486 MT (\050XON\051 is retained in Kermit-CMS, the subcommand ``)52 W /Courier SF (SET HANDSHAKE 0)52 W /Times-Roman SF ('' is a good candidate for inclusion) 52 W( in)53 W /Courier SF 8280 50682 MT (SYSTEM KERMINI)SH /Times-Roman SF (.)SH 12 /Times-Bold AF 8280 53270 MT (Interactive Operation:)SH 10 /Times-Roman AF 8280 54684 MT (To run Kermit-CMS interactively, invoke the program from CMS by typing)SH /Courier SF 38945 XM (KERMIT)SH /Times-Roman SF (. When) 250 W( you see the prompt,)SH /Courier SF 10680 56339 MT (Kermit-CMS>)SH /Times-Roman SF 8280 58056 MT (you may type a Kermit subcommand. When the subcommand completes, Kermit issues another prompt.) 28 W( The) 304 W( cycle)27 W 8280 59252 MT (repeats until you exit from the program. For example:)SH /Courier SF 10680 60907 MT (KERMIT)SH 3600 50 10680 61107 UL 10680 62562 MT (Kermit-CMS Version 4.0 \05088/1/31\051)SH 10680 63593 MT (Enter ? for a list of valid commands)SH 10680 65248 MT (Kermit-CMS>send foo *)SH 6000 50 17280 65448 UL /Times-Italic SF 11880 66963 MT (Files with fn FOO are sent)SH /Courier SF 10680 68618 MT (Kermit-CMS>receive test spss)SH 10200 50 17280 68818 UL /Times-Italic SF 11880 70333 MT (File is received and called TEST SPSS A1)SH /Courier SF 10680 71988 MT (Kermit-CMS>exit)SH 2400 50 17280 72188 UL ES %%Page: 194 195 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 194)SH 12 /Times-Bold AF 26753 XM (Kermit User Guide: IBM VM/CMS KERMIT \0509.2\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (The prompt string under CMS is truly interactive. In other words, the string \050without) 94 W( carriage return or linefeed\051)95 W 6120 9082 MT (appears only when fresh input is) 217 W( needed from the terminal. If, for example, Kermit is invoked after several)216 W 6120 10278 MT (subcommands have been stacked up, the stack is read and executed before the first prompt appears.)SH 12 /Times-Bold AF 6120 12866 MT (Command Line Invocation:)SH 10 /Times-Roman AF 6120 14280 MT (Kermit-CMS may also be invoked with command line arguments from CMS. The arguments are interpreted as) 31 W( one)32 W 6120 15476 MT (or more subcommands to be executed by Kermit after completion of the initialization. For instance:)SH /Courier SF 8520 17131 MT (KERMIT send test fortran)SH 14400 50 8520 17331 UL /Times-Roman SF 6120 18433 MT (or)SH /Courier SF 8520 19673 MT (KERMIT set debug on # set file binary # server)SH 27600 50 8520 19873 UL /Times-Roman SF 6120 22065 MT (Kermit will exit and return) 22 W( to CMS after completing the specified subcommand or subcommands. Note that several)21 W 6120 23261 MT (commands may) 106 W( be given on the command line as long as they are separated by the LINEND character, which is)107 W 6120 24457 MT (pound sign in this case. Note that the LINEND is a concept of CP, rather than Kermit, and applies only to)205 W 6120 25653 MT (commands entered from the terminal and only when LINEDIT is) 153 W( on. A command line may contain up to 130)154 W 6120 26849 MT (characters.)SH 12 /Times-Bold AF 6120 29437 MT (EXEC Operation:)SH 10 /Times-Roman AF 6120 30851 MT (Like other CMS) 138 W( programs, Kermit-CMS may be invoked from a CMS EXEC. Subcommands can be passed to)137 W 6120 32047 MT (Kermit using the program stack and/or command line arguments. For example, to start) 29 W( up Kermit-CMS and have it)30 W 6120 33243 MT (act as a server, include the line:)SH /Courier SF 8520 34898 MT (KERMIT server)SH 7800 50 8520 35098 UL /Times-Roman SF 6120 36615 MT (To pass more than one subcommand, they must be) 8 W( stacked in the order in which they are to be executed. To start up)7 W 6120 37811 MT (a Kermit-CMS server with a three character CRC, include:)SH /Courier SF 8520 39466 MT (&STACK set block 3)SH 10800 50 8520 39666 UL 8520 40497 MT (&STACK server)SH 7800 50 8520 40697 UL 8520 41528 MT (KERMIT)SH 3600 50 8520 41728 UL /Times-Roman SF 6120 43245 MT (Another way of setting up multiple subcommands) 44 W( would be to collect the subcommands into a TAKE file and then)45 W 6120 44441 MT (issue the TAKE subcommand via the command line or program stack.) 70 W( Of) 389 W( course, EXEC's may be executed from)69 W 6120 45637 MT (Kermit, either directly or from a) 11 W( TAKE file, and Kermit subcommands, in turn, may be issued from EXEC's as long)12 W 6120 46833 MT (as Kermit is active. See the TAKE subcommand for more details.)SH 12 /Times-Bold AF 6120 49421 MT (Server mode:)SH 10 /Times-Roman AF 6120 50835 MT (Command execution in server mode is different in several respects from normal operation. First of all,) 11 W( some Kermit)10 W 6120 52031 MT (subcommands are not) 8 W( allowed \050see the list of subcommands in the Kermit-370 chapter\051. Moreover, command errors)9 W 6120 53227 MT (always terminate any active TAKE file.) 102 W( Also,) 453 W( commands other than CP commands run in a special environment)101 W 6120 54423 MT (with RUN ON, TIMER OFF, and so forth. Another difference is) 1 W( that Kermit intercepts all SVC instructions in order)2 W 6120 55619 MT (to catch console I/O and transmit the data to) 84 W( the local Kermit as text packets. Since Kermit does not emulate the)83 W 6120 56815 MT (substitution functions of the LINEDIT macro, some messages will appear rather cryptic.) 78 W( A) 407 W( more serious problem)79 W 6120 58011 MT (with this redirection is that some VM/CMS system commands may issue console I/O directly to CP, so that) 80 W( some)79 W 6120 59207 MT (messages never appear to the local Kermit \050except,) 248 W( perhaps, as bad packets\051. For non-TTY terminals, such)249 W 6120 60403 MT (messages are stacked up in the console output queue and appear all at once when Kermit returns from server mode.)SH ES %%Page: 195 196 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (9.3. Kermit-CMS Subcommands)SH 10 /Times-Italic AF 51275 XM (Page 195)SH 46800 50 8280 5709 UL 14 /Times-Bold AF 8280 8138 MT (9.3. Kermit-CMS Subcommands)SH 10 /Times-Roman AF 8280 10256 MT (Kermit-CMS supports) 88 W( all the subcommands described in the corresponding section of the Kermit-370 chapter. In)87 W 8280 11452 MT (addition, there) 121 W( are two more, both of which can be issued as remote Kermit commands when Kermit-CMS is in)122 W 8280 12648 MT (server mode. The first is)101 W /Courier SF 19134 XM (CMS)SH /Times-Roman SF (, which is just a synonym) 101 W( for the generic HOST subcommand. The second is)100 W /Courier SF 53630 XM (CP)SH /Times-Roman SF (,)SH 8280 13844 MT (which specifically issues a command to CP. In most circumstances, the latter is) 80 W( not needed, since CMS will pass)81 W 8280 15040 MT (along CP commands to CP.)SH 8280 17432 MT (The remainder of this section concentrates on the subcommands that have) 4 W( special form or meaning for Kermit-CMS.)3 W 8280 18628 MT (See also the chapter on Kermit-370 for further details.)SH 13 /Times-Bold AF 24708 21987 MT (The SEND Subcommand)SH 10 /Times-Roman AF 8280 24360 MT (Syntax:)SH /Courier SF 11586 XM (SEND)SH /Times-Italic SF 14586 XM (filespec)SH /Courier SF 18241 XM ([)SH /Times-Italic SF (foreign-filespec)SH /Courier SF (])SH /Times-Roman SF 8280 26752 MT (The SEND subcommand causes a file or file group to be sent from CMS to the Kermit on the other) 15 W( system.)16 W /Times-Italic SF 52025 XM (filespec)SH /Times-Roman SF 8280 27948 MT (takes the form:)SH /Courier SF 10680 29603 MT (filename filetype [filemode])SH /Times-Roman SF 8280 31320 MT (but the filemode if optional only if the)SH /Times-Italic SF 23835 XM (foreign-filespec)SH /Times-Roman SF 30362 XM (is omitted.)SH /Times-Italic SF 8280 33712 MT (filespec)SH /Times-Roman SF 11589 XM (may contain the wildcard characters ``)4 W /Courier SF (*)SH /Times-Roman SF ('' or) 4 W( ``)3 W /Courier SF (%)SH /Times-Roman SF (''. If)256 W /Times-Italic SF 33178 XM (filespec)SH /Times-Roman SF 36486 XM (contains wildcard characters then all matching)3 W 8280 34908 MT (files will be) 16 W( sent. If, however, a file exists by the same name on more than one disk, only the first one Kermit-CMS)17 W 8280 36104 MT (encounters, according to the disk search order, is sent. See also the CWD subcommand.)SH 8280 38496 MT (The)SH /Times-Italic SF 10216 XM (foreign-filespec)SH /Times-Roman SF (, if any, is used for the file header of the outgoing file, replacing the) 131 W( usual filename.filetype)130 W 8280 39692 MT (copied from the CMS)SH /Times-Italic SF 17224 XM (filespec)SH /Times-Roman SF (. It) 250 W( may take one of two forms:)SH /Courier SF 10680 41347 MT (filename filetype)SH /Times-Roman SF 8280 43064 MT (or)SH /Courier SF 10680 44719 MT (arbitrary-string)SH /Times-Roman SF 8280 46436 MT (Normally, this form of the SEND subcommand is used only for) 18 W( single files because the)19 W /Times-Italic SF 43718 XM (foreign-filespec)SH /Times-Roman SF 50264 XM (is used only)19 W 8280 47632 MT (for the first file of a group \050subsequent files) 185 W( having default headers\051. However, in the two-token form of the)184 W /Times-Italic SF 8280 48828 MT (foreign-filespec)SH /Times-Roman SF 14833 XM (either the name or type may be an Equals sign ``)27 W /Courier SF (=)SH /Times-Roman SF ('' to signify that the corresponding CMS name or)27 W 8280 50024 MT (type is to be retained in the file header. In that case, the partial renaming carries) 26 W( through an entire group of files. It)25 W 8280 51220 MT (is the user's responsibility to prevent such partial renaming from sending duplicate file headers within a file group.)SH 8280 53612 MT (Although the file transfer cannot be cancelled from) 36 W( the CMS side, Kermit-CMS is capable of responding to "cancel)37 W 8280 54808 MT (file" or "cancel batch") 58 W( signals from the local Kermit; these are typically entered by typing Control-X or Control-Z,)57 W 8280 56004 MT (respectively.)SH 13 /Times-Bold AF 23480 59363 MT (The RECEIVE Subcommand)SH 10 /Times-Roman AF 8280 61736 MT (Syntax:)SH /Courier SF 11586 XM (RECEIVE [)SH /Times-Italic SF (filespec)SH /Courier SF (])SH /Times-Roman SF 8280 64128 MT (The RECEIVE subcommand tells Kermit to receive a file) 112 W( or file group from the other system. You should then)113 W 8280 65324 MT (issue a SEND subcommand to the other Kermit.)SH 8280 67716 MT (The format of)SH /Times-Italic SF 14084 XM (filespec)SH /Times-Roman SF 17389 XM (is:)SH /Courier SF 10680 69371 MT (filename filetype [filemode])SH /Times-Roman SF 8280 71763 MT (If the optional)55 W /Times-Italic SF 14360 XM (filespec)SH /Times-Roman SF 17719 XM (is omitted, Kermit-CMS will use the name\050s\051 provided by the other Kermit. If that name is)54 W ES %%Page: 196 197 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 196)SH 12 /Times-Bold AF 26753 XM (Kermit User Guide: IBM VM/CMS KERMIT \0509.3\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (not a legal CMS file name, Kermit-CMS will delete excess characters and will change illegal characters) 264 W( to)265 W 6120 9082 MT (underscores. A)414 W /Times-Italic SF 12864 XM (filespec)SH /Times-Roman SF 16251 XM (in the subcommand indicates what name the incoming file should be given.) 82 W( The)412 W /Times-Italic SF 49865 XM (filespec)SH /Times-Roman SF 6120 10278 MT (may include a filemode to designate the) 53 W( destination disk. If none is provided, the file will be saved on the "home")54 W 6120 11474 MT (disk with filemode number ``)53 W /Courier SF (1)SH /Times-Roman SF (''. If) 356 W( you want to use the same name but a different filemode,) 53 W( specify ``)52 W /Courier SF (= = FM)52 W /Times-Roman SF (''.)SH 6120 12670 MT (Wildcards may not be used.)SH 6120 15062 MT (If the optional)173 W /Times-Italic SF 12555 XM (filespec)SH /Times-Roman SF 16033 XM (is provided, but more) 173 W( than one file arrives, the first file will be stored under the given)174 W /Times-Italic SF 6120 16258 MT (filespec)SH /Times-Roman SF (, and the remainder will be stored under) 63 W( their own names on the "home" disk. If, however, ``)62 W /Courier SF (= = FM)62 W /Times-Roman SF ('' is)62 W 6120 17454 MT (used, all files will be placed onto the specified disk.)SH 6120 19846 MT (When the record format is "F", any received record longer than the logical record length \050LRECL\051 will be) 12 W( truncated,)13 W 6120 21042 MT (and shorter records will be padded.) 165 W( The) 578 W( padding character is a blank for text files and a null for binary files.)164 W 6120 22238 MT (Received binary \050but not V-binary or D-binary\051 files are treated as byte streams and broken up into records all of the)10 W 6120 23434 MT (logical record length. See the SET FILE TYPE, SET FILE LRECL, and SET FILE RECFM subcommands.)SH 6120 25826 MT (If an error occurs during the file transfer, as much of the file) 63 W( as was received is saved on disk. If the sending of a)62 W 6120 27022 MT (file is cancelled by the user of the foreign system, Kermit-CMS will discard whatever had arrived, unless) 36 W( APPEND)37 W 6120 28218 MT (is ON or INCOMPLETE is KEEP.)SH 6120 30610 MT (If the incoming file has the) 216 W( same name as an existing file, and WARNING is OFF, the original file will be)215 W 6120 31806 MT (overwritten. If) 292 W( WARNING is set ON,) 21 W( however, Kermit-CMS will change the incoming name so as not to obliterate)22 W 6120 33002 MT (the pre-existing file. It attempts to find a) 43 W( unique name by successively modifying the original and checking for the)42 W 6120 34198 MT (existence of) 48 W( such a file at each step. The procedure begins by truncating the filetype to six characters if necessary,)49 W 6120 35394 MT (and then appending ``)30 W /Courier SF ($0)SH /Times-Roman SF (''. If) 310 W( a file by that name exists, Kermit then replaces the ``)30 W /Courier SF (0)SH /Times-Roman SF ('' with a ``)30 W /Courier SF (1)SH /Times-Roman SF (''. It) 310 W( continues in)29 W 6120 36590 MT (this manner up to ``)SH /Courier SF (9)SH /Times-Roman SF ('', and if an unused name cannot be found, the transfer fails.)SH 13 /Times-Bold AF 22910 39949 MT (The GET Subcommand)SH 10 /Times-Roman AF 6120 42322 MT (Syntax:)SH /Courier SF 9426 XM (GET)SH /Times-Italic SF 11826 XM (foreign-filespec)SH /Courier SF 18703 XM ([)SH /Times-Italic SF (filespec)SH /Courier SF (])SH /Times-Roman SF 6120 44714 MT (The GET subcommand tells Kermit to request a file or file group from the other system, which must) 36 W( have a Kermit)37 W 6120 45910 MT (running in server) 19 W( mode. The syntax is complicated by the allowance of two forms for the)18 W /Times-Italic SF 42533 XM (foreign-filespec)SH /Times-Roman SF (, just as in)18 W 6120 47106 MT (the SEND subcommand. Here the parsing is based on the number of "words" \050blank-delimited strings\051) 179 W( in the)180 W 6120 48302 MT (subcommand argument,) 288 W( which can be anything from one to five. If the number is anything but four, the)287 W 6120 49498 MT (interpretation is unambiguous, but when there are four words, the first word plays the key role. If it has more) 49 W( than)50 W 6120 50694 MT (eight characters or contains a ``)54 W /Courier SF (.)SH /Times-Roman SF ('' or ``)54 W /Courier SF (/)SH /Times-Roman SF ('', it is assumed to be the whole)54 W /Times-Italic SF 36345 XM (foreign-filespec)SH /Times-Roman SF (; otherwise, it is) 54 W( assumed)53 W 6120 51890 MT (to be the first of two words that, when joined by a ``)SH /Courier SF (.)SH /Times-Roman SF ('', make up the)SH /Times-Italic SF 33882 XM (filespec)SH /Times-Roman SF 37187 XM (on the other system.)SH 13 /Times-Bold AF 22440 55249 MT (The TAKE Subcommand)SH 10 /Times-Roman AF 6120 57622 MT (Syntax:)SH /Courier SF 9426 XM (TAKE)SH /Times-Italic SF 12426 XM (filespec)SH /Times-Roman SF 6120 60014 MT (Execute Kermit subcommands from the specified file, where)24 W /Times-Italic SF 30890 XM (filespec)SH /Times-Roman SF 34219 XM (has the format)24 W /Courier SF 40263 XM (fn [ft [fm]])25 W /Times-Roman SF (. The) 300 W( default)25 W 6120 61210 MT (filetype is ``)SH /Courier SF (TAKE)SH /Times-Roman SF ('', and the default filemode is ``)SH /Courier SF (*)SH /Times-Roman SF (''.)SH 6120 63602 MT (Kermit subcommands may also be executed from CMS EXEC's, so that the TAKE subcommand is,) 139 W( in a sense,)138 W 6120 64798 MT (superfluous under VM/CMS. In CMS terminology, Kermit establishes) 134 W( a Kermit subcommand environment, and)135 W 6120 65994 MT (EXEC's written in EXEC 2 or) 43 W( REXX may invoke subcommands within that environment. For example, to display)42 W 6120 67190 MT (the current packet checksum type, an EXEC 2 would issue)SH /Courier SF 8520 68845 MT (&SUBCOMMAND KERMIT SHOW BLOCK-CHECK)SH /Times-Roman SF 6120 70562 MT (and a REXX macro would issue)SH ES %%Page: 197 198 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (9.3. Kermit-CMS Subcommands)SH 10 /Times-Italic AF 51275 XM (Page 197)SH 46800 50 8280 5709 UL /Courier SF 10680 7824 MT (Address KERMIT 'SHOW BLOCK-CHECK')SH /Times-Roman SF 8280 9541 MT (There is one important difference between executing a TAKE file and an) 73 W( EXEC: the former may issue a QUIT or)74 W 8280 10737 MT (EXIT subcommand, but the latter) 10 W( may not. Also, a Kermit subcommand issued from an EXEC returns a completion)9 W 8280 11933 MT (code according to the current error status \050see) 22 W( the table under "After Kermit Completes" in the Kermit-370 chapter\051.)23 W 8280 13129 MT (An EXEC could therefore be set up to react appropriately to file transmission errors or other unpredictable events.)SH 13 /Times-Bold AF 25214 16488 MT (The SET Subcommand)SH 10 /Times-Roman AF 8280 18861 MT (Syntax:)SH /Courier SF 11586 XM (SET)SH /Times-Italic SF 13986 XM (parameter)SH /Courier SF 18752 XM ([)SH /Times-Italic SF (value)SH /Courier SF (])SH /Times-Roman SF 8280 21253 MT (The SET subcommand establishes or modifies various parameters controlling file transfers. The) 143 W( following SET)142 W 8280 22449 MT (parameters are available in Kermit-CMS, but not in Kermit-370 in general:)SH 8280 24059 MT (DESTINATION)SH 22680 XM ("Home" disk.)SH 8280 25164 MT (FILE)SH 8780 26269 MT (LRECL)SH 22680 XM (Logical Record length for incoming file.)SH 8780 27374 MT (RECFM)SH 22680 XM (Record format for incoming files.)SH 8280 28479 MT (SEARCH-ALL)SH 22680 XM (Determine the default disk search scope.)SH 12 /Times-Bold AF 8280 31067 MT (SET DESTINATION)SH 10 /Times-Roman AF 8280 32481 MT (Syntax: SET DESTINATION)SH /Times-Italic SF 20529 XM (letter)SH /Times-Roman SF 8280 34873 MT (This subcommand is equivalent to the CWD subcommand \050q.v.\051.)SH 12 /Times-Bold AF 8280 37461 MT (SET FILE LRECL)SH 10 /Times-Roman AF 8280 38875 MT (Syntax:)SH /Courier SF 11586 XM (SET FILE LRECL)SH /Times-Italic SF 20586 XM (number)SH /Times-Roman SF 8280 41267 MT (This sets the logical record length for incoming files to a)78 W /Times-Italic SF 32052 XM (number)SH /Times-Roman SF 35435 XM (from 1 to 65535 \05064K-1\051. This variable is) 78 W( used)79 W 8280 42463 MT (only for fixed format and binary files. The default is 80.)SH 12 /Times-Bold AF 8280 45051 MT (SET FILE RECFM)SH 10 /Times-Roman AF 8280 46465 MT (Syntax:)SH /Courier SF 11586 XM (SET FILE RECFM)SH /Times-Italic SF 20586 XM (option)SH /Times-Roman SF 8280 48857 MT (This sets the record format to use for incoming files. Valid)192 W /Times-Italic SF 34553 XM (option)SH /Times-Roman SF (s are "Fixed" and) 192 W( "Variable" \050the default\051.)191 W 8280 50053 MT (Fixed-format records are padded or truncated, as needed, to the current LRECL.)SH 12 /Times-Bold AF 8280 52641 MT (SET SEARCH-ALL)SH 10 /Times-Roman AF 8280 54055 MT (Syntax:)SH /Courier SF 11586 XM (SET SEARCH-ALL ON)SH /Times-Italic SF 22386 XM (or)SH /Courier SF 23875 XM (OFF)SH /Times-Roman SF 8280 55846 MT (ON)SH 12280 XM (If the user omits the filemode from) 220 W( a SEND subcommand \050or a GET request to the other Kermit\051,)221 W 12280 56951 MT (Kermit-CMS will search all accessed disks for the named file or files.)SH 8280 58609 MT (OFF)SH 12280 XM (If the) 118 W( filemode is not specified, only the "home" disk and its read-only extensions will be searched for)117 W 12280 59714 MT (matching files. \050Default.\051)SH ES %%Page: 198 199 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 198)SH 12 /Times-Bold AF 26753 XM (Kermit User Guide: IBM VM/CMS KERMIT \0509.3\051)SH 46800 50 6120 5709 UL 13 SS 22693 8071 MT (The CWD Subcommand)SH 10 /Times-Roman AF 6120 10444 MT (Syntax:)SH /Courier SF 9426 XM (CWD)SH /Times-Italic SF 11826 XM (letter)SH /Times-Roman SF 6120 12836 MT (The CWD \050Change Working Directory\051 subcommand establishes a new default \050"home"\051 CMS) 46 W( disk.)47 W /Times-Italic SF 47549 XM (letter)SH /Times-Roman SF 49957 XM (may be)47 W 6120 14032 MT (the mode letter of any accessed disk. Subsequent file transfers take place preferentially to and from the default) 12 W( disk.)11 W 6120 15228 MT (The initial home disk is ``)SH /Courier SF (A)SH /Times-Roman SF (''. Note:) 250 W( setting the home disk in Kermit has no effect on the CMS search order.)SH 13 /Times-Bold AF 20309 18587 MT (The DIRECTORY Subcommand)SH 10 /Times-Roman AF 6120 20960 MT (Syntax:)SH /Courier SF 9426 XM (DIRECTORY [)SH /Times-Italic SF (filespec)SH /Courier SF (])SH /Times-Roman SF 6120 23352 MT (Under Kermit-CMS, the DIRECTORY subcommand is identical to the CMS LISTFILE command.)SH 13 /Times-Bold AF 22151 26711 MT (The SPACE Subcommand)SH 10 /Times-Roman AF 6120 29084 MT (Syntax:)SH /Courier SF 9426 XM (SPACE [)SH /Times-Italic SF (letter)SH /Courier SF (])SH /Times-Roman SF 6120 31476 MT (This subcommand displays the storage) 87 W( allocation on the specified CMS disk. If)88 W /Times-Italic SF 39480 XM (letter)SH /Times-Roman SF 41929 XM (is omitted, the default disk)88 W 6120 32672 MT (specified by the CWD subcommand is displayed. Aside from this default,) 59 W( the subcommand is identical with CMS)58 W 6120 33868 MT (QUERY DISK.)SH 13 /Times-Bold AF 22621 37227 MT (The GIVE Subcommand)SH 10 /Times-Roman AF 6120 39600 MT (Syntax:)SH /Courier SF 9426 XM (GIVE)SH /Times-Italic SF 12426 XM (table-name filespec)350 W /Times-Roman SF 6120 41992 MT (This subcommand compares the named table with its default values and saves the differences in a) 17 W( TAKE file named)18 W /Times-Italic SF 6120 43188 MT (filespec)SH /Times-Roman SF (. The) 358 W( format of)54 W /Times-Italic SF 15999 XM (filespec)SH /Times-Roman SF 19358 XM (is)SH /Courier SF 20329 XM (fn [ft) 54 W( [fm]])53 W /Times-Roman SF (. The) 356 W( default filetype is ``)53 W /Courier SF (TAKE)SH /Times-Roman SF ('', and the default filemode is)53 W 6120 44384 MT (that of the "home" disk. See the CWD subcommand.)SH 13 /Times-Bold AF 20345 47743 MT (The CP and CMS Subcommands)SH 10 /Times-Roman AF 6120 50116 MT (Syntax:)SH /Courier SF 9426 XM (CP)SH /Times-Italic SF 11226 XM (or)SH /Courier SF 12715 XM (CMS)SH /Times-Italic SF 15115 XM (text of command)SH /Times-Roman SF 6120 52508 MT (Although Kermit-CMS does not have a full set of its own subcommands for) 52 W( managing local files, it provides those)53 W 6120 53704 MT (services through the operating system. You can issue any) 147 W( CP or CMS command, but if Kermit-CMS has been)146 W 6120 54900 MT (invoked as a normal user-area program, rather than as a high-memory) 153 W( "resident" program or nucleus extension,)154 W 6120 56096 MT (other user-area) 86 W( CMS commands \050such as COPYFILE\051 are illegal. Even then, you can list, type, rename or delete)85 W 6120 57292 MT (files, send messages, and so on. The)SH /Courier SF 21090 XM (CMS)SH /Times-Roman SF 23140 XM (subcommand under Kermit is synonymous with the)SH /Courier SF 44056 XM (HOST)SH /Times-Roman SF 46706 XM (subcommand.)SH 14 /Times-Bold AF 6120 60894 MT (9.4. How to build an executable version of Kermit-CMS)SH 10 /Times-Roman AF 6120 63012 MT (Before attempting to build Kermit-CMS, look in the Kermit distribution under both IK0KER and IKCKER) 83 W( for an)84 W 6120 64208 MT (installation document, as well as "beware", help, and update files, and read them first.) 63 W( They) 375 W( will probably contain)62 W 6120 65404 MT (information that is more current than what you see here.)SH 6120 67796 MT (Kermit-CMS consists at present of a large assembly and a small optional one. The large) 178 W( assembly \050KERMIT)179 W 6120 68992 MT (ASSEMBLE\051 contains the Kermit program, and the) 52 W( small one \050KERMBOOT ASSEMBLE\051 is a bootstrap program)51 W 6120 70188 MT (for loading Kermit into high memory and running it. Although KERMBOOT is) 188 W( all in one file in the Kermit)189 W 6120 71384 MT (distribution, the source for Kermit itself is in many pieces, some generic for Kermit-370 and) 28 W( some specific to CMS.)27 W ES %%Page: 199 200 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (9.4. How to build an executable version of Kermit-CMS)SH 10 /Times-Italic AF 51275 XM (Page 199)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (All the necessary pieces) 104 W( are sequenced in columns 73-80 so that the numbers form a strictly increasing sequence)105 W 8280 9082 MT (when the pieces are correctly "pasted" together. It is important to) 88 W( preserve the original sequence numbers so that)87 W 8280 10278 MT (updates, if any, can be applied to the source.)SH 8280 12670 MT (To create a runnable version:)SH 10280 14461 MT (1.)SH 11280 XM (Combine the following ``)10 W /Courier SF (ASM)SH /Times-Roman SF ('' files from the Kermit distribution into a single file with)10 W /Courier SF 46664 XM (RECFM F)11 W /Times-Roman SF 51136 XM (and)SH /Courier SF 11280 15566 MT (LRECL 80)76 W /Times-Roman SF (: IK0DOC, IK0MAC, IKCMAC,) 76 W( IK0DEF, IK0MAI, IK0CMD, IK0COM, IKCUTL, and)75 W 11280 16671 MT (IK0PRO. The) 390 W( resulting file is the composite source for) 70 W( Kermit-CMS, called KERMIT ASSEMBLE.)71 W 11280 17776 MT (This source must retain the original sequence numbers in) 63 W( columns 73-80 \050in other words, be sure not)62 W 11280 18881 MT (to resequence the source accidentally by using the editor!\051)SH 10280 20539 MT (2.)SH 11280 XM (Copy or rename IKCBOO ASM from the Kermit distribution) 18 W( \050if desired\051 to a file called KERMBOOT)19 W 11280 21644 MT (ASSEMBLE with)SH /Courier SF 18781 XM (RECFM F)SH /Times-Roman SF 23231 XM (and)SH /Courier SF 24925 XM (LRECL 80)SH /Times-Roman SF (.)SH 10280 23302 MT (3.)SH 11280 XM (GLOBAL the) 121 W( necessary MACLIBs. Under VM/SP, these are DMSSP, CMSLIB, OSMACRO, and)120 W 11280 24407 MT (TSOMAC.)SH 10280 26065 MT (4.)SH 11280 XM (Assemble the source file\050s\051.)SH 10280 27723 MT (5.)SH 11280 XM (Load one file into memory via:)35 W /Courier SF 24211 XM (LOAD KERMIT)35 W /Times-Roman SF 31131 XM (or)SH /Courier SF 32249 XM (LOAD KERMBOOT)35 W /Times-Roman SF (. In) 320 W( the former case, the entire)36 W 11280 28828 MT (Kermit program is now loaded;) 22 W( in the latter, only a bootstrap program which expects to find the object)21 W 11280 29933 MT (file)SH /Courier SF 13008 XM (KERMIT TEXT)145 W /Times-Roman SF 20148 XM (at run time. Under) 145 W( CMS/SP Release 4 and above, there is a third and better)146 W 11280 31038 MT (option, namely,)SH /Courier SF 17780 XM (LOAD KERMIT \050RLDSAVE\051)SH /Times-Roman SF (.)SH 10280 32696 MT (6.)SH 11280 XM (Create the executable called)302 W /Courier SF 23984 XM (KERMIT MODULE)302 W /Times-Roman SF 32638 XM (via:)SH /Courier SF 34689 XM (GENMOD KERMIT)301 W /Times-Roman SF (. Alternatively) 852 W( \050under)301 W 11280 33801 MT (CMS/SP Release 3) 112 W( and below\051, create both KERMIT and KERMBOOT modules to give the user a)113 W 11280 34906 MT (choice of user-area or high-memory execution. Since Kermit-CMS is) 193 W( serially reusable, it can be)192 W 11280 36011 MT (reinvoked in the user area with the) 42 W( START command, but the high-memory version must be reloaded)43 W 11280 37116 MT (each time. If Kermit is loaded using the RLDSAVE option \050Release 4 and above\051, the module) 31 W( can, in)30 W 11280 38221 MT (fact, be) 26 W( run either way; the command)27 W /Courier SF 26631 XM (NUCXLOAD KERMIT)27 W /Times-Roman SF 35935 XM (will load Kermit "permanently" into high)27 W 11280 39326 MT (memory as a nucleus extension for) 9 W( invocation at need. Note: the nucleus extension can be removed by)8 W 11280 40431 MT (the command)SH /Courier SF 16946 XM (NUCXDROP KERMIT)SH /Times-Roman SF (.)SH 10280 42089 MT (7.)SH 11280 XM (If your site's ASCII/EBCDIC) 35 W( translation table for TTY lines does not conform to the one listed in the)36 W 11280 43194 MT (appendix \050which in turn conforms to the one given in the IBM) 28 W( System/370 Reference Summary\051, then)27 W 11280 44299 MT (enter the appropriate SET ATOE/ETOA/TATOE/TETOA) 92 W( subcommands in the SYSTEM KERMINI)93 W 11280 45404 MT (file, which should reside on) 65 W( the same disk as KERMIT MODULE \050and KERMIT TEXT\051.)64 W /Times-Italic SF 48711 XM (NOTE:)SH /Times-Roman SF 51914 XM (If)SH 11280 46509 MT (the ASCII/EBCDIC translation is not invertible, Kermit will not and cannot work.)SH 14 /Times-Bold AF 8280 50111 MT (9.5. What's New)SH 10 /Times-Roman AF 8280 52229 MT (Below is a list of the more important CMS-specific features in Version 4.0) 12 W( of Kermit-CMS added since the previous)13 W 8280 53425 MT (release, Version 3.1, in September 1986. For the list of generic additions, see the chapter on Kermit-370.)SH 10280 55216 MT (1.)SH 11280 XM (System commands issued) 227 W( through Kermit via the)226 W /Courier SF 32780 XM (CMS)SH /Times-Roman SF 35056 XM (or)SH /Courier SF 36365 XM (HOST)SH /Times-Roman SF 39241 XM (subcommands are automatically)226 W 11280 56321 MT (passed on to CP if \050a\051 CMS rejects them and \050b\051 IMPCP is set ON.)SH 10280 57979 MT (2.)SH 11280 XM (Kermit subcommands may be executed directly from CMS EXEC's.)SH 10280 59637 MT (3.)SH 11280 XM (Reject files known \050via A-packets\051 to be too big for available storage.)SH 10280 61295 MT (4.)SH 11280 XM (Bypass user translation tables and set TERMINAL SCROLL CONT for protocol mode on TTY lines.)SH 10280 62953 MT (5.)SH 11280 XM (KERMBOOT avoids the loading problem \050)108 W /Courier SF (VIRTUAL STORAGE CAPACITY EXCEEDED)109 W /Times-Roman SF (\051 due to)109 W 11280 64058 MT (large GLOBAL TXTLIB's and preserves the untokenized command line so that Kermit) 42 W( may be given)41 W 11280 65163 MT (mixed-case or long words as part of the initial command.)SH ES %%Page: 200 201 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 200)SH 12 /Times-Bold AF 26753 XM (Kermit User Guide: IBM VM/CMS KERMIT \0509.6\051)SH 46800 50 6120 5709 UL 14 SS 6120 8138 MT (9.6. What's Missing)SH 10 /Times-Roman AF 6120 10256 MT (Work on Kermit-CMS will continue. Features that need to be improved or added include:)SH /Symbol SF 7910 12161 MT (\267)SH /Times-Roman SF 8620 XM (Allow timeouts so Kermit-CMS does not wait forever if a packet does) 96 W( not arrive in a timely fashion.)97 W 8620 13266 MT (This is not possible under CMS at present.)SH /Symbol SF 7910 15255 MT (\267)SH /Times-Roman SF 8620 XM (Detect file properties from Attribute packets and allow overriding current parameter settings. Also)169 W 8620 16360 MT (implement file archiving.)SH /Symbol SF 7910 18349 MT (\267)SH /Times-Roman SF 8620 XM (Add a)SH /Courier SF 11286 XM (SET REPEAT)SH /Times-Roman SF 17536 XM (subcommand.)SH /Symbol SF 7910 20338 MT (\267)SH /Times-Roman SF 8620 XM (Finish)SH /Courier SF 11372 XM (SET LINE)1 W /Times-Roman SF (, so that) 1 W( Kermit-CMS can be used as a local Kermit, connecting to a remote host over)2 W 8620 21443 MT (an alternate communication port. Add a)SH /Courier SF 25006 XM (CONNECT)SH /Times-Roman SF 29456 XM (subcommand.)SH /Symbol SF 7910 23432 MT (\267)SH /Times-Roman SF 8620 XM (Intercept CP messages during protocol mode, rather than) 54 W( just suppressing them. Display the messages)53 W 8620 24537 MT (later or log them or send in packets as appropriate.)SH /Symbol SF 7910 26526 MT (\267)SH /Times-Roman SF 8620 XM (Define EXEC variables from Kermit by analogy with the XEDIT EXTRACT subcommand.)SH ES %%Page: 201 202 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (10. IBM MVS/TSO KERMIT)SH 10 /Times-Italic AF 51275 XM (Page 201)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 8280 8272 MT (10. IBM MVS/TSO KERMIT)SH 10 /Times-Italic AF 8280 10566 MT (Program:)SH /Times-Roman SF 15280 XM (John Chandler) 30 W( \050Harvard/Smithsonian Center for Astrophysics\051; contributions from Vace Kundakci)31 W 15280 11671 MT (and Daphne Tzoar \050Columbia U\051, Bob Shields \050U. Maryland\051, Victor Lee) 212 W( \050Queens U.\051, Gary)211 W 15280 12776 MT (Bjerke \050U. Texas) 66 W( at Austin\051, Greg Small \050UC Berkeley\051, Clark Frazier \050Harvard Bus. Sch.\051, Bob)67 W 15280 13881 MT (Bolch and Steve) 20 W( Blankinship \050Triangle\051, Ron Rusnak \050U. Chicago\051, Roger Fajman and Dale White)19 W 15280 14986 MT (\050NIH\051, Andre Pirard \050U. Liege\051)SH /Times-Italic SF 8280 16091 MT (Language:)SH /Times-Roman SF 15280 XM (IBM/370 Assembler)SH /Times-Italic SF 8280 17196 MT (Documentation:)SH /Times-Roman SF 15280 XM (John Chandler \050CfA\051)SH /Times-Italic SF 8280 18301 MT (Version:)SH /Times-Roman SF 15280 XM (4.0 \05088/1/31\051)SH /Times-Italic SF 8280 19406 MT (Date:)SH /Times-Roman SF 15280 XM (1988 February)SH 12 /Times-Bold AF 8280 21994 MT (Kermit-TSO Capabilities At A Glance:)SH 10 /Times-Roman AF 9280 23785 MT (Local operation:)SH 34480 XM (No)SH 9280 24890 MT (Remote operation:)SH 34480 XM (Yes)SH 9280 25995 MT (Transfers text files:)SH 34480 XM (Yes)SH 9280 27100 MT (Transfers binary files:)SH 34480 XM (Yes)SH 9280 28205 MT (Wildcard send:)SH 34480 XM (Yes)SH /Courier SF 9280 29310 MT (^X/^Z)SH /Times-Roman SF 12530 XM (interruption:)SH 34480 XM (Yes \050through micro\051)SH 9280 30415 MT (Filename collision avoidance:)SH 34480 XM (Yes)SH 9280 31520 MT (Can time out:)SH 34480 XM (Yes)SH 9280 32625 MT (8th-bit prefixing:)SH 34480 XM (Yes)SH 9280 33730 MT (Repeat count prefixing:)SH 34480 XM (Yes)SH 9280 34835 MT (Alternate block checks:)SH 34480 XM (Yes)SH 9280 35940 MT (Terminal emulation:)SH 34480 XM (No)SH 9280 37045 MT (Communication settings:)SH 34480 XM (No)SH 9280 38150 MT (Transmit BREAK:)SH 34480 XM (No)SH 9280 39255 MT (Transaction logging:)SH 34480 XM (Yes)SH 9280 40360 MT (Session logging:)SH 34480 XM (No)SH 9280 41465 MT (Raw transmit:)SH 34480 XM (Yes \050no prompts\051)SH 9280 42570 MT (Sliding window:)SH 34480 XM (No)SH 9280 43675 MT (Long packets:)SH 34480 XM (Yes)SH 9280 44780 MT (Act as server:)SH 34480 XM (Yes)SH 9280 45885 MT (Talk to server:)SH 34480 XM (Yes)SH 9280 46990 MT (Advanced server functions:)SH 34480 XM (Yes)SH 9280 48095 MT (Advanced commands for servers:)SH 34480 XM (Yes)SH 9280 49200 MT (Local file management:)SH 34480 XM (Yes)SH 9280 50305 MT (Handle Attribute Packets:)SH 34480 XM (Yes)SH 9280 51410 MT (Command/init files:)SH 34480 XM (Yes)SH 9280 52515 MT (Command macros:)SH 34480 XM (No)SH 8280 54907 MT (Kermit-TSO is a) 78 W( member of the generic Kermit-370 family and shares most of the features and capabilities of the)79 W 8280 56103 MT (group. As) 526 W( its name implies, Kermit-TSO is the version of Kermit-370 that runs under the MVS/TSO operating)137 W 8280 57299 MT (system. The) 264 W( primary documentation for Kermit-TSO) 7 W( is actually the chapter on Kermit-370, which describes general)8 W 8280 58495 MT (properties; the present chapter assumes the reader is familiar with that material. Only) 93 W( the details specific to TSO)92 W 8280 59691 MT (operation will be discussed here,) 44 W( e.g., command syntax relating to the TSO file system or commands not offered in)45 W 8280 60887 MT (general by Kermit-370.)SH 12 /Times-Bold AF 8280 63475 MT (TSO Specifics of Kermit-370:)SH 10 /Times-Roman AF 9280 65266 MT (Global INIT file:)SH 34480 XM (')SH /Courier SF (SYS1.KERMINI)SH /Times-Roman SF (')SH 9280 66371 MT (User INIT file:)SH /Courier SF 34480 XM (KERMINI)SH /Times-Roman SF 9280 67476 MT (Debug packet log:)SH /Courier SF 34480 XM (KER.LOG)SH /Times-Roman SF 9280 68581 MT (Server reply log:)SH /Courier SF 34480 XM (KER.REPLY)SH /Times-Roman SF 9280 69686 MT (Maximum packet size:)SH 34480 XM (1913)SH 9280 70791 MT (Maximum disk LRECL:)SH 34480 XM (32756)SH ES %%Page: 202 203 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 202)SH 12 /Times-Bold AF 25751 XM (Kermit User Guide: IBM MVS/TSO KERMIT \05010.1\051)SH 46800 50 6120 5709 UL 14 SS 6120 8138 MT (10.1. The MVS/TSO File System)SH 10 /Times-Roman AF 6120 10256 MT (The features of the TSO) 234 W( file system of greatest interest to Kermit users are the format of file specifications)233 W 6120 11452 MT (\050)SH /Times-Italic SF (filespecs)SH /Times-Roman SF (\051 and the concept of records. The latter is described in the Kermit-370 chapter.)SH 6120 13844 MT (The MVS/TSO)37 W /Times-Italic SF 12583 XM (filespec)SH /Times-Roman SF 15925 XM (\050called the data set name or DSN\051 takes the form of tokens \050known as qualifiers\051 of) 37 W( up to 8)38 W 6120 15040 MT (alphanumeric characters) 205 W( each, separated by periods. Each qualifier must begin with an alphabetic or national)204 W 6120 16236 MT (character. The) 530 W( total length must be no more than 44 characters,) 140 W( including periods. To be precise, a DSN may)141 W 6120 17432 MT (contain uppercase letters, digits, and the special characters ``)24 W /Courier SF ($)SH /Times-Roman SF ('' \050dollar sign\051,) 24 W( ``)23 W /Courier SF (#)SH /Times-Roman SF ('' \050pound sign\051, ``)23 W /Courier SF (@)SH /Times-Roman SF ('' \050at sign\051, and)23 W 6120 18628 MT (``)SH /Courier SF (-)SH /Times-Roman SF ('' \050hyphen\051 in addition to the separating periods. Other characters may be not be included.)SH 6120 21020 MT (There is another, structural restriction on data set names from the fact that TSO data) 111 W( sets are all cataloged. In a)112 W 6120 22216 MT (standard MVS catalog, each qualifier of each DSN is associated with) 88 W( an index of the same name. The index is a)87 W 6120 23412 MT (hierarchical catalog component which) 132 W( points downward either to a list of next-level indices or to a data set, but)133 W 6120 24608 MT (never to both. Consequently, a cataloged DSN is) 35 W( a chain of indices corresponding one-for-one with DSN qualifers,)34 W 6120 25804 MT (and the last index is a pointer to the data set itself. While there may be many indices with the same name, no) 59 W( two)60 W 6120 27000 MT (such duplicates may both be chained) 24 W( to the same next-higher-level index, so that, if DSN's are considered as strings)23 W 6120 28196 MT (of qualifiers \050not of characters\051, no DSN can be a major substring of any other. For example, if the name ')10 W /Courier SF (A.BB.C)SH /Times-Roman SF (')SH 6120 29392 MT (exists in the catalog, then ')82 W /Courier SF (A.BB)SH /Times-Roman SF (' and ')82 W /Courier SF (A.BB.C.X)SH /Times-Roman SF (' are illegal, but ')82 W /Courier SF (A.B)SH /Times-Roman SF (', ')82 W /Courier SF (A.BB.Y)SH /Times-Roman SF (', ')82 W /Courier SF (A.BBB)SH /Times-Roman SF (', and) 82 W( ')81 W /Courier SF (A.BB.BB)SH /Times-Roman SF (')SH 6120 30588 MT (are all legal.)SH 6120 32980 MT (A DSN given in its entirety \050as in the foregoing examples\051 is called "fully qualified" and must be enclosed in single)30 W 6120 34176 MT (quotes when entered in TSO. However,) 203 W( by convention \050and by definition\051 the first qualifier of each data set)202 W 6120 35372 MT (belonging to a given user must be the user's logon ID, and, by default, that) 25 W( ID is the assumed prefix in TSO when a)26 W 6120 36568 MT (DSN is)35 W /Times-Italic SF 9357 XM (not)SH /Times-Roman SF 10920 XM (enclosed in quotes. In practice, then, names) 35 W( are abbreviated by omitting the quotes and the prefix. The)34 W 6120 37764 MT (most common type of name, in fact, consists of the prefix plus two more qualifiers giving the data set's name) 68 W( and)69 W 6120 38960 MT (type, respectively, so that many files have DSN's that correspond exactly to the canonical) 7 W( Kermit representation of a)6 W /Times-Italic SF 6120 40156 MT (filespec)SH /Times-Roman SF (. For) 408 W( instance,)79 W /Courier SF 15657 XM (TEST.FORT)SH /Times-Roman SF 21386 XM (is the source) 79 W( of a Fortran program named TEST, and its fully qualified DSN)80 W 6120 41352 MT (would be ')SH /Times-Italic SF ()SH /Courier SF (.TEST.FORT)SH /Times-Roman SF (', where)SH /Times-Italic SF 23773 XM ()SH /Times-Roman SF 27873 XM (is the owner's logon ID.)SH 6120 43744 MT (While this description is complete as far as it goes, it omits an important feature) 78 W( that is widely used in organizing)77 W 6120 44940 MT (files under) 28 W( MVS and TSO, namely, the partitioned data set \050PDS\051. A PDS is a data set like any other, except that it)29 W 6120 46136 MT (has)SH /Times-Italic SF 7787 XM (members)SH /Times-Roman SF (, each of which can usually be treated as a file in) 84 W( its own right. In fact, with QSAM \050the file access)83 W 6120 47332 MT (method employed by Kermit and many other applications\051, only) 55 W( members, and not the whole PDS, may be read or)56 W 6120 48528 MT (written. Thus,) 268 W( the term "file", as used in this chapter and the Kermit-370 chapter, may refer to either a) 9 W( PDS member)8 W 6120 49724 MT (or an ordinary data set, but not) 21 W( to a PDS. The notation for a PDS member consists of the member name enclosed in)22 W 6120 50920 MT (parentheses and appended to the DSN) 204 W( \050and the whole enclosed in quotes if the DSN is fully qualified\051. For)203 W 6120 52116 MT (example, if the Fortran program)SH /Courier SF 19173 XM (TEST)SH /Times-Roman SF 21823 XM (were copied into a PDS called)SH /Courier SF 34154 XM (DEBUG.FORT)SH /Times-Roman SF (, it would then be known as)SH /Courier SF 8520 53771 MT (DEBUG.FORT\050TEST\051)SH /Times-Roman SF 6120 55488 MT (Although the member name is written together with the DSN, it and the surrounding) 43 W( parentheses are not really part)44 W 6120 56684 MT (of the DSN and are not counted toward the 44-character limit. Still, a member name must conform to the rules for a)14 W 6120 57880 MT (DSN qualifier and, in addition, must not contain any hyphens.)SH 6120 60272 MT (All these properties of DSN's come into play) 96 W( when a file is being received by Kermit-TSO because a valid DSN)97 W 6120 61468 MT (must be generated for the new data set. For example, any invalid character in the supplied)40 W /Times-Italic SF 43209 XM (filespec)SH /Times-Roman SF 46554 XM (is replaced) 40 W( by a)39 W 6120 62664 MT (pound sign \050or) 6 W( converted to uppercase if it is a lowercase letter\051. Also, each qualifier \050and the member name, if any\051)7 W 6120 63860 MT (is prefixed with a pound sign if it does not already begin with an alphabetic) 6 W( or national character and then shortened,)5 W 6120 65056 MT (if necessary, to eight characters. If no)6 W /Times-Italic SF 21663 XM (filespec)SH /Times-Roman SF 24974 XM (is supplied, Kermit-TSO creates a default DSN of ``)6 W /Courier SF ($.$)SH /Times-Roman SF (''. The) 263 W( DSN)7 W 6120 66252 MT (is expanded to its fully qualified form and then truncated at 44 characters, if need be.)SH 6120 68644 MT (The DSN prefix, which defaults to the user's logon ID, is similar to a device specification) 193 W( on microcomputer)192 W 6120 69840 MT (systems: it selects an area) 27 W( of disk storage, and it usually need not be specified. In some ways, the prefix is also like)28 W 6120 71036 MT (a disk directory designator, since the file system structure is hierarchical. For this reason, the Kermit concept of the)25 W ES %%Page: 203 204 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (10.1. The MVS/TSO File System)SH 10 /Times-Italic AF 51275 XM (Page 203)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT ("working directory" is equated with a) 26 W( particular DSN prefix under Kermit-TSO. The current "working directory" is)27 W 8280 9082 MT (the collection of all data sets whose names begin with the current prefix, and file) 53 W( transfers take place preferentially)52 W 8280 10278 MT (to and from that area \050i.e., unless a fully qualified DSN is given\051.)SH 8280 12670 MT (To provide compatibility with other operating systems, when Kermit-TSO sends a file, it ordinarily) 123 W( makes a file)124 W 8280 13866 MT (header with only the last two qualifiers of the full DSN \050or only the member name in) 66 W( the case of a PDS member\051.)65 W 8280 15062 MT (On the other hand, extra information may be added by way of the SET FOREIGN subcommand.)SH 8280 17454 MT (Kermit-TSO allows a group of files to be specified in a) 30 W( single)31 W /Times-Italic SF 33583 XM (filespec)SH /Times-Roman SF 36919 XM (by including the special "wildcard" character)31 W 8280 18650 MT (``)SH /Courier SF (*)SH /Times-Roman SF ('', which matches any string of) 47 W( characters \050even a null string\051 starting at a new DSN qualifier. Only one)46 W /Courier SF 52462 XM (*)SH /Times-Roman SF 53358 XM (may)SH 8280 19846 MT (be used in a)13 W /Times-Italic SF 13332 XM (filespec)SH /Times-Roman SF (. Also,) 278 W( the)14 W /Courier SF 21054 XM (*)SH /Times-Roman SF 21918 XM (may not be used for the member name of a PDS \050nor for any part of a PDS name\051.)14 W 8280 21042 MT (Here are some examples:)SH /Courier SF 9280 22833 MT (*.COBOL)SH /Times-Roman SF 14280 XM (All files of type)SH /Courier SF 20835 XM (COBOL)SH /Times-Roman SF 24085 XM (\050all COBOL source files\051 in the current working directory.)SH /Courier SF 9280 24491 MT (BATCH*H.FORT)SH /Times-Roman SF 14280 25596 MT (All files in the current directory which begin with) 21 W( the qualifier)22 W /Courier SF 39760 XM (BATCH)SH /Times-Roman SF 43032 XM (and which end with)22 W /Courier SF 51230 XM (H.FORT)SH /Times-Roman SF (.)SH 14280 26701 MT (This would not include)SH /Courier SF 23780 XM (BATCH.FORT)SH /Times-Roman SF (, however.)SH 8280 29093 MT (TSO files, like those in other) 9 W( IBM 370 systems, are record-oriented \050see the introduction to the Kermit-370 chapter\051.)8 W 8280 30289 MT (In particular, TSO files are characterized by record format \050RECFM\051, which may be) 15 W( fixed-length, varying-length, or)16 W 8280 31485 MT (undefined-length; by maximum record length \050LRECL\051; and by maximum block size \050BLKSIZE\051.) 8 W( Fixed-length) 265 W( and)7 W 8280 32681 MT (varying-length may be \050and, under Kermit, always) 7 W( are\051 combined into blocks, but undefined-length records may not.)8 W 8280 33877 MT (Indeed, by convention, they have no logical record length, only a maximum) 56 W( block size. Records in TSO files may)55 W 8280 35073 MT (be up to 32760 bytes long, but varying-length records use four bytes to) 8 W( specify the length and have an effective limit)9 W 8280 36269 MT (of 32756.)SH 8280 38661 MT (Another file system feature of occasional interest is the means of reporting errors. When Kermit-TSO) 38 W( encounters a)37 W 8280 39857 MT (disk error, it attempts to prepare an explanatory message) 48 W( for inclusion in the)49 W /Courier SF 39626 XM (STATUS)SH /Times-Roman SF 43525 XM (report. The) 348 W( primary method)49 W 8280 41053 MT (is the standard)SH /Courier SF 14307 XM (SYNADAF)SH /Times-Roman SF 18757 XM (macro.)SH 14 /Times-Bold AF 8280 44655 MT (10.2. Program Operation)SH 10 /Times-Roman AF 8280 46773 MT (At startup time, Kermit-TSO looks for two initialization files,) 251 W( ')250 W /Courier SF (SYS1.KERMINI)SH /Times-Roman SF (' and ')250 W /Times-Italic SF ()SH /Courier SF (.KERMINI)SH /Times-Roman SF (')SH 8280 47969 MT (\050where, as before,)11 W /Times-Italic SF 15726 XM ()SH /Times-Roman SF 19837 XM (is the user's) 11 W( logon ID\051. The latter file would also be known as just)12 W /Courier SF 46956 XM (KERMINI)SH /Times-Roman SF (. The) 274 W( file)12 W 8280 49165 MT (')SH /Courier SF (SYS1.KERMINI)SH /Times-Roman SF (' would be maintained by a systems programmer, but)154 W /Courier SF 38752 XM (KERMINI)SH /Times-Roman SF 43356 XM (would be maintained) 154 W( by the)153 W 8280 50361 MT (user.)SH 8280 52753 MT (Two parameters in the user's profile \050the) 88 W( character delete and line delete\051 are disabled during protocol mode \050and)89 W 8280 53949 MT (restored afterwards\051 to prevent any conflict in case either of these characters has) 52 W( been defined to be printable. The)51 W 8280 55145 MT (settings in effect when) 19 W( Kermit starts up are saved as a sort of "normal" status snapshot \050as opposed to the "protocol")20 W 8280 56341 MT (status just described\051. The protocol) 40 W( status is selected whenever Kermit enters protocol mode, and the normal status)39 W 8280 57537 MT (is selected when Kermit leaves protocol mode. Note: if) 59 W( Kermit is interrupted in the midst of a transfer or while in)60 W 8280 58733 MT (server mode, these parameters will be left with peculiar settings \050namely, the protocol status\051, and they may need to)31 W 8280 59929 MT (be restored by hand.)SH 8280 62321 MT (Although TSO does not allow an application) 57 W( program to take control of terminal synchronization on ``)58 W /Courier SF (TTY)SH /Times-Roman SF ('' lines,)58 W 8280 63517 MT (the various full-screen emulation front ends are quite a different matter. The standard) 110 W( IBM handshake \050XON\051 is)109 W 8280 64713 MT (unnecessary, for example, with a 7171 or 4994 because the front end itself turns the line around with essentially) 41 W( no)42 W 8280 65909 MT (delay in transparent mode. Thus, handshaking should be suppressed for ``)98 W /Courier SF (SERIES1)SH /Times-Roman SF ('' devices \050the micro) 98 W( Kermit)97 W 8280 67105 MT (should have HANDSHAKE set OFF, and Kermit-TSO should have HANDSHAKE set to 0\051.) 137 W( Since) 525 W( the generic)138 W 8280 68301 MT (Kermit-370 default handshake \050XON\051 is retained) 96 W( in Kermit-TSO, the subcommand ``)95 W /Courier SF (SET HANDSHAKE 0)95 W /Times-Roman SF ('' is a)95 W 8280 69497 MT (good candidate for inclusion the KERMINI file of any user who habitually uses ``)SH /Courier SF (SERIES1)SH /Times-Roman SF ('' lines.)SH ES %%Page: 204 205 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 204)SH 12 /Times-Bold AF 25751 XM (Kermit User Guide: IBM MVS/TSO KERMIT \05010.2\051)SH 46800 50 6120 5709 UL 6120 8004 MT (Interactive Operation:)SH 10 /Times-Roman AF 6120 9418 MT (To run Kermit-TSO interactively, invoke the program from TSO by typing)SH /Courier SF 36339 XM (KERMIT)SH /Times-Roman SF (. When) 250 W( you see the prompt,)SH /Courier SF 8520 11073 MT (Kermit-TSO>)SH /Times-Roman SF 6120 12790 MT (you may type a) 27 W( Kermit subcommand. When the subcommand completes, Kermit issues another prompt. The cycle)28 W 6120 13986 MT (repeats until you exit from the program. For example:)SH /Courier SF 8520 15641 MT (KERMIT)SH 3600 50 8520 15841 UL 8520 17296 MT (Kermit-TSO Version 4.0 \05088/1/31\051)SH 8520 18327 MT (Enter ? for a list of valid commands)SH 8520 19982 MT (Kermit-TSO>send foo.*)SH 6000 50 15120 20182 UL /Times-Italic SF 9720 21697 MT (Files beginning with FOO are sent)SH /Courier SF 8520 23352 MT (Kermit-TSO>receive test.spss)SH 10200 50 15120 23552 UL /Times-Italic SF 9720 25067 MT (File is received and called TEST.SPSS)SH /Courier SF 8520 26722 MT (Kermit-TSO>exit)SH 2400 50 15120 26922 UL 12 /Times-Bold AF 6120 29310 MT (Command Line Invocation:)SH 10 /Times-Roman AF 6120 30724 MT (Kermit-TSO may also) 117 W( be invoked with command line arguments from TSO. The arguments are interpreted as a)116 W 6120 31920 MT (subcommand to be executed by Kermit after completion of the initialization. For instance:)SH /Courier SF 8520 33575 MT (KERMIT send test.fort)SH 12600 50 8520 33775 UL /Times-Roman SF 6120 35967 MT (Kermit will exit and return to TSO after completing the specified subcommand.)SH 12 /Times-Bold AF 6120 38555 MT (CLIST Operation:)SH 10 /Times-Roman AF 6120 39969 MT (Like other TSO programs, Kermit-TSO may be invoked from a CLIST. Subcommands can be passed) 111 W( to Kermit)112 W 6120 41165 MT (using the program input stack and/or command line arguments. For example, to start up Kermit-TSO and) 6 W( have it act)5 W 6120 42361 MT (as a server, include the line:)SH /Courier SF 8520 44016 MT (KERMIT server)SH 7800 50 8520 44216 UL /Times-Roman SF 6120 45733 MT (To pass more than one subcommand, they must be stacked in the order in which they) 7 W( are to be executed. To start up)8 W 6120 46929 MT (a Kermit-TSO server with a three character CRC, create and stack a file with the following:)SH /Courier SF 8520 48584 MT (set block 3)SH 6600 50 8520 48784 UL 8520 49615 MT (server)SH 3600 50 8520 49815 UL /Times-Roman SF 6120 51332 MT (and then invoke Kermit. Like) 82 W( many utility programs, Kermit-TSO uses the GETLINE/PUTLINE service routines)81 W 6120 52528 MT (for terminal I/O, and the nominally interactive subcommands can thus be supplied under program control. Another)40 W 6120 53724 MT (way of) 33 W( setting up multiple subcommands would be to collect the subcommands into a TAKE file and then issue the)32 W 6120 54920 MT (TAKE subcommand via the command line. Of course, CLIST's may be executed) 93 W( from Kermit, either directly or)94 W 6120 56116 MT (from a TAKE file, and) 138 W( CLIST's in turn may freely issue Kermit subcommands. The subcommand KERMIT is)137 W 6120 57312 MT (especially useful in this context for distinguishing Kermit subcommands from TSO commands.)SH 12 /Times-Bold AF 6120 59900 MT (Server mode:)SH 10 /Times-Roman AF 6120 61314 MT (Command execution in) 10 W( server mode is different in several respects from normal operation. First of all, some Kermit)11 W 6120 62510 MT (subcommands are not allowed \050see the list of subcommands in the Kermit-370 chapter\051. Moreover,) 9 W( command errors)8 W 6120 63706 MT (always terminate any active TAKE file.) 202 W( Also,) 656 W( commands run in a special environment with the User Profile)203 W 6120 64902 MT (temporarily modified. Another difference is that Kermit intercepts) 70 W( terminal I/O as much as possible and transmits)69 W 6120 66098 MT (the data to the local Kermit as text packets. The) 74 W( problem with this redirection is that some MVS/TSO commands)75 W 6120 67294 MT (issue terminal) 225 W( I/O directly, so that some messages never appear to the local Kermit \050except, perhaps, as bad)224 W 6120 68490 MT (packets\051.)SH ES %%Page: 205 206 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (10.3. Kermit-TSO Subcommands)SH 10 /Times-Italic AF 51275 XM (Page 205)SH 46800 50 8280 5709 UL 14 /Times-Bold AF 8280 8138 MT (10.3. Kermit-TSO Subcommands)SH 10 /Times-Roman AF 8280 10256 MT (Kermit-TSO supports) 101 W( all the subcommands described in the corresponding section of the Kermit-370 chapter. In)102 W 8280 11452 MT (addition, there is the system-specific subcommand)376 W /Courier SF 31006 XM (TSO)SH /Times-Roman SF (, which) 376 W( is just a synonym for the generic)375 W /Courier SF 52680 XM (HOST)SH /Times-Roman SF 8280 12648 MT (subcommand.)SH /Courier SF 14363 XM (TSO)SH /Times-Roman SF 16413 XM (can be issued as a remote) SH( Kermit command when Kermit-TSO is in server mode. Also, the)1 W /Courier SF 53280 XM (END)SH /Times-Roman SF 8280 13844 MT (subcommand is available as a synonym for)SH /Courier SF 25750 XM (EXIT)SH /Times-Roman SF 28400 XM (and)SH /Courier SF 30094 XM (QUIT)SH /Times-Roman SF (.)SH 8280 16236 MT (The remainder of this section concentrates on the subcommands that) 18 W( have special form or meaning for Kermit-TSO.)17 W 8280 17432 MT (See also the chapter on Kermit-370 for further details.)SH 13 /Times-Bold AF 24708 20791 MT (The SEND Subcommand)SH 10 /Times-Roman AF 8280 23164 MT (Syntax:)SH /Courier SF 11586 XM (SEND)SH /Times-Italic SF 14236 XM (filespec)SH /Times-Roman SF 17541 XM ([)SH /Times-Italic SF (foreign-filespec)SH /Times-Roman SF (])SH 8280 25556 MT (The SEND subcommand causes a file or file group to be sent from TSO to the Kermit on) 73 W( the other system. DSN)74 W 8280 26752 MT (prefixing is done on the)SH /Times-Italic SF 18029 XM (filespec)SH /Times-Roman SF 21334 XM (in the usual way \050see also the CWD subcommand\051.)SH /Times-Italic SF 8280 29144 MT (filespec)SH /Times-Roman SF 11585 XM (may contain a wildcard ``)SH /Courier SF (*)SH /Times-Roman SF (''. If) 250 W( it does, then all matching files will be sent, up to 711 files in all.)SH 8280 31536 MT (The)SH /Times-Italic SF 10177 XM (foreign-filespec)SH /Times-Roman SF (, if any, is) 92 W( used for the file header of the outgoing file, replacing the usual name.type derived)91 W 8280 32732 MT (from the MVS/TSO)72 W /Times-Italic SF 16746 XM (filespec)SH /Times-Roman SF (. Normally,) 394 W( this form of the SEND) 72 W( subcommand is used only for single files because)73 W 8280 33928 MT (the)SH /Times-Italic SF 9752 XM (foreign-filespec)SH /Times-Roman SF 16279 XM (is used only for the first file of a group \050subsequent files having default headers\051.)SH 8280 36320 MT (Although the file transfer cannot be cancelled from the TSO side, Kermit-TSO is capable of) 63 W( responding to "cancel)62 W 8280 37516 MT (file" or "cancel batch" signals from the local Kermit; these are typically entered by typing) 57 W( Control-X or Control-Z,)58 W 8280 38712 MT (respectively.)SH 13 /Times-Bold AF 23480 42071 MT (The RECEIVE Subcommand)SH 10 /Times-Roman AF 8280 44444 MT (Syntax:)SH /Courier SF 11586 XM (RECEIVE)SH /Times-Roman SF 16036 XM ([)SH /Times-Italic SF (filespec)SH /Times-Roman SF (])SH 8280 46836 MT (The RECEIVE subcommand tells Kermit to receive a file or file group) 113 W( from the other system. You should then)112 W 8280 48032 MT (issue a SEND subcommand to the other Kermit.)SH 8280 50424 MT (A)SH /Times-Italic SF 9290 XM (filespec)SH /Times-Roman SF 12633 XM (in the subcommand indicates what name the incoming file should be given. Wildcards may not be used.)38 W 8280 51620 MT (If the)21 W /Times-Italic SF 10710 XM (filespec)SH /Times-Roman SF 14036 XM (is invalid, Kermit-TSO will suppress the transfer. If the optional)21 W /Times-Italic SF 40459 XM (filespec)SH /Times-Roman SF 43785 XM (is omitted \050and,) 21 W( in any case,)20 W 8280 52816 MT (for all files after the first in a group\051 Kermit-TSO will use the name\050s\051 provided by the) 59 W( other Kermit. If a name is)60 W 8280 54012 MT (not a legal DSN, Kermit-TSO will delete excess characters,) 64 W( change illegal characters to pound signs, and so on, to)63 W 8280 55208 MT (create a legal name.)SH 8280 57600 MT (When the record format is ``)228 W /Courier SF (F)SH /Times-Roman SF ('', any received record longer than the logical record length \050LRECL\051) 228 W( will be)229 W 8280 58796 MT (truncated, and) 70 W( shorter records will be padded. The padding character is a blank for text files and a null for binary)69 W 8280 59992 MT (files. Received) 278 W( binary \050but not V-binary or D-binary\051 files are treated as byte streams and broken up) 14 W( into records all)15 W 8280 61188 MT (of the logical record length. See the SET) 94 W( FILE TYPE, SET FILE LRECL, SET FILE BLKSIZE, and SET FILE)93 W 8280 62384 MT (RECFM subcommands.)SH 8280 64776 MT (If an error occurs during the file transfer, as much of the file as) 62 W( was received is saved on disk. If the sending of a)63 W 8280 65972 MT (file is cancelled by) 50 W( the user of the foreign system, Kermit-TSO will discard whatever had arrived, unless APPEND)49 W 8280 67168 MT (is ON or INCOMPLETE is KEEP.)SH 8280 69560 MT (If the incoming file has the same name as an existing file \050either a data set) 68 W( or a PDS member\051, and WARNING is)69 W 8280 70756 MT (OFF, the original file will be overwritten. If WARNING is set ON,) 42 W( however, Kermit-TSO will protect the existing)41 W 8280 71952 MT (file in one of two ways. If the)212 W /Times-Italic SF 22519 XM (filespec)SH /Times-Roman SF 26037 XM (was entered with the subcommand, Kermit will prompt the user for)213 W ES %%Page: 206 207 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 206)SH 12 /Times-Bold AF 25751 XM (Kermit User Guide: IBM MVS/TSO KERMIT \05010.3\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (permission to overwrite the file. If the)229 W /Times-Italic SF 23644 XM (filespec)SH /Times-Roman SF 27178 XM (came from the foreign Kermit, Kermit-TSO will) 229 W( change the)228 W 6120 9082 MT (incoming name so as not to obliterate the pre-existing file. It attempts to find a unique name by successively)171 W 6120 10278 MT (modifying the original and checking for the existence of such a file at) 109 W( each step. The procedure operates on the)108 W 6120 11474 MT (second qualifier of the full DSN \050or the member name in the case of a PDS member\051) 44 W( and begins by truncating it to)45 W 6120 12670 MT (seven characters, if necessary, and then) 62 W( appends ``)61 W /Courier SF (0)SH /Times-Roman SF (''. If) 372 W( a file by that name exists, Kermit then replaces the ``)61 W /Courier SF (0)SH /Times-Roman SF ('')SH 6120 13866 MT (with a ``)SH /Courier SF (1)SH /Times-Roman SF (''. It) 250 W( continues in this manner up to ``)SH /Courier SF (9)SH /Times-Roman SF ('', and if an unused name cannot be found, the transfer fails.)SH 13 /Times-Bold AF 23054 17225 MT (The SET Subcommand)SH 10 /Times-Roman AF 6120 19598 MT (Syntax:)SH /Courier SF 9426 XM (SET)SH /Times-Italic SF 11476 XM (parameter)SH /Times-Roman SF 15892 XM ([)SH /Times-Italic SF (value)SH /Times-Roman SF (])SH 6120 21990 MT (The SET subcommand) 142 W( establishes or modifies various parameters controlling file transfers. The following SET)143 W 6120 23186 MT (parameters are available in Kermit-TSO, but not in Kermit-370 in general:)SH 6120 24796 MT (FILE)SH 6620 25901 MT (BLKSIZE)SH 20520 XM (Block size for incoming file.)SH 6620 27006 MT (LRECL)SH 20520 XM (Logical Record length for incoming file.)SH 6620 28111 MT (RECFM)SH 20520 XM (Record format for incoming files.)SH 6620 29216 MT (SPACE)SH 20520 XM (Allocation unit \050in tracks\051 for incoming files.)SH 6620 30321 MT (UNIT)SH 20520 XM (Device type for incoming files.)SH 6620 31426 MT (VOLUME)SH 20520 XM (Disk pack for incoming files.)SH 6120 32531 MT (PREFIX)SH 20520 XM (Default disk area.)SH 6120 33636 MT (TIMER)SH 20520 XM (Determine whether Kermit-TSO should time out.)SH 12 /Times-Bold AF 6120 36224 MT (SET FILE BLKSIZE)SH 10 /Times-Roman AF 6120 37638 MT (Syntax:)SH /Courier SF 9426 XM (SET FILE BLKSIZE)SH /Times-Italic SF 19276 XM (number)SH /Times-Roman SF 6120 40030 MT (This sets the block size for incoming files to a)138 W /Times-Italic SF 26165 XM (number)SH /Times-Roman SF 29608 XM (from 1 to 32760.) 138 W( In) 524 W( the case of fixed-format files, this)137 W 6120 41226 MT (number is just an upper bound;) 8 W( the actual block size is taken to be the largest multiple of the LRECL which does not)9 W 6120 42422 MT (exceed this limit. The default is 6233.)SH 12 /Times-Bold AF 6120 45010 MT (SET FILE LRECL)SH 10 /Times-Roman AF 6120 46424 MT (Syntax:)SH /Courier SF 9426 XM (SET FILE LRECL)SH /Times-Italic SF 18076 XM (number)SH /Times-Roman SF 6120 48816 MT (This sets the effective logical record length) 55 W( for incoming files to a)54 W /Times-Italic SF 33436 XM (number)SH /Times-Roman SF 36795 XM (from 1 to 32756. This parameter is not)54 W 6120 50012 MT (used for files of undefined record format. Moreover, it is not exactly the same as the MVS/TSO LRECL, which) 50 W( is)51 W 6120 51208 MT (four more than the actual maximum data length for varying-length records. The default is 80.)SH 12 /Times-Bold AF 6120 53796 MT (SET FILE RECFM)SH 10 /Times-Roman AF 6120 55210 MT (Syntax:)SH /Courier SF 9426 XM (SET FILE RECFM)SH /Times-Italic SF 18076 XM (option)SH /Times-Roman SF 6120 57602 MT (This sets the record) 188 W( format to use for incoming files. Valid)187 W /Times-Italic SF 32336 XM (option)SH /Times-Roman SF (s are "Fixed", "Varying" \050the default\051, and)187 W 6120 58798 MT ("Undefined". This) 326 W( parameter is thus limited to a subset of the range of possibilities for the) 38 W( MVS/TSO RECFM. In)39 W 6120 59994 MT (Kermit-TSO, all incoming files of fixed) 46 W( or varying format are automatically blocked according to the current block)45 W 6120 61190 MT (size. Fixed-format) 250 W( records are padded or truncated, as needed, to the current LRECL.)SH 12 /Times-Bold AF 6120 63778 MT (SET FILE SPACE)SH 10 /Times-Roman AF 6120 65192 MT (Syntax:)SH /Courier SF 9426 XM (SET FILE SPACE)SH /Times-Italic SF 18076 XM (number)SH /Times-Roman SF 6120 67584 MT (This sets the track allocation unit for incoming files to a number from 1 to 32760. The default is) 31 W( 5. Since data sets)32 W 6120 68780 MT (are allowed as many as 15 extents, this default provides for files up to 75 tracks.)SH ES %%Page: 207 208 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (10.3. Kermit-TSO Subcommands)SH 10 /Times-Italic AF 51275 XM (Page 207)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (SET FILE UNIT)SH 10 /Times-Roman AF 8280 9418 MT (Syntax:)SH /Courier SF 11586 XM (SET FILE UNIT)SH /Times-Italic SF 19636 XM (type)SH /Times-Roman SF 8280 11810 MT (This sets the device type or group for incoming files. Valid)159 W /Times-Italic SF 34324 XM (option)SH /Times-Roman SF (s are installation-dependent. The default) 159 W( is)158 W /Courier SF 8280 13006 MT (SYSDA)SH /Times-Roman SF (, which is) 38 W( universally available, but not necessarily desirable, since many installations restrict TSO data sets)39 W 8280 14202 MT (to a particular set) 136 W( of disk volumes. In such cases, there is usually a unit name which refers only to those TSO)135 W 8280 15398 MT (volumes, and the global)SH /Courier SF 18085 XM (INIT)SH /Times-Roman SF 20735 XM (file)SH /Courier SF 22318 XM ('SYS1.KERMINI')SH /Times-Roman SF 30968 XM (should set the file unit parameter to that name.)SH 12 /Times-Bold AF 8280 17986 MT (SET FILE VOLUME)SH 10 /Times-Roman AF 8280 19400 MT (Syntax:)SH /Courier SF 11586 XM (SET FILE VOLUME)SH /Times-Italic SF 20836 XM (name)SH /Times-Roman SF 8280 21792 MT (This sets the disk volume for incoming files. Valid)23 W /Times-Italic SF 29315 XM (names)SH /Times-Roman SF (s are) 23 W( installation-dependent, but are, in any case, no more)24 W 8280 22988 MT (than six alphanumeric characters.) 42 W( The) 332 W( default is blank \050none\051; in that case, the system chooses one of the available)41 W 8280 24184 MT (volumes of the specified UNIT type.)SH 12 /Times-Bold AF 8280 26772 MT (SET PREFIX)SH 10 /Times-Roman AF 8280 28186 MT (Syntax:)SH /Courier SF 11586 XM (SET PREFIX)SH /Times-Roman SF 17836 XM ([)SH /Times-Italic SF (string)SH /Times-Roman SF (])SH 8280 30578 MT (This subcommand is equivalent to the CWD subcommand \050q.v.\051.)SH 12 /Times-Bold AF 8280 33166 MT (SET TIMER)SH 10 /Times-Roman AF 8280 34580 MT (Syntax:)SH /Courier SF 11586 XM (SET TIMER ON)SH /Times-Italic SF 19386 XM (or)SH /Courier SF 20875 XM (OFF)SH /Times-Roman SF 8280 36972 MT (This specifies whether Kermit-TSO is to maintain a timer for each packet it expects to) 44 W( read. The default is ON. If)45 W 8280 38168 MT (the timer is enabled, its duration) 5 W( is set by the SET SEND TIMEOUT subcommand initially and then set according to)4 W 8280 39364 MT (the request of the other Kermit.)SH 13 /Times-Bold AF 24853 42723 MT (The CWD Subcommand)SH 10 /Times-Roman AF 8280 45096 MT (Syntax:)SH /Courier SF 11586 XM (CWD)SH /Times-Roman SF 13636 XM ([)SH /Times-Italic SF (string or PDSname)SH /Times-Roman SF (\050\051])SH 8280 47488 MT (The CWD \050Change) 79 W( Working Directory\051 subcommand establishes a new default DSN prefix or turns prefixing off.)80 W 8280 48684 MT (This facility is similar to, but not quite the same as, the) 56 W( prefix defined in the User Profile. The)55 W /Times-Italic SF 47415 XM (string)SH /Times-Roman SF (, if specified,)55 W 8280 49880 MT (must consist) 44 W( of one or more DSN qualifiers, and the first must already be an index in the disk catalog. Subsequent)45 W 8280 51076 MT (file transfers take) 83 W( place to and from the corresponding disk area whenever a fully qualified DSN \050one enclosed in)82 W 8280 52272 MT (quotes\051 is not given. The initial prefix is the user's logon ID, i.e.,) 31 W( the same as the default prefix in the User Profile.)32 W 8280 53468 MT (If no prefix) 169 W( is given in this subcommand, then prefixing is no longer performed. The user must be careful to)168 W 8280 54664 MT (remember the distinction between the prefix) 37 W( defined for Kermit and that for TSO. Pure Kermit subcommands \050like)38 W /Courier SF 8280 55860 MT (SEND)SH /Times-Roman SF 11047 XM (and)SH /Courier SF 12857 XM (TAKE)SH /Times-Roman SF (\051 always use the former, but TSO commands \050and the TSO-related subcommand)116 W /Courier SF 49060 XM (TYPE)SH /Times-Roman SF (\051 use the)116 W 8280 57056 MT (latter.)SH 8280 59448 MT (An alternative form of the CWD subcommand allows specifying the full \050but unquoted\051 name of a PDS followed by)17 W 8280 60644 MT (paired parentheses. When such a "working directory" is in use, a)47 W /Times-Italic SF 35154 XM (filespec)SH /Times-Roman SF 38506 XM (other than a fully qualified) 47 W( DSN is taken)46 W 8280 61840 MT (to be a member name within the) 52 W( PDS. For that reason, this form should be used cautiously, since the Kermit-TSO)53 W 8280 63036 MT (log)SH /Times-Italic SF 9856 XM (filespecs)SH /Times-Roman SF 13598 XM (\050such as)48 W /Courier SF 17193 XM (KER.LOG)SH /Times-Roman SF 21691 XM (and)SH /Courier SF 23433 XM (KER.REPLY)SH /Times-Roman SF (\051 would be) 48 W( treated the same way. In particular, it is advisable to)47 W 8280 64232 MT (turn on debug mode only when the Kermit prefix is a partially qualified DSN) 33 W( \050once started, the log continues to the)34 W 8280 65428 MT (same data set regardless of what happens to the prefix\051.)SH ES %%Page: 208 209 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 208)SH 12 /Times-Bold AF 25751 XM (Kermit User Guide: IBM MVS/TSO KERMIT \05010.3\051)SH 46800 50 6120 5709 UL 13 SS 20309 8071 MT (The DIRECTORY Subcommand)SH 10 /Times-Roman AF 6120 10444 MT (Syntax:)SH /Courier SF 9426 XM (DIRECTORY)SH /Times-Roman SF 15076 XM ([)SH /Times-Italic SF (filespec)SH /Times-Roman SF (])SH 6120 12836 MT (The DIRECTORY subcommand uses the TSO LISTCAT command to display part of) 82 W( the data set catalog, i.e., all)81 W 6120 14032 MT (data sets whose names begin with the qualifiers) 20 W( in the Kermit prefix \050if any\051 concatenated with the given)21 W /Times-Italic SF 48650 XM (filespec)SH /Times-Roman SF 51976 XM (\050if)SH 6120 15228 MT (any\051.)SH 13 /Times-Bold AF 22982 18587 MT (The TSO Subcommand)SH 10 /Times-Roman AF 6120 20960 MT (Syntax:)SH /Courier SF 9426 XM (TSO)SH /Times-Italic SF 11476 XM (text of command)SH /Times-Roman SF 6120 23352 MT (Although Kermit-TSO does not have a full set of its own subcommands for managing TSO) 68 W( files, it provides those)67 W 6120 24548 MT (services through the operating system. You) 52 W( can issue any TSO command, e.g., to list, type, rename or delete files,)53 W 6120 25744 MT (send messages, and so on. The)SH /Courier SF 18868 XM (TSO)SH /Times-Roman SF 20918 XM (subcommand under Kermit is synonymous with the)SH /Courier SF 41834 XM (HOST)SH /Times-Roman SF 44484 XM (subcommand.)SH 14 /Times-Bold AF 6120 29346 MT (10.4. How to build an executable version of Kermit-TSO)SH 10 /Times-Roman AF 6120 31464 MT (Before attempting to build Kermit-TSO, look in the Kermit distribution) 101 W( under both IK0KER and IKTKER for an)100 W 6120 32660 MT (installation document, as well as) 62 W( "beware", help, and update files, and read them first. They will probably contain)63 W 6120 33856 MT (information that is more current than what you see here.)SH 6120 36248 MT (Kermit-TSO consists at present of a large assembly \050KERMIT.ASM, containing the Kermit program\051 and a) 89 W( small)88 W 6120 37444 MT (one \050DYNALC.ASM, containing a subroutine for allocating data sets\051. Although DYNALC is) 83 W( a single file in the)84 W 6120 38640 MT (Kermit distribution, the source for Kermit itself is in many pieces, some) 2 W( generic for Kermit-370 and some specific to)1 W 6120 39836 MT (TSO. All) 588 W( the necessary pieces are sequenced in columns 73-80 so that the numbers form a strictly increasing)170 W 6120 41032 MT (sequence when the pieces are correctly "pasted" together.) 33 W( It) 314 W( is important to preserve the original sequence numbers)32 W 6120 42228 MT (so that updates, if any, can be applied to the source.)SH 6120 44620 MT (To create a runnable version:)SH 8120 46411 MT (1.)SH 9120 XM (Combine the following ``)4 W /Courier SF (ASM)SH /Times-Roman SF ('' files from the Kermit distribution into a single file with)4 W /Courier SF 44420 XM (RECFM=F\050B\051)SH /Times-Roman SF 9120 47516 MT (and)SH /Courier SF 10911 XM (LRECL=80)SH /Times-Roman SF (: IK0DOC,) 97 W( IK0MAC, IKTMAC, IK0DEF, IK0MAI, IK0CMD, IK0COM, IKTUTL,)96 W 9120 48621 MT (and IK0PRO. The resulting) 14 W( file is the composite source for Kermit-TSO, called KERMIT.ASM. This)15 W 9120 49726 MT (source must retain the original sequence numbers in columns 73-80 \050in other words, be sure not to)125 W 9120 50831 MT (resequence the source accidentally by using the editor!\051)SH 8120 52489 MT (2.)SH 9120 XM (Copy or rename IKTDYN.ASM from the Kermit distribution) 149 W( to a file called DYNALC.ASM with)150 W /Courier SF 9120 53594 MT (RECFM=F\050B\051)SH /Times-Roman SF 15370 XM (and)SH /Courier SF 17064 XM (LRECL=80)SH /Times-Roman SF (.)SH 8120 55252 MT (3.)SH 9120 XM (Assemble the source file\050s\051.)SH 8120 56910 MT (4.)SH 9120 XM (Create the executable load) 75 W( module)74 W /Courier SF 23573 XM (KERMIT)SH /Times-Roman SF 27497 XM (using the linkage editor. Kermit is designed to run as a)74 W 9120 58015 MT (command processor, and so it must be placed) 266 W( in SYS1.CMDLIB or in a PDS concatenated to)267 W 9120 59120 MT (SYS1.CMDLIB \050for example, via the STEPLIB command\051.)SH 8120 60778 MT (5.)SH 9120 XM (If your site's ASCII/EBCDIC translation table for TTY lines does not conform to the one) 36 W( listed in the)35 W 9120 61883 MT (appendix \050which in turn conforms) 27 W( to the one given in the IBM System/370 Reference Summary\051, then)28 W 9120 62988 MT (enter the appropriate SET) 318 W( ATOE/ETOA/TATOE/TETOA subcommands into 'SYS1.KERMINI'.)317 W /Times-Italic SF 9120 64093 MT (NOTE:)SH /Times-Roman SF 12259 XM (If the ASCII/EBCDIC translation is not invertible, Kermit will not and cannot work.)SH 6120 65884 MT (In order to) 213 W( verify the operation of a new version of Kermit-TSO, you may run it under TEST using the CP)214 W 6120 67080 MT (parameter.)SH ES %%Page: 209 210 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (10.5. What's New)SH 10 /Times-Italic AF 51275 XM (Page 209)SH 46800 50 8280 5709 UL 14 /Times-Bold AF 8280 8138 MT (10.5. What's New)SH 10 /Times-Roman AF 8280 10256 MT (Below is a list of the more important features in Version) 20 W( 4.0 of Kermit-TSO added since the release of TSO/3708 in)19 W 8280 11452 MT (May 1987.) 89 W( Since) 430 W( Version 4.0 is the first release of Kermit-370 for TSO, some of the "new" features are actually)90 W 8280 12648 MT (new only to the Columbia TSO distribution.)SH 10280 14439 MT (1.)SH 11280 XM (Suppression of LINE and CHAR delete functions during protocol mode.)SH 10280 16097 MT (2.)SH 11280 XM (Advanced server functions and subcommands for talking to another Kermit running in server mode.)SH 10280 17755 MT (3.)SH 11280 XM (Long packet protocol.)SH 10280 19413 MT (4.)SH /Courier SF 11280 XM (TYPE)SH /Times-Roman SF (,)SH /Courier SF 14180 XM (ECHO)SH /Times-Roman SF (,)SH /Courier SF 17080 XM (XTYPE)SH /Times-Roman SF (, and)SH /Courier SF 22274 XM (XECHO)SH /Times-Roman SF 25524 XM (subcommands \050the last two being Series/1 analogs of the first two.\051)SH 10280 21071 MT (5.)SH 11280 XM (REMOTE KERMIT commands honored by TSO server, including)276 W /Courier SF 40402 XM (SET)SH /Times-Roman SF (,)SH /Courier SF 42978 XM (SHOW)SH /Times-Roman SF (,)SH /Courier SF 46154 XM (TAKE)SH /Times-Roman SF (,)SH /Courier SF 49330 XM (TDUMP)SH /Times-Roman SF (,)SH /Courier SF 11280 22176 MT (STATUS)SH /Times-Roman SF (,)SH /Courier SF 15380 XM (HOST)SH /Times-Roman SF (,)SH /Courier SF 18280 XM (TSO)SH /Times-Roman SF (,)SH /Courier SF 20580 XM (CWD)SH /Times-Roman SF (,)SH /Courier SF 22880 XM (DIR)SH /Times-Roman SF (, and)SH /Courier SF 26874 XM (TYPE)SH /Times-Roman SF (.)SH 10280 23834 MT (6.)SH 11280 XM (TEST mode for debugging.)SH 10280 25492 MT (7.)SH 11280 XM (Multi-column, two-level, selective SHOW display.)SH 10280 27150 MT (8.)SH 11280 XM (Send and acknowledge attribute packets.)SH 10280 28808 MT (9.)SH 11280 XM (Optionally append to, rather than replace, old data sets with duplicate names.)SH 9780 30466 MT (10.)SH 11280 XM (Automatic detection of terminal controller type \050)SH /Courier SF (TTY)SH /Times-Roman SF 32827 XM (or)SH /Courier SF 33910 XM (SERIES1)SH /Times-Roman SF (\051.)SH 9780 32124 MT (11.)SH 11280 XM (SYNADAF message in cases of disk I/O error.)SH 14 /Times-Bold AF 8280 35726 MT (10.6. What's Missing)SH 10 /Times-Roman AF 8280 37844 MT (Work on Kermit-TSO will continue. Features that need to be improved or added include:)SH /Symbol SF 10070 39749 MT (\267)SH /Times-Roman SF 10780 XM (Detect file properties from Attribute packets and allow overriding current parameter settings. Also)169 W 10780 40854 MT (implement file archiving.)SH /Symbol SF 10070 42843 MT (\267)SH /Times-Roman SF 10780 XM (Add a)SH /Courier SF 13446 XM (SET REPEAT)SH /Times-Roman SF 19696 XM (subcommand.)SH /Symbol SF 10070 44832 MT (\267)SH /Times-Roman SF 10780 XM (Finish)SH /Courier SF 13546 XM (SET LINE)15 W /Times-Roman SF (, so) 15 W( that Kermit-TSO can be used as a local Kermit, connecting to a remote host over)14 W 10780 45937 MT (an alternate communication port. Add a)SH /Courier SF 27166 XM (CONNECT)SH /Times-Roman SF 31616 XM (subcommand.)SH /Symbol SF 10070 47926 MT (\267)SH /Times-Roman SF 10780 XM (Compute file size for outgoing A-packets and implement the SPACE subcommand.)SH /Symbol SF 10070 49915 MT (\267)SH /Times-Roman SF 10780 XM (Reject files known \050via A-packets\051 to be too big for available storage.)SH /Symbol SF 10070 51904 MT (\267)SH /Times-Roman SF 10780 XM (Intercept)SH /Times-Italic SF 14584 XM (all)SH /Times-Roman SF 15890 XM (terminal output during protocol mode.)SH /Symbol SF 10070 53893 MT (\267)SH /Times-Roman SF 10780 XM (Allow wildcard notation for PDS members.)SH ES %%Page: 210 211 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 210)SH 12 /Times-Bold AF 26651 XM (Kermit User Guide: IBM MVS/TSO KERMIT \05011\051)SH 46800 50 6120 5709 UL ES %%Page: 211 212 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (11. VAX/VMS KERMIT)SH 10 /Times-Italic AF 51275 XM (Page 211)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 8280 8272 MT (11. VAX/VMS KERMIT)SH 10 /Times-Italic AF 8280 10566 MT (Authors:)SH /Times-Roman SF 14280 XM (Robert C. McQueen, Nick Bush, Stevens Institute of Technology;)SH 14280 11671 MT (Jonathan Welch, Amherst College)SH /Times-Italic SF 8280 12776 MT (Language:)SH /Times-Roman SF 14280 XM (Bliss-32)SH /Times-Italic SF 8280 13881 MT (Documentation:)SH /Times-Roman SF 14280 14986 MT (R. McQueen, N. Bush, C. Gianone)SH /Times-Italic SF 8280 16091 MT (Version:)SH /Courier SF 14280 XM (3.3.117)SH /Times-Italic SF 8280 17196 MT (Date:)SH /Times-Roman SF 14280 XM (June 1, 1988)SH 12 /Times-Bold AF 8280 19784 MT (VAX/VMS Kermit-32 Capabilities At a Glance:)SH 10 /Times-Roman AF 9280 21575 MT (Local operation:)SH 34480 XM (Yes)SH 9280 22680 MT (Remote operation:)SH 34480 XM (Yes)SH 9280 23785 MT (Transfers text files:)SH 34480 XM (Yes)SH 9280 24890 MT (Transfers binary files:)SH 34480 XM (Yes)SH 9280 25995 MT (Wildcard send:)SH 34480 XM (Yes)SH /Courier SF 9280 27100 MT (^X/^Y)SH /Times-Roman SF 12530 XM (interruption:)SH 34480 XM (Yes)SH 9280 28205 MT (Filename collision avoidance:)SH 34480 XM (Yes)SH 9280 29310 MT (Timeouts:)SH 34480 XM (Yes)SH 9280 30415 MT (8th-bit prefixing:)SH 34480 XM (Yes)SH 9280 31520 MT (Repeat character compression:)SH 34480 XM (Yes)SH 9280 32625 MT (Alternate block check types:)SH 34480 XM (Yes)SH 9280 33730 MT (Communication settings:)SH 34480 XM (Yes)SH 9280 34835 MT (Transmit BREAK:)SH 34480 XM (No)SH 9280 35940 MT (IBM mainframe communication:)SH 34480 XM (Yes)SH 9280 37045 MT (Transaction logging:)SH 34480 XM (Yes)SH 9280 38150 MT (Session logging \050raw capture\051:)SH 34480 XM (Yes)SH 9280 39255 MT (Debug logging:)SH 34480 XM (Yes)SH 9280 40360 MT (Raw transmit:)SH 34480 XM (Yes)SH 9280 41465 MT (Login scripts:)SH 34480 XM (No)SH 9280 42570 MT (Act as server:)SH 34480 XM (Yes)SH 9280 43675 MT (Talk to server:)SH 34480 XM (Yes)SH 9280 44780 MT (Advanced commands for servers:)SH 34480 XM (Yes)SH 9280 45885 MT (Local file management:)SH 34480 XM (Yes)SH 9280 46990 MT (Initialization file:)SH 34480 XM (Yes \050)SH /Courier SF (VMSKERMIT.INI)SH /Times-Roman SF (\051)SH 9280 48095 MT (Long packets:)SH 34480 XM (No)SH 9280 49200 MT (Sliding windows:)SH 34480 XM (No)SH 9280 50305 MT (Attribute packets:)SH 34480 XM (No)SH 8280 52697 MT (Kermit-32 is a program that implements the Kermit file transfer protocol for the Digital Equipment Corporation)137 W 8280 53893 MT (VAX series computers under the VAX/VMS operating system. It is) 141 W( written in BLISS-32 and MACRO-32, with)140 W 8280 55089 MT (sources for) 124 W( all BLISS modules also available as MACRO-32 sources. Kermit-32 should run on any VAX/VMS)125 W 8280 56285 MT (system from version 4.0 on \050Version 3)SH /Courier SF (.)SH /Times-Roman SF (1 of Kermit-32 is the last version that runs under pre-4.0 releases of VMS\051.)SH 8280 58677 MT (The first section of this chapter) 16 W( will describe the things you need to know about the VAX/VMS file system and how)15 W 8280 59873 MT (Kermit-32 uses it. The second section) 176 W( describes the special features of Kermit-32. The final section contains)177 W 8280 61069 MT (information of interest to those who need to install Kermit-32 on a system.)SH ES %%Page: 212 213 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 212)SH 12 /Times-Bold AF 28254 XM (Kermit User Guide: VAX/VMS KERMIT \05011.1\051)SH 46800 50 6120 5709 UL 14 SS 6120 8138 MT (11.1. The VAX/VMS File System)SH 10 /Times-Roman AF 6120 10256 MT (The two main items of interest of the VAX/VMS file system \050for the) 287 W( Kermit user\051 are the format of file)286 W 6120 11452 MT (specifications and the types of files and file data.)SH 12 /Times-Bold AF 6120 14040 MT (VAX/VMS File Specifications)SH 10 /Times-Roman AF 6120 15454 MT (VAX/VMS file specifications are of the form)SH /Courier SF 8520 17109 MT (NODE::DEVICE:[DIRECTORY]NAME.TYPE;VERSION)SH /Times-Roman SF 6120 18826 MT (Under version 3.x of VMS, NAME may be up to 9 characters,) 83 W( TYPE may be up to 3 characters and each item in)84 W 6120 20022 MT (DIRECTORY may be up to 9 character long. Only alphanumeric) 30 W( characters may be used in DIRECTORY, NAME)29 W 6120 21218 MT (and TYPE.)SH 6120 23610 MT (Under version 4.0 \050and later\051 of VMS, NAME,) 77 W( TYPE and each item in DIRECTORY may be up to 39 characters)78 W 6120 24806 MT (long, and may contain alphanumeric characters plus underscore.)SH 6120 27198 MT (VERSION is a decimal number indicating the version of the file \050generation\051. DEVICE may be either a physical or)25 W 6120 28394 MT (logical device name. If it is a logical name, it may be up to) 140 W( 63 characters long and may contain alphanumeric)141 W 6120 29590 MT (characters plus dollar signs and underscores.) 112 W( NODE) 473 W( may be either a logical name which translates to a DECnet)111 W 6120 30786 MT (node name or a physical DECnet node name.) 279 W( In) 810 W( either case, access information can be included \050see the)280 W 6120 31982 MT (DECnet-VMS User's guide for more information\051. The node name) 128 W( is not normally present, since most files are)127 W 6120 33178 MT (accessed on the same node where the user's job is running.) 126 W( The) 504 W( version number is not normally given \050in fact,)127 W 6120 34374 MT (should not normally be given\051. When device and/or directory are not supplied, they) 110 W( default to the user's current)109 W 6120 35570 MT (default device and directory. Therefore,)75 W /Courier SF 22953 XM (NAME.TYPE)SH /Times-Roman SF 28678 XM (is normally all that is needed to specify a file on the user's)76 W 6120 36766 MT (default device and directory. This is also all the Kermit-32 will normally) 231 W( send as the name of a file being)230 W 6120 37962 MT (transferred.)SH 6120 40354 MT (The node field) 269 W( specifies the name \050and access information\051 for the DECnet node where the file is located.)270 W 6120 41550 MT (Kermit-32 does not transmit the) 2 W( node field to the target system, but will attempt to honor a node field in an incoming)1 W 6120 42746 MT (file name.)SH 6120 45138 MT (The device field specifies a physical or "logical" device upon which the) 8 W( file is resident. The directory field indicates)9 W 6120 46334 MT (the area on the device, for instance the area belonging to the owner of the file.) 174 W( Kermit-32) 597 W( does not normally)173 W 6120 47530 MT (transmit the device or directory) 65 W( fields to the target system, but will attempt to honor device or directory fields that)66 W 6120 48726 MT (may appear in incoming file names. It will not create new directories, however, so any directory must already exist.)SH 6120 51118 MT (The name is the primary identifier for the file. The type, also called the "extension", is an indicator which, by)144 W 6120 52314 MT (convention, tells what kind of file we have. For instance)16 W /Courier SF 29265 XM (FOO.FOR)SH /Times-Roman SF 33732 XM (is the source of a Fortran program named FOO;)17 W /Courier SF 6120 53510 MT (FOO.OBJ)SH /Times-Roman SF 10909 XM (might be the relocatable) 339 W( object module produced by compiling)338 W /Courier SF 39312 XM (FOO.FOR)SH /Times-Roman SF (;)SH /Courier SF 44378 XM (FOO.EXE)SH /Times-Roman SF 49166 XM (could an)338 W 6120 54706 MT (executable program produced by LINKing)SH /Courier SF 23421 XM (FOO.REL)SH /Times-Roman SF (, and so forth.)SH 6120 57098 MT (VAX/VMS allows a group of files to be specified in a) 70 W( single file specification by including the special "wildcard")71 W 6120 58294 MT (characters, ")65 W /Courier SF (*)SH /Times-Roman SF (" and ")65 W /Courier SF (%)SH /Times-Roman SF (". A) 380 W( ")65 W /Courier SF (*)SH /Times-Roman SF (" matches any string of characters, including no characters at all; a ")64 W /Courier SF (%)SH /Times-Roman SF (" matches any)64 W 6120 59490 MT (single character. Here are some examples:)SH /Courier SF 6120 61281 MT (*.FOR)SH /Times-Roman SF 10120 XM (All files of type)SH /Courier SF 16675 XM (FOR)SH /Times-Roman SF 18725 XM (\050all Fortran source files\051 in the default directory.)SH /Courier SF 6120 62939 MT (FOO.*)SH /Times-Roman SF 10120 XM (Files of all types with name)SH /Courier SF 21453 XM (FOO)SH /Times-Roman SF (.)SH /Courier SF 6120 64597 MT (F*.*)SH /Times-Roman SF 10120 XM (All files whose names start with F.)SH /Courier SF 6120 66255 MT (F*X*.*)SH /Times-Roman SF 10120 XM (All files whose names start with F and contain at least one X.)SH /Courier SF 6120 67913 MT (%.*)SH /Times-Roman SF 10120 XM (All files whose names are exactly one character long.)SH /Courier SF 6120 69571 MT (*.%%*)SH /Times-Roman SF 10120 XM (All files whose types are at least two characters long.)SH 6120 71362 MT (Wildcard notation is used on many computer systems in similar ways, and it is the) 15 W( mechanism most commonly used)16 W ES %%Page: 213 214 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (11.1. The VAX/VMS File System)SH 10 /Times-Italic AF 51275 XM (Page 213)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (to instruct Kermit to send a group of files.)SH 13 /Times-Bold AF 24205 11245 MT (Text Files and Binary Files)SH 10 /Times-Roman AF 8280 13618 MT (The file system used by VAX/VMS provides for a large number of attributes to be) 31 W( associated with each file. These)30 W 8280 14814 MT (attributes provide some indication of whether the file is a text file, or is some other type) 49 W( of non-text data. The two)50 W 8280 16010 MT (major attributes that affect Pro/Kermit are the record type and record) 156 W( attribute. The record type describes how)155 W 8280 17206 MT (logical records are stored in the file. Records may be of some fixed length \050specified by another) 158 W( attribute\051, or)159 W 8280 18402 MT (variable length \050specified within each record\051, or stream \050implying no real record divisions\051. The record attributes)68 W 8280 19598 MT (describe how the breaks between records are to be treated. For example, a) 6 W( record attribute of implied carriage return)7 W 8280 20794 MT (means that any program reading the file with intentions of printing it out) 147 W( should add a carriage return/line feed)146 W 8280 21990 MT (sequence between each record. Other attributes include FORTRAN carriage control and print file format.)SH 8280 24382 MT (The "standard" method of storing) 121 W( text in a file under VAX/VMS is to store one line of text per record \050variable)122 W 8280 25578 MT (length records\051, with a carriage return/line feed sequence) 37 W( implied by the end of the record \050implied carriage return\051.)36 W 8280 26774 MT (This is) 11 W( the method Kermit-32 uses to store files it receives when using FILE TYPE TEXT. Note that there are other)12 W 8280 27970 MT (formats which are used) 19 W( to store text under VAX/VMS, however, the one used be Kermit-32 is the only one which is)18 W 8280 29166 MT (handled correctly by all known utility programs under VAX/VMS. Also, most programs which work with text) 26 W( files)27 W 8280 30362 MT (\050the editor EDT, for example\051 place some limit on) 80 W( the length of the lines which can be handled. Typically this is)79 W 8280 31558 MT (255. Kermit-32) 408 W( can write files with up to 4095 characters on) 79 W( a line, which means a text file from another system)80 W 8280 32754 MT (may be transferred and stored correctly by Kermit-32, but may still be unusable by certain VAX/VMS programs.)SH 8280 35146 MT (Certain PC applications may) 39 W( create text files with lines even longer than Kermit-32's maximum. Typical examples)38 W 8280 36342 MT (are the ASCII export) 130 W( procedures of database, spreadsheet, and CAD packages. If you try to send such a file to)131 W 8280 37538 MT (Kermit-32, the transfer will fail with a message:)SH /Courier SF 10680 39193 MT (%KERMIT32-E-REC_TOO_BIG, Record too big for KERMIT's internal buffer)SH /Times-Roman SF 8280 40910 MT (If this happens, you can SET FILE TYPE BINARY on the VAX) 56 W( before transferring the file to it. You should still)55 W 8280 42106 MT (be able to use the file as a text file, with the above proviso about record length.)SH 8280 44498 MT (There is no standard format for storing binary files. Basically, any record format with no record) 41 W( attributes are used)42 W 8280 45694 MT (for binary files.) 166 W( Since) 581 W( programs which work with binary files under VAX/VMS expect to see some particular)165 W 8280 46890 MT (format, more information is needed for transfer of binary files than for transfer of) 43 W( text files. The current version of)44 W 8280 48086 MT (Kermit-32 is not capable of transferring all types of binary files which) 141 W( were created on a VAX/VMS system to)140 W 8280 49282 MT (another system and retrieving) 147 W( them intact, nor is it capable of transferring all of types binary files created on a)148 W 8280 50478 MT (VAX/VMS system to another VAX/VMS, P/OS, or RSX-11M/M+ system intact. However, certain) 172 W( formats of)171 W 8280 51674 MT (binary files can be transferred,) 4 W( and binary files from some other systems may be transferred to a VAX and recovered)5 W 8280 52870 MT (intact.)SH 8280 55262 MT (Binary files which are created on a VAX \050or other Files-11 systems\051 with fixed 512 byte records) 53 W( \050a fairly common)52 W 8280 56458 MT (format\051 can be transferred using Kermit-32. The only required action is to set the file type) 198 W( to "fixed" in the)199 W 8280 57654 MT (receiving Kermit-32.)SH 8280 60046 MT (Using two) 94 W( programs supplied with Kermit-32, it is possible to transfer almost any type of sequential file between)93 W 8280 61242 MT (VAXes, or between a VAX and a P/OS or RSX-11M/M+ system. These two) 32 W( programs \050VMSHEX and VMSDEH\051)33 W 8280 62438 MT (will convert the binary files to text \050using a variation on Intel hex) 31 W( format\051. The resulting text file can be transferred)30 W 8280 63634 MT (like any other, and finally "dehexified" reproducing the original file, with the major) 20 W( attributes intact. Unfortunately,)21 W 8280 64830 MT (the text files tend to be about twice the size of the original binary files, so) 21 W( the transfers take a bit longer than regular)20 W 8280 66026 MT (text files. On the plus) 91 W( side, the text versions of the files can be transferred to any system with a Kermit and still)92 W 8280 67222 MT (retrieved intact. They can also be transferred over 7-bit data paths without any problems. The bootstrap) 42 W( procedure)41 W 8280 68418 MT (\050described below\051, makes use of hexified versions of the binary file which makes up Kermit-32.)SH ES %%Page: 214 215 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 214)SH 12 /Times-Bold AF 28254 XM (Kermit User Guide: VAX/VMS KERMIT \05011.1\051)SH 46800 50 6120 5709 UL 13 SS 16270 8071 MT (Using the VAX to Archive Microcomputer Files)SH 10 /Times-Roman AF 6120 10444 MT (You can use) 31 W( Kermit to send textual files from a microcomputer or any 8-bit system to a VAX/VMS system with no)32 W 6120 11640 MT (special provisions, since Kermit-32 stores incoming files) 47 W( as text files \050variable length records with implied carriage)46 W 6120 12836 MT (returns\051 unless it is explicitly told otherwise. But Kermit-32 has no) 86 W( automatic way of distinguishing an incoming)87 W 6120 14032 MT (binary file from an incoming text file. It turns out that because of) 89 W( the method used by Kermit-32 for storing text)88 W 6120 15228 MT (files, a binary file can be stored like a text file so long as it does not contain) 60 W( a string of more than 4095 characters)61 W 6120 16424 MT (between carriage return,) 70 W( line feed sequences, and ends with a carriage return line feed. Since most binary files do)69 W 6120 17620 MT (not have these) 32 W( characteristics, you must inform Kermit-32 that a file it is about to receive is to be stored as a binary)33 W 6120 18816 MT (file. This) 504 W( is done) 127 W( using the SET FILE TYPE BINARY command. This instructs Kermit-32 to store the data it)126 W 6120 20012 MT (receives in the file without checking for carriage return, line feed sequences. The file) 120 W( it creates will be variable)121 W 6120 21208 MT (record length, with no record attributes. Each record will contain 510 bytes) 135 W( of data, except the last, which will)134 W 6120 22404 MT (contain whatever amount is left before the end of the file. This allows Kermit-32 to correctly return exactly) 14 W( the data)15 W 6120 23600 MT (it was sent when the file is returned to the original system.)SH 6120 25992 MT (Note that because of the need) 56 W( to use a different file type for binary files, it is not possible to use a "wildcard send")55 W 6120 27188 MT (command to send a mixture of text and binary files to a) 14 W( VAX system unless the text files are not intended for use on)15 W 6120 28384 MT (the VAX; rather, you must send all text files with Kermit-32's file type set to text, and) 52 W( all binary files with the file)51 W 6120 29580 MT (type set to binary.)SH 6120 31972 MT (Once you get the) 159 W( foreign file into the VAX system, stored with the correct file type, you need take no special)160 W 6120 33168 MT (measures to send it back to its system of) 39 W( origin. This is because Kermit-32 honors the record type and attributes of)38 W 6120 34364 MT (the file as it is stored) 158 W( on the VAX. In fact, SET FILE TYPE BINARY or TEXT only affects how Kermit-32)159 W 6120 35560 MT (receives files - it does not affect how Kermit-32 transmits files.)SH 13 /Times-Bold AF 20764 38919 MT (Files Kermit-32 Cannot Handle)SH 10 /Times-Roman AF 6120 41292 MT (The Kermit protocol can only accommodate transfer) 1 W( of)SH /Times-Italic SF 28454 XM (sequential)SH /Times-Roman SF 32815 XM (files, files which are a linear sequence of bytes \050or)SH 6120 42488 MT (words\051.)SH 6120 44880 MT (Some files on a VAX/VMS system are not sequential, and cannot) 101 W( be successfully sent or received by Kermit-32.)102 W 6120 46076 MT (These are mainly indexed data files, but can also include other files which) 31 W( require more than just the data in the file)30 W 6120 47272 MT (to be completely reconstructed. External control information and file attributes are not transmitted.) 59 W( However,)370 W /Times-Italic SF 51476 XM (any)SH /Times-Roman SF 6120 48468 MT (VMS file can be transferred with Kermit if it has been "hexified" with VMSHEX.)SH 14 /Times-Bold AF 6120 52070 MT (11.2. Program Operation)SH 10 /Times-Roman AF 6120 54188 MT (Kermit-32's prompt is normally ")42 W /Courier SF (Kermit-32>)SH /Times-Roman SF (". If) 334 W( a foreign command is defined) 42 W( to run Kermit-32 \050eg.)41 W /Courier SF 49320 XM (KERMIT)SH 6120 55384 MT (:= $KERMIT)SH /Times-Roman SF (\051, Kermit-32 will accept a single command on the command line, like this:)SH /Courier SF 8520 57039 MT ($)SH 8520 58070 MT ($ Kermit send foo.bar)SH 11400 50 9720 58270 UL /Times-Italic SF 9720 59785 MT (the file is sent)SH /Courier SF 8520 61440 MT ($)SH 8520 62471 MT ($ mcr kermit send foo.bar)SH 13800 50 9720 62671 UL /Times-Italic SF 9720 64186 MT (the file is sent)SH /Courier SF 8520 65841 MT ($)SH /Times-Roman SF 6120 67558 MT (You can run the program interactively to issue several commands, like this:)SH /Courier SF 8520 69213 MT ($)SH 8520 70244 MT ($ run sys$system:kermit)SH 12600 50 9720 70444 UL 8520 71275 MT (VMS Kermit-32 version 3.3.117)SH ES %%Page: 215 216 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (11.2. Program Operation)SH 10 /Times-Italic AF 51275 XM (Page 215)SH 46800 50 8280 5709 UL /Courier SF 10680 7824 MT (Default terminal for transfers is: _TTA1:)SH 10680 9479 MT (Kermit-32>send foo.*)SH 6000 50 16680 9679 UL /Times-Italic SF 11880 11194 MT (files are sent)SH /Courier SF 10680 12849 MT (Kermit-32>statistics)SH 6000 50 16680 13049 UL /Times-Italic SF 11880 14564 MT (performance statistics are printed)SH /Courier SF 10680 16219 MT (Kermit-32>receive)SH 4200 50 16680 16419 UL /Times-Italic SF 11880 17934 MT (files are received)SH /Courier SF 10680 19589 MT (Kermit-32>exit)SH 2400 50 16680 19789 UL 10680 20620 MT ($)SH /Times-Roman SF 8280 23012 MT (Upon initial startup, Kermit-32 executes commands from its initialization) 95 W( file,)96 W /Courier SF 40730 XM (VMSKERMIT.INI)SH /Times-Roman SF (, if any, in your)96 W 8280 24208 MT (directory.)SH 8280 26600 MT (Command keywords may be abbreviated to their shortest prefix that sets them apart from) 5 W( any other keyword valid in)4 W 8280 27796 MT (that field.)SH 8280 30188 MT (Kermit-32 provides most of the commands possible for an "ideal" Kermit program, as described in the main part) 38 W( of)39 W 8280 31384 MT (the)SH /Times-Italic SF 9752 XM (Kermit User Guide)SH /Times-Roman SF (. The) 250 W( following sections will concentrate on system-dependent aspects of Kermit-32.)SH 14 /Times-Bold AF 8280 34986 MT (11.3. Conditioning Your Job for Kermit)SH 10 /Times-Roman AF 8280 37104 MT (Kermit-32 does as much) 112 W( as it can to condition your line for file transfer. It saves all your terminal settings, and)111 W 8280 38300 MT (restores them after use. However, there are some sources) 54 W( of interference over which Kermit-32 has no control. In)55 W 8280 39496 MT (particular, messages issued by other processes in your job could become mingled with Kermit packets and slow)132 W 8280 40692 MT (things down or stop them entirely. This is a fairly rare occurence and can be easily avoided by not) SH( running any other)1 W 8280 41888 MT (process which wishes to perform I/O to your terminal while you are running Kermit-32.)SH 8280 44280 MT (Normally, when Kermit-32 is run, it assumes you wish to use it in remote) 49 W( mode and perform file transfers over the)48 W 8280 45476 MT (terminal line which controls your job. This) 52 W( can be overridden, however, by defining a logical name which equates)53 W 8280 46672 MT (to some other terminal line in) 21 W( the system. The default terminal line to be used for file transfers is determined by the)20 W 8280 47868 MT (first of the following) 84 W( logical names which translates to a terminal line which is available for use by your process:)85 W 8280 49064 MT (KER$COMM, SYS$INPUT, SYS$OUTPUT, and SYS$COMMAND. If none of these logical names) 6 W( translate to an)5 W 8280 50260 MT (available terminal line, there is no default terminal line and a SET LINE command must be used before) 22 W( any transfer)23 W 8280 51456 MT (command is performed. Note that this is the typical case in a batch job.)SH 8280 53848 MT (Kermit-32 will also default the type of parity) 17 W( to be used on the communication line to that which is set on its default)16 W 8280 55044 MT (terminal line when it is started. This means that if all communication at a site) 75 W( is normally done using even parity)76 W 8280 56240 MT (\050for example\051, Kermit-32 will also use even parity.)SH 8280 58632 MT (There are two things to) 46 W( keep in mind when using Kermit-32 in local mode \050where the file transfers are done over a)45 W 8280 59828 MT (different terminal line from where commands are typed\051:)SH /Symbol SF 10070 61733 MT (\267)SH /Times-Roman SF 10780 XM (Under VAX/VMS, every terminal line has an owner UIC and protection code) 64 W( associated with it. This)65 W 10780 62838 MT (UIC and) 114 W( protection is used to determine who can allocate \050and therefore use\051 the terminal line when)113 W 10780 63943 MT (they are not logged in on that) 12 W( line. Therefore, in order for Kermit-32 to be able to perform file transfers)13 W 10780 65048 MT (over a terminal line other than the one on which) 59 W( you are logged in, the field of the protection code for)58 W 10780 66153 MT (the terminal which applies to your job \050based on your UIC and) 103 W( the owner UIC of the terminal\051 must)104 W 10780 67258 MT (allow your job) 109 W( access to the terminal. You may need to request your system manager to change the)108 W 10780 68363 MT (protection for a) 74 W( terminal line to allow you to use it with Kermit-32 in local mode. See the section on)75 W 10780 69468 MT (Installation for details.)SH /Symbol SF 10070 71126 MT (\267)SH /Times-Roman SF 10780 XM (Terminal lines which) 228 W( have been declared as modem control lines will have the phone "hung up")227 W ES %%Page: 216 217 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 216)SH 12 /Times-Bold AF 28254 XM (Kermit User Guide: VAX/VMS KERMIT \05011.3\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 8620 7886 MT (whenever the terminal line becomes) 135 W( free \050deallocated\051. This means that if you do not use the DCL)136 W 8620 8991 MT (ALLOCATE command to) 191 W( allocate the terminal line to your job before entering Kermit-32, exiting)190 W 8620 10096 MT (Kermit-32 will cause the terminal line to "hang up" the modem. If you) 106 W( do wish to get to DCL after)107 W 8620 11201 MT (having used Kermit-32 to connect) 58 W( a modem control line which you do not have allocated, you can use)57 W 8620 12306 MT (the PUSH command to spawn a subprocess running DCL.)SH 14 /Times-Bold AF 6120 15908 MT (11.4. Kermit-32 Commands)SH 10 /Times-Roman AF 6120 18026 MT (This section describes the Kermit-32 commands -- in detail where they differ from the) 19 W( "ideal" Kermit, briefly where)20 W 6120 19222 MT (they coincide. Kermit-32 has the following commands:)SH /Courier SF 14520 20832 MT (@)SH /Times-Roman SF 15620 XM (synonym for "take".)SH 13120 21937 MT (BYE)SH 15620 XM (to remote server.)SH 10398 23042 MT (CONNECT)SH 15620 XM (as terminal to remote system.)SH 12843 24147 MT (EXIT)SH 15620 XM (from Kermit-32.)SH 11898 25252 MT (FINISH)SH 15620 XM (Shut down remote server.)SH 13176 26357 MT (GET)SH 15620 XM (remote files from server.)SH 12620 27462 MT (HELP)SH 15620 XM (with Kermit-32.)SH 11787 28567 MT (LOCAL)SH 15620 XM (prefix for local file management commands.)SH 13065 29672 MT (LOG)SH 15620 XM (remote terminal session.)SH 11010 30777 MT (LOGOUT)SH 15620 XM (remote server.)SH 12564 31882 MT (PUSH)SH 15620 XM (to DCL command level.)SH 12732 32987 MT (QUIT)SH 15620 XM (from Kermit-32.)SH 10898 34092 MT (RECEIVE)SH 15620 XM (files from remote Kermit.)SH 11009 35197 MT (REMOTE)SH 15620 XM (prefix for remote file management commands.)SH 12509 36302 MT (SEND)SH 15620 XM (files to remote Kermit.)SH 11286 37407 MT (SERVER)SH 15620 XM (mode of remote operation.)SH 13342 38512 MT (SET)SH 15620 XM (various parameters.)SH 12176 39617 MT (SHOW)SH 15620 XM (various parameters.)SH 11342 40722 MT (STATUS)SH 15620 XM (about most recent file transfer.)SH 10009 41827 MT (TRANSMIT)SH 15620 XM (Transmit \050upload\051 a file with no error checking.)SH 12454 42932 MT (TAKE)SH 15620 XM (Kermit-32 commands from a file.)SH 12 /Times-Bold AF 6120 46048 MT (11.4.1. Commands for File Transfer)SH 10 /Times-Roman AF 6120 47990 MT (Kermit-32 provides the standard SEND, RECEIVE, and GET commands for transferring files) 161 W( using the Kermit)160 W 6120 49186 MT (protocol.)SH 13 /Times-Bold AF 23452 52545 MT (The SEND Command)SH 10 /Times-Roman AF 6120 54918 MT (Syntax:)SH 6120 57310 MT (Sending a file or files:)SH /Courier SF 8120 58828 MT (SEND)SH /Times-Italic SF 11120 XM (filespec)SH /Times-Roman SF 6120 61220 MT (The SEND command causes a file or file group to be sent from the VAX to the) 68 W( other system. If)69 W /Times-Italic SF 46213 XM (filespec)SH /Times-Roman SF 49587 XM (contains)SH 6120 62416 MT (wildcard characters then all matching files will) 164 W( be sent, in alphabetical order \050according to the ASCII collating)163 W 6120 63612 MT (sequence\051 by name. If)85 W /Times-Italic SF 15875 XM (filespec)SH /Times-Roman SF 19265 XM (does not contain any wildcard characters, then the single file) 85 W( specified by)86 W /Times-Italic SF 49865 XM (filespec)SH /Times-Roman SF 6120 64808 MT (will be sent.)SH ES %%Page: 217 218 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (11.4.1. Commands for File Transfer)SH 10 /Times-Italic AF 51275 XM (Page 217)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8880 8004 MT (SEND Command General Operation:)SH 10 /Times-Roman AF 8280 9418 MT (Files will be sent with) 188 W( at least their VAX/VMS file name and type \050for instance)187 W /Courier SF 43113 XM (FOO.BAR)SH /Times-Roman SF (\051. If) 624 W( a SET FILE)187 W 8280 10614 MT (NAMING FULL) 60 W( command has been given, Kermit-32 will also send the device name, directory name and version)61 W 8280 11810 MT (number \050for instance)378 W /Courier SF 17995 XM (USER$DISK:[JOE]FOO.BAR;25)SH /Times-Roman SF (\051. If) 1006 W( a SET FILE) 378 W( NAMING UNTRANSLATED)377 W 8280 13006 MT (command has been given, Kermit-32 will send the file name, type and version number \050for instance)7 W /Courier SF 48497 XM (FOO.BAR;25)SH /Times-Roman SF (\051.)SH 8280 14202 MT (If a SET) 98 W( FILE NAMING NORMAL_FORM command has been given \050this is the initial default\051, Kermit-32 will)97 W 8280 15398 MT (only send the file name and type.)SH 8280 17790 MT (Each file will be sent according to the record type and) 45 W( attributes recorded in its file descriptor. Kermit-32 attempts)46 W 8280 18986 MT (to translate all formats of text file \050including those with FORTRAN or print carriage control\051) 50 W( to a format usable on)49 W 8280 20182 MT (any system. Note that there is no need to set the FILE TYPE parameter for sending files,) 68 W( since Kermit-32 always)69 W 8280 21378 MT (uses the information from the file descriptor to determine how to send the file.)SH 8280 23770 MT (If communication line parity) 4 W( is being used \050see SET PARITY\051, Kermit-32 will request that the other Kermit accept a)3 W 8280 24966 MT (special kind of prefix notation for binary) 36 W( files. This is an advanced feature, and not all Kermits have it; if the other)37 W 8280 26162 MT (Kermit does not agree to use this feature, binary files) 64 W( cannot be sent correctly. This includes executable programs)63 W 8280 27358 MT (\050like)SH /Courier SF 10486 XM (.EXE)SH /Times-Roman SF 13259 XM (files, CP/M)123 W /Courier SF 18368 XM (.COM)SH /Times-Roman SF 21142 XM (files\051, relocatable object modules \050)124 W /Courier SF (.OBJ)SH /Times-Roman SF 38270 XM (files\051, as well as any text file containing)124 W 8280 28554 MT (characters with the eighth bit on.)SH 8280 30946 MT (Kermit-32 will also ask the other Kermit whether it can handle a special prefix encoding for repeated characters. If)34 W 8280 32142 MT (it can,) 30 W( then files with long strings of repeated characters will be transmitted very efficiently. Columnar data, highly)31 W 8280 33338 MT (indented text, and binary files are the major beneficiaries of this technique.)SH 8280 35730 MT (If you're) 18 W( running Kermit-32 locally, for instance dialing out from a VAX to another system using an autodialer, you)17 W 8280 36926 MT (should have already run Kermit on the remote system and issued either a RECEIVE or a SERVER) 16 W( command. Once)17 W 8280 38122 MT (you give Kermit-32 the SEND command, the name) 128 W( of each file will be displayed on your screen as the transfer)127 W 8280 39318 MT (begins. If) 250 W( the file is successfully transferred, you will see ")SH /Courier SF ([OK])SH /Times-Roman SF (", otherwise there will be an error message.)SH 8280 41710 MT (During local operation, you can type Control-A at) 92 W( any point during the transfer to get a brief status report.) 93 W( You)779 W 8280 42906 MT (may also type Control-X or Control-Z to interrupt the current file or file group.)SH 13 /Times-Bold AF 24384 46265 MT (The RECEIVE Command)SH 10 /Times-Roman AF 8280 48638 MT (Syntax:)SH /Courier SF 11836 XM (RECEIVE [)SH /Times-Italic SF (filespec)SH /Courier SF (])SH /Times-Roman SF 8280 51030 MT (The RECEIVE command tells Kermit-32 to receive a) 92 W( file or file group from the other system. If only one file is)91 W 8280 52226 MT (being received,) 84 W( you may include the optional)85 W /Times-Italic SF 27149 XM (filespec)SH /Times-Roman SF 30539 XM (as the name to store the incoming file under; otherwise, the)85 W 8280 53422 MT (name is taken from the incoming file header. If the name in the header is not a legal VAX/VMS file) 188 W( name,)187 W 8280 54618 MT (Kermit-32 will normally replace the illegal characters with "X" \050see SET FILE NAMING NORMAL_FORM\051.)SH 8280 57010 MT (If an incoming file has the same name as an existing file, Kermit-32 just creates a new version) 5 W( of the same name and)6 W 8280 58206 MT (type, for instance)SH /Courier SF 15445 XM (FOO.BAR;3, FOO.BAR;4)SH /Times-Roman SF (.)SH 8280 60598 MT (Incoming files will all be stored with the prevailing file type, ASCII by default, which is) 66 W( appropriate for text files.)65 W 8280 61794 MT (If you are asking Kermit-32 to receive binary files from a microcomputer) 45 W( or other 8-bit system, you must first type)46 W 8280 62990 MT (SET FILE TYPE BINARY. Otherwise, an error may occur when) 71 W( receiving the file, or a carriage return, line feed)70 W 8280 64186 MT (will be added to the end of the file and the file will be useless when sent back to the system of origin.)SH 8280 66578 MT (If parity) 31 W( is being used on the communications line, then 8th-bit prefixing will be requested. If the other side cannot)32 W 8280 67774 MT (do this, binary files cannot be transferred correctly.)SH 8280 70166 MT (If an incoming file does not arrive in) 145 W( its entirety, Kermit-32 will normally discard it; it will not appear in your)144 W 8280 71362 MT (directory. You) 392 W( may change this behavior by using the command SET INCOMPLETE KEEP, which will cause as)72 W ES %%Page: 218 219 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 218)SH 12 /Times-Bold AF 27354 XM (Kermit User Guide: VAX/VMS KERMIT \05011.4.1\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (much of the file as arrived to be saved in your directory.)SH 8 SS 41841 9933 MT (1)SH 10 SS 6120 10278 MT (If you are running Kermit-32 locally, you should already have issued a SEND command)26 W 42516 XM (to the remote Kermit, and)25 W 6120 11474 MT (then escaped back to Kermit-32. As files arrive, their names will be displayed on) 161 W( your screen. You can type)162 W 6120 12670 MT (Control-A during the transfer for a brief status report.)SH 6120 15062 MT (If a file arrives that you don't really want, you can attempt to cancel it) 7 W( by typing Control-X; this sends a cancellation)6 W 6120 16258 MT (request to the remote Kermit. If the remote Kermit understands this) 132 W( request \050not all implementations of Kermit)133 W 6120 17454 MT (support this feature\051, it will comply; otherwise it will continue to send. If a file) 23 W( group is being sent, you can request)22 W 6120 18650 MT (the entire group be cancelled by typing Control-Z.)SH 13 /Times-Bold AF 23813 22009 MT (The GET Command)SH 10 /Times-Roman AF 6120 24382 MT (Syntax:)SH /Courier SF 9426 XM (GET [)SH /Times-Italic SF (remote-filespec)SH /Courier SF (])SH /Times-Roman SF 6120 26774 MT (The GET command requests a remote Kermit server to send the file or file group specified) 19 W( by)20 W /Times-Italic SF 44187 XM (remote-filespec)SH /Times-Roman SF (. This)290 W 6120 27970 MT (command can be used only when Kermit-32 is local, with a Kermit server on the other) 52 W( end of the line specified by)51 W 6120 29166 MT (SET LINE. This means that you must have CONNECTed to the other system,) 61 W( logged in, run Kermit there, issued)62 W 6120 30362 MT (the SERVER command, and escaped back to the VAX.)SH 6120 32754 MT (The remote filespec is any string that can be a legal file specification for the) 138 W( remote system; it is not parsed or)137 W 6120 33950 MT (validated locally. Any leading spaces before the remote filespec are stripped, and lower case) 8 W( characters are raised to)9 W 6120 35146 MT (upper case.)SH 6120 37538 MT (As files arrive, their names will be) 201 W( displayed on your screen. As in the RECEIVE command, you may type)200 W 6120 38734 MT (Control-A to get a brief status report, ^X to request that the current incoming file be cancelled, ^Z to request that the)11 W 6120 39930 MT (entire incoming batch be cancelled.)SH 6120 42322 MT (If the remote Kermit) 5 W( is not capable of server functions, then you will probably get an error message back from it like)4 W 6120 43518 MT ("Illegal packet type". In this case, you must connect to the other Kermit,) 34 W( give a SEND command, escape back, and)35 W 6120 44714 MT (give a RECEIVE command.)SH 13 /Times-Bold AF 22657 48073 MT (The STATUS Command)SH 10 /Times-Roman AF 6120 50446 MT (Give statistics about the most recent file transfer.)SH 13 /Times-Bold AF 23452 53805 MT (The PUSH Command)SH 10 /Times-Roman AF 6120 56178 MT (Syntax:)SH /Courier SF 9426 XM (TAKE)SH /Times-Roman SF 6120 58570 MT (Invoke an inferior DCL command processor, to which you may issue) 141 W( any DCL commands. Type LOGOUT to)140 W 6120 59766 MT (return to Kermit-32.)SH 10800 50 6120 70283 UL 6 SS 6920 71691 MT (1)SH 8 /Times-Italic AF 7220 72000 MT (not)SH /Times-Roman SF 8442 XM (SERVER -- use the GET command to receive files from a Kermit server.)SH ES %%Page: 219 220 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (11.4.1. Commands for File Transfer)SH 10 /Times-Italic AF 51275 XM (Page 219)SH 46800 50 8280 5709 UL 13 /Times-Bold AF 25504 8071 MT (The TAKE Command)SH 10 /Times-Roman AF 8280 10444 MT (Syntax:)SH /Courier SF 11586 XM (TAKE)SH /Times-Italic SF 14586 XM (file-spec)SH /Courier SF 18574 XM ([ /DISPLAY ])SH /Times-Roman SF 8280 12836 MT (Where 'file-spec' is any normal VAX/VMS file specification.) 104 W( If) 459 W( file-spec does not specify a file-type Kermit-32)105 W 8280 14032 MT (will supply a default of)5 W /Courier SF 17832 XM (.COM)SH /Times-Roman SF (. The /DISPLAY option causes the commands read from the file to be displayed on the)5 W 8280 15228 MT (user's terminal.)SH 8280 17620 MT (The TAKE command tells Kermit-32) 291 W( to execute commands from the specified file. You may also use the)292 W 8280 18816 MT (VAX/VMS notation "@" instead of Take to specify a command file.)SH 8280 21208 MT (The file)SH /Courier SF 11668 XM (VMSKERMIT.INI)SH /Times-Roman SF 19718 XM (is automatically taken upon program startup.)SH 12 /Times-Bold AF 8280 24324 MT (11.4.2. Server Operation)SH 13 SS 24709 27683 MT (The SERVER Command)SH 10 /Times-Roman AF 8280 30056 MT (The SERVER command puts a remote Kermit-32 in "server mode", so that it receives all further commands in)153 W 8280 31252 MT (packets from the local Kermit. The Kermit-32 server is capable \050as) 151 W( of this writing\051 of executing the following)152 W 8280 32448 MT (remote server commands: SEND, GET, FINISH, BYE, REMOTE DIRECTORY, REMOTE CWD, REMOTE)192 W 8280 33644 MT (SPACE, REMOTE DELETE, REMOTE) 346 W( TYPE, REMOTE HELP, REMOTE COPY, REMOTE RENAME,)347 W 8280 34840 MT (REMOTE SEND_MESSAGE, REMOTE WHO, and REMOTE HOST.)SH 8280 37232 MT (Any nonstandard parameters should be) 36 W( selected with SET commands before putting Kermit-32 into server mode, in)35 W 8280 38428 MT (particular the file type. The Kermit-32 server) 4 W( can send all files in the correct manner automatically. However, if you)5 W 8280 39624 MT (need to ask Kermit-32 to receive binary files you must issue the SET FILE) 180 W( TYPE BINARY command before)179 W 8280 40820 MT (putting it into server mode, and then you must only send binary files. You cannot) 64 W( send a mixture of text files and)65 W 8280 42016 MT (8-bit binary files to a Kermit-32 server unless the files are not for use on the VAX.)SH 13 /Times-Bold AF 25253 45375 MT (Commands for Servers)SH 10 /Times-Roman AF 8280 47748 MT (When running in local mode, Kermit-32 allows you) 68 W( to give a wide range of commands to a remote Kermit server,)67 W 8280 48944 MT (with no guarantee the that the remote server can process them, since they are all optional) 79 W( features of the protocol.)80 W 8280 50140 MT (Commands for servers include the standard)132 W /Courier SF 26680 XM (SEND)SH /Times-Roman SF (,)SH /Courier SF 29712 XM (GET)SH /Times-Roman SF (,)SH /Courier SF 32144 XM (BYE)SH /Times-Roman SF (,)SH /Courier SF 34576 XM (LOGOUT)SH /Times-Roman SF 38557 XM (and)SH /Courier SF 40382 XM (FINISH)SH /Times-Roman SF 44363 XM (commands, as well as the)131 W /Courier SF 8280 51336 MT (REMOTE)SH /Times-Roman SF 12130 XM (command.)SH 8280 53728 MT (Syntax:)SH /Courier SF 11586 XM (REMOTE)SH /Times-Italic SF 15786 XM (command)SH /Times-Roman SF 8280 56120 MT (Send the specified command to the remote server. If the server does not understand the command) 136 W( \050all of these)137 W 8280 57316 MT (commands are optional features of the Kermit protocol\051, it will reply with) 50 W( a message like "Unknown Kermit server)49 W 8280 58512 MT (command". If) 656 W( does understand, it will send the results back, and they will be displayed) 203 W( on the screen. The)204 W 8280 59708 MT (REMOTE commands are:)SH 8280 61499 MT (COPY)SH /Times-Italic SF 11197 XM (filespec)SH /Times-Roman SF 16280 XM (Copy file. The server is asked to make a copy of the specified) 53 W( file. Kermit-32 will prompt for)52 W 16280 62604 MT (the new file name on a separate line. Both filespecs must be in) 13 W( the correct format for the remote)14 W 16280 63709 MT (system. Kermit-32) 290 W( does not parse or validate the file specifications. Any leading spaces will be)19 W 16280 64814 MT (stripped and lower case characters converted to upper case. Note that this command simply)147 W 16280 65919 MT (provides for copying a file within the server's system - it does not cause a file to be transferred.)SH 8280 67496 MT (CWD [)SH /Times-Italic SF (directory)SH /Times-Roman SF (])SH 16280 XM (Change Working Directory. If no directory) 160 W( name is provided, the server will change to the)159 W 16280 68601 MT (default or home directory. Otherwise, you will be prompted for a) 38 W( password, and the server will)39 W 16280 69706 MT (attempt to change to the specified directory. The) 117 W( password is entered on a separate line, and)116 W 16280 70811 MT (does not echo as you type it. If access is not granted, the server will provide a message to that)57 W 16280 71916 MT (effect. Note) 592 W( that while not all server) 171 W( Kermits require \050or accept\051 a password to change the)170 W ES %%Page: 220 221 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 220)SH 12 /Times-Bold AF 27354 XM (Kermit User Guide: VAX/VMS KERMIT \05011.4.2\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 14120 7886 MT (working directory, Kermit-32 will always ask for one when a directory name is provided.)SH 6120 9463 MT (DELETE)SH /Times-Italic SF 10147 XM (filespec)SH /Times-Roman SF 14120 XM (Delete the specified file or files. The names) 120 W( of the files that are deleted will appear on your)121 W 14120 10568 MT (screen.)SH 6120 12145 MT (DIRECTORY [)SH /Times-Italic SF (filespec)SH /Times-Roman SF (])SH 14120 13250 MT (The names of the files that match the given) 69 W( file specification will be displayed on your screen,)70 W 14120 14355 MT (perhaps along with size and date information for each file. If no file specification is given, all)72 W 14120 15460 MT (files from the current directory will be listed.)SH 6120 17037 MT (DISK_USAGE [)SH /Times-Italic SF (directory)SH /Times-Roman SF (])SH 14120 18142 MT (Display information about disk usage) 216 W( in the given directory \050or by the given user\051. If no)215 W 14120 19247 MT (directory is provided, disk usage information is provided for the current) 96 W( working directory \050or)97 W 14120 20352 MT (user\051. This) 250 W( is the same as the REMOTE SPACE command.)SH 6120 21929 MT (EXIT)SH 14120 XM (Requests the server to leave Kermit, allowing the terminal to be used for normal commands.)SH 6120 23506 MT (FINISH)SH 14120 XM (Requests the) 73 W( server to return to the Kermit prompt, allowing statistics to be obtained about the)72 W 14120 24611 MT (transfers.)SH 6120 26188 MT (HELP [)SH /Times-Italic SF (topic)SH /Times-Roman SF (])SH 14120 XM (Provide information about the given topic. If no topic is given, provide a list of the) 88 W( functions)89 W 14120 27293 MT (that are available from the server.) 105 W( Some) 458 W( servers may ignore the topic and always display the)104 W 14120 28398 MT (same information.)SH 6120 29975 MT (HOST [)SH /Times-Italic SF (command)SH /Times-Roman SF (])SH 14120 XM (Pass the given command to the server's host command processor, and display the) 190 W( resulting)191 W 14120 31080 MT (output on your screen.)SH 6120 32657 MT (LOGIN)SH /Times-Italic SF 9480 XM (user-id)SH /Times-Roman SF 14120 XM (Supply information to the server Kermit to indicate what user-id, account and password are to) 2 W( be)1 W 14120 33762 MT (used. The) 375 W( server Kermit may use this to validate the user's access to the system as well as for)63 W 14120 34867 MT (billing purposes.) 71 W( It may also use this information to provide the user with access to files on its)70 W 14120 35972 MT (system.)SH 6120 37549 MT (LOGOUT)SH 14120 XM (Request the server to exit Kermit and logout its job \050or process\051. This command is identical) 57 W( to)58 W 14120 38654 MT (the LOGOUT command.)SH 6120 40231 MT (RENAME)SH /Times-Italic SF 10592 XM (filespec)SH /Times-Roman SF 14120 XM (Change the name on the specified file \050or files\051. Kermit-32 will) 233 W( prompt for the new file)232 W 14120 41336 MT (specification on the next line. Both file specifications must be valid for the server's system.)SH 6120 42913 MT (SEND_MESSAGE)SH /Times-Italic SF 14148 XM (destination-address)SH /Times-Roman SF 14120 44018 MT (Request the server to send a single line message to the) 165 W( specified destination address \050which)164 W 14120 45123 MT (might be a user-id, terminal) 37 W( designator, or some other item, depending upon the server Kermit\051.)38 W 14120 46228 MT (Kermit-32 will prompt for the single line message on the next line.)SH 6120 47805 MT (SPACE [)SH /Times-Italic SF (directory)SH /Times-Roman SF (])SH 14120 XM (Display information about disk usage) 216 W( in the given directory \050or by the given user\051. If no)215 W 14120 48910 MT (directory is provided, disk usage information is provided for the current) 96 W( working directory \050or)97 W 14120 50015 MT (user\051. This) 250 W( is the same as the REMOTE DISK_USAGE command.)SH 6120 51592 MT (STATUS)SH 14120 XM (Display information about the status of the server.)SH 6120 53169 MT (TYPE)SH /Times-Italic SF 8870 XM (filespec)SH /Times-Roman SF 14120 XM (Display the contents of the specified file on your screen.)SH 6120 54746 MT (WHO [)SH /Times-Italic SF (user-id)SH /Times-Roman SF (])SH 14120 XM (Display information about the given user. If no) 67 W( user-id is given, display information about the)66 W 14120 55851 MT (currently active users. Kermit-32 will prompt) 181 W( for options for selecting what information to)182 W 14120 56956 MT (display and/or formatting) 239 W( parameters. The format of both the user-id and the options are)238 W 14120 58061 MT (dependent upon the server Kermit.)SH 12 /Times-Bold AF 6120 61177 MT (11.4.3. Commands for Local File Management)SH 10 /Times-Roman AF 6120 63119 MT (Syntax:)SH /Courier SF 9426 XM (LOCAL [)SH /Times-Italic SF (command)SH /Courier SF (])SH /Times-Roman SF 6120 65511 MT (Execute the specified command on the local system -- on the VAX/VMS system where Kermit-32 is) 3 W( running. These)4 W 6120 66707 MT (commands provide some local file management capability without having to leave the Kermit-32 program. These)76 W 6120 67903 MT (commands are very similar to the REMOTE commands in function and syntax. They) 60 W( are all executed locally, and)61 W 6120 69099 MT (are available) 143 W( when Kermit-32 is either local or remote. The arguments to these commands are the same as the)142 W 6120 70295 MT (arguments expected from the user Kermit when Kermit-32 is processing a command in server mode.)SH ES %%Page: 221 222 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (11.4.3. Commands for Local File Management)SH 10 /Times-Italic AF 51275 XM (Page 221)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (COPY)SH /Times-Italic SF 11197 XM (filespec)SH /Times-Roman SF 16280 XM (Make a copy of the given file \050or files\051. Kermit-32 will prompt for the new file) 85 W( specification.)86 W 16280 8991 MT (The command) 91 W( is actually performed by using the DCL COPY command \050COPY/LOG)90 W /Times-Italic SF 52191 XM (old-file)SH 16280 10096 MT (new-file)SH /Times-Roman SF (\051, and any options which are valid on the DCL COPY command may be included.)SH 8280 11673 MT (CWD [)SH /Times-Italic SF (directory)SH /Times-Roman SF (])SH 16280 XM (Change working directory, or, in VAX/VMS terminology, change the) 86 W( default device/directory.)87 W 16280 12778 MT (This command takes the same arguments as the) 64 W( DCL SET DEFAULT command \050i.e., a device)63 W 16280 13883 MT (and directory, only a directory, or) 1 W( only a device\051. If no argument is given, the default device and)2 W 16280 14988 MT (directory are reset to that in effect when Kermit-32 was run.) 202 W( The) 653 W( new default device and)201 W 16280 16093 MT (directory will be typed out.)SH 8280 17670 MT (DELETE)SH /Times-Italic SF 12307 XM (filespec)SH /Times-Roman SF 16280 XM (Delete the specified file or files. This command is performed) 183 W( by using the DCL DELETE)184 W 16280 18775 MT (command \050DELETE/LOG)276 W /Times-Italic SF 27719 XM (filespec)SH /Times-Roman SF (\051. Therefore,) 802 W( any options which) 276 W( are valid on the DCL)275 W 16280 19880 MT (DELETE command may be included.)SH 8280 21457 MT (DIRECTORY [)SH /Times-Italic SF (filespec)SH /Times-Roman SF (])SH 16280 22562 MT (Provide a directory listing of the specified files. This command) 35 W( is performed by using the DCL)34 W 16280 23667 MT (DIRECTORY command \050DIRECTORY)153 W /Times-Italic SF 33211 XM (filespec)SH /Times-Roman SF (\051, so any options valid for the DCL DIREC-)154 W 16280 24772 MT (TORY command may be included.)SH 8280 26349 MT (DISK_USAGE [)SH /Times-Italic SF (uic)SH /Times-Roman SF (])SH 16280 27454 MT (Display disk usage information for the given UIC.) 192 W( If) 636 W( no UIC is given, display disk usage)193 W 16280 28559 MT (information for the process UIC. This command is performed by using the DCL SHOW)238 W 16280 29664 MT (QUOTA command \050SHOW QUOTA or SHOW QUOTA/USER=)SH /Times-Italic SF (uic)SH /Times-Roman SF (\051.)SH 8280 31241 MT (HELP)SH 16280 XM (Display the help message describing the server commands which are available.)SH 8280 32818 MT (HOST)SH /Times-Italic SF 11141 XM (DCL command)SH /Times-Roman SF 16280 33923 MT (Perform the given DCL command. The command should not perform any action) 131 W( which will)130 W 16280 35028 MT (require more input. Any output resulting from the command will be typed on the terminal.)SH 8280 36605 MT (RENAME)SH /Times-Italic SF 12752 XM (filespec)SH /Times-Roman SF 16280 XM (Change the name of the specified file.) 4 W( Kermit-32) 260 W( will prompt for the new name on the next line.)5 W 16280 37710 MT (This command is performed by using the DCL RENAME command) 106 W( \050RENAME/LOG)105 W /Times-Italic SF 52191 XM (old-file)SH 16280 38815 MT (new-file)SH /Times-Roman SF (\051, so any options which are valid on the DCL RENAME command may be included.)SH 8280 40392 MT (SEND_MESSAGE)SH /Times-Italic SF 16308 XM (terminal-name)SH /Times-Roman SF 16280 41497 MT (Send a single line message to the given) 25 W( terminal. Kermit-32 will prompt for the message on the)24 W 16280 42602 MT (next line. Since this command is performed using the DCL REPLY command)SH /Courier SF 18680 44317 MT (REPLY/TERMINAL=)SH /Times-Italic SF (terminal-name)SH /Courier SF 34168 XM (")SH /Times-Italic SF (message)SH /Courier SF (")SH /Times-Roman SF 16280 46034 MT (OPER privileges are needed to perform it.)SH 8280 47611 MT (TYPE)SH /Times-Italic SF 11030 XM (filespec)SH /Times-Roman SF 16280 XM (Display the contents) 27 W( of the specified file or files at your terminal. Each file will be preceded by)28 W 16280 48716 MT (its name in angle brackets.)SH 12 /Times-Bold AF 8280 51832 MT (11.4.4. The CONNECT Command)SH 10 /Times-Roman AF 8280 53774 MT (Syntax:)SH /Courier SF 11586 XM (CONNECT [)SH /Times-Italic SF (terminal-name)SH /Courier SF (])SH /Times-Roman SF 8280 56166 MT (Establish a terminal connection to the system connected to the terminal line specified here or) 12 W( in the most recent SET)11 W 8280 57362 MT (LINE command, using full duplex echoing and no parity) 118 W( unless otherwise specified in previous SET commands.)119 W 8280 58558 MT (Get back to) 346 W( Kermit-32 by typing the escape character followed by the letter C. The escape character is)345 W 8280 59754 MT (Control-Close-Square-Bracket \050)254 W /Courier SF (^])SH /Times-Roman SF (\051 by) 254 W( default. When you type the escape character, several single-character)255 W 8280 60950 MT (commands are possible:)SH /Courier SF 9280 62741 MT (C)SH /Times-Roman SF 11280 XM (Close the connection and return to Kermit-32.)SH /Courier SF 9280 63846 MT (Q)SH /Times-Roman SF 11280 XM (If a session log is active, temporarily Quit logging.)SH /Courier SF 9280 64951 MT (R)SH /Times-Roman SF 11280 XM (Resume logging to the session log.)SH /Courier SF 9280 66056 MT (S)SH /Times-Roman SF 11280 XM (Show status of the connection.)SH /Courier SF 9280 67161 MT (0)SH /Times-Roman SF 11280 XM (Send a null character.)SH /Courier SF 9280 68266 MT (?)SH /Times-Roman SF 11280 XM (List all the possible single-character arguments.)SH /Courier SF 9280 69371 MT (^])SH /Times-Roman SF 10730 XM (\050or whatever you have set the escape character to be\051:)SH 11280 70476 MT (Typing the escape character twice sends one copy of it to the connected host.)SH ES %%Page: 222 223 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 222)SH 12 /Times-Bold AF 27354 XM (Kermit User Guide: VAX/VMS KERMIT \05011.4.4\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (You can use the SET ESCAPE command to define) 199 W( a different escape character, and SET PARITY, and SET)200 W 6120 9082 MT (LOCAL_ECHO to change those communication-line-oriented parameters.) 135 W( Type) 519 W( the SHOW LINE command for)134 W 6120 10278 MT (information about your current communication settings.)SH 6120 12670 MT (Kermit-32 does not have) 18 W( any special autodialer interface. It assumes that the connection has already been made and)19 W 6120 13866 MT (the line assigned.)SH 12 /Times-Bold AF 6120 16982 MT (11.4.5. The SET and SHOW Commands)SH 13 SS 23957 20341 MT (The SET Command)SH 10 /Times-Roman AF 6120 22714 MT (Syntax:)SH /Courier SF 9426 XM (SET)SH /Times-Italic SF 11826 XM (parameter)SH /Courier SF 16592 XM ([)SH /Times-Italic SF (option)SH /Courier SF 20348 XM ([)SH /Times-Italic SF (value)SH /Courier SF (]])SH /Times-Roman SF 6120 25106 MT (Establish or modify various parameters for file transfer or terminal connection.) 48 W( You) 344 W( can examine their values with)47 W 6120 26302 MT (the SHOW command. The following parameters may be SET:)SH 13242 27912 MT (BLOCK_CHECK)SH 21020 XM (Packet transmission error detection method)SH 14577 29017 MT (DEBUGGING)SH 21020 XM (Record or display state transitions or packets)SH 17132 30122 MT (DELAY)SH 21020 XM (How long to wait before starting to send)SH 16797 31227 MT (ESCAPE)SH 21020 XM (Character for terminal connection)SH 18409 32332 MT (FILE)SH 21020 XM (For setting file parameters like file type)SH 14299 33437 MT (HANDSHAKE)SH 21020 XM (For establishing half duplex line turnaround handshake)SH 15187 34542 MT (IBM_MODE)SH 21020 XM (For communicating with an IBM mainframe)SH 11576 35647 MT (INCOMPLETE_FILE)SH 21020 XM (What to do with an incomplete file)SH 18243 36752 MT (LINE)SH 21020 XM (Terminal line to use for file transfer or CONNECT)SH 13965 37857 MT (LOCAL_ECHO)SH 21020 XM (For terminal connection, ON or OFF)SH 15853 38962 MT (MESSAGE)SH 21020 XM (The type of typeout to be done during transfers)SH 16909 40067 MT (PARITY)SH 21020 XM (Character parity to use)SH 16519 41172 MT (PROMPT)SH 21020 XM (Change the program's command prompt)SH 16298 42277 MT (RECEIVE)SH 21020 XM (Various parameters for receiving files)SH 12854 43382 MT (REPEAT_QUOTE)SH 20770 XM (Character to use for repeat compression)SH 17242 44487 MT (RETRY)SH 21020 XM (How many times to retry a packet before giving up)SH 17909 45592 MT (SEND)SH 21020 XM (Various parameters for sending files)SH 15409 46697 MT (TRANSMIT)SH 21020 XM (Control TRANSMIT command echo and delay)SH 6120 49089 MT (Those SET commands which differ from the "ideal" Kermit are now described in detail.)SH 12 /Times-Bold AF 6120 51677 MT (SET DEBUGGING)SH 10 /Times-Roman AF 6120 53091 MT (Syntax:)SH /Courier SF 9426 XM (SET DEBUGGING)SH /Times-Italic SF 17826 XM (options)SH /Times-Roman SF 6120 55483 MT (Record the packet traffic, either on your terminal or in a file. Some reasons for doing this would be to debug a)115 W 6120 56679 MT (version of Kermit that) 105 W( you are working on, to record a transaction in which an error occurred for evidence when)104 W 6120 57875 MT (reporting bugs, or simply to vary the display you get when running Kermit-32 in local mode. Options are:)SH 6120 59666 MT (ON)SH 14120 XM (Display each incoming and outgoing packet \050lengthy\051.)SH 6120 61243 MT (OFF)SH 14120 XM (Don't display or record debugging) 64 W( information \050this is the normal mode\051. If debugging was in)65 W 14120 62348 MT (effect, turn it off.)SH 6120 64139 MT (The debugging information is recorded in the file specified by the most recent LOG DEBUGGING command.)SH ES %%Page: 223 224 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (11.4.5. The SET and SHOW Commands)SH 10 /Times-Italic AF 51275 XM (Page 223)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (SET ESCAPE)SH 10 /Courier AF 8280 9416 MT (SET ESCAPE)SH /Times-Italic SF 14880 XM (octal-number)SH /Times-Roman SF 8280 11808 MT (Specify the control character you want to use to) 45 W( "escape" from remote connections back to Kermit-32. The default)44 W 8280 13004 MT (is 35) 68 W( \050Control-]\051. The number is the octal value of the ASCII control character, 1 to 37 \050or 177\051, for instance 2 is)69 W 8280 14200 MT (Control-B. After) 466 W( you type the escape character, you must follow it by) 108 W( a one of the single-character "arguments")107 W 8280 15396 MT (described under the CONNECT command, above.)SH 12 /Times-Bold AF 8280 17984 MT (SET FILE)SH 10 /Times-Roman AF 8280 19398 MT (Syntax:)SH /Courier SF 11586 XM (SET FILE)SH /Times-Italic SF 16986 XM (parameter keyword)SH /Times-Roman SF 8280 21790 MT (Establish file-related parameters:)SH 8280 23581 MT (TYPE)SH /Times-Italic SF 11030 XM (keyword)SH /Times-Roman SF 12280 24686 MT (Type of file for VAX/VMS file output. The choices are ASCII, BINARY, or FIXED.)SH 12280 26477 MT (ASCII)SH 16280 XM (Store the file as a standard VAX/VMS text) 84 W( file. Any file received is stored as variable length)83 W 16280 27582 MT (records with carriage return, line feed sequences implied between) 109 W( records. This is the format)110 W 16280 28687 MT (preferred by most utility) 105 W( programs under VAX/VMS. An error will occur if any line is more)104 W 16280 29792 MT (than 4096 characters long. Note that) 170 W( lines are only terminated by carriage return, line feed)171 W 16280 30897 MT (sequences. A) 652 W( carriage return that is not followed) 201 W( by a line feed or a line feed that is not)200 W 16280 32002 MT (preceded by a carriage return is not) 18 W( considered the end of a line, and is included within the body)19 W 16280 33107 MT (of a record.)SH 12280 34684 MT (BINARY)SH 16280 XM (Store the file as a binary file. Any file received is stored as variable length) 133 W( records with no)132 W 16280 35789 MT (record attributes. Kermit-32 actually will) 81 W( write 510 bytes in each record except the last. This)82 W 16280 36894 MT (makes each record take up one disk block \050510 data bytes plus two bytes of record) 25 W( length\051. The)24 W 16280 37999 MT (last record is written containing only as much data is) 6 W( left to the end of the file. Any file which is)7 W 16280 39104 MT (just a stream of bytes can be stored as a BINARY file, and recovered) 94 W( intact later. This is the)93 W 16280 40209 MT (preferred file type for use in archiving files.)SH 12280 41786 MT (FIXED)SH 16280 XM (Store the file as) 65 W( a fixed length binary file. Any file received is stored as fixed length 512 byte)66 W 16280 42891 MT (records with no record) 105 W( attributes. This is the format used for binary files such as VAX/VMS)104 W 16280 43996 MT ("EXE" files and RSX-11M/M+ "TSK" files. Since even the last record) 6 W( of the file is written with)7 W 16280 45101 MT (512 bytes \050even if it is not filled\051, this) 25 W( format does not necessarily maintain the correct length of)24 W 16280 46206 MT (a file.) 102 W( It) 455 W( should normally only be used for files which are coming from a VAX/VMS system)103 W 16280 47311 MT (which are currently stored in fixed 512 byte records.)SH 8280 49102 MT (NAMING)SH /Times-Italic SF 12640 XM (keyword)SH /Times-Roman SF 12280 50207 MT (Determine the form of names to be sent with outgoing files and determine the translation performed on)99 W 12280 51312 MT (incoming file names. The choices are FULL, NORMAL_FORM and UNTRANSLATED.)SH 12280 53103 MT (FULL)SH 16280 XM (Kermit-32 will send full file names \050including device, directory, file name, file) 32 W( type and version)31 W 16280 54208 MT (number\051. When) 354 W( receiving a file, Kermit-32 will perform no translation of the file name \050which)52 W 16280 55313 MT (must therefore be a legal VAX/VMS file specification\051.)SH 12280 56890 MT (NORMAL_FORM)SH 16280 57995 MT (Kermit-32 will send only the file name and file type. When receiving) 159 W( a file, Kermit-32 will)160 W 16280 59100 MT (convert the file specification received to contain only) 74 W( uppercase letters, digits, and at most one)73 W 16280 60205 MT (period. Any) 274 W( other characters will be translated) 12 W( to ")13 W /Courier SF (X)SH /Times-Roman SF (". There) 276 W( will be at most 9 characters before)13 W 16280 61310 MT (the period \050if any\051, and at most 3 characters afterwards. This forces the file name) 56 W( to be a valid)55 W 16280 62415 MT (VAX/VMS 3.x file specification. This is the default.)SH 12280 63992 MT (UNTRANSLATED)SH 16280 65097 MT (Kermit-32 will send only the file name and file type. When receiving a file,) 54 W( Kermit-32 will not)53 W 16280 66202 MT (perform any conversions on the file specification, which therefore must) 96 W( be a legal VAX/VMS)97 W 16280 67307 MT (file specification. If you want to receive files) 16 W( with long names, use this option. To transfer files)15 W 16280 68412 MT (with VAX/VMS long names between two VMS 4.0-or-later) 136 W( systems, use this option on both)137 W 16280 69517 MT (sides.)SH ES %%Page: 224 225 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 224)SH 12 /Times-Bold AF 27354 XM (Kermit User Guide: VAX/VMS KERMIT \05011.4.5\051)SH 46800 50 6120 5709 UL 6120 8004 MT (SET HANDSHAKE)SH 10 /Times-Roman AF 6120 9418 MT (Syntax:)SH /Courier SF 9426 XM (SET HANDSHAKE)SH /Times-Italic SF 17826 XM (o)SH /Times-Roman SF 6120 11810 MT (Sets the) 66 W( half duplex line turnaround handshake character to the ASCII character whose octal value is)65 W /Times-Italic SF 47707 XM (o)SH /Times-Roman SF (. Normally)380 W 6120 13006 MT (required for communication with half duplex systems like IBM mainframes.)SH 12 /Times-Bold AF 6120 15594 MT (SET IBM_MODE)SH 10 /Times-Roman AF 6120 17008 MT (Syntax:)SH /Courier SF 9426 XM (SET IBM_MODE ON)SH /Times-Italic SF 19026 XM (or)SH /Courier SF 20515 XM (OFF)SH /Times-Roman SF 6120 19400 MT (When IBM_MODE is set to ON, Kermit-32 will override) 17 W( the parity and local echo settings and use odd parity, local)18 W 6120 20596 MT (echo on, and also enable a handshake character of XON \050control-Q, ASCII 021 octal\051.) 244 W( This) 737 W( feature allows)243 W 6120 21792 MT (Kermit-32 to talk with certain systems \050notably some IBM mainframes\051,) 90 W( which require waiting for a XON before)91 W 6120 22988 MT (sending data.)SH 6120 25380 MT (The various features selected by this command can be overridden subsequently by) 409 W( SET PARITY, SET)408 W 6120 26576 MT (LOCAL_ECHO, and SET HANDSHAKE commands.)SH 12 /Times-Bold AF 6120 29164 MT (SET LINE)SH 10 /Times-Roman AF 6120 30578 MT (Syntax:)SH /Courier SF 9426 XM (SET LINE [)SH /Times-Italic SF (terminal-name)SH /Courier SF (])SH /Times-Roman SF 6120 32970 MT (Specify the terminal name to use for file transfer or CONNECT; the)25 W /Times-Italic SF 33915 XM (terminal-name)SH /Times-Roman SF 40078 XM (can be up to 16 characters) 25 W( long.)26 W 6120 34166 MT (If you issue this command using other than your job's controlling terminal,) 59 W( you will be running Kermit-32)58 W /Times-Italic SF 49948 XM (locally)SH /Times-Roman SF (,)SH 6120 35362 MT (and you must log in to the remote system and run Kermit on that side in order to transfer a file.) 52 W( If) 356 W( you don't issue)53 W 6120 36558 MT (this command, Kermit-32) 4 W( determines whether it is to run locally or)3 W /Times-Italic SF 33208 XM (remotely)SH /Times-Roman SF 36960 XM (based on the default terminal line found)3 W 6120 37754 MT (when Kermit-32 is started. Kermit-32 uses a list of logical names to determine which terminal should be) 16 W( the default)17 W 6120 38950 MT (terminal line. The first of these names) 41 W( which translates to a terminal which is available \050i.e., not allocated by some)40 W 6120 40146 MT (other process\051 is used. The logical names Kermit-32 tries are KER$COMM,) 93 W( SYS$INPUT, SYS$$OUTPUT, and)94 W 6120 41342 MT (SYS$COMMAND. If) 674 W( none of these translate to an available terminal, Kermit-32 is running)212 W /Times-Italic SF 46250 XM (detached)SH /Times-Roman SF (, and a)211 W 6120 42538 MT (terminal must be specified by) 23 W( the SET LINE command before any actions can be performed. If a terminal is found,)24 W 6120 43734 MT (Kermit-32 is running) 257 W( locally if this is a terminal other than the one controlling the job \050i.e., different from)256 W 6120 44930 MT (SYS$COMMAND\051, otherwise Kermit-32 is running remotely. You) 292 W( can also select the line directly in the)293 W 6120 46126 MT (CONNECT command; the command)SH /Courier SF 8520 47781 MT (CONNECT TTA0)SH /Times-Roman SF 6120 49498 MT (is equivalent to)SH /Courier SF 8520 51153 MT (SET LINE TTA0)SH 8520 52184 MT (CONNECT)SH /Times-Roman SF 6120 54576 MT (If you type SET LINE with no argument, you will deassign any previous assigned line and revert to remote mode.)SH 12 /Times-Bold AF 6120 57164 MT (SET SERVER_TIMEOUT)SH 10 /Times-Roman AF 6120 58578 MT (Syntax: SET SERVER_TIMEOUT)SH /Times-Italic SF 20537 XM (number)SH /Times-Roman SF 6120 60970 MT (This specifies the number of) 98 W( seconds between timeouts during server command wait, 0 specifies that no timeouts)97 W 6120 62166 MT (should occur during server command wait. When a Kermit server times out, it sends) 22 W( a NAK packet. Some systems)23 W 6120 63362 MT (cannot clear piled-up NAKs from their input buffers; if you're using such a) 252 W( system to communicate with a)251 W 6120 64558 MT (Kermit-32 server, and you expect to be leaving the server idle for) 216 W( long periods of time, you should use this)217 W 6120 65754 MT (command to turn off server command-wait timeouts.)SH ES %%Page: 225 226 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (11.4.5. The SET and SHOW Commands)SH 10 /Times-Italic AF 51275 XM (Page 225)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (SET TRANSMIT)SH 10 /Times-Roman AF 8280 9418 MT (Syntax: SET TRANSMIT DELAY)SH /Times-Italic SF 22613 XM (integer)SH /Times-Roman SF (, SET TRANSMIT ECHO ON/OFF)SH 8280 11810 MT (It is possible to set a few parameters associated with the raw TRANSMIT command that) 91 W( vary both what the user)90 W 8280 13006 MT (sees on the screen as well as the speed of the transmit.)SH 8280 15398 MT (SET TRANSMIT DELAY)SH 8280 17790 MT (This parameter is the amount of time to delay after each carriage return is transmitted. Valid delay values) 104 W( range)105 W 8280 18986 MT (between 0 \050the default\051 and) 137 W( 9 tenths of a second. The format of the command is: SET TRANSMIT DELAY)136 W /Times-Italic SF 54580 XM (d)SH /Times-Roman SF 8280 20182 MT (Where)SH /Times-Italic SF 11195 XM (d)SH /Times-Roman SF 11945 XM (is a single decimal digit representing tenths of a second.)SH 8280 22574 MT (Some remote hosts may not be able to receive the characters as fast as Kermit-32) 36 W( can send them. The TRANSMIT)37 W 8280 23770 MT (DELAY can be used to slow up the transfer by adding a slight delay after each line is sent.)SH 8280 26162 MT (The transfer also runs slower if the transmit echo is on, and) 2 W( the remote system is echoing the characters as it receives)1 W 8280 27358 MT (them. If) 310 W( the transmit delay is set to 9 tenths of a second, the) 30 W( remote system is echoing characters, the transmit echo)31 W 8280 28554 MT (is on, and the remote system still cannot keep up, then the connection should be made at a slower baud rate.)SH 8280 30946 MT (Conversely, the file transfer speed can be increased by: setting the delay to 0 and the echo) 49 W( off, stopping the remote)48 W 8280 32142 MT (system from echoing the characters it receives, and connecting at higher baud rates.)SH 8280 34534 MT (SET TRANSMIT ECHO)SH 8280 36926 MT (This command controls what the user sees on the screen during the file transfer.) 9 W( The) 270 W( format of the command is SET)10 W 8280 38122 MT (TRANSMIT ECHO ON or OFF.)SH 8280 40514 MT (By default, the transmit echo is left off and the user sees the number of each line after it has been) 22 W( transmitted. With)21 W 8280 41710 MT (transmit echo on, the user sees whatever the remote system) 14 W( would normally echo back to him while he is typing in a)15 W 8280 42906 MT (file. Note) 250 W( that turning the echo on typically slows the file transfer down.)SH 13 /Times-Bold AF 25323 46265 MT (The SHOW Command)SH 10 /Times-Roman AF 8280 48638 MT (Syntax:)SH /Courier SF 11586 XM (SHOW)SH /Times-Roman SF 14236 XM ([)SH /Times-Italic SF (option)SH /Times-Roman SF (])SH 8280 51030 MT (The SHOW command displays various information:)SH 8280 52821 MT (ALL)SH 16280 XM (All parameters.)SH 8280 54479 MT (BLOCK_CHECK_TYPE)SH 16280 55584 MT (The block check type being requested.)SH 8280 57242 MT (COMMUNICATIONS)SH 16280 58347 MT (Parameters affecting the terminal line being used for communication.)SH 8280 60005 MT (DEBUGGING)SH 16280 XM (Debugging mode in effect, if any.)SH 8280 61663 MT (DELAY)SH 16280 XM (The number of) 112 W( seconds Kermit-32 will delay before starting a SEND or RECEIVE command)111 W 16280 62768 MT (when in remote mode.)SH 8280 64426 MT (ESCAPE)SH 16280 XM (The current escape character for the CONNECT processing.)SH 8280 66084 MT (FILE_PARAMETERS)SH 16280 67189 MT (File type, file naming, and incomplete file disposition.)SH 8280 68847 MT (INCOMPLETE_FILE_DISPOSITION)SH 16280 69952 MT (The action to take when a transfer is aborted.)SH 8280 71610 MT (LINE)SH 16280 XM (Terminal line in use.)SH ES %%Page: 226 227 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 226)SH 12 /Times-Bold AF 27354 XM (Kermit User Guide: VAX/VMS KERMIT \05011.4.5\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (LOCAL_ECHO)SH 14120 XM (Whether characters should be echoed locally when CONNECTed.)SH 6120 9544 MT (PACKET)SH 14120 XM (For incoming and outbound packets.)SH 6120 11202 MT (PARITY)SH 14120 XM (The parity type in use.)SH 6120 12860 MT (RECEIVE)SH 14120 XM (For inbound packets.)SH 6120 14518 MT (RETRY)SH 14120 XM (The number of retries to be done on bad packets.)SH 6120 16176 MT (SEND)SH 14120 XM (For outbound packets.)SH 6120 17834 MT (TRANSMIT)SH 14120 XM (Parameters for TRANSMIT command.)SH 6120 19492 MT (VERSION)SH 14120 XM (The program version number of Kermit-32.)SH 12 /Times-Bold AF 6120 22608 MT (11.4.6. Program Management Commands)SH 13 SS 23416 25967 MT (The HELP Command)SH 10 /Times-Roman AF 6120 28340 MT (Syntax:)SH /Courier SF 9426 XM (HELP [)SH /Times-Italic SF (topic)SH /Courier SF 15626 XM ({)SH /Times-Italic SF (subtopic)SH /Courier SF (}])SH /Times-Roman SF 6120 30732 MT (Typing HELP alone prints a brief summary of Kermit-20 and its commands. You can also type)SH /Courier SF 8520 32447 MT (HELP)SH /Times-Italic SF 11520 XM (command)SH /Times-Roman SF 6120 34164 MT (for any Kermit-20 command, e.g. "help send" or "help set) 54 W( parity" to get more detailed information about a specific)55 W 6120 35360 MT (command.)SH 13 /Times-Bold AF 20309 38719 MT (The EXIT and QUIT Commands)SH 10 /Times-Roman AF 6120 41092 MT (Syntax:)SH /Courier SF 9426 XM (EXIT)SH /Times-Roman SF 6120 43484 MT (Exit from Kermit-32. You can also exit from the Kermit-32 when it is waiting for a command by typing a control-Z.)SH 6120 44680 MT (When Kermit-32 is running remotely, two control-Y's will abort the) 33 W( transfer, bringing Kermit-32 back to command)34 W 6120 45876 MT (mode. The) 318 W( two) 34 W( control-Y's must be typed together, as if a timeout occurs between them the first is ignored. When)33 W 6120 47072 MT (Kermit-32 is running locally, two control-Y's will stop Kermit-32 and return you to DCL.) 137 W( You) 526 W( will be able to)138 W 6120 48268 MT (CONTINUE if you do not perform any command which runs a program. However, after continuing,) 127 W( control-A,)126 W 6120 49464 MT (control-X and control-Z will no longer be accepted as commands.)SH /Courier SF 6120 51856 MT (QUIT)SH /Times-Roman SF 8770 XM (is a synonym for EXIT.)SH 13 /Times-Bold AF 23741 55215 MT (The LOG Command)SH 10 /Times-Roman AF 6120 57588 MT (Syntax:)SH /Courier SF 9426 XM (LOG)SH /Times-Roman SF 11476 XM ([)SH /Times-Italic SF (option)SH /Times-Roman SF 14615 XM ([)SH /Times-Italic SF (filespec)SH /Times-Roman SF (]])SH 6120 59980 MT (Log the specified option to the specified file:)SH 6120 61771 MT (SESSION)SH 14120 XM (During CONNECT log all characters that appear on the) 146 W( screen to the specified file. During)147 W 14120 62876 MT (CONNECT, the session log) 84 W( can be temporarily turned off during the remote session by typing)83 W 14120 63981 MT (the escape character followed by Q \050for Quit logging\051, and turned on again by typing the escape)28 W 14120 65086 MT (character followed by R \050for Resume logging\051.)SH 6120 66663 MT (TRANSACTIONS)SH 14120 XM (During file) 27 W( transfer, log the progress of each file. Transaction logging is recommended for long)26 W 14120 67768 MT (or unattended file transfers, so that you don't have to watch the screen. The log may) 219 W( be)220 W 14120 68873 MT (inspected after the transfer is complete to see what files were transferred and what errors may)93 W 14120 69978 MT (have occurred.)SH 6120 71555 MT (DEBUGGING)SH 14120 XM (Log debugging info to the specified file. If no SET DEBUGGING command was) 111 W( previously)112 W ES %%Page: 227 228 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (11.4.6. Program Management Commands)SH 10 /Times-Italic AF 51275 XM (Page 227)SH 46800 50 8280 5709 UL /Times-Roman SF 16280 7886 MT (issued, the) 27 W( file will be opened and no information written. If DEBUGGING is turned on \050either)26 W 16280 8991 MT (via the SET DEBUGGING command) 55 W( or by typed control-D during a local transfer\051, the packet)56 W 16280 10096 MT (debugging information) 173 W( will be written to the file. Packet format is described in the)172 W /Times-Italic SF 52302 XM (Kermit)SH 16280 11201 MT (Protocol Manual)SH /Times-Roman SF (.)SH 8280 13593 MT (Any log files are closed when you EXIT or QUIT from Kermit. You may explicitly) 62 W( close a log file and terminate)63 W 8280 14789 MT (logging by using the LOG command without a file specification.)SH 13 /Times-Bold AF 24817 18148 MT (The STATUS Command)SH 10 /Times-Roman AF 8280 20521 MT (Syntax:)SH /Courier SF 11586 XM (STATUS)SH /Times-Roman SF 8280 22913 MT (The current) 64 W( status of Kermit-32 will be displayed. This includes the number of characters that have been sent and)63 W 8280 24109 MT (received from the remote Kermit. Also included is an estimate of the effective baud rate of the transfer. This) 9 W( number)10 W 8280 25305 MT (is not intended to be exact, but only an indication of what range of throughput has been provided.)SH 14 /Times-Bold AF 8280 28907 MT (11.5. Raw Upload and Download)SH 13 SS 23842 32266 MT (The TRANSMIT Command)SH 10 /Times-Roman AF 8280 34639 MT (Syntax:)SH /Courier SF 11586 XM (TRANSMIT)SH /Times-Italic SF 16986 XM (file-spec)SH /Times-Roman SF 8280 37031 MT (The TRANSMIT command allows you to upload files "raw" to systems that don't have a Kermit program available.)19 W 8280 38227 MT (Note that there is no error checking or packets involved in this method of file transfer.)SH 8280 40619 MT (This command does a raw transmit of an ASCII file, one character at a time, with) 32 W( carriage returns \050no line-feeds\051 at)33 W 8280 41815 MT (the end of each line.) 16 W( It) 280 W( is used with Kermit-32 in local mode. The user must first prepare the remote host to receive)15 W 8280 43011 MT (the file by) 183 W( starting an edit session in input mode. Then the user can escape back to Kermit-32 and issue the)184 W 8280 44207 MT (TRANSMIT command. After the transmit is finished,) 33 W( the user then CONNECTs back to the remote host again and)32 W 8280 45403 MT (ends the edit session.)SH 8280 47795 MT (During a file transmit, the following control characters can be used to affect the transfer in progress:)SH 8280 49586 MT (CTRL-C)SH 16280 XM (Abort the transmit)SH 8280 51163 MT (CTRL-X)SH 16280 XM (Abort the file currently being transmitted)SH 8280 52740 MT (CTRL-Z)SH 16280 XM (Abort the file group currently being transmitted)SH 8280 55132 MT (See SET TRANSMIT for information about controlling echo and delays.)SH 13 /Times-Bold AF 22993 58491 MT (The LOG SESSION Command)SH 10 /Times-Roman AF 8280 60864 MT (Syntax:)SH /Courier SF 11586 XM (LOG SESSION)SH /Times-Italic SF 18786 XM (file-spec)SH /Times-Roman SF 8280 63256 MT ("Raw Download" is the term commonly used to describe the capture of) 78 W( a remote file on the local system, without)79 W 8280 64452 MT (any kind of error detection or correction. This allows you to obtain files from remote systems) 128 W( that do not have)127 W 8280 65648 MT (Kermit, but with the risk of loss or corruption of data.)SH 8280 68040 MT (Kermit-32 provides raw downloading via the LOG SESSION command during) 3 W( CONNECT to a remote system. The)4 W 8280 69236 MT (session log is described above. To use session logging to capture a file:)SH 10280 71027 MT (1.)SH 11280 XM (Run Kermit on the VAX/VMS system.)SH ES %%Page: 228 229 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 228)SH 12 /Times-Bold AF 28254 XM (Kermit User Guide: VAX/VMS KERMIT \05011.5\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 8120 7886 MT (2.)SH 9120 XM (SET LINE to the terminal line through which you will be connected to the remote system.)SH 8120 10096 MT (3.)SH 9120 XM (Perform any required SET commands to condition Kermit for communication with the remote system.)SH 8120 12306 MT (4.)SH 9120 XM (CONNECT to the remote system and log in.)SH 8120 14516 MT (5.)SH 9120 XM (Condition your job on the remote system not to pause at the end of a screenful of text, and give)171 W 9120 15621 MT (whatever commands may be necessary to achieve a "clean" terminal) 144 W( listing -- for instance, disable)145 W 9120 16726 MT (messages from the system or other users.)SH 8120 18936 MT (6.)SH 9120 XM (Type the appropriate) 81 W( command to have the desired file displayed at the terminal,)80 W /Times-Italic SF 42656 XM (but do not type the)80 W 9120 20041 MT (terminating carriage return)SH /Times-Roman SF (. On) 250 W( most systems, the command would be "type", on Unix it's "cat".)SH 8120 22251 MT (7.)SH 9120 XM (Escape back to Kermit-32) 3 W( and give the LOG SESSION command with the file specification where you)4 W 9120 23356 MT (wish to store the data.)SH 8120 25566 MT (8.)SH 9120 XM (CONNECT back to the remote system and type a carriage return. The file will be) 62 W( displayed on your)61 W 9120 26671 MT (screen and recorded in the session log file.)SH 8120 28881 MT (9.)SH 9120 XM (Escape back to Kermit-32 and give the LOG SESSION command without a file specification.)SH 6120 30672 MT (The file you specified will contain everything that was typed on your screen.) 121 W( You) 494 W( will probably find that some)122 W 6120 31868 MT (editing necessary to remove extraneous prompts, messages, padding characters, or terminal escape sequences, or to)50 W 6120 33064 MT (fill in lost or garbled characters.)SH 6120 35456 MT (Use the TRANSMIT command for raw uploading.)SH 14 /Times-Bold AF 6120 39058 MT (11.6. Installation of Kermit-32)SH 10 /Times-Roman AF 6120 41176 MT (VMS Kermit-32 comes in 3 forms: hex, Macro source, and Bliss source.) 208 W( Each) 668 W( can be used as the basis for)209 W 6120 42372 MT (installation.)SH 6120 44764 MT (Before beginning, make a special directory for VMS Kermit and read the) 6 W( files)5 W /Courier SF 37689 XM (VMS*.*)SH /Times-Roman SF 41544 XM (from the Kermit distribution)5 W 6120 45960 MT (tape into this directory. Columbia's Ker- mit tapes) 23 W( are written with blocksize 8192, which is 4 times larger than the)24 W 6120 47156 MT (default tape blocksize for VMS. You should mount these tapes on the VMS system with the following command:)SH /Courier SF 8520 48811 MT (MOUNT/BLOCK=8192/DENSITY=1600 MTA0: KERMIT)SH /Times-Roman SF 6120 51203 MT (\050or substitute some other tape drive name for)6 W /Courier SF 24387 XM (MTA0:)SH /Times-Roman SF (\051 Do not use the)6 W /Courier SF 34055 XM (/FOREIGN)SH /Times-Roman SF 39111 XM (switch. Once) 262 W( the) 6 W( tape is mounted,)5 W 6120 52399 MT (you can use normal VMS COPY commands) 39 W( to copy the files from the tape. For instance, if you have defined your)40 W 6120 53595 MT (Kermit directory to have logical name KER:, you can) 2 W( use the following command to copy the VMS Kermit files into)1 W 6120 54791 MT (this directory:)SH /Courier SF 8520 56446 MT ($ copy mta0:vms*.* ker:)SH 12 /Times-Bold AF 6120 59034 MT (METHOD 1: DECODE THE HEX FILE)SH 10 /Times-Italic AF 6120 60448 MT (WARNING)SH /Times-Roman SF 10814 XM (-- If you are running a pre-4.0 release of VMS, see Method 1.5 below!)SH 6120 62840 MT (The easiest way to install VMS Kermit is to "dehexify" the hexadecimal encoded task image. Follow these steps:)SH 8120 64631 MT (1.)SH 9120 XM (There should be a file VMSDEH.MAR on your disk. This is a Macro-32 program that decodes) 98 W( the)99 W 9120 65736 MT (hex file of the VMS Kermit task image. Compile and load this program:)SH /Courier SF 11520 67391 MT ($ macro vmsdeh)SH 11520 68422 MT ($ link vmsdeh)SH /Times-Roman SF 8120 70632 MT (2.)SH 9120 XM (Run the VMSDEH program:)SH ES %%Page: 229 230 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (11.6. Installation of Kermit-32)SH 10 /Times-Italic AF 51275 XM (Page 229)SH 46800 50 8280 5709 UL /Courier SF 13680 7824 MT ($ run vmsdeh)SH 13680 8855 MT (Please type the file name: vmsmit.hex)SH /Times-Roman SF 11280 10572 MT (The VMSDEH program automatically creates KERMIT.EXE.)SH 10280 12782 MT (3.)SH 11280 XM (Now you can type "run kermit". Make sure it works. If not, try method 2.)SH 10280 14992 MT (4.)SH 11280 XM (Install KERMIT.EXE in the appropriate system area.)SH 10280 17202 MT (5.)SH 11280 XM (Install the help files, for instance:)SH /Courier SF 13680 18857 MT ($ LIBRARY/HELP/DELETE=KERMIT SYS$HELP:HELPLIB.HLB)SH 13680 19888 MT ($ LIBRARY/INSERT/HELP SYS$HELP:HELPLIB.HLB VMSSYS.HLP)SH 13680 20919 MT ($ LIBRARY/CREATE/HELP SYS$HELP:KERMIT.HLB VMSUSR.HLP)SH /Times-Roman SF 11280 22636 MT (See the file)SH /Courier SF 16029 XM (VMSINS.HLP)SH /Times-Roman SF 22279 XM (for further hints about the help files.)SH 8280 24427 MT (Note, the companion program to)68 W /Courier SF 21896 XM (VMSDEH.MAR)SH /Times-Roman SF 28214 XM (is)SH /Courier SF 29199 XM (VMSHEX.MAR)SH /Times-Roman SF (. It) 386 W( creates hex files from binary files. You) 68 W( can)67 W 8280 25623 MT (use this program to encode any VMS binary file into printable form, and VMSDEH to decode it back into its)171 W 8280 26819 MT (original form, with all of its directory information intact.)SH 12 /Times-Bold AF 8280 29407 MT (METHOD 1.5: DEHEXIFY THE OLD KERMIT-32 HEX FILE)SH 10 /Times-Roman AF 8280 30821 MT (If you are running a version of VMS before 4.0, then the current release of Kermit-32) 15 W( will not work on your system.)14 W 8280 32017 MT (If you tried Method 1, and the resulting Kermit program) 84 W( gave an error message like "invalid image header" when)85 W 8280 33213 MT (you tried to run it, this is probably) 131 W( the cause. In that case, you must use version 3.1 of VMS Kermit until you)130 W 8280 34409 MT (upgrade your VMS version. To use version 3.1 of VMS Kermit, follow the directions for Method) 184 W( 1, but use)185 W 8280 35605 MT (VMSDEH to dehexify the file)69 W /Courier SF 20929 XM (VMSV31.HEX)SH /Times-Roman SF 27248 XM (rather than)69 W /Courier SF 31939 XM (VMSMIT.HEX)SH /Times-Roman SF (. The) 386 W( result will be called)68 W /Courier SF 49080 XM (VMSMIT.EXE)SH /Times-Roman SF 8280 36801 MT (rather than)23 W /Courier SF 12880 XM (KERMIT.EXE)SH /Times-Roman SF (. You) 296 W( can rename this file to)23 W /Courier SF 30923 XM (KERMIT.EXE)SH /Times-Roman SF 37196 XM (and install it) 23 W( and the help files normally, but)24 W 8280 37997 MT (note that the help files apply to the newer releases.)SH 12 /Times-Bold AF 8280 40585 MT (METHOD 2: ASSEMBLE THE MACRO FILES)SH 10 /Times-Roman AF 8280 41999 MT (Only use this method if method) 49 W( 1 fails for some reason. This method assembles all the Macro-32 source programs)48 W 8280 43195 MT (into object files, and then links them together into)16 W /Courier SF 28590 XM (KERMIT.EXE)SH /Times-Roman SF (, and then installs)16 W /Courier SF 41904 XM (KERMIT.EXE)SH /Times-Roman SF 48170 XM (and the) 16 W( help files)17 W 8280 44391 MT (in the system. NOTE: Kermit-32 is NOT written in Macro-32; it is written in Bliss-32, and these Macro) 82 W( files are)81 W 8280 45587 MT (output by the Bliss compiler. It is not recommended that changes) 101 W( be made to the Macro source, except as noted)102 W 8280 46783 MT (below. To) 250 W( build from Macro, follow these steps:)SH 10280 48574 MT (1.)SH 11280 XM (Make sure you have all the VMS*.MAR files on your current disk and directory.)SH 10280 50784 MT (2.)SH 11280 XM (There is a DCL procedure to assemble and link all) 81 W( of these files, but for some reason it assumes the)80 W 11280 51889 MT (files are called)148 W /Courier SF 17805 XM (KER*.*)SH /Times-Roman SF 21803 XM (instead of)148 W /Courier SF 26265 XM (VMS*.*)SH /Times-Roman SF (. There) 547 W( is another DCL procedure,)149 W /Courier SF 45153 XM (VMSREN.COM)SH /Times-Roman SF (, to)149 W 11280 52994 MT (rename them:)SH /Courier SF 13680 54649 MT ($ @vmsren)SH /Times-Roman SF 10280 56859 MT (3.)SH 11280 XM (Now that the VMS Kermit files are renamed to)362 W /Courier SF 33618 XM (KER*.*)SH /Times-Roman SF (, you can run the DCL) 362 W( procedure)361 W 11280 57964 MT (VMSINS.COM to assemble and link them into KERMIT.EXE.)SH /Courier SF 13680 59619 MT ($ @vmsins)SH 13680 61274 MT (Kermit-32 Installation Procedure)SH 13680 62929 MT (Rebuild from sources? \050YES or NO\051 yes)SH 13680 64584 MT (Which version? \050BLISS or MACRO\051 macro)SH 13680 66239 MT (Install Kermit-32 on the system? yes)SH /Times-Italic SF 13680 67270 MT (\050note, you have to have write access to the system directories to do this\051)SH /Courier SF 13680 68925 MT (This may take some time)SH /Times-Italic SF 13680 69956 MT (\050time passes\051)SH /Courier SF 13680 71611 MT (Kermit-32 installation is complete.)SH ES %%Page: 230 231 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 230)SH 12 /Times-Bold AF 28254 XM (Kermit User Guide: VAX/VMS KERMIT \05011.6\051)SH 46800 50 6120 5709 UL 6120 8004 MT (METHOD 3: COMPILE THE BLISS SOURCES)SH 10 /Times-Roman AF 6120 9418 MT (You can use this) 66 W( method only if you have a Bliss-32 compiler. Even then, there's no reason to do this unless you)67 W 6120 10614 MT (want to change the sources) 58 W( in some way. Follow the steps in Method 2, except reply "bliss" instead of "macro" to)57 W 6120 11810 MT (the "Which version?" question.)SH 6120 14202 MT (FILES)SH 6120 16594 MT (Kermit-32 is built from a number of BLISS-32 sources and one MACRO-32 source.) 8 W( In) 267 W( order to make it possible for)9 W 6120 17790 MT (sites without BLISS-32 to build, MACRO-32 sources) 25 W( generated by BLISS-32 are also included for all of the BLISS)24 W 6120 18986 MT (modules. In) 326 W( the normal distribution of Kermit-32, all of the) 38 W( files start with the prefix "VMS". This will need to be)39 W 6120 20182 MT (changed to "KER" in order to build the program properly. The following files are distributed as part of Kermit-32:)SH /Courier SF 6120 21973 MT (VMSTT.BLI)SH /Times-Roman SF 14120 XM (Common BLISS source for the terminal text output support.)SH /Courier SF 6120 23550 MT (VMSGLB.BLI)SH /Times-Roman SF 14120 XM (Common BLISS source for the global storage for VMSMSG.BLI.)SH /Courier SF 6120 25127 MT (VMSMSG.BLI)SH /Times-Roman SF 14120 XM (Common BLISS source for the protocol handling module.)SH /Courier SF 6120 26704 MT (VMSCOM.REQ)SH /Times-Roman SF 14120 XM (Common BLISS require file which defines various common) 135 W( parameters. This is required by)134 W 14120 27809 MT (VMSMSG.BLI. This) 250 W( file must be renamed to KERCOM.REQ.)SH /Courier SF 6120 29386 MT (VMSMIT.BWR)SH /Times-Roman SF 14120 XM ("Beware File" for Kermit-32 \050read it!\051.)SH /Courier SF 6120 30963 MT (VMSMIT.BLI)SH /Times-Roman SF 14120 XM (BLISS-32 source for the command parser, and some basic support routines.)SH /Courier SF 6120 32540 MT (VMSFIL.BLI)SH /Times-Roman SF 14120 XM (BLISS-32 source for the file I/O.)SH /Courier SF 6120 34117 MT (VMSTRM.BLI)SH /Times-Roman SF 14120 XM (BLISS-32 source for) 75 W( the terminal processing. This handles the driving of the terminal line for)76 W 14120 35222 MT (the transfers and the connect command processing.)SH /Courier SF 6120 36799 MT (VMSSYS.BLI)SH /Times-Roman SF 14120 XM (System interface routines for the Kermit generic command processing.)SH /Courier SF 6120 38376 MT (VMSGEN.MAR)SH /Times-Roman SF 14120 XM (Macro-32 source file that contains the REMOTE command text that is given to VMS. Sites)135 W 14120 39481 MT (desiring to change what DCL commands are used to process the various) 312 W( generic server)313 W 14120 40586 MT (commands can make those changes in this source. This also contains the text) 205 W( of the help)204 W 14120 41691 MT (message returned in response to the server generic help command.)SH /Courier SF 6120 43268 MT (VMSERR.MSG)SH /Times-Roman SF 14120 XM (MESSAGE source for error messages used by VAX/VMS Kermit.)SH /Courier SF 6120 44845 MT (VMSERR.REQ)SH /Times-Roman SF 14120 XM (BLISS-32 require file which defines the error codes.) 178 W( This) 608 W( is REQUIREd by the BLISS-32)179 W 14120 45950 MT (sources.)SH /Courier SF 6120 47527 MT (VMSMIT.MSS)SH /Times-Roman SF 14120 XM (SCRIBE source file for VMSMIT.DOC \050this document\051.)SH /Courier SF 6120 49104 MT (VMSMIT.RNH)SH /Times-Roman SF 14120 XM (RUNOFF source for the help files for VAX/VMS Kermit. When this is run through) 61 W( RUNOFF)60 W 14120 50209 MT (with /VARIANT=SYSTEM, it) 46 W( produces a .HLP \050VMSSYS.HLP\051 file suitable for inserting into)47 W 14120 51314 MT (the system help library \050SYS$HELP:HELPLIB.HLB\051 to provide a KERMIT topic for the)275 W 14120 52419 MT (system HELP command. When run through RUNOFF without the /VARIANT=SYSTEM,) 130 W( it)131 W 14120 53524 MT (produces a .HLP file \050VMSUSR.HLP\051 to) 19 W( be stored on SYS$HELP: for use by the Kermit HELP)18 W 14120 54629 MT (command.)SH /Courier SF 6120 56206 MT (VMSSYS.HLP)SH /Times-Roman SF 14120 XM (RUNOFF output file for system wide Kermit HELP.)SH /Courier SF 6120 57783 MT (VMSUSR.HLP)SH /Times-Roman SF 14120 XM (RUNOFF output file for Kermit's HELP command.)SH /Courier SF 6120 59360 MT (VMSREN.COM)SH /Times-Roman SF 14120 XM (Command file to rename VMS*.* to KER*.*.)SH /Courier SF 6120 60937 MT (VMSINS.COM)SH /Times-Roman SF 14120 XM (Command file to build and install VAX/VMS Kermit.)SH /Courier SF 6120 62514 MT (VMSMIT.HEX)SH /Times-Roman SF 14120 XM (A hexified version) 22 W( of .EXE file for VMS Kermit. This file can be dehexified using the supplied)23 W 14120 63619 MT (program. In) 384 W( the hexified form, the file should be transferable over any) 67 W( medium which handles)66 W 14120 64724 MT (normal text. This is the most reliable copy of the executable version of VMS Kermit.)SH /Courier SF 6120 66301 MT (VMSHEX.MAR)SH /Times-Roman SF 14120 XM (Source for the hexification program. This is the program which) 345 W( was used to produce)346 W 14120 67406 MT (VMSMIT.HEX. It) 362 W( can also be used to produce hexified version of) 56 W( any \050or at least almost any\051)55 W 14120 68511 MT (Files-11 file. The dehexification program should then be) 220 W( able to reproduce a copy of the)221 W 14120 69616 MT (original file with the) 119 W( file parameters correctly set. Note that the format used for the hexified)118 W 14120 70721 MT (files is basically Intel) 107 W( hex format. There are some additional records used to store the record)108 W 14120 71826 MT (format, etc. Also, the file name as typed to the prompt from VMSHEX is stored in) 34 W( the hexified)33 W ES %%Page: 231 232 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (11.6. Installation of Kermit-32)SH 10 /Times-Italic AF 51275 XM (Page 231)SH 46800 50 8280 5709 UL /Times-Roman SF 16280 7886 MT (version of the file for use) 84 W( by the dehexification program. By doing this, it is possible to store)85 W 16280 8991 MT (more than one binary file with a single hexified file.)SH /Courier SF 8280 10568 MT (VMSDEH.MAR)SH /Times-Roman SF 16280 XM (Source for the dehexification program.)SH /Courier SF 8280 12145 MT (VMSV31.*)SH /Times-Roman SF 16280 XM (Version VMS Kermit, the last version that will run under release 3.x of VMS.) 23 W( Versions) 295 W( 3.2 and)22 W 16280 13250 MT (later require VMS release 4.0 or later.)SH /Courier SF 8280 14827 MT (VMSV3x.MEM)SH /Times-Roman SF 16280 XM (ocumentation on the changes between) 92 W( releases 3.1 and 3.1, and 3.2 and 3.3 of Kermit-32, and)93 W 16280 15932 MT (additional installation information.)SH 12 /Times-Bold AF 8280 18520 MT (OTHER INSTALLATION CONSIDERATIONS)SH 10 /Times-Roman AF 8280 19934 MT (As distributed, Kermit-32 should work on any VAX/VMS system \050version 4.0) 21 W( and later\051. Customization is possible)20 W 8280 21130 MT (with or without a BLISS-32 compiler. Default parameter values may be changed) 177 W( by changing the appropriate)178 W 8280 22326 MT (LITERALs in the BLISS-32 source) 58 W( for VMSMSG, or the actual values which are stored in the routine MSG_INIT)57 W 8280 23522 MT (in the MACRO-32 source for VMSMSG.)SH 8280 25914 MT (Sites can also easily) 88 W( change the commands which are used for processing the generic server functions \050REMOTE)89 W 8280 27110 MT (commands when) 109 W( running as a server\051. The text which makes up these commands is in the file VMSGEN.MAR,)108 W 8280 28306 MT (along with the text of the) 227 W( REMOTE HELP message. This allows a site to make use of local programs for)228 W 8280 29502 MT (performing some of the commands \050perhaps using FINGER to perform the WHO command, etc.\051.)SH 8280 31894 MT (If you want to allow your users to assign external terminal) 45 W( lines for connect- ing to remote systems from the VAX,)44 W 8280 33090 MT (e.g. by dialing out, you will have to con- figure those) 50 W( lines to allow the desired access. Otherwise, users will get a)51 W 8280 34286 MT (message like "No privilege for attempted operation" when they do a SET LINE command.) 65 W( Sample) 379 W( commands for)64 W 8280 35482 MT (terminal TXA0: might include:)SH /Courier SF 10680 37137 MT ($ SET PROTECTION=\050W:R\051 TXA0:/DEVICE)SH /Times-Roman SF 8280 38854 MT (or)SH /Courier SF 10680 40509 MT ($ SET PROTECTION=\050W:RWLP\051/DEVICE/OWNER=[1,4] TXA0:)SH /Times-Roman SF 8280 42226 MT (or)SH /Courier SF 10680 43881 MT ($ SET ACL/OBJECT=DEVICE/ACL=\050IDENTIFIER=INTERACTIVE,OPTIONS=NONE,-)SH 11880 44912 MT (ACCESS=READ+WRITE\051 TXA0:)SH /Times-Roman SF 8280 46629 MT (Consult your VAX/VMS) 103 W( system manager's manual for the ramifications \050especially on security\051 of each of these)104 W 8280 47825 MT (commands.)SH ES %%Page: 232 233 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 232)SH 12 /Times-Bold AF 29154 XM (Kermit User Guide: VAX/VMS KERMIT \05012\051)SH 46800 50 6120 5709 UL ES %%Page: 233 234 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (12. DECSYSTEM-20 KERMIT)SH 10 /Times-Italic AF 51275 XM (Page 233)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 8280 8272 MT (12. DECSYSTEM-20 KERMIT)SH 10 /Times-Italic AF 8280 10566 MT (Authors:)SH /Times-Roman SF 14280 XM (Frank da Cruz, Bill Catchings, Columbia University)SH /Times-Italic SF 8280 11671 MT (Language:)SH /Times-Roman SF 14280 XM (MACRO-20)SH /Times-Italic SF 8280 12776 MT (Version:)SH /Courier SF 14280 XM (4.2\050262\051)SH /Times-Italic SF 8280 13881 MT (Date:)SH /Times-Roman SF 14280 XM (January 1988)SH 12 /Times-Bold AF 8280 16469 MT (Kermit-20 Capabilities At a Glance:)SH 10 /Times-Roman AF 9280 18260 MT (Local operation:)SH 34480 XM (Yes)SH 9280 19365 MT (Remote operation:)SH 34480 XM (Yes)SH 9280 20470 MT (Transfers text files:)SH 34480 XM (Yes)SH 9280 21575 MT (Transfers binary files:)SH 34480 XM (Yes)SH 9280 22680 MT (Wildcard send:)SH 34480 XM (Yes)SH /Courier SF 9280 23785 MT (^X/^Y)SH /Times-Roman SF 12530 XM (interruption:)SH 34480 XM (Yes)SH 9280 24890 MT (Filename collision avoidance:)SH 34480 XM (Yes)SH 9280 25995 MT (Timeouts:)SH 34480 XM (Yes)SH 9280 27100 MT (8th-bit prefixing:)SH 34480 XM (Yes)SH 9280 28205 MT (Repeat character compression:)SH 34480 XM (Yes)SH 9280 29310 MT (Alternate block check types:)SH 34480 XM (Yes)SH 9280 30415 MT (Communication settings:)SH 34480 XM (Yes)SH 9280 31520 MT (Transmit BREAK:)SH 34480 XM (Yes)SH 9280 32625 MT (IBM mainframe communication:)SH 34480 XM (Yes)SH 9280 33730 MT (Transaction logging:)SH 34480 XM (Yes)SH 9280 34835 MT (Session logging:)SH 34480 XM (Yes)SH 9280 35940 MT (Debug logging:)SH 34480 XM (Yes)SH 9280 37045 MT (Raw transmit:)SH 34480 XM (Yes)SH 9280 38150 MT (Login scripts:)SH 34480 XM (Yes)SH 9280 39255 MT (Act as server:)SH 34480 XM (Yes)SH 9280 40360 MT (Talk to server:)SH 34480 XM (Yes)SH 9280 41465 MT (Advanced commands for servers:)SH 34480 XM (Yes)SH 9280 42570 MT (Local file management:)SH 34480 XM (Yes)SH 9280 43675 MT (Command/init files:)SH 34480 XM (Yes)SH 9280 44780 MT (Long packets:)SH 34480 XM (No)SH 9280 45885 MT (Sliding windows:)SH 34480 XM (No)SH 9280 46990 MT (Handle file attributes:)SH 34480 XM (No)SH 8280 49382 MT (Kermit-20 is a program that implements the Kermit file transfer protocol for the Digital Equipment Corporation)137 W 8280 50578 MT (DECSYSTEM-20 mainframe computer. It is written) 153 W( in MACRO-20 assembly language and should run on any)154 W 8280 51774 MT (DEC-20 system with version 4 of TOPS-20 or later.)SH 8280 54166 MT (The Kermit-20 section will describe the things you should know about the DEC-20) 116 W( file system in order to make)115 W 8280 55362 MT (effective use of Kermit, and then it will describe the special features of the Kermit-20 program.)SH 14 /Times-Bold AF 8280 58964 MT (12.1. The DEC-20 File System)SH 10 /Times-Roman AF 8280 61082 MT (The features of the DEC-20 file system of greatest interest to Kermit users are the form of the file specifications, and)3 W 8280 62278 MT (the distinctions between text and binary files.)SH ES %%Page: 234 235 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 234)SH 12 /Times-Bold AF 24787 XM (Kermit User Guide: DECSYSTEM-20 KERMIT \05012.1\051)SH 46800 50 6120 5709 UL 6120 8004 MT (DEC-20 File Specifications)SH 10 /Times-Roman AF 6120 9418 MT (DEC-20 file specifications are of the form)SH /Courier SF 8520 11073 MT (DEVICE:NAME.TYPE.GEN;ATTRIBUTES)SH /Times-Roman SF 6120 12790 MT (where the DIRECTORY, NAME, and TYPE) 183 W( may each be up to 39 characters in length, GEN is a generation)182 W 6120 13986 MT (\050version number\051, and various attributes are possible \050protection code, account, temporary,) 135 W( etc\051. Generation and)136 W 6120 15182 MT (attributes are normally omitted. Device and) 10 W( directory, when omitted, default to the user's own \050or "connected"\051 disk)9 W 6120 16378 MT (and directory. Thus)37 W /Courier SF 14572 XM (NAME.TYPE)SH /Times-Roman SF 20259 XM (is normally sufficient to specify a file, and only) 37 W( this information is sent along by)38 W 6120 17574 MT (Kermit-20 with an outgoing file.)SH 6120 19966 MT (The device, directory, name, and type fields may contain uppercase letters,) 124 W( digits, and the special characters ")123 W /Courier SF (-)SH /Times-Roman SF (")SH 6120 21162 MT (\050dash\051, ")38 W /Courier SF (_)SH /Times-Roman SF (" \050underscore\051, and ")38 W /Courier SF ($)SH /Times-Roman SF (" \050dollar sign\051. There are no) 38 W( imbedded or trailing spaces. Other characters may be)39 W 6120 22358 MT (included by prefixing them \050each\051 with a Control-V. The) 23 W( fields of the file specification are set off from one another)22 W 6120 23554 MT (by the punctuation indicated above.)SH 6120 25946 MT (The device field specifies a physical or "logical" device upon which the) 8 W( file is resident. The directory field indicates)9 W 6120 27142 MT (the area on the device, for instance) 112 W( the area belonging to the owner of the file. Kermit-20 does not transmit the)111 W 6120 28338 MT (device or directory fields to the target system, and does not attempt) 121 W( to honor device or directory fields that may)122 W 6120 29534 MT (appear in incoming file names; for instance, it will not create new directories.)SH 6120 31926 MT (The name is the primary identifier for the file. The type, also called the "extension", is an indicator which, by)144 W 6120 33122 MT (convention, tells what kind of file we have. For instance)16 W /Courier SF 29265 XM (FOO.FOR)SH /Times-Roman SF 33732 XM (is the source of a Fortran program named FOO;)17 W /Courier SF 6120 34318 MT (FOO.REL)SH /Times-Roman SF 10909 XM (might be the relocatable) 339 W( object module produced by compiling)338 W /Courier SF 39312 XM (FOO.FOR)SH /Times-Roman SF (;)SH /Courier SF 44378 XM (FOO.EXE)SH /Times-Roman SF 49166 XM (could an)338 W 6120 35514 MT (executable program produced by LOADing and SAVing)SH /Courier SF 29032 XM (FOO.REL)SH /Times-Roman SF (, and so forth.)SH 6120 37906 MT (The DEC-20 allows a group of files to be specified in a single file specification by including the special "wildcard")39 W 6120 39102 MT (characters, ")65 W /Courier SF (*)SH /Times-Roman SF (" and ")65 W /Courier SF (%)SH /Times-Roman SF (". A) 380 W( ")65 W /Courier SF (*)SH /Times-Roman SF (" matches any string of characters, including no characters at all; a ")64 W /Courier SF (%)SH /Times-Roman SF (" matches any)64 W 6120 40298 MT (single character. Here are some examples:)SH /Courier SF 6120 42089 MT (*.FOR)SH /Times-Roman SF 10120 XM (All files of type)SH /Courier SF 16675 XM (FOR)SH /Times-Roman SF 18725 XM (\050all Fortran source files\051 in the connected directory.)SH /Courier SF 6120 43747 MT (FOO.*)SH /Times-Roman SF 10120 XM (Files of all types with name)SH /Courier SF 21453 XM (FOO)SH /Times-Roman SF (.)SH /Courier SF 6120 45405 MT (F*.*)SH /Times-Roman SF 10120 XM (All files whose names start with F.)SH /Courier SF 6120 47063 MT (F*X*.*)SH /Times-Roman SF 10120 XM (All files whose names start with F and contain at least one X.)SH /Courier SF 6120 48721 MT (%.*)SH /Times-Roman SF 10120 XM (All files whose names are exactly one character long.)SH /Courier SF 6120 50379 MT (*.%%%*)SH /Times-Roman SF 10120 XM (All files whose types are at least three characters long.)SH 6120 52170 MT (Wildcard notation is used on many computer systems in similar ways, and it is the) 15 W( mechanism most commonly used)16 W 6120 53366 MT (to instruct Kermit to send a group of files.)SH 13 /Times-Bold AF 22045 56725 MT (Text Files and Binary Files)SH 10 /Times-Roman AF 6120 59098 MT (The DEC-20, like most) 172 W( computers, has a file system with its own peculiarities. Like many other systems, the)171 W 6120 60294 MT (DEC-20 makes a distinction between)114 W /Times-Italic SF 21827 XM (text files)114 W /Times-Roman SF 25666 XM (and)SH /Times-Italic SF 27474 XM (binary files)114 W /Times-Roman SF (. Text) 478 W( files are generally) 114 W( those composed only of)115 W 6120 61490 MT (printing characters \050letters, digits, and punctuation\051 and "carriage control" characters \050carriage return,) 8 W( line feed, form)7 W 6120 62686 MT (feed, tab\051. Text files are designed to) 2 W( be read by people. Binary files are designed to be read by a computer program,)3 W 6120 63882 MT (and may have any contents at all.) 8 W( If) 264 W( you use the DEC-20 TYPE command to display a text file on your terminal, the)7 W 6120 65078 MT (result will be intelligible. If you type a binary file on your) 59 W( terminal, you will probably see mainly gibberish. You)60 W 6120 66274 MT (can not always tell a text file from a) 84 W( binary file by its name or directory information, though in general files with)83 W 6120 67470 MT (types like)146 W /Courier SF 10523 XM (.TXT)SH /Times-Roman SF (,)SH /Courier SF 13569 XM (.DOC)SH /Times-Roman SF (,)SH /Courier SF 16615 XM (.HLP)SH /Times-Roman SF 19411 XM (are textual \050as are "source files" for computer) 146 W( programs like text formatters and)147 W 6120 68666 MT (programming language compilers\051, and files with types like)SH /Courier SF 30256 XM (.EXE)SH /Times-Roman SF (,)SH /Courier SF 33156 XM (.REL)SH /Times-Roman SF (,)SH /Courier SF 36056 XM (.BIN)SH /Times-Roman SF 38706 XM (are binary.)SH 6120 71058 MT (The DEC-20 has an unusual word size, 36 bits. It differs from) 89 W( most other systems by storing text in 7-bit, rather)88 W ES %%Page: 235 236 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (12.1. The DEC-20 File System)SH 10 /Times-Italic AF 51275 XM (Page 235)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (than 8-bit, bytes. Since text is encoded in the 7-bit ASCII character set, this allows) 79 W( more efficient use of storage.)80 W 8280 9082 MT (However, the word size is not a multiple of) 30 W( the normal byte size. The DEC-20 therefore stores five 7-bit characters)29 W 8280 10278 MT (per word, with one bit left over.)SH 8280 12670 MT (It is also possible to store files with other byte sizes.) 108 W( The) 467 W( common layouts of bytes within a word are shown in)109 W 8280 13866 MT (Figure 12-1.)SH 46800 50 8280 15857 UL 10530 18772 MT (7:)SH 12280 XM (Text Files: Five 7-bit bytes per word.)SH 500 50 10530 18972 UL /Courier SF 12880 20427 MT (+------+------+------+------+------++)SH 12880 21458 MT (| | | | | ||)3000 W 12880 22489 MT (+------+------+------+------+------++)SH 12880 23520 MT (0 7 14) 3000 W( 21 28 35)2400 W /Times-Roman SF 12280 25237 MT (Normally, bit 35 is unused and) 11 W( set to zero. However, in EDIT \050or SOS, or OTTO\051 line-numbered files, bit)10 W 12280 26342 MT (35 is set to 1 when the word contains a line number.)SH 10530 29329 MT (8:)SH 12280 XM ("Foreign" binary files: Four 8-bit bytes per word.)SH 500 50 10530 29529 UL /Courier SF 12880 30984 MT (+-------+-------+-------+-------+---+)SH 12880 32015 MT (| | | | |) 3600 W( |)1200 W 12880 33046 MT (+-------+-------+-------+-------+---+)SH 12880 34077 MT (0 8 16) 3600 W( 24 32) 3000 W( 35)600 W /Times-Roman SF 12280 35794 MT (Bits 32-35 are unused.)SH 10280 38781 MT (36:)SH 12280 XM ("Native" binary files: One 36-bit byte per word.)SH 1000 50 10280 38981 UL /Courier SF 12880 40436 MT (+-----------------------------------+)SH 12880 41467 MT (| |)20400 W 12880 42498 MT (+-----------------------------------+)SH 12880 43529 MT (0 35)20400 W /Times-Roman SF 12280 45246 MT (All bits are used.)SH /Times-Bold SF 20084 47037 MT (Figure 12-1:)SH /Times-Roman SF 25833 XM (DECSYSTEM-20 Word/Byte Organization)SH 46800 50 8280 48847 UL 8280 51039 MT (The minimum unit of disk allocation on) 52 W( the DEC-20 is a)53 W /Times-Italic SF 31718 XM (page)SH /Times-Roman SF (, 512 36-bit words, or 2560 7-bit characters, or 2048)53 W 8280 52235 MT (8-bit bytes. Any file) 124 W( that contains at least one bit of information occupies at least a full page on the disk. The)123 W 8280 53431 MT (directory information for a file includes the number) 62 W( of pages occupied on the disk, the bytesize of the file, and the)63 W 8280 54627 MT (number of bytes of that size which are in the file. This information can) 317 W( be seen by using the DEC-20)316 W 8280 55823 MT (VDIRECTORY command, for instance)SH /Courier SF 10680 57478 MT (@vdir foo.*)SH 12480 59133 MT (PS:)SH 11280 60164 MT (Name Protection) 2400 W( Pages) 1800 W( Bytes\050Size\051 Creation)SH 11280 61195 MT (FOO.COM.1;P774242 1) 5400 W( 384\0508\051) SH( 27-Dec-83)2400 W 13080 62226 MT (MAC.1;P774242 1) 6000 W( 152\0507\051) SH( 27-Dec-83)2400 W 12480 63257 MT (.REL.1;P774242 1) 6000 W( 39\05036\051) SH( 27-Dec-83)2400 W 12480 64288 MT (.EXE.1;P774242 2) 6000 W( 1024\05036\051) SH( 27-Dec-83)1200 W 11280 65943 MT (Total of 5 pages in 4 files)SH /Times-Roman SF 8280 67660 MT (In this example,)148 W /Courier SF 15390 XM (FOO.MAC)SH /Times-Roman SF 19988 XM (occupies 1 page, and is composed of 152 7-bit bytes. This file is textual \050program)149 W 8280 68856 MT (source for the MACRO assembler\051, 152) 179 W( characters long. Programs which read text files \050such as text editors,)178 W 8280 70052 MT (program compilers, the TYPE command,) 183 W( etc\051 determine the end of a file from the byte count specified in the)184 W 8280 71248 MT (directory. Kermit-20) 411 W( determines the end of file in the same way, so although)80 W /Courier SF 40507 XM (FOO.MAC)SH /Times-Roman SF 45037 XM (occupies an entire 2560-)80 W ES %%Page: 236 237 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 236)SH 12 /Times-Bold AF 24787 XM (Kermit User Guide: DECSYSTEM-20 KERMIT \05012.1\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (byte page of storage, only the) 81 W( first 152 characters are transmitted. Binary files, such as)82 W /Courier SF 42503 XM (FOO.EXE)SH /Times-Roman SF 47035 XM (\050an executable)82 W 6120 9082 MT (DEC-20 program\051,) 5 W( tend to occupy full pages. In this case too, Kermit-20 uses the byte count to determine the end of)4 W 6120 10278 MT (file.)SH 6120 12670 MT (Why do you need to know) 49 W( all this? In most cases, you don't. It depends on whether you are using the DEC-20 as)50 W 6120 13866 MT (your "home base".)SH 13 /Times-Bold AF 15981 17225 MT (Using a Microcomputer to Archive DEC-20 Files)SH 10 /Times-Roman AF 6120 19598 MT (Most computers \050other than the DEC-10 and DEC-20\051 store characters in 8-bit bytes. Let's call any such) 28 W( system an)27 W 6120 20794 MT (8-bit-byte system. Microcomputers that run CP/M or MS-DOS or PC-DOS, and any) 11 W( computers than run Unix, store)12 W 6120 21990 MT (these 8-bit bytes) 76 W( in a linear sequence. Certain other 8-bit-byte systems \050PDP-11 or VAX systems with FILES-11,)75 W 6120 23186 MT (IBM mainframes\051 have more complex file formats. This discussion applies to all) 259 W( linear 8-bit-byte systems,)260 W 6120 24382 MT (including most popular microcomputers.)SH 6120 26774 MT (Kermit can send any "native" DEC-20 sequential file, text or binary,) 25 W( to an 8-bit-byte system and bring it back to the)24 W 6120 27970 MT (DEC-20 restored to its original form. If you are using a microcomputer to archive your) 111 W( DEC-20 files, you need)112 W 6120 29166 MT (never concern yourself with) 108 W( details of byte size or file format. The same holds true between two DEC-20s, or a)107 W 6120 30362 MT (DEC-10 and a DEC-20.)SH 6120 32754 MT (There is, however, one special complication of which you should be aware.) 187 W( Certain) 626 W( microcomputer operating)188 W 6120 33950 MT (systems, notably CP/M, do not have an entirely satisfactory way of indicating the) 117 W( end of file. The file length is)116 W 6120 35146 MT (recorded in blocks rather than bytes. For text files, the end) 21 W( of file is marked within a block by inserting a Control-Z)22 W 6120 36342 MT (after the last data) 29 W( character. Binary files, however, might easily contain Control-Z characters as data. Therefore, in)28 W 6120 37538 MT (order not to lose data, these systems must transmit binary files in complete blocks.) 79 W( If) 409 W( the binary file is of foreign)80 W 6120 38734 MT (origin \050for instance, from a DEC-20\051, and it did not happen to fill up) 80 W( the last block when it was transferred to the)79 W 6120 39930 MT (micro, then when that file is sent back to the system of origin in "binary mode," junk will appear at the end) 48 W( \050if it is)49 W 6120 41126 MT (sent back in "text mode," it could be truncated at the first data byte that happened to correspond to Control-Z\051.) 38 W( For)324 W 6120 42322 MT (DEC-20 programs in)52 W /Courier SF 14914 XM (.EXE)SH /Times-Roman SF 17616 XM (format, this generally has no effect on the runnability or behavior of the program.) 52 W( But)356 W 6120 43518 MT (for other binary files, particularly internal format numerical data or relocatable program object \050)133 W /Courier SF (.REL)SH /Times-Roman SF (\051 files,) 133 W( the)132 W 6120 44714 MT (junk could have bad effects. For instance, extraneous data at the end of a)63 W /Courier SF 36641 XM (.REL)SH /Times-Roman SF 39354 XM (file will) 63 W( generally cause LINK to)64 W 6120 45910 MT (fail to load the file.)SH 6120 48302 MT (Most microcomputer Kermit programs have commands to control end-of-file detection -- commands like) 26 W( SET FILE)25 W 6120 49498 MT (TEXT, SET FILE BINARY, SET EOF CTRLZ.)SH 13 /Times-Bold AF 15439 52857 MT (Using the DEC-20 to Archive Microcomputer Files)SH 10 /Times-Roman AF 6120 55230 MT (You can) 56 W( use Kermit to send textual files from a microcomputer or any 8-bit system to the DEC-20 with no special)57 W 6120 56426 MT (provisions, since Kermit-20 stores incoming characters in 7-bit bytes) 254 W( as text unless you explicitly instruct it)253 W 6120 57622 MT (otherwise. But) 436 W( Kermit-20 has no automatic way of distinguishing an incoming binary file from an incoming text)93 W 8 SS 7703 58473 MT (2)SH 10 SS 6120 58818 MT (file.)SH 8367 XM (Binary files from 8-bit-byte systems generally contain significant data in the 8th bit, which would be lost if) 14 W( the)13 W 6120 60014 MT (incoming characters were stored in 7-bit bytes, rendering the file useless when sent back to the) 134 W( original system.)135 W 6120 61210 MT (Thus if you want to) 43 W( use Kermit to store foreign 8-bit binary data on the DEC-20, you must tell it to store such files)42 W 6120 62406 MT (with a bytesize of 8 rather than 7. This can be the source of much confusion and inconvenience. In) 38 W( particular, you)39 W 6120 63602 MT (cannot use a "wildcard send" command to send a mixture of text and binary files from) 72 W( an 8-bit-byte system to the)71 W 6120 64798 MT (DEC-20; rather, you must send) 15 W( all text files with Kermit-20's file bytesize set to 7, and all 8-bit binary files with the)16 W 6120 65994 MT (bytesize set to 8.)SH 10800 50 6120 70283 UL 6 SS 6920 71691 MT (2)SH 8 SS 7220 72000 MT (Unless the incoming file has an "ITS Binary Header"; see below.)SH ES %%Page: 237 238 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (12.1. The DEC-20 File System)SH 10 /Times-Italic AF 51275 XM (Page 237)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (Once you get the foreign binary file into the DEC-20, stored with the correct bytesize \050as)32 W /Courier SF 44645 XM (FOO.COM)SH /Times-Roman SF 49126 XM (is stored in the)31 W 8280 9082 MT (example above\051, you need take no special measures to send) 212 W( it back to its system of origin. This is because)213 W 8280 10278 MT (Kermit-20 honors the bytesize and byte count from the directory. For instance, if you told Kermit-20) 143 W( to)142 W /Courier SF 52680 XM (SEND)SH 8280 11474 MT (FOO.*)SH /Times-Roman SF (, every file in the example above would be transmitted in the correct manner, automatically.)SH 8280 13866 MT (The previous discussion assumes you want to store text files in usable form on the DEC-20.) 79 W( However,) 409 W( if you are)80 W 8280 15062 MT (using the DEC-20 purely as a repository for your microcomputer files, and you have no desire to display or) 3 W( share the)2 W 8280 16258 MT (contents of those files on the DEC-20,) 27 W( you can SET FILE BYTESIZE 8 for all incoming files, both text and binary.)28 W 8280 17454 MT (When the files are sent back to a microcomputer, they will be stored correctly.)SH 13 /Times-Bold AF 22924 20813 MT (Files Kermit-20 Cannot Handle)SH 10 /Times-Roman AF 8280 23186 MT (The Kermit protocol can only accommodate transfer) 1 W( of)SH /Times-Italic SF 30614 XM (sequential)SH /Times-Roman SF 34975 XM (files, files which are a linear sequence of bytes \050or)SH 8280 24382 MT (words\051.)SH 8280 26774 MT (Some files on the DEC-20 are not sequential, and cannot be successfully sent) 131 W( or received by Kermit-20. These)132 W 8280 27970 MT (include directory files, files with holes \050missing pages\051,) 115 W( ISAM files, and RMS files. These files require external)114 W 8280 29166 MT (information \050kept in the DEC-20's file descriptor block and/or index) 182 W( table\051 in order to be reconstructed; when)183 W 8280 30362 MT (sending files, Kermit-20 presently transmits only the file) 213 W( name and the contents of the file. External control)212 W 8280 31558 MT (information and file attributes are not transmitted.)SH 14 /Times-Bold AF 8280 35160 MT (12.2. Program Operation)SH 10 /Times-Roman AF 8280 37278 MT (Kermit-20's prompt is ")51 W /Courier SF (Kermit-20>)SH /Times-Roman SF (". Kermit-20) 352 W( will accept a single command) 51 W( on the Exec command line, like)52 W 8280 38474 MT (this:)SH /Courier SF 10680 40129 MT (@)SH 10680 41160 MT (@Kermit send foo.bar)SH 11400 50 11280 41360 UL /Times-Italic SF 11880 42875 MT (the file is sent)SH /Courier SF 10680 44530 MT (@)SH /Times-Roman SF 8280 46247 MT (or you can run the program interactively to issue several commands, like this:)SH /Courier SF 10680 47902 MT (@)SH 10680 48933 MT (@Kermit)SH 3600 50 11280 49133 UL 10680 50588 MT (TOPS-20 Kermit version 4.2\050262\051)SH 10680 52243 MT (Kermit-20>send foo.*)SH 6000 50 16680 52443 UL /Times-Italic SF 11880 53958 MT (files are sent)SH /Courier SF 10680 55613 MT (Kermit-20>statistics)SH 6000 50 16680 55813 UL /Times-Italic SF 11880 57328 MT (performance statistics are printed)SH /Courier SF 10680 58983 MT (Kermit-20>receive)SH 4200 50 16680 59183 UL /Times-Italic SF 11880 60698 MT (files are received)SH /Courier SF 10680 62353 MT (Kermit-20>exit)SH 2400 50 16680 62553 UL 10680 63384 MT (@)SH /Times-Roman SF 8280 65776 MT (During interactive operation, you may use the TOPS-20 help \050"?"\051 and recognition \050ESC\051 features) 170 W( freely while)169 W 8280 66972 MT (typing commands. A question mark typed at any point in a command displays the options) 80 W( available at that point;)81 W 8280 68168 MT (typing an ESC character causes the current keyword or filename to be completed \050or default value to be supplied\051,)62 W 8280 69364 MT (and a "guide) 82 W( word" in parentheses to be typed, prompting you for the next field. If you have not typed sufficient)83 W 8280 70560 MT (characters to uniquely) 47 W( specify the keyword or filename \050or if there is no default value\051 then a beep will be sounded)46 W 8280 71756 MT (and you may continue typing.)SH ES %%Page: 238 239 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 238)SH 12 /Times-Bold AF 24787 XM (Kermit User Guide: DECSYSTEM-20 KERMIT \05012.2\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (Command keywords may be abbreviated to) 4 W( their shortest prefix that sets them apart from any other keyword valid in)5 W 6120 9082 MT (that field.)SH 6120 11474 MT (If you have a file called)233 W /Courier SF 17237 XM (KERMIT.INI)SH /Times-Roman SF 23720 XM (in your login directory, Kermit-20 will) 233 W( execute an automatic TAKE)232 W 6120 12670 MT (command on) 210 W( it upon initial startup.)211 W /Courier SF 22152 XM (KERMIT.INI)SH /Times-Roman SF 28613 XM (may contain any Kermit-20 commands, for instance SET)211 W 6120 13866 MT (commands, or DEFINEs for SET macros to configure Kermit-20 to various systems or communications media.)SH 6120 16258 MT (Kermit-20 provides) 39 W( most of the commands possible for an "ideal" Kermit program, as described in the main part of)38 W 6120 17454 MT (the)SH /Times-Italic SF 7592 XM (Kermit User Guide)SH /Times-Roman SF (. The) 250 W( following sections will concentrate on system-dependent aspects of Kermit-20.)SH 14 /Times-Bold AF 6120 21056 MT (12.3. Remote and Local Operation)SH 10 /Times-Roman AF 6120 23174 MT (Kermit-20 normally runs in remote mode, with the user sitting at a) 51 W( PC. But Kermit-20 can also run in local mode.)52 W 6120 24370 MT (Local operation of) 189 W( Kermit-20 is useful if the DEC-20 has an autodialer, or a hardwired connection to another)188 W 6120 25566 MT (computer. When) 300 W( in local mode, file transfer takes place over an assigned TTY line, and) 25 W( Kermit-20 is free to update)26 W 6120 26762 MT (your screen with status information, and to listen to your keyboard for interrupt characters.)SH 46800 50 6120 28753 UL /Times-Italic SF 8520 31592 MT (Local Operation of Kermit-20:)SH /Courier SF 9120 33654 MT (DECSYSTEM-20)SH 8520 34685 MT (+---------------------------------------+)SH 8520 35716 MT (| |)22800 W 8520 36747 MT (| +--------------------+) 1200 W( |)7800 W 8520 37778 MT (| |) 1200 W( Your Job) SH( |) 6000 W( |)7800 W 8520 38809 MT (| |) 1200 W( |) 11400 W( |)7800 W 8520 39840 MT (| | +------------+ |) 1200 W( <--Commands | Your Job's)SH 8520 40871 MT (| | |) 1200 W( Kermit-20 +---+--------------+----------------- \050-: You)SH 8520 41902 MT (| | |) 1200 W( |) 6600 W( |) 1200 W( Display---> | Controlling TTY)SH 8520 42933 MT (| | |) 1200 W( |) 6600 W( |) 1200 W( |)7800 W 8520 43964 MT (| | |) 1200 W( |) 6600 W( |) 1200 W( |)7800 W 8520 44995 MT (| | |) 1200 W( |) 6600 W( |) 1200 W( <--Packets) SH( |) 1200 W( Kermit's)SH 8520 46026 MT (| | |) 1200 W( +---+--------------+----------------->) 6600 W( Remote)SH 8520 47057 MT (| | +------------+ |) 1200 W( Packets-->) SH( |) 1200 W( Assigned TTY) SH( System)3000 W 8520 48088 MT (| |) 1200 W( |) 11400 W( |)7800 W 8520 49119 MT (| +--------------------+) 1200 W( |)7800 W 8520 50150 MT (| |)22800 W 8520 51181 MT (+---------------------------------------+)SH /Times-Bold SF 20049 52898 MT (Figure 12-2:)SH /Times-Roman SF 25798 XM (DEC-20 Kermit Local Operation)SH 46800 50 6120 54708 UL 6120 56900 MT (Kermit-20 enters local mode when you issue a SET LINE)20 W /Times-Italic SF 29705 XM (n)SH /Times-Roman SF 30475 XM (command, where)20 W /Times-Italic SF 37652 XM (n)SH /Times-Roman SF 38422 XM (is the octal TTY number of any) 20 W( line)19 W 6120 58096 MT (other than your own controlling terminal.)SH 14 /Times-Bold AF 6120 61698 MT (12.4. Conditioning Your Job for Kermit)SH 10 /Times-Roman AF 6120 63816 MT (Kermit-20 does as much as it can to condition your line for file transfer. It saves all your terminal and link settings,)24 W 6120 65012 MT (and restores them after use. However, there are some sources of interference over which Kermit-20) 101 W( can have no)100 W 6120 66208 MT (control. In) 302 W( particular, messages issued by superior or parellel forks could become) 26 W( mingled with Kermit packets and)27 W 6120 67404 MT (slow things down or stop them entirely.) 158 W( For) 565 W( this reason, before using Kermit-20 for any extended period, you)157 W 6120 68600 MT (should:)SH /Symbol SF 7910 70505 MT (\267)SH /Times-Roman SF 8620 XM (Type the Exec commands SET NO MAIL-WATCH and SET NO ALERTS)SH ES %%Page: 239 240 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (12.4. Conditioning Your Job for Kermit)SH 10 /Times-Italic AF 51275 XM (Page 239)SH 46800 50 8280 5709 UL /Symbol SF 10070 8000 MT (\267)SH /Times-Roman SF 10780 XM (Make sure you don't have any print or batch jobs pending that) 175 W( were submitted with the /NOTIFY)176 W 10780 9105 MT (option.)SH /Symbol SF 10070 10763 MT (\267)SH /Times-Roman SF 10780 XM (Make sure you don't have any superior) 223 W( or parallel forks that have enabled terminal interrupts on)222 W 10780 11868 MT (Control-A; these could prevent Kermit packets \050which start with Control-A\051 from getting through.)SH 8280 13659 MT (After running Kermit, you can restore your mail-watch and alerts by hand. Alternatively, you could have an) 65 W( Exec)66 W 8280 14855 MT (command file for invoking Kermit like this:)SH /Courier SF 10680 16510 MT (set no alerts)SH 10680 17541 MT (set no mail-watch)SH 10680 18572 MT (kermit)SH 10680 19603 MT (set mail-watch)SH 10680 20634 MT (set alert 1:00PM Go to lunch)SH 10680 21665 MT (set alert 6:00PM Go to dinner)SH 10680 22696 MT (set alert 11:30PM Go to sleep)SH 14 /Times-Bold AF 8280 26298 MT (12.5. Kermit-20 Commands)SH 10 /Times-Roman AF 8280 28416 MT (This section describes the Kermit-20) 20 W( commands -- in detail where they differ from the "ideal" Kermit, briefly where)19 W 8280 29612 MT (they coincide. Kermit-20 has the following commands:)SH 15280 31222 MT (BYE)SH 17780 XM (to remote server.)SH 14002 32327 MT (CLEAR)SH 17780 XM (a stuck connection)SH 14113 33432 MT (CLOSE)SH 17780 XM (log file and stop logging remote session.)SH 12558 34537 MT (CONNECT)SH 17780 XM (as terminal to remote system.)SH 14947 35642 MT (CWD)SH 17780 XM (change local working directory.)SH 13725 36747 MT (DEFINE)SH 17780 XM (macros of Kermit-20 commands.)SH 13503 37852 MT (DELETE)SH 17780 XM (local files.)SH 11558 38957 MT (DIRECTORY)SH 17780 XM (listing of local files.)SH 14558 40062 MT (ECHO)SH 17780 XM (a line of text.)SH 15003 41167 MT (EXIT)SH 17780 XM (from Kermit-20.)SH 14058 42272 MT (FINISH)SH 17780 XM (Shut down remote server.)SH 15336 43377 MT (GET)SH 17780 XM (remote files from server.)SH 14780 44482 MT (HELP)SH 17780 XM (about Kermit-20.)SH 14336 45587 MT (INPUT)SH 17780 XM (characters from communication line.)SH 13947 46692 MT (LOCAL)SH 17780 XM (prefix for local file management commands.)SH 15225 47797 MT (LOG)SH 17780 XM (remote terminal session.)SH 13336 48902 MT (OUTPUT)SH 17780 XM (characters to communication line.)SH 14113 50007 MT (PAUSE)SH 17780 XM (between commands.)SH 14724 51112 MT (PUSH)SH 17780 XM (to TOPS-20 command level.)SH 14892 52217 MT (QUIT)SH 17780 XM (from Kermit-20)SH 13058 53322 MT (RECEIVE)SH 17780 XM (files from remote Kermit.)SH 13169 54427 MT (REMOTE)SH 17780 XM (prefix for remote file management commands.)SH 15169 55532 MT (RUN)SH 17780 XM (a DEC-20 program.)SH 14669 56637 MT (SEND)SH 17780 XM (files to remote Kermit.)SH 13446 57742 MT (SERVER)SH 17780 XM (mode of remote operation.)SH 15502 58847 MT (SET)SH 17780 XM (various parameters.)SH 14336 59952 MT (SHOW)SH 17780 XM (various parameters.)SH 14168 61057 MT (SPACE)SH 17780 XM (inquiry.)SH 11724 62162 MT (STATISTICS)SH 17780 XM (about most recent file transfer.)SH 14614 63267 MT (TAKE)SH 17780 XM (commands from a file.)SH 12169 64372 MT (TRANSMIT)SH 17780 XM (a file "raw".)SH 14780 65477 MT (TYPE)SH 17780 XM (a local file.)SH ES %%Page: 240 241 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 240)SH 12 /Times-Bold AF 23887 XM (Kermit User Guide: DECSYSTEM-20 KERMIT \05012.5.1\051)SH 46800 50 6120 5709 UL 6120 8004 MT (12.5.1. Commands for File Transfer)SH 10 /Times-Roman AF 6120 9946 MT (Kermit-20 provides the standard) 160 W( SEND, RECEIVE, and GET commands for transferring files using the Kermit)161 W 6120 11142 MT (protocol.)SH 13 /Times-Bold AF 23452 14501 MT (The SEND Command)SH 10 /Times-Roman AF 6120 16874 MT (Syntax:)SH 6120 19266 MT (Sending a single file:)SH /Courier SF 8120 20784 MT (SEND)SH /Times-Italic SF 11120 XM (nonwild-filespec1)SH /Courier SF 18831 XM (\050AS\051 [)SH /Times-Italic SF (filespec2)SH /Courier SF (])SH /Times-Roman SF 6120 23176 MT (Sending multiple files:)SH /Courier SF 8120 24694 MT (SEND)SH /Times-Italic SF 11120 XM (wild-filespec1)SH /Courier SF 17331 XM (\050INITIAL\051 [)SH /Times-Italic SF (filespec2)SH /Courier SF (])SH /Times-Roman SF 6120 27086 MT (The SEND command causes a) 107 W( file or file group to be sent from the DEC-20 to the other system. There are two)106 W 6120 28282 MT (forms of) 192 W( the command, depending on whether)193 W /Times-Italic SF 26189 XM (filespec1)SH /Times-Roman SF 30187 XM (contains wildcard characters \050")193 W /Courier SF (*)SH /Times-Roman SF (" or ")193 W /Courier SF (%)SH /Times-Roman SF ("\051. Kermit-20)636 W 6120 29478 MT (automatically recognizes the two cases and issues the appropriate guide word, \050AS\051 or \050INITIAL\051, depending) 23 W( on the)22 W 6120 30674 MT (form of)SH /Times-Italic SF 9397 XM (filespec1)SH /Times-Roman SF (.)SH 12 /Times-Bold AF 6720 33262 MT (Sending a File Group)SH 10 /Times-Roman AF 6120 34676 MT (If)SH /Times-Italic SF 7090 XM (filespec1)SH /Times-Roman SF 10949 XM (contains wildcard characters then all matching files will be sent, in alphabetical order) 54 W( \050according to the)55 W 6120 35872 MT (ASCII collating sequence\051 by name. If a file can't be opened for read access, it will be) 19 W( skipped. The initial file in a)18 W 6120 37068 MT (wildcard group can be specified with the optional)59 W /Times-Italic SF 26644 XM (filespec2)SH /Times-Roman SF (. This) 368 W( allows a previously) 59 W( interrupted wildcard transfer)60 W 6120 38264 MT (from where it left off, or it can be used to skip some files that would be transmitted first.)SH 12 /Times-Bold AF 6720 40852 MT (Sending a Single File)SH 10 /Times-Roman AF 6120 42266 MT (If)SH /Times-Italic SF 7262 XM (filespec1)SH /Times-Roman SF 11293 XM (does not contain any wildcard characters, then the single file) 226 W( specified by)225 W /Times-Italic SF 43579 XM (filespec1)SH /Times-Roman SF 47609 XM (will be sent.)225 W 6120 43462 MT (Optionally,)SH /Times-Italic SF 10920 XM (filespec2)SH /Times-Roman SF 14747 XM (may be used to specify the name under which the file will arrive at the target system;)22 W /Times-Italic SF 49365 XM (filespec2)SH /Times-Roman SF 6120 44658 MT (is not parsed or validated in any way by Kermit-20, but lower case letters are raised to upper case, and) 135 W( leading)134 W 6120 45854 MT ("whitespace" \050blanks and tabs\051 are discarded. If)30 W /Times-Italic SF 25920 XM (filespec2)SH /Times-Roman SF 29755 XM (is not specified, Kermit-20 will send) 30 W( the file with its own)31 W 8 SS 8536 46705 MT (3)SH 10 SS 6120 47050 MT (name.)SH 12 /Times-Bold AF 6720 49638 MT (SEND Command General Operation:)SH 10 /Times-Roman AF 6120 51052 MT (Files will be sent with) 53 W( their DEC-20 filename and filetype \050for instance)52 W /Courier SF 35522 XM (FOO.BAR)SH /Times-Roman SF (, no device or directory field, no)52 W 6120 52248 MT (generation number or attributes\051. If you expect to) 83 W( be sending files whose names contain characters that would be)84 W 6120 53444 MT (illegal in filenames on the target system, and you know that the Kermit on the target system does not have) 4 W( the ability)3 W 6120 54640 MT (to convert incoming filenames, you can issue the SET FILE NAMING NORMAL-FORM command to have)242 W 6120 55836 MT (Kermit-20 replace suspect characters by)SH /Courier SF 22420 XM (X)SH /Times-Roman SF ('s.)SH 6120 58228 MT (Each file will be sent according to) 30 W( its bytesize and byte count from the directory unless you specify otherwise using)29 W 6120 59424 MT (SET FILE BYTESIZE, or unless the file has an "ITS Binary" header. If the bytesize is 8, then four) 36 W( 8-bit bytes will)37 W 6120 60620 MT (be sent from each DEC-20) 48 W( 36-bit word, and the low order four bits will be skipped. If other than 8, then five 7-bit)47 W 6120 61816 MT (bytes will be sent from each word, with) 7 W( the 8th bit of the 5th character set to the value of the remaining bit \050"bit 35"\051)8 W 8 SS 12091 62667 MT (4)SH 10 SS 6120 63012 MT (from the word.)SH 10800 50 6120 66587 UL 6 SS 6920 67995 MT (3)SH 8 SS 7220 68304 MT (Control-V's, which are used to quote otherwise illegal characters in DEC-20 file specifications, are stripped.)SH 6 SS 6920 69843 MT (4)SH 8 SS 7220 70152 MT (This is the same method) 23 W( used by the DEC-20 to encode 36-bit data on "ANSI-ASCII" tapes. It allows not only DEC-20 binary files, but also)22 W 6120 71076 MT (the line-sequence-numbered files) 99 W( produced by EDIT, SOS, or OTTO, which use bit 35 to distinguish line numbers from text, to be sent and)100 W 6120 72000 MT (retrieved correctly.)SH ES %%Page: 241 242 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (12.5.1. Commands for File Transfer)SH 10 /Times-Italic AF 51275 XM (Page 241)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (If communication line parity) 4 W( is being used \050see SET PARITY\051, Kermit-20 will request that the other Kermit accept a)3 W 8280 9082 MT (special kind of prefix notation for binary) 36 W( files. This is an advanced feature, and not all Kermits have it; if the other)37 W 8280 10278 MT (Kermit does not agree to use this feature, binary files) 64 W( cannot be sent correctly. This includes executable programs)63 W 8280 11474 MT (\050like DEC-20)28 W /Courier SF 14003 XM (.EXE)SH /Times-Roman SF 16682 XM (files, CP/M)29 W /Courier SF 21602 XM (.COM)SH /Times-Roman SF 24281 XM (files\051, relocatable object modules \050)29 W /Courier SF (.REL)SH /Times-Roman SF 40934 XM (files\051, as well as text files with line)29 W 8280 12670 MT (sequence numbers.)SH 8280 15062 MT (Kermit-20 will also ask the other Kermit whether it can handle a special prefix encoding for repeated characters. If)34 W 8280 16258 MT (it can,) 30 W( then files with long strings of repeated characters will be transmitted very efficiently. Columnar data, highly)31 W 8280 17454 MT (indented text, and binary files are the major beneficiaries of this technique.)SH 8280 19846 MT (If you're running Kermit-20 locally, for instance dialing out from the) 7 W( DEC-20 to another system using an autodialer,)6 W 8280 21042 MT (you should have already) 64 W( run Kermit on the remote system and issued either a RECEIVE or a SERVER command.)65 W 8280 22238 MT (Once you give Kermit-20 the SEND command, the name of each file will be displayed on your screen as the transfer)3 W 8280 23434 MT (begins; a) 144 W( ")145 W /Courier SF (.)SH /Times-Roman SF (" will be displayed for every 5 data packets sucessfully sent, and a ")145 W /Courier SF (%)SH /Times-Roman SF (" for every retransmission or)145 W 8280 24630 MT (timeout that) 169 W( occurs \050you may also elect other typeout options with the SET DEBUG command\051. If the file is)168 W 8280 25826 MT (successfully transferred, you will see ")212 W /Courier SF ([OK])SH /Times-Roman SF (", otherwise there will) 212 W( be an error message. When the specified)213 W 8280 27022 MT (operation is complete, the program will sound a beep. If) 68 W( you see many ")67 W /Courier SF (%)SH /Times-Roman SF (" characters, you are probably suffering)67 W 8280 28218 MT (from a noisy connection. You may be able to) 379 W( cut down on the retransmissions by using SET SEND)380 W 8280 29414 MT (PACKET-LENGTH to decrease the packet length; this will reduce the probability that a) 200 W( given packet will be)199 W 8280 30610 MT (corrupted by noise, and reduce the time required to retransmit a corrupted packet.)SH 8280 33002 MT (During local operation, you can type Control-A at) 92 W( any point during the transfer to get a brief status report.) 93 W( You)779 W 8280 34198 MT (may also type Control-X or Control-Z to interrupt the current file or file group.)SH 13 /Times-Bold AF 24384 37557 MT (The RECEIVE Command)SH 10 /Times-Roman AF 8280 39930 MT (Syntax:)SH /Courier SF 11836 XM (RECEIVE [)SH /Times-Italic SF (filespec)SH /Courier SF (])SH /Times-Roman SF 8280 42322 MT (The RECEIVE command tells Kermit-20 to receive a) 92 W( file or file group from the other system. If only one file is)91 W 8280 43518 MT (being received,) 84 W( you may include the optional)85 W /Times-Italic SF 27149 XM (filespec)SH /Times-Roman SF 30539 XM (as the name to store the incoming file under; otherwise, the)85 W 8280 44714 MT (name is taken from the incoming file header. Even if the name in the header is not a legal TOPS-20 file name,)115 W 8280 45910 MT (Kermit-20 will store it under that name, in) 22 W( which case you can refer to it later only by quoting each illegal character)23 W 8280 47106 MT (\050spaces, control characters, etc\051 with Control-V. If for some reason an incoming filename simply) 233 W( cannot be)232 W 8280 48302 MT (converted to legal form, the file will be) 64 W( saved as)65 W /Courier SF 28447 XM (-UNTRANSLATABLE-FILENAME-.KERMIT)SH /Times-Roman SF 47962 XM (\050new generation\051.)65 W 8280 49498 MT (You may also use SET FILE NAMING NORMAL-FORM to have Kermit-20 choose more) 41 W( conventional names for)40 W 8280 50694 MT (incoming files.)SH 8280 53086 MT (If an incoming file has the same name as an existing file, Kermit-20 just creates) 25 W( a new generation of the same name)26 W 8280 54282 MT (and type, for instance)78 W /Courier SF 17451 XM (FOO.BAR.3, FOO.BAR.4)78 W /Times-Roman SF (. The) 406 W( oldest generation will be) 78 W( automatically deleted, but you)77 W 8280 55478 MT (can still UNDELETE it.)SH 8280 57870 MT (Incoming files will all be stored with the prevailing bytesize, 7 by default, which is appropriate for text files.) 10 W( If) 532 W( you)11 W 8280 59066 MT (are asking Kermit-20 to receive binary files from) 84 W( a microcomputer or other 8-bit system, you must first type SET)83 W 8280 60262 MT (FILE BYTESIZE 8. Otherwise, the) 62 W( 8th bit of each byte will be lost and the file will be useless when sent back to)63 W 8280 61458 MT (the system of origin.)SH 8280 63850 MT (If you have SET PARITY, then 8th-bit prefixing will be requested. If the other side cannot do this,) 114 W( binary files)113 W 8280 65046 MT (cannot be transferred correctly. In all cases, Kermit-20) 262 W( will request the other Kermit to compress repeated)263 W 8280 66242 MT (characters; if the other side) 150 W( can do this \050not all Kermits know how\051 there may be a significant improvement in)149 W 8280 67438 MT (transmission speed.)SH 8280 69830 MT (If an incoming file does not arrive in its entirety, Kermit-20 will normally discard) 144 W( it; it will not appear in your)145 W 8280 71026 MT (directory. You) 394 W( may change this behavior by using the command SET INCOMPLETE KEEP, which will) 72 W( cause as)71 W ES %%Page: 242 243 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 242)SH 12 /Times-Bold AF 23887 XM (Kermit User Guide: DECSYSTEM-20 KERMIT \05012.5.1\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (much of the file as arrived to be saved in your directory.)SH 8 SS 41836 9933 MT (5)SH 10 SS 6120 10278 MT (If you are running Kermit-20 locally,) 25 W( you should already have issued a SEND command)26 W 42512 XM (to the remote Kermit, and)26 W 6120 11474 MT (then escaped back) 33 W( to DEC-20 Kermit. As files arrive, their names will be displayed on your screen, along with ")32 W /Courier SF (.)SH /Times-Roman SF (")SH 6120 12670 MT (and ")SH /Courier SF (%)SH /Times-Roman SF (" characters to indicate the packet traffic; you can type Control-A during the transfer for a brief status report.)SH 6120 15062 MT (If a file arrives that you don't really) 6 W( want, you can attempt to cancel it by typing Control-X; this sends a cancellation)7 W 6120 16258 MT (request to the remote Kermit. If) 133 W( the remote Kermit understands this request \050not all implementations of Kermit)132 W 6120 17454 MT (support this feature\051, it will comply; otherwise it) 22 W( will continue to send. If a file group is being sent, you can request)23 W 6120 18650 MT (the entire group be cancelled by typing Control-Z.)SH 13 /Times-Bold AF 23813 22009 MT (The GET Command)SH 10 /Times-Roman AF 6120 24382 MT (Syntax:)SH /Courier SF 9426 XM (GET [)SH /Times-Italic SF (remote-filespec)SH /Courier SF (])SH /Times-Roman SF 6120 26774 MT (The GET command requests a) 20 W( remote Kermit server to send the file or file group specified by)19 W /Times-Italic SF 44189 XM (remote-filespec)SH /Times-Roman SF (. This)288 W 6120 27970 MT (command can be used only when there is a Kermit server) 78 W( on the other end of the line. This means that you must)79 W 6120 29166 MT (have CONNECTed to the other system, logged in,) 103 W( run Kermit there, issued the SERVER command, and escaped)102 W 6120 30362 MT (back to the DEC-20, or else you Kermit-20 is in remote mode,) 4 W( TAKEing commands from a file, and interacting with)5 W 6120 31558 MT (a local Kermit server.)SH 6120 33950 MT (The remote filespec is any string that can be a legal file specification for the) 138 W( remote system; it is not parsed or)137 W 6120 35146 MT (validated locally. You should not put a trailing comment on the GET command, since this will) 11 W( be sent as part of the)12 W 6120 36342 MT (remote filespec.)SH 6120 38734 MT (If you need to include otherwise illegal characters such as) 71 W( ")70 W /Courier SF (!)SH /Times-Roman SF (" or ")70 W /Courier SF (;)SH /Times-Roman SF (" \050the normal command comment delimeters\051,)70 W 6120 39930 MT (")SH /Courier SF (?)SH /Times-Roman SF (" \050the command help character\051, ")35 W /Courier SF (@)SH /Times-Roman SF (" \050the indirect command file indicator\051, or certain control) 35 W( characters, then you)36 W 6120 41126 MT (should precede each such character by a Control-V. Kermit-20 will discard) 18 W( these Control-V quoting prefixes before)17 W 6120 42322 MT (sending the file specification to the remote host.)SH 6120 44714 MT (If you want to) 37 W( store the incoming file name with a different name than the remote host sends it with, just type GET)38 W 6120 45910 MT (alone on a line; Kermit-20 will prompt) 315 W( you separately for the source \050remote\051 and destination \050local\051 file)314 W 6120 47106 MT (specification. If) 378 W( more than one file arrives, only the first one) 64 W( will be stored under the name given; the rest will be)65 W 6120 48302 MT (stored under the names they are sent with. Example:)SH /Courier SF 8520 49957 MT (Kermit-20>get)SH 1800 50 14520 50157 UL 9120 50988 MT (Remote Source File: profile exec a1)SH 9000 50 21120 51188 UL 9120 52019 MT (Local Destination File: profile.exec)SH 7200 50 23520 52219 UL /Times-Roman SF 6120 54411 MT (As files arrive, their names will be displayed on) 147 W( your screen, along with ")146 W /Courier SF (.)SH /Times-Roman SF (" and ")146 W /Courier SF (%)SH /Times-Roman SF (" characters to indicate the)146 W 6120 55607 MT (packet traffic. As) 2 W( in the RECEIVE command, you may type Control-A to get a brief status report, ^X to request that)3 W 6120 56803 MT (the current incoming file be cancelled, ^Z to request that the entire incoming batch be cancelled.)SH 6120 59195 MT (If the remote Kermit) 5 W( is not capable of server functions, then you will probably get an error message back from it like)4 W 6120 60391 MT ("Illegal packet type". In this case, you must connect to the other Kermit,) 34 W( give a SEND command, escape back, and)35 W 6120 61587 MT (give a RECEIVE command.)SH 10800 50 6120 70283 UL 6 SS 6920 71691 MT (5)SH 8 /Times-Italic AF 7220 72000 MT (not)SH /Times-Roman SF 8442 XM (SERVER -- use the GET command to receive files from a Kermit server.)SH ES %%Page: 243 244 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (12.5.1. Commands for File Transfer)SH 10 /Times-Italic AF 51275 XM (Page 243)SH 46800 50 8280 5709 UL 13 /Times-Bold AF 23516 8071 MT (The STATISTICS Command)SH 10 /Times-Roman AF 8280 10444 MT (Give statistics about the most recent file transfer.) 17 W( For) 283 W( instance, here's what Kermit-20 displayed after transmitting a)16 W 8280 11640 MT (short binary file, using repeated-character compression:)SH /Courier SF 11280 13295 MT (Maximum number of characters in packet: 80 received; 80 sent)SH 11280 14326 MT (Number of characters transmitted in 2 seconds)SH 15480 15357 MT (Sent: 34) 3000 W( Overhead:) 6000 W( 34)3600 W 15480 16388 MT (Received: 107) 600 W( Overhead:) 5400 W( -408)3600 W 11880 17419 MT (Total received: 141) SH( Overhead:) 5400 W( -374)3600 W 11280 18450 MT (Total characters transmitted per second:) SH( 70)3600 W 11280 19481 MT (Effective data rate:) SH( 2570) 1200 W( baud)SH 11280 20512 MT (Efficiency: 214.1667) 6600 W( per cent)SH 11280 21543 MT (Interpacket pause in effect: 0 sec)SH 11280 23198 MT (Timeouts: 0)SH 11280 24229 MT (NAKs: 0)2400 W /Times-Roman SF 8280 26621 MT (Note that the data compression allowed the effective baud rate to) 6 W( exceed the actual speed of the communication line,)7 W 8280 27817 MT (which in this case happened to be 1200 baud. The efficiency is displayed only if the actual baud rate is known.)SH 12 /Times-Bold AF 8280 30933 MT (12.5.2. Server Operation)SH 13 SS 24709 34292 MT (The SERVER Command)SH 10 /Times-Roman AF 8280 36665 MT (The SERVER command puts a remote Kermit-20 in "server mode", so that it receives all further commands in)153 W 8280 37861 MT (packets from the local Kermit. The Kermit-20 server is capable \050as) 151 W( of this writing\051 of executing the following)152 W 8280 39057 MT (remote server commands: SEND, GET, FINISH, BYE, REMOTE DIRECTORY, REMOTE CWD, REMOTE)192 W 8280 40253 MT (SPACE, REMOTE DELETE, REMOTE TYPE, REMOTE HELP.)SH 8280 42645 MT (Any nonstandard parameters should be selected with SET commands before putting Kermit-20) 35 W( into server mode, in)36 W 8280 43841 MT (particular the) 49 W( file bytesize. The DEC-20 Kermit server can send most files in the correct manner automatically, by)48 W 8280 45037 MT (recognizing the DEC-20 file bytesize. However, if you need to ask the DEC-20 Kermit server to receive) 6 W( binary files)7 W 8280 46233 MT (from an 8-bit-byte system \050that is, from) 20 W( almost any system that's not a DEC-10 or DEC-20\051 you must issue the SET)19 W 8280 47429 MT (FILE BYTESIZE 8 command before putting it into server mode, and) 109 W( then you must only send 8-bit binary files.)110 W 8280 48625 MT (You cannot send a mixture of text files and 8-bit binary files to a Kermit-20 server.)SH 13 /Times-Bold AF 25253 51984 MT (Commands for Servers)SH 10 /Times-Roman AF 8280 54357 MT (When running in local mode, Kermit-20 allows you) 68 W( to give a wide range of commands to a remote Kermit server,)67 W 8280 55553 MT (with no guarantee the that the remote server can process them, since they are all optional) 79 W( features of the protocol.)80 W 8280 56749 MT (Commands for servers include the standard)132 W /Courier SF 26680 XM (SEND)SH /Times-Roman SF (,)SH /Courier SF 29712 XM (GET)SH /Times-Roman SF (,)SH /Courier SF 32144 XM (BYE)SH /Times-Roman SF (, and)132 W /Courier SF 36401 XM (FINISH)SH /Times-Roman SF 40382 XM (commands, as well as the)131 W /Courier SF 51480 XM (REMOTE)SH /Times-Roman SF 8280 57945 MT (command.)SH 8280 60337 MT (These commands are generally issued when Kermit-20) 47 W( is in local mode, i.e. you have already connected to another)48 W 8280 61533 MT (system, run Kermit there and put it into server mode, and escaped back to) 110 W( Kermit-20. However, Kermit-20 also)109 W 8280 62729 MT (allows you to operate in the opposite direction, i.e. Kermit-20 is the remote Kermit, and) 15 W( the local Kermit is in server)16 W 8280 63925 MT (mode. This) 479 W( is handy when, for instance, you want to transfer a disparate collection of files that can't be readily)114 W 8280 65121 MT (specified by a wildcard group, all in a single, unattended operation.) 40 W( In) 332 W( this case, you can create a TAKE command)41 W 8280 66317 MT (file for Kermit-20 that SENDs and/or GETs the desired files, and then shuts down local server when done, e.g.:)SH /Courier SF 10680 67972 MT (set delay 0) SH( ;) 7200 W( No need to pause before sending)SH 10680 69003 MT (; Connect to own directory, leave a blank line for password.)SH 10680 70034 MT (cwd me:)SH 10680 71689 MT (log transactions) SH( ;) 4200 W( Keep a log)SH ES %%Page: 244 245 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 244)SH 12 /Times-Bold AF 23887 XM (Kermit User Guide: DECSYSTEM-20 KERMIT \05012.5.2\051)SH 46800 50 6120 5709 UL 10 /Courier AF 8520 7824 MT (; Change directories on the PC.)SH 8520 8855 MT (remote cwd \134kermit)SH 8520 10510 MT (send ker:mskerm.doc) SH( ;) 2400 W( Send the MS-DOS Kermit manual)SH 8520 11541 MT (send ker:mskerm.bwr) SH( ;) 2400 W( Send the MS-DOS Kermit "beware file")SH 8520 12572 MT (; Now change to the MS-DOS binaries area)SH 8520 13603 MT (remote cwd \134bin)SH 8520 15258 MT (send kb:msvibm.exe) SH( ;) 3000 W( Send the executable DOS Kermit program)SH 8520 16289 MT (; Put DOS back in default directory)SH 8520 17320 MT (remote cwd \134chris)SH 8520 18975 MT (; Connect back to default directory on the DEC-20)SH 8520 20006 MT (cwd me:)SH 8520 21661 MT (close transactions) SH( ;) 3000 W( Close transaction log)SH 8520 22692 MT (send transaction.log) SH( ;) 1800 W( Send it)SH 8520 23723 MT (finish ;) 10200 W( Shut down DOS Kermit server)SH /Times-Roman SF 6120 25440 MT (Commands to servers) 38 W( \050GET, BYE, FINISH, REMOTE\051 can be issued from a remote Kermit-20 only by means of a)37 W 6120 26636 MT (TAKE file. When Kermit-20 is local \050i.e. after SET LINE\051, you can issue these commands interactively as well.)SH 12 /Times-Bold AF 6120 29224 MT (The REMOTE Command)SH 10 /Times-Roman AF 6120 30638 MT (Send the specified command to the remote server. If the server does not understand the command) 136 W( \050all of these)137 W 6120 31834 MT (commands are optional features of the Kermit protocol\051, it will reply with) 50 W( a message like "Unknown Kermit server)49 W 6120 33030 MT (command". If) 656 W( does understand, it will send the results back, and they will be displayed) 203 W( on the screen. The)204 W 6120 34226 MT (REMOTE commands are:)SH 6120 36017 MT (CWD [)SH /Times-Italic SF (directory)SH /Times-Roman SF (])SH 14120 XM (Change Working Directory. If no directory) 160 W( name is provided, the server will change to the)159 W 14120 37122 MT (default or home directory. Otherwise, you will be prompted for a) 38 W( password, and the server will)39 W 14120 38227 MT (attempt to change to the specified directory. The) 117 W( password is entered on a separate line, and)116 W 14120 39332 MT (does not echo as you type it. If access is not granted, the server will provide a message to that)57 W 14120 40437 MT (effect. Do) 250 W( not put trailing comments after a REMOTE CWD command, or after the password.)SH 6120 42014 MT (DELETE)SH /Times-Italic SF 10147 XM (filespec)SH /Times-Roman SF 14120 XM (Delete the specified file or files. The names of the) 121 W( files that are deleted will appear on your)120 W 14120 43119 MT (screen.)SH 6120 44696 MT (DIRECTORY [)SH /Times-Italic SF (filespec)SH /Times-Roman SF (])SH 14120 45801 MT (The names of the files that match the given) 70 W( file specification will be displayed on your screen,)69 W 14120 46906 MT (perhaps along with size and date information for each file. If no file specification is given, all)72 W 14120 48011 MT (files from the current directory will be listed.)SH 6120 49588 MT (HELP)SH 14120 XM (Provide a list of the functions that are available from the server.)SH 6120 51165 MT (HOST [)SH /Times-Italic SF (command)SH /Times-Roman SF (])SH 14120 XM (Pass the) 191 W( given command to the server's host command processor, and display the resulting)190 W 14120 52270 MT (output on your screen.)SH 6120 53847 MT (SPACE)SH 14120 XM (Provide information about disk) 156 W( usage in the current directory, such as the quota, the current)157 W 14120 54952 MT (storage, the amount of remaining free space.)SH 6120 56529 MT (TYPE)SH /Times-Italic SF 8870 XM (filespec)SH /Times-Roman SF 14120 XM (Display the contents of the specified file on your screen.)SH 12 /Times-Bold AF 6120 59645 MT (12.5.3. Commands for Local File Management)SH 10 /Times-Roman AF 6120 61587 MT (Syntax:)SH /Courier SF 9426 XM (LOCAL [)SH /Times-Italic SF (command)SH /Courier SF (])SH /Times-Roman SF 6120 63979 MT (Execute the specified command on the local system -- on the DEC-20) 257 W( where Kermit-20 is running. These)256 W 6120 65175 MT (commands provide some local file management capability without having to leave the Kermit-20 program.)SH 6120 66966 MT (CWD [)SH /Times-Italic SF (directory)SH /Times-Roman SF (])SH 14120 XM (Change working directory, or, in DEC-20 terminology,) 8 W( CONNECT to the specified directory. If)9 W 14120 68071 MT (a password is) 63 W( required, you will be prompted for one. Do not include a trailing comment after)62 W 14120 69176 MT (the password.)SH 6120 70753 MT (DELETE)SH /Times-Italic SF 10147 XM (filespec)SH /Times-Roman SF 14120 XM (Delete the specified file or files, but do not expunge them \050unless you have SET) 124 W( EXPUNGE)125 W 14120 71858 MT (ON\051.)SH ES %%Page: 245 246 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (12.5.3. Commands for Local File Management)SH 10 /Times-Italic AF 51275 XM (Page 245)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (DIRECTORY [)SH /Times-Italic SF (filespec)SH /Times-Roman SF (])SH 16280 8991 MT (Provide a directory listing of the specified files.)SH 8280 10568 MT (RUN [)SH /Times-Italic SF (filespec)SH /Times-Roman SF (])SH 16280 XM (Attempts to run the specified file, which must be in ")231 W /Courier SF (.EXE)SH /Times-Roman SF (" format \050)231 W /Courier SF (.EXE)SH /Times-Roman SF 49452 XM (is the default)231 W 16280 11673 MT (filetype\051, in an inferior fork. Control) 47 W( returns to Kermit-20 when the program terminates. Once)46 W 16280 12778 MT (you have used this command, you can restart the same program) 120 W( by issuing a RUN command)121 W 16280 13883 MT (with no arguments. If you RUN)186 W /Courier SF 30803 XM (SYSTEM:EXEC)SH /Times-Roman SF (, then you will) 186 W( be able to issue TOPS-20)185 W 16280 14988 MT (commands without leaving Kermit; you can get back to Kermit from the EXEC by) 96 W( typing the)97 W 16280 16093 MT (EXEC POP command.)SH 8280 17670 MT (SPACE)SH 16280 XM (Show how much space is used and remaining in the current directory.)SH 8280 19247 MT (TYPE)SH 16280 XM (Display the contents of the specified file or files at your terminal. This works like) 54 W( the DEC-20)53 W 16280 20352 MT (TYPE command, except that if a file has a bytesize of) 72 W( 8, Kermit-20 will do 8-bit input from it)73 W 16280 21457 MT (rather than 7-bit. Also, the DEC-20 Control-O command) 161 W( discards output only from the file)160 W 16280 22562 MT (currently being displayed; if multiple files are being typed, then) 5 W( output will resume with the next)6 W 16280 23667 MT (file.)SH 8280 26059 MT (The LOCAL commands may also be used without the "LOCAL" prefix.)SH 12 /Times-Bold AF 8280 29175 MT (12.5.4. The CONNECT Command)SH 10 /Times-Roman AF 8280 31117 MT (Syntax:)SH /Courier SF 11586 XM (CONNECT [)SH /Times-Italic SF (number)SH /Courier SF (])SH /Times-Roman SF 8280 33509 MT (Establish a terminal connection to the system connected to the octal) 144 W( TTY number specified here or in the most)143 W 8280 34705 MT (recent SET LINE command, using full duplex echoing and no parity unless otherwise specified in previous) 118 W( SET)119 W 8280 35901 MT (commands. Get) 334 W( back to Kermit-20) 42 W( by typing the escape character followed by the letter C. The escape character is)41 W 8280 37097 MT (Control-Backslash \050)127 W /Courier SF (^\134)SH /Times-Roman SF (\051 by default. When you type the escape character, several single-character) 127 W( commands are)128 W 8280 38293 MT (possible:)SH /Courier SF 9280 40084 MT (C)SH /Times-Roman SF 11280 XM (Close the connection and return to Kermit-20.)SH /Courier SF 9280 41189 MT (S)SH /Times-Roman SF 11280 XM (Show status of the connection; equivalent to SHOW LINE.)SH /Courier SF 9280 42294 MT (P)SH /Times-Roman SF 11280 XM (Push to a new Exec. POP from the Exec to get back to the connection.)SH /Courier SF 9280 43399 MT (Q)SH /Times-Roman SF 11280 XM (If a session log is active, temporarily Quit logging.)SH /Courier SF 9280 44504 MT (R)SH /Times-Roman SF 11280 XM (Resume logging to the session log.)SH /Courier SF 9280 45609 MT (B)SH /Times-Roman SF 11280 XM (Send a simulated BREAK signal.)SH /Courier SF 9280 46714 MT (?)SH /Times-Roman SF 11280 XM (List all the possible single-character arguments.)SH /Courier SF 9280 47819 MT (^\134)SH /Times-Roman SF 10730 XM (\050or whatever you have set the escape character to be\051:)SH 11280 48924 MT (Typing the escape character twice sends one copy of it to the connected host.)SH 8280 50715 MT (You can use the SET) 37 W( ESCAPE command to define a different escape character, and SET PARITY, SET DUPLEX,)38 W 8280 51911 MT (SET HANDSHAKE, SET FLOW, and SET SPEED) 101 W( to change those communication-line-oriented parameters. In)100 W 8280 53107 MT (order for the simulated BREAK signal to work, TOPS-20 must know the speed of the terminal. If it) 54 W( does not, you)55 W 8280 54303 MT (may use the SET SPEED command.) 268 W( Type) 785 W( the SHOW LINE command for information about your current)267 W 8280 55499 MT (communication settings.)SH 8280 57891 MT (Kermit-20 does not have) 18 W( any special autodialer interface. It assumes that the connection has already been made and)19 W 8280 59087 MT (the line assigned.)SH 12 /Times-Bold AF 8280 62203 MT (12.5.5. The SET, SHOW, and DEFINE Commands)SH 10 /Times-Roman AF 8280 64145 MT (SET is used for establishing or changing parameters, DEFINE) 12 W( lets you group several SET commands together into a)11 W 8280 65341 MT (single "macro" command, and SHOW lets you examine current settings or macro definitions.)SH ES %%Page: 246 247 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 246)SH 12 /Times-Bold AF 23887 XM (Kermit User Guide: DECSYSTEM-20 KERMIT \05012.5.5\051)SH 46800 50 6120 5709 UL 13 SS 23957 8071 MT (The SET Command)SH 10 /Times-Roman AF 6120 10444 MT (Syntax:)SH /Courier SF 9426 XM (SET)SH /Times-Italic SF 11826 XM (parameter)SH /Courier SF 16592 XM ([)SH /Times-Italic SF (option)SH /Courier SF 20348 XM ([)SH /Times-Italic SF (value)SH /Courier SF (]])SH /Times-Roman SF 6120 12836 MT (Establish or modify various parameters for file transfer) 47 W( or terminal connection. You can examine their values with)48 W 6120 14032 MT (the SHOW command. The following parameters may be SET:)SH 17131 15642 MT (BREAK)SH 21020 XM (Adjust the BREAK simulation parameter)SH 13409 16747 MT (BLOCK-CHECK)SH 21020 XM (Packet transmission error detection method)SH 14577 17852 MT (DEBUGGING)SH 21020 XM (Record or display state transitions or packets)SH 17132 18957 MT (DELAY)SH 21020 XM (How long to wait before starting to send)SH 16576 20062 MT (DUPLEX)SH 21020 XM (For terminal connection, FULL or HALF)SH 16797 21167 MT (ESCAPE)SH 21020 XM (Character for terminal connection)SH 18409 22272 MT (FILE)SH 21020 XM (For setting file parameters like byte size)SH 12632 23377 MT (FLOW-CONTROL)SH 21020 XM (For enabling or disabling XON/XOFF flow control)SH 14299 24482 MT (HANDSHAKE)SH 21020 XM (For turning around half duplex communication line)SH 18631 25587 MT (IBM)SH 21020 XM (For communicating with an IBM mainframe)SH 14187 26692 MT (INCOMPLETE)SH 21020 XM (What to do with an incomplete file)SH 17576 27797 MT (INPUT)SH 21020 XM (For specifying behavior of the INPUT command)SH 14854 28902 MT (ITS-BINARY)SH 21020 XM (For recognizing a special 8-bit binary file format)SH 18243 30007 MT (LINE)SH 21020 XM (TTY line to use for file transfer or CONNECT)SH 16909 31112 MT (PARITY)SH 21020 XM (Character parity to use)SH 16519 32217 MT (PROMPT)SH 21020 XM (Change the program's command prompt)SH 16298 33322 MT (RECEIVE)SH 21020 XM (Various parameters for receiving files)SH 17242 34427 MT (RETRY)SH 21020 XM (How many times to retry a packet before giving up)SH 17909 35532 MT (SEND)SH 21020 XM (Various parameters for sending files)SH 17464 36637 MT (SPEED)SH 21020 XM (Baud rate of communication line)SH 14410 37742 MT (TVT-BINARY)SH 21020 XM (For negotiating binary mode on ARPANET)SH 6120 40134 MT (The DEFINE command may be used to compose "macros") 64 W( by combining SET commands. Those SET commands)63 W 6120 41330 MT (which differ from the "ideal" Kermit are now described in detail.)SH 12 /Times-Bold AF 6120 43918 MT (SET BREAK)SH 10 /Times-Roman AF 6120 45332 MT (Syntax:)SH /Courier SF 9580 XM (SET BREAK)154 W /Times-Italic SF 15888 XM (n)SH /Times-Roman SF 16792 XM (Specify the number of nulls to be sent at 50 baud to simulate a BREAK signal when)154 W 6120 46528 MT (connected to a remote host via SET LINE and CONNECT.)SH 12 /Times-Bold AF 6120 49116 MT (SET DEBUG)SH 10 /Times-Roman AF 6120 50530 MT (Syntax:)SH /Courier SF 9426 XM (SET DEBUG)SH /Times-Italic SF 15426 XM (options)SH /Times-Roman SF 6120 52922 MT (Record the packet traffic, either on your terminal or in a file. Some reasons for doing this would be to debug a)115 W 6120 54118 MT (version of Kermit that you are working on, to record a transaction in which an error occurred) 104 W( for evidence when)105 W 6120 55314 MT (reporting bugs, or simply to vary the display you get when running Kermit-20 in local mode. Options are:)SH 6120 57105 MT (STATES)SH 14120 XM (Show Kermit state transitions and packet numbers \050brief\051.)SH 6120 58682 MT (PACKETS)SH 14120 XM (Display each incoming and outgoing packet \050lengthy\051.)SH 6120 60259 MT (OFF)SH 14120 XM (Don't display or record debugging information \050this is the normal mode\051.) 65 W( If) 379 W( debugging was in)64 W 14120 61364 MT (effect, turn it off and close any log file.)SH 6120 63155 MT (The debugging information is recorded in the file specified by the most recent LOG DEBUGGING) 176 W( command,)177 W /Courier SF 6120 64351 MT (DEBUGGING.LOG)SH /Times-Roman SF 14170 XM (by default.)SH ES %%Page: 247 248 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (12.5.5. The SET, SHOW, and DEFINE Commands)SH 10 /Times-Italic AF 51275 XM (Page 247)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (SET ESCAPE)SH 10 /Courier AF 8280 9416 MT (SET ESCAPE)SH /Times-Italic SF 14880 XM (octal-number)SH /Times-Roman SF 8280 11808 MT (Specify the control character you want to use to) 45 W( "escape" from remote connections back to Kermit-20. The default)44 W 8280 13004 MT (is 34 \050Control-\134\051. The number is the octal value of the ASCII control character, 1) 71 W( to 37 \050or 177\051, for instance 2 is)72 W 8280 14200 MT (Control-B. After) 466 W( you type the escape character, you must follow it by) 108 W( a one of the single-character "arguments")107 W 8280 15396 MT (described under the CONNECT command, above.)SH 12 /Times-Bold AF 8280 17984 MT (SET EXPUNGE)SH 10 /Courier AF 8280 19396 MT (SET EXPUNGE ON)SH /Times-Italic SF 17280 XM (or)SH /Courier SF 18769 XM (OFF)SH /Times-Roman SF 8280 21788 MT (Tell whether you want a DELETE command \050either) 170 W( the LOCAL DELETE command or a REMOTE DELETE)171 W 8280 22984 MT (command sent to a Kermit-20 server\051 to expunge files as it deletes them. On) 11 W( the DEC-20, a deleted file continues to)10 W 8280 24180 MT (take up space, and may be "undeleted" at a later time in) 133 W( the same session. To expunge a deleted file means to)134 W 8280 25376 MT (remove it completely and irrevocably, freeing its space for further use. EXPUNGE is OFF by) 42 W( default; deleted files)41 W 8280 26572 MT (are not automatically expunged. SET EXPUNGE applies only to files that are deleted) 39 W( explicitly by Kermit-20, and)40 W 8280 27768 MT (not to files that are implicitly deleted when new generations of existing files are created.)SH 12 /Times-Bold AF 8280 30356 MT (SET FILE)SH 10 /Times-Roman AF 8280 31770 MT (Syntax:)SH /Courier SF 11586 XM (SET FILE)SH /Times-Italic SF 16986 XM (parameter keyword)SH /Times-Roman SF 8280 34162 MT (Establish file-related parameters:)SH 8280 35953 MT (BYTESIZE)SH /Times-Italic SF 13252 XM (keyword or number)SH /Times-Roman SF 12280 37058 MT (Byte size for DEC-20 file input/output. The choices are SEVEN \0507\051, EIGHT \0508\051, and AUTO.)SH 12280 38849 MT (SEVEN)SH 16280 XM (\050or 7\051 Always store or retrieve five 7-bit bytes per word. When sending a) 91 W( file, ignore the file)92 W 16280 39954 MT (bytesize and do 7-bit input from the file.) 40 W( There) 329 W( would be no reason to use this option except to)39 W 16280 41059 MT (explicitly force an 8-bit file to be treated as a 7-bit file.)SH 12280 42636 MT (EIGHT)SH 16280 XM (\050or 8\051 Always store or retrieve four 8-bit bytes per word. When sending a file, ignore the) 85 W( file)86 W 16280 43741 MT (bytesize and do 8-bit input from the file. This command is necessary) 128 W( when receiving binary)127 W 16280 44846 MT (files from 8-bit-byte systems, such as most microcomputers.)SH 12280 46423 MT (AUTO)SH 16280 XM (Equivalent to SEVEN for incoming files, and for outgoing files means to use EIGHT if the)161 W 16280 47528 MT (DEC-20 file bytesize \050as shown by the Exec VDIR command\051) 30 W( is 8, otherwise use SEVEN. The)29 W 16280 48633 MT (default is AUTO.)SH 12280 50424 MT (The DEC-20 can send any mixture of) 33 W( file types in the correct way automatically, but you)34 W /Times-Italic SF 48673 XM (must)SH /Times-Roman SF 50846 XM (set the file)34 W 12280 51529 MT (bytesize to 8 for any incoming 8-bit binary files, and to AUTO) 151 W( \050i.e. 7\051 for any incoming text files or)150 W 12280 52634 MT (DEC-20 binary files.)SH 8280 54211 MT (NAMING UNTRANSLATED)SH /Times-Italic SF 20889 XM (or)SH /Times-Roman SF 22028 XM (NORMAL-FORM)SH 12280 55316 MT (If NORMAL-FORM the names of incoming or outgoing files will) 30 W( be converted to contain only uppercase)29 W 12280 56421 MT (letters, digits, and at most one period; any other characters will be translated to) 512 W( ")513 W /Courier SF (X)SH /Times-Roman SF (". If)1276 W 12280 57526 MT (UNTRANSLATED, filenames will be sent and used literally. UNTRANSLATED is the default.)SH 12 /Times-Bold AF 8280 60114 MT (SET IBM)SH 10 /Times-Roman AF 8280 61528 MT (Syntax:)SH /Courier SF 11586 XM (SET IBM ON)SH /Times-Italic SF 18186 XM (or)SH /Courier SF 19675 XM (OFF)SH /Times-Roman SF 8280 63920 MT (SET IBM is really a predefined SET macro rather than a "hardwired") 213 W( SET command; it can be redefined or)212 W 8280 65116 MT (undefined \050see DEFINE\051; as distributed from Columbia, Kermit-20 defines IBM) 167 W( to be "parity mark, handshake)168 W 8280 66312 MT (XON, duplex half".)SH 8280 68704 MT (SET IBM should be used when running Kermit-20 in) 2 W( local mode, connected to an IBM or similar mainframe. If you)1 W 8280 69900 MT (have redefined the SET IBM macro, then your parameters will be used instead.)SH ES %%Page: 248 249 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 248)SH 12 /Times-Bold AF 23887 XM (Kermit User Guide: DECSYSTEM-20 KERMIT \05012.5.5\051)SH 46800 50 6120 5709 UL 6120 8004 MT (SET ITS-BINARY)SH 10 /Times-Roman AF 6120 9418 MT (Syntax:)SH /Courier SF 9426 XM (SET ITS-BINARY ON)SH /Times-Italic SF 20226 XM (or)SH /Courier SF 21715 XM (OFF)SH /Times-Roman SF 6120 11810 MT (Specify whether ITS-Binary file headers are to be recognized or ignored. By default, they are recognized. ITS)130 W 6120 13006 MT (binary format is a way \050devised at MIT\051 of storing foreign 8-bit binary) 38 W( data on a 36-bit machine to allow automatic)37 W 6120 14202 MT (recognition of these files when sending them out) 41 W( again, so that you don't have to depend on the file byte size, or to)42 W 6120 15398 MT (issue explicit SET FILE BYTESIZE commands to Kermit.)SH 6120 17790 MT (An ITS format binary file contains the) 304 W( sixbit characters "DSK8" left-adjusted in the first 36-bit word. If)303 W 6120 18986 MT (ITS-BINARY is ON, then Kermit-20 will send) 65 W( any file starting with this "header word" using 8-bit input from the)66 W 6120 20182 MT (file even) 179 W( if the file bytesize is not 8, and will not send the header word itself. Kermit-20 will also store any)178 W 6120 21378 MT (incoming file that begins with that header word using 8-bit bytesize, again discarding the header word) 128 W( itself. If)129 W 6120 22574 MT (ITS-BINARY is OFF, then the header word, if) 60 W( any, will be sent or kept, and i/o will be according to the setting of)59 W 6120 23770 MT (FILE BYTESIZE.)SH 6120 26162 MT (This facility is provided for compatibility with the file formats used on certain public-access CP/M libraries.)SH 12 /Times-Bold AF 6120 28750 MT (SET INPUT)SH 10 /Times-Roman AF 6120 30164 MT (Syntax:)SH /Courier SF 9426 XM (SET INPUT)SH /Times-Italic SF 15426 XM (parameter value)SH /Times-Roman SF 6120 32556 MT (The INPUT) 116 W( command is used in TAKE command files or DEC-20 Batch control files as part of the login script)117 W 6120 33752 MT (facility, which is explained in greater detail later. SET INPUT controls) 40 W( the behavior of the INPUT command. The)39 W 6120 34948 MT (parameters are as follows:)SH 6120 36739 MT (SET INPUT DEFAULT-TIMEOUT)SH /Times-Italic SF 20979 XM (n)SH 10120 37844 MT (n)SH /Times-Roman SF 10972 XM (is the number of seconds for an INPUT command to time out after not receiving the) 102 W( requested input,)101 W 10120 38949 MT (when no interval is explicitly given in the INPUT command. For instance, if the) 52 W( default timeout interval)53 W 10120 40054 MT (is 10 seconds, then the command)SH /Courier SF 12520 41709 MT (INPUT login:)SH /Times-Roman SF 10120 43426 MT (will look for the ")8 W /Courier SF (login:)SH /Times-Roman SF (" prompt for 10 seconds. The default may be) 8 W( overriden by including an explicit)7 W 10120 44531 MT (interval in the INPUT command:)SH /Courier SF 12520 46186 MT (INPUT 15 login:)SH /Times-Roman SF 10120 47903 MT (The default timeout interval is 5 seconds.)SH 6120 49480 MT (SET INPUT TIMEOUT-ACTION PROCEED)SH /Times-Italic SF 25007 XM (or)SH /Times-Roman SF 26146 XM (QUIT)SH 10120 50585 MT (If the INPUT command comes from a Kermit-20 command file \050see TAKE command\051 or a TOPS-20)152 W 10120 51690 MT (Batch control file, then use this command) 179 W( to specify whether processing of the command file should)180 W 10120 52795 MT (proceed or quit after a timeout occurs. For TAKE files, the current command file is) 180 W( terminated and)179 W 10120 53900 MT (control returns to the invoking level \050Kermit-20 prompt level, or a superior TAKE file\051. The default)165 W 10120 55005 MT (action is PROCEED.)SH 6120 56582 MT (SET INPUT CASE IGNORE)SH /Times-Italic SF 18175 XM (or)SH /Times-Roman SF 19314 XM (OBSERVE)SH 10120 57687 MT (Specify whether alphabetic case should be) 129 W( ignored \050"a" matches "A"\051 or observed \050"a" does not match)130 W 10120 58792 MT ("A"\051 when scanning the input for the specified search string. By default, aphabetic case is ignored.)SH 6120 60583 MT (SET INPUT commands are "global"; the settings) 89 W( are not "pushed" and "popped" when entering or leaving TAKE)88 W 6120 61779 MT (command files.)SH ES %%Page: 249 250 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (12.5.5. The SET, SHOW, and DEFINE Commands)SH 10 /Times-Italic AF 51275 XM (Page 249)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (SET LINE)SH 10 /Times-Roman AF 8280 9418 MT (Syntax:)SH /Courier SF 11586 XM (SET LINE [)SH /Times-Italic SF (octal-number)SH /Courier SF (])SH /Times-Roman SF 8280 11810 MT (Specify the octal TTY number to use for file transfer or CONNECT. If you) 165 W( issue this command, you will be)166 W 8280 13006 MT (running Kermit-20)18 W /Times-Italic SF 16093 XM (locally)SH /Times-Roman SF (, and) 18 W( you must log in to the remote system and run Kermit on that side in order to transfer)17 W 8280 14202 MT (a file. If you don't issue this command, Kermit-20 assumes it) 94 W( is running)95 W /Times-Italic SF 38875 XM (remotely)SH /Times-Roman SF (, and does file transfer over its)95 W 8280 15398 MT (job's controlling terminal line. You can also select the line directly in the CONNECT command; the command)SH /Courier SF 10680 17053 MT (CONNECT 12)SH /Times-Roman SF 8280 18770 MT (is equivalent to)SH /Courier SF 10680 20425 MT (SET LINE 12)SH 10680 21456 MT (CONNECT)SH /Times-Roman SF 8280 23848 MT (If you type SET LINE with no number argument, you will deassign any previous assigned) 31 W( line and revert to remote)30 W 8280 25044 MT (mode.)SH 8280 27436 MT (The SHOW LINE command will display the currently selected) 71 W( communication line and its charactistics, including)72 W 8280 28632 MT (parity, duplex, handshake, flow) 68 W( control, the speed if known, whether carrier is present \050if it is a modem-controlled)67 W 8280 29828 MT (line\051, and whether Kermit-20 is in local or remote mode.)SH 12 /Times-Bold AF 8280 32416 MT (SET RECEIVE)SH 10 /Times-Roman AF 8280 33830 MT (In addition to the full complement of SET RECEIVE commands described in) 140 W( the main part of the Kermit User)141 W 8280 35026 MT (Guide, you may also SET RECEIVE SERVER-TIMEOUT to a value) 36 W( between 0 and 94. This specifies the number)35 W 8280 36222 MT (of seconds between timeouts during server command wait, 0 specifies that no timeouts should occur during server)73 W 8280 37418 MT (command wait. When a Kermit server times out, it sends a NAK packet. Some systems cannot) 142 W( clear piled-up)141 W 8280 38614 MT (NAKs from their input buffers; if you're using such a system) 120 W( to communicate with a Kermit-20 server, and you)121 W 8280 39810 MT (expect to be leaving) 187 W( the server idle for long periods of time, you should use this command to turn off server)186 W 8280 41006 MT (command-wait timeouts.)SH 12 /Times-Bold AF 8280 43594 MT (SET SPEED)SH 10 /Times-Roman AF 8280 45008 MT (Syntax:)SH /Courier SF 11586 XM (SET SPEED)SH /Times-Italic SF 17586 XM (n)SH /Times-Roman SF 8280 47400 MT (Set the baud rate of the currently) 36 W( selected communication to)37 W /Times-Italic SF 32973 XM (n)SH /Times-Roman SF (, the decimal baud rate, for instance 300, 1200, 4800.)37 W 8280 48596 MT (When operating in local mode, it may be necessary to issue this command in order to enable BREAK simulation.)SH 12 /Times-Bold AF 8280 51184 MT (SET TVT-BINARY)SH 10 /Times-Roman AF 8280 52598 MT (Syntax:)SH /Courier SF 11586 XM (SET TVT-BINARY ON)SH /Times-Italic SF 22036 XM (or)SH /Courier SF 23175 XM (OFF)SH /Times-Roman SF 8280 54990 MT (Only for users) 105 W( running Kermit-20 on an ARPANET DEC-20, signed on to an ARPANET virtual terminal \050TVT\051)104 W 8280 56186 MT (from another host or through an ARPANET TAC. SET TVT ON) 12 W( causes Kermit-20 to negotiate binary mode \0508-bit\051)13 W 8280 57382 MT (communication with the ARPANET during file transfer. Without this command, file transfer through a TVT would)26 W 8280 58578 MT (not work in most cases.)SH 8280 60970 MT (TVT-BINARY is OFF by default. If you normally use Kermit-20 through the) 32 W( ARPAnet, you can put the command)33 W 8280 62166 MT (SET TVT-BINARY ON into your)SH /Courier SF 22251 XM (KERMIT.INI)SH /Times-Roman SF 28501 XM (file.)SH /Times-Italic SF 8280 64558 MT (CAUTION)SH /Times-Roman SF (: This facility) 46 W( requires certain features in the Release 5 TOPS-20 ARPANET monitor, which may not be)45 W 8280 65754 MT (present in releases distributed by DEC. See the Kermit-20 source code for details.)SH ES %%Page: 250 251 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 250)SH 12 /Times-Bold AF 23887 XM (Kermit User Guide: DECSYSTEM-20 KERMIT \05012.5.5\051)SH 46800 50 6120 5709 UL 13 SS 22730 8071 MT (The DEFINE Command)SH 10 /Times-Roman AF 6120 10444 MT (Syntax:)SH /Courier SF 9426 XM (DEFINE)SH /Times-Italic SF 13626 XM (macroname)SH /Courier SF 18947 XM ([)SH /Times-Italic SF (set-option)SH /Courier SF 24147 XM ([,)SH /Times-Italic SF 25947 XM (set-option)SH /Courier SF 30547 XM ([...]]])SH /Times-Roman SF 6120 12836 MT (The DEFINE command is available in Kermit-20 for building "macros" of SET commands. The macro) 4 W( name can be)5 W 6120 14032 MT (any keyword-style character string, and the set options are anything you) 53 W( would type after SET in a SET command;)52 W 6120 15228 MT (several set options may be strung together, separated by commas. Example:)SH /Courier SF 8520 16883 MT (define notimeout send timeout 0, receive timeout 0, receive server 0)SH /Times-Roman SF 6120 18600 MT (Macro definitions may not include macro names. You can list all your macros and their definitions with the SHOW)19 W 6120 19796 MT (MACROS command. You can list a particular macro definition with HELP SET)SH /Times-Italic SF 38840 XM (macroname)SH /Times-Roman SF (.)SH 13 /Times-Bold AF 23163 23155 MT (The SHOW Command)SH 10 /Times-Roman AF 6120 25528 MT (Syntax:)SH /Courier SF 9426 XM (SHOW)SH /Times-Roman SF 12076 XM ([)SH /Times-Italic SF (option)SH /Times-Roman SF (])SH 6120 27920 MT (The SHOW command displays various information:)SH 6120 29711 MT (DAYTIME)SH 14120 XM (Current date, time, phase of moon.)SH 6120 31369 MT (DEBUGGING)SH 14120 XM (Debugging mode in effect, if any.)SH 6120 33027 MT (FILE-INFO)SH 14120 XM (Byte size for DEC-20 file i/o, incomplete file disposition.)SH 6120 34685 MT (INPUT)SH 14120 XM (INPUT command parameters.)SH 6120 36343 MT (LINE)SH 14120 XM (TTY line, parity, duplex, flow control, handshake, escape character, speed \050if known\051,) 218 W( and)217 W 14120 37448 MT (session loggin) 12 W( information. Note that before release 6.0 of TOPS-20, the DEC-20 does not keep)13 W 14120 38553 MT (a record of the actual baud rate of a modem-controlled or "remote" TTY line.)SH 6120 40211 MT (MACROS)SH 14120 XM (Definitions for SET macros.)SH 6120 41869 MT (PACKET-INFO)SH 14120 XM (For incoming and outbound packets.) 232 W( Items) 713 W( under RECEIVE column show parameters for)231 W 14120 42974 MT (packets Kermit-20 expects to receive, under SEND shows parameters for outgoing packets.)SH 6120 44632 MT (TIMING-INFO)SH 14120 XM (Delays, retries, server NAK intervals.)SH 6120 46290 MT (VERSION)SH 14120 XM (Program version of Kermit-20. This is also displayed when Kermit-20 is initially started.)SH 6120 47948 MT (ALL)SH 14120 XM (\050default\051 All of the above.)SH 12 /Times-Bold AF 6120 51064 MT (12.5.6. Program Management Commands)SH 13 SS 23344 54423 MT (The TAKE Command)SH 10 /Times-Roman AF 6120 56796 MT (Syntax:)SH /Courier SF 9426 XM (TAKE)SH /Times-Italic SF 12426 XM (filespec)SH /Times-Roman SF 6120 59188 MT (Execute Kermit-20 commands) 1 W( from the specified file. The file may contain contain any valid Kermit-20 commands,)2 W 6120 60384 MT (including other TAKE commands; command files may be nested up to a depth of 20.) 142 W( Default) 532 W( file type for the)141 W 6120 61580 MT (command file is)23 W /Courier SF 12883 XM (.CMD)SH /Times-Roman SF (. Most) 296 W( commands) 23 W( may have trailing comments, beginning by semicolon, but these should be)24 W 6120 62776 MT (avoided in REMOTE commands, GET) 249 W( commands, and the passwords that are prompted for after CWD and)248 W 6120 63972 MT (REMOTE CWD commands.)SH ES %%Page: 251 252 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (12.5.6. Program Management Commands)SH 10 /Times-Italic AF 51275 XM (Page 251)SH 46800 50 8280 5709 UL 13 /Times-Bold AF 25432 8071 MT (The ECHO Command)SH 10 /Times-Roman AF 8280 10444 MT (Syntax:)SH /Courier SF 11586 XM (ECHO)SH /Times-Italic SF 14236 XM (line of text)SH /Times-Roman SF 8280 12836 MT (The line of text is echoed at the terminal. This is) 63 W( useful when issued from within TAKE command files, to report)64 W 8280 14032 MT (progress or issue instructions.)SH 13 /Times-Bold AF 25576 17391 MT (The HELP Command)SH 10 /Times-Roman AF 8280 19764 MT (Syntax:)SH /Courier SF 11586 XM (HELP [)SH /Times-Italic SF (topic)SH /Courier SF 17786 XM ([)SH /Times-Italic SF (subtopic)SH /Courier SF (]])SH /Times-Roman SF 8280 22156 MT (Typing HELP alone prints a brief summary of Kermit-20 and its commands. You can also type)SH /Courier SF 10680 23871 MT (HELP)SH /Times-Italic SF 13680 XM (command)SH /Times-Roman SF 8280 25588 MT (for any Kermit-20 command, e.g. "help send" or "help set) 55 W( parity" to get more detailed information about a specific)54 W 8280 26784 MT (command. Type)250 W /Courier SF 10680 28439 MT (HELP ?)SH /Times-Roman SF 8280 30156 MT (to see a list of the available help commands.)SH 13 /Times-Bold AF 22469 33515 MT (The EXIT and QUIT Commands)SH 10 /Times-Roman AF 8280 35888 MT (Syntax:)SH /Courier SF 11586 XM (EXIT)SH /Times-Roman SF 8280 38280 MT (Exit from Kermit-20. You can) 6 W( CONTINUE the program from the TOPS-20 Exec, provided you haven't run another)7 W 8280 39476 MT (program on top of it.) 8 W( You) 265 W( can also exit from Kermit-20 by typing one or more control-C's, even if it's in the middle)7 W 8280 40672 MT (of transferring) 56 W( a file. Kermit-20 will always restore your terminal to its original condition, and you will be able to)57 W 8280 41868 MT (CONTINUE the program to get back to ")SH /Courier SF (Kermit-20>)SH /Times-Roman SF (" command level with current settings intact.)SH /Courier SF 8280 44260 MT (QUIT)SH /Times-Roman SF 10930 XM (is a synonym for EXIT.)SH 13 /Times-Bold AF 25901 47619 MT (The LOG Command)SH 10 /Times-Roman AF 8280 49992 MT (Syntax:)SH /Courier SF 11586 XM (LOG)SH /Times-Roman SF 13636 XM ([)SH /Times-Italic SF (option)SH /Times-Roman SF 16775 XM ([)SH /Times-Italic SF (filespec)SH /Times-Roman SF (]])SH 8280 52384 MT (Log the specified option to the specified file:)SH 8280 54175 MT (SESSION)SH 16280 XM (During CONNECT or execution of a login script, log all characters that appear on) 42 W( the screen to)41 W 16280 55280 MT (the specified file. During CONNECT, the session log can be temporarily) 59 W( turned off during the)60 W 16280 56385 MT (remote session by typing the escape) 73 W( character followed by Q \050for Quit logging\051, and turned on)72 W 16280 57490 MT (again by typing the escape) 216 W( character followed by R \050for Resume logging\051. Default log is)217 W /Courier SF 16280 58595 MT (SESSION.LOG)SH /Times-Roman SF 23130 XM (in the current directory.)SH 8280 60172 MT (TRANSACTIONS)SH 16280 XM (During file transfer, log the progress of each file.) 103 W( The) 454 W( DEC-20 transaction log file looks like)102 W 16280 61277 MT (this:)SH /Courier SF 18680 62932 MT (Kermit-20 Transaction Log File, Monday 27-Feb-1984)SH 18680 64587 MT (18:40:13: Opened Log: PS:SAMPLE.LOG.1)SH 18680 65618 MT (18:40:31: -- Send Begins --)SH 20480 66649 MT (8th bit prefixing: Off)SH 20480 67680 MT (Block check type: 1)SH 18680 68711 MT (18:40:31: Opened File: PS:LOGIN.CMD.6)SH 20480 69742 MT (Sending As "LOGIN.CMD")SH 20480 70773 MT (Sent: 547 7-bit bytes)SH 18680 71804 MT (18:40:34: Closed PS:LOGIN.CMD.6)SH ES %%Page: 252 253 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 252)SH 12 /Times-Bold AF 23887 XM (Kermit User Guide: DECSYSTEM-20 KERMIT \05012.5.6\051)SH 46800 50 6120 5709 UL 10 /Courier AF 16520 7824 MT (18:40:34: Send Complete)SH 16520 8855 MT (18:40:50: -- Receive Begins --)SH 18320 9886 MT (8th bit prefixing: Off)SH 18320 10917 MT (Block check type: 1)SH 16520 11948 MT (18:40:50: Opened: PS:AUTOEXEC.BAT.1)SH 18320 12979 MT (Written: 186 7-bit bytes)SH 16520 14010 MT (18:40:51: Closed: PS:AUTOEXEC.BAT.1)SH 16520 15041 MT (18:40:56: Closed Transaction Log)SH /Times-Roman SF 14120 16758 MT (Transaction logging is recommended for long or unattended file transfers, so that you don't have)8 W 14120 17863 MT (to watch the screen. The log may be inspected after the transfer is complete) 93 W( to see what files)92 W 14120 18968 MT (were transferred and what errors may have occurred. Default log) SH( is)1 W /Courier SF 41418 XM (TRANSACTION.LOG)SH /Times-Roman SF 50669 XM (in the)1 W 14120 20073 MT (current directory.)SH 6120 21650 MT (DEBUGGING)SH 14120 XM (Log STATES or PACKETS, as specified in the most recent SET DEBUGGING) 94 W( command, to)93 W 14120 22755 MT (the specified file. If log file not specified, then) 75 W( use TTY if local, or)76 W /Courier SF 42468 XM (DEBUGGING.LOG)SH /Times-Roman SF 50594 XM (in the)76 W 14120 23860 MT (current directory if remote. If no SET) 180 W( DEBUGGING command was previously issued, log)179 W 14120 24965 MT (STATES to the specified file. Also allow specification of bytesize for the) 90 W( log file, 7 \050normal,)91 W 14120 26070 MT (default\051, or 8 \050for debugging) 145 W( binary transfers when the parity bit is being used for data\051, for)144 W 14120 27175 MT (instance)SH /Courier SF 16520 28830 MT (LOG DEBUGGING BINARY.LOG 8)SH /Times-Roman SF 14120 30547 MT (A 7-bit log file can be typed, printed, or examined with) 49 W( a text editor or searching program. An)50 W 14120 31652 MT (8-bit log file) 58 W( can only be examined with a system utility like FILDDT. When logging packets,)57 W 14120 32757 MT (each packet is preceded by a timestamp, the) 59 W( current timeout interval \050preceded by a slash\051, and)60 W 14120 33862 MT (")SH /Courier SF (R:)SH /Times-Roman SF (" or ")50 W /Courier SF (S:)SH /Times-Roman SF (" to indicate data being received and sent, respectively. Packet format) 50 W( is described)49 W 14120 34967 MT (in the)SH /Times-Italic SF 16620 XM (Kermit Protocol Manual)SH /Times-Roman SF (.)SH 6120 37359 MT (SESSION is the default option. Thus the command "LOG" alone will cause CONNECT sessions) 87 W( to be logged in)88 W /Courier SF 6120 38555 MT (SESSION.LOG)SH /Times-Roman SF 13044 XM (in the current directory. Any log files are closed when you EXIT or QUIT from Kermit,) 74 W( and are)73 W 6120 39751 MT (reactivated if you CONTINUE the program. You may explicitly) 123 W( close a log file and terminate logging with the)124 W 6120 40947 MT (CLOSE command.)SH 13 /Times-Bold AF 22982 44306 MT (The CLOSE Command)SH 10 /Times-Roman AF 6120 46679 MT (Syntax:)SH /Courier SF 9426 XM (CLOSE)SH /Times-Italic SF 12676 XM (option)SH /Times-Roman SF 6120 49071 MT (Close the specified log file, SESSION, TRANSACTION, or DEBUGGING, and terminate logging to that file.)SH 14 /Times-Bold AF 6120 52673 MT (12.6. Login Scripts: The INPUT, OUTPUT, CLEAR, and PAUSE Commands)SH 10 /Times-Roman AF 6120 54791 MT (When running Kermit-20 in local mode, connecting from) 84 W( the DEC-20 to another system via an external TTY line)83 W 6120 55987 MT (\050for instance, through an autodialer\051, you) 297 W( may use the Kermit-20 INPUT, OUTPUT, CLEAR, and PAUSE)298 W 6120 57183 MT (commands to carry on a dialog with the remote system. When combined into a) 143 W( "script" in a Kermit-20 TAKE)142 W 6120 58379 MT (command file, or included in a Batch control file, these commands provide the ability to initially connect) 29 W( and log in)30 W 6120 59575 MT (to a remote system, and to set it up for file transfer. During script execution, session logging may) 28 W( be used to record)27 W 6120 60771 MT (the dialog.)SH ES %%Page: 253 254 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (12.6. Login Scripts: The INPUT, OUTPUT, CLEAR, and PAUSE Commands)SH 10 /Times-Italic AF 51275 XM (Page 253)SH 46800 50 8280 5709 UL 13 /Times-Bold AF 25070 8071 MT (The CLEAR Command)SH 10 /Times-Roman AF 8280 10444 MT (Syntax:)SH /Courier SF 11586 XM (CLEAR)SH /Times-Roman SF 8280 12836 MT (Clear the input and output buffers of the currently selected line, and attempt to clear any XOFF deadlock.)SH 13 /Times-Bold AF 25215 16195 MT (The PAUSE Command)SH 10 /Times-Roman AF 8280 18568 MT (Syntax:)SH /Courier SF 11586 XM (PAUSE)SH /Times-Roman SF 14836 XM ([)SH /Times-Italic SF (interval)SH /Times-Roman SF (])SH 8280 20960 MT (Pause the specified number of seconds before executing the next command. The default interval is one second.)SH 13 /Times-Bold AF 25323 24319 MT (The INPUT Command)SH 10 /Times-Roman AF 8280 26692 MT (Syntax:)SH /Courier SF 11586 XM (INPUT)SH /Times-Roman SF 14836 XM ([)SH /Times-Italic SF (interval)SH /Times-Roman SF (] [)SH /Times-Italic SF (string)SH /Times-Roman SF (])SH 8280 29084 MT (On the currently selected communication line, look) 75 W( for the given string for the specified interval of time, which is)76 W 8280 30280 MT (specified in seconds. If no interval is specified, then wait for the default interval, which may) 67 W( be specified by SET)66 W 8280 31476 MT (INPUT DEFAULT-TIMEOUT, and is normally) 7 W( 5 seconds. Specifying an interval of 0 \050or less\051 means no timeout --)8 W 8280 32672 MT (wait forever for the specified string. An INPUT command can by interrupted by) 76 W( typing one or more Control-C's,)75 W 8280 33868 MT (which will return you to)SH /Courier SF 18196 XM (Kermit-20>)SH /Times-Roman SF 24446 XM (prompt level.)SH 8280 36260 MT (Characters coming in from the line) 48 W( will be scanned for the search string, and when a match is found, the command)49 W 8280 37456 MT (will terminate successfully; if the string is not found within the given interval,) 257 W( the command will terminate)256 W 8280 38652 MT (unsuccessfully. While) 250 W( the INPUT command is active, all incoming characters will appear on your screen.)SH 8280 41044 MT (The search string may) 171 W( contain any printable characters. Control or other special characters that you could not)172 W 8280 42240 MT (normally type as part of a command may be included) 84 W( by preceding their octal ASCII values with a backslash, for)83 W 8280 43436 MT (instance)SH /Courier SF 11886 XM (foo\13415)SH /Times-Roman SF 15815 XM (is "foo" followed by a carriage return \050ASCII 15, octal\051. A) 79 W( backslash alone will be taken as is,)80 W 8280 44632 MT (unless it is followed by an octal digit \0500-7\051; if you want to actually) 81 W( specify a backslash in this context, double the)80 W 8280 45828 MT (backslash \050)SH /Courier SF (\134\1345)SH /Times-Roman SF 14801 XM (will be taken as)SH /Courier SF 21300 XM (\1345)SH /Times-Roman SF (\051.)SH 8280 48220 MT (The behavior of the INPUT command is governed by the SET INPUT CASE, SET INPUT) 37 W( DEFAULT-TIMEOUT,)38 W 8280 49416 MT (and SET INPUT TIMEOUT-ACTION) 12 W( commands, as described in the Kermit Commands section of the User Guide,)11 W 8280 50612 MT (or in the Kermit book.)SH 8280 53004 MT (In addition to normal use, Kermit-20 scripts can also be used in DEC-20 batch control files. Failure to match) 93 W( an)94 W 8280 54200 MT (input string in the timeout interval will result in a message starting with ``)43 W /Courier SF (?)SH /Times-Roman SF ('', which signals the) 43 W( Batch controller to)42 W 8280 55396 MT (detect an error. If INPUT TIMEOUT-ACTION is) 91 W( SET to PROCEED, any timeout error messages will be issued)92 W 8280 56592 MT (starting with a ")SH /Courier SF (%)SH /Times-Roman SF (", which does not signal an error to Batch.)SH 8280 58984 MT (In addition to otherwise untypable control characters \050like Control-C\051, certain printable characters in the search)167 W 8280 60180 MT (string may need to be "quoted" using the backslash mechanism:)SH /Courier SF 8280 61971 MT (@)SH /Times-Roman SF 9130 XM (\050ASCII 100\051)SH 16280 XM (If it is the first character in the string,) 37 W( atsign tells TOPS-20 that the following characters will be)38 W 16280 63076 MT (the name of an indirect command file, for instance)SH /Courier SF 18680 64731 MT (input 10 @foo.txt)SH /Times-Roman SF 16280 66448 MT (tells Kermit to spend 10 seconds scanning the communication line input for) 63 W( the string which is)62 W 16280 67553 MT (contained in the file)77 W /Courier SF 24809 XM (FOO.TXT)SH /Times-Roman SF (. If) 405 W( you need to specify a string that starts with ")78 W /Courier SF (@)SH /Times-Roman SF (", use)78 W /Courier SF 52680 XM (\134100)SH /Times-Roman SF 16280 68658 MT (instead.)SH /Courier SF 8280 70235 MT (?)SH /Times-Roman SF 9130 XM (\050ASCII 77\051)SH 16280 XM (A question mark tells TOPS-20 to provide a brief help message about this part of the) 26 W( command;)25 W 16280 71340 MT (use)SH /Courier SF 17863 XM (\13477)SH /Times-Roman SF 19913 XM (instead.)SH ES %%Page: 254 255 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 254)SH 12 /Times-Bold AF 24787 XM (Kermit User Guide: DECSYSTEM-20 KERMIT \05012.6\051)SH 46800 50 6120 5709 UL 10 /Courier AF 6120 7886 MT (!)SH /Times-Roman SF 6970 XM (\050ASCII 41\051)SH 14120 XM (If it is the first character in the string, an exclamation point) 96 W( will cause TOPS-20 to ignore the)97 W 14120 8991 MT (rest of the string, i.e. treat it as a comment, use)SH /Courier SF 33034 XM (\13441)SH /Times-Roman SF (.)SH /Courier SF 6120 10568 MT (;)SH /Times-Roman SF 6970 XM (\050ASCII 73\051)SH 14120 XM (Same as exclamation mark, use)SH /Courier SF 26951 XM (\13473)SH /Times-Roman SF (.)SH /Courier SF 6120 12145 MT (\050)SH /Times-Roman SF 6970 XM (\050ASCII 50\051)SH 14120 XM (In first position, TOPS-20 will think this marks the beginning of a "guide word"; use)SH /Courier SF 48269 XM (\13450)SH /Times-Roman SF (.)SH /Courier SF 6120 13722 MT (-)SH /Times-Roman SF 6970 XM (\050ASCII 55\051)SH 14120 XM (In)SH /Times-Italic SF 15285 XM (final)SH /Times-Roman SF 17451 XM (position, a dash) 82 W( tells TOPS-20 that the command line is to be continued, concatenated)81 W 14120 14827 MT (with the following line. Use)122 W /Courier SF 26546 XM (\13455)SH /Times-Roman SF 28718 XM (instead of a final dash. For instance, to specify) 122 W( the string)123 W 14120 15932 MT (")SH /Courier SF (More?--)SH /Times-Roman SF (", use ")SH /Courier SF (More\13477-\13455)SH /Times-Roman SF (".)SH 13 /Times-Bold AF 22477 19291 MT (The OUTPUT Command)SH 10 /Times-Roman AF 6120 21664 MT (Syntax:)SH /Courier SF 9426 XM (OUTPUT)SH /Times-Italic SF 13276 XM (string)SH /Times-Roman SF 6120 24056 MT (The given string is sent out the currently selected communication line. The string is in the same) 20 W( form as the INPUT)19 W 6120 25252 MT (string; control or special characters may be included by) 83 W( prefacing their octal ASCII value with a backslash. Note)84 W 6120 26448 MT (that any terminating carriage return must be included explicitly as)135 W /Courier SF 34077 XM (\13415)SH /Times-Roman SF (. The) 520 W( string will also be) 135 W( echoed at your)134 W 6120 27644 MT (terminal.)SH 13 /Times-Bold AF 24355 31003 MT (Login Script Hints)SH 10 /Times-Roman AF 6120 33376 MT (It is not a good idea to store) 44 W( passwords in plain text in a file. The facilities of the TOPS-20 command parser make)45 W 6120 34572 MT (this unnecessary,) 112 W( so long as you are sitting at your terminal. Suppose you have a script that looks for the string)111 W 6120 35768 MT (")SH /Courier SF (Password:)SH /Times-Roman SF 12528 XM (" and then outputs your password using a command like)SH /Courier SF 8520 37423 MT (out mypassword\13415)SH /Times-Roman SF 6120 39140 MT (If you change this line to)SH /Courier SF 8520 40795 MT (out @tty:)SH /Times-Roman SF 6120 42512 MT (you may enter the password from your terminal as follows:)SH /Courier SF 8520 44167 MT (login: myuserid)SH 8520 45198 MT (Password: mypassword\13415^Z)SH 9000 50 14520 45398 UL /Times-Roman SF 6120 46915 MT (That is, you type the password, a backslash-encoded carriage return, and then Control-Z. This may be) 85 W( done even)86 W 6120 48111 MT (when executing commands from a TAKE file; after the)139 W /Courier SF 29727 XM (^Z)SH /Times-Roman SF (, control returns to the TAKE) 139 W( file. In the OUTPUT)138 W 6120 49307 MT (command, ")33 W /Courier SF (@TTY:)SH /Times-Roman SF 14288 XM (designates)SH /Courier SF 18737 XM (TTY:)SH /Times-Roman SF 21420 XM (\050your job's controlling terminal\051 to be an indirect command file; the)34 W /Courier SF 49263 XM (^Z)SH /Times-Roman SF 50747 XM (is the)34 W 6120 50503 MT ("end of file") 75 W( for a terminal. This same technique could have been used in the first script example to allow you to)74 W 6120 51699 MT (supply from the terminal the name of) 87 W( the file to be sent. It might be a good idea to for you to include an ECHO)88 W 6120 52895 MT (command in your script file to remind you to do this, for instance:)SH /Courier SF 8520 54550 MT (input password:)SH 8520 55581 MT (echo ^GType your password, followed by "\13415" and then a CTRL-Z)SH 8520 56612 MT (output @tty:)SH /Times-Roman SF 6120 58329 MT (The)SH /Courier SF 7925 XM (^G)SH /Times-Roman SF 9375 XM (is a Control-G, which should get your attention by sounding a beep at your terminal.)SH 6120 60721 MT (One might expect to be able) 5 W( to use the same indirect file mechanism with the OUTPUT command to provide a crude)4 W 6120 61917 MT ("raw upload" facility, as in)SH /Courier SF 8520 63572 MT (output @foo.bar)SH /Times-Roman SF 6120 65289 MT (to send the contents of the file)246 W /Courier SF 20146 XM (FOO.BAR)SH /Times-Roman SF 24842 XM (to the remote) 246 W( system, with)247 W /Times-Italic SF 36908 XM (no)SH /Times-Roman SF 38405 XM (synchronization or error checking.)247 W 6120 66485 MT (Unfortunately, there are two problems with this approach:) 65 W( first, TOPS-20 converts all carriage return / linefeeds in)64 W 6120 67681 MT (an indirect command file to spaces, and second, only very short files) 33 W( may be treated this way, because they must fit)34 W 6120 68877 MT (within TOPS-20's command "atom" buffer. The Kermit-20 TRANSMIT command provides a synchronized) 119 W( raw)118 W 6120 70073 MT (uploading of files.)SH ES %%Page: 255 256 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (12.7. Raw Download and Upload)SH 10 /Times-Italic AF 51275 XM (Page 255)SH 46800 50 8280 5709 UL 14 /Times-Bold AF 8280 8138 MT (12.7. Raw Download and Upload)SH 10 /Times-Roman AF 8280 10256 MT ("Raw Download" is the term commonly used to describe the capture of) 78 W( a remote file on the local system, without)79 W 8280 11452 MT (any kind of error detection or correction. This allows you to obtain files from remote systems) 128 W( that do not have)127 W 8280 12648 MT (Kermit, but with the risk of loss or corruption of data.)SH 8280 15040 MT (Kermit-20 provides raw downloading via the LOG SESSION command during) 3 W( CONNECT to a remote system. The)4 W 8280 16236 MT (session log is described above. To use session logging to capture a file:)SH 10280 18027 MT (1.)SH 11280 XM (Run Kermit on the DEC-20.)SH 10280 20237 MT (2.)SH 11280 XM (SET LINE to the TTY number through which you will be connected to the remote system.)SH 10280 22447 MT (3.)SH 11280 XM (Perform any required SET commands to) 24 W( condition Kermit for communication with the remote system.)23 W 11280 23552 MT (You may need SET PARITY, SET) 89 W( DUPLEX, SET FLOW, SET HANDSHAKE, etc., depending on)90 W 11280 24657 MT (the characteristics of the remote system and the communication medium.)SH 10280 26867 MT (4.)SH 11280 XM (CONNECT to the remote system and log in.)SH 10280 29077 MT (5.)SH 11280 XM (Condition your job on the remote system not to pause at the end of a screenful of text, and give)171 W 11280 30182 MT (whatever commands may be necessary to achieve a "clean" terminal) 144 W( listing -- for instance, disable)145 W 11280 31287 MT (messages from the system or other users.)SH 10280 33497 MT (6.)SH 11280 XM (Type the appropriate) 81 W( command to have the desired file displayed at the terminal,)80 W /Times-Italic SF 44816 XM (but do not type the)80 W 11280 34602 MT (terminating carriage return)SH /Times-Roman SF (. On) 250 W( most systems, the command would be "type", on Unix it's "cat".)SH 10280 36812 MT (7.)SH 11280 XM (Escape back to Kermit to the DEC-20 and give the LOG SESSION command.)SH 10280 39022 MT (8.)SH 11280 XM (CONNECT back to the) 61 W( remote system and type a carriage return. The file will be displayed on your)62 W 11280 40127 MT (screen and recorded in the session log file.)SH 10280 42337 MT (9.)SH 11280 XM (Escape back to Kermit on the DEC-20 and give the CLOSE SESSION command.)SH 8280 44128 MT (The file will be in)70 W /Courier SF 16046 XM (SESSION.LOG)SH /Times-Roman SF 22966 XM (in your) 70 W( connected directory, unless you gave another name for it in your LOG)69 W 8280 45324 MT (SESSION command. You will) 27 W( probably find that some editing necessary to remove extraneous prompts, messages,)28 W 8280 46520 MT (padding characters, or terminal escape sequences, or to fill in lost) 7 W( or garbled characters. Here's an example showing)6 W 8280 47716 MT (how to capture a file)SH /Courier SF 16750 XM (foo.bar)SH /Times-Roman SF 21200 XM (from a remote Unix system:)SH /Courier SF 10680 49371 MT (@kermit)SH 3600 50 11280 49571 UL 10680 50402 MT (Kermit-20>set line 23)SH 6600 50 16680 50602 UL 10680 51433 MT (Kermit-20>connect)SH 4200 50 16680 51633 UL 10680 52464 MT ([KERMIT-20: Connecting to remote host over TTY23:,)SH 11280 53495 MT (type C to return.])SH 10680 54526 MT (4.2 BSD UNIX)SH 10680 56181 MT (login: myuserid)SH 4800 50 14880 56381 UL 10680 57212 MT (Password: mypassword)SH 6000 50 16680 57412 UL 10680 58243 MT (% cat foo.bar^\134C)SH 8400 50 11880 58443 UL 10680 59274 MT ([KERMIT-20: Connection Closed])SH 10680 60305 MT (Kermit-20>log session foo.bar)SH 11400 50 16680 60505 UL 10680 61336 MT (Kermit-20>connect)SH 4200 50 16680 61536 UL 10680 62367 MT ([KERMIT-20: Connecting to remote host over TTY23:,)SH 11280 63398 MT (type C to return.])SH 10680 64429 MT ([KERMIT-20: Logging to File FOO.BAR.1])SH /Times-Italic SF 10680 65460 MT (\050Type carriage return now.\051)SH /Courier SF 10680 66491 MT (This is the file foo.bar.)SH 10680 67522 MT (It has three lines.)SH 10680 68553 MT (This is the last line.)SH 10680 69584 MT (% ^\134)SH 1200 50 11880 69784 UL 10680 70615 MT ([KERMIT-20: Closing Log File FOO.BAR.1>)SH 10680 71646 MT ([KERMIT-20: Connection Closed])SH ES %%Page: 256 257 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 256)SH 12 /Times-Bold AF 24787 XM (Kermit User Guide: DECSYSTEM-20 KERMIT \05012.7\051)SH 46800 50 6120 5709 UL 10 /Courier AF 8520 7824 MT (Kermit-20>close session)SH 7800 50 14520 8024 UL /Times-Roman SF 6120 9541 MT (Note that in this case, the Unix ")SH /Courier SF (%)SH /Times-Roman SF 20338 XM (" prompt at the end of the text will have to be edited out.)SH 13 /Times-Bold AF 26070 12900 MT (Raw Upload)SH 10 /Times-Roman AF 6120 15273 MT ("Raw Upload" means sending a file from the local system to a remote one,) 223 W( again without error detection or)224 W 6120 16469 MT (correction. This) 414 W( allows you to send files from the DEC-20 to remote systems that don't have) 82 W( Kermit. Kermit-20)81 W 6120 17665 MT (provides the TRANSMIT command for this purpose.)SH 6120 20057 MT (Syntax:)SH /Courier SF 9426 XM (TRANSMIT)SH /Times-Italic SF 14476 XM (filespec)SH /Times-Roman SF 17781 XM ([)SH /Times-Italic SF (prompt)SH /Times-Roman SF (])SH 6120 22449 MT (For use in local mode only. Sends the specified text file) 182 W( a line at a time, "raw" \050as is,)183 W /Times-Italic SF 44053 XM (without)SH /Times-Roman SF 47487 XM (using Kermit)183 W 6120 23645 MT (protocol\051, to the remote system, waiting for the) 47 W( specified prompt for each line. Only a single file may be sent with)46 W 6120 24841 MT (the TRANSMIT command; wildcards are not allowed in the filespec. The file should be) 9 W( a text file, not a binary file.)10 W 6120 26037 MT (Since protocol is not being used, no assurance can be given that) 95 W( the file will arrive at the destination correctly or)94 W 6120 27233 MT (completely.)SH 6120 29625 MT (The)SH /Times-Italic SF 8025 XM (prompt)SH /Times-Roman SF 11264 XM (is any string, for instance the prompt of a line editor) 100 W( in text insertion mode. The prompt string may)101 W 6120 30821 MT (include special characters by preceding their octal ASCII values with a backslash, e.g.)99 W /Courier SF 42121 XM (\13412)SH /Times-Roman SF 44270 XM (for linefeed,)99 W /Courier SF 49605 XM (\13421)SH /Times-Roman SF 51754 XM (for)SH 6120 32017 MT (XON \050)SH /Courier SF (^Q)SH /Times-Roman SF (\051. The) 250 W( syntax of the prompt string is explained in greater detail above, with the INPUT command.)SH 6120 34409 MT (If a prompt string is supplied, alphabetic case will be ignored in searching for it unless you SET INPUT) 130 W( CASE)131 W 6120 35605 MT (OBSERVE. If) 384 W( a prompt string is not supplied, then linefeed will be used) 67 W( by default, unless you have performed a)66 W 6120 36801 MT (SET HANDSHAKE command, in which case the current handshake character will be used. If you really want) 82 W( to)83 W 6120 37997 MT (send the entire file without waiting for any prompts, specify a prompt of "\1340" \050ASCII zero, null\051 \050this is not advised\051.)SH 6120 40389 MT (The file will be sent using the current) 43 W( settings for duplex, parity, and flow control. There are no timeouts on input,)42 W 6120 41585 MT (as there are with the INPUT command. The TRANSMIT command) 222 W( waits forever for the prompt to appear.)223 W 6120 42781 MT (However, if you observe that the transfer is stuck, there are three things you can do:)SH /Symbol SF 7910 44686 MT (\267)SH /Times-Roman SF 8620 XM (Type a Carriage Return to transmit the next line.)SH /Symbol SF 7910 46675 MT (\267)SH /Times-Roman SF 8620 XM (Type a Control-P to retransmit the line that was just transmitted.)SH /Symbol SF 7910 48664 MT (\267)SH /Times-Roman SF 8620 XM (Type two Control-C's to cancel the TRANSMIT) 103 W( command and get back to)102 W /Courier SF 40124 XM (Kermit-20>)SH /Times-Roman SF 46476 XM (command)SH 8620 49769 MT (level.)SH 6120 52161 MT (TRANSMIT should be used as) 50 W( follows: CONNECT to the remote system, login, and start up some kind of process)51 W 6120 53357 MT (on the remote) 112 W( system to store input from the terminal into a file. On a DEC-20 \050that doesn't have Kermit\051, you)111 W 6120 54553 MT (could do)SH /Courier SF 8520 56208 MT (copy tty: foo.bar)SH /Times-Roman SF 6120 57925 MT (or you could start a line editor like EDIT or OTTO and put it into text insertion) 10 W( mode. On a Unix system, you could)11 W /Courier SF 8520 59580 MT (cat /dev/tty > foo.bar)SH /Times-Roman SF 6120 61297 MT (or you could run "ed" and give it the "a" command.)SH 6120 63689 MT (The Kermit-20 TRANSMIT command will send the first line of the file immediately. Then) 180 W( it will wait for a)179 W 6120 64885 MT ("prompt" from the remote system before sending) 208 W( the next line. When performing a copy operation from the)209 W 6120 66081 MT (terminal to a file, the "prompt" will probably be) 72 W( a linefeed, ")71 W /Courier SF (\13412)SH /Times-Roman SF (" which is the default prompt -- most full duplex)71 W 6120 67277 MT (systems expect you to type a line of text terminated by a carriage return; they) 29 W( echo the characters you type and then)30 W 6120 68473 MT (output a linefeed. Half duplex systems, on the other hand, use some kind of) 76 W( line turnaround handshake character,)75 W 6120 69669 MT (like XON \050Control-Q\051,) 56 W( to let you know when they are ready for the next line of input. Line editors like EDIT and)57 W 6120 70865 MT (OTTO prompt you with a line number followed) 88 W( by a tab; in that case your prompt character would be ")87 W /Courier SF (\13411)SH /Times-Roman SF (" \050be)87 W ES %%Page: 257 258 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (12.7. Raw Download and Upload)SH 10 /Times-Italic AF 51275 XM (Page 257)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (careful -- if) 67 W( the remote DEC-20 doesn't think your terminal has hardware tabs, it will simulate them by outputting)68 W 8280 9082 MT (spaces\051. In) 306 W( any case, to assure synchronization, it is your responsibility to set up the target system) 28 W( to accept line-at-)27 W 8280 10278 MT (a-time textual input and to determine what the system's prompt will be when it is ready for the next line.)SH 8280 12670 MT (Each line is sent with a terminating carriage return; linefeeds are) 48 W( not sent, since these are supplied by the receiving)49 W 8280 13866 MT (system if it needs) 31 W( them. The TRANSMIT command continues to send all the lines of the file in this manner until it)30 W 8280 15062 MT (reaches the end, or until you interrupt the operation by typing Control-C's.)SH 8280 17454 MT (If you cannot make the TRANSMIT command work automatically, for instance because the remote system's prompt)2 W 8280 18650 MT (changes for each line, you) 61 W( may TRANSMIT manually by specifying a prompt string that will not appear, and then)60 W 8280 19846 MT (typing a carriage return at your keyboard for each line you want to send.)SH 8280 22238 MT (If the TRANSMIT command completes successfully \050you'll get a message to the effect that the transmission) 151 W( is)152 W 8280 23434 MT (complete\051, then you) 72 W( must connect back to the remote system and type whatever command it needs in orderto save)71 W 8280 24630 MT (and/or close the file there.)SH 14 /Times-Bold AF 8280 28232 MT (12.8. Kermit-20 Examples)SH 10 /Times-Roman AF 8280 30350 MT (Here are a few examples of the use of Kermit-20. Text entered by the user is underlined.)SH 13 /Times-Bold AF 26535 33709 MT (Remote Operation)SH 10 /Times-Roman AF 8280 36082 MT (The following example shows use of Kermit-20 as a server from) 26 W( an IBM PC. In this example, the user runs Kermit)27 W 8280 37278 MT (on the PC, connects) 67 W( to the DEC-20, and starts Kermit-20 in server mode. From that point on, the user need never)66 W 8280 38474 MT (connect to the DEC-20 again. In this example, the user gets a file from the DEC-20,) 48 W( works on it locally at the PC,)49 W 8280 39670 MT (and then sends the results back to the DEC-20. Note that the user can leave and restart Kermit on the PC as often as)14 W 8280 40866 MT (desired.)SH /Courier SF 8880 42521 MT (A>Kermit)SH 3600 50 10080 42721 UL 8880 43552 MT (Kermit-MS>connect)SH 4200 50 14880 43752 UL 8880 44583 MT (@)SH 8880 45614 MT (@Kermit)SH 3600 50 9480 45814 UL 8880 46645 MT (TOPS-20 Kermit version 4.2\050262\051)SH 8880 48300 MT (Kermit-20>server)SH 3600 50 14880 48500 UL 9480 49955 MT (Kermit Server running on DEC-20 host. Please type your escape)SH 9480 50986 MT (sequence to return to your local machine. Shut down the server by)SH 9480 52017 MT (typing the Kermit BYE command on your local machine.)SH 8880 53048 MT (^[C)SH 1800 50 8880 53248 UL 8880 54079 MT (Kermit-MS>get foo.txt)SH 6600 50 14880 54279 UL /Times-Italic SF 10880 55597 MT (The transfer takes place.)SH /Courier SF 8880 57055 MT (Kermit-MS>exit)SH 2400 50 14880 57255 UL 8880 58086 MT (A>)SH 8880 59117 MT (A>edit foo.txt ; \050)SH /Times-Italic SF (or whatever)SH /Courier SF (...\051)SH 7200 50 10080 59317 UL 8880 60148 MT (A>)SH 8880 61179 MT (A>Kermit)SH 3600 50 10080 61379 UL 8880 62210 MT (Kermit-MS>send foo.txt)SH 7200 50 14880 62410 UL /Times-Italic SF 10880 63728 MT (The transfer takes place.)SH /Courier SF 8880 65186 MT (Kermit-MS>bye)SH 1800 50 14880 65386 UL 8880 66217 MT (A>)SH /Times-Roman SF 8280 68609 MT (The next example shows the special) 47 W( procedure you would have to use in order to send a mixture of text and binary)48 W 8280 69805 MT (files from a PC \050or an 8-bit-byte system\051 to the DEC-20. Note that in this case, it's more convenient to avoid) 19 W( server)18 W 8280 71001 MT (mode.)SH ES %%Page: 258 259 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 258)SH 12 /Times-Bold AF 24787 XM (Kermit User Guide: DECSYSTEM-20 KERMIT \05012.8\051)SH 46800 50 6120 5709 UL 10 /Courier AF 6720 7824 MT (Kermit-MS>connect)SH 4200 50 12720 8024 UL 6720 8855 MT (@)SH 6720 9886 MT (@Kermit)SH 3600 50 7320 10086 UL 6720 10917 MT (TOPS-20 Kermit version 4.2\050262\051)SH 6720 12572 MT (Kermit-20>receive)SH 4200 50 12720 12772 UL 6720 13603 MT (^]C)SH 1800 50 6720 13803 UL 6720 14634 MT (Kermit-MS>send *.txt)SH 6000 50 12720 14834 UL /Times-Italic SF 8720 16152 MT (Textual files are sent.)SH /Courier SF 6720 17807 MT (Kermit-MS>connect)SH 4200 50 12720 18007 UL 6720 18838 MT (Kermit-20>set file bytesize 8)SH 11400 50 12720 19038 UL 6720 19869 MT (Kermit-20>receive)SH 4200 50 12720 20069 UL 6720 20900 MT (^]C)SH 1800 50 6720 21100 UL 6720 21931 MT (Kermit-MS>send *.exe)SH 6000 50 12720 22131 UL /Times-Italic SF 8720 23449 MT (Binary files are sent.)SH /Courier SF 6720 25104 MT (Kermit-MS>connect)SH 4200 50 12720 25304 UL 6720 26135 MT (Kermit-20>exit)SH 2400 50 12720 26335 UL 6720 27166 MT (@logout)SH 3600 50 7320 27366 UL 6720 28197 MT (^]C)SH 1800 50 6720 28397 UL 6720 29228 MT (Kermit-86>exit)SH 2400 50 12720 29428 UL 6720 30259 MT (A>)SH 13 /Times-Bold AF 24952 33618 MT (Local Operation)SH 10 /Times-Roman AF 6120 35991 MT (In this example, a program DIAL is used to direct an autodialer to call another computer) 71 W( \050a DECsystem-10\051; once)72 W 6120 37187 MT (the connection is made, DIAL starts Kermit with an implicit) 417 W( CONNECT command for the appropriate)416 W 6120 38383 MT (communication line. DIAL is not part of Kermit;) 55 W( if your system has an autodialer, there will be some site-specific)56 W 6120 39579 MT (procedure for using it.)SH /Courier SF 6720 41234 MT (@dial)SH 2400 50 7320 41434 UL 6720 42265 MT (Dial>dial stevens)SH 7200 50 9720 42465 UL 6720 43296 MT (STEVENS, 1-\050201\051 555-1234, baud:1200)SH 6720 44327 MT ([confirm])SH 6720 45358 MT (Dialing your number, please hold...)SH 6720 46389 MT (Your party is waiting on TTY11:.)SH 6720 47420 MT (@)SH 6720 48451 MT (@Kermit)SH 3600 50 7320 48651 UL 6720 49482 MT (TOPS-20 Kermit version 4.2\050262\051)SH 6720 51137 MT (Kermit-20>connect 11)SH 6000 50 12720 51337 UL 6720 52168 MT ([Kermit-20: Connecting over TTY11:, type C to return])SH 6720 53823 MT (CONNECTING TO HOST SYSTEM.)SH 6720 54854 MT (Stevens T/S 7.01A\05010\051 20:20:04 TTY41 system 1282)SH 6720 55885 MT (Connected to Node DN87S1\050101\051 Line # 57)SH 6720 57540 MT (Please LOGIN or ATTACH)SH 6720 59195 MT (.log 10,35)SH 5400 50 7320 59395 UL 6720 60226 MT (JOB 51 Stevens T/S 7.01A\05010\051 TTY41)SH 6720 61257 MT (Password:)SH 6720 62288 MT (20:20 15-Dec-83) 1200 W( Thur)3600 W 6720 63943 MT (.r new:Kermit)SH 7200 50 7320 64143 UL 6720 65598 MT (TOPS-10 Kermit version 2\050106\051)SH 6720 67253 MT (Kermit-10>server)SH 3600 50 12720 67453 UL 6720 68908 MT ([Kermit Server running on the DEC host. Please type your escape)SH 7320 69939 MT (sequence to return to your local machine. Shut down the server by)SH 7320 70970 MT (typing the Kermit BYE command on your local machine.])SH ES %%Page: 259 260 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (12.8. Kermit-20 Examples)SH 10 /Times-Italic AF 51275 XM (Page 259)SH 46800 50 8280 5709 UL /Courier SF 8880 7824 MT (^YC)SH 1800 50 8880 8024 UL 8880 9479 MT ([Kermit-20: Connection Closed. Back at DEC-20.])SH 8880 11134 MT (Kermit-20>set file bytesize 8)SH 11400 50 14880 11334 UL 8880 12165 MT (Kermit-20>get setdtr.cmd)SH 8400 50 14880 12365 UL 8880 13196 MT (^A for status report, ^X to cancel file, ^Z to cancel batch.)SH 8880 14227 MT (SETDTR.CMD.7 ^A)SH 1200 50 16680 14427 UL 9480 15258 MT (Receiving SETDTR.CMD.7, file bytesize 8)SH 9480 16289 MT (\050repeated character compression\051)SH 9480 17320 MT (At page 1)SH 9480 18351 MT (Files: 0, packets: 1, chars: 66)SH 9480 19382 MT (NAKs: 0, timeouts: 0)SH 8880 20413 MT (.[OK])SH 8880 21444 MT (Kermit-20>bye)SH 8880 22475 MT (Job 51 User F DA CRUZ [10,35])SH 8880 23506 MT (Logged-off TTY41 at 20:22:58 on 15-Dec-83)SH 8880 24537 MT (Runtime: 0:00:01, KCS:33, Connect time: 0:02:39)SH 8880 25568 MT (Disk Reads:72, Writes:4, Blocks saved:160)SH 8880 26599 MT (....)SH 8880 27630 MT (Hangup? y)SH 600 50 13680 27830 UL 8880 28661 MT (Click. Call duration was 193 seconds to area 201.)SH 8880 29692 MT (Dial>exit)SH 2400 50 11880 29892 UL /Times-Roman SF 8280 31409 MT (Note the use of Control-A to get a status report during the transfer.)SH 14 /Times-Bold AF 8280 35011 MT (12.9. Installation of Kermit-20)SH 10 /Times-Roman AF 8280 37129 MT (Kermit-20 is built from a single MACRO-20 source file,)74 W /Courier SF 31833 XM (K20MIT.MAC)SH /Times-Roman SF (. It) 398 W( requires the standard DEC-distributed)74 W 8280 38325 MT (tools MONSYM, MACSYM, and CMD; the following files should be in)5 W /Courier SF 37697 XM (SYS:)SH /Times-Roman SF 40352 XM (--)SH /Courier SF 41274 XM (MONSYM.UNV, MACSYM.UNV,)6 W 8280 39521 MT (MACREL.REL, CMD.UNV,)17 W /Times-Roman SF 20914 XM (and)SH /Courier SF 22975 XM (CMD.REL.)SH /Times-Roman SF 28309 XM (The CMD package) 17 W( is also included with the Kermit distribution as)16 W /Courier SF 8280 40717 MT (K20CMD.*)SH /Times-Roman SF (, in case you can't find it on your system.)SH 8280 43109 MT (The program should work on all TOPS-20 systems as) 81 W( distributed, but many customizations are possible. The site)82 W 8280 44305 MT (manager may wish to change various default parameters on a site-wide basis; this) 39 W( may be done simply by changing)38 W 8280 45501 MT (the definitions of the desired symbols, under "subttl Definitions", and reassembling.)SH 8280 47893 MT (The most notable) SH( site dependency is the definition of "SET IBM". As distributed from Columbia, Kermit-20 defines)1 W 8280 49089 MT ("SET IBM" in) 7 W( a built-in SET macro definition as "parity mark, duplex half, handshake xon". This definition may be)6 W 8280 50285 MT (found at MACTAB+1, near the end) 124 W( of the impure data section. It may be changed or deleted, and the program)125 W 8280 51481 MT (reassembled.)SH 8280 53873 MT (Sites that do) 223 W( not have ARPANET may wish to delete the TVT-BINARY entries from SET command tables,)222 W 8280 55069 MT (SETABL and SETHLP.)SH ES %%Page: 260 261 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 260)SH 12 /Times-Bold AF 25687 XM (Kermit User Guide: DECSYSTEM-20 KERMIT \05013\051)SH 46800 50 6120 5709 UL ES %%Page: 261 262 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (13. PDP-11 Kermit)SH 10 /Times-Italic AF 51275 XM (Page 261)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 8280 8272 MT (13. PDP-11 Kermit)SH 10 /Times-Italic AF 8280 10566 MT (Author:)SH /Times-Roman SF 18280 XM (Brian Nelson, University of Toledo, Ohio)SH /Times-Italic SF 8280 11671 MT (Documentation:)SH /Times-Roman SF 18280 XM (Brian Nelson)SH /Times-Italic SF 8280 12776 MT (Language:)SH /Times-Roman SF 18280 XM (Macro-11)SH /Times-Italic SF 8280 13881 MT (Version:)SH /Times-Roman SF 18280 XM (3.58)SH /Times-Italic SF 8280 14986 MT (Date:)SH /Times-Roman SF 18280 XM (September, 1987)SH /Times-Italic SF 8280 16091 MT (Systems Supported:)SH /Times-Roman SF 18280 XM (RSTS/E, RSX-11M/M+, P/OS, Micro-RSX, RT-11 and TSX+)SH 12 /Times-Bold AF 8280 18679 MT (Kermit-11 Capabilities At A Glance:)SH 10 /Times-Roman AF 9280 20889 MT (Local operation:)SH 34480 XM (Yes)SH 9280 21994 MT (Remote operation:)SH 34480 XM (Yes)SH 9280 23099 MT (Transfer text files:)SH 34480 XM (Yes)SH 9280 24204 MT (Transfer binary files:)SH 34480 XM (Yes)SH 9280 25309 MT (Wildcard send:)SH 34480 XM (Yes)SH 9280 26414 MT (File transfer interruption:)SH 34480 XM (Yes)SH 9280 27519 MT (Filename collision avoidance:)SH 34480 XM (Yes)SH 9280 28624 MT (Can time out:)SH 34480 XM (Yes)SH 9280 29729 MT (8th-bit prefixing:)SH 34480 XM (Yes)SH 9280 30834 MT (Repeat count prefixing:)SH 34480 XM (Yes)SH 9280 31939 MT (Alternate block checks:)SH 34480 XM (Yes)SH 9280 33044 MT (LONG Packet protocol support:)SH 34480 XM (Yes)SH 9280 34149 MT (Sliding Windows protocol support:)SH 34480 XM (No)SH 9280 35254 MT (Terminal emulation:)SH 34480 XM (Yes)SH 9280 36359 MT (Communication settings:)SH 34480 XM (Yes)SH 9280 37464 MT (Transmit BREAK:)SH 34480 XM (Yes \050depends on system\051)SH 9280 38569 MT (IBM mainframe communication:)SH 34480 XM (Yes)SH 9280 39674 MT (Transaction logging:)SH 34480 XM (Yes)SH 9280 40779 MT (Session logging:)SH 34480 XM (Yes)SH 9280 41884 MT (Debug logging:)SH 34480 XM (Yes)SH 9280 42989 MT (Packet logging:)SH 34480 XM (Yes)SH 9280 44094 MT (Act as server:)SH 34480 XM (Yes)SH 9280 45199 MT (Talk to server:)SH 34480 XM (Yes)SH 9280 46304 MT (Advanced server functions:)SH 34480 XM (Yes)SH 9280 47409 MT (Local file management:)SH 34480 XM (Yes)SH 9280 48514 MT (Command/Init files:)SH 34480 XM (Yes)SH 9280 49619 MT (File attributes packets:)SH 34480 XM (Yes)SH 9280 50724 MT (Command macros:)SH 34480 XM (No)SH 9280 51829 MT (Raw file transmit:)SH 34480 XM (Yes)SH ES %%Page: 262 263 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 262)SH 12 /Times-Bold AF 32086 XM (Kermit User Guide: PDP-11 Kermit \05013\051)SH 46800 50 6120 5709 UL 14 SS 6120 8138 MT (13.1. File Systems on the PDP-11)SH 12 SS 6120 11254 MT (13.1.1. File Specifications)SH 10 /Times-Roman AF 6120 13196 MT (The general format of a file name is:)SH /Courier SF 6120 15588 MT (NODE::DEVICE:[DIRECTORY]NAME.TYPE;VERSION)SH /Times-Roman SF 6120 17980 MT ('Node' refers to the DECNET node name, for example,)49 W /Courier SF 29027 XM (FUBAR::)SH /Times-Roman SF (, if) 49 W( applicable. 'Device', if present, refers to the)50 W 6120 19176 MT (physical device or logical name where the file resides.)SH 6120 21568 MT (For RSTS/E, 'device' can be) 58 W( a physical device, such as)57 W /Courier SF 29023 XM (DB0:)SH /Times-Roman SF 31730 XM (or)SH /Courier SF 32870 XM (DU1:)SH /Times-Roman SF (, or it can be a user or system logical name)57 W 6120 22764 MT (which may include both a physical device name and a directory name. If the device name is) 82 W( a logical name, is it)83 W 6120 23960 MT (composed of 1 to 9) 83 W( alphanumeric characters, including ')82 W /Courier SF ($)SH /Times-Roman SF (', as in)82 W /Courier SF 33093 XM (DISK$ONE:)SH /Times-Roman SF (,)SH /Courier SF 39075 XM (LB:)SH /Times-Roman SF 41207 XM (and so on. For instance, the)82 W 6120 25156 MT (DCL system command)SH /Courier SF 8520 26811 MT ($ ASS/SYS DB1:[200,210] SRC$DIR)SH /Times-Roman SF 6120 28528 MT (would associate both) 107 W( the device)108 W /Courier SF 19628 XM (DB1:)SH /Times-Roman SF 22386 XM (and directory)108 W /Courier SF 28156 XM ([200,210])SH /Times-Roman SF 33914 XM (with)SH /Courier SF 36050 XM (SRC$DIR:)SH /Times-Roman SF (. Explicitly) 466 W( given directories)108 W 6120 29724 MT (override directory names) 163 W( imbedded in a logical name. Names longer than nine characters are truncated by the)162 W 6120 30920 MT (executive.)SH 6120 33312 MT (In the case of RSX-11M/M+ and RT-11, the) 29 W( device name can be either a physical name, such as)30 W /Courier SF 45431 XM (DU0:)SH /Times-Roman SF (, or a logical)30 W 6120 34508 MT (name which will translate to a physical device name, such as)SH /Courier SF 30671 XM (LB:)SH /Times-Roman SF (.)SH 6120 36900 MT (On RSTS/E and RSX-11M/M+, the) 145 W( [directory] is a UIC \050user identification code\051 or PPN \050project,programmer\051)144 W 6120 38096 MT (number of the format [NNN,MMM]. All users are assigned) 58 W( a UIC \050or PPN\051 when accounts are created, this is the)59 W 6120 39292 MT (number you give to LOGIN to log into the system.) 27 W( It) 303 W( is also your default UIC \050or PPN\051. Micro-Rsx and P/OS may)26 W 6120 40488 MT (have directories in either UIC format or named directory format, such as)122 W /Courier SF 36827 XM ([1,2])SH /Times-Roman SF 40199 XM (or)SH /Courier SF 41405 XM ([KERMIT])SH /Times-Roman SF (. For) 496 W( P/OS, the)123 W 6120 41684 MT (default directory is)SH /Courier SF 13924 XM ([USERFILES])SH /Times-Roman SF (. Directories) 250 W( are not used in RT-11.)SH 6120 44076 MT (The NAME field) 84 W( is the primary identifier for the file. The name can be one to nine characters for RSX-11M/M+)83 W 6120 45272 MT (and P/OS, and one to six characters for) 61 W( RSTS/E, RT-11 and TSX+. The TYPE field is usually used to group files)62 W 6120 46468 MT (according to some convention. For example,)79 W /Courier SF 24976 XM (XXX.FTN)SH /Times-Roman SF 29505 XM (refers to a) 79 W( Fortran-77 source file,)78 W /Courier SF 43443 XM (FOO.C)SH /Times-Roman SF 46771 XM (to a 'C' source)78 W 6120 47664 MT (file, and)SH /Courier SF 9647 XM (K11POS.TSK)SH /Times-Roman SF 15897 XM (refers to a task image.)SH 6120 50056 MT (The version field is applicable ONLY to RSX type systems. The default version) 154 W( is always the highest version)155 W 6120 51252 MT (number.)SH 6120 53644 MT (All systems mentioned support some sort of filename) 43 W( wildcarding, the flexibility of which varies by executive. All)42 W 6120 54840 MT (support the use of ')84 W /Courier SF (*)SH /Times-Roman SF (' to represent either a fully wildcarded NAME or) 84 W( TYPE. RSTS/E supports the use of ')85 W /Courier SF (?)SH /Times-Roman SF (' to)85 W 6120 56036 MT (match any single character, whereas the others use a ')42 W /Courier SF (%)SH /Times-Roman SF (' to match any single character. The) 42 W( RSTS/E Kermit server)41 W 6120 57232 MT (will translate ')55 W /Courier SF (%)SH /Times-Roman SF (' to ')55 W /Courier SF (?)SH /Times-Roman SF (' internally for the GET and REMOTE DIR) 55 W( commands \050see the section on Kermit-11 server)56 W 6120 58428 MT (operation\051.)SH 6120 60820 MT (Examples of wildcarded filenames:)SH /Courier SF 6120 62611 MT (*.B2S)SH /Times-Roman SF 14120 XM (Match any file with a TYPE of B2S.)SH /Courier SF 6120 64188 MT (K11%%%.MAC)SH /Times-Roman SF 14120 XM (match any file starting with K11, followed by one to three characters, with a TYPE of MAC.)SH /Courier SF 6120 65765 MT (K11???.MAC)SH /Times-Roman SF 14120 XM (Same as above, but for RSTS/E only.)SH /Courier SF 6120 67342 MT (XYZ.*;*)SH /Times-Roman SF 14120 XM (All versions of files with a NAME of XYZ with any TYPE \050RSX-11M/M+ and P/OS only\051.)SH ES %%Page: 263 264 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (13.1.2. File Formats \050Binary and Text\051)SH 10 /Times-Italic AF 51275 XM (Page 263)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (13.1.2. File Formats \050Binary and Text\051)SH 8280 11120 MT (13.1.2.1. RT-11 and TSX+)SH 10 /Times-Roman AF 8280 13062 MT (RT-11 treats all files as a) 26 W( contiguous stream of characters. There is no information stored in the directory to tell the)25 W 8280 14258 MT (system \050or) 132 W( program\051 that a file is readable text \050source program, runoff document,...\051 or consists of binary data)133 W 8280 15454 MT (\050executable program, object file,)28 W /Courier SF 21666 XM (.SYS)SH /Times-Roman SF 24344 XM (file,...\051. An) 304 W( application program like Kermit-11 needs to know what type of)27 W 8280 16650 MT (file to expect, thus the presence of the SET FILE TYPE command \050discussed later\051. The) 4 W( only real convention is that)5 W 8280 17846 MT (text files) 37 W( are streams of seven bit data with each record terminated by a carriage return/line feed character sequence)36 W 8280 19042 MT (and that binary files normally follow a filename TYPE) 9 W( convention. The TYPE \050)10 W /Courier SF (.SAV)SH /Times-Roman SF (,)SH /Courier SF 43530 XM (.SYS)SH /Times-Roman SF (, ...\051 is what Kermit-11)10 W 8280 20238 MT (will look at to decide if a file should be sent as a text or binary file.)SH 12 /Times-Bold AF 8280 23354 MT (13.1.2.2. RSTS/E, P/OS and RSX-11M/M+)SH 10 /Times-Roman AF 8280 25296 MT (These systems can) 36 W( provide for a large number of file attributes for each file by using either FCS11 \050RSX-11M/M+\051)35 W 8280 26492 MT (or RMS11) 66 W( \050all\051. Text files are normally considered to be either STREAM format \050FB$STM\051 or VARIABLE with)67 W 8280 27688 MT (implied carriage control \050FB$VAR and FB$CR\051. RSTS/E has historically defaulted to STREAM, whereas the RSX)22 W 8280 28884 MT (based systems) 17 W( use VARIABLE. Kermit-11 follows those defaults when creating files unless told to do so otherwise)18 W 8280 30080 MT (by the presence) 15 W( of attribute data. The conversion of the internal data representation to one that can be transmitted to)14 W 8280 31276 MT (another Kermit is transparent for these types of files. Both the file attributes) 51 W( and the filename TYPE are examined)52 W 8280 32472 MT (by Kermit-11 to determine if) 25 W( a file needs to be sent as a text file \050default\051 or a binary file. Additionally, on RSTS/E)24 W 8280 33668 MT (Kermit checks the file protection code, as one of the bits in it is used to flag an executable file \050bit 6\051.)SH 8280 36060 MT (In all cases, unless \050at this time\051 Kermit-11 is talking to another Kermit-11, or if Kermit-11 can't tell if a file) 119 W( is)120 W 8280 37256 MT (consists of binary data, the command SET FILE TYPE) 39 W( FIXED must be used to force Kermit to either send or get a)38 W 8280 38452 MT (non-text file correctly. When Kermit-11 is running in binary mode,) 126 W( all data is read from \050or written to\051 the file)127 W 8280 39648 MT (without any translation or internal record control information. Any attribute information in the file's) 21 W( directory entry)20 W 8280 40844 MT (is ignored and the data read \050or written\051 in 512 byte unformatted blocks. Thus) 46 W( it is indeed possible to transfer files)47 W 8280 42040 MT (like task images) 18 W( and object libraries. Since Kermit-11 supports a subset of a protocol feature called 'attributes', two)17 W 8280 43236 MT (Kermit-11's connected together can also correctly transfer) 46 W( files other than simple text and unformatted binary files,)47 W 8280 44432 MT (such as RMS indexed or relative files.)SH 12 /Times-Bold AF 8280 47548 MT (13.1.3. Saving Files on the PDP-11 From Your Microcomputer)SH 10 /Times-Roman AF 8280 49490 MT (You can send) 27 W( textual files to Kermit-11 without any special considerations as Kermit-11 defaults to creating normal)26 W 8280 50686 MT (text files. However, if you are sending a binary) 78 W( file \050perhaps an)79 W /Courier SF 35097 XM (.EXE)SH /Times-Roman SF (\051 from say, your Rainbow under MS-DOS,)79 W 8280 51882 MT (you would need to tell Kermit-11 to expect binary data. This is done with) 142 W( the Kermit-11 command SET FILE)141 W 8280 53078 MT (TYPE FIXED. This will force Kermit-11 to write the data) 19 W( out exactly as it comes, in 512 byte unformatted records.)20 W 8280 54274 MT (Sending the same file back to the Rainbow would not require any special action since the file, as) 147 W( it sits on the)146 W 8280 55470 MT (PDP-11, has the proper) 101 W( information in the directory entry to tell Kermit-11 that the file is binary. As a note, for)102 W 8280 56666 MT (RT-11 you would need to use a filetype that is normally considered 'binary' like)72 W /Courier SF 41728 XM (.SAV)SH /Times-Roman SF 44450 XM (or)SH /Courier SF 45605 XM (.OBJ)SH /Times-Roman SF 48327 XM (\050see above notes)72 W 8280 57862 MT (for RT-11\051.)SH 8280 60254 MT (Never try to do a wildcarded send) 15 W( with mixed binary and text files with the file type set to FIXED. The result could)16 W 8280 61450 MT (be unusable as not all systems store) 51 W( text data in the same internal format. For example, if Kermit-11 is forced into)50 W 8280 62646 MT (binary mode \050via SET FIL TYP FIX\051 and is requested to send a file with implied carriage control \050normal) 43 W( for RSX)44 W 8280 63842 MT (text files\051, it will actually send, for each line, two bytes representing the record length, followed by the) 10 W( data and then)9 W 8280 65038 MT (followed by a ASCII NUL to pad the record to an even length. That is not) 1 W( incorrect, rather, it is EXACTLY how the)2 W 8280 66234 MT (data was stored on disk.)SH 8280 68626 MT (In general, avoid sending anything other than unformatted binary files and text file to unlike) 28 W( systems. For example,)27 W 8280 69822 MT (requesting a RMS indexed file from the PDP-11 to be sent) 32 W( to a PC would case Kermit-11 to send it as a binary file,)33 W 8280 71018 MT (but the file attributes would be lost. Sending such a file back to the PDP-11 would result) 38 W( in an unusable file unless)37 W ES %%Page: 264 265 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 264)SH 12 /Times-Bold AF 30286 XM (Kermit User Guide: PDP-11 Kermit \05013.1.3\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (you could reconstruct the attribute information.)SH 12 /Times-Bold AF 6120 11002 MT (13.1.4. Program Operation)SH 10 /Times-Roman AF 6120 12944 MT (Kermit-11's prompt is normally "Kermit-11>". This can be changed if need be via the) 82 W( SET PROMPT command.)83 W 6120 14140 MT (Invoking Kermit-11 is very site dependent.)SH 12 /Times-Bold AF 6120 17256 MT (13.1.4.1. RSTS/E)SH 10 /Times-Roman AF 6120 19198 MT (If Kermit-11 has a ccl definition, it would likely be invoked) 10 W( as "KER" or "KERMIT". If not, try "RUN $KERMIT",)9 W 6120 20394 MT (as this is a likely place where Kermit-11 may have been put. Otherwise consult your local support staff.)SH 12 /Times-Bold AF 6120 23510 MT (13.1.4.2. RSX-11M/M+)SH 10 /Times-Roman AF 6120 25452 MT (If Kermit-11 has been installed, it) 84 W( most likely will have a task name of)85 W /Courier SF 35774 XM (...KER)SH /Times-Roman SF 39709 XM (which means that typing "KER")85 W 6120 26648 MT (should get things running. If not, consult your local support staff.)SH 12 /Times-Bold AF 6120 29764 MT (13.1.4.3. RT-11/TSX+)SH 10 /Times-Roman AF 6120 31706 MT (On version 5 of RT-11,) 373 W( programs can be run simply by typing the filename. Thus, if there is a file)372 W /Courier SF 6120 32902 MT (SY:KERMIT.SAV)SH /Times-Roman SF (, simply type "KERMIT". If this fails, contact your local support staff for assistance.)SH 12 /Times-Bold AF 6120 36018 MT (13.1.4.4. P/OS)SH 10 /Times-Roman AF 6120 37960 MT (Kermit-11 is generally run from DCL on P/OS. The program is invoked via the DCL RUN) 65 W( command, as in RUN)66 W 6120 39156 MT (K11POS or RUN KERMIT, depending on what the task image name is.)SH 6120 41548 MT (Note that for the case where Kermit) 59 W( is installed \050for RSTS/E and RSX-11M/M+\051 that Kermit-11 can get command)58 W 6120 42744 MT (line arguments, as in:)SH /Courier SF 8520 44461 MT ($ KER SERV)SH /Times-Roman SF 26520 XM (Kermit starts as a server.)SH /Courier SF 8520 45492 MT (> KER send fubar.txt)SH /Times-Roman SF 26520 XM (Kermit sends the file.)SH 6120 47209 MT (Otherwise, the program is run interactively from the Kermit-11> prompt:)SH /Courier SF 8520 48864 MT ($ KERMIT)SH 8520 49895 MT (Kermit-11 V3.54)SH 8520 50926 MT (Kermit-11>SET BLO 3)SH /Times-Roman SF 26520 XM (Changes checksum type.)SH /Courier SF 8520 51957 MT (Kermit-11>SER)SH /Times-Roman SF 26520 XM (Enter Kermit server.)SH 6120 54349 MT (Note that whenever Kermit-11 starts up, it will always try to find) 191 W( a file called)192 W /Courier SF 40151 XM (KERMIT.INI)SH /Times-Roman SF 46593 XM (in your current)192 W 6120 55545 MT (directory. This) 678 W( file can contain any valid Kermit) 214 W( command, though the usual use of this is to place various)213 W 6120 56741 MT (Kermit-11 SET commands in it. If this file does NOT exist,) 156 W( it will try to find it in)157 W /Courier SF 42120 XM (LB:[1,2]KERMIT.INI)SH /Times-Roman SF 6120 57937 MT (\050excluding RT-11\051. In addition to the)146 W /Courier SF 22474 XM (.INI)SH /Times-Roman SF 25269 XM (file, commands may be placed in a file and then executed via the)145 W 6120 59133 MT (Kermit-11 TAKE \050or @\051 command.)SH 14 /Times-Bold AF 6120 62735 MT (13.2. Local and Remote Operation)SH 10 /Times-Roman AF 6120 64853 MT (Kermit-11 by default assumes that all file transfers will occur over the terminal) 29 W( line that you are currently logged in)30 W 6120 66049 MT (on \050)106 W /Courier SF (TI:)SH /Times-Roman SF (,)SH /Courier SF 10215 XM (TT:)SH /Times-Roman SF (,)SH /Courier SF 12621 XM (KB:)SH /Times-Roman SF (\051. This) 460 W( is known as REMOTE mode \050the PDP-11 is the remote system\051. This would be the)105 W 6120 67245 MT (desired case if you are running Kermit on a microcomputer such as a Rainbow) 111 W( and are currently logged into the)112 W 6120 68441 MT (PDP-11 through the micro. However, if you wanted to dial out, say by an autodial modem, from) 107 W( the PDP-11 to)106 W 6120 69637 MT (another system, you need to tell Kermit-11 to use some other terminal line. This would be called) 4 W( LOCAL mode \050the)5 W 6120 70833 MT (PDP-11 is the local system\051. The line) 184 W( can be altered with the SET LINE command \050see section on SET and)183 W ES %%Page: 265 266 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (13.2. Local and Remote Operation)SH 10 /Times-Italic AF 51275 XM (Page 265)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (CONNECT\051. A) 536 W( SET LINE command is done) 143 W( implicitly if Kermit-11 finds itself running on a PRO/350, under)144 W 8280 9082 MT (either P/OS, RT-11 or TSX+.)SH 8280 11474 MT (Since support of parity varies) 94 W( by both interface type \050DL11 vs DZ11\051 and by operating system, Kermit-11 makes)93 W 8280 12670 MT (NO attempt) 47 W( to find out what the current parity of it's line is. Kermit-11 generates it's own parity which is set with)48 W 8280 13866 MT (the SET PARITY command.)SH 8280 16258 MT (There are a couple of things to point out regarding Kermit-11 and LOCAL mode \050you did a SET LINE command\051:)SH /Symbol SF 10070 18163 MT (\267)SH /Times-Roman SF 10780 XM (The system) 153 W( manager may have lines other than your own protected \050or owned by the system\051. On)152 W 10780 19268 MT (RSTS/E lines are often made unaccessible unless your account) 87 W( possesses the needed privilege\050s\051. On)88 W 10780 20373 MT (RSX-11M/M+, privilege is required to alter settings on any other terminal line. You may have to talk) 1 W( to)SH 10780 21478 MT (your system manager to get access to an outgoing terminal line.)SH /Symbol SF 10070 23467 MT (\267)SH /Times-Roman SF 10780 XM (Once connected to a modem through another line, a means must exist for the connection to be) SH( broken \050if)1 W 10780 24572 MT (the host) 74 W( you are calling won't do it\051. Given that your line has full or partial modem control \050DZV11,)73 W 10780 25677 MT (DZ11, DH11, DHU/V11\051 the RSX, RT-11/TSX+ and RSTS/E Kermits have a HANGUP \050or)388 W 10780 26782 MT (DISCONNECT\051 command, which) 76 W( instructs the system to disconnect the modem. Unless this is done,)75 W 10780 27887 MT (you never get disconnected and could run up a tidy phone bill.)SH 8280 30279 MT (Kermit-11 has, as of v3.53, a rudimentary command line editor. You) 186 W( can recall previous commands with the)187 W 8280 31475 MT (UP-Arrow key, and exit) 163 W( the command with the LEFT and RIGHT arrow keys. The RUBOUT key, of course,)162 W 8280 32671 MT (deletes characters, while the Control-R key retypes) 52 W( the line. Control-E moves to the end of the line and Control-H)53 W 8280 33867 MT (moves to the start of the line.)SH 14 /Times-Bold AF 8280 37469 MT (13.3. Kermit-11 Commands)SH 10 /Times-Roman AF 8280 39587 MT (Kermit-11 has the following commands available:)SH 8530 41197 MT (@)SH 17780 XM (Synonym for TAKE)SH 8530 42302 MT (BYE)SH 17780 XM (Logout a remote server)SH 8530 43407 MT (CONNECT)SH 17780 XM (Connect to a remote system)SH 8530 44512 MT (COPY)SH 17780 XM (Local copy of a file\050s\051)SH 8530 45617 MT (CWD)SH 17780 XM (Set new working directory)SH 8530 46722 MT (DELETE)SH 17780 XM (Local delete of a file\050s\051)SH 8530 47827 MT (DIAL)SH 17780 XM (Have a connected modem dial a number)SH 8530 48932 MT (DIRECT)SH 17780 XM (Local directory display)SH 8530 50037 MT (DISCONNECT)SH 17780 XM (Hangup a remote line)SH 8530 51142 MT (DISPLAY)SH 17780 XM (Internal debugging)SH 8530 52247 MT (ERASE)SH 17780 XM (Local delete of a file\050s\051)SH 8530 53352 MT (EXIT)SH 17780 XM (Exit to system)SH 8530 54457 MT (FINISH)SH 17780 XM (Stop a remote server without logging out)SH 8530 55562 MT (GET)SH 17780 XM (Get a file\050s\051 from a remote server)SH 8530 56667 MT (HANGUP)SH 17780 XM (Hangup a remote line)SH 8530 57772 MT (HOST)SH 17780 XM (Execute system command locally \050where applicable\051)SH 8530 58877 MT (LOCAL)SH 17780 XM (Force interpretation of command to the local system)SH 8530 59982 MT (LOGFILE)SH 17780 XM (Create a log file)SH 8530 61087 MT (QUIT)SH 17780 XM (Same as EXIT)SH 8530 62192 MT (PRINT)SH 17780 XM (Print a file locally \050where applicable\051)SH 8530 63297 MT (RECEIVE)SH 17780 XM (Receive a file\050s\051 from a remote kermit)SH 8530 64402 MT (REMOTE)SH 17780 XM (Prefix for file management commands to a server)SH 8530 65507 MT (RENAME)SH 17780 XM (Local rename of filename\050s\051)SH 8530 66612 MT (SEND)SH 17780 XM (Send a file\050s\051 to a remote Kermit)SH 8530 67717 MT (SERVER)SH 17780 XM (start a Kermit server)SH 8530 68822 MT (SET)SH 17780 XM (Change Kermit parameters)SH 8530 69927 MT (SHOW)SH 17780 XM (Display Kermit parameters)SH 8530 71032 MT (TAKE)SH 17780 XM (Execute indirect command file)SH ES %%Page: 266 267 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 266)SH 12 /Times-Bold AF 31186 XM (Kermit User Guide: PDP-11 Kermit \05013.3\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6370 7886 MT (TYPE)SH 15620 XM (Local display of file on terminal)SH 6370 8991 MT (WHO)SH 15620 XM (Local display of logged in users \050RSTS/E only\051)SH 14 /Times-Bold AF 6120 12593 MT (13.4. Commands for File Transfer)SH 10 /Times-Roman AF 6120 14711 MT (Kermit-11 includes the standard repertoire of Kermit file transfer commands, including) 182 W( SEND, RECEIVE, and)181 W 6120 15907 MT (GET.)SH 13 /Times-Bold AF 23452 19266 MT (The SEND Command)SH 10 /Times-Roman AF 6120 21639 MT (Syntax:)SH /Courier SF 9676 XM (SEND)SH /Times-Italic SF 12676 XM (filespec)SH /Times-Roman SF 6120 24031 MT (The SEND command causes a file or file group to be sent from the PDP-11 to the) 20 W( other system. If filespec contains)21 W 6120 25227 MT (wildcard characters then all matching files will) 164 W( be sent, in alphabetical order \050according to the ASCII collating)163 W 6120 26423 MT (sequence\051 by name. If filespec does not contain any wildcard characters, then the single file specified by) 79 W( filespec)80 W 6120 27619 MT (will be sent.)SH /Times-Bold SF 8120 29897 MT (SEND Command General Operation)SH /Times-Roman SF 6120 31663 MT (:)SH 6120 34055 MT (Files will be sent with their PDP-11 file name and type \050for instance) 11 W( FOO.BAR\051. Each file will be sent according to)10 W 6120 35251 MT (the record type and attributes recorded in its) 5 W( file descriptor. Kermit-11 attempts to translate all formats of text file to)6 W 6120 36447 MT (a format usable on any system. Note that there is no need to set the FILE TYPE parameter for) 52 W( sending files, since)51 W 6120 37643 MT (Kermit-11 always uses the information from the file directory entry) 16 W( and the filetype \050extension\051 to determine how to)17 W 6120 38839 MT (send the file.)SH 6120 41231 MT (If communication line parity is being used \050see SET PARITY\051, Kermit-11 will request that the other Kermit use a)71 W 6120 42427 MT (special kind of prefix notation for binary) 36 W( files. This is an advanced feature, and not all Kermits have it; if the other)37 W 6120 43623 MT (Kermit does not agree to use this feature, binary files) 64 W( cannot be sent correctly. This includes executable programs)63 W 6120 44819 MT (\050like)SH /Courier SF 8326 XM (.EXE)SH /Times-Roman SF 11099 XM (files, CP/M)123 W /Courier SF 16208 XM (.COM)SH /Times-Roman SF 18982 XM (files\051, relocatable object modules \050)124 W /Courier SF (.OBJ)SH /Times-Roman SF 36110 XM (files\051, as well as any text file containing)124 W 6120 46015 MT (characters with the eighth bit on.)SH 6120 48407 MT (Kermit-11 will also ask the other Kermit whether it can handle a special prefix encoding for repeated characters. If)34 W 6120 49603 MT (it can,) 30 W( then files with long strings of repeated characters will be transmitted very efficiently. Columnar data, highly)31 W 6120 50799 MT (indented text, and binary files are the major beneficiaries of this technique.)SH 6120 53191 MT (If you're running) 63 W( Kermit-11 locally, for instance dialing out from a PDP-11 to another system using an autodialer,)62 W 6120 54387 MT (you should have already) 64 W( run Kermit on the remote system and issued either a RECEIVE or a SERVER command.)65 W 6120 55583 MT (Once you give Kermit-11 the SEND command, the name of each file will be displayed on your screen as the transfer)3 W 6120 56779 MT (begins. As) 292 W( the transfer continues, you will get a small display of the packet count along with) 21 W( the number of packets)22 W 6120 57975 MT (rejected. See) 610 W( the SET TERMINAL and SET UPDATE commands for more information.) 180 W( You) 609 W( may also type)179 W 6120 59171 MT (Control-X or) 59 W( Control-Z to interrupt the current file or file group. Control-E will also abort the transfer by sending)60 W 6120 60367 MT (an 'error' packet to the other Kermit.)SH ES %%Page: 267 268 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (13.4. Commands for File Transfer)SH 10 /Times-Italic AF 51275 XM (Page 267)SH 46800 50 8280 5709 UL 13 /Times-Bold AF 24565 8071 MT (The RECEIVE command)SH 10 /Times-Roman AF 8280 10444 MT (Syntax:)SH /Courier SF 11836 XM (RECEIVE [)SH /Times-Italic SF (filespec)SH /Courier SF (])SH /Times-Roman SF 8280 12836 MT (The RECEIVE command) 76 W( tells Kermit-11 to receive a file or file group from the other system. The name is taken)75 W 8280 14032 MT (from the incoming file header.) 39 W( If) 329 W( an incoming file has the same name as an existing file, Kermit-11 will by default)40 W 8280 15228 MT (create a new file. On RT-11 and RSTS/E, the old file will be) 123 W( deleted by the executive. On RSX-11M/M+ and)122 W 8280 16424 MT (P/OS, a new file with a) 43 W( higher version number will be created. To avoid files being superceded, see the SET FILE)44 W 8280 17620 MT ([NO]SUPERCEDE command.)SH 8280 20012 MT (Incoming files will all be stored with the prevailing file type, ASCII by default, which is appropriate for text files. If)4 W 8280 21208 MT (you are asking Kermit-11) 98 W( to receive binary files from a microcomputer or other 8-bit system, you must first type)99 W 8280 22404 MT (SET FILE TYPE FIXED. Otherwise,) 62 W( an error may occur when receiving the file. Please note that this does NOT)61 W 8280 23600 MT (apply to two Kermit-11 programs connected to each other. In that case the sending Kermit-11) 16 W( will tell the receiving)17 W 8280 24796 MT (Kermit-11 to switch to binary mode if need be.)SH 8280 27188 MT (If parity is being used on the communications line, then 8th-bit prefixing will be requested. If the other side) 32 W( cannot)31 W 8280 28384 MT (do this, binary files cannot be transferred correctly.)SH 8280 30776 MT (If you) 47 W( are running Kermit-11 locally, you should already have issued a SEND command to the remote Kermit, and)48 W 8280 31972 MT (then escaped back to Kermit-11. As files arrive, their names will be displayed on your screen.)SH 8280 34364 MT (If a file arrives that you don't really want, you can attempt to cancel it) 7 W( by typing Control-X; this sends a cancellation)6 W 8280 35560 MT (request to the remote Kermit. If the remote Kermit understands this) 132 W( request \050not all implementations of Kermit)133 W 8280 36756 MT (support this feature\051, it will comply; otherwise it will continue to send. If a file) 23 W( group is being sent, you can request)22 W 8280 37952 MT (the entire group be cancelled by typing Control-Z.)SH 8280 40344 MT (Normally, one runs the remote Kermit as a SERVER, thus the RECEIVE command is never) 60 W( used, rather, the GET)61 W 8280 41540 MT (command, described next, is used.)SH 13 /Times-Bold AF 25973 44899 MT (The GET Command)SH 10 /Times-Roman AF 8280 47272 MT (Syntax:)SH /Courier SF 11836 XM (GET [)SH /Times-Italic SF (remote-filespec)SH /Courier SF (])SH /Times-Roman SF 8280 49664 MT (The GET command requests a) 20 W( remote Kermit server to send the file or file group specified by)19 W /Times-Italic SF 46349 XM (remote-filespec)SH /Times-Roman SF (. This)288 W 8280 50860 MT (command can be used only when Kermit-11) 51 W( is local, with a Kermit server on the other end of the line specified by)52 W 8280 52056 MT (SET LINE. This means that you) 62 W( must have CONNECTed to the other system, logged in, run Kermit there, issued)61 W 8280 53252 MT (the SERVER command, and escaped back to the PDP-11.)SH 8280 55644 MT (The remote filespec is any string that can) 137 W( be a legal file specification for the remote system; it is not parsed or)138 W 8280 56840 MT (validated locally. Any leading) 9 W( spaces before the remote filespec are stripped, and lower case characters are raised to)8 W 8280 58036 MT (upper case.)SH 8280 60428 MT (As files arrive, their names will be displayed on your screen. As in the RECEIVE command, Control-X \050)105 W /Courier SF (^X)SH /Times-Roman SF (\051 to)105 W 8280 61624 MT (request that the current incoming file be ancelled,)SH /Courier SF 28359 XM (^Z)SH /Times-Roman SF 29809 XM (to request that the entire incoming batch be cancelled.)SH 8280 64016 MT (If the remote Kermit) 5 W( is not capable of server functions, then you will probably get an error message back from it like)4 W 8280 65212 MT ("Illegal packet type". In this case, you must connect to the other Kermit,) 34 W( give a SEND command, escape back, and)35 W 8280 66408 MT (give a RECEIVE command.)SH ES %%Page: 268 269 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 268)SH 12 /Times-Bold AF 30286 XM (Kermit User Guide: PDP-11 Kermit \05013.4.1\051)SH 46800 50 6120 5709 UL 6120 8004 MT (13.4.1. Server Operation)SH 10 /Times-Roman AF 6120 9946 MT (The SERVER command puts a remote Kermit-11 in "server mode", so that it receives all further commands in)153 W 6120 11142 MT (packets from the local Kermit. The Kermit-11 server is capable \050as) 151 W( of this writing\051 of executing the following)152 W 6120 12338 MT (remote server commands:) 233 W( SEND, GET, FINISH, BYE, REMOTE DIRECTORY, REMOTE CWD, REMOTE)232 W 6120 13534 MT (SPACE, REMOTE DELETE, REMOTE) 346 W( TYPE, REMOTE HELP, REMOTE COPY, REMOTE RENAME,)347 W 6120 14730 MT (REMOTE WHO, REMOTE LOGIN and REMOTE HOST.)SH 6120 17122 MT (Any nonstandard parameters should be) 36 W( selected with SET commands before putting Kermit-11 into server mode, in)35 W 6120 18318 MT (particular the file type. The Kermit-11 server can send all files) 146 W( in the correct manner automatically. As noted)147 W 6120 19514 MT (before, if a) 114 W( Kermit-11 is talking to another Kermit-11, they will negotiate any 'binary' parameters automatically.)113 W 6120 20710 MT (However, if this is NOT the case and you need) 2 W( to ask Kermit-11 to receive binary files you must issue the SET FILE)3 W 6120 21906 MT (TYPE FIX command before putting it into server mode, and then you must only send binary files. You cannot send)18 W 6120 23102 MT (a mixture of text files and 8-bit binary files to a Kermit-11 server unless the files are not for use on the PDP-11.)SH 12 /Times-Bold AF 6120 26218 MT (13.4.2. Commands for Servers)SH 10 /Times-Roman AF 6120 28160 MT (When running in local mode, Kermit-11 allows you to give a wide range) 67 W( of commands to a remote Kermit server,)68 W 6120 29356 MT (with no guarantee the that) 80 W( the remote server can process them, since they are all optional features of the protocol.)79 W 6120 30552 MT (Commands for servers include the standard SEND, GET, BYE, FINISH) 207 W( commands, as well as the REMOTE)208 W 6120 31748 MT (command.)SH 13 /Times-Bold AF 23849 35107 MT (The BYE Command)SH 10 /Times-Roman AF 6120 37480 MT (The BYE command tells a) 91 W( remote server to log out of the remote system. In addition, some remote systems will)90 W 6120 38676 MT (also disconnect the line for you. If this is not the case, the DISCONNECT command will \050depending on your)152 W 6120 39872 MT (interface\051 cause the line to be dropped. See DISCONNECT.)SH 13 /Times-Bold AF 22946 43231 MT (The FINISH Command)SH 10 /Times-Roman AF 6120 45604 MT (The FINISH) 93 W( command tells the remote Kermit server to exit without logging out of the remote system. You can)92 W 6120 46800 MT (then CONNECT back to the Server operation system.)SH 13 /Times-Bold AF 22297 50159 MT (The REMOTE Command)SH 10 /Times-Roman AF 6120 52532 MT (Send the specified command to the remote server. If the server does not understand the command) 136 W( \050all of these)137 W 6120 53728 MT (commands are optional features of the Kermit protocol\051, it will reply with) 50 W( a message like "Unknown Kermit server)49 W 6120 54924 MT (command". If) 656 W( does understand, it will send the results back, and they will be displayed) 203 W( on the screen. The)204 W 6120 56120 MT (REMOTE commands are:)SH 6120 57911 MT (REMOTE COPY)SH /Times-Italic SF 13398 XM (filespec newfilespec)SH /Times-Roman SF 14120 59016 MT (Copy file. The) 70 W( server is asked to make a copy of the specified file. Both filespecs must be in)71 W 14120 60121 MT (the correct format for the remote system.) 284 W( Kermit-11) 817 W( does not parse or validate the file)283 W 14120 61226 MT (specifications. Any) 258 W( leading spaces will be stripped and lower case) 4 W( characters converted to upper)5 W 14120 62331 MT (case. Note) 346 W( that this command) 48 W( simply provides for copying a file within the server's system - it)47 W 14120 63436 MT (does not cause a file to be transferred.)SH 6120 65013 MT (REMOTE CWD)SH /Times-Italic SF 13064 XM (directory)SH /Times-Roman SF 14120 66118 MT (Change Working Directory. If no directory) 160 W( name is provided, the server will change to the)159 W 14120 67223 MT (default or home directory. Kermit-11 currently does not ask for a password.)SH 6120 68800 MT (REMOTE DELETE)SH /Times-Italic SF 14508 XM (filespec)SH /Times-Roman SF 14120 69905 MT (Delete the specified file or files. The names of the) 121 W( files that are deleted will appear on your)120 W 14120 71010 MT (screen.)SH ES %%Page: 269 270 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (13.4.2. Commands for Servers)SH 10 /Times-Italic AF 51275 XM (Page 269)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (REMOTE DIRECTORY [)SH /Times-Italic SF (filespec)SH /Times-Roman SF (])SH 16280 8991 MT (The names of the files that match the given) 70 W( file specification will be displayed on your screen,)69 W 16280 10096 MT (perhaps along with size and date information for each file. If no file specification is given, all)72 W 16280 11201 MT (files from the current directory will be listed.)SH 8280 12778 MT (REMOTE HELP)SH 16280 XM (The remote server will send back a list of server commands that it can execute.)SH 8280 14355 MT (REMOTE HOST)SH /Times-Italic SF 15502 XM (command)SH /Times-Roman SF 16280 15460 MT (Pass the given command to the server's host command processor, and display the) 190 W( resulting)191 W 16280 16565 MT (output on your screen. Not all Kermit) 84 W( servers can do this function. In the case of Kermit-11,)83 W 16280 17670 MT (only the RSTS/E Kermit-11 server can execute the REMOTE HOST command.)SH 8280 19247 MT (REMOTE LOGIN)SH /Times-Italic SF 16001 XM (user password)SH /Times-Roman SF 16280 20352 MT (Ask a remote server to log into a different account or username.) 38 W( The) 325 W( support for this command)37 W 16280 21457 MT (is rarely implemented as many) 262 W( systems layer login/logout support over the executive. A)263 W 16280 22562 MT (Kermit-11 server can only support) 47 W( this on RSTS/E, and at that only for version 9.0 or later. Of)46 W 16280 23667 MT (the various DEC PDP-11 operating systems, only) 12 W( RSTS/E has the support for logging in and out)13 W 16280 24772 MT (built into the executive and accessible with directives.)SH 8280 26349 MT (REMOTE RENAME)SH /Times-Italic SF 17113 XM (oldfile newfile)SH /Times-Roman SF 16280 27454 MT (Change the name on the specified file \050or files\051. Both file) 83 W( specifications must be valid for the)84 W 16280 28559 MT (server's system.)SH 8280 30136 MT (REMOTE SPACE)SH 16280 XM (Display information about disk usage in the current directory.)SH 8280 31713 MT (REMOTE TYPE)SH /Times-Italic SF 15391 XM (filespec)SH /Times-Roman SF 16280 32818 MT (Display the contents of the specified file on your screen.)SH 8280 34395 MT (REMOTE WHO)SH 16280 XM (Display current status of user's logged in.)SH 14 /Times-Bold AF 8280 37997 MT (13.5. Commands for Local File Management)SH 10 /Times-Roman AF 8280 40115 MT (These commands provide some local file management capability without having to) 99 W( leave the Kermit-11 program.)100 W 8280 41311 MT (These commands are very similar to the REMOTE commands in function and syntax. They are) 8 W( all executed locally,)7 W 8280 42507 MT (and are available when Kermit-11 is either local or remote. The arguments to these commands) 50 W( are the same as the)51 W 8280 43703 MT (arguments expected from the user Kermit when Kermit-11 is processing a command in server mode. Additionally,)47 W 8280 44899 MT (these commands can be prefixed by the LOCAL keyword.)SH 8280 46509 MT (COPY)SH /Times-Italic SF 11197 XM (filespec newfilespec)SH /Times-Roman SF 8280 47614 MT (CWD)SH /Times-Italic SF 10863 XM (directory)SH /Times-Roman SF 8280 48719 MT (DELETE)SH /Times-Italic SF 12307 XM (filespec)SH /Times-Roman SF 8280 49824 MT (DIRECTORY [)SH /Times-Italic SF (filespec)SH /Times-Roman SF (])SH 8280 50929 MT (HELP)SH 8280 52034 MT (HOST)SH /Times-Italic SF 11141 XM (command)SH /Times-Roman SF 8280 53139 MT (RENAME)SH /Times-Italic SF 12752 XM (oldfile newfile)SH /Times-Roman SF 8280 54244 MT (SPACE)SH 8280 55349 MT (TYPE)SH /Times-Italic SF 11030 XM (filespec)SH /Times-Roman SF 8280 56454 MT (WHO)SH 12 /Times-Bold AF 8280 59570 MT (13.5.1. The CONNECT Command)SH 10 /Times-Roman AF 8280 61512 MT (The CONNECT command will allow you to connect in as a terminal over the line that was specified by the) 93 W( SET)94 W 8280 62708 MT (LINE command. \050Using the CONNECT command before using the SET) 123 W( LINE command will result in an error)122 W 8280 63904 MT (message.\051 The) 250 W( terminal line must be one which is accessible to the user.)SH 8280 66296 MT (The distributed RSX-11M/M+ task has been built with the)4 W /Courier SF 31963 XM (/PR:0)SH /Times-Roman SF 35217 XM (switch to enable the task to change other) 4 W( terminal)5 W 8280 67492 MT (settings. Additionally,) 708 W( for RSX-11M/M+, the MCR command)229 W /Courier SF 35427 XM (SET /SLAVE=TT)229 W /Times-Italic SF (nn)SH /Courier SF (:)SH /Times-Roman SF 45535 XM (should be done) 229 W( before)228 W 8280 68688 MT (entering Kermit-11.)SH 8280 71080 MT (If you are running)SH /Courier SF 15778 XM (K11POS.TSK)SH /Times-Roman SF 22028 XM (on a PRO/350, Kermit will set the line to)SH /Courier SF 38695 XM (XK0:)SH /Times-Roman SF 41345 XM (and the speed to 9600 by default.)SH ES %%Page: 270 271 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 270)SH 12 /Times-Bold AF 30286 XM (Kermit User Guide: PDP-11 Kermit \05013.5.1\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (Please note that Kermit-11 CAN NOT change the speed of a) 54 W( DL11 type interface, nor can it change the speed of a)55 W 6120 9082 MT (PDT-150 modem port \050use SPEED.SAV\051.)SH 6120 11474 MT (The following is an example of using a Racal-Vadic VA212) 154 W( autodialing modem to log into a remote TOPS-20)153 W 6120 12670 MT (system. There) 398 W( is one point) 74 W( at which there is no echoing of the user input, this is following the typing of the local)75 W 6120 13866 MT ('escape sequence', which by default is Control-)128 W /Courier SF (\134)SH /Times-Roman SF 26889 XM (followed by a 'c'.) 128 W( The) 505 W( control-backslash informs the terminal)127 W 6120 15062 MT (emulator that the next character is) 88 W( a command. In this case, the command was 'C', which means to return to the)89 W 6120 16258 MT (local PDP-11 system. Control-)58 W /Courier SF (\134)SH /Times-Roman SF 19788 XM (followed by)58 W /Courier SF 24959 XM (?)SH /Times-Roman SF 25867 XM (would print a help message. All the commands prior to the) 58 W( DIAL)57 W 6120 17454 MT (command were contained in the INI file,)SH /Courier SF 22616 XM (KERMIT.INI)SH /Times-Roman SF (.)SH /Courier SF 8520 19109 MT ($ kermit)SH 8520 20140 MT (Kermit-11 V3.46 Last edit: 21-Feb-1986)SH 8520 21171 MT (Kermit-11>set modem vadic)SH 9000 50 14520 21371 UL 8520 22202 MT (Kermit-11>set pho num cu 9K12121234567)SH 16800 50 14520 22402 UL 8520 23233 MT (Kermit-11>set logfile 20.log)SH 10800 50 14520 23433 UL 8520 24264 MT (Kermit-11>set deb console)SH 9000 50 14520 24464 UL 8520 25295 MT (Kermit-11>set lin tt58:)SH 7800 50 14520 25495 UL 8520 26326 MT (Link: TT58: Speed: 9600, DTR not present)SH 8520 27357 MT (Kermit-11>set dtr)SH 4200 50 14520 27557 UL 8520 28388 MT (Kermit-11>set spe 1200)SH 7200 50 14520 28588 UL 8520 29419 MT (Kermit-11>dial cu)SH 4200 50 14520 29619 UL 8520 30450 MT (Using: 9K12121234567)SH 8520 31481 MT (Connection established, type CONNECT to access remote)SH 8520 32512 MT (Kermit-11>connect)SH 4200 50 14520 32712 UL 8520 34167 MT (enter class 4)SH 8520 35198 MT (class 004 start)SH 8520 36853 MT (CU20B)SH 8520 37884 MT (@log xx.abcdef)SH 9120 38915 MT (CU20B, TOPS-20 Monitor 5.1\0505101\051-2)SH 9120 39946 MT (Job 28, TTY32, 2-Apr-84 4:15:24PM)SH 9120 40977 MT (Previous login was 2-Apr-84 4:10:16PM)SH 13320 42008 MT (.)SH 13320 43039 MT (.)SH 8520 44070 MT (@logout)SH 8520 45101 MT ([Confirm])SH 8520 46132 MT (Logged out Job 28, User XX.ABCDEF , TTY 32,)SH 9720 47163 MT (at 2-Apr-84) 600 W( 16:19:34, Used 0:00:11 in 0:04:10)SH 8520 48818 MT (Kermit-11>disc)SH 2400 50 14520 49018 UL 8520 49849 MT (KERMIT link TT58: disconnected)SH 8520 50880 MT (Kermit-11>exit)SH 2400 50 14520 51080 UL 8520 52535 MT ($ logout)SH 14 /Times-Bold AF 6120 56137 MT (13.6. The SET Command)SH 10 /Times-Roman AF 6120 58255 MT (Syntax:)SH /Courier SF 9426 XM (SET)SH /Times-Italic SF 11826 XM (parameter keyword)SH /Times-Roman SF 6120 60647 MT (The SET command is used to set various parameters in Kermit. The format of the SET command is:)SH 12 /Times-Bold AF 6120 63235 MT (SET ATTRIBUTES)SH 10 /Times-Roman AF 6120 64649 MT (Syntax:)SH /Courier SF 9426 XM (SET ATTRIBUTES {ON, OFF})SH /Times-Roman SF 6120 67041 MT (Part of the Kermit protocol is the support of file attributes. Connected) 265 W( Kermits that support this can send)266 W 6120 68237 MT (information to each other about file) 90 W( size, time/date of creation, RMS file headers and other useful things. Due to)89 W 6120 69433 MT (potential problems with incompatible implementations this feature can) 229 W( be disabled. In this case, the sending)230 W 6120 70629 MT (Kermit-11 will never try to send file attributes, even though the receiver may have indicated that it supports this.)SH ES %%Page: 271 272 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (13.6. The SET Command)SH 10 /Times-Italic AF 51275 XM (Page 271)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (SET BAUD)SH 10 /Times-Roman AF 8280 9418 MT (This is the same as SET SPEED. See HELP SET SPEED)SH 12 /Times-Bold AF 8280 12006 MT (SET BINARY-TYPE)SH 10 /Times-Roman AF 8280 13420 MT (Kermit-11 has) 25 W( a default list of filetypes that are scanned to decide if a file should be sent in binary mode in addition)24 W 8280 14616 MT (to checking file attributes for RSX, P/OS and RSTS/E.) 166 W( The) 583 W( user can, however, override this list with the this)167 W 8280 15812 MT (command. The) 462 W( default) 106 W( list is fairly inclusive, with types such as)105 W /Courier SF 35541 XM (.SAV)SH /Times-Roman SF 38296 XM (and)SH /Courier SF 40095 XM (.TSK)SH /Times-Roman SF 42850 XM (forcing Kermit-11 into binary)105 W 8280 17008 MT (transmission. See) 250 W( HELP SET FIL for the default list. Examples:)SH /Courier SF 10680 18663 MT (Kermit-11> set binary-type .sav)SH 12000 50 17280 18863 UL 10680 19694 MT (Kermit-11> set bin .exe)SH 7200 50 17280 19894 UL 12 /Times-Bold AF 8280 22282 MT (SET BLOCK-CHECK)SH 10 /Times-Roman AF 8280 23696 MT (Syntax:)SH /Courier SF 11586 XM (SET BLOCK_CHECK {1, 2, 3})SH /Times-Roman SF 8280 26088 MT (The SET) 164 W( BLOCKCHECK command is used to determine the block check sequence which will be used during)165 W 8280 27284 MT (transmission. The) 316 W( block check sequence is used to) 33 W( detect transmission errors. There are three types of block check)32 W 8280 28480 MT (available. These) 424 W( are the single character checksum \050default\051,) 87 W( the two character checksum, and the three character)88 W 8280 29676 MT (CRC \050cyclic redundancy check\051. This command does not ensure that the desired type of block) 53 W( check will be used,)52 W 8280 30872 MT (since both) 100 W( Kermit's involved in the transfer must agree on the block check type. Kermit-11 will request that the)101 W 8280 32068 MT (type of block check set by this command be used for a transfer. If the other Kermit) 91 W( has also had the same block)90 W 8280 33264 MT (check type requested, then the desired) 15 W( block check type will be used. Otherwise, the single character checksum will)16 W 8280 34460 MT (be used.) 26 W( The) 300 W( command should be given to BOTH Kermits since Kermit-11, when in server mode, has no say about)25 W 8280 35656 MT (what kind of checksum it wants to use. \050See Kermit protocol manual for more information.\051)SH 12 /Times-Bold AF 8280 38244 MT (SET CONSOLE)SH 10 /Times-Roman AF 8280 39658 MT (Syntax:)SH /Courier SF 11586 XM (SET CONSOLE {7, 8})SH /Times-Roman SF 8280 42050 MT (The SET CONSOLE command is used under P/OS to control the passing) 98 W( of 8 bit data to the terminal during the)99 W 8280 43246 MT (connect command. If you are getting multinational characters being printed, this is) 56 W( a very useful thing to set. The)55 W 8280 44442 MT (default is SET CON 7.)SH 12 /Times-Bold AF 8280 47030 MT (SET DEBUG)SH 10 /Times-Roman AF 8280 48444 MT (Syntax:)SH /Courier SF 11586 XM (SET DEBUG {ALL, CONSOLE, CONNECT, FILE, PACKET, STATE})SH /Times-Roman SF 8280 50836 MT (The SET DEBUG command is used to) 68 W( specify the type and level of debugging to a disk file . This disk file must)69 W 8280 52032 MT (have been created by the SET LOGFILE command.)SH /Times-Bold SF 10280 54310 MT (SET DEBUG ALL)SH /Times-Roman SF 8280 56702 MT (SET DEBUG ALL will turn on logging for) 151 W( CONSOLE,CONNECT,FILE,PACKET and STATE to the disk file)150 W 8280 57898 MT (specified by SET LOGFILE. This command is the same as SET DEBUG ON. The command format is:)SH /Times-Bold SF 10280 60176 MT (SET DEBUG CONSOLE)SH /Times-Roman SF 8280 62568 MT (SET DEBUG CONSOLE will turn on logging for all) 59 W( i/o during a remote connect to the disk file specified by SET)60 W 8280 63764 MT (LOGFILE. This) 250 W( command is the same as SET DEBUG CONNECT.)SH /Times-Bold SF 10280 66042 MT (SET DEBUG CONNECT)SH /Times-Roman SF 8280 68434 MT (SET DEBUG) 55 W( CONNECT will turn on logging for all i/o during a remote connect to the disk file specified by SET)54 W 8280 69630 MT (LOGFILE. This) 250 W( command is the same as SET DEBUG CONSOLE.)SH /Times-Bold SF 10280 71908 MT (SET DEBUG FILE)SH ES %%Page: 272 273 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 272)SH 12 /Times-Bold AF 31186 XM (Kermit User Guide: PDP-11 Kermit \05013.6\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (SET DEBUG FILE will log all file 'opens' and 'creates' to the file specified by SET LOGFILE.)SH /Times-Bold SF 8120 10164 MT (SET DEBUG HELP)SH /Times-Roman SF 6120 12556 MT (SET DEBUG HELP gives the user a list of all qualifiers which can be used with SET DEBUG.)SH /Times-Bold SF 8120 14834 MT (SET DEBUG NONE)SH /Times-Roman SF 6120 17226 MT (SET DEBUG NONE 'turns off' all debugging. This is the same as the SET DEBUG OFF command.)SH /Times-Bold SF 8120 19504 MT (SET DEBUG OFF)SH /Times-Roman SF 6120 21896 MT (SET DEBUG OFF 'turns off' all debugging. This is the same as the SET DEBUG NONE command.)SH /Times-Bold SF 8120 24174 MT (SET DEBUG ON)SH /Times-Roman SF 6120 26566 MT (SET DEBUG ON will 'turn on') 138 W( logging for CONSOLE,CONNECT,FILE,PACKET and STATE to the disk file)139 W 6120 27762 MT (specified by SET LOGFILE. This command is the same as SET DEBUG ALL.)SH /Times-Bold SF 8120 30040 MT (SET DEBUG PACKET)SH /Times-Roman SF 6120 32432 MT (SET DEBUG PACKET will 'turn on') 65 W( logging of all receive and transmit packets to the disk file specified by SET)64 W 6120 33628 MT (LOGFILE.)SH /Times-Bold SF 8120 35906 MT (SET DEBUG STATE)SH /Times-Roman SF 6120 38298 MT (SET DEBUG STATE will turn on logging of all internal Kermit-11 state transitions.)SH 13 /Times-Bold AF 25853 41657 MT (SET DELAY)SH 10 /Times-Roman AF 6120 44030 MT (Syntax:)SH /Courier SF 9426 XM (SET DELAY)SH /Times-Italic SF 15426 XM (seconds)SH /Times-Roman SF 6120 46422 MT (The DELAY parameter is) 16 W( the number of seconds to wait before sending data after a SEND command is given. This)17 W 6120 47618 MT (is used when Kermit-11 is running in remote) 88 W( mode to allow the user time to escape back to the other Kermit and)87 W 6120 48814 MT (give a RECEIVE command.)SH 13 /Times-Bold AF 25023 52173 MT (SET DEFAULT)SH 10 /Times-Roman AF 6120 54546 MT (Syntax:)SH /Courier SF 9426 XM (SET DEFAULT)SH /Times-Italic SF 16626 XM (device)SH /Times-Roman SF 6120 56938 MT (The DEFAULT parameter allows you to specify a device and) 171 W( UIC \050or PPN\051 for all subsequent file opens \050for)172 W 6120 58134 MT (SENDING\051 and file creates \050for RECEIVING\051. It is disabled by typing SET HOME. Example:)SH /Courier SF 8520 59789 MT (Kermit-11>set default db2:[200,201])SH 15000 50 14520 59989 UL /Times-Roman SF 6120 61506 MT (This is quite useful for Kermit-11 running on a DECNET link, as you can set the default for file operations to)150 W 6120 62702 MT (include node names and passwords as in:)SH /Courier SF 8520 64357 MT (Kermit-11>set def orion::sys$system:[fubar])SH 19800 50 14520 64557 UL ES %%Page: 273 274 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (13.6. The SET Command)SH 10 /Times-Italic AF 51275 XM (Page 273)SH 46800 50 8280 5709 UL 13 /Times-Bold AF 28663 8071 MT (SET DIAL)SH 10 /Times-Roman AF 8280 10444 MT (Kermit-11 has knowledge built in to it of a number of the more common) 67 W( 'smart' autodial modems. To find out if)68 W 8280 11640 MT (your modem is directly supported try the command SET MODEM ?. If your modem is not in this list then you) 10 W( need)9 W 8280 12836 MT (the SET DIAL command) 217 W( to generate the data base used by Kermit to control the modem. Kermit uses this)218 W 8280 14032 MT (information to implement) 75 W( the DIAL command. A command such as DIAL can only be done when Kermit knows)74 W 8280 15228 MT (both how to format commands to the modem, and what kind of text the modem will send back to it in response.) 24 W( As)299 W 8280 16424 MT (an example, the VADIC VA212PA modem is awakened from) 115 W( an idle state by the character sequence 05 015 \050in)114 W 8280 17620 MT (octal\051, which is a Control-E followed by a carriage return. In response to this two-character) 142 W( string, the modem)143 W 8280 18816 MT (responds with:)SH /Courier SF 10680 20471 MT (HELLO: I'M READY)SH 10680 21502 MT (*)SH /Times-Roman SF 8280 23894 MT (Thus Kermit has to know that when it sends the) 20 W( wakeup sequence it needs to wait for the asterisk to be sent back by)19 W 8280 25090 MT (the modem. At this point Kermit will know that the modem is in a) 26 W( state awaiting further commands, such as that to)27 W 8280 26286 MT (dial a phone number.)SH 8280 28678 MT (It is not possible for Kermit to have) 27 W( knowledge of all makes of modems. Instead Kermit supports a command, SET)26 W 8280 29874 MT (MODEM USER_DEFINED, which then allows you to use the SET DIAL command to inform) 149 W( Kermit how the)150 W 8280 31070 MT (modem works. Once Kermit knows how to control) 77 W( the modem, you can use the DIAL command to initiate a call)76 W 8280 32266 MT (from Kermit.)SH 8280 34658 MT (The SET DIAL commands are:)SH 8280 36268 MT (SET DIAL WAKEUP)SH 29880 XM (Define the wakeup string)SH 8280 37373 MT (SET DIAL PROMPT)SH 29880 XM (Define the prompt the modem uses)SH 8280 38478 MT (SET DIAL INITIATE)SH 29880 XM (Define a string to start dialing)SH 8280 39583 MT (SET DIAL CONFIRM)SH 29880 XM (Define the string to confirm number)SH 8280 40688 MT (SET DIAL FORMAT)SH 29880 XM (Define the number formatting string)SH 8280 41793 MT (SET DIAL SUCCESS)SH 29880 XM (Define string\050s\051 for call complete)SH 8280 42898 MT (SET DIAL INFO)SH 29880 XM (Define string\050s\051 for informative text)SH 8280 44003 MT (SET DIAL FAILURE)SH 29880 XM (Define string\050s\051 for call failure)SH 8280 45108 MT (SET DIAL CONFIRM)SH 29880 XM (Define string for number confirmation)SH 8280 46213 MT (SET DIAL WAKE_RATE)SH 29880 XM (Set pause time between wakeup characters)SH 8280 47318 MT (SET DIAL DIAL_RATE)SH 29880 XM (Set pause time between number digits)SH 8280 48423 MT (SET DIAL DIAL_PAUSE)SH 29880 XM (Define string for dial tone pause)SH 8280 50815 MT (Suppose we had to tell Kermit about the Racal Vadic VA212PA modem \050though in) 88 W( reality Kermit already knows)89 W 8280 52011 MT (about that kind\051. In checking the owners manual for it, we find that:)SH /Symbol SF 10070 53916 MT (\267)SH /Times-Roman SF 10780 XM (To wake the modem up, we type a control E followed by a carriage return.)SH /Symbol SF 10070 55905 MT (\267)SH /Times-Roman SF 10780 XM (To dial a number, we type the letter D followed by a carriage return. At this) 36 W( point, the modem prints a)35 W 10780 57010 MT (NUMBER? prompt,) 412 W( we then type the desired number in. It reprints the number and then waits for a)82 W 10780 58115 MT (carriage return from us to confirm that its really the correct phone number.)SH /Symbol SF 10070 60104 MT (\267)SH /Times-Roman SF 10780 XM (When it completes dialing, it will print 'ON LINE' or 'ONLINE' for a) 20 W( successful call, otherwise it may)19 W 10780 61209 MT (display on the terminal 'BUSY', 'FAILED CALL', 'NO DIAL', 'VOICE' or 'TIME OUT'.) 19 W( While) 289 W( it is)20 W 10780 62314 MT (waiting for its call to be answered, it may) 81 W( print the line 'RINGING' several times in order to tell you)80 W 10780 63419 MT (that it is working on it.)SH 8280 65210 MT (The Kermit commands required would be:)SH /Courier SF 10680 66865 MT (Kermit-11>SET MODEM USER_DEFINED)SH 10680 67896 MT (Kermit-11>SET DIAL WAKEUP \13405\134015)SH 10680 68927 MT (Kermit-11>SET DIAL PROMPT *)SH 10680 69958 MT (Kermit-11>SET DIAL INITIATE D\134015)SH 10680 70989 MT (Kermit-11>SET DIAL FORMAT %P%S\134015)SH ES %%Page: 274 275 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 274)SH 12 /Times-Bold AF 31186 XM (Kermit User Guide: PDP-11 Kermit \05013.6\051)SH 46800 50 6120 5709 UL 10 /Courier AF 8520 7824 MT (Kermit-11>SET DIAL CONFIRM \134015)SH 8520 8855 MT (Kermit-11>SET DIAL SUCCESS ONLINE)SH 8520 9886 MT (Kermit-11>SET DIAL SUCCESS ON LINE)SH 8520 10917 MT (Kermit-11>SET DIAL INFO RINGING)SH 8520 11948 MT (Kermit-11>SET DIAL FAILURE BUSY)SH 8520 12979 MT (Kermit-11>SET DIAL FAILURE FAILED CALL)SH 8520 14010 MT (Kermit-11>SET DIAL FAILURE NO DIAL)SH 8520 15041 MT (Kermit-11>SET DIAL FAILURE VOICE)SH 8520 16072 MT (Kermit-11>SET DIAL FAILURE TIME OUT)SH 8520 17103 MT (Kermit-11>SET DIAL DIAL_PAUSE 9K)SH 8520 18134 MT (Kermit-11>DIAL 14195551212)SH /Times-Roman SF 6120 20526 MT (The notation ")2 W /Courier SF (\13405\134015)SH /Times-Roman SF (" indicates the Control E followed by a carriage return; 05 is octal for control E, 015 is octal)2 W 6120 21722 MT (for carriage return. An alternate) 96 W( notation for octal numbers can be used by placing the value inside of inequality)95 W 6120 22918 MT (characters, as in SET DIAL WAKE <05><015> though the former is preferred.)SH 6120 25310 MT (The notation ")11 W /Courier SF (%P%S\134015)SH /Times-Roman SF (" indicates to Kermit that the phone number from the dial) 11 W( command is to be followed by a)12 W 6120 26506 MT (carriage return; the)10 W /Courier SF 14008 XM (%S)SH /Times-Roman SF 15468 XM (is simply a placeholder for the phone number. The presence of the)10 W /Courier SF 42592 XM (%P)SH /Times-Roman SF 44052 XM (is to indicate where to)9 W 6120 27702 MT (insert the) 3 W( dial pause string, in this case we need to dial 9 and wait for a second dial tone. The "K" is the Racal Vadic)4 W 6120 28898 MT (code to get the modem to pause. If you are dialing on a) 9 W( direct line, the DIAL_PAUSE command is unneeded. If for)8 W 6120 30094 MT (any reason you need to pass a "\134" or "<" to your modem, simply prefix the character with another "\134", as in "\134\134".)SH 6120 32486 MT (Many modems require only the WAKEUP, PROMPT, FORMAT and result strings. The) 187 W( Digital DF112 is an)188 W 6120 33682 MT (example of this; its definition would look like:)SH /Courier SF 8520 35337 MT (Kermit-11>SET MODEM USER_DEFINED)SH 8520 36368 MT (Kermit-11>SET DIAL WAKEUP \13402)SH 8520 37399 MT (Kermit-11>SET DIAL PROMPT READY)SH 8520 38430 MT (Kermit-11>SET DIAL FORMAT %S#)SH 8520 39461 MT (Kermit-11>SET DIAL SUCCESS ATTACHED)SH 8520 40492 MT (Kermit-11>SET DIAL FAILURE BUSY)SH 8520 41523 MT (Kermit-11>SET DIAL FAILURE DISCONNECTED)SH 8520 42554 MT (Kermit-11>SET DIAL FAILURE ERROR)SH 8520 43585 MT (Kermit-11>SET DIAL FAILURE NO ANSWER)SH /Times-Roman SF 6120 45977 MT (Some modems may be unable to accept data at the line speed; in this case we would need to use) 105 W( the SET DIAL)104 W 6120 47173 MT (WAKE_RATE and SET) 27 W( DIAL DIAL_RATE. These two commands accept a delay time in milliseconds; the actual)28 W 6120 48369 MT (delay will not be precise as the PDP-11 line clock interrupts sixty times per second. Furthermore, on RSTS/E the)73 W 6120 49565 MT (finest granularity for timing is one second; thus setting delays would result in delays of one second increments.)SH 6120 51957 MT (In general, not all) 77 W( of the result fields need be specified except for the call completed strings; Kermit will time out)78 W 6120 53153 MT (after a while if it can't match a response with any definitions.)SH 6120 55545 MT (Further information can be found in the sections on SET MODEM, DIAL, REDIAL and SET PHONE.)SH 13 /Times-Bold AF 26756 58904 MT (SET DTR)SH 10 /Times-Roman AF 6120 61277 MT (The SET DTR command is very similar) 228 W( to the DISCONNECT \050or HANGUP\051 command. SET DTR, where)227 W 6120 62473 MT (supported, raises DTR for a predetermined amount) 81 W( of time, whereas the DISCONNECT \050or HANGUP\051 command)82 W 6120 63669 MT (drops DTR. The) 141 W( SET DTR is only functional on RSTS/E, which by default keeps DTR low until either RING)140 W 6120 64865 MT (INDICATOR or CARRIER DETECT goes high.) 28 W( This) 307 W( is opposite of the behavior on RT11 and RSX11M/M+, both)29 W 6120 66061 MT (of which normally assert) 131 W( DTR. The SET DTR command raises DTR for at least 30 seconds \050depending on the)130 W 6120 67257 MT (version of RSTS/E\051 and is useful for making connections to front end switches \050such as MICOM) 44 W( and GANDALF\051.)45 W 6120 68453 MT (On RT11, SET DTR is identical to the HANGUP command; it simply) 110 W( drops DTR for two seconds. In this case)109 W 6120 69649 MT (\050RT11 and TSX+\051 this command is only supported) 105 W( on RT11 5.2 and TSX+ 6.0 with the XL/XC and CL drivers,)106 W 6120 70845 MT (respectively. This) 286 W( command is a no-op on RSX11M/M+ and P/OS. For further information on modem) 18 W( support, see)17 W ES %%Page: 275 276 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (13.6. The SET Command)SH 10 /Times-Italic AF 51275 XM (Page 275)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (the later section regarding such.)SH 13 /Times-Bold AF 27616 11245 MT (SET DUPLEX)SH 10 /Times-Roman AF 8280 13618 MT (Syntax:)SH /Courier SF 11586 XM (SET DUPLEX {FULL, HALF})SH /Times-Roman SF 8280 16010 MT (The DUPLEX parameter controls whether an outgoing link \050set) 72 W( via the SET LINE command\051 is a full duplex link)73 W 8280 17206 MT (\050the default\051 or a half duplex link. All it does for half duplex is to cause all characters) 66 W( typed after the CONNECT)65 W 8280 18402 MT (command to be echoed locally.)SH 13 /Times-Bold AF 25991 21761 MT (SET END-OF-LINE)SH 10 /Times-Roman AF 8280 24134 MT (Syntax:)SH /Courier SF 11586 XM (SET END-OF-LINE )SH /Times-Roman SF 8280 26526 MT (The END-OF-LINE) 4 W( parameter sets the ASCII character which will be used as a line terminator for all packets SENT)5 W 8280 27722 MT (to the other KERMIT. This is normally not needed for most versions of KERMIT.)SH 13 /Times-Bold AF 27724 31081 MT (SET ESCAPE)SH 10 /Times-Roman AF 8280 33454 MT (Syntax)SH /Courier SF 11308 XM (SET ESCAPE)SH /Times-Roman SF 17908 XM (\051)SH 8280 35846 MT (This command will set the) 38 W( escape character for the CONNECT processing. The command will take the octal value)37 W 8280 37042 MT (of the character) 81 W( to use as the escape character. This is the character which is used to "escape" back to Kermit-11)82 W 8280 38238 MT (after using the) 30 W( CONNECT command. It defaults to control \050octal 34\051. It is usually a good idea to set this character)29 W 8280 39434 MT (to something which is not used \050or at least) 209 W( not used very much\051 on the system being to which Kermit-11 is)210 W 8280 40630 MT (CONNECTing.)SH 13 /Times-Bold AF 28772 43989 MT (SET FILE)SH 10 /Times-Roman AF 8280 46362 MT (Syntax:)SH /Courier SF 11586 XM (SET FILE {NOSUPERCEDE, SUPERCEDE, TYPE)SH /Times-Italic SF 34986 XM (file-type)SH /Courier SF (})SH /Times-Roman SF 8280 48754 MT (The SET FILE command allows you to set various file related parameters.)SH 13 /Times-Bold AF 24907 52113 MT (SET FILE TYPE ASCII)SH 10 /Times-Roman AF 8280 54486 MT (File type ASCII is for text files. SET FILE TYPE TEXT is the same.)SH /Times-Bold SF 10280 56764 MT (SET FILE TYPE AUTO)SH /Times-Roman SF 8280 59156 MT (Kermit-11 will normally try to decide if) 47 W( a file must be sent in binary mode based on the file attributes and filetype.)46 W 8280 60352 MT (If, for instance, the directory entry for)33 W /Courier SF 23923 XM (FUBAR.TXT)SH /Times-Roman SF 29606 XM (showed it to be) 33 W( RMS \050or FCS\051 fixed length records, Kermit-11)34 W 8280 61548 MT (will switch to binary mode and send it verbatim. If the) 24 W( receiving Kermit is Kermit-11, then the sending Kermit will)23 W 8280 62744 MT (send attribute data over also. The file types shown in Table 13-1 also will normally be sent as binary files) 78 W( unless)79 W 8280 63940 MT (you use the SET FILE TYPE NOAUTO command.)SH /Times-Bold SF 10280 66218 MT (SET FILE TYPE BINARY)SH /Times-Roman SF 8280 68610 MT (File type BINARY is for non-text files. Note that binary files which are generated on a PDP-11 system cannot) 64 W( be)63 W 8280 69806 MT (transferred to another \050non PDP-11\051) 9 W( system without losing file attributes. This means that \050for example\051, an RSM11)10 W 8280 71002 MT (indexed file cannot be transmitted with Kermit-11 at this time. You can not have parity set to anything but) 50 W( NONE)49 W ES %%Page: 276 277 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 276)SH 12 /Times-Bold AF 31186 XM (Kermit User Guide: PDP-11 Kermit \05013.6\051)SH 46800 50 6120 5709 UL 46800 50 6120 8086 UL 10 /Courier AF 6120 10820 MT (*.TSK)SH /Times-Roman SF 10120 XM (RSX, IAS, and RSTS tasks)SH /Courier SF 6120 11925 MT (*.SAV)SH /Times-Roman SF 10120 XM (RT11 and RSTS save images)SH /Courier SF 6120 13030 MT (*.OBJ)SH /Times-Roman SF 10120 XM (Compiler and macro-11 output)SH /Courier SF 6120 14135 MT (*.STB)SH /Times-Roman SF 10120 XM (TKB and LINK symbol tables)SH /Courier SF 6120 15240 MT (*.CRF)SH /Times-Roman SF 10120 XM (TKB and LINK cross reference files)SH /Courier SF 6120 16345 MT (*.TSD)SH /Times-Roman SF 10120 XM ('Time shared DIBOL' for RT11)SH /Courier SF 6120 17450 MT (*.BAC)SH /Times-Roman SF 10120 XM (RSTS Basic-plus 'compiled' files)SH /Courier SF 6120 18555 MT (*.OLB)SH /Times-Roman SF 10120 XM (RSX, IAS, and RSTS object libraries)SH /Courier SF 6120 19660 MT (*.MLB)SH /Times-Roman SF 10120 XM (RSX, IAS, and RSTS macro libraries)SH /Courier SF 6120 20765 MT (*.RTS)SH /Times-Roman SF 10120 XM (RSTS/E run time systems)SH /Courier SF 6120 21870 MT (*.EXE)SH /Times-Roman SF 10120 XM (VMS executable)SH /Times-Bold SF 22506 23480 MT (Table 13-1:)SH /Times-Roman SF 27867 XM (Kermit-11 File Types)SH 46800 50 6120 25290 UL 6120 26881 MT (to use binary file) 103 W( transfer \050see HELP SET PARITY\051 unless the other Kermit can process eight bit quoting. Two)104 W 6120 28077 MT (Kermit-11's connected to each other will use binary transmission automatically via the Kermit attribute packets,)135 W 6120 29273 MT (preserving file attributes where it makes sense \050i.e. RSTS/E and RSX only\051.)SH /Times-Bold SF 8120 31551 MT (SET FILE TYPE DECMULTINATIONAL)SH /Times-Roman SF 6120 33943 MT (PDP-11 Kermit normally strips the high) 7 W( bit of every character on both transmission and reception of files \050unless the)8 W 6120 35139 MT (SET FILE TYPE FIXED command was given\051.) 8 W( The) 264 W( SET FIL DEC command will cause Kermit-11 to leave all data)7 W 6120 36335 MT (intact but still obey the host) 45 W( file system when reading or writing files. In other words, Kermit will write sequential)46 W 6120 37531 MT (implied carriage control files with eight bit data if this command is used.)SH 12 /Times-Bold AF 6120 40119 MT (SET FILE TYPE FIXED)SH 10 /Times-Roman AF 6120 41533 MT (This is the same as SET FILE TYPE BINARY.)SH /Times-Bold SF 8120 43811 MT (SET FILE TYPE NOAUTO)SH /Times-Roman SF 6120 46203 MT (SET FILE NOAUTO disables Kermit-11 from trying to base binary transmission mode on file attributes or filetype.)SH /Times-Bold SF 8120 48481 MT (SET FILE SUPERCEDE)SH /Times-Roman SF 6120 50247 MT (Syntax:)SH /Courier SF 9426 XM (SET FILE {SUPERCEDE, NOSUPERCEDE})SH /Times-Roman SF 6120 52639 MT (SET FILE [NO]SUPERCEDE allows Kermit-11 to accept or reject files received \050from either the RECEIVE or) 2 W( GET)1 W 6120 53835 MT (commands\051 on a per file basis. The default is) 7 W( SUPERCEDE. By doing SET FILE NOSUPERCEDE Kermit-11 will)8 W 6120 55031 MT (always check) 115 W( to see if the file to be created is already there \050independent of version number\051 and reject it to the)114 W 6120 56227 MT (sending server if it exists. This presumes that the Kermit sending the file) 33 W( understands the protocol to reject one file)34 W 6120 57423 MT (of a) 128 W( \050possibly\051 wildcarded group of files. The main use of this is to resume getting a group of files, as in)127 W /Courier SF 51120 XM (GET)SH 6120 58619 MT (KER:K11*.*)SH /Times-Roman SF 12439 XM (or)SH /Courier SF 13591 XM (GET KER:MS????.*)69 W /Times-Roman SF 23579 XM (having lost the connection after transferring some of the files.) 69 W( If) 390 W( this is)70 W 6120 59815 MT (set, then any files already transferred will not be transferred again.)SH ES %%Page: 277 278 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (13.6. The SET Command)SH 10 /Times-Italic AF 51275 XM (Page 277)SH 46800 50 8280 5709 UL 13 /Times-Bold AF 28231 8071 MT (SET HOME)SH 10 /Times-Roman AF 8280 10444 MT (SET HOME resets the default device and UIC \050or) 91 W( PPN\051 to nothing, ie, all file opens and creates use your default)90 W 8280 11640 MT (disk \050)SH /Courier SF (SY:)SH /Times-Roman SF (\051 and your UIC \050or PPN\051.)SH 13 /Times-Bold AF 26750 14999 MT (SET IBM-MODE)SH 10 /Times-Roman AF 8280 17372 MT (Syntax:)SH /Courier SF 11586 XM (SET IBM {ON, OFF})SH /Times-Roman SF 8280 19764 MT (The SET IBM ON \050or OFF\051 will instruct) 39 W( Kermit-11 to wait for an XON following each packet sent to an IBM host)40 W 8280 20960 MT (in linemode.) 36 W( Since) 321 W( the default for IBM mode may not always be appropriate for your IBM compatible system, you)35 W 8280 22156 MT (can always use the SET HANDSHAKE) 10 W( XON and SET DUPLEX HALF to avoid the parity setting implied by using)11 W 8280 23352 MT (IBM mode.)SH 13 /Times-Bold AF 28699 26711 MT (SET LINE)SH 10 /Times-Roman AF 8280 29084 MT (Syntax:)SH /Courier SF 11586 XM (SET LINE)SH /Times-Italic SF 16986 XM (device-designator)SH /Times-Roman SF 8280 31476 MT (The SET LINE command sets the terminal name up for use with the connect command.) 36 W( To) 321 W( use this you must have)35 W 8280 32672 MT (access to that device. On many systems terminal lines other than your own are protected from access, and may)123 W 8280 33868 MT (require special procedures to access them. The form of the device name is TTnnn:,) 2 W( where 'nnn' is a decimal number)1 W 8280 35064 MT (for RSTS and an octal number for RSX-11M/M+. For) 148 W( RT-11, the device name is simply the MT unit number)149 W 8280 36260 MT (shown by the SHO TER command, as in) 55 W( '5' for DZ11 unit 0 line 4. If the system is running RT-11 version 5 you)54 W 8280 37456 MT (can do a SET LIN XL:. At worst case, Kermit-11 can use the console port on RT-11.) 18 W( For) 287 W( more information see the)19 W 8280 38652 MT (notes later on for RT-11 If you are running)42 W /Courier SF 26071 XM (K11POS.TSK)SH /Times-Roman SF 32363 XM (for P/OS) 42 W( on the PRO/350, Kermit-11 will set the line to)41 W /Courier SF 8280 39848 MT (XK0:)SH /Times-Roman SF 11048 XM (and the speed to 9600 baud when Kermit starts.) 118 W( To) 488 W( override the line or speed, set HELP SET LINE and)119 W 8280 41044 MT (HELP SET SPEED. Examples:)SH /Courier SF 10680 42761 MT (Kermit-11>SET LINE TT55:)SH /Times-Roman SF 29880 XM (\050for RSTS and RSX-11M/M+\051)SH /Courier SF 10680 43792 MT (Kermit-11>SET LINE 5)SH /Times-Roman SF 29880 XM (\050for RT-11 and MT service\051)SH /Courier SF 10680 44823 MT (Kermit-11>SET LINE XK0:)SH /Times-Roman SF 29880 XM (\050for P/OS, done implicitly\051)SH /Courier SF 10680 45854 MT (Kermit-11>SET LINE XL:)SH /Times-Roman SF 29880 XM (\050for RT-11 and XL handler\051)SH 8280 48246 MT (See HELP CONNECT, HELP SET DUPLEX and HELP SET SPEED for more information. Also, for TSX+, see)68 W 8280 49442 MT (notes regarding TSX later in these notes. The RT-11 XL handler has notes later on also.)SH 13 /Times-Bold AF 27327 52801 MT (SET LOGFILE)SH 10 /Times-Roman AF 8280 55174 MT (Syntax:)SH /Courier SF 11586 XM (SET LOGFILE)SH /Times-Italic SF 18786 XM (filespec)SH /Times-Roman SF 8280 57566 MT (The SET) 135 W( LOGFILE command creates a debug dump file for you. It must be used BEFORE any SET DEBUG)136 W 8280 58762 MT (commands can be used. See HELP DEBUG for further information about debugging modes.)SH ES %%Page: 278 279 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 278)SH 12 /Times-Bold AF 31186 XM (Kermit User Guide: PDP-11 Kermit \05013.6\051)SH 46800 50 6120 5709 UL 13 SS 25493 8071 MT (SET MODEM)SH 10 /Times-Roman AF 6120 10444 MT (The SET MODEM command defines the type of MODEM use) 88 W( for dialing out on the line set with the SET LINE)87 W 6120 11640 MT (command, or, in the case of the PRO/350, the) 61 W( XC or XK port. There are only a few modems defined at this time,)62 W 6120 12836 MT (they are:)SH 6120 14627 MT (VADIC)SH 14120 XM (Generic RACAL-VADIC autodial)SH 6120 15732 MT (VA212PA)SH 14120 XM (Stand alone VADIC VA212)SH 6120 16837 MT (VA212PAR)SH 14120 XM (Rack mounted VADIC VA212)SH 6120 17942 MT (VA4224)SH 14120 XM (Rack mounted VADIC VA4224 .v22bis)SH 6120 19047 MT (HAYES)SH 14120 XM (Hayes smartmodem)SH 6120 20152 MT (DF100)SH 14120 XM (DEC DF112)SH 6120 21257 MT (DF200)SH 14120 XM (DEC DF224)SH 6120 22362 MT (DF03)SH 14120 XM (DEC DF03)SH 6120 23467 MT (MICROCOM)SH 6120 25258 MT (The DIAL command is then used after the SET MODEM command. For example, on a PRO/350 running P/OS:)SH /Courier SF 8520 26913 MT (Kermit-11>set prompt PRO>)SH 9000 50 14520 27113 UL 8520 27944 MT (PRO>set modem va212pa)SH 10200 50 10920 28144 UL 8520 28975 MT (PRO>dial 5374411)SH 7200 50 10920 29175 UL 8520 30006 MT (Modem in command mode)SH 8520 31037 MT (Modem dialing)SH 8520 32068 MT (Connection made, type CONNECT to access remote)SH 8520 33099 MT (PRO>con)SH 1800 50 10920 33299 UL 8520 34130 MT (Enter class ? VX785A)SH 3600 50 16920 34330 UL 8520 35161 MT (Class start)SH 8520 36192 MT (Username: BRIAN)SH 3000 50 14520 36392 UL 8520 37223 MT (Password:)SH 3000 50 14520 37423 UL 8520 38938 MT (...)SH /Times-Italic SF (and so on)SH 13 /Times-Bold AF 22423 42297 MT (SET PACKET-LENGTH)SH 10 /Times-Roman AF 6120 44670 MT (Syntax:)SH /Courier SF 9426 XM (SET PACKET-LENGTH)SH /Times-Italic SF 20226 XM (length)SH /Times-Roman SF 6120 47062 MT (You can alter the default transmitted packet length with the SET PACKET-LENGTH command.) 87 W( This) 422 W( should not)86 W 6120 48258 MT (normally be needed unless the line is very noisy, at which time you should probably give up anyway.)SH 13 /Times-Bold AF 25637 51617 MT (SET PARITY)SH 10 /Times-Roman AF 6120 53990 MT (Syntax:)SH /Courier SF 9426 XM (SET PARITY {EVEN, ODD, MARK, NONE, SPACE})SH /Times-Roman SF 6120 56382 MT (This is used with the SET LINE and CONNECT commands to specify the type) 112 W( of parity for the remote link. It)113 W 6120 57578 MT (defaults to NONE and can be any of ODD, EVEN, MARK or SPACE.)SH 6120 59970 MT (All parity generation is done via software, no special) 109 W( hardware is used. The use of software parity generation is)108 W 6120 61166 MT (restricted to 8 bit links only. The) 114 W( character format, if parity is set to anything but NONE, will be 7 bits of data)115 W 6120 62362 MT (followed with high bit set or cleared to indicate the parity. If you) 93 W( set parity to anything but NONE \050the default\051,)92 W 6120 63558 MT (Kermit-11 will be forced to request 8bit prefixing from the other) 4 W( Kermit-11, which is a method by which Kermit can)5 W 6120 64754 MT ('prefix' eight bit characters with a) 166 W( shift code. You MUST use parity \050even if MARK or SPACE\051 when using)165 W 6120 65950 MT (Kermit-11 with the IBM CMS Series/1 or 7171 3270 emulator, or in linemode through a 3705 front end.)SH ES %%Page: 279 280 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (13.6. The SET Command)SH 10 /Times-Italic AF 51275 XM (Page 279)SH 46800 50 8280 5709 UL 13 /Times-Bold AF 28158 8071 MT (SET PAUSE)SH 10 /Times-Roman AF 8280 10444 MT (Syntax:)SH /Courier SF 11586 XM (SET PAUSE)SH /Times-Italic SF 17586 XM (seconds)SH /Times-Roman SF 8280 12836 MT (PAUSE tells Kermit to wait the specified number of seconds between) 83 W( each packet being sent to the other Kermit.)84 W 8280 14032 MT (This may) 55 W( be useful under situations of heavy system load. This may be automatically computer by Kermit-11 in a)54 W 8280 15228 MT (future release as a function of line speed.)SH 13 /Times-Bold AF 27978 18587 MT (SET PHONE)SH 10 /Times-Roman AF 8280 20960 MT (Syntax:)SH /Courier SF 11586 XM (SET PHONE {NUMBER, TONE, PULSE, BLIND})SH /Times-Roman SF 8280 23352 MT (The SET PHONE NUMBER command allows you to associate a) 35 W( phone number with a symbolic name for later use)36 W 8280 24548 MT (with the DIAL) 55 W( command. These definitions could be placed in your)54 W /Courier SF 36565 XM (KERMIT.INI)SH /Times-Roman SF 42869 XM (file, and then referenced later.)54 W 8280 25744 MT (Example:)SH /Courier SF 10680 27399 MT (Kermit-11>set pho num work 5374411)SH 14400 50 16680 27599 UL 10680 28430 MT (Kermit-11>set pho num market 16174671234)SH 18000 50 16680 28630 UL 10680 29461 MT (Kermit-11>dial work)SH 5400 50 16680 29661 UL /Times-Roman SF 8280 31853 MT (The other two SET PHONE options, SET PHONE [TONE][PULSE] and SET) 10 W( PHONE BLIND are not useful unless)11 W 8280 33049 MT (the appropiate dial formatting string and character sequences for selecting PULSE or) 11 W( TONE, and BLIND dialing are)10 W 8280 34245 MT (present in the modem definition macros in)107 W /Courier SF 26222 XM (K11DIA.MAC)SH /Times-Roman SF (. The) 465 W( format effector for TONE/PULSE is)108 W /Courier SF 50498 XM (%M)SH /Times-Roman SF 52056 XM (and the)108 W 8280 35441 MT (effector for BLIND is)SH /Courier SF 17277 XM (%B)SH /Times-Roman SF (. Currently) 250 W( \050in 3.54\051 only the VA4224 has entries for these options.)SH 13 /Times-Bold AF 29025 38800 MT (SET POS)SH 10 /Times-Roman AF 8280 41173 MT (Syntax:)SH /Courier SF 11586 XM (SET POS {DTE, NODTE})SH /Times-Roman SF 8280 43565 MT (The SET POS command allows options SPECIFIC to P/OS to be) 64 W( altered. The most useful option is the SET POS)63 W 8280 44761 MT ([NO]DTE command. This allows Kermit-11 to use PRO/Communications version 2) 55 W( for terminal emulation, if this)56 W 8280 45957 MT (product has been installed on the PRO/350. Of course, if this) 44 W( option is chosen, control is returned to the PRO with)43 W 8280 47153 MT (the EXIT key \050F10\051 rather than with Control \134C.)SH 13 /Times-Bold AF 27473 50512 MT (SET PROMPT)SH 10 /Times-Roman AF 8280 52885 MT (Syntax:)SH /Courier SF 11586 XM (SET PROMPT)SH /Times-Italic SF 18186 XM (prompt)SH /Times-Roman SF 8280 55277 MT (The SET PROMPT command is useful if you are using two Kermit-11's to talk to each other.) 83 W( By) 417 W( using the SET)84 W 8280 56473 MT (PROMPT command, you) 101 W( can change the prompt from 'Kermit-11>' on either \050or both\051 Kermit to something that)100 W 8280 57669 MT (would indicate which system you are currently connected to. Examples:)SH /Courier SF 10680 59324 MT (Kermit-11>set prompt Kermit-11/1170>)SH 15600 50 16680 59524 UL 10680 60355 MT (Kermit-11>set prompt Fubar>)SH 10200 50 16680 60555 UL 10680 61386 MT (Kermit-11>set prompt ProKermit-11>)SH 14400 50 16680 61586 UL ES %%Page: 280 281 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 280)SH 12 /Times-Bold AF 31186 XM (Kermit User Guide: PDP-11 Kermit \05013.6\051)SH 46800 50 6120 5709 UL 13 SS 25167 8071 MT (SET RECEIVE)SH 10 /Times-Roman AF 6120 10444 MT (Currently the SET RECEIVE and SET SEND basically work the same in that) 101 W( they only alter the END-OF-LINE)102 W 6120 11640 MT (character and the START-OF-PACKET value, as in:)SH /Courier SF 8520 13295 MT (Kermit-11>set rec start 2)SH 9000 50 14520 13495 UL 8520 14326 MT (Kermit-11>set rec end 12)SH 8400 50 14520 14526 UL /Times-Roman SF 6120 16043 MT (The command SET RECEIVE PACKET-LENGTH command is discussed below.)SH /Times-Bold SF 8120 18321 MT (SET RECEIVE END-OF-LINE)SH /Times-Roman SF 6120 20087 MT (This instructs Kermit-11 to expect something other than the default carriage return \050octal 15\051 at the end) 34 W( of a packet.)33 W 6120 21283 MT (Kermit-11 will ignore packet terminators. The SET SEND END) 37 W( command is of more use in conditioning outgoing)38 W 6120 22479 MT (packets.)SH /Times-Bold SF 8120 24757 MT (SET RECEIVE START-OF-PACKET)SH /Times-Roman SF 6120 26523 MT (The normal Kermit packet) 86 W( prefix is Control-A \050ASCII 1\051; this command changes the prefix Kermit-11 expects on)85 W 6120 27719 MT (incoming packets. The only reasons this should ever be changed would be: Some piece) 80 W( of equipment somewhere)81 W 6120 28915 MT (between the two Kermit) 156 W( programs will not pass through a Control-A; or, some piece of of equipment similarly)155 W 6120 30111 MT (placed is echoing its input. In the latter case, the recipient of such an echo can change the packet) 188 W( prefix for)189 W 6120 31307 MT (outbound packets to be different from that of arriving packets so that the echoed packets) 151 W( will be ignored. The)150 W 6120 32503 MT (opposite Kermit must also be told to change the prefix for its inbound packets and) 101 W( the prefix it uses on outgoing)102 W 6120 33699 MT (packets.)SH 13 /Times-Bold AF 19298 37058 MT (SET RECEIVE PACKET-LENGTH)SH 10 /Times-Roman AF 6120 39431 MT (Syntax:)SH /Courier SF 9426 XM (SET RECEIVE PACKET-LENGTH)SH /Times-Italic SF 25026 XM (length)SH /Times-Roman SF 6120 41823 MT (This command has two functions. The first, and normal one, is to reduce) 42 W( incoming packet lengths in the event that)41 W 6120 43019 MT (normal sized Kermit packets can not be passed through the) 34 W( communications circuit. There could be, perhaps, some)35 W 6120 44215 MT ('black box' somewhere in the link that has a very small buffer size; this command could be) 48 W( used to reduce the size)47 W 6120 45411 MT (that the SENDING Kermit will use.)SH 6120 47803 MT (The other use) 27 W( is to enable a protocol extension to Kermit called 'Long Packets'. The actual protocol is documented)28 W 6120 48999 MT (elsewhere, let's just say that this is a way for two Kermit's to use packet sizes far) 15 W( greater than the normal \050'Classic'\051)14 W 6120 50195 MT (packet size) 236 W( if 90 characters or so. The main use of this feature is in file transfer over links that introduce)237 W 6120 51391 MT (considerable delay, it is not uncommon for packets to incur an one to two second delay. The net) 52 W( result is a VERY)51 W 6120 52587 MT (slow running Kermit with an effective speed of perhaps) 14 W( 300 to 600 baud rather than 1200 or 2400 baud. By making)15 W 6120 53783 MT (the packets longer, we raise) 54 W( the effective speed of such a circuit. The main restriction on the packet size chosen is)53 W 6120 54979 MT (the link, a given circuit may not pass 500 character packets.) 5 W( Also,) 262 W( BOTH Kermits must support this extension to the)6 W 6120 56175 MT (protocol, they will always negotiate it before any file transfer. See the notes at the end of this document) 69 W( for more)68 W 6120 57371 MT (information.)SH 6120 59763 MT (It is HIGHLY recommended that you use the CRC block check, as the) 222 W( default type one checksum could be)223 W 6120 60959 MT (inadequate for such long packets, as in:)SH /Courier SF 8520 62614 MT (Kermit-11>SET BLO 3)SH ES %%Page: 281 282 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (13.6. The SET Command)SH 10 /Times-Italic AF 51275 XM (Page 281)SH 46800 50 8280 5709 UL 13 /Times-Bold AF 24367 8071 MT (SET RECORD-FORMAT)SH 10 /Times-Roman AF 8280 10444 MT (Syntax:)SH /Courier SF 11586 XM (SET RECORD-FORMAT {STREAM, VARIABLE})SH /Times-Roman SF 8280 12836 MT (Kermit will, by default, create RMS11 variable length implied) 169 W( carriage control records for text files. You can)168 W 8280 14032 MT (override this and change it to create stream ascii records with) 83 W( the SET RECORD-FORMAT STREAM command.)84 W 8280 15228 MT (This is useful for RSTS/E systems if you need file compatability with BASIC Plus. This command would) 48 W( be most)47 W 8280 16424 MT (useful in a)SH /Courier SF 12696 XM (KERMIT.INI)SH /Times-Roman SF 18946 XM (file, which is executed by KERMIT when Kermit starts.)SH 13 /Times-Bold AF 28013 19783 MT (SET RETRY)SH 10 /Times-Roman AF 8280 22156 MT (Syntax: \050SET RETRY \051)SH /Times-Italic SF (number)SH /Times-Roman SF 8280 24548 MT (SET RETRY value tells) 48 W( Kermit to try that many times on a NAK'ed packet before giving up. This should only be)49 W 8280 25744 MT (needed if the line is extremely noisy or the PDP-11 host is running very slowly due to the system load.)SH 13 /Times-Bold AF 28988 29103 MT (SET RSX)SH 10 /Times-Roman AF 8280 31476 MT (The SET RSX command is intended to deal with) 198 W( the peculiarities often found with RSX systems. There are)197 W 8280 32672 MT (currently three SET RSX commands, as in:)SH /Courier SF 10680 34389 MT (Kermit-11>SET RSX FASTIO)SH /Times-Roman SF 29880 XM (Default for packet reading,)SH 29880 35420 MT (waits for .)SH /Courier SF 10680 36451 MT (Kermit-11>SET RSX CHARIO)SH /Times-Roman SF 29880 XM (Read one char at a time for)SH 29880 37482 MT (packet reading.)SH /Courier SF 10680 38513 MT (Kermit-11>SET RSX TC.DLU n)SH /Times-Roman SF 29880 XM (Alters the) 250 W( TC.DLU setting.)SH /Courier SF 10680 39544 MT (Kermit-11>SET RSX CONNECT ALT)SH /Times-Roman SF 29880 XM (Uses a new \050v2.33\051 connect)SH 29880 40575 MT (driver which bypasses TTDRV)SH 29880 41606 MT (flow control.)SH /Courier SF 10680 42637 MT (Kermit-11>SET RSX CONNECT DEF)SH /Times-Roman SF 29880 XM (Use old connect code \0502.32\051)SH 8280 44354 MT (The SET RSX command is subject to change and the above options may be removed in the future. Note the the SET)SH 8280 45550 MT (RSX CHARIO may be needed when transfering files with) 146 W( parity enabled. This command alters the method by)145 W 8280 46746 MT (which a packet is read; instead of waiting for a) 127 W( carriage return, Kermit reads the typeahead byte count and then)128 W 8280 47942 MT (issues a read for that many characters. This is the same method Kermit-11 ALWAYS uses under P/OS.)SH 13 /Times-Bold AF 23950 51301 MT (SET RT-11 CREATE-SIZE)SH 10 /Times-Roman AF 8280 53674 MT (Syntax: \050SET RT-11 CREATE-SIZE \051)SH /Times-Italic SF (number)SH /Times-Roman SF 8280 56066 MT (The SET RT-11 CREATE value command was added to) 13 W( assist those RT-11 users with very small disks to be able to)12 W 8280 57262 MT (get files with sizes greater that half of the available contiguous space available. While this is NOT a) 25 W( problem going)26 W 8280 58458 MT (from one) 148 W( Kermit-11 to another Kermit-11 since the PDP-11 Kermit supports a subset of the protocol known as)147 W 8280 59654 MT ('ATTRIBUTES', other Kermits may not support the exchange) 146 W( of file sizes \050most do not\051. Thus if your largest)147 W 8280 60850 MT (contiguous space is 300 blocks and you want to get a 250 block file, the command:)SH /Courier SF 10680 62505 MT (Kermit-11>set rt-11 cre 250)SH 10200 50 16680 62705 UL /Times-Roman SF 8280 64222 MT (would be needed, as RT-11 by default only allocates 50 percent of the available space.)SH ES %%Page: 282 283 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 282)SH 12 /Times-Bold AF 31186 XM (Kermit User Guide: PDP-11 Kermit \05013.6\051)SH 46800 50 6120 5709 UL 13 SS 20708 8071 MT (SET RT-11 FLOW-CONTROL)SH 10 /Times-Roman AF 6120 10444 MT (Syntax:)SH /Courier SF 9426 XM (SET RT-11 {FLOW-CONTROL, NOFLOW})SH /Times-Roman SF 6120 12836 MT (Note that for the connect command under RT-11 you will most likely need xon/off flow control to) 47 W( be generated by)46 W 6120 14032 MT (Kermit-11. This) 342 W( is enabled with the) 46 W( SET RT-11 FLOW command. This is by default NOFLOW since the modem)47 W 6120 15228 MT (the author uses,) 62 W( a Vadic 212PA, can't handle XONs and XOFFs while in command mode. The solution here is to)61 W 6120 16424 MT (escape back to Kermit command mode) 129 W( after the remote system has been logged into, and then type SET RT-11)130 W 6120 17620 MT (FLOW.)SH 6120 20012 MT (The effect of SET RT-11 FLOW is for Kermit-11,) 43 W( when in connect mode, to send an XOFF to the host every eight)42 W 6120 21208 MT (characters. When) 504 W( the loop in the connect module finds) 127 W( no more data in the input buffer, it sends up to 2 XON)128 W 6120 22404 MT (characters \050in case the first XON got lost\051 to tell the remote system to start sending again.) 4 W( The) 256 W( reason for doing so is)3 W 6120 23600 MT (that the RT-11 multiple terminal service is very slow) 9 W( about handling input interrupts and does not do any of it's own)10 W 6120 24796 MT (flow control when it's internal) 100 W( ring buffer gets full. This has been tested at line speeds up to 4800 baud without)99 W 6120 25992 MT (losing data. This setting should not be needed for use with the XC/XL handlers.)SH 6120 28384 MT (SET RT-11 FLOW has NO) 166 W( effect on packet transmission, since the Kermit packet size is never mode than 96)167 W 6120 29580 MT (characters, and the RT-11 input buffer is 134 characters in size.)SH 6120 31972 MT (The SET RT-11 [NO]FLOW command replaces the older SET RTFLOW [ON][OFF].)SH 13 /Times-Bold AF 20563 35331 MT (SET RT-11 VOLUME-VERIFY)SH 10 /Times-Roman AF 6120 37704 MT (Syntax:)SH /Courier SF 9426 XM (SET RT-11 {VOLUME-VERIFY, NOVOLUME})SH /Times-Roman SF 6120 40096 MT (Normally RT-11 Kermit-11 will check the directory header of) 100 W( a disk to verify that it most likely contains a valid)99 W 6120 41292 MT (RT-11 file structure before trying to) 55 W( read the directory. If for some reason your disk does not contain the standard)56 W 6120 42488 MT (data at offset 760 in the header, Kermit-11) 103 W( will reject the disk. The SET RT-11 NOVOL command will instruct)102 W 6120 43684 MT (Kermit-11 to bypass that check.)SH 13 /Times-Bold AF 26395 47043 MT (SET SEND)SH 10 /Times-Roman AF 6120 49416 MT (The SET SEND command controls what Kermit-11 will be doing for) 17 W( outgoing packets in that you may want to alter)18 W 6120 50612 MT (the packet terminator and/or the start of packet character \050by default, 15 octal) 65 W( and 1 octal respectively. See HELP)64 W 6120 51808 MT (SET RECEIVE for more information.)SH 6120 54200 MT (The only extra option for SET SEND is SET SEND [NO]XON. If the) 101 W( command SET SEND XON is give, then)102 W 6120 55396 MT (every packet sent will be prefixed with an XON) 48 W( character. This could be useful in situations where flow control is)47 W 6120 56592 MT (erratic. The) 432 W( actual intent of this option was to try to circumvent a) 91 W( firmware bug in the DHV11 when used under)92 W 6120 57788 MT (RSTS/E.)SH ES %%Page: 283 284 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (13.6. The SET Command)SH 10 /Times-Italic AF 51275 XM (Page 283)SH 46800 50 8280 5709 UL 13 /Times-Bold AF 28194 8071 MT (SET SPEED)SH 10 /Times-Roman AF 8280 10444 MT (Syntax:)SH /Courier SF 11586 XM (SET SPEED)SH /Times-Italic SF 17586 XM (speed)SH /Times-Roman SF 8280 12836 MT (SET SPEED value sets the line speed for the device specified via the SET) 189 W( LINE command, and used for the)188 W 8280 14032 MT (CONNECT command. Changing the speed of) 38 W( a terminal line requires privilege for RSTS and RSX-11M/M+. The)39 W 8280 15228 MT (SET SPEED command will only function with a DH11, DHV11, DZ11 or DZV11 multiline interface. Example:)SH /Courier SF 10680 16883 MT (Kermit-11>set speed 1200)SH 8400 50 16680 17083 UL /Times-Roman SF 8280 18600 MT (1200 Baud would be a normal speed to use with a VA212PA or a DF03.)SH 8280 20992 MT (Please note that Kermit-11 CAN NOT change the speed of a DL11) 55 W( type interface, nor can it change the speed of a)54 W 8280 22188 MT (PDT-150 modem port. For a PDT-150) 9 W( modem port, use a command of)10 W /Courier SF 37207 XM (/M/S:)SH /Times-Italic SF (nnnn)SH /Times-Roman SF 42467 XM (to change the speed to)10 W /Times-Italic SF 51654 XM (nnnn)SH /Times-Roman SF 53914 XM (for)SH 8280 23384 MT (the)SH /Courier SF 9752 XM (SPEED.SAV)SH /Times-Roman SF 15402 XM (program.)SH 13 /Times-Bold AF 27147 26743 MT (SET TIMEOUT)SH 10 /Times-Roman AF 8280 29116 MT (Syntax:)SH /Courier SF 11586 XM (SET TIMEOUT)SH /Times-Italic SF 18786 XM (seconds)SH /Times-Roman SF 8280 31508 MT (The timeout value tells Kermit how long to wait to get a packet from the other Kermit. If system loads) 46 W( are high, it)45 W 8280 32704 MT (may be desirable to increase this beyond the default of 10 seconds.)SH 13 /Times-Bold AF 26713 36063 MT (SET TERMINAL)SH 10 /Times-Roman AF 8280 38436 MT (Syntax:)SH /Courier SF 11586 XM (SET TERMINAL {TTY, VT100})SH /Times-Roman SF 8280 40828 MT (The SET TERMINAL command simply controls the way which Kermit-11 prints packet counts while) 185 W( send or)186 W 8280 42024 MT (receiving a file) 64 W( \050or group of files\051. The simplest way is the default, SET TER TTY. Using SET TER VT100 will)63 W 8280 43220 MT (cause Kermit to) 106 W( display headers for the numbers printed, at a possible cost in packet speed due to screen control)107 W 8280 44416 MT (overhead. On) 262 W( the PRO/350, VT100 is assumed. On RSTS/E v9.0) 6 W( and later, the executive is queried for the terminal)5 W 8280 45612 MT (type.)SH 13 /Times-Bold AF 27616 48971 MT (SET UPDATE)SH 10 /Times-Roman AF 8280 51344 MT (Syntax:)SH /Courier SF 11586 XM (SET {UPDATE)SH /Times-Italic SF 18786 XM (number)SH /Courier SF (, NOUPDATE})SH /Times-Roman SF 8280 53736 MT (The SET UPDATE command controls the frequency at which the packet) 23 W( count display is updated. The default is 1,)24 W 8280 54932 MT (displaying each packet. A SET UPD 0 will disable all packet count logs, whereas a SET UPD N will update) 90 W( the)89 W 8280 56128 MT (display every N packets. The SET NOUPDATE command is the same as SET UPDATE 0.)SH 12 /Times-Bold AF 8280 59244 MT (13.6.1. The DIAL Command)SH 10 /Times-Roman AF 8280 61186 MT (The DIAL command is new for version 3.29 of) 100 W( Kermit-11. The DIAL command is used to dial a number on an)101 W 8280 62382 MT (attached modem of known type \050see SET MODEM\051. To find out the current known modems, use the SET) 3 W( MODEM)2 W 8280 63578 MT (? command. The) 592 W( following example shows) 171 W( a RACAL-VADIC VA212 modem connect to the)172 W /Courier SF 48959 XM (XK:)SH /Times-Roman SF 51181 XM (port on a)172 W 8280 64774 MT (PRO/350 running P/OS version 2.)SH /Courier SF 10680 66429 MT (Kermit-11>set prompt PRO>)SH 10680 67460 MT (PRO>set modem va212pa)SH 10680 68491 MT (PRO>dial 5374401)SH 10680 69522 MT (Modem in command modem)SH 10680 70553 MT (Modem dialing)SH 10680 71584 MT (Connection failed, !BUSY)SH ES %%Page: 284 285 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 284)SH 12 /Times-Bold AF 30286 XM (Kermit User Guide: PDP-11 Kermit \05013.6.1\051)SH 46800 50 6120 5709 UL 10 /Courier AF 8520 7824 MT (PRO>dial 5374411)SH 8520 8855 MT (Modem in command modem)SH 8520 9886 MT (Modem dialing)SH 8520 10917 MT (Connection made, type CONNECT to access remote)SH 8520 11948 MT (PRO>con)SH 8520 12979 MT (Enter class ? VX785A)SH 8520 14010 MT (Class start)SH 8520 15041 MT (Username: BRIAN)SH 8520 16072 MT (Password: ......................)SH /Times-Roman SF 6120 18464 MT (See SET MODEM for more information.)SH 14 /Times-Bold AF 6120 22066 MT (13.7. System Manager's Notes)SH 12 SS 6120 25182 MT (13.7.1. Odds and Ends)SH 10 /Times-Roman AF 6120 27124 MT (There are a few odds and ends that should be made aware to the system manager of any PDP-11 system) 60 W( regarding)59 W 6120 28320 MT (Kermit-11. They) 580 W( are as follows, grouped by operating system. Please note that installation instructions are in)165 W /Courier SF 6120 29516 MT (K11INS.DOC)SH /Times-Roman SF 12370 XM (and that additional information may be in Kermit-11's online help command.)SH 13 /Times-Bold AF 26198 32875 MT (Restrictions)SH 10 /Times-Roman AF 6120 35248 MT (Prior to version 2.21, Kermit-11 did) 90 W( not support 8-bit prefixing. Prior to version 2.23, Kermit-11 did not support)89 W 6120 36444 MT (repeat character encoding.)SH 6120 38836 MT (The PRO/RT-11 version of) 155 W( Kermit-11 will request 8-bit prefixing due to the fact that the XC handler does not)156 W 6120 40032 MT (support 8BIT data. For most Kermits this should not) 80 W( be a problem. The XC handler always strips bit 7 from the)79 W 6120 41228 MT (character being sent,) 81 W( so the PRO/RT-11 version of Kermit will request prefixing of such. It does so internally by)82 W 6120 42424 MT (setting PARITY to SPACE \050always clear the high bit, bit seven\051.)SH 6120 44816 MT (Note that this implies that a SET PARITY SPACE command) 131 W( will force Kermit-11 to request '8bit' prefixing in)130 W 6120 46012 MT (order to transfer binary files across a seven bit link.)SH 13 /Times-Bold AF 28075 49371 MT (P/OS)SH 10 /Times-Roman AF 6120 51744 MT (Kermit-11 will run on under P/OS on the Pro/350, the executable file is called)105 W /Courier SF 39059 XM (K11POS.TSK)SH /Times-Roman SF (. It) 461 W( does NOT run)106 W 6120 52940 MT (from a menu, the normal way to run it is via the RUN) 90 W( command in DCL. It will support the Kermit-11 attribute)89 W 6120 54136 MT (packets, thus a PRO/350 connected to a PDP-11) 55 W( host can transparently handle binary and other types of files. The)56 W 6120 55332 MT (P/OS Kermit-11 can) 49 W( be run either as a local Kermit or a Kermit server. This has been tested under P/OS version 2)48 W 6120 56528 MT (connected to both a PDP-11/23+ and PDP-11/70 RSTS/E host.)SH 6120 58920 MT (When Kermit-11 is started on the PRO, it will automatically do a)12 W /Courier SF 32568 XM (SET LINE XK0:)12 W /Times-Roman SF 40654 XM (and a SET SPEED 9600. You)12 W 6120 60116 MT (can, of course, change the speed to whatever you need with the SET SPEED command. The line should be left as)57 W /Courier SF 6120 61312 MT (XK0:)SH /Times-Roman SF (.)SH 6120 63704 MT (The top row function keys are mapped internally. Kermit-11 maps F5 \050break\051 into a true BREAK \050a space of) 64 W( 275)65 W 6120 64900 MT (ms\051, F6 \050interrupt\051 to Control-C, F10) 66 W( to Control-Z, F11 to escape \050octal 33\051 and F12 to backspace \050octal 10\051. The)65 W 6120 66096 MT (incoming escape sequence DECID is intercepted to allow Kermit-11 to send back a device response of VT100.)SH ES %%Page: 285 286 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (13.7.1. Odds and Ends)SH 10 /Times-Italic AF 51275 XM (Page 285)SH 46800 50 8280 5709 UL 13 /Times-Bold AF 29440 8071 MT (RSTS/E)SH 10 /Times-Roman AF 8280 10444 MT (Kermit-11 runs on version 7.2 or later) 27 W( of RSTS/E. Due to options present in version 8, binary file transfers will not)28 W 8280 11640 MT (be possible under version 7.2 of RSTS/E. This is due to the use of 8 bit mode for the) 110 W( terminal link to allow all)109 W 8280 12836 MT (characters to be passed. The so called '8BIT' terminal setting was new as of version 8.0-06 of RSTS/E.)SH 8280 15228 MT (Any RSTS/E system running Kermit-11 will need the sysgen option for) 74 W( multiple private delimiters in the terminal)75 W 8280 16424 MT (driver. This) 394 W( special mode is needed since the 'normal' RSTS/E binary terminal mode has a 'feature' that disables)71 W 8280 17620 MT (binary mode whenever the terminal times) 143 W( out on a read. Since timeouts are essential to Kermit error recovery,)144 W 8280 18816 MT (binary mode can not be used for i/o.)SH 8280 21208 MT (Certain functions of Kermit-11 require that the system manager install) 175 W( Kermit with temporary privileges, these)174 W 8280 22404 MT (commands are the) 60 W( SYSTEM, WHO and REMOTE HOST commands. Kermit-11 does NOT need these to operate)61 W 8280 23600 MT (correctly.)SH 8280 25992 MT (Kermit-11 can only be built \050from source, not from HEX files\051 under RSTS/E version 8.0) 48 W( or later due to the use of)47 W 8280 27188 MT (RMS11 v2.0 and new assembler directives.)SH 8280 29580 MT (Support for the server remote login is only available under RSTS/E 9.0 or later. Also, a) 219 W( REMOTE LOGIN)220 W 8280 30776 MT (command to a RSTS/E server will fail unless the user has the WACNT privilege. While the LOGIN program) 60 W( will)59 W 8280 31972 MT (skip the password lookup if WACNT is present, Kermit will require a password.)SH 13 /Times-Bold AF 27735 35331 MT (RSX-11M/M+)SH 10 /Times-Roman AF 8280 37704 MT (Kermit-11 can) 121 W( not be installed non-checkpointable due to an apparent RMS11 bug. In other words, don't try to)122 W 8280 38900 MT (install the task '/CKP=NO'.)SH 8280 41292 MT (To use the connect command effectively, typeahead support) 77 W( is needed in the terminal driver. For RSX-11M+, set)76 W 8280 42488 MT (the typeahead buffer size high, as in SET /TYPEAHEAD=TT22:200. Also, if your connect line is) 1 W( TT22: \050as above\051,)2 W 8280 43684 MT (use the mcr command SET/SLAVE=TT22:)SH 8280 46076 MT (Kermit-11 can only be built under RSX-11M) 9 W( version 4.1 or later, or under RSX-11M Plus version 2.1 or later due to)8 W 8280 47272 MT (the use of RMS11 v2.0 and new assembler directives.)SH 8280 49664 MT (There is a SET RSX command, see HELP SET RSX for further information.)SH 8280 52056 MT (As a side issue, please note that the) 217 W( file)218 W /Courier SF 26177 XM (K11POS.TSK)SH /Times-Roman SF 32645 XM (is quite usable under RSX, the difference being that)218 W /Courier SF 8280 53252 MT (K11RSX.TSK)SH /Times-Roman SF 14690 XM (has DECNET support and RMS-11 overlayed in the task image \050besides) 160 W( which, due to the lack)159 W 8280 54448 MT (author's systems running RSX may not be up to date\051 linked into) 5 W( it, whereas K11POS has NO Decnet support but IS)6 W 8280 55644 MT (linked to the RMS11 library RMSRES \050v2\051, thus) 20 W( K11POS saves disk space as well as supporting named directories,)19 W 8280 56840 MT (ala VMS style.)SH 13 /Times-Bold AF 29910 60199 MT (RT-11)SH 10 /Times-Roman AF 8280 62572 MT (Kermit-11, as of version 2.20, has been tested) 128 W( under RT-11 version 5.0 under the FB and XM monitors using a)129 W 8280 63768 MT (DZ11 line for the link, and also on a PDT-150 using the modem port for the link. It has additionally) 17 W( been run under)16 W 8280 64964 MT (Micro-11's and the PRO/350 using the XL and XC handlers respectively.)SH 8280 67356 MT (Kermit-11 requires .TWAIT support as well as multiple) 55 W( terminal support \050unless the XL/XC handler is used\051. The)56 W 8280 68552 MT (use of multiple terminal support allows Kermit-11 to) 97 W( use any type of interface sysgened, including the DZ11 and)96 W 8280 69748 MT (DZV11. It) 452 W( is possible under version 5 of RT-11 to use the XL: handler) 101 W( instead of the multiple terminal support.)102 W 8280 70944 MT (The use of the XL: driver will result in much faster file transfer at) 35 W( high baud rates. Note that XL: must be set up at)34 W ES %%Page: 286 287 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 286)SH 12 /Times-Bold AF 30286 XM (Kermit User Guide: PDP-11 Kermit \05013.7.1\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (system startup or at some time later to set the proper speed, CSR and vector.)SH 6120 10278 MT (For those users) 13 W( who do not have multiple terminal support and do not have the XL handler, Kermit-11 will force the)14 W 6120 11474 MT (use of the console for data transfers. This will require that Kermit-11) 116 W( request eight bit prefixing from any other)115 W 6120 12670 MT (Kermit wishing to send binary data files. Additionally, you can force console mode by doing a SET LINE TT:)SH 6120 15062 MT (Please note that the device name) 77 W( syntax for terminal lines follows the MT unit numbers, thus if a SHO TER gave)78 W 6120 16258 MT (unit 5 for DZ11 line 0 the the device name would be SET) 45 W( LINE 5. If you use the XL handler, you would say SET)44 W 6120 17454 MT (LINE XL:. To force the console to be used, you would SET LINE TT:.)SH 6120 19846 MT (Additionally, Kermit-11 for RT-11 looks for its help file,)60 W /Courier SF 29742 XM (K11HLP.HLP)SH /Times-Roman SF (, on)60 W /Courier SF 37612 XM (DK:)SH /Times-Roman SF 39722 XM (first and then on)61 W /Courier SF 46743 XM (SY:)SH /Times-Roman SF 48854 XM (if the first)61 W 6120 21042 MT (one fails.)SH 6120 23434 MT (Full wildcarding is supported for RT-11, in the form *.type, name.*, *.* and the) 91 W( % character to match any single)90 W 6120 24630 MT (character.)SH 6120 27022 MT (Kermit-11 can only be built on RT-11 version 5.0 or later due to the use of new assembler directives.)SH 6120 29414 MT (Please note that for the connect command under RT-11 and the) 94 W( use of the MT service, you will most likely need)95 W 6120 30610 MT (xon/off flow control to be generated by Kermit-11. This is enabled with the SET RTFLOW ON command.) 32 W( This) 313 W( is)31 W 6120 31806 MT (by default OFF since the modem the author uses, a Vadic 212P, can't handle XONs and XOFFs while in command)38 W 6120 33002 MT (mode. The) 320 W( solution here is to escape back to Kermit command mode after the remote system) 35 W( has been logged into,)34 W 6120 34198 MT (and then type SET RTFLOW ON.)SH 6120 36590 MT (Due to overlaying constraints, the RT-11 Kermit-11 will not accept wildcards for the RENAME and DELETE)176 W 6120 37786 MT (commands and the REMOTE server equivalents.)SH 6120 40178 MT (The executable files are)SH /Courier SF 15894 XM (K11XM.SAV)SH /Times-Roman SF 21544 XM (for the XM system and PRO/350, and K11RT4 for the FB system.)SH 6120 42570 MT (As a final \050I hope\051 RT-11 note, see) 26 W( the RT-11 v5.1 Release Notes page 9-2 and chapter 12. The discussion relevant)25 W 6120 43766 MT (here regards the use of the XL/XC handlers.)SH 6120 46158 MT (Note that the default XL: handler vector \050DL-11, DLV-11\051 is 300 and the CSR is 176500. For the) 171 W( Micro-11,)172 W 6120 47354 MT (PDP-11 and LSI-11, when the) 99 W( DL11/DLV11 interface is installed the field service representative will inform you)98 W 6120 48550 MT (what the CSR and VECTOR are. If they are NOT 176500 and 300, then to use the XL: handler) 18 W( you will need, prior)19 W 6120 49746 MT (to running Kermit-11, to set them. Suppose the DL vector is 400 and) 28 W( the CSR is 176510. Then the following DCL)27 W 6120 50942 MT (commands would set the addresses for RT-11:)SH /Courier SF 8520 52597 MT (.SET XL CSR=176510)SH 8520 53628 MT (.SET XL VECTOR=400)SH /Times-Roman SF 6120 56020 MT (You SHOULD NOT ever alter these settings for XC: on the) 94 W( PRO/3xx. The ONLY settings you can alter for the)95 W 6120 57216 MT (PRO/3xx is the speed, as in DCL command SET) 128 W( XC SPEED=nnnn. Kermit-11 CAN NOT alter the XC: speed)127 W 6120 58412 MT (itself. As) 328 W( noted previously) 39 W( in this document, Kermit-11 executes the Kermit-11 command SET LIN XC: implicitly)40 W 6120 59608 MT (if it finds itself running on a PRO/3xx system.)SH 6120 62000 MT (Note that if) 1 W( your modem requires DTR to be present, you must use either an interface that asserts it \050as does the PDT)SH 6120 63196 MT (and PRO communications port\051, force it high internally to the modem,) 51 W( or build a cable to force it high. See HELP)52 W 6120 64392 MT (MODEM for more information.)SH ES %%Page: 287 288 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (13.7.1. Odds and Ends)SH 10 /Times-Italic AF 51275 XM (Page 287)SH 46800 50 8280 5709 UL 13 /Times-Bold AF 30045 8071 MT (TSX+)SH 10 /Times-Roman AF 8280 10444 MT (While most of the above notes for RT-11 apply for) 109 W( TSX+, there are a few differences of note. The first, in that)108 W 8280 11640 MT (TSX+ is a timesharing system, allows the Kermit user to log in) 18 W( normally from another system running Kermit \050as in)19 W 8280 12836 MT (a Rainbow\051 and give) 141 W( the TSX+ Kermit the SERVER command and commence file transfer operations from the)140 W 8280 14032 MT (other system \050ie, the Rainbow\051. If you are dialing INTO a TSX+ system, you need to give the TSX command:)SH /Courier SF 10680 15687 MT (.SET TT 8BIT)SH /Times-Roman SF 8280 17404 MT (to be able to transfer data to your local \050PC, other PDP-11,...\051 system without incurring the overhead) 36 W( of the Kermit)37 W 8280 18600 MT (protocol known as eight bit prefixing. If this is not possible, due to your local system requiring parity,) 4 W( or some other)3 W 8280 19796 MT (intervening device adds parity, then you should give Kermit the) 140 W( command SET PARITY SPACE, to let Kermit)141 W 8280 20992 MT (know that it can't send binary data as-is.)SH 8280 23384 MT (To use Kermit-11 to dial out from the TSX+ system,) 214 W( the following commands are needed. Note that TSX+)213 W 8280 24580 MT (commands will) 279 W( be preceeded by the normal RT-11 prompt, the ever present DOT \050'.'\051, whereas Kermit-11)280 W 8280 25776 MT (commands will be prefixed by the default Kermit-11 prompt, 'Kermit-11>':)SH /Courier SF 10680 27493 MT (.SET CL LINE=n)SH /Times-Roman SF 25080 XM (Where 'n' is the unit number)SH /Courier SF 10680 28524 MT (.SET CL NOLFOUT)SH 10680 29555 MT (.SET CL SPEED=n)SH /Times-Roman SF 25080 XM (Where 'n' is the speed for that unit)SH /Courier SF 10680 30586 MT (.ASS CL XL)SH 10680 31617 MT (Kermit-11>SET LIN XL:)SH 10680 32648 MT (Kermit-11>CONNECT)SH /Times-Roman SF 8280 34365 MT (As of Kermit-11 version 3.44, you may use CL directly in the SET LINE command, as in:)SH /Courier SF 10680 36020 MT (.SET CL3 LINE=3)SH 10680 37051 MT (.R K11XM)SH 10680 38082 MT (Kermit-11>SET LIN CL3)SH 10680 39113 MT (Kermit-11>SET SPEED 1200)SH 10680 40144 MT (Kermit-11>CONNECT)SH /Times-Roman SF 8280 42536 MT (A sample command file in actual use is:)SH /Courier SF 10680 44191 MT (SET CL3 LINE=3)SH 10680 45222 MT (SET CL3 NOLFOUT)SH 10680 46253 MT (SET CL3 TAB)SH 10680 47284 MT (SET CL3 FORM)SH 10680 48315 MT (SET CL3 SPEED=2400)SH 10680 49346 MT (ALLOCATE CL3:)SH 10680 50377 MT (R K11XM)SH 10680 51408 MT (DEALLOC CL3)SH 10680 52439 MT (SET CL3 LFOUT)SH 10680 53470 MT (SET CL3 LINE=0)SH 10680 54501 MT (SH CL)SH /Times-Roman SF 8280 56893 MT (If you are running PRO/TSX+, then Kermit will make the assignment of LINE 3 to either CL0 or CL1 if) 83 W( you are)82 W 8280 58089 MT (running Kermit from the console, ie, LINE 1. The speed will default to the last SET SPEED or the speed set) 106 W( at)107 W 8280 59285 MT (system boot.)SH 8280 61677 MT (Lastly, TSX+ needs PLAS support to use)SH /Courier SF 25066 XM (K11XM.SAV)SH /Times-Roman SF (, see the installation notes for further data.)SH ES %%Page: 288 289 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 288)SH 12 /Times-Bold AF 30286 XM (Kermit User Guide: PDP-11 Kermit \05013.7.1\051)SH 46800 50 6120 5709 UL 13 SS 24120 8071 MT (RSTS/E version 9.x)SH 10 /Times-Roman AF 6120 10444 MT (RSTS/E does not control modems signals in the manner that RSX or VMS does. VMS always asserts DTR whereas)13 W 6120 11640 MT (RSTS/E will not assert DTR until the terminal driver can see) 47 W( RCD \050also known as DCD\051 which is pin 8 \050eight\051 for)48 W 6120 12836 MT (the RS232 connection. To connect directly to) 34 W( a modem \050like a VADIC 212, sorry, no DEC modems here\051 we must)33 W 6120 14032 MT (do one of two things:)SH 8120 15823 MT (1.)SH 9120 XM (Force the modem \050via strapping options or whatever\051 to assert RCD \050DCD\051 pin 8, thus) 83 W( RSTS/E will)84 W 9120 16928 MT (see carrier and raise DTR \050pin 20 for RS232\051)SH 8120 19138 MT (2.)SH 9120 XM (Set the terminal to LOCAL \050RSTS/E V9 syntax 'SET TER) 14 W( TTxx:/NODIAL/PERM'\051 and break pin 20)13 W 9120 20243 MT (\050DTR\051 and connect pin 20 to 8 on the modem side. This) 55 W( will cause the modem to be able to dial out)56 W 9120 21348 MT (and allow RSTS/E to connect to it. You will also need to have the modem assert RCD, pin 8. Keep) 10 W( in)9 W 9120 22453 MT (mind that the Kermit-11 command DISCONNECT \050or HANGUP\051 will not function if a line is set to)71 W 9120 23558 MT (NODIAL \050INIT SET syntax 'LOCAL'\051. This has been tested on a Racal Vadic VA212.)SH 8120 25768 MT (3.)SH 9120 XM (Break pin) 2 W( 8 \050RCD\051 and loop DTR \050pin 20\051 on the CPU side to RCD \050pin 8\051 on the CPU side. Then use)1 W 9120 26873 MT (the command SET DTR in Kermit-11 to get RSTS to raise DTR and thus loop it's) 20 W( DTR signal back to)21 W 9120 27978 MT (RCD. See) 250 W( the next note regarding this.)SH 6120 30370 MT (For those of you who have port switches such) 84 W( as the Gandalf type, there is one additional problem. For Gandalf,)83 W 6120 31566 MT (suppose you want to connect a DZ11 line) 46 W( to to an AMTB2. You will have a problem, in that the Gandalf AMTB2)47 W 6120 32762 MT (wants to see RCD \050DCD\051 asserted to make a connection. What you may need to do is this:)SH 6120 35154 MT (Make a cable for the DZ11 to AMTB2 port as follows:)SH /Courier SF 13320 36809 MT (CPU side) SH( AMTB2) 13800 W( side)SH 22920 37840 MT (20--|)SH 22920 38871 MT (8---|-----------8)SH 22920 39902 MT (7---------------7)SH 22920 40933 MT (3---------------2)SH 22920 41964 MT (2---------------3)SH /Times-Roman SF 6120 43681 MT (Note that 20 is tied to 8 on the CPU side. Also, 2 is swapped for 3.)SH 6120 46073 MT (Then, the Kermit-11 command SET DTR,) 118 W( which forces RSTS to raise DTR for 30 seconds, will cause the DTR)117 W 6120 47269 MT (signal to loop back to the RCD \050DCD\051 signal and thus tell RSTS that there is) 79 W( carrier detect which will raise DTR)80 W 6120 48465 MT (\050the chicken or egg question\051 and get things rolling.) 56 W( The) 361 W( Kermit-11 HANGUP \050or DISCONNECT\051 command will)55 W 6120 49661 MT (drop DTR and force the modem to break the connection.)SH 13 /Times-Bold AF 24463 53020 MT (RSX and Modems)SH 10 /Times-Roman AF 6120 55393 MT (While the author's experience on RSX is limited, the following notes may be of use.) 34 W( Dialing) 320 W( out on a LOCAL line)35 W 6120 56589 MT (will often require that the modem assert internally DTR. If a line is set REMOTE on RSX, the driver) 90 W( will assert)89 W 6120 57785 MT (DTR and RTS. For a modem, like a VA212PAR strapped at the factory defaults, this) 1 W( will cause the modem to assert)2 W 6120 58981 MT (DSR and RCD. On the VADIC in particular, the modem will drop) 164 W( RCD during a DIAL command unless the)163 W 6120 60177 MT (modem is configured to assert RCD continuously. For dialing out, ideally the modem should be able to) 26 W( assert RCD)27 W 6120 61373 MT (via an option or internally settable strap or switch. If this is not possible, an alternative is to break line) 17 W( 8 \050RCD\051 and)16 W 6120 62569 MT (jumper DTR \05020\051 to RCD \0508\051 on the CPU side. This will force RSX to always see carrier detect and) 76 W( allow a dial)77 W 6120 63765 MT (sequence to complete. The Kermit-11 command DISCONNECT \050or HANGUP\051) 43 W( will still disconnect the modem as)42 W 6120 64961 MT (the modem will drop from the line when it sees DTR go low \050assuming the modem is) 79 W( not strapped to assert DTR)80 W 6120 66157 MT (internally\051.)SH ES %%Page: 289 290 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (13.8. Typical Kermit-11 Transfer Rates)SH 10 /Times-Italic AF 51275 XM (Page 289)SH 46800 50 8280 5709 UL 14 /Times-Bold AF 8280 8138 MT (13.8. Typical Kermit-11 Transfer Rates)SH 10 /Times-Roman AF 8280 10256 MT (Some sample timings for Kermit-11 and long packet support. The packet size in the RSTS/E) 136 W( to P/OS was 500)135 W 8280 11452 MT (bytes, the size from RSTS/E) 65 W( to RSTS/E was 700 bytes. These sizes are somewhat arbitrary, they depend more on)66 W 8280 12648 MT (the system's buffering capabilities than anything else.)SH 8280 15040 MT (Host buffering capabilities:)SH 8280 16650 MT (P/OS)SH 29880 XM (500 \050estimated\051)SH 8280 17755 MT (RSTS/E 9.0 or later)SH 29880 XM (up to 7000, given sufficient system pool)SH 8280 18860 MT (RSX-11M+)SH 29880 XM (255 \050I/D space CPU only\051)SH 8280 19965 MT (RSX-11M)SH 29880 XM (34)SH 8280 21070 MT (RT-11)SH 29880 XM (134 \050could be larger with mod to XC/XL\051)SH 8280 23462 MT (As it can be seen, large packets make sense only for RSTS/E, P/OS and RSX-11M+ if) 219 W( one wishes to avoid)218 W 8280 24658 MT (XON/XOFF overhead at high speeds. It should be possible to run larger packets on M+ and RT-11 at lower speeds.)SH 8280 27050 MT (File transferred:)222 W /Courier SF 15389 XM (K11POS.TSK)SH /Times-Roman SF (, size 102,400 bytes \050200 disk blocks\051.) 222 W( Actual) 695 W( data packet characters AFTER)223 W 8280 28246 MT (prefixing was 120,857.)SH 8280 29856 MT (Time Speed) 750 W( Data) 500 W( rate) SH( Comments)1500 W 8280 30961 MT (seconds baud)SH 8280 33171 MT (1436 1200 84/sec) 750 W( 11/44) 2250 W( to PRO/350, 'Classic' Kermit)SH 16280 34276 MT (local phone call)SH 8280 35381 MT (1237 1200 97/sec) 750 W( 11/44) 2250 W( to PRO/350, 500 Char packets)SH 16280 36486 MT (local phone call)SH 8280 38696 MT (2915 1200 41/sen) 750 W( 11/44) 2250 W( to PRO/350, 'Classic' Kermit)SH 16280 39801 MT (local call, 1 second ACK delay.)SH 8280 40906 MT (1492 1200 81/sec) 750 W( 11/44) 2250 W( to PRO/350, 500 Char packets)SH 16280 42011 MT (local call, 1 second ACK delay.)SH 8280 44221 MT (304 9600) 1000 W( 397/sec) 750 W( 11/44) 2000 W( to 11/44, 'Classic' Kermit,)SH 16280 45326 MT (connected locally via Gandalf switch.)SH 8280 46431 MT (245 9600) 1000 W( 493/sec) 750 W( 11/44) 2000 W( to 11/44, 700 char packets,)SH 16280 47536 MT (connected locally via Gandalf switch.)SH 8280 49146 MT (The last) 88 W( two timings are much lower than the line speed due to the fact the the PDP 11/44 is running 100% busy)87 W 8280 50342 MT (trying to keep up with character interrupts using a normal terminal driver. A special purpose driver, such as the XK)21 W 8280 51538 MT (driver found on P/OS, would have lower overhead and allow somewhat faster data rates.)SH 8280 53930 MT (Long packets were chosen for) 69 W( Kermit-11 due to the lack of suitable interrupt driven i/o \050at this time\051 under one of)68 W 8280 55126 MT (the operating systems, RSTS/E. The Sliding Windows) 112 W( would likely function better in those situations where the)113 W 8280 56322 MT (circuit delay is much higher, or when the circuit can not accommodate large packet sizes.)SH 14 /Times-Bold AF 8280 59924 MT (13.9. Common Problems)SH ES %%Page: 290 291 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 290)SH 12 /Times-Bold AF 31186 XM (Kermit User Guide: PDP-11 Kermit \05013.9\051)SH 46800 50 6120 5709 UL 13 SS 24843 8071 MT (Connection Fails)SH 10 /Times-Roman AF 6120 10444 MT (Check modem control signals. RSX needs TC.DLU set to two to talk to) 28 W( a dial out modem, otherwise you will need)27 W 6120 11640 MT (to strap or jumper signals in the modem to have carrier detect set high.) 30 W( RSTS/E) 312 W( also should have the modem assert)31 W 6120 12836 MT (carrier detect. If not, see the previous) 124 W( notes about modems. If all else fails, put a breakout box in the line and)123 W 6120 14032 MT (observe what signals are present.)SH 13 /Times-Bold AF 24195 17391 MT (File Transfer Fails.)SH 10 /Times-Roman AF 6120 19764 MT (If the file transfer aborts on retries immediately, there may be a parity problem. If the problem) 37 W( shows up on binary)38 W 6120 20960 MT (files, try a SET PAR SPACE command to Kermit; that will force eight bit data to be prefixed into seven bits. If) 12 W( you)11 W 6120 22156 MT (instead get a retry about once every 10 seconds, the other) 62 W( Kermit is not responding and your Kermit is timing out.)63 W 6120 23352 MT (Check to see if your connection is still present, and try the SET PARITY command.)SH 6120 25744 MT (If you) 96 W( are sending binary data between unlike Kermits, you will most likely have to give the proper command to)95 W 6120 26940 MT (each to prepare them for the binary data; this is the SET FILE command; for Kermit-11) 50 W( it's SET FIL BIN \050or SET)51 W 6120 28136 MT (FIL TYP FIX\051; for VMS Kermit it's SET FIL TYP FIX.)SH 6120 30528 MT (If your Kermit's packets are being echoed) 74 W( back, try a SET SEND START value command for your Kermit, and a)73 W 6120 31724 MT (SET REC START samevalue for) 106 W( the other Kermit. This will force Kermit to ignore any echoed packets as they)107 W 6120 32920 MT (won't have the default start of packet character \050a CONTROL A, octal 1\051.)SH ES %%Page: 291 292 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (14. Apple II Kermit)SH 10 /Times-Italic AF 51275 XM (Page 291)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 8280 8272 MT (14. Apple II Kermit)SH 10 /Times-Roman AF 8280 10566 MT (Authors:)SH 14280 XM (Antonino N. J. Mione \050Stevens Institute of Technology\051,)SH 14280 11671 MT (Peter Trei \050Columbia University\051,)SH 14280 12776 MT (Ted Medin \050NOSC\051, Bob Holley \050SERDAC\051)SH 8280 14434 MT (Version:)SH 14280 XM (3.85)SH 8280 16092 MT (Date:)SH 14280 XM (1988 July)SH /Times-Italic SF 8280 18484 MT (Kermit-65 Capabilities At A Glance:)SH /Times-Roman SF 9280 20094 MT (Local operation:)SH 34480 XM (Yes)SH 9280 21199 MT (Remote operation:)SH 34480 XM (Yes)SH 9280 22304 MT (Transfers text files:)SH 34480 XM (Yes)SH 9280 23409 MT (Transfers binary files:)SH 34480 XM (Yes)SH 9280 24514 MT (Wildcard send:)SH 34480 XM (Yes)SH /Courier SF 9280 25619 MT (^X/^Y)SH /Times-Roman SF 12530 XM (interruption:)SH 34480 XM (Yes)SH 9280 26724 MT (Filename collision avoidance:)SH 34480 XM (Yes)SH 9280 27829 MT (Can time out:)SH 34480 XM (Yes)SH 9280 28934 MT (8th-bit prefixing:)SH 34480 XM (Yes)SH 9280 30039 MT (Repeat count prefixing:)SH 34480 XM (No)SH 9280 31144 MT (Alternate block checks:)SH 34480 XM (No)SH 9280 32249 MT (Terminal emulation:)SH 34480 XM (Yes \050VT52, VT100\051)SH 9280 33354 MT (Communication settings:)SH 34480 XM (Yes)SH 9280 34459 MT (Transmit BREAK:)SH 34480 XM (Yes)SH 9280 35564 MT (IBM communication:)SH 34480 XM (Yes)SH 9280 36669 MT (Transaction logging:)SH 34480 XM (No)SH 9280 37774 MT (Session logging \050raw download\051:)SH 34480 XM (Yes)SH 9280 38879 MT (Raw upload:)SH 34480 XM (No)SH 9280 39984 MT (Act as server:)SH 34480 XM (Yes)SH 9280 41089 MT (Talk to server:)SH 34480 XM (Yes)SH 9280 42194 MT (Advanced commands for servers:)SH 34480 XM (Yes)SH 9280 43299 MT (Long packets:)SH 34480 XM (Yes)SH 9280 44404 MT (Sliding windows:)SH 34480 XM (No)SH 9280 45509 MT (Local file management:)SH 34480 XM (Yes)SH 9280 46614 MT (Handle file attributes:)SH 34480 XM (No)SH 9280 47719 MT (Command/init files:)SH 34480 XM (Yes)SH 9280 48824 MT (Printer control:)SH 34480 XM (Yes)SH 8280 51216 MT (Kermit-65 is a program that implements the Kermit file) 103 W( transfer protocol for the Motorola 6502 processor family)102 W 8280 52412 MT (\050hence the name, Kermit-65\051 on the) 75 W( Apple II microcomputer system. It is written in 6502 assembly language and)76 W 8280 53608 MT (should run on any Apple II or compatible running DOS 3.3 or PRODOS 8. This section will) 8 W( describe the things you)7 W 8280 54804 MT (should know about the file system in order to make effective use of) 108 W( Kermit, and then it will describe the special)109 W 8280 56000 MT (features of the Kermit-65 program.)SH 14 /Times-Bold AF 8280 59602 MT (14.1. Supported Systems and Devices)SH 10 /Times-Roman AF 8280 61720 MT (There are several different Apple II's which can) 17 W( run Kermit-65. Kermit will have no problems running on an Apple)16 W 8280 62916 MT (II, II+, //e, //c) 12 W( or //gs system. Of the different communication devices available for the Apple II, Kermit-65 supports)13 W 8280 64112 MT (the ones shown in Table 14-1.)SH 8280 66504 MT (It is possible that other cards may have operational characteristics very similar or identical to one of the devices)119 W 8280 67700 MT (above. If this is the case, it may work using one of the currently available device drivers. The user) 35 W( may want to try)36 W 8280 68896 MT (each of the above options to see if any of them) 55 W( work. Kermit-65 must be told in which slot the card resides. This)54 W 8280 70092 MT (may be done with the 'SET' command \050documented below\051.)SH ES %%Page: 292 293 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 292)SH 12 /Times-Bold AF 30817 XM (Kermit User Guide: Apple II Kermit \05014.2\051)SH 46800 50 6120 5709 UL 46800 50 6120 8086 UL 10 /Times-Roman AF 16920 10820 MT (AE Serial Pro \050super serial driver - sw 1 & 3 open 2 & 4 closed\051)SH 16920 11925 MT (AIO II \050Uses the Apple Com Card driver??? - untested\051)SH 16920 13030 MT (ALS dispatcher \050Uses the Apple Com Card driver\051)SH 16920 14135 MT (Apple Com Serial Card)SH 16920 15240 MT (ASIO \050Uses the Apple Com Card driver??? - untested\051)SH 16920 16345 MT (Apple Super Serial Card & //c Serial Port)SH 16920 17450 MT (Apple //gs Serial Port)SH 16920 18555 MT (CCS 7710 Serial Card)SH 16920 19660 MT (CCS 7711 \050Uses the Apple Com Card driver??? - untested\051)SH 16920 20765 MT (D.C. Hayes Micromodem.)SH 16920 21870 MT (Microtek sv-622 Card)SH 16920 22975 MT (Prometheus Versacard \050Uses the Apple Com Card driver\051)SH 16920 24080 MT (SSM AIO \050Uses the Apple Com Card driver??? - untested\051)SH /Times-Bold SF 15507 25690 MT (Table 14-1:)SH /Times-Roman SF 20868 XM (Apple II Communication Cards Supported by Kermit-65)SH 46800 50 6120 27500 UL 14 /Times-Bold AF 6120 30902 MT (14.2. The DOS 3.3 File System)SH 10 /Times-Roman AF 6120 33020 MT (Items of importance which will be discussed in this section include filenames and file characteristics.)SH /Times-Bold SF 8120 35298 MT (Apple DOS Filenames)SH /Times-Roman SF 6120 37690 MT (Filenames under Apple DOS may contain almost any ASCII) 17 W( character \050including space\051. It is not recommended that)18 W 6120 38886 MT (special characters, \050i.e. control characters or) 29 W( spaces\051 be used in a filename to be transferred by Kermit-65 since they)28 W 6120 40082 MT (may cause problems when parsing the filename. Filenames may be up to 40 characters in length.)SH /Times-Bold SF 8120 42360 MT (Apple DOS File Characteristics)SH /Times-Roman SF 6120 44752 MT (All files in Apple DOS have a file type associated with them which is contained) 6 W( in the directory entry for the file but)7 W 6120 45948 MT (is not part of the filename itself. There are four types of files in DOS 3.3. They are:)SH 8120 47739 MT (1.)SH 9120 XM (APPLESOFT BASIC)SH 8120 48844 MT (2.)SH 9120 XM (INTEGER BASIC)SH 8120 49949 MT (3.)SH 9120 XM (BINARY)SH 8120 51054 MT (4.)SH 9120 XM (TEXT)SH 6120 53446 MT (All file types have) 21 W( their data stored in eight-bit bytes although not all of them need the eighth bit. The two file types)20 W 6120 54642 MT (containing basic programs required the eighth bit due to the nature) 154 W( of the data being stored. BINARY files are)155 W 6120 55838 MT (images of memory copied into a file. Often,) 109 W( these are machine code programs. These files require all eight bits.)108 W 6120 57034 MT (TEXT files normally contain only) 60 W( printable or carriage control characters. They are stored in the form of seven-bit)61 W 6120 58230 MT (ASCII characters but the) 112 W( eighth bit should always be set since Apples manipulate all text internally as 'Negative)111 W 6120 59426 MT (ASCII'. When) 348 W( transmitting non-text files the user must insure that both Kermits are) 49 W( handling eight-bit data so that)50 W 6120 60622 MT (no information is lost. If an eight-bit data path is) 70 W( not available \050i.e. the remote Kermit needs to do parity checking)69 W 6120 61818 MT (with the eigth bit\051, then eight-bit quoting should be used.) 66 W( Of) 384 W( course, BINARY files as well as Apple BASIC files)67 W 6120 63014 MT (will not have much meaning on a different system. If) 113 W( the user desires to edit a BASIC file on a mainframe, for)112 W 6120 64210 MT (instance, s/he must convert it to a TEXT file before sending it over. After) 54 W( receiving the file back on the Apple, the)55 W 6120 65406 MT (user may) 175 W( convert it back to BASIC once again. The reason BASIC files would be meaningless to a different)174 W 6120 66602 MT (machine is that) 27 W( the Apple stores BASIC keywords as single character tokens to save space and processing time. To)28 W 6120 67798 MT (convert a BASIC program to and from a TEXT file, consult the Apple DOS 3.3 Manual.) 78 W( File) 405 W( information can be)77 W 6120 68994 MT (obtained by issuing the CATALOG command. For example:)SH /Courier SF 9720 70649 MT (]CATALOG)SH ES %%Page: 293 294 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (14.2. The DOS 3.3 File System)SH 10 /Times-Italic AF 51275 XM (Page 293)SH 46800 50 8280 5709 UL /Courier SF 12480 7824 MT (DISK VOLUME 010)SH 13680 9479 MT (*A 002 HELLO)SH 14280 10510 MT (B 078 KERMIT)SH 14280 11541 MT (A 002 READER)SH 14280 12572 MT (T 005 TESTFILE)SH 11880 14227 MT (])SH /Times-Roman SF 8280 16619 MT (When Kermit-65 is receiving a file, the file it creates on diskette will be of the type) 86 W( indicated by the FILE-TYPE)87 W 8280 17815 MT (parameter. The) 412 W( file will always be left in an unlocked state after it is closed by Kermit-65. When sending a) 81 W( file,)80 W 8280 19011 MT (Kermit-65 will use the FILE-TYPE parameter to determine how to detect) 163 W( an End-of-file condition. Thus, it is)164 W 8280 20207 MT (important to have this set properly in all cases.)SH /Times-Bold SF 10280 22485 MT (Recommendations for Archiving Files)SH /Times-Roman SF 8280 24877 MT (When using a large system for) 14 W( archiving purposes, there is no reason to convert Apple Basic programs into text files)13 W 8280 26073 MT (before sending them if there is no need to edit them on the mainframe. The) 36 W( FILE-TYPE parameter must always be)37 W 8280 27269 MT (set correctly when sending and receiving files. The procedure for archiving files is:)SH 10280 29060 MT (1.)SH 11280 XM (Run Kermit on remote system.)SH 10280 30718 MT (2.)SH /Courier SF 11280 XM (SET FILE-TYPE TEXT)SH /Times-Roman SF 22330 XM (\050)SH /Times-Italic SF (or)SH /Courier SF 24152 XM (APPLESOFT)SH /Times-Italic SF 30152 XM (or)SH /Courier SF 31641 XM (...)SH /Times-Roman SF (\051 on Kermit-65.)SH 10280 32376 MT (3.)SH 11280 XM (Send the files.)SH 14 /Times-Bold AF 8280 35978 MT (14.3. The PRODOS File System)SH 10 /Times-Roman AF 8280 38096 MT (The PRODOS system is essentialy the same as the DOS system with the exception that performance has) 170 W( been)169 W 8280 39292 MT (improved, hardware usage has) 176 W( been expanded and file names have different syntax. File names are the major)177 W 8280 40488 MT (importance to the Kermit system. File names have the following syntax:)SH /Courier SF 10680 42143 MT (/volname/subdirectory1/.../subdirectoryn/filename)SH /Times-Roman SF 8280 43860 MT (where "volname") 21 W( is the volume name where the file is located. Subdirectory\050n\051 is a subdirectory on the volume and)20 W 8280 45056 MT (may be omitted. Filenames are much more restrictive than DOS filenames.) 66 W( PRODOS) 383 W( filenames are limited to 15)67 W 8280 46252 MT (characters with no imbedded spaces and few special characters, and must begin with an alphabetic character.)219 W 8280 47448 MT (/volname/sub ... may be omited from the filename by use of the PREFIX command.)SH 8280 49840 MT (Binary file transfer using PRODOS has its dangers when creating new) 120 W( files. PRODOS keeps the file's size and)121 W 8280 51036 MT (starting location in the directory which is) 12 W( of course not transferred. Therefore a new binary file will have its starting)11 W 8280 52232 MT (location 0 which) 42 W( can cause some interesting problems if you try and BRUN the file. Basic files all start at $801 \050it)43 W 8280 53428 MT (says here\051 so Kermit creates new basic files with a starting address of $801.)SH 14 /Times-Bold AF 8280 57030 MT (14.4. Program Operation)SH 10 /Times-Roman AF 8280 59148 MT (Prior to using Kermit-65 for transferring files, the modem interface must be set) 59 W( to handle data in a certain manner.)58 W 8280 60344 MT (First, the data format should be 8 data) 11 W( bits and 1 stop bit. Second, the card should be set to no parity. The baud rate)12 W 8280 61540 MT (\050if adjustable\051 must be set to whatever rate the) 209 W( modem can handle. For the D.C. Hayes Micromodem, these)208 W 8280 62736 MT (parameters are set correctly by default, so very little has to be) 54 W( done. For the Apple Super Serial Card these are set)55 W 8280 63932 MT (from within Kermit-65) 112 W( except the interrupt switch \050sw6-2\051 which must be set for interupts on. For the Microtek)111 W 8280 65128 MT (SV-622, all applicable parameters are set by Kermit-65. Some mainframes may need parity checking) SH( \050i.e. most IBM)1 W 8280 66324 MT (machines\051. In) 798 W( this case some parity setting \050other than none\051 will usually work. When talking with such)273 W 8280 67520 MT (mainframes, binary and basic files on the Apple cannot be transferred) 38 W( unless Eighth-bit-quoting is acceptable to the)39 W 8280 68716 MT (host. If) 678 W( you have the parameters set correctly then the "connect" command will start Kermit talking out the)214 W 8280 69912 MT (communication port.)SH ES %%Page: 294 295 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 294)SH 12 /Times-Bold AF 30817 XM (Kermit User Guide: Apple II Kermit \05014.4\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (File transfer is very dependent upon parity. Make sure the host and) 15 W( local parity are the same. Following are a couple)16 W 6120 9082 MT (of site's method for file transfer.)SH 6120 11474 MT (We have an IBM 3033 and 4381 and use both 3705/3725 and 7171 or Series/1 front ends.) 44 W( The) 336 W( differences in front)43 W 6120 12670 MT (ends as far as any microcomputer Kermit is concerned duplex \050local-echo on) 108 W( for the 3705, local-echo off for the)109 W 6120 13866 MT (7171 or Series/1\051, parity \050the two front ends might use different parity, e.g. Mark for the 3705 and Even for) 121 W( the)120 W 6120 15062 MT (7171\051, and flow control \050None for the 3705, XON/XOFF for the 7171\051.)SH 6120 17454 MT (In Kermit-65, IBM mainframe users need to set the following parameters:)SH 8120 19245 MT (BAUD)SH 16120 XM (Whatever is supported.)SH 8120 20903 MT (PARITY)SH 16120 XM (EVEN, ODD, or MARK, whatever your front end requires.)SH 8120 22561 MT (FLOW)SH 16120 XM (XON for the 7171, NONE for the 3705.)SH 8120 24219 MT (FLOW DELAY)SH 16120 XM (00)SH 8120 25877 MT (LOCAL-ECHO)SH 16120 XM (OFF for 7171, ON for 3705)SH 8120 27535 MT (In Kermit-65, SERDAC VAX 8800 users need to set the following parameters:)SH 8120 29193 MT (BAUD SERDAC Dial-up & 300, 1200, or) 47 W( 2400 baud FIRN Dialup: \050the highest your modem and the dial-up)48 W 16120 30298 MT (connection will support\051)SH 8120 31956 MT (Ethernet Hardwire: 300, 1200, 2400, or 4800 baud.)SH 8120 33614 MT (PARITY NONE)SH 8120 35272 MT (FLOW XON)SH 8120 36930 MT (FLOW DELAY 00 \050higher for printers, logging, or "slow" Apples\051)SH 8120 38588 MT (LOCAL-ECHO OFF)SH 8120 40246 MT (NOTE: If you want to do a binary file transfer \050Apple binary or BASIC files\051 via a FIRN Network connection)44 W 16120 41351 MT (to the SERDAC VAX 8800, you must SET PARITY SPACE before the) 288 W( transfer is)289 W 16120 42456 MT (initiated; that will insure that eight-bit quoting is used.) 87 W( If) 422 W( you dial directly into the VAX)86 W 16120 43561 MT (8800, SET PARITY NONE; eight-bit quoting \050which is less efficient\051 is not required.)SH /Times-Bold SF 8120 45839 MT (Conversing With Kermit-65)SH /Times-Roman SF 6120 48231 MT (Kermit-65 reads file)3 W /Courier SF 14488 XM (KERMIT.INIT)SH /Times-Roman SF 21341 XM (from the default drive when started.) 3 W( The) 258 W( lines of this file are executed one at a)4 W 6120 49427 MT (time starting at the begining. This file should be an ASCII text file) 153 W( and contain commands to set up Kermit's)152 W 6120 50623 MT (parameters as desired. It will also execute Kermit's other commands. However, any) 71 W( command which reads a file)72 W 6120 51819 MT (\050like MODEM\051 or leaves local mode) 138 W( \050like CONNECT\051 will terminate reading of this file and continue with the)137 W 6120 53015 MT (command specified. Use your favorite editor to produce this file. Here's a sample:)SH /Courier SF 8520 54670 MT (set display 80 3)SH 8520 55701 MT (set keyboard 2e)SH 8520 56732 MT (set baud 4800)SH 8520 57763 MT (modem)SH /Times-Roman SF 6120 60155 MT (Kermit-65's prompt is ")162 W /Courier SF (Kermit-65>)SH /Times-Roman SF (". To) 574 W( run Kermit-65 and issue commands to it, type ")162 W /Courier SF (brun kermit)163 W /Times-Roman SF (".)SH 6120 61351 MT (Example:)SH /Courier SF 8520 63006 MT (]BRUN KERMIT)SH 6600 50 9120 63206 UL 8520 64661 MT (NOSC/STEVENS/CU - APPLE ][ KERMIT-65 - VER 3.84)SH 8520 66316 MT (Kermit-65>send testfile)SH 7800 50 14520 66516 UL /Times-Italic SF 10920 68031 MT (\050file is sent...\051)SH /Courier SF 8520 69686 MT (Kermit-65>status)SH 3600 50 14520 69886 UL /Times-Italic SF 10920 71401 MT (\050performance statistics are printed...\051)SH ES %%Page: 295 296 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (14.4. Program Operation)SH 10 /Times-Italic AF 51275 XM (Page 295)SH 46800 50 8280 5709 UL /Courier SF 10680 7884 MT (Kermit-65>)SH /Times-Italic SF (\050other commands...\051)SH 8054 50 16680 8084 UL /Courier SF 16680 8915 MT (.)SH 16680 9946 MT (.)SH 16680 10977 MT (.)SH 10680 12008 MT (Kermit-65>exit)SH 2400 50 16680 12208 UL 10680 13039 MT (])SH /Times-Roman SF 8280 15431 MT (Like many Kermit programs, Kermit-65 uses a DEC-20 style command parser. During interactive) 91 W( operation, you)90 W 8280 16627 MT (may use the ?-prompting help feature \050"?"\051 and recognition \050ESC\051 features while typing commands. A) 104 W( question)105 W 8280 17823 MT (mark typed at any point in a command) 62 W( displays the options available at that point; typing an ESC character causes)61 W 8280 19019 MT (the current keyword to be completed \050or) 19 W( default value to be supplied\051. If you have not typed sufficient characters to)20 W 8280 20215 MT (uniquely specify the keyword \050or if there is no default value\051 then a beep will be) 99 W( sounded and you may continue)98 W 8280 21411 MT (typing. Keywords) 250 W( may be abbreviated to any prefix that is unique.)SH /Times-Bold SF 10280 23689 MT (Remote and Local Operation)SH /Times-Roman SF 8280 26081 MT (Kermit-65 is normally run in local mode. It) 12 W( may be run as a remote Kermit as well although there is no advantage to)13 W 8280 27277 MT (doing things that way. Kermit-65 supports User-mode) 164 W( commands for talking to a Server, and it does support a)163 W 8280 28473 MT (limited server mode.)SH 14 /Times-Bold AF 8280 32075 MT (14.5. Kermit-65 Commands)SH 13 SS 25612 35434 MT (The SEND Command)SH 10 /Times-Roman AF 8280 37807 MT (Syntax:)SH /Courier SF 11586 XM (SEND)SH /Times-Italic SF 14586 XM (filespec)SH /Times-Roman SF 8280 40199 MT (The SEND command causes a file to be sent from the Apple to the remote system. The Filespec is the name) 35 W( of the)36 W 8280 41395 MT (file on the Apple diskette to be sent. The parser will) 18 W( not accept control characters and certain special characters in a)17 W 8280 42591 MT (filename \050like comma\051, so the user may have to rename the file before it is) 44 W( sent. The user may also have problems)45 W 8280 43787 MT (in filename compatibility with remote Kermits. If the remote Kermit does) 19 W( not have the facilities to beat the filename)18 W 8280 44983 MT (into a format that its system likes, the user may have to rename the) 88 W( file before sending it. Thanks to Dick Atlee,)89 W 8280 46179 MT (wildcards are now acceptable) 16 W( when sending files \050they have always been acceptable when receiving files\051. The ``)15 W /Courier SF (*)SH /Times-Roman SF ('')SH 8280 47375 MT (is a multiple character wildcard and the ``)SH /Courier SF (=)SH /Times-Roman SF ('' is a single character wildcard.)SH 8280 49767 MT (The default disk drive is used for file transfers this can be changed) 23 W( with the 'SET DEFAULT-DISK'\050DOS\051 or 'SET)24 W 8280 50963 MT (PREFIX'\050PRODOS\051 command \050explained) 237 W( below\051. As a file is being sent, the screen displays 'RECEIVING)236 W 8280 52159 MT (NUMBER OF BYTES' and 'SENDING NUMBER OF BYTES') 168 W( followed by the hexidecimal number of bytes)169 W 8280 53355 MT (transferred since start of transmission. If a packet must be transmitted several times) 93 W( and it reaches the maximum)92 W 8280 54551 MT (retry count,) 167 W( the transfer will fail and the 'Kermit-65>' prompt will return. If the remote Kermit sends an error)168 W 8280 55747 MT (packet, the text of the packet will be displayed on the) 152 W( screen, the transfer will fail, and the prompt will return.)151 W 8280 56943 MT (Currently, a packet can be retransmitted manually by typing anything on the keyboard. If a 'Q' is typed, the entire)63 W 8280 58139 MT (transmission will be aborted.)SH ES %%Page: 296 297 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 296)SH 12 /Times-Bold AF 30817 XM (Kermit User Guide: Apple II Kermit \05014.5\051)SH 46800 50 6120 5709 UL 13 SS 22224 8071 MT (The RECEIVE Command)SH 10 /Times-Roman AF 6120 10444 MT (Syntax:)SH /Courier SF 9426 XM (RECEIVE [)SH /Times-Italic SF (filespec)SH /Courier SF (])SH /Times-Roman SF 6120 12836 MT (The RECEIVE command tells Kermit-65 to receive a) 92 W( file or file group from the other system. If only one file is)91 W 6120 14032 MT (being received, you) 81 W( may include the optional filespec as the name to store the incoming file under; otherwise, the)82 W 6120 15228 MT (name is) 136 W( taken from the incoming file header. If the name in the header is not a legal filename, Kermit-65 will)135 W 6120 16424 MT (attempt to change it into something legal.) 35 W( If) 322 W( FILE-WARNING is on and an incoming file has a name identical to a)36 W 6120 17620 MT (file already existing on the diskette, Kermit-65 will issue a warning to the user and attempt) 3 W( to modify the filename to)2 W 6120 18816 MT (make it unique. Currently, a packet can be retransmitted manually by typing anything) 46 W( on the keyboard. If a 'Q' is)47 W 6120 20012 MT (typed, the entire transmission will be aborted. Filespec is required when xmodem protocol is used.)SH 13 /Times-Bold AF 23344 23371 MT (The TAKE Command)SH 10 /Times-Roman AF 6120 25744 MT (Syntax:)SH /Courier SF 9426 XM (TAKE)SH /Times-Italic SF 12426 XM (filespec)SH /Times-Roman SF 6120 28136 MT (The TAKE commands tells kermit-65 to execute commands from the specified file similarly to) 65 W( the KERMIT.INIT)64 W 6120 29332 MT (file. See discussion on KERMIT.INIT above for details.)SH 13 /Times-Bold AF 23452 32691 MT (The TYPE Command)SH 10 /Times-Roman AF 6120 35064 MT (Syntax:)SH /Courier SF 9426 XM (TYPE)SH /Times-Italic SF 12426 XM (filespec)SH /Times-Roman SF 6120 37456 MT (The TYPE commands tells kermit-65 to print to the screen from the specified file. Text) 86 W( files only and works best)87 W 6120 38652 MT (with 80 characters per line or less.)SH 13 /Times-Bold AF 23813 42011 MT (The GET Command)SH 10 /Times-Roman AF 6120 44384 MT (Syntax:)SH /Courier SF 9426 XM (GET)SH /Times-Italic SF 11826 XM (remote-filespec)SH /Times-Roman SF 6120 46776 MT (The GET command requests a) 20 W( remote Kermit server to send the file or file group specified by)19 W /Times-Italic SF 44189 XM (remote-filespec)SH /Times-Roman SF (. This)288 W 6120 47972 MT (command can be used with a) 61 W( Kermit server on the other end. The remote filespec is any string that can be a legal)62 W 6120 49168 MT (file specification for the remote system; it is not parsed) 154 W( or validated locally. So if the remote Kermit supports)153 W 6120 50364 MT (wildcards you can specify them in the)26 W /Times-Italic SF 21716 XM (remote-filespec)SH /Times-Roman SF (. If) 302 W( the remote Kermit is not capable of server functions, then)27 W 6120 51560 MT (you will probably get an error message back from it like "Illegal packet type". In this case, you must) 25 W( connect to the)24 W 6120 52756 MT (other Kermit, give a SEND command, escape back, and give a RECEIVE command. Currently, a) 105 W( packet can be)106 W 6120 53952 MT (retransmitted manually by typing anything on the) 213 W( keyboard. If a 'Q' is typed, the entire transmission will be)212 W 6120 55148 MT (cancelled.)SH 13 /Times-Bold AF 21935 58507 MT (The CONNECT Command)SH 10 /Times-Roman AF 6120 60880 MT (Syntax:)SH /Courier SF 9676 XM (CONNECT)SH /Times-Roman SF 6120 63272 MT (Establish a terminal connection) 45 W( to the remote system using all the current SET paramaters for terminal type, speed,)46 W 6120 64468 MT (parity, etc. Get back to Kermit-65 by typing the escape character followed by the letter C. The escape) 56 W( character is)55 W 6120 65664 MT (Control-)SH /Courier SF (@)SH /Times-Roman SF 10401 XM (by default.) 42 W( When) 335 W( you type the escape character, several single-character commands are possible. These)43 W 6120 66860 MT (are shown in Table 14-2.)SH 6120 69252 MT (You can use the SET ESCAPE) 93 W( command to define a different escape character. When CONNECTed, Kermit-65)92 W 6120 70448 MT (will be passing characters entered) 109 W( on the keyboard to the remote system, and passing characters from the remote)110 W 6120 71644 MT (system to the Apple screen. Incoming characters are interpreted according) 157 W( the selected terminal type \050see SET)156 W ES %%Page: 297 298 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (14.5. Kermit-65 Commands)SH 10 /Times-Italic AF 51275 XM (Page 297)SH 46800 50 8280 5709 UL 46800 50 8280 8086 UL /Courier SF 10280 11001 MT (?)SH /Times-Roman SF 13280 XM (List all the possible single-character arguments.)SH /Courier SF 10280 12106 MT (B)SH /Times-Roman SF 13280 XM (Send a BREAK signal.)SH /Courier SF 10280 13211 MT (C)SH /Times-Roman SF 13280 XM (Close the connection and return to Kermit-65.)SH /Courier SF 10280 14316 MT (D)SH /Times-Roman SF 13280 XM (Drop the phone line to the remote and return to Kermit-65.)SH /Courier SF 10280 15421 MT (E)SH /Times-Roman SF 13280 XM (rEfresh the screen \050useful for clearing garbage on screen\051.)SH /Courier SF 10280 16526 MT (K)SH /Times-Roman SF 13280 XM (TOGGLE Keypad application-mode on/off.)SH /Courier SF 10280 17631 MT (P)SH /Times-Roman SF 13280 XM (Toggle the Printer on/off.)SH /Courier SF 10280 18736 MT (R)SH /Times-Roman SF 13280 XM (pRint the screen, >= //e required)SH /Courier SF 10280 19841 MT (S)SH /Times-Roman SF 13280 XM (Show Status of the connection.)SH /Courier SF 10280 20946 MT (W)SH /Times-Roman SF 13280 XM (sWap the del and backspace key.)SH /Courier SF 10280 22051 MT (0)SH /Times-Roman SF 13280 XM (Send a null \050ASCII 0\051.)SH /Courier SF 10280 23156 MT (^@)SH /Times-Roman SF 13280 XM (\050or whatever the Connect-Escape character is\051: Send the Connect-Escape character itself.)SH /Times-Bold SF 16973 24947 MT (Table 14-2:)SH /Times-Roman SF 22334 XM (Kermit-65 Single-Character CONNECT Escape Commands)SH 46800 50 8280 26757 UL 8280 28348 MT (TERMINAL\051.)SH 8280 30740 MT (On an Apple II+ with an incomplete keyboard, special characters can be typed by prefixing) 9 W( regular characters with a)10 W 8280 31936 MT (right-arrow. On) 494 W( uppercase-only screens, uppercase characters are shown in inverse and lowercase characters) 122 W( are)121 W 8280 33132 MT (displayed as normal uppercase characters.)SH 8280 35524 MT (Here are the rules for using the special 2/2+) 23 W( input, to get all printable ASCII characters, and how they appear on the)24 W 8280 36720 MT (screen. Special) 468 W( meanings are applied in various contexts to) 109 W( certain characters. The left and right arrow keys do)108 W 8280 37916 MT (special things, and sometimes the escape key does as well. For letters, the keyboard is always in either) 136 W( default)137 W 8280 39112 MT (UPPERCASE mode or default lowercase mode. When in UPPERCASE, all) 38 W( letters typed are sent out as uppercase.)37 W 8280 40308 MT (In lowercase, all letters are sent as lowercase. To reverse the case for the next character) 107 W( only, hit the right-arrow)108 W 8280 41504 MT (\050"prefix"\051 key.) 31 W( To) 311 W( switch the default case, hit the prefix-key twice in a row. For funny characters, the prefix key is)30 W 8280 42700 MT (also used to get the) 109 W( unusual punctuation characters which are not on the Apple keyboard. Table 14-3 shows the)110 W 8280 43896 MT (Apple II/II+ keyboard escapes; the letter "p" represents the prefix character.)SH 46800 50 8280 45887 UL 10280 48802 MT (To Get)SH 31880 XM (Type)SH 39080 XM (Appearence)SH 4555 50 10280 49002 UL 2055 50 31880 49002 UL 4775 50 39080 49002 UL 10280 50088 MT (Left Square Bracket)SH 32130 XM (p)SH /Courier SF (\050)SH 40880 XM ([)SH /Times-Roman SF 10280 51374 MT (Right Square Bracket)SH 32130 XM (p)SH /Courier SF (\051)SH 40880 XM (])SH /Times-Roman SF 10280 52660 MT (Left Curly Bracket)SH 32130 XM (p)SH /Courier SF (<)SH 40880 XM ({)SH /Times-Roman SF 10280 53946 MT (Right Curly Bracket)SH 32130 XM (p)SH /Courier SF (>)SH 40880 XM (})SH /Times-Roman SF 10280 55232 MT (Underline)SH 32130 XM (p)SH /Courier SF (-)SH 40880 XM (_)SH /Times-Roman SF 10280 56518 MT (Backslash)SH 32130 XM (p)SH /Courier SF (/)SH 40880 XM (\134)SH /Times-Roman SF 10280 57804 MT (Tilde \050wiggle\051)SH 32130 XM (p)SH /Courier SF (^)SH 40880 XM (~)SH /Times-Roman SF 10280 59090 MT (Vertical Line)SH 32130 XM (p)SH /Courier SF (.)SH 40880 XM (|)SH /Times-Bold SF 22733 60881 MT (Table 14-3:)SH /Times-Roman SF 28094 XM (Apple II/II+ Keyboard Escapes)SH 46800 50 8280 62691 UL 8280 64883 MT (The left-arrow key sends a rubout \050ASCII 127\051. With left-arrow and right arrow) 94 W( doing special things, it's a little)93 W 8280 66079 MT (hard to enter their characters) 20 W( \050)21 W /Courier SF (^H)SH /Times-Roman SF 21875 XM (and)SH /Courier SF 23590 XM (^U)SH /Times-Roman SF 25061 XM (respectively\051. There) 292 W( is therefore an escape from prefix mode sequence. If)21 W 8280 67275 MT (you type prefix-ESC, the next character is sent without any interpretation. If you) 2 W( have the capability for upper/lower)1 W 8280 68471 MT (case, etc, then use the 'SET KEYBOARD' and 'SET DISPLAY' commands to specify complete keyboards.)SH ES %%Page: 298 299 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 298)SH 12 /Times-Bold AF 30817 XM (Kermit User Guide: Apple II Kermit \05014.5\051)SH 46800 50 6120 5709 UL 13 SS 23416 8071 MT (The HELP Command)SH 10 /Times-Roman AF 6120 10444 MT (Syntax:)SH /Courier SF 9426 XM (HELP)SH /Times-Roman SF 6120 12836 MT (Typing HELP alone prints a brief summary of the Kermit-65 commands.)SH 13 /Times-Bold AF 22550 16195 MT (The MODEM Command)SH 10 /Times-Roman AF 6120 18568 MT (Syntax:)SH /Times-Italic SF 9426 XM (MODEM)SH /Times-Roman SF 6120 20960 MT (This command is designed for the hayes smart modem. Typing MODEM causes) 81 W( the file)82 W /Courier SF 43056 XM (KERMIT.MODEM)SH /Times-Roman SF 50588 XM (in the)82 W 6120 22156 MT (default drive/path to be used as a menu. You will be) 105 W( able to select any line in the file to be sent to the modem.)104 W 6120 23352 MT (Sorry, you can't back up to a previous menu, you will have to Quit and execute) 166 W( MODEM again. A "connect")167 W 6120 24548 MT (response from the smart modem will cause Kermit leave the modem) 256 W( command and execute the CONNECT)255 W 6120 25744 MT (command. For a Hayes smart modem) 119 W( this file should have commands using text status responses \050not numbers\051.)120 W 6120 26940 MT (One command) 32 W( per line with comments allowed after the first space \050blank\051. Use your favorite editor to produce this)31 W 6120 28136 MT (ASCII text file. Since the attention Hayes command \050AT\051 requires a delay the ``)115 W /Courier SF (&)SH /Times-Roman SF ('' character becomes) 115 W( the time)116 W 6120 29332 MT (delay for Kermit. Each ``)6 W /Courier SF (&)SH /Times-Roman SF ('' causes) 6 W( a delay of one second on a 6502 chip. If you have a //gs or an accelerator board)5 W 6120 30528 MT (you may have to use the SET TIMING command to produce a one second delay. If you really need to send the "&")19 W 6120 31724 MT (character to the modem) 36 W( then the "\134" is the escape character. Put a "\134" before any character and that character will be)35 W 6120 32920 MT (sent asis. Of course two "\134"'s will produce one "\134". Normally Kermit will) 5 W( wait for 27 seconds \050again on a 6502 chip\051)6 W 6120 34116 MT (for the modem to respond, but any character typed on the keyboard will terminate this wait. If may hear) 69 W( the busy)68 W 6120 35312 MT (signal and there is no sense waiting any longer, so hit \050crash-not so hard\051 any key on the keyboard.)SH 6120 37704 MT (Following is an example of the)SH /Courier SF 18786 XM (KERMIT.MODEM)SH /Times-Roman SF 26236 XM (file:)SH /Courier SF 8520 39419 MT (+++&&ATH)SH /Times-Italic SF 15720 XM (Get the Hayes Smartmodem's attention and then hang up.)SH /Courier SF 8520 40450 MT (ATDP1234567)SH /Times-Italic SF 15720 XM (Call your local BBS with pulse dialing.)SH /Courier SF 8520 41481 MT (ATDT8901234)SH /Times-Italic SF 15720 XM (Call your work dialup phone with touch tone dialing.)SH 13 /Times-Bold AF 21899 44840 MT (The CATALOG Command)SH 10 /Times-Roman AF 6120 47213 MT (Syntax:)SH /Courier SF 9426 XM (CATALOG)SH /Times-Roman SF 6120 49605 MT (Typing CATALOG produces a catalog \050directory\051 listing of your default drive.)SH 13 /Times-Bold AF 22549 52964 MT (The DELETE Command)SH 10 /Times-Roman AF 6120 55337 MT (Syntax:)SH /Courier SF 9426 XM (DELETE)SH /Times-Italic SF 13626 XM (filespec)SH /Times-Roman SF 6120 57729 MT (Typing DELETE causes the file specified to be deleted.)SH ES %%Page: 299 300 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (14.5. Kermit-65 Commands)SH 10 /Times-Italic AF 51275 XM (Page 299)SH 46800 50 8280 5709 UL 13 /Times-Bold AF 24709 8071 MT (The SERVER Command)SH 10 /Times-Roman AF 8280 10444 MT (Syntax:)SH /Courier SF 11586 XM (SERVER)SH /Times-Roman SF 8280 12836 MT (Typing SERVER alone turns Kermit into a) 166 W( file server to a remote Kermit. Currently server mode will handle)167 W 8280 14032 MT (remote "send", "get", "remote" and "fin" commands. Variants of the) 65 W( above commands will probably work but file)64 W 8280 15228 MT (serving is very limited at present. Because the Apple requires knowledge of file types) 129 W( you can use the "remote)130 W 8280 16424 MT (Kermit" \050or whatever the remote Kermit's syntax is\051 command to set the file-type on the server. Yes, the server) 9 W( will)8 W 8280 17620 MT (execute any command so you can really get) 207 W( the server into trouble \050this is not a BBS\051. You must have the)208 W 8280 18816 MT (appropiate file type set before transfering files.) 18 W( You) 285 W( can exit server mode by typing Control-C \050)17 W /Courier SF (^C)SH /Times-Roman SF (\051 when not doing)17 W 8280 20012 MT (file transfers or the remote can of course terminate via the "fin" command.)SH 13 /Times-Bold AF 24457 23371 MT (The REMOTE Command)SH 10 /Times-Roman AF 8280 25744 MT (Syntax:)SH /Courier SF 11586 XM (REMOTE [)SH /Times-Italic SF (option character-string)SH /Courier SF (])SH /Times-Roman SF 8280 28136 MT (The only option currently is "kermit". This command submits the) 256 W( command "character-string" to the remote)257 W 8280 29332 MT (Kermit's command processor. Long replys) 6 W( are not paged so you will have to use ^S to stop the screen. The obvious)5 W 8280 30528 MT (usage is for setting and showing parameters on the remote Kermit.)SH 13 /Times-Bold AF 22469 33887 MT (The EXIT and QUIT Commands)SH 10 /Times-Roman AF 8280 36260 MT (Syntax:)SH /Courier SF 11586 XM (EXIT)SH /Times-Italic SF 14586 XM (or)SH /Courier SF 16075 XM (QUIT)SH /Times-Roman SF 8280 38652 MT (Exit from Kermit-65. You can restart the program, provided you haven't run anything else, by typing 'CALL 4096'.)SH ES %%Page: 300 301 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 300)SH 12 /Times-Bold AF 30817 XM (Kermit User Guide: Apple II Kermit \05014.5\051)SH 46800 50 6120 5709 UL 13 SS 23957 8071 MT (The SET Command)SH 10 /Times-Roman AF 6120 10444 MT (Syntax:)SH /Courier SF 9426 XM (SET)SH /Times-Italic SF 11826 XM (parameter)SH /Courier SF 16592 XM ([)SH /Times-Italic SF (option)SH /Courier SF 20348 XM ([)SH /Times-Italic SF (value)SH /Courier SF (]])SH /Times-Roman SF 6120 12836 MT (Establish or modify various parameters for file transfer) 47 W( or terminal connection. You can examine their values with)48 W 6120 14032 MT (the SHOW command. The following parameters may be SET:)SH 10688 16966 MT (APPLICATION-MODE)SH 21270 XM (Set VT100 gs keypad in/out of application mode.)SH 17687 18071 MT (BAUD)SH 21270 XM (Which baud rate should the com card use?)SH 10409 19176 MT (CURSOR-KEYS-VT100)SH 21270 XM (In VT100 mode cursor keys give VT100 sequences.)SH 14577 20281 MT (DEBUGGING)SH 21270 XM (TERSE or VERBOSE packet information.)SH 13299 21386 MT (DEFAULT-DISK)SH 21270 XM (Which Diskette drive is used for DOS 3.3 file transfer?)SH 16298 22491 MT (DISPLAY)SH 21270 XM (Which type of screen display is being used?)SH 16797 23596 MT (ESCAPE)SH 21270 XM (Character for terminal connection.)SH 15576 24701 MT (FILE-TYPE)SH 21270 XM (Type of Apple file being sent/received.)SH 13244 25806 MT (FILE-WARNING)SH 21270 XM (Warn users if incoming file exists?)SH 17687 26911 MT (FLOW)SH 21270 XM (Should xon/xoff flow control be used to the remote?)SH 14965 28016 MT (KEYBOARD)SH 21270 XM (II+ or //e keyboard.)SH 16465 29121 MT (KEYPAD)SH 21270 XM (Is there a gs style keypad?)SH 14132 30226 MT (LOCAL-ECHO)SH 21270 XM (Full or half duplex switch.)SH 16909 31331 MT (PARITY)SH 21270 XM (Character parity to use)SH 17075 32436 MT (PREFIX)SH 21270 XM (Which default prefix to use with PRODOS?)SH 16353 33541 MT (PRINTER)SH 21270 XM (Should the printer be used for the display?)SH 15242 34646 MT (PROTOCOL)SH 21270 XM (Which protocol is to be used for file transfer.)SH 16298 35751 MT (RECEIVE)SH 21270 XM (Various parameters for receiving files)SH 17909 36856 MT (SEND)SH 21270 XM (Various parameters for sending files)SH 18020 37961 MT (SLOT)SH 21270 XM (Which slot # is communication device in?)SH 17409 39066 MT (TIMER)SH 21270 XM (Should Kermit observe the receive timeout value?)SH 16743 40171 MT (TIMIMG)SH 21270 XM (Change the time loop for 1 ms. delays.)SH 15354 41276 MT (TERMINAL)SH 21270 XM (Which type of terminal should Kermit emulate?)SH /Times-Bold SF 8120 43554 MT (SET APPLICATION-MODE)SH /Times-Roman SF 6120 45320 MT (Syntax:)SH /Courier SF 9426 XM (SET APPLICATION-MODE {ON, OFF})SH /Times-Roman SF 6120 47712 MT (For VT100 emulation with a gs-style keypad you) 43 W( can set the keypad in or out of application mode. Some computer)42 W 6120 48908 MT (systems set this via escape sequences so it may not be necessary to use this command.)SH /Times-Bold SF 8120 51186 MT (SET BAUD)SH /Times-Roman SF 6120 52952 MT (Syntax:)SH /Courier SF 9426 XM (SET BAUD)SH /Times-Italic SF 14826 XM (value)SH /Times-Roman SF 6120 55344 MT (Value is the baud rate for your communication card. For the super) 59 W( serial and the microtek it can be 300 to 19200.)60 W 6120 56540 MT (The actual values will depend upon the com card you are running with.)SH /Times-Bold SF 8120 58818 MT (SET CURSOR-KEYS-VT100)SH /Times-Roman SF 6120 61210 MT (Syntax:)SH /Courier SF 9426 XM (SET CURSOR-KEYS-VT100 {ON, OFF})SH /Times-Roman SF 6120 63602 MT (In VT100 emulation the cursor keys can also emulate the VT100 cursor keys.)SH /Times-Bold SF 8120 65880 MT (SET DEBUGGING)SH /Times-Roman SF 6120 68272 MT (Syntax:)SH /Courier SF 9426 XM (SET DEBUGGING {TERSE, VERBOSE, OFF})SH /Times-Roman SF 6120 70664 MT (Record the packet traffic on your terminal. Options are: TERSE, Show packet info) 198 W( only \050brief\051. VERBOSE)197 W 6120 71860 MT (displays packet field descriptions with packet info \050lengthy\051. OFF disables display of) 10 W( debugging information \050this is)11 W ES %%Page: 301 302 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (14.5. Kermit-65 Commands)SH 10 /Times-Italic AF 51275 XM (Page 301)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (the default\051.)SH /Times-Bold SF 10280 10164 MT (SET DEFAULT-DISK)SH /Times-Roman SF 8280 11930 MT (Syntax:)SH /Courier SF 11586 XM (SET DEFAULT-DISK {SLOT, VOLUME, DRIVE})SH /Times-Italic SF 34986 XM (value)SH /Times-Roman SF 8280 14322 MT (This DOS command will tell Kermit-65 which disk drive should be used for file transfers. The three) 102 W( parameters)101 W 8280 15518 MT (which may be set separately are SLOT, VOLUME and DRIVE. The value for SLOT ranges from 1 to 7. The value)28 W 8280 16714 MT (for DRIVE is either 1 or 2. The value for VOLUME ranges from 0 to 255.)SH /Times-Bold SF 10280 18992 MT (SET DISPLAY)SH /Times-Roman SF 8280 21384 MT (Syntax:)SH /Courier SF 11586 XM (SET DISPLAY {2E, 2P})SH /Times-Roman SF 24436 XM (or)SH /Courier SF 25519 XM (SET DISPLAY 80-COL)SH /Times-Italic SF 36919 XM (number)SH /Times-Roman SF 8280 23776 MT (This command will tell Kermit-65 which kind of screen display you want to use.) 96 W( If) 441 W( you have an Apple II or II+)95 W 8280 24972 MT (without an 80) 68 W( column card, use the first syntax. If you have any kind of an Apple with an 80 column card, enter:)69 W 8280 26168 MT (SET DISPLAY 80, followed by a space and the slot number where the card resides \050if you don't) 128 W( know the slot)127 W 8280 27364 MT (number, or the card is built-in to the set, try 3 \051.)SH /Times-Bold SF 10280 29642 MT (SET ESCAPE)SH /Times-Roman SF 8280 31408 MT (Syntax:)SH /Courier SF 11586 XM (SET ESCAPE)SH /Times-Italic SF 18186 XM (hexidecimal-number)SH /Times-Roman SF 8280 33800 MT (Specify the control character you want to use to "escape" from) 44 W( remote connections back to Kermit-65. The default)45 W 8280 34996 MT (is 0 \050Control-)15 W /Courier SF (@)SH /Times-Roman SF (\051. The) 280 W( number is the hex value of the ASCII control character, 1 to 37, for instance 2 is Control-B, B)15 W 8280 36192 MT (is Control-K.)SH /Times-Bold SF 10280 38470 MT (SET FILE-TYPE)SH /Times-Roman SF 8280 40236 MT (Syntax:)SH /Courier SF 11586 XM (SET FILE-TYPE {APPLESOFT, INTEGER, TEXT, BINARY, OTHER)SH /Times-Italic SF 44586 XM (hex-value)SH /Courier SF (})SH /Times-Roman SF 8280 42628 MT (This will inform) 48 W( Kermit-65 what type of file is being sent or received. It is important that this is set correctly since)49 W 8280 43824 MT (Kermit-65 must create a file of the appropriate type when receiving \050and it has no way of knowing what kind of file)24 W 8280 45020 MT (it is\051.) 127 W( When) 505 W( Kermit-65 is sending, it must also know the type of file since that tells it how to detect the actual)128 W 8280 46216 MT (end-of-file. The) 269 W( keywords for this parameter are listed below. OTHER includes an added hex-value so that the user)9 W 8280 47412 MT (may specify the hex value of the file-type. This has meaning only in PRODOS and allows the user to) 10 W( specify any of)11 W 8280 48608 MT (the many different file types used in PRODOS, see Tables 14-4 and 14-5 \050thanks to Phil Chien, M L Stier et al\051.)SH 10280 50399 MT (APPLESOFT)SH 18280 XM (The file being transfered is an Applesoft Basic program.)SH 10280 52057 MT (INTEGER)SH 18280 XM (The file being sent/received is an Integer Basic program.)SH 10280 53715 MT (TEXT)SH 18280 XM (The file being sent/received is an ASCII Text file.)SH 10280 55373 MT (BINARY)SH 18280 XM (The file being sent/received is a Binary image.)SH 10280 57031 MT (OTHER)SH 18280 XM (The type of file being sent/received is specified by the hex-value.)SH /Times-Bold SF 10280 59309 MT (SET FILE-WARNING)SH /Times-Roman SF 8280 61075 MT (Syntax:)SH /Courier SF 11586 XM (SET FILE-WARNING {ON, OFF})SH /Times-Roman SF 8280 63467 MT (This tells Kermit-65 whether to warn the user about incoming filenames conflicting with existing files or not.) 105 W( If)458 W 8280 64663 MT (there is a conflict Kermit-65 will attempt to change the file name to something unique.)SH /Times-Bold SF 10280 66941 MT (SET FLOW)SH /Times-Roman SF 8280 68707 MT (Syntax:)SH /Courier SF 11586 XM (SET FLOW {OFF, XON, DELAY)SH /Times-Italic SF 27186 XM (number)SH /Courier SF (})SH /Times-Roman SF 8280 71099 MT (SET FLOW allows one to use the XON/XOFF protocol) 30 W( when connected to a remote site. Delay timings are part of)31 W ES %%Page: 302 303 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 302)SH 12 /Times-Bold AF 30817 XM (Kermit User Guide: Apple II Kermit \05014.5\051)SH 46800 50 6120 5709 UL 46800 50 6120 8086 UL 10 /Courier AF 7320 10865 MT (?)SH 14520 XM (List of most of the prodos file types.)SH 7320 12927 MT (Num Name) 7200 W( OS)1800 W 4800 50 7320 13127 UL 2400 50 16920 13127 UL 2400 50 21720 13127 UL 7320 13958 MT ($00)SH 14520 XM (r typeless)7200 W 7320 14989 MT ($01)SH 14520 XM (r BAD both) 2400 W( BAD) 1800 W( blocks file)SH 7320 16020 MT ($02)SH 14520 XM (r PCD SOS Pascal) 2400 W( CoDe file)SH 7320 17051 MT ($03)SH 14520 XM (r PTX SOS Pascal) 2400 W( TeXt file)SH 7320 18082 MT ($04)SH 14520 XM (r TXT both) 2400 W( ASCII) 1800 W( text file)SH 7320 19113 MT ($05)SH 14520 XM (r PDA SOS Pascal) 2400 W( DAta file)SH 7320 20144 MT ($06)SH 14520 XM (r BIN both) 2400 W( BINary) 1800 W( file)SH 7320 21175 MT ($07)SH 14520 XM (r CHR SOS CHaRacter) 2400 W( font file)SH 7320 22206 MT ($08)SH 14520 XM (r PIC both) 2400 W( PICture) 1800 W( file)SH 7320 23237 MT ($09)SH 14520 XM (r BA3 SOS Business) 2400 W( BASIC \050SOS\051 program file)SH 7320 24268 MT ($0A)SH 14520 XM (r DA3 SOS Business) 2400 W( BASIC \050SOS\051 data file)SH 7320 25299 MT ($0B)SH 14520 XM (r WPD SOS Word) 2400 W( Processor Document)SH 7320 26330 MT ($0C)SH 14520 XM (r SOS) 7200 W( SOS) 2400 W( system file)SH 7320 27361 MT ($0D)SH 14520 XM (r SOS) 7200 W( SOS) 2400 W( reserved file type)SH 7320 28392 MT ($0E)SH 14520 XM (r SOS) 7200 W( SOS) 2400 W( reserved file type)SH 7320 29423 MT ($0F)SH 14520 XM (r DIR Both) 2400 W( subDIRectory) 1800 W( file)SH 7320 30454 MT ($10)SH 14520 XM (r RPD SOS RPS) 2400 W( data file)SH 7320 31485 MT ($11)SH 14520 XM (r RPI SOS RPS) 2400 W( index file)SH 7320 32516 MT ($12)SH 14520 XM (r SOS) 7200 W( Applefile) 2400 W( diskcard file)SH 7320 33547 MT ($13)SH 14520 XM (r SOS) 7200 W( Applefile) 2400 W( model file)SH 7320 34578 MT ($14)SH 14520 XM (r SOS) 7200 W( Applefile) 2400 W( report format file)SH 7320 35609 MT ($15)SH 14520 XM (r SOS) 7200 W( Screen) 2400 W( library file)SH 7320 36640 MT ($16)SH 14520 XM (r SOS) 7200 W( SOS) 2400 W( reserved file type)SH 7320 37671 MT ($17)SH 14520 XM (r SOS) 7200 W( SOS) 2400 W( reserved file type)SH 7320 38702 MT ($18)SH 14520 XM (r SOS) 7200 W( SOS) 2400 W( reserved file type)SH 7320 39733 MT ($19)SH 14520 XM (r ADB ProDOS) 2400 W( AppleWorks) 600 W( Database file)SH 7320 40764 MT ($1A)SH 14520 XM (r AWP ProDOS) 2400 W( AppleWorks) 600 W( WordProcessing file)SH 7320 41795 MT ($1B)SH 14520 XM (r ASP ProDOS) 2400 W( AppleWorks) 600 W( Spreadsheet file)SH 7320 42826 MT ($1C-$5F)SH 14520 XM (r Reserved)10200 W 7320 43857 MT ($60-$6F)SH 14520 XM (r ProDOS) 10200 W( PC) 600 W( Transporter \050Applied Engineering\051)SH 22920 44888 MT (reserved filetyp)SH 7920 45919 MT ($60)SH 14520 XM (r PRE ProDOS) 2400 W( ProDOS) 600 W( preboot driver)SH 7920 46950 MT ($61-$6A)SH 14520 XM (r ProDOS) 4800 W( Reserved)600 W 7920 47981 MT ($6B)SH 14520 XM (r NIO ProDOS) 2400 W( PC) 600 W( Transporter BIOS and drivers)SH 7920 49012 MT ($6C)SH 14520 XM (r ProDOS) 7200 W( Reserved)600 W 7920 50043 MT ($6D)SH 14520 XM (r DVR ProDOS) 2400 W( PC) 600 W( Transporter device drivers)SH 7920 51074 MT ($6E)SH 14520 XM (r ProDOS) 7200 W( Reserved)600 W 7920 52105 MT ($6F)SH 14520 XM (r HDV ProDOS) 2400 W( MSDOS) 600 W( HardDisk Volume)SH 7320 53136 MT ($70-$9F)SH 14520 XM (r Reserved)15000 W 7320 54167 MT ($A0)SH 14520 XM (r WPF ProDOS) 2400 W( WordPerfect) 600 W( document file)SH 7320 55198 MT ($A1)SH 14520 XM (r MAC ProDOS) 2400 W( Macrofile)600 W 7320 56229 MT ($A2)SH 14520 XM (r HLP ProDOS) 2400 W( Help) 600 W( File)SH 7320 57260 MT ($A3)SH 14520 XM (r DAT ProDOS) 2400 W( Data) 600 W( File)SH 7320 58291 MT ($A4)SH 14520 XM (r Reserved)12000 W 7320 59322 MT ($A5)SH 14520 XM (r LEX ProDOS) 2400 W( Spelling) 600 W( dictionary)SH 7320 60353 MT ($A6-$AB)SH 14520 XM (r Reserved)10200 W /Times-Bold SF 21492 62070 MT (Table 14-4:)SH /Times-Roman SF 26853 XM (PRODOS file types, part 1)SH 46800 50 6120 63880 UL 6120 65471 MT (this command.) 37 W( Using) 322 W( delay times is probably a desperation move to keep the screen/printer from losing characters.)36 W 6120 66667 MT (Setting the timings will have to be set by experience.) 44 W( Perhaps) 339 W( the best way to set the timings is to bring the values)45 W 6120 67863 MT (down until you get failures and then double the timing figure. Both) 28 W( LOG and SET PRINTER will probably depend)27 W 6120 69059 MT (on flow control.)SH 8120 70850 MT (OFF)SH 16120 XM (Turn off flow control)SH ES %%Page: 303 304 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (14.5. Kermit-65 Commands)SH 10 /Times-Italic AF 51275 XM (Page 303)SH 46800 50 8280 5709 UL 46800 50 8280 8086 UL /Courier SF 9480 10865 MT (Num Name) 7200 W( OS)1800 W 4800 50 9480 11065 UL 2400 50 19080 11065 UL 2400 50 23880 11065 UL 9480 11896 MT ($AC)SH 16680 XM (r ARC ProDOS) 2400 W( General) 600 W( Purpose Archive file)SH 9480 12927 MT ($AD-$AF)SH 16680 XM (r Reserved)15000 W 9480 13958 MT ($B0)SH 16680 XM (r SRC ProDOS) 2400 W( ORCA/M) 600 W( & APW source file)SH 9480 14989 MT ($B1)SH 16680 XM (r OBJ ProDOS) 2400 W( ORCA/M) 600 W( & APW object file)SH 9480 16020 MT ($B2)SH 16680 XM (r LIB ProDOS) 2400 W( ORCA/M) 600 W( & APW library file)SH 9480 17051 MT ($B3)SH 16680 XM (r S16 ProDOS) 2400 W( ProDOS16) 600 W( system file)SH 9480 18082 MT ($B4)SH 16680 XM (r RTL ProDOS) 2400 W( ProDOS16) 600 W( runtime library)SH 9480 19113 MT ($B5)SH 16680 XM (r EXE ProDOS) 2400 W( APW) 600 W( shell command file)SH 9480 20144 MT ($B6)SH 16680 XM (r STR ProDOS) 2400 W( ProDOS16) 600 W( startup init file)SH 9480 21175 MT ($B7)SH 16680 XM (r TSF ProDOS) 2400 W( ProDOS16) 600 W( temporary init file)SH 9480 22206 MT ($B8)SH 16680 XM (r NDA ProDOS) 2400 W( ProDOS16) 600 W( new desk accessory)SH 9480 23237 MT ($B9)SH 16680 XM (r CDA ProDOS) 2400 W( ProDOS16) 600 W( classic desk accessory)SH 9480 24268 MT ($BA)SH 16680 XM (r TOL ProDOS) 2400 W( ProDOS16) 600 W( toolset file)SH 9480 25299 MT ($BB)SH 16680 XM (r DRV ProDOS) 2400 W( ProDOS16) 600 W( driver file)SH 9480 26330 MT ($BC-$BE)SH 16680 XM (r Reserved) 15000 W( for ProDOS16 load file)SH 9480 27361 MT ($BF)SH 16680 XM (r DOC ProDOS) 2400 W( document) 600 W( file)SH 9480 28392 MT ($C0)SH 16680 XM (r PNT ProDOS) 2400 W( //gs) 600 W( paint document)SH 9480 29423 MT ($C1)SH 16680 XM (r SCR ProDOS) 2400 W( //gs) 600 W( screen file)SH 9480 30454 MT ($C2-$C7)SH 16680 XM (r Reserved)5400 W 9480 31485 MT ($C8)SH 16680 XM (r FNT ProDOS) 2400 W( Printer) 600 W( font file)SH 9480 32516 MT ($C9)SH 16680 XM (r ProDOS) 7200 W( finder) 600 W( files)SH 9480 33547 MT ($CA)SH 16680 XM (r ProDOS) 7200 W( finder) 600 W( icons)SH 9480 34578 MT ($CB-$DF)SH 16680 XM (r Reserved)15000 W 9480 35609 MT ($E0)SH 16680 XM (r LBR ProDOS) 2400 W( Apple) 600 W( archive library file)SH 9480 36640 MT ($E1)SH 16680 XM (r Unknown) 12000 W( \050unlisted\051)SH 9480 37671 MT ($E2)SH 16680 XM (r ATI ProDOS) 2400 W( Appletalk) 600 W( init file)SH 9480 38702 MT ($E3-$EE)SH 16680 XM (r Reserved)3600 W 9480 39733 MT ($EF)SH 16680 XM (r PAS ProDOS) 2400 W( ProDOS) 600 W( Pascal file)SH 9480 40764 MT ($F0)SH 16680 XM (r CMD ProDOS) 2400 W( added) 600 W( command file)SH 9480 41795 MT ($F1-$F8)SH 16680 XM (r ProDOS) 10200 W( User) 600 W( defined filetypes)SH 25080 42826 MT (\050popular ones include:\051)SH 10080 43857 MT ($F1)SH 16680 XM (r OVL ProDOS) 2400 W( Overlay) 600 W( file)SH 10080 44888 MT ($F2)SH 16680 XM (r DBF ProDOS) 2400 W( Database) 600 W( file)SH 10080 45919 MT ($F3)SH 16680 XM (r PAD ProDOS) 2400 W( MouseWrite) 600 W( file)SH 10080 46950 MT ($F4)SH 16680 XM (r MCR ProDOS) 2400 W( AE) 600 W( Pro macro file)SH 10080 47981 MT ($F5)SH 16680 XM (r ECP ProDOS) 2400 W( ECP) 600 W( batch file)SH 10080 49012 MT ($F6)SH 16680 XM (r DSC ProDOS) 2400 W( description) 600 W( file)SH 10080 50043 MT ($F7)SH 16680 XM (r TMP ProDOS) 2400 W( temporary) 600 W( work file)SH 10080 51074 MT ($F8)SH 16680 XM (r RSX ProDOS) 2400 W( linkable) 600 W( object module)SH 9480 52105 MT ($F9)SH 16680 XM (r IMG ProDOS) 2400 W( ProDOS) 600 W( image file)SH 9480 53136 MT ($FA)SH 16680 XM (r INT) 2400 W( ProDOS) 1800 W( Integer) 600 W( BASIC program)SH 9480 54167 MT ($FB)SH 16680 XM (r IVR) 2400 W( ProDOS) 1800 W( Integer) 600 W( BASIC variables file)SH 9480 55198 MT ($FC)SH 16680 XM (r BAS) 2400 W( ProDOS) 1800 W( AppleSoft) 600 W( BASIC program)SH 9480 56229 MT ($FD)SH 16680 XM (r VAR) 2400 W( ProDOS) 1800 W( AppleSoft) 600 W( BASIC variables file)SH 9480 57260 MT ($FE)SH 16680 XM (r REL) 2400 W( ProDOS) 1800 W( ProDOS) 600 W( EDASM relocatable object module file)SH 9480 58291 MT ($FF)SH 16680 XM (r SYS) 2400 W( ProDOS) 1800 W( ProDOS8) 600 W( system file)SH /Times-Bold SF 23652 60008 MT (Table 14-5:)SH /Times-Roman SF 29013 XM (PRODOS file types, part 2)SH 46800 50 8280 61818 UL 10280 63409 MT (XON)SH 18280 XM (Turn on xon/xoff flow control with the remote)SH 10280 65067 MT (DELAY)SH /Times-Italic SF 13918 XM (number)SH /Times-Roman SF 18280 XM (Delay the micro until XOFF takes effect)SH 8280 67459 MT (Delay followed by a number \050including 0\051 delays) 14 W( the program for that many milliseconds after the XOFF is given to)15 W 8280 68655 MT (the remote. This delay allows the XOFF to take effect before the program continues.)SH 8280 71047 MT (NOTE: Except) 309 W( for printing and logging, most Apples will not require you to use a flow delay, even at rates up thru)29 W ES %%Page: 304 305 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 304)SH 12 /Times-Bold AF 30817 XM (Kermit User Guide: Apple II Kermit \05014.5\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (19200 baud; for proper screen control,) 52 W( however, certain older Apple IIe's may require a fairly high delay \050120-160)53 W 6120 9082 MT (dec\051, even at 300 baud.)SH /Times-Bold SF 8120 11360 MT (SET KEYBOARD)SH /Times-Roman SF 6120 13126 MT (Syntax:)SH /Courier SF 9426 XM (SET KEYBOARD {2P, 2E})SH /Times-Roman SF 6120 15518 MT (SET KEYBOARD tells Kermit-65 if the user has a) 68 W( full keyboard \0502E\051 or not \0502P\051. If the user is on an Apple II+,)67 W 6120 16714 MT (this should be set to 2P \050which is the default\051. When set to that, character) 95 W( translations are available by using the)96 W 6120 17910 MT (right-arrow key as a prefix character, as shown in Table 14-3.)SH /Times-Bold SF 8120 20188 MT (SET KEYPAD)SH /Times-Roman SF 6120 21954 MT (Syntax:)SH /Courier SF 9426 XM (SET KEYPAD {ON, OFF})SH /Times-Roman SF 6120 24346 MT (SET KEYPAD tells Kermit-65 if the user has an Apple//gs-style keypad available. This is automatically set on) 22 W( a gs)21 W 6120 25542 MT (but must be set) 14 W( manually on other machines. With keypad set ON then "VT100 keypad on an Apple keyboard" \050see)15 W 6120 26738 MT (below\051 will not be used but the actual keypad will be.)SH /Times-Bold SF 8120 29016 MT (SET LOCAL-ECHO)SH /Times-Roman SF 6120 31408 MT (Syntax:)SH /Courier SF 9426 XM (SET LOCAL-ECHO {ON,OFF} [Default: OFF])SH /Times-Roman SF 6120 33800 MT (This command tells Kermit-65 to echo to the screen characters you type on the keyboard \050LOCAL-ECHO = ON\051, or)9 W 6120 34996 MT (to let the remote system echo the typed characters \050LOCAL-ECHO = OFF\051. If, when CONNECTed to the) 49 W( remote,)50 W 6120 36192 MT (you see a duplicate of every character you type, escape back to Kermit-65, and SET LOCAL-ECHO OFF.) 39 W( If, when)38 W 6120 37388 MT (CONNECTed to the remote, you see nothing echoed to the screen, escape) 354 W( back to Kermit-65, and SET)355 W 6120 38584 MT (LOCAL-ECHO ON.)SH /Times-Bold SF 8120 40862 MT (SET PARITY)SH /Times-Roman SF 6120 43254 MT (Syntax:)SH /Courier SF 9426 XM (SET PARITY {NONE, EVEN, ODD, MARK, SPACE} [Default: NONE])SH /Times-Roman SF 6120 45646 MT (This command) 58 W( tells Kermit-65 which parity you want to use while communicating with the remote. Most remotes)57 W 6120 46842 MT (use NONE; some use EVEN, a few may use the other possible values. If you have a choice of parity to) 58 W( use with a)59 W 6120 48038 MT (remote machine, if possible, choose NONE.)SH /Times-Bold SF 8120 50316 MT (SET PREFIX)SH /Times-Roman SF 6120 52708 MT (Syntax:)SH /Courier SF 9426 XM (SET PREFIX string [Default: boot volume])SH /Times-Roman SF 6120 55100 MT (This command allows you to specify a ProDOS file prefix.)SH /Times-Bold SF 8120 57378 MT (SET PRINTER)SH /Times-Roman SF 6120 59144 MT (Syntax:)SH /Courier SF 9426 XM (SET PRINTER {ON, SLOT})SH /Times-Italic SF 23226 XM (number)SH 8520 60340 MT (or)SH /Courier SF 9659 XM (SET PRINTER OFF)SH /Times-Roman SF 6120 62732 MT (This allows one to) 11 W( turn the printer on for printing what is displayed on the screen. With all the different printers and)10 W 6120 63928 MT (printer cards there will be a lot of variability here but flow) 29 W( control \050XON/XOFF\051 is probably required when you are)30 W 6120 65124 MT (connected to a remote site. The printer can also) 189 W( be toggled on/off via the ESCAPE character followed by the)188 W 6120 66320 MT (command "P".)SH 6120 68712 MT (Remember when you use your) 96 W( printer there are a lot of variables here. What was being sent to the screen now is)97 W 6120 69908 MT (being sent to your printer. If you were emulating) 84 W( the VT52 your printer may not know how to handle the escape)83 W 6120 71104 MT (sequences, tabs, etc. It may be you can tell the host you are a tty or some) 30 W( such device that will give produce control)31 W ES %%Page: 305 306 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (14.5. Kermit-65 Commands)SH 10 /Times-Italic AF 51275 XM (Page 305)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (codes that your printer can handle. Some printers may require the flow control and delay to get readable printing.)SH 10280 9677 MT (ON)SH 18280 XM (Turn the printer on, slot number is required.)SH 10280 11335 MT (OFF)SH 18280 XM (Turn the printer off.)SH 10280 12993 MT (SLOT)SH /Times-Italic SF 13030 XM (number)SH /Times-Roman SF 18280 XM (Printer card is in slot "number".)SH /Times-Bold SF 10280 15271 MT (SET PROTOCOL)SH /Times-Roman SF 8280 17037 MT (Syntax:)SH /Courier SF 11586 XM (SET PROTOCOL {KERMIT, XMODEM})SH /Times-Roman SF 8280 19429 MT (SET PROTOCOL tells kermit-65 which protocol to use for file transfer. NOTE: When) 28 W( XMODEM is used you will)27 W 8280 20625 MT (probably want) 83 W( to change the carrage return and carrage return/line feed translation in the send/receive parameters.)84 W 8280 21821 MT (eg. "SET SEND CR<->CR,LF OFF" and "SET RECEIVE CR<->CR,LF OFF".)SH /Times-Bold SF 10280 24099 MT (SET SLOT)SH /Times-Roman SF 8280 25865 MT (Syntax:)SH /Courier SF 11586 XM (SET SLOT)SH /Times-Italic SF 16986 XM (number)SH /Times-Roman SF 8280 28257 MT (This option tells Kermit-65 in which slot the communication device is located.) 22 W( The) 293 W( range for the number parameter)21 W 8280 29453 MT (is 1-7.)SH /Times-Bold SF 10280 31731 MT (SET TIMER)SH /Times-Roman SF 8280 34123 MT (Syntax:)SH /Courier SF 11586 XM (SET TIMER {ON, OFF})SH /Times-Roman SF 8280 36515 MT (SET TIMER will turn on or off the) 104 W( timeout checking for receive file transfers. Since there is no clock for exact)105 W 8280 37711 MT (timing a loop of instructions has been set up assuming a 1 megacycle CPU. CPUs which run faster) 94 W( may have to)93 W 8280 38907 MT (make allowances via the SET RECEIVE TIMEOUT command or the SET TIMING command.)SH /Times-Bold SF 10280 41185 MT (SET TIMIMG)SH /Times-Roman SF 8280 43577 MT (Syntax:)SH /Courier SF 11586 XM (SET TIMIMG { number })SH /Times-Roman SF 8280 45969 MT (Kermit uses a timing loop with the rom address $fca8) 84 W( to produce a 1 ms. delay. If you have a machine that runs)85 W 8280 47165 MT (faster than the 6502 chip you may have to increase this number to get the 1 ms delay.)SH /Times-Bold SF 10280 49443 MT (SET TERMINAL)SH /Times-Roman SF 8280 51209 MT (Syntax:)SH /Courier SF 11586 XM (SET TERMINAL {MONITOR, NONE, VT100, VT52})SH /Times-Roman SF 8280 53601 MT (When TERMINAL is NONE, then all incoming characters \050except nulls\051 are passed directly to the display.)SH 8280 55993 MT (MONITOR emulation simply displays) 237 W( all the characters received from the remote \050except nulls\051 without any)236 W 8280 57189 MT (formating of the screen \05040 or 80 characters per line\051. Control characters are displayed inverse.)SH 8280 59581 MT (VT100 Emulation)SH 7250 50 8280 59781 UL 8280 61973 MT (The Kermit-65 VT100 emulator is a small but working set of a true VT100 terminal.) 46 W( It) 343 W( appears to work with most)47 W 8280 63169 MT (of the standard full) 17 W( screen editors and processors on BSD UNIX and VAX/VMS machines. An Apple//e, //c, or //gs)16 W 8280 64365 MT (is probably required with the Apple 80 column text card. Sorry, but the II and) 38 W( II+ will probably have to use one of)39 W 8280 65561 MT (the other terminal options. The VT100 keypad has also been defined) 19 W( for the application mode via the OA/CA/game)18 W 8280 66757 MT (button. Figure) 462 W( 14-1) 106 W( shows the Apple keypad looks like to EDIT \050VMS\051, an Figure 14-2 shows the layout on an)107 W 8280 67953 MT (Apple//gs keyboard. When using EVE \050VMS\051 the meaning of the keys will of course change.)SH 8280 70345 MT (As you can see the keypad is physically laid out like the VT100 keypad except for the lower right corner.) 73 W( Notice)394 W 8280 71541 MT (that above) 85 W( the keys are the VT100 labels while within the box \050key\051 is the Apple key label. Also the arrow keys)86 W ES %%Page: 306 307 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 306)SH 12 /Times-Bold AF 30817 XM (Kermit User Guide: Apple II Kermit \05014.5\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (work as VT100 arrow keys with the OA/CA/game button.)SH 46800 50 6120 9877 UL /Courier SF 21120 12656 MT (PF1 PF2 PF3 PF4 .\050period\051)2400 W 19920 13687 MT (------- ------- ------- ------- -------)SH 19320 14718 MT (| | |findnxt|delline|select) 3600 W( |)SH 19320 15749 MT (| 6 | 7 | 8 | 9 | 0 |)1200 W 19320 16780 MT (| gold | help | find |undelln| reset |)SH 19920 17811 MT (------- ------- ------- ------- -------)SH 22920 18842 MT (7 8 9 -)3600 W 21720 19873 MT (------- ------- ------- -------)SH 21120 20904 MT (| page |section|append |delword|)SH 21120 21935 MT (| Y | U | I | O |)1200 W 21120 22966 MT (|command| fill |replace|undelwd|)SH 21720 23997 MT (------- ------- ------- -------)SH 24720 25028 MT (4 5 6 ,)3600 W 23520 26059 MT (------- ------- ------- -------)SH 23520 27090 MT (|advanc|backup | cut |delchar|)SH 23520 28121 MT (| H) 600 W( | J | K | L |)1200 W 23520 29152 MT (|bottom| top |) 600 W( paste |undelch|)SH 23520 30183 MT (------- ------- ------- -------)SH 26520 31214 MT (1 2 3 ENTER)3600 W 25320 32245 MT (------- ------- ------- -------)SH 24720 33276 MT (| word | eol | char | enter |)SH 24720 34307 MT (| N | M | , | . |)1200 W 24720 35338 MT (|chgcase|deleol |specins| sub |)SH 25320 36369 MT (------- ------- ------- -------)SH 28920 37400 MT (0)SH 12120 38431 MT (---------------------------------------)SH 28920 39462 MT (bline |)3000 W 15120 40493 MT (space bar) SH( |)14400 W 28320 41524 MT (openline |)1800 W 12120 42555 MT (---------------------------------------)SH /Times-Bold SF 18883 44272 MT (Figure 14-1:)SH /Times-Roman SF 24632 XM (VT100 Keypad on an Apple Keyboard)SH 46800 50 6120 46082 UL 6120 48274 MT (VT52 Emulation)SH 6750 50 6120 48474 UL 6120 50666 MT (SET TERMINAL VT52 will turn on the VT52 terminal) 93 W( emulation. One thing that is required is your 80-column)92 W 6120 51862 MT (card must handle) 2 W( the $16 command in order for reverse scrolling to work. The Apple//e 80 column card handles this)3 W 6120 53058 MT (fine. The) 348 W( VT52) 49 W( keypad has been defined using the open/closed Apple. For II or II+ one will have to have a game)48 W 6120 54254 MT (paddle or joy stick \050key shift mod too????\051 and) 55 W( use the buttons. When a button/open/closed Apple is pushed then)56 W 6120 55450 MT (the keys starting with 6,7,8 & 9 form the top of the keypad. Key 6 is the blue key key 7 is) 27 W( the red key etc. The keys)26 W 6120 56646 MT (directly below the 6,7,8 & 9 and shifted) 7 W( one-half key to the right form the second row of the keypad etc. Every thing)8 W 6120 57842 MT (is fine until you get to the last row on the keypad. There the sp bar is 0 and the other) 90 W( two keys are moved to the)89 W 6120 59038 MT (upper right as the 0 & - keys. This way the arrow keys are available) 73 W( as VT52 keys with the OA/CA/game button)74 W 6120 60234 MT (combination \050thanks to Dick Atlee for) 84 W( this idea\051. With those two exceptions the keypad is physically similar to a)83 W 6120 61430 MT (VT52 keypad. Remember the open/closed Apple or the game button must be pushed \050like the) 72 W( cntl key\051 to get the)73 W 6120 62626 MT (keypad emulation. Figure 14-3 should clear up the questions.)SH 6120 65018 MT (The arrow keys work as VT52 arrow keys with the OA/CA/game button.)SH ES %%Page: 307 308 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (14.5. Kermit-65 Commands)SH 10 /Times-Italic AF 51275 XM (Page 307)SH 46800 50 8280 5709 UL 46800 50 8280 8086 UL /Courier SF 23280 10865 MT (PF1 PF2 PF3 PF4)2400 W 22080 11896 MT (------- ------- ------- -------)SH 21480 12927 MT (| | |findnxt|delline|)3600 W 21480 13958 MT (| CLEAR |) SH( = | / | * |)1200 W 21480 14989 MT (| gold | help | find |undelln|)SH 22080 16020 MT (------- ------- ------- -------)SH 23280 17051 MT (7 8 9 -)3600 W 22080 18082 MT (------- ------- ------- -------)SH 21480 19113 MT (| page |section|append |delword|)SH 21480 20144 MT (| 7 | 8 | 9 | + |)1200 W 21480 21175 MT (|command| fill |replace|undelwd|)SH 22080 22206 MT (------- ------- ------- -------)SH 23280 23237 MT (4 5 6 ,)3600 W 22080 24268 MT (------- ------- ------- -------)SH 21480 25299 MT (| advanc|backup | cut |delchar|)SH 21480 26330 MT (| 4 | 5 | 6 | - |)1200 W 21480 27361 MT (| bottom| top | paste |undelch|)SH 22080 28392 MT (------- ------- ------- -------)SH 23280 29423 MT (1 2 3 ENTER)3600 W 22080 30454 MT (------- ------- ------- -------)SH 21480 31485 MT (| word | eol | char |) SH( |)3600 W 21480 32516 MT (| 1 | 2 | 3 |) 1200 W( |)3600 W 21480 33547 MT (|chgcase|deleol |specins|) SH( |)3600 W 22080 34578 MT (------- ------- -------| enter |)SH 26280 35609 MT (0 .) 5400 W( |) 1800 W( ENTER |)SH 22080 36640 MT (-----------------------| sub |)600 W 21480 37671 MT (| bline) 1800 W( |select) 3000 W( |) SH( |)3600 W 21480 38702 MT (| 0) 3000 W( |) 4200 W( . |) 1200 W( |)3600 W 21480 39733 MT (| openline) 600 W( |) 2400 W( reset |) SH( |)3600 W 22080 40764 MT (-------------------------------)SH /Times-Bold SF 17904 42481 MT (Figure 14-2:)SH /Times-Roman SF 23653 XM (VT100 Keypad on an Apple//gs or Equivalent Keypad)SH 46800 50 8280 44291 UL 13 /Times-Bold AF 24349 47450 MT (THE SHOW COMMAND)SH 10 /Times-Roman AF 8280 49823 MT (Syntax:)SH /Courier SF 11586 XM (SHOW [)SH /Times-Italic SF (option)SH /Courier SF (])SH /Times-Roman SF 8280 52215 MT (The SHOW command displays various information:)SH 10280 54006 MT (ALL)SH 22280 XM (All parameter settings \050this is quite long\051.)SH 10280 55664 MT (BAUD)SH 22280 XM (Baud rate of the com card.)SH 10280 57322 MT (CURSOR-KEYS-VT100)SH 22280 XM (Are the cursor keys emulating the VT100 cursor keys?)SH 10280 58980 MT (DEBUGGING)SH 22280 XM (Debugging mode.)SH 10280 60638 MT (DEFAULT-DISK)SH 22280 XM (Which Diskette drive is used for file transfer?)SH 10280 62296 MT (DEVICE-DRIVER)SH 22280 XM (Which communication device is being used?)SH 10280 63954 MT (DISPLAY)SH 22280 XM (Which screen display is being used?)SH 10280 65612 MT (ESCAPE)SH 22280 XM (Character for terminal connection.)SH 10280 67270 MT (FILE-TYPE)SH 22280 XM (Of Apple DOS/PRODOS file being sent/received.)SH 10280 68928 MT (FILE-WARNING)SH 22280 XM (Warn users if incoming file exists?)SH 10280 70586 MT (FLOW)SH 22280 XM (Should XON/XOFF flow control be used to the remote?)SH ES %%Page: 308 309 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 308)SH 12 /Times-Bold AF 30817 XM (Kermit User Guide: Apple II Kermit \05014.5\051)SH 46800 50 6120 5709 UL 46800 50 6120 8086 UL 10 /Courier AF 9720 10865 MT (^ is up arrow) SH( BLUE) 1800 W( RED GRAY ^) 2400 W( .\050period\051) 1800 W( ENTER)SH 19920 11896 MT (------- ------- ------- ------- ------- -------)SH 19320 12927 MT (| | |delline|) 3600 W( up) 600 W( |select) 1200 W( | enter |)SH 19320 13958 MT (| 6 | 7 | 8 | 9 | 0 | - |)1200 W 19320 14989 MT (| gold | help |undelln|replace| reset | sub |)SH 19920 16020 MT (------- ------- ------- ------- ------- -------)SH 10920 17051 MT (v is down arrow) SH( 7) 2400 W( 8 9 v)3600 W 21720 18082 MT (------- ------- ------- -------)SH 21120 19113 MT (| page |findnxt|delword| down |)SH 21120 20144 MT (| Y | U | I | O |)1200 W 21120 21175 MT (|command| find |undelwd|section|)SH 21720 22206 MT (------- ------- ------- -------)SH 24720 23237 MT (4 5 6 ->)3600 W 23520 24268 MT (------- ------- ------- -------)SH 23520 25299 MT (|advanc|backup |delchar| right |)SH 23520 26330 MT (| H) 600 W( | J | K | L |)1200 W 23520 27361 MT (|bottom| top |undelch|specins|)600 W 23520 28392 MT (------- ------- ------- -------)SH 26520 29423 MT (1 2 3) 3600 W( <-)3000 W 25320 30454 MT (------- ------- ------- -------)SH 24720 31485 MT (| word | eol | cut | left |)SH 24720 32516 MT (| N | M | , | . |)1200 W 24720 33547 MT (|chgcase|deleol | paste |append |)SH 25320 34578 MT (------- ------- ------- -------)SH 28320 35609 MT (0)SH 12120 36640 MT (---------------------------------------)SH 28920 37671 MT (bline |)3000 W 15120 38702 MT (space bar) SH( |)14400 W 28320 39733 MT (openline |)1800 W 12120 40764 MT (---------------------------------------)SH /Times-Bold SF 19133 42481 MT (Figure 14-3:)SH /Times-Roman SF 24882 XM (VT52 Keypad on an Apple Keyboard)SH 46800 50 6120 44291 UL 8120 45882 MT (KEYBOARD)SH 20120 XM (II+ or //e keyboard.)SH 8120 47540 MT (KEYPAD)SH 20120 XM (Does a gs-style keypad exist?)SH 8120 49198 MT (LOCAL-ECHO)SH 20120 XM (Full or half duplex switch.)SH 8120 50856 MT (PARITY)SH 20120 XM (Character parity to use)SH 8120 52514 MT (PREFIX)SH 20120 XM (Which default prefix to use with PRODOS?)SH 8120 54172 MT (PRINTER)SH 20120 XM (Should the printer be used for the display?)SH 8120 55830 MT (PROTOCOL)SH 20120 XM (Which protocol is to be used for file transfer.)SH 8120 57488 MT (RECEIVE)SH 20120 XM (Various parameters for receiving files)SH 8120 59146 MT (SEND)SH 20120 XM (Various parameters for sending files)SH 8120 60804 MT (SLOT)SH 20120 XM (Which slot # is communication device in?)SH 8120 62462 MT (TIMER)SH 20120 XM (Is the receive timeout on or off?)SH 8120 64120 MT (TERMINAL)SH 20120 XM (Which terminal \050if any\051 should Kermit emulate?)SH 6120 65911 MT (The above options are analogous to the equivalent SET commands.)SH ES %%Page: 309 310 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (14.5. Kermit-65 Commands)SH 10 /Times-Italic AF 51275 XM (Page 309)SH 46800 50 8280 5709 UL 13 /Times-Bold AF 24817 8071 MT (The STATUS Command)SH 10 /Times-Roman AF 8280 10444 MT (Syntax:)SH /Courier SF 11586 XM (STATUS)SH /Times-Roman SF 8280 12836 MT (Give statistics about the most recent file transfer. This includes information such as) 317 W( number of characters)316 W 8280 14032 MT (sent/received, number of data characters sent/received, and last error encountered.)SH 13 /Times-Bold AF 25901 17391 MT (The LOG Command)SH 10 /Times-Roman AF 8280 19764 MT (Syntax:)SH /Courier SF 11586 XM (LOG)SH /Times-Italic SF 13986 XM (filespec)SH /Times-Roman SF 8280 22156 MT (When connected to a remote site, log the remote session's output to the specified file. The file type and file) 8 W( warning)9 W 8280 23352 MT (protocols are observed. This command is dependent upon the flow control \050XON/XOFF\051 working. Without flow)100 W 8280 24548 MT (control there is little possibility of getting a correct copy of the terminal session. The logging) 124 W( begins when you)125 W 8280 25744 MT (connect to the remote and is terminated when you escape back to the local Kermit) 147 W( with the ESCAPE character)146 W 8280 26940 MT (followed by the "C" command.)SH 14 /Times-Bold AF 8280 30542 MT (14.6. Standard Installation)SH 10 /Times-Roman AF 8280 32660 MT (To bootstrap Kermit to the Apple, get the files)70 W /Courier SF 27687 XM (APP3)SH /Times-Italic SF (xx)SH /Courier SF (.1)SH /Times-Roman SF 32496 XM (thru)SH /Courier SF 34428 XM (APP3)SH /Times-Italic SF (xx)SH /Courier SF (.2)SH /Times-Roman SF 39237 XM (on a DOS 3.3 diskette, where)71 W /Times-Italic SF 51661 XM (xx)SH /Times-Roman SF 52870 XM (is the)71 W 8280 33856 MT (current version. Make sure the diskette is a master diskette and empty. Then:)SH /Courier SF 10680 35571 MT (EXEC APP3)SH /Times-Italic SF (xx)SH /Courier SF (.1,R25)SH /Times-Roman SF 8280 37963 MT (You will be asked several questions) 117 W( about your hardware and the program should execute and produce a binary,)116 W /Courier SF 8280 39159 MT (kermit.help)SH /Times-Roman SF 15303 XM (and)SH /Courier SF 17170 XM (kermit.init)SH /Times-Roman SF 24193 XM (with some starting instructions. If you) 173 W( want to run Kermit on PRODOS)174 W 8280 40355 MT (simply use the PRODOS conversion) 329 W( routines to move the binary,)328 W /Courier SF 37924 XM (kermit.help)SH /Times-Roman SF 45102 XM (and)SH /Courier SF 47124 XM (kermit.init)SH /Times-Roman SF 54302 XM (to)SH 8280 41551 MT (PRODOS. If) 350 W( you want other options as a regular thing then change file)50 W /Courier SF 37838 XM (kermit.init)SH /Times-Roman SF 44739 XM (with your changes. Then)51 W 8280 42747 MT (make sure the file is on the same disk as the binary.)SH /Times-Bold SF 10280 45025 MT (Files Supplied for Kermit-65)SH /Times-Roman SF 8280 47417 MT (The following files should be supplied on the distribution tape:)SH /Courier SF 10280 49027 MT (APPAAA.HLP)SH /Times-Roman SF 21080 XM (List of files \050like this one\051)SH /Courier SF 10280 50132 MT (APP385.1)SH /Times-Roman SF 21080 XM (Easy install file 1 \050an exec file for DOS 3.3\051)SH /Courier SF 10280 51237 MT (APP385.2)SH /Times-Roman SF 21080 XM (Easy install file 2 \050an exec file for DOS 3.3\051)SH /Courier SF 10280 52342 MT (APPACC.HEX)SH /Times-Roman SF 21080 XM (Apple com card hex)SH /Courier SF 10280 53447 MT (APPACC.M65)SH /Times-Roman SF 21080 XM (Apple com card source)SH /Courier SF 10280 54552 MT (APPCCS.HEX)SH /Times-Roman SF 21080 XM (CCS 7710 com card hex)SH /Courier SF 10280 55657 MT (APPCCS.M65)SH /Times-Roman SF 21080 XM (CCS 7710 com card source)SH /Courier SF 10280 56762 MT (APPCPS.HEX)SH /Times-Roman SF 21080 XM (CPS com card hex)SH /Courier SF 10280 57867 MT (APPCPS.M65)SH /Times-Roman SF 21080 XM (CPS com card source)SH /Courier SF 10280 58972 MT (APPGS.HEX)SH /Times-Roman SF 21080 XM (GS serial port hex)SH /Courier SF 10280 60077 MT (APPGS.M65)SH /Times-Roman SF 21080 XM (GS serial port source)SH /Courier SF 10280 61182 MT (APPHMM.HEX)SH /Times-Roman SF 21080 XM (Hayes micro modem card hex)SH /Courier SF 10280 62287 MT (APPHMM.M65)SH /Times-Roman SF 21080 XM (Hayes micro modem card source)SH /Courier SF 10280 63392 MT (APPLE.DOC)SH /Times-Roman SF 21080 XM (Complete documentation \050it says here\051)SH /Courier SF 10280 64497 MT (APPLE.MSS)SH /Times-Roman SF 21080 XM (Scribe text formatter source for documentation)SH /Courier SF 10280 65602 MT (APPMAI.HEX)SH /Times-Roman SF 21080 XM (Main kermit pgm hex)SH /Courier SF 10280 66707 MT (APPMAI.M65)SH /Times-Roman SF 21080 XM (Main kermit pgm source)SH /Courier SF 10280 67812 MT (APPMAK.UNX)SH /Times-Roman SF 21080 XM (Make file for UNIX cross assembly \050to assemble Kermit\051)SH /Courier SF 10280 68917 MT (APPMSV.HEX)SH /Times-Roman SF 21080 XM (Microtec com card hex)SH /Courier SF 10280 70022 MT (APPMSV.M65)SH /Times-Roman SF 21080 XM (Microtec com card source)SH /Courier SF 10280 71127 MT (APPSSC.HEX)SH /Times-Roman SF 21080 XM (Super serial com card hex)SH ES %%Page: 310 311 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 310)SH 12 /Times-Bold AF 30817 XM (Kermit User Guide: Apple II Kermit \05014.6\051)SH 46800 50 6120 5709 UL 10 /Courier AF 8120 7886 MT (APPSSC.M65)SH /Times-Roman SF 18920 XM (Super serial com card source)SH /Courier SF 8120 8991 MT (APPXAS.1)SH /Times-Roman SF 18920 XM (65c02 cross assembler for UNIX system part 1)SH /Courier SF 8120 10096 MT (APPXAS.2)SH /Times-Roman SF 18920 XM (65c02 cross assembler for UNIX system part 2)SH /Courier SF 8120 11201 MT (APPXAS.3)SH /Times-Roman SF 18920 XM (65c02 cross assembler for UNIX system part 3)SH 6120 12811 MT (The syntax of the) 169 W( filenames may vary. On UNIX systems, the filenames will be in lowercase. On VM/CMS)168 W 6120 14007 MT (systems, the period will be replaced by a space.)SH /Times-Bold SF 8120 16285 MT (Alternate Installation)SH /Times-Roman SF 6120 18677 MT (The main problem exists in getting the hex files onto your diskette as a text file. But again that is a) 97 W( test of your)98 W 6120 19873 MT (creativity. If you have a version of Kermit running then GET or RECIEVE the file as a text file and) 124 W( you are in)123 W 6120 21069 MT (business. Since) 454 W( Kermit has) 102 W( been separated into two assemblies then two hex files will have to be present on the)103 W 6120 22265 MT (diskette. Get the main hex file)286 W /Courier SF 20140 XM (APPMAI.HEX)SH /Times-Roman SF 26676 XM (and select which com card hex you) 286 W( will need. First ")285 W /Courier SF (exec)SH 6120 23461 MT (APPMAI.HEX)SH /Times-Roman SF (". Your) 382 W( Apple \050or compatable\051) 66 W( will go into monitor and show you)67 W /Courier SF 39836 XM (*)SH /Times-Roman SF ('s for several minutes. This is)67 W 6120 24657 MT (the monitor loading) 108 W( the hex into binary. If you get beeps from the monitor its probably because you didnt get a)107 W 6120 25853 MT (good copy of the text file. Now EXEC the com) 75 W( card driver you are going to use. You will have to get back into)76 W 6120 27049 MT (basic\050aha another test for you,try) 110 W( "3d0G"\051 to do this. And you will see the monitor loading the com driver. The)109 W 6120 28245 MT (order of EXEC's is important. The com card should be loaded) 106 W( last. Next get back into basic and do a ")107 W /Courier SF (bsave)SH 6120 29441 MT (kermit,A$1000,L$6e00)SH /Times-Roman SF (". You) 280 W( may have to) 15 W( specify the drive to do this binary save, with a slot or drive on the)14 W 6120 30637 MT (end of the BSAVE \050aha another test\051. You now run Kermit via ")SH /Courier SF (brun kermit)SH /Times-Roman SF (".)SH 6120 33029 MT (If you want to customize Kermit for your equipment, the recommended method is to) 21 W( use file "kermit.init" OR do all)22 W 6120 34225 MT (your SETs, etc, and then do an "exit". Now you should be back) 259 W( in BASIC. At this point do a ")258 W /Courier SF (bsave)SH /Times-Italic SF 6120 35421 MT (name)SH /Courier SF (,A$1000,L$6e00)SH /Times-Roman SF (" and when you do a ")64 W /Courier SF (brun)SH /Times-Italic SF 29005 XM (name)SH /Times-Roman SF (" all your setups will be remembered. NOTE: If you)65 W 6120 36617 MT (save your current settings via ")105 W /Courier SF (bsave kermit ...)105 W /Times-Roman SF (" you may find that moving that binary to another) 105 W( type of)104 W 6120 37813 MT (Apple \050e.g. from a //e to an //e+\051 will not be possible. So make sure) 44 W( you keep the original binary to move between)45 W 6120 39009 MT (machine types.)SH 6120 41401 MT (Since the org is now $1000 if you have been using Kermit and then went back to basic for some trivial thing a)125 W 6120 42597 MT ("CALL 4096" should start up Kermit without having to reload it.)SH 6120 44989 MT (In summary:)SH 8120 46780 MT (1.)SH /Courier SF 9120 XM (EXEC APPMAI.HEX)SH /Times-Roman SF 8120 48438 MT (2.)SH 9120 XM (Choose the com card driver you will use. For example)SH /Courier SF 31339 XM (APPSSC.HEX)SH /Times-Roman SF (.)SH 8120 50096 MT (3.)SH /Courier SF 9120 XM (3D0G)SH /Times-Roman SF 8120 51754 MT (4.)SH /Courier SF 9120 XM (EXEC APPSSC.HEX)SH /Times-Roman SF 8120 53412 MT (5.)SH /Courier SF 9120 XM (BSAVE kermit,A$1000,L$6e00)SH /Times-Roman SF 6120 55203 MT (And you should be in business. Remember there is the) 69 W( command HELP and whenever you are into a command a)70 W 6120 56399 MT ("?" will give you the posible options available at that point of a command. The escape key will finish typing) 100 W( an)99 W 6120 57595 MT (option if it is possible. The syntax of all the commands and options only requires enough characters to make) 92 W( that)93 W 6120 58791 MT (command or option unique.)SH 14 /Times-Bold AF 6120 62393 MT (14.7. Problems)SH 10 SS 8120 64671 MT (Installation)SH /Times-Roman SF 6120 67063 MT (NOTE: When using the super serial driver you must have the cards) 27 W( sw6-2 on. This allows the card to use interupts.)26 W 6120 68259 MT (The rest of the switches are) 44 W( set from within Kermit. It appears that you can run your Apple 2 with sw6-2 on and in)45 W 6120 69455 MT (99% of the) 48 W( cases will cause no problems. This is because the OS runs with interupts locked out \050"sei" in assembly)47 W 6120 70651 MT (language\051 and the program must explicitly give a "cli" for interupts to work \050the super serial driver does\051.)SH ES %%Page: 311 312 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (14.7. Problems)SH 10 /Times-Italic AF 51275 XM (Page 311)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (The AE Serial Pro) 265 W( must have switches 1 & 3 open and 2 & 4 closed. This appears to dissagree with the)266 W 8280 9082 MT (documentation since those settings turn off irq interupts) 2 W( and turn on nmi interupts. So watch this it may get corrected)1 W 8280 10278 MT (in later versions.)SH 8280 12670 MT (The Microtek driver is a super serial look alike which) 2 W( does not run with interupts. If you have trouble with the super)3 W 8280 13866 MT (serial driver you might try) 141 W( the MSV driver. For you people with the MSV-622c card, you might try running a)140 W 8280 15062 MT (jumper from the UART 6551 pin) 16 W( 26 to the card edge pin 30. This will enable interupts just like the SSC sw2-6, and)17 W 8280 16258 MT (then you can use the super serial driver.)SH 8280 18650 MT (The Prometheus) 50 W( card will work with the Apple com driver. However you will have to set the switches on the card)49 W 8280 19846 MT (for baud etc. Evidently this card can not be programed by) 31 W( the software. If that is not true then here is an oportunity)32 W 8280 21042 MT (for you to write a better driver. If you do please pass it on for other Prometheus users.)SH 8280 23434 MT (Unconfirmed reports have) 251 W( it that the Apple Cat will work with the Apple com driver. Would appreciate a)250 W 8280 24630 MT (confirmation.)SH 8280 27022 MT (Some have noted the Apple com card must be initialized via the "IN#x" before starting) 11 W( Kermit. Ike has now updated)12 W 8280 28218 MT (this driver and the initialization is now done within the Apple com driver. Thanks Ike.)SH /Times-Bold SF 10280 30496 MT (Usage)SH /Times-Roman SF 8280 32888 MT (There is) 181 W( the command HELP and whenever you are into a command a "?" will give you the posible options)180 W 8280 34084 MT (available at that point of a command. The escape) 46 W( key will finish typing an option if it is possible. The syntax of all)47 W 8280 35280 MT (the commands and options only requires enough characters to make that command or option unique.)SH 8280 37672 MT (When using flow control you may appear to hang. Type a)SH /Courier SF 31609 XM (^Q)SH /Times-Roman SF 33059 XM (\050Control-Q\051 and that may free you up.)SH 8280 40064 MT (Remember when) 82 W( you use your printer there are a lot of variables here. What was being sent to the screen now is)81 W 8280 41260 MT (being sent to your printer. If you were emulating the VT52 your) 83 W( printer may not know how to handle the escape)84 W 8280 42456 MT (sequences, tabs etc. It may be you can tell the host you are a tty or some such) 56 W( device that will give carrage returns)55 W 8280 43652 MT (etc that your printer can handle. Some printers may require the flow control and delay to get readable printing.)SH /Times-Bold SF 10280 45930 MT (File Transfer Errors)SH /Times-Roman SF 8280 48322 MT ("File Transfer Errors," was added to this document by the Southeast Regional Data Center \050SERDAC\051, '88 July 17.)SH 8280 50714 MT (In spite of the fact that successful Kermit) 241 W( file transfers are almost always error free, there are a number of)242 W 8280 51910 MT (circumstances which can corrupt, prevent,) 48 W( or interrupt/abort a transfer. In the case of an actual abort, there may be)47 W 8280 53106 MT (data loss or corruption, and an incomplete file may not have a) 128 W( correct end-of-file. These circumstances may be)129 W 8280 54302 MT (roughly divided into two groups: \0501\051 problems due to file or disk errors, and) 7 W( \0502\051 problems due to delays or failures in)6 W 8280 55498 MT (Kermit packet exchange.)SH 8280 57890 MT (Common problems in category \0501\051 include the following:)SH 8280 60282 MT (\050a\051 improper file specification \050b\051 wrong file type \050c\051 protected file\050s\051 \050d\051 disk problems)SH 8280 62674 MT (\0501a\051 problems can occur when) 38 W( you specify, to either the Apple or host Kermit, a non-existent or improperly located)39 W 8280 63870 MT (file. Misspelling) 440 W( and/or incorrect \050sub\051directory specification are popular villains!) 95 W( If) 439 W( you are commanding either)94 W 8280 65066 MT (Kermit to SEND a file \050SEND filespec\051, the problem will be fairly obvious.) 91 W( On) 433 W( the Apple II, you'll see an error)92 W 8280 66262 MT (message like: "FILE NOT FOUND." On the VAX/VMS 8800, for example, you'll see) 14 W( the message: "%KERMIT32)13 W 8280 67458 MT (....., file not found for 'filespec'". In either case, the transfer will not take place. If you're) 32 W( using Kermit-65 to GET)33 W 8280 68654 MT (\050GET filespec\051 files from the VAX/VMS Kermit server, and the requested file does not exist in your VAX default)65 W 8280 69850 MT (directory, you) 216 W( should see a Kermit-32 generated "REMOTE MESSAGE %KERMIT32 ....., file not found for)217 W 8280 71046 MT ('filespec'" appear in the transmission status display,) 269 W( and then the Kermit-65 message "CANNOT RECEIVE)268 W ES %%Page: 312 313 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 312)SH 12 /Times-Bold AF 30817 XM (Kermit User Guide: Apple II Kermit \05014.7\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (FILE-HEAD". Transfer) 250 W( of the questionable file will not take place.)SH 6120 10278 MT (\0501b\051 problems can occur if you forget to specify, to either the Apple or host Kermit, what type of file you wish) 72 W( to)73 W 6120 11474 MT (transfer. If) 388 W( you are using Kermit-65 to send files to a host, you are fairly well protected against this error. If you)69 W 6120 12670 MT (attempt to send a file whose CATALOG type does not match the) 46 W( FILE-TYPE parameter setting, you will receive a)47 W 6120 13866 MT ("INCOMPATIBLE FILE FORMAT" error message, or) 73 W( something similar, and the transfer will not take place. If,)72 W 6120 15062 MT (however, you are) 7 W( receiving \050via RECEIVE or GET\051 a file whose native type does not match the FILE-TYPE setting,)8 W 6120 16258 MT (the file WILL be received. It will be) 8 W( mis-typed \050according to the FILE-TYPE setting\051, though, and any later attempt)7 W 6120 17454 MT (to use it on the Apple will probably be unsuccessful.)SH 6120 19846 MT (The same sort of circumstances generally apply for a host Kermit. With the VAX 8800, for) 237 W( example, when)238 W 6120 21042 MT (Kermit-32 is sending a file, you generally need not worry) 27 W( about setting its file type. When Kermit-32 is receiving a)26 W 6120 22238 MT (file, however, properly) 64 W( setting its file type is very critical. If you wish to put Kermit-32 in server mode to receive)65 W 6120 23434 MT (multiple files, set the file type BEFORE using the) 129 W( SERVER command, and make sure that you only send it the)128 W 6120 24630 MT (appropriate type of files during that server session. You cannot switch file types DURING a given server session!)SH 6120 27022 MT (NOTE: One other way you can get into trouble with "wrong file type" is by trying to send) 70 W( a file which is mixed--)71 W 6120 28218 MT (mostly text, but with some imbedded characters that are not true 7-bit ASCII \050i.e., ASCII codes 00-127\051. This) 22 W( often)21 W 6120 29414 MT (happens when) 161 W( you are trying to transfer a file which is word processor output. Most word processing software)162 W 6120 30610 MT (claims to allow you to output a true ASCII or text file, but in some cases it really does not, and) 36 W( in others the choice)35 W 6120 31806 MT (of output options is confusing. If you have set up either Kermit program to) 59 W( send/receive a text file, and you try to)60 W 6120 33002 MT (transfer illegal ASCII) 65 W( characters \050codes 128-256\051, your transfer may "hang" or be aborted. At the very best, if the)64 W 6120 34198 MT (transfer "works," the suspect characters will later probably be meaningless or confusing to the destination machine.)SH 6120 36590 MT (\0501c\051 problems can occur in two) 36 W( ways on the Apple II. If your default drive disk is write protected, and you attempt)37 W 6120 37786 MT (to receive a file, you will receive a "WRITE PROTECTED" error message, and no transfer) 57 W( will take place. If you)56 W 6120 38982 MT (have set Kermit-65's) 1 W( FILE-WARNING parameter to OFF \050normally NOT a good idea\051, and you attempt to receive a)2 W 6120 40178 MT (file that already exists in a locked state on your default diskette, you will receive a) 32 W( "FILE LOCKED" error message)31 W 6120 41374 MT (\050if the file is very short, you may) 18 W( have to check with a Kermit-65 STATUS command to see the error message\051, and)19 W 6120 42570 MT (no transfer will take place.)SH 6120 44962 MT (Similar problems may occur on the host because of various file protection schemes.) 76 W( On) 400 W( the VAX/VMS 8800, for)75 W 6120 46158 MT (example, Kermit-32 cannot send out) 6 W( a file that you are unauthorized to read. And, it cannot receive a file unless you)7 W 6120 47354 MT (are authorized to write to that filename and its \050sub\051directory. If you use Kermit-32 to attempt to SEND) 101 W( \050SEND)100 W 6120 48550 MT (filespec\051 a protected file, you should see a "%KERMIT32 ....., insufficient) 68 W( privilege or file protection violation for)69 W 6120 49746 MT ('filespec'" error message, and no transfer will take place.) 25 W( If) 298 W( you have Kermit-32 in server mode, and you are trying)24 W 6120 50942 MT (to GET a protected file from it, or you are trying to) 3 W( SEND it a file whose space is protected, you should see a similar)4 W 6120 52138 MT (Kermit-32 generated REMOTE MESSAGE appear in the transmission status display, and then, on GET,) 250 W( the)249 W 6120 53334 MT (Kermit-65 message "CANNOT RECEIVE FILE-HEAD". Transfer of the protected file will not take place.)SH 6120 55726 MT (\0501d\051 problems are most) 98 W( likely to occur because of Apple II diskette or drive problems. The following conditions)99 W 6120 56922 MT (will generate "DISK I/O" or "I/O ERROR") 36 W( messages when Kermit-65 transfer commands are entered: bad diskette)35 W 6120 58118 MT (in default drive, no diskette in default drive, default drive door open, and/or unINITialized disk in default drive.)SH 6120 60510 MT (If any of those errors are detected before the attempted transmission) 46 W( of a given file, the transfer of that file will not)47 W 6120 61706 MT (begin. If any are detected DURING a file transmission, the file transfer will likely abort; at best transmitted data) 6 W( will)5 W 6120 62902 MT (be incomplete. Data which does reach the destination end of an) 44 W( aborted transfer should be considered very suspect;)45 W 6120 64098 MT (the disk problem should be corrected) 42 W( and the transfer should be repeated! \050The best chance you have for salvaging)41 W 6120 65294 MT (text file data in an abort is if the file destination is the host machine and you have) 19 W( told its Kermit to save incomplete)20 W 6120 66490 MT (files, e.g., on the VAX-8800, you need to SET INCOMPLETE KEEP\051.)SH 6120 68882 MT (One other Apple II disk problem) 61 W( can be encountered while you are using Kermit-65 to receive files. If you exceed)60 W 6120 70078 MT (the storage capacity of your) 50 W( diskette during a RECEIVE or a GET, you should see a "DISK FULL" error message.)51 W 6120 71274 MT (Data that has been received up to the point of the overflow) 40 W( will be automatically DELETEd. Make CERTAIN that)39 W ES %%Page: 313 314 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (14.7. Problems)SH 10 /Times-Italic AF 51275 XM (Page 313)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (you do not try to) 19 W( receive any more files until you have DELETEd some files from the problem diskette, or until you)20 W 8280 9082 MT (have replaced it with one that has adequate capacity to receive the complete file. NOTE: See Section 1.5.4.)SH 8280 11474 MT (It is less likely that \0501d\051 problems would occur because of host machine disk problems. The most) 287 W( likely)286 W 8280 12670 MT (circumstance you) 64 W( might encounter on the VAX/VMS 8800, for example, would be in receiving a large file and, in)65 W 8280 13866 MT (the process, exceeding your VAX disk quota. In such a case, you should) 87 W( see an appropriate Kermit-32 generated)86 W 8280 15062 MT (REMOTE MESSAGE appear within the) 88 W( Kermit-65 transmission status display. If this happens, delete some files)89 W 8280 16258 MT (from your) 11 W( VAX \050sub\051directories, and/or have your VAX disk quota increased BEFORE you try the transfer again. If)10 W 8280 17454 MT (you have issued a SET INCOMPLETE KEEP command to Kermit-32, there may be some chance) 44 W( of salvaging text)45 W 8280 18650 MT (file data that arrived before the disk quota overage, but the best thing you can do is to repeat the transfer!)SH 8280 21042 MT (As a general rule, if some disk or file error prevents a transfer from beginning, to get it to "go," you will need to)89 W 8280 22238 MT (correct the error and repeat all the steps that preceded it.)SH 8280 24630 MT (If you are still commanding the host Kermit, and you see) 63 W( an error message, you will have to get the host Kermit's)64 W 8280 25826 MT (prompt back and give it an) 61 W( acceptable command. If you have commanded the host Kermit to SEND or RECEIVE,)60 W 8280 27022 MT (and are back commanding Kermit-65 when you notice the error, you will have) 62 W( to correct the problem, CONNECT)63 W 8280 28218 MT (back to the host, get the host Kermit prompt) 130 W( \050with the VAX/VMS 8800, try typing RETURN or CTRL-Y\051, and)129 W 8280 29414 MT (repeat the SEND or RECEIVE command, before returning back to Kermit-65 to command it again.)SH 8280 31806 MT (If you have placed the host Kermit in) 39 W( server mode, and are giving Kermit-65 commands when you notice an Apple)40 W 8280 33002 MT (disk/file error prevents a) 23 W( file transfer from starting, chances are good that you won't have to CONNECT back to the)22 W 8280 34198 MT (host. It) 278 W( is also important to note that within a single) 14 W( server session, when you are transferring multiple files, all files)15 W 8280 35394 MT (transferred PRECEDING an error \050or) 101 W( abort\051 are probably good. To repeat the transfer, correct the error, and give)100 W 8280 36590 MT (Kermit-65 the appropriate command to transfer the file that messed up.) 26 W( The first time you do it, you may get back a)27 W 8280 37786 MT (message like "REMOTE MESSAGE %KERMIT-32..... protocol error") 19 W( This is just the host server trying to get back)18 W 8280 38982 MT ("on track" after the error. When the Kermit-65> prompt returns, enter the transfer command again, and it) 155 W( will)156 W 8280 40178 MT (probably be accepted.)SH 8280 42570 MT (If the second attempt should fail, wait for the Kermit-65>) 82 W( prompt, enter: FINISH, wait for the prompt again, and)81 W 8280 43766 MT (enter: CONNECT. If you do not see the host operating) 18 W( system prompt \050$ on the VAX 8800\051, type a few RETURNs)19 W 8280 44962 MT (\050or on the VAX/VMS a CTRL-Y\051. Re-invoke the host Kermit and put it back in server mode.)SH 8280 47354 MT (If disk or file errors prevent a transfer) 19 W( from completing, recovery will depend on the error, whether you had the host)18 W 8280 48550 MT (Kermit in server mode or not, and on your desire for accuracy.)SH 8280 50942 MT (Some disk/file error aborts are "fatal" \050e.g., Apple DISK FULL, and) 200 W( uploading to the VAX 8800 w/o having)201 W 8280 52138 MT (commanded Kermit-32 to SET INCOMPLETE KEEP\051. The destination file will) 56 W( be destroyed. The transfer of the)55 W 8280 53334 MT (file will have) 27 W( to be repeated again from the beginning. Again, unless you have set the host Kermit for server mode,)28 W 8280 54530 MT (you will have to CONNECT back, get the host Kermit prompt, and re-command it. If you were) 32 W( in a server session,)31 W 8280 55726 MT (though, you can probably) 129 W( repeat the transfer of the interrupted file without going back to the host \050see recovery)130 W 8280 56922 MT (procedures above\051.)SH 8280 59314 MT (Other disk/file errors that interrupt/abort a transfer may leave salvageable text data at the) 61 W( transfer destination. The)60 W 8280 60510 MT (best policy, though, is to repeat the transfer of the incomplete file \050see recovery procedures above\051.)SH 8280 62902 MT (Common problems in category \0502\051 include the following:)SH 8280 65294 MT (\050a\051 bad parity)SH 8280 67686 MT (\050b\051 noisy communications line)SH 8280 70078 MT (\050c\051 timeout due to delays, "disaster," etc.)SH ES %%Page: 314 315 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 314)SH 12 /Times-Bold AF 30817 XM (Kermit User Guide: Apple II Kermit \05014.7\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (\050d\051 Kermit-program incompatibility)SH 6120 10278 MT (\050e\051 user error)SH 6120 12670 MT (\0502a\051)SH 6120 15062 MT (Parity settings are very critical to correct transfers. If you do not inform Kermit-65 of the correct parity) 39 W( being used)40 W 6120 16258 MT (by the remote host machine or the) 5 W( communications path to it, "checksum" error checking calculations will be wrong,)4 W 6120 17454 MT (and packets will be consistently rejected when they arrive at their destination. In) 23 W( particular, most binary file Kermit)24 W 6120 18650 MT (transfers won't get very far if parity is not set correctly.)SH 6120 21042 MT ([NOTE: If you want) 1 W( to do a binary file transfer \050Apple binary or BASIC files\051 via a FIRN Network connection to the)SH 6120 22238 MT (SERDAC VAX/VMS 8800, you must SET) 124 W( PARITY SPACE before the transfer is initiated; that will insure that)125 W 6120 23434 MT (eight-bit quoting is used. If you dial directly into the VAX/VMS 8800, SET PARITY NONE;) 124 W( eight-bit quoting)123 W 6120 24630 MT (\050which is less efficient\051 is not required].)SH 6120 27022 MT (\0502b\051)SH 6120 29414 MT (Line noise can be the) 168 W( root cause for a variety of file transfer problems. The beauty of a "packetized protocol)169 W 6120 30610 MT (transfer" scheme like Kermit is that ordinarily, the scheme will overcome an occasional burst of line noise. A)158 W 6120 31806 MT (packet which arrives out of sequence, or which does not have the same checksum "bit count" as when it) 69 W( was sent,)70 W 6120 33002 MT (will get retransmitted, and the noise induced data error will correct itself.)SH 6120 35394 MT (Sometimes, however,) 66 W( bad line noise can outwit even the cleverest aspects of Kermit. There are some times where)65 W 6120 36590 MT (severe noise can corrupt the "checksum" error checking and lead to undetected transmission of a bad character)163 W 6120 37786 MT (\050assuming that the severe line noise exists, chances of this happening for one character are, for) 141 W( Kermit-65 error)140 W 6120 38982 MT (checking, less than two percent\051.)SH 6120 41374 MT (If line noise is bad) 39 W( enough and persistent enough, it is also a cause for several problems that will eventually "hang")40 W 6120 42570 MT (or totally confuse and abort a transfer:)SH 6120 44962 MT (Each transfer is preceded by the Kermit-to-Kermit exchange of several) 69 W( short "initialization packets. These tell the)68 W 6120 46158 MT (controlling programs critical things to expect about the upcoming transfer. If) 90 W( line noise prevents the packets from)91 W 6120 47354 MT (arriving, or scrambles them up, the transfer probably can't get started correctly.)SH 6120 49746 MT (One of the biggest vulnerabilities of the Kermit scheme is) 66 W( that each arriving packet must be acknowledged \050ACK\051)65 W 6120 50942 MT (by the receiver, and that the) 3 W( sender must actually receive back the acknowledgement \050likewise, if an expected packet)4 W 6120 52138 MT (does not) 83 W( arrive, there often must be a negative acknowledgement \050NAK\051\051. Since the ACK/NAK packets are very)82 W 6120 53334 MT (short, they are rather vulnerable to severe noise. If too many of them are scrambled or lost, the transfer) 38 W( can get out)39 W 6120 54530 MT (of synch, and the transferring programs can lose track of where they are.)SH 6120 56922 MT (One other place) 95 W( Kermit is vulnerable is in the beginning of a data packet. The first several bytes of these longer)94 W 6120 58118 MT (packets are reserved for control information: packet type, byte count, sequence number, etc. If line noise repeatedly)20 W 6120 59314 MT (coincides with the transmission of this control information, it) 244 W( is very easy for the transfer to get confused--)243 W 6120 60510 MT (particularly if the packet numbering gets garbled.)SH 6120 62902 MT (If you detect frequent line noise after you've) 42 W( connected to a host, but before you begin transfers \050you will probably)43 W 6120 64098 MT (see extraneous) 120 W( junk characters appearing on your screen\051, you're probably in for trouble. Once transfers actually)119 W 6120 65294 MT (begin, line noise problems) 242 W( are often characterized by incrementing of the RETRY counter on the Kermit-65)243 W 6120 66490 MT (transmission status display, and/or by long pauses in incrementing of the status display byte counter.)SH 6120 68882 MT (To minimize line) 179 W( noise, first see if there are any obvious loose connections in your equipment \050telephone line)178 W 6120 70078 MT (connection to wall box, telephone line) 1 W( to modem, modem cabling to serial connector, or, if appropriate, cabling from)2 W 6120 71274 MT (hardwire port to serial connector\051. If not,) 55 W( you may want to hang up and redial to get another telephone connection)54 W ES %%Page: 315 316 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (14.7. Problems)SH 10 /Times-Italic AF 51275 XM (Page 315)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (\050almost every connection is unique, and you may get a better one than) 101 W( you had\051. Many line noise problems will)102 W 8280 9082 MT (clear up with those simple remedies, but some may be beyond your control!)SH 8280 11474 MT (If all else fails, you) 169 W( may also try shortening the maximum length of your data packets \050SET SEND/RECEIVE)168 W 8280 12670 MT (PACKET-LENGTH\051 to possibly lessen the effects of persistent noise.)SH 8280 15062 MT (\0502c\051)SH 8280 17454 MT (A Kermit transfer consists of a regular and predictable exchange of initialization, data, and, ACK/NAK packets.) 46 W( If)343 W 8280 18650 MT (something \050line noise, busy computer, user error, etc.\051) 107 W( interrupts or delays this regular exchange, there must be a)106 W 8280 19846 MT (way for a Kermit program on at least one end to figure out something is wrong and try to get the packet exchange)62 W 8280 21042 MT (back on track again.)SH 8280 23434 MT (This is usually done with a timer and retry mechanism. If a Kermit does not) 48 W( receive an expected packet, within its)47 W 8280 24630 MT (timer's time limit \050a timeout\051, it will) 49 W( resend its last sent packet to try to "wake up" the other Kermit \050effectively by)50 W 8280 25826 MT (asking it to send its last packet again\051. This resending is repeated \050"retried"\051 a) 43 W( number of times before the program)42 W 8280 27022 MT (assumes it cannot get things on track again. Each packet resent by Kermit-65) 183 W( is counted as a RETRY on its)184 W 8280 28218 MT (transmission status display. If Kermit-65's retry count exceeds 20, it will try to issue) 42 W( an error message according to)41 W 8280 29414 MT (what kind of packet it was waiting for and/or it will say MAX RETRY) 7 W( COUNT EXCEEDED. The transfer will then)8 W 8280 30610 MT (be aborted.)SH 8280 33002 MT (Very frequently, timeouts are caused by unexpected delays in the) 102 W( remote computer, or in the network thru which)101 W 8280 34198 MT (you connect to it. If you know that the host machine or network is very busy, and you) 119 W( repeatedly have aborted)120 W 8280 35394 MT (transfers due to timeouts, you may be able to alleviate the problem by increasing the) 34 W( value of the default Kermit-65)33 W 8280 36590 MT (receive timeout parameter \050SET RECEIVE TIMEOUT\051.)SH 8280 38982 MT (Other common ways that Kermit-65) 187 W( can timeout and abort are: \0501\051 if the host machine "goes down" during a)188 W 8280 40178 MT (transfer, \0502\051 if the telephone, network,) 135 W( or hardwire connection is completely broken during a transfer, \0503\051 if you)134 W 8280 41374 MT (forgot to "start up" the host Kermit and give it a) 141 W( transfer command \050SEND, RECEIVE, or SERVER\051 BEFORE)142 W 8280 42570 MT (giving Kermit-65 a transfer command, and \0504\051 if \0502a\051, \0502b\051, \0502d\051, or \0502e\051 problems) 92 W( occur and critical initialization)91 W 8280 43766 MT (packets are never received.)SH 8280 46158 MT (In cases \0501\051 and \0502\051, you will eventually probably see a) 119 W( CANNOT RECEIVE DATA or MAX RETRY COUNT)120 W 8280 47354 MT (EXCEEDED message from Kermit-65. Cases \0503\051 and \0504\051 may result in a CANNOT RECEIVE INIT message.)SH 8280 49746 MT (\0502d\051)SH 8280 52138 MT (To do effective Kermit transfers, there must be two Kermit programs working--) 86 W( one on either end of a "computer)85 W 8280 53334 MT (connection." In) 612 W( addition, the two Kermits must be able to "talk to" each other) 181 W( in a prescribed, standard way.)182 W 8280 54530 MT (Although there are specific standards for writing all Kermit programs, most) 12 W( of them have been written by volunteers)11 W 8280 55726 MT (and are in the) 7 W( "public domain." The protocol requirements and resultant programs are generally rather complex, and)8 W 8280 56922 MT (it is all too easy to inadvertently) 51 W( program in a subtle error in a given Kermit version. Additionally, there are many)50 W 8280 58118 MT ("levels of ability" of Kermit programs: some can operate in server mode, some cannot. Some can transfer) 109 W( binary)110 W 8280 59314 MT (files; some cannot,) 140 W( etc. Unless the Kermit programs you are using are both error free, and both have the same)139 W 8280 60510 MT (capabilities for the transfers you wish to perform, you are in trouble!)SH 8280 62902 MT (If there is a systematic "bug" in one of the Kermit programs, or if you are asking one Kermit to do something) 74 W( the)75 W 8280 64098 MT (other can't do, there will) 58 W( usually be a problem with packet exchange; in many cases the requested transfer will not)57 W 8280 65294 MT (even get started.) 65 W( You) 382 W( may see a Kermit-65 error message, on the transmission status display, saying that a packet)66 W 8280 66490 MT (was not received, or a REMOTE MESSAGE saying a packet) 53 W( was unexpectedly received, or one that the command)52 W 8280 67686 MT (cannot be executed by the other Kermit. In some cases,) 140 W( you may see no explanatory error messages at all; the)141 W 8280 68882 MT (transfer will just "hang" and will probably eventually "timeout" and abort \050MAX RETRY COUNT EXCEEDED\051.)SH 8280 71274 MT (\0502e\051)SH ES %%Page: 316 317 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 316)SH 12 /Times-Bold AF 30817 XM (Kermit User Guide: Apple II Kermit \05014.7\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (If you've read about category \0501\051 errors) 24 W( above, you can see that there are a variety of things you can do to with files)23 W 6120 9082 MT (or disks to mess up) 152 W( a Kermit transfer. You can also wreak havoc by issuing improper or illegal commands to)153 W 6120 10278 MT (Kermit programs. Before trying to transfer) 11 W( a lot of files, or trying out a new type of transfer, be sure you understand)10 W 6120 11474 MT (the procedure you need to follow and the various Kermit commands that will be involved.)SH 6120 13866 MT (New Kermit users often try to command their local Kermit program \050e.g., Kermit-65\051 to send or receive a file,)153 W 6120 15062 MT (without having first invoked and commanded the host Kermit.)SH 6120 17454 MT (Another common error is to issue improper commands to a remote server.) 259 W( For) 767 W( example, when VAX/VMS)258 W 6120 18650 MT (Kermit-32 is in server mode, and) 183 W( you are requesting files from it via Kermit-65 commands, you cannot use a)184 W 6120 19846 MT (RECEIVE command; you must instead use GET.)SH 6120 22238 MT (As with Kermit program incompatibilities,) 203 W( illegal or inappropriate commands will often cause a problem with)202 W 6120 23434 MT (packet exchange; in many cases the requested transfer or action will) 22 W( not even get started. You may see a Kermit-65)23 W 6120 24630 MT (error message, on the transmission) 58 W( status display, saying a packet was not received, a REMOTE MESSAGE that a)57 W 6120 25826 MT (packet was unexpectedly received, or one that the) 7 W( command cannot be executed by the other Kermit. In some cases,)8 W 6120 27022 MT (you may see no explanatory error messages at all; the transfer) 227 W( will just "hang" and will probably eventually)226 W 6120 28218 MT ("timeout" and abort \050MAX RETRY COUNT EXCEEDED\051.)SH 6120 30610 MT (Except for the) 52 W( fact that you will probably never note a category \0502\051 "packet exchange" error while you are "talking)53 W 6120 31806 MT (to" the remote system or commanding its Kermit, and that the remedies you must employ to correct the) 59 W( errors will)58 W 6120 33002 MT (be different, recovery procedures to get your) 43 W( file transferred correctly will be much the same as those we described)44 W 6120 34198 MT (at the end of the) 99 W( discussion on category \0501\051 "disk/file" errors. Make sure to read that discussion for more details)98 W 6120 35394 MT (than we have included below.)SH 6120 37786 MT (In short, if an error prevents a given transfer from actually beginning, you will need to correct the error and) 60 W( repeat)61 W 6120 38982 MT (all the steps that preceded it. This will be more difficult if you are transferring only one file-- having commanded)64 W 6120 40178 MT (the remote Kermit to SEND or RECEIVE.) 137 W( If) 526 W( you have placed the remote Kermit in server mode, and an error)138 W 6120 41374 MT (prevents the transfer) 72 W( of one file, all files transferred up to that point are probably OK, and you can usually correct)71 W 6120 42570 MT (the problem, and get a transfer started again without having to reCONNECT back to the host.)SH 6120 44962 MT (If you are transferring a text file, and an abort occurs in mid-transfer,) 228 W( some data may be salvageable in the)229 W 6120 46158 MT (destination file, but) 17 W( the best rule with any type of file is to repeat the transfer, in which case the recovery procedures)16 W 6120 47354 MT (in the last paragraph apply.)SH 14 /Times-Bold AF 6120 50956 MT (14.8. Customizing Kermit-65)SH 10 /Times-Roman AF 6120 53074 MT (The source code to) 91 W( Kermit-65 is in 6502 Assembler. It has been formatted for a cross assembler which runs on a)92 W 6120 54270 MT (unix 2's complement machine. Files)43 W /Courier SF 21405 XM (appxas.1)SH /Times-Roman SF 26497 XM (thru)SH /Courier SF 28400 XM (appxas.3)SH /Times-Roman SF 33492 XM (are the cross assembler for UNIX. Get the files)42 W 6120 55466 MT (on a UNIX system and then look at the documentation at the start. They) 79 W( will easily make you a xasm for Kermit.)80 W 6120 56662 MT (The file)SH /Courier SF 9508 XM (appmak.unx)SH /Times-Roman SF 15758 XM (is the makefile to use with the xasm to reassemble all of Kermit's parts.)SH 6120 59054 MT (Kermit-65 3.xx has been separated into two assemblies, the main routines) 33 W( and the com card routines for the devices)32 W 6120 60250 MT (shown in Table 14-1. A vector has been set) 31 W( up in low memory for the two assemblies to communicate. Look at the)32 W 6120 61446 MT (working com drivers for tips on how to incorporate your version of the com driver. some things to note: It) 175 W( is)174 W 6120 62642 MT (probably best to buffer the input from the remote and to get input characters) 36 W( from the remote every chance you get.)37 W 6120 63838 MT (Note the Microtek SV-622) 35 W( driver, whenever the input is checked for a character and has a character the character is)34 W 6120 65034 MT (put into the buffer immeadiatly.) 104 W( Also) 460 W( when the output is checked for ready to output, if the card is not ready to)105 W 6120 66230 MT (output then it is checked for a character to input. All this should help prevent losing characters.)SH 6120 68622 MT (Communications card vector area:)SH /Courier SF 6120 70277 MT (address size module) SH( function)1200 W 4200 50 6120 70477 UL 2400 50 10920 70477 UL 3600 50 14520 70477 UL 4800 50 19920 70477 UL 6120 71308 MT (1003 byte) 1800 W( main) 1200 W( This) 2400 W( is the baud rate index as follows:)SH ES %%Page: 317 318 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (14.8. Customizing Kermit-65)SH 10 /Times-Italic AF 51275 XM (Page 317)SH 46800 50 8280 5709 UL /Courier SF 23280 7824 MT (3 - 110)SH 23280 8855 MT (4 - 135.4)SH 23280 9886 MT (5 - 150)SH 23280 10917 MT (6 - 300)SH 23280 11948 MT (7 - 600)SH 23280 12979 MT (8 - 1200)SH 23280 14010 MT (9 - 1800)SH 22680 15041 MT (10 - 2400)SH 22680 16072 MT (11 - 3600)SH 22680 17103 MT (12 - 4800)SH 22680 18134 MT (13 - 7200)SH 22680 19165 MT (14 - 9600)SH 22680 20196 MT (15 - 19200)SH 22680 21227 MT (for example:)SH 22680 22258 MT (if index is 6 then line should be 300 baud)SH 8280 23289 MT (1004 byte) 1800 W( unused)6600 W 8280 24320 MT (1005 word) 1800 W( driver Address) 1200 W( of a null terminated string.)SH 22680 25351 MT (address should point to a capitalized)SH 22680 26382 MT (string of the drivers id)SH 8280 27413 MT (1007 byte) 1800 W( main) 1200 W( Com) 2400 W( slot in the form $n0 where n is slot #.)SH 8280 28444 MT (1008 byte) 1800 W( main) 1200 W( Force) 2400 W( initialization flag when 0.)SH 22680 29475 MT (init routine should always initialize when)SH 22680 30506 MT (this flag is 0 & then set flag non-zero.)SH 8280 31537 MT (1009 word) 1800 W( main) 1200 W( Address) 2400 W( of the end of Kermit main routine.)SH 8280 32568 MT (100b byte) 1800 W( main) 1200 W( Flow) 2400 W( control is on when high bit is set.)SH 8280 33599 MT (100c word) 1800 W( driver Address) 1200 W( of the end of the com driver.)SH 8280 34630 MT (1020 3) 600 W( bytes driver) SH( Jump) 1200 W( to initialization routine.)SH 8280 35661 MT (1023 3) 600 W( bytes driver) SH( Jump) 1200 W( to command routine. A reg has command)SH 23880 36692 MT (0 - hang up the line)SH 22680 37723 MT ($0b - set baud rate)SH 22680 38754 MT ($0c - set break on the line)SH 22680 39785 MT ($91 - do xon on the line)SH 22680 40816 MT ($93 - do xoff on the line)SH 22680 41847 MT (routine returns false \050P reg zero flag\051)SH 22680 42878 MT (if unable to do command.)SH 8280 43909 MT (1026 3) 600 W( bytes driver) SH( Jump) 1200 W( to check for input from the line.)SH 22680 44940 MT (routine returns false \050P reg zero flag\051)SH 22680 45971 MT (if no character on line)SH 8280 47002 MT (1029 3) 600 W( bytes driver) SH( Jump) 1200 W( to get input character from line.)SH 22680 48033 MT (routine returns character in A reg)SH 8280 49064 MT (102c 3) 600 W( bytes driver) SH( Jump) 1200 W( to put character in A reg on line.)SH 8280 50095 MT (102f 3) 600 W( bytes driver) SH( Jump) 1200 W( to reset com driver.)SH 8280 51126 MT (1040 3) 600 W( bytes main) SH( Jump) 2400 W( to Apple ROM wait rtn. microsecs delay)SH 22680 52157 MT (=1/2\05026+27A+5A*A\051 where A is the accumulator)SH 8280 53188 MT (1043 3) 600 W( bytes main) SH( Jump) 2400 W( to routine to print null-terminated string.)SH 22680 54219 MT (X reg contains least significant byte of address)SH 22680 55250 MT (Y reg contains most significant byte of address)SH 22680 56281 MT (routine does not issue a carriage return.)SH 8280 57312 MT (1046 3) 600 W( bytes main) SH( Jump) 2400 W( to routine to read the keyboard.)SH 22680 58343 MT (A reg contains the character read)SH 8280 59374 MT (1049 3) 600 W( bytes main) SH( Jump) 2400 W( to routine to print carrage rtn & line feed.)SH 8280 60405 MT (104f 3) 600 W( bytes main) SH( Jump) 2400 W( to routine to set characters parity.)SH 22680 61436 MT (A reg contains the character before and after.)SH /Times-Roman SF 8280 63828 MT (All the routines) 108 W( should return with the "rts" instruction. Routines which can return a true/false indication should)107 W 8280 65024 MT (return with the P reg zero flag set appropiately. That) 18 W( is: a "beq" instruction will branch on a false indication and the)19 W 8280 66220 MT ("bne" will branch on a true indication. The com driver should start its routines above the main routines and) 112 W( tell)111 W 8280 67416 MT (where the end of the) 113 W( com driver is via location $100c. If your com driver gets too large then the bsave address)114 W 8280 68612 MT (would have to be changed when you are saving the binary to diskette.)SH ES %%Page: 318 319 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 318)SH 12 /Times-Bold AF 31717 XM (Kermit User Guide: Apple II Kermit \05015\051)SH 46800 50 6120 5709 UL ES %%Page: 319 320 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (15. CP/M-80 KERMIT)SH 10 /Times-Italic AF 51275 XM (Page 319)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 8280 8272 MT (15. CP/M-80 KERMIT)SH 10 /Times-Italic AF 8280 10566 MT (Program:)SH /Times-Roman SF 14280 XM (Bill Catchings, Columbia University,) 18 W( with contributions from Charles Carvalho \050ACC\051, Bernie Eiben)17 W 14280 11671 MT (\050DEC\051, Nick) 34 W( Bush \050Stevens\051, John Bray \050University of Tennessee\051, Bruce Tanner \050Cerritos College\051,)35 W 14280 12776 MT (Greg Small \050University of California) 291 W( at Berkeley\051, Kimmo Laaksonen \050Helskini University of)290 W 14280 13881 MT (Technology\051, Brian Robertson) 16 W( \050Aberdeen University\051, A.J. Cole \050Leeds University\051, John Shearwood)17 W 14280 14986 MT (\050Birmingham University\051, Tony) 248 W( Addyman \050Salford University\051, Godfrey Nix and Martin Carter)247 W 14280 16091 MT (\050Nottingham University\051, Ian Young \050Edinburgh University\051, Chris Miles \050Manchester) 114 W( University\051,)115 W 14280 17196 MT (Richard Russell, Dave Roberts, and many, many others.)SH /Times-Italic SF 8280 19406 MT (Language:)SH /Times-Roman SF 14280 XM (8080 Assembler, M80, or MAC80)SH /Times-Italic SF 8280 21616 MT (Version:)SH /Courier SF 14280 XM (4.09)SH /Times-Italic SF 8280 23826 MT (Date:)SH /Times-Roman SF 14280 XM (11th January, 1988)SH /Times-Italic SF 8280 26036 MT (Documentation:)SH /Times-Roman SF 14280 27141 MT (Bertil Schou, Loughborough University \050with lots) 388 W( of help from Jon Warbrick of Plymouth)389 W 14280 28246 MT (Polytechnic\051; Christine Gianone and Frank da Cruz, Columbia) 91 W( University; Charles Carvalho, ACC;)90 W 14280 29351 MT (many others.)SH /Times-Italic SF 8280 31743 MT (KERMIT-80 Capabilities At A Glance:)SH /Times-Roman SF 9280 33353 MT (Local operation:)SH 34480 XM (Yes)SH 9280 34458 MT (Remote operation:)SH 34480 XM (Partial, Auto-receive only)SH 9280 35563 MT (Login scipts:)SH 34480 XM (No)SH 9280 36668 MT (Transfer text files:)SH 34480 XM (Yes)SH 9280 37773 MT (Transfer binary files:)SH 34480 XM (Yes)SH 9280 38878 MT (Wildcard send:)SH 34480 XM (Yes)SH 9280 39983 MT (File transfer interruption:)SH 34480 XM (Yes)SH 9280 41088 MT (Filename collision avoidance:)SH 34480 XM (Yes, poor)SH 9280 42193 MT (Can time out:)SH 34480 XM (Yes)SH 9280 43298 MT (8th-bit prefixing:)SH 34480 XM (Yes)SH 9280 44403 MT (Repeat count prefixing:)SH 34480 XM (No)SH 9280 45508 MT (Alternate block checks:)SH 34480 XM (Yes)SH 9280 46613 MT (Terminal emulation:)SH 34480 XM (Yes, VT52 and others)SH 9280 47718 MT (Communication settings:)SH 34480 XM (Yes; duplex, parity)SH 9280 48823 MT (Support for dial-out modems:)SH 34480 XM (No)SH 9280 49928 MT (Transmit BREAK:)SH 34480 XM (Yes; most versions)SH 9280 51033 MT (IBM communication:)SH 34480 XM (Yes)SH 9280 52138 MT (Transaction logging:)SH 34480 XM (No)SH 9280 53243 MT (Debug logging:)SH 34480 XM (No)SH 9280 54348 MT (Session logging:)SH 34480 XM (Yes)SH 9280 55453 MT (Raw file transmit:)SH 34480 XM (Yes)SH 9280 56558 MT (Act as server:)SH 34480 XM (No)SH 9280 57663 MT (Talk to server:)SH 34480 XM (Yes; SEND, GET, FIN, BYE)SH 9280 58768 MT (Advanced commands for servers:)SH 34480 XM (No)SH 9280 59873 MT (Command/init files:)SH 34480 XM (Yes)SH 9280 60978 MT (Command macros:)SH 34480 XM (No)SH 9280 62083 MT (Local file management:)SH 34480 XM (Yes; DIR, ERA, TYPE, PRINT, COPY)SH 9280 63188 MT (Handle file attributes:)SH 34480 XM (No)SH 9280 64293 MT (Extended packets:)SH 34480 XM (No)SH 9280 65398 MT (Sliding Windows:)SH 34480 XM (No)SH 9280 66503 MT (Printer control:)SH 34480 XM (Yes, better, but not perfect)SH ES %%Page: 320 321 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 320)SH 12 /Times-Bold AF 29186 XM (Kermit User Guide: CP/M-80 KERMIT \05015.1\051)SH 46800 50 6120 5709 UL 14 SS 6120 8138 MT (15.1. Summary of CP/M)SH 10 /Times-Roman AF 6120 10256 MT (There are essentially two versions of CP/M - Versions 2.2 and 3.0 \050sometimes also called CP/M PLUS.\051)SH 6120 12648 MT (CP/M-80 Version 2)95 W /Courier SF (.)SH /Times-Roman SF (2 is run in) 95 W( a single 64 Kbyte "page", usually the largest amount of memory on Z80 or 8080)96 W 6120 13844 MT (systems. The) 682 W( BIOS \050Basic input/output system\051, BDOS \050Basic Disk Operating System\051 and) 216 W( CCP \050Command)215 W 6120 15040 MT (console processor\051 all share memory with) 58 W( any transient program the user may wish to run. Some basic commands)59 W 6120 16236 MT (are available through the) 38 W( CCP, like DIR, ERA etc,while others are loaded from disk into the transient program area)37 W 6120 17432 MT (and run as a program, like PIP or STAT.)SH 6120 19824 MT (CP/M Version 3)33 W /Courier SF (.)SH /Times-Roman SF (0 \050or CP/M PLUS\051 effectively removes the requirement of having the CCP and) 33 W( BDOS along with)34 W 6120 21020 MT (a chunk of the) 54 W( BIOS code being resident in the single 64k byte page of memory. This allows even more space for)53 W 6120 22216 MT (programs in the) 20 W( TPA, but still a little less than the maximum of 64k. It is substantially different from CP/M version)21 W 6120 23412 MT (2)SH /Courier SF (.)SH /Times-Roman SF (2, with lots of added features. Kermit-80) 239 W( uses very few additional version 3)238 W /Courier SF (.)SH /Times-Roman SF (0 features, and only where)238 W 6120 24608 MT (absolutely necessary.)SH 6120 27000 MT (CP/M file specifications are of the form)SH /Courier SF 22312 XM (DEV:XXXXXXXX.YYY)SH /Times-Roman SF (, where)SH /Courier SF 6120 28791 MT (DEV:)SH /Times-Roman SF 14120 XM (is a)125 W /Times-Italic SF 15981 XM (device name)125 W /Times-Roman SF (, normally the A:) 125 W( or) SH( B:) 125 W( floppy.) SH( If) 500 W( omitted, the device name defaults to your)125 W 14120 29896 MT (connected diskette.)SH /Courier SF 6120 31473 MT (XXXXXXXX)SH /Times-Roman SF 14120 XM (is a)SH /Times-Italic SF 15731 XM (filename)SH /Times-Roman SF 19425 XM (of up to 8 characters.)SH /Courier SF 6120 33050 MT (YYY)SH /Times-Roman SF 14120 XM (is the)SH /Times-Italic SF 16509 XM (file type)SH /Times-Roman SF (, up to 3 characters.)SH 6120 34841 MT (File names and file types may contain letters, digits, and some special characters, including dash, dollar) 90 W( sign, and)89 W 6120 36037 MT (underscore, but no imbedded spaces. Upper and lower case letters are equivalent.)SH 6120 38429 MT ("Wildcard" file-group specifications are) 30 W( permitted in file names and file types \050but not device names\051 within certain)31 W 6120 39625 MT (contexts; a ")134 W /Courier SF (*)SH /Times-Roman SF (" matches a whole field, a ")134 W /Courier SF (?)SH /Times-Roman SF (" matches) 518 W( a single character, including space.) 134 W( Examples:) 517 W( ")133 W /Courier SF (*.F??)SH /Times-Roman SF (")SH 6120 40821 MT (specifies all files whose)24 W /Times-Italic SF 15992 XM (types)SH /Times-Roman SF 18321 XM (start with F and are 1, 2, or 3 characters long; ")24 W /Courier SF (F?.*)SH /Times-Roman SF (" specifies all files whose names)25 W 6120 42017 MT (start with F and are no more than two characters long \050before the trailing spaces\051.)SH 6120 44409 MT (The five CP/M commands are:)SH 6120 46200 MT (DIR)SH /Times-Italic SF 8092 XM (file)SH /Times-Roman SF 14120 XM (Lists the the names of) 165 W( the specified files. The default file specification is "*.*". Example:)164 W 14120 47305 MT (")SH /Courier SF (DIR B:*.FOR)SH /Times-Roman SF (".)SH 6120 48882 MT (ERA)SH /Times-Italic SF 8370 XM (file)SH /Times-Roman SF 14120 XM (Erases \050deletes\051 the specified file\050s\051; wildcards allowed.)SH 6120 50459 MT (REN)SH /Times-Italic SF 8370 XM (new old)SH /Times-Roman SF 14120 XM (Changes the name of a file from)SH /Times-Italic SF 27256 XM (old)SH /Times-Roman SF 28784 XM (to)SH /Times-Italic SF 29812 XM (new)SH /Times-Roman SF (, e.g.)SH 14120 51564 MT (")SH /Courier SF (REN NEW.FOR=OLD.FOR)SH /Times-Roman SF (".)SH 6120 53141 MT (SAVE)SH 14120 XM (Saves the specified number of memory blocks into a file. \050Not on CP/M Plus systems\051)SH 6120 54718 MT (TYPE)SH /Times-Italic SF 8870 XM (file)SH /Times-Roman SF 14120 XM (Types the specified file on the screen, e.g. ")SH /Courier SF (TYPE FOO.TXT)SH /Times-Roman SF (".)SH 6120 56509 MT (The most important programs are:)SH 6120 58300 MT (STAT)SH 14120 XM (Gives statistics on disk usage; sets and displays IOBYTE. \050Not on CP/M Plus systems\051)SH 6120 59877 MT (PIP)SH 14120 XM (Peripheral Interchange) 51 W( Program. Copies files. In response to the ")52 W /Courier SF (*)SH /Times-Roman SF (" prompt, give a command)52 W 556 50 14120 60077 UL 333 50 18531 60077 UL 556 50 23553 60077 UL 14120 60982 MT (of the form)SH /Courier SF 16520 62637 MT (disk:outfile=disk:infile)SH /Times-Roman SF 14120 64354 MT (Wildcards \050")71 W /Courier SF (*)SH /Times-Roman SF (" for a whole field or ")71 W /Courier SF (?)SH /Times-Roman SF (" for) 392 W( a letter\051 can be used. Examples:) 71 W( ")70 W /Courier SF (A:=B:*.*)SH /Times-Roman SF (" to)70 W 14120 65459 MT (copy a whole disk, ")56 W /Courier SF (A:=B:*.FOR)SH /Times-Roman SF (" to copy all the Fortran programs) 56 W( from disk B to disk A. If)57 W 14120 66564 MT (the disk specification is omitted, your "connected" disk is assumed. Command line arguments)78 W 14120 67669 MT (are also accepted, e.g. ")SH /Courier SF (PIP A:=B:*.*)SH /Times-Roman SF (".)SH 6120 70061 MT (There are equivalent commands for CP/M Version 3.0, but are not loaded into memory in the same) 4 W( way as for CP/M)5 W 6120 71257 MT (Version 2.2. For further information on CP/M, consult your microcomputer manual or a CP/M handbook.)SH ES %%Page: 321 322 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (15.2. Kermit-80 Description)SH 10 /Times-Italic AF 51275 XM (Page 321)SH 46800 50 8280 5709 UL 14 /Times-Bold AF 8280 8138 MT (15.2. Kermit-80 Description)SH 10 /Times-Roman AF 8280 10256 MT (Since Kermit-80 runs on a standalone micro, it is always in control of the screen -- it is always)134 W /Times-Italic SF 48875 XM (local)SH /Times-Roman SF (. Thus,) 516 W( it)133 W 8280 11452 MT (always keeps the screen updated with the file name and the packet number, whether sending or receiving.)SH 8280 13844 MT (Kermit-80 is capable of an imprecise or "fuzzy" timeout on an input request, and can break deadlocks) 11 W( automatically.)12 W 8280 15040 MT (In most cases, this) 191 W( is not important, because the KERMIT on the other side is most likely able to handle the)190 W 8280 16236 MT (timeouts. The) 370 W( timeouts done by Kermit-80 are fuzzy because they depend on the speed of the) 60 W( processor and other)61 W 8280 17432 MT (factors that can vary from system to system.)SH 8280 19824 MT (If, despite the timeout capability, the transmission appears to) 27 W( be stuck \050and you can tell that this has happened if the)26 W 8280 21020 MT (screen fails to change for) 55 W( a while\051 you can type carriage return to have the micro do what it would have done on a)56 W 8280 22216 MT (timeout, namely) 76 W( NAK the expected packet to cause theforeign host to send it again \050or, if the micro is sending, to)75 W 8280 23412 MT (retransmit the last packet\051. Micro/micro or micro/IBM-mainframe) 206 W( transfers could require this kind of manual)207 W 8280 24608 MT (intervention.)SH 8280 27000 MT (File transfers may be interrupted in several ways.)SH 8280 28791 MT (Control-C)SH 16280 XM (This will return you) 47 W( to Kermit-80 command level immediately, so that you can connect back to)46 W 16280 29896 MT (the remote system, or take any other desired action.)SH 8280 31473 MT (Control-X)SH 16280 XM (When sending a file, this will terminate the sending of the current file) 181 W( with a signal to the)182 W 16280 32578 MT (KERMIT on the other side to discard what it got so far. If there are more files to be sent,)157 W 16280 33683 MT (KERMIT-80 will go on to the next one. When receiving a file, KERMIT-80) 52 W( will send a signal)53 W 16280 34788 MT (to the) 32 W( remote KERMIT to stop sending this file. If the remote KERMIT understands this signal)31 W 16280 35893 MT (\050not all implementations of KERMIT do\051, it will comply, otherwise the file will keep coming.)91 W 16280 36998 MT (In any case, the remote KERMIT will go on to the next file in the group, if any.)SH 8280 38575 MT (Control-Z)SH 16280 XM (Like Control-X, except if a file group is being transmitted, this will) 40 W( stop the transmission of the)39 W 16280 39680 MT (entire group. If only a single file is being transmitted, it works exactly like Control-X.)SH 8280 41257 MT (Carriage Return)SH 16280 XM (If you type a) 232 W( carriage return Kermit-80 will resend the current packet. You may do this)233 W 16280 42362 MT (repeatedly, up to the packet retry limit \050somewhere between 5 and 16 times\051) 143 W( for a particular)142 W 16280 43467 MT (packet.)SH 13 /Times-Bold AF 25451 46826 MT (Kermit-80 Commands)SH 10 /Times-Roman AF 8280 49199 MT (KERMIT-80 uses the DECSYSTEM-20 keyword style command language.) 79 W( Each) 410 W( keyword may be abbreviated to)80 W 8280 50395 MT (its minumum unique length. "?" may be typed to request a menu of the available options for the current field at any)21 W 8280 51591 MT (point in) 63 W( a command. ESC may be typed at any point in a command to fill out the current keyword or filename; if)64 W 8280 52787 MT (sufficient characters have not been typed to identify the current field uniquely,) 61 W( KERMIT-80 will sound a beep and)60 W 8280 53983 MT (allow you to continue from that point.)SH 8280 55774 MT (BREAK)SH 12280 XM (Send a Break condition to the remote computer. This is only possible if your system is capable of) 13 W( sending)14 W 12280 56879 MT (breaks. It) 478 W( is intended to be used with PAUSE, STRING etc and the TAKE command to do weird and)114 W 12280 57984 MT (wonderful things, like automatic logging on to a remote host.)SH 8280 59561 MT (BYE)SH 12280 XM (When talking to a remote Kermit Server, this command shuts down the server) 103 W( and logs it out, and also)104 W 12280 60666 MT (exits from Kermit-80 to CP/M command level.)SH 8280 62243 MT (CONNECT)SH 12280 63348 MT (Establish a "virtual terminal" connection to any host that) 56 W( may be connected to the serial port, i.e.) 57 W( pass) SH( all)57 W 12280 64453 MT (typein to the serial port and display all input from the serial port on the screen.) 121 W( Also,) 491 W( emulate a DEC)120 W 12280 65558 MT (VT52 to allow cursor control, screen clearing,) 83 W( etc., if VT52-EMULATION is ON \050see below\051, in which)84 W 12280 66663 MT (case you should also set your terminal type on) 90 W( the remote host to VT52. \050Some versions emulate other)89 W 12280 67768 MT (terminals.\051)SH 12280 69345 MT (Warning: VT52 emulation is only successful if your system or its attached terminal can do the same) 62 W( sort)63 W 12280 70450 MT (of functions as) 47 W( a genuine VT52. Things to beware of are cursor addressing, clear to end of page and end)46 W 12280 71555 MT (of line, clear screen, home) 192 W( cursor, and clear-and-home functions. The useability of VT52 emulation)193 W ES %%Page: 322 323 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 322)SH 12 /Times-Bold AF 29186 XM (Kermit User Guide: CP/M-80 KERMIT \05015.2\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 10120 7886 MT (depends entirely on how many of the VT52 functions can be emulated by your terminal.)SH 10120 9463 MT (The escape) 103 W( character differs from micro to micro; when you issue the CONNECT command, the micro)102 W 10120 10568 MT (will print) 40 W( a message telling you how to get back. The escape sequence is generally an uncommonly-used)41 W 10120 11673 MT (control character, like CTRL-backslash or CTRL-rightbracket, followed by a single letter "command":)SH 10120 13464 MT (C)SH 12120 XM (Close Connection, return to)SH /Courier SF 23425 XM (Kermit-80>)SH /Times-Roman SF 29675 XM (command level.)SH 10120 14569 MT (S)SH 12120 XM (Display Status of connection, but maintain remote connection.)SH /Courier SF 10120 15674 MT (?)SH /Times-Roman SF 12120 XM (List available single-character commands.)SH 10120 16779 MT (0)SH 12120 XM (\050zero\051 Send a null \0500\051 character.)SH 10120 17884 MT (B)SH 12120 XM (Send a BREAK signal. Most systems provide this function.)SH 10120 18989 MT (D)SH 12120 XM (Drop the line. Used on) 51 W( the Apple with modem. Automatically closes the connection after dropping)50 W 12120 20094 MT (the line. The TORCH system acknowledges this command but does nothing.)SH 10120 21199 MT (P)SH 12120 XM (Toggle printer on or off. Allows you to copy whatever goes to the screen to the printer.)SH 10120 22304 MT (S)SH 12120 XM (Temporarily suspend logging to the log file.)SH 10120 23409 MT (Q)SH 12120 XM (Restart logging to the log file)SH /Courier SF 10120 24514 MT (^])SH /Times-Roman SF 12120 XM (\050or whatever - a second copy of the escape character\051 Send the escape character itself) 69 W( to the remote)70 W 12120 25619 MT (host.)SH 6120 27410 MT (DIRECTORY)SH 10120 28515 MT (This provides a directory listing of the specified files. If no) 26 W( files are specified, all files on the default disk)27 W 10120 29620 MT (are listed. File sizes, in K, are) 2 W( included. You may interrupt the listing at any time by typing any character.)1 W 10120 30725 MT (The listing \050even if) 98 W( interrupted\051 concludes with a display of the amount of free storage left on the disk.)99 W 10120 31830 MT (You can inhibit the display of file sizes by SET DIRECTORY OFF.)SH 6120 33407 MT (ERASE)SH /Times-Italic SF 9537 XM (filespec)SH /Times-Roman SF 10120 34512 MT (This executes) 64 W( the CP/M ERA command on the specified file\050s\051. The names of the files being erased are)65 W 10120 35617 MT (not displayed.)SH 6120 37194 MT (EXIT)SH 10120 XM (Quit back to CP/M. The return is made by a JMP 0 \050Warmstart\051)SH 6120 38771 MT (FCOPY)SH /Times-Italic SF 9593 XM (source destination)SH /Times-Roman SF 10120 39876 MT (Copy a named file to another file, either on the same drive or another drive.)SH 6120 41453 MT (FINISH)SH 10120 XM (Like LOGOUT, but shuts down the remote server) 199 W( without logging it out. Leaves you at Kermit-80)200 W 10120 42558 MT (command level; subsequent CONNECT commands will put you back at host system command level.)SH 6120 44135 MT (GET)SH /Times-Italic SF 8314 XM (filespec \050local_filespec\051)SH /Times-Roman SF 10120 45240 MT (When Kermit-80 is talking) 67 W( to a Kermit Server on the host, you should use the GET command to request)68 W 10120 46345 MT (the server to send files to you, for example:)SH /Courier SF 12520 48000 MT (get hlp:k*.hlp)SH /Times-Roman SF 10120 49717 MT (You may specify a local filename) 264 W( if you want to save the remote file under a different filename.)263 W 10120 50822 MT (Limitation: If you request an alternate block check type using) 194 W( the SET BLOCK command, the GET)195 W 10120 51927 MT (command will not communicate it to the remote server. If you want to have) 7 W( type 2 or 3 block checks done)6 W 10120 53032 MT (when getting files from the server, you have to issue) 11 W( the appropriate SET BLOCK command to the remote)12 W 10120 54137 MT (KERMIT before putting it in server mode.)SH 6120 55714 MT (HELP)SH 10120 XM (List all these commands,) 27 W( with a short description on what the commands do. A question mark will do the)26 W 10120 56819 MT (same. If) 408 W( you have already typed a command but do not know) 79 W( what the parameters are, type a space \050to)80 W 10120 57924 MT (indicate the end of the command\051 and a question mark.) 43 W( You) 335 W( will be informed of what Kermit can expect)42 W 10120 59029 MT (at that stage.)SH 6120 60606 MT (INPUT)SH /Times-Italic SF 9314 XM (time_delay string)SH /Times-Roman SF 10120 61711 MT (Setup a string and time delay for your CP/M system to expect from) 36 W( the host, then wait for that sting to be)35 W 10120 62816 MT (sent to your CP/M-80 system.)SH 6120 64393 MT (LOG)SH /Times-Italic SF 8425 XM (filespec)SH /Times-Roman SF 10120 65498 MT (When CONNECTed to a foreign host as a terminal, log the terminal session to the specified diskette file.)49 W 10120 66603 MT (This functionality depends to some extent) 13 W( on the remote host's ability to do XON/XOFF flow control, and)14 W 10120 67708 MT (does not guarantee a complete transcript \050after all, that's what the KERMIT protocol is for\051. The log file)48 W 10120 68813 MT (is closed when the connection is closed by typing the escape character followed by the single-character)104 W 10120 69918 MT (command "C".)SH 6120 71495 MT (LOG \050append\051)SH ES %%Page: 323 324 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (15.2. Kermit-80 Description)SH 10 /Times-Italic AF 51275 XM (Page 323)SH 46800 50 8280 5709 UL /Times-Roman SF 12280 7886 MT (It is possible to temporarily suspend logging during connect state. Typing an) 97 W( escape sequence can turn)98 W 12280 8991 MT (file logging on \050 R for Resume\051 or off \050 Q for quiet\051.)SH 12280 10568 MT (Re-entering connect state will re-open the previously opened log file and append to that file.)SH 8280 12145 MT (LOGOUT)SH 12280 13250 MT (Like BYE, but leaves you at Kermit-80 command level.)SH 8280 14827 MT (PAUSE)SH /Times-Italic SF 11697 XM (delay_period)SH /Times-Roman SF 12280 15932 MT (If this command is issued your CP/M system will wait) 42 W( a while before proceeding with another command.)41 W 12280 17037 MT (This is intended for use) 21 W( in TAKE commands, where you may want to pause for a while before proceeding)22 W 12280 18142 MT (with the rest of the TAKE file. The actula delay) 62 W( is very variable between systems, and values should be)61 W 12280 19247 MT (determined on a trial and error basis.)SH 8280 20824 MT (PRINT)SH 12280 XM (Print a file to the) 65 W( console and printer. Output to the printer is buffered by the Kermit maintained printer)66 W 12280 21929 MT (buffer This routine is identical to TYPE but characters are echoed to the printer as well as) 72 W( to the screen.)71 W 12280 23034 MT (Suspending and aborting output is as described in TYPE.)SH 8280 24611 MT (RECEIVE)SH /Times-Italic SF 12752 XM (filespec)SH /Times-Roman SF 12280 25716 MT (Receive file\050s\051 from the remote) 185 W( Kermit, and save them under the names provided in the file headers)184 W 12280 26821 MT (supplied by) 37 W( the remote host. If a local filespec is given, the file is saved under the given filename. If the)38 W 12280 27926 MT (names aren't legal, use) 104 W( as many legal characters from the name as possible \050see the description of SET)103 W 12280 29031 MT (FILE-WARNING below\051. If there's) 128 W( a conflict, and FILE-WARNING is ON, warn the user and try to)129 W 12280 30136 MT (build a unique name for the file by adding ")SH /Courier SF (&)SH /Times-Roman SF (" characters to the name.)SH 8280 31713 MT (SEND)SH /Times-Italic SF 11141 XM (filespec)SH /Times-Roman SF 12280 32818 MT (Send file\050s\051 specified by)SH /Times-Italic SF 22278 XM (filespec)SH /Times-Roman SF 25583 XM (to the remote Kermit. The)SH /Times-Italic SF 36498 XM (filespec)SH /Times-Roman SF 39803 XM (may contain CP/M wildcards.)SH 8280 34395 MT (SET)SH /Times-Italic SF 10308 XM (parameter)SH /Times-Roman SF 14724 XM ([)SH /Times-Italic SF (value)SH /Times-Roman SF (])SH 12280 35500 MT (Set the specified parameter to the specified value. Possible parameter settings:)SH 12280 37291 MT (AUTORECEIVE)SH 16280 38396 MT (ON \050or OFF\051. Allows several files to be received without having to type) 156 W( RECEIVE on the)157 W 16280 39501 MT (receiving machine. The routine simply looks for activity) 92 W( on the serial line, and if so fudges a)91 W 16280 40606 MT (RECEIVE command. The packet sent by the sender will be lost.)SH 12280 42183 MT (BAUD-RATE)SH /Times-Italic SF 18307 XM (value)SH /Times-Roman SF 16280 43288 MT (Change the) 23 W( baud rate of the communications port. This command only works on some systems.)22 W /Times-Italic SF 16280 44393 MT (value)SH /Times-Roman SF 18892 XM (is the numeric baud rate \050300, 9600, etc.\051 desired. Type SET) 196 W( BAUD followed by a)197 W 16280 45498 MT (question mark for a list of supported baud rates. On systems that do) 36 W( not support this command,)35 W 16280 46603 MT (you must set the port baud rate from CP/M or other setup mechanism outside of KERMIT-80.)SH 12280 48180 MT (BLOCK-CHECK-TYPE)SH /Times-Italic SF 22474 XM (option)SH /Times-Roman SF 16280 49285 MT (The options are:)SH 16280 51076 MT (1-CHARACTER-CHECKSUM)SH 20280 52181 MT (Normal, default, standard 6-bit checksum.)SH 16280 53286 MT (2-CHARACTER-CHECKSUM)SH 20280 54391 MT (A 12-bit checksum encoded as two characters.)SH 16280 55496 MT (3-CHARACTER-CRC-CCITT)SH 20280 56601 MT (A 16-bit CCITT-format Cyclic Redundancy Check, encoded as 3 characters.)SH 12280 58392 MT (BUFFER-SIZE)SH /Times-Italic SF 18753 XM (value)SH /Times-Roman SF 16280 59497 MT (This allows you to set) 87 W( a buffer size during transfer of data. On some systems it takes so long)86 W 16280 60602 MT (that the remote end times out while the local system is reading or writing to disk.) 8 W( The) 267 W( size is the)9 W 16280 61707 MT (number of 128 disk sectors \050nominal\051 and can be from 1 \050128 bytes\051 to 64 \0508 kbytes\051.)SH 12280 63284 MT (CASE-SENSITIVITY ON \050or OFF\051)SH 16280 64389 MT (Kermit-80 usually maps lower case characters) 91 W( to upper case character, but there may be times)92 W 16280 65494 MT (when lower case should be left alone. SET CASE-SENSITIVITY ON will do this-but only) 50 W( for)49 W 16280 66599 MT (some functions.)SH 16280 68176 MT (CP/M-80 filenames will still be mapped to uppercase characters.)SH 12280 69753 MT (DEBUG)SH 16280 XM (ON \050or OFF\051. Enables/disables displaying of packets on the screen during) 122 W( file transfer. Not)123 W 16280 70858 MT (performed if the QUIET option has been set for the terminal \050ie SET TERMINAL QUIET\051)SH ES %%Page: 324 325 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 324)SH 12 /Times-Bold AF 29186 XM (Kermit User Guide: CP/M-80 KERMIT \05015.2\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 10120 7886 MT (DEFAULT-DISK)SH /Times-Italic SF 17591 XM (drive letter)SH /Times-Roman SF 14120 8991 MT (This allows you to set the) 94 W( default disk as source and destination of file transfers. In addition,)95 W 14120 10096 MT (issuing this command) 134 W( causes you to switch to the specified disk and log it in, write-enabled.)133 W 14120 11201 MT (The colon must be included in the disk name \050A:\051. The selected disk appears in) 302 W( your)303 W 14120 12306 MT (KERMIT-80 prompt, for instance)SH /Courier SF 16520 13961 MT (Kermit-80 14A:>)SH /Times-Roman SF 10120 15678 MT (DIRECTORY-FILE-SIZE ON \050or OFF\051.)SH 14120 17255 MT (By setting DIRECTORY-FILE-SIZE OFF you) 71 W( can get an abreviated listing of your disk drive.)70 W 14120 18360 MT (File sizes are not) 2 W( calculated, and five files are shown on a line. Setting this option ON will show)3 W 14120 19465 MT (file sizes of each file.)SH 14120 21042 MT (Both options will list the free space remaining.)SH 10120 22619 MT (ESCAPE)SH 14120 XM (Change the escape) 5 W( character for virtual terminal connections. Kermit-80 will prompt you for the)4 W 14120 23724 MT (new escape character, which you enter literally.)SH 10120 25301 MT (FILE-MODE)SH /Times-Italic SF 15758 XM (option)SH /Times-Roman SF 14120 26406 MT (Tells KERMIT-80 what kind of file it is) 69 W( sending, so that KERMIT can correctly determine the)68 W 14120 27511 MT (end of the file. SET FILE BINARY means to send all the 128-byte blocks \050ie) 119 W( logical CP/M)120 W 14120 28616 MT (sectors\051 of the file, including the last block in its entirety; SET FILE ASCII) 14 W( is used for text files,)13 W 14120 29721 MT (and transmission stops when the first Control-Z is encountered anywhere in the) 70 W( file \050this is the)71 W 14120 30826 MT (CP/M convention for marking the end of a text file\051.)SH 14120 32403 MT (SET FILE-MODE) 99 W( DEFAULT tells Kermit to attempt to determine the file type by examining)98 W 14120 33508 MT (the file) 50 W( being transmitted. If a Control-Z appears before the last block of the file, it is assumed)51 W 14120 34613 MT (to be BINARY; if, when the first Control-Z is encountered, the remainder) 104 W( of the file contains)103 W 14120 35718 MT (only control-Z's, it is assumed to be a text file. Unfortunately,) 253 W( not all programs fill the)254 W 14120 36823 MT (remainder of the last record of a text file with Control-Z's, so this algorithm is not) 184 W( always)183 W 14120 37928 MT (successful.)SH 14120 39505 MT (If binary transmission is used on a text) 238 W( file, or a compressed file \050eg a .DQC file\051 some)239 W 14120 40610 MT (extraneous characters \050up to 127 of them\051 may appear at the end of the file on the target system.)SH 14120 42187 MT (If ASCII transmission is used on a binary file, any 8th) 96 W( bits set will be stripped and a warning)95 W 14120 43292 MT (sent to the console. When the first control-Z is encountered, the file is assumed to be at) 16 W( the end,)17 W 14120 44397 MT (even if it is not.)SH 10120 45974 MT (FLOW-CONTROL ON \050or OFF\051)SH 14120 47079 MT (Sets XON/XOFF flow control on or off. If set ON the host is expected to respond) 48 W( to an XOFF)49 W 14120 48184 MT (or XON sent by Kermit-80. If set) 177 W( off, no flow control is assumed and any XON/XOFF is)176 W 14120 49289 MT (ignored.)SH 10120 50866 MT (IBM ON \050or OFF\051)SH 14120 51971 MT (Allow the transfer) 125 W( of files to and from an IBM mainframe computer. This makes Kermit-80)124 W 14120 53076 MT (wait for the IBM turnaround) 61 W( character \050XON\051, ignore parity on input, add appropriate parity to)62 W 14120 54181 MT (output, and use local echoing during) 167 W( CONNECT. As distributed, KERMIT-80 uses MARK)166 W 14120 55286 MT (parity for IBM communication. If you) 4 W( don't give this command, IBM mode is OFF. Since IBM)5 W 14120 56391 MT (VM/CMS KERMIT does not have timeout capability,) 118 W( SET IBM ON also turns on the "fuzzy)117 W 14120 57496 MT (timer" automatically.)SH 10120 59073 MT (LOCAL-ECHO ON \050or OFF\051)SH 14120 60178 MT (When you CONNECT to a) 136 W( remote host, you must set LOCAL-ECHO ON if the host is half)135 W 14120 61283 MT (duplex, OFF if full duplex. OFF by default.)SH 10120 62860 MT (LOGGING ON \050or OFF\051)SH 14120 63965 MT (Cease or resume logging whenever) 25 W( connect mode is entered. This is really only applicable after)24 W 14120 65070 MT (a LOG command is no longer required.)SH 10120 66647 MT (NO-EXIT)SH 14120 67752 MT (This command is applicable only) 145 W( for Kermit initiated with a command tail. For example, if)144 W 14120 68857 MT (Kermit was initiated by:)SH 14120 70434 MT (KERMIT ;SEND HELLO;NO-EXIT)SH ES %%Page: 325 326 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (15.2. Kermit-80 Description)SH 10 /Times-Italic AF 51275 XM (Page 325)SH 46800 50 8280 5709 UL /Times-Roman SF 16280 7886 MT (Kermit would first seek out and execute the KERMIT.INI file \050if present\051, then) 248 W( send file)249 W 16280 8991 MT (HELLO to a remote system.) 8 W( Usually) 265 W( Kermit would exit back to CP/M, but NO-EXIT over-rides)7 W 16280 10096 MT (this.)SH 16280 11673 MT (Note the leading semicolon. This clears leading spaces from the first command.)SH 12280 13250 MT (PORT)SH /Times-Italic SF 15086 XM (port name)SH /Times-Roman SF 16280 14355 MT (Allows you to switch between different communication ports. This command is not available)96 W 16280 15460 MT (on all systems. Type)56 W /Courier SF 25283 XM (SET PORT ?)57 W /Times-Roman SF 31704 XM (for a list of valid options for your system. \050Note: If your)57 W 16280 16565 MT (system does not support several) 105 W( ports, this command will return a "Not implemented" error if)104 W 16280 17670 MT (you try to set a port.\051)SH 12280 19247 MT (PRINTER)SH 16280 20352 MT (ON \050or OFF\051)SH 16280 21457 MT (Turns copying of CONNECT session) 151 W( to printer on and off. It is also possible to toggle the)152 W 16280 22562 MT (printer on/off from the connect state, by typing followed by P.)SH 12280 24139 MT (PARITY)SH /Times-Italic SF 16141 XM (option)SH /Times-Roman SF 16280 25244 MT (Sets parity for outgoing characters to one of) 49 W( the following: NONE, SPACE, MARK, EVEN, or)50 W 16280 26349 MT (ODD. On) 286 W( input, if parity is NONE, then the 8th bit is kept \050as data\051, otherwise it is stripped) 18 W( and)17 W 16280 27454 MT (ignored. The) 558 W( parity setting applies to both terminal) 154 W( connection and file transfer. If you set)155 W 16280 28559 MT (parity to) 236 W( anything other than none, KERMIT-80 will attempt to use "8th bit prefixing" to)235 W 16280 29664 MT (transfer binary files.) 45 W( If) 341 W( the other KERMIT is also capable of 8th bit prefixing, then binary files)46 W 16280 30769 MT (can be transferred successfully; if not, the 8th bit of each data byte) 75 W( will be lost \050you will see a)74 W 16280 31874 MT (warning on your screen if this happens\051.)SH 12280 33451 MT (RECEIVE)SH /Times-Italic SF 16752 XM (parameter)SH /Times-Roman SF 21168 XM ([)SH /Times-Italic SF (value)SH /Times-Roman SF (])SH 16280 34556 MT (Set a RECEIVE parameter.)SH 16280 36347 MT (PAD-CHAR)SH 20280 37452 MT (Set the PAD character to use while receiving files. Currently a dummy, as for SET)100 W 20280 38557 MT (SEND PAD-CHAR.)SH 16280 39662 MT (PADDING [value])SH 20280 40767 MT (Set the) 75 W( number of PAD characters to use while receiving files. Same as SET SEND)76 W 20280 41872 MT (PADDING.)SH 16280 42977 MT (START-OF-PACKET [value])SH 20280 44082 MT (Set the default start of Packet character) 57 W( for receiving files. Apply the same rules and)58 W 20280 45187 MT (considerations as for SET SEND START-OF-PACKET.)SH 12280 46978 MT (SEND)SH /Times-Italic SF 15141 XM (parameter)SH /Times-Roman SF 19557 XM ([)SH /Times-Italic SF (value)SH /Times-Roman SF (])SH 16280 48083 MT (Set a SEND parameter.)SH 16280 49874 MT (PAD-CHAR)SH 20280 50979 MT (Set the Pad character to be used while sending files. It is currently a dummy) 99 W( entry,)98 W 20280 52084 MT (and does not do anything.)SH 16280 53189 MT (PADDING [value])SH 20280 54294 MT (Set the number of PAD-CHARS to be used while sending files.) 250 W( This) 748 W( too does)249 W 20280 55399 MT (nothing.)SH 16280 56504 MT (START-OF-PACKET)SH 20280 57609 MT (Set the) 29 W( default start of packet character to another character than control-A. This may)28 W 20280 58714 MT (be necessary on systems \050including intervening networks\051 that) 438 W( trap control-A)439 W 20280 59819 MT (characters. Choose) 273 W( a control character not otherwise used, ie not carriage return \05013D,)11 W 20280 60924 MT (ODH\051, line feed \05010D, OAN\051, tabs \05009D, 09H\051, backspace \05008H\051, and bell) 107 W( \05007H\051 or)108 W 20280 62029 MT (any other used between you and your remote system.)SH 12280 63820 MT (TACTRAP)SH 16280 64925 MT (set the TAC intercept character. If) 158 W( you are attached to a TAC it will swallow the intercept)159 W 16280 66030 MT (character \050commercial AT sign by default\051 so Kermit) 95 W( sends it twice. With this command you)94 W 16280 67135 MT (can set the intercept character \050ie the one to send twice\051 to another character.)SH 12280 68712 MT (TERMINAL)SH /Times-Italic SF 17696 XM (option)SH /Times-Roman SF 16280 69817 MT (Select one of the following terminal characteristics:)SH 16280 71608 MT (OFF)SH 20280 XM (sets emulation off, and its up to the) 64 W( attached terminal to respond to escape sequences)63 W ES %%Page: 326 327 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 326)SH 12 /Times-Bold AF 29186 XM (Kermit User Guide: CP/M-80 KERMIT \05015.2\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 18120 7886 MT (sent from the remote host system.)SH 14120 9544 MT (DUMB)SH 18120 XM (Like off, but carriage return and line feed characters are) 122 W( the only control characters)123 W 18120 10649 MT (accepted. All) 250 W( other control characters are simply ignored. \050Really a "Glass TTY"\051.)SH 14120 12307 MT (EXTERNAL)SH 18120 13412 MT (Emulation is provided for by a routine in the) 258 W( system dependent part of Kermit.)259 W 18120 14517 MT (Attempting to set this option without having and externally supplied) 237 W( routine will)236 W 18120 15622 MT (returna "Not Implemented" error.)SH 14120 17280 MT (VT52)SH 18120 XM (When connected as a terminal to a foreign host, the micro emulates a VT52.) 100 W( VT52)451 W 18120 18385 MT (emulation is set by default, except on micros that already have terminal functionality)74 W 18120 19490 MT (built in, such as the DEC VT180 and DECmate \050these act as) 34 W( VT100-series terminals\051.)35 W 18120 20595 MT (Some systems emulate other terminals, like the ADM3A; see table 15-5.)SH 14120 22253 MT (QUIET)SH 18120 XM (Do not) 73 W( display any file transfer information onto the console. This mode is useful if)72 W 18120 23358 MT (you console takes a long time to update the display. Only the file name) 57 W( is displayed.)58 W 18120 24463 MT (DEBUGging information is not displayed even if selected.)SH 14120 26121 MT (REGULAR)SH 18120 27226 MT (Inverse of QUIET. All packets etc displayed, as ususal.)SH 10120 29017 MT (TIMER ON \050or OFF\051)SH 14120 30122 MT (Enable or disable the "fuzzy timer". The timer is off by default, because in the) 132 W( normal case)131 W 14120 31227 MT (KERMIT-80 is communicating) 61 W( with a mainframe KERMIT that has its own timer. Mainframe)62 W 14120 32332 MT (KERMIT timers tend to) 47 W( be more precise or adaptable to changing conditions. You should SET)46 W 14120 33437 MT (TIMER ON if you are) 40 W( communicating with a KERMIT that does not have a timer. You should)41 W 14120 34542 MT (SET TIMER OFF if you are communicating over a network with long delays.)SH 10120 36119 MT (USER)SH /Times-Italic SF 12926 XM (new user number)SH /Times-Roman SF 14120 37224 MT (Sets another user number to be active.) 202 W( Acceptable) 656 W( user numbers are 0 to 31, though it is)203 W 14120 38329 MT (recommended to use user numbers 0 to 15 only. This is really only useful for Winchester)184 W 14120 39434 MT (Systems with high disk capacities.)SH 10120 41011 MT (WARNING ON \050or OFF\051)SH 14120 42116 MT (Warn user of filename conflicts when receiving files from remote host, and attempt) 6 W( to generate a)5 W 14120 43221 MT (unique name by adding ")SH /Courier SF (&)SH /Times-Roman SF (" characters to the given name. ON by default.)SH 6120 45012 MT (SHOW)SH 10120 XM (Display all setable parameters. You will) 96 W( get a page or so of the status af all parameters that can be set)97 W 10120 46117 MT (using the SET command.)SH 6120 47694 MT (STATUS)SH 10120 XM (The same function as Show.)SH 6120 49271 MT (STRING)SH /Times-Italic SF 9981 XM (line of text)SH /Times-Roman SF 10120 50376 MT (Send a character string to the host. This simply copies the string to the correct line, and assumes all)152 W 10120 51481 MT (appropriate parameters have been set to be used eg) 30 W( baudrate, parity etc. It is intended as an option for the)29 W 10120 52586 MT (TAKE command.)SH 6120 54163 MT (TAKE)SH /Times-Italic SF 9036 XM (filespec)SH /Times-Roman SF 10120 55268 MT (Take characters and commands from the specified file as) 41 W( if they were entered from the keyboard. This is)40 W 10120 56373 MT (useful if you want to) 209 W( set up a batch job. A command file can send, get, receive, set functions etc)210 W 10120 57478 MT (automatically.)SH 10120 59055 MT (An automatic "TAKE KERMIT.INI" is executed from the default drive when Kermit-80 is loaded.) 68 W( This)385 W 10120 60160 MT (can be used to set defaults of band rate, parity, filetype, default drive etc.)SH 10120 61737 MT (If KERMIT.INI does not exist, control is given directly to the user.)SH 6120 63314 MT (TRANSMIT)SH /Times-Italic SF 11481 XM (filespec wait character string)SH /Times-Roman SF 10120 64419 MT (Send the specified file to the system on the other end of the connection as though it were) 71 W( being typed at)70 W 10120 65524 MT (the terminal, one) 35 W( line at a time. Each line sent is terminated with a carriage return, and any line feeds are)36 W 10120 66629 MT (stripped from the file sent. After each line has been sent Kermit waits for a) 31 W( character string from the host)30 W 10120 67734 MT (\050eg a acrriage) 75 W( return\051. If not specified, a carriage return is assumed. No KERMIT protocol is involved.)76 W 10120 68839 MT (An asterix \050star\051 is sent to the console for every line sent, to indicate how the transfer is progressing.) 21 W( This)290 W 10120 69944 MT (is useful for sending files to systems that don't have a KERMIT) 42 W( program. During transmission, you may)43 W 10120 71049 MT (type one of these single-character commands:)SH ES %%Page: 327 328 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (15.2. Kermit-80 Description)SH 10 /Times-Italic AF 51275 XM (Page 327)SH 46800 50 8280 5709 UL /Times-Roman SF 12280 7886 MT (Control-C)SH 14280 8991 MT (Cease transmission, and drop into terminal emulation mode.)SH 12280 10096 MT ()SH 14280 11201 MT (Re-transmit the previous line.)SH 8280 12992 MT (TYPE)SH 12280 XM (Type a file to the console. Typing any character) 2 W( other than Control-C while the file is being displayed will)1 W 12280 14097 MT (suspend the output. Another character will resume output. A Control-C will abort the rest of the output.)SH 8280 15674 MT (VERSION)SH 12280 16779 MT (Show the name, edit number, and edit date of several of the modules that make up Kermit-80.)SH 14 /Times-Bold AF 8280 20381 MT (15.3. Kermit-80 Flavors)SH 10 /Times-Roman AF 8280 22499 MT (Many of the systems supported use an external terminal, rather than a built-in console. Kermit may) 153 W( be further)152 W 8280 23695 MT (customized for these systems by defining \050at assembly time\051 the terminal type to be used. If) 97 W( the terminal type is)98 W 8280 24891 MT (unknown or does not match any of the existing terminal options, the generic "CRT" option may be selected. In) 30 W( this)29 W 8280 26087 MT (case, Kermit cannot) 24 W( do fancy screen control during file transfer; it simply types the file names, packet numbers, and)25 W 8280 27283 MT (messages in sequence across and down the screen. This) 184 W( works best if you can put your micro or terminal in)183 W 8280 28479 MT ("autowrap" mode; otherwise the packet) 68 W( numbers will pile up in the rightmost column; the filenames and messages)69 W 8280 29675 MT (will always appear on a new line, however. If no specific terminal has been selected, Kermit) 151 W( cannot do VT52)150 W 8280 30871 MT (emulation; it) 166 W( can act as a "dumb terminal" \050sometimes called a "glass TTY"\051, or else its own built in terminal)167 W 8280 32067 MT (firmware provides cursor control functions independent of the Kermit program.)SH 12 /Times-Bold AF 8280 35183 MT (15.3.1. Generic Kermit-80)SH 10 /Times-Roman AF 8280 37125 MT ("Generic Kermit-80" is an implementation of) 12 W( Kermit that should run on any 8080-compatible CP/M 2.2 system with)11 W 8280 38321 MT (no modification at all, or perhaps only a minor one. Unlike other Kermit-80 implementations, it contains no) 6 W( system-)7 W 8280 39517 MT (dependent manipulation of the serial port. All I/O is done with standard) 88 W( CP/M BIOS calls, and I/O redirection is)87 W 8280 40713 MT (done using the CP/M IOBYTE function, which, according to the Digital Research)24 W /Times-Italic SF 41620 XM (CP/M Operating System Manual)24 W /Times-Roman SF (,)SH 8280 41909 MT (is an optional feature of any particular CP/M implementation.) 208 W( If) 664 W( your system does not provide the IOBYTE)207 W 8280 43105 MT (function, Generic Kermit-80) 35 W( will not work; furthermore, not all systems that implement IOBYTE do so in the same)36 W 8280 44301 MT (way. The) 318 W( SET PORT command may be used to select the devices to be used for input and) 34 W( output. Table 15-1 lists)33 W 8280 45497 MT (the options to the SET PORT command and their effects.)SH 46800 50 8280 47414 UL /Courier SF 19614 49495 MT (SET PORT)SH /Times-Italic SF 25014 XM (xxx)SH /Courier SF 28746 XM (input from) SH( output) 3000 W( to)SH 6732 50 19614 49695 UL 6000 50 28746 49695 UL 5400 50 38346 49695 UL 22380 50526 MT (CRT CRT: CRT:)6600 W 22380 51557 MT (PTR PTR: PTP:)6600 W 22380 52588 MT (TTY TTY: TTY:)6600 W 22380 53619 MT (UC1 UC1: UC1:)6600 W 22380 54650 MT (UR1 UR1: UP1:)6600 W 22380 55681 MT (UR2 UR2: UP2:)6600 W /Times-Bold SF 22791 57291 MT (Table 15-1:)SH /Times-Roman SF 28152 XM (Kermit-80 SET PORT Options)SH 46800 50 8280 59101 UL 8280 61293 MT (The default is SET PORT PTR. In all cases, the console \050CON:\051 and list \050LST:\051 devices) 104 W( used are those selected)105 W 8280 62489 MT (when Kermit is started.)SH 8280 64881 MT (The reason all Kermit-80 implementations) 129 W( aren't generic is that a good deal of speed is sacrificed by getting all)128 W 8280 66077 MT (services from the) 44 W( operating system. While a specific implementation of Kermit-80 may be able to operate at 4800,)45 W 8280 67273 MT (9600, or even 56 Kilo baud,) 31 W( generic Kermit will fail to work on some systems at speeds in excess of 1200 baud. In)30 W 8280 68469 MT (addition, many features of Kermit) 170 W( require more specific knowledge of the hardware involved. Generic Kermit)171 W 8280 69665 MT (cannot send a BREAK signal, or change the baud rate, for example.)SH ES %%Page: 328 329 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 328)SH 12 /Times-Bold AF 28286 XM (Kermit User Guide: CP/M-80 KERMIT \05015.3.2\051)SH 46800 50 6120 5709 UL 6120 8004 MT (15.3.2. CP/M 3 Kermit)SH 10 /Times-Roman AF 6120 9946 MT (CP/M-3 Kermit \050also known as CP/M-Plus Kermit\051 is a version of) 162 W( generic Kermit-80, and should run on most)161 W 6120 11142 MT (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 6120 12338 MT (BAUD and SET PORT commands are not supported; nor can a BREAK be sent. Like generic Kermit-80, a terminal)3 W 6120 13534 MT (may be selected at assembly time.)SH 12 /Times-Bold AF 6120 16650 MT (15.3.3. System-Specific Versions)SH 10 /Times-Roman AF 6120 18592 MT (There are also many versions of Kermit-80) 38 W( tailored to specific systems. Most of these operate uniformly, but some)39 W 6120 19788 MT (of them) 146 W( take advantage \050or suffer limitations\051 of the specific system. Here are some of the special features for)145 W 6120 20984 MT (particular systems:)SH 6120 22775 MT (Amstrad: -- Two versions:)SH 3444 50 6120 22975 UL 8120 24566 MT (PCW 8256)SH 10120 25671 MT (The PCW 8256/8512 with the serial inerafce attached.)SH 8120 27248 MT (CPC 6128)SH 10120 28353 MT (The 664 with add on memory and 6128 are both supported.) 9 W( Both) 269 W( systems must run CP/M Plus, so the 664)10 W 10120 29458 MT (will need an add on RAM) 71 W( pack and CP/M upgrade. A high speed transfer rate of 38k baud can be used)70 W 10120 30563 MT (between Amstrad computers.)SH 6120 32354 MT (ACCESS:)SH 3779 50 6120 32554 UL 8120 33459 MT (Access Matrix computer using port J5. Supports SET BAUD-RATE for rates of 300-9600 baud.)SH 6120 35036 MT (Apple II -- four variations:)SH 3360 50 6120 35236 UL 8120 36827 MT (APMMDM:)SH 10120 37932 MT (Apple with Z80) 62 W( Softcard and Micromodem II in slot 2 Dialout capability provided in connect command;)63 W 10120 39037 MT (user is prompted for phone number if carrier is not present. During) 125 W( connect mode,)124 W /Courier SF 45291 XM (^]D)SH /Times-Roman SF 47465 XM (drops carrier.)124 W 10120 40142 MT (BYE command also causes carrier to be dropped.)SH 8120 41719 MT (AP6551:)SH 10120 42824 MT (Apple with Z80 Softcard,) 199 W( and one of several 6551-based communication cards; the slot number is a)198 W 10120 43929 MT (compile-time parameter \050default is slot 2\051. SET BAUD-RATE supported; speeds are 110-19200 baud.)SH 8120 45506 MT (APCPS:)SH 10120 46611 MT (Apple with Z80 Softcard and CP Multi-Function) 280 W( Card. The slot number is again a compile-time)279 W 10120 47716 MT (parameter. SET) 250 W( BAUD-RATE is supported for baud rates from 50 baud to 19200 baud.)SH 8120 49293 MT (AP6850:)SH 10120 50398 MT (Apple II with Z80 Softcard and a 6850-based USART in slot 2-the slot being a compile-time) 73 W( parameter.)72 W 10120 51503 MT (SET BAUD-RATE is not supported.)SH 6120 53294 MT (BBC:)SH 2001 50 6120 53494 UL 8120 54399 MT (Acorn Computers BBC) 289 W( Computer with Acorn Z80 second processor running CP/M-80. Supports SET)288 W 8120 55504 MT (BAUD-RATE and can send breaks.)SH 6120 57081 MT (BigBoard II:)SH 4805 50 6120 57281 UL 8120 58186 MT (Uses serial port A. To use port B, change mnport, mnprts, and baudrt and reassemble. Can generate) 48 W( BREAK.)47 W 8120 59291 MT (SET BAUD-RATE supported; speeds are 300-38400 baud.)SH 6120 60868 MT (Cifer:)SH 2055 50 6120 61068 UL 8120 61973 MT (Originally coded for Cifer 1886 using the VL: port set as TTYI: and TTYO: but) 82 W( works successfully on 18xx)81 W 8120 63078 MT (and 28xx series machines.)SH 8120 64655 MT (There are now two versions, each with two variations:) 1 W( Either running CP/M Version 2.2 or 3.0, and either using)2 W 8120 65760 MT (the VL: or AUX: ports. The VL: port version can only use seven bits of data, so parity prefixing) 62 W( is required)61 W 8120 66865 MT (for binary) 21 W( file transfers. This restriction is removed by using the AUX: port. For those interested, the problem)22 W 8120 67970 MT (is due to the interprocessor link between the) 2 W( video and CPU \050!\051 boards. The VL: port is on the video board, and)1 W 8120 69075 MT (the AUX: port on the CPU board, and the inter processor link can only transfer seven bits of data.)SH 8120 70652 MT (Supports SET BAUD-RATE, and can generate breaks on some models with a BREAK key.)SH ES %%Page: 329 330 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (15.3.3. System-Specific Versions)SH 10 /Times-Italic AF 51275 XM (Page 329)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (Comart:)SH 3000 50 8280 8086 UL 10280 8991 MT (Comart Communicator-Similar to Northstar equipment. Can generate BREAK.)SH 8280 10568 MT (Compupro:)SH 4278 50 8280 10768 UL 10280 11673 MT (Based on Kermit 3.x, and has been merged into V4.09)SH 8280 13250 MT (CPT-85xx word processors:)SH 10943 50 8280 13450 UL 10280 14355 MT (Can generate BREAK. SET BAUD-RATE supported; speeds are 50-9600 baud.)SH 8280 15932 MT (Cromemco:)SH 4444 50 8280 16132 UL 10280 17037 MT (Cromemco computers with TU-ART card. Supports SET BAUD-RATE \050110-9600 baud\051.)SH 8280 18614 MT (DEC DECmate II word processor \050with Z80 card\051:)SH 20023 50 8280 18814 UL 10280 19719 MT (Can generate BREAK.)SH 8280 21296 MT (DEC VT180 \050Robin\051:)SH 8444 50 8280 21496 UL 10280 22401 MT (Three output ports, referred to as COMMUNICATIONS, GENERAL, and PRINTER. Can generate BREAK.)SH 8280 23978 MT (Digicomp Delphi 100:)SH 8722 50 8280 24178 UL 10280 25083 MT (SET BAUD-RATE supported; speeds are 50-19200 baud.)SH 8280 26660 MT (Discovery:)SH 4110 50 8280 26860 UL 10280 27765 MT (Action Computer Enterprises "Discovery" Multi-user Computer. Uses Port) 30 W( B on an 83U user board. Supports)31 W 10280 28870 MT (SET BAUD-RATE for 50-19200 baud. Can generate BREAK.)SH 8280 30447 MT (Epson:)SH 2500 50 8280 30647 UL 10280 31552 MT (Epson PX-8 with) 56 W( LCD display. Although it is quite different in displaying of Packet Information, it works as)57 W 10280 32657 MT (any other CP/M-80 Kermit. Supports SET BAUD-RATE and can generate BREAK.)SH 8280 34234 MT (Generic Kermit:)SH 6248 50 8280 34434 UL 10280 35339 MT (Two versions,) 45 W( one for CP/M version 2)46 W /Courier SF (.)SH /Times-Roman SF (2 and version 3. These systems use IOBYTE flipping \050V2)46 W /Courier SF (.)SH /Times-Roman SF (2\051 and the)46 W 10280 36444 MT (AUX: device) 308 W( to communicate to the) 29 W( serial line. You may have to SET PORT xxx before the version 2)28 W /Courier SF (.)SH /Times-Roman SF (2 will)28 W 10280 37549 MT (work, as Kermit needs to know what device is the serial line.)SH 8280 39126 MT (Genie:)SH 2388 50 8280 39326 UL 10280 40231 MT (Eaca Video Genie.)SH 8280 41808 MT (Heath: Three Versions:)SH 2388 50 8280 42008 UL 10280 43599 MT (H8QUAD)SH 12280 44704 MT (for Heath-8 systems) 13 W( with the quad io board. This system has been derived from V3.x code. Note that this)14 W 12280 45809 MT (version will not run "as is" on H89 systems.)SH 10280 47386 MT (H89)SH 12280 XM (For Heath-89 machines suports baud rates from 50 to 56,000 baud.)SH 10280 48963 MT (Z100)SH 12280 50068 MT (For Z-100 running CP/M-85. This version does not support setting of baud rates.)SH 8280 51859 MT (Intertec Superbrain: Two Versions:)SH 7692 50 8280 52059 UL 10280 53650 MT (BRAINA)SH 12280 54755 MT (For superbrain using AUX port. Breaks and SET BAUD both supported)SH 10280 56332 MT (BRAINM)SH 12280 57437 MT (As above, but using the MAIN port.)SH 8280 59228 MT (Ithaca:)SH 2443 50 8280 59428 UL 10280 60333 MT (Ithaca Intersystems based computer using the VIO card for all IO to the outside world. The system is strictly)60 W 10280 61438 MT (speaking a home-brew variant of the Ithaca machine,) 23 W( using an S100 cardcage without a front panel. It uses the)24 W 10280 62543 MT (Extended BIOS by) 39 W( EuroMicro of London. However, I see no reason for this version not running on a genuine)38 W 10280 63648 MT (Ithaca Intersystems machine. There are patches needed to the EuroMicro BIOS to make this version work.)SH 8280 65225 MT (Kaypro:)SH 3277 50 8280 65425 UL 10280 66330 MT (Should work on most Kaypro models, as well as some related systems) 25 W( \050Ferguson BigBoard I, Xerox 820\051. For)24 W 10280 67435 MT (the newer Kaypros with multiple ports, Kermit uses the one labeled "serial) 13 W( data"; it cannot use the serial printer)14 W 10280 68540 MT (or internal modem ports \050but it should be possible to modify the values for) 82 W( mnport, mnprts, and baudrt to do)81 W 10280 69645 MT (this\051. Can) 250 W( generate BREAK. SET BAUD-RATE supported; speeds are 50-19200 baud.)SH 8280 71222 MT (Lobo:)SH 2111 50 8280 71422 UL ES %%Page: 330 331 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 330)SH 12 /Times-Bold AF 28286 XM (Kermit User Guide: CP/M-80 KERMIT \05015.3.3\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 8120 7886 MT (Lobo MAX-80. Supports SET BAUD-RATE and can generate BREAKS.)SH 6120 9463 MT (Merlin:)SH 2722 50 6120 9663 UL 8120 10568 MT (British Telecom Merlin M2215 \050also Rair Black Box, possibly also the ICL PC?\051. Requires a terminal.)SH 6120 12145 MT (Micromate:)SH 4388 50 6120 12345 UL 8120 13250 MT (PMC 101 Micromate. Supports SET BAUD-RATE and can generate BREAK.)SH 6120 14827 MT (Micromint: Two versions)SH 4278 50 6120 15027 UL 8120 16618 MT (S6)SH 10120 XM (The Ciarcia/Micromint sb-180 board with a 6Mhz procoessor. System requires a terminal.)SH 8120 18195 MT (S9)SH 10120 XM (As above, but with a 9Mhz processor.)SH 6120 19986 MT (NCR:)SH 2056 50 6120 20186 UL 8120 21091 MT (Decisionmate 5. Uses the 2651 and is largely the same as the Ithaca Intersystems machine implementation.)SH 6120 22668 MT (Northstar: -- There are four versions available:)SH 3777 50 6120 22868 UL 8120 24459 MT (NORTHS:)SH 10120 25564 MT (Northstar Horizon with HS10-4 board. Supports SET BAUD-RATE and SET PORT.)SH 8120 27141 MT (HORIZON:)SH 10120 28246 MT (Northstar Horizon using the serial ports on the Mother board. Can generate BREAK.)SH 8120 29823 MT (BASICNS:)SH 10120 30928 MT (Basic Northstar Horizon using the printer port. Can generate BREAK.)SH 8120 32505 MT (ADVANT:)SH 10120 33610 MT (Northstar Advantage. Supports SET BAUD-RATE and can generate BREAK. Traps Control-0 in the)129 W 10120 34715 MT (system filter.)SH 6120 36506 MT (Morrow Decision I:)SH 7665 50 6120 36706 UL 8120 37611 MT (Uses the Multi-I/O board. Port 1 is the console, port 3 is the communications line.) 191 W( SET) 634 W( BAUD-RATE)192 W 8120 38716 MT (supported; speeds are 75-56000 baud.)SH 6120 40293 MT (Morrow Micro Decision I:)SH 10359 50 6120 40493 UL 6120 41870 MT (Nokia MicroMikko:)SH 7805 50 6120 42070 UL 8120 42975 MT (Will not echo control-O \050which locks keyboard\051. SET BAUD-RATE supported; speeds are 75-9600 baud.)SH 6120 44552 MT (Ohio Scientific:)SH 6083 50 6120 44752 UL 8120 45657 MT (Doesn't have screen control.)SH 6120 47234 MT (Osborne 1:)SH 4138 50 6120 47434 UL 8120 48339 MT (Uses serial line, not internal modem.) 38 W( Left-arrow) 327 W( key generates \050"delete" or "rubout" character\051 during)39 W 8120 49444 MT (connect mode. SET BAUD-RATE supported; speeds are 300 and 1200) 167 W( baud. Now supports multi-sector)166 W 8120 50549 MT (buffering.)SH 6120 52126 MT (Research Machines: Two Versions:)SH 7803 50 6120 52326 UL 8120 53917 MT (RM380ZM:)SH 10120 55022 MT (380Z and 5.25" disks supports SET BAUD.RATE)SH 8120 56599 MT (RM380ZF:)SH 10120 57704 MT (380Z and 8" disks, otherwise as above.)SH 6120 59495 MT (Sanyo:)SH 2500 50 6120 59695 UL 8120 60600 MT (Sanyo MBC-1100. This version derived from Kermit V3.x)SH 6120 62177 MT (ScreenTyper:)SH 5109 50 6120 62377 UL 8120 63282 MT (Details unkown.)SH 6120 64859 MT (TRS-80: Three versions:)SH 3167 50 6120 65059 UL 8120 66650 MT (TRS80LB:)SH 10120 67755 MT (TRS-80 with Lifeboat CP/M)SH 8120 69332 MT (TRS80PT:)SH 10120 70437 MT (TRS-80 with Pickles and Trout CP/M)SH ES %%Page: 331 332 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (15.3.3. System-Specific Versions)SH 10 /Times-Italic AF 51275 XM (Page 331)SH 46800 50 8280 5709 UL /Times-Roman SF 10280 7886 MT (TRSM4:)SH 12280 8991 MT (TRS-80 Model 4 with Montezuma CP/M)SH 8280 10782 MT (Teletek:)SH 2999 50 8280 10982 UL 10280 11887 MT (Teletek Systemaster. Supports SET BAUD.)SH 8280 13464 MT (Telcon:)SH 2777 50 8280 13664 UL 10280 14569 MT (TELCON ZOBRA portable computer.)SH 8280 16146 MT (Torch:)SH 2388 50 8280 16346 UL 10280 17251 MT (Torch Unicorn 5 initially, but the code runs on other Z80 based CP/N \050as in Nut!\051 systems.) 79 W( It) 410 W( uses the BBC)80 W 10280 18356 MT (Computer as a "Base processor", and is similar to the BBC version. The base processors RS423) 77 W( port is used)76 W 10280 19461 MT (rather than any built in Modem. \050UK telecoms legislation effectively) 109 W( makes modem control software tricky)110 W 10280 20566 MT (business...\051. Two) 591 W( potential versions exist-one using cursor positioning codes for a MCP and CCCP ROM)170 W 10280 21671 MT (combination of revision less than 1.00, the other version uses the additional facility MCP/CCCP) 196 W( versions)197 W 10280 22776 MT (greater than 1. Supports SET BAUD-RATE and can generate BREAKs.)SH 10280 24353 MT (Note that binary files must be transferred using SET PARITY to anything other than) 45 W( NONE! Parity is neither)44 W 10280 25458 MT (generated nor checked.)SH 8280 27035 MT (US Micro Sales:)SH 6333 50 8280 27235 UL 10280 28140 MT (S-100-8 based computer.)SH 8280 29717 MT (Vector Graphics:)SH 6581 50 8280 29917 UL 10280 30822 MT (Vector)SH 8280 32399 MT (Xerox:)SH 2499 50 8280 32599 UL 10280 33504 MT (Xerox 820.)SH 8280 35081 MT (Z80MU:)SH 3222 50 8280 35281 UL 10280 36186 MT (Development Kermit on a PC running the) 298 W( Z80MU Z80 and CP/M 2)299 W /Courier SF (.)SH /Times-Roman SF (2 development system. Allows)299 W 10280 37291 MT (development of the system independent modules to be done on an IBM) 241 W( PC or clone. Also allows the)240 W 10280 38396 MT (generation of new .HEX files, that may then be KERMITed to the target system. Note:) 54 W( Not) 359 W( all the BDOS or)55 W 10280 39501 MT (BIOS routines are supported, so avoid "unusual" BIOS/BDOS calls. \050For example,) 92 W( DIR from within Kermit)91 W 10280 40606 MT (will fail as one of the BIOS routines returning disk parameters is not supported.\051)SH 14 /Times-Bold AF 8280 44208 MT (15.4. Installation of Kermit-80)SH 10 /Times-Roman AF 8280 46326 MT (Kermit-80 was written originally for the Intertec SuperBrain in lowest-common-denominator) 97 W( 8080) 445 W( code with the)98 W 8280 47522 MT (standard assembler, ASM \050single source module, no macros, no advanced) 293 W( instructions\051, so that it could be)292 W 8280 48718 MT (assembled on any CP/M-80 system \050the 8080 assembler is distributed as a standard) 83 W( part of CP/M-80, whereas the)84 W 8280 49914 MT (fancier Z80 or macro assemblers are normally commercial products\051. It has since been modified to run on many)99 W 8280 51110 MT (other systems as well. Kermit-80 should be able) 106 W( to run on any 8080-, 8085- or Z80-based microcomputer under)107 W 8280 52306 MT (CP/M with appropriate minor changes to reflect the port I/O and screen control for the system \050see below\051.)SH 8280 54698 MT (The proliferation of new systems supported by Kermit-80 made) 66 W( the program grow so large and complicated that it)65 W 8280 55894 MT (had to be) 138 W( broken up into system-independent and system-dependent modules, as of version 4 \050this was done by)139 W 8280 57090 MT (Charles Carvalho of ACC\051. Each module is composed of multiple files. This has reduced the time and disk) 57 W( space)56 W 8280 58286 MT (necessary for assembly; Kermit-80 may) 126 W( once again be assembled on a CP/M system with roughly 250Kbytes of)127 W 8280 59482 MT (space. The) 302 W( majority of the code does not) 26 W( need to be reassembled to support a new system. Unfortunately, it can no)25 W 8280 60678 MT (longer be assembled with ASM, since ASM does not support multiple input files.) 73 W( To) 398 W( allow it to be assembled on)74 W 8280 61874 MT (any CP/M system,) 103 W( the public-domain assembler LASM is included in the distribution kit. Kermit-80 may also be)102 W 8280 63070 MT (assembled with Microsoft's M80 \050not supplied\051. In theory, any 8080) 33 W( assembler supporting the INCLUDE directive)34 W 8280 64266 MT (ought to work, as well.)SH 8280 66658 MT (All versions of Kermit-80 are) 72 W( assembled from the same set of sources, with system dependencies taken care of by)71 W 8280 67854 MT (assembly-time conditionals within the system-dependent module \050eventually, the system-dependent module) 183 W( will)184 W 8280 69050 MT (itself be broken up into multiple files, one for each system\051. The most important) 45 W( system dependencies are terminal)44 W 8280 70246 MT (emulation \050when CONNECTed to) 153 W( the remote host\051 and screen handling, which are dependent on the individual)154 W 8280 71442 MT (micro's escape codes \050these features are table driven and easily modified for other CP/M) 74 W( systems\051, and the lowest)73 W ES %%Page: 332 333 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 332)SH 12 /Times-Bold AF 29186 XM (Kermit User Guide: CP/M-80 KERMIT \05015.4\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (level I/O routines for the serial communications port. The) 93 W( port routines are best done only with BDOS calls, but)94 W 6120 9082 MT (some systems do not allow this, primarily because the BDOS) 91 W( routines strip the parity bit during port I/O, and the)90 W 6120 10278 MT (parity bit is used for data when transmitting binary files.)SH 6120 12670 MT (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 6120 13866 MT (terminal connection, keyboard interruption of stuck transmissions, etc. On systems that fully) 246 W( implement I/O)245 W 6120 15062 MT (redirection via the optional CP/M IOBYTE facility, this may be done by switching) 127 W( the IOBYTE definition. On)128 W 6120 16258 MT (others, however, IN/OUT instructions explicitly referencing the port device registers must be used.)SH 6120 18650 MT (CP/M-80 KERMIT) 110 W( versions 3.8 and later include a "fuzzy timer" that allows a timeout to occur after an interval)109 W 6120 19846 MT (ranging from 5 to 20 seconds \050depending upon the speed) 32 W( of the processor and the operating system routines\051 during)33 W 6120 21042 MT (which expected input does not appear at the port. In this) 2 W( case, retransmission occurs automatically. In any case, you)1 W 6120 22238 MT (may type a carriage return during transmission to simulate a timeout when the transfer appears to be stuck.)SH 12 /Times-Bold AF 6120 25354 MT (15.4.1. Organization of Kermit-80)SH 10 /Times-Roman AF 6120 27296 MT (Kermit-80 consists of two modules, each of which is generated from multiple source files.) 209 W( The) 669 W( first module)210 W 6120 28492 MT (contains the system-independent code;) 27 W( the second module is configured for a particular system and merged with the)26 W 6120 29688 MT (system-independent module to produce a customized Kermit-80.)SH 6120 32080 MT (The distribution kit contains:)SH /Symbol SF 7910 33985 MT (\267)SH /Times-Roman SF 8620 XM (the system-independent module,)SH /Courier SF 21841 XM (CPSKER.HEX)SH /Times-Roman SF (;)SH /Symbol SF 7910 35090 MT (\267)SH /Times-Roman SF 8620 XM (the system-dependent modules,)SH /Courier SF 21452 XM (CPV*.HEX)SH /Times-Roman SF 26502 XM (\050see table 15-2 and 15-3\051;)SH /Symbol SF 7910 36195 MT (\267)SH /Times-Roman SF 8620 XM (the source files,)SH /Courier SF 15174 XM (CPS*.ASM)SH /Times-Roman SF 20224 XM (and)SH /Courier SF 21918 XM (CPX*.ASM)SH /Times-Roman SF (,)SH /Symbol SF 7910 37300 MT (\267)SH /Times-Roman SF 8620 XM (the public-domain CP/M assembler,)SH /Courier SF 23314 XM (LASM.*)SH /Times-Roman SF (,)SH /Symbol SF 7910 38405 MT (\267)SH /Times-Roman SF 8620 XM (the public-domain CP/M load/patch utility,)SH /Courier SF 26121 XM (MLOAD.*)SH ES %%Page: 333 334 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (15.4.1. Organization of Kermit-80)SH 10 /Times-Italic AF 51275 XM (Page 333)SH 46800 50 8280 5709 UL 46800 50 8280 8086 UL /Courier SF 8280 10167 MT (Symbol Filename) 600 W( System)SH 3600 50 8280 10367 UL 4800 50 13080 10367 UL 3600 50 18480 10367 UL 8280 11854 MT (ACCESS CPVACC)600 W /Times-Roman SF 17880 XM (Access Matrix)SH /Courier SF 8280 12885 MT (ADVANT CPVADV)600 W /Times-Roman SF 17880 XM (Northstar Advantage)SH /Courier SF 8280 13916 MT (AP6551 CPVAPL)600 W /Times-Roman SF 17880 XM (Apple II, Z80 Softcard, 6551 ACIA in serial interface)SH /Courier SF 8280 14947 MT (AP6850 CPVA65)600 W /Times-Roman SF 17880 XM (Apple II, Z80 Softcard, 6850 ACIA in Serial Iiterface)SH /Courier SF 8280 15978 MT (APMMDM CPVAPM)600 W /Times-Roman SF 17880 XM (Apple II, Z80 Softcard, Micromodem II in slot 2)SH /Courier SF 8280 17009 MT (APCPS CPVCPS)1200 W /Times-Roman SF 17880 XM (Apple II, Z80 Softcard, with CPS multifunction card)SH /Courier SF 8280 18040 MT (BASICNS CPVBNS)SH /Times-Roman SF 17880 XM (Northstar Horizon \050terminal required\051)SH /Courier SF 8280 19071 MT (BBC CPVBBC)2400 W /Times-Roman SF 17880 XM (Acorn "BBC" computer with Acorn Z80 second processor)SH /Courier SF 8280 20102 MT (BBII CPVBB2)1800 W /Times-Roman SF 17880 XM (BigBoard II \050terminal required\051)SH /Courier SF 8280 21133 MT (BRAINM CPVBRM)600 W /Times-Roman SF 17880 XM (Intertec Superbrain using the main port)SH /Courier SF 8280 22164 MT (BRAINA CPVBRA)600 W /Times-Roman SF 17880 XM (Intertec Superbrain using the Aux port)SH /Courier SF 8280 23195 MT (CIFER2 CPVCIF)600 W /Times-Roman SF 17880 XM (Cifer 1886 using the VL: Serial port and CP/M V2.2)SH /Courier SF 8280 24226 MT (CIFER3 CPVCI3)600 W /Times-Roman SF 17880 XM (Cifer 1886 using the VL: Serial port and CP/M V3.0)SH /Courier SF 8280 25257 MT (CIFER2 CPVCA2)600 W /Times-Roman SF 17880 XM (Cifer 1886 using the AUX: Serial port and CP/M V2.2)SH /Courier SF 8280 26288 MT (CIFER3 CPVCA3)600 W /Times-Roman SF 17880 XM (Cifer 1886 using the AUX: Serial port and CP/M V3.0)SH /Courier SF 8280 27319 MT (CMEMCO CPVCRO)600 W /Times-Roman SF 17880 XM (Cromemco with TU-ART card. Terminal required\051)SH /Courier SF 8280 28350 MT (COMART CPVCOM)600 W /Times-Roman SF 17880 XM (Comart Communicator \050terminal required\051)SH /Courier SF 8280 29381 MT (COMPRO CPVPRO)600 W /Times-Roman SF 17880 XM (Compupro with Interfacer 4 \050or 3\051. Terminal required.)SH /Courier SF 8280 30412 MT (CPC CPVCPC)2400 W /Times-Roman SF 17880 XM (Amstrad CPC 664 and 6128 and CP/M 3)SH /Courier SF 8280 31443 MT (CPM3 CPVCP3)1800 W /Times-Roman SF 17880 XM ("Generic": CP/M 3.0 \050CP/M Plus\051 systems \050terminal req'd\051)SH /Courier SF 8280 32474 MT (CPT85XX CPVCPT)SH /Times-Roman SF 17880 XM (CPT-85xx wordprocessor with CP/M)SH /Courier SF 8280 33505 MT (DELPHI CPVDEL)600 W /Times-Roman SF 17880 XM (Digicomp Delphi 100 \050terminal required\051)SH /Courier SF 8280 34536 MT (DISC CPVDIS)1800 W /Times-Roman SF 17880 XM (Action Computer Enterprises "Discovery" \050terminal req'd\051)SH /Courier SF 8280 35567 MT (DMII CPVDM2)1800 W /Times-Roman SF 17880 XM (DECmate II with CP/M option)SH /Courier SF 8280 36598 MT (GENER CPVGEN)1200 W /Times-Roman SF 17880 XM ("Generic": CPM 2.2 systems with IOBYTE \050terminal req'd\051)SH /Courier SF 8280 37629 MT (GENIE CPVGNI)1200 W /Times-Roman SF 17880 XM (Video Genie)SH /Courier SF 8280 38660 MT (H8QUAD CPVH8Q)600 W /Times-Roman SF 17880 XM (Heath-8 with Quad 8 i/o board)SH /Courier SF 8280 39691 MT (HEATH CPVH89)1200 W /Times-Roman SF 17880 XM (Heath/Zenith H89)SH /Courier SF 8280 40722 MT (HORIZON CPVHOR)SH /Times-Roman SF 17880 XM (Northstar Horizon \050terminal required\051)SH /Courier SF 8280 41753 MT (KPII CPVKPR)1800 W /Times-Roman SF 17880 XM (Kaypro-II \050and 4; probably supports all Kaypro systems\051)SH /Courier SF 8280 42784 MT (LOBO CPVLBO)1800 W /Times-Roman SF 17880 XM (Lobo Max-80)SH 8280 44575 MT ("symbol" is the symbol used to select the target system, in)SH /Courier SF 31818 XM (CPVTYP.ASM)SH /Times-Roman SF (;)SH 8280 46802 MT ("filename" is the name under which the module is supplied in the distribution.)SH /Times-Bold SF 20764 48412 MT (Table 15-2:)SH /Times-Roman SF 26125 XM (Systems supported by Kermit-80 \050Part 1\051)SH 46800 50 8280 50222 UL ES %%Page: 334 335 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 334)SH 12 /Times-Bold AF 28286 XM (Kermit User Guide: CP/M-80 KERMIT \05015.4.1\051)SH 46800 50 6120 5709 UL 46800 50 6120 8086 UL 10 /Courier AF 6120 10167 MT (Symbol Filename) 600 W( System)SH 3600 50 6120 10367 UL 4800 50 10920 10367 UL 3600 50 16320 10367 UL 6120 11854 MT (M2215 CPVMRL)1200 W /Times-Roman SF 15720 XM (British Telecom Merlin/Rair Black Box \050terminal required\051)SH /Courier SF 6120 12885 MT (MDI CPVMDI)2400 W /Times-Roman SF 15720 XM (Morrow Decision I \050terminal required\051)SH /Courier SF 6120 13916 MT (MIKKO CPVMIK)1200 W /Times-Roman SF 15720 XM (MikroMikko)SH /Courier SF 6120 14947 MT (MMATE CPVMM)1200 W /Times-Roman SF 15720 XM (PMC 101 Micromate \050terminal required\051)SH /Courier SF 6120 15978 MT (MMDI CPVUD)1800 W /Times-Roman SF 15720 XM (Morrow Micro Decision I \050terminal required\051)SH /Courier SF 6120 17009 MT (NCRDMV CPVDMV)600 W /Times-Roman SF 15720 XM (NCR Decision Mate V. \050Terminal required?\051)SH /Courier SF 6120 18040 MT (NORTHS CPVNS)600 W /Times-Roman SF 15720 XM (Northstar Horizon with HSIO-4 card \050terminal req'd\051)SH /Courier SF 6120 19071 MT (OSBRN1 CPVOSB)600 W /Times-Roman SF 15720 XM (Osborne 1)SH /Courier SF 6120 20102 MT (OSI CPVOSI)2400 W /Times-Roman SF 15720 XM (Ohio Scientific)SH /Courier SF 6120 21133 MT (PCI2651 CPVPCI)SH /Times-Roman SF 15720 XM (Ithaca Intersystems with VI0 card \050terminal required\051)SH /Courier SF 6120 22164 MT (PCW CPVPCW)2400 W /Times-Roman SF 15720 XM (Amstrad PCW 8256/8512 with serial interface)SH /Courier SF 6120 23195 MT (PX8 CPVPX8)2400 W /Times-Roman SF 15720 XM (Epson PX-8)SH /Courier SF 6120 24226 MT (RM380ZM CPVRMM)SH /Times-Roman SF 15720 XM (Research Machines 380Z with MDS \0505.25" discs\051)SH /Courier SF 6120 25257 MT (RM380ZF CPVRMF)SH /Times-Roman SF 15720 XM (Research Machines 380Z with FDS \0508" discs\051)SH /Courier SF 6120 26288 MT (ROBIN CPVROB)1200 W /Times-Roman SF 15720 XM (DEC VT180)SH /Courier SF 6120 27319 MT (S1008 CPVUSM)1200 W /Times-Roman SF 15720 XM (US Microsales S-100-8 \050terminal required\051)SH /Courier SF 6120 28350 MT (SANYO CPVSAN)1200 W /Times-Roman SF 15720 XM (Sanyo MBC-1100)SH /Courier SF 6120 29381 MT (SB6 CPVSB6)2400 W /Times-Roman SF 15720 XM (Micromint SB-180 with 6Mhz CPU \050terminal required\051)SH /Courier SF 6120 30412 MT (SB9 CPVSB9)2400 W /Times-Roman SF 15720 XM (Micromint SB-180 with 9Mhz CPU \050terminal required\051)SH /Courier SF 6120 31443 MT (SCNTPR CPVSCN)600 W /Times-Roman SF 15720 XM (Screentyper)SH /Courier SF 6120 32474 MT (TELCON CPVTEL)600 W /Times-Roman SF 15720 XM (TELCON Zobra portable)SH /Courier SF 6120 33505 MT (TELETEK CPVTET)SH /Times-Roman SF 15720 XM (Teletek Systemaster)SH /Courier SF 6120 34536 MT (TORCH CPVTRC)1200 W /Times-Roman SF 15720 XM (Torch computers BBC-B with Z80 second processors)SH /Courier SF 6120 35567 MT (TRS80LB CPVTLB)SH /Times-Roman SF 15720 XM (TRS-80 model II with Lifeboat 2.25C CP/M Display)SH /Courier SF 6120 36598 MT (TRS80PT CPVTPT)SH /Times-Roman SF 15720 XM (TRS-80 model II with Pickles + Trout CP/M Display)SH /Courier SF 6120 37629 MT (TRSM4 CPVTM4)1200 W /Times-Roman SF 15720 XM (TRS-80 model IV)SH /Courier SF 6120 38660 MT (VECTOR CPVVEC)600 W /Times-Roman SF 15720 XM (Vector Graphics)SH /Courier SF 6120 39691 MT (XER820 CPVXER)600 W /Times-Roman SF 15720 XM (Xerox 820)SH /Courier SF 6120 40722 MT (Z100 CPVZ00)1800 W /Times-Roman SF 15720 XM (Z-100 under CP/M-85)SH /Courier SF 6120 41753 MT (Z80MU CPVZ80)1200 W /Times-Roman SF 15720 XM (Z80MU development system on a PC)SH 6120 43544 MT ("symbol" is the symbol used to select the target system, in)SH /Courier SF 29658 XM (CPXTYP.ASM)SH /Times-Roman SF (;)SH 6120 45771 MT ("filename" is the name under which the module is supplied in the distribution.)SH /Times-Bold SF 18604 47381 MT (Table 15-3:)SH /Times-Roman SF 23965 XM (Systems supported by Kermit-80 \050Part 2\051)SH 46800 50 6120 49191 UL ES %%Page: 335 336 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (15.4.1. Organization of Kermit-80)SH 10 /Times-Italic AF 51275 XM (Page 335)SH 46800 50 8280 5709 UL 46800 50 8280 8086 UL /Courier SF 8280 10167 MT (Symbol Terminal) 600 W( type)SH 3600 50 8280 10367 UL 4800 50 13080 10367 UL 2400 50 18480 10367 UL 8280 11854 MT (CRT)SH /Times-Roman SF 13080 XM (Dumb terminal type. Does not do cursor addressing)SH /Courier SF 8280 12885 MT (ADM3A)SH /Times-Roman SF 13080 XM (Lear Seigler ADM 3A)SH /Courier SF 8280 13916 MT (ADM22)SH /Times-Roman SF 13080 XM (Lear Seigler ADM 22)SH /Courier SF 8280 14947 MT (AM230)SH /Times-Roman SF 13080 XM (Ampro 230)SH /Courier SF 8280 15978 MT (H1500)SH /Times-Roman SF 13080 XM (Hazeltine 1500)SH /Courier SF 8280 17009 MT (SMRTVD)SH /Times-Roman SF 13080 XM (Netronics Smartvid)SH /Courier SF 8280 18040 MT (SOROQ)SH /Times-Roman SF 13080 XM (Soroq IQ-120)SH /Courier SF 8280 19071 MT (TVI912)SH /Times-Roman SF 13080 XM (Televideo 912)SH /Courier SF 8280 20102 MT (TVI925)SH /Times-Roman SF 13080 XM (Televideo 925 or Freedom 100)SH /Courier SF 8280 21133 MT (VT52)SH /Times-Roman SF 13080 XM (Dec VT52 or equivalent \050H19\051)SH /Courier SF 8280 22164 MT (VT100)SH /Times-Roman SF 13080 XM (Dec VT100 or equivalent)SH /Courier SF 8280 23195 MT (WYSE)SH /Times-Roman SF 13080 XM (Wyse 100)SH 8280 24986 MT ("symbol" is the symbol used to select the target system, in)SH /Courier SF 31818 XM (CPXTYP.ASM)SH /Times-Roman SF (;)SH 8280 27213 MT ("Terminal type" is the type of terminal "symbol" selects.)SH /Times-Bold SF 22042 28823 MT (Table 15-4:)SH /Times-Roman SF 27403 XM (Terminals supported by Kermit-80)SH 46800 50 8280 30633 UL 12 /Times-Bold AF 8280 33549 MT (15.4.2. Downloading Kermit-80)SH 10 /Times-Roman AF 8280 35491 MT (You'll need either a pre-configured)4 W /Courier SF 22712 XM (.COM)SH /Times-Roman SF 25367 XM (file or the system-independent module,)5 W /Courier SF 41279 XM (CPSKER)SH /Times-Roman SF (, in binary \050)5 W /Courier SF (.COM)SH /Times-Roman SF (\051 or hex)5 W 8280 36687 MT (\050)SH /Courier SF (.HEX)SH /Times-Roman SF (\051 format and the system-dependent overlay for your system \050from Tables 15-2) 74 W( and 15-3\051. If your system is)73 W 8280 37883 MT (not listed in the table, get the generic CP/M 2)138 W /Courier SF (.)SH /Times-Roman SF (2 Kermit or the generic CP/M 3 Kermit. If you) 138 W( already have a)139 W 8280 39079 MT (version of Kermit on your micro and you want to) 68 W( install a new version, simply use your present version to get the)67 W 8280 40275 MT (new files. Transfer the files to your system and skip ahead to "merging the modules".)SH 8280 42667 MT (If you do) 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 8280 43863 MT (to a mainframe computer with a copy of the Kermit-80 distribution, you should read this section.)SH 8280 46255 MT (There are several ways to get CP/M Kermit) 106 W( from a host system to your micro. The easiest is to "download" the)105 W 8280 47451 MT (necessary "hex" files into your micro's memory and then save them on the disk.) 84 W( If) 419 W( you have a terminal emulator)85 W 8280 48647 MT (program on your micro which can save a copy of the session to disk, connect to your host, and type) 69 W( the necessary)68 W 8280 49843 MT (files. Exit) 316 W( from the emulator, saving) 33 W( the session log, and edit the session log to extract the hex files. Skip ahead to)34 W 8280 51039 MT ("merging the files".)SH 8280 53431 MT (The following is a procedure which, though far from foolproof, should allow you to get a version of Kermit to your)32 W 8280 54627 MT (CP/M based micro. It depends upon the host prompt, or at least the first character of the host) 62 W( prompt, being some)63 W 8280 55823 MT (character that cannot appear in a hex) 58 W( file \050the valid characters for hex files are the digits 0-9, the upper case letters)57 W 8280 57019 MT (A-F, the colon ``)55 W /Courier SF (:)SH /Times-Roman SF ('', carriage return, and line feed\051. As soon the prompt character is encountered, the transfer) 55 W( will)56 W 8280 58215 MT (terminate. If) 288 W( your host) 19 W( does not issue a prompt that will accommodate this scheme, you can achieve the same effect)18 W 8280 59411 MT (by adding an atsign ``@'' to the very end of the hex file before sending it from the host. The) 36 W( program below looks)37 W 8280 60607 MT (for an atsign \050the normal DEC-20 prompt, hex 40\051. DECSYSTEM-10 users would) 241 W( look for a dot, hex 2E;)240 W 8280 61803 MT (VAX/VMS or UNIX users would look for a dollar sign, hex 24; UNIX C-Shell users would look) 29 W( for a percent sign,)30 W 8280 62999 MT (hex 26.)SH 10280 64790 MT (1.)SH 11280 XM (For CP/M 2)44 W /Courier SF (.)SH /Times-Roman SF (2 systems, connect to a floppy disk with plenty) 44 W( of free space. Run DDT and type in the)43 W 11280 65895 MT (following \050the comments should not be typed in; they are there just to tell you what's happening\051:)137 W 11280 67000 MT (\050Note that this wont work for CP/M Plus or 3)SH /Courier SF (.)SH /Times-Roman SF (0 systems!\051)SH 46800 50 8280 68917 UL /Courier SF 8280 70416 MT (-a100 ;Begin) 10800 W( assembling code at 100)SH 11280 71447 MT (0100 LXI) 1800 W( H,2FE) SH( ;Where) 3600 W( to store in memory)SH ES %%Page: 336 337 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 336)SH 12 /Times-Bold AF 28286 XM (Kermit User Guide: CP/M-80 KERMIT \05015.4.2\051)SH 46800 50 6120 5709 UL 10 /Courier AF 9120 7824 MT (0103 SHLD) 1800 W( 200) SH( ;Keep) 4200 W( pointer there)SH 9120 8855 MT (0106 MVI) 1800 W( E,D) SH( ;Get) 4800 W( a CR)SH 9120 9886 MT (0108 MVI) 1800 W( C,4) SH( ;Output) 4800 W( to PUNCH \050send to HOST\051)SH 9120 10917 MT (010A CALL) 1800 W( 5)SH 9120 11948 MT (010D MVI) 1800 W( C,3) SH( ;Input) 4800 W( from READER \050read from HOST\051)SH 9120 12979 MT (010F CALL) 1800 W( 5)SH 9120 14010 MT (0112 ANI) 1800 W( 7F) SH( ;Strip) 5400 W( parity bit)SH 9120 15041 MT (0114 PUSH) 1800 W( PSW) SH( ;Save) 4200 W( a and flags)SH 9120 16072 MT (0115 MOV) 1800 W( E,A) SH( ;Move) 4800 W( char to E for echo)SH 9120 17103 MT (0116 MVI) 1800 W( C,2) SH( ;Output) 4800 W( to screen)SH 9120 18134 MT (0118 CALL) 1800 W( 5)SH 9120 19165 MT (011B POP) 1800 W( PSW) SH( ;Restore) 4800 W( A and flags)SH 9120 20196 MT (011C CPI) 1800 W( 40) SH( ;\050or) 5400 W( 4E,24,26,etc\051 System prompt?)SH 9120 21227 MT (011E JZ) 1800 W( 127) SH( ;Yes,) 5400 W( have whole file in memory)SH 9120 22258 MT (0121 CALL) 1800 W( 17A) SH( ;No,) 4200 W( store another byte)SH 9120 23289 MT (0124 JMP) 1800 W( 10D) SH( ;Read) 4800 W( another byte)SH 9120 24320 MT (0127 MVI) 1800 W( A,1A) SH( ;Get) 4200 W( a Control-Z \050CP/M EOF mark\051)SH 9120 25351 MT (0129 CALL) 1800 W( 17A) SH( ;Store) 4200 W( it in memory)SH 9120 26382 MT (012C LXI) 1800 W( H,300) SH( ;Get) 3600 W( memory pointer)SH 9120 27413 MT (012F SHLD) 1800 W( 202) SH( ;Store) 4200 W( as DMA pointer)SH 9120 28444 MT (0132 LDA) 1800 W( 201) SH( ;Get) 4800 W( 'HI' byte of memory pointer)SH 9120 29475 MT (0135 STA) 1800 W( 200) SH( ;and) 4800 W( store it as 'LO' one)SH 9120 30506 MT (0138 XRA) 1800 W( A)SH 9120 31537 MT (0139 STA) 1800 W( 201) SH( ;Zero) 4800 W( 'HI' byte \050slow *256\051)SH 9120 32568 MT (013C MVI) 1800 W( C,16) SH( ;Make) 4200 W( NEW file)SH 9120 33599 MT (013E LXI) 1800 W( D,5C) SH( ;With) 4200 W( FCB1)SH 9120 34630 MT (0141 CALL) 1800 W( 5)SH 9120 35661 MT (0144 CALL) 1800 W( 15E) SH( ;Write) 4200 W( 128 bytes \050sector\051)SH 9120 36692 MT (0147 CALL) 1800 W( 15E) SH( ;Write) 4200 W( another sector)SH 9120 37723 MT (014A LXI) 1800 W( H,FFFF) SH( ;Get) 3000 W( a 16-bit Minus One)SH 9120 38754 MT (014D XCHG) 1800 W( ;into) 6600 W( DE)SH 9120 39785 MT (014E LHLD) 1800 W( 200) SH( ;Get) 4200 W( 256-byte counter)SH 9120 40816 MT (0151 DAD) 1800 W( D) SH( ;Decrement)6000 W 9120 41847 MT (0152 SHLD) 1800 W( 200) SH( ;and) 4200 W( store back)SH 9120 42878 MT (0155 MVI) 1800 W( A,2) SH( ;Check) 4800 W( if)SH 9120 43909 MT (0157 CMP) 1800 W( L) SH( ;) 6000 W( 256-byte counter down to offset)SH 9120 44940 MT (0158 JZ) 1800 W( 183) SH( ;Yes,) 5400 W( we're done)SH 9120 45971 MT (015B JMP) 1800 W( 144) SH( ;Keep) 4800 W( writing..)SH 9120 47002 MT (015E LHLD) 1800 W( 202) SH( ;Get) 4200 W( file-pointer)SH 9120 48033 MT (0161 XCHG) 1800 W( ;into) 6600 W( DE)SH 9120 49064 MT (0162 MVI) 1800 W( C,1A) SH( ;Set) 4200 W( DMA-address)SH 9120 50095 MT (0164 CALL) 1800 W( 5)SH 9120 51126 MT (0167 MVI) 1800 W( C,15) SH( ;Write) 4200 W( sector \050128 bytes\051)SH 9120 52157 MT (0169 LXI) 1800 W( D,5C) SH( ;using) 4200 W( FCB1)SH 9120 53188 MT (016C CALL) 1800 W( 5)SH 9120 54219 MT (016F LHLD) 1800 W( 202) SH( ;Get) 4200 W( file-pointer)SH 9120 55250 MT (0172 LXI) 1800 W( D,80) SH( ;128-bytes)4200 W 9120 56281 MT (0175 DAD) 1800 W( D) SH( ;added) 6000 W( to file-pointer)SH 9120 57312 MT (0176 SHLD) 1800 W( 202) SH( ;and) 4200 W( save)SH 9120 58343 MT (0179 RET) 1800 W( ;and) 7200 W( return)SH 9120 59374 MT (017A LHLD) 1800 W( 200) SH( ;Get) 4200 W( Memory-pointer)SH 9120 60405 MT (017D MOV) 1800 W( M,A) SH( ;Store) 4800 W( character)SH 9120 61436 MT (017E INX) 1800 W( H) SH( ;Increment) 6000 W( Pointer)SH 9120 62467 MT (017F SHLD) 1800 W( 200) SH( ;and) 4200 W( save)SH 9120 63498 MT (0182 RET) 1800 W( ;and) 7200 W( return)SH 9120 64529 MT (0183 MVI) 1800 W( C,10) SH( ;CLOSE) 4200 W( file)SH 9120 65560 MT (0185 LXI) 1800 W( D,5C) SH( ;using) 4200 W( FCB1)SH 9120 66591 MT (0188 CALL) 1800 W( 5)SH 9120 67622 MT (018B JMP) 1800 W( 0) SH( ;Force) 6000 W( WARM BOOT)SH 9120 68653 MT (0179)SH 9120 69684 MT (-^C ;\050Type) 12000 W( Control-C\051 Return to CP/M)SH 9120 70715 MT (A>SAVE 1 FETCH.COM) SH( ;Save) 3000 W( program, we need to run it twice.)SH ES %%Page: 337 338 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (15.4.2. Downloading Kermit-80)SH 10 /Times-Italic AF 51275 XM (Page 337)SH 46800 50 8280 5709 UL /Times-Bold SF 17501 7886 MT (Figure 15-1:)SH /Times-Roman SF 23250 XM (Bootstrap program for Kermit-80 and CP/M Version 2.2)SH 46800 50 8280 9696 UL 11280 11213 MT (Alternatively, an assembler source file for this program is distributed with) 374 W( CP/M Kermit as)373 W /Courier SF 11280 12318 MT (CPKFET.ASM)SH /Times-Roman SF (. You) 478 W( might prefer to type the assembler) 114 W( version in and assemble and load it \050ASM)115 W 11280 13423 MT (CPKFET, LOAD CPKFET, or MASM CPKFET,) 43 W( MLOAD CPKFET\051, to let the assembler and loader)42 W 11280 14528 MT (catch any typing errors.)SH 10280 16738 MT (2.)SH 11280 XM (Connect to your host using a terminal or a terminal emulation program. Ensure that your host does) 6 W( not)7 W 11280 17843 MT (have your terminal in "page mode" \050does not pause at the end of each screenful\051.)SH 10280 20053 MT (3.)SH 11280 XM (Tell the host to display the first hex file \050the) 38 W( system-independent module\051 at your terminal, e.g. give a)37 W 11280 21158 MT (command like)SH /Courier SF 17224 XM (TYPE CPSKER.HEX)SH /Times-Roman SF (,)SH /Times-Italic SF 26724 XM (without a terminating carriage return)SH /Times-Roman SF (.)SH 3001 50 26724 21358 UL 10280 23368 MT (4.)SH 11280 XM (Return to your micro by switching the cable from the terminal to the micro, or by terminating) 142 W( the)143 W 11280 24473 MT (micro's terminal program.)SH 10280 26683 MT (5.)SH 11280 XM (Make sure your IOBYTE is set so that)17 W /Courier SF 27024 XM (RDR:)SH /Times-Roman SF 29690 XM (and)SH /Courier SF 31400 XM (PUN:)SH /Times-Roman SF 34066 XM (correspond to the I/O port that is connected to)16 W 11280 27788 MT (the host \050this would normally be the case unless you have done something special to change things\051.)SH 10280 29998 MT (6.)SH 11280 XM (Load the program you entered in the first step with DDT, and use it to capture the first hex file:)SH /Courier SF 13680 31653 MT (DDT FETCH.COM)SH 13680 32684 MT (-icpsker.hex ;Setup) 6600 W( FCB for file CPSKER.HEX)SH 13680 33715 MT (-g100,179 ;Execute) 8400 W( the program.)SH /Times-Roman SF 11280 35432 MT (Now there should be a file)SH /Courier SF 22111 XM (CPSKER.HEX)SH /Times-Roman SF 28361 XM (on your connected disk.)SH 10280 37642 MT (7.)SH 11280 XM (Return to the host, and tell it) 112 W( to display the second hex file \050the system-dependent module for your)113 W 11280 38747 MT (configuration\051. Again,) 250 W( do not type the terminating carriage return.)SH 10280 40957 MT (8.)SH 11280 XM (Return to your micro, and run the capture program again:)SH /Courier SF 13680 42612 MT (DDT FETCH.COM)SH 13680 43643 MT (-icpxovl.hex ;Setup) 6600 W( FCB to create CPXOVL.HEX)SH 13680 44674 MT (-g100,179 ;Execute) 8400 W( the program.)SH /Times-Roman SF 11280 46391 MT (Now there should be a file)132 W /Courier SF 22903 XM (CPXOVL.HEX)SH /Times-Roman SF 29284 XM (on your connected disk. Replace)131 W /Courier SF 43595 XM (CPXOVL.HEX)SH /Times-Roman SF 49976 XM (in this)131 W 11280 47496 MT (example with the appropriate overlay file for your system.)SH 8280 49287 MT (Merging the files:)SH 10280 51078 MT (1.)SH 11280 XM (For purposes of illustration, we will assume the system-dependent overlay is called "cpxovl)162 W /Courier SF (.)SH /Times-Roman SF (hex".)SH 11280 52183 MT (The two hex) 1 W( files may be combined with MLOAD or DDT. If you already have a running Kermit, you)SH 11280 53288 MT (can transfer)208 W /Courier SF 16638 XM (MLOAD.HEX)SH /Times-Roman SF 22497 XM (to your system and create)209 W /Courier SF 34012 XM (MLOAD.COM)SH /Times-Roman SF 39871 XM (by running LOAD. If you're)209 W 11280 54393 MT (bootstrapping Kermit, you could transfer)27 W /Courier SF 28024 XM (MLOAD.HEX)SH /Times-Roman SF 33701 XM (to your system the same way you got the) 27 W( other)26 W 11280 55498 MT (two)SH /Courier SF 13070 XM (.HEX)SH /Times-Roman SF 15761 XM (files, but it's probably simpler to use DDT to get Kermit running, and get MLOAD later if)41 W 11280 56603 MT (you need it.)SH 10280 58813 MT (2.)SH 11280 XM (Using MLOAD, the two pieces may be easily merged:)SH /Courier SF 13680 60468 MT (A>mload kermit49=cpsker,cpxovl)SH 16800 50 14880 60668 UL /Times-Italic SF 13680 61499 MT (\050Some messages about program size, etc...\051)SH /Courier SF 13680 62530 MT (A>)SH /Times-Roman SF 10280 64740 MT (3.)SH 11280 XM (If you don't have MLOAD running, it's a bit more complex:)SH /Courier SF 13680 66395 MT (A>ddt cpsker.hex)SH 8400 50 14880 66595 UL 13680 67426 MT (NEXT PC)600 W 13680 68457 MT (3500 0100)SH 13680 69488 MT (-icpxovl.hex)SH 6600 50 14280 69688 UL 13680 70519 MT (-r)SH 600 50 14280 70719 UL 13680 71550 MT (NEXT PC)600 W ES %%Page: 338 339 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 338)SH 12 /Times-Bold AF 28286 XM (Kermit User Guide: CP/M-80 KERMIT \05015.4.2\051)SH 46800 50 6120 5709 UL 10 /Courier AF 11520 7824 MT (xxxx 0000)SH 11520 8855 MT (-^C)SH 1200 50 12120 9055 UL 11520 9886 MT (A>save)SH /Times-Italic SF 15720 XM (dd)SH /Courier SF 17320 XM (kermit49.com)SH 11800 50 12720 10086 UL /Times-Roman SF 9120 11603 MT (The page count) 50 W( \050"dd"\051 used in the SAVE command is calculated from the last address \050"xxxx"\051 given)49 W 9120 12708 MT (by DDT in) 48 W( response to the R command: drop the last two digits and add 1 if they were not zero, then)49 W 9120 13813 MT (convert from hexadecimal \050base 16\051 to decimal \050base 10\051: 684F) 11 W( becomes 69 hex, which is 105 decimal)10 W 9120 14918 MT (\0505 times 16 plus 9\051) 89 W( -- but 6700 becomes 67 hex, or 103 decimal \050consult an introductory computing)90 W 9120 16023 MT (book if you don't understand number base conversion\051.)SH 8120 18233 MT (4.)SH 9120 XM (If you are using the Z80MU) 53 W( CP/M and Z80 development toolkit on an IBM PC or clone, then follow)52 W 9120 19338 MT (the same instructions as for a genuine CP/M system. When you have loaded your file, you will) 57 W( have)58 W 9120 20443 MT (to ship the .COM or two .HEX files to the target CP/M system. \050Possibly) 108 W( using a previous issue of)107 W 9120 21548 MT (Kermit?\051)SH 8120 23758 MT (5.)SH 9120 XM (Note that CP/M hex files have checksums on each line. If there were any transmission) 67 W( errors during)68 W 9120 24863 MT (the downloading process, MLOAD or DDT will) 210 W( notice a bad checksum and will report an error)209 W 9120 25968 MT (\050something like "Illegal Format"\051. If you get any errors during loading, either fix the hex) 63 W( file locally)64 W 9120 27073 MT (with an editor, or repeat the transfer.)SH 6120 29465 MT (You now should have a running version of Kermit-80, called)SH /Courier SF 30755 XM (KERMIT49.COM)SH /Times-Roman SF (.)SH 6120 31857 MT (Test your new Kermit by running it. If) 96 W( it gives you a prompt, it might be OK. \050don't delete your old one yet...\051.)95 W 6120 33053 MT (Instead of a prompt, you could get one of two messages indicating that the configuration information is invalid:)SH /Courier SF 8520 34708 MT (?Kermit has not been configured for a target system)SH /Times-Roman SF 6120 36425 MT (or)SH /Courier SF 8520 38080 MT (?Consistency check on configuration failed)SH /Times-Roman SF 6120 39797 MT (Of course, neither of these messages should appear) 109 W( if you're building Kermit from the distribution kit. The first)110 W 6120 40993 MT (message indicates that) 1 W( the overlay was not found where the system-independent module expected to find it, probably)SH 6120 42189 MT (because the overlay address is incorrect; the second indicates that the version of CPXLNK used in the system-)157 W 6120 43385 MT (dependent module is incompatible with the system-independent module.)SH 6120 45777 MT (Once you are satisfied that KERMIT40 works correctly, you should rename your old)76 W /Courier SF 41324 XM (KERMIT.COM)SH /Times-Roman SF 47650 XM (to something)75 W 6120 46973 MT (else, like)SH /Courier SF 9925 XM (OKERMIT.COM)SH /Times-Roman SF (, and rename)SH /Courier SF 21912 XM (KERMIT40.COM)SH /Times-Roman SF 29362 XM (to)SH /Courier SF 30390 XM (KERMIT.COM)SH /Times-Roman SF (.)SH 12 /Times-Bold AF 6120 50089 MT (15.4.3. Assembling Kermit-80 from the sources)SH 10 /Times-Roman AF 6120 52031 MT (Kermit-80 is built in two pieces from the following files:)SH /Times-Italic SF 6120 53820 MT (The system-independent files:)SH /Courier SF 7320 54925 MT (CPSKER.ASM)SH /Times-Roman SF 14120 XM (header file)SH /Courier SF 7320 56030 MT (CPSDEF.ASM)SH /Times-Roman SF 14120 XM (definitions for both KERMIT and KERSYS)SH /Courier SF 7320 57135 MT (CPSMIT.ASM)SH /Times-Roman SF 14120 XM (initialization, main loop, miscellaneous commands \050BYE, EXIT, LOG, SET,) 30 W( SHOW, STATUS,)31 W 14120 58240 MT (and VERSION\051)SH /Courier SF 7320 59345 MT (CPSCOM.ASM)SH /Times-Roman SF 14120 XM (second part of commands, status and set file)SH /Courier SF 7320 60450 MT (CPSPK1.ASM)SH /Times-Roman SF 14120 XM (part 1 of the KERMIT protocol handler \050SEND, RECEIVE, LOGOUT,and FINISH commands\051)SH /Courier SF 7320 61555 MT (CPSPK2.ASM)SH /Times-Roman SF 14120 XM (part 2 of the KERMIT protocol handler)SH /Courier SF 7320 62660 MT (CPSREM.ASM)SH /Times-Roman SF 14120 XM (REMOTE routines \050FINISH, BYE and LOGOUT in CPXPK*.ASM\051)SH /Courier SF 7320 63765 MT (CPSSER.ASM)SH /Times-Roman SF 14120 XM (SERVER routines \050for the future\051)SH /Courier SF 7320 64870 MT (CPSTT.ASM)SH /Times-Roman SF 14120 XM (the transparent commands \050TRANSMIT, CONNECT\051)SH /Courier SF 7320 65975 MT (CPSCPM.ASM)SH /Times-Roman SF 14120 XM (CP/M commands \050DIR, ERA, USER, TYPE, PRINT, COPY\051)SH /Courier SF 7320 67080 MT (CPSWLD.ASM)SH /Times-Roman SF 14120 XM (the wildcard handler)SH /Courier SF 7320 68185 MT (CPSCMD.ASM)SH /Times-Roman SF 14120 XM (the command parser)SH /Courier SF 7320 69290 MT (CPSUTL.ASM)SH /Times-Roman SF 14120 XM (utility routines and data)SH /Courier SF 7320 70395 MT (CPSDAT.ASM)SH /Times-Roman SF 14120 XM (data space and the overlay definitions)SH /Courier SF 7320 71500 MT (CPXLNK.ASM)SH /Times-Roman SF 14120 XM (linkage area description)SH ES %%Page: 339 340 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (15.4.3. Assembling Kermit-80 from the sources)SH 10 /Times-Italic AF 51275 XM (Page 339)SH 46800 50 8280 5709 UL 8280 9410 MT (The system-dependent files:)SH /Courier SF 9480 10515 MT (CPXTYP.ASM)SH /Times-Roman SF 16280 XM (system selection)SH /Courier SF 9480 11620 MT (CPXLNK.ASM)SH /Times-Roman SF 16280 XM (system overlay specification and jump table)SH /Courier SF 9480 12725 MT (CPXCOM.ASM)SH /Times-Roman SF 16280 XM (common routines for all systems)SH /Courier SF 9480 13830 MT (CPXSWT.ASM)SH /Times-Roman SF 16280 XM (system selector or switcher)SH 8280 16259 MT (One of:)SH /Courier SF 9480 17364 MT (CPXSYS.ASM)SH /Times-Roman SF 16280 XM (family file for some system-specific code)SH /Courier SF 9480 18469 MT (CPXTOR.ASM)SH /Times-Roman SF 16280 XM (family file for Torch, Superbrain, PCI2651 etc)SH /Courier SF 9480 19574 MT (CPXNOR.ASM)SH /Times-Roman SF 16280 XM (family file for Northstar and Comart machines)SH /Courier SF 9480 20679 MT (CPXMRL.ASM)SH /Times-Roman SF 16280 XM (family file for British Telecom merlin/Rair Black Box)SH /Courier SF 9480 21784 MT (CPXSB.ASM)SH /Times-Roman SF 16280 XM (family file for Micromint SB-180 systems)SH /Courier SF 9480 22889 MT (CPXCIF.ASM)SH /Times-Roman SF 16280 XM (family file for Cifer systems)SH /Courier SF 9480 23994 MT (CPXHEA.ASM)SH /Times-Roman SF 16280 XM (family file for Heath/Zenith systems)SH /Courier SF 9480 25099 MT (CPXAPP.ASM)SH /Times-Roman SF 16280 XM (family file for Apple II systems)SH /Courier SF 9480 26204 MT (CPXPCW.ASM)SH /Times-Roman SF 16280 XM (family file for Amstrad PCW 8256/8512 machines)SH /Courier SF 9480 27309 MT (CPXBBI.ASM)SH /Times-Roman SF 16280 XM (family file for BigBoard, Kaypro and Xerox 820 systems)SH /Courier SF 9480 28414 MT (CPXSYO.ASM)SH /Times-Roman SF 16280 XM (family file for Sanyo MBS-1100 systems)SH /Courier SF 9480 29519 MT (CPXTM4.ASM)SH /Times-Roman SF 16280 XM (family file for Tandy Model 4 with CP/M systems)SH /Courier SF 9480 30624 MT (CPXGNI.ASM)SH /Times-Roman SF 16280 XM (family file for Video Genie systems)SH /Courier SF 9480 31729 MT (CPXPRO.ASM)SH /Times-Roman SF 16280 XM (family file for Compupro systems)SH /Courier SF 9480 32834 MT (CPXZ80.ASM)SH /Times-Roman SF 16280 XM (family file for the Z80MU development system)SH 8280 35263 MT (and if you use a terminal,)SH /Courier SF 9480 36368 MT (CPXVDU.ASM)SH /Times-Roman SF 16280 XM (display codes for VDUs etc. Not always required)SH 8280 38159 MT (The system-independent module contains all of the system-independent files) 135 W( except for)134 W /Courier SF 44951 XM (CPXLNK.ASM)SH /Times-Roman SF (, which is)134 W 8280 39355 MT (assembled into the system-dependent module to provide the structures needed to connect the) 156 W( two modules. As)157 W 8280 40551 MT (distributed, the system-independent module is named)28 W /Courier SF 30030 XM (CPSKER.HEX)SH /Times-Roman SF (. If) 306 W( you have a) 28 W( copy of)27 W /Courier SF 45776 XM (CPSKER.HEX)SH /Times-Roman SF (, you do)27 W 8280 41747 MT (not need to reassemble the system-independent module to configure Kermit for your system.)SH 8280 44139 MT (The system-dependent module consists of)503 W /Courier SF 27821 XM (CPXTYP.ASM)SH /Times-Roman SF (,)SH /Courier SF 34824 XM (CPSDEF.ASM)SH /Times-Roman SF (,)SH /Courier SF 41827 XM (CPXLNK.ASM)SH /Times-Roman SF (,)SH /Courier SF 48830 XM (CPXSWT.ASM)SH /Times-Roman SF (,)SH /Courier SF 8280 45335 MT (CPSCOM.ASM)SH /Times-Roman SF (, one of) 675 W( the family files)674 W /Courier SF 27908 XM (CPXSYS.ASM)SH /Times-Roman SF (,)SH /Courier SF 35082 XM (CPXTOR.ASM)SH /Times-Roman SF (,)SH /Courier SF 42256 XM (CPXMRL.ASM)SH /Times-Roman SF (,)SH /Courier SF 49430 XM (CPXSB.ASM)SH /Times-Roman SF (,)SH /Courier SF 8280 46531 MT (CPXCIF.ASM)SH /Times-Roman SF (,)SH /Courier SF 15038 XM (CPXHEA.ASM)SH /Times-Roman SF (,)SH /Courier SF 21796 XM (CPXBBI.ASM)SH /Times-Roman SF (,)SH /Courier SF 28554 XM (CPXTM4.ASM)SH /Times-Roman SF (,)SH /Courier SF 35312 XM (CPXGNI.ASM)SH /Times-Roman SF (,)SH /Courier SF 42071 XM (CPXNOR.ASM)SH /Times-Roman SF (,)SH /Courier SF 48830 XM (CPXAPP.ASM)SH /Times-Roman SF (,)SH /Courier SF 8280 47727 MT (CPXPCW.ASM)SH /Times-Roman SF (, or)23 W /Courier SF 15909 XM (CPXPRO.ASM)SH /Times-Roman SF (, and possibly)23 W /Courier SF 27756 XM (CPXVDU.ASM)SH /Times-Roman SF (, if your) 23 W( system uses a terminal for the console. One)22 W 8280 48923 MT (copy of the) 1 W( system-dependent module is supplied already assembled for each supported system; the filename may be)2 W 8280 50119 MT (obtained from tables 15-2 and 15-3. If a terminal is required for a system, a CRT \050glass TTY) 122 W( device\051 has been)121 W 8280 51315 MT (selected.)SH 8280 53707 MT (After assembling the two pieces separately, they are combined with DDT or MLOAD into a system-specific Kermit.)SH 8280 56099 MT (If you want to rebuild the system-independent module, the only change you may) 159 W( need to make is to select the)160 W 8280 57295 MT (assembler to be used, in)182 W /Courier SF 19022 XM (CPSKER.ASM)SH /Times-Roman SF (. Define) 614 W( one of MAC80, M80, or LASM to TRUE to select) 182 W( it as the)181 W 8280 58491 MT (assembler; the others should be defined FALSE.)SH 8280 60883 MT (Assuming you have the Microsoft Macro Assembler package \050M80/L80\051, you'll need to do the following:)SH /Courier SF 10680 62538 MT (A>m80 cpsker=cpsker.asm)SH 12600 50 11880 62738 UL 10680 63569 MT (A>l80 /p:100,cpsker,cpsker/n/e)SH 16800 50 11880 63769 UL /Times-Roman SF 8280 65286 MT (This will produce)SH /Courier SF 15585 XM (CPSKER.COM)SH /Times-Roman SF (.)SH 8280 67678 MT (If you are using LASM instead, do this:)SH /Courier SF 10680 69333 MT (A>lasm cpsker)SH 6600 50 11880 69533 UL /Times-Roman SF 8280 71050 MT (LASM will generate)53 W /Courier SF 16910 XM (CPSKER.HEX)SH /Times-Roman SF 23214 XM (and)SH /Courier SF 24962 XM (CPSKER.PRN)SH /Times-Roman SF (. LASM) 358 W( allows options to be specified in the same way as)54 W ES %%Page: 340 341 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 340)SH 12 /Times-Bold AF 28286 XM (Kermit User Guide: CP/M-80 KERMIT \05015.4.3\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (the standard assembler, ASM, so the command)SH /Courier SF 8520 9541 MT (A>lasm cpsker.abz)SH 9000 50 9720 9741 UL /Times-Roman SF 6120 11258 MT (will read the source files from drive A, send the)SH /Courier SF 25477 XM (.HEX)SH /Times-Roman SF 28127 XM (file to drive B, and suppress the listing file.)SH 6120 13650 MT (If you are using) 128 W( the Z80MU development system on an IBM PC or clone, then assemble your files using either)127 W 6120 14846 MT (LASM and MLOAD or M80 and L80, as) 3 W( if you were using a genuine CP/M-80 system. Note that you will still have)4 W 6120 16042 MT (the problem of transferring your assembled files to the target CP/M system.)SH 6120 18434 MT (If you want to generate a system-dependent overlay for a particular system, or want to change the terminal)247 W 6120 19630 MT (supported, you'll need to check three areas in)SH /Courier SF 24532 XM (CPXTYP.ASM)SH /Times-Roman SF (:)SH 6120 22022 MT (First, the overlay start ADDRESS. The symbol) 83 W( "ovladr" is EQUated to the address of "LNKFLG" in the system-)84 W 6120 23218 MT (independent module, as the starting address of the overlay \0506000H for version)109 W /Courier SF 38839 XM (4.09)SH /Times-Roman SF (\051. You'll) 468 W( need to know this)109 W 6120 24414 MT (value if you're building the overlay with M80/L80. You won't normally need to change this value.)SH 6120 26806 MT (Second, the assembler being used. Again, define one of MAC80, M80, and LASM to be TRUE to) 104 W( select it, and)105 W 6120 28002 MT (define the others to be FALSE. The two modules \050system-independent and system-dependent\051) 100 W( do not need to be)99 W 6120 29198 MT (built with the same assembler.)SH 6120 31590 MT (Third, the system configuration. Locate) 99 W( your system in tables 15-2 and 15-3, then define the appropriate symbol)100 W 6120 32786 MT (TRUE, and the rest FALSE.) 84 W( If) 417 W( the system comes with a builtin console terminal, define all the terminal switches)83 W 6120 33982 MT (FALSE. If) 508 W( the system uses an external terminal as the console, locate the terminal in) 129 W( table 15-5 and define the)130 W 6120 35178 MT (appropriate symbol TRUE, and the remainder) 160 W( FALSE. If the terminal is not listed in table 15-5, use the CRT)159 W 6120 36374 MT (switch; in this case, VT52 emulation is not supported.)SH 6120 38766 MT (In addition, there are a few general and system-specific symbols which may be altered to fit your system:)SH 6120 40557 MT (APSLOT)SH 14120 XM (For Apple with 6551 ACIA, defines the slot number of the serial card)SH 6120 42134 MT (CPUSPD)SH 14120 XM (Processor speed in units of 100KHz \050currently used only for bbII and kpII for timing loops\051)SH 6120 43711 MT (TAC)SH 14120 XM (For users connecting through ARPAnet TACs: set to TRUE if you) 53 W( wish the default TACTRAP)54 W 14120 44816 MT (status to be ON. \050This may be overridden with the SET TACTRAP command\051. If) 99 W( you're not)98 W 14120 45921 MT (connecting through a TAC, set tac to FALSE and ignore tacval.)SH 6120 47498 MT (TACVAL)SH 14120 XM (For ARPANET TAC users: defines the default TAC) 4 W( intercept character \050may be overridden with)5 W 14120 48603 MT (the SET TACTRAP command\051.)SH 6120 50995 MT (If you are just assembling an existing configuration,) 141 W( you'll need to edit)140 W /Courier SF 36443 XM (CPXTYP.ASM)SH /Times-Roman SF 42833 XM (only. If) 530 W( you are adding)140 W 6120 52191 MT (support for a new) 16 W( system, you should not modify)17 W /Courier SF 26158 XM (CPSDEF.ASM)SH /Times-Roman SF 32425 XM (or)SH /Courier SF 33525 XM (CPXLNK.ASM)SH /Times-Roman SF (; if you do, you'll have to change)17 W 6120 53387 MT (the system-independent module also. Eventually,)28 W /Courier SF 26453 XM (CPXSYS.ASM)SH /Times-Roman SF 32731 XM (will be split into separate) 28 W( files, each of which will)27 W 6120 54583 MT (generate one or more related systems. When this happens, you'll want to pick the one closest to your) 29 W( system to use)30 W 6120 55779 MT (as a starting point.)SH 6120 58171 MT (After editing)SH /Courier SF 11508 XM (CPXTYP.ASM)SH /Times-Roman SF 17758 XM (as necessary, assemble and link the overlay as follows:)SH /Symbol SF 7910 60076 MT (\267)SH /Times-Roman SF 8620 XM (With M80 \050where "xxxx" is the hex value of ovladr from)SH /Courier SF 31682 XM (CPXLNK.ASM)SH /Times-Roman SF (\051:)SH /Courier SF 11020 61731 MT (A>m80 cpxtyp=cpxtyp.asm)SH 12600 50 12220 61931 UL 11020 62762 MT (A>l80 /p:xxxx,cpxtyp,cpxtyp/n/x/e)SH 18600 50 12220 62962 UL /Symbol SF 7910 64751 MT (\267)SH /Times-Roman SF 8620 XM (With LASM:)SH /Courier SF 11020 66406 MT (A>lasm cpxtyp)SH 6600 50 12220 66606 UL /Times-Roman SF 6120 68798 MT (With an IBM PC or clone using the Z80MU softwrae, follow the instructions as if) 128 W( you were using a real CP/M)127 W 6120 69994 MT (system.)SH ES %%Page: 341 342 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (15.4.3. Assembling Kermit-80 from the sources)SH 10 /Times-Italic AF 51275 XM (Page 341)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (The overlay \050)6 W /Courier SF (CPXTYP.HEX)SH /Times-Roman SF (\051 may then be merged with the system-independent module as) 6 W( described above \050creating)7 W 8280 9082 MT (a runnable Kermit from the distribution kit\051.)SH 8280 11474 MT (If you are using the Z80MU development system on a PC, and already have a running) 42 W( Kermit-80 v3.9 or later, you)41 W 8280 12670 MT (can merge the) 1 W( two)2 W /Courier SF 15895 XM (.HEX)SH /Times-Roman SF 18547 XM (files into a)2 W /Courier SF 23025 XM (.COM)SH /Times-Roman SF 25677 XM (file with LINK80 \050TOPS 10/20\051, MLOAD \050Z80MU\051, L80 \050Z80MU\051, and)2 W 8280 13866 MT (transfer the new)SH /Courier SF 14972 XM (.COM)SH /Times-Roman SF 17622 XM (file to your micro with Kermit:)SH /Symbol SF 10070 15771 MT (\267)SH /Times-Roman SF 10780 XM (Z80MU on a PC and MLOAD:)SH /Courier SF 13180 17426 MT (@MLOAD KERNEW=CPSKER,CPXTYP)SH 15600 50 13780 17626 UL /Symbol SF 10070 19415 MT (\267)SH /Times-Roman SF 10780 XM (Z80MU on a PC and C80:)SH /Courier SF 13180 21070 MT (@L80 /P:xxxx,CPXTYP,CPXTYP/N/X/E)SH 18600 50 13780 21270 UL /Times-Roman SF 8280 22861 MT (producing)SH /Courier SF 12585 XM (KERNEW.COM)SH /Times-Roman SF (.)SH 46800 50 8280 24671 UL 8280 26900 MT (Symbol)SH 19080 XM (Terminal description)SH 3112 50 8280 27100 UL 8360 50 19080 27100 UL 8280 28005 MT (crt)SH 19080 XM (Basic CRT, no cursor positioning)SH 8280 29110 MT (adm3a)SH 19080 XM (ADM3A Display or lookalike)SH 8280 30215 MT (adm22)SH 19080 XM (ADM22 Display or lookalike)SH 8280 31320 MT (am230)SH 19080 XM (Ampro 230)SH 8280 32425 MT (h1500)SH 19080 XM (Hazeltine 1500)SH 8280 33530 MT (smrtvd)SH 19080 XM (Netronics Smartvid-80)SH 8280 34635 MT (soroq)SH 19080 XM (Soroq IQ-120)SH 8280 35740 MT (tvi912)SH 19080 XM (TVI 912)SH 8280 36845 MT (tvi925)SH 19080 XM (TVI 925, Freedom 100)SH 8280 37950 MT (vt52)SH 19080 XM (VT 52 or VT52 emulator such as Heath H19, H29, etc.)SH 8280 39055 MT (vt100)SH 19080 XM (VT 100 or emulator \050most ANSI terminals should work\051)SH 8280 40160 MT (wyse)SH 19080 XM (Wyse 100)SH /Times-Bold SF 22764 41770 MT (Table 15-5:)SH /Times-Roman SF 28125 XM (Terminals known to Kermit-80)SH 46800 50 8280 43580 UL 14 /Times-Bold AF 8280 46982 MT (15.5. Adding Support For A New System)SH 10 /Times-Roman AF 8280 49100 MT (Kermit-80 is built from a common set of source files; the system-dependent module makes heavy use) 23 W( of conditional)22 W 8280 50296 MT (assembly \050this complication will be removed in future releases\051. The) 90 W( system dependencies arise from attempts to)91 W 8280 51492 MT (answer some questions:)SH 10280 53283 MT (1.)SH /Times-Italic SF 11280 XM (What kind of terminal is to be supported?)SH /Times-Roman SF 11280 55712 MT (For many micros, the console is an integral part of the system, but others) 25 W( can use an external terminal.)24 W 11280 56817 MT (In either case, the commands to manipulate the screen \050position) 38 W( the cursor, erase the screen, etc\051 must)39 W 11280 57922 MT (be defined.)SH 10280 60132 MT (2.)SH /Times-Italic SF 11280 XM (How is the serial line accessed?)SH /Times-Roman SF 11280 62561 MT (For systems supporting the IOBYTE function,) 38 W( this is straightforward; the symbol "IOBYT" is defined)37 W 11280 63666 MT (TRUE. If) 554 W( the serial line is accessed with IN and OUT instructions, it may be possible to use the)152 W 11280 64771 MT (simple I/O routines provided. In this case, the symbol "INOUT" is) 36 W( defined TRUE, the MNPORT and)35 W 11280 65876 MT (MNPRTS are defined to be the data and control addresses, respectively, and) 64 W( bit masks for testing for)65 W 11280 66981 MT ("input data available") 123 W( and "output buffer empty" must be defined. If the interface is strange, leave)122 W 11280 68086 MT (IOBYT and INOUT set to FALSE, and provide the I/O routines.)SH 10280 70296 MT (3.)SH /Times-Italic SF 11280 XM (What initialization is necessary?)SH ES %%Page: 342 343 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 342)SH 12 /Times-Bold AF 29186 XM (Kermit User Guide: CP/M-80 KERMIT \05015.5\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 9120 7886 MT (You may wish to set the baud rate or configure the serial line at startup. Examples) 86 W( for a number of)87 W 9120 8991 MT (devices are present.)SH 8120 11201 MT (4.)SH /Times-Italic SF 9120 XM (What special features are to be supported?)SH /Times-Roman SF 9120 13630 MT (You may want to provide the capability to select one of several serial lines with the SET) 183 W( PORT)182 W 9120 14735 MT (command, or to change the speed of the serial) 21 W( line with the SET BAUD-RATE command. To do this,)22 W 9120 15840 MT (you'll need to build a command table, using the systems already supported as) 10 W( examples. The ability to)9 W 9120 16945 MT (send a BREAK signal is desirable. Again, examples for several different interfaces \050ACIA,) 52 W( SIO, etc\051)53 W 9120 18050 MT (are present.)SH 8120 20260 MT (5.)SH /Times-Italic SF 9120 XM (Do you want to design an external terminal type?)SH /Times-Roman SF 9120 22689 MT (There is a jump entry in the overlay file to allow users to add their own termainl emulator.) 114 W( If) 477 W( you)113 W 9120 23794 MT (write the code for) 223 W( such an emulator, you must load this jump address with the address of your)224 W 9120 24899 MT (emulator, and SET) 106 W( TERMINAL EXTERNAL from within Kermit. All characters will be passed to)105 W 9120 26004 MT (this routine during connect mode.)SH 14 /Times-Bold AF 6120 29606 MT (15.6. Notes on New Features in Kermit-80 Version 4)SH 10 /Symbol AF 7910 31838 MT (\267)SH /Times-Italic SF 8620 XM (Debugging aids:)218 W /Times-Roman SF 16468 XM (SET DEBUG ON will add two fields to the SEND/RECEIVE display, labelled)218 W 8620 32943 MT ("Spack" and) 40 W( "Rpack". These display the last packet sent and received. Of course, this slows down the)39 W 8620 34048 MT (transfer, especially if the console is an external) 24 W( terminal. SET DEBUG OFF removes these fields. The)25 W 8620 35153 MT (VERSION command) 27 W( displays the name, edit number, and edit date of several of the modules that make)26 W 8620 36258 MT (up Kermit.)SH /Symbol SF 7910 38247 MT (\267)SH /Times-Italic SF 8620 XM (TAC support:)32 W /Times-Roman SF 14407 XM (ARPAnet TACs \050and many other communication devices) 32 W( such as terminal concentrators,)33 W 8620 39352 MT (modems, port contention units, network PADs, etc\051 use a printing character \050like) 79 W( "@"\051 as an intercept)78 W 8620 40457 MT (character, to allow commands to be issued to the TAC, or modem, etc. In order to send this character) 7 W( to)8 W 8620 41562 MT (the host, it must be typed) 163 W( twice. The command "SET TAC CHARACTER" to Kermit enables the)162 W 8620 42667 MT ("TACtrap" and asks the) 358 W( user to specify the TAC intercept character. This character will be)359 W 8620 43772 MT (automatically doubled when it) 94 W( appears in Kermit protocol messages \050sent by the SEND or RECEIVE)93 W 8620 44877 MT (commands\051 or when it appears in a) 295 W( file being sent with the TRANSMIT command. It is not)296 W 8620 45982 MT (automatically doubled when typed by the user in CONNECT mode. "SET TAC) 192 W( ON" enables the)191 W 8620 47087 MT (TACtrap but does not change the TAC intercept character, which) 109 W( is initially "@". "SET TAC OFF")110 W 8620 48192 MT (disables the TACtrap.)SH /Symbol SF 7910 50181 MT (\267)SH /Times-Italic SF 8620 XM (File buffering:)96 W /Times-Roman SF 15269 XM (Previous versions of Kermit-80 buffered only) 96 W( one sector \050128 bytes\051 at a time during)95 W 8620 51286 MT (file transfer operations. This version buffers 16Kbytes at a time, reducing the number of) 151 W( times the)152 W 8620 52391 MT (floppy drive must be) 33 W( spun up and down, and increasing the effective throughput of the link. If the disk)32 W 8620 53496 MT (transfer rate is) 89 W( too slow, however, the remote Kermit may time out and retransmit packets. This will)90 W 8620 54601 MT (show up on the screen in the "Retries:" field; if this occurs after disk activity, you) 26 W( may want to increase)25 W 8620 55706 MT (the timeout value on the remote Kermit,) 135 W( SET BUFFER while in Kermit,or reassemble)136 W 8620 56811 MT (Kermit with a smaller value for MAXSEC \050in)304 W /Courier SF 29661 XM (CPSDEF.ASM)SH /Times-Roman SF (\051 This) 304 W( buffer is also used by the)303 W 8620 57916 MT (TRANSMIT command; the log file enabled by the LOG command is still written a sector at a time.)SH 6120 60308 MT (This section is intended for people wanting to implement their own versions) 16 W( of Kermit-80 for computers not already)17 W 6120 61504 MT (defined.)SH 6120 63896 MT (The system independent code communicates to routines for a specific system through a set of tables.) 62 W( These) 372 W( tables)61 W 6120 65092 MT (are defined in CPXLNK.ASM, and) 106 W( should not be modified between revisions of Kermit. If an entry is added or)107 W 6120 66288 MT (deleted, then) 199 W( the whole of Kermit-80 needs reassembling. Make sure that the changes to CPXLNK.ASM are)198 W 6120 67484 MT (duplicated in CPSUTL.ASM, which has the system independent equivalent of CPXLNK.ASM.)SH 6120 69876 MT (The following entries/definitions apply) 140 W( to revision 4.09. There have been three additional entries since revision)141 W 6120 71072 MT (4.05.)SH ES %%Page: 343 344 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (15.6. Notes on New Features in Kermit-80 Version 4)SH 10 /Times-Italic AF 51275 XM (Page 343)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (The table) 56 W( is split into three sectors; The first section defines two byte "words" giving 16 bits of interface data; The)55 W 8280 9082 MT (second set is a set of jumps to various functions, and finally the third set a set of pure data bytes.)SH 12 /Times-Bold AF 8280 12198 MT (15.6.1. Interface Data.)SH 10 /Times-Roman AF 12280 14140 MT (LNKFLG)SH 16280 XM (Must be first entry in overlay at overlay address. Is a two byte address giving the size of the)98 W 3944 50 12280 14340 UL 16280 15245 MT (linkage table. This is used to check for consistency of overlay's)SH 12280 17674 MT (ENTSIZE)SH 4055 50 12280 17874 UL 16280 18779 MT (Length of entry table, also used for consistency checking after the overlay. Currently 6)SH 12280 21208 MT (SYSEDT)SH 16280 XM (The address of a dollar-terminated string giving the overlay revision level and date. Points) 45 W( to a)46 W 3778 50 12280 21408 UL 16280 22313 MT (string like: CPXSYS.ASM\05033\051 4-JUN-1986$)SH 12280 24742 MT (FAMILY)SH 16280 XM (The address of a dollar-terminated string giving the Family overlay revision) 80 W( level and date. If)79 W 3833 50 12280 24942 UL 16280 25847 MT (the system is in CPXSYS.ASM rather than a) 46 W( particular Family overlay, it is simply a pointer to)47 W 16280 26952 MT ($)SH 12 /Times-Bold AF 8280 32278 MT (15.6.2. Jump Table.)SH 10 /Times-Roman AF 8280 34220 MT (This is split into three main sectors-)SH 10280 37335 MT (1.)SH 11280 XM (Input/Output routines)SH 10280 39545 MT (2.)SH 11280 XM (Screen formatting routines)SH 10280 41755 MT (3.)SH 11280 XM (other system dependent routines)SH 9280 45070 MT (SELMDM)SH 4278 50 9280 45270 UL /Times-Italic SF 9280 46175 MT (Parameters)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 47280 MT (Returns)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 48385 MT (Description)SH /Times-Roman SF 16280 XM (selects the modem port. Most) 56 W( systems do nothing and simply return. HL,DE and BC registers)55 W 16280 49490 MT (preserved.)SH 9280 51919 MT (OUTMDM)SH 4555 50 9280 52119 UL /Times-Italic SF 9280 53024 MT (Parameters)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 54129 MT (Returns)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 55234 MT (Description)SH /Times-Roman SF 16280 XM (Output the character in E register to the communications line. BC,DE,HL registers preserved.)SH 9280 57663 MT (INPMDM)SH 4111 50 9280 57863 UL /Times-Italic SF 9280 58768 MT (Parameters)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 59873 MT (Returns)SH /Times-Roman SF 16280 XM (Accumulator either 0 or character from comms line if available)SH /Times-Italic SF 9280 60978 MT (Description)SH /Times-Roman SF 16280 XM (Check modem) 90 W( for character and if so, return it in A. HL,DE,BC registers preserved, flags and)91 W 16280 62083 MT (accumulator lost.)SH 9280 64512 MT (FLSMDM)SH 4223 50 9280 64712 UL /Times-Italic SF 9280 65617 MT (Parameters)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 66722 MT (Returns)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 67827 MT (Description)SH /Times-Roman SF 16280 XM (Clear any pending characters in the input buffer from the modem. No registers are preserved.)SH 9280 70256 MT (SELCON)SH 3889 50 9280 70456 UL /Times-Italic SF 9280 71361 MT (Parameters)SH /Times-Roman SF 16280 XM (None)SH ES %%Page: 344 345 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 344)SH 12 /Times-Bold AF 28286 XM (Kermit User Guide: CP/M-80 KERMIT \05015.6.2\051)SH 46800 50 6120 5709 UL 10 /Times-Italic AF 7120 7886 MT (Returns)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 8991 MT (Description)SH /Times-Roman SF 14120 XM (Select the console.) 44 W( This) 337 W( is a null subroutine for most systems, but for IOBYTE systems selects)43 W 14120 10096 MT (the console.)SH 7120 12525 MT (OUTCON)SH 4166 50 7120 12725 UL /Times-Italic SF 7120 13630 MT (Parameters)SH /Times-Roman SF 14120 XM (Character in E)SH /Times-Italic SF 7120 14735 MT (Returns)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 15840 MT (Description)SH /Times-Roman SF 14120 XM (Send the character in E to the console. Any quirks) 145 W( of system responding in an odd manner)146 W 14120 16945 MT (should be handled. No registers preserved.)SH 7120 19374 MT (INPCON)SH 3722 50 7120 19574 UL /Times-Italic SF 7120 20479 MT (Parameters)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 21584 MT (Returns)SH /Times-Roman SF 14120 XM (Zero or character in A.)SH /Times-Italic SF 7120 22689 MT (Description)SH /Times-Roman SF 14120 XM (Get a character from the console or return a null if no character to be read.) 119 W( No) 486 W( registers are)118 W 14120 23794 MT (preserved.)SH 7120 26223 MT (OUTLPT)SH 3833 50 7120 26423 UL /Times-Italic SF 7120 27328 MT (Parameters)SH /Times-Roman SF 14120 XM (Character in E)SH /Times-Italic SF 7120 28433 MT (Returns)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 29538 MT (Description)SH /Times-Roman SF 14120 XM (Send the character in E to the printer. The console is selected. Only DE registers are preserved)SH 7120 31967 MT (LPTSTAT)SH 4278 50 7120 32167 UL /Times-Italic SF 7120 33072 MT (Parameters)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 34177 MT (Returns)SH /Times-Roman SF 14120 XM (00H or 0FFH in A register)SH /Times-Italic SF 7120 35282 MT (Description)SH /Times-Roman SF 14120 XM (Test the printer to see if it is ready to receive a character to) 20 W( be printed. If a 00H is returned then)21 W 14120 36387 MT (the printer is ready to receive a character.)SH 7120 38816 MT (EXTTER)SH 3833 50 7120 39016 UL /Times-Italic SF 7120 39921 MT (Parameters)SH /Times-Roman SF 14120 XM (Character to be sent to the user supplied terminal emulator in the E register)SH /Times-Italic SF 7120 41026 MT (Returns)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 42131 MT (Description)SH /Times-Roman SF 14120 XM (If the user has supplied a terminal emulator in) 67 W( the overlay code, EXTTER will be a JMP . If SET TERMINAL EXTERNAL has been) 148 W( set, all caharcters will be passed)149 W 14120 44341 MT (verbatim to this terminal emulator. If there is) 155 W( no external emulator, this code will never be)154 W 14120 45446 MT (called. The) 320 W( user should reset terminal conditions on initialisation of both the system and) 35 W( before)36 W 14120 46551 MT (CONNECT. All) 250 W( registers should be preserved.)SH 7120 48980 MT (XBDOS)SH 3389 50 7120 49180 UL /Times-Italic SF 7120 50085 MT (Parameters)SH /Times-Roman SF 14120 XM (Any required for calling BDOS)SH /Times-Italic SF 7120 51190 MT (Returns)SH /Times-Roman SF 14120 XM (Any expected from the called BDOS routine)SH /Times-Italic SF 7120 52295 MT (Description)SH /Times-Roman SF 14120 XM (This is an alternative entry to BDOS. This entry will) 53 W( also check the printer status etc. For full)52 W 14120 53400 MT (details see the code for the BDOS trap in CPSUTL.ASM.)SH 14120 55829 MT (2b\051)SH 14120 58258 MT (CLRLIN)SH 3611 50 14120 58458 UL /Times-Italic SF 7120 59363 MT (Parameters)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 60468 MT (Returns)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 61573 MT (Description)SH /Times-Roman SF 14120 XM (Clear the current line on the terminal)SH 7120 64002 MT (CLRSPC)SH 3724 50 7120 64202 UL /Times-Italic SF 7120 65107 MT (Parameters)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 66212 MT (Returns)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 67317 MT (Description)SH /Times-Roman SF 14120 XM (Erase the current position \050after a backspace\051)SH 7120 69746 MT (DELCHR)SH 4000 50 7120 69946 UL /Times-Italic SF 7120 70851 MT (Parameters)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 71956 MT (Returns)SH /Times-Roman SF 14120 XM (None)SH ES %%Page: 345 346 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (15.6.2. Jump Table.)SH 10 /Times-Italic AF 51275 XM (Page 345)SH 46800 50 8280 5709 UL 9280 7886 MT (Description)SH /Times-Roman SF 16280 XM (Make delete \0507FH\051 look like a backspace. Some systems do a backspace, space, backspace)163 W 16280 8991 MT (automatically others have to simulate it)SH 9280 11420 MT (CLRTOP)SH 3834 50 9280 11620 UL /Times-Italic SF 9280 12525 MT (Parameters)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 13630 MT (Returns)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 14735 MT (Description)SH /Times-Roman SF 16280 XM (Clear the screen and place the cursor at the top LH corner)SH 9280 17164 MT (SCREND)SH 3945 50 9280 17364 UL /Times-Italic SF 9280 18269 MT (Parameters)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 19374 MT (Returns)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 20479 MT (Description)SH /Times-Roman SF 16280 XM (Place the cursor on the line for the Kermit-80 prompt after a file transfer. \050Usually line 13\051)SH 9280 22908 MT (SCRERR)SH 3835 50 9280 23108 UL /Times-Italic SF 9280 24013 MT (Parameters)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 25118 MT (Returns)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 26223 MT (Description)SH /Times-Roman SF 16280 XM (Move cursor to the error message field on the file transfer format screen)SH 9280 28652 MT (SCRFLN)SH 3779 50 9280 28852 UL /Times-Italic SF 9280 29757 MT (Parameters)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 30862 MT (Returns)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 31967 MT (Description)SH /Times-Roman SF 16280 XM (Move the cursor to the filename field)SH 9280 34396 MT (SCRNP)SH 3168 50 9280 34596 UL /Times-Italic SF 9280 35501 MT (Parameters)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 36606 MT (Returns)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 37711 MT (Description)SH /Times-Roman SF 16280 XM (Move the cursor to the packet count field)SH 9280 40140 MT (SCRNRT)SH 3890 50 9280 40340 UL /Times-Italic SF 9280 41245 MT (Parameters)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 42350 MT (Returns)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 43455 MT (Description)SH /Times-Roman SF 16280 XM (Move cursor to the retry count field)SH 9280 45884 MT (SCRST)SH 3057 50 9280 46084 UL /Times-Italic SF 9280 46989 MT (Parameters)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 48094 MT (Returns)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 49199 MT (Description)SH /Times-Roman SF 16280 XM (Move cursor to the status field)SH 9280 51628 MT (RPPOS)SH 3057 50 9280 51828 UL /Times-Italic SF 9280 52733 MT (Parameters)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 53838 MT (Returns)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 54943 MT (Description)SH /Times-Roman SF 16280 XM (Move to the receive packet field \050debugging use\051)SH 9280 57372 MT (SPPOS)SH 2946 50 9280 57572 UL /Times-Italic SF 9280 58477 MT (Parameters)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 59582 MT (Returns)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 60687 MT (Description)SH /Times-Roman SF 16280 XM (Move to the send packet field \050for debugging use\051)SH 16280 63116 MT (2c\051)SH 16280 65545 MT (SYSINIT)SH 3833 50 16280 65745 UL /Times-Italic SF 9280 66650 MT (Parameters)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 67755 MT (Returns)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 68860 MT (Description)SH /Times-Roman SF 16280 XM (Initialize the system specific) 49 W( items. No registers are preserved. Any initialization is done once)48 W 16280 69965 MT (only when Kermit-80 is first loaded.)SH ES %%Page: 346 347 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 346)SH 12 /Times-Bold AF 28286 XM (Kermit User Guide: CP/M-80 KERMIT \05015.6.2\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 7120 7886 MT (SYSEXIT)SH 4111 50 7120 8086 UL /Times-Italic SF 7120 8991 MT (Parameters)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 10096 MT (Returns)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 11201 MT (Description)SH /Times-Roman SF 14120 XM (Program termination. De-initialize anything in preparation for a return to CP/M)SH 7120 13630 MT (SYSCON)SH 3945 50 7120 13830 UL /Times-Italic SF 7120 14735 MT (Parameters)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 15840 MT (Returns)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 16945 MT (Description)SH /Times-Roman SF 14120 XM (Initialize anything before entering the connect state.)SH 7120 19374 MT (SYSCLS)SH 3668 50 7120 19574 UL /Times-Italic SF 7120 20479 MT (Parameters)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 21584 MT (Returns)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 22689 MT (Description)SH /Times-Roman SF 14120 XM (System dependent close routine when exiting connect state)SH 7120 25118 MT (SYSINH)SH 3611 50 7120 25318 UL /Times-Italic SF 7120 26223 MT (Parameters)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 27328 MT (Returns)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 28433 MT (Description)SH /Times-Roman SF 14120 XM (Help routine to test for any extensions to the escape menu during the connect state.) 40 W( If) 331 W( a system)41 W 14120 29538 MT (has any special feature it) 499 W( can use during connect mode, then it can be tested as)498 W 14120 30643 MT (xxx. This) 1370 W( entry) 560 W( is a string for printing to the console for an)561 W 14120 31748 MT (? Often) 250 W( used for generating breaks or controlling a modem.)SH 7120 34177 MT (SYSINT)SH 3500 50 7120 34377 UL /Times-Italic SF 7120 35282 MT (Parameters)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 36387 MT (Returns)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 37492 MT (Description)SH /Times-Roman SF 14120 XM (This is a test-and-jump on receipt of an escape sequence not understood by Kermit-80.) 94 W( If) 437 W( the)93 W 14120 38597 MT (character in A is not recognized by your version of Kermit=80, do a rskip)SH 7120 41026 MT (SYSFLT)SH 3612 50 7120 41226 UL /Times-Italic SF 7120 42131 MT (Parameters)SH /Times-Roman SF 14120 XM (Character in E)SH /Times-Italic SF 7120 43236 MT (Returns)SH /Times-Roman SF 14120 XM (Character in E. Either a 00H or anything else in A)SH /Times-Italic SF 7120 44341 MT (Description)SH /Times-Roman SF 14120 XM (Test the character in E. If it may not be printed to the console, set A to zero.) 33 W( All) 317 W( other registers)34 W 14120 45446 MT (preserved.)SH 14120 46551 MT (NB ,,, are always rejected.)SH 7120 48980 MT (SYSBYE)SH 3834 50 7120 49180 UL /Times-Italic SF 7120 50085 MT (Parameters)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 51190 MT (Returns)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 52295 MT (Description)SH /Times-Roman SF 14120 XM (System dependent processing for the BYE command. \050eg hang up the phone\051)SH 7120 54724 MT (SYSSPD)SH 3668 50 7120 54924 UL /Times-Italic SF 7120 55829 MT (Parameters)SH /Times-Roman SF 14120 XM (Value from table in DE)SH /Times-Italic SF 7120 56934 MT (Returns)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 58039 MT (Description)SH /Times-Roman SF 14120 XM (The system dependent code for baud rate) 9 W( change. DE contains the two byte value from the baud)8 W 14120 59144 MT (rate table. This value is also stored in "SPEED")SH 7120 61573 MT (SYSPRT)SH 3668 50 7120 61773 UL /Times-Italic SF 7120 62678 MT (Parameters)SH /Times-Roman SF 14120 XM (Value in DE)SH /Times-Italic SF 7120 63783 MT (Returns)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 64888 MT (Description)SH /Times-Roman SF 14120 XM (The system dependent code for setting the port. The parameters are passed in DE,) 106 W( which are)107 W 14120 65993 MT (obtained from the port tables)SH 7120 68422 MT (SYSSCR)SH 3724 50 7120 68622 UL /Times-Italic SF 7120 69527 MT (Parameters)SH /Times-Roman SF 14120 XM (String pointer in DE)SH /Times-Italic SF 7120 70632 MT (Returns)SH /Times-Roman SF 14120 XM (None)SH /Times-Italic SF 7120 71737 MT (Description)SH /Times-Roman SF 14120 XM (Setup the screen display for file transfer. The Kermit version string is pointed to by DE. If) 41 W( the)40 W ES %%Page: 347 348 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (15.6.2. Jump Table.)SH 10 /Times-Italic AF 51275 XM (Page 347)SH 46800 50 8280 5709 UL /Times-Roman SF 16280 7886 MT (terminal is not capable of cursor addressing \050eg dumb glass TTY\051 then) 12 W( only the screen is cleared)13 W 16280 8991 MT (and the version string is printed.)SH 9280 11420 MT (CSRPOS)SH 3724 50 9280 11620 UL /Times-Italic SF 9280 12525 MT (Parameters)SH /Times-Roman SF 16280 XM (Row number in B, column number in C)SH /Times-Italic SF 9280 13630 MT (Returns)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 14735 MT (Description)SH /Times-Roman SF 16280 XM (Move the cursor to) 74 W( row B, column C where B=1,C=1 is top LH corner of screen. The routine)73 W 16280 15840 MT (should first end a) 19 W( "cursor position" leading string \050up to four characters\051 then use the parameters)20 W 16280 16945 MT (given to complete the versions cursor position function)SH 9280 19374 MT (SYSSPC)SH 3613 50 9280 19574 UL /Times-Italic SF 9280 20479 MT (Parameters)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 21584 MT (Returns)SH /Times-Roman SF 16280 XM (K bytes free in HL)SH /Times-Italic SF 9280 22689 MT (Description)SH /Times-Roman SF 16280 XM (Get the amount of free disk space on the selected disk drive. This could be in the system)179 W 16280 23794 MT (independent code. Automatically detects CP/M V2.2 or V3.0. No registers saved.)SH 9280 26223 MT (MOVER)SH 3611 50 9280 26423 UL /Times-Italic SF 9280 27328 MT (Parameters)SH /Times-Roman SF 16280 XM (Source Pointer in HL)SH 16280 28433 MT (Destination Pointer in DE)SH 16280 29538 MT (Byte count in BC)SH /Times-Italic SF 9280 30643 MT (Returns)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 31748 MT (Description)SH /Times-Roman SF 16280 XM (Move \050BC\051 bytes from \050HL\051 to \050DE\051 Z80 based) 50 W( systems do an LDIR, while 8080 systems do it)51 W 16280 32853 MT (as a loop. All registers destroyed)SH 9280 35282 MT (PRTSTR)SH 3668 50 9280 35482 UL /Times-Italic SF 9280 36387 MT (Parameters)SH /Times-Roman SF 16280 XM ($ terminated string pointed to by DE)SH /Times-Italic SF 9280 37492 MT (Returns)SH /Times-Roman SF 16280 XM (None)SH /Times-Italic SF 9280 38597 MT (Description)SH /Times-Roman SF 16280 XM (Print the string onto the console.)SH 16280 41026 MT (3\051)SH 9280 44560 MT (PTTAB)SH 16280 XM (WORD)SH 23480 XM (Points to VT52 equivalent escape sequences.)SH 3167 50 9280 44760 UL 9280 46989 MT (SPDTAB)SH 16280 XM (WORD)SH 23480 XM (Address of baud-rate command table, or 0 if table does not exist)SH 3834 50 9280 47189 UL 9280 49418 MT (SPDHLP)SH 16280 XM (WORD)SH 23480 XM (Address of baud-rate help table, or 0 if SET BAUD-RATE is not supported.)SH 3723 50 9280 49618 UL 9280 51847 MT (PRTTAB)SH 16280 XM (WORD)SH 23480 XM (Address of port command table or 0 if SET PORT is not supported.)SH 3834 50 9280 52047 UL 9280 54276 MT (PRTHLP)SH 16280 XM (WORD)SH 23480 XM (Address of port help table or 0 if SET PORT is not supported)SH 3723 50 9280 54476 UL 9280 56705 MT (TIMOUT)SH 16280 XM (BYTE)SH 23480 XM (FUZZY-TIMER. Set) 582 W( to value suitable to your system \050depends largely) 166 W( on)165 W 3888 50 9280 56905 UL 16280 57810 MT (CPU speed\051)SH 9280 60239 MT (VTFLG)SH 16280 XM (BYTE)SH 23480 XM (VT52 emulation flag. Set to 0 if terminal) 23 W( emulates a VT52, 01 if emulation is)24 W 3222 50 9280 60439 UL 16280 61344 MT (required, or 0FFH if emulations not possible \050eg for "CRT"\051)SH 9280 63773 MT (ESCCHR)SH 16280 XM (BYTE)SH 23480 XM (default escape character-usually control-] but sometimes control-\134)SH 3890 50 9280 63973 UL 9280 66202 MT (SPEED)SH 16280 XM (WORD)SH 23480 XM (Storage space for baud-rate. Set to 0FFFFH as) 303 W( baud rates are initially)302 W 3056 50 9280 66402 UL 16280 67307 MT (unknown. Note) 250 W( that the STATUS routine only looks at the first \050least significant\051 byte.)SH 9280 69736 MT (PORT)SH 16280 XM (WORD)SH 23480 XM (Storage space for port. Set to 0FFFFH as ports may not be implemented, and)43 W 2556 50 9280 69936 UL 16280 70841 MT (is initially unknown)SH ES %%Page: 348 349 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 348)SH 12 /Times-Bold AF 28286 XM (Kermit User Guide: CP/M-80 KERMIT \05015.6.2\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 7120 9410 MT (PRNFLG)SH 14120 XM (BYTE)SH 21320 XM (Printer copy flag-if O no copy. Anything else => copy to printer)SH 3834 50 7120 9610 UL 7120 11839 MT (DBGFLG)SH 14120 XM (BYTE)SH 21320 XM (Debugging flag. If O then no debugging to be) 24 W( done. \050ie writing of debugging)23 W 4000 50 7120 12039 UL 14120 12944 MT (info during a file transfer\051)SH 7120 15373 MT (ECOFLG)SH 14120 XM (BYTE)SH 21320 XM (Local ECHO flag \050default is off\051)SH 3889 50 7120 15573 UL 7120 17802 MT (FLWFLG)SH 14120 XM (BYTE)SH 21320 XM (File warning flag. If set to 1 will not overwrite files already existing) 66 W( on disk)67 W 4000 50 7120 18002 UL 14120 18907 MT (with some-named files being transferred)SH 7120 21336 MT (IBMFLG)SH 14120 XM (BYTE)SH 21320 XM (IBM system is the host-assume IBM file transfers etc)SH 3778 50 7120 21536 UL 7120 23765 MT (CPMFLG)SH 14120 XM (BYTE)SH 21320 XM (Flag indicating) 322 W( type of CP/M files to be transferred. Default setting -)321 W 4001 50 7120 23965 UL 14120 24870 MT (DEFAULT)SH 7120 27299 MT (PARITY)SH 14120 XM (BYTE)SH 21320 XM (Type of parity in use)SH 3611 50 7120 27499 UL 14120 28404 MT (0 = Even parity)SH 14120 29509 MT (3 = Mark parity)SH 14120 30614 MT (6 = No parity \0508th bit is data\051)SH 14120 31719 MT (9 = Odd parity)SH 14120 32824 MT (12 = Space parity)SH 7120 35253 MT (SPSIZ)SH 14120 XM (BYTE)SH 21320 XM (Size of send packet)SH 2612 50 7120 35453 UL 7120 37682 MT (RPSIZ)SH 14120 XM (BYTE)SH 21320 XM (Size of receive packet)SH 2723 50 7120 37882 UL 7120 40111 MT (STIME)SH 14120 XM (BYTE)SH 21320 XM (Send timer \050time-out\051)SH 3000 50 7120 40311 UL 7120 42540 MT (RTIME)SH 14120 XM (BYTE)SH 21320 XM (Receive timer \050time-out\051)SH 3111 50 7120 42740 UL 7120 44969 MT (SPAD)SH 14120 XM (BYTE)SH 21320 XM (Send Padding \050default=0\051)SH 2556 50 7120 45169 UL 7120 47398 MT (RPAD)SH 14120 XM (BYTE)SH 21320 XM (Receive Padding \050default=0\051)SH 2667 50 7120 47598 UL 7120 49827 MT (SPADCH)SH 14120 XM (BYTE)SH 21320 XM (Send Padding character \050default=NULL\051)SH 3945 50 7120 50027 UL 7120 52256 MT (RPADCH)SH 14120 XM (BYTE)SH 21320 XM (Receive Padding character \050default=NULC\051)SH 4056 50 7120 52456 UL 7120 54685 MT (SEOL)SH 14120 XM (BYTE)SH 21320 XM (Send EOL character \050default=CR\051)SH 2500 50 7120 54885 UL 7120 57114 MT (REOL)SH 14120 XM (BYTE)SH 21320 XM (Receive EOL character \050default=CR\051)SH 2611 50 7120 57314 UL 7120 59543 MT (SQUOTE)SH 14120 XM (BYTE)SH 21320 XM (Send quote character \050default=#\051)SH 3944 50 7120 59743 UL 7120 61972 MT (RQUOTE)SH 14120 XM (BYTE)SH 21320 XM (Receive quote character \050default=#\051)SH 4055 50 7120 62172 UL 7120 64401 MT (CHKTYP)SH 14120 XM (BYTE)SH 21320 XM (Ascii value of checktype)SH 4000 50 7120 64601 UL 14120 65506 MT (31H="1"=checktype1 \0506bits\051)SH 14120 66611 MT (32H="2"=checktype2 \05012bits\051)SH 14120 67716 MT (33H="3"=CCITT checksum \050CRC\051)SH 14120 68821 MT (Default is 31H\050"1"\051)SH 7120 71250 MT (TACFLG)SH 14120 XM (BYTE)SH 21320 XM (If set to on \050non zero\051 send the TACCHR twice. This is for ARPA TAC users,)3 W 3889 50 7120 71450 UL ES %%Page: 349 350 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (15.6.2. Jump Table.)SH 10 /Times-Italic AF 51275 XM (Page 349)SH 46800 50 8280 5709 UL /Times-Roman SF 16280 7886 MT (where the TAC swallows one "wakeup" character.) 11 W( If) 271 W( sent twice the TAC will pas one on and go)10 W 16280 8991 MT (back to normal mode.)SH 9280 11420 MT (TACCHR)SH 16280 XM (BYTE)SH 23480 XM (Desired TAC character. It is ignored if TAC trapping is turned off. Value) 71 W( to)72 W 4056 50 9280 11620 UL 16280 12525 MT (send twice if TAC interception is set on. Default=0, but set to commercial) 16 W( AT if the conditional)15 W 16280 13630 MT (assembly flag TAC is set true)SH 9280 16059 MT (BUFADR)SH 16280 XM (WORD)SH 23480 XM (Address of Multi-Sector buffering for I/O)SH 4056 50 9280 16259 UL 9280 18488 MT (BUFSEC)SH 16280 XM (BYTE)SH 23480 XM (The number of bytes the big buffers can hold. Default is 1. \0500=256 sectors\051.)SH 3779 50 9280 18688 UL 9280 20917 MT (FFUSSY)SH 16280 XM (BYTE)SH 23480 XM (Indicates if) 491 W( funny characters may be used in CP/M file names \050eg)492 W 3668 50 9280 21117 UL /Courier SF 16280 22022 MT (<>.,;?#[])SH /Times-Roman SF (\051 If zero, allow anything. Default is nonzero.)SH 9280 24451 MT (BMAX)SH 16280 XM (SPACE:\0502bytes\051 Highest block number on selected disk drive)SH 3000 50 9280 24651 UL 9280 26880 MT (BMASK)SH 16280 XM (SPACE:\0501byte\051 \050Records/block\051-1)SH 3556 50 9280 27080 UL 9280 29309 MT (BSHIFTF)SH 16280 XM (SPACE:\0501byte\051 Number of shifts to multiply by rec.block)SH 4001 50 9280 29509 UL 9280 31738 MT (NNAMS)SH 16280 XM (SPACE:\0501byte\051 Counter for file-names per line)SH 3611 50 9280 31938 UL 14 /Times-Bold AF 8280 35340 MT (15.7. Future Work)SH 10 /Times-Roman AF 8280 37458 MT (Work that needs to be done in future releases includes:)SH /Symbol SF 10070 39363 MT (\267)SH /Times-Roman SF 10780 XM (Merge in support for additional CP/M-80 systems, particularly) 135 W( those for which support was recently)134 W 10780 40468 MT (added to the monolithic v3.x source.)SH /Symbol SF 10070 42457 MT (\267)SH /Times-Roman SF 10780 XM (Break up)89 W /Courier SF 14846 XM (CPXSYS)SH /Times-Roman SF 18785 XM (into discrete source files, one for each system. These source files should serve) 89 W( as)90 W 10780 43562 MT (simple models for adding support for new) 308 W( systems to Kermit-80 -- only the very basic screen)307 W 10780 44667 MT (definitions, flags, i/o primitives,) 131 W( initializations, and so forth should appear in each system-dependent)132 W 10780 45772 MT (file.)SH /Symbol SF 10070 47761 MT (\267)SH /Times-Roman SF 10780 XM (Addition of missing) 352 W( features -- compression of repeated characters during packet transmission,)351 W 10780 48866 MT (transmission of file attributes \050particularly size, so that "percent done") 243 W( can be displayed for both)244 W 10780 49971 MT (incoming and outbound files\051,) 373 W( advanced commands for servers \050REMOTE DIRECTORY, etc\051,)372 W 10780 51076 MT (command macros and initialization) 40 W( files, login scripts, remote operation and server mode, etc etc. Any)41 W 10780 52181 MT (offers??)SH ES %%Page: 350 351 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 350)SH 12 /Times-Bold AF 30086 XM (Kermit User Guide: CP/M-80 KERMIT \05016\051)SH 46800 50 6120 5709 UL ES %%Page: 351 352 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (16. CP/M-86 KERMIT)SH 10 /Times-Italic AF 51275 XM (Page 351)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 8280 8272 MT (16. CP/M-86 KERMIT)SH 10 /Times-Italic AF 8280 10566 MT (Authors:)SH /Times-Roman SF 14280 XM (Bill Catchings, Columbia University; Ron Blanford, University of Washington; Richard) 183 W( Garland,)182 W 14280 11671 MT (Columbia University.)SH /Times-Italic SF 8280 12776 MT (Language:)SH /Times-Roman SF 14280 XM (Digital Research ASM86)SH /Times-Italic SF 8280 13881 MT (Version:)SH /Courier SF 14280 XM (2.9)SH /Times-Italic SF 8280 14986 MT (Date:)SH /Times-Roman SF 14280 XM (December 1984)SH /Times-Italic SF 8280 16091 MT (Documentation:)SH /Times-Roman SF 14280 17196 MT (Frank da Cruz, Columbia)SH 8280 19588 MT (This version of KERMIT is designed to support any CP/M-86 system. So far it supports the DEC Rainbow-100) 13 W( and)12 W 8280 20784 MT (the NEC Advanced Personal Computer \050APC\051. It is very similar to CP/M-80 and MS DOS KERMIT.)SH 12 /Times-Bold AF 8280 23372 MT (CP/M-86 KERMIT-86 Capabilities At A Glance:)SH 10 /Times-Roman AF 9280 25163 MT (Local operation:)SH 34480 XM (Yes)SH 9280 26268 MT (Remote operation:)SH 34480 XM (No)SH 9280 27373 MT (Transfers text files:)SH 34480 XM (Yes)SH 9280 28478 MT (Transfers binary files:)SH 34480 XM (Yes)SH 9280 29583 MT (Wildcard send:)SH 34480 XM (Yes)SH /Courier SF 9280 30688 MT (^X/^Y)SH /Times-Roman SF 12530 XM (interruption:)SH 34480 XM (Yes)SH 9280 31793 MT (Filename collision avoidance:)SH 34480 XM (Yes)SH 9280 32898 MT (Can time out:)SH 34480 XM (Yes)SH 9280 34003 MT (8th-bit prefixing:)SH 34480 XM (Yes)SH 9280 35108 MT (Repeat count prefixing:)SH 34480 XM (No)SH 9280 36213 MT (Alternate block checks:)SH 34480 XM (No)SH 9280 37318 MT (Terminal emulation:)SH 34480 XM (Yes, uses PC firmware \050VT100\051)SH 9280 38423 MT (Communication settings:)SH 34480 XM (Yes; duplex, parity)SH 9280 39528 MT (Transmit BREAK:)SH 34480 XM (Yes)SH 9280 40633 MT (IBM communication:)SH 34480 XM (Yes)SH 9280 41738 MT (Transaction logging:)SH 34480 XM (No)SH 9280 42843 MT (Session logging \050raw download\051:)SH 34480 XM (Yes)SH 9280 43948 MT (Raw upload:)SH 34480 XM (No)SH 9280 45053 MT (Act as server:)SH 34480 XM (No)SH 9280 46158 MT (Talk to server:)SH 34480 XM (Yes; SEND, GET, FIN, BYE)SH 9280 47263 MT (Advanced commands for servers:)SH 34480 XM (No)SH 9280 48368 MT (Local file management:)SH 34480 XM (Yes)SH 9280 49473 MT (Handle file attributes:)SH 34480 XM (No)SH 9280 50578 MT (Command/init files:)SH 34480 XM (Yes)SH 9280 51683 MT (Printer control:)SH 34480 XM (No)SH 13 /Times-Bold AF 22906 55042 MT (CP/M-86 KERMIT Description)SH 10 /Times-Roman AF 8280 57415 MT (Since Kermit-86 runs on a) 133 W( standalone micro, it is always in control of the screen -- it is always)134 W /Times-Italic SF 48872 XM (local)SH /Times-Roman SF (. Thus,) 518 W( it)134 W 8280 58611 MT (always keeps the screen updated with the file name and the packet number,) 287 W( whether sending or receiving.)286 W 8280 59807 MT (Kermit-86 is capable of timing out an input request, and can thus break deadlocks automatically.) 111 W( In) 473 W( most cases,)112 W 8280 61003 MT (however, this is not desirable because the KERMIT) 198 W( on the other side is most likely better able to handle the)197 W 8280 62199 MT (timeouts; therefore, Kermit-86's timer is normally not used.)SH 8280 64591 MT (If despite the) 38 W( timeout capability, the transmission appears to be stuck \050and you can tell that this has happened if the)39 W 8280 65787 MT (screen fails to change for a long while\051 you can type carriage return) 55 W( to have the micro do what it would have done)54 W 8280 66983 MT (on a timeout, namely NAK the expected packet to cause to foreign host to send it again \050or, if the micro is sending,)23 W 8280 68179 MT (to retransmit the last) 125 W( packet\051. Micro/micro or micro/IBM-mainframe transfers could require this kind of manual)124 W 8280 69375 MT (intervention.)SH 8280 71767 MT (File transfers may be interrupted in several ways.)SH ES %%Page: 352 353 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 352)SH 12 /Times-Bold AF 30086 XM (Kermit User Guide: CP/M-86 KERMIT \05016\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (Control-C)SH 14120 XM (This will return you to Kermit-86 command level immediately, so that you can) 46 W( connect back to)47 W 14120 8991 MT (the remote system, or take any other desired action.)SH 6120 10568 MT (Control-X)SH 14120 XM (When sending a file, this will) 182 W( terminate the sending of the current file with a signal to the)181 W 14120 11673 MT (KERMIT on the other side to discard what it got so far. If there are more files to be sent,)157 W 14120 12778 MT (KERMIT-86 will go on to) 53 W( the next one. When receiving a file, KERMIT-86 will send a signal)52 W 14120 13883 MT (to the remote KERMIT to stop sending this file. If the remote KERMIT understands this) 31 W( signal)32 W 14120 14988 MT (\050not all implementations of KERMIT do\051, it will comply, otherwise the file will keep coming.)91 W 14120 16093 MT (In either case, the remote KERMIT will go on to the next file in the group, if any.)SH 6120 17670 MT (Control-Z)SH 14120 XM (Like Control-X, except if a file) 39 W( group is being transmitted, this will stop the transmission of the)40 W 14120 18775 MT (entire group. If only a single file is being transmitted, it works exactly like Control-X.)SH 6120 20352 MT (Carriage Returns)SH 14120 XM (If you type carriage return repeatedly Kermit-86 will retry the current packet up) 23 W( to its retry limit)22 W 14120 21457 MT (\050somewhere between 5) 166 W( and 16 times\051 and then, if no valid response was received, return to)167 W 14120 22562 MT (Kermit-86 command level.)SH 6120 24954 MT (When KERMIT-86 is started, it looks for the file)2 W /Courier SF 25969 XM (KERMIT.INI)SH /Times-Roman SF (. If) 254 W( found, it executes KERMIT-86 commands from)1 W 6120 26150 MT (it before prompting you for commands. The KERMIT-86 prompt looks like this:)SH /Courier SF 8520 27805 MT (Kermit-86 B3>)SH /Times-Roman SF 6120 29522 MT (in which "B" is your current default disk and "3" is the current default user number.)SH 14 /Times-Bold AF 6120 33124 MT (16.1. Kermit-86 Commands)SH 10 /Times-Roman AF 6120 35242 MT (KERMIT-86 uses the DECSYSTEM-20 keyword style command language.) 79 W( Each) 410 W( keyword may be abbreviated to)80 W 6120 36438 MT (its minumum unique length. "?" may be typed to request a menu of the available options for the current field at any)21 W 6120 37634 MT (point in) 63 W( a command. ESC may be typed at any point in a command to fill out the current keyword or filename; if)64 W 6120 38830 MT (sufficient characters have not been typed to identify the current field uniquely,) 61 W( KERMIT-86 will sound a beep and)60 W 6120 40026 MT (allow you to continue from that point.)SH 6120 41817 MT (CONNECT)SH 10120 42922 MT (Establish a "virtual terminal" connection to any host that may) 57 W( be connected to the serial port, i.e.) 56 W( pass) SH( all)56 W 10120 44027 MT (typein to) 94 W( the serial port and display all input from the serial port on the screen, using the system's own)95 W 10120 45132 MT (built-in support) 12 W( for ANSI \050VT100-like\051 screen control. When you issue the CONNECT command, the PC)11 W 10120 46237 MT (will print a message telling you how to get back by typing an) 70 W( an escape sequence, an uncommonly-used)71 W 10120 47342 MT (control character, normally CTRL-backslash, followed by a single letter "command".)SH 10120 49133 MT (C)SH 12120 XM (Close Connection, return to)SH /Courier SF 23425 XM (Kermit-86>)SH /Times-Roman SF 29675 XM (command level.)SH /Courier SF 10120 50238 MT (?)SH /Times-Roman SF 12120 XM (List available single-character commands.)SH 10120 51343 MT (B)SH 12120 XM (Send a BREAK signal.)SH 10120 52448 MT (Q)SH 12120 XM (Quit logging the remote session.)SH 10120 53553 MT (R)SH 12120 XM (Resume logging the remote session.)SH 10120 54658 MT (L)SH 12120 XM (Toggle logging.)SH /Courier SF 10120 55763 MT (^\134)SH /Times-Roman SF 12120 XM (\050or whatever - a) 70 W( second copy of the escape character\051 Send the escape character itself to the remote)69 W 12120 56868 MT (host.)SH 6120 58659 MT (SEND)SH /Times-Italic SF 8981 XM (filespec)SH /Times-Roman SF 10120 59764 MT (Send file\050s\051 specified by)SH /Times-Italic SF 20118 XM (filespec)SH /Times-Roman SF 23423 XM (to the remote Kermit, using the prevailing file mode \050ASCII or BINARY;)SH 10120 60869 MT (see SET\051. The)SH /Times-Italic SF 16313 XM (filespec)SH /Times-Roman SF 19618 XM (may contain CP/M wildcards.)SH 6120 62446 MT (RECEIVE)SH 10120 63551 MT (Receive file\050s\051 from the remote Kermit. Store them under the names) 25 W( provided in the file headers supplied)24 W 10120 64656 MT (by the remote host.) 23 W( If) 298 W( the names aren't legal, use as many legal characters from the name as possible \050see)24 W 10120 65761 MT (the description of SET FILE-WARNING below\051. If there's a conflict, and FILE-WARNING is ON,) 17 W( warn)16 W 10120 66866 MT (the user and try to build a unique name for the file by) 59 W( adding ")60 W /Courier SF (&)SH /Times-Roman SF (" characters to the name. You may also)60 W 10120 67971 MT (provide an optional file) 10 W( name in the RECEIVE command; if you do, the incoming file will be stored under)9 W 10120 69076 MT (the name you specify. If more than one file) 94 W( arrives, only the first will be stored under the given name,)95 W 10120 70181 MT (unless you included wildcard characters in the RECEIVE filespec; in that) 12 W( case, the filespec will be used as)11 W 10120 71286 MT (a mask for incoming filenames. For instance, you told the) 55 W( remote Kermit to send)56 W /Courier SF 43752 XM (*.ASM)SH /Times-Roman SF (, you could tell)56 W ES %%Page: 353 354 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (16.1. Kermit-86 Commands)SH 10 /Times-Italic AF 51275 XM (Page 353)SH 46800 50 8280 5709 UL /Times-Roman SF 12280 7886 MT (KERMIT-86 to "receive)SH /Courier SF 22269 XM (*.A86)SH /Times-Roman SF (", thereby changing the filetype of all the incoming files.)SH 8280 9463 MT (GET)SH /Times-Italic SF 10474 XM (filespec)SH /Times-Roman SF 12280 10568 MT (When Kermit-86 is talking) 67 W( to a Kermit Server on the host, you should use the GET command to request)68 W 12280 11673 MT (the server to send files to you, for example:)SH /Courier SF 29888 XM (get hlp:k*.hlp)SH /Times-Roman SF 8280 13250 MT (BYE)SH 12280 XM (When talking to a remote Kermit Server,) 104 W( this command shuts down the server and logs it out, and also)103 W 12280 14355 MT (exits from Kermit-86 to CP/M command level.)SH 8280 15932 MT (LOGOUT)SH 12280 17037 MT (Like BYE, but leaves you at Kermit-86 command level.)SH 8280 18614 MT (FINISH)SH 12280 XM (Like LOGOUT, but shuts down the remote server without logging) 200 W( it out. Leaves you at Kermit-86)199 W 12280 19719 MT (command level; a subsequent CONNECT command should put you back at host system command level.)SH 8280 21296 MT (EXIT)SH 12280 XM (Exit from KERMIT-86 back to CP/M.)SH 8280 22873 MT (QUIT)SH 12280 XM (Synonym for EXIT.)SH 8280 24450 MT (SET)SH /Times-Italic SF 10308 XM (parameter)SH /Times-Roman SF 14724 XM ([)SH /Times-Italic SF (value)SH /Times-Roman SF (])SH 12280 25555 MT (Set the specified parameter to the specified value. Possible settings:)SH 12280 27346 MT (BAUD)SH 16280 XM (Change the) 23 W( baud rate of the communications port. This command only works on some systems,)22 W 16280 28451 MT (and its actual operation can vary from system to) 180 W( system. Type SET BAUD followed by a)181 W 16280 29556 MT (question mark, and follow the) 106 W( directions. On systems that do not support this command, you)105 W 16280 30661 MT (must set the port baud rate from CP/M or other setup mechanism outside of KERMIT-86.)SH 12280 32238 MT (DEBUG)SH 16280 XM (ON or OFF. If ON, displays incoming and outbound packets during file transfer. OFF by)170 W 16280 33343 MT (default.)SH 12280 34920 MT (DEFAULT-DISK)SH /Times-Italic SF 19751 XM (disk/user)SH /Times-Roman SF 16280 36025 MT (Specify default disk and user number for subsequent file) 224 W( reception and transmission. The)225 W 16280 37130 MT (specification following the command must be in one of the following forms:)SH /Courier SF 18280 38921 MT (d:)SH /Times-Roman SF 20280 XM (= go to drive d \050A through P\051 without changing user)SH /Courier SF 18280 40026 MT (u:)SH /Times-Roman SF 20280 XM (= go to user u \0500 through 15\051 without changing drive)SH /Courier SF 18280 41131 MT (du:)SH /Times-Roman SF 20280 XM (= go to drive d and user u)SH /Courier SF 18280 42236 MT (:)SH /Times-Roman SF 20280 XM (= go to the defaults when Kermit was loaded)SH 16280 44027 MT (Whenever a drive is) 126 W( specified, even if it is the same as the current default drive, the drive is)125 W 16280 45132 MT (logged in so that disks) 212 W( can be swapped without exiting Kermit to type control-C. Kermit)213 W 16280 46237 MT (restores the original drive and user upon termination.)SH 12280 47814 MT (ESCAPE)SH 16280 XM (Change the escape character for virtual terminal connections. Select a) 84 W( character in the control)83 W 16280 48919 MT (range that you will not be likely) 135 W( to need at the remote host; type the new character literally.)136 W 16280 50024 MT (Certain characters, like Control-X, cannot be specified.)SH 12280 51601 MT (FILE-TYPE)SH 16280 52706 MT (Tells KERMIT-86 what kind of file it is sending,) 68 W( so that KERMIT can correctly determine the)69 W 16280 53811 MT (end of the file.) 30 W( SET) 309 W( FILE BINARY means to send all the 128-byte blocks of the file, including)29 W 16280 54916 MT (the last block in its entirety;) 17 W( SET FILE ASCII is used for text files, and transmission stops when)18 W 16280 56021 MT (the first Control-Z is encountered anywhere in the file) 30 W( \050this is the CP/M convention for marking)29 W 16280 57126 MT (the end of a text file\051. If binary transmission is used) 63 W( on a text file, some extraneous characters)64 W 16280 58231 MT (\050up to 127 of them\051 may appear at the end of the file on the target system. If ASCII transmission)SH 16280 59336 MT (is used on a binary file, the entire file will not be sent if it happens to contain any) 17 W( data bytes that)18 W 16280 60441 MT (correspond to Control-Z. ASCII is the default.)SH 12280 62018 MT (FLOW-CONTROL)SH 16280 63123 MT (Select the desired type of flow control to) 73 W( be used on the communication line. The choices are)74 W 16280 64228 MT (NONE and XON/XOFF. XON/XOFF is the default. If the remote system is not full) 49 W( duplex or)48 W 16280 65333 MT (cannot do XON/XOFF, you should use NONE.)SH 12280 66910 MT (IBM ON \050or OFF\051)SH 16280 68015 MT (Allow the transfer) 125 W( of files to and from an IBM mainframe computer. This makes Kermit-86)124 W 16280 69120 MT (wait for the IBM turnaround) 61 W( character \050XON\051, ignore parity on input, add appropriate parity to)62 W 16280 70225 MT (output, and use local echoing during) 167 W( CONNECT. As distributed, KERMIT-86 uses MARK)166 W 16280 71330 MT (parity for IBM communication. If you) 4 W( don't give this command, IBM mode is OFF. Since IBM)5 W ES %%Page: 354 355 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 354)SH 12 /Times-Bold AF 29186 XM (Kermit User Guide: CP/M-86 KERMIT \05016.1\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 14120 7886 MT (VM/CMS KERMIT does not have timeout capability, SET IBM ON also turns on the) 87 W( timeout)86 W 14120 8991 MT (facility automatically, as if you had typed "SET TIMER ON".)SH 10120 10568 MT (LOCAL-ECHO ON \050or OFF\051)SH 14120 11673 MT (When you CONNECT to a) 136 W( remote host, you must set LOCAL-ECHO ON if the host is half)135 W 14120 12778 MT (duplex, OFF if full duplex. OFF by default.)SH 10120 14355 MT (LOG)SH 14120 XM (Specify a log file on the current CP/M disk into which to record incoming characters during)137 W 14120 15460 MT (CONNECT. If) 576 W( the remote host can do XON/XOFF, then the log file will) 163 W( normally capture)162 W 14120 16565 MT (every character shown on the screen. When connected to the remote) 141 W( system, several single-)142 W 14120 17670 MT (character arguments to the connect escape character can be used to control logging) 11 W( -- Q \050quit\051, R)10 W 14120 18775 MT (\050resume\051, L \050toggle\051. If you use R or L during connect without) 3 W( having previously specified a log)4 W 14120 19880 MT (file name, then)SH /Courier SF 20341 XM (KERMIT.LOG)SH /Times-Roman SF 26591 XM (is used. An open log is closed when you escape back to the PC.)SH 10120 21457 MT (PARITY)SH 14120 XM (Sets parity for outgoing characters to one of) 50 W( the following: NONE, SPACE, MARK, EVEN, or)49 W 14120 22562 MT (ODD. On) 285 W( input, if parity is NONE, then the 8th bit is kept \050as data\051, otherwise it is stripped and)18 W 14120 23667 MT (ignored. The) 560 W( parity setting applies to both terminal) 155 W( connection and file transfer. If you set)154 W 14120 24772 MT (parity to anything other than NONE, Kermit-86 will attempt to use "8th) 10 W( bit prefixing" to transfer)11 W 14120 25877 MT (binary files. If the other KERMIT is also capable) 70 W( of 8th bit prefixing, then binary files can be)69 W 14120 26982 MT (transferred successfully; if not, the 8th bit of each data byte will be lost \050you will) 40 W( see a warning)41 W 14120 28087 MT (on your screen if this happens\051.)SH 10120 29664 MT (PORT)SH 14120 XM (Allows you to switch between different communication ports on the PC. This command) 61 W( is not)60 W 14120 30769 MT (available on all systems.)SH 10120 32346 MT (TIMER ON \050or OFF\051)SH 14120 33451 MT (Enable or disable the timeout facility.) 89 W( The) 426 W( timer is off by default, because in the normal case)88 W 14120 34556 MT (KERMIT-86 is communicating) 61 W( with a mainframe KERMIT that has its own timer. Mainframe)62 W 14120 35661 MT (KERMIT timers tend to) 47 W( be more precise or adaptable to changing conditions. You should SET)46 W 14120 36766 MT (TIMER ON) 65 W( if you are communicating with another KERMIT that does not have a timer. You)66 W 14120 37871 MT (should SET TIMER OFF if you are communicating over a network with long delays.)SH 10120 39448 MT (WARNING ON \050or OFF\051)SH 14120 40553 MT (Warn user of filename) 5 W( conflicts when receiving files from remote host, and attempt to generate a)6 W 14120 41658 MT (unique name by adding ")SH /Courier SF (&)SH /Times-Roman SF (" characters to the given name. OFF by default.)SH 6120 43449 MT (SHOW)SH 10120 XM (Show the current settings of the SET parameters.)SH 6120 45026 MT (TAKE)SH 10120 XM (Take KERMIT-86 commands from the specified) 47 W( file. The file should not contain any TAKE commands;)46 W 10120 46131 MT (nested command files do not work.)SH 6120 47708 MT (LOCAL)SH 10120 XM (This is a prefix for local file management commands, to distinguish them from remote file management)87 W 10120 48813 MT (commands \050which aren't implemented yet\051. The LOCAL prefix is) 23 W( optional; if left off, the commands will)22 W 10120 49918 MT (be performed locally.)SH 10120 51709 MT (SPACE)SH 18120 XM (Show how much space is used and remaining on the current disk.)SH 10120 53286 MT (DIRECTORY)SH 18120 XM (Provide a directory) 14 W( listing for the current disk, showing the name and size of each file.)15 W 18120 54391 MT (A filespec may be given to select only a certain file or wildcard file group.)SH 10120 55968 MT (DELETE)SH 18120 XM (Delete the specified files from the current disk.)SH 10120 57545 MT (TYPE)SH 18120 XM (A wildcard filespec is accepted and files) 195 W( displayed alphabetically. The display is)194 W 18120 58650 MT (paged in Unix fashion with ")7 W /Courier SF (--more--)SH /Times-Roman SF (" displayed on the last line.) 7 W( Typein) 266 W( options at)8 W 18120 59755 MT (that point can be obtained by hitting a ')SH /Courier SF (?)SH /Times-Roman SF ('.)SH 14 /Times-Bold AF 6120 63357 MT (16.2. Installation:)SH 10 /Times-Roman AF 6120 65475 MT (CP/M-86 KERMIT is broken up into several source modules:)SH /Courier SF 10920 67192 MT (C86CMD.A86)SH /Times-Roman SF 22920 XM (Command parser)SH /Courier SF 10920 68223 MT (C86FIL.A86)SH /Times-Roman SF 22920 XM (File handler)SH /Courier SF 10920 69254 MT (C86Xxx.A86)SH /Times-Roman SF 22920 XM (System Dependent I/O)SH /Courier SF 10920 70285 MT (C86KER.A86)SH /Times-Roman SF 22920 XM (Main Program)SH /Courier SF 10920 71316 MT (C86PRO.A86)SH /Times-Roman SF 22920 XM (Protocol Module)SH ES %%Page: 355 356 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (16.2. Installation:)SH 10 /Times-Italic AF 51275 XM (Page 355)SH 46800 50 8280 5709 UL /Courier SF 13080 7886 MT (C86TRM.A86)SH /Times-Roman SF 25080 XM (Terminal Emulation)SH /Courier SF 13080 8917 MT (C86UTL.A86)SH /Times-Roman SF 25080 XM (Utilities)SH 8280 11309 MT (The main program module,)43 W /Courier SF 19645 XM (C86KER.A86)SH /Times-Roman SF (, contains INCLUDE directives for the) 43 W( other files. The C86Xxx module)42 W 8280 12505 MT (is stored with "xx" replaced by codes denoting the machine) 17 W( for which the program is being built -- RB for Rainbow,)18 W 8280 13701 MT (AP for NEC APC,) 88 W( etc. The program may be built on the CP/M-86 system by obtaining all the source files listed)87 W 8280 14897 MT (above, storing them on the current disk) 19 W( with the names indicated, renaming the appropriate)20 W /Courier SF 45215 XM (C86Xxx.A86)SH /Times-Roman SF 51485 XM (file to be)20 W /Courier SF 8280 16093 MT (C86XXX.A86)SH /Times-Roman SF (, and then doing:)SH /Courier SF 13080 17810 MT (ASM86 C86KER $PZ)SH /Times-Roman SF 23880 XM (\050takes about 6 minutes on the Rainbow\051)SH /Courier SF 13080 18841 MT (GENCMD C86KER)SH /Times-Roman SF 23880 XM (\050takes less than a minute\051)SH 8280 20558 MT (and, if desired,)SH /Courier SF 13080 22213 MT (REN KERMIT.CMD=C86KER.CMD)SH 14 /Times-Bold AF 8280 25815 MT (16.3. DEC Rainbow 100 Support)SH 10 /Times-Roman AF 8280 27933 MT (Kermit-86 runs on the DEC Rainbow 100 or 100+ under CP/M-86/80, version 1 or 2, on the 8088 side. It uses) 45 W( the)44 W 8280 29129 MT (built-in firmware to emulate a VT102 ANSI terminal during CONNECT, and runs well at speeds up to 9600 baud.)SH 8280 31521 MT (You should be able to download the program using the old KERMIT on the) 120 W( Z80 side \050Rainbow Kermit, VT180)121 W 8280 32717 MT (Kermit, or generic CP/M-80 Kermit will do the job, but only under DEC CP/M-86/80) 119 W( version 1.0\051, or an earlier)118 W 8280 33913 MT (version of Kermit-86.)SH 8280 36305 MT (If you) 237 W( don't have an earlier version of KERMIT, then follow the directions for installing KERMIT-80 \050yes,)238 W 8280 37501 MT (KERMIT-80\051 in the KERMIT-80 section of the)67 W /Times-Italic SF 28051 XM (Kermit User Guide)66 W /Times-Roman SF (, but send the Kermit-86 hex file instead. This)66 W 8280 38697 MT (works because the Rainbow can run CP/M-80 programs like DDT.)SH 8280 41089 MT (Another way to get Kermit onto your Rainbow for the first time would be from a DEC VT-180 diskette.) 25 W( A) 302 W( VT-180)26 W 8280 42285 MT (can use its own Kermit to load Rainbow) 36 W( Kermit onto its disk, which can then be read directly by a Rainbow. Also,)35 W 8280 43481 MT (note that VT-180 Kermit-80 can actually run on the Rainbow on the Z80) 103 W( side under DEC CP/M-86/80 version 1)104 W 8280 44677 MT (\050but not version 2 or higher\051, at speeds of 1800 baud or lower.)SH 14 /Times-Bold AF 8280 48279 MT (16.4. NEC Advanced Personal Computer Support)SH 10 /Times-Roman AF 8280 50397 MT (\050Contributed by Ron Blanford, University of Washington\051)SH 8280 52789 MT (Currently only) 5 W( the standard serial port is supported, and not the H14 auxiliary port. The SET PORT command is not)4 W 8280 53985 MT (implemented.)SH 8280 56377 MT (While in Kermit's terminal emulation mode, local commands are initiated by a two-character sequence) 13 W( consisting of)14 W 8280 57573 MT (the "escape character" followed by one other character identifying the command. \050Make the second character a '?')49 W 8280 58769 MT (to see a list of the) 38 W( valid commands.\051 As distributed, the standard Kermit-86 uses the control-backslash character as)39 W 8280 59965 MT (the escape character in terminal mode. The trouble is that the CP/M-86 BIOS in the APC ignores a keyboard) 39 W( entry)38 W 8280 61161 MT (of Control-\134 \050i.e. holding down the CTRL key while striking the '\134' key\051, making) 36 W( it difficult \050impossible\051 to use this)37 W 8280 62357 MT (method to get out of terminal mode.)SH 8280 64749 MT (One solution is to perform a "SET ESCAPE ^" command before entering terminal mode to) 173 W( change the escape)172 W 8280 65945 MT (character to) 5 W( a caret \050or any other character the APC keyboard will generate\051. This command could be placed in your)6 W /Courier SF 8280 67141 MT (KERMIT.INI)SH /Times-Roman SF 14530 XM (file for automatic execution every time Kermit is started.)SH 8280 69533 MT (The simpler solution is) 6 W( to realize that the character code for a Control-\134 is a hexadecimal 1C, and that this is the code)5 W 8280 70729 MT (generated by) 33 W( the INS key on the numeric keypad. Once you can remember that every reference to Control-\134 should)34 W 8280 71925 MT (be interpreted as a reference to the INS key, this is actually easier to use than the two-key Control-\134 sequence.)SH ES %%Page: 356 357 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 356)SH 12 /Times-Bold AF 29186 XM (Kermit User Guide: CP/M-86 KERMIT \05016.4\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (In the standard CP/M-86 BIOS, the unshifted DEL key generates) 66 W( a Control-X character \050hexadecimal 18\051. This is)65 W 6120 9082 MT (the CP/M command to erase the current input line, and is very useful) 26 W( for local processing. Most mainframes do not)27 W 6120 10278 MT (use the) 86 W( Control-X character at all, so it becomes much less useful during terminal emulation. The DEL character)85 W 6120 11474 MT (\050hexadecimal 7F\051, on the other hand, is often used by mainframes and can only be generated on the) 18 W( APC by holding)19 W 6120 12670 MT (down the SHIFT key while striking the DEL key \050this capability is not mentioned anywhere in the documentation\051.)SH 6120 15062 MT (Because the Control-X character is so seldom used while the DEL character) 115 W( is commonly used, the initialization)114 W 6120 16258 MT (procedure in Kermit-86 modifies the CP/M-86 BIOS so that the DEL key) 144 W( generates the DEL character whether)145 W 6120 17454 MT (shifted or not. Control-X can still be generated if necessary by holding down the CTRL key while striking the 'X')50 W 6120 18650 MT (key. The) 250 W( CP/M-86 BIOS is returned to its original state when Kermit terminates.)SH 6120 21042 MT (The APC uses escape sequences which have been standardized by the) SH( American National Standards Institute \050ANSI\051)1 W 6120 22238 MT (to control cursor) 140 W( movement, screen erasing, and character attribute manipulation. Perhaps the best-known other)139 W 6120 23434 MT (terminal which follows ANSI guidelines is the DEC VT100. The APC only recognizes a few of the more important)19 W 6120 24630 MT (ANSI commands, and not the complete set which the VT100 supports.)SH 6120 27022 MT (The ANSI/VT100 features that the NEC APC supports are:)SH /Symbol SF 7910 28927 MT (\267)SH /Times-Roman SF 8620 XM (direct cursor addressing \050by row and column\051)SH /Symbol SF 7910 30032 MT (\267)SH /Times-Roman SF 8620 XM (relative cursor addressing \050up, down, left, right\051)SH /Symbol SF 7910 31137 MT (\267)SH /Times-Roman SF 8620 XM (line erasing \050cursor to end, beginning to cursor, entire line\051)SH /Symbol SF 7910 32242 MT (\267)SH /Times-Roman SF 8620 XM (screen erasing \050cursor to end, beginning to cursor, entire screen\051)SH /Symbol SF 7910 33347 MT (\267)SH /Times-Roman SF 8620 XM (character attributes \050underline, reverse video, blink, but not bold\051)SH 6120 35138 MT (In addition, the first four grey function keys \050unshifted\051 generate the escape sequences associated with) 42 W( PF1 through)41 W 6120 36334 MT (PF4 on the VT100 keyboard. The arrow keys and numeric keypad DO NOT generate the corresponding VT100)113 W 6120 37530 MT (sequences.)SH 6120 39922 MT (These functions are enough to) 84 W( support simple command line editing on most systems, and allow mailers or paged)83 W 6120 41118 MT (file display programs to clear the screen before each display. Underlining and reverse video are also) 25 W( useful in some)26 W 6120 42314 MT (applications. This) 318 W( is not enough to support the more sophisticated screen control required by screen editors such as)34 W 6120 43510 MT (EMACS or KED. In addition, due to a bug in the implementation of the) 80 W( CP/M-86 BIOS, the sequence ordinarily)81 W 6120 44706 MT (used to home the) 75 W( cursor \050esc [ H\051 does not work correctly; a patch for CP/M to correct this problem is distributed)74 W 6120 45902 MT (with APC Kermit-86.)SH ES %%Page: 357 358 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (I. The ASCII Character Set)SH 10 /Times-Italic AF 51275 XM (Page 357)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 27834 8272 MT (Appendix I)SH 22949 9680 MT (The ASCII Character Set)SH 10 /Times-Roman AF 8280 11974 MT (ASCII Code \050ANSI X3.4-1968\051)SH 12776 50 8280 12174 UL 8280 14366 MT (There are 128 characters in the ASCII \050American national Standard Code for) 69 W( Information Interchange\051 "alphabet".)70 W 8280 15562 MT (The characters are listed in order of ASCII value; the columns are labeled as follows:)SH 8280 17353 MT (Bit)SH 16280 XM (Even parity bit for ASCII character.)SH 8280 18458 MT (ASCII Dec)SH 16280 XM (Decimal \050base 10\051 representation.)SH 8280 19563 MT (ASCII Oct)SH 16280 XM (Octal \050base 8\051 representation.)SH 8280 20668 MT (ASCII Hex)SH 16280 XM (Hexadecimal \050base 16\051 representation.)SH 8280 21773 MT (EBCDIC Hex)SH 16280 XM (EBCDIC hexadecimal equivalent for Kermit translate tables.)SH 8280 22878 MT (Char)SH 16280 XM (Name or graphical representation of character.)SH 8280 23983 MT (Remark)SH 16280 XM (Description of character.)SH 8280 25774 MT (The first group consists of nonprintable 'control' characters:)SH /Courier SF 11280 27429 MT (.....ASCII.... EBCDIC)SH 8280 28460 MT (Bit Dec) 600 W( Oct) 1200 W( Hex Hex Char Remarks)600 W 1800 50 8280 28660 UL 1800 50 11280 28660 UL 1800 50 14880 28660 UL 1800 50 17880 28660 UL 1800 50 20880 28660 UL 2400 50 25080 28660 UL 4200 50 28680 28660 UL 8880 29491 MT (0 000 000 00 00) 1200 W( NUL) 1800 W( ^@,) 1200 W( Null, Idle)SH 8880 30522 MT (1 001 001 01 01) 1200 W( SOH) 1800 W( ^A,) 1200 W( Start of heading)SH 8880 31553 MT (1 002 002 02 02) 1200 W( STX) 1800 W( ^B,) 1200 W( Start of text)SH 8880 32584 MT (0 003 003 03 03) 1200 W( ETX) 1800 W( ^C,) 1200 W( End of text)SH 8880 33615 MT (1 004 004 04 37) 1200 W( EOT) 1800 W( ^D,) 1200 W( End of transmission)SH 8880 34646 MT (0 005 005 05 2D) 1200 W( ENQ) 1800 W( ^E,) 1200 W( Enquiry)SH 8880 35677 MT (0 006 006 06 2E) 1200 W( ACK) 1800 W( ^F,) 1200 W( Acknowledge)SH 8880 36708 MT (1 007 007 07 2F) 1200 W( BEL) 1800 W( ^G,) 1200 W( Bell, beep, or fleep)SH 8880 37739 MT (1 008 010 08 16) 1200 W( BS ^H,) 1800 W( Backspace)SH 8880 38770 MT (0 009 011 09 05) 1200 W( HT ^I,) 1800 W( Horizontal tab)SH 8880 39801 MT (0 010 012 0A 25) 1200 W( LF ^J,) 1800 W( Line feed)SH 8880 40832 MT (1 011 013 0B 0B) 1200 W( VT ^K,) 1800 W( Vertical tab)SH 8880 41863 MT (0 012 014 0C 0C) 1200 W( FF ^L,) 1800 W( Form feed \050top of page\051)SH 8880 42894 MT (1 013 015 0D 0D) 1200 W( CR ^M,) 1800 W( Carriage return)SH 8880 43925 MT (1 014 016 0E 0E) 1200 W( SO ^N,) 1800 W( Shift out)SH 8880 44956 MT (0 015 017 0F 0F) 1200 W( SI ^O,) 1800 W( Shift in)SH 8880 45987 MT (1 016 020 10 10) 1200 W( DLE) 1800 W( ^P,) 1200 W( Data link escape)SH 8880 47018 MT (0 017 021 11 11) 1200 W( DC1) 1800 W( ^Q,) 1200 W( Device control 1, XON)SH 8880 48049 MT (0 018 022 12 12) 1200 W( DC2) 1800 W( ^R,) 1200 W( Device control 2)SH 8880 49080 MT (1 019 023 13 13) 1200 W( DC3) 1800 W( ^S,) 1200 W( Device control 3, XOFF)SH 8880 50111 MT (0 020 024 14 3C) 1200 W( DC4) 1800 W( ^T,) 1200 W( Device control 4)SH 8880 51142 MT (1 021 025 15 3D) 1200 W( NAK) 1800 W( ^U,) 1200 W( Negative acknowledge)SH 8880 52173 MT (1 022 026 16 32) 1200 W( SYN) 1800 W( ^V,) 1200 W( Synchronous idle)SH 8880 53204 MT (0 023 027 17 26) 1200 W( ETB) 1800 W( ^W,) 1200 W( End of transmission block)SH 8880 54235 MT (0 024 030 18 18) 1200 W( CAN) 1800 W( ^X,) 1200 W( Cancel)SH 8880 55266 MT (1 025 031 19 19) 1200 W( EM ^Y,) 1800 W( End of medium)SH 8880 56297 MT (1 026 032 1A 3F) 1200 W( SUB) 1800 W( ^Z,) 1200 W( Substitute)SH 8880 57328 MT (0 027 033 1B 27) 1200 W( ESC) 1800 W( ^[,) 1200 W( Escape, prefix, altmode)SH 8880 58359 MT (1 028 034 1C 1C) 1200 W( FS ^\134,) 1800 W( File separator)SH 8880 59390 MT (0 029 035 1D 1D) 1200 W( GS ^],) 1800 W( Group separator)SH 8880 60421 MT (0 030 036 1E 1E) 1200 W( RS ^^,) 1800 W( Record separator)SH 8880 61452 MT (1 031 037 1F 1F) 1200 W( US ^_,) 1800 W( Unit separator)SH /Times-Roman SF 8280 63169 MT (The last four are usually associated with the control version of backslash, right square bracket, uparrow \050or)252 W 8280 64365 MT (circumflex\051, and underscore, respectively, but some terminals do not transmit these control characters.)SH ES %%Page: 358 359 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 358)SH 12 /Times-Bold AF 27687 XM (Kermit User Guide: The ASCII Character Set \050I\051)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (The following characters are printable:)SH 6120 9603 MT (First, some punctuation characters.)SH /Courier SF 9120 11665 MT (.....ASCII.... EBCDIC)SH 6120 12696 MT (Bit Dec) 600 W( Oct) 1200 W( Hex Hex Char Remarks)600 W 1800 50 6120 12896 UL 1800 50 9120 12896 UL 1800 50 12720 12896 UL 1800 50 15720 12896 UL 1800 50 18720 12896 UL 2400 50 22920 12896 UL 4200 50 26520 12896 UL 6720 13727 MT (1 032 040 20 40) 1200 W( SP Space,) 1800 W( blank)SH 6720 14758 MT (0 033 041 21 5A) 1200 W( !) 1800 W( Exclamation) 2400 W( mark)SH 6720 15789 MT (0 034 042 22 7F) 1200 W( ") 1800 W( Doublequote)2400 W 6720 16820 MT (1 035 043 23 7B) 1200 W( #) 1800 W( Number) 2400 W( sign, pound sign)SH 6720 17851 MT (0 036 044 24 5B) 1200 W( $) 1800 W( Dollar) 2400 W( sign)SH 6720 18882 MT (1 037 045 25 6C) 1200 W( %) 1800 W( Percent) 2400 W( sign)SH 6720 19913 MT (1 038 046 26 50) 1200 W( &) 1800 W( Ampersand)2400 W 6720 20944 MT (0 039 047 27 7D) 1200 W( ') 1800 W( Apostrophe,) 2400 W( accent acute)SH 6720 21975 MT (0 040 050 28 4D) 1200 W( \050) 1800 W( Left) 2400 W( parenthesis)SH 6720 23006 MT (1 041 051 29 5D) 1200 W( \051) 1800 W( Right) 2400 W( parenthesis)SH 6720 24037 MT (1 042 052 2A 5C) 1200 W( *) 1800 W( Asterisk,) 2400 W( star)SH 6720 25068 MT (0 043 053 2B 4E) 1200 W( +) 1800 W( Plus) 2400 W( sign)SH 6720 26099 MT (1 044 054 2C 6B) 1200 W( ,) 1800 W( Comma)2400 W 6720 27130 MT (0 045 055 2D 60) 1200 W( -) 1800 W( Dash,) 2400 W( hyphen, minus sign)SH 6720 28161 MT (0 046 056 2E 4B) 1200 W( .) 1800 W( Period,) 2400 W( dot)SH 6720 29192 MT (1 047 057 2F 61) 1200 W( /) 1800 W( Slash)2400 W /Times-Roman SF 6120 30909 MT (Numeric characters:)SH /Courier SF 9120 32971 MT (.....ASCII.... EBCDIC)SH 6120 34002 MT (Bit Dec) 600 W( Oct) 1200 W( Hex Hex Char Remarks)600 W 1800 50 6120 34202 UL 1800 50 9120 34202 UL 1800 50 12720 34202 UL 1800 50 15720 34202 UL 1800 50 18720 34202 UL 2400 50 22920 34202 UL 4200 50 26520 34202 UL 6720 35033 MT (0 048 060 30 F0) 1200 W( 0) 1800 W( Zero)2400 W 6720 36064 MT (1 049 061 31 F1) 1200 W( 1) 1800 W( One)2400 W 6720 37095 MT (1 050 062 32 F2) 1200 W( 2) 1800 W( Two)2400 W 6720 38126 MT (0 051 063 33 F3) 1200 W( 3) 1800 W( Three)2400 W 6720 39157 MT (1 052 064 34 F4) 1200 W( 4) 1800 W( Four)2400 W 6720 40188 MT (0 053 065 35 F5) 1200 W( 5) 1800 W( Five)2400 W 6720 41219 MT (0 054 066 36 F6) 1200 W( 6) 1800 W( Six)2400 W 6720 42250 MT (1 055 067 37 F7) 1200 W( 7) 1800 W( Seven)2400 W 6720 43281 MT (1 056 070 38 F8) 1200 W( 8) 1800 W( Eight)2400 W 6720 44312 MT (0 057 071 39 F9) 1200 W( 9) 1800 W( Nine)2400 W /Times-Roman SF 6120 46029 MT (More punctuation characters:)SH /Courier SF 9120 48091 MT (.....ASCII.... EBCDIC)SH 6120 49122 MT (Bit Dec) 600 W( Oct) 1200 W( Hex Hex Char Remarks)600 W 1800 50 6120 49322 UL 1800 50 9120 49322 UL 1800 50 12720 49322 UL 1800 50 15720 49322 UL 1800 50 18720 49322 UL 2400 50 22920 49322 UL 4200 50 26520 49322 UL 6720 50153 MT (0 058 072 3A 7A) 1200 W( :) 1800 W( Colon)2400 W 6720 51184 MT (1 059 073 3B 5E) 1200 W( ;) 1800 W( Semicolon)2400 W 6720 52215 MT (0 060 074 3C 4C) 1200 W( <) 1800 W( Left) 2400 W( angle bracket)SH 6720 53246 MT (1 061 075 3D 7E) 1200 W( =) 1800 W( Equal) 2400 W( sign)SH 6720 54277 MT (1 062 076 3E 6E) 1200 W( >) 1800 W( Right) 2400 W( angle bracket)SH 6720 55308 MT (0 063 077 3F 6F) 1200 W( ?) 1800 W( Question) 2400 W( mark)SH 6720 56339 MT (1 064 100 40 7C) 1200 W( @) 1800 W( "At") 2400 W( sign)SH ES %%Page: 359 360 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (I. The ASCII Character Set)SH 10 /Times-Italic AF 51275 XM (Page 359)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (Upper-case alphabetic characters \050letters\051:)SH /Courier SF 11280 9948 MT (.....ASCII.... EBCDIC)SH 8280 10979 MT (Bit Dec) 600 W( Oct) 1200 W( Hex Hex Char Remarks)600 W 1800 50 8280 11179 UL 1800 50 11280 11179 UL 1800 50 14880 11179 UL 1800 50 17880 11179 UL 1800 50 20880 11179 UL 2400 50 25080 11179 UL 4200 50 28680 11179 UL 8880 12010 MT (0 065 101 41 C1) 1200 W( A)1800 W 8880 13041 MT (0 066 102 42 C2) 1200 W( B)1800 W 8880 14072 MT (1 067 103 43 C3) 1200 W( C)1800 W 8880 15103 MT (0 068 104 44 C4) 1200 W( D)1800 W 8880 16134 MT (1 069 105 45 C5) 1200 W( E)1800 W 8880 17165 MT (1 070 106 46 C6) 1200 W( F)1800 W 8880 18196 MT (0 071 107 47 C7) 1200 W( G)1800 W 8880 19227 MT (0 072 110 48 C8) 1200 W( H)1800 W 8880 20258 MT (1 073 111 49 C9) 1200 W( I)1800 W 8880 21289 MT (1 074 112 4A D1) 1200 W( J)1800 W 8880 22320 MT (0 075 113 4B D2) 1200 W( K)1800 W 8880 23351 MT (1 076 114 4C D3) 1200 W( L)1800 W 8880 24382 MT (0 077 115 4D D4) 1200 W( M)1800 W 8880 25413 MT (0 078 116 4E D5) 1200 W( N)1800 W 8880 26444 MT (1 079 117 4F D6) 1200 W( O)1800 W 8880 27475 MT (0 080 120 50 D7) 1200 W( P)1800 W 8880 28506 MT (1 081 121 51 D8) 1200 W( Q)1800 W 8880 29537 MT (1 082 122 52 D9) 1200 W( R)1800 W 8880 30568 MT (0 083 123 53 E2) 1200 W( S)1800 W 8880 31599 MT (1 084 124 54 E3) 1200 W( T)1800 W 8880 32630 MT (0 085 125 55 E4) 1200 W( U)1800 W 8880 33661 MT (0 086 126 56 E5) 1200 W( V)1800 W 8880 34692 MT (1 087 127 57 E6) 1200 W( W)1800 W 8880 35723 MT (1 088 130 58 E7) 1200 W( X)1800 W 8880 36754 MT (0 089 131 59 E8) 1200 W( Y)1800 W 8880 37785 MT (0 090 132 5A E9) 1200 W( Z)1800 W /Times-Roman SF 8280 39502 MT (More punctuation characters:)SH /Courier SF 11280 41564 MT (.....ASCII.... EBCDIC)SH 8280 42595 MT (Bit Dec) 600 W( Oct) 1200 W( Hex Hex Char Remarks)600 W 1800 50 8280 42795 UL 1800 50 11280 42795 UL 1800 50 14880 42795 UL 1800 50 17880 42795 UL 1800 50 20880 42795 UL 2400 50 25080 42795 UL 4200 50 28680 42795 UL 8880 43626 MT (1 091 133 5B AD) 1200 W( [) 1800 W( Left) 2400 W( square bracket)SH 8880 44657 MT (0 092 134 5C E0) 1200 W( \134) 1800 W( Backslash)2400 W 8880 45688 MT (1 093 135 5D BD) 1200 W( ]) 1800 W( Right) 2400 W( square bracket)SH 8880 46719 MT (1 094 136 5E 5F) 1200 W( ^) 1800 W( Circumflex,) 2400 W( up arrow)SH 8880 47750 MT (0 095 137 5F 6D) 1200 W( _) 1800 W( Underscore,) 2400 W( left arrow)SH 8880 48781 MT (0 096 140 60 79) 1200 W( `) 1800 W( Accent) 2400 W( grave)SH ES %%Page: 360 361 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 360)SH 12 /Times-Bold AF 43052 XM (Kermit User Guide)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (Lower-case alphabetic characters \050letters\051:)SH /Courier SF 9120 9948 MT (.....ASCII.... EBCDIC)SH 6120 10979 MT (Bit Dec) 600 W( Oct) 1200 W( Hex Hex Char Remarks)600 W 1800 50 6120 11179 UL 1800 50 9120 11179 UL 1800 50 12720 11179 UL 1800 50 15720 11179 UL 1800 50 18720 11179 UL 2400 50 22920 11179 UL 4200 50 26520 11179 UL 6720 12010 MT (1 097 141 61 81) 1200 W( a)1800 W 6720 13041 MT (1 098 142 62 82) 1200 W( b)1800 W 6720 14072 MT (0 099 143 63 83) 1200 W( c)1800 W 6720 15103 MT (1 100 144 64 84) 1200 W( d)1800 W 6720 16134 MT (0 101 145 65 85) 1200 W( e)1800 W 6720 17165 MT (0 102 146 66 86) 1200 W( f)1800 W 6720 18196 MT (1 103 147 67 87) 1200 W( g)1800 W 6720 19227 MT (1 104 150 68 88) 1200 W( h)1800 W 6720 20258 MT (0 105 151 69 89) 1200 W( i)1800 W 6720 21289 MT (0 106 152 6A 91) 1200 W( j)1800 W 6720 22320 MT (1 107 153 6B 92) 1200 W( k)1800 W 6720 23351 MT (0 108 154 6C 93) 1200 W( l)1800 W 6720 24382 MT (1 109 155 6D 94) 1200 W( m)1800 W 6720 25413 MT (1 110 156 6E 95) 1200 W( n)1800 W 6720 26444 MT (0 111 157 6F 96) 1200 W( o)1800 W 6720 27475 MT (1 112 160 70 97) 1200 W( p)1800 W 6720 28506 MT (0 113 161 71 98) 1200 W( q)1800 W 6720 29537 MT (0 114 162 72 99) 1200 W( r)1800 W 6720 30568 MT (1 115 163 73 A2) 1200 W( s)1800 W 6720 31599 MT (0 116 164 74 A3) 1200 W( t)1800 W 6720 32630 MT (1 117 165 75 A4) 1200 W( u)1800 W 6720 33661 MT (1 118 166 76 A5) 1200 W( v)1800 W 6720 34692 MT (0 119 167 77 A6) 1200 W( w)1800 W 6720 35723 MT (0 120 170 78 A7) 1200 W( x)1800 W 6720 36754 MT (1 121 171 79 A8) 1200 W( y)1800 W 6720 37785 MT (1 122 172 7A A9) 1200 W( z)1800 W /Times-Roman SF 6120 39502 MT (More punctuation characters:)SH /Courier SF 9120 41564 MT (.....ASCII.... EBCDIC)SH 6120 42595 MT (Bit Dec) 600 W( Oct) 1200 W( Hex Hex Char Remarks)600 W 1800 50 6120 42795 UL 1800 50 9120 42795 UL 1800 50 12720 42795 UL 1800 50 15720 42795 UL 1800 50 18720 42795 UL 2400 50 22920 42795 UL 4200 50 26520 42795 UL 6720 43626 MT (0 123 173 7B C0) 1200 W( {) 2400 W( Left) 1800 W( brace \050curly bracket\051)SH 6720 44657 MT (1 124 174 7C 4F) 1200 W( |) 2400 W( Vertical) 1800 W( bar)SH 6720 45688 MT (0 125 175 7D D0) 1200 W( }) 2400 W( Right) 1800 W( brace \050curly bracket\051)SH 6720 46719 MT (0 126 176 7E A1) 1200 W( ~) 2400 W( Tilde)1800 W /Times-Roman SF 6120 49467 MT (Finally, one more nonprintable character:)SH /Courier SF 6720 51529 MT (0 127) 1800 W( 177) 1200 W( 7F) 600 W( 07) 1200 W( DEL) 1800 W( Delete,) 1200 W( rubout)SH ES %%Page: 361 362 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (Kermit User Guide)SH 10 /Times-Italic AF 51275 XM (Page 361)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 8280 8272 MT (Index)SH 8 /Times-Roman AF 12280 10429 MT (-F Command) SH( 50,) 400 W( 59)SH 37120 XM (CLEAR 40)400 W 37120 11353 MT (CLEAR Command) SH( 253)400 W 12280 12277 MT (.BOO Files) SH( 109)400 W 37120 XM (CLOSE Command) SH( 76)400 W 12280 13201 MT (.PIF Files) SH( 52)400 W 37120 XM (COM3 and COM4) SH( 85,) 400 W( 126)SH 37120 14125 MT (Command echoing) SH( 183)400 W 12280 15049 MT (7171 101)400 W 37120 XM (Command Files) SH( 89)400 W 37120 15973 MT (Command Macro) SH( 93)400 W 12280 16897 MT (8080 327,) 400 W( 331)SH 37120 XM (Command Parsing) SH( 24)400 W 12280 17821 MT (8th-bit Prefixing) SH( 169,) 400 W( 267)SH 37120 XM (COMMENT Command) SH( 59)400 W 37120 18745 MT (Common problems) SH( 289)400 W 12280 19669 MT (Alarm 77)400 W 37120 XM (Completion 50,) 400 W( 54)SH 12280 20593 MT (ANSI Printer Control) SH( 129)400 W 37120 XM (CONFIG.SYS 51)400 W 12280 21517 MT (ANSI.SYS 56,) 400 W( 59, 83, 86, 89, 104, 128)SH 37120 XM (CONNECT 11,) 400 W( 12, 321, 352)SH 12280 22441 MT (APC 355)400 W 37120 XM (CONNECT Command) SH( 31,) 400 W( 61, 269, 296)SH 12280 23365 MT (Append 322)400 W 37120 XM (CONTINUE 226,) 400 W( 251)SH 12280 24289 MT (Apple II) SH( 291)400 W 37120 XM (Control Characters) SH( 11,) 400 W( 357)SH 12280 25213 MT (Apple II Keypad) SH( 304,) 400 W( 305)SH 37120 XM (Control-A 217,) 400 W( 241)SH 12280 26137 MT (Apple Macintosh) SH( 161)400 W 37120 XM (Control-C 226,) 400 W( 251, 321)SH 12280 27061 MT (ARPANET 249,) 400 W( 342)SH 37120 XM (Control-V 241)400 W 12280 27985 MT (ASCII 55,) 400 W( 357)SH 37120 XM (Control-X 28,) 400 W( 217, 218, 241, 242, 321)SH 12280 28909 MT (ASCII-to-EBCDIC 180)400 W 37120 XM (Control-X,-Z 68,) 400 W( 69)SH 12280 29833 MT (Asynchronous Communication Server) SH( 52)400 W 37120 XM (Control-Z 28,) 400 W( 217, 218, 241, 242, 321)SH 12280 30757 MT (Attention Character) SH( 342)400 W 37120 XM (Copy 322)400 W 12280 31681 MT (Attributes 67,) 400 W( 78, 270)SH 37120 XM (Count 78)400 W 12280 32605 MT (Autoanswer 15)400 W 37120 XM (CP/M 236,) 400 W( 331)SH 12280 33529 MT (Autoanswer Modem) SH( 72)400 W 37120 XM (CP/M-80 Kermit) SH( 319)400 W 12280 34453 MT (Autodialer 14,) 400 W( 144, 148)SH 37120 XM (CR 321)400 W 12280 35377 MT (AUTOEXEC.BAT 52)400 W 37120 XM (Crash 21)400 W 12280 36301 MT (Autoreceive 323)400 W 37120 XM (CRC 78)400 W 37120 37225 MT (CRLF 176,) 400 W( 181)SH 12280 38149 MT (Background 138,) 400 W( 141, 161)SH 37120 XM (CTTY 51,) 400 W( 87, 101)SH 12280 39073 MT (Backslash Number Format) SH( 54)400 W 37120 XM (CWD Command) SH( 30)400 W 12280 39997 MT (Batch 248)400 W 12280 40921 MT (Batch operation) SH( 194)400 W 37120 XM (Debug 323)400 W 12280 41845 MT (Batch Operation of Kermit-MS) SH( 51)400 W 37120 XM (Debugging 33,) 400 W( 78, 181, 222, 246, 353)SH 12280 42769 MT (Baud 283,) 400 W( 323, 353)SH 37120 XM (DEC Rainbow) SH( 355)400 W 12280 43693 MT (Baud Rate) SH( 33,) 400 W( 46, 88)SH 37120 XM (DECSYSTEM-20 233)400 W 12280 44617 MT (Bell 78,) 400 W( 169)SH 37120 XM (Default Disk) SH( 323)400 W 12280 45541 MT (Binary Files) SH( 19,) 400 W( 27, 36, 48, 85, 166, 175, 181, 196, 205, 217, 240, 241)SH 37120 XM (DEFINE 93)400 W 12280 46465 MT (Binhex 172)400 W 37120 XM (DEFINE Command) SH( 38,) 400 W( 250)SH 12280 47389 MT (BIOS 123,) 400 W( 327)SH 37120 XM (Delay 34)400 W 12280 48313 MT (Bios LAN) SH( 125)400 W 37120 XM (DELETE 217,) 400 W( 241)SH 12280 49237 MT (Blind 63,) 400 W( 79, 126)SH 37120 XM (DELETE Command) SH( 30,) 400 W( 298)SH 12280 50161 MT (BLKSIZE 176)400 W 37120 XM (DG/1 44)400 W 12280 51085 MT (Block Check) SH( 33,) 400 W( 78, 180, 323)SH 37120 XM (DIAL 283)400 W 12280 52009 MT (BOO Files) SH( 109)400 W 37120 XM (DIAL Command) SH( 94)400 W 12280 52933 MT (Bootstrapping CP/M Kermit) SH( 335)400 W 37120 XM (Dialout Modem) SH( 148)400 W 12280 53857 MT (Bootstrapping MacKermit) SH( 172)400 W 37120 XM (Directory 322)400 W 12280 54781 MT (Bootstrapping MS-DOS Kermit) SH( 108)400 W 37120 XM (DIRECTORY Command) SH( 30)400 W 12280 55705 MT (BREAK 170,) 400 W( 321)SH 37120 XM (Directory file size) SH( 324)400 W 12280 56629 MT (BREAK Simulation) SH( 246,) 400 W( 249)SH 37120 XM (Diskette 21)400 W 12280 57553 MT (Buffer size) SH( 323)400 W 37120 XM (Display, File Transfer) SH( 79,) 400 W( 126)SH 12280 58477 MT (BYE 16,) 400 W( 17, 321, 353)SH 37120 XM (DO Command) SH( 93)400 W 12280 59401 MT (BYE Command) SH( 29,) 400 W( 268)SH 37120 XM (Downloading 335)400 W 12280 60325 MT (Byte Size) SH( 235,) 400 W( 243, 247)SH 37120 XM (DTR 162)400 W 37120 61249 MT (Dump Screen) SH( 64,) 400 W( 80)SH 12280 62173 MT (C-Kermit 131)400 W 37120 XM (Duplex 34)400 W 12280 63097 MT (Cables 15)400 W 12280 64021 MT (Cancelling a File Transfer) SH( 28,) 400 W( 68, 69, 195, 205, 217, 218, 241, 242)SH 37120 XM (EBCDIC 357)400 W 12280 64945 MT (Capabilities 261)400 W 37120 XM (EBCDIC-to-ASCII 180)400 W 12280 65869 MT (Capturing Files) SH( 39)400 W 37120 XM (Echo 20,) 400 W( 251)SH 12280 66793 MT (Carriage Return) SH( 321)400 W 37120 XM (ECHO Command) SH( 59)400 W 12280 67717 MT (Case Sensitivity) SH( 323)400 W 37120 XM (Echo mode) SH( 178)400 W 12280 68641 MT (Catalog 202)400 W 37120 XM (Eighth-Bit Prefix) SH( 27,) 400 W( 28, 36, 85, 217, 240, 241, 325, 354)SH 12280 69565 MT (CATALOG Command) SH( 298)400 W 37120 XM (Emergency Exit) SH( 133)400 W 12280 70489 MT (Checksum 78)400 W 37120 XM (End Of File) SH( 48,) 400 W( 80, 236)SH 12280 71413 MT (CKMKER 161)400 W 37120 XM (End Of Line) SH( 36,) 400 W( 37)SH ES %%Page: 362 363 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 362)SH 12 /Times-Bold AF 43052 XM (Kermit User Guide)SH 46800 50 6120 5709 UL 8 /Times-Roman AF 10120 7749 MT (Erase 322)400 W 34960 XM (KERMBOOT 198,) 400 W( 199)SH 10120 8673 MT (Error exit) SH( 178)400 W 34960 XM (Kermit Commands) SH( 12)400 W 10120 9597 MT (Error Recovery) SH( 19)400 W 34960 XM (Kermit Protocol) SH( 7)400 W 10120 10521 MT (Errorlevel 80)400 W 34960 XM (Kermit server) SH( 16)400 W 10120 11445 MT (Escape Character) SH( 12,) 400 W( 321, 324, 352, 353)SH 34960 XM (Kermit-11 Commands) SH( 265)400 W 10120 12369 MT (Escape Character for CONNECT) SH( 34,) 400 W( 61, 63, 80, 223, 247)SH 34960 XM (Key Redefinition) SH( 81,) 400 W( 165, 170)SH 10120 13293 MT (Escape Sequence) SH( 11)400 W 10120 14217 MT (EXEPACK 44)400 W 34960 XM (Labels 98)400 W 10120 15141 MT (EXIT 226,) 400 W( 251, 322)SH 34960 XM (LAN 52)400 W 10120 16065 MT (EXIT Command) SH( 32)400 W 34960 XM (Line Sequence Numbers) SH( 240)400 W 10120 16989 MT (Expunging Deleted Files) SH( 247)400 W 34960 XM (Linefeed 256)400 W 10120 17913 MT (Extended ASCII) SH( 166)400 W 34960 XM (Local 12,) 400 W( 23, 177, 321, 351)SH 10120 18837 MT (External Terminal Emulation) SH( 325)400 W 34960 XM (Local Area Network) SH( 52,) 400 W( 73)SH 34960 19761 MT (Local Commands) SH( 30,) 400 W( 269)SH 10120 20685 MT (Failure, file transfer) SH( 290)400 W 34960 XM (Local Echo) SH( 34,) 400 W( 62, 83)SH 10120 21609 MT (File Attributes) SH( 67,) 400 W( 270)SH 34960 XM (Local operation) SH( 264)400 W 10120 22533 MT (File Copying) SH( 322)400 W 34960 XM (LOCAL-ECHO 188,) 400 W( 324, 354)SH 10120 23457 MT (File Management) SH( 269)400 W 34960 XM (LOG 322,) 400 W( 354)SH 10120 24381 MT (File matching) SH( 195,) 400 W( 205)SH 34960 XM (LOG Command) SH( 39,) 400 W( 76)SH 10120 25305 MT (File renaming) SH( 184)400 W 34960 XM (LOG PACKETS) SH( 76)400 W 10120 26229 MT (File specifications) SH( 262)400 W 34960 XM (LOG SESSION) SH( 71)400 W 10120 27153 MT (File truncation) SH( 181)400 W 34960 XM (LOG TRANSACTION) SH( 76)400 W 10120 28077 MT (File Type) SH( 223)400 W 34960 XM (Logfile 277)400 W 10120 29001 MT (File Warning) SH( 37,) 400 W( 91, 133, 180, 184)SH 34960 XM (Logging 324)400 W 10120 29925 MT (File-mode 324)400 W 34960 XM (Login Scripts) SH( 39,) 400 W( 252)SH 10120 30849 MT (File-Warning 323,) 400 W( 352)SH 34960 XM (LOGOUT 323,) 400 W( 353)SH 10120 31773 MT (FINISH 16,) 400 W( 17, 322, 353)SH 34960 XM (Long Packets) SH( 86,) 400 W( 169, 177, 184, 186, 193, 280, 289)SH 10120 32697 MT (FINISH Command) SH( 29,) 400 W( 268)SH 34960 XM (LRECL 176,) 400 W( 181)SH 10120 33621 MT (Fixed file type) SH( 263,) 400 W( 267)SH 10120 34545 MT (Flow Control) SH( 34,) 400 W( 80, 129, 188, 193, 324, 353)SH 34960 XM (MacBinary 167)400 W 10120 35469 MT (Folder 164)400 W 34960 XM (Macintosh Kermit) SH( 161)400 W 10120 36393 MT (Fork 166)400 W 34960 XM (MacKermit Settings Files) SH( 169)400 W 34960 37317 MT (MACLIB 199)400 W 10120 38241 MT (Generation 241)400 W 34960 XM (Macro 93)400 W 10120 39165 MT (Generic Kermit-80) SH( 327)400 W 34960 XM (Macros 38)400 W 10120 40089 MT (Generic MS-DOS Kermit) SH( 85,) 400 W( 111)SH 34960 XM (MAIL Command) SH( 75)400 W 10120 41013 MT (German 91)400 W 34960 XM (Margins 182)400 W 10120 41937 MT (GET 17,) 400 W( 178, 196, 322, 353)SH 34960 XM (MASM 111)400 W 10120 42861 MT (GET Command) SH( 267,) 400 W( 296)SH 34960 XM (Menu 54)400 W 10120 43785 MT (GOTO Command) SH( 98)400 W 34960 XM (Message Interference) SH( 215,) 400 W( 238)SH 10120 44709 MT (Graphics 65,) 400 W( 119)SH 34960 XM (META Key) SH( 171)400 W 10120 45633 MT (Graphics Screen Capture) SH( 121)400 W 34960 XM (MFS 164)400 W 34960 46557 MT (Mode Line) SH( 64,) 400 W( 84)SH 10120 47481 MT (Handicapped 79,) 400 W( 126)SH 34960 XM (Modem 47,) 400 W( 57, 62, 63, 92, 100, 148)SH 10120 48405 MT (Handshake 35,) 400 W( 81, 182, 188, 193, 224, 256)SH 34960 XM (MODEM Command) SH( 298)400 W 10120 49329 MT (HANGUP 63)400 W 34960 XM (Modems 288)400 W 10120 50253 MT (Hayes Modem) SH( 150)400 W 34960 XM (Mouse 162,) 400 W( 165)SH 10120 51177 MT (Heath/Zenith-19 Emulation) SH( 112)400 W 34960 XM (MS-DOS 43)400 W 10120 52101 MT (Help 54,) 400 W( 237, 322)SH 34960 XM (MS-Windows 44,) 400 W( 52)SH 10120 53025 MT (HFS 164)400 W 34960 XM (MSKERMIT.INI 49,) 400 W( 57, 82, 89, 101)SH 10120 53949 MT (Home disk) SH( 192,) 400 W( 197, 198)SH 34960 XM (MVS/TSO 201)400 W 10120 54873 MT (Host commands) SH( 183)400 W 34960 55797 MT (NAK 321,) 400 W( 351)SH 10120 56721 MT (IBM 147,) 400 W( 175, 191, 201, 224, 247, 324, 353)SH 34960 XM (National Characters) SH( 54,) 400 W( 61, 79)SH 10120 57645 MT (IBM Mainframe) SH( 101)400 W 34960 XM (NEC Advanced Personal Computer) SH( 355)400 W 10120 58569 MT (IBM PC Family) SH( 43)400 W 34960 XM (NEC APC3) SH( 104)400 W 10120 59493 MT (IF Command) SH( 99)400 W 34960 XM (NetBIOS 52,) 400 W( 86, 124)SH 10120 60417 MT (Incomplete file) SH( 205)400 W 34960 XM (Network 52)400 W 10120 61341 MT (Incomplete File Disposition) SH( 28,) 400 W( 69, 81, 217, 241)SH 34960 XM (Network security) SH( 73,) 400 W( 125)SH 10120 62265 MT (Incomplete File Transfer) SH( 35)400 W 34960 XM (No-exit 324)400 W 10120 63189 MT (Incomplete files) SH( 182,) 400 W( 196)SH 34960 XM (Noise 7)400 W 10120 64113 MT (Indirect Command File) SH( 254)400 W 34960 XM (Normal Form for File Names) SH( 217,) 400 W( 223, 240, 247)SH 10120 65037 MT (Initial Filespec) SH( 27,) 400 W( 216, 240)SH 34960 XM (Novell 124)400 W 10120 65961 MT (Initialization files) SH( 176,) 400 W( 193, 199, 203, 208)SH 34960 XM (Null Modem) SH( 15)400 W 10120 66885 MT (INPUT 39,) 400 W( 41, 248, 250, 252, 322)SH 10120 67809 MT (INPUT Command) SH( 40,) 400 W( 81, 85, 96, 253)SH 34960 XM (OUTPUT 39,) 400 W( 252)SH 10120 68733 MT (Intercept Character) SH( 342)400 W 34960 XM (OUTPUT Command) SH( 97)400 W 10120 69657 MT (Interference 215,) 400 W( 238)SH 10120 70581 MT (Internal Modem) SH( 19)400 W 34960 XM (P/OS 263,) 400 W( 264, 284)SH 10120 71505 MT (ITS-Binary Format) SH( 248)400 W 34960 XM (Packet 8)400 W ES %%Page: 363 364 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (Kermit User Guide)SH 10 /Times-Italic AF 51275 XM (Page 363)SH 46800 50 8280 5709 UL 8 /Times-Roman AF 12280 7749 MT (Packet Length) SH( 36,) 400 W( 37)SH 37120 XM (Server 16,) 400 W( 17, 72, 178, 219, 243)SH 12280 8673 MT (Packet-length 278)400 W 37120 XM (SERVER Command) SH( 29,) 400 W( 299)SH 12280 9597 MT (Pad character) SH( 325)400 W 37120 XM (SERVER commands) SH( 268)400 W 12280 10521 MT (Padding 36,) 400 W( 37)SH 37120 XM (Server Operation) SH( 268)400 W 12280 11445 MT (Parity 27,) 400 W( 28, 35, 71, 85, 96, 112, 165, 182, 188, 217, 240, 241, 278, 325, 354, 357)SH 37120 XM (Session Log) SH( 166)400 W 12280 12369 MT (Partitioned data set) SH( 202)400 W 37120 XM (SET 12,) 400 W( 323, 353)SH 12280 13293 MT (Password 254)400 W 37120 XM (SET APPLICATION-MODE) SH( 300)400 W 12280 14217 MT (Passwords 254)400 W 37120 XM (SET BAUD) SH( 271,) 400 W( 283)SH 12280 15141 MT (PATH 47,) 400 W( 50, 52, 57, 59, 69)SH 37120 XM (SET Command) SH( 32,) 400 W( 270, 300)SH 12280 16065 MT (PAUSE 39,) 400 W( 252, 323)SH 37120 XM (SET DEFAULT-DISK) SH( 301)400 W 12280 16989 MT (Pause Between Packets) SH( 36,) 400 W( 37)SH 37120 XM (SET DISPLAY) SH( 301)400 W 12280 17913 MT (PAUSE Command) SH( 40,) 400 W( 253)SH 37120 XM (SET ESCAPE) SH( 275)400 W 12280 18837 MT (PC-DOS 43)400 W 37120 XM (SET FILE TYPE) SH( 275)400 W 12280 19761 MT (PDP-11 261)400 W 37120 XM (SET FILE TYPE FIXED) SH( 276)400 W 12280 20685 MT (POP 58)400 W 37120 XM (SET FILE-TYPE) SH( 301)400 W 12280 21609 MT (POP Command) SH( 100)400 W 37120 XM (SET INPUT) SH( 41,) 400 W( 248)SH 12280 22533 MT (Port 325)400 W 37120 XM (SET KEYBOARD) SH( 304)400 W 12280 23457 MT (Print 323)400 W 37120 XM (SET KEYPAD) SH( 304)400 W 12280 24381 MT (Printer 61,) 400 W( 64, 71, 79, 129, 325)SH 37120 XM (SET LINE) SH( 277)400 W 12280 25305 MT (ProKey 83)400 W 37120 XM (SET LOCAL-ECHO) SH( 304)400 W 12280 26229 MT (Prompt 11,) 400 W( 36, 279)SH 37120 XM (SET LOGFILE) SH( 277)400 W 12280 27153 MT (Protocol Converter) SH( 101)400 W 37120 XM (SET PACKET-LENGTH) SH( 278)400 W 12280 28077 MT (PUSH Command) SH( 31,) 400 W( 57)SH 37120 XM (Set padding) SH( 325)400 W 37120 29001 MT (SET PARITY) SH( 278,) 400 W( 304)SH 12280 29925 MT (Qualifier 202)400 W 37120 XM (SET PORT NETBIOS) SH( 52,) 400 W( 86)SH 12280 30849 MT (QUIT 32,) 400 W( 226, 251)SH 37120 XM (SET PORT UB-NET1) SH( 52,) 400 W( 86)SH 37120 31773 MT (SET PREFIX) SH( 304)400 W 12280 32697 MT (Rainbow 103,) 400 W( 106)SH 37120 XM (SET PRINTER) SH( 304)400 W 12280 33621 MT (Rainbow 100) SH( 355)400 W 37120 XM (SET PROMPT) SH( 279)400 W 12280 34545 MT (RAM Disk) SH( 51,) 400 W( 67)SH 37120 XM (SET PROTOCOL) SH( 305)400 W 12280 35469 MT (Raw Download) SH( 166,) 400 W( 227, 255)SH 37120 XM (SET RECEIVE) SH( 280,) 400 W( 325)SH 12280 36393 MT (Raw Upload) SH( 254,) 400 W( 256)SH 37120 XM (SET RECEIVE PACKET-LENGTH) SH( 280)400 W 12280 37317 MT (RECEIVE 12,) 400 W( 13, 14, 28, 178, 195, 205, 217, 241, 323, 352)SH 37120 XM (SET RECORD-FORMAT) SH( 281)400 W 12280 38241 MT (RECEIVE Command) SH( 69,) 400 W( 267, 296)SH 37120 XM (SET RETRY) SH( 281)400 W 12280 39165 MT (Receive packet-length) SH( 280)400 W 37120 XM (SET RSX) SH( 281)400 W 12280 40089 MT (RECFM 176)400 W 37120 XM (SET RT-11 CREATE-SIZE) SH( 281)400 W 12280 41013 MT (Recognition 237)400 W 37120 XM (SET RT-11 FLOW-CONTROL) SH( 282)400 W 12280 41937 MT (Record too big) SH( 213)400 W 37120 XM (SET SEND) SH( 282,) 400 W( 325)SH 12280 42861 MT (Record-format 281)400 W 37120 XM (SET SLOT) SH( 305)400 W 12280 43785 MT (Records 176)400 W 37120 XM (SET SPEED) SH( 283)400 W 12280 44709 MT (Redirected input and output) SH( 51)400 W 37120 XM (Set Start of packet) SH( 325)400 W 12280 45633 MT (REINPUT Command) SH( 97)400 W 37120 XM (SET TERMINAL) SH( 89,) 400 W( 283, 305)SH 12280 46557 MT (Remote 12,) 400 W( 17, 23, 177)SH 37120 XM (SET UPDATE) SH( 283)400 W 12280 47481 MT (REMOTE Command) SH( 30,) 400 W( 299)SH 37120 XM (Setfile 172)400 W 12280 48405 MT (REMOTE commands) SH( 268)400 W 37120 XM (Settings Files) SH( 169)400 W 12280 49329 MT (Remote operation) SH( 264)400 W 37120 XM (SHOW 12,) 400 W( 225, 250, 326, 354)SH 12280 50253 MT (Repeated Character Compression) SH( 27,) 400 W( 28, 217, 241)SH 37120 XM (SHOW Command) SH( 38)400 W 12280 51177 MT (ResEdit 172)400 W 37120 XM (SNA 175,) 400 W( 180)SH 12280 52101 MT (Retry Limit) SH( 37)400 W 37120 XM (SPACE Command) SH( 31)400 W 12280 53025 MT (Rollback 64)400 W 37120 XM (Speaking Device) SH( 79)400 W 12280 53949 MT (RSTS/E 261,) 400 W( 262, 263, 264, 285)SH 37120 XM (Speed 88,) 400 W( 249, 250)SH 12280 54873 MT (RSTS/E version 9.x) SH( 288)400 W 37120 XM (Starlan 124)400 W 12280 55797 MT (RSX 288)400 W 37120 XM (Start Of Packet) SH( 37)400 W 12280 56721 MT (RSX-11 261)400 W 37120 XM (Statistics 38)400 W 12280 57645 MT (RSX-11M 263)400 W 37120 XM (Status 326)400 W 12280 58569 MT (RSX-11M/M+ 285)400 W 37120 XM (STAY 50)400 W 12280 59493 MT (RT-11 261,) 400 W( 263, 264, 285)SH 37120 XM (STAY Command) SH( 57)400 W 12280 60417 MT (RUN Command) SH( 31)400 W 37120 XM (STOP 58)400 W 37120 61341 MT (STOP Command) SH( 100)400 W 12280 62265 MT (Saving files) SH( 263)400 W 37120 XM (STRING 326)400 W 12280 63189 MT (Screen Dump) SH( 64,) 400 W( 80)SH 37120 XM (SuperKey 83)400 W 12280 64113 MT (Screen Rollback) SH( 64)400 W 12280 65037 MT (Script Files) SH( 95)400 W 37120 XM (TAC 342)400 W 12280 65961 MT (Search order) SH( 195)400 W 37120 XM (TAC Binary Mode) SH( 249)400 W 12280 66885 MT (Security 73,) 400 W( 125)SH 37120 XM (TacTrap 325)400 W 12280 67809 MT (SEND 12,) 400 W( 14, 17, 27, 177, 178, 195, 205, 216, 240, 282, 323, 352)SH 37120 XM (TAKE 178,) 400 W( 196, 248, 326, 354)SH 12280 68733 MT (SEND Command) SH( 68,) 400 W( 266, 295)SH 37120 XM (TAKE Command) SH( 296)400 W 12280 69657 MT (SEND delay) SH( 181)400 W 37120 XM (Tektronix 65,) 400 W( 89, 119)SH 12280 70581 MT (Series/1 175,) 400 W( 180, 191, 201)SH 37120 XM (TELENET 35,) 400 W( 38, 85, 151)SH 12280 71505 MT (SERIES1 188)400 W 37120 XM (Terminal Emulation) SH( 44,) 400 W( 63, 325)SH ES %%Page: 364 365 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 364)SH 12 /Times-Bold AF 43052 XM (Kermit User Guide)SH 46800 50 6120 5709 UL 8 /Times-Roman AF 10120 7749 MT (Terminal Settings) SH( 89)400 W 10120 8673 MT (TEST 183)400 W 10120 9597 MT (The GET Command) SH( 29)400 W 10120 10521 MT (Timeout 36,) 400 W( 37, 40, 90, 253, 321, 332, 351)SH 10120 11445 MT (TIMER 326,) 400 W( 354)SH 10120 12369 MT (Token Ring) SH( 124)400 W 10120 13293 MT (TOPS-20 233)400 W 10120 14217 MT (TopView 44)400 W 10120 15141 MT (Transfer rates) SH( 289)400 W 10120 16065 MT (TRANSLATION 91,) 400 W( 175, 184)SH 10120 16989 MT (TRANSMIT 70,) 400 W( 254, 256, 326)SH 10120 17913 MT (TRANSMIT Command) SH( 39)400 W 10120 18837 MT (TSX+ 263,) 400 W( 264, 287)SH 10120 19761 MT (TTY 175,) 400 W( 180, 188, 191, 193, 201)SH 10120 20685 MT (TVT-Binary 249)400 W 10120 21609 MT (Type 179,) 400 W( 327)SH 10120 22533 MT (TYPE Command) SH( 296)400 W 10120 23457 MT (Typeahead 41)400 W 10120 25305 MT (UART 44)400 W 10120 26229 MT (UNDELETE 217,) 400 W( 241)SH 10120 27153 MT (Ungermann Bass Net One LAN) SH( 125)400 W 10120 28077 MT (Ungermann-Bass 52,) 400 W( 125)SH 10120 29001 MT (UNIX Kermit) SH( 131)400 W 10120 29925 MT (Upload 254)400 W 10120 30849 MT (USER 326)400 W 10120 31773 MT (User area) SH( 198,) 400 W( 199)SH 10120 32697 MT (User profile) SH( 203,) 400 W( 204, 207)SH 10120 34545 MT (Variables, substitution) SH( 94)400 W 10120 35469 MT (VAX/VMS 211)400 W 10120 36393 MT (VERSION 56,) 400 W( 217, 327)SH 10120 37317 MT (Virtual Terminal) SH( 12,) 400 W( 321, 352)SH 10120 38241 MT (VM/CMS 14,) 400 W( 191)SH 10120 39165 MT (VT100 Emulation) SH( 305,) 400 W( 326)SH 10120 40089 MT (VT102 Emulation) SH( 44,) 400 W( 89, 112, 165)SH 10120 41013 MT (VT52 Emulation) SH( 112,) 400 W( 306, 325)SH 10120 42861 MT (Warning 37,) 400 W( 91, 133, 184, 326, 354)SH 10120 43785 MT (Wildcard 12,) 400 W( 13, 48, 68, 192, 203, 212, 234, 262)SH 10120 44709 MT (Word Size) SH( 235)400 W 10120 46557 MT (Xmodem 108)400 W 10120 47481 MT (XON/XOFF 34,) 400 W( 44, 70, 80, 322, 357)SH 10120 48405 MT (XSEND 69)400 W 10120 50253 MT (Z80 331)400 W ES %%Page: i 366 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (Kermit User Guide)SH 10 /Times-Italic AF 52497 XM (Page i)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 25591 8272 MT (Table of Contents)SH 12 SS 8280 10684 MT (How To Get Kermit)SH 54480 XM (3)SH 8280 12208 MT (Organization of This Manual)SH 54480 XM (5)SH 8280 13732 MT (1. Introduction)SH 54480 XM (7)SH 10 SS 9780 15122 MT (1.1. Why Kermit?)SH 54580 XM (7)SH 9780 16202 MT (1.2. How Kermit Works)SH 54580 XM (8)SH 12 SS 8280 17726 MT (2. How to Use Kermit)SH 53880 XM (11)SH 10 SS 9780 19116 MT (2.1. Transferring a File)SH 54080 XM (11)SH 9780 20196 MT (2.2. Basic Kermit Commands)SH 54080 XM (12)SH 9780 21276 MT (2.3. Real Examples)SH 54080 XM (13)SH 11780 22356 MT (2.3.1. PC to Host)SH 54080 XM (13)SH 11780 23436 MT (2.3.2. Host to Host)SH 54080 XM (14)SH 11780 24516 MT (2.3.3. Micro to Micro)SH 54080 XM (15)SH 9780 25596 MT (2.4. Another Way -- The Kermit Server)SH 54080 XM (16)SH 12 SS 8280 27120 MT (3. When Things Go Wrong)SH 53880 XM (19)SH 10 SS 9780 28510 MT (3.1. Basic Connection Problems)SH 54080 XM (19)SH 9780 29590 MT (3.2. Terminal Connection Works But The Transfer Won't Start)SH 54080 XM (19)SH 9780 30670 MT (3.3. Special Characters)SH 54080 XM (20)SH 9780 31750 MT (3.4. The Transfer Starts But Then Gets Stuck)SH 54080 XM (20)SH 11780 32830 MT (3.4.1. The Connection is Broken)SH 54080 XM (21)SH 11780 33910 MT (3.4.2. The Disk is Full)SH 54080 XM (21)SH 11780 34990 MT (3.4.3. Transmission Delays)SH 54080 XM (21)SH 11780 36070 MT (3.4.4. Noise Corruption)SH 54080 XM (21)SH 11780 37150 MT (3.4.5. Host Errors)SH 54080 XM (21)SH 9780 38230 MT (3.5. File is Garbage)SH 54080 XM (21)SH 12 SS 8280 39754 MT (4. Kermit Commands)SH 53880 XM (23)SH 10 SS 9780 41144 MT (4.1. Remote and Local Operation)SH 54080 XM (23)SH 9780 42224 MT (4.2. The Command Dialog)SH 54080 XM (24)SH 9780 43304 MT (4.3. Notation)SH 54080 XM (24)SH 9780 44384 MT (4.4. Summary of Kermit Commands)SH 54080 XM (26)SH 9780 45464 MT (4.5. The SEND Command)SH 54080 XM (27)SH 9780 46544 MT (4.6. The RECEIVE Command)SH 54080 XM (28)SH 9780 47624 MT (4.7. The GET Command)SH 54080 XM (29)SH 9780 48704 MT (4.8. The SERVER Command)SH 54080 XM (29)SH 9780 49784 MT (4.9. The BYE Command)SH 54080 XM (29)SH 9780 50864 MT (4.10. The FINISH Command)SH 54080 XM (29)SH 9780 51944 MT (4.11. The REMOTE Command)SH 54080 XM (30)SH 9780 53024 MT (4.12. Local Commands)SH 54080 XM (30)SH 9780 54104 MT (4.13. The CONNECT Command)SH 54080 XM (31)SH 9780 55184 MT (4.14. HELP)SH 54080 XM (31)SH 9780 56264 MT (4.15. The TAKE Command)SH 54080 XM (31)SH 9780 57344 MT (4.16. The EXIT and QUIT Commands)SH 54080 XM (32)SH 9780 58424 MT (4.17. The SET Command)SH 54080 XM (32)SH 9780 59504 MT (4.18. The DEFINE Command)SH 54080 XM (38)SH 9780 60584 MT (4.19. The SHOW Command)SH 54080 XM (38)SH 9780 61664 MT (4.20. The STATISTICS Command)SH 54080 XM (38)SH 9780 62744 MT (4.21. The LOG Command)SH 54080 XM (39)SH 9780 63824 MT (4.22. The TRANSMIT Command)SH 54080 XM (39)SH 9780 64904 MT (4.23. Login Scripts: The INPUT, OUTPUT, CLEAR, and PAUSE Commands)SH 54080 XM (39)SH ES %%Page: ii 367 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page ii)SH 12 /Times-Bold AF 43052 XM (Kermit User Guide)SH 46800 50 6120 5709 UL 6120 8004 MT (5. MS-DOS KERMIT)SH 51720 XM (43)SH 10 SS 7620 9394 MT (5.1. System Requirements)SH 51920 XM (44)SH 7620 10474 MT (5.2. History)SH 51920 XM (44)SH 7620 11554 MT (5.3. Using MS-Kermit)SH 51920 XM (46)SH 7620 12634 MT (5.4. The MS-DOS File System)SH 51920 XM (47)SH 9620 13714 MT (5.4.1. File Specifications)SH 51920 XM (47)SH 9620 14794 MT (5.4.2. File Formats)SH 51920 XM (48)SH 7620 15874 MT (5.5. Program Setup and Invocation)SH 51920 XM (49)SH 7620 16954 MT (5.6. Kermit-MS Commands)SH 51920 XM (53)SH 9620 18034 MT (5.6.1. Program Management Commands)SH 51920 XM (56)SH 9620 19114 MT (5.6.2. Local File Management Commands)SH 51920 XM (59)SH 9620 20194 MT (5.6.3. COMMANDS FOR TERMINAL CONNECTION)SH 51920 XM (61)SH 9620 21274 MT (5.6.4. COMMANDS FOR FILE TRANSFER)SH 51920 XM (67)SH 9620 22354 MT (5.6.5. Hints for Transferring Large Files)SH 51920 XM (70)SH 9620 23434 MT (5.6.6. Commands for Raw Uploading and Downloading)SH 51920 XM (70)SH 9620 24514 MT (5.6.7. Kermit Server Commands)SH 51920 XM (72)SH 9620 25594 MT (5.6.8. Commands for Controlling Remote Kermit Servers)SH 51920 XM (74)SH 9620 26674 MT (5.6.9. The LOG and CLOSE Commands)SH 51920 XM (76)SH 9620 27754 MT (5.6.10. The SET Command)SH 51920 XM (77)SH 9620 28834 MT (5.6.11. The STATUS and SHOW Commands)SH 51920 XM (91)SH 7620 29914 MT (5.7. Macros)SH 51920 XM (93)SH 7620 30994 MT (5.8. SCRIPTS)SH 51920 XM (95)SH 7620 32074 MT (5.9. Initialization Files Revisited)SH 51420 XM (101)SH 7620 33154 MT (5.10. MS-Kermit Features for Different Systems)SH 51420 XM (101)SH 7620 34234 MT (5.11. Compatibility with Older Versions of MS-DOS Kermit)SH 51420 XM (106)SH 7620 35314 MT (5.12. What's Missing)SH 51420 XM (108)SH 7620 36394 MT (5.13. Installation of Kermit-MS)SH 51420 XM (108)SH 7620 37474 MT (5.14. Program Organization)SH 51420 XM (110)SH 7620 38554 MT (5.15. Bringing Kermit to New Systems)SH 51420 XM (111)SH 7620 39634 MT (5.16. Kermit-MS VT102 Terminal Emulator Technical Summary)SH 51420 XM (112)SH 9620 40714 MT (5.16.1. Treatment of Inbound Characters During Terminal Emulation)SH 51420 XM (112)SH 9620 41794 MT (5.16.2. Keyboard Layout and Characters Sent)SH 51420 XM (113)SH 9620 42874 MT (5.16.3. Responses To Characters Received By the Terminal Emulator)SH 51420 XM (115)SH 9620 43954 MT (5.16.4. DEC VT102 Functions While in VT52 Mode)SH 51420 XM (117)SH 9620 45034 MT (5.16.5. Heath-19 Functions While in Non-ANSI Mode)SH 51420 XM (118)SH 9620 46114 MT (5.16.6. Heath-19 Functions While in ANSI Mode)SH 51420 XM (119)SH 9620 47194 MT (5.16.7. Tektronix 4010/4014 Graphics Terminal Functions)SH 51420 XM (119)SH 7620 48274 MT (5.17. IBM PC Kermit Technical Summaries)SH 51420 XM (123)SH 9620 49354 MT (5.17.1. Kermit-MS/IBM on Local Area Networks)SH 51420 XM (124)SH 9620 50434 MT (5.17.2. Use of Kermit-MS with External Device Drivers)SH 51420 XM (126)SH 9620 51514 MT (5.17.3. Kermit-MS/IBM Serial Port Information)SH 51420 XM (126)SH 9620 52594 MT (5.17.4. CTTY COMx for IBM Machines)SH 51420 XM (128)SH 9620 53674 MT (5.17.5. Screen Sizes and the EGA Board, IBM Versions)SH 51420 XM (128)SH 9620 54754 MT (5.17.6. Kermit-MS/IBM Printer Control)SH 51420 XM (129)SH 12 SS 6120 56278 MT (6. UNIX KERMIT)SH 51120 XM (131)SH 10 SS 7620 57668 MT (6.1. The Unix File System)SH 51420 XM (132)SH 7620 58748 MT (6.2. File Transfer)SH 51420 XM (132)SH 7620 59828 MT (6.3. Command Line Operation)SH 51420 XM (133)SH 7620 60908 MT (6.4. Interactive Operation)SH 51420 XM (137)SH 7620 61988 MT (6.5. UUCP Lock Files)SH 51420 XM (152)SH 7620 63068 MT (6.6. C-Kermit under Berkeley or System III/V Unix:)SH 51420 XM (153)SH 7620 64148 MT (6.7. C-Kermit on the DEC Pro-3xx with Pro/Venix Version 1)SH 51420 XM (154)SH 7620 65228 MT (6.8. C-Kermit under VAX/VMS)SH 51420 XM (154)SH 7620 66308 MT (6.9. C-Kermit on the Macintosh and other Systems)SH 51420 XM (154)SH 7620 67388 MT (6.10. C-Kermit Restrictions and Known Bugs)SH 51420 XM (154)SH 7620 68468 MT (6.11. How to Build C-Kermit for a Unix System)SH 51420 XM (155)SH ES %%Page: iii 368 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (Kermit User Guide)SH 10 /Times-Italic AF 51941 XM (Page iii)SH 46800 50 8280 5709 UL /Times-Bold SF 9780 7870 MT (6.12. Adapting C-Kermit to Other Systems)SH 53580 XM (155)SH 12 SS 8280 9394 MT (7. MACINTOSH KERMIT)SH 53280 XM (161)SH 10 SS 9780 10784 MT (7.1. Introduction)SH 53580 XM (161)SH 9780 11864 MT (7.2. Installation)SH 53580 XM (162)SH 9780 12944 MT (7.3. Getting Started)SH 53580 XM (162)SH 9780 14024 MT (7.4. The Macintosh File System)SH 53580 XM (164)SH 9780 15104 MT (7.5. Menus)SH 53580 XM (164)SH 9780 16184 MT (7.6. Terminal Emulation)SH 53580 XM (165)SH 9780 17264 MT (7.7. File Transfer)SH 53580 XM (166)SH 11780 18344 MT (7.7.1. Sending Files)SH 53580 XM (167)SH 11780 19424 MT (7.7.2. Receiving Files)SH 53580 XM (167)SH 9780 20504 MT (7.8. Remote Commands)SH 53580 XM (168)SH 9780 21584 MT (7.9. Server Operation)SH 53580 XM (168)SH 9780 22664 MT (7.10. Settings)SH 53580 XM (168)SH 9780 23744 MT (7.11. Settings Files)SH 53580 XM (169)SH 9780 24824 MT (7.12. Reconfiguring the Keyboard)SH 53580 XM (170)SH 11780 25904 MT (7.12.1. Defining Key Macros)SH 53580 XM (170)SH 11780 26984 MT (7.12.2. Defining Key Modifiers)SH 53580 XM (170)SH 11780 28064 MT (7.12.3. Modifiers Dialog)SH 53580 XM (171)SH 9780 29144 MT (7.13. Bootstrapping)SH 53580 XM (172)SH 9780 30224 MT (7.14. Differences Between Versions 0.8 and 0.9)SH 53580 XM (172)SH 12 SS 8280 31748 MT (8. IBM 370 KERMIT)SH 53280 XM (175)SH 10 SS 9780 33138 MT (8.1. Program Operation)SH 53580 XM (176)SH 9780 34218 MT (8.2. Kermit-370 Subcommands)SH 53580 XM (176)SH 9780 35298 MT (8.3. Before Connecting to the Mainframe)SH 53580 XM (188)SH 9780 36378 MT (8.4. After Returning from Kermit-370)SH 53580 XM (188)SH 9780 37458 MT (8.5. What's New)SH 53580 XM (188)SH 9780 38538 MT (8.6. What's Missing)SH 53580 XM (190)SH 12 SS 8280 40062 MT (9. IBM VM/CMS KERMIT)SH 53280 XM (191)SH 10 SS 9780 41452 MT (9.1. The VM/CMS File System)SH 53580 XM (192)SH 9780 42532 MT (9.2. Program Operation)SH 53580 XM (193)SH 9780 43612 MT (9.3. Kermit-CMS Subcommands)SH 53580 XM (195)SH 9780 44692 MT (9.4. How to build an executable version of Kermit-CMS)SH 53580 XM (198)SH 9780 45772 MT (9.5. What's New)SH 53580 XM (199)SH 9780 46852 MT (9.6. What's Missing)SH 53580 XM (200)SH 12 SS 8280 48376 MT (10. IBM MVS/TSO KERMIT)SH 53280 XM (201)SH 10 SS 9780 49766 MT (10.1. The MVS/TSO File System)SH 53580 XM (202)SH 9780 50846 MT (10.2. Program Operation)SH 53580 XM (203)SH 9780 51926 MT (10.3. Kermit-TSO Subcommands)SH 53580 XM (205)SH 9780 53006 MT (10.4. How to build an executable version of Kermit-TSO)SH 53580 XM (208)SH 9780 54086 MT (10.5. What's New)SH 53580 XM (209)SH 9780 55166 MT (10.6. What's Missing)SH 53580 XM (209)SH 12 SS 8280 56690 MT (11. VAX/VMS KERMIT)SH 53280 XM (211)SH 10 SS 9780 58080 MT (11.1. The VAX/VMS File System)SH 53580 XM (212)SH 9780 59160 MT (11.2. Program Operation)SH 53580 XM (214)SH 9780 60240 MT (11.3. Conditioning Your Job for Kermit)SH 53580 XM (215)SH 9780 61320 MT (11.4. Kermit-32 Commands)SH 53580 XM (216)SH 11780 62400 MT (11.4.1. Commands for File Transfer)SH 53580 XM (216)SH 11780 63480 MT (11.4.2. Server Operation)SH 53580 XM (219)SH 11780 64560 MT (11.4.3. Commands for Local File Management)SH 53580 XM (220)SH 11780 65640 MT (11.4.4. The CONNECT Command)SH 53580 XM (221)SH 11780 66720 MT (11.4.5. The SET and SHOW Commands)SH 53580 XM (222)SH 11780 67800 MT (11.4.6. Program Management Commands)SH 53580 XM (226)SH ES %%Page: iv 369 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page iv)SH 12 /Times-Bold AF 43052 XM (Kermit User Guide)SH 46800 50 6120 5709 UL 10 SS 7620 7870 MT (11.5. Raw Upload and Download)SH 51420 XM (227)SH 7620 8950 MT (11.6. Installation of Kermit-32)SH 51420 XM (228)SH 12 SS 6120 10474 MT (12. DECSYSTEM-20 KERMIT)SH 51120 XM (233)SH 10 SS 7620 11864 MT (12.1. The DEC-20 File System)SH 51420 XM (233)SH 7620 12944 MT (12.2. Program Operation)SH 51420 XM (237)SH 7620 14024 MT (12.3. Remote and Local Operation)SH 51420 XM (238)SH 7620 15104 MT (12.4. Conditioning Your Job for Kermit)SH 51420 XM (238)SH 7620 16184 MT (12.5. Kermit-20 Commands)SH 51420 XM (239)SH 9620 17264 MT (12.5.1. Commands for File Transfer)SH 51420 XM (240)SH 9620 18344 MT (12.5.2. Server Operation)SH 51420 XM (243)SH 9620 19424 MT (12.5.3. Commands for Local File Management)SH 51420 XM (244)SH 9620 20504 MT (12.5.4. The CONNECT Command)SH 51420 XM (245)SH 9620 21584 MT (12.5.5. The SET, SHOW, and DEFINE Commands)SH 51420 XM (245)SH 9620 22664 MT (12.5.6. Program Management Commands)SH 51420 XM (250)SH 7620 23744 MT (12.6. Login Scripts: The INPUT, OUTPUT, CLEAR, and PAUSE Commands)SH 51420 XM (252)SH 7620 24824 MT (12.7. Raw Download and Upload)SH 51420 XM (255)SH 7620 25904 MT (12.8. Kermit-20 Examples)SH 51420 XM (257)SH 7620 26984 MT (12.9. Installation of Kermit-20)SH 51420 XM (259)SH 12 SS 6120 28508 MT (13. PDP-11 Kermit)SH 51120 XM (261)SH 10 SS 7620 29898 MT (13.1. File Systems on the PDP-11)SH 51420 XM (262)SH 9620 30978 MT (13.1.1. File Specifications)SH 51420 XM (262)SH 9620 32058 MT (13.1.2. File Formats \050Binary and Text\051)SH 51420 XM (263)SH 11620 33138 MT (13.1.2.1. RT-11 and TSX+)SH 51420 XM (263)SH 11620 34218 MT (13.1.2.2. RSTS/E, P/OS and RSX-11M/M+)SH 51420 XM (263)SH 9620 35298 MT (13.1.3. Saving Files on the PDP-11 From Your Microcomputer)SH 51420 XM (263)SH 9620 36378 MT (13.1.4. Program Operation)SH 51420 XM (264)SH 11620 37458 MT (13.1.4.1. RSTS/E)SH 51420 XM (264)SH 11620 38538 MT (13.1.4.2. RSX-11M/M+)SH 51420 XM (264)SH 11620 39618 MT (13.1.4.3. RT-11/TSX+)SH 51420 XM (264)SH 11620 40698 MT (13.1.4.4. P/OS)SH 51420 XM (264)SH 7620 41778 MT (13.2. Local and Remote Operation)SH 51420 XM (264)SH 7620 42858 MT (13.3. Kermit-11 Commands)SH 51420 XM (265)SH 7620 43938 MT (13.4. Commands for File Transfer)SH 51420 XM (266)SH 9620 45018 MT (13.4.1. Server Operation)SH 51420 XM (268)SH 9620 46098 MT (13.4.2. Commands for Servers)SH 51420 XM (268)SH 7620 47178 MT (13.5. Commands for Local File Management)SH 51420 XM (269)SH 9620 48258 MT (13.5.1. The CONNECT Command)SH 51420 XM (269)SH 7620 49338 MT (13.6. The SET Command)SH 51420 XM (270)SH 9620 50418 MT (13.6.1. The DIAL Command)SH 51420 XM (283)SH 7620 51498 MT (13.7. System Manager's Notes)SH 51420 XM (284)SH 9620 52578 MT (13.7.1. Odds and Ends)SH 51420 XM (284)SH 7620 53658 MT (13.8. Typical Kermit-11 Transfer Rates)SH 51420 XM (289)SH 7620 54738 MT (13.9. Common Problems)SH 51420 XM (289)SH 12 SS 6120 56262 MT (14. Apple II Kermit)SH 51120 XM (291)SH 10 SS 7620 57652 MT (14.1. Supported Systems and Devices)SH 51420 XM (291)SH 7620 58732 MT (14.2. The DOS 3.3 File System)SH 51420 XM (292)SH 7620 59812 MT (14.3. The PRODOS File System)SH 51420 XM (293)SH 7620 60892 MT (14.4. Program Operation)SH 51420 XM (293)SH 7620 61972 MT (14.5. Kermit-65 Commands)SH 51420 XM (295)SH 7620 63052 MT (14.6. Standard Installation)SH 51420 XM (309)SH 7620 64132 MT (14.7. Problems)SH 51420 XM (310)SH 7620 65212 MT (14.8. Customizing Kermit-65)SH 51420 XM (316)SH ES %%Page: v 370 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (Kermit User Guide)SH 10 /Times-Italic AF 52331 XM (Page v)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (15. CP/M-80 KERMIT)SH 53280 XM (319)SH 10 SS 9780 9394 MT (15.1. Summary of CP/M)SH 53580 XM (320)SH 9780 10474 MT (15.2. Kermit-80 Description)SH 53580 XM (321)SH 9780 11554 MT (15.3. Kermit-80 Flavors)SH 53580 XM (327)SH 11780 12634 MT (15.3.1. Generic Kermit-80)SH 53580 XM (327)SH 11780 13714 MT (15.3.2. CP/M 3 Kermit)SH 53580 XM (328)SH 11780 14794 MT (15.3.3. System-Specific Versions)SH 53580 XM (328)SH 9780 15874 MT (15.4. Installation of Kermit-80)SH 53580 XM (331)SH 11780 16954 MT (15.4.1. Organization of Kermit-80)SH 53580 XM (332)SH 11780 18034 MT (15.4.2. Downloading Kermit-80)SH 53580 XM (335)SH 11780 19114 MT (15.4.3. Assembling Kermit-80 from the sources)SH 53580 XM (338)SH 9780 20194 MT (15.5. Adding Support For A New System)SH 53580 XM (341)SH 9780 21274 MT (15.6. Notes on New Features in Kermit-80 Version 4)SH 53580 XM (342)SH 11780 22354 MT (15.6.1. Interface Data.)SH 53580 XM (343)SH 11780 23434 MT (15.6.2. Jump Table.)SH 53580 XM (343)SH 9780 24514 MT (15.7. Future Work)SH 53580 XM (349)SH 12 SS 8280 26038 MT (16. CP/M-86 KERMIT)SH 53280 XM (351)SH 10 SS 9780 27428 MT (16.1. Kermit-86 Commands)SH 53580 XM (352)SH 9780 28508 MT (16.2. Installation:)SH 53580 XM (354)SH 9780 29588 MT (16.3. DEC Rainbow 100 Support)SH 53580 XM (355)SH 9780 30668 MT (16.4. NEC Advanced Personal Computer Support)SH 53580 XM (355)SH 12 SS 8280 32192 MT (Appendix I. The ASCII Character Set)SH 53280 XM (357)SH 8280 33716 MT (Index)SH 53280 XM (361)SH ES %%Page: vi 371 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page vi)SH 12 /Times-Bold AF 43052 XM (Kermit User Guide)SH 46800 50 6120 5709 UL ES %%Page: vii 372 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (Kermit User Guide)SH 10 /Times-Italic AF 51775 XM (Page vii)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 26702 8272 MT (List of Figures)SH 10 SS 9780 10550 MT (Figure 1-1:) SH( A) 500 W( Kermit Packet)SH 54580 XM (8)SH 9780 11630 MT (Figure 1-2:) SH( Kermit) 500 W( File Transfer)SH 54580 XM (9)SH 9780 12710 MT (Figure 4-1:) SH( Local) 500 W( and Remote Kermits)SH 54080 XM (23)SH 9780 13790 MT (Figure 5-1:) SH( MS-Kermit) 500 W( File Transfer Display Screen)SH 54080 XM (67)SH 9780 14870 MT (Figure 5-2:) SH( MS-Kermit) 500 W( Script for Logging In)SH 53580 XM (100)SH 9780 15950 MT (Figure 5-3:) SH( MS-Kermit) 500 W( Script for More Control of a Hayes 2400 bps Modem)SH 53580 XM (102)SH 9780 17030 MT (Figure 5-4:) SH( MS-DOS) 500 W( Batch File Invoking Kermit to Send VAX Mail)SH 53580 XM (103)SH 9780 18110 MT (Figure 5-5:) SH( MS-Kermit) 500 W( Script for Logging into VAX and Sending Mail)SH 53580 XM (104)SH 9780 19190 MT (Figure 5-6:) SH( An) 500 W( Advanced MS-Kermit Initialization File)SH 53580 XM (105)SH 9780 20270 MT (Figure 7-1:) SH( MacKermit) 500 W( Key Modifier Dialog)SH 53580 XM (171)SH 9780 21350 MT (Figure 12-1:) SH( DECSYSTEM-20) 500 W( Word/Byte Organization)SH 53580 XM (235)SH 9780 22430 MT (Figure 12-2:) SH( DEC-20) 500 W( Kermit Local Operation)SH 53580 XM (238)SH 9780 23510 MT (Figure 14-1:) SH( VT100) 500 W( Keypad on an Apple Keyboard)SH 53580 XM (306)SH 9780 24590 MT (Figure 14-2:) SH( VT100) 500 W( Keypad on an Apple//gs or Equivalent Keypad)SH 53580 XM (307)SH 9780 25670 MT (Figure 14-3:) SH( VT52) 500 W( Keypad on an Apple Keyboard)SH 53580 XM (308)SH 9780 26750 MT (Figure 15-1:) SH( Bootstrap) 500 W( program for Kermit-80 and CP/M Version 2.2)SH 53580 XM (337)SH ES %%Page: viii 373 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page viii)SH 12 /Times-Bold AF 43052 XM (Kermit User Guide)SH 46800 50 6120 5709 UL ES %%Page: ix 374 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (Kermit User Guide)SH 10 /Times-Italic AF 52053 XM (Page ix)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 27013 8272 MT (List of Tables)SH 10 SS 9780 10550 MT (Table 5-1:) SH( MS-DOS) 500 W( Kermit Backslash Codes)SH 54080 XM (54)SH 9780 11630 MT (Table 5-2:) SH( The) 500 W( US ASCII Character Set \050ANSI X3.4-1977\051)SH 54080 XM (55)SH 9780 12710 MT (Table 5-3:) SH( RS-232-C) 500 W( Modem Signals)SH 54080 XM (62)SH 9780 13790 MT (Table 5-4:) SH( Kermit-MS) 500 W( Single-Character CONNECT Escape Commands)SH 54080 XM (63)SH 9780 14870 MT (Table 5-5:) SH( Adapters) 500 W( Supported by IBM PC MS-Kermit for Tektronix Emulation)SH 54080 XM (66)SH 9780 15950 MT (Table 5-6:) SH( Kermit-MS) 500 W( Verbs for the IBM PC Family)SH 54080 XM (84)SH 9780 17030 MT (Table 5-7:) SH( Kermit-MS) 500 W( Terminal Emulation Options)SH 53580 XM (106)SH 9780 18110 MT (Table 5-8:) SH( Kermit-MS) 500 W( Screen Scroll Keys)SH 53580 XM (106)SH 9780 19190 MT (Table 5-9:) SH( Kermit-MS) 500 W( Verbs for the DEC Rainbow)SH 53580 XM (107)SH 9780 20270 MT (Table 5-10:) SH( Response) 500 W( of MS-Kermit Tektronix Emulator to Received Characters)SH 53580 XM (119)SH 9780 21350 MT (Table 5-11:) SH( Tektronix) 500 W( Dot-Drawing Commands)SH 53580 XM (121)SH 9780 22430 MT (Table 5-12:) SH( MS-Kermit) 500 W( Tektronix Coordinate Interpretation)SH 53580 XM (122)SH 9780 23510 MT (Table 5-13:) SH( IBM) 500 W( PC/XT/AT Serial Port Numbers)SH 53580 XM (127)SH 9780 24590 MT (Table 8-1:) SH( Error) 500 W( messages and codes for Kermit-370)SH 53580 XM (189)SH 9780 25670 MT (Table 13-1:) SH( Kermit-11) 500 W( File Types)SH 53580 XM (276)SH 9780 26750 MT (Table 14-1:) SH( Apple) 500 W( II Communication Cards Supported by Kermit-65)SH 53580 XM (292)SH 9780 27830 MT (Table 14-2:) SH( Kermit-65) 500 W( Single-Character CONNECT Escape Commands)SH 53580 XM (297)SH 9780 28910 MT (Table 14-3:) SH( Apple) 500 W( II/II+ Keyboard Escapes)SH 53580 XM (297)SH 9780 29990 MT (Table 14-4:) SH( PRODOS) 500 W( file types, part 1)SH 53580 XM (302)SH 9780 31070 MT (Table 14-5:) SH( PRODOS) 500 W( file types, part 2)SH 53580 XM (303)SH 9780 32150 MT (Table 15-1:) SH( Kermit-80) 500 W( SET PORT Options)SH 53580 XM (327)SH 9780 33230 MT (Table 15-2:) SH( Systems) 500 W( supported by Kermit-80 \050Part 1\051)SH 53580 XM (333)SH 9780 34310 MT (Table 15-3:) SH( Systems) 500 W( supported by Kermit-80 \050Part 2\051)SH 53580 XM (334)SH 9780 35390 MT (Table 15-4:) SH( Terminals) 500 W( supported by Kermit-80)SH 53580 XM (335)SH 9780 36470 MT (Table 15-5:) SH( Terminals) 500 W( known to Kermit-80)SH 53580 XM (341)SH ES %%Trailer %%Pages: 374 %%DocumentFonts: Times-Roman Times-Bold Times-Italic Courier Symbol