Documentation for DSZ-Paz 0.20
16 October 1988
by
Dave Saunders
FidoNet Node 154/655

Dsz-Paz is a small program designed to add the wide variety of DSZ protocols
such as Zmodem and Ymodem-G to communications programs.

The idea for this endeavor was spawned by the program DSZ-Zap which was
written by Brad Cronk of Iowa City, Iowa. Dsz-Paz, however, uses none of
the same code, is written in an entirely different language, had a smaller
executable code size, requires only one file which supports several ComPorts,
and offers other enhancements over the original program.

Please be sure to read the additions and changes section at the end of this
file for information on any changes or enhancements which have been made to
previous versions of the program.


To install Dsz-Paz:
Basically, two options are available.

1) Specify Dsz-Paz.Exe as the editor option of Telix or Procomm ( or
as a hot-key option in Procomm+ or Binkley ).
2) Run Dsz-Paz.Exe from a DOS shell.

Environment Variables:
Dsz-Paz eliminates the need for multiple files to support multiple
communications ports by taking advantage of DOS environment variables.

This version of Dsz-Paz supports the following environment variables.

- DSZPORT : You may set DSZPORT equal to the communications port you
use for telecommunications. For example, if you use
Com2: you would add the following line to you AutoExec.Bat
file:
SET DSZPORT=2
If this environment variable is not found, you will be
prompted for the ComPort you are using.

- DSZEDIT : No, you do not have to give up your editor when you use
Dsz-Paz. In fact, if you did not have an editor-key in
your current communications program, now you do with
Dsz-Paz. Simply set the environment variable DSZEDIT to
the full pathname of your favorite editor; you will be
prompted for command line parameters. For example, if
you use the program Qedit (Q.Com or Q.Exe) as your editor
and it is located in D:\Q\Q.Com or D:\Q\Q.Exe you would
add the following line to your AutoExec.Bat file:
SET DSZEDIT=D:\Q\Q
You can either add the .Exe, .Com or .Bat file extension
or leave it off; Dsz-Paz is intelligent enough to figure
out which you really need.

- DOWNLOAD : Don't like all of your downloaded files ending up in the
current directory? Well, if you set the environment
variable DOWNLOAD to the path of your download directory,
Dsz-Zap will direct DSZ to place the files within that
directory. If this environment variable is not found
your downloads will end up in the current directory.
For example, to have all of your downloads placed in the
directory D:\COMM\DLOAD you would add the following line
to your AutoExec.Bat file:
SET DOWNLOAD=D:\COMM\DLOAD
NOTE: You do not need a trailing backslash following the
path of your download directory. I do not do any error-
checking to make sure the path exists so make sure that
you have specified the path of an existing directory or
DSZ will abort with an error message.

NOTE:
- Some of the protocols do not need a filename; DSZ will fetch it for
you during the transmission. The protocols which do not require a
filename are Zmodem, Ymodem and Ymodem-G. When you are asked for a
filename by Dsz-Zap simply press enter.

If you receive the DOS error: "Bad Command or Filename" it means one of the
following:
- If you are using the editor, you have specified an invalid
pathname.
- DSZ is not located within your DOS path.

Simply correct the problem ( Don't forget to change the DSZEDIT= in your
AutoExec.Bat file if this was the problem ).


******************************************************************************
Summary of Command Line Parameters
******************************************************************************

/F=filename ( Filename parameter )

/A=S To send a file. ( Action parameter )
/A=R To receive a file. ( Action parameter )

/P=protocol Valid protocols are: ( Protocol parameter )
Z - Zmodem
Y - Ymodem
G - Ymodem-G
X - Xmodem
C - Xmodem-CRC
1 - 1K-Xmodem
J - Jmodem
M - Megalink
S - Sealink
O - Overdrive Sealink
/B ( End of transfer bell parameter )

/C=Valid_Dos_Command ( DOS command to be executed
after DSZ-Paz terminates
parameter )

/NB ( Parameter which disallows the
use of the DSZ buffer command
which is incompatible with the
.EXE version of DSZ )

/R ( Parameter to allow Zmodem to
resume an aborted download )

/BIOS ( Makes DSZ-Paz write through the
bios rather than directly to
display memory )
- For more information on command line parameters, read the additions section
of this documentation which follows.

--------------------------------------------
|Additions to Version 0.071 - 19 March 1988 |
--------------------------------------------

For you power users I have added the option of specifying the protocol,
Send/Receive action and filenames on the command line. All command line
parameters are entirely optional; if you do not specify all required
parameters then Dsz-Paz will prompt you for them in the usual manner.

Command line parameters are as follows:

/F=filename
/A=S To send a file.
/A=R To receive a file.
/P=protocol Valid protocols are: ( Protocol parameter )
Z - Zmodem
Y - Ymodem
G - Ymodem-G
X - Xmodem
C - Xmodem-CRC
1 - 1K-Xmodem
J - Jmodem
M - Megalink
S - Sealink
O - Overdrive Sealink

NOTE: You must have a space between parameters. The parameters do not
have to be in any particular order and are not case significant. A couple
of common sense items:

- Dsz-Paz verifies the existence of any files that you are trying to
send before it calls DSZ. If you do not specify the /A= parameter
on the command line, Dsz-Paz cannot tell if you are sending or
receiving a file ( received files will not be verified, since they
do not yet exist on your drive ) and it will ignore the /F= option.

- Some of the protocols do not need a filename; DSZ will fetch it for
you during the transmission. The protocols which do not require a
filename are Zmodem, Ymodem and Ymodem-G. If you specify a filename
on the command line for any of these protocols, Dsz-Zap will ignore
the filename.

EXAMPLE: To send the file named C:\AUTOEXEC.BAT using Zmodem the command
would be the following:
DSZ-PAZ /A=S /P=Z /F=C:\AUTOEXEC.BAT


--------------------------------------------
|Additions to Version 0.072 - 24 March 1988 |
--------------------------------------------

Added a couple more command line parameters to Dsz-Paz. The /C parameter
allows Dsz-Paz to execute another program after the transfer is completed
and the /B parameter has Dsz-Paz sound a small alarm when the transfer is
completed. The /C parameter will use the current DOS path to search for
the DOS command to be executed.

Syntax for new command line parameters:

/B
/C=Valid_Dos_Command

EXAMPLE: To send the file named C:\AUTOEXEC.BAT using Zmodem, sound the
alarm upon completion of transfer and then list the current directory the
command would be the following:


DSZ-PAZ /A=S /P=Z /F=C:\AUTOEXEC.BAT /B /C=DIR


--------------------------------------------
|Additions to Version 0.073 - 25 March 1988 |
--------------------------------------------

No major changes in this revision. I simply changed the processing order
so that the user will be prompted for a filename when receiving a file ONLY
if the protocol requires it. I also modified the alarm procedure so that it
is a bit more noticable and so that it can be aborted at any time if the user
presses a key.


---------------------------------------------
|Additions to Version 0.078 - 10 April 1988 |
---------------------------------------------

I made numerous changes between Versions 0.073 and 0.078:

- Put in code obtained from Jim Berg's JBCOMM Version 1.2 Turbo Pascal
version 4.0 communications unit to check the speed of the Com Ports
so that MegaLink, SeaLink and OverDrive SeaLink could be added.

- Added MegaLink, SeaLink and OverDrive SeaLink support to the program.
Since the communications routines provided by Jim Berg only support
Com Ports 1 and 2 ( for the present ), these are the only ports that
you can use the new protocols with.

For MegaLink, SeaLink and OverDrive SeaLink to work, you must have the
following files located within your DOS path.

Clink.Exe
MLink.Com

Clink, by System Enhancements Associates and MegaLink, by Paul Meiners
of P & M Software of Houston, TX can be obtained on many bulletin boards.

- Fixed a bug which kludged the download path when downloading with any of
the DSZ protocols which require the filename to be manually entered by
the receiving station.

- Optimized the code just a bit and trimmed down the memory requirements
that DSZ requires to run by a small amount.


---------------------------------------------
|Additions to Version 0.080 - 13 April 1988 |
---------------------------------------------

- Added support for the .EXE version of DSZ by making the buffering
parameter optional. DSZ-Paz defaults to a 4K communications buffer,
which the .EXE version of DSZ does not support. If you are running
the .EXE version of DSZ you will need to place a /NB parameter in your
command line used to run DSZ-Paz.

- Added another version of the PC-Pursuit optimized Zmodem protocol to the
program.

---------------------------------------------
|Additions to Version 0.081 - 14 April 1988 |
---------------------------------------------

- Added support for resuming aborted Zmodem downloads. If you want to resume
an aborted Zmodem download, add a /R to your normal DSZ-Paz command line.

---------------------------------------------
|Additions to Version 0.082 - 14 April 1988 |
---------------------------------------------

- If you specify multiple files to send for one of the batch transfer
protocols, DSZ-Paz will no longer abort with an error message stating
that it cannot locate the files you are attempting to transfer. I
modified the code so DSZ-Paz simply does not attempt to check for
file existence prior to transfer when it detects multiple filenames
to be sent.


---------------------------------------------
|Additions to Version 0.083 - 18 April 1988 |
---------------------------------------------

- Added another command line parameter for those using DSZ-Paz with Multi-
tasking software and voice synthesizers. The /BIOS command line
parameter forces DSZ-Paz to use BIOS writes rather than direct screen
writes for video displays.

-----------------------------------------------
|Additions to Version 0.23 - 10 October 1988 |
-----------------------------------------------

-Added Jmodem ( along with a few other bug fixes ) to DSZ-Paz.