





INTRODUCTION

 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.  

1 @

 This commamd opens an indirect file for command  input.   It  is
 identical to the TAKE command.  The format of the command is:
  
                Kermit-11>@ file-specification
  
 where 'file-specification' is any valid  file  specification  on
 the system on which the server kermit is running.

1 BYE

 The BYE command will cause Kermit-11 (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-11 receives the acknowledgement that this is
 being done, it will prompt for another command.  The  DISCONNECT
 command  should  always  follow the BYE command.  The format for
 BYE is:
  
                Kermit-11>BYE
  

1 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.  (Using the CONNECT command before using the  SET  LINE
 command  will result in an error message) The terminal line must
 be one which is accessable to  the  user.   The  format  of  the
 CONNECT command is:
  
                Kermit-11>CONNECT
  
 Since for RSX11M/M+ the SET SPEED command and the  internal  QIO
 issued  to  disable  echoing require that Kermit be a privileged
 task,  you  may  have  to  give  the  MCR  SET /ECHO=TTnn:   and
 SET /SPEED=TTnn:xxxx:xxxx  first.   This  can  be done using the
 SYSTEM command.

1 COPY

 The COPY  command  creates  a  copy  of  the  input  file.   The
 Kermit-11  COPY  command  does  NOT  support  wildcards  in  the
 filename, and while COPY does use  multiblock  buffering  it  is
 usually  more  efficient to use the system utilty PIP or the DCL
 command COPY for this.  COPY uses RMS block i/o  for  both  RSTS
 and  RSX.   Any  executable  RSTS  file (*.TSK, *.BAC and *.SAV)
 copied will not be useable until it's run time system  name  and
 protection code is reset.
  
                Kermit-11> COPY
                From: ABCDEF.DAT
                To  : FUBAR.LST
  
        or
  
                Kermit-11> COPY ABCDEF.DAT FUBAR.LST
  

1 DELETE

 The DELETE command will delete the specified file or file  group
 from the system.  Wildcards are permitted.
  
                Kermit-11>DELETE FUBAR.MAC
                Kermit-11>DELETE FUBAR.*
  

1 DIRECT

 The DIRECT command will display the  current  default  directory
 when used in the format:
  
                Kermit-11>DIRECT
  
 If a directory other  than  the  current  default  directory  is
 desired then DIRECT may be used in the format:
  
                Kermit-11>DIRECT file-specification
  
 where 'file-specification'  is  any  legitimate  combination  of
 device  name,  uic or ppn, and a filename which can include wild
 carding characters.

1 DISCONNECT

 The DISCONNECT command cuases Kermit-11 to  'hang-up'  the  line
 which was specified with the SET LINE command and connected with
 the CONNECT command.  The format is:
  
                Kermit-11>DISCONNECT
  

1 ERASE

 The ERASE command will ERASE the specified file  or  file  group
 from the system.  Wildcards are permitted.
  
                Kermit-11>ERASE FUBAR.MAC
                Kermit-11>ERASE FUBAR.*
  
 The ERASE command is identical to the DELETE command.

1 EXIT

 The EXIT command will cause kermit  to  return  to  the  command
 level.   This  command  is  the  same  as the QUIT command.  The
 format is:
  
                Kermit-11>EXIT
  

1 FINISH

 The FINISH command will tell Kermit-11 ,which is in local  mode,
 to  signal  the  other  kermit  to  exit from server mode.  When
 Kermit-11 has received acknowledgement that this is  being  done
 it will prompt for another command.  The command format is:
  
                Kermit-11>FINISH
  

1 GET

 The GET command tells the remote kermit which is in server  mode
 to  get  a  file or group of files.  The format for this command
 is:
  
  
                Kermit-11>GET file-specification
  
 where 'file-specification' may include any legitimate device,ppn
 or  uic  as  well as the file specification.  Wildcarding may be
 used in the file-spec.  to obtain a group of files.

1 HANGUP

 The HANGUP command will drop the remote line  specified  by  the
 SET LINE command and connected by the CONNECT command.  The same
 function is performed by the DISCONNECT command.  The format  of
 the HANGUP command is:
  
                Kermit-11>HANGUP
  

1 HELP

 As of this version (Version 1) of  Kermit-11  the  HELP  command
 simply  prints  a list of all available commands in their proper
 format.  The format of the HELP command is:
  
                Kermit-11>HELP
  

1 LOCAL

 The LOCAL command can be used to prefix any  kermit  command  to
 insure  that  the command so prefixed will be carried out by the
 user's own kermit.  All commands are local by default  with  the
 exceptions of BYE, FINISH,and GET.  The LOCAL command format is:
  
                Kermit-11>LOCAL kermit command name
  

1 QUIT

 The QUIT command will cause Kermit-11 to return to  the  command
 level.   This  command  is  the  same  as the EXIT command.  The
 format is:
  
                Kermit-11>QUIT
  

1 RECEIVE

 The RECEIVE command will put Kermit-11 into remote mode to  wait
 for a single file transfer transaction.  Kermit-11 will wait for
 a file transfer initialization  from  the  other  kermit.   This
 command  is  useful  if  the other kermit does not support local
 server commands.  Command format is:
  
                Kermit-11>RECEIVE
  
 Please note that this version of Kermit-11 (Version 1) does  NOT
 support the RECEIVE Command in the format:
  
                Kermit-11>RECEIVE filename
  

1 REMOTE

 The REMOTE command is used as a prefix to indicate to  Kermit-11
 that  the  command  so  prefixed  is to be executed by the other
 (remote) kermit server.  Command format:
  
                Kermit-11>REMOTE
  
 will return a prompt requesting a command name:
  
                Remote Kermit cmd ?
  
 REMOTE can also be used with a command name as an argument:
  
                Kermit-11>REMOTE command name
  
 Please see HELP REMOTE command name for details.

2 BYE

 The REMOTE BYE command will cause Kermit-11 (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-11  receives the acknowledgement
 that this is being done, it will  prompt  for  another  command.
 The  DISCONNECT  command  should  always  follow.   This command
 (REMOTE BYE) is the same as the BYE command.  The command format
 is:
  
                Kermit-11>REMOTE BYE
  
 or
  
                Kermit-11>REMOTE 
                Remote Kermit cmd ?BYE
  

2 COPY

 The remote copy is just like the local copy command in  that  it
 creates a copy of the input file.  Like the local Kermit-11 COPY
 command it does NOT support wildcards in the filename, and while
 COPY  does use multiblock buffering it is usually more efficient
 to use the system utilty PIP or the DCL command COPY  for  this.
 COPY  uses  RMS block i/o for both RSTS and RSX.  Any executable
 RSTS file (*.TSK, *.BAC and *.SAV) copied will  not  be  useable
 until it's run time system name and protection code is reset.
  
                Kermit-11>REMOTE COPY
                From: ABCDEF.DAT
                To  : FUBAR.LST
  
        or
  
                Kermit-11>REMOTE COPY ABCDEF.DAT FUBAR.LST
  

2 DIRECT

 The remote DIRECT command will tell the remote Kermit server  to
 send  a  directory  listing over the connection.  Not all Kermit
 servers have this implemented.
  
                Kermit-11>REM DIR *.MAC
  
 The above example would tell the remote server to send a  direc-
 tory listing of all files ending with a .MAC filetype.

2 ERASE

 The remote ERASE command will tell the remote Kermit  server  to
 delete   any   files  matching  the  filespecification.   For  a
 Kermit-11 server, this can include wilcard characters.
  
                Kermit-11>REM ERASE *.MAC
  
                Files deleted:
                SY:[2,2]FUBAR.MAC
                SY:[2,2]HLPSUB.MAC
  
                Kermit-11>
  
 The remote Kermit server may respond with the filenames deleted,
 the above example is what a Kermit-11 server would respond with.

2 FINISH

 The REMOTE FINISH command will tell  Kermit-11  ,  which  is  in
 local mode, to signal the other kermit to exit from server mode.
 When Kermit-11 has received acknowledgement that this  is  being
 done  it  will prompt for another command.  REMOTE FINISH is the
 same as the FINISH command.  The command format is:
  
                Kermit-11>REMOTE FINISH
  
 or
                Kermit-11>REMOTE
                Remote Kermit cmd ?FINISH
  

2 GET

 The REMOTE GET command tells  the  remote  kermit  which  is  in
 server  mode to get a file or group of files.  REMOTE GET is the
 same as the GET command.  The format for this command is:
  
                Kermit-11>REMOTE GET
  
 or
  
                Kermit-11>REMOTE
                Remote Kermit cmd ?GET
  

2 HELP

 The REMOTE HELP command instructs a remote Kermit server to send
 a list of remote commands that it can process.

2 RENAME

 The remote RENAME command is used to rename a  file  or  set  of
 files.  RENAME is used with two arguments in the format:
  
                Kermit-11>REMOTE RENAME oldname newname
  
 If the remote RENAME is used with one or  no  argument  it  will
 prompt for missing arguments:
                Kermit-11>REMOTE RENAME
                From: oldname
                To:   newname
  
 When the remote RENAME is finished the remote Kermit server will
 most  likely return either a list of files renamed or a count of
 the number of files renamed.  For  a  Kermit-11  server  running
 remotely you would get a count of the number of files renamed.
  
                Kermit-11>REMOTE RENAME t.* junk
                Remote ack: 3 files renamed
  

2 SPACE

 The REMOTE SPACE command sends a generic command to  the  remote
 kermit  requesting information about the amounts of space avail-
 able and space used on the remote host.  Command format is:
  
                Kermit-11>REMOTE SPACE
  
 or
  
                Kermit-11>REMOTE
                Kermit Remote cmd ?SPACE
  

2 TYPE

 The REMOTE TYPE command is just like the  TYPE  command  but  it
 tells a remote Kermit server to get the file to be typed on your
 terminal and send it over.
  
                Kermit-11>REMOTE TYPE FUBAR.MAC
  

2 WHO

 The REMOTE WHO command instructs a remote Kermit server to  send
 a  listing  of  who's logged into the system.  This is currently
 only operational for Kermit server running under RSTS/E.  Please
 note that this command may be restricted by the system manager.
  
                Kermit-11>REMOTE WHO
  

1 RENAME

 The RENAME command is  used  to  rename  a  local  (only)  file.
 RENAME can be used with two arguments is the format:
  
                Kermit-11>RENAME oldname newname
  
 If RENAME is used with one or no argument  it  will  prompt  for
 missing arguments:
                Kermit-11>RENAME
                From: oldname
                To:   newname
  
 When RENAME is finished it will return a 'report' of what it has
 done:
  
                Kermit-11>RENAME t.* junk
                File DB0:[1,8]T.T1 renamed to DB0:[1,8]JUNK.T1
                File DB0:[1,8]T.T renamed to DB0:[1,8]JUNK.T
  

1 SEND

 The SEND command will allow the user to send a  file(s)  to  the
 other  kermit.   If Kermit-11 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 to the other kermit  and  issue  a
 receive  command.   If  Kermit-11 is running in local mode , the
 file will be sent immediately on the terminal line specified  by
 the set line command.  Format of the SEND command is:
  
                Kermit-11>SEND file-specification
  
 Where 'file-specification' can include device,ppn or uic,as well
 as the file-spec.  which may use wildcarding.

1 SERVER

 The SERVER command will put Kermit-11 into  server  mode.   When
 Kermit-11  is  in  server mode while runnuing as a remote kermit
 (transmitting over the  controlling  terminal  line)  the  other
 kermit  can  issue  server  commands  to  send and receive files
 without having to give SEND or RECEIVE  commands  to  Kermit-11.
 In  order to correctly receive binary files while in server mode
 a SET FILETYPE BINARY must be done first.  At this time there is
 no  way  for Kermit-11 to determine whether an incomming file is
 ascii or binary.  Command format is:
  
                Kermit-11>SERVER
  

1 SET

 The SET command is used to set  various  parameters  in  kermit.
 The format of the SET command is:
  
                Kermit-11>SET parameter keyword
  

2 BLOCK-CHECK

 The SET BLOCKCHECK command is used to determine the 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-32 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.  The command  should  be
 given  to BOTH Kermits since Kermit-11, when in server mode, has
 no say about what kind of checksum it wants to use.  (See Kermit
 protocol manual for more information.)
  
            Kermit-11>SET BLOCK_CHECK keyword
  
 Where keyword is one of:
  
          1_CHARACTER_CHECKSUM or ONE_CHARACTER_CHECKSUM
  
          2_CHARACTER_CHECKSUM or TWO_CHARACTER_CHECKSUM
  
          3_CHARACTER_CRC_CCITT or THREE_CHARACTER_CRC_CCITT
  

2 DEBUG

 The SET DEBUG command is used to specify the type and  level  of
 debugging  to  a  disk  file  .   This  disk file must have been
 created by the SET LOGFILE command.  The format  for  SET  DEBUG
 is:
  
                Kermit-11>SET DEBUG qualifier
  

3 ALL

 SET    DEBUG    ALL     will     turn     on     logging     for
 CONSOLE,CONNECT,FILE,PACKET and STATE to the disk file specified
 by SET LOGFILE.  This commamd is the same as SET DEBUG ON.   The
 command format is:
  
                Kermit-11>SET DEBUG ALL
  

3 CONSOLE

 SET DEBUG CONSOLE will turn on logging  for  all  i/o  during  a
 remote  connect to the disk file specified by SET LOGFILE.  This
 command is the same as SET DEBUG CONNECT.   The  command  format
 is:
  
                Kermit-11>SET DEBUG CONSOLE
  

3 CONNECT

 SET DEBUG CONNECT will turn on logging  for  all  i/o  during  a
 remote  connect to the disk file specified by SET LOGFILE.  This
 command is the same as SET DEBUG CONSOLE.   The  command  format
 is:
  
                Kermit-11>SET DEBUG CONNECT
  

3 FILE

 SET DEBUG FILE will log all file 'opens' and  'creates'  to  the
 file specified by SET LOGFILE.  The command format is:
  
                Kermit-11>SET DEBUG FILE
  

3 HELP

 SET DEBUG HELP gives the user a list of all qualifiers which can
 be used with SET DEBUG.  Command format is:
  
                Kermit-11>SET DEBUG HELP
  

3 NONE

 SET DEBUG NONE 'turns off' all debugging.  This is the  same  as
 the SET DEBUG OFF command.  Command format is:
  
                Kermit-11>SET DEBUG NONE
  

3 OFF

 SET DEBUG OFF 'turns off' all debugging.  This is  the  same  as
 the SET DEBUG NONE command.  Command format is:
  
                Kermit-11>SET DEBUG OFF
  

3 ON

 SET     DEBUG     ON     will'turn     on'      logging      for
 CONSOLE,CONNECT,FILE,PACKET and STATE to the disk file specified
 by SET LOGFILE.  This commamd is the same as SET DEBUG ALL.  The
 command format is:
  
                Kermit-11>SET DEBUG ON
  

3 PACKET

 SET DEBUG PACKET will 'turn  on'  logging  of  all  receive  and
 transmit packets to the disk file specified by SET LOGFILE.  The
 command format is:
  
                Kermit-11>SET DEBUG PACKET
  

3 STATE

 SET DEBUG STATE will turn on logging of all  internal  Kermit-11
 state transitions 

2 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-11 is running in remote mode to allow the  user  time  to
 escape back to the other Kermit and give a RECEIVE command.
  
            Kermit-11>SET DELAY number-of-seconds
  
 Where number of seconds is the (decimal)  number  of  second  to
 wait before sending data.

2 DEFAULT

 The DEFAULT parameter allows you to specify a device and UIC (or
 PPN)  for  all  subsequent  file  opens  (for  SENDING) and file
 creates (for RECEIVING).  It is disabled by typing SET HOME.
  
                Kermit-11>SET DEFAULT device
  

2 END-OF-LINE

 The END-OF-LINE parameter sets the ascii character which will be
 used  as  a  line  terminator  for all packets SENT to the other
 KERMIT.  This is  normally  not  needed  for  most  versions  of
 KERMIT.
  
                Kermit-11>SET END-OF-LINE octal value of
  character
  

2 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-32 after using the
 CONNECT command.  It defaults to  control \ (octal  34).   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-11 is CONNECTing.
  
            Kermit-11>SET ESCAPE octal-character-value
  
 Where octal-character-value is the ASCII value of the  character
 to use as the escape character (in octal).

2 FILETYPE

 This command will set the file type that Kermit is receiving.  A
 file  type  of  ASCII should be used to receive text files which
 are to be used as text files on the PDP11 system.  The file type
 BINARY should be used for binary files, such as CP/M .COM files,
 which need to be kept in a format that allows  the  file  to  be
 returned without any changes.
  
            Kermit-11>SET FILE_TYPE type
  
3 ASCII

 File type ASCII is for text files.

3 BINARY

 File type BINARY is for non-text files.  Note that binary  files
 which  are  generated on a PDP11 system cannot be transferred to
 another PDP11 system without losing file attributes.  This means
 that  (for example), an RSM11 indexed file cannot be transmitted
 with Kermit-11.

2 HANGUP

 SET HANGUP is the same as the DISCONNECT command.  It  forces  a
 connected  line  (specified  via  the  SET  LINE  command) to be
 dropped.  This is currently only supported for RSTS version 8.
  
                Kermit-11>SET HANGUP
  

2 HOME

 SET HOME resets the default device and UIC (or PPN) to  nothing,
 ie,  all  file opens and creates use your default disk (SY:) and
 your UIC (or PPN).
  
                Kermit-11>SET HOME
  

2 IBMMODE

  
                IBM mode has not yet been implemented
  

2 LINE

 The SET LINE command sets the terminal name up for use with  the
 connect  command.   To  use  this  you  must have access to that
 device.  On many systems terminal lines other than your own  are
 protected  from  access,  and  may require special procedures to
 access them.
 The form of the device name is TTnnn:, where 'nnn' is a  decimal
 number for RSTS and an octal number for RSX11M/M+.
  
                Kermit-11>SET LINE TT55:
  

2 LOGFILE

 The SET LOGFILE command creates a debug dump file for  you.   It
 must  be  used  BEFORE  any SET DEBUG commands can be used.  See
 HELP DEBUG for further information about debugging modes.
  
                Kermit-11>SET LOGFILE MYLOG.TXT
                Created debug file MYLOG.TXT
                Kermit-11>
  

2 PACKET-LENGTH

 You can alter the default transmitted packet length with the SET
 PACKET-LENGTH  command.   This  should  not  normally  be needed
 unless the line is very noisy, at which time you should probably
 give up anyway.
  
                Kermit-11>SET PACKET 60
  

2 PARITY

 This is used with the SET LINE and CONNECT commands  to  specify
 the type of parity for the remote link.  It defaults to NONE and
 can be either ODD or EVEN, as in:
  
                Kermit-11>SET PARITY NONE
                Kermit-11>SET PARITY ODD
                Kermit-11>SET PARITY EVEN
  
 If you choose ODD or EVEN, you will be  unable  to  send  BINARY
 files using Kermit-11 (at this time, version 1).
 This is currently available only for Kermit on  RSTS  (25-Jan-84
 15:11:01)

2 PAUSE

 PAUSE tells Kermit to  wait  the  specified  number  of  seconds
 between each packet being sent to the other Kermit.  This may be
 useful under situations of  heavy  system  load.   This  may  be
 automatically  computer  by  Kermit-11  in a future release as a
 function of line speed.
  
                Kermit-11>SET PAUSE 1
  

2 RECORD-FORMAT

 Kermit will, by default, create RMS11  variable  length  implied
 carriage  control records for text files.  You can override this
 and change it to  create  stream  ascii  records  with  the  SET
 RECORD-FORMAT STREAM command.  This is useful for RSTS/E systems
 if you need file compatibility with BASIC Plus.
  
                Kermit-11>SET RECORD-FORMAT STREAM
                Kermit-11>SET RECORD-FORMAT VARIABLE
  
 This command would be most useful in a KERMIT.INI file, which is
 executed by KERMIT when Kermit starts.

2 RETRY

 SET RETRY value tells Kermit to try that many times on a  NAK'ed
 packet before giving up.  This should only be needed if the line
 is extremely noisy or the PDP11 host is running very slowly  due
 to the system load.
  
                Kermit-11>SET RETRY 10
  

2 SPEED

 SET SPEED value sets the line speed for the device specified via
 the  SET  LINE  command,  and  used  for  the  CONNECT  command.
 Changing the speed of a terminal  line  requires  privilege  for
 RSTS and RSX11M/M+.
  
                Kermit-11>SET SPEED 1200
  
 1200 Baud would be a normal speed to use with  a  VA212LS  or  a
 DF03.

2 TIMEOUT

 The timeout value tells Kermit how long to wait to get a  packet
 from  the  other  Kermit.   If  system loads are high, it may be
 desirable to increase this beyond the default of 10 seconds.

1 SHOW

 The SHOW command will display  the  settings  made  by  the  SET
 command and allow you to look at session statistics.
  
                Kermit-11>SHOW parameter
  
2 ALL
 Displays everything:   BLOCK-CHECK     DEBUG           DEFAULT 
  ESCAPE
                        FILE-TYPE       LINE            PACKET  
  PARAM
                        TIME            VERSION
  
2 BLOCK-CHECK-TYPE

 Displays the current type of checksum set.

2 DEBUG

 Shows the status of debugging.

2 DEFAULT

 Shows the device and UIC (or PPN) used for file operations.

2 ESCAPE

 Shows the escape character used to return to a local Kermit-11

2 FILE-TYPE

 Shows the current filetype (BINARY or ASCII)

2 LINE

 Displays parameters associated with the current connect line.

2 PACKET

 Prints out packets statistics  from  the  last  transaction  and
 total so far.

2 PARAMETERS

 Prints out various send parameters
2 RECORD-FORMAT

 Shows what kind of file will be created by Kermit.

2 TIME

 The time of day

2 VERSION

 My current version and edit.

1 STARTUP

 You can place a file called KERMIT.INI in your account and  have
 Kermit-11  automatically  read  commands  from it before getting
 commands from your terminal.

1 SYSTEM

 The SYSTEM command takes a CCL/MCR/DCL command line and spawns a
 task  to  execute it.  This is done via the SPWN$S directive for
 RSX and by spawning a job on a psuedo kerboard for RSTS.  If the
 command  fails  for RSTS then Kermits protection code was set to
 run without privileges.
  
                Kermit-11>SYS PIP DB1:=FUBAR.DAT
                Kermit-11>SYS
                Command: SUB MYJOB
                Kermit-11>
  

1 TAKE

 The Take command is just like the  command.  It opens a disk file
 for reading commands from, as in TAKE filename.
  
                Kermit-11>TAKE MYKERM.CMD
  
1 TYPE

 The TYPE command prints a file to your terminal, as in:
  
                Kermit-11>TYPE KERMIT.INI
  

1 WHO

 The WHO command (currently  for  RSTS/E  only)  prints  a  brief
 SYSTAT out.

