home *** CD-ROM | disk | FTP | other *** search
/ Columbia Kermit / kermit.zip / pckermit / pcboothlp.txt next >
Text File  |  2020-01-01  |  5KB  |  115 lines
  1. [Excerpt from the Kermit User's Guide]
  2.  
  3. 4.5. 8086/8088
  4.  
  5. Kermit-86  is written in 8086 Macro Assembler (ASM86), and assembled locally on
  6. the micro.  Versions for the IBM PC (PC DOS) and the Heath/Zenith Z100 (MS DOS)
  7. are prepared from common source using conditional assembly switches similar  to
  8. those  in KERMIT-80.  The IBM flag has site-dependent meaning.  As shipped from
  9. Columbia, it means local echo during CONNECT, mark parity, and half duplex line
  10. handshaking using CTRL-Q as the turnaround character.  If you need  to  install
  11. Kermit  on  your PC, and you do not have a Kermit floppy but you do have access
  12. to a mainframe computer with a copy of the  IBM  PC  Kermit  distribution,  you
  13. should read this section.
  14.  
  15. Since  the  PC  assembler is not provided with the minimum system, IBM PC users
  16. cannot be expected to have it.  Assembler  source  plus  the  runnable  version
  17.                                  16
  18. (.EXE)  of Kermit are distributed  , along with some special "bootstrap" files,
  19. described below.
  20.  
  21.  
  22. 4.5.1. Bootstrapping
  23.  
  24. The KERMIT.EXE file is converted by an assembler program on the PC, KFIX, which
  25. makes all bytes in the file printable by breaking each one up  into  two  4-bit
  26. "nibbles"  and  adding  a  constant.    The  result  is a printable file called
  27. KERMIT.FIX.  It is assumed that a copy of KERMIT.FIX is available to you  on  a
  28. mainframe  computer.   To download the file to the PC, two cooperating programs
  29. are run: a Fortran program, KSEND, on the mainframe and a Basic program,  KGET,
  30. on  the  PC.    These programs are very short; they are shown in their entirety
  31. below.  KSEND reads a line at a time from KERMIT.FIX, types the line, and waits
  32. for a signal from KGET that it can send more data.  KGET reads  each  line  and
  33. converts  the text back to the format of an executable (.EXE) file.  Here's the
  34. procedure:
  35.  
  36.  
  37. _______________
  38.  
  39.   16
  40.     The PC assembler's object (.OBJ) files are not  printable,  like  CP/M  hex
  41. files, so the Kermit-80 bootstrapping technique would not work here.
  42.                                     - 60 -
  43.  
  44.  
  45.    1. You  should  have  a  version  of  KGET  on  the PC and KSEND on the
  46.       mainframe; if you don't have them, copy  them  (i.e. type  them  in,
  47.                      17
  48.       using an editor  ) from the listings below.
  49.  
  50.    2. Log  in  on the mainframe.  This could be tricky if you have no ter-
  51.       minal  emulation  facility  on  the  PC.    If  you  have  the   IBM
  52.       asynchronous  communication  package,  you can do this at low speeds
  53.       (baud rates).  If your PC has no terminal emulation facility, you'll
  54.       have to use a real terminal to log in, and then switch the cable  to
  55.       the PC.
  56.  
  57.    3. Compile  KSEND.FOR on your mainframe, if it needs compiling.  Define
  58.       logical unit numbers 5 and 6 to be  the  controlling  terminal,  and
  59.       logical unit number 7 to be KERMIT.FIX.  On the DEC-20, for example:
  60.  
  61.         @define 5: tty:
  62.         @define 6: tty:
  63.         @define 7: kermit.fix
  64.  
  65.       On a DECsystem-10, do something like:
  66.  
  67.         .assign tty: 5:
  68.         .assign tty: 6:
  69.         .assign dsk: 7:
  70.         .rename for007.dat=kermit.fix
  71.  
  72.       On an IBM system under VM/CMS,
  73.  
  74.         .filedef 5 term ( lrecl 64 recfm f
  75.         .filedef 6 term ( lrecl 64 recfm f
  76.         .filedef 7 disk kermit fix ( lrecl 64 recfm f perm
  77.  
  78.       Start KSEND on the mainframe.  It will print a message, and then sit
  79.       and  wait for the PC to send back an OK; don't change any connectors
  80.       until you see the message.
  81.  
  82.    4. Escape back to the PC, or connect the PC to the mainframe.  The PC's
  83.       communication port should be connected with a  cable  to  the  modem
  84.       that's  connected  to  the  mainframe  (dialup, dedicated, switched,
  85.       whatever hookup you normally have available for logging  in  on  the
  86.       mainframe  from a terminal).  If you were using a different terminal
  87.       to log in to the mainframe, make sure the PC's communication port is
  88.       set at the same speed.
  89.  
  90.    5. Enter BASIC and run KGET on the PC.  If KGET prints  messages  about
  91.       i/o  errors,  run  it again.  If it still gets errors, reboot the PC
  92.       and try again.  Once KGET is running, the transmission  will  begin.
  93.       KGET will print each 64-character line of nibbles as it arrives from
  94.       the  mainframe.  Each line should be the same length -- if you see a
  95.       ragged edge, you can assume there has been a transmission error, and
  96.  
  97. _______________
  98.  
  99.   17
  100.     You'll also have to compile and load the KSEND program on the mainframe.
  101.                                     - 61 -
  102.  
  103.  
  104.       you should start the process again.
  105.  
  106.    6. When  transmission  is complete, you'll see the BASIC "Ready" prompt
  107.       again.   Leave  BASIC  by  typing  SYSTEM.    You  should  now  have
  108.       KERMIT.EXE  on your PC.  Try to run it.  If you see the "Kermit-86>"
  109.       prompt, try to CONNECT to  the  host  mainframe  and  transfer  some
  110.       files.   If Kermit doesn't run correctly, there may have been trans-
  111.       mission errors, in which case you should  start  the  process  again
  112.       from step 2 above.
  113.  
  114. [The programs mentionned above can be found in the User's Guide.]
  115.