Using Columbia KERMIT for OS/2 with TE/2

15 March, 1993 Brady Flowers Oberon Software BBS: 507-388-1154 Fido: 1:292/60

(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 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.
 * 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.

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.