home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / d / k6gman.doc < prev    next >
Text File  |  2020-01-01  |  56KB  |  1,722 lines
  1.                    Kermit68K user's and implementor's guide
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                                Roberto Bagnara
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                               Physics Department
  24.                               Bologna University
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.                                   July 1987
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.                                                                 Page 2
  46.  
  47.  
  48.                       **** WARNING ***   *** WARNING ***
  49.  
  50. This is a provisional help file extracted from the manual  that  is  still  in
  51. preparation,  when finished it will be distributed without further delays.  It
  52. is not checked at all and there are things, already implemented in the current
  53. release  of  Kermit68K,  not described here.  Furthermore some of the features
  54. here described are not fully implemented and checked.
  55.  
  56. Note also that I and the OS9/68000 version implementor (Steve Williams,  Texas
  57. University  at  Austin)  are  releasing now Kermit68K/OS9 because of the great
  58. need for beta-testers, we need user's feedback  to  go  further.   Furthermore
  59. this  is  the FIRST official release of the program, so probably a lot of bugs
  60. will be discovered, I and Steve apologize in advance  for  any  inconvenience.
  61. Don't  hesitate  to contact me (Bitnet:  Bagnara@Iboinfn) at any time for bugs
  62. reporting, suggestions, complaints and, why not,  compliments.   If  you  have
  63. problems in installing Kermit68K/OS9 on your system or if you are sure that an
  64. incovenience is due to the system dependent part you  can  write  directly  to
  65. Steve (Arpanet, Usenet:  {seismo|gatech|ihnp4}!ut-sally!stevew).
  66.  
  67. Finally remember that,  in  the  version  you  have  now,  the  macro  command
  68. capability  is  implemented  only  at  the embrional state that is there is no
  69. protection against a number of common situations  (really  it  should  not  be
  70. included  in this release but...), this facility will appear fully implemented
  71. in Kermit68K release 1.1 that will come soon.
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.                                                                 Page 3
  82.  
  83.  
  84. 1.  Introduction
  85.  
  86. Kermit is the name of a protocol for transferring files from one  computer  to
  87. another over ordinary asynchronous terminal connections.  Kermit programs have
  88. been written for many different computers, and in general  any  two  computers
  89. that have Kermit programs can exchange sequential files correctly.
  90.  
  91. The Kermit file transfer protocol was  designed  at  the  Columbia  University
  92. Center  for  Computing  Activities (CUCCA) in 1981-82 mainly by Bill Catchings
  93. and Frank da Cruz.  KERMIT is named after  the  famous  reporter,  Kermit  the
  94. Frog,  star  of  the  television series "The Muppet Show".  The name Kermit is
  95. used by permission of Henson Associates, Inc., New York.
  96.  
  97. This manual describes a Kermit  implementation  for  systems  based  upon  the
  98. Motorola   MC68000   microprocessors   family.   The  language  used  for  its
  99. implementation is assembly, and it may be processed, with a few modifications,
  100. by most assemblers following the syntax defined by Motorola [2,3].
  101.  
  102. This Kermit implementation has been written in order to be installed  also  on
  103. those  MC68000  microprocessors  family  based  machines,  which  have  no  or
  104. not-standard operating system (being often custom built for  the  solution  of
  105. specific  processing  problems).   At  least in the high energy physics field,
  106. that frequently happens.  The key principles  of  this  Kermit  implementation
  107. are:
  108.  
  109. 1) MACHINE INDEPENDENCE, (obviously stated that the processor  belongs
  110.    to the  Motorola MC68000 family). The system dependent part is kept
  111.    in  a  separate  module  and  it's  composed  by  a   few routines,
  112.    containing  all the knowledge about the system's file structure and
  113.    I/O ports.
  114.  
  115. 2) MINIMAL  SYSTEM  REQUIREMENTS,  Kermit68K  has  been  designed  for
  116.    portability  among   MC68000  operating   systems  and  assemblers,
  117.    particularly those of the sort that are sold as turnkey systems for
  118.    lab work,  with little or nothing in the way of utility software or
  119.    operating system support for many of  the functions often taked for
  120.    granted.
  121.  
  122. 3) MODULARITY,  Kermit68K is higly modularized, users that need to use
  123.    it for particular purposes can take advantage of this by using only
  124.    the parts suitable for their project.
  125.  
  126. 4) EASY CUSTOMIZATION,  the program  is  thoroughly  documented,  thus
  127.    allowing  the implementors to modify it easily,  according to their
  128.    need.
  129.  
  130. 5) EFFICIENCY,  the program is coded for  speed and it takes  a really
  131.    small memory space. Furthermore,  it's ROMable so it can be used on
  132.    embedded  system  for specific applications  (e.g.  automatic  data
  133.    transmission from a  remote acquisition station to a database  host
  134.    computer).
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.                                                                 Page 4
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.           PLEASE USE KERMIT68K ONLY FOR PEACEFUL AND HUMANE PURPOSES
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.                                                                 Page 5
  169.  
  170.  
  171. 2.  Kermit68K at a glance
  172.  
  173. Program:        Roberto Bagnara, Physics Department, Bologna University
  174. Language:       Motorola MC68000 Assembly Language
  175. Documentation:  Roberto Bagnara
  176. Version:        1.0.00
  177. Date:           July 01, 1987
  178.  
  179. Capabilities:   Local operation:                    Yes
  180.                 Remote operation:                   Yes
  181.                 Transfers text files:               Yes
  182.                 Transfers binary files:             Yes
  183.                 Wildcard send:                      Yes
  184.                 ^X/^Z interruption:                 Yes
  185.                 Filename collision avoidance:       Yes
  186.                 Can time out:                       Yes
  187.                 8th-bit prefixing:                  Yes
  188.                 Repeat count prefixing:             Yes
  189.                 Alternate block checks:             Yes
  190.                 Terminal emulation:                 No
  191.                 Communication settings:             Yes
  192.                 Transmit BREAK:                     Yes
  193.                 IBM mainframe communication:        Yes
  194.                 Transaction logging:                No
  195.                 Session logging:                    No
  196.                 Raw transmit:                       No
  197.                 Act as server:                      No
  198.                 Talk to server:                     Yes
  199.                 Advanced server functions:          No
  200.                 Advanced commands for servers:      Yes
  201.                 Local file management:              Yes
  202.                 Command/init files:                 Yes
  203.                 Command macros:                     Yes
  204.                 Attribute packets:                  No
  205.                 Extended-length packets:            No
  206.                 Sliding windows:                    No
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.                                                                 Page 6
  217.  
  218.  
  219. cc Kermit68K Interactive Operations
  220.  
  221.  
  222. cc.1 Entering commands
  223.  
  224. Kermit68K's default interactive command prompt is "Kermit68K>".   In  response
  225. to  this  prompt,  you  may  type  any  valid command.  Kermit68K executes the
  226. command and then prompts you for another command.  The process continues until
  227. you instruct the program to terminate.
  228.  
  229. Kermit68K commands begin with  a  keyword,  normally  an  English  verb,  that
  230. describe  what  you want the program to do.  This command verb may be followed
  231. by one or more parameters that specify what the verb acts upon.  At least  one
  232. blank  character  must separate the command name from the first parameter, and
  233. at least one blank must separate each additional parameter from  the  previous
  234. parameter.  Multiple spaces and tabs are permitted in all cases where a single
  235. blank is required.
  236.  
  237. When you enter  commands,  you  can  use  any  combination  of  uppercase  and
  238. lowercase  because  the  command  interpreter  translates lowercase letters to
  239. uppercase letters when it tries to match command  verbs  and  other  parameter
  240. keywords.   File  specifications  and  other  non-keyword  parameters are left
  241. unchanged, so, if your operating system cares of letter cases, make  sure  you
  242. type these parameters in the correct way.
  243.  
  244. A Kermit68K command can contain up to 132 characters, besides, each element in
  245. a  command  (for  example,  a file specification or keyword parameter) must be
  246. less or equal to 132 characters.
  247.  
  248. You can abbreviate command verbs  and  parameter  keywords  omitting  trailing
  249. characters  as  long  as the truncation is unique, thus permitting the command
  250. interpreter to distinguish it from any other keyword valid in that field.  For
  251. example,  the  HELP command is currently the only command that begins with the
  252. character "H".  Therefore, the HELP command could be  truncated  to  just  one
  253. character.   The  RECEIVE and RETRY keywords, however, have the same first two
  254. characters, so  these  commands  cannot  be  truncated  to  fewer  than  three
  255. characters.
  256.  
  257. Certain commonly-used commands are exceptions to the minimum  truncation  rule
  258. because they can be truncated to just their first character, even though other
  259. commands begin with the same character.  The commands that  benefit  of  these
  260. non-unique abbreviations are SEND, RECEIVE, and CONNECT.
  261.  
  262. Unless you specify an  alternate  radix,  the  Kermit68K  command  interpreter
  263. treats  all  numeric  values  as decimal integers.  You can specify a radix by
  264. using the radix operators ("$" for hexadecimal,  ""  for  octal,  or  "%"  for
  265. binary).  There cannot be any blanks between a radix operator and a value.
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.                                                                 Page 7
  276.  
  277.  
  278. Certain  characters  have  special  functions  during  typein  of  interactive
  279. commands:
  280.  
  281. DEL (Delete)
  282.         Delete the most  recently entered character.  You may also use
  283.         BS (Backspace, Control-H) for this function. Note that the key
  284.         that performs the  delete function  is marked  RUBOUT on  some
  285.         terminals.
  286.  
  287. CAN (Control-X)
  288.         Erase the entire command.  Useful if you make several mistakes
  289.         on  a particular line and want to  cancel the line and reenter
  290.         it.
  291.  
  292. CR (Carriage-Return)
  293.         Enters  the  command  for  execution.   LF  (Linefeed)  or  FF
  294.         (Formfeed) may also be used for this purpose.
  295.  
  296. A command line beginning with a percent sign "%" is ignored.  Such  lines  may
  297. be  used  to  include illustrative commentary in Kermit command dialogs.  Note
  298. that the command interpreter treats the "%" as any other command, so make sure
  299. that at least one space or tab follows it.
  300.  
  301. Interactive Kermit68K  accepts  commands  from  files  as  well  as  from  the
  302. keyboard.   When  you  enter  interactive  mode,  Kermit68K looks for the file
  303. KERMIT.INI in your current directory and executes any commands it finds there.
  304. A  TAKE  command  is  also  provided for use at any time during an interactive
  305. session, to allow commands to be executed from a file; command  files  may  be
  306. nested to a maximum of 20.
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.                                                                 Page 8
  317.  
  318.  
  319. cc.2 Kermit68K commands in brief
  320.  
  321. Here is a brief list of Kermit68K interactive commands:
  322.  
  323. %                 Treat the rest of the line as a comment.
  324. !                 Forward the rest of the line to system command processor.
  325. BYE               Terminate and log out a remote Kermit server.
  326. CONNECT           Establish a terminal connection to a remote system.
  327. COPY              Make a copy of a local files.
  328. CWD               Change Working Directory.
  329. DEFINE            Define a macro command.
  330. DELETE            Delete a local files.
  331. DIRECTORY         Display a directory listing.
  332. ECHO              Display arguments literally.
  333. EXIT              Exit from the program, closing any open files.
  334. FINISH            Instruct a remote Kermit server to exit, but not log out.
  335. GET               Get files from a remote Kermit server.
  336. HELP              Display a brief command and macro list.
  337. LIST              List a macro command text.
  338. PRINT             Print local files.
  339. QUIT              Same as EXIT.
  340. RECEIVE           Passively wait for files to arrive.
  341. REMOTE            Issue commands to a remote Kermit server.
  342. RENAME            Rename local files.
  343. SEND              Send files.
  344. SET               Set various parameters.
  345. SHOW              Display values of tha SETtable parameters.
  346. SPACE             Display current disk space usage.
  347. STATISTICS        Display statistics about most recent transaction.
  348. TAKE              Execute commands from a file.
  349. TYPE              Display local files on the screen.
  350.  
  351. The SETtable parameters are:
  352.  
  353. BAUD              Same as SPEED.
  354. BLOCK_CHECK_TYPE  Level of packet error detection.
  355. DELAY             How long to wait before sending first packet.
  356. DUPLEX            Specify which side echoes during CONNECT.
  357. ESCAPE            Prefix for "escape commands" during CONNECT.
  358. FILE              Set various file parameters.
  359. FLOW_CONTROL      Communication line full-duplex flow control.
  360. HANDSHAKE         Communication line half-duplex turnaround character.
  361. INCOMPLETE_FILE_DISPOSITION Disposition for incompletely received files.
  362. LINE              Communication line device name.
  363. PARITY            Communication line character parity.
  364. PROMPT            The Kermit68K program's interactive command prompt.
  365. RECEIVE           Parameters for inbound packets.
  366. RETRY             Set limits for retrying packets transmission.
  367. SEND              Parameters for outbound packets.
  368. SPEED             Communication line speed.
  369.  
  370. The REMOTE commands are:
  371.  
  372. COPY              Copy remote files.
  373. CWD               Change remote working directory.
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.                                                                 Page 9
  384.  
  385.  
  386. DELETE            Delete remote files.
  387. DIRECTORY         Display a listing of remote file names.
  388. HELP              Request help from a remote server.
  389. HOST              Issue a command to remote host in its own command language.
  390. KERMIT            Issue a command to remote Kermit in its own syntax.
  391. PRINT             Print remote files.
  392. RENAME            Rename remote files.
  393. SET               Set parameters of the remote Kermit program.
  394. SPACE             Display current disk space usage on remote system.
  395. SUBMIT            Send a command to remote host for batch execution.
  396. TYPE              Display a remote file on your screen.
  397. WHO               Display who's logged in, or get information about a user.
  398.  
  399.  
  400. cc.pp The BYE command
  401.  
  402. This command will cause Kermit68K (when in  local  mode)  to  tell  the  other
  403. Kermit  (which  should  be  in  server  mode)  to  exit  from  Kermit  and, if
  404. applicable, terminate its job (or process, etc.).  When Kermit68K receives the
  405. acknowledgement that this is being done, it will exit to the operating system.
  406.  
  407. Kermit68K>BYE
  408.  
  409.  
  410. cc.pp The CONNECT command
  411.  
  412. The CONNECT command will allow you to connect in as a  virtual  terminal  over
  413. the default line or the one specified by the last SET LINE command.
  414.  
  415. Kermit68K>CONNECT
  416.  
  417.  
  418. cc.pp.1 The CONNECT command Escape-Character
  419.  
  420. This character is used to issue a limited set of commands to  Kermit68K  after
  421. using the CONNECT command.  Its default value is CTRL-E (5 decimal, ASCII ENQ)
  422. and can be changed via the SET ESCAPE command.  It is usually a  good  pratice
  423. to  set  this  character  to something which is not used (or at least not used
  424. very much) on the system to which Kermit68K is CONNECTing.  The  command  that
  425. is  issued  is  determined  by  the  character  that is typed after the escape
  426. character.  The following characters are recognized  by  Kermit68K  after  the
  427. escape character:
  428.  
  429.            B - Send a BREAK
  430.            C - Close the connection and return to Kermit68K
  431.            H - Hangup and close the connection
  432.            S - Show the connection status
  433.            0 - Send a NULL
  434.            ? - Type help text
  435.            Escape-Character - Send the Escape-Character
  436.  
  437.  
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.                                                                Page 10
  446.  
  447.  
  448. Any other character will cause  Kermit68K  to  ring  the  bell  at  the  local
  449. terminal.   The Escape-Character S (show status) command displays the terminal
  450. line being used and the settings of local echo and parity.
  451.  
  452.  
  453. cc.pp The COPY command
  454.  
  455. This causes Kermit68K to make a copy of the specified local file.  The  format
  456. of the command is:
  457.  
  458. Kermit68K>COPY <source-file-spec> <target-file-spec>
  459.  
  460. Where <source-file-spec> is the name  of  the  file  you  wish  to  copy,  and
  461. <target-file-spec> is the name for the copy.
  462.  
  463.  
  464. cc.pp The CWD command
  465.  
  466. This command (short for "Change Working Directory") causes Kermit68K to change
  467. the default directory that will be used for files whose specification does not
  468. include the directory information.  What happen if no device or  directory  is
  469. specified is implementation dependent.
  470.  
  471. Kermit68K>CWD [<local-directory-spec>]
  472.  
  473. Where <local-directory-spec> is the device and/or directory to set as default.
  474.  
  475.  
  476. cc.pp The DEFINE command
  477.  
  478. This command allow the user to define a macro  command.   The  format  of  the
  479. command is:
  480.  
  481. Kermit68K>DEFINE <macro-name> [<macro-body>]
  482.  
  483. Where <macro-name> is the name of the macro you are defining and  <macro-body>
  484. should  be specified when you want to define a one-command macro.  In the case
  485. you want to define a multi-command macro, that is a  macro  that  has  a  body
  486. composed  of  several  lines,  you shouldn't specify the optional <macro-body>
  487. string, Kermit68K will prompt you (really there is no prompt string) for macro
  488. body  lines  until  you  enter a blank line.  For further information on macro
  489. commands see the section below.
  490.  
  491.  
  492. cc.pp The DELETE command
  493.  
  494. This causes Kermit68K to delete the specified local file(s).   The  format  of
  495. the command is:
  496.  
  497. Kermit68K>DELETE <local-file-spec>
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.                                                                Page 11
  508.  
  509.  
  510. Where <local-file-spec> specifies the file(s) you wish to delete.
  511.  
  512.  
  513. cc.pp The DIRECTORY command
  514.  
  515. This causes Kermit68K to display a listing of the current default directory or
  516. of the one specified in the command.
  517.  
  518. Kermit68K>DIRECTORY [<local-device/directory/file-spec>]
  519.  
  520. Where   <local-device/directory/file-spec>   allow,   depending   on    system
  521. characteristics, the generation of a more selective listing.
  522.  
  523.  
  524. cc.pp The EXIT command
  525.  
  526. The EXIT command will cause  Kermit68K  to  return  to  command  level.   This
  527. command is the same as the QUIT command.
  528.  
  529. Kermit68K>EXIT
  530.  
  531.  
  532. cc.pp The FINISH command
  533.  
  534. This command will cause Kermit68K (when in  local  mode)  to  tell  the  other
  535. Kermit  (which should be in server mode) to exit from Kermit.  After receiving
  536. the acknowledgement that this is being done, Kermit68K will prompt for another
  537. command.
  538.  
  539. Kermit68K>FINISH
  540.  
  541.  
  542. cc.pp The GET command
  543.  
  544. The GET command is used to have a local mode Kermit68K request a file  from  a
  545. remote Kermit server.  Kermit68K must be running as a local Kermit.  Kermit68K
  546. will then request the other Kermit (which must be running in server  mode)  to
  547. transfer  the  specified  file  (or  set  of  files)  to  Kermit68K.  The file
  548. specification must be in the format of the system on which the  server  Kermit
  549. is running.  The format of the command is:
  550.  
  551. Kermit68K>GET <file-spec>
  552.  
  553. Where <file-spec> is any valid file specification on the system on  which  the
  554. server Kermit is running.
  555.  
  556.  
  557. cc.pp The HELP command
  558.  
  559. Prints a brief summary of the Kermit68K commands and user defined macros.
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.                                                                Page 12
  570.  
  571.  
  572. Kermit68K>HELP
  573.  
  574.  
  575. cc.pp The LIST command
  576.  
  577. This command will cause Kermit68K to show  the  body  of  the  specified  user
  578. defined macro.
  579.  
  580. Kermit68K>LIST <macro-name>
  581.  
  582. Where <macro-name> is the name of the macro of wich you want the listing.
  583.  
  584.  
  585. cc.pp The QUIT command
  586.  
  587. This command will cause Kermit68K to return to the  operating  system  command
  588. level.  This is the same as the EXIT command.
  589.  
  590. Kermit68K>QUIT
  591.  
  592.  
  593. cc.pp The RECEIVE command
  594.  
  595. The RECEIVE command is used to put Kermit68K into remote mode  waiting  for  a
  596. single  file  transfer  transaction.   This is most useful if the other Kermit
  597. does not support local server commands.  If no file  specification  is  given,
  598. Kermit68K will use whatever file specification is supplied by the other Kermit
  599. (suitably altered to conform to the underlying  operating  system  standards).
  600. If  a  file specification is given, Kermit68K will use that file specification
  601. instead of that supplied by the other Kermit.  This is most  useful  when  the
  602. file  name  on the other system is such that it does not map well into a local
  603. system file specification.  Note that if the other Kermit sends more than  one
  604. file,  only  the  first  one  is  renamed.   Therefore,  it  is  best to use a
  605. file-specification on this command only when transferring a single file.   The
  606. format of the command is:
  607.  
  608. Kermit68K>RECEIVE <local-file-spec>
  609.  
  610. Where <local-file-spec> is any valid file specification on your system.
  611.  
  612.  
  613. cc.pp The REMOTE command
  614.  
  615. This command allows the user of Kermit68K (in  local  mode)  to  give  various
  616. commands  to  the other Kermit (which must be in server mode).  These commands
  617. provide for listing the contents of a directory, deleting files, typing files,
  618. displaying  the  amount  of  disk  space  used, etc.  Note that not all server
  619. Kermits support all commands, but all server Kermits  should  respond  with  a
  620. message saying the command is not implemented if it does not support it.
  621.  
  622. Kermit68K>REMOTE <keyword> [<argument>...]
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.                                                                Page 13
  633.  
  634.  
  635. Where <keyword> is the name of the command, and  <argument>  is  one  optional
  636. argument for the command.
  637.  
  638.  
  639. cc.pp.1 The Remote COPY command
  640.  
  641. This causes Kermit68K to request that the server Kermit make  a  copy  of  the
  642. specified file.  Both the old and new files are files on the server's system -
  643. no file transfer between systems is done.  The server  Kermit  should  respond
  644. with  some indication that either the file was successfully copied, or with an
  645. error message.  Note that some Kermit's will allow wild-carded  copies,  while
  646. others will only allow a single file to be copied per command.
  647.  
  648. Kermit68K>REMOTE COPY <old-remote-file> <new-remote-file>
  649.  
  650. Where <old-remote-file> is the  name  of  the  file  you  wish  to  copy,  and
  651. <new-remote-file> is the name for the copy.
  652.  
  653.  
  654. cc.pp.2 The Remote CWD command
  655.  
  656. This command (short  for  "Change  Working  Directory")  causes  Kermit68K  to
  657. request  that  the  server  Kermit change the default directory (path, device,
  658. etc.) that will be used for files whose specification  does  not  include  the
  659. directory information.  For some systems a password can be supplied which will
  660. allow access to the new directory.   If  no  directory  is  specified  in  the
  661. command,  the  server  Kermit will set the default directory back to the users
  662. default.  This may be either the directory which is the  default  when  a  job
  663. created,  or  the default directory which was in effect when the server Kermit
  664. was started.  The server Kermit should respond with a message which  indicates
  665. where the new default directory has been set, or with an error message.
  666.  
  667. Kermit68K>REMOTE CWD [<remote-directory-spec>] [<password>]
  668.  
  669. Where <remote-directory-spec> is a string which is acceptable as  a  directory
  670. specification for the server system and <password> is a string that could give
  671. you access to the specified mass-storage area.
  672.  
  673.  
  674. cc.pp.3 The Remote DELETE command
  675.  
  676. This causes Kermit68K to request the server Kermit  to  delete  the  specified
  677. file  (or  files if the server Kermit supports wild-card deletes).  The server
  678. Kermit should respond with a message indicating whether the  file  (or  files)
  679. has been deleted.
  680.  
  681. Kermit68K>REMOTE DELETE <remote-file-spec>
  682.  
  683. Where <file-spec> is a  valid  file  specification  for  the  remote  Kermit's
  684. system.
  685.  
  686.  
  687.  
  688.  
  689.  
  690.  
  691.  
  692.  
  693.  
  694.                                                                Page 14
  695.  
  696.  
  697. cc.pp.4 The Remote DIRECTORY command
  698.  
  699. This causes Kermit68K to request a directory listing from the  server  Kermit.
  700. The  directory  listing will be printed on the user's terminal.  The format of
  701. the listing is determined by the server Kermit.
  702.  
  703. Kermit68K>REMOTE DIRECTORY [<remote-file-spec>]
  704.  
  705. Where <remote-file-spec> is a valid file specification for the server Kermit's
  706. system.
  707.  
  708.  
  709. cc.pp.5 The Remote SPACE command
  710.  
  711. This causes Kermit68K to request the server Kermit to reply with an indication
  712. of  the amount of disk space used and available for the given directory/device
  713. (or the default directory/device if none is given).
  714.  
  715. Kermit68K>REMOTE SPACE [<remote-device/directory-spec>]
  716.  
  717. Where  <remote-directory/device-spec>  is  a  specification  for  the   server
  718. Kermit's  system  to  allow,  when  possible,  the generation of more selected
  719. information.
  720.  
  721.  
  722. cc.pp.6 The Remote HELP command
  723.  
  724. This causes Kermit68K to request the server  Kermit  to  reply  with  a  short
  725. summary of what commands it supports in server mode.  If an argument is given,
  726. help on the specific topic is requested.  The resulting help message  will  be
  727. typed on the users terminal.
  728.  
  729. Kermit68K>REMOTE HELP [<topic>]
  730.  
  731. Where <topic> is a subject for more detailed help.  If no topic  is  given,  a
  732. general help message is requested.
  733.  
  734.  
  735. cc.pp.7 The Remote HOST command
  736.  
  737. This command requests the server Kermit to perform the specified command as if
  738. it  were  typed by the user on a terminal.  Any results of the command will be
  739. printed on the user's terminal.  Note  that  this  should  only  be  used  for
  740. commands  which  will  not require any more user input, since there will be no
  741. way for the user to interact with the remote system to supply more input.
  742.  
  743. Kermit68K>REMOTE HOST <command>
  744.  
  745. Where <command> is any valid command to be processed by  the  remote  system's
  746. standard command parser.
  747.  
  748.  
  749. cc.pp.8 The Remote RENAME command
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.                                                                Page 15
  760.  
  761.  
  762. This command causes Kermit68K to request that the  server  Kermit  change  the
  763. name  of a file.  The server Kermit should respond with an indication that the
  764. operation is completed successfully, or else  with  an  error  message.   Some
  765. Kermit  programs  may allow wild-card file specifications to be used, and will
  766. respond with a list of files and new names.
  767.  
  768. Kermit68K>REMOTE RENAME <old-remote-file> <new-remote-file>
  769.  
  770. Where  <old-remote-file>  is  the  name  of  the  file  to  be  renamed,   and
  771. <new-remote-file> is the new name for the file.
  772.  
  773.  
  774. cc.pp.9 The Remote TYPE command
  775.  
  776. This causes Kermit68K to request the server Kermit to transmit  the  specified
  777. file  (or  files if the server supports wild-cards) so that the file(s) can be
  778. typed on the users terminal.
  779.  
  780. Kermit68K>REMOTE TYPE <remote-file-spec>
  781.  
  782. Where <remote-file-spec> is a valid file specification for the server Kermit's
  783. system.
  784.  
  785.  
  786. cc.pp.10 The Remote WHO command
  787.  
  788. This requests the server Kermit to display a list  of  users  of  its  system,
  789. along  with  other  information  about  the  users  and/or system.  A specific
  790. user-id may be supplied, which may result in more detailed  information  about
  791. the particular user.
  792.  
  793. Kermit68K>REMOTE WHO <user-id>
  794.  
  795. Where <user-id> is an optional string representing a specific user.
  796.  
  797.  
  798. cc.pp The RENAME command
  799.  
  800. This command causes Kermit68K to change the name of a local file.
  801.  
  802. Kermit68K>LOCAL RENAME <old-local-file> <new-local-file>
  803.  
  804. Where  <old-local-file>  is  the  name  of  the  file  to  be   renamed,   and
  805. <new-local-file> is the new name for the file.
  806.  
  807.  
  808. cc.pp The SEND command
  809.  
  810. The SEND command will allow you to send a file(s) to the  other  Kermit.   The
  811. SEND  command will allow file wild-card processing depending on the underlying
  812. operating system.  If Kermit68K is running in remote mode, the  file  will  be
  813. sent  on  the  controlling  terminal  line after waiting the number of seconds
  814. specified by the SET DELAY command.  This gives the user time to  escape  back
  815. to  the  other Kermit and issue a receive command.  If Kermit68K is running in
  816. local mode, the file will be sent immediately on the terminal  line  specified
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.                                                                Page 16
  827.  
  828.  
  829. by the SET LINE command.
  830.  
  831. Kermit68K>SEND <local-file-spec>
  832.  
  833. Where <local-file-spec> is any valid file specification.
  834.  
  835.  
  836. cc.pp The SET command
  837.  
  838. The SET command is used to set various parameters in Kermit68K.
  839.  
  840.  
  841. cc.pp.1 The Set BLOCK_CHECK_TYPE command
  842.  
  843. The SET BLOCK_CHECK_TYPE command is used to determine the type of  block check
  844. sequence  which will be used during transmission.  The block check sequence is
  845. used to detect transmission errors.  There are three  types  of  block  checks
  846. available.   These  are  the  single  character  checksum  (default),  the two
  847. character checksum, and the three character  CRC  (cyclic  redundancy  check).
  848. This  command  does  not  ensure  that the desired type of block check will be
  849. used, since both Kermit's involved in the transfer must  agree  on  the  block
  850. check  type.   Kermit68K will request that the type of block check set by this
  851. command be used for a transfer.  If the other Kermit has  also  had  the  same
  852. block  check  type  requested, then the desired block check type will be used.
  853. Otherwise, the single character  checksum  will  be  used.   (See  the  Kermit
  854. protocol manual for more information.)
  855.  
  856. Kermit68K>SET BLOCK_CHECK_TYPE <type>
  857.  
  858. Where <type> is one of 1, ONE, 2, TWO, 3, THREE.
  859.  
  860.  
  861. cc.pp.2 The Set DELAY command
  862.  
  863. The DELAY parameter is the number of seconds to wait before sending data after
  864. a  SEND  command  is  given.  This is used when Kermit68K is running in remote
  865. mode to allow the user time to escape back to the  other  Kermit  and  give  a
  866. RECEIVE command.
  867.  
  868. Kermit68K>SET DELAY <n>
  869.  
  870. Where <n> is the number of seconds to wait before sending data.
  871.  
  872.  
  873. cc.pp.3 The Set ESCAPE command
  874.  
  875. This command will set the escape character for the  CONNECT  processing.   The
  876. command  will  take  the  decimal  value of the character to use as the escape
  877. character.  This is the character which is used to "escape" back to  Kermit68K
  878. after  using  the  CONNECT  command.   It  defaults  to  5 decimal (ASCII ENQ,
  879. CTRL-E).
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.                                                                Page 17
  890.  
  891.  
  892. It is usually a good idea to set this character to something which is not used
  893. (or  at  least  not  used  very  much)  on  the  system  to which Kermit68K is
  894. CONNECTing.
  895.  
  896. Kermit68K>SET ESCAPE <char-ascii-value>
  897.  
  898. Where <char-ascii-value> is the ASCII value of the character  to  use  as  the
  899. escape character.
  900.  
  901.  
  902. cc.pp.4 The Set FILE command
  903.  
  904. The SET FILE command allows setting of parameters relating to the file  format
  905. and file naming conventions used by Kermit68K.
  906.  
  907. Kermit68K>SET FILE <parameter>
  908.  
  909. Where <parameter> is one of DISPLAY, NAMES, TYPE, WARNING.
  910.  
  911.  
  912. cc.pp.4.1 The Set File DISPLAY command
  913.  
  914. This command allows the user to enable/disable two features of Kermit68K  when
  915. it  runs  in local mode:  the file transfers progress display and the keyboard
  916. sampling to detect user interruptions.  By default the file display  parameter
  917. is ON.  If OFF (this might be achieved also specifying -q on the command line)
  918. none of this is done, and,  if  the  system  support  multitasking,  the  file
  919. transfer   may   proceed  in  the  background  oblivious  to  any  other  work
  920. concurrently done at the console terminal.
  921.  
  922. Kermit68K>SET FILE DISPLAY <state>
  923.  
  924. Where <state> is either ON or OFF.
  925.  
  926.  
  927. cc.pp.4.1 The Set File NAMES command
  928.  
  929. This command sets the type of processing Kermit68K should  do  on  file  names
  930. that are being sent and received.  Kermit68K can either send the complete file
  931. specification (including device, directories, file name, file type and version
  932. number)  or only the file name and type.  When receiving a file specification,
  933. Kermit68K can either attempt to use it as a normal file specification  as  is,
  934. or  first  perform  some  substitutions  and truncations in order to force the
  935. received specification to be just a valid file name and type.
  936.  
  937. Normally  CONVERTED,  which  means   that   outbound   filenames   have   path
  938. specifications  stripped,  strange characters and extra periods changed to X's
  939. and so on.  LITERAL means that none of these conversions are done;  therefore,
  940. any  directory  path appearing in a received file specification must exist and
  941. be write-accessible.  When LITERAL naming is being used, the sender should not
  942. use  path  names  in the file specification unless the same path exists on the
  943. target system and is writable.
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.                                                                Page 18
  954.  
  955.  
  956. Kermit68K>SET FILE NAMES <type>
  957.  
  958. Where <type> is either CONVERTED or LITERAL.
  959.  
  960.  
  961. cc.pp.4.2 The Set File TYPE command
  962.  
  963. This command will set the file type that Kermit68K is receiving.  A file  type
  964. of  TEXT  should  be  used  to receive text files which are to be used as text
  965. files on the local system.  The file type BINARY should  be  used  for  binary
  966. files,  such as CP/M .COM files, which need to be kept in a format that allows
  967. the file to be returned without any changes.  Furthermore, if the system  uses
  968. a  single character instead of a CRLF sequence for text file line delimitation
  969. (this is the case of OS9), that character  will  be  converted  to  CRLF  upon
  970. output,  and  CRLF  will  be  converted  to that character on input.  When the
  971. BINARY file type is selected (this might be done also specifying the -i option
  972. in  the  command line) Kermit68K makes no conversion between newlines and CRLF
  973. line delimiters.
  974.  
  975. Kermit68K>SET FILE TYPE <type>
  976.  
  977. Where <type> is either TEXT or BINARY.
  978.  
  979.  
  980. cc.pp.ss The Set File WARNING command
  981.  
  982. Normally OFF, which means that incoming files will silently overwrite existing
  983. files  of  the  same name.  When ON (this might be done also specifying the -w
  984. option on the command line) Kermit68K will check if  an  arriving  file  would
  985. overwrite  an  existing  file;  if  so,  it  will construct a new name for the
  986. arriving file, in a form that is dependent from the the implementation.
  987.  
  988. Kermit68K>SET File WARNING <state>
  989.  
  990. Where <state> is either ON or OFF.
  991.  
  992.  
  993. cc.pp.ss The Set FLOW_CONTROL command
  994.  
  995. Normally XON/XOFF for full duplex flow control.  Should be set to NONE if  the
  996. other  system  cannot  do  xon/xoff  flow control, or if you have issued a SET
  997. HANDSHAKE command.  If set to XON/XOFF, then handshake should be set to  NONE.
  998. This setting applies during both terminal connection and file transfer.
  999.  
  1000. Kermit68K>SET FLOW_CONTROL <keyword>
  1001.  
  1002. Where <state> is either NONE or XON/XOFF.
  1003.  
  1004.  
  1005. cc.pp.5 The Set HANDSHAKE command
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.                                                                Page 19
  1016.  
  1017.  
  1018. Sets the half duplex line turnaround handshake character Kermit68K  will  use.
  1019. Normally  required  for  communication  with  half  duplex  systems  like  IBM
  1020. mainframes.
  1021.  
  1022. Kermit68K>SET HANDSHAKE <keyword>
  1023.  
  1024. Where <keyword> is one of NONE,  BELL,  LF,  CR,  XON,  XOFF,  ESC.   The  SET
  1025. HANDSHAKE NONE command turns handshaking off.
  1026.  
  1027.  
  1028. cc.pp.6 The Set INCOMPLETE_FILE_DISPOSITION command
  1029.  
  1030. This command allows the user to determine what is done with a file that is not
  1031. completely  received.   If the disposition is KEEP, all files received will be
  1032. kept, even if only a portion of the file is received.  If the  disposition  is
  1033. DISCARD (the default), files which are not completely received are discarded.
  1034.  
  1035. Kermit68K>SET INCOMPLETE_FILE_DISPOSITION <action>
  1036.  
  1037. Where <action> is either DISCARD or KEEP.
  1038.  
  1039.  
  1040. cc.pp.7 The Set LINE command
  1041.  
  1042. This will set the terminal line that you are using.  The terminal line must be
  1043. one which is accessible to the users process.
  1044.  
  1045. Kermit68K>SET LINE <terminal-name>
  1046.  
  1047. The <terminal-name> device must be a terminal line.
  1048.  
  1049.  
  1050. cc.pp.7 The Set DUPLEX command
  1051.  
  1052. The SET DUPLEX command specifies whether characters should be  echoed  locally
  1053. when  CONNECTing  to  another system.  If DUPLEX is set to HALF, any character
  1054. typed on the terminal will be echoed immediately to the terminal, as  well  as
  1055. being  sent  to the other system.  If DUPLEX is set to FULL (the default), the
  1056. characters typed on the terminal are only sent  to  the  other  system  (which
  1057. would normally be echoing the characters).
  1058.  
  1059. Kermit68K>SET DUPLEX <state>
  1060.  
  1061. Where <state> is either FULL or HALF.
  1062.  
  1063.  
  1064. cc.pp.7 The Set PARITY command
  1065.  
  1066. This command determines the type of parity to use on  the  transmission  line.
  1067. Kermit68K  normally  uses  characters which consist of eight data bits with no
  1068. parity bit.  For systems or transmission media which require a specific parity
  1069. type, Kermit68K can send characters as seven data bits plus a parity bit.
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.                                                                Page 20
  1080.  
  1081.  
  1082. Kermit68K>SET PARITY <state>
  1083.  
  1084. Where <state> is one of:
  1085.  
  1086.     NONE     (default) eight data bits and no parity bit.
  1087.  
  1088.     MARK     seven data bits with the parity bit set to one.
  1089.  
  1090.     SPACE    seven data bits with the parity bit set to zero.
  1091.  
  1092.     EVEN     seven data bits with the parity bit set to make
  1093.              the overall parity even.
  1094.  
  1095.     ODD      seven data bits with the parity bit set to make
  1096.              the overall parity odd.
  1097.  
  1098.  
  1099. cc.pp.8 The Set PROMPT command
  1100.  
  1101. This command sets the string to  be  used  for  the  command  prompt.   If  no
  1102. argument is given, the default prompt "Kermit68K>" is used.
  1103.  
  1104. Kermit68K>SET PROMPT [<new-prompt-text>]
  1105.  
  1106. Where <new-prompt-text> is the new prompt to use.
  1107.  
  1108.  
  1109. cc.pp.9 The set RECEIVE command
  1110.  
  1111. It is possible to set various parameters associated with the receiving of  the
  1112. data  from  the remote Kermit.  SET RECEIVE will enable you to set the various
  1113. receive parameters.
  1114.  
  1115.  
  1116. cc.pp.9.1 The Set Receive END_OF_LINE command
  1117.  
  1118. This will set the end-of-line character the Kermit68K expects to receive  from
  1119. the  remote  Kermit.   This  is  the character which terminates a packet.  The
  1120. parameter must be a number in the range 1 to 31 decimal.  The default value is
  1121. 13 decimal (ASCII CR, CTRL-M).
  1122.  
  1123. Kermit68K>SET RECEIVE END_OF_LINE <char-ascii-value>
  1124.  
  1125. Where <char-ascii-value> is the ASCII value of the character to  use  for  the
  1126. end-of-line character.
  1127.  
  1128.  
  1129. cc.pp.9.2 The Set Receive MARKER command
  1130.  
  1131. This command will set the start of packet character for Kermit68K.  The  start
  1132. of  packet  character  must  be  in the range of 1 to 31 decimal.  The default
  1133. value is 1 (ASCII  SOH,  CTRL-A).   This  value  should  only  be  changed  if
  1134. absolutely necessary.  It must be set the same in both Kermit's.
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.                                                                Page 21
  1145.  
  1146.  
  1147. Kermit68K>SET RECEIVE MARKER <char-ascii-value>
  1148.  
  1149. Where <char-ascii-value> is the ASCII value  of  the  receive  start-of-packet
  1150. character to use.
  1151.  
  1152.  
  1153. cc.pp.9.3 The Set Receive PACKET_LENGTH command
  1154.  
  1155. This will set the receive packet length.  The value for this parameter must be
  1156. between  10  and  94.   Packet lengths outside of this range are illegal.  The
  1157. default value is 80.
  1158.  
  1159. Kermit68K>SET RECEIVE PACKET_LENGTH <number>
  1160.  
  1161. Where <number> is the receive packet length to use.
  1162.  
  1163.  
  1164. cc.pp.9.4 The Set Receive PADDING command
  1165.  
  1166. Kermit68K normally does not need to have incoming packets  preceded  with  pad
  1167. characters.  This command allows Kermit68K to request the other Kermit to send
  1168. the specified number of pad characters before any packet.  The  default  value
  1169. is 0.
  1170.  
  1171. Kermit68K>SET RECEIVE PADDING <number>
  1172.  
  1173. Where <number> is the number of padding characters to request.
  1174.  
  1175.  
  1176. cc.pp.9.5 The Set Receive PAD_CHARACTER command
  1177.  
  1178. This parameter is the padding character  that  will  be  sent  by  the  remote
  1179. Kermit.   The  parameter  must be in the range of 0 to 31 or 127 decimal.  The
  1180. default value is 0 (ASCII NUL, CTRL-@).
  1181.  
  1182. Kermit68K>SET RECEIVE PAD_CHARACTER <char-ascii-value>
  1183.  
  1184. Where <char-ascii-value> is the ASCII value of the character to be used by the
  1185. remote Kermit as a pad character.
  1186.  
  1187.  
  1188. cc.pp.9.6 The Set Receive TIMEOUT command
  1189.  
  1190. This will set the number of seconds before Kermit68K will time out the attempt
  1191. to  receive  a  message.   This time out is used to handle transmission errors
  1192. which totally lose a message.  The default value is 15 seconds.
  1193.  
  1194. Kermit68K>SET RECEIVE TIMEOUT <n>
  1195.  
  1196. Where <n> is the number of seconds to wait for a message.
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.  
  1204.  
  1205.  
  1206.                                                                Page 22
  1207.  
  1208.  
  1209. cc.pp.10 The Set RETRY command
  1210.  
  1211. This command sets the maximum number of times Kermit68K  should  try  to  send
  1212. specific  packets.   There  are  two  retry  maximums,  one  for  the  initial
  1213. connection packet (the "SEND-INIT"), the other for  all  other  packets.   The
  1214. default  value  for initial connections is 5.  The default value for all other
  1215. packets is 16.
  1216.  
  1217. Kermit68K>SET RETRY <type> <n>
  1218.  
  1219. Where <type> is either INITIAL_CONNECTION (for initial  connection  packet) or
  1220. PACKET (for all other packets), and <n> is the number of retries to attempt.
  1221.  
  1222.  
  1223. cc.pp.11 The Set SEND command
  1224.  
  1225. It is possible to set various parameters associated with the receiving of  the
  1226. data from the remote Kermit.  SET SEND will enable you to set the various SEND
  1227. parameters.  These parameters should not normally be set, since as part of the
  1228. transfer  initialization  process  the  two  Kermit's  exchange  their RECEIVE
  1229. parameters.  The capability of setting these parameters is  provided  so  that
  1230. the  transfer  initialization  can be completed even if the default parameters
  1231. are not correct.
  1232.  
  1233.  
  1234. cc.pp.11.1 The Set Send END_OF_LINE command
  1235.  
  1236. This will set the end-of-line character the Kermit68K will send to the  remote
  1237. Kermit.   This is the character which terminates a packet.  The parameter must
  1238. be a number in the range 1 to 31 decimal.  The default  value  is  13  decimal
  1239. (ASCII CR, CTRL-M).
  1240.  
  1241. Kermit68K>SET SEND END_OF_LINE<char-ascii-value>
  1242.  
  1243. Where <char-ascii-value> is the ASCII value of the character to  use  for  the
  1244. end-of-line character.
  1245.  
  1246.  
  1247. cc.pp.11.2 The Set Send MARKER command
  1248.  
  1249. This command will set the start of packet character for Kermit68K.  The  start
  1250. of  packet  character  must  be  in the range of 1 to 31 decimal.  The default
  1251. value is 1 (ASCII  SOH,  CTRL-A).   This  value  should  only  be  changed  if
  1252. absolutely necessary.  It must be set the same in both Kermit's.
  1253.  
  1254. Kermit68K>SET SEND MARKER <char-ascii-value>
  1255.  
  1256. Where <char-ascii-value> is the ASCII value of the  start-of-packet  character
  1257. to use.
  1258.  
  1259.  
  1260. cc.pp.11.3 The Set Send PACKET_LENGTH command
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.                                                                Page 23
  1271.  
  1272.  
  1273. This will set the SEND packet length.  The value for this  parameter  must  be
  1274. between  10  and  94.   Packet lengths outside of this range are illegal.  The
  1275. default value is 90.
  1276.  
  1277. Kermit68K>SET SEND PACKET_LENGTH <n>
  1278.  
  1279. Where <n> is the send packet length to use.
  1280.  
  1281.  
  1282. cc.pp.11.4 The Set Send PADDING command
  1283.  
  1284. This command will set the number of padding characters that will  be  sent  to
  1285. the other Kermit.  The default value is 0.
  1286.  
  1287. Kermit68K>SET SEND PADDING <n>
  1288.  
  1289. Where <n> is the number of padding characters to use.
  1290.  
  1291.  
  1292. cc.pp.11.5 The Set Send PAD_CHARACTER command
  1293.  
  1294. This parameter is the padding character that is sent  to  the  remote  Kermit.
  1295. The  parameter  must  be a number in the range of 0 to 31 or 127 decimal.  The
  1296. default value is 0 (ASCII NUL, CTRL-@).
  1297.  
  1298. Kermit68K>SET SEND PAD_CHARACTER <char-ascii-value>
  1299.  
  1300. Where <char-ascii-value> is the ASCII value of the character to be used  as  a
  1301. pad character.
  1302.  
  1303.  
  1304. cc.pp.11.6 The Set Send TIMEOUT command
  1305.  
  1306. This will set the number of seconds before Kermit68K will time out  a  message
  1307. it has sent to the other Kermit.  This time out is used to handle transmission
  1308. errors which totally lose a message.  The default value is 15 seconds.
  1309.  
  1310. Kermit68K>SET SEND TIMEOUT <n>
  1311.  
  1312. Where <n> is the number of seconds to wait for a message.
  1313.  
  1314.  
  1315. cc.pp The SHOW command
  1316.  
  1317. The SHOW command will allow you to show the various parameters  that  are  set
  1318. with the SET command.  cc.pp.1 The Show PARAMETERS command
  1319.  
  1320. The SHOW PARAMETERS command will cause all of the Kermit68K parameters  to  be
  1321. listed.
  1322.  
  1323.  
  1324. cc.pp.2 The Show VERSION command
  1325.  
  1326.  
  1327.  
  1328.  
  1329.  
  1330.  
  1331.  
  1332.  
  1333.  
  1334.                                                                Page 24
  1335.  
  1336.  
  1337. Displays the version number of Kermit68K in use.
  1338.  
  1339.  
  1340. cc.pp The SPACE command
  1341.  
  1342. This causes Kermit68K to display the amount of disk space used  and  available
  1343. in the current working directory or device.
  1344.  
  1345. Kermit68K>SPACE [<local-device/directory-spec>]
  1346.  
  1347. Where <local-directory/device-spec> specifies the mass-storage area  for  wich
  1348. the usage statistics are wanted.
  1349.  
  1350.  
  1351. cc.pp The TAKE command
  1352.  
  1353. The TAKE command tells Kermit68K to execute commands from the specified file.
  1354.  
  1355. Kermit68K>TAKE <file-spec>
  1356.  
  1357. Where <file-spec> is any normal local file specification.
  1358.  
  1359.  
  1360. cc.pp The TYPE command
  1361.  
  1362. This causes Kermit68K to display the specified file(s) on the terminal.
  1363.  
  1364. Kermit68K>LOCAL TYPE <file-spec>
  1365.  
  1366. Where <file-spec> is a valid local file specification.
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.                                                                Page 25
  1377.  
  1378.  
  1379. cc.pp The macro commands capability
  1380.  
  1381. Concerning the macro commands capability, at the current development stage, it
  1382. should  be better named "command grouping capability", that is, you can define
  1383. a commands group making reference to it by use of a single name.
  1384.  
  1385. A little example, your computer is connected to two hosts, let say  a  VAX/VMS
  1386. and  an  IBM mainframe, you frequently need to exchange files with both of the
  1387. machines, maybe using your local computer  as  a  temporary  storage  station.
  1388. Given  this  scenario, when you want to connect to the IBM mainframe, you must
  1389. issue the following command sequence:
  1390. Kermit68K> SET LINE MyIBMLine
  1391. Kermit68K> SET PARITY ODD
  1392. Kermit68K> SET DUPLEX HALF
  1393. Kermit68K> SET HANDSHAKE XON
  1394.  
  1395. When you have finished your work with the IBM mainframe,  maybe  you  need  to
  1396. exchange files with the VAX/VMS system, so again:
  1397. Kermit68K> SET LINE MyVAXLine
  1398. Kermit68K> SET PARITY NONE
  1399. Kermit68K> SET DUPLEX FULL
  1400. Kermit68K> SET HANDSHAKE NONE
  1401.  
  1402. All this can cause you some frustration; command grouping helps  you  in  this
  1403. problem.   You  issue  to  Kermit68K  the  following  command sequences (maybe
  1404. included in a take file or in the initialization file KERMIT.INI) ONCE AND FOR
  1405. ALL:
  1406. Kermit68K> DEFINE IBM
  1407. SET LINE MyIBMLine
  1408. SET PARITY ODD
  1409. SET DUPLEX HALF
  1410. SET HANDSHAKE XON
  1411.  
  1412. (the blank line above tells Kermit68K that the macro body is finished)
  1413. Kermit68K> DEFINE VAX
  1414. SET LINE MyVAXLine
  1415. SET PARITY NONE
  1416. SET DUPLEX FULL
  1417. SET HANDSHAKE NONE
  1418.  
  1419. (the same for this blank line)
  1420.  
  1421. At this point, all that you need to switch  the  connection  between  the  two
  1422. systems back and forth is to type the commands IBM and VAX.
  1423.  
  1424. If you want to define a one-command macro, you can do  the  job  on  a  single
  1425. line, another example:
  1426. Kermit68K> DEFINE KEEP SET INCOMPLETE_FILE_DISPOSITION KEEP
  1427.  
  1428. You can see the body of a macro by requiring its LISTing, for example:
  1429. Kermit68K> LIST IBM
  1430.  
  1431.  
  1432.  
  1433.  
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439.                                                                Page 26
  1440.  
  1441.  
  1442. The command line expansion will come soon in a new Kermit68K release.  By this
  1443. new  facility  you'll  be able to give aliases to Kermit68K commands and to do
  1444. other interesting things.  Two examples showing the FUTURE:
  1445. Kermit68K> DEFINE LS DIR %1
  1446.  
  1447. where %1 stands for the 1st parameter, if you are UNIX-dependent, now you  can
  1448. use LS instead of DIR;
  1449. Kermit68K> DEFINE MOVE
  1450. echo Sending file %1
  1451. send %1
  1452. echo Deleting file %1
  1453. delete %1
  1454.  
  1455. now you have a command that will allow you  to  destroy  your  most  important
  1456. files, if the transfer fails.
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.                                                                Page 27
  1467.  
  1468.  
  1469. cc Command Line Operation
  1470.  
  1471. The Kermit68K command line syntax conforms to the  Proposed  Syntax  Standards
  1472. for  Unix  System  Commands put forth by Kathy Hemenway and Helene Armitage of
  1473. ATT Bell Laboratories in Unix/World, Vol.1, No.3, 1984.  The rules that  apply
  1474. are:
  1475.  
  1476.       a) Command names must be between 2 and 9 characters ("kermit" is 6).
  1477.       b) Command names must include lower case letters and digits only.
  1478.       c) An option name is a single character.
  1479.       d) Options are delimited by '-'.
  1480.       e) Options with no arguments may be grouped (bundled) behind one
  1481.          delimiter.
  1482.       f) Option-arguments cannot be optional.
  1483.       g) Arguments immediately follow options, separated by whitespace.
  1484.       h) The order of options does not matter.
  1485.       i) A group of bundled options may end with an option that has an argument.
  1486.  
  1487.  
  1488. Kermit68K command line options may specify either  actions  or  settings.   If
  1489. Kermit68K  is  invoked  with a command line that specifies no actions, then it
  1490. will issue a prompt and begin  interactive  dialog.   Action  options  specify
  1491. either  protocol  transactions  or  terminal connection.  The command line may
  1492. contain no more than one protocol action option.  The  following  options  are
  1493. interpreted by Kermit68K.
  1494.  
  1495. -s <file-spec>
  1496.                 Send the specified file or  files.   If  <file-spec>  contains
  1497.                 wildcard  (meta)  characters,  Kermit68K will try to expand it
  1498.                 into a file list.
  1499.  
  1500. -r
  1501.                 Receive a file or files.  Wait passively for files to arrive.
  1502.  
  1503. -k
  1504.                 Receive (passively) a file or files, sending them to  standard
  1505.                 output.   If  the  operating  system  supports  IO redirection
  1506.                 and/or pipes, this option can be powerfully  used  in  several
  1507.                 ways.
  1508.  
  1509. -a <file-spec>
  1510.                 If you have specified a file transfer option  in  the  command
  1511.                 line,  you  may  give an alternate name for a single file with
  1512.                 the -a ("as") option.  When used with -s  Kermit68K  tells  to
  1513.                 the  receiver  that  the  file  must  be stored under the name
  1514.                 <file-spec>, when used with -r or  -g,  Kermit68K  stores  the
  1515.                 incoming  file  under the name <file-spec>.  Note that if more
  1516.                 than one file is sent or  arrives,  only  the  first  file  is
  1517.                 affected by the -a option.
  1518.  
  1519. -l <device>
  1520.                 Specify a terminal line to use for file transfer and  terminal
  1521.                 connection.   When  an  external line is being used, you might
  1522.                 also need some additional options for successful communication
  1523.                 with  the remote system.  These options are -b (baud-rate), -p
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.                                                                Page 28
  1534.  
  1535.  
  1536.                 (parity) and -t (turnaround).
  1537.  
  1538. -b <baud-rate>
  1539.                 Specify the baud rate for the line given  in  the  -l  option.
  1540.                 This  option  should  always  be  included with the -l option,
  1541.                 since the speed of an external line is  not  necessarily  what
  1542.                 you  expect.   <baud-rate> is a number specification, possible
  1543.                 values are 50, 110, 150, 300, 600,  1200,  2400,  4800,  9600,
  1544.                 19200 and 38400.
  1545.  
  1546. -p <parity>
  1547.                 Specify the parity  to  be  used  on  the  transmission  line,
  1548.                 possible  values  are  e,o,m,s,n  (even,  odd, mark, space, or
  1549.                 none).  If  parity  is  other  than  none,  then  the  8th-bit
  1550.                 prefixing mechanism will be used for transferring 8-bit binary
  1551.                 data, provided that the opposite Kermit agrees.   The  default
  1552.                 parity is none.
  1553.  
  1554. -t
  1555.                 Specifies  half  duplex,  line  turnaround  with  XON  as  the
  1556.                 handshake character.
  1557.  
  1558. -g <file-spec>
  1559.                 Actively request a remote server to send  the  named  file  or
  1560.                 files,  note  that  <file-spec> is a file specification in the
  1561.                 remote host's own syntax.
  1562.  
  1563. -f
  1564.                 Send a 'finish' command to a remote server.
  1565.  
  1566. -c
  1567.                 Establish a terminal connection over the default communication
  1568.                 line,  before  any protocol transaction takes place.  Get back
  1569.                 to the local system by typing the escape  character  (normally
  1570.                 Control-E) followed by the letter 'c'.
  1571.  
  1572. -n
  1573.                 Like -c, but after a protocol transaction takes place; -c  and
  1574.                 -n may both be used in the same command.  The use of -n and -c
  1575.                 is illustrated below.
  1576.  
  1577. -i
  1578.                 Specifies that files should be sent or  received  exactly  "as
  1579.                 is"  with  no  conversions.   This  option  is  necessary  for
  1580.                 transmitting binary files.  It may also be used for  transfers
  1581.                 between  like  systems  (it  must  be  given to both Kermit68k
  1582.                 programs), where it will improve performance by  circumventing
  1583.                 the  normal  text-file  conversions, and will allow mixture of
  1584.                 text and binary files in a single file group.
  1585.  
  1586. -w
  1587.                 Avoid filename collisions for incoming files.
  1588.  
  1589.  
  1590.  
  1591.  
  1592.  
  1593.  
  1594.  
  1595.  
  1596.  
  1597.                                                                Page 29
  1598.  
  1599.  
  1600. -q
  1601.                 Suppress screen update during file transfer, for  instance  to
  1602.                 allow a file transfer to proceed in the background.
  1603.  
  1604. -h
  1605.                 Display a brief synopsis of the command line options.
  1606.  
  1607. Command Line Examples:
  1608.  
  1609. kermit -l EPCI2 -b 1200 -cn -r
  1610.  
  1611. This command connects you to the system on the other  end  of  EPCI2  at  1200
  1612. baud, where you presumably log in and run Kermit with a 'send' command.  After
  1613. you escape back, Kermit68K waits for a file (or files) to  arrive.   When  the
  1614. file  transfer  is completed, you are reconnected to the remote system so that
  1615. you can logout.
  1616.  
  1617. kermit -l /T1 -b 4800 -cntp m -r -a format.s
  1618.  
  1619. This command is like the preceding one, except the remote system in this  case
  1620. uses  half duplex communication with mark parity.  The first file that arrives
  1621. is stored under the name format.s.
  1622.  
  1623. kermit -l /dev/ttyi6 -b 9600 -nf
  1624.  
  1625. This command would be used to shut down a remote server and  then  connect  to
  1626. the  remote  system, in order to log out or to make further use of it.  The -n
  1627. option is invoked after -f (-c would have been invoked before).
  1628.  
  1629. kermit -i -wl acia1 -b 9600
  1630.  
  1631. This command sets the communication line and speed.  Files are transmitted  as
  1632. binary.   Incoming  files that have the same names as existing files are given
  1633. new, unique names.  Since no action is specified, Kermit68K  issues  a  prompt
  1634. and  enters an interactive dialog with you.  Any settings given on the command
  1635. line remain in force during the dialog, unless explicitly changed.
  1636.  
  1637. kermit
  1638.  
  1639. This command starts up Kermit interactively with all default settings.
  1640.  
  1641. cc.pp File Transfer
  1642.  
  1643. If Kermit68K is in local mode and file display is on, the terminal  screen  is
  1644. continously  updated  to  show  the  progress  of the file transfer.  A dot is
  1645. printed for every four data packets, other packets are shown by type:
  1646.  
  1647.       I Exchange Parameter Information
  1648.       R Receive Initiate
  1649.       S Send Initiate
  1650.       F File Header
  1651.       G Generic Server Command
  1652.       C Remote Host Command
  1653.       N Negative Acknowledgement (NAK)
  1654.       E Fatal Error
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.                                                                Page 30
  1665.  
  1666.  
  1667.       T Indicates a timeout occurred
  1668.       Q Indicates a damaged, undesired, or illegal packet was received
  1669.       % Indicates a packet was retransmitted
  1670.  
  1671. cc.pp Control Characters
  1672.  
  1673. During a file transfer (GET, RECEIVE or SEND commands) with Kermit68K in local
  1674. mode  the  following  control characters can be used to affect the transfer in
  1675. progress:
  1676.  
  1677.            CTRL-R - Force a protocol timeout, resend last packet
  1678.            CTRL-X - Abort the file currently being transfered
  1679.            CTRL-Z - Abort the file group currently being transfered
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.                                                                Page 31
  1690.  
  1691.  
  1692. cc.pp References
  1693.  
  1694.       1 Kermit, A File Transfer Protocol,
  1695.         ISBN 0-932376-88-6, 1986
  1696.         Frank da Cruz, Digital Press, Bedford MA
  1697.         DEC order number EY-6705E-DP
  1698.  
  1699.  
  1700.       2 M68000 16-Bit Microprocessor, User's Manual,
  1701.         MC68000UM(AD3), Third Edition, 1982
  1702.         Motorola Inc.
  1703.  
  1704.  
  1705.       3 MC68020 32-Bit Microprocessor, User's Manual,
  1706.         MC68020UM(AD1), First Edition, 1984
  1707.         Motorola Inc.
  1708.  
  1709.  
  1710.       4 68000/08/10 Cross Assembler for MSDOS & CP/M 86, Reference Manual
  1711.         2500 A.D. Software, Inc.
  1712.  
  1713.  
  1714.       5 M68000 Cross Macro Assembler, Reference Manual,
  1715.         M68KXASM(D3), September 1979
  1716.         Motorola Inc.
  1717.  
  1718.  
  1719.       6 M68MIL Cross Macro Assembler
  1720.         CERN 83-12, 22 December 1983
  1721.         Horst von Eicken, CERN, Data Handling Division
  1722.