





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 BINARY FILES

  Binary files are those files which require all  eight  bits  in
 each character.  Text files, like program source files, compiler
 listing and runoff files, normally use only the low  seven  bits
 in  each  character.   Binary  files  include  task images, save
 images, RMS relative and indexed files and other  special  types
 of files.
  In order for Kermit to transfer these files Kermit-11 needs  an
 eight  bit  line,  which for most PDP-11 systems is the default.
 Additionally, most Kermits need to be set into a binary mode  to
 transfer such files.  The command to do this is usually the 'SET
 FILETYPE BINARY' command, or 'SET FIL  BIN'  for  short.   Since
 various  Kermit  implementations  are  at  different  stages  of
 developement, most Kermit links  can  NOT  handle  binary  files
 automatically,  thus the above SET command must be given to BOTH
 Kermits prior to a binary file transfer.  One important note  is
 that  the  VMS  Kermit-32 requires a SET FIL TYP FIX to properly
 send  and  receive  binary  files.   For  example,  a  Kermit-11
 connected to a VMS system as a local Kermit would first log onto
 the VAX and invoke Kermit-32 and give the commands SET  FIL  TYP
 FIX  and  SER.   Then  one  would  escape  back to the Kermit-11
 (control c) and give Kermit-11 the command SET FIL BIN  (or  the
 same, SET FIL TYP FIX).  At this point the Kermit-11 can use the
 GET and SEND commands to transfer binary files like task  images
 and save images.
  As a side note,  there  may  be  cases  where  the  proper  SET
 commands  have  been given but the binary file does not transfer
 correctly.  This has been noted on VMS  when  a  task  image  is
 copied  from tape via FLX to disk and then sent over to a PDP-11
 using Kermit.  The file was found to  contain  carriage  control
 after  it  was  sent  to  the PDP-11.  This was because when FLX
 created it on the VAX, the  file  was  created  with  fixed  512
 records  with  carriage return control.  VMS Kermit honored this
 and sent a CRLF every 512 bytes.
  Please note that transfering text files when one or both of the
 Kermits  are  set  to binary mode can result in an unusable file
 after transfer because of the possibility of transfering  imbed-
 ded record control information.

  Version 2.16 (and later versions) of Kermit-11, however, can do
 the switch into binary mode automatically if the file attributes
 (and protection code for RSTS/E) indicate that the file is  most
 likely  a  binary file.  Additionally, two Kermit-11's connected
 to each other will both do the 'right' thing if this is the case
 by  the  sending  Kermit-11  telling  the receiving Kermit-11 to
 switch to binary mode.  In this case, the sending Kermit-11 will
 also  send  a  copy of the file attributes over so the receiving
 Kermit-11 can properly set this when the file is  closed.   Thus
 two  Kermit-11's  connected  to each other can send task images,
 RMS indexed files and so on.

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 COMMAND-LINE

 Kermit, if the task is installed on RSX11M/N+ or has a CCL  name
 for  it  for  RSTS/E,  will  get  that  command  and  execute it
 immediatley.  For all command other  than  SERVER,  Kermit  will
 exit  upon completion of the command.  In the case of the SERVER
 command, Kermit will return to interactive  mode  if  the  local
 Kermit sends it a FINISH command.
  
                > KERMIT SERVER
                $ KERMIT HELP
  
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
  
 The distributed RSX11M/M+ task has been  built  with  the  /PR:0
 switch  to  enable  the  task to change other terminal settings.
 Addtionally, for RSX11M/M+, the  MCR  command  SET  /SLAVE=TTnn:
 should be done before entering Kermit-11.

 If you are running K11POS.TSK on a PRO/350, Kermit will set  the
 line to XK0:  and the speed to 9600 by default.

 Please note that Kermit-11 CAN NOT change the speed  of  a  DL11
 type  interface,  nor can it change the speed of a PDT-150 modem
 port (use SPEED.SAV).

 The following is an example of using a Racal-Vadic  VA212  auto-
 dialing  modem  to  log into a remote TOPS-20 system.  There are
 two points at which there is no echoing of the user input.   The
 first  is  the  typing  of  a control-E <cr> sequence to get the
 attention of the modem, which responds  by  sending  the  string
 'HELLO:I'M  READY'.   The  second  is  the  typing  of the local
 'escape sequence', which by default is control \ followed  by  a
 'c'.   The  control backslash informs the terminal emulator that
 the next character is a command.  In this case, the command  was
 'C',  which means to return to the local PDP-11 system.  Control
 \ ?  would print a help message.  
  
  
        $ kermit
        Kermit-11 V2.13
        Kermit-11>set logfile 20.log
        Kermit-11>set deb console
        Kermit-11>set lin tt58:
        Link device set to TT58:
        Kermit-11>set spe 1200
        Kermit-11>con
        Connecting to TT58:
        
        HELLO:I'M READY
        *d
        NUMBER? 
        3
        9-1-212-123-4567
        9-1-212-123-4567
        
        DIALING...
        ANSWER TONE
        ON LINE 
        
        enter class 4
        class 004 start
        
        CU20B
        @log xx.abcdef 
         CU20B, TOPS-20 Monitor 5.1(5101)-2
         Job 28, TTY32, 2-Apr-84 4:15:24PM
         Previous login was 2-Apr-84 4:10:16PM
                .
                .
                .
                .
        @log
        [Confirm]
        Logged out Job 28, User XX.ABCDEF , TTY 32,
          at  2-Apr-84 16:19:34,  Used 0:00:11 in 0:04:10
        
        Kermit-11>disc
        KERMIT link TT58: disconnected
        Kermit-11>exit
        
        $ logout
  
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 CWD

 The CWD command alters the current device and UIC (ppn) default.
 Thus, the command 'CWD [200,200]' would cause all following file
 operations to insert the string  [200,200]  unless  an  explicit
 directory  name  was  given.   This  is identical to the SET DEF
 command.  Passwords are ignored.

1 DECNET

 Kermit-11 can access DECNET files if  built  with  DAP  support.
 This is included in the task images K11NRS.TSK and K11RSX.TSK as
 distributed.  DECNET support has been tested  for  RSX11M.   See
 SET DEFAULT for more information.

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 DIAL

 The DIAL command will take the number specified and  attempt  to
 get  the attached modem to dial the phone number.  The SET MODEM
 command must have be used first, except in the case of  PRO/TMS.
 Additionally, if no line has been set, the SET LINE command must
 be used.  Note that  for  the  PRO/350,  an  implicit  set  line
 command is done at startup for XK:  or XC:.
 Once a connection is made, you will be returned to the Kermit-11
 command  line  prompt,  at  which  time  you can use the CONNECT
 command to attach to the remote system.

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 DISPLAY

 The Display command will  format  and  print  global  read/write
 data, defined in K11MAC.MAC, to the terminal, as in:
  
                Kermit-11>DISP PROMPT
  

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.  This
 command presumes that the modem cable has the DTR line (pin  20)
 connected.   The  same  function  is performed by the DISCONNECT
 command.  The format of the HANGUP command is:
  
                Kermit-11>HANGUP
  

1 HELP-FILE

 The Kermit-11  help  file  (this  file)  should  be  located  as
 follows:
  
        For RSTS/E, RSX11M/M+
  
                LB:[1,2]K11HLP.HLP      or
                SY:[1,2]K11HLP.HLP      or
                KERMIT:K11HLP.HLP       or
                HELP:K11HLP.HLP
        
        For RT11
  
                DK:K11HLP.HLP           or
                SY:K11HLP.HLP
  
        For P/OS on the PRO/350
  
                [001002]K11HLP.HLP
  

1 HOST

 The HOST command is identical to the SYSTEM command in  that  it
 takes the command and spawns a process to execute the command.
  
                Kermit-11>HOST SHO TER 
  
                Current settings for KB6:
                Broadcast   CRFill=0    NoEcho      NoHostSync
                Lowercase   NoParity    NoScope     Speed not
  settable
                Tab         NoTTSync    Width=80
  
                Kermit-11>
  

1 INTRODUCTION

 The KERMIT file transfer protocol is  intended  for  use  in  an
 environment where there may be a diverse mixture of computers --
 micros, personal computers, workstations, laboratory  computers,
 timesharing  systems  --  from  a variety of manufacturers.  All
 these systems need have in common is the ability to  communicate
 in ASCII over ordinary serial telecommunication lines.

 KERMIT was originally designed at Columbia  University  to  meet
 the  need  for  file  transfer  between our DECSYSTEM-20 and IBM
 370-series mainframes and various microcomputers.  It turned out
 that the diverse characteristics of these three kinds of systems
 resulted in a design that was general enough to fit  almost  any
 system.   The  IBM mainframe, in particular, strains most common
 assumptions about how computers communicate.

 The   KERMIT   protocol    is    specifically    designed    for
 character-oriented  transmission  over  serial telecommunication
 lines.  The design allows for the restrictions and peculiarities
 of the medium and the requirements of diverse operating environ-
 ments -- buffering, duplex, parity, character set, file  organi-
 zation,  etc.  The protocol is carried out by KERMIT programs on
 each end of the serial connection  sending  "packets"  back  and
 forth;   the sender sends file names, file contents, and control
 information;    the   receiver   acknowledges   (positively   or
 negatively) each packet.

 The packets have a layered design, in keeping with the ANSI  and
 ISO  philosophies,  with  the  outermost fields used by the data
 link layer to verify data integrity, the  next  by  the  session
 layer  to verify continuity, and the data itself at the applica-
 tion level.

 Connections between systems  are  established  by  the  ordinary
 user.    In   a   typical  case,  the  user  runs  KERMIT  on  a
 microcomputer, enters terminal emulation, connects to  a  remote
 host  computer  (perhaps by dialing up), logs in, runs KERMIT on
 the remote host, and then issues  commands  to  that  KERMIT  to
 start  a  file transfer, "escapes" back to the micro, and issues
 commands to that KERMIT to start its side of the file  transfer.
 Files may be transferred singly or in groups.

 Basic KERMIT provides only file transfer, and that  is  provided
 for sequential files only, though the protocol attempts to allow
 for various types of sequential files.  Microcomputer  implemen-
 tations  of  KERMIT are also expected to provide terminal emula-
 tion, to facilitate the initial connection.

 More advanced implementations simplify the user interface  some-
 what  by  allowing  the  KERMIT  on  the remote host to run as a
 "server", which can transfer  files  in  either  direction  upon
 command  from  the  local  "user"  Kermit.   The server can also
 provide  additional  functionality,  such  as  file  management,
 messages,  mail,  and  so  forth.   Other optional features also
 exist, including a variety of block check types, a mechanism for
 passing  8-bit data through a 7-bit communication link, a way to
 compressing a repeated sequence of characters, and so forth.

 As local area networks become  more  popular,  inexpensive,  and
 standardized,  the  demand  for KERMIT and similar protocols may
 dwindle, but will never wither away entirely.  Unlike  hardwired
 networks,  KERMIT gives the ordinary user the power to establish
 reliable error-free connections between any two computers;  this
 may always be necessary for one-shot or long-haul connections.

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 LOGFILE

 The LOGFILE command creates the debug and session logging  file.
 It is identical to the SET LOGFILE command.
  
                Kermit-11>LOGFILE FUBAR.LOG
  

1 Modems

 The question of how to set one's modem (if  applicable)  depends
 on  a number of factors.  For this discusion, we will be limited
 to considerations under RSTS/E (and to a limited degree, RSX and
 P/OS).   This  discussion  is  relavent  to  dialing out from an
 attached line.  Please note that the following comments will not
 be applicable to all types of modems.
2 RSTS/E

 RSTS/E does not control modems signals in the manner that RSX or
 VMS does.  VMS always asserts DTR whereas RSTS/E will not assert
 DTR until the terminal driver can see RCD (also  known  as  DCD)
 which  is  pin  8  (eight)  for  the  RS232  connection.  If the
 interface is a DH11 with full modem control, a  cable  with  all
 signals  connected will work fine.  However, if the interface is
 a DZ11 we have the problem that the DZ has  only  partial  modem
 control.   To  connect  directly  to  a modem (like a VADIC 212,
 sorry, no DEC modems here) we must do one of two things:

 (1) Force the modem  (via  strapping  options  or  whatever)  to
 assert  RCD  (DCD) pin 8, thus RSTS/E will see carrier and raise
 DTR (pin 20 for RS232)

 (2) Set the  terminal  to  LOCAL  (RSTS/E  V9  syntax  'SET  TER
 TTxx:/NODIAL/PERM') and break pin 20 (DTR) and connect pin 20 to
 8 on the modem side.  This will cause the modem to  be  able  to
 dial  out and allow RSTS/E to connect to it.  You will also need
 to have the modem assert RCD, pin 8.   Keep  in  mind  that  the
 Kermit-11  command DISCONNECT (or HANGUP) will not function if a
 line is set to NODIAL (INIT SET syntax 'LOCAL').  This has  been
 tested on a Racal Vadic VA212.

 For those of you who have port  switches  such  as  the  Gandalf
 type, there is one additional problem.
 For Gandalf, suppose you want to connect a DZ11 line  to  to  an
 AMTB2.  You will have a problem, in that the Gandalf AMTB2 wants
 to see RCD (DCD) asserted to make a connection.   What  you  may
 need to do is this:
  
        Make a cable for the DZ11 to AMTB2 port as follows:
  
        CPU side                        AMTB2 side
                        20--|
                        8---|-----------8
                        7---------------7
                        3---------------2
                        2---------------3
  
        Note that 20 is tied to 8 on the CPU side.
        Also, 2 is swapped for 3.
  
 Then, the Kermit-11 command SET DTR, which forces RSTS to  raise
 DTR  for  30  seconds, will cause the DTR signal to loop back to
 the RCD (DCD) signal and thus tell RSTS that  there  is  carrier
 detect  which  will  raise DTR (the chicken or egg question) and
 get  things  rolling.   The  Kermit-11  HANGUP  (or  DISCONNECT)
 command  will  drop DTR and force the modem to break the connec-
 tion.  
2 P/OS (Pro 3xx)

 Under P/OS the author has used (1) a DLV11 line in the 11/23+ at
 home  at  9600  baud without any modem signals, (2) a link using
 only 2,3 and 7 to a Racal Vadic 3212 (not an autodialer) and (3)
 a  Gandalf  LDS125  modem.  In all cases there were no problems.
 It would seem that the PRO/350 comm port does not need the modem
 signals.   This  will,  of  course,  mean  that  the  HANGUP (or
 DISCONNECT) commands will NOT function since DTR  is  not  being
 passed.  Please note that you must ensure that pins 2 and 3 (RXD
 and TXD) are swapped if you are not using  some  type  of  modem
 (one of the things a NULL modem cable does ).

2 RSX11M/M+

 The setting of the connected line (SET LINE  TTnn:)  depends  on
 the  signals  that  the  modem can assert (see HELP MODEM RSTS).
 Since the author does not run RSX on a system with  modem  lines
 (the  system  is  an  11/23+,  DLV11 lines), the command SET RSX
 TC.DLU value has been added (though untested).  This command can
 be  used  to set the TC.DLU parameter to 1 or 2.  A value of one
 (1) (SET RSX TC 1) is normal for remote lines, indeed, it is the
 result  of the MCR command SET/REMOTE=TTnn:.  However, it may be
 the case that TC.DLU needs to be set to two (2) (SET RSX  TC.DLU
 2).   If  this  SET command is used, Kermit-11 will alter it (if
 different from the current setting) and wait  five  (5)  seconds
 for  the change to come into effect.  This is only applicable to
 modem controlled lines.  There is  no  way  (at  this  time)  to
 change  the  TC.DLU  setting  to  two  via  MCR  or DCL commands
 (perhaps we need a SET/DIALOUT=TTnn:).

 For more information, please consult K11USR.DOC

1 MicroRSX

 Operation under MicroRSX is identical to that under RSX11M+ and,
 for  the most part, P/OS.  The image K11POS.TSK is used, as this
 image is linked to the resident library  RMSRES,  thus  allowing
 access to named directories under MicroRSX.

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 PARITY

 Sometimes two Kermit's may appear  to  be  sending  the  correct
 packets  but one or the other of them will constantly reject the
 same packet.  This usually will  be  seen  when  the  requesting
 Kermit  asks  a  server for a file and then rejects the server's
 first packet, doing so until the  retry  threshold  is  reached.
 This  can  often be caused by parity being introduced somewhere,
 and one or both of the Kermit's do  not  know  this.   This  can
 happen  when  a  modem is generating parity or when a private or
 public network is doing so.  Some Kermit's  have  a  SET  PARITY
 command  to  assist  in  this.   If  the  communications link is
 introducing parity, a simle fix  is  to  tell  each  Kermit  the
 command SET PARITY SPACE.  This will force the Kermit program to
 always remove bit 7 from the incoming data.  Normally this  will
 not  affect  file  transfer  since  many  Kermit implementations
 support what is called eight bit prefixing, which is a method of
 encoding  an  eight  bit data item to fit over a seven bit link.
 See HELP SET PARITY for more information.  

1 PRINT

 The PRINT command will cause the specified file(s) to be printed
 on  the  system  line printer.  This command may not function on
 all systems.

1 PRO/350

2 RT11 version 5.1

 Kermit-11 runs under the RT11 version 5.1 XM  monitor  by  using
 the  DIGITAL  distributed  XC  handler.  The XC handler supports
 several useful functions such as start/stop break, variable size
 reads  and  driver/line  reset.   Due  to an apparent bug in the
 driver, Kermit has to use flow control (XON/XOFF) to control the
 sending  Kermit  at  high  speeds  (9600  baud).   This  has the
 undesireable effect of slowing the transfer  down  by  about  15
 percent.  This is enabled by typing SET RTFLOW ON.
 As an alternative, the XC handler can be modified to  avoid  all
 problems  with buffer overflows by increasing the buffer size in
 XL.MAC.  See the file K11PRT.MAC for information regarding this.

 Note the the XC handler does not accept .SPFUN calls  to  change
 the  baud  rate,  rather,  you  must  set  it  prior to entering
 Kermit-11  as  in  SET  XC:SPEED=9600.   The  Kermit  disconnect
 command  will  not function.  Kermit will always fake a SET LINE
 XC0:  at startup on  the  PRO/350.   Unlike  the  standard  RT11
 Kermit-11,  you  DO NOT need to use the SET RTFLOW ON command to
 enforce flow control during the CONNECT command.  The XC  driver
 handles this automatically for you.
 To send a BREAK while in connect mode, type  your  local  escape
 character (normally a CTRL \) followed by a B.

2 P/OS version 2.0

 Kermit-11 will run on under P/OS on the Pro/350, the  executable
 file is called K11POS.TSK.  It does NOT (and can not) run from a
 menu, the normal way to run it is via the RUN  command  in  DCL.
 It  will support the Kermit-11 attribute packets, thus a PRO/350
 connected to a PDP11 host can transparently  handle  binary  and
 other types of files.  The P/OS Kermit-11 can be run either as a
 local Kermit or a Kermit server.  This  has  been  tested  under
 P/OS version 2 connected to both a PDP11/23+ and PDP11/70 RSTS/E
 host.
 When Kermit-11 is started on the PRO, it will automatically do a
 SET LINE XK0:  and a SET SPEED 9600.  You can, of course, change
 the speed to whatever you need with the SET SPEED command.   The
 line should be left as XK0:.

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 and HELP  SERVER
 for general Kermit server operation.

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 CWD

 The REMOTE CWD command will  cause  Kermit-11  to  send  to  the
 Kermit  server  the  new  default directory.  If the server is a
 Kermit-11, passwords are ignored.  See HELP CWD and HELP SET DEF
 for further information.

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 HOST

 The REMOTE HOST command sends the comamnd  over  to  the  remote
 Kermit  for  execution  on  that system.  This is only currently
 supported for version 8.0 of RSTS/E, and will be  supported  for
 RSX11M Plus in the near future.
  
                Kermit-11>REM HOST SHO DEV
  
                Busy Devices:
                Device      Job    Why
                KB12        18     AS
                PK0         29     Open
                PK1         8      AS
                PK2         5      AS+Open
                SH0         2      Open
                FE0         14     AS+Open
                
                Disk Structure:
                Dsk Open   Size    Free  Clu Err Name   Level  Comments
                DK1    0   4800   640 13%  4  0  BRIAN4  1.1   Pri, DLW, Lck
                DB0   23 171796 33944 19%  4  0  SYSPAC  1.1   Pub, DLW
                DB1    3 171796 15948  9%  4  0  WORK1   1.1   Pri
                DB2   53 131648  7344  5%  4  0  SYSLIB  1.1   Pri, DLW
  
                Kermit-11>
  
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 available 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 RESTRICTIONS

 Prior to version 2.21, Kermit-11 did not support 8-bit prefixing.
 Prior to version 2.23, Kermit-11 did  not  support  repeat  character
 encoding.
 The PRO/RT11 version of Kermit-11 will request 8-bit prefixing due to
 the  fact  that  the XC handler does not support 8BIT data.  For most
 Kermits this should not be a problem.  The XC handler  always  strips
 bit  7  from  the  character  being  sent, so the PRO/RT11 version of
 Kermit will request prefixing of such.   It  does  so  internally  by
 setting PARITY to SPACE (always clear the high bit, bit seven).
1 RSTS

 Kermit-11 runs on version 7.2 or later of  RSTS/E.   Due  to  options
 present  in  version  8,  binary  file transfers will not be possible
 under version 7.2 of RSTS/E.  This is due to the use of  8  bit  mode
 for  the  terminal link to allow all characters to be passed.  The so
 called '8BIT' termianl setting  was  new  as  of  version  8.0-06  of
 RSTS/E.

 Any RSTS/E system running Kermit-11 will need the sysgen  option  for
 multiple  private  delimiters  in  the terminal driver.  This special
 mode is needed since the 'normal' RSTS/E binary terminal mode  has  a
 'feature'  that  disables binary mode whenever the terminal times out
 on a read.  Since timeouts are essential to  Kermit  error  recovery,
 binary mode can not be used for i/o.

 Certain functions  of  Kermit-11  require  that  the  system  manager
 install  Kermit  with  temporary  priveledges, these commands are the
 SYSTEM, WHO and REMOTE HOST commands.  Kermit-11 does NOT need  these
 to operate correctly.

 Kermit-11 can only be built under RSTS/E version 8.0 or later due  to
 the use of RMS11 v2.0 and new assembler directives.

1 RSX11M/M+

 Kermit-11 can not be installed non-checkpointable due to an  apparent
 RMS11 bug.  In other words, don't try to install the task '/CKP=NO'.

 To use the connect command effectively, typeahead support  is  needed
 in  the  terminal driver.  For RSX11M+, set the typeahead buffer size
 high, as in SET /TYPEAHEAD=TT22:200.  Also, if your connect  line  is
 TT22:  (as above), use the mcr command SET/SLAVE=TT22:  

 Kermit-11 can only be built under RSX11M version  4.1  or  later,  or
 under  RSX11M  Plus version 2.1 or later due to the use of RMS11 v2.0
 and new assembler directives.

 There is a SET RSX command, see HELP SET RSX for further information.

 As a side issue, please note that the file K11POS.TSK is quite usable
 under  RSX,  the  difference being that K11RSX.TSK has DECNET support
 and RMS-11 overlayed in the task image (besides  which,  due  to  the
 lack  author's systems running RSX may not be up to date) linked into
 it, whereas K11POS has NO Decnet support but IS linked to  the  RMS11
 library RMSRES (v2), thus K11POS saves disk space as well as support-
 ing named directories, ala VMS style.

1 RT11

  Kermit-11, as of version 2.20, has been tested  under  RT11  version
 5.0  under the FB and XM monitors using a DZ11 line for the link, and
 also on a PDT-150 using the modem port for the link.   It  has  addi-
 tionally  been  run under Micro-11's and the PRO/350 using the XL and
 XC handlers respectively.
  As of Kermit-11 v2.39, RT11 users can use a SET LIN TT:, which  will
 force  Kermit-11  to  use  the  CONSOLE  port  for  all I/O, with the
 restriction that CONSOLE port I/O must request 8bit prefixing for the
 transfer of BINARY data.  Additionally, if the RT11 system lacks both
 MT service and the XL/XC handler, Kermit-11 will use the  console  by
 default.

  Kermit-11 requires .TWAIT  support  as  well  as  multiple  terminal
 support.   The  use  of multiple terminal support allows Kermit-11 to
 use any type of interface sysgened, including  the  DZ11  and  DZV11.
 The  exceptions  for  MT support and/or XC/XL support are noted above
 regarding console only usage.
  It is possible under version 5 of  RT11  to  use  the  XL:   handler
 instead of the multiple terminal support.  The use of the XL:  driver
 will result in much faster file transfer at high  baud  rates.   Note
 that  XL:   must be set up at system startup or at some time later to
 set the proper speed, CSR and vector.  For PRO/RT11 information,  see
 HELP PRO RT11.

  Please note that the device name syntax for terminal  lines  follows
 the  MT  unit  numbers, thus if a SHO TER gave unit 5 for DZ11 line 0
 the the device name would be:
  
        Kermit-11>SET LINE 5
  
 If you must use the console port:
  
        Kermit-11>SET LIN TT:
  
 If you use the XL handler, you would do this:
  
        Kermit-11>SET LINE XL:
  
 Additionally, Kermit-11 for RT11 looks for its help file, K11HLP.HLP,
 on DK:  first and then on SY:  if the first one fails.

 Full wildcarding is supported for RT11, in the form  *.type,  name.*,
 *.* and the % character to match any single character.

 Kermit-11 can only be built on RT11 version 5.0 or later due  to  the
 use of new assembler directives.
 Please note that for the connect command under RT11 and  the  use  of
 the  MT service, you will most likely need xon/off flow control to be
 generated by Kermit-11.  This is  enabled  with  the  SET  RTFLOW  ON
 command.   This  is by default OFF since the modem the author uses, a
 Vadic 212LS, can't handle XONs and XOFFs while in command mode.   The
 solution  here  is  to  escape  back to Kermit command mode after the
 remote system has been logged into, and then type SET RTFLOW ON.

 Due to overlaying constraints, the RT11  Kermit-11  will  not  accept
 wildcards  for  the  RENAME and DELETE commands and the REMOTE server
 equivalents.

 The executable files are K11XM.SAV for the XM system and PRO/350, and
 K11RT4 for the FB system.

 For notes regarding hardware, see K11USR.DOC 

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
  
  
  At this time, the Kermit-11 server can process the following
  commands:
  
                BYE             Logout Kermit-11.
                REMOTE COPY     Copy a file to another.
                REMOTE DIR      Prints a directory out.
                REMOTE DISK     Prints the disk  space.
                REMOTE ERASE    Delete the filename(s).
                FINISH          Exits Kermit-11 server.
                GET             Sends  the filename(s).
                REMOTE HELP     Prints this  help text.
                REMOTE HOST     Execute a host command.
                REMOTE RENAME   Rename old file to new.
                REMOTE SPACE    Prints the disk  space.
                REMOTE TYPE     Prints the filename(s).
                REMOTE WHO      Shows users logged  in.
  
  

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 ATTRIBUTES

 Part of the Kermit  protocol  is  the  support  of  file  attributes.
 Connected  Kermits  that  support  this  can send information to each
 other about file size, time/date of creation, RMS  file  headers  and
 other  useful  things.   Due  to potential problems with incompatible
 implementations this feature can be  disabled.   In  this  case,  the
 sending Kermit-11 will never try to send file attributes, even though
 the receiver may have indicated that it supports this.
  
                Kermit-11>SET ATTRIBUTES OFF
                Kermit-11>SET ATTRIBUTES ON
                Kermit-11>SET NOATTRIBUTES
  

2 BAUD

 This is the same as SET SPEED.  See HELP SET SPEED

2 BINARY-TYPE

 Kermit-11 has a default list of filetypes that are scanned to  decide
 if  a file should be sent in binary mode in addition to checking file
 attributes for RSX, P/OS and RSTS/E.  The user can, however,  overide
 this  list  with  the  this  command.   The  default  list  is fairly
 inclusive, with types such as .SAV and .TSK  forcing  Kermit-11  into
 binary transmission.  See HELP SET FIL for the default list.
  
        Kermit-11> SET BINARY-TYPE .SAV
        Kermit-11> SET BIN .EXE
  

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-11 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
           Kermit-11>SET BLO 1
           Kermit-11>SET BLO 2
           Kermit-11>SET BLO 3
  
 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 CONSOLE

 The SET CONSOLE command is used under P/OS to control the passing  of
 8  bit  data  to  th terminal during the connect command.  If you are
 getting multinational characters being printed, this is a very useful
 thing to set.  The default is SET CON 7.
  
        Kermit-11>SET CON 8
        Kermit-11>SET CON 7
  

2 DEBUG

 The SET DEBUG command is used to specify the type and level of debug-
 ging  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
                Kermit-11>SET NODEBUG
  

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
                Kermit-11>SET DEFAULT DB2:[200,201]
  
 This is quite useful for Kermit-11 running on a DECNET link,  as  you
 can  set  the  default  for file operations to include node names and
 passwords as in:
  
                Kermit-11>set def orion::sys$system:[fubar]
  

2 DUPLEX

 The DUPLEX parameter controls whether an outgoing link (set  via  the
 SET  LINE  command)  is  a  full  duplex link (the default) or a half
 duplex link.  All it does for half duplex is to cause all  characters
 typed after the CONNECT command to be echoed locally.
  
                Kermit-11>SET DUPLEX HALF
                Kermit-11>SET DUPLEX FULL
  

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  process-
 ing.   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-11  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
            Kermit-11>SET FIL BIN
  
3 ASCII

 File type ASCII is for text files.

3 AUTO

 Kermit-11 will normally try to decide if  a  file  must  be  sent  in
 binary  mode  based  on  the  file  attributes and filetype.  If, for
 instance, the directory entry for FUBAR.TXT showed it to be  RMS  (or
 FCS)  fixed  length records, Kermit-11 will switch to binary mode and
 send it verbatim.  If the receiving Kermit  is  Kermit-11,  then  the
 sending  Kermit  will  send  attribute data over also.  The following
 file types also will normally be sent as binary files unless you  use
 the SET FILE NOAUTO command.
  
                *.TSK   ; rsx, ias, and rsts tasks
                *.SAV   ; rt11 and rsts save images
                *.OBJ   ; compiler and mac output
                *.STB   ; tkband link symbol tables
                *.CRF   ; tkb and link cross reference files
                *.TSD   ; 'time shared dibol' for rt11
                *.BAC   ; rsts basic+ 'compiled' files
                *.OLB   ; rsx, ias, and rsts object libraries
                *.MLB   ; rsx, ias, and rsts macro libraries
                *.RTS   ; rsts/e run time systems
                *.EXE   ; vms executable
  
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 (non
 PDP-11) system without losing file attributes.  This means that  (for
 example),  an RSM11 indexed file cannot be transmitted with Kermit-11
 at this time.  You can not have parity set to anything  but  NONE  to
 use  binary  file  transfer  (see  HELP  SET PARITY) unless the other
 Kermit can process eight bit quoting.  Two Kermit-11's  connected  to
 each  other will use binary transmission automatically via the Kermit
 attribute packets, preserving file attributes where  it  makes  sense
 (ie, RSTS/E and RSX only).

3 FIXED

 SET FIL FIXED is the same as SET FIL BIN

3 NOAUTO

 SET FILE  NOAUTO  disables  Kermit-11  from  trying  to  base  binary
 transmission mode on file attributes or filetype.

3 PROTECT

 See HELP SET FILE SUPERCEDE for information.

3 SUPERCEDE

 SET FILE [NO]SUPERCEDE allows Kermit-11 to  accept  or  reject  files
 received  (from  either  the  RECEIVE  or GET commands) on a per file
 basis.  The default is SUPERCEDE.   By  doing  SET  FILE  NOSUPERCEDE
 Kermit-11  will  always  check  to  see  if the file to be created is
 already there (independent of version number) and reject  it  to  the
 sending  server  if it exists.  This presumes that the Kermit sending
 the file understands the protocol to reject one file of a  (possibly)
 wildcarded group of files.
 The main use of this is to resume getting a group of files, as in GET
 KER:K11*.*  or  GET  KER:MS????.*  having  lost  the connection after
 transfering some of the files.   If  this  is  set,  then  any  files
 already transfered will not be transfered again.
  
        Kermit-11>SET FILE SUPERCEDE
        Kermit-11>SET FILE NOSUPERCEDE
  
3 TEXT

 SET FIL TEXT is the same as SET FIL ASCII

3 TYPE

 The SET FILE TYPE xxx command  is  the  same  as  the  SET  FILE  xxx
 command.   The  keyword  TYPE is ignored for compatibility with other
 implementations of Kermit.

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 IBM-MODE

 The SET IBM ON (or OFF) will instruct Kermit-11 to wait for an XON
 following each packet sent to an IBM host. Since the default for IBM
 mode may not always be appropiate for your IBM compatible system, you
 can always use the SET HANDSHAKE XON and SET DUPLEX HALF to avoid the
 parity setting implied by using IBM mode.
 
                Kermit-11>SET IBM ON
                Kermit-11>SET IBM OFF
  

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+.  For RT11, the
 device name is simply the  MT  unit  number  shown  by  the  SHO  TER
 command,  as  in  '5'  for  DZ11  unit  0 line 4.  If you are running
 K11POS.TSK for P/OS on the PRO/350, Kermit-11 will set  the  line  to
 XK0:  and the speed to 9600 baud when Kermit starts.  To override the
 line or speed, set HELP SET LINE and HELP SET SPEED.
 As of Kermit-11 v2.39, RT11 users can use a SET LIN TT:,  which  will
 force  Kermit-11  to  use  the  CONSOLE  port  for  all I/O, with the
 restriction that CONSOLE port I/O must request 8bit prefixing for the
 transfer of BINARY data.  Additionally, if the RT11 system lacks both
 MT service and the XL/XC Kermit-11 will use the console by default.
  
                Kermit-11>SET LINE TT55:        (for RSTS and RSX)
                Kermit-11>SET LINE 5            (for RT11)
                Kermit-11>SET LINE XK0:         (for P/OS)
                Kermit-11>SET LINE XL:          (for RT11)
 See HELP CONNECT, HELP SET DUPLEX and HELP SET SPEED for more  infor-
 mation.

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 MODEM

 The SET MODEM command is used to establish the type of modem you  are
 using  for  the  DIAL command.  If the type of modem is not currently
 supported, the DIAL command will not function.  As of  this  writing,
 28-Oct-85,  only the Racal Vadic VA212PA, VA212PAR, Digital DF112 and
 Hayes modems are supported.  The older VADIC  3212  and  34xx  modems
 with autodialing options should also function via SET MODEM VADIC.
  
                Kermit-11>SET MOD VADIC         for most Vadic
                Kermit-11>SET MOD VA212PAR      rack mount VA212
                Kermit-11>SET MOD DF100
                Kermit-11>SET MOD HAYES
  

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, EVEN, MARK or SPACE as in:
  
                Kermit-11>SET PARITY NONE
                Kermit-11>SET PARITY ODD
                Kermit-11>SET PARITY EVEN
                Kermit-11>SET PARITY MARK
                Kermit-11>SET PARITY SPACE
  
 All parity generation is done via software, no  special  hardware  is
 used.   The  use of software parity generation is restricted to 8 bit
 links only.  The character format, if parity is set to  anything  but
 NONE, will be 7 bits of data followed with high bit set or cleared to
 indicate the parity.  If you set parity to  anything  but  NONE  (the
 default) you can NOT, at this time, send binary files.  Attempting to
 set parity if the FILETYPE is BINARY will result  in  an  error  (SET
 FILETYPE qualifier).

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 PROMPT

 The SET PROMPT command is useful if you are using two Kermit-11's  to
 talk  to each other.  By using the SET PROMPT command, you can change
 the prompt from 'Kermit-11>' on either (or both) Kermit to  something
 that would indicate which system you are currently connected to.
  
                Kermit-11>SET PROMPT KERMIT-11/1170>
                Kermit-11>SET PROMPT FUBAR>
                Kermit-11>SET PROMPT PROKERMIIT-11>
  

2 RANDOM

 This command allows Kermit-11 to randomly  generate  checksum  errors
 for  testing  error  recovery  of  an  attatched  Kermit.   You would
 normally never use this command.  Another command that goes  with  it
 is  called  SET  SEED  value  which  starts  the psuedo random number
 generator at a different point.
  
                Kermit-11>SET RANDOM ON
                Kermit-11>SET RANDOM OFF
  

2 RECEIVE

 Currently the SET RECEIVE and SET SEND basically  work  the  same  in
 that   they   only   alter   the   END-OF-LINE   character   and  the
 START-OF-PACKET value, as in:
  
                Kermit-11>SET REC START 2
                Kermit-11>SET REC END 12
  
3 END-OF-LINE

 This instructs Kermit-11 to expect something other than  the  default
 carriage  return  (octal  15) at the end of a packet.  Kermit-11 will
 ignore packet terminators.  The SET SEND END command is of  more  use
 in conditioning outgoing packets.

3 START-OF-PACKET

 The normal Kermit packet  prefix  is  Control-A  (1);   this  command
 changes  the  prefix Kermit-11 expects on incoming packets.  The only
 reasons this should ever be changed would be:  Some piece  of  equip-
 ment  somewhere between the two Kermit programs will not pass through
 a Control-A;  or, some piece of  of  equipment  similarly  placed  is
 echoing its input.  In the latter case, the recipient of such an echo
 can change the packet prefix for outbound  packets  to  be  different
 from  that  of  arriving  packets  so that the echoed packets will be
 ignored.  The opposite Kermit must also be told to change the  prefix
 for its inbound packets and the prefix it uses on outgoing packets.
  
                Kermit-11>SET REC START-OF-PACKET 2
  
2 RECORD-FORMAT

 Kermit will, by default, create RMS11 variable  length  implied  car-
 riage  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 RSX

 The SET RSX command is intended to deal with  the  peculiarities  oft
 found  with RSX systems.  There are currently three SET RSX commands,
 as in:
  
        Kermit-11>SET RSX FASTIO        Default for packet reading,
                                        waits for <CR>.
        Kermit-11>SET RSX CHARIO        Read one char at a time for
                                        packet reading.
        Kermit-11>SET RSX TC.DLU n      Alters  the TC.DLU setting.
        Kermit-11>SET RSX CONNECT ALT   Uses a new  (v2.33) connect
                                        driver which bypasses TTDRV
                                        flow control.
        Kermit-11>SET RSX CONNECT DEF   Use old connect code (2.32)

2 RT11

3 CREATE-SIZE

 The SET RT11 CREATE value command was  added  to  assist  those  RT11
 users  with  very  small  disks  to  be  able to get files with sizes
 greater that half of the availble contiguous space  availble.   While
 this  is  NOT a problem going from one Kermit-11 to another Kermit-11
 since the PDP-11 Kermit supports a subset of the  protocol  known  as
 'ATTRIBUTES',  other  Kermits  may  not  support the exchange of file
 sizes (most do not).  Thus if your largest contiguous  space  is  300
 blocks and you want to get a 250 block file, the command:
  
        Kermit-11>SET RT11 CRE 250
  
 would be needed, as RT11 by default only allocates 50 percent of  the
 available space.

3 FLOW-CONTROL

 Note that for the connect command under RT11  you  will  most  likely
 need  xon/off  flow  control  to  be generated by Kermit-11.  This is
 enabled with the SET RT11 FLOW command.  This is  by  default  NOFLOW
 since the modem the author uses, a Vadic 212LS, can't handle XONs and
 XOFFs while in command mode.  The solution here is to escape back  to
 Kermit command mode after the remote system has been logged into, and
 then type SET RT11 FLOW.
 The effect of SET RT11 FLOW is for Kermit-11, when in  connect  mode,
 to send an XOFF to the host every eight characters.  When the loop in
 the connect module finds no more data in the input buffer,  it  sends
 up  to  2 XON characters (in case the first XON got lost) to tell the
 remote system to start sending again.  The reason  for  doing  so  is
 that  the  RT11 multiple terminal service is very slow about handling
 input interupts and does not do any of it's  own  flow  control  when
 it's  internal  ring  buffer gets full.  This has been tested at line
 speeds up to 4800 baud without losing data.  This setting should  not
 be needed for use with the XC/XL handlers.
 SET RT11 FLOW has NO effect on packet transmission, since the  Kermit
 packet  size  is  never  mode  than 96 characters, and the RT11 input
 buffer is 134 chararcters in size.
  
                Kermit-11>SET RT11 FLOW
                Kermit-11>SET RT11 NOFLOW
  

3 VOLUME-VERIFY

 Normally RT11 Kermit-11 will check the directory header of a disk  to
 verify  that  it  most  likely  contains  a valid RT11 file structure
 before trying to read the directory.  If for some  reason  your  disk
 does  not  contain  the  standard  data  at offset 760 in the header,
 Kermit-11 will reject the disk.  The  SET  RT11  NOVOL  command  will
 instruct Kermit-11 to bypass that check.
  
                Kermit-11>SET RT11 VOL
                Kermit-11>SET RT11 NOVOL
  

2 SEND

 The SET SEND command  controls  what  Kermit-11  will  be  doing  for
 outgoing  packets in that you may want to alter the packet terminator
 and/or the start of packet character (by  default,  15  octal  and  1
 octal respectively.  See HELP SET RECEIVE for more information.

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+.
 The  SET SPEED command will only function with a DH11, DHV11, DZ11 or
 DZV11 multiline interface.
  
                Kermit-11>SET SPEED 1200
  
 1200 Baud would be a normal speed to use with a VA212LS or a DF03.

 Please note that Kermit-11 CAN NOT change the speed of  a  DL11  type
 interface,  nor can it change the speed of a PDT-150 modem port.  For
 a PDT-150 modem port, use a command  of  /M/S:nnnn.   to  change  the
 speed to nnnn for the SPEED.SAV program.

2 START-OF-PACKET

 The SET START octal-value tells Kermit-11 to expect and also to  send
 as  the  start of packet character the specified character instead of
 the default Control-A  (octal  1).   Note  that  both  Kermit's  must
 support  this  command (or SET RECEIVE/SEND START value) as it is not
 possible for two Kermit's to negociate this.  This set command is the
 same as doing both a SET REC START n and SET SEND START n.
  
                Kermit-11>SET START 2
                Kermit-11>SET START 1
  

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.

2 TERMINAL

 The SET TERMINAL command simply  controls  the  way  which  Kermit-11
 prints  packet  counts  while  send  or receiving a file (or group of
 files).  The simplest way is the default, SET TER TTY.  Using SET TER
 VT100  will  cause Kermit to display headers for the numbers printed,
 at a possible cost in packet speed due to screen control overhead.
  
                Kermit-11>SET TER TTY
                Kermit-11>SET TER VT100
  

2 UPDATE

 The SET UPDATE command controls the frequency  at  which  the  packet
 count  display is updated.  The default is 1, displaying each packet.
 A SET UPD 0 will disable all packet count logs, whereas a SET  UPD  N
 will update the display every N packets.  The SET NOUPDATE command is
 the same as SET UPDATE 0.

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 TSX+

 Kermit-11 for TSX+ is exactly the same  Kermit  used  under  RT11/XM.
 Kermit-11  for RT11 always checks for the type of system it is on, be
 that RT11, PRO/RT11 or TSX+.  At run time, it will  dispatch  to  the
 correct overlay for doing terminal i/o (or XL/XC i/o).  Note that for
 TSX+, you can only dial out by using the XL  handler,  supplied  with
 version 5.  As far as system requirements go the author has been told
 that the sysgen parameter DINSPC in TSGEN.MAC mu st at least 100 (10)
 in  value, otherwise the terminal driver will be unable to buffer the
 entire received Kermit packet.  Since the author does not have or use
 TSX+,  any  problems  that arise on TSX+ will have to be fixed by the
 site's systems personel and reported back to the author.
 To use the CL:   handler  under  TSX+,  the  following  commands  are
 needed.  Please note that 'n' stands for a value, be it a unit number
 or a speed value.  In all  cases,  the  commands  are  KMON  commands
 unless shown with a Kermit-11> prefix.
  
        .SET CL LINE=n
        .SET CL NOLFOUT
        .SET CL SPEED=nnnn
        .ASS CLn XL
        .run kermit
        Kermit-11>SET LIN XL
  
 See HELP RT11 for more information that would also pertain to TSX+.

1 TYPE

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

1 USAGE

 Kermit-11 is normally run on the PDP-11  host  system  as  a  server.
 This means that a remote Kermit can send it commands without the user
 having to be switching between the local Kermit (usually a micro) and
 the  remote Kermit (the one on the PDP-11).  While Kermit-11 supports
 most of the server commands shown in version Four revision 1  of  the
 protocol  manual  (see  HELP REMOTE), not all micro based Kermits are
 able to send these commands to Kermit-11.  Most  Kermits  do  support
 the  GET,  SEND, BYE and FINISH server commands, which are sufficient
 for most file transfers.  The following is an example of the  dialoge
 when  a  DEC  VT180  Robin  connects to a PDP11/70 RSTS system to use
 Kermit.
  
    A>b:
    B>a:cpmrob
    Kermit-80 V3.6 [VT180 "Robin"]
  
    Kermit-80  B:>connect
    [Connected to remote host, type Control-\C to return]
  
    LOG
    RSTS V8.0-07 U of Toledo 70 Job 12 KB25  17-Feb-84  03:31 PM
    User    # 2/2
    Password:
  
    Welcome to RSTS/E version 8.0
  
    $ kermit
    Kermit-11>server
    Kermit Server running on PDP-11 host. Please type your escape sequence
    to return  to your local machine.  Shut down the server by  typing the
    Kermit BYE command on your local machine.
  
    (the user now types Ctrl \C)
  
    Kermit-80  B:>get *.odl
        .
        . All files on the 11/70 with types of ODL are sent
        .
    Kermit-80  B:>bye
    B>
  
 See HELP SEND, HELP GET and HELP BYE for additional information.

1 WHO

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

