home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / flex2 / fl2ker.sty < prev    next >
Text File  |  2020-01-01  |  34KB  |  385 lines

  1. ,* Last update 13 July 1985,ju,lm 5,ll 72,pl 66,hd,ll 60,tfKERMIT-09 User
  2. s guide,,,pg,ft,ll 60,ce 1- ## -,,,ce 2FLEX-09 KERMIT--------------,nj
  3. Author:    Jur van der Burg    Nettelhorst 56    2402 LS    Alphen aan den Rijn    
  4. The NetherlandsLanguage:    C (Compiled with Introl (c) compiler)Version:    3.0Date:
  5.     July 1986,juKERMIT for FLEX has it's roots in the UNIX version. It is enhanced in
  6.  several ways, such as data logging, server mode etc.It should run on about any version
  7.  of the FLEX-09 (tm) or SK*DOS (tm) operating system. It requires 48K of memory. Hardware d
  8. ependent things are kept in the files FLK.H and FLIO.C .FLEX-09 KERMIT has most of the 
  9. features specified in the KERMIT Protocol Manual.,pg1. Remote and Local Operation,i
  10. n 5KERMIT programs can be run in two ways, remote and local. A remote Kermit is usually r
  11. unning on a mainframe, which you have CONNECTed to through a PC or other computer. When KER
  12. MIT runs remotely, all file transfer is done over the job's controlling terminal line -- th
  13. e same line over which you logged in, and to which you would type interactive commands. Wha
  14. t the system thinks is your terminal is really another computer, usually a microcomputer, r
  15. unning its own copy of Kermit.When KERMIT is in "local mode", file transfer is done ove
  16. r an external device, such as a microcomputer's serial communication port, or an assigned t
  17. erminal line on a mainframe. The local Kermit is connected in some way (like a dialout mech
  18. anism) to another computer, again running its own copy of Kermit. A local Kermit is in cont
  19. rol of the screen, a remote Kermit has no direct access to it.Microcomputer KERMITs usu
  20. ally run in local "mode", whereas mainframe Kermits usually need to be given some special c
  21. ommand to run in local mode. Some commands make sense only for remote Kermits, others only 
  22. for local, still others can be used with either. Local and remote operation of KERMIT is sh
  23. own schematically here:,in 0 Micro is Local, Mainframe is Remote:    Communicatio
  24. n Line     (Packets)     +-------------------/    /-----------------+    Other terminals     !    (!    !    !    !     !
  25.     (!    !    !    !    Micro    !    LOCAL    Mainframe    !    !    !    !    REMOTE +
  26. ----------+----------+    +------------+--+--+--+--------+ !    Serial Port    !    !     !    ! !    !    !     !    
  27. ! !    !    !     !    ! !    +---------------+    !    !     Your job's    ! !    ! Packets: 724
  28.     !    !    !     terminal line    ! !    !    !    !    !    ! !    ! File: FOO.BAR !
  29.     !    !    ! !    +---------------+    !    !    ! !    Screen     !    !    ! !    !    !    !
  30.  +---------------+-----+    +------------------------------+    !    ! (Commands)    !    +------------+---------+    \    Keyboard    
  31. \    +----------------------+    You,pg,in 5The KERMIT program on the micro is a local Kermit. It ca
  32. n control the screen, the keyboard, and the port separately, thus it can update the screen 
  33. with status information, watch for interrupt signals from the keyboard, and transfer packet
  34. s on the communications port, all at the same time.The KERMIT program running on the ma
  35. inframe is a remote Kermit. The user logs in to the mainframe through a terminal port. The 
  36. host computer cannot tell that the user is really coming in through a microcomputer. The ke
  37. yboard, screen, and port functions are all combined in user's mainframe terminal line. Ther
  38. efore a remote Kermit is cut off from your screen and keyboard during file transfer.A K
  39. ERMIT server is always remote, and must get its commands from a local KERMIT. The following
  40.  descriptions will indicate when a command must be remote or local.,in 02. Command In
  41. terface,in 5The FLEX-09 implementation has an interactive keyword-style command inter
  42. face, modeled after that of the DEC VAX/VMS operating system, which is roughly as follows:
  43. In response to the "Kermit-xx>" prompt you may type a keyword, such as SEND, RECEIVE, o
  44. r EXIT, possibly followed by additional keywords or operands, each of which is called a fie
  45. ld. You can abbreviate keywords (but not file names) to any length that makes them distingu
  46. ishable from any other keyword valid for that field. The command is terminated by a carriag
  47. e return. Before the carriage return is typed, the command can be edited using RUBOUT or ot
  48. her command editing keys. Finally, the same command is entered again with a minimum of keys
  49. trokes, with each field abbreviated to its shortest unique length.,in 03. Notation
  50. ,in 5In the command descriptions, the following notation is used:anything,in 15
  51. A parameter - the symbol is replaced by an argument of the specified type (number, filena
  52. me, etc).,in 5[anything],in 15An optional field. If omitted, it defaults to an a
  53. ppropriate value.,in 5number,in 15A whole number, entered in hexadecimal or decim
  54. al notation.,in 5character,in 15A single character, entered literally, or as a nu
  55. mber (perhaps decimal or hexadecimal) representing the ASCII value of the character.,in
  56.  5file-spec,in 15A file specification, i.e. the name of a file, possibly including a 
  57. drive number or other qualifying information, and possibly containing "wildcard" or pattern
  58. -matching characters to denote a group of files.,in 5^X,in 15A control character 
  59. may be written using "uparrow" or "caret" notation, since many systems display control char
  60. acters this way. Control characters are produced by holding down the key marked CTRL or Con
  61. trol and typing the appropriate character, e.g. X.,in 5Commands are shown in upper ca
  62. se, but can be entered in any combination of upper and lower case.,in 04. Summary of 
  63. KERMIT Commands,in 5Here is a brief list of KERMIT commands as they are found in the 
  64. FLEX-09 KERMIT program. The following sections will describe these commands in detail.,
  65. in 5For exchanging files:    SEND, RECEIVE, GETFor connecting to a remote host:    
  66. CONNECT, SET LINE, SET CONFIGURATION, SET BAUD, SET DUPLEX,    SET HANDSHAKE, SET ESCAP
  67. E, SET PROMPT, SET LOGFor acting as a server:    SERVERFor talking to a server:
  68.     BYE, FINISH, GET, SENDSetting nonstandard transmission and file parameters:    SE
  69. T BLOCK_CHECK_TYPE, SET DEBUG, SET DELAY, SET FILETYPE,    SET INCOMPLETE, SET WARNING, S
  70. ET CONFIGURATION, SET RETRY,    SET END_OF_LINE, SET START_OF_PACKET, SET PACKET_LENGTH,
  71.     SET TIMEOUT, SET PADDING, SET PADCHAR, SET QUOTE,    SET REPEAT_QUOTE, SET EIGHT_BI
  72. T_QUOTE, TAKEFor interrupting transmission:    Control-X, Control-ZGetting inform
  73. ation:    HELP, STATISTICS, SHOW, Control-DFor recording the history of a file transf
  74. er operation:    SET DEBUG LOGFor non-protocol file capture or transmission:    SET
  75.  LOG, TRANSMITLeaving the program:    EXIT, QUITIf you have a file called KERMIT.
  76. INI in your default or home disk, KERMIT will execute an automatic TAKE command on it upon 
  77. initial startup. KERMIT.INI may contain any KERMIT commands, for instance SET commands to c
  78. onfigure KERMIT to various systems or communications media.,in 05. The SEND Command
  79. ,si 3Syntax: SEND filespec [filespec2] [filspec3...],in 5The SEND command cause
  80. s a file or file group to be sent to the other system. The filespec may contain the commonl
  81. y used wild-card characters '*' and/or '?', where '*' stands for a string match (including 
  82. null) and '?' stands for a single character match. Use of wildcard characters is the most c
  83. ommon method of indicating a group of files in a single file specification. For instance if
  84.  FOO.BAS is a single file, a BASIC program named FOO, then *.BAS might be a group of BASIC 
  85. programs. If filespec1 contains wildcard characters then all matching files will be sent, i
  86. n directory-listing order by name. If a file can't be opened for read access, it will be sk
  87. ipped. There may be a total of twenty files or file groups specified.,si -2SEND Comma
  88. nd General OperationFiles will be sent with their filename and filetype (for instance F
  89. OO.BAR, no device or directory field, no generation number or attributes). If communication
  90.  line parity is being used (see SET CONFIGURATION), the sending KERMIT will request that th
  91. e other KERMIT accept a special kind of prefix notation for binary files. This is an advanc
  92. ed feature, and not all KERMITs have it; if the other KERMIT does not agree to use this fea
  93. ture, binary files cannot be sent correctly.,si -2SEND Remote OperationIf you are
  94.  running KERMIT remotely (for instance, from a microcomputer), you should "escape back" to 
  95. your local Kermit within a reasonable amount of time and give the RECEIVE command. Don't ta
  96. ke more than about one minute to complete the switch, or KERMIT may "time out" and give up 
  97. (in that case, you'll have to CONNECT back to the remote system and reissue the SEND comman
  98. d).,si -2SEND Local OperationIf you're running KERMIT locally, for instance on a 
  99. microcomputer, you should have already run KERMIT on the remote system and issued either a 
  100. RECEIVE or a SERVER command.Once you give KERMIT the SEND command, the name of each fil
  101. e will be printed on your screen as the transfer begins, and information will be displayed 
  102. to indicate the packet traffic. When the specified operation is complete, the program will 
  103. sound a beep, and the status of the operation will be indicated by the message Complete, In
  104. terrupted, or Failed.If you see many packet retry indications, you are probably sufferi
  105. ng from a noisy connection. You may be able to cut down on the retransmissions by using SET
  106.  PACKET_LENGTH to decrease the packet length; this will reduce the probability that a given
  107.  packet will be corrupted by noise, and reduce the time required to retransmit a corrupted 
  108. packet. If you notice a file being sent which you do not really want to send, you may cance
  109. l the operation immediately by typing either Control-X or Control-Z. If your are sending a 
  110. file group, Control-X will cause the current file to be skipped, and KERMIT will go on to t
  111. he next file, whereas Control-Z will cancel sending the entire group and return you to KERM
  112. IT-09 command level.,in 06. The RECEIVE Command,si 3Syntax:    RECEIVE [filespe
  113. c],in 5The RECEIVE command tells KERMIT to wait for the arrival a file or file group 
  114. sent by a SEND command from the other system. If only one file is being received, you may i
  115. nclude the optional filespec as the name to store the incoming file under; otherwise, the n
  116. ame is taken from the incoming file header. If the name in the header is not a legal file n
  117. ame on the local system, KERMIT will attempt to transform it to a legal name. If an incomin
  118. g file has the same name as an existing file, KERMIT will either overwrite the old file or 
  119. else try to create a new unique name, depending on the setting of FILE WARNING.If you h
  120. ave SET CONFIGURATION with parity, then 8th-bit prefixing will be requested. If the other s
  121. ide cannot do this, binary files cannot be transferred correctly. The sending KERMIT may al
  122. so request that repeated characters be compressed.If an incoming file does not arrive i
  123. n its entirety, KERMIT will normally discard it; it will not appear in your directory. You 
  124. may change this behavior by using the command SET INCOMPLETE KEEP, which will cause as much
  125.  of the file as arrived to be saved in your directory.,si -2RECEIVE Remote Operation
  126. If your are running KERMIT remotely, you should escape back to your local Kermit and gi
  127. ve the SEND command. You should do this within about one minute, or KERMIT may time out and
  128.  give up; if this happens, you can CONNECT back to the remote system and reissue the RECEIV
  129. E command.,si -2RECEIVE Local OperationIf you are running KERMIT locally, you sho
  130. uld already have issued a SEND command to the remote KERMIT, and then escaped back to KERMI
  131. T-09 (not SERVER -- use the GET command to receive files from a KERMIT server).As files
  132.  arrive, their names will be shown on your screen, along with a continuous display the pack
  133. et traffic.If a file begins to arrives that you don't really want, you can attempt to c
  134. ancel it by typing Control-X; this sends a cancellation request to the remote Kermit. If th
  135. e remote Kermit understands this request (not all implementations of Kermit support this fe
  136. ature), it will comply; otherwise it will continue to send. KERMIT-09 will detect this situ
  137. ation and send an error packet. If a file group is being sent, you can request the entire g
  138. roup be cancelled by typing Control-Z.,in 07. GET,si 3LOCAL ONLY -- Syntax: GET
  139.  remote-filespec [filespec2...],in 5The GET command requests a remote KERMIT server t
  140. o send the file or file group specified by remote-filespec. Note the distinction between th
  141. e RECEIVE and GET commands: RECEIVE puts KERMIT into a passive wait state, whereas GET acti
  142. vely sends a command to a server.The GET command can be used only when KERMIT is local,
  143.  with a KERMIT server on the other end of the line. This means that you must have CONNECTed
  144.  to the other system, logged in, run KERMIT there, issued the SERVER command, and escaped b
  145. ack to the local KERMIT.The remote filespec is any string that can be a legal file spec
  146. ification for the remote system; it is not parsed or validated locally. As files arrive, th
  147. eir names will be displayed on your screen, along with a continuous indication of the packe
  148. t traffic. As in the RECEIVE command, you may type Control-X to request that the current in
  149. coming file be cancelled, Control-Z to request that the entire incoming batch be cancelled.
  150. If the remote KERMIT is not capable of server functions, then you will probably get an 
  151. error message back from it like "Illegal packet type". In this case, you must connect to th
  152. e other Kermit, give a SEND command, escape back, and give a RECEIVE command.,in 08. 
  153. SERVER,si 3Syntax: SERVER,in 5The SERVER command instructs KERMIT to cease taki
  154. ng commands from the keyboard and to receive all further instructions in the form of KERMIT
  155.  packets from another system. A KERMIT server must be remote; that is, you must be logged i
  156. n to the system through another computer, such as a microcomputer. In addition, your local 
  157. KERMIT should have commands for communicating with remote servers; these include GET, FINIS
  158. H, and BYE.After issuing this command, escape back to your local system and issue SEND,
  159.  GET, BYE, FINISH, or other server-oriented commands from there. If your local KERMIT does 
  160. not have a BYE command, then it does not have the full ability to communicate with a KERMIT
  161.  server and you should not put the remote KERMIT into SERVER mode. If your local KERMIT doe
  162. s have a BYE command, use it to shut down and log out the KERMIT server when you are done w
  163. ith it. The KERMIT-09 server can also be shutdown by typing Control-X or Control-Z. Then th
  164. e server will stop after the timeout.Any nonstandard parameters should be selected with
  165.  SET commands before putting KERMIT in server mode, in particular the block check type and 
  166. special file modes.,in 09. BYE,si 3LOCAL ONLY -- Syntax: BYE,in 5When ru
  167. nning as a local Kermit talking to a KERMIT server, use the BYE command to shut down and lo
  168. g out the server. This will also close any debugging log files and exit from the local KERM
  169. IT.,in 010. FINISH,si 3LOCAL ONLY -- Syntax: FINISH,in 5When running as a
  170.  local Kermit talking to a remote KERMIT server use the FINISH command to shut down the ser
  171. ver without logging out the remote job, so that you can CONNECT back to it.,in 011. F
  172. LEX,si 3Syntax: FLEX command,in 5Execute the specified command on the local sys
  173. tem -- on the system where KERMIT to which your are typing this command is running. These c
  174. ommands provide some local file management capability without having to leave the KERMIT pr
  175. ogram, which is particularly useful on microcomputers. Be sure that the programs you run re
  176. side in the utility command space ($C100 - $C6FF).FLEX DELETE filespec    Delete the sp
  177. ecified file or files.FLEX CAT [filespec]    Provide a directory listing of the specifi
  178. ed    files.,in 012. CONNECT,si 3LOCAL ONLY -- Syntax: CONNECT [terminal-desi
  179. gnator],in 5Establish a terminal connection to the system at the other end of the co
  180. mmunication line. On a microcomputer, this is normally the serial port. On a mainframe, you
  181.  will have to specify a terminal line number or other identifier, either in the CONNECT co
  182. mmand itself, or in a SET LINE command. If a log file was opened (see SET LOG) then the dat
  183. a will be buffered in memory, which will be written to disk if it becomes full. Handshaking
  184.  is provided (see SET HANDSHAKE). Get back to the local KERMIT by typing the escape charact
  185. er followed by a single character "command".,pgSeveral single-character commands are po
  186. ssible:    C    Close the connection and return to the local KERMIT.    H    Show ava
  187. ilability.    S    Show status of the connection.    B    Send a BREAK signal.    0    
  188. (zero) Send a NUL (0) character.    Q    Quit logging session transcript.    R    Res
  189. ume logging session transcript.    ?    List all the possible single-character arguments.
  190.     ^    (or whatever you have set the escape character to be)        Typing the escape cha
  191. racter twice sends one copy of it        to the connected host.    other    Rings the bell.
  192. You can use the SET ESCAPE command to define a different escape character, and SET CONF
  193. IGURATION, SET BAUD, SET DUPLEX, SET HANDSHAKE to establish or change those parameters.
  194. ,in 013. HELP,si 3Syntax: HELP [subject] [sub-subject],in 5Typing HELP alone 
  195. prints a brief summary of KERMIT and its commands. Help about a particular topic can be obt
  196. ained by giving it as a parameter. The HELP data file will be searched on the drive KERMIT-
  197. 09 was loaded from.,in 014. EXIT, QUIT,si 3Syntax: EXIT    or:    QUIT,in
  198.  5Exit from KERMIT. QUIT is a synonym for EXIT. If a log file was used with CONNECT, and 
  199. the buffer still contains data, then the buffer will we written to disk before terminating 
  200. KERMIT-09.,in 015. The SET Command,si 3Syntax: SET parameter [option] [value]
  201. ,in 5Establish or modify various parameters for file transfer or terminal connection.
  202. When a file transfer operation begins, the two KERMITs automatically exchange special i
  203. nitialization messages, in which each program provides the other with certain information a
  204. bout itself. This information includes the maximum packetsize it wants to receive, the time
  205. out interval it wants the other KERMIT to use, the number and type of padding characters it
  206.  needs, the end-of-line character it needs to terminate each packet (if any), the block che
  207. ck type, the desired prefixes for control characters, characters with the "high bit" set, a
  208. nd repeated characters. Each KERMIT program has its own preset "default" values for these p
  209. arameters, and you normally need not concern yourself with them. You can examine their valu
  210. es with the SHOW command; the SET command is provided to allow you to change them in order 
  211. to adapt to unusual conditions.The following parameters may be SET:,in 7BAUD    S
  212. et the speed of the current communications portBLOCK_CHECK_TYPE Packet transmission error
  213.  detection methodCONFIGURATION    Character parity to useDEBUG     Mode or log fileDEL
  214. AY     How long to wait before starting to sendDUPLEX     For terminal connection, full (re
  215. mote echo) or    half (local echo)EIGHT_BIT_QUOTE    Character to use for binary file t
  216. ransfer if    parity usedEND_OF_LINE    End of line characterESCAPE     Character for 
  217. terminal connectionFILETYPE        For setting ascii or binary file type.HANDSHAKE    Selec
  218. ting flow control characters, like XON/XOFFINCOMPLETE    What to do with an incomplete fi
  219. leLINE    Terminal line to use for terminal connection or    file transferLOG    CONN
  220. ECTion logging filePACKET_LENGTH    Length of a packetPADDING    
  221. Number of padding char
  222. actersPADCHAR    
  223. Padding characterPROMPT     Prompt of the local KERMITQUOTE     Charac
  224. ter used to transfer control charactersREPEAT_QUOTE    Character to use for data compress
  225. ionRETRY     How many times to retry a packet before give upSTART_OF_PACKET    Start of 
  226. packet characterTIMEOUT    
  227. Time to wait for a packetWARNING    
  228. File conflict warning fl
  229. ag,in 2SET BAUD,si 1Syntax: SET BAUD number,in 5Set or change the baud ra
  230. te (approximate translation: transmission speed in bits per second) on the currently select
  231. ed communications device. In simple FLEX systems the only allowable baud-rates are 300 and 
  232. 1200. Other interfaces may provide a complete range.,in 2SET BLOCK_CHECK_TYPE,si 
  233. 1Syntax: SET BLOCK_CHECK_TYPE number,in 5KERMIT normally uses a 1-character block c
  234. heck, or "checksum", on each packet. The sender of the packet computes the block check base
  235. d on the other characters in the packet, and the receiver recomputes it the same way. If th
  236. ese quantities agree, the packet is accepted and the transmission proceeds. If they disagr
  237. ee, the packet is rejected and transmitted again.However, the block check is not a fool
  238. proof method of error detection. The normal single-character KERMIT block check is only a 6
  239. -bit quantity (the low order 8 bits of the arithmetic sum folded upon itself). With only si
  240. x bits of accuracy, the chances are one     6in 2    -- that is, 1/64 -- that an error can
  241.  occur which will not be detected in the checksum, assuming that all errors are equally lik
  242. ely.You can decrease the probability that an error can slip through, at the expense of 
  243. transmission efficiency, by using the SET BLOCK_CHECK_TYPE command to select more rigorous 
  244. block check methods. Note that all three methods will detect any single-bit error, or any e
  245. rror in an odd number of bits.The options are:,in 71-CHARACTER-CHECKSUM:,in 1
  246. 5The normal single-character 6-bit checksum.,in 72-CHARACTER-CHECKSUM:,in 15A
  247.  2-character, 12-bit checksum. Reduces the probability of an error going undetected to 1/40
  248. 96, but adds an extra character to each packet.,in 73-CHARACTER-CRC:,in 15A 3-c
  249. haracter, 16-bit Cyclic Redundancy Check, CCITT format. In addition to errors in any odd nu
  250. mber of bits, this method detects double bit errors, all error bursts of length 16 or less,
  251.  and more than 99.99% of all possible longer bursts. Adds two extra characters to each pack
  252. et.,in 5The single character checksum has proven to be quite adequate in practice, mu
  253. ch more effective than straightforward analysis would indicate, since all errors are not eq
  254. ually likely, and a simple checksum is well suited to catching the kinds of errors that are
  255.  typical of telecommunication lines. The other methods should be requested only when the co
  256. nnection is very noisy.Note that the 2- and 3-character block checks are not available 
  257. in all versions of KERMIT; if the other KERMIT is not capable of performing the higher-prec
  258. ision block checks, the transfer will automatically use the standard single-character metho
  259. d.,in 2SET DEBUG,si 1Syntax: SET DEBUG options [file],in 5Record the pack
  260. et traffic, either on your terminal or in a file. Options are:ON    Display each incomi
  261. ng and outgoing packet    (lengthy).OFF    Don't display debugging information (this 
  262. is the    default). If debugging was in effect, turn it off    and close any open debug
  263.  log file.LOG    Log the information to the specified file.During data transfer, de
  264. bugging can be toggled on and off by pressing Control-D. If a log file was opened, it will 
  265. be closed.,in 2SET DELAY,si 1Syntax: SET DELAY number,in 5Specify how man
  266. y seconds to wait before sending the first packet after a SEND command. Use when remote and
  267.  SENDing files back to your local Kermit. This gives you time to "escape" back and issue a 
  268. RECEIVE command. The normal delay is 5 seconds. In local mode or server mode, KERMIT does n
  269. ot delay before sending the first packet.,in 2SET DUPLEX,si 1Syntax: SET DUPLEX
  270.  keyword,in 5For use when CONNECTed to a remote system. The keyword choices are FULL 
  271. and HALF. FULL means the remote system echoes the characters you type, HALF means the local
  272.  system echoes them. FULL is the default, and is used by most hosts. HALF is necessary when
  273.  connecting to IBM mainframes. Half duplex is also called "local echo".,in 2SET ESCAP
  274. E,si 1Syntax: SET ESCAPE character,in 5Specify or change the character you want
  275.  to use to "escape" from remote connections back to KERMIT. This would normally be a charac
  276. ter you don't expect to be using on the remote system, perhaps a control character like ^[,
  277.  ^], ^^, or ^_. KERMIT-09 uses the up-arrow ('^') by default. After you type the escape cha
  278. racter, you must follow it by a single-character "argument", such as "C" for Close Connecti
  279. on. The arguments are listed above, under the description of the CONNECT command.,in 2
  280. SET FILETYPE,si 1Syntax: SET FILETYPE parameter,in 5Establish file-related pa
  281. rameter. This may be either ASCII for text files or BINARY for non-text files. This is a ve
  282. ry important command if you intend to transfer binary files, but is normally unnecessary fo
  283. r transmitting textual files.,in 2SET HANDSHAKE,si 1Syntax: SET HANDSHAKE start
  284.  stop,in 5For communicating with full duplex systems. System-level flow control is no
  285. t necessary to the KERMIT protocol, but it can help to use it if the same method is availab
  286. le on both systems. The most common type of flow control on full duplex systems is XON/XOFF
  287. . If the KERMIT input buffer is filled up to 250 characters, the stop character is sent. If
  288.  the buffer becomes empty and contains only 10 characters, the start character will be send
  289. . The defaults for start is XON (17), and for stop XOFF (19).,nl 5,in 2SET INCOMPLE
  290. TE,si 1Syntax: SET INCOMPLETE option,in 5Specify what to do when a file transfe
  291. r fails before it is completed. The options are DISCARD (the default) and KEEP. If you choo
  292. se KEEP, then if a transfer fails to complete successfully, you will be able to keep the in
  293. complete part that was received.,in 2SET LINE,si 1Syntax: SET LINE terminal-des
  294. ignator,in 5Specify the terminal line to use for file transfer or CONNECT. This comma
  295. nd is found on mainframe KERMITs, which normally run in "remote mode" using their own contr
  296. olling terminal for file transfer. Specifying a separate line puts the program in "local mo
  297. de". If the line is specified as 'REMOTE', the communication will revert to the job's contr
  298. olling terminal.,in 2SET CONFIGURATION,si 1Syntax: SET CONFIGURATION number
  299. ,in 5Parity is a technique used by communications equipment for detecting errors on a per
  300. -character basis; the "8th bit" of each character acts as a check bit for the other seven b
  301. its. KERMIT uses block checks to detect errors on a per-packet basis, and it does not use c
  302. haracter parity. However, some systems that KERMIT runs on, or equipment through which thes
  303. e systems communicate, may be using character parity. If KERMIT does not know about this, a
  304. rriving data will have been modified and the block check will appear to be wrong, and packe
  305. ts will be rejected.If parity is being used on the communication line, you must inform 
  306. both KERMITs, so the desired parity can be added to outgoing characters, and stripped from 
  307. incoming ones. SET CONFIGURATION should be used for communicating with hosts that require c
  308. haracter parity (IBM mainframes are typical examples) or through devices or networks that a
  309. dd parity to characters that pass through them. Both KERMITs should be set to the same pari
  310. ty. The specified configuration parity is used both for terminal connection (CONNECT) and f
  311. ile transfer (SEND, RECEIVE, GET).The choices for SET CONFIGURATION are:,in 70.    
  312. Seven data bits, even parity and two stop bits.1.    Seven data bits, odd parity and tw
  313. o stop bits.2.    Seven data bits, even parity and one stop bit.3.    Seven data bits, 
  314. odd parity and one stop bit.4.    Eight data bits, no parity and two stop bits.5.    Ei
  315. ght data bits, no parity and one stop bit (default).6.    Eight data bits, even parity an
  316. d one stop bit.7.    Eight data bits, odd parity and one stop bit.,in 5Eight bits m
  317. eans no parity is affecting the data, and the 8th bit of each character can be used for dat
  318. a when transmitting binary files.If you have set to use parity then advanced versions o
  319. f KERMIT (including KERMIT-09) will request that binary files will be transferred using 8th
  320. -bit-prefixing. If the KERMIT on the other side knows how to do 8th-bit-prefixing (this is 
  321. an optional feature of the KERMIT protocol, and not all implementations of KERMIT have it),
  322.  then binary files can be transmitted successfully. If eight-bits communication is specifie
  323. d, 8th-bit-prefixing will not be requested.,in 2SET EIGHT_BIT_QUOTE,si 1Syntax:
  324.  SET EIGHT_BIT_QUOTE character,in 5What character to use to process eight_bit bytes o
  325. ver a line using only seven data bits. The sending KERMIT will ask the other KERMIT whether
  326.  it can handle a special prefix encoding for characters withthe eighth bit on, using the 
  327. eight_bit_quote character. This character should be distinct from the REPEAT_QUOTE characte
  328. r and the QUOTE character. The default is "&" (38). There should be no reason to change thi
  329. s.,in 2SET END_OF_LINE,si 1Syntax: SET END_OF_LINE character,in 5The ASC
  330. II character to be used as a line terminator for packets, if one is required by the other s
  331. ystem, carriage return by default. You will only have to use this command for systems that 
  332. require a line terminator other than carriage return. The character must be specified as a 
  333. hexadecimal number.,in 2SET LOG,si 1Syntax: SET LOG filespec,in 5Create a
  334.  transcript of a CONNECT session, when running a local KERMIT connected to a remote system,
  335.  in the specified file. Logging can be "toggled" by typing the connect escape character fo
  336. llowed by Q (Quit logging) or R (Resume logging). Session-logging is useful for recording d
  337. ialog with an interactive system, and for "capturing" from systems that don't have KERMIT. 
  338. No guarantee can be made that the file will arrive correctly or completely, since no error 
  339. checking takes place. The log file will be closed if the filespec is a dash ("-").,in 2
  340. SET PACKET_LENGTH,si 1Syntax: SET PACKET_LENGTH number,in 5Maximum packet len
  341. gth to send between 10 and 94 (decimal). Shortening the packets might allow more of them to
  342.  get through through without error on noisy communication lines. Lengthening the packets in
  343. creases the throughput on clean lines.,in 2SET TIMEOUT,si 1Syntax: SET TIMEOUT 
  344. number,in 5How many seconds to wait for a packet before trying again.,in 2SET P
  345. ADDING,si 1Syntax: SET PADDING number,in 5How much padding to send before a pac
  346. ket, if the other side needspadding. Default is no padding.,in 2SET PADCHAR,si 
  347. 1Syntax: SET PADCHAR character,in 5What kind of padding character to send. Default 
  348. is NUL (0). The character must be specified as a hexadecimal number.,in 2SET QUOTE
  349. ,si 1Syntax: SET QUOTE character,in 5What printable character to use for quotin
  350. g of control characters. This character should be distinct from the EIGHT_BIT_QUOTE charact
  351. er and the REPEAT_QUOTE character. The default is "#" (35). There should be no reason to c
  352. hange this.,in 2SET REPEAT_QUOTE,si 1Syntax: SET REPEAT_QUOTE character,in 
  353. 5What character to use to process repeat count characters. The sending KERMIT will ask th
  354. e other KERMIT whether it can handle a special prefix encoding for repeated characters, usi
  355. ng the repeat_quote character. This character should be distinct from the EIGHT_BIT_QUOTE c
  356. haracter and the QUOTE character. The default is "~" (126). There should be no reason to c
  357. hange this.,in 2SET RETRY,si 1Syntax: SET RETRY number,in 5Set the maximu
  358. m number of retries for how many times to try sending a particular packet before giving up,
  359.  normally 10. If a line is very noisy, you might want to increase this number.,in 2SE
  360. T START_OF_PACKET,si 1Syntax: SET START_OF_PACKET character,in 5The start-of-pa
  361. cket character is the only control character used "bare" by the KERMIT protocol. It is Cont
  362. rol-A by default. If a bare Control-A causes problems for your communication hardware or so
  363. ftware, you can use this command to select a different control character to mark the start 
  364. of a packet. You must also set the start_of_packet character at the KERMIT on the other sys
  365. tem (providing it has such a command). The character must be specified as a hexadecimal num
  366. ber.,nl 5,in 2SET WARNING,si 1Syntax: SET WARNING keyword,in 5Enable or d
  367. isable the warning if an incoming file already exists, where the keyword must be either ON 
  368. or OFF. When set to ON (the default) and an incoming file already exists, an attempt will b
  369. e made to store the file under a new and unique name. When set to OFF, an existing file wi
  370. ll be overwritten.,in 016. SHOW,si 3Syntax: SHOW option,in 5The SHOW comm
  371. and displays the values of the parameters settable by the SET command. If the option is ALL
  372. , then a complete display will be provided.,in 017. STATISTICS,si 3Syntax: STAT
  373. ISTICS,in 5Give statistics about the most recent file transfer, such as the total num
  374. ber of characters transmitted, the effective baud rate (only if a hardware clock is availab
  375. le), and so forth.,in 018. TAKE,si 3Syntax: TAKE filespec,in 5Execute KER
  376. MIT commands from the specified file. The file may contain any valid KERMIT commands, inclu
  377. ding other TAKE commands.,in 019. TRANSMIT,si 3Syntax: TRANSMIT filespec,in
  378.  5Send the contents of the specified file to the other system "bare", without protocol, p
  379. ackets, error checking, or retransmission. This command is useful for sending standard logo
  380. n or connection sequences, or to send commands to a smart modem, or for sending files to sy
  381. stems that don't have KERMIT. No guarantee can be made that the target system will receive 
  382. the file correctly and completely. When receiving a file, the target system would normally 
  383. be running a text editor in text collection mode. The tranferred data will be displayed on 
  384. the screen if DEBUG is on.
  385.