%!PS-Adobe-2.0 %%Title: ikxhdr.mss %%DocumentFonts: (atend) %%Creator: John Chandler,,, and Scribe 7(1700) %%CreationDate: 15 October 1993 16:32 %%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 /RC {100.0 -100.0 scale 612.0 0.0 translate -90.0 rotate .01 -.01 scale} bind def /URC {100.0 -100.0 scale 90.0 rotate -612.0 0.0 translate .01 -.01 scale} bind def /RCC {100.0 -100.0 scale 0.0 -792.0 translate 90.0 rotate .01 -.01 scale} bind def /URCC {100.0 -100.0 scale -90.0 rotate 0.0 792.0 translate .01 -.01 scale} bind def % Generate encodings for accent fonts. Taken from the Postscript "Cookbook" /reencodedict 6 dict def /ReEncode { reencodedict begin /newencoding exch def /newfontname exch def /basefontname exch def /basefontdict basefontname findfont def /newfont basefontdict maxlength dict def basefontdict {exch dup /FID ne dup /Encoding ne and { exch newfont 3 1 roll put } { pop pop } ifelse } forall newfont /FontName newfontname put newfont /Encoding newencoding put newfontname newfont definefont pop end } def /Stuff { exch 1 add dup Accent 4 2 roll exch put } def /Accent 256 array def 0 1 255 { Accent exch /.notdef put } for 8#040 [ /exclamdown /dotlessi /AE /OE /Oslash /Lslash /acute /guillemotleft /guillemotright /macron /cent /sterling /currency /yen /bar /section /dieresis /hungarumlaut] { Stuff } forall pop 8#062 [ /ae /oe /oslash /thorn /lslash /ordfeminine /degree /ordmasculine /paragraph /periodcentered /florin /ogonek] { Stuff } forall pop 8#076 [ /questiondown /caron] { Stuff } forall pop 8#100 [ /Aacute /Acircumflex /Adieresis /Agrave /Aring /Atilde /Ccedilla /Eacute /Ecircumflex /Edieresis /Egrave /Iacute /Icircumflex /Idieresis /Igrave /Ntilde /Oacute /Ocircumflex /Odieresis /Ograve /Otilde /Scaron /Uacute /Ucircumflex /Udieresis /Ugrave /Ydieresis /Zcaron /Eth /Thorn /germandbls /breve] { Stuff } forall pop 8#140 [ /aacute /acircumflex /adieresis /agrave /aring /atilde /ccedilla /eacute /ecircumflex /edieresis /egrave /iacute /icircumflex /idieresis /igrave /ntilde /oacute /ocircumflex /odieresis /ograve /otilde /scaron /uacute /ucircumflex /udieresis /ugrave /ydieresis /zcaron /eth /cedilla] { Stuff } forall pop 8#177 [ /a /b /c /d /e /f /g /h /i /j /k /l /m /n /o /p /q /r /s /t /u /v /w /x /y /z /A /B /C /D /E /F /G /H /I /J /K /L /M /N /O /P /Q /R /S /T /U /V /W /X /Y /Z /hungarumlaut /grave /breve /circumflex /tilde /macron /breve /dotaccent /dieresis /ring /cedilla /hungarumlaut /ogonek /caron] { Stuff } forall pop /Times-Roman /Times-Accent Accent ReEncode /Times-Bold /Times-Bold-Accent Accent ReEncode /Times-Italic /Times-Italic-Accent Accent ReEncode /Helvetica /Helvetica-Accent Accent ReEncode /Helvetica-Bold /Helvetica-Bold-Accent Accent ReEncode /Helvetica-Oblique /Helvetica-Italic-Accent Accent ReEncode /Helvetica-Narrow /Helvetica-Narrow-Accent Accent ReEncode /Helvetica-Narrow-Bold /Helvetica-Narrow-Bold-Accent Accent ReEncode /Helvetica-Narrow-Oblique /Helvetica-Narrow-Italic-Accent Accent ReEncode /AvantGarde-Book /Avantgarde-Accent Accent ReEncode /AvantGarde-BookOblique /Avantgarde-Italic-Accent Accent ReEncode /AvantGarde-Demi /Avantgarde-Bold-Accent Accent ReEncode /Courier /Courier-Accent Accent ReEncode /Courier-Bold /Courier-Bold-Accent Accent ReEncode /Courier-Oblique /Courier-Italic-Accent Accent ReEncode /Palatino-Roman /Palatino-Accent Accent ReEncode /Palatino-Bold /Palatino-Bold-Accent Accent ReEncode /Palatino-Italic /Palatino-Italic-Accent Accent ReEncode /Bookman-Light /Bookman-Accent Accent ReEncode /Bookman-Demi /Bookman-Bold-Accent Accent ReEncode /Bookman-LightItalic /Bookman-Italic-Accent Accent ReEncode /ZapfChancery-MediumItalic /Chancery-Accent Accent ReEncode /NewCenturySchlbk-Roman /NewCenturySchlbk-Accent Accent ReEncode /NewCenturySchlbk-Bold /NewCentury-Bold-Accent Accent ReEncode /NewCenturySchlbk-Italic /NewCentury-Italic-Accent Accent ReEncode /Garamond-Light /Garamond-Accent Accent ReEncode /Garamond-Bold /Garamond-Bold-Accent Accent ReEncode /Garamond-LightItalic /Garamond-Italic-Accent Accent ReEncode %%EndProlog %%Page: 0 1 BS 0 SI 15 /Times-Bold AF 14779 26885 MT (IBM SYSTEM/370 CICS KERMIT USER'S GUIDE)SH 13 SS 28538 30244 MT (Version 4.3)SH 10 /Times-Roman AF 28777 34323 MT (John Chandler)SH 22500 36715 MT (Harvard/Smithsonian Center for Astrophysics)SH /Times-Italic SF 27694 39107 MT (September 30, 1993)SH /Times-Roman SF 26485 43891 MT (Copyright \050C\051 1981, 1993)SH 20111 45087 MT (Trustees of Columbia University in the City of New York)SH /Times-Italic SF 18429 47479 MT (Permission is granted to any individual or institution to use, copy,)SH 18178 48675 MT (or redistribute this document so long as it is not sold for profit, and)SH 23291 49871 MT (provided this copyright notice is retained.)SH ES %%Page: i 48 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (IBM System/370 Kermit)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 (1. IBM 370 KERMIT)SH 54480 XM (1)SH 10 SS 9780 12074 MT (1.1. Translation Tables)SH 54580 XM (2)SH 9780 13154 MT (1.2. File Attributes)SH 54580 XM (6)SH 9780 14234 MT (1.3. Program Operation)SH 54580 XM (6)SH 9780 15314 MT (1.4. Kermit-370 Subcommands)SH 54580 XM (7)SH 9780 16394 MT (1.5. Before Connecting to the Mainframe)SH 54080 XM (25)SH 9780 17474 MT (1.6. Trouble-shooting Protocol Converters)SH 54080 XM (26)SH 9780 18554 MT (1.7. After Returning from Kermit-370)SH 54080 XM (28)SH 9780 19634 MT (1.8. What's New)SH 54080 XM (29)SH 9780 20714 MT (1.9. What's Missing)SH 54080 XM (30)SH 9780 21794 MT (1.10. Further Reading)SH 54080 XM (30)SH 12 SS 8280 23318 MT (2. IBM CICS KERMIT)SH 53880 XM (33)SH 10 SS 9780 24708 MT (2.1. CICS Data Objects)SH 54080 XM (34)SH 9780 25788 MT (2.2. Program Operation)SH 54080 XM (36)SH 9780 26868 MT (2.3. Kermit-CICS Subcommands)SH 54080 XM (38)SH 9780 27948 MT (2.4. How to build an executable Kermit-CICS)SH 54080 XM (42)SH 9780 29028 MT (2.5. What's New)SH 54080 XM (43)SH 9780 30108 MT (2.6. What's Missing)SH 54080 XM (43)SH 12 SS 8280 31632 MT (Index)SH 53880 XM (45)SH ES %%Page: ii 49 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page ii)SH 12 /Times-Bold AF 42185 XM (Kermit User's Guide)SH 46800 50 6120 5709 UL ES %%Page: iii 50 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (IBM System/370 Kermit)SH 10 /Times-Italic AF 51941 XM (Page iii)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 27013 8272 MT (List of Tables)SH 10 SS 9780 10550 MT (Table 1-1:) SH( Allowed) 500 W( character set combinations in Kermit-370)SH 54580 XM (3)SH 9780 11630 MT (Table 1-2:) SH( EBCDIC) 500 W( \050hexadecimal\051 code points for LATIN1)SH 54580 XM (4)SH 9780 12710 MT (Table 1-3:) SH( Character) 500 W( graphics for EBCDIC codes)SH 54580 XM (5)SH 9780 13790 MT (Table 1-4:) SH( Error) 500 W( messages and codes for Kermit-370)SH 54080 XM (29)SH ES %%Page: 1 2 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (1. IBM 370 KERMIT)SH 10 /Times-Italic AF 52275 XM (Page 1)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 8280 8272 MT (1. IBM 370 KERMIT)SH 10 /Times-Italic AF 8280 10566 MT (Program:)SH /Times-Roman SF 15780 XM (John Chandler \050Harvard/Smithsonian Center for) 490 W( Astrophysics\051; contributions from Va)489 W /Times-Accent SF (g)SH /Times-Roman SF (e)SH 15780 11671 MT (Kundak)SH /Times-Accent SF (g)SH /Times-Roman SF (i and Daphne Tzoar \050Columbia) 291 W( U\051, Bob Shields \050U. Maryland\051, Greg Small \050UC)292 W 15780 12776 MT (Berkeley\051, Clark Frazier \050Harvard Bus. Sch.\051, Bob Bolch and Steve Blankinship) 65 W( \050Triangle\051, Ron)64 W 15780 13881 MT (Rusnak \050U. Chicago\051, Roger Fajman and Dale Wright \050NIH\051, Andr)156 W /Times-Accent SF (h)SH /Times-Roman SF 44862 XM (Pirard \050U. Li)157 W /Times-Accent SF (k)SH /Times-Roman SF (ge\051, Pierre)157 W 15780 14986 MT (Goyette \050McGill U.\051)SH /Times-Italic SF 8280 16091 MT (Language:)SH /Times-Roman SF 15780 XM (IBM 370 Assembler)SH /Times-Italic SF 8280 17196 MT (Documentation:)SH /Times-Roman SF 15780 XM (John Chandler \050CfA\051)SH /Times-Italic SF 8280 18301 MT (Version:)SH /Times-Roman SF 15780 XM (4.3)SH /Times-Italic SF 8280 19406 MT (Date:)SH /Times-Roman SF 15780 XM (1993 September)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, 3090,)50 W /Times-Italic SF 29107 XM (etc.)SH /Times-Roman SF (\051 under a variety of operating systems. Kermit-370) 50 W( operates)51 W 8280 24190 MT (over asynchronous ASCII communication lines attached to a 3705-style) 181 W( or protocol enveloping 3708 front end)180 W 8280 25386 MT (\050``)SH /Courier SF (TTY)SH /Times-Roman SF ('' or line-mode devices\051, to a Series/1 or 4994 running the Yale ASCII Terminal) 54 W( Communication System or)55 W 8280 26582 MT (the IBM 7171 ASCII Device) 118 W( Control Unit or a 9370 with ASCII subsystem \050``)117 W /Courier SF (SERIES1)SH /Times-Roman SF ('' devices\051, to the IBM)117 W 8280 27778 MT (3174 protocol converter at level B2.0 or higher \050``)9 W /Courier SF (AEA)SH /Times-Roman SF ('' devices\051, or to front-ends) 9 W( with graphics pass-through mode,)10 W 8280 28974 MT (such as the Datastream/Leedata 8010 and PCI 1076 \050``)181 W /Courier SF (GRAPHICS)SH /Times-Roman SF ('' devices\051. As of this writing, the pending)181 W 8280 30170 MT (implementation of full\050er\051 7171 compatibility in the program product) 205 W( SIM3278 has not been completed. The)206 W 8280 31366 MT (non-line-mode devices are often called) 135 W( full-screen devices. For more details on front ends, see the section SET)134 W 8280 32562 MT (CONTROLLER.)SH 8280 34954 MT (The source is coded in IBM 370 assembly language and is compatible with the F, VS, and H assemblers.) 33 W( The) 317 W( code)34 W 8280 36150 MT (is divided into sections, some generic and some specific to an individual operating system. While) 122 W( the details of)121 W 8280 37346 MT (file-system and supervisor interaction vary widely) 3 W( among the systems available for IBM 370's, the basic features are)4 W 8280 38542 MT (essentially the same. This chapter describes the features common to all variants of Kermit-370,) 154 W( and a separate)153 W 8280 39738 MT (chapter will deal with the system-specific details for each variant.)SH 8280 42130 MT (IBM 370) 218 W( systems have some peculiarities that users should be aware of. First, these systems are essentially)219 W 8280 43326 MT (half-duplex; the communication line must "turn around" before any data can be sent. The ``)165 W /Courier SF (TTY)SH /Times-Roman SF ('' devices are)165 W 8280 44522 MT (strictly half-duplex, and even the ``)241 W /Courier SF (SERIES1)SH /Times-Roman SF ('', ``)241 W /Courier SF (GRAPHICS)SH /Times-Roman SF ('', and) 241 W( ``)242 W /Courier SF (AEA)SH /Times-Roman SF ('' devices, although they maintain)242 W 8280 45718 MT (full-duplex communication with the terminal, must transmit a block at a time to the) 126 W( mainframe. The fact that a)125 W 8280 46914 MT (packet has been received from the IBM system through a ``)36 W /Courier SF (TTY)SH /Times-Roman SF ('' device is no guarantee that it) 36 W( is ready for a reply;)37 W 8280 48110 MT (generally, the) 62 W( true indicator of readiness is the line turnaround character \050XON\051, which the operating system sends)61 W 8280 49306 MT (immediately before issuing) 13 W( a read request. On some systems, however, it is possible for Kermit to do away with the)14 W 8280 50502 MT (system-supplied turnaround and schedule read requests immediately after the) 77 W( corresponding writes. It is up to the)76 W 8280 51698 MT (user to tell the other Kermit how it must conform to the requirements of the IBM mainframe.)SH 8280 54090 MT (A second distinction is) 78 W( that disk files are encoded using the EBCDIC character set. Consequently, there are three)79 W 8280 55286 MT (layers of character translation on packets exchanged on a ``)17 W /Courier SF (TTY)SH /Times-Roman SF ('' device. For an incoming) 17 W( packet, the outer layer is)16 W 8280 56482 MT (provided by the operating system, which translates all characters from ASCII to EBCDIC. Kermit-370 must) 85 W( then)86 W 8280 57678 MT (translate the packets back to ASCII \050the middle layer\051 in order) 49 W( to calculate and verify the checksum. Data arriving)48 W 8280 58874 MT (through a ``)115 W /Courier SF (SERIES1)SH /Times-Roman SF ('', ``)115 W /Courier SF (GRAPHICS)SH /Times-Roman SF ('', or ``)115 W /Courier SF (AEA)SH /Times-Roman SF ('' device are still in ASCII and therefore bypass) 115 W( the two outer)116 W 8280 60070 MT (layers. In) 442 W( any case, Kermit-370 translates text files finally into EBCDIC \050the inner layer\051) 96 W( before storing on disk.)95 W 8280 61266 MT (When Kermit-370 sends a file, the opposite translations occur. The middle-layer) 29 W( tables used by Kermit must be the)30 W 8280 62462 MT (inverses of the corresponding outer-layer) 58 W( ones used by the host operating system if file transfers are to work at all.)57 W 8280 63658 MT (If necessary, the system programmer should add) 179 W( the appropriate SET TATOE/TETOA/TTABLE subcommands)180 W 8280 64854 MT (\050)SH /Times-Italic SF (q.v.)SH /Times-Roman SF (\051 to) 358 W( the global INIT file. Indeed, it is) 54 W( usually a good idea to set TTABLE ON in the global INIT file to force)53 W 8280 66050 MT (using different built-in sets of tables for the) 32 W( inner and middle layers whenever the system has ``)33 W /Courier SF (TTY)SH /Times-Roman SF ('' devices. The)33 W 8280 67246 MT (standard 7-bit ASCII-to-EBCDIC translations can be found in the Appendix) 169 W( or the IBM System/370 Reference)168 W 8280 68442 MT (Card. See) 250 W( the section "Translation Tables" for more details.)SH 8280 70834 MT (Another distinction of IBM 370's is that) 74 W( they store and retrieve files as records rather than byte streams. Records)75 W ES %%Page: 2 3 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 2)SH 12 /Times-Bold AF 30785 XM (Kermit User's Guide: IBM 370 KERMIT 1)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (may be either fixed-length with some sort of padding \050as) 115 W( needed\051 or varying-length with some sort of \050generally)114 W 6120 9082 MT (hidden\051 delimiters.) 88 W( Thus,) 428 W( Kermit-370 must assemble incoming data packets into records by stripping off carriage)89 W 6120 10278 MT (return-linefeed pairs \050CRLF's\051 and padding with blanks or truncating as needed) 82 W( and must strip trailing blanks and)81 W 6120 11474 MT (append CRLF's to outgoing records. \050See the SET FILE TYPE subcommand.\051 Further, disk files) 9 W( typically have the)10 W 6120 12670 MT (records combined into blocks for efficiency. One consequence of this form of storage) 90 W( is that files have attributes)89 W 6120 13866 MT (describing the component records: maximum record length \050LRECL\051, record format \050RECFM\051,) 192 W( and sometimes)193 W 6120 15062 MT (block size \050BLKSIZE\051.)SH 6120 17454 MT (As mentioned before, Kermit-370 is) 13 W( a family of programs. At present, only the CMS, TSO, MUSIC, ROSCOE, and)12 W 6120 18650 MT (CICS variants are operational. Variants for DOS-4 and MTS have at least) 132 W( reached the "drawing board," but no)133 W 6120 19846 MT (others have even been started as of this writing.) 189 W( Volunteers) 626 W( are always welcome to port Kermit-370 to other)188 W 6120 21042 MT (operating systems or add new features to the existing family.) 74 W( Anyone) 400 W( interested should first get in touch with the)75 W 6120 22238 MT (Center for Computing Activities at Columbia University) 115 W( to find out what projects of a similar nature are already)114 W 6120 23434 MT (pending \050and thereby prevent unnecessary duplication of effort\051. There are supplemental files) 239 W( in the Kermit)240 W 6120 24630 MT (distribution with explanations of how to go about porting Kermit-370 and how) 144 W( to add support for new terminal)143 W 6120 25826 MT (controller types. For details, refer to the installation guide for the variant of your choice.)SH 14 /Times-Bold AF 6120 29428 MT (1.1. Translation Tables)SH 10 /Times-Roman AF 6120 31546 MT (Traditionally, IBM mainframe Kermits have translated 7-bit ASCII characters) 190 W( to 8-bit EBCDIC characters and)191 W 6120 32742 MT (ignored the "parity" bit in the process.) 17 W( Similarly,) 283 W( the 8-bit EBCDIC characters have been mapped onto 7-bit ASCII,)16 W 6120 33938 MT (thereby producing many ambiguities in translating the ASCII files back) 1 W( to EBCDIC. These ambiguities fall into two)2 W 6120 35134 MT (categories: EBCDIC characters not representable in ASCII) 247 W( have been rendered as ASCII nulls, and alternate)246 W 6120 36330 MT (EBCDIC representations of characters such as the ASCII backslash have been mapped) 44 W( together, but at least no two)45 W 6120 37526 MT (7-bit ASCII characters) 303 W( are translated into the same EBCDIC character. The ambiguities were tolerable in)302 W 6120 38722 MT (environments where the traditionally non-printable characters never occurred in) 107 W( text files, but text processing has)108 W 6120 39918 MT (increasingly tended to include such characters for mathematical formulas) 211 W( or for languages other than English.)210 W 6120 41114 MT (Ultimately, the translation tables must become completely invertible,) 48 W( lest information be lost in the transfer. There)49 W 6120 42310 MT (has long been an option to) 80 W( replace parts of the translation tables via commands from the user \050or imbedded in the)79 W 6120 43506 MT (INIT files\051, but such replacements were always supported locally and were, therefore, basically non-standard.)SH 6120 45898 MT (The concept) 87 W( of standard translations is currently in a state of flux because of the proliferation of 8-bit code pages)88 W 6120 47094 MT (and the countervailing efforts at standardization among groups such) 268 W( as the ISO and Kermit developers. In)267 W 6120 48290 MT (particular, Kermit-370 now supports a set of EBCDIC and "extended ASCII" code pages with built-in translation)103 W 6120 49486 MT (tables and) 23 W( automatic identification of the "ASCII" transfer character set via Attribute packets. This facility supports)22 W 6120 50682 MT (files stored using numerous IBM Country Extended Code Pages and permits transfers using character sets) 87 W( ASCII,)88 W 6120 51878 MT (ARABIC, CYRILLIC, GREEK, HEBREW, JAPAN-EUC, KATAKANA, LATIN1, LATIN2, LATIN3,) 42 W( and THAI.)41 W 6120 53074 MT (See Table 1-1 for a display of the allowed combinations of character sets. See also file ISOK7.TXT in) 57 W( the Kermit)58 W 6120 54270 MT (distribution for a somewhat) 10 W( outdated description of the protocol extensions. Kermit-370 currently supports text files)9 W 6120 55466 MT (in the following languages:) 261 W( Afrikaans,) 773 W( Albanian, Arabic, Bulgarian, Byelorussian, Catalan, Czech, Croatian,)262 W 6120 56662 MT (Danish, Dutch, English, Esperanto, Faeroese, Finnish,) 415 W( French, Gaelic, Galician, German, Greek, Hebrew,)414 W 6120 57858 MT (Hungarian, Icelandic, Italian,) 39 W( Japanese \050Katakana and Kanji\051, Lao, Latin, Macedonian, Maltese, Norwegian, Polish,)40 W 6120 59054 MT (Portuguese, Quechua, Romanian, Russian, Serbian, Slovak, Slovene, Spanish,) 197 W( Swahili, Swedish, Thai, Turkish,)196 W 6120 60250 MT (Ukrainian, and Volap)8 W /Times-Accent SF (y)SH /Times-Roman SF (k. Visual) 266 W( representations of the characters sets may be found in the ISO register \050for) 8 W( transfer\051)9 W 6120 61446 MT (and in various IBM documents, such as S544-3156 "About Type" \050for files\051.)SH 6120 63838 MT (Kermit itself normally operates in) 39 W( English, but there are versions with the interactive messages translated into other)38 W 6120 65034 MT (languages. The) 950 W( currently available languages) 350 W( are Czech, Dutch, Finnish, French, German, Italian, Polish,)351 W 6120 66230 MT (Portuguese, Russian, and Spanish. Special thanks to Petr Adelsberger, Mauricio) 167 W( Alvarenga, Lorenzo Beltrame,)166 W 6120 67426 MT (Janusz Bien, Jose Eduardo de Lucca, Richard Gatersleben, Kauko Haumalainen, Jaroslaw Kurowski,) 241 W( Roberto)242 W 6120 68622 MT (Magana, Alberto Rio, Christian Robert, Gisbert Selke, Karel Smuk, Rob van) 54 W( der Wal, Konstantin Vinogradov, and)53 W 6120 69818 MT (Joachim Wlodarz for preparing these translations. See the) 109 W( installation guide for details on the alternate-language)110 W 6120 71014 MT (versions. There) 250 W( are no translations yet of the help files, nor of this document.)SH ES %%Page: 3 4 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (1.1. Translation Tables)SH 10 /Times-Italic AF 52275 XM (Page 3)SH 46800 50 8280 5709 UL 46800 50 8280 8086 UL /Times-Roman SF 24400 10315 MT (Transfer character set)SH 3387 50 24400 10515 UL 3664 50 28037 10515 UL 1111 50 31951 10515 UL 10381 12744 MT (Local)SH 15614 XM (ASCII)SH 19726 XM (ARAB.)SH 24047 XM (CYR.)SH 27493 XM (GREEK)SH 31995 XM (HEB.)SH 35524 XM (JAPAN)SH 39885 XM (KATAK.)SH 45164 XM (L1)SH 47684 XM (L2)SH 49844 XM (L3)SH 52086 XM (THAI)SH 2277 50 10381 12944 UL 10033 15173 MT (CP037)SH 16670 XM (*)SH 45220 XM (**)SH 10033 16278 MT (CP273)SH 45220 XM (**)SH 10033 17383 MT (CP275)SH 45220 XM (**)SH 10033 18488 MT (CP277)SH 45220 XM (**)SH 10033 19593 MT (CP278)SH 45220 XM (**)SH 10033 20698 MT (CP280)SH 45220 XM (**)SH 10033 21803 MT (CP281)SH 36830 XM (*)SH 45220 XM (**)SH 10033 22908 MT (CP282)SH 45220 XM (**)SH 10033 24013 MT (CP284)SH 45220 XM (**)SH 10033 25118 MT (CP285)SH 45220 XM (**)SH 10033 26223 MT (CP290)SH 36830 XM (*)SH 41260 XM (**)SH 10033 27328 MT (CP297)SH 45220 XM (**)SH 10033 28433 MT (CP420)SH 20740 XM (**)SH 10033 29538 MT (CP424)SH 32620 XM (**)SH 10033 30643 MT (CP500)SH 16670 XM (*)SH 36830 XM (*)SH 45220 XM (**)SH 10033 31748 MT (CP838)SH 52780 XM (**)SH 10033 32853 MT (CP870)SH 47740 XM (**)SH 10033 33958 MT (CP871)SH 45220 XM (**)SH 10033 35063 MT (CP875)SH 28660 XM (**)SH 10033 36168 MT (CP880)SH 16670 XM (*)SH 24700 XM (**)SH 10033 37273 MT (CP905)SH 49900 XM (**)SH 9756 38378 MT (CZECH)SH 47990 XM (*)SH 10020 39483 MT (DKOI)SH 16670 XM (*)SH 24450 XM (***)SH 9686 40588 MT (EBCDIC)SH 16670 XM (*)SH 21240 XM (*)SH 44970 XM (***)SH 9659 41693 MT (H-EBCD)SH 36830 XM (*)SH 41510 XM (*)SH 9951 42798 MT (KANJI)SH 36830 XM (*)SH /Times-Bold SF 19098 44408 MT (Table 1-1:)SH /Times-Roman SF 23959 XM (Allowed character set combinations in Kermit-370)SH 8280 46018 MT (All allowed combinations are marked with asterisks,) 7 W( and the preferred combination in each row or column is the one)6 W 8280 47123 MT (with the most asterisks. Whenever a character set is specified, either directly or through an) 105 W( Attribute packet, the)106 W 8280 48228 MT (other category of character set is checked to) 83 W( see if it makes up an allowed combination. If not, it is forced to the)82 W 8280 49333 MT (preferred character set.)SH 46800 50 8280 51962 UL 8280 54154 MT (As nearly as possible, the tables in Kermit-370 are invertible, but all of the character sets) SH( reserve many \050typically 65\051)1 W 8280 55350 MT (code points for control characters and leave them officially undefined) 97 W( and unprintable. This applies both to IBM)96 W 8280 56546 MT (code pages and ISO standard 8-bit character sets. Although 33 of the controls have widely accepted mappings,) 48 W( the)49 W 8280 57742 MT (others do not, and) 86 W( Kermit-370 currently uses those given in an appendix of IBM's VS/Fortran Reference Manual.)85 W 8280 58938 MT (Needless to say, such translations are arbitrary) 109 W( and may be invalidated by future decisions at IBM or ISO. Still,)110 W 8280 60134 MT (most of the translations are likely to) 10 W( be stable in the long run. Table 1-2 shows the current translation from LATIN1)9 W 8280 61330 MT (to EBCDIC, which is likely to be the most) 166 W( often used. Other translations, including the reverse ones, may be)167 W 8280 62526 MT (displayed using the TDUMP subcommand of Kermit-370.)SH 8280 64918 MT (Besides converting files for transmission, Kermit-370 must also compensate for the EBCDIC/ASCII translation)143 W 8280 66114 MT (performed by some front ends and must, therefore, be able to apply the exact reverse translations on both) 41 W( input and)42 W 8280 67310 MT (output. This) 398 W( is the "middle layer" of translation described earlier for) 74 W( ``)73 W /Courier SF (TTY)SH /Times-Roman SF ('' devices. Consider the fate of a Left)73 W 8280 68506 MT (Square Bracket character in an inbound packet on a ``)53 W /Courier SF (TTY)SH /Times-Roman SF ('' line. It begins as) 53 W( ASCII code x'5B' \05091 decimal\051, but)54 W 8280 69702 MT (the front end translates it to EBCDIC before presenting it to Kermit-370. In) 153 W( this example, suppose it becomes)152 W 8280 70898 MT (EBCDIC code x'4A' \05074 decimal\051 instead of the standard x'AD' \050173 decimal\051. Then,) 23 W( Kermit must be primed with)24 W ES %%Page: 4 5 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 4)SH 12 /Times-Bold AF 29885 XM (Kermit User's Guide: IBM 370 KERMIT 1.1)SH 46800 50 6120 5709 UL 46800 50 6120 8086 UL 10 /Times-Roman AF 11103 10315 MT (-0)SH 13263 XM (-1)SH 15423 XM (-2)SH 17583 XM (-3)SH 19743 XM (-4)SH 21903 XM (-5)SH 24063 XM (-6)SH 26223 XM (-7)SH 28383 XM (-8)SH 30543 XM (-9)SH 32592 XM (-A)SH 34780 XM (-B)SH 36940 XM (-C)SH 39072 XM (-D)SH 41288 XM (-E)SH 43475 XM (-F)SH 7863 12744 MT (0-)SH 11020 XM (00)SH 13180 XM (01)SH 15340 XM (02)SH 17500 XM (03)SH 19660 XM (37)SH 21709 XM (2D)SH 23924 XM (2E)SH 26112 XM (2F)SH 28300 XM (16)SH 30460 XM (05)SH 32620 XM (25)SH 34696 XM (0B)SH 36856 XM (0C)SH 38989 XM (0D)SH 41204 XM (0E)SH 43392 XM (0F)SH 7863 13849 MT (1-)SH 11020 XM (10)SH 13180 XM (11)SH 15340 XM (12)SH 17500 XM (13)SH 19576 XM (3C)SH 21709 XM (3D)SH 23980 XM (32)SH 26140 XM (26)SH 28300 XM (18)SH 30460 XM (19)SH 32592 XM (3F)SH 34780 XM (27)SH 36856 XM (1C)SH 38989 XM (1D)SH 41204 XM (1E)SH 43392 XM (1F)SH 7863 14954 MT (2-)SH 11020 XM (40)SH 13069 XM (5A)SH 15312 XM (7F)SH 17416 XM (7B)SH 19576 XM (5B)SH 21736 XM (6C)SH 23980 XM (50)SH 26029 XM (7D)SH 28189 XM (4D)SH 30349 XM (5D)SH 32536 XM (5C)SH 34724 XM (4E)SH 36856 XM (6B)SH 39100 XM (60)SH 41176 XM (4B)SH 43420 XM (61)SH 7863 16059 MT (3-)SH 10992 XM (F0)SH 13152 XM (F1)SH 15312 XM (F2)SH 17472 XM (F3)SH 19632 XM (F4)SH 21792 XM (F5)SH 23952 XM (F6)SH 26112 XM (F7)SH 28272 XM (F8)SH 30432 XM (F9)SH 32509 XM (7A)SH 34724 XM (5E)SH 36856 XM (4C)SH 39044 XM (7E)SH 41204 XM (6E)SH 43392 XM (6F)SH 7863 17164 MT (4-)SH 10936 XM (7C)SH 13096 XM (C1)SH 15256 XM (C2)SH 17416 XM (C3)SH 19576 XM (C4)SH 21736 XM (C5)SH 23896 XM (C6)SH 26056 XM (C7)SH 28216 XM (C8)SH 30376 XM (C9)SH 32509 XM (D1)SH 34669 XM (D2)SH 36829 XM (D3)SH 38989 XM (D4)SH 41149 XM (D5)SH 43309 XM (D6)SH 7863 18269 MT (5-)SH 10909 XM (D7)SH 13069 XM (D8)SH 15229 XM (D9)SH 17444 XM (E2)SH 19604 XM (E3)SH 21764 XM (E4)SH 23924 XM (E5)SH 26084 XM (E6)SH 28244 XM (E7)SH 30404 XM (E8)SH 32564 XM (E9)SH 34558 XM (AD)SH 36884 XM (E0)SH 38905 XM (BD)SH 41232 XM (5F)SH 43309 XM (6D)SH 7863 19374 MT (6-)SH 11020 XM (79)SH 13180 XM (81)SH 15340 XM (82)SH 17500 XM (83)SH 19660 XM (84)SH 21820 XM (85)SH 23980 XM (86)SH 26140 XM (87)SH 28300 XM (88)SH 30460 XM (89)SH 32620 XM (91)SH 34780 XM (92)SH 36940 XM (93)SH 39100 XM (94)SH 41260 XM (95)SH 43420 XM (96)SH 7863 20479 MT (7-)SH 11020 XM (97)SH 13180 XM (98)SH 15340 XM (99)SH 17389 XM (A2)SH 19549 XM (A3)SH 21709 XM (A4)SH 23869 XM (A5)SH 26029 XM (A6)SH 28189 XM (A7)SH 30349 XM (A8)SH 32509 XM (A9)SH 34696 XM (C0)SH 36912 XM (4F)SH 38989 XM (D0)SH 41149 XM (A1)SH 43420 XM (07)SH 7863 21584 MT (8-)SH 11020 XM (20)SH 13180 XM (21)SH 15340 XM (22)SH 17500 XM (23)SH 19660 XM (24)SH 21820 XM (15)SH 23980 XM (06)SH 26140 XM (17)SH 28300 XM (28)SH 30460 XM (29)SH 32509 XM (2A)SH 34696 XM (2B)SH 36856 XM (2C)SH 39100 XM (09)SH 41149 XM (0A)SH 43336 XM (1B)SH 7863 22689 MT (9-)SH 11020 XM (30)SH 13180 XM (31)SH 15229 XM (1A)SH 17500 XM (33)SH 19660 XM (34)SH 21820 XM (35)SH 23980 XM (36)SH 26140 XM (08)SH 28300 XM (38)SH 30460 XM (39)SH 32509 XM (3A)SH 34696 XM (3B)SH 36940 XM (04)SH 39100 XM (14)SH 41204 XM (3E)SH 43364 XM (FF)SH 7752 23794 MT (A-)SH 11020 XM (41)SH 12958 XM (AA)SH 15229 XM (4A)SH 17416 XM (B1)SH 19632 XM (9F)SH 21736 XM (B2)SH 23869 XM (6A)SH 26056 XM (B5)SH 28133 XM (BB)SH 30376 XM (B4)SH 32509 XM (9A)SH 34669 XM (8A)SH 36856 XM (B0)SH 38905 XM (CA)SH 41121 XM (AF)SH 43253 XM (BC)SH 7780 24899 MT (B-)SH 11020 XM (90)SH 13152 XM (8F)SH 15173 XM (EA)SH 17361 XM (FA)SH 19521 XM (BE)SH 21709 XM (A0)SH 23896 XM (B6)SH 26056 XM (B3)SH 28189 XM (9D)SH 30238 XM (DA)SH 32536 XM (9B)SH 34696 XM (8B)SH 36856 XM (B7)SH 39016 XM (B8)SH 41176 XM (B9)SH 43225 XM (AB)SH 7780 26004 MT (C-)SH 11020 XM (64)SH 13180 XM (65)SH 15340 XM (62)SH 17500 XM (66)SH 19660 XM (63)SH 21820 XM (67)SH 23924 XM (9E)SH 26140 XM (68)SH 28300 XM (74)SH 30460 XM (71)SH 32620 XM (72)SH 34780 XM (73)SH 36940 XM (78)SH 39100 XM (75)SH 41260 XM (76)SH 43420 XM (77)SH 7752 27109 MT (D-)SH 10825 XM (AC)SH 13180 XM (69)SH 15173 XM (ED)SH 17389 XM (EE)SH 19521 XM (EB)SH 21736 XM (EF)SH 23841 XM (EC)SH 26028 XM (BF)SH 28300 XM (80)SH 30321 XM (FD)SH 32536 XM (FE)SH 34668 XM (FB)SH 36828 XM (FC)SH 38905 XM (BA)SH 41093 XM (AE)SH 43420 XM (59)SH 7808 28214 MT (E-)SH 11020 XM (44)SH 13180 XM (45)SH 15340 XM (42)SH 17500 XM (46)SH 19660 XM (43)SH 21820 XM (47)SH 23896 XM (9C)SH 26140 XM (48)SH 28300 XM (54)SH 30460 XM (51)SH 32620 XM (52)SH 34780 XM (53)SH 36940 XM (58)SH 39100 XM (55)SH 41260 XM (56)SH 43420 XM (57)SH 7835 29319 MT (F-)SH 10936 XM (8C)SH 13180 XM (49)SH 15145 XM (CD)SH 17361 XM (CE)SH 19493 XM (CB)SH 21708 XM (CF)SH 23813 XM (CC)SH 26084 XM (E1)SH 28300 XM (70)SH 30238 XM (DD)SH 32453 XM (DE)SH 34585 XM (DB)SH 36745 XM (DC)SH 38989 XM (8D)SH 41204 XM (8E)SH 43281 XM (DF)SH /Times-Bold SF 17272 32253 MT (Table 1-2:)SH /Times-Roman SF 22133 XM (EBCDIC \050hexadecimal\051 code points for LATIN1)SH 6120 33863 MT (This table shows the values of the EBCDIC equivalents for) 9 W( the code points in the LATIN1 character set. The values)8 W 6120 34968 MT (are arranged in LATIN1 collating sequence, and the rows and columns are labeled) 57 W( with the first and second digits,)58 W 6120 36073 MT (respectively, of the LATIN1 code points. For example, LATIN1 code 41 \050hex\051 is) 108 W( upper-case "A", and the inter-)107 W 6120 37178 MT (section of row "4-" and column "-1" has the value C1 \050hex\051, which is the EBCDIC code for) 53 W( "A". Rows "0-", "1-",)54 W 6120 38283 MT ("8-", and "9-" are officially) 108 W( undefined in ISO 8859-1 and so, in principle, could be changed at some future time,)107 W 6120 39388 MT (especially "8-" and "9-". Note that this table uses a) 103 W( format close to that of the TDUMP subcommand and of the)104 W 6120 40493 MT (Kermit code itself, but character-set tables are often displayed with the rows and columns interchanged.)SH 46800 50 6120 43122 UL 6120 44532 MT (a)SH /Courier SF 6838 XM (SET TETOA 74 91)23 W /Times-Roman SF 16180 XM (so that, when reconstructing the original ASCII packet, the character becomes x'5B' again.)23 W 6120 45728 MT (Otherwise, the packet checksum) 144 W( will appear invalid. Kermit comes with a pair of default tables, but it may be)145 W 6120 46924 MT (necessary to customize them, as this example shows. The) 10 W( following procedure will reveal any changes needed. The)9 W 6120 48120 MT (procedure has two) 35 W( stages: the first is for any line-mode front end, and the second only for front ends capable of full)36 W 6120 49316 MT (8-bit data transfer. Note) 336 W( that, although the discussion refers to hexadecimal values, the Kermit-370 SET)335 W 6120 50512 MT (subcommands require decimal numeric arguments. Also,) 15 W( note that this procedure assumes you will run Kermit with)16 W 6120 51708 MT (TTABLE set on; hence, the references to Kermit-370 tables are to TATOE and TETOA. If you choose to define)88 W 6120 52904 MT (Kermit's file translation to match that of the front end, you should leave TTABLE set) 47 W( off and remove the T's from)48 W 6120 54100 MT (the SET subcommands described below. This will also turn off the) 212 W( automatic switching of translation tables)211 W 6120 55296 MT (according to the Attribute packets received from the other Kermit.) 186 W( Under) 623 W( CMS, you must issue a)187 W /Courier SF 48533 XM (CMS SET)187 W 6120 56492 MT (INPUT)SH /Times-Roman SF 9370 XM (and a)SH /Courier SF 11758 XM (CMS SET OUTPUT)SH /Times-Roman SF 20408 XM (before starting this procedure.)SH 8120 58283 MT (1.)SH 9120 XM (Create a file containing all the non-control EBCDIC characters \050hex codes 40-FF\051 and display) 41 W( the file)40 W 9120 59388 MT (on any available ASCII terminal hooked up to the line-mode front end in question.)SH 8120 61046 MT (2.)SH 9120 XM (If any printable ASCII character is missing from the display, Kermit cannot work through) 98 W( this front)99 W 9120 62151 MT (end \050unless you modify the tables in the front end itself\051.)SH 8120 63809 MT (3.)SH 9120 XM (If any ASCII character appears twice, there is no cause for alarm.)SH 8120 65467 MT (4.)SH 9120 XM (If any ASCII character does not appear where it should, according to Table 1-3,) 56 W( a SET TATOE must)55 W 9120 66572 MT (be added to the system INIT file.) 166 W( For) 583 W( example, if EBCDIC code 5F \050Not Sign, according to the)167 W 9120 67677 MT (Appendix\051 appears as an ASCII Tilde) 53 W( \0507E\051, but EBCDIC A1 \050Tilde\051 does not, a SET TATOE 126 95)52 W 9120 68782 MT (is required. Warning: characters considered unprintable by) 83 W( the front end are likely to be filtered out)84 W 9120 69887 MT (entirely when you display the file; do not expect the display to line up just like Table 1-3.)SH 8120 71545 MT (5.)SH 9120 XM (Create a) 117 W( file on the mainframe using an ASCII terminal for input, and enter all 95 printable ASCII)116 W ES %%Page: 5 6 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (1.1. Translation Tables)SH 10 /Times-Italic AF 52275 XM (Page 5)SH 46800 50 8280 5709 UL /Times-Roman SF 11280 7886 MT (characters in collating sequence.) 216 W( You) 684 W( can presumably save time by skipping the 52 upper- and)217 W 11280 8991 MT (lower-case letters and the 10 digits.)SH 10280 10649 MT (6.)SH 11280 XM (Display the file from the previous step in hexadecimal or other binary form.)SH 10280 12307 MT (7.)SH 11280 XM (If any duplicates appear among the 95 characters \050or 33, if you) 164 W( have taken the short cut\051, Kermit)163 W 11280 13412 MT (cannot work through this front end \050unless you modify the tables in the front end\051.)SH 10280 15070 MT (8.)SH 11280 XM (Compare the hexadecimal codes with rows 2-7 of Table 1-2. If a discrepancy appears,) 23 W( a SET TETOA)24 W 11280 16175 MT (must be added to the system INIT file. For example, if ASCII Left) 42 W( Bracket \0505B\051 appears as EBCDIC)41 W 11280 17280 MT (4A, a SET TETOA 74 91 is needed. At this point, the first stage is complete.)SH 10280 18938 MT (9.)SH 11280 XM (If 8-bit line-mode file transfer is desired, you) 29 W( must now verify the extended character set. Display the)30 W 11280 20043 MT (file of) 34 W( EBCDIC codes again, this time using a terminal with extended character set display, or capture)33 W 11280 21148 MT (the session with a micro Kermit and display the resulting file in hexadecimal. If any code in the) 19 W( range)20 W 11280 22253 MT (A0-FE does not appear, the front end will not allow 8-bit) 214 W( Kermit data transfers. Generate SET)213 W 11280 23358 MT (TATOE entries for the entire range, as needed, just as in the example given for 7-bit codes.) SH( If) 252 W( the front)1 W 11280 24463 MT (end's translation tables are documented, it may be easier to) 92 W( work from the manual, but you must be)91 W 11280 25568 MT (sure that you have tables for all of the translations that occur on the data path.)SH 9780 27226 MT (10.)SH 11280 XM (Create a file of the 95 extended ASCII codes A0-FE, if possible,) 186 W( by using a terminal capable of)187 W 11280 28331 MT (transmitting those codes or transmitting a pre-made file "raw". If necessary,) 206 W( use the appropriate)205 W 11280 29436 MT (table\050s\051 in the manual\050s\051 instead.)SH 9780 31094 MT (11.)SH 11280 XM (Again, if any duplicates appear, this front end is incapable of 8-bit file transfers.) 47 W( Otherwise,) 345 W( generate)48 W 11280 32199 MT (SET TETOA entries as before.)SH 46800 50 8280 34190 UL 13430 36419 MT (0)SH 15590 XM (1)SH 17750 XM (2)SH 19910 XM (3)SH 22070 XM (4)SH 24230 XM (5)SH 26390 XM (6)SH 28550 XM (7)SH 30710 XM (8)SH 32870 XM (9)SH 34919 XM (A)SH 37106 XM (B)SH 39266 XM (C)SH 41399 XM (D)SH 43614 XM (E)SH 45802 XM (F)SH 10023 38848 MT (4-)SH 37315 XM (.)SH 39318 XM (<)SH 41593 XM (\050)SH 43638 XM (+)SH 45980 XM (|)SH 10023 39953 MT (5-)SH 13291 XM (&)SH 35113 XM (!)SH 37190 XM ($)SH 39350 XM (*)SH 41593 XM (\051)SH 43781 XM (;)SH 45845 XM (^)SH 10023 41058 MT (6-)SH 13513 XM (-)SH 15701 XM (/)SH 37315 XM (,)SH 39183 XM (%)SH 41510 XM (_)SH 43638 XM (>)SH 45858 XM (?)SH 10023 42163 MT (7-)SH /Courier SF 32820 XM (`)SH /Times-Roman SF 35141 XM (:)SH 37190 XM (#)SH 39139 XM (@)SH /Courier SF 41460 XM (')SH /Times-Roman SF 43638 XM (=)SH 45876 XM (")SH 10023 43268 MT (8-)SH 15618 XM (a)SH 17750 XM (b)SH 19938 XM (c)SH 22070 XM (d)SH 24258 XM (e)SH 26473 XM (f)SH 28550 XM (g)SH 30710 XM (h)SH 32981 XM (i)SH 10023 44373 MT (9-)SH 15701 XM (j)SH 17750 XM (k)SH 20021 XM (l)SH 21931 XM (m)SH 24230 XM (n)SH 26390 XM (o)SH 28550 XM (p)SH 30710 XM (q)SH 32953 XM (r)SH 9912 45478 MT (A-)SH 15569 XM (~)SH 17805 XM (s)SH 20021 XM (t)SH 22070 XM (u)SH 24230 XM (v)SH 26279 XM (w)SH 28550 XM (x)SH 30710 XM (y)SH 32898 XM (z)SH 41593 XM ([)SH 9940 46583 MT (B-)SH 41593 XM (])SH 9940 47688 MT (C-)SH 13440 XM ({)SH 15479 XM (A)SH 17666 XM (B)SH 19826 XM (C)SH 21959 XM (D)SH 24174 XM (E)SH 26362 XM (F)SH 28439 XM (G)SH 30599 XM (H)SH 32953 XM (I)SH 9912 48793 MT (D-)SH 13440 XM (})SH 15645 XM (J)SH 17639 XM (K)SH 19854 XM (L)SH 21875 XM (M)SH 24119 XM (N)SH 26279 XM (O)SH 28522 XM (P)SH 30599 XM (Q)SH 32786 XM (R)SH 9968 49898 MT (E-)SH 13541 XM (\134)SH 17722 XM (S)SH 19854 XM (T)SH 21959 XM (U)SH 24119 XM (V)SH 26168 XM (W)SH 28439 XM (X)SH 30599 XM (Y)SH 32814 XM (Z)SH 9995 51003 MT (F-)SH 13430 XM (0)SH 15590 XM (1)SH 17750 XM (2)SH 19910 XM (3)SH 22070 XM (4)SH 24230 XM (5)SH 26390 XM (6)SH 28550 XM (7)SH 30710 XM (8)SH 32870 XM (9)SH /Times-Bold SF 21557 53937 MT (Table 1-3:)SH /Times-Roman SF 26418 XM (Character graphics for EBCDIC codes)SH 8280 55547 MT (This table) 100 W( shows the representations of the EBCDIC codes arranged in EBCDIC collating sequence, row by row.)99 W 8280 56652 MT (Codes that do not correspond to ISO 646 characters \0507-bit ASCII\051, have been left) 104 W( blank. One special case is the)105 W 8280 57757 MT (EBCDIC code 5F, which represents a Not Sign in IBM's CP037, but which is traditionally mapped to the ASCII)97 W 8280 58862 MT (Circumflex, as shown here. WARNING: this) 163 W( manual may have been printed on a device that maps characters)164 W 8280 59967 MT (differently. Consult) 250 W( the Appendix to verify.)SH 46800 50 8280 62596 UL ES %%Page: 6 7 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 6)SH 12 /Times-Bold AF 29885 XM (Kermit User's Guide: IBM 370 KERMIT 1.2)SH 46800 50 6120 5709 UL 14 SS 6120 8138 MT (1.2. File Attributes)SH 10 /Times-Roman AF 6120 10256 MT (Kermit-370 attempts to send and receive) 94 W( file attributes along with the files themselves. Before Kermit receives a)93 W 6120 11452 MT (file, it compares the Length attribute \050if available\051 with the amount of disk space available \050if known\051 so that the file)14 W 6120 12648 MT (can be rejected if it will not fit. In addition, the Type, Access, Encoding, Disposition, and Format attributes,) 32 W( if any,)31 W 6120 13844 MT (are interpreted in order to match the received file to the original as nearly as possible.) 11 W( All) 274 W( other attributes \050including)12 W 6120 15040 MT (Date\051 are simply ignored. For Type, Kermit recognizes text and binary) 136 W( specifications; for Access, it recognizes)135 W 6120 16236 MT (append, normal, and supersede; for Encoding, it) 194 W( recognizes ASCII, extended, and EBCDIC \050which it treats as)195 W 6120 17432 MT (binary\051; for Disposition, it recognizes) 98 W( mail, print, and job; and for Format, it recognizes text, D-binary, V-binary,)97 W 6120 18628 MT (binary, and LRECL. Any other values are rejected.)SH 6120 21020 MT (On sending a file, if the other Kermit is willing to accept Attribute packets, Kermit-370 sends the) 57 W( Type, Encoding,)58 W 6120 22216 MT (Format, Date, and Length attributes \050unless some or) 101 W( all of them have been disabled -- see the SET ATTRIBUTE)100 W 6120 23412 MT (subcommand\051.)SH 6120 25804 MT (Unfortunately, the set of file attributes defined in the Kermit protocol is not well matched to the needs of IBM 370)50 W 6120 27000 MT (file systems, so) 200 W( that much of the machinery for creating and interpreting of Attribute packets is useless. For)199 W 6120 28196 MT (example, the "Format" attribute, which should logically specify the record format of the received file, gives) 19 W( only the)20 W 6120 29392 MT (format of) 101 W( the file in transmission and cannot distinguish between fixed-length and varying-length records for text)100 W 6120 30588 MT (files. This) 450 W( limitation is partly due to the fact that other Kermits) 100 W( do not generally support the same attributes. In)101 W 6120 31784 MT (short, even if the protocol made it possible, some of the important attributes would never be specified anyway.)152 W 6120 32980 MT (Nonetheless, efforts are being made to extend the protocol to be more comprehensive.)SH 14 /Times-Bold AF 6120 36582 MT (1.3. Program Operation)SH 10 /Times-Roman AF 6120 38700 MT (Kermit-370 can be invoked directly or from a command) 307 W( procedure. In either case, it reads and executes)308 W 6120 39896 MT (subcommands sequentially until directed to quit, and then) 92 W( returns. A subcommand consists of one or more fields)91 W 6120 41092 MT (\050words\051 separated by spaces or commas.)SH 6120 43484 MT (Upon startup, the program looks for two \050optional\051 initialization files, one system-wide and a) 39 W( second specific to the)40 W 6120 44680 MT (user. Both)730 W /Times-Italic SF 11451 XM (filespecs)SH /Times-Roman SF 15385 XM (are, of course, system-dependent. The purpose of these files is to allow) 240 W( Kermit to be)239 W 6120 45876 MT (customized for a particular system and for a) 230 W( user's specific settings without changing the source code. The)231 W 6120 47072 MT (system-wide file, which) 23 W( is maintained by a systems programmer, should contain Kermit subcommands that all users)22 W 6120 48268 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 49464 MT (tables used by Kermit-370. The user-specific file, if any, should contain subcommands that the user generally issues)5 W 6120 50660 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 51856 MT (the terminal. Here is a sample INIT file:)SH /Courier SF 8520 53511 MT (* Asterisk in column one is a comment.)SH 8520 54542 MT (set transfer character-set latin1)SH 8520 55573 MT (set file collision rename)SH 8520 56604 MT (set block 3)SH /Times-Roman SF 6120 58996 MT (During interactive execution, you may use the built-in help feature while) 167 W( typing Kermit-370 subcommands. A)166 W 6120 60192 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 61388 MT (description of what is expected or possible at that point. Moreover, mistyping a subcommand will generally produce)SH 6120 62584 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 63780 MT (the minimum-length abbreviation in upper case and the remainder, if any, in lower case. In entering) 211 W( Kermit)210 W 6120 64976 MT (subcommands, any keyword may be shortened to any substring that contains the minimum abbreviation.)SH 6120 67368 MT (Besides knowing the mechanics of entering Kermit subcommands) 288 W( and interpreting responses, the user must)289 W 6120 68564 MT (understand which subcommands) 140 W( are necessary. The default values for Kermit-370 options have, in some cases,)139 W 6120 69760 MT (been constrained by a desire for continuity, so that some of the default) 141 W( behavior is distinctly "suboptimal." An)142 W 6120 70956 MT (example of) 251 W( this is the traditional 80-byte default RECEIVE packet size, which generally gives much slower)250 W ES %%Page: 7 8 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (1.3. Program Operation)SH 10 /Times-Italic AF 52275 XM (Page 7)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (transmission than a size of 1000 or more. Such options are flagged) 30 W( in this chapter with a notation that they perhaps)31 W 8280 9082 MT (ought to be set in the INIT files. Note, however,) 192 W( that the interplay of Kermit protocol sometimes provides a)191 W 8280 10278 MT (performance upgrade with no special action required from) 86 W( the Kermit-370 user. An example of this is the SEND)87 W 8280 11474 MT (packet-size, which is always under the control of the) 30 W( other Kermit. Kermit-370 always sends packets as long as the)29 W 8280 12670 MT (other Kermit allows, unless the frequency of transmission errors indicates that shorter packets would be more)202 W 8280 13866 MT (efficient \050see the subcommand SET SPEED\051.)SH 8280 16258 MT (Kermit-370 also attempts to produce) 30 W( optimal results by adapting to the file attributes sent by the other Kermit along)29 W 8280 17454 MT (with the files, such as TYPE and LRECL. Such attributes, when sent by the other Kermit, temporarily override the)38 W 8280 18650 MT (current settings in Kermit-370 during the reception of the associated file. Potentially) 215 W( even more importantly,)214 W 8280 19846 MT (Kermit-370 automatically recognizes the character set used for the file transfer and chooses, if) 267 W( necessary, a)268 W 8280 21042 MT (compatible character set for file storage. Table 1-1 shows the currently supported list of character) 13 W( sets. As with any)12 W 8280 22238 MT (automatic operation, Kermit's honoring of the) 15 W( transmitted attributes may need to be suppressed in part or altogether,)16 W 8280 23434 MT (and the SET ATTRIBUTE subcommand provides this capability.)SH 8280 25826 MT (Another attribute that Kermit-370 supports is file disposition, which allows files) 128 W( to be received and immediately)127 W 8280 27022 MT (retransmitted as) 176 W( electronic mail, sent to a printer, or submitted as a batch job. These three options are highly)177 W 8280 28218 MT (site-specific and are implemented as a set) 36 W( of three host commands with similar calling sequences. In each case, the)35 W 8280 29414 MT (command is invoked in two different ways in the process of processing the file.) 46 W( It) 343 W( is called without any)47 W /Times-Italic SF 50895 XM (filespec)SH /Times-Roman SF 54247 XM (or)SH 8280 30610 MT (other options as soon as the corresponding attribute is) 293 W( recognized by Kermit-370. If the command is not)292 W 8280 31806 MT (implemented or for some reason returns a non-zero completion code \050such a code should be negative, if at) 173 W( all)174 W 8280 33002 MT (possible\051, Kermit-370 rejects the) 1 W( file using the normal attribute exchange mechanism. Otherwise, the file is received)SH 8280 34198 MT (as usual, and the) 27 W( command is invoked again at the end-of-file. The second time, the command is given the name of)28 W 8280 35394 MT (the received file and the) 20 W( options received from the sending Kermit \050such as the list of recipients for electronic mail\051.)19 W 8280 36590 MT (The command is then responsible for disposing of the file \050and deleting it, if desired\051. If, for any reason, the) 90 W( file)91 W 8280 37786 MT (cannot be sent as required, the command should return a negative completion code \050or) 87 W( non-zero, at any rate\051, and)86 W 8280 38982 MT (Kermit-370 will send back an error message to the sending) 15 W( Kermit. The command itself should refrain from issuing)16 W 8280 40178 MT (any messages of its own or permitting commands that it invokes) 6 W( to issue messages. See the beginning of the chapter)5 W 8280 41374 MT (on the system-specific) 20 W( variant of Kermit-370 for the exact command syntax. Some sample implementations of such)21 W 8280 42570 MT (commands may be available in the) 64 W( Kermit distribution -- refer to the system-specific installation guide for a list of)63 W 8280 43766 MT (samples.)SH 14 /Times-Bold AF 8280 47368 MT (1.4. Kermit-370 Subcommands)SH 10 /Times-Roman AF 8280 49486 MT (The following is a summary of Kermit subcommands. The starred subcommands can be issued as) 80 W( remote Kermit)81 W 8280 50682 MT (commands to Kermit-370 when it is in server mode. System-specific subcommands are omitted from this list.)SH 15280 52292 MT (BYE)SH 18860 XM (logs out other Kermit server.)SH 14947 53397 MT (CWD)SH (*)SH 18860 XM (establishes a new working directory.)SH 11558 54502 MT (DIRECTORY)SH 18860 XM (displays all or part of the disk directory.)SH 14558 55607 MT (ECHO)SH 18860 XM (a line back to the user.)SH 15003 56712 MT (EXIT)SH 18860 XM (from Kermit-370.)SH 14058 57817 MT (FINISH)SH 18860 XM (other Kermit server.)SH 15336 58922 MT (GET)SH 18860 XM (file\050s\051 from a Kermit server.)SH 14892 60027 MT (GIVE)SH (*)SH 18860 XM (creates a TAKE file snapshot of a table.)SH 14780 61132 MT (HELP)SH 18860 XM (about Kermit-370.)SH 14669 62237 MT (HOST)SH (*)SH 18860 XM (executes a system command.)SH 13447 63342 MT (KERMIT)SH (*)SH 18860 XM (executes a Kermit subcommand.)SH 14892 64447 MT (QUIT)SH 18860 XM (from Kermit-370.)SH 13058 65552 MT (RECEIVE)SH 18860 XM (file\050s\051 from other Kermit.)SH 14669 66657 MT (SEND)SH 18860 XM (file\050s\051 to other Kermit.)SH 13446 67762 MT (SERVER)SH 18860 XM (mode of remote operation.)SH 15502 68867 MT (SET)SH (*)SH 18860 XM (various parameters.)SH 14336 69972 MT (SHOW)SH (*)SH 18860 XM (various parameters.)SH 14168 71077 MT (SPACE)SH (*)SH 18860 XM (displays disk storage allocation.)SH ES %%Page: 8 9 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 8)SH 12 /Times-Bold AF 29885 XM (Kermit User's Guide: IBM 370 KERMIT 1.4)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 11342 7886 MT (STATUS)SH (*)SH 16700 XM (inquiry.)SH 12675 8991 MT (STOP)SH 16700 XM (easy escape from protocol mode.)SH 12454 10096 MT (TAKE)SH (*)SH 16700 XM (subcommands from file.)SH 11620 11201 MT (TDUMP)SH (*)SH 16700 XM (dumps the contents of a table.)SH 12620 12306 MT (TYPE)SH (*)SH 16700 XM (a file.)SH 10787 13411 MT (VERSION)SH (*)SH 16700 XM (of Kermit-370.)SH 11676 14516 MT (XECHO)SH 16700 XM (echoes a line \050transparently\051.)SH 11898 15621 MT (XTYPE)SH 16700 XM (displays a file \050transparently\051.)SH 6120 18013 MT (Although Kermit-370 is generally a remote Kermit, it has the capability of communicating with another) 73 W( Kermit in)72 W 6120 19209 MT (server mode. In that situation, the subcommand prefixes REMOTE and) 137 W( LOCAL refer to the Kermit server and)138 W 6120 20405 MT (Kermit-370, respectively, even when Kermit-370 is, strictly) 34 W( speaking, the remote Kermit. To help avoid confusion,)33 W 6120 21601 MT (this chapter will often use the term "foreign" to apply to the Kermit at) 8 W( the other end from Kermit-370. All the above)9 W 6120 22797 MT (subcommands may be preceded by the LOCAL) 117 W( prefix, but only certain ones are valid with REMOTE, including)116 W 6120 23993 MT (some not shown here. See the) 78 W( description of the SERVER subcommand for details. Any text replies Kermit-370)79 W 6120 25189 MT (gets from the foreign Kermit server are added) 12 W( to a disk file \050whose)11 W /Times-Italic SF 33180 XM (filespec)SH /Times-Roman SF 36496 XM (is, of course, system-dependent\051. Such a)11 W 6120 26385 MT (transaction can be carried out, for example, under control of a TAKE) 47 W( file if Kermit-370 is not operating locally. If)48 W 6120 27581 MT (the local Kermit has a "magic" character sequence) 45 W( that switches it from terminal emulation to server mode, then an)44 W 6120 28777 MT (entire session could be controlled from the mainframe, possibly in response to) 49 W( a single command issued by a naive)50 W 6120 29973 MT (user. For) 250 W( example,)SH /Courier SF 8520 31628 MT (.grab)SH 2400 50 9120 31828 UL /Courier-Oblique SF 11520 33283 MT (Kermit-370 is invoked and executes the following TAKE file)SH /Courier SF 8520 34938 MT (ECHO Serve Me!)SH /Courier-Oblique SF 21720 XM (the local Kermit switches to server mode)SH /Courier SF 8520 35969 MT (GET file.a)SH /Courier-Oblique SF 21720 XM (the server uploads file.a)SH /Courier SF 8520 37000 MT (FINISH)SH /Courier-Oblique SF 21720 XM (the server switches back to terminal mode)SH /Times-Roman SF 6120 39392 MT (The remainder of this section describes subcommands) 25 W( with special meaning or use in Kermit-370, except the highly)24 W 6120 40588 MT (system-dependent ones. For the latter,) 128 W( refer to the appropriate chapter. Subcommands are listed in alphabetical)129 W 6120 41784 MT (order.)SH 13 /Times-Bold AF 18359 45143 MT (The ECHO and XECHO Subcommands)SH 10 /Times-Roman AF 6120 47516 MT (Syntax:)SH /Courier SF 9776 XM ([X]ECHO)SH /Times-Italic SF 14576 XM (line)SH /Times-Roman SF 6120 49908 MT (These subcommands type the)118 W /Times-Italic SF 18645 XM (line)SH /Times-Roman SF 20512 XM (back at the user. The)117 W /Times-Italic SF 30017 XM (line)SH /Times-Roman SF 31884 XM (may contain control characters or any desired text,)117 W 6120 51104 MT (including upper or lower case. These subcommands) 24 W( may be used, for example, to test the ASCII/EBCDIC translate)25 W 6120 52300 MT (tables or to issue coded) 23 W( commands to the user's terminal. XECHO differs from ECHO primarily in that it sends the)22 W 6120 53496 MT (text as a raw transmission according to the current CONTROLLER setting. Thus, XECHO) 26 W( will, if necessary, break)27 W 6120 54692 MT (the text into pieces no larger than the current SEND PACKET-SIZE) 398 W( and will use transparent mode if)397 W 6120 55888 MT (CONTROLLER is SERIES1, GRAPHICS or AEA. It also offers its own brand of control-character quoting,) 45 W( using)46 W 6120 57084 MT (the ``)112 W /Courier SF (^)SH /Times-Roman SF ('' character to indicate that only the five low-order bits of the ASCII) 112 W( codes are to be used. Thus, ``)111 W /Courier SF (^a)SH /Times-Roman SF ('',)SH 6120 58280 MT (``)SH /Courier SF (^A)SH /Times-Roman SF ('', and ``)85 W /Courier SF (^!)SH /Times-Roman SF ('' are all) 85 W( translated to SOH \050CTRL-A\051, while ``)86 W /Courier SF (^[)SH /Times-Roman SF ('' becomes ESC. However, there must be one)86 W 6120 59476 MT (exception for ``)150 W /Courier SF (^)SH /Times-Roman SF ('' itself: ``)150 W /Courier SF (^>)SH /Times-Roman SF ('' and ``)150 W /Courier SF (^~)SH /Times-Roman SF ('' are both translated to RS \050CTRL-)150 W /Courier SF (^)SH /Times-Roman SF (\051, but ``)150 W /Courier SF (^^)SH /Times-Roman SF ('' becomes just) 150 W( ``)149 W /Courier SF (^)SH /Times-Roman SF (''.)SH 6120 60672 MT (XECHO also decodes 8th-bit) 50 W( quoting, just as in Kermit protocol, and this feature can be disabled by setting 8th-bit)51 W 6120 61868 MT (quoting off. For example, if the 8th-bit quote character is ``)150 W /Courier SF (&)SH /Times-Roman SF ('', entering the) 150 W( subcommand ``)149 W /Courier SF (XECHO &A)149 W /Times-Roman SF ('' will)149 W 6120 63064 MT (transmit a code x'C1', but the same subcommand with quoting off will transmit two bytes: x'2641'.)SH ES %%Page: 9 10 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (1.4. Kermit-370 Subcommands)SH 10 /Times-Italic AF 52275 XM (Page 9)SH 46800 50 8280 5709 UL 13 /Times-Bold AF 25070 8071 MT (The GET Subcommand)SH 10 /Times-Roman AF 8280 10444 MT (Syntax:)SH /Courier SF 11936 XM (GET [)SH /Times-Italic SF (foreign-filespec)SH /Courier SF 21813 XM ([)SH /Times-Italic SF (filespec)SH /Courier SF (]])SH /Times-Roman SF 8280 12836 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 8280 14032 MT (running in server mode. Provided the other Kermit complies,) 24 W( the effect is the same as if SEND)23 W /Times-Italic SF 47086 XM (foreign-filespec)SH /Times-Roman SF 53636 XM (had)SH 8280 15228 MT (been issued directly to the other Kermit) 148 W( and RECEIVE [)149 W /Times-Italic SF (filespec)SH /Times-Roman SF (] to Kermit-370. If this subcommand is issued)149 W 8280 16424 MT (without any arguments, Kermit-370) 120 W( will prompt the user for both foreign and native)119 W /Times-Italic SF 43715 XM (filespecs)SH /Times-Roman SF 47528 XM (\050and will insist on)119 W 8280 17620 MT (getting the former, but will do without the latter\051. See the respective SEND and RECEIVE subcommands for a)125 W 8280 18816 MT (description of the each)SH /Times-Italic SF 17611 XM (filespec)SH /Times-Roman SF (.)SH 13 /Times-Bold AF 24781 22175 MT (The GIVE Subcommand)SH 10 /Times-Roman AF 8280 24548 MT (Syntax:)SH /Courier SF 11936 XM (GIVE)SH /Times-Italic SF 14936 XM (table-name filespec)350 W /Times-Roman SF 8280 26940 MT (This compares the named translation or selection table with its current default values and saves the) 5 W( differences in the)4 W 8280 28136 MT (form of a TAKE) 63 W( file consisting of SET subcommands that would convert the default into the current arrangement.)64 W 8280 29332 MT (ATOE, ETOA, TATOE, and) 118 W( TETOA are the available translation tables, and CONTROL-CHAR is the selection)117 W 8280 30528 MT (table. The) 491 W( details of the)121 W /Times-Italic SF 18920 XM (filespec)SH /Times-Roman SF 22346 XM (are system-dependent, but those details will, in general, be the same as for the)121 W 8280 31724 MT (TAKE subcommand \050)8 W /Times-Italic SF (q.v.)SH /Times-Roman SF (\051. In) 266 W( the case of tables ATOE and ETOA, the current defaults are the values from the most)7 W 8280 32920 MT (recent character-set definition, if any, but the defaults for TATOE and TETOA always remain at the initial values.)64 W 8280 34116 MT (See the SET FILE CHARACTER-SET and SET TRANSFER CHARACTER-SET subcommands for more details.)SH 13 /Times-Bold AF 24419 37475 MT (The HINTS Subcommand)SH 10 /Times-Roman AF 8280 39848 MT (Syntax:)SH /Courier SF 11936 XM (HINTS)SH /Times-Roman SF 8280 42240 MT (This subcommand produces a screenful of suggestions for Kermit) 72 W( operation, including warnings about any current)71 W 8280 43436 MT (settings that may be undesirable.)SH 13 /Times-Bold AF 24636 46795 MT (The HOST Subcommand)SH 10 /Times-Roman AF 8280 49168 MT (Syntax:)SH /Courier SF 11936 XM (HOST)SH /Times-Italic SF 14936 XM (text of command)SH /Times-Roman SF 8280 51560 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 52756 MT (completion code, the code will be displayed. Generally, the name of) 13 W( the system \050)12 W /Times-Italic SF (e.g.)SH /Times-Roman SF (, CMS\051 is treated as a synonym)12 W 8280 53952 MT (for the HOST subcommand.)SH 8280 56344 MT (When Kermit-370) 190 W( is in \050non-local\051 server mode, you must avoid sending it any HOST commands that trigger)191 W 8280 57540 MT (full-screen terminal) 42 W( I/O, since the server-client interface does not provide any full-screen terminal emulation, nor is)41 W 8280 58736 MT (Kermit-370 usually able to intercept such I/O in any case.)SH ES %%Page: 10 11 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 10)SH 12 /Times-Bold AF 29885 XM (Kermit User's Guide: IBM 370 KERMIT 1.4)SH 46800 50 6120 5709 UL 13 SS 21574 8071 MT (The KERMIT Subcommand)SH 10 /Times-Roman AF 6120 10444 MT (Syntax:)SH /Courier SF 9776 XM (KERMIT)SH /Times-Italic SF 13976 XM (text of subcommand)SH /Times-Roman SF 6120 12836 MT (This is provided for redundancy as the counterpart of the HOST subcommand. Kermit-370 executes) 73 W( the specified)74 W 6120 14032 MT (text as) 40 W( a Kermit subcommand just as if the LOCAL prefix had been entered. Note, however, that the specified text)39 W 6120 15228 MT (must not begin with a second KERMIT prefix.)SH 13 /Times-Bold AF 21320 18587 MT (The RECEIVE Subcommand)SH 10 /Times-Roman AF 6120 20960 MT (Syntax:)SH /Courier SF 9776 XM (RECEIVE [)SH /Times-Italic SF (filespec)SH /Courier SF (])SH /Times-Roman SF 6120 23352 MT (The RECEIVE subcommand tells Kermit-370 to accept a file or file) 49 W( group. The user must issue the corresponding)50 W 6120 24548 MT (SEND subcommand to the other Kermit. When files are received, their) 65 W( names are recorded in a transaction log in)64 W 6120 25744 MT (memory and may) 67 W( be viewed later via the TDUMP NAMES subcommand. The log contains the names along with)68 W 6120 26940 MT (the file sizes and any relevant error messages. Another form of log may be provided through an accounting exit)104 W 6120 28136 MT (routine, which is called) 84 W( at the end of every RECEIVE session. Such an accounting log may contain elapsed time)85 W 6120 29332 MT (and numbers of bytes sent, received, and transferred to/from disk.) 5 W( If) 259 W( an error occurs during the file transfer, as much)4 W 6120 30528 MT (of the file as was received is saved on disk. If, however, the sending of a file is cancelled by the user of the foreign)28 W 6120 31724 MT (system, Kermit-370 will discard whatever had arrived, unless FILE) 50 W( COLLISION is APPEND or INCOMPLETE is)49 W 6120 32920 MT (KEEP.)SH 6120 35312 MT (Kermit-370 has a context-dependent maximum record) 10 W( length, and received records longer than that will be folded or)11 W 6120 36508 MT (truncated to the proper length; when this happens, Kermit) 324 W( may or may not stop, depending on the FILE)323 W 6120 37704 MT (subparameter LONGLINE. If truncation does occur, Kermit will) 88 W( later note the fact as an error \050unless something)89 W 6120 38900 MT (more serious happens in the meantime\051. In addition, when a) 81 W( fixed record length is specified, received records are)80 W 6120 40096 MT (padded to the correct length.) 84 W( The) 420 W( padding character is a blank for text files and a null for binary files. Received)85 W 6120 41292 MT (binary \050but not V-binary or D-binary\051 files are treated as byte streams and broken up into records all of the) 60 W( logical)59 W 6120 42488 MT (record length,)20 W /Times-Italic SF 11964 XM (i.e.)SH /Times-Roman SF (, folded. For more details on the RECEIVE subcommand syntax and operation, see) 20 W( the chapter on)21 W 6120 43684 MT (the desired system-specific variant of Kermit-370 under) 71 W( both RECEIVE and SET FILE. See also \050in this chapter\051)70 W 6120 44880 MT (the SET FILE LONGLINE subcommand for details on record truncation and folding.)SH 13 /Times-Bold AF 22548 48239 MT (The SEND Subcommand)SH 10 /Times-Roman AF 6120 50612 MT (Syntax:)SH /Courier SF 9776 XM (SEND [)SH /Times-Italic SF (filespec)SH /Courier SF ([<)SH /Times-Italic SF (options)SH /Courier SF (>] [)SH /Times-Italic SF (foreign-filespec)SH /Courier SF (]][, ...])SH /Times-Roman SF 6120 53004 MT (The SEND subcommand tells Kermit-370 to send a file or file group to the other \050foreign\051 Kermit.) 62 W( If) 376 W( no such file)63 W 6120 54200 MT (exists, Kermit-370 simply displays an error message and issues another prompt.) 108 W( Like) 464 W( RECEIVE, SEND keeps a)107 W 6120 55396 MT (transaction log of all files transferred in a group and calls the accounting exit routine at the) 1 W( end of the session. If this)2 W 6120 56592 MT (subcommand is issued without any arguments, Kermit-370 will prompt the user for both native) 14 W( and foreign)13 W /Times-Italic SF 49476 XM (filespec)SH /Times-Roman SF (s)SH 6120 57788 MT (\050and will insist on getting the former, but will do without) 144 W( the latter\051. Either with or without prompting, SEND)145 W 6120 58984 MT (allows specifying a list of up to 13 files \050or file groups\051 separated by commas. \050By ending the) 102 W( command line or)101 W 6120 60180 MT (subsequent response with a comma, the user ensures further prompting.\051 In) 132 W( this syntax, the)133 W /Times-Italic SF 44932 XM (options)SH /Times-Roman SF 48260 XM (enclosed in)133 W 6120 61376 MT (angle brackets may be regarded as part) 34 W( of the native)33 W /Times-Italic SF 27505 XM (filespec)SH /Times-Roman SF (. There) 316 W( must be no intervening blanks. At present, the)33 W 6120 62572 MT (only supported option is a range of line numbers within the file to be sent. The range takes the) 127 W( form [)128 W /Times-Italic SF (n)SH /Times-Roman SF (][-[)SH /Times-Italic SF (m)SH /Times-Roman SF (]],)SH 6120 63768 MT (where)SH /Times-Italic SF 8854 XM (n)SH /Times-Roman SF 9645 XM (is the number of the first line to send \050counting from 1\051, and)41 W /Times-Italic SF 34453 XM (m)SH /Times-Roman SF 35466 XM (is the last. Omitting either number implies)41 W 6120 64964 MT (the corresponding limit is the physical) 56 W( beginning or end of the file. This same option syntax may be used in some)57 W 6120 66160 MT (commands issued to the foreign Kermit, namely, those involving)141 W /Times-Italic SF 33581 XM (filespec)SH /Times-Roman SF (s in 370 form. In particular, GET and)140 W 6120 67356 MT (REMOTE TYPE can use this syntax. Note that a trailing ``)39 W /Courier SF (>)SH /Times-Roman SF ('' is) 39 W( used by some other Kermits, such as MS-Kermit,)40 W 6120 68552 MT (to indicate redirection of) 152 W( the output from REMOTE commands to disk. In order to transmit the ``)151 W /Courier SF (>)SH /Times-Roman SF ('' and also)151 W 6120 69748 MT (prevent the redirection to disk, it would be necessary to add an explicit redirection to the terminal, as in)SH /Courier SF 8520 71403 MT (REM TYPE)SH /Courier-Oblique SF 13920 XM (filespec)SH /Courier SF (<)SH /Courier-Oblique SF (n)SH /Courier SF (-)SH /Courier-Oblique SF (m)SH /Courier SF (> > CON)SH ES %%Page: 11 12 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (1.4. Kermit-370 Subcommands)SH 10 /Times-Italic AF 51775 XM (Page 11)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (Although file transfers cannot be cancelled from the 370 side, Kermit-370 is capable of responding) 55 W( to "cancel file")56 W 8280 9082 MT (or "cancel batch" signals from the local Kermit; these are typically entered) 248 W( by typing CTRL-X or CTRL-Z,)247 W 8280 10278 MT (respectively.)SH 8280 12670 MT (When Kermit-370 sends files) 40 W( using long packets \050longer than 94\051, the throughput is especially sensitive to the level)41 W 8280 13866 MT (of noise on the line because retries are so time-consuming. Therefore, Kermit-370) 61 W( imposes an extra, heuristic size)60 W 8280 15062 MT (limit on packets when retries have been found necessary.) 124 W( When) 500 W( that is the case, after every 15 packets, Kermit)125 W 8280 16258 MT (computes the packet size for maximum throughput assuming that the transmission errors were) 228 W( due to sparse,)227 W 8280 17454 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 18650 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 19846 MT (be noiseless and sends packets of the maximum length the other Kermit allows. The algorithm) 151 W( is explained in)152 W /Times-Italic SF 8280 21042 MT (Kermit News)109 W /Times-Roman SF 13943 XM (V. 3 #1. For) 109 W( more details on the SEND subcommand syntax and operation, see the chapter on the)108 W 8280 22238 MT (desired system-specific variant of Kermit-370.)SH 13 /Times-Bold AF 23805 25597 MT (The SERVER Subcommand)SH 10 /Times-Roman AF 8280 27970 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 8280 29166 MT (commands, execute a restricted set of Kermit subcommands,) 136 W( and perform a variety of generic Kermit functions.)135 W 8280 30362 MT (The following list) 151 W( shows the typical local Kermit commands along with the server functions they elicit. When)152 W 8280 31558 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 8280 32754 MT (direction.)SH 8280 34364 MT (BYE)SH 22680 XM (log out the Kermit server.)SH 8280 35469 MT (FINISH)SH 22680 XM (server mode.)SH 8280 36574 MT (GET)SH 22680 XM (a file or files from the server.)SH 8280 37679 MT (REMOTE)SH 8780 38784 MT (COPY)SH 22680 XM (a file or files.)SH 8780 39889 MT (CWD)SH 22680 XM (set new working directory.)SH 8780 40994 MT (DELETE)SH 22680 XM (a file or files.)SH 8780 42099 MT (DIRECTORY)SH 22680 XM (display file attributes.)SH 8780 43204 MT (HELP)SH 22680 XM (display a command summary, such as this.)SH 8780 44309 MT (HOST)SH 22680 XM (execute a system command.)SH 8780 45414 MT (KERMIT)SH 22680 XM (execute a Kermit-370 subcommand.)SH 8780 46519 MT (PRINT)SH 22680 XM (send a file to be printed by the server.)SH 8780 47624 MT (RENAME)SH 22680 XM (a file or files.)SH 8780 48729 MT (SPACE)SH 22680 XM (display disk space.)SH 8780 49834 MT (TYPE)SH 22680 XM (a file.)SH 8280 50939 MT (SEND)SH 22680 XM (a file or files to the server.)SH 8280 53331 MT (If your local Kermit does not support the REMOTE KERMIT command,) 24 W( you may need to issue SET subcommands)25 W 8280 54527 MT (to select various options) 40 W( before typing the SERVER subcommand. Once in server mode, Kermit-370 will await all)39 W 8280 55723 MT (further instructions from the client Kermit on the other end of the connection until a FINISH or) 70 W( BYE command is)71 W 8280 56919 MT (given.)SH 8280 59311 MT (Command execution in server mode is different in some respects from normal operation. First of all, some) 51 W( Kermit)50 W 8280 60507 MT (subcommands are not allowed) 130 W( \050see the list at the beginning of this section\051. Moreover, command errors always)131 W 8280 61703 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 62899 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 64095 MT (order to transmit the data to the local Kermit as text packets.)SH 8280 66487 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 67683 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 68879 MT (issuing any of) 165 W( the commands: REMOTE TYPE, REMOTE HOST PRT, REMOTE KERMIT TYPE, REMOTE)164 W 8280 70075 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 71271 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 ES %%Page: 12 13 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 12)SH 12 /Times-Bold AF 29885 XM (Kermit User's Guide: IBM 370 KERMIT 1.4)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (terminal output, and return the results to the local Kermit. The first form is also distinguished by the fact that the)74 W 6120 9082 MT (line range may be specified in the same manner as in) 220 W( the SEND subcommand. The syntax of the others is)219 W 6120 10278 MT (system-dependent.)SH 13 /Times-Bold AF 23054 13637 MT (The SET Subcommand)SH 10 /Times-Roman AF 6120 16010 MT (Syntax:)SH /Courier SF 9776 XM (SET)SH /Times-Italic SF 12176 XM (parameter)SH /Courier SF 16942 XM ([)SH /Times-Italic SF (value)SH /Courier SF (])SH /Times-Roman SF 6120 18402 MT (The SET) 20 W( subcommand establishes or modifies various parameters controlling file transfers. The values can, in turn,)21 W 6120 19598 MT (be examined with the SHOW subcommand. Some parameters have two) 231 W( levels. In particular, there are two)230 W 6120 20794 MT (matching lists of) 114 W( SEND and RECEIVE sub-parameters corresponding to the values exchanged by Kermits in the)115 W 6120 21990 MT (Send-Init/ACK sequence. For each) 62 W( of these SEND/RECEIVE pairs one element is encoded in outgoing parameter)61 W 6120 23186 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 6120 24382 MT (and also has the effect of redefining the default value for decoding from) 53 W( subsequent parameter packets. Generally,)52 W 6120 25578 MT (the distinction between SEND) 168 W( and RECEIVE parameters is unambiguous, the only exception being TIMEOUT)169 W 6120 26774 MT (\050)SH /Times-Italic SF (q.v.)SH /Times-Roman SF (\051. The) 250 W( following SET subcommands are available in Kermit-370:)SH 6120 28384 MT (ATOE)SH 20520 XM (Modify the Kermit-370 ASCII-to-EBCDIC table.)SH 6120 29489 MT (ATTRIBUTE)SH 20520 XM (Determine A-packet generation.)SH 6120 30594 MT (BLOCK-CHECK)SH 20520 XM (Level of error checking for file transfer.)SH 6120 31699 MT (CONTROLLER)SH 20520 XM (Indicate type of terminal connection.)SH 6120 32804 MT (CONTROL-CHAR)SH 20520 XM (Set prefixing state.)SH 6120 33909 MT (DEBUG)SH 20520 XM (Log packet traffic during file transfer.)SH 6120 35014 MT (DELAY)SH 20520 XM (Length of pause before a SEND subcommand.)SH 6120 36119 MT (EOF)SH 20520 XM (Text file truncation at CTRL-Z.)SH 6120 37224 MT (ETOA)SH 20520 XM (Modify the Kermit-370 EBCDIC-to-ASCII table.)SH 6120 38329 MT (FILE)SH 20520 XM (Attributes for incoming or outgoing files...)SH 6620 39434 MT (CHARACTER-SET)SH 20520 XM (... for 370 storage.)SH 6620 40539 MT (COLLISION)SH 20520 XM (... treatment for duplicate names.)SH 6620 41644 MT (LONGLINE)SH 20520 XM (... treatment of too-long records.)SH 6620 42749 MT (OVERWRITE)SH 20520 XM (... treatment of attributes.)SH 6620 43854 MT (TYPE)SH 20520 XM (... text or binary.)SH /Times-Italic SF 6620 44959 MT (other)SH /Times-Roman SF 20520 XM (... system-specific attributes.)SH 6120 46064 MT (FOREIGN)SH 20520 XM (Strings added to outgoing filespec...)SH 6620 47169 MT (PREFIX)SH 6620 48274 MT (SUFFIX)SH 6120 49379 MT (INCOMPLETE)SH 20520 XM (Determine the action on an aborted file transfer.)SH 6120 50484 MT (LINE)SH 20520 XM (Specify alternate communication line.)SH 6120 51589 MT (MARGIN)SH 20520 XM (for sending files...)SH 6620 52694 MT (LEFT)SH 6620 53799 MT (RIGHT)SH 6120 54904 MT (PROMPT)SH 20520 XM (For Kermit-370 subcommands.)SH 6120 56009 MT (RETRY)SH 20520 XM (Maximum retry count...)SH 6620 57114 MT (INIT)SH 20520 XM (... for initial packet exchange.)SH 6620 58219 MT (PACKET)SH 20520 XM (... per packet for ongoing transfer.)SH 6120 59324 MT (SERVER-TIMEOUT)SH 20520 XM (Spacing between server NAK's.)SH 6120 60429 MT (SPEED)SH 20520 XM (Line speed for packet-size calculations.)SH 6120 61534 MT (SYSCMD)SH 20520 XM (Try apparently invalid Kermit subcommands on host system.)SH 6120 62639 MT (TABS-EXPAND)SH 20520 XM (Determine tab-to-space conversion on reception.)SH 6120 63744 MT (TAKE)SH 6620 64849 MT (ECHO)SH 20520 XM (Echo subcommands read from TAKE files.)SH 6620 65954 MT (ERROR-ACTION)SH 20520 XM (Exit from TAKE file on command error.)SH 6120 67059 MT (TEST)SH 20520 XM (Facilitate testing of Kermit.)SH 6120 68164 MT (TATOE)SH 20520 XM (Modify the Kermit-370 ASCII-to-EBCDIC table.)SH 6120 69269 MT (TETOA)SH 20520 XM (Modify the Kermit-370 EBCDIC-to-ASCII table.)SH 6120 70374 MT (TRANSFER)SH 20520 XM (Options for transmission...)SH 6620 71479 MT (CHARACTER-SET)SH 20520 XM (... of text files.)SH ES %%Page: 13 14 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (1.4. Kermit-370 Subcommands)SH 10 /Times-Italic AF 51775 XM (Page 13)SH 46800 50 8280 5709 UL /Times-Roman SF 8780 7886 MT (LOCKING-SHIFT)SH 22680 XM (... protocol extension.)SH 8280 8991 MT (TTABLE)SH 22680 XM (Determine which tables undo the terminal translation.)SH 8280 10096 MT (8-BIT-QUOTE)SH 22680 XM (Determine state of 8th-bit prefixing.)SH 8280 11201 MT (SEND or RECEIVE)SH 8780 12306 MT (END-OF-LINE)SH 22680 XM (Packet terminator.)SH 8780 13411 MT (PACKET-SIZE)SH 22680 XM (Maximum packet size.)SH 8780 14516 MT (PAD-CHAR)SH 22680 XM (Character to insert before each packet.)SH 8780 15621 MT (PADDING)SH 22680 XM (Number of pad characters to insert.)SH 8780 16726 MT (PARITY)SH 22680 XM (Indicate if 7-bit or 8-bit data.)SH 8780 17831 MT (QUOTE)SH 22680 XM (Use to quote control characters in packets.)SH 8780 18936 MT (START-OF-PACKET)SH 22680 XM (Packet beginning marker.)SH 8780 20041 MT (TIMEOUT)SH 22680 XM (Time limit for response.)SH 12 /Times-Bold AF 8280 22629 MT (SET ATOE etc.)SH 10 /Times-Roman AF 8280 24043 MT (Syntax:)SH /Courier SF 11936 XM (SET)SH /Times-Italic SF 14336 XM (table)SH /Courier SF 16936 XM ([)SH /Times-Italic SF (num1 num2)350 W /Courier SF (])SH /Times-Roman SF 8280 26435 MT (This modifies one of the ASCII/EBCDIC translation tables used by Kermit-370 \050for) 94 W( example, to conform to your)93 W 8280 27631 MT (system\051. The) 494 W( valid) 122 W( table names are ATOE, ETOA, TATOE, and TETOA. The arguments are, respectively, the)123 W 8280 28827 MT (offset within the named) 25 W( table and the new value for that offset. If the arguments are omitted, the table is restored to)24 W 8280 30023 MT (its initial arrangement. Both)94 W /Times-Italic SF 20472 XM (num1)SH /Times-Roman SF 23038 XM (and)SH /Times-Italic SF 24826 XM (num2)SH /Times-Roman SF 27392 XM (should be in the) 94 W( range 0-255 \050decimal\051. For example, in ATOE or)95 W 8280 31219 MT (TATOE, the offset is the ASCII character code, and the) 16 W( new value is the new EBCDIC result code. Initially, ATOE)15 W 8280 32415 MT (and TATOE each contain two identical copies of the 7-bit ASCII character table. Helpful hint: if you have files) 14 W( that)15 W 8280 33611 MT (make use of extended \0508-bit\051 ASCII) 186 W( codes and wish to upload them via Kermit-370, be sure to define unique)185 W 8280 34807 MT (EBCDIC equivalents of all the needed 8-bit ASCII codes or else treat such files as binary data.) 62 W( Any) 376 W( time you use)63 W 8280 36003 MT (the SET ATOE or SET ETOA subcommands, that) 77 W( has a side effect equivalent to SET ATTRIBUTE ENCODING)76 W 8280 37199 MT (OFF \050)54 W /Times-Italic SF (q.v.)SH /Times-Roman SF (\051. If) 358 W( the extended ASCII character set is one of those) 54 W( supported for file transfer in Kermit-370, you need)55 W 8280 38395 MT (only issue a SET TRANSFER CHARACTER-SET \050)SH /Times-Italic SF (q.v.)SH /Times-Roman SF (\051.)SH 8280 40787 MT (Note: the meaning of) 90 W( the tables depends on the TTABLE setting -- if TTABLE is OFF, the TATOE and TETOA)89 W 8280 41983 MT (tables are not used.)SH 12 /Times-Bold AF 8280 44571 MT (SET ATTRIBUTE)SH 10 /Times-Roman AF 8280 45985 MT (Syntax:)SH /Courier SF 11936 XM (SET ATTRIBUTE [)SH /Times-Italic SF (attribute)SH /Courier SF (] ON)SH /Times-Italic SF 27381 XM (or)SH /Courier SF 28870 XM (OFF)SH /Times-Roman SF 8280 48377 MT (The individual)505 W /Times-Italic SF 15401 XM (attribute)SH /Times-Roman SF (s are LENGTH, TYPE, DATE, CREATOR, ACCOUNT,) 505 W( AREA, PASSWORD,)506 W 8280 49573 MT (BLOCKSIZE, ACCESS, ENCODING, DISPOSITION, PROTECT, ORIGIN, FORMAT, SYS-INFO,) 510 W( and)509 W 8280 50769 MT (BYTE-LENGTH. Kermit-370) 400 W( distinguishes between the two forms of this subcommand by counting "words".) 75 W( In)402 W 8280 51965 MT (order to see the list of supported attributes, you) 3 W( must enter ``)2 W /Courier SF (SET ATTR ? ?)2 W /Times-Roman SF (''; if you enter just ``)2 W /Courier SF (SET ATTR ?)2 W /Times-Roman SF ('',)SH 8280 53161 MT (Kermit will list just the alternatives ON and OFF.)SH 8280 54952 MT (ON)SH 12280 XM (The specified attribute is to be processed, or attribute packets are) 12 W( generated for all outgoing files, provided)13 W 12280 56057 MT (the other Kermit indicates the ability to accept them. \050Default\051.)SH 8280 57715 MT (OFF)SH 12280 XM (The specified attribute is to be ignored and not generated, or attribute packets are never generated.)SH 12 /Times-Bold AF 8280 60303 MT (SET BLOCK-CHECK)SH 10 /Times-Roman AF 8280 61717 MT (Syntax:)SH /Courier SF 11936 XM (SET BLOCK-CHECK)SH /Times-Italic SF 21536 XM (type)SH /Times-Roman SF 8280 64109 MT (This determines the type of block check) 61 W( used during file transfer, provided the other Kermit agrees. Valid options)60 W 8280 65305 MT (for)SH /Times-Italic SF 10000 XM (type)SH /Times-Roman SF 12220 XM (are: 1-byte) 858 W( \050for a one-character) 304 W( checksum\051, 2-byte \050for a two-character checksum\051, 3-byte \050for a)305 W 8280 66501 MT (three-character CRC\051, and Blank-free-2 \050for a shifted two-character checksum that avoids using blanks. This) 30 W( is one)29 W 8280 67697 MT (of only two Send-Init parameters that cannot be SET separately for SEND and RECEIVE.)SH ES %%Page: 14 15 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 14)SH 12 /Times-Bold AF 29885 XM (Kermit User's Guide: IBM 370 KERMIT 1.4)SH 46800 50 6120 5709 UL 6120 8004 MT (SET CONTROLLER)SH 10 /Times-Roman AF 6120 9418 MT (Syntax:)SH /Courier SF 9776 XM (SET CONTROLLER)SH /Times-Italic SF 18776 XM (type)SH /Times-Roman SF 6120 11810 MT (The)SH /Times-Italic SF 8204 XM (type)SH /Times-Roman SF 10399 XM (may be) 279 W( TTY, SERIES1, GRAPHICS, AEA, FULLSCREEN, VTAMTTY, or NONE. Kermit-370)280 W 6120 13006 MT (automatically determines whether you are) 60 W( connected via a Series/1 \050or similar\051 emulation controller or a TTY line.)59 W 6120 14202 MT (In some circumstances, such as) 81 W( when the connection is through a non-graphics-capable 3174 port, Kermit will set)82 W 6120 15398 MT (CONTROLLER to NONE, which has the effect of disabling file transfers. This) 61 W( subcommand is provided, though,)60 W 6120 16594 MT (to allow) 223 W( the automatic choice to be superseded, and because Kermit may not be able to distinguish between)224 W 6120 17790 MT (Series/1-type and other 3270-emulation) 352 W( controllers. In particular, there is no way to distinguish between)351 W 6120 18986 MT (FULLSCREEN and GRAPHICS from) 94 W( within Kermit. When CONTROLLER is set to SERIES1, GRAPHICS, or)95 W 6120 20182 MT (AEA, Kermit disables the 3270 protocol conversion) 142 W( function by putting the terminal controller into "transparent)141 W 6120 21378 MT (mode", which allows Kermit packets to pass through intact. Note: an incorrect CONTROLLER setting) 15 W( may lock up)16 W 6120 22574 MT (or wipe out your session when you try to transfer files.)SH 6120 24966 MT (Kermit operation is possible through an IBM 3708 front) 100 W( end, but only in a rather specific configuration. See the)99 W 6120 26162 MT (installation guide for your variant of Kermit-370 for the details of that) 85 W( and other hardware-related restrictions and)86 W 6120 27358 MT (configurations.)SH 12 /Times-Bold AF 6120 29946 MT (SET CONTROL-CHAR)SH 10 /Times-Roman AF 6120 31360 MT (Syntax:)SH /Courier SF 9776 XM (SET CONTROL-CHAR)SH /Times-Italic SF 19976 XM (mode)SH /Courier SF 22742 XM ([)SH /Times-Italic SF (number)SH /Courier SF (])SH /Times-Roman SF 6120 33752 MT (The)SH /Times-Italic SF 7942 XM (mode)SH /Times-Roman SF 10375 XM (may be PREFIXED \050normal Kermit protocol for control characters\051) 17 W( or UNPREFIXED. In the latter case,)16 W 6120 34948 MT (the specified control character \050given as a decimal number in the range 0-31 or 128-159\051) 73 W( is transmitted "as is". If)74 W 6120 36144 MT (the)SH /Times-Italic SF 7605 XM (number)SH /Times-Roman SF 10923 XM (is omitted, then all control) 13 W( characters are set accordingly. Kermit-370 automatically overrides the user's)12 W 6120 37340 MT (settings for certain characters used for Kermit protocol: the) 13 W( start-of-packet, the end-of-packet, the handshake \050if set\051,)14 W 6120 38536 MT (and XOFF \050not really used, but too dangerous to send\051. Sending control characters) 76 W( without prefixes can speed up)75 W 6120 39732 MT (transfers of binary files.)SH 6120 42124 MT (The status of prefixing is initially "PREFIXED" for all control characters. It can) 155 W( be displayed by the TDUMP)156 W 6120 43320 MT (CONTROL subcommand, or saved in the form of a TAKE file by the GIVE CONTROL subcommand \050)SH /Times-Italic SF (q.v.)SH /Times-Roman SF (\051.)SH 12 /Times-Bold AF 6120 45908 MT (SET DEBUG)SH 10 /Times-Roman AF 6120 47322 MT (Syntax:)SH /Courier SF 9776 XM (SET DEBUG OFF)SH /Times-Italic SF 18176 XM (or)SH /Courier SF 19665 XM (ON [RAW] [I/O] [SAVE] [LONG] [TIME])SH /Times-Roman SF 6120 49714 MT (Note: any combination, in any order, of RAW, I/O, SAVE, and TIME may follow or replace ON. Each of the three)24 W 6120 50910 MT (implies ON.)SH 6120 52701 MT (ON)SH 10120 XM (Keep a journal of) 50 W( all packets sent and received in a log file on disk. If the file already exists, it is erased)51 W 10120 53806 MT (and overwritten. The)190 W /Times-Italic SF 19739 XM (filespec)SH /Times-Roman SF 23234 XM (of the log is, of course, system-dependent.) 190 W( All) 628 W( packets are logged in)189 W 10120 54911 MT (EBCDIC for legibility, even when CONTROLLER is set to SERIES1, GRAPHICS, or AEA.)SH 6120 56569 MT (RAW)SH 10120 XM (The same as ON, but packets are logged in) 80 W( the form that is passed to or from the operating system,)81 W /Times-Italic SF 51448 XM (i.e.)SH /Times-Roman SF (,)SH 10120 57674 MT (EBCDIC for TTY or VTAMTTY) 86 W( terminals, and ASCII for SERIES1, GRAPHICS, and AEA terminals.)85 W 10120 58779 MT (This option is generally not recommended; I/O is preferable.)SH 6120 60437 MT (I/O)SH 10120 XM (The same as ON, but the log includes) 15 W( additional transmission status information, such as the AID returned)16 W 10120 61542 MT (by a full-screen device. See below for a summary of the log formats.)SH 6120 63200 MT (SAVE)SH 10120 XM (The same as ON,) 71 W( but the log file is closed after each entry is added, so that, if the session is abnormally)70 W 10120 64305 MT (terminated, the log file will be complete and readable.)SH 6120 65963 MT (LONG)SH 10120 XM (The same as I/O, but the additional information is not truncated to 36 bytes.)SH 6120 67621 MT (TIME)SH 10120 XM (Used only) 63 W( with I/O or LONG. The lines of hexadecimal dump are tagged with the time of day from the)64 W 10120 68726 MT (CPU clock, truncated to the nearest second.)SH 6120 70384 MT (OFF)SH 10120 XM (Stop logging packets and close the the log file. \050Default.\051)SH ES %%Page: 15 16 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (1.4. Kermit-370 Subcommands)SH 10 /Times-Italic AF 51775 XM (Page 15)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (Often, problems with Kermit file transfers or server-mode operations can be) 12 W( diagnosed by setting DEBUG on in one)11 W 8280 9082 MT (or both Kermits, regardless of where the problems actually lie. For Kermit-370, the) 288 W( maximum amount of)289 W 8280 10278 MT (information can) 180 W( generally be obtained by setting DEBUG to I/O or LONG, but the format of the log depends)179 W 8280 11474 MT (somewhat on which variant of Kermit-370 is involved. Before examining the log, you should set DEBUG) 124 W( OFF)125 W 8280 12670 MT (either explicitly or by exiting from Kermit-370.)SH 8280 15062 MT (There is an optional feature for logging dumps of storage blocks at selected points in the execution.) 21 W( By) 291 W( default, this)20 W 8280 16258 MT (feature is disabled \050at assembly time\051 by having the) 23 W( variable symbol &KTRACE set to NO and also by virtue of the)24 W 8280 17454 MT (fact that no calls to the dump) 41 W( routine are present in the distribution code. Further, the dumps are suppressed unless)40 W 8280 18650 MT (both DEBUG and TEST \050)31 W /Times-Italic SF (q.v.)SH /Times-Roman SF (\051 are set on. To select when and what) 31 W( blocks to dump, it is necessary to insert calls to)32 W 8280 19846 MT (KHDMP at appropriate points in the source before assembling. Each such call) 116 W( generates a dump each time it is)115 W 8280 21042 MT (executed, provided that DEBUG and TEST are set, and the contents) 13 W( of all registers are preserved. The call specifies)14 W 8280 22238 MT (the starting address, the length, and a short title for the block. Only eight characters of the title will) 34 W( be used. Some)33 W 8280 23434 MT (examples:)SH /Courier SF 14280 25163 MT (KHDMP ATOE+128,128,'ATOEhigh')SH /Times-Roman SF 21280 26268 MT (Dump the 2nd half of the ATOE table.)SH /Courier SF 14280 27926 MT (KHDMP KHDSAV,20,'R14 - R2')SH /Times-Roman SF 21280 29031 MT (Dump registers 14-2.)SH /Courier SF 14280 30689 MT (KHDMP 32\050,13\051,40,'**R3-R12')SH /Times-Roman SF 21280 31794 MT (Dump registers 3-12.)SH /Courier SF 14280 33452 MT (KHDMP \0503\051,\0500\051,'**QBLOCK')SH /Times-Roman SF 21280 34557 MT (Dump block addressed by R3 with length specified in R0.)SH 8280 36949 MT (There is another debugging facility that is enabled by the variable symbol &KTRACE along with the dump option,)44 W 8280 38145 MT (namely, an execution trace. There is a circular buffer of trace elements in Kermit's working storage, and) 116 W( a new)115 W 8280 39341 MT (element is written each time a Kermit subroutine is called) 1 W( or returns. The elements contain the subroutine name plus)2 W 8280 40537 MT (\050on entry\051 a sequence number and the contents of registers 0 and 1 or \050on) 5 W( exit\051 the character ``)4 W /Courier SF (>)SH /Times-Roman SF ('' and the contents of)4 W 8280 41733 MT (registers 15 and 1. There is also a mechanism for tracing extra events by inserting KTRACE calls into the) 57 W( source.)58 W 8280 42929 MT (For example,)SH /Courier SF 14280 44658 MT (KTRACE 0\0505\051,REGS=5)SH /Times-Roman SF 21280 45763 MT (Trace eight bytes pointed to by R5 and R5 itself.)SH /Courier SF 14280 47421 MT (KTRACE FOOBAR)SH /Times-Roman SF 21280 48526 MT (Trace eight bytes at label FOOBAR.)SH /Courier SF 14280 50184 MT (KTRACE 'Found it',REGS=\0501,7\051)SH /Times-Roman SF 21280 51289 MT (Trace "Found it", R1, and R7.)SH 8280 53681 MT (The trace table is simply updated in storage, eating its own tail. It can be found in a memory dump by locating) 41 W( the)42 W 8280 54877 MT ("eye-catcher" that says ``)45 W /Courier SF (KTRACE:)SH /Times-Roman SF ('', which) 45 W( precedes the start, current, and end pointers for the table. The table is)44 W 8280 56073 MT (also accessible interactively via the TDUMP subcommand \050)SH /Times-Italic SF (q.v.)SH /Times-Roman SF (\051.)SH 8280 58465 MT (Each line in the debug log begins with a one-letter tag and a) 83 W( colon and contains information according to the tag.)84 W 8280 59661 MT (The following tags are defined.)SH 8280 61452 MT (S:)SH 10280 XM (The text of a packet sent. Normally, it will be encoded in EBCDIC for convenience, but) 73 W( if DEBUG is set to)72 W 10280 62557 MT (RAW, the) 24 W( packet will appear exactly as passed to or from the system, i.e., in EBCDIC for TTY or VTAMTTY)25 W 10280 63662 MT (lines and in ASCII for full-screen lines.)SH 8280 65320 MT (R:)SH 10280 XM (The text of a packet received. The same encoding applies.)SH 8280 66978 MT (A:)SH 10280 XM (The AID) 93 W( and buffer address returned by a full-screen device along with a read operation \050three characters in)92 W 10280 68083 MT (all\051. The) 262 W( values) 6 W( should all be printable EBCDIC. This obsolete tag was used by TSO and MUSIC Kermits and)7 W 10280 69188 MT (appeared only when DEBUG was set to I/O.)SH 8280 70846 MT (*:)SH 10280 XM (Data dumped by the optional KHDMP routine.)SH ES %%Page: 16 17 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 16)SH 12 /Times-Bold AF 29885 XM (Kermit User's Guide: IBM 370 KERMIT 1.4)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (The following) 9 W( tags appear only when DEBUG is set to I/O or LONG. All values are in hexadecimal. The meanings)8 W 6120 9082 MT (differ slightly according to the operating system. For CMS,) 55 W( the I/O parameter list is a channel command; for TSO)56 W 6120 10278 MT (or ROSCOE, the SVC 93 \050TPUT/TGET\051 parameters; for) 6 W( CICS, an intermediate string similar to channel commands.)5 W 6120 11474 MT (Similarly, the status data consist) 2 W( of the stored CSW plus an attention interrupt indicator for CMS, but the return code)3 W 6120 12670 MT (from the I/O operation for TSO, ROSCOE, CICS, and MUSIC.)SH 6120 14461 MT (a:)SH 8120 XM (Channel and device status after an unexpected attention interrupt.)SH 6120 16119 MT (b:)SH 8120 XM (I/O parameter list for recovering from a CP break-in on screen.)SH 6120 17777 MT (c:)SH 8120 XM (I/O parameter list for resuming normal screen operation.)SH 6120 19435 MT (d:)SH 8120 XM (Data transferred on the previously indicated I/O operation.)SH 6120 21093 MT (e:)SH 8120 XM (Status data after an I/O command has completed with an error.)SH 6120 22751 MT (g:)SH 8120 XM (I/O parameter list for reading from the screen buffer.)SH 6120 24409 MT (i:)SH 8120 XM (Status data after an I/O command has completed normally.)SH 6120 26067 MT (m:)SH 8120 XM (I/O parameter list for displaying text on the screen.)SH 6120 27725 MT (o:)SH 8120 XM (I/O parameter list for initializing the screen for transfers.)SH 6120 29383 MT (r:)SH 8120 XM (I/O parameter list for reading from the terminal.)SH 6120 31041 MT (w:)SH 8120 XM (I/O parameter list for a transparent write.)SH 6120 32699 MT (?:)SH 8120 XM (I/O parameter list for some other operation, such as clearing the screen.)SH 12 /Times-Bold AF 6120 35287 MT (SET DELAY)SH 10 /Times-Roman AF 6120 36701 MT (Syntax:)SH /Courier SF 9776 XM (SET DELAY)SH /Times-Italic SF 15776 XM (number)SH /Times-Roman SF 6120 39093 MT (Normally, Kermit-370 waits 10 seconds after) 6 W( the SEND subcommand before starting the transfer, but this delay may)5 W 6120 40289 MT (be set to) 182 W( any non-negative value. Two DELAY values have special meaning. When DELAY is 1, the usual)183 W 6120 41485 MT (two-line greeting) 27 W( displayed during protocol mode is abbreviated to a short message \050the default Kermit prompt with)26 W 6120 42681 MT (three dots...\051,) 44 W( and when DELAY is 0, the greeting is suppressed entirely, along with the extra one-second pause for)45 W 6120 43877 MT (subcommands like RECEIVE, SERVER, REMOTE, and the like.)SH 12 /Times-Bold AF 6120 46465 MT (SET EOF)SH 10 /Times-Roman AF 6120 47879 MT (Syntax:)SH /Courier SF 9776 XM (SET EOF ON)SH /Times-Italic SF 16376 XM (or)SH /Courier SF 17865 XM (OFF)SH /Times-Roman SF 6120 49670 MT (ON)SH 10120 XM (Scan each incoming TEXT file for the first occurrence of CTRL-Z) 102 W( and ignore the remainder of the file)101 W 10120 50775 MT (\050but continue decoding up to the actual end of the file\051. BINARY files are not affected.)SH 6120 52433 MT (OFF)SH 10120 XM (Accept incoming files in their entirety. \050Default.\051)SH 12 /Times-Bold AF 6120 55021 MT (SET FILE CHARACTER-SET)SH 10 /Times-Roman AF 6120 56435 MT (Syntax:)SH /Courier SF 9776 XM (SET FILE CHARACTER-SET)SH /Times-Italic SF 23576 XM (name)SH /Times-Roman SF 6120 58827 MT (Specifies the name of the character set used in files stored on disk. This setting may be superseded by) 41 W( an Attribute)42 W 6120 60023 MT (packet of an incoming file. Currently, the available names are CP037,) 158 W( CP273, CP275, CP277, CP278, CP280,)157 W 6120 61219 MT (CP281, CP282, CP284, CP285, CP290, CP297, CP420, CP424, CP500, CP838,) 148 W( CP870, CP871, CP875, CP880,)149 W 6120 62415 MT (CP905, CP1047, CZECH, DKOI, EBCDIC,) 775 W( H-EBCDIK-DASH, and KANJI \050or FUJITSU-KANJI,)774 W 6120 63611 MT (HITACHI-KANJI, or IBM-KANJI\051. The names beginning with CP refer to IBM code pages, while DKOI) 103 W( is the)104 W 6120 64807 MT (Cyrillic standard GOST 19768-87 used in) 44 W( the USSR, CZECH is a character set sometimes used in Czechoslovakia,)43 W 6120 66003 MT (and EBCDIC \050the default\051 is the traditional)39 W /Times-Italic SF 23920 XM (de facto)40 W /Times-Roman SF 27444 XM (standard EBCDIC character set. A character set other than the)40 W 6120 67199 MT (default may be required) 79 W( by local conventions and, if so, should be specified in the system or user INIT files. See)78 W 6120 68395 MT (Table 1-1 for the allowed combinations of transfer) 74 W( and file character sets. Explicitly setting this option has a side)75 W 6120 69591 MT (effect equivalent to issuing SET ATTRIBUTE ENCODING ON \050)SH /Times-Italic SF (q.v.)SH /Times-Roman SF (\051.)SH 6120 71983 MT (The name KANJI) 69 W( is actually just an alias for the local preferred proprietary Kanji code \050Fujitsu, Hitachi, or IBM\051.)68 W ES %%Page: 17 18 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (1.4. Kermit-370 Subcommands)SH 10 /Times-Italic AF 51775 XM (Page 17)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (The various Kanji) 99 W( character sets have two-byte codes \050DBCS\051, but are used with one-byte code pages \050SBCS\051 as)100 W 8280 9082 MT (well. It) 300 W( is normally necessary to issue two SET) 25 W( FILE CHARACTER-SET SUBCOMMANDS in order to set up for)24 W 8280 10278 MT (a DBCS: first, selecting a compatible SBCS, and,) 209 W( second, selecting the DBCS itself. If the current SBCS is)210 W 8280 11474 MT (incompatible with the selected DBCS, a default will be chosen. This default, along with the choice of) 25 W( the particular)24 W 8280 12670 MT (proprietary character set associated with the alias KANJI, is chosen by the installer.)SH 12 /Times-Bold AF 8280 15258 MT (SET FILE COLLISION)SH 10 /Times-Roman AF 8280 16672 MT (Syntax:)SH /Courier SF 11936 XM (SET FILE COLLISION)SH /Times-Italic SF 23336 XM (action)SH /Times-Roman SF 8280 19064 MT (Specifies the action to take when an incoming file has the) 2 W( same name as an existing one. Two of the options involve)3 W 8280 20260 MT (choosing an alternative, unique name similar to the one in conflict, but the details) 64 W( of choosing are system-specific.)63 W 8280 21456 MT (Typically, the method involves adding digits to the existing name.)SH 8280 23247 MT (APPEND)SH 14780 XM (The new file is appended to the old one. This option has the) 8 W( the same effect as the old subcommand)9 W 14780 24352 MT (SET APPEND ON.)SH 8280 26010 MT (BACKUP)SH 14780 XM (The existing file is renamed, and the new file is given the desired) 201 W( name as if no conflict had)200 W 14780 27115 MT (occurred.)SH 8280 28773 MT (DISCARD)SH 14780 XM (The incoming file is rejected by returning a "cancel file" indication on any Data packets.)SH 8280 30431 MT (OVERWRITE)SH 14780 XM (The existing file) 177 W( is overwritten with the incoming file. This is the default for the CMS, TSO,)178 W 14780 31536 MT (ROSCOE, and MUSIC variants. Changing this default is a good candidate) 94 W( for INIT files. When)93 W 14780 32641 MT (COLLISION is set to OVERWRITE, the attributes of the) 120 W( new file are determined by the current)121 W 14780 33746 MT (setting of FILE OVERWRITE \050)SH /Times-Italic SF (q.v.)SH /Times-Roman SF (\051.)SH 8280 35404 MT (RENAME)SH 14780 XM (The incoming file is renamed so as not) 143 W( to destroy \050overwrite\051 the pre-existing one, and the new)142 W 14780 36509 MT (name is returned to the sending Kermit for information purposes. This has the same effect as the) SH( old)1 W 14780 37614 MT (subcommand SET WARNING ON. This is the default for the CICS variant.)SH 12 /Times-Bold AF 8280 40202 MT (SET FILE LONGLINE)SH 10 /Times-Roman AF 8280 41616 MT (Syntax:)SH /Courier SF 11936 XM (SET FILE LONGLINE FOLD)SH /Times-Italic SF 25736 XM (or)SH /Courier SF 27225 XM (TRUNCATE)SH /Times-Italic SF 32625 XM (or)SH /Courier SF 34114 XM (HALT)SH /Times-Roman SF 8280 44008 MT (This specifies the action to take) 12 W( when a received line is longer than the current maximum record length. That length)11 W 8280 45204 MT (is determined by the context in a system-specific way. Refer to) 4 W( the description of the RECEIVE subcommand in the)5 W 8280 46400 MT (appropriate chapter for details.)SH 8280 48191 MT (FOLD)SH 14280 XM (Specifies that long lines are to be split into two or more records as needed, all but the last being of) 4 W( the)3 W 14280 49296 MT (maximum length. No) 148 W( null records are created when the received line is an exact multiple of the)149 W 14280 50401 MT (record length. BINARY files are always considered, by definition, as) 18 W( a single line and, therefore, are)17 W /Times-Italic SF 14280 51506 MT (always)SH /Times-Roman SF 17358 XM (folded, regardless of the setting of this parameter. V-BINARY and D-BINARY files, on) 50 W( the)51 W 14280 52611 MT (other hand, are reconstructed by) 49 W( folding at points determined by the context within the received file,)48 W 14280 53716 MT (and cannot be) 64 W( folded further to fit the current maximum length. Any such records that are too long)65 W 14280 54821 MT (will be truncated.)SH 8280 56479 MT (TRUNCATE)SH 14280 XM (Specifies that long lines are to be truncated at the maximum length. \050Default.\051) 120 W( Kermit-370) 488 W( takes)119 W 14280 57584 MT (note of the number of such truncations performed) 1 W( on a file and reports it in the STATUS message and)2 W 14280 58689 MT (also treats the fact of truncation as an error when the file transfer is complete. The) 6 W( file will have been)5 W 14280 59794 MT (transferred, but obviously not quite intact. However, this) 6 W( option can be useful for some tasks, such as)7 W 14280 60899 MT (stripping sequence numbers from) 98 W( card images. The process is similar to that provided by the SET)97 W 14280 62004 MT (MARGIN RIGHT subcommand for sending files.)SH 8280 63662 MT (HALT)SH 14280 XM (Specifies that a file transfer is to halt immediately if a received line is too long.) 114 W( Kermit-370) 480 W( then)115 W 14280 64767 MT (issues an error packet and stops the transfer.)SH ES %%Page: 18 19 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 18)SH 12 /Times-Bold AF 29885 XM (Kermit User's Guide: IBM 370 KERMIT 1.4)SH 46800 50 6120 5709 UL 6120 8004 MT (SET FILE OVERWRITE)SH 10 /Times-Roman AF 6120 9418 MT (Syntax:)SH /Courier SF 9776 XM (SET FILE OVERWRITE DEFAULT)SH /Times-Italic SF 25976 XM (or)SH /Courier SF 27465 XM (PRESERVE)SH /Times-Roman SF 6120 11209 MT (DEFAULT)SH 11620 XM (Specifies that the current file attribute settings are to) 9 W( be used for the new file. The result is roughly the)8 W 11620 12314 MT (same as if the old file, if any, were completely erased before the new file is received. \050Default.\051)SH 6120 13972 MT (PRESERVE)SH 11620 XM (Specifies that the attributes of the file being overwritten are to be retained) 77 W( and used for the new file.)78 W 11620 15077 MT (The result is roughly the same as if the) 11 W( old files contents were deleted, and the new file were appended)10 W 11620 16182 MT (to the empty stub.)SH 12 /Times-Bold AF 6120 18770 MT (SET FILE TYPE)SH 10 /Times-Roman AF 6120 20184 MT (Syntax:)SH /Courier SF 9776 XM (SET FILE TYPE)SH /Times-Italic SF 18176 XM (type)SH /Times-Roman SF 6120 22576 MT (Specifies the type of data comprising files to be sent or received. This setting may be) 11 W( temporarily superseded by the)12 W 6120 23772 MT (Attribute packets for a file being received.)SH 6120 25563 MT (TEXT)SH 11620 XM (Specifies ordinary text.) 3 W( ASCII-to-EBCDIC) 255 W( or EBCDIC-to-ASCII translation is performed on the data.)2 W 11620 26668 MT (Trailing blanks are removed, and CRLF's are appended to outgoing records. CRLF's) 22 W( are used, in turn,)23 W 11620 27773 MT (to determine the) 100 W( end of incoming records, which are padded with blanks if necessary to fill buffers.)99 W 11620 28878 MT (\050Default.\051 Note:) 710 W( trailing blanks are removed from outgoing, varying-length records only if they)231 W 11620 29983 MT (consist of a single blank each,) 22 W( or if there is a right margin specified \050)21 W /Times-Italic SF (q.v.)SH /Times-Roman SF (\051. Further) 292 W( note: a given file is)21 W 11620 31088 MT (intrinsically categorized as fixed-length or varying-length \050or undefined-length\051 by the) 30 W( file system and)31 W 11620 32193 MT (cannot be changed simply by setting the FILE RECFM parameter in Kermit.) 139 W( Conversion) 526 W( between)138 W 11620 33298 MT (formats is a system-specific) 21 W( function; see the system documentation or consult your local support staff)22 W 11620 34403 MT (for details on conversion techniques.)SH 6120 36061 MT (BINARY)SH 11620 XM (Specifies bit-stream data. No translation is performed, no CRLF's are added to outgoing records,) 39 W( and)38 W 11620 37166 MT (blanks are neither added nor removed. Incoming bytes are added successively to) 102 W( the current record)103 W 11620 38271 MT (buffer, which is written) 63 W( out when the current LRECL is reached. Padding, if necessary, is done with)62 W 11620 39376 MT (nulls.)SH 6120 41034 MT (V-BINARY)SH 11620 XM (Specifies varying-length-record binary) 33 W( data. This type is like BINARY, except that a two-byte binary)34 W 11620 42139 MT (prefix is added to each outgoing record giving the number of data bytes, and incoming records are set)41 W 11620 43244 MT (off by \050and stripped of\051 their prefixes on receipt.)SH 6120 44902 MT (D-BINARY)SH 11620 XM (Is like V-BINARY except that the) 2 W( length prefixes are five-byte ASCII-encoded decimal \050right-justified)3 W 11620 46007 MT (with leading zeroes\051.)SH 12 /Times-Bold AF 6120 48595 MT (SET FOREIGN)SH 10 /Times-Roman AF 6120 50009 MT (Syntax:)SH /Courier SF 9776 XM (SET FOREIGN PREFIX)SH /Times-Italic SF 21176 XM (string)SH /Times-Roman SF 6120 52401 MT (This defines a prefix string to be added to the outgoing)12 W /Times-Italic SF 28444 XM (filespec)SH /Times-Roman SF 31761 XM (generated by the) 12 W( SEND subcommand. For example,)11 W 6120 53597 MT (the string might be set to ``)28 W /Courier SF (B:)SH /Times-Roman SF ('' to specify output) 28 W( to the B disk drive on the other Kermit's system. The default is a)29 W 6120 54793 MT (null string. There is also a FOREIGN SUFFIX handled in the same manner.)SH 12 /Times-Bold AF 6120 57381 MT (SET HANDSHAKE)SH 10 /Times-Roman AF 6120 58795 MT (Syntax:)SH /Courier SF 9776 XM (SET HANDSHAKE)SH /Times-Italic SF 18176 XM (number)SH /Times-Roman SF 6120 61187 MT (This defines the character, if any, that Kermit-370 should send \050or cause to be sent\051 immediately before reading) 5 W( each)4 W 6120 62383 MT (packet. The) 272 W( character is given as the decimal of an ASCII control character, or as zero if no handshake) 11 W( is to be sent.)12 W 6120 63579 MT (The default is 17) 112 W( \050XON\051, and any value in the range 0-31 is valid, but 13 \050CR\051 should not be used because it is)111 W 6120 64775 MT (generally the end-of-packet) 131 W( character. When Kermit-370 is running through a full-duplex connection \050such as a)132 W 6120 65971 MT (``)SH /Courier SF (SERIES1)SH /Times-Roman SF (''\051, the traditional IBM handshaking is) 38 W( not necessary, and HANDSHAKE should be set to 0 \050as long as)37 W 6120 67167 MT (the other Kermit can) 52 W( be instructed not to expect a handshake\051. Note the distinction between)53 W /Courier SF 43986 XM (SET HANDSHAKE)53 W /Times-Roman SF 52142 XM (in)SH 6120 68363 MT (Kermit-370 \050where it defines a character to be sent\051 and in many) 55 W( micro Kermits \050where it defines a character to be)54 W 6120 69559 MT (expected\051.)SH ES %%Page: 19 20 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (1.4. Kermit-370 Subcommands)SH 10 /Times-Italic AF 51775 XM (Page 19)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (SET INCOMPLETE)SH 10 /Times-Roman AF 8280 9418 MT (Syntax:)SH /Courier SF 11936 XM (SET INCOMPLETE DISCARD)SH /Times-Italic SF 25736 XM (or)SH /Courier SF 27225 XM (KEEP)SH /Times-Roman SF 8280 11209 MT (DISCARD)SH 13280 XM (Specifies that incomplete files \050that is, files partially received in a transfer cancelled by) 213 W( the other)214 W 13280 12314 MT (Kermit\051 are to be erased. This is the) 244 W( default. Note that when FILE COLLISION is APPEND,)243 W 13280 13419 MT (incomplete files are never erased, lest pre-existing data be lost.)SH 8280 15077 MT (KEEP)SH 13280 XM (Specifies that incomplete files are to be kept.)SH 12 /Times-Bold AF 8280 17665 MT (SET LINE)SH 10 /Times-Roman AF 8280 19079 MT (Syntax:)SH /Courier SF 11936 XM (SET LINE [)SH /Times-Italic SF (name)SH /Courier SF (])SH /Times-Roman SF 8280 21471 MT (This specifies an alternate communication) 52 W( line for file transfers. If the)53 W /Times-Italic SF 37378 XM (name)SH /Times-Roman SF 39847 XM (is omitted, the default line \050the user's)53 W 8280 22667 MT (terminal\051 is used. The format of)116 W /Times-Italic SF 22312 XM (name)SH /Times-Roman SF 24844 XM (is, of course, system-dependent, and some variants of) 116 W( Kermit-370 do not)115 W 8280 23863 MT (support any alternate lines. No variant currently allows Kermit-370 to CONNECT over an alternate line.)SH 12 /Times-Bold AF 8280 26451 MT (SET MARGIN)SH 10 /Times-Roman AF 8280 27865 MT (Syntax:)SH /Courier SF 11936 XM (SET MARGIN)SH /Times-Italic SF 18536 XM (side column)350 W /Times-Roman SF 8280 30257 MT (When Kermit-370 sends a text file, each line may be truncated on the left or right \050or both\051 at) SH( fixed column numbers.)1 W 8280 31453 MT (Only the text from the left margin) 2 W( to the right margin \050inclusive\051 will be sent, and any trailing blanks in the truncated)1 W 8280 32649 MT (lines will be stripped. A value of zero for either margin disables truncation on that side.)SH 12 /Times-Bold AF 8280 35237 MT (SET PROMPT)SH 10 /Times-Roman AF 8280 36651 MT (Syntax:)SH /Courier SF 11936 XM (SET PROMPT [)SH /Times-Italic SF (string)SH /Courier SF (])SH /Times-Roman SF 8280 39043 MT (This defines the) 27 W( character string that Kermit-370 displays when asking for a subcommand. The prompt may be any)28 W 8280 40239 MT (string of up to 20 characters. The default is the name of the system-specific variant of Kermit-370 followed by) 2 W( a ">")1 W 8280 41435 MT (sign,)SH /Times-Italic SF 10447 XM (e.g.)SH /Times-Roman SF (,)SH /Courier SF 12391 XM (Kermit-CMS>)SH /Times-Roman SF (. If) 250 W( the)SH /Times-Italic SF 22129 XM (string)SH /Times-Roman SF 24713 XM (is omitted, normal system prompting will occur.)SH 12 /Times-Bold AF 8280 44023 MT (SET RETRY)SH 10 /Times-Roman AF 8280 45437 MT (Syntax:)SH /Courier SF 11936 XM (SET RETRY INITIAL)SH /Times-Italic SF 22736 XM (or)SH /Courier SF 24225 XM (PACKETS)SH /Times-Italic SF 29025 XM (number)SH /Times-Roman SF 8280 47829 MT (Kermit-370 resends its last packet after receiving a NAK or) 114 W( bad packet, but it eventually gives up after repeated)115 W 8280 49025 MT (failures on the same packet. The limit) 62 W( on retries can be set separately for the initial packet exchange \050Send-Init or)61 W 8280 50221 MT (server-mode command\051 and for ordinary packets. The default for INITIAL is 16 and for) 16 W( PACKETS, 5. Either limit)17 W 8280 51417 MT (can be set to any positive value.)SH 12 /Times-Bold AF 8280 54005 MT (SET SERVER-TIMEOUT)SH 10 /Times-Roman AF 8280 55419 MT (Syntax:)SH /Courier SF 11936 XM (SET SERVER-TIMEOUT)SH /Times-Italic SF 23336 XM (time)SH /Times-Roman SF 8280 57811 MT (This defines the)36 W /Times-Italic SF 15026 XM (time)SH /Times-Roman SF 17034 XM (in seconds that Kermit-370 in server mode should wait for a command before sending a NAK)35 W 8280 59007 MT (packet. The) 274 W( default is 120. A value of 0 means that Kermit should wait indefinitely, not only in the server loop,) 12 W( but)13 W 8280 60203 MT (in all transfers, regardless) 44 W( of the timeout value specified by the other Kermit. Some variants are unable to time out)43 W 8280 61399 MT (in any case. Also, timeouts are not implemented for any of the full-screen terminal controllers.)SH 12 /Times-Bold AF 8280 63987 MT (SET SPEED)SH 10 /Times-Roman AF 8280 65401 MT (Syntax:)SH /Courier SF 11936 XM (SET SPEED)SH /Times-Italic SF 17936 XM (number)SH /Times-Roman SF 8280 67793 MT (This determines the communication line speed assumed by Kermit-370 in calculating) 76 W( the optimum packet size. If)77 W 8280 68989 MT (the value is) 8 W( zero, such calculations are suppressed. This option is purely informative and has no effect on actual line)7 W 8280 70185 MT (speed. \050Default) 250 W( 1200.\051)SH ES %%Page: 20 21 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 20)SH 12 /Times-Bold AF 29885 XM (Kermit User's Guide: IBM 370 KERMIT 1.4)SH 46800 50 6120 5709 UL 6120 8004 MT (SET SYSCMD)SH 10 /Times-Roman AF 6120 9418 MT (Syntax:)SH /Courier SF 9776 XM (SET SYSCMD ON)SH /Times-Italic SF 18176 XM (or)SH /Courier SF 19665 XM (OFF)SH /Times-Roman SF 6120 11209 MT (ON)SH 10120 XM (If the user enters) 89 W( a command string which is not a valid Kermit subcommand, Kermit-370 will pass the)90 W 10120 12314 MT (string along to the host operating system for execution. If the string is rejected by the system) 117 W( as well,)116 W 10120 13419 MT (Kermit will report it as an) 112 W( invalid)113 W /Times-Italic SF 24544 XM (Kermit)SH /Times-Roman SF 27685 XM (subcommand. Otherwise,) 476 W( Kermit will assume the string was)113 W 10120 14524 MT (intended as a host command and will simply report the completion code if non-zero.)SH 6120 16182 MT (OFF)SH 10120 XM (Invalid Kermit) 14 W( subcommands are simply rejected as such. System commands may be executed, of course,)13 W 10120 17287 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 10120 18392 MT (or TSO. \050Default.\051)SH 12 /Times-Bold AF 6120 20980 MT (SET TABS-EXPAND)SH 10 /Times-Roman AF 6120 22394 MT (Syntax:)SH /Courier SF 9776 XM (SET TABS-EXPAND ON [)SH /Times-Italic SF (list)SH /Courier SF (])SH /Times-Italic SF 24199 XM (or)SH /Courier SF 25688 XM (OFF)SH /Times-Roman SF 6120 24185 MT (ON)SH 10120 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 10120 25290 MT (the next higher multiple of eight for each tab. If tab settings other than columns 1, 9, 17,)37 W /Times-Italic SF 46569 XM (etc.)SH /Times-Roman SF 48273 XM (are desired,)38 W 10120 26395 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 10120 27500 MT (by spaces or commas and must be in strictly increasing order.)SH 6120 29158 MT (OFF)SH 10120 XM (Incoming tabs are retained. \050Default.\051)SH 12 /Times-Bold AF 6120 31746 MT (SET TAKE ECHO)SH 10 /Times-Roman AF 6120 33160 MT (Syntax:)SH /Courier SF 9776 XM (SET TAKE ECHO ON)SH /Times-Italic SF 19976 XM (or)SH /Courier SF 21465 XM (OFF)SH /Times-Roman SF 6120 34951 MT (ON)SH 10120 XM (Subcommands are echoed to the terminal as they are executed from a TAKE file.)SH 6120 36609 MT (OFF)SH 10120 XM (Subcommands from a TAKE file are executed "silently." \050Default.\051)SH 12 /Times-Bold AF 6120 39197 MT (SET TAKE ERROR-ACTION)SH 10 /Times-Roman AF 6120 40611 MT (Syntax:)SH /Courier SF 9776 XM (SET TAKE ERROR-ACTION CONTINUE)SH /Times-Italic SF 28376 XM (or)SH /Courier SF 29865 XM (HALT)SH /Times-Roman SF 6120 42402 MT (CONTINUE)SH 11620 XM (Execution continues in a TAKE file regardless of illegal commands, except in server) 71 W( mode. \050This is)72 W 11620 43507 MT (the default.\051)SH 6120 45165 MT (HALT)SH 11620 XM (A command error in a TAKE file causes immediate exit to Kermit subcommand level.)SH 12 /Times-Bold AF 6120 47753 MT (SET TEST)SH 10 /Times-Roman AF 6120 49167 MT (Syntax:)SH /Courier SF 9776 XM (SET TEST ON)SH /Times-Italic SF 16976 XM (or)SH /Courier SF 18465 XM (OFF)SH /Times-Roman SF 6120 50958 MT (ON)SH 10120 XM (Allow setting the START-OF-PACKET and other special characters to any value, and suppress type 1)131 W 10120 52063 MT (checksum testing on received packets.)SH 6120 53721 MT (OFF)SH 10120 XM (Normal operation. \050Default.\051)SH 12 /Times-Bold AF 6120 56309 MT (SET TRANSFER CHARACTER-SET)SH 10 /Times-Roman AF 6120 57723 MT (Syntax:)SH /Courier SF 9776 XM (SET TRANSFER CHARACTER-SET)SH /Times-Italic SF 25976 XM (name)SH /Times-Roman SF 6120 60115 MT (Specifies the name of the character set used in sending or) 108 W( receiving files. This setting may be superseded by an)109 W 6120 61311 MT (Attribute packet of an incoming file. Currently, the available names are ASCII \050the default\051, ARABIC,) 21 W( CYRILLIC,)20 W 6120 62507 MT (GREEK, HEBREW, JAPAN-EUC,) 237 W( KATAKANA, LATIN1, LATIN2, LATIN3, THAI, and TRANSPARENT.)238 W 6120 63703 MT (There are) 35 W( also special aliases L1, L2, and L3 for the LATINx names. All but JAPAN-EUC, TRANSPARENT, and)34 W 6120 64899 MT (ASCII represent 8-bit codes composed of) 106 W( a pair of 94- or 96-character sets from the ISO registry combined with)107 W 6120 66095 MT (normal definitions for the) 50 W( so-called C0 and C1 characters. JAPAN-EUC is a DBCS for encoding Kanji characters,)49 W 6120 67291 MT (plus Roman, Greek, and Cyrillic. ASCII is the traditional character set supported by) 48 W( Kermit, but one of the newer,)49 W 6120 68487 MT (8-bit sets) 26 W( would be preferable for most users. This option is, therefore, a good candidate for inclusion in the system)25 W 6120 69683 MT (INIT file.) 122 W( See) 496 W( Table 1-1 for the allowed combinations of transfer and file character sets. Explicitly setting this)123 W 6120 70879 MT (option has a side effect equivalent to issuing SET ATTRIBUTE ENCODING ON \050)95 W /Times-Italic SF (q.v.)SH /Times-Roman SF (\051. There) 440 W( is) 95 W( one exception,)94 W ES %%Page: 21 22 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (1.4. Kermit-370 Subcommands)SH 10 /Times-Italic AF 51775 XM (Page 21)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (namely, TRANSPARENT, which sets ENCODING OFF and replaces) 87 W( both translation tables with null operations,)88 W 8280 9082 MT (regardless of the current nominal file character set.)SH 8280 11474 MT (The biggest drawback of the built-in tables for the various character sets is) 97 W( that neither the ISO registry nor IBM)96 W 8280 12670 MT (defines any mapping between the C1 characters \050hex 80-9F in ISO arrangements\051 and) 106 W( the characters of EBCDIC)107 W 8280 13866 MT (code pages. Thus, the mappings in Kermit-370 tables are) 158 W( somewhat arbitrary, and future pronouncements may)157 W 8280 15062 MT (suddenly invalidate some or all of those 32 mappings.)SH 12 /Times-Bold AF 8280 17650 MT (SET TRANSFER LOCKING-SHIFT)SH 10 /Times-Roman AF 8280 19064 MT (Syntax:)SH /Courier SF 11936 XM (SET TRANSFER LOCKING-SHIFT ON)SH /Times-Italic SF 29936 XM (or)SH /Courier SF 31425 XM (OFF)SH /Times-Italic SF 33825 XM (or)SH /Courier SF 35314 XM (FORCED)SH /Times-Roman SF 8280 20855 MT (ON)SH 12780 XM (The Kermit) 13 W( locking-shift protocol is to be used in transfers to or from cooperating partners, provided that)14 W 12780 21960 MT (8th-bit quoting is enabled.)SH 8280 23618 MT (OFF)SH 12780 XM (The Kermit locking-shift protocol is not to be used.)SH 8280 25276 MT (FORCED)SH 12780 XM (The Kermit locking-shift protocol is to be used, regardless of the cooperation of) 69 W( the other Kermit. The)68 W 12780 26381 MT (encoding uses only the locking shifts, to the exclusion of 8th-bit quoting.)SH 12 /Times-Bold AF 8280 28969 MT (SET TTABLE)SH 10 /Times-Roman AF 8280 30383 MT (Syntax:)SH /Courier SF 11936 XM (SET TTABLE ON)SH /Times-Italic SF 20336 XM (or)SH /Courier SF 21825 XM (OFF)SH /Times-Italic SF 24225 XM (or)SH /Courier SF 25714 XM (KP)SH /Times-Roman SF 8280 32174 MT (ON)SH 12280 XM (The translation that undoes the terminal) 48 W( controller's ASCII/EBCDIC conversion comes from the TATOE)49 W 12280 33279 MT (and TETOA tables, rather than the ATOE and ETOA tables \050which are used only for translating) 153 W( disk)152 W 12280 34384 MT (files\051. This) 350 W( option has) 50 W( no effect when there is no translation built into the controller,)51 W /Times-Italic SF 47144 XM (i.e.)SH /Times-Roman SF (, with SERIES1,)51 W 12280 35489 MT (GRAPHICS, and AEA connections.)SH 8280 37147 MT (OFF)SH 12280 XM (The ATOE and ETOA tables are used for all translations by Kermit-370. \050Default.\051)SH 8280 38805 MT (KP)SH 12280 XM (Same as ON, but also establishes values in) 143 W( the TATOE and TETOA tables based on IBM's corporate)142 W 12280 39910 MT (standard ASCII/EBCDIC translation \050distinct from the internationally accepted)SH /Times-Italic SF 44221 XM (de facto)SH /Times-Roman SF 47665 XM (standard\051.)SH 12 /Times-Bold AF 8280 42498 MT (SET 8-BIT-QUOTE)SH 10 /Times-Roman AF 8280 43912 MT (Syntax:)SH /Courier SF 11936 XM (SET 8-BIT-QUOTE)SH /Times-Italic SF 21536 XM (char or)350 W /Courier SF 25458 XM (ON)SH /Times-Italic SF 27258 XM (or)SH /Courier SF 28747 XM (OFF)SH /Times-Roman SF 8280 46304 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 8280 47500 MT (only two Send-Init parameters that cannot be SET separately for SEND and RECEIVE.)SH 8280 49291 MT (char)SH 12280 XM (Eighth-bit prefixing will be done using)92 W /Times-Italic SF 28665 XM (char)SH /Times-Roman SF (, provided the other) 92 W( Kermit agrees. The default value is an)91 W 12280 50396 MT (ampersand.)SH 8280 52054 MT (ON)SH 12280 XM (Eighth-bit prefixing will be done, provided the other Kermit explicitly requests it \050and) 222 W( specifies the)223 W 12280 53159 MT (character\051.)SH 8280 54817 MT (OFF)SH 12280 XM (Eighth-bit prefixing will not be done.)SH 12 /Times-Bold AF 8280 57405 MT (SET SEND/RECEIVE)SH 10 /Times-Roman AF 8280 58819 MT (The following parameters can be set) 153 W( either as SEND or RECEIVE options. As a rule, in each pair, one is the)152 W 8280 60015 MT (operational value, and the other is used to change the default for Send-Init packets received from) 68 W( the other Kermit)69 W 8280 61211 MT (and to set up parameter values as if the) 123 W( other Kermit had specified them on the previous exchange. When both)122 W 8280 62407 MT (values are described, the operational) 55 W( one will be first. For all parameters besides QUOTE, the operational value is)56 W 8280 63603 MT (the RECEIVE. After a transfer, the operational values will be unchanged, but the others \050as displayed by SHOW\051)65 W 8280 64799 MT (will reflect the parameters specified by the other Kermit.) 149 W( The) 549 W( underlying defaults established by previous SET)150 W 8280 65995 MT (subcommands will still be in effect. In the syntax descriptions,)SH /Times-Italic SF 33806 XM (mode)SH /Times-Roman SF 36222 XM (is SEND or RECEIVE.)SH ES %%Page: 22 23 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 22)SH 12 /Times-Bold AF 29885 XM (Kermit User's Guide: IBM 370 KERMIT 1.4)SH 46800 50 6120 5709 UL 6120 8004 MT (END-OF-LINE)SH 10 /Times-Roman AF 6120 9418 MT (Syntax:)SH /Courier SF 9776 XM (SET)SH /Times-Italic SF 12176 XM (mode)SH /Courier SF 14942 XM (END-OF-LINE)SH /Times-Italic SF 22142 XM (number)SH /Times-Roman SF 6120 11810 MT (RECEIVE should not be changed.)SH 6120 14202 MT (SEND may be) 1 W( needed to establish contact. If the other system needs packets to be terminated by anything other than)SH 6120 15398 MT (carriage return, specify the decimal value of the desired ASCII character.)196 W /Times-Italic SF 38240 XM (number)SH /Times-Roman SF 41742 XM (must be in the range 0-31)197 W 6120 16594 MT (\050decimal\051. The) 250 W( default is 13 \050CR\051.)SH 12 /Times-Bold AF 6120 19182 MT (PACKET-SIZE)SH 10 /Times-Roman AF 6120 20596 MT (Syntax:)SH /Courier SF 9776 XM (SET)SH /Times-Italic SF 12176 XM (mode)SH /Courier SF 14942 XM (PACKET-SIZE)SH /Times-Italic SF 22142 XM (number)SH /Times-Roman SF 6120 22988 MT (RECEIVE defines)47 W /Times-Italic SF 13824 XM (number)SH /Times-Roman SF 17176 XM (as the maximum length for incoming packets. The valid range is) 47 W( 26-9024, but 94 is the)46 W 6120 24184 MT (limit for normal short-packet protocol. The default is 80. Specifying a value greater than 94 is) 155 W( necessary and)156 W 6120 25380 MT (sufficient to enable the long-packet protocol for transfers to Kermit-370 \050provided the other Kermit is) 165 W( willing\051.)164 W 6120 26576 MT (Kermit-370 will actually accept long packets in any) 89 W( case, but the protocol requires that the other Kermit not send)90 W 6120 27772 MT (them unless Kermit-370 asks.) 22 W( Raising) 292 W( this value from the default is a good candidate for inclusion in INIT files. In)21 W 6120 28968 MT (practice, the packet size may be limited by hardware and) 148 W( programming considerations. See the system-specific)149 W 6120 30164 MT (chapters for details.)SH 6120 32556 MT (SEND might be needed for sending files) 106 W( to a minimal Kermit that neither specifies a buffer size in the Send-Init)105 W 6120 33752 MT (sequence nor can accept the default \05080\051.) 4 W( It) 259 W( may also be used to specify the packet size for a "raw" download via the)5 W 6120 34948 MT (XTYPE subcommand. This parameter has no other function and is) 107 W( completely irrelevant to long packets. If the)106 W 6120 36144 MT (other Kermit asks for long packets, Kermit-370 will always comply.)SH 12 /Times-Bold AF 6120 38732 MT (PAD-CHAR)SH 10 /Times-Roman AF 6120 40146 MT (Syntax:)SH /Courier SF 9776 XM (SET)SH /Times-Italic SF 12176 XM (mode)SH /Courier SF 14942 XM (PAD-CHAR)SH /Times-Italic SF 20342 XM (number)SH /Times-Roman SF 6120 42538 MT (RECEIVE defines)36 W /Times-Italic SF 13802 XM (number)SH /Times-Roman SF 17143 XM (as the character to be used by the other Kermit for padding packets. The character must)37 W 6120 43734 MT (be an ASCII control character \050in the range 0-31\051. The default is 0 \050NULL\051. This option is seldom useful.)SH 6120 46126 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 6120 48714 MT (PADDING)SH 10 /Times-Roman AF 6120 50128 MT (Syntax:)SH /Courier SF 9776 XM (SET)SH /Times-Italic SF 12176 XM (mode)SH /Courier SF 14942 XM (PADDING)SH /Times-Italic SF 19742 XM (number)SH /Times-Roman SF 6120 52520 MT (RECEIVE defines the)14 W /Times-Italic SF 15244 XM (number)SH /Times-Roman SF 18563 XM (of pad characters to) 14 W( be used for padding packets from the other Kermit. This number)13 W 6120 53716 MT (may be anywhere from 0 to 94. The default is 0. This option is seldom useful.)SH 6120 56108 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 6120 58696 MT (PARITY)SH 10 /Times-Roman AF 6120 60110 MT (Syntax:)SH /Courier SF 9776 XM (SET)SH /Times-Italic SF 12176 XM (mode)SH /Courier SF 14942 XM (PARITY MARK)SH /Times-Italic SF 22142 XM (or)SH /Courier SF 23631 XM (NONE)SH /Times-Roman SF 6120 62502 MT (RECEIVE specifies the parity expected in the transparent-mode ASCII data) 174 W( received by the mainframe from a)175 W 6120 63698 MT (full-screen device. Such data will typically have either all Mark parity \050seven) 23 W( data bits with the eighth bit set\051 or no)22 W 6120 64894 MT (parity \050eight data bits\051. This is typically not the same as the parity used in communications between) 89 W( the protocol)90 W 6120 66090 MT (convertor and the terminal. Kermit-370 must know which kind of parity to) 56 W( expect in order to calculate checksums)55 W 6120 67286 MT (properly. Since) 343 W( Kermit-370 does not actually verify parity, the other possible variants \050ODD, EVEN, and SPACE\051)47 W 6120 68482 MT (are lumped together with MARK parity for the purpose of this subcommand, which merely chooses between 7-bit)73 W 6120 69678 MT (and 8-bit data transfer. The default is MARK.)SH ES %%Page: 23 24 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (1.4. Kermit-370 Subcommands)SH 10 /Times-Italic AF 51775 XM (Page 23)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (SEND is also an operational) 210 W( value, specifying the parity to be used in constructing outgoing data packets on)211 W 8280 9082 MT (full-screen devices. NONE is the default and) 61 W( is generally preferable, in that it permits binary transfers without the)60 W 8280 10278 MT (need for eighth-bit prefixing, but MARK may be required in some configurations.)SH 12 /Times-Bold AF 8280 12866 MT (QUOTE)SH 10 /Times-Roman AF 8280 14280 MT (Syntax:)SH /Courier SF 11936 XM (SET)SH /Times-Italic SF 14336 XM (mode)SH /Courier SF 17102 XM (QUOTE)SH /Times-Italic SF 20702 XM (char)SH /Times-Roman SF 8280 16672 MT (SEND indicates a printable character for prefixing \050quoting\051 control) SH( characters and other prefix characters. The only)1 W 8280 17868 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 19064 MT (prefix\051 as data. It must be a single character with ASCII value 33-62 or 96-126 \050decimal\051.)SH 8280 21456 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 22652 MT (does not admit it.)SH 12 /Times-Bold AF 8280 25240 MT (START-OF-PACKET)SH 10 /Times-Roman AF 8280 26654 MT (Syntax:)SH /Courier SF 11936 XM (SET)SH /Times-Italic SF 14336 XM (mode)SH /Courier SF 17102 XM (START-OF-PACKET)SH /Times-Italic SF 26702 XM (number)SH /Times-Roman SF 8280 29046 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 30242 MT (character must be an ASCII control character \050in the range 0-31\051. The default is 1 \050SOH\051. This may need to be)100 W 8280 31438 MT (changed to establish contact.)SH 8280 33830 MT (SEND may also need to) 124 W( be changed to establish contact. It defines)123 W /Times-Italic SF 36934 XM (number)SH /Times-Roman SF 40362 XM (as the character to be used to mark)123 W 8280 35026 MT (outgoing packets.)SH 12 /Times-Bold AF 8280 37614 MT (TIMEOUT)SH 10 /Times-Roman AF 8280 39028 MT (Syntax:)SH /Courier SF 11936 XM (SET)SH /Times-Italic SF 14336 XM (mode)SH /Courier SF 17102 XM (TIMEOUT)SH /Times-Italic SF 21902 XM (time)SH /Times-Roman SF 8280 41420 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 42616 MT (packet. The) 250 W( default is 5. A value of 0 means the other Kermit should wait indefinitely.)SH 8280 45008 MT (SEND may be needed to define the)2 W /Times-Italic SF 22652 XM (time)SH /Times-Roman SF 24626 XM (in seconds Kermit-370 is to wait for a response from the other Kermit in the)1 W 8280 46204 MT (initial packet exchange, although the default value) 200 W( 0 \050indefinite wait\051 is probably satisfactory, especially since)201 W 8280 47400 MT (Kermit-370 in many cases cannot time out anyway. Specifying a non-zero value) 19 W( will prevent the other Kermit from)18 W 8280 48596 MT (ever requesting infinite "patience" from Kermit-370.)SH 13 /Times-Bold AF 24420 51955 MT (The SHOW Subcommand)SH 10 /Times-Roman AF 8280 54328 MT (Syntax:)SH /Courier SF 11936 XM (SHOW [)SH /Times-Italic SF (option)SH /Courier SF (])SH /Times-Roman SF 8280 56720 MT (The SHOW subcommand displays the values of all parameters) 135 W( that can be changed with the SET subcommand,)136 W 8280 57916 MT (except CONTROL-CHAR, ATOE, ETOA, TATOE, and TETOA \050for those, see the TDUMP subcommand\051. If)149 W 8280 59112 MT (specified,)SH /Times-Italic SF 12423 XM (option)SH /Times-Roman SF 15262 XM (can be a particular parameter or the keyword ``)33 W /Courier SF (ALL)SH /Times-Roman SF ('' \050the default\051. Groups of) 33 W( parameters, such as)34 W 8280 60308 MT (SEND, can be displayed by) 20 W( requesting the group name, or individual sub-parameters can be displayed by specifying)19 W 8280 61504 MT (the complete name. For example,)SH /Courier SF 10680 63159 MT (SHOW RECEIVE EOL)SH /Times-Roman SF 8280 64876 MT (will display the decimal value of the packet terminator that Kermit-370 currently expects,)SH /Times-Italic SF 44385 XM (i.e.)SH /Times-Roman SF (, 13. Similarly,)SH /Courier SF 10680 66531 MT (SHOW FOREIGN)SH /Times-Roman SF 8280 68248 MT (will display) 58 W( the character strings currently in use for prefix and suffix on each outgoing)59 W /Times-Italic SF 44352 XM (filespec)SH /Times-Roman SF (. When) 368 W( ``)59 W /Courier SF (ALL)SH /Times-Roman SF ('' is)59 W 8280 69444 MT (specified or implied, all parameters other than the attribute switches are displayed.)SH ES %%Page: 24 25 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 24)SH 12 /Times-Bold AF 29885 XM (Kermit User's Guide: IBM 370 KERMIT 1.4)SH 46800 50 6120 5709 UL 13 SS 21753 8071 MT (The STATUS Subcommand)SH 10 /Times-Roman AF 6120 10444 MT (Syntax:)SH /Courier SF 9776 XM (STATUS)SH /Times-Roman SF 6120 12836 MT (This subcommand displays) 161 W( information about the previously executed subcommand. The response will include)160 W 6120 14032 MT (either the) 361 W( 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)362 W 6120 15228 MT (transfers yet)30 W /Times-Roman SF (''. If) 310 W( the status reflects an error condition, the name of the) 30 W( last file used \050excluding TAKE files\051)29 W 6120 16424 MT (will be displayed as well. If the error) 29 W( was detected by the other Kermit, the message will be ``)30 W /Courier SF (Micro aborted)30 W /Times-Roman SF ('')SH 6120 17620 MT (followed by the text from the Error packet. Conversely, if Kermit-370 detected the error, the text of) 145 W( the status)144 W 6120 18816 MT (message will have constituted the error packet) 26 W( sent out. In any case, if the last file transfer was cancelled \050by virtue)27 W 6120 20012 MT (of an attribute mismatch or manual intervention\051, the) 7 W( reason for cancellation is displayed. Also, if the error occurred)6 W 6120 21208 MT (in disk I/O, any available explanatory) 95 W( information is displayed. Normally, the error status is altered only when a)96 W 6120 22404 MT (transfer-initiating subcommand \050SEND or RECEIVE\051 is) 112 W( executed, but there are several exceptions. If an invalid)111 W 6120 23600 MT (subcommand is entered, the status becomes ``)124 W /Courier SF (Kermit command error)124 W /Times-Roman SF ('', and the next subcommand entered)124 W 6120 24796 MT (will reset the status. Also, in server mode)56 W /Times-Italic SF 23650 XM (every)SH /Times-Roman SF 26121 XM (subcommand is received through a) 56 W( transfer from the other Kermit)55 W 6120 25992 MT (and may affect the status \050except the STATUS subcommand itself, of course\051.)SH 6120 28384 MT (Other information is also included. When Kermit-370 has been) 83 W( forced to truncate one or more records in the last)84 W 6120 29580 MT (RECEIVE operation \050because of the current) 64 W( maximum record length\051, the number of records truncated is reported.)63 W 6120 30776 MT (The status display also includes) 58 W( throughput statistics for the last transfer: number of files sent, duration, number of)59 W 6120 31972 MT (packets, number of retries, and averages of bytes/packet) 53 W( and bytes/second. These last two quantities are calculated)52 W 6120 33168 MT (separately for bytes sent and received on the communication line \050including padding, if any\051, and the last) 20 W( quantity is)21 W 6120 34364 MT (also calculated on) 58 W( the basis of the number of bytes read from or written to disk. Further, if retries were necessary,)57 W 6120 35560 MT (Kermit-370 computes the optimum packet size) 53 W( assuming the retries to have been due to sparse, Poisson-distributed)54 W 6120 36756 MT (bursts of noise. This is the same heuristic) 16 W( optimum that Kermit-370 computes and uses as an alternative packet-size)15 W 6120 37952 MT (limit when sending long packets. If TEST is set on,) 73 W( Kermit also reports the maximum size attained by its storage)74 W 6120 39148 MT (stack since execution began.)SH 13 /Times-Bold AF 22585 42507 MT (The STOP Subcommand)SH 10 /Times-Roman AF 6120 44880 MT (Syntax:)SH /Courier SF 9776 XM (STOP)SH /Times-Roman SF 6120 47272 MT (This is not a subcommand in the usual sense. Instead, it is a command string that can be) 262 W( entered on the)261 W 6120 48468 MT (communication line while Kermit-370 is in protocol mode and will cause protocol) 11 W( mode to cease immediately. This)12 W 6120 49664 MT (may be useful if the other Kermit has crashed. The word "stop") 28 W( may be entered in either upper or lower case, but it)27 W 6120 50860 MT (must be the) 90 W( only character string in the "packet" in question. If you are using a full-screen terminal, and if other)91 W 6120 52056 MT (information appears on the screen, you) 179 W( must clear that other text from the screen \050using CLEAR EOF\051 before)178 W 6120 53252 MT (pressing ENTER.)SH 13 /Times-Bold AF 22440 56611 MT (The TAKE Subcommand)SH 10 /Times-Roman AF 6120 58984 MT (Syntax:)SH /Courier SF 9776 XM (TAKE)SH /Times-Italic SF 12776 XM (filespec)SH /Times-Roman SF 6120 61376 MT (Execute Kermit subcommands from the specified file, usually called) 140 W( a TAKE file. The TAKE file may in turn)141 W 6120 62572 MT (include TAKE subcommands,) 229 W( and the nesting may continue to a depth of ten. If a TAKE file includes the)228 W 6120 63768 MT (subcommand SERVER, however, the nesting count is saved and starts over again in server mode in) 57 W( case the client)58 W 6120 64964 MT (Kermit should transmit a REMOTE KERMIT TAKE command.) 365 W( The) 979 W( user has the option of seeing the)364 W 6120 66160 MT (subcommands echoed from the TAKE file as they are executed and also the option of automatically) 54 W( exiting from a)55 W 6120 67356 MT (TAKE file on error. See the subcommand SET TAKE for details.)SH ES %%Page: 25 26 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (1.4. Kermit-370 Subcommands)SH 10 /Times-Italic AF 51775 XM (Page 25)SH 46800 50 8280 5709 UL 13 /Times-Bold AF 24059 8071 MT (The TDUMP Subcommand)SH 10 /Times-Roman AF 8280 10444 MT (Syntax:)SH /Courier SF 11936 XM (TDUMP)SH /Times-Italic SF 15536 XM (table-name or)350 W /Courier SF 22124 XM (NAMES)SH /Times-Italic SF 25724 XM (or)SH /Courier SF 27213 XM (TRACE)SH /Times-Roman SF 8280 12836 MT (This displays the contents of)8 W /Times-Italic SF 20014 XM (table-name)SH /Times-Roman SF (. The) 265 W( same table can be modified using the SET subcommand. The ATOE,)7 W 8280 14032 MT (ETOA, TATOE, and TETOA translation tables) 85 W( and the CONTROL-CHAR prefixing selection table can presently)86 W 8280 15228 MT (be displayed and changed.) 19 W( The) 286 W( NAMES table is the transaction log for the last transfer, consisting of the)18 W /Times-Italic SF 50924 XM (filespec)SH /Times-Roman SF 54247 XM (of)SH 8280 16424 MT (each file sent or received, along with the size \050in Kbytes\051) 42 W( and any error messages. If the Kermit TRACE facility is)43 W 8280 17620 MT (enabled, the TRACE table may be displayed \050and destroyed in the process\051. This table contains entries) 242 W( for)241 W 8280 18816 MT (subroutine calls and returns during) 32 W( program execution, but Kermit normally does not have the facility enabled. See)33 W 8280 20012 MT (SET DEBUG for more details on execution tracing.)SH 13 /Times-Bold AF 20880 23371 MT (The TYPE and XTYPE Subcommands)SH 10 /Times-Roman AF 8280 25744 MT (Syntax:)SH /Courier SF 11936 XM ([X]TYPE)SH /Times-Italic SF 16736 XM (filespec)SH /Times-Roman SF 8280 28136 MT (These subcommands display) 75 W( the named file. TYPE is effectively a synonym for \050and allows the same options as\051)74 W 8280 29332 MT (the host system command for displaying files at the terminal, but XTYPE performs a raw file transfer on) 19 W( the current)20 W 8280 30528 MT (communication line \050which need not be the terminal\051 according to the current CONTROLLER setting. Thus,)200 W 8280 31724 MT (XTYPE uses transparent mode if CONTROLLER) 120 W( is SERIES1, GRAPHICS, or AEA. Also, it sends the data in)121 W 8280 32920 MT (bursts no larger than the current) 66 W( SEND PACKET-SIZE. Since XTYPE is basically a modified SEND, the options)65 W 8280 34116 MT (allowed on the)SH /Times-Italic SF 14418 XM (filespec)SH /Times-Roman SF 17723 XM (for SEND are also allowed for XTYPE.)SH 13 /Times-Bold AF 23480 37475 MT (The VERSION Subcommand)SH 10 /Times-Roman AF 8280 39848 MT (Syntax:)SH /Courier SF 11936 XM (VERSION)SH /Times-Roman SF 8280 42240 MT (This subcommand displays the program version number and date.)SH 14 /Times-Bold AF 8280 45842 MT (1.5. Before Connecting to the Mainframe)SH 10 /Times-Roman AF 8280 47960 MT (Several options must) 100 W( be set in the micro Kermit before connecting to an IBM 370 system as a line-mode device.)101 W 8280 49156 MT (You should set LOCAL-ECHO to ON \050to indicate half-duplex\051.) 78 W( This) 404 W( is the norm but not true in absolutely every)77 W 8280 50352 MT (case; if each character appears twice on your terminal screen, set LOCAL-ECHO to OFF. FLOW-CONTROL)167 W 8280 51548 MT (should be set to NONE,) 141 W( and on some systems HANDSHAKE should be set to XON. The parity should be set)140 W 8280 52744 MT (according to the system's specifications.) 23 W( On) 298 W( some micro Kermits, all of the above is done in one step using the DO)24 W 8280 53940 MT (IBM macro \050or SET IBM ON\051. Set the baud rate to correspond to the line speed.)SH 8280 56332 MT (Connecting through a full-screen device also requires that certain options be) 2 W( set in the micro Kermit. You should set)1 W 8280 57528 MT (LOCAL-ECHO to OFF \050to indicate full-duplex\051. FLOW-CONTROL should be set) 397 W( to XON/XOFF, and)398 W 8280 58724 MT (HANDSHAKE should be set to OFF. For many systems, the PARITY should be) 23 W( set to EVEN. Set the baud rate to)22 W 8280 59920 MT (correspond to the line speed.)SH 8280 62312 MT (One exception to these rules is the case where the micro Kermit is attempting automated file transfer,)255 W /Times-Italic SF 53386 XM (e.g.)SH /Times-Roman SF (,)SH 8280 63508 MT (downloading several separate files from) 114 W( Kermit-370 running in server mode. In fact, under those circumstances,)113 W 8280 64704 MT (handshaking is necessary even with ``)81 W /Courier SF (SERIES1)SH /Times-Roman SF ('' connections, and the two Kermits must) 81 W( be instructed to adopt a)82 W 8280 65900 MT (common handshake character \050)106 W /Times-Italic SF (e.g.)SH /Times-Roman SF (, by SET HANDSHAKE 10 to Kermit-370 and) 106 W( SET HANDSHAKE LF to the)105 W 8280 67096 MT (micro\051.)SH 8280 69488 MT (In any case, you should make) 132 W( sure that either the micro Kermit or Kermit-370 will provide timeouts during file)133 W 8280 70684 MT (transfers \050if not both\051. Some variants of Kermit-370 \050notably CMS\051 cannot provide timeouts,) 45 W( and you may need to)44 W 8280 71880 MT (set the TIMER to ON in the micro.)SH ES %%Page: 26 27 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 26)SH 12 /Times-Bold AF 29885 XM (Kermit User's Guide: IBM 370 KERMIT 1.5)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (When you are connecting through) 36 W( a protocol convertor, it is useful to know the key sequence that causes the screen)37 W 6120 9082 MT (image to be repainted from the controller's memory. In many cases, it) 25 W( is CTRL-V, although CTRL-G and CTRL-C)24 W 6120 10278 MT (are also sometimes used. In general, this sequence should be) 144 W( typed whenever reconnecting to Kermit-370 after)145 W 6120 11474 MT (being in Kermit protocol mode) 94 W( \050and sometimes after merely escaping to the local Kermit\051, since the local Kermit)93 W 6120 12670 MT (may have modified the screen.)SH 14 /Times-Bold AF 6120 16272 MT (1.6. Trouble-shooting Protocol Converters)SH 10 /Times-Roman AF 6120 18390 MT (Many, but not all, protocol converters have transparent modes that) 168 W( permit Kermit file transfers. The welter of)169 W 6120 19586 MT (competing and often incompatible communications devices would cause a major headache,) 289 W( except for three)288 W 6120 20782 MT (circumstances. First,) 322 W( Kermit-370 has routines for automatically detecting which) 36 W( kind of front end is controlling the)37 W 6120 21978 MT (current session; second, the Kermit installer is encouraged to tailor Kermit) 327 W( to force the correct choice of)326 W /Courier SF 6120 23174 MT (CONTROLLER)SH /Times-Roman SF 12638 XM (whenever those routines don't work properly; and, third, Kermit offers a last-resort mode of)268 W 6120 24370 MT (operation that will work with almost any) 182 W( protocol converter. Because of the limitations in the catch-all mode)181 W 6120 25566 MT (\050known as)206 W /Courier SF 10920 XM (FULLSCREEN)SH /Times-Roman SF 17376 XM (mode\051, it) 206 W( is still best to take advantage of the transparency, if any, in the protocol)207 W 6120 26762 MT (converter, and the automatic detection routines still play an important role. It) 116 W( will be instructive to outline what)115 W 6120 27958 MT (those routines actually do and how they can go wrong.)SH 12 /Times-Bold AF 6120 30546 MT (Recognizing a Series/1)SH 10 /Times-Roman AF 6120 31960 MT (Although protocol) 31 W( converters are advertised as simulating the behavior of IBM 3270-type terminals, there generally)32 W 6120 33156 MT (are differences which could be used to distinguish each type of device) 138 W( from the others and from real 3270-type)137 W 6120 34352 MT (terminals. However,) 320 W( all that really matters) 35 W( to Kermit-370 is whether there is a transparent mode available such that)36 W 6120 35548 MT (file transfers can be carried out. To date, only three fundamentally different transparent modes have been reported)56 W 6120 36744 MT (to Columbia, and it seems likely that no others have been \050or, perhaps, ever will be\051 implemented. All are supported)7 W 6120 37940 MT (by Kermit.)SH 6120 40332 MT (Kermit-370 recognizes these front ends automatically by making) 35 W( two simple tests. The first takes advantage of one)34 W 6120 41528 MT (of the advanced features) 179 W( first implemented in the Yale ASCII system and subsequently copied in many of the)180 W 6120 42724 MT (devices that adopted the same transparent mode. This feature is a special 3270 data-stream order which requests) 59 W( a)58 W 6120 43920 MT (status report from the protocol converter. Kermit sends this order and then reads the "3270 screen". If Kermit sees) 1 W( a)2 W 6120 45116 MT (valid status report, it sets)SH /Courier SF 16342 XM (CONTROLLER)SH /Times-Roman SF 22592 XM (to)SH /Courier SF 23620 XM (SERIES1)SH /Times-Roman SF 28070 XM (and stops testing.)SH 12 /Times-Bold AF 6120 47704 MT (Two catches)SH 10 /Times-Roman AF 6120 49118 MT (Obviously, the Yale status order is not implemented in most) 116 W( other kinds of hardware. Thus, the order would be)115 W 6120 50314 MT (rejected by a non-Yale-type controller, and that could have undesirable side) 139 W( effects on the hardware. However,)140 W 6120 51510 MT (hardware is generally designed to be robust -- the real drawback) 64 W( lies in the side effects on certain communications)63 W 6120 52706 MT (software \050notably) 64 W( VTAM/TSO\051, which may respond badly while trying to protect the robust hardware from illegal)65 W 6120 53902 MT (orders. If) 618 W( it proves impossible to make the external software behave properly, the only) 184 W( recourse is to modify)183 W 6120 55098 MT (Kermit-370 to skip the first test altogether and possibly to force the)154 W /Courier SF 35132 XM (CONTROLLER)SH /Times-Roman SF 41537 XM (setting; this modification is)155 W 6120 56294 MT (described in the relevant "Beware" file in a note dated 89/2/27.)SH 6120 58686 MT (Catch Two) 21 W( is that the status order is not implemented in all of the devices that support Yale-ASCII-style transparent)20 W 6120 59882 MT (mode. This) 267 W( means that some devices "fall through the cracks" in this procedure. A site where such devices are used)9 W 6120 61078 MT (may find it expedient to modify Kermit \050following the same "Beware" pattern\051) 227 W( to force the procedure to set)226 W /Courier SF 6120 62274 MT (CONTROLLER)SH /Times-Roman SF 12485 XM (to)SH /Courier SF 13628 XM (SERIES1)SH /Times-Roman SF 18193 XM (\050assuming there are) 115 W( no other protocol converters also in use that support one of the)116 W 6120 63470 MT (other transparent modes\051. A list of such devices can be found in a footnote in the Kermit distribution file)250 W /Courier SF 6120 64666 MT (ik0aaa.hlp)SH /Times-Roman SF (.)SH ES %%Page: 27 28 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (1.6. Trouble-shooting Protocol Converters)SH 10 /Times-Italic AF 51775 XM (Page 27)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (Recognizing a 3174)SH 10 /Times-Roman AF 8280 9418 MT (The second diagnostic test) 135 W( uses a hardware command \050Read Partition Query\051 that is defined by IBM, but is not)136 W 8280 10614 MT (implemented on all 3270-type equipment. There is, thus, the) 27 W( same danger as in the first test, but the danger appears)26 W 8280 11810 MT (to be slight. Indeed, both CMS and TSO allow a user program to know in advance whether a) 70 W( Query is permitted.)71 W 8280 13006 MT (The Query response consists of one or more structured fields,) 50 W( and the 3174 AEA ASCII Graphics system \050the only)49 W 8280 14202 MT (device with the)45 W /Courier SF 14776 XM (AEA)SH /Times-Roman SF 16872 XM (style of transparency\051 is easily identified by the appearance and content of a particular type of)46 W 8280 15398 MT (field. In) 334 W( fact, it is possible to tell from the Query data whether the particular 3174 line is allowed to use the ASCII)41 W 8280 16594 MT (Graphics transparency. Therefore, this test has three possible outcomes: Kermit may detect a) 46 W( transparency-enabled)47 W 8280 17790 MT (3174 line \050and) 2 W( set)1 W /Courier SF 15674 XM (CONTROLLER)SH /Times-Roman SF 21925 XM (to)SH /Courier SF 22954 XM (AEA)SH /Times-Roman SF (\051; it may detect an incapable 3174 line \050and set)1 W /Courier SF 43705 XM (CONTROLLER)SH /Times-Roman SF 49956 XM (to)SH /Courier SF 50985 XM (NONE)SH /Times-Roman SF (\051; or)1 W 8280 18986 MT (it may detect "none of the above" \050and set)38 W /Courier SF 25629 XM (CONTROLLER)SH /Times-Roman SF 31917 XM (to)SH /Courier SF 32983 XM (GRAPHICS)SH /Times-Roman SF (\051. Thus,) 328 W( aside from the exceptions already)39 W 8280 20182 MT (noted,)SH /Courier SF 11002 XM (GRAPHICS)SH /Times-Roman SF 16052 XM (simply means that the front end either supports SAS-style transparency or none at all.)SH 12 /Times-Bold AF 8280 22770 MT (Fallback positions)SH 10 /Times-Roman AF 8280 24184 MT (What should you do when the automatic detection fails?) 154 W( Obviously,) 557 W( the first thing is Be Prepared. Often, the)153 W 8280 25380 MT (misbehavior of VTAM can be halted by pressing ENTER or PA1, so) 30 W( you should be sure to know how to generate a)31 W 8280 26576 MT (PA1 when trying out Kermit on an unfamiliar type of protocol) 132 W( converter. Also, you should know what kind of)131 W 8280 27772 MT (transparency to expect) 107 W( for the front end and verify that Kermit-370 has, in fact, set)108 W /Courier SF 43140 XM (CONTROLLER)SH /Times-Roman SF 49498 XM (appropriately.)SH 8280 28968 MT (This means checking the list of devices in) 19 W( the Kermit distribution file)18 W /Courier SF 36501 XM (ik0aaa.hlp)SH /Times-Roman SF (. If) 286 W( your configuration is listed)18 W 8280 30164 MT (as)SH /Times-Italic SF 9379 XM (un)SH /Times-Roman SF (supported, you may be wasting your time, but) 16 W( the list is not necessarily up-to-date. If your configuration is not)17 W 8280 31360 MT (listed at all, you have the opportunity to be a pioneer and report your findings) 103 W( back to Columbia for inclusion in)102 W 8280 32556 MT (future editions of the list. There are a few rules of) 83 W( thumb for quickly deducing the controller type by reading the)84 W 8280 33752 MT (manuals for the device; the manuals may not be specific enough, but this is clearly the) 69 W( easiest way of determining)68 W 8280 34948 MT (whether Kermit can support a) 112 W( given device and which controller type is applicable. The rules are as follows \050in)113 W 8280 36144 MT (order of simplicity and likelihood\051:)SH 10280 37935 MT (1.)SH 11280 XM (GRAPHICS or SERIES1 may be implied when the device has a transparent) 272 W( or graphics mode)271 W 11280 39040 MT (described as compatible with that of a supported device listed in)SH /Courier SF 37193 XM (ik0aaa.hlp)SH /Times-Roman SF (.)SH 10280 40698 MT (2.)SH 11280 XM (SERIES1 is implied when the device runs the "Yale ASCII Communication System" or something)142 W 11280 41803 MT (with a similar name.)SH 10280 43461 MT (3.)SH 11280 XM (GRAPHICS is implied if the manual mentions the SAS Institute in the context of ASCII graphics.)SH 10280 45119 MT (4.)SH 11280 XM (GRAPHICS is implied when output transparent data) 189 W( may be preceded by a WCC \050Write Control)188 W 11280 46224 MT (Character\051 and 70 \050hex\051.)SH 10280 47882 MT (5.)SH 11280 XM (SERIES1 is) 124 W( implied when transparent data must be preceded by a WCC and either 115D7F110005)125 W 11280 48987 MT (\050write-read\051 or 115D7F110000 \050write-only\051.)SH 10280 50645 MT (6.)SH 11280 XM (GRAPHICS or) 12 W( SERIES1 may be implied when some of the manufacturer's other products are listed in)11 W /Courier SF 11280 51750 MT (ik0aaa.hlp)SH /Times-Roman SF (, and all are shown as being of one type.)SH 10280 53408 MT (7.)SH 11280 XM (If none of the above rules apply, but the manuals describe a transparent mode in detail, the device) 14 W( may)15 W 11280 54513 MT (be a totally new type. The) 54 W( distribution file)53 W /Courier SF 29095 XM (ik0con.hlp)SH /Times-Roman SF 35398 XM (has hints on implementing Kermit support)53 W 11280 55618 MT (for the new type.)SH 10280 57276 MT (8.)SH 11280 XM (If nothing else works, you can probably use FULLSCREEN mode, as long as the micro Kermit)211 W 11280 58381 MT (supports it.)SH 8280 60773 MT (If Kermit tries to transfer a file with the wrong)22 W /Courier SF 27385 XM (CONTROLLER)SH /Times-Roman SF 33657 XM (value, there is a distressing possibility for) 22 W( the session)21 W 8280 61969 MT (to lock or, at least, appear to lock. When and if this happens, be sure to connect back) 154 W( to the mainframe, type)155 W 8280 63165 MT (``)SH /Courier SF (STOP)SH /Times-Roman SF ('', and press ENTER several) 198 W( times \050perhaps as many as 15 times\051 before taking any drastic steps like)197 W 8280 64361 MT (breaking the connection. ``)38 W /Courier SF (STOP)SH /Times-Roman SF ('' is) 38 W( a special escape mechanism for getting out of Kermit protocol mode quickly.)39 W 8280 65557 MT (Kermit-370 recognizes such a request in most situations where terminal I/O is not entirely frozen. Sometimes,)158 W 8280 66753 MT (apparent lock-ups are due) 61 W( to something as simple as incorrect parity settings in the micro Kermit, so always check)62 W 8280 67949 MT (the basic communication settings and, if necessary, experiment before trying a different)41 W /Courier SF 44098 XM (CONTROLLER)SH /Times-Roman SF 50389 XM (type. Also,)330 W 8280 69145 MT (to avoid unnecessary confusion, check for) 187 W( the existence of a Kermit initialization file \050possibly created by the)188 W 8280 70341 MT (installer\051 which could be re-setting)28 W /Courier SF 22612 XM (CONTROLLER)SH /Times-Roman SF 28890 XM (after the automatic procedure has finished. Such a re-setting is) 28 W( a)27 W 8280 71537 MT (poor idea in an initialization file, even a personal one,) 72 W( unless there is absolutely only one kind of communications)73 W ES %%Page: 28 29 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 28)SH 12 /Times-Bold AF 29885 XM (Kermit User's Guide: IBM 370 KERMIT 1.6)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (equipment on your system.)SH 6120 10278 MT (If file transfers do not work at first, it is best to do the following before trying again:)SH 8120 12069 MT (1.)SH 9120 XM (Reduce the packet size to no more than 80 at both ends.)SH 8120 14279 MT (2.)SH 9120 XM (Enable 8th-bit quoting at both ends.)SH 8120 16489 MT (3.)SH 9120 XM (Set)SH /Courier SF 10648 XM (SEND PARITY MARK)SH /Times-Roman SF 20498 XM (in Kermit-370.)SH 6120 18881 MT (If those changes do not make transfers work, the next remedial action depends on the symptoms of failure.)SH /Symbol SF 7910 20786 MT (\267)SH /Times-Roman SF 8620 XM (No packets exchanged and session locked up after reconnecting: change packet characters) 210 W( in both)209 W 8620 21891 MT (directions.)SH /Symbol SF 7910 23880 MT (\267)SH /Times-Roman SF 8620 XM (No packets exchanged, but no lockup: change packet characters or parity.)SH /Symbol SF 7910 25869 MT (\267)SH /Times-Roman SF 8620 XM (Always multiple retries of third or fourth packet: reduce receiving packet size.)SH /Symbol SF 7910 27858 MT (\267)SH /Times-Roman SF 8620 XM (Multiple retries after random number of packets: check hardware and cables.)SH /Symbol SF 7910 29847 MT (\267)SH /Times-Roman SF 8620 XM (Multiple retries after file-dependent number of packets: check for equipment that intercepts) 10 W( one or more)11 W 8620 30952 MT (printable characters or reduce the packet size.)SH 6120 33344 MT (When all else fails, you should be ready to) 7 W( reset)6 W /Courier SF 25601 XM (CONTROLLER)SH /Times-Roman SF 31857 XM (by hand and try again. The change most likely to be)6 W 6120 34540 MT (necessary is from)50 W /Courier SF 13518 XM (GRAPHICS)SH /Times-Roman SF 18618 XM (to)SH /Courier SF 19696 XM (SERIES1)SH /Times-Roman SF (. However,) 350 W( it is conceivable) 50 W( that the installer has modified Kermit-370)51 W 6120 35736 MT (at your location to force the)2 W /Courier SF 17463 XM (CONTROLLER)SH /Times-Roman SF 23715 XM (setting from the start, in which case, you might need to go the other way.)1 W 6120 36932 MT (Normally, Kermit's diagnostic procedure at start-up) 70 W( takes one or two seconds \050because of programmed delays\051, so)71 W 6120 38128 MT (you should be suspicious if the Kermit prompt appears immediately after you start the program.) 102 W( The) 452 W( only initial)101 W /Courier SF 6120 39324 MT (CONTROLLER)SH /Times-Roman SF 12400 XM (setting that you should)30 W /Times-Italic SF 21854 XM (not)SH /Times-Roman SF 23412 XM (change by hand is)30 W /Courier SF 30975 XM (NONE)SH /Times-Roman SF (, which) 30 W( means that Kermit-370 has recognized a)31 W 6120 40520 MT (3174 AEA line that is not configured for file transfer \050or else the Kermit installer has a warped sense of humor\051.)SH 6120 42912 MT (If no amount of experimenting gets a transparent mode to work, it is) 81 W( time to recheck the list of supported devices)80 W 6120 44108 MT (and the age of your equipment. If yours) 153 W( is very old, it may require new microcode or some other software or)154 W 6120 45304 MT (hardware upgrade. In any case, if your results \050whether positive or negative\051 are not already shown in)350 W /Courier SF 6120 46500 MT (ik0aaa.hlp)SH /Times-Roman SF (, you should report them to Columbia so that others may profit by your experience.)SH 14 /Times-Bold AF 6120 50102 MT (1.7. After Returning from Kermit-370)SH 10 /Times-Roman AF 6120 52220 MT (When Kermit-370 receives a QUIT or EXIT subcommand or finishes the subcommand or) SH( subcommands specified in)1 W 6120 53416 MT (the original command string that invoked Kermit, control is returned to) 115 W( the caller. Before returning, Kermit-370)114 W 6120 54612 MT (closes any active TAKE files \050the EXIT or QUIT) 76 W( subcommand may be issued from a TAKE file\051. On return, the)77 W 6120 55808 MT (completion code is set from the current error status according to the codes in Table 1-4.)SH 6120 58200 MT (The error codes in Table 1-4 bear no relationship to the severity of) 81 W( the associated error conditions, aside from the)80 W 6120 59396 MT (assignment of code 0. The underlying) 234 W( rationale is that the only current generic system for the treatment of)235 W 6120 60592 MT (completion codes is to take a non-zero code as an indication of error. Indeed, Kermit returns a) 11 W( completion code of 0)10 W 6120 61788 MT (when "error" condition 1 holds.)SH ES %%Page: 29 30 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (1.8. What's New)SH 10 /Times-Italic AF 51775 XM (Page 29)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 8280 34625 MT (21)SH 12600 XM (PTY)SH 18360 XM (8th-bit quote not set)SH 8280 35730 MT (22)SH 12600 XM (FTS)SH 18360 XM (File too short)SH 8280 36835 MT (23)SH 12600 XM (SOH)SH 18360 XM (Missing start-of-packet)SH 8280 37940 MT (24)SH 12600 XM (OPT)SH 18360 XM (Option error on filespec)SH 8280 39045 MT (25)SH 12600 XM (DSP)SH 18360 XM (Unable to dispose of file)SH /Times-Bold SF 20904 40655 MT (Table 1-4:)SH /Times-Roman SF 25765 XM (Error messages and codes for Kermit-370)SH 46800 50 8280 43989 UL 14 /Times-Bold AF 8280 47391 MT (1.8. What's New)SH 10 /Times-Roman AF 8280 49509 MT (Below is a list of the changes in Version 4.3 of Kermit-370.)SH 10280 51300 MT (1.)SH 11280 XM (Compatibility with the \050aging\051 F-level assembler.)SH 10280 52958 MT (2.)SH 11280 XM (Support for LATIN2, LATIN3, TRANSPARENT, CP870, CP905, and) 89 W( CP880, as well as the aliases)90 W 11280 54063 MT (L1, L2, and L3. New alias CP1047 for EBCDIC.)SH 10280 55721 MT (3.)SH 11280 XM (Support for IBM 3174 ASCII Graphics mode.)SH 10280 57379 MT (4.)SH 11280 XM (Improved controller detection, including local customization options.)SH 10280 59037 MT (5.)SH 11280 XM (Support for new unprefixed transmission of selected control characters.)SH 10280 60695 MT (6.)SH 11280 XM (Support for REMOTE PRINT, REMOTE MAIL, and REMOTE SUBMIT.)SH 10280 62353 MT (7.)SH 11280 XM (Improved error message for bad packet-size, new alias PACKET-LENGTH for PACKET-SIZE.)SH 10280 64011 MT (8.)SH 11280 XM (Correct observance of FILE COLLISION for all files in a group.)SH 10280 65669 MT (9.)SH 11280 XM (Ignoring spurious flow-control "packets" from \050for example\051 MS-Kermit.)SH 9780 67327 MT (10.)SH 11280 XM (Support for new locking-shift Kermit protocol.)SH 9780 68985 MT (11.)SH 11280 XM (Support for Japanese Kanji file transfer and support for the Thai and Arabic character sets.)SH 9780 70643 MT (12.)SH 11280 XM (New versions of Kermit with the interactive messages in languages other than English.)SH ES %%Page: 30 31 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 30)SH 12 /Times-Bold AF 29885 XM (Kermit User's Guide: IBM 370 KERMIT 1.8)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 7620 7886 MT (13.)SH 9120 XM (New FULLSCREEN controller type.)SH 7620 9544 MT (14.)SH 9120 XM (New HINTS subcommand.)SH 7620 11202 MT (15.)SH 9120 XM (More graceful recovery from terminal I/O errors and exceptions.)SH 7620 12860 MT (16.)SH 9120 XM (Support for SNA LU1 3770-type devices and 8-bit, no-parity devices.)SH 7620 14518 MT (17.)SH 9120 XM (Optional conversion of EBCDIC printer carriage control into ASCII control characters.)SH 7620 16176 MT (18.)SH 9120 XM (Support for STOP command on "dumb" 3270 terminals and PCI protocol converters.)SH 7620 17834 MT (19.)SH 9120 XM (New efficiency display in STATUS report, based on SPEED setting.)SH 7620 19492 MT (20.)SH 9120 XM (New, uniform messages upon entering protocol mode, in the) 85 W( form "KERMIT READY TO SEND...")84 W 9120 20597 MT (\050or RECEIVE or SERVE\051.)SH 7620 22255 MT (21.)SH 9120 XM (8-bit XECHO output.)SH 7620 23913 MT (22.)SH 9120 XM (Control prefixing for C1 controls.)SH 7620 25571 MT (23.)SH 9120 XM (New VERSION subcommand.)SH 7620 27229 MT (24.)SH 9120 XM (Improved debugging facilities.)SH 14 /Times-Bold AF 6120 30831 MT (1.9. What's Missing)SH 10 /Times-Roman AF 6120 32949 MT (Work on Kermit-370 will continue. Features that need to be improved or added include:)SH /Symbol SF 7910 34854 MT (\267)SH /Times-Roman SF 8620 XM (Implement file archiving.)SH /Symbol SF 7910 36843 MT (\267)SH /Times-Roman SF 8620 XM (Implement file transfer checkpointing.)SH /Symbol SF 7910 38832 MT (\267)SH /Times-Roman SF 8620 XM (Add SET REPEAT subcommand.)SH /Symbol SF 7910 40821 MT (\267)SH /Times-Roman SF 8620 XM (Improve Kermit-370 operation as a local Kermit.)SH /Symbol SF 7910 42810 MT (\267)SH /Times-Roman SF 8620 XM (Implement public server mode.)SH /Symbol SF 7910 44799 MT (\267)SH /Times-Roman SF 8620 XM (Allow REMOTE KERMIT HELP, REMOTE KERMIT DIR, and REMOTE SET from a micro.)SH /Symbol SF 7910 46788 MT (\267)SH /Times-Roman SF 8620 XM (Add new SET FILE LONGLINE DISCARD option to allow multi-file transfer to proceed) 228 W( past a)229 W 8620 47893 MT (truncation problem.)SH /Symbol SF 7910 49882 MT (\267)SH /Times-Roman SF 8620 XM (System-specific upgrades; see the respective chapters for details.)SH 6120 52274 MT (Anyone interested in) 259 W( working on these or other improvements should first get in touch with the Center for)258 W 6120 53470 MT (Computing Activities at Columbia University to find out if someone else has already) 15 W( begun a similar project \050and, if)16 W 6120 54666 MT (so, who\051.)SH 14 /Times-Bold AF 6120 58268 MT (1.10. Further Reading)SH 10 /Times-Roman AF 6120 60386 MT (Below is a list of references for some of the material in this chapter.)SH 8120 62177 MT (1.)SH /Times-Italic SF 9120 XM (About Type: IBM's Technical) 216 W( Reference for 240-Pel Digitized Type)215 W /Times-Roman SF (, S544-3156-02 \0501989\051. This)215 W 9120 63282 MT (manual contains visual) 160 W( tables of many EBCDIC code pages and a comprehensive list of character)161 W 9120 64387 MT (names and acronyms.)SH 8120 66045 MT (2.)SH /Times-Italic SF 9120 XM (IBM System/370 Reference Summary)132 W /Times-Roman SF (, GX20-1850-3 \0501976\051. This reference) 132 W( card contains EBCDIC)131 W 9120 67150 MT (and ASCII character codes.)SH 8120 68808 MT (3.)SH /Times-Italic SF 9120 XM (IBM VS Fortran Application Programming: Language Reference)55 W /Times-Roman SF (, GC26-3986-1 \0501982\051. Appendix E)56 W 9120 69913 MT (contains a table of EBCDIC and ASCII characters with an implied full 256-byte translation table.)SH 8120 71571 MT (4.)SH /Times-Italic SF 9120 XM (IBM 3174 Character Set Reference)46 W /Times-Roman SF (, GA27-3831-02 \0501990\051. Chapter 5 contains) 46 W( visual tables of many)45 W ES %%Page: 31 32 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (1.10. Further Reading)SH 10 /Times-Italic AF 51775 XM (Page 31)SH 46800 50 8280 5709 UL /Times-Roman SF 11280 7886 MT (EBCDIC code pages.)SH 10280 9544 MT (5.)SH /Times-Italic SF 11280 XM (Info-Kermit Digest)251 W /Times-Roman SF 19615 XM (Vol. 11 #1 \0501989\051. This issue contains draft specifications of some Kermit)252 W 11280 10649 MT (protocol extensions.)SH 10280 12307 MT (6.)SH /Times-Italic SF 11280 XM (ISO International Register of) 84 W( Coded Character Sets to be used with Escape Sequences)83 W /Times-Roman SF 47220 XM (\0501989\051. This)416 W 11280 13412 MT (\050very large\051 document has complete and unambiguous descriptions of standard coded character) 8 W( sets. It)9 W 11280 14517 MT (can be obtained from the ECMA.)SH 10280 16175 MT (7.)SH /Times-Italic SF 11280 XM (Kermit, A File Transfer Protocol)203 W /Times-Roman SF 25740 XM (by Frank da Cruz; Digital Press \0501987\051. This book) 203 W( contains a)202 W 11280 17280 MT (thorough description of the Kermit protocol and services with copious examples.)SH 10280 18938 MT (8.)SH 11280 XM (Kermit distribution file ISOK7.TXT \0501992\051.) 298 W( This) 848 W( preliminary draft describes the new transfer)299 W 11280 20043 MT (protocol, including the international character-set support.)SH 10280 21701 MT (9.)SH /Times-Italic SF 11280 XM (Kermit News)255 W /Times-Roman SF 17235 XM (Vol. 3 #1, p.5, "Dynamic Packet Size Control" \0501988\051.) 255 W( This) 759 W( article describes an)254 W 11280 22806 MT (algorithm for optimizing Kermit throughput in the face of line noise.)SH 9780 24464 MT (10.)SH /Times-Italic SF 11280 XM (Kermit News)90 W /Times-Roman SF 16905 XM (#4, p.16, "International Character Sets") 90 W( \0501990\051. This article discusses the new transfer)91 W 11280 25569 MT (protocol.)SH 9780 27227 MT (11.)SH /Times-Italic SF 11280 XM (ASCII and EBCDIC Character Set and Code) 153 W( Issues in Systems Applications Architecture)152 W /Times-Roman SF (, SHARE)152 W 11280 28332 MT (white paper by) 267 W( Edwin Hart \0501989\051. This document, available as file SHARE REQUIRE from)268 W 11280 29437 MT (LISTSERV@JHUVM, lays out general considerations for character codes and translatability.)SH 9780 31095 MT (12.)SH 11280 XM (Kermit distribution file LSHIFT.TXT \0501991\051. This file describes the new protocol extension) 14 W( for better)13 W 11280 32200 MT (compression of 8th-bit text on 7-bit channels.)SH ES %%Page: 32 33 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 32)SH 12 /Times-Bold AF 30785 XM (Kermit User's Guide: IBM 370 KERMIT 2)SH 46800 50 6120 5709 UL ES %%Page: 33 34 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (2. IBM CICS KERMIT)SH 10 /Times-Italic AF 51775 XM (Page 33)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 8280 8272 MT (2. IBM CICS KERMIT)SH 10 /Times-Italic AF 8280 10566 MT (Program:)SH /Times-Roman SF 15780 XM (John Chandler \050Harvard/Smithsonian Center for) 489 W( Astrophysics\051; contributions from Va)490 W /Times-Accent SF (g)SH /Times-Roman SF (e)SH 15780 11671 MT (Kundak)SH /Times-Accent SF (g)SH /Times-Roman SF (i and Daphne Tzoar \050Columbia U\051, Brian Lesser \050U. New Brunswick\051,) 107 W( Carrie Ledford)106 W 15780 12776 MT (\050Miami U.\051, Jeff Huestis \050Washington U.\051, Wayne) 208 W( Mery \050Lehigh U.\051, ICSTI, Pierre Goyette)209 W 15780 13881 MT (\050McGill U.\051, Clark Frazier \050Harvard Bus. Sch.\051, Bob Bolch \050Triangle\051, Andr)SH /Times-Accent SF (h)SH /Times-Roman SF 46968 XM (Pirard \050U. Li)SH /Times-Accent SF (k)SH /Times-Roman SF (ge\051)SH /Times-Italic SF 8280 14986 MT (Language:)SH /Times-Roman SF 15780 XM (IBM/370 Assembler)SH /Times-Italic SF 8280 16091 MT (Documentation:)SH /Times-Roman SF 15780 XM (John Chandler \050CfA\051)SH /Times-Italic SF 8280 17196 MT (Version:)SH /Times-Roman SF 15780 XM (4.3.0 \05093/9/30\051)SH /Times-Italic SF 8280 18301 MT (Date:)SH /Times-Roman SF 15780 XM (1993 September)SH 12 /Times-Bold AF 8280 20889 MT (Kermit-CICS Capabilities At A Glance:)SH 10 /Times-Roman AF 9280 22680 MT (Local operation:)SH 32320 XM (Yes)SH 9280 23785 MT (Remote operation:)SH 32320 XM (Yes)SH 9280 24890 MT (Transfers text files:)SH 32320 XM (Yes)SH 9280 25995 MT (Transfers binary files:)SH 32320 XM (Yes)SH 9280 27100 MT (Wildcard send:)SH 32320 XM (Yes)SH /Courier SF 9280 28205 MT (^X/^Z)SH /Times-Roman SF 12530 XM (interruption:)SH 32320 XM (Yes \050through micro\051)SH 9280 29310 MT (Filename collision avoidance:)SH 32320 XM (Yes)SH 9280 30415 MT (Can time out:)SH 32320 XM (No)SH 9280 31520 MT (8th-bit prefixing:)SH 32320 XM (Yes)SH 9280 32625 MT (Repeat count prefixing:)SH 32320 XM (Yes)SH 9280 33730 MT (Alternate block checks:)SH 32320 XM (Yes)SH 9280 34835 MT (Terminal emulation:)SH 32320 XM (No)SH 9280 35940 MT (Communication settings:)SH 32320 XM (No)SH 9280 37045 MT (Transmit BREAK:)SH 32320 XM (No)SH 9280 38150 MT (Packet logging:)SH 32320 XM (Yes)SH 9280 39255 MT (Transaction logging:)SH 32320 XM (Yes)SH 9280 40360 MT (Session logging:)SH 32320 XM (No)SH 9280 41465 MT (Raw transmit:)SH 32320 XM (Yes \050no prompts\051)SH 9280 42570 MT (Sliding window:)SH 32320 XM (No)SH 9280 43675 MT (Long packets:)SH 32320 XM (Yes)SH 9280 44780 MT (Act as server:)SH 32320 XM (Yes)SH 9280 45885 MT (Talk to server:)SH 32320 XM (Yes)SH 9280 46990 MT (Advanced server functions:)SH 32320 XM (Yes)SH 9280 48095 MT (Advanced commands for servers:)SH 32320 XM (Yes)SH 9280 49200 MT (Local file management:)SH 32320 XM (Yes)SH 9280 50305 MT (Handle Attribute Packets:)SH 32320 XM (Yes)SH 9280 51410 MT (Command/init files:)SH 32320 XM (Yes)SH 9280 52515 MT (Command macros:)SH 32320 XM (No)SH 12 /Times-Bold AF 8280 55103 MT (CICS Specifics of Kermit-370:)SH 10 /Times-Roman AF 9280 56894 MT (Global INIT file:)SH /Courier SF 32320 XM (KSYS.TD)SH /Times-Roman SF 9280 57999 MT (User INIT file:)SH /Courier SF 32320 XM (KINIT.TAKE)SH /Times-Roman SF 9280 59104 MT (Debug packet log:)SH /Courier SF 32320 XM (KLOG)SH /Times-Italic SF (term)SH /Courier SF (.TS)SH /Times-Roman SF 9280 60209 MT (Server reply log:)SH /Courier SF 32320 XM (KREP)SH /Times-Italic SF (term)SH /Courier SF (.TS)SH /Times-Roman SF 9280 61314 MT (Mail command:)SH /Courier SF 32320 XM (KERMAIL R\050_...\051)SH /Times-Italic SF 41920 XM (filespec)SH /Courier SF 45575 XM (LIST\050)SH /Times-Italic SF (users)SH /Courier SF (\051)SH /Times-Roman SF 9280 62419 MT (Print command:)SH /Courier SF 32320 XM (KERMPRT R\050_...\051)SH /Times-Italic SF 41920 XM (filespec)SH /Courier SF 45575 XM (OPTIONS\050)SH /Times-Italic SF (options)SH /Courier SF (\051)SH /Times-Roman SF 9280 63524 MT (Submit command:)SH /Courier SF 32320 XM (KERMSUB R\050_...\051)SH /Times-Italic SF 41920 XM (filespec)SH /Courier SF 45575 XM (OPTIONS\050)SH /Times-Italic SF (options)SH /Courier SF (\051)SH /Times-Roman SF 9280 64629 MT (Maximum packet size:)SH 32320 XM (1913 \050SERIES1\051, 1024 \050TTY\051)SH 9280 65734 MT (Maximum disk LRECL:)SH 32320 XM (32767)SH 8280 68126 MT (Kermit-CICS is a member of the generic) 61 W( Kermit-370 family and shares most of the features and capabilities of the)60 W 8280 69322 MT (group. As) 308 W( its name implies, Kermit-CICS is the variant of Kermit-370 that runs under CICS. As much as possible,)29 W 8280 70518 MT (it is designed to) 17 W( be independent of the operating system that runs CICS, but only on IBM-370-compatible machines.)16 W 8280 71714 MT (The primary documentation for Kermit-CICS) 162 W( is actually the chapter on Kermit-370 \050entitled IBM 370 Kermit\051,)163 W ES %%Page: 34 35 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 34)SH 12 /Times-Bold AF 29719 XM (Kermit User's Guide: IBM CICS KERMIT 2)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (which describes general properties; the present chapter assumes the reader) 71 W( is familiar with that material. Only the)70 W 6120 9082 MT (details specific to CICS operation will be discussed here,)124 W /Times-Italic SF 30289 XM (e.g.)SH /Times-Roman SF (, command syntax relating to CICS data) 124 W( objects or)125 W 6120 10278 MT (commands not offered in general by Kermit-370.)SH 14 /Times-Bold AF 6120 13880 MT (2.1. CICS Data Objects)SH 10 /Times-Roman AF 6120 15998 MT (Unlike other environments for Kermit-370, CICS is not really an operating) 51 W( system and does not have anything that)50 W 6120 17194 MT (can be called a file) 221 W( system. Nonetheless, CICS supports a variety of data objects that can be called "files".)222 W 6120 18390 MT (Moreover, Kermit-CICS itself maintains a) 304 W( Kermit-only collection of storage organized into user directories.)303 W 6120 19586 MT (Furthermore, Kermit) 242 W( simulates a set of CICS file-maintenance commands: DIRECTORY, TYPE, COPY, and)243 W 6120 20782 MT (DELETE. Thus,) 290 W( for the purposes of Kermit, we may speak of a "CICS file system". The features) 20 W( of the file system)19 W 6120 21978 MT (of greatest interest to Kermit users are the supported types of data) 185 W( object, the format of file specifications \050or)186 W /Times-Italic SF 6120 23174 MT (filespecs)SH /Times-Roman SF (\051, and the concept of records. The latter is described in the Kermit-370 chapter.)SH 6120 25566 MT (As of this writing, Kermit-CICS supports three different) 208 W( types of data object: temporary storage \050TS\051 queues,)207 W 6120 26762 MT (transient data \050TD\051 queues,) 22 W( and Kermit-managed directory members. The first two are standard CICS objects while)23 W 6120 27958 MT (the third is a special kind of object designed for small, personalized, infrequently used, quasi-permanent files,) 54 W( such)53 W 6120 29154 MT (as on-line help files and individual Kermit initialization files. In principle, Kermit also supports) 70 W( three other types,)71 W 6120 30350 MT (but the support is provided through an) 5 W( interface to external programs, only one of which has yet been written. These)4 W 6120 31546 MT (other types are non-TD pipes, spool files, and native) 44 W( OS data sets. No external drivers are included in the standard)45 W 6120 32742 MT (distribution.)SH 6120 35134 MT (The CICS)SH /Times-Italic SF 10398 XM (filespec)SH /Times-Roman SF 13703 XM (takes one of two forms:)SH /Courier SF 8520 36789 MT ([fileclass/]filename[.filetype])SH /Times-Roman SF 6120 38091 MT (or)SH /Courier SF 8520 39331 MT ('qualified.file.name)SH /Times-Roman SF 6120 41048 MT (The first form represents a "normal" CICS data object while the second is the means) 61 W( of specifying a data object in)60 W 6120 42244 MT (the native) 110 W( operating system that supports CICS. In the first form, the optional fileclass is a string of up to eight)111 W 6120 43440 MT (characters. The) 343 W( filename is the primary identifier for the file, but the formats of both the fileclass and the filename)46 W 6120 44636 MT (depend on) 81 W( the filetype. The latter must be one of a small set of supported types: PGM, SPOOL, TAKE, TD, TS,)82 W 6120 45832 MT (TSAUX or TSMAIN. The last two are) 37 W( alternates for TS and are intended for specifying the type of storage desired)36 W 6120 47028 MT (for a new) 62 W( TS queue. The default is Auxiliary storage. Any of the three types will serve equally well to identify a)63 W 6120 48224 MT (queue that already exists. With filetypes ``)196 W /Courier SF (TD)SH /Times-Roman SF ('' and ``)196 W /Courier SF (TQ)SH /Times-Roman SF ('', the) 196 W( fileclass is meaningless but may be specified)195 W 6120 49420 MT (anyway.)SH 6120 51812 MT (Kermit-CICS supplies a default filetype of ``)154 W /Courier SF (TS)SH /Times-Roman SF ('' for any received file if no filetype is provided) 154 W( by the remote)155 W 6120 53008 MT (system. If) 298 W( no filename is supplied either, Kermit invents one by concatenating the letter ``)24 W /Courier SF (K)SH /Times-Roman SF ('', a) 24 W( three-digit number,)23 W 6120 54204 MT (and the user's four-character CICS terminal id. In any case, Kermit forces the filename to conform to) 7 W( CICS rules by)8 W 6120 55400 MT (truncating it, if necessary, to eight characters \050four for a TD queue\051. Also, Kermit converts any lower-case) 18 W( letters to)17 W 6120 56596 MT (upper case. Kermit-CICS supports a special file naming construct for TS queues. If) 52 W( the string ";;;;" appears in the)53 W 6120 57792 MT (name given to Kermit, that is replaced by the) 80 W( terminal id of the current session. This is useful for avoiding name)79 W 6120 58988 MT (conflicts when two or more users are running Kermit at the same time.) 83 W( The) 417 W( special string may also be set to any)84 W 6120 60184 MT (other desired four-byte) 72 W( string, simply by changing the definition of variable symbol &KTRMS in the source code.)71 W 6120 61380 MT (The string should not contain any reserved characters,) 57 W( such as Asterisk, Percent, Period, Slash, Less-than, Comma,)58 W 6120 62576 MT (or Blank, and should not begin with quasi-reserved characters such as Apostrophe or Question mark.)SH 6120 64968 MT (Filetype ``)5 W /Courier SF (TD)SH /Times-Roman SF ('' refers to any kind of transient data queue. TD queues are much like files in a true file system, except)5 W 6120 66164 MT (for two important features: TD queues are permanent) 7 W( data objects \050despite the transience of the data\051, and there is no)8 W 6120 67360 MT (straightforward means of determining how much) 60 W( storage a given TD queue occupies. These two features combine)59 W 6120 68556 MT (to defeat the provisions) 237 W( made by Kermit for handling filename collision \050see SET FILE COLLISION in the)238 W 6120 69752 MT (Kermit-370 chapter\051.) 179 W( Intra-partition) 606 W( queues, at least, have an associated number of queued records, but output)178 W 6120 70948 MT (extra-partition queues do not and therefore must always be presumed to contain data,)9 W /Times-Italic SF 40509 XM (i.e.)SH /Times-Roman SF (, to exist in a real sense. Of)10 W ES %%Page: 35 36 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (2.1. CICS Data Objects)SH 10 /Times-Italic AF 51775 XM (Page 35)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (course, all TD queues exist insofar as they are pre-defined in the CICS DCT, but the intent of) 60 W( the default filename)59 W 8280 9082 MT (collision handling is to protect data from erasure.) 41 W( Thus,) 333 W( Kermit-CICS will not normally write an uploaded file into)42 W 8280 10278 MT (an output extra-partition TD queue at all.) 10 W( Because) 269 W( of the filename collision, the file would be written to a TS queue,)9 W 8280 11474 MT (according to the) 24 W( algorithm described under SET FILE COLLISION in this chapter. The only way of uploading to a)25 W 8280 12670 MT (TD queue is to change the COLLISION setting to APPEND or OVERWRITE. Another) 51 W( effect of the non-dynamic)50 W 8280 13866 MT (quality of TD queues is that Kermit, when presented) 23 W( with an undefined TD queue name for an uploaded file, cannot)24 W 8280 15062 MT (create the missing queue. Thus, it must behave as if there were a) 72 W( filename collision and find an alternate place to)71 W 8280 16258 MT (store the file. However, if COLLISION were not set to RENAME, Kermit would) 29 W( not even check for collisions, but)30 W 8280 17454 MT (would simply attempt to write to the undefined queue and stop the file transfer because of the resulting I/O error.)SH 8280 19846 MT (Because TD queues are system-wide) 91 W( resources available to all users, data could be destroyed or confused if more)90 W 8280 21042 MT (than one user attempted to) 134 W( read or write the same queue at once. To prevent that, Kermit-CICS uses the CICS)135 W 8280 22238 MT (ENQUEUE command with a resource name equal to the name of the TD queue and gives up if the resource is) 32 W( busy)31 W 8280 23434 MT (for three consecutive seconds of waiting.)SH 8280 25826 MT (Filetype ``)129 W /Courier SF (PGM)SH /Times-Roman SF ('' specifies a pipe managed by a CICS program whose name is the filename. Such a program) 129 W( is)130 W 8280 27022 MT (invoked to open the pipe, then successively to read or write, and) 41 W( finally to close the pipe. A single program can be)40 W 8280 28218 MT (written to manage both input and output, even perhaps both at the same time.) 51 W( The) 354 W( optional fileclass in the)52 W /Times-Italic SF 52025 XM (filespec)SH /Times-Roman SF 8280 29414 MT (may be used by the program for any desired purpose. See the installation guide for details about writing such) 114 W( a)113 W 8280 30610 MT (program.)SH 8280 33002 MT (Filetype ``)23 W /Courier SF (SPOOL)SH /Times-Roman SF ('' represents a special) 23 W( type of pipe. The filename gives the name of the desired spool file, and the)24 W 8280 34198 MT (program to be invoked is IKXDYNAL. The optional fileclass is the spool class.)SH 8280 36590 MT (Filetype ``)80 W /Courier SF (TAKE)SH /Times-Roman SF ('' denotes a Kermit-managed directory member.) 80 W( Note) 408 W( that this filetype is not reserved for TAKE)79 W 8280 37786 MT (files, even though directory storage is the logical place to keep most TAKE files. Throughout this chapter, as in) 25 W( the)26 W 8280 38982 MT (other chapters on Kermit-370, the) 189 W( term "TAKE file" will always mean a file containing Kermit subcommands)188 W 8280 40178 MT (suitable for execution via the TAKE subcommand,) 77 W( regardless of the filetype. Data objects with filetype ``)78 W /Courier SF (TAKE)SH /Times-Roman SF ('')SH 8280 41374 MT (will be called "directory members",) 93 W( regardless of the purpose of those objects. The fileclass, if any, specifies the)92 W 8280 42570 MT (directory name \050either ``)135 W /Courier SF (0000)SH /Times-Roman SF ('' to select the common directory or) 135 W( a userid to select a personal directory\051. The)136 W 8280 43766 MT (default directory name is ``)148 W /Courier SF (*)SH /Times-Roman SF ('', which represents the userid of the current session. Userids in Kermit-CICS) 148 W( are)147 W 8280 44962 MT (determined according to an algorithm chosen as part of the) 103 W( installation process \050)104 W /Times-Italic SF (e.g.)SH /Times-Roman SF (, the CICS operator id\051. The)104 W 8280 46158 MT (filename of a member specifies that member within) 103 W( the given directory. Obviously, distinct members having the)102 W 8280 47354 MT (same filename may exist simultaneously in different directories. In short,) 22 W( this Kermit-managed storage comes close)23 W 8280 48550 MT (to being a real file system, aside from the limitation to) 111 W( the single filetype ``)110 W /Courier SF (TAKE)SH /Times-Roman SF (''. For) 470 W( this reason, the Kermit)110 W 8280 49746 MT (concept of the "working directory" is implemented in Kermit-CICS primarily as the) 142 W( current directory associated)143 W 8280 50942 MT (with filetype ``)40 W /Courier SF (TAKE)SH /Times-Roman SF (''. However,) 330 W( there is an alternate use of the "working directory" concept, namely, to specify a)39 W 8280 52138 MT (default prefix for Qualified File Names \050QFN's\051. Selecting a "directory") 171 W( name that begins with an apostrophe)172 W 8280 53334 MT (establishes that string as a QFN prefix for subsequent)93 W /Times-Italic SF 30753 XM (filespecs)SH /Times-Roman SF 34540 XM (given to Kermit-CICS. See the description of the)92 W 8280 54530 MT (CWD subcommand in this chapter for more details about "working directories".)SH 8280 56922 MT (Despite the apparent convenience and privacy of Kermit directory members, these objects are not intended for)180 W 8280 58118 MT (routine file transfers, but) 58 W( only for small, quasi-permanent files. The implementation makes use of a VSAM KSDS)57 W 8280 59314 MT (for storing the members and is geared entirely toward simplicity, rather than efficiency. Thus, each record of a)133 W 8280 60510 MT (directory member) 109 W( is a separate record in the KSDS identified by a human-readable 17-byte key consisting of the)108 W 8280 61706 MT (directory name, the member name, and the record number. Reading or writing a large member) 213 W( could tie up)214 W 8280 62902 MT (significant amounts of system resources. To ensure that) 51 W( users respect the restriction on directory members, Kermit)50 W 8280 64098 MT (imposes a two-tiered quota on each directory. If the first) 65 W( limit is exceeded, no further members may be created in)66 W 8280 65294 MT (the offending directory until enough space has been freed by deleting members. If the) 110 W( second limit is exceeded,)109 W 8280 66490 MT (Kermit will stop writing to the new member immediately and) 66 W( will give a "disk full" error indication. These limits)67 W 8280 67686 MT (apply equally to all directories. The limits in the standard version of Kermit-CICS are 100,000 and 150,000) 54 W( bytes,)53 W 8280 68882 MT (respectively, but each installation is free to establish its own limits.)SH 8280 71274 MT (To provide compatibility with other operating systems, when Kermit-CICS sends a file,) 102 W( it ordinarily makes a file)103 W ES %%Page: 36 37 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 36)SH 12 /Times-Bold AF 28819 XM (Kermit User's Guide: IBM CICS KERMIT 2.1)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (header with only the filename and filetype. However, extra information) 246 W( may be added by way of the SET)245 W 6120 9082 MT (FOREIGN subcommand. In the case of a QFN, the last two tokens of the name are used for sending.)SH 6120 11474 MT (CICS allows a group of files to be specified) 42 W( in a single)43 W /Times-Italic SF 28737 XM (filespec)SH /Times-Roman SF 32085 XM (by including the special "wildcard" characters ``)43 W /Courier SF (*)SH /Times-Roman SF ('')SH 6120 12670 MT (and ``)108 W /Courier SF (%)SH /Times-Roman SF (''. A) 466 W( ``)108 W /Courier SF (*)SH /Times-Roman SF ('' matches any string of characters \050even a) 108 W( null string\051 within the filename; a ``)107 W /Courier SF (%)SH /Times-Roman SF ('' matches any)107 W 6120 13866 MT (single character. Here are some examples:)SH /Courier SF 7120 15657 MT (*.TS)SH /Times-Roman SF 15120 XM (All TS queues currently in CICS.)SH /Courier SF 7120 17315 MT (F*.TD)SH /Times-Roman SF 15120 XM (All TD queues whose names start with F.)SH /Courier SF 7120 18973 MT (0000/%%.TAKE)SH /Times-Roman SF 15120 XM (All system directory members with two-character names.)SH 6120 21365 MT (CICS files,) 223 W( like those in other IBM 370 systems, are record-oriented \050see the introduction to the Kermit-370)224 W 6120 22561 MT (chapter\051. In) 564 W( particular, CICS files are characterized by record format) 157 W( \050RECFM\051, which may be fixed-length or)156 W 6120 23757 MT (varying-length, and by record length \050LRECL\051. Extra-partition TD queues are the only currently supported type) 47 W( of)48 W 6120 24953 MT (file that may have fixed-length records.) 10 W( An) 268 W( important point to note is that records being written to a RECFM V data)9 W 6120 26149 MT (object are generally not limited in length) 101 W( by the current LRECL, but only by the CICS Kermit maximum \05032767)102 W 6120 27345 MT (bytes\051. This) 314 W( is true of directory members and TS and intra-partition TD queues, but other limits may apply) 32 W( to other)31 W 6120 28541 MT (data objects.)SH 6120 30933 MT (When sending files, Kermit-CICS includes a date/time attribute if available.) 83 W( However,) 418 W( any date attribute of a file)84 W 6120 32129 MT (received into CICS is merely checked for validity and then discarded.)SH 6120 34521 MT (Another file system feature of) 19 W( occasional interest is the means of reporting errors. When Kermit-CICS encounters a)18 W 6120 35717 MT (file I/O error, it records) 14 W( the function name and the error code from EIBRCODE for inclusion in the STATUS report.)15 W 6120 36913 MT (The explanations of) 104 W( EIBRCODE can be found in Appendix A of the CICS command-level reference manual. In)103 W 6120 38109 MT (some cases, however, Kermit will report an) 4 W( error code for an operation not directly performed by CICS. These extra)5 W 6120 39305 MT (codes have not been defined, since they would result from operations on as-yet-unsupported filetypes.)SH 14 /Times-Bold AF 6120 42907 MT (2.2. Program Operation)SH 10 /Times-Roman AF 6120 45025 MT (Kermit-CICS is a conversational transaction. Thus, when it starts up, it allocates and initializes buffers) 41 W( and storage)40 W 6120 46221 MT (arrays. In) 794 W( addition, to provide for site-) 272 W( and user-specific environments, it looks for two initialization files,)273 W /Courier SF 6120 47417 MT (KSYS.TD)SH /Times-Roman SF 10578 XM (and)SH /Courier SF 12280 XM (KINIT.TAKE)SH /Times-Roman SF (. The) 266 W( file)8 W /Courier SF 22450 XM (KSYS.TD)SH /Times-Roman SF 26908 XM (is a read-only, extra-partition TD queue maintained by a systems)8 W 6120 48613 MT (programmer. The) 256 W( file)3 W /Courier SF 15213 XM (KINIT.TAKE)SH /Times-Roman SF 21466 XM (resides in the user's Kermit directory and must be maintained by the user. For)3 W 6120 49809 MT (example, the file could be changed by) 84 W( downloading it to a microcomputer, editing it there, and uploading it again)83 W 6120 51005 MT (\050making sure to set) 35 W( FILE COLLISION to OVERWRITE\051. Alternatively, if tools exist for editing TS queues within)36 W 6120 52201 MT (CICS, the file could be copied to a TS queue, edited, and copied back.)SH 6120 54593 MT (Kermit-CICS cannot time out while waiting for a packet. The only way to time out is) 28 W( from the other side: typing a)27 W 6120 55789 MT (carriage return to the local Kermit causing it to retransmit its last packet, or an automatic timeout as provided by)98 W 6120 56985 MT (many Kermits.)SH 6120 59377 MT (CICS is different from some other IBM mainframe systems in that it allows a program to take control of prompting)35 W 6120 60573 MT (and synchronization) 21 W( on ``)22 W /Courier SF (TTY)SH /Times-Roman SF ('' lines. Kermit-CICS takes advantage of this option, and it is not necessary to enable)22 W 6120 61769 MT (handshaking on the micro Kermit before connecting to CICS. Thus, the micro Kermit should) 47 W( have HANDSHAKE)46 W 6120 62965 MT (set OFF, and Kermit-CICS should have HANDSHAKE) 81 W( set to 0. Since the generic Kermit-370 default handshake)82 W 6120 64161 MT (\050XON\051 is retained) 46 W( in Kermit-CICS, the subcommand ``)45 W /Courier SF (SET HANDSHAKE 0)45 W /Times-Roman SF ('' is a good candidate for inclusion in)45 W /Courier SF 6120 65357 MT (KSYS.TD)SH /Times-Roman SF (.)SH ES %%Page: 37 38 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (2.2. Program Operation)SH 10 /Times-Italic AF 51775 XM (Page 37)SH 46800 50 8280 5709 UL 12 /Times-Bold AF 8280 8004 MT (Interactive Operation:)SH 10 /Times-Roman AF 8280 9418 MT (To run Kermit-CICS interactively, invoke the program from CICS by typing)SH /Courier SF 39167 XM (KERMIT)SH /Times-Roman SF (. When) 250 W( you see the prompt,)SH /Courier SF 10680 11073 MT (Kermit-CICS>)SH /Times-Roman SF 8280 12790 MT (you may type a) 27 W( Kermit subcommand. When the subcommand completes, Kermit issues another prompt. The cycle)28 W 8280 13986 MT (repeats until you exit from the program. For example:)SH /Courier SF 10680 15641 MT (.KERMIT)SH 3600 50 11280 15841 UL 10680 17296 MT (Kermit-CICS Version 4.3.0 \05093/9/30\051)SH 10680 18327 MT (Enter ? for a list of valid commands)SH 10680 19982 MT (Kermit-CICS>send foo*.ts)SH 7200 50 17880 20182 UL /Courier-Oblique SF 11880 21637 MT (TS queues with names beginning FOO are sent)SH /Courier SF 10680 23292 MT (Kermit-CICS>receive test.td)SH 9000 50 17880 23492 UL /Courier-Oblique SF 11880 24947 MT (File is received and stored in the TD queue called TEST)SH /Courier SF 10680 26602 MT (Kermit-CICS>exit)SH 2400 50 17880 26802 UL /Times-Roman SF 8280 28994 MT (In this example, which assumes a linemode session with) 97 W( a system prompt of ``)96 W /Courier SF (.)SH /Times-Roman SF ('', the text entered by the user is)96 W 8280 30190 MT (displayed along with messages and prompts. The annotations are indented, but the distinction between user text) 13 W( and)14 W 8280 31386 MT (Kermit text may depend upon how this document is) 43 W( printed. Normally, the text entered by the user is underscored,)42 W 8280 32582 MT (and the messages and prompts are not.)SH 8280 34974 MT (The prompt string from Kermit-CICS is truly interactive. In other words, the prompt appears) 26 W( only when fresh input)27 W 8280 36170 MT (is needed from the terminal. If, for example, multiple Kermit) 208 W( subcommands have been stacked up using the)207 W 8280 37366 MT (delimiter feature, the stack is read and executed before the next prompt appears.)SH 12 /Times-Bold AF 8280 39954 MT (Command Line Invocation:)SH 10 /Times-Roman AF 8280 41368 MT (Kermit-CICS may be invoked with command-line arguments from CICS.) 121 W( The) 493 W( arguments \050taken to be the string)122 W 8280 42564 MT (beginning after the first blank after the four-letter transaction) 304 W( id ``)303 W /Courier SF (KERM)SH /Times-Roman SF (''\051 are interpreted as one or more)303 W 8280 43760 MT (subcommands to be executed by Kermit after completion of the initialization. Thus, the command) 262 W( may be)263 W 8280 44956 MT (abbreviated as ``)SH /Courier SF (KERM)SH /Times-Roman SF ('' or ``)SH /Courier SF (KERMI)SH /Times-Roman SF ('' at the user's discretion. For instance:)SH /Courier SF 10680 46611 MT (.KERMIT send test.take)SH 12600 50 11280 46811 UL /Times-Roman SF 8280 49003 MT (Kermit will exit and return to CICS after completing the) 56 W( specified subcommand. A command line may contain up)55 W 8280 50199 MT (to 256 characters. Note that the subcommand delimiter is) 14 W( initially disabled in Kermit-CICS, but it can be enabled in)15 W 8280 51395 MT (either of the initialization files and can then be used for entering multiple subcommands on the command line.)SH 12 /Times-Bold AF 8280 53983 MT (Non-interactive Operation:)SH 10 /Times-Roman AF 8280 55397 MT (Kermit-CICS is both a CICS transaction named) 208 W( KERM and a CICS program named KERMIT. As with any)207 W 8280 56593 MT (transaction, it may be started automatically as well as by hand, but it will then read) 5 W( the terminal expecting to find the)6 W 8280 57789 MT (command-line arguments \050if) 50 W( any\051 for execution as a Kermit subcommand. In addition, Kermit may be invoked via)49 W 8280 58985 MT (the CICS LINK and XCTL commands and \050optionally\051 supplied with a COMMAREA.)SH 8280 61377 MT (If there is no COMMAREA,) 72 W( Kermit reads the terminal just as if it were invoked as a transaction. If supplied, the)73 W 8280 62573 MT (COMMAREA is scanned, instead of a terminal buffer, for the command) 2 W( string. Note that, if the COMMAREA does)1 W 8280 63769 MT (not begin) 48 W( with a blank, the first blank-delimited word will be ignored in the same way as the transaction name in a)49 W 8280 64965 MT (terminal buffer. In both cases, the command-line arguments begin with the first non-blank character after) 69 W( the first)68 W 8280 66161 MT (blank. Once) 378 W( the command line is established, execution proceeds the) 64 W( same as if Kermit had been started by hand;)65 W 8280 67357 MT (since Kermit exits as soon as it finishes the subcommand specified in the command) 42 W( string, there is no need to enter)41 W 8280 68553 MT (any subcommands at the terminal in this mode of operation.) 30 W( Even) 311 W( so, Kermit should be given a terminal, since that)31 W 8280 69749 MT (provides the communication line for file transfer.)SH ES %%Page: 38 39 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 38)SH 12 /Times-Bold AF 28819 XM (Kermit User's Guide: IBM CICS KERMIT 2.2)SH 46800 50 6120 5709 UL 10 /Times-Roman AF 6120 7886 MT (When Kermit exits, if the given COMMAREA is at least seven bytes long, Kermit sets a return or completion code)38 W 6120 9082 MT (in the COMMAREA according to the current status. See) 76 W( the table of error codes in the Kermit-370 chapter. The)77 W 6120 10278 MT (return code takes the following form: the characters) 150 W( ``)149 W /Courier SF (R\050)SH /Times-Roman SF ('', a four-byte signed binary integer, and the character)149 W 6120 11474 MT (``)SH /Courier SF (\051)SH /Times-Roman SF (''. It) 250 W( is, thus, compatible with the convention described below under the CICS subcommand.)SH 12 /Times-Bold AF 6120 14062 MT (Interface to mail, print, and batch)SH 10 /Times-Roman AF 6120 15476 MT (Unlike many other IBM/370) 20 W( environments, CICS does not provide a standard means of returning a completion code)21 W 6120 16672 MT (from an invoked program. As the) 22 W( previous paragraph indicates, Kermit-370 has adopted its own standard, using the)21 W 6120 17868 MT (COMMAREA, and this applies to the calling sequences for the commands that handle) 90 W( electronic mail, print files,)91 W 6120 19064 MT (and batch jobs.) 145 W( Thus,) 539 W( the ``)144 W /Courier SF (R\050_...\051)SH /Times-Roman SF ('' shown in those sequences at the beginning of this chapter is not to be)144 W 6120 20260 MT (considered as an option, but as a required part of the COMMAREA to allow room for a return code.) 25 W( Consequently,)302 W 6120 21456 MT (when Kermit-CICS calls one of those programs to verify the feasibility of that kind of file disposition,) 263 W( the)262 W 6120 22652 MT (COMMAREA consists of seven bytes, rather than none. See below under the HOST subcommand for more details)36 W 6120 23848 MT (about invoking CICS programs from Kermit.)SH 12 /Times-Bold AF 6120 26436 MT (Server mode:)SH 10 /Times-Roman AF 6120 27850 MT (Command execution in) 211 W( server mode is different in three respects from normal operation. First, some Kermit)210 W 6120 29046 MT (subcommands are not allowed \050see the list of subcommands in the Kermit-370) 71 W( chapter\051. Second, command errors)72 W 6120 30242 MT (always terminate) 92 W( any active TAKE file. Third, Kermit intercepts its terminal output and transmits the data to the)91 W 6120 31438 MT (local Kermit as text packets. However, any other programs that wish to write to the terminal will do) 70 W( so, and such)71 W 6120 32634 MT (messages never appear to the local Kermit \050except, perhaps, as bad packets\051.)SH 14 /Times-Bold AF 6120 36236 MT (2.3. Kermit-CICS Subcommands)SH 10 /Times-Roman AF 6120 38354 MT (Kermit-CICS supports all the subcommands described in the Kermit-370) 293 W( chapter. In addition, there is the)292 W 6120 39550 MT (system-specific subcommand ``)55 W /Courier SF (CICS)SH /Times-Roman SF ('', which is a synonym for the) 55 W( generic subcommand ``)56 W /Courier SF (HOST)SH /Times-Roman SF (''. ``)362 W /Courier SF (CICS)SH /Times-Roman SF ('' can)56 W 6120 40746 MT (be issued as a remote Kermit command when Kermit-CICS is in server mode.)SH 6120 43138 MT (This section concentrates on the subcommands that have special form or meaning for Kermit-CICS. These) 153 W( are)152 W 6120 44334 MT (ordered alphabetically. See the chapter on Kermit-370 for further details.)SH 13 /Times-Bold AF 22729 47693 MT (The CICS Subcommand)SH 10 /Times-Roman AF 6120 50066 MT (Syntax:)SH /Courier SF 9776 XM (CICS)SH /Times-Italic SF 12776 XM (text of command)SH /Times-Roman SF 6120 52458 MT (Kermit-CICS supports two kinds of "system" commands. Both kinds are designated by the prefix ``)160 W /Courier SF (CICS)SH /Times-Roman SF ('' or)160 W 6120 53654 MT (``)SH /Courier SF (HOST)SH /Times-Roman SF ('', even though neither kind can be invoked directly from a CICS session. The) 67 W( first word of the command)66 W 6120 54850 MT (string is taken to be the name of the command.) 32 W( Kermit) 315 W( first checks whether the name is in a list of simulated CICS)33 W 6120 56046 MT (functions \050and their abbreviations\051. If so, Kermit itself) 261 W( simulates the function. The available functions are)260 W 6120 57242 MT (DIRECTORY, TYPE, COPY, and DELETE. DIRECTORY and TYPE are identical to) 93 W( the corresponding Kermit)94 W 6120 58438 MT (subcommands. COPY) 376 W( has a straightforward syntax \050old)63 W /Times-Italic SF 29427 XM (filespec)SH /Times-Roman SF 32794 XM (followed by new\051; DELETE is even simpler \050just)62 W 6120 59634 MT (the desired)130 W /Times-Italic SF 10990 XM (filespec)SH /Times-Roman SF (\051. DELETE) 510 W( and DIRECTORY have no special options, but COPY and TYPE offer one: the)131 W 6120 60830 MT (source)SH /Times-Italic SF 8986 XM (filespec)SH /Times-Roman SF 12297 XM (may have a range of line numbers \050in the same syntax as the SEND subcommand\051 to be copied/typed)6 W 6120 62026 MT (instead of the entire file. All four functions are applicable to the same data objects as KERMIT) 212 W( SEND and)213 W 6120 63222 MT (RECEIVE, but none of the) 247 W( four recognize wildcards. No RENAME function is implemented, although that)246 W 6120 64418 MT (command name is reserved. If the command name is not found in the list of) 65 W( special functions, Kermit attempts to)66 W 6120 65614 MT (invoke a CICS program of that name with a COMMAREA consisting of the remainder of the command string.) 22 W( The)292 W 6120 66810 MT (CICS commands) 1 W( used in command-level programming are not supported. Kermit detects numeric return codes from)2 W 6120 68006 MT (co-operating invoked programs by examining the COMMAREA upon return. If the first) 100 W( two bytes are the string)99 W 6120 69202 MT (``)SH /Courier SF (R\050)SH /Times-Roman SF ('', the seventh byte is ``)60 W /Courier SF (\051)SH /Times-Roman SF ('', and the third) 60 W( byte is the same as the fourth, the string of bytes three though six is)61 W 6120 70398 MT (taken to be a binary fullword) 69 W( return code. The conditions are sufficiently restrictive that "accidental" return codes)68 W 6120 71594 MT (are very rare \050one chance) 41 W( in four billion, assuming totally random bytes, but probably less than that in practice\051. A)42 W ES %%Page: 39 40 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (2.3. Kermit-CICS Subcommands)SH 10 /Times-Italic AF 51775 XM (Page 39)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (negative code is taken to) 49 W( mean that the host command was actually "illegal" in some sense, a zero code means that)48 W 8280 9082 MT (the command completed successfully, and a positive code means) 90 W( that the command encountered an error of some)91 W 8280 10278 MT (kind while executing. Positive codes are reported to the user in the form) 23 W( ``)22 W /Courier SF (R\050number\051)SH /Times-Roman SF ('', where the numeric value)22 W 8280 11474 MT (is given in decimal.)SH 13 /Times-Bold AF 24853 14833 MT (The CWD Subcommand)SH 10 /Times-Roman AF 8280 17206 MT (Syntax:)SH /Courier SF 11936 XM (CWD)SH /Times-Italic SF 14336 XM (directory or)350 W /Courier SF 20091 XM (')SH /Times-Italic SF (prefix)SH /Times-Roman SF 8280 19598 MT (The CWD \050Change) 184 W( Working Directory\051 subcommand establishes a new default directory or specifies a default)185 W 8280 20794 MT (prefix for Qualified File Names. The specified name is normally the four-character userid associated with a)226 W 8280 21990 MT (directory in Kermit-managed storage. However, if) 41 W( the name is omitted, this resets the directory to ``)42 W /Courier SF (*)SH /Times-Roman SF ('', which is a)42 W 8280 23186 MT (synonym for the session userid. If the name begins) 97 W( with an apostrophe, that establishes the use of Qualified File)96 W 8280 24382 MT (Names with the given string as prefix. When a QFN prefix is established,) 171 W( any)172 W /Times-Italic SF 42370 XM (filespec)SH /Times-Roman SF 45847 XM (given to Kermit-CICS)172 W 8280 25578 MT (without an explicit fileclass \050directory\051 will be appended to the current) 47 W( prefix and interpreted as a QFN, rather than)46 W 8280 26774 MT (as a normal CICS data object name. When a fileclass is) 69 W( given explicitly, even if the fileclass is ignored \050as in the)70 W 8280 27970 MT (case of TD and TS queues\051, that overrides the presumption of a QFN. Thus, while the) 66 W( CWD subcommand allows)65 W 8280 29166 MT (the convenience of an abbreviated) 114 W( notation for both QFN's and normal data object names, the underlying syntax)115 W 8280 30362 MT (always permits the) 69 W( specification of any desired file by spelling out the)68 W /Times-Italic SF 37372 XM (filespec)SH /Times-Roman SF 40745 XM (in full. For example, if the current)68 W 8280 31558 MT (prefix is ``)95 W /Courier SF ('AAA1234.)SH /Times-Roman SF ('', the QFN ``)95 W /Courier SF ('AAA1234.OLD.TAKE')SH /Times-Roman SF ('' may be abbreviated as just ``)95 W /Courier SF (OLD.TAKE)SH /Times-Roman SF ('', but)95 W 8280 32754 MT (the system initialization file can still be specified \050as ``)125 W /Courier SF (*/KSYS.TD)SH /Times-Roman SF (''\051. Similarly,) 500 W( if the prefix is ``)125 W /Courier SF (*)SH /Times-Roman SF ('',)SH /Times-Italic SF 52011 XM (i.e.)SH /Times-Roman SF (, the)125 W 8280 33950 MT (session default directory name, the same QFN must be) 57 W( spelled out in full, while the filespec ``)58 W /Courier SF (OLD.TAKE)SH /Times-Roman SF ('' would)58 W 8280 35146 MT (refer to member ``)SH /Courier SF (OLD)SH /Times-Roman SF ('' in the user's directory.)SH 13 /Times-Bold AF 22469 38505 MT (The DIRECTORY Subcommand)SH 10 /Times-Roman AF 8280 40878 MT (Syntax:)SH /Courier SF 11936 XM (DIRECTORY)SH /Times-Italic SF 17936 XM (filespec)SH /Times-Roman SF 8280 43270 MT (The DIRECTORY subcommand displays attributes of one or more files \050name, LRECL,) 102 W( RECFM, size, type, and)101 W 8280 44466 MT (date\051. The)268 W /Times-Italic SF 12861 XM (filespec)SH /Times-Roman SF 16175 XM (may have wildcard characters if it) 9 W( refers to members of the current working directory or to TS or)10 W 8280 45662 MT (TD queues.) 89 W( For) 426 W( TD queues, the type is displayed as ``)88 W /Courier SF (EXTRA)SH /Times-Roman SF ('', ``)88 W /Courier SF (INTRA)SH /Times-Roman SF ('', ``)88 W /Courier SF (REMOTE)SH /Times-Roman SF ('', or ``)88 W /Courier SF (INDIRECT)SH /Times-Roman SF ('', and)88 W 8280 46858 MT (the type for all other data) 159 W( objects is ``)160 W /Courier SF (OTHER)SH /Times-Roman SF (''. The) 570 W( size is displayed, where possible, in two forms, both the)160 W 8280 48054 MT (number of records and) 42 W( the total number of bytes \050rounded to the nearest kilobyte\051. If either of those sizes is shown)41 W 8280 49250 MT (as zero, it may simply mean) 95 W( that Kermit was unable to obtain the required information,)96 W /Times-Italic SF 44794 XM (e.g.)SH /Times-Roman SF (, for main-storage TS)96 W 8280 50446 MT (queues in CICS under MVS/ESA. A value of zero for the LRECL means that) 33 W( the only limit is 32767. Similarly, if)32 W 8280 51642 MT (the date is unavailable \050often the case\051, it will simply be omitted.)SH 13 /Times-Bold AF 24781 55001 MT (The GIVE Subcommand)SH 10 /Times-Roman AF 8280 57374 MT (Syntax:)SH /Courier SF 11936 XM (GIVE)SH /Times-Italic SF 14936 XM (table-name filespec)350 W /Times-Roman SF 8280 59766 MT (This subcommand compares the named) 19 W( translation table with its default values and saves the differences in a TAKE)20 W 8280 60962 MT (file named)164 W /Times-Italic SF 13107 XM (filespec)SH /Times-Roman SF (. The)577 W /Times-Italic SF 19207 XM (filespec)SH /Times-Roman SF 22675 XM (has the usual format, except that the default filetype is ``)163 W /Courier SF (TAKE)SH /Times-Roman SF ('', rather than)163 W 8280 62158 MT (``)SH /Courier SF (TS)SH /Times-Roman SF (''. See) 250 W( the Kermit-370 chapter for a fuller description of this subcommand.)SH ES %%Page: 40 41 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 40)SH 12 /Times-Bold AF 28819 XM (Kermit User's Guide: IBM CICS KERMIT 2.3)SH 46800 50 6120 5709 UL 13 SS 22513 8071 MT (The HELP Subcommand)SH 10 /Times-Roman AF 6120 10444 MT (Syntax:)SH /Courier SF 9776 XM (HELP [)SH /Times-Italic SF (subcommand)SH /Courier SF (])SH /Times-Roman SF 6120 12836 MT (This subcommand displays a message that explains the specified Kermit-CICS subcommand. If no subcommand) 35 W( is)36 W 6120 14032 MT (given, the message) 41 W( explains the Kermit command itself. These messages are stored in the Kermit-managed storage)40 W 6120 15228 MT (in the common directory.)SH 13 /Times-Bold AF 21320 18587 MT (The RECEIVE Subcommand)SH 10 /Times-Roman AF 6120 20960 MT (Syntax:)SH /Courier SF 9776 XM (RECEIVE [)SH /Times-Italic SF (filespec)SH /Courier SF (])SH /Times-Roman SF 6120 23352 MT (The RECEIVE subcommand tells Kermit to receive one or more files from the other) 83 W( system. You must issue the)84 W 6120 24548 MT (corresponding SEND subcommand to the other Kermit.)SH 6120 26940 MT (If the optional)49 W /Times-Italic SF 12183 XM (filespec)SH /Times-Roman SF 15537 XM (is omitted, Kermit-CICS will use the name\050s\051 provided) 49 W( by the other Kermit. If that name is)48 W 6120 28136 MT (not a legal CICS file name, Kermit-CICS will delete excess characters, if any. If the filetype) 95 W( is illegal, however,)96 W 6120 29332 MT (Kermit will reject the file. Wildcards may not be used.) 113 W( A)475 W /Times-Italic SF 31111 XM (filespec)SH /Times-Roman SF 34528 XM (in the subcommand indicates what name the)112 W 6120 30528 MT (incoming file should be given. If the optional)54 W /Times-Italic SF 25216 XM (filespec)SH /Times-Roman SF 28575 XM (is provided, but more than one file arrives,) 54 W( the first file will)55 W 6120 31724 MT (be stored under the given)21 W /Times-Italic SF 16584 XM (filespec)SH /Times-Roman SF (, and the remainder will be stored under their own names, as provided by the other)21 W 6120 32920 MT (Kermit.)SH 6120 35312 MT (For purposes of truncation and folding, the maximum record length for a received file) 51 W( depends on the file type and)52 W 6120 36508 MT (the filetype. BINARY files are folded at the current LRECL, but TEXT files may have a) 60 W( maximum size of 32767)59 W 6120 37704 MT (\050TS queues and Kermit directory members do, as do TD queues with varying-length records\051.)SH 6120 40096 MT (If the incoming file has the same name as an existing file,) 159 W( the action taken depends on the FILE COLLISION)160 W 6120 41292 MT (setting. The) 710 W( possible settings and their meanings are given in the Kermit-370 chapter. Two of) 230 W( the settings)229 W 6120 42488 MT (\050BACKUP and RENAME\051 require that) 192 W( Kermit-CICS change the incoming name so as not to obliterate a pre-)193 W 6120 43684 MT (existing file. It attempts to find a unique name by successively modifying the original and checking for the)216 W 6120 44880 MT (existence of such a file at each step. The procedure begins by truncating the filename) 39 W( to six characters if necessary)40 W 6120 46076 MT (and then) 82 W( appending ``)81 W /Courier SF ($0)SH /Times-Roman SF ('' and changing any filetype other than ``)81 W /Courier SF (TAKE)SH /Times-Roman SF ('' to ``)81 W /Courier SF (TS)SH /Times-Roman SF (''. If) 412 W( a file by that name exists,)81 W 6120 47272 MT (Kermit then replaces the ``)18 W /Courier SF (0)SH /Times-Roman SF ('' with a ``)18 W /Courier SF (1)SH /Times-Roman SF (''. It) 286 W( continues) 18 W( in this manner up to ``)19 W /Courier SF (9)SH /Times-Roman SF ('', and if an unused name cannot be)19 W 6120 48468 MT (found, the transfer fails. In Kermit-CICS, the default setting of) 56 W( FILE COLLISION is RENAME, which causes the)55 W 6120 49664 MT (new file to be stored under the modified name. The BACKUP option is not supported by Kermit-CICS.)SH 13 /Times-Bold AF 22548 53023 MT (The SEND Subcommand)SH 10 /Times-Roman AF 6120 55396 MT (Syntax:)SH /Courier SF 9776 XM (SEND [)SH /Times-Italic SF (filespec)SH /Courier SF ([<)SH /Times-Italic SF (options)SH /Courier SF (>] [)SH /Times-Italic SF (foreign-filespec)SH /Courier SF (]][, ...])SH /Times-Roman SF 6120 57788 MT (The SEND) 122 W( subcommand causes one or more files to be sent from CICS to the other system. For details on the)123 W /Times-Italic SF 6120 58984 MT (options)SH /Times-Roman SF (, see the description of SEND in the) 101 W( Kermit-370 chapter. Note that no blanks may intervene between the)100 W 6120 60180 MT (CICS)SH /Times-Italic SF 8593 XM (filespec)SH /Times-Roman SF 11898 XM (and the)SH /Times-Italic SF 15064 XM (options)SH /Times-Roman SF (.)SH 6120 62572 MT (If the filetype is ``)203 W /Courier SF (TD)SH /Times-Roman SF ('', ``)203 W /Courier SF (TS)SH /Times-Roman SF ('', or ``)203 W /Courier SF (TAKE)SH /Times-Roman SF ('', the filename may contain the wildcard characters ``)203 W /Courier SF (*)SH /Times-Roman SF ('' or ``)204 W /Courier SF (%)SH /Times-Roman SF (''.)SH 6120 63768 MT (Wildcards are valid with) 73 W( ``)72 W /Courier SF (TAKE)SH /Times-Roman SF ('' only for the current directory. If wildcards are used, all eligible matching files)72 W 6120 64964 MT (will be sent. Note that wildcard specification) 12 W( for TS queues cannot be guaranteed to work correctly, since CICS is a)13 W 6120 66160 MT (multi-user environment, and the system chain of queues can be modified dynamically while) 28 W( Kermit is following the)27 W 6120 67356 MT (chain looking) 6 W( for matches. The result might be to skip one or more files, to send a file more than once, or to attempt)7 W 6120 68552 MT (sending a non-existant queue \050cutting short the transfer with an I/O error message\051.)SH 6120 70944 MT (The)SH /Times-Italic SF 8061 XM (foreign-filespec)SH /Times-Roman SF (, if) 136 W( any, is used for the file header of the outgoing file, replacing the usual ``)135 W /Courier SF (name.type)SH /Times-Roman SF ('')SH ES %%Page: 41 42 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (2.3. Kermit-CICS Subcommands)SH 10 /Times-Italic AF 51775 XM (Page 41)SH 46800 50 8280 5709 UL /Times-Roman SF 8280 7886 MT (copied from the CICS)61 W /Times-Italic SF 17579 XM (filespec)SH /Times-Roman SF (. Normally,) 372 W( this form of the SEND subcommand is) 61 W( used only when the)62 W /Times-Italic SF 50380 XM (filespec)SH /Times-Roman SF 53747 XM (has)SH 8280 9082 MT (no wildcards, since the)133 W /Times-Italic SF 18227 XM (foreign-filespec)SH /Times-Roman SF 24887 XM (is used only for the first file of a group) 133 W( \050subsequent files having default)132 W 8280 10278 MT (headers\051. If) 742 W( both)246 W /Times-Italic SF 16346 XM (filespecs)SH /Times-Roman SF 20287 XM (are omitted for this subcommand, Kermit will prompt separately for each. This)247 W 8280 11474 MT (prompting mode is especially) 26 W( useful when more than one file \050or file group\051 is to be sent, since the command line is)25 W 8280 12670 MT (limited to 130 characters.)SH 8280 15062 MT (Trailing blanks in a text file with RECFM F are deemed superfluous and are stripped off when) 196 W( Kermit-CICS)197 W 8280 16258 MT (downloads the file. In order to treat such blanks as significant, you must convert the record format to) 65 W( V by using,)64 W 8280 17454 MT (for example, the Kermit HOST COPY subcommand to move the file to a TS queue.)SH 13 /Times-Bold AF 25214 20813 MT (The SET Subcommand)SH 10 /Times-Roman AF 8280 23186 MT (Syntax:)SH /Courier SF 11936 XM (SET)SH /Times-Italic SF 14336 XM (parameter)SH /Courier SF 19102 XM ([)SH /Times-Italic SF (value)SH /Courier SF (])SH /Times-Roman SF 8280 25578 MT (The SET subcommand) 142 W( establishes or modifies various parameters controlling file transfers. The following SET)143 W 8280 26774 MT (parameters are available in Kermit-CICS, but not universally in Kermit-370:)SH 8280 28384 MT (DELIMITER)SH 22680 XM (character for terminal input.)SH 8280 29489 MT (FILE)SH 8780 30594 MT (LRECL)SH 22680 XM (Logical Record length for incoming file.)SH 8780 31699 MT (RECFM)SH 22680 XM (Record format for incoming files.)SH 8280 32804 MT (PREFIX)SH 22680 XM (New directory.)SH 12 /Times-Bold AF 8280 35392 MT (SET DELIMITER)SH 10 /Times-Roman AF 8280 36806 MT (Syntax:)SH /Courier SF 11936 XM (SET DELIMITER)SH /Times-Italic SF 20336 XM (character)SH /Times-Roman SF 8280 39198 MT (This subcommand) 159 W( is defines a character to be interpreted as the logical end of an input command line \050for the)158 W 8280 40394 MT (purpose of entering multiple commands on a single line\051.) 74 W( This) 399 W( is used only for commands entered at the terminal)75 W 8280 41590 MT (and has no effect on commands contained in TAKE files. The delimiter is initially undefined,) 77 W( but it can be set in)76 W 8280 42786 MT (one of the initialization files and thereby be used in parsing the initial command-line arguments.)SH 12 /Times-Bold AF 8280 45374 MT (SET FILE COLLISION)SH 10 /Times-Roman AF 8280 46788 MT (Syntax:)SH /Courier SF 11936 XM (SET FILE COLLISION)SH /Times-Italic SF 23336 XM (option)SH /Times-Roman SF 8280 49180 MT (Unlike most other variants of Kermit-370, Kermit-CICS has RENAME) 44 W( as the default value for FILE COLLISION.)45 W 8280 50376 MT (As a consequence, the usual mode of) 191 W( operation for receiving a file that already exists \050or appears to exist, as)190 W 8280 51572 MT (extra-partition TD) 62 W( queues always do\051, is to assign a new and unique name and save the file as a TS queue. If you)63 W 8280 52768 MT (really want to upload into an extra-partition TD queue,) 122 W( you must first SET FILE COLLISION OVERWRITE or)121 W 8280 53964 MT (APPEND, whichever is appropriate. Actually, if the queue in question already exists) 186 W( but is closed, these two)187 W 8280 55160 MT (options have the same effect, which is to overwrite the queue.)SH 12 /Times-Bold AF 8280 57748 MT (SET FILE LRECL)SH 10 /Times-Roman AF 8280 59162 MT (Syntax:)SH /Courier SF 11936 XM (SET FILE LRECL)SH /Times-Italic SF 20936 XM (number)SH /Times-Roman SF 8280 61554 MT (This sets) 79 W( the logical record length for incoming files to a)78 W /Times-Italic SF 32053 XM (number)SH /Times-Roman SF 35436 XM (from 1 to 32767 \05032K-1\051. This variable is used)78 W 8280 62750 MT (only for fixed-format and binary files. However, the only currently supported type of fixed-format files) 170 W( is the)171 W 8280 63946 MT (extra-partition TD queue, which does not allow Kermit to alter the pre-defined LRECL. The default is 80.)SH ES %%Page: 42 43 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 42)SH 12 /Times-Bold AF 28819 XM (Kermit User's Guide: IBM CICS KERMIT 2.3)SH 46800 50 6120 5709 UL 6120 8004 MT (SET FILE RECFM)SH 10 /Times-Roman AF 6120 9418 MT (Syntax:)SH /Courier SF 9776 XM (SET FILE RECFM)SH /Times-Italic SF 18776 XM (option)SH /Times-Roman SF 6120 11810 MT (This sets the record format to use for incoming files. Valid)71 W /Times-Italic SF 30941 XM (option)SH /Times-Roman SF (s are "Undefined", "Fixed", and) 71 W( "Variable" \050the)70 W 6120 13006 MT (default\051. Fixed-format) 420 W( records are padded, folded, or truncated, as needed, to the current LRECL. Most) 85 W( kinds of)86 W 6120 14202 MT (files, in fact, cannot be anything but variable. There is no) 27 W( current use for this subcommand, since the only files that)26 W 6120 15398 MT (can have fixed-length records are not) 29 W( affected by the Kermit setting. However, there may be future applications for)30 W 6120 16594 MT (as-yet-unsupported filetypes.)SH 12 /Times-Bold AF 6120 19182 MT (SET PREFIX)SH 10 /Times-Roman AF 6120 20596 MT (Syntax:)SH /Courier SF 9776 XM (SET PREFIX)SH /Times-Italic SF 16376 XM (string)SH /Times-Roman SF 6120 22988 MT (This subcommand is equivalent to the CWD subcommand \050)110 W /Times-Italic SF (q.v.)SH /Times-Roman SF (\051. Issuing) 470 W( ``)110 W /Courier SF (SHOW PREFIX)110 W /Times-Roman SF ('' will not reveal the)110 W 6120 24184 MT (name of the default directory, since that is called) 43 W( by its alias ``)44 W /Courier SF (*)SH /Times-Roman SF (''. You) 338 W( must use the SPACE subcommand instead)44 W 6120 25380 MT (\050)SH /Times-Italic SF (q.v.)SH /Times-Roman SF (\051. There) 250 W( is no mechanism for displaying the list of all existing directories.)SH 13 /Times-Bold AF 22151 28739 MT (The SPACE Subcommand)SH 10 /Times-Roman AF 6120 31112 MT (Syntax:)SH /Courier SF 9776 XM (SPACE)SH /Times-Roman SF 6120 33504 MT (This subcommand displays the storage allocation in the) 155 W( current directory and the allowed quota. If there is no)154 W 6120 34700 MT (current directory,)SH /Times-Italic SF 13312 XM (i.e.)SH /Times-Roman SF (, if a QFN prefix has been selected, the response is ``)SH /Courier SF (No directory defined)SH /Times-Roman SF (''.)SH 13 /Times-Bold AF 22440 38059 MT (The TAKE Subcommand)SH 10 /Times-Roman AF 6120 40432 MT (Syntax:)SH /Courier SF 9776 XM (TAKE)SH /Times-Italic SF 12776 XM (filespec)SH /Times-Roman SF 6120 42824 MT (Execute Kermit subcommands from the specified file. The)124 W /Times-Italic SF 31176 XM (filespec)SH /Times-Roman SF 34605 XM (has the) 124 W( usual format, except that the default)125 W 6120 44020 MT (filetype is ``)SH /Courier SF (TAKE)SH /Times-Roman SF ('', rather than ``)SH /Courier SF (TS)SH /Times-Roman SF (''.)SH 14 /Times-Bold AF 6120 47622 MT (2.4. How to build an executable Kermit-CICS)SH 10 /Times-Roman AF 6120 49740 MT (Before attempting to build Kermit-CICS, look in the Kermit) 266 W( distribution under IKXKER for the installation)265 W 6120 50936 MT (document, as well as "beware", help, and update files, and read them) 47 W( first. They will probably contain information)48 W 6120 52132 MT (that is more current than what you see here. Indeed, the) 27 W( process of applying the updates is complicated enough that)26 W 6120 53328 MT (it cannot be adequately described here.) 55 W( The) 361 W( installation document)56 W /Courier SF 33419 XM (IKXKER.INS)SH /Times-Roman SF 39725 XM (contains a full description of the)56 W 6120 54524 MT (process, including batch jobs for carrying out the various steps. You) 124 W( will need to extract the JCL and submit it)123 W 6120 55720 MT (\050suitably tailored to your local environment\051. These jobs apply the updates, pass the source through) 335 W( the)336 W 6120 56916 MT (command-level translator and the assembler, and finally link the program into an executable phase or load module.)SH 6120 59308 MT (If your site's ASCII/EBCDIC translation table for TTY lines does not conform to the one listed) 122 W( in the appendix)121 W 6120 60504 MT (\050which in turn) 76 W( conforms to the one given in the IBM System/370 Reference Summary\051, then enter the appropriate)77 W 6120 61700 MT (SET ATOE/ETOA/TATOE/TETOA subcommands in)202 W /Courier SF 28926 XM (KSYS.TD)SH /Times-Roman SF (. The) 654 W( generic) 202 W( Kermit-370 chapter includes an)201 W 6120 62896 MT (invertible 256-entry translation table and describes a procedure for determining what) 4 W( SET subcommands are needed.)5 W /Times-Italic SF 6120 64092 MT (NOTE:)SH /Times-Roman SF 9306 XM (If your site's) 47 W( ASCII/EBCDIC translation is not invertible for at least 96 entries, Kermit will not and cannot)46 W 6120 65288 MT (work.)SH ES %%Page: 43 44 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (IBM System/370 Kermit)SH 10 /Times-Italic AF 51775 XM (Page 43)SH 46800 50 8280 5709 UL 14 /Times-Bold AF 8280 8138 MT (2.5. What's New)SH 10 /Times-Roman AF 8280 10256 MT (Below is a list of the CICS-specific features in Version 4.3.0 of Kermit-CICS added since the previous major)183 W 8280 11452 MT (release, Version 4.2 in March of 1990. For the list of generic additions, see the chapter on Kermit-370.)SH 10280 13243 MT (1.)SH 11280 XM (Termid substitution in filenames.)SH 10280 14901 MT (2.)SH 11280 XM (User id for Kermit storage expanded to 8 bytes.)SH 10280 16559 MT (3.)SH 11280 XM (Compatibility with CICS 3.1.)SH 10280 18217 MT (4.)SH 11280 XM (Prompt string padded with XON.)SH 10280 19875 MT (5.)SH 11280 XM (Serialized access to TD queues.)SH 10280 21533 MT (6.)SH 11280 XM (Small bug fixes.)SH 14 /Times-Bold AF 8280 25135 MT (2.6. What's Missing)SH 10 /Times-Roman AF 8280 27253 MT (Work on Kermit-CICS will continue. Features that need to be improved or added include:)SH /Symbol SF 10070 29158 MT (\267)SH /Times-Roman SF 10780 XM (IKXDYNAL for both CICS/VSE and CICS/MVS. The former would probably) 6 W( support only spool files,)5 W 10780 30263 MT (but the latter should support both spool files and MVS data sets \050QFN's\051.)SH /Symbol SF 10070 32252 MT (\267)SH /Times-Roman SF 10780 XM (Sample exit routines for supporting userid algorithms besides the OPID and TERM options.)SH /Symbol SF 10070 34241 MT (\267)SH /Times-Roman SF 10780 XM (Sample package of security exit routines.)SH /Symbol SF 10070 36230 MT (\267)SH /Times-Roman SF 10780 XM (Support for data objects on a remote CICS.)SH /Symbol SF 10070 38219 MT (\267)SH /Times-Roman SF 10780 XM (Cleaner performance of server-mode BYE function, dependent on local conventions.)SH /Symbol SF 10070 40208 MT (\267)SH /Times-Roman SF 10780 XM (Support for indirect TD queues.)SH /Symbol SF 10070 42197 MT (\267)SH /Times-Roman SF 10780 XM (Mechanism for flushing terminal output from Kermit \050such as for the TYPE subcommand\051.)SH /Symbol SF 10070 44186 MT (\267)SH /Times-Roman SF 10780 XM (Mechanism for collecting "terminal" output from invoked programs.)SH /Symbol SF 10070 46175 MT (\267)SH /Times-Roman SF 10780 XM (Testing under CICS/VM.)SH /Symbol SF 10070 48164 MT (\267)SH /Times-Roman SF 10780 XM (SET REPEAT subcommand.)SH /Symbol SF 10070 50153 MT (\267)SH /Times-Roman SF 10780 XM (CONNECT subcommand. This may be impossible.)SH 8280 52545 MT (Anyone interested in working on these or other improvements should first get in touch with the) 258 W( Center for)259 W 8280 53741 MT (Computing Activities at Columbia University to find) 16 W( out if someone else has already begun a similar project \050and, if)15 W 8280 54937 MT (so, who\051.)SH ES %%Page: 44 45 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 44)SH 12 /Times-Bold AF 42185 XM (Kermit User's Guide)SH 46800 50 6120 5709 UL ES %%Page: 45 46 BS 0 SI 12 /Times-Bold AF 8280 4404 MT (IBM System/370 Kermit)SH 10 /Times-Italic AF 51775 XM (Page 45)SH 46800 50 8280 5709 UL 16 /Times-Bold AF 8280 8272 MT (Index)SH 8 /Times-Roman AF 12280 10429 MT (3174 1,) 400 W( 14)SH 35320 XM (Filename collision) SH( 17,) 400 W( 34, 40, 41)SH 12280 11353 MT (3708 14)400 W 35320 XM (Flow control) SH( 25)400 W 35320 12277 MT (Folding 10,) 400 W( 17, 40)SH 12280 13201 MT (Alternate lines) SH( 19)400 W 35320 XM (Foreign 8,) 400 W( 18)SH 12280 14125 MT (Appending 17)400 W 35320 XM (Front end) SH( 1)400 W 12280 15049 MT (Arabic 2,) 400 W( 20)SH 35320 XM (Full screen) SH( 9,) 400 W( 25)SH 12280 15973 MT (ASCII-to-EBCDIC 13)400 W 12280 16897 MT (Attributes.)SH /Times-Italic SF 15878 XM (See)SH /Times-Roman SF 17188 XM (File attributes)SH 35320 XM (GET 9)400 W 12280 17821 MT (Automatic operation) SH( 37)400 W 35320 XM (GIVE 9,) 400 W( 39)SH 35320 18745 MT (Greek 2,) 400 W( 20)SH 12280 19669 MT (Batch jobs) SH( 7,) 400 W( 38, 42)SH 12280 20593 MT (Binary files) SH( 1,) 400 W( 10, 17, 18)SH 35320 XM (Handshake 18,) 400 W( 25, 36)SH 12280 21517 MT (Blanks)SH 35320 XM (Hebrew 2,) 400 W( 20)SH 13378 22441 MT (preserving trailing) SH( 18,) 400 W( 41)SH 35320 XM (HELP 40)400 W 13378 23365 MT (stripping 2,) 400 W( 18, 19)SH 35320 XM (Host commands) SH( 9,) 400 W( 20, 38)SH 13378 24289 MT (trailing 2,) 400 W( 19)SH 12280 25213 MT (BLKSIZE 2)400 W 35320 XM (IBM 1,) 400 W( 33)SH 12280 26137 MT (Block check) SH( 13)400 W 35320 XM (Incomplete files) SH( 10,) 400 W( 19)SH 35320 27061 MT (Initialization files) SH( 1,) 400 W( 6, 17, 20, 22, 33, 34, 36, 42)SH 12280 27985 MT (Cancelling a file transfer) SH( 10)400 W 12280 28909 MT (Character sets) SH( 2,) 400 W( 16, 20, 21)SH 35320 XM (Kanji 2,) 400 W( 16, 20)SH 12280 29833 MT (CICS 16,) 400 W( 17, 33)SH 35320 XM (Katakana 2,) 400 W( 20)SH 12280 30757 MT (CICS command level) SH( 38,) 400 W( 42)SH 12280 31681 MT (CMS 16,) 400 W( 17)SH 35320 XM (Languages 2)400 W 12280 32605 MT (Code pages) SH( 2)400 W 35320 XM (Local 8)400 W 13778 33529 MT (See also) SH( Character) 400 W( sets)SH 35320 XM (LOCAL-ECHO 25)400 W 12280 34453 MT (Collision.)SH /Times-Italic SF 15613 XM (See)SH /Times-Roman SF 16923 XM (Filename collision)SH 35320 XM (Log files) SH( 33)400 W 12280 35377 MT (Command echoing) SH( 20,) 400 W( 24)SH 35320 XM (Long packets) SH( 10,) 400 W( 22, 24)SH 12280 36301 MT (Command level.)SH /Times-Italic SF 17767 XM (See)SH /Times-Roman SF 19077 XM (CICS command level)SH 35320 XM (LRECL 2,) 400 W( 18, 33)SH 12280 37225 MT (Command prefix) SH( 8,) 400 W( 10, 20)SH 12280 38149 MT (Completion codes) SH( 28,) 400 W( 38)SH 35320 XM (Mail 7)400 W 13778 39073 MT (See also) SH( Error) 400 W( codes)SH 36818 XM (See also) SH( Electronic) 400 W( mail)SH 12280 39997 MT (Control characters) SH( 14,) 400 W( 25)SH 35320 XM (Margins 19)400 W 12280 40921 MT (Controller 14)400 W 35320 XM (MTS 2)400 W 12280 41845 MT (COPY 38)400 W 35320 XM (MUSIC 16,) 400 W( 17)SH 12280 42769 MT (CRLF 2,) 400 W( 18)SH 12280 43693 MT (CSW 16)400 W 35320 XM (Optimum packet size) SH( 11,) 400 W( 19)SH 12280 44617 MT (CWD 39)400 W 35320 XM (Overwriting files) SH( 18)400 W 12280 45541 MT (Cyrillic 2,) 400 W( 16, 20)SH 36818 XM (See also) SH( Filename) 400 W( collision)SH 12280 47389 MT (Debugging 14)400 W 35320 XM (Packet size) SH( 11,) 400 W( 22)SH 12280 48313 MT (DELETE 38)400 W 35320 XM (Parity 22,) 400 W( 25)SH 12280 49237 MT (Delimiter 41)400 W 35320 XM (Pipes 35)400 W 12280 50161 MT (Directories 35,) 400 W( 39, 42)SH 35320 XM (Prefix.)SH /Times-Italic SF 37674 XM (See)SH /Times-Roman SF 38984 XM (Command, Eighth-bit, Foreign)SH 12280 51085 MT (DIRECTORY 38,) 400 W( 39)SH 35320 XM (Prefixing 14)400 W 12280 52009 MT (Discarding files) SH( 17,) 400 W( 19, 30)SH 35320 XM (Printing files) SH( 7,) 400 W( 38)SH 13778 52933 MT (See also) SH( DELETE)400 W 35320 XM (Prompt 19)400 W 12280 53857 MT (DOS-4 2)400 W 12280 54781 MT (Dumping storage) SH( 15)400 W 35320 XM (Qualified File Names) SH( 34,) 400 W( 35, 39, 42)SH 35320 55705 MT (Queues)SH 12280 56629 MT (EBCDIC-to-ASCII 13)400 W 36818 XM (See also) SH( TD,) 400 W( TS)SH 12280 57553 MT (ECHO 8)400 W 35320 XM (Quotas 35)400 W 13778 58477 MT (See also) SH( Command) 400 W( echoing)SH 35320 XM (Quote.)SH /Times-Italic SF 37675 XM (See)SH /Times-Roman SF 38985 XM (Prefix)SH 12280 59401 MT (Eighth-bit prefix) SH( 21,) 400 W( 23)SH 12280 60325 MT (Electronic mail) SH( 7,) 400 W( 38)SH 35320 XM (Raw transmission) SH( 8,) 400 W( 25)SH 12280 61249 MT (End of file) SH( 16)400 W 35320 XM (RECEIVE 9,) 400 W( 10, 40)SH 12280 62173 MT (Error codes) SH( 28,) 400 W( 36)SH 35320 XM (RECFM 2,) 400 W( 42)SH 12280 63097 MT (Extended ASCII) SH( 13)400 W 35320 XM (Records 2)400 W 35320 64021 MT (Remote 8)400 W 12280 64945 MT (File attributes) SH( 2,) 400 W( 13, 23)SH 35320 XM (RENAME 17,) 400 W( 38)SH 12280 65869 MT (File disposition) SH( 7)400 W 35320 XM (Renaming files) SH( 17)400 W 12280 66793 MT (File management) SH( 38)400 W 36818 XM (See also) SH( File) 400 W( renaming)SH 12280 67717 MT (File renaming) SH( 17)400 W 35320 XM (ROSCOE 16,) 400 W( 17)SH 12280 68641 MT (File truncation) SH( 16)400 W 12280 69565 MT (Fileclass 34,) 400 W( 35, 39)SH 35320 XM (Screen refresh) SH( 26)400 W ES %%Page: 46 47 BS 0 SI 10 /Times-Italic AF 6120 4404 MT (Page 46)SH 12 /Times-Bold AF 42185 XM (Kermit User's Guide)SH 46800 50 6120 5709 UL 8 /Times-Roman AF 10120 7749 MT (SEND 9,) 400 W( 10, 40)SH 10120 8673 MT (SEND delay) SH( 16)400 W 10120 9597 MT (Series/1 1,) 400 W( 14, 33)SH 10120 10521 MT (SERVER 11)400 W 10120 11445 MT (SET 12,) 400 W( 41)SH 10120 12369 MT (SHOW 23)400 W 10120 13293 MT (SNA 1,) 400 W( 14)SH 10120 14217 MT (SPACE 42)400 W 10120 15141 MT (Spool files) SH( 35)400 W 10120 16065 MT (STATUS 24)400 W 10120 16989 MT (STOP 24)400 W 10120 17913 MT (Stripping blanks.)SH /Times-Italic SF 15785 XM (See)SH /Times-Roman SF 17095 XM (Blanks)SH 10120 18837 MT (Subcommand prefix.)SH /Times-Italic SF 17028 XM (See)SH /Times-Roman SF 18338 XM (Command prefix)SH 10120 19761 MT (Submitting jobs) SH( 7)400 W 11618 20685 MT (See also) SH( Batch) 400 W( jobs)SH 10120 22533 MT (Tabs 20)400 W 10120 23457 MT (TAKE 24,) 400 W( 35, 42)SH 10120 24381 MT (TAKE files) SH( 35)400 W 10120 25305 MT (TD queues) SH( 34,) 400 W( 41)SH 10120 26229 MT (TDUMP 25)400 W 10120 27153 MT (TEST 20)400 W 10120 28077 MT (TGET 16)400 W 10120 29001 MT (Thai 2)400 W 10120 29925 MT (Timeout 19,) 400 W( 23, 25)SH 10120 30849 MT (TPUT 16)400 W 10120 31773 MT (Tracing execution) SH( 15,) 400 W( 25)SH 10120 32697 MT (Trailing blanks.)SH /Times-Italic SF 15384 XM (See)SH /Times-Roman SF 16694 XM (Blanks)SH 10120 33621 MT (Transaction log) SH( 10,) 400 W( 25)SH 10120 34545 MT (Translation 1,) 400 W( 3, 21)SH 10120 35469 MT (Translation tables) SH( 2,) 400 W( 9, 21, 39, 42)SH 10120 36393 MT (Transparent mode) SH( 8,) 400 W( 25)SH 10120 37317 MT (Truncation 10,) 400 W( 17, 40)SH 11618 38241 MT (See also) SH( File) 400 W( truncation)SH 10120 39165 MT (TS queues) SH( 34)400 W 10120 40089 MT (TSO 16,) 400 W( 17)SH 10120 41013 MT (TTY 1,) 400 W( 14, 25, 33, 36)SH 10120 41937 MT (Type 10,) 400 W( 11, 38)SH 10120 43785 MT (Userids 35)400 W 10120 45633 MT (Warning 17)400 W 10120 46557 MT (Wildcards 36,) 400 W( 40)SH 10120 48405 MT (XECHO 8)400 W ES %%Trailer %%Pages: 50 %%DocumentFonts: Times-Roman Times-Bold Times-Italic Times-Accent Courier Courier-Oblique Symbol