home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / kermit / cp409doc.ark / CPKERM.TXT < prev    next >
Encoding:
Text File  |  1988-05-17  |  9.2 KB  |  264 lines
  1.  
  2.  
  3. CPKERM.MSG       08 Jan 1988
  4. **********
  5.  
  6. After  an incredibly long gestation peroid,  here is hopefully an 
  7. updated version of Kermit-80 V4.05. Kermit-80 V4.08 is issued for 
  8. testing  purposes  only.  Version  4.09 is the release  issue  of 
  9. version 4.08.  I still, however, want any feedback about problems 
  10. generated in this revision, or others desperately want fixing. 
  11.  
  12. Superficially,  there  is  little  real change  in  operation  of 
  13. Kermit-80,   version 4.05,   but there have been some major  jobs 
  14. tackled like trapping BDOS calls and multiple FCB buffering... 
  15.  
  16. New bits for this version include:
  17.      SET       {SEND/RECEIVE} START-OF-PACKET character
  18.      SET       DIRECTORY-FILE-SIZE (Shows or hides file sizes  on 
  19.                DIRectory displays)
  20.      SET       TERMINAL to  OFF,  VT52,  DUMB,  EXTERNAL,  QUIET, 
  21.                REGULAR.   External  is for those wanting to write 
  22.                their  own  drivers,  DUMB  passes  only  printing 
  23.                characters and sone control characters (eg CR/LF).  
  24.                QUIET/REGULAR    permits   brief/verbose    screen 
  25.                displays during transfers.
  26.      SET       USER to set other user spaces
  27.      RECEIVE   to collect a file from a remote SENDer
  28.      GET       to collect a file from a remote SERVER
  29.      SEND      {local filename} {remote filename}
  30.      TAKE      to  take command files from disk (including  other 
  31.                takes files!)
  32.      FCOPY     Copy CP/M files from within Kermit (no wildcard)
  33.      TYPE      Type a file to the console from within Kermit
  34.      PRINT     Print a file to the printer from within Kermit
  35.      -         updated  TRANSMIT command that waits for a  string 
  36.                of characters from the host (default is CR)
  37.      -         Command line commands, eg:
  38.                     KERMIT ;SET FILE BINARY;SEND FOO.BAR
  39.      -         automatic  TAKE  KERMIT.INI  on  default  disk  on 
  40.                loading KERMIT-80 (useful for SET BAUD etc.)
  41.      -         much improved speed on DIRECTORY 
  42.      -         automatic  CLOSE-ing of a terminal  connection  if 
  43.                the line is DROP-ped (currently only for an Apple, 
  44.                and  Torch  has  a  dummy test for  cntrl-]  D  in 
  45.                connect state)
  46.      -         improved  printer  handling.  (Kermit-80 sends  an 
  47.                XOFF to the host if the characters are comming  in 
  48.                faster  than they are printed.  This does not work 
  49.                in  this version,  as another  option,  SET  FLOW-
  50.                CONTROL  has not been fully implemented - also,  I 
  51.                did  not  have  a printer to test this  out  on  a 
  52.                Torch...) 
  53.  
  54. On the negative side,  only LASM and Microsoft M80 assemblers can 
  55. be used to assemble the source files. I personally see no pont in 
  56. being  able to support several assemblers if LASM can do the job, 
  57. but  then  again,  I have not used the MAC80  cross  assembler... 
  58. Comments on assembler compatabilities, please!
  59.  
  60. All  source  files  have  been  renamed,  and  there  are  a  few 
  61. additions. All source files are named in the form:
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69. CPaxxx.ASM
  70.  
  71. where:
  72.  
  73.      a=A for general information
  74.      a=S for system independent source files and hex file
  75.      a=X for system dependent source files
  76.      a=V for system-dependent hex files
  77.  
  78. The  system  dependent code has changed a  litle  too,  hopefully 
  79. bringing  the  CPXSYS.ASM (formerly CP4SYS.ASM) file a  bit  more 
  80. toward  a  manageable  size.  There is now  the  possibility  for 
  81. FAMILIES  of  systems,  like APPLE and NorthStar  (also  Comart), 
  82. which  contains  code  for computers of a  single  type.  I  have 
  83. immediately  gone against all this by creating a family with  the 
  84. code for Torches,  Cifers, Ithacas and Superbrains. (This because 
  85. we have these systems here at Loughborough) 
  86.  
  87. CPXSYS.ASM  is the "left over" systems not having a family to  go 
  88. to  (poor  things),  but is very much smaller than  the  original 
  89. CP4SYS.ASM.
  90.  
  91. All VDU and terminal information is now held in CPXVDU.ASM.  This 
  92. is really the last section in the older CP4SYS.ASM file.
  93.  
  94. A quick "schematic" of what happens at assembly time... (assuming 
  95. LASM is being used)
  96.  
  97. LASM CPXTYP... this then assembles the following:
  98.  
  99. CPXTYP
  100.  |
  101.  v
  102. CPSDEF
  103.  |
  104.  v
  105. CPXLNK
  106.  |
  107.  v
  108. CPXCOM (Common code for most systems)
  109.  |
  110.  v
  111. CPXSWT-------+----------+-----------+-----------+---- File selector
  112.  |           |          |           |           |
  113.  v           v          v           v       CPXTOR     CPXAPP      CPXNOR      CPX???    one of
  114.  |           |          |           |           |      several
  115.  |           |          |           |           |      Families
  116.  +<----------+----------+-----------+-----------+----
  117.  |
  118.  v
  119. CPXVDU   (if a terminal is required)
  120.  |
  121.  |
  122.  v
  123. <END of assembly>
  124.  
  125.  
  126.  
  127. Users  should  be  aware  of  the  change  both  to  the  linking 
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134. information and start of the overlay address. Since Version 4.05, 
  135. four new entries have been added to the overlay table.   First of 
  136. all,  family  (offset +6),  which is a two byte poiter to a text 
  137. string in the family file.   The remainder are two byte  pointers 
  138. (in  the usual JMP 0 format) to a print status  routne,  (lptstat 
  139. offset 20h),  an optional VDU driver, and a reverse entry back to 
  140. the  system independent BDOS routines (which does a lot more than 
  141. simply pass on the BDOS request to BDOS)
  142.  
  143. There  have  also  been some bugs fixed in  some  of  the  system 
  144. dependent code, so you would be wise pulling all the source files 
  145. across. 
  146.  
  147. The overlay address is now 6000h, and will probably change before 
  148. this  revision  is  complete.  The speeding up of  multiple  file 
  149. handling takes its toll on memory,  as there are now 64-ish  FCBs 
  150. buffered. This speeds up the DIRECTORY command no end. 
  151.  
  152. With  the overlay address at 6000h there is still a lot of  space 
  153. free for more things to be added,  so unless there is a big  hash 
  154. made to Kermit, this will not change.
  155.  
  156. Most  of  the  Version 4.05 documentation still  holds  for  this 
  157. version  of kermit-80.  Note however the changes in the number of 
  158. system dependent files used, and the use of FAMILY files. 
  159.  
  160. The  new  commands are  (hopefully)  self-explanatory.  The  TAKE 
  161. command  requires  files  TAKE-n to be pure ASCII  text,  with  a 
  162. control-z as the end of file marker.  Most editors will  probably 
  163. do this for you. 
  164.  
  165. LASM  and Microsoft M80 assembles are the only ones supported.  I 
  166. suggest LASM be used by default for all further development work, 
  167. though   I   DO  know  that  there  are  others   requestin   M80 
  168. comaptability.  
  169.  
  170. How to get V4.09 onto your system.
  171. **********************************
  172. If you alread have a Kermit running on your system, you should be 
  173. able  to  pull the CPSKER.HEX and suitable system file  to  yopur 
  174. system,  then MLOAD the two together.   If you dont have  kermit, 
  175. see  if you cannot get a copy from somewhere - it saves a lot  of 
  176. frustrating work.  Failing that, refer to the REAL manuals!
  177.  
  178. If  you  want  to assemble the sources from  scratch,  pull  all 
  179. CPS*.ASM  files,   and  CPX(TYP  LNK  COM  SWT).ASM  files,   and 
  180. CPXVDU.ASM  if you use a terminal.   You will have to  pluck 
  181. either  CPXSYS./ASM or another family file.   You will also  need 
  182. loads of disk space.   If you run short,  but have a handy IBM PC 
  183. or  clone  with a Mbyte or two free,  use the public  domain  Z80 
  184. emulator Z80MU to develop the .HEX files required.  Also aquire a 
  185. copy  of LASM.   Use LASM it to assemble CPSKER and CPXTYP  after 
  186. editing CPXTYP and selecting a suitable system.    This generates 
  187. CPSKER.HEX and CPXTYP.HEX.
  188.  
  189. MLOAD the two .HEX files together, eg: 
  190.  
  191. MLOAD NEWKER=CPSKER,CPXTYP
  192.  
  193. After this,  you will hopefully have a runnable copy of KERMIT-80 
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200. Version 4.09 on your system. 
  201.  
  202. Disclaimer:  No  responsibilty can be assumed by anyone as to the 
  203. suitabilty etc.etc.  In otherwords,  you are the one  responsible 
  204. for your implentation of Kermit-80, any version. I will give help 
  205. where I can,  but no guaranttes will be given.  Note that not all 
  206. systems  and  facilities  have  been tested (thats  why  you  are 
  207. getting  involved!) so make sure you have a copy of  4.05  Kermit 
  208. before trying this one! 
  209.  
  210. Things yet to be done - lots!
  211.  
  212. There have been moves trying to add other independent modules for 
  213. other terminal emulators other than the VT52. Demands for SERVER, 
  214. REMOTE HOST..., file compression, better TRANSMIT, % of file sent 
  215. and/or  Kbytes  sent/received  as  part  of  the  display  diring 
  216. transfers,  a  lot  of cosmetic tidying up as well as  even  more 
  217. systems  to be added.  CP/M-80 is a slowly dying DOS,  and I feel 
  218. inclined to leave some bits out, like SERVER (how many use really 
  219. large  Winchesters in CP/M-80 systems,  and want true  servers?). 
  220. Does  anyone have a burning desire for these facilities?  And  if 
  221. so, will YOU be willing to take on the job of implementing them? 
  222.  
  223. If you have any comments,  please E-mail them to  OBSchou (me) at 
  224. Loughborough.  If you really must, try (0509) 222313, but I share 
  225. a phone, so use the phone only if you cannot mail me. 
  226.  
  227. Best of luck, 
  228.  
  229. Bertil Schou.
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.