home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / open / dsz0223.lzh / DSZ.DOC < prev    next >
Text File  |  1989-02-23  |  70KB  |  2,341 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                    CONTENTS
  7.  
  8.  
  9.  1.  DESCRIPTION..........................................................   2
  10.  
  11.  2.  EXIT STATUS..........................................................   4
  12.  
  13.  3.  COMMANDS.............................................................   5
  14.      3.1   Interrupt Keys.................................................   8
  15.  
  16.  4.  NUMERIC PARAMETERS...................................................   9
  17.  
  18.  5.  ENVIRONMENT VARIABLES................................................  11
  19.  
  20.  6.  EXAMPLES.............................................................  14
  21.  
  22.  7.  IN CASE OF DIFFICULTY................................................  15
  23.      7.1   LOCKUPS........................................................  15
  24.            7.1.1  Insufficient Memory  15
  25.            7.1.2  Bad COMM Port Configuration  15
  26.      7.2   Incorrect Batch Files..........................................  16
  27.      7.3   No Carrier Detect..............................................  16
  28.      7.4   PKARC 3.6......................................................  16
  29.      7.5   COMMAND NOT FOUND..............................................  16
  30.      7.6   DOS 3.x........................................................  16
  31.      7.7   Perstor Controllers............................................  17
  32.      7.8   IBM PS/2 Model 50Z.............................................  17
  33.      7.9   Brain Damaged UARTS............................................  17
  34.            7.9.1  Everex Internal Modems  17
  35.      7.10  Weird Iron.....................................................  17
  36.      7.11  Will the real YMODEM please stand up?..........................  17
  37.      7.12  286 and 386 Extended Memory....................................  18
  38.  
  39.  8.  BACKGROUND OPERATION.................................................  19
  40.  
  41.  9.  CALLING DSZ FROM COMM PROGRAMS.......................................  20
  42.      9.1   GT POWER 13.00/14.00...........................................  20
  43.      9.2   PROCOMM........................................................  20
  44.      9.3   PROCOMM PLUS...................................................  20
  45.      9.4   Qmodem.........................................................  21
  46.      9.5   BULLETIN BOARDS................................................  21
  47.  
  48. 10.  FLOW CONTROL.........................................................  22
  49.  
  50. 11.  ERROR MESSAGES.......................................................  23
  51.  
  52. 12.  ASSOCIATED DOCUMENTS.................................................  26
  53.  
  54. 13.  FILES................................................................  27
  55.  
  56. 14.  CHANGES..............................................................  28
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66. 15.  Other Omen Technology Products.......................................  30
  67.  
  68. 16.  FAIR PLAY............................................................  31
  69.      16.1  Sharing DSZ Files..............................................  31
  70.      16.2  REGISTRATION...................................................  32
  71.      16.3  Files on Registration Disk.....................................  34
  72.      16.4  Bulletin Board Registration....................................  34
  73.  
  74. 17.  ACKNOWLEDGEMENTS.....................................................  36
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.         DSZ - a ZMODEM, True YMODEM(TM), XMODEM File Transfer Program
  125.  
  126.  
  127.                                 Chuck Forsberg
  128.  
  129.                              Omen Technology Inc
  130.  
  131.  
  132.                                    ABSTRACT
  133.  
  134.  
  135.  
  136.                     ZMODEM - Not just another XMODEM hack
  137.  
  138. The ZMODEM file transfer protocol provides reliable file and command transfers
  139. with complete END-TO-END data integrity between application programs.
  140. ZMODEM's 32 bit CRC protects against errors that continue to sneak into even
  141. the most advanced networks.
  142.  
  143. ZMODEM safeguards all data and supervisory information with effective error
  144. detection.  (XMODEM and many recently introduced protocols do not protect
  145. vital supervisory data!)
  146.  
  147. ZMODEM rapidly transfers files, particularly with buffered (error correcting)
  148. modems, timesharing systems, satellite relays, and wide area packet switched
  149. networks.  ZMODEM's streaming operation eliminates delays caused by
  150. Kermit/XMODEM/YMODEM/JMODEM block acknowledgements.  ZMODEM eliminates the
  151. classic XMODEM/YMODEM/JMODEM PACKET LENGTH compromises between transfer
  152. efficiency and error recovery.  ZMODEM's packet length is the entire file.
  153.  
  154. User Friendliness is an important ZMODEM feature.  ZMODEM AutoDownload
  155. (Automatic file Download initiated without user intervention) greatly
  156. simplifies file transfers compared to traditional protocols.
  157.  
  158. DSZ's ZMODEM provides advanced file management features including Intelligent
  159. Crash Recovery, flexible control of selective file transfers, and security
  160. verified command downloading.
  161.  
  162. DSZ is one of many available programs that implement the ZMODEM file transfer
  163. protocol.
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.         DSZ - a ZMODEM, True YMODEM(TM), XMODEM File Transfer Program
  182.  
  183.                                 Chuck Forsberg
  184.  
  185.                              Omen Technology Inc
  186.  
  187.  
  188.                          Omen Technology Incorporated
  189.                         The High Reliability Software
  190.  
  191.                      17505-V Northwest Sauvie Island Road
  192.                             Portland Oregon 97231
  193.       TeleGodzilla BBS: 503-621-3746 Speed 1200,2400,19200(Telebit PEP)
  194.                               FAX: 503-621-3735
  195.                        Compuserve:70007,2304  GEnie:CAF
  196.                       UUCP: ...!tektronix!reed!omen!caf
  197.  
  198.   *************************************************************************
  199. Registration bypasses the shareware announcement and unlocks the advanced
  200. features in all past and future versions of DSZ.  You don't have to pay and
  201. pay for new versions, one registration "does it all"!
  202.   *************************************************************************
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241. Chapter 1 Pg 2            DSZ Reference Rev 02-23-89           Typeset 2-23-89
  242.  
  243.  
  244.  
  245. 1.  DESCRIPTION
  246.  
  247. DSZ is a "protocol driver" that uses the ZMODEM, True YMODEM(TM), or XMODEM
  248. protocol to transfer files over a serial port with a variety of programs.
  249.  
  250. ZMODEM Transfers feature 32 bit CRC, crash recovery, and advanced file
  251. management.
  252.  
  253. DSZ has three main commands for ZMODEM transfers: "sz" sends file(s), "rz"
  254. receives file(s), and "t" is a terminal emulation function with automatic no-
  255. keystroke ZMODEM file downloads.
  256.  
  257. When calling bulletin boards to download files with ZMODEM you can avoid the
  258. bother of starting DSZ for each transfer by calling DSZ first, before asking
  259. the BBS for the download.          dsz t The "t" command allows you to
  260. keyboard the file request to the BBS.  DSZ's ZMODEM AutoDownload then receives
  261. the file automatically, without any wasted keystrokes or delay.  Try it,
  262. you'll like it!  (The "t" command is described below.)
  263.  
  264. YMODEM downloads are almost as easy.  Use the "t" command as shown above, and
  265. hit the F3 key after telling the board to download a file with YMODEM.
  266.  
  267. ZMODEM and True YMODEM(TM) transfers preserve exact file length and
  268. modification time.
  269.  
  270. DSZ supports XMODEM-1k (XMODEM with 1024 byte blocks, sometimes mislabeled
  271. YMODEM) and CRC-16 with the sx -k and rc commands.
  272.  
  273. DSZ is derived from Omen Technology's "Professional-YAM" high reliability
  274. communications tools, (also known as PowerCom(TM)), and supports a subset of
  275. Pro-YAM's file transfer related commands.  This documentation makes extensive
  276. references to contemporary editions of the ZCOMM or Pro-YAM manual, and is
  277. incomplete without it.  (Registered copies include an alternate, copyrighted
  278. file.)
  279.  
  280. DSZ is designed to be called from a communications bulletin board program.
  281. DSZ may also be called from other communications programs, but the combination
  282. lacks much of the enjoyable user friendliness of a program with integrated
  283. ZMODEM.
  284.  
  285. DSZ uses its own modem I/O.  The original interrupt vector, UART parity, and
  286. interrupt configuration are restored on exit.  The original state of the 8259
  287. interrupt mask bit for this vector is also restored on exit.
  288.  
  289. DSZ uses DOS standard output (stdout) for messages.  It never writes directly
  290. to the screen.  DSZ expects its standard output to point to the console, a
  291. logging file, or NUL, not the modem port.  If dsz's standard output is
  292. redirected to the modem (as with ProComm's Host mode DOS shell), the
  293. combination may lock up the computer.  If necessary, dsz's standard output may
  294. be redirected back to the console device with the CON command.
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301. Chapter 1 Pg 3            DSZ Reference Rev 02-23-89           Typeset 2-23-89
  302.  
  303.  
  304.  
  305. Users of pcAnywhere may use dsz's A command to disable pcAnywhere during file
  306. transfers.
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361. Chapter 2 Pg 4            DSZ Reference Rev 02-23-89           Typeset 2-23-89
  362.  
  363.  
  364.  
  365. 2.  EXIT STATUS
  366.  
  367. DSZ exits with 0 status for successful transfers, or the value of the Q
  368. parameter (default 1) if a file transfer failed, or if no files were
  369. transferred.  Many languages and "door" programs do not return this
  370. information to the calling program.  Some languages and "door" programs freak
  371. out (hang) on certain non-zero exit values.
  372.  
  373. A batch file that calls DSZ directly may be used to detect the DSZ exit status
  374. with the DOS "errorlevel" construct.  Please refer to the Q numeric parameter
  375. below for more information.
  376.  
  377. DSZ's log file entries may also be examined to determine the success or
  378. failure of a file transfer.
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421. Chapter 3 Pg 5            DSZ Reference Rev 02-23-89           Typeset 2-23-89
  422.  
  423.  
  424.  
  425. 3.  COMMANDS
  426.  
  427. dsz [A] [CON] [port N] [speed S] [handshake XX] [D] [d] command
  428.  
  429. DSZ commands are an improper subset of Pro-YAM/PowerCom/ZCOMM commands.  The
  430. file transfer commands are fully described in ZCOMMDOC.ARC, the ZCOMM User's
  431. Manual.  Portions of the ZCOMM User's Manual are provided in DSZBG.ZOO, a
  432. Copyrighted file included with the DSZ registration disk.  Please refer to one
  433. of those documents for details on the following commands.
  434.  
  435.          ***********************************************************
  436.                                   NOTE WELL
  437. Except as noted, all commands must be in entered lower case, NOT UPPER CASE.
  438. (Case is significant!)
  439.          ***********************************************************
  440.  
  441. When used (in any combination), the A, CON, port, speed, handshake, and d
  442. commands must be given in the order shown.
  443.  
  444.  
  445. A     Suspend pcAnywhere operation during file transfers.  This is necessary
  446.       to avoid lockups caused by pcAnywhere host mode.  This command should be
  447.       given to the program running under pcAnyehere host mode.
  448.  
  449.       EXAMPLE: C>dsz A sz *.foo
  450.  
  451.  
  452.  
  453. CON   Redirect message output to the DOS "CON" (console) device, overriding
  454.       any previous redirections.  This is necessary to avoid lockups caused by
  455.       Procomm host mode.  Most programs do not require this hack.  This
  456.       command is unique to DSZ.
  457.  
  458. estimate length [speed] Use the specified length and optional specified
  459.       effective speed for the next receive file to be created.  This command
  460.       must come after any port, speed, or handshake commands.  Please refer to
  461.       DSZBG.ZOO or the ZCOMM User's manual for details.
  462.  
  463. handshake XX Enable one of several choices of hardware handshake.  (The
  464.       default is XOFF/XON software handshake).  This command is documented in
  465.       the ZCOMM or Pro-YAM manual, and in DSZBG.DOC.  (The ZCOMM manual is
  466.       available on all bulletin boards registered for DSZ as ZCOMMDOC.ARC.) On
  467.       DSZ the "handshake" command may be abbreviated to "ha".
  468.  
  469. port N select port N (n = 1,2,3,4,5,6,7,8, 10,11,12,13,14,15,16,17,18) Default
  470.       is port 1 (COM1) or read from the DSZPORT dos environment variable.
  471.       COM10 to COM18 refer to the COM1 to COM8 ports on the PS/2.
  472.  
  473.       In multitasking operation, accessing a port used by another running
  474.       program may hang the machine.
  475.       EXAMPLE: to use COM2:
  476.  
  477.  
  478.  
  479.  
  480.  
  481. Chapter 3 Pg 6            DSZ Reference Rev 02-23-89           Typeset 2-23-89
  482.  
  483.  
  484.  
  485.       dsz port 2 rz
  486.  
  487. portx ... Select arbitrary port address and interrupt vector.  Please refer to
  488.       DSZBG.ZOO or the ZCOMM or Professional-YAM manuals for information on
  489.       this command.
  490.  
  491. speed S Set the specified speed.  This command is rarely needed because DSZ
  492.       reads the port's current speed by default.  Please refer to the FLOW
  493.       CONTROL, MAIN COMMANDS and SOFTWARE COEXISTENCE chapters in DSZBG.ZOO or
  494.       the ZCOMM or Pro-YAM manual for important information about the speed
  495.       command.
  496.  
  497. D     Disables the modem (drops Data Terminal Ready, DTR) if carrier is lost.
  498.       This may be used to prevent spurious events (phone ringing) from
  499.       interfering with the calling bulletin board's recovery from carrier
  500.       loss.
  501.  
  502. d     Disables carrier dropout monitoring, for modems that do not properly
  503.       drive the "Carrier Detect" input on the PC.  If you see a No Carrier
  504.       Detect message, you need to give the d command.
  505.  
  506. LARG  Convert ARG to lower case, then parse arg.
  507.  
  508. pxN   Set a numeric parameter x to N.  These parameters are mostly a subset of
  509.       the Pro-YAM/ZCOMM numeric parameters, and are listed below.  They assume
  510.       their defaults each time DSZ is called.  Without an argument, p displays
  511.       the numeric parameters and their values.
  512.  
  513.       EXAMPLE: C>dsz p
  514.  
  515.       z pxN Set zmodem numeric parameter x to N.  These parameters correspond
  516.       to the Pro-YAM or ZCOMM "zmodem" parameters and rarely need changing.
  517.       These parameters assume their defaults each time DSZ is called.  Without
  518.       an argument, z p displays the zmodem numeric parameters and their
  519.       values.
  520.  
  521. restrict Restrict pathnames to the current disk and directory tree, and
  522.       disallow overwriting of existing files.  When DSZ is restricted, it will
  523.       refuse to transfer files containing the string autoexec.bat and
  524.       command.com in upper or lower case.  This provides some defense from
  525.       malicious uploaded files.
  526.  
  527. t     [-8g] Talk with ZMODEM AutoDownload.  The optional -8g (available on
  528.       registered copies only) allows "BBS (ANSI) graphics".  (A video device
  529.       driver such as ANSI.SYS must be loaded to suppport some types of
  530.       graphics.) A small subset of ZCOMM/Pro-YAM term function subcommands are
  531.       recognized.  Keyboard F1 or ALT-X to exit.  F3 receives file(s) with
  532.       True YMODEM(TM), ALT-P toggles parity between the 8n default and 8g
  533.       (enables ANSI "graphics").  ALT-H toggles two local echo ("Half Duplex")
  534.       modes; the second displays a newline (CR/LF) when Enter is keyboarded.
  535.       Keyboarded ASCII characters are sent to the modem.  ALT-B sends a break.
  536.  
  537.  
  538.  
  539.  
  540.  
  541. Chapter 3 Pg 7            DSZ Reference Rev 02-23-89           Typeset 2-23-89
  542.  
  543.  
  544.  
  545.       Modem characters print on the screen.  A device driver such as ANSI.SYS
  546.       may be used to recognize escape sequences.
  547.  
  548.       DSZ's ZMODEM AutoDownload detects the start of a ZMODEM file download
  549.       and accepts the file(s) without operator intervention.
  550.  
  551. rz    [-abenprt+Yy] [dir] [file ...]          (ZMODEM receive) **
  552.  
  553. rb    [-abt+y] [dir] [file ...]     (YMODEM receive) **
  554.  
  555. rb -g [-abt+y] [dir] [file ...]     (YMODEM-g receive) **
  556.  
  557. rc    [-abt+y] file1                (XMODEM/CRC receive)
  558.  
  559. ro    [-abt+y] file1                (XMODEM OverThruster receive)
  560.  
  561. rx    [-abt+y] file1                (XMODEM receive)
  562.  
  563. rx    -g [-abt+y] file1             (Qmodem-G receive) **
  564.  
  565.       ** Download directory specification ignored w/o registration
  566.  
  567.  
  568. sz    [-abefnprtYQS+y] [-w[N]]  file ...      (ZMODEM send)
  569.  
  570. sb    [-ft] [PREFIX=p | ONAME=n] file ...     (YMODEM, YMODEM-g send)
  571.  
  572. sb -k [-ft] [PREFIX=p | ONAME=n] file ...     (YMODEM-1k send)
  573.  
  574. sx    [-t] file1                    (XMODEM, XMODEM/CRC, Qmodem-G send)
  575.  
  576. sx -k [-t] file1                    (XMODEM-1k send)
  577.  
  578. v     Verify the serial number by writing a log entry (see DSZLOG).
  579.  
  580.       v      1     0 bps    0 cps   0 errors     0  128 s/n 13027
  581.  
  582.       The letter "v" indicates a verification entry.  The first numeric field
  583.       is 1 if YMODEM-g is supported.  The last field is the serial number.
  584.       Unregistered copies show a s/n of 0.
  585.  
  586. The meanings of optional arguments to the file transfer commands are described
  587. in DSZBG.DOC and the ZCOMM/Pro-YAM manual.
  588.  
  589. The s (SlugBait) option prevents a receiver from receiving a file without
  590. accounting for it.  Attempts to do so are flagged with a Q status in the log
  591. file.  This option can cause a transfer that legitimately fails near the very
  592. end of the file to be reported as Questionable rather than ERROR.
  593.  
  594. Send files may be specified indirectly:
  595.                              dsz sz @C:files.lst
  596.  
  597.  
  598.  
  599.  
  600.  
  601. Chapter 3 Pg 8            DSZ Reference Rev 02-23-89           Typeset 2-23-89
  602.  
  603.  
  604.  
  605. sends the files in C:files.lst.  This provides another means of bypassing the
  606. DOS command line limit.  The first letter must be "@" and the third letter
  607. must be ":" to distinguish this from an ordinary pathname.  Pathnames in the
  608. indirect may be separated with any combination of space(s), tab(s), CR and/or
  609. LF.  No spaces may appear inside a pathname; "FOO     .BAR" won't work.
  610.  
  611. 3.1  Interrupt Keys
  612.  
  613. Ctrl-Break Terminates the transfer in progress.
  614.  
  615. ALT-N Abruptly terminates (NUKES) the transfer in progress.
  616.  
  617. Ctrl-X Typing a dozen Ctrl-X characters to another ZMODEM program terminates
  618.      ZMODEM operations.
  619.  
  620. ALT-F Skips the current file in ZMODEM transfers.
  621.  
  622. ALT-B Cancels the current ZMODEM session.
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661. Chapter 4 Pg 9            DSZ Reference Rev 02-23-89           Typeset 2-23-89
  662.  
  663.  
  664.  
  665. 4.  NUMERIC PARAMETERS
  666.  
  667. DSZ uses the following main numeric parameters, settable with the pxN command.
  668.  
  669. EXAMPLE: C>dsz pQ0
  670.  
  671.  
  672. In addition, DSZ uses the Pro-YAM/ZCOMM zmodem numeric parameters described in
  673. the Pro-YAM/ZCOMM reference manual and in DSZBG.DOC.
  674.  
  675.  
  676. B   Set the size of buffer used for disk reads and writes.  The default is
  677.     1024, 4096 maximum.  If your copy of DSZ is running on a floppy disk
  678.     system or a very slow turkey hard disk, a larger value may give better
  679.     results.  Too large a value may exhaust memory, induce receiver timeouts,
  680.     cause disconnects(!), or generate spurious CRC errors.  If performance
  681.     logging doesn't work, this parameter is too big.  This parameter is
  682.     supported on versions compiled with TurboC.
  683.  
  684.     EXAMPLE: C>dsz pB4096 sz A:floppy.fil
  685.  
  686.     Setting the buffer size larger may lock out the performance log, DSZFILES,
  687.     and/or indirect pathname list in the "tiny model" DSZ flavor.  If you
  688.     aren't bloody sure you need a bigger buffer, don't use one.
  689.  
  690. O   This parameter controls XMODEM OverThruster(TM).  It is described in
  691.     dszbg.doc.  This file is part of the software package sent to paid
  692.     registrants.
  693.  
  694. Q   Error code returned to DOS (default 1).  (Success always returns 0.) Some
  695.     programs toss cookies when confronted with certain exit codes.
  696.  
  697.     EXAMPLE: C>dsz pQ-1 sz foo.bar
  698.  
  699.  
  700. S   Timeout in seconds (default 15) waiting for restraint release (XON and/or
  701.     handshake).
  702.  
  703. W   Wait for Enter key before exiting after an error.  Effective on registered
  704.     copies.  Useful when calling DSZ from DESQview, allows the window to close
  705.     unless there is an error message that should remain visible.
  706.  
  707. a   Calibrates certain protocol timeouts used with XMODEM and YMODEM transfers
  708.     (Cybernetic Data Recovery(TM)).  This parameter does not affect ZMODEM
  709.     transfers.
  710.  
  711.     The a numeric parameter is automatically set to 2000 for a 4.77 mHz PC or
  712.     XT, 4000 for a PS2/30, 6000 for an 8 mHz 1ws AT, and 12000 for a PS2/80.
  713.     If your computer has a speedup card or otherwise runs unusually fast (or
  714.     slow!) for its type, you may set the a numeric parameter to a value that
  715.     reflects its speed.
  716.  
  717.  
  718.  
  719.  
  720.  
  721. Chapter 4 Pg 10           DSZ Reference Rev 02-23-89           Typeset 2-23-89
  722.  
  723.  
  724.  
  725.     EXAMPLE: dsz port 2 pa4000 rb
  726.  
  727.  
  728.     NOTE: Setting this parameter does not suppress the "Unknown Machine Type"
  729.     message which is displayed before the command line is scanned.
  730.  
  731. d   A non zero value (the default) causes incoming files received with ZMODEM
  732.     and full YMODEM transfers to have their Date set to that sent in the file
  733.     header.  ZMODEM's file management features depend on the transmission of
  734.     each file's modification date.  Files will have the same creation date,
  735.     even if the two machines are in different time zones.  When transferring
  736.     files to/from a Unix system, creation dates are interpreted according to
  737.     GMT or Universal Coordinated Time.  File dating may be disabled with a pd0
  738.     command.
  739.     NOTE: Backdating file creation times may confuse some backup programs.
  740.  
  741. v   Verbose level (debugging output) Negative values inhibit some routine
  742.     messages.  Setting v to 1 or greater causes serialized copies to ring the
  743.     bell when a transfer is done.
  744.  
  745. z   Timezone in minutes behind GMT, used for ZMODEM and True YMODEM file
  746.     transfers to coordinate the actual date of the file with computers in
  747.     other time zones.  Effective on registered copies.  PDT or MST corresponds
  748.     to 420.  This may be preset with the ZONE DOS environment variable.
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781. Chapter 5 Pg 11           DSZ Reference Rev 02-23-89           Typeset 2-23-89
  782.  
  783.  
  784.  
  785. 5.  ENVIRONMENT VARIABLES
  786.  
  787. The following DOS environment variables may be set to modify DSZ operation.
  788.  
  789. DIRRX (Registered copies only.) Specifies the directory to receive (download)
  790.     files.  If the sting in DIRRX ends with "/", directory and/or disk
  791.     designators in the incoming pathname are stripped, and only the stem (name
  792.     and extension) is used.  Otherwise, if an incoming file has an absolute
  793.     pathname, the incoming pathname is used.
  794.  
  795.     EXAMPLE: set DIRRX=C:/rxdirect/
  796.  
  797.     The "set" command defining the receive directory may be placed in your
  798.     AUTOEXEC.BAT file.
  799.  
  800. DSZFILES May contain a list of up to 9999 pathnames to transmit, with entries
  801.     separated by spaces.  If present, DSZFILES is used in place of a normal
  802.     command line list of files to send with the sb and sz commands.
  803.  
  804.     EXAMPLE: C>set DSZFILES=file1 file2 file3 *.c
  805.     C>dsz port 2 handshake on sz -r
  806.  
  807.     In practice, this string would be built up by a calling program and passed
  808.     to DSZ with a "spawnvpe", "execvpe", or similar subroutine call.
  809.  
  810.     SEE ALSO: Pathname list specification @C:files.lst
  811.  
  812. DSZLOG log file to receive entries for files sent and received.  (Default
  813.     null).  Sample entries:
  814.  
  815. Z  46532 38400 bps 3324 cps   0 errors    66 1024 DSZ.COM 1177
  816. Z 124087 19200 bps 1880 cps   0 errors     6 1024 MXY.TMP 1177
  817.  
  818.     Transfer times are based on the DOS time of day clock and have one second
  819.     jitter.  As with all protocol throughput reports generated by Omen
  820.     Technology programs (and contrary to the false claims of some critics),
  821.     DSZ's throughput figures for ZMODEM, Kermit, and True YMODEM(TM) transfers
  822.     do not take "credit" for pathname and/or protocol overhead characters.
  823.     DSZ's throughput reports do not include the time required to send the
  824.     pathname.  This understates the true time required to transfer files, but
  825.     the time required to send the pathname often depends on the alacrity of
  826.     the operator, and thus does not always reflect the performance of the
  827.     protocol itself.
  828.  
  829.     Transfers measuring less than one second are reported as having 9999
  830.     characters per second throughput.
  831.  
  832.     The unlabeled numeric field after the error (retry) count is the number of
  833.     flow control stoppages encountered sending the file.  This number gives an
  834.     indication of flow control restrictions (overloaded networks, etc.)
  835.     encountered during the transfer.
  836.  
  837.  
  838.  
  839.  
  840.  
  841. Chapter 5 Pg 12           DSZ Reference Rev 02-23-89           Typeset 2-23-89
  842.  
  843.  
  844.  
  845.     The last numeric field before the file name is the YMODEM block size or
  846.     ZMODEM subpacket length used for the last block in the file.
  847.  
  848.     The last field is the serial number of the other program, or -1 if this
  849.     information is not available.
  850.  
  851.     The code letter indicates the type of transfer, Z (ZMODEM), S (X/YMODEM),
  852.     R (X/YMODEM), E (error), or L (transfer terminated by loss of data
  853.     carrier).
  854.  
  855.     WARNING: If DSZ encounters a loss of carrier or other fatal error
  856.     condition before a file commences transmission, a log entry will not be
  857.     made.
  858.  
  859.     EXAMPLE: C>set DSZLOG=C:/yam/dszlog
  860.  
  861.  
  862. DSZOPT (Paid Registered copies only) String containing default options for DSZ
  863.     file transfers.  Options are optional modifiers to the DSZ sz, rz, sx, rx,
  864.     sb, rb commands.
  865.  
  866.     An 8n may be appended to the string to make BBS (ANSI) graphics the
  867.     default for DSZ's t command.  The ability to preset these options is
  868.     especially helpful for controlling ZMODEM automatic downloads from DSZ's t
  869.     command.
  870.  
  871.     EXAMPLE: C>set DSZOPT=r
  872.     Enables DSZ's Intelligent Crash Recovery(TM) as a default.
  873.  
  874.     Let's say you wish ZMODEM crash recovery, and BBS "graphics" for the DSZ
  875.     term function:
  876.     C>set DSZOPT=r8g
  877.  
  878.  
  879.     WARNING: Do NOT include "ena" or any other commands in the DSZOPT string.
  880.     With the exception of the "8g" mode, only **options** may be placed in the
  881.     DSZOPT string!  (Options are the letters that modify the sz, rz, sb, etc.
  882.     commands.  In "rz -r", "r" is an option.)
  883.  
  884. MAXBYTES Maximum number of bytes allowed for transfer.  If this number is
  885.     exceeded, DSZ skips the offending files (ZMODEM) or aborts remaining files
  886.     in the batch (YMODEM).
  887.  
  888. DSZPORT Default communications port override, default 1.
  889.     EXAMPLE:
  890.     C>set DSZPORT=2
  891.  
  892. ZONE sets the z numeric parameter to the number of minutes the current local
  893.     time lags GMT time.  PDT or MST corresponds to 420.  PST corresponds to
  894.     480.  This environment variable has no effect on unregistered DSZ copies.
  895.     EXAMPLE:
  896.  
  897.  
  898.  
  899.  
  900.  
  901. Chapter 5 Pg 13           DSZ Reference Rev 02-23-89           Typeset 2-23-89
  902.  
  903.  
  904.  
  905.     C>set ZONE=420
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.  
  936.  
  937.  
  938.  
  939.  
  940.  
  941.  
  942.  
  943.  
  944.  
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961. Chapter 6 Pg 14           DSZ Reference Rev 02-23-89           Typeset 2-23-89
  962.  
  963.  
  964.  
  965. 6.  EXAMPLES
  966.  
  967. dsz sz c:foo.* b:*.c          (send files with ZMODEM)
  968.  
  969. dsz sz -Z *.lst               (send files with compression)
  970.  
  971. dsz sz -r yzmodem.arc         (CRASH RECOVERY: resume interrupted transfer)
  972.  
  973. dsz rz -r                     (CRASH RECOVERY: resume interrupted transfer)
  974.  
  975. dsz handshake both sz yzmodem.arc       (Hardware+Software handshake)
  976.  
  977. dsz sz -n *.*                 (send files that are newer or rx has no copy)
  978.  
  979. dsz sz -Yn *.*                (Only send files that are newer than receiver's
  980. copy)
  981.                               (Do not send files that do not exist on
  982. receiver's disk)
  983.  
  984. dsz rz C:/UPLOADS             (receive files to specified directory #)
  985.  
  986. dsz port 2 speed 38400 restrict rz
  987.  
  988. dsz rz  -y prog.arc           (ZMODEM, single file pathname override)
  989.  
  990. dsz z pr1 rx foo.dat          (XMODEM receive, remove file if error)
  991.  
  992. dsz pO60 ro foo.dat           (XMODEM/OverThruster receive, GEnie MNP #)
  993.  
  994. DSZ LRC L-Y NEWPROG.ARC       (generate lower case "rc -y" command)
  995.  
  996. dsz pv2 sz foo >debug.dmp     (Debugging data dump)
  997.  
  998. dsz sz @C:/bbs/files.lst      (Indirect file list)
  999.  
  1000. # Paid registered copies only
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.  
  1020.  
  1021. Chapter 7 Pg 15           DSZ Reference Rev 02-23-89           Typeset 2-23-89
  1022.  
  1023.  
  1024.  
  1025. 7.  IN CASE OF DIFFICULTY
  1026.  
  1027. If you have difficulty getting DSZ to work, start with the following command
  1028. to DSZ directly from the DOS prompt, without running any TSR or other COMM
  1029. program:
  1030.                               dsz port 1 speed 2400 d t
  1031. (Change the port number and speed as necessary.) This connects you to the
  1032. modem.  Dial a bulletin board by typing AT commands to the modem ("ATDP621-
  1033. 3746").  Log in as usual.  Then, request a ZMODEM download of a file you don't
  1034. already have.  The file will download automatically, you don't have to do
  1035. anything.  This procedure verifies the correct operation of DSZ.
  1036.  
  1037. The "sb" and "sz" commands exploit DOS's tree structured file system.  An "sz"
  1038. command with no file specified sends all the files in the current directory.
  1039. A directory or disk specifier expands to all files in that directory.
  1040.  
  1041.  
  1042. 7.1  LOCKUPS
  1043.  
  1044. 7.1.1  Insufficient Memory
  1045. DSZ complains when it detects insufficient memory to operate.  When calling
  1046. DSZ from another program, there may be ALMOST enough memory for proper
  1047. operation, but DSZ locks up during a transfer or the calling program freezes
  1048. after DSZ displays the "DSZ Finished" message.
  1049.  
  1050. Sometimes there is a message about insufficient memory, sometimes just a
  1051. lockup and no message.  To verify this problem, call CHKDSK from within your
  1052. comms program (not from DOS!) by defining it as an external protocol.  If you
  1053. use an interface program (Hotkeyz, Prodoor, etc.), you must call CHKDSK from
  1054. that program, as those programs also reduce the memory available to DSZ.
  1055.  
  1056. CHKDSK should report at least 64k free memory.  If less memory is reported,
  1057. reduce the size of the capture buffer, reboot the system with fewer/smaller
  1058. device drivers and TSR programs.  Calling DSZ directly from the comms program
  1059. instead of from an interface also saves memory.
  1060.  
  1061.  
  1062. 7.1.2  Bad COMM Port Configuration
  1063. DSZ is fastidious about which interrupt vectors it takes over.  Unlike some
  1064. COMM programs, DSZ grabs only the correct interrupt vector for its interrupt
  1065. service routine.  This allows multi line operation under DESQview and other
  1066. multitasking systems.
  1067.  
  1068. Incorrectly configured serial ports that work with programs that pig out both
  1069. IRQ3 and IRQ4, will lock up with DSZ.  If DSZ locks up the machine as soon as
  1070. it tries to send or receive data, this is usually the fault.  Make sure the
  1071. comm port is strapped correctly; COM1 uses IRQ4, COM2 uses IRQ3.  DSZ will
  1072. lock up if the comm port is not properly set up.
  1073.  
  1074. In addition, DSZ will not work properly if two devices are connected to the
  1075. same IRQ line, even when some other programs (that don't use interrupts as
  1076.  
  1077.  
  1078.  
  1079.  
  1080.  
  1081. Chapter 7 Pg 16           DSZ Reference Rev 02-23-89           Typeset 2-23-89
  1082.  
  1083.  
  1084.  
  1085. intensively) do work normally on the same machine.
  1086.  
  1087.  
  1088. 7.2  Incorrect Batch Files
  1089.  
  1090. Incorrect batch files are the number one source of problems using DSZ for
  1091. downloads.  DSZ's command line echo was added to assist in correcting
  1092. defective batch files.  Try running DSZ by itself, without any batch files or
  1093. TSR programs, calling it directly from DOS as described above.
  1094.  
  1095.  
  1096. 7.3  No Carrier Detect
  1097.  
  1098. If you see a No Carrier Detect message, you really need to give the d command:
  1099.                               dsz port 1 speed 2400 d t
  1100.  
  1101. Better yet, correct your modem cable to allow proper operation of the Carrier
  1102. Detect signal (CD)!
  1103.  
  1104. Some BBS and/or "door" programs hang when the program (such as DSZ) they call
  1105. returns with a non 0 exit status.  Please refer to the "EXIT STATUS" chapter
  1106. of the document for more information.
  1107.  
  1108. 7.4  PKARC 3.6
  1109.  
  1110. It has been reported that PK36 grabs some interrupts and doesn't restore them
  1111. on exit in an attempt to prevent hacks of the program.  Since eliminating that
  1112. particular version and cleaning up memory, highspeed xfers even with 8250
  1113. UARTS work properly again.
  1114.  
  1115. The problem with PK 3.6 appears to be most severe if a BBS operator has
  1116. doorware, etc that accesses the PK programs from a shell of some sort.  This
  1117. info may be helpful to users who are having otherwise inexplicable file xfer
  1118. problams.
  1119.  
  1120. Phil Katz has written me that this problem has been corrected in subsequent
  1121. versions.
  1122.  
  1123. 7.5  COMMAND NOT FOUND
  1124.  
  1125. If you see this message, make sure DSZ is in the DOS PATH.  Sometimes this
  1126. error is caused by having too many environment variable strings.
  1127.  
  1128.  
  1129. 7.6  DOS 3.x
  1130.  
  1131. DOS 3.x systems may need to have a "STACKS = 8,256" line in CONFIG.SYS to
  1132. prevent antisocial behavior. This is required on the NEC Multispeed, or if
  1133. certain TSR's are used.
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141. Chapter 7 Pg 17           DSZ Reference Rev 02-23-89           Typeset 2-23-89
  1142.  
  1143.  
  1144.  
  1145. 7.7  Perstor Controllers
  1146.  
  1147. Several reports have been received indicating Perstor disk controllers
  1148. interfere with data comunications.  Perstor is reportedly working on a fix.
  1149.  
  1150.  
  1151. 7.8  IBM PS/2 Model 50Z
  1152.  
  1153. Early samples of this machine have a design error on the motherboard that
  1154. causes comms programs to lock up the machine.  Replacing the motherboard with
  1155. a correctly functioning unit from current production corrects the problem.
  1156. The part number of the replacement PS2/50 Z motherboard is 35F5928.
  1157. (Information provided by John M. Choma 73047,3566) In the U.S. IBM has
  1158. stonewalled on this issue, but in December 1988 agreed to replace the
  1159. defective motherboards under warranty.
  1160.  
  1161.  
  1162. 7.9  Brain Damaged UARTS
  1163.  
  1164. Omen Technology has received reports of problems with defective 8250 type UART
  1165. integrated circuits in Leading Edge modem boards, serial port interfaces, and
  1166. computers.  The defective chip logic affects high performance software.
  1167. Replacing the buggy chip with a newer chip (16450 or NS16550AN) corrects the
  1168. problem.  The NS16550AN is a plug in replacement for 8250 and 16450 serial
  1169. chips.  386 and fast 286 machines should use the NS16550AN for best results.)
  1170. Arrow Electronics at 1-800-932-7769 sells National NS16550AN chips mail order
  1171. (credit card) in small quantities.
  1172.  
  1173.  
  1174. 7.9.1  Everex Internal Modems
  1175. Numerous reports have been received concerning difficulties with Everex modem
  1176. cards.  Some of these cards contain buggy 8250 chips which are not up to the
  1177. demands of full duplex streaming protocols such as ZMODEM.  Replacing the
  1178. buggy 8250 chip with a 16450 (or better yet NS16550AN) chip corrects these
  1179. problems.
  1180.  
  1181.  
  1182. 7.10  Weird Iron
  1183.  
  1184. A few machines, some with V20 CPUs, don't like DSZ.COM.  We have not been able
  1185. to repeat this; TeleGodzilla (using a V20) runs DSZ.COM without a hitch.
  1186. Switching to DSZ.EXE has cleared up the problems on other machines.
  1187.  
  1188.  
  1189. 7.11  Will the real YMODEM please stand up?
  1190.  
  1191. Some XMODEM programs claiming to support YMODEM do not send or accept the
  1192. YMODEM pathname block.  1024 byte XMODEM is XMODEM-1k, not YMODEM as defined
  1193. by Ward Christensen in 1985 when he coined the word.  1987 and later versions
  1194. of YMODEM.DOC remind the reader of the official YMODEM definition, which has
  1195. not changed since YMODEM's coinage in 1985.
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201. Chapter 7 Pg 18           DSZ Reference Rev 02-23-89           Typeset 2-23-89
  1202.  
  1203.  
  1204.  
  1205. 7.12  286 and 386 Extended Memory
  1206.  
  1207. Virtual memory disk caches and ramdisks using 80286 or 80386 extended memory
  1208. require a kluge hardware reset of the CPU chip to return to the normal "real
  1209. mode" after accessing extended memory.  This interference to the interrupt
  1210. response time causes lost characters on comm ports, and may be minimized by
  1211. specifying shorter memory transfers.
  1212.  
  1213. Switching to a National NS16550AN UART chip helps tremendously, allowing
  1214. transfers at 115200 bps instead of 9600 bps with a standard 8250.  The
  1215. NS16550AN is a plug in replacement for 8250 and 16450 serial chips.  Arrow
  1216. Electronics 1-800-932-7769 sells National NS16550AN chips mail order (credit
  1217. card) in small quantities.
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261. Chapter 8 Pg 19           DSZ Reference Rev 02-23-89           Typeset 2-23-89
  1262.  
  1263.  
  1264.  
  1265. 8.  BACKGROUND OPERATION
  1266.  
  1267. Three DESQview description files are provided to demonstrate background
  1268. operation with modest (66 kb window) memory requirements.  DSZ uses tight
  1269. C/ASM code, table driven CRC generators, and buffered receive and transmit for
  1270. good performance in the background without hogging CPU cycles.  On a QIC Labs
  1271. 8 mHz PC-AT clone, DSZ can download files in the background (3 background
  1272. clock ticks, 9 foreground clock ticks) with a throughput better than 9600 bps.
  1273.  
  1274. 2S   Prompts for file name(s) and sends them with ZMODEM protocol.  File: 2S-
  1275.      PIF.DVP
  1276.  
  1277. 2T   Talks to the modem and allows manual YMODEM (F3) or automatic ZMODEM
  1278.      downloads.  File: 2T-PIF.DVP
  1279.  
  1280. 2A   Like 2T, but using Quarterdeck's dvansi.com memory resident ANSI CRT
  1281.      device driver to process ANSI screen codes.  File: 2A-PIF.DVP DS.BAT is
  1282.      the batch file used by 2A.
  1283.  
  1284. These files are written for a port 2 local connection and \TMP directory, but
  1285. may be modified to suit your requirements using the DESQview CP command.  The
  1286. W numeric allows DESQview to close the window after DSZ finishes, providing a
  1287. pleasant user interface.
  1288.  
  1289. Other DVPs, Scripts, and Batch files are available on the DESQView conference
  1290. on the Sound of Music as DVDSZ20Z.ARC.
  1291.  
  1292. Operation at high speed (above 9600 bps) may require the DESQview "Optimize
  1293. communications" performance Advanced Setup option.
  1294.  
  1295. Newer versions of DESQview may require more "common memory" allocation (6-8 k
  1296. bytes) to operate with DSZ.
  1297.  
  1298.          ***********************************************************
  1299.                                    WARNING
  1300. When running DSZ under a multi tasking system such as DESQview, do not allow
  1301. two programs to access the same comm port at the same time.  At best, such
  1302. actions will disrupt communications.  At worst, your computer will attempt to
  1303. open a subspace channel to V'ger.
  1304.  
  1305. When running a comm program under DESQview or any related multitasking
  1306. executive, DSZ must be called directly from the comm program, in the same
  1307. window.  DO NOT open a separate window for DSZ unless you were about to power
  1308. down the computer anyway.
  1309.          ***********************************************************
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.  
  1320.  
  1321. Chapter 9 Pg 20           DSZ Reference Rev 02-23-89           Typeset 2-23-89
  1322.  
  1323.  
  1324.  
  1325. 9.  CALLING DSZ FROM COMM PROGRAMS
  1326.  
  1327. It may be necessary to give a
  1328.  
  1329. SET COMSPEC=A:\COMMAND.COM
  1330.  
  1331. (change as needed) in your AUTOEXEC.BAT file to allow programs to call DSZ.
  1332.  
  1333. 9.1  GT POWER 13.00/14.00
  1334.  
  1335. GT Power version 13/14 includes a YMRX.BAT (YMODEM-g receive) file with an
  1336. "rz" command.  You guessed it, "rz" is for ZMODEM protocol (the z means
  1337. ZMODEM!).  Please change the file to use the correct "rb -g" for YMODEM-g.
  1338.  
  1339. The files ZMTX.ARC and GT1300.NOT available on many bulletin boards contain
  1340. useful information for GT Power users.
  1341.  
  1342. 9.2  PROCOMM
  1343.  
  1344. DSZ may not operate properly when called from Procomm if Procomm has files
  1345. open at the time.
  1346.  
  1347. A number of reports have been received of problems running DSZ from Procomm
  1348. Plus because of insufficient memory.  Please refer to the subchapter on
  1349. LOCKUPS.
  1350.  
  1351. When running under ProComm's Host mode, failure to use the DSZ CON command may
  1352. cause Procomm to lock up the computer, or at least interfere with file
  1353. transfers, etc.
  1354.  
  1355. EXAMPLE: DSZ CON sz %1
  1356.  
  1357.  
  1358. The POE, PCALL, DSZ_ZAP, and PROZ programs have been popular in interfacing
  1359. DSZ to Procomm's editor gateway.
  1360.  
  1361. Hint: the DOS PATH environment variable must include Procomm's directory to
  1362. allow POE to locate all the POE files,.  The POE files should be stored in the
  1363. Procomm directory.  Setting the "PROCOMM" environment variable is
  1364. insufficient.
  1365.  
  1366. 9.3  PROCOMM PLUS
  1367.  
  1368. DSZ may not operate properly when called from Procomm if Procomm has files
  1369. open at the time.
  1370.  
  1371. Here are some handy settings for Procomm Plus.
  1372.  
  1373. First, set the DOS environment as necessary before running Procomm:
  1374. SET DSZPORT=2                           (Only needed for COM2)
  1375. SET DSZLOG=DSZ.LOG            (If you wish a log file)
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381. Chapter 9 Pg 21           DSZ Reference Rev 02-23-89           Typeset 2-23-89
  1382.  
  1383.  
  1384.  
  1385. Then set Procomm's external protocol strings:
  1386. A- External protocol 1 upload filename  ...ZMODEMU
  1387. B- External protocol 1 download filename ... ZMODEMD
  1388.  
  1389. And then some short batch files:
  1390. ZMODEMU.BAT:                  DSZ sz %1 %2 %3 %4 %5 %6 %7 %8 %9
  1391. ZMODEMD.BAT:    DSZ rz
  1392.  
  1393. To make downloads easier, use the "dsz t" command described above.
  1394. ZMODEMT.BAT:                  DSZ t
  1395.  
  1396. 9.4  Qmodem
  1397.  
  1398. The following is based on a message from Mike Cody, sysop of HomePlate 313-
  1399. 385-9969 3/12/24/96 HST
  1400.  
  1401. Go into Qinstall and go to frame 3 Directories. Then select External protocols
  1402. #3 I think. Now you will see a definition area to tell Qmodem the
  1403. Letter,batchfile combo to use.
  1404.  
  1405. Now put Z in the letter definition, Zup.bat in the u/l batch zdown.bat in the
  1406. d/l batch, and Y in the btch protocol. Now save it at the menu with f10 and S.
  1407.  
  1408. Then go to DOS and create the following batch files in your Qmodem
  1409. directory...
  1410.  
  1411. Zdown.bat: DSZ port %2 speed %1 rz -r
  1412.  
  1413. Zup.bat: DSZ port %2 speed %1 sz %3
  1414.  
  1415. These are the batch files that will be called by Qmodem.  If uou did everthing
  1416. right when uoy hit PGDN or PGUP you will see an external protocol called Z)
  1417. Zmodem in the box. For an easier time do a serch for either External.arc or
  1418. maybe the string "Qmodem" in the file database as there is a file with several
  1419. external prootcols and batch files available in the Mahoney file section (EXEC
  1420. BBS).
  1421.  
  1422. 9.5  BULLETIN BOARDS
  1423.  
  1424. When installing DSZ on a bulletin board or host system, be sure to check for
  1425. proper operation when the caller hangs up while a file is being sent or
  1426. received.
  1427.  
  1428. Currently, Only the TurboC version supports file sharing (shared read access
  1429. on files sent by  dsz).
  1430.  
  1431. Some bulletin board interface routines do not call DSZ to send a file until
  1432. they have verified the file's presence by opening the file.  If this checking
  1433. is done in DOS's default exclusive open mode, dsz's file sharing will be
  1434. defeated.
  1435.  
  1436.  
  1437.  
  1438.  
  1439.  
  1440.  
  1441. Chapter 9 Pg 22           DSZ Reference Rev 02-23-89           Typeset 2-23-89
  1442.  
  1443.  
  1444.  
  1445. 10.  FLOW CONTROL
  1446.  
  1447. If you plan to send files over Telenet (PC-Pursuit), you must refer to the
  1448. Pro-YAM or ZCOMM Reference manual (in ZCOMMDOC.ARC) FLOW CONTROL chapter for
  1449. vital information on flow control considerations necessary for proper
  1450. operation of ZMODEM and other streaming protocols.
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.  
  1460.  
  1461.  
  1462.  
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.  
  1479.  
  1480.  
  1481.  
  1482.  
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.  
  1489.  
  1490.  
  1491.  
  1492.  
  1493.  
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499.  
  1500.  
  1501. Chapter 11 Pg 23          DSZ Reference Rev 02-23-89           Typeset 2-23-89
  1502.  
  1503.  
  1504.  
  1505. 11.  ERROR MESSAGES
  1506.  
  1507. COM2 1200 bps Carrier Detect enabled Handshake slow
  1508. Command line = (commands)
  1509. This is a normal message displayed to help resolve problems with incorrect
  1510. batch files.  The port number, speed, carrier detect ("enabled" or "DISABLED")
  1511. and "handshake" indicate the selected mode of operation.
  1512.  
  1513. DSZ FINISHED! exit code = 0
  1514. This is DSZ's normal exit when no unrecoverable errors have been detected.  If
  1515. an error such as failed file transfer had been detected, the exit code would
  1516. be 1, or the value set in the Q numeric parameter.
  1517.  
  1518. As the message implies, DSZ has done all of its processing, and has return the
  1519. communications port and vector to its original value before displaying this
  1520. message.  If the computer locks up after this message is displayed, there's
  1521. something wrong with the program that called DSZ, not with DSZ itself.
  1522.  
  1523. Unknown Machine Type XX, 'a' parameter preset to 6000 indicates a ROM BIOS
  1524. that does not follow the IBM specification for identifying the machine type.
  1525. If your computer causes DSZ to display this message, you may set the a numeric
  1526. parameter described elsewhere in this document.  This message is generated
  1527. before any commands are read, so do not be alarmed when setting the a
  1528. parameter doesn't make this message go away.  The a parameter does not affect
  1529. ZMODEM transfers.
  1530.  
  1531. Need more memory to run DSZ or Abnormal program termination is displayed by
  1532. the TurboC startup routine if DSZ is run in too small a memory partition.  If
  1533. you see this message, use a larger memory partition for DSZ or remove some
  1534. memory resident programs.  This message may also appear if the calling program
  1535. fails to free memory before calling DSZ.
  1536.  
  1537. No Carrier Detect is displayed when DSZ recognizes a loss or lack or carrier
  1538. detect signal from the modem.  This is caused by a line disconnect, defective
  1539. cable, or incorrect modem strapping.  It may be disabled with the d command.
  1540. Sometimes this is caused by setting the B parameter to too large a value.
  1541.  
  1542. Garbage Count Exceeded Indicates ZMODEM has not detected a valid start of
  1543. header in a reasonable number of characters.
  1544.  
  1545. If DSZ becomes "stuck" on emitting this messages, it is possible the sending
  1546. program may not be able to recognize and act upon transmission requests (ZROPS
  1547. headers).  The sending program should be corrected.  In the meantime, setting
  1548. a ZMODEM packet length with the "zmodem pl4096" command forces the sender to
  1549. wait for the receivers' progress reports.
  1550.  
  1551. Permission denied comes from the Microsoft C Library.  This may be caused by
  1552. attempts to modify a read only file or directory, or create a file in a
  1553. nonexistient directory.
  1554.  
  1555. A furtive flashing appearance of XOFF or FLOW during ZMODEM or YMODEM-g file
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561. Chapter 11 Pg 24          DSZ Reference Rev 02-23-89           Typeset 2-23-89
  1562.  
  1563.  
  1564.  
  1565. sending signifies DSZ is responding to flow control restraint.  This is normal
  1566. operation when buffered modems or packet switched networks are used.  ZMODEM's
  1567. robustness and reliability allow creative users to transfer files over unusual
  1568. multiple computer lash-ups, causing modem data lights and computer status
  1569. displays to dance in unfamiliar rhythms.  Got ZRPOS indicates the receiving
  1570. program has detected a transmission error and has requested retransmission.
  1571. In other words, ZMODEM is doing its job of detecting and correcting missing
  1572. and garbled data.  If this happens more often than observed line errors would
  1573. indicate is reasonable, there may be a flow control problem in one of four
  1574. areas:
  1575.  
  1576.   + Between the sending program and its modem.  If using an interface speed
  1577.     higher than the transmission speed, or modem to modem error correction
  1578.     (MNP, LAPB, PEP, etc.), check that the modem and the sending program are
  1579.     configured for the same flow control methods.  Omen Technology's software
  1580.     is faster than most other programs, and may expose flow control problems
  1581.     not seen with slower software.
  1582.  
  1583.   + Between the sending modem and the network.  Correcting this requires
  1584.     "handshake both" to allow the sending program to honor both hardware (CTS)
  1585.     flow control from the modem and software flow control (XON/XOFF) from the
  1586.     network.
  1587.  
  1588.   + Between parts of the network.
  1589.  
  1590.   + Between the receiving modem and the receiving program.  This can happen at
  1591.     high transmission speeds when the receiver has specified a large I/O
  1592.     buffer size with the B numeric parameter.
  1593.  
  1594.     Excessive interrupt latency from extended memory ramdisks or disk caches,
  1595.     and poorly written hard disk drivers also wreak havoc on streaming
  1596.     protocols but do not affect start-stop protocols (XMODEM, etc.).
  1597.  
  1598.     To correct these problems, give the "handshake slow" command to the
  1599.     receiver.
  1600.  
  1601. Byte NNNN retry M: <error message> These messages appear when the protocol has
  1602. detected an error and is attempting to retransmit the garbled data.  These are
  1603. normal messages.
  1604.  
  1605. Serial Input Error: Line Status Register HH indicates a slow device driver,
  1606. TSR program, or other software is disabling interrupts too long for the
  1607. program to accept incoming data, and some characters are lost.  A slow
  1608. response to folow control also triggers this message.
  1609.  
  1610. The value of the line status register is displayed in HEX.  The following
  1611. error conditions when present OR into the Line Status Register.
  1612.  
  1613.  
  1614. 01   The Interrupt level circular buffer has been overrun.  The remote did not
  1615.      respond to 's XOFF or hardware flow control, and continued to send
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621. Chapter 11 Pg 25          DSZ Reference Rev 02-23-89           Typeset 2-23-89
  1622.  
  1623.  
  1624.  
  1625.      characters after being told not to.  This problem is alleviated by
  1626.      correct modem flow control configuration.
  1627.  
  1628.  
  1629. 02   Data Overrun is caused by firmware, TSR programs, EGA/VGA board auto-
  1630.      select, or operating system software locking out interrupts for excessive
  1631.      periods.  Interrupt latency caused by EGA/VGA board auto-select can be
  1632.      corrected by disabling auto-select.  Other chapters in this document give
  1633.      additional suggestions for correcting excessive interrupt latency,
  1634.      primarily the handshake slow command and the NS16550AN UART chip.
  1635.  
  1636.  
  1637. 08   Framing Error generally caused by line noise or an incorrect transmission
  1638.      speed or format (number of bits).  Most protocols require 8 bits no
  1639.      parity for proper operation.  This is set automatically by Omen
  1640.      Technology programs, but other programs may not be so smart.
  1641.  
  1642.  
  1643. 10   Break Interrupt generally caused by line noise or an incorrect
  1644.      transmission speed or format (number of bits).
  1645.  
  1646.  
  1647. 18   Break Interrupt and Framing Error (see above) in combination.
  1648.  
  1649. Please refer to the In Case of Difficulty chapter of this document for
  1650. solutions.
  1651.  
  1652. Less commonly encountered DSZ error messages are explained in the Pro-YAM
  1653. manual.
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681. Chapter 12 Pg 26          DSZ Reference Rev 02-23-89           Typeset 2-23-89
  1682.  
  1683.  
  1684.  
  1685. 12.  ASSOCIATED DOCUMENTS
  1686.  
  1687. Consult the Professional-YAM, PowerCom, or ZCOMM manual chapter "OPTIONS FOR
  1688. FILE TRANSFERS" for descriptions of the file transfer options.  The "FILE
  1689. TRANSFER BASICS" chapter explains the relative merits of XMODEM, YMODEM,
  1690. ZMODEM, and other protocols and gives tips on their use.  The "MAIN COMMANDS"
  1691. chapter describes the rb, rx, rc, rz, sb, and sz commands.  The "MODEM
  1692. INTERFACING" and "FLOW CONTROL" chapters contain important information on the
  1693. use of buffered modems with DSZ.
  1694.  
  1695. Information on the ZMODEM Inter Application File Transfer Protocol may be
  1696. found in ZMODEM.DOC, part of YZMODEM.ARC (available on TeleGodzilla).
  1697.  
  1698. C Source code for XMODEM, YMODEM, and ZMODEM transfers is included in
  1699. RZSZ.ZOO.  This file includes a Pro-YAM/ZCOMM script to upload a bootstrap
  1700. file to a Unix system, force its compilation, and (if the compilation is
  1701. successful) upload the rz/sz source files.
  1702.  
  1703. The C source code now includes VAX/VMS support.
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.  
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.  
  1729.  
  1730.  
  1731.  
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738.  
  1739.  
  1740.  
  1741. Chapter 13 Pg 27          DSZ Reference Rev 02-23-89           Typeset 2-23-89
  1742.  
  1743.  
  1744.  
  1745. 13.  FILES
  1746.  
  1747. 2S-PIF.DVP, 2A-PIF.DVP, DS.BAT, 2T-PIF.DVP DSZ.COM, and DSZ.DOC constitute
  1748. Omen Technology's DSZ.ARC.
  1749.  
  1750. 2S-PIF.DVP, 2A-PIF.DVP, DS.BAT, and 2T-PIF.DVP are only used with Quarterdeck
  1751. Office Systems' DESQview multitasking executive for background operation.
  1752. Their use is described in a previous chapter of this document.
  1753.  
  1754. ZCOMMDOC.ARC (manual), ZCOMMEXE.ARC (programs), ZCOMMHLP.ARC (help processor
  1755. and database), ZCOMM communications tools.  The ZCOMM files should be
  1756. available on the BBS you downloaded DSZ.ARC from.  If these files are not
  1757. available, the BBS is not fulfilling the concractual requirements of free BBS
  1758. registration of DSZ.
  1759.  
  1760. YZMODEM.ARC (available on TeleGodzilla) contains XMODEM, YMODEM, and ZMODEM
  1761. Protocol Descriptions.
  1762.  
  1763. RZSZ.ZOO contains ZMODEM "C" source code.  (COMPLETE VAX VMS and Unix/Xenix
  1764. programs).
  1765.  
  1766. DSZ.EXE compiled with the Xenix to DOS XC provides moderately higher maximum
  1767. throughput (1700 vs 1300 cps downloading to a 4.77 mHz XT).  The speed
  1768. difference is a function of the compiler, the source code is the same.  The
  1769. Xenix XC version requires more memory, and does not support file sharing or a
  1770. large I/O buffer.  This version is available in DSZEXE.ZOO.
  1771.  
  1772. ZCOMM and Pro-YAM also run at a higher speed than DSZ.COM.
  1773.  
  1774. DSZBG.ZOO contains DSZBG.DOC.  Part of the DSZ registration disk (and not for
  1775. public distribution), this file provides background information on the
  1776. ZCOMM/Pro-YAM commands provided in DSZ.
  1777.  
  1778. LOOZ.EXE unpacks .ZOO archives.  LOOZ.DOC describes LOOZ.EXE.  The ZOO archive
  1779. format is a machine independent improvement on the PC-DOS specific .ARC
  1780. format.
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794.  
  1795.  
  1796.  
  1797.  
  1798.  
  1799.  
  1800.  
  1801. Chapter 14 Pg 28          DSZ Reference Rev 02-23-89           Typeset 2-23-89
  1802.  
  1803.  
  1804.  
  1805. 14.  CHANGES
  1806.  
  1807. Be sure to save your serial number/password (SNP) card and the putsnp program
  1808. you received from Omen to use with future versions of DSZ you may download!
  1809. The current DSZ version is maintained on GEnie, EXEC-BBS, CompuServe as well
  1810. as TeleGodzilla.
  1811.  
  1812. A reminder: the -Z option is effective only when it is given to the sending
  1813. program.
  1814.  
  1815. 2-23-89 The term function now sends BREAK in response to the ALT-B key.
  1816. Handling of the Ctrl-Break vector has been changed so an untimely keyboarded
  1817. Ctrl-C or Ctrl-Break will not hang DOS.
  1818.  
  1819. A problem in the 1/17/89 and 2/2/89 versions corrupts files under unusual
  1820. circustances.  Please delete all instances of the 1/17/89 and 2-02-89 version.
  1821.  
  1822. 2-15-89  DIRRX is enabled for BBS registrations (8xxx numbers).  Logic has
  1823. been added to simulate transmit interrupts on chips that have problems in this
  1824. area.  The "A" command does not require registration.  An interaction between
  1825. ONAME= or PREFIX= and the file count display has been removed.  Time/date
  1826. conversion routines have been enhanced to deal with files with missing dates.
  1827. The "v" command has been added to allow bbs programs to interrogate DSZ's
  1828. serial number.
  1829.  
  1830. 2-06-89 A spurious error message at the completion of YMODEM downloads with a
  1831. download directory specified on the command line has been eliminated.
  1832.  
  1833. 2-05-89 DSZ now returns a non 0 status unless at least one file has been
  1834. transferred.  An inappropriate pathname/disk specifier check on specified
  1835. download directories has been removed.
  1836.  
  1837. Previous versions:
  1838.  
  1839. Added the "A" command to prevent pcAnywhere host mode from locking up DSZ.
  1840. SlugBait logic has been simplified, reporting any failed file transfer where
  1841. any of the last 1K of the file was sent with Q status.
  1842.  
  1843. Introduced ZMODEM RLE compression with the -Z option.  (DSZ copies with paid
  1844. registration also accept "Z" in the DSZOPT environment variable.) ZMODEM RLE
  1845. compression packs runs of the same character in two or three character
  1846. sequences.  Compression is useful for screen dumps, uncompressed workspaces,
  1847. compiler listings, and other files rich with strings of repeated characters,
  1848. but not .ARC and compressed files to more than 1000 per cent (10x speedup!)
  1849. for the Personal Computing text file benchmark(!).  When sending to programs
  1850. that do not support ZMODEM compression, the -Z option is ignored.  The -Z
  1851. option is effective when specified to the sending program only.
  1852.  
  1853. Good news for tired frog stompers!  The ZMODEM rz/sz programs are now
  1854. available in a VMS C flavor.  The VAX/VMS source files are contained in the
  1855. RZSZ.ARC (RZSZ.ZOO) archive file.
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861. Chapter 14 Pg 29          DSZ Reference Rev 02-23-89           Typeset 2-23-89
  1862.  
  1863.  
  1864.  
  1865. "Handshake slow" has been added to disable the RTS signal to the modem while
  1866. writing to disk, even if the interrupt buffer is not chock full of bytes.
  1867. This should help systems with excessive interrupt latency on disk writes.
  1868.  
  1869. Setting the v (verbose) parameter to 1 or greater causes serialized copies to
  1870. ring the bell when a transfer is done.
  1871.  
  1872. DSZ.DOC has been extensively rewritten and reorganized.  DSZ now supports the
  1873. advanced buffering of the National NS16550AN and Intel 82510 serial interface
  1874. devices.  Arrow Electronics 1-800-932-7769 sells National NS16550AN chips mail
  1875. order (credit card) in small quantities.
  1876.  
  1877.  
  1878. Pirated/hacked versions of DSZ have cost users and DSZ's developer thousands
  1879. of dollars in lost time and other expenses, in addition to injuring the
  1880. reputation of Omen Technology and its products.  Regrettably, Omen Technology
  1881. cannot support prior versions of DSZ because of this piracy.
  1882.  
  1883. Name             Length                           Date        Time   CRC
  1884. dsz.com          52622  Crunched   16%     44473  23 Feb 89   1:22p  981b
  1885. PKZIP -vt 32 bit CRC: B5F6F990
  1886.  
  1887. Your copy of DSZ should show this information as provided by
  1888.  
  1889.        arc v dsz
  1890. or
  1891.       pkxarc -v dsz or
  1892.       pkzip -vt dsz
  1893.  
  1894. If your copy shows a different CRC or file length, insist on a legitimate copy
  1895. and report the source of the bogus/pirated copy to Omen Technology Inc.  Omen
  1896. Technology has received reports of serious problems caused by unauthorized
  1897. patches to DSZ, and cannot assume liability for the performance of the
  1898. resultant code.
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.  
  1920.  
  1921. Chapter 15 Pg 30          DSZ Reference Rev 02-23-89           Typeset 2-23-89
  1922.  
  1923.  
  1924.  
  1925. 15.  Other Omen Technology Products
  1926.  
  1927. Omen Technolgy makes Professional-YAM, a comphrensive comms program with
  1928. unmatched power.  Flavors are available for PC-DOS, Unix, Xenix, and OS/2
  1929. Protected mode.
  1930.  
  1931. ZCOMM is a full featured shareware version with a $40.00 basic registration.
  1932.  
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  
  1939.  
  1940.  
  1941.  
  1942.  
  1943.  
  1944.  
  1945.  
  1946.  
  1947.  
  1948.  
  1949.  
  1950.  
  1951.  
  1952.  
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962.  
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.  
  1977.  
  1978.  
  1979.  
  1980.  
  1981. Chapter 16 Pg 31          DSZ Reference Rev 02-23-89           Typeset 2-23-89
  1982.  
  1983.  
  1984.  
  1985. 16.  FAIR PLAY
  1986.  
  1987. Unlike snazzy menu interfaces, reliable high speed transfer protocols take
  1988. many hours of testing, often over expensive phone connections, to develop.
  1989. Two decades of communications experience and protocol testing are distilled in
  1990. DSZ.
  1991.  
  1992. DSZ is a user supported program developed and supported by Chuck Forsberg,
  1993. owner of Omen Technology.  Countless hours of work and expen$ive resources
  1994. went to develop and support DSZ for the myriad environments users use it in.
  1995. The fact that most of the problems people encounter with DSZ are caused by
  1996. other software, hardware problems, failure to read the supplied documentation,
  1997. or pirating has not kept users from seeking and getting help, even if it means
  1998. calling the author in the middle of his sleep.
  1999.  
  2000. Beyond this, the world of communications is constantly evolving, and it
  2001. requires a significant ongoing effort to keep DSZ and its documentation up to
  2002. date with the current state of the art.  Individuals with little knowledge of
  2003. the dynamic nature of telecommunications (or hidden agendas) have
  2004. misrepresented the frequency of enhancements to DSZ as a sign that DSZ is
  2005. "unstable" and unworthy of "serious consideration".  If you think such sniping
  2006. is fair play, you are more than welcome to use one of the many other protocol
  2007. programs available, each of which claim to offer speed and reliability
  2008. comparable to DSZ.
  2009.  
  2010. Non registered users are welcome to use DSZ for a reasonable evaluation
  2011. period.  "Reasonable" means "until you've decided whether the program is worth
  2012. $20.00".  It does not mean "until some competing program gets around to adding
  2013. ZMODEM or True Ymodem(TM)".  Afterwards, ethical use of DSZ requires
  2014. registering the copy.
  2015.  
  2016. DSZ is not and never has been Public Domain.  Every version of DSZ has
  2017. included a Copyright Notice and a prohibition against sale or modification.
  2018. There is no usage counter or other Trojan Horse in DSZ, but if you use this
  2019. program, you have a moral and ethical obligation to register it.
  2020.  
  2021. Paid registration enables OverThruster(TM), YMODEM-g, and other advanced
  2022. features that are present in DSZ.ARC in encrypted form.  The registration
  2023. package serializes and decodes all past and future versions of DSZ.COM and
  2024. DSZ.EXE.
  2025.  
  2026. 16.1  Sharing DSZ Files
  2027.  
  2028. You are welcome to share unmodified copies of DSZ.ARC with your friends and
  2029. associates for their evaluation.  This documentation file and the MAILER file
  2030. must be provided with all copies of DSZ except by prior written permission
  2031. from Omen Technology Inc.  If DSZ.ARC is "zipped" or otherwise repacked, no
  2032. files may be added to or removed from the archive.  Because of piracy
  2033. problems, Omen Technology must INSIST that DSZ be distributed only as part of
  2034. the DSZ.ARC file EXACTLY as provided by Omen Technology Inci, or in an archive
  2035. which displays a CRC value for DSZ.COM equal to that shown in the CHANGES
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041. Chapter 16 Pg 32          DSZ Reference Rev 02-23-89           Typeset 2-23-89
  2042.  
  2043.  
  2044.  
  2045. chapter.
  2046.  
  2047. If you distribute DSZEXE.ZOO, DSZ.ARC must be included in the same directory
  2048. since DSZEXE.ZOO references files in DSZ.ARC.  The DSZEXE.ZOO file may not be
  2049. modified in any way, including repacking with another archive program.  I ask
  2050. this favor because Rahul's ZOO is a superior archiving format, and I want to
  2051. help it along.
  2052.  
  2053. If you see an improperly packed or otherwise modified DSZ archive or parts
  2054. thereof in a bulletin board, please ask the board's operator to replace such
  2055. files with DSZ.ARC exactly as provided by Omen Technology Inc.  Flame them
  2056. until they behave responsibly.
  2057.  
  2058. No version of DSZ may be sold without the prior written permission of Omen
  2059. Technology Inc.
  2060.  
  2061. Distribution or use of programs that modify, patch, disassemble, decompile, or
  2062. otherwise reverse engineer DSZ without prior written permission by Omen
  2063. Technology Inc is a bloody theft of services and a violation of federal
  2064. copyright law.  The same applies to debug scripts and documentation written
  2065. for the same purposes.  These perform the same function as pirate satellite
  2066. and/or cable descramblers, to obtain benefit from encrypted communications
  2067. without proper payment.  Piracy has been investigated by the FBI and
  2068. prosecuted under federal statutes.  Applicable law provides for damages and
  2069. recovery of attorney's fees.  Omen Technology has received reports of serious
  2070. problems caused by unauthorized patches to DSZ, and cannot assume liability
  2071. for the performance of the resultant code.  So far, none of the slime
  2072. producing such bilge have seen fit to sign their real name and address to
  2073. their cretinous attempts at ego gratification.
  2074.  
  2075. Distribution of DSZ in any medium without this documentation file is an
  2076. unauthorized modification to DSZ that deprives the rightful author of
  2077. registration revenues.  That is a theft of intellectual property.  Such
  2078. distribution also damages the author also obliges the user and author to waste
  2079. time and phone bills scrounging for the documentation, and answering questions
  2080. that are fully covered in the documentation.
  2081.  
  2082. If any version of DSZ is distributed with any other product, software or
  2083. hardware, the product documentation must clearly and prominently state that
  2084. the customer's continued use of DSZ requires registration directly with Omen
  2085. Technology or its duly authorized agent(s).  When DSZ is distributed on disk,
  2086. a contemporary copy of ZCOMMDOC.ARC should be included on the same disk.
  2087.  
  2088. Thank you for your support.
  2089.  
  2090. 16.2  REGISTRATION
  2091.  
  2092. After a short evaluation period, ethical users must register their copy of DSZ
  2093. with a check for $20.00 in U.S. funds sent to:
  2094.  
  2095.        Omen Technology Inc.
  2096.  
  2097.  
  2098.  
  2099.  
  2100.  
  2101. Chapter 16 Pg 33          DSZ Reference Rev 02-23-89           Typeset 2-23-89
  2102.  
  2103.  
  2104.  
  2105.        P.O. Box 4681
  2106.        Portland, OR 97208
  2107.        For VISA/MC Registrations, voice call 503-621-3406
  2108.        FAX: 503-621-3735
  2109.  
  2110. The address on your check is sufficient, no need to fill out forms.
  2111.  
  2112. Don't bother scrounging for an envelope, just print the INSTANT MAILER
  2113. included in this archive!
  2114.  
  2115. Overseas registrations are sent out International Air Mail.  Users, especially
  2116. those overseas, may choose to register their copy of DSZ for $25.00 U.S.  by
  2117. providing their VISA or Mastercard card number with expiration date and their
  2118. name as it appears on their credit card.
  2119.  
  2120. Please contact Omen Technology before issuing unfunded purchase orders.
  2121.  
  2122.   *************************************************************************
  2123. The user registration package includes additional user documentation, a
  2124. printed serial number password (SNP) card, latest versions of the DSZ
  2125. programs, and the installation program which uses the SNP to enable andvanced
  2126. features and bypass the opening advertisement.
  2127.  
  2128. The registration package unlocks the extra value in all past and future
  2129. versions of DSZ.COM and DSZ.EXE.
  2130.   *************************************************************************
  2131.  
  2132. The unique serial number on the registration card is registered to the user,
  2133. and is acceptable proof of registration to corporate auditors.
  2134.  
  2135. The putsnp program inserts your unique DSZ Serial Number Password (SNP) into
  2136. you copy of DSZ with the following command:
  2137.        putsnp dsz.com
  2138. Putsnp accepts your SNP and asks appropriate questions before inserting the
  2139. SNP to enable the extra value in DSZ.
  2140.  
  2141. Some TSR programs have been known to interfere with putsnp.  If you have a
  2142. lockup running putsnp, run it without any TSR programs.
  2143.  
  2144.  
  2145. The only legitimate way to disable the opening advertisement in DSZ is to
  2146. insert an authorized SNP obtained from Omen Technology into DSZ with the
  2147. putsnp program.  Any other suppression or modification of the opening screen
  2148. is an illegal, unethical theft of services.  Omen Technology has received
  2149. reports of serious problems caused by unauthorized patches to DSZ, and cannot
  2150. assume liability for the performance of the resultant code.
  2151.  
  2152. Piracy is stealing.
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161. Chapter 16 Pg 34          DSZ Reference Rev 02-23-89           Typeset 2-23-89
  2162.  
  2163.  
  2164.  
  2165. 16.3  Files on Registration Disk
  2166.  
  2167. The following files are currently included on the Registration Disk sent to
  2168. paid registrants.
  2169.  
  2170. LOOZ.EXE       Program to unpack .ZOO archives.
  2171.  
  2172.  
  2173. DSZEXE.ZOO     Contains DSZ.EXE.
  2174.  
  2175.                To dearchive with looz: looz x dszexe (Note: x must be lower
  2176.                case, X won't work!)
  2177.  
  2178.                Type "looz" without arguments to see the help message.
  2179.  
  2180.  
  2181. DSZ.ARC        Contains DSZ.COM, this document, DESQview description files,
  2182.                and an instant no-effort registration mailer.
  2183.  
  2184.                To dearchive with looz: looz x yzmodem (Note: x must be lower
  2185.                case, X won't work!)
  2186.  
  2187.  
  2188. RZSZ.ZOO       ZMODEM C source code, porting base for several dozen ZMODEM
  2189.                implementations
  2190.  
  2191.                To dearchive with looz: looz x rzsz (Note: x must be lower
  2192.                case, X won't work!)
  2193.  
  2194.  
  2195. PUTSNP.EXE     Installs your unique registered serial number to enable the
  2196.                extra value in DSZ.
  2197.  
  2198.  
  2199. DSZBG.DOC (in DSZBG.ZOO) Background information for DSZ, consisting of
  2200.                relevant parts of the ZCOMM User's Manual.  DSZBG.DOC is for
  2201.                paid registered users only; registered bulletin boards and
  2202.                unregistered users are welcome to read the same information
  2203.                contained in the ZCOMM manual (contained in ZCOMMDOC.ARC).
  2204.  
  2205.                To dearchive with looz: looz x dszbg (Note: x must be lower
  2206.                case, X won't work!)
  2207.  
  2208.  
  2209. 16.4  Bulletin Board Registration
  2210.  
  2211. DSZ may be freely used and copied by public bulletin board systems which agree
  2212. to the conditions stated in the accompanying bbs_reg.txt file.  Those not
  2213. abiding to these conditions must obtain a paid registration for each node.
  2214.  
  2215. The purpose of free bulletin board registrations is to support and promote
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221. Chapter 16 Pg 35          DSZ Reference Rev 02-23-89           Typeset 2-23-89
  2222.  
  2223.  
  2224.  
  2225. ZCOMM and Professional-YAM by popularizing the ZMODEM protocol.  BBS
  2226. registrations must be submitted on the form with signature and date.  BBS
  2227. registrations postmarked after the date shown on the form will be ignored.
  2228. Free bulletin board registrations are processed in batches, when there is a
  2229. major upgrade to ZCOMM.  BBS registrations support the features needed for BBS
  2230. operation with ZMODEM.
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.  
  2257.  
  2258.  
  2259.  
  2260.  
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281. Chapter 17 Pg 36          DSZ Reference Rev 02-23-89           Typeset 2-23-89
  2282.  
  2283.  
  2284.  
  2285. 17.  ACKNOWLEDGEMENTS
  2286.  
  2287. 32 bit CRC code courtesy Gary S. Brown.
  2288.  
  2289. The High Reliability Software(TM), TurboLearn Script Writer(TM), Cybernetic
  2290. Data Recovery(TM), Intelligent Crash Recovery(TM), Error Containment(TM), Full
  2291. Time Capture(TM), True YMODEM(TM), OverThruster(TM), Password Guardian(TM),
  2292. CryptoScript(TM), and TurboDial(TM) are Omen Technology trademarks.
  2293.  
  2294. PowerCom was trademarked in 1985 by POLYTRON Corporation, Hillsboro Oregon.
  2295.  
  2296. DSZ and this documentation are Copyright 1988 by Omen Technology Inc, all
  2297. rights reserved.  True YMODEM(TM) is an Omen Technology Trademark signifying
  2298. YMODEM protocol support that meets the full YMODEM specification.
  2299.  
  2300.                          Omen Technology Incorporated
  2301.                         The High Reliability Software
  2302.  
  2303.                      17505-V Northwest Sauvie Island Road
  2304.                             Portland Oregon 97231
  2305.                 Modem: 503-621-3746 Speed 1200,2400,19200 PEP
  2306.                               FAX: 503-621-3735
  2307.                        Compuserve:70007,2304  GEnie:CAF
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319.  
  2320.  
  2321.  
  2322.  
  2323.  
  2324.  
  2325.  
  2326.  
  2327.  
  2328.  
  2329.  
  2330.  
  2331.  
  2332.  
  2333.  
  2334.  
  2335.  
  2336.  
  2337.  
  2338.  
  2339.  
  2340.  
  2341.