home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / pdp11 / k11hlp.txt < prev    next >
Text File  |  2020-01-01  |  74KB  |  1,954 lines
  1.  
  2.  
  3.  
  4. 1 @
  5.  
  6.  This command opens  an  indirect  file  for  command  input.   It  is
  7.  identical to the TAKE command.  The format of the command is:
  8.  
  9.                 Kermit-11>@ file-specification
  10.  
  11.  where 'file-specification' is any valid  file  specification  on  the
  12.  system on which the server Kermit is running.
  13.  
  14. 1 BINARY FILES
  15.  
  16.   Binary files are those files which require all eight  bits  in  each
  17.  character.   Text  files, like program source files, compiler listing
  18.  and RUNOFF files, normally use  only  the  low  seven  bits  in  each
  19.  character.   Binary  files  include  task  images,  save  images, RMS
  20.  relative and indexed files and other special types of files.
  21.   In order for Kermit to transfer these files Kermit-11 needs an eight
  22.  bit   line,   which   for   most   PDP-11  systems  is  the  default.
  23.  Additionally, most Kermits need to be  set  into  a  binary  mode  to
  24.  transfer  such  files.   The  command  to do this is usually the 'SET
  25.  FILETYPE BINARY' command, or 'SET FIL BIN' for short.  Since  various
  26.  Kermit  implementations are at different stages of developement, most
  27.  Kermit links can NOT handle  binary  files  automatically,  thus  the
  28.  above  SET  command  must  be given to BOTH Kermits prior to a binary
  29.  file transfer.  One important note is that the VMS Kermit-32 requires
  30.  a  SET  FIL  TYP  FIX to properly send and receive binary files.  For
  31.  example, a Kermit-11 connected to a VMS  system  as  a  local  Kermit
  32.  would  first  log  onto  the  VAX  and  invoke Kermit-32 and give the
  33.  commands SET FIL TYP FIX and SER.  Then one would escape back to  the
  34.  Kermit-11  (control c) and give Kermit-11 the command SET FIL BIN (or
  35.  the same, SET FIL TYP FIX).  At this point the Kermit-11 can use  the
  36.  GET  and  SEND commands to transfer binary files like task images and
  37.  save images.
  38.   As a side note, there may be cases where  the  proper  SET  commands
  39.  have  been  given  but  the  binary file does not transfer correctly.
  40.  This has been noted on VMS when a task image is copied from tape  via
  41.  FLX  to  disk  and then sent over to a PDP-11 using Kermit.  The file
  42.  was found to contain carriage  control  after  it  was  sent  to  the
  43.  PDP-11.   This  was  because when FLX created it on the VAX, the file
  44.  was created with fixed 512 records with carriage return control.  VMS
  45.  Kermit honored this and sent a CRLF every 512 bytes.
  46.   Please note that transfering text files when  one  or  both  of  the
  47.  Kermits  are  set to binary mode can result in an unusable file after
  48.  transfer because of the possibility of  transfering  imbedded  record
  49.  control information.
  50.  
  51.   Version 2.16 (and later versions) of Kermit-11, however, can do  the
  52.  switch  into  binary  mode  automatically if the file attributes (and
  53.  protection code for RSTS/E) indicate that the file is most  likely  a
  54.  binary  file.   Additionally, two Kermit-11's connected to each other
  55.  will both do the 'right' thing if this is the  case  by  the  sending
  56.  Kermit-11  telling  the receiving Kermit-11 to switch to binary mode.
  57.  In this case, the sending Kermit-11 will also send a copy of the file
  58.  attributes over so the receiving Kermit-11 can properly set this when
  59.  the file is closed.  Thus two Kermit-11's connected to each other can
  60.  send task images, RMS indexed files and so on.
  61.  
  62. 1 BYE
  63.  
  64.  The BYE command will cause Kermit-11 (when in local mode) to tell the
  65.  other Kermit (which should be in server mode) to exit from Kermit and
  66.  if applicable terminate its job (or process, etc.).   When  Kermit-11
  67.  receives  the acknowledgement that this is being done, it will prompt
  68.  for another command.  The DISCONNECT command should always follow the
  69.  BYE command.  The format for BYE is:
  70.  
  71.                 Kermit-11>BYE
  72.  
  73.  
  74. 1 COMMAND-LINE
  75.  
  76.  Kermit, if the task is installed on RSX11M/M+ or has a CCL  name  for
  77.  it for RSTS/E, can get a command from the command-line and execute it
  78.  immediately.  For all commands other than SERVER,  Kermit  will  exit
  79.  upon  completion  of the command.  In the case of the SERVER command,
  80.  Kermit will return to interactive mode if the local Kermit sends it a
  81.  FINISH command.
  82.  
  83.                 > KERMIT SERVER
  84.                 $ KERMIT HELP
  85.  
  86. 1 CONNECT
  87.  
  88.  The CONNECT command will  allow  you  to  connect  in  as  a  virtual
  89.  terminal  over  the  line that was specified by the SET LINE command.
  90.  (Using the CONNECT command before using the  SET  LINE  command  will
  91.  result  in  an error message.) The terminal line must be one which is
  92.  accessable to the user.  The format of the CONNECT command is:
  93.  
  94.                 Kermit-11>CONNECT
  95.  
  96.  The distributed RSX11M/M+ task has been built with the  /PR:0  switch
  97.  to  enable  the task to change other terminal settings.  Addtionally,
  98.  for RSX11M/M+, the MCR  command  SET  /SLAVE=TTnn:   should  be  done
  99.  before entering Kermit-11.
  100.  
  101.  If you are running K11POS.TSK on a PRO/350, Kermit will set the  line
  102.  to XK0:  and the speed to 9600 by default.
  103.  
  104.  Please note that Kermit-11 CANNOT change the speed  of  a  DL11  type
  105.  interface,  nor  can it change the speed of a PDT-150 modem port (use
  106.  SPEED.SAV).
  107.  
  108.  The following is an example of using a Racal-Vadic VA212  autodialing
  109.  modem  to  log into a remote TOPS-20 system.  There are two points at
  110.  which there is no echoing of the user input.  The first is the typing
  111.  of a control-E <cr> sequence to get the attention of the modem, which
  112.  responds by sending the string 'HELLO:I'M READY'.  The second is  the
  113.  typing  of the local 'escape sequence', which by default is control \
  114.  followed by a  'C'.   The  control  backslash  informs  the  terminal
  115.  emulator  that  the  next  character is a command.  In this case, the
  116.  command was 'C', which means to return to the  local  PDP-11  system.
  117.  Control \ ?  would print a help message.
  118.  
  119.  
  120.         $ kermit
  121.         Kermit-11 V2.13
  122.         Kermit-11>set logfile 20.log
  123.         Kermit-11>set deb console
  124.         Kermit-11>set lin tt58:
  125.         Link device set to TT58:
  126.         Kermit-11>set spe 1200
  127.         Kermit-11>con
  128.         Connecting to TT58:
  129.         
  130.         HELLO:I'M READY
  131.         *d
  132.         NUMBER? 
  133.         3
  134.         9-1-212-123-4567
  135.         9-1-212-123-4567
  136.         
  137.         DIALING...
  138.         ANSWER TONE
  139.         ON LINE 
  140.         
  141.         enter class 4
  142.         class 004 start
  143.         
  144.         CU20B
  145.         @log xx.abcdef 
  146.          CU20B, TOPS-20 Monitor 5.1(5101)-2
  147.          Job 28, TTY32, 2-Apr-84 4:15:24PM
  148.          Previous login was 2-Apr-84 4:10:16PM
  149.                 .
  150.                 .
  151.                 .
  152.                 .
  153.         @log
  154.         [Confirm]
  155.         Logged out Job 28, User XX.ABCDEF , TTY 32,
  156.           at  2-Apr-84 16:19:34,  Used 0:00:11 in 0:04:10
  157.         
  158.         Kermit-11>disc
  159.         KERMIT link TT58: disconnected
  160.         Kermit-11>exit
  161.         
  162.         $ logout
  163.  
  164. 1 COPY
  165.  
  166.  The COPY command creates a copy of the  input  file.   The  Kermit-11
  167.  COPY  command  does  NOT support wildcards in the filename, and while
  168.  COPY does use multiblock buffering it is usually  more  efficient  to
  169.  use  the  system  utilty  PIP or the DCL command COPY for this.  COPY
  170.  uses RMS block i/o for both RSTS and RSX.  Any executable  RSTS  file
  171.  (*.TSK,  *.BAC  and  *.SAV) copied will not be useable until it's run
  172.  time system name and protection code is reset.
  173.  
  174.                 Kermit-11> COPY
  175.                 From: ABCDEF.DAT
  176.                 To  : FUBAR.LST
  177.  
  178.         or
  179.  
  180.                 Kermit-11> COPY ABCDEF.DAT FUBAR.LST
  181.  
  182.  
  183. 1 CWD
  184.  
  185.  The CWD command alters the current  device  and  UIC  (PPN)  default.
  186.  Thus,  the  command  'CWD  [200,200]'  would cause all following file
  187.  operations  to  insert  the  string  [200,200]  unless  an   explicit
  188.  directory  name was given.  This is identical to the SET DEF command.
  189.  Passwords are ignored.
  190.  
  191. 1 DECNET
  192.  
  193.  Kermit-11 can access DECnet files if built with DAP support.  This is
  194.  included in the task images K11NRS.TSK and K11RSX.TSK as distributed.
  195.  DECnet support has been tested for RSX11M.  See SET DEFAULT for  more
  196.  information.
  197.  
  198. 1 DELETE
  199.  
  200.  The DELETE command will delete the specified file or file group  from
  201.  the system.  Wildcards are permitted.
  202.  
  203.                 Kermit-11>DELETE FUBAR.MAC
  204.                 Kermit-11>DELETE FUBAR.*
  205.  
  206.  
  207. 1 DIAL
  208.  
  209.  The DIAL command will take the number specified and  attempt  to  get
  210.  the  attached  modem to dial the phone number.  The SET MODEM command
  211.  must  have  be  used  first,  except  in   the   case   of   PRO/TMS.
  212.  Additionally,  if  no line has been set, the SET LINE command must be
  213.  used.  Note that for the PRO/350, an implicit  SET  LINE  command  is
  214.  done at startup for XK:  or XC:.
  215.  Once a connection is made, you will  be  returned  to  the  Kermit-11
  216.  command line prompt, at which time you can use the CONNECT command to
  217.  attach to the remote system.
  218.  The case of PRO/TMS is special.  This is an internal modem,  accessed
  219.  via  device  XT1:.   In  this case, the user MUST suplly, in the dial
  220.  string, any TMS formatting or control characters.  The modem type  is
  221.  selected automatically if you do a SET LINE XT0:  or SET LINE XT1:
  222.  
  223. 1 DIRECT
  224.  
  225.  The DIRECT command will display the current  default  directory  when
  226.  used in the format:
  227.  
  228.                 Kermit-11>DIRECT
  229.  
  230.  If a directory other than the current default  directory  is  desired
  231.  then DIRECT may be used in the format:
  232.  
  233.                 Kermit-11>DIRECT file-specification
  234.  
  235.  where 'file-specification' is any legitimate  combination  of  device
  236.  name,  UIC  or  PPN,  and  a  filename which can include wild-carding
  237.  characters.
  238.  
  239. 1 DISCONNECT
  240.  
  241.  The DISCONNECT command causes Kermit-11 to 'hang-up' the  line  which
  242.  was  specified  with  the  SET  LINE  command  and connected with the
  243.  CONNECT command.  The format is:
  244.  
  245.                 Kermit-11>DISCONNECT
  246.  
  247.  
  248. 1 DISPLAY
  249.  
  250.  The Display command will format and  print  global  read/write  data,
  251.  defined in K11MAC.MAC, to the terminal, as in:
  252.  
  253.                 Kermit-11>DISP PROMPT
  254.  
  255.  
  256. 1 ERASE
  257.  
  258.  The ERASE command will ERASE the specified file or  file  group  from
  259.  the system.  Wildcards are permitted.
  260.  
  261.                 Kermit-11>ERASE FUBAR.MAC
  262.                 Kermit-11>ERASE FUBAR.*
  263.  
  264.  The ERASE command is identical to the DELETE command.
  265.  
  266. 1 EXIT
  267.  
  268.  The EXIT command will cause Kermit to return to  the  command  level.
  269.  This command is the same as the QUIT command.  The format is:
  270.  
  271.                 Kermit-11>EXIT
  272.  
  273.  
  274. 1 FINISH
  275.  
  276.  The FINISH command will tell Kermit-11, which is in  local  mode,  to
  277.  signal the other Kermit to exit from server mode.  When Kermit-11 has
  278.  received acknowledgement that this is being done, it will prompt  for
  279.  another command.  The command format is:
  280.  
  281.                 Kermit-11>FINISH
  282.  
  283.  
  284. 1 GET
  285.  
  286.  The GET command tells the remote Kermit which is in  server  mode  to
  287.  get a file or group of files.  The format for this command is:
  288.  
  289.  
  290.                 Kermit-11>GET file-specification
  291.  
  292.  where 'file-specification' may include any legitimate device, PPN  or
  293.  UIC  as  well  as the file specification.  Wildcarding may be used in
  294.  the file-spec.  to obtain a group of files.
  295.  
  296. 1 HANGUP
  297.  
  298.  The HANGUP command will drop the remote line  specified  by  the  SET
  299.  LINE  command  and  connected  by  the CONNECT command.  This command
  300.  presumes that the modem cable has the DTR line  (pin  20)  connected.
  301.  The same function is performed by the DISCONNECT command.  The format
  302.  of the HANGUP command is:
  303.  
  304.                 Kermit-11>HANGUP
  305.  
  306.  
  307. 1 HELP-FILE
  308.  
  309.  The Kermit-11 help file (this file) should be located as follows:
  310.  
  311.         For RSTS/E, RSX11M/M+
  312.  
  313.                 LB:[1,2]K11HLP.HLP      or
  314.                 SY:[1,2]K11HLP.HLP      or
  315.                 KERMIT:K11HLP.HLP       or
  316.                 HELP:K11HLP.HLP
  317.         
  318.         For RT11
  319.  
  320.                 DK:K11HLP.HLP           or
  321.                 SY:K11HLP.HLP
  322.  
  323.         For P/OS on the PRO/350
  324.  
  325.                 [001002]K11HLP.HLP
  326.  
  327.  
  328. 1 HOST
  329.  
  330.  The HOST command is identical to the SYSTEM command in that it  takes
  331.  the command and spawns a process to execute the command.
  332.  
  333.                 Kermit-11>HOST SHO TER 
  334.  
  335.                 Current settings for KB6:
  336.                 Broadcast   CRFill=0    NoEcho      NoHostSync
  337.                 Lowercase   NoParity    NoScope     Speed not settable
  338.                 Tab         NoTTSync    Width=80
  339.  
  340.                 Kermit-11>
  341.  
  342.  
  343. 1 INTRODUCTION
  344.  
  345.  The  KERMIT  file  transfer  protocol  is  intended  for  use  in  an
  346.  environment  where  there  may  be  a diverse mixture of computers --
  347.  micros,  personal  computers,  workstations,  laboratory   computers,
  348.  timesharing  systems  --  from a variety of manufacturers.  All these
  349.  systems need have in common is the ability to  communicate  in  ASCII
  350.  over ordinary serial telecommunication lines.
  351.  
  352.  KERMIT was originally designed at Columbia  University  to  meet  the
  353.  need  for  file  transfer between our DECSYSTEM-20 and IBM 370-series
  354.  mainframes and  various  microcomputers.   It  turned  out  that  the
  355.  diverse characteristics of these three kinds of systems resulted in a
  356.  design that was general enough to fit almost  any  system.   The  IBM
  357.  mainframe,  in  particular, strains most common assumptions about how
  358.  computers communicate.
  359.  
  360.  The KERMIT protocol is specifically designed  for  character-oriented
  361.  transmission  over serial telecommunication lines.  The design allows
  362.  for  the  restrictions  and  peculiarities  of  the  medium  and  the
  363.  requirements  of diverse operating environments -- buffering, duplex,
  364.  parity, character set,  file  organization,  etc.   The  protocol  is
  365.  carried  out  by KERMIT programs on each end of the serial connection
  366.  sending "packets" back and forth; the sender sends file  names,  file
  367.  contents,   and   control   information;  the  receiver  acknowledges
  368.  (positively or negatively) each packet.
  369.  
  370.  The packets have a layered design, in keeping with the ANSI  and  ISO
  371.  philosophies,  with  the outermost fields used by the data link layer
  372.  to verify data integrity, the next by the  session  layer  to  verify
  373.  continuity, and the data itself at the application level.
  374.  
  375.  Connections between systems are established by the ordinary user.  In
  376.  a  typical  case,  the  user  runs  KERMIT on a microcomputer, enters
  377.  terminal emulation, connects to a remote host  computer  (perhaps  by
  378.  dialing up), logs in, runs KERMIT on the remote host, and then issues
  379.  commands to that KERMIT to start a file transfer, "escapes"  back  to
  380.  the  micro,  and  issues commands to that KERMIT to start its side of
  381.  the file transfer.  Files may be transferred singly or in groups.
  382.  
  383.  Basic KERMIT provides only file transfer, and that  is  provided  for
  384.  sequential  files  only,  though  the  protocol attempts to allow for
  385.  various types of sequential files.  Microcomputer implementations  of
  386.  KERMIT are also expected to provide terminal emulation, to facilitate
  387.  the initial connection.
  388.  
  389.  More advanced implementations simplify the user interface somewhat by
  390.  allowing  the  KERMIT  on the remote host to run as a "server", which
  391.  can transfer files in either direction upon command  from  the  local
  392.  "user" Kermit.  The server can also provide additional functionality,
  393.  such as  file  management,  messages,  mail,  and  so  forth.   Other
  394.  optional  features  also  exist,  including  a variety of block check
  395.  types,  a  mechanism  for  passing  8-bit  data   through   a   7-bit
  396.  communication  link,  a  way  to  compressing  a repeated sequence of
  397.  characters, and so forth.
  398.  
  399.  As  local  area  networks  become  more  popular,  inexpensive,   and
  400.  standardized,  the  demand  for  KERMIT  and  similar  protocols  may
  401.  dwindle, but will  never  wither  away  entirely.   Unlike  hardwired
  402.  networks,  KERMIT  gives  the  ordinary  user  the power to establish
  403.  reliable error-free connections between any two computers;  this  may
  404.  always be necessary for one-shot or long-haul connections.
  405.  
  406. 1 LOCAL
  407.  
  408.  The LOCAL command can be used to prefix any Kermit command to  insure
  409.  that  the  command  so prefixed will be carried out by the user's own
  410.  kermit.  All commands are local by default  with  the  exceptions  of
  411.  BYE, FINISH,and GET.  The LOCAL command format is:
  412.  
  413.                 Kermit-11>LOCAL Kermit-command-name
  414.  
  415.  
  416. 1 LOGFILE
  417.  
  418.  The LOGFILE command creates the debug and session logging  file.   It
  419.  is identical to the SET LOGFILE command.
  420.  
  421.                 Kermit-11>LOGFILE FUBAR.LOG
  422.  
  423.  
  424. 1 Modems
  425.  
  426.  The question of how to set one's modem (if applicable) depends  on  a
  427.  number  of  factors.   For  this  discusion,  we  will  be limited to
  428.  considerations under RSTS/E (and to a limited degree, RSX and  P/OS).
  429.  This  discussion  is  relavent  to dialing out from an attached line.
  430.  Please note that the following comments will not be applicable to all
  431.  types of modems.
  432. 2 RSTS/E
  433.  
  434.  RSTS/E does not control modems signals in the manner that RSX or  VMS
  435.  does.   VMS  always  asserts  DTR  whereas RSTS/E will not assert DTR
  436.  until the terminal driver can see RCD (also known as  DCD)  which  is
  437.  pin  8  (eight) for the RS232 connection.  If the interface is a DH11
  438.  with full modem control, a cable with all signals connected will work
  439.  fine.   However,  if the interface is a DZ11 we have the problem that
  440.  the DZ has only partial modem control.   To  connect  directly  to  a
  441.  modem (like a VADIC 212, sorry, no DEC modems here) we must do one of
  442.  two things:
  443.  
  444.  (1) Force the modem (via strapping options or whatever) to assert RCD
  445.  (DCD)  pin  8, thus RSTS/E will see carrier and raise DTR (pin 20 for
  446.  RS232)
  447.  
  448.  (2)  Set  the  terminal  to  LOCAL  (RSTS/E  V9   syntax   'SET   TER
  449.  TTxx:/NODIAL/PERM') and break pin 20 (DTR) and connect pin 20 to 8 on
  450.  the modem side.  This will cause the modem to be able to dial out and
  451.  allow  RSTS/E to connect to it.  You will also need to have the modem
  452.  assert  RCD,  pin  8.   Keep  in  mind  that  the  Kermit-11  command
  453.  DISCONNECT  (or  HANGUP) will not function if a line is set to NODIAL
  454.  (INIT SET syntax 'LOCAL').  This has been tested  on  a  Racal  Vadic
  455.  VA212.
  456.  
  457.  For those of you who have port switches such  as  the  Gandalf  type,
  458.  there is one additional problem.
  459.  For Gandalf, suppose you want to connect a DZ11 line to to an  AMTB2.
  460.  You  will  have a problem, in that the Gandalf AMTB2 wants to see RCD
  461.  (DCD) asserted to make a connection.  What you  may  need  to  do  is
  462.  this:
  463.  
  464.         Make a cable for the DZ11 to AMTB2 port as follows:
  465.  
  466.         CPU side                        AMTB2 side
  467.                         20--|
  468.                         8---|-----------8
  469.                         7---------------7
  470.                         3---------------2
  471.                         2---------------3
  472.  
  473.         Note that 20 is tied to 8 on the CPU side.
  474.         Also, 2 is swapped for 3.
  475.  
  476.  Then, the Kermit-11 command SET DTR, which forces RSTS to  raise  DTR
  477.  for  30  seconds,  will  cause the DTR signal to loop back to the RCD
  478.  (DCD) signal and thus tell RSTS that there is  carrier  detect  which
  479.  will  raise DTR (the chicken or egg question) and get things rolling.
  480.  The Kermit-11 HANGUP (or DISCONNECT) command will drop DTR and  force
  481.  the modem to break the connection.
  482. 2 P/OS (Pro 3xx)
  483.  
  484.  Under P/OS the author has used (1) a DLV11 line in the 11/23+ at home
  485.  at 9600 baud without any modem signals, (2) a link using only 2,3 and
  486.  7 to a Racal Vadic 3212 (not an autodialer) and (3) a Gandalf  LDS125
  487.  modem.   In all cases there were no problems.  It would seem that the
  488.  PRO/350 comm port does not need the modem  signals.   This  will,  of
  489.  course,  mean  that  the  HANGUP  (or  DISCONNECT)  commands will NOT
  490.  function since DTR is not being passed.  Please note  that  you  must
  491.  ensure  that  pins  2  and 3 (RXD and TXD) are swapped if you are not
  492.  using some type of modem (one of the things a NULL modem  cable  does
  493.  ).
  494.  
  495. 2 RSX11M/M+
  496.  
  497.  The setting of the connected line (SET LINE  TTnn:)  depends  on  the
  498.  signals  that  the modem can assert (see HELP MODEM RSTS).  Since the
  499.  author does not run RSX on a system with modem lines (the  system  is
  500.  an  11/23+,  DLV11  lines), the command SET RSX TC.DLU value has been
  501.  added (though untested).  This command can be used to set the  TC.DLU
  502.  parameter to 1 or 2.  A value of one (1) (SET RSX TC 1) is normal for
  503.  remote  lines,  indeed,  it  is  the  result  of  the   MCR   command
  504.  SET/REMOTE=TTnn:.   However,  it may be the case that TC.DLU needs to
  505.  be set to two (2) (SET RSX TC.DLU 2).  If this SET command  is  used,
  506.  Kermit-11  will  alter it (if different from the current setting) and
  507.  wait five (5) seconds for the change to come into  effect.   This  is
  508.  only  applicable to modem controlled lines.  There is no way (at this
  509.  time) to change the TC.DLU setting to two via  MCR  or  DCL  commands
  510.  (perhaps we need a SET /DIALOUT=TTnn:).
  511.  
  512.  For more information, please consult K11USR.DOC
  513.  
  514. 1 MicroRSX
  515.  
  516.  Operation under MicroRSX is identical to that under RSX11M+ and,  for
  517.  the  most part, P/OS.  The image K11POS.TSK is used, as this image is
  518.  linked to the resident library RMSRES, thus allowing access to  named
  519.  directories under MicroRSX.
  520.  
  521. 1 QUIT
  522.  
  523.  The QUIT command will cause Kermit-11 to return to the command level.
  524.  This command is the same as the EXIT command.  The format is:
  525.  
  526.                 Kermit-11>QUIT
  527.  
  528.  
  529. 1 PARITY
  530.  
  531.  Sometimes two Kermit's may appear to be sending the  correct  packets
  532.  but  one or the other of them will constantly reject the same packet.
  533.  This usually will be seen when the requesting Kermit  asks  a  server
  534.  for a file and then rejects the server's first packet, doing so until
  535.  the retry threshold is reached.  This can often be caused  by  parity
  536.  being  introduced  somewhere,  and one or both of the Kermit's do not
  537.  know this.  This can happen when a modem is generating parity or when
  538.  a  private  or  public network is doing so.  Some Kermit's have a SET
  539.  PARITY command to assist in this.   If  the  communications  link  is
  540.  introducing  parity,  a simple fix is to tell each Kermit the command
  541.  SET PARITY SPACE.  This will  force  the  Kermit  program  to  always
  542.  remove  bit  7 from the incoming data.  Normally this will not affect
  543.  file transfer since  many  Kermit  implementations  support  what  is
  544.  called  eight  bit  prefixing, which is a method of encoding an eight
  545.  bit data item to fit over a seven bit link.  See HELP SET PARITY  for
  546.  more information.
  547.  
  548. 1 PRINT
  549.  
  550.  The PRINT command will cause the specified file(s) to be  printed  on
  551.  the  system  line  printer.   This  command  may  not function on all
  552.  systems.
  553.  
  554. 1 PRO/350
  555.  
  556. 2 RT11 version 5.1
  557.  
  558.  Kermit-11 runs under the RT11 version 5.1 XM  monitor  by  using  the
  559.  DIGITAL  distributed  XC  handler.   The  XC handler supports several
  560.  useful functions such as start/stop break, variable  size  reads  and
  561.  driver/line  reset.  Due to an apparent bug in the driver, Kermit has
  562.  to use flow control (XON/XOFF) to control the sending Kermit at  high
  563.  speeds  (9600 baud).  This has the undesireable effect of slowing the
  564.  transfer down by about 15 percent.  This is  enabled  by  typing  SET
  565.  RTFLOW ON.
  566.  As an alternative, the XC  handler  can  be  modified  to  avoid  all
  567.  problems  with  buffer  overflows  by  increasing  the buffer size in
  568.  XL.MAC.  See the file K11PRT.MAC for information regarding this.
  569.  
  570.  Note the the XC handler does not accept .SPFUN calls  to  change  the
  571.  baud  rate, rather, you must set it prior to entering Kermit-11 as in
  572.  SET XC:SPEED=9600.  The Kermit DISCONNECT command will not  function.
  573.  Kermit  will  always fake a SET LINE XC0:  at startup on the PRO/350.
  574.  Unlike the standard RT11 Kermit-11, you DO NOT need to  use  the  SET
  575.  RTFLOW ON command to enforce flow control during the CONNECT command.
  576.  The XC driver handles this automatically for you.
  577.  To send a BREAK  while  in  CONNECT  mode,  type  your  local  escape
  578.  character (normally a CTRL \) followed by a B.
  579.  
  580. 2 P/OS version 2.0
  581.  
  582.  Kermit-11 will run on under P/OS on the Pro/350, the executable  file
  583.  is  called K11POS.TSK.  It does NOT (and cannot) run from a menu, the
  584.  normal way to run it is via the RUN command in DCL.  It will  support
  585.  the Kermit-11 attribute packets, thus a PRO/350 connected to a PDP-11
  586.  host can transparently handle binary and other types of  files.   The
  587.  P/OS  Kermit-11  can  be  run  either  as  a local Kermit or a Kermit
  588.  server.  This has been tested under P/OS version 2 connected to  both
  589.  a PDP-11/23+ and PDP-11/70 RSTS/E host.
  590.  When Kermit-11 is started on the PRO, it will automatically do a  SET
  591.  LINE  XK0:   and  a  SET  SPEED 9600.  You can, of course, change the
  592.  speed to whatever you need with the  SET  SPEED  command.   The  line
  593.  should be left as XK0:.
  594.  
  595. 1 RECEIVE
  596.  
  597.  The RECEIVE command will put Kermit-11 into remote mode to wait for a
  598.  single  file  transfer  transaction.   Kermit-11 will wait for a file
  599.  transfer initialization from  the  other  kermit.   This  command  is
  600.  useful  if  the  other Kermit does not support local server commands.
  601.  Command format is:
  602.  
  603.                 Kermit-11>RECEIVE
  604.  
  605.  Please note that this version  of  Kermit-11  (Version  1)  does  NOT
  606.  support the RECEIVE command in the format:
  607.  
  608.                 Kermit-11>RECEIVE filename
  609.  
  610.  
  611. 1 REMOTE
  612.  
  613.  The REMOTE command is used as a prefix to indicate to Kermit-11  that
  614.  the  command  so  prefixed  is  to  be executed by the other (remote)
  615.  Kermit server.  Command format:
  616.  
  617.                 Kermit-11>REMOTE
  618.  
  619.  will return a prompt requesting a command name:
  620.  
  621.                 Remote Kermit cmd ?
  622.  
  623.  REMOTE can also be used with a command name as an argument:
  624.  
  625.                 Kermit-11>REMOTE command-name
  626.  
  627.  Please see HELP REMOTE command name for details and HELP  SERVER  for
  628.  general Kermit server operation.
  629.  
  630. 2 BYE
  631.  
  632.  The REMOTE BYE command will cause Kermit-11 (when in local  mode)  to
  633.  tell  the  other Kermit (which should be in server mode) to exit from
  634.  Kermit and if applicable terminate its job (or process, etc.).   When
  635.  Kermit-11  receives  the  acknowledgement that this is being done, it
  636.  will prompt for  another  command.   The  DISCONNECT  command  should
  637.  always  follow.   This  command  (REMOTE  BYE) is the same as the BYE
  638.  command.  The command format is:
  639.   
  640.                 Kermit-11>REMOTE BYE
  641.  
  642.  or
  643.  
  644.                 Kermit-11>REMOTE 
  645.                 Remote Kermit cmd ?BYE
  646.  
  647.  
  648. 2 COPY
  649.  
  650.  The remote copy is just like  the  local  copy  command  in  that  it
  651.  creates  a  copy  of  the  input file.  Like the local Kermit-11 COPY
  652.  command it does NOT support wildcards in the filename, and while COPY
  653.  does use multiblock buffering it is usually more efficient to use the
  654.  system utilty PIP or the DCL command COPY for this.   COPY  uses  RMS
  655.  block  i/o  for  both RSTS and RSX.  Any executable RSTS file (*.TSK,
  656.  *.BAC and *.SAV) copied will not  be  useable  until  it's  run  time
  657.  system name and protection code is reset.
  658.  
  659.                 Kermit-11>REMOTE COPY
  660.                 From: ABCDEF.DAT
  661.                 To  : FUBAR.LST
  662.  
  663.         or
  664.  
  665.                 Kermit-11>REMOTE COPY ABCDEF.DAT FUBAR.LST
  666.  
  667.  
  668. 2 CWD
  669.  
  670.  The REMOTE CWD command will cause Kermit-11 to  send  to  the  Kermit
  671.  server  the  new  default  directory.   If the server is a Kermit-11,
  672.  passwords are ignored.  See HELP CWD and HELP  SET  DEF  for  further
  673.  information.
  674.  
  675. 2 DIRECT
  676.  
  677.  The remote DIRECT command will tell the remote Kermit server to  send
  678.  a directory listing over the connection.  Not all Kermit servers have
  679.  this implemented.
  680.  
  681.                 Kermit-11>REM DIR *.MAC
  682.  
  683.  The above example would tell the remote server to  send  a  directory
  684.  listing of all files ending with a .MAC filetype.
  685.  
  686. 2 ERASE
  687.  
  688.  The remote ERASE command will tell the remote Kermit server to delete
  689.  any  files  matching the file specification.  For a Kermit-11 server,
  690.  this can include wildcard characters.
  691.  
  692.                 Kermit-11>REM ERASE *.MAC
  693.  
  694.                 Files deleted:
  695.                 SY:[2,2]FUBAR.MAC
  696.                 SY:[2,2]HLPSUB.MAC
  697.  
  698.                 Kermit-11>
  699.  
  700.  The remote Kermit server may respond with the filenames deleted,  the
  701.  above example is what a Kermit-11 server would respond with.
  702.  
  703. 2 FINISH
  704.  
  705.  The REMOTE FINISH command will tell Kermit-11 ,  which  is  in  local
  706.  mode,  to  signal  the  other  Kermit to exit from server mode.  When
  707.  Kermit-11 has received acknowledgement that this  is  being  done  it
  708.  will  prompt  for  another command.  REMOTE FINISH is the same as the
  709.  FINISH command.  The command format is:
  710.  
  711.                 Kermit-11>REMOTE FINISH
  712.  
  713.  or
  714.                 Kermit-11>REMOTE
  715.                 Remote Kermit cmd ?FINISH
  716.  
  717.  
  718. 2 GET
  719.  
  720.  The REMOTE GET command tells the remote Kermit  which  is  in  server
  721.  mode  to get a file or group of files.  REMOTE GET is the same as the
  722.  GET command.  The format for this command is:
  723.   
  724.                 Kermit-11>REMOTE GET
  725.  
  726.  or
  727.  
  728.                 Kermit-11>REMOTE
  729.                 Remote Kermit cmd ?GET
  730.  
  731.  
  732. 2 HELP
  733.  
  734.  The REMOTE HELP command instructs a remote Kermit server  to  send  a
  735.  list of remote commands that it can process.
  736.  
  737. 2 HOST
  738.  
  739.  The REMOTE HOST command sends the comamnd over to the  remote  Kermit
  740.  for  execution  on that system.  This is only currently supported for
  741.  version 8.0 of RSTS/E, and will be supported for RSX11M-Plus  in  the
  742.  near future.
  743.  
  744.                 Kermit-11>REM HOST SHO DEV
  745.  
  746.                 Busy Devices:
  747.                 Device      Job    Why
  748.                 KB12        18     AS
  749.                 PK0         29     Open
  750.                 PK1         8      AS
  751.                 PK2         5      AS+Open
  752.                 SH0         2      Open
  753.                 FE0         14     AS+Open
  754.                 
  755.                 Disk Structure:
  756.                 Dsk Open   Size    Free  Clu Err Name   Level  Comments
  757.                 DK1    0   4800   640 13%  4  0  BRIAN4  1.1   Pri, DLW, Lck
  758.                 DB0   23 171796 33944 19%  4  0  SYSPAC  1.1   Pub, DLW
  759.                 DB1    3 171796 15948  9%  4  0  WORK1   1.1   Pri
  760.                 DB2   53 131648  7344  5%  4  0  SYSLIB  1.1   Pri, DLW
  761.  
  762.                 Kermit-11>
  763.  
  764. 2 RENAME
  765.  
  766.  The remote RENAME command is used to rename a file or set  of  files.
  767.  RENAME is used with two arguments in the format:
  768.  
  769.                 Kermit-11>REMOTE RENAME oldname newname
  770.  
  771.  If the remote RENAME is used with one or no argument it  will  prompt
  772.  for missing arguments:
  773.                 Kermit-11>REMOTE RENAME
  774.                 From: oldname
  775.                 To:   newname
  776.  
  777.  When the remote RENAME is finished the remote Kermit server will most
  778.  likely return either a list of files renamed or a count of the number
  779.  of files renamed.  For a Kermit-11 server running remotely you  would
  780.  get a count of the number of files renamed.
  781.  
  782.                 Kermit-11>REMOTE RENAME t.* junk
  783.                 Remote ack: 3 files renamed
  784.  
  785.  
  786. 2 SPACE
  787.  
  788.  The REMOTE SPACE command sends a generic command to the remote Kermit
  789.  requesting information about the amounts of space available and space
  790.  used on the remote host.  Command format is:
  791.  
  792.                 Kermit-11>REMOTE SPACE
  793.  
  794.  or
  795.  
  796.                 Kermit-11>REMOTE
  797.                 Kermit Remote cmd ?SPACE
  798.  
  799.  
  800. 2 TYPE
  801.  
  802.  The REMOTE TYPE command is just like the TYPE command but it tells  a
  803.  remote Kermit server to get the file to be typed on your terminal and
  804.  send it over.
  805.  
  806.                 Kermit-11>REMOTE TYPE FUBAR.MAC
  807.  
  808.  
  809. 2 WHO
  810.  
  811.  The REMOTE WHO command instructs a remote Kermit  server  to  send  a
  812.  listing  of  who's  logged  into  the system.  This is currently only
  813.  operational for Kermit server running under RSTS/E.  Please note that
  814.  this command may be restricted by the system manager.
  815.  
  816.                 Kermit-11>REMOTE WHO
  817.  
  818.  
  819. 1 RENAME
  820.  
  821.  The RENAME command is used to rename a local (only) file.  RENAME can
  822.  be used with two arguments is the format:
  823.  
  824.                 Kermit-11>RENAME oldname newname
  825.  
  826.  If RENAME is used with one or no argument it will prompt for  missing
  827.  arguments:
  828.                 Kermit-11>RENAME
  829.                 From: oldname
  830.                 To:   newname
  831.  
  832.  When RENAME is finished it will return a  'report'  of  what  it  has
  833.  done:
  834.  
  835.                 Kermit-11>RENAME t.* junk
  836.                 File DB0:[1,8]T.T1 renamed to DB0:[1,8]JUNK.T1
  837.                 File DB0:[1,8]T.T renamed to DB0:[1,8]JUNK.T
  838.  
  839.  
  840. 1 RESTRICTIONS
  841.  
  842.  Prior to version 2.21, Kermit-11 did not support 8-bit prefixing.
  843.  Prior to version 2.23, Kermit-11 did  not  support  repeat  character
  844.  encoding.
  845.  The PRO/RT11 version of Kermit-11 will request 8-bit prefixing due to
  846.  the  fact  that  the XC handler does not support 8BIT data.  For most
  847.  Kermits this should not be a problem.  The XC handler  always  strips
  848.  bit  7  from  the  character  being  sent, so the PRO/RT11 version of
  849.  Kermit will request prefixing of such.   It  does  so  internally  by
  850.  setting PARITY to SPACE (always clear the high bit, bit seven).
  851. 1 RSTS
  852.  
  853.  Kermit-11 runs on version 7.2 or later of  RSTS/E.   Due  to  options
  854.  present  in  version  8,  binary  file transfers will not be possible
  855.  under version 7.2 of RSTS/E.  This is due to the use of  8  bit  mode
  856.  for  the  terminal link to allow all characters to be passed.  The so
  857.  called '8BIT' termianl setting  was  new  as  of  version  8.0-06  of
  858.  RSTS/E.
  859.  
  860.  Any RSTS/E system running Kermit-11 will need the sysgen  option  for
  861.  multiple  private  delimiters  in  the terminal driver.  This special
  862.  mode is needed since the 'normal' RSTS/E binary terminal mode  has  a
  863.  'feature'  that  disables binary mode whenever the terminal times out
  864.  on a read.  Since timeouts are essential to  Kermit  error  recovery,
  865.  binary mode can not be used for i/o.
  866.  
  867.  Certain functions  of  Kermit-11  require  that  the  system  manager
  868.  install  Kermit  with  temporary  priviledges, these commands are the
  869.  SYSTEM, WHO and REMOTE HOST commands.  Kermit-11 does NOT need  these
  870.  to operate correctly.
  871.  
  872.  Kermit-11 can only be built under RSTS/E version 8.0 or later due  to
  873.  the use of RMS-11 V2.0 and new assembler directives.
  874.  
  875. 1 RSX11M/M+
  876.  
  877.  Kermit-11 cannot be installed non-checkpointable due to  an  apparent
  878.  RMS-11 bug.  In other words, don't try to install the task '/CKP=NO'.
  879.  
  880.  To use the CONNECT command effectively, typeahead support  is  needed
  881.  in  the  terminal driver.  For RSX11M+, set the typeahead buffer size
  882.  high, as in SET /TYPEAHEAD=TT22:200.  Also, if your CONNECT  line  is
  883.  TT22:  (as above), use the mcr command SET /SLAVE=TT22:
  884.  
  885.  Kermit-11 can only be built under RSX11M version  4.1  or  later,  or
  886.  under  RSX11M-Plus version 2.1 or later due to the use of RMS-11 v2.0
  887.  and new assembler directives.
  888.  
  889.  There is a SET RSX command, see HELP SET RSX for further information.
  890.  
  891.  As a side issue, please note that the file K11POS.TSK is quite usable
  892.  under  RSX,  the  difference being that K11RSX.TSK has DECnet support
  893.  and RMS-11 overlayed in the task image (besides  which,  due  to  the
  894.  lack  author's systems running RSX may not be up to date) linked into
  895.  it, whereas K11POS has NO DECnet support but IS linked to the  RMS-11
  896.  library  RMSRES  (V2),  thus  K11POS  saves  disk  space  as  well as
  897.  supporting named directories, ala VMS style.
  898.  
  899. 1 RT11
  900.  
  901.   Kermit-11, as of version 2.20, has been tested  under  RT11  version
  902.  5.0  under the FB and XM monitors using a DZ11 line for the link, and
  903.  also on a PDT-150  using  the  modem  port  for  the  link.   It  has
  904.  additionally  been  run under Micro-11's and the PRO/350 using the XL
  905.  and XC handlers respectively.
  906.   As of Kermit-11 v2.39, RT11 users can use a SET LIN TT:, which  will
  907.  force  Kermit-11  to  use  the  CONSOLE  port  for  all I/O, with the
  908.  restriction that CONSOLE port I/O must request 8bit prefixing for the
  909.  transfer of BINARY data.  Additionally, if the RT11 system lacks both
  910.  MT service and the XL/XC handler, Kermit-11 will use the  console  by
  911.  default.
  912.  
  913.   Kermit-11 requires .TWAIT  support  as  well  as  multiple  terminal
  914.  support.   The  use  of multiple terminal support allows Kermit-11 to
  915.  use any type of interface sysgened, including  the  DZ11  and  DZV11.
  916.  The  exceptions  for  MT support and/or XC/XL support are noted above
  917.  regarding console only usage.
  918.   It is possible under version 5 of  RT11  to  use  the  XL:   handler
  919.  instead of the multiple terminal support.  The use of the XL:  driver
  920.  will result in much faster file transfer at high  baud  rates.   Note
  921.  that  XL:   must be set up at system startup or at some time later to
  922.  set the proper speed, CSR and vector.  For PRO/RT11 information,  see
  923.  HELP PRO RT11.
  924.  
  925.   Please note that the device name syntax for terminal  lines  follows
  926.  the  MT  unit  numbers, thus if a SHO TER gave unit 5 for DZ11 line 0
  927.  the the device name would be:
  928.  
  929.         Kermit-11>SET LINE 5
  930.  
  931.  If you must use the console port:
  932.  
  933.         Kermit-11>SET LIN TT:
  934.  
  935.  If you use the XL handler, you would do this:
  936.  
  937.         Kermit-11>SET LINE XL:
  938.  
  939.  Additionally, Kermit-11 for RT11 looks for its help file, K11HLP.HLP,
  940.  on DK:  first and then on SY:  if the first one fails.
  941.  
  942.  Full wildcarding is supported for RT11, in the form  *.type,  name.*,
  943.  *.* and the % character to match any single character.
  944.  
  945.  Kermit-11 can only be built on RT11 version 5.0 or later due  to  the
  946.  use of new assembler directives.
  947.  Please note that for the CONNECT command under RT11 and  the  use  of
  948.  the MT service, you will most likely need XON/XOFF flow control to be
  949.  generated by Kermit-11.  This is  enabled  with  the  SET  RTFLOW  ON
  950.  command.   This  is by default OFF since the modem the author uses, a
  951.  Vadic 212LS, can't handle XONs and XOFFs while in command mode.   The
  952.  solution  here  is  to  escape  back to Kermit command mode after the
  953.  remote system has been logged into, and then type SET RTFLOW ON.
  954.  
  955.  Due to overlaying constraints, the RT11  Kermit-11  will  not  accept
  956.  wildcards  for  the  RENAME and DELETE commands and the REMOTE server
  957.  equivalents.
  958.  
  959.  The executable files are K11XM.SAV for the XM system and PRO/350, and
  960.  K11RT4 for the FB system.
  961.  
  962.  For notes regarding hardware, see K11USR.DOC
  963.  
  964. 1 SEND
  965.  
  966.  The SEND command will allow the user to send a file(s) to  the  other
  967.  Kermit.  If Kermit-11 is running in remote mode the file will be sent
  968.  on the controlling terminal line after waiting the number of  seconds
  969.  specified  by  the  SET  DELAY  command.  This gives the user time to
  970.  escape to the other Kermit and issue a receive command.  If Kermit-11
  971.  is  running  in local mode , the file will be sent immediately on the
  972.  terminal line specified by the SET LINE command.  Format of the  SEND
  973.  command is:
  974.  
  975.                 Kermit-11>SEND file-specification
  976.  
  977.  Where 'file-specification' can include device, PPN, or UIC,  as  well
  978.  as the file-spec.  which may use wildcarding.
  979.  
  980. 1 SERVER
  981.  
  982.  The SERVER  command  will  put  Kermit-11  into  server  mode.   When
  983.  Kermit-11  is  in  server  mode  while  running  as  a  remote Kermit
  984.  (transmitting over the controlling terminal line)  the  other  Kermit
  985.  can issue server commands to send and receive files without having to
  986.  give SEND or RECEIVE commands to Kermit-11.  In  order  to  correctly
  987.  receive  binary files while in server mode a SET FILETYPE BINARY must
  988.  be done first.  At this  time  there  is  no  way  for  Kermit-11  to
  989.  determine  whether  an  incomming  file  is ASCII or binary.  Command
  990.  format is:
  991.  
  992.                 Kermit-11>SERVER
  993.  
  994.  
  995.   At this time, the Kermit-11 server can process the following
  996.   commands:
  997.  
  998.                 BYE             Logout Kermit-11.
  999.                 REMOTE COPY     Copy a file to another.
  1000.                 REMOTE DIR      Prints a directory out.
  1001.                 REMOTE DISK     Prints the disk  space.
  1002.                 REMOTE ERASE    Delete the filename(s).
  1003.                 FINISH          Exits Kermit-11 server.
  1004.                 GET             Sends  the filename(s).
  1005.                 REMOTE HELP     Prints this  help text.
  1006.                 REMOTE HOST     Execute a host command.
  1007.                 REMOTE RENAME   Rename old file to new.
  1008.                 REMOTE SPACE    Prints the disk  space.
  1009.                 REMOTE TYPE     Prints the filename(s).
  1010.                 REMOTE WHO      Shows users logged  in.
  1011.  
  1012.  
  1013.  
  1014. 1 SET
  1015.  
  1016.  The SET command is used to set various  parameters  in  Kermit.   The
  1017.  format of the SET command is:
  1018.  
  1019.                 Kermit-11>SET parameter keyword
  1020.  
  1021.  
  1022. 2 ATTRIBUTES
  1023.  
  1024.  Part of the Kermit  protocol  is  the  support  of  file  attributes.
  1025.  Connected  Kermits  that  support  this  can send information to each
  1026.  other about file size, time/date of creation, RMS  file  headers  and
  1027.  other  useful  things.   Due  to potential problems with incompatible
  1028.  implementations this feature can be  disabled.   In  this  case,  the
  1029.  sending Kermit-11 will never try to send file attributes, even though
  1030.  the receiver may have indicated that it supports this.
  1031.  
  1032.                 Kermit-11>SET ATTRIBUTES OFF
  1033.                 Kermit-11>SET ATTRIBUTES ON
  1034.                 Kermit-11>SET NOATTRIBUTES
  1035.  
  1036.  
  1037. 2 BAUD
  1038.  
  1039.  This is the same as SET SPEED.  See HELP SET SPEED
  1040.  
  1041. 2 BINARY-TYPE
  1042.  
  1043.  Kermit-11 has a default list of filetypes that are scanned to  decide
  1044.  if  a file should be sent in binary mode in addition to checking file
  1045.  attributes for RSX, P/OS and RSTS/E.  The user can, however,  overide
  1046.  this  list  with  the  this  command.   The  default  list  is fairly
  1047.  inclusive, with types such as .SAV and .TSK  forcing  Kermit-11  into
  1048.  binary transmission.  See HELP SET FIL for the default list.
  1049.  
  1050.         Kermit-11> SET BINARY-TYPE .SAV
  1051.         Kermit-11> SET BIN .EXE
  1052.  
  1053.  
  1054. 2 BLOCK-CHECK
  1055.  
  1056.  The SET BLOCKCHECK command is  used  to  determine  the  block  check
  1057.  sequence  which  will  be  used during transmission.  The block check
  1058.  sequence is used to detect  transmission  errors.   There  are  three
  1059.  types  of  block  check  available.   These  are the single character
  1060.  checksum  (default),  the  two  character  checksum,  and  the  three
  1061.  character  CRC  (cyclic  redundancy  check).   This  command does not
  1062.  ensure that the desired type of block check will be used, since  both
  1063.  Kermit's involved in the transfer must agree on the block check type.
  1064.  Kermit-11 will request that the type  of  block  check  set  by  this
  1065.  command be used for a transfer.  If the other Kermit has also had the
  1066.  same block check type requested, then the desired  block  check  type
  1067.  will be used.  Otherwise, the single character checksum will be used.
  1068.  The command should be given to BOTH Kermits since Kermit-11, when  in
  1069.  server  mode, has no say about what kind of checksum it wants to use.
  1070.  (See Kermit protocol manual for more information.)
  1071.  
  1072.             Kermit-11>SET BLOCK_CHECK keyword
  1073.            Kermit-11>SET BLO 1
  1074.            Kermit-11>SET BLO 2
  1075.            Kermit-11>SET BLO 3
  1076.  
  1077.  Where keyword is one of:
  1078.  
  1079.           1_CHARACTER_CHECKSUM or ONE_CHARACTER_CHECKSUM
  1080.  
  1081.           2_CHARACTER_CHECKSUM or TWO_CHARACTER_CHECKSUM
  1082.  
  1083.           3_CHARACTER_CRC_CCITT or THREE_CHARACTER_CRC_CCITT
  1084.  
  1085.  
  1086. 2 CONSOLE
  1087.  
  1088.  The SET CONSOLE command is used under P/OS to control the passing  of
  1089.  8  bit  data  to  th terminal during the CONNECT command.  If you are
  1090.  getting multinational characters being printed, this is a very useful
  1091.  thing to set.  The default is SET CON 7.
  1092.  
  1093.         Kermit-11>SET CON 8
  1094.         Kermit-11>SET CON 7
  1095.  
  1096.  
  1097. 2 DEBUG
  1098.  
  1099.  The SET DEBUG command is used  to  specify  the  type  and  level  of
  1100.  debugging  to a disk file .  This disk file must have been created by
  1101.  the SET LOGFILE command.  The format for SET DEBUG is:
  1102.  
  1103.                 Kermit-11>SET DEBUG qualifier
  1104.                 Kermit-11>SET NODEBUG
  1105.  
  1106.  
  1107. 3 ALL
  1108.  
  1109.  SET DEBUG ALL will turn on logging for CONSOLE, CONNECT, FILE, PACKET
  1110.  and STATE to the disk file specified by SET LOGFILE.  This command is
  1111.  the same as SET DEBUG ON.  The command format is:
  1112.  
  1113.                 Kermit-11>SET DEBUG ALL
  1114.  
  1115.  
  1116. 3 CONSOLE
  1117.  
  1118.  SET DEBUG CONSOLE will turn on logging for all I/O  during  a  remote
  1119.  CONNECT  to  the disk file specified by SET LOGFILE.  This command is
  1120.  the same as SET DEBUG CONNECT.  The command format is:
  1121.  
  1122.                 Kermit-11>SET DEBUG CONSOLE
  1123.  
  1124.  
  1125. 3 CONNECT
  1126.  
  1127.  SET DEBUG CONNECT will turn on logging for all I/O  during  a  remote
  1128.  CONNECT  to  the disk file specified by SET LOGFILE.  This command is
  1129.  the same as SET DEBUG CONSOLE.  The command format is:
  1130.  
  1131.                 Kermit-11>SET DEBUG CONNECT
  1132.  
  1133.  
  1134. 3 FILE
  1135.  
  1136.  SET DEBUG FILE will log all file 'opens' and 'creates'  to  the  file
  1137.  specified by SET LOGFILE.  The command format is:
  1138.  
  1139.                 Kermit-11>SET DEBUG FILE
  1140.  
  1141.  
  1142. 3 HELP
  1143.  
  1144.  SET DEBUG HELP gives the user a list of all qualifiers which  can  be
  1145.  used with SET DEBUG.  Command format is:
  1146.  
  1147.                 Kermit-11>SET DEBUG HELP
  1148.  
  1149.  
  1150. 3 NONE
  1151.  
  1152.  SET DEBUG NONE turns off all debugging.  This is the same as the  SET
  1153.  DEBUG OFF command.  Command format is:
  1154.  
  1155.                 Kermit-11>SET DEBUG NONE
  1156.  
  1157.  
  1158. 3 OFF
  1159.  
  1160.  SET DEBUG OFF turns off all debugging.  This is the same as  the  SET
  1161.  DEBUG NONE command.  Command format is:
  1162.  
  1163.                 Kermit-11>SET DEBUG OFF
  1164.  
  1165.  
  1166. 3 ON
  1167.  
  1168.  SET DEBUG ON will turn on logging for CONSOLE, CONNECT, FILE,  PACKET
  1169.  and STATE to the disk file specified by SET LOGFILE.  This command is
  1170.  the same as SET DEBUG ALL.  The command format is:
  1171.  
  1172.                 Kermit-11>SET DEBUG ON
  1173.  
  1174.  
  1175. 3 PACKET
  1176.  
  1177.  SET DEBUG PACKET will turn on logging of  all  receive  and  transmit
  1178.  packets  to  the  disk  file  specified  by SET LOGFILE.  The command
  1179.  format is:
  1180.  
  1181.                 Kermit-11>SET DEBUG PACKET
  1182.  
  1183.  
  1184. 3 STATE
  1185.  
  1186.  SET DEBUG STATE will turn on logging of all internal Kermit-11  state
  1187.  transitions
  1188.  
  1189. 2 DELAY
  1190.  
  1191.  The DELAY parameter is the number of seconds to wait  before  sending
  1192.  data  after  a SEND command is given.  This is used when Kermit-11 is
  1193.  running in remote mode to allow the user time to escape back  to  the
  1194.  other Kermit and give a RECEIVE command.
  1195.  
  1196.             Kermit-11>SET DELAY number-of-seconds
  1197.  
  1198.  Where number of seconds is the (decimal) number  of  second  to  wait
  1199.  before sending data.
  1200.  
  1201. 2 DEFAULT
  1202.  
  1203.  The DEFAULT parameter allows you to specify a device and UIC (or PPN)
  1204.  for  all  subsequent  file  opens (for SENDING) and file creates (for
  1205.  RECEIVING).  It is disabled by typing SET HOME.
  1206.  
  1207.                 Kermit-11>SET DEFAULT device
  1208.                 Kermit-11>SET DEFAULT DB2:[200,201]
  1209.  
  1210.  This is quite useful for Kermit-11 running on a DECnet link,  as  you
  1211.  can  set  the  default  for file operations to include node names and
  1212.  passwords as in:
  1213.  
  1214.                 Kermit-11>set def orion::sys$system:[fubar]
  1215.  
  1216.  
  1217. 2 DIAL
  1218.  
  1219.  The SET DIAL command is used to configure an undefined modem type  to
  1220.  enable  the  DIAL  command  to function.  Since the discussion of SET
  1221.  DIAL is quite involved, please consult the Kermit-11 User's Guide for
  1222.  further   information.   The  following  commands  are  supported  by
  1223.  Kermit-11 for the SET DIAL command:
  1224.  
  1225.                 Kermit-11>SET DIAL WAKEUP string
  1226.                 Kermit-11>SET DIAL WAKE_STRING string
  1227.                 Kermit-11>SET DIAL PROMPT string
  1228.                 Kermit-11>SET DIAL INITIATE string
  1229.                 Kermit-11>SET DIAL FORMAT string
  1230.                 Kermit-11>SET DIAL SUCCESS string
  1231.                 Kermit-11>SET DIAL INFORMATION string
  1232.                 Kermit-11>SET DIAL FAILURE string
  1233.                 Kermit-11>SET DIAL CONFIRM string
  1234.                 Kermit-11>SET DIAL WAKE_RATE delay
  1235.                 Kermit-11>SET DIAL DIAL_RATE delay
  1236.                 Kermit-11>SET DIAL DIAL_PAUSE string
  1237.  
  1238.  
  1239. 2 DUPLEX
  1240.  
  1241.  The DUPLEX parameter controls whether an outgoing link (set  via  the
  1242.  SET  LINE  command)  is  a  full  duplex link (the default) or a half
  1243.  duplex link.  All it does for half duplex is to cause all  characters
  1244.  typed after the CONNECT command to be echoed locally.
  1245.  
  1246.                 Kermit-11>SET DUPLEX HALF
  1247.                 Kermit-11>SET DUPLEX FULL
  1248.  
  1249.  
  1250. 2 END-OF-LINE
  1251.  
  1252.  The END-OF-LINE parameter sets the ASCII character which will be used
  1253.  as  a line terminator for all packets SENT to the other KERMIT.  This
  1254.  is normally not needed for most versions of KERMIT.
  1255.  
  1256.                 Kermit-11>SET END-OF-LINE octal-value-of-character
  1257.  
  1258.  
  1259. 2 ESCAPE
  1260.  
  1261.  This  command  will  set  the  escape  character  for   the   CONNECT
  1262.  processing.   The  command will take the octal value of the character
  1263.  to use as the escape character.  This is the character which is  used
  1264.  to  "escape"  back  to Kermit-11 after using the CONNECT command.  It
  1265.  defaults to control (octal 34).  It is usually a  good  idea  to  set
  1266.  this  character  to something which is not used (or at least not used
  1267.  very much) on the system being to which Kermit-11 is CONNECTing.
  1268.  
  1269.             Kermit-11>SET ESCAPE octal-character-value
  1270.  
  1271.  Where octal-character-value is the ASCII value of  the  character  to
  1272.  use as the escape character (in octal).
  1273.  
  1274. 2 FILETYPE
  1275.  
  1276.  This command will set the file type that Kermit is receiving.  A file
  1277.  type  of  ASCII  should be used to receive text files which are to be
  1278.  used as text files on the PDP-11 system.  The file type BINARY should
  1279.  be  used  for binary files, such as CP/M .COM files, which need to be
  1280.  kept in a format that allows the file  to  be  returned  without  any
  1281.  changes.
  1282.  
  1283.             Kermit-11>SET FILE_TYPE type
  1284.             Kermit-11>SET FIL BIN
  1285.  
  1286. 3 ASCII
  1287.  
  1288.  File type ASCII is for text files.
  1289.  
  1290. 3 AUTO
  1291.  
  1292.  Kermit-11 will normally try to decide if  a  file  must  be  sent  in
  1293.  binary  mode  based  on  the  file  attributes and filetype.  If, for
  1294.  instance, the directory entry for FUBAR.TXT showed it to be  RMS  (or
  1295.  FCS)  fixed  length records, Kermit-11 will switch to binary mode and
  1296.  send it verbatim.  If the receiving Kermit  is  Kermit-11,  then  the
  1297.  sending  Kermit  will  send  attribute data over also.  The following
  1298.  file types also will normally be sent as binary files unless you  use
  1299.  the SET FILE NOAUTO command.
  1300.  
  1301.                 *.TSK   ; rsx, ias, and rsts tasks
  1302.                 *.SAV   ; rt11 and rsts save images
  1303.                 *.OBJ   ; compiler and mac output
  1304.                 *.STB   ; tkband link symbol tables
  1305.                 *.CRF   ; tkb and link cross reference files
  1306.                 *.TSD   ; 'time shared dibol' for rt11
  1307.                 *.BAC   ; rsts basic+ 'compiled' files
  1308.                 *.OLB   ; rsx, ias, and rsts object libraries
  1309.                 *.MLB   ; rsx, ias, and rsts macro libraries
  1310.                 *.RTS   ; rsts/e run time systems
  1311.                 *.EXE   ; vms executable
  1312.  
  1313. 3 BINARY
  1314.  
  1315.  File type BINARY is for non-text files.  Note that binary files which
  1316.  are  generated  on  a  PDP-11 system cannot be transferred to another
  1317.  (non PDP-11) system without losing file attributes.  This means  that
  1318.  (for  example),  an  RMS-11  indexed  file cannot be transmitted with
  1319.  Kermit-11 at this time.  You can not have parity set to anything  but
  1320.  NONE  to  use  binary  file transfer (see HELP SET PARITY) unless the
  1321.  other  Kermit  can  process  eight  bit  quoting.   Two   Kermit-11's
  1322.  connected  to  each  other will use binary transmission automatically
  1323.  via the Kermit attribute packets, preserving file attributes where it
  1324.  makes sense (ie, RSTS/E and RSX only).
  1325.  
  1326. 3 FIXED
  1327.  
  1328.  SET FIL FIXED is the same as SET FIL BIN
  1329.  
  1330. 3 NOAUTO
  1331.  
  1332.  SET FILE  NOAUTO  disables  Kermit-11  from  trying  to  base  binary
  1333.  transmission mode on file attributes or filetype.
  1334.  
  1335. 3 PROTECT
  1336.  
  1337.  See HELP SET FILE SUPERCEDE for information.
  1338.  
  1339. 3 SUPERCEDE
  1340.  
  1341.  SET FILE [NO]SUPERCEDE allows Kermit-11 to  accept  or  reject  files
  1342.  received  (from  either  the  RECEIVE  or GET commands) on a per file
  1343.  basis.  The default is SUPERCEDE.   By  doing  SET  FILE  NOSUPERCEDE
  1344.  Kermit-11  will  always  check  to  see  if the file to be created is
  1345.  already there (independent of version number) and reject  it  to  the
  1346.  sending  server  if it exists.  This presumes that the Kermit sending
  1347.  the file understands the protocol to reject one file of a  (possibly)
  1348.  wildcarded group of files.
  1349.  The main use of this is to resume getting a group of files, as in GET
  1350.  KER:K11*.*  or  GET  KER:MS????.*  having  lost  the connection after
  1351.  transfering some of the files.   If  this  is  set,  then  any  files
  1352.  already transfered will not be transfered again.
  1353.  
  1354.         Kermit-11>SET FILE SUPERCEDE
  1355.         Kermit-11>SET FILE NOSUPERCEDE
  1356.  
  1357. 3 TEXT
  1358.  
  1359.  SET FIL TEXT is the same as SET FIL ASCII
  1360.  
  1361. 3 TYPE
  1362.  
  1363.  The SET FILE TYPE xxx command  is  the  same  as  the  SET  FILE  xxx
  1364.  command.   The  keyword  TYPE is ignored for compatibility with other
  1365.  implementations of Kermit.
  1366.  
  1367. 2 HANGUP
  1368.  
  1369.  SET HANGUP is the same  as  the  DISCONNECT  command.   It  forces  a
  1370.  connected  line  (specified  via the SET LINE command) to be dropped.
  1371.  This is currently only supported for RSTS version 8.
  1372.  
  1373.                 Kermit-11>SET HANGUP
  1374.  
  1375.  
  1376. 2 HOME
  1377.  
  1378.  SET HOME resets the default device and UIC (or PPN) to  nothing,  ie,
  1379.  all  file  opens and creates use your default disk (SY:) and your UIC
  1380.  (or PPN).
  1381.  
  1382.                 Kermit-11>SET HOME
  1383.  
  1384.  
  1385. 2 IBM-MODE
  1386.  
  1387.  The SET IBM ON (or OFF) will instruct Kermit-11 to wait for an XON
  1388.  following each packet sent to an IBM host. Since the default for IBM
  1389.  mode may not always be appropiate for your IBM compatible system, you
  1390.  can always use the SET HANDSHAKE XON and SET DUPLEX HALF to avoid the
  1391.  parity setting implied by using IBM mode.
  1392.  .lit
  1393.  
  1394.                 Kermit-11>SET IBM ON
  1395.                 Kermit-11>SET IBM OFF
  1396.  
  1397.  
  1398. 2 LINE
  1399.  
  1400.  The SET LINE command sets the terminal  name  up  for  use  with  the
  1401.  CONNECT  command.   To  use this you must have access to that device.
  1402.  On many systems terminal lines other than your own are protected from
  1403.  access, and may require special procedures to access them.
  1404.  The form of the device name is  TTnnn:,  where  'nnn'  is  a  decimal
  1405.  number  for  RSTS  and  an octal number for RSX11M/M+.  For RT11, the
  1406.  device name is simply the  MT  unit  number  shown  by  the  SHO  TER
  1407.  command,  as  in  '5'  for  DZ11  unit  0 line 4.  If you are running
  1408.  K11POS.TSK for P/OS on the PRO/350, Kermit-11 will set  the  line  to
  1409.  XK0:  and the speed to 9600 baud when Kermit starts.  To override the
  1410.  line or speed, set HELP SET LINE and HELP SET SPEED.
  1411.  As of Kermit-11 v2.39, RT11 users can use a SET LIN TT:,  which  will
  1412.  force  Kermit-11  to  use  the  CONSOLE  port  for  all I/O, with the
  1413.  restriction that CONSOLE port I/O must request 8bit prefixing for the
  1414.  transfer of BINARY data.  Additionally, if the RT11 system lacks both
  1415.  MT service and the XL/XC Kermit-11 will use the console by default.
  1416.  
  1417.                 Kermit-11>SET LINE TT55:        (for RSTS and RSX)
  1418.                 Kermit-11>SET LINE 5            (for RT11)
  1419.                 Kermit-11>SET LINE XK0:         (for P/OS)
  1420.                 Kermit-11>SET LINE XL:          (for RT11)
  1421.  See HELP CONNECT, HELP  SET  DUPLEX  and  HELP  SET  SPEED  for  more
  1422.  information.
  1423.  
  1424. 2 LOGFILE
  1425.  
  1426.  The SET LOGFILE command creates a debug dump file for you.   It  must
  1427.  be  used  BEFORE  any SET DEBUG commands can be used.  See HELP DEBUG
  1428.  for further information about debugging modes.
  1429.  
  1430.                 Kermit-11>SET LOGFILE MYLOG.TXT
  1431.                 Created debug file MYLOG.TXT
  1432.                 Kermit-11>
  1433.  
  1434.  
  1435. 2 MODEM
  1436.  
  1437.  The SET MODEM command is used to establish the type of modem you  are
  1438.  using  for  the  DIAL command.  If the type of modem is not currently
  1439.  supported, the DIAL command will not function.  As of  this  writing,
  1440.  27-Jan-85,  the  Racal  Vadic  VA212PA, VA212PAR, generic VA3400 with
  1441.  autodialler option, Digital  DF112,  MicroCom  SX1200,  Rixon  R212A,
  1442.  PRO/TMS  and  Hayes  modems  are supported.  The older VADIC 3212 and
  1443.  34xx modems with autodialing options should  also  function  via  SET
  1444.  MODEM  VADIC.   The following modems are defined.  The DF200 and DF03
  1445.  types have not been tested.
  1446.  
  1447.                 Kermit-11>SET MOD VA212PA
  1448.                 Kermit-11>SET MOD VA212PAR
  1449.                 Kermit-11>SET MOD VADIC   
  1450.                 Kermit-11>SET MOD DF03    
  1451.                 Kermit-11>SET MOD DF100   
  1452.                 Kermit-11>SET MOD DF200                           
  1453.                 Kermit-11>SET MOD HAYES                           
  1454.                 Kermit-11>SET MOD MICROCOM
  1455.                 Kermit-11>SET MOD R212A   
  1456.                 Kermit-11>SET MOD PROTMS                          
  1457.  
  1458.  
  1459.  An implcit SET MOD PROTMS is done if the line is XTn:  and the  modem
  1460.  type is undefined under P/OS on the PRO/350.
  1461.  
  1462. 2 PACKET-LENGTH
  1463.  
  1464.  You can alter the default transmitted  packet  length  with  the  SET
  1465.  PACKET-LENGTH command.  This should not normally be needed unless the
  1466.  line is very noisy, at which time you should probably give up anyway.
  1467.  
  1468.                 Kermit-11>SET PACKET 60
  1469.  
  1470.  
  1471. 2 PARITY
  1472.  
  1473.  This is used with the SET LINE and CONNECT commands  to  specify  the
  1474.  type  of  parity for the remote link.  It defaults to NONE and can be
  1475.  either ODD, EVEN, MARK or SPACE as in:
  1476.  
  1477.                 Kermit-11>SET PARITY NONE
  1478.                 Kermit-11>SET PARITY ODD
  1479.                 Kermit-11>SET PARITY EVEN
  1480.                 Kermit-11>SET PARITY MARK
  1481.                 Kermit-11>SET PARITY SPACE
  1482.  
  1483.  All parity generation is done via software, no  special  hardware  is
  1484.  used.   The  use of software parity generation is restricted to 8 bit
  1485.  links only.  The character format, if parity is set to  anything  but
  1486.  NONE, will be 7 bits of data followed with high bit set or cleared to
  1487.  indicate the parity.  If you set parity to  anything  but  NONE  (the
  1488.  default) you can NOT, at this time, send binary files.  Attempting to
  1489.  set parity if the FILETYPE is BINARY will result  in  an  error  (SET
  1490.  FILETYPE qualifier).
  1491.  
  1492. 2 PAUSE
  1493.  
  1494.  PAUSE tells Kermit to wait the specified number  of  seconds  between
  1495.  each packet being sent to the other Kermit.  This may be useful under
  1496.  situations of heavy system load.  This may be automatically  computer
  1497.  by Kermit-11 in a future release as a function of line speed.
  1498.  
  1499.                 Kermit-11>SET PAUSE 1
  1500.  
  1501.  
  1502. 2 PHONE
  1503.  
  1504.  Currently, the SET PHONE command supports the NUMBER option, as in:
  1505.  
  1506.                 Kermit-11>SET PHONE NUMBER WORK 5374411
  1507.  
  1508.  This allows Kermit to associate a tag name with a  phone  number  for
  1509.  the DIAL command; in the above example:
  1510.  
  1511.                 Kermit-11>SET MOD VADIC
  1512.                 Kermit-11>DIAL WORK
  1513.  
  1514.  This would cause Kermit-11 to translate WORK to 5374411 and dial  it.
  1515.  See the Kermit-11 User's Guide for further information.
  1516.  
  1517. 2 PROMPT
  1518.  
  1519.  The SET PROMPT command is useful if you are using two Kermit-11's  to
  1520.  talk  to each other.  By using the SET PROMPT command, you can change
  1521.  the prompt from 'Kermit-11>' on either (or both) Kermit to  something
  1522.  that would indicate which system you are currently connected to.
  1523.  
  1524.                 Kermit-11>SET PROMPT KERMIT-11/1170>
  1525.                 Kermit-11>SET PROMPT FUBAR>
  1526.                 Kermit-11>SET PROMPT PROKERMIIT-11>
  1527.  
  1528.  
  1529. 2 RANDOM
  1530.  
  1531.  This command allows Kermit-11 to randomly  generate  checksum  errors
  1532.  for  testing  error  recovery  of  an  attatched  Kermit.   You would
  1533.  normally never use this command.  Another command that goes  with  it
  1534.  is  called  SET  SEED  value  which  starts  the pseudo-random number
  1535.  generator at a different point.
  1536.  
  1537.                 Kermit-11>SET RANDOM ON
  1538.                 Kermit-11>SET RANDOM OFF
  1539.  
  1540.  
  1541. 2 RECEIVE
  1542.  
  1543.  Currently the SET RECEIVE and SET SEND basically  work  the  same  in
  1544.  that   they   only   alter   the   END-OF-LINE   character   and  the
  1545.  START-OF-PACKET value, as in:
  1546.  
  1547.                 Kermit-11>SET REC START 2
  1548.                 Kermit-11>SET REC END 12
  1549.  
  1550. 3 END-OF-LINE
  1551.  
  1552.  This instructs Kermit-11 to expect something other than  the  default
  1553.  carriage  return  (octal  15) at the end of a packet.  Kermit-11 will
  1554.  ignore packet terminators.  The SET SEND END command is of  more  use
  1555.  in conditioning outgoing packets.
  1556.  
  1557. 3 START-OF-PACKET
  1558.  
  1559.  The normal Kermit  packet  prefix  is  Control-A  (1);  this  command
  1560.  changes  the  prefix Kermit-11 expects on incoming packets.  The only
  1561.  reasons this  should  ever  be  changed  would  be:   Some  piece  of
  1562.  equipment  somewhere  between  the  two Kermit programs will not pass
  1563.  through a Control-A; or, some piece of of equipment similarly  placed
  1564.  is  echoing  its input.  In the latter case, the recipient of such an
  1565.  echo can  change  the  packet  prefix  for  outbound  packets  to  be
  1566.  different  from  that  of arriving packets so that the echoed packets
  1567.  will be ignored.  The opposite Kermit must also be told to change the
  1568.  prefix  for  its  inbound  packets and the prefix it uses on outgoing
  1569.  packets.
  1570.  
  1571.                 Kermit-11>SET REC START-OF-PACKET 2
  1572.  
  1573.  
  1574. 3 PACKET-LENGTH
  1575.  
  1576.  SET RECEIVE PACKET-LENGTH
  1577.  
  1578.  This command has two functions.  The first, and  normal  one,  is  to
  1579.  reduce  incoming packet lengths in the event that normal sized Kermit
  1580.  packets can not be passed through the communications circuit.   There
  1581.  could  be, perhaps, some 'black box' somewhere in the link that has a
  1582.  very small buffer size; this command could be used to reduce the size
  1583.  that the SENDING Kermit will use.
  1584.  
  1585.  The other use is to enable a new protocol extension to Kermit  called
  1586.  'LONG  PACKETS'.   The actual protocol is documented elsewhere, let's
  1587.  just say that this is a way for two Kermit's to use packet sizes  far
  1588.  greater  than  the normal ('Classic') packet size of 90 characters or
  1589.  so.  The main use of this feature is in file transfer over links that
  1590.  introduce considerable delay, it is not uncommon for packets to incur
  1591.  an one to two second delay.  The net result is a  VERY  slow  running
  1592.  Kermit with an effective speed of perhaps 300 to 600 baud rather than
  1593.  1200 or 2400 baud.  By  making  the  packets  longer,  we  raise  the
  1594.  effective  speed  of  such  a  circuit.   The main restriction on the
  1595.  packet size chosen is the link, a given  circuit  may  not  pass  500
  1596.  character packets.  Also, BOTH Kermits must support this extension to
  1597.  the protocol, they will always negotiate it before any file transfer.
  1598.  See the notes at the end of this document for more information.
  1599.  
  1600.                 Kermit-11>SET REC PAC 50
  1601.                 Kermit-11>SET REC PAC 600
  1602.  
  1603.  It is HIGHLY recommended that you use the CRC  block  check,  as  the
  1604.  default  type one checksum could be inadequate for such long packets,
  1605.  as in:
  1606.  
  1607.                 Kermit-11>SET BLO 3
  1608.  
  1609.  
  1610. 2 POS (P/OS on the PRO/350)
  1611.  
  1612.  The currently available options on the SET command  for  the  PRO/3x0
  1613.  under P/OS version 2 are:
  1614.  
  1615.         Kermit-11>SET POS DTE
  1616.         Kermit-11>SET POS NODTE
  1617.  
  1618.  The DTE option tells Kermit-11 to attempt to spawn PRO/Communications
  1619.  (DTE)  as  the  CONNECT  code; this allows the use of the 'grey keys'
  1620.  SETUP to set terminal emulation characteristics, and the use  of  the
  1621.  'EXIT'  key  to  return to the Kermit-11 command level.  The 'SET POS
  1622.  DTE' command enables the attempt to call PRO/COMM, whereas  the  'SET
  1623.  POS NODTE' enables the builtin terminal emulation.
  1624.  
  1625. 2 RECORD-FORMAT
  1626.  
  1627.  Kermit will,  by  default,  create  RMS-11  variable  length  implied
  1628.  carriage  control  records for text files.  You can override this and
  1629.  change it to create stream ascii records with the  SET  RECORD-FORMAT
  1630.  STREAM  command.   This is useful for RSTS/E systems if you need file
  1631.  compatibility with BASIC-Plus.
  1632.  
  1633.                 Kermit-11>SET RECORD-FORMAT STREAM
  1634.                 Kermit-11>SET RECORD-FORMAT VARIABLE
  1635.  
  1636.  This command would be most useful in  a  KERMIT.INI  file,  which  is
  1637.  executed by KERMIT when Kermit starts.
  1638.  
  1639. 2 RETRY
  1640.  
  1641.  SET RETRY value tells Kermit to try  that  many  times  on  a  NAK'ed
  1642.  packet  before  giving up.  This should only be needed if the line is
  1643.  extremely noisy or the PDP-11 host is running very slowly due to  the
  1644.  system load.
  1645.  
  1646.                 Kermit-11>SET RETRY 10
  1647.  
  1648.  
  1649. 2 RSX
  1650.  
  1651.  The SET RSX command is intended to deal with  the  peculiarities  oft
  1652.  found  with RSX systems.  There are currently three SET RSX commands,
  1653.  as in:
  1654.  
  1655.         Kermit-11>SET RSX FASTIO        Default for packet reading,
  1656.                                         waits for <CR>.
  1657.         Kermit-11>SET RSX CHARIO        Read one char at a time for
  1658.                                         packet reading.
  1659.         Kermit-11>SET RSX TC.DLU n      Alters  the TC.DLU setting.
  1660.         Kermit-11>SET RSX CONNECT ALT   Uses a new  (v2.33) CONNECT
  1661.                                         driver which bypasses TTDRV
  1662.                                         flow control.
  1663.         Kermit-11>SET RSX CONNECT DEF   Use old CONNECT code (2.32)
  1664.  
  1665. 2 RT11
  1666.  
  1667. 3 CREATE-SIZE
  1668.  
  1669.  The SET RT11 CREATE value command was  added  to  assist  those  RT11
  1670.  users  with  very  small  disks  to  be  able to get files with sizes
  1671.  greater that half of the availble contiguous space  availble.   While
  1672.  this  is  NOT a problem going from one Kermit-11 to another Kermit-11
  1673.  since the PDP-11 Kermit supports a subset of the  protocol  known  as
  1674.  'ATTRIBUTES',  other  Kermits  may  not  support the exchange of file
  1675.  sizes (most do not).  Thus if your largest contiguous  space  is  300
  1676.  blocks and you want to get a 250 block file, the command:
  1677.  
  1678.         Kermit-11>SET RT11 CRE 250
  1679.  
  1680.  would be needed, as RT11 by default only allocates 50 percent of  the
  1681.  available space.
  1682.  
  1683. 3 FLOW-CONTROL
  1684.  
  1685.  Note that for the CONNECT command under RT11  you  will  most  likely
  1686.  need  XON/XOFF  flow  control  to be generated by Kermit-11.  This is
  1687.  enabled with the SET RT11 FLOW command.  This is  by  default  NOFLOW
  1688.  since the modem the author uses, a Vadic 212LS, can't handle XONs and
  1689.  XOFFs while in command mode.  The solution here is to escape back  to
  1690.  Kermit command mode after the remote system has been logged into, and
  1691.  then type SET RT11 FLOW.
  1692.  The effect of SET RT11 FLOW is for Kermit-11, when in  CONNECT  mode,
  1693.  to send an XOFF to the host every eight characters.  When the loop in
  1694.  the CONNECT module finds no more data in the input buffer,  it  sends
  1695.  up  to  2 XON characters (in case the first XON got lost) to tell the
  1696.  remote system to start sending again.  The reason  for  doing  so  is
  1697.  that  the  RT11 multiple terminal service is very slow about handling
  1698.  input interupts and does not do any of it's  own  flow  control  when
  1699.  it's  internal  ring  buffer gets full.  This has been tested at line
  1700.  speeds up to 4800 baud without losing data.  This setting should  not
  1701.  be needed for use with the XC/XL handlers.
  1702.  SET RT11 FLOW has NO effect on packet transmission, since the  Kermit
  1703.  packet  size  is  never  mode  than 96 characters, and the RT11 input
  1704.  buffer is 134 chararcters in size.
  1705.  
  1706.                 Kermit-11>SET RT11 FLOW
  1707.                 Kermit-11>SET RT11 NOFLOW
  1708.  
  1709.  
  1710. 3 VOLUME-VERIFY
  1711.  
  1712.  Normally RT11 Kermit-11 will check the directory header of a disk  to
  1713.  verify  that  it  most  likely  contains  a valid RT11 file structure
  1714.  before trying to read the directory.  If for some  reason  your  disk
  1715.  does  not  contain  the  standard  data  at offset 760 in the header,
  1716.  Kermit-11 will reject the disk.  The  SET  RT11  NOVOL  command  will
  1717.  instruct Kermit-11 to bypass that check.
  1718.  
  1719.                 Kermit-11>SET RT11 VOL
  1720.                 Kermit-11>SET RT11 NOVOL
  1721.  
  1722.  
  1723. 2 SEND
  1724.  
  1725.  The SET SEND command  controls  what  Kermit-11  will  be  doing  for
  1726.  outgoing  packets in that you may want to alter the packet terminator
  1727.  and/or the start of packet character (by  default,  15  octal  and  1
  1728.  octal respectively.  See HELP SET RECEIVE for more information.
  1729.  
  1730. 2 SPEED
  1731.  
  1732.  SET SPEED value sets the line speed for the device specified via  the
  1733.  SET  LINE  command,  and  used for the CONNECT command.  Changing the
  1734.  speed of a terminal line requires privilege for RSTS  and  RSX11M/M+.
  1735.  The  SET SPEED command will only function with a DH11, DHV11, DZ11 or
  1736.  DZV11 multiline interface.
  1737.  
  1738.                 Kermit-11>SET SPEED 1200
  1739.  
  1740.  1200 Baud would be a normal speed to use with a VA212LS or a DF03.
  1741.  
  1742.  Please note that Kermit-11 CANNOT change the speed  of  a  DL11  type
  1743.  interface,  nor can it change the speed of a PDT-150 modem port.  For
  1744.  a PDT-150 modem port, use a command  of  /M/S:nnnn.   to  change  the
  1745.  speed to nnnn for the SPEED.SAV program.
  1746.  
  1747. 2 START-OF-PACKET
  1748.  
  1749.  The SET START octal-value tells Kermit-11 to expect and also to  send
  1750.  as  the  start of packet character the specified character instead of
  1751.  the default Control-A  (octal  1).   Note  that  both  Kermit's  must
  1752.  support  this  command (or SET RECEIVE/SEND START value) as it is not
  1753.  possible for two Kermit's to negociate this.  This set command is the
  1754.  same as doing both a SET REC START n and SET SEND START n.
  1755.  
  1756.                 Kermit-11>SET START 2
  1757.                 Kermit-11>SET START 1
  1758.  
  1759.  
  1760. 2 TIMEOUT
  1761.  
  1762.  The timeout value tells Kermit how long to wait to get a packet  from
  1763.  the  other  Kermit.  If system loads are high, it may be desirable to
  1764.  increase this beyond the default of 10 seconds.
  1765.  
  1766. 2 TERMINAL
  1767.  
  1768.  The SET TERMINAL command simply  controls  the  way  which  Kermit-11
  1769.  prints  packet  counts  while  send  or receiving a file (or group of
  1770.  files).  The simplest way is the default, SET TER TTY.  Using SET TER
  1771.  VT100  will  cause Kermit to display headers for the numbers printed,
  1772.  at a possible cost in packet speed due to screen control overhead.
  1773.  
  1774.                 Kermit-11>SET TER TTY
  1775.                 Kermit-11>SET TER VT100
  1776.  
  1777.  
  1778. 2 UPDATE
  1779.  
  1780.  The SET UPDATE command controls the frequency  at  which  the  packet
  1781.  count  display is updated.  The default is 1, displaying each packet.
  1782.  A SET UPD 0 will disable all packet count logs, whereas a SET  UPD  N
  1783.  will update the display every N packets.  The SET NOUPDATE command is
  1784.  the same as SET UPDATE 0.
  1785.  
  1786. 1 SHOW
  1787.  
  1788.  The SHOW command will display the settings made by  the  SET  command
  1789.  and allow you to look at session statistics.
  1790.  
  1791.                 Kermit-11>SHOW parameter
  1792.  
  1793. 2 ALL
  1794.  Displays everything:   BLOCK-CHECK     DEBUG           DEFAULT         ESCAPE
  1795.                         FILE-TYPE       LINE            PACKET          PARAM
  1796.                         TIME            VERSION
  1797.  
  1798. 2 BLOCK-CHECK-TYPE
  1799.  
  1800.  Displays the current type of checksum set.
  1801.  
  1802. 2 DEBUG
  1803.  
  1804.  Shows the status of debugging.
  1805.  
  1806. 2 DEFAULT
  1807.  
  1808.  Shows the device and UIC (or PPN) used for file operations.
  1809.  
  1810. 2 ESCAPE
  1811.  
  1812.  Shows the escape character used to return to a local Kermit-11
  1813.  
  1814. 2 FILE-TYPE
  1815.  
  1816.  Shows the current filetype (BINARY or ASCII)
  1817.  
  1818. 2 LINE
  1819.  
  1820.  Displays parameters associated with the current CONNECT line.
  1821.  
  1822. 2 PACKET
  1823.  
  1824.  Prints out packets statistics from the last transaction and total  so
  1825.  far.
  1826.  
  1827. 2 PARAMETERS
  1828.  
  1829.  Prints out various send parameters
  1830. 2 RECORD-FORMAT
  1831.  
  1832.  Shows what kind of file will be created by Kermit.
  1833.  
  1834. 2 TIME
  1835.  
  1836.  The time of day
  1837.  
  1838. 2 VERSION
  1839.  
  1840.  My current version and edit.
  1841.  
  1842. 1 STARTUP
  1843.  
  1844.  You can place a file called  KERMIT.INI  in  your  account  and  have
  1845.  Kermit-11 automatically read commands from it before getting commands
  1846.  from your terminal.
  1847.  
  1848. 1 SYSTEM
  1849.  
  1850.  The SYSTEM command takes a CCL/MCR/DCL command line and spawns a task
  1851.  to  execute it.  This is done via the SPWN$S directive for RSX and by
  1852.  spawning a job on a pseudo-keyboard for RSTS.  If the  command  fails
  1853.  for  RSTS  then  Kermits  protection  code  was  set  to  run without
  1854.  privileges.
  1855.  
  1856.                 Kermit-11>SYS PIP DB1:=FUBAR.DAT
  1857.                 Kermit-11>SYS
  1858.                 Command: SUB MYJOB
  1859.                 Kermit-11>
  1860.  
  1861.  
  1862. 1 TAKE
  1863.  
  1864.  The Take command is just like the @ command.  It opens  a  disk  file
  1865.  for reading commands from, as in TAKE filename.
  1866.  
  1867.                 Kermit-11>TAKE MYKERM.CMD
  1868.  
  1869.  
  1870. 1 TSX+
  1871.  
  1872.  Kermit-11 for TSX+ is exactly the same  Kermit  used  under  RT11/XM.
  1873.  Kermit-11  for RT11 always checks for the type of system it is on, be
  1874.  that RT11, PRO/RT11 or TSX+.  At run time, it will  dispatch  to  the
  1875.  correct overlay for doing terminal I/O (or XL/XC I/O).  Note that for
  1876.  TSX+, you can only dial out by using the XL  handler,  supplied  with
  1877.  version 5.  As far as system requirements go the author has been told
  1878.  that the sysgen parameter DINSPC in TSGEN.MAC mu st at least 100 (10)
  1879.  in  value, otherwise the terminal driver will be unable to buffer the
  1880.  entire received Kermit packet.  Since the author does not have or use
  1881.  TSX+,  any  problems  that arise on TSX+ will have to be fixed by the
  1882.  site's systems personel and reported back to the author.
  1883.  To use the CL:   handler  under  TSX+,  the  following  commands  are
  1884.  needed.  Please note that 'n' stands for a value, be it a unit number
  1885.  or a speed value.  In all  cases,  the  commands  are  KMON  commands
  1886.  unless shown with a Kermit-11> prefix.
  1887.  
  1888.         .SET CL LINE=n
  1889.         .SET CL NOLFOUT
  1890.         .SET CL SPEED=nnnn
  1891.         .ASS CLn XL
  1892.         .run kermit
  1893.         Kermit-11>SET LIN XL
  1894.  
  1895.  See HELP RT11 for more information that would also pertain to TSX+.
  1896.  
  1897. 1 TYPE
  1898.  
  1899.  The TYPE command prints a file to your terminal, as in:
  1900.  
  1901.                 Kermit-11>TYPE KERMIT.INI
  1902.  
  1903.  
  1904. 1 USAGE
  1905.  
  1906.  Kermit-11 is normally run on the PDP-11  host  system  as  a  server.
  1907.  This means that a remote Kermit can send it commands without the user
  1908.  having to be switching between the local Kermit (usually a micro) and
  1909.  the  remote Kermit (the one on the PDP-11).  While Kermit-11 supports
  1910.  most of the server commands shown in version Four revision 1  of  the
  1911.  protocol  manual  (see  HELP REMOTE), not all micro based Kermits are
  1912.  able to send these commands to Kermit-11.  Most  Kermits  do  support
  1913.  the  GET,  SEND, BYE and FINISH server commands, which are sufficient
  1914.  for most file transfers.  The following is an example of  the  dialog
  1915.  when  a  DEC  VT180  Robin connects to a PDP-11/70 RSTS system to use
  1916.  Kermit.
  1917.  
  1918.     A>b:
  1919.     B>a:cpmrob
  1920.     Kermit-80 V3.6 [VT180 "Robin"]
  1921.  
  1922.     Kermit-80  B:>connect
  1923.     [Connected to remote host, type Control-\C to return]
  1924.  
  1925.     LOG
  1926.     RSTS V8.0-07 U of Toledo 70 Job 12 KB25  17-Feb-84  03:31 PM
  1927.     User    # 2/2
  1928.     Password:
  1929.  
  1930.     Welcome to RSTS/E version 8.0
  1931.  
  1932.     $ kermit
  1933.     Kermit-11>server
  1934.     Kermit Server running on PDP-11 host. Please type your escape sequence
  1935.     to return  to your local machine.  Shut down the server by  typing the
  1936.     Kermit BYE command on your local machine.
  1937.  
  1938.     (the user now types Ctrl \C)
  1939.  
  1940.     Kermit-80  B:>get *.odl
  1941.         .
  1942.         . All files on the 11/70 with types of ODL are sent
  1943.         .
  1944.     Kermit-80  B:>bye
  1945.     B>
  1946.  
  1947.  See HELP SEND, HELP GET and HELP BYE for additional information.
  1948.  
  1949. 1 WHO
  1950.  
  1951.  The WHO command (currently for RSTS/E only)  prints  a  brief  SYSTAT
  1952.  out.
  1953.  
  1954.