          Kermit is a file transfer program.  It allows  the  transfer
          of files over terminal lines from a remote Kermit program to
          the local Kermit program.

          Kermit-10 can be run in either local or  remote  modes.   In
          remote  mode,  transfers  take  place  over  the controlling
          terminal line.  Ususally, Kermit-10 is used in  remote  mode
          as a "server", meaning that it will accept commands from the
          other  Kermit.   In  local  mode,  Kermit-10  will   perform
          transfers  over  a  terminal line other than the controlling
          terminal.  In local mode, Kermit-10  is  capable  of  giving
          commands  to a "server" Kermit.  Kermit-10 is put into local
          mode by using the SET LINE command.

          Type  HELP  <command>  for  more  information  on  a   given
          commands.  Additional information is avaiable for:

          BYE       CONNECT   EXIT      FINISH    GET       LOGOUT
          RECEIVE SEND        SET       SHOW      STATUS

*BYE
BYE       This command will cause Kermit-10 (when in  local  mode)  to
          tell  the  other  Kermit (which should be in server mode) to
          exit from Kermit and, if applicable, terminate its  job  (or
          process, etc.).  When Kermit-10 receives the acknowledgement
          that this is being done, it will exit to VMS.

                    Kermit-10>BYE


*CONNECT
CONNECT   The CONNECT command will  allow  you  to  connect  in  as  a
          virtual terminal over the line that was specified by the SET
          LINE command, or to  the  terminal  line  specified  in  the
          command.  The format of the CONNECT command is:

                    Kermit-10>CONNECT

          or

                    Kermit-10>CONNECT device:

          where device: is the terminal name to be used.

          or

                    Kermit-10>CONNECT node:: line

          where node:: is the node number the terminal is  attach  to,
          and line is the line number within that node.

*EXIT
EXIT      The EXIT command will cause  Kermit  to  return  to  command
          level.   This  command  is the same as the QUIT command.  An
          example of this command is:

                    Kermit-10>EXIT

*FINISH
FINISH    This command will cause Kermit-10 (when in  local  mode)  to
          tell  the  other  Kermit (which should be in server mode) to
          exit from Kermit.  After receiving the acknowledgement  that
          this  is  being  done,  Kermit-10  will  prompt  for another
          command.

                    Kermit-10>FINISH


*GET
GET       This command can only be used in local mode.  It will  cause
          Kermit-10  to  request  that the other Kermit (which must be
          running in server mode) to transmit the specifed file(s)  to
          Kermit-10.

                    Kermit-10>GET file-specification

          Where "file-specification" is a valid file specification for
          the system on which the other Kermit is running.

*LOGOUT
LOGOUT    This command will cause Kermit-10 (when in  local  mode)  to
          tell  the  other  Kermit (which should be in server mode) to
          exit from Kermit and, if applicable, terminate its  job  (or
          process, etc.).  When Kermit-10 receives the acknowledgement
          that this is being done, it will prompt for another command.

                    Kermit-10>LOGOUT


*QUIT
QUIT      This command will cause Kermit to return to  command  level.
          This is the same as the EXIT command.

                    Kermit-10>QUIT

*RECEIVE
RECEIVE   The RECEIVE command is used to  put  Kermit-10  into  remote
          mode  waiting for a single file transfer transaction.  If no
          file specification is given, Kermit-10 will wait for a  file
          transfer  initialization sequence from the other Kermit.  If
          a file specification is given, that file specification  will
          be  used  to  store the received file(s), regardless of what
          name is supplied by the other Kermit.

          The format of the command is:

                    Kermit-10>RECEIVE

          or

                    Kermit-10>RECEIVE file-specification

          Where  "file-specification"  is  any  valid   TOPS-10   file
          specification.

*SEND
SEND      The SEND command will allow you to send  a  file(s)  to  the
          other  Kermit.   If Kermit-10 is running in remote mode, the
          file will be sent on the  controlling  terminal  line  after
          waiting  the  number  of  seconds specified by the SET DELAY
          command.  This gives the user time to  escape  back  to  the
          other  Kermit  and issue a receive command.  If Kermit-10 is
          running in local mode, the file will be sent immediately  on
          the terminal line specified by the SET LINE command.

          The command format is:

                    Kermit-10>SEND file-specification

          Where  "file-specification"  is  any  normal  TOPS-10   file
          specification.    Any  portion  of  the  file  specification
          (except the device) may be wildcarded.  Note that the single
          wild-card  character  is  indicated  by  a  % instead of the
          usualy ?, since ? is used to obtain help.

*SERVER
SERVER    This command will cause Kermit-10 to enter server mode.  The
          other  Kermit  can  then  issue  server commands to send and
          receive  files  without  having  to  give  SEND  or  RECEIVE
          commands  to  Kermit-10.   Kermit-10  may be put into SERVER
          mode while running as either a remote  Kermit  (transmitting
          over  the  controlling  terminal line), or as a local Kermit
          (transmitting over  a  terminal  specified  by  a  SET  LINE
          command).   Note  that  in order to correctly receive binary
          files while in SERVER mode, a SET  FILE-BYTE-SIZE  EIGHT-BIT
          must  be  done  first.   At  this  time  there is no way for
          Kermit-10 to determine whether an incoming file is ASCII  or
          binary.   Kermit-10  does make an attempt to guess whether a
          file being sent is ASCII or binary if a  SET  FILE-BYTE-SIZE
          AUTO-BYTE  command  is  done,  however,  this  tends  to  be
          unreliable as it is based on the  mode  used  to  write  the
          file.

          The format of the command is:

                    Kermit-10>SERVER


*SET
SET       The SET command is used to set various parameters in Kermit.
          Additional  information  is available for the SET command by
          typing HELP  SET  <option>,  where  option  is  one  of  the
          following:

          BLOCK-CHECK-TYPE              DEBUGGING      DELAY    ESCAPE
          FILE-BYTE-SIZE FILE-WARNING   IBM-MODE       INCOMPLETE-FILE
          LINE LOCAL-ECHO                MESSAGE       PARITY  RECEIVE
          REPEAT RETRY   SEND

*SET BLOCK-CHECK-TYPE
SET BLOCK-CHECK-TYPE     The SET BLOCK-CHECK-TYPE command is  used  to
          determine  the  type  of  block check sequence which will be
          used during transmission.  The block check sequence is  used
          to  detect  transmission  errors.   There are three types of
          block check  available.   These  are  the  single  character
          checksum  (default),  the  two  character  checksum, and the
          three character CRC (cyclic redundancy check).  This command
          does not ensure that the desired type of block check will be
          used, since both Kermit's  involved  in  the  transfer  must
          agree  on the block check type.  Kermit-10 will request that
          the type of block check set by this command be  used  for  a
          transfer.   If  the other Kermit has also had the same block
          check type requested, then the desired block check type will
          be  used.   Otherwise, the single character checksum will be
          used.  (See Kermit protocol manual for more information.)

                    Kermit-10>SET BLOCK-CHECK-TYPE keyword

          Where keyword is one of:

          1.  1-CHARACTER-CHECKSUM or ONE-CHARACTER-CHECKSUM

          2.  2-CHARACTER-CHECKSUM or TWO-CHARACTER-CHECKSUM

          3.  3-CHARACTER-CRC-CCITT or THREE-CHARACTER-CRC-CCITT


*SET DEBUGGING
SET DEBUGGING            The SET DEBUGGING command is used to set  the
          debug  type  out on the user's terminal.  Kermit-10 can only
          do debugging type out when running as a  local  Kermit  (SET
          LINE  command done).  This is because the debugging type out
          would interfere with the file transfer if it  were  sent  to
          the controlling terminal line in remote mode.  The debugging
          log file may be used to redirect the debugging output  to  a
          file.   This  may  be  used with Kermit-10 running in either
          remote or local modes.

                    Kermit-10>SET DEBUGGING keyword

          Where keyword is either ON, OFF,  NO-LOG-FILE,  or  LOG-FILE
          file-specification.    Doing   a   SET   DEBUGGING  LOG-FILE
          file-spec causes Kermit-10 to turn debugging on  and  append
          all  debugging  output  to  the file specified.  If the file
          does  not  exist  it  will  be   created.    SET   DEBUGGING
          NO-LOG-FILE will close the log file and turn debugging off.

*SET DELAY
SET DELAY The DELAY parameter is the number of seconds to wait  before
          sending  data  after  a SEND command is given.  This is used
          when Kermit-10 is running in remote mode to allow  the  user
          time  to  escape back to the other Kermit and give a RECEIVE
          command.

                    Kermit-10>SET DELAY number-of-seconds

          Where number of seconds is the (decimal) number of second to
          wait before sending data.

*SET ESCAPE
SET ESCAPE               This command will set  the  escape  character
          for the CONNECT processing.  The command will take the octal
          value of the character to use as the escape character.  This
          is the character which is used to "escape" back to Kermit-10
          after using the CONNECT command.  It defaults to  ^Y  (octal
          31).   It  is  usually  a good idea to set this character to
          something which is not used (or at least not used very much)
          on the system being to which Kermit-10 is CONNECTing.

                    Kermit-10>SET ESCAPE octal-character-value

          Where  octal-character-value  is  the  ASCII  value  of  the
          character to use as the escape character (in octal).

*SET FILE-BYTE-SIZE
SET FILE-BYTE-SIZE       This command sets  the  byte  size  Kermit-10
          will use for files being received or transmitted.  SEVEN-BIT
          bytes should be used for ASCII text files which  are  to  be
          used  as text files on the TOPS-10 system.  SEVEN-BIT should
          also be used to  sending  TOPS-10  format  binary  files  to
          another  system  if  the file is intended to be brought to a
          TOPS-10 system.  EIGHT-BIT bytes should be used  for  binary
          files from other systems (such as CP/M .COM files) which are
          being transferred to the TOPS-10 system for  storage.   This
          allows   the  file  to  be  returned  without  any  changes.
          AUTO-BYTE is the same as SEVEN-BIT for files being  received
          from   the   other   Kermit.    When  sending  a  file  with
          FILE-BYTE-SIZE AUTO-BYTE, Kermit-10 will guess  whether  the
          file  should  be sent as SEVEN-BIT or EIGHT-BIT.  This guess
          is based on the mode used to write the file.   If  the  file
          was  written  in image mode, image binary mode, binary mode,
          or dump record mode, the file will be sent as  an  EIGHT-BIT
          file,  otherwise  it will be sent as a SEVEN-BIT file.  Note
          that version 1 of Kermit-10 wrote all files it  received  in
          binary mode, even if FILE-BYTE-SIZE SEVEN-BIT was set.  This
          means that AUTO-BYTE will not correctly determine  the  byte
          size  to  use  for  files which were written with Kermit-10.
          This is also true of files written  by  a  number  of  other
          programs  under  TOPS-10, most notably any file written by a
          Galaxy component (such as batch .LOG files) are  written  in
          binary mode.  AUTO-BYTE is the default FILE-BYTE-SIZE.

                    Kermit-10>SET FILE-TYPE type

          Where type is SEVEN-BIT, EIGHT-BIT or AUTO-BYTE.

*SET FILE-WARNING
SET FILE-WARNING         This command determines what  Kermit-10  will
          do  when  it  receives  a file with a file name that already
          exists.  If FILE-WARNING is turned ON,  Kermit-10  will  not
          supersede  the old file.  Instead it will create a file with
          the same file name and the first extension of the form  .nnn
          (where  n  is  an  octal  digit) such that the file will not
          supersede any existing file.  If FILE-WARNING is turned  OFF
          (the default), Kermit-10 will supersede the old file.

                    Kermit-10>SET FILE-WARNING keyword

          Where keyword is either ON or OFF.

*SET IBM-MODE
SET IBM-MODE             The SET IBM-MODE command allows Kermit-10  to
          be  put  into  a  mode  which will allow transfers to an IBM
          host.  This causes Kermit-10 to wait for the IBM  turnaround
          character (XON, CTRL-Q) before sending any characters to the
          other Kermit.  It also forces the parity type  to  be  mark,
          and turns on local echo for the CONNECT command.

                    Kermit-10>SET IBM-MODE keyword

          Where keyword is either ON or OFF.

*SET INCOMPLETE-FILE
SET INCOMPLETE-FILE      The SET INCOMPLETE-FILE  command  allows  the
          user  to  determine  what  is  done  with a file that is not
          completely received.  If the disposition is KEEP,  all  file
          received will be kept, even if only a portion of the file is
          received.  If the  disposition  is  DISCARD  (the  default),
          files which are not completely received are discarded.

                    Kermit-10>SET INCOMPLETE-FILE keyword

          Where keyword is either DISCARD or KEEP.

*SET LINE
SET LINE  This will set the terminal line that Kermit-10 will use  for
          file transfers and the CONNECT command.

                    Kermit-10>SET LINE device:

          Where device: is a terminal name.

          or

                    Kermit-10>SET LINE node:: line

          Where node:: is the node name  the  terminal  is  physically
          connected  to,  and line number is the terminals line number
          within that node.

*SET LOCAL-ECHO          
SET LOCAL-ECHO           The SET LOCAL-ECHO command specifies  whether
          characters  should  be  echoed  locally  when  CONNECTing to
          another system.  If LOCAL-ECHO is set to ON,  any  character
          typed  on  the  terminal  will  be echoed immediately to the
          terminal, as well as being sent to  the  other  system.   If
          LOCAL-ECHO is set to OFF (the default), the characters typed
          on the terminal are only sent to  the  other  system  (which
          would normally be echoing the characters).

                    Kermit-10>SET LOCAL-ECHO keyword

          Where keyword is either ON or OFF.

*SET MESSAGE
SET MESSAGE              This  command  sets  the  type   of   typeout
          Kermit-10 will do during transfers in local mode.  Kermit-10
          can type out the file specification being  transferred,  the
          packet numbers being sent an received, both or neither.  The
          default is  to  type  file  specifications  but  not  packet
          numbers.

                    Kermit-10>SET MESSAGE type

          or

                    Kermit-10>SET MESSAGE NO type

          Where type is either FILE or PACKET.

*SET PARITY
SET PARITY               This command determines the type of parity to
          use   on   the  transmission  line.   Kermit  normally  uses
          characters which consist of eight data bits with  no  parity
          bit.   For  systems  or  transmission  media which require a
          specific parity type, Kermit can send  characters  as  seven
          data bits plus a parity bit.

                    Kermit-10>SET PARITY keyword

          Where keyword is one of:

          1.  NONE (default) - eight data bits and no parity bit.

          2.  MARK - seven data bits with the parity bit set to one.

          3.  SPACE - seven data bits with the parity bit set to zero.

          4.  EVEN - seven data bits with the parity bit set  to  make
              the overall parity even.

          5.  ODD - seven data bits with the parity bit  set  to  make
              the overall parity odd.


*SET RECEIVE
SET RECEIVE              It is  possible  to  set  various  parameters
          associated  with  the  receiving of the data from the remote
          Kermit.  SET RECEIVE will enable  you  to  set  the  various
          receive parameters.  Additional information is available for
          the  SET  RECEIVE  commands  by  typing  HELP  SET   RECEIVE
          <option>, where <option> is one of the following:

          EIGTH-BIT-QUOTE               END-OF-LINE    PACKET-LENGTH
          PADCHAR PADDING               QUOTE          
          START-OF-PACKET TIMEOUT

*SET RECEIVE EIGTH-BIT-QUOTE
SET RECEIVE 8TH-BIT-QUOTE or
SET RECEIVE EIGTH-BIT-QUOTE             This    command    sets    the
          character  to  be  used (when necessary) to quote characters
          which have the eigth bit (parity bit) set.  This is used  to
          transfer eight-bit bytes on a transmission medium which only
          supports seven data bits.  The default value  is  46  (ASCII
          "").   Eigth-bit  quoting will only be used if both Kermit's
           _
          can handle it, and the tranmission medium does not  transmit
          8 data bits (as indicated by the SET PARITY command).

                    Kermit-10>SET RECEIVE EIGTH-BIT-QUOTE nnn

          Where nnn is the ASCII value of the character (in octal)  to
          use for quoting characters which have the eigth bit set.

*SET RECEIVE END-OF-LINE
SET RECEIVE END-OF-LINE  This will set the end of line  character  the
          Kermit-10  expects  to receive from the remote Kermit.  This
          is the character which terminates  a  packet.   The  default
          value is 15 (ASCII CR, CTRL-M).

                    Kermit-10>SET RECEIVE END-OF-LINE nnn

          Where n is the ASCII value of the character to use  for  the
          end of line character (in octal).

*SET RECEIVE PACKET-LENGTH
SET RECEIVE PACKET-LENGTH               This  will  set  the   receive
          packet length.  The value for this parameter must be between
          10 and  96.   Packet  lengths  outside  of  this  range  are
          illegal.  The default value is 80.

                    Kermit-10>SET RECEIVE PACKET-LENGTH 60

*SET RECEIVE PADCHAR
SET RECEIVE PADCHAR      This parameter is the padding character  that
          is  sent  to  the  remote  Kermit.  The parameter must be an
          octal number in the range of 0 to  37  or  177.   All  other
          values are illegal.  The default value is 0 (an ASCII NUL).

                    Kermit-10>SET RECEIVE PADCHAR nnn

          Where nnn is the ASCII value of the character to be used  as
          a pad character (in octal).

*SET RECEIVE PADDING
SET RECEIVE PADDING      This command will set the number  of  padding
          characters  that  will  be  sent  to  the other Kermit.  The
          default value is 0.

                    Kermit-10>SET RECEIVE PADDING n

          Where n is the decimal number of padding characters to use.

*SET RECEIVE QUOTE
SET RECEIVE QUOTE        This will  set  the  quoting  character  that
          Kermit-10  will  expect  on  incoming messages.  This is the
          character used to quote  control  characters.   The  default
          value is 43 (ASCII " ").

                    Kermit-10>SET RECEIVE QUOTE nnn

          Where nnn is the ASCII value of the  quoting  character  (in
          octal).

*SET RECEIVE START-OF-PACKET
SET RECEIVE START-OF-PACKET             This  command  will  set   the
          start  of  packet character for Kermit.  The start of packet
          character must be in the  range  of  0  to  36  octal.   The
          default  value  is 1 (ASCII SOH, CTRL-A).  This value should
          only be changed if absolutely necessary.  It must be set the
          same in both Kermit's.

                    Kermit-10>SET RECEIVE START-OF-PACKET 3

*SET RECEIVE TIMEOUT
SET RECEIVE TIMEOUT      This will set the number  of  seconds  before
          Kermit-10  will  time  out the attempt to receive a message.
          This time out is used to handle  transmission  errors  which
          totally lose a message.  The default value is 15 seconds.

                    Kermit-10>SET RECEIVE TIMEOUT n

          Where n is the number of seconds to wait for a  message  (in
          decimal).

*SET REPEAT
SET REPEAT               This command sets the character to be used as
          the  lead-in  character  for  a repeat sequence (a string of
          characters which represents some number of characters  which
          are  repeated  in  the  data).   Both  Kermit's must support
          repeat compression for this to be in effect.  The  character
          set  by  this  command  must  be in the range 41 ("1") to 76
          (">") or 140 ("`") to 176 ("~").  The character will only be
          used  on file which are being transmitted by Kermit-10.  The
          REPEAT character used for incoming files is  decided  on  by
          the  other Kermit.  The default value is 176 ("~").  A value
          of 40 (a space) will disable repeat compression.

                    Kermit-10>SET REPEAT nnn

          Where  nnn  is  the  ASCII  value  for  the  repeat  quoting
          character (in octal).

*SET RETRY
SET RETRY This command sets the  maximum  number  of  times  Kermit-10
          should  try  to  send  specific packet.  There are two retry
          maximums,  one  for  the  initial  connection  packet   (the
          "SEND-INIT"),  the other for all other packets.  The default
          value for initial connections is 5.  The default  value  for
          all other packets is 16.

                    Kermit-10>SET RETRY keyword n

          Where keyword  is  either  INITIAL-CONNECTION  (for  initial
          connection packet) or PACKETS (for all other packets), and n
          is the decimal number of retries to attempt.

*SET SEND
SET SEND  It is possible to set various parameters associated with the
          sending  of  data  from  the  remote  Kermit.  SET SEND will
          enable you  to  set  the  various  SEND  parameters.   These
          parameters  should not normally be set, since as part of the
          transfer initialization process the  two  Kermit's  exchange
          their  RECEIVE  parameters.  The capability of setting these
          parameters is provided so that the  transfer  initialization
          can  be  completed  even  if  the default parameters are not
          correct.  Additional information is available  for  the  SET
          SEND  command  by  typing  HELP  SET  SEND  <option>,  where
          <option> is one of the following:

          END-OF-LINE    PACKET-LENGTH  PADCHAR        PADDING   QUOTE
          START-OF-PACKET TIMEOUT

*SET SEND END-OF-LINE
SET SEND END-OF-LINE     This will set the end of line  character  the
          Kermit-10  will  send  to  the  remote  Kermit.  This is the
          character which terminates a packet.  The default  value  is
          15 (ASCII CR, CTRL-M).

                    Kermit-10>SET SEND END-OF-LINE nnn

          Where n is the ASCII value of the character to use  for  the
          end of line character (in octal).

*SET SEND PACKET-LENGTH
SET SEND PACKET-LENGTH   This will set the SEND  packet  length.   The
          value  for this parameter must be between 10 and 96.  Packet
          lengths outside of this  range  are  illegal.   The  default
          value is 80.

                    Kermit-10>SET SEND PACKET-LENGTH 60

*SET SEND PADCHAR
SET SEND PADCHAR         This parameter is the padding character  that
          is  sent  to  the  remote  Kermit.  The parameter must be an
          octal number in the range of 0 to  37  or  177.   All  other
          values are illegal.  The default value is 0 (an ASCII NUL).

                    Kermit-10>SET SEND PADCHAR nnn

          Where nnn is the ASCII value of the character to be used  as
          a pad character (in octal).

*SET SEND PADDING
SET SEND PADDING         This command will set the number  of  padding
          characters  that  will  be  sent  to  the other Kermit.  The
          default value is 0.

                    Kermit-10>SET SEND PADDING n

          Where n is the decimal number of padding characters to use.

*SET SEND QUOTE
SET SEND QUOTE           This will  set  the  quoting  character  that
          Kermit-10  will  expect  on  incoming messages.  This is the
          character used to quote  control  characters.   The  default
          value is 43 (ASCII " ").

                    Kermit-10>SET SEND QUOTE nnn

          Where nnn is the ASCII value of the  quoting  character  (in
          octal).

*SET SEND START-OF-PACKET
SET SEND START-OF-PACKET This command will set  the  start  of  packet
          character for Kermit.  The start of packet character must be
          in the range of 0 to 36  octal.   The  default  value  is  1
          (ASCII  SOH,  CTRL-A).  This value should only be changed if
          absolutely necessary.  It must  be  set  the  same  in  both
          Kermit's.

                    Kermit-10>SET SEND START-OF-PACKET 3

*SET SEND TIMEOUT
SET SEND TIMEOUT         This will set the number  of  seconds  before
          Kermit-10  will  time out a message it has sent to the other
          Kermit.   message.   This  time  out  is  used   to   handle
          transmission  errors  which  totally  lose  a  message.  The
          default value is 15 seconds.

                    Kermit-10>SET SEND TIMEOUT n

          Where n is the number of seconds to wait for a  message  (in
          decimal).

*SHOW
SHOW      The  SHOW  command  will  allow  you  to  show  the  various
          parameters  that  are  set with the SET command.  Additional
          information is available for the SHOW command by typing HELP
          SHOW <option>, where <option> is one of the following:

          ALL           DAYTIME       DEBUGGING     FILE-INFORMATION
          LINE-INFORMATION PACKET-INFORMATION       VERSION

*SHOW ALL
SHOW ALL  The SHOW ALL command will cause all of the parameters to  be
          listed.

*SHOW DAYTIME
SHOW DAYTIME            Display the current date and time.

*SHOW DEBUGGING
SHOW DEBUGGING          Display  whether  debugging  is  enabled,  the
          current  debugging  log  file (if any), and the message type
          out information.

*SHOW FILE-INFORMATION
SHOW FILE-INFORMATION   This will display the  parameters  related  to
          files  being used.  This includes the file byte size and the
          incomplete file disposition.

*SHOW LINE-INFORMATION
SHOW LINE-INFORMATION   Display the  terminal  line  being  used,  the
          parity being used and whether local echo is enabled.

*SHOW PACKET-INFORMATION
SHOW PACKET-INFORMATION This will display the current settings of  the
          send and receive packet parameters.

*SHOW VERSION
SHOW VERSION            Display the version number of Kermit-10.

*STATUS
STATUS    The current status of Kermit-10  will  be  displayed.   This
          includes  the  number  of characters that have been sent and
          received from  the  remote  Kermit.   Also  included  is  an
          estimate  of  the effective baud rate of the transfer.  This
          number is not intended to be exact, but only  an  indication
          of what range of throughput has been provided.
