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