UPLOAD.SCR
DOWNLOAD.SCR

These are two very simple macros to interface ms-kermit with gsz 
or dsz. They have been tested with MS-Kermit 3.11 and gsz.

     I'm a recent convert to ms-kermit, and find it superior to 
Procomm Plus and Qmodem (the 2 other communications programs i 
have tried). And, the price is very good. The only problem is the 
lack of popular file transfer protocols (x, y, and zmodem). Kermit 
has it's own protocol. I have seen people who know what they are 
talking about say that the kermit protocol with sliding windows 
and large data packets performs as fast as y or zmodem, but so far 
all the systems i have communicated with have old and brain- 
damaged versions of kermit which don't support these advanced 
features, and perform very slowly. So i needed a way to implement 
zmodem (and if possible x and ymodem as well) as external 
protocols. GSZ fits the need nicely. It is a sharewhare program 
that implements all three, and is available in the usual archives 
and BBSs. DSZ is basically the same thing, without the "graphic" 
interface.

     In Procomm Plus, for example, you have access to a menu of 
file transfer protocols at the press of a key. I wanted to be able 
to do the same with ms-kermit, and these macros were born.

     I have seen other people do the same thing by escaping out of 
terminal mode (alt-x) and then running a macro. I wanted to be 
able to call the external file transfer protocols without having 
to drop from terminal mode, by just pressing a "hot-key". I found 
out that there are two kermit "verbs" that where left free to be 
associated with any macro. These where intended to allow the user 
to perform some kind of setup on the remote kermit system, but 
they serve my purpose nicely. These verbs are TerminalS and 
TerminalR.

     If you copy the lines bellow into your mskermit.ini file, you 
will be able to call external protocols (using GSZ or DSZ) like 
this:

Alt-D for download
Alt-U for upload

You will be presented with a short menu, where you can make your 
selection:

"1" or "z" or "zmodem" for zmodem
"2" or "y" or "ymodem" for ymodem
"3" or "x" or "xmodem" for xmodem


     Note that you will have to edit the files upload.scr and 
download.scr just a little bit. At the top of both these files you 
will find the line "define progpath c:\kermit\gsz". Edit this so 
that it points to the full pathname of gsz (or dsz) in your 
system.

     There is one obstacle i couldn't get around: ms-kermit sends 
a ^S (wait) character before it shells out to dos and calls gsz. 
This apparently makes it impossible to use xmodem and ymodem to 
transfer files to unix systems running sx/rx, sb/rb. Zmodem 
(sz/rz) works just fine (and anyway, you wouldn't want to use 
xmodem or ymodem if the unix system has zmodem available. I have 
tested xmodem and ymodem against a couple of BBSs, and they work 
fine. And there is always the kermit native protocol, as a last 
resource.

     If you don't like Alt-D and Alt-U as hotkeys, this is how you 
change them: inside ms-kermit, type "show key" <Enter>, then press 
the key you want to use as hotkey. Kermit will respond with the 
scan code it assigns for that key. Write it down. Substitute it in 
the line where it says "set key \xxxx \KTerminalS" for upload, or
"set key \xxxx \KTerminalR" for download.

     The files that compose this package are released into public 
domain, and shall not be sold. You are free to modify and 
redistribute them as you please. Only, if you modify them, include 
a note saying so, or else remove my name from the files.

     Support: none. But i'm glad to help if i can and have time. I 
can be reached by email as glauber@david.wheaton.edu, until the 
end of 1992. After that, i don't know. If you like these macros, 
and want to drop me email saying so, please do.


                                                   Glauber Ribeiro



THE FOLLOWING LINES MUST BE COPIED IN YOUR MSKERMIT.INI FILE:
------------cut here----------------------------------------------

; These macros are used to call file transfer protocols
; from terminal mode

def TerminalR take download.scr, connect
def TerminalS take upload.scr, connect


set key \2326 \KTerminalS       ; Alt-U = upload
set key \2336 \KTerminalR       ; Alt-D = download

------------cut here----------------------------------------------
