


1 @

 This command 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  imbedded  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/M+ or has a CCL  name  for
 it for RSTS/E, can get a command from the command-line and execute it
 immediately.  For all commands 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 CANNOT 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  autodialing
 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.
 The case of PRO/TMS is special.  This is an internal modem,  accessed
 via  device  XT1:.   In  this case, the user MUST suplly, in the dial
 string, any TMS formatting or control characters.  The modem type  is
 selected automatically if you do a SET LINE XT0:  or SET LINE XT1:

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 causes 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 environments -- buffering, duplex,
 parity, character set,  file  organization,  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 application 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 implementations  of
 KERMIT are also expected to provide terminal emulation, to facilitate
 the initial connection.

 More advanced implementations simplify the user interface somewhat 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 connection.
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 simple 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 cannot) 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 PDP-11
 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 PDP-11/23+ and PDP-11/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  directory
 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 file specification.  For a Kermit-11 server,
 this can include wildcard 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  priviledges, 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 RMS-11 V2.0 and new assembler directives.

1 RSX11M/M+

 Kermit-11 cannot be installed non-checkpointable due to  an  apparent
 RMS-11 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 RMS-11 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  RMS-11
 library  RMSRES  (V2),  thus  K11POS  saves  disk  space  as  well as
 supporting 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
 additionally  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/XOFF 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  running  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
 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
                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 command 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 command 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 DIAL

 The SET DIAL command is used to configure an undefined modem type  to
 enable  the  DIAL  command  to function.  Since the discussion of SET
 DIAL is quite involved, please consult the Kermit-11 User's Guide for
 further   information.   The  following  commands  are  supported  by
 Kermit-11 for the SET DIAL command:

                Kermit-11>SET DIAL WAKEUP string
                Kermit-11>SET DIAL WAKE_STRING string
                Kermit-11>SET DIAL PROMPT string
                Kermit-11>SET DIAL INITIATE string
                Kermit-11>SET DIAL FORMAT string
                Kermit-11>SET DIAL SUCCESS string
                Kermit-11>SET DIAL INFORMATION string
                Kermit-11>SET DIAL FAILURE string
                Kermit-11>SET DIAL CONFIRM string
                Kermit-11>SET DIAL WAKE_RATE delay
                Kermit-11>SET DIAL DIAL_RATE delay
                Kermit-11>SET DIAL DIAL_PAUSE string


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
 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-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 PDP-11 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  PDP-11 system cannot be transferred to another
 (non PDP-11) system without losing file attributes.  This means  that
 (for  example),  an  RMS-11  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.
 .lit

                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
 information.

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,
 27-Jan-85,  the  Racal  Vadic  VA212PA, VA212PAR, generic VA3400 with
 autodialler option, Digital  DF112,  MicroCom  SX1200,  Rixon  R212A,
 PRO/TMS  and  Hayes  modems  are supported.  The older VADIC 3212 and
 34xx modems with autodialing options should  also  function  via  SET
 MODEM  VADIC.   The following modems are defined.  The DF200 and DF03
 types have not been tested.

                Kermit-11>SET MOD VA212PA
                Kermit-11>SET MOD VA212PAR
                Kermit-11>SET MOD VADIC   
                Kermit-11>SET MOD DF03    
                Kermit-11>SET MOD DF100   
                Kermit-11>SET MOD DF200                           
                Kermit-11>SET MOD HAYES                           
                Kermit-11>SET MOD MICROCOM
                Kermit-11>SET MOD R212A   
                Kermit-11>SET MOD PROTMS                          


 An implcit SET MOD PROTMS is done if the line is XTn:  and the  modem
 type is undefined under P/OS on the PRO/350.

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 PHONE

 Currently, the SET PHONE command supports the NUMBER option, as in:

                Kermit-11>SET PHONE NUMBER WORK 5374411

 This allows Kermit to associate a tag name with a  phone  number  for
 the DIAL command; in the above example:

                Kermit-11>SET MOD VADIC
                Kermit-11>DIAL WORK

 This would cause Kermit-11 to translate WORK to 5374411 and dial  it.
 See the Kermit-11 User's Guide for further information.

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 pseudo-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
 equipment  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


3 PACKET-LENGTH

 SET RECEIVE PACKET-LENGTH

 This command has two functions.  The first, and  normal  one,  is  to
 reduce  incoming packet lengths in the event that normal sized Kermit
 packets can not be passed through the communications circuit.   There
 could  be, perhaps, some 'black box' somewhere in the link that has a
 very small buffer size; this command could be used to reduce the size
 that the SENDING Kermit will use.

 The other use is to enable a new protocol extension to Kermit  called
 'LONG  PACKETS'.   The actual protocol is documented elsewhere, let's
 just say that this is a way for two Kermit's to use packet sizes  far
 greater  than  the normal ('Classic') packet size of 90 characters or
 so.  The main use of this feature is in file transfer over links that
 introduce considerable delay, it is not uncommon for packets to incur
 an one to two second delay.  The net result is a  VERY  slow  running
 Kermit with an effective speed of perhaps 300 to 600 baud rather than
 1200 or 2400 baud.  By  making  the  packets  longer,  we  raise  the
 effective  speed  of  such  a  circuit.   The main restriction on the
 packet size chosen is the link, a given  circuit  may  not  pass  500
 character packets.  Also, BOTH Kermits must support this extension to
 the protocol, they will always negotiate it before any file transfer.
 See the notes at the end of this document for more information.

                Kermit-11>SET REC PAC 50
                Kermit-11>SET REC PAC 600

 It is HIGHLY recommended that you use the CRC  block  check,  as  the
 default  type one checksum could be inadequate for such long packets,
 as in:

                Kermit-11>SET BLO 3


2 POS (P/OS on the PRO/350)

 The currently available options on the SET command  for  the  PRO/3x0
 under P/OS version 2 are:

        Kermit-11>SET POS DTE
        Kermit-11>SET POS NODTE

 The DTE option tells Kermit-11 to attempt to spawn PRO/Communications
 (DTE)  as  the  CONNECT  code; this allows the use of the 'grey keys'
 SETUP to set terminal emulation characteristics, and the use  of  the
 'EXIT'  key  to  return to the Kermit-11 command level.  The 'SET POS
 DTE' command enables the attempt to call PRO/COMM, whereas  the  'SET
 POS NODTE' enables the builtin terminal emulation.

2 RECORD-FORMAT

 Kermit will,  by  default,  create  RMS-11  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 PDP-11 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/XOFF  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 CANNOT 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 pseudo-keyboard 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  dialog
 when  a  DEC  VT180  Robin connects to a PDP-11/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.


.
