RUNZY.DOC

RUNZY.COM:                    *** ORIGIN ***

Developed using Borland's Turbo-C (c) v1.5, by Mark Stingley of Morgan
Creek Computing, P.O. Box 308, Colorado City, Texas 79512.  Phone:
(915) 728-5769 8AM-5PM (MCC BBS hours M-F 5P-2A, S-S 8A-2A, featuring
a Smart Conference.  300/1200/2400 baud, 8-N-1.  BBS software is, of
course, PC Board (c) v12.1, from Clark Development Corp.


                              *** PURPOSE ***

RUNZY is a program that will drive the venerable "DSZ.COM" program
from Omen Technology, Inc.  DSZ (c) features Forzberg's Zmodem, true
Ymodem protocols.


RUNZY (for RUN Z - Y) replaces the normal batch program drivers, which
won't run under the DOS window in Smart Communications.  With RUNZY, it
is easy to take advantage of these fast and accurate protocols, which
are a considerable improvement over the Xmodem (checksum) with which
the Smart Communications module is afflicted.


                              *** DISCLAIMER ***

RUNZY is offered into the public domain for anyone who wishes to use
it, since I wrote it, and that's the way I want it.  The only condition
is that your use of the program be considered a release for the author
of any and all liability.  It works on my fine equipment, so I don't
think you'll have any trouble, though.  Still, there is no warranty ex-
pressed or implied as to RUNZY's suitability for your uses.


Be advised that the DSZ program is the property and trademark of Omen
Technology, and they require a nominal registration fee.  Details re-
garding registration of DSZ are in the DSZ.ARC file.  Honestly, since
DSZ will shorten on-line time, the slight registration fee is well
worth it.


                              *** OPERATION ***

By now, you've gathered that DSZ is required for Zmodem and Ymodem op-
eration with RUNZY.


Here's how it works:

Normally, you can't call DSZ from the DOS window (Ctrl-O), since you
can't pass parameters needed by the program, and batch files won't ex-
ecute.  You would type in the long command line for DSZ every time you
use it, but the host computer would probably timeout by the time you
finished.  Since RUNZY is a menu driven .COM program, it is easily ex-
ecuted from the DOS window, and then RUNZY will pass the necessary pa-
rameters to DSZ for file transfer (upload or download).

All you have to do is unarchive RUNZY.ARC and DSZ.ARC, and place the
program files in your "Smart\Comm" directory.  The routines should run
OK from any "pathed" directory, though.  Another nice feature of RUNZY
is that it should also run DSZ.EXE (yes, there's one of those too; for
less compatible PC's).

Operating steps are like so:

                    1.  Make sure DOS path and directory are set.
                    2.  Run Smart Communications.
                    3.  Tell host computer to initiate down/upload.
                    4.  Press F-3 and Crtl-O.
                    5.  Type RUNZY <Enter>.
                    6.  Follow the menu prompts accordingly.
                    7.  After transfer, type Exit <Enter> then F-3.
                    8.  You will now be back Online.

          or

                    build a comm project that says

                    " COMMAND /C RUNZY "

                    and execute it from the online screen (F-8)
                    after telling the host computer to initiate 
                    a file transfer.

IMPORTANT:  Make sure DSZ.COM and RUNZY.COM are in a pathed directory,
and you should change to the directory containing your upload files to
avoid having to type pathnames.  Change the directory BEFORE running
Smart.  Also, if you aren't using COM1, you will need to issue the DOS
SET command BEFORE starting Smart Communications.

While online with Smart Communications, simply get the Host computer
prepared for your Y or Z protocol transfer, then immediately press
Ctrl-O for the DOS window.  Type "RUNZY" then press enter.  The rest is
menu prompted.


                              *** INTERNALS ***

RUNZY does everything through TURBO-C DOS call conventions.  The actual
function used is EXEC, with the -p switch set, so DOS will look for
DSZ.COM or DSZ.EXE in the current directory, then the entire path. 
When uploading a file, try to make sure it is in the logged, or cur-
rent, directory so you don't have to type out a long path along with
the filename.

RUNZY ain't fancy.  It does no error checking, and when transmitting a
file, it will pass to DSZ whatever you enter as a filename.  DSZ will
display progress and termination codes.

The parameters passed to DSZ are as follows:

     buffers are set = pB4096
     handshake is set = both
     serial port is COM1: (default)  For COM2-4, "SET DSZPORT=?"
                                        from DOS. (See DSZ.DOC.)

These settings should be satisfactory for most systems.  As a matter of
fact, RUNZY should enable operation of DSZ within Procomm or other pro-
grams.


                              *** SOURCE CODE ***

The C language source code for RUNZY can be obtained by sending a
stamped, self-addressed envelope to:

     Morgan Creek Computing
     (RUNZY offer)
     P. O. Box 308
     Colorado City, TX 79512