home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / c / ucjlm2.doc < prev    next >
Text File  |  2020-01-01  |  5KB  |  105 lines
  1.  
  2.  
  3.     M2 KERMIT is  a modification of KERMIT  UCSD (UCMICRO version
  4.     by  Tim Shimeall  of the  University of  California, Irvine ,
  5.     which in turn is a  modification of UCTERAK by Kate MacGregor
  6.     of Cornell University). M2 KERMIT  was created by Henry Balen
  7.     of  Lancaster University,  Lancaster to  run on  a Magiscan 2
  8.     image  processing  system (made  by  Joyce  Loebl). Like  the
  9.     previous version this is written entirely in UCSD Pascal, and
  10.     minor changes were needed in  the translation from UCMICRO to
  11.     M2 KERMIT.  This version  does have  a few  machine dependant
  12.     features but these are in seperate units.
  13.  
  14.     The following files make up M2 KERMIT;
  15.  
  16.        BINUTILS.TEXT
  17.        DISK.TEXT
  18.        FILEUNIT.TEXT
  19.        HELP.TEXT
  20.        KERMIT.TEXT
  21.        PARUNIT.TEXT
  22.        RECSW.TEXT
  23.        RS232.TEXT
  24.        RSUTILS.TEXT
  25.        SENDSW.TEXT
  26.        SYSUNIT.TEXT
  27.        UTILS.TEXT
  28.        HANDLE.TXT
  29.     All these files have UCJ  prefix on front in the distribution
  30.     directory, with the first 3 characters of their names following.
  31.     The    files    DISK.TEXT,    FILEUNIT.TEXT,    PARUNIT.TEXT,
  32.     SYSUNIT.TEXT are separately compiled  units (modules) for use
  33.     by the main program KERMIT.TEXT;  the rest are the text files
  34.     that make up M2KERMIT.
  35.  
  36.     The  Magiscan  2   does  not  have  the   capability  to  use
  37.     interrupts, so this  version is like the  UCMICRO version and
  38.     makes  use of  polling. Unlike  the microengine  the Magiscan
  39.     does  have  enough memory  so  the  command parser  has  been
  40.     'reconverted'  from   a  "segment  procedure"  to   a  "unit"
  41.     (PARUNIT.TEXT). So far the time  out mechanism is the same as
  42.     for the  microengine; I  hope to make  use of  the Magiscan's
  43.     internal clock in  a future version. There are also  a few of
  44.     other units  which are machine dependant:  The RS232, SYSUNIT
  45.     and  the  DISK  unit;  the latter  was  written  because  the
  46.     Magiscan's  Image load  and  save routines  didn't cope  with
  47.     eight bit images, that was solved in this unit. Though a word
  48.     of warning has to inserted here, DO NOT KRUNCH AN IMAGE FILE,
  49.     the UCSD filer on the magiscan seems to upset the way I store
  50.     the images i.e. they lose a bit.
  51.  
  52.     M2 KERMIT has the following limitations:
  53.  
  54.     a) No wild card designations of file names
  55.     b) No character repeat counts
  56.     c) No  '?' and <esc> at the end of a command line.
  57.     d) No server communications
  58.     e) Only one  file is sent at  a time (a break  packet is sent
  59.     after each file).
  60.  
  61.  
  62.  
  63.  
  64.     KERMIT M2 has been thoroughly  tested in connections with VMS
  65.     and BBC KERMIT, but errors  may persist. In particular, since
  66.     there  are  no interrupts  in  this  version, characters  may
  67.     occasionally  be  lost.  Character  loss  was  observed  with
  68.     transfers from the BBC and the MUX  delay had to be set to >=
  69.     4; this enabled a wait between transmision of characters from
  70.     the BBC. A  way round this would be to  implement the receive
  71.     and send  packet routines in  machine code, and  possibly the
  72.     terminal emulator, this would speed  up the polling and hence
  73.     reduce the likelyhood of character loss.
  74.  
  75.     The commands recognized by KERMIT  M2 are a superset of those
  76.     for  KERMIT UCMICRO.  I shall  give the  descriptions of  the
  77.     commands that  I have added and  you should refer  to UCMICRO
  78.     and TPKERM for the rest:
  79.  
  80.      SET BAUD  <rate>: this command enables  the user to  set the
  81.     Baud rate,  the value  of <rate> can  be examined  by doing a
  82.     SHOW BAUD (or a SHOW ALL).
  83.  
  84.      SET DISK  <vol>: this  command enables the  user to  set the
  85.     work disk to any valid  UCSD block device (i.e #4,#5,#9,#10),
  86.     the value  of <vol> should be  any of the  following 4,5,9,10
  87.     dependant on  which devices your machine  has available. This
  88.     can also be examined by use of the SHOW command.
  89.  
  90.      DIRECTORY: this  command gives the directory  of the current
  91.     work disk, it gives an extended directory listing.
  92.  
  93.      DELETE <filename>: this command deletes the given <filename>
  94.     from the work disk.
  95.  
  96.      TRANSFER TYPE  <type>: this tells  KERMIT what type  of file
  97.     transfer is going to take place, the choice of transfer types
  98.     are TEXT,  DATA, CODE, IMAGE. The  first is the  default, for
  99.     IMAGE types an image has to be loaded using the LOAD command.
  100.  
  101.      LOAD  <filename>: this  loads an  image (called  <filename>)
  102.     from the  work disk, this  can only  be done if  the transfer
  103.     type is IMAGE.
  104.  
  105.