Programmer 7500

home *** CD-ROM | disk | FTP | other *** search

/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / COMMUNIC / K9X88D_3.ZIP / DOCS.ZIP / DSZ.DOC < prev next >

Wrap

Text File | 1988-01-10 | 40.2 KB | 991 lines

DSZ(Shareware) Omen Technology DSZ(Shareware) NAME dsz - ZMODEM, True YMODEM(TM), XMODEM file transfer subprogram SYNOPSIS dsz [CON] [port N] [speed S] [handshake XX] [D] [d] command DESCRIPTION Dsz is a "protocol driver" that uses the ZMODEM, True YMODEM(TM), or XMODEM protocol to transfer files over a serial port with a variety of programs. Non registered users are granted a license to use dsz for a limited evaluation period. Otherwise, use of dsz requires registering the copy. Registration enables some advanced features. If you received this copy of DSZ with another progam, even if your copy of the other program is registered, this copy of DSZ has not been registered. Please refer to the licensing information below, and support the continued development of high quality shareware. ZMODEM Transfers feature 32 bit CRC, crash recovery, and advanced file management. When calling bulletin boards to download files with ZMODEM or True YMODEM(TM), you can avoid the bother of starting DSZ for each transfer by calling dsz first, before asking the BBS for the download (dsz t). The "t" command allows you to keyboard the file request to the BBS. DSZ's ZMODEM AutoDownload then receives the file automatically, without any wasted keystrokes or delay. Try it, you'll like it! (The "t" command is described below.) True YMODEM(TM) transfers preserve exact file length and modification time. Dsz supports XMODEM-1k (XMODEM with 1024 byte blocks, sometimes mislabeled YMODEM) and CRC-16 with the sx -k and rc commands. Dsz is derived from Omen Technology's Professional-YAM communications software, (also published by POLYTRON Corp of Hillsboro Oregon as PowerCom(TM)), and supports a subset of Pro-YAM's file transfer related commands. This documentation makes extensive references to contemporary editions of the ZCOMM or Pro-YAM manual, and is incomplete without it. Dsz is designed to be called from a communications bulletin board program. Dsz may also be called from other Page 1 (printed 1/10/88) DSZ(Shareware) Omen Technology DSZ(Shareware) communications programs, but the combination lacks much of the power of a communications program with integrated ZMODEM. Dsz uses its own modem I/O. The original interrupt vector, UART parity, interrupt configuration, and 8259 interrupt mask are restored on exit. Dsz uses DOS standard output (stdout) for messages, it does not write directly to the screen. Dsz expects its standard output to point to the console, a logging file, or NUL, not the modem port. If necessary, dsz's standard output may be redirected to the console device with the CON command. If dsz's standard output has been redirected to the modem (as with ProComm's Host mode DOS shell), failure to use the CON command may lock up the computer. Dsz exits with 0 status for successful transfers, or the value of the Q parameter (default 1) if a file transfer failed. Some languages do not return this information to the calling program. A batch file that calls dsz directly may be used to detect the dsz exit status, or dsz's log file entries may be examined. ENVIRONMENT VARIABLES DSZLOG log file to receive entries for files sent and received. (Default null). Sample entries: Z 46532 38400 bps 3324 cps 0 errors 66 1024 DSZ.COM 1177 Z 124087 19200 bps 1880 cps 0 errors 6 1024 MXY.TMP 1177 Transfer times are based on the DOS time of day clock and have one second jitter. As with all protocol throughput reports generated by Omen Technology programs (and contrary to the false claims of some critics), dsz's throughput figures for ZMODEM, Kermit, and True YMODEM(TM) transfers do not take "credit" for pathname and/or protocol overhead characters. Dsz's throughput reports do not include the time required to send the pathname. This understates the true time required to transfer files, but the time required to send the pathname often depends on the alacrity of the operator, and thus does not always reflect the performance of the protocol itself. Transfers measuring less than one second are reported as having 9999 characters per second throughput. The unlabeled numeric field after the error (retry) Page 2 (printed 1/10/88) DSZ(Shareware) Omen Technology DSZ(Shareware) count is the number of flow control stoppages encountered sending the file. This number gives an indication of flow control restrictions (overloaded networks, etc.) encountered during the transfer. The last numeric field before the file name is the block or subpacket length used for the last block in the file. The last field is the serial number of the other program, or -1 if this information is not available. The code letter indicates the type of transfer, Z (ZMODEM), S (X/YMODEM), R (X/YMODEM), E (error), or L (transfer terminated by loss of data carrier). DSZOPT String containing default options for DSZ file transfers. (Registered copies only) An 8n may be appended to the string to make BBS (ANSI) graphics the default for dsz's t command. The ability to preset these options is especially helpful with dsz's t command. EXAMPLE: C>set DSZOPT=r Enables dsz's intelligent Crash Recovery as a default. Let's say you wish ZMODEM crash recovery, and BBS "graphics" for the term function: C>set DSZOPT=r8g WARNING: Do NOT include "ena" in the string. MAXBYTES Maximum number of bytes allowed for transfer. If this number is exceeded, dsz skips the offending files (ZMODEM) or aborts remaining files in the batch (YMODEM). DSZPORT Default communications port override, default 1. EXAMPLE: C>set DSZPORT=2 ZONE sets the z numeric parameter to the number of minutes the current local time lags GMT time. PDT or MST corresponds to 420. (Registered copies only) EXAMPLE: C>set ZONE=420 COMMANDS Dsz commands are an improper subset of Pro- YAM/PowerCom/ZCOMM commands. Except as noted, all commands must be in lower case, are exectued left to right, and must be entered in the order shown at the beginning of this document. Unlike ZCOMM, PowerCom, and Pro-YAM, dsz does not support Page 3 (printed 1/10/88) DSZ(Shareware) Omen Technology DSZ(Shareware) ZMODEM AutoDownload with ZMODEM security challenge. (AutoDownload is a pleasant user interface that recognizes the start of a file download and automatically starts the correct file transfer protocol. Please refer to the ZCOMM/PowerCom/Pro-YAM user manual for details on this powerful and convenient feature.) Unregistered copies of dsz do not support OverThruster(TM). Dsz does not support Kermit, Kermit AutoDownload, Super Kermit, B Protocol, the traditional XMODEM variants MODEM7 batch, Telink, WXMODEM, and Clink/SEAlink supported by Pro-YAM/PowerCom/ZCOMM. Interrupt keys: Ctrl-Break Terminates the transfer in progress. ALT-N Abruptly terminates (NUKES) the transfer in progress. When used, the CON, port, speed, handshake, and d commands must be given in the order shown. CON Redirect message output to the DOS "CON" (console) device, overriding any previous redirections. handshake XX Enable one of several choices of hardware handshake. (The default is XOFF/XON software handshake). This command is documented in the ZCOMM or Pro-YAM manual. port N select port N (n = 1,2,3,4 ... 8) Default is port 1 (COM1) or read from the DSZPORT dos environment variable. In multitasking operation, accessing a port used by another running program will hang the machine. EXAMPLE: to use COM2: dsz port 2 rz speed S Set the specified speed. This command is rarely needed because dsk reads the port's current speed by default. Please refer to to the FLOW CONTROL, MAIN COMMANDS and SOFTWARE COEXISTENCE chapters in the ZCOMM or Pro-YAM manual for important information about the speed command. D Diaables the modem (drops Data Terminal Ready, DTR) if carrier is lost. This may be used to prevent spurious events from interfering with a bulletin board's recovery from carrier loss. d Disables carrier dropout monitoring, for modems that do not properly drive the "Data Carrier Detect" input on the PC. LARG Convert ARG to lower case, then parse arg. pxN Set a numeric parameter x to N. These parameters are a subset of the Pro-YAM or ZCOMM numeric parameters, and Page 4 (printed 1/10/88) DSZ(Shareware) Omen Technology DSZ(Shareware) are listed below. They assume their defaults each time dsz is called. Without an argument, p displays the numeric parameters and their values. z pxN Set zmodem numeric parameter x to N. These parameters correspond to the Pro-YAM or ZCOMM "zmodem" parameters and rarely need changing. These parameters assume their defaults each time dsz is called. Without an argument, z p displays the zmodem numeric parameters and their values. restrict Restrict pathnames to the current disk and directory tree, and disallows overwriting of existing files. When dsz is restricted, it will refuse to transfer files containing the string autoexec.bat and command.com in either case. This provides some defense from malicious uploaded files. t [-8g] Talk with ZMODEM AutoDownload. The optional -8g (available on registered copies only) allows "BBS (ANSI) graphics". A small subset of ZCOMM/Pro-YAM term function subcommands are recognized. Keyboard F1 or ALT-X to exit. F3 receives file(s) with True YMODEMTm, ALT-P toggles parity between the 8n default and 8g (enables ANSI "graphics"). ALT-H toggles two local echo ("Half Duplex") modes; the second displays a newline on Enter. Keyboarded ASCII characters are sent to the modem. Modem characters print on the screen. A device driver such as ANSI.SYS may be used to recognize escape sequences. ZMODEM AutoDownload detects the start of a ZMODEM file download and accepts the file(s) without operator intervention. sz [-abefnprtY+y] [-w[N]] [PREFIX=p | ONAME=n] file ...(ZMODEM) sb [-ft] [PREFIX=p | ONAME=n] file ... (YMODEM) sb -k [-ft] [PREFIX=p | ONAME=n] file ... (YMODEM-1k) sx [-t] file1 (XMODEM or XMODEM/CRC) sx -k [-t] file1 (XMODEM-1k) rz [-abenprt+Yy] [dir] [file ...] (ZMODEM) rb [-abt+y] [dir] [file ...] (YMODEM) rb -g [-abt+y] [dir] [file ...] (YMODEM-g) rc [-abt+y] file1 (XMODEM/CRC) ro [-abt+y] file1 (XMODEM OverThruster) Page 5 (printed 1/10/88) DSZ(Shareware) Omen Technology DSZ(Shareware) rx [-abt+y] file1 (XMODEM) PARAMETERS Dsz uses the following main numeric parameters, settable with the pxN command. EXAMPLE: dsz pB4096 In addition, dsz uses the Pro-YAM/ZCOMM zmodem numeric parameters described in the Pro-YAM/ZCOMM manual. B Set the size of buffer used for disk reads and writes. The default is 1024, 8192 maximum. A larger value may give better results when sending files to or from from sluggish floppy disk systems. Too large a value will exhaust memory or induce receiver timeouts. This parameter is supported on versions compiled with TurboC. Q Error code returned to DOS (default 1). (Success returns 0.) Some programs toss cookies when confronted with certain exit codes. O Controls OverThruster(TM) operation with XMODEM, XMODEM-1k, and YMODEM downloads. This parameter should be set as follows: CompuServe XMODEM Negative numbers control the number of bytes added to the window on XMODEM downloads from the CompuServe Information Service. Larger numbers increase throughput, but cause improperly interfaced MNP modems on CIS nodes to drop characters under stress, disrupting the file transfer. EXAMPLE: dsz pO-512 ro file1.ext Other XMODEM Positive numbers up to a system dependent value less than the protocol block size increase throughput. Larger values induce timeouts and/or retransmitted blocks. The optimum value must be determined by experiment. 60 usually give best results with MNP modems at 2400 bps. The optimum value varies depending on the remote computer, modem(s), system traffic, and the network node. EXAMPLE: dsz pO60 ro file1.ext S Timeout in seconds (default 15) waiting for restraint release (XON and/or handshake). W Wait for Enter key before exiting after an error. Useful when calling dsz from DESQview, allows the window to close unless there is an error message that should remain visible. a Calibrates certain protocol timeouts used with XMODEM and YMODEM transfers (Cybernetic Data Recovery(TM)). The a numeric parameter is automatically set to 2000 for a 4.77 mHz PC or XT, 4000 for a PS2/30, 6000 for an 8 mHz 1ws AT, and 12000 for a PS2/80. If your computer Page 6 (printed 1/10/88) DSZ(Shareware) Omen Technology DSZ(Shareware) has a speedup card or otherwise runs unusually fast (or slow!) for its type, you should set the a numeric parameter to a value that reflects its speed. v Verbose level (debugging output) Negative values inhibit some routine messages z Timezone in minutes behind GMT, used for ZMODEM and True YMODEM file transfers to coordinate the actual date of the file with computers in other time zones. Effective on registered copies. PDT or MST corresponds to 420. This may be preset with the ZONE DOS environment variable. BACKGROUND OPERATION Three DESQview description files are provided to demonstrate background operation with modest (66 kb window) memory requirements. Dsz uses tight C/ASM code, table driven CRC generators, and buffered receive and transmit for good performance in the background without hogging CPU cycles. On a QIC Labs PC-AT clone, dsz can download files in the background (3 background clock ticks, 9 foreground clock ticks) with a throughput better than 9600 bps. 2S Prompts for file name(s) and sends them with ZMODEM protocol. 2T Talks to the modem and allows manual YMODEM (F3) or automatic ZMODEM downloads. 2A Like 2T, but using Quarterdeck's dvansi.com memory resident ANSI CRT device driver to process ANSI screen codes. DS.BAT is the batch file used by 2A. These files are written for a port 2 local connection and \TMP directory, but may be modified to suit your requirements using the DESQview CP command. The W numeric allows DESQview to close the window after dsz finishes, providing a pleasant user interface. Operation at high speed (above 9600 bps) requires the DESQview "Optimize communications" performance Advanced Setup option. *********************************************************** WARNING When running dsz under a multi tasking system such as DESQview, do not allow two programs to access the same comm port at the same time. At best, such actions will disrupt communications. At worst, your computer will attempt to open a subspace channel to V'ger. *********************************************************** FLOW CONTROL Please refer to the Pro-YAM, PowerCom, or ZCOMM manual FLOW CONTROL chapter for important information on flow control Page 7 (printed 1/10/88) DSZ(Shareware) Omen Technology DSZ(Shareware) considerations necessary for proper operation of ZMODEM and other streaming protocols with buffered (error correcting) modems and/or networks. EXAMPLES dsz sz c:foo.* b:*.c (send files) dsz sz -r yzmodem.arc (CRASH RECOVERY: resume interrupted transfer) dsz handshake both sz yzmodem.arc (Hardware+Software handshake) dsz sz -n *.* (send files that are newer or rx has no copy) dsz sz -Yn *.* (Only send files that are newer than receiver's copy) (Do not send files that do not exist on receiver's disk) dsz rz C:/UPLOADS (receive files to specified directory) dsz port 2 speed 38400 restrict rz dsz rz -y prog.arc (ZMODEM, single file pathname override) dsz z pr1 rx foo.dat (XMODEM receive, remove file if error) dsz pO60 ro foo.dat (XMODEM/OverThruster receive, GEnie MNP) DSZ LRC L-Y NEWPROG.ARC (generate lower case "rc -y" command) dsz pv2 sz foo >debug.dmp (Debugging data dump) ERROR MESSAGES The message Abnormal program termination is printed by the TurboC startup routine if dsz is run in too small a memory partition. If you see this message, use a larger memory partition for dsz or remove some memory resident programs. This message may also appear if the calling program fails to free memory before calling dsz. The message Unknown Machine Type XX, Assuming AT indicates a ROM BIOS that does not follow the IBM specification for identifying the machine type. If your computer causes dsz to display this message, you must set the a numeric Page 8 (printed 1/10/88) DSZ(Shareware) Omen Technology DSZ(Shareware) parameter described elsewhere in this document. A perplexing, cryptic message comes from the Microsoft C Library: "Permission denied". This may be caused by attempts to modify a read only file or directory, or create a file in a nonexistient directory. A furtive flashing appearance of "XOFF" or "FLOW" during ZMODEM or YMODEM-g file sending signifies dsz is responding to flow control restraint. This is normal operation when buffered modems or packet switched networks are used. ZMODEM's robustness and reliability allow creative users to transfer files over unusual multiple computer lash-ups, causing modem data lights and computer status displays to dance in unfamiliar rhythms. Other Dsz error messages are listed in the Pro-YAM manual. SEE ALSO Consult the Professional-YAM, PowerCom, or ZCOMM manual chapter "OPTIONS FOR FILE TRANSFERS" for option meanings. The "FILE TRANSFER BASICS" chapter explains the relative merits of XMODEM, YMODEM, ZMODEM, and other protocols and gives tips on their use. The "MAIN COMMANDS" chapter describes the rb, rx, rc, rz, sb, and sz commands. The "MODEM INTERFACING" and "FLOW CONTROL" chapters contain important information on the use of buffered modems with dsz. Information on the ZMODEM Inter Application File Transfer Protocol may be found in ZMODEM.DOC, part of YZMODEM.ZOO (yzmodem.arc). C Source code for XMODEM, YMODEM, and ZMODEM transfers is included in RZSZ.ZOO. This file includes a Pro-YAM/ZCOMM script to upload a bootstrap file to a Unix system, force its compilation, and (if the compilation is successful) upload the rz/sz source files. GT POWER 13.00 GT Power version 13.00 includes a YMRX.BAT (YMODEM-g receive) file with an "rz" command. You guessed it, "rz" is for ZMODEM protocol (the z means ZMODEM!). Please change the file to use the correct "rb -g" for YMODEM-g. The files ZMTX.ARC and GT1300.NOT available on many bulletin boards contain useful information for GT Power users. PROCOMM When running under ProComm's Host mode, failure to use the CON command may cause Procomm to lock up the computer. The POE and PROZ programs have been popular in interfacing DSZ to Procomm's editor gateway. Page 9 (printed 1/10/88) DSZ(Shareware) Omen Technology DSZ(Shareware) VCACHE Virtual memory disk caches and ramdisks using 80286 extended memory require a hardware reset of the 80286 chip to return to the normal "real mode" after accessing extended memory. This interference to the interrupt response time causes lost characters on comm ports, and may be minimized by specifying shorter memory transfers. BULLETIN BOARDS When installing dsz on a bulletin board or host system, be sure to check for proper operation when the caller hangs up while a file is being sent or recieved. Currently, Only the TurboC version supports file sharing (shared read access on files sent by dsz). Some bulletin board interface routines do not call dsz to send a file until they have verified the file's existience by opening the file. If this checking is done in MS-DOS's default exclusive open mode, dsz's file sharing will be defeated. NOTES If you have difficulty getting dsz to work, start with the following command to dsz directly from the DOS prompt, without running any other COMM program: dsz port 1 speed 2400 d t (Change the port number and speed as necessary.) This connects you to the modem. Dial a bulletin board by typing AT commands to the modem ("ATDP621-3406"). Log in, and request a ZMODEM download. The file will transfer automatically. The "sb" and "sz" commands exploit DOS's tree structured file system. An "sz" command with no file specified sends all the files in the current directory. A directory or disk specifier expands to all files in that directory. DOS 3.x systems may need to have a "STACKS = 8,256" line in CONFIG.SYS to prevent antisocial behavior. This is required on the NEC Multispeed, or if certain TSR's are used. A few machines, some with V20 CPUs, don't like DSZ.COM. We have not been able to repeat this; TeleGodzilla (using a V20) runs DSZ.COM without a hitch. Switching to DSZ.EXE has cleared up the problems on other machines. Some XMODEM programs claiming to support YMODEM do not send or accept the YMODEM pathname block. 1024 byte XMODEM is XMODEM-1k, not YMODEM as defined by Ward Christensen in 1985 when he coined the word. 1987 versions of YMODEM.DOC remind the reader of the official YMODEM definition. Page 10 (printed 1/10/88) DSZ(Shareware) Omen Technology DSZ(Shareware) 32 bit CRC code courtesy Gary S. Brown. Cybernetic Data Recovery(TM), Error Containment(TM), OverThruster(TM), Password Guardian(TM), CryptoScript(TM), and TurboDial(TM) are Omen Technology trademarks. PowerCom was trademarked in 1985 by POLYTRON Corporation, Hillsboro Oregon. Dsz and this documentation are Copyright 1988 by Omen Technology Inc, all rights reserved. True YMODEM(TM) is an Omen Technology Trademark signifying YMODEM protocol support that meets the full YMODEM specification. FILES ZCOMMDOC.ARC, ZCOMMEXE.ARC, ZCOMMHLP.ARC, YZMODEM.ZOO (yzmodem.arc) (Official XMODEM, YMODEM, and ZMODEM Protocol Description), RZSZ.ZOO (rzsz.arc) (Unix/Xenix source code), 2S-PIF.DVP, 2A-PIF.DVP, DS.BAT, 2T-PIF.DVP DSZ.COM, DSZ.DOC (this file). DSZ.EXE compiled with the Xenix to DOS XC provides moderately higher maximum throughput (1700 vs 1300 cps downloading to a 4.77 mHz XT). The speed difference is a function of the compiler, the source code is the same. The Xenix XC version requires more memory, and does not support file sharing or a large I/O buffer. This version is available in DSZEXE.ZOO. ZCOMM and Pro-YAM also run at a higher speed than DSZ.COM. Incompatible batch files may cause dsz to fail. LICENSING INFORMATION Dsz is a user supported program developed and supported by Chuck Forsberg. It has taken countless hours of work and considerable resources to develop and support dsz in the myriad environments users use it. Unlike snazzy menu interfaces, developing high performance transfer protocols takes many hours of testing. Help fight the high cost of software by supporting high quality shareware. Thank you for your support. Dsz is not and never has been public domain. Every version of dsz has included a Copyright Notice and a prohibition against sale or modification. Dsz is not free software. If you use this program, you ought to register it. This documentation file and the MAILER file must be provided with all copies of DSZ except by prior written permission Page 11 (printed 1/10/88) DSZ(Shareware) Omen Technology DSZ(Shareware) from Omen Technology Inc. No version of dsz may be modified, patched, hacked, disassembled, decompiled, or otherwise reverse engineered, or sold, without prior written permission by Omen Technology Inc. Distribution of dsz in any medium without this documentation file constitutes an unauthorized modification. If dsz is distributed with any other product, software or hardware, the product documentation must clearly and promimently state that the customer's continued use of dsz requires registration directly with Omen Technology or its duly authorized agent(s). When dsz is distributed on disk, a contemporary copy of ZCOMMDOC.ARC must be included on the same disk. After an initial short evaluation period, users should register their copy of dsz with a check for $20.00 in U.S. funds sent to: Omen Technology Inc. P.O. Box 4681 Portland, OR 97208 Don't bother scrounging for an envelope, use the INSTANT MAILER included in this archive! Users, especially those overseas, may choose to register their copy of dsz for $25.00 U.S. by providing their VISA or Mastercard card number with expiration date and their name as it appears on their card. *********************************************************** The USER registration package includes a serial number, the latest DSZ programs, the installation program which enables features and bypasses the opening advertisement, and additional documentation. The registration package serializes all past and future versions of DSZ.COM and DSZ.EXE. *********************************************************** The putsnp program inserts YOUR DSZ, ZCOMM, PowerCom, or Pro-YAM Serial Number Password (SNP) into you copy of DSZ: putsnp dsz.com Putsnp accepts your SNP and asks appropriate questions before inserting the SNP. The only legitimate way to disable the opening advertisement in dsz is to insert an authorized SNP obtained from Omen Technology into dsz with the putsnp program. Any other suppression or modification of the opening screen is Page 12 (printed 1/10/88) DSZ(Shareware) Omen Technology DSZ(Shareware) illegal, unethical, and prohibited. Distribution of programs and/or instructions on how to modify, patch, disassemble, decompile, or otherwise reverse engineer dsz without prior written permission by Omen Technology Inc is a theft of services and a violation of federal copyright law, and will be referred to the FBI for investigation and prosecution under federal conspiricy statutes. Applicable RICO law provides for treble damages and recovery of attorney's fees. Dsz may be used and copied by bulletin board systems which feature the ZCOMM files (ZCOMMEXE.ARC, ZCOMMDOC.ARC, ZCOMMHLP.ARC) for downloading. A Dsz registration and a diskette with current versions of the ZCOMM files (for bulletin board downloading) will be mailed upon validation. Dsz may be registered without charge by sending your bulletin board's address, telephone number and a valid login. CHANGES Be sure to save the serial number/password card and putsnp program you received from Omen to use with future versions of DSZ you download! 1-9-87 Code was added to prevent hanging with the Intel 82510 UART chip used in newer Intel add in boards (and possibly elsewhere). More instructions were added to the NOTES chapter of this document. 12-28-87 Spurious ACKs in the YMODEM-g "rb -g" command were eliminated. The -g option now works with the "rx" command to support so called "ymodem g" programs that are not YMODEM at all (rx -g file.ext). Some systems generate incorrect disk free space counts, preventing valid transfers; this check has been eliminated. 12-14-87 The minimum dynamic subpacket length is now 32. MAXBYTES now works for large values. 12-10-87 Documentation enhanced, ds.bat fixed. 12-6-87 New features for bulletin board operators: The "S" option interrogates the other program's serial number (sz -S file...) when sending file(s) with ZMODEM. The serial number has been added to the the log file (last field). Operation of the -S option has been checked with various versions of DSZ, ZCOMM, Pro-YAM, Unix rz, and Opus. Programs derived from the Unix rz source code tend to return the receiver's capability as serial number, but this is no great loss as those programs don't have a serial number anyway. Page 13 (printed 1/10/88) DSZ(Shareware) Omen Technology DSZ(Shareware) The MAXBYTES environment variable may be used to limit the number of bytes transferred. 11-26-87 DSZ.COM is compiled with a newer version of TurboC, which may affect operation (hopefully for the better) on marginally compatible systems that previously induced irreproducible dysfunctions. This version still accepts the TurboC tiny model startup patch, but the patched program requires slightly more memory than before. Sending at 2400 bps, the ZMODEM subpacket length now jumps to 1024 after the first 4k (if no errors). This will improve throughput by a small but measureable amount. (NOTE: Do not confuse the ZMODEM subpacket length with XMODEM's 128/1204 block length.) When DSZ detects carrier loss, it now waits 2 seconds for the modem to stabilize before exiting. The D command was added. These enhancements may help the program or "door interface" calling DSZ to recover from carrier loss more reliably. YMODEM screen display cosmetics have been improved. DSZ now displays its exit status as it exits. 10-27-87 DSZ now sends and displays the total number of bytes, and displays the estimated time to send all of the files in the batch.. 10-25-87 A bug fix for the distributed Demo of GT Power 13.00 is included. The ZCOMM/Pro-YAM "ro" command and O parameter been added for XMODEM OverThruster(TM) downloads. With clean lines, OverThruster can speed up network XMODEM downloads considerably, enough to pay for registration quickly. Typical values for the "O" parameter are 20 to 35 for regular modems, 60 for MNP modems. They vary widely on different systems and even between ports on the same network. For XMODEM downloads from Compuserve, the "O" parameter should be set to 0. EXAMPLE: "dsz pO35 ro speedy.fil" The "w[N]" option was added to allow an easier way to specify a window size for the "sz" command over PC Pursuit. A missing N gives a window size of 4096. This option allows the DSZOPT environmet string to set the window size. The ZCOMM/Pro-YAM "t" option (term talk after transfer) has been added. This allows you to enter a description after uploading a file to a bulletin board. EXAMPLE: "dsz sz -t stealth.zoo" Memory requirements have been reduced by eliminating unused routines. The DIRSIZE environment variable is not used; Page 14 (printed 1/10/88) DSZ(Shareware) Omen Technology DSZ(Shareware) files are sent in directory order. 10-15-87 Disables file sharing calls on DOS levels less than 3.x. Registered copies recognize "t -8g" as well as a trailing "8g" in DSZOPT. 10-6-87 English command error explanations have been reinstated. For registered programs only, the ZONE and DSZOPT environment variables were added. The z parameter now works. The -r option (Crash Recovery) is now intelligent, checking for discrepeancies between the old file and the new file. Acquisition and release of the modem port was enhanced for smoother operation in computers multitasking multiple communications programs on different ports. Pirated/hacked versions of DSZ have cost users and dsz's developer thousands of dollars in lost time and other expenses, in addition to injuring the reputation of Omen Technology and its products. Regrettably, Omen Technology cannot support prior versions of dsz because of this piracy. Name Length Date Time CRC dsz.com 46942 Squeezed 9% 42728 9 Jan 88 3:05a d013 Your copy of dsz show show this information as provided by arc v dsz.arc or pkxarc -v dsz.arc If your copy shows a different CRC or file length, insist on a legitimate copy and report the source of the pirated copy to Omen Technology Inc. Omen Technology Incorporated The High Reliability Software 17505-V Northwest Sauvie Island Road Portland Oregon 97231 VOICE: 503-621-3406 :VOICE Modem: 503-621-3746 Speed 1200,2400,19200 PEP Compuserve:70007,2304 GEnie:CAF UUCP: ...!tektronix!reed!omen!caf Page 15 (printed 1/10/88)