15 March, 1993

Brady Flowers
Oberon Software
BBS: 507-388-1154
Fido: 1:292/60


                   Using Columbia KERMIT for OS/2 with TE/2
                   ----------------------------------------

  (Note: This document contains only a brief discussion on using CKERMIT
  with TE/2.  You will also need to know how to use CKERMIT, a discussion
  of which is beyond the scope of this document; see the documentation
  accompanying CKERMIT.  This document may contain errors, use at your
  own risk.  This document in no way implies a commitment on the part of
  Oberon Software or the author.)

1. You must use CKERMIT Version 5A(188) or later.  This file is available
   on the Oberon BBS as CK5A188.ZIP.

2. It is recommended that you use the SIO comm port driver instead of the
   default COM.SYS.  SIO050.ZIP is also available on the Oberon BBS.  See
   the SIO documentation for information on installing SIO.

3. CKERMIT comes in both 16-bit and 32-bit OS/2 executable formats.  Only
   the 32-bit version is tested.  See the CKERMIT documentation for
   information on installing CKERMIT.

4. Once CKERMIT is installed on your system, you need to set up TE/2 to
   use it as an external program.  You do this by modifying the TE2.XEX
   file.  See the TE/2 documentation for a more detailed discussion on how
   to use the TE2.XEX file.  For our purposes here, we assume that you
   have already installed CKERMIT to your liking in the directory "D:\PBIN",
   and that you have renamed CKOKER32.EXE to CKERMIT.EXE.  In the examples
   below, remember to change the path and file name to match your setup!

   Use any text editor to edit the TE2.XEX file. Each entry in the file is
   four lines long; pick any two, four-line entries that you do not use
   and replace them with with the example settings below.  If TE/2 is
   currently running, you will want to exit and restart TE/2 so that it will
   re-read the modified file.

   A. KERMIT Receive

      The four line TE2.XEX file entry should look like:

          0x0011,3
          KERMIT Download
          d:\pbin\ckermit.exe
          -l %h -r

      - The first line specifies that the program will be run as a child
        program to TE/2, TE/2 will save and restore the screen before and
        after executing the program and wait for a keystroke before returning.
      - The second line is the title that will appear in the "External
        Programs" menu.
      - The third line is the full path/name of the executable (modify this
        to match your setup).
      - The fourth line is the command line parameters for the program, the
        "%h" causes the numeric value of the open Com port handle to be
        passed CKERMIT.

      To use KERMIT download, initiate the file transfer with the host
      system and, when the host prompts you to begin receiving, press
      Alt-J and select "KERMIT Download" from the menu.


   A. KERMIT Send

      The four line TE2.XEX file entry should look like:

          0x0011,3
          KERMIT Upload
          d:\pbin\ckermit.exe
          -l %h -s %?[Send files(s):]

      - The first line specifies that the program will be run as a child
        program to TE/2, TE/2 will save and restore the screen before and
        after executing the program and wait for a keystroke before returning.
      - The second line is the title that will appear in the "External
        Programs" menu.
      - The third line is the full path/name of the executable (modify this
        to match your setup).
      - The fourth line is the command line parameters for the program, the
        "%h" causes the numeric value of the open Com port handle to be
        passed CKERMIT. The "%?[Send files(s):]" will cause TE/2 to present
        you with an input field before executing the program, the prompt for
        the input will be "Send file(s):" and whatever you type here
        (presumably a list of file names) will be placed into the command
        line at this point.

      To use KERMIT upload, initiate the file transfer with the host
      system and, when the host prompts you to begin sending, press
      Alt-J and select "KERMIT Upload" from the menu.