home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / d / k10v3.mem < prev    next >
Text File  |  2020-01-01  |  10KB  |  200 lines
  1.  
  2.  
  3.  
  4. The following reflects Kermit-10 version 3(123).
  5.  
  6.                      New features and changes in Kermit-10
  7.                      -------------------------------------
  8.  
  9. There have been a number of new features which have been added to Kermit-10.
  10.  
  11.      1.  The "SET PROMPT xxx" command has been added.
  12.  
  13.      2.  When running as a user Kermit  (i.e.,  talking  to  a  server),  it  is
  14.          possible  to  access  all  of  the  generic  command  functions (REMOTE
  15.          commands) that were specified in edition 4 of the protocol manual.
  16.  
  17.      3.  When Kermit-10 is running as a remote Kermit (i.e., transferring over a
  18.          terminal  other than the controlling terminal line), typing a control-A
  19.          will give  a  single  status  line,  typing  a  control-D  will  toggle
  20.          debugging  on or off, and typing a carriage return will force a timeout
  21.          (usually causing a NAK or retransmission).
  22.  
  23.      4.  There is now a SET SERVER-TIMER command to set the period for  NAKs  to
  24.          be  sent  when  the  server is idle.  If this value is set to zero, the
  25.          server will only send out NAKs if it receives a bad message.   This  is
  26.          useful when the Kermit on the other end cannot clear its buffers.
  27.  
  28.      5.  It is now possible to assign a terminal other than the jobs controlling
  29.          terminal as the default device for file transfers.  If the logical name
  30.          "KERMIT" is assigned to a terminal, that terminal will be  the  default
  31.          device for all transfer operations (and for the CONNECT command).  This
  32.          acts as if a "SET LINE KERMIT:" command was given upon startup.
  33.  
  34.      6.  Kermit-10 should now work correctly on non-network systems.
  35.  
  36.      7.  A few bugs in wild-card file specification processing have been  fixed.
  37.          Kermit-10  should  now  handle  pathological  and  ersatz  device names
  38.          correctly.
  39.  
  40.      8.  A TAKE command has been added.  Note that a file being  "TAKEn"  cannot
  41.          contain TAKE commands, since OPRPAR does not handle more than one level
  42.          of indirection.
  43.  
  44.      9.  A DEFINE commands has been added.  This allows macros to be defined for
  45.          collections of setable parameters.  Any items which can be SET with the
  46.          SET command can be used within a macro definition.  Commas are used  to
  47.          separate  parameters.   The  SET  command  can  also  now take multiple
  48.          parameters separated by commas.
  49.  
  50.     10.  The SET FILE-BYTE-SIZE and SET FILE-WARNING commands have been  changed
  51.          to  SET  FILE BYTE-SIZE and SET FILE WARNING.  This is both to make the
  52.          commands easier to type (SET F B instead of SET FILE-B), and  to  allow
  53.          for  the  new  command  SET FILE NAMING.  The new command specifies how
  54.          file names being sent and received are to  be  treated.   The  possible
  55.          arguments are:
  56.  
  57.          1.  FULL-FILE-SPECIFICATION - include the device name and path  in  any
  58.              file  name  being  sent.  When receiving a file name, do not do any
  59.              special processing on the name before trying to use it  as  a  file
  60.              name.
  61.  
  62.          2.  NORMAL-FORM - include only the file name and extension  (no  device
  63.              or path) in any file name being sent.  Convert any non-alphanumeric
  64.              characters to "X".  When receiving a  file  specification,  convert
  65.              any non-alphanumeric characters to "X".
  66.  
  67.          3.  UNTRANSLATED - include  only  the  file  name  and  extension  when
  68.              sending  a file name, do not change any characters in the file name
  69.              or extension.  When receiving a file specification, do not  do  any
  70.              special processing on the name before trying to use it.
  71.  
  72.  
  73.     11.  The KL10 only instructions  (ADJBP's)  have  been  replaced  with  more
  74.          acceptable  ones.   This  should  make  Kermit-10  run on KI10s without
  75.          problems.
  76.  
  77.     12.  When running as a server Kermit, some of the generic command  functions
  78.          are processed.  The following generic server commands (REMOTE commands)
  79.          are supported in server mode (and as LOCAL commands):
  80.  
  81.          1.  CWD - Change working directory.  The default path for the job  will
  82.              be  set to the path supplied as an argument.  Any password supplied
  83.              is ignored.  If no arguments are supplied, the default path is  set
  84.              to  that  which  was  in  effect  when  Kermit-10  was started (not
  85.              necessarily the user's PPN).
  86.  
  87.          2.  DELETE/ERASE - Delete files.  The files specified by the  (possibly
  88.              wildcard)  file  specification supplied as an argument are deleted.
  89.              For each file that matches the file  specification  Kermit-10  will
  90.              reply with the file specification and size of file (in blocks).
  91.  
  92.          3.  DIRECTORY -  List  directory.   The  files  which  match  the  file
  93.              specification  supplied  as an argument are listed along with their
  94.              size (in blocks) and their creation dates.
  95.  
  96.          4.  HELP - Give help message.  Kermit-10 will reply with a help message
  97.              indicating  which  server  commands  are  supported,  and  what the
  98.              arguments should be.  Any argument to the HELP command are ignored.
  99.  
  100.          5.  SPACE - Show disk space usage.  Kermit-10 will reply with a message
  101.              indicating  the  amount  of  space in use and amount remaining with
  102.              respect to logged in and logged out quotas, and  total  free  space
  103.              remaining  on  the  structure.  If no argument is given, the values
  104.              will be listed for all structures for the user's PPN.
  105.  
  106.          6.  STATUS - Status of Kermit-10.  Kermit-10 will reply with a  message
  107.              that indicates the amount of data that has been sent or received.
  108.  
  109.          7.  TYPE - Type a file or files.  The file specification  supplied  may
  110.              be wild-carded.
  111.  
  112.  
  113.     13.  The LOG command has  been  added  to  support  log  files.   There  are
  114.          currently  two types of log files implemented - SESSION and DEBUG.  The
  115.          SESSION log is used in connection with the CONNECT command to  log  all
  116.          characters which are being typed on the user's terminal.  The DEBUG log
  117.          is used for debugging output (when  debugging  is  enabled).   The  LOG
  118.          DEBUG  command is an alternative to the previous SET DEBUGGING-LOG, but
  119.          does not enable debugging output.  With both types of  log  files,  the
  120.          user  may specify whether the file should supersede an already existing
  121.          file by the same name, or append to it.  Since Kermit-10 only opens the
  122.          file  during  either  a  connect  session  (the  SESSION log) or a file
  123.          transfer transaction (the DEBUG log), it will switch  to  appending  to
  124.          the file after it has initially opened it.
  125.  
  126.  
  127.                                  Kermit Sources
  128.                                  ------ -------
  129.  
  130. The following describes the various source files which make up  Kermit-10.   The
  131. names used are those which are normally used when Kermit-10 is distributed along
  132. with other Kermits.  Before using these files, the "K10" prefix must be  changed
  133. to "KER" (i.e., K10MSG.MAC ==> KERMSG.MAC).  Note that the .BLI files are common
  134. to  Kermit-10,  VAX/VMS  Kermit-32,  and  Pro/Kermit.   In  certain  cases,  the
  135. K10xxx.BLI  files  may  only contain a pointer to the actual file containing the
  136. full source (for example, K10MSG.BLI may say "The complete source may  be  found
  137. in VMSMSG.BLI.").
  138.  
  139. Common BLISS source modules:
  140.  
  141.      1.  K10TT.BLI - Common BLISS source for the terminal text  output  support.
  142.          This module produces K10TT.MAC.
  143.  
  144.      2.  K10GLB.BLI - Common BLISS source for the global storage for K10MSG.BLI.
  145.          This module produces K10GLB.MAC.
  146.  
  147.      3.  K10MSG.BLI - Common BLISS source  for  the  protocol  handling  module.
  148.          This module produces K10MSG.MAC.
  149.  
  150.      4.  K10COM.REQ - Common BLISS require file  which  defines  various  common
  151.          parameters.   This  is required by K10MSG.BLI.  This must be renamed to
  152.          KERMSG.BLI.
  153.  
  154. The following files are specific to Kermit-10:
  155.  
  156.      1.  K10UNV.MAC -  Definitions  of  common  symbols.   Must  be  renamed  to
  157.          KERUNV.MAC.
  158.  
  159.      2.  K10MIT.MAC - Command  parser,  basic  support  routines  for  file  and
  160.          terminal I/O.
  161.  
  162.      3.  K10WLD.MAC - Wild-card file processor (derived from WILD).
  163.  
  164.      4.  K10SYS.MAC - System interface routines.  This contains system dependent
  165.          routines for K10MSG for handling various server commands.
  166.  
  167.      5.  K10MSG.MAC - Protocol handling module.  This is  actually  produced  by
  168.          BLISS-36 from K10MSG.BLI.
  169.  
  170.      6.  K10MSG.MAI - KI10 verison of K10MSG.MAC.  This contains  no  KL10  only
  171.          instructions.
  172.  
  173.      7.  K10GLB.MAC - Global storage used by the message processing.
  174.  
  175.      8.  K10ERR.R36 - BLISS-36 require file needed by K10MSG.BLI to  define  the
  176.          error  codes  passed  between  the  protocol  module  and  the  rest of
  177.          Kermit-10.  This file must be renamed to KERERR.R36.
  178.  
  179.      9.  K10TT.MAC - Terminal text output  support  routines  for  the  protocol
  180.          module.    This   are  used  for  debugging  output  as  well  as  file
  181.          specification and packet number typeout.  This  file  is  generated  by
  182.          BLISS-36 from K10TT.BLI.
  183.  
  184.     10.  K10TT.MAI - KI10 version of K10TT.MAC.
  185.  
  186.     11.  K10MIT.RNH - RUNOFF (DSR) source for Kermit-10 help file.
  187.  
  188.     12.  K10MIT.HLP - Help file for Kermit-10.  This is formatted for the OPRPAR
  189.          help subroutine.
  190.  
  191.     13.  K10MIT.CCL - Command file for Link-10 to load Kermit-10.
  192.  
  193. The following files are included only if the distribution  path  supported  full
  194. 36-bit binary files.
  195.  
  196.      1.  K10MIT.EXE - Executable version of Kermit-10 for KL10 based systems.
  197.  
  198.      2.  K10KIT.EXE - Executable version of Kermit-10 for KI10 based systems.
  199.