home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / archives / unisysaseries.zip / uaskerdoc.txt < prev   
Text File  |  1990-07-13  |  32KB  |  704 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9. KERMIT for UNISYS A-Series Systems
  10. October 1989
  11.  
  12. Authors:  Larry Johnson, Katie Stevens, Dave Squire
  13.           University of California, Davis
  14.  
  15. Language: Algol
  16. Version:  1.041
  17. Date:     September 28, 1989
  18.  
  19. A-Series KERMIT Capabilities At a Glance:
  20.  
  21.      Local operation:                       No
  22.      Remote operation:                      Yes
  23.      Transfers text files:                  Yes
  24.      Transfers binary files:                Yes
  25.      Wildcard send:                         No
  26.      Filename collision avoidance:          No
  27.      Timeouts:                              Yes
  28.      8-th bit prefixing:                    Yes
  29.      Repeat count prefixing:                Yes
  30.      Alternate block check types:           Yes
  31.      Transaction logging:                   No
  32.      Session logging:                       No
  33.      Debug logging:                         Yes
  34.      Act as server:                         Yes
  35.      Advanced server functions:             No
  36.      Command/init files:                    Yes
  37.      Attribute packets:                     No
  38.      Long Packets:                          Yes
  39.      Windowing:                             No
  40.  
  41. Kermit is a program that does reliable file transfer between
  42. computers over data communication lines and has been implemented on
  43. many different machines, including microprocessors.  AS-Kermit,
  44. written in Algol for Unisys A-series systems, communicates with
  45. even the most minimal Kermit implementations.  The program source
  46. is contained in one symbol file and does not require a separate
  47. help file.  The program does not require any special datacom
  48. support.
  49.  
  50. The file transfer protocol uses packets that are checksummed and
  51. acknowledged, and are resent if errors are detected.  Packet
  52. lengths are typically limited to 88 characters of data although
  53. this version allows longer packet sizes to be specified.
  54.  
  55. In the narrative description that follows, there are several
  56. references to AS-Kermit commands.  These commands are all described
  57. in detail in the final section of this document.  Since one Kermit
  58. does not a file transfer make, it is assumed that the reader is
  59. familiar with at least one other implementation of Kermit, namely
  60. the version that runs on the system communicating with AS-Kermit on
  61. the A-series machine.
  62.  
  63.  
  64. UNISYS File System
  65.  
  66. For Kermit users, the most important features of the Unisys A-
  67. Series file system are character set, file title and file
  68. structure.  Since AS-Kermit must be able to transfer files to and
  69. from a large variety of operating systems there are commands to
  70. allow users to control these attributes.
  71.  
  72. Character Set Conversion
  73.  
  74. The default character set of an A-Series file is EBCDIC.  Since
  75. most micros and many other systems use ASCII, it is necessary for
  76. AS-Kermit to translate between these character sets.  When
  77. receiving a file, characters are unconditionally translated from
  78. ASCII to EBCDIC.  When sending a file, AS-Kermit uses the EXTMODE
  79. of the file to control translation.  If the file is already ASCII
  80. then translation does not occur, otherwise an EBCDIC file is
  81. translated to ASCII.  This translation is not important if the file
  82. being transferred is a text file, but since the conversion changes
  83. the bit patterns of each byte, problems arise when the file
  84. contains binary data.  The SET BINARY command is used to preserve a
  85. full eight bit binary byte across the seven bit data path assumed
  86. by AS-Kermit.
  87.  
  88. File Title Conversion
  89.  
  90. Since A-Series file titles are generally incompatible with other
  91. computer system file naming conventions, there are provisions for
  92. title conversion. When sending, AS-Kermit can change an A-Series
  93. file title into one more compatible with other systems; for
  94. receiving, almost any file name may be converted to a usable A-
  95. Series file title.  The SET SEND ACTUAL-TITLE command may be used
  96. to suppress the default conversion of file titles that normally
  97. occurs when sending files.
  98.  
  99. A-Series file titles are of the form:
  100.  
  101.      (USERCODE)NAME1/NAME2/.../NAMEX  ON FAMILYNAME
  102.  
  103.      Up to 12 names, each containing up to 17 characters, may be
  104.      specified.
  105.  
  106. Most micros have file names of the form:  namename.ext, where
  107. namename may be up to 8 characters long, and .ext is an optional
  108. name extension up to 3 characters long.
  109.  
  110. If the default conversion occurs when sending, the filename sent is
  111. the name following the final slash in the A-series title (NAMEX in
  112. the example above).  If the name following the slash is longer than
  113. 8 characters, a  period is inserted after the eighth character and
  114. up to three more characters are used as the name extension.  If the
  115. name is longer than 11 characters,  it is truncated.  The on-part
  116. is not sent and the usercode is removed from the file title
  117. regardless of the state of SEND ACTUAL-TITLE.
  118.  
  119.      A-Series file title:   (USERCODE)NAME1/.../LONGERTHAN11 ON MYFAM
  120.      Sent as:               longerth.an1
  121.  
  122. Additionally, since AS-Kermit uses one or more blanks as a token
  123. delimiter, files may not be sent that have blanks as part of a
  124. quoted name, nor can an on-part be specified in a SEND command.  To
  125. send a file from a named pack,  that pack must be part of a FAMILY
  126. statement specified before running AS-Kermit.
  127.  
  128. When receiving files, file name conversion is controlled by RECEIVE
  129. ACTUAL-TITLE.  If this attribute is set, the only modification AS-
  130. Kermit makes is to translate all lowercase letters in the file
  131. title to uppercase.  If the resulting name is not a valid A-Series
  132. filename the receive will fail.  If this attribute is not set, AS-
  133. Kermit converts the name supplied by the sender into a title with
  134. the following rules:
  135.  
  136.      1)  Lower case is translated to upper case and extraneous
  137.          slashes are deleted.
  138.  
  139.      2)  If a name is longer than 17 characters, it is broken up
  140.          into multiple 17 (or fewer) character names separated by
  141.          slashes.
  142.  
  143.      3)  Names that contain non-alphanumeric characters, including
  144.          periods, are enclosed in quotes.
  145.  
  146.      4)     The new title can have no more than 12 names.
  147.  
  148. Since slash is used as a name separator, about the only string that
  149. won't produce a valid A-Series title is one of all slashes.
  150.  
  151.      File sent as:     /justabitlongerthan17/"a/"//"zT"/abc.ext
  152.      A-series title:    JUSTABITLONGERTHA/N17/"A/"/ZT/"ABC.EXT"
  153.  
  154. Unless the A-Series site runs AS-Kermit as a privileged program,
  155. files can not be directed to another usercode.  To specify a
  156. usercode and/or a named pack, RECEIVE ACTUAL-TITLE must be set and
  157. a valid A-Series title specified with the usercode in parentheses
  158. and/or the on-part following the name.
  159.  
  160. File Structure Conversion
  161.  
  162. The file system on an A-Series computer is based on fixed-length,
  163. blocked records. Some other systems also use this method, but many
  164. systems use variable-length records with a character such as a
  165. linefeed for a record separator. The SET FILE commands control the
  166. manner in which AS-Kermit converts between fixed and variable
  167. length file formats.
  168.  
  169. For AS-Kermit to be able to open a disk file for sending, the file
  170. must have FILEORGANIZATION of NOTRESTRICTED,  which is the default
  171. for disk files on an A-Series system.
  172.  
  173. Sending Conversion
  174.  
  175. The default for AS-Kermit is to convert from fixed-length to
  176. variable-length records and to insert the two character separator
  177. consisting of <carriage return, linefeed> between records.  After
  178. the possible translation to ASCII, variable-length records are made
  179. by stripping trailing blanks and characters less than blank off the
  180. end of the fixed-length record read from the disk file.  SET FILE
  181. FIXED may be used to inhibit the stripping of these trailing
  182. characters.
  183.  
  184. SET FILE RAW may be used to not only inhibit the stripping of
  185. characters but to also inhibit the insertion of record separators.
  186.  
  187. Receiving Conversion
  188.  
  189. When receiving a file, AS-Kermit creates a diskfile with the
  190. following defaults:  MAXRECSIZE = 15, BLOCKSIZE = 420, UNITS =
  191. WORDS.  The SET FILE commands may be used to change these
  192. attributes but they must remain compatible.  If a warning about
  193. blocksize-recordsize incompatibility is given, the values must be
  194. corrected before receiving a file.
  195.  
  196. AS-Kermit converts the received records to fixed length format disk
  197. file using the following rules:
  198.  
  199.      1)  Any occurance of a linefeed is used to end a record. If
  200.          the record received is shorter than a disk file record,
  201.          it is padded with trailing blanks.  If the record
  202.          received is longer than a disk record, it is split into
  203.          two or more records, and the last one is padded with
  204.          blanks if necessary. The linefeed is not included in the
  205.          disk record.
  206.  
  207.      2)  Carriage returns are discarded. It is assumed that they
  208.          are part of the record separator.
  209.  
  210.      3)  Tabs (HT) are converted to blanks. The tab positions are
  211.          in 8-column fixed positions.  When a tab is encountered,
  212.          blanks are inserted in the disk record to move to the
  213.          next tab position.  The tab conversion can be disabled
  214.          with SET FILE EXPAND-TABS OFF.  In this case, the tab
  215.          characters are written into the disk file.
  216.  
  217. One other option exists for file reception.  SET FILE RAW ON may be
  218. used to override the record and the character conversions mentioned
  219. above. The disk file generated on the A-Series system is then a
  220. byte-by-byte copy of the received file, translated to EBCDIC.
  221. Setting  RAW ON  also sets EXPAND-TABS OFF.
  222.  
  223. Transfers fail if the sending Kermit tries to use the parity bit
  224. for data.  The local Kermit should have its communication set up
  225. for 7-bit if there are non-graphic characters in the file to be
  226. transferred.  With some Kermits, this can only be done by setting
  227. parity to "space".  Files containing EBCDIC characters that
  228. translate into ASCII characters with a value greater than 127
  229. cannot be sent by AS-Kermit unless BINARY is ON.
  230.  
  231. Running AS-Kermit
  232.  
  233. AS-Kermit must be run interactively, and only in remote mode.  This
  234. means that AS-Kermit may not be used to call another computer.
  235. Instead, the local system communicating with the A-series machine
  236. must run its version of Kermit.  The local Kermit's terminal
  237. emulator is then used to log-on to A-series Cande and to run AS-
  238. Kermit.  Thus the user needs to be familiar with both AS-Kermit and
  239. the Kermit version running on the local system.  The following
  240. discussion, from the point of view of a user running a local Kermit
  241. on a computer in communication with an A-series host, refers to the
  242. user's system the local system.
  243.  
  244. The first step in any file transfer is to run Kermit on the local
  245. system.  When beginning execution, most versions of Kermit load an
  246. optional initialization file and then prompt for a command.  To
  247. talk to the A-Series system, the CONNECT command is entered in
  248. order to begin terminal emulation. The keyboard and screen of the
  249. local system then act as a terminal and the user connects to the A-
  250. series computer according to the method used at the particular
  251. site.  This might consist of telling the local system modem to dial
  252. out, or if the local system is directly connected to a network
  253. switch, simply specifying the A-series host in response to a
  254. "request" prompt.
  255.  
  256. Once connected, the user logs on to Cande and then runs AS-Kermit.
  257. At UC Davis, typing "KERMIT" begins this execution, after which an
  258. initialization file, if present, is read (see TAKE command).  A
  259. prompt is then given to enter a command and file transfer may
  260. begin.
  261.  
  262. To transfer from the A-Series, the command SEND followed by the
  263. filename is entered.  The local Kermit  must then be put in receive
  264. mode.  For most PC Kermits, "CONTROL-[ c", that is, CONTROL (CTRL)
  265. and [ keys at the same time, then "c", escapes to command mode,
  266. from which RECEIVE is entered in order to start receiving the file.
  267. On a Macintosh, the FILE menu choice RECEIVE must be clicked. When
  268. the transfer finishes, the Macintosh returns to terminal mode.
  269. Other versons usually return to command mode from which a CONNECT
  270. command is needed to restart terminal emulation in order to again
  271. communicate with AS-Kermit and begin another transfer.
  272.  
  273. To transfer a file to the A-series machine, the RECEIVE command is
  274. entered, then after returning to command mode on the local system a
  275. SEND is entered.  If the files being sent to the A-Series system
  276. need different record or block sizes, then the appropriate AS-
  277. Kermit commands must be entered before receiving each file.
  278.  
  279. Server Mode
  280.  
  281. Server mode may be used to transfer several files in both
  282. directions.  In this mode AS-Kermit takes commands from the other
  283. Kermit instead of the keyboard. Instead of using SEND or RECEIVE
  284. commands, the AS-Kermit SERVER command is used before going back to
  285. command mode on the local Kermit.  The SEND command is used on the
  286. local Kermit to transfer files to the A-Series system but the GET
  287. command is used from the local Kermit to transfer files from the A-
  288. Series system.  This method saves having to go back and forth
  289. between the two Kermits to transfer files.
  290.  
  291. The FINISH command from the local Kermit terminates AS-Kermit, but
  292. it is necessary to connect back in order to log off from the CANDE
  293. session.  When exiting the local Kermit it may not disconnect from
  294. the communication line so it is advisable to execute the HANGUP
  295. command before the EXIT command.
  296.  
  297. AS-Kermit commands
  298.  
  299. Kermit commands can be abbreviated using the minimally
  300. distinguishable string.  For example, as a command SE could be
  301. either SET or SEND and produces an error;  R, however, suffices for
  302. RECEIVE.
  303.  
  304. Abbreviations are context-sensitive.  As a command, SE is
  305. ambiguous; however, as an argument to STATUS, SEND may be
  306. abbreviated with S.  To check for ambiguous abbreviations, an
  307. abbreviation followed by ? with no intervening space may be
  308. entered.
  309.  
  310. EXIT    Exit from AS-Kermit, closing any open debugging log
  311.         files.  AS-Kermit may be stopped in the midst of a
  312.         transfer by typing ?DS or ?END.
  313.  
  314. HELP    Give a list of command verbs. Typing <command> ? gives
  315.         the options available for that command.
  316.  
  317. QUIT    A synonym for EXIT.
  318.  
  319. RECEIVE Receive a file or group of files from the local Kermit.
  320.  
  321. SEND <filespec1> <filespec2> ... <filespecn>
  322.  
  323.         Send file(s) specified by <filespec1> <filespec2> ... to
  324.         the local Kermit.  This command is used to send files to
  325.         the local Kermit.  After entering the SEND command to AS-
  326.         Kermit, the user returns to command mode on the local
  327.         Kermit and gives the RECEIVE command.  If this is not
  328.         done quickly enough, several "send-init" packets may
  329.         arrive prematurely,  but AS-Kermit will continue sending
  330.         them until it gets a response or until INITIAL-CONNECTION
  331.         attempts have occured (see SET RETRY ).
  332.  
  333. SERVER  Act as a Kermit Server with default options, or with
  334.         whatever options have been established by previous SET
  335.         commands.  All options remain in effect as long as the
  336.         server is running.  To change an option, the server must
  337.         be shut down and restarted after changing the option.
  338.         The AS-Kermit server may be shut down from the local
  339.         Kermit with the FINISH command, or by connecting back to
  340.         the A-Series system and typing ?DS.  In either case AS-
  341.         Kermit terminates and must be run again to transfer more
  342.         files.
  343.  
  344. SET <parameter>
  345.  
  346.         Set the specified parameter to the specified value.  Some
  347.         parameters have their own parameters.
  348.  
  349.  
  350. SET BINARY <value>
  351.  
  352.         On some systems, transmitting 8-bit data over a typical
  353.         terminal line may result in corruption of the 8th bit.
  354.         Kermit uses "binary quoting" to tell the receiver to
  355.         store a byte with the high bit on.  This method involves
  356.         extra overhead, and it should be used only when necessary
  357.         to guarantee the integrity of the 8th bit of data.  A
  358.         text file does not normally need the eighth bit
  359.         preserved.
  360.  
  361.         <value> = ON:  Use "binary quoting" when transmitting
  362.         bytes with the high bit on.
  363.  
  364.         <value> = OFF:  Do not send any "binary quotes" when
  365.         transmitting.  The received value of the high bit is
  366.         assumed to be arbitrary.  This is the default.
  367.  
  368. SET BLOCK-CHECK <d>
  369.  
  370.         AS-Kermit supports 3 different block-checks, called type
  371.         1, 2 and 3.  Kermit uses block-checks to detect data
  372.         corruption during transmission. The larger values of
  373.         block-check type provide better protection against errors
  374.         at the expense of more processor time used to calculate
  375.         them.  For short packets of less than 100 bytes block-
  376.         check type 1 is adequate.  For longer packets or noisy
  377.         communication lines, larger block-checks may be used.
  378.         The default block-check is 1.  Both Kermits must agree to
  379.         use the same block-check if type 2 or 3 is to be used and
  380.         not all Kermits support all types.
  381.  
  382.         <d> = 1, 2, or 3.
  383.  
  384. SET DEBUGGING <option>
  385.  
  386.         When KERMIT is not transferring files successfully, it
  387.         may be useful to inspect the messages that are sent
  388.         between the two Kermits, or the internal state
  389.         transitions.  Debugging display cannot be done to the
  390.         screen since AS-Kermit cannot run in local mode so debug
  391.         information is written to a disk file.
  392.  
  393.  
  394.         <option> = STATES:  Show the packet number and type or
  395.         internal state for each packet.
  396.  
  397.              S     Send Initiate
  398.              R     Receive Initiate
  399.              F     File Header
  400.              D     Data
  401.              Z     End of File
  402.              B     Break Transmission
  403.              C     Transfer Complete
  404.              E     Error
  405.              A     Abort Transmission
  406.              T     Timeout
  407.              Q     Checksum Failure
  408.  
  409.  
  410.         <option> = PACKETS:  Display the actual incoming and
  411.         outgoing packets.  For a description of the packet
  412.         format, see the Kermit Protocol Manual.
  413.  
  414.         <option> = LOG-FILE <filename>:   This option allows the
  415.         name of the log file to be set, but the <filename>
  416.         parameter can only be a single name.  The file has a
  417.         default title of KERMIT/LOG or may be file-equated when
  418.         running AS-Kermit (INTNAME = LOG).  If there has been no
  419.         previous SET DEBUG command , this command also forces
  420.         DEBUGGING <option> to STATES.  SET DEBUGGING OFF closes
  421.         the log file, as does the EXIT, BYE, and FINISH commands.
  422.  
  423.         <option> = OFF:  No debugging information is displayed.
  424.         If debugging was previously in effect, debugging is
  425.         turned off and any debugging log file is closed.
  426.         Debugging is OFF by default.
  427.  
  428. SET DELAY <d>
  429.  
  430.         Specify the delay, <d> seconds, before sending the first
  431.         send-init packet.  This allows time to exit terminal
  432.         emulation, put the local Kermit in command mode, and to
  433.         enter the  RECEIVE command.  Normal delay is 5 seconds.
  434.  
  435. SET FILE <parameter>
  436.  
  437.         File parameters allow Kermit to control some attributes
  438.         of the files being processed.  The FIXED parameter
  439.         applies to files being read.  The rest of the parameters
  440.         listed below apply to files being written.
  441.  
  442.         BLOCK-SIZE <d>:  Sets the number of UNITS per block for
  443.         the receive file. to <d>.  Default is 420 UNITS/block.
  444.         Also see RECORD-SIZE and UNITS.
  445.  
  446.         EXPAND-TABS <value>:  Since not all software and hardware
  447.         on A-Series systems can deal with tabs, this option
  448.         allows tabs to be expanded into blanks.  The tabs, fixed
  449.         at 8 columns per tab, can not be changed.  Setting RAW
  450.         turns this option OFF.
  451.  
  452.              <value> = ON:  Expand tabs into blanks.  This is the
  453.              default.
  454.  
  455.              <value> = OFF:  Store the tab characters in the output
  456.              file.
  457.  
  458.         FIXED <value>:  Most Kermits use variable-length records
  459.         on their host machines. To be compatible with these
  460.         systems, AS-Kermit converts fixed-length files on an A-
  461.         series host to variable-length records by stripping
  462.         trailing characters less than or equal to ASCII blank
  463.         from each record before transmitting.  This  reduces the
  464.         number of bytes transmitted.  FIXED only applies if RAW
  465.         is OFF.
  466.  
  467.              <value> = ON:  Do not strip trailing characters.  Send
  468.              all the data bytes.
  469.  
  470.              <value> = OFF:  Do not transmit trailing characters.
  471.              This is the default.
  472.  
  473.         RAW <value>:  A-Series systems generally use fixed-length
  474.         record files.  For receiving, this option packs
  475.         characters into fixed-length records regardless of
  476.         newline characters.  For sending, full records with no
  477.         record separator are sent. Setting RAW ON sets EXPAND-
  478.         TABS OFF.  To receive RAW and expand tabs, EXPAND-TABS ON
  479.         must be entered after setting RAW ON.
  480.  
  481.              <value> = ON:  Received records are filled character
  482.              by character. A new record is started only when the
  483.              current record is full. Transmitted records have no
  484.              record separator.
  485.  
  486.              <value> = OFF: This is the default. Records received
  487.              are filled character-by-character. A new record is
  488.              started each time a  newline character is received.
  489.              Records sent are separated by CR, LF.
  490.  
  491.         RECORD-SIZE <d>:  Sets the record length in terms of
  492.         UNITS for the received file to <d>.  Default RECORD-SIZE
  493.         is 15.
  494.  
  495.         UNITS <type>:  Sets the unit used to measure RECORD-SIZE
  496.         and BLOCKSIZE attributes for a file being received.
  497.  
  498.              <type> = CHARACTERS:  Units are eight-bit bytes.
  499.  
  500.              <type> = WORDS:  Units are A-series system words, 48-
  501.              bits/word (6 characters/word).  This is the default.
  502.  
  503. SET INCOMPLETE <disposition>
  504.  
  505.         When a file transfer cannot be completed (for instance,
  506.         because the communication path suddenly breaks or becomes
  507.         too noisy), the Kermit receiving the file can either
  508.         discard or retain the incomplete portion of the file that
  509.         has been received.
  510.  
  511.         <disposition> = DISCARD: Remove the partially received
  512.         file from the A-Series disk.
  513.  
  514.         <disposition> = KEEP:  Retain the file on disk containing
  515.         all the data transferred successfully up until the error
  516.         occurred. This option may be useful when transferring
  517.         very long files, if it is possible for the sending system
  518.         start again at the place it was interrupted, e.g. by
  519.         breaking the end of the file off with a text editor.
  520.         This is the default.
  521.  
  522.  
  523. SET RETRY <parameter> <value>
  524.  
  525.         Set the maximum number of times AS-Kermit will retry an
  526.         operation before giving up and terminating the transfer.
  527.         Possible <parameter> values are INITIAL-CONNECTION and
  528.         PACKETS.  The default <value> settings are 20 and 10,
  529.         respectively, but these can be set higher when the
  530.         connection is noisy, or when other problems prevent a
  531.         transfer from completing successfully.
  532.  
  533. SET RECEIVE <parameter>
  534. SET SEND <parameter>
  535.  
  536.         ACTUAL-FILETITLE <value>: Controls conversion of file
  537.         names to/from A-series format.
  538.  
  539.              <value> = ON:  Do not perform file name conversion.
  540.              Use the file name received for the title,  or send the
  541.              unaltered file title as the file name.
  542.  
  543.              <value> = OFF:  This is the default.  Perform file
  544.              name conversion. Change file names to be usable by the
  545.              receiving system.
  546.  
  547.         END-OF-LINE <d>:  Specify the character with which the
  548.         remote Kermit should terminate its packets.  Carriage
  549.         Return (ASCII 15) is the default.  AS-Kermit requires the
  550.         packet terminator for packets it receives to be a
  551.         carriage return. <d> is the decimal value of the ASCII
  552.         character.
  553.  
  554.         PACKET-LENGTH <d>:  Specify the longest packet the remote
  555.         Kermit may send.  Legal values of <d> are 10 to 2000; the
  556.         default is 94 (88 data bytes plus 6 packet bytes).
  557.  
  558.         PADCHAR <d>:  Specify a padding character to precede
  559.         packets.  Not needed for packets received by AS-Kermit.
  560.  
  561.         PADDING <d>:  Specify the number of padding characters to
  562.         be inserted before packets.   Not needed for packets
  563.         received by AS-Kermit.
  564.  
  565.         PAUSE <d>:  When receiving a file, pause the specified
  566.         number of tenths of a second between receiving a packet
  567.         and sending the acknowledgement (ACK) or the resend (NAK)
  568.         reply.   Default is no pause, <d> = 0.
  569.  
  570.         QUOTE <char>:  Specify the character the remote Kermit
  571.         should use for quoting control characters.  The default
  572.         is "#" and there is generally no reason to change this.
  573.         Permissible values are "!"  to "~" , i.e., the ASCII
  574.         characters in the printable range.  <char> is an actual
  575.         character.
  576.  
  577.         START-OF-PACKET <d>:  Specify the character the remote
  578.         Kermit is using to start its packets, normally ASCII 1
  579.         (SOH).  If the remote Kermit is incapable of transmitting
  580.         an ASCII 1, this command informs AS-Kermit what character
  581.         to expect.  Permissible values are 1 (SOH) to 31 (US).
  582.         <d> is the decimal value of the character.
  583.  
  584.         TIMEOUT <d>:  The number of seconds AS-Kermit waits after
  585.         sending a packet for an acknowledgement from the remote
  586.         Kermit. The delay may be adjusted to accommodate various
  587.         line speeds, or to compensate for slow systems.  Legal
  588.         values for <d> range from 1 to 94 seconds.  The default
  589.         is 5 seconds.
  590.  
  591. SHOW <parameter>
  592. STATUS <parameter>
  593.  
  594.         These two commands are synonyms that show the settings of
  595.         SET command parameters, as well as information about SEND
  596.         or RECEIVE parameters.  The <parameter> is either SEND or
  597.         RECEIVE, and determines which set of information is
  598.         displayed.  The default, if no <parameter> is given, is
  599.         RECEIVE.
  600.  
  601. TAKE <filespec>
  602.  
  603.         Read Kermit control commands from a disk file. A "take"
  604.         file contains Kermit commands, one command per record, in
  605.         the same format as those entered from the keyboard.  A
  606.         "take" file should be type data to avoid the possibility
  607.         of a sequence number being interpreted as part of a
  608.         command.  Nested "takes" are not permitted. Each record
  609.         read is echoed to the screen prefixed by "TAKEN: ".  If
  610.         an error occurs, no special action occurs; the next
  611.         command is read and processed, just as if it had come
  612.         from the keyboard.  At startup, AS-Kermit looks for a
  613.         file called KERMITINI and if present, it is processed as
  614.         a TAKE file. KERMITINI is useful for changing default
  615.         Kermit attributes every time AS-Kermit runs.
  616.  
  617.  
  618. ASCII to EBCDIC and EBCDIC to ASCII
  619. Translations used by AS-Kermit
  620. Page 1 of 2
  621.  
  622.  |  A-> E       |  A-> E       |  A-> E       |  A-> E        |
  623.  |  E-----> A   |  E-----> A   |  E-----> A   |  E-----> A    |
  624.  |              |              |              |               |
  625.  |  00  00  00  |  40  7C  20  |  80  20  C3  |  C0  76  7B   |
  626.  |  01  01  01  |  41  C1  A0  |  81  21  61  |  C1  77  41   |
  627.  |  02  02  02  |  42  C2  A1  |  82  22  62  |  C2  78  42   |
  628.  |  03  03  03  |  43  C3  A2  |  83  23  63  |  C3  80  43   |
  629.  |  04  37  9C  |  44  C4  A3  |  84  24  64  |  C4  8A  44   |
  630.  |  05  2D  09  |  45  C5  A4  |  85  15  65  |  C5  8B  45   |
  631.  |  06  2E  86  |  46  C6  A5  |  86  06  66  |  C6  8C  46   |
  632.  |  07  2F  7F  |  47  C7  A6  |  87  17  67  |  C7  8D  47   |
  633.  |  08  16  97  |  48  C8  A7  |  88  28  68  |  C8  8E  48   |
  634.  |  09  05  8D  |  49  C9  A8  |  89  29  69  |  C9  8F  49   |
  635.  |  0A  25  8E  |  4A  D1  5B  |  8A  2A  C4  |  CA  90  E8   |
  636.  |  0B  0B  0B  |  4B  D2  2E  |  8B  2B  C5  |  CB  9A  E9   |
  637.  |  0C  0C  0C  |  4C  D3  3C  |  8C  2C  C6  |  CC  9B  EA   |
  638.  |  0D  0D  0D  |  4D  D4  28  |  8D  09  C7  |  CD  9C  EB   |
  639.  |  0E  0E  0E  |  4E  D5  2B  |  8E  0A  C8  |  CE  9D  EC   |
  640.  |  0F  0F  0F  |  4F  D6  21  |  8F  1B  C9  |  CF  9E  ED   |
  641.  |  10  10  10  |  50  D7  26  |  90  30  CA  |  D0  9F  7D   |
  642.  |  11  11  11  |  51  D8  A9  |  91  31  6A  |  D1  A0  4A   |
  643.  |  12  12  12  |  52  D9  AA  |  92  1A  6B  |  D2  AA  4B   |
  644.  |  13  13  13  |  53  E2  AB  |  93  33  6C  |  D3  AB  4C   |
  645.  |  14  3C  9D  |  54  E3  AC  |  94  34  6D  |  D4  AC  4D   |
  646.  |  15  3D  85  |  55  E4  AD  |  95  35  6E  |  D5  AD  4E   |
  647.  |  16  32  08  |  56  E5  AE  |  96  36  6F  |  D6  AE  4F   |
  648.  |  17  26  87  |  57  E6  AF  |  97  08  70  |  D7  AF  50   |
  649.  |  18  18  18  |  58  E7  B0  |  98  38  71  |  D8  B0  51   |
  650.  |  19  19  19  |  59  E8  B1  |  99  39  72  |  D9  B1  52   |
  651.  |  1A  3F  92  |  5A  E9  5D  |  9A  3A  CB  |  DA  B2  EE   |
  652.  |  1B  27  8F  |  5B  4A  24  |  9B  3B  CC  |  DB  B3  EF   |
  653.  |  1C  1C  1C  |  5C  E0  2A  |  9C  04  CD  |  DC  B4  F0   |
  654.  |  1D  1D  1D  |  5D  5A  29  |  9D  14  CE  |  DD  B5  F1   |
  655.  |  1E  1E  1E  |  5E  5F  3B  |  9E  3E  CF  |  DE  B6  F2   |
  656.  |  1F  1F  1F  |  5F  6D  5E  |  9F  E1  D0  |  DF  B7  F3   |
  657.  |  20  40  80  |  60  79  2D  |  A0  41  D1  |  E0  B8  5C   |
  658.  |  21  4F  81  |  61  81  2F  |  A1  42  7E  |  E1  B9  9F   |
  659.  |  22  7F  82  |  62  82  B2  |  A2  43  73  |  E2  BA  53   |
  660.  |  23  7B  83  |  63  83  B3  |  A3  44  74  |  E3  BB  54   |
  661.  |  24  5B  84  |  64  84  B4  |  A4  45  75  |  E4  BC  55   |
  662.  |  25  6C  0A  |  65  85  B5  |  A5  46  76  |  E5  BD  56   |
  663.  |  26  50  17  |  66  86  B6  |  A6  47  77  |  E6  BE  57   |
  664.  |  27  7D  1B  |  67  87  B7  |  A7  48  78  |  E7  BF  58   |
  665.  |  28  4D  88  |  68  88  B8  |  A8  49  79  |  E8  CA  59   |
  666.  |  29  5D  89  |  69  89  B9  |  A9  51  7A  |  E9  CB  5A   |
  667.  |  2A  5C  8A  |  6A  91  7C  |  AA  52  D2  |  EA  CC  F4   |
  668.  |  2B  4E  8B  |  6B  92  2C  |  AB  53  D3  |  EB  CD  F5   |
  669.  |  2C  6B  8C  |  6C  93  25  |  AC  54  D4  |  EC  CE  F6   |
  670.  |  2D  60  05  |  6D  94  5F  |  AD  55  D5  |  ED  CF  F7   |
  671.  |  2E  4B  06  |  6E  95  3E  |  AE  56  D6  |  EE  DA  F8   |
  672.  |  2F  61  07  |  6F  96  3F  |  AF  57  D7  |  EF  DB  F9   |
  673.  
  674.  
  675.  
  676.  
  677.  
  678. ASCII to EBCDIC and EBCDIC to ASCII
  679. Translations used by AS-Kermit
  680. Page 2 of 2
  681.  
  682.  
  683.  |  A-> E        |  A-> E        |  A-> E        |  A-> E        |
  684.  |  E-----> A    |  E-----> A    |  E-----> A    |  E-----> A    |
  685.  |               |               |               |               |
  686.  |  30  F0  90   |  70  97  BA   |  B0  58  D8   |  F0  DC  30   |
  687.  |  31  F1  91   |  71  98  BB   |  B1  59  D9   |  F1  DD  31   |
  688.  |  32  F2  16   |  72  99  BC   |  B2  62  DA   |  F2  DE  32   |
  689.  |  33  F3  93   |  73  A2  BD   |  B3  63  DB   |  F3  DF  33   |
  690.  |  34  F4  94   |  74  A3  BE   |  B4  64  DC   |  F4  EA  34   |
  691.  |  35  F5  95   |  75  A4  BF   |  B5  65  DD   |  F5  EB  35   |
  692.  |  36  F6  96   |  76  A5  C0   |  B6  66  DE   |  F6  EC  36   |
  693.  |  37  F7  04   |  77  A6  C1   |  B7  67  DF   |  F7  ED  37   |
  694.  |  38  F8  98   |  78  A7  C2   |  B8  68  E0   |  F8  EE  38   |
  695.  |  39  F9  99   |  79  A8  60   |  B9  69  E1   |  F9  EF  39   |
  696.  |  3A  7A  9A   |  7A  A9  3A   |  BA  70  E2   |  FA  FA  FA   |
  697.  |  3B  5E  9B   |  7B  C0  23   |  BB  71  E3   |  FB  FB  FB   |
  698.  |  3C  4C  14   |  7C  6A  40   |  BC  72  E4   |  FC  FC  FC   |
  699.  |  3D  7E  15   |  7D  D0  27   |  BD  73  E5   |  FD  FD  FD   |
  700.  |  3E  6E  9E   |  7E  A1  3D   |  BE  74  E6   |  FE  FE  FE   |
  701.  |  3F  6F  1A   |  7F  07  22   |  BF  75  E7   |  FF  FF  FF   |
  702.  
  703.  
  704.