home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
High Voltage Shareware
/
high1.zip
/
high1
/
DIR36
/
SDPL101E.ZIP
/
SDPL.DOC
< prev
next >
Wrap
Text File
|
1993-08-25
|
54KB
|
1,243 lines
Streamline Design (Lite) Protocol Module Version 1.01
CopyRight (C) 1993 Streamline Design (984502 Ontario Inc.)
All Rights Reserved
Voice: (416)790-1997 10:00am to 6:00pm
BBS : (416)793-1411 24 Hours a Day
Table of Contents
1 - Introduction
2 - Liscencing
3 - Future Plans
4 - Quick Reference
5 - XModem
6 - YModem
7 - ZModem
8 - General
9 - Additional Programs
10 - Registration
1 - Introduction
The Streamline Design Protocol Module, aka SDPL, was designed to
allow the transfer of data from various platforms. It will work
in DOS, PS2, OS2, Windows, Networked, and any of the previous
emulated environments. The goal of SDPL is to make it easy to
transfer data with a great amount of flexibility and ease of
use.
SDPL supports the following protocols: XModem
XModem Relaxed
XModem/CRC
XModem/CRC Relaxed
XModem-1k
XModem-1k Relaxed
XModem-1kG
XModem-1kG Relaxed
Ymodem
YModem Relaxed
YModemG
YModemG Relaxed
YModem-128
YModem-128 Relaxed
ZModem
ZModem-8k
If you have any comments or suggestions about this product we
would be glad to hear from you about them.
The following is a list of machines and environments this
product has been tested on:
Environments
- DOS
- Lantastic
- MS Windows 3.xx
- Novell
Hardware
- Phillips 486/25 EISA
- Phillips 386/33 ISA with Phoenix BIOS
- Intel 386/33 ISA with AMI BIOS
- Intel 9600EX Modem
- USR Robotics 19200 Modem
- Generic 2400 Modem
2 - Liscencing
This program is NOT public domain and is (c)Copyrighted
1993 by Thomas S. Thayer with all rights reserved. It may
not be distributed for personal gain under any circumstances.
The SDPLxxx.ZIP file in its original form may be copied or
distributed thru Bulletin Board systems provided no fee is
charged for its distribution and no modifications are made to
the program files contained therein.
User Supported Software is a way for you to review a
program on a trial basis and test its operation on your
system prior to purchasing it. Under this type of
distribution system, you are insured that the program meets
your needs and requirements. You may review this program
for a period of 30 days, free of charge, after which, you
must either order a copy or remove it from your system.
This software is provided on an "As Is" basis without
warranty either implied or expressed of any kind. Thomas S.
Thayer, the author and sole owner of this software, takes
no responsibility for loss of data or damage to equipment
thru the use of this software. Should the software prove
defective the entire burden of any and all repairs and
replacements and/or data restoration rests with the user. In
no event will the author be liable for any costs and/or
losses either tangible or intangible arising from the use of
this software.
3 - Future Plans
In future updates we plan to implement as many suggestions
and enhancements as is possible. The following is a list of
future enhancements already planned:
- Background Transfers
- Sealink
- Telink
- BPlus
- Bi-directional operation
4 - Quick Reference
A command that accepts an argument will always have a '=' preceding the
argument.
##### - Numeric Value
$$$$$ - ASCII Numeric Value
CCCCC - Character or String Value
????? - Boolean Value (On/Off)
XModem Commands
Command Description Args Default
------- ---------------------------------------------------- ----- -------
xrx Use XModem in the relaxed state N/A N/A
sx Send a file using XModem N/A N/A
sxc Send a file using XModem/CRC N/A N/A
sxk Send a file using XModem-1k N/A N/A
sxg Send a file using XModem-1kG N/A N/A
rx Receive a file using XModem N/A N/A
rxc Receive a file using XModem/CRC N/A N/A
rxk Receive a file using XModem-1k N/A N/A
rxg Receive a file using XModem-1kG N/A N/A
YModem Commands
Command Description Args Default
------- ---------------------------------------------------- ----- -------
sy Send a file using YModem N/A N/A
syg Send a file using YModemG N/A N/A
ry Receive a file using YModem N/A N/A
ryg Receive a file using YModemG N/A N/A
n1k Do not use 1k, (1024 byte), blocks ????? false/off
nrx Do not use YModem in the relaxed state ????? false/off
ZModem Commands
Command Description Args Default
------- ---------------------------------------------------- ----- -------
sz Send a file using ZModem N/A N/A
rz Receive a file using ZModem N/A N/A
rzr Set up ZModem to allow file recovery ????? false/off
zf1 Overwrite the existing file if the incoming file ????? false/off
is newer or longer than the existing file
zf2 Currently acts the same as zf4 ????? false/off
zf3 Write the transmitted file no matter what ????? false/off
zf4 If the file is new write it, otherwise append it to ????? false/off
the end of the existing file
zf5 Write the file if it is new, or newer than the ????? false/off
existing file.
zf6 Write the file if it is new, or if its date or size ????? false/off
is different from the existing file
zf7 Write the file only if it is new ????? true/on
z8k Use large, (8k/8192 byte), with ZModem ????? false/off
zov When receiving a file ignore the transmitting ????? false/off
systems file management options and use the receiving
systems file management options
skn Skip all incoming files that don't already exist on ????? false/off
the receiving system
General Commands
Command Description Args Default
------- ---------------------------------------------------- ----- -------
gid Include directory with file names ????? false/off
ghd Honor directory in file names ????? false/off
grl Lower RTS during disk writes ????? false/off
dhw The amount of time, (in clock tics), to wait ##### 182/10 sec
before retrying a handshake signal
dhr The maximum number time to retry before aborting ##### 10
transfer
dtt The number of tics to wait for a receiver flow ##### 1092
control release
dsi The amount of time to wait between updates to the ##### 91/5 secs
status screen in tics
bfc The fill character for partial protocol blocks $$$$$ 26 (^Z)
gho The hour offset to correspond the GMT ##### 0
td Set the Telix delay, (in tics),will usually never ##### 9
need this.
dd Set the destination directory for received files CCCCC blank
fln Set the name for the file log CCCCC blank
oh Set the number of bytes per block ##### N/A
std Set the time, (in milliseconds), that it takes the ##### N/A
block to get to the remote, for the remote to
acknowledge and for that acknowledgement to reach us
fs Force the Status updates ????? True/On
si The amount of time to wait between updates to the ##### 91/5 secs
status screen in tics
sab Set the actual BPS (needed only if modem differs ##### N/A
from port)
soo Set option for what to do when the destination file ##### 1
already exists
@fl The path and name to the list of files you wish to CCCCC blank
transfer
com The comport to use with this session ##### 1
bd Override the baudrate with this value ##### N/A
irq Define Non-Standard IRQs and/or base address CCCCC N/A
fnm Name for file to be transferred or received CCCCC blank
inb Set the size of the input buffer ##### 4096
otb Set the size of the output buffer ##### 4096
par Override the parity type CCCCC N/A
stb Override the Stop Bits ##### N/A
dtb Override the data bits ##### N/A
hud Use DTR for Receive Flow Control ????? false/off
hur Use RTS for Receive Flow Control ????? true/On
hrd Require DSR before transmitting ????? false/Off
hrc Require CTS before transmitting ????? true/on
hdl Make DTR Active Low ????? false/off
hrl Make RTS Active Low ????? false/off
hsl Make DSR Active Low ????? false/off
hcl Make CTS Active Low ????? false/off
rpg Return partial strings from the input buffer ????? true/on
rd Return the delimiter character from the input buffer ????? true/on
epp Execute partial puts to the output buffer ????? true/on
idc Ignore the case justification on delimiter chars ????? false/off
roc Restore the UART when ending a session ????? false/off
dmc Hangup the modem when finished with session ????? false/off
rmo Raise the DTR and RTS signals when SDPL is started ????? true/on
idt Do not initialize port with DTR low ????? false/off
irt Do not initialize port with RTS low ????? false/off
dsz Adhere to DSZ standards ????? false/off
5 - XModem
XModem is the oldest protocol supported by SDPL. It was first
developed by Ward Christensen in 1977 and then placed in the public
domain. It became a very popular protocol and is still in wide use.
However, it's use has diminished over the years as faster and more
efficient protocols arrived.
XModem is also the simplest, and perhaps the slowest, protocol
supported by SDPL. XModem uses 128 bytes blocks, requires an
acknowledgement of each block, and uses only a simple checksum
for data integrity.
SDPL provides a few options for better speed and flexibility when
using XModem. Such options are 1024 byte(1k) blocks, CRC checks,
G Mode, and relaxed mode.
The XModem protocol does not support batch transfers.
Options
xrx - This command has no arguments and simply puts the XModem
transfer into relaxed mode. Relaxed mode simply sets the
time out for XModem to 10 seconds rather than the default
of 5 seconds.
ie: SDPL rx xrx fnm=c:\SDPL\test.txt
The above would receive/download to a file named test.txt in a
directory named SDPL on the C drive. It would also set the
XModem timeout to 10 seconds.
sx - This command has no arguments and simply starts the transfer
a file specified by the fnm command using XModem.
ie: SDPL sx fnm=c:\SDPL\test.txt
The above would transfer/Upload a file named test.txt from
a directory named SDPL on the C drive.
sxc - This command has no arguments and simply starts the transfer
a file specified by the fnm command using XModem/CRC. XModem/CRC
is an improvement on the original XModem. It provides a 16 bit
CRC (cyclic redundancy check) block check for the original
checksum. This gives you a higher level of data integrity.
ie: SDPL sxc fnm=c:\SDPL\test.txt
The above would transfer/Upload a file named test.txt from
a directory named SDPL on the C drive.
sxk - This command has no arguments and simply starts the transfer
a file specified by the fnm command using XModem-1k. XModem-1k
is an improvement on the original XModem. It provides a 16 bit
CRC (cyclic redundancy check) block check for the original
checksum as well as using 1024 byte blocks rather than the
original 128 byte blocks. This gives you a higher level of data
integrity and a faster transfer.
ie: SDPL sxk fnm=c:\SDPL\test.txt
The above would transfer/Upload a file named test.txt from
a directory named SDPL on the C drive.
sxg - This command has no arguments and simply starts the transfer
a file specified by the fnm command using XModem-1kG. XModem-1kG
is an improvement on the original XModem. It provides a 16 bit
CRC (cyclic redundancy check) block check for the original
checksum, uses 1024 byte blocks rather than the original 128 byte
blocks, and performs a streaming transfer. A streaming transfer
means that the transmitter continuously transfers blocks without
waiting for acknowledgements. This gives you a higher level of
data integrity and a faster transfer, but it should never be used
with non error correcting modems. If you are using a non error
correcting modem, and the receiver receives a bad block, the
transfer will be aborted.
ie: SDPL sxg fnm=c:\SDPL\test.txt
The above would transfer/Upload a file named test.txt from
a directory named SDPL on the C drive.
rx - This command has no arguments and receives data and stores it to
a file specified by the fnm command using XModem.
ie: SDPL sx fnm=c:\SDPL\test.txt
The above would receive/download to a file named test.txt in
a directory named SDPL on the C drive.
rxc - This command has no arguments and receives data and stores it to
a file specified by the fnm command using XModem/CRC. XModem/CRC
is an improvement on the original XModem. It provides a 16 bit
CRC (cyclic redundancy check) block check for the original
checksum. This gives you a higher level of data integrity.
ie: SDPL rxc fnm=c:\SDPL\test.txt
The above would receive/download to a file named test.txt in
a directory named SDPL on the C drive.
sxk - This command has no arguments and receives data and stores it to
a file specified by the fnm command using XModem-1k. XModem-1k
is an improvement on the original XModem. It provides a 16 bit
CRC (cyclic redundancy check) block check for the original
checksum as well as using 1024 byte blocks rather than the
original 128 byte blocks. This gives you a higher level of data
integrity and a faster transfer.
ie: SDPL rxk fnm=c:\SDPL\test.txt
The above would receive/download to a file named test.txt from
a directory named SDPL on the C drive.
rxg - This command has no arguments and receives data and stores it to
a file specified by the fnm command using XModem-1kG. XModem-1kG
is an improvement on the original XModem. It provides a 16 bit
CRC (cyclic redundancy check) block check for the original
checksum, uses 1024 byte blocks rather than the original 128 byte
blocks, and performs a streaming transfer. A streaming transfer
means that the transmitter continuously transfers blocks without
waiting for acknowledgements. This gives you a higher level of
data integrity and a faster transfer, but it should never be used
with non error correcting modems. If you are using a non error
correcting modem, and the receiver receives a bad block, the
transfer will be aborted.
ie: SDPL rxg fnm=c:\SDPL\test.txt
The above would receive/download to a file named test.txt in
a directory named SDPL on the C drive.
6 - YModem
Ymodem is basically the same as XModem-1k with batch file transfer
ability. This means a single YModem transfer can transfer as many
files as you wish. It also provides the receiver with information
about the incoming files such as: file name, size, date.
Options
sy - This command has no arguments and starts a transfer of a file
specified by the fnm command, or the @fl command, using YModem.
ie: SDPL sy fnm=c:\SDPL\test.txt
The above would transfer/upload a file named test.txt from a
directory named SDPL on the C drive.
syg - This command has no arguments and starts a transfer of a file
specified by the fnm command, or the @fl command, using YModemG.
YModemG is a streaming protocol. A streaming protocol means that
the transmitter continuously transfers blocks without waiting for
acknowledgements. This gives you a faster transfer, but it
should never be used with non error correcting modems. If you
are using a non error correcting modem, and the receiver
receives a bad block, the transfer will be aborted.
ie: SDPL syg fnm=c:\SDPL\test.txt
The above would transfer/upload a file named test.txt from a
directory named SDPL on the C drive.
ry - This command has no arguments and receives data and stores it to
a file specified by the fnm command using YModem. If the fnm
command is not specified you could use the dd command to specify
the destination directory and the protocol would use the incoming
filename and store it in that directory. Without the dd command
and the fnm command YModem will simply store the file, using the
incoming name, to the current directory.
ie: SDPL ry
The above would receive/download a file using the incoming name
into the current directory.
ryg - This command has no arguments and receives data and stores it to
a file specified by the fnm command using YModemG. YModemG is a
streaming protocol. A streaming protocol means that the
transmitter continuously transfers blocks without waiting for
acknowledgements. This gives you a faster transfer, but it
should never be used with non error correcting modems. If you
are using a non error correcting modem, and the receiver
receives a bad block, the transfer will be aborted.
ie: SDPL ryg fnm=c:\SDPL\test.txt
The above would receive/download a file named test.txt in a
directory named SDPL on the C drive.
n1k - This command has no arguments and simply tells SDPL to use 128
byte blocks rather than 1024 byte blocks.
ie: SDPL ry n1k dd=c:\SDPL
The above would receive data in 128 byte blocks and store it to
a file, using the incoming name, in a directory named SDPL on the
C drive.
nrx - This command has no arguments and simply tells SDPL not to use the
the relaxed state for the transfer. By default, YModem uses a
XModem relaxed state. Using this option tells YModem to
implement 5 second timeouts rather than 10 second timeouts.
ie: SDPL ry n1k nrx
The above would receive data in 128 byte blocks, use 5 second
timeouts, and store it to a file, using the incoming name, in
a directory named SDPL on the C drive.
7 - ZModem
Zmodem was developed by Chuck Forsberg under contract to Telenet.
It was developed for the public domain and its purpose was to
provide a durable protocol with strong error recovery features and
good performance over a variety of network types (satellite,
switched, etc.). For the most part is has achieved these goals
and is by far the best choice overall.
ZModem offers the best overall mix of speed, features, and tolerance
for errors. This protocol has lots of room for growth, and many
options. Unlike XModem and YModem, Zmodem employs headers, data
subpackets, and frames. This allows ZModem to implement many
features that other protocols simply cannot achieve.
ZModem will do its best to correct errors in the transmission. It
does this by a variety of ways. It will use file recovery if the
transfer was aborted and it will also increment and decrement block
sizes to compensate for errors. For instance, if you are using the
8k option with ZModem and you get a noisy line ZModem will drop to
1k blocks and if the errors still occur will then try 512 byte blocks.
If the errors still persist it will try 256 byte blocks as a last
resort. After it has tried the 256 byte blocks, if the errors still
persist, it will abort the transfer.
ZModem offers batch transfers.
Options
sz - This command has no arguments and simply transmits a file
specified by either the fnm command or the @fl command.
ie: SDPL com=2 sz fnm=c:\SDPL\test.txt
The above would transmit/upload a file named test.txt in a
directory named SDPL on the C drive. It also uses COM 2 and
provides graphical display.
rz - This command has no arguments and simply receives a file
specified by either the fnm command or the @fl command or
the incoming name is used. The destination directory of
the file can be specified by the dd command.
ie: SDPL rz dd=c:\SDPL
The above would receive/download a file using the incoming name
to a directory named SDPL on the C drive. It defaults to COM1.
rzr - This command has no arguments and simply instructs ZModem to
use the file recovery option. File recovery allows you to
resume a transfer at the point it left off. The following
will explain a little better:
Suppose you are doing a batch transfer of three files. To
simplify things the files are named A, B, and C.
File A = 12000 bytes
File B = 14000 bytes
File C = 25000 bytes
You start the transfer and File A is completed but when you
are at byte 7000 of file B the transfer aborts. If you
implemented the file recovery option the following would
occur:
File A would not be transferred since it already exists on
the remote system.
File B would start off at byte 7000
File C would be transferred completely.
All 3 files would be in the exact shape you wish them to be
on the remote system.
ZModem offers several file management routines. These are simple
rule that tell ZModem to accept a file or not. As a general rule
all file management specifications are defined by the transmitter.
However, SDPL implements an option that allows the receiver to
override this functionality. The following is a list of file
management options. Only one option can be specified at a time.
zf1 - This command has no arguments and instructs ZModem to transfer
the file and overwrite the existing file only if the file
being transferred is newer or longer than the existing file.
zf2 - This command accepts no arguments and acts the same as zf4.
Refer to the command zf4 for more information.
zf3 - This command has no arguments and instructs ZModem to transfer
the file and overwrite the existing file regardless of anything.
zf4 - This command has no arguments and instructs ZModem to transfer
the file and overwrite the existing file only if it is new.
Otherwise, it will append to the existing file.
zf5 - This command has no arguments and instructs ZModem to transfer
the file and overwrite the existing file only if it is new or
newer than the existing file.
zf6 - This command has no arguments and instructs ZModem to transfer
the file and overwrite the existing file only if it is new or
its date or size if different from the existing file.
zf7 - This command has no arguments and instructs ZModem to transfer
the file only if the file does not exist.
z8k - This command has no arguments and simply tells ZModem to
implement large subpackets. This sets the subpacket size to
8k, (8192 bytes). This provides a faster transfer as a general
rule.
zov - This command has no arguments and simply tells ZModem to ignore
the transmitting systems filemanagement options and implement
those specified on this end of the transfer.
skn - This command has no arguments and simply tells ZModem not to
receive files that do not already exist.
8 - General
These options allow you to use SDPL in a myriad of ways and in many
environments. These control things such as DTR, RTS, CTS, DSR,
graphical displays, destination directories, etc.
Options
gid - This command has no arguments and simply tells SDPL to include
directory names in the file information packet when transmitting
files. Not all protocols support file information packets.
ie: SDPL sz gid fnm=c:\SDPL\test.txt
The above would transmit/upload a file named test.txt from a
directory named SDPL on the C drive. It would also include
c:\SDPL\test.txt in the file info packet as opposed to test.txt.
ghd - This command has no arguments and simply tells SDPL to try and
honor the incoming directory names. This does not mean that it
will create directories. If the path does not exist it will
save the file in the current directory or the directory
specified by the dd command. This is not supported by ASCII and
all XModem protocols.
SDPL defaults this to off.
ie: SDPL rz ghd dd=c:\SDPL
The above would receive/download a file(s) using the incoming
name(s). SDPL will check the pathing of each file being
received and if the path exists will store the file in that
directory. If the path does not exist, it will store it in
the specified by the dd command.
grl - This command has no arguments and all SDPL protocols will force
RTS off while writing received data to disk (temporarily
preventing the modem from sending additional data). RTS is
turned back on as soon as the disk write is finished. This
option might be required when running SDPL under some
multi-tasking operating systems or in network environments
that leave interrupts disabled while writing to network devices.
SDPL defaults this to off.
ie: SDPL rz grl
The above would receive/download a file(s) into the current
directory using COM 1 and using the incoming file names. It
would also lower the RTS signal every time the data was
written to disk.
dhw - This command accepts a numeric argument that specifies the amount
of time, (in tics), to wait before retrying a handshake
signal. Note: ASCII does not use handshaking and the ZModem
default is 60 seconds/1092 tics as opposed to the 10
second/182 tic default for all other protocols. This will usually
be used in conjunction with the dhr command.
ie: SDPL rz dhw=120 dhr=20
The above would receive/download a file(s) using ZModem, COM1,
the current directory as the destination, incoming file name(s),
and would set the handshake to a 120 second/1092 tic timeout with
20 retries.
dhr - This command accepts a numeric argument that specifies the
maximum number times to retry a handshake before aborting
the protocol. This will usually be used in conjunction with the
dhw command.
ie: SDPL rz dhw=120 dhr=20
The above would receive/download a file(s) using ZModem, COM1,
the current directory as the destination, incoming file name(s),
and would set the handshake to a 120 second/1092 tic timeout with
20 retries.
dtt - This command accepts a numeric argument that specifies the number
of tics to wait for a receiver flow control release.
SDPL defaults this to 1092
ie: SDPL rz dtt=182
The above would receive/download a file(s) using COM1, ZModem,
the current directory as the destination, and set the timeout
for a receiver flow control release to 182 tics/10 seconds.
dsi - This command accepts a numeric argument that specifies the amount
of time to wait between updates to the status screen in tics.
SDPL defaults this to 91 tics/5 seconds
ie: SDPL rz dsi=182
The above would receive/download a file(s) using COM1, ZModem,
the current directory as the destination, and set the status
screen update interval 10 182 tics/10 seconds. This may
improve throughput but it will rarely be noticed.
bfc - This command accepts a numeric ASCII representation argument
that specifies the fill character for partial protocol blocks.
A block fill character is used to fill the last block transmitted
by a protocol that doesn't keep track of the file size.
SDPL defaults this to 26/^Z
ie: SDPL rx bfc=13
The above would receive/download a file(s) using COM1, XModem,
the current directory as the destination, and set the block
fill character to a carriage return.
gho - This command accepts a numeric argument that specifies the
difference, in hours, between the current time zone and the
Greenwich Meridian Time (GMT). The specifications for YModem
and ZModem state the file creation date stamp should be
referenced to GMT. In order to meet this specification both
the receiver and transmitter must adjust the time stamp by
the difference between the current time zone and the GMT time
zone. In practice, most YModem and ZModem implementations
ignore this.
SDPL defaults this to 0.
ie: SDPL rz gho=1
The above would receive/download a file(s) using COM1, ZModem,
the current directory as the destination, and set the GMT
offset to 1 hour.
td - This command accepts a numeric argument that specifies the Telix
delay, (in tics). You will usually never need this.
SDPL defaults this to 9
ie: SDPL rz td=12
The above would receive/download a file(s) using COM1, ZModem,
the current directory as the destination, and set the Telix
delay to 12 tics.
dd - This command accepts a character string argument that specifies
the destination directory for received files. This option will
be used depending on other options selected.
SDPL defaults this to a blank, meaning the current directory.
ie: SDPL rz ghd dd=c:\SDPL
The above would receive/download a file(s) using the incoming
name(s). SDPL will check the pathing of each file being
received and if the path exists will store the file in that
directory. If the path does not exist, it will store it in
the specified by the dd command.
fln - This command accepts a character string argument that specifies
the path and name for the file log. The file log will log
information about your transfers. The logging capabilities
are only activated if a name and path are specified. Otherwise
SDPL will not log transfer information. This file is an ASCII
text file.
SDPL defaults this to blank, meaning no logging capabilities.
ie: SDPL rz fln=c:\SDPL\SDPL.log
The above would receive/download a file(s) using COM1, ZModem,
the current directory as the destination, and saves transfer
information in a file named SDPL.log in a directory named SDPL
on the C drive.
oh - This command accepts a numeric argument that specifies the
number of overhead bytes per block. This does not affect the
block sizes for the protocols. It is simply a modification
procedure for efficiency calculations on the status screen. This
could be handy when using directly linked PCs.
ie: SDPL rz oh=256 std=500
The above would receive/download a file(s) using COM1, ZModem,
the current directory as the destination, set the overhead block
size to 256, and set the turn around delay to 500.
std - This command accepts a numeric argument that specifies the turn
the time, (in milliseconds), that it takes the block to get to
the remote, for the remote to acknowledge and for that
acknowledgement to reach us. It is simply a modification
procedure for efficiency calculations on the status screen. This
could be handy when using directly linked PCs.
ie: SDPL rz oh=256 std=500
The above would receive/download a file(s) using COM1, ZModem,
the current directory as the destination, set the overhead block
size to 256, and set the turn around delay to 500.
fs - This command has no arguments and simply tells SDPL to always
update the status screen.
si - This command acts the same as the dsi command.
sab - This command accepts a numeric argument that sets the actual BPS
(needed only if modem differs from port).
This routine may be used in cases such as the following:
- Two machines are communicating at 9600 BPS via MNP or
v.32 modems
- Both modems are using their built in data compression
facilities to increase the effective BPS rate
- The machines are communicating at a rate of 19200 baud to
insure that the modem doesn't have to waste time waiting
for data to send, and they are using hardware flow control
to pace the flow of data between the modems and machines
In such a case the protocol will base any transfer rate
calculations on a BPS rate of 19200, the rate at which the data
is being sent to the modem, and it will under estimate the
efficiency of the transmission, since the data isn't actually
being sent to the remote at that rate.
To get more accurate calculations in this case you would set
the actual BPS to 9600, the rate at which the data is being sent
to the remotes modem. The calculations will be slightly
inaccurate but will better reflect the actual efficiency.
ie: SDPL rz sab=9600
The above would receive/download a file(s) using COM1, ZModem,
the current directory as the destination, and set the actual
BPS to 9600
soo - This command accepts a numeric argument in the range of 1 to 3.
It sets option for what to do when the destination file already
exists. The following is a list of actions SDPL will take
when using this option:
1 - Will abort the transfer
2 - Will rename the incoming file and write to that name
3 - Will overwrite the file
SDPL defaults this to 1
ie: SDPL rz soo=2
The above would receive/download a file(s) using COM1, ZModem,
the current directory as the destination, and would rename the
incoming file(s) if they already exist.
@fl - This command accepts a character string argument that specifies
the path and name to the list of files you wish to transfer.
This file is an ASCII text file with each file/path on a
separate line. This will allow you to set up batch transfers
easily and quickly.
com - This command accepts a numeric argument between 1 and 36. It
specifies the comport you wish to use. 1 = COM1, 2 = COM2, etc..
ie: SDPL rz com=2
The above would receive/download a file(s) using COM2, ZModem,
the current directory as the destination, and would rename the
incoming file(s) if they already exist.
bd - This command accepts a numeric argument that specifies the baud
rate, that is different from the current port, you wish to use.
This should rarely be used.
ie: SDPL rz com=2 bd=2400
The above would receive/download a file(s) using COM2, ZModem,
the current directory as the destination, would rename the
incoming file(s) if they already exist, set the baud rate to
2400.
irq - This option accepts a character string argument that equates to
Non-Standard IRQs and/or base addresses. This is accomplished
by the following rules:
1 - Irq value must be in the range of 0 and 15.
2 - Base Address is Hexadecimal string.
3 - The irq value must be specified first, then a /, the
the hexadecimal base address string.
ie: SDPL rz com=2 bd=2400 irq= 7/02E8
The above would receive/download a file(s) using ZModem,
the current directory as the destination, would rename the
incoming file(s) if they already exist, set the baud rate to
2400, and define COM2 as using interrupt 7 and address 2E8.
fnm - This command accepts a character string argument which specifies
the name/path for a file to be transferred or received.
ie: SDPL rz com=2 bd=2400 irq= 7/02E8 fnm=c:\SDPL\test.txt
The above would receive/download a file(s) using ZModem,
the current directory as the destination, would rename the
incoming file(s) if they already exist, set the baud rate to
2400, define COM2 as using interrupt 7 and address 2E8, and
receive a file named test.txt to a directory named SDPL on the
C drive.
inb - This command accepts a numeric argument that defines the
size of the input buffer.
SDPL defaults this to 4096
ie: SDPL rz com=2 bd=2400 irq= 7/02E8 fnm=c:\SDPL\test.txt inb=1024
The above would receive/download a file(s) using ZModem,
the current directory as the destination, would rename the
incoming file(s) if they already exist, set the baud rate to
2400, define COM2 as using interrupt 7 and address 2E8,
receives a file named test.txt to a directory named SDPL on the
C drive, and sets the input buffer to 1024 bytes.
otb - This command accepts a numeric argument that defines the
size of the output buffer.
SDPL defaults this to 4096
ie: SDPL rz com=2 bd=2400 irq= 7/02E8 fnm=c:\SDPL\test.txt otb=1024
The above would receive/download a file(s) using ZModem,
the current directory as the destination, would rename the
incoming file(s) if they already exist, set the baud rate to
2400, define COM2 as using interrupt 7 and address 2E8,
receives a file named test.txt to a directory named SDPL on the
C drive, and sets the output buffer to 1024 bytes.
par - This command accepts a character string argument that changes
the current parity type. Valid arguments are as follows:
NoParity
OddParity
EvenParity
MarkParity
SpaceParity
ie: SDPL rz par=NoParity
The above would receive/download a file(s) using ZModem, the
current directory as the destination, COM1, and set the parity
to None.
stb - This command accepts a numeric argument that overrides the
current stop Bit value. Valid range is 1 to 2.
ie: SDPL rz par=NoParity stb=2
The above would receive/download a file(s) using ZModem, the
current directory as the destination, COM1, sets the parity
to None, and sets the stop bits to 2.
dtb - This command accepts a numeric argument that overrides the
current data bit value. Valid range is 5 to 8.
ie: SDPL rz par=NoParity stb=2 dtb=6
The above would receive/download a file(s) using ZModem, the
current directory as the destination, COM1, sets the parity
to None, sets the stop bits to 2, and sets the data bits to 6.
hud - This command has no arguments and simply tells to utilize DTR
for Receive Flow Control
ie: SDPL rz hud
The above would receive/download a file(s) using ZModem, the
current directory as the destination, COM1, and implement a
DTR hardware flow control method.
hur - This command has no arguments and simply tells to utilize RTS
for Receive Flow Control
ie: SDPL rz hur
The above would receive/download a file(s) using ZModem, the
current directory as the destination, COM1, and implement a
RTS hardware flow control method.
hrd - This command accepts no arguments and simply tells SDPL to require
a DSR signal before transmitting
ie: SDPL rz hrd
The above would receive/download a file(s) using ZModem, the
current directory as the destination, COM1, and would require
a DSR signal before transmitting.
hrc - This command accepts no arguments and simply tells SDPL to require
a CTS signal before transmitting
ie: SDPL rz hrc
The above would receive/download a file(s) using ZModem, the
current directory as the destination, COM1, and would require
a CTS signal before transmitting.
hdl - This command has no arguments and simply tells SDPL to set the
DTR signal low.
ie: SDPL rz hdl
The above would receive/download a file(s) using ZModem, the
current directory as the destination, COM1, and would set the
DTR signal low.
hrl - This command has no arguments and simply tells SDPL to set the
RTS signal low.
ie: SDPL rz hrl
The above would receive/download a file(s) using ZModem, the
current directory as the destination, COM1, and would set the
RTS signal low.
hsl - This command has no arguments and simply tells SDPL to set the
DSR signal low.
ie: SDPL rz hsl
The above would receive/download a file(s) using ZModem, the
current directory as the destination, COM1, and would set the
DSR signal low.
hcl - This command has no arguments and simply tells SDPL to set the
CTS signal low.
ie: SDPL rz hcl
The above would receive/download a file(s) using ZModem, the
current directory as the destination, COM1, and would set the
CTS signal low.
rpg - This command accepts no arguments and tells SDPL to return
whatever exists in the input buffer if it is a partial block.
rd - This command accepts no arguments and tells SDPL to return the
delimiter character used as well as the string it delimits.
epp - This command accepts no arguments and tells SDPL to store as much
data as possible, in the output buffer, if there is not enough
room to store the whole block.
idc - This command has no arguments and tells SDPL to treat characters
in a delimited set with case sensitivity.
roc - This command has no arguments and simply tells SDPL to restore the
UART to its original state when the session is completed.
dmc - This command has no arguments and simply tells SDPL to hangup
the modem when the session is completed.
rmo - This command accepts no arguments and tells SDPL to raise the DTR
and RTS signals when the session is started.
idt - This command has no arguments and tells SDPL not to initialize
the port with DTR low.
irt - This command has no arguments and tells SDPL not to initialize
then port with RTS low.
dsz - This command has no arguments and tells SDPL to adhere to DSZ
standards. This will allow you to setup SDPL as a DSZ protocol
inside PCBoard.
9 - Additional Programs
With the SDPL bundle you will receive four programs designed to
help you define various values for the commands specified in this
manual.
SEC2TIC.EXE - This program will allow you to find out what the
proper tic value is for a value in seconds. These
conversions depend on your system so be sure to run
it at least once.
TIC2SEC.EXE - This program will allow you to find out what the
proper second value is for the tics specified. These
conversions depend on your system so be sure to run
it at least once.
MILL2SEC.EXE - This program will tell you what the specified
millisecond value equates to in seconds.
SEC2MILL.EXE - This program will tell you what the specified second
value equates to in milliseconds.
10 - Registration
Upon Registering SDPL you will receive a serialized copy of SDPL that will
allow you to access many other features.
Pricing and taxation is based upon the shipping point.
You can order SDPL online at Streamline Design or The Support Group using
a VISA or Mastercard. You can also order over the phone using VISA or
Mastercard.
-------------------------------------------------------------------------------
Order Form
-------------------------------------------------------------------------------
Addressing Information
Billing Address Shipping Address
Name : ________________________ Name : ________________________
Company : ________________________ Company : ________________________
Department : ________________________ Department : ________________________
Address : ________________________ Address : ________________________
: ________________________ : ________________________
: ________________________ : ________________________
Prov/State : ________________________ Prov/State : ________________________
City : ________________________ : ________________________
Country : ________________________ Country : ________________________
Postal/ZIP : ________________________ Postal/ZIP : ________________________
Phone 1 : ________________________ Phone 1 : ________________________
Phone 2 : ________________________ Phone 2 : ________________________
Product Information - Please Ship [ ] Will Download [ ]
Please allow 3 to 4 business days upon receipt for processing.
Shipping Media
3 1/2 inch, 720 Diskette [ ] 3 1/2 inch, 1.44 Diskette [ ]
5 1/4 inch, 360 Diskette [ ] 5 1/4 inch, 1.2 Diskette [ ]
Download Media
ZIP File Format Ver 1.02 [ ] LHARC File Format Ver 1.13 [ ]
ARJ File Format Ver 2.22 [ ] PKPAK File Format Ver 3.61 [ ]
Quantity 1 to 9 : ____________ x 35.00 = Subtotal: ________________
Quantity 10 to 24 : ____________ x 32.00 = Subtotal: ________________
Quantity 25 to 49 : ____________ x 28.00 = Subtotal: ________________
Quantity 50 to 99 : ____________ x 20.00 = Subtotal: ________________
Quantity 100 and above, please call.
Ontario Residents add 7% Sales Tax Taxation: ________________
and 8% GST
The Rest of Canada add 8% GST
Add 5.00 for Shipping and handling Shipping: ________________
Total : ________________
Credit Card Information
Name on Card : _________________ Card Type: VISA [ ] MasterCard [ ]
Credit Card # : _________________ Expiry : _______
Thank You for using The Streamline Design Protocol Module