Category : Communication (modem) tools and utilities
Archive   : ZSCRIPTS.ZIP
Filename : ZSCRIPTS.TXT

**************************************************
* HOW TO INTEGRATE ZMODEM PROTOCOL WITH MIRROR *
**************************************************

In this archive file you should find 4 MIRROR script files:

XZ.XTS - SEND FILES WITH ZMODEM
XZBG.XTS - (above using background)

RZ.XTS - RECEIVE FILES WITH ZMODEM
RZBG.XTS - (above using background)

You will also find the file ZMODEM.BAT. You should copy all 4
script files into MIRROR's subdirectory on your hard disk. You
will also need to copy the batch file ZMODEM.BAT and the program
DSZ.COM onto your hard disk. DSZ.COM may be found in archived
form on most BBS's (including the SoftKlone Information
Exchange). You should copy DSZ.COM and ZMODEM.BAT together into
a subdirectory whose path appears in the PATH command in your
AUTOEXEC.BAT file. If you put them elsewhere, these scripts may
not work.

To use the scripts, you must press your ATtention key in order
to get to the COMMAND? prompt, and enter the "DO" command to
execute the apprropriate script. For example,

COMMAND? DO RZ

( means you should press the ENTER key) would allow
you to receive file(s) using ZMODEM. Note that you can define
MIRROR's function keys to enter these commands for you, thus
making ZMODEM transfers available with a single keypress. For
example, you could define function keys -F1 and
-F2 as follows:

COMMAND? FK S1 @DO RZ|
COMMAND? FK S2 @DO XZ|

Please consult your MIRROR manual for more details about how to
define function keys.

**********************************
* SPECIFIC INFO ON THE SCRIPTS *
**********************************

As you may have guessed, RZ.XTS contains the script to
DOWNLOAD (i.e. receive) files with ZMODEM while XZ.XTS contains
the script to UPLOAD (i.e. send) files with ZMODEM. Both of
these scripts require MIRROR's PRISM addin module. Also, both
scripts use Mirror's RUn command. Because of this, these scripts
will NOT work if MIRROR is currently in background, or EVEN IF
MIRROR HAS EVER BEEN IN BACKGROUND. The scripts RZBG.XTS and XZBG.XTS
will put MIRROR in background mode and initiate ZMODEM. Modify these
scripts as desired to suit your own uses.

To use RZ.XTS, you should first tell your BBS that you wish to
download using ZMODEM, and specify the file(s) you want. When it
tells you it is ready to send, hit to get to MIRROR's
COMMAND? prompt, and enter the command DO RZ. You will be asked
to specify the drive/path where you wish to receive your file(s).
The default is MIRROR's current directory. Mirror will then
"shell" out to ZMODEM and attempt to receive files at the current
PORT and SPEED settings in Mirror. Mirror will not be able to
tell whether the transfer went well, so check for error messages
from your BBS, and restart the script if necessary.

To use XZ.XTS, you should first tell your BBS that you wish to
upload using ZMODEM, and specify the file you want to send. When
it tells you it is ready to receive, hit to get to MIRROR's
COMMAND? prompt, and enter the command DO XZ. You will be asked
to specify the name of the file, including drive and path. The
default drive/path is MIRROR's current drive/path. Mirror will
then "shell" out to ZMODEM and attempt to send files at the
current PORT and SPEED settings in Mirror. Mirror will not be
able to tell whether the transfer went well, so check for error
messages from your BBS, and restart the script if necessary.

You may use RZBG and XZBG in exactly the same way that you use
RZ and XZ with the only difference being the way MIRROR invokes
ZMODEM. Instead of "shelling" to ZMODEM (MIRROR's RUn command),
MIRROR goes into the background and, essentially, types the
necessary command to DOS to invoke ZMODEM. Naturally, it is assumed
that you are not running another program besides MIRROR at that
time. If you were, that program would appear, instead of DOS when
MIRROR went into background, and ZMODEM would not be invoked.